@sia.soul/sia-react-ui 0.1.92 → 0.1.95

package/dist/{Select-Bv2AmXRD.d.cts → Select-DQpfyK7I.d.cts}

@@ -177,6 +177,8 @@ type SelectOption = {
     disabled?: boolean;
     /** 弹框模式中的分组标题。 */
     group?: string;
+    /** 弹框模式中显示在选项名称旁的帮助说明，不参与搜索或回填。 */
+    description?: ReactNode;
 };
 /** 选择器的属性配置。 */
 interface SelectProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "defaultValue" | "onChange" | "value"> {
@@ -196,6 +198,9 @@ interface SelectProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "def
     modalThreshold?: number;
     /** 弹框标题、布局及顶部/底部扩展内容。 */
     modalConfig?: {
+        /** 多选弹框显示分组复选框，仅切换当前搜索及已选视图中该组的可用项。
+         * @defaultValue false */
+        groupCheckable?: boolean;
         /** 弹框标题，未设置时使用 Select 的 placeholder。 */
         title?: ReactNode;
         /** 弹框宽度，默认 900px。 */

package/dist/{Select-Cc1owuvN.d.ts → Select-DmT9pFRW.d.ts}

@@ -177,6 +177,8 @@ type SelectOption = {
     disabled?: boolean;
     /** 弹框模式中的分组标题。 */
     group?: string;
+    /** 弹框模式中显示在选项名称旁的帮助说明，不参与搜索或回填。 */
+    description?: ReactNode;
 };
 /** 选择器的属性配置。 */
 interface SelectProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "defaultValue" | "onChange" | "value"> {
@@ -196,6 +198,9 @@ interface SelectProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "def
     modalThreshold?: number;
     /** 弹框标题、布局及顶部/底部扩展内容。 */
     modalConfig?: {
+        /** 多选弹框显示分组复选框，仅切换当前搜索及已选视图中该组的可用项。
+         * @defaultValue false */
+        groupCheckable?: boolean;
         /** 弹框标题，未设置时使用 Select 的 placeholder。 */
         title?: ReactNode;
         /** 弹框宽度，默认 900px。 */

package/dist/{chunk-3JCIEB7I.js → chunk-4TTHPU2S.js}

@@ -1,7 +1,7 @@
 import {
   FloatingScrollbarProvider,
   Select
-} from "./chunk-ZY3YKRD4.js";
+} from "./chunk-DJTV4X6L.js";
 import {
   Icon
 } from "./chunk-X5BFQUFX.js";

package/dist/{chunk-ZY3YKRD4.js → chunk-DJTV4X6L.js}

@@ -1170,7 +1170,8 @@ function SelectionPanel({
   displayField = "label",
   columns = 1,
   maxHeight = 250,
-  autoFocusSearch = false
+  autoFocusSearch = false,
+  groupCheckable = false
 }) {
   const [localSearch, setLocalSearch] = useState2("");
   const search = searchValue ?? localSearch;
@@ -1202,7 +1203,7 @@ function SelectionPanel({
     let top = 0;
     for (const [group, items] of groups) {
       if (group) {
-        rows2.push({ key: `group-${rows2.length}`, title: group, top, height: 30 });
+        rows2.push({ key: `group-${rows2.length}`, title: group, items, top, height: 30 });
         top += 30;
       }
       for (let index = 0; index < items.length; index += count) {
@@ -1240,6 +1241,42 @@ function SelectionPanel({
     const add = enabled.filter((option) => operation === "all" || !selected.has(option.value)).map((option) => option.value);
     onChange([...retained, ...add]);
   }
+  function groupHeading(title, items) {
+    if (!multiple || !groupCheckable) return title;
+    const editable = items.filter((option) => !option.disabled && option.optionType !== "divider");
+    const all = editable.length > 0 && editable.every((option) => selected.has(option.value));
+    return /* @__PURE__ */ jsx3(
+      Checkbox2,
+      {
+        checked: all,
+        indeterminate: !all && editable.some((option) => selected.has(option.value)),
+        disabled: disabled || loading || !editable.length,
+        onChange: (checked) => {
+          const next = new Set(value);
+          editable.forEach((option) => checked ? next.add(option.value) : next.delete(option.value));
+          onChange([...next]);
+        },
+        children: title
+      }
+    );
+  }
+  function help(option) {
+    return option.description != null && option.description !== false ? /* @__PURE__ */ jsx3(Tooltip, { title: option.description, children: /* @__PURE__ */ jsx3(
+      "span",
+      {
+        role: "img",
+        "aria-label": "\u9009\u9879\u8BF4\u660E",
+        tabIndex: 0,
+        onClick: (event) => {
+          event.preventDefault();
+          event.stopPropagation();
+        },
+        onKeyDown: (event) => event.stopPropagation(),
+        style: { display: "inline-flex", marginInlineStart: 4 },
+        children: /* @__PURE__ */ jsx3(Icon, { name: "help-circle", size: 14 })
+      }
+    ) }) : null;
+  }
   return /* @__PURE__ */ jsxs3("div", { className: "sia-selection-panel", children: [
     /* @__PURE__ */ jsx3(FloatingScrollbarProvider, { targetRef: listRef }),
     showSearch && /* @__PURE__ */ jsx3(
@@ -1293,7 +1330,7 @@ function SelectionPanel({
             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);
-            const row = rows.find((row2) => row2.items?.includes(option));
+            const row = rows.find((row2) => row2.title === void 0 && row2.items?.includes(option));
             if (row && listRef.current) {
               listRef.current.scrollTop = Math.max(0, row.top - maxHeight / 2);
               setScrollTop(listRef.current.scrollTop);
@@ -1308,7 +1345,7 @@ function SelectionPanel({
           {
             className: row.title !== void 0 ? "sia-selection-panel__group" : "sia-selection-panel__row",
             style: { position: "absolute", top: row.top, height: row.height, width: "100%", gridTemplateColumns: `repeat(${count}, minmax(0, 1fr))` },
-            children: row.title ?? row.items?.map((option, index) => option.optionType === "divider" ? /* @__PURE__ */ jsx3("div", { role: "separator", className: "sia-selection-panel__divider" }, `divider-${index}`) : /* @__PURE__ */ jsx3(Tooltip, { title: option.disabled ? option.disabledTip : void 0, placement: "right", children: /* @__PURE__ */ jsx3(
+            children: row.title !== void 0 ? groupHeading(row.title, row.items ?? []) : row.items?.map((option, index) => option.optionType === "divider" ? /* @__PURE__ */ jsx3("div", { role: "separator", className: "sia-selection-panel__divider" }, `divider-${index}`) : /* @__PURE__ */ jsx3(Tooltip, { title: option.disabled ? option.disabledTip : void 0, placement: "right", children: /* @__PURE__ */ jsx3(
               "div",
               {
                 role: "option",
@@ -1325,10 +1362,16 @@ function SelectionPanel({
                   if (!event.target.closest(".sia-checkbox")) toggle(option);
                 },
                 children: multiple ? /* @__PURE__ */ jsx3(Checkbox2, { checked: selected.has(option.value), disabled: disabled || loading || option.disabled, tabIndex: -1, onChange: () => toggle(option), children: /* @__PURE__ */ jsxs3("span", { className: "sia-selection-panel__text", children: [
-                  /* @__PURE__ */ jsx3("span", { className: "sia-selection-panel__label", children: showValue || displayField === "label" ? option.label : String(option.value) }),
+                  /* @__PURE__ */ jsxs3("span", { className: "sia-selection-panel__label", children: [
+                    showValue || displayField === "label" ? option.label : String(option.value),
+                    help(option)
+                  ] }),
                   showValue && /* @__PURE__ */ jsx3("small", { children: String(option.value) })
                 ] }) }) : /* @__PURE__ */ jsxs3("span", { className: "sia-selection-panel__text", children: [
-                  /* @__PURE__ */ jsx3("span", { className: "sia-selection-panel__label", children: showValue || displayField === "label" ? option.label : String(option.value) }),
+                  /* @__PURE__ */ jsxs3("span", { className: "sia-selection-panel__label", children: [
+                    showValue || displayField === "label" ? option.label : String(option.value),
+                    help(option)
+                  ] }),
                   showValue && /* @__PURE__ */ jsx3("small", { children: String(option.value) })
                 ] })
               }
@@ -1852,6 +1895,7 @@ var Select = forwardRef2(function Select2({
               value: modalValues,
               onChange: setModalValues,
               multiple,
+              groupCheckable: modalConfig?.groupCheckable,
               allowDeselect: allowClear,
               selectedOnly,
               showValue,

package/dist/{chunk-7MTL2KB5.js → chunk-FGGBNWBT.js}

@@ -1,7 +1,7 @@
 import {
   Popover,
   Tooltip
-} from "./chunk-ZY3YKRD4.js";
+} from "./chunk-DJTV4X6L.js";
 import {
   Dropdown,
   Icon,

package/dist/{core-DV-4tf3K.d.cts → core-CkK9RRi0.d.cts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, HTMLAttributes, CSSProperties, MouseEvent, ReactElement, ImgHTMLAttributes, InputHTMLAttributes, MouseEventHandler, AnchorHTMLAttributes, ButtonHTMLAttributes } from 'react';
-import { B as ButtonProps, f as Button } from './Select-Bv2AmXRD.cjs';
+import { B as ButtonProps, f as Button } from './Select-DQpfyK7I.cjs';
 import { C as ControlSize, a as ControlStatus, I as InputPlaceholderMode } from './shared-Bx4B28Wh.cjs';
 
 /** 单个工具栏操作及其下拉菜单。 */

package/dist/{core-DBfzPqVR.d.ts → core-uAx1caJB.d.ts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, HTMLAttributes, CSSProperties, MouseEvent, ReactElement, ImgHTMLAttributes, InputHTMLAttributes, MouseEventHandler, AnchorHTMLAttributes, ButtonHTMLAttributes } from 'react';
-import { B as ButtonProps, f as Button } from './Select-Cc1owuvN.js';
+import { B as ButtonProps, f as Button } from './Select-DmT9pFRW.js';
 import { C as ControlSize, a as ControlStatus, I as InputPlaceholderMode } from './shared-Bx4B28Wh.js';
 
 /** 单个工具栏操作及其下拉菜单。 */

package/dist/core.cjs

@@ -3990,7 +3990,8 @@ function SelectionPanel({
   displayField = "label",
   columns = 1,
   maxHeight = 250,
-  autoFocusSearch = false
+  autoFocusSearch = false,
+  groupCheckable = false
 }) {
   const [localSearch, setLocalSearch] = (0, import_react23.useState)("");
   const search = searchValue ?? localSearch;
@@ -4022,7 +4023,7 @@ function SelectionPanel({
     let top = 0;
     for (const [group, items] of groups) {
       if (group) {
-        rows2.push({ key: `group-${rows2.length}`, title: group, top, height: 30 });
+        rows2.push({ key: `group-${rows2.length}`, title: group, items, top, height: 30 });
         top += 30;
       }
       for (let index = 0; index < items.length; index += count) {
@@ -4060,6 +4061,42 @@ function SelectionPanel({
     const add = enabled.filter((option) => operation === "all" || !selected.has(option.value)).map((option) => option.value);
     onChange([...retained, ...add]);
   }
+  function groupHeading(title, items) {
+    if (!multiple || !groupCheckable) return title;
+    const editable = items.filter((option) => !option.disabled && option.optionType !== "divider");
+    const all = editable.length > 0 && editable.every((option) => selected.has(option.value));
+    return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+      Checkbox2,
+      {
+        checked: all,
+        indeterminate: !all && editable.some((option) => selected.has(option.value)),
+        disabled: disabled || loading || !editable.length,
+        onChange: (checked) => {
+          const next = new Set(value);
+          editable.forEach((option) => checked ? next.add(option.value) : next.delete(option.value));
+          onChange([...next]);
+        },
+        children: title
+      }
+    );
+  }
+  function help(option) {
+    return option.description != null && option.description !== false ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Tooltip, { title: option.description, children: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+      "span",
+      {
+        role: "img",
+        "aria-label": "\u9009\u9879\u8BF4\u660E",
+        tabIndex: 0,
+        onClick: (event) => {
+          event.preventDefault();
+          event.stopPropagation();
+        },
+        onKeyDown: (event) => event.stopPropagation(),
+        style: { display: "inline-flex", marginInlineStart: 4 },
+        children: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Icon, { name: "help-circle", size: 14 })
+      }
+    ) }) : null;
+  }
   return /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "sia-selection-panel", children: [
     /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(FloatingScrollbarProvider, { targetRef: listRef }),
     showSearch && /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
@@ -4113,7 +4150,7 @@ function SelectionPanel({
             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);
-            const row = rows.find((row2) => row2.items?.includes(option));
+            const row = rows.find((row2) => row2.title === void 0 && row2.items?.includes(option));
             if (row && listRef.current) {
               listRef.current.scrollTop = Math.max(0, row.top - maxHeight / 2);
               setScrollTop(listRef.current.scrollTop);
@@ -4128,7 +4165,7 @@ function SelectionPanel({
           {
             className: row.title !== void 0 ? "sia-selection-panel__group" : "sia-selection-panel__row",
             style: { position: "absolute", top: row.top, height: row.height, width: "100%", gridTemplateColumns: `repeat(${count}, minmax(0, 1fr))` },
-            children: row.title ?? row.items?.map((option, index) => option.optionType === "divider" ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { role: "separator", className: "sia-selection-panel__divider" }, `divider-${index}`) : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Tooltip, { title: option.disabled ? option.disabledTip : void 0, placement: "right", children: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+            children: row.title !== void 0 ? groupHeading(row.title, row.items ?? []) : row.items?.map((option, index) => option.optionType === "divider" ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { role: "separator", className: "sia-selection-panel__divider" }, `divider-${index}`) : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Tooltip, { title: option.disabled ? option.disabledTip : void 0, placement: "right", children: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
               "div",
               {
                 role: "option",
@@ -4145,10 +4182,16 @@ function SelectionPanel({
                   if (!event.target.closest(".sia-checkbox")) toggle(option);
                 },
                 children: multiple ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Checkbox2, { checked: selected.has(option.value), disabled: disabled || loading || option.disabled, tabIndex: -1, onChange: () => toggle(option), children: /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("span", { className: "sia-selection-panel__text", children: [
-                  /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("span", { className: "sia-selection-panel__label", children: showValue || displayField === "label" ? option.label : String(option.value) }),
+                  /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("span", { className: "sia-selection-panel__label", children: [
+                    showValue || displayField === "label" ? option.label : String(option.value),
+                    help(option)
+                  ] }),
                   showValue && /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("small", { children: String(option.value) })
                 ] }) }) : /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("span", { className: "sia-selection-panel__text", children: [
-                  /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("span", { className: "sia-selection-panel__label", children: showValue || displayField === "label" ? option.label : String(option.value) }),
+                  /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("span", { className: "sia-selection-panel__label", children: [
+                    showValue || displayField === "label" ? option.label : String(option.value),
+                    help(option)
+                  ] }),
                   showValue && /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("small", { children: String(option.value) })
                 ] })
               }
@@ -4669,6 +4712,7 @@ var Select = (0, import_react25.forwardRef)(function Select2({
               value: modalValues,
               onChange: setModalValues,
               multiple,
+              groupCheckable: modalConfig?.groupCheckable,
               allowDeselect: allowClear,
               selectedOnly,
               showValue,

package/dist/core.d.cts

@@ -1,4 +1,4 @@
-export { d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, h as Card, i as CardAccent, j as CardProps, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, K as Icon, L as IconName, M as IconProps, N as IconVariant, U as Input, V as InputProps, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, aq as TabItem, ar as Tabs, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagSize, T as TagStatus, aA as TagVariant, aE as Toolbar, aF as ToolbarItem, aG as ToolbarProps, aR as Typography, aS as TypographyLinkProps, aT as TypographyProps, aU as TypographyTitleProps, aV as TypographyType, aW as Upload, aX as UploadChangeInfo, aY as UploadDraggerProps, aZ as UploadFile, a_ as UploadFileStatus, b1 as UploadProps, b5 as UploadRequestOptions, b9 as message } from './core-DV-4tf3K.cjs';
-export { f as Button, B as ButtonProps, e as ButtonSize, g as ButtonVariant, h as Modal, d as ModalActionResult, M as ModalOpenConfig, i as ModalProps, j as ModalType, a as OverlayApiHandle, k as Select, S as SelectOption, c as SelectProps, m as SelectValue } from './Select-Bv2AmXRD.cjs';
+export { d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, h as Card, i as CardAccent, j as CardProps, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, K as Icon, L as IconName, M as IconProps, N as IconVariant, U as Input, V as InputProps, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, aq as TabItem, ar as Tabs, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagSize, T as TagStatus, aA as TagVariant, aE as Toolbar, aF as ToolbarItem, aG as ToolbarProps, aR as Typography, aS as TypographyLinkProps, aT as TypographyProps, aU as TypographyTitleProps, aV as TypographyType, aW as Upload, aX as UploadChangeInfo, aY as UploadDraggerProps, aZ as UploadFile, a_ as UploadFileStatus, b1 as UploadProps, b5 as UploadRequestOptions, b9 as message } from './core-CkK9RRi0.cjs';
+export { f as Button, B as ButtonProps, e as ButtonSize, g as ButtonVariant, h as Modal, d as ModalActionResult, M as ModalOpenConfig, i as ModalProps, j as ModalType, a as OverlayApiHandle, k as Select, S as SelectOption, c as SelectProps, m as SelectValue } from './Select-DQpfyK7I.cjs';
 import 'react';
 import './shared-Bx4B28Wh.cjs';

package/dist/core.d.ts

@@ -1,4 +1,4 @@
-export { d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, h as Card, i as CardAccent, j as CardProps, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, K as Icon, L as IconName, M as IconProps, N as IconVariant, U as Input, V as InputProps, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, aq as TabItem, ar as Tabs, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagSize, T as TagStatus, aA as TagVariant, aE as Toolbar, aF as ToolbarItem, aG as ToolbarProps, aR as Typography, aS as TypographyLinkProps, aT as TypographyProps, aU as TypographyTitleProps, aV as TypographyType, aW as Upload, aX as UploadChangeInfo, aY as UploadDraggerProps, aZ as UploadFile, a_ as UploadFileStatus, b1 as UploadProps, b5 as UploadRequestOptions, b9 as message } from './core-DBfzPqVR.js';
-export { f as Button, B as ButtonProps, e as ButtonSize, g as ButtonVariant, h as Modal, d as ModalActionResult, M as ModalOpenConfig, i as ModalProps, j as ModalType, a as OverlayApiHandle, k as Select, S as SelectOption, c as SelectProps, m as SelectValue } from './Select-Cc1owuvN.js';
+export { d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, h as Card, i as CardAccent, j as CardProps, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, K as Icon, L as IconName, M as IconProps, N as IconVariant, U as Input, V as InputProps, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, aq as TabItem, ar as Tabs, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagSize, T as TagStatus, aA as TagVariant, aE as Toolbar, aF as ToolbarItem, aG as ToolbarProps, aR as Typography, aS as TypographyLinkProps, aT as TypographyProps, aU as TypographyTitleProps, aV as TypographyType, aW as Upload, aX as UploadChangeInfo, aY as UploadDraggerProps, aZ as UploadFile, a_ as UploadFileStatus, b1 as UploadProps, b5 as UploadRequestOptions, b9 as message } from './core-uAx1caJB.js';
+export { f as Button, B as ButtonProps, e as ButtonSize, g as ButtonVariant, h as Modal, d as ModalActionResult, M as ModalOpenConfig, i as ModalProps, j as ModalType, a as OverlayApiHandle, k as Select, S as SelectOption, c as SelectProps, m as SelectValue } from './Select-DmT9pFRW.js';
 import 'react';
 import './shared-Bx4B28Wh.js';

package/dist/core.js

@@ -10,10 +10,10 @@ import {
   Typography,
   Upload,
   message
-} from "./chunk-7MTL2KB5.js";
+} from "./chunk-FGGBNWBT.js";
 import {
   Select
-} from "./chunk-ZY3YKRD4.js";
+} from "./chunk-DJTV4X6L.js";
 import {
   Icon,
   Input,

package/dist/index.cjs

@@ -3987,7 +3987,8 @@ function SelectionPanel({
   displayField = "label",
   columns = 1,
   maxHeight = 250,
-  autoFocusSearch = false
+  autoFocusSearch = false,
+  groupCheckable = false
 }) {
   const [localSearch, setLocalSearch] = (0, import_react19.useState)("");
   const search = searchValue ?? localSearch;
@@ -4019,7 +4020,7 @@ function SelectionPanel({
     let top = 0;
     for (const [group, items] of groups) {
       if (group) {
-        rows2.push({ key: `group-${rows2.length}`, title: group, top, height: 30 });
+        rows2.push({ key: `group-${rows2.length}`, title: group, items, top, height: 30 });
         top += 30;
       }
       for (let index = 0; index < items.length; index += count) {
@@ -4057,6 +4058,42 @@ function SelectionPanel({
     const add = enabled.filter((option) => operation === "all" || !selected.has(option.value)).map((option) => option.value);
     onChange([...retained, ...add]);
   }
+  function groupHeading(title, items) {
+    if (!multiple || !groupCheckable) return title;
+    const editable = items.filter((option) => !option.disabled && option.optionType !== "divider");
+    const all = editable.length > 0 && editable.every((option) => selected.has(option.value));
+    return /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+      Checkbox2,
+      {
+        checked: all,
+        indeterminate: !all && editable.some((option) => selected.has(option.value)),
+        disabled: disabled || loading || !editable.length,
+        onChange: (checked) => {
+          const next = new Set(value);
+          editable.forEach((option) => checked ? next.add(option.value) : next.delete(option.value));
+          onChange([...next]);
+        },
+        children: title
+      }
+    );
+  }
+  function help(option) {
+    return option.description != null && option.description !== false ? /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(Tooltip, { title: option.description, children: /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+      "span",
+      {
+        role: "img",
+        "aria-label": "\u9009\u9879\u8BF4\u660E",
+        tabIndex: 0,
+        onClick: (event) => {
+          event.preventDefault();
+          event.stopPropagation();
+        },
+        onKeyDown: (event) => event.stopPropagation(),
+        style: { display: "inline-flex", marginInlineStart: 4 },
+        children: /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(Icon, { name: "help-circle", size: 14 })
+      }
+    ) }) : null;
+  }
   return /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("div", { className: "sia-selection-panel", children: [
     /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(FloatingScrollbarProvider, { targetRef: listRef }),
     showSearch && /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
@@ -4110,7 +4147,7 @@ function SelectionPanel({
             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);
-            const row = rows.find((row2) => row2.items?.includes(option));
+            const row = rows.find((row2) => row2.title === void 0 && row2.items?.includes(option));
             if (row && listRef.current) {
               listRef.current.scrollTop = Math.max(0, row.top - maxHeight / 2);
               setScrollTop(listRef.current.scrollTop);
@@ -4125,7 +4162,7 @@ function SelectionPanel({
           {
             className: row.title !== void 0 ? "sia-selection-panel__group" : "sia-selection-panel__row",
             style: { position: "absolute", top: row.top, height: row.height, width: "100%", gridTemplateColumns: `repeat(${count}, minmax(0, 1fr))` },
-            children: row.title ?? row.items?.map((option, index) => option.optionType === "divider" ? /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("div", { role: "separator", className: "sia-selection-panel__divider" }, `divider-${index}`) : /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(Tooltip, { title: option.disabled ? option.disabledTip : void 0, placement: "right", children: /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+            children: row.title !== void 0 ? groupHeading(row.title, row.items ?? []) : row.items?.map((option, index) => option.optionType === "divider" ? /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("div", { role: "separator", className: "sia-selection-panel__divider" }, `divider-${index}`) : /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(Tooltip, { title: option.disabled ? option.disabledTip : void 0, placement: "right", children: /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
               "div",
               {
                 role: "option",
@@ -4142,10 +4179,16 @@ function SelectionPanel({
                   if (!event.target.closest(".sia-checkbox")) toggle(option);
                 },
                 children: multiple ? /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(Checkbox2, { checked: selected.has(option.value), disabled: disabled || loading || option.disabled, tabIndex: -1, onChange: () => toggle(option), children: /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("span", { className: "sia-selection-panel__text", children: [
-                  /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("span", { className: "sia-selection-panel__label", children: showValue || displayField === "label" ? option.label : String(option.value) }),
+                  /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("span", { className: "sia-selection-panel__label", children: [
+                    showValue || displayField === "label" ? option.label : String(option.value),
+                    help(option)
+                  ] }),
                   showValue && /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("small", { children: String(option.value) })
                 ] }) }) : /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("span", { className: "sia-selection-panel__text", children: [
-                  /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("span", { className: "sia-selection-panel__label", children: showValue || displayField === "label" ? option.label : String(option.value) }),
+                  /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("span", { className: "sia-selection-panel__label", children: [
+                    showValue || displayField === "label" ? option.label : String(option.value),
+                    help(option)
+                  ] }),
                   showValue && /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("small", { children: String(option.value) })
                 ] })
               }
@@ -4666,6 +4709,7 @@ var Select = (0, import_react21.forwardRef)(function Select2({
               value: modalValues,
               onChange: setModalValues,
               multiple,
+              groupCheckable: modalConfig?.groupCheckable,
               allowDeselect: allowClear,
               selectedOnly,
               showValue,
@@ -11647,6 +11691,8 @@ var InputNumber = (0, import_react44.forwardRef)(function InputNumber2({
   max,
   step = 1,
   precision,
+  formatter,
+  parser,
   size: sizeProp,
   status = "default",
   prefix,
@@ -11667,10 +11713,14 @@ var InputNumber = (0, import_react44.forwardRef)(function InputNumber2({
   const inputId = id ?? fallbackId;
   const localRef = (0, import_react44.useRef)(null);
   const [currentValue, setCurrentValue] = useControllableState({ value, defaultValue, onChange });
-  const [text, setText] = (0, import_react44.useState)(() => formatValue(currentValue, precision));
+  const displayValue = (next) => {
+    const plain = formatValue(next, precision);
+    return plain && formatter ? formatter(plain) : plain;
+  };
+  const [text, setText] = (0, import_react44.useState)(() => displayValue(currentValue));
   (0, import_react44.useEffect)(() => {
-    setText(formatValue(currentValue, precision));
-  }, [currentValue, precision]);
+    setText(displayValue(currentValue));
+  }, [currentValue, precision, formatter]);
   function setRef(node) {
     localRef.current = node;
     if (typeof forwardedRef === "function") forwardedRef(node);
@@ -11689,19 +11739,33 @@ var InputNumber = (0, import_react44.forwardRef)(function InputNumber2({
       setCurrentValue(null);
       return;
     }
-    const parsed = Number(rawText);
+    let parsed;
+    try {
+      const value2 = parser ? parser(rawText) : rawText;
+      if (typeof value2 === "string" && value2.trim() === "") {
+        setText("");
+        setCurrentValue(null);
+        return;
+      }
+      parsed = Number(value2);
+    } catch {
+      setText(displayValue(currentValue));
+      return;
+    }
     if (!Number.isFinite(parsed)) {
-      setText(formatValue(currentValue, precision));
+      setText(displayValue(currentValue));
       return;
     }
     const nextValue = normalize(parsed);
-    setText(formatValue(nextValue, precision));
+    setText(displayValue(nextValue));
     setCurrentValue(nextValue);
   }
   function changeBy(direction) {
     if (disabled || readOnly) return;
     const baseValue = currentValue ?? 0;
-    commit(String(baseValue + step * direction));
+    const nextValue = normalize(baseValue + step * direction);
+    setText(displayValue(nextValue));
+    setCurrentValue(nextValue);
     localRef.current?.focus();
   }
   function handleBlur(event) {
@@ -11826,6 +11890,7 @@ function SelectModalBody({ config, values, disabled, onChange }) {
         value: values,
         onChange,
         multiple,
+        groupCheckable: config.groupCheckable,
         disabled,
         selectedOnly,
         showValue: config.showValue,
@@ -11851,7 +11916,7 @@ function openSelectModal(config) {
     } });
   }
   function modalConfig() {
-    const { options, value, mode, showValue, columns, maxHeight, headerExtra, extraValues, searchPlaceholder, filterOption, onSearch, onConfirm, ...modal } = current;
+    const { options, value, mode, groupCheckable, showValue, columns, maxHeight, headerExtra, extraValues, searchPlaceholder, filterOption, onSearch, onConfirm, ...modal } = current;
     return {
       ...modal,
       title: current.title ?? "\u8BF7\u9009\u62E9",
@@ -24440,6 +24505,13 @@ function mergeQueryFields(saved, active) {
   const current = new Set(active.map((item) => item.key));
   return [...active, ...saved.filter((item) => !current.has(item.key))];
 }
+function countQueryFieldRows(centers) {
+  const rows = [];
+  for (const top of centers) {
+    if (!rows.some((value) => Math.abs(value - top) <= 0.5)) rows.push(top);
+  }
+  return rows.length;
+}
 
 // src/components/QueryFormSettings.tsx
 var import_jsx_runtime92 = require("react/jsx-runtime");
@@ -24607,6 +24679,7 @@ var import_jsx_runtime93 = require("react/jsx-runtime");
 function QueryForm({
   fields,
   settings,
+  showSettings,
   children,
   form: providedForm,
   onSearch,
@@ -24681,6 +24754,7 @@ function QueryForm({
   const actionsRef = (0, import_react97.useRef)(null);
   const toggleRef = (0, import_react97.useRef)(null);
   const [fittingCount, setFittingCount] = (0, import_react97.useState)(limit);
+  const [settingsRows, setSettingsRows] = (0, import_react97.useState)(0);
   (0, import_react97.useLayoutEffect)(() => {
     const row = rowRef.current;
     const actions = actionsRef.current;
@@ -24688,6 +24762,21 @@ function QueryForm({
     function measure() {
       if (!row || !actions) return;
       const gap = parseFloat(getComputedStyle(row).columnGap) || 0;
+      const sourceFields = Array.from(row.querySelectorAll(":scope > .sia-query-form__field"));
+      const sourceHidden = sourceFields.map((field) => field.hidden);
+      const sourceCollapsed = row.classList.contains("is-collapsed");
+      row.classList.remove("is-collapsed");
+      sourceFields.forEach((field) => {
+        field.hidden = false;
+      });
+      if (row.clientWidth > 0) setSettingsRows(countQueryFieldRows(sourceFields.map((field) => {
+        const rect = field.getBoundingClientRect();
+        return rect.top + rect.height / 2;
+      })));
+      sourceFields.forEach((field, index) => {
+        field.hidden = sourceHidden[index];
+      });
+      row.classList.toggle("is-collapsed", sourceCollapsed);
       const allFields = Array.from(
         row.querySelectorAll(":scope > .sia-query-form__field:not([data-settings-hidden])")
       );
@@ -24914,7 +25003,7 @@ function QueryForm({
                         children: saveText
                       }
                     ) : null,
-                    cloudSettings.control
+                    showSettings ?? settingsRows > 2 ? cloudSettings.control : null
                   ] }),
                   collapsible && entries.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime93.jsx)("span", { ref: toggleRef, hidden: !needsCollapse, children: /* @__PURE__ */ (0, import_jsx_runtime93.jsx)(
                     Button,

package/dist/index.d.cts

@@ -1,11 +1,11 @@
-import { T as TagStatus, B as BadgeProps } from './core-DV-4tf3K.cjs';
-export { a as Badge, b as BadgeRibbonProps, c as BadgeStatus, d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, C as Calendar, g as CalendarProps, h as Card, i as CardAccent, j as CardProps, k as Carousel, l as CarouselProps, m as CarouselRef, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, D as Dropdown, r as DropdownButtonProps, s as DropdownMenuProps, t as DropdownOpenSource, u as DropdownPlacement, v as DropdownProps, w as DropdownTrigger, F as FILLED_ICON_NAMES, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, H as FloatingPlacement, I as FloatingTrigger, J as ICON_NAMES, K as Icon, L as IconName, M as IconProps, N as IconVariant, O as Image, P as ImagePreview, Q as ImagePreviewConfig, R as ImagePreviewProps, S as ImageProps, U as Input, V as InputProps, W as Menu, X as MenuClickInfo, Y as MenuItem, Z as MenuMode, _ as MenuProps, $ as MenuTheme, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, a4 as NotificationConfig, a5 as NotificationPlacement, a6 as NotificationType, a7 as Popconfirm, a8 as PopconfirmProps, a9 as Popover, aa as PopoverProps, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ae as Rate, af as RateProps, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, ak as Spin, al as SpinProps, am as StepItem, an as StepStatus, ao as Steps, ap as StepsProps, aq as TabItem, ar as Tabs, as as TabsContextMenuClickInfo, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagSize, aA as TagVariant, aB as Timeline, aC as TimelineItem, aD as TimelineProps, aE as Toolbar, aF as ToolbarItem, aG as ToolbarProps, aH as Tooltip, aI as TooltipProps, aJ as Tour, aK as TourProps, aL as TourStep, aM as Tree, aN as TreeDropPosition, aO as TreeKey, aP as TreeNode, aQ as TreeProps, aR as Typography, aS as TypographyLinkProps, aT as TypographyProps, aU as TypographyTitleProps, aV as TypographyType, aW as Upload, aX as UploadChangeInfo, aY as UploadDraggerProps, aZ as UploadFile, a_ as UploadFileStatus, a$ as UploadHttpRequest, b0 as UploadItemActions, b1 as UploadProps, b2 as UploadRef, b3 as UploadRejectInfo, b4 as UploadRequestHandle, b5 as UploadRequestOptions, b6 as Watermark, b7 as WatermarkFont, b8 as WatermarkProps, b9 as message, ba as notification } from './core-DV-4tf3K.cjs';
+import { T as TagStatus, B as BadgeProps } from './core-CkK9RRi0.cjs';
+export { a as Badge, b as BadgeRibbonProps, c as BadgeStatus, d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, C as Calendar, g as CalendarProps, h as Card, i as CardAccent, j as CardProps, k as Carousel, l as CarouselProps, m as CarouselRef, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, D as Dropdown, r as DropdownButtonProps, s as DropdownMenuProps, t as DropdownOpenSource, u as DropdownPlacement, v as DropdownProps, w as DropdownTrigger, F as FILLED_ICON_NAMES, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, H as FloatingPlacement, I as FloatingTrigger, J as ICON_NAMES, K as Icon, L as IconName, M as IconProps, N as IconVariant, O as Image, P as ImagePreview, Q as ImagePreviewConfig, R as ImagePreviewProps, S as ImageProps, U as Input, V as InputProps, W as Menu, X as MenuClickInfo, Y as MenuItem, Z as MenuMode, _ as MenuProps, $ as MenuTheme, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, a4 as NotificationConfig, a5 as NotificationPlacement, a6 as NotificationType, a7 as Popconfirm, a8 as PopconfirmProps, a9 as Popover, aa as PopoverProps, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ae as Rate, af as RateProps, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, ak as Spin, al as SpinProps, am as StepItem, an as StepStatus, ao as Steps, ap as StepsProps, aq as TabItem, ar as Tabs, as as TabsContextMenuClickInfo, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagSize, aA as TagVariant, aB as Timeline, aC as TimelineItem, aD as TimelineProps, aE as Toolbar, aF as ToolbarItem, aG as ToolbarProps, aH as Tooltip, aI as TooltipProps, aJ as Tour, aK as TourProps, aL as TourStep, aM as Tree, aN as TreeDropPosition, aO as TreeKey, aP as TreeNode, aQ as TreeProps, aR as Typography, aS as TypographyLinkProps, aT as TypographyProps, aU as TypographyTitleProps, aV as TypographyType, aW as Upload, aX as UploadChangeInfo, aY as UploadDraggerProps, aZ as UploadFile, a_ as UploadFileStatus, a$ as UploadHttpRequest, b0 as UploadItemActions, b1 as UploadProps, b2 as UploadRef, b3 as UploadRejectInfo, b4 as UploadRequestHandle, b5 as UploadRequestOptions, b6 as Watermark, b7 as WatermarkFont, b8 as WatermarkProps, b9 as message, ba as notification } from './core-CkK9RRi0.cjs';
 import * as react from 'react';
 import { HTMLAttributes, ReactNode, CSSProperties, ElementType, FormHTMLAttributes, InputHTMLAttributes, ChangeEvent, TextareaHTMLAttributes, MouseEvent, Key, PointerEvent, Ref, ReactElement, ButtonHTMLAttributes, RefObject } from 'react';
 import { C as ControlSize, I as InputPlaceholderMode, a as ControlStatus } from './shared-Bx4B28Wh.cjs';
-import { O as OverlayContainer, a as OverlayApiHandle, M as ModalOpenConfig, S as SelectOption, b as SelectChangeValue, c as SelectProps, d as ModalActionResult, B as ButtonProps, e as ButtonSize } from './Select-Bv2AmXRD.cjs';
-export { f as Button, g as ButtonVariant, h as Modal, i as ModalProps, j as ModalType, k as Select, l as SelectMode, m as SelectValue } from './Select-Bv2AmXRD.cjs';
-export { D as DatePicker, a as DatePickerDisabledInfo, b as DatePickerPreset, c as DatePickerProps, d as DatePickerShowTime, e as DatePickerType, f as DatePickerValue, g as DateRangePickerPreset, h as DateRangePickerProps, S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-CRWxqHFp.cjs';
+import { O as OverlayContainer, a as OverlayApiHandle, M as ModalOpenConfig, S as SelectOption, b as SelectChangeValue, c as SelectProps, d as ModalActionResult, B as ButtonProps, e as ButtonSize } from './Select-DQpfyK7I.cjs';
+export { f as Button, g as ButtonVariant, h as Modal, i as ModalProps, j as ModalType, k as Select, l as SelectMode, m as SelectValue } from './Select-DQpfyK7I.cjs';
+export { D as DatePicker, a as DatePickerDisabledInfo, b as DatePickerPreset, c as DatePickerProps, d as DatePickerShowTime, e as DatePickerType, f as DatePickerValue, g as DateRangePickerPreset, h as DateRangePickerProps, S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-BT71tp7y.cjs';
 export { RichTextContent, RichTextContentFormat, RichTextContentProps, RichTextEditor, RichTextEditorProps, RichTextImagePasteHandler, RichTextToolbar } from './rich-text-editor.cjs';
 export { MarkdownEditor, MarkdownEditorMode, MarkdownEditorProps } from './markdown-editor.cjs';
 import * as Monaco from 'monaco-editor';
@@ -1652,6 +1652,16 @@ interface InputNumberProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "
     step?: number;
     /** 固定小数位数 */
     precision?: number;
+    /**
+     * 将已提交的数值转换为显示文本，例如千分位或货币符号；输入过程中保留原始草稿，失焦、回车、步进及外部 value 更新后格式化。
+     * 参数为应用 precision 后的十进制文本，空值为空字符串；应返回显示文本，并与 parser 配套。未指定时显示普通十进制文本。
+     */
+    formatter?: (value: string) => string;
+    /**
+     * 失焦或回车时将输入文本解析为数字或数字字符串；无效值或抛出异常时恢复当前值，不触发 onChange。
+     * 空输入或解析为空字符串提交 null；未指定时使用 Number 转换。步进使用数值计算，不经过 parser。
+     */
+    parser?: (text: string) => number | string;
     /** small / medium / large 高度为 22 / 30 / 38px；默认继承 Form，组件自身 size 优先 */
     size?: ControlSize;
     /**
@@ -1683,6 +1693,9 @@ interface SelectModalConfig extends Omit<ModalOpenConfig, "children" | "footer"
     /** 单选或多选模式；single 确认时返回单值，multiple 返回数组。
      * @defaultValue "single" */
     mode?: SelectProps["mode"];
+    /** 多选时显示分组复选框，仅切换当前搜索及已选视图中该组的可用项。
+     * @defaultValue false */
+    groupCheckable?: boolean;
     /** 在选项名称下方另起一行显示 value；关闭此项仍可按 value 搜索。
      * @defaultValue false */
     showValue?: boolean;
@@ -2943,6 +2956,8 @@ interface SelectionOption {
     disabledTip?: ReactNode;
     /** 选项所属分组名称。 */
     group?: string;
+    /** 选项名称旁帮助图标的悬停说明，不参与搜索及值回填。 */
+    description?: ReactNode;
     /** 普通或按钮形态 */
     optionType?: "divider";
 }
@@ -2959,6 +2974,9 @@ interface SelectionPanelProps {
      * @defaultValue false
      */
     multiple?: boolean;
+    /** 多选时在分组标题前显示复选框，仅切换当前搜索及已选视图中该组的可用选项；保留组外、隐藏及禁用的已选值。
+     * @defaultValue false */
+    groupCheckable?: boolean;
     /** 单选时允许再次点击已选项以清空选择。 */
     allowDeselect?: boolean;
     /**
@@ -3022,7 +3040,7 @@ interface SelectionPanelProps {
     autoFocusSearch?: boolean;
 }
 /** 可嵌入下拉或弹窗的分组选择面板，长列表按行虚拟化。 */
-declare function SelectionPanel({ options, value, onChange, multiple, allowDeselect, disabled, loading, showSearch, showActions, includeUnknownValues, searchValue, onSearch, selectedOnly, showValue, displayField, columns, maxHeight, autoFocusSearch }: SelectionPanelProps): react.JSX.Element;
+declare function SelectionPanel({ options, value, onChange, multiple, allowDeselect, disabled, loading, showSearch, showActions, includeUnknownValues, searchValue, onSearch, selectedOnly, showValue, displayField, columns, maxHeight, autoFocusSearch, groupCheckable }: SelectionPanelProps): react.JSX.Element;
 
 /** 输入选择组合控件的属性配置。 */
 interface InputSelectProps {
@@ -3152,8 +3170,14 @@ interface QueryFormSearchInfo {
 interface QueryFormProps<T extends FormValues = FormValues> extends Omit<FormProps, "onFinish" | "children" | "onError"> {
     /** 查询字段配置，每项包含稳定 key、可选宽度以及 Form.Item 属性；提供后优先于 children。 */
     fields?: readonly QueryFormField[];
-    /** 云设置入口，在查询操作按钮组末尾显示竖向三点图标；复用表格 adapter 和 scope，读写共用快照的 queryForm 属性。未提供时不显示入口。隐藏字段保留挂载和值；children 模式需提供稳定 React key。 */
+    /** 云设置入口，在查询操作按钮组末尾显示竖向三点图标；复用表格 adapter 和 scope，读写共用快照的 queryForm 属性。未提供时不显示入口；入口显隐由 showSettings 控制。隐藏字段保留挂载和值；children 模式需提供稳定 React key。 */
     settings?: QueryFormSettingsConfig;
+    /**
+     * 是否显示查询设置入口，需同时提供 settings。true 始终显示，false 始终隐藏；未指定时，全部条件在当前宽度下展开超过两行才显示。
+     * 行数不包含操作按钮和快捷查询；按未隐藏条件前的完整字段测量，收起或保存字段显隐后仍可恢复设置。
+     * @defaultValue undefined
+     */
+    showSettings?: boolean;
     /** 也可直接放入 Form.Item 或 Space.Compact，每个直接子项视为一个查询字段。 */
     children?: ReactNode;
     /** 表单校验通过后执行查询。values 是完整条件；info.source 区分 submit（查询）、reset（重置）、quick（顶部预设）和 saved（已保存条件）。返回 Promise 时自动显示加载状态并阻止重复提交。 */
@@ -3242,7 +3266,7 @@ interface QueryFormProps<T extends FormValues = FormValues> extends Omit<FormPro
     actionsExtra?: ReactNode;
 }
 /** 可复用的业务查询表单；快捷查询的存储和结果数据由业务方管理。 */
-declare function QueryForm<T extends FormValues = FormValues>({ fields, settings, children, form: providedForm, onSearch, loading, fieldWidth, collapsible, collapsed: controlledCollapsed, defaultCollapsed, collapsedCount, onCollapsedChange, quickQueries, quickQuerySize, savedQueries, shortcutsLoading, onSaveQuery, onRemoveQuery, onError, searchText, resetText, saveText, resetSearch, actionsExtra, disabled, className, placeholderMode, onValuesChange, onFinishFailed, ...formProps }: QueryFormProps<T>): react.JSX.Element;
+declare function QueryForm<T extends FormValues = FormValues>({ fields, settings, showSettings, children, form: providedForm, onSearch, loading, fieldWidth, collapsible, collapsed: controlledCollapsed, defaultCollapsed, collapsedCount, onCollapsedChange, quickQueries, quickQuerySize, savedQueries, shortcutsLoading, onSaveQuery, onRemoveQuery, onError, searchText, resetText, saveText, resetSearch, actionsExtra, disabled, className, placeholderMode, onValuesChange, onFinishFailed, ...formProps }: QueryFormProps<T>): react.JSX.Element;
 
 /** 数字区间，依次为下限和上限；null 表示该端未填写，0 是有效数值。 */
 type NumberRangeValue = [number | null, number | null];

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-import { T as TagStatus, B as BadgeProps } from './core-DBfzPqVR.js';
-export { a as Badge, b as BadgeRibbonProps, c as BadgeStatus, d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, C as Calendar, g as CalendarProps, h as Card, i as CardAccent, j as CardProps, k as Carousel, l as CarouselProps, m as CarouselRef, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, D as Dropdown, r as DropdownButtonProps, s as DropdownMenuProps, t as DropdownOpenSource, u as DropdownPlacement, v as DropdownProps, w as DropdownTrigger, F as FILLED_ICON_NAMES, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, H as FloatingPlacement, I as FloatingTrigger, J as ICON_NAMES, K as Icon, L as IconName, M as IconProps, N as IconVariant, O as Image, P as ImagePreview, Q as ImagePreviewConfig, R as ImagePreviewProps, S as ImageProps, U as Input, V as InputProps, W as Menu, X as MenuClickInfo, Y as MenuItem, Z as MenuMode, _ as MenuProps, $ as MenuTheme, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, a4 as NotificationConfig, a5 as NotificationPlacement, a6 as NotificationType, a7 as Popconfirm, a8 as PopconfirmProps, a9 as Popover, aa as PopoverProps, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ae as Rate, af as RateProps, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, ak as Spin, al as SpinProps, am as StepItem, an as StepStatus, ao as Steps, ap as StepsProps, aq as TabItem, ar as Tabs, as as TabsContextMenuClickInfo, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagSize, aA as TagVariant, aB as Timeline, aC as TimelineItem, aD as TimelineProps, aE as Toolbar, aF as ToolbarItem, aG as ToolbarProps, aH as Tooltip, aI as TooltipProps, aJ as Tour, aK as TourProps, aL as TourStep, aM as Tree, aN as TreeDropPosition, aO as TreeKey, aP as TreeNode, aQ as TreeProps, aR as Typography, aS as TypographyLinkProps, aT as TypographyProps, aU as TypographyTitleProps, aV as TypographyType, aW as Upload, aX as UploadChangeInfo, aY as UploadDraggerProps, aZ as UploadFile, a_ as UploadFileStatus, a$ as UploadHttpRequest, b0 as UploadItemActions, b1 as UploadProps, b2 as UploadRef, b3 as UploadRejectInfo, b4 as UploadRequestHandle, b5 as UploadRequestOptions, b6 as Watermark, b7 as WatermarkFont, b8 as WatermarkProps, b9 as message, ba as notification } from './core-DBfzPqVR.js';
+import { T as TagStatus, B as BadgeProps } from './core-uAx1caJB.js';
+export { a as Badge, b as BadgeRibbonProps, c as BadgeStatus, d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, C as Calendar, g as CalendarProps, h as Card, i as CardAccent, j as CardProps, k as Carousel, l as CarouselProps, m as CarouselRef, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, D as Dropdown, r as DropdownButtonProps, s as DropdownMenuProps, t as DropdownOpenSource, u as DropdownPlacement, v as DropdownProps, w as DropdownTrigger, F as FILLED_ICON_NAMES, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, H as FloatingPlacement, I as FloatingTrigger, J as ICON_NAMES, K as Icon, L as IconName, M as IconProps, N as IconVariant, O as Image, P as ImagePreview, Q as ImagePreviewConfig, R as ImagePreviewProps, S as ImageProps, U as Input, V as InputProps, W as Menu, X as MenuClickInfo, Y as MenuItem, Z as MenuMode, _ as MenuProps, $ as MenuTheme, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, a4 as NotificationConfig, a5 as NotificationPlacement, a6 as NotificationType, a7 as Popconfirm, a8 as PopconfirmProps, a9 as Popover, aa as PopoverProps, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ae as Rate, af as RateProps, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, ak as Spin, al as SpinProps, am as StepItem, an as StepStatus, ao as Steps, ap as StepsProps, aq as TabItem, ar as Tabs, as as TabsContextMenuClickInfo, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagSize, aA as TagVariant, aB as Timeline, aC as TimelineItem, aD as TimelineProps, aE as Toolbar, aF as ToolbarItem, aG as ToolbarProps, aH as Tooltip, aI as TooltipProps, aJ as Tour, aK as TourProps, aL as TourStep, aM as Tree, aN as TreeDropPosition, aO as TreeKey, aP as TreeNode, aQ as TreeProps, aR as Typography, aS as TypographyLinkProps, aT as TypographyProps, aU as TypographyTitleProps, aV as TypographyType, aW as Upload, aX as UploadChangeInfo, aY as UploadDraggerProps, aZ as UploadFile, a_ as UploadFileStatus, a$ as UploadHttpRequest, b0 as UploadItemActions, b1 as UploadProps, b2 as UploadRef, b3 as UploadRejectInfo, b4 as UploadRequestHandle, b5 as UploadRequestOptions, b6 as Watermark, b7 as WatermarkFont, b8 as WatermarkProps, b9 as message, ba as notification } from './core-uAx1caJB.js';
 import * as react from 'react';
 import { HTMLAttributes, ReactNode, CSSProperties, ElementType, FormHTMLAttributes, InputHTMLAttributes, ChangeEvent, TextareaHTMLAttributes, MouseEvent, Key, PointerEvent, Ref, ReactElement, ButtonHTMLAttributes, RefObject } from 'react';
 import { C as ControlSize, I as InputPlaceholderMode, a as ControlStatus } from './shared-Bx4B28Wh.js';
-import { O as OverlayContainer, a as OverlayApiHandle, M as ModalOpenConfig, S as SelectOption, b as SelectChangeValue, c as SelectProps, d as ModalActionResult, B as ButtonProps, e as ButtonSize } from './Select-Cc1owuvN.js';
-export { f as Button, g as ButtonVariant, h as Modal, i as ModalProps, j as ModalType, k as Select, l as SelectMode, m as SelectValue } from './Select-Cc1owuvN.js';
-export { D as DatePicker, a as DatePickerDisabledInfo, b as DatePickerPreset, c as DatePickerProps, d as DatePickerShowTime, e as DatePickerType, f as DatePickerValue, g as DateRangePickerPreset, h as DateRangePickerProps, S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-rtYL9egr.js';
+import { O as OverlayContainer, a as OverlayApiHandle, M as ModalOpenConfig, S as SelectOption, b as SelectChangeValue, c as SelectProps, d as ModalActionResult, B as ButtonProps, e as ButtonSize } from './Select-DmT9pFRW.js';
+export { f as Button, g as ButtonVariant, h as Modal, i as ModalProps, j as ModalType, k as Select, l as SelectMode, m as SelectValue } from './Select-DmT9pFRW.js';
+export { D as DatePicker, a as DatePickerDisabledInfo, b as DatePickerPreset, c as DatePickerProps, d as DatePickerShowTime, e as DatePickerType, f as DatePickerValue, g as DateRangePickerPreset, h as DateRangePickerProps, S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-CFGzoyLs.js';
 export { RichTextContent, RichTextContentFormat, RichTextContentProps, RichTextEditor, RichTextEditorProps, RichTextImagePasteHandler, RichTextToolbar } from './rich-text-editor.js';
 export { MarkdownEditor, MarkdownEditorMode, MarkdownEditorProps } from './markdown-editor.js';
 import * as Monaco from 'monaco-editor';
@@ -1652,6 +1652,16 @@ interface InputNumberProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "
     step?: number;
     /** 固定小数位数 */
     precision?: number;
+    /**
+     * 将已提交的数值转换为显示文本，例如千分位或货币符号；输入过程中保留原始草稿，失焦、回车、步进及外部 value 更新后格式化。
+     * 参数为应用 precision 后的十进制文本，空值为空字符串；应返回显示文本，并与 parser 配套。未指定时显示普通十进制文本。
+     */
+    formatter?: (value: string) => string;
+    /**
+     * 失焦或回车时将输入文本解析为数字或数字字符串；无效值或抛出异常时恢复当前值，不触发 onChange。
+     * 空输入或解析为空字符串提交 null；未指定时使用 Number 转换。步进使用数值计算，不经过 parser。
+     */
+    parser?: (text: string) => number | string;
     /** small / medium / large 高度为 22 / 30 / 38px；默认继承 Form，组件自身 size 优先 */
     size?: ControlSize;
     /**
@@ -1683,6 +1693,9 @@ interface SelectModalConfig extends Omit<ModalOpenConfig, "children" | "footer"
     /** 单选或多选模式；single 确认时返回单值，multiple 返回数组。
      * @defaultValue "single" */
     mode?: SelectProps["mode"];
+    /** 多选时显示分组复选框，仅切换当前搜索及已选视图中该组的可用项。
+     * @defaultValue false */
+    groupCheckable?: boolean;
     /** 在选项名称下方另起一行显示 value；关闭此项仍可按 value 搜索。
      * @defaultValue false */
     showValue?: boolean;
@@ -2943,6 +2956,8 @@ interface SelectionOption {
     disabledTip?: ReactNode;
     /** 选项所属分组名称。 */
     group?: string;
+    /** 选项名称旁帮助图标的悬停说明，不参与搜索及值回填。 */
+    description?: ReactNode;
     /** 普通或按钮形态 */
     optionType?: "divider";
 }
@@ -2959,6 +2974,9 @@ interface SelectionPanelProps {
      * @defaultValue false
      */
     multiple?: boolean;
+    /** 多选时在分组标题前显示复选框，仅切换当前搜索及已选视图中该组的可用选项；保留组外、隐藏及禁用的已选值。
+     * @defaultValue false */
+    groupCheckable?: boolean;
     /** 单选时允许再次点击已选项以清空选择。 */
     allowDeselect?: boolean;
     /**
@@ -3022,7 +3040,7 @@ interface SelectionPanelProps {
     autoFocusSearch?: boolean;
 }
 /** 可嵌入下拉或弹窗的分组选择面板，长列表按行虚拟化。 */
-declare function SelectionPanel({ options, value, onChange, multiple, allowDeselect, disabled, loading, showSearch, showActions, includeUnknownValues, searchValue, onSearch, selectedOnly, showValue, displayField, columns, maxHeight, autoFocusSearch }: SelectionPanelProps): react.JSX.Element;
+declare function SelectionPanel({ options, value, onChange, multiple, allowDeselect, disabled, loading, showSearch, showActions, includeUnknownValues, searchValue, onSearch, selectedOnly, showValue, displayField, columns, maxHeight, autoFocusSearch, groupCheckable }: SelectionPanelProps): react.JSX.Element;
 
 /** 输入选择组合控件的属性配置。 */
 interface InputSelectProps {
@@ -3152,8 +3170,14 @@ interface QueryFormSearchInfo {
 interface QueryFormProps<T extends FormValues = FormValues> extends Omit<FormProps, "onFinish" | "children" | "onError"> {
     /** 查询字段配置，每项包含稳定 key、可选宽度以及 Form.Item 属性；提供后优先于 children。 */
     fields?: readonly QueryFormField[];
-    /** 云设置入口，在查询操作按钮组末尾显示竖向三点图标；复用表格 adapter 和 scope，读写共用快照的 queryForm 属性。未提供时不显示入口。隐藏字段保留挂载和值；children 模式需提供稳定 React key。 */
+    /** 云设置入口，在查询操作按钮组末尾显示竖向三点图标；复用表格 adapter 和 scope，读写共用快照的 queryForm 属性。未提供时不显示入口；入口显隐由 showSettings 控制。隐藏字段保留挂载和值；children 模式需提供稳定 React key。 */
     settings?: QueryFormSettingsConfig;
+    /**
+     * 是否显示查询设置入口，需同时提供 settings。true 始终显示，false 始终隐藏；未指定时，全部条件在当前宽度下展开超过两行才显示。
+     * 行数不包含操作按钮和快捷查询；按未隐藏条件前的完整字段测量，收起或保存字段显隐后仍可恢复设置。
+     * @defaultValue undefined
+     */
+    showSettings?: boolean;
     /** 也可直接放入 Form.Item 或 Space.Compact，每个直接子项视为一个查询字段。 */
     children?: ReactNode;
     /** 表单校验通过后执行查询。values 是完整条件；info.source 区分 submit（查询）、reset（重置）、quick（顶部预设）和 saved（已保存条件）。返回 Promise 时自动显示加载状态并阻止重复提交。 */
@@ -3242,7 +3266,7 @@ interface QueryFormProps<T extends FormValues = FormValues> extends Omit<FormPro
     actionsExtra?: ReactNode;
 }
 /** 可复用的业务查询表单；快捷查询的存储和结果数据由业务方管理。 */
-declare function QueryForm<T extends FormValues = FormValues>({ fields, settings, children, form: providedForm, onSearch, loading, fieldWidth, collapsible, collapsed: controlledCollapsed, defaultCollapsed, collapsedCount, onCollapsedChange, quickQueries, quickQuerySize, savedQueries, shortcutsLoading, onSaveQuery, onRemoveQuery, onError, searchText, resetText, saveText, resetSearch, actionsExtra, disabled, className, placeholderMode, onValuesChange, onFinishFailed, ...formProps }: QueryFormProps<T>): react.JSX.Element;
+declare function QueryForm<T extends FormValues = FormValues>({ fields, settings, showSettings, children, form: providedForm, onSearch, loading, fieldWidth, collapsible, collapsed: controlledCollapsed, defaultCollapsed, collapsedCount, onCollapsedChange, quickQueries, quickQuerySize, savedQueries, shortcutsLoading, onSaveQuery, onRemoveQuery, onError, searchText, resetText, saveText, resetSearch, actionsExtra, disabled, className, placeholderMode, onValuesChange, onFinishFailed, ...formProps }: QueryFormProps<T>): react.JSX.Element;
 
 /** 数字区间，依次为下限和上限；null 表示该端未填写，0 是有效数值。 */
 type NumberRangeValue = [number | null, number | null];

package/dist/index.js

@@ -80,7 +80,7 @@ import {
   Watermark,
   message,
   notification
-} from "./chunk-7MTL2KB5.js";
+} from "./chunk-FGGBNWBT.js";
 import {
   MarkdownEditor
 } from "./chunk-TUXNOSCT.js";
@@ -92,7 +92,7 @@ import {
   DatePicker,
   SelectDateRange,
   TimePanel
-} from "./chunk-3JCIEB7I.js";
+} from "./chunk-4TTHPU2S.js";
 import {
   Checkbox,
   FloatingScrollbarProvider,
@@ -104,7 +104,7 @@ import {
   Tooltip,
   Tree,
   useScrollbarProximity
-} from "./chunk-ZY3YKRD4.js";
+} from "./chunk-DJTV4X6L.js";
 import {
   Dropdown,
   FILLED_ICON_NAMES,
@@ -4199,6 +4199,8 @@ var InputNumber = forwardRef4(function InputNumber2({
   max,
   step = 1,
   precision,
+  formatter,
+  parser,
   size: sizeProp,
   status = "default",
   prefix,
@@ -4219,10 +4221,14 @@ var InputNumber = forwardRef4(function InputNumber2({
   const inputId = id ?? fallbackId;
   const localRef = useRef11(null);
   const [currentValue, setCurrentValue] = useControllableState({ value, defaultValue, onChange });
-  const [text, setText] = useState13(() => formatValue(currentValue, precision));
+  const displayValue = (next) => {
+    const plain = formatValue(next, precision);
+    return plain && formatter ? formatter(plain) : plain;
+  };
+  const [text, setText] = useState13(() => displayValue(currentValue));
   useEffect9(() => {
-    setText(formatValue(currentValue, precision));
-  }, [currentValue, precision]);
+    setText(displayValue(currentValue));
+  }, [currentValue, precision, formatter]);
   function setRef(node) {
     localRef.current = node;
     if (typeof forwardedRef === "function") forwardedRef(node);
@@ -4241,19 +4247,33 @@ var InputNumber = forwardRef4(function InputNumber2({
       setCurrentValue(null);
       return;
     }
-    const parsed = Number(rawText);
+    let parsed;
+    try {
+      const value2 = parser ? parser(rawText) : rawText;
+      if (typeof value2 === "string" && value2.trim() === "") {
+        setText("");
+        setCurrentValue(null);
+        return;
+      }
+      parsed = Number(value2);
+    } catch {
+      setText(displayValue(currentValue));
+      return;
+    }
     if (!Number.isFinite(parsed)) {
-      setText(formatValue(currentValue, precision));
+      setText(displayValue(currentValue));
       return;
     }
     const nextValue = normalize(parsed);
-    setText(formatValue(nextValue, precision));
+    setText(displayValue(nextValue));
     setCurrentValue(nextValue);
   }
   function changeBy(direction) {
     if (disabled || readOnly) return;
     const baseValue = currentValue ?? 0;
-    commit(String(baseValue + step * direction));
+    const nextValue = normalize(baseValue + step * direction);
+    setText(displayValue(nextValue));
+    setCurrentValue(nextValue);
     localRef.current?.focus();
   }
   function handleBlur(event) {
@@ -4378,6 +4398,7 @@ function SelectModalBody({ config, values, disabled, onChange }) {
         value: values,
         onChange,
         multiple,
+        groupCheckable: config.groupCheckable,
         disabled,
         selectedOnly,
         showValue: config.showValue,
@@ -4403,7 +4424,7 @@ function openSelectModal(config) {
     } });
   }
   function modalConfig() {
-    const { options, value, mode, showValue, columns, maxHeight, headerExtra, extraValues, searchPlaceholder, filterOption, onSearch, onConfirm, ...modal } = current;
+    const { options, value, mode, groupCheckable, showValue, columns, maxHeight, headerExtra, extraValues, searchPlaceholder, filterOption, onSearch, onConfirm, ...modal } = current;
     return {
       ...modal,
       title: current.title ?? "\u8BF7\u9009\u62E9",
@@ -9092,6 +9113,13 @@ function mergeQueryFields(saved, active) {
   const current = new Set(active.map((item) => item.key));
   return [...active, ...saved.filter((item) => !current.has(item.key))];
 }
+function countQueryFieldRows(centers) {
+  const rows = [];
+  for (const top of centers) {
+    if (!rows.some((value) => Math.abs(value - top) <= 0.5)) rows.push(top);
+  }
+  return rows.length;
+}
 
 // src/components/QueryFormSettings.tsx
 import { Fragment as Fragment9, jsx as jsx26, jsxs as jsxs24 } from "react/jsx-runtime";
@@ -9259,6 +9287,7 @@ import { jsx as jsx27, jsxs as jsxs25 } from "react/jsx-runtime";
 function QueryForm({
   fields,
   settings,
+  showSettings,
   children,
   form: providedForm,
   onSearch,
@@ -9333,6 +9362,7 @@ function QueryForm({
   const actionsRef = useRef20(null);
   const toggleRef = useRef20(null);
   const [fittingCount, setFittingCount] = useState23(limit);
+  const [settingsRows, setSettingsRows] = useState23(0);
   useLayoutEffect6(() => {
     const row = rowRef.current;
     const actions = actionsRef.current;
@@ -9340,6 +9370,21 @@ function QueryForm({
     function measure() {
       if (!row || !actions) return;
       const gap = parseFloat(getComputedStyle(row).columnGap) || 0;
+      const sourceFields = Array.from(row.querySelectorAll(":scope > .sia-query-form__field"));
+      const sourceHidden = sourceFields.map((field) => field.hidden);
+      const sourceCollapsed = row.classList.contains("is-collapsed");
+      row.classList.remove("is-collapsed");
+      sourceFields.forEach((field) => {
+        field.hidden = false;
+      });
+      if (row.clientWidth > 0) setSettingsRows(countQueryFieldRows(sourceFields.map((field) => {
+        const rect = field.getBoundingClientRect();
+        return rect.top + rect.height / 2;
+      })));
+      sourceFields.forEach((field, index) => {
+        field.hidden = sourceHidden[index];
+      });
+      row.classList.toggle("is-collapsed", sourceCollapsed);
       const allFields = Array.from(
         row.querySelectorAll(":scope > .sia-query-form__field:not([data-settings-hidden])")
       );
@@ -9566,7 +9611,7 @@ function QueryForm({
                         children: saveText
                       }
                     ) : null,
-                    cloudSettings.control
+                    showSettings ?? settingsRows > 2 ? cloudSettings.control : null
                   ] }),
                   collapsible && entries.length > 0 ? /* @__PURE__ */ jsx27("span", { ref: toggleRef, hidden: !needsCollapse, children: /* @__PURE__ */ jsx27(
                     Button,

package/dist/{select-date-range-CRWxqHFp.d.cts → select-date-range-BT71tp7y.d.cts}

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { InputHTMLAttributes, ReactNode, HTMLAttributes, CSSProperties } from 'react';
 import { I as InputPlaceholderMode, C as ControlSize, a as ControlStatus } from './shared-Bx4B28Wh.cjs';
-import { S as SelectOption, m as SelectValue } from './Select-Bv2AmXRD.cjs';
+import { S as SelectOption, m as SelectValue } from './Select-DQpfyK7I.cjs';
 
 /** 日期选择附带的时间选择配置。 */
 type DatePickerShowTime = boolean | {

package/dist/{select-date-range-rtYL9egr.d.ts → select-date-range-CFGzoyLs.d.ts}

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { InputHTMLAttributes, ReactNode, HTMLAttributes, CSSProperties } from 'react';
 import { I as InputPlaceholderMode, C as ControlSize, a as ControlStatus } from './shared-Bx4B28Wh.js';
-import { S as SelectOption, m as SelectValue } from './Select-Cc1owuvN.js';
+import { S as SelectOption, m as SelectValue } from './Select-DmT9pFRW.js';
 
 /** 日期选择附带的时间选择配置。 */
 type DatePickerShowTime = boolean | {

package/dist/select-date-range.cjs

@@ -3623,7 +3623,8 @@ function SelectionPanel({
   displayField = "label",
   columns = 1,
   maxHeight = 250,
-  autoFocusSearch = false
+  autoFocusSearch = false,
+  groupCheckable = false
 }) {
   const [localSearch, setLocalSearch] = (0, import_react16.useState)("");
   const search = searchValue ?? localSearch;
@@ -3655,7 +3656,7 @@ function SelectionPanel({
     let top = 0;
     for (const [group, items] of groups) {
       if (group) {
-        rows2.push({ key: `group-${rows2.length}`, title: group, top, height: 30 });
+        rows2.push({ key: `group-${rows2.length}`, title: group, items, top, height: 30 });
         top += 30;
       }
       for (let index = 0; index < items.length; index += count) {
@@ -3693,6 +3694,42 @@ function SelectionPanel({
     const add = enabled.filter((option) => operation === "all" || !selected.has(option.value)).map((option) => option.value);
     onChange([...retained, ...add]);
   }
+  function groupHeading(title, items) {
+    if (!multiple || !groupCheckable) return title;
+    const editable = items.filter((option) => !option.disabled && option.optionType !== "divider");
+    const all = editable.length > 0 && editable.every((option) => selected.has(option.value));
+    return /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+      Checkbox2,
+      {
+        checked: all,
+        indeterminate: !all && editable.some((option) => selected.has(option.value)),
+        disabled: disabled || loading || !editable.length,
+        onChange: (checked) => {
+          const next = new Set(value);
+          editable.forEach((option) => checked ? next.add(option.value) : next.delete(option.value));
+          onChange([...next]);
+        },
+        children: title
+      }
+    );
+  }
+  function help(option) {
+    return option.description != null && option.description !== false ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(Tooltip, { title: option.description, children: /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+      "span",
+      {
+        role: "img",
+        "aria-label": "\u9009\u9879\u8BF4\u660E",
+        tabIndex: 0,
+        onClick: (event) => {
+          event.preventDefault();
+          event.stopPropagation();
+        },
+        onKeyDown: (event) => event.stopPropagation(),
+        style: { display: "inline-flex", marginInlineStart: 4 },
+        children: /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(Icon, { name: "help-circle", size: 14 })
+      }
+    ) }) : null;
+  }
   return /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { className: "sia-selection-panel", children: [
     /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(FloatingScrollbarProvider, { targetRef: listRef }),
     showSearch && /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
@@ -3746,7 +3783,7 @@ function SelectionPanel({
             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);
-            const row = rows.find((row2) => row2.items?.includes(option));
+            const row = rows.find((row2) => row2.title === void 0 && row2.items?.includes(option));
             if (row && listRef.current) {
               listRef.current.scrollTop = Math.max(0, row.top - maxHeight / 2);
               setScrollTop(listRef.current.scrollTop);
@@ -3761,7 +3798,7 @@ function SelectionPanel({
           {
             className: row.title !== void 0 ? "sia-selection-panel__group" : "sia-selection-panel__row",
             style: { position: "absolute", top: row.top, height: row.height, width: "100%", gridTemplateColumns: `repeat(${count}, minmax(0, 1fr))` },
-            children: row.title ?? row.items?.map((option, index) => option.optionType === "divider" ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("div", { role: "separator", className: "sia-selection-panel__divider" }, `divider-${index}`) : /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(Tooltip, { title: option.disabled ? option.disabledTip : void 0, placement: "right", children: /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+            children: row.title !== void 0 ? groupHeading(row.title, row.items ?? []) : row.items?.map((option, index) => option.optionType === "divider" ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("div", { role: "separator", className: "sia-selection-panel__divider" }, `divider-${index}`) : /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(Tooltip, { title: option.disabled ? option.disabledTip : void 0, placement: "right", children: /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
               "div",
               {
                 role: "option",
@@ -3778,10 +3815,16 @@ function SelectionPanel({
                   if (!event.target.closest(".sia-checkbox")) toggle(option);
                 },
                 children: multiple ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(Checkbox2, { checked: selected.has(option.value), disabled: disabled || loading || option.disabled, tabIndex: -1, onChange: () => toggle(option), children: /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("span", { className: "sia-selection-panel__text", children: [
-                  /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { className: "sia-selection-panel__label", children: showValue || displayField === "label" ? option.label : String(option.value) }),
+                  /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("span", { className: "sia-selection-panel__label", children: [
+                    showValue || displayField === "label" ? option.label : String(option.value),
+                    help(option)
+                  ] }),
                   showValue && /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("small", { children: String(option.value) })
                 ] }) }) : /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("span", { className: "sia-selection-panel__text", children: [
-                  /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { className: "sia-selection-panel__label", children: showValue || displayField === "label" ? option.label : String(option.value) }),
+                  /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("span", { className: "sia-selection-panel__label", children: [
+                    showValue || displayField === "label" ? option.label : String(option.value),
+                    help(option)
+                  ] }),
                   showValue && /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("small", { children: String(option.value) })
                 ] })
               }
@@ -4302,6 +4345,7 @@ var Select = (0, import_react18.forwardRef)(function Select2({
               value: modalValues,
               onChange: setModalValues,
               multiple,
+              groupCheckable: modalConfig?.groupCheckable,
               allowDeselect: allowClear,
               selectedOnly,
               showValue,

package/dist/select-date-range.d.cts

@@ -1,4 +1,4 @@
-export { S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-CRWxqHFp.cjs';
+export { S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-BT71tp7y.cjs';
 import 'react';
 import './shared-Bx4B28Wh.cjs';
-import './Select-Bv2AmXRD.cjs';
+import './Select-DQpfyK7I.cjs';

package/dist/select-date-range.d.ts

@@ -1,4 +1,4 @@
-export { S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-rtYL9egr.js';
+export { S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-CFGzoyLs.js';
 import 'react';
 import './shared-Bx4B28Wh.js';
-import './Select-Cc1owuvN.js';
+import './Select-DmT9pFRW.js';

package/dist/select-date-range.js

@@ -1,7 +1,7 @@
 import {
   SelectDateRange
-} from "./chunk-3JCIEB7I.js";
-import "./chunk-ZY3YKRD4.js";
+} from "./chunk-4TTHPU2S.js";
+import "./chunk-DJTV4X6L.js";
 import "./chunk-X5BFQUFX.js";
 import "./chunk-SJFT5OSX.js";
 import "./chunk-PUZWLIIJ.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sia.soul/sia-react-ui",
-  "version": "0.1.92",
+  "version": "0.1.95",
   "description": "Sia Design components and tokens for React",
   "publishConfig": {
     "access": "public",