formstand 0.12.0 → 0.14.0

package/dist/devtools/index.cjs

@@ -0,0 +1,313 @@
+'use strict';
+
+var react = require('react');
+var react$1 = require('zustand/react');
+var shallow = require('zustand/react/shallow');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/devtools/FormstandDevtools.tsx
+
+// src/core/path.ts
+var isIndexSegment = (s) => {
+  const n = Number(s);
+  return Number.isInteger(n) && n >= 0 && String(n) === s;
+};
+var PARSE_CACHE_MAX = 4096;
+var parseCache = /* @__PURE__ */ new Map();
+var parsePath = (path) => {
+  const cached = parseCache.get(path);
+  if (cached !== void 0) return cached;
+  const segments = Object.freeze(
+    path === "" ? [] : path.split(".").map((s) => isIndexSegment(s) ? Number(s) : s)
+  );
+  if (parseCache.size >= PARSE_CACHE_MAX) parseCache.clear();
+  parseCache.set(path, segments);
+  return segments;
+};
+var isPlainRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+var readSegment = (obj, segment) => {
+  if (obj == null) return void 0;
+  if (Array.isArray(obj)) {
+    return typeof segment === "number" ? obj[segment] : void 0;
+  }
+  return isPlainRecord(obj) && Object.hasOwn(obj, String(segment)) ? obj[String(segment)] : void 0;
+};
+var getAtPath = (obj, path) => parsePath(path).reduce(readSegment, obj);
+function useFormSelectorShallow(form, selector) {
+  return react$1.useStore(form.store, shallow.useShallow(selector));
+}
+
+// src/devtools/paths.ts
+var isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value) && // A Date is a leaf, not a container to recurse into: its own keys are
+// methods, and useField binds the Date itself.
+!(value instanceof Date);
+var leafPaths = (value, base = "") => {
+  const join = (key) => base === "" ? String(key) : `${base}.${String(key)}`;
+  if (Array.isArray(value)) {
+    return value.length === 0 ? [base] : value.flatMap((item, index) => leafPaths(item, join(index)));
+  }
+  if (isPlainObject(value)) {
+    const keys = Object.keys(value);
+    return keys.length === 0 ? [base] : keys.flatMap((key) => leafPaths(value[key], join(key)));
+  }
+  return [base];
+};
+var unmatchedErrorKeys = (errorKeys, leaves) => {
+  const covered = new Set(leaves);
+  return errorKeys.filter((key) => !covered.has(key));
+};
+
+// src/devtools/styles.ts
+var ANCHOR = {
+  "bottom-right": { bottom: 12, right: 12 },
+  "bottom-left": { bottom: 12, left: 12 },
+  "top-right": { top: 12, right: 12 },
+  "top-left": { top: 12, left: 12 }
+};
+var MONO = 'ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace';
+var anchorFor = (position) => ANCHOR[position];
+var styles = {
+  root: {
+    position: "fixed",
+    zIndex: 2147483e3,
+    fontFamily: MONO,
+    fontSize: 11,
+    lineHeight: 1.45,
+    color: "#e6e6e6",
+    colorScheme: "dark"
+  },
+  toggle: {
+    background: "#1b1b1f",
+    border: "1px solid #3a3a42",
+    color: "#e6e6e6",
+    borderRadius: 6,
+    padding: "6px 10px",
+    font: "inherit",
+    cursor: "pointer"
+  },
+  panel: {
+    width: "min(440px, calc(100vw - 24px))",
+    maxHeight: "min(60vh, 520px)",
+    overflow: "auto",
+    background: "#141417",
+    border: "1px solid #3a3a42",
+    borderRadius: 8,
+    boxShadow: "0 12px 32px rgba(0,0,0,0.45)"
+  },
+  header: {
+    display: "flex",
+    alignItems: "center",
+    justifyContent: "space-between",
+    gap: 8,
+    padding: "8px 10px",
+    borderBottom: "1px solid #2a2a31",
+    position: "sticky",
+    top: 0,
+    background: "#141417"
+  },
+  section: { padding: "8px 10px", borderBottom: "1px solid #23232a" },
+  sectionTitle: {
+    color: "#9aa0aa",
+    textTransform: "uppercase",
+    letterSpacing: "0.06em",
+    fontSize: 10,
+    margin: "0 0 6px"
+  },
+  table: {
+    width: "100%",
+    borderCollapse: "collapse",
+    tableLayout: "fixed"
+  },
+  th: {
+    textAlign: "left",
+    color: "#9aa0aa",
+    fontWeight: 400,
+    padding: "2px 4px",
+    borderBottom: "1px solid #2a2a31"
+  },
+  td: {
+    padding: "2px 4px",
+    verticalAlign: "top",
+    wordBreak: "break-word"
+  },
+  path: { color: "#c8b6ff" },
+  error: { color: "#ff8f8f" },
+  muted: { color: "#7d838d" },
+  flag: { color: "#7ddca4" },
+  pre: {
+    margin: 0,
+    whiteSpace: "pre-wrap",
+    wordBreak: "break-word"
+  },
+  button: {
+    background: "#22222a",
+    border: "1px solid #3a3a42",
+    color: "#e6e6e6",
+    borderRadius: 5,
+    padding: "3px 8px",
+    font: "inherit",
+    cursor: "pointer"
+  }
+};
+var isDevBuild = () => typeof process === "undefined" || process.env?.["NODE_ENV"] !== "production";
+var preview = (value) => {
+  if (value === void 0) return "undefined";
+  if (value instanceof Date) return value.toISOString();
+  const json = JSON.stringify(value);
+  return json === void 0 ? String(value) : json.length > 60 ? `${json.slice(0, 57)}\u2026` : json;
+};
+var flags = (row) => [
+  row.touched ? "touched" : "",
+  row.dirty ? "dirty" : "",
+  row.isValidating ? "validating" : ""
+].filter((flag) => flag !== "").join(" ");
+var useDevtoolsState = (form) => useFormSelectorShallow(form, (state) => ({
+  values: state.values,
+  errors: state.errors,
+  schemaErrors: state.schemaErrors,
+  serverErrors: state.serverErrors,
+  touched: state.touched,
+  isValidating: state.isValidating,
+  isSubmitting: state.isSubmitting,
+  isValidatingForm: state.isValidatingForm,
+  submitCount: state.submitCount,
+  mode: state.mode
+}));
+var Section = ({
+  title,
+  children
+}) => /* @__PURE__ */ jsxRuntime.jsxs("div", { style: styles.section, children: [
+  /* @__PURE__ */ jsxRuntime.jsx("p", { style: styles.sectionTitle, children: title }),
+  children
+] });
+var DevtoolsPanel = ({
+  form,
+  position = "bottom-right",
+  defaultOpen = false,
+  label = "formstand"
+}) => {
+  const state = useDevtoolsState(form);
+  const [open, setOpen] = react.useState(defaultOpen);
+  const [held, setHeld] = react.useState(null);
+  const rows = leafPaths(state.values).map((path) => {
+    const field = form.getFieldState(path);
+    return {
+      path,
+      value: field.value,
+      error: field.error,
+      touched: field.touched,
+      dirty: field.dirty,
+      isValidating: field.isValidating
+    };
+  });
+  const orphanErrors = unmatchedErrorKeys(
+    Object.keys(state.errors),
+    rows.map((row) => row.path)
+  );
+  const diff = form.diff();
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { style: { ...styles.root, ...anchorFor(position) }, children: open ? /* @__PURE__ */ jsxRuntime.jsxs("div", { style: styles.panel, children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { style: styles.header, children: [
+      /* @__PURE__ */ jsxRuntime.jsx("strong", { children: label }),
+      /* @__PURE__ */ jsxRuntime.jsxs("span", { style: styles.muted, children: [
+        state.mode,
+        state.isSubmitting ? " \xB7 submitting" : "",
+        state.isValidatingForm ? " \xB7 validating" : "",
+        state.submitCount > 0 ? ` \xB7 submits ${state.submitCount}` : ""
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          style: styles.button,
+          onClick: () => setOpen(false),
+          children: "close"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsx(Section, { title: `fields (${rows.length})`, children: /* @__PURE__ */ jsxRuntime.jsxs("table", { style: styles.table, children: [
+      /* @__PURE__ */ jsxRuntime.jsx("thead", { children: /* @__PURE__ */ jsxRuntime.jsxs("tr", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("th", { style: { ...styles.th, width: "38%" }, children: "path" }),
+        /* @__PURE__ */ jsxRuntime.jsx("th", { style: styles.th, children: "value" }),
+        /* @__PURE__ */ jsxRuntime.jsx("th", { style: { ...styles.th, width: "26%" }, children: "state" })
+      ] }) }),
+      /* @__PURE__ */ jsxRuntime.jsx("tbody", { children: rows.map((row) => /* @__PURE__ */ jsxRuntime.jsxs("tr", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("td", { style: { ...styles.td, ...styles.path }, children: row.path }),
+        /* @__PURE__ */ jsxRuntime.jsxs("td", { style: styles.td, children: [
+          preview(row.value),
+          row.error === void 0 ? null : /* @__PURE__ */ jsxRuntime.jsx("div", { style: styles.error, children: row.error.join(", ") })
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx("td", { style: { ...styles.td, ...styles.flag }, children: flags(row) })
+      ] }, row.path)) })
+    ] }) }),
+    orphanErrors.length === 0 ? null : (
+      // Errors with no field of their own: the root "" key, array-level
+      // messages, server verdicts on paths that hold no value yet.
+      /* @__PURE__ */ jsxRuntime.jsx(Section, { title: "errors without a field", children: orphanErrors.map((key) => /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { style: styles.path, children: key === "" ? "(root)" : key }),
+        " ",
+        /* @__PURE__ */ jsxRuntime.jsx("span", { style: styles.error, children: (state.errors[key] ?? []).join(", ") })
+      ] }, key)) })
+    ),
+    /* @__PURE__ */ jsxRuntime.jsxs(Section, { title: "error channels", children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { style: styles.muted, children: [
+        "schema ",
+        Object.keys(state.schemaErrors).length,
+        " \xB7 server",
+        " ",
+        Object.keys(state.serverErrors).length
+      ] }),
+      Object.entries(state.serverErrors).map(([key, messages]) => /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { style: styles.path, children: key === "" ? "(root)" : key }),
+        " ",
+        /* @__PURE__ */ jsxRuntime.jsx("span", { style: styles.error, children: messages.join(", ") }),
+        " ",
+        /* @__PURE__ */ jsxRuntime.jsx("span", { style: styles.muted, children: getAtPath(state.schemaErrors, key) === void 0 ? "(showing)" : "(behind a schema error)" })
+      ] }, key))
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsx(Section, { title: "diff vs initial", children: /* @__PURE__ */ jsxRuntime.jsx("pre", { style: styles.pre, children: Object.keys(diff).length === 0 ? "clean" : JSON.stringify(diff, null, 2) }) }),
+    /* @__PURE__ */ jsxRuntime.jsxs(Section, { title: "time travel", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          style: styles.button,
+          onClick: () => setHeld(form.snapshot()),
+          children: "snapshot"
+        }
+      ),
+      " ",
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          style: styles.button,
+          disabled: held === null,
+          onClick: () => {
+            if (held !== null) form.restore(held);
+          },
+          children: "restore"
+        }
+      ),
+      " ",
+      /* @__PURE__ */ jsxRuntime.jsx("span", { style: styles.muted, children: held === null ? "nothing held" : "snapshot held" })
+    ] })
+  ] }) : /* @__PURE__ */ jsxRuntime.jsxs(
+    "button",
+    {
+      type: "button",
+      style: styles.toggle,
+      onClick: () => setOpen(true),
+      children: [
+        label,
+        Object.keys(state.errors).length > 0 ? ` \xB7 ${String(Object.keys(state.errors).length)} err` : ""
+      ]
+    }
+  ) });
+};
+var FormstandDevtools = (props) => isDevBuild() ? /* @__PURE__ */ jsxRuntime.jsx(DevtoolsPanel, { ...props }) : null;
+
+exports.FormstandDevtools = FormstandDevtools;
+exports.leafPaths = leafPaths;
+exports.unmatchedErrorKeys = unmatchedErrorKeys;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/devtools/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/path.ts","../../src/react/useFormSelector.ts","../../src/devtools/paths.ts","../../src/devtools/styles.ts","../../src/devtools/FormstandDevtools.tsx"],"names":["useStore","useShallow","jsxs","jsx","useState"],"mappings":"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","file":"index.cjs","sourcesContent":["import { isPlainObject } from \"./equality\";\n\nexport type PathSegment = string | number;\n\n// Segment keys containing \".\" are not addressable (paths are split on dots);\n// use nested objects or index-free keys instead.\n\n// Writes above this index are refused — a typo'd path like \"items.4294967296\"\n// must not allocate a multi-gigabyte array.\nconst MAX_ARRAY_INDEX = 100_000;\n\nconst isIndexSegment = (s: string): boolean => {\n  const n = Number(s);\n  return Number.isInteger(n) && n >= 0 && String(n) === s;\n};\n\n// Hot path: every field subscription re-resolves its path on every store\n// notification (getAtPath in selectors), so parsing is memoized — a form's\n// paths are a small fixed set. Bounded like equality's dirtyCache: a\n// pathological unbounded key set resets the cache instead of growing it\n// forever (the reset only costs re-parsing, never correctness).\nconst PARSE_CACHE_MAX = 4096;\nconst parseCache = new Map<string, readonly PathSegment[]>();\n\nexport const parsePath = (path: string): readonly PathSegment[] => {\n  const cached = parseCache.get(path);\n  if (cached !== undefined) return cached;\n  // Frozen because the array is now SHARED across every caller (and cached):\n  // parsePath is a public export, and pre-cache each call returned a private\n  // array that was safe to mutate. Freezing enforces the `readonly` type at\n  // runtime so an external `.sort()`/`.reverse()`/`.push()` throws instead of\n  // silently corrupting the cache for every later lookup of this path.\n  const segments = Object.freeze(\n    path === \"\"\n      ? []\n      : path.split(\".\").map((s) => (isIndexSegment(s) ? Number(s) : s)),\n  );\n  if (parseCache.size >= PARSE_CACHE_MAX) parseCache.clear();\n  parseCache.set(path, segments);\n  return segments;\n};\n\nconst isPlainRecord = (value: unknown): value is Record<string, unknown> =>\n  value !== null && typeof value === \"object\" && !Array.isArray(value);\n\n// The existing container decides how a segment is interpreted: arrays take\n// numeric segments as indices, records take any segment as a string key (so a\n// z.record keyed \"0\" reads/writes the record key, not an array index). Only\n// when the container is absent does the segment type pick what gets created.\nconst readSegment = (obj: unknown, segment: PathSegment): unknown => {\n  if (obj == null) return undefined;\n  if (Array.isArray(obj)) {\n    return typeof segment === \"number\" ? obj[segment] : undefined;\n  }\n  // Own properties only: a runtime-built path like \"lookup.constructor\" on a\n  // z.record must read as absent, not leak Object.prototype members as field\n  // values.\n  return isPlainRecord(obj) && Object.hasOwn(obj, String(segment))\n    ? obj[String(segment)]\n    : undefined;\n};\n\nexport const getAtPath = (obj: unknown, path: string): unknown =>\n  parsePath(path).reduce<unknown>(readSegment, obj);\n\nexport type SlotAtPath =\n  | Readonly<{ exists: true; value: unknown }>\n  | Readonly<{ exists: false }>;\n\n// Resolve `path` while checking that every segment is read from a real\n// container: an in-range array index, or a key on a plain record (containers\n// decide, mirroring readSegment). A segment into an absent or non-container\n// value addresses no slot at all — a full-form parse would key that error at\n// the missing ANCESTOR, not here, so field-scoped validation must skip it\n// rather than parse the leaf's subschema against undefined (which would\n// fabricate a spurious \"required\" error the full pass never produces). Note\n// this checks the CONTAINER, not the value: a leaf that is undefined at the\n// FINAL step through a real record is still an addressable (legitimately\n// empty) slot. Returns the resolved value so callers don't walk twice.\nexport const slotAtPath = (obj: unknown, path: string): SlotAtPath => {\n  const walked = parsePath(path).reduce<\n    Readonly<{ ok: boolean; current: unknown }>\n  >(\n    (acc, segment) => {\n      const container = acc.current;\n      const addressable =\n        typeof segment === \"number\"\n          ? Array.isArray(container)\n            ? segment < container.length\n            : isPlainRecord(container)\n          : isPlainRecord(container);\n      return !acc.ok || !addressable\n        ? { ok: false, current: undefined }\n        : { ok: true, current: readSegment(container, segment) };\n    },\n    { ok: true, current: obj },\n  );\n  return walked.ok ? { exists: true, value: walked.current } : { exists: false };\n};\n\n// Whether the path addresses an OWN slot: every step reads a real\n// container's own key / in-range array index, the final segment included.\n// This is stricter than slotAtPath, which treats a MISSING final key on a\n// real record as an addressable (legitimately empty) slot — here it reads\n// false. The consumer is setValue's identity guard: writing `undefined`\n// over an ABSENT key is NOT a no-op (it creates the key, a real state\n// change — key-count dirtiness, persisted shape), while writing it over a\n// key that exists holding undefined is.\nexport const hasOwnSlot = (obj: unknown, path: string): boolean =>\n  parsePath(path).reduce<Readonly<{ ok: boolean; current: unknown }>>(\n    (acc, segment) => {\n      const container = acc.current;\n      const owns = Array.isArray(container)\n        ? typeof segment === \"number\" && segment < container.length\n        : isPlainRecord(container) && Object.hasOwn(container, String(segment));\n      return !acc.ok || !owns\n        ? { ok: false, current: undefined }\n        : { ok: true, current: readSegment(container, segment) };\n    },\n    { ok: true, current: obj },\n  ).ok;\n\nconst writeIntoArray = (\n  arr: readonly unknown[],\n  index: number,\n  rest: readonly PathSegment[],\n  value: unknown,\n): readonly unknown[] => {\n  const length = Math.max(arr.length, index + 1);\n  return Array.from({ length }, (_, i) =>\n    i === index ? writeSegments(arr[i], rest, value) : arr[i],\n  );\n};\n\nconst refusesHugeIndex = (index: number): boolean => {\n  if (index > MAX_ARRAY_INDEX) {\n    console.warn(\n      `[formstand] refusing to write array index ${index} (max ${MAX_ARRAY_INDEX}); value left unchanged.`,\n    );\n    return true;\n  }\n  return false;\n};\n\nconst writeSegments = (\n  obj: unknown,\n  segments: readonly PathSegment[],\n  value: unknown,\n): unknown => {\n  const [head, ...rest] = segments;\n  if (head === undefined) return value;\n\n  if (Array.isArray(obj)) {\n    if (typeof head !== \"number\") {\n      console.warn(\n        `[formstand] cannot write string key \"${head}\" into an array; value left unchanged.`,\n      );\n      return obj;\n    }\n    if (refusesHugeIndex(head)) return obj;\n    return writeIntoArray(obj, head, rest, value);\n  }\n\n  // Records take any segment as a string key (mirroring readSegment), so a\n  // z.record keyed by a large numeric id is writable — the array-index cap\n  // only applies where an array actually exists or would be created.\n  if (isPlainRecord(obj)) {\n    // Spreading is only safe for PLAIN objects: spreading a Date/Map/Set or\n    // class instance keeps own enumerable props but drops the prototype (and\n    // for Map/Set, every entry) — the original would be silently destroyed.\n    // Refuse, like the other unwritable shapes above.\n    if (!isPlainObject(obj)) {\n      console.warn(\n        `[formstand] cannot write key \"${String(head)}\" through a non-plain object (Date/Map/Set/class instance); value left unchanged.`,\n      );\n      return obj;\n    }\n    const key = String(head);\n    return { ...obj, [key]: writeSegments(obj[key], rest, value) };\n  }\n\n  // Absent (or non-container) value: create a container from the segment type.\n  if (typeof head === \"number\") {\n    if (refusesHugeIndex(head)) return obj;\n    return writeIntoArray([], head, rest, value);\n  }\n  return { [head]: writeSegments(undefined, rest, value) };\n};\n\nexport const setAtPath = <T>(obj: T, path: string, value: unknown): T =>\n  writeSegments(obj, parsePath(path), value) as T;\n","import type { z } from \"zod\";\nimport type { StoreApi } from \"zustand/vanilla\";\nimport { useStore } from \"zustand/react\";\nimport { useShallow } from \"zustand/react/shallow\";\nimport type { Form } from \"../core/createForm\";\nimport type { DefaultPathDepth, PathDepth } from \"../core/fieldPath\";\nimport type { FormState } from \"../core/types\";\n\ntype ReadonlyStore<T> = Pick<\n  StoreApi<T>,\n  \"getState\" | \"getInitialState\" | \"subscribe\"\n>;\n\nexport type FormStateApi = Readonly<{\n  store: ReadonlyStore<FormState<unknown>>;\n}>;\n\nexport function useFormSelector<\n  TSchema extends z.ZodType,\n  U,\n  D extends PathDepth = DefaultPathDepth,\n>(\n  form: Form<TSchema, D>,\n  selector: (state: FormState<z.input<TSchema>>) => U,\n): U;\n// The `schema?: undefined` brand forces Form<TSchema> (which has a real\n// `schema` property) to bind only the typed overload above. Without\n// it, Form<TSchema> would structurally satisfy FormStateApi too and a\n// bad selector could silently widen to FormState<unknown>.\nexport function useFormSelector<U>(\n  form: FormStateApi & { readonly schema?: undefined },\n  selector: (state: FormState<unknown>) => U,\n): U;\nexport function useFormSelector<U>(\n  form: FormStateApi,\n  selector: (state: FormState<unknown>) => U,\n): U {\n  return useStore(form.store, selector);\n}\n\nexport function useFormSelectorShallow<\n  TSchema extends z.ZodType,\n  U,\n  D extends PathDepth = DefaultPathDepth,\n>(\n  form: Form<TSchema, D>,\n  selector: (state: FormState<z.input<TSchema>>) => U,\n): U;\nexport function useFormSelectorShallow<U>(\n  form: FormStateApi & { readonly schema?: undefined },\n  selector: (state: FormState<unknown>) => U,\n): U;\nexport function useFormSelectorShallow<U>(\n  form: FormStateApi,\n  selector: (state: FormState<unknown>) => U,\n): U {\n  return useStore(form.store, useShallow(selector));\n}\n","// Walking a values object into the list of paths the panel shows.\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" &&\n  value !== null &&\n  !Array.isArray(value) &&\n  // A Date is a leaf, not a container to recurse into: its own keys are\n  // methods, and useField binds the Date itself.\n  !(value instanceof Date);\n\n// The addressable leaf paths of a values object, in declaration order.\n// Arrays contribute one path per ROW rather than one for the array, because\n// that is what a field binds to; the array's own path still shows up in the\n// panel via the error map, which is where `z.array().min(1)` lands.\n//\n// An empty object or array is itself a leaf here. It has no children to\n// describe, and dropping it would hide a field that exists in the schema.\nexport const leafPaths = (value: unknown, base = \"\"): readonly string[] => {\n  const join = (key: string | number): string =>\n    base === \"\" ? String(key) : `${base}.${String(key)}`;\n\n  if (Array.isArray(value)) {\n    return value.length === 0\n      ? [base]\n      : value.flatMap((item, index) => leafPaths(item, join(index)));\n  }\n  if (isPlainObject(value)) {\n    const keys = Object.keys(value);\n    return keys.length === 0\n      ? [base]\n      : keys.flatMap((key) => leafPaths(value[key], join(key)));\n  }\n  return [base];\n};\n\n// Error keys that no leaf path covers: the root \"\" key (a schema-wide\n// refine), array-level messages keyed at the container, and server verdicts\n// written at a path that holds no value yet. Without this the panel would\n// silently drop exactly the errors that are hardest to debug.\nexport const unmatchedErrorKeys = (\n  errorKeys: readonly string[],\n  leaves: readonly string[],\n): readonly string[] => {\n  const covered = new Set(leaves);\n  return errorKeys.filter((key) => !covered.has(key));\n};\n","import type { CSSProperties } from \"react\";\n\n// Inline styles on purpose: a devtools panel that needs the consumer to\n// import a stylesheet is a devtools panel that renders unstyled the first\n// time someone tries it. Inline also means nothing here can leak into or be\n// overridden by the host app's CSS, which matters when the whole job is\n// showing you the truth about your form.\n\nexport type DevtoolsPosition =\n  | \"bottom-right\"\n  | \"bottom-left\"\n  | \"top-right\"\n  | \"top-left\";\n\nconst ANCHOR: Readonly<Record<DevtoolsPosition, CSSProperties>> = {\n  \"bottom-right\": { bottom: 12, right: 12 },\n  \"bottom-left\": { bottom: 12, left: 12 },\n  \"top-right\": { top: 12, right: 12 },\n  \"top-left\": { top: 12, left: 12 },\n};\n\nconst MONO =\n  'ui-monospace, SFMono-Regular, Menlo, Consolas, \"Liberation Mono\", monospace';\n\nexport const anchorFor = (position: DevtoolsPosition): CSSProperties =>\n  ANCHOR[position];\n\nexport const styles = {\n  root: {\n    position: \"fixed\",\n    zIndex: 2147483000,\n    fontFamily: MONO,\n    fontSize: 11,\n    lineHeight: 1.45,\n    color: \"#e6e6e6\",\n    colorScheme: \"dark\",\n  } satisfies CSSProperties,\n  toggle: {\n    background: \"#1b1b1f\",\n    border: \"1px solid #3a3a42\",\n    color: \"#e6e6e6\",\n    borderRadius: 6,\n    padding: \"6px 10px\",\n    font: \"inherit\",\n    cursor: \"pointer\",\n  } satisfies CSSProperties,\n  panel: {\n    width: \"min(440px, calc(100vw - 24px))\",\n    maxHeight: \"min(60vh, 520px)\",\n    overflow: \"auto\",\n    background: \"#141417\",\n    border: \"1px solid #3a3a42\",\n    borderRadius: 8,\n    boxShadow: \"0 12px 32px rgba(0,0,0,0.45)\",\n  } satisfies CSSProperties,\n  header: {\n    display: \"flex\",\n    alignItems: \"center\",\n    justifyContent: \"space-between\",\n    gap: 8,\n    padding: \"8px 10px\",\n    borderBottom: \"1px solid #2a2a31\",\n    position: \"sticky\",\n    top: 0,\n    background: \"#141417\",\n  } satisfies CSSProperties,\n  section: { padding: \"8px 10px\", borderBottom: \"1px solid #23232a\" },\n  sectionTitle: {\n    color: \"#9aa0aa\",\n    textTransform: \"uppercase\",\n    letterSpacing: \"0.06em\",\n    fontSize: 10,\n    margin: \"0 0 6px\",\n  } satisfies CSSProperties,\n  table: {\n    width: \"100%\",\n    borderCollapse: \"collapse\",\n    tableLayout: \"fixed\",\n  } satisfies CSSProperties,\n  th: {\n    textAlign: \"left\",\n    color: \"#9aa0aa\",\n    fontWeight: 400,\n    padding: \"2px 4px\",\n    borderBottom: \"1px solid #2a2a31\",\n  } satisfies CSSProperties,\n  td: {\n    padding: \"2px 4px\",\n    verticalAlign: \"top\",\n    wordBreak: \"break-word\",\n  } satisfies CSSProperties,\n  path: { color: \"#c8b6ff\" } satisfies CSSProperties,\n  error: { color: \"#ff8f8f\" } satisfies CSSProperties,\n  muted: { color: \"#7d838d\" } satisfies CSSProperties,\n  flag: { color: \"#7ddca4\" } satisfies CSSProperties,\n  pre: {\n    margin: 0,\n    whiteSpace: \"pre-wrap\",\n    wordBreak: \"break-word\",\n  } satisfies CSSProperties,\n  button: {\n    background: \"#22222a\",\n    border: \"1px solid #3a3a42\",\n    color: \"#e6e6e6\",\n    borderRadius: 5,\n    padding: \"3px 8px\",\n    font: \"inherit\",\n    cursor: \"pointer\",\n  } satisfies CSSProperties,\n} as const;\n","import { type ReactNode, useState } from \"react\";\nimport type { z } from \"zod\";\nimport type { Form } from \"../core/createForm\";\nimport type { FieldPath } from \"../core/fieldPath\";\nimport { getAtPath } from \"../core/path\";\nimport type { FormState } from \"../core/types\";\nimport { useFormSelectorShallow } from \"../react/useFormSelector\";\nimport { leafPaths, unmatchedErrorKeys } from \"./paths\";\nimport { type DevtoolsPosition, anchorFor, styles } from \"./styles\";\n\nexport type FormstandDevtoolsProps<TSchema extends z.ZodType> = Readonly<{\n  form: Form<TSchema>;\n  position?: DevtoolsPosition;\n  defaultOpen?: boolean;\n  /** Shown on the toggle, for telling two mounted panels apart. */\n  label?: string;\n}>;\n\ntype FieldRow = Readonly<{\n  path: string;\n  value: unknown;\n  error: readonly string[] | undefined;\n  touched: boolean;\n  dirty: boolean;\n  isValidating: boolean;\n}>;\n\n// Non-production only, matching createForm's own devtools gate: the panel is\n// a debugging affordance, and shipping it to end users would leak the whole\n// form state into the page. Bundlers that define NODE_ENV drop the panel\n// entirely; the `typeof process` guard keeps it from throwing in runtimes\n// that define no process at all.\nconst isDevBuild = (): boolean =>\n  typeof process === \"undefined\" ||\n  process.env?.[\"NODE_ENV\"] !== \"production\";\n\nconst preview = (value: unknown): string => {\n  if (value === undefined) return \"undefined\";\n  if (value instanceof Date) return value.toISOString();\n  const json = JSON.stringify(value);\n  // Long strings and big row objects would push the value column past the\n  // panel; the full value is one expand away in the Values section.\n  return json === undefined\n    ? String(value)\n    : json.length > 60\n      ? `${json.slice(0, 57)}…`\n      : json;\n};\n\nconst flags = (row: FieldRow): string =>\n  [\n    row.touched ? \"touched\" : \"\",\n    row.dirty ? \"dirty\" : \"\",\n    row.isValidating ? \"validating\" : \"\",\n  ]\n    .filter((flag) => flag !== \"\")\n    .join(\" \");\n\n// Reads every slice the panel renders in ONE shallow-compared subscription.\n// Each member is a stored reference the form replaces on write, so shallow\n// equality is stable — deriving anything fresh (an array from dirtyFields())\n// inside the selector would hand the store a new reference every pass and\n// loop it (React #185).\nconst useDevtoolsState = <TSchema extends z.ZodType>(form: Form<TSchema>) =>\n  useFormSelectorShallow(form, (state) => ({\n    values: state.values,\n    errors: state.errors,\n    schemaErrors: state.schemaErrors,\n    serverErrors: state.serverErrors,\n    touched: state.touched,\n    isValidating: state.isValidating,\n    isSubmitting: state.isSubmitting,\n    isValidatingForm: state.isValidatingForm,\n    submitCount: state.submitCount,\n    mode: state.mode,\n  }));\n\nconst Section = ({\n  title,\n  children,\n}: Readonly<{ title: string; children: ReactNode }>) => (\n  <div style={styles.section}>\n    <p style={styles.sectionTitle}>{title}</p>\n    {children}\n  </div>\n);\n\nconst DevtoolsPanel = <TSchema extends z.ZodType>({\n  form,\n  position = \"bottom-right\",\n  defaultOpen = false,\n  label = \"formstand\",\n}: FormstandDevtoolsProps<TSchema>) => {\n  const state = useDevtoolsState(form);\n  const [open, setOpen] = useState(defaultOpen);\n  const [held, setHeld] = useState<FormState<z.input<TSchema>> | null>(null);\n\n  // Computed every render rather than memoized. getFieldState and diff() read\n  // through `form`, not through anything in a dependency array, so a memo\n  // would need deps the linter can't see and would go stale the moment one\n  // was missed. This component only re-renders when the subscription above\n  // reports a real change, so recomputing is both cheap and always right.\n  const rows: readonly FieldRow[] = leafPaths(state.values).map((path) => {\n    // Runtime-built strings need the cast the typed surface documents.\n    // getFieldState rather than re-deriving dirty here, so the panel reports\n    // the library's own comparison rules (Dates by timestamp, deep for\n    // containers) instead of offering a second opinion.\n    const field = form.getFieldState(path as FieldPath<z.input<TSchema>>);\n    return {\n      path,\n      value: field.value,\n      error: field.error,\n      touched: field.touched,\n      dirty: field.dirty,\n      isValidating: field.isValidating,\n    };\n  });\n\n  const orphanErrors = unmatchedErrorKeys(\n    Object.keys(state.errors),\n    rows.map((row) => row.path),\n  );\n\n  const diff = form.diff();\n\n  return (\n    <div style={{ ...styles.root, ...anchorFor(position) }}>\n      {open ? (\n        <div style={styles.panel}>\n          <div style={styles.header}>\n            <strong>{label}</strong>\n            <span style={styles.muted}>\n              {state.mode}\n              {state.isSubmitting ? \" · submitting\" : \"\"}\n              {state.isValidatingForm ? \" · validating\" : \"\"}\n              {state.submitCount > 0 ? ` · submits ${state.submitCount}` : \"\"}\n            </span>\n            <button\n              type=\"button\"\n              style={styles.button}\n              onClick={() => setOpen(false)}\n            >\n              close\n            </button>\n          </div>\n\n          <Section title={`fields (${rows.length})`}>\n            <table style={styles.table}>\n              <thead>\n                <tr>\n                  <th style={{ ...styles.th, width: \"38%\" }}>path</th>\n                  <th style={styles.th}>value</th>\n                  <th style={{ ...styles.th, width: \"26%\" }}>state</th>\n                </tr>\n              </thead>\n              <tbody>\n                {rows.map((row) => (\n                  <tr key={row.path}>\n                    <td style={{ ...styles.td, ...styles.path }}>{row.path}</td>\n                    <td style={styles.td}>\n                      {preview(row.value)}\n                      {row.error === undefined ? null : (\n                        <div style={styles.error}>{row.error.join(\", \")}</div>\n                      )}\n                    </td>\n                    <td style={{ ...styles.td, ...styles.flag }}>\n                      {flags(row)}\n                    </td>\n                  </tr>\n                ))}\n              </tbody>\n            </table>\n          </Section>\n\n          {orphanErrors.length === 0 ? null : (\n            // Errors with no field of their own: the root \"\" key, array-level\n            // messages, server verdicts on paths that hold no value yet.\n            <Section title=\"errors without a field\">\n              {orphanErrors.map((key) => (\n                <div key={key}>\n                  <span style={styles.path}>{key === \"\" ? \"(root)\" : key}</span>{\" \"}\n                  <span style={styles.error}>\n                    {(state.errors[key] ?? []).join(\", \")}\n                  </span>\n                </div>\n              ))}\n            </Section>\n          )}\n\n          <Section title=\"error channels\">\n            <div style={styles.muted}>\n              schema {Object.keys(state.schemaErrors).length} · server{\" \"}\n              {Object.keys(state.serverErrors).length}\n            </div>\n            {Object.entries(state.serverErrors).map(([key, messages]) => (\n              <div key={key}>\n                <span style={styles.path}>{key === \"\" ? \"(root)\" : key}</span>{\" \"}\n                <span style={styles.error}>{messages.join(\", \")}</span>{\" \"}\n                <span style={styles.muted}>\n                  {getAtPath(state.schemaErrors, key) === undefined\n                    ? \"(showing)\"\n                    : \"(behind a schema error)\"}\n                </span>\n              </div>\n            ))}\n          </Section>\n\n          <Section title=\"diff vs initial\">\n            <pre style={styles.pre}>\n              {Object.keys(diff).length === 0\n                ? \"clean\"\n                : JSON.stringify(diff, null, 2)}\n            </pre>\n          </Section>\n\n          <Section title=\"time travel\">\n            <button\n              type=\"button\"\n              style={styles.button}\n              onClick={() => setHeld(form.snapshot())}\n            >\n              snapshot\n            </button>{\" \"}\n            <button\n              type=\"button\"\n              style={styles.button}\n              disabled={held === null}\n              onClick={() => {\n                if (held !== null) form.restore(held);\n              }}\n            >\n              restore\n            </button>{\" \"}\n            <span style={styles.muted}>\n              {held === null ? \"nothing held\" : \"snapshot held\"}\n            </span>\n          </Section>\n        </div>\n      ) : (\n        <button\n          type=\"button\"\n          style={styles.toggle}\n          onClick={() => setOpen(true)}\n        >\n          {label}\n          {Object.keys(state.errors).length > 0\n            ? ` · ${String(Object.keys(state.errors).length)} err`\n            : \"\"}\n        </button>\n      )}\n    </div>\n  );\n};\n\n/**\n * A form-aware debugging panel: every field's value, error, and flags, the\n * two error channels shown separately, the live diff against initial values,\n * and snapshot/restore time travel.\n *\n * Renders nothing in production builds.\n */\nexport const FormstandDevtools = <TSchema extends z.ZodType>(\n  props: FormstandDevtoolsProps<TSchema>,\n) => (isDevBuild() ? <DevtoolsPanel {...props} /> : null);\n"]}

package/dist/devtools/index.d.cts

@@ -0,0 +1,27 @@
+import * as react from 'react';
+import { z } from 'zod';
+import { F as Form } from '../createForm-C9hZffCQ.cjs';
+import 'zustand/vanilla';
+
+type DevtoolsPosition = "bottom-right" | "bottom-left" | "top-right" | "top-left";
+
+type FormstandDevtoolsProps<TSchema extends z.ZodType> = Readonly<{
+    form: Form<TSchema>;
+    position?: DevtoolsPosition;
+    defaultOpen?: boolean;
+    /** Shown on the toggle, for telling two mounted panels apart. */
+    label?: string;
+}>;
+/**
+ * A form-aware debugging panel: every field's value, error, and flags, the
+ * two error channels shown separately, the live diff against initial values,
+ * and snapshot/restore time travel.
+ *
+ * Renders nothing in production builds.
+ */
+declare const FormstandDevtools: <TSchema extends z.ZodType>(props: FormstandDevtoolsProps<TSchema>) => react.JSX.Element | null;
+
+declare const leafPaths: (value: unknown, base?: string) => readonly string[];
+declare const unmatchedErrorKeys: (errorKeys: readonly string[], leaves: readonly string[]) => readonly string[];
+
+export { type DevtoolsPosition, FormstandDevtools, type FormstandDevtoolsProps, leafPaths, unmatchedErrorKeys };

package/dist/devtools/index.d.ts

@@ -0,0 +1,27 @@
+import * as react from 'react';
+import { z } from 'zod';
+import { F as Form } from '../createForm-C9hZffCQ.js';
+import 'zustand/vanilla';
+
+type DevtoolsPosition = "bottom-right" | "bottom-left" | "top-right" | "top-left";
+
+type FormstandDevtoolsProps<TSchema extends z.ZodType> = Readonly<{
+    form: Form<TSchema>;
+    position?: DevtoolsPosition;
+    defaultOpen?: boolean;
+    /** Shown on the toggle, for telling two mounted panels apart. */
+    label?: string;
+}>;
+/**
+ * A form-aware debugging panel: every field's value, error, and flags, the
+ * two error channels shown separately, the live diff against initial values,
+ * and snapshot/restore time travel.
+ *
+ * Renders nothing in production builds.
+ */
+declare const FormstandDevtools: <TSchema extends z.ZodType>(props: FormstandDevtoolsProps<TSchema>) => react.JSX.Element | null;
+
+declare const leafPaths: (value: unknown, base?: string) => readonly string[];
+declare const unmatchedErrorKeys: (errorKeys: readonly string[], leaves: readonly string[]) => readonly string[];
+
+export { type DevtoolsPosition, FormstandDevtools, type FormstandDevtoolsProps, leafPaths, unmatchedErrorKeys };