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

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;

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

@@ -0,0 +1,317 @@
+"use client";
+var _excluded = ["options", "value", "onChange", "icon", "label", "bordered", "multiple", "count", "showSearch", "_isCollapsed", "flat"],
+  _excluded2 = ["onOpenChange"];
+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 _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); }
+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; }
+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, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import theme from "../../../theme";
+import { useFilterContext } from "../../FilterContext";
+import { useFilterCollapsed } from "../../hooks/useFilterCollapsed";
+import { useFilterTooltip } from "../../hooks/useFilterTooltip";
+import useFilterStyle, { getFilterCls } from "../../style";
+import { generateFilterId, getPlaceholder, getWrappedValueStyle, normalizeLabel } from "../../utils";
+import CountNumber from "../CountNumber";
+import FilterButton from "../FilterButton";
+import WrappedTagsDisplay from "../WrappedTagsDisplay";
+import { useNormalizedValue } from "./hooks/useNormalizedValue";
+import { useCascaderLabels } from "./hooks/useCascaderLabels";
+import { useCascaderCallbacks } from "./hooks/useCascaderCallbacks";
+import { countLeafNodes } from "./utils/countUtils";
+import { FlatCascaderContent } from "./components/FlatCascaderContent";
+import { NormalCascaderContent } from "./components/NormalCascaderContent";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+var FilterCascader = function FilterCascader(_ref) {
+  var _count$showTotal;
+  var _ref$options = _ref.options,
+    options = _ref$options === void 0 ? [] : _ref$options,
+    value = _ref.value,
+    onChange = _ref.onChange,
+    icon = _ref.icon,
+    label = _ref.label,
+    _ref$bordered = _ref.bordered,
+    bordered = _ref$bordered === void 0 ? true : _ref$bordered,
+    _ref$multiple = _ref.multiple,
+    multiple = _ref$multiple === void 0 ? false : _ref$multiple,
+    _ref$count = _ref.count,
+    count = _ref$count === void 0 ? false : _ref$count,
+    _ref$showSearch = _ref.showSearch,
+    showSearch = _ref$showSearch === void 0 ? false : _ref$showSearch,
+    _ref$_isCollapsed = _ref._isCollapsed,
+    _isCollapsed = _ref$_isCollapsed === void 0 ? false : _ref$_isCollapsed,
+    _ref$flat = _ref.flat,
+    flat = _ref$flat === void 0 ? false : _ref$flat,
+    restProps = _objectWithoutProperties(_ref, _excluded);
+  var isCollapsed = useFilterCollapsed(_isCollapsed);
+  var _useFilterStyle = useFilterStyle(),
+    prefixCls = _useFilterStyle.prefixCls;
+  var _theme$useToken = theme.useToken(),
+    token = _theme$useToken.token;
+  var filterButtonRef = useRef(null);
+  var _useFilterContext = useFilterContext(),
+    updateFilterValue = _useFilterContext.updateFilterValue;
+  var filterId = useMemo(function () {
+    return generateFilterId('cascader', label);
+  }, [label]);
+
+  // 用于控制二级 Popover 的打开状态（仅在单选模式下使用）
+  var _useState = useState(null),
+    _useState2 = _slicedToArray(_useState, 2),
+    openPopoverKey = _useState2[0],
+    setOpenPopoverKey = _useState2[1];
+  // 用于 flat 模式下的多列路径（支持多层级）
+  var _useState3 = useState([]),
+    _useState4 = _slicedToArray(_useState3, 2),
+    flatColumnsPath = _useState4[0],
+    setFlatColumnsPath = _useState4[1];
+
+  // 搜索关键词状态
+  var _useState5 = useState(''),
+    _useState6 = _slicedToArray(_useState5, 2),
+    searchKeyword = _useState6[0],
+    setSearchKeyword = _useState6[1];
+
+  // 从 restProps 中排除 onOpenChange，避免类型冲突
+  var externalOnOpenChange = restProps.onOpenChange,
+    filterButtonProps = _objectWithoutProperties(restProps, _excluded2);
+
+  // 解析 count 配置
+  var showCount = !!count;
+  var showTotal = _typeof(count) === 'object' ? (_count$showTotal = count.showTotal) !== null && _count$showTotal !== void 0 ? _count$showTotal : false : false;
+
+  // 值管理
+  var _useNormalizedValue = useNormalizedValue(value, onChange, multiple),
+    currentValue = _useNormalizedValue.currentValue,
+    setValue = _useNormalizedValue.setValue;
+
+  // 标签显示
+  var _useCascaderLabels = useCascaderLabels(currentValue, options, label, multiple, isCollapsed),
+    getSelectedLabel = _useCascaderLabels.getSelectedLabel,
+    getSelectedTags = _useCascaderLabels.getSelectedTags;
+
+  // 回调函数
+  var _useCascaderCallbacks = useCascaderCallbacks(currentValue, setValue, options, multiple, filterButtonRef, setOpenPopoverKey),
+    handleChange = _useCascaderCallbacks.handleChange,
+    clearByParent = _useCascaderCallbacks.clearByParent,
+    handleClear = _useCascaderCallbacks.handleClear,
+    selectAllChildren = _useCascaderCallbacks.selectAllChildren,
+    handleRemoveTag = _useCascaderCallbacks.handleRemoveTag;
+
+  // 使用 Tooltip hook
+  var _useFilterTooltip = useFilterTooltip({
+      hasValue: currentValue.length > 0,
+      label: label,
+      content: currentValue.length > 0 ? getSelectedTags().map(function (i) {
+        return i.label;
+      }).join(', ') : null,
+      disabled: isCollapsed
+    }),
+    onPopoverOpenChange = _useFilterTooltip.onPopoverOpenChange,
+    wrapWithTooltip = _useFilterTooltip.wrapWithTooltip;
+
+  // 处理主弹窗状态变化
+  var handleMainPopoverOpenChange = useCallback(function (open) {
+    onPopoverOpenChange(open);
+    // 当主弹窗关闭时，同步关闭二级弹窗（单选模式）
+    if (!open && !multiple) {
+      setOpenPopoverKey(null);
+    }
+    // flat 模式下，关闭弹窗时重置列路径，下次打开时只显示最顶层
+    if (!open && flat) {
+      setFlatColumnsPath([]);
+    }
+    // 弹窗关闭时清空搜索关键词
+    if (!open) {
+      setSearchKeyword('');
+    }
+    externalOnOpenChange === null || externalOnOpenChange === void 0 || externalOnOpenChange(open);
+  }, [onPopoverOpenChange, externalOnOpenChange, multiple, flat]);
+
+  // 根据搜索关键词过滤选项（同时搜索父级和子级）
+  var filteredOptions = useMemo(function () {
+    if (!showSearch || !searchKeyword) return options;
+    var lowerKeyword = searchKeyword.toLowerCase().trim();
+    return options.map(function (option) {
+      var parentLabel = normalizeLabel(option.label).toLowerCase();
+      var parentMatches = parentLabel.includes(lowerKeyword);
+
+      // 递归过滤子级选项
+      var filterChildren = function filterChildren(children) {
+        return children.map(function (child) {
+          var childLabel = normalizeLabel(child.label).toLowerCase();
+          var childMatches = childLabel.includes(lowerKeyword);
+
+          // 如果有子级，递归过滤
+          if (child.children && child.children.length > 0) {
+            var _filteredChildren = filterChildren(child.children);
+            // 如果当前节点匹配或有匹配的子级，则保留
+            if (childMatches || _filteredChildren.length > 0) {
+              return _objectSpread(_objectSpread({}, child), {}, {
+                children: childMatches ? child.children : _filteredChildren
+              });
+            }
+            return null;
+          }
+
+          // 叶子节点，如果匹配则保留
+          return childMatches ? child : null;
+        }).filter(function (child) {
+          return child !== null;
+        });
+      };
+      var filteredChildren = option.children ? filterChildren(option.children) : [];
+
+      // 如果父级匹配或有匹配的子级，则保留该选项
+      if (parentMatches || filteredChildren.length > 0) {
+        return _objectSpread(_objectSpread({}, option), {}, {
+          // 如果父级不匹配但子级匹配，只显示匹配的子级
+          children: parentMatches ? option.children : filteredChildren
+        });
+      }
+      return null;
+    }).filter(function (option) {
+      return option !== null;
+    });
+  }, [showSearch, searchKeyword, options]);
+
+  // 当值变化时，更新 context 中的值
+  useEffect(function () {
+    if (isCollapsed && updateFilterValue) {
+      updateFilterValue(filterId, label, currentValue, options, 'cascader');
+    }
+  }, [isCollapsed, updateFilterValue, filterId, label, currentValue, options]);
+
+  // 渲染内容
+  var renderContent = flat ? /*#__PURE__*/_jsx(FlatCascaderContent, {
+    options: filteredOptions,
+    currentValue: currentValue,
+    multiple: multiple,
+    filterButtonRef: filterButtonRef,
+    onValueChange: setValue
+  }) : /*#__PURE__*/_jsx(NormalCascaderContent, {
+    options: filteredOptions,
+    currentValue: currentValue,
+    multiple: multiple,
+    prefixCls: prefixCls,
+    openPopoverKey: openPopoverKey,
+    filterButtonRef: filterButtonRef,
+    onOpenPopoverKeyChange: setOpenPopoverKey,
+    onValueChange: setValue,
+    onHandleChange: handleChange,
+    onClearByParent: clearByParent,
+    onSelectAllChildren: selectAllChildren,
+    showSearch: showSearch,
+    searchKeyword: searchKeyword,
+    onSearchChange: setSearchKeyword
+  });
+
+  // flat 模式下的 Popover 样式（动态宽度）
+  var flatPopoverStyles = flat ? {
+    body: {
+      padding: 0
+    }
+  } : undefined;
+
+  // 计算总数（用于显示计数）
+  var totalCount = showTotal ? options.reduce(function (acc, curr) {
+    return acc + (curr.children ? countLeafNodes(curr.children) : 0);
+  }, 0) : 0;
+
+  // Wrapped 模式
+  if (isCollapsed) {
+    var hasValue = currentValue.length > 0;
+    if (multiple) {
+      var selectedTags = getSelectedTags();
+      return /*#__PURE__*/_jsxs("div", {
+        style: {
+          paddingBlock: token.paddingXXS
+        },
+        children: [/*#__PURE__*/_jsx("div", {
+          style: {
+            marginBottom: 8
+          },
+          children: label
+        }), /*#__PURE__*/_jsx(FilterButton, _objectSpread(_objectSpread(_objectSpread({
+          ref: filterButtonRef,
+          icon: icon,
+          label: label,
+          bordered: bordered,
+          onClear: handleClear,
+          content: renderContent,
+          selected: hasValue,
+          onOpenChange: handleMainPopoverOpenChange,
+          _isFlat: flat
+        }, flat ? {
+          styles: flatPopoverStyles
+        } : {}), filterButtonProps), {}, {
+          children: /*#__PURE__*/_jsx(WrappedTagsDisplay, {
+            tags: selectedTags,
+            onRemove: handleRemoveTag
+          })
+        }))]
+      });
+    }
+    return /*#__PURE__*/_jsxs("div", {
+      children: [/*#__PURE__*/_jsx("div", {
+        style: {
+          marginBottom: 8
+        },
+        children: label
+      }), /*#__PURE__*/_jsx(FilterButton, _objectSpread(_objectSpread(_objectSpread({
+        ref: filterButtonRef,
+        icon: icon,
+        label: label,
+        bordered: bordered,
+        onClear: handleClear,
+        content: renderContent,
+        selected: hasValue,
+        onOpenChange: handleMainPopoverOpenChange
+      }, flat ? {
+        styles: flatPopoverStyles
+      } : {}), filterButtonProps), {}, {
+        children: /*#__PURE__*/_jsx("span", {
+          className: getFilterCls(prefixCls, 'text-ellipsis'),
+          style: getWrappedValueStyle(hasValue),
+          children: hasValue ? getSelectedLabel() : getPlaceholder()
+        })
+      }))]
+    });
+  }
+
+  // 正常模式
+  var filterButton = /*#__PURE__*/_jsxs(FilterButton, _objectSpread(_objectSpread(_objectSpread({
+    ref: filterButtonRef,
+    icon: icon,
+    label: label,
+    bordered: bordered,
+    onClear: handleClear,
+    content: renderContent,
+    selected: !!currentValue.length,
+    onOpenChange: handleMainPopoverOpenChange,
+    _isFlat: flat
+  }, flat ? {
+    styles: flatPopoverStyles
+  } : {}), filterButtonProps), {}, {
+    children: [/*#__PURE__*/_jsx("span", {
+      className: getFilterCls(prefixCls, 'text-ellipsis'),
+      children: getSelectedLabel()
+    }), multiple && showCount && currentValue.length > 0 && /*#__PURE__*/_jsx(CountNumber, {
+      count: currentValue.length,
+      total: totalCount
+    })]
+  }));
+  return wrapWithTooltip(filterButton);
+};
+export default FilterCascader;

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

@@ -0,0 +1,56 @@
+import type { ReactNode } from 'react';
+import type { BaseFilterProps, InternalFilterProps } from '../../type';
+export interface CascaderOption {
+    label?: ReactNode;
+    value: string;
+    disabled?: boolean;
+    children?: CascaderOption[];
+}
+interface BaseFilterCascaderProps extends BaseFilterProps, InternalFilterProps {
+    /** 选项列表 */
+    options?: CascaderOption[];
+    /** 是否显示计数，可传入 { showTotal: true } 同时显示总数 */
+    count?: boolean | {
+        showTotal?: boolean;
+    };
+}
+type FilterCascaderSingleBase = BaseFilterCascaderProps & {
+    /** 是否多选 */
+    multiple?: false;
+    /** 当前选中值，格式为 [parentValue, childValue] */
+    value?: string[];
+    /** 值变化回调 */
+    onChange?: (value: string[]) => void;
+};
+type FilterCascaderMultipleBase = BaseFilterCascaderProps & {
+    /** 是否多选 */
+    multiple?: true;
+    /** 当前选中值，格式为 [[parentValue, childValue], ...] */
+    value?: string[][];
+    /** 值变化回调 */
+    onChange?: (value: string[][]) => void;
+};
+type FilterCascaderWithSearch<T extends FilterCascaderSingleBase | FilterCascaderMultipleBase> = T & {
+    /** 是否显示搜索框，默认为 false */
+    showSearch: true;
+    flat?: never;
+};
+type FilterCascaderWithFlat<T extends FilterCascaderSingleBase | FilterCascaderMultipleBase> = T & {
+    /** 扁平化展示 */
+    flat: true;
+    showSearch?: never;
+};
+type FilterCascaderNormal<T extends FilterCascaderSingleBase | FilterCascaderMultipleBase> = T & {
+    flat?: false;
+    showSearch?: false;
+};
+export type FilterCascaderSingleProps = FilterCascaderWithSearch<FilterCascaderSingleBase> | FilterCascaderWithFlat<FilterCascaderSingleBase> | FilterCascaderNormal<FilterCascaderSingleBase>;
+export type FilterCascaderMultipleProps = FilterCascaderWithSearch<FilterCascaderMultipleBase> | FilterCascaderWithFlat<FilterCascaderMultipleBase> | FilterCascaderNormal<FilterCascaderMultipleBase>;
+export type FilterCascaderProps = FilterCascaderSingleProps | FilterCascaderMultipleProps;
+export interface SelectedTag {
+    label: ReactNode;
+    value: string;
+    parentValue: string;
+    childValue: string;
+}
+export {};

package/es/filter/components/FilterCascader/types.js

@@ -0,0 +1 @@
+export {};

package/es/filter/components/FilterCascader/utils/countUtils.d.ts

@@ -0,0 +1,13 @@
+import type { CascaderOption } from '../types';
+/**
+ * 递归统计所有叶子节点数量（只统计没有children的节点）
+ */
+export declare const countLeafNodes: (options: CascaderOption[]) => number;
+/**
+ * 收集所有叶子节点的完整路径
+ */
+export declare const collectLeafPaths: (options: CascaderOption[], basePath: string[]) => string[][];
+/**
+ * 统计选中的子节点数量
+ */
+export declare const countSelectedChildren: (currentValue: string[][], currentPath: string[]) => number;