@mirascript/mirascript 0.1.3 → 0.1.5

package/dist/vm/lib/global/to-primitive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-primitive.d.ts","sourceRoot":"","sources":["../../../../src/vm/lib/global/to-primitive.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEjD,eAAO,MAAM,SAAS,uEAYrB,CAAC;AAEF,eAAO,MAAM,SAAS,uEAYrB,CAAC;AAEF,eAAO,MAAM,UAAU,wEAYtB,CAAC;AAEF,eAAO,MAAM,MAAM,6HAYlB,CAAC"}
+{"version":3,"file":"to-primitive.d.ts","sourceRoot":"","sources":["../../../../src/vm/lib/global/to-primitive.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,SAAS,mIAYrB,CAAC;AAEF,eAAO,MAAM,SAAS,mIAYrB,CAAC;AAEF,eAAO,MAAM,UAAU,oIAYtB,CAAC;AAEF,eAAO,MAAM,MAAM,yLAYlB,CAAC"}

package/dist/vm/types/wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../../src/vm/types/wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,8BAAsB,SAAS,CAAC,CAAC,SAAS,MAAM;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAAR,KAAK,EAAE,CAAC;IAC7B,cAAc;IACd,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAClC,cAAc;IACd,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK;IAChC,WAAW;IACX,QAAQ,CAAC,IAAI,IAAI,MAAM,EAAE;IACzB,aAAa;IACb,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IACpC,WAAW;IACX,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC;IAC9B,WAAW;IACX,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC;IAChC,iCAAiC;IACjC,MAAM,IAAI,SAAS;IAGnB,YAAY;IACZ,QAAQ,IAAI,MAAM;CAGrB;AAID,4BAA4B;AAC5B,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,CAEnF"}
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../../src/vm/types/wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,8BAAsB,SAAS,CAAC,CAAC,SAAS,MAAM;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAAR,KAAK,EAAE,CAAC;IAC7B,cAAc;IACd,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAClC,cAAc;IACd,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK;IAChC,WAAW;IACX,QAAQ,CAAC,IAAI,IAAI,MAAM,EAAE;IACzB,aAAa;IACb,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IACpC,WAAW;IACX,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC;IAC9B,WAAW;IACX,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC;IAChC,iCAAiC;IACjC,MAAM,IAAI,SAAS;IAGnB,YAAY;IACZ,QAAQ,IAAI,MAAM;CAKrB;AAID,4BAA4B;AAC5B,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,CAEnF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mirascript/mirascript",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "description": "An expression based scripting language.",
   "main": "./dist/index.js",
@@ -35,8 +35,10 @@
     "ansi-styles": "^6.2.3",
     "commander": "^14.0.2",
     "js-base64": "^3.7.8",
-    "@mirascript/napi": "~0.1.3",
-    "@mirascript/wasm": "~0.1.3"
+    "source-map-js": "^1.2.1",
+    "supports-color": "^10.2.2",
+    "@mirascript/napi": "~0.1.5",
+    "@mirascript/wasm": "~0.1.5"
   },
   "devDependencies": {
     "@types/node": "^24.10.0",
@@ -44,13 +46,13 @@
     "ava": "^6.4.1",
     "c8": "^10.1.3",
     "sinon": "^21.0.0",
-    "type-fest": "^5.1.0"
+    "type-fest": "^5.2.0"
   },
   "scripts": {
     "watch": "pnpm build:ts --watch",
     "build:ts": "pnpm clean && tsc",
     "build": "pnpm build:ts --emitDeclarationOnly && node ./esbuild.config.js",
-    "mirascript": "node ./dist/cli/index.js",
+    "mirascript": "node --enable-source-maps ./dist/cli/index.js",
     "clean": "rimraf dist",
     "test": "c8 ava"
   }

package/src/cli/execute.ts

@@ -1,21 +1,24 @@
 /* eslint-disable no-console */
 import styles from 'ansi-styles';
+import supportsColor from 'supports-color';
 import { compile } from '../index.js';
 import { createVmContext, VmFunction, type VmValue } from '../vm/index.js';
 import { debug_print } from '../vm/lib/global/debug.js';
 import { print } from './print.js';
 
 /** 执行脚本 */
-export async function execute(script: string, template: boolean, variables: Record<string, VmValue>): Promise<void> {
+export async function execute(
+    script: string,
+    template: boolean,
+    variables: Record<string, VmValue>,
+    fileName: string,
+): Promise<void> {
     try {
-        const f = await compile(script, { input_mode: template ? 'Template' : 'Script' });
+        const f = await compile(script, { input_mode: template ? 'Template' : 'Script', sourceMap: true, fileName });
         const r = f(
             createVmContext({
                 debug_print: VmFunction((...values) => {
-                    console.log(
-                        '\u001B[46;30m MiraScript \u001B[0m',
-                        ...values.map((v) => (typeof v == 'string' ? v : print(v))),
-                    );
+                    console.log(...debug_print.prefix, ...values.map((v) => (typeof v == 'string' ? v : print(v))));
                 }, debug_print),
                 ...variables,
             }),
@@ -26,7 +29,12 @@ export async function execute(script: string, template: boolean, variables: Reco
             console.log(print(r));
         }
     } catch (ex) {
-        console.error(styles.red.open + (ex as Error).message + styles.red.close);
+        const { stack } = ex as Error;
+        if (supportsColor.stderr) {
+            console.error(styles.red.open + stack + styles.red.close);
+        } else {
+            console.error(stack);
+        }
         process.exitCode = 2;
     }
 }

package/src/cli/index.ts

@@ -1,11 +1,14 @@
 /* c8 ignore start */
 /* eslint-disable no-console */
 import { readFile, stat } from 'node:fs/promises';
-import { program } from '@commander-js/extra-typings';
+import { pathToFileURL } from 'node:url';
+import { InvalidArgumentError, program } from '@commander-js/extra-typings';
 import { execute } from './execute.js';
 import pkg from '../../package.json' with { type: 'json' };
 import { compileSync } from '../compiler/index.js';
-import type { VmValue } from '../vm/index.js';
+import { configCheckpoint, type VmValue } from '../vm/index.js';
+
+const DEFAULT_TIMEOUT = 3000;
 
 program.name(pkg.name.split('/').pop()!).version(pkg.version).description(pkg.description);
 
@@ -33,12 +36,26 @@ program
         {} as Record<string, VmValue>,
     )
     .option('-t, --template', '使用模板模式')
+    .option(
+        '--timeout <ms>',
+        '脚本执行超时时间（毫秒，0 表示不超时）',
+        (v) => {
+            const ms = Number.parseFloat(v);
+            if (Number.isNaN(ms) || ms < 0) {
+                throw new InvalidArgumentError('超时时间必须是非负整数');
+            }
+            return ms;
+        },
+        DEFAULT_TIMEOUT,
+    )
     .option('--no-template', '使用脚本模式')
     .option('-e, --eval <script>', '要执行的脚本')
     .argument('[script]', '要执行的脚本文件路径（如果提供了 -e 则忽略此参数）')
     .action(async (script, opt) => {
+        configCheckpoint(opt.timeout || Number.POSITIVE_INFINITY);
         if (opt.eval != null) {
-            await execute(opt.eval, !!opt.template, opt.variable);
+            const template = !!opt.template;
+            await execute(opt.eval, template, opt.variable, template ? 'eval.miratpl' : 'eval.mira');
             return;
         }
         if (script) {
@@ -62,9 +79,9 @@ program
                 }
                 return;
             }
-            const context = await readFile(script, 'utf8');
+            const context = await readFile(script, 'utf-8');
             const template = opt.template ?? script.endsWith('.miratpl');
-            await execute(context, template, opt.variable);
+            await execute(context, template, opt.variable, pathToFileURL(script).href);
             return;
         }
         program.help({ error: true });

package/src/cli/print.ts

@@ -1,40 +1,56 @@
 import styles from 'ansi-styles';
-import { serialize, type SerializeOptions } from '../subtle.js';
+import supportsColor from 'supports-color';
+import {
+    serialize,
+    serializeNumber,
+    serializeBoolean,
+    serializeNil,
+    type SerializeOptions,
+    operations,
+} from '../subtle.js';
 import type { VmAny, VmRecord } from '../vm/index.js';
 
+const noColor = !supportsColor.stdout;
+
 const options: Partial<SerializeOptions> = {
     maxDepth: 3,
-    serializeNil: () => styles.gray.open + 'nil' + styles.gray.close,
-    serializeBoolean: (v) => styles.blue.open + (v ? 'true' : 'false') + styles.blue.close,
-    serializeNumber: (v) =>
-        styles.yellow.open +
-        (Number.isNaN(v) ? 'nan' : Number.isFinite(v) ? v.toString() : v > 0 ? 'inf' : '-inf') +
-        styles.yellow.close,
-    serializeStringQuote: (v, open) => {
-        const q = styles.dim.open + v + styles.dim.close;
-        if (open) {
-            return styles.green.open + q;
-        } else {
-            return q + styles.green.close;
-        }
-    },
-    serializeStringEscape: (v) => styles.bold.open + v + styles.bold.close,
-    serializeFunction: (v) => styles.cyan.open + `<function ${v.name || 'anonymous'}>` + styles.cyan.close,
-    serializePropName: (v) => styles.whiteBright.open + String(v) + styles.whiteBright.close,
-    serializeModule: (v, depth, options) => {
-        return (
-            styles.magenta.open +
-            `<module ${v.name || 'anonymous'}>` +
-            styles.magenta.close +
-            ' ' +
-            options.serializeRecord(v.value as VmRecord, depth, options)
-        );
-    },
+    serializeNil: noColor ? undefined : () => styles.gray.open + serializeNil() + styles.gray.close,
+    serializeBoolean: noColor ? undefined : (v) => styles.blue.open + serializeBoolean(v) + styles.blue.close,
+    serializeNumber: noColor ? undefined : (v) => styles.yellow.open + serializeNumber(v) + styles.yellow.close,
+    serializeStringQuote: noColor
+        ? undefined
+        : (v, open) => {
+              const q = styles.dim.open + v + styles.dim.close;
+              if (open) {
+                  return styles.green.open + q;
+              } else {
+                  return q + styles.green.close;
+              }
+          },
+    serializeStringEscape: noColor ? undefined : (v) => styles.bold.open + v + styles.bold.close,
+    serializePropName: noColor ? undefined : (v) => styles.whiteBright.open + String(v) + styles.whiteBright.close,
+    serializeFunction: noColor
+        ? operations.$ToString
+        : (v) => styles.cyan.open + operations.$ToString(v) + styles.cyan.close,
+    serializeModule: noColor
+        ? (v, depth, options) => {
+              return operations.$ToString(v) + ' ' + options.serializeRecord(v.value as VmRecord, depth, options);
+          }
+        : (v, depth, options) => {
+              return (
+                  styles.magenta.open +
+                  operations.$ToString(v) +
+                  styles.magenta.close +
+                  ' ' +
+                  options.serializeRecord(v.value as VmRecord, depth, options)
+              );
+          },
 };
 
 /** 序列化值 */
 export function print(value: VmAny, depth = 3): string {
     if (value === undefined) {
+        if (noColor) return '<uninitialized>';
         return styles.gray.open + '<uninitialized>' + styles.gray.close;
     }
     return serialize(value, { ...options, maxDepth: depth });

package/src/compiler/diagnostic.ts

@@ -77,20 +77,30 @@ interface ParsedDiagnostics {
     references: SourceReference[];
     /** 标签引用诊断信息 */
     tagsReferences: SourceReference[];
+
+    /** 代码映射信息 */
+    sourcemaps: IRange[];
 }
 
 /** 分析诊断信息，{@link diagnostic_position_encoding} 不能设为 `None` */
-export function parseDiagnostics(source: ScriptInput, diagnostics: Uint32Array): ParsedDiagnostics {
+export function parseDiagnostics(
+    source: ScriptInput,
+    diagnostics: Uint32Array,
+    filter?: (code: DiagnosticCode) => boolean,
+): ParsedDiagnostics {
     const parsed = [];
     const bufLen = diagnostics.length;
     for (let i = 0; i < bufLen; i += 5) {
+        const code = diagnostics[i + 4]! as DiagnosticCode;
+        if (filter && !filter(code)) {
+            continue;
+        }
         const startLineNumber = diagnostics[i]!;
         const startColumn = diagnostics[i + 1]!;
         const endLineNumber = diagnostics[i + 2]!;
         const endColumn = diagnostics[i + 3]!;
-        const error = diagnostics[i + 4]! as DiagnosticCode;
         parsed.push({
-            code: error,
+            code,
             range: {
                 startLineNumber,
                 startColumn,
@@ -107,6 +117,7 @@ export function parseDiagnostics(source: ScriptInput, diagnostics: Uint32Array):
     const _tags: SourceDiagnostic[] = [];
     const _references: SourceReference[] = [];
     const _tagsReferences: SourceReference[] = [];
+    const _sourcemaps: IRange[] = [];
     for (let i = 0; i < parsed.length; i++) {
         const diagnostic = parsed[i]!;
         const { code } = diagnostic;
@@ -120,7 +131,11 @@ export function parseDiagnostics(source: ScriptInput, diagnostics: Uint32Array):
             _hints.push(diagnostic);
         } else if (code > DiagnosticCode.TagStart && code < DiagnosticCode.TagEnd) {
             _tags.push(diagnostic);
+        } else if (code === DiagnosticCode.SourceMap) {
+            _sourcemaps.push(diagnostic.range);
+            continue;
         } else {
+            // 非法诊断代码，跳过
             continue;
         }
         diagnostic.references = [];
@@ -151,6 +166,7 @@ export function parseDiagnostics(source: ScriptInput, diagnostics: Uint32Array):
         tags: _tags,
         references: _references,
         tagsReferences: _tagsReferences,
+        sourcemaps: _sourcemaps,
     };
 }
 

package/src/compiler/emit.ts

@@ -1,11 +1,18 @@
 import { OpCode } from '@mirascript/wasm/types';
-import { encodeURL } from 'js-base64';
+import { toBase64 } from 'js-base64';
 import type { VmConst, VmPrimitive } from '../vm/index.js';
 import type { ScriptInput, TranspileOptions } from './types.js';
+import type { IRange } from './diagnostic.js';
+import { SourceMapGenerator } from 'source-map-js';
 
 /** 生成代码 */
-export function emit(source: ScriptInput, chunk: Uint8Array, options: TranspileOptions): string {
-    const gen = new Emitter(source, chunk, options);
+export function emit(
+    source: ScriptInput,
+    chunk: Uint8Array,
+    sourcemaps: readonly IRange[],
+    options: TranspileOptions,
+): string {
+    const gen = new Emitter(source, chunk, sourcemaps, options);
     gen.read();
     const code = gen.codeLines.join('\n');
     return code;
@@ -57,7 +64,7 @@ function toJavascript(value: VmConst | undefined): string {
     return String(value);
 }
 
-const ORIGIN = `mira://MiraScript`;
+const ORIGIN = `mira://MiraScript/`;
 let sourceId = 1;
 
 /** 创建数组 */
@@ -75,6 +82,7 @@ class Emitter {
     constructor(
         readonly source: ScriptInput,
         readonly chunk: Uint8Array,
+        readonly sourcemaps: readonly IRange[],
         readonly options: TranspileOptions,
     ) {
         this.pretty = options.pretty ?? false;
@@ -362,9 +370,9 @@ class Emitter {
                 );
                 if (script) {
                     args.unshift(`global = GlobalFallback()`);
-                    code = `'use strict'; return (function script(${args.join(', ')}) { try { CpEnter(); var ${regs};`;
+                    code = `'use strict'; return ((${args.join(', ')}) => { try { CpEnter(); var ${regs};`;
                 } else {
-                    code = `${this.wv(reg)} = Function(function (${args.join(', ')}) { try { CpEnter(); var ${regs};`;
+                    code = `${this.wv(reg)} = Function((${args.join(', ')}) => { try { CpEnter(); var ${regs};`;
                 }
                 if (varg) {
                     code += ` var ${this.wv(argn, -1)} = Vargs(vargs);`;
@@ -688,6 +696,9 @@ class Emitter {
                 code = `continue;`;
                 break;
             }
+            case OpCode.Noop: {
+                return;
+            }
             default: {
                 code = `; // ${OpCode[opcode] ?? opcode}`;
                 break;
@@ -742,27 +753,42 @@ class Emitter {
         const hasSchema = /^\w+:/.test(fileName);
         if (!hasSchema) {
             if (fileName.startsWith('/')) {
-                fileName = fileName.replace(/^\\+\s*/, '');
+                fileName = fileName.replace(/^\/+\s*/, '');
             }
             if (!fileName) {
                 fileName = `${sourceId++}.${this.options.input_mode === 'Template' ? 'miratpl' : 'mira'}`;
             }
         }
-        const data = {
-            version: 3,
-            file: fileName,
-            sourceRoot: hasSchema ? '' : ORIGIN,
-            sources: [fileName],
-            sourcesContent: [ArrayBuffer.isView(this.source) ? null : this.source],
-            names: [],
-            mappings: '',
-        };
+        const map = new SourceMapGenerator({
+            file: fileName + '.js',
+        });
+        if (typeof this.source === 'string') {
+            map.setSourceContent(fileName, this.source);
+        }
+        for (let i = 0; i < this.sourcemaps.length; i++) {
+            const range = this.sourcemaps[i];
+            if (!range) break;
+            map.addMapping({
+                generated: {
+                    // 前两行固定为：
+                    // (function anonymous($Add,$Aeq, ...
+                    // ) {
+                    line: i + 3,
+                    column: 0,
+                },
+                original: {
+                    line: range.startLineNumber,
+                    column: range.startColumn - 1,
+                },
+                source: fileName,
+            });
+        }
         const prefix = '//# ';
-        const sourceURL = hasSchema ? fileName : `${ORIGIN}/${fileName}.js`;
+        const sourceURL = hasSchema ? fileName : `${ORIGIN}${fileName}`;
         this.codeLines.push(
             // Prevent source map from being recognized as of this file
-            `${prefix}sourceURL=${sourceURL}`,
-            `${prefix}sourceMappingURL=data:application/json;base64,${encodeURL(JSON.stringify(data))}`,
+            `${prefix}sourceURL=${sourceURL}.js`,
+            `${prefix}sourceMappingURL=data:application/json;base64,${toBase64(map.toString())}`,
         );
     }
 }

package/src/compiler/index.ts

@@ -4,7 +4,7 @@ import './types.js';
 import { emit } from './emit.js';
 import { createScript } from './create-script.js';
 import { compileFast } from './compile-fast.js';
-import { formatDiagnostic, parseDiagnostics } from './diagnostic.js';
+import { DiagnosticCode, formatDiagnostic, parseDiagnostics } from './diagnostic.js';
 import { generateBytecode, generateBytecodeSync, loadModule } from './generate-bytecode.js';
 import { compileWorker } from './worker-manager.js';
 await loadModule();
@@ -33,7 +33,10 @@ export function emitScript(
     if (!code) {
         reportDiagnostic(source, diagnostics);
     }
-    const target = emit(source, code, options);
+    const sourcemaps = options.sourceMap
+        ? parseDiagnostics(source, diagnostics, (c) => c === DiagnosticCode.SourceMap).sourcemaps
+        : [];
+    const target = emit(source, code, sourcemaps, options);
     return createScript(source, target);
 }
 
@@ -41,6 +44,11 @@ export function emitScript(
  * 生成 MiraScript 对应的 JavaScript 代码
  */
 export async function compile(this: void, source: ScriptInput, options: TranspileOptions = {}): Promise<VmScript> {
+    if (options.sourceMap) {
+        options.diagnostic_sourcemap = true;
+        // https://tc39.es/ecma426/#sec-terms-and-definitions-colun
+        options.diagnostic_position_encoding ??= 'Utf16';
+    }
     if (typeof source == 'string') {
         const result = compileFast(source, options);
         if (result) return result;

package/src/compiler/worker.ts

@@ -1,6 +1,7 @@
 import type { ScriptInput, TranspileOptions } from './types.js';
 import { emit } from './emit.js';
 import { generateBytecode } from './generate-bytecode.js';
+import { DiagnosticCode, parseDiagnostics } from './diagnostic.js';
 
 /**
  * 生成 MiraScript 对应的 JavaScript 代码
@@ -13,7 +14,10 @@ export async function compile(
     if (bytecode == null) {
         return [undefined, errors];
     }
-    const generatedCode = emit(script, bytecode, options);
+    const sourcemaps = options.sourceMap
+        ? parseDiagnostics(script, errors, (c) => c === DiagnosticCode.SourceMap).sourcemaps
+        : [];
+    const generatedCode = emit(script, bytecode, sourcemaps, options);
     return [generatedCode, errors];
 }
 

package/src/helpers/serialize.ts

@@ -67,7 +67,7 @@ const DEFAULT_OPTIONS = Object.freeze({
 } satisfies SerializeOptions);
 
 /** 获取选项 */
-export function getSerializeOptions(options: Partial<SerializeOptions> | undefined): SerializeOptions {
+function getSerializeOptions(options: Partial<SerializeOptions> | undefined): SerializeOptions {
     if (options == null) return DEFAULT_OPTIONS;
     const opt = { ...DEFAULT_OPTIONS };
     for (const key in options) {
@@ -157,17 +157,17 @@ export function serializePropName(value: string, options?: Partial<SerializeOpti
 }
 
 /** 序列化 nil 值 */
-function serializeNil(): string {
+export function serializeNil(): string {
     return 'nil';
 }
 
 /** 序列化布尔值 */
-function serializeBoolean(value: boolean): string {
+export function serializeBoolean(value: boolean): string {
     return value ? 'true' : 'false';
 }
 
 /** 序列化数字 */
-function serializeNumber(value: number): string {
+export function serializeNumber(value: number): string {
     if (isNaN(value)) return 'nan';
     if (!isFinite(value)) return value < 0 ? '-inf' : 'inf';
     if (value === 0) {
@@ -178,7 +178,7 @@ function serializeNumber(value: number): string {
 }
 
 /** 序列化数组 */
-function serializeArray(value: VmArray, depth: number, options: SerializeOptions): string {
+export function serializeArray(value: VmArray, depth: number, options: SerializeOptions): string {
     if (depth > options.maxDepth) return `[]`;
     if (value.length === 0) return '[]';
     let str = '[';
@@ -207,7 +207,7 @@ function customValueOf(value: VmRecord): VmAny | undefined {
 }
 
 /** 序列化记录 */
-function serializeRecord(value: VmRecord, depth: number, options: SerializeOptions): string {
+export function serializeRecord(value: VmRecord, depth: number, options: SerializeOptions): string {
     const customValue = customValueOf(value);
     if (customValue !== undefined) {
         return serializeImpl(customValue, depth - 1, options);

package/src/subtle.ts

@@ -1,7 +1,17 @@
 export * as constants from './helpers/constants.js';
 export { VmSharedContext, DefaultVmContext } from './vm/types/context.js';
 export * as operations from './vm/operations.js';
-export { serialize, serializeString, serializePropName, type SerializeOptions } from './helpers/serialize.js';
+export {
+    serialize,
+    serializeNil,
+    serializeBoolean,
+    serializeNumber,
+    serializeString,
+    serializePropName,
+    serializeArray,
+    serializeRecord,
+    type SerializeOptions,
+} from './helpers/serialize.js';
 export { lib } from './vm/lib/_loader.js';
 export * from './compiler/diagnostic.js';
 export { generateBytecode, generateBytecodeSync, emitScript } from './compiler/index.js';

package/src/vm/lib/_helpers.ts

@@ -191,17 +191,22 @@ export type VmLibOption = Pick<
 export type VmLib<T extends VmFunctionLike = VmFunctionLike> = T & VmLibOption;
 
 /** 创建库函数 */
-export function VmLib<T extends VmFunctionLike>(fn: T, option: VmLibOption): VmLib<T> {
+export function VmLib<T extends VmFunctionLike, P extends Record<string, unknown>>(
+    fn: T,
+    option: VmLibOption,
+    properties?: P,
+): VmLib<T> & P {
     /* c8 ignore next 2 */
     if (typeof fn != 'function') throw new TypeError('Invalid function');
     if (isVmFunction(fn)) throw new TypeError('Cannot create VmLib from a VmFunction');
 
-    const ret = fn as T & VmLibOption as Writable<VmLibOption>;
+    const ret = fn as T & VmLibOption & P as Writable<T & VmLibOption & P>;
+    Object.assign(ret, properties);
     ret.params = option.params;
     ret.paramsType = option.paramsType;
     ret.returns = option.returns;
     ret.returnsType = option.returnsType;
     ret.summary = option.summary;
     ret.examples = option.examples;
-    return ret as T & VmLibOption;
+    return ret as T & VmLibOption & P;
 }

package/src/vm/lib/global/debug.ts

@@ -1,3 +1,4 @@
+import supportsColor from 'supports-color';
 import { VmError } from '../../error.js';
 import { $ToString } from '../../operations.js';
 import type { VmAny } from '../../types/index.js';
@@ -6,7 +7,7 @@ import { VmLib } from '../_helpers.js';
 export const debug_print = VmLib(
     (...args) => {
         // eslint-disable-next-line no-console
-        console.log('\u001B[46;30m MiraScript \u001B[0m', ...args);
+        console.log(...debug_print.prefix, ...args);
     },
     {
         summary: '打印调试信息到控制台',
@@ -15,14 +16,17 @@ export const debug_print = VmLib(
         returnsType: 'nil',
         examples: ['debug_print("value:", 42);'],
     },
+    {
+        prefix: ['MiraScript'] as readonly string[],
+    },
 );
 
 export const panic = VmLib(
     (message: VmAny) => {
         // eslint-disable-next-line no-console
-        if (message === undefined) console.error('\u001B[41;37m MiraScript \u001B[0m');
+        if (message === undefined) console.error(...panic.prefix);
         // eslint-disable-next-line no-console
-        else console.error('\u001B[41;37m MiraScript \u001B[0m', message);
+        else console.error(...panic.prefix, message);
         const error = message == null ? 'panic' : 'panic: ' + $ToString(message);
         throw new VmError(error, undefined);
     },
@@ -33,4 +37,21 @@ export const panic = VmLib(
         returnsType: 'never',
         examples: ['panic("boom");'],
     },
+    {
+        prefix: ['MiraScript'] as readonly string[],
+    },
 );
+
+if (typeof location != 'undefined') {
+    const badge = '%cMiraScript';
+    const common = 'display: inline-block; padding: 1px 4px; border-radius: 3px;';
+    debug_print.prefix = [badge, `${common} background: #007acc; color: #fff;`];
+    panic.prefix = [badge, `${common} background: #d23d3d; color: #fff;`];
+} else {
+    if (supportsColor.stdout) {
+        debug_print.prefix = ['\u001B[44;37m MiraScript \u001B[0m'];
+    }
+    if (supportsColor.stderr) {
+        panic.prefix = ['\u001B[41;37m MiraScript \u001B[0m'];
+    }
+}

package/src/vm/lib/global/math-arr.ts

@@ -36,7 +36,7 @@ export const hypot = VmLib(build(Math.hypot), {
 export const sum = VmLib(
     (...values: readonly VmAny[]) => {
         const numbers = getNumbers(values);
-        return numbers.reduce((a, b) => a + b, 0);
+        return numbers.reduce((a, b) => a + b, -0);
     },
     {
         summary: '返回一组数的总和',

package/src/vm/types/wrapper.ts

@@ -23,7 +23,9 @@ export abstract class VmWrapper<T extends object> {
     }
     /** 转为字符串 */
     toString(): string {
-        return `<${this.type} ${this.describe}>`;
+        const { type, describe } = this;
+        if (!describe) return `<${type}>`;
+        return `<${type} ${describe}>`;
     }
 }