@oceanbase/design 1.0.0-alpha.2 → 1.0.0-alpha.21

package/lib/filter/components/FilterCascader/components/CascaderOption/OptionItem.js

@@ -0,0 +1,51 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.OptionItem = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _antd = require("antd");
+var _theme = _interopRequireDefault(require("../../../../../theme"));
+var _icons = require("@oceanbase/icons");
+var _style = require("../../../../style");
+var _constants = require("../../constants");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * 级联选择器的选项文本显示组件（单选模式）
+ */
+const OptionItem = ({
+  label,
+  hasChildren,
+  isSelected,
+  isMultiple,
+  prefixCls
+}) => {
+  const {
+    token
+  } = _theme.default.useToken();
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    children: [label && /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+      className: (0, _style.getFilterCls)(prefixCls, 'text-ellipsis'),
+      style: {
+        flex: 1
+      },
+      children: label
+    }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_antd.Flex, {
+      align: "center",
+      gap: _constants.GAP_SIZE_SMALL,
+      children: [!isMultiple && !hasChildren && isSelected && /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.CheckOutlined, {
+        style: {
+          color: token.colorPrimary
+        }
+      }), hasChildren && /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.RightOutlined, {
+        style: {
+          fontSize: _constants.ICON_SIZE,
+          color: token.colorTextSecondary
+        }
+      })]
+    })]
+  });
+};
+exports.OptionItem = OptionItem;

package/lib/filter/components/FilterCascader/components/FlatCascaderContent/index.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { CascaderPanelProps } from 'antd';
+import type { CascaderOption } from '../../types';
+import type { FilterButtonRef } from '../../../FilterButton';
+interface FlatCascaderContentProps extends CascaderPanelProps {
+    options: CascaderOption[];
+    currentValue: (string | number)[][];
+    multiple: boolean;
+    filterButtonRef: React.RefObject<FilterButtonRef>;
+    onValueChange: (value: (string | number)[][]) => void;
+}
+/**
+ * Flat 模式的级联内容容器组件
+ * 使用 antd 的 Cascader.Panel 实现多列展示
+ */
+export declare const FlatCascaderContent: React.FC<FlatCascaderContentProps>;
+export {};

package/lib/filter/components/FilterCascader/components/FlatCascaderContent/index.js

@@ -0,0 +1,77 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.FlatCascaderContent = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _antd = require("antd");
+var _jsxRuntime = require("react/jsx-runtime");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+/**
+ * 类型工具：根据 multiple 属性推断 Cascader.Panel 的 value 类型
+ * - 单选 (multiple=false): string[]
+ * - 多选 (multiple=true): string[][]
+ */
+/**
+ * Flat 模式的级联内容容器组件
+ * 使用 antd 的 Cascader.Panel 实现多列展示
+ */
+const FlatCascaderContent = ({
+  options,
+  currentValue,
+  filterButtonRef,
+  multiple = false,
+  onValueChange,
+  ...restProps
+}) => {
+  // 将组件内部的值格式转换为 Cascader.Panel 需要的格式
+  // 组件内部：[[parent, child], ...] 或 [[parent, child]]
+  // Cascader.Panel：
+  //   - 单选 (multiple=false): string[]
+  //   - 多选 (multiple=true): string[][]
+
+  const cascaderValue = (0, _react.useMemo)(() => {
+    if (currentValue.length === 0) return undefined;
+    if (!multiple) {
+      // 单选：currentValue 是 [[parent, child]]，返回 [parent, child]
+      return currentValue[0];
+    } else {
+      // 多选：currentValue 是 [[parent, child], ...]
+      return currentValue;
+    }
+  }, [currentValue, multiple]);
+
+  // 处理 Cascader.Panel 的值变化
+  const handleCascaderChange = value => {
+    if (multiple) {
+      // 多选：value 是 string[][]，如 [['frontend', 'react'], ['backend', 'java']]
+      onValueChange(value);
+    } else {
+      // 单选：value 是 string[]，如 ['frontend', 'react']
+      onValueChange([value]);
+      filterButtonRef.current?.closePopover();
+    }
+  };
+
+  // 使用条件渲染来处理 multiple 属性的类型问题
+  return multiple ?
+  /*#__PURE__*/
+  // @ts-ignore-next-line
+  (0, _jsxRuntime.jsx)(_antd.Cascader.Panel, {
+    options: options,
+    value: cascaderValue,
+    onChange: handleCascaderChange,
+    multiple: multiple,
+    showCheckedStrategy: _antd.Cascader.SHOW_CHILD,
+    ...restProps
+  }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Cascader.Panel, {
+    options: options,
+    value: cascaderValue,
+    onChange: handleCascaderChange,
+    multiple: false,
+    ...restProps
+  });
+};
+exports.FlatCascaderContent = FlatCascaderContent;

package/lib/filter/components/FilterCascader/components/NormalCascaderContent.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+import type { CascaderOption } from '../types';
+import type { FilterButtonRef } from '../../FilterButton';
+interface NormalCascaderContentProps {
+    options: CascaderOption[];
+    currentValue: string[][];
+    multiple: boolean;
+    prefixCls: string;
+    openPopoverKey: string | null;
+    filterButtonRef: React.RefObject<FilterButtonRef>;
+    onOpenPopoverKeyChange: (key: string | null) => void;
+    onValueChange: (value: string[][]) => void;
+    onHandleChange: (parentValue: string, childValue: string) => void;
+    onClearByParent: (parentValue: string) => void;
+    onSelectAllChildren: (option: CascaderOption) => void;
+    showSearch?: boolean;
+    searchKeyword?: string;
+    onSearchChange?: (value: string) => void;
+}
+/**
+ * 非 Flat 模式的级联内容组件
+ */
+export declare const NormalCascaderContent: React.FC<NormalCascaderContentProps>;
+export {};

package/lib/filter/components/FilterCascader/components/NormalCascaderContent.js

@@ -0,0 +1,258 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NormalCascaderContent = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _antd = require("antd");
+var _checkbox = _interopRequireDefault(require("../../../../checkbox"));
+var _theme = _interopRequireDefault(require("../../../../theme"));
+var _input = _interopRequireDefault(require("../../../../input"));
+var _empty = _interopRequireDefault(require("../../../../empty"));
+var _icons = require("@oceanbase/icons");
+var _style = require("../../../style");
+var _constants = require("../constants");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * 非 Flat 模式的级联内容组件
+ */
+const NormalCascaderContent = ({
+  options,
+  currentValue,
+  multiple,
+  prefixCls,
+  openPopoverKey,
+  filterButtonRef,
+  onOpenPopoverKeyChange,
+  onValueChange,
+  onHandleChange,
+  onClearByParent,
+  onSelectAllChildren,
+  showSearch = false,
+  searchKeyword = '',
+  onSearchChange
+}) => {
+  const {
+    token
+  } = _theme.default.useToken();
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+    style: {
+      padding: _constants.PADDING_VERTICAL,
+      maxHeight: _constants.MAX_HEIGHT,
+      overflowY: 'auto'
+    },
+    children: [showSearch && /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+      style: {
+        marginInline: 12,
+        marginBottom: 8
+      },
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_input.default, {
+        placeholder: "\u641C\u7D22",
+        prefix: /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.SearchOutlined, {}),
+        allowClear: true,
+        value: searchKeyword,
+        onChange: e => onSearchChange?.(e.target.value),
+        onClick: e => e.stopPropagation()
+      })
+    }), options.length === 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_empty.default, {
+      image: _empty.default.PRESENTED_IMAGE_SIMPLE,
+      description: "\u65E0\u5339\u914D\u7ED3\u679C",
+      style: {
+        padding: '16px 0'
+      }
+    }) : options.map(option => {
+      const selectedChildren = currentValue.filter(item => item[0] === option.value).map(item => item[1]);
+      const hasSelectedChildren = selectedChildren.length > 0;
+      const hasChildren = option.children && option.children.length > 0;
+      const allChildrenSelected = multiple && hasChildren && selectedChildren.length === option.children.length;
+
+      // 判断当前节点是否被选中（用于无子节点的情况）
+      const isNodeSelected = currentValue.some(item => item[0] === option.value && !item[1]);
+
+      // 处理无子节点的点击事件
+      const handleNodeClick = () => {
+        if (option.disabled) {
+          return;
+        }
+        if (!hasChildren) {
+          // 无子节点时，直接选中/取消选中该节点
+          if (multiple) {
+            const isSelected = currentValue.some(item => item[0] === option.value && !item[1]);
+            if (isSelected) {
+              onValueChange(currentValue.filter(item => !(item[0] === option.value && !item[1])));
+            } else {
+              onValueChange([...currentValue, [option.value, '']]);
+            }
+          } else {
+            const isSelected = currentValue.some(item => item[0] === option.value && !item[1]);
+            if (isSelected) {
+              onValueChange([]);
+            } else {
+              onValueChange([[option.value, '']]);
+            }
+            onOpenPopoverKeyChange(null);
+            setTimeout(() => {
+              filterButtonRef.current?.closePopover();
+            }, 0);
+          }
+        }
+      };
+
+      // 没有子节点时，直接渲染节点项，不使用 Popover
+      if (!hasChildren) {
+        return /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+          style: {
+            padding: _constants.PADDING_HORIZONTAL
+          },
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Flex, {
+            gap: _constants.GAP_SIZE_SMALL * 2,
+            className: (0, _style.getFilterCls)(prefixCls, 'select-option'),
+            justify: "space-between",
+            align: "center",
+            onClick: handleNodeClick,
+            style: {
+              cursor: option.disabled ? 'not-allowed' : 'pointer',
+              color: option.disabled ? token.colorTextDisabled : 'inherit'
+            },
+            children: multiple ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_checkbox.default, {
+              checked: isNodeSelected,
+              disabled: option.disabled,
+              children: /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+                className: (0, _style.getFilterCls)(prefixCls, 'text-ellipsis'),
+                children: option.label
+              })
+            }) : /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+              children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+                className: (0, _style.getFilterCls)(prefixCls, 'text-ellipsis'),
+                children: option.label
+              }), /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+                children: isNodeSelected && /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.CheckOutlined, {
+                  style: {
+                    color: token.colorPrimary
+                  }
+                })
+              })]
+            })
+          })
+        }, option.value);
+      }
+
+      // 有子节点时，使用 Popover
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Popover, {
+        placement: "rightTop",
+        trigger: 'hover',
+        arrow: false,
+        open: option?.disabled ? false : multiple ? undefined : openPopoverKey === option.value,
+        onOpenChange: multiple ? undefined : open => {
+          if (!open) {
+            onOpenPopoverKeyChange(null);
+          } else {
+            onOpenPopoverKeyChange(option.value);
+          }
+        },
+        content: option.children?.map(child => {
+          const isSelected = selectedChildren.includes(child.value);
+          const isChildDisabled = child.disabled || false;
+          return /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Flex, {
+            gap: _constants.GAP_SIZE_SMALL * 2,
+            className: (0, _style.getFilterCls)(prefixCls, 'select-option'),
+            justify: "space-between",
+            onClick: e => {
+              e.stopPropagation();
+              if (!isChildDisabled) {
+                onHandleChange(option.value, child.value);
+              }
+            },
+            style: {
+              cursor: isChildDisabled ? 'not-allowed' : 'pointer',
+              color: isChildDisabled ? token.colorTextDisabled : 'inherit'
+            },
+            children: multiple ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_checkbox.default, {
+              checked: isSelected,
+              disabled: isChildDisabled,
+              children: /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+                className: (0, _style.getFilterCls)(prefixCls, 'text-ellipsis'),
+                children: child.label
+              })
+            }) : /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+              children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+                className: (0, _style.getFilterCls)(prefixCls, 'text-ellipsis'),
+                children: child.label
+              }), /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+                children: isSelected && /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.CheckOutlined, {
+                  style: {
+                    color: token.colorPrimary
+                  }
+                })
+              })]
+            })
+          }, child.value);
+        }),
+        styles: {
+          body: {
+            padding: 8,
+            maxHeight: 220,
+            maxWidth: 300,
+            overflowY: 'auto'
+          }
+        },
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+          style: {
+            padding: _constants.PADDING_HORIZONTAL
+          },
+          children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_antd.Flex, {
+            gap: _constants.GAP_SIZE_SMALL * 2,
+            className: (0, _style.getFilterCls)(prefixCls, 'select-option'),
+            justify: "space-between",
+            align: "center",
+            style: {
+              cursor: option.disabled ? 'not-allowed' : 'pointer',
+              color: option.disabled ? token.colorTextDisabled : 'inherit'
+            },
+            children: [multiple ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_checkbox.default, {
+              checked: allChildrenSelected,
+              indeterminate: hasSelectedChildren && !allChildrenSelected,
+              disabled: option.disabled,
+              onClick: e => e.stopPropagation(),
+              onChange: () => {
+                if (!option.disabled) {
+                  if (allChildrenSelected) {
+                    onClearByParent(option.value);
+                  } else {
+                    onSelectAllChildren(option);
+                  }
+                }
+              },
+              children: /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+                className: (0, _style.getFilterCls)(prefixCls, 'text-ellipsis'),
+                children: option.label
+              })
+            }) : /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+              className: (0, _style.getFilterCls)(prefixCls, 'text-ellipsis'),
+              children: option.label
+            }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Flex, {
+              align: "center",
+              gap: _constants.GAP_SIZE_SMALL,
+              children: /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+                className: (0, _style.getFilterCls)(prefixCls, 'icon-wrapper'),
+                children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.RightOutlined, {
+                  className: hasSelectedChildren ? (0, _style.getFilterCls)(prefixCls, 'arrow-icon') : ''
+                }), hasSelectedChildren && /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+                  className: (0, _style.getFilterCls)(prefixCls, 'clear-icon'),
+                  onClick: e => {
+                    e.stopPropagation();
+                    onClearByParent(option.value);
+                  },
+                  children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.CloseOutlined, {})
+                })]
+              })
+            })]
+          })
+        })
+      }, option.value);
+    })]
+  });
+};
+exports.NormalCascaderContent = NormalCascaderContent;

package/lib/filter/components/FilterCascader/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const COLUMN_WIDTH = 200;
+export declare const MAX_HEIGHT = 300;
+export declare const PADDING_VERTICAL = "8px 0px";
+export declare const PADDING_HORIZONTAL = "0px 8px";
+export declare const ICON_SIZE = 12;
+export declare const GAP_SIZE = 8;
+export declare const GAP_SIZE_SMALL = 4;

package/lib/filter/components/FilterCascader/constants.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PADDING_VERTICAL = exports.PADDING_HORIZONTAL = exports.MAX_HEIGHT = exports.ICON_SIZE = exports.GAP_SIZE_SMALL = exports.GAP_SIZE = exports.COLUMN_WIDTH = void 0;
+// 样式常量
+const COLUMN_WIDTH = exports.COLUMN_WIDTH = 200;
+const MAX_HEIGHT = exports.MAX_HEIGHT = 300;
+const PADDING_VERTICAL = exports.PADDING_VERTICAL = '8px 0px';
+const PADDING_HORIZONTAL = exports.PADDING_HORIZONTAL = '0px 8px';
+const ICON_SIZE = exports.ICON_SIZE = 12;
+const GAP_SIZE = exports.GAP_SIZE = 8;
+const GAP_SIZE_SMALL = exports.GAP_SIZE_SMALL = 4;

package/lib/filter/components/FilterCascader/hooks/useCascaderCallbacks.d.ts

@@ -0,0 +1,12 @@
+import type { CascaderOption } from '../types';
+import type { FilterButtonRef } from '../../FilterButton';
+/**
+ * 管理级联选择器的所有回调函数
+ */
+export declare const useCascaderCallbacks: (currentValue: string[][], setValue: (value: string[][]) => void, options: CascaderOption[], multiple: boolean, filterButtonRef: React.RefObject<FilterButtonRef>, setOpenPopoverKey: (key: string | null) => void) => {
+    handleChange: (parentValue: string, childValue: string) => void;
+    clearByParent: (parentValue: string) => void;
+    handleClear: () => void;
+    selectAllChildren: (option: CascaderOption) => void;
+    handleRemoveTag: (tagValue: string) => void;
+};

package/lib/filter/components/FilterCascader/hooks/useCascaderCallbacks.js

@@ -0,0 +1,81 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useCascaderCallbacks = void 0;
+var _react = require("react");
+/**
+ * 管理级联选择器的所有回调函数
+ */
+const useCascaderCallbacks = (currentValue, setValue, options, multiple, filterButtonRef, setOpenPopoverKey) => {
+  const handleChange = (0, _react.useCallback)((parentValue, childValue) => {
+    const parentOption = options.find(opt => opt.value === parentValue);
+    const childOption = parentOption?.children?.find(child => child.value === childValue);
+    if (parentOption?.disabled || childOption?.disabled) {
+      return;
+    }
+    if (multiple) {
+      const existingIndex = currentValue.findIndex(item => item[0] === parentValue && item[1] === childValue);
+      let newValueList;
+      if (existingIndex !== -1) {
+        newValueList = currentValue.filter((_, index) => index !== existingIndex);
+      } else {
+        newValueList = [...currentValue, [parentValue, childValue]];
+      }
+      setValue(newValueList);
+    } else {
+      const isCurrentSelected = currentValue.length === 1 && currentValue[0][0] === parentValue && currentValue[0][1] === childValue;
+      let newValueList;
+      if (isCurrentSelected) {
+        newValueList = [];
+      } else {
+        newValueList = [[parentValue, childValue]];
+      }
+      setValue(newValueList);
+      setOpenPopoverKey(null);
+      setTimeout(() => {
+        filterButtonRef.current?.closePopover();
+      }, 0);
+    }
+  }, [currentValue, multiple, setValue, options, filterButtonRef, setOpenPopoverKey]);
+  const clearByParent = (0, _react.useCallback)(parentValue => {
+    const newValueList = currentValue.filter(item => item[0] !== parentValue);
+    setValue(newValueList);
+  }, [currentValue, setValue]);
+  const handleClear = (0, _react.useCallback)(() => {
+    setValue([]);
+  }, [setValue]);
+  const selectAllChildren = (0, _react.useCallback)(option => {
+    if (option.disabled) {
+      return;
+    }
+    const otherValues = currentValue.filter(item => item[0] !== option.value);
+    const allChildValues = option.children?.filter(child => !child.disabled).map(child => [option.value, child.value]) || [];
+    const newValueList = [...otherValues, ...allChildValues];
+    setValue(newValueList);
+  }, [currentValue, setValue]);
+
+  // 移除某个选中的值
+  const handleRemoveTag = (0, _react.useCallback)(tagValue => {
+    // tagValue 格式：path1::path2::path3::index
+    const parts = tagValue.split('::');
+    if (parts.length >= 2) {
+      const pathParts = parts.slice(0, -1); // 移除最后的 index
+
+      const newValueList = currentValue.filter(item => {
+        if (item.length !== pathParts.length) return true;
+        return !item.every((val, idx) => val === pathParts[idx]);
+      });
+      setValue(newValueList);
+    }
+  }, [currentValue, setValue]);
+  return {
+    handleChange,
+    clearByParent,
+    handleClear,
+    selectAllChildren,
+    handleRemoveTag
+  };
+};
+exports.useCascaderCallbacks = useCascaderCallbacks;

package/lib/filter/components/FilterCascader/hooks/useCascaderLabels.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from 'react';
+import type { CascaderOption, SelectedTag } from '../types';
+/**
+ * 管理级联选择器的标签显示逻辑
+ */
+export declare const useCascaderLabels: (currentValue: string[][], options: CascaderOption[], label: ReactNode, multiple: boolean, isCollapsed: boolean) => {
+    getSelectedLabel: () => ReactNode;
+    getSelectedTags: () => SelectedTag[];
+};

package/lib/filter/components/FilterCascader/hooks/useCascaderLabels.js

@@ -0,0 +1,56 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useCascaderLabels = void 0;
+var _react = require("react");
+var _pathUtils = require("../utils/pathUtils");
+/**
+ * 管理级联选择器的标签显示逻辑
+ */
+const useCascaderLabels = (currentValue, options, label, multiple, isCollapsed) => {
+  // 获取当前选中值的 label（用于单选模式显示）
+  const getSelectedLabel = (0, _react.useCallback)(() => {
+    if (isCollapsed && currentValue.length === 0) {
+      return '';
+    }
+    if (currentValue.length === 0) {
+      return label;
+    }
+    if (!multiple && currentValue.length === 1) {
+      const selectedPath = currentValue[0];
+
+      // 如果是空路径
+      if (!selectedPath || selectedPath.length === 0) {
+        return label;
+      }
+
+      // 对于多层级路径，查找最后一个节点
+      const currentOption = (0, _pathUtils.findOptionByPath)(options, selectedPath);
+      return currentOption?.label || label;
+    }
+    return label;
+  }, [currentValue, isCollapsed, label, multiple, options]);
+
+  // 获取选中值的 tags（用于多选模式 Tag 显示）
+  const getSelectedTags = (0, _react.useCallback)(() => {
+    return currentValue.map((selectedPath, index) => {
+      // 对于多层级路径，查找最后一个节点
+      const currentOption = (0, _pathUtils.findOptionByPath)(options, selectedPath);
+      const displayLabel = currentOption?.label || selectedPath[selectedPath.length - 1];
+      const valueKey = selectedPath.join('::') + `::${index}`;
+      return {
+        label: displayLabel,
+        value: valueKey,
+        parentValue: selectedPath[0],
+        childValue: selectedPath[selectedPath.length - 1]
+      };
+    });
+  }, [currentValue, options]);
+  return {
+    getSelectedLabel,
+    getSelectedTags
+  };
+};
+exports.useCascaderLabels = useCascaderLabels;

package/lib/filter/components/FilterCascader/hooks/useNormalizedValue.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 管理级联选择器的值，处理单选/多选格式转换
+ */
+export declare const useNormalizedValue: (value: string[] | string[][] | undefined, onChange: ((value: string[]) => void) | ((value: string[][]) => void), multiple: boolean) => {
+    currentValue: string[][];
+    setValue: (newValue: string[][]) => void;
+};

package/lib/filter/components/FilterCascader/hooks/useNormalizedValue.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useNormalizedValue = void 0;
+var _react = require("react");
+/**
+ * 管理级联选择器的值，处理单选/多选格式转换
+ */
+const useNormalizedValue = (value, onChange, multiple) => {
+  const normalizeValue = (0, _react.useCallback)(val => {
+    if (!val) return [];
+    if (val.length === 0) return [];
+    // 判断是否为单选格式 string[]
+    if (!multiple && val.length > 0 && typeof val[0] === 'string') {
+      return [val];
+    }
+    return val;
+  }, [multiple]);
+  const denormalizeValue = (0, _react.useCallback)(val => {
+    if (!multiple && val.length > 0) {
+      return val[0]; // 单选模式返回 string[]
+    }
+    return val; // 多选模式返回 string[][]
+  }, [multiple]);
+
+  // 使用受控状态 hook，内部统一使用 string[][] 格式
+  const [internalValue, setInternalValue] = (0, _react.useState)(() => normalizeValue(value));
+
+  // 同步外部 value 到内部
+  (0, _react.useEffect)(() => {
+    setInternalValue(normalizeValue(value));
+  }, [value, normalizeValue]);
+
+  // 内部 setValue 包装函数
+  const setValue = (0, _react.useCallback)(newValue => {
+    setInternalValue(newValue);
+    if (onChange) {
+      onChange(denormalizeValue(newValue));
+    }
+  }, [onChange, denormalizeValue]);
+  return {
+    currentValue: internalValue,
+    setValue
+  };
+};
+exports.useNormalizedValue = useNormalizedValue;