@omnitron-dev/prism 0.2.0 → 0.3.1

package/dist/components/error-boundary/error-boundary.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Error Boundary Component
+ *
+ * React error boundary for graceful error handling.
+ * Includes stack trace parsing for improved debugging.
+ *
+ * @module components/error-boundary
+ */
+import { Component, type ReactNode, type ErrorInfo } from 'react';
+import type { SxProps, Theme } from '@mui/material/styles';
+/**
+ * Parsed stack frame information.
+ */
+export interface StackFrame {
+    /** Function or method name */
+    functionName: string | null;
+    /** Source file path */
+    filePath: string | null;
+    /** Line number in the file */
+    lineNumber: number | null;
+    /** Column number in the file */
+    columnNumber: number | null;
+    /** Whether this frame is from app code (src/) vs node_modules */
+    isAppCode: boolean;
+}
+/**
+ * Parsed stack trace result.
+ */
+export interface ParsedStackTrace {
+    /** Primary error location (first app code frame) */
+    primary: StackFrame | null;
+    /** All parsed frames */
+    frames: StackFrame[];
+    /** Original stack trace string */
+    raw: string;
+}
+/**
+ * Parse an error stack trace into structured data.
+ *
+ * Extracts function names, file paths, and line numbers from stack traces.
+ * Identifies app code vs library code for better debugging.
+ *
+ * @param stack - Error stack trace string
+ * @returns Parsed stack trace with frames
+ *
+ * @example
+ * ```tsx
+ * try {
+ *   throw new Error('Something went wrong');
+ * } catch (error) {
+ *   const parsed = parseStackTrace(error.stack);
+ *   console.log('Error in:', parsed.primary?.filePath);
+ *   console.log('Function:', parsed.primary?.functionName);
+ *   console.log('Line:', parsed.primary?.lineNumber);
+ * }
+ * ```
+ */
+export declare function parseStackTrace(stack?: string): ParsedStackTrace;
+/**
+ * Get a summary of the error location.
+ *
+ * @param error - Error object
+ * @returns Human-readable error location
+ */
+export declare function getErrorLocation(error: Error): string;
+/**
+ * Error fallback component props.
+ */
+export interface FallbackProps {
+    /** The error that was caught */
+    error: Error;
+    /** Error info from React */
+    errorInfo: ErrorInfo | null;
+    /** Parsed stack trace for debugging */
+    parsedStack: ParsedStackTrace;
+    /** Reset error boundary state */
+    resetErrorBoundary: () => void;
+}
+/**
+ * Error boundary props.
+ */
+export interface ErrorBoundaryProps {
+    /** Child components to render */
+    children: ReactNode;
+    /** Custom fallback component */
+    fallback?: ReactNode | ((props: FallbackProps) => ReactNode);
+    /** Callback when error is caught */
+    onError?: (error: Error, errorInfo: ErrorInfo, parsedStack: ParsedStackTrace) => void;
+    /** Callback when error is reset */
+    onReset?: () => void;
+    /** Reset keys - boundary resets when these change */
+    resetKeys?: unknown[];
+    /** Custom sx props for default fallback */
+    sx?: SxProps<Theme>;
+    /** Show detailed stack info in default fallback (auto-detects dev mode if not set) */
+    showDetails?: boolean;
+}
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+    errorInfo: ErrorInfo | null;
+}
+/**
+ * Error Boundary - Catches JavaScript errors in child components.
+ *
+ * @example
+ * ```tsx
+ * <ErrorBoundary
+ *   fallback={({ error, resetErrorBoundary }) => (
+ *     <div>
+ *       <p>Error: {error.message}</p>
+ *       <button onClick={resetErrorBoundary}>Retry</button>
+ *     </div>
+ *   )}
+ *   onError={(error, info) => logErrorToService(error, info)}
+ * >
+ *   <MyComponent />
+ * </ErrorBoundary>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With reset keys
+ * <ErrorBoundary resetKeys={[userId, postId]}>
+ *   <UserPost userId={userId} postId={postId} />
+ * </ErrorBoundary>
+ * ```
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): Partial<ErrorBoundaryState>;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    componentDidUpdate(prevProps: ErrorBoundaryProps): void;
+    resetErrorBoundary: () => void;
+    render(): ReactNode;
+}
+/**
+ * Hook to throw errors from event handlers.
+ * Useful for triggering error boundary from async code.
+ *
+ * @returns Function to throw an error
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const throwError = useErrorBoundary();
+ *
+ *   const handleClick = async () => {
+ *     try {
+ *       await fetchData();
+ *     } catch (error) {
+ *       throwError(error as Error);
+ *     }
+ *   };
+ *
+ *   return <button onClick={handleClick}>Fetch</button>;
+ * }
+ * ```
+ */
+export declare function useErrorBoundary(): (error: Error) => void;
+export {};
+//# sourceMappingURL=error-boundary.d.ts.map

package/dist/components/error-boundary/error-boundary.d.ts.map

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

package/dist/components/error-boundary/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Error Boundary Component
+ *
+ * @module components/error-boundary
+ */
+export { ErrorBoundary, useErrorBoundary, parseStackTrace, getErrorLocation, type ErrorBoundaryProps, type FallbackProps, type StackFrame, type ParsedStackTrace, } from './error-boundary.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/error-boundary/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/error-boundary/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,74 @@
+/**
+ * Field.Autocomplete Component
+ *
+ * React Hook Form integrated autocomplete with search.
+ *
+ * @module components/field
+ */
+import type { ReactNode } from 'react';
+import type { TextFieldProps } from '@mui/material/TextField';
+/**
+ * Option for autocomplete.
+ */
+export interface AutocompleteOption {
+    /** Option value */
+    value: string | number;
+    /** Display label */
+    label: string;
+    /** Optional group */
+    group?: string;
+    /** Disabled state */
+    disabled?: boolean;
+}
+/**
+ * Props for Field.Autocomplete component.
+ */
+export interface FieldAutocompleteProps {
+    /** Field name in the form */
+    name: string;
+    /** Autocomplete options */
+    options: AutocompleteOption[];
+    /** Field label */
+    label?: string;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Helper text */
+    helperText?: string;
+    /** Props passed to TextField */
+    textFieldProps?: Partial<TextFieldProps>;
+    /** 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';
+}
+/**
+ * Field.Autocomplete - Autocomplete with React Hook Form integration.
+ *
+ * @example
+ * ```tsx
+ * <FormProvider {...methods}>
+ *   <Field.Autocomplete
+ *     name="country"
+ *     label="Country"
+ *     options={countries}
+ *     placeholder="Select a country..."
+ *   />
+ * </FormProvider>
+ * ```
+ */
+export declare function FieldAutocomplete({ name, options, label, placeholder, helperText, textFieldProps, disableClearable, disableCloseOnSelect, loading, loadingText, noOptionsText, disabled, readOnly, fullWidth, size, }: FieldAutocompleteProps): ReactNode;
+//# sourceMappingURL=field-autocomplete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field-autocomplete.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-autocomplete.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,OAAO,CAAC;AAIvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,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,sBAAsB;IACrC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,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,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;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,OAAO,EACP,KAAK,EACL,WAAW,EACX,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,OAAO,EACP,WAAW,EACX,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,SAAgB,EAChB,IAAI,GACL,EAAE,sBAAsB,GAAG,SAAS,CA8CpC"}

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

@@ -0,0 +1,42 @@
+/**
+ * Field.Checkbox Component
+ *
+ * React Hook Form integrated checkbox field with full accessibility support.
+ *
+ * @module components/field
+ */
+import type { ReactNode, ComponentProps } from 'react';
+import { type RegisterOptions } from 'react-hook-form';
+import Checkbox from '@mui/material/Checkbox';
+/**
+ * Props for Field.Checkbox component.
+ */
+export interface FieldCheckboxProps extends Omit<ComponentProps<typeof Checkbox>, 'name'> {
+    /** Field name in the form */
+    name: string;
+    /** Checkbox label */
+    label?: ReactNode;
+    /** Helper text */
+    helperText?: string;
+    /** Validation rules for react-hook-form */
+    rules?: RegisterOptions;
+}
+/**
+ * Field.Checkbox - Checkbox with React Hook Form integration.
+ *
+ * Includes comprehensive accessibility attributes:
+ * - aria-describedby for helper text and error messages
+ * - aria-invalid for error states
+ * - aria-required for required fields
+ * - Proper label associations
+ *
+ * @example
+ * ```tsx
+ * <FormProvider {...methods}>
+ *   <Field.Checkbox name="terms" label="I agree to the terms" />
+ *   <Field.Checkbox name="newsletter" label="Subscribe to newsletter" />
+ * </FormProvider>
+ * ```
+ */
+export declare function FieldCheckbox({ name, label, helperText, rules, required, indeterminate, ...other }: FieldCheckboxProps): ReactNode;
+//# sourceMappingURL=field-checkbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field-checkbox.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-checkbox.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEvD,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,QAAQ,MAAM,wBAAwB,CAAC;AAK9C;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,cAAc,CAAC,OAAO,QAAQ,CAAC,EAAE,MAAM,CAAC;IACvF,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,KAAK,EACL,UAAU,EACV,KAAK,EACL,QAAQ,EACR,aAAa,EACb,GAAG,KAAK,EACT,EAAE,kBAAkB,GAAG,SAAS,CAwChC"}

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

@@ -0,0 +1,80 @@
+/**
+ * Field.Code Component
+ *
+ * React Hook Form integrated OTP (One-Time Password) input.
+ * Provides a professional code/PIN entry experience.
+ *
+ * @module components/field
+ */
+import type { ReactNode } from 'react';
+import type { BoxProps } from '@mui/material/Box';
+import type { TextFieldProps } from '@mui/material/TextField';
+import type { FormHelperTextProps } from '@mui/material/FormHelperText';
+/**
+ * Props for Field.Code component.
+ */
+export interface FieldCodeProps {
+    /** Field name in the form */
+    name: string;
+    /** Number of code digits (default: 6) */
+    length?: number;
+    /** Placeholder character (default: '-') */
+    placeholder?: string;
+    /** Helper text shown below the input */
+    helperText?: ReactNode;
+    /** Auto-focus the first input on mount */
+    autoFocus?: boolean;
+    /** Disable all inputs */
+    disabled?: boolean;
+    /** Input type: text, number, or password */
+    type?: 'text' | 'number' | 'password';
+    /** Gap between inputs (CSS value) */
+    gap?: number | string;
+    /** Width of each input field (CSS value) */
+    inputWidth?: number | string;
+    /** Slot props for nested components */
+    slotProps?: {
+        /** Wrapper Box props */
+        wrapper?: Partial<BoxProps>;
+        /** Individual TextField props */
+        textField?: Partial<TextFieldProps>;
+        /** FormHelperText props */
+        helperText?: Partial<FormHelperTextProps>;
+    };
+}
+/**
+ * Field.Code - OTP/PIN code input with React Hook Form integration.
+ *
+ * Features:
+ * - Automatic focus navigation between digits
+ * - Paste support for full codes
+ * - Backspace navigation
+ * - Configurable length and styling
+ *
+ * @example
+ * ```tsx
+ * <FormProvider {...methods}>
+ *   <Field.Code
+ *     name="verificationCode"
+ *     autoFocus
+ *   />
+ * </FormProvider>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With custom styling
+ * <Field.Code
+ *   name="pin"
+ *   length={4}
+ *   type="password"
+ *   inputWidth={56}
+ *   gap={2}
+ *   slotProps={{
+ *     textField: { variant: 'filled' },
+ *   }}
+ * />
+ * ```
+ */
+export declare function FieldCode({ name, length, placeholder, helperText, autoFocus, disabled, type, gap, inputWidth, slotProps, }: FieldCodeProps): ReactNode;
+//# sourceMappingURL=field-code.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field-code.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-code.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAA8C,MAAM,OAAO,CAAC;AAMnF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAMxE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtC,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,uCAAuC;IACvC,SAAS,CAAC,EAAE;QACV,wBAAwB;QACxB,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5B,iCAAiC;QACjC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QACpC,2BAA2B;QAC3B,UAAU,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;KAC3C,CAAC;CACH;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,MAAU,EACV,WAAiB,EACjB,UAAU,EACV,SAAiB,EACjB,QAAgB,EAChB,IAAa,EACb,GAAS,EACT,UAAe,EACf,SAAS,GACV,EAAE,cAAc,GAAG,SAAS,CAyK5B"}

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

@@ -0,0 +1,84 @@
+/**
+ * Field.CountrySelect Component
+ *
+ * React Hook Form integrated country selector with flag icons.
+ * Provides searchable country selection with ISO code support.
+ *
+ * @module components/field
+ */
+import type { ReactNode } from 'react';
+import type { AutocompleteProps } from '@mui/material/Autocomplete';
+import type { TextFieldProps } from '@mui/material/TextField';
+/**
+ * Country data structure
+ */
+export interface Country {
+    /** ISO 3166-1 alpha-2 code */
+    code: string;
+    /** Country name */
+    label: string;
+    /** Dial code with + prefix */
+    phone: string;
+    /** Flag emoji */
+    flag: string;
+}
+/**
+ * Props for Field.CountrySelect component.
+ */
+export interface FieldCountrySelectProps extends Omit<AutocompleteProps<Country, boolean, boolean, false>, 'options' | 'renderInput' | 'value' | 'onChange' | 'getOptionLabel' | 'isOptionEqualToValue'> {
+    /** Field name in the form */
+    name: string;
+    /** Field label */
+    label?: string;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Helper text shown below the field */
+    helperText?: ReactNode;
+    /** Return value type: 'code' returns ISO code, 'label' returns country name */
+    getValue?: 'code' | 'label' | 'full';
+    /** Custom countries data (overrides default) */
+    countries?: Country[];
+    /** TextField props for customization */
+    textFieldProps?: Partial<TextFieldProps>;
+}
+/**
+ * Field.CountrySelect - Country selector with React Hook Form integration.
+ *
+ * Features:
+ * - Searchable country list with flag icons
+ * - Return ISO code, country name, or full object
+ * - Custom country data support
+ *
+ * @example
+ * ```tsx
+ * <FormProvider {...methods}>
+ *   <Field.CountrySelect
+ *     name="country"
+ *     label="Country"
+ *   />
+ * </FormProvider>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Return ISO code instead of full object
+ * <Field.CountrySelect
+ *   name="countryCode"
+ *   label="Country"
+ *   getValue="code"
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Multiple selection
+ * <Field.CountrySelect
+ *   name="visitedCountries"
+ *   label="Countries Visited"
+ *   multiple
+ *   getValue="code"
+ * />
+ * ```
+ */
+export declare function FieldCountrySelect({ name, label, placeholder, helperText, getValue, countries: customCountries, textFieldProps, multiple, disabled, ...other }: FieldCountrySelectProps): ReactNode;
+//# sourceMappingURL=field-country-select.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field-country-select.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-country-select.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,OAAO,CAAC;AAMvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAM9D;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CACnD,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EACnD,SAAS,GAAG,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,gBAAgB,GAAG,sBAAsB,CAC7F;IACC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACrC,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CAC1C;AA4KD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,KAAK,EACL,WAAW,EACX,UAAU,EACV,QAAiB,EACjB,SAAS,EAAE,eAAe,EAC1B,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,uBAAuB,GAAG,SAAS,CAkHrC"}

package/dist/components/field/field-date-picker.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Field.DatePicker Component
+ *
+ * React Hook Form integrated date picker using MUI X DatePickers.
+ * Consistent with Field.DateTimePicker and Field.TimePicker.
+ *
+ * @module components/field
+ */
+import type { ReactNode } from 'react';
+import type { TextFieldProps } from '@mui/material/TextField';
+import type { Dayjs } from 'dayjs';
+/**
+ * Props for Field.DatePicker component.
+ */
+export interface FieldDatePickerProps {
+    /** Field name in the form */
+    name: string;
+    /** Field label */
+    label?: ReactNode;
+    /** Helper text shown below the field */
+    helperText?: ReactNode;
+    /** TextField props for customization */
+    textFieldProps?: Partial<TextFieldProps>;
+    /** Disable the field */
+    disabled?: boolean;
+    /** Read-only mode */
+    readOnly?: boolean;
+    /** Minimum selectable date */
+    minDate?: Dayjs;
+    /** Maximum selectable date */
+    maxDate?: Dayjs;
+    /** Disable past dates */
+    disablePast?: boolean;
+    /** Disable future dates */
+    disableFuture?: boolean;
+    /** Views to display */
+    views?: Array<'year' | 'month' | 'day'>;
+    /** Open picker to specific view */
+    openTo?: 'year' | 'month' | 'day';
+    /** Format for display */
+    format?: string;
+}
+/**
+ * Field.DatePicker - Date picker with React Hook Form integration.
+ *
+ * Uses @mui/x-date-pickers DatePicker for a polished calendar UI.
+ * Stores value as ISO string for serialization compatibility.
+ *
+ * @example
+ * ```tsx
+ * <FormProvider {...methods}>
+ *   <Field.DatePicker name="birthDate" label="Birth Date" />
+ *   <Field.DatePicker name="deadline" label="Deadline" disablePast />
+ * </FormProvider>
+ * ```
+ */
+export declare function FieldDatePicker({ name, label, helperText, textFieldProps, disabled, readOnly, minDate, maxDate, disablePast, disableFuture, views, openTo, format, }: FieldDatePickerProps): ReactNode;
+//# sourceMappingURL=field-date-picker.d.ts.map

package/dist/components/field/field-date-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-date-picker.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-date-picker.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAQnC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,wCAAwC;IACxC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC,wBAAwB;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,yBAAyB;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2BAA2B;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uBAAuB;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,CAAC;IACxC,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IAClC,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAqBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,KAAK,EACL,UAAU,EACV,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,OAAO,EACP,WAAW,EACX,aAAa,EACb,KAAK,EACL,MAAM,EACN,MAAM,GACP,EAAE,oBAAoB,GAAG,SAAS,CA+ClC"}

package/dist/components/field/field-datetime-picker.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Field.DateTimePicker Component
+ *
+ * React Hook Form integrated date-time picker using MUI X DatePickers.
+ * Combines date and time selection in a single component.
+ *
+ * @module components/field
+ */
+import type { ReactNode } from 'react';
+import type { TextFieldProps } from '@mui/material/TextField';
+import type { Dayjs } from 'dayjs';
+/**
+ * Props for Field.DateTimePicker component.
+ */
+export interface FieldDateTimePickerProps {
+    /** Field name in the form */
+    name: string;
+    /** Field label */
+    label?: ReactNode;
+    /** Helper text shown below the field */
+    helperText?: ReactNode;
+    /** TextField props for customization */
+    textFieldProps?: Partial<TextFieldProps>;
+    /** Disable the field */
+    disabled?: boolean;
+    /** Read-only mode */
+    readOnly?: boolean;
+    /** Minutes step for time selection */
+    minutesStep?: number;
+    /** Use 12-hour format with AM/PM */
+    ampm?: boolean;
+    /** Minimum selectable datetime */
+    minDateTime?: Dayjs;
+    /** Maximum selectable datetime */
+    maxDateTime?: Dayjs;
+    /** Disable past dates */
+    disablePast?: boolean;
+    /** Disable future dates */
+    disableFuture?: boolean;
+    /** Views to display */
+    views?: Array<'year' | 'month' | 'day' | 'hours' | 'minutes' | 'seconds'>;
+    /** Open picker to specific view */
+    openTo?: 'year' | 'month' | 'day' | 'hours' | 'minutes' | 'seconds';
+    /** Format for display */
+    format?: string;
+}
+/**
+ * Field.DateTimePicker - Combined date and time picker with React Hook Form integration.
+ *
+ * Uses @mui/x-date-pickers DateTimePicker for comprehensive date-time selection.
+ * Automatically normalizes various date/time value types to Dayjs.
+ *
+ * @example
+ * ```tsx
+ * <FormProvider {...methods}>
+ *   <Field.DateTimePicker
+ *     name="eventStart"
+ *     label="Event Start"
+ *   />
+ *   <Field.DateTimePicker
+ *     name="eventEnd"
+ *     label="Event End"
+ *     ampm={false}
+ *     minutesStep={15}
+ *   />
+ * </FormProvider>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With date constraints
+ * <Field.DateTimePicker
+ *   name="appointment"
+ *   label="Appointment"
+ *   minDateTime={dayjs()}
+ *   maxDateTime={dayjs().add(30, 'day')}
+ *   disablePast
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With custom views
+ * <Field.DateTimePicker
+ *   name="scheduledAt"
+ *   label="Schedule"
+ *   views={['year', 'month', 'day', 'hours', 'minutes']}
+ *   textFieldProps={{
+ *     variant: 'filled',
+ *     size: 'small',
+ *   }}
+ * />
+ * ```
+ */
+export declare function FieldDateTimePicker({ name, label, helperText, textFieldProps, disabled, readOnly, minutesStep, ampm, minDateTime, maxDateTime, disablePast, disableFuture, views, openTo, format, }: FieldDateTimePickerProps): ReactNode;
+//# sourceMappingURL=field-datetime-picker.d.ts.map

package/dist/components/field/field-datetime-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-datetime-picker.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-datetime-picker.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAWnC;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,wCAAwC;IACxC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC,wBAAwB;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kCAAkC;IAClC,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,kCAAkC;IAClC,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,yBAAyB;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2BAA2B;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uBAAuB;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;IAC1E,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACpE,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,IAAI,EACJ,KAAK,EACL,UAAU,EACV,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,KAAK,EACL,MAAM,EACN,MAAM,GACP,EAAE,wBAAwB,GAAG,SAAS,CA0CtC"}