@sheinx/hooks 3.0.0-alpha.2 → 3.0.0-alpha.20

package/cjs/components/use-transfer/index.js

@@ -1,4 +1,5 @@
 "use strict";
+"use client";
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {

package/cjs/components/use-transfer/use-transfer.type.d.ts

@@ -7,24 +7,77 @@ export interface TransferInfo<DataItem> {
     disabledKeys: KeygenResult[];
 }
 export interface BaseTransferProps<DataItem, Value extends KeygenResult[]> {
+    /**
+     * @en Data source
+     * @cn 数据源
+     * @default index
+     */
     data: DataItem[];
     selectedKeys?: KeygenResult[];
+    /**
+     * @en Default checked list
+     * @cn 默认被勾选的列表
+     */
     defaultSelectedKeys?: KeygenResult[];
+    /**
+     * @en The set of values displayed in the box data on the right
+     * @cn 显示在右侧框数据的值集合
+     */
     value?: Value;
+    /**
+     * @en Default value
+     * @cn 默认值  和 value 类型相同
+     */
     defaultValue?: Value;
+    /**
+     * @en Format value. The defaule value is return the original data. When it is a string, the value is fetched from the original data as a key equivalent to (d) => d[format] When it is a function, use its return value
+     * @cn 格式化 value, 默认值，返回原始数据。 为 string 时，会作为 key 从原始数据中获取值，相当于 (d) => d[format]; 为函数时，以函数返回结果作为 value
+     * @default d => d
+     */
     format?: ((data: DataItem) => Value[number]) | ObjectKey<DataItem>;
+    /**
+     * @en Generate a auxiliary method for each key If not filled, index will be used(not recommended,there may be problems with more than 10 data) When it is a function, use its return value. When it is a string，ues the value of the string.For example, "id" is the same thing as (d) => d.id
+     * @cn 生成每一项key的辅助方法 为 true 时，以数据项本身作为key，相当于 (d => d) 为函数时，使用此函数返回值 为string时，使用这个string对应的数据值。如 "id"，相当于 (d => d.id)
+     * @default index
+     */
     keygen?: KeygenType<DataItem>;
     simple?: boolean;
+    /**
+     * @en When the value is true, disabled all checkboxes; When the value is function, disable the checkbox that this function returns true
+     * @cn 如果 disabled 为 true，禁用全部选项，如果 disabled 为函数，根据函数反回结果禁用选项
+     */
     disabled?: boolean | ((data: DataItem) => boolean);
     valueControl: boolean;
     selectControl: boolean;
+    /**
+     * @en By default, the result of the format function is used to compare whether it matches. In some cases (for example, whe an object that returns the original data is updated, an different option with the same value  is generated), the prediction function needs to be used to determine whether match
+     * @cn 默认使用 format 函数执行的结果来比较是否匹配，在某些情况下（例如返回原始数据的对象，更新数据时，生成了一个值相同，非同一个对象的选项），需要借助 prediction 函数来判断是否匹配
+     */
     prediction?: (value: Value[number], Data: DataItem) => boolean;
+    /**
+     * @en The callback before the value is changed, when the return value is not empty, it will be used as the new value of the component
+     * @cn 值改变前的回调，当返回值不为空时将作为组件的新值
+     */
     beforeChange?: (value: Value) => any;
+    /**
+     * @en Change callback,Parameter is the selected value
+     * @cn 改变回调,参数为当前选中值
+     */
     onChange?: (value: Value, currentData: DataItem[] | DataItem, isTarget: boolean) => void;
+    /**
+     * @en Filter function, parameters are: input text, data, whether it is the data on the left
+     * @cn 筛选函数, 参数为: 输入文本, 数据, 是否为左侧数据
+     */
     onFilter?: (text: string, data: DataItem, isSource: boolean) => boolean;
+    /**
+     * @en Search event
+     * @cn 输入框值变化的回调, 参数为: 输入文本, 是否为左侧数据
+     */
     onSearch?: (text: string, isSource: boolean) => void;
     /**
      * ((value: KeygenResult) => void) 这种为内部非受控情况下的类型，非受控内部直接整合 target source
+     * @en Select event
+     * @cn 勾选触发的方法
      */
     onSelectChange?: ((sourceKeys: KeygenResult[], targetKeys?: KeygenResult[]) => void) | ((selectKeys: KeygenResult[]) => void);
 }

package/cjs/components/use-transfer/use-transfer.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-transfer.type.d.ts","sourceRoot":"","sources":["use-transfer.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAExE,oBAAY,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnD,MAAM,WAAW,YAAY,CAAC,QAAQ;IACpC,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACzC,YAAY,EAAE,YAAY,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB,CAAC,QAAQ,EAAE,KAAK,SAAS,YAAY,EAAE;IACvE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B,mBAAmB,CAAC,EAAE,YAAY,EAAE,CAAC;IACrC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACnE,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC;IACnD,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC;IAC/D,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,GAAG,CAAC;IACrC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACzF,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC;IACxE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD;;OAEG;IACH,cAAc,CAAC,EACX,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,UAAU,CAAC,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC,GACnE,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC,CAAC;CAC5C"}
+{"version":3,"file":"use-transfer.type.d.ts","sourceRoot":"","sources":["use-transfer.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAExE,oBAAY,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnD,MAAM,WAAW,YAAY,CAAC,QAAQ;IACpC,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACzC,YAAY,EAAE,YAAY,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB,CAAC,QAAQ,EAAE,KAAK,SAAS,YAAY,EAAE;IACvE;;;;OAIG;IACH,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,YAAY,EAAE,CAAC;IACrC;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACnE;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC;IACnD,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC;IAC/D;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,GAAG,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACzF;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC;IACxE;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD;;;;OAIG;IACH,cAAc,CAAC,EACX,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,UAAU,CAAC,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC,GACnE,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC,CAAC;CAC5C"}

package/cjs/components/use-tree/index.d.ts

@@ -1,6 +1,5 @@
 export { default, default as useTree } from './use-tree';
-export type { BaseTreeProps, UpdateFunc, TreePathType } from './use-tree.type';
+export type { BaseTreeProps, UpdateFunc, TreePathType, TreeModeType } from './use-tree.type';
 export { default as useTreeNode } from './use-tree-node';
 export type { BaseTreeNodeProps, UpdateType } from './use-tree-node.type';
-export { default as usePlacement } from './use-placement';
 //# sourceMappingURL=index.d.ts.map

package/cjs/components/use-tree/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE1E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE7F,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/cjs/components/use-tree/index.js

@@ -1,4 +1,5 @@
 "use strict";
+"use client";
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
@@ -10,12 +11,6 @@ Object.defineProperty(exports, "default", {
     return _useTree.default;
   }
 });
-Object.defineProperty(exports, "usePlacement", {
-  enumerable: true,
-  get: function get() {
-    return _usePlacement.default;
-  }
-});
 Object.defineProperty(exports, "useTree", {
   enumerable: true,
   get: function get() {
@@ -29,5 +24,4 @@ Object.defineProperty(exports, "useTreeNode", {
   }
 });
 var _useTree = _interopRequireDefault(require("./use-tree"));
-var _useTreeNode = _interopRequireDefault(require("./use-tree-node"));
-var _usePlacement = _interopRequireDefault(require("./use-placement"));
+var _useTreeNode = _interopRequireDefault(require("./use-tree-node"));

package/cjs/components/use-tree/use-tree-node.d.ts

@@ -1,12 +1,13 @@
 /// <reference types="react" />
 import { BaseTreeNodeProps } from './use-tree-node.type';
-declare const useTreeNode: <DataItem>(props: BaseTreeNodeProps<DataItem>) => {
+declare const useTreeNode: <DataItem, Value>(props: BaseTreeNodeProps<DataItem, Value>) => {
     update: (key: string, value: boolean) => void;
     active: boolean;
     expanded: boolean;
     fetching: boolean;
     isLeaf: () => boolean;
     setFetching: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setExpanded: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     onToggle: () => void;
 };
 export default useTreeNode;

package/cjs/components/use-tree/use-tree-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-tree-node.d.ts","sourceRoot":"","sources":["use-tree-node.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,QAAA,MAAM,WAAW;kBAMmB,MAAM,SAAS,OAAO;;;;;;;CAkDzD,CAAC;AACF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"use-tree-node.d.ts","sourceRoot":"","sources":["use-tree-node.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,QAAA,MAAM,WAAW;kBAMmB,MAAM,SAAS,OAAO;;;;;;;;CAmDzD,CAAC;AACF,eAAe,WAAW,CAAC"}

package/cjs/components/use-tree/use-tree-node.js

@@ -13,8 +13,7 @@ var useTreeNode = function useTreeNode(props) {
     data = props.data,
     bindNode = props.bindNode,
     childrenKey = props.childrenKey,
-    loader = props.loader,
-    onToggle = props.onToggle;
+    loader = props.loader;
   var _useState = (0, _react.useState)(false),
     _useState2 = (0, _slicedToArray2.default)(_useState, 2),
     active = _useState2[0],
@@ -45,9 +44,9 @@ var useTreeNode = function useTreeNode(props) {
     }
   });
   var handleToggle = function handleToggle() {
-    var newExpand = !expanded;
-    setExpanded(newExpand);
-    if (onToggle) onToggle(id, newExpand);
+    // const newExpand = !expanded;
+    // setExpanded(newExpand);
+    // if (onToggle) onToggle(id, newExpand);
   };
   var isLeaf = function isLeaf() {
     var children = data[childrenKey];
@@ -60,9 +59,9 @@ var useTreeNode = function useTreeNode(props) {
   (0, _react.useEffect)(function () {
     var _bindNode = bindNode(id, update),
       active = _bindNode.active,
-      expanded = _bindNode.expanded;
+      nextExpanded = _bindNode.expanded;
     setActive(active);
-    setExpanded(expanded);
+    setExpanded(nextExpanded);
   }, []);
   return {
     update: update,
@@ -71,6 +70,7 @@ var useTreeNode = function useTreeNode(props) {
     fetching: fetching,
     isLeaf: isLeaf,
     setFetching: setFetching,
+    setExpanded: setExpanded,
     onToggle: handleToggle
   };
 };

package/cjs/components/use-tree/use-tree-node.type.d.ts

@@ -7,7 +7,7 @@ export interface NodeState {
     expanded: boolean;
     fetching: boolean;
 }
-export interface BaseTreeNodeProps<DataItem> {
+export interface BaseTreeNodeProps<DataItem, Value> {
     id: KeygenResult;
     data: DataItem;
     childrenKey: keyof DataItem;
@@ -20,7 +20,7 @@ export interface BaseTreeNodeProps<DataItem> {
     };
     content: HTMLDivElement | null;
     loader?: (key: KeygenResult, data: DataItem) => void;
-    onToggle?: (id: KeygenResult, expanded: boolean) => void;
+    onToggle?: (id: Value, expanded: boolean) => void;
     onDrop?: (data: DataItem[], key: KeygenResult, targetKey: KeygenResult, position: number) => void;
 }
 //# sourceMappingURL=use-tree-node.type.d.ts.map

package/cjs/components/use-tree/use-tree-node.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-tree-node.type.d.ts","sourceRoot":"","sources":["use-tree-node.type.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,oBAAY,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5D,oBAAY,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAEjE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB,CAAC,QAAQ;IACzC,EAAE,EAAE,YAAY,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,QAAQ,CAAC;IAC5B,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IACzC,iBAAiB,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3D,cAAc,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IACrC,QAAQ,EAAE,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,KAAK;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3F,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACzD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACnG"}
+{"version":3,"file":"use-tree-node.type.d.ts","sourceRoot":"","sources":["use-tree-node.type.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,oBAAY,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5D,oBAAY,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAEjE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB,CAAC,QAAQ,EAAE,KAAK;IAChD,EAAE,EAAE,YAAY,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,QAAQ,CAAC;IAC5B,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IACzC,iBAAiB,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3D,cAAc,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IACrC,QAAQ,EAAE,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,KAAK;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3F,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACnG"}

package/cjs/components/use-tree/use-tree.d.ts

@@ -23,18 +23,41 @@ export declare const MODE: {
     MODE_4: number;
 };
 declare const useTree: <DataItem>(props: BaseTreeProps<DataItem>) => {
-    func: {
+    datum: {
         get: (id: KeygenResult) => CheckedStatusType | undefined;
-        set: (id: KeygenResult, checked: CheckedStatusType, direction?: 'asc' | 'desc') => CheckedStatusType;
+        set: (id: KeygenResult, checked: CheckedStatusType, direction?: 'asc' | 'desc') => CheckedStatusType | null;
+        childrenKey: keyof DataItem & string;
+        data: DataItem[];
         getPath: (id: KeygenResult) => TreePathType | undefined;
         getValue: () => KeygenResult[];
         getChecked: (id: KeygenResult) => boolean | "indeterminate";
+        getKey: (item: DataItem, id?: KeygenResult, index?: number) => KeygenResult;
+        getDataByValues: (values: KeygenResult[] | KeygenResult) => NonNullable<DataItem> | {
+            IS_NOT_MATCHED_VALUE: boolean;
+            value: KeygenResult;
+        } | (NonNullable<DataItem> | {
+            IS_NOT_MATCHED_VALUE: boolean;
+            value: KeygenResult;
+        } | null)[] | null;
+        setValue: (value?: KeygenResult[]) => void;
+        setData: (data?: DataItem[] | undefined) => void;
         isDisabled: (id: KeygenResult) => boolean;
         bindNode: (id: KeygenResult, update: UpdateFunc) => {
             active: boolean;
             expanded: boolean;
         };
+        getDataById: (id: KeygenResult) => NonNullable<DataItem> | {
+            IS_NOT_MATCHED_VALUE: boolean;
+            value: KeygenResult;
+        } | null;
     };
+    getKey: (item: DataItem, id?: KeygenResult, index?: number) => KeygenResult;
+    getDataById: (id: KeygenResult) => NonNullable<DataItem> | {
+        IS_NOT_MATCHED_VALUE: boolean;
+        value: KeygenResult;
+    } | null;
+    expanded: KeygenResult[] | undefined;
+    onExpand: (value: KeygenResult[]) => void;
     pathMap: Map<KeygenResult, TreePathType>;
     dataMap: Map<KeygenResult, DataItem>;
     valueMap: Map<KeygenResult, CheckedStatusType>;

package/cjs/components/use-tree/use-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-tree.d.ts","sourceRoot":"","sources":["use-tree.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EAEjB,UAAU,EACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,eAAO,MAAM,IAAI;IACf;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAEJ,CAAC;AAEF,QAAA,MAAM,OAAO;;kBAyCM,YAAY;kBAsOZ,YAAY,WAAW,iBAAiB,cAAc,KAAK,GAAG,MAAM;sBAjLhE,YAAY;;yBAYT,YAAY;yBAmIZ,YAAY;uBA9Md,YAAY,UAAU,UAAU;;;;;;;;;CAgUvD,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"use-tree.d.ts","sourceRoot":"","sources":["use-tree.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EAEjB,UAAU,EACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,eAAO,MAAM,IAAI;IACf;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAEJ,CAAC;AAEF,QAAA,MAAM,OAAO;;kBAqDM,YAAY;kBAkQZ,YAAY,WAAW,iBAAiB,cAAc,KAAK,GAAG,MAAM;;;sBAzMhE,YAAY;;yBAYT,YAAY;sCAjEA,YAAY,UAAe,MAAM,KAAG,YAAY;kCA+EnD,YAAY,EAAE,GAAG,YAAY;;;;;;;2BAqIpC,YAAY,EAAE;;yBAQhB,YAAY;uBA3Od,YAAY,UAAU,UAAU;;;;0BAuF7B,YAAY;;;;;kCAxED,YAAY,UAAe,MAAM,KAAG,YAAY;sBAwE3D,YAAY;;;;;;;;;;CAoRtC,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/cjs/components/use-tree/use-tree.js

@@ -11,11 +11,12 @@ require("core-js/modules/es.map.js");
 require("core-js/modules/web.dom-collections.iterator.js");
 require("core-js/modules/es.array.index-of.js");
 require("core-js/modules/web.dom-collections.for-each.js");
+require("core-js/modules/es.array.map.js");
 require("core-js/modules/es.array.concat.js");
 require("core-js/modules/es.array.filter.js");
-require("core-js/modules/es.set.js");
 var _react = require("react");
 var _useLatestObj = _interopRequireDefault(require("../../common/use-latest-obj"));
+var _useInputAble2 = require("../../common/use-input-able");
 var _is = require("../../utils/is");
 var MODE = {
   /**
@@ -51,17 +52,31 @@ var useTree = function useTree(props) {
     keygen = props.keygen,
     mode = props.mode,
     activeProp = props.active,
-    expanded = props.expanded,
-    defaultExpanded = props.defaultExpanded,
+    expandedProp = props.expanded,
+    _props$defaultExpande = props.defaultExpanded,
+    defaultExpanded = _props$defaultExpande === void 0 ? [] : _props$defaultExpande,
     defaultExpandAll = props.defaultExpandAll,
-    disabledProps = props.disabled;
+    disabledProps = props.disabled,
+    unmatch = props.unmatch,
+    isControlled = props.isControlled,
+    onExpandProp = props.onExpand;
+  var _useInputAble = (0, _useInputAble2.useInputAble)({
+      value: expandedProp,
+      defaultValue: defaultExpanded,
+      control: isControlled,
+      onChange: onExpandProp,
+      beforeChange: undefined
+    }),
+    expanded = _useInputAble.value,
+    onExpand = _useInputAble.onChange;
   var _useRef = (0, _react.useRef)({
       pathMap: new Map(),
       dataMap: new Map(),
       valueMap: new Map(),
       updateMap: new Map(),
+      unmatchedValueMap: new Map(),
       disabled: false,
-      value: [],
+      value: undefined,
       data: [],
       cachedValue: []
     }),
@@ -84,9 +99,9 @@ var useTree = function useTree(props) {
       expanded: !!(expandeds && expandeds.indexOf(id) >= 0)
     };
   };
-  function get(id) {
+  var get = function get(id) {
     return context.valueMap.get(id);
-  }
+  };
   var getKey = function getKey(item) {
     var id = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
     var index = arguments.length > 2 ? arguments[2] : undefined;
@@ -133,6 +148,10 @@ var useTree = function useTree(props) {
         default:
       }
     });
+    context.unmatchedValueMap.forEach(function (unmatch, id) {
+      if (unmatch) values.push(id);
+    });
+    context.cachedValue = values;
     return values;
   };
   var getPath = function getPath(id) {
@@ -152,15 +171,33 @@ var useTree = function useTree(props) {
     if (value === 2) checked = 'indeterminate';
     return checked;
   };
-
-  // const getDataById = (id: KeygenResult) => {
-  //   const oroginData = context.dataMap.get(id);
-  //   if (oroginData) return oroginData;
-  // };
-
+  var getDataById = function getDataById(id) {
+    var oroginData = context.dataMap.get(id);
+    if (oroginData) return oroginData;
+    if (!unmatch) return null;
+    return {
+      IS_NOT_MATCHED_VALUE: true,
+      value: id
+    };
+  };
+  var getDataByValues = function getDataByValues(values) {
+    if ((0, _is.isArray)(values)) {
+      return values.map(getDataById);
+    }
+    return getDataById(values);
+  };
   var setValueMap = function setValueMap(id, checked) {
     context.valueMap.set(id, checked);
   };
+  var setUnmatedValue = function setUnmatedValue() {
+    context.unmatchedValueMap = new Map();
+    if (!context.value || !context.data) return;
+    context.value.forEach(function (v) {
+      var data = getDataById(v);
+      var unmatched = (0, _is.isUnMatchedData)(data);
+      if (unmatched) context.unmatchedValueMap.set(v, true);else context.unmatchedValueMap.delete(v);
+    });
+  };
   var initData = function initData(data, path, disabled) {
     var index = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : [];
     var ids = [];
@@ -169,6 +206,7 @@ var useTree = function useTree(props) {
       var id = getKey(item, path[path.length - 1], i);
       // 重复 id 警告
       if (context.dataMap.get(id)) {
+        console.error("There is already a key \"".concat(id, "\" exists. The key must be unique."));
         return;
       }
       // 制作 data mapping
@@ -177,32 +215,32 @@ var useTree = function useTree(props) {
       if (_isDisabled === false && (0, _is.isFunc)(context.disabled)) {
         _isDisabled = context.disabled(item);
       }
-      ids.push(id);
       var indexPath = [].concat((0, _toConsumableArray2.default)(index), [i]);
+      ids.push(id);
       var children = [];
       if (Array.isArray(item[childrenKey])) {
         var _children = initData(item[childrenKey], [].concat((0, _toConsumableArray2.default)(path), [id]), mode === MODE.MODE_4 ? disabled : _isDisabled, indexPath);
         if (_children) children = _children;
       }
       context.pathMap.set(id, {
-        index: i,
-        path: path,
         children: children,
+        path: path,
         isDisabled: _isDisabled,
-        indexPath: indexPath
+        indexPath: indexPath,
+        index: i
       });
     }
     return ids;
   };
   var initValue = function initValue(ids_outer, forceCheck) {
     var ids = ids_outer;
-    if (!data || !value) {
+    if (!context.data || !context.value) {
       return undefined;
     }
     if (!ids) {
       ids = [];
-      context.pathMap.forEach(function (path, index) {
-        if (path.path.length === 0) {
+      context.pathMap.forEach(function (item, index) {
+        if (item.path.length === 0) {
           ids.push(index);
         }
       });
@@ -219,13 +257,13 @@ var useTree = function useTree(props) {
       if (forceCheck) {
         setValueMap(item, 1);
         initValue(children, forceCheck);
-        return;
+        continue;
       }
-      var childChecked = value.indexOf(item) >= 0 ? 1 : 0;
+      var childChecked = context.value.indexOf(item) >= 0 ? 1 : 0;
 
       // 选中且非 mode 1 和 mode 4，则需要将其子选项统统强制选中
       if (childChecked === 1 && mode !== MODE.MODE_1 && mode !== MODE.MODE_4) {
-        // initValue(children, true);
+        initValue(children, true);
       }
       // mode 2 mode 3 mode 的情况下，需要根据 children 内容来决定是否选中
       else if (children.length > 0) {
@@ -234,7 +272,7 @@ var useTree = function useTree(props) {
       }
       // 没有子节点的情况下，需要根据 value 来决定是否选中
       else {
-        childChecked = value.indexOf(item) >= 0 ? 1 : 0;
+        childChecked = context.value.indexOf(item) >= 0 ? 1 : 0;
       }
 
       // 同步状态至 map 中
@@ -254,6 +292,7 @@ var useTree = function useTree(props) {
     if (value && value !== context.cachedValue) {
       initValue();
     }
+    setUnmatedValue();
   };
   var isDisabled = function isDisabled(id) {
     var node = context.pathMap.get(id);
@@ -277,6 +316,7 @@ var useTree = function useTree(props) {
     context.pathMap = new Map();
     context.dataMap = new Map();
     context.valueMap = new Map();
+    context.unmatchedValueMap = new Map();
     context.disabled = getDisabled();
     context.data = data;
     if (!data) return;
@@ -288,9 +328,11 @@ var useTree = function useTree(props) {
     if (!isDisabled(id)) {
       setValueMap(id, checked);
     }
-
-    // // const data = getDataById(id);
-
+    var data = getDataById(id);
+    if (data && data['IS_NOT_MATCHED_VALUE']) {
+      if (checked) context.unmatchedValueMap.set(id, true);else context.unmatchedValueMap.delete(id);
+      return null;
+    }
     if (mode === MODE.MODE_4) {
       return 0;
     }
@@ -322,34 +364,44 @@ var useTree = function useTree(props) {
     }
     return current;
   };
-  var handleExpanded = function handleExpanded(expanded) {
-    var temp = new Set(expanded);
-    context.updateMap.forEach(function (update, id) {
-      update('expanded', temp.has(id));
-    });
-  };
-  (0, _react.useEffect)(function () {
+  if (firstRender.current) {
     setValue(value);
     setData(data);
-    setTimeout(function () {
-      firstRender.current = false;
-    });
-  }, [data]);
+    firstRender.current = false;
+  }
   (0, _react.useEffect)(function () {
-    if (firstRender.current) return;
-    handleExpanded(expanded);
-  }, [expanded]);
-  var func = (0, _useLatestObj.default)({
+    if (defaultExpandAll) {
+      var nextExpanded = [];
+      context.dataMap.forEach(function (item, k) {
+        if (item[childrenKey]) {
+          nextExpanded.push(k);
+        }
+      });
+      onExpand(nextExpanded);
+    }
+  }, []);
+  var datum = (0, _useLatestObj.default)({
     get: get,
     set: set,
+    childrenKey: childrenKey,
+    data: data,
     getPath: getPath,
     getValue: getValue,
     getChecked: getChecked,
+    getKey: getKey,
+    getDataByValues: getDataByValues,
+    setValue: setValue,
+    setData: setData,
     isDisabled: isDisabled,
-    bindNode: bindNode
+    bindNode: bindNode,
+    getDataById: getDataById
   });
   return {
-    func: func,
+    datum: datum,
+    getKey: getKey,
+    getDataById: getDataById,
+    expanded: expanded,
+    onExpand: onExpand,
     pathMap: context.pathMap,
     dataMap: context.dataMap,
     valueMap: context.valueMap,

package/cjs/components/use-tree/use-tree.type.d.ts

@@ -1,4 +1,4 @@
-import { ObjectType, StructKeygenStringType, KeygenResult } from '../../common/type';
+import { StructKeygenStringType, KeygenResult, ObjectKey } from '../../common/type';
 export declare type CheckedStatusType = 0 | 1 | 2;
 export declare type TreeModeType = 0 | 1 | 2 | 3 | 4;
 export declare type UpdateFunc = (name: string, active: boolean) => void;
@@ -6,6 +6,7 @@ export interface TreeContext<DataItem> {
     pathMap: Map<KeygenResult, TreePathType>;
     dataMap: Map<KeygenResult, DataItem>;
     valueMap: Map<KeygenResult, CheckedStatusType>;
+    unmatchedValueMap: Map<any, any>;
     updateMap: Map<KeygenResult, UpdateFunc>;
     disabled: boolean | ((item: DataItem) => boolean);
     value?: KeygenResult[];
@@ -14,23 +15,87 @@ export interface TreeContext<DataItem> {
 }
 export interface TreePathType {
     children: KeygenResult[];
-    path: (number | string)[];
+    path: KeygenResult[];
     isDisabled: boolean;
     indexPath: number[];
     index: number;
 }
-export interface BaseTreeProps<DataItem = ObjectType> {
+export interface BaseTreeProps<DataItem> {
+    /**
+     * @private 内部属性
+     */
+    isControlled: boolean;
     active?: KeygenResult;
+    /**
+     * @en Selected key (controlled)
+     * @cn 选中的 key （受控）
+     */
     value?: KeygenResult[];
+    /**
+     * @en Default selected key (not controlled)
+     * @cn 默认选中的 key （非受控）
+     */
     defaultValue?: KeygenResult[];
+    /**
+     * @en Data, children is children, if children is null or length is 0, it is considered as a leaf node
+     * @cn 数据，子节点为 children，如果 children 值为 null 或 长度为 0 时，视为叶子节点
+     */
     data: DataItem[];
+    /**
+     * @en Expanded node
+     * @cn 展开的节点 key(受控)
+     */
     expanded?: KeygenResult[];
+    /**
+     * @en Default expanded nodes
+     * @cn 默认展开的节点 key（非受控）
+     */
     defaultExpanded?: KeygenResult[];
+    /**
+     * @en Expanded all nodes
+     * @cn 默认展开所有节点
+     * @default false
+     */
     defaultExpandAll?: boolean;
+    /**
+     * @en Control whether the node can be chosen
+     * @cn 显示选择框时有效，为 true 时，所有节点禁用选择，为函数时，根据函数返回结果确定是否禁用
+     * @default false
+     */
     disabled?: boolean | ((item: DataItem) => boolean);
+    /**
+     * @en Auxiliary method for generating key. When it is a function, use the return value of this function. When it is a string, use the data value corresponding to this string. For example, "id" is the same thing as (d) => d.id
+     * @cn 生成 key 的辅助方法, 为函数时，使用此函数返回值, 为 string 时，使用这个 string 对应的数据值。如 "id"，相当于 (d) => d.id
+     * @default index
+     */
     keygen: StructKeygenStringType<DataItem>;
-    childrenKey?: keyof DataItem;
+    /**
+     * @en Specify the name of the subdata
+     * @cn 指定子数据的属性名
+     * @default 'children'
+     */
+    childrenKey?: ObjectKey<DataItem>;
+    /**
+     * @en Mode 0: Returns only the fully selected node including the parent node. 1: Returns all selected nodes and semi-selected nodes. 2: Return only the selected child nodes. 3: If the parent node is full selected, only return the parent node. 4: What you choose is what you get
+     * @cn 选中值模式，未设置值为单选 0: 只返回完全选中的节点，包含父节点 1: 返回全部选中的节点和半选中的父节点 2: 只返回选中的子节点 3: 如果父节点选中，只返回父节点 4: 所选即所得
+     * @default 1
+     */
     mode?: TreeModeType;
+    /**
+     * @en Whether to monitor data changes to update data
+     * @cn 是否监听 data 变化更新数据
+     * @default true
+     */
     dataUpdate?: boolean;
+    /**
+     * @en Whether to enable unmatch mode
+     * @cn 是否开启不匹配模式
+     */
+    unmatch?: boolean;
+    /**
+     * @en Expand event
+     * @cn 节点展开回调，参数为当前展开节点 key 数组
+     */
+    onExpand?: (value: KeygenResult[]) => void;
 }
 //# sourceMappingURL=use-tree.type.d.ts.map