@mirascript/cli 0.1.86 → 0.1.88

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-import { program as program4 } from "@commander-js/extra-typings";
+import { program as program5 } from "@commander-js/extra-typings";
 import pkg from "#package.json" with { type: "json" };
 
 // src/commands/run.ts
@@ -28,13 +28,23 @@ import {
 // src/utils/color.ts
 import supportsColor from "supports-color";
 var noColor = !supportsColor.stdout;
+function format(text2, style) {
+  if (style && !noColor) {
+    return style.open + text2 + style.close;
+  } else {
+    return text2;
+  }
+}
+function write(text2, style) {
+  process.stdout.write(format(text2, style));
+}
 
 // src/utils/print.ts
 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,
+  serializeNil: noColor ? void 0 : () => format(serializeNil(), styles.gray),
+  serializeBoolean: noColor ? void 0 : (v) => format(serializeBoolean(v), styles.blue),
+  serializeNumber: noColor ? void 0 : (v) => format(serializeNumber(v), styles.yellow),
   serializeStringQuote: noColor ? void 0 : (v, open) => {
     const q = styles.dim.open + v + styles.dim.close;
     if (open) {
@@ -43,30 +53,27 @@ var options = {
       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);
+  serializeStringEscape: noColor ? void 0 : (v) => format(v, styles.bold),
+  serializePropName: noColor ? void 0 : (v) => format(String(v), styles.whiteBright),
+  serializeFunction: (v) => format(operations.$ToString(v), styles.cyan),
+  serializeModule: (v, depth, options2) => {
+    return format(operations.$ToString(v), styles.magenta) + " " + 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 format("<undefined>", styles.gray);
   }
   return serialize(value, { ...options, maxDepth: depth });
 }
 
 // src/utils/execute.ts
 var { panic, debug_print } = lib;
-panic.serializer = debug_print.serializer = (arg, format2) => {
-  if (!format2 && typeof arg == "string") {
+panic.serializer = debug_print.serializer = (arg, format3) => {
+  if (!format3 && typeof arg == "string") {
     return null;
   }
-  if (format2 === "%o" || format2 === "%O" || !format2) {
+  if (format3 === "%o" || format3 === "%O" || !format3) {
     return print(arg);
   }
   return null;
@@ -316,7 +323,7 @@ async function getConfig(templateMode) {
     return scriptConfig;
   }
 }
-async function format(input, templateMode) {
+async function format2(input, templateMode) {
   if (!input) return "";
   const mod = await loadModule();
   const compiler = new mod.wasm.MonacoCompiler(input, await getConfig(templateMode));
@@ -339,7 +346,7 @@ command2.description("格式化 MiraScript 脚本").option("-w, --write", "直
     for await (const chunk of process.stdin) {
       input += chunk;
     }
-    const output = await format(input, !!opt.template);
+    const output = await format2(input, !!opt.template);
     if (output == null) {
       console.error("格式化失败");
       process.exit(1);
@@ -349,7 +356,7 @@ command2.description("格式化 MiraScript 脚本").option("-w, --write", "直
   }
   for await (const file of fs.glob(script)) {
     const input = await fs.readFile(file, "utf8");
-    const output = await format(input, !!opt.template);
+    const output = await format2(input, !!opt.template);
     if (opt.write) {
       if (output == null) {
         console.error(`格式化失败: ${file}`);
@@ -375,11 +382,163 @@ program3.command("repl").description("启动 MiraScript REPL（交互式命令
   await startRepl();
 });
 
+// src/commands/man/index.ts
+import { program as program4 } from "@commander-js/extra-typings";
+import { lib as lib3 } from "@mirascript/mirascript/subtle";
+import { KEYWORDS, OPERATORS } from "@mirascript/help";
+
+// src/commands/man/lib.ts
+import styles4 from "ansi-styles";
+import { lib as lib2 } from "@mirascript/mirascript/subtle";
+
+// src/commands/man/table.ts
+import styles3 from "ansi-styles";
+function printTable(map, title, formatter = String) {
+  if (title) {
+    write(title + "\n", styles3.bold);
+  }
+  const keys = Object.keys(map).sort();
+  const maxKeyLength = Math.max(...keys.map((k) => k.length));
+  for (const key of keys) {
+    const value = map[key];
+    if (value === void 0) continue;
+    const firstLine = formatter(value, key).split("\n")[0];
+    write("  ", styles3.dim);
+    write(key, styles3.greenBright);
+    write(" ".repeat(maxKeyLength - key.length), styles3.dim);
+    write("  " + firstLine + "\n");
+  }
+}
+
+// src/commands/man/lib.ts
+function analyzePath(path2) {
+  const segments = path2.split(".").map((s) => s.trim()).filter((s) => s.length > 0);
+  if (segments.length === 0) return [];
+  if (segments[0] === "lib") {
+    return segments.slice(1);
+  }
+  return segments;
+}
+function getLibValue(path2) {
+  let value = lib2;
+  for (const seg of path2) {
+    if (value === void 0) return void 0;
+    value = value[seg.trim()];
+  }
+  return value;
+}
+function printKw(kw) {
+  write(kw, styles4.blueBright);
+}
+function printComment(comment) {
+  const lines = comment.split("\n");
+  for (const line of lines) {
+    write("// ", styles4.dim);
+    write(line, styles4.gray);
+    write("\n");
+  }
+}
+function printLib(name) {
+  const path2 = analyzePath(name);
+  const value = getLibValue(path2);
+  if (value === void 0) return false;
+  if ("value" in value) {
+    if (value.summary) {
+      printComment(value.summary);
+    }
+    printKw("let");
+    write(" ");
+    write(path2.join("."), styles4.cyanBright);
+    write(" = ");
+    write(print(value.value));
+    write(";\n");
+  } else if ("summary" in value) {
+    if (value.summary) {
+      printComment(value.summary);
+    }
+    const params = value.params ? Object.entries(value.params) : null;
+    for (const [name2, param] of params ?? []) {
+      if (!param.description) continue;
+      const comment = `\`${name2}\` - ${param.description}`;
+      printComment(comment);
+    }
+    if (value.returns?.description) {
+      printComment(`返回值 - ${value.returns.description}`);
+    }
+    printKw("fn");
+    write(" ");
+    write(path2.join("."), styles4.yellowBright);
+    write("(");
+    if (!params) {
+      write("..");
+    } else {
+      for (let i = 0; i < params.length; i++) {
+        const [name2, param] = params[i];
+        if (i > 0) {
+          write(", ");
+        }
+        write(format(name2, styles4.italic), styles4.cyanBright);
+        write(": ");
+        write(param.type, styles4.greenBright);
+      }
+    }
+    write(")");
+    if (value.returns) {
+      write(" -> ");
+      write(value.returns.type, styles4.greenBright);
+    }
+    write(";\n");
+    if (value.examples?.length) {
+      for (const example of value.examples) {
+        printComment(example);
+      }
+    }
+  } else {
+    printKw("mod");
+    write(" ");
+    write(path2.join("."), styles4.cyanBright);
+    write(" {\n");
+    printTable(value, "", (v) => v.summary);
+    write("}\n");
+  }
+  return true;
+}
+
+// src/commands/man/index.ts
+var command3 = program4.command("man");
+command3.description("显示 MiraScript 的手册").argument(
+  "<topic>",
+  '要显示的主题，可以是 "keywords"、"operators"、"libraries" 或标准库中的函数/模块名（如 "matrix.add"）、关键字/操作符（如 "if"、"&&"）'
+).action((topic) => {
+  if (topic in KEYWORDS) {
+    const desc = KEYWORDS[topic];
+    console.log(desc);
+  } else if (topic in OPERATORS) {
+    const desc = OPERATORS[topic];
+    console.log(desc);
+  } else if (printLib(topic)) {
+    return;
+  } else if (topic === "keywords") {
+    printTable(KEYWORDS, "MiraScript 关键字：");
+  } else if (topic === "operators") {
+    printTable(OPERATORS, "MiraScript 操作符：");
+  } else if (topic === "libraries") {
+    printTable(lib3, "MiraScript 标准库：", (v, k) => {
+      if ("summary" in v) {
+        return v.summary ?? k;
+      }
+      return `模块 ${k}`;
+    });
+  } else {
+    command3.help({ error: true });
+  }
+});
+
 // src/index.ts
-var p = program4;
+var p = program5;
 var binName = Object.keys(pkg.bin)[0];
 if (binName) {
-  p = program4.name(binName);
+  p = program5.name(binName);
 }
 var index_default = p.version(pkg.version).description(pkg.description);
 export {

package/dist/index.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../src/index.ts", "../src/commands/run.ts", "../src/utils/execute.ts", "../src/utils/print.ts", "../src/utils/color.ts", "../src/utils/repl.ts", "../src/commands/format.ts", "../src/commands/repl.ts"],
-  "mappings": "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",
-  "names": ["program", "styles", "supportsColor", "options", "format", "supportsColor", "styles", "compile", "CompileError", "createVmContext", "CompileError", "createVmContext", "script", "compile", "result", "p", "template", "program", "command", "program", "program", "program"]
+  "sources": ["../src/index.ts", "../src/commands/run.ts", "../src/utils/execute.ts", "../src/utils/print.ts", "../src/utils/color.ts", "../src/utils/repl.ts", "../src/commands/format.ts", "../src/commands/repl.ts", "../src/commands/man/index.ts", "../src/commands/man/lib.ts", "../src/commands/man/table.ts"],
+  "mappings": "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",
+  "names": ["program", "styles", "supportsColor", "text", "options", "format", "supportsColor", "styles", "compile", "CompileError", "createVmContext", "CompileError", "createVmContext", "script", "compile", "result", "p", "template", "program", "format", "command", "program", "program", "program", "lib", "styles", "lib", "styles", "styles", "path", "lib", "styles", "name", "command", "program", "lib", "program"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mirascript/cli",
-  "version": "0.1.86",
+  "version": "0.1.88",
   "author": "CloudPSS",
   "license": "MIT",
   "description": "Cli for MiraScript, an expression based scripting language.",
@@ -38,8 +38,9 @@
     "ansi-styles": "^7.0.0",
     "commander": "^15.0.0",
     "supports-color": "^11.0.0",
-    "@mirascript/bindings": "~0.1.86",
-    "@mirascript/mirascript": "~0.1.86"
+    "@mirascript/bindings": "~0.1.88",
+    "@mirascript/mirascript": "~0.1.88",
+    "@mirascript/help": "~0.1.88"
   },
   "devDependencies": {
     "type-fest": "^5.8.0"

package/src/commands/man/index.ts

@@ -0,0 +1,38 @@
+/* eslint-disable no-console */
+import { program } from '@commander-js/extra-typings';
+import { lib } from '@mirascript/mirascript/subtle';
+import { KEYWORDS, OPERATORS } from '@mirascript/help';
+import { printLib } from './lib.js';
+import { printTable } from './table.js';
+
+const command = program.command('man');
+command
+    .description('显示 MiraScript 的手册')
+    .argument(
+        '<topic>',
+        '要显示的主题，可以是 "keywords"、"operators"、"libraries" 或标准库中的函数/模块名（如 "matrix.add"）、关键字/操作符（如 "if"、"&&"）',
+    )
+    .action((topic) => {
+        if (topic in KEYWORDS) {
+            const desc = KEYWORDS[topic as keyof typeof KEYWORDS];
+            console.log(desc);
+        } else if (topic in OPERATORS) {
+            const desc = OPERATORS[topic as keyof typeof OPERATORS];
+            console.log(desc);
+        } else if (printLib(topic)) {
+            return;
+        } else if (topic === 'keywords') {
+            printTable(KEYWORDS, 'MiraScript 关键字：');
+        } else if (topic === 'operators') {
+            printTable(OPERATORS, 'MiraScript 操作符：');
+        } else if (topic === 'libraries') {
+            printTable(lib, 'MiraScript 标准库：', (v, k) => {
+                if ('summary' in v) {
+                    return v.summary ?? k;
+                }
+                return `模块 ${k}`;
+            });
+        } else {
+            command.help({ error: true });
+        }
+    });

package/src/commands/man/lib.ts

@@ -0,0 +1,110 @@
+import styles from 'ansi-styles';
+import { format, write } from '../../utils/color.js';
+import { print } from '../../utils/print.js';
+import { lib } from '@mirascript/mirascript/subtle';
+import { printTable } from './table.js';
+
+/** 分析路径 */
+function analyzePath(path: string): readonly string[] {
+    const segments = path
+        .split('.')
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    if (segments.length === 0) return [];
+    if (segments[0] === 'lib') {
+        return segments.slice(1);
+    }
+    return segments;
+}
+
+/** 获取库值 */
+function getLibValue(path: readonly string[]): (typeof lib)[keyof typeof lib] | undefined {
+    let value: object = lib;
+    for (const seg of path) {
+        if (value === undefined) return undefined;
+        value = value[seg.trim() as keyof typeof value];
+    }
+    return value as (typeof lib)[keyof typeof lib] | undefined;
+}
+
+/** 打印关键字 */
+function printKw(kw: string): void {
+    write(kw, styles.blueBright);
+}
+
+/** 打印注释 */
+function printComment(comment: string): void {
+    const lines = comment.split('\n');
+    for (const line of lines) {
+        write('// ', styles.dim);
+        write(line, styles.gray);
+        write('\n');
+    }
+}
+
+/** 打印库 */
+export function printLib(name: string): boolean {
+    const path = analyzePath(name);
+    const value = getLibValue(path);
+    if (value === undefined) return false;
+    if ('value' in value) {
+        if (value.summary) {
+            printComment(value.summary);
+        }
+        printKw('let');
+        write(' ');
+        write(path.join('.'), styles.cyanBright);
+        write(' = ');
+        write(print(value.value));
+        write(';\n');
+    } else if ('summary' in value) {
+        if (value.summary) {
+            printComment(value.summary);
+        }
+        const params = value.params ? Object.entries(value.params) : null;
+        for (const [name, param] of params ?? []) {
+            if (!param.description) continue;
+            const comment = `\`${name}\` - ${param.description}`;
+            printComment(comment);
+        }
+        if (value.returns?.description) {
+            printComment(`返回值 - ${value.returns.description}`);
+        }
+        printKw('fn');
+        write(' ');
+        write(path.join('.'), styles.yellowBright);
+        write('(');
+        if (!params) {
+            write('..');
+        } else {
+            for (let i = 0; i < params.length; i++) {
+                const [name, param] = params[i]!;
+                if (i > 0) {
+                    write(', ');
+                }
+                write(format(name, styles.italic), styles.cyanBright);
+                write(': ');
+                write(param.type, styles.greenBright);
+            }
+        }
+        write(')');
+        if (value.returns) {
+            write(' -> ');
+            write(value.returns.type, styles.greenBright);
+        }
+        write(';\n');
+        if (value.examples?.length) {
+            for (const example of value.examples) {
+                printComment(example);
+            }
+        }
+    } else {
+        printKw('mod');
+        write(' ');
+        write(path.join('.'), styles.cyanBright);
+        write(' {\n');
+        printTable(value as Record<string, { summary: string }>, '', (v) => v.summary);
+        write('}\n');
+    }
+    return true;
+}

package/src/commands/man/table.ts

@@ -0,0 +1,27 @@
+import styles from 'ansi-styles';
+import { write } from '../../utils/color.js';
+
+/** 打印表格 */
+export function printTable<T>(
+    map: Record<string, T>,
+    title: string,
+    formatter: (value: T, key: string) => string = String,
+): void {
+    if (title) {
+        write(title + '\n', styles.bold);
+    }
+
+    const keys = Object.keys(map).sort();
+    const maxKeyLength = Math.max(...keys.map((k) => k.length));
+
+    for (const key of keys) {
+        const value = map[key];
+        if (value === undefined) continue;
+
+        const firstLine = formatter(value, key).split('\n')[0];
+        write('  ', styles.dim);
+        write(key, styles.greenBright);
+        write(' '.repeat(maxKeyLength - key.length), styles.dim);
+        write('  ' + firstLine + '\n');
+    }
+}

package/src/index.ts

@@ -4,6 +4,7 @@ import pkg from '#package.json' with { type: 'json' };
 import './commands/run.js';
 import './commands/format.js';
 import './commands/repl.js';
+import './commands/man/index.js';
 
 let p = program;
 const binName = Object.keys(pkg.bin)[0];

package/src/utils/color.ts

@@ -1,2 +1,16 @@
+import type { CSPair } from 'ansi-styles';
 import supportsColor from 'supports-color';
 export const noColor = !supportsColor.stdout;
+
+/** 格式化 */
+export function format(text: string, style?: CSPair): string {
+    if (style && !noColor) {
+        return style.open + text + style.close;
+    } else {
+        return text;
+    }
+}
+/** 写入 */
+export function write(text: string, style?: CSPair): void {
+    process.stdout.write(format(text, style));
+}

package/src/utils/print.ts

@@ -8,13 +8,13 @@ import {
     type SerializeOptions,
     operations,
 } from '@mirascript/mirascript/subtle';
-import { noColor } from './color.js';
+import { noColor, format } from './color.js';
 
 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,
+    serializeNil: noColor ? undefined : () => format(serializeNil(), styles.gray),
+    serializeBoolean: noColor ? undefined : (v) => format(serializeBoolean(v), styles.blue),
+    serializeNumber: noColor ? undefined : (v) => format(serializeNumber(v), styles.yellow),
     serializeStringQuote: noColor
         ? undefined
         : (v, open) => {
@@ -25,31 +25,22 @@ const options: Partial<SerializeOptions> = {
                   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)
-              );
-          },
+    serializeStringEscape: noColor ? undefined : (v) => format(v, styles.bold),
+    serializePropName: noColor ? undefined : (v) => format(String(v), styles.whiteBright),
+    serializeFunction: (v) => format(operations.$ToString(v), styles.cyan),
+    serializeModule: (v, depth, options) => {
+        return (
+            format(operations.$ToString(v), styles.magenta) +
+            ' ' +
+            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 format('<undefined>', styles.gray);
     }
     return serialize(value, { ...options, maxDepth: depth });
 }