@omnitron-dev/prism 0.2.0 → 0.3.1

package/dist/components/field/field-editor.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Field.Editor Component
+ *
+ * Rich text editor with React Hook Form integration.
+ * Provides both a basic textarea fallback and a headless API for custom editors (TipTap, etc.)
+ *
+ * @module components/field
+ */
+import type { ReactNode, ComponentProps, ReactElement } from 'react';
+import { type RegisterOptions } from 'react-hook-form';
+import Box from '@mui/material/Box';
+/**
+ * Toolbar configuration for the editor.
+ */
+export interface EditorToolbarConfig {
+    /** Enable bold formatting */
+    bold?: boolean;
+    /** Enable italic formatting */
+    italic?: boolean;
+    /** Enable underline formatting */
+    underline?: boolean;
+    /** Enable strikethrough formatting */
+    strikethrough?: boolean;
+    /** Enable heading levels */
+    headings?: boolean | number[];
+    /** Enable bullet list */
+    bulletList?: boolean;
+    /** Enable numbered list */
+    orderedList?: boolean;
+    /** Enable blockquote */
+    blockquote?: boolean;
+    /** Enable code block */
+    codeBlock?: boolean;
+    /** Enable link insertion */
+    link?: boolean;
+    /** Enable image insertion */
+    image?: boolean;
+    /** Enable text alignment */
+    align?: boolean;
+    /** Enable undo/redo */
+    history?: boolean;
+}
+/**
+ * Props passed to custom editor render function.
+ */
+export interface EditorRenderProps {
+    /** Current HTML content */
+    value: string;
+    /** Update handler - call with new HTML content */
+    onChange: (html: string) => void;
+    /** Blur handler for form validation */
+    onBlur: () => void;
+    /** Error state */
+    error: boolean;
+    /** Field name */
+    name: string;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Read-only state */
+    readOnly?: boolean;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Toolbar configuration */
+    toolbar?: EditorToolbarConfig;
+    /** Minimum height */
+    minHeight?: number | string;
+    /** Maximum height */
+    maxHeight?: number | string;
+    /** Custom CSS class */
+    className?: string;
+    /** Aria label for accessibility */
+    'aria-label'?: string;
+    /** Aria described-by for error messages */
+    'aria-describedby'?: string;
+}
+/**
+ * Props for Field.Editor component.
+ */
+export interface FieldEditorProps {
+    /** Field name in the form */
+    name: string;
+    /** Field label */
+    label?: string;
+    /** Helper text displayed below the editor */
+    helperText?: ReactNode;
+    /** Validation rules for react-hook-form */
+    rules?: RegisterOptions;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Read-only state */
+    readOnly?: boolean;
+    /** Toolbar configuration */
+    toolbar?: EditorToolbarConfig;
+    /** Minimum height */
+    minHeight?: number | string;
+    /** Maximum height */
+    maxHeight?: number | string;
+    /** Required field indicator */
+    required?: boolean;
+    /** Full width */
+    fullWidth?: boolean;
+    /** Custom editor render function (for TipTap, etc.) */
+    renderEditor?: (props: EditorRenderProps) => ReactElement;
+    /** Additional props for the wrapper Box */
+    sx?: ComponentProps<typeof Box>['sx'];
+    /** Aria label for accessibility */
+    'aria-label'?: string;
+}
+/**
+ * Default toolbar configuration.
+ */
+export declare const DEFAULT_EDITOR_TOOLBAR: EditorToolbarConfig;
+/**
+ * Field.Editor - Rich text editor with React Hook Form integration.
+ *
+ * Supports both a basic textarea fallback and custom editor implementations.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage (textarea fallback)
+ * <FormProvider {...methods}>
+ *   <Field.Editor
+ *     name="content"
+ *     label="Article Content"
+ *     placeholder="Write your article..."
+ *     minHeight={300}
+ *   />
+ * </FormProvider>
+ *
+ * // With custom TipTap editor
+ * <Field.Editor
+ *   name="content"
+ *   label="Article Content"
+ *   renderEditor={({ value, onChange, onBlur, error }) => (
+ *     <TipTapEditor
+ *       content={value}
+ *       onUpdate={({ editor }) => onChange(editor.getHTML())}
+ *       onBlur={onBlur}
+ *       editorProps={{
+ *         attributes: {
+ *           class: error ? 'editor-error' : '',
+ *         },
+ *       }}
+ *     />
+ *   )}
+ * />
+ * ```
+ */
+export declare function FieldEditor({ name, label, helperText, rules, placeholder, disabled, readOnly, toolbar, minHeight, maxHeight, required, fullWidth, renderEditor, sx, 'aria-label': ariaLabel, }: FieldEditorProps): ReactNode;
+/**
+ * Props for Field.CustomEditor component.
+ */
+export interface FieldCustomEditorProps {
+    /** Field name in the form */
+    name: string;
+    /** Field label */
+    label?: string;
+    /** Helper text displayed below the editor */
+    helperText?: ReactNode;
+    /** Validation rules for react-hook-form */
+    rules?: RegisterOptions;
+    /** Required field indicator */
+    required?: boolean;
+    /** Full width */
+    fullWidth?: boolean;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Additional props for the wrapper Box */
+    sx?: ComponentProps<typeof Box>['sx'];
+    /** Render function for custom editor */
+    children: (props: {
+        value: string;
+        onChange: (value: string) => void;
+        onBlur: () => void;
+        error: boolean;
+        errorMessage?: string;
+        name: string;
+        disabled?: boolean;
+    }) => ReactElement;
+}
+/**
+ * Field.CustomEditor - Headless editor field with render prop pattern.
+ *
+ * Provides maximum flexibility for integrating any editor library.
+ *
+ * @example
+ * ```tsx
+ * import { useEditor, EditorContent } from '@tiptap/react';
+ * import StarterKit from '@tiptap/starter-kit';
+ *
+ * function ArticleForm() {
+ *   return (
+ *     <FormProvider {...methods}>
+ *       <Field.CustomEditor name="content" label="Content" required>
+ *         {({ value, onChange, onBlur, error }) => {
+ *           const editor = useEditor({
+ *             extensions: [StarterKit],
+ *             content: value,
+ *             onUpdate: ({ editor }) => onChange(editor.getHTML()),
+ *             onBlur: () => onBlur(),
+ *           });
+ *
+ *           return (
+ *             <Box sx={{ border: error ? '1px solid red' : '1px solid gray' }}>
+ *               <EditorContent editor={editor} />
+ *             </Box>
+ *           );
+ *         }}
+ *       </Field.CustomEditor>
+ *     </FormProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function FieldCustomEditor({ name, label, helperText, rules, required, fullWidth, disabled, sx, children, }: FieldCustomEditorProps): ReactNode;
+//# sourceMappingURL=field-editor.d.ts.map

package/dist/components/field/field-editor.d.ts.map

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

package/dist/components/field/field-multi-checkbox.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Field.MultiCheckbox Component
+ *
+ * React Hook Form integrated multiple checkbox group.
+ * Manages array values for multi-select scenarios.
+ *
+ * @module components/field
+ */
+import { type ReactNode } from 'react';
+import type { BoxProps } from '@mui/material/Box';
+import type { CheckboxProps } from '@mui/material/Checkbox';
+import type { FormControlProps } from '@mui/material/FormControl';
+import type { FormGroupProps } from '@mui/material/FormGroup';
+import type { FormHelperTextProps } from '@mui/material/FormHelperText';
+import type { FormLabelProps } from '@mui/material/FormLabel';
+/**
+ * Option for multi-checkbox selection
+ */
+export interface MultiCheckboxOption {
+    /** Display label */
+    label: string;
+    /** Value stored when selected */
+    value: string;
+    /** Disable this option */
+    disabled?: boolean;
+}
+/**
+ * Props for Field.MultiCheckbox component.
+ */
+export interface FieldMultiCheckboxProps extends Omit<FormGroupProps, 'onChange'> {
+    /** Field name in the form */
+    name: string;
+    /** Label for the checkbox group */
+    label?: string;
+    /** Available options */
+    options: MultiCheckboxOption[];
+    /** Helper text shown below the group */
+    helperText?: ReactNode;
+    /** Slot props for nested components */
+    slotProps?: {
+        /** Wrapper FormControl props */
+        wrapper?: Partial<FormControlProps>;
+        /** Individual Checkbox props */
+        checkbox?: Partial<CheckboxProps>;
+        /** FormLabel props */
+        formLabel?: Partial<FormLabelProps>;
+        /** FormHelperText props */
+        helperText?: Partial<FormHelperTextProps>;
+        /** Container Box props */
+        container?: Partial<BoxProps>;
+    };
+}
+/**
+ * Field.MultiCheckbox - Multiple checkbox group with React Hook Form integration.
+ *
+ * Stores selected values as an array. Toggle logic automatically adds/removes
+ * values when checkboxes are clicked.
+ *
+ * @example
+ * ```tsx
+ * <FormProvider {...methods}>
+ *   <Field.MultiCheckbox
+ *     name="interests"
+ *     label="Select your interests"
+ *     options={[
+ *       { label: 'Technology', value: 'tech' },
+ *       { label: 'Sports', value: 'sports' },
+ *       { label: 'Music', value: 'music' },
+ *       { label: 'Art', value: 'art' },
+ *     ]}
+ *   />
+ * </FormProvider>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Horizontal layout
+ * <Field.MultiCheckbox
+ *   name="features"
+ *   label="Enable features"
+ *   row
+ *   options={[
+ *     { label: 'Dark Mode', value: 'dark' },
+ *     { label: 'Notifications', value: 'notify' },
+ *     { label: 'Auto-save', value: 'autosave', disabled: true },
+ *   ]}
+ * />
+ * ```
+ */
+export declare function FieldMultiCheckbox({ name, label, options, helperText, slotProps, row, ...other }: FieldMultiCheckboxProps): ReactNode;
+//# sourceMappingURL=field-multi-checkbox.d.ts.map

package/dist/components/field/field-multi-checkbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-multi-checkbox.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-multi-checkbox.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAS9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAM9D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC;IAC/E,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,wCAAwC;IACxC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,uCAAuC;IACvC,SAAS,CAAC,EAAE;QACV,gCAAgC;QAChC,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACpC,gCAAgC;QAChC,QAAQ,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QAClC,sBAAsB;QACtB,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QACpC,2BAA2B;QAC3B,UAAU,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC1C,0BAA0B;QAC1B,SAAS,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;KAC/B,CAAC;CACH;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,KAAK,EACL,OAAO,EACP,UAAU,EACV,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,uBAAuB,GAAG,SAAS,CAsErC"}

package/dist/components/field/field-multi-select.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Field.MultiSelect Component
+ *
+ * React Hook Form integrated multi-select with chips.
+ *
+ * @module components/field
+ */
+import type { ReactNode } from 'react';
+import type { TextFieldProps } from '@mui/material/TextField';
+/**
+ * Option for multi-select.
+ */
+export interface MultiSelectOption {
+    /** Option value */
+    value: string | number;
+    /** Display label */
+    label: string;
+    /** Optional group */
+    group?: string;
+    /** Disabled state */
+    disabled?: boolean;
+}
+/**
+ * Props for Field.MultiSelect component.
+ */
+export interface FieldMultiSelectProps {
+    /** Field name in the form */
+    name: string;
+    /** Select options */
+    options: MultiSelectOption[];
+    /** Field label */
+    label?: string;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Helper text */
+    helperText?: string;
+    /** Props passed to TextField */
+    textFieldProps?: Partial<TextFieldProps>;
+    /** Maximum number of selections */
+    maxSelections?: number;
+    /** Chip variant */
+    chipVariant?: 'filled' | 'outlined' | 'soft';
+    /** Chip color */
+    chipColor?: 'default' | 'primary' | 'secondary' | 'error' | 'info' | 'success' | 'warning';
+    /** Disable clearable */
+    disableClearable?: boolean;
+    /** Disable close on select */
+    disableCloseOnSelect?: boolean;
+    /** Loading state */
+    loading?: boolean;
+    /** Loading text */
+    loadingText?: ReactNode;
+    /** No options text */
+    noOptionsText?: ReactNode;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Read only state */
+    readOnly?: boolean;
+    /** Full width */
+    fullWidth?: boolean;
+    /** Size */
+    size?: 'small' | 'medium';
+    /** Limit number of visible tags */
+    limitTags?: number;
+}
+/**
+ * Field.MultiSelect - Multiple selection with React Hook Form integration.
+ *
+ * @example
+ * ```tsx
+ * <FormProvider {...methods}>
+ *   <Field.MultiSelect
+ *     name="tags"
+ *     label="Tags"
+ *     options={[
+ *       { value: 'react', label: 'React' },
+ *       { value: 'typescript', label: 'TypeScript' },
+ *       { value: 'nodejs', label: 'Node.js' },
+ *     ]}
+ *   />
+ * </FormProvider>
+ * ```
+ */
+export declare function FieldMultiSelect({ name, options, label, placeholder, helperText, textFieldProps, maxSelections, chipVariant, chipColor, disableClearable, disableCloseOnSelect, loading, loadingText, noOptionsText, disabled, readOnly, fullWidth, size, limitTags, }: FieldMultiSelectProps): ReactNode;
+//# sourceMappingURL=field-multi-select.d.ts.map

package/dist/components/field/field-multi-select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-multi-select.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-multi-select.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,OAAO,CAAC;AAKvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB;IACnB,WAAW,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IAC7C,iBAAiB;IACjB,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3F,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8BAA8B;IAC9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mBAAmB;IACnB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,sBAAsB;IACtB,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW;IACX,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,OAAO,EACP,KAAK,EACL,WAAW,EACX,UAAU,EACV,cAAc,EACd,aAAa,EACb,WAAsB,EACtB,SAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,OAAO,EACP,WAAW,EACX,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,SAAgB,EAChB,IAAI,EACJ,SAAS,GACV,EAAE,qBAAqB,GAAG,SAAS,CAkFnC"}

package/dist/components/field/field-multi-switch.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Field.MultiSwitch Component
+ *
+ * React Hook Form integrated multiple switch group.
+ * Manages array values for multi-toggle scenarios.
+ *
+ * @module components/field
+ */
+import { type ReactNode } from 'react';
+import type { BoxProps } from '@mui/material/Box';
+import type { SwitchProps } from '@mui/material/Switch';
+import type { FormControlProps } from '@mui/material/FormControl';
+import type { FormGroupProps } from '@mui/material/FormGroup';
+import type { FormHelperTextProps } from '@mui/material/FormHelperText';
+import type { FormLabelProps } from '@mui/material/FormLabel';
+/**
+ * Option for multi-switch selection
+ */
+export interface MultiSwitchOption {
+    /** Display label */
+    label: string;
+    /** Value stored when enabled */
+    value: string;
+    /** Disable this option */
+    disabled?: boolean;
+}
+/**
+ * Props for Field.MultiSwitch component.
+ */
+export interface FieldMultiSwitchProps extends Omit<FormGroupProps, 'onChange'> {
+    /** Field name in the form */
+    name: string;
+    /** Label for the switch group */
+    label?: string;
+    /** Available options */
+    options: MultiSwitchOption[];
+    /** Helper text shown below the group */
+    helperText?: ReactNode;
+    /** Slot props for nested components */
+    slotProps?: {
+        /** Wrapper FormControl props */
+        wrapper?: Partial<FormControlProps>;
+        /** Individual Switch props */
+        switch?: Partial<SwitchProps>;
+        /** FormLabel props */
+        formLabel?: Partial<FormLabelProps>;
+        /** FormHelperText props */
+        helperText?: Partial<FormHelperTextProps>;
+        /** Container Box props */
+        container?: Partial<BoxProps>;
+    };
+}
+/**
+ * Field.MultiSwitch - Multiple switch group with React Hook Form integration.
+ *
+ * Stores enabled values as an array. Toggle logic automatically adds/removes
+ * values when switches are toggled.
+ *
+ * @example
+ * ```tsx
+ * <FormProvider {...methods}>
+ *   <Field.MultiSwitch
+ *     name="notifications"
+ *     label="Notification Settings"
+ *     options={[
+ *       { label: 'Email notifications', value: 'email' },
+ *       { label: 'Push notifications', value: 'push' },
+ *       { label: 'SMS notifications', value: 'sms' },
+ *     ]}
+ *   />
+ * </FormProvider>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Horizontal layout with custom styling
+ * <Field.MultiSwitch
+ *   name="features"
+ *   label="Feature Toggles"
+ *   row
+ *   options={[
+ *     { label: 'Beta Features', value: 'beta' },
+ *     { label: 'Analytics', value: 'analytics' },
+ *     { label: 'Debug Mode', value: 'debug', disabled: true },
+ *   ]}
+ *   slotProps={{
+ *     switch: { color: 'success' },
+ *   }}
+ * />
+ * ```
+ */
+export declare function FieldMultiSwitch({ name, label, options, helperText, slotProps, row, ...other }: FieldMultiSwitchProps): ReactNode;
+//# sourceMappingURL=field-multi-switch.d.ts.map

package/dist/components/field/field-multi-switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-multi-switch.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-multi-switch.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAS9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAM9D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC;IAC7E,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,wCAAwC;IACxC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,uCAAuC;IACvC,SAAS,CAAC,EAAE;QACV,gCAAgC;QAChC,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACpC,8BAA8B;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC9B,sBAAsB;QACtB,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QACpC,2BAA2B;QAC3B,UAAU,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC1C,0BAA0B;QAC1B,SAAS,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;KAC/B,CAAC;CACH;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,KAAK,EACL,OAAO,EACP,UAAU,EACV,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,qBAAqB,GAAG,SAAS,CAsEnC"}

package/dist/components/field/field-number.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Field.Number Component
+ *
+ * React Hook Form integrated number field with proper numeric handling
+ * and full accessibility support.
+ *
+ * @module components/field
+ */
+import type { ReactNode, ComponentProps } from 'react';
+import { type RegisterOptions } from 'react-hook-form';
+import TextField from '@mui/material/TextField';
+/**
+ * Props for Field.Number component.
+ */
+export interface FieldNumberProps extends Omit<ComponentProps<typeof TextField>, 'name' | 'type'> {
+    /** Field name in the form */
+    name: string;
+    /** Minimum allowed value */
+    min?: number;
+    /** Maximum allowed value */
+    max?: number;
+    /** Decimal places to allow */
+    decimals?: number;
+    /** Allow negative numbers */
+    allowNegative?: boolean;
+    /** Default value when input is empty */
+    defaultValue?: number;
+    /** Validation rules for react-hook-form */
+    rules?: RegisterOptions;
+}
+/**
+ * Field.Number - Number input with proper numeric handling.
+ * Uses transformNumber utilities for three-phase input handling.
+ *
+ * Includes comprehensive accessibility attributes:
+ * - aria-describedby for helper text and error messages
+ * - aria-invalid for error states
+ * - aria-valuemin/max for range constraints
+ * - Proper inputMode for numeric keyboard
+ *
+ * @example
+ * ```tsx
+ * <FormProvider {...methods}>
+ *   <Field.Number name="quantity" label="Quantity" min={1} max={100} />
+ *   <Field.Number name="price" label="Price" decimals={2} min={0} />
+ * </FormProvider>
+ * ```
+ */
+export declare function FieldNumber({ name, min, max, decimals, allowNegative, defaultValue, rules, error: _error, ...other }: FieldNumberProps): ReactNode;
+//# sourceMappingURL=field-number.d.ts.map

package/dist/components/field/field-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-number.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-number.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEvD,OAAO,EAGL,KAAK,eAAe,EAIrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,SAAS,MAAM,yBAAyB,CAAC;AAIhD;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,cAAc,CAAC,OAAO,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/F,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AA+HD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,GAAG,EACH,GAAG,EACH,QAAQ,EACR,aAAoB,EACpB,YAAgB,EAChB,KAAK,EAEL,KAAK,EAAE,MAAM,EACb,GAAG,KAAK,EACT,EAAE,gBAAgB,GAAG,SAAS,CAuB9B"}

package/dist/components/field/field-phone.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Field.Phone Component
+ *
+ * React Hook Form integrated international phone number input.
+ * Provides country selection with flag display and validation.
+ *
+ * @module components/field
+ */
+import type { ReactNode } from 'react';
+import type { TextFieldProps } from '@mui/material/TextField';
+/**
+ * Country data structure
+ */
+export interface CountryData {
+    /** ISO 3166-1 alpha-2 code */
+    code: string;
+    /** Country name */
+    name: string;
+    /** Dial code with + prefix */
+    dialCode: string;
+    /** Flag emoji */
+    flag: string;
+}
+/**
+ * Props for Field.Phone component.
+ */
+export interface FieldPhoneProps extends Omit<TextFieldProps, 'name' | 'value' | 'onChange'> {
+    /** Field name in the form */
+    name: string;
+    /** Default country code (e.g., 'US') */
+    defaultCountry?: string;
+    /** Preferred countries shown at top of list */
+    preferredCountries?: string[];
+    /** Hide country selector */
+    hideCountrySelect?: boolean;
+    /** Custom countries data (overrides default) */
+    countries?: CountryData[];
+}
+/**
+ * Field.Phone - International phone input with React Hook Form integration.
+ *
+ * Features:
+ * - Country selector with flags
+ * - Automatic country detection from dial code
+ * - Preferred countries list
+ * - Phone number formatting
+ *
+ * @example
+ * ```tsx
+ * <FormProvider {...methods}>
+ *   <Field.Phone
+ *     name="phone"
+ *     label="Phone Number"
+ *     defaultCountry="US"
+ *   />
+ * </FormProvider>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With preferred countries
+ * <Field.Phone
+ *   name="mobile"
+ *   label="Mobile"
+ *   defaultCountry="GB"
+ *   preferredCountries={['GB', 'US', 'DE', 'FR']}
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Hide country selector
+ * <Field.Phone
+ *   name="phone"
+ *   label="Phone"
+ *   hideCountrySelect
+ *   defaultCountry="US"
+ * />
+ * ```
+ */
+export declare function FieldPhone({ name, label, helperText, defaultCountry, preferredCountries, hideCountrySelect, countries: customCountries, disabled, ...other }: FieldPhoneProps): ReactNode;
+//# sourceMappingURL=field-phone.d.ts.map

package/dist/components/field/field-phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-phone.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-phone.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,OAAO,CAAC;AAYpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAM9D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IAC1F,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,4BAA4B;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gDAAgD;IAChD,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;CAC3B;AAgGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,KAAK,EACL,UAAU,EACV,cAAqB,EACrB,kBAAuB,EACvB,iBAAyB,EACzB,SAAS,EAAE,eAAe,EAC1B,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,eAAe,GAAG,SAAS,CAyJ7B"}