jz-toolkit 1.1.6 → 1.1.8

package/README.md

@@ -4,7 +4,20 @@
 
 #### 🆕 最近更新
 
-##### v1.1.5
+##### v1.1.9
+- 新增 `renderTemplate()` - 字符串模板替换函数，支持灵活的变量替换
+
+```typescript
+import { renderTemplate } from "jz-toolkit";
+
+const result = renderTemplate(
+  { name: "张三", money: 100.50 },
+  "你好, {{name}}! 你的余额是 {{money}} 元。"
+);
+// 返回: "你好, 张三! 你的余额是 100.50 元。"
+```
+
+##### v1.1.8
 - 新增 `toThousandsIntl()` - 国际化数字千分位格式化函数，支持多地区格式
 - 新增 `toThousands()` - 常规数字千分位格式化函数
 

package/dist/esm/index.d.ts

@@ -17,7 +17,7 @@ export * as dom from "./generDom";
 export { chunk, compact, filterDuplicateValues, filterArrayAttr, uniq, uniqBy, flatten, flattenDeep, groupBy, sortBy, intersection, difference, union, first, last, take, takeRight, } from "./array";
 export { flattenTree, convertToArray } from "./mapToArray";
 export { pick, omit, deepClone, merge, get, set, flattenObject, unflattenObject, } from "./object";
-export { capitalize, camelCase, kebabCase, snakeCase, pascalCase, truncate, trim, trimStart, trimEnd, randomString, randomNumericString, randomAlphaString, toThousandsIntl, toThousands } from "./string";
+export { capitalize, camelCase, kebabCase, snakeCase, pascalCase, truncate, trim, trimStart, trimEnd, randomString, randomNumericString, randomAlphaString, toThousandsIntl, toThousands, renderTemplate, } from "./string";
 export { numberToFixed, random, randomInt, clamp, inRange, formatNumber, sum, average, max, min, } from "./number";
 export { debounce, throttle, once, sleep, delay, } from "./function";
 export { formatDate, addDays, addMonths, addYears, diffDays, diffHours, diffMinutes, isValidDate, isSameDay, isToday, isYesterday, isTomorrow, isDateInRange, } from "./date";

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAGlC,OAAO,EAEL,KAAK,EACL,OAAO,EACP,qBAAqB,EACrB,eAAe,EACf,IAAI,EACJ,MAAM,EACN,OAAO,EACP,WAAW,EACX,OAAO,EACP,MAAM,EACN,YAAY,EACZ,UAAU,EACV,KAAK,EACL,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,SAAS,GACV,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAEL,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,KAAK,EACL,GAAG,EACH,GAAG,EACH,aAAa,EACb,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,OAAO,EACP,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACZ,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,aAAa,EACb,MAAM,EACN,SAAS,EACT,KAAK,EACL,OAAO,EACP,YAAY,EACZ,GAAG,EACH,OAAO,EACP,GAAG,EACH,GAAG,GACJ,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,KAAK,GACN,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,EACX,SAAS,EACT,OAAO,EACP,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAEL,KAAK,EACL,OAAO,EACP,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAEL,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,YAAY,GACb,MAAM,OAAO,CAAC;AAEf,OAAO,EAEL,OAAO,EACP,OAAO,EACP,KAAK,EACL,QAAQ,EACR,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,MAAM,EACN,QAAQ,EACR,KAAK,EACL,KAAK,EACL,OAAO,EACP,YAAY,EACZ,aAAa,EACb,IAAI,EACJ,OAAO,EACP,QAAQ,GACT,MAAM,WAAW,CAAC;AACnB,OAAO,EAEL,OAAO,GACR,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAGlC,OAAO,EAEL,KAAK,EACL,OAAO,EACP,qBAAqB,EACrB,eAAe,EACf,IAAI,EACJ,MAAM,EACN,OAAO,EACP,WAAW,EACX,OAAO,EACP,MAAM,EACN,YAAY,EACZ,UAAU,EACV,KAAK,EACL,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,SAAS,GACV,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAEL,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,KAAK,EACL,GAAG,EACH,GAAG,EACH,aAAa,EACb,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,OAAO,EACP,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,cAAc,GACf,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,aAAa,EACb,MAAM,EACN,SAAS,EACT,KAAK,EACL,OAAO,EACP,YAAY,EACZ,GAAG,EACH,OAAO,EACP,GAAG,EACH,GAAG,GACJ,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,KAAK,GACN,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,EACX,SAAS,EACT,OAAO,EACP,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAEL,KAAK,EACL,OAAO,EACP,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAEL,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,YAAY,GACb,MAAM,OAAO,CAAC;AAEf,OAAO,EAEL,OAAO,EACP,OAAO,EACP,KAAK,EACL,QAAQ,EACR,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,MAAM,EACN,QAAQ,EACR,KAAK,EACL,KAAK,EACL,OAAO,EACP,YAAY,EACZ,aAAa,EACb,IAAI,EACJ,OAAO,EACP,QAAQ,GACT,MAAM,WAAW,CAAC;AACnB,OAAO,EAEL,OAAO,GACR,MAAM,YAAY,CAAC"}

package/dist/esm/index.js

@@ -26,7 +26,7 @@ export {
 pick, omit, deepClone, merge, get, set, flattenObject, unflattenObject, } from "./object";
 export { 
 // 字符串
-capitalize, camelCase, kebabCase, snakeCase, pascalCase, truncate, trim, trimStart, trimEnd, randomString, randomNumericString, randomAlphaString, toThousandsIntl, toThousands } from "./string";
+capitalize, camelCase, kebabCase, snakeCase, pascalCase, truncate, trim, trimStart, trimEnd, randomString, randomNumericString, randomAlphaString, toThousandsIntl, toThousands, renderTemplate, } from "./string";
 export { 
 // 数字
 numberToFixed, random, randomInt, clamp, inRange, formatNumber, sum, average, max, min, } from "./number";

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

@@ -7,4 +7,5 @@ export * from './truncate';
 export * from './trim';
 export * from './randomString';
 export * from './toThousandsIntl';
+export * from './renderTemplate';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAA"}

package/dist/esm/string/index.js

@@ -7,3 +7,4 @@ export * from './truncate';
 export * from './trim';
 export * from './randomString';
 export * from './toThousandsIntl';
+export * from './renderTemplate';

package/dist/esm/string/renderTemplate.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 字符串模板替换函数
+ * @param params - 替换的键值对数据，支持字符串、数字、布尔值
+ * @param template - 模板字符串
+ * @param regex - 匹配模式，默认为 {{key}} 格式，必须包含全局标志 g
+ * @returns 替换后的字符串
+ *
+ * @example
+ * ```ts
+ * const result = renderTemplate(
+ *   { name: "张三", money: 100.50 },
+ *   "你好, {{name}}! 你的余额是 {{money}} 元。"
+ * );
+ * // 返回: "你好, 张三! 你的余额是 100.50 元。"
+ * ```
+ */
+export declare function renderTemplate(params: Record<string, string | number | boolean>, template: string, regex?: RegExp): string;
+//# sourceMappingURL=renderTemplate.d.ts.map

package/dist/esm/string/renderTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderTemplate.d.ts","sourceRoot":"","sources":["../../../src/string/renderTemplate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EACjD,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAqB,GAC7B,MAAM,CAaR"}

package/dist/esm/string/renderTemplate.js

@@ -0,0 +1,30 @@
+/**
+ * 字符串模板替换函数
+ * @param params - 替换的键值对数据，支持字符串、数字、布尔值
+ * @param template - 模板字符串
+ * @param regex - 匹配模式，默认为 {{key}} 格式，必须包含全局标志 g
+ * @returns 替换后的字符串
+ *
+ * @example
+ * ```ts
+ * const result = renderTemplate(
+ *   { name: "张三", money: 100.50 },
+ *   "你好, {{name}}! 你的余额是 {{money}} 元。"
+ * );
+ * // 返回: "你好, 张三! 你的余额是 100.50 元。"
+ * ```
+ */
+export function renderTemplate(params, template, regex = /{{(.*?)}}/g) {
+    // 验证正则表达式是否包含全局标志
+    if (!regex.global) {
+        throw new Error('regex must have global flag (g)');
+    }
+    return template.replace(regex, (match, key) => {
+        const trimmedKey = key.trim();
+        const value = params[trimmedKey];
+        // 使用严格判断而不是 ||，避免 0、false 等值被误判
+        return value !== undefined && value !== null
+            ? String(value)
+            : match;
+    });
+}

package/dist/index.d.ts

@@ -17,7 +17,7 @@ export * as dom from "./generDom";
 export { chunk, compact, filterDuplicateValues, filterArrayAttr, uniq, uniqBy, flatten, flattenDeep, groupBy, sortBy, intersection, difference, union, first, last, take, takeRight, } from "./array";
 export { flattenTree, convertToArray } from "./mapToArray";
 export { pick, omit, deepClone, merge, get, set, flattenObject, unflattenObject, } from "./object";
-export { capitalize, camelCase, kebabCase, snakeCase, pascalCase, truncate, trim, trimStart, trimEnd, randomString, randomNumericString, randomAlphaString, toThousandsIntl, toThousands } from "./string";
+export { capitalize, camelCase, kebabCase, snakeCase, pascalCase, truncate, trim, trimStart, trimEnd, randomString, randomNumericString, randomAlphaString, toThousandsIntl, toThousands, renderTemplate, } from "./string";
 export { numberToFixed, random, randomInt, clamp, inRange, formatNumber, sum, average, max, min, } from "./number";
 export { debounce, throttle, once, sleep, delay, } from "./function";
 export { formatDate, addDays, addMonths, addYears, diffDays, diffHours, diffMinutes, isValidDate, isSameDay, isToday, isYesterday, isTomorrow, isDateInRange, } from "./date";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAGlC,OAAO,EAEL,KAAK,EACL,OAAO,EACP,qBAAqB,EACrB,eAAe,EACf,IAAI,EACJ,MAAM,EACN,OAAO,EACP,WAAW,EACX,OAAO,EACP,MAAM,EACN,YAAY,EACZ,UAAU,EACV,KAAK,EACL,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,SAAS,GACV,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAEL,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,KAAK,EACL,GAAG,EACH,GAAG,EACH,aAAa,EACb,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,OAAO,EACP,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACZ,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,aAAa,EACb,MAAM,EACN,SAAS,EACT,KAAK,EACL,OAAO,EACP,YAAY,EACZ,GAAG,EACH,OAAO,EACP,GAAG,EACH,GAAG,GACJ,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,KAAK,GACN,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,EACX,SAAS,EACT,OAAO,EACP,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAEL,KAAK,EACL,OAAO,EACP,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAEL,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,YAAY,GACb,MAAM,OAAO,CAAC;AAEf,OAAO,EAEL,OAAO,EACP,OAAO,EACP,KAAK,EACL,QAAQ,EACR,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,MAAM,EACN,QAAQ,EACR,KAAK,EACL,KAAK,EACL,OAAO,EACP,YAAY,EACZ,aAAa,EACb,IAAI,EACJ,OAAO,EACP,QAAQ,GACT,MAAM,WAAW,CAAC;AACnB,OAAO,EAEL,OAAO,GACR,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAGlC,OAAO,EAEL,KAAK,EACL,OAAO,EACP,qBAAqB,EACrB,eAAe,EACf,IAAI,EACJ,MAAM,EACN,OAAO,EACP,WAAW,EACX,OAAO,EACP,MAAM,EACN,YAAY,EACZ,UAAU,EACV,KAAK,EACL,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,SAAS,GACV,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAEL,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,KAAK,EACL,GAAG,EACH,GAAG,EACH,aAAa,EACb,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,OAAO,EACP,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,cAAc,GACf,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,aAAa,EACb,MAAM,EACN,SAAS,EACT,KAAK,EACL,OAAO,EACP,YAAY,EACZ,GAAG,EACH,OAAO,EACP,GAAG,EACH,GAAG,GACJ,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,KAAK,GACN,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,EACX,SAAS,EACT,OAAO,EACP,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAEL,KAAK,EACL,OAAO,EACP,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAEL,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,YAAY,GACb,MAAM,OAAO,CAAC;AAEf,OAAO,EAEL,OAAO,EACP,OAAO,EACP,KAAK,EACL,QAAQ,EACR,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,MAAM,EACN,QAAQ,EACR,KAAK,EACL,KAAK,EACL,OAAO,EACP,YAAY,EACZ,aAAa,EACb,IAAI,EACJ,OAAO,EACP,QAAQ,GACT,MAAM,WAAW,CAAC;AACnB,OAAO,EAEL,OAAO,GACR,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -30,8 +30,8 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.randomNumericString = exports.randomString = exports.trimEnd = exports.trimStart = exports.trim = exports.truncate = exports.pascalCase = exports.snakeCase = exports.kebabCase = exports.camelCase = exports.capitalize = exports.unflattenObject = exports.flattenObject = exports.set = exports.get = exports.merge = exports.deepClone = exports.omit = exports.pick = exports.convertToArray = exports.flattenTree = exports.takeRight = exports.take = exports.last = exports.first = exports.union = exports.difference = exports.intersection = exports.sortBy = exports.groupBy = exports.flattenDeep = exports.flatten = exports.uniqBy = exports.uniq = exports.filterArrayAttr = exports.filterDuplicateValues = exports.compact = exports.chunk = exports.dom = exports.validate = exports.url = exports.async = exports.date = exports.func = exports.mapToArray = exports.number = exports.utility = exports.string = exports.object = exports.array = void 0;
-exports.isNull = exports.isBoolean = exports.isNumber = exports.isString = exports.isEmptyValue = exports.isPositiveInteger = exports.isInteger = exports.isNumeric = exports.isIdCard = exports.isURL = exports.isPhone = exports.isEmail = exports.addUrlParams = exports.getUrlParam = exports.stringifyQueryString = exports.parseQueryString = exports.promiseAllWithLimit = exports.timeout = exports.retry = exports.isDateInRange = exports.isTomorrow = exports.isYesterday = exports.isToday = exports.isSameDay = exports.isValidDate = exports.diffMinutes = exports.diffHours = exports.diffDays = exports.addYears = exports.addMonths = exports.addDays = exports.formatDate = exports.delay = exports.sleep = exports.once = exports.throttle = exports.debounce = exports.min = exports.max = exports.average = exports.sum = exports.formatNumber = exports.inRange = exports.clamp = exports.randomInt = exports.random = exports.numberToFixed = exports.toThousands = exports.toThousandsIntl = exports.randomAlphaString = void 0;
-exports.message = exports.uniqueId = exports.shortId = exports.uuid = exports.isEmptyObject = exports.isEmptyArray = exports.isEmpty = exports.isSet = exports.isMap = exports.isRegExp = exports.isDate = exports.isFunction = exports.isObject = exports.isArray = exports.isNullOrUndefined = exports.isUndefined = void 0;
+exports.isBoolean = exports.isNumber = exports.isString = exports.isEmptyValue = exports.isPositiveInteger = exports.isInteger = exports.isNumeric = exports.isIdCard = exports.isURL = exports.isPhone = exports.isEmail = exports.addUrlParams = exports.getUrlParam = exports.stringifyQueryString = exports.parseQueryString = exports.promiseAllWithLimit = exports.timeout = exports.retry = exports.isDateInRange = exports.isTomorrow = exports.isYesterday = exports.isToday = exports.isSameDay = exports.isValidDate = exports.diffMinutes = exports.diffHours = exports.diffDays = exports.addYears = exports.addMonths = exports.addDays = exports.formatDate = exports.delay = exports.sleep = exports.once = exports.throttle = exports.debounce = exports.min = exports.max = exports.average = exports.sum = exports.formatNumber = exports.inRange = exports.clamp = exports.randomInt = exports.random = exports.numberToFixed = exports.renderTemplate = exports.toThousands = exports.toThousandsIntl = exports.randomAlphaString = void 0;
+exports.message = exports.uniqueId = exports.shortId = exports.uuid = exports.isEmptyObject = exports.isEmptyArray = exports.isEmpty = exports.isSet = exports.isMap = exports.isRegExp = exports.isDate = exports.isFunction = exports.isObject = exports.isArray = exports.isNullOrUndefined = exports.isUndefined = exports.isNull = void 0;
 // 类型导出
 __exportStar(require("./types"), exports);
 // 功能模块导出
@@ -96,6 +96,7 @@ Object.defineProperty(exports, "randomNumericString", { enumerable: true, get: f
 Object.defineProperty(exports, "randomAlphaString", { enumerable: true, get: function () { return string_1.randomAlphaString; } });
 Object.defineProperty(exports, "toThousandsIntl", { enumerable: true, get: function () { return string_1.toThousandsIntl; } });
 Object.defineProperty(exports, "toThousands", { enumerable: true, get: function () { return string_1.toThousands; } });
+Object.defineProperty(exports, "renderTemplate", { enumerable: true, get: function () { return string_1.renderTemplate; } });
 var number_1 = require("./number");
 // 数字
 Object.defineProperty(exports, "numberToFixed", { enumerable: true, get: function () { return number_1.numberToFixed; } });

package/dist/string/index.d.ts

@@ -7,4 +7,5 @@ export * from './truncate';
 export * from './trim';
 export * from './randomString';
 export * from './toThousandsIntl';
+export * from './renderTemplate';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAA"}

package/dist/string/index.js

@@ -23,3 +23,4 @@ __exportStar(require("./truncate"), exports);
 __exportStar(require("./trim"), exports);
 __exportStar(require("./randomString"), exports);
 __exportStar(require("./toThousandsIntl"), exports);
+__exportStar(require("./renderTemplate"), exports);

package/dist/string/renderTemplate.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 字符串模板替换函数
+ * @param params - 替换的键值对数据，支持字符串、数字、布尔值
+ * @param template - 模板字符串
+ * @param regex - 匹配模式，默认为 {{key}} 格式，必须包含全局标志 g
+ * @returns 替换后的字符串
+ *
+ * @example
+ * ```ts
+ * const result = renderTemplate(
+ *   { name: "张三", money: 100.50 },
+ *   "你好, {{name}}! 你的余额是 {{money}} 元。"
+ * );
+ * // 返回: "你好, 张三! 你的余额是 100.50 元。"
+ * ```
+ */
+export declare function renderTemplate(params: Record<string, string | number | boolean>, template: string, regex?: RegExp): string;
+//# sourceMappingURL=renderTemplate.d.ts.map

package/dist/string/renderTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderTemplate.d.ts","sourceRoot":"","sources":["../../src/string/renderTemplate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EACjD,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAqB,GAC7B,MAAM,CAaR"}

package/dist/string/renderTemplate.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTemplate = void 0;
+/**
+ * 字符串模板替换函数
+ * @param params - 替换的键值对数据，支持字符串、数字、布尔值
+ * @param template - 模板字符串
+ * @param regex - 匹配模式，默认为 {{key}} 格式，必须包含全局标志 g
+ * @returns 替换后的字符串
+ *
+ * @example
+ * ```ts
+ * const result = renderTemplate(
+ *   { name: "张三", money: 100.50 },
+ *   "你好, {{name}}! 你的余额是 {{money}} 元。"
+ * );
+ * // 返回: "你好, 张三! 你的余额是 100.50 元。"
+ * ```
+ */
+function renderTemplate(params, template, regex = /{{(.*?)}}/g) {
+    // 验证正则表达式是否包含全局标志
+    if (!regex.global) {
+        throw new Error('regex must have global flag (g)');
+    }
+    return template.replace(regex, (match, key) => {
+        const trimmedKey = key.trim();
+        const value = params[trimmedKey];
+        // 使用严格判断而不是 ||，避免 0、false 等值被误判
+        return value !== undefined && value !== null
+            ? String(value)
+            : match;
+    });
+}
+exports.renderTemplate = renderTemplate;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jz-toolkit",
-  "version": "1.1.6",
+  "version": "1.1.8",
   "description": "一个轻量级的JavaScript/TypeScript 工具库",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -91,7 +91,8 @@
     "format": "prettier --write 'src/**/*.ts'",
     "prepublishOnly": "npm run build && npm run test",
     "setNpm":"npm config set registry https://registry.npmjs.org",
-    "setPnpm":"npm config set registry https://registry.npmmirror.com"
+    "setPnpm":"npm config set registry https://registry.npmmirror.com",
+    "testNpm": "node ./scripts/getNpm.js"
   },
   "keywords": [
     "utility",