@sia.soul/sia-react-ui 0.1.91 → 0.1.94

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-GLXGN5SO.js → chunk-4TTHPU2S.js}

@@ -1,10 +1,10 @@
 import {
   FloatingScrollbarProvider,
   Select
-} from "./chunk-7BJPQCRG.js";
+} from "./chunk-DJTV4X6L.js";
 import {
   Icon
-} from "./chunk-G5K72R4O.js";
+} from "./chunk-X5BFQUFX.js";
 import {
   PopupPortal,
   useControlSize,

package/dist/{chunk-7BJPQCRG.js → chunk-DJTV4X6L.js}

@@ -3,7 +3,7 @@ import {
   Icon,
   Input,
   Modal
-} from "./chunk-G5K72R4O.js";
+} from "./chunk-X5BFQUFX.js";
 import {
   Button
 } from "./chunk-SJFT5OSX.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-AG2VFAZR.js → chunk-FGGBNWBT.js}

@@ -1,12 +1,12 @@
 import {
   Popover,
   Tooltip
-} from "./chunk-7BJPQCRG.js";
+} from "./chunk-DJTV4X6L.js";
 import {
   Dropdown,
   Icon,
   useOverlayLifecycle
-} from "./chunk-G5K72R4O.js";
+} from "./chunk-X5BFQUFX.js";
 import {
   Button,
   TextArea

package/dist/{chunk-G5K72R4O.js → chunk-X5BFQUFX.js}

@@ -1351,7 +1351,8 @@ var placementMap = {
   topLeft: "top-start",
   topRight: "top-end"
 };
-function DropdownRoot({
+function DropdownInternal({
+  popupAnchorRef,
   menu,
   children,
   trigger = ["hover"],
@@ -1564,7 +1565,7 @@ function DropdownRoot({
           PopupPortal,
           {
             ref: popupRef,
-            anchorRef: contextPoint ? contextAnchorRef : rootRef,
+            anchorRef: contextPoint ? contextAnchorRef : popupAnchorRef ?? rootRef,
             open: mounted,
             placement: contextPoint ? "bottom-start" : placementMap[placement],
             offset: contextPoint ? 2 : 6,
@@ -1586,6 +1587,9 @@ function DropdownRoot({
     }
   );
 }
+function DropdownRoot(props) {
+  return /* @__PURE__ */ jsx5(DropdownInternal, { ...props });
+}
 function DropdownButton({
   children,
   className = "",
@@ -1597,9 +1601,10 @@ function DropdownButton({
   trigger = ["click"],
   ...dropdownProps
 }) {
-  return /* @__PURE__ */ jsxs4("span", { className: `sia-dropdown-button ${className}`.trim(), children: [
+  const groupRef = useRef2(null);
+  return /* @__PURE__ */ jsxs4("span", { ref: groupRef, className: `sia-dropdown-button ${className}`.trim(), children: [
     /* @__PURE__ */ jsx5(Button, { ...buttonProps, disabled: disabled || buttonDisabled, onClick, children }),
-    /* @__PURE__ */ jsx5(DropdownRoot, { ...dropdownProps, disabled: disabled || dropdownDisabled, trigger, showTriggerIcon: false, children: /* @__PURE__ */ jsx5(
+    /* @__PURE__ */ jsx5(DropdownInternal, { ...dropdownProps, popupAnchorRef: groupRef, disabled: disabled || dropdownDisabled, trigger, showTriggerIcon: false, children: /* @__PURE__ */ jsx5(
       Button,
       {
         ...buttonProps,

package/dist/{chunk-OPYA3PMD.js → chunk-YPHUBD4F.js}

@@ -2,7 +2,7 @@ import {
   Dropdown,
   Icon,
   Input
-} from "./chunk-G5K72R4O.js";
+} from "./chunk-X5BFQUFX.js";
 import {
   Button
 } from "./chunk-SJFT5OSX.js";

package/dist/{core-OIIkAeiG.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';
 
 /** 单个工具栏操作及其下拉菜单。 */
@@ -875,9 +875,15 @@ interface DropdownProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children"
         source: DropdownOpenSource;
     }) => void;
 }
-declare function DropdownRoot({ menu, children, trigger, placement, open, defaultOpen, disabled, showTriggerIcon, arrow, autoFocus, openDelay, closeDelay, popupClassName, popupStyle, popupRender, onOpenChange, className, onClick, onMouseEnter, onMouseLeave, onContextMenu, onKeyDown, ...props }: DropdownProps): react.JSX.Element;
-/** DropdownButton的属性配置。 */
+/** 普通下拉菜单使用自身触发器定位，不对外暴露组合按钮的内部锚点。 */
+declare function DropdownRoot(props: DropdownProps): react.JSX.Element;
+/** 组合下拉按钮的属性配置；菜单相对于整组按钮定位，主操作和箭头触发保持独立。 */
 interface DropdownButtonProps extends Omit<DropdownProps, "children" | "className"> {
+    /**
+     * 相对于整组按钮的弹出方向和对齐位置；默认优先与主按钮左侧对齐，视口空间不足时自动调整位置。
+     * @defaultValue "bottomLeft"
+     */
+    placement?: DropdownPlacement;
     /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
     /**

package/dist/{core-BGA9VB0L.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';
 
 /** 单个工具栏操作及其下拉菜单。 */
@@ -875,9 +875,15 @@ interface DropdownProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children"
         source: DropdownOpenSource;
     }) => void;
 }
-declare function DropdownRoot({ menu, children, trigger, placement, open, defaultOpen, disabled, showTriggerIcon, arrow, autoFocus, openDelay, closeDelay, popupClassName, popupStyle, popupRender, onOpenChange, className, onClick, onMouseEnter, onMouseLeave, onContextMenu, onKeyDown, ...props }: DropdownProps): react.JSX.Element;
-/** DropdownButton的属性配置。 */
+/** 普通下拉菜单使用自身触发器定位，不对外暴露组合按钮的内部锚点。 */
+declare function DropdownRoot(props: DropdownProps): react.JSX.Element;
+/** 组合下拉按钮的属性配置；菜单相对于整组按钮定位，主操作和箭头触发保持独立。 */
 interface DropdownButtonProps extends Omit<DropdownProps, "children" | "className"> {
+    /**
+     * 相对于整组按钮的弹出方向和对齐位置；默认优先与主按钮左侧对齐，视口空间不足时自动调整位置。
+     * @defaultValue "bottomLeft"
+     */
+    placement?: DropdownPlacement;
     /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
     /**

package/dist/core.cjs

@@ -1707,7 +1707,8 @@ var placementMap = {
   topLeft: "top-start",
   topRight: "top-end"
 };
-function DropdownRoot({
+function DropdownInternal({
+  popupAnchorRef,
   menu,
   children,
   trigger = ["hover"],
@@ -1920,7 +1921,7 @@ function DropdownRoot({
           PopupPortal,
           {
             ref: popupRef,
-            anchorRef: contextPoint ? contextAnchorRef : rootRef,
+            anchorRef: contextPoint ? contextAnchorRef : popupAnchorRef ?? rootRef,
             open: mounted,
             placement: contextPoint ? "bottom-start" : placementMap[placement],
             offset: contextPoint ? 2 : 6,
@@ -1942,6 +1943,9 @@ function DropdownRoot({
     }
   );
 }
+function DropdownRoot(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(DropdownInternal, { ...props });
+}
 function DropdownButton({
   children,
   className = "",
@@ -1953,9 +1957,10 @@ function DropdownButton({
   trigger = ["click"],
   ...dropdownProps
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("span", { className: `sia-dropdown-button ${className}`.trim(), children: [
+  const groupRef = (0, import_react8.useRef)(null);
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("span", { ref: groupRef, className: `sia-dropdown-button ${className}`.trim(), children: [
     /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Button, { ...buttonProps, disabled: disabled || buttonDisabled, onClick, children }),
-    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(DropdownRoot, { ...dropdownProps, disabled: disabled || dropdownDisabled, trigger, showTriggerIcon: false, children: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(DropdownInternal, { ...dropdownProps, popupAnchorRef: groupRef, disabled: disabled || dropdownDisabled, trigger, showTriggerIcon: false, children: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
       Button,
       {
         ...buttonProps,
@@ -3985,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;
@@ -4017,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) {
@@ -4055,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)(
@@ -4108,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);
@@ -4123,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",
@@ -4140,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) })
                 ] })
               }
@@ -4664,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-OIIkAeiG.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-BGA9VB0L.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,16 +10,16 @@ import {
   Typography,
   Upload,
   message
-} from "./chunk-AG2VFAZR.js";
+} from "./chunk-FGGBNWBT.js";
 import {
   Select
-} from "./chunk-7BJPQCRG.js";
+} from "./chunk-DJTV4X6L.js";
 import {
   Icon,
   Input,
   Modal,
   Segmented
-} from "./chunk-G5K72R4O.js";
+} from "./chunk-X5BFQUFX.js";
 import {
   Button
 } from "./chunk-SJFT5OSX.js";

package/dist/index.cjs

@@ -1877,7 +1877,8 @@ var placementMap = {
   topLeft: "top-start",
   topRight: "top-end"
 };
-function DropdownRoot({
+function DropdownInternal({
+  popupAnchorRef,
   menu,
   children,
   trigger = ["hover"],
@@ -2090,7 +2091,7 @@ function DropdownRoot({
           PopupPortal,
           {
             ref: popupRef,
-            anchorRef: contextPoint ? contextAnchorRef : rootRef,
+            anchorRef: contextPoint ? contextAnchorRef : popupAnchorRef ?? rootRef,
             open: mounted,
             placement: contextPoint ? "bottom-start" : placementMap[placement],
             offset: contextPoint ? 2 : 6,
@@ -2112,6 +2113,9 @@ function DropdownRoot({
     }
   );
 }
+function DropdownRoot(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(DropdownInternal, { ...props });
+}
 function DropdownButton({
   children,
   className = "",
@@ -2123,9 +2127,10 @@ function DropdownButton({
   trigger = ["click"],
   ...dropdownProps
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("span", { className: `sia-dropdown-button ${className}`.trim(), children: [
+  const groupRef = (0, import_react8.useRef)(null);
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("span", { ref: groupRef, className: `sia-dropdown-button ${className}`.trim(), children: [
     /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Button, { ...buttonProps, disabled: disabled || buttonDisabled, onClick, children }),
-    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(DropdownRoot, { ...dropdownProps, disabled: disabled || dropdownDisabled, trigger, showTriggerIcon: false, children: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(DropdownInternal, { ...dropdownProps, popupAnchorRef: groupRef, disabled: disabled || dropdownDisabled, trigger, showTriggerIcon: false, children: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
       Button,
       {
         ...buttonProps,
@@ -3982,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;
@@ -4014,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) {
@@ -4052,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)(
@@ -4105,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);
@@ -4120,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",
@@ -4137,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) })
                 ] })
               }
@@ -4661,6 +4709,7 @@ var Select = (0, import_react21.forwardRef)(function Select2({
               value: modalValues,
               onChange: setModalValues,
               multiple,
+              groupCheckable: modalConfig?.groupCheckable,
               allowDeselect: allowClear,
               selectedOnly,
               showValue,
@@ -11821,6 +11870,7 @@ function SelectModalBody({ config, values, disabled, onChange }) {
         value: values,
         onChange,
         multiple,
+        groupCheckable: config.groupCheckable,
         disabled,
         selectedOnly,
         showValue: config.showValue,
@@ -11846,7 +11896,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",
@@ -24435,6 +24485,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");
@@ -24602,6 +24659,7 @@ var import_jsx_runtime93 = require("react/jsx-runtime");
 function QueryForm({
   fields,
   settings,
+  showSettings,
   children,
   form: providedForm,
   onSearch,
@@ -24676,6 +24734,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;
@@ -24683,6 +24742,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])")
       );
@@ -24909,7 +24983,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-OIIkAeiG.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-OIIkAeiG.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';
@@ -1683,6 +1683,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 +2946,8 @@ interface SelectionOption {
     disabledTip?: ReactNode;
     /** 选项所属分组名称。 */
     group?: string;
+    /** 选项名称旁帮助图标的悬停说明，不参与搜索及值回填。 */
+    description?: ReactNode;
     /** 普通或按钮形态 */
     optionType?: "divider";
 }
@@ -2959,6 +2964,9 @@ interface SelectionPanelProps {
      * @defaultValue false
      */
     multiple?: boolean;
+    /** 多选时在分组标题前显示复选框，仅切换当前搜索及已选视图中该组的可用选项；保留组外、隐藏及禁用的已选值。
+     * @defaultValue false */
+    groupCheckable?: boolean;
     /** 单选时允许再次点击已选项以清空选择。 */
     allowDeselect?: boolean;
     /**
@@ -3022,7 +3030,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 +3160,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 +3256,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-BGA9VB0L.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-BGA9VB0L.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';
@@ -1683,6 +1683,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 +2946,8 @@ interface SelectionOption {
     disabledTip?: ReactNode;
     /** 选项所属分组名称。 */
     group?: string;
+    /** 选项名称旁帮助图标的悬停说明，不参与搜索及值回填。 */
+    description?: ReactNode;
     /** 普通或按钮形态 */
     optionType?: "divider";
 }
@@ -2959,6 +2964,9 @@ interface SelectionPanelProps {
      * @defaultValue false
      */
     multiple?: boolean;
+    /** 多选时在分组标题前显示复选框，仅切换当前搜索及已选视图中该组的可用选项；保留组外、隐藏及禁用的已选值。
+     * @defaultValue false */
+    groupCheckable?: boolean;
     /** 单选时允许再次点击已选项以清空选择。 */
     allowDeselect?: boolean;
     /**
@@ -3022,7 +3030,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 +3160,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 +3256,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,19 +80,19 @@ import {
   Watermark,
   message,
   notification
-} from "./chunk-AG2VFAZR.js";
+} from "./chunk-FGGBNWBT.js";
 import {
   MarkdownEditor
 } from "./chunk-TUXNOSCT.js";
 import {
   RichTextContent,
   RichTextEditor
-} from "./chunk-OPYA3PMD.js";
+} from "./chunk-YPHUBD4F.js";
 import {
   DatePicker,
   SelectDateRange,
   TimePanel
-} from "./chunk-GLXGN5SO.js";
+} from "./chunk-4TTHPU2S.js";
 import {
   Checkbox,
   FloatingScrollbarProvider,
@@ -104,7 +104,7 @@ import {
   Tooltip,
   Tree,
   useScrollbarProximity
-} from "./chunk-7BJPQCRG.js";
+} from "./chunk-DJTV4X6L.js";
 import {
   Dropdown,
   FILLED_ICON_NAMES,
@@ -117,7 +117,7 @@ import {
   Segmented,
   Steps,
   useOverlayLifecycle
-} from "./chunk-G5K72R4O.js";
+} from "./chunk-X5BFQUFX.js";
 import {
   Button,
   TextArea
@@ -4378,6 +4378,7 @@ function SelectModalBody({ config, values, disabled, onChange }) {
         value: values,
         onChange,
         multiple,
+        groupCheckable: config.groupCheckable,
         disabled,
         selectedOnly,
         showValue: config.showValue,
@@ -4403,7 +4404,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 +9093,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 +9267,7 @@ import { jsx as jsx27, jsxs as jsxs25 } from "react/jsx-runtime";
 function QueryForm({
   fields,
   settings,
+  showSettings,
   children,
   form: providedForm,
   onSearch,
@@ -9333,6 +9342,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 +9350,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 +9591,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/rich-text-editor.cjs

@@ -1710,7 +1710,8 @@ var placementMap = {
   topLeft: "top-start",
   topRight: "top-end"
 };
-function DropdownRoot({
+function DropdownInternal({
+  popupAnchorRef,
   menu,
   children,
   trigger = ["hover"],
@@ -1923,7 +1924,7 @@ function DropdownRoot({
           PopupPortal,
           {
             ref: popupRef,
-            anchorRef: contextPoint ? contextAnchorRef : rootRef,
+            anchorRef: contextPoint ? contextAnchorRef : popupAnchorRef ?? rootRef,
             open: mounted,
             placement: contextPoint ? "bottom-start" : placementMap[placement],
             offset: contextPoint ? 2 : 6,
@@ -1945,6 +1946,9 @@ function DropdownRoot({
     }
   );
 }
+function DropdownRoot(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(DropdownInternal, { ...props });
+}
 function DropdownButton({
   children,
   className = "",
@@ -1956,9 +1960,10 @@ function DropdownButton({
   trigger = ["click"],
   ...dropdownProps
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("span", { className: `sia-dropdown-button ${className}`.trim(), children: [
+  const groupRef = (0, import_react8.useRef)(null);
+  return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("span", { ref: groupRef, className: `sia-dropdown-button ${className}`.trim(), children: [
     /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Button, { ...buttonProps, disabled: disabled || buttonDisabled, onClick, children }),
-    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(DropdownRoot, { ...dropdownProps, disabled: disabled || dropdownDisabled, trigger, showTriggerIcon: false, children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(DropdownInternal, { ...dropdownProps, popupAnchorRef: groupRef, disabled: disabled || dropdownDisabled, trigger, showTriggerIcon: false, children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
       Button,
       {
         ...buttonProps,

package/dist/rich-text-editor.js

@@ -1,8 +1,8 @@
 import {
   RichTextContent,
   RichTextEditor
-} from "./chunk-OPYA3PMD.js";
-import "./chunk-G5K72R4O.js";
+} from "./chunk-YPHUBD4F.js";
+import "./chunk-X5BFQUFX.js";
 import "./chunk-SJFT5OSX.js";
 import "./chunk-PUZWLIIJ.js";
 export {

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,8 +1,8 @@
 import {
   SelectDateRange
-} from "./chunk-GLXGN5SO.js";
-import "./chunk-7BJPQCRG.js";
-import "./chunk-G5K72R4O.js";
+} from "./chunk-4TTHPU2S.js";
+import "./chunk-DJTV4X6L.js";
+import "./chunk-X5BFQUFX.js";
 import "./chunk-SJFT5OSX.js";
 import "./chunk-PUZWLIIJ.js";
 export {

package/package.json

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