@al8b/runtime 0.1.0

package/dist/system/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/system/index.ts","../../src/constants.ts","../../src/system/api.ts"],"sourcesContent":["/**\n * System API exports\n */\n\nexport { System } from \"./api\";\n","/** Default frames per second */\nexport const DEFAULT_FPS = 60;\n\n/** Default update rate (updates per second) */\nexport const DEFAULT_UPDATE_RATE = 60;\n\n/** Frame time in milliseconds at 60 FPS */\nexport const FRAME_TIME_MS = 1000 / DEFAULT_FPS;\n\n/** Threshold in ms to detect long pauses (tab switch, etc.) */\nexport const PAUSE_THRESHOLD_MS = 160;\n\n/** Default tile/block size in pixels */\nexport const DEFAULT_BLOCK_SIZE = 16;\n\n/** Minimum interval between loading bar redraws in ms (~60fps) */\nexport const LOADING_BAR_THROTTLE_MS = 16;\n\n/** Timeout in ms for individual asset loads (sprite/map HTTP requests) */\nexport const ASSET_LOAD_TIMEOUT_MS = 30_000;\n","/**\n * System API - System information and control\n */\n\nimport type { SystemAPI } from \"@al8b/vm\";\nimport { DEFAULT_FPS, DEFAULT_UPDATE_RATE } from \"../constants\";\n\nexport class System {\n\tprivate systemAPI: SystemAPI;\n\n\tconstructor() {\n\t\t// Create system API with mutable state\n\t\tthis.systemAPI = {\n\t\t\t// Time\n\t\t\tget time() {\n\t\t\t\treturn Date.now();\n\t\t\t},\n\n\t\t\t// FPS\n\t\t\tfps: DEFAULT_FPS,\n\n\t\t\t// CPU load\n\t\t\tcpu_load: 0,\n\n\t\t\t// Update rate\n\t\t\tupdate_rate: DEFAULT_UPDATE_RATE,\n\n\t\t\t// Language\n\t\t\tget language() {\n\t\t\t\treturn typeof navigator !== \"undefined\" ? navigator.language : \"en\";\n\t\t\t},\n\n\t\t\t// Input availability\n\t\t\tinputs: {\n\t\t\t\tget keyboard() {\n\t\t\t\t\treturn 1;\n\t\t\t\t},\n\t\t\t\tget mouse() {\n\t\t\t\t\treturn 1;\n\t\t\t\t},\n\t\t\t\tget touch() {\n\t\t\t\t\treturn typeof window !== \"undefined\" && \"ontouchstart\" in window ? 1 : 0;\n\t\t\t\t},\n\t\t\t\tget gamepad() {\n\t\t\t\t\treturn typeof navigator !== \"undefined\" && typeof navigator.getGamepads === \"function\" ? 1 : 0;\n\t\t\t\t},\n\t\t\t},\n\n\t\t\t// Loading progress\n\t\t\tloading: 0,\n\n\t\t\t// Utility functions\n\t\t\tprompt: (text: string, callback: (result: string) => void) => {\n\t\t\t\tif (typeof window !== \"undefined\") {\n\t\t\t\t\tconst result = window.prompt(text);\n\t\t\t\t\tif (result !== null && callback) {\n\t\t\t\t\t\tcallback(result);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t},\n\n\t\t\tsay: (text: string) => {\n\t\t\t\tif (typeof window !== \"undefined\") {\n\t\t\t\t\twindow.alert(text);\n\t\t\t\t}\n\t\t\t},\n\n\t\t\t// File drop support\n\t\t\tfile: {\n\t\t\t\tdropped: 0,\n\t\t\t},\n\n\t\t\t// JavaScript interop (placeholder for future use)\n\t\t\tjavascript: {},\n\n\t\t\t// Additional flags\n\t\t\tdisable_autofullscreen: 0,\n\t\t\tpreemptive: 1,\n\t\t};\n\t}\n\n\t/**\n\t * Get system API for game code\n\t */\n\tgetAPI(): SystemAPI {\n\t\treturn this.systemAPI;\n\t}\n\n\t/**\n\t * Update FPS\n\t */\n\tsetFPS(fps: number): void {\n\t\tthis.systemAPI.fps = fps;\n\t}\n\n\t/**\n\t * Update CPU load\n\t */\n\tsetCPULoad(load: number): void {\n\t\tthis.systemAPI.cpu_load = load;\n\t}\n\n\t/**\n\t * Update loading progress\n\t */\n\tsetLoading(progress: number): void {\n\t\tthis.systemAPI.loading = progress;\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;ACCO,IAAMA,cAAc;AAGpB,IAAMC,sBAAsB;AAG5B,IAAMC,gBAAgB,MAAOF;;;ACA7B,IAAMG,SAAN,MAAMA;EAPb,OAOaA;;;EACJC;EAER,cAAc;AAEb,SAAKA,YAAY;;MAEhB,IAAIC,OAAO;AACV,eAAOC,KAAKC,IAAG;MAChB;;MAGAC,KAAKC;;MAGLC,UAAU;;MAGVC,aAAaC;;MAGb,IAAIC,WAAW;AACd,eAAO,OAAOC,cAAc,cAAcA,UAAUD,WAAW;MAChE;;MAGAE,QAAQ;QACP,IAAIC,WAAW;AACd,iBAAO;QACR;QACA,IAAIC,QAAQ;AACX,iBAAO;QACR;QACA,IAAIC,QAAQ;AACX,iBAAO,OAAOC,WAAW,eAAe,kBAAkBA,SAAS,IAAI;QACxE;QACA,IAAIC,UAAU;AACb,iBAAO,OAAON,cAAc,eAAe,OAAOA,UAAUO,gBAAgB,aAAa,IAAI;QAC9F;MACD;;MAGAC,SAAS;;MAGTC,QAAQ,wBAACC,MAAcC,aAAAA;AACtB,YAAI,OAAON,WAAW,aAAa;AAClC,gBAAMO,SAASP,OAAOI,OAAOC,IAAAA;AAC7B,cAAIE,WAAW,QAAQD,UAAU;AAChCA,qBAASC,MAAAA;UACV;QACD;MACD,GAPQ;MASRC,KAAK,wBAACH,SAAAA;AACL,YAAI,OAAOL,WAAW,aAAa;AAClCA,iBAAOS,MAAMJ,IAAAA;QACd;MACD,GAJK;;MAOLK,MAAM;QACLC,SAAS;MACV;;MAGAC,YAAY,CAAC;;MAGbC,wBAAwB;MACxBC,YAAY;IACb;EACD;;;;EAKAC,SAAoB;AACnB,WAAO,KAAK9B;EACb;;;;EAKA+B,OAAO3B,KAAmB;AACzB,SAAKJ,UAAUI,MAAMA;EACtB;;;;EAKA4B,WAAWC,MAAoB;AAC9B,SAAKjC,UAAUM,WAAW2B;EAC3B;;;;EAKAC,WAAWC,UAAwB;AAClC,SAAKnC,UAAUkB,UAAUiB;EAC1B;AACD;","names":["DEFAULT_FPS","DEFAULT_UPDATE_RATE","FRAME_TIME_MS","System","systemAPI","time","Date","now","fps","DEFAULT_FPS","cpu_load","update_rate","DEFAULT_UPDATE_RATE","language","navigator","inputs","keyboard","mouse","touch","window","gamepad","getGamepads","loading","prompt","text","callback","result","say","alert","file","dropped","javascript","disable_autofullscreen","preemptive","getAPI","setFPS","setCPULoad","load","setLoading","progress"]}

package/dist/system/index.mjs

@@ -0,0 +1,101 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/constants.ts
+var DEFAULT_FPS = 60;
+var DEFAULT_UPDATE_RATE = 60;
+var FRAME_TIME_MS = 1e3 / DEFAULT_FPS;
+
+// src/system/api.ts
+var System = class {
+  static {
+    __name(this, "System");
+  }
+  systemAPI;
+  constructor() {
+    this.systemAPI = {
+      // Time
+      get time() {
+        return Date.now();
+      },
+      // FPS
+      fps: DEFAULT_FPS,
+      // CPU load
+      cpu_load: 0,
+      // Update rate
+      update_rate: DEFAULT_UPDATE_RATE,
+      // Language
+      get language() {
+        return typeof navigator !== "undefined" ? navigator.language : "en";
+      },
+      // Input availability
+      inputs: {
+        get keyboard() {
+          return 1;
+        },
+        get mouse() {
+          return 1;
+        },
+        get touch() {
+          return typeof window !== "undefined" && "ontouchstart" in window ? 1 : 0;
+        },
+        get gamepad() {
+          return typeof navigator !== "undefined" && typeof navigator.getGamepads === "function" ? 1 : 0;
+        }
+      },
+      // Loading progress
+      loading: 0,
+      // Utility functions
+      prompt: /* @__PURE__ */ __name((text, callback) => {
+        if (typeof window !== "undefined") {
+          const result = window.prompt(text);
+          if (result !== null && callback) {
+            callback(result);
+          }
+        }
+      }, "prompt"),
+      say: /* @__PURE__ */ __name((text) => {
+        if (typeof window !== "undefined") {
+          window.alert(text);
+        }
+      }, "say"),
+      // File drop support
+      file: {
+        dropped: 0
+      },
+      // JavaScript interop (placeholder for future use)
+      javascript: {},
+      // Additional flags
+      disable_autofullscreen: 0,
+      preemptive: 1
+    };
+  }
+  /**
+  * Get system API for game code
+  */
+  getAPI() {
+    return this.systemAPI;
+  }
+  /**
+  * Update FPS
+  */
+  setFPS(fps) {
+    this.systemAPI.fps = fps;
+  }
+  /**
+  * Update CPU load
+  */
+  setCPULoad(load) {
+    this.systemAPI.cpu_load = load;
+  }
+  /**
+  * Update loading progress
+  */
+  setLoading(progress) {
+    this.systemAPI.loading = progress;
+  }
+};
+export {
+  System
+};
+//# sourceMappingURL=index.mjs.map

package/dist/system/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants.ts","../../src/system/api.ts"],"sourcesContent":["/** Default frames per second */\nexport const DEFAULT_FPS = 60;\n\n/** Default update rate (updates per second) */\nexport const DEFAULT_UPDATE_RATE = 60;\n\n/** Frame time in milliseconds at 60 FPS */\nexport const FRAME_TIME_MS = 1000 / DEFAULT_FPS;\n\n/** Threshold in ms to detect long pauses (tab switch, etc.) */\nexport const PAUSE_THRESHOLD_MS = 160;\n\n/** Default tile/block size in pixels */\nexport const DEFAULT_BLOCK_SIZE = 16;\n\n/** Minimum interval between loading bar redraws in ms (~60fps) */\nexport const LOADING_BAR_THROTTLE_MS = 16;\n\n/** Timeout in ms for individual asset loads (sprite/map HTTP requests) */\nexport const ASSET_LOAD_TIMEOUT_MS = 30_000;\n","/**\n * System API - System information and control\n */\n\nimport type { SystemAPI } from \"@al8b/vm\";\nimport { DEFAULT_FPS, DEFAULT_UPDATE_RATE } from \"../constants\";\n\nexport class System {\n\tprivate systemAPI: SystemAPI;\n\n\tconstructor() {\n\t\t// Create system API with mutable state\n\t\tthis.systemAPI = {\n\t\t\t// Time\n\t\t\tget time() {\n\t\t\t\treturn Date.now();\n\t\t\t},\n\n\t\t\t// FPS\n\t\t\tfps: DEFAULT_FPS,\n\n\t\t\t// CPU load\n\t\t\tcpu_load: 0,\n\n\t\t\t// Update rate\n\t\t\tupdate_rate: DEFAULT_UPDATE_RATE,\n\n\t\t\t// Language\n\t\t\tget language() {\n\t\t\t\treturn typeof navigator !== \"undefined\" ? navigator.language : \"en\";\n\t\t\t},\n\n\t\t\t// Input availability\n\t\t\tinputs: {\n\t\t\t\tget keyboard() {\n\t\t\t\t\treturn 1;\n\t\t\t\t},\n\t\t\t\tget mouse() {\n\t\t\t\t\treturn 1;\n\t\t\t\t},\n\t\t\t\tget touch() {\n\t\t\t\t\treturn typeof window !== \"undefined\" && \"ontouchstart\" in window ? 1 : 0;\n\t\t\t\t},\n\t\t\t\tget gamepad() {\n\t\t\t\t\treturn typeof navigator !== \"undefined\" && typeof navigator.getGamepads === \"function\" ? 1 : 0;\n\t\t\t\t},\n\t\t\t},\n\n\t\t\t// Loading progress\n\t\t\tloading: 0,\n\n\t\t\t// Utility functions\n\t\t\tprompt: (text: string, callback: (result: string) => void) => {\n\t\t\t\tif (typeof window !== \"undefined\") {\n\t\t\t\t\tconst result = window.prompt(text);\n\t\t\t\t\tif (result !== null && callback) {\n\t\t\t\t\t\tcallback(result);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t},\n\n\t\t\tsay: (text: string) => {\n\t\t\t\tif (typeof window !== \"undefined\") {\n\t\t\t\t\twindow.alert(text);\n\t\t\t\t}\n\t\t\t},\n\n\t\t\t// File drop support\n\t\t\tfile: {\n\t\t\t\tdropped: 0,\n\t\t\t},\n\n\t\t\t// JavaScript interop (placeholder for future use)\n\t\t\tjavascript: {},\n\n\t\t\t// Additional flags\n\t\t\tdisable_autofullscreen: 0,\n\t\t\tpreemptive: 1,\n\t\t};\n\t}\n\n\t/**\n\t * Get system API for game code\n\t */\n\tgetAPI(): SystemAPI {\n\t\treturn this.systemAPI;\n\t}\n\n\t/**\n\t * Update FPS\n\t */\n\tsetFPS(fps: number): void {\n\t\tthis.systemAPI.fps = fps;\n\t}\n\n\t/**\n\t * Update CPU load\n\t */\n\tsetCPULoad(load: number): void {\n\t\tthis.systemAPI.cpu_load = load;\n\t}\n\n\t/**\n\t * Update loading progress\n\t */\n\tsetLoading(progress: number): void {\n\t\tthis.systemAPI.loading = progress;\n\t}\n}\n"],"mappings":";;;;AACO,IAAMA,cAAc;AAGpB,IAAMC,sBAAsB;AAG5B,IAAMC,gBAAgB,MAAOF;;;ACA7B,IAAMG,SAAN,MAAMA;EAPb,OAOaA;;;EACJC;EAER,cAAc;AAEb,SAAKA,YAAY;;MAEhB,IAAIC,OAAO;AACV,eAAOC,KAAKC,IAAG;MAChB;;MAGAC,KAAKC;;MAGLC,UAAU;;MAGVC,aAAaC;;MAGb,IAAIC,WAAW;AACd,eAAO,OAAOC,cAAc,cAAcA,UAAUD,WAAW;MAChE;;MAGAE,QAAQ;QACP,IAAIC,WAAW;AACd,iBAAO;QACR;QACA,IAAIC,QAAQ;AACX,iBAAO;QACR;QACA,IAAIC,QAAQ;AACX,iBAAO,OAAOC,WAAW,eAAe,kBAAkBA,SAAS,IAAI;QACxE;QACA,IAAIC,UAAU;AACb,iBAAO,OAAON,cAAc,eAAe,OAAOA,UAAUO,gBAAgB,aAAa,IAAI;QAC9F;MACD;;MAGAC,SAAS;;MAGTC,QAAQ,wBAACC,MAAcC,aAAAA;AACtB,YAAI,OAAON,WAAW,aAAa;AAClC,gBAAMO,SAASP,OAAOI,OAAOC,IAAAA;AAC7B,cAAIE,WAAW,QAAQD,UAAU;AAChCA,qBAASC,MAAAA;UACV;QACD;MACD,GAPQ;MASRC,KAAK,wBAACH,SAAAA;AACL,YAAI,OAAOL,WAAW,aAAa;AAClCA,iBAAOS,MAAMJ,IAAAA;QACd;MACD,GAJK;;MAOLK,MAAM;QACLC,SAAS;MACV;;MAGAC,YAAY,CAAC;;MAGbC,wBAAwB;MACxBC,YAAY;IACb;EACD;;;;EAKAC,SAAoB;AACnB,WAAO,KAAK9B;EACb;;;;EAKA+B,OAAO3B,KAAmB;AACzB,SAAKJ,UAAUI,MAAMA;EACtB;;;;EAKA4B,WAAWC,MAAoB;AAC9B,SAAKjC,UAAUM,WAAW2B;EAC3B;;;;EAKAC,WAAWC,UAAwB;AAClC,SAAKnC,UAAUkB,UAAUiB;EAC1B;AACD;","names":["DEFAULT_FPS","DEFAULT_UPDATE_RATE","FRAME_TIME_MS","System","systemAPI","time","Date","now","fps","DEFAULT_FPS","cpu_load","update_rate","DEFAULT_UPDATE_RATE","language","navigator","inputs","keyboard","mouse","touch","window","gamepad","getGamepads","loading","prompt","text","callback","result","say","alert","file","dropped","javascript","disable_autofullscreen","preemptive","getAPI","setFPS","setCPULoad","load","setLoading","progress"]}

package/dist/types/assets.d.mts

@@ -0,0 +1,43 @@
+/**
+ * Asset type definitions
+ */
+/**
+ * Resources metadata
+ */
+interface Resources {
+    /** Image/sprite resources */
+    images?: ResourceFile[];
+    /** Map resources */
+    maps?: ResourceFile[];
+    /** Sound resources */
+    sounds?: ResourceFile[];
+    /** Music resources */
+    music?: ResourceFile[];
+    /** Generic asset resources */
+    assets?: ResourceFile[];
+    /** Source code files */
+    sources?: ResourceFile[];
+}
+/**
+ * Resource file metadata
+ */
+interface ResourceFile {
+    /** File name */
+    file: string;
+    /** Version/hash for cache busting */
+    version?: string | number;
+    /** Additional properties (for sprites, etc) */
+    properties?: any;
+}
+/**
+ * Asset collections
+ */
+interface AssetCollections {
+    sprites: Record<string, any>;
+    maps: Record<string, any>;
+    sounds: Record<string, any>;
+    music: Record<string, any>;
+    assets: Record<string, any>;
+}
+
+export type { AssetCollections, ResourceFile, Resources };

package/dist/types/assets.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Asset type definitions
+ */
+/**
+ * Resources metadata
+ */
+interface Resources {
+    /** Image/sprite resources */
+    images?: ResourceFile[];
+    /** Map resources */
+    maps?: ResourceFile[];
+    /** Sound resources */
+    sounds?: ResourceFile[];
+    /** Music resources */
+    music?: ResourceFile[];
+    /** Generic asset resources */
+    assets?: ResourceFile[];
+    /** Source code files */
+    sources?: ResourceFile[];
+}
+/**
+ * Resource file metadata
+ */
+interface ResourceFile {
+    /** File name */
+    file: string;
+    /** Version/hash for cache busting */
+    version?: string | number;
+    /** Additional properties (for sprites, etc) */
+    properties?: any;
+}
+/**
+ * Asset collections
+ */
+interface AssetCollections {
+    sprites: Record<string, any>;
+    maps: Record<string, any>;
+    sounds: Record<string, any>;
+    music: Record<string, any>;
+    assets: Record<string, any>;
+}
+
+export type { AssetCollections, ResourceFile, Resources };

package/dist/types/assets.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/assets.ts
+var assets_exports = {};
+module.exports = __toCommonJS(assets_exports);
+//# sourceMappingURL=assets.js.map

package/dist/types/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/assets.ts"],"sourcesContent":["/**\n * Asset type definitions\n */\n\n/**\n * Resources metadata\n */\nexport interface Resources {\n\t/** Image/sprite resources */\n\timages?: ResourceFile[];\n\t/** Map resources */\n\tmaps?: ResourceFile[];\n\t/** Sound resources */\n\tsounds?: ResourceFile[];\n\t/** Music resources */\n\tmusic?: ResourceFile[];\n\t/** Generic asset resources */\n\tassets?: ResourceFile[];\n\t/** Source code files */\n\tsources?: ResourceFile[];\n}\n\n/**\n * Resource file metadata\n */\nexport interface ResourceFile {\n\t/** File name */\n\tfile: string;\n\t/** Version/hash for cache busting */\n\tversion?: string | number;\n\t/** Additional properties (for sprites, etc) */\n\tproperties?: any;\n}\n\n/**\n * Asset collections\n */\nexport interface AssetCollections {\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}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;;","names":[]}

package/dist/types/assets.mjs

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

package/dist/types/assets.mjs.map

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

package/dist/types/bridge.d.mts

@@ -0,0 +1,66 @@
+import { StateSnapshot } from '@al8b/time';
+
+type HostEventSource = "host" | "backend" | "realtime";
+interface HostEvent {
+    type: string;
+    payload?: unknown;
+    requestId?: string;
+    source?: HostEventSource;
+}
+interface RuntimeSessionSnapshot {
+    user?: {
+        id: string;
+        displayName?: string;
+        roles?: string[];
+        metadata?: Record<string, unknown>;
+    } | null;
+    player?: {
+        id: string;
+        name?: string;
+        slot?: string;
+        metadata?: Record<string, unknown>;
+    } | null;
+    game?: {
+        id: string;
+        slug?: string;
+        version?: string;
+    } | null;
+    room?: {
+        id: string;
+        role?: string;
+        metadata?: Record<string, unknown>;
+    } | null;
+}
+interface RuntimeSnapshotMeta {
+    slot?: string;
+    label?: string;
+    metadata?: Record<string, unknown>;
+}
+interface RuntimeSnapshot {
+    version: 1;
+    global: StateSnapshot;
+    session: RuntimeSessionSnapshot | null;
+    router: {
+        path: string;
+        sceneName: string | null;
+    };
+    system: {
+        updateRate: number;
+    };
+}
+interface RuntimeResetOptions {
+    preserveStorage?: boolean;
+    preserveSession?: boolean;
+    preserveSnapshot?: boolean;
+    reinitializeSources?: boolean;
+}
+interface RuntimeBridge {
+    request?<TResponse = unknown>(name: string, payload?: unknown): Promise<TResponse> | TResponse;
+    emit?(name: string, payload?: unknown): void;
+    subscribe?(handler: (event: HostEvent) => void): (() => void) | void;
+    getSession?(): Promise<RuntimeSessionSnapshot | null> | RuntimeSessionSnapshot | null;
+    saveSnapshot?(snapshot: RuntimeSnapshot, meta?: RuntimeSnapshotMeta): Promise<void> | void;
+    loadSnapshot?(meta?: RuntimeSnapshotMeta): Promise<RuntimeSnapshot | null> | RuntimeSnapshot | null;
+}
+
+export type { HostEvent, HostEventSource, RuntimeBridge, RuntimeResetOptions, RuntimeSessionSnapshot, RuntimeSnapshot, RuntimeSnapshotMeta };

package/dist/types/bridge.d.ts

@@ -0,0 +1,66 @@
+import { StateSnapshot } from '@al8b/time';
+
+type HostEventSource = "host" | "backend" | "realtime";
+interface HostEvent {
+    type: string;
+    payload?: unknown;
+    requestId?: string;
+    source?: HostEventSource;
+}
+interface RuntimeSessionSnapshot {
+    user?: {
+        id: string;
+        displayName?: string;
+        roles?: string[];
+        metadata?: Record<string, unknown>;
+    } | null;
+    player?: {
+        id: string;
+        name?: string;
+        slot?: string;
+        metadata?: Record<string, unknown>;
+    } | null;
+    game?: {
+        id: string;
+        slug?: string;
+        version?: string;
+    } | null;
+    room?: {
+        id: string;
+        role?: string;
+        metadata?: Record<string, unknown>;
+    } | null;
+}
+interface RuntimeSnapshotMeta {
+    slot?: string;
+    label?: string;
+    metadata?: Record<string, unknown>;
+}
+interface RuntimeSnapshot {
+    version: 1;
+    global: StateSnapshot;
+    session: RuntimeSessionSnapshot | null;
+    router: {
+        path: string;
+        sceneName: string | null;
+    };
+    system: {
+        updateRate: number;
+    };
+}
+interface RuntimeResetOptions {
+    preserveStorage?: boolean;
+    preserveSession?: boolean;
+    preserveSnapshot?: boolean;
+    reinitializeSources?: boolean;
+}
+interface RuntimeBridge {
+    request?<TResponse = unknown>(name: string, payload?: unknown): Promise<TResponse> | TResponse;
+    emit?(name: string, payload?: unknown): void;
+    subscribe?(handler: (event: HostEvent) => void): (() => void) | void;
+    getSession?(): Promise<RuntimeSessionSnapshot | null> | RuntimeSessionSnapshot | null;
+    saveSnapshot?(snapshot: RuntimeSnapshot, meta?: RuntimeSnapshotMeta): Promise<void> | void;
+    loadSnapshot?(meta?: RuntimeSnapshotMeta): Promise<RuntimeSnapshot | null> | RuntimeSnapshot | null;
+}
+
+export type { HostEvent, HostEventSource, RuntimeBridge, RuntimeResetOptions, RuntimeSessionSnapshot, RuntimeSnapshot, RuntimeSnapshotMeta };

package/dist/types/bridge.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/bridge.ts
+var bridge_exports = {};
+module.exports = __toCommonJS(bridge_exports);
+//# sourceMappingURL=bridge.js.map

package/dist/types/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/bridge.ts"],"sourcesContent":["import type { StateSnapshot } from \"@al8b/time\";\n\nexport type HostEventSource = \"host\" | \"backend\" | \"realtime\";\n\nexport interface HostEvent {\n\ttype: string;\n\tpayload?: unknown;\n\trequestId?: string;\n\tsource?: HostEventSource;\n}\n\nexport interface RuntimeSessionSnapshot {\n\tuser?: {\n\t\tid: string;\n\t\tdisplayName?: string;\n\t\troles?: string[];\n\t\tmetadata?: Record<string, unknown>;\n\t} | null;\n\tplayer?: {\n\t\tid: string;\n\t\tname?: string;\n\t\tslot?: string;\n\t\tmetadata?: Record<string, unknown>;\n\t} | null;\n\tgame?: {\n\t\tid: string;\n\t\tslug?: string;\n\t\tversion?: string;\n\t} | null;\n\troom?: {\n\t\tid: string;\n\t\trole?: string;\n\t\tmetadata?: Record<string, unknown>;\n\t} | null;\n}\n\nexport interface RuntimeSnapshotMeta {\n\tslot?: string;\n\tlabel?: string;\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface RuntimeSnapshot {\n\tversion: 1;\n\tglobal: StateSnapshot;\n\tsession: RuntimeSessionSnapshot | null;\n\trouter: {\n\t\tpath: string;\n\t\tsceneName: string | null;\n\t};\n\tsystem: {\n\t\tupdateRate: number;\n\t};\n}\n\nexport interface RuntimeResetOptions {\n\tpreserveStorage?: boolean;\n\tpreserveSession?: boolean;\n\tpreserveSnapshot?: boolean;\n\treinitializeSources?: boolean;\n}\n\nexport interface RuntimeBridge {\n\trequest?<TResponse = unknown>(name: string, payload?: unknown): Promise<TResponse> | TResponse;\n\temit?(name: string, payload?: unknown): void;\n\tsubscribe?(handler: (event: HostEvent) => void): (() => void) | void;\n\tgetSession?(): Promise<RuntimeSessionSnapshot | null> | RuntimeSessionSnapshot | null;\n\tsaveSnapshot?(snapshot: RuntimeSnapshot, meta?: RuntimeSnapshotMeta): Promise<void> | void;\n\tloadSnapshot?(meta?: RuntimeSnapshotMeta): Promise<RuntimeSnapshot | null> | RuntimeSnapshot | null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA8DA;;","names":[]}

package/dist/types/bridge.mjs

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

package/dist/types/bridge.mjs.map

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

package/dist/types/index.d.mts

@@ -0,0 +1,6 @@
+export { AssetCollections, ResourceFile, Resources } from './assets.mjs';
+export { InputDebugSetting, RuntimeDebugOptions, RuntimeListener, RuntimeOptions } from './runtime.mjs';
+export { HostEvent, HostEventSource, RuntimeBridge, RuntimeResetOptions, RuntimeSessionSnapshot, RuntimeSnapshot, RuntimeSnapshotMeta } from './bridge.mjs';
+export { ErrorInfo, GlobalAPI, MetaFunctions, SystemAPI, VMContext, VMWarnings, WarningInfo } from '@al8b/vm';
+import '@al8b/framework-shared';
+import '@al8b/time';

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export { AssetCollections, ResourceFile, Resources } from './assets.js';
+export { InputDebugSetting, RuntimeDebugOptions, RuntimeListener, RuntimeOptions } from './runtime.js';
+export { HostEvent, HostEventSource, RuntimeBridge, RuntimeResetOptions, RuntimeSessionSnapshot, RuntimeSnapshot, RuntimeSnapshotMeta } from './bridge.js';
+export { ErrorInfo, GlobalAPI, MetaFunctions, SystemAPI, VMContext, VMWarnings, WarningInfo } from '@al8b/vm';
+import '@al8b/framework-shared';
+import '@al8b/time';

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 * Type definitions for @al8b/runtime\n */\n\nexport type {\n\tAssetCollections,\n\tResourceFile,\n\tResources,\n} from \"./assets\";\nexport type {\n\tErrorInfo,\n\tInputDebugSetting,\n\tRuntimeDebugOptions,\n\tRuntimeListener,\n\tRuntimeOptions,\n} from \"./runtime\";\nexport type {\n\tHostEvent,\n\tHostEventSource,\n\tRuntimeBridge,\n\tRuntimeResetOptions,\n\tRuntimeSessionSnapshot,\n\tRuntimeSnapshot,\n\tRuntimeSnapshotMeta,\n} from \"./bridge\";\nexport type { GlobalAPI, MetaFunctions, SystemAPI, VMContext, VMWarnings, WarningInfo } from \"./vm\";\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/dist/types/runtime.d.mts

@@ -0,0 +1,71 @@
+import { Resources } from './assets.mjs';
+import { CompiledModuleArtifact, SerializedRoutineData } from '@al8b/framework-shared';
+import { ErrorInfo } from '@al8b/vm';
+export { ErrorInfo } from '@al8b/vm';
+import { RuntimeBridge, RuntimeSessionSnapshot } from './bridge.mjs';
+import '@al8b/time';
+
+/**
+ * Runtime type definitions
+ */
+
+/**
+ * Runtime configuration options
+ */
+type InputDebugSetting = boolean | {
+    keyboard?: boolean;
+    mouse?: boolean;
+    touch?: boolean;
+    gamepad?: boolean;
+};
+interface RuntimeDebugOptions {
+    /** Input debug logging configuration */
+    input?: InputDebugSetting;
+    /** Log screen/canvas state changes */
+    screen?: boolean;
+    /** Detailed lifecycle logs for runtime startup and control */
+    lifecycle?: boolean;
+}
+interface RuntimeOptions {
+    /** Base URL for loading assets */
+    url?: string;
+    /** Source code files (for development) */
+    sources?: Record<string, string>;
+    /** Pre-compiled routines (for production) */
+    compiledRoutines?: Record<string, CompiledModuleArtifact | SerializedRoutineData>;
+    /** Resources metadata */
+    resources?: Resources;
+    /** Environment variables (key-value pairs) */
+    env?: Record<string, string>;
+    /** Listener for events (logging, errors) */
+    listener?: RuntimeListener;
+    /** Host bridge for platform and backend integrations */
+    bridge?: RuntimeBridge;
+    /** Initial session context supplied by the host */
+    initialSession?: RuntimeSessionSnapshot | null;
+    /** Canvas element to use */
+    canvas?: HTMLCanvasElement;
+    /** Screen width */
+    width?: number;
+    /** Screen height */
+    height?: number;
+    /** Namespace for localStorage */
+    namespace?: string;
+    /** Preserve localStorage on reset */
+    preserveStorage?: boolean;
+    /** Debug toggles */
+    debug?: RuntimeDebugOptions;
+}
+/**
+ * Runtime listener for events
+ */
+interface RuntimeListener {
+    /** Log message */
+    log?: (message: string) => void;
+    /** Report error */
+    reportError?: (error: ErrorInfo) => void;
+    /** Code paused (system.pause called) */
+    codePaused?: () => void;
+}
+
+export { type InputDebugSetting, Resources, type RuntimeDebugOptions, type RuntimeListener, type RuntimeOptions };

package/dist/types/runtime.d.ts

@@ -0,0 +1,71 @@
+import { Resources } from './assets.js';
+import { CompiledModuleArtifact, SerializedRoutineData } from '@al8b/framework-shared';
+import { ErrorInfo } from '@al8b/vm';
+export { ErrorInfo } from '@al8b/vm';
+import { RuntimeBridge, RuntimeSessionSnapshot } from './bridge.js';
+import '@al8b/time';
+
+/**
+ * Runtime type definitions
+ */
+
+/**
+ * Runtime configuration options
+ */
+type InputDebugSetting = boolean | {
+    keyboard?: boolean;
+    mouse?: boolean;
+    touch?: boolean;
+    gamepad?: boolean;
+};
+interface RuntimeDebugOptions {
+    /** Input debug logging configuration */
+    input?: InputDebugSetting;
+    /** Log screen/canvas state changes */
+    screen?: boolean;
+    /** Detailed lifecycle logs for runtime startup and control */
+    lifecycle?: boolean;
+}
+interface RuntimeOptions {
+    /** Base URL for loading assets */
+    url?: string;
+    /** Source code files (for development) */
+    sources?: Record<string, string>;
+    /** Pre-compiled routines (for production) */
+    compiledRoutines?: Record<string, CompiledModuleArtifact | SerializedRoutineData>;
+    /** Resources metadata */
+    resources?: Resources;
+    /** Environment variables (key-value pairs) */
+    env?: Record<string, string>;
+    /** Listener for events (logging, errors) */
+    listener?: RuntimeListener;
+    /** Host bridge for platform and backend integrations */
+    bridge?: RuntimeBridge;
+    /** Initial session context supplied by the host */
+    initialSession?: RuntimeSessionSnapshot | null;
+    /** Canvas element to use */
+    canvas?: HTMLCanvasElement;
+    /** Screen width */
+    width?: number;
+    /** Screen height */
+    height?: number;
+    /** Namespace for localStorage */
+    namespace?: string;
+    /** Preserve localStorage on reset */
+    preserveStorage?: boolean;
+    /** Debug toggles */
+    debug?: RuntimeDebugOptions;
+}
+/**
+ * Runtime listener for events
+ */
+interface RuntimeListener {
+    /** Log message */
+    log?: (message: string) => void;
+    /** Report error */
+    reportError?: (error: ErrorInfo) => void;
+    /** Code paused (system.pause called) */
+    codePaused?: () => void;
+}
+
+export { type InputDebugSetting, Resources, type RuntimeDebugOptions, type RuntimeListener, type RuntimeOptions };

package/dist/types/runtime.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/runtime.ts
+var runtime_exports = {};
+module.exports = __toCommonJS(runtime_exports);
+//# sourceMappingURL=runtime.js.map

package/dist/types/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/runtime.ts"],"sourcesContent":["/**\n * Runtime type definitions\n */\n\nimport type { CompiledModuleArtifact, SerializedRoutineData } from \"@al8b/framework-shared\";\nimport type { ErrorInfo } from \"@al8b/vm\";\nimport type { Resources } from \"./assets\";\nimport type { RuntimeBridge, RuntimeSessionSnapshot } from \"./bridge\";\n\nexport type { ErrorInfo, Resources };\n\n/**\n * Runtime configuration options\n */\nexport type InputDebugSetting =\n\t| boolean\n\t| {\n\t\t\tkeyboard?: boolean;\n\t\t\tmouse?: boolean;\n\t\t\ttouch?: boolean;\n\t\t\tgamepad?: boolean;\n\t  };\n\nexport interface RuntimeDebugOptions {\n\t/** Input debug logging configuration */\n\tinput?: InputDebugSetting;\n\t/** Log screen/canvas state changes */\n\tscreen?: boolean;\n\t/** Detailed lifecycle logs for runtime startup and control */\n\tlifecycle?: boolean;\n}\n\nexport interface RuntimeOptions {\n\t/** Base URL for loading assets */\n\turl?: string;\n\t/** Source code files (for development) */\n\tsources?: Record<string, string>;\n\t/** Pre-compiled routines (for production) */\n\tcompiledRoutines?: Record<string, CompiledModuleArtifact | SerializedRoutineData>;\n\t/** Resources metadata */\n\tresources?: Resources;\n\t/** Environment variables (key-value pairs) */\n\tenv?: Record<string, string>;\n\t/** Listener for events (logging, errors) */\n\tlistener?: RuntimeListener;\n\t/** Host bridge for platform and backend integrations */\n\tbridge?: RuntimeBridge;\n\t/** Initial session context supplied by the host */\n\tinitialSession?: RuntimeSessionSnapshot | null;\n\t/** Canvas element to use */\n\tcanvas?: HTMLCanvasElement;\n\t/** Screen width */\n\twidth?: number;\n\t/** Screen height */\n\theight?: number;\n\t/** Namespace for localStorage */\n\tnamespace?: string;\n\t/** Preserve localStorage on reset */\n\tpreserveStorage?: boolean;\n\t/** Debug toggles */\n\tdebug?: RuntimeDebugOptions;\n}\n\n/**\n * Runtime listener for events\n */\nexport interface RuntimeListener {\n\t/** Log message */\n\tlog?: (message: string) => void;\n\t/** Report error */\n\treportError?: (error: ErrorInfo) => void;\n\t/** Code paused (system.pause called) */\n\tcodePaused?: () => void;\n}\n\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;;","names":[]}

package/dist/types/runtime.mjs

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

package/dist/types/runtime.mjs.map

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

package/dist/types/vm.d.mts

@@ -0,0 +1 @@
+export { ErrorInfo, GlobalAPI, MetaFunctions, SystemAPI, VMContext, VMWarnings, WarningInfo } from '@al8b/vm';

package/dist/types/vm.d.ts

@@ -0,0 +1 @@
+export { ErrorInfo, GlobalAPI, MetaFunctions, SystemAPI, VMContext, VMWarnings, WarningInfo } from '@al8b/vm';