haze-ui 1.32.0 → 1.34.0

package/dist/types/components/TimeGrid/TimeGrid.d.ts

@@ -0,0 +1,58 @@
+import type { ComponentPropsWithoutRef, Ref } from 'react';
+import type { ControlOrValue } from 'react-use-control';
+/**
+ * TimeGrid — a single-select grid of `'HH:mm'` time slots generated
+ * from a `from`..`to` window and a minute `step` (Mantine 8 TimeGrid
+ * precedent). The selection is controllable state
+ * (`ControlOrValue<string>` via useControl): pass a plain string for
+ * uncontrolled usage, a control or `value` + `onChange` for the
+ * controlled flow — `''` is the no-selection sentinel.
+ *
+ * Accessibility: an ARIA radio group — the root carries
+ * `role="radiogroup"` (name it with `aria-label`), every slot is a
+ * native `<button role="radio">` with `aria-checked`. Keyboard follows
+ * the roving-tabindex radio/grid hybrid: the selected slot (else the
+ * first enabled one) is the group's single tab stop; arrows move by
+ * slot (left/right) or by row (`columns`, up/down), Home/End jump the
+ * edges, and every move both focuses and selects — the radio pattern's
+ * arrow-checks semantics. Disabled slots are skipped and unreachable.
+ *
+ * Form participation mirrors Segmented: a `name` renders a hidden
+ * input bridge so `new FormData(form)` / server actions receive the
+ * selected `'HH:mm'`; `''` submits nothing.
+ */
+type TimeGridClassNames = {
+    /** The radiogroup root (`data-slot='time-grid'`). */
+    root?: string;
+    /** Every slot button (`data-slot='cell'`). */
+    cell?: string;
+};
+type TimeGridProps = {
+    /** Selected `'HH:mm'` slot — `ControlOrValue<string>`, `''` = none. */
+    value?: ControlOrValue<string>;
+    onChange?: (value: string) => void;
+    /** Window start, `'HH:mm'`; default '00:00'. */
+    from?: string;
+    /** Window end, `'HH:mm'`, inclusive when step-aligned; default '23:00'. */
+    to?: string;
+    /** Slot cadence in minutes; default 60. */
+    step?: number;
+    /** Slots rendered unselectable (skipped by the keyboard rover too). */
+    disabledValues?: readonly string[];
+    /** Slots per row in the grid; default 4. */
+    columns?: number;
+    /** Display text per slot (defaults to the `'HH:mm'` value). */
+    formatLabel?: (value: string) => string;
+    /**
+     * Form field name: renders a hidden input bridge next to the group
+     * so `<form action={fn}>` / `new FormData(form)` receive the selected
+     * slot. The `''` no-selection sentinel submits nothing.
+     */
+    name?: string;
+    classNames?: TimeGridClassNames;
+    className?: string;
+    /** Forwarded to the group's focus target — the selected slot's button (falling back to the first enabled one). */
+    ref?: Ref<HTMLButtonElement>;
+} & Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'onChange'>;
+export default function TimeGrid({ value: valueControl, onChange, from, to, step, disabledValues, columns, formatLabel, name, classNames, className, style, ref, ...rest }: TimeGridProps): import("react").JSX.Element;
+export type { TimeGridProps, TimeGridClassNames };

package/dist/types/components/TimeGrid/index.d.ts

@@ -0,0 +1,2 @@
+export { default as TimeGrid } from './TimeGrid.js';
+export type { TimeGridProps, TimeGridClassNames } from './TimeGrid.js';

package/dist/types/components/TimeGrid/time-grid-styles.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared TimeGrid skin — the slot-picker chrome (group grid and the
+ * per-slot button in its idle and selected states) the `TimeGrid`
+ * component wears. Living in its own module keeps the component file
+ * free of style internals (react-refresh boundary); split-css groups
+ * the emitted CSS into `haze-ui/css/time-grid.css`. The grid's column
+ * count is layout data (the `columns` prop) and rides the root as an
+ * inline `grid-template-columns`, not a class.
+ */
+export declare const timeGridBase: import("@linaria/core").LinariaClassName;
+export declare const timeGridButton: import("@linaria/core").LinariaClassName;
+/** The checked slot — must follow `timeGridButton` in the class list. */
+export declare const timeGridButtonSelected: import("@linaria/core").LinariaClassName;

package/dist/types/components/TimePicker/TimePicker.d.ts

@@ -1,6 +1,6 @@
 import type { ComponentPropsWithoutRef, Ref } from 'react';
 import type { ControlOrValue } from 'react-use-control';
-import type { TimeParts, TimePickerFormat } from './time';
+import type { TimeParts, TimePickerFormat } from './time.js';
 type TimePickerProps = {
     value?: ControlOrValue<string>;
     /** Panel visibility; defaults to the trigger's own toggle state. */

package/dist/types/components/TimePicker/TimePickerPanel.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentPropsWithoutRef, Ref } from 'react';
-import type { TimeParts, TimePickerFormat } from './time';
+import type { TimeParts, TimePickerFormat } from './time.js';
 /**
  * One enabled/disabled decision for a candidate cell. The predicate is
  * evaluated against the currently selected parts for the other fields

package/dist/types/components/TimePicker/index.d.ts

@@ -1,5 +1,5 @@
-export { default as TimePicker } from './TimePicker';
-export type { TimePickerProps } from './TimePicker';
-export { default as TimePickerCore } from './TimePickerCore';
-export type { TimePickerCoreProps } from './TimePickerCore';
-export type { TimeParts, TimePickerFormat } from './time';
+export { default as TimePicker } from './TimePicker.js';
+export type { TimePickerProps } from './TimePicker.js';
+export { default as TimePickerCore } from './TimePickerCore.js';
+export type { TimePickerCoreProps } from './TimePickerCore.js';
+export type { TimeParts, TimePickerFormat } from './time.js';

package/dist/types/components/Timeline/index.d.ts

@@ -1,2 +1,2 @@
-export { Timeline, TimelineItem } from './Timeline';
-export type { TimelineProps, TimelineItemProps } from './Timeline';
+export { Timeline, TimelineItem } from './Timeline.js';
+export type { TimelineProps, TimelineItemProps } from './Timeline.js';

package/dist/types/components/Toast/Toast.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-import type { ToastAction } from './ToastContext';
+import type { ToastAction } from './ToastContext.js';
 /**
  * Semantic slot classes (AntD v6 `classNames` shape) for the toast
  * family. Toasts are usually fired imperatively (`useToast()` /

package/dist/types/components/Toast/ToastContainer.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { ToastClassNames } from './Toast';
+import type { ToastClassNames } from './Toast.js';
 type ToastPlacement = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 type ToastContainerProps = {
     children: ReactNode;

package/dist/types/components/Toast/index.d.ts

@@ -1,7 +1,7 @@
-export { default as Toast } from './Toast';
-export type { ToastProps, ToastClassNames } from './Toast';
-export { default as ToastContainer } from './ToastContainer';
-export type { ToastContainerProps } from './ToastContainer';
-export { default as useToast } from './useToast';
-export { toast } from './toast-channel';
-export type { ToastAction, ToastOptions, ToastVariant } from './toast-channel';
+export { default as Toast } from './Toast.js';
+export type { ToastProps, ToastClassNames } from './Toast.js';
+export { default as ToastContainer } from './ToastContainer.js';
+export type { ToastContainerProps } from './ToastContainer.js';
+export { default as useToast } from './useToast.js';
+export { toast } from './toast-channel.js';
+export type { ToastAction, ToastOptions, ToastVariant } from './toast-channel.js';

package/dist/types/components/Toast/toast-channel.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { ToastAction, ToastDeferredCopyKey, ToastItem, ToastUpdateOptions, ToastVariant } from './ToastContext';
+import type { ToastAction, ToastDeferredCopyKey, ToastItem, ToastUpdateOptions, ToastVariant } from './ToastContext.js';
 /** Options accepted by `toast()` — the same call shape `useToast()` takes. */
 type ToastOptions = {
     variant?: ToastVariant;

package/dist/types/components/Toast/useToast.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { ToastOptions, ToastPromiseOptions, ToastUpdateOptions, ToastVariantOptions } from './toast-channel';
+import type { ToastOptions, ToastPromiseOptions, ToastUpdateOptions, ToastVariantOptions } from './toast-channel.js';
 /**
  * The `useToast()` return value: the toast trigger itself (returns the id,
  * usable with `update`) plus `loading`/`update`/`promise` — one-to-one

package/dist/types/components/Toggle/index.d.ts

@@ -1,4 +1,4 @@
-export { default as Toggle } from './Toggle';
-export type { ToggleProps } from './Toggle';
-export { default as ToggleCore } from './ToggleCore';
-export type { ToggleCoreProps } from './ToggleCore';
+export { default as Toggle } from './Toggle.js';
+export type { ToggleProps } from './Toggle.js';
+export { default as ToggleCore } from './ToggleCore.js';
+export type { ToggleCoreProps } from './ToggleCore.js';

package/dist/types/components/TokenCounter/index.d.ts

@@ -1,2 +1,2 @@
-export { default as TokenCounter } from './TokenCounter';
-export type { TokenCounterProps } from './TokenCounter';
+export { default as TokenCounter } from './TokenCounter.js';
+export type { TokenCounterProps } from './TokenCounter.js';

package/dist/types/components/ToolCallCard/index.d.ts

@@ -1,2 +1,2 @@
-export { default as ToolCallCard } from './ToolCallCard';
-export type { ToolCallCardProps, ToolCallStatus } from './ToolCallCard';
+export { default as ToolCallCard } from './ToolCallCard.js';
+export type { ToolCallCardProps, ToolCallStatus } from './ToolCallCard.js';

package/dist/types/components/Toolbar/index.d.ts

@@ -1,8 +1,8 @@
-export { default as Toolbar } from './Toolbar';
-export type { ToolbarProps } from './Toolbar';
-export { default as ToolbarButton } from './ToolbarButton';
-export type { ToolbarButtonProps } from './ToolbarButton';
-export { default as ToolbarSeparator } from './ToolbarSeparator';
-export type { ToolbarSeparatorProps } from './ToolbarSeparator';
-export { default as ToolbarToggle } from './ToolbarToggle';
-export type { ToolbarToggleProps } from './ToolbarToggle';
+export { default as Toolbar } from './Toolbar.js';
+export type { ToolbarProps } from './Toolbar.js';
+export { default as ToolbarButton } from './ToolbarButton.js';
+export type { ToolbarButtonProps } from './ToolbarButton.js';
+export { default as ToolbarSeparator } from './ToolbarSeparator.js';
+export type { ToolbarSeparatorProps } from './ToolbarSeparator.js';
+export { default as ToolbarToggle } from './ToolbarToggle.js';
+export type { ToolbarToggleProps } from './ToolbarToggle.js';

package/dist/types/components/Tooltip/Tooltip.d.ts

@@ -1,6 +1,20 @@
-import type { ReactNode } from 'react';
+import type { ReactNode, Ref } from 'react';
 import type { ControlOrValue } from 'react-use-control';
-import type { CollisionPadding } from '../../utils/collision';
+import type { CollisionPadding } from '../../utils/collision.js';
+/**
+ * Semantic slot classes (AntD v6 `classNames` shape): keys mirror the
+ * data-slot each part carries. Consumer classes are appended at the end
+ * of each part's class list (able to override component defaults) and
+ * compose with the root `className`.
+ */
+type TooltipClassNames = {
+    /** The wrapper `<span>` (`data-slot='tooltip'`) around trigger and bubble. */
+    root?: string;
+    /** The trigger-hosting `<span>` (`data-slot='trigger'`) that wraps children. */
+    trigger?: string;
+    /** The bubble `<span>` itself (`data-slot='content'`, `role='tooltip'`). */
+    content?: string;
+};
 type TooltipProps = {
     content: ReactNode;
     position?: 'top' | 'bottom' | 'left' | 'right';
@@ -9,8 +23,16 @@ type TooltipProps = {
     open?: ControlOrValue<boolean>;
     /** Viewport inset the bubble treats as collision space. */
     collisionPadding?: CollisionPadding;
+    /** Slot classes (see {@link TooltipClassNames}); each key lands on the
+     * part carrying the matching data-slot, after the component defaults. */
+    classNames?: TooltipClassNames;
     className?: string;
+    /**
+     * Forwarded to the component's own root — the wrapper `<span>`
+     * (`data-slot='tooltip'`) around the trigger host and the bubble.
+     */
+    ref?: Ref<HTMLSpanElement>;
     children: ReactNode;
 };
-export default function Tooltip({ content, position, delay: delayProp, open: openControl, collisionPadding, className, children, }: TooltipProps): import("react").JSX.Element;
-export type { TooltipProps };
+export default function Tooltip({ content, position, delay: delayProp, open: openControl, collisionPadding, classNames, className, ref, children, }: TooltipProps): import("react").JSX.Element;
+export type { TooltipProps, TooltipClassNames };

package/dist/types/components/Tooltip/index.d.ts

@@ -1,2 +1,2 @@
-export { default as Tooltip } from './Tooltip';
-export type { TooltipProps } from './Tooltip';
+export { default as Tooltip } from './Tooltip.js';
+export type { TooltipProps, TooltipClassNames } from './Tooltip.js';

package/dist/types/components/Tour/Tour.d.ts

@@ -1,6 +1,6 @@
 import type { ComponentPropsWithoutRef, ReactNode } from 'react';
 import type { ControlOrValue } from 'react-use-control';
-import type { FloatingPlacement } from '../../utils/floating';
+import type { FloatingPlacement } from '../../utils/floating.js';
 /** Why the tour closed: the last step's Done button vs. an early exit. */
 type TourCloseReason = 'done' | 'skip';
 /**

package/dist/types/components/Tour/index.d.ts

@@ -1,2 +1,2 @@
-export { default as Tour } from './Tour';
-export type { TourCloseReason, TourPlacement, TourProps, TourStep } from './Tour';
+export { default as Tour } from './Tour.js';
+export type { TourCloseReason, TourPlacement, TourProps, TourStep } from './Tour.js';

package/dist/types/components/Trace/Trace.d.ts

@@ -0,0 +1,37 @@
+import type { ComponentPropsWithoutRef, ComponentType, ReactNode } from 'react';
+import type { ControlOrValue } from 'react-use-control';
+/**
+ * Line-by-line reasoning trace for agentic UIs (the shadcn Trace shape):
+ * `<Trace>` lays out `<TraceItem>` steps, each carrying a status marker,
+ * a title, an optional custom icon and an optional disclosure revealing
+ * `details` below the line. Status transitions are mirrored to screen
+ * readers through a per-item sr-only live region.
+ */
+type TraceStatus = 'pending' | 'running' | 'done' | 'error';
+type TraceProps = {
+    /** `TraceItem` steps composing the trace, one per line. */
+    children: ReactNode;
+    className?: string;
+} & Omit<ComponentPropsWithoutRef<'div'>, 'children'>;
+type TraceItemProps = {
+    /** The step's headline — the line's visible text. */
+    title: ReactNode;
+    status?: TraceStatus;
+    /** Replaces the status glyph inside the marker (the marker keeps its status ring). */
+    icon?: ComponentType;
+    /** Payload revealed by the line's disclosure toggle; omit for a plain line. */
+    details?: ReactNode;
+    /** Controlled/uncontrolled expanded state of the details panel (default `false`). */
+    open?: ControlOrValue<boolean>;
+    /** Fires on every expand/collapse transition, whatever drove it. */
+    onOpenChange?: (open: boolean) => void;
+    className?: string;
+} & Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'>;
+type TraceDetailsProps = {
+    children: ReactNode;
+    className?: string;
+} & Omit<ComponentPropsWithoutRef<'div'>, 'children'>;
+export declare function TraceItem({ title, status, icon: Icon, details, open: openControl, onOpenChange, className, ...rest }: TraceItemProps): import("react").JSX.Element;
+export declare function TraceDetails({ children, className, ...rest }: TraceDetailsProps): import("react").JSX.Element;
+export default function Trace({ children, className, ...rest }: TraceProps): import("react").JSX.Element;
+export type { TraceProps, TraceItemProps, TraceDetailsProps, TraceStatus };

package/dist/types/components/Trace/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Trace, TraceItem, TraceDetails } from './Trace.js';
+export type { TraceProps, TraceItemProps, TraceDetailsProps, TraceStatus } from './Trace.js';

package/dist/types/components/Transfer/Transfer.d.ts

@@ -1,5 +1,5 @@
 import type { ControlOrValue } from 'react-use-control';
-import type { TransferItem } from './TransferCore';
+import type { TransferItem } from './TransferCore.js';
 type TransferProps = {
     dataSource: TransferItem[];
     targetKeys?: ControlOrValue<string[]>;

package/dist/types/components/Transfer/index.d.ts

@@ -1,4 +1,4 @@
-export { default as Transfer } from './Transfer';
-export type { TransferProps, TransferItem } from './Transfer';
-export { default as TransferCore } from './TransferCore';
-export type { TransferCoreProps } from './TransferCore';
+export { default as Transfer } from './Transfer.js';
+export type { TransferProps, TransferItem } from './Transfer.js';
+export { default as TransferCore } from './TransferCore.js';
+export type { TransferCoreProps } from './TransferCore.js';

package/dist/types/components/Tree/SortableTree.d.ts

@@ -1,5 +1,5 @@
-import type { SortableTreeMoveInfo } from './sortable-tree-utils';
-import type { TreeProps } from './types';
+import type { SortableTreeMoveInfo } from './sortable-tree-utils.js';
+import type { TreeProps } from './types.js';
 /**
  * Props for `SortableTree` — the full `TreeProps` field set (the tree
  * keeps all of its expand/select/check/keyboard/virtual behavior) plus

package/dist/types/components/Tree/Tree.d.ts

@@ -1,3 +1,3 @@
-import type { TreeProps, TreeVirtualizedConfig } from './types';
-export default function Tree({ treeData, multiple, checkable, checkStrictly, selectable, disabled, blockNode, showLine, showIcon, switcherIcon, loadingIcon, titleRender, iconRender, virtualized, loadData, searchValue, rowWrap, keyboardNavigation, expandedKeys: expandedKeysControl, selectedKeys: selectedKeysControl, checkedKeys: checkedKeysControl, className, onExpand, onSelect, onCheck, }: TreeProps): import("react").JSX.Element;
+import type { TreeProps, TreeVirtualizedConfig } from './types.js';
+export default function Tree({ treeData, multiple, checkable, checkStrictly, selectable, disabled, blockNode, showLine, showIcon, switcherIcon, loadingIcon, titleRender, iconRender, virtualized, loadData, searchValue, rowWrap, keyboardNavigation, expandedKeys: expandedKeysControl, selectedKeys: selectedKeysControl, checkedKeys: checkedKeysControl, ref, className, onExpand, onSelect, onCheck, }: TreeProps): import("react").JSX.Element;
 export type { TreeProps, TreeVirtualizedConfig };

package/dist/types/components/Tree/TreeItem.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { TreeNodeData } from './types';
+import type { TreeNodeData } from './types.js';
 type TreeItemProps = {
     node: TreeNodeData;
     level: number;

package/dist/types/components/Tree/index.d.ts

@@ -1,4 +1,4 @@
-export { default as Tree } from './Tree';
-export { default as SortableTree } from './SortableTree';
-export type { TreeProps, TreeNodeData } from './types';
-export type { SortableTreeProps, SortableTreeMoveInfo } from './SortableTree';
+export { default as Tree } from './Tree.js';
+export { default as SortableTree } from './SortableTree.js';
+export type { TreeProps, TreeNodeData } from './types.js';
+export type { SortableTreeProps, SortableTreeMoveInfo } from './SortableTree.js';

package/dist/types/components/Tree/sortable-tree-utils.d.ts

@@ -1,4 +1,4 @@
-import type { TreeNodeData } from './types';
+import type { TreeNodeData } from './types.js';
 /**
  * Pure move math for SortableTree — no React, no dnd, fully unit-testable.
  * The drag runtime reports a target row; these functions turn that into the

package/dist/types/components/Tree/types.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from 'react';
+import type { ReactNode, Ref } from 'react';
 import type { ControlOrValue } from 'react-use-control';
 /**
  * Tree 节点数据接口
@@ -119,6 +119,14 @@ export type TreeProps = {
     selectedKeys?: ControlOrValue<string[]>;
     /** （受控）复选的节点 */
     checkedKeys?: ControlOrValue<string[]>;
+    /**
+     * Forwarded to the root `role="tree"` container `<div>` — the same
+     * node every render path (nested, virtualized, empty search) roots
+     * at. The roving-tabindex model keeps its internal handle alongside
+     * (merged), so a consumer ref observes without disturbing focus
+     * bookkeeping.
+     */
+    ref?: Ref<HTMLDivElement>;
     /** 自定义类名 */
     className?: string;
     /** 展开/收起回调 */

package/dist/types/components/Tree/utils.d.ts

@@ -1,4 +1,4 @@
-import type { TreeNodeData } from './types';
+import type { TreeNodeData } from './types.js';
 /**
  * A visible tree row: one treeitem in the depth-first order the tree
  * renders (parents before children, expanded subtrees only). Backs both

package/dist/types/components/TreeSelect/TreeSelect.d.ts

@@ -1,6 +1,6 @@
 import type { ComponentPropsWithoutRef, Ref } from 'react';
 import type { ControlOrValue } from 'react-use-control';
-import type { TreeNodeData, TreeVirtualizedConfig } from '../Tree/types';
+import type { TreeNodeData, TreeVirtualizedConfig } from '../Tree/types.js';
 type TreeSelectProps = {
     /**
      * Full node tree rendered in the panel — `Tree`'s data shape

package/dist/types/components/TreeSelect/index.d.ts

@@ -1,2 +1,2 @@
-export { default as TreeSelect } from './TreeSelect';
-export type { TreeSelectProps } from './TreeSelect';
+export { default as TreeSelect } from './TreeSelect.js';
+export type { TreeSelectProps } from './TreeSelect.js';

package/dist/types/components/Typography/index.d.ts

@@ -1,2 +1,2 @@
-export { Title, Text, Paragraph } from './Typography';
-export type { TitleProps, TextProps, ParagraphProps, TextEllipsis } from './Typography';
+export { Title, Text, Paragraph } from './Typography.js';
+export type { TitleProps, TextProps, ParagraphProps, TextEllipsis } from './Typography.js';

package/dist/types/components/Upload/Upload.d.ts

@@ -1,6 +1,6 @@
 import type { ReactNode, Ref } from 'react';
 import type { ControlOrValue } from 'react-use-control';
-import type { UploadFileStatus, UploadHandle, UploadListItemRender, UploadRequest, UploadValueItem } from './types';
+import type { UploadClassNames, UploadFileStatus, UploadHandle, UploadListItemRender, UploadRequest, UploadValueItem } from './types.js';
 type UploadProps = {
     /** Selected files — local `File` picks mixed freely with `UploadFile`
      * echo entries (files already on the server); uncontrolled
@@ -10,11 +10,17 @@ type UploadProps = {
     /** Renders the drag-and-drop drop area (default) or a plain
      * click-only picker area — see `UploadCoreProps.droppable`. */
     droppable?: boolean;
+    /** Paste-to-upload: clipboard files run through the drop pipeline —
+     * see `UploadCoreProps.paste`. */
+    paste?: boolean;
     /** Gatekeeper for every picked or dropped file — see
      * `UploadCoreProps.beforeUpload`. */
     beforeUpload?: (file: File) => boolean | Promise<boolean>;
     /** Cap for the committed list — see `UploadCoreProps.maxCount`. */
     maxCount?: number;
+    /** Per-file size cap in bytes; over-limit files stay as error rows
+     * that never upload — see `UploadCoreProps.maxSize`. */
+    maxSize?: number;
     multiple?: boolean;
     /** Custom upload executor — see `UploadCoreProps.request`. */
     request?: UploadRequest;
@@ -32,6 +38,9 @@ type UploadProps = {
     /** Picks only enter the list; uploads start via the `UploadHandle`
      * ref — see `UploadCoreProps.manual`. */
     manual?: boolean;
+    /** Cap on simultaneously in-flight uploads (default `4`); excess
+     * files queue in value order — see `UploadCoreProps.concurrency`. */
+    concurrency?: number;
     /** Built-in file list with progress and per-state actions — see
      * `UploadCoreProps.showUploadList`. */
     showUploadList?: boolean | {
@@ -58,9 +67,23 @@ type UploadProps = {
      * when uncontrolled). Removals and `clear()` do not fire this (they
      * are not picks). */
     onChange?: (files: File[]) => void;
+    /**
+     * Semantic slot classes (AntD v6 `classNames` shape): declared once
+     * here and applied to the drop zone plus the built-in list (see
+     * {@link UploadClassNames}). Not passing it renders identical output.
+     */
+    classNames?: UploadClassNames;
     className?: string;
     children?: ReactNode;
+    /**
+     * The imperative `UploadHandle` (`upload`/`uploadAll`/`abort`/
+     * `clear`) — a command object, not a DOM node. The family renders no
+     * single root element (the drop zone and the list are siblings), so
+     * there is no root container to forward a DOM ref to: style the
+     * zone through `classNames.trigger`, or query the parts by their
+     * `data-slot` attributes (`drop-zone`, `list`, `item`).
+     */
     ref?: Ref<UploadHandle>;
 };
-export default function Upload({ value: valueControl, accept, droppable, beforeUpload, maxCount, multiple, request, action, method, headers, name, data, manual, showUploadList, listType, onPreview, removeLabel, directory, onStatusChange, onChange, className, children, ref, }: UploadProps): import("react").JSX.Element;
+export default function Upload({ value: valueControl, accept, droppable, paste, beforeUpload, maxCount, maxSize, multiple, request, action, method, headers, name, data, manual, concurrency, showUploadList, listType, onPreview, removeLabel, directory, onStatusChange, onChange, classNames, className, children, ref, }: UploadProps): import("react").JSX.Element;
 export type { UploadProps };

package/dist/types/components/Upload/UploadCore.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentPropsWithoutRef, ReactNode, Ref } from 'react';
-import type { UploadFileStatus, UploadHandle, UploadListItemRender, UploadRequest, UploadValueItem } from './types';
+import type { UploadClassNames, UploadFileStatus, UploadHandle, UploadListItemRender, UploadRequest, UploadValueItem } from './types.js';
 type UploadCoreProps = {
     /** The selected files — the field value, emitted verbatim (as the
      * complete next list) by `onChange`. Local `File` picks mix freely
@@ -21,6 +21,13 @@ type UploadCoreProps = {
      * the dashed drop area with a drag-over highlight and accepts dropped
      * files; `false` renders a plain click-only picker area. */
     droppable?: boolean;
+    /** Paste-to-upload: the zone (focusable — `role="button"`,
+     * `tabIndex={0}`) listens for paste events and runs clipboard files
+     * through the exact drop pipeline — `accept` grammar,
+     * `beforeUpload`, `maxSize`, `maxCount` — reporting new files the
+     * same way drops do. Clipboard content without files passes through
+     * untouched. Works in droppable and click-only modes alike. */
+    paste?: boolean;
     /** Gatekeeper applied to every file — click picks and drops alike —
      * before it enters the value: return `false` (or a promise resolving
      * to `false`) to drop the file. Verdicts for one pick are awaited
@@ -28,6 +35,17 @@ type UploadCoreProps = {
      * every verdict resolved; the UI is not blocked while waiting.
      * A refused file never enters the list, so it never uploads. */
     beforeUpload?: (file: File) => boolean | Promise<boolean>;
+    /** Per-file size cap in bytes, applied after the `beforeUpload`
+     * verdicts and before `maxCount`. An over-limit file still enters
+     * the value — as an error row carrying a size message — but never
+     * uploads: auto mode, `retry` and the `UploadHandle` all refuse it,
+     * leaving remove as the only action. `maxCount` caps the whole
+     * committed list, rejected rows included (pipeline order:
+     * `accept → beforeUpload → maxSize → maxCount`). The cap gates the
+     * intake paths only — a `File` arriving through `value` is the
+     * consumer's call and uploads normally. A non-positive or
+     * non-finite value disables the cap. */
+    maxSize?: number;
     /** Cap for the committed list. Applied last: existing entries win,
      * then the freshly picked survivors; anything beyond the first
      * `maxCount` entries is discarded silently. */
@@ -65,6 +83,15 @@ type UploadCoreProps = {
      * with `request` or `action`.
      */
     manual?: boolean;
+    /**
+     * Cap on simultaneously in-flight uploads (default `4`). Files
+     * beyond the cap queue in value order and start as running uploads
+     * finish, fail or are cancelled — auto mode, the `UploadHandle`
+     * triggers and retries all funnel through the same queue. A
+     * non-finite value (`Infinity`) uploads everything at once — the
+     * pre-queue behavior.
+     */
+    concurrency?: number;
     /**
      * Renders the built-in file list below the zone (default `false`):
      * file name, live progress (reusing `Progress`), status icon and
@@ -112,9 +139,23 @@ type UploadCoreProps = {
      * echoes report their terminal `status`/`percent` like any row.
      */
     onStatusChange?: (files: UploadFileStatus[]) => void;
+    /**
+     * Semantic slot classes (AntD v6 `classNames` shape): the `trigger`
+     * slot lands on the drop zone, the rest hand down to the built-in
+     * list (see {@link UploadClassNames}).
+     */
+    classNames?: UploadClassNames;
     className?: string;
     children?: ReactNode;
+    /**
+     * The imperative `UploadHandle` (`upload`/`uploadAll`/`abort`/
+     * `clear`) — a command object, not a DOM node. The component renders
+     * no single root element (the drop zone and the list are siblings),
+     * so there is no root container to forward a DOM ref to: style the
+     * zone through `classNames.trigger`, or query the parts by their
+     * `data-slot` attributes (`drop-zone`, `list`, `item`).
+     */
     ref?: Ref<UploadHandle>;
-} & Omit<ComponentPropsWithoutRef<'div'>, 'value' | 'onChange' | 'children' | 'onClick' | 'onDrop' | 'onDragOver' | 'onDragEnter' | 'onDragLeave' | 'onKeyDown' | 'role' | 'tabIndex'>;
-export default function UploadCore({ value, onChange, accept, droppable, beforeUpload, maxCount, multiple, request, action, method, headers, name, data, manual, showUploadList, listType, onPreview, removeLabel, directory, onStatusChange, className, children, ref, ...rest }: UploadCoreProps): import("react").JSX.Element;
+} & Omit<ComponentPropsWithoutRef<'div'>, 'value' | 'onChange' | 'children' | 'onClick' | 'onDrop' | 'onDragOver' | 'onDragEnter' | 'onDragLeave' | 'onKeyDown' | 'onPaste' | 'role' | 'tabIndex'>;
+export default function UploadCore({ value, onChange, accept, droppable, paste, beforeUpload, maxCount, maxSize, multiple, request, action, method, headers, name, data, manual, concurrency, showUploadList, listType, onPreview, removeLabel, directory, onStatusChange, classNames, className, children, ref, ...rest }: UploadCoreProps): import("react").JSX.Element;
 export type { UploadCoreProps };

package/dist/types/components/Upload/UploadList.d.ts

@@ -1,4 +1,5 @@
-import type { UploadEntry, UploadListItemRender, UploadValueItem } from './types';
+import type { Ref } from 'react';
+import type { UploadClassNames, UploadEntry, UploadListItemRender, UploadValueItem } from './types.js';
 type UploadListProps = {
     /** Tracked rows, in value order. */
     entries: UploadEntry[];
@@ -16,6 +17,19 @@ type UploadListProps = {
     onRemove: (file: UploadValueItem) => void;
     onRetry: (file: UploadValueItem) => void;
     onCancel: (file: UploadValueItem) => void;
+    /**
+     * Semantic slot classes handed down from `<Upload>`/`<UploadCore>` —
+     * the `list`/`item`/`progress` slots of {@link UploadClassNames}
+     * this component owns.
+     */
+    classNames?: Pick<UploadClassNames, 'list' | 'item' | 'progress'>;
+    /**
+     * Forwarded to the list root `<ul>` (`data-slot='list'`) — the
+     * Upload family's DOM-ref surface (the `Upload`/`UploadCore` `ref`
+     * is the imperative `UploadHandle`, a command object, and the family
+     * renders no single root element).
+     */
+    ref?: Ref<HTMLUListElement>;
 };
-export default function UploadList({ entries, listType, removeLabel, itemRender, onPreview, onRemove, onRetry, onCancel, }: UploadListProps): import("react").JSX.Element;
+export default function UploadList({ entries, listType, removeLabel, itemRender, onPreview, onRemove, onRetry, onCancel, classNames, ref, }: UploadListProps): import("react").JSX.Element;
 export type { UploadListProps };

package/dist/types/components/Upload/index.d.ts

@@ -1,5 +1,5 @@
-export { default as Upload } from './Upload';
-export type { UploadProps } from './Upload';
-export { default as UploadCore } from './UploadCore';
-export type { UploadCoreProps } from './UploadCore';
-export type { UploadHandle, UploadStatus, UploadFile, UploadValueItem, UploadFileStatus, UploadRequest, UploadRequestOptions, UploadListItemActions, UploadListItemRender, } from './types';
+export { default as Upload } from './Upload.js';
+export type { UploadProps } from './Upload.js';
+export { default as UploadCore } from './UploadCore.js';
+export type { UploadCoreProps } from './UploadCore.js';
+export type { UploadClassNames, UploadHandle, UploadStatus, UploadFile, UploadValueItem, UploadFileStatus, UploadRequest, UploadRequestOptions, UploadListItemActions, UploadListItemRender, } from './types.js';