@qsxy/element-plus-react 1.0.0-next.1 → 1.0.0-next.3

package/dist/Tree/RCTree.d.ts

@@ -114,6 +114,10 @@ export interface TreeProps<TreeDataType extends BasicDataNode = DataNode> {
         dropPosition: number;
         dropToGap: boolean;
     }) => void;
+    /**
+     * Used for `rc-tree-select` only.
+     * Do not use in your production code directly since this will be refactor.
+     */
     onActiveChange?: (key: Key) => void;
     filterTreeNode?: (treeNode: EventDataNode) => boolean;
     motion?: any;
@@ -186,6 +190,13 @@ declare class RCTree<TreeDataType extends BasicDataNode = DataNode> extends Comp
     componentWillUnmount(): void;
     static getDerivedStateFromProps(props: TreeProps, prevState: TreeState): Partial<TreeState<DataNode<any>>>;
     onNodeDragStart: NodeDragEventHandler<HTMLDivElement, TreeDataType>;
+    /**
+     * [Legacy] Select handler is smaller than node,
+     * so that this will trigger when drag enter node or select handler.
+     * This is a little tricky if customize css without padding.
+     * Better for use mouse move event to refresh drag state.
+     * But let's just keep it to avoid event trigger logic change.
+     */
     onNodeDragEnter: (event: any, node: NodeInstance<TreeDataType>) => void;
     onNodeDragOver: (event: any, node: NodeInstance<TreeDataType>) => void;
     onNodeDragLeave: NodeDragEventHandler;
@@ -215,6 +226,7 @@ declare class RCTree<TreeDataType extends BasicDataNode = DataNode> extends Comp
         dropPosition: 0 | 1 | -1;
         keyEntities: Record<Key, DataEntity<TreeDataType>>;
     };
+    /** Set uncontrolled `expandedKeys`. This will also auto update `flattenNodes`. */
     setExpandedKeys: (expandedKeys: Key[]) => void;
     flattenTreeData: (expandedKeys: Key[]) => FlattenNode[];
     onNodeExpand: (e: any, treeNode: EventDataNode) => void;
@@ -224,6 +236,9 @@ declare class RCTree<TreeDataType extends BasicDataNode = DataNode> extends Comp
     getActiveItem: () => FlattenNode;
     offsetActiveKey: (offset: number) => void;
     onKeyDown: React.KeyboardEventHandler<HTMLDivElement>;
+    /**
+     * Only update the value which is not in props
+     */
     setUncontrolledState: (state: Partial<TreeState>, atomic?: boolean, forceState?: Partial<TreeState<TreeDataType>> | null) => void;
     scrollTo: ScrollTo;
     render(): React.JSX.Element;

package/dist/Tree/Tree.d.ts

@@ -84,25 +84,40 @@ export interface TreeProps<T> extends Omit<RcTreeProps<T>, 'prefixCls' | 'showLi
         showLeafIcon: boolean;
     };
     className?: string;
+    /** 是否支持多选 */
     multiple?: boolean;
+    /** 是否自动展开父节点 */
     autoExpandParent?: boolean;
+    /** Checkable状态下节点选择完全受控（父子节点选中状态不再关联） */
     checkStrictly?: boolean;
+    /** 是否支持选中 */
     checkable?: boolean;
+    /** 是否禁用树 */
     disabled?: boolean;
+    /** 默认展开所有树节点 */
     defaultExpandAll?: boolean;
+    /** 默认展开对应树节点 */
     defaultExpandParent?: boolean;
+    /** 默认展开指定的树节点 */
     defaultExpandedKeys?: Key[];
+    /** （受控）展开指定的树节点 */
     expandedKeys?: Key[];
+    /** （受控）选中复选框的树节点 */
     checkedKeys?: Key[] | {
         checked: Key[];
         halfChecked: Key[];
     };
+    /** 默认选中复选框的树节点 */
     defaultCheckedKeys?: Key[];
+    /** （受控）设置选中的树节点 */
     selectedKeys?: Key[];
+    /** 默认选中的树节点 */
     defaultSelectedKeys?: Key[];
     selectable?: boolean;
+    /** 点击树节点触发 */
     filterAntTreeNode?: (node: AntTreeNode) => boolean;
     loadedKeys?: Key[];
+    /** 设置节点可拖拽（IE>8） */
     draggable?: DraggableFn | boolean | DraggableConfig;
     style?: React.CSSProperties;
     showIcon?: boolean;

package/dist/Tree/TreeNode.d.ts

@@ -18,16 +18,23 @@ export interface TreeNodeProps<TreeDataType extends BasicDataNode = DataNode> {
     dragOverGapBottom?: boolean;
     pos?: string;
     domRef?: Ref<HTMLDivElement>;
+    /** New added in Tree for easy data access */
     data?: TreeDataType;
     isStart?: boolean[];
     isEnd?: boolean[];
     active?: boolean;
     onMouseMove?: React.MouseEventHandler<HTMLDivElement>;
+    /** 设置为叶子节点 (设置了 loadData 时有效)。为 false 时会强制将其作为父节点 */
     isLeaf?: boolean;
+    /** 当树为 checkable 时，设置独立节点是否展示 Checkbox */
     checkable?: boolean;
+    /** 设置节点是否可被选中 */
     selectable?: boolean;
+    /** 禁掉响应 */
     disabled?: boolean;
+    /** 禁掉 checkbox */
     disableCheckbox?: boolean;
+    /** 自定义图标。可接收组件，props 为当前节点 props */
     icon?: IconType;
     switcherIcon?: IconType;
     children?: React.ReactElement;

package/dist/Tree/TreeNode.js

@@ -316,7 +316,7 @@ var InternalTreeNode = class extends import_react.Component {
     // Icon + Title
     this.renderSelector = () => {
       const { dragNodeHighlight } = this.state;
-      const { title, selected, icon, loading, data } = this.props;
+      const { title = defaultTitle, selected, icon, loading, data } = this.props;
       const {
         context: { prefixCls, showIcon, icon: treeIcon, loadData, titleRender }
       } = this.props;
@@ -466,9 +466,6 @@ var InternalTreeNode = class extends import_react.Component {
 };
 var ContextTreeNode = (props) => /* @__PURE__ */ import_react.default.createElement(import_contextTypes.TreeContext.Consumer, null, (context) => /* @__PURE__ */ import_react.default.createElement(InternalTreeNode, { ...props, context }));
 ContextTreeNode.displayName = "TreeNode";
-ContextTreeNode.defaultProps = {
-  title: defaultTitle
-};
 ContextTreeNode.isTreeNode = 1;
 var TreeNode_default = ContextTreeNode;
 // Annotate the CommonJS export names for ESM import in node:

package/dist/Tree/contextTypes.d.ts

@@ -1,4 +1,8 @@
 import React, { Context } from 'react';
+/**
+ * Webpack has bug for import loop, which is not the same behavior as ES module.
+ * When util.js imports the TreeNode for tree generate will cause treeContextTypes be empty.
+ */
 import { DraggableConfig } from './RCTree';
 import { BasicDataNode, DataEntity, DataNode, Direction, EventDataNode, IconType, Key, NodeInstance } from './typings';
 export type NodeMouseEventParams = {

package/dist/Tree/typings.d.ts

@@ -2,6 +2,7 @@ import React, { Component } from 'react';
 import { IconName } from '../Icon';
 import { TreeNodeProps } from './TreeNode';
 export { ScrollTo } from '../VirtualList';
+/** For fieldNames, we provides a abstract interface */
 export interface BasicDataNode {
     checkable?: boolean;
     disabled?: boolean;
@@ -10,6 +11,7 @@ export interface BasicDataNode {
     isLeaf?: boolean;
     selectable?: boolean;
     switcherIcon?: IconType;
+    /** Set style of TreeNode. This is not recommend if you don't have any force requirement */
     className?: string;
     style?: React.CSSProperties;
 }
@@ -72,6 +74,7 @@ export type GetCheckDisabled<RecordType> = (record: RecordType) => boolean;
 export type Direction = 'ltr' | 'rtl' | undefined;
 export interface FieldNames {
     title?: string;
+    /** @private Internal usage for `rc-tree-select`, safe to remove if no need */
     _title?: string[];
     key?: string;
     children?: string;

package/dist/Tree/util.d.ts

@@ -26,13 +26,30 @@ export declare function calcDropPosition<TreeDataType extends BasicDataNode = Da
     dragOverNodeKey: Key;
     dropAllowed: boolean;
 };
+/**
+ * Return selectedKeys according with multiple prop
+ * @param selectedKeys
+ * @param props
+ * @returns [string]
+ */
 export declare function calcSelectedKeys(selectedKeys: Key[], props: TreeProps): Key[];
 export declare function convertDataToTree(treeData: DataNode[], processor?: {
     processProps: (prop: DataNode) => any;
 }): NodeElement[];
+/**
+ * Parse `checkedKeys` to { checkedKeys, halfCheckedKeys } style
+ */
 export declare function parseCheckedKeys(keys: Key[] | {
     checked: Key[];
     halfChecked: Key[];
 }): any;
+/**
+ * If user use `autoExpandParent` we should get the list of parent node
+ * @param keyList
+ * @param keyEntities
+ */
 export declare function conductExpandParent(keyList: Key[], keyEntities: Record<Key, DataEntity>): Key[];
+/**
+ * omit prop
+ */
 export declare function omit<T extends object, K extends keyof T>(obj: T, fields: K[]): Omit<T, K>;

package/dist/Tree/utils/KeyCode.d.ts

@@ -1,110 +1,436 @@
+/**
+ * @ignore
+ * some key-codes definition and utils from closure-library
+ * @author yiminghe@gmail.com
+ */
 declare const KeyCode: {
+    /**
+     * MAC_ENTER
+     */
     MAC_ENTER: number;
+    /**
+     * BACKSPACE
+     */
     BACKSPACE: number;
+    /**
+     * TAB
+     */
     TAB: number;
+    /**
+     * NUMLOCK on FF/Safari Mac
+     */
     NUM_CENTER: number;
+    /**
+     * ENTER
+     */
     ENTER: number;
+    /**
+     * SHIFT
+     */
     SHIFT: number;
+    /**
+     * CTRL
+     */
     CTRL: number;
+    /**
+     * ALT
+     */
     ALT: number;
+    /**
+     * PAUSE
+     */
     PAUSE: number;
+    /**
+     * CAPS_LOCK
+     */
     CAPS_LOCK: number;
+    /**
+     * ESC
+     */
     ESC: number;
+    /**
+     * SPACE
+     */
     SPACE: number;
+    /**
+     * PAGE_UP
+     */
     PAGE_UP: number;
+    /**
+     * PAGE_DOWN
+     */
     PAGE_DOWN: number;
+    /**
+     * END
+     */
     END: number;
+    /**
+     * HOME
+     */
     HOME: number;
+    /**
+     * LEFT
+     */
     LEFT: number;
+    /**
+     * UP
+     */
     UP: number;
+    /**
+     * RIGHT
+     */
     RIGHT: number;
+    /**
+     * DOWN
+     */
     DOWN: number;
+    /**
+     * PRINT_SCREEN
+     */
     PRINT_SCREEN: number;
+    /**
+     * INSERT
+     */
     INSERT: number;
+    /**
+     * DELETE
+     */
     DELETE: number;
+    /**
+     * ZERO
+     */
     ZERO: number;
+    /**
+     * ONE
+     */
     ONE: number;
+    /**
+     * TWO
+     */
     TWO: number;
+    /**
+     * THREE
+     */
     THREE: number;
+    /**
+     * FOUR
+     */
     FOUR: number;
+    /**
+     * FIVE
+     */
     FIVE: number;
+    /**
+     * SIX
+     */
     SIX: number;
+    /**
+     * SEVEN
+     */
     SEVEN: number;
+    /**
+     * EIGHT
+     */
     EIGHT: number;
+    /**
+     * NINE
+     */
     NINE: number;
+    /**
+     * QUESTION_MARK
+     */
     QUESTION_MARK: number;
+    /**
+     * A
+     */
     A: number;
+    /**
+     * B
+     */
     B: number;
+    /**
+     * C
+     */
     C: number;
+    /**
+     * D
+     */
     D: number;
+    /**
+     * E
+     */
     E: number;
+    /**
+     * F
+     */
     F: number;
+    /**
+     * G
+     */
     G: number;
+    /**
+     * H
+     */
     H: number;
+    /**
+     * I
+     */
     I: number;
+    /**
+     * J
+     */
     J: number;
+    /**
+     * K
+     */
     K: number;
+    /**
+     * L
+     */
     L: number;
+    /**
+     * M
+     */
     M: number;
+    /**
+     * N
+     */
     N: number;
+    /**
+     * O
+     */
     O: number;
+    /**
+     * P
+     */
     P: number;
+    /**
+     * Q
+     */
     Q: number;
+    /**
+     * R
+     */
     R: number;
+    /**
+     * S
+     */
     S: number;
+    /**
+     * T
+     */
     T: number;
+    /**
+     * U
+     */
     U: number;
+    /**
+     * V
+     */
     V: number;
+    /**
+     * W
+     */
     W: number;
+    /**
+     * X
+     */
     X: number;
+    /**
+     * Y
+     */
     Y: number;
+    /**
+     * Z
+     */
     Z: number;
+    /**
+     * META
+     */
     META: number;
+    /**
+     * WIN_KEY_RIGHT
+     */
     WIN_KEY_RIGHT: number;
+    /**
+     * CONTEXT_MENU
+     */
     CONTEXT_MENU: number;
+    /**
+     * NUM_ZERO
+     */
     NUM_ZERO: number;
+    /**
+     * NUM_ONE
+     */
     NUM_ONE: number;
+    /**
+     * NUM_TWO
+     */
     NUM_TWO: number;
+    /**
+     * NUM_THREE
+     */
     NUM_THREE: number;
+    /**
+     * NUM_FOUR
+     */
     NUM_FOUR: number;
+    /**
+     * NUM_FIVE
+     */
     NUM_FIVE: number;
+    /**
+     * NUM_SIX
+     */
     NUM_SIX: number;
+    /**
+     * NUM_SEVEN
+     */
     NUM_SEVEN: number;
+    /**
+     * NUM_EIGHT
+     */
     NUM_EIGHT: number;
+    /**
+     * NUM_NINE
+     */
     NUM_NINE: number;
+    /**
+     * NUM_MULTIPLY
+     */
     NUM_MULTIPLY: number;
+    /**
+     * NUM_PLUS
+     */
     NUM_PLUS: number;
+    /**
+     * NUM_MINUS
+     */
     NUM_MINUS: number;
+    /**
+     * NUM_PERIOD
+     */
     NUM_PERIOD: number;
+    /**
+     * NUM_DIVISION
+     */
     NUM_DIVISION: number;
+    /**
+     * F1
+     */
     F1: number;
+    /**
+     * F2
+     */
     F2: number;
+    /**
+     * F3
+     */
     F3: number;
+    /**
+     * F4
+     */
     F4: number;
+    /**
+     * F5
+     */
     F5: number;
+    /**
+     * F6
+     */
     F6: number;
+    /**
+     * F7
+     */
     F7: number;
+    /**
+     * F8
+     */
     F8: number;
+    /**
+     * F9
+     */
     F9: number;
+    /**
+     * F10
+     */
     F10: number;
+    /**
+     * F11
+     */
     F11: number;
+    /**
+     * F12
+     */
     F12: number;
+    /**
+     * NUMLOCK
+     */
     NUMLOCK: number;
+    /**
+     * SEMICOLON
+     */
     SEMICOLON: number;
+    /**
+     * DASH
+     */
     DASH: number;
+    /**
+     * EQUALS
+     */
     EQUALS: number;
+    /**
+     * COMMA
+     */
     COMMA: number;
+    /**
+     * PERIOD
+     */
     PERIOD: number;
+    /**
+     * SLASH
+     */
     SLASH: number;
+    /**
+     * APOSTROPHE
+     */
     APOSTROPHE: number;
+    /**
+     * SINGLE_QUOTE
+     */
     SINGLE_QUOTE: number;
+    /**
+     * OPEN_SQUARE_BRACKET
+     */
     OPEN_SQUARE_BRACKET: number;
+    /**
+     * BACKSLASH
+     */
     BACKSLASH: number;
+    /**
+     * CLOSE_SQUARE_BRACKET
+     */
     CLOSE_SQUARE_BRACKET: number;
+    /**
+     * WIN_KEY
+     */
     WIN_KEY: number;
+    /**
+     * MAC_FF_META
+     */
     MAC_FF_META: number;
+    /**
+     * WIN_IME
+     */
     WIN_IME: number;
+    /**
+     * whether text and modified key is entered at the same time.
+     */
     isTextModifyingKeyEvent: (e: KeyboardEvent) => boolean;
+    /**
+     * whether character is entered.
+     */
     isCharacterKey: (keyCode: number) => boolean;
 };
 export default KeyCode;

package/dist/Tree/utils/conductUtil.d.ts

@@ -4,6 +4,12 @@ interface ConductReturnType {
     halfCheckedKeys: Key[];
 }
 export declare function isCheckDisabled<TreeDataType>(node: TreeDataType): boolean;
+/**
+ * Conduct with keys.
+ * @param keyList current key list
+ * @param keyEntities key - dataEntity map
+ * @param mode `fill` to fill missing key, `clean` to remove useless key
+ */
 export declare function conductCheck<TreeDataType extends BasicDataNode = DataNode>(keyList: Key[], checked: true | {
     checked: false;
     halfCheckedKeys: Key[];

package/dist/Tree/utils/dictUtil.d.ts

@@ -1,4 +1,5 @@
 import { DataNode, Key } from '../typings';
+/** 计算选中范围，只考虑expanded情况以优化性能 */
 export declare function calcRangeKeys<T = DataNode>({ treeData, expandedKeys, startKey, endKey }: {
     treeData: T[];
     expandedKeys: Key[];

package/dist/Tree/utils/pickAttrs.d.ts

@@ -3,4 +3,9 @@ export interface PickConfig {
     data?: boolean;
     attr?: boolean;
 }
+/**
+ * Picker props from exist props with filter
+ * @param props Passed props
+ * @param ariaOnly boolean | { aria?: boolean; data?: boolean; attr?: boolean; } filter config
+ */
 export default function pickAttrs(props: object, ariaOnly?: boolean | PickConfig): {};