@qsxy/element-plus-react 1.0.0-next.2 → 1.0.0-next.21

package/dist/Cascader/Utils.js

@@ -1,83 +1,12 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/Cascader/Utils.ts
-var Utils_exports = {};
-__export(Utils_exports, {
-  reOrgTree: () => reOrgTree,
-  toArray: () => toArray
-});
-module.exports = __toCommonJS(Utils_exports);
-var import_cloneDeep = __toESM(require("lodash/cloneDeep"));
-var import_omit = __toESM(require("lodash/omit"));
-var import_Util = require("../Util");
-var toArray = (val, separator = "/") => {
-  if ((0, import_Util.isNotEmpty)(val)) {
-    if (typeof val === "string") {
+import { isNotEmpty } from "../Util";
+export var toArray = function toArray(val) {
+  var separator = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '/';
+  if (isNotEmpty(val)) {
+    if (typeof val === 'string') {
       return val.split(separator);
     } else if (val instanceof Array) {
       return val;
     }
   }
   return [];
-};
-var reOrgTree = (treeData, level, { valueKey = "value", labelKey = "label", leafKey = "leaf", childrenKey = "children" }, { valueKey: treeValueKey = "key", labelKey: treeLabelKey = "title", childrenKey: treeChildrenKey = "children" }, plainData = [], parent = null) => {
-  return treeData.map((node) => {
-    if (node[childrenKey]) {
-      node[childrenKey] = reOrgTree(
-        node[childrenKey],
-        level,
-        { valueKey, labelKey, leafKey, childrenKey },
-        { valueKey: treeValueKey, labelKey: treeLabelKey, childrenKey: treeChildrenKey },
-        plainData,
-        (0, import_omit.default)((0, import_cloneDeep.default)(node), childrenKey)
-      );
-    }
-    const id = (0, import_Util.randomCode)(11);
-    plainData.push({
-      __id: id,
-      __level: level,
-      __pId: (parent == null ? void 0 : parent.__id) ?? "0",
-      [valueKey]: node[treeValueKey],
-      [labelKey]: node[treeLabelKey],
-      [leafKey]: false,
-      treeChildren: Object.prototype.hasOwnProperty.call(node, treeChildrenKey),
-      ...parent != null ? { parent } : {}
-    });
-    return {
-      ...node,
-      __id: id,
-      __pId: (parent == null ? void 0 : parent.__id) ?? "0"
-    };
-  });
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  reOrgTree,
-  toArray
-});
+};

package/dist/Cascader/index.d.ts

@@ -1,2 +1,2 @@
 export { default as Cascader } from './Cascader';
-export type { CascaderMenuProps, CascaderProps, TreeMenuProps } from './typings';
+export type { CascaderMenuProps, CascaderProps } from './typings';

package/dist/Cascader/index.js

@@ -1,39 +1 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/Cascader/index.ts
-var Cascader_exports = {};
-__export(Cascader_exports, {
-  Cascader: () => import_Cascader.default
-});
-module.exports = __toCommonJS(Cascader_exports);
-var import_Cascader = __toESM(require("./Cascader"));
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  Cascader
-});
+export { default as Cascader } from "./Cascader";

package/dist/Cascader/typings.d.ts

@@ -1,79 +1,143 @@
 import React from 'react';
-import { InputRef } from '../Input';
+import { InputRef } from '../Input/typings';
 import { PopperOptions } from '../Popper';
-import { DataNode, DirectoryTreeProps, Key } from '../Tree';
 import { AnimationEventProps, BaseProps, FormControlBaseProps, NativeProps } from '../types/common';
 export type ValueType = string[] | string[][];
-export interface CascaderProps<V = ValueType, S = DataNode> extends Omit<FormControlBaseProps<V>, 'onChange' | 'value' | 'defaultValue'>, BaseProps, NativeProps, AnimationEventProps, PopperOptions, Omit<DirectoryTreeProps<S>, 'children' | 'style' | 'expandedKeys' | 'className' | 'readOnly' | 'disabled'> {
+export interface CascaderProps<V = ValueType, S = any> extends Omit<FormControlBaseProps<V>, 'onChange' | 'value' | 'defaultValue'>, BaseProps, NativeProps, AnimationEventProps, PopperOptions {
+    /** 初始值 */
     defaultValue?: ValueType;
+    /** 值（可控） */
     value?: ValueType;
+    /** 可选项数据源，键名可通过 Props 属性配置 */
     options?: any[];
+    /** 配置选项 */
     props?: CascaderMenuProps;
-    treeMenuProps?: TreeMenuProps;
+    /** 是否禁用 */
     disabled?: boolean;
+    /** 是否可以清空选项 */
     clearable?: boolean;
+    /** 输入框中是否显示选中值的完整路径 */
     showAllLevels?: boolean;
+    /** 用于分隔选项的字符 */
     separator?: string;
+    /** 是否可搜索 */
     filterable?: boolean;
+    /** 自定义搜索方法 */
     filterMethod?: (val: ValueType, searchText: string) => boolean;
+    /** 占位符 */
     placeholder?: string;
+    /** 选项为空时显示的文字 */
     noDataText?: string;
+    /** 搜索条件无匹配时显示的文字 */
     noMatchText?: string;
+    /** 是否正在从远程获取数据 */
     loading?: boolean;
+    /** 远程加载时显示的文字 */
     loadingText?: string;
+    /**  */
     required?: boolean;
+    /** 表单校验错误提示 */
     error?: boolean;
+    /** 表单校验警告提示 */
     warning?: boolean;
+    /** 多选时是否将选中值按文字的形式展示 */
     collapseTags?: boolean;
+    /** 需要显示的 Tag 的最大数量 只有当 collapseTags 设置为 true 时才会生效。 */
     maxCollapseTags?: number;
+    /** 当鼠标悬停于折叠标签的文本时，是否显示所有选中的标签。 要使用此属性，collapseTags属性必须设定为 true */
     collapseTagsTooltip?: boolean;
+    /** 鼠标悬停于折叠标签的文本格式化函数， 要使用此属性，collapseTags属性必须设定为 true */
     collapseTips?: (collapseNum: number, total: number) => string;
+    /** 是否纯文本模式，即无边框 */
     plain?: boolean;
+    /** 输入框头部内容，只对 type="text" 有效 */
     prefix?: React.ReactElement<any> | string | number;
+    /** 输入框尾部内容，只对 type="text" 有效 */
     suffix?: React.ReactElement<any> | string | number;
+    /** 输入框前置内容，只对 type="text" 有效 */
     prepend?: React.ReactElement<any> | string | number;
+    /** 输入框后置内容，只对 type="text" 有效 */
     append?: React.ReactElement | string | number;
-    expandedKeys?: Key[][];
     lable?: string;
+    /** 是否追加到body下 */
     appendToBody?: boolean;
+    /** 选中值发生变化时触发 */
     onChange?: (value: ValueType, level?: number, label?: string | string[], node?: S[] | S[][]) => void;
+    /** 是否可以选择 */
     shouldSelect?: (node?: object, level?: number) => boolean;
     labelFormatter?: (level?: number, node?: object[]) => string;
 }
 export interface CascaderMenuProps {
+    /** 次级菜单的展开方式 */
     expandTrigger?: 'click' | 'hover';
+    /** 是否多选 */
     multiple?: boolean;
+    /** 是否严格的遵守父子节点不互相关联 */
     checkStrictly?: boolean;
+    /** 在选中节点改变时，是否返回由该节点所在的各级菜单的值所组成的数组，若设置 false，则只返回该节点的值 */
     emitPath?: boolean;
+    /** 是否动态加载子节点，需与 lazyLoad 方法结合使用 */
     lazy?: boolean;
-    lazyLoad?: (node: object, resolve?: (value: object[], isTree?: boolean) => void, reject?: () => void) => void;
-    valueKey?: string;
-    labelKey?: string;
-    childrenKey?: string;
-    disabledKey?: string;
-    leafKey?: string;
-}
-export interface TreeMenuProps {
+    /** 加载动态数据的方法，仅在 lazy 为 true 时有效 */
+    lazyLoad?: (node: object, resolve?: (value: object[]) => void, reject?: () => void) => void;
+    /** 指定选项的值为选项对象的某个属性值 */
     valueKey?: string;
+    /** 指定选项标签为选项对象的某个属性值 */
     labelKey?: string;
+    /** 指定选项的子选项为选项对象的某个属性值 */
     childrenKey?: string;
+    /** 指定选项的禁用为选项对象的某个属性值 */
     disabledKey?: string;
+    /** 指定选项的叶子节点的标志位为选项对象的某个属性值 */
     leafKey?: string;
 }
 export interface CascaderRef {
     inputInstance?: InputRef;
     setLabel: (label: string) => void;
     onClear: () => void;
+    /** 重置懒加载的节点，适用于动态懒加载配置 */
     resetNodes: () => void;
     setVisible: (visible: boolean) => void;
 }
 export interface OptionNode extends Object {
+    /**
+     * 主键
+     * @private
+     */
     __id: string;
+    /**
+     * 父级节点ID
+     * @private
+     */
     __pId: string;
+    /**
+     * 层级
+     * @private
+     */
     __level?: number;
+    /**
+     * 是否叶子节点
+     * @private
+     */
     __leaf?: boolean;
+    /**
+     * 是否已勾选
+     * @private
+     */
     __checked?: boolean;
+    /**
+     * 是否半选
+     * @private
+     */
     __indeterminate?: boolean;
+    /**
+     * 时子节点集合
+     * @private
+     */
     children?: OptionNode[];
+    /**
+     * 树形组件时子节点集合
+     * @private
+     */
     treeChildren?: boolean;
 }

package/dist/Cascader/typings.js

@@ -1,17 +1 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/Cascader/typings.ts
-var typings_exports = {};
-module.exports = __toCommonJS(typings_exports);
+export {};

package/dist/Cascader/useCascader.d.ts

@@ -1,29 +1,87 @@
 import { Key } from '../Tree';
 import { CascaderProps, OptionNode } from './typings';
 export declare const useCascader: (initialData: object[], props: CascaderProps, value: string[] | string[][]) => {
+    /** 最高层级 */
     allLevel: number;
+    /** 选项数据 */
     optionData: Record<string, OptionNode[]>;
-    storeOptionData: (nodes: object[], level: number, parent: OptionNode, { isTree, isCover }: {
-        isTree?: boolean;
+    /**
+     * 懒加载时存储option
+     * @param nodes
+     * @param level 层级
+     */
+    storeOptionData: (nodes: object[], level: number, parent: OptionNode, { isCover }: {
         isCover?: boolean;
     }) => OptionNode[];
+    /**
+     * 获取选中的值
+     * @param level 层级
+     * @returns
+     */
     getSelectedValue: () => string[];
+    /**
+     * 获取任意层级选中的值
+     * @param level 层级
+     * @returns
+     */
     getValueOfLevel: (level?: number) => string;
+    /**
+     * 获取选中的文本
+     * @param level 层级
+     * @returns
+     */
     getSelectedLabel: (labelFormatter?: (node?: OptionNode[]) => string) => string;
+    /**
+     * 设置任意层级节点的标签
+     * @param level 层级
+     * @param value
+     */
     setSelectedNode: (level: number, node: OptionNode) => void;
     setSelectedValue: (level: number, val: string) => void;
     getSelectedNode: () => OptionNode[];
+    /**
+     * 设置选中节点
+     * @param level 层级
+     * @param node 当前节点
+     * @param checked 是否选中
+     */
     setCheckedNode: (level: number, node: OptionNode, checked: boolean) => void;
     getCheckedNodes: () => OptionNode[][];
     getCheckedValue: () => string[][];
     getCheckedLabel: () => any[][];
     loopGetParent: (level: number, node: OptionNode, result?: OptionNode[]) => OptionNode[];
+    /**
+     * 获取任意节点的option数据
+     * @param level 层级
+     * @returns
+     */
     getOptions: (level: number) => OptionNode[];
+    /** 清空值 */
     clearSelected: () => void;
+    /**
+     * 设置节点是否为叶子节点
+     * @param node
+     * @param isLeaf
+     */
     setNodeLeaf: (node: OptionNode, isLeaf: boolean) => void;
+    /**
+     * 获取数据类型
+     * @param level 层级
+     * @returns
+     */
     getDataType: (level: number) => any;
-    getTreeData: (level: number) => any[];
+    /**
+     * 获取扩展key
+     * @param level 层级
+     * @returns
+     */
     getExpandedKeys: (level: number) => Key[];
+    /**
+     * 设置扩展key
+     * @param level 层级
+     * @param keys
+     * @returns
+     */
     setExpandedKeys: (level: number, keys: Key[]) => void;
     handleSearch: (searchText: string) => OptionNode[][];
     resetNodes: () => void;