feat: unify dynamic expression APIs under Expr<T>

[ladparth]

Description

Unifies all dynamic expression APIs under a single Expr<T> type, replacing the fragmented DynamicValue, VisibilityCondition, and resolveDynamicValue/evaluateVisibility helpers. Introduces inline JS functions as a first-class expression type — the "escape hatch" for non-JSON-serializable schemas requested in #110.

Also introduces FormRegistries as a unified container for all runtime registries (fields, validators, resolvers, fns), replacing the scattered registry, customValidators, and optionResolvers props. Registry merging is now handled correctly at the framework layer — global FormProvider registries are deep-merged with form-level overrides, with form-level keys winning per sub-registry.

Key Changes

Core (form-core)

• Introduce Expr<T> unified expression system replacing DynamicValue and VisibilityCondition
• Add $text node for string interpolation ("Hello ${/firstName}")
• Add $when/$then/$else node for conditional branching (ternary)
• Add $fn node for calling named functions from registries.fns
• Add inline JS function support: condition: ({ data, context }) => ...
• Introduce ExprContext with data and context properties
• Add resolveExpr as the single evaluation entry point
• Fix InferType for empty-name primitive arrays to produce flat arrays
• Deprecate evaluateVisibility, resolveDynamicValue, and old context types

React Adapter (form-react)

• Introduce FormRegistries container for fields, validators, resolvers, fns
• Add registries prop to FormProvider, Form, RenderFields, FieldRenderer, and useForm
• Add mergeRegistries utility — deep per-sub-registry merge, form-level keys override global
• Normalize deprecated registry, customValidators, optionResolvers props into registries at entry points (FieldRenderer, RenderFields, FormProvider, useForm) — nothing deprecated leaks downstream
• Fix FormProvider clobbering outer context when registries is undefined
• Deprecate registry, customValidators, and optionResolvers top-level props

Docs / Web (apps/web)

• Update all docs to use registries API
• Update FormProvider in global providers to registries={{ fields: registry }}
• Update registry components (form.tsx, array.tsx, collapsible.tsx, tabs.tsx) to use resolveExpr and registries
• Update country-state-form example to use registries.resolvers

Type of change

• feat (New feature)
• fix (Bug fix)
• refactor (Refactoring code without changing behavior)

Related Issues

• Closes [FEAT] Allow passing async functions to the form schema #110

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
buzzform	Ready	Preview, Comment	Apr 15, 2026 0:39am