@qimen-lab/core 0.1.1

package/dist/utils/object/properties.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 将源对象中的定义值复制到目标对象
+ *
+ * 此函数会遍历源对象的属性，如果属性值不是 undefined，
+ * 则将其复制到目标对象中。对于对象类型的属性，会进行递归复制。
+ *
+ * @param source 源对象，从中复制属性
+ * @param target 目标对象，接收源对象的属性
+ * @returns 返回更新后的目标对象
+ */
+export declare function copyIfDefined(source: Record<string, any>, target: Record<string, any>): Record<string, any>;
+/**
+ * 递归替换目标对象的成员
+ *
+ * 该函数用于将源对象中的所有成员递归地替换到目标对象中。如果遇到相同名称的成员，
+ * 且两者都是对象，则会递归地进行替换；否则，会直接用源对象的成员覆盖目标对象的成员
+ *
+ * @param source 源对象，其成员将被复制到目标对象中
+ * @param target 目标对象，其成员将被源对象的成员替换
+ * @param maxDepth 最大递归深度，默认为10，以防止无限递归
+ * @param currentDepth 当前递归深度，初始调用时通常不需要设置
+ * @throws 如果超过最大递归深度或源和目标不是对象，将抛出错误
+ */
+export declare function replaceMembers(source: Record<string, any>, target: Record<string, any>, maxDepth?: number, currentDepth?: number): void;
+/**
+ * 从对象中获取嵌套值
+ *
+ * 根据提供的路径字符串从对象中获取嵌套的值，路径使用点号分隔
+ *
+ * @param obj 要从中获取值的对象
+ * @param path 属性路径，例如 "a.b.c" 表示 obj.a.b.c
+ * @returns 如果路径存在则返回对应的值，否则返回 undefined
+ */
+export declare function getNestedValue(obj: Record<string, any>, path: string): any;
+/**
+ * 设置对象的嵌套值
+ *
+ * 根据提供的路径字符串在对象中设置嵌套的值，路径使用点号分隔
+ * 如果路径中的中间属性不存在，会自动创建对象
+ *
+ * @param obj 要设置值的对象
+ * @param path 属性路径，例如 "a.b.c" 表示 obj.a.b.c
+ * @param value 要设置的值
+ *
+ * @example
+ * const obj = {};
+ * setNestedValue(obj, 'a.b.c', 'value');
+ * console.log(obj); // { a: { b: { c: 'value' } } }
+ */
+export declare function setNestedValue(obj: Record<string, any>, path: string, value: any): void;
+/**
+ * 销毁对象的成员
+ *
+ * 遍历指定的成员列表，对每个成员执行销毁操作（如果存在 destroy 方法），
+ * 然后递归销毁其子对象的成员，最后删除该成员
+ *
+ * @param obj 要销毁成员的对象
+ * @param members 要销毁的成员名称列表
+ */
+export declare function destroyMembers(obj: Record<string, any>, members: string[]): void;
+//# sourceMappingURL=properties.d.ts.map

package/dist/utils/object/properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../../../src/utils/object/properties.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAcrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,QAAQ,GAAE,MAAW,EACrB,YAAY,GAAE,MAAU,GACzB,IAAI,CAYN;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAY1E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAkBvF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAmBhF"}

package/dist/utils/object/properties.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyIfDefined = copyIfDefined;
+exports.replaceMembers = replaceMembers;
+exports.getNestedValue = getNestedValue;
+exports.setNestedValue = setNestedValue;
+exports.destroyMembers = destroyMembers;
+const base_1 = require("./base");
+/**
+ * 将源对象中的定义值复制到目标对象
+ *
+ * 此函数会遍历源对象的属性，如果属性值不是 undefined，
+ * 则将其复制到目标对象中。对于对象类型的属性，会进行递归复制。
+ *
+ * @param source 源对象，从中复制属性
+ * @param target 目标对象，接收源对象的属性
+ * @returns 返回更新后的目标对象
+ */
+function copyIfDefined(source, target) {
+    for (const key in source) {
+        if (source.hasOwnProperty(key)) {
+            if ((0, base_1.isObject)(source[key])) {
+                if (!target.hasOwnProperty(key)) {
+                    target[key] = {};
+                }
+                copyIfDefined(source[key], target[key]);
+            }
+            else if (source[key] !== undefined) {
+                target[key] = source[key];
+            }
+        }
+    }
+    return target;
+}
+/**
+ * 递归替换目标对象的成员
+ *
+ * 该函数用于将源对象中的所有成员递归地替换到目标对象中。如果遇到相同名称的成员，
+ * 且两者都是对象，则会递归地进行替换；否则，会直接用源对象的成员覆盖目标对象的成员
+ *
+ * @param source 源对象，其成员将被复制到目标对象中
+ * @param target 目标对象，其成员将被源对象的成员替换
+ * @param maxDepth 最大递归深度，默认为10，以防止无限递归
+ * @param currentDepth 当前递归深度，初始调用时通常不需要设置
+ * @throws 如果超过最大递归深度或源和目标不是对象，将抛出错误
+ */
+function replaceMembers(source, target, maxDepth = 10, currentDepth = 0) {
+    for (const key in source) {
+        if (source.hasOwnProperty(key)) {
+            // 如果源和目标的当前成员都是对象，则递归替换成员
+            if ((0, base_1.isObject)(source[key]) && (0, base_1.isObject)(target[key])) {
+                replaceMembers(source[key], target[key], maxDepth, currentDepth + 1);
+            }
+            else {
+                // 直接用源对象的成员覆盖目标对象的成员
+                target[key] = source[key];
+            }
+        }
+    }
+}
+/**
+ * 从对象中获取嵌套值
+ *
+ * 根据提供的路径字符串从对象中获取嵌套的值，路径使用点号分隔
+ *
+ * @param obj 要从中获取值的对象
+ * @param path 属性路径，例如 "a.b.c" 表示 obj.a.b.c
+ * @returns 如果路径存在则返回对应的值，否则返回 undefined
+ */
+function getNestedValue(obj, path) {
+    const keys = path.split('.');
+    let result = obj;
+    for (const key of keys) {
+        if (result && result.hasOwnProperty(key)) {
+            result = result[key];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return result;
+}
+/**
+ * 设置对象的嵌套值
+ *
+ * 根据提供的路径字符串在对象中设置嵌套的值，路径使用点号分隔
+ * 如果路径中的中间属性不存在，会自动创建对象
+ *
+ * @param obj 要设置值的对象
+ * @param path 属性路径，例如 "a.b.c" 表示 obj.a.b.c
+ * @param value 要设置的值
+ *
+ * @example
+ * const obj = {};
+ * setNestedValue(obj, 'a.b.c', 'value');
+ * console.log(obj); // { a: { b: { c: 'value' } } }
+ */
+function setNestedValue(obj, path, value) {
+    const keys = path.split('.');
+    let result = obj;
+    for (let i = 0; i < keys.length - 1; i++) {
+        const key = keys[i];
+        // 如果当前键不存在或不是对象，则创建一个新对象
+        if (!result.hasOwnProperty(key) ||
+            result[key] === null ||
+            typeof result[key] !== 'object') {
+            result[key] = {};
+        }
+        result = result[key];
+    }
+    // 设置最后一个键的值
+    result[keys[keys.length - 1]] = value;
+}
+/**
+ * 销毁对象的成员
+ *
+ * 遍历指定的成员列表，对每个成员执行销毁操作（如果存在 destroy 方法），
+ * 然后递归销毁其子对象的成员，最后删除该成员
+ *
+ * @param obj 要销毁成员的对象
+ * @param members 要销毁的成员名称列表
+ */
+function destroyMembers(obj, members) {
+    members.forEach(member => {
+        if (obj.hasOwnProperty(member)) {
+            const memberValue = obj[member];
+            // 如果成员有 destroy 方法，则调用它
+            if ((0, base_1.isObject)(memberValue) && typeof memberValue.destroy === 'function') {
+                memberValue.destroy();
+            }
+            // 如果成员是对象，则递归销毁其所有成员
+            if ((0, base_1.isObject)(memberValue)) {
+                destroyMembers(memberValue, Object.keys(memberValue));
+            }
+            // 删除成员
+            delete obj[member];
+        }
+    });
+}
+//# sourceMappingURL=properties.js.map

package/dist/utils/object/properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.js","sourceRoot":"","sources":["../../../../src/utils/object/properties.ts"],"names":[],"mappings":"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"}

package/dist/utils/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@qimen-lab/utils",
+  "version": "0.1.1",
+  "main": "index.js",
+  "module": "index.esm.js",
+  "types": "index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": "./index.esm.js",
+      "require": "./index.js",
+      "types": "./index.d.ts"
+    }
+  }
+}

package/dist/utils/string/base.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 字符串基础操作工具函数
+ */
+/**
+ * 去除字符串首尾空格
+ * @param str 输入字符串
+ * @returns 去除首尾空格后的字符串
+ */
+export declare function trim(str: string): string;
+/**
+ * 将字符串首字母大写
+ * @param str 输入字符串
+ * @returns 首字母大写的字符串
+ */
+export declare function capitalize(str: string): string;
+/**
+ * 将字符串首字母小写
+ * @param str 输入字符串
+ * @returns 首字母小写的字符串
+ */
+export declare function uncapitalize(str: string): string;
+/**
+ * 将字符串转换为驼峰命名法
+ * @param str 输入字符串
+ * @returns 驼峰命名的字符串
+ */
+export declare function camelCase(str: string): string;
+/**
+ * 将驼峰式命名的字符串转换为连接符命名的全小写字符串
+ * @param str 输入的驼峰式字符串
+ * @returns 用连接符分隔的全小写字符串
+ */
+export declare function camelCaseToDash(str: string): string;
+//# sourceMappingURL=base.d.ts.map

package/dist/utils/string/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/utils/string/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAExC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgB7C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAInD"}

package/dist/utils/string/base.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * 字符串基础操作工具函数
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trim = trim;
+exports.capitalize = capitalize;
+exports.uncapitalize = uncapitalize;
+exports.camelCase = camelCase;
+exports.camelCaseToDash = camelCaseToDash;
+/**
+ * 去除字符串首尾空格
+ * @param str 输入字符串
+ * @returns 去除首尾空格后的字符串
+ */
+function trim(str) {
+    return str.trim();
+}
+/**
+ * 将字符串首字母大写
+ * @param str 输入字符串
+ * @returns 首字母大写的字符串
+ */
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+ * 将字符串首字母小写
+ * @param str 输入字符串
+ * @returns 首字母小写的字符串
+ */
+function uncapitalize(str) {
+    return str.charAt(0).toLowerCase() + str.slice(1);
+}
+/**
+ * 将字符串转换为驼峰命名法
+ * @param str 输入字符串
+ * @returns 驼峰命名的字符串
+ */
+function camelCase(str) {
+    // 将字符串转换为小写并按空格、连字符、下划线分割
+    if (!str.includes('-') && !str.includes('_') && !str.includes(' '))
+        return uncapitalize(str);
+    const words = str.toLowerCase().split(/[-_\s]+/);
+    let result = '';
+    for (let i = 0; i < words.length; i++) {
+        const word = words[i].toLocaleLowerCase();
+        if (i === 0) {
+            result += word; // 第一个单词保持小写
+        }
+        else {
+            result += capitalize(word);
+        }
+    }
+    return result;
+}
+/**
+ * 将驼峰式命名的字符串转换为连接符命名的全小写字符串
+ * @param str 输入的驼峰式字符串
+ * @returns 用连接符分隔的全小写字符串
+ */
+function camelCaseToDash(str) {
+    let result = str.replace(/([A-Z])/g, '-$1').toLowerCase();
+    if (result.startsWith('-'))
+        result = result.slice(1);
+    return result;
+}
+//# sourceMappingURL=base.js.map

package/dist/utils/string/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/utils/string/base.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAOH,oBAEC;AAOD,gCAEC;AAOD,oCAEC;AAOD,8BAgBC;AAOD,0CAIC;AA3DD;;;;GAIG;AACH,SAAgB,IAAI,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,GAAW;IAClC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,SAAgB,SAAS,CAAC,GAAW;IACjC,0BAA0B;IAC1B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;IAC7F,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACV,MAAM,IAAI,IAAI,CAAC,CAAC,YAAY;QAChC,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAAC,GAAW;IACvC,IAAI,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1D,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/utils/string/css.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CSS单位处理工具函数
+ */
+export type CssUnitType = string | number | null | undefined;
+/**
+ * 将CSS单位值标准化为字符串
+ * @param value CSS单位值
+ * @returns 标准化后的CSS单位字符串
+ */
+export declare function normalizeCssUnit(value: CssUnitType): string;
+/**
+ * 将CSS单位字符串转换为数值
+ * @param value CSS单位字符串或数值
+ * @returns 解析出的数值
+ */
+export declare function cssUnitTypeToNumber(value: CssUnitType): number;
+//# sourceMappingURL=css.d.ts.map

package/dist/utils/string/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../../../src/utils/string/css.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAE7D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAM3D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAQ9D"}

package/dist/utils/string/css.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * CSS单位处理工具函数
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeCssUnit = normalizeCssUnit;
+exports.cssUnitTypeToNumber = cssUnitTypeToNumber;
+/**
+ * 将CSS单位值标准化为字符串
+ * @param value CSS单位值
+ * @returns 标准化后的CSS单位字符串
+ */
+function normalizeCssUnit(value) {
+    if (value === 0)
+        return '0';
+    if (typeof value === 'number')
+        return value + 'px';
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    return value;
+}
+/**
+ * 将CSS单位字符串转换为数值
+ * @param value CSS单位字符串或数值
+ * @returns 解析出的数值
+ */
+function cssUnitTypeToNumber(value) {
+    if (typeof value === 'number')
+        return value;
+    const match = value.match(/^(\d+(\.\d+)?)(px|em|rem|%|pt|pc|ex|ch|vw|vh|vmin|vmax)?$/);
+    if (match) {
+        const num = parseFloat(match[1]);
+        return num;
+    }
+    return 0;
+}
+//# sourceMappingURL=css.js.map

package/dist/utils/string/css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.js","sourceRoot":"","sources":["../../../../src/utils/string/css.ts"],"names":[],"mappings":";AAAA;;GAEG;;AASH,4CAMC;AAOD,kDAQC;AA1BD;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,KAAkB;IAC/C,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,GAAG,IAAI,CAAC;IACnD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC5C,OAAO,KAAe,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,KAAkB;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,KAAK,GAAG,KAAM,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IACxF,IAAI,KAAK,EAAE,CAAC;QACR,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,OAAO,GAAG,CAAC;IACf,CAAC;IACD,OAAO,CAAC,CAAC;AACb,CAAC"}

package/dist/utils/string/format.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 文本替换和格式化工具函数
+ */
+/**
+ * 使用提供的选项对象替换字符串中的占位符
+ * @param str 包含占位符的字符串
+ * @param options 替换选项对象，键为占位符名称，值为替换内容
+ * @returns 替换后的字符串
+ */
+export declare function replace(str: string, options: {
+    [key: string]: string;
+}): string;
+/**
+ * 替换字符串中所有匹配项
+ * @param str 源字符串
+ * @param search 要查找的字符串
+ * @param replace 用于替换的字符串
+ * @returns 替换后的字符串
+ */
+export declare function replaceAll(str: string, search: string, replace: string): string;
+/**
+ * 高亮文本中匹配的搜索词
+ * @param text 原始文本
+ * @param search 要高亮的搜索词
+ * @param additionalClass 额外添加的CSS类名（可选），默认类名始终存在
+ * @returns 包含高亮HTML标签的文本
+ */
+export declare function highlightText(text: string, search: string, additionalClass?: string): string;
+/**
+ * 将文本转换为HTML格式，每个换行使用P标签包裹
+ * @param text 要转换的文本或文本数组
+ * @param className 应用于段落的CSS类名
+ * @returns 转换后的HTML字符串
+ */
+export declare function textToHtml(text: string | string[], className?: string): string;
+/**
+ * 将字符串按指定分隔符分割，并支持分隔符的转义
+ * 例如：splitWithEscaping("a,b,,c,d", ",") => ["a", "b,c", "d"]
+ * @param str 要分割的字符串
+ * @param separator 分隔符
+ * @returns 分割后的字符串数组
+ */
+export declare function splitWithEscaping(str: string, separator: string): string[];
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/string/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../src/utils/string/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAAG,MAAM,CAQ/E;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAI/E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAE,MAAW,GAAG,MAAM,CAehG;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,SAAS,GAAE,MAAW,GAAG,MAAM,CAOlF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CA0B1E"}

package/dist/utils/string/format.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * 文本替换和格式化工具函数
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replace = replace;
+exports.replaceAll = replaceAll;
+exports.highlightText = highlightText;
+exports.textToHtml = textToHtml;
+exports.splitWithEscaping = splitWithEscaping;
+/**
+ * 使用提供的选项对象替换字符串中的占位符
+ * @param str 包含占位符的字符串
+ * @param options 替换选项对象，键为占位符名称，值为替换内容
+ * @returns 替换后的字符串
+ */
+function replace(str, options) {
+    for (const key in options) {
+        if (options.hasOwnProperty(key)) {
+            const value = options[key];
+            str = replaceAll(str, `{${key}}`, value);
+        }
+    }
+    return str;
+}
+/**
+ * 替换字符串中所有匹配项
+ * @param str 源字符串
+ * @param search 要查找的字符串
+ * @param replace 用于替换的字符串
+ * @returns 替换后的字符串
+ */
+function replaceAll(str, search, replace) {
+    // 转义特殊正则字符，然后创建大小写不敏感的正则表达式
+    const escapedSearch = search.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return str.replace(new RegExp(escapedSearch, 'gi'), replace);
+}
+/**
+ * 高亮文本中匹配的搜索词
+ * @param text 原始文本
+ * @param search 要高亮的搜索词
+ * @param additionalClass 额外添加的CSS类名（可选），默认类名始终存在
+ * @returns 包含高亮HTML标签的文本
+ */
+function highlightText(text, search, additionalClass = '') {
+    // 如果text为空，则直接返回原文本
+    if (!text)
+        return text;
+    // 转义特殊正则字符，然后创建大小写不敏感的正则表达式
+    const escapedSearch = search.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    // 创建正则表达式，忽略大小写
+    const regex = new RegExp(`(${escapedSearch})`, 'gi');
+    // 合并默认类名和额外类名
+    const defaultClass = 'text-danger font-bold';
+    const combinedClass = additionalClass ? `${defaultClass} ${additionalClass}` : defaultClass;
+    // 替换匹配的文本，并添加高亮 HTML
+    return text.replace(regex, match => `<span class="${combinedClass}">${match}</span>`);
+}
+/**
+ * 将文本转换为HTML格式，每个换行使用P标签包裹
+ * @param text 要转换的文本或文本数组
+ * @param className 应用于段落的CSS类名
+ * @returns 转换后的HTML字符串
+ */
+function textToHtml(text, className = '') {
+    if (Array.isArray(text)) {
+        return text.map(t => textToHtml(t, className)).join('');
+    }
+    return (`<p class="${className}">` + text.replace(/\n/g, `</p><p class="${className}">`) + '</p>');
+}
+/**
+ * 将字符串按指定分隔符分割，并支持分隔符的转义
+ * 例如：splitWithEscaping("a,b,,c,d", ",") => ["a", "b,c", "d"]
+ * @param str 要分割的字符串
+ * @param separator 分隔符
+ * @returns 分割后的字符串数组
+ */
+function splitWithEscaping(str, separator) {
+    // 此函数用于将字符串按指定分隔符分割，并支持分隔符的转义
+    if (separator === '')
+        return [str];
+    // 首先替换所有转义分隔符（两个连续的分隔符）为临时标记
+    const escapedSeparator = separator + separator;
+    const tempMarker = '\u0001'; // 使用一个不太可能出现在普通文本中的字符作为临时标记
+    let processedStr = str;
+    let index = 0;
+    // 替换所有转义分隔符为临时标记
+    while ((index = processedStr.indexOf(escapedSeparator, index)) !== -1) {
+        processedStr =
+            processedStr.substring(0, index) +
+                tempMarker +
+                processedStr.substring(index + escapedSeparator.length);
+        // 移动索引到替换后的位置之后，避免重复匹配
+        index++;
+    }
+    // 按正常分隔符分割字符串
+    const parts = processedStr.split(separator);
+    // 将临时标记替换回实际的分隔符字符
+    return parts.map(part => part.replace(new RegExp(tempMarker, 'g'), separator));
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/string/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../../src/utils/string/format.ts"],"names":[],"mappings":"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"}

package/dist/utils/string/id.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ID生成和唯一性处理工具函数
+ */
+/**
+ * 生成唯一ID
+ * @param prefix ID前缀，默认为"id"
+ * @returns 生成的唯一ID字符串
+ */
+export declare function getId(prefix?: string): string;
+/**
+ * 生成分布式追踪ID (traceId)
+ * @returns 生成的唯一追踪ID字符串，格式为16位十六进制字符串
+ */
+export declare function generateTraceId(): string;
+/**
+ * 空字符串的表示（非断开空格字符）
+ */
+export declare const emptyString = "\u00A0";
+/**
+ * 标准化语言代码
+ * @param language 语言代码
+ * @returns 标准化的语言代码
+ */
+export declare function normalizedLanguage(language: string): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/string/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../../src/utils/string/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,GAAE,MAAa,GAAG,MAAM,CAGnD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAOxC;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,UAIlD"}

package/dist/utils/string/id.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * ID生成和唯一性处理工具函数
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emptyString = void 0;
+exports.getId = getId;
+exports.generateTraceId = generateTraceId;
+exports.normalizedLanguage = normalizedLanguage;
+let idSeed = 0;
+/**
+ * 生成唯一ID
+ * @param prefix ID前缀，默认为"id"
+ * @returns 生成的唯一ID字符串
+ */
+function getId(prefix = 'id') {
+    idSeed += 1;
+    return `${prefix}-${Date.now()}-${idSeed}`;
+}
+/**
+ * 生成分布式追踪ID (traceId)
+ * @returns 生成的唯一追踪ID字符串，格式为16位十六进制字符串
+ */
+function generateTraceId() {
+    // 生成16位十六进制字符串作为traceId
+    return Array.from({ length: 16 }, () => Math.floor(Math.random() * 256)
+        .toString(16)
+        .padStart(2, '0')).join('');
+}
+/**
+ * 空字符串的表示（非断开空格字符）
+ */
+exports.emptyString = '\u00A0';
+/**
+ * 标准化语言代码
+ * @param language 语言代码
+ * @returns 标准化的语言代码
+ */
+function normalizedLanguage(language) {
+    if (language === 'zh-Hans')
+        language = 'zh-CN';
+    if (language === 'zh-Hant')
+        language = 'zh-TW';
+    return language;
+}
+//# sourceMappingURL=id.js.map

package/dist/utils/string/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../../src/utils/string/id.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AASH,sBAGC;AAMD,0CAOC;AAYD,gDAIC;AAvCD,IAAI,MAAM,GAAG,CAAC,CAAC;AAEf;;;;GAIG;AACH,SAAgB,KAAK,CAAC,SAAiB,IAAI;IACvC,MAAM,IAAI,CAAC,CAAC;IACZ,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,EAAE,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe;IAC3B,wBAAwB;IACxB,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CACnC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;SAC1B,QAAQ,CAAC,EAAE,CAAC;SACZ,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CACxB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACU,QAAA,WAAW,GAAG,QAAQ,CAAC;AAEpC;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,QAAgB;IAC/C,IAAI,QAAQ,KAAK,SAAS;QAAE,QAAQ,GAAG,OAAO,CAAC;IAC/C,IAAI,QAAQ,KAAK,SAAS;QAAE,QAAQ,GAAG,OAAO,CAAC;IAC/C,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/utils/string/index.d.ts

@@ -0,0 +1,6 @@
+export * from './base';
+export * from './format';
+export * from './css';
+export * from './id';
+export * from './plural';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/string/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/string/index.ts"],"names":[],"mappings":"AAGA,cAAc,QAAQ,CAAC;AAGvB,cAAc,UAAU,CAAC;AAGzB,cAAc,OAAO,CAAC;AAGtB,cAAc,MAAM,CAAC;AAGrB,cAAc,UAAU,CAAC"}