@dragonmastery/zinia-forms-core 0.3.4 → 0.3.6

package/dist/index.d.ts

@@ -116,7 +116,6 @@ interface ArrayFieldProps<FormType, ItemType> {
     minItems?: number;
     maxItems?: number;
     allowReordering?: boolean;
-    autoPrefixFields?: boolean;
     ariaLabels?: {
         addButton?: string;
         removeButton?: string;
@@ -139,6 +138,430 @@ interface CheckboxFieldProps<FormType> {
     variant?: string;
 }
 
+interface DateFieldProps<FormType> {
+    name: FlexiblePath<FormType>;
+    label?: string;
+    hideLabel?: boolean;
+    description?: string;
+    required?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    class?: string | string[];
+    size?: string;
+    variant?: string;
+    min?: string;
+    max?: string;
+    formatter?: (date: string) => unknown;
+}
+
+interface NumberFieldProps<FormType> {
+    name: FlexiblePath<FormType>;
+    label?: string;
+    hideLabel?: boolean;
+    description?: string;
+    required?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    class?: string | string[];
+    size?: string;
+    variant?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+
+/**
+ * Option item for select fields
+ * @template TData - Type of the optional data object for storing additional metadata
+ *                    Useful for cascading dropdowns where options need to be filtered by parent field values
+ *
+ * @example
+ * // With typed data
+ * interface CityData {
+ *   country: string;
+ *   population: number;
+ * }
+ * const options: SelectOption<CityData>[] = [
+ *   { value: 'nyc', label: 'New York', data: { country: 'usa', population: 8000000 } }
+ * ];
+ *
+ * @example
+ * // Without data (backward compatible)
+ * const options: SelectOption[] = [
+ *   { value: 'option1', label: 'Option 1' }
+ * ];
+ */
+interface SelectOption<TData = Record<string, any>> {
+    value: string;
+    label: string;
+    /**
+     * Optional data object for storing additional metadata
+     * Useful for cascading dropdowns where options need to be filtered by parent field values
+     */
+    data?: TData;
+}
+/**
+ * Extract enum values from a Zod enum schema
+ */
+type ZodEnumValues<T extends z.ZodEnum<[string, ...string[]]>> = T['_def']['values'][number];
+/**
+ * Type for a mapping of enum values to labels
+ */
+type EnumValueToLabelMap<T extends string> = Record<T, string>;
+/**
+ * Type for a value-to-label mapping that can be either a function or an object map
+ */
+type ValueToLabelMapping<T extends string = string> = ((value: string) => string) | EnumValueToLabelMap<T>;
+/**
+ * Helper type to extract the type of a field at a given path
+ */
+type FieldType<T, P extends string> = P extends keyof T ? T[P] : P extends `${infer A}.${infer B}` ? A extends keyof T ? FieldType<T[A], B> : never : never;
+/**
+ * Helper type to extract enum values from a field type
+ */
+type EnumValuesFromField<T> = T extends string ? T : never;
+/**
+ * Type that maps field paths to their corresponding enum types
+ */
+type FieldPathToEnum$1<T, P extends Path<T>> = EnumValuesFromField<FieldType<T, P & string>>;
+/**
+ * Props for the SelectField component
+ * @template FormType - The form type
+ * @template P - The field path in the form
+ * @template TData - The type of the data property in SelectOption (for cascading dropdowns)
+ */
+interface SelectFieldProps<FormType, P extends Path<FormType> = Path<FormType>, TData = any> {
+    /**
+     * Field name (path in the form state)
+     * Accepts both static paths and dynamic paths for use in array fields
+     */
+    name: FlexiblePath<FormType>;
+    /**
+     * Field label
+     */
+    label?: string;
+    /**
+     * Whether to hide the label
+     */
+    hideLabel?: boolean;
+    /**
+     * Field description
+     */
+    description?: string;
+    /**
+     * Whether the field is required
+     */
+    required?: boolean;
+    /**
+     * Placeholder text
+     */
+    placeholder?: string;
+    /**
+     * Whether the field is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Whether the field is readonly
+     */
+    readonly?: boolean;
+    /**
+     * CSS classes to apply to the field
+     */
+    class?: string | string[];
+    /**
+     * Field size
+     */
+    size?: string;
+    /**
+     * Field variant
+     */
+    variant?: string;
+    /**
+     * Select options (overrides options from schema)
+     * Using selectOptions instead of options to avoid conflicts with HTML select element
+     *
+     * @example
+     * // With typed data
+     * interface CityData { country: string; }
+     * const options: SelectOption<CityData>[] = [
+     *   { value: 'nyc', label: 'New York', data: { country: 'usa' } }
+     * ];
+     */
+    selectOptions?: SelectOption<TData>[];
+    /**
+     * Custom mapping function to convert values to labels
+     * This is useful when you want to customize how labels are displayed
+     * without providing a full options array
+     *
+     * Can be provided as either:
+     * 1. A function that takes a value and returns a label
+     * 2. An object map where keys are enum values and values are labels
+     */
+    valueToLabel?: ValueToLabelMapping<FieldPathToEnum$1<FormType, P>>;
+    /**
+     * Whether to use options from the schema (default: true)
+     * Set to false to ignore schema options even when no options prop is provided
+     */
+    useSchemaOptions?: boolean;
+    /**
+     * Field path that this field depends on for cascading dropdowns
+     * When the parent field changes, this field's options will be filtered
+     * and the field will be reset (unless autoReset is false)
+     *
+     * @example
+     * // City field depends on country field
+     * <SelectField name="city" dependsOn="country" :optionFilterFn="filterCitiesByCountry" />
+     */
+    dependsOn?: FlexiblePath<FormType>;
+    /**
+     * Function to filter options based on the parent field's value
+     * Receives the parent field value and all available options
+     * Should return the filtered options array
+     *
+     * The function signature is tied to the TData type parameter, ensuring type safety
+     * between selectOptions and optionFilterFn
+     *
+     * @example
+     * // With typed data - both props must use the same data type
+     * interface CityData { country: string; }
+     * const filterCitiesByCountry = (
+     *   countryValue: string,
+     *   allOptions: SelectOption<CityData>[]
+     * ): SelectOption<CityData>[] => {
+     *   return allOptions.filter(opt => opt.data?.country === countryValue);
+     * };
+     *
+     * @example
+     * // Without typed data (backward compatible)
+     * const filterCitiesByCountry = (
+     *   countryValue: string,
+     *   allOptions: SelectOption[]
+     * ): SelectOption[] => {
+     *   return allOptions.filter(opt => opt.value.startsWith(countryValue));
+     * };
+     */
+    optionFilterFn?: (parentValue: any, allOptions: SelectOption<TData>[]) => SelectOption<TData>[];
+    /**
+     * Whether to automatically reset this field when the parent field changes (default: true)
+     * Set to false if you want to preserve the value when parent changes
+     */
+    autoReset?: boolean;
+}
+/**
+ * Array of prop names for SelectField component.
+ * This is derived from SelectFieldProps interface and ensures type safety.
+ * Used for prop normalization and filtering in component implementations.
+ *
+ * TypeScript ensures all entries are valid keys of SelectFieldProps.
+ */
+declare const SELECT_FIELD_PROP_NAMES: readonly ["name", "selectOptions", "placeholder", "disabled", "readonly", "class", "label", "hideLabel", "description", "required", "size", "variant", "valueToLabel", "useSchemaOptions", "dependsOn", "optionFilterFn", "autoReset"];
+
+/**
+ * Type to convert underscores to PascalCase
+ * This helper type processes a single segment by capitalizing after underscores
+ */
+type SegmentToPascalCase<S extends string> = S extends `${infer First}_${infer Rest}` ? `${Capitalize<First>}${SegmentToPascalCase<Rest>}` : Capitalize<S>;
+/**
+ * Type to convert a dot-separated path to PascalCase
+ * This uses recursion to handle any level of nesting
+ * Also handles underscores by removing them and capitalizing each segment
+ */
+type PathToPascalCase<P extends string> = P extends `${infer A}.${infer B}` ? `${SegmentToPascalCase<A>}${PathToPascalCase<B>}` : `${SegmentToPascalCase<P>}Field`;
+/**
+ * Type that maps field paths to their corresponding enum types
+ */
+type FieldPathToEnum<T, P extends Path<T>> = P extends keyof T ? T[P] extends string ? T[P] : string : string;
+/**
+ * Type that extracts the array element type from a field path
+ * If the path points to an array, it extracts the element type
+ * @example
+ * ArrayItemType<{users: User[]}, 'users'> = User
+ * ArrayItemType<{tasks: Task[]}, 'tasks'> = Task
+ */
+type ArrayItemType<T, P extends Path<T>> = P extends keyof T ? T[P] extends ReadonlyArray<infer Item> ? Item : T[P] extends Array<infer Item> ? Item : never : never;
+/**
+ * Type-safe fields object that provides autocomplete for field names
+ * Maps each key of T to a string (the prefixed field name)
+ * All fields return strings regardless of whether the actual field is optional
+ */
+type FieldNames<T> = T extends Record<string, any> ? {
+    [K in keyof T]-?: string;
+} : Record<string, string>;
+/**
+ * Type for array field components with properly typed slots
+ */
+type ArrayFieldComponent<T, P extends Path<T>> = vue.FunctionalComponent<Omit<ArrayFieldProps<T, ArrayItemType<T, P>>, 'name'>, {}, {
+    itemRenderer: (props: {
+        item: ArrayItemType<T, P>;
+        index: number;
+        fields: FieldNames<ArrayItemType<T, P>>;
+    }) => any;
+    availableItemRenderer: (props: {
+        item: ArrayItemType<T, P>;
+        index: number;
+    }) => any;
+    default: () => any;
+}, {}>;
+/**
+ * Type for enum field components that require valueToLabel
+ */
+type EnumFieldComponent<T, P extends Path<T>> = (props: Omit<SelectFieldProps<T>, 'name' | 'valueToLabel'> & {
+    valueToLabel: Record<FieldPathToEnum<T, P>, string>;
+}, context?: any) => any;
+/**
+ * Type for select field components (can work with string or enum fields)
+ * Uses SelectFieldProps<T, P, TData> to preserve path-specific typing for props like dependsOn
+ * and ensure type safety between selectOptions and optionFilterFn
+ */
+type SelectFieldComponent<T, P extends Path<T>> = <TData = any>(props: Omit<SelectFieldProps<T, P, TData>, 'name'>, context?: any) => any;
+/**
+ * Type for number field components
+ */
+type NumberFieldComponent<T> = (props: Omit<NumberFieldProps<T>, 'name'>, context?: any) => any;
+/**
+ * Type for checkbox field components
+ */
+type CheckboxFieldComponent<T> = (props: Omit<CheckboxFieldProps<T>, 'name'>, context?: any) => any;
+/**
+ * Type for date field components
+ */
+type DateFieldComponent<T> = (props: Omit<DateFieldProps<T>, 'name'>, context?: any) => any;
+/**
+ * Generic field component type - fallback for any other field types
+ */
+type GenericFieldComponent = (props: any, context?: any) => any;
+/**
+ * Helper to unwrap optional/nullable types
+ * Removes undefined and null from union types
+ * Examples:
+ *   string | undefined → string
+ *   string | null → string
+ *   string | undefined | null → string
+ */
+type UnwrapOptional<T> = Exclude<T, undefined | null>;
+/**
+ * Maps a field path to its component type based on the field's actual type
+ * Enums are explicitly passed as FieldType = 'enum' since they can't be auto-detected
+ * Everything else is inferred from the actual TypeScript type at the path
+ *
+ * For string fields, we use SelectFieldComponent<T, P> which is a superset that includes
+ * all TextField functionality plus additional props like dependsOn for cascading dropdowns.
+ * This provides better type safety and autocomplete.
+ */
+type FieldComponentType<T, P extends Path<T>, FieldType extends string = 'string'> = FieldType extends 'enum' ? EnumFieldComponent<T, P> : P extends keyof T ? UnwrapOptional<T[P]> extends Array<any> | ReadonlyArray<any> ? ArrayFieldComponent<T, P> : UnwrapOptional<T[P]> extends number ? NumberFieldComponent<T> : UnwrapOptional<T[P]> extends boolean ? CheckboxFieldComponent<T> : UnwrapOptional<T[P]> extends Date ? DateFieldComponent<T> : UnwrapOptional<T[P]> extends string ? SelectFieldComponent<T, P> : GenericFieldComponent : GenericFieldComponent;
+/**
+ * Type for the components object with PascalCase keys derived from field paths
+ * Each component gets the right type based on what the field actually is
+ */
+type ComponentsType<T> = {
+    [K in Path<T> as PathToPascalCase<K & string>]: FieldComponentType<T, K>;
+};
+
+/**
+ * Types for field metadata in the form system
+ */
+/**
+ * Metadata about a form field
+ * This interface defines all the properties that describe a field's behavior and appearance
+ */
+interface FieldMetadata {
+    /** The full path to the field (e.g., 'user.firstName') */
+    path: string;
+    /** Whether the field is required (false if optional) */
+    isRequired: boolean;
+    /** The data type of the field */
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object' | 'enum' | 'date' | 'union';
+    /** The input type for rendering the field */
+    inputType?: 'text' | 'email' | 'url' | 'tel' | 'number' | 'select' | 'checkbox' | 'radio' | 'textarea' | 'password' | 'array' | 'currency' | 'date' | 'time' | 'datetime-local' | 'file' | 'range' | 'search' | 'combobox';
+    /** The display label for the field */
+    label?: string;
+    /** Placeholder text for the field */
+    placeholder?: string;
+    /** Minimum value (for number fields) or length (for string/array fields) */
+    min?: number;
+    /** Maximum value (for number fields) or length (for string/array fields) */
+    max?: number;
+    /** Regular expression pattern for validation */
+    pattern?: RegExp;
+    /** Options for enum fields */
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    /** Default value for the field */
+    defaultValue?: any;
+    /** Whether the field is an array */
+    isArray?: boolean;
+    /** Metadata for array element type */
+    arrayOf?: FieldMetadata;
+    /** Child field metadata for object types */
+    children?: Record<string, FieldMetadata>;
+    /** Available items for array fields */
+    availableItems?: any[];
+    /** Help text to display with the field */
+    helpText?: string;
+    /** For textarea fields, number of rows to display */
+    rows?: number;
+    /** For textarea fields, number of columns to display */
+    cols?: number;
+    /** For enum fields, map values to display labels */
+    valueToLabel?: Record<string, string>;
+    /** Whether the field should be disabled */
+    disabled?: boolean;
+    /** Whether the field should be hidden */
+    hidden?: boolean;
+    /** CSS class to apply to the field */
+    className?: string;
+    /** Whether the field should be focused on load */
+    autofocus?: boolean;
+    /** For number fields, the step value */
+    step?: number;
+    /** Autocomplete attribute for the field */
+    autocomplete?: string;
+}
+
+/**
+ * Types for schema metadata in the form system
+ */
+
+/**
+ * Additional metadata that can be associated with schema fields
+ * This interface defines properties that can be attached to schema fields
+ * to customize their behavior and appearance
+ */
+interface SchemaFieldMetadata {
+    /** The input type for rendering the field */
+    inputType?: 'text' | 'email' | 'tel' | 'number' | 'select' | 'checkbox' | 'radio' | 'textarea' | 'password' | 'currency' | 'date' | 'time' | 'datetime-local' | 'combobox' | 'array';
+    /** Placeholder text for the field */
+    placeholder?: string;
+    /** The display label for the field */
+    label?: string;
+    /** Help text to display with the field */
+    helpText?: string;
+    /** For textarea fields, number of rows to display */
+    rows?: number;
+    /** For textarea fields, number of columns to display */
+    cols?: number;
+    /** For enum fields, map values to display labels */
+    valueToLabel?: Record<string, string>;
+    /** Whether to hide validation errors */
+    hideError?: boolean;
+    /** Step value for numeric fields */
+    step?: number;
+    /** Any other custom properties */
+    [key: string]: any;
+}
+/**
+ * Type for the registry mapping field paths to their metadata
+ */
+type MetadataRegistry = Record<string, SchemaFieldMetadata>;
+/**
+ * Type helper to extract all possible paths from a Zod schema
+ */
+type PathsOf<T extends z.ZodTypeAny> = Path<z.infer<T>>;
+
 /**
  * Option item for combobox fields - can be a string or label/value object
  */
@@ -219,6 +642,14 @@ interface ComboboxFieldProps<FormType, P extends Path<FormType> = Path<FormType>
      */
     filterFn?: (query: string, option: ComboboxOption) => boolean;
 }
+/**
+ * Array of prop names for ComboboxField component.
+ * This is derived from ComboboxFieldProps interface and ensures type safety.
+ * Used for prop normalization and filtering in component implementations.
+ *
+ * TypeScript ensures all entries are valid keys of ComboboxFieldProps.
+ */
+declare const COMBOBOX_FIELD_PROP_NAMES: readonly ["name", "options", "placeholder", "disabled", "readonly", "class", "label", "hideLabel", "description", "required", "size", "variant", "allowCreate", "filterFn"];
 
 interface CurrencyFieldProps<FormType> {
     name: FlexiblePath<FormType>;
@@ -237,23 +668,6 @@ interface CurrencyFieldProps<FormType> {
     step?: number;
 }
 
-interface DateFieldProps<FormType> {
-    name: FlexiblePath<FormType>;
-    label?: string;
-    hideLabel?: boolean;
-    description?: string;
-    required?: boolean;
-    placeholder?: string;
-    disabled?: boolean;
-    readonly?: boolean;
-    class?: string | string[];
-    size?: string;
-    variant?: string;
-    min?: string;
-    max?: string;
-    formatter?: (date: string) => unknown;
-}
-
 interface DateTimeLocalFieldProps<FormType> {
     name: FlexiblePath<FormType>;
     label?: string;
@@ -342,23 +756,6 @@ interface FormProps<FormType> {
     children?: any;
 }
 
-interface NumberFieldProps<FormType> {
-    name: FlexiblePath<FormType>;
-    label?: string;
-    hideLabel?: boolean;
-    description?: string;
-    required?: boolean;
-    placeholder?: string;
-    disabled?: boolean;
-    readonly?: boolean;
-    class?: string | string[];
-    size?: string;
-    variant?: string;
-    min?: number;
-    max?: number;
-    step?: number;
-}
-
 interface PasswordFieldProps<FormType> {
     name: FlexiblePath<FormType>;
     label?: string;
@@ -394,139 +791,41 @@ interface RadioFieldProps<FormType> {
 
 interface RangeFieldProps<FormType> {
     name: FlexiblePath<FormType>;
-    label?: string;
-    hideLabel?: boolean;
-    description?: string;
-    required?: boolean;
-    disabled?: boolean;
-    readonly?: boolean;
-    class?: string | string[];
-    size?: string;
-    variant?: string;
-    min?: number;
-    max?: number;
-    step?: number;
-    showValue?: boolean;
-}
-
-interface ResetButtonProps<FormType> {
-    resetText?: string;
-    className?: string;
-    disabled?: boolean;
-    onReset?: () => void;
-}
-
-interface SearchFieldProps<FormType> {
-    name: FlexiblePath<FormType>;
-    label?: string;
-    hideLabel?: boolean;
-    description?: string;
-    required?: boolean;
-    placeholder?: string;
-    disabled?: boolean;
-    readonly?: boolean;
-    autocomplete?: string;
-    class?: string | string[];
-    size?: string;
-    variant?: string;
-}
-
-/**
- * Option item for select fields
- */
-interface SelectOption {
-    value: string;
-    label: string;
-}
-/**
- * Type for a mapping of enum values to labels
- */
-type EnumValueToLabelMap<T extends string> = Record<T, string>;
-/**
- * Type for a value-to-label mapping that can be either a function or an object map
- */
-type ValueToLabelMapping<T extends string = string> = ((value: string) => string) | EnumValueToLabelMap<T>;
-/**
- * Helper type to extract the type of a field at a given path
- */
-type FieldType<T, P extends string> = P extends keyof T ? T[P] : P extends `${infer A}.${infer B}` ? A extends keyof T ? FieldType<T[A], B> : never : never;
-/**
- * Helper type to extract enum values from a field type
- */
-type EnumValuesFromField<T> = T extends string ? T : never;
-/**
- * Type that maps field paths to their corresponding enum types
- */
-type FieldPathToEnum$1<T, P extends Path<T>> = EnumValuesFromField<FieldType<T, P & string>>;
-/**
- * Props for the SelectField component
- */
-interface SelectFieldProps<FormType, P extends Path<FormType> = Path<FormType>> {
-    /**
-     * Field name (path in the form state)
-     * Accepts both static paths and dynamic paths for use in array fields
-     */
+    label?: string;
+    hideLabel?: boolean;
+    description?: string;
+    required?: boolean;
+    disabled?: boolean;
+    readonly?: boolean;
+    class?: string | string[];
+    size?: string;
+    variant?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    showValue?: boolean;
+}
+
+interface ResetButtonProps<FormType> {
+    resetText?: string;
+    className?: string;
+    disabled?: boolean;
+    onReset?: () => void;
+}
+
+interface SearchFieldProps<FormType> {
     name: FlexiblePath<FormType>;
-    /**
-     * Field label
-     */
     label?: string;
-    /**
-     * Whether to hide the label
-     */
     hideLabel?: boolean;
-    /**
-     * Field description
-     */
     description?: string;
-    /**
-     * Whether the field is required
-     */
     required?: boolean;
-    /**
-     * Placeholder text
-     */
     placeholder?: string;
-    /**
-     * Whether the field is disabled
-     */
     disabled?: boolean;
-    /**
-     * Whether the field is readonly
-     */
     readonly?: boolean;
-    /**
-     * CSS classes to apply to the field
-     */
+    autocomplete?: string;
     class?: string | string[];
-    /**
-     * Field size
-     */
     size?: string;
-    /**
-     * Field variant
-     */
     variant?: string;
-    /**
-     * Select options (overrides options from schema)
-     * Using selectOptions instead of options to avoid conflicts with HTML select element
-     */
-    selectOptions?: SelectOption[];
-    /**
-     * Custom mapping function to convert values to labels
-     * This is useful when you want to customize how labels are displayed
-     * without providing a full options array
-     *
-     * Can be provided as either:
-     * 1. A function that takes a value and returns a label
-     * 2. An object map where keys are enum values and values are labels
-     */
-    valueToLabel?: ValueToLabelMapping<FieldPathToEnum$1<FormType, P>>;
-    /**
-     * Whether to use options from the schema (default: true)
-     * Set to false to ignore schema options even when no options prop is provided
-     */
-    useSchemaOptions?: boolean;
 }
 
 interface SubmitButtonProps<FormType> {
@@ -791,195 +1090,6 @@ interface DataTableProps<FormType> {
     name?: string;
 }
 
-/**
- * Type to convert underscores to PascalCase
- * This helper type processes a single segment by capitalizing after underscores
- */
-type SegmentToPascalCase<S extends string> = S extends `${infer First}_${infer Rest}` ? `${Capitalize<First>}${SegmentToPascalCase<Rest>}` : Capitalize<S>;
-/**
- * Type to convert a dot-separated path to PascalCase
- * This uses recursion to handle any level of nesting
- * Also handles underscores by removing them and capitalizing each segment
- */
-type PathToPascalCase<P extends string> = P extends `${infer A}.${infer B}` ? `${SegmentToPascalCase<A>}${PathToPascalCase<B>}` : `${SegmentToPascalCase<P>}Field`;
-/**
- * Type that maps field paths to their corresponding enum types
- */
-type FieldPathToEnum<T, P extends Path<T>> = P extends keyof T ? T[P] extends string ? T[P] : string : string;
-/**
- * Type that extracts the array element type from a field path
- * If the path points to an array, it extracts the element type
- * @example
- * ArrayItemType<{users: User[]}, 'users'> = User
- * ArrayItemType<{tasks: Task[]}, 'tasks'> = Task
- */
-type ArrayItemType<T, P extends Path<T>> = P extends keyof T ? T[P] extends ReadonlyArray<infer Item> ? Item : T[P] extends Array<infer Item> ? Item : never : never;
-/**
- * Type for array field components with properly typed slots
- */
-type ArrayFieldComponent<T, P extends Path<T>> = vue.FunctionalComponent<Omit<ArrayFieldProps<T, ArrayItemType<T, P>>, 'name'>, {}, {
-    itemRenderer: (props: {
-        item: ArrayItemType<T, P>;
-        index: number;
-        getFieldName: (fieldPath: string) => string;
-    }) => any;
-    availableItemRenderer: (props: {
-        item: ArrayItemType<T, P>;
-        index: number;
-    }) => any;
-    default: () => any;
-}, {}>;
-/**
- * Type for enum field components that require valueToLabel
- */
-type EnumFieldComponent<T, P extends Path<T>> = (props: Omit<SelectFieldProps<T>, 'name' | 'valueToLabel'> & {
-    valueToLabel: Record<FieldPathToEnum<T, P>, string>;
-}, context?: any) => any;
-/**
- * Type for text field components
- */
-type TextFieldComponent<T> = (props: Omit<TextFieldProps<T>, 'name'>, context?: any) => any;
-/**
- * Type for select field components (can work with string or enum fields)
- */
-type SelectFieldComponent<T, P extends Path<T>> = (props: Omit<SelectFieldProps<T>, 'name'>, context?: any) => any;
-/**
- * Type for number field components
- */
-type NumberFieldComponent<T> = (props: Omit<NumberFieldProps<T>, 'name'>, context?: any) => any;
-/**
- * Type for checkbox field components
- */
-type CheckboxFieldComponent<T> = (props: Omit<CheckboxFieldProps<T>, 'name'>, context?: any) => any;
-/**
- * Type for date field components
- */
-type DateFieldComponent<T> = (props: Omit<DateFieldProps<T>, 'name'>, context?: any) => any;
-/**
- * Generic field component type - fallback for any other field types
- */
-type GenericFieldComponent = (props: any, context?: any) => any;
-/**
- * Maps a field path to its component type based on the field's actual type
- * Enums are explicitly passed as FieldType = 'enum' since they can't be auto-detected
- * Everything else is inferred from the actual TypeScript type at the path
- *
- * For string fields, we allow both TextFieldComponent and SelectFieldComponent
- * because string fields can use inputType: 'select' in metadata to become SelectFields
- */
-type FieldComponentType<T, P extends Path<T>, FieldType extends string = 'string'> = FieldType extends 'enum' ? EnumFieldComponent<T, P> : P extends keyof T ? T[P] extends Array<any> | ReadonlyArray<any> ? ArrayFieldComponent<T, P> : T[P] extends number ? NumberFieldComponent<T> : T[P] extends boolean ? CheckboxFieldComponent<T> : T[P] extends Date ? DateFieldComponent<T> : T[P] extends string ? // String fields can be either TextField or SelectField depending on inputType metadata
-TextFieldComponent<T> | SelectFieldComponent<T, P> : GenericFieldComponent : GenericFieldComponent;
-/**
- * Type for the components object with PascalCase keys derived from field paths
- * Each component gets the right type based on what the field actually is
- */
-type ComponentsType<T> = {
-    [K in Path<T> as PathToPascalCase<K & string>]: FieldComponentType<T, K>;
-};
-
-/**
- * Types for field metadata in the form system
- */
-/**
- * Metadata about a form field
- * This interface defines all the properties that describe a field's behavior and appearance
- */
-interface FieldMetadata {
-    /** The full path to the field (e.g., 'user.firstName') */
-    path: string;
-    /** Whether the field is required (false if optional) */
-    isRequired: boolean;
-    /** The data type of the field */
-    type: 'string' | 'number' | 'boolean' | 'array' | 'object' | 'enum' | 'date' | 'union';
-    /** The input type for rendering the field */
-    inputType?: 'text' | 'email' | 'url' | 'tel' | 'number' | 'select' | 'checkbox' | 'radio' | 'textarea' | 'password' | 'array' | 'currency' | 'date' | 'time' | 'datetime-local' | 'file' | 'range' | 'search' | 'combobox';
-    /** The display label for the field */
-    label?: string;
-    /** Placeholder text for the field */
-    placeholder?: string;
-    /** Minimum value (for number fields) or length (for string/array fields) */
-    min?: number;
-    /** Maximum value (for number fields) or length (for string/array fields) */
-    max?: number;
-    /** Regular expression pattern for validation */
-    pattern?: RegExp;
-    /** Options for enum fields */
-    options?: Array<{
-        value: string;
-        label: string;
-    }>;
-    /** Default value for the field */
-    defaultValue?: any;
-    /** Whether the field is an array */
-    isArray?: boolean;
-    /** Metadata for array element type */
-    arrayOf?: FieldMetadata;
-    /** Child field metadata for object types */
-    children?: Record<string, FieldMetadata>;
-    /** Available items for array fields */
-    availableItems?: any[];
-    /** Help text to display with the field */
-    helpText?: string;
-    /** For textarea fields, number of rows to display */
-    rows?: number;
-    /** For textarea fields, number of columns to display */
-    cols?: number;
-    /** For enum fields, map values to display labels */
-    valueToLabel?: Record<string, string>;
-    /** Whether the field should be disabled */
-    disabled?: boolean;
-    /** Whether the field should be hidden */
-    hidden?: boolean;
-    /** CSS class to apply to the field */
-    className?: string;
-    /** Whether the field should be focused on load */
-    autofocus?: boolean;
-    /** For number fields, the step value */
-    step?: number;
-    /** Autocomplete attribute for the field */
-    autocomplete?: string;
-}
-
-/**
- * Types for schema metadata in the form system
- */
-
-/**
- * Additional metadata that can be associated with schema fields
- * This interface defines properties that can be attached to schema fields
- * to customize their behavior and appearance
- */
-interface SchemaFieldMetadata {
-    /** The input type for rendering the field */
-    inputType?: 'text' | 'email' | 'tel' | 'number' | 'select' | 'checkbox' | 'radio' | 'textarea' | 'password' | 'currency' | 'date' | 'time' | 'datetime-local' | 'combobox';
-    /** Placeholder text for the field */
-    placeholder?: string;
-    /** The display label for the field */
-    label?: string;
-    /** Help text to display with the field */
-    helpText?: string;
-    /** For textarea fields, number of rows to display */
-    rows?: number;
-    /** For textarea fields, number of columns to display */
-    cols?: number;
-    /** For enum fields, map values to display labels */
-    valueToLabel?: Record<string, string>;
-    /** Whether to hide validation errors */
-    hideError?: boolean;
-    /** Step value for numeric fields */
-    step?: number;
-    /** Any other custom properties */
-    [key: string]: any;
-}
-/**
- * Type for the registry mapping field paths to their metadata
- */
-type MetadataRegistry = Record<string, SchemaFieldMetadata>;
-/**
- * Type helper to extract all possible paths from a Zod schema
- */
-type PathsOf<T extends z.ZodTypeAny> = Path<z.infer<T>>;
-
 /**
  * Types for style creators in the form system
  */
@@ -1014,7 +1124,7 @@ interface StyleCreators {
         itemRenderer: (props: {
             item: ItemType;
             index: number;
-            getFieldName: (fieldPath: string) => string;
+            fields: FieldNames<ItemType>;
         }) => any;
         availableItemRenderer: (props: {
             item: ItemType;
@@ -1204,7 +1314,7 @@ declare function useForm<T extends z.ZodObject<any>, CalcType = (values: z.infer
     ziniaGeneric: {
         TextField: vue.FunctionalComponent<TextFieldProps<z.TypeOf<T>>, {}, any, {}>;
         NumberField: vue.FunctionalComponent<NumberFieldProps<z.TypeOf<T>>, {}, any, {}>;
-        SelectField: vue.FunctionalComponent<SelectFieldProps<z.TypeOf<T>, Path<z.TypeOf<T>>>, {}, any, {}>;
+        SelectField: vue.FunctionalComponent<SelectFieldProps<z.TypeOf<T>, Path<z.TypeOf<T>>, any>, {}, any, {}>;
         CheckboxField: vue.FunctionalComponent<CheckboxFieldProps<z.TypeOf<T>>, {}, any, {}>;
         TextareaField: vue.FunctionalComponent<TextareaFieldProps<z.TypeOf<T>>, {}, any, {}>;
         RadioField: vue.FunctionalComponent<RadioFieldProps<z.TypeOf<T>>, {}, any, {}>;
@@ -1222,7 +1332,9 @@ declare function useForm<T extends z.ZodObject<any>, CalcType = (values: z.infer
             itemRenderer: (props: {
                 item: any;
                 index: number;
-                getFieldName: (fieldPath: string) => string;
+                fields: Record<string, string> | {
+                    [x: string]: string;
+                };
             }) => any;
             availableItemRenderer: (props: {
                 item: any;
@@ -1265,10 +1377,10 @@ declare function useForm<T extends z.ZodObject<any>, CalcType = (values: z.infer
             }) => any;
             default: () => any;
         }, {}>;
-        createTypedSelectField: <P extends Path<z.TypeOf<T>>>(fieldPath: P) => <E extends FieldPathToEnum<z.TypeOf<T>, P> = FieldPathToEnum<z.TypeOf<T>, P>>(props: Omit<SelectFieldProps<z.TypeOf<T>, Path<z.TypeOf<T>>>, "name" | "valueToLabel"> & {
+        createTypedSelectField: <P extends Path<z.TypeOf<T>>>(fieldPath: P) => <E extends FieldPathToEnum<z.TypeOf<T>, P> = FieldPathToEnum<z.TypeOf<T>, P>>(props: Omit<SelectFieldProps<z.TypeOf<T>, Path<z.TypeOf<T>>, any>, "name" | "valueToLabel"> & {
             valueToLabel: Record<E, string>;
         }, context?: any) => any;
-        typedSelectFields: { [K in Path<z.TypeOf<T>>]?: (<E extends FieldPathToEnum<z.TypeOf<T>, K> = FieldPathToEnum<z.TypeOf<T>, K>>(props: Omit<SelectFieldProps<z.TypeOf<T>, Path<z.TypeOf<T>>>, "name" | "valueToLabel"> & {
+        typedSelectFields: { [K in Path<z.TypeOf<T>>]?: (<E extends FieldPathToEnum<z.TypeOf<T>, K> = FieldPathToEnum<z.TypeOf<T>, K>>(props: Omit<SelectFieldProps<z.TypeOf<T>, Path<z.TypeOf<T>>, any>, "name" | "valueToLabel"> & {
             valueToLabel: Record<E, string>;
         }, context?: any) => any) | undefined; };
         fields: Record<Path<z.TypeOf<T>>, any>;
@@ -1341,7 +1453,7 @@ declare function createTypedArrayField<T, P extends Path<T>>(baseArrayField: Fun
     itemRenderer: (props: {
         item: ArrayItemType<T, P>;
         index: number;
-        getFieldName: (fieldPath: string) => string;
+        fields: FieldNames<ArrayItemType<T, P>>;
     }) => any;
     availableItemRenderer: (props: {
         item: ArrayItemType<T, P>;
@@ -1362,7 +1474,7 @@ declare function generateFieldComponents<T extends z.ZodObject<any>>(schema: T,
     generic: {
         TextField: vue.FunctionalComponent<TextFieldProps<z.TypeOf<T>>, {}, any, {}>;
         NumberField: vue.FunctionalComponent<NumberFieldProps<z.TypeOf<T>>, {}, any, {}>;
-        SelectField: vue.FunctionalComponent<SelectFieldProps<z.TypeOf<T>, Path<z.TypeOf<T>>>, {}, any, {}>;
+        SelectField: vue.FunctionalComponent<SelectFieldProps<z.TypeOf<T>, Path<z.TypeOf<T>>, any>, {}, any, {}>;
         CheckboxField: vue.FunctionalComponent<CheckboxFieldProps<z.TypeOf<T>>, {}, any, {}>;
         TextareaField: vue.FunctionalComponent<TextareaFieldProps<z.TypeOf<T>>, {}, any, {}>;
         RadioField: vue.FunctionalComponent<RadioFieldProps<z.TypeOf<T>>, {}, any, {}>;
@@ -1380,7 +1492,9 @@ declare function generateFieldComponents<T extends z.ZodObject<any>>(schema: T,
             itemRenderer: (props: {
                 item: any;
                 index: number;
-                getFieldName: (fieldPath: string) => string;
+                fields: Record<string, string> | {
+                    [x: string]: string;
+                };
             }) => any;
             availableItemRenderer: (props: {
                 item: any;
@@ -1423,10 +1537,10 @@ declare function generateFieldComponents<T extends z.ZodObject<any>>(schema: T,
             }) => any;
             default: () => any;
         }, {}>;
-        createTypedSelectField: <P extends Path<z.TypeOf<T>>>(fieldPath: P) => <E extends FieldPathToEnum<z.TypeOf<T>, P> = FieldPathToEnum<z.TypeOf<T>, P>>(props: Omit<SelectFieldProps<z.TypeOf<T>, Path<z.TypeOf<T>>>, "name" | "valueToLabel"> & {
+        createTypedSelectField: <P extends Path<z.TypeOf<T>>>(fieldPath: P) => <E extends FieldPathToEnum<z.TypeOf<T>, P> = FieldPathToEnum<z.TypeOf<T>, P>>(props: Omit<SelectFieldProps<z.TypeOf<T>, Path<z.TypeOf<T>>, any>, "name" | "valueToLabel"> & {
             valueToLabel: Record<E, string>;
         }, context?: any) => any;
-        typedSelectFields: { [K in Path<z.TypeOf<T>>]?: (<E extends FieldPathToEnum<z.TypeOf<T>, K> = FieldPathToEnum<z.TypeOf<T>, K>>(props: Omit<SelectFieldProps<z.TypeOf<T>, Path<z.TypeOf<T>>>, "name" | "valueToLabel"> & {
+        typedSelectFields: { [K in Path<z.TypeOf<T>>]?: (<E extends FieldPathToEnum<z.TypeOf<T>, K> = FieldPathToEnum<z.TypeOf<T>, K>>(props: Omit<SelectFieldProps<z.TypeOf<T>, Path<z.TypeOf<T>>, any>, "name" | "valueToLabel"> & {
             valueToLabel: Record<E, string>;
         }, context?: any) => any) | undefined; };
         fields: Record<Path<z.TypeOf<T>>, any>;
@@ -2252,4 +2366,4 @@ declare const ActionIcons: {
     readonly dotsHorizontal: "<svg fill=\"none\" stroke=\"currentColor\" viewBox=\"0 0 24 24\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M5 12h.01M12 12h.01M19 12h.01M6 12a1 1 0 11-2 0 1 1 0 012 0zm7 0a1 1 0 11-2 0 1 1 0 012 0zm7 0a1 1 0 11-2 0 1 1 0 012 0z\" /></svg>";
 };
 
-export { ActionIcons, type ActionItem, type ActionsConfig, type ButtonActionItem, type ColumnDefinition, type CursorDataTableOptions, type CursorFetchParams, type CursorFetchResult, type DataTableColumns, type DataTableOptions, type DisplayComponentsType, type DisplayFieldComponent, ErrorDisplay, type FetchDataParams, type FetchDataResult, type FilterOptionItem, type FilterValue, type LinkActionItem, LoadingDisplay, NoDataDisplay, SCHEMA_ID_SYMBOL, type TypedSelectFieldComponent, type UseCursorDataTableType, type UseDataTableType, type UseDeleteModalType, type UseDisplayType, type UseFormType, type UseFormTyped, ZINIA_DATA_TABLE_ACTIONS_KEY, ZINIA_DATA_TABLE_COLUMNS_KEY, ZINIA_DATA_TABLE_FILTER_INPUTS_KEY, ZINIA_DATA_TABLE_FILTER_OPERATORS_KEY, ZINIA_DATA_TABLE_FILTER_OPTIONS_LOADING_KEY, ZINIA_DATA_TABLE_FILTER_OPTIONS_STATE_KEY, ZINIA_DATA_TABLE_KEY, ZINIA_DATA_TABLE_NAME_KEY, ZINIA_DATA_TABLE_OPTIONS_KEY, ZINIA_DATA_TABLE_SEARCH_INPUT_KEY, ZINIA_DELETE_MODAL_FIELDS_GENERIC_KEY, ZINIA_DELETE_MODAL_FIELDS_KEY, ZINIA_DELETE_MODAL_KEY, ZINIA_DELETE_MODAL_SCHEMA_KEY, ZINIA_DISPLAY_FIELDS_GENERIC_KEY, ZINIA_DISPLAY_FIELDS_KEY, ZINIA_DISPLAY_KEY, ZINIA_DISPLAY_SCHEMA_KEY, ZINIA_FIELDS_GENERIC_KEY, ZINIA_FIELDS_KEY, ZINIA_FORM_KEY, ZINIA_FORM_SCHEMA_KEY, type ZiniaDataTable, type ZiniaDeleteModal, type ZiniaDeleteModalFields, type ZiniaDeleteModalGenericFields, type ZiniaDisplay, type ZiniaDisplayFields, type ZiniaDisplayGenericFields, type ZiniaForm, type ZiniaFormFields, type ZiniaFormGenericFields, ZiniaPlugin, type ZiniaPluginOptions, clearAllMetadata, clearSchemaMetadata, createBaseComponents, createBaseDisplayComponents, createPartialStyle, createStyleTemplate, createTypedArrayField, createTypedSelectField, daisyUIStyle, extendStyle, generateDisplayComponents, generateFieldComponents, getAllSchemaMetadata, getDefaultStyle, getFieldMetadata, getRegisteredStyle, getRegisteredStyleNames, getSchemaId, hasRegisteredStyle, hasSchemaMetadata, mergeStyles, plainStyle, registerSchemaMetadata, registerStyle, setSchemaMetadata, useCursorDataTable, useDataTable, useDeleteModal, useDisplay, useForm, withMetadata };
+export { ActionIcons, type ActionItem, type ActionsConfig, type ArrayFieldProps, type ButtonActionItem, COMBOBOX_FIELD_PROP_NAMES, type CheckboxFieldProps, type ColumnDefinition, type ComboboxFieldProps, type ComboboxOption, type CurrencyFieldProps, type CursorDataTableOptions, type CursorFetchParams, type CursorFetchResult, type DataTableColumns, type DataTableOptions, type DataTableProps, type DateFieldProps, type DateTimeLocalFieldProps, type DeleteModalProps, type DisplayComponentsType, type DisplayFieldComponent, type DisplayFieldProps, type DisplayProps, type EmailFieldProps, type EnumValueToLabelMap, type EnumValuesFromField, ErrorDisplay, type FetchDataParams, type FetchDataResult, type FieldPathToEnum$1 as FieldPathToEnum, type FieldType, type FileFieldProps, type FilterOptionItem, type FilterValue, type FormErrorsSummaryProps, type FormProps, type LinkActionItem, LoadingDisplay, NoDataDisplay, type NumberFieldProps, type PasswordFieldProps, type RadioFieldProps, type RangeFieldProps, type ResetButtonProps, SCHEMA_ID_SYMBOL, SELECT_FIELD_PROP_NAMES, type SearchFieldProps, type SelectFieldProps, type SelectOption, type SubmitButtonProps, type TelFieldProps, type TextFieldProps, type TextareaFieldProps, type TimeFieldProps, type ToppingsFieldProps, type TransferListFieldProps, type TypedSelectFieldComponent, type UrlFieldProps, type UseCursorDataTableType, type UseDataTableType, type UseDeleteModalType, type UseDisplayType, type UseFormType, type UseFormTyped, type ValueToLabelMapping, ZINIA_DATA_TABLE_ACTIONS_KEY, ZINIA_DATA_TABLE_COLUMNS_KEY, ZINIA_DATA_TABLE_FILTER_INPUTS_KEY, ZINIA_DATA_TABLE_FILTER_OPERATORS_KEY, ZINIA_DATA_TABLE_FILTER_OPTIONS_LOADING_KEY, ZINIA_DATA_TABLE_FILTER_OPTIONS_STATE_KEY, ZINIA_DATA_TABLE_KEY, ZINIA_DATA_TABLE_NAME_KEY, ZINIA_DATA_TABLE_OPTIONS_KEY, ZINIA_DATA_TABLE_SEARCH_INPUT_KEY, ZINIA_DELETE_MODAL_FIELDS_GENERIC_KEY, ZINIA_DELETE_MODAL_FIELDS_KEY, ZINIA_DELETE_MODAL_KEY, ZINIA_DELETE_MODAL_SCHEMA_KEY, ZINIA_DISPLAY_FIELDS_GENERIC_KEY, ZINIA_DISPLAY_FIELDS_KEY, ZINIA_DISPLAY_KEY, ZINIA_DISPLAY_SCHEMA_KEY, ZINIA_FIELDS_GENERIC_KEY, ZINIA_FIELDS_KEY, ZINIA_FORM_KEY, ZINIA_FORM_SCHEMA_KEY, type ZiniaDataTable, type ZiniaDeleteModal, type ZiniaDeleteModalFields, type ZiniaDeleteModalGenericFields, type ZiniaDisplay, type ZiniaDisplayFields, type ZiniaDisplayGenericFields, type ZiniaForm, type ZiniaFormFields, type ZiniaFormGenericFields, ZiniaPlugin, type ZiniaPluginOptions, type ZodEnumValues, clearAllMetadata, clearSchemaMetadata, createBaseComponents, createBaseDisplayComponents, createPartialStyle, createStyleTemplate, createTypedArrayField, createTypedSelectField, daisyUIStyle, extendStyle, generateDisplayComponents, generateFieldComponents, getAllSchemaMetadata, getDefaultStyle, getFieldMetadata, getRegisteredStyle, getRegisteredStyleNames, getSchemaId, hasRegisteredStyle, hasSchemaMetadata, mergeStyles, plainStyle, registerSchemaMetadata, registerStyle, setSchemaMetadata, useCursorDataTable, useDataTable, useDeleteModal, useDisplay, useForm, withMetadata };