@sia.soul/sia-react-ui 0.1.39 → 0.1.41

package/dist/{core-D4opRFkZ.d.cts → core-C2IieVNm.d.cts}

@@ -721,7 +721,7 @@ interface TabsProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
      * @defaultValue false
      */
     centered?: boolean;
-    /** 标签栏左侧标题，科技大屏型会附带装饰线；折线科技型横向布局按标题内容及装饰留白确定宽度，标签超宽时独立横向滚动并保持当前标签可见，窄屏时标题独占一行。 */
+    /** 标签栏左侧标题，支持文本或 React 节点；科技样式附带装饰线。 */
     tabBarTitle?: ReactNode;
     /** 标签栏与内容面板之间的间距，单位 px，支持 0；未指定时上下布局为 16px，左右布局为 20px。仅影响当前 Tabs，不传递给嵌套实例。 */
     contentGap?: number;
@@ -744,7 +744,7 @@ interface TabsProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
     /** 点击选项卡右键菜单时调用。 */
     onTabContextMenuClick?: (info: TabsContextMenuClickInfo) => void;
 }
-/** 选项卡组件。 */
+/** 选项卡组件；横向空间不足时，剩余标签收起到末尾的更多菜单，支持悬停或点击展开。 */
 declare function Tabs({ items, activeKey, defaultActiveKey, onChange, onAfterChange, deferContent, type, size, tabPosition, orientation, centered, tabBarTitle, tabBarExtraContent, contentGap, destroyInactiveTabPane, closable, onEdit, tabContextMenu, onTabContextMenuClick, className, ...props }: TabsProps): react.JSX.Element;
 
 /** 打开下拉菜单的触发方式。 */
@@ -852,15 +852,15 @@ declare const Dropdown: typeof DropdownRoot & {
     Button: typeof DropdownButton;
 };
 
-/** Floating的位置类型。 */
-type FloatingPlacement = "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "right";
+/** 气泡十二个方向；start/end 为对应边的起点/终点对齐，同时支持 topLeft、leftTop 等驼峰别名。 */
+type FloatingPlacement = "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "left-start" | "left-end" | "right" | "right-start" | "right-end" | "topLeft" | "topRight" | "bottomLeft" | "bottomRight" | "leftTop" | "leftBottom" | "rightTop" | "rightBottom";
 /** 触发浮层显示的交互方式。 */
 type FloatingTrigger = "hover" | "focus" | "click";
 /** 文字提示的属性配置。 */
 interface TooltipProps {
     /** 标题内容，可传入文本或 React 节点。 */
     title?: ReactNode;
-    /** 子内容；组件嵌套内容或当前节点的子项。 */
+    /** 触发气泡的元素；定位以实际接收触发事件的 DOM 元素为准，初始打开时使用首个子元素。 */
     children: ReactElement;
     /** 相对于触发元素的弹出方向和对齐位置。 */
     placement?: FloatingPlacement;
@@ -876,8 +876,13 @@ interface TooltipProps {
     mouseEnterDelay?: number;
     /** 鼠标移出后延迟隐藏的时间。 */
     mouseLeaveDelay?: number;
-    /** 显示箭头及是否指向触发器中心 */
-    arrow?: boolean;
+    /** 是否显示箭头，默认 true；对象配置可让箭头指向触发元素中心。 */
+    arrow?: boolean | {
+        /** 是否指向触发元素中心，默认 false；空间受限时箭头限制在气泡边缘内。 */
+        pointAtCenter?: boolean;
+    };
+    /** 是否自动翻转和贴边偏移，默认 true；滚动时始终跟随触发元素，目标完全离开可视区域时隐藏气泡。 */
+    autoAdjustOverflow?: boolean;
     /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
     /** 附加到组件根节点的 CSS 类名。 */
@@ -1119,7 +1124,7 @@ declare function Tree({ treeData, selectedKeys, defaultSelectedKeys, expandedKey
 
 /** 气泡确认的属性配置。 */
 interface PopconfirmProps {
-    /** 子内容；组件嵌套内容或当前节点的子项。 */
+    /** 触发确认框的元素；默认在该元素上方居中显示，空间不足时自动避让。 */
     children: ReactElement;
     /** 标题内容，可传入文本或 React 节点。 */
     title: ReactNode;
@@ -1144,6 +1149,12 @@ interface PopconfirmProps {
      * @defaultValue "top"
      */
     placement?: FloatingPlacement;
+    /** 是否显示箭头，默认 true；设置 { pointAtCenter: true } 时指向触发元素中心。 */
+    arrow?: TooltipProps["arrow"];
+    /** 是否自动翻转和贴边偏移，默认 true；滚动时跟随目标，目标完全离开可视区域时隐藏。 */
+    autoAdjustOverflow?: boolean;
+    /** 是否跳过气泡直接确认，默认 false；为 true 时仅点击触发元素会调用 onConfirm，disabled 优先，异步执行期间忽略重复点击。 */
+    skipConfirm?: boolean;
     /**
      * 触发显示的交互方式。
      * @defaultValue "click"
@@ -1168,15 +1179,17 @@ interface PopconfirmProps {
     showCancel?: boolean;
     /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
-    /** 用户确认时调用；支持异步返回值，具体签名见类型。 */
-    onConfirm?: (event?: React.MouseEvent) => void | boolean | Promise<void | boolean>;
-    /** 用户取消或通过关闭入口退出时调用。 */
+    /** 点击确定或跳过确认时调用，参数为点击事件；返回 false 保持打开，其余同步结果关闭。返回 Promise 时显示加载状态，成功且结果不为 false 时关闭；抛错或拒绝时保持打开并调用 onConfirmError。受控模式通过 onOpenChange 请求关闭，需外部更新 open。 */
+    onConfirm?: (event?: React.MouseEvent) => void | boolean | PromiseLike<void | boolean>;
+    /** 确认回调抛错或 Promise 拒绝时调用，参数为原始错误；可用于展示失败提示，默认保持气泡并恢复按钮，不自动展示错误文案。 */
+    onConfirmError?: (error: unknown) => void;
+    /** 点击取消按钮时调用，参数为点击事件；点击外部关闭不会触发此回调。 */
     onCancel?: (event?: React.MouseEvent) => void;
     /** 打开状态改变时触发，参数为新的打开状态。 */
     onOpenChange?: (open: boolean) => void;
 }
 /** 气泡确认组件。 */
-declare function Popconfirm({ children, title, description, okText, cancelText, okButtonProps, cancelButtonProps, placement, trigger, open, defaultOpen, disabled, showCancel, icon, onConfirm, onCancel, onOpenChange, }: PopconfirmProps): react.JSX.Element;
+declare function Popconfirm({ children, title, description, okText, cancelText, okButtonProps, cancelButtonProps, placement, trigger, open, defaultOpen, disabled, showCancel, icon, onConfirm, onConfirmError, onCancel, onOpenChange, arrow, autoAdjustOverflow, skipConfirm, }: PopconfirmProps): react.JSX.Element;
 /** 进度的状态类型。 */
 type ProgressStatus = "normal" | "active" | "success" | "exception";
 /** 进度的属性配置。 */

package/dist/{core-VNY_7WRq.d.ts → core-ZmKnvCFV.d.ts}

@@ -721,7 +721,7 @@ interface TabsProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
      * @defaultValue false
      */
     centered?: boolean;
-    /** 标签栏左侧标题，科技大屏型会附带装饰线；折线科技型横向布局按标题内容及装饰留白确定宽度，标签超宽时独立横向滚动并保持当前标签可见，窄屏时标题独占一行。 */
+    /** 标签栏左侧标题，支持文本或 React 节点；科技样式附带装饰线。 */
     tabBarTitle?: ReactNode;
     /** 标签栏与内容面板之间的间距，单位 px，支持 0；未指定时上下布局为 16px，左右布局为 20px。仅影响当前 Tabs，不传递给嵌套实例。 */
     contentGap?: number;
@@ -744,7 +744,7 @@ interface TabsProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
     /** 点击选项卡右键菜单时调用。 */
     onTabContextMenuClick?: (info: TabsContextMenuClickInfo) => void;
 }
-/** 选项卡组件。 */
+/** 选项卡组件；横向空间不足时，剩余标签收起到末尾的更多菜单，支持悬停或点击展开。 */
 declare function Tabs({ items, activeKey, defaultActiveKey, onChange, onAfterChange, deferContent, type, size, tabPosition, orientation, centered, tabBarTitle, tabBarExtraContent, contentGap, destroyInactiveTabPane, closable, onEdit, tabContextMenu, onTabContextMenuClick, className, ...props }: TabsProps): react.JSX.Element;
 
 /** 打开下拉菜单的触发方式。 */
@@ -852,15 +852,15 @@ declare const Dropdown: typeof DropdownRoot & {
     Button: typeof DropdownButton;
 };
 
-/** Floating的位置类型。 */
-type FloatingPlacement = "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "right";
+/** 气泡十二个方向；start/end 为对应边的起点/终点对齐，同时支持 topLeft、leftTop 等驼峰别名。 */
+type FloatingPlacement = "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "left-start" | "left-end" | "right" | "right-start" | "right-end" | "topLeft" | "topRight" | "bottomLeft" | "bottomRight" | "leftTop" | "leftBottom" | "rightTop" | "rightBottom";
 /** 触发浮层显示的交互方式。 */
 type FloatingTrigger = "hover" | "focus" | "click";
 /** 文字提示的属性配置。 */
 interface TooltipProps {
     /** 标题内容，可传入文本或 React 节点。 */
     title?: ReactNode;
-    /** 子内容；组件嵌套内容或当前节点的子项。 */
+    /** 触发气泡的元素；定位以实际接收触发事件的 DOM 元素为准，初始打开时使用首个子元素。 */
     children: ReactElement;
     /** 相对于触发元素的弹出方向和对齐位置。 */
     placement?: FloatingPlacement;
@@ -876,8 +876,13 @@ interface TooltipProps {
     mouseEnterDelay?: number;
     /** 鼠标移出后延迟隐藏的时间。 */
     mouseLeaveDelay?: number;
-    /** 显示箭头及是否指向触发器中心 */
-    arrow?: boolean;
+    /** 是否显示箭头，默认 true；对象配置可让箭头指向触发元素中心。 */
+    arrow?: boolean | {
+        /** 是否指向触发元素中心，默认 false；空间受限时箭头限制在气泡边缘内。 */
+        pointAtCenter?: boolean;
+    };
+    /** 是否自动翻转和贴边偏移，默认 true；滚动时始终跟随触发元素，目标完全离开可视区域时隐藏气泡。 */
+    autoAdjustOverflow?: boolean;
     /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
     /** 附加到组件根节点的 CSS 类名。 */
@@ -1119,7 +1124,7 @@ declare function Tree({ treeData, selectedKeys, defaultSelectedKeys, expandedKey
 
 /** 气泡确认的属性配置。 */
 interface PopconfirmProps {
-    /** 子内容；组件嵌套内容或当前节点的子项。 */
+    /** 触发确认框的元素；默认在该元素上方居中显示，空间不足时自动避让。 */
     children: ReactElement;
     /** 标题内容，可传入文本或 React 节点。 */
     title: ReactNode;
@@ -1144,6 +1149,12 @@ interface PopconfirmProps {
      * @defaultValue "top"
      */
     placement?: FloatingPlacement;
+    /** 是否显示箭头，默认 true；设置 { pointAtCenter: true } 时指向触发元素中心。 */
+    arrow?: TooltipProps["arrow"];
+    /** 是否自动翻转和贴边偏移，默认 true；滚动时跟随目标，目标完全离开可视区域时隐藏。 */
+    autoAdjustOverflow?: boolean;
+    /** 是否跳过气泡直接确认，默认 false；为 true 时仅点击触发元素会调用 onConfirm，disabled 优先，异步执行期间忽略重复点击。 */
+    skipConfirm?: boolean;
     /**
      * 触发显示的交互方式。
      * @defaultValue "click"
@@ -1168,15 +1179,17 @@ interface PopconfirmProps {
     showCancel?: boolean;
     /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
-    /** 用户确认时调用；支持异步返回值，具体签名见类型。 */
-    onConfirm?: (event?: React.MouseEvent) => void | boolean | Promise<void | boolean>;
-    /** 用户取消或通过关闭入口退出时调用。 */
+    /** 点击确定或跳过确认时调用，参数为点击事件；返回 false 保持打开，其余同步结果关闭。返回 Promise 时显示加载状态，成功且结果不为 false 时关闭；抛错或拒绝时保持打开并调用 onConfirmError。受控模式通过 onOpenChange 请求关闭，需外部更新 open。 */
+    onConfirm?: (event?: React.MouseEvent) => void | boolean | PromiseLike<void | boolean>;
+    /** 确认回调抛错或 Promise 拒绝时调用，参数为原始错误；可用于展示失败提示，默认保持气泡并恢复按钮，不自动展示错误文案。 */
+    onConfirmError?: (error: unknown) => void;
+    /** 点击取消按钮时调用，参数为点击事件；点击外部关闭不会触发此回调。 */
     onCancel?: (event?: React.MouseEvent) => void;
     /** 打开状态改变时触发，参数为新的打开状态。 */
     onOpenChange?: (open: boolean) => void;
 }
 /** 气泡确认组件。 */
-declare function Popconfirm({ children, title, description, okText, cancelText, okButtonProps, cancelButtonProps, placement, trigger, open, defaultOpen, disabled, showCancel, icon, onConfirm, onCancel, onOpenChange, }: PopconfirmProps): react.JSX.Element;
+declare function Popconfirm({ children, title, description, okText, cancelText, okButtonProps, cancelButtonProps, placement, trigger, open, defaultOpen, disabled, showCancel, icon, onConfirm, onConfirmError, onCancel, onOpenChange, arrow, autoAdjustOverflow, skipConfirm, }: PopconfirmProps): react.JSX.Element;
 /** 进度的状态类型。 */
 type ProgressStatus = "normal" | "active" | "success" | "exception";
 /** 进度的属性配置。 */