@mirascript/mirascript 0.1.17 → 0.1.19

package/src/cli/execute.ts

@@ -2,10 +2,17 @@
 import styles from 'ansi-styles';
 import supportsColor from 'supports-color';
 import { compile } from '../index.js';
-import { createVmContext, VmFunction, type VmValue } from '../vm/index.js';
-import { debug_print } from '../vm/lib/global/debug.js';
+import { createVmContext, type VmValue } from '../vm/index.js';
+import { debug_print, panic } from '../vm/lib/global/debug.js';
 import { print } from './print.js';
 
+panic.serializer = debug_print.serializer = (arg, format) => {
+    if (format === '%o' || format === '%O' || !format) {
+        return print(arg);
+    }
+    return null;
+};
+
 /** 执行脚本 */
 export async function execute(
     script: string,
@@ -15,14 +22,7 @@ export async function execute(
 ): Promise<void> {
     try {
         const f = await compile(script, { input_mode: template ? 'Template' : 'Script', sourceMap: true, fileName });
-        const r = f(
-            createVmContext({
-                debug_print: VmFunction((...values) => {
-                    console.log(...debug_print.prefix, ...values.map((v) => (typeof v == 'string' ? v : print(v))));
-                }, debug_print),
-                ...variables,
-            }),
-        );
+        const r = f(createVmContext(variables));
         if (template) {
             console.log(r);
         } else {

package/src/compiler/diagnostic.ts

@@ -8,11 +8,12 @@ export { DiagnosticCode };
 const diagnosticMessages = new Map<DiagnosticCode, string | null>();
 /** 获取 {@link DiagnosticCode} 对应的消息 */
 export function getDiagnosticMessage(code: DiagnosticCode): string | null {
-    if (!isSafeInteger(code) || code < 0 || code >= 0xffff) {
+    if (code < 0 || code >= 0xffff || !isSafeInteger(code)) {
         throw new RangeError(`Invalid DiagnosticCode: ${code}`);
     }
-    if (diagnosticMessages.has(code)) {
-        return diagnosticMessages.get(code) || null;
+    const cached = diagnosticMessages.get(code);
+    if (cached !== undefined) {
+        return cached;
     }
     const mod = getModule();
     const msg = mod.getDiagnosticMessage(code);
@@ -83,6 +84,23 @@ interface ParsedDiagnostics {
     sourcemaps: IRange[];
 }
 
+const {
+    ErrorStart,
+    ErrorEnd,
+    WarningStart,
+    WarningEnd,
+    InfoStart,
+    InfoEnd,
+    HintStart,
+    HintEnd,
+    TagStart,
+    TagEnd,
+    ReferenceStart,
+    ReferenceEnd,
+    TagRefStart,
+    TagRefEnd,
+    SourceMap,
+} = DiagnosticCode;
 /** 分析诊断信息，{@link diagnostic_position_encoding} 不能设为 `None` */
 export function parseDiagnostics(
     source: ScriptInput,
@@ -122,17 +140,17 @@ export function parseDiagnostics(
     for (let i = 0; i < parsed.length; i++) {
         const diagnostic = parsed[i]!;
         const { code } = diagnostic;
-        if (code > DiagnosticCode.ErrorStart && code < DiagnosticCode.ErrorEnd) {
+        if (code > ErrorStart && code < ErrorEnd) {
             _errors.push(diagnostic);
-        } else if (code > DiagnosticCode.WarningStart && code < DiagnosticCode.WarningEnd) {
+        } else if (code > WarningStart && code < WarningEnd) {
             _warnings.push(diagnostic);
-        } else if (code > DiagnosticCode.InfoStart && code < DiagnosticCode.InfoEnd) {
+        } else if (code > InfoStart && code < InfoEnd) {
             _infos.push(diagnostic);
-        } else if (code > DiagnosticCode.HintStart && code < DiagnosticCode.HintEnd) {
+        } else if (code > HintStart && code < HintEnd) {
             _hints.push(diagnostic);
-        } else if (code > DiagnosticCode.TagStart && code < DiagnosticCode.TagEnd) {
+        } else if (code > TagStart && code < TagEnd) {
             _tags.push(diagnostic);
-        } else if (code === DiagnosticCode.SourceMap) {
+        } else if (code === SourceMap) {
             _sourcemaps.push(diagnostic.range);
             continue;
         } else {
@@ -143,11 +161,11 @@ export function parseDiagnostics(
         while (i + 1 < parsed.length) {
             const ref = parsed[i + 1]!;
             let isRef = false;
-            if (ref.code > DiagnosticCode.TagRefStart && ref.code < DiagnosticCode.TagRefEnd) {
+            if (ref.code > TagRefStart && ref.code < TagRefEnd) {
                 isRef = true;
                 _tagsReferences.push(ref);
             }
-            if (ref.code > DiagnosticCode.ReferenceStart && ref.code < DiagnosticCode.ReferenceEnd) {
+            if (ref.code > ReferenceStart && ref.code < ReferenceEnd) {
                 isRef = true;
                 _references.push(ref);
             }

package/src/vm/checkpoint.ts

@@ -1,13 +1,22 @@
+import { isNaN } from '../helpers/utils.js';
+// 不使用 performance.now()，精度够即可，且性能开销更小
+const { now } = Date;
+const TIME_ORIGIN = now() - 1000 * 3600 * 24; // 减去一天，防止系统时间被调整到过去时出问题
+const timestamp = () => now() - TIME_ORIGIN;
+
 const MAX_DEPTH = 128;
+const CP_UNSET = -1;
+/** Default timeout in milliseconds */
+const CP_DEFAULT_TIMEOUT = 100;
 
 let cpDepth = 0;
-let cp = Number.NaN;
-let cpTimeout = 100; // Default timeout in milliseconds
+let cp = CP_UNSET;
+let cpTimeout = CP_DEFAULT_TIMEOUT;
 /** 检查点 */
 export function Cp(): void {
-    if (!cp) {
-        cp = Date.now();
-    } else if (Date.now() - cp > cpTimeout) {
+    if (cp === CP_UNSET) {
+        cp = timestamp();
+    } else if (timestamp() - cp > cpTimeout) {
         throw new RangeError('Execution timeout');
     }
 }
@@ -15,7 +24,7 @@ export function Cp(): void {
 export function CpEnter(): void {
     cpDepth++;
     if (cpDepth <= 1) {
-        cp = Date.now();
+        cp = timestamp();
         cpDepth = 1;
     } else if (cpDepth > MAX_DEPTH) {
         throw new RangeError('Maximum call depth exceeded');
@@ -27,16 +36,16 @@ export function CpEnter(): void {
 export function CpExit(): void {
     cpDepth--;
     if (cpDepth < 1) {
-        cp = Number.NaN;
+        cp = CP_UNSET;
         cpDepth = 0;
     } else {
         Cp();
     }
 }
 /** 设置检查点超时时间 */
-export function configCheckpoint(timeout = 100): void {
-    if (typeof timeout !== 'number' || timeout <= 0 || Number.isNaN(timeout)) {
+export function configCheckpoint(timeout = CP_DEFAULT_TIMEOUT): void {
+    if (typeof timeout !== 'number' || timeout <= 0 || isNaN(timeout)) {
         throw new RangeError('Invalid timeout value');
     }
-    cpTimeout = timeout;
+    cpTimeout = Math.ceil(timeout);
 }

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

@@ -1,13 +1,87 @@
 import supportsColor from 'supports-color';
 import { VmError } from '../../../helpers/error.js';
-import { toString } from '../../../helpers/convert/to-string.js';
+import { toString } from '../../../helpers/convert/index.js';
 import type { VmAny } from '../../types/index.js';
 import { VmLib } from '../helpers.js';
 
+/** 序列化格式 */
+type SerializeFormat =
+    /** 表示未指定格式 */
+    | ''
+    /** 以 `%` 开头的格式占位符 */
+    | `%${string}`;
+/**
+ * 默认的序列化函数
+ * @param arg 要序列化的值
+ * @param format 序列化格式
+ * @returns 序列化后的字符串，或 null 表示直接将原值传递给控制台
+ */
+function defaultSerializer(arg: VmAny, format: SerializeFormat): string | null {
+    return null;
+}
+
+/** 序列化值 */
+function serializeValue(arg: VmAny, format: SerializeFormat, serializer: typeof defaultSerializer): string | null {
+    if (serializer == null || serializer === defaultSerializer) {
+        return defaultSerializer(arg, format);
+    }
+    try {
+        return serializer(arg, format);
+    } catch {
+        return defaultSerializer(arg, format);
+    }
+}
+
 export const debug_print = VmLib(
     (...args) => {
+        const { serializer } = debug_print;
+        if (args.length <= 1 || typeof args[0] != 'string' || !args[0].includes('%')) {
+            // eslint-disable-next-line no-console
+            console.log(...debug_print.prefix, ...args.map((v) => serializeValue(v, '', serializer) ?? v));
+            return;
+        }
+        const [prefix, ...additional] = debug_print.prefix;
+        const [arg0, ...argsRest] = args;
+        const format = `${prefix || ''} ${arg0}`;
+        const values = [...additional, ...argsRest];
+        const parts = format.split(/(%[%\w])/g);
+        const messageToConsole: string[] = [];
+        const valuesToConsole: unknown[] = [];
+        let valIndex = 0;
+        for (let i = 0; i < parts.length; i++) {
+            if (i % 2 === 0) {
+                // Regular string part
+                messageToConsole.push(parts[i]!);
+                continue;
+            }
+            // Specifier part
+            const specifier = parts[i]!;
+            if (specifier === '%%') {
+                messageToConsole.push('%');
+            } else {
+                if (valIndex >= values.length) {
+                    messageToConsole.push(specifier);
+                    continue;
+                }
+                const arg = values[valIndex++]!;
+                const f = serializeValue(arg, specifier as SerializeFormat, serializer);
+                if (f != null) {
+                    messageToConsole.push('%s');
+                    valuesToConsole.push(f);
+                } else {
+                    messageToConsole.push(specifier);
+                    valuesToConsole.push(arg);
+                }
+            }
+        }
+
+        // Append any remaining arguments separated by spaces
+        if (valIndex < values.length) {
+            const remaining = values.slice(valIndex);
+            valuesToConsole.push(...remaining.map((v) => serializeValue(v, '', serializer) ?? v));
+        }
         // eslint-disable-next-line no-console
-        console.log(...debug_print.prefix, ...args);
+        console.log(messageToConsole.join(''), ...valuesToConsole);
     },
     {
         summary: '打印调试信息到控制台',
@@ -17,7 +91,8 @@ export const debug_print = VmLib(
         examples: ['debug_print("value:", 42);'],
     },
     {
-        prefix: ['MiraScript'] as readonly string[],
+        prefix: ['MiraScript'] as readonly [prefix: string, ...additional: readonly string[]],
+        serializer: defaultSerializer,
     },
 );
 
@@ -26,7 +101,7 @@ export const panic = VmLib(
         // eslint-disable-next-line no-console
         if (message === undefined) console.error(...panic.prefix);
         // eslint-disable-next-line no-console
-        else console.error(...panic.prefix, message);
+        else console.error(...panic.prefix, serializeValue(message, '', panic.serializer));
         const mgsStr = toString(message, null);
         const error = !mgsStr ? 'panic' : 'panic: ' + mgsStr;
         throw new VmError(error, undefined);
@@ -40,14 +115,16 @@ export const panic = VmLib(
     },
     {
         prefix: ['MiraScript'] as readonly string[],
+        serializer: defaultSerializer,
     },
 );
 
 if (typeof location != 'undefined') {
-    const badge = '%cMiraScript';
+    const badge = '%cMiraScript%c';
     const common = 'display: inline-block; padding: 1px 4px; border-radius: 3px;';
-    debug_print.prefix = [badge, `${common} background: #007acc; color: #fff;`];
-    panic.prefix = [badge, `${common} background: #d23d3d; color: #fff;`];
+    const reset = '';
+    debug_print.prefix = [badge, `${common} background: #007acc; color: #fff;`, reset];
+    panic.prefix = [badge, `${common} background: #d23d3d; color: #fff;`, reset];
 } else {
     if (supportsColor.stdout) {
         debug_print.prefix = ['\u001B[44;37m MiraScript \u001B[0m'];

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

@@ -1,5 +1,5 @@
 import { isVmExtern, isVmModule } from '../../types/index.js';
-import { required, rethrowError, VmLib } from '../helpers.js';
+import { expectString, required, rethrowError, VmLib } from '../helpers.js';
 const { parse, stringify } = JSON;
 
 export const to_json = VmLib(
@@ -26,10 +26,9 @@ export const to_json = VmLib(
 
 export const from_json = VmLib(
     (json, fallback) => {
-        required('json', json, null);
-        if (typeof json != 'string') return json;
+        const j = expectString('json', json);
         try {
-            return parse(json);
+            return parse(j);
         } catch (ex) {
             if (fallback !== undefined) return fallback;
             rethrowError('Invalid JSON', ex, null);

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

@@ -1,2 +1,34 @@
-const { PI, E } = Math;
-export { PI as '@pi', E as '@e' };
+import { VmLib } from '../helpers.js';
+
+export const PI = VmLib(Math.PI, {
+    summary: '圆周率',
+    returnsType: 'number',
+});
+export const E = VmLib(Math.E, {
+    summary: '自然对数的底数',
+    returnsType: 'number',
+});
+export const SQRT1_2 = VmLib(Math.SQRT1_2, {
+    summary: '1 的平方根除以 2',
+    returnsType: 'number',
+});
+export const SQRT2 = VmLib(Math.SQRT2, {
+    summary: '2 的平方根',
+    returnsType: 'number',
+});
+export const LN2 = VmLib(Math.LN2, {
+    summary: '2 的自然对数',
+    returnsType: 'number',
+});
+export const LN10 = VmLib(Math.LN10, {
+    summary: '10 的自然对数',
+    returnsType: 'number',
+});
+export const LOG2E = VmLib(Math.LOG2E, {
+    summary: 'e 以 2 为底的对数',
+    returnsType: 'number',
+});
+export const LOG10E = VmLib(Math.LOG10E, {
+    summary: 'e 以 10 为底的对数',
+    returnsType: 'number',
+});

package/src/vm/lib/helpers.ts

@@ -243,6 +243,7 @@ export function arrayLen(len: number | null | undefined): number {
 /** 应用映射函数 */
 export function map(
     data: VmConst,
+    /** 返回 `undefined` 表示跳过该元素 */
     mapper: (value: VmConst, index: number | string | null, data: VmConst) => VmConst | undefined,
 ): VmConst {
     if (isVmPrimitive(data)) {
@@ -276,19 +277,17 @@ export type VmLibOption = Pick<
     'summary' | 'params' | 'paramsType' | 'returns' | 'returnsType' | 'examples'
 >;
 /** 库函数 */
-export type VmLib<T extends VmFunctionLike = VmFunctionLike> = T & VmLibOption;
+export type VmLib<T extends VmFunctionLike | VmConst = VmFunctionLike> = (T extends VmFunctionLike ? T : { value: T }) &
+    VmLibOption;
 
 /** 创建库函数 */
-export function VmLib<const T extends VmFunctionLike, P extends Record<string, unknown> = Record<never, never>>(
-    fn: T,
-    option: VmLibOption,
-    properties?: P,
-): VmLib<T> & P {
-    /* c8 ignore next 2 */
-    if (typeof fn != 'function') throw new TypeError('Invalid function');
-    if (isVmFunction(fn)) throw new TypeError('Cannot create VmLib from a VmFunction');
+export function VmLib<
+    const T extends VmFunctionLike | VmConst,
+    P extends Record<string, unknown> = Record<never, never>,
+>(value: T, option: VmLibOption, properties?: P): VmLib<T> & P {
+    if (isVmFunction(value)) throw new TypeError('Cannot create VmLib from a VmFunction');
 
-    const ret = fn as Writable<VmLib<T>> & P;
+    const ret = (typeof value == 'function' ? value : { value: value }) as unknown as Writable<VmLib<T>> & P;
     Object.assign(ret, properties);
     ret.params = option.params;
     ret.paramsType = option.paramsType;

package/src/vm/lib/index.ts

@@ -1,16 +1,20 @@
 import * as global from './global/index.js';
 import * as mods from './mod/index.js';
-import { VM_SHARED_CONTEXT } from '../types/context.js';
+import { VM_SHARED_CONTEXT, VM_SHARED_CONTEXT_DESCRIPTIONS } from '../types/context.js';
 import { create, entries } from '../../helpers/utils.js';
 import { createModule, wrapEntry, type RawValue } from './loader.js';
 
 for (const [name, value] of entries(global)) {
-    VM_SHARED_CONTEXT[name] = wrapEntry(name, value as RawValue, 'global');
+    const [wrappedValue, description] = wrapEntry(name, value as RawValue, 'global');
+    VM_SHARED_CONTEXT[name] = wrappedValue;
+    VM_SHARED_CONTEXT_DESCRIPTIONS[name] = description;
 }
 
 for (const [name, value] of entries(mods)) {
     const mod = createModule(name, value as Record<string, RawValue>);
-    VM_SHARED_CONTEXT[name] = wrapEntry(name, mod, 'global');
+    const [wrappedValue, description] = wrapEntry(name, mod, 'global');
+    VM_SHARED_CONTEXT[name] = wrappedValue;
+    VM_SHARED_CONTEXT_DESCRIPTIONS[name] = description;
 }
 
 export const lib: Readonly<typeof global & typeof mods> = Object.freeze(Object.assign(create(null), global, mods));

package/src/vm/lib/loader.ts

@@ -1,43 +1,80 @@
-import { VmFunction, VmModule, type VmConst, type VmFunctionLike, type VmImmutable } from '../types/index.js';
+import {
+    isVmModule,
+    VmFunction,
+    VmModule,
+    type VmConst,
+    type VmFunctionLike,
+    type VmImmutable,
+} from '../types/index.js';
 import { create, defineProperty, entries } from '../../helpers/utils.js';
 
 import type { VmLib, VmLibOption } from './helpers.js';
 
+/** 内置模块 */
+class VmBuiltinModule<const T extends Record<string, VmImmutable> = Record<string, VmImmutable>> extends VmModule<T> {
+    constructor(
+        name: string,
+        value: T,
+        readonly descriptions: Record<keyof T, string | undefined>,
+    ) {
+        super(name, value);
+    }
+    /** @inheritdoc */
+    override describe(key: string): string | undefined {
+        return this.descriptions[key as keyof T];
+    }
+}
+
 /** 原始值 */
-export type RawValue = VmLib | VmConst | VmModule;
+export type RawValue = VmLib<VmFunctionLike | VmConst> | VmBuiltinModule;
 /** 包装值 */
-type ToWrappedValue<V extends RawValue> = V extends VmFunctionLike ? VmFunction<V> : V;
+type ToWrappedValue<V extends RawValue> = V extends VmLib<infer C> ? (C extends VmFunctionLike ? VmFunction<C> : C) : V;
 /** 包装值 */
-export function wrapEntry<const T extends RawValue>(name: string, value: T, module: string): ToWrappedValue<T> {
-    if (typeof value == 'function') {
-        if (value.name !== name) {
-            // 如果函数名和导出名不一致，则重命名
-            defineProperty(value, 'name', {
-                value: name,
-                configurable: true,
-            });
+export function wrapEntry<const T extends RawValue>(
+    name: string,
+    value: T,
+    module: string,
+): [value: ToWrappedValue<T>, description: string | undefined] {
+    if (isVmModule(value)) {
+        return [value as ToWrappedValue<T>, undefined];
+    }
+    if (typeof value != 'function') {
+        if (value == null || typeof value != 'object' || !('value' in value)) {
+            throw new TypeError(`Cannot wrap non-function, non-const value: ${name} in module ${module}`);
         }
-        return VmFunction(value, {
+        return [value.value as ToWrappedValue<T>, value.summary || undefined];
+    }
+    if (value.name !== name) {
+        // 如果函数名和导出名不一致，则重命名
+        defineProperty(value, 'name', {
+            value: name,
+            configurable: true,
+        });
+    }
+    return [
+        VmFunction(value, {
             isLib: true,
             injectCp: true,
             fullName: `${module}.${name}`,
             ...(value as VmLibOption),
-        }) as ToWrappedValue<T>;
-    } else {
-        return value as ToWrappedValue<T>;
-    }
+        }) as ToWrappedValue<T>,
+        value.summary || undefined,
+    ];
 }
 
 /** 创建模块 */
-export type ToWrappedModule<T extends Record<string, RawValue>> = VmModule<{
+export type ToWrappedModule<T extends Record<string, RawValue>> = VmBuiltinModule<{
     [key in keyof T]: ToWrappedValue<T[key]>;
 }>;
 
 /** 创建模块 */
 export function createModule<const T extends Record<string, RawValue>>(name: string, lib: T): ToWrappedModule<T> {
     const mod = create(null) as Record<string, VmImmutable>;
+    const descriptions = create(null) as Record<string, string | undefined>;
     for (const [key, value] of entries(lib)) {
-        mod[key] = wrapEntry(key, value, name);
+        const [wrappedValue, description] = wrapEntry(key, value, name);
+        mod[key] = wrappedValue;
+        descriptions[key] = description;
     }
-    return new VmModule(name, mod) as ToWrappedModule<T>;
+    return new VmBuiltinModule(name, mod, descriptions) as ToWrappedModule<T>;
 }

package/src/vm/types/context.ts

@@ -1,4 +1,4 @@
-import { create, entries, keys } from '../../helpers/utils.js';
+import { create, entries, hasOwn, keys } from '../../helpers/utils.js';
 import { isVmAny } from '../../helpers/types.js';
 import { VmError } from '../../helpers/error.js';
 import { kVmContext } from '../../helpers/constants.js';
@@ -14,7 +14,7 @@ export interface VmContext {
     /** 枚举所有 key，仅在 LSP 中使用 */
     keys(): readonly string[];
     /** 描述值，返回 MarkDown 文本，仅在 LSP 中使用 */
-    describe?(key: string): string | undefined;
+    describe(key: string): string | undefined;
     /**
      * 获取指定 key 的值 `global[key]`
      * @throws {VmError} 如果值不存在则抛出异常
@@ -28,6 +28,7 @@ export type VmContextRecord = Record<string, VmValue>;
 /** MiraScript 执行上下文 */
 export type VmContextRecordLoose = Record<string, VmValue | undefined>;
 export const VM_SHARED_CONTEXT: Record<string, VmImmutable> = create(null);
+export const VM_SHARED_CONTEXT_DESCRIPTIONS: Record<string, string | undefined> = create(null);
 /** 缓存 {@link VM_SHARED_CONTEXT} 的 keys */
 let VM_SHARED_CONTEXT_KEYS: readonly string[] | null = null;
 
@@ -41,6 +42,7 @@ export function defineVmContextValue(
     name: string,
     value: VmImmutable | ((...args: VmAny[]) => VmAny),
     override = false,
+    description: string | null | undefined = undefined,
 ): void {
     if (!override && name in VM_SHARED_CONTEXT) throw new Error(`Global variable '${name}' is already defined.`);
     let v: VmImmutable;
@@ -53,6 +55,7 @@ export function defineVmContextValue(
         v = value;
     }
     VM_SHARED_CONTEXT[name] = v ?? null;
+    if (description) VM_SHARED_CONTEXT_DESCRIPTIONS[name] = description;
     VM_SHARED_CONTEXT_KEYS = null;
 }
 
@@ -74,6 +77,10 @@ export const DefaultVmContext: VmContext = freeze({
     has(key: string): boolean {
         return key in VM_SHARED_CONTEXT;
     },
+    /** @inheritdoc */
+    describe(key: string): string | undefined {
+        return VM_SHARED_CONTEXT_DESCRIPTIONS[key];
+    },
 });
 
 /** 以值为后备的实现 */
@@ -99,10 +106,14 @@ class ValueVmContext implements VmContext {
     has(key: string): boolean {
         return key in this.env;
     }
+    /** @inheritdoc */
+    describe(key: string): string | undefined {
+        if (this.describer != null && hasOwn(this.env, key)) return this.describer(key);
+        return VM_SHARED_CONTEXT_DESCRIPTIONS[key];
+    }
     constructor(
         private readonly env: VmContextRecord,
-        /** @inheritdoc */
-        readonly describe?: (key: string) => string | undefined,
+        private readonly describer?: (key: string) => string | undefined,
     ) {}
 }
 
@@ -124,11 +135,15 @@ class FactoryVmContext implements VmContext {
     has(key: string): boolean {
         return this.getter(key) !== undefined || DefaultVmContext.has(key);
     }
+    /** @inheritdoc */
+    describe(key: string): string | undefined {
+        if (this.describer != null && this.getter(key) !== undefined) return this.describer(key);
+        return VM_SHARED_CONTEXT_DESCRIPTIONS[key];
+    }
     constructor(
         private readonly getter: (key: string) => VmValue | undefined,
         private readonly enumerator?: () => Iterable<string>,
-        /** @inheritdoc */
-        readonly describe?: (key: string) => string | undefined,
+        private readonly describer?: (key: string) => string | undefined,
     ) {}
 }
 

package/src/vm/types/extern.ts

@@ -115,7 +115,7 @@ export class VmExtern<const T extends object = object> extends VmWrapper<T> {
         return 'extern';
     }
     /** @inheritdoc */
-    override get describe(): string {
+    override get tag(): string {
         const tag = ObjectToString.call(this.value).slice(8, -1);
         if (isArray(this.value)) {
             return `${tag}(${this.value.length})`;

package/src/vm/types/module.ts

@@ -35,7 +35,7 @@ export class VmModule<const T extends Record<string, VmImmutable> = Record<strin
         return 'module';
     }
     /** @inheritdoc */
-    override get describe(): string {
+    override get tag(): string {
         return this.name;
     }
 }

package/src/vm/types/wrapper.ts

@@ -16,15 +16,19 @@ export abstract class VmWrapper<T extends object> {
     abstract same(other: VmAny): boolean;
     /** 获取类型 */
     abstract get type(): TypeName;
-    /** 获取描述 */
-    abstract get describe(): string;
+    /** 获取当前对象的描述 */
+    abstract get tag(): string;
+    /** 描述键对应的值 */
+    describe(key: string): string | undefined {
+        return undefined;
+    }
     /** Convert the object to JSON */
     toJSON(): undefined {
         return undefined;
     }
     /** 转为字符串 */
     toString(useBraces: boolean): string {
-        const { type, describe } = this;
+        const { type, tag: describe } = this;
         if (!describe) return `<${type}>`;
         return `<${type} ${describe}>`;
     }