@cloudpss/template 0.5.23

package/README.md

@@ -0,0 +1,3 @@
+# @cloudpss/template
+
+String and object template engine for Node.js and the browser.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { parseTemplate } from './parser.js';
+export type { Template } from './parser.js';
+export { template } from './template/index.js';
+export type { TemplateFunction, TemplateOptions } from './template/index.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { parseTemplate } from './parser.js';
+export { template } from './template/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,15 @@
+/** 字符串模板 */
+export type Template = string | {
+    type: 'formula';
+    value: string;
+} | {
+    type: 'interpolation';
+    templates: string[];
+    values: string[];
+};
+/** 字符串模板类型 */
+export type TemplateType = (Template & object)['type'];
+/**
+ * 解析字符串模板
+ */
+export declare function parseTemplate(template: string): Template;

package/dist/parser.js

@@ -0,0 +1,128 @@
+var ParserStatus;
+(function (ParserStatus) {
+    ParserStatus[ParserStatus["Text"] = 0] = "Text";
+    ParserStatus[ParserStatus["ExpressionSimple"] = 1] = "ExpressionSimple";
+    ParserStatus[ParserStatus["ExpressionComplex"] = 2] = "ExpressionComplex";
+})(ParserStatus || (ParserStatus = {}));
+Object.freeze(ParserStatus);
+/**
+ * 解析字符串插值模板
+ * @example parseInterpolation("$hello $name! I am $age years old. I'll be ${age+1} next year. Give me $$100.")
+ * // {
+ * //   type: 'interpolation',
+ * //   templates: ['hello ', '! I am ', ' years old. I\'ll be ', ' next year. Give me $$100.'],
+ * //   values: ['name', 'age', 'age+1']
+ * // }
+ */
+function parseInterpolation(template) {
+    const templates = [];
+    const values = [];
+    let currentTemplate = '';
+    let currentValue = '';
+    let expressionComplexDepth = 0;
+    let status = ParserStatus.Text;
+    for (let i = 1; i < template.length; i++) {
+        const char = template[i];
+        if (status === ParserStatus.Text) {
+            if (char !== '$') {
+                currentTemplate += char;
+                continue;
+            }
+            if (i === template.length - 1) {
+                // End of input
+                currentTemplate += char;
+                continue;
+            }
+            const nextChar = template[i + 1];
+            if (nextChar === '$') {
+                // Escaped dollar sign
+                currentTemplate += char;
+                i++;
+                continue;
+            }
+            if (nextChar === '{') {
+                // Start of expression
+                templates.push(currentTemplate);
+                currentTemplate = '';
+                status = ParserStatus.ExpressionComplex;
+                expressionComplexDepth = 1;
+                i++;
+                continue;
+            }
+            if (/[a-zA-Z_]/.exec(nextChar)) {
+                // Start of expression
+                templates.push(currentTemplate);
+                currentTemplate = '';
+                status = ParserStatus.ExpressionSimple;
+                continue;
+            }
+            // Not an expression
+            currentTemplate += char;
+            continue;
+        }
+        if (status === ParserStatus.ExpressionSimple) {
+            if (/[a-zA-Z0-9_]/.exec(char)) {
+                currentValue += char;
+                continue;
+            }
+            // End of expression
+            values.push(currentValue);
+            currentValue = '';
+            status = ParserStatus.Text;
+            i--;
+            continue;
+        }
+        if (status === ParserStatus.ExpressionComplex) {
+            if (char === '{') {
+                expressionComplexDepth++;
+            }
+            else if (char === '}') {
+                expressionComplexDepth--;
+                if (expressionComplexDepth === 0) {
+                    // End of expression
+                    values.push(currentValue.trim());
+                    currentValue = '';
+                    status = ParserStatus.Text;
+                    continue;
+                }
+            }
+            currentValue += char;
+            continue;
+        }
+    }
+    if (status === ParserStatus.Text) {
+        templates.push(currentTemplate);
+    }
+    else if (status === ParserStatus.ExpressionSimple) {
+        values.push(currentValue);
+        templates.push('');
+    }
+    else {
+        throw new Error('Unexpected end of input');
+    }
+    if (values.length === 0)
+        return templates[0];
+    return {
+        type: 'interpolation',
+        templates,
+        values,
+    };
+}
+/**
+ * 解析字符串模板
+ */
+export function parseTemplate(template) {
+    if (!template)
+        return '';
+    if (template.startsWith('=')) {
+        return {
+            type: 'formula',
+            value: template.slice(1).trim(),
+        };
+    }
+    if (template.startsWith('$')) {
+        return parseInterpolation(template);
+    }
+    return template;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/template/compiler.d.ts

@@ -0,0 +1,27 @@
+import type { TemplateFunction, TemplateOptions } from './index.js';
+/** 创建模板 */
+export declare class TemplateCompiler {
+    readonly template: unknown;
+    readonly options: Required<TemplateOptions>;
+    constructor(template: unknown, options: Required<TemplateOptions>);
+    private readonly params;
+    private readonly copyable;
+    /** 构建求值 */
+    private buildEval;
+    /** 构建字符串 */
+    private buildString;
+    /** 构建 Error */
+    private buildError;
+    /** 构建数组 */
+    private buildArray;
+    /** 构建 ArrayBuffer */
+    private buildArrayBuffer;
+    /** 构建 ArrayBufferView */
+    private buildArrayBufferView;
+    /** 构建对象 */
+    private buildObject;
+    /** 构建值 */
+    private buildValue;
+    /** 构建模板 */
+    build(): TemplateFunction;
+}

package/dist/template/compiler.js

@@ -0,0 +1,157 @@
+import { parseTemplate } from '../parser.js';
+/** 是否为 ArrayBuffer */
+function isArrayBuffer(value) {
+    if (value instanceof ArrayBuffer)
+        return true;
+    if (typeof SharedArrayBuffer == 'function' && value instanceof SharedArrayBuffer)
+        return true;
+    return false;
+}
+/** 是否为 Error */
+function isError(value) {
+    return value instanceof Error || (typeof DOMException == 'function' && value instanceof DOMException);
+}
+const KNOWN_ERRORS = [EvalError, RangeError, ReferenceError, SyntaxError, TypeError, URIError];
+/** 创建模板 */
+export class TemplateCompiler {
+    template;
+    options;
+    constructor(template, options) {
+        this.template = template;
+        this.options = options;
+    }
+    params = new Map();
+    copyable = [];
+    /** 构建求值 */
+    buildEval(expression, type) {
+        const { evaluator } = this.options;
+        if (!this.params.has('evaluator')) {
+            this.params.set('evaluator', evaluator.inject);
+        }
+        return evaluator.compile(expression, type);
+    }
+    /** 构建字符串 */
+    buildString(str) {
+        const parsed = parseTemplate(str);
+        if (typeof parsed === 'string')
+            return JSON.stringify(parsed);
+        if (parsed.type === 'formula')
+            return this.buildEval(parsed.value, parsed.type);
+        let result = '';
+        for (let i = 0; i < parsed.templates.length; i++) {
+            if (parsed.templates[i]) {
+                result += (result ? '+' : '') + JSON.stringify(parsed.templates[i]);
+            }
+            if (i < parsed.values.length) {
+                if (!result)
+                    result = '""';
+                result += '+' + this.buildEval(parsed.values[i], parsed.type);
+            }
+        }
+        return '(' + result + ')';
+    }
+    /** 构建 Error */
+    buildError(err) {
+        if (typeof DOMException == 'function' && err instanceof DOMException) {
+            return `new DOMException(${this.buildString(err.message)}, ${this.buildString(err.name)})`;
+        }
+        const constructor = KNOWN_ERRORS.find((type) => err instanceof type)?.name ?? 'Error';
+        if (err.name === constructor) {
+            return `new ${constructor}(${this.buildString(err.message)})`;
+        }
+        return `Object.assign(new ${constructor}(${this.buildString(err.message)}), {name: ${this.buildString(err.name)}})`;
+    }
+    /** 构建数组 */
+    buildArray(arr) {
+        return `[${arr.map(this.buildValue.bind(this)).join(',')}]`;
+    }
+    /** 构建 ArrayBuffer */
+    buildArrayBuffer(buffer) {
+        this.copyable.push(buffer.slice(0));
+        return `copyable[${this.copyable.length - 1}].slice(0)`;
+    }
+    /** 构建 ArrayBufferView */
+    buildArrayBufferView(view) {
+        this.copyable.push(view.buffer.slice(view.byteOffset, view.byteOffset + view.byteLength));
+        return `new ${view.constructor.name}(copyable[${this.copyable.length - 1}].slice(0))`;
+    }
+    /** 构建对象 */
+    buildObject(obj) {
+        let result = '';
+        for (const key in obj) {
+            if (!Object.prototype.hasOwnProperty.call(obj, key))
+                continue;
+            const value = obj[key];
+            if (result)
+                result += ',';
+            if (this.options.objectKeyMode === 'ignore') {
+                result += JSON.stringify(key);
+            }
+            else {
+                result += '[' + this.buildString(key) + ']';
+            }
+            result += ':';
+            result += this.buildValue(value);
+        }
+        return '{' + result + '}';
+    }
+    /** 构建值 */
+    buildValue(value) {
+        if (value === null)
+            return 'null';
+        if (value === undefined)
+            return 'undefined';
+        if (value === true)
+            return 'true';
+        if (value === false)
+            return 'false';
+        if (typeof value == 'function')
+            return 'undefined';
+        if (typeof value == 'symbol')
+            return 'undefined';
+        if (typeof value == 'bigint')
+            return `${value}n`;
+        if (typeof value == 'number')
+            return String(value);
+        if (typeof value == 'string')
+            return this.buildString(value);
+        /* c8 ignore next */
+        if (typeof value != 'object')
+            throw new Error(`Unsupported value: ${Object.prototype.toString.call(value)}`);
+        if (value instanceof Date)
+            return `new Date(${value.getTime()})`;
+        if (value instanceof RegExp)
+            return value.toString();
+        if (isError(value))
+            return this.buildError(value);
+        if (Array.isArray(value))
+            return this.buildArray(value);
+        if (isArrayBuffer(value))
+            return this.buildArrayBuffer(value);
+        if (ArrayBuffer.isView(value))
+            return this.buildArrayBufferView(value);
+        return this.buildObject(value);
+    }
+    /** 构建模板 */
+    build() {
+        const source = this.buildValue(this.template);
+        if (this.copyable.length) {
+            this.params.set('copyable', this.copyable);
+        }
+        const params = [...this.params];
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-implied-eval
+            const result = new Function(...params.map(([key]) => key), 'context', `
+            if (context == null) context = {};
+            return (${source});
+            `).bind(undefined, ...params.map(([, value]) => value));
+            result.source = source;
+            return result;
+            /* c8 ignore next 3 */
+        }
+        catch (e) {
+            throw new Error(`Failed to compile template: ${source}\n${e.message}`, { cause: e });
+        }
+    }
+}
+//# sourceMappingURL=compiler.js.map

package/dist/template/compiler.js.map

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

package/dist/template/index.d.ts

@@ -0,0 +1,30 @@
+import type { TemplateType } from '../parser.js';
+/** 模板编译求值 */
+export type TemplateEvaluator = {
+    /** 注入为 `evaluator` 变量，可在生成的求值代码中使用 */
+    inject: unknown;
+    /** 生成求值代码，可用变量：`evaluator` `context` */
+    compile: (expression: string, type: TemplateType) => string;
+};
+/** 模板选项 */
+export interface TemplateOptions {
+    /**
+     * 模板求值器
+     * @default context?.[expression] ?? (type === 'formula' ? undefined : '')
+     */
+    evaluator?: TemplateEvaluator;
+    /**
+     * 对 object key 的处理方式
+     * - `template` 使用模板进行插值
+     * - `ignore` 原样输出
+     * @default 'template'
+     */
+    objectKeyMode?: 'template' | 'ignore';
+}
+export declare const defaultEvaluator: TemplateEvaluator;
+/** 已编译的模板函数 */
+export type TemplateFunction<T = unknown, C = Record<string, unknown>> = ((context?: C) => T) & {
+    source: string;
+};
+/** 创建模板 */
+export declare function template<T = unknown, C = Record<string, unknown>>(template: T, options?: TemplateOptions): TemplateFunction<T, C>;

package/dist/template/index.js

@@ -0,0 +1,25 @@
+import { TemplateCompiler } from './compiler.js';
+export const defaultEvaluator = {
+    inject: undefined,
+    compile: (expression, type) => {
+        switch (type) {
+            case 'formula':
+                return `context[${JSON.stringify(expression)}]`;
+            case 'interpolation':
+                return `(context[${JSON.stringify(expression)}] ?? '')`;
+            /* c8 ignore next 2 */
+            default:
+                throw new Error(`Unsupported type: ${type}`);
+        }
+    },
+};
+/** 创建模板 */
+export function template(template, options = {}) {
+    const opt = {
+        objectKeyMode: 'template',
+        evaluator: defaultEvaluator,
+        ...options,
+    };
+    return new TemplateCompiler(template, opt).build();
+}
+//# sourceMappingURL=index.js.map

package/dist/template/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/template/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AA0BjD,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IAC/C,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE;QAC1B,QAAQ,IAAI,EAAE,CAAC;YACX,KAAK,SAAS;gBACV,OAAO,WAAW,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;YACpD,KAAK,eAAe;gBAChB,OAAO,YAAY,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC;YAC5D,sBAAsB;YACtB;gBACI,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAA8B,EAAE,CAAC,CAAC;QAC/E,CAAC;IACL,CAAC;CACJ,CAAC;AAOF,WAAW;AACX,MAAM,UAAU,QAAQ,CACpB,QAAW,EACX,UAA2B,EAAE;IAE7B,MAAM,GAAG,GAAG;QACR,aAAa,EAAE,UAAU;QACzB,SAAS,EAAE,gBAAgB;QAC3B,GAAG,OAAO;KACb,CAAC;IACF,OAAO,IAAI,gBAAgB,CAAC,QAAQ,EAAE,GAAgC,CAAC,CAAC,KAAK,EAA4B,CAAC;AAC9G,CAAC"}

package/jest.config.js

@@ -0,0 +1,3 @@
+import { config } from '../../jest.config.js';
+
+export default { ...config };

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@cloudpss/template",
+  "version": "0.5.23",
+  "author": "CloudPSS",
+  "license": "MIT",
+  "keywords": [
+    "template",
+    "string-template",
+    "template-string"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": "./dist/index.js",
+  "scripts": {
+    "start": "pnpm clean && tsc --watch",
+    "build": "pnpm clean && tsc",
+    "clean": "rimraf dist",
+    "test": "NODE_OPTIONS=\"${NODE_OPTIONS:-} --experimental-vm-modules\" jest"
+  }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export { parseTemplate } from './parser.js';
+export type { Template } from './parser.js';
+export { template } from './template/index.js';
+export type { TemplateFunction, TemplateOptions } from './template/index.js';

package/src/parser.ts

@@ -0,0 +1,143 @@
+/** 字符串模板 */
+export type Template =
+    | string
+    | {
+          type: 'formula';
+          value: string;
+      }
+    | {
+          type: 'interpolation';
+          templates: string[];
+          values: string[];
+      };
+
+/** 字符串模板类型 */
+export type TemplateType = (Template & object)['type'];
+
+enum ParserStatus {
+    Text,
+    ExpressionSimple,
+    ExpressionComplex,
+}
+Object.freeze(ParserStatus);
+
+/**
+ * 解析字符串插值模板
+ * @example parseInterpolation("$hello $name! I am $age years old. I'll be ${age+1} next year. Give me $$100.")
+ * // {
+ * //   type: 'interpolation',
+ * //   templates: ['hello ', '! I am ', ' years old. I\'ll be ', ' next year. Give me $$100.'],
+ * //   values: ['name', 'age', 'age+1']
+ * // }
+ */
+function parseInterpolation(template: string): Template {
+    const templates: string[] = [];
+    const values: string[] = [];
+    let currentTemplate = '';
+    let currentValue = '';
+    let expressionComplexDepth = 0;
+    let status = ParserStatus.Text;
+
+    for (let i = 1; i < template.length; i++) {
+        const char = template[i];
+
+        if (status === ParserStatus.Text) {
+            if (char !== '$') {
+                currentTemplate += char;
+                continue;
+            }
+            if (i === template.length - 1) {
+                // End of input
+                currentTemplate += char;
+                continue;
+            }
+            const nextChar = template[i + 1];
+            if (nextChar === '$') {
+                // Escaped dollar sign
+                currentTemplate += char;
+                i++;
+                continue;
+            }
+            if (nextChar === '{') {
+                // Start of expression
+                templates.push(currentTemplate);
+                currentTemplate = '';
+                status = ParserStatus.ExpressionComplex;
+                expressionComplexDepth = 1;
+                i++;
+                continue;
+            }
+            if (/[a-zA-Z_]/.exec(nextChar)) {
+                // Start of expression
+                templates.push(currentTemplate);
+                currentTemplate = '';
+                status = ParserStatus.ExpressionSimple;
+                continue;
+            }
+            // Not an expression
+            currentTemplate += char;
+            continue;
+        }
+        if (status === ParserStatus.ExpressionSimple) {
+            if (/[a-zA-Z0-9_]/.exec(char)) {
+                currentValue += char;
+                continue;
+            }
+            // End of expression
+            values.push(currentValue);
+            currentValue = '';
+            status = ParserStatus.Text;
+            i--;
+            continue;
+        }
+        if (status === ParserStatus.ExpressionComplex) {
+            if (char === '{') {
+                expressionComplexDepth++;
+            } else if (char === '}') {
+                expressionComplexDepth--;
+                if (expressionComplexDepth === 0) {
+                    // End of expression
+                    values.push(currentValue.trim());
+                    currentValue = '';
+                    status = ParserStatus.Text;
+                    continue;
+                }
+            }
+            currentValue += char;
+            continue;
+        }
+    }
+    if (status === ParserStatus.Text) {
+        templates.push(currentTemplate);
+    } else if (status === ParserStatus.ExpressionSimple) {
+        values.push(currentValue);
+        templates.push('');
+    } else {
+        throw new Error('Unexpected end of input');
+    }
+
+    if (values.length === 0) return templates[0];
+
+    return {
+        type: 'interpolation',
+        templates,
+        values,
+    };
+}
+
+/**
+ * 解析字符串模板
+ */
+export function parseTemplate(template: string): Template {
+    if (!template) return '';
+    if (template.startsWith('=')) {
+        return {
+            type: 'formula',
+            value: template.slice(1).trim(),
+        };
+    }
+    if (template.startsWith('$')) {
+        return parseInterpolation(template);
+    }
+    return template;
+}

package/src/template/compiler.ts

@@ -0,0 +1,138 @@
+import { parseTemplate, type TemplateType } from '../parser.js';
+import type { TemplateFunction, TemplateOptions } from './index.js';
+
+/** 是否为 ArrayBuffer */
+function isArrayBuffer(value: object): value is ArrayBuffer | SharedArrayBuffer {
+    if (value instanceof ArrayBuffer) return true;
+    if (typeof SharedArrayBuffer == 'function' && value instanceof SharedArrayBuffer) return true;
+    return false;
+}
+
+/** 是否为 Error */
+function isError(value: unknown): value is Error {
+    return value instanceof Error || (typeof DOMException == 'function' && value instanceof DOMException);
+}
+
+const KNOWN_ERRORS = [EvalError, RangeError, ReferenceError, SyntaxError, TypeError, URIError] as const;
+
+/** 创建模板 */
+export class TemplateCompiler {
+    constructor(
+        readonly template: unknown,
+        readonly options: Required<TemplateOptions>,
+    ) {}
+    private readonly params = new Map<string, unknown>();
+    private readonly copyable: unknown[] = [];
+    /** 构建求值 */
+    private buildEval(expression: string, type: TemplateType): string {
+        const { evaluator } = this.options;
+        if (!this.params.has('evaluator')) {
+            this.params.set('evaluator', evaluator.inject);
+        }
+        return evaluator.compile(expression, type);
+    }
+    /** 构建字符串 */
+    private buildString(str: string): string {
+        const parsed = parseTemplate(str);
+        if (typeof parsed === 'string') return JSON.stringify(parsed);
+        if (parsed.type === 'formula') return this.buildEval(parsed.value, parsed.type);
+        let result = '';
+        for (let i = 0; i < parsed.templates.length; i++) {
+            if (parsed.templates[i]) {
+                result += (result ? '+' : '') + JSON.stringify(parsed.templates[i]);
+            }
+            if (i < parsed.values.length) {
+                if (!result) result = '""';
+                result += '+' + this.buildEval(parsed.values[i], parsed.type);
+            }
+        }
+        return '(' + result + ')';
+    }
+    /** 构建 Error */
+    private buildError(err: Error): string {
+        if (typeof DOMException == 'function' && err instanceof DOMException) {
+            return `new DOMException(${this.buildString(err.message)}, ${this.buildString(err.name)})`;
+        }
+        const constructor = KNOWN_ERRORS.find((type) => err instanceof type)?.name ?? 'Error';
+        if (err.name === constructor) {
+            return `new ${constructor}(${this.buildString(err.message)})`;
+        }
+        return `Object.assign(new ${constructor}(${this.buildString(err.message)}), {name: ${this.buildString(err.name)}})`;
+    }
+    /** 构建数组 */
+    private buildArray(arr: unknown[]): string {
+        return `[${arr.map(this.buildValue.bind(this)).join(',')}]`;
+    }
+    /** 构建 ArrayBuffer */
+    private buildArrayBuffer(buffer: ArrayBuffer | SharedArrayBuffer): string {
+        this.copyable.push(buffer.slice(0));
+        return `copyable[${this.copyable.length - 1}].slice(0)`;
+    }
+    /** 构建 ArrayBufferView */
+    private buildArrayBufferView(view: ArrayBufferView): string {
+        this.copyable.push(view.buffer.slice(view.byteOffset, view.byteOffset + view.byteLength));
+        return `new ${view.constructor.name}(copyable[${this.copyable.length - 1}].slice(0))`;
+    }
+    /** 构建对象 */
+    private buildObject(obj: Record<string, unknown>): string {
+        let result = '';
+        for (const key in obj) {
+            if (!Object.prototype.hasOwnProperty.call(obj, key)) continue;
+            const value = obj[key];
+            if (result) result += ',';
+            if (this.options.objectKeyMode === 'ignore') {
+                result += JSON.stringify(key);
+            } else {
+                result += '[' + this.buildString(key) + ']';
+            }
+            result += ':';
+            result += this.buildValue(value);
+        }
+        return '{' + result + '}';
+    }
+    /** 构建值 */
+    private buildValue(value: unknown): string {
+        if (value === null) return 'null';
+        if (value === undefined) return 'undefined';
+        if (value === true) return 'true';
+        if (value === false) return 'false';
+        if (typeof value == 'function') return 'undefined';
+        if (typeof value == 'symbol') return 'undefined';
+        if (typeof value == 'bigint') return `${value}n`;
+        if (typeof value == 'number') return String(value);
+        if (typeof value == 'string') return this.buildString(value);
+        /* c8 ignore next */
+        if (typeof value != 'object') throw new Error(`Unsupported value: ${Object.prototype.toString.call(value)}`);
+        if (value instanceof Date) return `new Date(${value.getTime()})`;
+        if (value instanceof RegExp) return value.toString();
+        if (isError(value)) return this.buildError(value);
+        if (Array.isArray(value)) return this.buildArray(value);
+        if (isArrayBuffer(value)) return this.buildArrayBuffer(value);
+        if (ArrayBuffer.isView(value)) return this.buildArrayBufferView(value);
+        return this.buildObject(value as Record<string, unknown>);
+    }
+    /** 构建模板 */
+    build(): TemplateFunction {
+        const source = this.buildValue(this.template);
+        if (this.copyable.length) {
+            this.params.set('copyable', this.copyable);
+        }
+        const params = [...this.params];
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-implied-eval
+            const result = new Function(
+                ...params.map(([key]) => key),
+                'context',
+                `
+            if (context == null) context = {};
+            return (${source});
+            `,
+            ).bind(undefined, ...params.map(([, value]) => value)) as TemplateFunction;
+            result.source = source;
+            return result;
+            /* c8 ignore next 3 */
+        } catch (e) {
+            throw new Error(`Failed to compile template: ${source}\n${(e as Error).message}`, { cause: e });
+        }
+    }
+}

package/src/template/index.ts

@@ -0,0 +1,59 @@
+import type { TemplateType } from '../parser.js';
+import { TemplateCompiler } from './compiler.js';
+
+/** 模板编译求值 */
+export type TemplateEvaluator = {
+    /** 注入为 `evaluator` 变量，可在生成的求值代码中使用 */
+    inject: unknown;
+    /** 生成求值代码，可用变量：`evaluator` `context` */
+    compile: (expression: string, type: TemplateType) => string;
+};
+
+/** 模板选项 */
+export interface TemplateOptions {
+    /**
+     * 模板求值器
+     * @default context?.[expression] ?? (type === 'formula' ? undefined : '')
+     */
+    evaluator?: TemplateEvaluator;
+    /**
+     * 对 object key 的处理方式
+     * - `template` 使用模板进行插值
+     * - `ignore` 原样输出
+     * @default 'template'
+     */
+    objectKeyMode?: 'template' | 'ignore';
+}
+
+export const defaultEvaluator: TemplateEvaluator = {
+    inject: undefined,
+    compile: (expression, type) => {
+        switch (type) {
+            case 'formula':
+                return `context[${JSON.stringify(expression)}]`;
+            case 'interpolation':
+                return `(context[${JSON.stringify(expression)}] ?? '')`;
+            /* c8 ignore next 2 */
+            default:
+                throw new Error(`Unsupported type: ${type satisfies never as string}`);
+        }
+    },
+};
+
+/** 已编译的模板函数 */
+export type TemplateFunction<T = unknown, C = Record<string, unknown>> = ((context?: C) => T) & {
+    source: string;
+};
+
+/** 创建模板 */
+export function template<T = unknown, C = Record<string, unknown>>(
+    template: T,
+    options: TemplateOptions = {},
+): TemplateFunction<T, C> {
+    const opt = {
+        objectKeyMode: 'template',
+        evaluator: defaultEvaluator,
+        ...options,
+    };
+    return new TemplateCompiler(template, opt as Required<TemplateOptions>).build() as TemplateFunction<T, C>;
+}

package/tests/parser.js

@@ -0,0 +1,184 @@
+import { parseTemplate } from '../dist/parser.js';
+
+describe('parseTemplate', () => {
+    describe('should parse plain', () => {
+        it('empty string', () => {
+            // @ts-expect-error test
+            expect(parseTemplate(null)).toEqual('');
+            // @ts-expect-error test
+            expect(parseTemplate(undefined)).toEqual('');
+            expect(parseTemplate('')).toEqual('');
+        });
+        it('string', () => {
+            expect(parseTemplate('Hello, world!')).toEqual('Hello, world!');
+            expect(parseTemplate('\u0000')).toEqual('\u0000');
+            expect(parseTemplate(' ')).toEqual(' ');
+            // bad surrogate pair
+            expect(parseTemplate('\uD800')).toEqual('\uD800');
+            expect(parseTemplate('\uDC00')).toEqual('\uDC00');
+        });
+        it('template like (but not)', () => {
+            expect(parseTemplate(' = 1+1')).toEqual(' = 1+1');
+            expect(parseTemplate(' =1+1')).toEqual(' =1+1');
+            expect(parseTemplate(' =1+1 ')).toEqual(' =1+1 ');
+            expect(parseTemplate(' =1+1 ')).toEqual(' =1+1 ');
+            expect(parseTemplate(' $aa')).toEqual(' $aa');
+        });
+    });
+
+    it('should parse formulas', () => {
+        expect(parseTemplate('= 1+1')).toEqual({ type: 'formula', value: '1+1' });
+        expect(parseTemplate('= 1+1 ')).toEqual({ type: 'formula', value: '1+1' });
+        expect(parseTemplate('=arg')).toEqual({ type: 'formula', value: 'arg' });
+        expect(parseTemplate('=arg1+arg2')).toEqual({ type: 'formula', value: 'arg1+arg2' });
+    });
+
+    describe('should parse interpolation', () => {
+        it('optimize for no interpolation', () => {
+            expect(parseTemplate('$')).toBe('');
+            expect(parseTemplate('$not')).toBe('not');
+            expect(parseTemplate('$not interpolation')).toBe('not interpolation');
+            expect(parseTemplate('$$')).toBe('$');
+            expect(parseTemplate('$$$')).toBe('$');
+            expect(parseTemplate('$$$$')).toBe('$$');
+        });
+
+        it('should parse simple interpolation', () => {
+            expect(parseTemplate('$hello $name!')).toEqual({
+                type: 'interpolation',
+                templates: ['hello ', '!'],
+                values: ['name'],
+            });
+            expect(parseTemplate('$$name')).toEqual({
+                type: 'interpolation',
+                templates: ['', ''],
+                values: ['name'],
+            });
+            expect(parseTemplate('$$name_is_long')).toEqual({
+                type: 'interpolation',
+                templates: ['', ''],
+                values: ['name_is_long'],
+            });
+            expect(parseTemplate('$$_001')).toEqual({
+                type: 'interpolation',
+                templates: ['', ''],
+                values: ['_001'],
+            });
+            expect(parseTemplate('$$001$a')).toEqual({
+                type: 'interpolation',
+                templates: ['$001', ''],
+                values: ['a'],
+            });
+            expect(parseTemplate('$$name$a')).toEqual({
+                type: 'interpolation',
+                templates: ['', '', ''],
+                values: ['name', 'a'],
+            });
+        });
+
+        it('should parse complex interpolation', () => {
+            expect(parseTemplate('$hello ${name}!')).toEqual({
+                type: 'interpolation',
+                templates: ['hello ', '!'],
+                values: ['name'],
+            });
+            expect(parseTemplate('$${name}')).toEqual({
+                type: 'interpolation',
+                templates: ['', ''],
+                values: ['name'],
+            });
+            expect(parseTemplate('$${name_is_long}')).toEqual({
+                type: 'interpolation',
+                templates: ['', ''],
+                values: ['name_is_long'],
+            });
+            expect(parseTemplate('$${_001}')).toEqual({
+                type: 'interpolation',
+                templates: ['', ''],
+                values: ['_001'],
+            });
+            expect(parseTemplate('$1${  }2')).toEqual({
+                type: 'interpolation',
+                templates: ['1', '2'],
+                values: [''],
+            });
+            expect(parseTemplate('$${ name }${ a}')).toEqual({
+                type: 'interpolation',
+                templates: ['', '', ''],
+                values: ['name', 'a'],
+            });
+        });
+
+        it('should parse mixed interpolation', () => {
+            expect(parseTemplate('$$name${a}')).toEqual({
+                type: 'interpolation',
+                templates: ['', '', ''],
+                values: ['name', 'a'],
+            });
+            expect(parseTemplate('$${name }$a')).toEqual({
+                type: 'interpolation',
+                templates: ['', '', ''],
+                values: ['name', 'a'],
+            });
+            expect(
+                parseTemplate("$hello $name! I am $age years old. I'll be ${age+1} next year. Give me $$100."),
+            ).toEqual({
+                type: 'interpolation',
+                templates: ['hello ', '! I am ', " years old. I'll be ", ' next year. Give me $100.'],
+                values: ['name', 'age', 'age+1'],
+            });
+        });
+
+        it('should not break on normal braces', () => {
+            expect(parseTemplate('$$aa{$b}')).toEqual({
+                type: 'interpolation',
+                templates: ['', '{', '}'],
+                values: ['aa', 'b'],
+            });
+            expect(parseTemplate('$$aa{$}')).toEqual({
+                type: 'interpolation',
+                templates: ['', '{$}'],
+                values: ['aa'],
+            });
+            expect(parseTemplate('$$aa{}')).toEqual({
+                type: 'interpolation',
+                templates: ['', '{}'],
+                values: ['aa'],
+            });
+            expect(parseTemplate('$$$$aa{}')).toEqual({
+                type: 'interpolation',
+                templates: ['$', '{}'],
+                values: ['aa'],
+            });
+        });
+
+        it('should throw on invalid interpolation', () => {
+            expect(() => parseTemplate('$${')).toThrow('Unexpected end of input');
+            expect(() => parseTemplate('$${123')).toThrow('Unexpected end of input');
+            expect(() => parseTemplate('$${{123}')).toThrow('Unexpected end of input');
+        });
+
+        it('should pair braces', () => {
+            expect(parseTemplate('$${n{am}e}')).toEqual({
+                type: 'interpolation',
+                templates: ['', ''],
+                values: ['n{am}e'],
+            });
+            expect(parseTemplate('$${n{{a}m}e}')).toEqual({
+                type: 'interpolation',
+                templates: ['', ''],
+                values: ['n{{a}m}e'],
+            });
+            expect(parseTemplate('$aaa${n{{a}m}e}bbb')).toEqual({
+                type: 'interpolation',
+                templates: ['aaa', 'bbb'],
+                values: ['n{{a}m}e'],
+            });
+            expect(parseTemplate('$aaa${n{{a}m}e}${n{{a}m}e}bbb${n{{a}m}e}ccc')).toEqual({
+                type: 'interpolation',
+                templates: ['aaa', '', 'bbb', 'ccc'],
+                values: ['n{{a}m}e', 'n{{a}m}e', 'n{{a}m}e'],
+            });
+        });
+    });
+});

package/tests/template.js

@@ -0,0 +1,261 @@
+import { randomBytes, randomFillSync } from 'node:crypto';
+import { template } from '@cloudpss/template';
+
+describe('template', () => {
+    it('should handle primitives', () => {
+        expect(template('')()).toEqual('');
+        expect(template('Hello, world!')()).toEqual('Hello, world!');
+        expect(template(1)()).toEqual(1);
+        expect(template(1.1)()).toEqual(1.1);
+        expect(template(Number.NaN)()).toEqual(Number.NaN);
+        expect(template(Number.POSITIVE_INFINITY)()).toEqual(Number.POSITIVE_INFINITY);
+        expect(template(Number.NEGATIVE_INFINITY)()).toEqual(Number.NEGATIVE_INFINITY);
+        expect(template(Number.EPSILON)()).toEqual(Number.EPSILON);
+        expect(template(true)()).toEqual(true);
+        expect(template(false)()).toEqual(false);
+        expect(template(null)()).toEqual(null);
+        expect(template(undefined)()).toEqual(undefined);
+        expect(template(1n)()).toEqual(1n);
+        expect(
+            template({
+                string: 'Hello, world!',
+                number: 1,
+                boolean: true,
+                null: null,
+                undefined: undefined,
+                bigint: 1n,
+            })(),
+        ).toEqual({
+            string: 'Hello, world!',
+            number: 1,
+            boolean: true,
+            null: null,
+            undefined: undefined,
+            bigint: 1n,
+        });
+    });
+    it('should ignore symbols', () => {
+        expect(template(Symbol(''))()).toEqual(undefined);
+        expect(
+            template({
+                key: Symbol(''),
+                [Symbol('')]: 1,
+            })(),
+        ).toEqual({
+            key: undefined,
+        });
+    });
+    it('should ignore functions', () => {
+        expect(template(() => 1)()).toEqual(undefined);
+        expect(
+            template({
+                key: () => 1,
+            })(),
+        ).toEqual({
+            key: undefined,
+        });
+    });
+    it('should copy arrays', () => {
+        const arr = [1, 2, {}];
+        const result = template(arr)();
+        expect(result).toEqual(arr);
+        expect(result).not.toBe(arr);
+        expect(result[2]).not.toBe(arr[2]);
+    });
+    it('should copy objects', () => {
+        const obj = { a: 1, b: 2, c: {} };
+        const result = template(obj)();
+        expect(result).toEqual(obj);
+        expect(result).not.toBe(obj);
+        expect(result.c).not.toBe(obj.c);
+    });
+    it('should copy dates', () => {
+        const date = new Date();
+        const result = template(date)();
+        expect(result).toEqual(date);
+        expect(result).not.toBe(date);
+    });
+    it('should copy regexps', () => {
+        const regexp = /./gi;
+        const result = template(regexp)();
+        expect(result).toEqual(regexp);
+        expect(result).not.toBe(regexp);
+    });
+    describe('should copy errors', () => {
+        it('Error', () => {
+            const error = new Error('test error');
+            const result = template(error)();
+            expect(result).toBeInstanceOf(Error);
+            expect(result.name).toBe(error.name);
+            expect(result.message).toBe(error.message);
+            expect(result).not.toBe(error);
+        });
+
+        it('TypeError', () => {
+            const error = new TypeError('test error');
+            const result = template(error)();
+            expect(result).toBeInstanceOf(TypeError);
+            expect(result.name).toBe(error.name);
+            expect(result.message).toBe(error.message);
+            expect(result).not.toBe(error);
+        });
+
+        it('SyntaxError with custom name', () => {
+            const error = new SyntaxError('test error');
+            error.name = 'CustomError';
+            const result = template(error)();
+            expect(result).toBeInstanceOf(SyntaxError);
+            expect(result.name).toBe(error.name);
+            expect(result.message).toBe(error.message);
+            expect(result).not.toBe(error);
+        });
+
+        it('DOMException', () => {
+            const error = new DOMException('test error', 'AbortError');
+            const result = template(error)();
+            expect(result).toBeInstanceOf(DOMException);
+            expect(result.name).toBe(error.name);
+            expect(result.message).toBe(error.message);
+            expect(result.code).toBe(error.code);
+            expect(result).not.toBe(error);
+        });
+
+        it('CustomError', () => {
+            const error = new (class CustomError extends Error {})('test error');
+            const result = template(error)();
+            expect(result).toBeInstanceOf(Error);
+            expect(result.name).toBe(error.name);
+            expect(result.message).toBe(error.message);
+            expect(result).not.toBe(error);
+        });
+    });
+    describe('should copy ArrayBuffers', () => {
+        it('ArrayBuffer', () => {
+            const buffer = randomBytes(16).buffer;
+            const t = template(buffer);
+            const result1 = t();
+            const result2 = t();
+            expect(new Uint8Array(result1)).toEqual(new Uint8Array(buffer));
+            expect(new Uint8Array(result2)).toEqual(new Uint8Array(buffer));
+            expect(result1).not.toBe(buffer);
+            expect(result2).not.toBe(buffer);
+            expect(result1).not.toBe(result2);
+        });
+        it('SharedArrayBuffer', () => {
+            const buffer = new SharedArrayBuffer(16);
+            randomFillSync(new Uint8Array(buffer));
+            const result = template(buffer)();
+            expect(new Uint8Array(result)).toEqual(new Uint8Array(buffer));
+            expect(result).toBeInstanceOf(SharedArrayBuffer);
+            expect(result).not.toBe(buffer);
+        });
+    });
+    describe('should copy ArrayBufferViews', () => {
+        it('DataView', () => {
+            const buffer = randomBytes(64).buffer;
+            const view = new DataView(buffer, 32, 16);
+            const result = template(view)();
+            expect(result).toEqual(view);
+            expect(result).not.toBe(view);
+            expect(new Uint8Array(result.buffer)).toEqual(new Uint8Array(buffer, view.byteOffset, view.byteLength));
+            expect(result.buffer).not.toBe(buffer);
+        });
+        it('Uint8Array', () => {
+            const buffer = randomBytes(64).buffer;
+            const view = new Uint8Array(buffer, 32, 16);
+            const result = template(view)();
+            expect(result).toEqual(view);
+            expect(result).not.toBe(view);
+            expect(new Uint8Array(result.buffer)).toEqual(new Uint8Array(buffer, view.byteOffset, view.byteLength));
+            expect(result.buffer).not.toBe(buffer);
+        });
+        it('Float64Array', () => {
+            const buffer = randomBytes(64).buffer;
+            const view = new Float64Array(buffer, 32, 1);
+            const result = template(view)();
+            expect(result).toEqual(view);
+            expect(result).not.toBe(view);
+            expect(new Uint8Array(result.buffer)).toEqual(new Uint8Array(buffer, view.byteOffset, view.byteLength));
+            expect(result.buffer).not.toBe(buffer);
+        });
+        it('BigInt64Array', () => {
+            const buffer = randomBytes(64).buffer;
+            const view = new BigInt64Array(buffer, 32, 1);
+            const t = template(view);
+            const result1 = t();
+            const result2 = t();
+            expect(result1).toEqual(view);
+            expect(result1).not.toBe(view);
+            expect(result2).toEqual(view);
+            expect(result2).not.toBe(view);
+            expect(result2).not.toBe(result1);
+            expect(new Uint8Array(result1.buffer)).toEqual(new Uint8Array(buffer, view.byteOffset, view.byteLength));
+            expect(new Uint8Array(result2.buffer)).toEqual(new Uint8Array(buffer, view.byteOffset, view.byteLength));
+            expect(result1.buffer).not.toBe(buffer);
+            expect(result2.buffer).not.toBe(buffer);
+            expect(result1.buffer).not.toBe(result2.buffer);
+        });
+    });
+    it('should build interpolated strings', () => {
+        const t = template({ hello: '$Hello, ${name}!', not: 'Hello $name', array: ['$$name', '$not'] });
+        const result = t({
+            name: 'world',
+        });
+        expect(result).toEqual({
+            hello: 'Hello, world!',
+            not: 'Hello $name',
+            array: ['world', 'not'],
+        });
+    });
+    it('should ignore properties on the prototype chain', () => {
+        const obj = Object.create({ prototype: 'chain' });
+        obj.own = 'property';
+        const result = template(obj)();
+        expect(result).toEqual({ own: 'property' });
+    });
+    it('should ignore non-enumerable properties', () => {
+        const obj = Object.create(null, {
+            enumerable: {
+                value: 'property',
+                enumerable: false,
+            },
+        });
+        const result = template(obj)();
+        expect(result).toEqual({});
+    });
+    describe('should work while objectKeyMode is', () => {
+        it('template', () => {
+            const obj = { $: 1, _: 2, '=x': 3, $$y: 4 };
+            const result = template(obj, { objectKeyMode: 'template' })({ x: 11n, y: 12 });
+            expect(result).toEqual({
+                '': 1,
+                _: 2,
+                11: 3,
+                12: 4,
+            });
+        });
+        it('ignore', () => {
+            const obj = { $: 1, _: 2, '=x': 3, $$y: 4 };
+            const result = template(obj, { objectKeyMode: 'ignore' })({ x: 11n, y: 12 });
+            expect(result).toEqual({
+                $: 1,
+                _: 2,
+                '=x': 3,
+                $$y: 4,
+            });
+        });
+    });
+
+    describe('should work with default evaluator', () => {
+        it('with formula', () => {
+            const obj = { a: '=a', b: '=b' };
+            const result = template(obj)({ a: 1 });
+            expect(result).toEqual({ a: 1, b: undefined });
+        });
+        it('with interpolation', () => {
+            const obj = { a: '$$a', b: '$$b' };
+            const result = template(obj)({ a: 1 });
+            expect(result).toEqual({ a: '1', b: '' });
+        });
+    });
+});

package/tests/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../tsconfig",
+  "include": ["./"],
+  "compilerOptions": {
+    "checkJs": true,
+    "noEmit": true
+  }
+}

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig",
+  "include": ["./src/"],
+  "compilerOptions": {
+    "outDir": "./dist"
+  }
+}