feat(options): async resolvers and dynamic dependencies

[ladparth]

Description

This PR introduces a robust system for handling async field options and dynamic field dependencies in BuzzForm. It enables developers to easily implement cascading dropdowns (e.g., Country > State > City) with automatic loading states, request deduplication, and stale value clearing.

Key Changes

Core (form-core)

• Added OptionResolverRegistry and OptionResolver types to support async option fetching.
• Introduced defineOptionResolvers helper for type-safe registration of fetchers.
• Enhanced resolveOptions to handle dynamic option sources and conditions.
• Updated dependency walking logic to support reactive field updates.

React Adapter (form-react)

• Rewrote useFieldOptions hook to support async resolvers with built-in loading and error states.
• Implemented automatic value clearing when a field's dependencies change or when its current value is no longer present in the updated options list.
• Added support for request deduplication to prevent redundant API calls when multiple fields share the same resolver/args.
• Added optionResolvers prop to Form, Field, and FieldRenderer for global or scoped resolver injection.

Docs / Web (apps/web)

• Added a comprehensive guide for Option Resolvers in SKILL.md.
• Added a "Country + State" form example demonstrating dynamic dependencies and async loading.

Other

• Added setup-labels.js and setup-milestones.js scripts for repository initialization.
• Added issue-resolution.md workflow for standardized agent-driven development.

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 How to get the current value of another field from the field component? #109
• Closes [FEAT] Allow passing async functions to the form schema #110
• Closes [FEAT] Example with Country + State form with dependant fields and dynamic async loading of the data #112

[vercel]

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

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