formstand 0.14.0 → 0.15.2

package/CHANGELOG.md

@@ -1,5 +1,115 @@
 # Changelog
 
+## 0.15.2 — 2026-08-11
+
+Identical to 0.15.1, republished under a fresh tag. The v0.15.1 tag was
+pushed during the August 6 GitHub Actions outage and GitHub dropped the
+tag event outright, so the Publish workflow never ran and 0.15.1 never
+reached npm. The Publish workflow only fires on tag pushes by design (the
+trusted-publishing trust is bound to that trigger), so the recovery is a
+new version under a new tag. No code changes.
+
+## formstand-cli 0.11.1 — 2026-08-11
+
+Identical to formstand-cli 0.11.0, republished under a fresh tag for the
+same reason as 0.15.2 above: the cli-v0.11.0 tag event was dropped in the
+August 6 outage and the version never reached npm. No code changes.
+
+## 0.15.1 — 2026-08-06
+
+### Fixed
+
+- **Tuple element paths type as their exact element.** `FieldValue` resolved
+  a path like `"pair.0"` into `[string, number]` through the generic array
+  arm, so the value typed as `string | number` instead of `string`. The
+  bundled field components hid this by asserting their own value type; the
+  raw hooks exposed it, and a CLI module tuple section over a mixed tuple
+  did not compile because its per-kind prop builders need the exact element.
+  Tuple index paths now resolve positionally. Types only, no runtime change.
+
+## formstand-cli 0.11.0 — 2026-08-06
+
+### Fixed
+
+- **Four edge-config compile and layout bugs in the container migration**,
+  all one family: a gate that decides imports or exports did not count every
+  shape that renders section chrome.
+  - A module union section at `--columns 2|3` rendered its vertical `Stack`
+    shell while importing for the grid it no longer renders, a TS2304 in
+    mantine and mui output. Imports and shell now derive from one visual.
+  - A tuple-only root emitted section chrome (`Typography`/`Title`/`Heading`
+    headings, and at `--columns 2|3` the `Row`/`Col` or `Grid` pair) without
+    importing any of it; the section-import gate now counts tuples.
+  - A module tuple section imported the bound field hook from `hooks.ts`,
+    which never exported it for a tuple-only root; the export gate now
+    mirrors the tuple section's own import rule.
+  - A module nested `<fieldset>` lost its full-row span for the CSS-grid
+    backends (plain, shadcn, chakra), collapsing a nested section into one
+    grid cell; the span now rides the fieldset whenever no cell wrapper
+    exists to carry it.
+
+  The version matrix now generates tuple-only and root-union schemas against
+  every kit's real declarations (`cli/matrix/edgeSchemas.ts`), and the CI
+  suite grew matching regression tests, so the class cannot ship green again.
+
+### Changed
+
+- **`--columns` output is responsive.** `--columns 2` now means "two columns
+  when there is room, one on a phone" in every backend's own dialect: MUI gets
+  an `sx` breakpoint object, chakra a responsive `gridTemplateColumns` style
+  prop, mantine `SimpleGrid cols={{ base: 1, sm: N }}`, and the inline-style
+  backends (plain, antd) a `repeat(auto-fit, minmax(...))` track whose calc
+  caps the column count at N while a 220px floor collapses columns that would
+  squeeze inputs below a usable width. shadcn already collapsed via
+  `md:grid-cols-N`. Fixed grid tracks were why generated multi-column forms
+  were unusable on phones; regenerate to pick the new grids up.
+- **antd sections lay out with `Row`/`Col`** instead of an inline CSS grid:
+  the kit's own 24-column idiom, responsive via `xs`/`sm` props, in both
+  layouts. Nested sections, arrays, unions, and tuples ride spanning or item
+  `Col`s; a union section keeps its vertical shell, since its children are
+  conditional fragments that cannot each be a `Col`. This is also the shape
+  that makes a per-field span a one-prop change later.
+- **mantine sections lay out with `Grid`/`Grid.Col`** instead of
+  `SimpleGrid`: responsive span objects (`span={{ base: 12, sm: 6 }}`), and
+  the container that can express a per-field span at all, which `SimpleGrid`
+  cannot. Same cell rules as antd: leaves ride item Cols, nested content
+  spans, 1-column chrome reads as a `Stack`. The version matrix caught one
+  invented prop on the way in (`Grid` has no `gutter` in v9), which is
+  exactly the drift it exists to catch.
+- **mui sections lay out with `Grid` containers** instead of `sx` CSS grids
+  — the same component the hand-written playground demos use — with the
+  spelling the pinned major actually accepts: `size={{ xs: 12, sm: 6 }}` on
+  v7/v9, legacy `item xs={12} sm={6}` on v5 **and** v6 (v6's size-prop grid
+  is the separate `Grid2` import; the matrix against real v6 declarations is
+  what established that). 1-column chrome keeps the historical Stack and
+  CardContent output.
+
+## 0.15.0 — 2026-08-04
+
+### Fixed
+
+- **`persistForm` no longer applies a draft from a different schema shape.**
+  The stored JSON was cast straight to the values type and adopted, so a draft
+  written before a schema change rebased the form onto values its own schema
+  rejects. Because the default `adopt` mode clears errors and resets the
+  baseline, the form then read **clean** while holding them, which is the worst
+  version of the failure.
+
+  A draft is now ignored when its shape conflicts with the form's: a path
+  holding a string where the form expects an object, an array of strings where
+  it expects rows. Only overlapping paths are compared, and only their kinds,
+  so a half-filled draft still restores (a draft is work in progress and would
+  fail full validation by design), and so does one that filled an optional the
+  initial values left empty.
+
+### Added
+
+- **`persistForm`'s `version` option.** Renames and removals are invisible to
+  the shape guard above, because JSON drops undefined slots and an absent key
+  is indistinguishable from an unfilled optional. `version` covers those: it is
+  stored with the draft and a mismatch discards it. Leaving it unset keeps the
+  stored format byte-identical, so existing drafts survive the upgrade.
+
 ## 0.14.0 — 2026-07-31
 
 ### Added

package/README.md

@@ -12,6 +12,7 @@ Zod-schema-first form state for React 19, backed by zustand.
 - **Field arrays** with stable IDs that survive reorders, inserts, and removes.
 - **Bound input components** with the accessibility wiring already done.
 - **A generator**: [`formstand-cli`](https://scrumrot.github.io/formstand/documentation/cli/) writes the whole component from your schema, for six UI kits.
+- **[Devtools](https://scrumrot.github.io/formstand/documentation/devtools)**: `formstand/devtools` is a panel showing every field, both error channels, and the live diff. Renders nothing in production.
 
 ## Install
 
@@ -111,6 +112,7 @@ PATCH-ready payload of exactly what changed.
 | 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) |
+| Devtools | `<FormstandDevtools form={form} />` from `formstand/devtools` | [Devtools](https://scrumrot.github.io/formstand/documentation/devtools) |
 
 Coming from react-hook-form? The
 [migration guide](https://scrumrot.github.io/formstand/documentation/migrating-from-react-hook-form)

package/dist/{createForm-C9hZffCQ.d.cts → createForm-jlzK2lCG.d.cts}

@@ -40,7 +40,7 @@ type FieldPath<T, D extends number = DefaultPathDepth> = FieldPathRec<T, Normali
 type FieldPathRec<T, D extends number> = [D] extends [0] ? never : IsArray<T> extends true ? T extends readonly (infer U)[] ? `${number}` | (IsRecord<NonNullable<U>> extends true ? `${number}.${FieldPathRec<NonNullable<U>, Prev[D]>}` : IsArray<NonNullable<U>> extends true ? `${number}.${FieldPathRec<NonNullable<U>, Prev[D]>}` : never) : never : IsRecord<T> extends true ? {
     [K in keyof T & string]: K | (IsRecord<NonNullable<T[K]>> extends true ? `${K}.${FieldPathRec<NonNullable<T[K]>, Prev[D]>}` : IsArray<NonNullable<T[K]>> extends true ? `${K}.${FieldPathRec<NonNullable<T[K]>, Prev[D]>}` : never);
 }[keyof T & string] : never;
-type StepValue<T, K extends string> = T extends readonly (infer U)[] ? K extends `${number}` ? U : never : T extends object ? K extends keyof T ? T[K] : never : never;
+type StepValue<T, K extends string> = T extends readonly (infer U)[] ? K extends keyof T ? T[K] : K extends `${number}` ? U : never : T extends object ? K extends keyof T ? T[K] : never : never;
 type FieldValue<T, P extends string> = [T] extends [NonNullable<T>] ? P extends `${infer Head}.${infer Tail}` ? FieldValue<StepValue<T, Head>, Tail> : StepValue<T, P> : FieldValue<NonNullable<T>, P> | undefined;
 
 type ValidationMode = "onChange" | "onBlur" | "onSubmit" | "onTouched" | "all";

package/dist/{createForm-C9hZffCQ.d.ts → createForm-jlzK2lCG.d.ts}

@@ -40,7 +40,7 @@ type FieldPath<T, D extends number = DefaultPathDepth> = FieldPathRec<T, Normali
 type FieldPathRec<T, D extends number> = [D] extends [0] ? never : IsArray<T> extends true ? T extends readonly (infer U)[] ? `${number}` | (IsRecord<NonNullable<U>> extends true ? `${number}.${FieldPathRec<NonNullable<U>, Prev[D]>}` : IsArray<NonNullable<U>> extends true ? `${number}.${FieldPathRec<NonNullable<U>, Prev[D]>}` : never) : never : IsRecord<T> extends true ? {
     [K in keyof T & string]: K | (IsRecord<NonNullable<T[K]>> extends true ? `${K}.${FieldPathRec<NonNullable<T[K]>, Prev[D]>}` : IsArray<NonNullable<T[K]>> extends true ? `${K}.${FieldPathRec<NonNullable<T[K]>, Prev[D]>}` : never);
 }[keyof T & string] : never;
-type StepValue<T, K extends string> = T extends readonly (infer U)[] ? K extends `${number}` ? U : never : T extends object ? K extends keyof T ? T[K] : never : never;
+type StepValue<T, K extends string> = T extends readonly (infer U)[] ? K extends keyof T ? T[K] : K extends `${number}` ? U : never : T extends object ? K extends keyof T ? T[K] : never : never;
 type FieldValue<T, P extends string> = [T] extends [NonNullable<T>] ? P extends `${infer Head}.${infer Tail}` ? FieldValue<StepValue<T, Head>, Tail> : StepValue<T, P> : FieldValue<NonNullable<T>, P> | undefined;
 
 type ValidationMode = "onChange" | "onBlur" | "onSubmit" | "onTouched" | "all";

package/dist/devtools/index.d.cts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { z } from 'zod';
-import { F as Form } from '../createForm-C9hZffCQ.cjs';
+import { F as Form } from '../createForm-jlzK2lCG.cjs';
 import 'zustand/vanilla';
 
 type DevtoolsPosition = "bottom-right" | "bottom-left" | "top-right" | "top-left";

package/dist/devtools/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { z } from 'zod';
-import { F as Form } from '../createForm-C9hZffCQ.js';
+import { F as Form } from '../createForm-jlzK2lCG.js';
 import 'zustand/vanilla';
 
 type DevtoolsPosition = "bottom-right" | "bottom-left" | "top-right" | "top-left";

package/dist/index.cjs

@@ -1140,6 +1140,25 @@ var shouldValidateOn = (trigger, mode, reValidateMode, submitAttempted, touched
 };
 
 // src/core/persist.ts
+var kindOf = (value) => value === null ? "null" : Array.isArray(value) ? "array" : typeof value;
+var conflictsWith = (draft, reference) => {
+  if (draft === void 0 || draft === null) return false;
+  if (reference === void 0 || reference === null) return false;
+  const draftKind = kindOf(draft);
+  const referenceKind = kindOf(reference);
+  if (draftKind !== referenceKind) return true;
+  if (draftKind === "array") {
+    const [d] = draft;
+    const [r] = reference;
+    return conflictsWith(d, r);
+  }
+  if (draftKind === "object") {
+    const d = draft;
+    const r = reference;
+    return Object.keys(d).some((key) => conflictsWith(d[key], r[key]));
+  }
+  return false;
+};
 var defaultStorage = () => {
   try {
     return typeof globalThis.localStorage === "undefined" ? null : globalThis.localStorage;
@@ -1152,11 +1171,29 @@ var persistForm = (form, options) => {
   const debounceMs = options.debounceMs ?? 300;
   const apply = options.apply ?? "adopt";
   const applyDraft = (values) => apply === "restore" ? form.setValues(values) : form.adoptValues(values);
+  const referenceShape = () => {
+    try {
+      return JSON.parse(JSON.stringify(form.getState().initialValues));
+    } catch {
+      return void 0;
+    }
+  };
   const restore = () => {
     try {
       const raw = storage === null ? null : storage.getItem(options.key);
       if (raw === null) return false;
-      applyDraft(JSON.parse(raw));
+      const parsed = JSON.parse(raw);
+      const versioned = options.version !== void 0 && typeof parsed === "object" && parsed !== null && "__v" in parsed;
+      if (options.version !== void 0 && !versioned) return false;
+      const wrapper = parsed;
+      if (versioned && wrapper.__v !== options.version) return false;
+      if (versioned && wrapper.values === void 0) return false;
+      const values = versioned ? wrapper.values : parsed;
+      const reference = referenceShape();
+      if (reference !== void 0 && conflictsWith(values, reference)) {
+        return false;
+      }
+      applyDraft(values);
       return true;
     } catch {
       return false;
@@ -1164,7 +1201,12 @@ var persistForm = (form, options) => {
   };
   const writeDraft = (values) => {
     try {
-      storage?.setItem(options.key, JSON.stringify(values));
+      storage?.setItem(
+        options.key,
+        JSON.stringify(
+          options.version === void 0 ? values : { __v: options.version, values }
+        )
+      );
     } catch {
     }
   };