@takeoff-ui/react-spar 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { HTMLAttributes, ElementType, ComponentPropsWithoutRef, ReactNode, Ref } from 'react';
+import { HTMLAttributes, ElementType, ComponentPropsWithoutRef, ReactNode, Ref, ImgHTMLAttributes } from 'react';
 import { PolymorphicProps, AccordionProps as AccordionProps$1, AccordionItemProps as AccordionItemProps$1, AccordionHeaderProps as AccordionHeaderProps$1, AccordionContentProps as AccordionContentProps$1, BreadcrumbProps as BreadcrumbProps$1, BreadcrumbItemRenderProps, BreadcrumbLinkProps as BreadcrumbLinkProps$1, NavigationHandler, PressEvent, ButtonProps as ButtonProps$1, CheckboxRenderProps as CheckboxRenderProps$1, CheckboxProps as CheckboxProps$1, DialogProps as DialogProps$1, DialogTriggerProps as DialogTriggerProps$1, DialogOverlayProps as DialogOverlayProps$1, DialogContentProps, DialogTitleProps as DialogTitleProps$1, DialogCloseProps as DialogCloseProps$1, DropdownMenuProps, DropdownMenuTriggerProps, DropdownMenuContentProps, DropdownMenuViewportProps, DropdownMenuItemProps, DropdownMenuGroupProps, DropdownMenuLabelProps, DropdownMenuSeparatorProps, DropdownMenuArrowProps, FieldProps as FieldProps$1, FieldLabelProps as FieldLabelProps$1, FieldDescriptionProps as FieldDescriptionProps$1, FieldErrorMessageProps as FieldErrorMessageProps$1, InputProps as InputProps$1, InputFieldProps as InputFieldProps$1, LabelProps as LabelProps$1, RadioProps as RadioProps$1, RadioItemRenderProps, RadioItemProps as RadioItemProps$1, PopoverProps as PopoverProps$1, PopoverTriggerProps as PopoverTriggerProps$1, PopoverContentProps as PopoverContentProps$1, PopoverCloseProps as PopoverCloseProps$1, SelectProps as SelectProps$1, SelectTriggerProps as SelectTriggerProps$1, SelectContentProps as SelectContentProps$1, SelectViewportProps as SelectViewportProps$1, SelectItemProps as SelectItemProps$1, SelectGroupProps as SelectGroupProps$1, SelectLabelProps as SelectLabelProps$1, SelectSeparatorProps as SelectSeparatorProps$1, SwitchRenderProps as SwitchRenderProps$1, SwitchProps as SwitchProps$1, TabsProps as TabsProps$1, TabsListProps as TabsListProps$1, TabsTriggerRenderProps as TabsTriggerRenderProps$1, TabsTriggerProps as TabsTriggerProps$1, TabsContentProps as TabsContentProps$1, TabsActivationMode as TabsActivationMode$1, TooltipTriggerProps as TooltipTriggerProps$1, TooltipContentProps as TooltipContentProps$1, TooltipProps as TooltipProps$1, TooltipProviderProps as TooltipProviderProps$1, ToasterController, ToastData as ToastData$1, ToasterProps as ToasterProps$1, ToastOptions as ToastOptions$1 } from '@turkish-technology/spar';
 export { BreadcrumbItemRenderProps, BreadcrumbPosition, CreateToasterOptions, ToastAnnouncement, ToastPlacement, ToastPromiseOptions, ToastStatus, ToastType, ToastUpdateOptions, ToasterController, createToaster } from '@turkish-technology/spar';
 import * as _tanstack_react_table from '@tanstack/react-table';
@@ -896,7 +896,7 @@ declare const Chip: {
  * Side from which the drawer slides in.
  * @defaultValue 'right'
  */
-type DrawerPlacement = 'left' | 'right' | 'top' | 'bottom' | 'full-screen';
+type DrawerPlacement = 'left' | 'right' | 'top' | 'bottom';
 type DrawerOverlaySlot = 'root';
 type DrawerPanelSlot = 'root';
 type DrawerHeaderSlot = 'root';
@@ -3588,4 +3588,463 @@ declare const Skeleton: {
     displayName: string;
 };
 
-export { Accordion, type AccordionContentProps, type AccordionCurrentValue, type AccordionHeaderProps, type AccordionHeadingLevel, type AccordionIndicatorProps, type AccordionIndicatorRenderState, type AccordionItemProps, type AccordionMode, type AccordionProps, type AccordionSize, type AccordionTriggerProps, type AccordionType, type AccordionValue, type AccordionValueChangeHandler, Alert, type AlertActionsProps, type AlertActionsSlot, type AlertAppearance, type AlertCloseProps, type AlertCloseSlot, type AlertContentProps, type AlertContentSlot, type AlertDescriptionProps, type AlertDescriptionSlot, type AlertProps, type AlertSlot, type AlertTitleProps, type AlertTitleSlot, type AlertVariant, Badge, type BadgeAppearance, type BadgeProps, type BadgeSize, type BadgeSlot, type BadgeVariant, Breadcrumb, type BreadcrumbItemProps, type BreadcrumbLinkProps, type BreadcrumbListProps, type BreadcrumbNavigationHandler, type BreadcrumbPageProps, type BreadcrumbPressEvent, type BreadcrumbProps, type BreadcrumbSeparatorProps, type BreadcrumbSize, type BreadcrumbType, Button, type ButtonAppearance, type ButtonProps, type ButtonSize, type ButtonSlot, type ButtonVariant, Card, type CardBodyProps, type CardBodySlot, type CardDescriptionProps, type CardDescriptionSlot, type CardFooterProps, type CardFooterSlot, type CardFooterType, type CardHeaderProps, type CardHeaderSlot, type CardHeaderType, type CardProps, type CardSlot, type CardTitleProps, type CardTitleSlot, Checkbox, type CheckboxIndicatorProps, type CheckboxIndicatorRenderProps, type CheckboxProps, type CheckboxRenderProps, type CheckboxSize, type CheckboxSlot, Chip, type ChipAppearance, type ChipProps, type ChipSize, type ChipSlot, type ChipVariant, type ClassNamesMap, type ColorMode, type ComponentName, type ComponentThemeConfig, type ComponentThemeRegistry, type ComponentsThemeMap, type ControlledState, type DataSlotName, Dialog, type DialogBodyProps, type DialogBodySlot, type DialogCloseProps, type DialogCloseSlot, type DialogDescriptionProps, type DialogDescriptionSlot, type DialogFooterProps, type DialogFooterSlot, type DialogFooterType, type DialogHeaderProps, type DialogHeaderSlot, type DialogHeaderType, type DialogOverlayIntensity, type DialogOverlayProps, type DialogOverlaySlot, type DialogPanelProps, type DialogPanelSlot, type DialogProps, type DialogTitleProps, type DialogTitleSlot, type DialogTriggerProps, type DialogTriggerSlot, Divider, type DividerAlign, type DividerAppearance, type DividerOrientation, type DividerProps, type DividerSlot, Drawer, type DrawerBodyProps, type DrawerCloseProps, type DrawerDescriptionProps, type DrawerFooterProps, type DrawerHeaderProps, type DrawerOverlayProps, type DrawerPanelProps, type DrawerPlacement, type DrawerProps, type DrawerTitleProps, type DrawerTriggerProps, Dropdown, type DropdownArrowProps, type DropdownContentProps, type DropdownContentWidth, type DropdownGroupProps, type DropdownItemProps, type DropdownLabelProps, type DropdownProps, type DropdownSeparatorProps, type DropdownSize, type DropdownTriggerProps, type DropdownViewportProps, Field, type FieldDescriptionProps, type FieldDescriptionSlot, type FieldErrorMessageProps, type FieldErrorMessageSlot, type FieldLabelProps, type FieldLabelSlot, type FieldProps, type FieldSlot, Input, type InputChipsProps, type InputChipsSlot, type InputClearButtonProps, type InputClearButtonSlot, type InputDecrementProps, type InputDecrementSlot, type InputFieldProps, type InputFieldSlot, type InputIncrementProps, type InputIncrementSlot, type InputLeadingIconProps, type InputLeadingIconSlot, type InputPrefixProps, type InputPrefixSlot, type InputProps, type InputRevealButtonProps, type InputRevealButtonSlot, type InputSize, type InputSlot, type InputSpinnerProps, type InputSpinnerSlot, type InputStepperProps, type InputStepperSlot, type InputStrengthProps, type InputStrengthSlot, type InputSuffixProps, type InputSuffixSlot, type InputTrailingIconProps, type InputTrailingIconSlot, Label, type LabelProps, type LabelSlot, Popover, type PopoverArrowProps, type PopoverArrowSlot, type PopoverCloseProps, type PopoverCloseSlot, type PopoverContentProps, type PopoverContentSlot, type PopoverDescriptionProps, type PopoverDescriptionSlot, type PopoverHeaderProps, type PopoverHeaderSlot, type PopoverProps, type PopoverTriggerProps, type PopoverTriggerSlot, type PopoverVariant, Progress, type ProgressAppearance, type ProgressIndicatorProps, type ProgressIndicatorSlot, type ProgressProps, type ProgressSize, type ProgressSlot, type ProgressTrackProps, type ProgressTrackSlot, type ProgressValueProps, type ProgressValueSlot, type ProgressVariant, Radio, type RadioIndicatorProps, type RadioItemProps, type RadioItemSlot, type RadioLabelProps, type RadioPosition, type RadioProps, type RadioRenderProps, type RadioSize, type RadioSlot, Select, type SelectArrowProps, type SelectContentProps, type SelectGroupProps, type SelectIndicatorProps, type SelectIndicatorRenderState, type SelectItemProps, type SelectLabelProps, type SelectProps, type SelectSeparatorProps, type SelectSize, type SelectTriggerProps, type SelectViewportProps, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonShape, type SkeletonSlot, Slider, type SliderOrientation, type SliderProps, type SliderRangeProps, type SliderRangeValueProps, type SliderSingleValueProps, type SliderSize, type SliderSlot, type SliderThumbProps, type SliderThumbRenderProps, type SliderTicksProps, type SliderTooltip, type SliderTrackMode, type SliderTrackProps, type SliderValue, type SliderValueProps, type SliderValueRenderProps, type SliderVariant, type SlotClassNames, type SlotPropsMap, Spinner, type SpinnerAppearance, type SpinnerProps, type SpinnerSize, type SpinnerSlot, type SpinnerVariant, type StateOnlyComponentThemeConfig$1 as StateOnlyComponentThemeConfig, Stepper, type StepperDescriptionProps, type StepperIndicatorState, type StepperItemProps, type StepperMode, type StepperOrientation, type StepperProps, type StepperSize, type StepperStepClickDetail, type StepperStepStatus, type StepperTitleProps, Switch, type SwitchIndicatorProps, type SwitchIndicatorRenderProps, type SwitchProps, type SwitchRenderProps, type SwitchSize, type SwitchSlot, type SwitchVariant, Table, type TableAlign, type TableColumnAccessor, type TableColumnDef, type TableColumnFilter, type TableColumnFilterContext, type TableColumnFilterOption, type TableColumnFilterType, type TableColumnMeta, type TableDataRequest, type TableExpansionConfig, type TableFilteringConfig, type TablePaginationConfig, type TableProps, type TableSelectionConfig, type TableSize, type TableSlot, type TableSortingConfig, type TableStickySide, Tabs, type TabsActivationMode, type TabsAppearance, type TabsContentProps, type TabsListProps, type TabsProps, type TabsSize, type TabsTriggerProps, type TabsTriggerRenderProps, type TabsVariant, TakeoffSparProvider, type TakeoffSparProviderProps, type TakeoffSparProviderValue, type ThemeValue, Toast, type ToastAppearance, type ToastData, type ToastOptions, type ToastProps, type ToastSlot, type ToastVariant, Toaster, type ToasterOwnProps, type ToasterProps, type ToasterSlot, Tooltip, type TooltipArrowProps, type TooltipArrowSlot, type TooltipContentProps, type TooltipContentSlot, type TooltipDescriptionProps, type TooltipDescriptionSlot, type TooltipHeaderProps, type TooltipHeaderSlot, type TooltipProps, type TooltipProviderProps, type TooltipTriggerProps, type TooltipTriggerSlot, type TooltipVariant, getExportRows, useComponentTheme, useTheme };
+type UploadSlot = 'root';
+type UploadDropzoneSlot = 'root';
+type UploadActionsSlot = 'root';
+type UploadTriggerSlot = 'root';
+type UploadSubmitSlot = 'root';
+type UploadListSlot = 'root';
+type UploadItemSlot = 'root';
+type UploadItemContentSlot = 'root' | 'name' | 'size' | 'status' | 'progress';
+type UploadItemPreviewSlot = 'root' | 'image' | 'icon' | 'extension';
+type UploadItemActionsSlot = 'root';
+type UploadItemActionSlot = 'root';
+/**
+ * Per-file lifecycle status, driven by the consumer (the component does not
+ * upload): `'idle'` is the resting state, `'uploading'` the transfer itself (the
+ * only status that draws the progress bar), `'processing'` the server's own step
+ * once the bytes have landed, which reports no percentage, and `'completed'` /
+ * `'error'` the two outcomes.
+ */
+type UploadFileStatus = 'idle' | 'uploading' | 'processing' | 'completed' | 'error';
+/**
+ * A file in the Upload value: a plain object that *points at* a picked `File`,
+ * or stands for a remote/preloaded one through its `url`. `name` / `size` /
+ * `type` may be set on the entry or read off `file`; the entry's own value
+ * always wins.
+ */
+interface UploadFile {
+    /** Stable identity (React key, status mapping). Generated for picked files. */
+    id: string;
+    /** The local bytes. Absent for a remote/preloaded entry, which uses `url`. */
+    file?: File;
+    /** Display name. Read off `file` when the entry does not state it. */
+    name?: string;
+    /** Size in bytes. Read off `file` when the entry does not state it. */
+    size?: number;
+    /** MIME type. Read off `file` when the entry does not state it. */
+    type?: string;
+    /** Remote URL for download / image preview when the bytes are not local. */
+    url?: string;
+    /**
+     * A picture *of* the file rather than the file itself — a server-rendered
+     * first page, a video's poster frame. Shown whatever the entry's `type` is,
+     * which is what puts a non-image on the image branch; the download ignores it.
+     */
+    thumbUrl?: string;
+    /**
+     * Lifecycle status. Optional because an entry without one already means the
+     * resting state.
+     * @defaultValue 'idle'
+     */
+    status?: UploadFileStatus;
+    /** Upload progress 0–100 while `status` is `'uploading'`. */
+    progress?: number;
+    /** Human-readable error, shown when `status` is `'error'`. */
+    error?: string;
+}
+/**
+ * A file that failed validation, emitted (batched) through `onFilesReject` —
+ * rejected files never enter `value`, so this is the only way a consumer learns
+ * about them. Discriminated on `code`, and each branch carries the limit that
+ * was broken, since the sentence shown to the user is the consumer's to write.
+ */
+type UploadRejection = {
+    file: File;
+    code: 'file-invalid-type';
+    /** The `accept` list the file failed to match. */
+    accept: string;
+} | {
+    file: File;
+    code: 'file-too-large';
+    /** The `maxFileSize` (bytes) the file exceeded. */
+    maxFileSize: number;
+} | {
+    file: File;
+    code: 'too-many-files';
+    /** How many files were allowed — `maxFileCount`, or 1 without `multiple`. */
+    maxFileCount: number;
+};
+/**
+ * State + validation props owned by the Upload root. The anatomy — dropzone,
+ * trigger, per-file actions — is expressed by composing parts rather than by
+ * flags, mirroring the Input "modes as composition" model.
+ */
+interface UploadOwnProps {
+    /** Committed files (controlled). Pair with `onValueChange`. */
+    value?: UploadFile[];
+    /** Initial files for uncontrolled usage. */
+    defaultValue?: UploadFile[];
+    /** Called with the next file array after a selection, drop, or removal. */
+    onValueChange?: (files: UploadFile[]) => void;
+    /** Acceptable file types — comma-separated MIME types (`image/*`) and/or extensions (`.pdf`). */
+    accept?: string;
+    /**
+     * Allow selecting/holding more than one file. When `false`, a new selection
+     * replaces the current file.
+     * @defaultValue false
+     */
+    multiple?: boolean;
+    /**
+     * Browse folders instead of single files: the picker takes a directory and
+     * every file inside it (recursively), each keeping its `webkitRelativePath`
+     * (e.g. `reports/2024/q1.pdf`) for rebuilding the tree. Implies `multiple`.
+     * Only affects the picker — dropping a folder on `Upload.Dropzone` does not
+     * expand it.
+     * @defaultValue false
+     */
+    directory?: boolean;
+    /** Maximum size per file, in bytes. Larger files are rejected. */
+    maxFileSize?: number;
+    /** Maximum number of files (only meaningful with `multiple`). Extra files are rejected. */
+    maxFileCount?: number;
+    /**
+     * Called with the entries that just entered the value — the files wrapped this
+     * batch rather than the whole array, which is what a consumer starts its own
+     * upload from. Files dropped as duplicates of ones already held are not
+     * reported.
+     */
+    onFileAccept?: (files: UploadFile[]) => void;
+    /** Called with every file rejected by validation (type, size, or count). */
+    onFilesReject?: (rejections: UploadRejection[]) => void;
+    /**
+     * Row support text while a file transfers. Localize per upload; an empty
+     * string drops the status line, glyph included.
+     * @defaultValue 'Uploading…'
+     */
+    uploadingLabel?: string;
+    /**
+     * Row support text while the server works on a file that has landed.
+     * Localize per upload; an empty string drops the status line, glyph included.
+     * @defaultValue 'Processing…'
+     */
+    processingLabel?: string;
+    /**
+     * Row support text once a file is done. Localize per upload; an empty string
+     * drops the status line, glyph included.
+     * @defaultValue 'Completed'
+     */
+    completedLabel?: string;
+    /**
+     * Row support text for a failure that reports no `error` message of its own —
+     * an entry's own `error` always wins. Localize per upload; an empty string
+     * drops the status line, glyph included.
+     * @defaultValue 'Failed'
+     */
+    errorLabel?: string;
+    /**
+     * Accessible name for a row's progress bar, as a template: `{name}` stands
+     * for the file's name, so several bars uploading at once stay distinguishable.
+     * An empty string counts as unset — the bar cannot go unnamed.
+     * @defaultValue '{name} upload progress'
+     */
+    progressLabel?: string;
+    /**
+     * Accessible name for the built-in `action="download"`, as a `{name}`
+     * template. An `Upload.ItemAction`'s own `label` wins over it, and an empty
+     * string counts as unset — an icon-only button cannot go unnamed.
+     * @defaultValue 'Download {name}'
+     */
+    downloadLabel?: string;
+    /**
+     * Accessible name for the built-in `action="remove"`, as a `{name}` template.
+     * An `Upload.ItemAction`'s own `label` wins over it, and an empty string
+     * counts as unset — an icon-only button cannot go unnamed.
+     * @defaultValue 'Remove {name}'
+     */
+    removeLabel?: string;
+    /** Disables the whole control. Also inherited from a surrounding `Field`. */
+    disabled?: boolean;
+    /** Read-only: files render and remain downloadable, but adding/removing is blocked. Also inherited from `Field`. */
+    readOnly?: boolean;
+    /** Marks the control invalid — mirrored as `data-invalid` for the recipe's danger styling. Also inherited from `Field`. */
+    invalid?: boolean;
+    /** Per-slot class name overrides. */
+    classNames?: ClassNamesMap<UploadSlot>;
+    /** Per-slot HTML attribute overrides. */
+    slotProps?: SlotPropsMap<UploadSlot>;
+}
+/** Public props for the Upload root. Polymorphic via `as` (default `div`). */
+type UploadProps<T extends ElementType = 'div'> = PolymorphicProps<'div', T, UploadOwnProps>;
+interface UploadDropzoneOwnProps {
+    /** Zone content — typically a prompt and an `Upload.Trigger`. */
+    children?: ReactNode;
+    classNames?: ClassNamesMap<UploadDropzoneSlot>;
+    slotProps?: SlotPropsMap<UploadDropzoneSlot>;
+}
+/**
+ * Drag-and-drop target. Composing it is what enables drag-and-drop; it owns the
+ * `data-drag-state` (`accept` | `reject`) styling hook while a payload hovers.
+ */
+type UploadDropzoneProps<T extends ElementType = 'div'> = PolymorphicProps<'div', T, UploadDropzoneOwnProps>;
+interface UploadActionsOwnProps {
+    /** The controls to put on one line — typically `Upload.Trigger` and `Upload.Submit`. */
+    children?: ReactNode;
+    classNames?: ClassNamesMap<UploadActionsSlot>;
+    slotProps?: SlotPropsMap<UploadActionsSlot>;
+}
+/**
+ * A row for controls that belong together. `Upload.Dropzone` stacks its
+ * children, so a Browse button and a Send button written as bare siblings each
+ * take a line of their own; wrapping them in this part puts them side by side.
+ * It holds no behavior — anywhere a set of controls should share a line, this is
+ * the box for it.
+ */
+type UploadActionsProps<T extends ElementType = 'div'> = PolymorphicProps<'div', T, UploadActionsOwnProps>;
+interface UploadTriggerOwnProps {
+    /** Trigger label (e.g. `"Choose file"`). */
+    children?: ReactNode;
+    /**
+     * Button appearance. Quieter than Button's own default, and the treatment
+     * `Upload.Submit` takes too — the two stand beside each other in the zone, so
+     * they read as one pair. Re-point it on a Trigger that stands alone.
+     * @defaultValue 'outlined'
+     */
+    appearance?: ButtonAppearance;
+    /**
+     * Button color variant.
+     * @defaultValue 'neutral'
+     */
+    variant?: ButtonVariant;
+    classNames?: ClassNamesMap<UploadTriggerSlot>;
+    slotProps?: SlotPropsMap<UploadTriggerSlot>;
+}
+/** Button that opens the native file picker. Focusable; disabled when the upload is disabled or read-only. */
+type UploadTriggerProps<T extends ElementType = 'button'> = PolymorphicProps<'button', T, UploadTriggerOwnProps>;
+interface UploadSubmitOwnProps {
+    /** Submit label (e.g. `"Upload"`). Wire the actual upload through `onClick`. */
+    children?: ReactNode;
+    /**
+     * Button appearance. The Trigger's, not Button's own: the two stand beside
+     * each other in the zone, so they read as one pair rather than as two weights.
+     * Re-point it where the send is the page's primary action.
+     * @defaultValue 'outlined'
+     */
+    appearance?: ButtonAppearance;
+    /**
+     * Button color variant.
+     * @defaultValue 'neutral'
+     */
+    variant?: ButtonVariant;
+    classNames?: ClassNamesMap<UploadSubmitSlot>;
+    slotProps?: SlotPropsMap<UploadSubmitSlot>;
+}
+/**
+ * Optional "upload" button. The component does not perform the network upload
+ * (out of scope) — wire it through `onClick`. Disabled while there are no files
+ * or when the upload is disabled; read-only leaves it working, since handing a
+ * fixed list upstream does not change it.
+ */
+type UploadSubmitProps<T extends ElementType = 'button'> = PolymorphicProps<'button', T, UploadSubmitOwnProps>;
+interface UploadListOwnProps {
+    /**
+     * The rows. A function receives the current files and returns them (the usual
+     * form — the consumer owns the map, so each `Upload.Item` gets its `file` and
+     * every action closes over it). Plain nodes are rendered as authored. Omit it
+     * for a default `Upload.Item` per file.
+     */
+    children?: ReactNode | ((files: UploadFile[]) => ReactNode);
+    classNames?: ClassNamesMap<UploadListSlot>;
+    slotProps?: SlotPropsMap<UploadListSlot>;
+}
+/**
+ * File list region. Renders nothing while empty; otherwise its children (or a
+ * default row per file).
+ */
+type UploadListProps<T extends ElementType = 'div'> = PolymorphicProps<'div', T, UploadListOwnProps>;
+interface UploadItemOwnProps {
+    /** The file this row renders. Also what its `Upload.ItemAction` children read. */
+    file: UploadFile;
+    /**
+     * Action controls (`Upload.ItemAction`), wrapped in a default
+     * `Upload.ItemActions` for you — and *replacing* its default download + remove
+     * pair rather than joining it. Composing `Upload.ItemPreview`,
+     * `Upload.ItemContent`, or `Upload.ItemActions` replaces that region instead,
+     * each hoisted into its own position wherever it is written; with an
+     * `Upload.ItemActions` composed, anything else stays where it was written.
+     */
+    children?: ReactNode;
+    classNames?: ClassNamesMap<UploadItemSlot>;
+    slotProps?: SlotPropsMap<UploadItemSlot>;
+}
+/**
+ * Per-file row, in three regions: preview · content · actions. Every region has
+ * a default, so a bare row with only `file` is complete. Mirrors the entry's
+ * `status` as `data-status`.
+ */
+type UploadItemProps<T extends ElementType = 'div'> = PolymorphicProps<'div', T, UploadItemOwnProps>;
+interface UploadItemContentOwnProps {
+    /**
+     * Replaces the file's details entirely — your own name/meta layout, a
+     * description line, an inline error. Omit it for the default content (name,
+     * size, status icon, and the progress bar while uploading).
+     */
+    children?: ReactNode;
+    classNames?: ClassNamesMap<UploadItemContentSlot>;
+    slotProps?: SlotPropsMap<UploadItemContentSlot>;
+}
+/**
+ * The row's middle region: the file's name, its formatted size, the status icon
+ * (spinner / check / warning), and the progress bar while the entry uploads —
+ * all decorative inline slots of this part, styled through `classNames` /
+ * `slotProps`. `Upload.Item` renders it by default, and it reads its file from
+ * the surrounding row.
+ */
+type UploadItemContentProps<T extends ElementType = 'div'> = PolymorphicProps<'div', T, UploadItemContentOwnProps>;
+/**
+ * Per-slot attribute overrides for the preview. The `image` slot renders an
+ * `<img>`, so it also accepts image attributes (`alt`, `loading`, `sizes`, …) —
+ * the part's own `alt=""` / `loading="lazy"` are defaults a call site can
+ * replace, not invariants.
+ */
+type UploadItemPreviewSlotProps = SlotPropsMap<UploadItemPreviewSlot> & {
+    image?: ImgHTMLAttributes<HTMLImageElement>;
+};
+interface UploadItemPreviewOwnProps {
+    /**
+     * Replaces the built-in thumbnail entirely — your own glyph, a video poster,
+     * a rendered document page. Omit it for the default preview (image thumbnail,
+     * file-type icon, or extension badge).
+     */
+    children?: ReactNode;
+    classNames?: ClassNamesMap<UploadItemPreviewSlot>;
+    slotProps?: UploadItemPreviewSlotProps;
+}
+/**
+ * The row's thumbnail, in three branches: an image preview for image entries (a
+ * local `File` through an object URL revoked on unmount/change, a remote entry
+ * through its `url`), the shipped file-type icon (PDF, Word, Excel, PowerPoint,
+ * JPG, PNG, MP4, TXT, ZIP), and the uppercased extension for everything else.
+ * `Upload.Item` renders it by default, and it reads its file from the
+ * surrounding row.
+ */
+type UploadItemPreviewProps<T extends ElementType = 'span'> = PolymorphicProps<'span', T, UploadItemPreviewOwnProps>;
+interface UploadItemActionsOwnProps {
+    /**
+     * The row's actions. Replaces the default pair (`download` + `remove`)
+     * entirely — pass the `Upload.ItemAction`s you want, in the order you want.
+     */
+    children?: ReactNode;
+    classNames?: ClassNamesMap<UploadItemActionsSlot>;
+    slotProps?: SlotPropsMap<UploadItemActionsSlot>;
+}
+/**
+ * The row's trailing action area. `Upload.Item` renders it by default — holding
+ * a download and a remove action — so it only needs composing to change that set
+ * or to style / move the container itself.
+ */
+type UploadItemActionsProps<T extends ElementType = 'div'> = PolymorphicProps<'div', T, UploadItemActionsOwnProps>;
+interface UploadItemActionOwnProps {
+    /**
+     * Names the action, mirrored as `data-action` whatever the name is.
+     *
+     * Two names arrive wired, each with its own icon and label: `'download'` saves
+     * the row's file (its `File` through an object URL, a preloaded entry through
+     * its `url`) and stays available in read-only; `'remove'` drops the file from
+     * `value` and is not rendered at all in read-only. Any other name —
+     * `'preview'`, `'retry'`, `'share'` — is yours: the behavior comes from
+     * `onClick`, the glyph from `children`, the wording from `label`.
+     */
+    action?: 'download' | 'remove' | (string & {});
+    /**
+     * Accessible name for the action, as a template: `{name}` stands for the
+     * file's name, so `"Preview {name}"` gives `aria-label="Preview report.pdf"`
+     * and icon-only actions stay labelled per file. An explicit `aria-label` wins
+     * over it, and an empty one counts as unset, so a built-in action falls back
+     * to the root's copy rather than losing its name.
+     * @defaultValue the root's copy for the `action` (`downloadLabel` / `removeLabel`)
+     */
+    label?: string;
+    /** Action content — typically an icon. Defaults to the `action`'s own glyph. */
+    children?: ReactNode;
+    /**
+     * Button appearance. Defaults to the row's shape — a small, quiet icon button
+     * beside the file's details — rather than Button's own default, so a text-only
+     * remove or a danger-coloured one is a re-point, not a rebuild.
+     * @defaultValue 'outlined'
+     */
+    appearance?: ButtonAppearance;
+    /**
+     * Button color variant.
+     * @defaultValue 'neutral'
+     */
+    variant?: ButtonVariant;
+    /**
+     * Button size scale.
+     * @defaultValue 'small'
+     */
+    size?: ButtonSize;
+    classNames?: ClassNamesMap<UploadItemActionSlot>;
+    slotProps?: SlotPropsMap<UploadItemActionSlot>;
+}
+/**
+ * Per-file action control: one focusable, file-labelled button covering the
+ * built-in download / remove and every consumer-wired action — preview, retry,
+ * share — through `onClick`. Rendering it as `as="a" href` hands the download to
+ * the platform instead. Inert when the upload is disabled, or when the call site
+ * disables this one action.
+ */
+type UploadItemActionProps<T extends ElementType = 'button'> = PolymorphicProps<'button', T, UploadItemActionOwnProps>;
+declare module '../../core/theme' {
+    interface ComponentThemeRegistry {
+        Upload: ComponentThemeConfig<UploadProps, UploadSlot>;
+        UploadDropzone: ComponentThemeConfig<UploadDropzoneProps, UploadDropzoneSlot>;
+        UploadActions: ComponentThemeConfig<UploadActionsProps, UploadActionsSlot>;
+        UploadTrigger: ComponentThemeConfig<UploadTriggerProps, UploadTriggerSlot>;
+        UploadSubmit: ComponentThemeConfig<UploadSubmitProps, UploadSubmitSlot>;
+        UploadList: ComponentThemeConfig<UploadListProps, UploadListSlot>;
+        UploadItem: ComponentThemeConfig<UploadItemProps, UploadItemSlot>;
+        UploadItemContent: ComponentThemeConfig<UploadItemContentProps, UploadItemContentSlot>;
+        UploadItemPreview: ComponentThemeConfig<UploadItemPreviewProps, UploadItemPreviewSlot, UploadItemPreviewSlotProps>;
+        UploadItemActions: ComponentThemeConfig<UploadItemActionsProps, UploadItemActionsSlot>;
+        UploadItemAction: ComponentThemeConfig<UploadItemActionProps, UploadItemActionSlot>;
+    }
+}
+
+declare const Upload: {
+    <T extends react.ElementType = "div">(props: UploadProps<T>): react.JSX.Element;
+    displayName: string;
+} & {
+    Dropzone: {
+        <T extends react.ElementType = "div">(props: UploadDropzoneProps<T>): react.JSX.Element;
+        displayName: string;
+    };
+    Actions: {
+        <T extends react.ElementType = "div">(props: UploadActionsProps<T>): react.JSX.Element;
+        displayName: string;
+    };
+    Trigger: {
+        <T extends react.ElementType = "button">(props: UploadTriggerProps<T>): react.JSX.Element;
+        displayName: string;
+    };
+    Submit: {
+        <T extends react.ElementType = "button">(props: UploadSubmitProps<T>): react.JSX.Element;
+        displayName: string;
+    };
+    List: {
+        <T extends react.ElementType = "div">(props: UploadListProps<T>): react.JSX.Element | null;
+        displayName: string;
+    };
+    Item: {
+        <T extends react.ElementType = "div">(props: UploadItemProps<T>): react.JSX.Element;
+        displayName: string;
+    };
+    ItemPreview: {
+        <T extends react.ElementType = "span">(props: UploadItemPreviewProps<T>): react.JSX.Element;
+        displayName: string;
+    };
+    ItemContent: {
+        <T extends react.ElementType = "div">(props: UploadItemContentProps<T>): react.JSX.Element;
+        displayName: string;
+    };
+    ItemActions: {
+        <T extends react.ElementType = "div">(props: UploadItemActionsProps<T>): react.JSX.Element | null;
+        displayName: string;
+    };
+    ItemAction: {
+        <T extends react.ElementType = "button">(props: UploadItemActionProps<T>): react.JSX.Element | null;
+        displayName: string;
+    };
+};
+
+export { Accordion, type AccordionContentProps, type AccordionCurrentValue, type AccordionHeaderProps, type AccordionHeadingLevel, type AccordionIndicatorProps, type AccordionIndicatorRenderState, type AccordionItemProps, type AccordionMode, type AccordionProps, type AccordionSize, type AccordionTriggerProps, type AccordionType, type AccordionValue, type AccordionValueChangeHandler, Alert, type AlertActionsProps, type AlertActionsSlot, type AlertAppearance, type AlertCloseProps, type AlertCloseSlot, type AlertContentProps, type AlertContentSlot, type AlertDescriptionProps, type AlertDescriptionSlot, type AlertProps, type AlertSlot, type AlertTitleProps, type AlertTitleSlot, type AlertVariant, Badge, type BadgeAppearance, type BadgeProps, type BadgeSize, type BadgeSlot, type BadgeVariant, Breadcrumb, type BreadcrumbItemProps, type BreadcrumbLinkProps, type BreadcrumbListProps, type BreadcrumbNavigationHandler, type BreadcrumbPageProps, type BreadcrumbPressEvent, type BreadcrumbProps, type BreadcrumbSeparatorProps, type BreadcrumbSize, type BreadcrumbType, Button, type ButtonAppearance, type ButtonProps, type ButtonSize, type ButtonSlot, type ButtonVariant, Card, type CardBodyProps, type CardBodySlot, type CardDescriptionProps, type CardDescriptionSlot, type CardFooterProps, type CardFooterSlot, type CardFooterType, type CardHeaderProps, type CardHeaderSlot, type CardHeaderType, type CardProps, type CardSlot, type CardTitleProps, type CardTitleSlot, Checkbox, type CheckboxIndicatorProps, type CheckboxIndicatorRenderProps, type CheckboxProps, type CheckboxRenderProps, type CheckboxSize, type CheckboxSlot, Chip, type ChipAppearance, type ChipProps, type ChipSize, type ChipSlot, type ChipVariant, type ClassNamesMap, type ColorMode, type ComponentName, type ComponentThemeConfig, type ComponentThemeRegistry, type ComponentsThemeMap, type ControlledState, type DataSlotName, Dialog, type DialogBodyProps, type DialogBodySlot, type DialogCloseProps, type DialogCloseSlot, type DialogDescriptionProps, type DialogDescriptionSlot, type DialogFooterProps, type DialogFooterSlot, type DialogFooterType, type DialogHeaderProps, type DialogHeaderSlot, type DialogHeaderType, type DialogOverlayIntensity, type DialogOverlayProps, type DialogOverlaySlot, type DialogPanelProps, type DialogPanelSlot, type DialogProps, type DialogTitleProps, type DialogTitleSlot, type DialogTriggerProps, type DialogTriggerSlot, Divider, type DividerAlign, type DividerAppearance, type DividerOrientation, type DividerProps, type DividerSlot, Drawer, type DrawerBodyProps, type DrawerCloseProps, type DrawerDescriptionProps, type DrawerFooterProps, type DrawerHeaderProps, type DrawerOverlayProps, type DrawerPanelProps, type DrawerPlacement, type DrawerProps, type DrawerTitleProps, type DrawerTriggerProps, Dropdown, type DropdownArrowProps, type DropdownContentProps, type DropdownContentWidth, type DropdownGroupProps, type DropdownItemProps, type DropdownLabelProps, type DropdownProps, type DropdownSeparatorProps, type DropdownSize, type DropdownTriggerProps, type DropdownViewportProps, Field, type FieldDescriptionProps, type FieldDescriptionSlot, type FieldErrorMessageProps, type FieldErrorMessageSlot, type FieldLabelProps, type FieldLabelSlot, type FieldProps, type FieldSlot, Input, type InputChipsProps, type InputChipsSlot, type InputClearButtonProps, type InputClearButtonSlot, type InputDecrementProps, type InputDecrementSlot, type InputFieldProps, type InputFieldSlot, type InputIncrementProps, type InputIncrementSlot, type InputLeadingIconProps, type InputLeadingIconSlot, type InputPrefixProps, type InputPrefixSlot, type InputProps, type InputRevealButtonProps, type InputRevealButtonSlot, type InputSize, type InputSlot, type InputSpinnerProps, type InputSpinnerSlot, type InputStepperProps, type InputStepperSlot, type InputStrengthProps, type InputStrengthSlot, type InputSuffixProps, type InputSuffixSlot, type InputTrailingIconProps, type InputTrailingIconSlot, Label, type LabelProps, type LabelSlot, Popover, type PopoverArrowProps, type PopoverArrowSlot, type PopoverCloseProps, type PopoverCloseSlot, type PopoverContentProps, type PopoverContentSlot, type PopoverDescriptionProps, type PopoverDescriptionSlot, type PopoverHeaderProps, type PopoverHeaderSlot, type PopoverProps, type PopoverTriggerProps, type PopoverTriggerSlot, type PopoverVariant, Progress, type ProgressAppearance, type ProgressIndicatorProps, type ProgressIndicatorSlot, type ProgressProps, type ProgressSize, type ProgressSlot, type ProgressTrackProps, type ProgressTrackSlot, type ProgressValueProps, type ProgressValueSlot, type ProgressVariant, Radio, type RadioIndicatorProps, type RadioItemProps, type RadioItemSlot, type RadioLabelProps, type RadioPosition, type RadioProps, type RadioRenderProps, type RadioSize, type RadioSlot, Select, type SelectArrowProps, type SelectContentProps, type SelectGroupProps, type SelectIndicatorProps, type SelectIndicatorRenderState, type SelectItemProps, type SelectLabelProps, type SelectProps, type SelectSeparatorProps, type SelectSize, type SelectTriggerProps, type SelectViewportProps, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonShape, type SkeletonSlot, Slider, type SliderOrientation, type SliderProps, type SliderRangeProps, type SliderRangeValueProps, type SliderSingleValueProps, type SliderSize, type SliderSlot, type SliderThumbProps, type SliderThumbRenderProps, type SliderTicksProps, type SliderTooltip, type SliderTrackMode, type SliderTrackProps, type SliderValue, type SliderValueProps, type SliderValueRenderProps, type SliderVariant, type SlotClassNames, type SlotPropsMap, Spinner, type SpinnerAppearance, type SpinnerProps, type SpinnerSize, type SpinnerSlot, type SpinnerVariant, type StateOnlyComponentThemeConfig$1 as StateOnlyComponentThemeConfig, Stepper, type StepperDescriptionProps, type StepperIndicatorState, type StepperItemProps, type StepperMode, type StepperOrientation, type StepperProps, type StepperSize, type StepperStepClickDetail, type StepperStepStatus, type StepperTitleProps, Switch, type SwitchIndicatorProps, type SwitchIndicatorRenderProps, type SwitchProps, type SwitchRenderProps, type SwitchSize, type SwitchSlot, type SwitchVariant, Table, type TableAlign, type TableColumnAccessor, type TableColumnDef, type TableColumnFilter, type TableColumnFilterContext, type TableColumnFilterOption, type TableColumnFilterType, type TableColumnMeta, type TableDataRequest, type TableExpansionConfig, type TableFilteringConfig, type TablePaginationConfig, type TableProps, type TableSelectionConfig, type TableSize, type TableSlot, type TableSortingConfig, type TableStickySide, Tabs, type TabsActivationMode, type TabsAppearance, type TabsContentProps, type TabsListProps, type TabsProps, type TabsSize, type TabsTriggerProps, type TabsTriggerRenderProps, type TabsVariant, TakeoffSparProvider, type TakeoffSparProviderProps, type TakeoffSparProviderValue, type ThemeValue, Toast, type ToastAppearance, type ToastData, type ToastOptions, type ToastProps, type ToastSlot, type ToastVariant, Toaster, type ToasterOwnProps, type ToasterProps, type ToasterSlot, Tooltip, type TooltipArrowProps, type TooltipArrowSlot, type TooltipContentProps, type TooltipContentSlot, type TooltipDescriptionProps, type TooltipDescriptionSlot, type TooltipHeaderProps, type TooltipHeaderSlot, type TooltipProps, type TooltipProviderProps, type TooltipTriggerProps, type TooltipTriggerSlot, type TooltipVariant, Upload, type UploadActionsProps, type UploadActionsSlot, type UploadDropzoneProps, type UploadDropzoneSlot, type UploadFile, type UploadFileStatus, type UploadItemActionProps, type UploadItemActionSlot, type UploadItemActionsProps, type UploadItemActionsSlot, type UploadItemContentProps, type UploadItemContentSlot, type UploadItemPreviewProps, type UploadItemPreviewSlot, type UploadItemPreviewSlotProps, type UploadItemProps, type UploadItemSlot, type UploadListProps, type UploadListSlot, type UploadProps, type UploadRejection, type UploadSlot, type UploadSubmitProps, type UploadSubmitSlot, type UploadTriggerProps, type UploadTriggerSlot, getExportRows, useComponentTheme, useTheme };