@sia.soul/sia-react-ui 0.1.62 → 0.1.64

package/dist/{chunk-QJH7H3CB.js → chunk-NKSPPR2A.js}

@@ -5,7 +5,7 @@ import {
   Popover,
   Tooltip,
   useOverlayLifecycle
-} from "./chunk-F4XMRO6G.js";
+} from "./chunk-B42RCR7O.js";
 import {
   Dropdown,
   Icon
@@ -92,6 +92,7 @@ function Toolbar({ items, onAction, disabled = false, size = "small", variant =
 import { useState as useState2 } from "react";
 import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 function Card({
+  bordered = true,
   title,
   description,
   extra,
@@ -143,7 +144,7 @@ function Card({
   return /* @__PURE__ */ jsxs2(
     "section",
     {
-      className: `sia-card${isCollapsed ? " sia-card--collapsed" : ""}${selectable ? " sia-card--selectable" : ""}${selectable && isSelected ? " sia-card--selected" : ""}${hoverActions ? " sia-card--hover-actions" : ""} ${className}`.trim(),
+      className: `sia-card${!bordered ? " sia-card--borderless" : ""}${isCollapsed ? " sia-card--collapsed" : ""}${selectable ? " sia-card--selectable" : ""}${selectable && isSelected ? " sia-card--selected" : ""}${hoverActions ? " sia-card--hover-actions" : ""} ${className}`.trim(),
       style: mergedStyle,
       role: selectable ? "checkbox" : void 0,
       "aria-checked": selectable ? isSelected : void 0,
@@ -1418,7 +1419,7 @@ function UploadItem({ file, files, props, actions }) {
   }
   useEffect4(() => setFailed(false), [source]);
   const node = /* @__PURE__ */ jsxs8("div", { className: `sia-upload__item sia-upload__item--${file.status ?? "ready"}`, children: [
-    props.listType !== "text" ? /* @__PURE__ */ jsx8(Button, { variant: "text", className: "sia-upload__thumbnail", "aria-label": `\u9884\u89C8\u7F29\u7565\u56FE ${file.name}`, onClick: actions.preview, disabled: !canPreview, children: source && !failed ? /* @__PURE__ */ jsx8("img", { src: source, alt: file.name, onError: () => setFailed(true) }) : /* @__PURE__ */ jsx8(Icon, { name: file.type?.startsWith("image/") ? "image" : "file", size: 28 }) }) : /* @__PURE__ */ jsx8(Icon, { name: file.status === "done" ? "circle-check" : "file", size: 16 }),
+    props.listType !== "text" ? /* @__PURE__ */ jsx8(Button, { variant: "text", className: "sia-upload__thumbnail", "aria-label": `\u9884\u89C8\u7F29\u7565\u56FE ${file.name}`, onClick: actions.preview, disabled: !canPreview, children: source && !failed ? /* @__PURE__ */ jsx8("img", { src: source, alt: file.name, onError: () => setFailed(true) }) : /* @__PURE__ */ jsx8(Icon, { name: file.type?.startsWith("image/") ? "image" : "file", size: 28 }) }) : /* @__PURE__ */ jsx8("span", { className: "sia-upload__file-icon", children: /* @__PURE__ */ jsx8(Icon, { name: file.status === "done" ? "circle-check" : "file", size: 24 }) }),
     /* @__PURE__ */ jsx8("span", { className: "sia-upload__name", ...withTitleTooltip({ title: file.relativePath || file.name }), children: file.url ? /* @__PURE__ */ jsx8("a", { href: file.url, target: "_blank", rel: "noreferrer", children: file.name }) : file.name }),
     /* @__PURE__ */ jsxs8("span", { className: "sia-upload__actions", children: [
       /* @__PURE__ */ jsx8(Button, { variant: "text", title: "\u9884\u89C8", "aria-label": `\u9884\u89C8 ${file.name}`, disabled: !canPreview, onClick: actions.preview, children: /* @__PURE__ */ jsx8(Icon, { name: "eye", size: 14 }) }),
@@ -1433,7 +1434,8 @@ function UploadItem({ file, files, props, actions }) {
       ] }),
       /* @__PURE__ */ jsx8("span", { className: "sia-upload__progress", role: "progressbar", "aria-label": `${file.name} \u4E0A\u4F20\u8FDB\u5EA6`, "aria-valuemin": 0, "aria-valuemax": 100, "aria-valuenow": file.percent ?? 0, children: /* @__PURE__ */ jsx8("span", { style: { width: `${file.percent ?? 0}%` } }) })
     ] }),
-    file.status === "error" && /* @__PURE__ */ jsx8("span", { className: "sia-upload__error", children: "\u4E0A\u4F20\u5931\u8D25" })
+    file.status === "error" && /* @__PURE__ */ jsx8("span", { className: "sia-upload__error", children: "\u4E0A\u4F20\u5931\u8D25" }),
+    props.listType === "text" && (file.status === void 0 || file.status === "ready" || file.status === "done") && /* @__PURE__ */ jsx8("span", { className: "sia-upload__status", children: file.status === "done" ? "\u4E0A\u4F20\u5B8C\u6210" : "\u5DF2\u9009\u62E9" })
   ] });
   return /* @__PURE__ */ jsx8(Fragment4, { children: props.itemRender ? props.itemRender(node, file, files, actions) : node });
 }
@@ -1712,6 +1714,10 @@ var UploadRoot = forwardRef(function UploadRoot2({
           }
         ),
         listType !== "picture-card" && trigger,
+        showUploadList && listType === "text" && files.length > 0 && /* @__PURE__ */ jsxs8("div", { className: "sia-upload__list-heading", role: "status", children: [
+          "\u5DF2\u9009\u6587\u4EF6 ",
+          /* @__PURE__ */ jsx8("span", { className: "sia-upload__count", children: files.length })
+        ] }),
         /* @__PURE__ */ jsxs8("div", { className: "sia-upload__list", children: [
           showUploadList && files.map((file) => /* @__PURE__ */ jsx8(UploadItem, { file, files, props: { listType, disabled, itemRender, onPreview, downloadRequest, accept }, actions: {
             upload: () => start(file),
@@ -1750,7 +1756,7 @@ var UploadDragger = forwardRef(function UploadDragger2({ hint = "\u652F\u6301\u5
   ] }) });
 });
 var Upload = Object.assign(UploadRoot, {
-  /** 可点击、键盘操作和拖拽的上传区域，ref 支持手动上传、取消及移除。 */
+  /** 可点击、键盘操作和拖拽的上传区域，ref 支持手动上传、取消及移除；默认内容在文字或图片列表非空且可见时收紧高度，清空后恢复。 */
   Dragger: UploadDragger,
   /** beforeUpload 返回时移除该文件，不进行上传。 */
   LIST_IGNORE

package/dist/{chunk-7CAQPLKC.js → chunk-VGIGEDUP.js}

@@ -1,7 +1,7 @@
 import {
   FloatingScrollbarProvider,
   Select
-} from "./chunk-F4XMRO6G.js";
+} from "./chunk-B42RCR7O.js";
 import {
   Icon
 } from "./chunk-IUZ2RSI5.js";

package/dist/{core-BrQetGru.d.ts → core-DrNZuMER.d.ts}

@@ -46,6 +46,12 @@ declare function Toolbar({ items, onAction, disabled, size, variant, overflowLab
 type CardAccent = "primary" | "success" | "warning" | "error";
 /** 卡片的属性配置。 */
 interface CardProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    /**
+     * 是否显示外边框并保留默认内部留白。false 移除外边框、选中描边、标题区左右留白及说明、正文、悬浮操作区的内边距；保留背景、圆角、内部分割线和键盘焦点提示。
+     * 无边框时仍可通过 bodyStyle.padding 自定义正文内边距。
+     * @defaultValue true
+     */
+    bordered?: boolean;
     /** 标题内容，可传入文本或 React 节点。 */
     title?: ReactNode;
     /** 补充说明内容。 */
@@ -60,7 +66,7 @@ interface CardProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
     /** 受控选中状态，需在 onSelectedChange 中更新。 */
     selected?: boolean;
     /**
-     * 是否显示选中卡片右上角的三角勾选标记。仅在 selectable 且已选中时生效；false 保留选中边框和键盘交互。
+     * 是否显示选中卡片右上角的三角勾选标记。仅在 selectable 且已选中时生效；false 保留键盘交互，选中边框仅在 bordered 为 true 时显示。
      * @defaultValue true
      */
     showSelectedIndicator?: boolean;
@@ -103,11 +109,11 @@ interface CardProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
      * @defaultValue ""
      */
     bodyClassName?: string;
-    /** 内容区域的内联样式。 */
+    /** 内容区域的内联样式，可覆盖默认内边距：上下 6px，左右使用 --sia-spacing；bordered 为 false 时默认内边距为 0。 */
     bodyStyle?: CSSProperties;
 }
 /** 卡片组件。 */
-declare function Card({ title, description, extra, selectable, selected, showSelectedIndicator, defaultSelected, disabled, onSelectedChange, hoverActions, accent, accentColor, collapsible, collapsed, defaultCollapsed, onCollapsedChange, bodyHeight, bodyClassName, bodyStyle, className, style, children, onClick, onKeyDown, ...props }: CardProps): react.JSX.Element;
+declare function Card({ bordered, title, description, extra, selectable, selected, showSelectedIndicator, defaultSelected, disabled, onSelectedChange, hoverActions, accent, accentColor, collapsible, collapsed, defaultCollapsed, onCollapsedChange, bodyHeight, bodyClassName, bodyStyle, className, style, children, onClick, onKeyDown, ...props }: CardProps): react.JSX.Element;
 
 declare const iconPaths: {
     "notepad-file": react.JSX.Element;
@@ -1013,7 +1019,7 @@ interface TreeNode {
     children?: readonly TreeNode[];
     [key: string]: unknown;
 }
-/** 树的属性配置。 */
+/** 树的属性配置；通过 style 或 className 设置高度限制及 overflow: auto 后，溢出内容使用不占布局空间的浮动滚动条。 */
 interface TreeProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSelect" | "onDrop"> {
     /** 树形节点数据 */
     treeData: readonly TreeNode[];
@@ -1103,6 +1109,21 @@ interface TreeProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSelect" | "o
      * @defaultValue 34
      */
     stickyRowHeight?: number;
+    /**
+     * 是否允许组件在可见节点达到阈值且自身形成滚动视口时自动启用虚拟滚动；关闭后始终渲染全部已展开节点。
+     * @defaultValue true
+     */
+    virtual?: boolean;
+    /**
+     * 自动启用虚拟滚动所需的最少可见节点数；小于该数量时保留完整 DOM，避免为小树增加额外计算。
+     * @defaultValue 100
+     */
+    virtualThreshold?: number;
+    /**
+     * 虚拟滚动模式下每一行的固定高度，单位为像素；未传入时使用 stickyRowHeight 的值。
+     * @defaultValue stickyRowHeight
+     */
+    virtualItemHeight?: number;
     /**
      * 是否允许拖拽。
      * @defaultValue false
@@ -1145,8 +1166,8 @@ interface TreeProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSelect" | "o
         dropPosition: TreeDropPosition;
     }) => void;
 }
-/** 树组件。 */
-declare function Tree({ treeData, selectedKeys, defaultSelectedKeys, expandedKeys, defaultExpandedKeys, defaultExpandAll, checkedKeys, defaultCheckedKeys, loadingKeys, checkable, checkStrictly, multiple, selectable, showLine, showIcon, blockNode, indentSize, switcherWidth, stickyAncestors, stickyRowHeight, draggable, loadData, onSelect, onCheck, onExpand, onDrop, className, ...props }: TreeProps): react.JSX.Element;
+/** 树形控件，支持选择、勾选与异步加载；自身容器可滚动时默认接入浮动滚动条，无需全局 Provider。 */
+declare function Tree({ treeData, selectedKeys, defaultSelectedKeys, expandedKeys, defaultExpandedKeys, defaultExpandAll, checkedKeys, defaultCheckedKeys, loadingKeys, checkable, checkStrictly, multiple, selectable, showLine, showIcon, blockNode, indentSize, switcherWidth, stickyAncestors, stickyRowHeight, virtual, virtualThreshold, virtualItemHeight, draggable, loadData, onSelect, onCheck, onExpand, onDrop, className, ...props }: TreeProps): react.JSX.Element;
 
 /** 气泡确认的属性配置。 */
 interface PopconfirmProps {
@@ -1999,7 +2020,7 @@ interface UploadProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue
     fileList?: readonly UploadFile[];
     /** 非受控初始列表，后续修改不重置列表。 @defaultValue [] */
     defaultFileList?: readonly UploadFile[];
-    /** 文件列表样式：text 为文字列表，picture 为带缩略图的图片列表，picture-card 为照片墙。 @defaultValue "text" */
+    /** 文件列表样式：text 为带文件数量标题、图标和状态的文字卡片列表，picture 为带缩略图的图片列表，picture-card 为照片墙。 @defaultValue "text" */
     listType?: "text" | "picture" | "picture-card";
     /** 照片墙卡片尺寸，仅 listType="picture-card" 生效；数字设置正方形，对象分别设置宽高，单位 px。默认 112×112，各边最小 48，无效数值使用默认值；宽或高小于 88px 时隐藏文件名。 */
     cardSize?: number | {
@@ -2008,7 +2029,7 @@ interface UploadProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue
         /** 卡片高度，默认 112px，最小 48px。 */
         height?: number;
     };
-    /** 是否显示列表；隐藏时仍执行数量限制和变更通知。 @defaultValue true */
+    /** 是否显示内置列表及文字列表的数量标题；隐藏时仍执行数量限制和变更通知。 @defaultValue true */
     showUploadList?: boolean;
     /** 启动前校验，可异步；false 保留 ready，Upload.LIST_IGNORE 移除，File 转换本次上传内容；拒绝或抛错进入 error。手动上传时在调用 upload 后执行。 */
     beforeUpload?: (file: File, fileList: readonly File[]) => boolean | File | symbol | Promise<boolean | File | symbol>;
@@ -2041,9 +2062,9 @@ interface UploadDraggerProps extends UploadProps {
     hint?: ReactNode;
 }
 
-/** 上传组件，支持图片列表、照片墙、目录、粘贴与完全受控请求；未配置请求时仅选择文件。 */
+/** 上传组件，默认以带数量标题和状态的文字卡片展示已选文件；支持图片列表、照片墙、目录、粘贴与完全受控请求，未配置请求时仅选择文件。 */
 declare const Upload: react.ForwardRefExoticComponent<UploadProps & react.RefAttributes<UploadRef>> & {
-    /** 可点击、键盘操作和拖拽的上传区域，ref 支持手动上传、取消及移除。 */
+    /** 可点击、键盘操作和拖拽的上传区域，ref 支持手动上传、取消及移除；默认内容在文字或图片列表非空且可见时收紧高度，清空后恢复。 */
     Dragger: react.ForwardRefExoticComponent<UploadDraggerProps & react.RefAttributes<UploadRef>>;
     /** beforeUpload 返回时移除该文件，不进行上传。 */
     LIST_IGNORE: symbol;

package/dist/{core-MTKdBVk3.d.cts → core-hpkUd4EO.d.cts}

@@ -46,6 +46,12 @@ declare function Toolbar({ items, onAction, disabled, size, variant, overflowLab
 type CardAccent = "primary" | "success" | "warning" | "error";
 /** 卡片的属性配置。 */
 interface CardProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    /**
+     * 是否显示外边框并保留默认内部留白。false 移除外边框、选中描边、标题区左右留白及说明、正文、悬浮操作区的内边距；保留背景、圆角、内部分割线和键盘焦点提示。
+     * 无边框时仍可通过 bodyStyle.padding 自定义正文内边距。
+     * @defaultValue true
+     */
+    bordered?: boolean;
     /** 标题内容，可传入文本或 React 节点。 */
     title?: ReactNode;
     /** 补充说明内容。 */
@@ -60,7 +66,7 @@ interface CardProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
     /** 受控选中状态，需在 onSelectedChange 中更新。 */
     selected?: boolean;
     /**
-     * 是否显示选中卡片右上角的三角勾选标记。仅在 selectable 且已选中时生效；false 保留选中边框和键盘交互。
+     * 是否显示选中卡片右上角的三角勾选标记。仅在 selectable 且已选中时生效；false 保留键盘交互，选中边框仅在 bordered 为 true 时显示。
      * @defaultValue true
      */
     showSelectedIndicator?: boolean;
@@ -103,11 +109,11 @@ interface CardProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
      * @defaultValue ""
      */
     bodyClassName?: string;
-    /** 内容区域的内联样式。 */
+    /** 内容区域的内联样式，可覆盖默认内边距：上下 6px，左右使用 --sia-spacing；bordered 为 false 时默认内边距为 0。 */
     bodyStyle?: CSSProperties;
 }
 /** 卡片组件。 */
-declare function Card({ title, description, extra, selectable, selected, showSelectedIndicator, defaultSelected, disabled, onSelectedChange, hoverActions, accent, accentColor, collapsible, collapsed, defaultCollapsed, onCollapsedChange, bodyHeight, bodyClassName, bodyStyle, className, style, children, onClick, onKeyDown, ...props }: CardProps): react.JSX.Element;
+declare function Card({ bordered, title, description, extra, selectable, selected, showSelectedIndicator, defaultSelected, disabled, onSelectedChange, hoverActions, accent, accentColor, collapsible, collapsed, defaultCollapsed, onCollapsedChange, bodyHeight, bodyClassName, bodyStyle, className, style, children, onClick, onKeyDown, ...props }: CardProps): react.JSX.Element;
 
 declare const iconPaths: {
     "notepad-file": react.JSX.Element;
@@ -1013,7 +1019,7 @@ interface TreeNode {
     children?: readonly TreeNode[];
     [key: string]: unknown;
 }
-/** 树的属性配置。 */
+/** 树的属性配置；通过 style 或 className 设置高度限制及 overflow: auto 后，溢出内容使用不占布局空间的浮动滚动条。 */
 interface TreeProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSelect" | "onDrop"> {
     /** 树形节点数据 */
     treeData: readonly TreeNode[];
@@ -1103,6 +1109,21 @@ interface TreeProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSelect" | "o
      * @defaultValue 34
      */
     stickyRowHeight?: number;
+    /**
+     * 是否允许组件在可见节点达到阈值且自身形成滚动视口时自动启用虚拟滚动；关闭后始终渲染全部已展开节点。
+     * @defaultValue true
+     */
+    virtual?: boolean;
+    /**
+     * 自动启用虚拟滚动所需的最少可见节点数；小于该数量时保留完整 DOM，避免为小树增加额外计算。
+     * @defaultValue 100
+     */
+    virtualThreshold?: number;
+    /**
+     * 虚拟滚动模式下每一行的固定高度，单位为像素；未传入时使用 stickyRowHeight 的值。
+     * @defaultValue stickyRowHeight
+     */
+    virtualItemHeight?: number;
     /**
      * 是否允许拖拽。
      * @defaultValue false
@@ -1145,8 +1166,8 @@ interface TreeProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSelect" | "o
         dropPosition: TreeDropPosition;
     }) => void;
 }
-/** 树组件。 */
-declare function Tree({ treeData, selectedKeys, defaultSelectedKeys, expandedKeys, defaultExpandedKeys, defaultExpandAll, checkedKeys, defaultCheckedKeys, loadingKeys, checkable, checkStrictly, multiple, selectable, showLine, showIcon, blockNode, indentSize, switcherWidth, stickyAncestors, stickyRowHeight, draggable, loadData, onSelect, onCheck, onExpand, onDrop, className, ...props }: TreeProps): react.JSX.Element;
+/** 树形控件，支持选择、勾选与异步加载；自身容器可滚动时默认接入浮动滚动条，无需全局 Provider。 */
+declare function Tree({ treeData, selectedKeys, defaultSelectedKeys, expandedKeys, defaultExpandedKeys, defaultExpandAll, checkedKeys, defaultCheckedKeys, loadingKeys, checkable, checkStrictly, multiple, selectable, showLine, showIcon, blockNode, indentSize, switcherWidth, stickyAncestors, stickyRowHeight, virtual, virtualThreshold, virtualItemHeight, draggable, loadData, onSelect, onCheck, onExpand, onDrop, className, ...props }: TreeProps): react.JSX.Element;
 
 /** 气泡确认的属性配置。 */
 interface PopconfirmProps {
@@ -1999,7 +2020,7 @@ interface UploadProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue
     fileList?: readonly UploadFile[];
     /** 非受控初始列表，后续修改不重置列表。 @defaultValue [] */
     defaultFileList?: readonly UploadFile[];
-    /** 文件列表样式：text 为文字列表，picture 为带缩略图的图片列表，picture-card 为照片墙。 @defaultValue "text" */
+    /** 文件列表样式：text 为带文件数量标题、图标和状态的文字卡片列表，picture 为带缩略图的图片列表，picture-card 为照片墙。 @defaultValue "text" */
     listType?: "text" | "picture" | "picture-card";
     /** 照片墙卡片尺寸，仅 listType="picture-card" 生效；数字设置正方形，对象分别设置宽高，单位 px。默认 112×112，各边最小 48，无效数值使用默认值；宽或高小于 88px 时隐藏文件名。 */
     cardSize?: number | {
@@ -2008,7 +2029,7 @@ interface UploadProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue
         /** 卡片高度，默认 112px，最小 48px。 */
         height?: number;
     };
-    /** 是否显示列表；隐藏时仍执行数量限制和变更通知。 @defaultValue true */
+    /** 是否显示内置列表及文字列表的数量标题；隐藏时仍执行数量限制和变更通知。 @defaultValue true */
     showUploadList?: boolean;
     /** 启动前校验，可异步；false 保留 ready，Upload.LIST_IGNORE 移除，File 转换本次上传内容；拒绝或抛错进入 error。手动上传时在调用 upload 后执行。 */
     beforeUpload?: (file: File, fileList: readonly File[]) => boolean | File | symbol | Promise<boolean | File | symbol>;
@@ -2041,9 +2062,9 @@ interface UploadDraggerProps extends UploadProps {
     hint?: ReactNode;
 }
 
-/** 上传组件，支持图片列表、照片墙、目录、粘贴与完全受控请求；未配置请求时仅选择文件。 */
+/** 上传组件，默认以带数量标题和状态的文字卡片展示已选文件；支持图片列表、照片墙、目录、粘贴与完全受控请求，未配置请求时仅选择文件。 */
 declare const Upload: react.ForwardRefExoticComponent<UploadProps & react.RefAttributes<UploadRef>> & {
-    /** 可点击、键盘操作和拖拽的上传区域，ref 支持手动上传、取消及移除。 */
+    /** 可点击、键盘操作和拖拽的上传区域，ref 支持手动上传、取消及移除；默认内容在文字或图片列表非空且可见时收紧高度，清空后恢复。 */
     Dragger: react.ForwardRefExoticComponent<UploadDraggerProps & react.RefAttributes<UploadRef>>;
     /** beforeUpload 返回时移除该文件，不进行上传。 */
     LIST_IGNORE: symbol;