@startdownnotez404/ui 1.3.5 → 1.3.6

package/dist/table.d.mts

@@ -7,12 +7,11 @@ import { SelectProps } from '@mui/material/Select';
 import FormControl, { FormControlProps } from '@mui/material/FormControl';
 import _mui_material_MenuItem from '@mui/material/MenuItem';
 import { SliderProps } from '@mui/material/Slider';
-import { DatePicker } from '@mui/x-date-pickers/DatePicker';
-import { DateTimePicker } from '@mui/x-date-pickers/DateTimePicker';
+import { Dayjs } from 'dayjs';
+import Box from '@mui/material/Box';
 import { FormLabelProps } from '@mui/material/FormLabel';
 import { FormGroupProps } from '@mui/material/FormGroup';
 import MuiCheckBox from '@mui/material/Checkbox';
-import { DropzoneOptions } from 'react-dropzone';
 import { SwitchProps } from '@mui/material/Switch';
 import { CountryCode } from 'libphonenumber-js';
 import { ButtonProps } from '@mui/material/Button';
@@ -30,6 +29,8 @@ declare const FIELD_TYPEs: {
     readonly check: "check-field";
     readonly date: "date-field";
     readonly dateTime: "date-time-field";
+    readonly time: "time-field";
+    readonly dateRange: "date-range-field";
     readonly toggleButton: "toggle-button";
     readonly autocomplete: "autocomplete-field";
     readonly switch: "switch-field";
@@ -76,9 +77,213 @@ type MuiSelectProps = {
     };
 } & Omit<SelectProps, "label">;
 
-declare const MuiXDatePicker: React__default.FC<React__default.ComponentProps<typeof DatePicker>>;
+type MuiXDatePickerProps = {
+    /** Controlled value (Dayjs, Date, or null). Prefer this in forms/stories. */
+    value?: Dayjs | Date | string | null;
+    /** Uncontrolled initial value when `value` is omitted. */
+    defaultValue?: Dayjs | Date | string | null;
+    /**
+     * Called with Dayjs | null (same shape as MUI DatePicker) so UseForm DateField
+     * can keep using `d?.toDate?.()`.
+     */
+    onChange?: (value: Dayjs | null) => void;
+    label?: string;
+    disabled?: boolean;
+    /** Override display format (default `MM/DD/YYYY`). */
+    format?: string;
+    /** Optional sx for the outer field wrapper. */
+    sx?: React__default.ComponentProps<typeof Box>['sx'];
+    /**
+     * When true, the trigger field stays read-only (calendar-only).
+     * Default false — user can type a date string and commit on blur/Enter.
+     */
+    disableTyping?: boolean;
+    /**
+     * Legacy passthrough kept for UseForm slotProps compatibility.
+     * `textField` bits are applied to the trigger field.
+     */
+    slotProps?: {
+        textField?: Record<string, unknown>;
+        openPickerIcon?: Record<string, unknown>;
+        actionBar?: Record<string, unknown>;
+    };
+};
+/**
+ * Soft/quiet DatePicker with a typeable trigger field.
+ *
+ * Trigger text is editable by default (commit on blur/Enter). Calendar icon
+ * opens the DateCalendar popover; focusing/typing the field does not.
+ * Pass `disableTyping` for read-only calendar-only mode.
+ *
+ * Invalid typed input reverts to the last committed label.
+ * Escape cancels the edit without committing.
+ */
+declare const MuiXDatePicker: React__default.FC<MuiXDatePickerProps>;
+
+type MuiXDateTimePickerProps = {
+    /** Controlled value (Dayjs, Date, or null). Prefer this in forms/stories. */
+    value?: Dayjs | Date | string | null;
+    /** Uncontrolled initial value when `value` is omitted. */
+    defaultValue?: Dayjs | Date | string | null;
+    /**
+     * Called with Dayjs | null (same shape as MUI DateTimePicker) so UseForm
+     * DateTimeField can keep using `d?.toDate?.()`.
+     */
+    onChange?: (value: Dayjs | null) => void;
+    label?: string;
+    disabled?: boolean;
+    /** 12h + am/pm when true (default). When false, display/parse as `HH:mm`. */
+    ampm?: boolean;
+    /** Override display format (default `MM/DD/YYYY hh:mm a` or 24h variant). */
+    format?: string;
+    /** Optional sx for the outer field wrapper. */
+    sx?: React__default.ComponentProps<typeof Box>['sx'];
+    /**
+     * When true, the trigger field stays read-only (calendar-only).
+     * Default false — user can type a datetime string and commit on blur/Enter.
+     */
+    disableTyping?: boolean;
+    /**
+     * Legacy passthrough kept for UseForm slotProps compatibility.
+     * `textField` bits are applied to the trigger field.
+     */
+    slotProps?: {
+        textField?: Record<string, unknown>;
+        openPickerIcon?: Record<string, unknown>;
+        actionBar?: Record<string, unknown>;
+    };
+};
+/**
+ * Soft/quiet DateTimePicker with a typeable trigger field.
+ *
+ * Trigger text is editable by default (commit on blur/Enter). Calendar icon
+ * opens the date+time popover; focusing/typing the field does not.
+ * Pass `disableTyping` for read-only calendar-only mode.
+ *
+ * Invalid typed input reverts to the last committed label.
+ * Escape cancels the edit without committing.
+ */
+declare const MuiXDateTimePicker: React__default.FC<MuiXDateTimePickerProps>;
 
-declare const MuiXDateTimePicker: React__default.FC<React__default.ComponentProps<typeof DateTimePicker>>;
+type MuiXTimePickerProps = {
+    /** Controlled value (Dayjs, Date, or null). Prefer this in forms/stories. */
+    value?: Dayjs | Date | string | null;
+    /** Uncontrolled initial value when `value` is omitted. */
+    defaultValue?: Dayjs | Date | string | null;
+    /**
+     * Called with Dayjs | null (same shape as MUI TimePicker) so UseForm TimeField
+     * can keep using `d?.toDate?.()`.
+     */
+    onChange?: (value: Dayjs | null) => void;
+    label?: string;
+    disabled?: boolean;
+    /** 12h + am/pm when true (default). When false, display/parse as `HH:mm`. */
+    ampm?: boolean;
+    /** Override display format (default `hh:mm a` or `HH:mm` when ampm=false). */
+    format?: string;
+    /** Optional sx for the outer field wrapper. */
+    sx?: React__default.ComponentProps<typeof Box>['sx'];
+    /**
+     * When true, the trigger field stays read-only (clock-only).
+     * Default false — user can type a time string and commit on blur/Enter.
+     */
+    disableTyping?: boolean;
+    /**
+     * Legacy passthrough kept for UseForm slotProps compatibility.
+     * `textField` bits are applied to the trigger field.
+     */
+    slotProps?: {
+        textField?: Record<string, unknown>;
+        openPickerIcon?: Record<string, unknown>;
+        actionBar?: Record<string, unknown>;
+    };
+};
+/**
+ * Soft/quiet TimePicker with a typeable trigger field.
+ *
+ * Trigger text is editable by default (commit on blur/Enter). Clock icon opens
+ * the multi-section digital clock popover; focusing/typing the field does not.
+ * Pass `disableTyping` for read-only clock-only mode.
+ *
+ * Invalid typed input (e.g. `04:15 aa`) reverts to the last committed label.
+ * Escape cancels the edit without committing.
+ */
+declare const MuiXTimePicker: React__default.FC<MuiXTimePickerProps>;
+
+type DateRangeValue = {
+    start: Date | null;
+    end: Date | null;
+};
+type MuiXDateRangePickerProps = {
+    /** Controlled value. Prefer this in forms/stories. */
+    value?: DateRangeValue;
+    /** Uncontrolled initial value when `value` is omitted. */
+    defaultValue?: DateRangeValue;
+    onChange?: (value: DateRangeValue) => void;
+    /** Combined field label (defaults to start/end labels joined). */
+    label?: string;
+    startLabel?: string;
+    endLabel?: string;
+    disabled?: boolean;
+    /** Optional sx for the outer field wrapper. */
+    sx?: React__default.ComponentProps<typeof Box>['sx'];
+    /**
+     * Show the Trip.com-style endorsement chip when both ends are set.
+     * Defaults to true (chip appears once start + end are non-null).
+     * Pass false to hide entirely.
+     */
+    showEndorsement?: boolean;
+    /**
+     * Custom chip label. String always shows that text when both ends are set.
+     * Function receives `{ start, end }` and may return `string | null` (`null` hides).
+     * When omitted, uses the built-in night/day formatter (`endorsementUnit`).
+     */
+    endorsement?: string | ((range: {
+        start: Date;
+        end: Date;
+    }) => string | null);
+    /**
+     * Unit for the default formatter.
+     * - `nights` (default): `end.diff(start, 'day')` -> "N night(s)" (hotel-style)
+     * - `days`: `end.diff(start, 'day') + 1` -> "N day(s)" (inclusive calendar days)
+     */
+    endorsementUnit?: 'nights' | 'days';
+    /**
+     * Legacy passthrough kept for UseForm slotProps compatibility.
+     * `start` / `end` textField bits are lightly applied to the single trigger field.
+     */
+    slotProps?: {
+        start?: {
+            slotProps?: {
+                textField?: Record<string, unknown>;
+            };
+            disabled?: boolean;
+        };
+        end?: {
+            slotProps?: {
+                textField?: Record<string, unknown>;
+            };
+            disabled?: boolean;
+        };
+    };
+    /**
+     * When true, the trigger field stays read-only (calendar-only).
+     * Default false — user can type a range string and commit on blur/Enter.
+     */
+    disableTyping?: boolean;
+};
+/**
+ * Free (non-Pro) date range: single field + dual-month booking calendar popover.
+ *
+ * Value shape: `{ start: Date | null; end: Date | null }` — null halves are OK.
+ * When both halves are set and start > end, they are swapped so the range is
+ * always ordered (start ≤ end).
+ *
+ * Trigger text is editable by default (commit on blur/Enter). Calendar icon
+ * opens the popover; focusing/typing the field does not. Pass `disableTyping`
+ * for read-only calendar-only mode.
+ */
+declare const MuiXDateRangePicker: React__default.FC<MuiXDateRangePickerProps>;
 
 interface CheckOptionType {
     id: string;
@@ -103,79 +308,6 @@ declare function CheckboxGroup({ error, required, options, setCheckedIds, title,
     };
 }): react_jsx_runtime.JSX.Element;
 
-type ValueOf<T> = T[keyof T];
-
-declare const FILE_STATUSs: {
-    readonly uploadingToLocal: "local-uploading";
-    readonly uploadedToLocal: "local-uploaded";
-    readonly localError: "local-error";
-    readonly pending: "pending";
-    readonly uploadPending: "upload-pending";
-    readonly gettingSignedURL: "upload-gettingSignedURL";
-    readonly beginUploadToS3: "upload-beginUploadToS3";
-    readonly uploadedToCloud: "upload-uploadedToCloud";
-    readonly error: "upload-error";
-    readonly downloadPending: "download-pending";
-    readonly downloading: "download-in-progress";
-    readonly downloaded: "download-completed";
-    readonly downloadError: "download-error";
-};
-type FileStatusType = ValueOf<typeof FILE_STATUSs>;
-type Attachment = {
-    url: string;
-    keyPath: string;
-    filename: string;
-    fileType: string;
-    hostname: string;
-};
-
-interface PreviewableFileProps {
-    path?: string;
-    blobUrl?: string;
-    filename?: string;
-    randomName?: string;
-    fileType?: string;
-    mimeType?: Blob["type"];
-    size?: number;
-    displaySize?: string;
-    url?: string;
-    fetchOptions?: object;
-    putUrl?: string;
-    getUrl?: string;
-    status?: FileStatusType;
-    revokeable?: boolean;
-    imageProps?: {
-        width: number;
-        height: number;
-    };
-}
-declare class PreviewableFile {
-    path: NonNullable<PreviewableFileProps["path"]>;
-    blobUrl: NonNullable<PreviewableFileProps["blobUrl"]>;
-    filename: NonNullable<PreviewableFileProps["filename"]>;
-    randomName: NonNullable<PreviewableFileProps["randomName"]>;
-    fileType: NonNullable<PreviewableFileProps["fileType"]>;
-    mimeType: NonNullable<PreviewableFileProps["mimeType"]>;
-    size: NonNullable<PreviewableFileProps["size"]>;
-    displaySize: NonNullable<PreviewableFileProps["displaySize"]>;
-    url: NonNullable<PreviewableFileProps["url"]>;
-    fetchOptions: NonNullable<PreviewableFileProps["fetchOptions"]>;
-    putUrl: NonNullable<PreviewableFileProps["putUrl"]>;
-    getUrl: NonNullable<PreviewableFileProps["getUrl"]>;
-    status: NonNullable<PreviewableFileProps["status"]>;
-    revokeable: NonNullable<PreviewableFileProps["revokeable"]>;
-    imageProps: NonNullable<PreviewableFileProps["imageProps"]>;
-    constructor(props?: PreviewableFileProps);
-    toPlainObj(): this;
-    updateFile(file: PreviewableFile | undefined): void;
-    updateStatus(status: FileStatusType): void;
-    downloadFile(): Promise<this>;
-    _displayFileSize(): string;
-    getUploadFormat(): Attachment;
-}
-
-type DropzoneType = "box" | "button";
-
 type OptionId = string;
 interface OptionParams {
     id?: OptionId;
@@ -223,15 +355,34 @@ type SliderSlotProps = Partial<SliderProps>;
 
 type DateTimeSlotProps = Partial<React__default.ComponentProps<typeof MuiXDateTimePicker>>;
 type DateSlotProps = Partial<React__default.ComponentProps<typeof MuiXDatePicker>>;
+type TimeSlotProps = Partial<React__default.ComponentProps<typeof MuiXTimePicker>>;
+type DateRangeSlotProps = {
+    startLabel?: string;
+    endLabel?: string;
+    /** Optional label override for the single dual-month trigger field. */
+    label?: string;
+    /** Legacy passthrough — applied lightly to the single trigger field. */
+    start?: Partial<React__default.ComponentProps<typeof MuiXDatePicker>>;
+    end?: Partial<React__default.ComponentProps<typeof MuiXDatePicker>>;
+} & Partial<Pick<React__default.ComponentProps<typeof MuiXDateRangePicker>, 'sx' | 'showEndorsement' | 'endorsement' | 'endorsementUnit'>>;
 
+/** Mime→extensions accept map, or a plain HTML accept string. */
+type FileAcceptMap = Record<string, string[]>;
 type FileUploadSlotProps = {
-    accept?: DropzoneOptions['accept'];
+    /** HTML accept string or mime→extensions map. */
+    accept?: FileAcceptMap | string;
     maxFiles?: number;
-    dropzoneType?: DropzoneType;
+    /**
+     * Trigger chrome. `button` → FileUpload variant="button";
+     * `box` / `dropzone` → variant="dropzone" (default).
+     */
+    dropzoneType?: 'box' | 'button' | 'dropzone';
+    /** Optional FileUpload item layout. */
+    itemVariant?: 'row' | 'tile';
 };
 type AvatarSlotProps = {
-    /** File accept config. Supports react-dropzone's accept shape or a plain input accept string. */
-    accept?: DropzoneOptions['accept'] | string;
+    /** File accept config. Mime→extensions map or a plain input accept string. */
+    accept?: FileAcceptMap | string;
     /** Avatar size preset from the elemental Avatar package */
     size?: Size;
     /** Override avatar dimensions (in px or css units) */
@@ -275,8 +426,14 @@ type ToggleButtonSlotProps = {
 type AutocompleteSlotProps = {
     options: OptionParams[];
     multiple?: boolean;
-    /** `field` is the full selector. `icon` is a compact IconButton with a badge. */
+    /** Soft Autocomplete input placeholder (defaults to Select options / Select an option). */
+    placeholder?: string;
+    /**
+     * @deprecated UseForm AutocompleteField now renders soft Autocomplete (TextField-like).
+     * GitHubPicker `variant` / `color` are ignored by the form field.
+     */
     variant?: GitHubPickerVariant;
+    /** @deprecated Ignored — see `variant`. */
     color?: GitHubPickerColor;
     useOptions?: () => {
         options: OptionParams[];
@@ -329,6 +486,24 @@ type JsonSlotProps = {
     editorProps?: Record<string, unknown>;
 };
 
+/** Per-file upload lifecycle for progress UI driven from outside. */
+type FileUploadStatus = 'idle' | 'uploading' | 'success' | 'error';
+/**
+ * Controlled item shape — UseForm-friendly.
+ *
+ * Store `FileUploadItem[]` in form state; submit with `.map((i) => i.file)`.
+ * Drive progress from the parent by updating `progress` / `status` / `error`
+ * on the same items (keep stable `id`s).
+ */
+type FileUploadItem = {
+    id: string;
+    file: File;
+    /** 0–100. Shown when status is uploading or when explicitly set. */
+    progress?: number;
+    error?: string;
+    status?: FileUploadStatus;
+};
+
 type FormFieldType = typeof FIELD_TYPEs[keyof typeof FIELD_TYPEs];
 type Explanation = {
     title?: string;
@@ -370,6 +545,8 @@ type SliderFieldConfig<T extends FormTypeMap = FormTypeMap> = FieldWithSlots<typ
 type CheckFieldConfig<T extends FormTypeMap = FormTypeMap> = FieldWithSlots<typeof FIELD_TYPEs.check, CheckSlotProps, T>;
 type DateFieldConfig<T extends FormTypeMap = FormTypeMap> = FieldWithSlots<typeof FIELD_TYPEs.date, DateSlotProps, T>;
 type DateTimeFieldConfig<T extends FormTypeMap = FormTypeMap> = FieldWithSlots<typeof FIELD_TYPEs.dateTime, DateTimeSlotProps, T>;
+type TimeFieldConfig<T extends FormTypeMap = FormTypeMap> = FieldWithSlots<typeof FIELD_TYPEs.time, TimeSlotProps, T>;
+type DateRangeFieldConfig<T extends FormTypeMap = FormTypeMap> = FieldWithSlots<typeof FIELD_TYPEs.dateRange, DateRangeSlotProps, T>;
 type ToggleButtonFieldConfig<T extends FormTypeMap = FormTypeMap> = FieldWithSlots<typeof FIELD_TYPEs.toggleButton, ToggleButtonSlotProps, T>;
 type AutocompleteFieldConfig<T extends FormTypeMap = FormTypeMap> = FieldWithSlots<typeof FIELD_TYPEs.autocomplete, AutocompleteSlotProps, T>;
 type SwitchFieldConfig<T extends FormTypeMap = FormTypeMap> = FieldWithSlots<typeof FIELD_TYPEs.switch, SwitchSlotProps, T>;
@@ -380,7 +557,7 @@ type CustomFieldConfig<T extends FormTypeMap = FormTypeMap> = FieldWithSlots<typ
 type TextArrayFieldConfig<T extends FormTypeMap = FormTypeMap> = FieldWithSlots<typeof FIELD_TYPEs.textArray, TextArraySlotProps, T>;
 type FileUploadFieldConfig<T extends FormTypeMap = FormTypeMap> = FieldWithSlots<typeof FIELD_TYPEs.fileUpload, FileUploadSlotProps, T>;
 type AvatarFieldConfig<T extends FormTypeMap = FormTypeMap> = FieldWithSlots<typeof FIELD_TYPEs.avatar, AvatarSlotProps, T>;
-type FieldConfig<T extends FormTypeMap = FormTypeMap> = TextFieldConfig<T> | SelectFieldConfig<T> | SliderFieldConfig<T> | CheckFieldConfig<T> | DateFieldConfig<T> | DateTimeFieldConfig<T> | ToggleButtonFieldConfig<T> | AutocompleteFieldConfig<T> | SwitchFieldConfig<T> | NumberFieldConfig<T> | JsonFieldConfig<T> | TextArrayFieldConfig<T> | CustomFieldConfig<T> | FileUploadFieldConfig<T> | AvatarFieldConfig<T> | TelFieldConfig<T>;
+type FieldConfig<T extends FormTypeMap = FormTypeMap> = TextFieldConfig<T> | SelectFieldConfig<T> | SliderFieldConfig<T> | CheckFieldConfig<T> | DateFieldConfig<T> | DateTimeFieldConfig<T> | TimeFieldConfig<T> | DateRangeFieldConfig<T> | ToggleButtonFieldConfig<T> | AutocompleteFieldConfig<T> | SwitchFieldConfig<T> | NumberFieldConfig<T> | JsonFieldConfig<T> | TextArrayFieldConfig<T> | CustomFieldConfig<T> | FileUploadFieldConfig<T> | AvatarFieldConfig<T> | TelFieldConfig<T>;
 type RowConfig<T extends FormTypeMap = FormTypeMap> = {
     row: number | string;
     fields: FieldConfig<T>[];
@@ -399,7 +576,10 @@ type FormConfig<T extends FormTypeMap = FormTypeMap> = {
     mode?: 'onSubmit' | 'onBlur' | 'onChange' | 'onTouched' | 'all';
 };
 type FormTypeMap = Record<string, FormFieldType>;
-type GetDataType<T extends FormFieldType> = T extends typeof FIELD_TYPEs.text ? string : T extends typeof FIELD_TYPEs.select ? string | string[] : T extends typeof FIELD_TYPEs.slider ? number : T extends typeof FIELD_TYPEs.check ? string[] : T extends typeof FIELD_TYPEs.date ? string | Date : T extends typeof FIELD_TYPEs.dateTime ? string | Date : T extends typeof FIELD_TYPEs.toggleButton ? string : T extends typeof FIELD_TYPEs.autocomplete ? string | string[] : T extends typeof FIELD_TYPEs.switch ? boolean : T extends typeof FIELD_TYPEs.number ? number : T extends typeof FIELD_TYPEs.tel ? string : T extends typeof FIELD_TYPEs.json ? unknown : T extends typeof FIELD_TYPEs.textArray ? string[] : T extends typeof FIELD_TYPEs.custom ? unknown : T extends typeof FIELD_TYPEs.fileUpload ? PreviewableFile[] : T extends typeof FIELD_TYPEs.avatar ? PreviewableFile | null : unknown;
+type GetDataType<T extends FormFieldType> = T extends typeof FIELD_TYPEs.text ? string : T extends typeof FIELD_TYPEs.select ? string | string[] : T extends typeof FIELD_TYPEs.slider ? number : T extends typeof FIELD_TYPEs.check ? string[] : T extends typeof FIELD_TYPEs.date ? string | Date : T extends typeof FIELD_TYPEs.dateTime ? string | Date : T extends typeof FIELD_TYPEs.time ? string | Date : T extends typeof FIELD_TYPEs.dateRange ? {
+    start: Date | null;
+    end: Date | null;
+} : T extends typeof FIELD_TYPEs.toggleButton ? string : T extends typeof FIELD_TYPEs.autocomplete ? string | string[] : T extends typeof FIELD_TYPEs.switch ? boolean : T extends typeof FIELD_TYPEs.number ? number : T extends typeof FIELD_TYPEs.tel ? string : T extends typeof FIELD_TYPEs.json ? unknown : T extends typeof FIELD_TYPEs.textArray ? string[] : T extends typeof FIELD_TYPEs.custom ? unknown : T extends typeof FIELD_TYPEs.fileUpload ? FileUploadItem[] : T extends typeof FIELD_TYPEs.avatar ? File | null : unknown;
 type InferFormDataType<T extends FormTypeMap> = {
     [K in keyof T]: GetDataType<T[K]>;
 };
@@ -415,6 +595,10 @@ type StrictFieldConfig<T extends FormTypeMap, K extends keyof T = keyof T> = K e
     name: K;
 } : T[K] extends typeof FIELD_TYPEs.dateTime ? DateTimeFieldConfig<T> & {
     name: K;
+} : T[K] extends typeof FIELD_TYPEs.time ? TimeFieldConfig<T> & {
+    name: K;
+} : T[K] extends typeof FIELD_TYPEs.dateRange ? DateRangeFieldConfig<T> & {
+    name: K;
 } : T[K] extends typeof FIELD_TYPEs.toggleButton ? ToggleButtonFieldConfig<T> & {
     name: K;
 } : T[K] extends typeof FIELD_TYPEs.autocomplete ? AutocompleteFieldConfig<T> & {