@classytic/formkit 1.3.1 → 1.4.0

package/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.0] - 2026-05-26
+
+### Added
+
+- New schema helpers exported from `./schema`: `extractDefaultValuesAsync`, field-type predicates (`isChoiceField`, `isTextField`, `isNumericField`, `isDateField`, `isContainerField`, `isArrayField`, `isDynamicField`, `isConditionalField`), schema composition (`mergeSchemas`, `extendSection`, `pickFields`, `omitFields`, `flattenSchema`), and `applyServerErrors`.
+- New exported types: `SectionRendererProps`, `GridRendererProps`, `FieldWrapperProps`, `ValidationRuleObject`, `PatternRuleObject`.
+- Conditional package exports add `module-sync` condition for better React Server Components / sync-import interop.
+
+### Changed
+
+- `main` / `module` fields removed from `package.json` in favor of pure conditional `exports`.
+
 ## [1.3.0] - 2026-02-27
 
 ### Added

package/README.md

@@ -20,7 +20,7 @@ Headless, type-safe form generation engine for React 19. Schema-driven with full
 - **Responsive layouts** - Multi-column grid layouts
 - **Accessibility** - Auto-generated `fieldId`, `error`, and `fieldState` props
 - **Validation helpers** - `buildValidationRules` generates RHF rules from schema props
-- **Lightweight** - ~7KB gzipped, tree-shakeable
+- **Lightweight** - ~12KB gzipped (peer deps excluded), tree-shakeable
 
 ## Requirements
 
@@ -54,28 +54,41 @@ import { Label } from "@/components/ui/label";
 
 export function FormInput({
   control,
-  field,
+  name,
+  rules,       // pre-computed RHF rules from schema (required, minLength, pattern, validate…)
   label,
   placeholder,
   required,
+  fieldId,     // use as id on <input> and htmlFor on <Label>
+  errorId,     // use as id on error <p> and aria-errormessage on <input>
+  shouldShowError, // true only after touch/submit — mirrors :user-invalid timing
   error,
-  fieldId,
 }: FieldComponentProps) {
   return (
     <Controller
-      name={field.name}
+      name={name}
       control={control}
-      render={({ field: rhfField }) => (
+      rules={rules}
+      render={({ field }) => (
         <div className="space-y-2">
           {label && (
             <Label htmlFor={fieldId}>
               {label}
-              {required && <span className="text-red-500 ml-1">*</span>}
+              {required && <span aria-hidden="true" className="text-red-500 ml-1">*</span>}
             </Label>
           )}
-          <Input {...rhfField} id={fieldId} placeholder={placeholder} />
-          {error && (
-            <p className="text-sm text-red-500">{error.message}</p>
+          <Input
+            {...field}
+            id={fieldId}
+            placeholder={placeholder}
+            aria-required={required || undefined}
+            aria-invalid={shouldShowError || undefined}
+            aria-errormessage={shouldShowError ? errorId : undefined}
+          />
+          {shouldShowError && (
+            <p id={errorId} role="alert" className="text-sm text-red-500">
+              {error?.message}
+            </p>
           )}
         </div>
       )}
@@ -277,7 +290,11 @@ interface Section<T> {
 
 ```ts
 interface BaseField<T> {
-  name: string;                 // Field name (required)
+  // name accepts Path<T> or any string.
+  // Use field.for<T>() builders for call-site enforcement of valid paths.
+  // Relative names are correct for nameSpace sections and itemFields children —
+  // FormGenerator prefixes them at render time (e.g. "street" → "address.street").
+  name: Path<T> | string;       // Field name (required)
   type: FieldType;              // Field type (required)
   label?: string;               // Field label
   placeholder?: string;         // Placeholder text
@@ -298,8 +315,10 @@ interface BaseField<T> {
   loadOptions?: (formValues: Partial<T>) => Promise<FieldOption[]> | FieldOption[];
   debounceMs?: number;
 
-  // For array/grouped types
-  itemFields?: BaseField<T>[];
+  // Sub-fields for group and array types.
+  // Children use relative names ("street") — FormGenerator prefixes with parent name.
+  // Intentionally untyped to T because they resolve at render time, not authoring time.
+  itemFields?: BaseField[];
 
   // For select/radio/checkbox
   options?: FieldOption[];