fix: harmonize validation modes and core type inference

[ladparth]

Description

This PR synchronizes the BuzzForm documentation with the current codebase while resolving several critical behavioral/type gaps identified during the audit. It fixes the validation trigger waterfall logic and corrects primitive array type inference for named items.

Key Changes

Core (form-core)

• Primitive Array Inference: Fixed a bug in InferType where named child fields in primitive: true arrays were incorrectly inferred as flat values. They now correctly resolve to object-wrapped arrays (e.g., { name: value }[]), matching the UI component's runtime behavior.

React Adapter (form-react)

• Validation Waterfall: Implemented cumulative validation for derivedValidationMode. Triggers now follow a "waterfall" logic:
  • "submit" (default): Runs on submit.
  • "blur": Runs on blur AND submit.
  • "change": Runs on change, blur, AND submit.
• Synchronized Defaults: Updated the internal default for derivedValidationMode to "submit" to match documentation and expected core behavior.

Docs / Web (apps/web)

• Technical Audit & Cleanup: Verified and synchronized all .mdx files.
• Validator Return Types: Updated all custom validator examples to return boolean (correct) instead of string or ternary results.
• UI Constraints: Clarified that maxTagLength is a UI-level constraint enforced by the tag component rather than an auto-derived schema validator.
• Primitive Array Docs: Updated array.mdx to accurately describe flat vs. object-wrapped inference choices.

Type of change

• feat (New feature)
• fix (Bug fix)
• docs (Documentation changes)
• refactor (Refactoring code without changing behavior)
• test (Adding or updating tests)
• chore (Maintenance, CI/CD, or Ops-related changes)

Related Issues

• Closes # [Issue number not provided]

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
buzzform	Ready	Preview, Comment	Apr 12, 2026 1:56pm