@sia.soul/sia-react-ui 0.1.20 → 0.1.22

package/dist/index.cjs

@@ -1484,6 +1484,7 @@ function DropdownRoot({
   open,
   defaultOpen = false,
   disabled = false,
+  showTriggerIcon = true,
   arrow = false,
   autoFocus = false,
   openDelay = 80,
@@ -1644,6 +1645,10 @@ function DropdownRoot({
       className: "sia-dropdown__menu"
     }
   );
+  const triggerNode = showTriggerIcon && (0, import_react7.isValidElement)(children) && children.type === Button && children.props.children !== void 0 && children.props.children !== null ? (0, import_react7.cloneElement)(children, {}, /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("span", { className: "sia-dropdown__trigger-content", children: [
+    children.props.children,
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Icon, { name: "chevron-down", size: 14, className: "sia-dropdown__trigger-icon" })
+  ] })) : children;
   return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
     "span",
     {
@@ -1659,7 +1664,7 @@ function DropdownRoot({
       onKeyDown: handleKeyDown,
       ...props,
       children: [
-        children,
+        triggerNode,
         /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
           "span",
           {
@@ -1706,7 +1711,7 @@ function DropdownButton({
 }) {
   return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("span", { className: `sia-dropdown-button ${className}`.trim(), children: [
     /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Button, { ...buttonProps, disabled, onClick, children }),
-    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(DropdownRoot, { ...dropdownProps, disabled, trigger, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(DropdownRoot, { ...dropdownProps, disabled, trigger, showTriggerIcon: false, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
       Button,
       {
         ...buttonProps,
@@ -1718,7 +1723,10 @@ function DropdownButton({
     ) })
   ] });
 }
-var Dropdown = Object.assign(DropdownRoot, { Button: DropdownButton });
+var Dropdown = Object.assign(DropdownRoot, {
+  /** 组合主操作按钮与下拉菜单的按钮组件。 */
+  Button: DropdownButton
+});
 
 // src/components/Pagination.tsx
 var import_react18 = require("react");
@@ -2027,12 +2035,19 @@ function preset(type, defaults = {}) {
   });
 }
 var Modal2 = Object.assign(ModalRoot, {
+  /** 直接打开实例，返回可用于更新或关闭的操作句柄。 */
   open: openModal,
+  /** 显示普通信息提示。 */
   info: preset("info", { title: "\u63D0\u793A" }),
+  /** 显示成功提示。 */
   success: preset("success", { title: "\u64CD\u4F5C\u6210\u529F" }),
+  /** 显示警告提示。 */
   warning: preset("warning", { title: "\u8BF7\u6CE8\u610F" }),
+  /** 显示错误提示。 */
   error: preset("error", { title: "\u64CD\u4F5C\u5931\u8D25" }),
+  /** 打开确认弹框，支持异步确认；返回 false 可阻止关闭。 */
   confirm: preset("confirm", { title: "\u786E\u8BA4\u64CD\u4F5C" }),
+  /** 关闭由此 API 打开的所有弹层。 */
   destroyAll() {
     [...modalHandles].forEach((handle) => handle.destroy());
   }
@@ -2215,7 +2230,10 @@ function CheckboxGroup({
     children
   ] }) }) });
 }
-var Checkbox2 = Object.assign(CheckboxRoot, { Group: CheckboxGroup });
+var Checkbox2 = Object.assign(CheckboxRoot, {
+  /** 组合多个子项并统一管理布局或选择状态。 */
+  Group: CheckboxGroup
+});
 
 // src/components/SelectionPanel.tsx
 var import_react13 = require("react");
@@ -2695,6 +2713,8 @@ function SelectionPanel({
   const search = searchValue ?? localSearch;
   const [scrollTop, setScrollTop] = (0, import_react13.useState)(0);
   const [active, setActive] = (0, import_react13.useState)();
+  const [keyboardActive, setKeyboardActive] = (0, import_react13.useState)(false);
+  const [deselectedHover, setDeselectedHover] = (0, import_react13.useState)();
   const listRef = (0, import_react13.useRef)(null);
   const id = (0, import_react13.useId)();
   const selected = (0, import_react13.useMemo)(() => new Set(value), [value]);
@@ -2739,9 +2759,11 @@ function SelectionPanel({
     if (listRef.current) listRef.current.scrollTop = 0;
     setActive(void 0);
   }, [search, selectedOnly, count]);
-  function toggle(option) {
+  function toggle(option, keyboard = false) {
     if (disabled || loading || option.disabled || option.optionType === "divider") return;
     setActive(option.value);
+    setKeyboardActive(keyboard);
+    setDeselectedHover(!keyboard && !multiple && allowDeselect && selected.has(option.value) ? option.value : void 0);
     onChange(multiple ? selected.has(option.value) ? value.filter((item) => item !== option.value) : [...value, option.value] : allowDeselect && selected.has(option.value) ? [] : [option.value]);
   }
   function batch(operation) {
@@ -2791,6 +2813,10 @@ function SelectionPanel({
         className: "sia-selection-panel__list",
         style: { maxHeight },
         onScroll: (event) => setScrollTop(event.currentTarget.scrollTop),
+        onPointerDown: () => setKeyboardActive(false),
+        onBlur: (event) => {
+          if (!event.currentTarget.contains(event.relatedTarget)) setKeyboardActive(false);
+        },
         "aria-activedescendant": active !== void 0 ? `${id}-${typeof active}-${active}` : void 0,
         onKeyDown: (event) => {
           if (event.target instanceof HTMLInputElement) return;
@@ -2798,6 +2824,8 @@ function SelectionPanel({
           const index = enabled.findIndex((option) => option.value === active);
           if (["ArrowDown", "ArrowUp", "Home", "End"].includes(event.key)) {
             event.preventDefault();
+            setKeyboardActive(true);
+            setDeselectedHover(void 0);
             const next = event.key === "Home" ? 0 : event.key === "End" ? enabled.length - 1 : Math.max(0, Math.min(enabled.length - 1, index + (event.key === "ArrowDown" ? 1 : -1)));
             const option = enabled[next];
             setActive(option.value);
@@ -2808,7 +2836,7 @@ function SelectionPanel({
             }
           } else if ((event.key === "Enter" || event.key === " ") && index >= 0) {
             event.preventDefault();
-            toggle(enabled[index]);
+            toggle(enabled[index], true);
           }
         },
         children: loading ? /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("div", { role: "status", children: "\u52A0\u8F7D\u4E2D\u2026" }) : !rows.length ? /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("div", { className: "sia-selection-panel__empty", children: "\u6682\u65E0\u5339\u914D\u9009\u9879" }) : /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("div", { style: { height: totalHeight, position: "relative" }, children: renderedRows.map((row) => /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
@@ -2824,7 +2852,11 @@ function SelectionPanel({
                 tabIndex: -1,
                 "aria-selected": selected.has(option.value),
                 "aria-disabled": disabled || option.disabled || void 0,
-                className: `sia-selection-panel__option${active === option.value ? " is-active" : ""}`,
+                className: `sia-selection-panel__option${keyboardActive && active === option.value ? " is-active" : ""}`,
+                "data-deselected-hover": deselectedHover === option.value || void 0,
+                onPointerLeave: () => {
+                  if (deselectedHover === option.value) setDeselectedHover(void 0);
+                },
                 onClick: (event) => {
                   if (!event.target.closest(".sia-checkbox")) toggle(option);
                 },
@@ -3276,7 +3308,8 @@ function defaultFilterOption(query, option) {
 var Select = (0, import_react17.forwardRef)(function Select2({
   options,
   mode = "single",
-  popupMode = "dropdown",
+  popupMode: popupModeProp,
+  modalThreshold = 15,
   modalConfig,
   value,
   defaultValue,
@@ -3285,7 +3318,7 @@ var Select = (0, import_react17.forwardRef)(function Select2({
   placeholderMode,
   size: sizeProp,
   status = "default",
-  allowClear = false,
+  allowClear = true,
   loading = false,
   showSearch = false,
   showValue = false,
@@ -3318,6 +3351,9 @@ var Select = (0, import_react17.forwardRef)(function Select2({
   const searchRef = (0, import_react17.useRef)(null);
   const listRef = (0, import_react17.useRef)(null);
   const [open, setOpen] = (0, import_react17.useState)(false);
+  const automaticMode = popupModeProp ?? (options.length > modalThreshold ? "modal" : "dropdown");
+  const [openedMode, setOpenedMode] = (0, import_react17.useState)(automaticMode);
+  const popupMode = open ? openedMode : automaticMode;
   const [modalValues, setModalValues] = (0, import_react17.useState)([]);
   const [selectedOnly, setSelectedOnly] = (0, import_react17.useState)(false);
   const [query, setQuery] = (0, import_react17.useState)("");
@@ -3389,9 +3425,10 @@ var Select = (0, import_react17.forwardRef)(function Select2({
   }
   function openDropdown() {
     if (disabled || loading) return;
+    setOpenedMode(automaticMode);
     const selectedIndex = filteredOptions.findIndex((option) => selectedValueSet.has(option.value) && !option.disabled);
     setActiveIndex(selectedIndex >= 0 ? selectedIndex : firstEnabledIndex());
-    if (popupMode === "modal") {
+    if (automaticMode === "modal") {
       setModalValues([...selectedValues]);
       setSelectedOnly(false);
     }
@@ -3700,6 +3737,7 @@ var DEFAULT_PAGE_SIZE_OPTIONS = [10, 25, 50, 100, 200, 500, 1e3, 2e3, 5e3];
 function Pagination({
   size: sizeProp,
   total = 0,
+  currentPageCount,
   current,
   defaultCurrent = 1,
   pageSize,
@@ -3726,6 +3764,7 @@ function Pagination({
   const loading = refreshing ?? internalRefreshing;
   const sizes = [...new Set([...pageSizeOptions, size].filter((value) => value > 0))].sort((a, b) => a - b);
   const range = safeTotal ? [(safePage - 1) * size + 1, Math.min(safeTotal, safePage * size)] : [0, 0];
+  const pageCount = Math.max(0, currentPageCount ?? (safeTotal ? range[1] - range[0] + 1 : 0));
   if (hideOnSinglePage && totalPages <= 1) return null;
   function change(nextPage, nextSize = size) {
     const nextTotalPages = Math.max(1, Math.ceil(safeTotal / nextSize));
@@ -3749,6 +3788,11 @@ function Pagination({
     }
   }
   return /* @__PURE__ */ (0, import_jsx_runtime16.jsxs)("nav", { className: `sia-pagination sia-pagination--${controlSize} ${className}`.trim(), "aria-label": "\u5206\u9875", ...props, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime16.jsxs)("span", { className: "sia-pagination__current-count", "aria-live": "polite", children: [
+      "\u5F53\u524D\u9875 ",
+      pageCount,
+      " \u6761"
+    ] }),
     showSizeChanger ? /* @__PURE__ */ (0, import_jsx_runtime16.jsxs)("div", { className: "sia-pagination__size", children: [
       /* @__PURE__ */ (0, import_jsx_runtime16.jsx)("span", { children: "\u6BCF\u9875\u663E\u793A" }),
       /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(
@@ -4460,11 +4504,17 @@ function openNotification(config) {
   return { key, close: () => closeNotification(key) };
 }
 var notification = {
+  /** 直接打开实例，返回可用于更新或关闭的操作句柄。 */
   open: openNotification,
+  /** 显示普通信息提示。 */
   info: (config) => openNotification({ ...config, type: "info" }),
+  /** 显示成功提示。 */
   success: (config) => openNotification({ ...config, type: "success" }),
+  /** 显示警告提示。 */
   warning: (config) => openNotification({ ...config, type: "warning" }),
+  /** 显示错误提示。 */
   error: (config) => openNotification({ ...config, type: "error" }),
+  /** 关闭指定实例；未指定标识时关闭所有实例。 */
   destroy: (key) => {
     if (key !== void 0) closeNotification(key);
     else {
@@ -4640,7 +4690,10 @@ function SpaceRoot({
     split !== void 0 && index < items.length - 1 ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("span", { className: "sia-space__split", children: split }) : null
   ] }, index)) });
 }
-var Space = Object.assign(SpaceRoot, { Compact: SpaceCompact });
+var Space = Object.assign(SpaceRoot, {
+  /** 紧凑布局容器，将相邻控件组合为连续的按钮或输入组。 */
+  Compact: SpaceCompact
+});
 function Divider({
   orientation = "horizontal",
   variant = "solid",
@@ -4913,7 +4966,10 @@ function SplitterRoot({
     )];
   }) });
 }
-var Splitter = Object.assign(SplitterRoot, { Panel: SplitterPanel });
+var Splitter = Object.assign(SplitterRoot, {
+  /** Splitter 中的可调整大小面板。 */
+  Panel: SplitterPanel
+});
 
 // src/components/ToolPanel.tsx
 var import_react25 = require("react");
@@ -5463,7 +5519,9 @@ function openDrawer(config) {
   return handle;
 }
 var Drawer2 = Object.assign(DrawerRoot, {
+  /** 直接打开实例，返回可用于更新或关闭的操作句柄。 */
   open: openDrawer,
+  /** 关闭由此 API 打开的所有弹层。 */
   destroyAll() {
     [...drawerHandles].forEach((handle) => handle.destroy());
   }
@@ -5867,9 +5925,13 @@ function FormErrorList({ errors = [] }) {
   return errors.length ? /* @__PURE__ */ (0, import_jsx_runtime26.jsx)("div", { className: "sia-form-error-list", children: errors.map((error, index) => /* @__PURE__ */ (0, import_jsx_runtime26.jsx)("div", { children: error }, index)) }) : null;
 }
 var Form = Object.assign(FormRoot, {
+  /** 表单字段，负责字段值绑定、校验和标签布局。 */
   Item: FormItem,
+  /** 动态表单列表，提供字段索引以及新增、删除、移动操作。 */
   List: FormList,
+  /** 显示表单错误文本集合。 */
   ErrorList: FormErrorList,
+  /** 创建或复用表单实例，返回单元素元组 [form]。 */
   useForm
 });
 
@@ -5948,7 +6010,12 @@ function RadioGroup({
     children
   ] }) }) });
 }
-var Radio2 = Object.assign(RadioRoot, { Button: RadioButton, Group: RadioGroup });
+var Radio2 = Object.assign(RadioRoot, {
+  /** 组合主操作按钮与下拉菜单的按钮组件。 */
+  Button: RadioButton,
+  /** 组合多个子项并统一管理布局或选择状态。 */
+  Group: RadioGroup
+});
 
 // src/components/Slider.tsx
 var import_react29 = require("react");
@@ -7871,7 +7938,12 @@ function UploadDragger({ hint = "\u652F\u6301\u5355\u4E2A\u6216\u6279\u91CF\u4E0
     /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("span", { children: hint })
   ] }) });
 }
-var Upload = Object.assign(UploadRoot, { Dragger: UploadDragger, LIST_IGNORE });
+var Upload = Object.assign(UploadRoot, {
+  /** 支持拖入文件上传的区域组件。 */
+  Dragger: UploadDragger,
+  /** beforeUpload 返回此标记时忽略该文件，不加入上传列表。 */
+  LIST_IGNORE
+});
 
 // src/components/TextArea.tsx
 var import_react36 = require("react");
@@ -10073,12 +10145,19 @@ function shortcut(type) {
   return (content, duration) => openMessage({ content, duration, type });
 }
 var message = {
+  /** 直接打开实例，返回可用于更新或关闭的操作句柄。 */
   open: openMessage,
+  /** 显示普通信息提示。 */
   info: shortcut("info"),
+  /** 显示成功提示。 */
   success: shortcut("success"),
+  /** 显示警告提示。 */
   warning: shortcut("warning"),
+  /** 显示错误提示。 */
   error: shortcut("error"),
+  /** 显示持续加载提示。 */
   loading: shortcut("loading"),
+  /** 关闭指定实例；未指定标识时关闭所有实例。 */
   destroy(key) {
     if (key !== void 0) {
       closeMessage(key);
@@ -10086,6 +10165,7 @@ var message = {
     }
     [...messageItems].forEach((item) => closeMessage(item.key));
   },
+  /** 配置消息默认持续时间和最大同时显示数量。 */
   config(config) {
     if (config.duration !== void 0) defaultDuration = config.duration;
     if (config.maxCount !== void 0) maxCount = Math.max(1, config.maxCount);
@@ -10819,7 +10899,7 @@ function TableCellContent({ children, ellipsis, title }) {
       layouts.forEach((layout) => layout.removeAttribute("data-table-inline-layout"));
     };
   }, [children, ellipsis, customContent]);
-  return /* @__PURE__ */ (0, import_jsx_runtime47.jsx)("div", { ref, className: "sia-table__cell-content", title, "data-custom-content": customContent || void 0, "data-content-overflow": ellipsis && customContent && overflowing || void 0, children });
+  return /* @__PURE__ */ (0, import_jsx_runtime47.jsx)("div", { ref, className: "sia-table__cell-content", "data-custom-content": customContent || void 0, "data-content-overflow": ellipsis && customContent && overflowing || void 0, children: title ? /* @__PURE__ */ (0, import_jsx_runtime47.jsx)(Tooltip, { title, className: "sia-table__cell-tooltip", children: /* @__PURE__ */ (0, import_jsx_runtime47.jsx)("span", { children }) }) : children });
 }
 
 // src/components/Table/Table.tsx
@@ -10981,6 +11061,7 @@ function isInteractiveTableTarget(target) {
 function createCellSelectionPlugin(options = {}) {
   let dragMode = null;
   let dragAnchor = null;
+  let textCell = null;
   let headerDragAnchorKey = null;
   let snapshotCache = null;
   let latestContext = null;
@@ -11282,12 +11363,17 @@ function createCellSelectionPlugin(options = {}) {
         return;
       }
       if (!isSelectable(row, column, context)) return;
-      event.preventDefault();
       window.getSelection()?.removeAllRanges();
       focusTable(event.currentTarget);
       const address = { rowKey: row.key, columnKey: column.key };
-      dragAnchor = event.shiftKey && context.state.range ? context.state.range.anchor : address;
-      dragMode = "cells";
+      const extendRange = event.shiftKey && context.state.range;
+      dragAnchor = extendRange ? extendRange.anchor : address;
+      dragMode = extendRange ? "cells" : "text";
+      textCell = extendRange ? null : event.currentTarget;
+      if (extendRange) {
+        event.preventDefault();
+        window.getSelection()?.removeAllRanges();
+      }
       setSelection(context, { anchor: dragAnchor, focus: address });
     },
     onCellPointerMove(row, column, event, context) {
@@ -11295,6 +11381,7 @@ function createCellSelectionPlugin(options = {}) {
       if ((event.buttons & 1) === 0) {
         dragMode = null;
         dragAnchor = null;
+        textCell = null;
         return;
       }
       if (dragMode === "rows") {
@@ -11304,6 +11391,12 @@ function createCellSelectionPlugin(options = {}) {
         return;
       }
       if (!isSelectable(row, column, context)) return;
+      if (dragMode === "text") {
+        if (sameCellAddress(dragAnchor, { rowKey: row.key, columnKey: column.key })) return;
+        dragMode = "cells";
+        textCell = null;
+        focusTable(event.currentTarget);
+      }
       event.preventDefault();
       window.getSelection()?.removeAllRanges();
       setSelection(context, {
@@ -11337,14 +11430,29 @@ function createCellSelectionPlugin(options = {}) {
     },
     onMount() {
       const stopDragging = () => {
+        constrainTextSelection();
         dragMode = null;
         dragAnchor = null;
+        textCell = null;
         headerDragAnchorKey = null;
       };
+      const constrainTextSelection = () => {
+        if (!dragMode) return;
+        const selection = window.getSelection();
+        if (!selection || selection.isCollapsed) return;
+        if (dragMode !== "text" || !textCell?.contains(selection.anchorNode) || !textCell.contains(selection.focusNode)) {
+          selection.removeAllRanges();
+        }
+      };
+      const handleSelectStart = (event) => {
+        if (dragMode && dragMode !== "text") event.preventDefault();
+      };
       const handleCopy = (event) => {
         const context = latestContext;
         if (options.copyable === false || !context || !activeRoot || !activeRoot.contains(document.activeElement) || isInteractiveTableTarget(document.activeElement))
           return;
+        const selection = window.getSelection();
+        if (selection && !selection.isCollapsed && selection.toString()) return;
         const text = copyText(context);
         if (!text) return;
         event.preventDefault();
@@ -11352,11 +11460,18 @@ function createCellSelectionPlugin(options = {}) {
         options.onCopy?.(text, selectedCells(context));
       };
       window.addEventListener("pointerup", stopDragging);
+      window.addEventListener("pointercancel", stopDragging);
       window.addEventListener("blur", stopDragging);
+      document.addEventListener("selectionchange", constrainTextSelection);
+      document.addEventListener("selectstart", handleSelectStart);
       document.addEventListener("copy", handleCopy);
       return () => {
+        stopDragging();
         window.removeEventListener("pointerup", stopDragging);
+        window.removeEventListener("pointercancel", stopDragging);
         window.removeEventListener("blur", stopDragging);
+        document.removeEventListener("selectionchange", constrainTextSelection);
+        document.removeEventListener("selectstart", handleSelectStart);
         document.removeEventListener("copy", handleCopy);
       };
     },
@@ -12088,6 +12203,7 @@ function createPaginationPlugin(options = {}) {
         Pagination,
         {
           className: "sia-table__pagination",
+          currentPageCount: context.rows.length,
           current: page.current,
           pageSize: page.pageSize,
           pageSizeOptions: options.pageSizeOptions ?? DEFAULT_PAGE_SIZE_OPTIONS,
@@ -12856,7 +12972,6 @@ function ColumnSettingPanel({
                           "span",
                           {
                             className: "sia-table-settings__name",
-                            title: labels.get(item.key) ?? item.key,
                             children: labels.get(item.key) ?? item.key
                           }
                         ),
@@ -13128,7 +13243,6 @@ function ToolbarItems({
         danger: item.danger,
         icon: item.icon,
         disabled,
-        title: typeof item.label === "string" ? item.label : void 0,
         onClick: () => void item.onClick?.(context),
         children: item.label
       },
@@ -13400,7 +13514,7 @@ var TableBodyRow = (0, import_react47.memo)(function TableBodyRow2({
               TableCellContent,
               {
                 ellipsis: column.ellipsis !== false,
-                title: column.showTitle !== false && column.ellipsis !== false && typeof value === "string" ? value : void 0,
+                title: column.showTitle === true && column.ellipsis !== false && typeof value === "string" ? value : void 0,
                 children: pluginCellProps.content !== void 0 ? pluginCellProps.content : column.render ? column.render(value, row.record, row.sourceIndex, { row, rowIndex, column }) : value
               }
             )
@@ -13825,7 +13939,7 @@ function TableInner(props, ref) {
       const fixed = normalizeFixed(column.fixed);
       const fixedEdgeClass = fixed === "left" && column.key === leftFixedEdgeKey ? " sia-table__cell--fixed-left-edge" : fixed === "right" && column.key === rightFixedEdgeKey ? " sia-table__cell--fixed-right-edge" : "";
       const autoWidthClass = column.autoWidth ? " sia-table__cell--auto-width" : "";
-      return /* @__PURE__ */ (0, import_jsx_runtime49.jsx)("td", { "data-column-key": column.key, className: `sia-table__cell sia-table__cell--${column.align ?? "left"} sia-table__summary-cell${isLabel ? " sia-table__summary-cell--label" : ""}${fixed ? ` sia-table__cell--fixed sia-table__cell--fixed-${fixed}` : ""}${fixedEdgeClass}${autoWidthClass}`, style: getFixedStyle(column), children: isLabel ? /* @__PURE__ */ (0, import_jsx_runtime49.jsx)("span", { className: "sia-table__summary-label", title: typeof content === "string" ? content : void 0, children: content }) : content }, column.key);
+      return /* @__PURE__ */ (0, import_jsx_runtime49.jsx)("td", { "data-column-key": column.key, className: `sia-table__cell sia-table__cell--${column.align ?? "left"} sia-table__summary-cell${isLabel ? " sia-table__summary-cell--label" : ""}${fixed ? ` sia-table__cell--fixed sia-table__cell--fixed-${fixed}` : ""}${fixedEdgeClass}${autoWidthClass}`, style: getFixedStyle(column), children: isLabel ? /* @__PURE__ */ (0, import_jsx_runtime49.jsx)("span", { className: "sia-table__summary-label", children: content }) : content }, column.key);
     }) }, summary.key);
   }
   return /* @__PURE__ */ (0, import_jsx_runtime49.jsxs)(
@@ -14051,19 +14165,33 @@ var ThemeSwitch = (0, import_react48.forwardRef)(function ThemeSwitch2({
 
 // src/theme.ts
 var SIA_THEME = {
+  /** 主色。 */
   colorPrimary: "#1677ff",
+  /** 主色的悬停色。 */
   colorPrimaryHover: "#4096ff",
+  /** 主色的按下色。 */
   colorPrimaryActive: "#0958d9",
+  /** 主要文本颜色。 */
   colorText: "#1f1f1f",
+  /** 次要文本颜色。 */
   colorTextSecondary: "#666666",
+  /** 页面背景颜色。 */
   colorBackground: "#f5f7fa",
+  /** 组件表面颜色。 */
   colorSurface: "#ffffff",
+  /** 默认边框颜色。 */
   colorBorder: "#d9d9d9",
+  /** 默认圆角半径，单位为像素。 */
   borderRadius: 6,
+  /** 默认控件高度，单位为像素。 */
   controlHeight: 32,
+  /** 默认布局间距，单位为像素。 */
   spacing: 16,
+  /** 默认字号，单位为像素。 */
   fontSize: 16,
+  /** 小号文字尺寸，单位为像素。 */
   fontSizeSmall: 14,
+  /** 大号文字尺寸，单位为像素。 */
   fontSizeLarge: 18
 };
 function applySiaTheme(mode, target = document.documentElement) {
@@ -14238,7 +14366,16 @@ function Link({ disabled, className = "", onClick, href, target, rel, ...props }
 function TypographyRoot({ className = "", ...props }) {
   return /* @__PURE__ */ (0, import_jsx_runtime52.jsx)("div", { ...props, className: `sia-typography ${className}`.trim() });
 }
-var Typography = Object.assign(TypographyRoot, { Title, Text, Paragraph, Link });
+var Typography = Object.assign(TypographyRoot, {
+  /** 语义化标题，支持标题级别、复制和编辑。 */
+  Title,
+  /** 行内文本，支持强调、复制、编辑和省略。 */
+  Text,
+  /** 段落文本，支持复制、编辑和省略。 */
+  Paragraph,
+  /** 具有排版样式的链接。 */
+  Link
+});
 
 // src/components/FloatButton.tsx
 var import_react50 = require("react");
@@ -14369,7 +14506,12 @@ function FloatButtonBackTop({ target, visibilityHeight = 400, behavior = "smooth
     element?.scrollTo({ top: 0, behavior: window.matchMedia("(prefers-reduced-motion: reduce)").matches ? "auto" : behavior });
   } });
 }
-var FloatButton2 = Object.assign(FloatButtonRoot, { Group: FloatButtonGroup, BackTop: FloatButtonBackTop });
+var FloatButton2 = Object.assign(FloatButtonRoot, {
+  /** 组合多个子项并统一管理布局或选择状态。 */
+  Group: FloatButtonGroup,
+  /** 滚动超过指定距离后显示的返回顶部按钮。 */
+  BackTop: FloatButtonBackTop
+});
 
 // src/components/ChartWhirlingLoading.tsx
 var import_react51 = require("react");
@@ -22038,7 +22180,7 @@ function QueryForm({
               {
                 className: "sia-query-form__field",
                 hidden: collapsed && index >= Math.min(limit, fittingCount),
-                style: entry.width !== void 0 ? { flexBasis: entry.width, width: entry.width } : void 0,
+                style: entry.width !== void 0 ? { "--sia-query-item-width": typeof entry.width === "number" ? `${entry.width}px` : entry.width } : void 0,
                 children: entry.content
               },
               entry.key

package/dist/index.css

@@ -4757,15 +4757,22 @@ fieldset:disabled .sia-input-number__floating-placeholder {
   display: flex;
   flex-wrap: wrap;
   align-items: center;
-  gap: 12px;
+  gap: var(--sia-query-field-gap, 12px);
   padding-top: 8px;
 }
 .sia-query-form__field {
-  flex: 0 1 var(--sia-query-field-width, 220px);
-  width: var(--sia-query-field-width, 220px);
+  --sia-query-item-width: var(--sia-query-field-width, 220px);
+  flex: 0 1 var(--sia-query-item-width);
+  width: var(--sia-query-item-width);
   min-width: 0;
   max-width: 100%;
 }
+.sia-query-form__field:has(.sia-picker-range-control, .sia-time-range, .sia-select-date-range, .sia-space-compact:not(.sia-space-compact--vertical) > :nth-child(2)) {
+  --sia-query-item-width: calc(var(--sia-query-field-width, 220px) + var(--sia-query-field-width, 220px) + var(--sia-query-field-gap, 12px));
+}
+.sia-query-form__field :is(.sia-picker-range-control, .sia-time-range, .sia-select-date-range, .sia-space-compact:not(.sia-space-compact--vertical)) {
+  width: 100%;
+}
 .sia-query-form__field[hidden] {
   display: none;
 }
@@ -4848,7 +4855,7 @@ fieldset:disabled .sia-input-number__floating-placeholder {
 @media (max-width: 600px) {
   .sia-query-form__fields.is-collapsed > .sia-query-form__field {
     flex-basis: auto !important;
-    width: var(--sia-query-field-width, 220px) !important;
+    width: var(--sia-query-item-width) !important;
   }
 }
 .sia-query-form__quick > .sia-badge:has(.sia-badge__count) {
@@ -7377,6 +7384,14 @@ fieldset:disabled .sia-input-number__floating-placeholder {
   cursor: not-allowed;
   opacity: .55;
 }
+.sia-dropdown__trigger-content {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+}
+.sia-dropdown__trigger-icon {
+  flex: none;
+}
 .sia-dropdown__context-anchor {
   position: fixed;
   width: 0;
@@ -7514,6 +7529,9 @@ fieldset:disabled .sia-input-number__floating-placeholder {
   gap: 4px;
   white-space: nowrap;
 }
+.sia-pagination__current-count {
+  white-space: nowrap;
+}
 .sia-pagination__size-select.sia-select {
   width: 94px;
 }
@@ -8529,6 +8547,12 @@ body > .sia-popup-portal[data-sia-popup-layer] {
   position: relative;
   display: inline-flex;
 }
+.sia-floating.sia-table__cell-tooltip {
+  display: block;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
 .sia-floating__overlay {
   --sia-floating-color: rgb(24 24 27 / 94%);
   --sia-floating-arrow-border: transparent;
@@ -9579,7 +9603,7 @@ button.sia-treemap__tile:focus-visible,
   min-width: 0;
   font: inherit;
 }
-.sia-selection-panel__option:hover,
+.sia-selection-panel__option:hover:not([data-deselected-hover=true]),
 .sia-selection-panel__option.is-active {
   background: var(--sia-color-fill-secondary, #f2f5f8);
 }