@al8b/vm 0.1.0

package/dist/l8bvm.mjs

@@ -0,0 +1,270 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/l8bvm.ts
+import { StorageService } from "@al8b/io";
+import { Routine, Runner } from "@al8b/lootiscript";
+
+// src/context.ts
+import { Random } from "@al8b/lootiscript";
+var _baseMeta = {
+  round: /* @__PURE__ */ __name((x) => Math.round(x), "round"),
+  floor: /* @__PURE__ */ __name((x) => Math.floor(x), "floor"),
+  ceil: /* @__PURE__ */ __name((x) => Math.ceil(x), "ceil"),
+  abs: /* @__PURE__ */ __name((x) => Math.abs(x), "abs"),
+  min: /* @__PURE__ */ __name((x, y) => Math.min(x, y), "min"),
+  max: /* @__PURE__ */ __name((x, y) => Math.max(x, y), "max"),
+  sqrt: /* @__PURE__ */ __name((x) => Math.sqrt(x), "sqrt"),
+  pow: /* @__PURE__ */ __name((x, y) => x ** y, "pow"),
+  sin: /* @__PURE__ */ __name((x) => Math.sin(x), "sin"),
+  cos: /* @__PURE__ */ __name((x) => Math.cos(x), "cos"),
+  tan: /* @__PURE__ */ __name((x) => Math.tan(x), "tan"),
+  asin: /* @__PURE__ */ __name((x) => Math.asin(x), "asin"),
+  acos: /* @__PURE__ */ __name((x) => Math.acos(x), "acos"),
+  atan: /* @__PURE__ */ __name((x) => Math.atan(x), "atan"),
+  atan2: /* @__PURE__ */ __name((y, x) => Math.atan2(y, x), "atan2"),
+  sind: /* @__PURE__ */ __name((x) => Math.sin(x / 180 * Math.PI), "sind"),
+  cosd: /* @__PURE__ */ __name((x) => Math.cos(x / 180 * Math.PI), "cosd"),
+  tand: /* @__PURE__ */ __name((x) => Math.tan(x / 180 * Math.PI), "tand"),
+  asind: /* @__PURE__ */ __name((x) => Math.asin(x) * 180 / Math.PI, "asind"),
+  acosd: /* @__PURE__ */ __name((x) => Math.acos(x) * 180 / Math.PI, "acosd"),
+  atand: /* @__PURE__ */ __name((x) => Math.atan(x) * 180 / Math.PI, "atand"),
+  atan2d: /* @__PURE__ */ __name((y, x) => Math.atan2(y, x) * 180 / Math.PI, "atan2d"),
+  log: /* @__PURE__ */ __name((x) => Math.log(x), "log"),
+  exp: /* @__PURE__ */ __name((x) => Math.exp(x), "exp"),
+  random: new Random(0),
+  PI: Math.PI,
+  true: 1,
+  false: 0
+};
+var _defaultPrint = /* @__PURE__ */ __name((text) => console.log(text), "_defaultPrint");
+function createVMContext(meta, global) {
+  const fullMeta = {
+    ..._baseMeta,
+    print: meta.print ?? _defaultPrint,
+    ...meta
+  };
+  return {
+    meta: fullMeta,
+    global,
+    local: global,
+    object: global,
+    breakable: 0,
+    continuable: 0,
+    returnable: 0,
+    stack_size: 0,
+    timeout: Date.now() + 3e3,
+    warnings: {
+      using_undefined_variable: {},
+      assigning_field_to_undefined: {},
+      invoking_non_function: {},
+      assigning_api_variable: {},
+      assignment_as_condition: {}
+    }
+  };
+}
+__name(createVMContext, "createVMContext");
+
+// src/extensions.ts
+function setupArrayExtensions() {
+  if (!Array.prototype.insert) {
+    Array.prototype.insert = function(element) {
+      this.splice(0, 0, element);
+      return element;
+    };
+  }
+  if (!Array.prototype.insertAt) {
+    Array.prototype.insertAt = function(element, index) {
+      if (index >= 0 && index < this.length) {
+        this.splice(index, 0, element);
+      } else {
+        this.push(element);
+      }
+      return element;
+    };
+  }
+  if (!Array.prototype.remove) {
+    Array.prototype.remove = function(index) {
+      if (index >= 0 && index < this.length) {
+        return this.splice(index, 1)[0];
+      }
+      return 0;
+    };
+  }
+  if (!Array.prototype.removeElement) {
+    Array.prototype.removeElement = function(element) {
+      const index = this.indexOf(element);
+      if (index >= 0) {
+        return this.splice(index, 1)[0];
+      }
+      return 0;
+    };
+  }
+  if (!Array.prototype.contains) {
+    Array.prototype.contains = function(element) {
+      return this.indexOf(element) >= 0 ? 1 : 0;
+    };
+  }
+  if (!Array.prototype.sortList) {
+    Array.prototype.sortList = function(fn) {
+      if (fn) {
+        return this.sort(fn);
+      }
+      return this.sort();
+    };
+  }
+}
+__name(setupArrayExtensions, "setupArrayExtensions");
+
+// src/l8bvm.ts
+function extractErrorInfo(err, fallbackFile, fallbackType, runner) {
+  const errorMessage = typeof err === "object" && err !== null && "error" in err && typeof err.error === "string" ? err.error : err?.message ?? String(err);
+  let stackTrace = err?.stackTrace;
+  if (!stackTrace && runner?.main_thread?.processor?.generateStackTrace) {
+    stackTrace = runner.main_thread.processor.generateStackTrace();
+  }
+  return {
+    error: errorMessage,
+    type: err?.type ?? fallbackType,
+    line: err?.line,
+    column: err?.column,
+    file: err?.file ?? fallbackFile,
+    stack: err?.stack,
+    stackTrace
+  };
+}
+__name(extractErrorInfo, "extractErrorInfo");
+var L8BVM = class {
+  static {
+    __name(this, "L8BVM");
+  }
+  context;
+  runner;
+  storage_service;
+  error_info = null;
+  constructor(meta = {}, global = {}, namespace = "/l8b", preserve_ls = false) {
+    this.context = createVMContext(meta, global);
+    this.storage_service = new StorageService(namespace, preserve_ls);
+    this.context.global.storage = this.storage_service.getInterface();
+    this.runner = new Runner(this);
+    this.runner.init();
+    setupArrayExtensions();
+  }
+  /**
+  * Run source code
+  *
+  * Compiles and executes a string of LootiScript code.
+  *
+  * @param {string} source - The source code to execute
+  * @param {number} [timeout=3000] - Execution time limit in ms
+  * @param {string} [filename=""] - Filename for error reporting
+  * @returns {any} The result of the last statement execution
+  * @throws {ErrorInfo} If compilation or execution fails
+  */
+  run(source, timeout = 3e3, filename = "") {
+    this.error_info = null;
+    this.context.timeout = Date.now() + timeout;
+    this.context.stack_size = 0;
+    try {
+      const result = this.runner.run(source, filename);
+      this.storage_service.check();
+      if (result !== null && result !== void 0) {
+        return this.runner.toString(result);
+      }
+      return null;
+    } catch (err) {
+      this.error_info = extractErrorInfo(err, filename, "runtime", this.runner);
+      throw err;
+    }
+  }
+  /**
+  * Call a global function
+  *
+  * Executes a specific function defined in the global scope.
+  * Useful for game loop hooks (update, draw) or event handlers.
+  *
+  * @param {string} name - Name of the function to call
+  * @param {any[]} [args=[]] - Arguments to pass to the function
+  * @param {number} [timeout=3000] - Execution time limit in ms
+  * @returns {any} The return value of the function
+  * @throws {ErrorInfo} If the function doesn't exist or execution fails
+  */
+  call(name, args = [], timeout = 3e3) {
+    this.error_info = null;
+    this.context.timeout = Date.now() + timeout;
+    this.context.stack_size = 0;
+    try {
+      const result = this.runner.call(name, ...args);
+      this.storage_service.check();
+      return result;
+    } catch (err) {
+      this.error_info = extractErrorInfo(err, name, "call", this.runner);
+      throw err;
+    }
+  }
+  /**
+  * Load a pre-compiled routine (for production builds)
+  *
+  * Loads bytecode directly into the VM, bypassing the compilation step.
+  * Used in production to improve startup time and obfuscate source.
+  *
+  * @param {any} routineData - Either a Routine instance or serialized JSON
+  * @param {string} [filename=""] - Name of the file for error reporting
+  * @throws {ErrorInfo} If loading fails
+  */
+  loadRoutine(routineData, filename = "") {
+    this.error_info = null;
+    try {
+      let routine;
+      if (routineData instanceof Routine) {
+        routine = routineData;
+      } else {
+        routine = new Routine(0).import(normalizeSerializedRoutine(routineData));
+      }
+      this.runner.main_thread.addCall(routine);
+      this.runner.tick();
+    } catch (err) {
+      this.error_info = extractErrorInfo(err, filename, "compile");
+      throw err;
+    }
+  }
+  /**
+  * Clear warnings
+  */
+  clearWarnings() {
+    this.context.warnings = {
+      using_undefined_variable: {},
+      assigning_field_to_undefined: {},
+      invoking_non_function: {},
+      assigning_api_variable: {},
+      assignment_as_condition: {}
+    };
+  }
+  /**
+  * Get warnings
+  */
+  getWarnings() {
+    return this.context.warnings || {};
+  }
+  /**
+  * Convert value to string (for printing)
+  */
+  toString(value) {
+    return this.runner.toString(value);
+  }
+};
+function normalizeSerializedRoutine(routineData) {
+  if (isCompiledModuleArtifact(routineData)) {
+    return routineData.routine;
+  }
+  return routineData;
+}
+__name(normalizeSerializedRoutine, "normalizeSerializedRoutine");
+function isCompiledModuleArtifact(value) {
+  return typeof value === "object" && value !== null && "format" in value && value.format === "l8b-compiled-routine" && "routine" in value;
+}
+__name(isCompiledModuleArtifact, "isCompiledModuleArtifact");
+export {
+  L8BVM
+};
+//# sourceMappingURL=l8bvm.mjs.map

package/dist/l8bvm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/l8bvm.ts","../src/context.ts","../src/extensions.ts"],"sourcesContent":["/**\n * L8BVM - Virtual Machine wrapper for lootiscript\n *\n * High-level interface for the LootiScript virtual machine.\n * Wraps the core Compiler, Processor, and Runner into a usable engine component.\n * Handles context creation, storage persistence, and error formatting.\n *\n * Responsibilities:\n * - Create and manage VM execution context\n * - Provide clean API for running code and calling functions\n * - Handle storage persistence\n * - Format and normalize runtime errors\n *\n * @module vm\n */\n\nimport type { CompiledModuleArtifact, SerializedRoutineData } from \"@al8b/framework-shared\";\nimport { StorageService } from \"@al8b/io\";\nimport { Routine, Runner } from \"@al8b/lootiscript\";\nimport { createVMContext } from \"./context\";\nimport { setupArrayExtensions } from \"./extensions\";\nimport type { ErrorInfo, GlobalAPI, MetaFunctions, VMContext } from \"./types\";\n\n/**\n * Extract normalized ErrorInfo from a caught exception.\n * Centralizes the error-parsing logic shared across run(), call(), and loadRoutine().\n */\nfunction extractErrorInfo(err: any, fallbackFile: string, fallbackType: string, runner?: Runner): ErrorInfo {\n\tconst errorMessage =\n\t\ttypeof err === \"object\" && err !== null && \"error\" in err && typeof err.error === \"string\"\n\t\t\t? err.error\n\t\t\t: err?.message ?? String(err);\n\n\tlet stackTrace = err?.stackTrace;\n\tif (!stackTrace && (runner as any)?.main_thread?.processor?.generateStackTrace) {\n\t\tstackTrace = (runner as any).main_thread.processor.generateStackTrace();\n\t}\n\n\treturn {\n\t\terror: errorMessage,\n\t\ttype: err?.type ?? fallbackType,\n\t\tline: err?.line,\n\t\tcolumn: err?.column,\n\t\tfile: err?.file ?? fallbackFile,\n\t\tstack: err?.stack,\n\t\tstackTrace,\n\t};\n}\n\nexport class L8BVM {\n\tpublic context: VMContext;\n\tpublic runner: Runner;\n\tpublic storage_service: StorageService;\n\tpublic error_info: ErrorInfo | null = null;\n\n\tconstructor(\n\t\tmeta: Partial<MetaFunctions> = {},\n\t\tglobal: Partial<GlobalAPI> = {},\n\t\tnamespace = \"/l8b\",\n\t\tpreserve_ls = false,\n\t) {\n\t\t// Initialize VM execution context with meta functions and global API\n\t\tthis.context = createVMContext(meta, global);\n\n\t\t// Initialize storage service for persistent data (localStorage/sessionStorage)\n\t\tthis.storage_service = new StorageService(namespace, preserve_ls);\n\n\t\t// Inject storage API into global scope for LootiScript access\n\t\tthis.context.global.storage = this.storage_service.getInterface();\n\n\t\t// Create Runner instance with reference to this VM for bidirectional communication\n\t\tthis.runner = new Runner(this as any);\n\n\t\t// Initialize Runner and create main execution thread\n\t\tthis.runner.init();\n\n\t\t// Add custom array methods to Array.prototype for LootiScript\n\t\tsetupArrayExtensions();\n\t}\n\n\t/**\n\t * Run source code\n\t *\n\t * Compiles and executes a string of LootiScript code.\n\t *\n\t * @param {string} source - The source code to execute\n\t * @param {number} [timeout=3000] - Execution time limit in ms\n\t * @param {string} [filename=\"\"] - Filename for error reporting\n\t * @returns {any} The result of the last statement execution\n\t * @throws {ErrorInfo} If compilation or execution fails\n\t */\n\trun(source: string, timeout = 3000, filename = \"\"): any {\n\t\tthis.error_info = null;\n\t\tthis.context.timeout = Date.now() + timeout;\n\t\tthis.context.stack_size = 0;\n\n\t\ttry {\n\t\t\tconst result = this.runner.run(source, filename);\n\t\t\tthis.storage_service.check();\n\n\t\t\tif (result !== null && result !== undefined) {\n\t\t\t\treturn this.runner.toString(result);\n\t\t\t}\n\t\t\treturn null;\n\t\t} catch (err: any) {\n\t\t\tthis.error_info = extractErrorInfo(err, filename, \"runtime\", this.runner);\n\t\t\tthrow err;\n\t\t}\n\t}\n\n\t/**\n\t * Call a global function\n\t *\n\t * Executes a specific function defined in the global scope.\n\t * Useful for game loop hooks (update, draw) or event handlers.\n\t *\n\t * @param {string} name - Name of the function to call\n\t * @param {any[]} [args=[]] - Arguments to pass to the function\n\t * @param {number} [timeout=3000] - Execution time limit in ms\n\t * @returns {any} The return value of the function\n\t * @throws {ErrorInfo} If the function doesn't exist or execution fails\n\t */\n\tcall(name: string, args: any[] = [], timeout = 3000): any {\n\t\tthis.error_info = null;\n\t\tthis.context.timeout = Date.now() + timeout;\n\t\tthis.context.stack_size = 0;\n\n\t\ttry {\n\t\t\tconst result = this.runner.call(name, ...args);\n\t\t\tthis.storage_service.check();\n\t\t\treturn result;\n\t\t} catch (err: any) {\n\t\t\tthis.error_info = extractErrorInfo(err, name, \"call\", this.runner);\n\t\t\tthrow err;\n\t\t}\n\t}\n\n\t/**\n\t * Load a pre-compiled routine (for production builds)\n\t *\n\t * Loads bytecode directly into the VM, bypassing the compilation step.\n\t * Used in production to improve startup time and obfuscate source.\n\t *\n\t * @param {any} routineData - Either a Routine instance or serialized JSON\n\t * @param {string} [filename=\"\"] - Name of the file for error reporting\n\t * @throws {ErrorInfo} If loading fails\n\t */\n\tloadRoutine(routineData: any, filename: string = \"\"): void {\n\t\tthis.error_info = null;\n\n\t\ttry {\n\t\t\tlet routine: Routine;\n\n\t\t\t// Handle both Routine instances and serialized routine data\n\t\t\t// Serialized data needs to be imported first\n\t\t\tif (routineData instanceof Routine) {\n\t\t\t\troutine = routineData;\n\t\t\t} else {\n\t\t\t\troutine = new Routine(0).import(normalizeSerializedRoutine(routineData));\n\t\t\t}\n\n\t\t\t// Add to main thread for execution\n\t\t\tthis.runner.main_thread.addCall(routine);\n\t\t\tthis.runner.tick();\n\t\t} catch (err: any) {\n\t\t\tthis.error_info = extractErrorInfo(err, filename, \"compile\");\n\t\t\tthrow err;\n\t\t}\n\t}\n\n\t/**\n\t * Clear warnings\n\t */\n\tclearWarnings(): void {\n\t\tthis.context.warnings = {\n\t\t\tusing_undefined_variable: {},\n\t\t\tassigning_field_to_undefined: {},\n\t\t\tinvoking_non_function: {},\n\t\t\tassigning_api_variable: {},\n\t\t\tassignment_as_condition: {},\n\t\t};\n\t}\n\n\t/**\n\t * Get warnings\n\t */\n\tgetWarnings(): Record<string, any> {\n\t\treturn this.context.warnings || {};\n\t}\n\n\t/**\n\t * Convert value to string (for printing)\n\t */\n\ttoString(value: any): string {\n\t\treturn this.runner.toString(value);\n\t}\n}\n\nfunction normalizeSerializedRoutine(routineData: CompiledModuleArtifact | SerializedRoutineData): SerializedRoutineData {\n\tif (isCompiledModuleArtifact(routineData)) {\n\t\treturn routineData.routine;\n\t}\n\n\treturn routineData;\n}\n\nfunction isCompiledModuleArtifact(value: unknown): value is CompiledModuleArtifact {\n\treturn (\n\t\ttypeof value === \"object\" &&\n\t\tvalue !== null &&\n\t\t\"format\" in value &&\n\t\t(value as { format?: unknown }).format === \"l8b-compiled-routine\" &&\n\t\t\"routine\" in value\n\t);\n}\n","/**\n * VM Context creation utilities\n */\n\nimport { Random } from \"@al8b/lootiscript\";\nimport type { GlobalAPI, MetaFunctions, VMContext } from \"./types\";\n\n// Shared math lambdas — allocated once, reused across all VM instances\nconst _baseMeta = {\n\tround: (x: number) => Math.round(x),\n\tfloor: (x: number) => Math.floor(x),\n\tceil: (x: number) => Math.ceil(x),\n\tabs: (x: number) => Math.abs(x),\n\tmin: (x: number, y: number) => Math.min(x, y),\n\tmax: (x: number, y: number) => Math.max(x, y),\n\tsqrt: (x: number) => Math.sqrt(x),\n\tpow: (x: number, y: number) => x ** y,\n\tsin: (x: number) => Math.sin(x),\n\tcos: (x: number) => Math.cos(x),\n\ttan: (x: number) => Math.tan(x),\n\tasin: (x: number) => Math.asin(x),\n\tacos: (x: number) => Math.acos(x),\n\tatan: (x: number) => Math.atan(x),\n\tatan2: (y: number, x: number) => Math.atan2(y, x),\n\tsind: (x: number) => Math.sin((x / 180) * Math.PI),\n\tcosd: (x: number) => Math.cos((x / 180) * Math.PI),\n\ttand: (x: number) => Math.tan((x / 180) * Math.PI),\n\tasind: (x: number) => (Math.asin(x) * 180) / Math.PI,\n\tacosd: (x: number) => (Math.acos(x) * 180) / Math.PI,\n\tatand: (x: number) => (Math.atan(x) * 180) / Math.PI,\n\tatan2d: (y: number, x: number) => (Math.atan2(y, x) * 180) / Math.PI,\n\tlog: (x: number) => Math.log(x),\n\texp: (x: number) => Math.exp(x),\n\trandom: new Random(0),\n\tPI: Math.PI,\n\ttrue: 1 as const,\n\tfalse: 0 as const,\n};\n\nconst _defaultPrint = (text: any) => console.log(text);\n\n/**\n * Create meta functions (built-in functions)\n */\nexport function createMetaFunctions(customPrint?: (text: any) => void): MetaFunctions {\n\treturn {\n\t\t..._baseMeta,\n\t\tprint: customPrint ?? _defaultPrint,\n\t};\n}\n\n/**\n * Create VM context\n */\nexport function createVMContext(meta: Partial<MetaFunctions>, global: Partial<GlobalAPI>): VMContext {\n\tconst fullMeta: MetaFunctions = {\n\t\t..._baseMeta,\n\t\tprint: meta.print ?? _defaultPrint,\n\t\t...meta,\n\t};\n\n\treturn {\n\t\tmeta: fullMeta as MetaFunctions,\n\t\tglobal: global as GlobalAPI,\n\t\tlocal: global,\n\t\tobject: global,\n\t\tbreakable: 0,\n\t\tcontinuable: 0,\n\t\treturnable: 0,\n\t\tstack_size: 0,\n\t\ttimeout: Date.now() + 3000,\n\t\twarnings: {\n\t\t\tusing_undefined_variable: {},\n\t\t\tassigning_field_to_undefined: {},\n\t\t\tinvoking_non_function: {},\n\t\t\tassigning_api_variable: {},\n\t\t\tassignment_as_condition: {},\n\t\t},\n\t};\n}\n","/**\n * Array extensions\n */\n\n/**\n * Setup array extensions\n */\nexport function setupArrayExtensions(): void {\n\t// Insert element at beginning of array (returns the inserted element)\n\tif (!Array.prototype.insert) {\n\t\tArray.prototype.insert = function (element: any) {\n\t\t\tthis.splice(0, 0, element);\n\t\t\treturn element;\n\t\t};\n\t}\n\n\t// Insert element at specific index (returns the inserted element)\n\tif (!Array.prototype.insertAt) {\n\t\tArray.prototype.insertAt = function (element: any, index: number) {\n\t\t\tif (index >= 0 && index < this.length) {\n\t\t\t\tthis.splice(index, 0, element);\n\t\t\t} else {\n\t\t\t\tthis.push(element);\n\t\t\t}\n\t\t\treturn element;\n\t\t};\n\t}\n\n\t// Remove element at index (returns removed element or 0 if out of bounds)\n\tif (!Array.prototype.remove) {\n\t\tArray.prototype.remove = function (index: number) {\n\t\t\tif (index >= 0 && index < this.length) {\n\t\t\t\treturn this.splice(index, 1)[0];\n\t\t\t}\n\t\t\treturn 0;\n\t\t};\n\t}\n\n\t// Remove first occurrence of element (returns removed element or 0 if not found)\n\tif (!Array.prototype.removeElement) {\n\t\tArray.prototype.removeElement = function (element: any) {\n\t\t\tconst index = this.indexOf(element);\n\t\t\tif (index >= 0) {\n\t\t\t\treturn this.splice(index, 1)[0];\n\t\t\t}\n\t\t\treturn 0;\n\t\t};\n\t}\n\n\t// Check if array contains element (returns 1 if found, 0 if not found)\n\tif (!Array.prototype.contains) {\n\t\tArray.prototype.contains = function (element: any) {\n\t\t\treturn this.indexOf(element) >= 0 ? 1 : 0;\n\t\t};\n\t}\n\n\t// Sort array with optional comparator function\n\tif (!Array.prototype.sortList) {\n\t\tArray.prototype.sortList = function (fn?: (a: any, b: any) => number) {\n\t\t\tif (fn) {\n\t\t\t\treturn this.sort(fn);\n\t\t\t}\n\t\t\treturn this.sort();\n\t\t};\n\t}\n}\n\n// TypeScript type declarations for Array prototype extensions\ndeclare global {\n\tinterface Array<T> {\n\t\tinsert(element: T): T;\n\t\tinsertAt(element: T, index: number): T;\n\t\tremove(index: number): T | 0;\n\t\tremoveElement(element: T): T | 0;\n\t\tcontains(element: T): 0 | 1;\n\t\tsortList(fn?: (a: T, b: T) => number): T[];\n\t}\n}\n"],"mappings":"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","names":["StorageService","Routine","Runner","Random","_baseMeta","round","x","Math","floor","ceil","abs","min","y","max","sqrt","pow","sin","cos","tan","asin","acos","atan","atan2","sind","PI","cosd","tand","asind","acosd","atand","atan2d","log","exp","random","Random","true","false","_defaultPrint","text","console","createVMContext","meta","global","fullMeta","_baseMeta","print","_defaultPrint","local","object","breakable","continuable","returnable","stack_size","timeout","Date","now","warnings","using_undefined_variable","assigning_field_to_undefined","invoking_non_function","assigning_api_variable","assignment_as_condition","setupArrayExtensions","Array","prototype","insert","element","splice","insertAt","index","length","push","remove","removeElement","indexOf","contains","sortList","fn","sort","extractErrorInfo","err","fallbackFile","fallbackType","runner","errorMessage","error","message","String","stackTrace","main_thread","processor","generateStackTrace","type","line","column","file","stack","L8BVM","context","storage_service","error_info","meta","global","namespace","preserve_ls","createVMContext","StorageService","storage","getInterface","Runner","init","setupArrayExtensions","run","source","timeout","filename","Date","now","stack_size","result","check","undefined","toString","call","name","args","loadRoutine","routineData","routine","Routine","import","normalizeSerializedRoutine","addCall","tick","clearWarnings","warnings","using_undefined_variable","assigning_field_to_undefined","invoking_non_function","assigning_api_variable","assignment_as_condition","getWarnings","value","isCompiledModuleArtifact","format"]}

package/dist/types/index.d.mts

@@ -0,0 +1,196 @@
+/**
+ * VM related type definitions
+ */
+/**
+ * Player API exposed to game code - controls player UX
+ */
+interface PlayerAPI {
+    /** Pause the game loop */
+    pause: () => void;
+    /** Resume the game loop */
+    resume: () => void;
+    /** Send a custom message to the host application */
+    postMessage: (message: any) => void;
+    /** Set target update rate (FPS) */
+    setFps: (fps: number) => void;
+    /** Current FPS (read-only) */
+    readonly fps: number;
+    /** Target update rate in Hz (read/write) */
+    update_rate: number;
+}
+/**
+ * System API exposed to game code - system info and utilities
+ */
+interface SystemAPI {
+    time: number;
+    fps: number;
+    cpu_load: number;
+    update_rate: number;
+    language: string;
+    inputs: {
+        keyboard: number;
+        mouse: number;
+        touch: number;
+        gamepad: number;
+    };
+    loading?: number;
+    prompt: (text: string, callback: (result: string) => void) => void;
+    say: (text: string) => void;
+    file: {
+        dropped: number;
+    };
+    javascript: any;
+    disable_autofullscreen?: number;
+    preemptive?: number;
+    threads?: any[];
+}
+/**
+ * Storage interface exposed to game code
+ */
+interface StorageInterface {
+    set: (name: string, value: unknown) => void;
+    get: (name: string) => unknown;
+}
+/**
+ * Scene interface exposed to game code
+ */
+interface SceneInterface {
+    register: (name: string, def: Record<string, unknown>) => void;
+    route: (path: string, sceneName: string) => void;
+    goto: (name: string, params?: Record<string, string>) => void;
+    current: () => string | null;
+}
+/**
+ * Router interface exposed to game code
+ */
+interface RouterInterface {
+    navigate: (path: string) => void;
+    back: () => void;
+    readonly path: string;
+}
+/**
+ * Global API exposed to game code
+ *
+ * Core service fields (screen, audio, keyboard, etc.) use Record<string, any>
+ * because they are dynamically populated from different core packages with varying shapes.
+ * Helper interfaces above document the expected shape of stable APIs.
+ */
+interface GlobalAPI {
+    screen: Record<string, any>;
+    audio: Record<string, any>;
+    keyboard: Record<string, any>;
+    mouse: Record<string, any>;
+    touch: Record<string, any>;
+    gamepad: Record<string, any>;
+    sprites: Record<string, any>;
+    maps: Record<string, any>;
+    sounds: Record<string, any>;
+    music: Record<string, any>;
+    assets: Record<string, any>;
+    storage: Record<string, any>;
+    scene: Record<string, any>;
+    route: Record<string, any>;
+    router: Record<string, any>;
+    player: Record<string, any>;
+    system: SystemAPI;
+    fonts?: Record<string, any>;
+    Sound?: any;
+    Image?: any;
+    Sprite?: any;
+    TileMap?: any;
+    Palette?: any;
+    Random?: any;
+}
+/**
+ * Meta functions (built-in functions)
+ */
+interface MetaFunctions {
+    print: (text: any) => void;
+    round: (x: number) => number;
+    floor: (x: number) => number;
+    ceil: (x: number) => number;
+    abs: (x: number) => number;
+    min: (x: number, y: number) => number;
+    max: (x: number, y: number) => number;
+    sqrt: (x: number) => number;
+    pow: (x: number, y: number) => number;
+    sin: (x: number) => number;
+    cos: (x: number) => number;
+    tan: (x: number) => number;
+    asin: (x: number) => number;
+    acos: (x: number) => number;
+    atan: (x: number) => number;
+    atan2: (y: number, x: number) => number;
+    sind: (x: number) => number;
+    cosd: (x: number) => number;
+    tand: (x: number) => number;
+    asind: (x: number) => number;
+    acosd: (x: number) => number;
+    atand: (x: number) => number;
+    atan2d: (y: number, x: number) => number;
+    log: (x: number) => number;
+    exp: (x: number) => number;
+    random: any;
+    PI: number;
+    true: number;
+    false: number;
+}
+/**
+ * Warning info for a specific code location
+ */
+interface WarningInfo {
+    file: string;
+    line: number;
+    column: number;
+    expression?: string;
+    identifier?: string;
+    reported?: boolean;
+}
+/**
+ * Accumulated warnings structure
+ */
+interface VMWarnings {
+    using_undefined_variable: Record<string, WarningInfo>;
+    assigning_field_to_undefined: Record<string, WarningInfo>;
+    invoking_non_function: Record<string, WarningInfo>;
+    assigning_api_variable: Record<string, WarningInfo>;
+    assignment_as_condition: Record<string, WarningInfo>;
+}
+/**
+ * VM Context
+ */
+interface VMContext {
+    meta: MetaFunctions;
+    global: GlobalAPI;
+    local: any;
+    object: any;
+    breakable: number;
+    continuable: number;
+    returnable: number;
+    stack_size: number;
+    timeout: number;
+    warnings: VMWarnings;
+}
+/**
+ * Call frame for stack trace
+ */
+interface CallFrame {
+    functionName: string;
+    file: string;
+    line: number;
+    column: number;
+}
+/**
+ * Error information returned by VM
+ */
+interface ErrorInfo {
+    error: string;
+    type?: string;
+    line?: number;
+    column?: number;
+    file?: string;
+    stack?: string;
+    stackTrace?: CallFrame[];
+}
+
+export type { CallFrame, ErrorInfo, GlobalAPI, MetaFunctions, PlayerAPI, RouterInterface, SceneInterface, StorageInterface, SystemAPI, VMContext, VMWarnings, WarningInfo };