@al8b/vm 0.1.0

package/dist/types/index.d.ts

@@ -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 };

package/dist/types/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types/index.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["/**\n * VM related type definitions\n */\n\n/**\n * Player API exposed to game code - controls player UX\n */\nexport interface PlayerAPI {\n\t/** Pause the game loop */\n\tpause: () => void;\n\t/** Resume the game loop */\n\tresume: () => void;\n\t/** Send a custom message to the host application */\n\tpostMessage: (message: any) => void;\n\t/** Set target update rate (FPS) */\n\tsetFps: (fps: number) => void;\n\t/** Current FPS (read-only) */\n\treadonly fps: number;\n\t/** Target update rate in Hz (read/write) */\n\tupdate_rate: number;\n}\n\n/**\n * System API exposed to game code - system info and utilities\n */\nexport interface SystemAPI {\n\ttime: number;\n\tfps: number;\n\tcpu_load: number;\n\tupdate_rate: number;\n\tlanguage: string;\n\tinputs: {\n\t\tkeyboard: number;\n\t\tmouse: number;\n\t\ttouch: number;\n\t\tgamepad: number;\n\t};\n\tloading?: number;\n\tprompt: (text: string, callback: (result: string) => void) => void;\n\tsay: (text: string) => void;\n\tfile: {\n\t\tdropped: number;\n\t};\n\tjavascript: any;\n\tdisable_autofullscreen?: number;\n\tpreemptive?: number;\n\tthreads?: any[];\n}\n\n/**\n * Storage interface exposed to game code\n */\nexport interface StorageInterface {\n\tset: (name: string, value: unknown) => void;\n\tget: (name: string) => unknown;\n}\n\n/**\n * Scene interface exposed to game code\n */\nexport interface SceneInterface {\n\tregister: (name: string, def: Record<string, unknown>) => void;\n\troute: (path: string, sceneName: string) => void;\n\tgoto: (name: string, params?: Record<string, string>) => void;\n\tcurrent: () => string | null;\n}\n\n/**\n * Router interface exposed to game code\n */\nexport interface RouterInterface {\n\tnavigate: (path: string) => void;\n\tback: () => void;\n\treadonly path: string;\n}\n\n/**\n * Global API exposed to game code\n *\n * Core service fields (screen, audio, keyboard, etc.) use Record<string, any>\n * because they are dynamically populated from different core packages with varying shapes.\n * Helper interfaces above document the expected shape of stable APIs.\n */\nexport interface GlobalAPI {\n\tscreen: Record<string, any>;\n\taudio: Record<string, any>;\n\tkeyboard: Record<string, any>;\n\tmouse: Record<string, any>;\n\ttouch: Record<string, any>;\n\tgamepad: Record<string, any>;\n\tsprites: Record<string, any>;\n\tmaps: Record<string, any>;\n\tsounds: Record<string, any>;\n\tmusic: Record<string, any>;\n\tassets: Record<string, any>;\n\tstorage: Record<string, any>;\n\tscene: Record<string, any>;\n\troute: Record<string, any>;\n\trouter: Record<string, any>;\n\tplayer: Record<string, any>;\n\tsystem: SystemAPI;\n\tfonts?: Record<string, any>;\n\tSound?: any;\n\tImage?: any;\n\tSprite?: any;\n\tTileMap?: any;\n\tPalette?: any;\n\tRandom?: any;\n}\n\n/**\n * Meta functions (built-in functions)\n */\nexport interface MetaFunctions {\n\tprint: (text: any) => void;\n\tround: (x: number) => number;\n\tfloor: (x: number) => number;\n\tceil: (x: number) => number;\n\tabs: (x: number) => number;\n\tmin: (x: number, y: number) => number;\n\tmax: (x: number, y: number) => number;\n\tsqrt: (x: number) => number;\n\tpow: (x: number, y: number) => number;\n\tsin: (x: number) => number;\n\tcos: (x: number) => number;\n\ttan: (x: number) => number;\n\tasin: (x: number) => number;\n\tacos: (x: number) => number;\n\tatan: (x: number) => number;\n\tatan2: (y: number, x: number) => number;\n\tsind: (x: number) => number;\n\tcosd: (x: number) => number;\n\ttand: (x: number) => number;\n\tasind: (x: number) => number;\n\tacosd: (x: number) => number;\n\tatand: (x: number) => number;\n\tatan2d: (y: number, x: number) => number;\n\tlog: (x: number) => number;\n\texp: (x: number) => number;\n\trandom: any;\n\tPI: number;\n\ttrue: number;\n\tfalse: number;\n}\n\n/**\n * Warning info for a specific code location\n */\nexport interface WarningInfo {\n\tfile: string;\n\tline: number;\n\tcolumn: number;\n\texpression?: string;\n\tidentifier?: string;\n\treported?: boolean;\n}\n\n/**\n * Accumulated warnings structure\n */\nexport interface VMWarnings {\n\tusing_undefined_variable: Record<string, WarningInfo>;\n\tassigning_field_to_undefined: Record<string, WarningInfo>;\n\tinvoking_non_function: Record<string, WarningInfo>;\n\tassigning_api_variable: Record<string, WarningInfo>;\n\tassignment_as_condition: Record<string, WarningInfo>;\n}\n\n/**\n * VM Context\n */\nexport interface VMContext {\n\tmeta: MetaFunctions;\n\tglobal: GlobalAPI;\n\tlocal: any;\n\tobject: any;\n\tbreakable: number;\n\tcontinuable: number;\n\treturnable: number;\n\tstack_size: number;\n\ttimeout: number;\n\twarnings: VMWarnings;\n}\n\n/**\n * Call frame for stack trace\n */\nexport interface CallFrame {\n\tfunctionName: string;\n\tfile: string;\n\tline: number;\n\tcolumn: number;\n}\n\n/**\n * Error information returned by VM\n */\nexport interface ErrorInfo {\n\terror: string;\n\ttype?: string;\n\tline?: number;\n\tcolumn?: number;\n\tfile?: string;\n\tstack?: string;\n\tstackTrace?: CallFrame[];\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;;","names":[]}

package/dist/types/index.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=index.mjs.map

package/dist/types/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,38 @@
+{
+	"name": "@al8b/vm",
+	"version": "0.1.0",
+	"sideEffects": false,
+	"files": [
+		"dist/**/*",
+		"README.md",
+		"package.json"
+	],
+	"scripts": {
+		"build": "tsup",
+		"clean": "bun --bun ../../../scripts/clean-package.mjs dist",
+		"test": "vitest run --passWithNoTests"
+	},
+	"main": "./dist/index.js",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.mjs",
+			"require": "./dist/index.js"
+		}
+	},
+	"dependencies": {
+		"@al8b/lootiscript": "workspace:*",
+		"@al8b/io": "workspace:*",
+		"@al8b/framework-shared": "workspace:*"
+	},
+	"keywords": [
+		"vm",
+		"runtime",
+		"lootiscript"
+	],
+	"publishConfig": {
+		"access": "public"
+	}
+}