@mirascript/wasm 0.1.89 → 0.1.91

package/dist/index.d.ts

@@ -12,6 +12,36 @@ export interface CompileResult {
     /** 编译生成的字节码 */
     readonly chunk?: Uint8Array;
 }
+/** 源码格式化选项 */
+export interface FormatOptions {
+    /** 制表符宽度。 */
+    readonly tabSize?: number;
+    /** 是否使用空格缩进。 */
+    readonly insertSpaces?: boolean;
+    /** 最大打印宽度。 */
+    readonly printWidth?: number;
+}
+/** UTF-16 绝对偏移范围 */
+export interface FormatRange {
+    /** 起始 UTF-16 偏移。 */
+    readonly start: number;
+    /** 结束 UTF-16 偏移。 */
+    readonly end: number;
+}
+/** 源码格式化编辑 */
+export interface FormatEdit extends FormatRange {
+    /** 替换文本。 */
+    readonly text: string;
+}
+/** 源码格式化结果 */
+export interface FormatResult {
+    /** 编译诊断。 */
+    readonly diagnostics: Uint32Array;
+    /** 互不重叠的格式化编辑。 */
+    readonly edits: readonly FormatEdit[];
+}
 /** 编译 MiraScript 代码 */
 export declare function compileSync(script: ScriptInput, config: Config | wasm.CompileConfig): CompileResult;
+/** 格式化 MiraScript 源码；ranges 使用 UTF-16 绝对偏移，省略时格式化整篇文档。 */
+export declare function formatSync(source: string, config: Config | wasm.CompileConfig, options?: FormatOptions, ranges?: readonly FormatRange[]): FormatResult;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAyC,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxG,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EAAE,IAAI,EAAE,CAAC;AAEhB,YAAY;AACZ,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1C;AAED,eAAe;AACf,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAkBrF;AAED,WAAW;AACX,MAAM,WAAW,aAAa;IAC1B,WAAW;IACX,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,eAAe;IACf,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;CAC/B;AAuBD,uBAAuB;AACvB,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,aAAa,GAAG,aAAa,CAInG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAyC,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxG,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EAAE,IAAI,EAAE,CAAC;AAEhB,YAAY;AACZ,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1C;AAED,eAAe;AACf,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAkBrF;AAED,WAAW;AACX,MAAM,WAAW,aAAa;IAC1B,WAAW;IACX,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,eAAe;IACf,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;CAC/B;AAED,cAAc;AACd,MAAM,WAAW,aAAa;IAC1B,aAAa;IACb,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB;IAChB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,cAAc;IACd,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,oBAAoB;AACpB,MAAM,WAAW,WAAW;IACxB,oBAAoB;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oBAAoB;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACxB;AAED,cAAc;AACd,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC3C,YAAY;IACZ,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED,cAAc;AACd,MAAM,WAAW,YAAY;IACzB,YAAY;IACZ,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,kBAAkB;IAClB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CACzC;AAuBD,uBAAuB;AACvB,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,aAAa,GAAG,aAAa,CAInG;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,aAAa,EACnC,OAAO,GAAE,aAAkB,EAC3B,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,GAChC,YAAY,CA4Bd"}

package/dist/index.js

@@ -56,4 +56,36 @@ export function compileSync(script, config) {
         ? compileImpl(wasm.compile, script, config)
         : compileImpl(wasm.compile_buffer, script, config);
 }
+/** 格式化 MiraScript 源码；ranges 使用 UTF-16 绝对偏移，省略时格式化整篇文档。 */
+export function formatSync(source, config, options = {}, ranges) {
+    const cfg = createConfig(config);
+    const rawOptions = new wasm.FormatOptions();
+    rawOptions.tab_size = options.tabSize ?? 2;
+    rawOptions.insert_spaces = options.insertSpaces ?? true;
+    rawOptions.print_width = options.printWidth ?? 80;
+    const rawRanges = new Uint32Array((ranges?.length ?? 0) * 2);
+    for (const [index, range] of (ranges ?? []).entries()) {
+        rawRanges[index * 2] = range.start;
+        rawRanges[index * 2 + 1] = range.end;
+    }
+    const result = wasm.format_sync(source, cfg, rawOptions, rawRanges);
+    try {
+        const encodedRanges = result.ranges();
+        const edits = [];
+        for (let index = 0; index < result.edit_count(); index++) {
+            edits.push({
+                start: encodedRanges[index * 2],
+                end: encodedRanges[index * 2 + 1],
+                text: result.edit_text(index) ?? '',
+            });
+        }
+        return { diagnostics: result.diagnostics(), edits };
+    }
+    finally {
+        result.free();
+        rawOptions.free();
+        if (cfg !== config)
+            cfg.free();
+    }
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,IAAI,EAAE,CAAC;AAEhB,YAAY;AACZ,MAAM,CAAC,KAAK,UAAU,IAAI;IACtB,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,eAAe;AACf,MAAM,UAAU,YAAY,CAAC,MAAoC;IAC7D,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;IAC7C,IAAI,MAAM,YAAY,IAAI,CAAC,aAAa;QAAE,OAAO,MAAM,CAAC;IACxD,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,GAAG,KAAK,MAAM;YAAE,SAAS,CAAC,aAAa;QAC3C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;YAAE,SAAS;QAC1C,IAAI,KAAK,GAAG,MAAM,CAAC,GAAmB,CAAU,CAAC;QACjD,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YACvB,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAkB,CAAU,CAAC;QACxD,CAAC;aAAM,IAAI,GAAG,KAAK,8BAA8B,EAAE,CAAC;YAChD,KAAK,GAAG,IAAI,CAAC,0BAA0B,CAAC,KAAmC,CAAU,CAAC;QAC1F,CAAC;QACD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;YAAE,SAAS;QAC5B,GAAG,CAAC,GAAmB,CAAC,GAAG,KAAK,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAUD,SAAS;AACT,SAAS,WAAW,CAChB,QAAuE,EACvE,MAAS,EACT,MAAmC;IAEnC,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;QAC7B,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;YAAS,CAAC;QACP,MAAM,CAAC,IAAI,EAAE,CAAC;QACd,oBAAoB;QACpB,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACjB,GAAG,CAAC,IAAI,EAAE,CAAC;QACf,CAAC;IACL,CAAC;AACL,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,WAAW,CAAC,MAAmB,EAAE,MAAmC;IAChF,OAAO,OAAO,MAAM,IAAI,QAAQ;QAC5B,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;QAC3C,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/wasm.d.ts

@@ -43,6 +43,25 @@ export enum DiagnosticPositionEncoding {
     Utf32 = 2,
 }
 
+export class FormatOptions {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor();
+    insert_spaces: boolean;
+    print_width: number;
+    tab_size: number;
+}
+
+export class FormatResult {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    diagnostics(): Uint32Array;
+    edit_count(): number;
+    edit_text(index: number): string | undefined;
+    ranges(): Uint32Array;
+}
+
 /**
  * Mode for reading input.
  */
@@ -62,7 +81,6 @@ export class MonacoCompiler {
     [Symbol.dispose](): void;
     diagnostics(): Uint32Array;
     emit(): Uint8Array | undefined;
-    format(): string | undefined;
     constructor(input: string, config: CompileConfig);
     parse(): boolean;
 }
@@ -71,6 +89,8 @@ export function compile(script: string, config: CompileConfig): CompileResult;
 
 export function compile_buffer(script: Uint8Array, config: CompileConfig): CompileResult;
 
+export function format_sync(source: string, config: CompileConfig, options: FormatOptions, ranges: Uint32Array): FormatResult;
+
 export function main(): void;
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
@@ -78,16 +98,29 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly __wbg_compileresult_free: (a: number, b: number) => void;
+    readonly __wbg_formatoptions_free: (a: number, b: number) => void;
+    readonly __wbg_formatresult_free: (a: number, b: number) => void;
     readonly __wbg_monacocompiler_free: (a: number, b: number) => void;
     readonly compile: (a: number, b: number, c: number) => number;
     readonly compileresult_chunk: (a: number) => [number, number];
     readonly compileresult_diagnostics: (a: number) => [number, number];
+    readonly format_sync: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
+    readonly formatoptions_insert_spaces: (a: number) => number;
+    readonly formatoptions_new: () => number;
+    readonly formatoptions_print_width: (a: number) => number;
+    readonly formatoptions_set_insert_spaces: (a: number, b: number) => void;
+    readonly formatoptions_set_print_width: (a: number, b: number) => void;
+    readonly formatoptions_set_tab_size: (a: number, b: number) => void;
+    readonly formatoptions_tab_size: (a: number) => number;
+    readonly formatresult_edit_count: (a: number) => number;
+    readonly formatresult_edit_text: (a: number, b: number) => [number, number];
+    readonly formatresult_ranges: (a: number) => [number, number];
     readonly main: () => void;
     readonly monacocompiler_diagnostics: (a: number) => [number, number];
     readonly monacocompiler_emit: (a: number) => [number, number];
-    readonly monacocompiler_format: (a: number) => [number, number];
     readonly monacocompiler_new: (a: number, b: number, c: number) => number;
     readonly monacocompiler_parse: (a: number) => number;
+    readonly formatresult_diagnostics: (a: number) => [number, number];
     readonly compile_buffer: (a: number, b: number, c: number) => number;
     readonly __wbg_compileconfig_free: (a: number, b: number) => void;
     readonly __wbg_get_compileconfig_diagnostic_error: (a: number) => number;
@@ -115,6 +148,7 @@ export interface InitOutput {
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __externref_table_dealloc: (a: number) => void;
     readonly __wbindgen_start: () => void;
 }
 

package/lib/wasm.js

@@ -210,6 +210,123 @@ export const DiagnosticPositionEncoding = Object.freeze({
     Utf32: 2, "2": "Utf32",
 });
 
+export class FormatOptions {
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        FormatOptionsFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_formatoptions_free(ptr, 0);
+    }
+    /**
+     * @returns {boolean}
+     */
+    get insert_spaces() {
+        const ret = wasm.formatoptions_insert_spaces(this.__wbg_ptr);
+        return ret !== 0;
+    }
+    constructor() {
+        const ret = wasm.formatoptions_new();
+        this.__wbg_ptr = ret;
+        FormatOptionsFinalization.register(this, this.__wbg_ptr, this);
+        return this;
+    }
+    /**
+     * @returns {number}
+     */
+    get print_width() {
+        const ret = wasm.formatoptions_print_width(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * @param {boolean} value
+     */
+    set insert_spaces(value) {
+        wasm.formatoptions_set_insert_spaces(this.__wbg_ptr, value);
+    }
+    /**
+     * @param {number} value
+     */
+    set print_width(value) {
+        wasm.formatoptions_set_print_width(this.__wbg_ptr, value);
+    }
+    /**
+     * @param {number} value
+     */
+    set tab_size(value) {
+        wasm.formatoptions_set_tab_size(this.__wbg_ptr, value);
+    }
+    /**
+     * @returns {number}
+     */
+    get tab_size() {
+        const ret = wasm.formatoptions_tab_size(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+}
+if (Symbol.dispose) FormatOptions.prototype[Symbol.dispose] = FormatOptions.prototype.free;
+
+export class FormatResult {
+    static __wrap(ptr) {
+        const obj = Object.create(FormatResult.prototype);
+        obj.__wbg_ptr = ptr;
+        FormatResultFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        FormatResultFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_formatresult_free(ptr, 0);
+    }
+    /**
+     * @returns {Uint32Array}
+     */
+    diagnostics() {
+        const ret = wasm.formatresult_diagnostics(this.__wbg_ptr);
+        var v1 = getArrayU32FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
+    /**
+     * @returns {number}
+     */
+    edit_count() {
+        const ret = wasm.formatresult_edit_count(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * @param {number} index
+     * @returns {string | undefined}
+     */
+    edit_text(index) {
+        const ret = wasm.formatresult_edit_text(this.__wbg_ptr, index);
+        let v1;
+        if (ret[0] !== 0) {
+            v1 = getStringFromWasm0(ret[0], ret[1]);
+            wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        }
+        return v1;
+    }
+    /**
+     * @returns {Uint32Array}
+     */
+    ranges() {
+        const ret = wasm.formatresult_ranges(this.__wbg_ptr);
+        var v1 = getArrayU32FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
+}
+if (Symbol.dispose) FormatResult.prototype[Symbol.dispose] = FormatResult.prototype.free;
+
 /**
  * Mode for reading input.
  * @enum {0 | 1}
@@ -257,18 +374,6 @@ export class MonacoCompiler {
         }
         return v1;
     }
-    /**
-     * @returns {string | undefined}
-     */
-    format() {
-        const ret = wasm.monacocompiler_format(this.__wbg_ptr);
-        let v1;
-        if (ret[0] !== 0) {
-            v1 = getStringFromWasm0(ret[0], ret[1]);
-            wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-        }
-        return v1;
-    }
     /**
      * @param {string} input
      * @param {CompileConfig} config
@@ -318,12 +423,37 @@ export function compile_buffer(script, config) {
     return CompileResult.__wrap(ret);
 }
 
+/**
+ * @param {string} source
+ * @param {CompileConfig} config
+ * @param {FormatOptions} options
+ * @param {Uint32Array} ranges
+ * @returns {FormatResult}
+ */
+export function format_sync(source, config, options, ranges) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    _assertClass(config, CompileConfig);
+    _assertClass(options, FormatOptions);
+    const ptr1 = passArray32ToWasm0(ranges, wasm.__wbindgen_malloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.format_sync(ptr0, len0, config.__wbg_ptr, options.__wbg_ptr, ptr1, len1);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return FormatResult.__wrap(ret[0]);
+}
+
 export function main() {
     wasm.main();
 }
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
+        __wbg_Error_408e67f47ca7b58b: function(arg0, arg1) {
+            const ret = Error(getStringFromWasm0(arg0, arg1));
+            return ret;
+        },
         __wbg___wbindgen_throw_bb96b2010945f0bc: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
@@ -371,6 +501,12 @@ const CompileConfigFinalization = (typeof FinalizationRegistry === 'undefined')
 const CompileResultFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_compileresult_free(ptr, 1));
+const FormatOptionsFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_formatoptions_free(ptr, 1));
+const FormatResultFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_formatresult_free(ptr, 1));
 const MonacoCompilerFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_monacocompiler_free(ptr, 1));
@@ -419,6 +555,13 @@ function getUint8ArrayMemory0() {
     return cachedUint8ArrayMemory0;
 }
 
+function passArray32ToWasm0(arg, malloc) {
+    const ptr = malloc(arg.length * 4, 4) >>> 0;
+    getUint32ArrayMemory0().set(arg, ptr / 4);
+    WASM_VECTOR_LEN = arg.length;
+    return ptr;
+}
+
 function passArray8ToWasm0(arg, malloc) {
     const ptr = malloc(arg.length * 1, 1) >>> 0;
     getUint8ArrayMemory0().set(arg, ptr / 1);
@@ -463,6 +606,12 @@ function passStringToWasm0(arg, malloc, realloc) {
     return ptr;
 }
 
+function takeFromExternrefTable0(idx) {
+    const value = wasm.__wbindgen_externrefs.get(idx);
+    wasm.__externref_table_dealloc(idx);
+    return value;
+}
+
 let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
 cachedTextDecoder.decode();
 const MAX_SAFARI_DECODE_BYTES = 2146435072;

package/lib/wasm_bg.wasm.d.ts

@@ -2,16 +2,29 @@
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
 export const __wbg_compileresult_free: (a: number, b: number) => void;
+export const __wbg_formatoptions_free: (a: number, b: number) => void;
+export const __wbg_formatresult_free: (a: number, b: number) => void;
 export const __wbg_monacocompiler_free: (a: number, b: number) => void;
 export const compile: (a: number, b: number, c: number) => number;
 export const compileresult_chunk: (a: number) => [number, number];
 export const compileresult_diagnostics: (a: number) => [number, number];
+export const format_sync: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
+export const formatoptions_insert_spaces: (a: number) => number;
+export const formatoptions_new: () => number;
+export const formatoptions_print_width: (a: number) => number;
+export const formatoptions_set_insert_spaces: (a: number, b: number) => void;
+export const formatoptions_set_print_width: (a: number, b: number) => void;
+export const formatoptions_set_tab_size: (a: number, b: number) => void;
+export const formatoptions_tab_size: (a: number) => number;
+export const formatresult_edit_count: (a: number) => number;
+export const formatresult_edit_text: (a: number, b: number) => [number, number];
+export const formatresult_ranges: (a: number) => [number, number];
 export const main: () => void;
 export const monacocompiler_diagnostics: (a: number) => [number, number];
 export const monacocompiler_emit: (a: number) => [number, number];
-export const monacocompiler_format: (a: number) => [number, number];
 export const monacocompiler_new: (a: number, b: number, c: number) => number;
 export const monacocompiler_parse: (a: number) => number;
+export const formatresult_diagnostics: (a: number) => [number, number];
 export const compile_buffer: (a: number, b: number, c: number) => number;
 export const __wbg_compileconfig_free: (a: number, b: number) => void;
 export const __wbg_get_compileconfig_diagnostic_error: (a: number) => number;
@@ -39,4 +52,5 @@ export const __wbindgen_free: (a: number, b: number, c: number) => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_externrefs: WebAssembly.Table;
+export const __externref_table_dealloc: (a: number) => void;
 export const __wbindgen_start: () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mirascript/wasm",
-  "version": "0.1.89",
+  "version": "0.1.91",
   "author": "CloudPSS",
   "license": "MIT",
   "description": "MiraScript compiler for WebAssembly",
@@ -30,8 +30,8 @@
     }
   },
   "devDependencies": {
-    "nodemon": "^3.1.14",
-    "@mirascript/constants": "~0.1.89"
+    "@mirascript/constants": "~0.1.91",
+    "nodemon": "^3.1.14"
   },
   "scripts": {
     "wasm": "wasm-pack build --target web --out-dir ../../packages/wasm/lib --no-pack ../../crates/wasm",

package/src/index.ts

@@ -39,6 +39,38 @@ export interface CompileResult {
     readonly chunk?: Uint8Array;
 }
 
+/** 源码格式化选项 */
+export interface FormatOptions {
+    /** 制表符宽度。 */
+    readonly tabSize?: number;
+    /** 是否使用空格缩进。 */
+    readonly insertSpaces?: boolean;
+    /** 最大打印宽度。 */
+    readonly printWidth?: number;
+}
+
+/** UTF-16 绝对偏移范围 */
+export interface FormatRange {
+    /** 起始 UTF-16 偏移。 */
+    readonly start: number;
+    /** 结束 UTF-16 偏移。 */
+    readonly end: number;
+}
+
+/** 源码格式化编辑 */
+export interface FormatEdit extends FormatRange {
+    /** 替换文本。 */
+    readonly text: string;
+}
+
+/** 源码格式化结果 */
+export interface FormatResult {
+    /** 编译诊断。 */
+    readonly diagnostics: Uint32Array;
+    /** 互不重叠的格式化编辑。 */
+    readonly edits: readonly FormatEdit[];
+}
+
 /** 编译 */
 function compileImpl<T>(
     compiler: (script: T, config: wasm.CompileConfig) => wasm.CompileResult,
@@ -66,3 +98,39 @@ export function compileSync(script: ScriptInput, config: Config | wasm.CompileCo
         ? compileImpl(wasm.compile, script, config)
         : compileImpl(wasm.compile_buffer, script, config);
 }
+
+/** 格式化 MiraScript 源码；ranges 使用 UTF-16 绝对偏移，省略时格式化整篇文档。 */
+export function formatSync(
+    source: string,
+    config: Config | wasm.CompileConfig,
+    options: FormatOptions = {},
+    ranges?: readonly FormatRange[],
+): FormatResult {
+    const cfg = createConfig(config);
+    const rawOptions = new wasm.FormatOptions();
+    rawOptions.tab_size = options.tabSize ?? 2;
+    rawOptions.insert_spaces = options.insertSpaces ?? true;
+    rawOptions.print_width = options.printWidth ?? 80;
+    const rawRanges = new Uint32Array((ranges?.length ?? 0) * 2);
+    for (const [index, range] of (ranges ?? []).entries()) {
+        rawRanges[index * 2] = range.start;
+        rawRanges[index * 2 + 1] = range.end;
+    }
+    const result = wasm.format_sync(source, cfg, rawOptions, rawRanges);
+    try {
+        const encodedRanges = result.ranges();
+        const edits: FormatEdit[] = [];
+        for (let index = 0; index < result.edit_count(); index++) {
+            edits.push({
+                start: encodedRanges[index * 2]!,
+                end: encodedRanges[index * 2 + 1]!,
+                text: result.edit_text(index) ?? '',
+            });
+        }
+        return { diagnostics: result.diagnostics(), edits };
+    } finally {
+        result.free();
+        rawOptions.free();
+        if (cfg !== config) cfg.free();
+    }
+}