@mirascript/mirascript 0.1.15 → 0.1.17

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

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/vm/types/module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,oBAAoB;AACpB,qBAAa,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAErG,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,MAAM;;IADrB,WAAW;IACF,IAAI,EAAE,MAAM;IACrB,WAAW;IACX,KAAK,EAAE,CAAC;IAIZ,kBAAkB;IACT,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAGlC,kBAAkB;IACT,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK;IAIhC,kBAAkB;IACT,IAAI,IAAI,MAAM,EAAE;IAGzB,kBAAkB;IACT,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAGpC,kBAAkB;IAClB,IAAa,IAAI,IAAI,QAAQ,CAE5B;IACD,kBAAkB;IAClB,IAAa,QAAQ,IAAI,MAAM,CAE9B;CACJ;AAID,2BAA2B;AAC3B,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAAC,CAAC,CAAC,CAElG"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/vm/types/module.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,oBAAoB;AACpB,qBAAa,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAE7G,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,MAAM;;IADrB,WAAW;IACF,IAAI,EAAE,MAAM;IACrB,WAAW;IACX,KAAK,EAAE,CAAC;IAIZ,kBAAkB;IACT,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAGlC,kBAAkB;IACT,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK;IAIhC,kBAAkB;IACT,IAAI,IAAI,MAAM,EAAE;IAGzB,kBAAkB;IACT,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAGpC,kBAAkB;IAClB,IAAa,IAAI,IAAI,QAAQ,CAE5B;IACD,kBAAkB;IAClB,IAAa,QAAQ,IAAI,MAAM,CAE9B;CACJ"}

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

@@ -22,6 +22,4 @@ export declare abstract class VmWrapper<T extends object> {
     /** 转为字符串 */
     toString(useBraces: boolean): string;
 }
-/** 检查值是否为 MiraScript 包装器 */
-export declare function isVmWrapper<T extends object>(value: unknown): value is VmWrapper<T>;
 //# sourceMappingURL=wrapper.d.ts.map

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,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM;CAKvC;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":"AACA,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,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM;CAKvC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mirascript/mirascript",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "author": "CloudPSS",
   "license": "MIT",
   "description": "An expression based scripting language.",
@@ -20,9 +20,11 @@
     "./cli": {
       "@mirascript/dev": "./src/cli/index.ts",
       "default": "./dist/cli/index.js"
-    }
+    },
+    "./package.json": "./package.json"
   },
   "imports": {
+    "#package.json": "./package.json",
     "#compiler/worker": {
       "@mirascript/dev": "./src/compiler/worker.ts",
       "default": "./dist/compiler/worker.js"
@@ -34,13 +36,14 @@
     "commander": "^14.0.2",
     "source-map-js": "^1.2.1",
     "supports-color": "^10.2.2",
-    "@mirascript/bindings": "~0.1.15"
+    "@mirascript/bindings": "~0.1.17"
   },
   "devDependencies": {
     "@types/node": "^24.10.1",
     "@types/sinon": "^21.0.0",
     "ava": "^6.4.1",
     "c8": "^10.1.3",
+    "madge": "^8.0.0",
     "sinon": "^21.0.0",
     "type-fest": "^5.2.0"
   },
@@ -49,6 +52,7 @@
     "build:ts": "pnpm clean && tsc",
     "build": "pnpm build:ts --emitDeclarationOnly && node ./esbuild.config.js",
     "mirascript": "node --enable-source-maps ./dist/cli/index.js",
+    "deps": "madge --circular --warning ./src",
     "clean": "rimraf dist",
     "test": "c8 ava"
   }

package/src/cli/index.ts

@@ -4,7 +4,7 @@ import { readFile, stat } from 'node:fs/promises';
 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 pkg from '#package.json' with { type: 'json' };
 import { compileSync } from '../compiler/index.js';
 import { configCheckpoint, type VmValue } from '../vm/index.js';
 

package/src/compiler/compile-fast.ts

@@ -1,6 +1,5 @@
-import { wrapScript } from './create-script.js';
+import { wrapScript, type VmScript } from './create-script.js';
 import type { TranspileOptions } from './types.js';
-import type { VmScript } from '../vm/types/index.js';
 import { GlobalFallback } from '../vm/helpers.js';
 import { isFinite } from '../helpers/utils.js';
 

package/src/compiler/create-script.ts

@@ -1,9 +1,18 @@
+import { kVmScript, VM_SCRIPT_NAME } from '../helpers/constants.js';
 import { defineProperty } from '../helpers/utils.js';
 import { keys, values } from '../vm/env.js';
-import type { VmScript, VmScriptLike } from '../vm/types/script.js';
+import type { VmValue, VmContext } from '../vm/types/index.js';
 import type { ScriptInput } from './types.js';
 
-const kVmScript = Symbol.for('mirascript.vm.script');
+/** Mirascript 脚本 */
+export type VmScriptLike = (global?: VmContext) => VmValue;
+
+/** Mirascript 脚本 */
+export type VmScript = VmScriptLike & {
+    readonly [kVmScript]: true;
+    /** 原始代码 */
+    readonly source: string;
+};
 
 /** 生成 JS 函数 */
 export function wrapScript(source: ScriptInput, script: VmScriptLike): VmScript {
@@ -11,6 +20,7 @@ export function wrapScript(source: ScriptInput, script: VmScriptLike): VmScript
     if (kVmScript in script) {
         return script as VmScriptLike as VmScript;
     }
+    defineProperty(script, 'name', { value: VM_SCRIPT_NAME });
     defineProperty(script, kVmScript, { value: true });
     if (typeof source === 'string') {
         defineProperty(script, 'source', { value: source, configurable: true });

package/src/compiler/diagnostic.ts

@@ -183,13 +183,22 @@ function formatRange(range: IRange): string {
 }
 
 /** 生成诊断消息的字符串 */
-export function formatDiagnostic(diagnostic: SourceDiagnostic): string {
-    const range = formatRange(diagnostic.range);
-    const codeName = DiagnosticCode[diagnostic.code] || `Unknown(${diagnostic.code})`;
-    let message = getDiagnosticMessage(diagnostic.code);
-    for (const ref of diagnostic.references) {
-        const refRange = formatRange(ref.range);
-        message += `\n    (${refRange}): ${getDiagnosticMessage(ref.code)}`;
+export function formatDiagnostics(
+    diagnostics: Iterable<SourceDiagnostic>,
+    source: ScriptInput,
+    fileName: string | undefined,
+): string[] {
+    const rangePrefix = fileName ? `${fileName}:` : '';
+    const messages: string[] = [];
+    for (const diagnostic of diagnostics) {
+        const range = formatRange(diagnostic.range);
+        const codeName = DiagnosticCode[diagnostic.code] || `Unknown(${diagnostic.code})`;
+        let message = getDiagnosticMessage(diagnostic.code);
+        for (const ref of diagnostic.references) {
+            const refRange = formatRange(ref.range);
+            message += `\n    (${refRange}): ${getDiagnosticMessage(ref.code)}`;
+        }
+        messages.push(`  ${codeName}(${rangePrefix}${range}): ${message}`);
     }
-    return `  ${codeName}(${range}): ${message}`;
+    return messages;
 }

package/src/compiler/emit/constants.ts

@@ -0,0 +1,2 @@
+export const SCRIPT_PREFIX = `'use strict'; return ((global = GlobalFallback()) => { try { CpEnter();`;
+export const GLOBAL_HINT = `/* globals */`;

package/src/compiler/emit/consts.ts

@@ -0,0 +1,47 @@
+import type { VmPrimitive } from '../../vm/index.js';
+
+/** 将值转为 JS 字面量 */
+export function toJsLiteral(value: VmPrimitive | undefined): string {
+    /* c8 ignore next 2 */
+    if (value === null) return 'null';
+    if (value === undefined) return 'undefined';
+    if (typeof value == 'string') {
+        return JSON.stringify(value);
+    }
+    // JSON 无法处理 NaN 等特殊数字
+    if (value === 0) {
+        if (1 / value === -Infinity) return '-0';
+        return '0';
+    }
+    return String(value satisfies number | boolean);
+}
+
+/** 解析常量 */
+export function readConst(reader: DataView, offset: number): [value: VmPrimitive, consumed: number] {
+    const type = reader.getUint8(offset);
+    switch (type) {
+        /* c8 ignore next 2 */
+        case 0:
+            return [null, 1];
+        case 1:
+            return [true, 1];
+        case 2:
+            return [false, 1];
+        case 3: {
+            const ordinal = reader.getInt32(offset + 1, true);
+            return [ordinal, 5];
+        }
+        case 4: {
+            const num = reader.getFloat64(offset + 1, true);
+            return [num, 9];
+        }
+        case 5: {
+            const len = reader.getUint32(offset + 1, true);
+            const str = new TextDecoder().decode(new Uint8Array(reader.buffer, reader.byteOffset + offset + 5, len));
+            return [str, 5 + len];
+        }
+        /* c8 ignore next 2 */
+        default:
+            throw new Error(`Unknown constant type: ${type}`);
+    }
+}

package/src/compiler/emit/globals.ts

@@ -0,0 +1,39 @@
+import { toString } from '../../helpers/convert/to-string.js';
+import { toJsLiteral } from './consts.js';
+import type { Emitter } from './index.js';
+
+/** 全局变量描述符 */
+export type GlobalDesc = {
+    /** 变量编译后的名称 */
+    v: string;
+    /** 变量名字的字面量，是一个 JS 字符串字面量 */
+    l: string;
+    /** 变量的表达式，用于获取全局变量 */
+    e: string;
+    /** 变量的名称 */
+    n: string;
+};
+
+/** 全局变量映射，key 为变量名在常量表中的索引 */
+export type GlobalMap = Map<number, GlobalDesc>;
+
+/** 获取全局变量映射 */
+export function readGlobal(emitter: Emitter, constIdx: number): GlobalDesc {
+    const { globals } = emitter;
+    const cached = globals.get(constIdx);
+    if (cached) return cached;
+    const constName = emitter.constVals[constIdx]!;
+    let name, lit;
+    if (typeof constName == 'string') {
+        name = constName;
+        lit = emitter.constLits[constIdx]!;
+    } else {
+        name = toString(constName, undefined);
+        lit = toJsLiteral(name);
+    }
+    const val = `g${globals.size + 1}`;
+    const expr = `(${val} === undefined ? (${val} = global.get(${lit})) : ${val})`;
+    const desc: GlobalDesc = { v: val, l: lit, e: expr, n: name };
+    globals.set(constIdx, desc);
+    return desc;
+}

package/src/compiler/{emit.ts → emit/index.ts}

@@ -1,9 +1,10 @@
 import { OpCode } from '@mirascript/bindings';
-import type { VmConst, VmPrimitive } from '../vm/index.js';
-import { $ToString } from '../vm/operations.js';
-import type { ScriptInput, TranspileOptions } from './types.js';
-import type { IRange } from './diagnostic.js';
-import { SourceMapGenerator } from 'source-map-js';
+import type { VmPrimitive } from '../../vm/index.js';
+import type { ScriptInput, TranspileOptions } from '../types.js';
+import type { IRange } from '../diagnostic.js';
+import { readGlobal, type GlobalMap } from './globals.js';
+import { readConst, toJsLiteral } from './consts.js';
+import { createSourceMap } from './sourcemap.js';
 
 /** 生成代码 */
 export function emit(
@@ -18,55 +19,6 @@ export function emit(
     return code;
 }
 
-/** 解析常量 */
-function readConst(reader: DataView, offset: number): [value: VmPrimitive, consumed: number] {
-    const type = reader.getUint8(offset);
-    switch (type) {
-        /* c8 ignore next 2 */
-        case 0:
-            return [null, 1];
-        case 1:
-            return [true, 1];
-        case 2:
-            return [false, 1];
-        case 3: {
-            const ordinal = reader.getInt32(offset + 1, true);
-            return [ordinal, 5];
-        }
-        case 4: {
-            const num = reader.getFloat64(offset + 1, true);
-            return [num, 9];
-        }
-        case 5: {
-            const len = reader.getUint32(offset + 1, true);
-            const str = new TextDecoder().decode(new Uint8Array(reader.buffer, reader.byteOffset + offset + 5, len));
-            return [str, 5 + len];
-        }
-        /* c8 ignore next 2 */
-        default:
-            throw new Error(`Unknown constant type: ${type}`);
-    }
-}
-
-/** 将值转为 JS */
-function toJavascript(value: VmConst | undefined): string {
-    /* c8 ignore next 2 */
-    if (value === null) return 'null';
-    if (value === undefined) return 'undefined';
-    if (typeof value == 'object' || typeof value == 'string') {
-        return JSON.stringify(value);
-    }
-    // JSON 无法处理 NaN 等特殊数字
-    if (value === 0) {
-        if (1 / value === -Infinity) return '-0';
-        return '0';
-    }
-    return String(value);
-}
-
-const ORIGIN = `mira://MiraScript/`;
-let sourceId = 1;
-
 /** 创建数组 */
 function createArray<T>(length: number, fn: (index: number) => T): T[] {
     // micro bench shows that this is faster than Array.from
@@ -80,7 +32,7 @@ function createArray<T>(length: number, fn: (index: number) => T): T[] {
 const SCRIPT_PREFIX = `'use strict'; return ((global = GlobalFallback()) => { try { CpEnter();`;
 const GLOBAL_HINT = `/* globals */`;
 /** 代码生成 */
-class Emitter {
+export class Emitter {
     constructor(
         readonly source: ScriptInput,
         readonly chunk: Uint8Array,
@@ -106,7 +58,7 @@ class Emitter {
         for (let i = 0, index = 0; i < this.constSize; index++) {
             const [constant, size] = readConst(this.constReader, i);
             this.constVals.push(constant);
-            this.constLits.push(toJavascript(constant));
+            this.constLits.push(toJsLiteral(constant));
             i += size;
         }
     }
@@ -125,24 +77,10 @@ class Emitter {
         return '  '.repeat(this.identCounter + len);
     }
 
-    readonly globals = new Map<number, [val: string, lit: string, eager: boolean, expr: string, name: string]>();
+    readonly globals: GlobalMap = new Map();
     /** 读取全局变量 */
     private rg(constIdx: number, eager: boolean): string {
-        const cached = this.globals.get(constIdx);
-        if (cached != null) {
-            if (eager && !cached[2]) {
-                cached[2] = true;
-                cached[3] = cached[0];
-            }
-            return cached[3];
-        }
-        const constName = this.constVals[constIdx]!;
-        const name = $ToString(constName);
-        const lit = typeof constName == 'string' ? this.constLits[constIdx]! : JSON.stringify(name);
-        const val = `g${this.globals.size + 1}`;
-        const expr = eager ? val : `(${val} === undefined ? (${val} = global.get(${lit})) : ${val})`;
-        this.globals.set(constIdx, [val, lit, eager, expr, name]);
-        return expr;
+        return readGlobal(this, constIdx).e;
     }
 
     readonly codeLines: string[] = [];
@@ -655,12 +593,12 @@ class Emitter {
             }
             case OpCode.If: {
                 const cond = read();
-                code = `if (${this.rv(cond)} !== false && $ToBoolean(${this.rv(cond)}) !== false) {`;
+                code = `if ($ToBoolean(${this.rv(cond)})) {`;
                 break;
             }
             case OpCode.IfNot: {
                 const cond = read();
-                code = `if (${this.rv(cond)} !== true && $ToBoolean(${this.rv(cond)}) !== true) {`;
+                code = `if (!$ToBoolean(${this.rv(cond)})) {`;
                 break;
             }
             case OpCode.IfInit: {
@@ -769,9 +707,8 @@ class Emitter {
         this.readCode();
         if (this.globals.size > 0) {
             let globalsInit = '';
-            for (const [val, lit, eager] of this.globals.values()) {
-                const expr = eager ? `${val} = global.get(${lit})` : val;
-                globalsInit += globalsInit ? `, ${expr}` : `var ${GLOBAL_HINT} ${expr}`;
+            for (const { v } of this.globals.values()) {
+                globalsInit += globalsInit ? `, ${v}` : `var ${GLOBAL_HINT} ${v}`;
             }
             this.codeLines[0] += globalsInit + ';';
         }
@@ -780,128 +717,7 @@ class Emitter {
     /** 添加源映射 */
     addSourceMap(): void {
         if (!this.options.sourceMap) return;
-        let fileName = (this.options.fileName ?? '').trim();
-        const hasSchema = /^\w+:/.test(fileName);
-        if (!hasSchema) {
-            if (fileName.startsWith('/')) {
-                fileName = fileName.replace(/^\/+\s*/, '');
-            }
-            if (!fileName) {
-                fileName = `${sourceId++}.${this.options.input_mode === 'Template' ? 'miratpl' : 'mira'}`;
-            }
-        }
-        const map = new SourceMapGenerator({
-            file: fileName + '.js',
-        });
-        if (typeof this.source === 'string') {
-            map.setSourceContent(fileName, this.source);
-        }
-        let hasStartMap = false;
-        for (let i = 1; i < this.sourcemaps.length; i++) {
-            const range = this.sourcemaps[i];
-            if (!range) break;
-            if (!hasStartMap && range.startLineNumber === 1 && range.startColumn === 1) {
-                hasStartMap = true;
-            }
-            map.addMapping({
-                generated: {
-                    // 前两行固定为：
-                    // (function anonymous($Add,$Aeq, ...
-                    // ) {
-                    line: i + 3,
-                    column: 0,
-                },
-                original: {
-                    line: range.startLineNumber,
-                    column: range.startColumn - 1,
-                },
-                source: fileName,
-            });
-        }
-        if (!hasStartMap) {
-            map.addMapping({
-                generated: {
-                    line: 3,
-                    column: SCRIPT_PREFIX.length - 'CpEnter();'.length,
-                },
-                original: {
-                    line: 1,
-                    column: 0,
-                },
-                source: fileName,
-            });
-        }
-        {
-            const line0 = this.codeLines[0]!;
-            const file = `${fileName} <globals>`;
-            let globals = `global;\n`;
-            map.addMapping({
-                generated: {
-                    line: 3,
-                    column: line0.indexOf(`global = `),
-                },
-                original: {
-                    line: 1,
-                    column: 0,
-                },
-                source: file,
-                name: 'global',
-            });
-            map.addMapping({
-                generated: {
-                    line: 3,
-                    column: SCRIPT_PREFIX.length,
-                },
-                original: {
-                    line: 1,
-                    column: 7,
-                },
-                source: file,
-                name: '',
-            });
-            let i = 1;
-            let pos = line0.indexOf(GLOBAL_HINT, SCRIPT_PREFIX.length) + GLOBAL_HINT.length;
-            for (const p of this.globals.values()) {
-                i++;
-                if (pos < 0) break;
-                const val = p[0];
-                pos = line0.indexOf(val, pos);
-                if (pos < 0) break;
-                const name = p[4];
-                map.addMapping({
-                    generated: {
-                        line: 3,
-                        column: pos,
-                    },
-                    original: {
-                        line: i,
-                        column: 0,
-                    },
-                    source: file,
-                    name,
-                });
-                globals += `${name};\n`;
-            }
-            map.addMapping({
-                generated: {
-                    line: 3,
-                    column: pos,
-                },
-                original: {
-                    line: i,
-                    column: 0,
-                },
-                source: file,
-                name: '',
-            });
-            map.setSourceContent(file, globals);
-        }
-        const prefix = '//# ';
-        const sourceURL = hasSchema ? fileName : `${ORIGIN}${fileName}`;
-        this.codeLines.push(
-            // Prevent source map from being recognized as of this file
-            `${prefix}sourceURL=${sourceURL}.js`,
-            `${prefix}sourceMappingURL=data:application/json,${encodeURIComponent(map.toString())}`,
-        );
+        const mapLines = createSourceMap(this.source, this.sourcemaps, this.codeLines, this.globals, this.options);
+        this.codeLines.push(...mapLines);
     }
 }

package/src/compiler/emit/sourcemap.ts

@@ -0,0 +1,168 @@
+import type { IRange } from '../diagnostic.js';
+import type { ScriptInput, TranspileOptions } from '../types.js';
+import { SourceMapGenerator } from 'source-map-js';
+import { GLOBAL_HINT, SCRIPT_PREFIX } from './constants.js';
+import type { GlobalMap } from './globals.js';
+
+const ORIGIN = `mira://MiraScript/`;
+const { SOURCE_URL, SOURCE_MAPPING_URL } = ((source, mapping, url) => {
+    // 避免被识别为当前文件的源映射
+    const prefix = '//# ';
+    return {
+        SOURCE_URL: prefix.concat(source, url),
+        SOURCE_MAPPING_URL: prefix.concat(source, mapping, url),
+    };
+})(`source`, `Mapping`, `URL`);
+// 前两行固定为：
+// (function anonymous($Add,$Aeq, ...
+// ) {
+const SOURCE_OFFSET = 3;
+
+/**
+ * Node.js Buffer 类型的简易声明，@mirascript/playground 调试环境下会直接加载此文件
+ */
+declare class Buffer {
+    /** @inheritdoc */
+    static from(str: string, encoding: 'utf8'): Buffer;
+    /** @inheritdoc */
+    toString(encoding: 'base64'): string;
+}
+
+const toDataUrl: (json: string) => string =
+    typeof Buffer == 'function' && typeof Buffer.from == 'function'
+        ? (s) => `data:application/json;base64,${Buffer.from(s, 'utf8').toString('base64')}`
+        : (s) => `data:application/json;charset=utf-8,${encodeURIComponent(s)}`;
+
+/** 添加全局变量的源映射 */
+function addGlobalMappings(globalLine: string, fileName: string, map: SourceMapGenerator, globals: GlobalMap) {
+    let globalFile = `global;\n`;
+    map.addMapping({
+        generated: {
+            line: 3,
+            column: globalLine.indexOf(`global = `),
+        },
+        original: {
+            line: 1,
+            column: 0,
+        },
+        source: fileName,
+        name: 'global',
+    });
+    map.addMapping({
+        generated: {
+            line: 3,
+            column: SCRIPT_PREFIX.length,
+        },
+        original: {
+            line: 1,
+            column: 7,
+        },
+        source: fileName,
+        name: '',
+    });
+    let i = 1;
+    let pos = globalLine.indexOf(GLOBAL_HINT, SCRIPT_PREFIX.length) + GLOBAL_HINT.length;
+    for (const p of globals.values()) {
+        i++;
+        if (pos < 0) break;
+        const { v, n } = p;
+        pos = globalLine.indexOf(v, pos);
+        if (pos < 0) break;
+        map.addMapping({
+            generated: {
+                line: 3,
+                column: pos,
+            },
+            original: {
+                line: i,
+                column: 0,
+            },
+            source: fileName,
+            name: n,
+        });
+        globalFile += `${n};\n`;
+    }
+    map.addMapping({
+        generated: {
+            line: 3,
+            column: pos,
+        },
+        original: {
+            line: i,
+            column: 0,
+        },
+        source: fileName,
+        name: '',
+    });
+    map.setSourceContent(fileName, globalFile);
+}
+
+let sourceId = 1;
+/** 创建源映射 */
+export function createSourceMap(
+    source: ScriptInput | undefined,
+    sourcemaps: readonly IRange[],
+    codeLines: readonly string[],
+    globals: GlobalMap,
+    options: TranspileOptions,
+): [string, string] {
+    let fileName = (options.fileName ?? '').trim();
+    const hasSchema = /^\w+:/.test(fileName);
+    if (!hasSchema) {
+        if (fileName.startsWith('/')) {
+            fileName = fileName.replace(/^\/+\s*/, '');
+        }
+        if (!fileName) {
+            fileName = `${sourceId++}.${options.input_mode === 'Template' ? 'miratpl' : 'mira'}`;
+        }
+    }
+    const map = new SourceMapGenerator({
+        file: fileName + '.js',
+    });
+    if (typeof source === 'string') {
+        map.setSourceContent(fileName, source);
+    }
+    let hasStartMap = false;
+    for (let i = 1; i < sourcemaps.length; i++) {
+        const range = sourcemaps[i];
+        if (!range) break;
+        if (!hasStartMap && range.startLineNumber === 1 && range.startColumn === 1) {
+            hasStartMap = true;
+        }
+        map.addMapping({
+            generated: {
+                line: i + SOURCE_OFFSET,
+                column: 0,
+            },
+            original: {
+                line: range.startLineNumber,
+                column: range.startColumn - 1,
+            },
+            source: fileName,
+        });
+    }
+    if (!hasStartMap) {
+        map.addMapping({
+            generated: {
+                line: SOURCE_OFFSET,
+                column: SCRIPT_PREFIX.length - 'CpEnter();'.length,
+            },
+            original: {
+                line: 1,
+                column: 0,
+            },
+            source: fileName,
+        });
+    }
+    const globalLine = codeLines[0];
+    if (globalLine?.includes(GLOBAL_HINT)) {
+        addGlobalMappings(globalLine, `${fileName} <globals>`, map, globals);
+    }
+    const sourceURL = hasSchema ? fileName : `${ORIGIN}${fileName}`;
+    const dataUrl = toDataUrl(map.toString());
+    return [
+        // Prevent source map from being recognized as of this file
+        `${SOURCE_URL}=${sourceURL}.js`,
+        `${SOURCE_MAPPING_URL}=${dataUrl}`,
+    ];
+}