@datum-cloud/datum-ui 1.3.1 → 1.4.0

package/dist/components/features/form/components/form-input.d.ts

@@ -18,4 +18,3 @@ export declare function FormInput({ ref, type, className, disabled, ...props }:
 export declare namespace FormInput {
     var displayName: string;
 }
-//# sourceMappingURL=form-input.d.ts.map

package/dist/components/features/form/components/form-radio-group.d.ts

@@ -32,4 +32,3 @@ export declare function FormRadioItem({ value, label, description, disabled }: F
 export declare namespace FormRadioItem {
     var displayName: string;
 }
-//# sourceMappingURL=form-radio-group.d.ts.map

package/dist/components/features/form/components/form-root.d.ts

@@ -27,4 +27,3 @@ export declare function FormRoot<T extends z.ZodType>({ schema, children, onSubm
 export declare namespace FormRoot {
     var displayName: string;
 }
-//# sourceMappingURL=form-root.d.ts.map

package/dist/components/features/form/components/form-select.d.ts

@@ -32,4 +32,3 @@ export declare function FormSelectItem({ value, children, disabled }: FormSelect
 export declare namespace FormSelectItem {
     var displayName: string;
 }
-//# sourceMappingURL=form-select.d.ts.map

package/dist/components/features/form/components/form-submit.d.ts

@@ -13,4 +13,3 @@ export declare function FormSubmit({ children, loadingText, loading, ...props }:
 export declare namespace FormSubmit {
     var displayName: string;
 }
-//# sourceMappingURL=form-submit.d.ts.map

package/dist/components/features/form/components/form-switch.d.ts

@@ -16,4 +16,3 @@ export declare function FormSwitch({ label, disabled, className }: FormSwitchPro
 export declare namespace FormSwitch {
     var displayName: string;
 }
-//# sourceMappingURL=form-switch.d.ts.map

package/dist/components/features/form/components/form-textarea.d.ts

@@ -18,4 +18,3 @@ export declare function FormTextarea({ ref, className, disabled, rows, ...props
 export declare namespace FormTextarea {
     var displayName: string;
 }
-//# sourceMappingURL=form-textarea.d.ts.map

package/dist/components/features/form/components/form-time-picker.d.ts

@@ -19,4 +19,3 @@ export declare function FormTimePicker({ min, max, step, placeholder, disabled,
 export declare namespace FormTimePicker {
     var displayName: string;
 }
-//# sourceMappingURL=form-time-picker.d.ts.map

package/dist/components/features/form/components/form-transfer.d.ts

@@ -35,4 +35,3 @@ export declare function FormTransfer<T>({ disabled, minItems, maxItems, ...props
 export declare namespace FormTransfer {
     var displayName: string;
 }
-//# sourceMappingURL=form-transfer.d.ts.map

package/dist/components/features/form/components/form-when.d.ts

@@ -32,4 +32,3 @@ export declare function FormWhen({ field, is, isNot, in: inArray, notIn, childre
 export declare namespace FormWhen {
     var displayName: string;
 }
-//# sourceMappingURL=form-when.d.ts.map

package/dist/components/features/form/components/index.d.ts

@@ -23,4 +23,3 @@ export { FormTextarea } from './form-textarea';
 export { FormTimePicker } from './form-time-picker';
 export { FormTransfer } from './form-transfer';
 export { FormWhen } from './form-when';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/features/form/components/stepper/form-step.d.ts

@@ -20,4 +20,3 @@ export declare function FormStep({ id, children }: FormStepProps): React.JSX.Ele
 export declare namespace FormStep {
     var displayName: string;
 }
-//# sourceMappingURL=form-step.d.ts.map

package/dist/components/features/form/components/stepper/form-stepper.d.ts

@@ -70,4 +70,3 @@ export declare namespace FormStepper {
     var displayName: string;
 }
 export {};
-//# sourceMappingURL=form-stepper.d.ts.map

package/dist/components/features/form/components/stepper/index.d.ts

@@ -2,4 +2,3 @@ export { FormStep } from './form-step';
 export { FormStepper, useFormStepperContext } from './form-stepper';
 export { StepperControls } from './stepper-controls';
 export { StepperNavigation } from './stepper-navigation';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/features/form/components/stepper/stepper-controls.d.ts

@@ -30,4 +30,3 @@ export declare function StepperControls({ prevLabel, nextLabel, loadingText, sho
 export declare namespace StepperControls {
     var displayName: string;
 }
-//# sourceMappingURL=stepper-controls.d.ts.map

package/dist/components/features/form/components/stepper/stepper-navigation.d.ts

@@ -15,4 +15,3 @@ export declare function StepperNavigation({ variant, labelOrientation, className
 export declare namespace StepperNavigation {
     var displayName: string;
 }
-//# sourceMappingURL=stepper-navigation.d.ts.map

package/dist/components/features/form/context/field-context.d.ts

@@ -13,4 +13,3 @@ export declare function useFieldContext(): FormFieldContextValue;
  */
 export declare function useOptionalFieldContext(): FormFieldContextValue | null;
 export { FieldContext };
-//# sourceMappingURL=field-context.d.ts.map

package/dist/components/features/form/context/form-context.d.ts

@@ -17,4 +17,3 @@ export declare function useFormField(name: string): NormalizedFieldMeta | undefi
  */
 export declare function useFormSubmitting(): boolean;
 export { FormContext };
-//# sourceMappingURL=form-context.d.ts.map

package/dist/components/features/form/context/index.d.ts

@@ -1,3 +1,2 @@
 export { FieldContext, FieldProvider, useFieldContext, useOptionalFieldContext, } from './field-context';
 export { FormContext, FormProvider, useFormContext, useFormField, useFormSubmitting, } from './form-context';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/features/form/hooks/index.d.ts

@@ -3,4 +3,3 @@ export { useFieldContext } from './use-field-context';
 export { useFormContext } from './use-form-context';
 export { useFormState } from './use-form-state';
 export { useWatch, useWatchAll } from './use-watch';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/features/form/hooks/use-display-touched.d.ts

@@ -17,4 +17,3 @@ export interface UseDisplayTouchedReturn {
  * behaviour across validation modes (onChange, onBlur, onSubmit).
  */
 export declare function useDisplayTouched(schema: z.ZodType): UseDisplayTouchedReturn;
-//# sourceMappingURL=use-display-touched.d.ts.map

package/dist/components/features/form/hooks/use-field-context.d.ts

@@ -21,4 +21,3 @@ import type { FormFieldContextValue } from '../types';
  * ```
  */
 export declare function useFieldContext(): FormFieldContextValue;
-//# sourceMappingURL=use-field-context.d.ts.map

package/dist/components/features/form/hooks/use-field.d.ts

@@ -25,4 +25,3 @@ import type { UseFieldReturn } from '../types';
  * ```
  */
 export declare function useField(name: string): UseFieldReturn;
-//# sourceMappingURL=use-field.d.ts.map

package/dist/components/features/form/hooks/use-form-context.d.ts

@@ -16,4 +16,3 @@ import type { FormContextValue } from '../types';
  * ```
  */
 export declare function useFormContext<T extends Record<string, unknown> = Record<string, unknown>>(): FormContextValue<T>;
-//# sourceMappingURL=use-form-context.d.ts.map

package/dist/components/features/form/hooks/use-form-state.d.ts

@@ -33,4 +33,3 @@ export declare function useFormState(): {
     /** Record of which fields have been focused and blurred */
     touchedFields: Record<string, boolean>;
 };
-//# sourceMappingURL=use-form-state.d.ts.map

package/dist/components/features/form/hooks/use-stepper.d.ts

@@ -53,4 +53,3 @@ export interface UseStepperReturn {
  * ```
  */
 export declare function useStepper(): UseStepperReturn;
-//# sourceMappingURL=use-stepper.d.ts.map

package/dist/components/features/form/hooks/use-watch.d.ts

@@ -27,4 +27,3 @@ export declare function useWatch<T = unknown>(name: string): T | undefined;
  * ```
  */
 export declare function useWatchAll<T extends Record<string, unknown>>(names: string[]): Partial<T>;
-//# sourceMappingURL=use-watch.d.ts.map

package/dist/components/features/form/index.d.ts

@@ -154,4 +154,3 @@ export { FormAutocomplete, FormAutosearch, FormButton, FormCheckbox, FormCombobo
 export { FormAdapterProvider, useAdapter } from './adapter-context';
 export type { CreateFormProps, FormAdapter, NormalizedFieldArray, NormalizedFieldMeta, NormalizedFieldState, NormalizedFormInstance, NormalizedFormState, } from './adapter-types';
 export type { AutocompleteGroup, AutocompleteOption, AutocompleteProps, FormAutocompleteProps, FormButtonProps, FormCheckboxProps, FormContextValue, FormCopyBoxProps, FormCustomProps, FormCustomRenderProps, FormDescriptionProps, FormDialogProps, FormErrorProps, FormFieldArrayProps, FormFieldArrayRenderProps, FormFieldContextValue, FormFieldProps, FormFieldRenderProps, FormInputProps, FormRadioGroupProps, FormRadioItemProps, FormRootProps, FormRootRenderProps, FormSelectItemProps, FormSelectProps, FormSubmitProps, FormSwitchProps, FormTelemetry, FormTextareaProps, FormWhenProps, UseFieldReturn, UseWatchReturn, } from './types';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/features/form/stepper/index.d.ts

@@ -14,4 +14,3 @@
 export { FormStep, FormStepper, StepperControls, StepperNavigation, } from '../components/stepper';
 export { useStepper } from '../hooks/use-stepper';
 export type { FormStepperProps, FormStepperRenderProps, FormStepProps, StepConfig, StepperContextValue, StepperControlsProps, StepperNavigationProps, } from '../types';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/features/form/types/context.d.ts

@@ -0,0 +1,18 @@
+import type { NormalizedFieldMeta, NormalizedFormInstance } from '../adapter-types';
+import type { FormActions, FormStateFields } from './core';
+export interface FormContextValue<_T extends Record<string, unknown> = Record<string, unknown>> extends FormStateFields, FormActions {
+    /** Normalized form instance */
+    form: NormalizedFormInstance;
+    /** Field metadata accessor */
+    fields: Record<string, NormalizedFieldMeta>;
+    /** Validation mode controlling when errors are displayed */
+    mode: 'onChange' | 'onBlur' | 'onSubmit';
+    /** Array of field names that are display-touched (for error filtering) */
+    displayTouchedFields: string[];
+    /** Mark a field as display-touched */
+    markFieldTouched: (fieldName: string) => void;
+    /** Mark all fields as display-touched */
+    markAllFieldsTouched: () => void;
+    /** Form ID */
+    formId: string;
+}

package/dist/components/features/form/types/core.d.ts

@@ -0,0 +1,20 @@
+import type { NormalizedFormState } from '../adapter-types';
+/**
+ * The canonical set of reactive form-state fields, shared by every render-prop
+ * and context surface. Composes the adapter's {@link NormalizedFormState} and
+ * adds the Form-tracked `isSubmitting` flag so the shape is defined once instead
+ * of being hand-duplicated across Form.Root / Form.Custom / FormContext.
+ */
+export interface FormStateFields extends NormalizedFormState {
+    /** Whether the form is currently submitting */
+    isSubmitting: boolean;
+}
+/**
+ * Imperative form actions shared across render-prop / context surfaces.
+ */
+export interface FormActions {
+    /** Programmatically submit the form */
+    submit: () => void;
+    /** Reset form to default values */
+    reset: () => void;
+}

package/dist/components/features/form/types/dialog.d.ts

@@ -0,0 +1,83 @@
+import type { z } from 'zod';
+import type { ButtonProps } from '../../..';
+import type { FormRootRenderProps } from './root';
+import type { FormTelemetry } from './telemetry';
+export interface FormDialogProps<T extends z.ZodType> {
+    /** Controlled open state */
+    open?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Default open state for uncontrolled usage */
+    defaultOpen?: boolean;
+    /** Dialog title */
+    title: string;
+    /** Dialog description (optional) */
+    description?: string;
+    /** Trigger element to open the dialog */
+    trigger?: React.ReactNode;
+    /** Zod schema for validation */
+    schema: T;
+    /** Default form values */
+    defaultValues?: Partial<z.infer<T>>;
+    /** Client-side submit handler */
+    onSubmit?: (data: z.infer<T>) => void | Promise<void>;
+    /** Called after successful submission */
+    onSuccess?: (data: z.infer<T>) => void;
+    /** Called when validation fails */
+    onError?: (error: z.ZodError<z.infer<T>>) => void;
+    /** Submit button text (default: "Submit") */
+    submitText?: string;
+    /** Submit button text while loading */
+    submitTextLoading?: string;
+    /** Cancel button text (default: "Cancel") */
+    cancelText?: string;
+    /** Whether to show cancel button (default: true) */
+    showCancel?: boolean;
+    /** Submit button type variant */
+    submitType?: ButtonProps['type'];
+    /**
+     * External loading state - use when submission is handled by external mutation.
+     * When provided, this overrides the internal isSubmitting state.
+     * @example
+     * ```tsx
+     * const mutation = useCreateUser();
+     * <Form.Dialog loading={mutation.isPending} ... />
+     * ```
+     */
+    loading?: boolean;
+    /** Custom form element (e.g., React Router's Form). Defaults to native <form>. */
+    formComponent?: React.ElementType;
+    /** Optional telemetry callbacks for form submission tracking */
+    telemetry?: FormTelemetry;
+    /** Whether to show the header close (X) button (default: true) */
+    showHeaderClose?: boolean;
+    /** Dialog content className */
+    className?: string;
+    /** Form className */
+    formClassName?: string;
+    /**
+     * Dialog form children - can be either:
+     * - ReactNode: Standard form fields
+     * - Render function: For accessing form state (form, fields, isSubmitting, etc.)
+     *
+     * @example Standard usage
+     * ```tsx
+     * <Form.Dialog title="Add User" schema={schema} onSubmit={handleSubmit}>
+     *   <Form.Field name="email"><Form.Input type="email" /></Form.Field>
+     * </Form.Dialog>
+     * ```
+     *
+     * @example Render function for form state access
+     * ```tsx
+     * <Form.Dialog title="Edit User" schema={schema} onSubmit={handleSubmit}>
+     *   {({ form, fields, isSubmitting, reset }) => (
+     *     <>
+     *       <Form.Field name="email"><Form.Input type="email" /></Form.Field>
+     *       <Button onClick={reset} disabled={isSubmitting}>Reset</Button>
+     *     </>
+     *   )}
+     * </Form.Dialog>
+     * ```
+     */
+    children: React.ReactNode | ((props: FormRootRenderProps) => React.ReactNode);
+}

package/dist/components/features/form/types/field.d.ts

@@ -0,0 +1,113 @@
+import type { NormalizedFieldMeta, NormalizedFieldState, NormalizedFormInstance } from '../adapter-types';
+/**
+ * Render props passed to Form.Field when using render function pattern
+ */
+export interface FormFieldRenderProps {
+    /** Normalized field state with value and control methods */
+    field: NormalizedFieldState;
+    /** Input control for programmatic value updates */
+    control: {
+        value: unknown;
+        change: (value: unknown) => void;
+        blur: () => void;
+        focus: () => void;
+    };
+    /** Field meta information */
+    meta: {
+        name: string;
+        id: string;
+        errors: string[];
+        required: boolean;
+        disabled: boolean;
+    };
+    /** Access to all form fields */
+    fields: Record<string, NormalizedFieldMeta>;
+    /** Form instance */
+    form: NormalizedFormInstance;
+    /** Whether form is currently submitting */
+    isSubmitting: boolean;
+}
+export interface FormFieldProps {
+    /** Field name - supports nested paths like "address.city" */
+    name: string;
+    /**
+     * Form children - can be either:
+     * - ReactNode: Standard input components (Form.Input, Form.Select, etc.)
+     * - Render function: For custom components needing field access
+     *
+     * @example Standard usage
+     * ```tsx
+     * <Form.Field name="email" label="Email">
+     *   <Form.Input type="email" />
+     * </Form.Field>
+     * ```
+     *
+     * @example Render function for custom components
+     * ```tsx
+     * <Form.Field name="role" label="Role">
+     *   {({ control, meta, fields }) => (
+     *     <CustomSelect
+     *       value={control.value}
+     *       onChange={control.change}
+     *     />
+     *   )}
+     * </Form.Field>
+     * ```
+     */
+    children: React.ReactNode | ((props: FormFieldRenderProps) => React.ReactNode);
+    /** Field label */
+    label?: string | React.ReactNode;
+    /** Helper description below the field */
+    description?: string | React.ReactNode;
+    /** Tooltip information */
+    tooltip?: string | React.ReactNode;
+    /** Mark field as required (shows asterisk) */
+    required?: boolean;
+    /** Disable the field */
+    disabled?: boolean;
+    /** Whether to render field errors (default: true) */
+    showErrors?: boolean;
+    /** Additional CSS classes for the field wrapper */
+    className?: string;
+    /** Additional CSS classes for the label */
+    labelClassName?: string;
+}
+export interface FormFieldContextValue {
+    /** Field name */
+    name: string;
+    /** Field ID for accessibility */
+    id: string;
+    /** Field errors */
+    errors: string[];
+    /** Whether the field is required */
+    required: boolean;
+    /** Whether the field is disabled */
+    disabled: boolean;
+    /** Normalized field state (available when adapter provides it) */
+    fieldState: NormalizedFieldState | null;
+}
+export interface UseFieldReturn {
+    /** Normalized field state */
+    field: NormalizedFieldState;
+    /** Input control for programmatic updates */
+    control: {
+        value: unknown;
+        change: (value: unknown) => void;
+        blur: () => void;
+        focus: () => void;
+    };
+    /** Field meta information */
+    meta: {
+        name: string;
+        id: string;
+        errors: string[];
+        required: boolean;
+        disabled: boolean;
+    };
+    /** Field errors */
+    errors: string[];
+}
+export interface UseWatchReturn<T = unknown> {
+    /** Current field value */
+    value: T;
+}