@lattice-php/lattice 0.17.2 → 0.19.0

package/dist/form/components/form.js

@@ -1,11 +1,11 @@
 import { LATTICE_EVENT } from "../../events/event-names.js";
 import { withHeaders } from "../../core/headers.js";
-import { FormProvider } from "./context.js";
-import { walkFields } from "./field-props.js";
-import { PrefillProvider } from "./prefill-context.js";
-import { ResolvedNodesProvider } from "./resolved-nodes.js";
-import { FormValuesProvider } from "./values.js";
-import { useFormResolver } from "./use-form-resolver.js";
+import { FormProvider } from "../hooks/context.js";
+import { PrefillProvider } from "../hooks/prefill-context.js";
+import { walkFields } from "../lib/field-props.js";
+import { ResolvedNodesProvider } from "../hooks/resolved-nodes.js";
+import { FormValuesProvider } from "../hooks/values.js";
+import { useFormResolver } from "../hooks/use-form-resolver.js";
 import { FormSubmitButton } from "./base/submit-button.js";
 import { Form } from "@inertiajs/react";
 import { useEffect, useMemo } from "react";

package/dist/form/components/form.js.map

@@ -1 +1 @@
-{"version":3,"file":"form.js","names":[],"sources":["../../../resources/js/form/components/form.tsx"],"sourcesContent":["import { Form as InertiaForm } from \"@inertiajs/react\";\nimport { withHeaders } from \"@lattice-php/lattice/core/headers\";\nimport { LATTICE_EVENT } from \"@lattice-php/lattice/events/event-names\";\nimport type { Node, RendererComponent } from \"@lattice-php/lattice/core/types\";\nimport { useEffect, useMemo } from \"react\";\nimport { FormSubmitButton } from \"./base/submit-button\";\nimport { FormProvider } from \"./context\";\nimport { walkFields } from \"./field-props\";\nimport { PrefillProvider } from \"./prefill-context\";\nimport { ResolvedNodesProvider } from \"./resolved-nodes\";\nimport { useFormResolver } from \"./use-form-resolver\";\nimport { FormValuesProvider } from \"./values\";\n\ntype CollectedFields = {\n  labels: Record<string, string>;\n  values: Record<string, unknown>;\n};\n\nfunction collectFields(nodes: Node[] | undefined): CollectedFields {\n  const collected: CollectedFields = { labels: {}, values: {} };\n\n  walkFields(nodes, (props) => {\n    if (!props.name) {\n      return;\n    }\n    if (props.label) {\n      collected.labels[props.name] = props.label;\n    }\n    if (props.value !== undefined) {\n      collected.values[props.name] = props.value;\n    }\n  });\n\n  return collected;\n}\n\nfunction FormResetListener({\n  componentId,\n  reset,\n}: {\n  componentId?: string;\n  reset: (...fields: string[]) => void;\n}) {\n  useEffect(() => {\n    const handler = (event: Event) => {\n      const detail = (event as CustomEvent<{ form: string | null }>).detail;\n\n      if (!detail?.form || detail.form === componentId) {\n        reset();\n      }\n    };\n\n    window.addEventListener(LATTICE_EVENT.resetForm, handler);\n\n    return () => window.removeEventListener(LATTICE_EVENT.resetForm, handler);\n  }, [componentId, reset]);\n\n  return null;\n}\n\nfunction FormBody({\n  action,\n  children,\n  componentRef,\n  nodes,\n  shouldRenderSubmitButton,\n  submitLabel,\n  summaryLabel,\n}: {\n  action: string;\n  children: React.ReactNode;\n  componentRef: string;\n  nodes: Node[] | undefined;\n  shouldRenderSubmitButton: boolean;\n  submitLabel: string;\n  summaryLabel: string;\n}) {\n  const { nodes: resolvedNodes, markUserEdit } = useFormResolver(action, componentRef, nodes);\n\n  return (\n    <PrefillProvider value={{ markUserEdit }}>\n      <ResolvedNodesProvider nodes={resolvedNodes}>\n        <div className=\"flex flex-col gap-6\">\n          {children}\n\n          {shouldRenderSubmitButton && (\n            <div className=\"flex justify-end rounded-lt border border-lt-border bg-lt-surface px-lt-gutter py-4 shadow-lt-sm\">\n              <FormSubmitButton label={submitLabel} summaryLabel={summaryLabel} />\n            </div>\n          )}\n        </div>\n      </ResolvedNodesProvider>\n    </PrefillProvider>\n  );\n}\n\nexport const FormComponent: RendererComponent<\"form\"> = ({ children, node }) => {\n  const props = node.props;\n  const action = props.action ?? \"#\";\n  const errorBag = props.errorBag;\n  const componentRef = props.ref ?? \"\";\n  const method = props.method ?? \"post\";\n  const precognitive = props.precognitive;\n  const resetOnError = props.resetOnError ?? false;\n  const resetOnSuccess = props.resetOnSuccess ?? [];\n  const state = props.state;\n  const { labels: fieldLabels, values: fieldValues } = useMemo(\n    () => collectFields(node.schema),\n    [node.schema],\n  );\n  const initialValues = useMemo(() => ({ ...fieldValues, ...state }), [fieldValues, state]);\n  const shouldRenderSubmitButton = props.submitButton;\n  const submitLabel = props.submitLabel ?? \"Submit\";\n  const summaryLabel = props.validationSummaryLabel;\n  const validationTimeout = props.validationTimeout ?? undefined;\n\n  return (\n    <InertiaForm\n      action={action}\n      data-slot=\"form\"\n      data-lattice-component={node.id}\n      errorBag={errorBag}\n      method={method}\n      resetOnError={resetOnError}\n      resetOnSuccess={resetOnSuccess}\n      validationTimeout={precognitive ? validationTimeout : undefined}\n      headers={withHeaders(componentRef)}\n      className=\"mx-auto flex w-full max-w-2xl flex-col gap-6\"\n    >\n      {({ clearErrors, errors, processing, reset, validate }) => (\n        <FormProvider\n          value={{\n            action,\n            clearErrors: (field) => clearErrors(field),\n            componentId: node.id,\n            componentRef,\n            errors: errors as Record<string, string | undefined>,\n            fieldLabels,\n            precognitive,\n            processing,\n            validate: (field) => validate(field),\n          }}\n        >\n          <FormResetListener componentId={node.id} reset={reset} />\n\n          {props.status && (\n            <div className=\"text-center text-sm font-medium text-lt-success\">{props.status}</div>\n          )}\n\n          <FormValuesProvider initial={initialValues}>\n            <FormBody\n              action={action}\n              componentRef={componentRef}\n              nodes={node.schema}\n              shouldRenderSubmitButton={shouldRenderSubmitButton}\n              submitLabel={submitLabel}\n              summaryLabel={summaryLabel}\n            >\n              {children}\n            </FormBody>\n          </FormValuesProvider>\n        </FormProvider>\n      )}\n    </InertiaForm>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;AAkBA,SAAS,cAAc,OAA4C;CACjE,MAAM,YAA6B;EAAE,QAAQ,CAAC;EAAG,QAAQ,CAAC;CAAE;CAE5D,WAAW,QAAQ,UAAU;EAC3B,IAAI,CAAC,MAAM,MACT;EAEF,IAAI,MAAM,OACR,UAAU,OAAO,MAAM,QAAQ,MAAM;EAEvC,IAAI,MAAM,UAAU,KAAA,GAClB,UAAU,OAAO,MAAM,QAAQ,MAAM;CAEzC,CAAC;CAED,OAAO;AACT;AAEA,SAAS,kBAAkB,EACzB,aACA,SAIC;CACD,gBAAgB;EACd,MAAM,WAAW,UAAiB;GAChC,MAAM,SAAU,MAA+C;GAE/D,IAAI,CAAC,QAAQ,QAAQ,OAAO,SAAS,aACnC,MAAM;EAEV;EAEA,OAAO,iBAAiB,cAAc,WAAW,OAAO;EAExD,aAAa,OAAO,oBAAoB,cAAc,WAAW,OAAO;CAC1E,GAAG,CAAC,aAAa,KAAK,CAAC;CAEvB,OAAO;AACT;AAEA,SAAS,SAAS,EAChB,QACA,UACA,cACA,OACA,0BACA,aACA,gBASC;CACD,MAAM,EAAE,OAAO,eAAe,iBAAiB,gBAAgB,QAAQ,cAAc,KAAK;CAE1F,OACE,oBAAC,iBAAD;EAAiB,OAAO,EAAE,aAAa;YACrC,oBAAC,uBAAD;GAAuB,OAAO;aAC5B,qBAAC,OAAD;IAAK,WAAU;cAAf,CACG,UAEA,4BACC,oBAAC,OAAD;KAAK,WAAU;eACb,oBAAC,kBAAD;MAAkB,OAAO;MAA2B;KAAe,CAAA;IAChE,CAAA,CAEJ;;EACgB,CAAA;CACR,CAAA;AAErB;AAEA,IAAa,iBAA4C,EAAE,UAAU,WAAW;CAC9E,MAAM,QAAQ,KAAK;CACnB,MAAM,SAAS,MAAM,UAAU;CAC/B,MAAM,WAAW,MAAM;CACvB,MAAM,eAAe,MAAM,OAAO;CAClC,MAAM,SAAS,MAAM,UAAU;CAC/B,MAAM,eAAe,MAAM;CAC3B,MAAM,eAAe,MAAM,gBAAgB;CAC3C,MAAM,iBAAiB,MAAM,kBAAkB,CAAC;CAChD,MAAM,QAAQ,MAAM;CACpB,MAAM,EAAE,QAAQ,aAAa,QAAQ,gBAAgB,cAC7C,cAAc,KAAK,MAAM,GAC/B,CAAC,KAAK,MAAM,CACd;CACA,MAAM,gBAAgB,eAAe;EAAE,GAAG;EAAa,GAAG;CAAM,IAAI,CAAC,aAAa,KAAK,CAAC;CACxF,MAAM,2BAA2B,MAAM;CACvC,MAAM,cAAc,MAAM,eAAe;CACzC,MAAM,eAAe,MAAM;CAC3B,MAAM,oBAAoB,MAAM,qBAAqB,KAAA;CAErD,OACE,oBAAC,MAAD;EACU;EACR,aAAU;EACV,0BAAwB,KAAK;EACnB;EACF;EACM;EACE;EAChB,mBAAmB,eAAe,oBAAoB,KAAA;EACtD,SAAS,YAAY,YAAY;EACjC,WAAU;aAER,EAAE,aAAa,QAAQ,YAAY,OAAO,eAC1C,qBAAC,cAAD;GACE,OAAO;IACL;IACA,cAAc,UAAU,YAAY,KAAK;IACzC,aAAa,KAAK;IAClB;IACQ;IACR;IACA;IACA;IACA,WAAW,UAAU,SAAS,KAAK;GACrC;aAXF;IAaE,oBAAC,mBAAD;KAAmB,aAAa,KAAK;KAAW;IAAQ,CAAA;IAEvD,MAAM,UACL,oBAAC,OAAD;KAAK,WAAU;eAAmD,MAAM;IAAY,CAAA;IAGtF,oBAAC,oBAAD;KAAoB,SAAS;eAC3B,oBAAC,UAAD;MACU;MACM;MACd,OAAO,KAAK;MACc;MACb;MACC;MAEb;KACO,CAAA;IACQ,CAAA;GACR;;CAEL,CAAA;AAEjB"}
+{"version":3,"file":"form.js","names":[],"sources":["../../../resources/js/form/components/form.tsx"],"sourcesContent":["import { Form as InertiaForm } from \"@inertiajs/react\";\nimport { withHeaders } from \"@lattice-php/lattice/core/headers\";\nimport { LATTICE_EVENT } from \"@lattice-php/lattice/events/event-names\";\nimport type { Node, RendererComponent } from \"@lattice-php/lattice/core/types\";\nimport { useEffect, useMemo } from \"react\";\nimport { FormSubmitButton } from \"./base/submit-button\";\nimport { FormProvider } from \"@lattice-php/lattice/form/hooks/context\";\nimport { walkFields } from \"@lattice-php/lattice/form/lib/field-props\";\nimport { PrefillProvider } from \"@lattice-php/lattice/form/hooks/prefill-context\";\nimport { ResolvedNodesProvider } from \"@lattice-php/lattice/form/hooks/resolved-nodes\";\nimport { useFormResolver } from \"@lattice-php/lattice/form/hooks/use-form-resolver\";\nimport { FormValuesProvider } from \"@lattice-php/lattice/form/hooks/values\";\n\ntype CollectedFields = {\n  labels: Record<string, string>;\n  values: Record<string, unknown>;\n};\n\nfunction collectFields(nodes: Node[] | undefined): CollectedFields {\n  const collected: CollectedFields = { labels: {}, values: {} };\n\n  walkFields(nodes, (props) => {\n    if (!props.name) {\n      return;\n    }\n    if (props.label) {\n      collected.labels[props.name] = props.label;\n    }\n    if (props.value !== undefined) {\n      collected.values[props.name] = props.value;\n    }\n  });\n\n  return collected;\n}\n\nfunction FormResetListener({\n  componentId,\n  reset,\n}: {\n  componentId?: string;\n  reset: (...fields: string[]) => void;\n}) {\n  useEffect(() => {\n    const handler = (event: Event) => {\n      const detail = (event as CustomEvent<{ form: string | null }>).detail;\n\n      if (!detail?.form || detail.form === componentId) {\n        reset();\n      }\n    };\n\n    window.addEventListener(LATTICE_EVENT.resetForm, handler);\n\n    return () => window.removeEventListener(LATTICE_EVENT.resetForm, handler);\n  }, [componentId, reset]);\n\n  return null;\n}\n\nfunction FormBody({\n  action,\n  children,\n  componentRef,\n  nodes,\n  shouldRenderSubmitButton,\n  submitLabel,\n  summaryLabel,\n}: {\n  action: string;\n  children: React.ReactNode;\n  componentRef: string;\n  nodes: Node[] | undefined;\n  shouldRenderSubmitButton: boolean;\n  submitLabel: string;\n  summaryLabel: string;\n}) {\n  const { nodes: resolvedNodes, markUserEdit } = useFormResolver(action, componentRef, nodes);\n\n  return (\n    <PrefillProvider value={{ markUserEdit }}>\n      <ResolvedNodesProvider nodes={resolvedNodes}>\n        <div className=\"flex flex-col gap-6\">\n          {children}\n\n          {shouldRenderSubmitButton && (\n            <div className=\"flex justify-end rounded-lt border border-lt-border bg-lt-surface px-lt-gutter py-4 shadow-lt-sm\">\n              <FormSubmitButton label={submitLabel} summaryLabel={summaryLabel} />\n            </div>\n          )}\n        </div>\n      </ResolvedNodesProvider>\n    </PrefillProvider>\n  );\n}\n\nexport const FormComponent: RendererComponent<\"form\"> = ({ children, node }) => {\n  const props = node.props;\n  const action = props.action ?? \"#\";\n  const errorBag = props.errorBag;\n  const componentRef = props.ref ?? \"\";\n  const method = props.method ?? \"post\";\n  const precognitive = props.precognitive;\n  const resetOnError = props.resetOnError ?? false;\n  const resetOnSuccess = props.resetOnSuccess ?? [];\n  const state = props.state;\n  const { labels: fieldLabels, values: fieldValues } = useMemo(\n    () => collectFields(node.schema),\n    [node.schema],\n  );\n  const initialValues = useMemo(() => ({ ...fieldValues, ...state }), [fieldValues, state]);\n  const shouldRenderSubmitButton = props.submitButton;\n  const submitLabel = props.submitLabel ?? \"Submit\";\n  const summaryLabel = props.validationSummaryLabel;\n  const validationTimeout = props.validationTimeout ?? undefined;\n\n  return (\n    <InertiaForm\n      action={action}\n      data-slot=\"form\"\n      data-lattice-component={node.id}\n      errorBag={errorBag}\n      method={method}\n      resetOnError={resetOnError}\n      resetOnSuccess={resetOnSuccess}\n      validationTimeout={precognitive ? validationTimeout : undefined}\n      headers={withHeaders(componentRef)}\n      className=\"mx-auto flex w-full max-w-2xl flex-col gap-6\"\n    >\n      {({ clearErrors, errors, processing, reset, validate }) => (\n        <FormProvider\n          value={{\n            action,\n            clearErrors: (field) => clearErrors(field),\n            componentId: node.id,\n            componentRef,\n            errors: errors as Record<string, string | undefined>,\n            fieldLabels,\n            precognitive,\n            processing,\n            validate: (field) => validate(field),\n          }}\n        >\n          <FormResetListener componentId={node.id} reset={reset} />\n\n          {props.status && (\n            <div className=\"text-center text-sm font-medium text-lt-success\">{props.status}</div>\n          )}\n\n          <FormValuesProvider initial={initialValues}>\n            <FormBody\n              action={action}\n              componentRef={componentRef}\n              nodes={node.schema}\n              shouldRenderSubmitButton={shouldRenderSubmitButton}\n              submitLabel={submitLabel}\n              summaryLabel={summaryLabel}\n            >\n              {children}\n            </FormBody>\n          </FormValuesProvider>\n        </FormProvider>\n      )}\n    </InertiaForm>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;AAkBA,SAAS,cAAc,OAA4C;CACjE,MAAM,YAA6B;EAAE,QAAQ,CAAC;EAAG,QAAQ,CAAC;CAAE;CAE5D,WAAW,QAAQ,UAAU;EAC3B,IAAI,CAAC,MAAM,MACT;EAEF,IAAI,MAAM,OACR,UAAU,OAAO,MAAM,QAAQ,MAAM;EAEvC,IAAI,MAAM,UAAU,KAAA,GAClB,UAAU,OAAO,MAAM,QAAQ,MAAM;CAEzC,CAAC;CAED,OAAO;AACT;AAEA,SAAS,kBAAkB,EACzB,aACA,SAIC;CACD,gBAAgB;EACd,MAAM,WAAW,UAAiB;GAChC,MAAM,SAAU,MAA+C;GAE/D,IAAI,CAAC,QAAQ,QAAQ,OAAO,SAAS,aACnC,MAAM;EAEV;EAEA,OAAO,iBAAiB,cAAc,WAAW,OAAO;EAExD,aAAa,OAAO,oBAAoB,cAAc,WAAW,OAAO;CAC1E,GAAG,CAAC,aAAa,KAAK,CAAC;CAEvB,OAAO;AACT;AAEA,SAAS,SAAS,EAChB,QACA,UACA,cACA,OACA,0BACA,aACA,gBASC;CACD,MAAM,EAAE,OAAO,eAAe,iBAAiB,gBAAgB,QAAQ,cAAc,KAAK;CAE1F,OACE,oBAAC,iBAAD;EAAiB,OAAO,EAAE,aAAa;YACrC,oBAAC,uBAAD;GAAuB,OAAO;aAC5B,qBAAC,OAAD;IAAK,WAAU;cAAf,CACG,UAEA,4BACC,oBAAC,OAAD;KAAK,WAAU;eACb,oBAAC,kBAAD;MAAkB,OAAO;MAA2B;KAAe,CAAA;IAChE,CAAA,CAEJ;;EACgB,CAAA;CACR,CAAA;AAErB;AAEA,IAAa,iBAA4C,EAAE,UAAU,WAAW;CAC9E,MAAM,QAAQ,KAAK;CACnB,MAAM,SAAS,MAAM,UAAU;CAC/B,MAAM,WAAW,MAAM;CACvB,MAAM,eAAe,MAAM,OAAO;CAClC,MAAM,SAAS,MAAM,UAAU;CAC/B,MAAM,eAAe,MAAM;CAC3B,MAAM,eAAe,MAAM,gBAAgB;CAC3C,MAAM,iBAAiB,MAAM,kBAAkB,CAAC;CAChD,MAAM,QAAQ,MAAM;CACpB,MAAM,EAAE,QAAQ,aAAa,QAAQ,gBAAgB,cAC7C,cAAc,KAAK,MAAM,GAC/B,CAAC,KAAK,MAAM,CACd;CACA,MAAM,gBAAgB,eAAe;EAAE,GAAG;EAAa,GAAG;CAAM,IAAI,CAAC,aAAa,KAAK,CAAC;CACxF,MAAM,2BAA2B,MAAM;CACvC,MAAM,cAAc,MAAM,eAAe;CACzC,MAAM,eAAe,MAAM;CAC3B,MAAM,oBAAoB,MAAM,qBAAqB,KAAA;CAErD,OACE,oBAAC,MAAD;EACU;EACR,aAAU;EACV,0BAAwB,KAAK;EACnB;EACF;EACM;EACE;EAChB,mBAAmB,eAAe,oBAAoB,KAAA;EACtD,SAAS,YAAY,YAAY;EACjC,WAAU;aAER,EAAE,aAAa,QAAQ,YAAY,OAAO,eAC1C,qBAAC,cAAD;GACE,OAAO;IACL;IACA,cAAc,UAAU,YAAY,KAAK;IACzC,aAAa,KAAK;IAClB;IACQ;IACR;IACA;IACA;IACA,WAAW,UAAU,SAAS,KAAK;GACrC;aAXF;IAaE,oBAAC,mBAAD;KAAmB,aAAa,KAAK;KAAW;IAAQ,CAAA;IAEvD,MAAM,UACL,oBAAC,OAAD;KAAK,WAAU;eAAmD,MAAM;IAAY,CAAA;IAGtF,oBAAC,oBAAD;KAAoB,SAAS;eAC3B,oBAAC,UAAD;MACU;MACM;MACd,OAAO,KAAK;MACc;MACb;MACC;MAEb;KACO,CAAA;IACQ,CAAA;GACR;;CAEL,CAAA;AAEjB"}

package/dist/form/components/index.d.ts

@@ -1,17 +1,17 @@
-export { BuilderComponent } from './fields/builder';
-export { CheckboxComponent } from './fields/checkbox';
-export { ChoiceComponent } from './fields/choice';
-export { DateInputComponent } from './fields/date-input';
-export { DateTimeInputComponent } from './fields/date-time-input';
-export { FileUploadComponent } from './fields/file-upload';
-export { FormComponent } from './form';
-export { HiddenInputComponent } from './fields/hidden-input';
-export { NumberInputComponent } from './fields/number-input';
-export { OtpInputComponent } from './fields/otp-input';
-export { PasswordInputComponent } from './fields/password-input';
-export { RepeaterComponent } from './fields/repeater';
-export { SelectComponent } from './fields/select';
-export { TextareaComponent } from './fields/textarea';
-export { TextInputComponent } from './fields/text-input';
-export { TimeInputComponent } from './fields/time-input';
-export { ToggleComponent } from './fields/toggle';
+export { BuilderComponent } from './fields/builder.js';
+export { CheckboxComponent } from './fields/checkbox.js';
+export { ChoiceComponent } from './fields/choice.js';
+export { DateInputComponent } from './fields/date-input.js';
+export { DateTimeInputComponent } from './fields/date-time-input.js';
+export { FileUploadComponent } from './fields/file-upload.js';
+export { FormComponent } from './form.js';
+export { HiddenInputComponent } from './fields/hidden-input.js';
+export { NumberInputComponent } from './fields/number-input.js';
+export { OtpInputComponent } from './fields/otp-input.js';
+export { PasswordInputComponent } from './fields/password-input.js';
+export { RepeaterComponent } from './fields/repeater.js';
+export { SelectComponent } from './fields/select.js';
+export { TextareaComponent } from './fields/textarea.js';
+export { TextInputComponent } from './fields/text-input.js';
+export { TimeInputComponent } from './fields/time-input.js';
+export { ToggleComponent } from './fields/toggle.js';

package/dist/form/embed.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Entry point for hosting a form runtime outside the `<Form>` component — action
+ * dialogs, table filter rows, and similar schema-driven surfaces. The counterpart
+ * to `toolkit.ts` (which serves custom-field authors): everything a host needs to
+ * provide form state, prefill, and dependent-field resolution around rendered
+ * fields. Form modules not re-exported here or in the toolkit are internal and
+ * may change without notice.
+ */
+export { FormProvider } from './hooks/context.js';
+export { PrefillProvider } from './hooks/prefill-context.js';
+export { ResolvedNodesProvider } from './hooks/resolved-nodes.js';
+export { FieldCommitOverrideProvider } from './hooks/use-field-commit.js';
+export { useFormResolver } from './hooks/use-form-resolver.js';
+export { FormValuesProvider, useFormValues, useSetFormValue } from './hooks/values.js';
+export { walkFields } from './lib/field-props.js';
+export { appendPath, getPath, setPath } from './lib/form-path.js';
+export { FORM_DEBOUNCE_MS } from './lib/form-transport.js';

package/dist/form/embed.js

@@ -0,0 +1,10 @@
+import { FormProvider } from "./hooks/context.js";
+import { PrefillProvider } from "./hooks/prefill-context.js";
+import { walkFields } from "./lib/field-props.js";
+import { appendPath, getPath, setPath } from "./lib/form-path.js";
+import { ResolvedNodesProvider } from "./hooks/resolved-nodes.js";
+import { FormValuesProvider, useFormValues, useSetFormValue } from "./hooks/values.js";
+import { FieldCommitOverrideProvider } from "./hooks/use-field-commit.js";
+import { FORM_DEBOUNCE_MS } from "./lib/form-transport.js";
+import { useFormResolver } from "./hooks/use-form-resolver.js";
+export { FORM_DEBOUNCE_MS, FieldCommitOverrideProvider, FormProvider, FormValuesProvider, PrefillProvider, ResolvedNodesProvider, appendPath, getPath, setPath, useFormResolver, useFormValues, useSetFormValue, walkFields };

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