@mirascript/mirascript 0.1.17 → 0.1.19

package/dist/{chunk-W2I5XPIE.js → chunk-BFSB6SQK.js}

@@ -45,7 +45,7 @@ import {
   parseDiagnostics,
   toString,
   values
-} from "./chunk-JG3D67GF.js";
+} from "./chunk-5AEWM4W6.js";
 
 // src/helpers/convert/index.ts
 var convert_exports = {};
@@ -555,13 +555,17 @@ var VmWrapper = class {
   constructor(value) {
     this.value = value;
   }
+  /** 描述键对应的值 */
+  describe(key) {
+    return void 0;
+  }
   /** Convert the object to JSON */
   toJSON() {
     return void 0;
   }
   /** 转为字符串 */
   toString(useBraces) {
-    const { type, describe } = this;
+    const { type, tag: describe } = this;
     if (!describe) return `<${type}>`;
     return `<${type} ${describe}>`;
   }
@@ -736,7 +740,7 @@ var VmExtern = class extends VmWrapper {
     return "extern";
   }
   /** @inheritdoc */
-  get describe() {
+  get tag() {
     const tag = ObjectToString.call(this.value).slice(8, -1);
     if (isArray(this.value)) {
       return `${tag}(${this.value.length})`;
@@ -773,21 +777,26 @@ var VmExtern = class extends VmWrapper {
 Object.defineProperty(VmExtern.prototype, kVmExtern, { value: true });
 
 // src/vm/checkpoint.ts
+var { now } = Date;
+var TIME_ORIGIN = now() - 1e3 * 3600 * 24;
+var timestamp = () => now() - TIME_ORIGIN;
 var MAX_DEPTH = 128;
+var CP_UNSET = -1;
+var CP_DEFAULT_TIMEOUT = 100;
 var cpDepth = 0;
-var cp = Number.NaN;
-var cpTimeout = 100;
+var cp = CP_UNSET;
+var cpTimeout = CP_DEFAULT_TIMEOUT;
 function Cp() {
-  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");
   }
 }
 function CpEnter() {
   cpDepth++;
   if (cpDepth <= 1) {
-    cp = Date.now();
+    cp = timestamp();
     cpDepth = 1;
   } else if (cpDepth > MAX_DEPTH) {
     throw new RangeError("Maximum call depth exceeded");
@@ -798,17 +807,17 @@ function CpEnter() {
 function CpExit() {
   cpDepth--;
   if (cpDepth < 1) {
-    cp = Number.NaN;
+    cp = CP_UNSET;
     cpDepth = 0;
   } else {
     Cp();
   }
 }
-function configCheckpoint(timeout = 100) {
-  if (typeof timeout !== "number" || timeout <= 0 || Number.isNaN(timeout)) {
+function configCheckpoint(timeout = CP_DEFAULT_TIMEOUT) {
+  if (typeof timeout !== "number" || timeout <= 0 || isNaN(timeout)) {
     throw new RangeError("Invalid timeout value");
   }
-  cpTimeout = timeout;
+  cpTimeout = Math.ceil(timeout);
 }
 
 // src/vm/types/function.ts
@@ -851,11 +860,12 @@ function VmFunction(fn, option = {}) {
 // src/vm/types/context.ts
 var { freeze } = Object;
 var VM_SHARED_CONTEXT = create(null);
+var VM_SHARED_CONTEXT_DESCRIPTIONS = create(null);
 var VM_SHARED_CONTEXT_KEYS = null;
 function globalVarNotFound(name) {
   throw new VmError(`Global variable '${name}' is not defined.`, null);
 }
-function defineVmContextValue(name, value, override = false) {
+function defineVmContextValue(name, value, override = false, description = void 0) {
   if (!override && name in VM_SHARED_CONTEXT) throw new Error(`Global variable '${name}' is already defined.`);
   let v;
   if (typeof value == "function") {
@@ -867,6 +877,7 @@ function defineVmContextValue(name, value, override = false) {
     v = value;
   }
   VM_SHARED_CONTEXT[name] = v ?? null;
+  if (description) VM_SHARED_CONTEXT_DESCRIPTIONS[name] = description;
   VM_SHARED_CONTEXT_KEYS = null;
 }
 var DefaultVmContext = freeze({
@@ -885,14 +896,18 @@ var DefaultVmContext = freeze({
   /** @inheritdoc */
   has(key) {
     return key in VM_SHARED_CONTEXT;
+  },
+  /** @inheritdoc */
+  describe(key) {
+    return VM_SHARED_CONTEXT_DESCRIPTIONS[key];
   }
 });
 var _a;
 _a = kVmContext;
 var ValueVmContext = class {
-  constructor(env, describe) {
+  constructor(env, describer) {
     this.env = env;
-    this.describe = describe;
+    this.describer = describer;
     this[_a] = true;
     this.cachedKeys = null;
   }
@@ -915,14 +930,19 @@ var ValueVmContext = class {
   has(key) {
     return key in this.env;
   }
+  /** @inheritdoc */
+  describe(key) {
+    if (this.describer != null && hasOwn(this.env, key)) return this.describer(key);
+    return VM_SHARED_CONTEXT_DESCRIPTIONS[key];
+  }
 };
 var _a2;
 _a2 = kVmContext;
 var FactoryVmContext = class {
-  constructor(getter, enumerator, describe) {
+  constructor(getter, enumerator, describer) {
     this.getter = getter;
     this.enumerator = enumerator;
-    this.describe = describe;
+    this.describer = describer;
     this[_a2] = true;
   }
   /** @inheritdoc */
@@ -940,6 +960,11 @@ var FactoryVmContext = class {
   has(key) {
     return this.getter(key) !== void 0 || DefaultVmContext.has(key);
   }
+  /** @inheritdoc */
+  describe(key) {
+    if (this.describer != null && this.getter(key) !== void 0) return this.describer(key);
+    return VM_SHARED_CONTEXT_DESCRIPTIONS[key];
+  }
 };
 function createVmContext(...args) {
   if (args[0] == null && args[1] == null) {
@@ -1257,7 +1282,7 @@ var VmModule = class extends VmWrapper {
     return "module";
   }
   /** @inheritdoc */
-  get describe() {
+  get tag() {
     return this.name;
   }
 };
@@ -1266,8 +1291,14 @@ Object.defineProperty(VmModule.prototype, kVmModule, { value: true });
 // src/vm/lib/global/index.ts
 var global_exports = {};
 __export(global_exports, {
-  "@e": () => E,
-  "@pi": () => PI,
+  E: () => E,
+  LN10: () => LN10,
+  LN2: () => LN2,
+  LOG10E: () => LOG10E,
+  LOG2E: () => LOG2E,
+  PI: () => PI,
+  SQRT1_2: () => SQRT1_2,
+  SQRT2: () => SQRT2,
   abs: () => abs2,
   acos: () => acos,
   acosh: () => acosh,
@@ -1498,10 +1529,9 @@ function map(data, mapper) {
     return fromEntries(e);
   }
 }
-function VmLib(fn, option, properties) {
-  if (typeof fn != "function") throw new TypeError("Invalid function");
-  if (isVmFunction(fn)) throw new TypeError("Cannot create VmLib from a VmFunction");
-  const ret = fn;
+function VmLib(value, option, properties) {
+  if (isVmFunction(value)) throw new TypeError("Cannot create VmLib from a VmFunction");
+  const ret = typeof value == "function" ? value : { value };
   Object.assign(ret, properties);
   ret.params = option.params;
   ret.paramsType = option.paramsType;
@@ -1568,7 +1598,38 @@ var product = VmLib(
 );
 
 // src/vm/lib/global/math-const.ts
-var { PI, E } = Math;
+var PI = VmLib(Math.PI, {
+  summary: "圆周率",
+  returnsType: "number"
+});
+var E = VmLib(Math.E, {
+  summary: "自然对数的底数",
+  returnsType: "number"
+});
+var SQRT1_2 = VmLib(Math.SQRT1_2, {
+  summary: "1 的平方根除以 2",
+  returnsType: "number"
+});
+var SQRT2 = VmLib(Math.SQRT2, {
+  summary: "2 的平方根",
+  returnsType: "number"
+});
+var LN2 = VmLib(Math.LN2, {
+  summary: "2 的自然对数",
+  returnsType: "number"
+});
+var LN10 = VmLib(Math.LN10, {
+  summary: "10 的自然对数",
+  returnsType: "number"
+});
+var LOG2E = VmLib(Math.LOG2E, {
+  summary: "e 以 2 为底的对数",
+  returnsType: "number"
+});
+var LOG10E = VmLib(Math.LOG10E, {
+  summary: "e 以 10 为底的对数",
+  returnsType: "number"
+});
 
 // src/vm/lib/global/math-unary.ts
 function build2(f) {
@@ -2469,9 +2530,63 @@ var repeat = VmLib(
 
 // src/vm/lib/global/debug.ts
 import supportsColor from "supports-color";
+function defaultSerializer(arg, format2) {
+  return null;
+}
+function serializeValue(arg, format2, serializer) {
+  if (serializer == null || serializer === defaultSerializer) {
+    return defaultSerializer(arg, format2);
+  }
+  try {
+    return serializer(arg, format2);
+  } catch {
+    return defaultSerializer(arg, format2);
+  }
+}
 var debug_print = VmLib(
   (...args) => {
-    console.log(...debug_print.prefix, ...args);
+    const { serializer } = debug_print;
+    if (args.length <= 1 || typeof args[0] != "string" || !args[0].includes("%")) {
+      console.log(...debug_print.prefix, ...args.map((v) => serializeValue(v, "", serializer) ?? v));
+      return;
+    }
+    const [prefix, ...additional] = debug_print.prefix;
+    const [arg0, ...argsRest] = args;
+    const format2 = `${prefix || ""} ${arg0}`;
+    const values4 = [...additional, ...argsRest];
+    const parts = format2.split(/(%[%\w])/g);
+    const messageToConsole = [];
+    const valuesToConsole = [];
+    let valIndex = 0;
+    for (let i = 0; i < parts.length; i++) {
+      if (i % 2 === 0) {
+        messageToConsole.push(parts[i]);
+        continue;
+      }
+      const specifier = parts[i];
+      if (specifier === "%%") {
+        messageToConsole.push("%");
+      } else {
+        if (valIndex >= values4.length) {
+          messageToConsole.push(specifier);
+          continue;
+        }
+        const arg = values4[valIndex++];
+        const f = serializeValue(arg, specifier, serializer);
+        if (f != null) {
+          messageToConsole.push("%s");
+          valuesToConsole.push(f);
+        } else {
+          messageToConsole.push(specifier);
+          valuesToConsole.push(arg);
+        }
+      }
+    }
+    if (valIndex < values4.length) {
+      const remaining = values4.slice(valIndex);
+      valuesToConsole.push(...remaining.map((v) => serializeValue(v, "", serializer) ?? v));
+    }
+    console.log(messageToConsole.join(""), ...valuesToConsole);
   },
   {
     summary: "打印调试信息到控制台",
@@ -2481,13 +2596,14 @@ var debug_print = VmLib(
     examples: ['debug_print("value:", 42);']
   },
   {
-    prefix: ["MiraScript"]
+    prefix: ["MiraScript"],
+    serializer: defaultSerializer
   }
 );
 var panic = VmLib(
   (message) => {
     if (message === void 0) console.error(...panic.prefix);
-    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, void 0);
@@ -2500,14 +2616,16 @@ var panic = VmLib(
     examples: ['panic("boom");']
   },
   {
-    prefix: ["MiraScript"]
+    prefix: ["MiraScript"],
+    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 = ["\x1B[44;37m MiraScript \x1B[0m"];
@@ -2542,10 +2660,9 @@ var to_json = VmLib(
 );
 var 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 !== void 0) return fallback;
       rethrowError("Invalid JSON", ex, null);
@@ -2782,9 +2899,9 @@ var getTimestamp = (datetime, fallback) => {
 };
 var to_timestamp = VmLib(
   (datetime, fallback) => {
-    const timestamp = getTimestamp(datetime, fallback !== void 0);
-    if (timestamp == null) return fallback;
-    return timestamp;
+    const timestamp2 = getTimestamp(datetime, fallback !== void 0);
+    if (timestamp2 == null) return fallback;
+    return timestamp2;
   },
   {
     summary: "将数据转换为 Unix 毫秒时间戳",
@@ -2799,10 +2916,10 @@ var to_timestamp = VmLib(
 );
 var to_datetime = VmLib(
   (datetime, offset, fallback) => {
-    const timestamp = getTimestamp(datetime, fallback !== void 0);
-    if (timestamp == null) return fallback;
+    const timestamp2 = getTimestamp(datetime, fallback !== void 0);
+    if (timestamp2 == null) return fallback;
     const o = expectNumberRange("offset", offset ?? 0, -24, 24);
-    const dateOffset = new Date(timestamp + o * 1e3 * 60 * 60);
+    const dateOffset = new Date(timestamp2 + o * 1e3 * 60 * 60);
     return {
       year: dateOffset.getUTCFullYear(),
       month: dateOffset.getUTCMonth() + 1,
@@ -2838,9 +2955,9 @@ to_datetime(0)
 );
 var to_iso8601 = VmLib(
   (datetime, fallback) => {
-    const timestamp = getTimestamp(datetime, fallback !== void 0);
-    if (timestamp == null) return fallback;
-    return new Date(timestamp).toISOString();
+    const timestamp2 = getTimestamp(datetime, fallback !== void 0);
+    if (timestamp2 == null) return fallback;
+    return new Date(timestamp2).toISOString();
   },
   {
     summary: "将数据转换为 ISO 8601 格式的字符串",
@@ -3359,39 +3476,64 @@ var diagonal = VmLib(
 );
 
 // src/vm/lib/loader.ts
+var VmBuiltinModule = class extends VmModule {
+  constructor(name, value, descriptions) {
+    super(name, value);
+    this.descriptions = descriptions;
+  }
+  /** @inheritdoc */
+  describe(key) {
+    return this.descriptions[key];
+  }
+};
 function wrapEntry(name, value, module) {
-  if (typeof value == "function") {
-    if (value.name !== name) {
-      defineProperty(value, "name", {
-        value: name,
-        configurable: true
-      });
+  if (isVmModule(value)) {
+    return [value, void 0];
+  }
+  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, value.summary || void 0];
+  }
+  if (value.name !== name) {
+    defineProperty(value, "name", {
+      value: name,
+      configurable: true
+    });
+  }
+  return [
+    VmFunction(value, {
       isLib: true,
       injectCp: true,
       fullName: `${module}.${name}`,
       ...value
-    });
-  } else {
-    return value;
-  }
+    }),
+    value.summary || void 0
+  ];
 }
 function createModule(name, lib2) {
   const mod = create(null);
+  const descriptions = create(null);
   for (const [key, value] of entries(lib2)) {
-    mod[key] = wrapEntry(key, value, name);
+    const [wrappedValue, description] = wrapEntry(key, value, name);
+    mod[key] = wrappedValue;
+    descriptions[key] = description;
   }
-  return new VmModule(name, mod);
+  return new VmBuiltinModule(name, mod, descriptions);
 }
 
 // src/vm/lib/index.ts
 for (const [name, value] of entries(global_exports)) {
-  VM_SHARED_CONTEXT[name] = wrapEntry(name, value, "global");
+  const [wrappedValue, description] = wrapEntry(name, value, "global");
+  VM_SHARED_CONTEXT[name] = wrappedValue;
+  VM_SHARED_CONTEXT_DESCRIPTIONS[name] = description;
 }
 for (const [name, value] of entries(mod_exports)) {
   const mod = createModule(name, value);
-  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;
 }
 var lib = Object.freeze(Object.assign(create(null), global_exports, mod_exports));
 
@@ -3411,6 +3553,7 @@ export {
   compileSync,
   VmModule,
   debug_print,
+  panic,
   lib
 };
-//# sourceMappingURL=chunk-W2I5XPIE.js.map
+//# sourceMappingURL=chunk-BFSB6SQK.js.map