rsuite 5.56.0 → 5.58.0

package/cjs/MultiCascadeTree/MultiCascadeTree.js

@@ -0,0 +1,131 @@
+'use client';
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.default = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
+var _react = _interopRequireDefault(require("react"));
+var _TreeView = _interopRequireDefault(require("./TreeView"));
+var _hooks = require("./hooks");
+var _utils = require("../utils");
+var _SearchView = _interopRequireDefault(require("./SearchView"));
+var emptyArray = [];
+
+/**
+ * The `MultiCascadeTree` component is used to select multiple values from cascading options.
+ * @see https://rsuitejs.com/components/multi-cascade-tree/
+ */
+var MultiCascadeTree = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
+  var _props$as = props.as,
+    Component = _props$as === void 0 ? 'div' : _props$as,
+    _props$data = props.data,
+    data = _props$data === void 0 ? emptyArray : _props$data,
+    defaultValue = props.defaultValue,
+    className = props.className,
+    _props$classPrefix = props.classPrefix,
+    classPrefix = _props$classPrefix === void 0 ? 'cascade-tree' : _props$classPrefix,
+    valueProp = props.value,
+    _props$valueKey = props.valueKey,
+    valueKey = _props$valueKey === void 0 ? 'value' : _props$valueKey,
+    _props$labelKey = props.labelKey,
+    labelKey = _props$labelKey === void 0 ? 'label' : _props$labelKey,
+    _props$childrenKey = props.childrenKey,
+    childrenKey = _props$childrenKey === void 0 ? 'children' : _props$childrenKey,
+    _props$disabledItemVa = props.disabledItemValues,
+    disabledItemValues = _props$disabledItemVa === void 0 ? emptyArray : _props$disabledItemVa,
+    _props$cascade = props.cascade,
+    cascade = _props$cascade === void 0 ? true : _props$cascade,
+    columnWidth = props.columnWidth,
+    columnHeight = props.columnHeight,
+    searchable = props.searchable,
+    _props$uncheckableIte = props.uncheckableItemValues,
+    uncheckableItemValues = _props$uncheckableIte === void 0 ? emptyArray : _props$uncheckableIte,
+    getChildren = props.getChildren,
+    renderColumn = props.renderColumn,
+    renderTreeNode = props.renderTreeNode,
+    onSelect = props.onSelect,
+    onCheck = props.onCheck,
+    onChange = props.onChange,
+    onSearch = props.onSearch,
+    rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "data", "defaultValue", "className", "classPrefix", "value", "valueKey", "labelKey", "childrenKey", "disabledItemValues", "cascade", "columnWidth", "columnHeight", "searchable", "uncheckableItemValues", "getChildren", "renderColumn", "renderTreeNode", "onSelect", "onCheck", "onChange", "onSearch"]);
+  var itemKeys = {
+    childrenKey: childrenKey,
+    labelKey: labelKey,
+    valueKey: valueKey
+  };
+  var _useSelect = (0, _hooks.useSelect)({
+      data: data,
+      childrenKey: childrenKey,
+      labelKey: labelKey,
+      valueKey: valueKey,
+      onSelect: onSelect,
+      getChildren: getChildren
+    }),
+    selectedPaths = _useSelect.selectedPaths,
+    flattenData = _useSelect.flattenData,
+    columnData = _useSelect.columnData,
+    handleSelect = _useSelect.handleSelect;
+  var _useControlled = (0, _utils.useControlled)(valueProp, defaultValue),
+    controlledValue = _useControlled[0];
+  var cascadeValueProps = (0, _extends2.default)({}, itemKeys, {
+    uncheckableItemValues: uncheckableItemValues,
+    cascade: cascade,
+    value: controlledValue,
+    onCheck: onCheck,
+    onChange: onChange
+  });
+  var _useCascadeValue = (0, _hooks.useCascadeValue)(cascadeValueProps, flattenData),
+    value = _useCascadeValue.value,
+    handleCheck = _useCascadeValue.handleCheck;
+  var _useSearch = (0, _hooks.useSearch)({
+      labelKey: labelKey,
+      valueKey: valueKey,
+      childrenKey: childrenKey,
+      flattenedData: flattenData,
+      uncheckableItemValues: uncheckableItemValues,
+      onSearch: onSearch
+    }),
+    items = _useSearch.items,
+    searchKeyword = _useSearch.searchKeyword,
+    handleSearch = _useSearch.handleSearch;
+  var _useClassNames = (0, _utils.useClassNames)(classPrefix),
+    withClassPrefix = _useClassNames.withClassPrefix,
+    merge = _useClassNames.merge;
+  var classes = merge(className, withClassPrefix('multi'));
+  return /*#__PURE__*/_react.default.createElement(Component, (0, _extends2.default)({
+    ref: ref,
+    className: classes
+  }, rest), searchable && /*#__PURE__*/_react.default.createElement(_SearchView.default, {
+    data: items,
+    value: value,
+    searchKeyword: searchKeyword,
+    valueKey: valueKey,
+    labelKey: labelKey,
+    childrenKey: childrenKey,
+    disabledItemValues: disabledItemValues,
+    onCheck: handleCheck,
+    onSearch: handleSearch
+  }), !searchKeyword && /*#__PURE__*/_react.default.createElement(_TreeView.default, {
+    cascade: cascade,
+    columnWidth: columnWidth,
+    columnHeight: columnHeight,
+    uncheckableItemValues: uncheckableItemValues,
+    disabledItemValues: disabledItemValues,
+    valueKey: valueKey,
+    labelKey: labelKey,
+    childrenKey: childrenKey,
+    classPrefix: classPrefix,
+    cascadeData: columnData,
+    cascadePaths: selectedPaths,
+    value: value,
+    onSelect: handleSelect,
+    onCheck: handleCheck,
+    renderColumn: renderColumn,
+    renderTreeNode: renderTreeNode
+  }));
+});
+MultiCascadeTree.displayName = 'MultiCascadeTree';
+var _default = MultiCascadeTree;
+exports.default = _default;

package/cjs/MultiCascadeTree/SearchView.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import { ItemDataType, WithAsProps } from '../@types/common';
+interface SearchViewProps<T> extends WithAsProps {
+    searchKeyword: string;
+    labelKey: string;
+    valueKey: string;
+    childrenKey: string;
+    value: T[];
+    data: ItemDataType<T>[];
+    disabledItemValues: any[];
+    cascade?: boolean;
+    onSearch: (value: string, event: React.ChangeEvent<HTMLInputElement>) => void;
+    onCheck: (item: ItemDataType<T>, event: React.SyntheticEvent, checked: boolean) => void;
+    inputRef?: React.RefObject<HTMLInputElement>;
+}
+declare function SearchView<T>(props: SearchViewProps<T>): JSX.Element;
+export default SearchView;

package/cjs/MultiCascadeTree/SearchView.js

@@ -0,0 +1,117 @@
+'use client';
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.default = void 0;
+var _extends3 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
+var _react = _interopRequireDefault(require("react"));
+var _utils = require("../utils");
+var _treeUtils = require("../utils/treeUtils");
+var _SearchBox = _interopRequireDefault(require("../internals/SearchBox"));
+var _Checkbox = _interopRequireDefault(require("../Checkbox"));
+var _utils2 = require("./utils");
+var _utils3 = require("../CascadeTree/utils");
+function SearchView(props) {
+  var _props$as = props.as,
+    Component = _props$as === void 0 ? 'div' : _props$as,
+    _props$classPrefix = props.classPrefix,
+    classPrefix = _props$classPrefix === void 0 ? 'cascade-search-view' : _props$classPrefix,
+    className = props.className,
+    searchKeyword = props.searchKeyword,
+    childrenKey = props.childrenKey,
+    labelKey = props.labelKey,
+    valueKey = props.valueKey,
+    value = props.value,
+    data = props.data,
+    disabledItemValues = props.disabledItemValues,
+    inputRef = props.inputRef,
+    cascade = props.cascade,
+    onSearch = props.onSearch,
+    onCheck = props.onCheck,
+    rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "classPrefix", "className", "searchKeyword", "childrenKey", "labelKey", "valueKey", "value", "data", "disabledItemValues", "inputRef", "cascade", "onSearch", "onCheck"]);
+  var _useClassNames = (0, _utils.useClassNames)(classPrefix),
+    merge = _useClassNames.merge,
+    prefix = _useClassNames.prefix,
+    withClassPrefix = _useClassNames.withClassPrefix,
+    rootPrefix = _useClassNames.rootPrefix;
+  var classes = merge(className, withClassPrefix());
+  var _useCustom = (0, _utils.useCustom)('Picker'),
+    locale = _useCustom.locale;
+  var renderSearchRow = function renderSearchRow(item, key) {
+    var _extends2;
+    var nodes = (0, _treeUtils.getNodeParents)(item);
+    var label = (0, _utils3.highlightLabel)({
+      item: item,
+      labelKey: labelKey,
+      searchKeyword: searchKeyword,
+      render: function render(patch, index) {
+        return /*#__PURE__*/_react.default.createElement("span", {
+          key: index,
+          className: prefix('match')
+        }, patch);
+      }
+    });
+    nodes.push((0, _extends3.default)({}, item, (_extends2 = {}, _extends2[labelKey] = label, _extends2)));
+    var active = value.some(function (value) {
+      if (cascade) {
+        return nodes.some(function (node) {
+          return node[valueKey] === value;
+        });
+      }
+      return item[valueKey] === value;
+    });
+    var disabled = disabledItemValues.some(function (value) {
+      return nodes.some(function (node) {
+        return node[valueKey] === value;
+      });
+    });
+    var rowClasses = prefix('row', {
+      'row-disabled': disabled
+    });
+    var indeterminate = cascade && !active && (0, _utils2.isSomeChildChecked)(item, value, {
+      valueKey: valueKey,
+      childrenKey: childrenKey
+    });
+    var handleChange = function handleChange(_value, checked, event) {
+      onCheck === null || onCheck === void 0 ? void 0 : onCheck(item, event, checked);
+    };
+    return /*#__PURE__*/_react.default.createElement("div", {
+      role: "treeitem",
+      "aria-disabled": disabled,
+      key: key,
+      className: rowClasses,
+      "data-key": item[valueKey]
+    }, /*#__PURE__*/_react.default.createElement(_Checkbox.default, {
+      disabled: disabled,
+      checked: active,
+      value: item[valueKey],
+      indeterminate: indeterminate,
+      onChange: handleChange
+    }, /*#__PURE__*/_react.default.createElement("span", {
+      className: prefix('col-group')
+    }, nodes.map(function (node, index) {
+      return /*#__PURE__*/_react.default.createElement("span", {
+        key: "col-" + index,
+        className: prefix('col')
+      }, node[labelKey]);
+    }))));
+  };
+  return /*#__PURE__*/_react.default.createElement(Component, (0, _extends3.default)({
+    className: classes
+  }, rest), /*#__PURE__*/_react.default.createElement(_SearchBox.default, {
+    placeholder: locale === null || locale === void 0 ? void 0 : locale.searchPlaceholder,
+    onChange: onSearch,
+    value: searchKeyword,
+    inputRef: inputRef
+  }), searchKeyword !== '' && /*#__PURE__*/_react.default.createElement("div", {
+    className: prefix('panel'),
+    "data-layer": 0,
+    role: "tree"
+  }, data.length ? data.map(renderSearchRow) : /*#__PURE__*/_react.default.createElement("div", {
+    className: merge(prefix('none'), rootPrefix('picker-none'))
+  }, locale.noResultsText)));
+}
+var _default = SearchView;
+exports.default = _default;

package/cjs/MultiCascadeTree/TreeView.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import { ItemDataType, WithAsProps, RsRefForwardingComponent } from '../@types/common';
+import type { CascadeColumn } from '../CascadeTree/types';
+export interface TreeViewProps<T = any> extends WithAsProps {
+    disabledItemValues?: T[];
+    value: T[];
+    childrenKey: string;
+    valueKey: string;
+    labelKey: string;
+    columnWidth?: number;
+    columnHeight?: number | string;
+    cascade?: boolean;
+    cascadeData: (readonly ItemDataType<T>[])[];
+    cascadePaths?: ItemDataType<T>[];
+    uncheckableItemValues: T[];
+    renderTreeNode?: (node: React.ReactNode, item: ItemDataType<T>) => React.ReactNode;
+    renderColumn?: (childNodes: React.ReactNode, column: CascadeColumn<T>) => React.ReactNode;
+    onCheck?: (node: ItemDataType<T>, event: React.SyntheticEvent, checked: boolean) => void;
+    onSelect?: (node: ItemDataType<T>, cascadePaths: ItemDataType<T>[], event: React.SyntheticEvent) => void;
+}
+declare const TreeView: RsRefForwardingComponent<'div', TreeViewProps>;
+export default TreeView;

package/cjs/{MultiCascader → MultiCascadeTree}/TreeView.js

@@ -14,15 +14,11 @@ var _utils = require("../utils");
 var _Picker = require("../internals/Picker");
 var _utils2 = require("./utils");
 var emptyArray = [];
-
-/**
- * TODO: reuse Menu from Cascader for consistent behavior
- */
 var TreeView = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
   var _props$as = props.as,
     Component = _props$as === void 0 ? 'div' : _props$as,
     _props$classPrefix = props.classPrefix,
-    classPrefix = _props$classPrefix === void 0 ? 'menu' : _props$classPrefix,
+    classPrefix = _props$classPrefix === void 0 ? 'tree' : _props$classPrefix,
     className = props.className,
     cascade = props.cascade,
     _props$cascadeData = props.cascadeData,
@@ -33,10 +29,10 @@ var TreeView = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
     childrenKey = _props$childrenKey === void 0 ? 'children' : _props$childrenKey,
     _props$disabledItemVa = props.disabledItemValues,
     disabledItemValues = _props$disabledItemVa === void 0 ? emptyArray : _props$disabledItemVa,
-    _props$menuWidth = props.menuWidth,
-    menuWidth = _props$menuWidth === void 0 ? 156 : _props$menuWidth,
-    _props$menuHeight = props.menuHeight,
-    menuHeight = _props$menuHeight === void 0 ? 200 : _props$menuHeight,
+    _props$columnWidth = props.columnWidth,
+    columnWidth = _props$columnWidth === void 0 ? 156 : _props$columnWidth,
+    _props$columnHeight = props.columnHeight,
+    columnHeight = _props$columnHeight === void 0 ? 200 : _props$columnHeight,
     _props$uncheckableIte = props.uncheckableItemValues,
     uncheckableItemValues = _props$uncheckableIte === void 0 ? emptyArray : _props$uncheckableIte,
     value = props.value,
@@ -45,11 +41,11 @@ var TreeView = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
     _props$labelKey = props.labelKey,
     labelKey = _props$labelKey === void 0 ? 'label' : _props$labelKey,
     style = props.style,
-    renderMenuItem = props.renderMenuItem,
-    renderMenu = props.renderMenu,
+    renderTreeNode = props.renderTreeNode,
+    renderColumn = props.renderColumn,
     _onCheck = props.onCheck,
     onSelect = props.onSelect,
-    rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "classPrefix", "className", "cascade", "cascadeData", "cascadePaths", "childrenKey", "disabledItemValues", "menuWidth", "menuHeight", "uncheckableItemValues", "value", "valueKey", "labelKey", "style", "renderMenuItem", "renderMenu", "onCheck", "onSelect"]);
+    rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "classPrefix", "className", "cascade", "cascadeData", "cascadePaths", "childrenKey", "disabledItemValues", "columnWidth", "columnHeight", "uncheckableItemValues", "value", "valueKey", "labelKey", "style", "renderTreeNode", "renderColumn", "onCheck", "onSelect"]);
   var _useClassNames = (0, _utils.useClassNames)(classPrefix),
     merge = _useClassNames.merge,
     prefix = _useClassNames.prefix;
@@ -127,19 +123,19 @@ var TreeView = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
       },
       checkable: !uncheckable,
       labelClickable: false
-    }, renderMenuItem ? renderMenuItem(label, node) : label, children ? /*#__PURE__*/_react.default.createElement(Icon, {
+    }, renderTreeNode ? renderTreeNode(label, node) : label, children ? /*#__PURE__*/_react.default.createElement(Icon, {
       className: prefix('caret'),
       spin: node.loading
     }) : null);
   };
   var columnStyles = {
-    height: menuHeight,
-    width: menuWidth
+    height: columnHeight,
+    width: columnWidth
   };
   var cascadeNodes = cascadeData.map(function (children, layer) {
     var uncheckableCount = 0;
     var onlyKey = layer + "_" + children.length;
-    var menu = /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, children.map(function (item, index) {
+    var childNodes = /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, children.map(function (item, index) {
       var uncheckable = uncheckableItemValues.some(function (uncheckableValue) {
         return (0, _utils.shallowEqual)(uncheckableValue, item[valueKey]);
       });
@@ -156,7 +152,7 @@ var TreeView = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
         size: children.length
       });
     }));
-    var parentNode = cascadePaths[layer - 1];
+    var parentItem = cascadePaths[layer - 1];
     var columnClasses = prefix('column', {
       'column-uncheckable': uncheckableCount === children.length
     });
@@ -166,14 +162,18 @@ var TreeView = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
       className: columnClasses,
       "data-layer": layer,
       style: columnStyles
-    }, renderMenu ? renderMenu(children, menu, parentNode, layer) : menu);
+    }, renderColumn ? renderColumn(childNodes, {
+      items: children,
+      parentItem: parentItem,
+      layer: layer
+    }) : childNodes);
   });
   var styles = (0, _extends2.default)({}, style, {
-    width: cascadeData.length * menuWidth
+    width: cascadeData.length * columnWidth
   });
   return /*#__PURE__*/_react.default.createElement(Component, (0, _extends2.default)({
     role: "tree",
-    id: id + "-" + popupType,
+    id: id ? id + "-" + popupType : undefined,
     "aria-labelledby": labelId,
     "aria-multiselectable": multiple
   }, rest, {

package/cjs/MultiCascadeTree/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export { default as useFlattenData } from './useFlattenData';
+export { default as useSelect } from './useSelect';
+export { default as useColumnData } from './useColumnData';
+export { default as useCascadeValue } from './useCascadeValue';
+export { default as useSearch } from './useSearch';

package/cjs/MultiCascadeTree/hooks/index.js

@@ -0,0 +1,16 @@
+'use client';
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.useSearch = exports.useCascadeValue = exports.useColumnData = exports.useSelect = exports.useFlattenData = void 0;
+var _useFlattenData = _interopRequireDefault(require("./useFlattenData"));
+exports.useFlattenData = _useFlattenData.default;
+var _useSelect = _interopRequireDefault(require("./useSelect"));
+exports.useSelect = _useSelect.default;
+var _useColumnData = _interopRequireDefault(require("./useColumnData"));
+exports.useColumnData = _useColumnData.default;
+var _useCascadeValue = _interopRequireDefault(require("./useCascadeValue"));
+exports.useCascadeValue = _useCascadeValue.default;
+var _useSearch = _interopRequireDefault(require("./useSearch"));
+exports.useSearch = _useSearch.default;

package/cjs/MultiCascadeTree/hooks/useCascadeValue.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="react" />
+import { MultiCascadeTreeProps, ItemKeys } from '../types';
+import { type ItemType } from '../utils';
+/**
+ * A hook that converts the value into a cascading value
+ * @param props
+ * @param flattenData
+ */
+declare function useCascadeValue<T>(props: Partial<MultiCascadeTreeProps<T>> & ItemKeys, flattenData: ItemType<T>[]): {
+    value: T[];
+    setValue: import("react").Dispatch<import("react").SetStateAction<T[]>>;
+    splitValue: (item: ItemType<T>, checked: boolean, value: T[]) => {
+        value: T[];
+        removedValue: T[];
+    };
+    handleCheck: (...args: any[]) => any;
+};
+export default useCascadeValue;

package/cjs/MultiCascadeTree/hooks/useCascadeValue.js

@@ -0,0 +1,202 @@
+'use client';
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.default = void 0;
+var _react = require("react");
+var _uniq = _interopRequireDefault(require("lodash/uniq"));
+var _remove = _interopRequireDefault(require("lodash/remove"));
+var _utils = require("../../utils");
+var _utils2 = require("../utils");
+/**
+ * A hook that converts the value into a cascading value
+ * @param props
+ * @param flattenData
+ */
+function useCascadeValue(props, flattenData) {
+  var valueKey = props.valueKey,
+    childrenKey = props.childrenKey,
+    uncheckableItemValues = props.uncheckableItemValues,
+    cascade = props.cascade,
+    valueProp = props.value,
+    onChange = props.onChange,
+    onCheck = props.onCheck;
+  /**
+   * Get the values of all children
+   */
+  var getChildrenValue = (0, _react.useCallback)(function (item) {
+    var values = [];
+    if (!item[childrenKey]) {
+      return values;
+    }
+    item[childrenKey].forEach(function (n) {
+      if (uncheckableItemValues && !uncheckableItemValues.some(function (v) {
+        return v === n[valueKey];
+      })) {
+        values.push(n[valueKey]);
+      }
+      values = values.concat(getChildrenValue(n));
+    });
+    return values;
+  }, [childrenKey, uncheckableItemValues, valueKey]);
+  var splitValue = (0, _react.useCallback)(function (item, checked, value) {
+    var itemValue = item[valueKey];
+    var childrenValue = getChildrenValue(item);
+    var parents = (0, _utils2.getParents)(item);
+    var nextValue = [].concat(value);
+    var removedValue = [];
+    if (checked) {
+      nextValue.push(itemValue);
+
+      // Delete all values under the current node
+      removedValue = removedValue.concat((0, _utils2.removeAllChildrenValue)(nextValue, item, {
+        valueKey: valueKey,
+        childrenKey: childrenKey
+      }) || []);
+
+      // Traverse all ancestor nodes of the current node
+      // Then determine whether all the child nodes of these nodes are selected, and then they themselves must be selected
+      var _loop = function _loop(i) {
+        // Whether the parent node can be selected
+        var isCheckableParent = !(uncheckableItemValues !== null && uncheckableItemValues !== void 0 && uncheckableItemValues.some(function (v) {
+          return v === parents[i][valueKey];
+        }));
+        if (isCheckableParent) {
+          var isCheckAll = parents[i][childrenKey]
+          // Filter out options that are marked as not selectable
+          .filter(function (n) {
+            return !(uncheckableItemValues !== null && uncheckableItemValues !== void 0 && uncheckableItemValues.some(function (v) {
+              return v === n[valueKey];
+            }));
+          })
+          // Check if all nodes are selected
+          .every(function (n) {
+            return nextValue.some(function (v) {
+              return v === n[valueKey];
+            });
+          });
+          if (isCheckAll) {
+            // Add parent node value
+            nextValue.push(parents[i][valueKey]);
+
+            // Delete all values under the parent node
+            removedValue = removedValue.concat((0, _utils2.removeAllChildrenValue)(nextValue, parents[i], {
+              valueKey: valueKey,
+              childrenKey: childrenKey
+            }) || []);
+          }
+        }
+      };
+      for (var i = 0; i < parents.length; i++) {
+        _loop(i);
+      }
+    } else {
+      var tempValue = childrenValue.concat(parents.map(function (item) {
+        return item[valueKey];
+      }));
+      nextValue = nextValue.concat((0, _utils2.getOtherItemValuesByUnselectChild)(item, nextValue, {
+        valueKey: valueKey,
+        childrenKey: childrenKey
+      }));
+
+      // Delete related child and parent nodes
+      removedValue = (0, _remove.default)(nextValue, function (v) {
+        // Delete yourself
+        if (v === itemValue) {
+          return true;
+        }
+        return tempValue.some(function (n) {
+          return n === v;
+        });
+      });
+    }
+    var uniqValue = (0, _uniq.default)(nextValue);
+    var uniqRemovedValue = (0, _uniq.default)(removedValue);
+    return {
+      value: uniqValue,
+      removedValue: uniqRemovedValue
+    };
+  }, [valueKey, childrenKey, uncheckableItemValues, getChildrenValue]);
+  var transformValue = (0, _react.useCallback)(function (value) {
+    if (value === void 0) {
+      value = [];
+    }
+    if (!cascade) {
+      return value;
+    }
+    var tempRemovedValue = [];
+    var nextValue = [];
+    var _loop2 = function _loop2(i) {
+      // If the value in the current value is already in the deleted list, it will not be processed
+      if (tempRemovedValue.some(function (v) {
+        return v === value[i];
+      })) {
+        return "continue";
+      }
+      var item = flattenData.find(function (v) {
+        return v[valueKey] === value[i];
+      });
+      if (!item) {
+        return "continue";
+      }
+      var sv = splitValue(item, true, value);
+      tempRemovedValue = (0, _uniq.default)(tempRemovedValue.concat(sv.removedValue));
+
+      // Get all relevant values
+      nextValue = (0, _uniq.default)(nextValue.concat(sv.value));
+    };
+    for (var i = 0; i < value.length; i++) {
+      var _ret = _loop2(i);
+      if (_ret === "continue") continue;
+    }
+
+    // Finally traverse all nextValue, and delete if its parent node is also nextValue
+    return nextValue.filter(function (v) {
+      var item = flattenData.find(function (n) {
+        return n[valueKey] === v;
+      });
+      if (item !== null && item !== void 0 && item.parent && nextValue.some(function (v) {
+        var _item$parent;
+        return v === ((_item$parent = item.parent) === null || _item$parent === void 0 ? void 0 : _item$parent[valueKey]);
+      })) {
+        return false;
+      }
+      return true;
+    });
+  }, [cascade, flattenData, splitValue, valueKey]);
+  var _useState = (0, _react.useState)(transformValue(valueProp) || []),
+    value = _useState[0],
+    setValue = _useState[1];
+  (0, _react.useEffect)(function () {
+    // Update value when valueProp is updated.
+    setValue(transformValue(valueProp) || []);
+  }, [transformValue, valueProp]);
+  var handleCheck = (0, _utils.useEventCallback)(function (node, event, checked) {
+    var nodeValue = node[valueKey];
+    var nextValue = [];
+    if (cascade) {
+      nextValue = splitValue(node, checked, value).value;
+    } else {
+      nextValue = [].concat(value);
+      if (checked) {
+        nextValue.push(nodeValue);
+      } else {
+        nextValue = nextValue.filter(function (n) {
+          return n !== nodeValue;
+        });
+      }
+    }
+    setValue(nextValue);
+    onChange === null || onChange === void 0 ? void 0 : onChange(nextValue, event);
+    onCheck === null || onCheck === void 0 ? void 0 : onCheck(nextValue, node, checked, event);
+  });
+  return {
+    value: value,
+    setValue: setValue,
+    splitValue: splitValue,
+    handleCheck: handleCheck
+  };
+}
+var _default = useCascadeValue;
+exports.default = _default;

package/cjs/MultiCascadeTree/hooks/useColumnData.d.ts

@@ -0,0 +1,16 @@
+/// <reference types="react" />
+declare type MayHasParent<T extends Record<string, unknown>> = T & {
+    parent?: MayHasParent<T>;
+};
+/**
+ * A hook for column data
+ * @param flattenData
+ */
+declare function useColumnData<T extends MayHasParent<Record<string, unknown>>>(flattenData: T[]): {
+    columnData: (readonly T[])[];
+    addColumn: (column: T[], index: number) => void;
+    removeColumnByIndex: (index: number) => void;
+    setColumnData: import("react").Dispatch<import("react").SetStateAction<(readonly T[])[]>>;
+    enforceUpdateColumnData: (nextData: T[]) => void;
+};
+export default useColumnData;