@mirascript/mirascript 0.1.33 → 0.1.35

package/src/helpers/serialize.ts

@@ -10,7 +10,6 @@ import {
     isVmModule,
     isVmRecord,
 } from './types.js';
-import type { VmWrapper } from '../vm/types/wrapper.js';
 
 /** 序列化设置 */
 export interface SerializeOptions {
@@ -302,7 +301,7 @@ export function serialize(value: VmAny, options?: Partial<SerializeOptions>): st
     return serializeImpl(value, 0, getSerializeOptions(options));
 }
 
-/** 将 MiraScript function 转化为 MiraScript 字符串 */
+/** 将 MiraScript 函数转化为 MiraScript 字符串 */
 export function displayFunction(value: VmFunction): string {
     try {
         const name = getVmFunctionInfo(value)?.fullName;
@@ -312,12 +311,27 @@ export function displayFunction(value: VmFunction): string {
         return `<function>`;
     }
 }
-/** 将 MiraScript module 转化为 MiraScript 字符串 */
-export function displayWrapper(value: VmWrapper<object>, useBraces: boolean, fallback: string): string {
+/** 将 MiraScript 模块转化为 MiraScript 字符串 */
+export function displayModule(value: VmModule): string {
     try {
-        return value.toString(useBraces);
+        return value.toString(true);
+        /* c8 ignore next 3 */
+    } catch {
+        return `<module>`;
+    }
+}
+/** 将 MiraScript 外部值转化为 MiraScript 字符串 */
+export function displayExtern(value: VmExtern): string {
+    try {
+        const tag = `<extern ${value.tag}>`;
+        const rep = value.toString(true);
+        if (rep === tag || rep.length > 50) {
+            return tag;
+        }
+        return `${tag} ${rep}`;
+        /* c8 ignore next 3 */
     } catch {
-        return fallback;
+        return `<extern>`;
     }
 }
 const DISPLAY_OPTIONS = Object.freeze({
@@ -333,8 +347,8 @@ const DISPLAY_OPTIONS = Object.freeze({
     serializeRecord,
     serializePropName: String,
     serializeFunction: displayFunction,
-    serializeModule: (value) => displayWrapper(value, true, '<module>'),
-    serializeExtern: (value) => displayWrapper(value, true, '<extern>'),
+    serializeModule: displayModule,
+    serializeExtern: displayExtern,
 } satisfies SerializeOptions);
 /**
  * 将 MiraScript 值转化为 MiraScript 字符串。

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

@@ -114,7 +114,7 @@ export const panic = VmLib(
         examples: ['panic("boom");'],
     },
     {
-        prefix: ['MiraScript'] as readonly string[],
+        prefix: ['MiraScript'] as readonly [prefix: string, ...additional: readonly string[]],
         serializer: defaultSerializer,
     },
 );

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

@@ -1,3 +1,4 @@
+import { DiagnosticCode } from '@mirascript/constants';
 import { VmLib } from '../helpers.js';
 
 export const PI = VmLib(Math.PI, {
@@ -8,6 +9,22 @@ export const E = VmLib(Math.E, {
     summary: '自然对数的底数',
     returnsType: 'number',
 });
+export const pi = VmLib(Math.PI, {
+    summary: '圆周率',
+    returnsType: 'number',
+    deprecated: {
+        use: 'PI',
+        message: DiagnosticCode.PreferUppercaseConstant,
+    },
+});
+export const e = VmLib(Math.E, {
+    summary: '自然对数的底数',
+    returnsType: 'number',
+    deprecated: {
+        use: 'E',
+        message: DiagnosticCode.PreferUppercaseConstant,
+    },
+});
 export const SQRT1_2 = VmLib(Math.SQRT1_2, {
     summary: '1 的平方根除以 2',
     returnsType: 'number',

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

@@ -69,21 +69,22 @@ export const to_datetime = VmLib(
         };
     },
     {
-        summary: '将数据转换为 Date 记录',
+        summary: '将数据转换为 DateTime 记录',
         params: {
             datetime: '要转换的数据，默认为当前时间',
             offset: '时区偏移量（单位：小时），默认为 0',
             fallback: '转换失败时的返回值',
         },
         paramsType: { datetime: 'number | string', offset: 'number', fallback: 'any' },
-        returnsType: 'Date | type(fallback)',
+        returnsType: 'DateTime | type(fallback)',
         examples: [
             `
 to_datetime(0)
 // (
-//    year: 1970, month: 1, day: 1,
-//    hour: 0, minute: 0, second: 0,
-//    millisecond: 0, dayOfWeek: 4, offset: 0
+//   year: 1970, month: 1, day: 1,
+//   hour: 0, minute: 0, second: 0,
+//   millisecond: 0,
+//   dayOfWeek: 4, offset: 0
 // )
             `.trim(),
         ],

package/src/vm/lib/helpers.ts

@@ -274,7 +274,7 @@ export function map(
 /** 库函数选项 */
 export type VmLibOption = Pick<
     VmFunctionOption,
-    'summary' | 'params' | 'paramsType' | 'returns' | 'returnsType' | 'examples' | 'injectCp'
+    'summary' | 'params' | 'paramsType' | 'returns' | 'returnsType' | 'examples' | 'injectCp' | 'deprecated'
 >;
 /** 库函数 */
 export type VmLib<T extends VmFunctionLike | VmConst = VmFunctionLike> = (T extends VmFunctionLike ? T : { value: T }) &
@@ -296,5 +296,6 @@ export function VmLib<
     ret.summary = option.summary;
     ret.examples = option.examples;
     ret.injectCp = option.injectCp ?? false;
+    ret.deprecated = option.deprecated ?? undefined;
     return ret as VmLib<T> & P;
 }

package/src/vm/operations/call.ts

@@ -1,24 +1,47 @@
 import { VmError } from '../../helpers/error.js';
 import { display } from '../../helpers/serialize.js';
 import { isVmFunction, isVmExtern, isVmConst } from '../../helpers/types.js';
-import type { VmAny, VmArray, VmValue } from '../types/index.js';
+import type { VmExtern, VmFunction, VmAny, VmArray, VmValue } from '../types/index.js';
 import { $AssertInit } from './common.js';
 
-export const $Call = (func: VmValue, args: readonly VmAny[]): VmValue => {
+/** 调用返回类型 */
+type CallReturn<T extends VmValue> =
+    T extends VmFunction<infer F>
+        ? F extends (...args: readonly VmAny[]) => infer R
+            ? // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
+              R extends void | undefined
+                ? null
+                : R
+            : VmValue
+        : T extends VmExtern<infer E>
+          ? E extends (...args: readonly VmAny[]) => infer R
+              ? // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
+                R extends void | undefined
+                  ? null
+                  : R extends VmValue
+                    ? R
+                    : R extends object
+                      ? VmExtern<R>
+                      : VmValue
+              : VmValue
+          : VmValue;
+
+/** 调用函数 */
+export function $Call<T extends VmValue, A extends readonly VmValue[]>(func: T, args: A): CallReturn<T> {
     for (const a of args) {
         $AssertInit(a);
     }
     if (isVmExtern(func)) {
-        return func.call(args as readonly VmValue[]) ?? null;
+        return (func.call(args as readonly VmValue[]) ?? null) as CallReturn<T>;
     }
     if (isVmFunction(func)) {
-        return func(...(args as readonly VmValue[])) ?? null;
+        return (func(...(args as readonly VmValue[])) ?? null) as CallReturn<T>;
     }
     throw new VmError(`Value is not callable: ${display(func)}`, null);
-};
+}
 
 /** 过滤剩余参数数组 */
-export const $VArgs = (varags: VmAny[]): VmArray => {
+export function $VArgs(varags: VmAny[]): VmArray {
     for (let i = 0, l = varags.length; i < l; i++) {
         const el = varags[i];
         if (!isVmConst(el)) {
@@ -26,4 +49,4 @@ export const $VArgs = (varags: VmAny[]): VmArray => {
         }
     }
     return varags as VmArray;
-};
+}

package/src/vm/operations/common.ts

@@ -1,6 +1,7 @@
 import { VmError } from '../../helpers/error.js';
 import type { VmAny, VmValue } from '../types/index.js';
 
-export const $AssertInit: (value: VmAny) => asserts value is VmValue = (value) => {
+/** 断言值已初始化 */
+export function $AssertInit(value: VmAny): asserts value is VmValue {
     if (value === undefined) throw new VmError(`Uninitialized value`, null);
-};
+}

package/src/vm/operations/compound.ts

@@ -1,8 +1,9 @@
 import { VmError } from '../../helpers/error.js';
-import { hasOwnEnumerable, isNaN, NotNumber, keys, create } from '../../helpers/utils.js';
+import { hasOwnEnumerable, isNaN, NotNumber, keys, create, isFinite } from '../../helpers/utils.js';
 import { toNumber, toString } from '../../helpers/convert/index.js';
 import { display } from '../../helpers/serialize.js';
 import { isVmPrimitive, isVmArray, isVmRecord, isVmFunction, isVmExtern, isVmWrapper } from '../../helpers/types.js';
+import { wrapToVmConst } from '../types/boundary.js';
 import type { VmAny, VmRecord, VmValue, VmConst } from '../types/index.js';
 import { isSame } from './utils.js';
 import { $AssertInit } from './common.js';
@@ -11,7 +12,8 @@ import { $ToString } from './convert.js';
 const { trunc } = Math;
 const { at } = Array.prototype;
 
-export const $In = (value: VmAny, iterable: VmAny): boolean => {
+/** 检查值是否在可迭代对象中 */
+export function $In(value: VmAny, iterable: VmAny): boolean {
     $AssertInit(value);
     $AssertInit(iterable);
     if (iterable == null) return false;
@@ -31,16 +33,20 @@ export const $In = (value: VmAny, iterable: VmAny): boolean => {
     const key = toString(value, undefined);
     if (isVmWrapper(iterable)) return iterable.has(key);
     return hasOwnEnumerable(iterable satisfies VmRecord, key);
-};
-export const $Length = (value: VmAny): number => {
+}
+
+/** 获取值的长度 */
+export function $Length(value: VmAny): number {
     $AssertInit(value);
     if (isVmArray(value)) return value.length;
     if (isVmRecord(value)) return keys(value).length;
     if (isVmWrapper(value)) return value.keys().length;
 
     throw new VmError(`Value has no length: ${display(value)}`, 0);
-};
-export const $Omit = (value: VmAny, omitted: ReadonlyArray<number | string>): VmRecord => {
+}
+
+/** 删除记录中的指定字段 */
+export function $Omit(value: VmAny, omitted: ReadonlyArray<number | string>): VmRecord {
     $AssertInit(value);
     if (value == null || !isVmRecord(value)) return {};
     const result: Record<string, VmConst> = {};
@@ -53,8 +59,10 @@ export const $Omit = (value: VmAny, omitted: ReadonlyArray<number | string>): Vm
         }
     }
     return result;
-};
-export const $Pick = (value: VmAny, picked: ReadonlyArray<number | string>): VmRecord => {
+}
+
+/** 选择记录中的指定字段 */
+export function $Pick(value: VmAny, picked: ReadonlyArray<number | string>): VmRecord {
     $AssertInit(value);
     if (value == null || !isVmRecord(value)) return {};
     const result: Record<string, VmConst> = {};
@@ -65,15 +73,17 @@ export const $Pick = (value: VmAny, picked: ReadonlyArray<number | string>): VmR
         }
     }
     return result;
-};
-export const $Has = (obj: VmAny, key: VmAny): boolean => {
+}
+/** 检查是否拥有字段 */
+export function $Has(obj: VmAny, key: VmAny): boolean {
     $AssertInit(obj);
     const pk = $ToString(key);
     if (obj == null || typeof obj != 'object') return false;
     if (isVmWrapper(obj)) return obj.has(pk);
     return hasOwnEnumerable(obj, pk);
-};
-export const $Get = (obj: VmAny, key: VmAny): VmValue => {
+}
+/** 获取字段 */
+export function $Get(obj: VmAny, key: VmAny): VmValue {
     $AssertInit(obj);
     if (isVmArray(obj)) {
         $AssertInit(key);
@@ -83,27 +93,39 @@ export const $Get = (obj: VmAny, key: VmAny): VmValue => {
     }
     const pk = $ToString(key);
     if (obj == null || typeof obj != 'object') return null;
-    if (isVmWrapper(obj)) return obj.get(pk) ?? null;
+    if (isVmWrapper(obj)) {
+        if (isFinite(key) && isVmExtern(obj) && obj.isArrayLike()) {
+            let index = trunc(key as number);
+            const { length } = obj.value;
+            if (index < 0) index += length;
+            if (index >= 0 && index < length) {
+                return obj.get(String(index)) ?? null;
+            }
+        }
+        return obj.get(pk) ?? null;
+    }
     if (!hasOwnEnumerable(obj, pk)) return null;
     return obj[pk] ?? null;
-};
-export const $Set = (obj: VmAny, key: VmAny, value: VmAny): void => {
+}
+/** 设置字段 */
+export function $Set(obj: VmAny, key: VmAny, value: VmAny): void {
     $AssertInit(obj);
     $AssertInit(value);
     const pk = $ToString(key);
     if (obj == null) return;
     if (!isVmExtern(obj)) throw new VmError(`Expected extern, got ${display(obj)}`, undefined);
     obj.set(pk, value);
-};
-export const $Iterable = (value: VmAny): Iterable<VmValue | undefined> => {
+}
+/** 获取可迭代对象 */
+export function $Iterable(value: VmAny): Iterable<VmValue | undefined> {
     $AssertInit(value);
     if (isVmWrapper(value)) return value.keys();
     if (isVmArray(value)) return value;
     if (value != null && typeof value == 'object') return keys(value);
     throw new VmError(`Value is not iterable: ${display(value)}`, isVmFunction(value) ? [] : [value]);
-};
-
-export const $RecordSpread = (record: VmAny): VmRecord | null => {
+}
+/** 展开记录 */
+export function $RecordSpread(record: VmAny): VmRecord | null {
     $AssertInit(record);
     if (record == null || isVmRecord(record)) return record;
     if (isVmArray(record)) {
@@ -127,23 +149,28 @@ export const $RecordSpread = (record: VmAny): VmRecord | null => {
         return result;
     }
     throw new VmError(`Expected record, array, extern or nil, got ${display(record)}`, null);
-};
+}
 
-export const $ArraySpread = (array: VmAny): Iterable<VmConst | undefined> => {
+/** 展开数组 */
+export function $ArraySpread(array: VmAny): Iterable<VmConst | undefined> {
     $AssertInit(array);
     if (array == null) return [];
     if (isVmArray(array)) return array;
-    if (isVmExtern(array) && typeof (array.value as Iterable<unknown>)[Symbol.iterator] == 'function') {
-        const result: VmConst[] = [];
-        for (const item of array.value as Iterable<unknown>) {
-            // 当前只有 Primitive 不会进行二次包装
-            if (isVmPrimitive(item)) {
-                result.push(item);
-            } else {
-                result.push(null);
+    if (isVmExtern(array)) {
+        if (array.isArrayLike()) {
+            const result: VmConst[] = [];
+            for (let i = 0, len = array.value.length; i < len; i++) {
+                const item = array.value[i];
+                result.push(wrapToVmConst(item, (v) => array.assumeVmValue(v, i)));
             }
+            return result;
+        } else if (typeof (array.value as Iterable<unknown>)[Symbol.iterator] == 'function') {
+            const result: VmConst[] = [];
+            for (const item of array.value as Iterable<unknown>) {
+                result.push(wrapToVmConst(item, (v) => array.assumeVmValue(v, Symbol.iterator as never)));
+            }
+            return result;
         }
-        return result;
     }
     throw new VmError(`Expected array, iterable extern or nil, got ${display(array)}`, []);
-};
+}

package/src/vm/operations/convert.ts

@@ -2,22 +2,26 @@ import { toNumber, toString, toBoolean, toFormat } from '../../helpers/convert/i
 import type { VmAny } from '../types/index.js';
 import { $AssertInit } from './common.js';
 
-export const $ToBoolean = (value: VmAny): boolean => {
+/** 转换为布尔值 */
+export function $ToBoolean(value: VmAny): boolean {
     if (typeof value == 'boolean') return value;
     $AssertInit(value);
     return toBoolean(value, undefined);
-};
-export const $ToString = (value: VmAny): string => {
+}
+/** 转换为字符串 */
+export function $ToString(value: VmAny): string {
     if (typeof value == 'string') return value;
     $AssertInit(value);
     return toString(value, undefined);
-};
-export const $ToNumber = (value: VmAny): number => {
+}
+/** 转换为数字 */
+export function $ToNumber(value: VmAny): number {
     if (typeof value == 'number') return value;
     $AssertInit(value);
     return toNumber(value, undefined);
-};
-export const $Format = (value: VmAny, format: string | null): string => {
+}
+/** 格式化值 */
+export function $Format(value: VmAny, format: string | null): string {
     $AssertInit(value);
     return toFormat(value, format);
-};
+}

package/src/vm/operations/helpers.ts

@@ -9,31 +9,31 @@ import { $AssertInit } from './common.js';
 import { $ToNumber } from './convert.js';
 
 /** 构造 record | array 元素 */
-export const $El = (value: VmAny): VmConst => {
+export function $El(value: VmAny): VmConst {
     $AssertInit(value);
     if (!isVmConst(value)) return null;
     return value;
-};
+}
 
 const EMPTY = create(null);
 /** 构造 record 可选元素 */
-export const $ElOpt = (key: string, value: VmAny): VmConst => {
+export function $ElOpt(key: string, value: VmAny): VmConst {
     $AssertInit(value);
     if (value == null || !isVmConst(value)) return EMPTY;
     return { __proto__: null, [key]: value };
-};
+}
 
 /** 构造函数和函数表达式 */
-export const $Fn = (name: string | null | undefined, fn: VmFunctionLike): VmFunction => {
+export function $Fn<T extends VmFunctionLike>(name: string | null | undefined, fn: T): VmFunction<T> {
     defineProperty(fn, 'name', { value: name || VM_FUNCTION_ANONYMOUS_NAME });
     return VmFunction(fn, { isLib: false, injectCp: false });
-};
+}
 
 /** 读取闭包上值 */
-export const $Upvalue = (value: VmAny): VmValue => {
+export function $Upvalue(value: VmAny): VmValue {
     $AssertInit(value);
     return value;
-};
+}
 
 const assertArrayLength = (start: number, end: number) => {
     if (end - start > VM_ARRAY_MAX_LENGTH) {
@@ -43,7 +43,8 @@ const assertArrayLength = (start: number, end: number) => {
 const isEmptyRange = (start: number, end: number) => {
     return !isFinite(start) || !isFinite(end) || start > end;
 };
-export const $ArrayRange = (start: VmAny, end: VmAny): VmArray => {
+/** 构造范围数组 */
+export function $ArrayRange(start: VmAny, end: VmAny): VmArray {
     const s = $ToNumber(start);
     const e = $ToNumber(end);
     if (isEmptyRange(s, e)) return [];
@@ -53,8 +54,9 @@ export const $ArrayRange = (start: VmAny, end: VmAny): VmArray => {
         arr.push(i);
     }
     return arr;
-};
-export const $ArrayRangeExclusive = (start: VmAny, end: VmAny): VmArray => {
+}
+/** 构造范围数组（不包含结束值） */
+export function $ArrayRangeExclusive(start: VmAny, end: VmAny): VmArray {
     const s = $ToNumber(start);
     const e = $ToNumber(end);
     if (isEmptyRange(s, e)) return [];
@@ -64,7 +66,7 @@ export const $ArrayRangeExclusive = (start: VmAny, end: VmAny): VmArray => {
         arr.push(i);
     }
     return arr;
-};
+}
 
 /** 默认执行上下文 */
 export function $GlobalFallback(): VmContext {

package/src/vm/operations/operator.ts

@@ -6,93 +6,112 @@ import { $ToBoolean, $ToNumber, $ToString } from './convert.js';
 import { isSame, overloadNumberString } from './utils.js';
 
 // String operations
-export const $Concat = (...args: readonly string[]): string => {
+/** 字符串连接 */
+export function $Concat(...args: readonly string[]): string {
     return args.map((a) => toFormat(a, null)).join('');
-};
+}
 
 // Unary operations
-export const $Pos = (a: VmAny): number => {
+/** 正号 */
+export function $Pos(a: VmAny): number {
     return $ToNumber(a);
-};
-export const $Neg = (a: VmAny): number => {
+}
+/** 负号 */
+export function $Neg(a: VmAny): number {
     return -$ToNumber(a);
-};
-export const $Not = (a: VmAny): boolean => {
+}
+/** 非 */
+export function $Not(a: VmAny): boolean {
     return !$ToBoolean(a);
-};
+}
 
 // Math operations
-export const $Add = (a: VmAny, b: VmAny): number => {
+/** 加法 */
+export function $Add(a: VmAny, b: VmAny): number {
     return $ToNumber(a) + $ToNumber(b);
-};
-export const $Sub = (a: VmAny, b: VmAny): number => {
+}
+/** 减法 */
+export function $Sub(a: VmAny, b: VmAny): number {
     return $ToNumber(a) - $ToNumber(b);
-};
-export const $Mul = (a: VmAny, b: VmAny): number => {
+}
+/** 乘法 */
+export function $Mul(a: VmAny, b: VmAny): number {
     return $ToNumber(a) * $ToNumber(b);
-};
-export const $Div = (a: VmAny, b: VmAny): number => {
+}
+/** 除法 */
+export function $Div(a: VmAny, b: VmAny): number {
     return $ToNumber(a) / $ToNumber(b);
-};
-export const $Mod = (a: VmAny, b: VmAny): number => {
+}
+/** 取模 */
+export function $Mod(a: VmAny, b: VmAny): number {
     return $ToNumber(a) % $ToNumber(b);
-};
-export const $Pow = (a: VmAny, b: VmAny): number => {
+}
+/** 乘方 */
+export function $Pow(a: VmAny, b: VmAny): number {
     return $ToNumber(a) ** $ToNumber(b);
-};
+}
 
 // Logical operations without short-circuiting
-export const $And = (a: VmAny, b: VmAny): boolean => {
+/** 与 */
+export function $And(a: VmAny, b: VmAny): boolean {
     return $ToBoolean(a) && $ToBoolean(b);
-};
-export const $Or = (a: VmAny, b: VmAny): boolean => {
+}
+/** 或 */
+export function $Or(a: VmAny, b: VmAny): boolean {
     return $ToBoolean(a) || $ToBoolean(b);
-};
+}
 
 // Comparison operations
-export const $Gt = (a: VmAny, b: VmAny): boolean => {
+/** 大于 */
+export function $Gt(a: VmAny, b: VmAny): boolean {
     if (overloadNumberString(a, b)) {
         return $ToNumber(a) > $ToNumber(b);
     } else {
         return $ToString(a) > $ToString(b);
     }
-};
-export const $Gte = (a: VmAny, b: VmAny): boolean => {
+}
+/** 大于等于 */
+export function $Gte(a: VmAny, b: VmAny): boolean {
     if (overloadNumberString(a, b)) {
         return $ToNumber(a) >= $ToNumber(b);
     } else {
         return $ToString(a) >= $ToString(b);
     }
-};
-export const $Lt = (a: VmAny, b: VmAny): boolean => {
+}
+/** 小于 */
+export function $Lt(a: VmAny, b: VmAny): boolean {
     if (overloadNumberString(a, b)) {
         return $ToNumber(a) < $ToNumber(b);
     } else {
         return $ToString(a) < $ToString(b);
     }
-};
-export const $Lte = (a: VmAny, b: VmAny): boolean => {
+}
+/** 小于等于 */
+export function $Lte(a: VmAny, b: VmAny): boolean {
     if (overloadNumberString(a, b)) {
         return $ToNumber(a) <= $ToNumber(b);
     } else {
         return $ToString(a) <= $ToString(b);
     }
-};
+}
 
 // Equality operations
-export const $Eq = (a: VmAny, b: VmAny): boolean => {
+/** 等于 */
+export function $Eq(a: VmAny, b: VmAny): boolean {
     $AssertInit(a);
     $AssertInit(b);
     // Number comparison is a special case to handle NaN correctly
     if (typeof a == 'number' && typeof b == 'number') return a === b;
     return isSame(a, b);
-};
-export const $Neq = (a: VmAny, b: VmAny): boolean => {
+}
+/** 不等于 */
+export function $Neq(a: VmAny, b: VmAny): boolean {
     return !$Eq(a, b);
-};
+}
 
 const { abs, min } = Math;
-export const $Aeq = (a: VmAny, b: VmAny): boolean => {
+/** 近似等于 */
+export function $Aeq(a: VmAny, b: VmAny): boolean {
     if (overloadNumberString(a, b)) {
         const an = $ToNumber(a);
         const bn = $ToNumber(b);
@@ -116,16 +135,19 @@ export const $Aeq = (a: VmAny, b: VmAny): boolean => {
         const bn = bi.normalize('NFC');
         return an === bn;
     }
-};
-export const $Naeq = (a: VmAny, b: VmAny): boolean => {
+}
+/** 不近似等于 */
+export function $Naeq(a: VmAny, b: VmAny): boolean {
     return !$Aeq(a, b);
-};
+}
 
-export const $Same = (a: VmAny, b: VmAny): boolean => {
+/** 全等于 */
+export function $Same(a: VmAny, b: VmAny): boolean {
     $AssertInit(a);
     $AssertInit(b);
     return isSame(a, b);
-};
-export const $Nsame = (a: VmAny, b: VmAny): boolean => {
+}
+/** 不全等于 */
+export function $Nsame(a: VmAny, b: VmAny): boolean {
     return !$Same(a, b);
-};
+}