@lattice-php/lattice 0.17.1 → 0.18.0

package/dist/form/{components → hooks}/context.d.ts

@@ -1,12 +1,15 @@
+import { Option } from '../../core/types.js';
 type FormContextValue = {
     action: string;
     clearErrors: (field: string) => void;
     componentId?: string;
     componentRef: string;
     errors: Record<string, string | undefined>;
+    fieldIdPrefix?: string;
     fieldLabels: Record<string, string>;
     precognitive: boolean;
     processing: boolean;
+    searchOptions?: (field: string, query: string, values: Record<string, unknown>, signal: AbortSignal) => Promise<Option[]>;
     validate: (field: string) => void;
 };
 export declare function FormProvider({ children, value, }: {

package/dist/form/{components → hooks}/context.js

@@ -1,12 +1,13 @@
 import { createContext, useContext } from "react";
 import { jsx } from "react/jsx-runtime";
-//#region resources/js/form/components/context.tsx
+//#region resources/js/form/hooks/context.tsx
 var FormContext = createContext({
 	action: "#",
 	clearErrors: () => {},
 	componentId: void 0,
 	componentRef: "",
 	errors: {},
+	fieldIdPrefix: void 0,
 	fieldLabels: {},
 	precognitive: false,
 	processing: false,

package/dist/form/hooks/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../../resources/js/form/hooks/context.tsx"],"sourcesContent":["import { createContext, useContext } from \"react\";\nimport type { Option } from \"@lattice-php/lattice/core/types\";\n\ntype FormContextValue = {\n  action: string;\n  clearErrors: (field: string) => void;\n  componentId?: string;\n  componentRef: string;\n  errors: Record<string, string | undefined>;\n  fieldIdPrefix?: string;\n  fieldLabels: Record<string, string>;\n  precognitive: boolean;\n  processing: boolean;\n  searchOptions?: (\n    field: string,\n    query: string,\n    values: Record<string, unknown>,\n    signal: AbortSignal,\n  ) => Promise<Option[]>;\n  validate: (field: string) => void;\n};\n\nconst FormContext = createContext<FormContextValue>({\n  action: \"#\",\n  clearErrors: () => {},\n  componentId: undefined,\n  componentRef: \"\",\n  errors: {},\n  fieldIdPrefix: undefined,\n  fieldLabels: {},\n  precognitive: false,\n  processing: false,\n  validate: () => {},\n});\n\nexport function FormProvider({\n  children,\n  value,\n}: {\n  children: React.ReactNode;\n  value: FormContextValue;\n}) {\n  return <FormContext.Provider value={value}>{children}</FormContext.Provider>;\n}\n\nexport function useFormContext() {\n  return useContext(FormContext);\n}\n"],"mappings":";;;AAsBA,IAAM,cAAc,cAAgC;CAClD,QAAQ;CACR,mBAAmB,CAAC;CACpB,aAAa,KAAA;CACb,cAAc;CACd,QAAQ,CAAC;CACT,eAAe,KAAA;CACf,aAAa,CAAC;CACd,cAAc;CACd,YAAY;CACZ,gBAAgB,CAAC;AACnB,CAAC;AAED,SAAgB,aAAa,EAC3B,UACA,SAIC;CACD,OAAO,oBAAC,YAAY,UAAb;EAA6B;EAAQ;CAA+B,CAAA;AAC7E;AAEA,SAAgB,iBAAiB;CAC/B,OAAO,WAAW,WAAW;AAC/B"}

package/dist/form/{components → hooks}/field-scope.js

@@ -1,8 +1,8 @@
-import { appendPath, getPath, toHtmlName } from "./form-path.js";
-import { buildOverrideKey, rowIdFrom } from "./override-keys.js";
+import { appendPath, getPath, toHtmlName } from "../lib/form-path.js";
+import { buildOverrideKey, rowIdFrom } from "../lib/override-keys.js";
 import { createContext, useContext, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
-//#region resources/js/form/components/field-scope.tsx
+//#region resources/js/form/hooks/field-scope.tsx
 var FieldScopeContext = createContext(null);
 function childCollectionIdentity(base, parent) {
 	if (!parent) return base;

package/dist/form/hooks/field-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-scope.js","names":[],"sources":["../../../resources/js/form/hooks/field-scope.tsx"],"sourcesContent":["import { createContext, useContext, useMemo } from \"react\";\nimport { appendPath, getPath, toHtmlName } from \"@lattice-php/lattice/form/lib/form-path\";\nimport { buildOverrideKey, rowIdFrom } from \"@lattice-php/lattice/form/lib/override-keys\";\n\ntype FieldScopeValue = {\n  row: Record<string, unknown>;\n  rowId: string | null;\n  path: string;\n  values: Record<string, unknown>;\n  identityPath: string;\n  getValue: (name: string) => unknown;\n  setValue: (name: string, value: unknown) => void;\n  scopedName: (name: string) => string;\n  errorKey: (name: string) => string;\n  overrideKey: (name: string) => string;\n};\n\nconst FieldScopeContext = createContext<FieldScopeValue | null>(null);\n\nfunction childCollectionIdentity(base: string, parent: FieldScopeValue | null): string {\n  if (!parent) {\n    return base;\n  }\n\n  const local = base.startsWith(`${parent.path}.`) ? base.slice(parent.path.length + 1) : base;\n\n  return appendPath(parent.identityPath, local);\n}\n\nexport function FieldScopeProvider({\n  base,\n  index,\n  row,\n  onChange,\n  children,\n}: {\n  base: string;\n  index: number;\n  row: Record<string, unknown>;\n  onChange: (name: string, value: unknown) => void;\n  children: React.ReactNode;\n}) {\n  const parent = useContext(FieldScopeContext);\n\n  const value = useMemo<FieldScopeValue>(() => {\n    const scopedRow = row ?? {};\n    const rowId = rowIdFrom(scopedRow);\n    const path = appendPath(base, index);\n    const identityCollection = childCollectionIdentity(base, parent);\n    const identityPath = appendPath(identityCollection, rowId ?? index);\n\n    return {\n      row: scopedRow,\n      rowId,\n      path,\n      values: parent ? { ...parent.values, ...scopedRow } : scopedRow,\n      identityPath,\n      getValue: (name) => getPath(scopedRow, name),\n      setValue: onChange,\n      scopedName: (name) => toHtmlName(appendPath(path, name)),\n      errorKey: (name) => appendPath(path, name),\n      overrideKey: (name) => buildOverrideKey(identityCollection, rowId, index, name),\n    };\n  }, [base, index, row, onChange, parent]);\n\n  return <FieldScopeContext.Provider value={value}>{children}</FieldScopeContext.Provider>;\n}\n\n/** Null outside a row so callers can preserve top-level behavior without a wrapper. */\nexport function useFieldScope(): FieldScopeValue | null {\n  return useContext(FieldScopeContext);\n}\n"],"mappings":";;;;;AAiBA,IAAM,oBAAoB,cAAsC,IAAI;AAEpE,SAAS,wBAAwB,MAAc,QAAwC;CACrF,IAAI,CAAC,QACH,OAAO;CAGT,MAAM,QAAQ,KAAK,WAAW,GAAG,OAAO,KAAK,EAAE,IAAI,KAAK,MAAM,OAAO,KAAK,SAAS,CAAC,IAAI;CAExF,OAAO,WAAW,OAAO,cAAc,KAAK;AAC9C;AAEA,SAAgB,mBAAmB,EACjC,MACA,OACA,KACA,UACA,YAOC;CACD,MAAM,SAAS,WAAW,iBAAiB;CAE3C,MAAM,QAAQ,cAA+B;EAC3C,MAAM,YAAY,OAAO,CAAC;EAC1B,MAAM,QAAQ,UAAU,SAAS;EACjC,MAAM,OAAO,WAAW,MAAM,KAAK;EACnC,MAAM,qBAAqB,wBAAwB,MAAM,MAAM;EAC/D,MAAM,eAAe,WAAW,oBAAoB,SAAS,KAAK;EAElE,OAAO;GACL,KAAK;GACL;GACA;GACA,QAAQ,SAAS;IAAE,GAAG,OAAO;IAAQ,GAAG;GAAU,IAAI;GACtD;GACA,WAAW,SAAS,QAAQ,WAAW,IAAI;GAC3C,UAAU;GACV,aAAa,SAAS,WAAW,WAAW,MAAM,IAAI,CAAC;GACvD,WAAW,SAAS,WAAW,MAAM,IAAI;GACzC,cAAc,SAAS,iBAAiB,oBAAoB,OAAO,OAAO,IAAI;EAChF;CACF,GAAG;EAAC;EAAM;EAAO;EAAK;EAAU;CAAM,CAAC;CAEvC,OAAO,oBAAC,kBAAkB,UAAnB;EAAmC;EAAQ;CAAqC,CAAA;AACzF;;AAGA,SAAgB,gBAAwC;CACtD,OAAO,WAAW,iBAAiB;AACrC"}

package/dist/form/{components → hooks}/prefill-context.js

@@ -1,5 +1,5 @@
 import { createContext, useContext } from "react";
-//#region resources/js/form/components/prefill-context.ts
+//#region resources/js/form/hooks/prefill-context.ts
 var PrefillContext = createContext(null);
 var PrefillProvider = PrefillContext.Provider;
 function usePrefillController() {

package/dist/form/hooks/prefill-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefill-context.js","names":[],"sources":["../../../resources/js/form/hooks/prefill-context.ts"],"sourcesContent":["import { createContext, useContext } from \"react\";\n\nexport type PrefillController = {\n  markUserEdit: (overrideKey: string) => void;\n};\n\nconst PrefillContext = createContext<PrefillController | null>(null);\n\nexport const PrefillProvider = PrefillContext.Provider;\n\nexport function usePrefillController(): PrefillController | null {\n  return useContext(PrefillContext);\n}\n"],"mappings":";;AAMA,IAAM,iBAAiB,cAAwC,IAAI;AAEnE,IAAa,kBAAkB,eAAe;AAE9C,SAAgB,uBAAiD;CAC/D,OAAO,WAAW,cAAc;AAClC"}

package/dist/form/{components → hooks}/resolved-nodes.d.ts

@@ -1,4 +1,4 @@
-import { Node } from '../../core/types';
+import { Node } from '../../core/types.js';
 export declare function ResolvedNodesProvider({ nodes, children, }: {
     nodes: Record<string, Node>;
     children: React.ReactNode;

package/dist/form/{components → hooks}/resolved-nodes.js

@@ -1,8 +1,8 @@
-import { fieldProps } from "./field-props.js";
+import { fieldProps } from "../lib/field-props.js";
 import { useFieldScope } from "./field-scope.js";
 import { createContext, useContext } from "react";
 import { jsx } from "react/jsx-runtime";
-//#region resources/js/form/components/resolved-nodes.tsx
+//#region resources/js/form/hooks/resolved-nodes.tsx
 var ResolvedNodesContext = createContext({});
 function ResolvedNodesProvider({ nodes, children }) {
 	return /* @__PURE__ */ jsx(ResolvedNodesContext.Provider, {

package/dist/form/hooks/resolved-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-nodes.js","names":[],"sources":["../../../resources/js/form/hooks/resolved-nodes.tsx"],"sourcesContent":["import { createContext, useContext } from \"react\";\nimport type { Node } from \"@lattice-php/lattice/core/types\";\nimport { fieldProps } from \"@lattice-php/lattice/form/lib/field-props\";\nimport { useFieldScope } from \"./field-scope\";\n\nconst ResolvedNodesContext = createContext<Record<string, Node>>({});\n\nexport function ResolvedNodesProvider({\n  nodes,\n  children,\n}: {\n  nodes: Record<string, Node>;\n  children: React.ReactNode;\n}) {\n  return <ResolvedNodesContext.Provider value={nodes}>{children}</ResolvedNodesContext.Provider>;\n}\n\nexport function useResolvedNode(node: Node): Node {\n  const nodes = useContext(ResolvedNodesContext);\n  const name = fieldProps(node).name ?? \"\";\n  const scope = useFieldScope();\n  const path = name && scope ? scope.errorKey(name) : name;\n\n  return (path && nodes[path]) || (name && nodes[name]) || node;\n}\n"],"mappings":";;;;;AAKA,IAAM,uBAAuB,cAAoC,CAAC,CAAC;AAEnE,SAAgB,sBAAsB,EACpC,OACA,YAIC;CACD,OAAO,oBAAC,qBAAqB,UAAtB;EAA+B,OAAO;EAAQ;CAAwC,CAAA;AAC/F;AAEA,SAAgB,gBAAgB,MAAkB;CAChD,MAAM,QAAQ,WAAW,oBAAoB;CAC7C,MAAM,OAAO,WAAW,IAAI,EAAE,QAAQ;CACtC,MAAM,QAAQ,cAAc;CAC5B,MAAM,OAAO,QAAQ,QAAQ,MAAM,SAAS,IAAI,IAAI;CAEpD,OAAQ,QAAQ,MAAM,SAAW,QAAQ,MAAM,SAAU;AAC3D"}

package/dist/form/{components → hooks}/row-layout-context.js

@@ -1,6 +1,6 @@
 import { createContext, useContext } from "react";
 import { jsx } from "react/jsx-runtime";
-//#region resources/js/form/components/row-layout-context.tsx
+//#region resources/js/form/hooks/row-layout-context.tsx
 var TableCellContext = createContext(false);
 function TableCellProvider({ children }) {
 	return /* @__PURE__ */ jsx(TableCellContext.Provider, {

package/dist/form/hooks/row-layout-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-layout-context.js","names":[],"sources":["../../../resources/js/form/hooks/row-layout-context.tsx"],"sourcesContent":["import { createContext, useContext } from \"react\";\n\nconst TableCellContext = createContext(false);\n\nexport function TableCellProvider({ children }: { children: React.ReactNode }) {\n  return <TableCellContext.Provider value={true}>{children}</TableCellContext.Provider>;\n}\n\n/** True when a field is being rendered inside a table-layout cell (no own label). */\nexport function useInTableCell(): boolean {\n  return useContext(TableCellContext);\n}\n"],"mappings":";;;AAEA,IAAM,mBAAmB,cAAc,KAAK;AAE5C,SAAgB,kBAAkB,EAAE,YAA2C;CAC7E,OAAO,oBAAC,iBAAiB,UAAlB;EAA2B,OAAO;EAAO;CAAoC,CAAA;AACtF;;AAGA,SAAgB,iBAA0B;CACxC,OAAO,WAAW,gBAAgB;AACpC"}

package/dist/form/{components → hooks}/use-controlled-field.d.ts

@@ -1,5 +1,5 @@
-import { Node } from '../../core/types';
-import { FieldState } from './conditions';
+import { Node } from '../../core/types.js';
+import { FieldState } from '../lib/conditions.js';
 export type ControlledField = FieldState & {
     localName: string;
     name: string;

package/dist/form/{components → hooks}/use-controlled-field.js

@@ -1,13 +1,14 @@
 import { testIdentity } from "../../core/test-id.js";
 import { useFormContext } from "./context.js";
-import { fieldProps } from "./field-props.js";
+import { fieldProps } from "../lib/field-props.js";
 import { useFieldScope } from "./field-scope.js";
 import { useFormValue } from "./values.js";
-import { useDependentField } from "./use-dependent-field.js";
 import { useFieldCommit } from "./use-field-commit.js";
-//#region resources/js/form/components/use-controlled-field.ts
+import { useDependentField } from "./use-dependent-field.js";
+import { fieldDomName } from "../lib/field-dom-name.js";
+//#region resources/js/form/hooks/use-controlled-field.ts
 function useControlledField(node) {
-	const { errors } = useFormContext();
+	const { errors, fieldIdPrefix } = useFormContext();
 	const scope = useFieldScope();
 	const state = useDependentField(node);
 	const props = fieldProps(node);
@@ -16,7 +17,7 @@ function useControlledField(node) {
 	const storedValue = scope ? scope.getValue(localName) : globalValue;
 	const currentValue = storedValue !== void 0 ? storedValue : props.value;
 	const value = typeof currentValue === "string" || typeof currentValue === "number" ? String(currentValue) : "";
-	const domName = scope ? scope.scopedName(localName) : localName;
+	const domName = fieldDomName(scope ? scope.scopedName(localName) : localName, fieldIdPrefix);
 	const errorKey = scope ? scope.errorKey(localName) : localName;
 	const { commit: commitField, change: changeField, blur: blurField } = useFieldCommit();
 	const commit = (next) => commitField(localName, next);

package/dist/form/hooks/use-controlled-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-controlled-field.js","names":[],"sources":["../../../resources/js/form/hooks/use-controlled-field.ts"],"sourcesContent":["import type { Node } from \"@lattice-php/lattice/core/types\";\nimport { testIdentity } from \"@lattice-php/lattice/core/test-id\";\nimport type { FieldState } from \"@lattice-php/lattice/form/lib/conditions\";\nimport { fieldProps } from \"@lattice-php/lattice/form/lib/field-props\";\nimport { useFieldScope } from \"./field-scope\";\nimport { useFormContext } from \"./context\";\nimport { fieldDomName } from \"@lattice-php/lattice/form/lib/field-dom-name\";\nimport { useDependentField } from \"./use-dependent-field\";\nimport { useFieldCommit } from \"./use-field-commit\";\nimport { useFormValue } from \"./values\";\n\nexport type ControlledField = FieldState & {\n  localName: string;\n  name: string;\n  testId?: string;\n  value: string;\n  error?: string;\n  commit: (value: unknown) => void;\n  change: (value: unknown) => void;\n  blur: () => void;\n};\n\nexport function useControlledField(node: Node): ControlledField {\n  const { errors, fieldIdPrefix } = useFormContext();\n  const scope = useFieldScope();\n  const state = useDependentField(node);\n  const props = fieldProps(node);\n  const localName = props.name ?? \"\";\n\n  const globalValue = useFormValue(localName);\n  const storedValue = scope ? scope.getValue(localName) : globalValue;\n  const currentValue = storedValue !== undefined ? storedValue : props.value;\n  const value =\n    typeof currentValue === \"string\" || typeof currentValue === \"number\"\n      ? String(currentValue)\n      : \"\";\n\n  const domName = fieldDomName(scope ? scope.scopedName(localName) : localName, fieldIdPrefix);\n  const errorKey = scope ? scope.errorKey(localName) : localName;\n\n  const { commit: commitField, change: changeField, blur: blurField } = useFieldCommit();\n  const commit = (next: unknown): void => commitField(localName, next);\n  const change = (next: unknown): void => changeField(localName, next);\n  const blur = (): void => blurField(localName);\n\n  return {\n    ...state,\n    localName,\n    name: domName,\n    testId: testIdentity(localName),\n    value,\n    error: errors[errorKey],\n    commit,\n    change,\n    blur,\n  };\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,mBAAmB,MAA6B;CAC9D,MAAM,EAAE,QAAQ,kBAAkB,eAAe;CACjD,MAAM,QAAQ,cAAc;CAC5B,MAAM,QAAQ,kBAAkB,IAAI;CACpC,MAAM,QAAQ,WAAW,IAAI;CAC7B,MAAM,YAAY,MAAM,QAAQ;CAEhC,MAAM,cAAc,aAAa,SAAS;CAC1C,MAAM,cAAc,QAAQ,MAAM,SAAS,SAAS,IAAI;CACxD,MAAM,eAAe,gBAAgB,KAAA,IAAY,cAAc,MAAM;CACrE,MAAM,QACJ,OAAO,iBAAiB,YAAY,OAAO,iBAAiB,WACxD,OAAO,YAAY,IACnB;CAEN,MAAM,UAAU,aAAa,QAAQ,MAAM,WAAW,SAAS,IAAI,WAAW,aAAa;CAC3F,MAAM,WAAW,QAAQ,MAAM,SAAS,SAAS,IAAI;CAErD,MAAM,EAAE,QAAQ,aAAa,QAAQ,aAAa,MAAM,cAAc,eAAe;CACrF,MAAM,UAAU,SAAwB,YAAY,WAAW,IAAI;CACnE,MAAM,UAAU,SAAwB,YAAY,WAAW,IAAI;CACnE,MAAM,aAAmB,UAAU,SAAS;CAE5C,OAAO;EACL,GAAG;EACH;EACA,MAAM;EACN,QAAQ,aAAa,SAAS;EAC9B;EACA,OAAO,OAAO;EACd;EACA;EACA;CACF;AACF"}

package/dist/form/hooks/use-dependent-field.d.ts

@@ -0,0 +1,3 @@
+import { Node } from '../../core/types.js';
+import { FieldState } from '../lib/conditions.js';
+export declare function useDependentField(node: Node): FieldState;

package/dist/form/{components → hooks}/use-dependent-field.js

@@ -1,18 +1,18 @@
-import { fieldProps } from "./field-props.js";
+import { fieldProps } from "../lib/field-props.js";
 import { useFieldScope } from "./field-scope.js";
-import { useFormValues } from "./values.js";
-import { evaluateConditions } from "./conditions.js";
-//#region resources/js/form/components/use-dependent-field.ts
+import { useFormValuesFor } from "./values.js";
+import { conditionFields, evaluateConditions } from "../lib/conditions.js";
+import { useMemo } from "react";
+//#region resources/js/form/hooks/use-dependent-field.ts
 function useDependentField(node) {
-	const values = useFormValues();
 	const scope = useFieldScope();
 	const props = fieldProps(node);
+	const values = useFormValuesFor(useMemo(() => conditionFields(props.conditions), [props.conditions]));
 	const conditionValues = scope ? {
 		...values,
 		...scope.values
 	} : values;
 	return evaluateConditions(props.conditions ?? void 0, conditionValues, {
-		hidden: props.hidden ?? false,
 		required: props.required ?? false,
 		readOnly: props.readOnly ?? false,
 		disabled: props.disabled ?? false

package/dist/form/hooks/use-dependent-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-dependent-field.js","names":[],"sources":["../../../resources/js/form/hooks/use-dependent-field.ts"],"sourcesContent":["import type { Node } from \"@lattice-php/lattice/core/types\";\nimport { useMemo } from \"react\";\nimport {\n  conditionFields,\n  type FieldState,\n  evaluateConditions,\n} from \"@lattice-php/lattice/form/lib/conditions\";\nimport { fieldProps } from \"@lattice-php/lattice/form/lib/field-props\";\nimport { useFieldScope } from \"./field-scope\";\nimport { useFormValuesFor } from \"./values\";\n\nexport function useDependentField(node: Node): FieldState {\n  const scope = useFieldScope();\n  const props = fieldProps(node);\n  const fields = useMemo(() => conditionFields(props.conditions), [props.conditions]);\n  const values = useFormValuesFor(fields);\n  // Bare condition names resolve to row siblings first; form values remain the fallback.\n  const conditionValues = scope ? { ...values, ...scope.values } : values;\n\n  return evaluateConditions(props.conditions ?? undefined, conditionValues, {\n    required: props.required ?? false,\n    readOnly: props.readOnly ?? false,\n    disabled: props.disabled ?? false,\n  });\n}\n"],"mappings":";;;;;;AAWA,SAAgB,kBAAkB,MAAwB;CACxD,MAAM,QAAQ,cAAc;CAC5B,MAAM,QAAQ,WAAW,IAAI;CAE7B,MAAM,SAAS,iBADA,cAAc,gBAAgB,MAAM,UAAU,GAAG,CAAC,MAAM,UAAU,CACjD,CAAM;CAEtC,MAAM,kBAAkB,QAAQ;EAAE,GAAG;EAAQ,GAAG,MAAM;CAAO,IAAI;CAEjE,OAAO,mBAAmB,MAAM,cAAc,KAAA,GAAW,iBAAiB;EACxE,UAAU,MAAM,YAAY;EAC5B,UAAU,MAAM,YAAY;EAC5B,UAAU,MAAM,YAAY;CAC9B,CAAC;AACH"}

package/dist/form/{components → hooks}/use-field-commit.d.ts

@@ -1,3 +1,4 @@
+import { ReactNode } from 'react';
 type FieldCommit = {
     /** Write the value and validate immediately (precognitive) or clear errors. */
     commit: (name: string, value: unknown) => void;
@@ -6,6 +7,10 @@ type FieldCommit = {
     /** Validate the field now if precognitive (e.g. on blur or popover close). */
     blur: (name: string) => void;
 };
+export declare function FieldCommitOverrideProvider({ children, value, }: {
+    children: ReactNode;
+    value: FieldCommit;
+}): import('react').FunctionComponentElement<import('react').ProviderProps<FieldCommit | null>>;
 /**
  * The shared field-mutation contract every form field uses to write its value
  * and drive precognition. Fields that validate on change call `commit`; fields

package/dist/form/{components → hooks}/use-field-commit.js

@@ -2,7 +2,12 @@ import { useFormContext } from "./context.js";
 import { usePrefillController } from "./prefill-context.js";
 import { useFieldScope } from "./field-scope.js";
 import { useSetFormValue } from "./values.js";
-//#region resources/js/form/components/use-field-commit.ts
+import { createContext, createElement, useContext } from "react";
+//#region resources/js/form/hooks/use-field-commit.ts
+var FieldCommitOverrideContext = createContext(null);
+function FieldCommitOverrideProvider({ children, value }) {
+	return createElement(FieldCommitOverrideContext.Provider, { value }, children);
+}
 /**
 * The shared field-mutation contract every form field uses to write its value
 * and drive precognition. Fields that validate on change call `commit`; fields
@@ -13,10 +18,12 @@ import { useSetFormValue } from "./values.js";
 * behavior is identical to before.
 */
 function useFieldCommit() {
+	const override = useContext(FieldCommitOverrideContext);
 	const { clearErrors, precognitive, validate } = useFormContext();
 	const setGlobal = useSetFormValue();
 	const scope = useFieldScope();
 	const prefill = usePrefillController();
+	if (override) return override;
 	const write = (name, value) => {
 		if (scope) scope.setValue(name, value);
 		else setGlobal(name, value);
@@ -39,6 +46,6 @@ function useFieldCommit() {
 	};
 }
 //#endregion
-export { useFieldCommit };
+export { FieldCommitOverrideProvider, useFieldCommit };
 
 //# sourceMappingURL=use-field-commit.js.map

package/dist/form/hooks/use-field-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-field-commit.js","names":[],"sources":["../../../resources/js/form/hooks/use-field-commit.ts"],"sourcesContent":["import { createContext, createElement, useContext } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { useFieldScope } from \"./field-scope\";\nimport { useFormContext } from \"./context\";\nimport { usePrefillController } from \"./prefill-context\";\nimport { useSetFormValue } from \"./values\";\n\ntype FieldCommit = {\n  /** Write the value and validate immediately (precognitive) or clear errors. */\n  commit: (name: string, value: unknown) => void;\n  /** Write the value and clear errors, deferring validation to a later `blur`. */\n  change: (name: string, value: unknown) => void;\n  /** Validate the field now if precognitive (e.g. on blur or popover close). */\n  blur: (name: string) => void;\n};\n\nconst FieldCommitOverrideContext = createContext<FieldCommit | null>(null);\n\nexport function FieldCommitOverrideProvider({\n  children,\n  value,\n}: {\n  children: ReactNode;\n  value: FieldCommit;\n}) {\n  return createElement(FieldCommitOverrideContext.Provider, { value }, children);\n}\n\n/**\n * The shared field-mutation contract every form field uses to write its value\n * and drive precognition. Fields that validate on change call `commit`; fields\n * that validate on blur/close (rich editor, select) call `change` then `blur`.\n *\n * When called inside a `FieldScopeProvider`, writes go through the scope's\n * `setValue` and error paths use the scoped dot-key; outside a scope the\n * behavior is identical to before.\n */\nexport function useFieldCommit(): FieldCommit {\n  const override = useContext(FieldCommitOverrideContext);\n  const { clearErrors, precognitive, validate } = useFormContext();\n  const setGlobal = useSetFormValue();\n  const scope = useFieldScope();\n  const prefill = usePrefillController();\n\n  if (override) {\n    return override;\n  }\n\n  const write = (name: string, value: unknown): void => {\n    if (scope) {\n      scope.setValue(name, value);\n    } else {\n      setGlobal(name, value);\n    }\n    prefill?.markUserEdit(scope ? scope.overrideKey(name) : name);\n  };\n  const errorPath = (name: string): string => (scope ? scope.errorKey(name) : name);\n\n  return {\n    commit(name, value) {\n      write(name, value);\n      if (precognitive) {\n        validate(errorPath(name));\n      } else {\n        clearErrors(errorPath(name));\n      }\n    },\n    change(name, value) {\n      write(name, value);\n      clearErrors(errorPath(name));\n    },\n    blur(name) {\n      if (precognitive) {\n        validate(errorPath(name));\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;AAgBA,IAAM,6BAA6B,cAAkC,IAAI;AAEzE,SAAgB,4BAA4B,EAC1C,UACA,SAIC;CACD,OAAO,cAAc,2BAA2B,UAAU,EAAE,MAAM,GAAG,QAAQ;AAC/E;;;;;;;;;;AAWA,SAAgB,iBAA8B;CAC5C,MAAM,WAAW,WAAW,0BAA0B;CACtD,MAAM,EAAE,aAAa,cAAc,aAAa,eAAe;CAC/D,MAAM,YAAY,gBAAgB;CAClC,MAAM,QAAQ,cAAc;CAC5B,MAAM,UAAU,qBAAqB;CAErC,IAAI,UACF,OAAO;CAGT,MAAM,SAAS,MAAc,UAAyB;EACpD,IAAI,OACF,MAAM,SAAS,MAAM,KAAK;OAE1B,UAAU,MAAM,KAAK;EAEvB,SAAS,aAAa,QAAQ,MAAM,YAAY,IAAI,IAAI,IAAI;CAC9D;CACA,MAAM,aAAa,SAA0B,QAAQ,MAAM,SAAS,IAAI,IAAI;CAE5E,OAAO;EACL,OAAO,MAAM,OAAO;GAClB,MAAM,MAAM,KAAK;GACjB,IAAI,cACF,SAAS,UAAU,IAAI,CAAC;QAExB,YAAY,UAAU,IAAI,CAAC;EAE/B;EACA,OAAO,MAAM,OAAO;GAClB,MAAM,MAAM,KAAK;GACjB,YAAY,UAAU,IAAI,CAAC;EAC7B;EACA,KAAK,MAAM;GACT,IAAI,cACF,SAAS,UAAU,IAAI,CAAC;EAE5B;CACF;AACF"}

package/dist/form/{components → hooks}/use-form-resolver.d.ts

@@ -1,5 +1,5 @@
-import { Node } from '../../core/types';
-import { PrefillController } from './prefill-context';
+import { Node } from '../../core/types.js';
+import { PrefillController } from './prefill-context.js';
 type FormResolver = {
     nodes: Record<string, Node>;
     markUserEdit: PrefillController["markUserEdit"];

package/dist/form/{components → hooks}/use-form-resolver.js

@@ -1,10 +1,10 @@
-import { walkFields } from "./field-props.js";
-import { postFormAction } from "./form-transport.js";
-import { getPath } from "./form-path.js";
-import { collectPrefillTargets, pathsToClear, pruneOverrides, seededOverrides } from "./prefill-targets.js";
+import { walkFields } from "../lib/field-props.js";
+import { getPath } from "../lib/form-path.js";
 import { useFormValues, useSetFormValue } from "./values.js";
+import { postFormAction } from "../lib/form-transport.js";
+import { collectPrefillTargets, pathsToClear, pruneOverrides, seededOverrides } from "../lib/prefill-targets.js";
 import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
-//#region resources/js/form/components/use-form-resolver.ts
+//#region resources/js/form/hooks/use-form-resolver.ts
 function useFormResolver(action, componentRef, nodes) {
 	const values = useFormValues();
 	const setValue = useSetFormValue();

package/dist/form/hooks/use-form-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-form-resolver.js","names":[],"sources":["../../../resources/js/form/hooks/use-form-resolver.ts"],"sourcesContent":["import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from \"react\";\nimport type { Node } from \"@lattice-php/lattice/core/types\";\nimport { walkFields } from \"@lattice-php/lattice/form/lib/field-props\";\nimport { FORM_DEBOUNCE_MS, postFormAction } from \"@lattice-php/lattice/form/lib/form-transport\";\nimport {\n  collectPrefillTargets,\n  getPath,\n  pathsToClear,\n  pruneOverrides,\n  seededOverrides,\n} from \"@lattice-php/lattice/form/lib/prefill-targets\";\nimport type { PrefillController } from \"./prefill-context\";\nimport { useFormValues, useSetFormValue } from \"./values\";\n\ntype ResolveResponse = {\n  fields?: Record<string, Node>;\n  values?: Record<string, unknown>;\n  prefill?: Record<string, unknown>;\n};\n\ntype FormResolver = {\n  nodes: Record<string, Node>;\n  markUserEdit: PrefillController[\"markUserEdit\"];\n};\n\nexport function useFormResolver(\n  action: string,\n  componentRef: string,\n  nodes: Node[] | undefined,\n): FormResolver {\n  const values = useFormValues();\n  const setValue = useSetFormValue();\n  const [resolved, setResolved] = useState<Record<string, Node>>({});\n\n  const targets = useMemo(() => collectPrefillTargets(nodes, values), [nodes, values]);\n\n  const overrides = useRef<Set<string>>(new Set());\n  const seededOverrideKeys = useRef<Set<string>>(new Set());\n  const previousValues = useRef<Record<string, unknown>>(values);\n  const previousTargets = useRef(targets);\n\n  // Read targets via a ref inside the effect: `targets` changes identity on every\n  // value change, but the effect must fire only when `watchSignature` changes\n  // (which already reflects added/removed target paths). Keeping `targets` out of\n  // the dep array preserves the targeted watch in non-\"any\" mode.\n  const targetsRef = useRef(targets);\n  targetsRef.current = targets;\n\n  useLayoutEffect(() => {\n    const liveOverrideKeys = new Set(targets.map((target) => target.overrideKey));\n    seededOverrideKeys.current = new Set(\n      [...seededOverrideKeys.current].filter((overrideKey) => liveOverrideKeys.has(overrideKey)),\n    );\n    const freshTargets = targets.filter(\n      (target) => !seededOverrideKeys.current.has(target.overrideKey),\n    );\n\n    // Layout ordering seeds loaded values before the first resolve effect can apply prefill.\n    for (const overrideKey of seededOverrides(freshTargets, values)) {\n      overrides.current.add(overrideKey);\n    }\n\n    for (const target of freshTargets) {\n      seededOverrideKeys.current.add(target.overrideKey);\n    }\n  }, [targets, values]);\n\n  const markUserEdit = useCallback((overrideKey: string) => {\n    overrides.current.add(overrideKey);\n  }, []);\n\n  const watch = useMemo(() => {\n    const keys = new Set<string>();\n    let any = false;\n    walkFields(nodes, (props) => {\n      if (Array.isArray(props.dependsOnKeys)) {\n        for (const key of props.dependsOnKeys) {\n          keys.add(String(key));\n        }\n      }\n      if (props.dependsOnAny) {\n        any = true;\n      }\n    });\n    return { keys: [...keys], any };\n  }, [nodes]);\n\n  const watchPaths = useMemo(() => {\n    const set = new Set<string>(watch.keys);\n    for (const target of targets) {\n      for (const dep of target.resetOn) {\n        set.add(dep);\n      }\n      for (const dep of target.refreshOn) {\n        set.add(dep);\n      }\n    }\n    return [...set];\n  }, [watch.keys, targets]);\n\n  // In \"any\" mode the values store keeps a stable reference until something\n  // actually changes, so its identity is the change signal. Otherwise hash the\n  // watched paths (form-level and per-row).\n  const watchSignature = watch.any\n    ? values\n    : JSON.stringify(watchPaths.map((path) => getPath(values, path)));\n\n  useEffect(() => {\n    if (watchPaths.length === 0 && !watch.any) {\n      return;\n    }\n\n    const previous = previousValues.current;\n    previousValues.current = values;\n\n    // `resetOn` deps unlock a path (a fresh product gives a fresh price); `refreshOn`\n    // deps only re-ask the server and never clear an override (a customer change\n    // re-prices untouched rows but leaves user-edited ones alone).\n    for (const overrideKey of pathsToClear(\n      { targets: previousTargets.current, values: previous },\n      { targets: targetsRef.current, values },\n    )) {\n      overrides.current.delete(overrideKey);\n    }\n    previousTargets.current = targetsRef.current;\n\n    // Override ownership is row-id keyed, so pruning removes departed rows without reindex drift.\n    overrides.current = pruneOverrides(overrides.current, targetsRef.current);\n\n    const controller = new AbortController();\n\n    const timer = window.setTimeout(() => {\n      void postFormAction<ResolveResponse>(\n        action,\n        componentRef,\n        { _resolve: true, ...values },\n        controller.signal,\n      )\n        .then((response) => {\n          if (!response) {\n            return;\n          }\n          for (const [name, value] of Object.entries(response.values ?? {})) {\n            setValue(name, value);\n          }\n          const targetsByPath = new Map(\n            targetsRef.current.map((target) => [target.path, target] as const),\n          );\n          for (const [path, value] of Object.entries(response.prefill ?? {})) {\n            const target = targetsByPath.get(path);\n\n            if (target && !overrides.current.has(target.overrideKey)) {\n              setValue(path, value);\n            }\n          }\n          if (response.fields) {\n            setResolved(response.fields);\n          }\n        })\n        .catch(() => {});\n    }, FORM_DEBOUNCE_MS);\n\n    return () => {\n      window.clearTimeout(timer);\n      controller.abort();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [watchSignature, action, componentRef, watch.any, setValue]);\n\n  return { nodes: resolved, markUserEdit };\n}\n"],"mappings":";;;;;;;AAyBA,SAAgB,gBACd,QACA,cACA,OACc;CACd,MAAM,SAAS,cAAc;CAC7B,MAAM,WAAW,gBAAgB;CACjC,MAAM,CAAC,UAAU,eAAe,SAA+B,CAAC,CAAC;CAEjE,MAAM,UAAU,cAAc,sBAAsB,OAAO,MAAM,GAAG,CAAC,OAAO,MAAM,CAAC;CAEnF,MAAM,YAAY,uBAAoB,IAAI,IAAI,CAAC;CAC/C,MAAM,qBAAqB,uBAAoB,IAAI,IAAI,CAAC;CACxD,MAAM,iBAAiB,OAAgC,MAAM;CAC7D,MAAM,kBAAkB,OAAO,OAAO;CAMtC,MAAM,aAAa,OAAO,OAAO;CACjC,WAAW,UAAU;CAErB,sBAAsB;EACpB,MAAM,mBAAmB,IAAI,IAAI,QAAQ,KAAK,WAAW,OAAO,WAAW,CAAC;EAC5E,mBAAmB,UAAU,IAAI,IAC/B,CAAC,GAAG,mBAAmB,OAAO,EAAE,QAAQ,gBAAgB,iBAAiB,IAAI,WAAW,CAAC,CAC3F;EACA,MAAM,eAAe,QAAQ,QAC1B,WAAW,CAAC,mBAAmB,QAAQ,IAAI,OAAO,WAAW,CAChE;EAGA,KAAK,MAAM,eAAe,gBAAgB,cAAc,MAAM,GAC5D,UAAU,QAAQ,IAAI,WAAW;EAGnC,KAAK,MAAM,UAAU,cACnB,mBAAmB,QAAQ,IAAI,OAAO,WAAW;CAErD,GAAG,CAAC,SAAS,MAAM,CAAC;CAEpB,MAAM,eAAe,aAAa,gBAAwB;EACxD,UAAU,QAAQ,IAAI,WAAW;CACnC,GAAG,CAAC,CAAC;CAEL,MAAM,QAAQ,cAAc;EAC1B,MAAM,uBAAO,IAAI,IAAY;EAC7B,IAAI,MAAM;EACV,WAAW,QAAQ,UAAU;GAC3B,IAAI,MAAM,QAAQ,MAAM,aAAa,GACnC,KAAK,MAAM,OAAO,MAAM,eACtB,KAAK,IAAI,OAAO,GAAG,CAAC;GAGxB,IAAI,MAAM,cACR,MAAM;EAEV,CAAC;EACD,OAAO;GAAE,MAAM,CAAC,GAAG,IAAI;GAAG;EAAI;CAChC,GAAG,CAAC,KAAK,CAAC;CAEV,MAAM,aAAa,cAAc;EAC/B,MAAM,MAAM,IAAI,IAAY,MAAM,IAAI;EACtC,KAAK,MAAM,UAAU,SAAS;GAC5B,KAAK,MAAM,OAAO,OAAO,SACvB,IAAI,IAAI,GAAG;GAEb,KAAK,MAAM,OAAO,OAAO,WACvB,IAAI,IAAI,GAAG;EAEf;EACA,OAAO,CAAC,GAAG,GAAG;CAChB,GAAG,CAAC,MAAM,MAAM,OAAO,CAAC;CASxB,gBAAgB;EACd,IAAI,WAAW,WAAW,KAAK,CAAC,MAAM,KACpC;EAGF,MAAM,WAAW,eAAe;EAChC,eAAe,UAAU;EAKzB,KAAK,MAAM,eAAe,aACxB;GAAE,SAAS,gBAAgB;GAAS,QAAQ;EAAS,GACrD;GAAE,SAAS,WAAW;GAAS;EAAO,CACxC,GACE,UAAU,QAAQ,OAAO,WAAW;EAEtC,gBAAgB,UAAU,WAAW;EAGrC,UAAU,UAAU,eAAe,UAAU,SAAS,WAAW,OAAO;EAExE,MAAM,aAAa,IAAI,gBAAgB;EAEvC,MAAM,QAAQ,OAAO,iBAAiB;GACpC,eACE,QACA,cACA;IAAE,UAAU;IAAM,GAAG;GAAO,GAC5B,WAAW,MACb,EACG,MAAM,aAAa;IAClB,IAAI,CAAC,UACH;IAEF,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,SAAS,UAAU,CAAC,CAAC,GAC9D,SAAS,MAAM,KAAK;IAEtB,MAAM,gBAAgB,IAAI,IACxB,WAAW,QAAQ,KAAK,WAAW,CAAC,OAAO,MAAM,MAAM,CAAU,CACnE;IACA,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,SAAS,WAAW,CAAC,CAAC,GAAG;KAClE,MAAM,SAAS,cAAc,IAAI,IAAI;KAErC,IAAI,UAAU,CAAC,UAAU,QAAQ,IAAI,OAAO,WAAW,GACrD,SAAS,MAAM,KAAK;IAExB;IACA,IAAI,SAAS,QACX,YAAY,SAAS,MAAM;GAE/B,CAAC,EACA,YAAY,CAAC,CAAC;EACnB,GAAA,GAAmB;EAEnB,aAAa;GACX,OAAO,aAAa,KAAK;GACzB,WAAW,MAAM;EACnB;CAEF,GAAG;EAhEoB,MAAM,MACzB,SACA,KAAK,UAAU,WAAW,KAAK,SAAS,QAAQ,QAAQ,IAAI,CAAC,CAAC;EA8D9C;EAAQ;EAAc,MAAM;EAAK;CAAQ,CAAC;CAE9D,OAAO;EAAE,OAAO;EAAU;CAAa;AACzC"}

package/dist/form/{components → hooks}/use-seed-default.js

@@ -1,7 +1,7 @@
 import { useFieldScope } from "./field-scope.js";
 import { useFormValue, useSetFormValue } from "./values.js";
 import { useEffect } from "react";
-//#region resources/js/form/components/use-seed-default.ts
+//#region resources/js/form/hooks/use-seed-default.ts
 /**
 * Seed a field's default into the store so dependent fields and the submitted
 * payload reflect it before the user interacts. Pass undefined to skip.

package/dist/form/hooks/use-seed-default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-seed-default.js","names":[],"sources":["../../../resources/js/form/hooks/use-seed-default.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useFieldScope } from \"./field-scope\";\nimport { useFormValue, useSetFormValue } from \"./values\";\n\n/**\n * Seed a field's default into the store so dependent fields and the submitted\n * payload reflect it before the user interacts. Pass undefined to skip.\n */\nexport function useSeedDefault(name: string, value: unknown): void {\n  const scope = useFieldScope();\n  const globalStored = useFormValue(name);\n  const stored = scope ? scope.getValue(name) : globalStored;\n  const setValue = useSetFormValue();\n\n  useEffect(() => {\n    if (stored === undefined && value !== undefined) {\n      if (scope) {\n        scope.setValue(name, value);\n      } else {\n        setValue(name, value);\n      }\n    }\n  }, [name, value, stored, setValue, scope]);\n}\n"],"mappings":";;;;;;;;AAQA,SAAgB,eAAe,MAAc,OAAsB;CACjE,MAAM,QAAQ,cAAc;CAC5B,MAAM,eAAe,aAAa,IAAI;CACtC,MAAM,SAAS,QAAQ,MAAM,SAAS,IAAI,IAAI;CAC9C,MAAM,WAAW,gBAAgB;CAEjC,gBAAgB;EACd,IAAI,WAAW,KAAA,KAAa,UAAU,KAAA,GACpC,IAAI,OACF,MAAM,SAAS,MAAM,KAAK;OAE1B,SAAS,MAAM,KAAK;CAG1B,GAAG;EAAC;EAAM;EAAO;EAAQ;EAAU;CAAK,CAAC;AAC3C"}

package/dist/form/{components → hooks}/values.d.ts

@@ -1,7 +1,9 @@
+export type SetFormValue = (name: string, value: unknown | ((previous: unknown) => unknown)) => void;
 export declare function FormValuesProvider({ initial, children, }: {
     initial: Record<string, unknown>;
     children: React.ReactNode;
 }): import("react").JSX.Element;
 export declare function useFormValues(): Record<string, unknown>;
 export declare function useFormValue(name: string): unknown;
-export declare function useSetFormValue(): (name: string, value: unknown) => void;
+export declare function useFormValuesFor(paths: string[]): Record<string, unknown>;
+export declare function useSetFormValue(): SetFormValue;

package/dist/form/hooks/values.js

@@ -0,0 +1,136 @@
+import { getPath, setPath } from "../lib/form-path.js";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useSyncExternalStore } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region resources/js/form/hooks/values.tsx
+var emptyValues = {};
+var emptySelectedValues = {};
+var FormValuesStoreContext = createContext(null);
+var SetFormValueContext = createContext(() => {});
+function valuesEqual(a, b) {
+	if (Object.is(a, b)) return true;
+	if (!a || !b || typeof a !== "object" || typeof b !== "object") return false;
+	if (Array.isArray(a) || Array.isArray(b)) return Array.isArray(a) && Array.isArray(b) && a.length === b.length && a.every((value, index) => valuesEqual(value, b[index]));
+	const aEntries = Object.entries(a);
+	const bObject = b;
+	return aEntries.length === Object.keys(bObject).length && aEntries.every(([key, value]) => valuesEqual(value, bObject[key]));
+}
+function normalizePath(path) {
+	return path.split(".").filter((part) => part !== "").join(".");
+}
+function pathsOverlap(left, right) {
+	return left === "" || right === "" || left === right || left.startsWith(`${right}.`) || right.startsWith(`${left}.`);
+}
+function createFormValuesStore(initial) {
+	let initialValues = initial;
+	let values = initial;
+	const listeners = /* @__PURE__ */ new Set();
+	const pathListeners = /* @__PURE__ */ new Map();
+	const selectedCache = /* @__PURE__ */ new Map();
+	const notify = (path) => {
+		for (const listener of listeners) listener();
+		const normalizedPath = normalizePath(path);
+		for (const [subscribedPath, subscribedListeners] of pathListeners) {
+			if (!pathsOverlap(subscribedPath, normalizedPath)) continue;
+			for (const listener of subscribedListeners) listener();
+		}
+	};
+	const updateValues = (next, path) => {
+		if (Object.is(values, next)) return;
+		values = next;
+		selectedCache.clear();
+		notify(path);
+	};
+	const subscribePath = (path, listener) => {
+		const normalizedPath = normalizePath(path);
+		const listenersForPath = pathListeners.get(normalizedPath) ?? /* @__PURE__ */ new Set();
+		listenersForPath.add(listener);
+		pathListeners.set(normalizedPath, listenersForPath);
+		return () => {
+			listenersForPath.delete(listener);
+			if (listenersForPath.size === 0) pathListeners.delete(normalizedPath);
+		};
+	};
+	return {
+		getPathSnapshot: (path) => getPath(values, path),
+		getPathsSnapshot: (paths) => {
+			if (paths.length === 0) return emptySelectedValues;
+			const normalizedPaths = paths.map(normalizePath);
+			const key = JSON.stringify(paths);
+			const selectedValues = normalizedPaths.map((path) => getPath(values, path));
+			const cached = selectedCache.get(key);
+			if (cached && cached.values.length === selectedValues.length && selectedValues.every((value, index) => Object.is(value, cached.values[index]))) return cached.snapshot;
+			const snapshot = Object.fromEntries(paths.map((path, index) => [path, selectedValues[index]]));
+			selectedCache.set(key, {
+				snapshot,
+				values: selectedValues
+			});
+			return snapshot;
+		},
+		getSnapshot: () => values,
+		replaceInitial: (nextInitial) => {
+			if (valuesEqual(initialValues, nextInitial)) return;
+			initialValues = nextInitial;
+			updateValues(nextInitial, "");
+		},
+		setValue: (name, value) => {
+			const previous = getPath(values, name);
+			const next = typeof value === "function" ? value(previous) : value;
+			if (Object.is(previous, next)) return;
+			updateValues(setPath(values, name, next), name);
+		},
+		subscribe: (listener) => {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		},
+		subscribePath,
+		subscribePaths: (paths, listener) => {
+			const unsubscribers = Array.from(new Set(paths.map(normalizePath))).map((path) => subscribePath(path, listener));
+			return () => {
+				for (const unsubscribe of unsubscribers) unsubscribe();
+			};
+		}
+	};
+}
+var fallbackFormValuesStore = createFormValuesStore(emptyValues);
+function FormValuesProvider({ initial, children }) {
+	const storeRef = useRef(null);
+	if (storeRef.current === null) storeRef.current = createFormValuesStore(initial);
+	useEffect(() => {
+		storeRef.current?.replaceInitial(initial);
+	}, [initial]);
+	return /* @__PURE__ */ jsx(FormValuesStoreContext.Provider, {
+		value: storeRef.current,
+		children: /* @__PURE__ */ jsx(SetFormValueContext.Provider, {
+			value: storeRef.current.setValue,
+			children
+		})
+	});
+}
+function useFormValuesStore() {
+	return useContext(FormValuesStoreContext) ?? fallbackFormValuesStore;
+}
+function useFormValues() {
+	const store = useFormValuesStore();
+	return useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+}
+function useFormValue(name) {
+	const store = useFormValuesStore();
+	const subscribe = useCallback((listener) => store.subscribePath(name, listener), [name, store]);
+	const getSnapshot = useCallback(() => store.getPathSnapshot(name), [name, store]);
+	return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+function useFormValuesFor(paths) {
+	const store = useFormValuesStore();
+	const pathsKey = JSON.stringify(paths);
+	const selectedPaths = useMemo(() => JSON.parse(pathsKey), [pathsKey]);
+	const subscribe = useCallback((listener) => store.subscribePaths(selectedPaths, listener), [selectedPaths, store]);
+	const getSnapshot = useCallback(() => store.getPathsSnapshot(selectedPaths), [selectedPaths, store]);
+	return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+function useSetFormValue() {
+	return useContext(SetFormValueContext);
+}
+//#endregion
+export { FormValuesProvider, useFormValue, useFormValues, useFormValuesFor, useSetFormValue };
+
+//# sourceMappingURL=values.js.map

package/dist/form/hooks/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","names":[],"sources":["../../../resources/js/form/hooks/values.tsx"],"sourcesContent":["import {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useSyncExternalStore,\n} from \"react\";\nimport { getPath, setPath } from \"@lattice-php/lattice/form/lib/form-path\";\n\nexport type SetFormValue = (\n  name: string,\n  value: unknown | ((previous: unknown) => unknown),\n) => void;\n\ntype FormValuesStore = {\n  getPathSnapshot: (path: string) => unknown;\n  getPathsSnapshot: (paths: string[]) => Record<string, unknown>;\n  getSnapshot: () => Record<string, unknown>;\n  replaceInitial: (initial: Record<string, unknown>) => void;\n  setValue: SetFormValue;\n  subscribe: (listener: () => void) => () => void;\n  subscribePath: (path: string, listener: () => void) => () => void;\n  subscribePaths: (paths: string[], listener: () => void) => () => void;\n};\n\nconst emptyValues: Record<string, unknown> = {};\nconst emptySelectedValues: Record<string, unknown> = {};\n\nconst FormValuesStoreContext = createContext<FormValuesStore | null>(null);\nconst SetFormValueContext = createContext<SetFormValue>(() => {});\n\nfunction valuesEqual(a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) {\n    return true;\n  }\n\n  if (!a || !b || typeof a !== \"object\" || typeof b !== \"object\") {\n    return false;\n  }\n\n  if (Array.isArray(a) || Array.isArray(b)) {\n    return (\n      Array.isArray(a) &&\n      Array.isArray(b) &&\n      a.length === b.length &&\n      a.every((value, index) => valuesEqual(value, b[index]))\n    );\n  }\n\n  const aEntries = Object.entries(a);\n  const bObject = b as Record<string, unknown>;\n\n  return (\n    aEntries.length === Object.keys(bObject).length &&\n    aEntries.every(([key, value]) => valuesEqual(value, bObject[key]))\n  );\n}\n\nfunction normalizePath(path: string): string {\n  return path\n    .split(\".\")\n    .filter((part) => part !== \"\")\n    .join(\".\");\n}\n\nfunction pathsOverlap(left: string, right: string): boolean {\n  return (\n    left === \"\" ||\n    right === \"\" ||\n    left === right ||\n    left.startsWith(`${right}.`) ||\n    right.startsWith(`${left}.`)\n  );\n}\n\nfunction createFormValuesStore(initial: Record<string, unknown>): FormValuesStore {\n  let initialValues = initial;\n  let values = initial;\n  const listeners = new Set<() => void>();\n  const pathListeners = new Map<string, Set<() => void>>();\n  const selectedCache = new Map<string, { snapshot: Record<string, unknown>; values: unknown[] }>();\n\n  const notify = (path: string): void => {\n    for (const listener of listeners) {\n      listener();\n    }\n\n    const normalizedPath = normalizePath(path);\n\n    for (const [subscribedPath, subscribedListeners] of pathListeners) {\n      if (!pathsOverlap(subscribedPath, normalizedPath)) {\n        continue;\n      }\n\n      for (const listener of subscribedListeners) {\n        listener();\n      }\n    }\n  };\n\n  const updateValues = (next: Record<string, unknown>, path: string): void => {\n    if (Object.is(values, next)) {\n      return;\n    }\n\n    values = next;\n    selectedCache.clear();\n    notify(path);\n  };\n\n  const subscribePath = (path: string, listener: () => void): (() => void) => {\n    const normalizedPath = normalizePath(path);\n    const listenersForPath = pathListeners.get(normalizedPath) ?? new Set<() => void>();\n\n    listenersForPath.add(listener);\n    pathListeners.set(normalizedPath, listenersForPath);\n\n    return () => {\n      listenersForPath.delete(listener);\n\n      if (listenersForPath.size === 0) {\n        pathListeners.delete(normalizedPath);\n      }\n    };\n  };\n\n  return {\n    getPathSnapshot: (path: string): unknown => getPath(values, path),\n    getPathsSnapshot: (paths: string[]): Record<string, unknown> => {\n      if (paths.length === 0) {\n        return emptySelectedValues;\n      }\n\n      const normalizedPaths = paths.map(normalizePath);\n      const key = JSON.stringify(paths);\n      const selectedValues = normalizedPaths.map((path) => getPath(values, path));\n      const cached = selectedCache.get(key);\n\n      if (\n        cached &&\n        cached.values.length === selectedValues.length &&\n        selectedValues.every((value, index) => Object.is(value, cached.values[index]))\n      ) {\n        return cached.snapshot;\n      }\n\n      const snapshot = Object.fromEntries(\n        paths.map((path, index) => [path, selectedValues[index]]),\n      );\n\n      selectedCache.set(key, { snapshot, values: selectedValues });\n\n      return snapshot;\n    },\n    getSnapshot: () => values,\n    replaceInitial: (nextInitial: Record<string, unknown>): void => {\n      if (valuesEqual(initialValues, nextInitial)) {\n        return;\n      }\n\n      initialValues = nextInitial;\n      updateValues(nextInitial, \"\");\n    },\n    setValue: (name: string, value: unknown | ((previous: unknown) => unknown)): void => {\n      const previous = getPath(values, name);\n      const next = typeof value === \"function\" ? value(previous) : value;\n\n      if (Object.is(previous, next)) {\n        return;\n      }\n\n      updateValues(setPath(values, name, next), name);\n    },\n    subscribe: (listener: () => void): (() => void) => {\n      listeners.add(listener);\n\n      return () => listeners.delete(listener);\n    },\n    subscribePath,\n    subscribePaths: (paths: string[], listener: () => void): (() => void) => {\n      const unsubscribers = Array.from(new Set(paths.map(normalizePath))).map((path) =>\n        subscribePath(path, listener),\n      );\n\n      return () => {\n        for (const unsubscribe of unsubscribers) {\n          unsubscribe();\n        }\n      };\n    },\n  };\n}\n\nconst fallbackFormValuesStore = createFormValuesStore(emptyValues);\n\nexport function FormValuesProvider({\n  initial,\n  children,\n}: {\n  initial: Record<string, unknown>;\n  children: React.ReactNode;\n}) {\n  const storeRef = useRef<FormValuesStore>(null);\n\n  if (storeRef.current === null) {\n    storeRef.current = createFormValuesStore(initial);\n  }\n\n  useEffect(() => {\n    storeRef.current?.replaceInitial(initial);\n  }, [initial]);\n\n  return (\n    <FormValuesStoreContext.Provider value={storeRef.current}>\n      <SetFormValueContext.Provider value={storeRef.current.setValue}>\n        {children}\n      </SetFormValueContext.Provider>\n    </FormValuesStoreContext.Provider>\n  );\n}\n\nfunction useFormValuesStore(): FormValuesStore {\n  return useContext(FormValuesStoreContext) ?? fallbackFormValuesStore;\n}\n\nexport function useFormValues(): Record<string, unknown> {\n  const store = useFormValuesStore();\n\n  return useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);\n}\n\nexport function useFormValue(name: string): unknown {\n  const store = useFormValuesStore();\n  const subscribe = useCallback(\n    (listener: () => void) => store.subscribePath(name, listener),\n    [name, store],\n  );\n  const getSnapshot = useCallback(() => store.getPathSnapshot(name), [name, store]);\n\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nexport function useFormValuesFor(paths: string[]): Record<string, unknown> {\n  const store = useFormValuesStore();\n  const pathsKey = JSON.stringify(paths);\n  const selectedPaths = useMemo(() => JSON.parse(pathsKey) as string[], [pathsKey]);\n  const subscribe = useCallback(\n    (listener: () => void) => store.subscribePaths(selectedPaths, listener),\n    [selectedPaths, store],\n  );\n  const getSnapshot = useCallback(\n    () => store.getPathsSnapshot(selectedPaths),\n    [selectedPaths, store],\n  );\n\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nexport function useSetFormValue(): SetFormValue {\n  return useContext(SetFormValueContext);\n}\n"],"mappings":"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"}

package/dist/form/index.d.ts

@@ -1 +1,4 @@
-export declare const formComponents: import('../core/registry').Plugin;
+export * from './components/index.js';
+export { FormValuesProvider } from './hooks/values.js';
+export { formComponents } from './plugin.js';
+export type * from './types.js';

package/dist/form/index.js

@@ -1,39 +1,20 @@
-import { createPlugin, lazyComponent } from "../core/registry.js";
-import { FormSkeletonComponent } from "./skeleton.js";
-//#region resources/js/form/index.ts
-var loadFormComponents = () => import("./components/index.js");
-function loadFormComponent(name) {
-	return async () => {
-		return { default: (await loadFormComponents())[name] };
-	};
-}
-var formComponents = createPlugin({
-	components: {
-		form: lazyComponent(loadFormComponent("FormComponent"), { fallback: FormSkeletonComponent }),
-		"field.builder": lazyComponent(loadFormComponent("BuilderComponent")),
-		"field.checkbox": lazyComponent(loadFormComponent("CheckboxComponent")),
-		"field.choice": lazyComponent(loadFormComponent("ChoiceComponent")),
-		"field.date-input": lazyComponent(loadFormComponent("DateInputComponent")),
-		"field.date-time-input": lazyComponent(loadFormComponent("DateTimeInputComponent")),
-		"field.file-upload": lazyComponent(loadFormComponent("FileUploadComponent")),
-		"field.hidden-input": lazyComponent(loadFormComponent("HiddenInputComponent")),
-		"field.number-input": lazyComponent(loadFormComponent("NumberInputComponent")),
-		"field.otp": lazyComponent(loadFormComponent("OtpInputComponent")),
-		"field.password-input": lazyComponent(loadFormComponent("PasswordInputComponent")),
-		"field.repeater": lazyComponent(loadFormComponent("RepeaterComponent")),
-		"field.rich-editor": lazyComponent(async () => {
-			const { RichEditorComponent } = await import("./components/fields/rich-editor.js");
-			return { default: RichEditorComponent };
-		}),
-		"field.select": lazyComponent(loadFormComponent("SelectComponent")),
-		"field.textarea": lazyComponent(loadFormComponent("TextareaComponent")),
-		"field.text-input": lazyComponent(loadFormComponent("TextInputComponent")),
-		"field.time-input": lazyComponent(loadFormComponent("TimeInputComponent")),
-		"field.toggle": lazyComponent(loadFormComponent("ToggleComponent"))
-	},
-	name: "lattice/form"
-});
-//#endregion
-export { formComponents };
-
-//# sourceMappingURL=index.js.map
+import { FormValuesProvider } from "./hooks/values.js";
+import { BuilderComponent } from "./components/fields/builder.js";
+import { CheckboxComponent } from "./components/fields/checkbox.js";
+import { ChoiceComponent } from "./components/fields/choice.js";
+import { DateInputComponent } from "./components/fields/date-input.js";
+import { DateTimeInputComponent } from "./components/fields/date-time-input.js";
+import { FileUploadComponent } from "./components/fields/file-upload.js";
+import { FormComponent } from "./components/form.js";
+import { HiddenInputComponent } from "./components/fields/hidden-input.js";
+import { NumberInputComponent } from "./components/fields/number-input.js";
+import { OtpInputComponent } from "./components/fields/otp-input.js";
+import { PasswordInputComponent } from "./components/fields/password-input.js";
+import { RepeaterComponent } from "./components/fields/repeater.js";
+import { SelectComponent } from "./components/fields/select.js";
+import { TextareaComponent } from "./components/fields/textarea.js";
+import { TextInputComponent } from "./components/fields/text-input.js";
+import { TimeInputComponent } from "./components/fields/time-input.js";
+import { ToggleComponent } from "./components/fields/toggle.js";
+import { formComponents } from "./plugin.js";
+export { BuilderComponent, CheckboxComponent, ChoiceComponent, DateInputComponent, DateTimeInputComponent, FileUploadComponent, FormComponent, FormValuesProvider, HiddenInputComponent, NumberInputComponent, OtpInputComponent, PasswordInputComponent, RepeaterComponent, SelectComponent, TextInputComponent, TextareaComponent, TimeInputComponent, ToggleComponent, formComponents };

package/dist/form/{components → lib}/conditions.d.ts

@@ -1,4 +1,4 @@
-import { Condition } from '../../types/generated';
+import { Condition } from '../../types/generated.js';
 export type { Condition };
 export type FieldConditions = {
     visible?: Condition[];
@@ -18,5 +18,6 @@ export type FieldState = {
     readOnly: boolean;
     disabled: boolean;
 };
+export declare function conditionFields(conditions: FieldConditions | undefined | null): string[];
 export declare function toBoolean(value: unknown): boolean;
 export declare function evaluateConditions(conditions: FieldConditions | undefined, values: Record<string, unknown>, flags: FieldFlags): FieldState;

package/dist/form/{components → lib}/conditions.js

@@ -1,4 +1,14 @@
-//#region resources/js/form/components/conditions.ts
+//#region resources/js/form/lib/conditions.ts
+function conditionFields(conditions) {
+	const fields = /* @__PURE__ */ new Set();
+	for (const group of [
+		conditions?.visible,
+		conditions?.required,
+		conditions?.readOnly,
+		conditions?.disabled
+	]) for (const condition of group ?? []) fields.add(condition.field);
+	return Array.from(fields);
+}
 var BOOLEAN_TRUE_VALUES = new Set([
 	"1",
 	"true",
@@ -65,6 +75,6 @@ function evaluateConditions(conditions, values, flags) {
 	};
 }
 //#endregion
-export { evaluateConditions, toBoolean };
+export { conditionFields, evaluateConditions, toBoolean };
 
 //# sourceMappingURL=conditions.js.map