@rezi-ui/core 0.1.0-alpha.6 → 0.1.0-alpha.63

package/dist/forms/internal/wizard.js

@@ -0,0 +1,311 @@
+import { isValidationClean, mergeValidationErrors } from "../validation.js";
+export function clampStepIndex(stepIndex, stepCount) {
+    if (stepCount <= 0) {
+        return 0;
+    }
+    if (stepIndex < 0) {
+        return 0;
+    }
+    if (stepIndex >= stepCount) {
+        return stepCount - 1;
+    }
+    return stepIndex;
+}
+function getStep(wizardSteps, stepIndex) {
+    if (wizardSteps.length === 0) {
+        return undefined;
+    }
+    const resolvedStep = clampStepIndex(stepIndex, wizardSteps.length);
+    return wizardSteps[resolvedStep];
+}
+export function getStepFields(step, values) {
+    if (step?.fields && step.fields.length > 0) {
+        return [...step.fields];
+    }
+    return Object.keys(values);
+}
+export function getWizardTransitionSteps(wizardSteps, fromStep, toStepExclusive, values) {
+    const steps = [];
+    for (let stepIndex = fromStep; stepIndex < toStepExclusive; stepIndex++) {
+        steps.push(Object.freeze({
+            stepIndex,
+            fields: getStepFields(getStep(wizardSteps, stepIndex), values),
+        }));
+    }
+    return Object.freeze(steps);
+}
+export function mergeStepErrors(prevErrors, stepFields, stepErrors) {
+    const nextErrors = { ...prevErrors };
+    for (const field of stepFields) {
+        nextErrors[field] = undefined;
+    }
+    const stepErrorKeys = Object.keys(stepErrors);
+    for (const field of stepErrorKeys) {
+        nextErrors[field] = stepErrors[field];
+    }
+    return nextErrors;
+}
+export function pickValidationFields(errors, fields) {
+    const selected = {};
+    for (const field of fields) {
+        const value = errors[field];
+        if (value !== undefined) {
+            selected[field] = value;
+        }
+    }
+    return selected;
+}
+export function clearValidationFields(errors, fields) {
+    if (fields.length === 0) {
+        return errors;
+    }
+    const nextErrors = { ...errors };
+    for (const field of fields) {
+        nextErrors[field] = undefined;
+    }
+    return nextErrors;
+}
+export function markFieldsTouched(prevTouched, values, fields) {
+    const nextTouched = {
+        ...prevTouched,
+    };
+    for (const field of fields) {
+        const value = values[field];
+        if (Array.isArray(value)) {
+            nextTouched[field] = value.map(() => true);
+        }
+        else {
+            nextTouched[field] = true;
+        }
+    }
+    return nextTouched;
+}
+export function runWizardStepValidation(options) {
+    const step = getStep(options.wizardSteps, options.stepIndex);
+    if (!step) {
+        return {};
+    }
+    const stepFields = getStepFields(step, options.values);
+    const syncStepErrors = pickValidationFields(options.runSyncValidationFiltered(options.values, options.source), stepFields);
+    if (!step.validate) {
+        return mergeValidationErrors(syncStepErrors, pickValidationFields(options.filterDisabledValidationErrors(options.source.errors, options.source), stepFields));
+    }
+    const customStepErrors = options.filterDisabledValidationErrors(pickValidationFields(step.validate(options.values), stepFields), options.source);
+    return mergeValidationErrors(mergeValidationErrors(syncStepErrors, customStepErrors), pickValidationFields(options.filterDisabledValidationErrors(options.source.errors, options.source), stepFields));
+}
+export function resolveWizardTransition(options) {
+    let mergedErrors = options.source.errors;
+    for (const transitionStep of options.transitionSteps) {
+        const stepSourceErrors = options.includeSourceErrors === false
+            ? clearValidationFields(mergedErrors, transitionStep.fields)
+            : options.asyncErrors === undefined
+                ? mergedErrors
+                : clearValidationFields(mergedErrors, transitionStep.fields);
+        const baseStepErrors = options.runWizardStepValidation(options.values, transitionStep.stepIndex, {
+            ...options.source,
+            errors: stepSourceErrors,
+        });
+        const stepErrors = options.asyncErrors === undefined
+            ? baseStepErrors
+            : mergeValidationErrors(baseStepErrors, pickValidationFields(options.asyncErrors, transitionStep.fields));
+        if (!isValidationClean(stepErrors)) {
+            return Object.freeze({
+                blockedFields: transitionStep.fields,
+                mergedErrors: mergeStepErrors(mergedErrors, transitionStep.fields, stepErrors),
+                touched: markFieldsTouched(options.source.touched, options.values, transitionStep.fields),
+            });
+        }
+        mergedErrors = clearValidationFields(mergedErrors, transitionStep.fields);
+    }
+    return null;
+}
+export function createWizardActions(options) {
+    const nextStep = () => {
+        if (!options.hasWizard) {
+            return true;
+        }
+        const snapshot = options.stateRef.current;
+        const currentStepIndex = clampStepIndex(snapshot.currentStep, options.stepCount);
+        if (currentStepIndex >= options.stepCount - 1) {
+            return true;
+        }
+        const targetStep = clampStepIndex(currentStepIndex + 1, options.stepCount);
+        const transitionSteps = getWizardTransitionSteps(options.wizardSteps, currentStepIndex, targetStep, snapshot.values);
+        const blocked = resolveWizardTransition({
+            values: snapshot.values,
+            transitionSteps,
+            source: snapshot,
+            includeSourceErrors: !options.validateAsync,
+            runWizardStepValidation: options.runWizardStepValidation,
+        });
+        if (blocked) {
+            options.updateFormState((prev) => ({
+                ...prev,
+                touched: blocked.touched,
+                errors: blocked.mergedErrors,
+            }));
+            return false;
+        }
+        if (!options.validateAsync) {
+            const traversedFields = transitionSteps.flatMap((step) => step.fields);
+            options.updateFormState((prev) => ({
+                ...prev,
+                currentStep: targetStep,
+                errors: clearValidationFields(prev.errors, traversedFields),
+            }));
+            return true;
+        }
+        void (async () => {
+            let asyncErrors;
+            try {
+                asyncErrors = await options.runAsyncValidationFiltered(snapshot.values, snapshot);
+            }
+            catch (error) {
+                if (options.stateRef.current.values !== snapshot.values ||
+                    clampStepIndex(options.stateRef.current.currentStep, options.stepCount) !==
+                        currentStepIndex) {
+                    return;
+                }
+                options.updateFormState((prev) => ({
+                    ...prev,
+                    submitError: error,
+                }));
+                return;
+            }
+            if (options.stateRef.current.values !== snapshot.values ||
+                clampStepIndex(options.stateRef.current.currentStep, options.stepCount) !== currentStepIndex) {
+                return;
+            }
+            const asyncBlocked = resolveWizardTransition({
+                values: snapshot.values,
+                transitionSteps,
+                source: options.stateRef.current,
+                asyncErrors,
+                includeSourceErrors: false,
+                runWizardStepValidation: options.runWizardStepValidation,
+            });
+            if (asyncBlocked) {
+                options.updateFormState((prev) => ({
+                    ...prev,
+                    touched: asyncBlocked.touched,
+                    errors: asyncBlocked.mergedErrors,
+                    submitError: undefined,
+                }));
+                return;
+            }
+            const traversedFields = transitionSteps.flatMap((step) => step.fields);
+            options.updateFormState((prev) => ({
+                ...prev,
+                currentStep: targetStep,
+                errors: clearValidationFields(prev.errors, traversedFields),
+                submitError: undefined,
+            }));
+        })();
+        return false;
+    };
+    const previousStep = () => {
+        if (!options.hasWizard) {
+            return;
+        }
+        options.updateFormState((prev) => ({
+            ...prev,
+            currentStep: clampStepIndex(prev.currentStep - 1, options.stepCount),
+        }));
+    };
+    const goToStep = (stepIndex) => {
+        if (!options.hasWizard) {
+            return false;
+        }
+        const snapshot = options.stateRef.current;
+        const currentStepIndex = clampStepIndex(snapshot.currentStep, options.stepCount);
+        const targetStep = clampStepIndex(stepIndex, options.stepCount);
+        if (targetStep === currentStepIndex) {
+            return true;
+        }
+        if (targetStep < currentStepIndex) {
+            options.updateFormState((prev) => ({
+                ...prev,
+                currentStep: targetStep,
+            }));
+            return true;
+        }
+        const transitionSteps = getWizardTransitionSteps(options.wizardSteps, currentStepIndex, targetStep, snapshot.values);
+        const blocked = resolveWizardTransition({
+            values: snapshot.values,
+            transitionSteps,
+            source: snapshot,
+            includeSourceErrors: !options.validateAsync,
+            runWizardStepValidation: options.runWizardStepValidation,
+        });
+        if (blocked) {
+            options.updateFormState((prev) => ({
+                ...prev,
+                touched: blocked.touched,
+                errors: blocked.mergedErrors,
+            }));
+            return false;
+        }
+        if (!options.validateAsync) {
+            const traversedFields = transitionSteps.flatMap((step) => step.fields);
+            options.updateFormState((prev) => ({
+                ...prev,
+                currentStep: targetStep,
+                errors: clearValidationFields(prev.errors, traversedFields),
+            }));
+            return true;
+        }
+        void (async () => {
+            let asyncErrors;
+            try {
+                asyncErrors = await options.runAsyncValidationFiltered(snapshot.values, snapshot);
+            }
+            catch (error) {
+                if (options.stateRef.current.values !== snapshot.values ||
+                    clampStepIndex(options.stateRef.current.currentStep, options.stepCount) !==
+                        currentStepIndex) {
+                    return;
+                }
+                options.updateFormState((prev) => ({
+                    ...prev,
+                    submitError: error,
+                }));
+                return;
+            }
+            if (options.stateRef.current.values !== snapshot.values ||
+                clampStepIndex(options.stateRef.current.currentStep, options.stepCount) !== currentStepIndex) {
+                return;
+            }
+            const asyncBlocked = resolveWizardTransition({
+                values: snapshot.values,
+                transitionSteps,
+                source: options.stateRef.current,
+                asyncErrors,
+                includeSourceErrors: false,
+                runWizardStepValidation: options.runWizardStepValidation,
+            });
+            if (asyncBlocked) {
+                options.updateFormState((prev) => ({
+                    ...prev,
+                    touched: asyncBlocked.touched,
+                    errors: asyncBlocked.mergedErrors,
+                    submitError: undefined,
+                }));
+                return;
+            }
+            const traversedFields = transitionSteps.flatMap((step) => step.fields);
+            options.updateFormState((prev) => ({
+                ...prev,
+                currentStep: targetStep,
+                errors: clearValidationFields(prev.errors, traversedFields),
+                submitError: undefined,
+            }));
+        })();
+        return false;
+    };
+    return Object.freeze({
+        nextStep,
+        previousStep,
+        goToStep,
+    });
+}
+//# sourceMappingURL=wizard.js.map

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

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

package/dist/forms/types.d.ts

@@ -6,6 +6,54 @@
  *
  * @see docs/recipes/form-validation.md (GitHub issue #119)
  */
+import type { InputProps, VNode } from "../widgets/types.js";
+/**
+ * Error value for a single form field.
+ * Array fields can carry per-item error messages.
+ */
+export type FieldErrorValue = string | ReadonlyArray<string | undefined>;
+/**
+ * Boolean state value for a field.
+ * Array fields can carry per-item flags.
+ */
+export type FieldBooleanValue = boolean | ReadonlyArray<boolean>;
+/**
+ * Keys in a form values object whose value is an array.
+ */
+export type ArrayFieldName<T extends Record<string, unknown>> = {
+    [K in keyof T]-?: T[K] extends ReadonlyArray<unknown> ? K : never;
+}[keyof T];
+/**
+ * Item type for an array field.
+ */
+export type ArrayFieldItem<T extends Record<string, unknown>, K extends ArrayFieldName<T>> = T[K] extends ReadonlyArray<infer Item> ? Item : never;
+/**
+ * Field names whose value can safely round-trip through a text input.
+ * Excludes literal-string fields because text inputs can emit arbitrary strings.
+ */
+export type UseFormTextFieldName<T extends Record<string, unknown>> = {
+    [K in keyof T]-?: Exclude<T[K], null | undefined> extends string ? string extends Exclude<T[K], null | undefined> ? K : never : never;
+}[keyof T];
+/**
+ * Step definition for multi-step form wizard support.
+ */
+export type FormWizardStep<T extends Record<string, unknown>> = Readonly<{
+    /** Unique step identifier. */
+    id: string;
+    /** Fields validated by this step. Defaults to all fields when omitted. */
+    fields?: ReadonlyArray<keyof T>;
+    /** Optional step-scoped validation. */
+    validate?: (values: T) => ValidationResult<T>;
+}>;
+/**
+ * Wizard configuration.
+ */
+export type FormWizardOptions<T extends Record<string, unknown>> = Readonly<{
+    /** Ordered steps in the wizard. */
+    steps: ReadonlyArray<FormWizardStep<T>>;
+    /** Initial step index (0-based). Default: 0. */
+    initialStep?: number;
+}>;
 /**
  * Options for configuring the useForm hook.
  */
@@ -20,12 +68,67 @@ export type UseFormOptions<T extends Record<string, unknown>> = Readonly<{
     validateOnBlur?: boolean;
     /** Callback invoked when form is submitted with valid values. */
     onSubmit: (values: T) => void | Promise<void>;
+    /** Optional callback invoked when `onSubmit` throws or rejects. */
+    onSubmitError?: (error: unknown) => void;
     /** Whether to reset form to initial values after successful submit. Default: false. */
     resetOnSubmit?: boolean;
     /** Asynchronous validation function (e.g., server-side checks). */
-    validateAsync?: (values: T) => Promise<Partial<Record<keyof T, string>>>;
+    validateAsync?: (values: T) => Promise<ValidationResult<T>>;
     /** Debounce delay in ms for async validation. Default: 300. */
     validateAsyncDebounce?: number;
+    /** Form-level disabled flag. Default: false. */
+    disabled?: boolean;
+    /** Form-level read-only flag. Default: false. */
+    readOnly?: boolean;
+    /** Field-level disabled overrides (override wins over form-level). */
+    fieldDisabled?: Partial<Record<keyof T, boolean>>;
+    /** Field-level read-only overrides (override wins over form-level). */
+    fieldReadOnly?: Partial<Record<keyof T, boolean>>;
+    /** Optional multi-step wizard configuration. */
+    wizard?: FormWizardOptions<T>;
+}>;
+/**
+ * Spread-ready input props returned by form.bind(field).
+ */
+export type UseFormInputBinding = Pick<InputProps, "id" | "value" | "onInput" | "onBlur" | "disabled" | "readOnly">;
+/**
+ * Options for form.bind(field).
+ */
+export type UseFormBindOptions = Readonly<{
+    /** Override generated input id. */
+    id?: string;
+}>;
+/**
+ * Options for form.field(field, options).
+ */
+export type UseFormFieldOptions = Readonly<{
+    /** Override generated input id. */
+    id?: string;
+    /** Reconciliation key for the outer field wrapper. */
+    key?: string;
+    /** Field label shown above the input. Defaults to the field name. */
+    label?: string;
+    /** Show required indicator beside the label. */
+    required?: boolean;
+    /** Help text shown when no error is rendered. */
+    hint?: string;
+    /** Optional explicit error override. */
+    error?: string;
+} & Omit<InputProps, "id" | "value" | "onInput" | "onBlur" | "key">>;
+/**
+ * Dynamic field array helper return type.
+ */
+export type UseFieldArrayReturn<T extends Record<string, unknown>, K extends ArrayFieldName<T>> = Readonly<{
+    /** Current array items. */
+    values: ReadonlyArray<ArrayFieldItem<T, K>>;
+    /** Stable keys for each array item. */
+    keys: ReadonlyArray<string>;
+    /** Append an item to the end of the array. */
+    append: (item: ArrayFieldItem<T, K>) => void;
+    /** Remove an item by index. */
+    remove: (index: number) => void;
+    /** Move item from index A to index B. */
+    move: (from: number, to: number) => void;
 }>;
 /**
  * Return type of the useForm hook.
@@ -34,29 +137,55 @@ export type UseFormReturn<T extends Record<string, unknown>> = Readonly<{
     /** Current form field values. */
     values: T;
     /** Validation errors keyed by field name. */
-    errors: Partial<Record<keyof T, string>>;
+    errors: ValidationResult<T>;
     /** Fields that have been focused and then blurred. */
-    touched: Partial<Record<keyof T, boolean>>;
+    touched: Partial<Record<keyof T, FieldBooleanValue>>;
     /** Fields that have been modified from initial values. */
-    dirty: Partial<Record<keyof T, boolean>>;
+    dirty: Partial<Record<keyof T, FieldBooleanValue>>;
     /** True if the form has no validation errors. */
     isValid: boolean;
     /** True if any field has been modified from initial values. */
     isDirty: boolean;
     /** True if form submission is in progress. */
     isSubmitting: boolean;
+    /** Most recent submit error from `onSubmit`, if any. */
+    submitError: unknown | undefined;
     /** Number of times handleSubmit has been called. */
     submitCount: number;
+    /** Form-level disabled flag. */
+    disabled: boolean;
+    /** Form-level read-only flag. */
+    readOnly: boolean;
+    /** Current wizard step index (0-based). */
+    currentStep: number;
+    /** Number of configured wizard steps. */
+    stepCount: number;
+    /** True when wizard support is configured. */
+    hasWizard: boolean;
+    /** True when current wizard step is the first step. */
+    isFirstStep: boolean;
+    /** True when current wizard step is the last step. */
+    isLastStep: boolean;
     /**
      * Returns a change handler for a specific field.
      * Use with input onInput callbacks.
      */
-    handleChange: (field: keyof T) => (value: T[keyof T]) => void;
+    handleChange: <K extends keyof T>(field: K) => (value: T[K]) => void;
     /**
      * Returns a blur handler for a specific field.
      * Marks field as touched and may trigger validation.
      */
-    handleBlur: (field: keyof T) => () => void;
+    handleBlur: <K extends keyof T>(field: K) => () => void;
+    /**
+     * Returns spread-ready input props for a specific field.
+     * Equivalent to wiring id/value/onInput/onBlur manually.
+     */
+    bind: <K extends UseFormTextFieldName<T>>(field: K, options?: UseFormBindOptions) => UseFormInputBinding;
+    /**
+     * Returns a fully wired ui.field(...) node with a child ui.input(...).
+     * Auto-wires bind props and touched error display.
+     */
+    field: <K extends UseFormTextFieldName<T>>(field: K, options?: UseFormFieldOptions) => VNode;
     /**
      * Submits the form if validation passes.
      * Runs both sync and async validation before calling onSubmit.
@@ -65,31 +194,57 @@ export type UseFormReturn<T extends Record<string, unknown>> = Readonly<{
     /** Resets form to initial values and clears all state. */
     reset: () => void;
     /** Sets a specific field's value programmatically. */
-    setFieldValue: (field: keyof T, value: T[keyof T]) => void;
+    setFieldValue: <K extends keyof T>(field: K, value: T[K]) => void;
     /** Sets a specific field's error programmatically. */
-    setFieldError: (field: keyof T, error: string | undefined) => void;
+    setFieldError: <K extends keyof T>(field: K, error: FieldErrorValue | undefined) => void;
     /** Marks a specific field as touched or untouched. */
-    setFieldTouched: (field: keyof T, touched: boolean) => void;
+    setFieldTouched: <K extends keyof T>(field: K, touched: boolean) => void;
     /** Validates a single field and returns its error (if any). */
-    validateField: (field: keyof T) => string | undefined;
+    validateField: <K extends keyof T>(field: K) => ValidationResult<T>[K] | undefined;
     /** Validates all fields and returns errors object. */
-    validateForm: () => Partial<Record<keyof T, string>>;
+    validateForm: () => ValidationResult<T>;
+    /** Set or clear form-level disabled state. */
+    setDisabled: (disabled: boolean) => void;
+    /** Set or clear form-level read-only state. */
+    setReadOnly: (readOnly: boolean) => void;
+    /** Set or clear field-level disabled override. */
+    setFieldDisabled: <K extends keyof T>(field: K, disabled: boolean | undefined) => void;
+    /** Set or clear field-level read-only override. */
+    setFieldReadOnly: <K extends keyof T>(field: K, readOnly: boolean | undefined) => void;
+    /** Check effective disabled state for a field. */
+    isFieldDisabled: <K extends keyof T>(field: K) => boolean;
+    /** Check effective read-only state for a field. */
+    isFieldReadOnly: <K extends keyof T>(field: K) => boolean;
+    /** Dynamic array helpers for an array-valued field. */
+    useFieldArray: <K extends ArrayFieldName<T>>(field: K) => UseFieldArrayReturn<T, K>;
+    /** Advance to next wizard step when current step is valid. */
+    nextStep: () => boolean;
+    /** Navigate to previous wizard step without re-validation. */
+    previousStep: () => void;
+    /** Navigate to a specific wizard step with forward validation gating. */
+    goToStep: (stepIndex: number) => boolean;
 }>;
 /**
  * Internal form state managed by useForm.
  */
 export type FormState<T extends Record<string, unknown>> = {
     values: T;
-    errors: Partial<Record<keyof T, string>>;
-    touched: Partial<Record<keyof T, boolean>>;
-    dirty: Partial<Record<keyof T, boolean>>;
+    errors: ValidationResult<T>;
+    touched: Partial<Record<keyof T, FieldBooleanValue>>;
+    dirty: Partial<Record<keyof T, FieldBooleanValue>>;
     isSubmitting: boolean;
+    submitError: unknown | undefined;
     submitCount: number;
+    disabled: boolean;
+    readOnly: boolean;
+    fieldDisabled: Partial<Record<keyof T, boolean>>;
+    fieldReadOnly: Partial<Record<keyof T, boolean>>;
+    currentStep: number;
 };
 /**
  * Validation result from sync or async validators.
  */
-export type ValidationResult<T extends Record<string, unknown>> = Partial<Record<keyof T, string>>;
+export type ValidationResult<T extends Record<string, unknown>> = Partial<Record<keyof T, FieldErrorValue>>;
 /**
  * Context passed to validation functions.
  */

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

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

package/dist/forms/useForm.d.ts

@@ -2,8 +2,8 @@
  * packages/core/src/forms/useForm.ts — Form management hook.
  *
  * Why: Provides a React-like form management hook for Rezi widgets.
- * Manages form values, validation, touched/dirty state, and submission.
- * Works with the widget composition API via WidgetContext hooks.
+ * Manages form values, validation, touched/dirty state, submission,
+ * dynamic array fields, wizard navigation, and disabled/read-only behavior.
  *
  * @see docs/recipes/form-validation.md (GitHub issue #119)
  */
@@ -11,44 +11,6 @@ import type { WidgetContext } from "../widgets/composition.js";
 import type { UseFormOptions, UseFormReturn } from "./types.js";
 /**
  * Form management hook for Rezi widgets.
- *
- * Provides comprehensive form state management including:
- * - Field value tracking
- * - Touched/dirty state
- * - Sync and async validation
- * - Form submission handling
- *
- * @param ctx - Widget context from defineWidget render function
- * @param options - Form configuration options
- * @returns Form state and control methods
- *
- * @example
- * ```ts
- * const LoginForm = defineWidget<{ onLogin: (u: string, p: string) => void }>(
- *   (props, ctx) => {
- *     const form = useForm(ctx, {
- *       initialValues: { username: "", password: "" },
- *       validate: (v) => {
- *         const errors: Record<string, string> = {};
- *         if (!v.username) errors.username = "Required";
- *         if (v.password.length < 8) errors.password = "Min 8 chars";
- *         return errors;
- *       },
- *       onSubmit: (v) => props.onLogin(v.username, v.password),
- *     });
- *
- *     return ui.column([
- *       ui.input({
- *         id: ctx.id("username"),
- *         value: form.values.username,
- *         onInput: form.handleChange("username"),
- *         onBlur: form.handleBlur("username"),
- *       }),
- *       // ...
- *     ]);
- *   }
- * );
- * ```
  */
 export declare function useForm<T extends Record<string, unknown>, State = void>(ctx: WidgetContext<State>, options: UseFormOptions<T>): UseFormReturn<T>;
 //# sourceMappingURL=useForm.d.ts.map