@mdxui/terminal 2.0.0

package/dist/forms/index.d.ts

@@ -0,0 +1,1596 @@
+import { z } from 'zod';
+import { U as UINode } from '../types-Bxu5PAgA.js';
+
+/**
+ * @mdxui/terminal Form Integration Types
+ *
+ * TypeScript types for React Hook Form integration with terminal renderers.
+ * These types provide a bridge between RHF's form state management and the
+ * UINode-based rendering system.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Base field value types supported by terminal form components.
+ *
+ * @remarks
+ * These represent the primitive values that can be stored in form fields.
+ * Compatible with RHF's FieldValues constraint.
+ */
+type FieldValue = string | number | boolean | null | undefined | string[] | FieldValue[];
+/**
+ * Generic form values type compatible with React Hook Form.
+ *
+ * @remarks
+ * This is the base constraint for all form value types.
+ * Equivalent to RHF's FieldValues type.
+ *
+ * @example
+ * ```tsx
+ * interface LoginFormValues extends FormValues {
+ *   email: string
+ *   password: string
+ *   rememberMe: boolean
+ * }
+ * ```
+ */
+interface FormValues {
+    [key: string]: FieldValue | FormValues;
+}
+/**
+ * Configuration for a single form field.
+ *
+ * @remarks
+ * This interface represents the complete state and configuration of a form field,
+ * including validation state, UI state, and metadata. This maps directly to
+ * the props expected by the Field renderer.
+ *
+ * @typeParam T - The value type for this field (defaults to FieldValue)
+ */
+interface FieldConfig<T extends FieldValue = FieldValue> {
+    /** Unique field name (used as form key) */
+    name: string;
+    /** Display label for the field */
+    label?: string;
+    /** Field input type */
+    type?: 'text' | 'email' | 'password' | 'number' | 'checkbox' | 'textarea' | 'select';
+    /** Current field value */
+    value?: T;
+    /** Placeholder text when empty */
+    placeholder?: string;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Validation error message */
+    error?: string;
+    /** Whether the field has passed validation */
+    valid?: boolean;
+    /** Whether the field is disabled */
+    disabled?: boolean;
+    /** Whether the field is read-only */
+    readonly?: boolean;
+    /** Helper text displayed below the field */
+    helperText?: string;
+    /** Whether the field is currently focused */
+    focused?: boolean;
+    /** Cursor position for text inputs (interactive tier) */
+    cursorPosition?: number;
+    /** Selection start for text inputs (interactive tier) */
+    selectionStart?: number;
+    /** Selection end for text inputs (interactive tier) */
+    selectionEnd?: number;
+    /** Options for select fields */
+    options?: Array<{
+        label: string;
+        value: string;
+        disabled?: boolean;
+    }>;
+}
+/**
+ * Form group configuration for organizing related fields.
+ *
+ * @remarks
+ * Groups allow organizing fields into logical sections with
+ * optional collapse functionality.
+ */
+interface FieldGroup {
+    /** Group title */
+    title: string;
+    /** Fields in this group */
+    fields: FieldConfig[];
+    /** Whether the group can be collapsed */
+    collapsible?: boolean;
+    /** Whether the group is currently collapsed */
+    collapsed?: boolean;
+}
+/**
+ * Complete form state configuration.
+ *
+ * @remarks
+ * This represents the full state of a form, including all fields,
+ * groups, validation state, and submission state. This maps directly
+ * to the props expected by the Form renderer.
+ *
+ * @typeParam T - The form values type
+ */
+interface FormState<T extends FormValues = FormValues> {
+    /** Form title */
+    title?: string;
+    /** Form description */
+    description?: string;
+    /** Standalone fields (not in groups) */
+    fields?: FieldConfig[];
+    /** Grouped fields */
+    groups?: FieldGroup[];
+    /** Form-level error message */
+    error?: string;
+    /** Form-level success message */
+    success?: string;
+    /** Whether the form is currently loading/submitting */
+    loading?: boolean;
+    /** Submit button label */
+    submitLabel?: string;
+    /** Cancel button label */
+    cancelLabel?: string;
+    /** Whether the submit button is disabled */
+    submitDisabled?: boolean;
+    /** Submit button hotkey (interactive tier) */
+    submitHotkey?: string;
+    /** Whether to show a border around the form */
+    border?: boolean;
+    /** The current form values (for RHF integration) */
+    values?: T;
+}
+/**
+ * RHF register function signature.
+ *
+ * @remarks
+ * This is a simplified version of RHF's UseFormRegister type,
+ * designed to work with the terminal renderer system.
+ */
+type RegisterFn = (name: string, options?: {
+    required?: boolean | string;
+    min?: number | {
+        value: number;
+        message: string;
+    };
+    max?: number | {
+        value: number;
+        message: string;
+    };
+    minLength?: number | {
+        value: number;
+        message: string;
+    };
+    maxLength?: number | {
+        value: number;
+        message: string;
+    };
+    pattern?: RegExp | {
+        value: RegExp;
+        message: string;
+    };
+    validate?: (value: FieldValue) => boolean | string | Promise<boolean | string>;
+}) => {
+    name: string;
+    onChange: (event: {
+        target: {
+            value: FieldValue;
+        };
+    }) => void;
+    onBlur: () => void;
+    ref: (element: unknown) => void;
+};
+/**
+ * RHF form state subset relevant to terminal rendering.
+ *
+ * @remarks
+ * This represents the subset of RHF's FormState that is relevant
+ * for rendering form UI in the terminal.
+ */
+interface RHFFormState {
+    /** Whether the form is currently submitting */
+    isSubmitting: boolean;
+    /** Whether the form has been submitted at least once */
+    isSubmitted: boolean;
+    /** Whether the form is valid */
+    isValid: boolean;
+    /** Whether any field has been modified */
+    isDirty: boolean;
+    /** Field-level errors */
+    errors: Record<string, {
+        message?: string;
+        type?: string;
+    }>;
+    /** Fields that have been touched (focused and blurred) */
+    touchedFields: Record<string, boolean>;
+    /** Fields that have been modified */
+    dirtyFields: Record<string, boolean>;
+}
+/**
+ * Configuration for connecting RHF to terminal form renderer.
+ *
+ * @remarks
+ * This interface provides the bridge between RHF's hooks and
+ * the terminal form rendering system.
+ *
+ * @typeParam T - The form values type
+ */
+interface RHFFormConfig<T extends FormValues = FormValues> {
+    /** RHF register function */
+    register: RegisterFn;
+    /** RHF form state */
+    formState: RHFFormState;
+    /** RHF getValues function */
+    getValues: () => T;
+    /** RHF setValue function */
+    setValue: (name: keyof T, value: FieldValue) => void;
+    /** RHF trigger function (validate field) */
+    trigger: (name?: keyof T | (keyof T)[]) => Promise<boolean>;
+    /** RHF handleSubmit function */
+    handleSubmit: (onSubmit: (data: T) => void | Promise<void>) => (e?: Event) => Promise<void>;
+    /** RHF reset function */
+    reset: (values?: Partial<T>) => void;
+}
+/**
+ * Select field option configuration.
+ */
+interface SelectOption<T = string> {
+    /** Display label */
+    label: string;
+    /** Value when selected */
+    value: T;
+    /** Whether the option is disabled */
+    disabled?: boolean;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * Select field state configuration.
+ *
+ * @remarks
+ * This maps to the props expected by the Select renderer.
+ */
+interface SelectState<T = string> {
+    /** Available options */
+    options: SelectOption<T>[];
+    /** Currently selected value(s) */
+    value?: T | T[];
+    /** Field label */
+    label?: string;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Validation error message */
+    error?: string;
+    /** Whether the field has passed validation */
+    valid?: boolean;
+    /** Whether the field is disabled */
+    disabled?: boolean;
+    /** Whether the dropdown is open */
+    open?: boolean;
+    /** Whether multiple selection is allowed */
+    multiple?: boolean;
+    /** Currently highlighted option index */
+    highlightedIndex?: number;
+    /** Whether the select is searchable */
+    searchable?: boolean;
+    /** Current search query */
+    searchValue?: string;
+    /** Filtered options (when searchable) */
+    filteredOptions?: SelectOption<T>[];
+    /** Whether options are loading */
+    loading?: boolean;
+}
+/**
+ * Search field suggestion configuration.
+ */
+interface SearchSuggestion {
+    /** Display label */
+    label: string;
+    /** Value when selected */
+    value: string;
+    /** Optional description */
+    description?: string;
+    /** Optional icon identifier */
+    icon?: string;
+}
+/**
+ * Search field state configuration.
+ *
+ * @remarks
+ * This maps to the props expected by the Search renderer.
+ */
+interface SearchState {
+    /** Current search query */
+    value: string;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Field label */
+    label?: string;
+    /** Whether the field is disabled */
+    disabled?: boolean;
+    /** Whether results are loading */
+    loading?: boolean;
+    /** Validation error message */
+    error?: string;
+    /** Whether the field is focused */
+    focused?: boolean;
+    /** Cursor position (interactive tier) */
+    cursorPosition?: number;
+    /** Available suggestions */
+    suggestions?: SearchSuggestion[] | null;
+    /** Whether to show suggestions dropdown */
+    showSuggestions?: boolean;
+    /** Currently highlighted suggestion index */
+    highlightedIndex?: number;
+    /** Maximum suggestions to show */
+    maxSuggestions?: number;
+    /** Whether to highlight matching text */
+    highlightMatches?: boolean;
+    /** Whether user is currently typing (debounce indicator) */
+    isTyping?: boolean;
+}
+/**
+ * Extracts the inferred type from a Zod schema.
+ *
+ * @remarks
+ * Use this to derive TypeScript types from your Zod validation schemas.
+ *
+ * @example
+ * ```tsx
+ * const loginSchema = z.object({
+ *   email: z.string().email(),
+ *   password: z.string().min(8),
+ * })
+ *
+ * type LoginForm = InferFormValues<typeof loginSchema>
+ * // { email: string; password: string }
+ * ```
+ */
+type InferFormValues<T extends z.ZodType> = z.infer<T>;
+/**
+ * Converts RHF form state to terminal FormState format.
+ *
+ * @remarks
+ * This type represents a function that transforms RHF's internal
+ * state representation to the format expected by terminal renderers.
+ */
+type FormStateConverter<T extends FormValues = FormValues> = (rhfConfig: RHFFormConfig<T>, fieldConfigs: FieldConfig[]) => FormState<T>;
+/**
+ * Field registration options for RHF integration.
+ */
+interface FieldRegistration {
+    /** Field name */
+    name: string;
+    /** Validation rules */
+    rules?: {
+        required?: boolean | string;
+        min?: number | {
+            value: number;
+            message: string;
+        };
+        max?: number | {
+            value: number;
+            message: string;
+        };
+        minLength?: number | {
+            value: number;
+            message: string;
+        };
+        maxLength?: number | {
+            value: number;
+            message: string;
+        };
+        pattern?: RegExp | {
+            value: RegExp;
+            message: string;
+        };
+    };
+    /** Default value */
+    defaultValue?: FieldValue;
+}
+
+/**
+ * @mdxui/terminal Form Zod Schemas
+ *
+ * Zod validation schemas for terminal form components.
+ * These schemas can be used with @hookform/resolvers/zod for
+ * React Hook Form integration.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Schema for primitive field values.
+ */
+declare const FieldValueSchema: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUndefined, z.ZodArray<z.ZodString, "many">]>;
+/**
+ * Schema for select option configuration.
+ */
+declare const SelectOptionSchema: z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodString;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    label: string;
+    disabled?: boolean | undefined;
+    description?: string | undefined;
+}, {
+    value: string;
+    label: string;
+    disabled?: boolean | undefined;
+    description?: string | undefined;
+}>;
+/**
+ * Schema for search suggestion configuration.
+ */
+declare const SearchSuggestionSchema: z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    label: string;
+    description?: string | undefined;
+    icon?: string | undefined;
+}, {
+    value: string;
+    label: string;
+    description?: string | undefined;
+    icon?: string | undefined;
+}>;
+/**
+ * Schema for field input types.
+ */
+declare const FieldTypeSchema: z.ZodEnum<["text", "email", "password", "number", "checkbox", "textarea", "select"]>;
+/**
+ * Schema for field configuration.
+ *
+ * @remarks
+ * Validates the complete structure of a form field configuration.
+ * Use this to validate field configs passed to terminal renderers.
+ */
+declare const FieldConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["text", "email", "password", "number", "checkbox", "textarea", "select"]>>;
+    value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUndefined, z.ZodArray<z.ZodString, "many">]>>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodOptional<z.ZodString>;
+    valid: z.ZodOptional<z.ZodBoolean>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    readonly: z.ZodOptional<z.ZodBoolean>;
+    helperText: z.ZodOptional<z.ZodString>;
+    focused: z.ZodOptional<z.ZodBoolean>;
+    cursorPosition: z.ZodOptional<z.ZodNumber>;
+    selectionStart: z.ZodOptional<z.ZodNumber>;
+    selectionEnd: z.ZodOptional<z.ZodNumber>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+        disabled?: boolean | undefined;
+        description?: string | undefined;
+    }, {
+        value: string;
+        label: string;
+        disabled?: boolean | undefined;
+        description?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    value?: string | number | boolean | string[] | null | undefined;
+    valid?: boolean | undefined;
+    options?: {
+        value: string;
+        label: string;
+        disabled?: boolean | undefined;
+        description?: string | undefined;
+    }[] | undefined;
+    type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+    label?: string | undefined;
+    disabled?: boolean | undefined;
+    placeholder?: string | undefined;
+    required?: boolean | undefined;
+    error?: string | undefined;
+    readonly?: boolean | undefined;
+    helperText?: string | undefined;
+    focused?: boolean | undefined;
+    cursorPosition?: number | undefined;
+    selectionStart?: number | undefined;
+    selectionEnd?: number | undefined;
+}, {
+    name: string;
+    value?: string | number | boolean | string[] | null | undefined;
+    valid?: boolean | undefined;
+    options?: {
+        value: string;
+        label: string;
+        disabled?: boolean | undefined;
+        description?: string | undefined;
+    }[] | undefined;
+    type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+    label?: string | undefined;
+    disabled?: boolean | undefined;
+    placeholder?: string | undefined;
+    required?: boolean | undefined;
+    error?: string | undefined;
+    readonly?: boolean | undefined;
+    helperText?: string | undefined;
+    focused?: boolean | undefined;
+    cursorPosition?: number | undefined;
+    selectionStart?: number | undefined;
+    selectionEnd?: number | undefined;
+}>;
+/**
+ * Schema for field group configuration.
+ */
+declare const FieldGroupSchema: z.ZodObject<{
+    title: z.ZodString;
+    fields: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<["text", "email", "password", "number", "checkbox", "textarea", "select"]>>;
+        value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUndefined, z.ZodArray<z.ZodString, "many">]>>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        error: z.ZodOptional<z.ZodString>;
+        valid: z.ZodOptional<z.ZodBoolean>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        readonly: z.ZodOptional<z.ZodBoolean>;
+        helperText: z.ZodOptional<z.ZodString>;
+        focused: z.ZodOptional<z.ZodBoolean>;
+        cursorPosition: z.ZodOptional<z.ZodNumber>;
+        selectionStart: z.ZodOptional<z.ZodNumber>;
+        selectionEnd: z.ZodOptional<z.ZodNumber>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+            disabled: z.ZodOptional<z.ZodBoolean>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            label: string;
+            disabled?: boolean | undefined;
+            description?: string | undefined;
+        }, {
+            value: string;
+            label: string;
+            disabled?: boolean | undefined;
+            description?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        value?: string | number | boolean | string[] | null | undefined;
+        valid?: boolean | undefined;
+        options?: {
+            value: string;
+            label: string;
+            disabled?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+        type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+        label?: string | undefined;
+        disabled?: boolean | undefined;
+        placeholder?: string | undefined;
+        required?: boolean | undefined;
+        error?: string | undefined;
+        readonly?: boolean | undefined;
+        helperText?: string | undefined;
+        focused?: boolean | undefined;
+        cursorPosition?: number | undefined;
+        selectionStart?: number | undefined;
+        selectionEnd?: number | undefined;
+    }, {
+        name: string;
+        value?: string | number | boolean | string[] | null | undefined;
+        valid?: boolean | undefined;
+        options?: {
+            value: string;
+            label: string;
+            disabled?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+        type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+        label?: string | undefined;
+        disabled?: boolean | undefined;
+        placeholder?: string | undefined;
+        required?: boolean | undefined;
+        error?: string | undefined;
+        readonly?: boolean | undefined;
+        helperText?: string | undefined;
+        focused?: boolean | undefined;
+        cursorPosition?: number | undefined;
+        selectionStart?: number | undefined;
+        selectionEnd?: number | undefined;
+    }>, "many">;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    collapsed: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    fields: {
+        name: string;
+        value?: string | number | boolean | string[] | null | undefined;
+        valid?: boolean | undefined;
+        options?: {
+            value: string;
+            label: string;
+            disabled?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+        type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+        label?: string | undefined;
+        disabled?: boolean | undefined;
+        placeholder?: string | undefined;
+        required?: boolean | undefined;
+        error?: string | undefined;
+        readonly?: boolean | undefined;
+        helperText?: string | undefined;
+        focused?: boolean | undefined;
+        cursorPosition?: number | undefined;
+        selectionStart?: number | undefined;
+        selectionEnd?: number | undefined;
+    }[];
+    collapsible?: boolean | undefined;
+    collapsed?: boolean | undefined;
+}, {
+    title: string;
+    fields: {
+        name: string;
+        value?: string | number | boolean | string[] | null | undefined;
+        valid?: boolean | undefined;
+        options?: {
+            value: string;
+            label: string;
+            disabled?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+        type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+        label?: string | undefined;
+        disabled?: boolean | undefined;
+        placeholder?: string | undefined;
+        required?: boolean | undefined;
+        error?: string | undefined;
+        readonly?: boolean | undefined;
+        helperText?: string | undefined;
+        focused?: boolean | undefined;
+        cursorPosition?: number | undefined;
+        selectionStart?: number | undefined;
+        selectionEnd?: number | undefined;
+    }[];
+    collapsible?: boolean | undefined;
+    collapsed?: boolean | undefined;
+}>;
+/**
+ * Schema for complete form state.
+ *
+ * @remarks
+ * Validates the full form configuration including all fields,
+ * groups, and UI state. Use this to validate form configs
+ * passed to the Form renderer.
+ */
+declare const FormStateSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<["text", "email", "password", "number", "checkbox", "textarea", "select"]>>;
+        value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUndefined, z.ZodArray<z.ZodString, "many">]>>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        error: z.ZodOptional<z.ZodString>;
+        valid: z.ZodOptional<z.ZodBoolean>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        readonly: z.ZodOptional<z.ZodBoolean>;
+        helperText: z.ZodOptional<z.ZodString>;
+        focused: z.ZodOptional<z.ZodBoolean>;
+        cursorPosition: z.ZodOptional<z.ZodNumber>;
+        selectionStart: z.ZodOptional<z.ZodNumber>;
+        selectionEnd: z.ZodOptional<z.ZodNumber>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+            disabled: z.ZodOptional<z.ZodBoolean>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            label: string;
+            disabled?: boolean | undefined;
+            description?: string | undefined;
+        }, {
+            value: string;
+            label: string;
+            disabled?: boolean | undefined;
+            description?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        value?: string | number | boolean | string[] | null | undefined;
+        valid?: boolean | undefined;
+        options?: {
+            value: string;
+            label: string;
+            disabled?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+        type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+        label?: string | undefined;
+        disabled?: boolean | undefined;
+        placeholder?: string | undefined;
+        required?: boolean | undefined;
+        error?: string | undefined;
+        readonly?: boolean | undefined;
+        helperText?: string | undefined;
+        focused?: boolean | undefined;
+        cursorPosition?: number | undefined;
+        selectionStart?: number | undefined;
+        selectionEnd?: number | undefined;
+    }, {
+        name: string;
+        value?: string | number | boolean | string[] | null | undefined;
+        valid?: boolean | undefined;
+        options?: {
+            value: string;
+            label: string;
+            disabled?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+        type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+        label?: string | undefined;
+        disabled?: boolean | undefined;
+        placeholder?: string | undefined;
+        required?: boolean | undefined;
+        error?: string | undefined;
+        readonly?: boolean | undefined;
+        helperText?: string | undefined;
+        focused?: boolean | undefined;
+        cursorPosition?: number | undefined;
+        selectionStart?: number | undefined;
+        selectionEnd?: number | undefined;
+    }>, "many">>;
+    groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        fields: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["text", "email", "password", "number", "checkbox", "textarea", "select"]>>;
+            value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUndefined, z.ZodArray<z.ZodString, "many">]>>;
+            placeholder: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            error: z.ZodOptional<z.ZodString>;
+            valid: z.ZodOptional<z.ZodBoolean>;
+            disabled: z.ZodOptional<z.ZodBoolean>;
+            readonly: z.ZodOptional<z.ZodBoolean>;
+            helperText: z.ZodOptional<z.ZodString>;
+            focused: z.ZodOptional<z.ZodBoolean>;
+            cursorPosition: z.ZodOptional<z.ZodNumber>;
+            selectionStart: z.ZodOptional<z.ZodNumber>;
+            selectionEnd: z.ZodOptional<z.ZodNumber>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+                disabled: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                value: string;
+                label: string;
+                disabled?: boolean | undefined;
+                description?: string | undefined;
+            }, {
+                value: string;
+                label: string;
+                disabled?: boolean | undefined;
+                description?: string | undefined;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            value?: string | number | boolean | string[] | null | undefined;
+            valid?: boolean | undefined;
+            options?: {
+                value: string;
+                label: string;
+                disabled?: boolean | undefined;
+                description?: string | undefined;
+            }[] | undefined;
+            type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+            label?: string | undefined;
+            disabled?: boolean | undefined;
+            placeholder?: string | undefined;
+            required?: boolean | undefined;
+            error?: string | undefined;
+            readonly?: boolean | undefined;
+            helperText?: string | undefined;
+            focused?: boolean | undefined;
+            cursorPosition?: number | undefined;
+            selectionStart?: number | undefined;
+            selectionEnd?: number | undefined;
+        }, {
+            name: string;
+            value?: string | number | boolean | string[] | null | undefined;
+            valid?: boolean | undefined;
+            options?: {
+                value: string;
+                label: string;
+                disabled?: boolean | undefined;
+                description?: string | undefined;
+            }[] | undefined;
+            type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+            label?: string | undefined;
+            disabled?: boolean | undefined;
+            placeholder?: string | undefined;
+            required?: boolean | undefined;
+            error?: string | undefined;
+            readonly?: boolean | undefined;
+            helperText?: string | undefined;
+            focused?: boolean | undefined;
+            cursorPosition?: number | undefined;
+            selectionStart?: number | undefined;
+            selectionEnd?: number | undefined;
+        }>, "many">;
+        collapsible: z.ZodOptional<z.ZodBoolean>;
+        collapsed: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        fields: {
+            name: string;
+            value?: string | number | boolean | string[] | null | undefined;
+            valid?: boolean | undefined;
+            options?: {
+                value: string;
+                label: string;
+                disabled?: boolean | undefined;
+                description?: string | undefined;
+            }[] | undefined;
+            type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+            label?: string | undefined;
+            disabled?: boolean | undefined;
+            placeholder?: string | undefined;
+            required?: boolean | undefined;
+            error?: string | undefined;
+            readonly?: boolean | undefined;
+            helperText?: string | undefined;
+            focused?: boolean | undefined;
+            cursorPosition?: number | undefined;
+            selectionStart?: number | undefined;
+            selectionEnd?: number | undefined;
+        }[];
+        collapsible?: boolean | undefined;
+        collapsed?: boolean | undefined;
+    }, {
+        title: string;
+        fields: {
+            name: string;
+            value?: string | number | boolean | string[] | null | undefined;
+            valid?: boolean | undefined;
+            options?: {
+                value: string;
+                label: string;
+                disabled?: boolean | undefined;
+                description?: string | undefined;
+            }[] | undefined;
+            type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+            label?: string | undefined;
+            disabled?: boolean | undefined;
+            placeholder?: string | undefined;
+            required?: boolean | undefined;
+            error?: string | undefined;
+            readonly?: boolean | undefined;
+            helperText?: string | undefined;
+            focused?: boolean | undefined;
+            cursorPosition?: number | undefined;
+            selectionStart?: number | undefined;
+            selectionEnd?: number | undefined;
+        }[];
+        collapsible?: boolean | undefined;
+        collapsed?: boolean | undefined;
+    }>, "many">>;
+    error: z.ZodOptional<z.ZodString>;
+    success: z.ZodOptional<z.ZodString>;
+    loading: z.ZodOptional<z.ZodBoolean>;
+    submitLabel: z.ZodOptional<z.ZodString>;
+    cancelLabel: z.ZodOptional<z.ZodString>;
+    submitDisabled: z.ZodOptional<z.ZodBoolean>;
+    submitHotkey: z.ZodOptional<z.ZodString>;
+    border: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    description?: string | undefined;
+    error?: string | undefined;
+    title?: string | undefined;
+    fields?: {
+        name: string;
+        value?: string | number | boolean | string[] | null | undefined;
+        valid?: boolean | undefined;
+        options?: {
+            value: string;
+            label: string;
+            disabled?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+        type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+        label?: string | undefined;
+        disabled?: boolean | undefined;
+        placeholder?: string | undefined;
+        required?: boolean | undefined;
+        error?: string | undefined;
+        readonly?: boolean | undefined;
+        helperText?: string | undefined;
+        focused?: boolean | undefined;
+        cursorPosition?: number | undefined;
+        selectionStart?: number | undefined;
+        selectionEnd?: number | undefined;
+    }[] | undefined;
+    groups?: {
+        title: string;
+        fields: {
+            name: string;
+            value?: string | number | boolean | string[] | null | undefined;
+            valid?: boolean | undefined;
+            options?: {
+                value: string;
+                label: string;
+                disabled?: boolean | undefined;
+                description?: string | undefined;
+            }[] | undefined;
+            type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+            label?: string | undefined;
+            disabled?: boolean | undefined;
+            placeholder?: string | undefined;
+            required?: boolean | undefined;
+            error?: string | undefined;
+            readonly?: boolean | undefined;
+            helperText?: string | undefined;
+            focused?: boolean | undefined;
+            cursorPosition?: number | undefined;
+            selectionStart?: number | undefined;
+            selectionEnd?: number | undefined;
+        }[];
+        collapsible?: boolean | undefined;
+        collapsed?: boolean | undefined;
+    }[] | undefined;
+    success?: string | undefined;
+    loading?: boolean | undefined;
+    submitLabel?: string | undefined;
+    cancelLabel?: string | undefined;
+    submitDisabled?: boolean | undefined;
+    submitHotkey?: string | undefined;
+    border?: boolean | undefined;
+}, {
+    description?: string | undefined;
+    error?: string | undefined;
+    title?: string | undefined;
+    fields?: {
+        name: string;
+        value?: string | number | boolean | string[] | null | undefined;
+        valid?: boolean | undefined;
+        options?: {
+            value: string;
+            label: string;
+            disabled?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+        type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+        label?: string | undefined;
+        disabled?: boolean | undefined;
+        placeholder?: string | undefined;
+        required?: boolean | undefined;
+        error?: string | undefined;
+        readonly?: boolean | undefined;
+        helperText?: string | undefined;
+        focused?: boolean | undefined;
+        cursorPosition?: number | undefined;
+        selectionStart?: number | undefined;
+        selectionEnd?: number | undefined;
+    }[] | undefined;
+    groups?: {
+        title: string;
+        fields: {
+            name: string;
+            value?: string | number | boolean | string[] | null | undefined;
+            valid?: boolean | undefined;
+            options?: {
+                value: string;
+                label: string;
+                disabled?: boolean | undefined;
+                description?: string | undefined;
+            }[] | undefined;
+            type?: "number" | "text" | "email" | "password" | "checkbox" | "textarea" | "select" | undefined;
+            label?: string | undefined;
+            disabled?: boolean | undefined;
+            placeholder?: string | undefined;
+            required?: boolean | undefined;
+            error?: string | undefined;
+            readonly?: boolean | undefined;
+            helperText?: string | undefined;
+            focused?: boolean | undefined;
+            cursorPosition?: number | undefined;
+            selectionStart?: number | undefined;
+            selectionEnd?: number | undefined;
+        }[];
+        collapsible?: boolean | undefined;
+        collapsed?: boolean | undefined;
+    }[] | undefined;
+    success?: string | undefined;
+    loading?: boolean | undefined;
+    submitLabel?: string | undefined;
+    cancelLabel?: string | undefined;
+    submitDisabled?: boolean | undefined;
+    submitHotkey?: string | undefined;
+    border?: boolean | undefined;
+}>;
+/**
+ * Schema for select component state.
+ */
+declare const SelectStateSchema: z.ZodObject<{
+    options: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+        disabled?: boolean | undefined;
+        description?: string | undefined;
+    }, {
+        value: string;
+        label: string;
+        disabled?: boolean | undefined;
+        description?: string | undefined;
+    }>, "many">;
+    value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    label: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodOptional<z.ZodString>;
+    valid: z.ZodOptional<z.ZodBoolean>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    open: z.ZodOptional<z.ZodBoolean>;
+    multiple: z.ZodOptional<z.ZodBoolean>;
+    highlightedIndex: z.ZodOptional<z.ZodNumber>;
+    searchable: z.ZodOptional<z.ZodBoolean>;
+    searchValue: z.ZodOptional<z.ZodString>;
+    filteredOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+        disabled?: boolean | undefined;
+        description?: string | undefined;
+    }, {
+        value: string;
+        label: string;
+        disabled?: boolean | undefined;
+        description?: string | undefined;
+    }>, "many">>;
+    loading: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    options: {
+        value: string;
+        label: string;
+        disabled?: boolean | undefined;
+        description?: string | undefined;
+    }[];
+    value?: string | string[] | undefined;
+    valid?: boolean | undefined;
+    label?: string | undefined;
+    disabled?: boolean | undefined;
+    placeholder?: string | undefined;
+    required?: boolean | undefined;
+    error?: string | undefined;
+    loading?: boolean | undefined;
+    open?: boolean | undefined;
+    multiple?: boolean | undefined;
+    highlightedIndex?: number | undefined;
+    searchable?: boolean | undefined;
+    searchValue?: string | undefined;
+    filteredOptions?: {
+        value: string;
+        label: string;
+        disabled?: boolean | undefined;
+        description?: string | undefined;
+    }[] | undefined;
+}, {
+    options: {
+        value: string;
+        label: string;
+        disabled?: boolean | undefined;
+        description?: string | undefined;
+    }[];
+    value?: string | string[] | undefined;
+    valid?: boolean | undefined;
+    label?: string | undefined;
+    disabled?: boolean | undefined;
+    placeholder?: string | undefined;
+    required?: boolean | undefined;
+    error?: string | undefined;
+    loading?: boolean | undefined;
+    open?: boolean | undefined;
+    multiple?: boolean | undefined;
+    highlightedIndex?: number | undefined;
+    searchable?: boolean | undefined;
+    searchValue?: string | undefined;
+    filteredOptions?: {
+        value: string;
+        label: string;
+        disabled?: boolean | undefined;
+        description?: string | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Schema for search component state.
+ */
+declare const SearchStateSchema: z.ZodObject<{
+    value: z.ZodString;
+    placeholder: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    loading: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodOptional<z.ZodString>;
+    focused: z.ZodOptional<z.ZodBoolean>;
+    cursorPosition: z.ZodOptional<z.ZodNumber>;
+    suggestions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+        description?: string | undefined;
+        icon?: string | undefined;
+    }, {
+        value: string;
+        label: string;
+        description?: string | undefined;
+        icon?: string | undefined;
+    }>, "many">>>;
+    showSuggestions: z.ZodOptional<z.ZodBoolean>;
+    highlightedIndex: z.ZodOptional<z.ZodNumber>;
+    maxSuggestions: z.ZodOptional<z.ZodNumber>;
+    highlightMatches: z.ZodOptional<z.ZodBoolean>;
+    isTyping: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    label?: string | undefined;
+    disabled?: boolean | undefined;
+    placeholder?: string | undefined;
+    error?: string | undefined;
+    focused?: boolean | undefined;
+    cursorPosition?: number | undefined;
+    loading?: boolean | undefined;
+    highlightedIndex?: number | undefined;
+    suggestions?: {
+        value: string;
+        label: string;
+        description?: string | undefined;
+        icon?: string | undefined;
+    }[] | null | undefined;
+    showSuggestions?: boolean | undefined;
+    maxSuggestions?: number | undefined;
+    highlightMatches?: boolean | undefined;
+    isTyping?: boolean | undefined;
+}, {
+    value: string;
+    label?: string | undefined;
+    disabled?: boolean | undefined;
+    placeholder?: string | undefined;
+    error?: string | undefined;
+    focused?: boolean | undefined;
+    cursorPosition?: number | undefined;
+    loading?: boolean | undefined;
+    highlightedIndex?: number | undefined;
+    suggestions?: {
+        value: string;
+        label: string;
+        description?: string | undefined;
+        icon?: string | undefined;
+    }[] | null | undefined;
+    showSuggestions?: boolean | undefined;
+    maxSuggestions?: number | undefined;
+    highlightMatches?: boolean | undefined;
+    isTyping?: boolean | undefined;
+}>;
+/**
+ * Schema for email validation.
+ */
+declare const EmailSchema: z.ZodString;
+/**
+ * Schema for password validation with common requirements.
+ */
+declare const PasswordSchema: z.ZodString;
+/**
+ * Schema for basic password validation (minimum length only).
+ */
+declare const SimplePasswordSchema: z.ZodString;
+/**
+ * Schema for username validation.
+ */
+declare const UsernameSchema: z.ZodString;
+/**
+ * Schema for URL validation.
+ */
+declare const UrlSchema: z.ZodString;
+/**
+ * Schema for phone number validation (basic).
+ */
+declare const PhoneSchema: z.ZodString;
+/**
+ * Creates a login form schema.
+ *
+ * @param options - Optional customization options
+ * @returns Zod schema for login form validation
+ *
+ * @example
+ * ```tsx
+ * const loginSchema = createLoginSchema()
+ * type LoginForm = z.infer<typeof loginSchema>
+ *
+ * // With remember me
+ * const loginSchemaWithRemember = createLoginSchema({ rememberMe: true })
+ * ```
+ */
+declare function createLoginSchema(options?: {
+    rememberMe?: boolean;
+    strictPassword?: boolean;
+}): z.ZodObject<{
+    email: z.ZodString;
+    password: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+    password: string;
+}, {
+    email: string;
+    password: string;
+}>;
+/**
+ * Creates a registration form schema.
+ *
+ * @param options - Optional customization options
+ * @returns Zod schema for registration form validation
+ *
+ * @example
+ * ```tsx
+ * const registerSchema = createRegistrationSchema({
+ *   confirmPassword: true,
+ *   termsRequired: true,
+ * })
+ * ```
+ */
+declare function createRegistrationSchema(options?: {
+    confirmPassword?: boolean;
+    termsRequired?: boolean;
+    usernameRequired?: boolean;
+}): z.ZodObject<{
+    email: z.ZodString;
+    password: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+    password: string;
+}, {
+    email: string;
+    password: string;
+}> | z.ZodIntersection<z.ZodEffects<z.ZodObject<{
+    email: z.ZodString;
+    password: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+    password: string;
+}, {
+    email: string;
+    password: string;
+}>, {
+    email: string;
+    password: string;
+}, {
+    email: string;
+    password: string;
+}>, z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
+/**
+ * Creates a contact form schema.
+ *
+ * @param options - Optional customization options
+ * @returns Zod schema for contact form validation
+ */
+declare function createContactSchema(options?: {
+    phoneRequired?: boolean;
+    subjectRequired?: boolean;
+}): z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+    message: string;
+    name: string;
+}, {
+    email: string;
+    message: string;
+    name: string;
+}>;
+/**
+ * Creates a profile form schema.
+ *
+ * @returns Zod schema for profile form validation
+ */
+declare function createProfileSchema(): z.ZodObject<{
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    email: z.ZodString;
+    bio: z.ZodOptional<z.ZodString>;
+    website: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    location: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+    firstName: string;
+    lastName: string;
+    bio?: string | undefined;
+    website?: string | undefined;
+    location?: string | undefined;
+    timezone?: string | undefined;
+}, {
+    email: string;
+    firstName: string;
+    lastName: string;
+    bio?: string | undefined;
+    website?: string | undefined;
+    location?: string | undefined;
+    timezone?: string | undefined;
+}>;
+/**
+ * Creates a settings form schema for common app settings.
+ *
+ * @returns Zod schema for settings form validation
+ */
+declare function createSettingsSchema(): z.ZodObject<{
+    emailNotifications: z.ZodDefault<z.ZodBoolean>;
+    pushNotifications: z.ZodDefault<z.ZodBoolean>;
+    marketingEmails: z.ZodDefault<z.ZodBoolean>;
+    theme: z.ZodDefault<z.ZodEnum<["light", "dark", "system"]>>;
+    language: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    emailNotifications: boolean;
+    pushNotifications: boolean;
+    marketingEmails: boolean;
+    theme: "light" | "dark" | "system";
+    language: string;
+}, {
+    emailNotifications?: boolean | undefined;
+    pushNotifications?: boolean | undefined;
+    marketingEmails?: boolean | undefined;
+    theme?: "light" | "dark" | "system" | undefined;
+    language?: string | undefined;
+}>;
+type LoginFormValues = z.infer<ReturnType<typeof createLoginSchema>>;
+type RegistrationFormValues = z.infer<ReturnType<typeof createRegistrationSchema>>;
+type ContactFormValues = z.infer<ReturnType<typeof createContactSchema>>;
+type ProfileFormValues = z.infer<ReturnType<typeof createProfileSchema>>;
+type SettingsFormValues = z.infer<ReturnType<typeof createSettingsSchema>>;
+
+/**
+ * @mdxui/terminal Form Converters
+ *
+ * Utility functions for converting between React Hook Form state
+ * and terminal UINode props format.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Converts RHF form state and field configurations to terminal FormState.
+ *
+ * @remarks
+ * This function bridges React Hook Form's state representation with
+ * the terminal form renderer's expected props format.
+ *
+ * @param rhfState - RHF form state from useForm hook
+ * @param fields - Array of field configurations
+ * @param options - Additional form options
+ * @returns FormState compatible with terminal Form renderer
+ *
+ * @example
+ * ```tsx
+ * const { formState, register, getValues } = useForm<LoginForm>()
+ *
+ * const terminalFormState = convertRHFToFormState(
+ *   formState,
+ *   [
+ *     { name: 'email', label: 'Email', type: 'email', required: true },
+ *     { name: 'password', label: 'Password', type: 'password', required: true },
+ *   ],
+ *   {
+ *     title: 'Login',
+ *     submitLabel: 'Sign In',
+ *     values: getValues(),
+ *   }
+ * )
+ * ```
+ */
+declare function convertRHFToFormState<T extends FormValues>(rhfState: RHFFormState, fields: FieldConfig[], options?: {
+    title?: string;
+    description?: string;
+    submitLabel?: string;
+    cancelLabel?: string;
+    submitHotkey?: string;
+    border?: boolean;
+    groups?: FieldGroup[];
+    values?: T;
+}): FormState<T>;
+/**
+ * Converts field configurations to UINode format for Form renderer.
+ *
+ * @param formState - Terminal FormState configuration
+ * @returns UINode for Form component
+ *
+ * @example
+ * ```tsx
+ * const formNode = formStateToUINode({
+ *   title: 'Contact Us',
+ *   fields: [
+ *     { name: 'email', label: 'Email', type: 'email' },
+ *     { name: 'message', label: 'Message', type: 'textarea' },
+ *   ],
+ *   submitLabel: 'Send',
+ * })
+ *
+ * const rendered = renderForm(formNode, ctx)
+ * ```
+ */
+declare function formStateToUINode<T extends FormValues>(formState: FormState<T>): UINode;
+/**
+ * Converts a single field configuration to UINode format.
+ *
+ * @param field - Field configuration
+ * @returns UINode for Field component
+ */
+declare function fieldConfigToUINode(field: FieldConfig): UINode;
+/**
+ * Creates a field configuration from RHF register result.
+ *
+ * @param name - Field name
+ * @param registerResult - Result from RHF register function
+ * @param options - Additional field options
+ * @returns FieldConfig for terminal rendering
+ */
+declare function createFieldFromRegister(name: string, registerResult: {
+    name: string;
+}, options?: Omit<FieldConfig, 'name'>): FieldConfig;
+/**
+ * Converts select state to UINode format.
+ *
+ * @param selectState - Select component state
+ * @returns UINode for Select component
+ */
+declare function selectStateToUINode<T = string>(selectState: SelectState<T>): UINode;
+/**
+ * Creates a select field configuration for RHF Controller integration.
+ *
+ * @param name - Field name
+ * @param options - Select options
+ * @param fieldOptions - Additional field options
+ * @returns SelectState for terminal rendering
+ *
+ * @example
+ * ```tsx
+ * // With RHF Controller
+ * <Controller
+ *   name="country"
+ *   control={control}
+ *   render={({ field, fieldState }) => {
+ *     const selectState = createSelectForController(
+ *       'country',
+ *       [
+ *         { label: 'United States', value: 'us' },
+ *         { label: 'Canada', value: 'ca' },
+ *       ],
+ *       {
+ *         value: field.value,
+ *         error: fieldState.error?.message,
+ *       }
+ *     )
+ *     const node = selectStateToUINode(selectState)
+ *     return renderSelect(node, ctx)
+ *   }}
+ * />
+ * ```
+ */
+declare function createSelectForController<T = string>(name: string, options: SelectOption<T>[], fieldOptions?: {
+    value?: T | T[];
+    error?: string;
+    label?: string;
+    placeholder?: string;
+    required?: boolean;
+    disabled?: boolean;
+    multiple?: boolean;
+    searchable?: boolean;
+}): SelectState<T>;
+/**
+ * Converts search state to UINode format.
+ *
+ * @param searchState - Search component state
+ * @returns UINode for Search component
+ */
+declare function searchStateToUINode(searchState: SearchState): UINode;
+/**
+ * Creates a debounced search state handler.
+ *
+ * @param onSearch - Callback when search should be executed
+ * @param delay - Debounce delay in milliseconds (default: 300)
+ * @returns Object with handlers for search input
+ *
+ * @example
+ * ```tsx
+ * const { handleChange, handleFocus, handleBlur, state } = createDebouncedSearch(
+ *   async (query) => {
+ *     const results = await fetchSuggestions(query)
+ *     return results.map(r => ({ label: r.name, value: r.id }))
+ *   }
+ * )
+ *
+ * // Use with RHF Controller
+ * <Controller
+ *   name="search"
+ *   control={control}
+ *   render={({ field }) => {
+ *     const searchNode = searchStateToUINode({
+ *       value: field.value,
+ *       ...state,
+ *     })
+ *     return renderSearch(searchNode, ctx)
+ *   }}
+ * />
+ * ```
+ */
+declare function createDebouncedSearch(onSearch: (query: string) => Promise<{
+    label: string;
+    value: string;
+}[]> | {
+    label: string;
+    value: string;
+}[], delay?: number): {
+    handleChange: (value: string) => void;
+    handleFocus: () => void;
+    handleBlur: () => void;
+    getState: () => Pick<SearchState, 'suggestions' | 'showSuggestions' | 'loading' | 'isTyping'>;
+};
+/**
+ * Extracts field errors from RHF form state in a format suitable for rendering.
+ *
+ * @param errors - RHF errors object
+ * @param fieldNames - Optional list of field names to extract
+ * @returns Record of field names to error messages
+ */
+declare function extractFieldErrors(errors: Record<string, {
+    message?: string;
+}>, fieldNames?: string[]): Record<string, string>;
+/**
+ * Checks if a form has any errors.
+ *
+ * @param errors - RHF errors object
+ * @returns True if there are any errors
+ */
+declare function hasFormErrors(errors: Record<string, unknown>): boolean;
+/**
+ * Gets the first field with an error.
+ *
+ * @param errors - RHF errors object
+ * @param fieldOrder - Optional field order to check
+ * @returns Name of first field with error, or undefined
+ */
+declare function getFirstErrorField(errors: Record<string, unknown>, fieldOrder?: string[]): string | undefined;
+
+export { type ContactFormValues, EmailSchema, type FieldConfig, FieldConfigSchema, type FieldGroup, FieldGroupSchema, type FieldRegistration, FieldTypeSchema, type FieldValue, FieldValueSchema, type FormState, type FormStateConverter, FormStateSchema, type FormValues, type InferFormValues, type LoginFormValues, PasswordSchema, PhoneSchema, type ProfileFormValues, type RHFFormConfig, type RHFFormState, type RegisterFn, type RegistrationFormValues, type SearchState, SearchStateSchema, type SearchSuggestion, SearchSuggestionSchema, type SelectOption, SelectOptionSchema, type SelectState, SelectStateSchema, type SettingsFormValues, SimplePasswordSchema, UrlSchema, UsernameSchema, convertRHFToFormState, createContactSchema, createDebouncedSearch, createFieldFromRegister, createLoginSchema, createProfileSchema, createRegistrationSchema, createSelectForController, createSettingsSchema, extractFieldErrors, fieldConfigToUINode, formStateToUINode, getFirstErrorField, hasFormErrors, searchStateToUINode, selectStateToUINode };