@mirascript/cli 0.1.40

package/cli.js

@@ -0,0 +1,5 @@
+#! /usr/bin/env node
+
+import program from './dist/index.js';
+
+await program.parseAsync();

package/dist/index.js

@@ -0,0 +1,240 @@
+// src/index.ts
+import { program as program3 } from "@commander-js/extra-typings";
+import pkg from "#package.json" with { type: "json" };
+
+// src/commands/run.ts
+import { readFile, stat } from "node:fs/promises";
+import { pathToFileURL } from "node:url";
+import { InvalidArgumentError, program } from "@commander-js/extra-typings";
+import { compileSync, configCheckpoint } from "@mirascript/mirascript";
+
+// src/utils/execute.ts
+import styles2 from "ansi-styles";
+import supportsColor2 from "supports-color";
+import { compile, createVmContext } from "@mirascript/mirascript";
+import { lib } from "@mirascript/mirascript/subtle";
+
+// src/utils/print.ts
+import styles from "ansi-styles";
+import supportsColor from "supports-color";
+import {
+  serialize,
+  serializeNumber,
+  serializeBoolean,
+  serializeNil,
+  operations
+} from "@mirascript/mirascript/subtle";
+var noColor = !supportsColor.stdout;
+var options = {
+  maxDepth: 3,
+  serializeNil: noColor ? void 0 : () => styles.gray.open + serializeNil() + styles.gray.close,
+  serializeBoolean: noColor ? void 0 : (v) => styles.blue.open + serializeBoolean(v) + styles.blue.close,
+  serializeNumber: noColor ? void 0 : (v) => styles.yellow.open + serializeNumber(v) + styles.yellow.close,
+  serializeStringQuote: noColor ? void 0 : (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 ? void 0 : (v) => styles.bold.open + v + styles.bold.close,
+  serializePropName: noColor ? void 0 : (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, options2) => {
+    return operations.$ToString(v) + " " + options2.serializeRecord(v.value, depth, options2);
+  } : (v, depth, options2) => {
+    return styles.magenta.open + operations.$ToString(v) + styles.magenta.close + " " + options2.serializeRecord(v.value, depth, options2);
+  }
+};
+function print(value, depth = 3) {
+  if (value === void 0) {
+    if (noColor) return "<uninitialized>";
+    return styles.gray.open + "<uninitialized>" + styles.gray.close;
+  }
+  return serialize(value, { ...options, maxDepth: depth });
+}
+
+// src/utils/execute.ts
+var { panic, debug_print } = lib;
+panic.serializer = debug_print.serializer = (arg, format2) => {
+  if (format2 === "%o" || format2 === "%O" || !format2) {
+    return print(arg);
+  }
+  return null;
+};
+async function execute(script, template, variables, fileName) {
+  try {
+    const f = await compile(script, { input_mode: template ? "Template" : "Script", sourceMap: true, fileName });
+    const r = f(createVmContext(variables));
+    if (template) {
+      console.log(r);
+    } else {
+      console.log(print(r));
+    }
+  } catch (ex) {
+    const { stack } = ex;
+    if (supportsColor2.stderr) {
+      console.error(styles2.red.open + stack + styles2.red.close);
+    } else {
+      console.error(stack);
+    }
+    process.exitCode = 2;
+  }
+}
+
+// src/commands/run.ts
+var DEFAULT_TIMEOUT = 3e3;
+program.command("run", { isDefault: true }).description("执行 MiraScript 脚本，默认命令").option(
+  "-v, --variable <key=value>",
+  "设置全局变量，可以多次使用",
+  (v, p) => {
+    p = { ...p };
+    const i = v.indexOf("=");
+    if (i < 0) {
+      p[v] = true;
+    } else {
+      const key = v.slice(0, i).trim();
+      const value = v.slice(i + 1).trim();
+      try {
+        const pv = compileSync(`return (${value});`)();
+        p[key] = pv ?? value;
+      } catch {
+        p[key] = value;
+      }
+    }
+    return p;
+  },
+  {}
+).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) {
+    const template = !!opt.template;
+    await execute(opt.eval, template, opt.variable, template ? "eval.miratpl" : "eval.mira");
+    return;
+  }
+  if (script) {
+    try {
+      const s = await stat(script);
+      if (!s.isFile()) {
+        console.error(`脚本路径不是文件: ${script}`);
+        process.exitCode = 2;
+        return;
+      }
+    } catch (ex) {
+      if (ex.code === "ENOENT") {
+        console.error(`脚本文件不存在: ${script}`);
+        process.exitCode = 2;
+      } else if (ex.code === "EACCES") {
+        console.error(`权限不足: ${ex.message}`);
+        process.exitCode = 3;
+      } else {
+        console.error(`无法访问脚本文件: ${ex.message}`);
+        process.exitCode = 1;
+      }
+      return;
+    }
+    const context = await readFile(script, "utf8");
+    const template = opt.template ?? script.endsWith(".miratpl");
+    await execute(context, template, opt.variable, pathToFileURL(script).href);
+    return;
+  }
+  program.help({ error: true });
+});
+
+// src/commands/format.ts
+import fs from "node:fs/promises";
+import { program as program2 } from "@commander-js/extra-typings";
+import { loadModule } from "@mirascript/bindings/wasm";
+var templateConfig = null;
+var scriptConfig = null;
+async function getConfig(templateMode) {
+  const mod = await loadModule();
+  if (templateMode) {
+    if (!templateConfig) {
+      templateConfig = new mod.wasm.Config();
+      templateConfig.input_mode = mod.wasm.InputMode.Template;
+      templateConfig.trivia = true;
+      templateConfig.diagnostic_position_encoding = mod.wasm.DiagnosticPositionEncoding.Utf8;
+    }
+    return templateConfig;
+  } else {
+    if (!scriptConfig) {
+      scriptConfig = new mod.wasm.Config();
+      scriptConfig.input_mode = mod.wasm.InputMode.Script;
+      scriptConfig.trivia = true;
+      scriptConfig.diagnostic_position_encoding = mod.wasm.DiagnosticPositionEncoding.Utf8;
+    }
+    return scriptConfig;
+  }
+}
+async function format(input, templateMode) {
+  if (!input) return "";
+  const mod = await loadModule();
+  const compiler = new mod.wasm.MonacoCompiler(input, await getConfig(templateMode));
+  try {
+    if (!compiler.parse()) return void 0;
+    const formatted = compiler.format();
+    if (!formatted) return void 0;
+    return formatted;
+  } finally {
+    compiler.free();
+  }
+}
+var command = program2.command("format");
+command.description("格式化 MiraScript 脚本").option("-w, --write", "直接修改文件").option("-t, --template", "对无法推断类型的文件使用模板模式").argument("<script...>", '要格式化的脚本文件路径或 glob，输入 "-" 表示从标准输入读取').action(async (script, opt) => {
+  if (script.length === 0) {
+    command.help({ error: true });
+  }
+  if (script.length === 1 && script[0] === "-") {
+    let input = "";
+    for await (const chunk of process.stdin) {
+      input += chunk;
+    }
+    const output = await format(input, !!opt.template);
+    if (output == null) {
+      console.error("格式化失败");
+      process.exit(1);
+    }
+    process.stdout.write(output);
+    return;
+  }
+  for await (const file of fs.glob(script)) {
+    const input = await fs.readFile(file, "utf8");
+    const output = await format(input, !!opt.template);
+    if (opt.write) {
+      if (output == null) {
+        console.error(`格式化失败: ${file}`);
+        continue;
+      }
+      if (output === input) {
+        console.warn(`文件未更改: ${file}`);
+        continue;
+      }
+      await fs.writeFile(file, output, "utf8");
+      console.warn(`已格式化文件: ${file}`);
+    } else {
+      process.stdout.write(`// File: ${file}
+`);
+      process.stdout.write((output ?? input) + "\n");
+    }
+  }
+});
+
+// src/index.ts
+var index_default = program3.name(pkg.name.split("/").pop()).version(pkg.version).description(pkg.description);
+export {
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/commands/run.ts", "../src/utils/execute.ts", "../src/utils/print.ts", "../src/commands/format.ts"],
+  "mappings": "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",
+  "names": ["program", "styles", "supportsColor", "options", "format", "supportsColor", "styles", "program", "program"]
+}

package/esbuild.config.js

@@ -0,0 +1,38 @@
+import esbuild from 'esbuild';
+import { parseArgs } from 'node:util';
+
+const args = parseArgs({
+    options: {
+        watch: {
+            type: 'boolean',
+            default: false,
+        },
+    },
+});
+
+const context = await esbuild.context({
+    sourcemap: true,
+    sourcesContent: false,
+    format: 'esm',
+    charset: 'utf8',
+    entryPoints: ['./src/index.ts'],
+    outdir: './dist',
+    target: 'esnext',
+    bundle: true,
+    packages: 'external',
+    external: ['#package.json'],
+    minify: false,
+    treeShaking: true,
+    splitting: true,
+});
+
+await context.rebuild();
+if (args.values.watch) {
+    await context.watch();
+    process.on('SIGINT', async () => {
+        await context.dispose();
+        process.exit(0);
+    });
+} else {
+    await context.dispose();
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@mirascript/cli",
+  "version": "0.1.40",
+  "author": "CloudPSS",
+  "license": "MIT",
+  "description": "Cli for MiraScript, an expression based scripting language.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "mirascript": "./cli.js"
+  },
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "@mirascript/dev": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "imports": {
+    "#package.json": "./package.json"
+  },
+  "dependencies": {
+    "@cloudpss/worker": "^0.1.10",
+    "@commander-js/extra-typings": "^14.0.0",
+    "ansi-styles": "^6.2.3",
+    "commander": "^14.0.2",
+    "supports-color": "^10.2.2",
+    "@mirascript/bindings": "~0.1.40",
+    "@mirascript/mirascript": "~0.1.40"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.10",
+    "type-fest": "^5.4.1"
+  },
+  "scripts": {
+    "watch": "pnpm build --watch",
+    "build": "pnpm clean && node ./esbuild.config.js",
+    "mirascript": "node --enable-source-maps ./cli.js",
+    "clean": "rimraf dist"
+  }
+}

package/src/commands/format.ts

@@ -0,0 +1,90 @@
+/* eslint-disable no-console */
+import fs from 'node:fs/promises';
+import { program } from '@commander-js/extra-typings';
+import { loadModule, type BcModule } from '@mirascript/bindings/wasm';
+
+let templateConfig: BcModule.WasmConfig | null = null;
+let scriptConfig: BcModule.WasmConfig | null = null;
+
+/** 获取配置 */
+async function getConfig(templateMode: boolean): Promise<BcModule.WasmConfig> {
+    const mod = await loadModule();
+    if (templateMode) {
+        if (!templateConfig) {
+            templateConfig = new mod.wasm.Config();
+            templateConfig.input_mode = mod.wasm.InputMode.Template;
+            templateConfig.trivia = true;
+            templateConfig.diagnostic_position_encoding = mod.wasm.DiagnosticPositionEncoding.Utf8;
+        }
+        return templateConfig;
+    } else {
+        if (!scriptConfig) {
+            scriptConfig = new mod.wasm.Config();
+            scriptConfig.input_mode = mod.wasm.InputMode.Script;
+            scriptConfig.trivia = true;
+            scriptConfig.diagnostic_position_encoding = mod.wasm.DiagnosticPositionEncoding.Utf8;
+        }
+        return scriptConfig;
+    }
+}
+
+/** 格式化 */
+async function format(input: string, templateMode: boolean): Promise<string | undefined> {
+    if (!input) return '';
+
+    const mod = await loadModule();
+    const compiler = new mod.wasm.MonacoCompiler(input, await getConfig(templateMode));
+    try {
+        if (!compiler.parse()) return undefined;
+        const formatted = compiler.format();
+        if (!formatted) return undefined;
+        return formatted;
+    } finally {
+        compiler.free();
+    }
+}
+
+const command = program.command('format');
+command
+    .description('格式化 MiraScript 脚本')
+    .option('-w, --write', '直接修改文件')
+    .option('-t, --template', '对无法推断类型的文件使用模板模式')
+    .argument('<script...>', '要格式化的脚本文件路径或 glob，输入 "-" 表示从标准输入读取')
+    .action(async (script, opt) => {
+        if (script.length === 0) {
+            command.help({ error: true });
+        }
+        if (script.length === 1 && script[0] === '-') {
+            // 从标准输入读取
+            let input = '';
+            for await (const chunk of process.stdin) {
+                input += chunk;
+            }
+            const output = await format(input, !!opt.template);
+            if (output == null) {
+                console.error('格式化失败');
+                process.exit(1);
+            }
+            process.stdout.write(output);
+            return;
+        }
+        for await (const file of fs.glob(script)) {
+            const input = await fs.readFile(file, 'utf8');
+            const output = await format(input, !!opt.template);
+            if (opt.write) {
+                if (output == null) {
+                    console.error(`格式化失败: ${file}`);
+                    continue;
+                }
+                if (output === input) {
+                    console.warn(`文件未更改: ${file}`);
+                    continue;
+                }
+                await fs.writeFile(file, output, 'utf8');
+                console.warn(`已格式化文件: ${file}`);
+            } else {
+                process.stdout.write(`// File: ${file}\n`);
+                process.stdout.write((output ?? input) + '\n');
+            }
+        }
+    });

package/src/commands/run.ts

@@ -0,0 +1,85 @@
+import { readFile, stat } from 'node:fs/promises';
+import { pathToFileURL } from 'node:url';
+import { InvalidArgumentError, program } from '@commander-js/extra-typings';
+import { compileSync, configCheckpoint, type VmValue } from '@mirascript/mirascript';
+import { execute } from '../utils/execute.js';
+
+const DEFAULT_TIMEOUT = 3000;
+
+/* eslint-disable no-console */
+program
+    .command('run', { isDefault: true })
+    .description('执行 MiraScript 脚本，默认命令')
+    .option(
+        '-v, --variable <key=value>',
+        '设置全局变量，可以多次使用',
+        (v, p) => {
+            p = { ...p };
+            const i = v.indexOf('=');
+            if (i < 0) {
+                p[v] = true;
+            } else {
+                const key = v.slice(0, i).trim();
+                const value = v.slice(i + 1).trim();
+                try {
+                    const pv = compileSync(`return (${value});`)();
+                    p[key] = pv ?? value;
+                } catch {
+                    p[key] = value;
+                }
+            }
+            return p;
+        },
+        {} 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) {
+            const template = !!opt.template;
+            await execute(opt.eval, template, opt.variable, template ? 'eval.miratpl' : 'eval.mira');
+            return;
+        }
+        if (script) {
+            try {
+                const s = await stat(script);
+                if (!s.isFile()) {
+                    console.error(`脚本路径不是文件: ${script}`);
+                    process.exitCode = 2;
+                    return;
+                }
+            } catch (ex) {
+                if ((ex as NodeJS.ErrnoException).code === 'ENOENT') {
+                    console.error(`脚本文件不存在: ${script}`);
+                    process.exitCode = 2;
+                } else if ((ex as NodeJS.ErrnoException).code === 'EACCES') {
+                    console.error(`权限不足: ${(ex as NodeJS.ErrnoException).message}`);
+                    process.exitCode = 3;
+                } else {
+                    console.error(`无法访问脚本文件: ${(ex as NodeJS.ErrnoException).message}`);
+                    process.exitCode = 1;
+                }
+                return;
+            }
+            const context = await readFile(script, 'utf8');
+            const template = opt.template ?? script.endsWith('.miratpl');
+            await execute(context, template, opt.variable, pathToFileURL(script).href);
+            return;
+        }
+        program.help({ error: true });
+    });

package/src/index.ts

@@ -0,0 +1,7 @@
+import { program } from '@commander-js/extra-typings';
+import pkg from '#package.json' with { type: 'json' };
+
+import './commands/run.js';
+import './commands/format.js';
+
+export default program.name(pkg.name.split('/').pop()!).version(pkg.version).description(pkg.description);

package/src/utils/execute.ts

@@ -0,0 +1,41 @@
+/* eslint-disable no-console */
+import styles from 'ansi-styles';
+import supportsColor from 'supports-color';
+import { compile, createVmContext, type VmValue } from '@mirascript/mirascript';
+import { lib } from '@mirascript/mirascript/subtle';
+import { print } from './print.js';
+
+const { panic, debug_print } = lib;
+
+panic.serializer = debug_print.serializer = (arg, format) => {
+    if (format === '%o' || format === '%O' || !format) {
+        return print(arg);
+    }
+    return null;
+};
+
+/** 执行脚本 */
+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', sourceMap: true, fileName });
+        const r = f(createVmContext(variables));
+        if (template) {
+            console.log(r);
+        } else {
+            console.log(print(r));
+        }
+    } catch (ex) {
+        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/utils/print.ts

@@ -0,0 +1,57 @@
+import styles from 'ansi-styles';
+import supportsColor from 'supports-color';
+import type { VmAny, VmRecord } from '@mirascript/mirascript';
+import {
+    serialize,
+    serializeNumber,
+    serializeBoolean,
+    serializeNil,
+    type SerializeOptions,
+    operations,
+} from '@mirascript/mirascript/subtle';
+
+const noColor = !supportsColor.stdout;
+
+const options: Partial<SerializeOptions> = {
+    maxDepth: 3,
+    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/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  // 如果使用其他版本 TS，使用类似 "extends": "@cloudpss/tsconfig/4.2" 引入
+  "extends": "../../tsconfig.json",
+
+  "compilerOptions": {
+    "noEmit": true
+  }
+}