@oceanbase/design 1.0.0-alpha.8 → 1.0.0

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

@@ -0,0 +1,78 @@
+"use client";
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _excluded = ["options", "currentValue", "filterButtonRef", "multiple", "onValueChange"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+import React, { useMemo } from 'react';
+import { Cascader } from 'antd';
+
+/**
+ * 类型工具：根据 multiple 属性推断 Cascader.Panel 的 value 类型
+ * - 单选 (multiple=false): string[]
+ * - 多选 (multiple=true): string[][]
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Flat 模式的级联内容容器组件
+ * 使用 antd 的 Cascader.Panel 实现多列展示
+ */
+export var FlatCascaderContent = function FlatCascaderContent(_ref) {
+  var options = _ref.options,
+    currentValue = _ref.currentValue,
+    filterButtonRef = _ref.filterButtonRef,
+    _ref$multiple = _ref.multiple,
+    multiple = _ref$multiple === void 0 ? false : _ref$multiple,
+    onValueChange = _ref.onValueChange,
+    restProps = _objectWithoutProperties(_ref, _excluded);
+  // 将组件内部的值格式转换为 Cascader.Panel 需要的格式
+  // 组件内部：[[parent, child], ...] 或 [[parent, child]]
+  // Cascader.Panel：
+  //   - 单选 (multiple=false): string[]
+  //   - 多选 (multiple=true): string[][]
+
+  var cascaderValue = useMemo(function () {
+    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 的值变化
+  var handleCascaderChange = function handleCascaderChange(value) {
+    if (multiple) {
+      // 多选：value 是 string[][]，如 [['frontend', 'react'], ['backend', 'java']]
+      onValueChange(value);
+    } else {
+      var _filterButtonRef$curr;
+      // 单选：value 是 string[]，如 ['frontend', 'react']
+      onValueChange([value]);
+      (_filterButtonRef$curr = filterButtonRef.current) === null || _filterButtonRef$curr === void 0 || _filterButtonRef$curr.closePopover();
+    }
+  };
+
+  // 使用条件渲染来处理 multiple 属性的类型问题
+  return multiple ?
+  /*#__PURE__*/
+  // @ts-ignore-next-line
+  _jsx(Cascader.Panel, _objectSpread({
+    options: options,
+    value: cascaderValue,
+    onChange: handleCascaderChange,
+    multiple: multiple,
+    showCheckedStrategy: Cascader.SHOW_CHILD
+  }, restProps)) : /*#__PURE__*/_jsx(Cascader.Panel, _objectSpread({
+    options: options,
+    value: cascaderValue,
+    onChange: handleCascaderChange,
+    multiple: false
+  }, restProps));
+};

package/es/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/es/filter/components/FilterCascader/components/NormalCascaderContent.js

@@ -0,0 +1,279 @@
+"use client";
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+import React from 'react';
+import { Flex, Popover } from 'antd';
+import Checkbox from "../../../../checkbox";
+import theme from "../../../../theme";
+import Input from "../../../../input";
+import Empty from "../../../../empty";
+import { CheckOutlined, CloseOutlined, RightOutlined, SearchOutlined } from '@oceanbase/icons';
+import { getFilterCls } from "../../../style";
+import { MAX_HEIGHT, PADDING_VERTICAL, PADDING_HORIZONTAL, GAP_SIZE_SMALL } from "../constants";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Fragment as _Fragment } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * 非 Flat 模式的级联内容组件
+ */
+export var NormalCascaderContent = function NormalCascaderContent(_ref) {
+  var options = _ref.options,
+    currentValue = _ref.currentValue,
+    multiple = _ref.multiple,
+    prefixCls = _ref.prefixCls,
+    openPopoverKey = _ref.openPopoverKey,
+    filterButtonRef = _ref.filterButtonRef,
+    onOpenPopoverKeyChange = _ref.onOpenPopoverKeyChange,
+    onValueChange = _ref.onValueChange,
+    onHandleChange = _ref.onHandleChange,
+    onClearByParent = _ref.onClearByParent,
+    onSelectAllChildren = _ref.onSelectAllChildren,
+    _ref$showSearch = _ref.showSearch,
+    showSearch = _ref$showSearch === void 0 ? false : _ref$showSearch,
+    _ref$searchKeyword = _ref.searchKeyword,
+    searchKeyword = _ref$searchKeyword === void 0 ? '' : _ref$searchKeyword,
+    onSearchChange = _ref.onSearchChange;
+  var _theme$useToken = theme.useToken(),
+    token = _theme$useToken.token;
+  return /*#__PURE__*/_jsxs("div", {
+    style: {
+      padding: PADDING_VERTICAL,
+      maxHeight: MAX_HEIGHT,
+      overflowY: 'auto'
+    },
+    children: [showSearch && /*#__PURE__*/_jsx("div", {
+      style: {
+        marginInline: 12,
+        marginBottom: 8
+      },
+      children: /*#__PURE__*/_jsx(Input, {
+        placeholder: "\u641C\u7D22",
+        prefix: /*#__PURE__*/_jsx(SearchOutlined, {}),
+        allowClear: true,
+        value: searchKeyword,
+        onChange: function onChange(e) {
+          return onSearchChange === null || onSearchChange === void 0 ? void 0 : onSearchChange(e.target.value);
+        },
+        onClick: function onClick(e) {
+          return e.stopPropagation();
+        }
+      })
+    }), options.length === 0 ? /*#__PURE__*/_jsx(Empty, {
+      image: Empty.PRESENTED_IMAGE_SIMPLE,
+      description: "\u65E0\u5339\u914D\u7ED3\u679C",
+      style: {
+        padding: '16px 0'
+      }
+    }) : options.map(function (option) {
+      var _option$children;
+      var selectedChildren = currentValue.filter(function (item) {
+        return item[0] === option.value;
+      }).map(function (item) {
+        return item[1];
+      });
+      var hasSelectedChildren = selectedChildren.length > 0;
+      var hasChildren = option.children && option.children.length > 0;
+      var allChildrenSelected = multiple && hasChildren && selectedChildren.length === option.children.length;
+
+      // 判断当前节点是否被选中（用于无子节点的情况）
+      var isNodeSelected = currentValue.some(function (item) {
+        return item[0] === option.value && !item[1];
+      });
+
+      // 处理无子节点的点击事件
+      var handleNodeClick = function handleNodeClick() {
+        if (option.disabled) {
+          return;
+        }
+        if (!hasChildren) {
+          // 无子节点时，直接选中/取消选中该节点
+          if (multiple) {
+            var isSelected = currentValue.some(function (item) {
+              return item[0] === option.value && !item[1];
+            });
+            if (isSelected) {
+              onValueChange(currentValue.filter(function (item) {
+                return !(item[0] === option.value && !item[1]);
+              }));
+            } else {
+              onValueChange([].concat(_toConsumableArray(currentValue), [[option.value, '']]));
+            }
+          } else {
+            var _isSelected = currentValue.some(function (item) {
+              return item[0] === option.value && !item[1];
+            });
+            if (_isSelected) {
+              onValueChange([]);
+            } else {
+              onValueChange([[option.value, '']]);
+            }
+            onOpenPopoverKeyChange(null);
+            setTimeout(function () {
+              var _filterButtonRef$curr;
+              (_filterButtonRef$curr = filterButtonRef.current) === null || _filterButtonRef$curr === void 0 || _filterButtonRef$curr.closePopover();
+            }, 0);
+          }
+        }
+      };
+
+      // 没有子节点时，直接渲染节点项，不使用 Popover
+      if (!hasChildren) {
+        return /*#__PURE__*/_jsx("div", {
+          style: {
+            padding: PADDING_HORIZONTAL
+          },
+          children: /*#__PURE__*/_jsx(Flex, {
+            gap: GAP_SIZE_SMALL * 2,
+            className: 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__*/_jsx(Checkbox, {
+              checked: isNodeSelected,
+              disabled: option.disabled,
+              children: /*#__PURE__*/_jsx("span", {
+                className: getFilterCls(prefixCls, 'text-ellipsis'),
+                children: option.label
+              })
+            }) : /*#__PURE__*/_jsxs(_Fragment, {
+              children: [/*#__PURE__*/_jsx("div", {
+                className: getFilterCls(prefixCls, 'text-ellipsis'),
+                children: option.label
+              }), /*#__PURE__*/_jsx("span", {
+                children: isNodeSelected && /*#__PURE__*/_jsx(CheckOutlined, {
+                  style: {
+                    color: token.colorPrimary
+                  }
+                })
+              })]
+            })
+          })
+        }, option.value);
+      }
+
+      // 有子节点时，使用 Popover
+      return /*#__PURE__*/_jsx(Popover, {
+        placement: "rightTop",
+        trigger: 'hover',
+        arrow: false,
+        open: option !== null && option !== void 0 && option.disabled ? false : multiple ? undefined : openPopoverKey === option.value,
+        onOpenChange: multiple ? undefined : function (open) {
+          if (!open) {
+            onOpenPopoverKeyChange(null);
+          } else {
+            onOpenPopoverKeyChange(option.value);
+          }
+        },
+        content: (_option$children = option.children) === null || _option$children === void 0 ? void 0 : _option$children.map(function (child) {
+          var isSelected = selectedChildren.includes(child.value);
+          var isChildDisabled = child.disabled || false;
+          return /*#__PURE__*/_jsx(Flex, {
+            gap: GAP_SIZE_SMALL * 2,
+            className: getFilterCls(prefixCls, 'select-option'),
+            justify: "space-between",
+            onClick: function 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__*/_jsx(Checkbox, {
+              checked: isSelected,
+              disabled: isChildDisabled,
+              children: /*#__PURE__*/_jsx("span", {
+                className: getFilterCls(prefixCls, 'text-ellipsis'),
+                children: child.label
+              })
+            }) : /*#__PURE__*/_jsxs(_Fragment, {
+              children: [/*#__PURE__*/_jsx("span", {
+                className: getFilterCls(prefixCls, 'text-ellipsis'),
+                children: child.label
+              }), /*#__PURE__*/_jsx("span", {
+                children: isSelected && /*#__PURE__*/_jsx(CheckOutlined, {
+                  style: {
+                    color: token.colorPrimary
+                  }
+                })
+              })]
+            })
+          }, child.value);
+        }),
+        styles: {
+          body: {
+            padding: 8,
+            maxHeight: 220,
+            maxWidth: 300,
+            overflowY: 'auto'
+          }
+        },
+        children: /*#__PURE__*/_jsx("div", {
+          style: {
+            padding: PADDING_HORIZONTAL
+          },
+          children: /*#__PURE__*/_jsxs(Flex, {
+            gap: GAP_SIZE_SMALL * 2,
+            className: 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__*/_jsx(Checkbox, {
+              checked: allChildrenSelected,
+              indeterminate: hasSelectedChildren && !allChildrenSelected,
+              disabled: option.disabled,
+              onClick: function onClick(e) {
+                return e.stopPropagation();
+              },
+              onChange: function onChange() {
+                if (!option.disabled) {
+                  if (allChildrenSelected) {
+                    onClearByParent(option.value);
+                  } else {
+                    onSelectAllChildren(option);
+                  }
+                }
+              },
+              children: /*#__PURE__*/_jsx("span", {
+                className: getFilterCls(prefixCls, 'text-ellipsis'),
+                children: option.label
+              })
+            }) : /*#__PURE__*/_jsx("div", {
+              className: getFilterCls(prefixCls, 'text-ellipsis'),
+              children: option.label
+            }), /*#__PURE__*/_jsx(Flex, {
+              align: "center",
+              gap: GAP_SIZE_SMALL,
+              children: /*#__PURE__*/_jsxs("div", {
+                className: getFilterCls(prefixCls, 'icon-wrapper'),
+                children: [/*#__PURE__*/_jsx(RightOutlined, {
+                  className: hasSelectedChildren ? getFilterCls(prefixCls, 'arrow-icon') : ''
+                }), hasSelectedChildren && /*#__PURE__*/_jsx("div", {
+                  className: getFilterCls(prefixCls, 'clear-icon'),
+                  onClick: function onClick(e) {
+                    e.stopPropagation();
+                    onClearByParent(option.value);
+                  },
+                  children: /*#__PURE__*/_jsx(CloseOutlined, {})
+                })]
+              })
+            })]
+          })
+        })
+      }, option.value);
+    })]
+  });
+};

package/es/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/es/filter/components/FilterCascader/constants.js

@@ -0,0 +1,8 @@
+// 样式常量
+export var COLUMN_WIDTH = 200;
+export var MAX_HEIGHT = 300;
+export var PADDING_VERTICAL = '8px 0px';
+export var PADDING_HORIZONTAL = '0px 8px';
+export var ICON_SIZE = 12;
+export var GAP_SIZE = 8;
+export var GAP_SIZE_SMALL = 4;

package/es/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/es/filter/components/FilterCascader/hooks/useCascaderCallbacks.js

@@ -0,0 +1,101 @@
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+import { useCallback } from 'react';
+/**
+ * 管理级联选择器的所有回调函数
+ */
+export var useCascaderCallbacks = function useCascaderCallbacks(currentValue, setValue, options, multiple, filterButtonRef, setOpenPopoverKey) {
+  var handleChange = useCallback(function (parentValue, childValue) {
+    var _parentOption$childre;
+    var parentOption = options.find(function (opt) {
+      return opt.value === parentValue;
+    });
+    var childOption = parentOption === null || parentOption === void 0 || (_parentOption$childre = parentOption.children) === null || _parentOption$childre === void 0 ? void 0 : _parentOption$childre.find(function (child) {
+      return child.value === childValue;
+    });
+    if (parentOption !== null && parentOption !== void 0 && parentOption.disabled || childOption !== null && childOption !== void 0 && childOption.disabled) {
+      return;
+    }
+    if (multiple) {
+      var existingIndex = currentValue.findIndex(function (item) {
+        return item[0] === parentValue && item[1] === childValue;
+      });
+      var newValueList;
+      if (existingIndex !== -1) {
+        newValueList = currentValue.filter(function (_, index) {
+          return index !== existingIndex;
+        });
+      } else {
+        newValueList = [].concat(_toConsumableArray(currentValue), [[parentValue, childValue]]);
+      }
+      setValue(newValueList);
+    } else {
+      var isCurrentSelected = currentValue.length === 1 && currentValue[0][0] === parentValue && currentValue[0][1] === childValue;
+      var _newValueList;
+      if (isCurrentSelected) {
+        _newValueList = [];
+      } else {
+        _newValueList = [[parentValue, childValue]];
+      }
+      setValue(_newValueList);
+      setOpenPopoverKey(null);
+      setTimeout(function () {
+        var _filterButtonRef$curr;
+        (_filterButtonRef$curr = filterButtonRef.current) === null || _filterButtonRef$curr === void 0 || _filterButtonRef$curr.closePopover();
+      }, 0);
+    }
+  }, [currentValue, multiple, setValue, options, filterButtonRef, setOpenPopoverKey]);
+  var clearByParent = useCallback(function (parentValue) {
+    var newValueList = currentValue.filter(function (item) {
+      return item[0] !== parentValue;
+    });
+    setValue(newValueList);
+  }, [currentValue, setValue]);
+  var handleClear = useCallback(function () {
+    setValue([]);
+  }, [setValue]);
+  var selectAllChildren = useCallback(function (option) {
+    var _option$children;
+    if (option.disabled) {
+      return;
+    }
+    var otherValues = currentValue.filter(function (item) {
+      return item[0] !== option.value;
+    });
+    var allChildValues = ((_option$children = option.children) === null || _option$children === void 0 ? void 0 : _option$children.filter(function (child) {
+      return !child.disabled;
+    }).map(function (child) {
+      return [option.value, child.value];
+    })) || [];
+    var newValueList = [].concat(_toConsumableArray(otherValues), _toConsumableArray(allChildValues));
+    setValue(newValueList);
+  }, [currentValue, setValue]);
+
+  // 移除某个选中的值
+  var handleRemoveTag = useCallback(function (tagValue) {
+    // tagValue 格式：path1::path2::path3::index
+    var parts = tagValue.split('::');
+    if (parts.length >= 2) {
+      var pathParts = parts.slice(0, -1); // 移除最后的 index
+
+      var newValueList = currentValue.filter(function (item) {
+        if (item.length !== pathParts.length) return true;
+        return !item.every(function (val, idx) {
+          return val === pathParts[idx];
+        });
+      });
+      setValue(newValueList);
+    }
+  }, [currentValue, setValue]);
+  return {
+    handleChange: handleChange,
+    clearByParent: clearByParent,
+    handleClear: handleClear,
+    selectAllChildren: selectAllChildren,
+    handleRemoveTag: handleRemoveTag
+  };
+};

package/es/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/es/filter/components/FilterCascader/hooks/useCascaderLabels.js

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

package/es/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/es/filter/components/FilterCascader/hooks/useNormalizedValue.js

@@ -0,0 +1,53 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useCallback, useEffect, useState } from 'react';
+
+/**
+ * 管理级联选择器的值，处理单选/多选格式转换
+ */
+export var useNormalizedValue = function useNormalizedValue(value, onChange, multiple) {
+  var normalizeValue = useCallback(function (val) {
+    if (!val) return [];
+    if (val.length === 0) return [];
+    // 判断是否为单选格式 string[]
+    if (!multiple && val.length > 0 && typeof val[0] === 'string') {
+      return [val];
+    }
+    return val;
+  }, [multiple]);
+  var denormalizeValue = useCallback(function (val) {
+    if (!multiple && val.length > 0) {
+      return val[0]; // 单选模式返回 string[]
+    }
+    return val; // 多选模式返回 string[][]
+  }, [multiple]);
+
+  // 使用受控状态 hook，内部统一使用 string[][] 格式
+  var _useState = useState(function () {
+      return normalizeValue(value);
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    internalValue = _useState2[0],
+    setInternalValue = _useState2[1];
+
+  // 同步外部 value 到内部
+  useEffect(function () {
+    setInternalValue(normalizeValue(value));
+  }, [value, normalizeValue]);
+
+  // 内部 setValue 包装函数
+  var setValue = useCallback(function (newValue) {
+    setInternalValue(newValue);
+    if (onChange) {
+      onChange(denormalizeValue(newValue));
+    }
+  }, [onChange, denormalizeValue]);
+  return {
+    currentValue: internalValue,
+    setValue: setValue
+  };
+};

package/es/filter/components/FilterCascader/index.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { FilterCascaderProps } from './types';
+declare const FilterCascader: React.FC<FilterCascaderProps>;
+export type { FilterCascaderProps, CascaderOption } from './types';
+export default FilterCascader;