@kdcloudjs/table 1.0.0

package/es/table/utils/tree-data-helpers/StrictTreeDataHelper.js

@@ -0,0 +1,138 @@
+import _createClass from "@babel/runtime-corejs3/helpers/createClass";
+import _extends from "@babel/runtime-corejs3/helpers/extends";
+import _classCallCheck from "@babel/runtime-corejs3/helpers/classCallCheck";
+
+function _createForOfIteratorHelper(o, allowArrayLike) { var it; if (typeof _Symbol === "undefined" || _getIteratorMethod(o) == null) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = _getIterator(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+
+function _unsupportedIterableToArray(o, minLen) { var _context; if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = _sliceInstanceProperty(_context = Object.prototype.toString.call(o)).call(_context, 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; }
+
+import _Set from "@babel/runtime-corejs3/core-js-stable/set";
+import _Map from "@babel/runtime-corejs3/core-js-stable/map";
+import _sliceInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/slice";
+import _Array$from from "@babel/runtime-corejs3/core-js-stable/array/from";
+import _Symbol from "@babel/runtime-corejs3/core-js-stable/symbol";
+import _getIteratorMethod from "@babel/runtime-corejs3/core-js/get-iterator-method";
+import _getIterator from "@babel/runtime-corejs3/core-js/get-iterator";
+import isLeafNode from '../isLeafNode';
+import { arrayUtils } from '../others';
+
+var Wrapper = function Wrapper(input) {
+  _classCallCheck(this, Wrapper);
+
+  _extends(this, input);
+};
+
+var StrictTreeDataHelper = /*#__PURE__*/function () {
+  function StrictTreeDataHelper(opts) {
+    _classCallCheck(this, StrictTreeDataHelper);
+
+    this.opts = opts;
+    this.valueSet = new _Set(opts.value);
+    this.initWrapperTree();
+  }
+
+  _createClass(StrictTreeDataHelper, [{
+    key: "initWrapperTree",
+    value: function initWrapperTree() {
+      var _this = this;
+
+      var getNodeValue = this.opts.getNodeValue;
+      this.rootWrapper = new Wrapper({
+        root: true,
+        children: []
+      });
+      this.wrapperMap = new _Map();
+
+      var dfs = function dfs(parentWrapper, nodes) {
+        var _iterator = _createForOfIteratorHelper(nodes),
+            _step;
+
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var node = _step.value;
+            var wrapper = new Wrapper({
+              parent: parentWrapper,
+              node: node,
+              checked: _this.valueSet.has(getNodeValue(node))
+            });
+
+            _this.wrapperMap.set(getNodeValue(node), wrapper);
+
+            parentWrapper.children.push(wrapper);
+
+            if (!isLeafNode(node)) {
+              wrapper.children = [];
+              dfs(wrapper, node.children);
+            }
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+      };
+
+      dfs(this.rootWrapper, this.opts.tree);
+    }
+  }, {
+    key: "value",
+    get: function get() {
+      return this.opts.value;
+    }
+  }, {
+    key: "isIndeterminate",
+    value: function isIndeterminate(nodeValue) {
+      return false;
+    }
+  }, {
+    key: "isChecked",
+    value: function isChecked(nodeValue) {
+      return this.valueSet.has(nodeValue);
+    }
+  }, {
+    key: "getValueAfterCheck",
+    value: function getValueAfterCheck(nodeValue) {
+      if (!this.isChecked(nodeValue)) {
+        return arrayUtils.merge(this.value, [nodeValue]);
+      }
+
+      return this.value;
+    }
+  }, {
+    key: "getValueAfterUncheck",
+    value: function getValueAfterUncheck(nodeValue) {
+      if (this.isChecked(nodeValue)) {
+        return arrayUtils.diff(this.value, [nodeValue]);
+      }
+
+      return this.value;
+    }
+  }, {
+    key: "getValueAfterToggle",
+    value: function getValueAfterToggle(nodeValue) {
+      if (this.isChecked(nodeValue)) {
+        return this.getValueAfterUncheck(nodeValue);
+      } else {
+        return this.getValueAfterCheck(nodeValue);
+      }
+    }
+  }, {
+    key: "getNode",
+    value: function getNode(nodeValue) {
+      var _a;
+
+      return (_a = this.wrapperMap.get(nodeValue)) === null || _a === void 0 ? void 0 : _a.node;
+    }
+  }, {
+    key: "getCleanValue",
+    value: function getCleanValue() {
+      return this.value;
+    }
+  }]);
+
+  return StrictTreeDataHelper;
+}();
+
+export { StrictTreeDataHelper as default };

package/es/table/utils/tree-data-helpers/TreeDataHelper.d.ts

@@ -0,0 +1,26 @@
+import { AbstractTreeNode } from '../../interfaces';
+export declare type CheckedStrategy = 'all' | 'parent' | 'child';
+export interface TreeDataHelperOptions<N extends AbstractTreeNode> {
+    tree: N[];
+    getNodeValue(node: N): string;
+    value: string[];
+    checkedStrategy: CheckedStrategy;
+    isDetached?(node: N): boolean;
+}
+export default class TreeDataHelper<N extends AbstractTreeNode> {
+    private readonly opts;
+    private readonly valueSet;
+    private wrapperMap;
+    private rootWrapper;
+    constructor(opts: TreeDataHelperOptions<N>);
+    private get value();
+    private isDetached;
+    private initWrapperTree;
+    isIndeterminate(nodeValue: string): boolean;
+    isChecked(nodeValue: string): boolean;
+    getValueAfterCheck(nodeValue: string): string[];
+    getValueAfterUncheck(nodeValue: string): string[];
+    getValueAfterToggle(nodeValue: string): string[];
+    getNode(nodeValue: string): N;
+    getCleanValue(): string[];
+}

package/es/table/utils/tree-data-helpers/TreeDataHelper.js

@@ -0,0 +1,337 @@
+import _sliceInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/slice";
+import _Array$from from "@babel/runtime-corejs3/core-js-stable/array/from";
+import _Symbol from "@babel/runtime-corejs3/core-js-stable/symbol";
+import _getIteratorMethod from "@babel/runtime-corejs3/core-js/get-iterator-method";
+import _getIterator from "@babel/runtime-corejs3/core-js/get-iterator";
+import _createClass from "@babel/runtime-corejs3/helpers/createClass";
+import _extends from "@babel/runtime-corejs3/helpers/extends";
+import _classCallCheck from "@babel/runtime-corejs3/helpers/classCallCheck";
+
+function _createForOfIteratorHelper(o, allowArrayLike) { var it; if (typeof _Symbol === "undefined" || _getIteratorMethod(o) == null) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = _getIterator(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+
+function _unsupportedIterableToArray(o, minLen) { var _context3; if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = _sliceInstanceProperty(_context3 = Object.prototype.toString.call(o)).call(_context3, 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; }
+
+import _Set from "@babel/runtime-corejs3/core-js-stable/set";
+import _Map from "@babel/runtime-corejs3/core-js-stable/map";
+import _concatInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/concat";
+import _filterInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/filter";
+import isLeafNode from '../isLeafNode';
+import { arrayUtils } from '../others';
+import console from '../console';
+
+var Wrapper = function Wrapper(input) {
+  _classCallCheck(this, Wrapper);
+
+  _extends(this, input);
+};
+
+var TreeDataHelper = /*#__PURE__*/function () {
+  function TreeDataHelper(opts) {
+    var _this = this;
+
+    _classCallCheck(this, TreeDataHelper);
+
+    this.isDetached = function (node) {
+      var _a, _b, _c;
+
+      return (_c = (_b = (_a = _this.opts).isDetached) === null || _b === void 0 ? void 0 : _b.call(_a, node)) !== null && _c !== void 0 ? _c : false;
+    };
+
+    this.opts = opts;
+    this.valueSet = new _Set(opts.value);
+    this.initWrapperTree();
+  }
+
+  _createClass(TreeDataHelper, [{
+    key: "value",
+    get: function get() {
+      return this.opts.value;
+    }
+  }, {
+    key: "initWrapperTree",
+    value: function initWrapperTree() {
+      var valueSet = new _Set(this.value);
+      this.rootWrapper = new Wrapper({
+        root: true,
+        children: []
+      });
+      this.wrapperMap = new _Map();
+      var getNodeValue = this.opts.getNodeValue;
+      var isDetached = this.isDetached,
+          wrapperMap = this.wrapperMap;
+      dfs(this.rootWrapper, this.opts.tree, false);
+
+      function dfs(parentWrapper, nodes, inheritParentChecked) {
+        // allChildrenChecked 先默认设置为 true
+        // dfs 过程中可能会更新 allChildrenChecked
+        parentWrapper.allChildrenChecked = true;
+
+        if (process.env.NODE_ENV !== 'production') {
+          if (nodes.every(isDetached)) {
+            console.warn('TreeDataHelper 检测到部分节点的下所有子节点均为 detached 状态，这将导致该节点变为「无效节点」', parentWrapper.node);
+          }
+        }
+
+        var _iterator = _createForOfIteratorHelper(nodes),
+            _step;
+
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var node = _step.value;
+            var detached = isDetached(node);
+            var exactChecked = valueSet.has(getNodeValue(node));
+
+            if (exactChecked && !detached) {
+              parentWrapper.anyDescendentsChecked = true;
+            }
+
+            var parentChecked = !detached && inheritParentChecked;
+            var checked = exactChecked || parentChecked;
+            var wrapper = new Wrapper({
+              parent: parentWrapper,
+              node: node,
+              checked: checked,
+              exactChecked: exactChecked,
+              parentChecked: parentChecked,
+              anyDescendentsChecked: checked,
+              detached: detached
+            });
+            wrapperMap.set(getNodeValue(node), wrapper);
+            parentWrapper.children.push(wrapper);
+
+            if (!isLeafNode(node)) {
+              wrapper.children = [];
+              dfs(wrapper, node.children, checked);
+
+              if (wrapper.anyDescendentsChecked && !detached) {
+                parentWrapper.anyDescendentsChecked = true;
+              }
+
+              if (wrapper.allChildrenChecked) {
+                wrapper.checked = true; // 当一个节点因为「子节点被全选」而变为 checked 时，我们需要更新子节点的 parentChecked 字段
+
+                var _iterator2 = _createForOfIteratorHelper(wrapper.children),
+                    _step2;
+
+                try {
+                  for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+                    var child = _step2.value;
+
+                    if (!child.detached) {
+                      child.parentChecked = true;
+                    }
+                  }
+                } catch (err) {
+                  _iterator2.e(err);
+                } finally {
+                  _iterator2.f();
+                }
+              }
+            }
+
+            if (!wrapper.checked && !detached) {
+              parentWrapper.allChildrenChecked = false;
+            }
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+      }
+    }
+  }, {
+    key: "isIndeterminate",
+    value: function isIndeterminate(nodeValue) {
+      var wrapper = this.wrapperMap.get(nodeValue);
+      return !wrapper.checked && wrapper.anyDescendentsChecked;
+    }
+  }, {
+    key: "isChecked",
+    value: function isChecked(nodeValue) {
+      var wrapper = this.wrapperMap.get(nodeValue);
+      return wrapper.checked;
+    }
+  }, {
+    key: "getValueAfterCheck",
+    value: function getValueAfterCheck(nodeValue) {
+      if (this.isChecked(nodeValue)) {
+        return this.getCleanValue();
+      }
+
+      var nextValue = arrayUtils.merge(this.value, [nodeValue]);
+      return new TreeDataHelper(_extends(_extends({}, this.opts), {
+        value: nextValue
+      })).getCleanValue();
+    }
+  }, {
+    key: "getValueAfterUncheck",
+    value: function getValueAfterUncheck(nodeValue) {
+      var _context;
+
+      if (!this.isChecked(nodeValue)) {
+        return this.getCleanValue();
+      }
+
+      var wrapper = this.wrapperMap.get(nodeValue);
+      var getNodeValue = this.opts.getNodeValue;
+      var appendArray = getAppendArray(wrapper);
+      var removeSet = getRemoveSet(wrapper);
+      var nextValue = arrayUtils.diff(_concatInstanceProperty(_context = this.value).call(_context, appendArray), removeSet);
+      return new TreeDataHelper(_extends(_extends({}, this.opts), {
+        value: nextValue
+      })).getCleanValue();
+
+      function getAppendArray(startWrapper) {
+        var result = [];
+        var current = startWrapper;
+
+        while (current.parentChecked && !current.detached) {
+          var _iterator3 = _createForOfIteratorHelper(current.parent.children),
+              _step3;
+
+          try {
+            for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+              var sibling = _step3.value;
+
+              if (sibling === current || sibling.exactChecked || sibling.detached) {
+                continue;
+              }
+
+              result.push(getNodeValue(sibling.node));
+            }
+          } catch (err) {
+            _iterator3.e(err);
+          } finally {
+            _iterator3.f();
+          }
+
+          current = current.parent;
+        }
+
+        return result;
+      }
+
+      function getRemoveSet(startWrapper) {
+        var result = new _Set();
+        var wrapper = startWrapper; // 不断向上收集选中的父节点
+
+        while (true) {
+          result.add(getNodeValue(wrapper.node));
+
+          if (wrapper.detached || !wrapper.parentChecked) {
+            break;
+          }
+
+          wrapper = wrapper.parent;
+        }
+
+        function dfs(wrappers) {
+          if (wrappers == null) {
+            return;
+          }
+
+          var _iterator4 = _createForOfIteratorHelper(wrappers),
+              _step4;
+
+          try {
+            for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+              var _wrapper = _step4.value;
+
+              if (_wrapper.detached || !_wrapper.checked) {
+                continue;
+              }
+
+              result.add(getNodeValue(_wrapper.node));
+
+              if (!isLeafNode(_wrapper) && _wrapper.anyDescendentsChecked) {
+                dfs(_wrapper.children);
+              }
+            }
+          } catch (err) {
+            _iterator4.e(err);
+          } finally {
+            _iterator4.f();
+          }
+        } // 收集所有的子孙节点
+
+
+        dfs(startWrapper.children);
+        return result;
+      }
+    }
+  }, {
+    key: "getValueAfterToggle",
+    value: function getValueAfterToggle(nodeValue) {
+      if (this.isChecked(nodeValue)) {
+        return this.getValueAfterUncheck(nodeValue);
+      } else {
+        return this.getValueAfterCheck(nodeValue);
+      }
+    }
+  }, {
+    key: "getNode",
+    value: function getNode(nodeValue) {
+      var _a;
+
+      return (_a = this.wrapperMap.get(nodeValue)) === null || _a === void 0 ? void 0 : _a.node;
+    }
+  }, {
+    key: "getCleanValue",
+    value: function getCleanValue() {
+      var _context2,
+          _this2 = this;
+
+      var _this$opts = this.opts,
+          checkedStrategy = _this$opts.checkedStrategy,
+          getNodeValue = _this$opts.getNodeValue;
+
+      var result = _filterInstanceProperty(_context2 = this.value).call(_context2, function (nodeValue) {
+        return !_this2.wrapperMap.has(nodeValue);
+      });
+
+      dfs(this.rootWrapper.children);
+      return result;
+
+      function dfs(wrappers) {
+        var _iterator5 = _createForOfIteratorHelper(wrappers),
+            _step5;
+
+        try {
+          for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+            var wrapper = _step5.value;
+
+            if (wrapper.checked) {
+              if (checkedStrategy === 'all') {
+                result.push(getNodeValue(wrapper.node));
+              } else if (checkedStrategy === 'parent') {
+                if (!wrapper.parentChecked) {
+                  result.push(getNodeValue(wrapper.node));
+                }
+              } else {
+                // checkedStrategy === 'child'
+                if (isLeafNode(wrapper)) {
+                  result.push(getNodeValue(wrapper.node));
+                }
+              }
+            }
+
+            if (!isLeafNode(wrapper)) {
+              dfs(wrapper.children);
+            }
+          }
+        } catch (err) {
+          _iterator5.e(err);
+        } finally {
+          _iterator5.f();
+        }
+      }
+    }
+  }]);
+
+  return TreeDataHelper;
+}();
+
+export { TreeDataHelper as default };

package/lib/_utils/arrayUtil.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 检查数组value的值是否唯一
+ * @param value 需要检查值是否唯一的数组
+ */
+export declare const isArrayValueRepeat: (value: any[]) => boolean;

package/lib/_utils/arrayUtil.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isArrayValueRepeat = void 0;
+
+/**
+ * 检查数组value的值是否唯一
+ * @param value 需要检查值是否唯一的数组
+ */
+var isArrayValueRepeat = function isArrayValueRepeat(value) {
+  var hash = {};
+
+  for (var i in value) {
+    if (hash[value[i]]) {
+      return true;
+    }
+
+    hash[value[i]] = true;
+  }
+
+  return false;
+};
+
+exports.isArrayValueRepeat = isArrayValueRepeat;

package/lib/_utils/devwarning.d.ts

@@ -0,0 +1 @@
+export default function (valid: boolean, component: string, message: string): void;

package/lib/_utils/devwarning.js

@@ -0,0 +1,21 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = _default;
+
+var _concat = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/concat"));
+
+var warned = {};
+
+function _default(valid, component, message) {
+  if (process.env.NODE_ENV !== 'production' && valid && !warned[message]) {
+    var _context;
+
+    warned[message] = true;
+    console.warn((0, _concat.default)(_context = "Warning: [kd-ui]-".concat(component, ": ")).call(_context, message));
+  }
+}

package/lib/_utils/formatUtil.d.ts

@@ -0,0 +1,46 @@
+export interface FormatParam {
+    mask?: string;
+    zeroShow?: boolean;
+    decimalLength?: number;
+    showDecimalTailZero?: boolean;
+    isRound?: boolean;
+    symbol?: string;
+    code?: string;
+}
+export interface EditFormatParam {
+    zeroShow?: boolean;
+    decimalLength?: number;
+    showDecimalTailZero?: boolean;
+    roundMethod?: string;
+    symbol?: string;
+}
+/**
+ * [数值类型格式化]
+ * @param  {[type]}  num                              [待格式化的数字]
+ * @param  {String}  mask                             [数值掩码
+ * 0：必须输入数字（0—9）
+ * 9：可选择输入数字（0—9）或空格
+ * #：可选择输入数字（0—9） 递归
+ * .: 小数点
+ * ,: 千位符
+ * %: 对最终值除以100处理
+ * %%: 对最终值不做处理
+ * //A: [a-zA-Z0-9]
+ * //S: [a-zA-Z]
+ * //&：必须输入任一字符或空格
+ * //C：可选择输入任一字符或空格
+ * $: 货币
+ * ]
+ * @param  {Boolean} zeroShow                         [为零显示]
+ * @param  {[type]}  decimalLength                    [小数精度的位数]
+ * @param  {Boolean} showDecimalTailZero              [是否显示尾部零]
+ * @return                                            [格式化后的数值]
+ */
+export declare function formatNumber(num: string | number, formatParams: FormatParam): string;
+/**
+ * 格式化数字字段编辑态的值
+ * 不支持掩码的格式化信息
+ * @param {*} num
+ * @param {*} param
+ */
+export declare function formatEditNumber(num: number | string, { zeroShow, decimalLength, showDecimalTailZero, roundMethod, symbol }: EditFormatParam): string;