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

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

@@ -5,7 +5,7 @@ import {
   Popover,
   Tooltip,
   useOverlayLifecycle
-} from "./chunk-F4XMRO6G.js";
+} from "./chunk-B42RCR7O.js";
 import {
   Dropdown,
   Icon

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-BemUqBUF.d.ts → core-DrNZuMER.d.ts}

@@ -109,7 +109,7 @@ interface CardProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
      * @defaultValue ""
      */
     bodyClassName?: string;
-    /** 内容区域的内联样式。 */
+    /** 内容区域的内联样式，可覆盖默认内边距：上下 6px，左右使用 --sia-spacing；bordered 为 false 时默认内边距为 0。 */
     bodyStyle?: CSSProperties;
 }
 /** 卡片组件。 */
@@ -1019,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[];
@@ -1109,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
@@ -1151,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 {

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

@@ -109,7 +109,7 @@ interface CardProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
      * @defaultValue ""
      */
     bodyClassName?: string;
-    /** 内容区域的内联样式。 */
+    /** 内容区域的内联样式，可覆盖默认内边距：上下 6px，左右使用 --sia-spacing；bordered 为 false 时默认内边距为 0。 */
     bodyStyle?: CSSProperties;
 }
 /** 卡片组件。 */
@@ -1019,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[];
@@ -1109,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
@@ -1151,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 {