formstand 0.24.0 → 0.25.0

package/CHANGELOG.md

@@ -1,5 +1,81 @@
 # Changelog
 
+## 0.25.0 — 2026-11-12
+
+### Added
+
+- `useVariantFieldArray(form, unionPath, field)`, the array twin of
+  `useVariantField`: a `z.array` that lives in one variant of a
+  discriminated union sits at a path `useFieldArray` cannot take, since
+  `FieldPath` on a union offers only the keys every variant shares. The
+  hook binds `${unionPath}.${field}` and types the rows from the variants
+  that declare the array; `field` is a variant sub-path (`"lights"`,
+  `"spec.lights"`, or a row template for an array nested in another
+  variant array's rows), and a common-key array stays with plain
+  `useFieldArray`, which the variant hook rejects. Same return as
+  `useFieldArray`, row ids included. `createFormHooks` gains the bound
+  `use{Name}VariantFieldArray`, and the type `VariantArrayFieldPath` is
+  exported. formstand-cli emits it for arrays inside union variants.
+
+### Fixed
+
+- `createFormHooks(createForm(schema, options), name)` with the form
+  created inline collapsed every depth-typed bound hook (`useXField`,
+  `useXFieldArray`, `useXIsDirty`) to a `never` path: the inner call
+  inferred its depth from the outer call's still-unresolved depth
+  parameter, so the depth became the whole budget union. `createForm` and
+  `useForm` now take their depth from `pathDepth` alone (`NoInfer` on the
+  returned form), so the inline shape types like the const-form shape the
+  docs show, and an explicit `pathDepth` still infers its literal.
+
+## formstand-cli 0.26.0 — 2026-11-12
+
+### Added
+
+- An **array inside a union variant** generates instead of degrading to a
+  TODO, in both layouts and every kit: a `{Stem}Rows` component on
+  `useVariantFieldArray(form, unionPath, "lights")` (formstand 0.25), its
+  row leaves on the variant path (the Bound components in the single-file
+  layout, `useVariantField` on a row template in the module layout), the
+  empty item typed from the hook, and deeper lists under those rows bound
+  the same way. Under a union row item the row's own index renames to the
+  next hole for the extracted component, as nested lists already do. Still
+  a TODO: a union inside a variant, a union or tuple inside a variant
+  array's rows, and an array every variant shares (a plain path, left to
+  `useFieldArray`). Generated output with a variant array needs formstand
+  0.25 or newer.
+
+### Changed
+
+- **Arrays of flat object rows generate as tables.** Where every row
+  field is a scalar within the path budget and none carries a component
+  override, the array renders as a table in both layouts and every kit:
+  one column per row field with
+  the label in the header (a description becomes the header's title), a
+  `{Stem}Row` component per row binding each cell from hoisted `useField`
+  hooks (`useVariantField` for an array inside a union variant) and
+  naming the control through `aria-label`, a Remove column, and the
+  array-level error plus the Add button under the table. antd's
+  data-driven `Table` gets one cell component per column. Rows holding a
+  container, scalar rows and rows with an overridden field keep the
+  cards, and the new `fields: { "<path>": { layout: "cards" } }` opts a
+  flat array back out; `layout: "table"` asserts one and errors, naming
+  the row field, where it cannot be built.
+
+### Fixed
+
+- The single-file layout's TODO for a container that still degrades inside
+  a row union's variant printed the hole-stripped naming path
+  (`"pavements.sub"`), which names no field a reader can find. It prints
+  the row template (`"pavements.${index}.sub"`), as the module layout
+  already did.
+- Two usage walks passed the wrong budget when descending into an
+  array's rows, so anything two objects deep under a row was skipped: a
+  discriminated union there rendered its variant controls without
+  importing the prop builders they call, and a described leaf there was
+  handed a `description` prop the Bound components did not declare.
+  Both walks carry the real budget now.
+
 ## 0.24.0 — 2026-10-23
 
 ### Added

package/README.md

@@ -123,7 +123,7 @@ PATCH-ready payload of exactly what changed.
 | Area | What's there | Docs |
 | --- | --- | --- |
 | Form instance | `createForm`, `setValue`/`setValues`, `reset`/`resetField`/`adoptValues`, `submit`/`handleSubmit`, `diff`/`dirtyFields`, `snapshot`/`restore`, array ops | [createForm & Form](https://scrumrot.github.io/formstand/documentation/api/) |
-| Hooks | `useForm`, `useField`, `useFieldArray`, `useVariantField`, `useFormSelector`, `useFormValues`, the flag hooks, `createFormContext`, `createFormHooks` | [Hooks](https://scrumrot.github.io/formstand/documentation/api/hooks) |
+| Hooks | `useForm`, `useField`, `useFieldArray`, `useVariantField`, `useVariantFieldArray`, `useFormSelector`, `useFormValues`, the flag hooks, `createFormContext`, `createFormHooks` | [Hooks](https://scrumrot.github.io/formstand/documentation/api/hooks) |
 | Components | `TextField`, `NumberField`, `DateField`, `CheckboxField`, `SelectField`, the prop builders, `useNumberInput`, `focusField`/`focusFirstError` | [Components & bindings](https://scrumrot.github.io/formstand/documentation/api/components) |
 | Validation | five modes plus `reValidateMode`, field-scoped passes, async refines with race handling, per-field `debounceMs` | [Validation](https://scrumrot.github.io/formstand/documentation/validation) |
 | Utilities | `parsePath`/`getAtPath`/`setAtPath`, `validateSync`/`validateAsync`, `persistForm`, and the full type list | [Utilities & types](https://scrumrot.github.io/formstand/documentation/api/utilities) |

package/dist/{createForm-BexUOCjZ.d.cts → createForm-CMVALnc3.d.cts}

@@ -202,7 +202,7 @@ type Form<TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth> = R
     snapshot: () => FormState<z.input<TSchema>>;
     restore: (snapshot: FormState<z.input<TSchema>>) => void;
 }>;
-declare const createForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(schema: TSchema, options: CreateFormOptions<TSchema, D>) => Form<TSchema, D>;
+declare const createForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(schema: TSchema, options: CreateFormOptions<TSchema, D>) => Form<TSchema, NoInfer<D>>;
 
 export { createForm as p, emptyValueForSchema as q, flattenIssues as r, isAsyncRequiredError as s, isClearableSchema as t, shouldValidateOn as u, validateAsync as v, validateSync as w };
 export type { ArrayFieldPath as A, BoolMap as B, CreateFormOptions as C, DefaultPathDepth as D, ErrorMap as E, Form as F, InvalidSubmitHandler as I, PathDepth as P, ReadonlyStoreApi as R, SettledFieldValidationResult as S, ValidationMode as V, FormState as a, FieldValidationResult as b, FieldPath as c, FieldValue as d, ArrayItemOf as e, FieldSnapshot as f, FieldsValidationResult as g, ResetOptions as h, SettledFieldsValidationResult as i, SettledValidationResult as j, SubmitHandler as k, SubmitOptions as l, SubmitResult as m, ValidationResult as n, ValidationTrigger as o };

package/dist/{createForm-BexUOCjZ.d.ts → createForm-CMVALnc3.d.ts}

@@ -202,7 +202,7 @@ type Form<TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth> = R
     snapshot: () => FormState<z.input<TSchema>>;
     restore: (snapshot: FormState<z.input<TSchema>>) => void;
 }>;
-declare const createForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(schema: TSchema, options: CreateFormOptions<TSchema, D>) => Form<TSchema, D>;
+declare const createForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(schema: TSchema, options: CreateFormOptions<TSchema, D>) => Form<TSchema, NoInfer<D>>;
 
 export { createForm as p, emptyValueForSchema as q, flattenIssues as r, isAsyncRequiredError as s, isClearableSchema as t, shouldValidateOn as u, validateAsync as v, validateSync as w };
 export type { ArrayFieldPath as A, BoolMap as B, CreateFormOptions as C, DefaultPathDepth as D, ErrorMap as E, Form as F, InvalidSubmitHandler as I, PathDepth as P, ReadonlyStoreApi as R, SettledFieldValidationResult as S, ValidationMode as V, FormState as a, FieldValidationResult as b, FieldPath as c, FieldValue as d, ArrayItemOf as e, FieldSnapshot as f, FieldsValidationResult as g, ResetOptions as h, SettledFieldsValidationResult as i, SettledValidationResult as j, SubmitHandler as k, SubmitOptions as l, SubmitResult as m, ValidationResult as n, ValidationTrigger as o };

package/dist/index.cjs

@@ -2243,6 +2243,14 @@ function useFieldArray(form, pathArg) {
     ]
   );
 }
+
+// src/react/useVariantFieldArray.ts
+function useVariantFieldArray(form, unionPath, field) {
+  return useFieldArray(
+    form,
+    `${unionPath}.${field}`
+  );
+}
 var useFormError = (form) => react$1.useStore(
   form.store,
   shallow.useShallow((state) => state.errors[""])
@@ -2321,6 +2329,11 @@ var createFormHooks = (form, name) => {
     field
   );
   const useBoundFieldArray = (path) => useFieldArray(structural, path);
+  const useBoundVariantFieldArray = (unionPath, field) => useVariantFieldArray(
+    structural,
+    unionPath,
+    field
+  );
   const useBoundSelector = (selector) => useFormSelector(structural, selector);
   const useBoundSelectorShallow = (selector) => useFormSelectorShallow(structural, selector);
   const useBoundError = () => useFormError(structural);
@@ -2340,6 +2353,7 @@ var createFormHooks = (form, name) => {
     [`use${prefix}Field`]: useBoundField,
     [`use${prefix}VariantField`]: useBoundVariantField,
     [`use${prefix}FieldArray`]: useBoundFieldArray,
+    [`use${prefix}VariantFieldArray`]: useBoundVariantFieldArray,
     [`use${prefix}Selector`]: useBoundSelector,
     [`use${prefix}SelectorShallow`]: useBoundSelectorShallow,
     [`use${prefix}Error`]: useBoundError,
@@ -2694,6 +2708,7 @@ exports.useNumberInput = useNumberInput;
 exports.usePersistForm = usePersistForm;
 exports.useSubmitCount = useSubmitCount;
 exports.useVariantField = useVariantField;
+exports.useVariantFieldArray = useVariantFieldArray;
 exports.validateAsync = validateAsync;
 exports.validateSync = validateSync;
 //# sourceMappingURL=index.cjs.map