vap1 0.4.7 → 0.5.0

package/utils/StringUtil.js

@@ -28,21 +28,39 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFileType = exports.getSuffix = exports.getFileName = exports.getFloat = exports.getInteger = exports.getBoolean = exports.getString = exports.copy = exports.px = exports.replaceAll = exports.className = exports.searchText = exports.spellMatch = exports.trimLower = exports.isBoolean = exports.isBTCAddress = exports.uuid = exports.genKey = exports.isId = exports.isId15 = exports.isId18 = exports.REG_ID_15 = exports.REG_ID_18 = exports.isIP = exports.isIP6 = exports.isIP4 = exports.isPhone = exports.isMAC = exports.isURL = exports.isEmail = exports.isTelePhone = exports.isMobilePhone = exports.REG_PORT = exports.REG_URL = exports.REG_IPV6 = exports.REG_IPV4 = exports.LETTERS = exports.REG_TELEPHONE = exports.REG_PHONE = exports.REG_EMAIL = void 0;
+exports.rise = exports.ratio = exports.getFileType = exports.getSuffix = exports.getFileName = exports.getFloat = exports.getInteger = exports.getBoolean = exports.getString = exports.copy = exports.px = exports.replaceAll = exports.className = exports.searchText = exports.spellMatch = exports.trimLower = exports.isBoolean = exports.isBTCAddress = exports.uuid = exports.genKey = exports.isId = exports.isId15 = exports.isId18 = exports.REG_ID_15 = exports.REG_ID_18 = exports.isIP = exports.isIP6 = exports.isIP4 = exports.isPhone = exports.isMAC = exports.isURL = exports.isEmail = exports.isTelePhone = exports.isMobilePhone = exports.REG_PORT = exports.REG_URL = exports.REG_IPV6 = exports.REG_IPV4 = exports.LETTERS = exports.REG_TELEPHONE = exports.REG_PHONE = exports.REG_EMAIL = void 0;
 var lodash_1 = __importDefault(require("lodash"));
 var dayjs_1 = __importDefault(require("dayjs"));
 var _Support_1 = require("./_Support");
 var py_1 = require("./py");
 Object.defineProperty(exports, "spellMatch", { enumerable: true, get: function () { return py_1.spellMatch; } });
 // import type { MatchPatterns } from './_Support';
+/**
+ * 邮箱地址正则表达式
+ */
 exports.REG_EMAIL = /^(([^<>()[\].,;:\s@"]+(\.[^<>()[\].,;:\s@"]+)*)|(".+"))@(([^<>()[\].,;:\s@"]+\.)+[^<>()[\].,;:\s@"]{2,})$/i;
+/**
+ * 手机号码正则表达式
+ */
 exports.REG_PHONE = /^((\+|00)86)?(1[3-9]|9[28])\d{9}$/; // https://github.com/validatorjs/validator.js/blob/master/src/lib/isMobilePhone.js
+/**
+ * 固定电话正则表达式
+ */
 exports.REG_TELEPHONE = /^0\d{2,3}-[1-9]\d{6,7}$/;
+/**
+ * 英文字母集合
+ */
 exports.LETTERS = new Set(['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z']);
 var IPv4SegmentFormat = '(?:[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])';
 var IPv4AddressFormat = "(".concat(IPv4SegmentFormat, "[.]){3}").concat(IPv4SegmentFormat);
+/**
+ * IPv4地址正则表达式
+ */
 exports.REG_IPV4 = new RegExp("^".concat(IPv4AddressFormat, "$"));
 var IPv6SegmentFormat = '(?:[0-9a-fA-F]{1,4})';
+/**
+ * IPv6地址正则表达式
+ */
 exports.REG_IPV6 = new RegExp('^(' +
     "(?:".concat(IPv6SegmentFormat, ":){7}(?:").concat(IPv6SegmentFormat, "|:)|") +
     "(?:".concat(IPv6SegmentFormat, ":){6}(?:").concat(IPv4AddressFormat, "|:").concat(IPv6SegmentFormat, "|:)|") +
@@ -53,7 +71,13 @@ exports.REG_IPV6 = new RegExp('^(' +
     "(?:".concat(IPv6SegmentFormat, ":){1}(?:(:").concat(IPv6SegmentFormat, "){0,4}:").concat(IPv4AddressFormat, "|(:").concat(IPv6SegmentFormat, "){1,6}|:)|") +
     "(?::((?::".concat(IPv6SegmentFormat, "){0,5}:").concat(IPv4AddressFormat, "|(?::").concat(IPv6SegmentFormat, "){1,7}|:))") +
     ')(%[0-9a-zA-Z-.:]{1,})?$');
+/**
+ * URL地址正则表达式
+ */
 exports.REG_URL = /^https?:\/\/(?:www\.)?[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b(?:[-a-zA-Z0-9()@:%_\+.~#?&\/=]*)$/;
+/**
+ * 端口号正则表达式
+ */
 exports.REG_PORT = /TODO/;
 var macAddress48 = /^(?:[0-9a-fA-F]{2}([-:\s]))([0-9a-fA-F]{2}\1){4}([0-9a-fA-F]{2})$/;
 var macAddress48NoSeparators = /^([0-9a-fA-F]){12}$/;
@@ -63,46 +87,109 @@ var macAddress64NoSeparators = /^([0-9a-fA-F]){16}$/;
 var macAddress64WithDots = /^([0-9a-fA-F]{4}\.){3}([0-9a-fA-F]{4})$/;
 var s4 = function () { return (((1 + Math.random()) * 0x10000) | 0).toString(16).substring(1); };
 /**
- * 是否为一个手机号码
-*/
+ * 判断是否为手机号码
+ * @param txt - 待验证的字符串
+ * @returns 是否为有效的手机号码
+ *
+ * @example
+ * isMobilePhone('13812345678') // => true
+ * isMobilePhone('1381234567') // => false
+ */
 var isMobilePhone = function (txt) { return exports.REG_PHONE.test(txt); };
 exports.isMobilePhone = isMobilePhone;
 /**
- * 是否为一个固话号码
-*/
+ * 判断是否为固定电话号码
+ * @param txt - 待验证的字符串
+ * @returns 是否为有效的固定电话号码
+ *
+ * @example
+ * isTelePhone('010-12345678') // => true
+ * isTelePhone('010123456789') // => false
+ */
 var isTelePhone = function (txt) { return exports.REG_TELEPHONE.test(txt); };
 exports.isTelePhone = isTelePhone;
 /**
- * 是否为一个Email地址
-*/
+ * 判断是否为Email地址
+ * @param txt - 待验证的字符串
+ * @returns 是否为有效的Email地址
+ *
+ * @example
+ * isEmail('user@example.com') // => true
+ * isEmail('invalid.email') // => false
+ */
 var isEmail = function (txt) { return exports.REG_EMAIL.test(txt); };
 exports.isEmail = isEmail;
 /**
- * 是否为一个URL地址
-*/
+ * 判断是否为URL地址
+ * @param txt - 待验证的字符串
+ * @returns 是否为有效的URL地址
+ *
+ * @example
+ * isURL('https://www.example.com') // => true
+ * isURL('invalid-url') // => false
+ */
 var isURL = function (txt) { return exports.REG_URL.test(txt); };
 exports.isURL = isURL;
 /**
- * 是否为一个Mac地址
-*/
+ * 判断是否为MAC地址
+ * @param txt - 待验证的字符串
+ * @returns 是否为有效的MAC地址
+ *
+ * @example
+ * isMAC('00:11:22:33:44:55') // => true
+ * isMAC('00-11-22-33-44-55') // => true
+ * isMAC('001122334455') // => true
+ * isMAC('invalid-mac') // => false
+ */
 var isMAC = function (txt) { return macAddress48.test(txt) || macAddress48WithDots.test(txt)
     || macAddress64.test(txt) || macAddress64WithDots.test(txt)
     || macAddress48NoSeparators.test(txt) || macAddress64NoSeparators.test(txt); };
 exports.isMAC = isMAC;
 /**
- * 是否为一个电话号码，支持固定电话和手机
-*/
+ * 判断是否为电话号码(支持固定电话和手机)
+ * @param txt - 待验证的字符串
+ * @returns 是否为有效的电话号码
+ *
+ * @example
+ * isPhone('13812345678') // => true
+ * isPhone('010-12345678') // => true
+ * isPhone('invalid-phone') // => false
+ */
 var isPhone = function (txt) { return (0, exports.isMobilePhone)(txt) || (0, exports.isTelePhone)(txt); };
 exports.isPhone = isPhone;
+/**
+ * 判断是否为IPv4地址
+ * @param str - 待验证的字符串
+ * @returns 是否为有效的IPv4地址
+ *
+ * @example
+ * isIP4('192.168.1.1') // => true
+ * isIP4('256.1.2.3') // => false
+ */
 var isIP4 = function (str) { return exports.REG_IPV4.test(str); };
 exports.isIP4 = isIP4;
+/**
+ * 判断是否为IPv6地址
+ * @param str - 待验证的字符串
+ * @returns 是否为有效的IPv6地址
+ *
+ * @example
+ * isIP6('2001:0db8:85a3:0000:0000:8a2e:0370:7334') // => true
+ * isIP6('invalid-ipv6') // => false
+ */
 var isIP6 = function (str) { return exports.REG_IPV6.test(str); };
 exports.isIP6 = isIP6;
 /**
- * 判断是否是一个 IP 地址，默认
- * @param str : 要判断的字符串
- * @param version : IP版本，默认为 IP4, 如果要同时 4，6， 传 空字串 ：''
-*/
+ * 判断是否为IP地址
+ * @param str - 待验证的字符串
+ * @param version - IP版本('4'|'6'|'')，默认为'4'。空字符串表示同时支持IPv4和IPv6
+ * @returns 是否为有效的IP地址
+ *
+ * @example
+ * isIP('192.168.1.1', '4') // => true
+ * isIP('2001:0db8:85a3:0000:0000:8a2e:0370:7334', '6') // => true
+ * isIP('192.168.1.1', '') // => true
+ */
 var isIP = function (str, version) {
     if (version === void 0) { version = ''; }
     switch (version) {
@@ -129,10 +216,16 @@ var ID_FACTORS = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
 // 校验码对应值
 var ID_CODES = ["1", "0", "X", "9", "8", "7", "6", "5", "4", "3", '2'];
 /**
- * 判断是否是一个18位身份证号
- * @param txt : 要判断的字符串
- * @param strict : 是否开启严格校验，默认开启
-*/
+ * 判断是否为18位身份证号
+ * @param txt - 待验证的字符串
+ * @param strict - 是否开启严格校验，默认为true
+ * @returns 是否为有效的18位身份证号
+ *
+ * @example
+ * isId18('110101199001011234') // => true
+ * isId18('11010119900101123X') // => true
+ * isId18('invalid-id', false) // => false
+ */
 var isId18 = function (txt, strict) {
     if (strict === void 0) { strict = true; }
     var isFormat = exports.REG_ID_18.test(txt);
@@ -156,12 +249,15 @@ var isId18 = function (txt, strict) {
 };
 exports.isId18 = isId18;
 /**
- * 判断是否是一个15位身份证号
- * @param txt : 要判断的字符串
- * @param strict : 是否开启严格校验，默认开启，
- *  15位身份证号，只会判定省份与年份，不检验哈希，性别
+ * 判断是否为15位身份证号
+ * @param txt - 待验证的字符串
+ * @param strict - 是否开启严格校验，默认为true
+ * @returns 是否为有效的15位身份证号
  *
-*/
+ * @example
+ * isId15('110101900101123') // => true
+ * isId15('invalid-id', false) // => false
+ */
 var isId15 = function (txt, strict) {
     if (strict === void 0) { strict = true; }
     var isFormat = exports.REG_ID_15.test(txt);
@@ -179,10 +275,16 @@ var isId15 = function (txt, strict) {
 };
 exports.isId15 = isId15;
 /**
- * 判断是否是一个身份证号，支持18位和15位
- * @param txt : 要判断的字符串
- * @param strict : 是否开启严格校验，默认开启
-*/
+ * 判断是否为身份证号(支持15位和18位)
+ * @param txt - 待验证的字符串
+ * @param strict - 是否开启严格校验，默认为true
+ * @returns 是否为有效的身份证号
+ *
+ * @example
+ * isId('110101199001011234') // => true
+ * isId('110101900101123') // => true
+ * isId('invalid-id', false) // => false
+ */
 var isId = function (txt, strict) {
     if (strict === void 0) { strict = true; }
     return (0, exports.isId18)(txt, strict) || (0, exports.isId15)(txt, strict);
@@ -191,8 +293,12 @@ exports.isId = isId;
 var MULTIPLIER = Math.pow(2, 20);
 var seenKeys = {};
 /**
- * 生成一个唯一 ID 标识
-*/
+ * 生成唯一ID标识
+ * @returns 生成的唯一ID字符串
+ *
+ * @example
+ * genKey() // => "1a2b3c"
+ */
 var genKey = function () {
     var key = void 0;
     while (key === undefined || seenKeys.hasOwnProperty(key) || !isNaN(+key)) {
@@ -203,32 +309,59 @@ var genKey = function () {
 };
 exports.genKey = genKey;
 /**
- * 生成uuid
-*/
+ * 生成UUID
+ * @returns 生成的UUID字符串
+ *
+ * @example
+ * uuid() // => "550e8400-e29b-41d4-a716-446655440000"
+ */
 var uuid = function () { return s4() + s4() + "-" + s4() + "-" + s4() + "-" + s4() + "-" + s4() + s4() + s4(); };
 exports.uuid = uuid;
 var REG_BTC32 = /^(bc1)[a-z0-9]{25,39}$/;
 var REG_BTC58 = /^(1|3)[A-HJ-NP-Za-km-z1-9]{25,39}$/;
 /**
- * 是否是一个 BTC 地址
-*/
+ * 判断是否为BTC地址
+ * @param str - 待验证的字符串
+ * @returns 是否为有效的BTC地址
+ *
+ * @example
+ * isBTCAddress('1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2') // => true
+ * isBTCAddress('invalid-address') // => false
+ */
 var isBTCAddress = function (str) { return REG_BTC32.test(str) || REG_BTC58.test(str); };
 exports.isBTCAddress = isBTCAddress;
 /**
- * 说明：不能判断 变量类型，为 vap 内置识别方法
- * 可为 Boolean 的有字符串有 0 / 1 / true / false / yes / no
- * 通过 getBoolean 可获取到对应的 bool 值
-*/
+ * 判断字符串是否可以转换为布尔值
+ * @param str - 待验证的字符串
+ * @returns 是否可以转换为布尔值
+ *
+ * @example
+ * isBoolean('true') // => true
+ * isBoolean('yes') // => true
+ * isBoolean('0') // => true
+ * isBoolean('invalid') // => false
+ */
 var isBoolean = function (str) { return _Support_1.TRUE_SET.has(str) || _Support_1.FALSE_SET.has(str); };
 exports.isBoolean = isBoolean;
 /**
- * 清空首尾空格，并小写
-*/
+ * 清空字符串首尾空格并转换为小写
+ * @param str - 输入字符串
+ * @returns 处理后的字符串
+ *
+ * @example
+ * trimLower('  Hello World  ') // => "hello world"
+ */
 var trimLower = function (str) { return lodash_1.default.toLower(lodash_1.default.trim(str)); };
 exports.trimLower = trimLower;
 /**
- * 搜索，用于高亮，通常与 HighLight 结合使用，或只使用 HighLight 组件
-*/
+ * 搜索文本并返回匹配结果，用于高亮显示
+ * @param sentence - 待搜索的文本
+ * @param keyword - 搜索关键词
+ * @returns 匹配结果数组
+ *
+ * @example
+ * searchText('Hello World', 'world') // => [{hit: false, text: 'Hello '}, {hit: true, text: 'World'}]
+ */
 var searchText = function (sentence, keyword) {
     var result = (0, py_1.spellMatch)(sentence, keyword);
     if (result.hit)
@@ -237,14 +370,30 @@ var searchText = function (sentence, keyword) {
 };
 exports.searchText = searchText;
 /**
- * 拼 className
-*/
+ * 合并CSS类名
+ * @param base - 基础类名数组
+ * @param classNameProps - 额外的类名
+ * @returns 合并后的类名字符串
+ *
+ * @example
+ * className(['btn', 'primary'], 'large') // => "btn primary large"
+ */
 var className = function (base, classNameProps) {
     if (classNameProps)
         return __spreadArray(__spreadArray([], __read(base), false), [classNameProps], false).join(' ');
     return base.join(' ');
 };
 exports.className = className;
+/**
+ * 替换字符串中所有匹配的内容
+ * @param text - 原始字符串
+ * @param keyword - 要替换的关键词或正则表达式
+ * @param replaceText - 替换后的文本
+ * @returns 替换后的字符串
+ *
+ * @example
+ * replaceAll('hello world', 'o', '0') // => "hell0 w0rld"
+ */
 var replaceAll = function (text, keyword, replaceText) {
     var reg = lodash_1.default.isRegExp(keyword) ? new RegExp(keyword, 'g') : new RegExp(keyword, "g");
     return lodash_1.default.replace(text, reg, replaceText);
@@ -252,9 +401,15 @@ var replaceAll = function (text, keyword, replaceText) {
 };
 exports.replaceAll = replaceAll;
 /**
- * 试图转px的值
- * 300px -> 300
-*/
+ * 将字符串转换为像素值
+ * @param str - 输入的数字或字符串
+ * @returns 转换后的像素值数字
+ *
+ * @example
+ * px('300px') // => 300
+ * px(300) // => 300
+ * px('invalid') // => 0
+ */
 var px = function (str) {
     if (lodash_1.default.isNumber(str)) {
         return str;
@@ -271,11 +426,15 @@ var px = function (str) {
 };
 exports.px = px;
 /**
- * 复制字符串
-*/
+ * 复制文本到剪贴板
+ * @param text - 要复制的文本
+ * @param onCopied - 复制成功后的回调函数
+ *
+ * @example
+ * copy('Hello World', (text) => console.log(`Copied: ${text}`))
+ */
 var copy = function (text, onCopied) {
     var input = document.createElement('textarea');
-    // input.setAttribute('readonly', 'readonly'); // 防止手机上弹出软键盘
     input.value = text;
     input.setAttribute('value', text);
     document.body.appendChild(input);
@@ -289,8 +448,15 @@ var copy = function (text, onCopied) {
 };
 exports.copy = copy;
 /**
- * 获取字符串
-*/
+ * 获取字符串值，空字符串返回默认值
+ * @param txt - 输入字符串
+ * @param defaultValue - 默认值
+ * @returns 处理后的字符串
+ *
+ * @example
+ * getString('  hello  ') // => "hello"
+ * getString('', 'default') // => "default"
+ */
 var getString = function (txt, defaultValue) {
     var result = lodash_1.default.trim(txt);
     if (result.length)
@@ -300,7 +466,15 @@ var getString = function (txt, defaultValue) {
 exports.getString = getString;
 /**
  * 获取布尔值
-*/
+ * @param key - 输入字符串
+ * @param defaultValue - 默认值
+ * @returns 转换后的布尔值
+ *
+ * @example
+ * getBoolean('true') // => true
+ * getBoolean('yes') // => true
+ * getBoolean('invalid', true) // => true
+ */
 var getBoolean = function (key, defaultValue) {
     if (key === null || key === undefined)
         return defaultValue || false;
@@ -315,8 +489,15 @@ var getBoolean = function (key, defaultValue) {
 };
 exports.getBoolean = getBoolean;
 /**
- * 获取数字
-*/
+ * 获取整数值
+ * @param txt - 输入字符串
+ * @param defaultValue - 默认值
+ * @returns 转换后的整数
+ *
+ * @example
+ * getInteger('123') // => 123
+ * getInteger('invalid', 0) // => 0
+ */
 var getInteger = function (txt, defaultValue) {
     if (txt === null || txt === undefined)
         return defaultValue || 0;
@@ -329,8 +510,15 @@ var getInteger = function (txt, defaultValue) {
 };
 exports.getInteger = getInteger;
 /**
- * 获取浮点数
-*/
+ * 获取浮点数值
+ * @param txt - 输入字符串
+ * @param defaultValue - 默认值
+ * @returns 转换后的浮点数
+ *
+ * @example
+ * getFloat('123.45') // => 123.45
+ * getFloat('invalid', 0) // => 0
+ */
 var getFloat = function (txt, defaultValue) {
     if (txt === null || txt === undefined)
         return defaultValue || 0;
@@ -342,6 +530,14 @@ var getFloat = function (txt, defaultValue) {
     }
 };
 exports.getFloat = getFloat;
+/**
+ * 获取文件名
+ * @param uri - 文件路径
+ * @returns 文件名
+ *
+ * @example
+ * getFileName('/path/to/file.txt') // => "file.txt"
+ */
 var getFileName = function (uri) {
     var idx = lodash_1.default.lastIndexOf(uri, '/');
     if (idx >= 0)
@@ -350,8 +546,13 @@ var getFileName = function (uri) {
 };
 exports.getFileName = getFileName;
 /**
- * 获取文件后缀名，并以小写的形式返回
-*/
+ * 获取文件后缀名
+ * @param fileName - 文件名
+ * @returns 小写的文件后缀名
+ *
+ * @example
+ * getSuffix('image.JPG') // => "jpg"
+ */
 var getSuffix = function (fileName) {
     if (fileName == '' || fileName == null)
         return '';
@@ -360,8 +561,14 @@ var getSuffix = function (fileName) {
 };
 exports.getSuffix = getSuffix;
 /**
- * 获取文件类及 icon
-*/
+ * 获取文件类型和对应的图标
+ * @param fileName - 文件名
+ * @returns [文件类型, 图标名称]
+ *
+ * @example
+ * getFileType('document.pdf') // => ['pdf', 'file-pdf']
+ * getFileType('image.jpg') // => ['image', 'file-image']
+ */
 var getFileType = function (fileName) {
     var type = (0, exports.getSuffix)(fileName);
     if (type == '')
@@ -387,6 +594,8 @@ var getFileType = function (fileName) {
         case 'ppt':
         case 'pptx':
             return ['ppt', 'file-ppt'];
+        case 'xml':
+            return ['xml', 'file-text'];
         case 'zip':
         case 'rar':
         case '7z':
@@ -413,3 +622,41 @@ var getFileType = function (fileName) {
     }
 };
 exports.getFileType = getFileType;
+/**
+ * 计算占比
+ * @param count - 分子
+ * @param total - 分母
+ * @returns 比率(0-1之间的小数)
+ *
+ * @example
+ * ratio(4, 10) // => 0.4
+ * ratio(0, 10) // => 0
+ */
+var ratio = function (count, total) {
+    if (count == 0)
+        return 0;
+    if (total == 0)
+        return 1;
+    return count / total;
+};
+exports.ratio = ratio;
+/**
+ * 计算增长率
+ * @param current - 当前值
+ * @param prev - 上一个值
+ * @returns 增长率(-1到1之间的小数)
+ *
+ * @example
+ * rise(120, 100) // => 0.2
+ * rise(80, 100) // => -0.2
+ */
+var rise = function (current, prev) {
+    if (current == prev)
+        return 0;
+    if (prev == 0)
+        return 1;
+    if (current == 0)
+        return -1;
+    return (current - prev) / prev;
+};
+exports.rise = rise;

package/utils/TreeUtil.js

@@ -80,7 +80,7 @@ var buildFlatTree = function (props, data) {
         return data;
     }
     var parentField = props.parentField, sortField = props.sortField, keyField = props.keyField;
-    var root = data.filter(function (item) { return item[parentField] == (props.rootCode || '0'); });
+    var root = data.filter(function (item) { return item[parentField] == (lodash_1.default.has(props, 'rootCode') ? props.rootCode : '0'); });
     if (sortField) {
         root = lodash_1.default.orderBy(root, sortField, 'asc');
     }
@@ -88,13 +88,25 @@ var buildFlatTree = function (props, data) {
     return root;
 };
 exports.buildFlatTree = buildFlatTree;
+var loopTree = function (tree, callback, position) {
+    if (position === void 0) { position = []; }
+    tree.map(function (node, idx) {
+        callback(node, __spreadArray(__spreadArray([], __read(position), false), [idx], false));
+        if (node.children && node.children.length)
+            loopTree(node.children, callback, __spreadArray(__spreadArray([], __read(position), false), [idx], false));
+    });
+};
 // 高性能树递归搜索
 var search = function (tree, word, titleField) {
     var keyword = (0, StringUtil_1.trimLower)(word);
     if (keyword == '' || keyword.length == 0)
         return { word: null, keyword: null, match: null };
     var searchPos = [];
-    tree.map(function (node, idx) { return searchNode(node, [idx], keyword, searchPos, titleField); });
+    loopTree(tree, function (node, pos) {
+        var hited = (0, py_1.spellHit)(node[titleField], keyword);
+        if (hited.length > 0)
+            searchPos.push(pos.join('-'));
+    });
     var match = new Set();
     searchPos.map(function (pos) {
         var key = pos;
@@ -109,11 +121,3 @@ var search = function (tree, word, titleField) {
     return { word: word, keyword: keyword, match: match };
 };
 exports.search = search;
-var searchNode = function (node, pos, keyword, result, titleField) {
-    var hited = (0, py_1.spellHit)(node[titleField], keyword);
-    if (hited.length >= 0)
-        result.push(pos.join('-'));
-    if (node.children && node.children.length)
-        searchNodes(node.children, pos, keyword, result, titleField);
-};
-var searchNodes = function (data, pos, keyword, result, titleField) { return data.map(function (item, idx) { return searchNode(item, __spreadArray(__spreadArray([], __read(pos), false), [idx], false), keyword, result, titleField); }); };

package/utils/VAP.d.ts

@@ -1,11 +1,36 @@
+/**
+ * VAP 是系统配置工具类，用于读取 xxx_conf 表的配置
+*/
 export type VAP = {
     KEYMAP: Map<string, string>;
     system_version: string;
+    /**
+     * 判断是否存在某个配置
+    */
     has: (key: string) => boolean;
-    getConfig: (key: string) => string;
+    /**
+     * 更新配置
+    */
+    update: (key: string, value: string) => Promise<boolean>;
+    /**
+     * 获取配置 ，不存在时返回 null
+    */
+    getConfig: (key: string) => string | null;
+    /**
+     * 获取字符串配置, 不存在时返回默认值（默认空字符串）
+    */
     getString: (key: string, defaultValue?: string) => string;
+    /**
+     * 获取布尔配置
+    */
     getBoolean: (key: string, defaultValue?: boolean) => boolean;
+    /**
+     * 获取整数配置
+    */
     getInteger: (key: string, defaultValue?: number) => number;
+    /**
+     * 获取浮点数配置
+    */
     getFloat: (key: string, defaultValue?: number) => number;
 };
 declare const _VAP: VAP;