@lattice-php/lattice 0.17.2 → 0.18.0

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":"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"}

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,4 +1,4 @@
-import { createPlugin, eagerComponent } from "../core/registry.js";
+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";
@@ -16,32 +16,5 @@ 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 { RichEditorComponent } from "./components/fields/rich-editor.js";
-//#region resources/js/form/index.ts
-var formComponents = createPlugin({
-	components: {
-		form: eagerComponent(FormComponent),
-		"field.builder": eagerComponent(BuilderComponent),
-		"field.checkbox": eagerComponent(CheckboxComponent),
-		"field.choice": eagerComponent(ChoiceComponent),
-		"field.date-input": eagerComponent(DateInputComponent),
-		"field.date-time-input": eagerComponent(DateTimeInputComponent),
-		"field.file-upload": eagerComponent(FileUploadComponent),
-		"field.hidden-input": eagerComponent(HiddenInputComponent),
-		"field.number-input": eagerComponent(NumberInputComponent),
-		"field.otp": eagerComponent(OtpInputComponent),
-		"field.password-input": eagerComponent(PasswordInputComponent),
-		"field.repeater": eagerComponent(RepeaterComponent),
-		"field.rich-editor": eagerComponent(RichEditorComponent),
-		"field.select": eagerComponent(SelectComponent),
-		"field.textarea": eagerComponent(TextareaComponent),
-		"field.text-input": eagerComponent(TextInputComponent),
-		"field.time-input": eagerComponent(TimeInputComponent),
-		"field.toggle": eagerComponent(ToggleComponent)
-	},
-	name: "lattice/form"
-});
-//#endregion
-export { formComponents };
-
-//# sourceMappingURL=index.js.map
+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

package/dist/form/lib/conditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.js","names":[],"sources":["../../../resources/js/form/lib/conditions.ts"],"sourcesContent":["import type { Condition, Op } from \"@lattice-php/lattice/types/generated\";\n\nexport type { Condition };\n\nexport type FieldConditions = {\n  visible?: Condition[];\n  required?: Condition[];\n  readOnly?: Condition[];\n  disabled?: Condition[];\n};\n\ntype FieldFlags = {\n  hidden?: boolean;\n  required?: boolean;\n  readOnly?: boolean;\n  disabled?: boolean;\n};\n\nexport type FieldState = {\n  hidden: boolean;\n  required: boolean;\n  readOnly: boolean;\n  disabled: boolean;\n};\n\nexport function conditionFields(conditions: FieldConditions | undefined | null): string[] {\n  const fields = new Set<string>();\n\n  for (const group of [\n    conditions?.visible,\n    conditions?.required,\n    conditions?.readOnly,\n    conditions?.disabled,\n  ]) {\n    for (const condition of group ?? []) {\n      fields.add(condition.field);\n    }\n  }\n\n  return Array.from(fields);\n}\n\nconst BOOLEAN_TRUE_VALUES = new Set([\"1\", \"true\", \"on\", \"yes\"]);\n\n// Mirrors PHP filter_var(FILTER_VALIDATE_BOOLEAN) so conditions evaluate\n// identically on the server and the client.\nexport function toBoolean(value: unknown): boolean {\n  if (typeof value === \"boolean\") {\n    return value;\n  }\n\n  if (typeof value === \"number\") {\n    return value === 1;\n  }\n\n  return BOOLEAN_TRUE_VALUES.has(String(value).toLowerCase());\n}\n\nfunction equals(actual: unknown, expected: unknown): boolean {\n  if (typeof expected === \"boolean\") {\n    return toBoolean(actual) === expected;\n  }\n  return String(actual ?? \"\") === String(expected ?? \"\");\n}\n\nfunction isIn(actual: unknown, expected: unknown): boolean {\n  const needles = (Array.isArray(expected) ? expected : [expected]).map((value) => String(value));\n  return needles.includes(String(actual ?? \"\"));\n}\n\nfunction isBlank(value: unknown): boolean {\n  return value == null || String(value).trim() === \"\";\n}\n\n// Null when either value can't be parsed, so before/after never matches a bad date. Mirrors PHP strtotime.\nfunction compareDates(actual: unknown, expected: unknown): number | null {\n  const left = Date.parse(String(actual));\n  const right = Date.parse(String(expected));\n\n  if (Number.isNaN(left) || Number.isNaN(right)) {\n    return null;\n  }\n\n  return left === right ? 0 : left < right ? -1 : 1;\n}\n\n// Unknown operators from untrusted payloads fail open (the condition matches).\n// The `never` parameter makes an Op value added without a case above a\n// compile error rather than a silent fall-through.\nfunction evaluateUnknownOperator(_operator: never): boolean {\n  return true;\n}\n\nfunction evaluateOp(operator: Op, actual: unknown, expected: unknown): boolean {\n  switch (operator) {\n    case \"eq\":\n      return equals(actual, expected);\n    case \"neq\":\n      return !equals(actual, expected);\n    case \"gt\":\n      return Number(actual) > Number(expected);\n    case \"lt\":\n      return Number(actual) < Number(expected);\n    case \"gte\":\n      return Number(actual) >= Number(expected);\n    case \"lte\":\n      return Number(actual) <= Number(expected);\n    case \"contains\":\n      return String(actual ?? \"\").includes(String(expected ?? \"\"));\n    case \"starts_with\":\n      return String(actual ?? \"\").startsWith(String(expected ?? \"\"));\n    case \"ends_with\":\n      return String(actual ?? \"\").endsWith(String(expected ?? \"\"));\n    case \"in\":\n      return isIn(actual, expected);\n    case \"not_in\":\n      return !isIn(actual, expected);\n    case \"before\":\n      return compareDates(actual, expected) === -1;\n    case \"after\":\n      return compareDates(actual, expected) === 1;\n    case \"empty\":\n      return isBlank(actual);\n    case \"filled\":\n      return !isBlank(actual);\n    default:\n      return evaluateUnknownOperator(operator);\n  }\n}\n\nfunction allMatch(conditions: Condition[], values: Record<string, unknown>): boolean {\n  return conditions.every((condition) =>\n    evaluateOp(condition.operator, values[condition.field], condition.value),\n  );\n}\n\nfunction anyMatch(conditions: Condition[] | undefined, values: Record<string, unknown>): boolean {\n  return Boolean(\n    conditions?.some((condition) =>\n      evaluateOp(condition.operator, values[condition.field], condition.value),\n    ),\n  );\n}\n\nexport function evaluateConditions(\n  conditions: FieldConditions | undefined,\n  values: Record<string, unknown>,\n  flags: FieldFlags,\n): FieldState {\n  const visible = !conditions?.visible?.length || allMatch(conditions.visible, values);\n\n  return {\n    hidden: Boolean(flags.hidden) || !visible,\n    required: Boolean(flags.required) || anyMatch(conditions?.required, values),\n    readOnly: Boolean(flags.readOnly) || anyMatch(conditions?.readOnly, values),\n    disabled: Boolean(flags.disabled) || anyMatch(conditions?.disabled, values),\n  };\n}\n"],"mappings":";AAyBA,SAAgB,gBAAgB,YAA0D;CACxF,MAAM,yBAAS,IAAI,IAAY;CAE/B,KAAK,MAAM,SAAS;EAClB,YAAY;EACZ,YAAY;EACZ,YAAY;EACZ,YAAY;CACd,GACE,KAAK,MAAM,aAAa,SAAS,CAAC,GAChC,OAAO,IAAI,UAAU,KAAK;CAI9B,OAAO,MAAM,KAAK,MAAM;AAC1B;AAEA,IAAM,sBAAsB,IAAI,IAAI;CAAC;CAAK;CAAQ;CAAM;AAAK,CAAC;AAI9D,SAAgB,UAAU,OAAyB;CACjD,IAAI,OAAO,UAAU,WACnB,OAAO;CAGT,IAAI,OAAO,UAAU,UACnB,OAAO,UAAU;CAGnB,OAAO,oBAAoB,IAAI,OAAO,KAAK,EAAE,YAAY,CAAC;AAC5D;AAEA,SAAS,OAAO,QAAiB,UAA4B;CAC3D,IAAI,OAAO,aAAa,WACtB,OAAO,UAAU,MAAM,MAAM;CAE/B,OAAO,OAAO,UAAU,EAAE,MAAM,OAAO,YAAY,EAAE;AACvD;AAEA,SAAS,KAAK,QAAiB,UAA4B;CAEzD,QADiB,MAAM,QAAQ,QAAQ,IAAI,WAAW,CAAC,QAAQ,GAAG,KAAK,UAAU,OAAO,KAAK,CACtF,EAAQ,SAAS,OAAO,UAAU,EAAE,CAAC;AAC9C;AAEA,SAAS,QAAQ,OAAyB;CACxC,OAAO,SAAS,QAAQ,OAAO,KAAK,EAAE,KAAK,MAAM;AACnD;AAGA,SAAS,aAAa,QAAiB,UAAkC;CACvE,MAAM,OAAO,KAAK,MAAM,OAAO,MAAM,CAAC;CACtC,MAAM,QAAQ,KAAK,MAAM,OAAO,QAAQ,CAAC;CAEzC,IAAI,OAAO,MAAM,IAAI,KAAK,OAAO,MAAM,KAAK,GAC1C,OAAO;CAGT,OAAO,SAAS,QAAQ,IAAI,OAAO,QAAQ,KAAK;AAClD;AAKA,SAAS,wBAAwB,WAA2B;CAC1D,OAAO;AACT;AAEA,SAAS,WAAW,UAAc,QAAiB,UAA4B;CAC7E,QAAQ,UAAR;EACE,KAAK,MACH,OAAO,OAAO,QAAQ,QAAQ;EAChC,KAAK,OACH,OAAO,CAAC,OAAO,QAAQ,QAAQ;EACjC,KAAK,MACH,OAAO,OAAO,MAAM,IAAI,OAAO,QAAQ;EACzC,KAAK,MACH,OAAO,OAAO,MAAM,IAAI,OAAO,QAAQ;EACzC,KAAK,OACH,OAAO,OAAO,MAAM,KAAK,OAAO,QAAQ;EAC1C,KAAK,OACH,OAAO,OAAO,MAAM,KAAK,OAAO,QAAQ;EAC1C,KAAK,YACH,OAAO,OAAO,UAAU,EAAE,EAAE,SAAS,OAAO,YAAY,EAAE,CAAC;EAC7D,KAAK,eACH,OAAO,OAAO,UAAU,EAAE,EAAE,WAAW,OAAO,YAAY,EAAE,CAAC;EAC/D,KAAK,aACH,OAAO,OAAO,UAAU,EAAE,EAAE,SAAS,OAAO,YAAY,EAAE,CAAC;EAC7D,KAAK,MACH,OAAO,KAAK,QAAQ,QAAQ;EAC9B,KAAK,UACH,OAAO,CAAC,KAAK,QAAQ,QAAQ;EAC/B,KAAK,UACH,OAAO,aAAa,QAAQ,QAAQ,MAAM;EAC5C,KAAK,SACH,OAAO,aAAa,QAAQ,QAAQ,MAAM;EAC5C,KAAK,SACH,OAAO,QAAQ,MAAM;EACvB,KAAK,UACH,OAAO,CAAC,QAAQ,MAAM;EACxB,SACE,OAAO,wBAAwB,QAAQ;CAC3C;AACF;AAEA,SAAS,SAAS,YAAyB,QAA0C;CACnF,OAAO,WAAW,OAAO,cACvB,WAAW,UAAU,UAAU,OAAO,UAAU,QAAQ,UAAU,KAAK,CACzE;AACF;AAEA,SAAS,SAAS,YAAqC,QAA0C;CAC/F,OAAO,QACL,YAAY,MAAM,cAChB,WAAW,UAAU,UAAU,OAAO,UAAU,QAAQ,UAAU,KAAK,CACzE,CACF;AACF;AAEA,SAAgB,mBACd,YACA,QACA,OACY;CACZ,MAAM,UAAU,CAAC,YAAY,SAAS,UAAU,SAAS,WAAW,SAAS,MAAM;CAEnF,OAAO;EACL,QAAQ,QAAQ,MAAM,MAAM,KAAK,CAAC;EAClC,UAAU,QAAQ,MAAM,QAAQ,KAAK,SAAS,YAAY,UAAU,MAAM;EAC1E,UAAU,QAAQ,MAAM,QAAQ,KAAK,SAAS,YAAY,UAAU,MAAM;EAC1E,UAAU,QAAQ,MAAM,QAAQ,KAAK,SAAS,YAAY,UAAU,MAAM;CAC5E;AACF"}

package/dist/form/lib/field-dom-name.d.ts

@@ -0,0 +1 @@
+export declare function fieldDomName(name: string, prefix?: string): string;

package/dist/form/lib/field-dom-name.js

@@ -0,0 +1,10 @@
+//#region resources/js/form/lib/field-dom-name.ts
+function fieldDomName(name, prefix) {
+	if (!prefix) return name;
+	const suffix = name.replace(/[^A-Za-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "");
+	return suffix ? `${prefix}-${suffix}` : prefix;
+}
+//#endregion
+export { fieldDomName };
+
+//# sourceMappingURL=field-dom-name.js.map

package/dist/form/lib/field-dom-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-dom-name.js","names":[],"sources":["../../../resources/js/form/lib/field-dom-name.ts"],"sourcesContent":["export function fieldDomName(name: string, prefix?: string): string {\n  if (!prefix) {\n    return name;\n  }\n\n  const suffix = name.replace(/[^A-Za-z0-9_-]+/g, \"-\").replace(/^-+|-+$/g, \"\");\n\n  return suffix ? `${prefix}-${suffix}` : prefix;\n}\n"],"mappings":";AAAA,SAAgB,aAAa,MAAc,QAAyB;CAClE,IAAI,CAAC,QACH,OAAO;CAGT,MAAM,SAAS,KAAK,QAAQ,oBAAoB,GAAG,EAAE,QAAQ,YAAY,EAAE;CAE3E,OAAO,SAAS,GAAG,OAAO,GAAG,WAAW;AAC1C"}

package/dist/form/{components → lib}/field-props.d.ts

@@ -1,5 +1,5 @@
-import { Node } from '../../core/types';
-import { FieldConditions } from './conditions';
+import { Node } from '../../core/types.js';
+import { FieldConditions } from './conditions.js';
 /**
  * The props every form-field node shares (the PHP Field base). Nodes flow through
  * the form framework loosely typed via the generic schema, so this is the typed
@@ -12,7 +12,6 @@ type FieldProps = {
     dependsOnKeys?: string[] | null;
     disabled?: boolean | null;
     helperText?: string | null;
-    hidden?: boolean | null;
     label?: string | null;
     name?: string;
     editablePrefill?: boolean | null;

package/dist/form/{components → lib}/field-props.js

@@ -1,4 +1,4 @@
-//#region resources/js/form/components/field-props.ts
+//#region resources/js/form/lib/field-props.ts
 function fieldProps(node) {
 	return node.props;
 }

package/dist/form/lib/field-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-props.js","names":[],"sources":["../../../resources/js/form/lib/field-props.ts"],"sourcesContent":["import type { Node } from \"@lattice-php/lattice/core/types\";\nimport type { FieldConditions } from \"./conditions\";\n\n/**\n * The props every form-field node shares (the PHP Field base). Nodes flow through\n * the form framework loosely typed via the generic schema, so this is the typed\n * lens the shared hooks read them through. Everything is optional because the\n * lens is also applied to non-field nodes while walking the schema.\n */\ntype FieldProps = {\n  conditions?: FieldConditions | null;\n  dependsOnAny?: boolean | null;\n  dependsOnKeys?: string[] | null;\n  disabled?: boolean | null;\n  helperText?: string | null;\n  label?: string | null;\n  name?: string;\n  editablePrefill?: boolean | null;\n  prefillRefreshOn?: string[] | null;\n  prefillResetOn?: string[] | null;\n  readOnly?: boolean | null;\n  required?: boolean | null;\n  tooltip?: string | null;\n  value?: unknown;\n};\n\nexport function fieldProps(node: Node): FieldProps {\n  return node.props as FieldProps;\n}\n\nexport function walkFields(\n  nodes: Node[] | undefined,\n  visit: (props: FieldProps, node: Node) => void,\n): void {\n  for (const child of nodes ?? []) {\n    visit(fieldProps(child), child);\n    walkFields(child.schema, visit);\n  }\n}\n"],"mappings":";AA0BA,SAAgB,WAAW,MAAwB;CACjD,OAAO,KAAK;AACd;AAEA,SAAgB,WACd,OACA,OACM;CACN,KAAK,MAAM,SAAS,SAAS,CAAC,GAAG;EAC/B,MAAM,WAAW,KAAK,GAAG,KAAK;EAC9B,WAAW,MAAM,QAAQ,KAAK;CAChC;AACF"}

package/dist/form/{components → lib}/form-path.js

@@ -1,4 +1,4 @@
-//#region resources/js/form/components/form-path.ts
+//#region resources/js/form/lib/form-path.ts
 function pathParts(path) {
 	return path.split(".").filter((part) => part !== "");
 }

package/dist/form/lib/form-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-path.js","names":[],"sources":["../../../resources/js/form/lib/form-path.ts"],"sourcesContent":["function pathParts(path: string): string[] {\n  return path.split(\".\").filter((part) => part !== \"\");\n}\n\nexport function appendPath(\n  base: string | null | undefined,\n  ...parts: Array<string | number>\n): string {\n  const suffix = parts.map(String).filter((part) => part !== \"\");\n\n  return [base ?? \"\", ...suffix].filter((part) => part !== \"\").join(\".\");\n}\n\nexport function toHtmlName(path: string): string {\n  const [head, ...tail] = pathParts(path);\n\n  return tail.reduce((name, part) => `${name}[${part}]`, head ?? \"\");\n}\n\nexport function getPath(values: Record<string, unknown>, path: string): unknown {\n  let current: unknown = values;\n\n  for (const part of pathParts(path)) {\n    if (current == null) {\n      return undefined;\n    }\n\n    current = (current as Record<string, unknown>)[part];\n  }\n\n  return current;\n}\n\nfunction emptyContainer(nextPart: string | undefined): Record<string, unknown> | unknown[] {\n  return nextPart !== undefined && /^\\d+$/.test(nextPart) ? [] : {};\n}\n\nexport function setPath(\n  values: Record<string, unknown>,\n  path: string,\n  value: unknown,\n): Record<string, unknown> {\n  const parts = pathParts(path);\n\n  if (parts.length === 0) {\n    return values;\n  }\n\n  const write = (current: unknown, index: number): unknown => {\n    const part = parts[index];\n    const last = index === parts.length - 1;\n    const source =\n      current && typeof current === \"object\" ? current : emptyContainer(parts[index + 1]);\n    const next = Array.isArray(source) ? [...source] : { ...(source as Record<string, unknown>) };\n\n    (next as Record<string, unknown>)[part] = last\n      ? value\n      : write((source as Record<string, unknown>)[part], index + 1);\n\n    return next;\n  };\n\n  return write(values, 0) as Record<string, unknown>;\n}\n"],"mappings":";AAAA,SAAS,UAAU,MAAwB;CACzC,OAAO,KAAK,MAAM,GAAG,EAAE,QAAQ,SAAS,SAAS,EAAE;AACrD;AAEA,SAAgB,WACd,MACA,GAAG,OACK;CACR,MAAM,SAAS,MAAM,IAAI,MAAM,EAAE,QAAQ,SAAS,SAAS,EAAE;CAE7D,OAAO,CAAC,QAAQ,IAAI,GAAG,MAAM,EAAE,QAAQ,SAAS,SAAS,EAAE,EAAE,KAAK,GAAG;AACvE;AAEA,SAAgB,WAAW,MAAsB;CAC/C,MAAM,CAAC,MAAM,GAAG,QAAQ,UAAU,IAAI;CAEtC,OAAO,KAAK,QAAQ,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,IAAI,QAAQ,EAAE;AACnE;AAEA,SAAgB,QAAQ,QAAiC,MAAuB;CAC9E,IAAI,UAAmB;CAEvB,KAAK,MAAM,QAAQ,UAAU,IAAI,GAAG;EAClC,IAAI,WAAW,MACb;EAGF,UAAW,QAAoC;CACjD;CAEA,OAAO;AACT;AAEA,SAAS,eAAe,UAAmE;CACzF,OAAO,aAAa,KAAA,KAAa,QAAQ,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC;AAClE;AAEA,SAAgB,QACd,QACA,MACA,OACyB;CACzB,MAAM,QAAQ,UAAU,IAAI;CAE5B,IAAI,MAAM,WAAW,GACnB,OAAO;CAGT,MAAM,SAAS,SAAkB,UAA2B;EAC1D,MAAM,OAAO,MAAM;EACnB,MAAM,OAAO,UAAU,MAAM,SAAS;EACtC,MAAM,SACJ,WAAW,OAAO,YAAY,WAAW,UAAU,eAAe,MAAM,QAAQ,EAAE;EACpF,MAAM,OAAO,MAAM,QAAQ,MAAM,IAAI,CAAC,GAAG,MAAM,IAAI,EAAE,GAAI,OAAmC;EAE5F,KAAkC,QAAQ,OACtC,QACA,MAAO,OAAmC,OAAO,QAAQ,CAAC;EAE9D,OAAO;CACT;CAEA,OAAO,MAAM,QAAQ,CAAC;AACxB"}

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

@@ -1,7 +1,7 @@
 /**
  * Shared client transport for the lattice form endpoint: every form sub-action
  * (validation resolve, option search) POSTs to the same signed URL, so the
- * request shape — notably stripping client-only row ids — lives here once.
+ * request shape lives here once.
  */
 export declare const FORM_DEBOUNCE_MS = 250;
 export declare function postFormAction<T>(action: string, componentRef: string, body: Record<string, unknown>, signal: AbortSignal): Promise<T | null>;