@slowclap/rezi-core 0.1.0-fork.1

package/dist/forms/bind.js

@@ -0,0 +1,96 @@
+/**
+ * packages/core/src/forms/bind.ts — Simple binding helpers.
+ */
+function parseFieldPath(field) {
+    const segments = field.split(".").filter((segment) => segment.length > 0);
+    return Object.freeze(segments);
+}
+function getFieldValue(state, field) {
+    if (typeof field !== "string") {
+        return state[field];
+    }
+    const path = parseFieldPath(field);
+    if (path.length === 0) {
+        return undefined;
+    }
+    let current = state;
+    for (const segment of path) {
+        if (current === null || typeof current !== "object") {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+}
+function setField(prev, field, value) {
+    if (typeof field !== "string") {
+        return { ...prev, [field]: value };
+    }
+    const path = parseFieldPath(field);
+    if (path.length === 0) {
+        return prev;
+    }
+    const root = { ...prev };
+    let target = root;
+    let source = prev;
+    for (let i = 0; i < path.length - 1; i++) {
+        const segment = path[i];
+        if (segment === undefined)
+            continue;
+        const sourceChild = source !== null && typeof source === "object"
+            ? source[segment]
+            : undefined;
+        const nextTarget = sourceChild !== null && typeof sourceChild === "object" && !Array.isArray(sourceChild)
+            ? { ...sourceChild }
+            : {};
+        target[segment] = nextTarget;
+        target = nextTarget;
+        source = sourceChild;
+    }
+    const leaf = path[path.length - 1];
+    if (leaf !== undefined) {
+        target[leaf] = value;
+    }
+    return root;
+}
+function toInputValue(value) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    return String(value);
+}
+export function bind(state, field, update) {
+    return {
+        value: toInputValue(getFieldValue(state, field)),
+        onInput: (value) => {
+            update((prev) => setField(prev, field, value));
+        },
+    };
+}
+export function bindTransform(state, field, update, transform) {
+    const currentValue = getFieldValue(state, field);
+    return {
+        value: transform.get(currentValue),
+        onInput: (value) => {
+            const next = transform.set(value);
+            update((prev) => setField(prev, field, next));
+        },
+    };
+}
+export function bindChecked(state, field, update) {
+    return {
+        checked: Boolean(getFieldValue(state, field)),
+        onChange: (checked) => {
+            update((prev) => setField(prev, field, checked));
+        },
+    };
+}
+export function bindSelect(state, field, update) {
+    return {
+        value: toInputValue(getFieldValue(state, field)),
+        onChange: (value) => {
+            update((prev) => setField(prev, field, value));
+        },
+    };
+}
+//# sourceMappingURL=bind.js.map

package/dist/forms/bind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.js","sourceRoot":"","sources":["../../src/forms/bind.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,SAAS,cAAc,CAAC,KAAa;IACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1E,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,aAAa,CACpB,KAAQ,EACR,KAAuB;IAEvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,GAAY,KAAK,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YACpD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAI,OAAmC,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CACf,IAAiB,EACjB,KAAuB,EACvB,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,GAAI,IAAU,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAO,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,EAAE,GAAI,IAAgC,EAAE,CAAC;IACtD,IAAI,MAAM,GAA4B,IAAI,CAAC;IAC3C,IAAI,MAAM,GAAY,IAAI,CAAC;IAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,OAAO,KAAK,SAAS;YAAE,SAAS;QAEpC,MAAM,WAAW,GACf,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;YAC3C,CAAC,CAAE,MAAkC,CAAC,OAAO,CAAC;YAC9C,CAAC,CAAC,SAAS,CAAC;QAEhB,MAAM,UAAU,GACd,WAAW,KAAK,IAAI,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YACpF,CAAC,CAAC,EAAE,GAAI,WAAuC,EAAE;YACjD,CAAC,CAAC,EAAE,CAAC;QAET,MAAM,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC;QAC7B,MAAM,GAAG,UAAU,CAAC;QACpB,MAAM,GAAG,WAAW,CAAC;IACvB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,OAAO,IAAS,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,IAAI,CAClB,KAAQ,EACR,KAAiB,EACjB,MAAkB;IAElB,OAAO;QACL,KAAK,EAAE,YAAY,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,EAAE,CAAC,KAAa,EAAE,EAAE;YACzB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,KAAQ,EACR,KAAiB,EACjB,MAAkB,EAClB,SAGC;IAED,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACjD,OAAO;QACL,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC;QAClC,OAAO,EAAE,CAAC,KAAa,EAAE,EAAE;YACzB,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAClC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAAQ,EACR,KAAiB,EACjB,MAAkB;IAElB,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7C,QAAQ,EAAE,CAAC,OAAgB,EAAE,EAAE;YAC7B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QACnD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,KAAQ,EACR,KAAiB,EACjB,MAAkB;IAElB,OAAO;QACL,KAAK,EAAE,YAAY,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAChD,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;YAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/forms/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * packages/core/src/forms/index.ts — Form system exports.
+ *
+ * @see docs/recipes/form-validation.md (GitHub issue #119)
+ */
+export type { ArrayFieldItem, ArrayFieldName, FieldBooleanValue, FieldErrorValue, FormState, FormWizardOptions, FormWizardStep, UseFormBindOptions, UseFormFieldOptions, UseFormInputBinding, UseFormTextFieldName, UseFieldArrayReturn, UseFormOptions, UseFormReturn, ValidationContext, ValidationResult, } from "./types.js";
+export { useForm } from "./useForm.js";
+export { createDebouncedAsyncValidator, DEFAULT_ASYNC_DEBOUNCE_MS, isValidationClean, mergeValidationErrors, runAsyncValidation, runFieldValidation, runSyncValidation, } from "./validation.js";
+export { bind, bindChecked, bindSelect, bindTransform } from "./bind.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/forms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/forms/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/forms/index.js

@@ -0,0 +1,9 @@
+/**
+ * packages/core/src/forms/index.ts — Form system exports.
+ *
+ * @see docs/recipes/form-validation.md (GitHub issue #119)
+ */
+export { useForm } from "./useForm.js";
+export { createDebouncedAsyncValidator, DEFAULT_ASYNC_DEBOUNCE_MS, isValidationClean, mergeValidationErrors, runAsyncValidation, runFieldValidation, runSyncValidation, } from "./validation.js";
+export { bind, bindChecked, bindSelect, bindTransform } from "./bind.js";
+//# sourceMappingURL=index.js.map

package/dist/forms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/forms/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/forms/internal/arrayState.d.ts

@@ -0,0 +1,35 @@
+import type { ArrayFieldItem, ArrayFieldName, FormState, UseFieldArrayReturn, ValidationResult } from "../types.js";
+type UpdateFormState<T extends Record<string, unknown>> = (nextState: FormState<T> | ((prev: FormState<T>) => FormState<T>)) => void;
+type AsyncValidatorRef<T extends Record<string, unknown>> = {
+    current: Readonly<{
+        run: (values: T) => void;
+        cancel: () => void;
+    }> | undefined;
+};
+type FieldArrayKeysRef<T extends Record<string, unknown>> = {
+    current: Partial<Record<keyof T, string[]>>;
+};
+type CounterRef = {
+    current: number;
+};
+export declare function getArrayFieldValues<T extends Record<string, unknown>, K extends ArrayFieldName<T>>(values: T, field: K): Array<ArrayFieldItem<T, K>>;
+export declare function createFieldArrayApi<T extends Record<string, unknown>>(options: {
+    state: FormState<T>;
+    validateOnChange: boolean | undefined;
+    initialValuesRef: {
+        current: T;
+    };
+    fieldArrayKeysRef: FieldArrayKeysRef<T>;
+    fieldArrayKeyCounterRef: CounterRef;
+    pendingAsyncValuesRef: {
+        current: T | null;
+    };
+    asyncValidatorRef: AsyncValidatorRef<T>;
+    updateFormState: UpdateFormState<T>;
+    isFieldEditableInternal: (field: keyof T, source?: Pick<FormState<T>, "disabled" | "fieldDisabled" | "readOnly" | "fieldReadOnly">) => boolean;
+    runSyncValidationFiltered: (values: T, source?: Pick<FormState<T>, "disabled" | "fieldDisabled">) => ValidationResult<T>;
+}): Readonly<{
+    useFieldArray: <K extends ArrayFieldName<T>>(field: K) => UseFieldArrayReturn<T, K>;
+}>;
+export {};
+//# sourceMappingURL=arrayState.d.ts.map

package/dist/forms/internal/arrayState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayState.d.ts","sourceRoot":"","sources":["../../../src/forms/internal/arrayState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EAEd,SAAS,EACT,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAGrB,KAAK,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CACxD,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAC7D,IAAI,CAAC;AAEV,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IAC1D,OAAO,EACH,QAAQ,CAAC;QACP,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;QACzB,MAAM,EAAE,MAAM,IAAI,CAAC;KACpB,CAAC,GACF,SAAS,CAAC;CACf,CAAC;AAEF,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IAC1D,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;CAC7C,CAAC;AAEF,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,cAAc,CAAC,CAAC,CAAC,EAChG,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,CAAC,GACP,KAAK,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAM7B;AA+FD,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE;IAC9E,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACpB,gBAAgB,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,gBAAgB,EAAE;QAAE,OAAO,EAAE,CAAC,CAAA;KAAE,CAAC;IACjC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACxC,uBAAuB,EAAE,UAAU,CAAC;IACpC,qBAAqB,EAAE;QAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IAC7C,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACxC,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACpC,uBAAuB,EAAE,CACvB,KAAK,EAAE,MAAM,CAAC,EACd,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,GAAG,eAAe,GAAG,UAAU,GAAG,eAAe,CAAC,KACrF,OAAO,CAAC;IACb,yBAAyB,EAAE,CACzB,MAAM,EAAE,CAAC,EACT,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,GAAG,eAAe,CAAC,KACtD,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC1B,GAAG,QAAQ,CAAC;IACX,aAAa,EAAE,CAAC,CAAC,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACrF,CAAC,CAmOD"}

package/dist/forms/internal/arrayState.js

@@ -0,0 +1,238 @@
+import { computeFieldDirty, normalizeBooleanArray, normalizeErrorArray } from "./state.js";
+export function getArrayFieldValues(values, field) {
+    const raw = values[field];
+    if (!Array.isArray(raw)) {
+        return [];
+    }
+    return [...raw];
+}
+function removeAtIndex(value, index) {
+    const next = [...value];
+    next.splice(index, 1);
+    return next;
+}
+function moveIndex(value, from, to) {
+    const next = [...value];
+    const [moved] = next.splice(from, 1);
+    if (moved === undefined) {
+        return next;
+    }
+    next.splice(to, 0, moved);
+    return next;
+}
+function nextFieldArrayKey(field, counterRef) {
+    const next = counterRef.current;
+    counterRef.current += 1;
+    return `${field}_${next}`;
+}
+function ensureFieldArrayKeys(field, length, fieldArrayKeysRef, fieldArrayKeyCounterRef) {
+    const existing = [...(fieldArrayKeysRef.current[field] ?? [])];
+    if (existing.length > length) {
+        existing.length = length;
+    }
+    while (existing.length < length) {
+        existing.push(nextFieldArrayKey(String(field), fieldArrayKeyCounterRef));
+    }
+    fieldArrayKeysRef.current[field] = existing;
+    return existing;
+}
+function appendFieldArrayKey(field, fieldArrayKeysRef, fieldArrayKeyCounterRef) {
+    const existing = [...(fieldArrayKeysRef.current[field] ?? [])];
+    existing.push(nextFieldArrayKey(String(field), fieldArrayKeyCounterRef));
+    fieldArrayKeysRef.current[field] = existing;
+}
+function removeFieldArrayKey(field, index, fieldArrayKeysRef) {
+    const existing = [...(fieldArrayKeysRef.current[field] ?? [])];
+    if (index < 0 || index >= existing.length) {
+        return;
+    }
+    existing.splice(index, 1);
+    fieldArrayKeysRef.current[field] = existing;
+}
+function moveFieldArrayKey(field, from, to, fieldArrayKeysRef) {
+    const existing = [...(fieldArrayKeysRef.current[field] ?? [])];
+    if (from < 0 || to < 0 || from >= existing.length || to >= existing.length || from === to) {
+        return;
+    }
+    const [moved] = existing.splice(from, 1);
+    if (moved === undefined) {
+        return;
+    }
+    existing.splice(to, 0, moved);
+    fieldArrayKeysRef.current[field] = existing;
+}
+function remapFieldArrayErrors(fieldError, size, map) {
+    if (typeof fieldError === "string") {
+        return fieldError;
+    }
+    return map(normalizeErrorArray(fieldError, size));
+}
+export function createFieldArrayApi(options) {
+    const useFieldArray = (field) => {
+        const fieldKey = field;
+        const values = getArrayFieldValues(options.state.values, field);
+        const keys = ensureFieldArrayKeys(fieldKey, values.length, options.fieldArrayKeysRef, options.fieldArrayKeyCounterRef);
+        const append = (item) => {
+            options.pendingAsyncValuesRef.current = null;
+            options.updateFormState((prev) => {
+                if (prev.isSubmitting || !options.isFieldEditableInternal(fieldKey, prev)) {
+                    return prev;
+                }
+                const currentValues = getArrayFieldValues(prev.values, field);
+                const nextValuesArray = [...currentValues, item];
+                const nextValues = {
+                    ...prev.values,
+                    [field]: nextValuesArray,
+                };
+                options.pendingAsyncValuesRef.current = nextValues;
+                const nextTouched = [
+                    ...normalizeBooleanArray(prev.touched[fieldKey], currentValues.length, false),
+                    false,
+                ];
+                const nextDirty = computeFieldDirty(fieldKey, nextValuesArray, options.initialValuesRef.current);
+                let nextErrors = prev.errors;
+                if (options.validateOnChange) {
+                    nextErrors = options.runSyncValidationFiltered(nextValues, prev);
+                }
+                else {
+                    nextErrors = {
+                        ...prev.errors,
+                        [fieldKey]: remapFieldArrayErrors(prev.errors[fieldKey], currentValues.length, (errs) => [...errs, undefined]),
+                    };
+                }
+                appendFieldArrayKey(fieldKey, options.fieldArrayKeysRef, options.fieldArrayKeyCounterRef);
+                return {
+                    ...prev,
+                    values: nextValues,
+                    errors: nextErrors,
+                    submitError: undefined,
+                    touched: {
+                        ...prev.touched,
+                        [fieldKey]: nextTouched,
+                    },
+                    dirty: {
+                        ...prev.dirty,
+                        [fieldKey]: nextDirty,
+                    },
+                };
+            });
+            const asyncValues = options.pendingAsyncValuesRef.current;
+            options.pendingAsyncValuesRef.current = null;
+            if (options.validateOnChange && options.asyncValidatorRef.current && asyncValues) {
+                options.asyncValidatorRef.current.run(asyncValues);
+            }
+        };
+        const remove = (index) => {
+            options.pendingAsyncValuesRef.current = null;
+            options.updateFormState((prev) => {
+                if (prev.isSubmitting || !options.isFieldEditableInternal(fieldKey, prev)) {
+                    return prev;
+                }
+                const currentValues = getArrayFieldValues(prev.values, field);
+                if (index < 0 || index >= currentValues.length) {
+                    return prev;
+                }
+                const nextValuesArray = removeAtIndex(currentValues, index);
+                const nextValues = {
+                    ...prev.values,
+                    [field]: nextValuesArray,
+                };
+                options.pendingAsyncValuesRef.current = nextValues;
+                const nextTouched = removeAtIndex(normalizeBooleanArray(prev.touched[fieldKey], currentValues.length, false), index);
+                const nextDirty = computeFieldDirty(fieldKey, nextValuesArray, options.initialValuesRef.current);
+                let nextErrors = prev.errors;
+                if (options.validateOnChange) {
+                    nextErrors = options.runSyncValidationFiltered(nextValues, prev);
+                }
+                else {
+                    nextErrors = {
+                        ...prev.errors,
+                        [fieldKey]: remapFieldArrayErrors(prev.errors[fieldKey], currentValues.length, (errs) => removeAtIndex(errs, index)),
+                    };
+                }
+                removeFieldArrayKey(fieldKey, index, options.fieldArrayKeysRef);
+                return {
+                    ...prev,
+                    values: nextValues,
+                    errors: nextErrors,
+                    submitError: undefined,
+                    touched: {
+                        ...prev.touched,
+                        [fieldKey]: nextTouched,
+                    },
+                    dirty: {
+                        ...prev.dirty,
+                        [fieldKey]: nextDirty,
+                    },
+                };
+            });
+            const asyncValues = options.pendingAsyncValuesRef.current;
+            options.pendingAsyncValuesRef.current = null;
+            if (options.validateOnChange && options.asyncValidatorRef.current && asyncValues) {
+                options.asyncValidatorRef.current.run(asyncValues);
+            }
+        };
+        const move = (from, to) => {
+            options.pendingAsyncValuesRef.current = null;
+            options.updateFormState((prev) => {
+                if (prev.isSubmitting || !options.isFieldEditableInternal(fieldKey, prev)) {
+                    return prev;
+                }
+                const currentValues = getArrayFieldValues(prev.values, field);
+                if (from < 0 ||
+                    to < 0 ||
+                    from >= currentValues.length ||
+                    to >= currentValues.length ||
+                    from === to) {
+                    return prev;
+                }
+                const nextValuesArray = moveIndex(currentValues, from, to);
+                const nextValues = {
+                    ...prev.values,
+                    [field]: nextValuesArray,
+                };
+                options.pendingAsyncValuesRef.current = nextValues;
+                const nextTouched = moveIndex(normalizeBooleanArray(prev.touched[fieldKey], currentValues.length, false), from, to);
+                const nextDirty = computeFieldDirty(fieldKey, nextValuesArray, options.initialValuesRef.current);
+                let nextErrors = {
+                    ...prev.errors,
+                    [fieldKey]: remapFieldArrayErrors(prev.errors[fieldKey], currentValues.length, (errs) => moveIndex(errs, from, to)),
+                };
+                if (options.validateOnChange) {
+                    nextErrors = options.runSyncValidationFiltered(nextValues, prev);
+                }
+                moveFieldArrayKey(fieldKey, from, to, options.fieldArrayKeysRef);
+                return {
+                    ...prev,
+                    values: nextValues,
+                    errors: nextErrors,
+                    submitError: undefined,
+                    touched: {
+                        ...prev.touched,
+                        [fieldKey]: nextTouched,
+                    },
+                    dirty: {
+                        ...prev.dirty,
+                        [fieldKey]: nextDirty,
+                    },
+                };
+            });
+            const asyncValues = options.pendingAsyncValuesRef.current;
+            options.pendingAsyncValuesRef.current = null;
+            if (options.validateOnChange && options.asyncValidatorRef.current && asyncValues) {
+                options.asyncValidatorRef.current.run(asyncValues);
+            }
+        };
+        return Object.freeze({
+            values,
+            keys,
+            append,
+            remove,
+            move,
+        });
+    };
+    return Object.freeze({
+        useFieldArray,
+    });
+}
+//# sourceMappingURL=arrayState.js.map

package/dist/forms/internal/arrayState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayState.js","sourceRoot":"","sources":["../../../src/forms/internal/arrayState.ts"],"names":[],"mappings":"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"}

package/dist/forms/internal/bindings.d.ts

@@ -0,0 +1,46 @@
+import type { WidgetContext } from "../../widgets/composition.js";
+import { ui } from "../../widgets/ui.js";
+import type { FieldErrorValue, FormState, UseFormBindOptions, UseFormFieldOptions, UseFormInputBinding, UseFormOptions, UseFormTextFieldName, ValidationResult } from "../types.js";
+type UpdateFormState<T extends Record<string, unknown>> = (nextState: FormState<T> | ((prev: FormState<T>) => FormState<T>)) => void;
+type AsyncValidatorRef<T extends Record<string, unknown>> = {
+    current: Readonly<{
+        run: (values: T) => void;
+        cancel: () => void;
+    }> | undefined;
+};
+export declare function createFieldBindings<T extends Record<string, unknown>, State>(options: {
+    ctx: Pick<WidgetContext<State>, "id">;
+    state: FormState<T>;
+    stateRef: {
+        current: FormState<T>;
+    };
+    initialValuesRef: {
+        current: T;
+    };
+    pendingAsyncValuesRef: {
+        current: T | null;
+    };
+    asyncValidatorRef: AsyncValidatorRef<T>;
+    validate: UseFormOptions<T>["validate"];
+    validateOnBlur: boolean | undefined;
+    validateOnChange: boolean | undefined;
+    updateFormState: UpdateFormState<T>;
+    isFieldDisabledInternal: (field: keyof T, source?: Pick<FormState<T>, "disabled" | "fieldDisabled">) => boolean;
+    isFieldReadOnlyInternal: (field: keyof T, source?: Pick<FormState<T>, "readOnly" | "fieldReadOnly">) => boolean;
+    isFieldEditableInternal: (field: keyof T, source?: Pick<FormState<T>, "disabled" | "fieldDisabled" | "readOnly" | "fieldReadOnly">) => boolean;
+    runSyncValidationFiltered: (values: T, source?: Pick<FormState<T>, "disabled" | "fieldDisabled">) => ValidationResult<T>;
+    canBindFieldAsText: (field: keyof T, values: T) => boolean;
+    warnUnsupportedTextBinding: (field: keyof T) => void;
+}): Readonly<{
+    validateForm: () => ValidationResult<T>;
+    validateField: <K extends keyof T>(field: K) => ValidationResult<T>[K] | undefined;
+    setFieldValue: <K extends keyof T>(field: K, value: T[K]) => void;
+    setFieldError: <K extends keyof T>(field: K, error: FieldErrorValue | undefined) => void;
+    setFieldTouched: <K extends keyof T>(field: K, touched: boolean) => void;
+    handleChange: <K extends keyof T>(field: K) => (value: T[K]) => void;
+    handleBlur: <K extends keyof T>(field: K) => () => void;
+    bind: <K extends UseFormTextFieldName<T>>(field: K, bindOptions?: UseFormBindOptions) => UseFormInputBinding;
+    field: <K extends UseFormTextFieldName<T>>(fieldName: K, fieldOptions?: UseFormFieldOptions) => ReturnType<typeof ui.field>;
+}>;
+export {};
+//# sourceMappingURL=bindings.d.ts.map

package/dist/forms/internal/bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../../src/forms/internal/bindings.ts"],"names":[],"mappings":"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"}

package/dist/forms/internal/bindings.js

@@ -0,0 +1,161 @@
+import { ui } from "../../widgets/ui.js";
+import { runFieldValidation } from "../validation.js";
+import { computeFieldDirty, hasTruthyBooleanValue, toFieldErrorString, toInputValue, } from "./state.js";
+export function createFieldBindings(options) {
+    const validateForm = () => {
+        const snapshot = options.stateRef.current;
+        const errors = options.runSyncValidationFiltered(snapshot.values, snapshot);
+        options.updateFormState((prev) => ({
+            ...prev,
+            errors,
+        }));
+        return errors;
+    };
+    const validateField = (field) => {
+        const snapshot = options.stateRef.current;
+        if (options.isFieldDisabledInternal(field, snapshot)) {
+            options.updateFormState((prev) => ({
+                ...prev,
+                errors: {
+                    ...prev.errors,
+                    [field]: undefined,
+                },
+            }));
+            return undefined;
+        }
+        const error = runFieldValidation(snapshot.values, field, options.validate);
+        options.updateFormState((prev) => ({
+            ...prev,
+            errors: {
+                ...prev.errors,
+                [field]: error,
+            },
+        }));
+        return error;
+    };
+    const setFieldValue = (field, value) => {
+        options.pendingAsyncValuesRef.current = null;
+        const newDirty = computeFieldDirty(field, value, options.initialValuesRef.current);
+        options.updateFormState((prev) => {
+            if (prev.isSubmitting || !options.isFieldEditableInternal(field, prev)) {
+                return prev;
+            }
+            const newValues = { ...prev.values, [field]: value };
+            options.pendingAsyncValuesRef.current = newValues;
+            let newErrors = prev.errors;
+            if (options.validateOnChange) {
+                newErrors = options.runSyncValidationFiltered(newValues, prev);
+            }
+            return {
+                ...prev,
+                values: newValues,
+                errors: newErrors,
+                submitError: undefined,
+                dirty: {
+                    ...prev.dirty,
+                    [field]: newDirty,
+                },
+            };
+        });
+        const asyncValues = options.pendingAsyncValuesRef.current;
+        options.pendingAsyncValuesRef.current = null;
+        if (options.validateOnChange && options.asyncValidatorRef.current && asyncValues) {
+            options.asyncValidatorRef.current.run(asyncValues);
+        }
+    };
+    const setFieldError = (field, error) => {
+        options.updateFormState((prev) => ({
+            ...prev,
+            errors: {
+                ...prev.errors,
+                [field]: error,
+            },
+        }));
+    };
+    const setFieldTouched = (field, touched) => {
+        options.updateFormState((prev) => ({
+            ...prev,
+            touched: {
+                ...prev.touched,
+                [field]: touched,
+            },
+        }));
+    };
+    const handleChange = (field) => (value) => {
+        setFieldValue(field, value);
+    };
+    const handleBlur = (field) => () => {
+        const snapshot = options.stateRef.current;
+        if (options.isFieldDisabledInternal(field, snapshot)) {
+            return;
+        }
+        const shouldValidateOnBlur = options.validateOnBlur ?? true;
+        if (!shouldValidateOnBlur) {
+            setFieldTouched(field, true);
+            return;
+        }
+        const errors = options.runSyncValidationFiltered(snapshot.values, snapshot);
+        options.updateFormState((prev) => ({
+            ...prev,
+            touched: {
+                ...prev.touched,
+                [field]: true,
+            },
+            errors,
+        }));
+        if (options.asyncValidatorRef.current) {
+            options.asyncValidatorRef.current.run(snapshot.values);
+        }
+    };
+    const bind = (field, bindOptions) => {
+        const snapshot = options.stateRef.current;
+        const disabled = options.isFieldDisabledInternal(field, snapshot);
+        const readOnly = !disabled && options.isFieldReadOnlyInternal(field, snapshot);
+        const textBindable = options.canBindFieldAsText(field, snapshot.values);
+        if (!textBindable) {
+            options.warnUnsupportedTextBinding(field);
+        }
+        return {
+            id: bindOptions?.id ?? options.ctx.id(String(field)),
+            value: toInputValue(snapshot.values[field]),
+            disabled,
+            readOnly,
+            onInput: (value) => {
+                if (!textBindable)
+                    return;
+                setFieldValue(field, value);
+            },
+            onBlur: handleBlur(field),
+        };
+    };
+    const field = (fieldName, fieldOptions) => {
+        const { key, label, required, hint, error, ...inputOverrides } = fieldOptions ?? {};
+        const inputBinding = bind(fieldName, inputOverrides.id === undefined ? undefined : { id: inputOverrides.id });
+        const touched = hasTruthyBooleanValue(options.state.touched[fieldName]);
+        const derivedError = touched ? toFieldErrorString(options.state.errors[fieldName]) : undefined;
+        const resolvedError = error ?? derivedError;
+        return ui.field({
+            ...(key !== undefined ? { key } : {}),
+            label: label ?? String(fieldName),
+            ...(required !== undefined ? { required } : {}),
+            ...(hint !== undefined ? { hint } : {}),
+            ...(resolvedError !== undefined ? { error: resolvedError } : {}),
+            children: ui.input({
+                ...inputBinding,
+                ...inputOverrides,
+            }),
+        });
+    };
+    return Object.freeze({
+        validateForm,
+        validateField,
+        setFieldValue,
+        setFieldError,
+        setFieldTouched,
+        handleChange,
+        handleBlur,
+        bind,
+        field,
+    });
+}
+//# sourceMappingURL=bindings.js.map