@al8b/runtime 0.1.0

package/dist/core/api-factory.mjs

@@ -0,0 +1,214 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/core/api-factory.ts
+import { Palette } from "@al8b/palette";
+import { Random, Routine } from "@al8b/vm";
+
+// src/assets/constructors.ts
+import { Sound } from "@al8b/audio";
+import { TileMap } from "@al8b/map";
+import { Image } from "@al8b/image";
+import { Sprite } from "@al8b/sprites";
+
+// src/utils/object-pool.ts
+var ObjectPool = class {
+  static {
+    __name(this, "ObjectPool");
+  }
+  pool = [];
+  factory;
+  reset;
+  maxSize;
+  /**
+  * Create a new object pool
+  *
+  * @param factory - Function to create new objects
+  * @param reset - Function to reset object state for reuse
+  * @param maxSize - Maximum pool size (default: 100)
+  */
+  constructor(factory, reset, maxSize = 100) {
+    this.factory = factory;
+    this.reset = reset;
+    this.maxSize = maxSize;
+  }
+  /**
+  * Acquire an object from the pool
+  *
+  * Returns a new object if pool is empty, otherwise reuses a pooled object.
+  *
+  * @returns Object from pool or newly created
+  */
+  acquire() {
+    if (this.pool.length > 0) {
+      return this.pool.pop();
+    }
+    return this.factory();
+  }
+  /**
+  * Release an object back to the pool
+  *
+  * Resets the object and adds it back to the pool for reuse.
+  * If pool is at max size, the object is discarded.
+  *
+  * @param obj - Object to release
+  */
+  release(obj) {
+    if (this.pool.length >= this.maxSize) {
+      return;
+    }
+    this.reset(obj);
+    this.pool.push(obj);
+  }
+  /**
+  * Clear all objects from the pool
+  */
+  clear() {
+    this.pool = [];
+  }
+  /**
+  * Get current pool size
+  *
+  * @returns Number of objects in pool
+  */
+  size() {
+    return this.pool.length;
+  }
+  /**
+  * Get maximum pool size
+  *
+  * @returns Maximum pool size
+  */
+  getMaxSize() {
+    return this.maxSize;
+  }
+  /**
+  * Set maximum pool size
+  *
+  * @param maxSize - New maximum pool size
+  */
+  setMaxSize(maxSize) {
+    this.maxSize = maxSize;
+    if (this.pool.length > maxSize) {
+      this.pool = this.pool.slice(0, maxSize);
+    }
+  }
+};
+
+// src/core/api-factory.ts
+function createRuntimeMeta(context) {
+  return {
+    print: /* @__PURE__ */ __name((text) => {
+      const vm = context.getVM();
+      if ((typeof text === "object" || typeof text === "function") && vm) {
+        text = vm.toString(text);
+      }
+      if (context.listener.log) {
+        context.listener.log(String(text));
+      } else {
+        console.log(text);
+      }
+    }, "print")
+  };
+}
+__name(createRuntimeMeta, "createRuntimeMeta");
+function createRuntimeGlobalApi(context) {
+  const inputStates = context.input.getStates();
+  const session = {
+    user: /* @__PURE__ */ __name(() => cloneValue(context.getSessionSnapshot()?.user ?? null), "user"),
+    player: /* @__PURE__ */ __name(() => cloneValue(context.getSessionSnapshot()?.player ?? null), "player"),
+    game: /* @__PURE__ */ __name(() => cloneValue(context.getSessionSnapshot()?.game ?? null), "game"),
+    room: /* @__PURE__ */ __name(() => cloneValue(context.getSessionSnapshot()?.room ?? null), "room")
+  };
+  const host = {
+    emit: /* @__PURE__ */ __name((name, payload) => {
+      context.sendHostEvent({
+        type: name,
+        payload,
+        source: "host"
+      });
+    }, "emit"),
+    request: /* @__PURE__ */ __name((name, payload, callback) => context.sendHostRequest(name, payload, callback), "request")
+  };
+  const memory = {
+    export: /* @__PURE__ */ __name(() => context.exportSnapshot(), "export"),
+    import: /* @__PURE__ */ __name((snapshot) => context.importSnapshot(snapshot), "import"),
+    reset: /* @__PURE__ */ __name((options) => context.resetRuntime(options), "reset"),
+    save: /* @__PURE__ */ __name((meta, callback) => context.saveSnapshot(meta, callback), "save"),
+    load: /* @__PURE__ */ __name((meta, callback) => context.loadSnapshot(meta, callback), "load")
+  };
+  return {
+    screen: context.screen.getInterface(),
+    audio: context.audio.getInterface(),
+    keyboard: inputStates.keyboard,
+    mouse: inputStates.mouse,
+    touch: inputStates.touch,
+    gamepad: inputStates.gamepad,
+    sprites: context.assets.sprites,
+    maps: context.assets.maps,
+    sounds: context.assets.sounds,
+    music: context.assets.music,
+    assets: context.assets.assets,
+    player: context.playerService.getInterface(),
+    host,
+    session,
+    memory,
+    system: context.system.getAPI(),
+    scene: /* @__PURE__ */ __name((name, definition) => {
+      const convertedDefinition = convertSceneDefinition(asSceneDefinition(definition), context.getVM(), context.listener);
+      context.sceneManager.registerScene(name, convertedDefinition);
+    }, "scene"),
+    route: /* @__PURE__ */ __name((path, sceneName) => context.sceneManager.registerRoute(path, sceneName), "route"),
+    router: context.sceneManager.router.getInterface(),
+    Image,
+    Sprite,
+    TileMap,
+    Sound,
+    Palette,
+    Random,
+    ObjectPool
+  };
+}
+__name(createRuntimeGlobalApi, "createRuntimeGlobalApi");
+function convertSceneDefinition(definition, vm, listener) {
+  if (!vm?.runner?.main_thread?.processor) {
+    listener.log?.("[RuntimeController] VM not ready for scene conversion. Scene functions may not work correctly.");
+    return definition;
+  }
+  const processor = vm.runner.main_thread.processor;
+  const context = vm.context;
+  const converted = {};
+  for (const [key, value] of Object.entries(definition)) {
+    if (value instanceof Routine) {
+      converted[key] = processor.routineAsFunction(value, context);
+      continue;
+    }
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+      converted[key] = convertSceneDefinition(value, vm, listener);
+      continue;
+    }
+    converted[key] = value;
+  }
+  return converted;
+}
+__name(convertSceneDefinition, "convertSceneDefinition");
+function asSceneDefinition(definition) {
+  if (!definition || typeof definition !== "object" || Array.isArray(definition)) {
+    throw new Error("Scene definition must be an object.");
+  }
+  return definition;
+}
+__name(asSceneDefinition, "asSceneDefinition");
+function cloneValue(value) {
+  if (value == null) {
+    return value;
+  }
+  return JSON.parse(JSON.stringify(value));
+}
+__name(cloneValue, "cloneValue");
+export {
+  convertSceneDefinition,
+  createRuntimeGlobalApi,
+  createRuntimeMeta
+};
+//# sourceMappingURL=api-factory.mjs.map

package/dist/core/api-factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/api-factory.ts","../../src/assets/constructors.ts","../../src/utils/object-pool.ts"],"sourcesContent":["import { Palette } from \"@al8b/palette\";\nimport type { SceneDefinition, SceneManager } from \"@al8b/scene\";\nimport { type GlobalAPI, type L8BVM, type MetaFunctions, Random, Routine } from \"@al8b/vm\";\nimport { Image, Sound, Sprite, TileMap } from \"../assets\";\nimport type { InputManager } from \"../input\";\nimport type {\n\tHostEvent,\n\tRuntimeBridge,\n\tRuntimeListener,\n\tRuntimeOptions,\n\tRuntimeResetOptions,\n\tRuntimeSessionSnapshot,\n\tRuntimeSnapshot,\n\tRuntimeSnapshotMeta,\n} from \"../types\";\nimport { ObjectPool } from \"../utils/object-pool\";\nimport type { PlayerService } from \"@al8b/player\";\nimport type { RuntimeAssetsRegistry } from \"./assets-registry\";\nimport type { Screen } from \"@al8b/screen\";\nimport type { AudioCore } from \"@al8b/audio\";\nimport type { System } from \"../system\";\n\nexport interface RuntimeApiFactoryContext {\n\tlistener: RuntimeListener;\n\toptions: RuntimeOptions;\n\tscreen: Screen;\n\taudio: AudioCore;\n\tinput: InputManager;\n\tsystem: System;\n\tplayerService: PlayerService;\n\tsceneManager: SceneManager;\n\tassets: RuntimeAssetsRegistry;\n\tbridge?: RuntimeBridge;\n\tgetVM: () => L8BVM | null;\n\tgetSessionSnapshot: () => RuntimeSessionSnapshot | null;\n\tsendHostEvent: (event: HostEvent) => void;\n\tsendHostRequest: (name: string, payload?: unknown, callback?: (result: unknown) => void) => string | null;\n\texportSnapshot: () => RuntimeSnapshot;\n\timportSnapshot: (snapshot: RuntimeSnapshot) => Promise<void>;\n\tresetRuntime: (options?: RuntimeResetOptions) => Promise<void>;\n\tsaveSnapshot: (meta?: RuntimeSnapshotMeta, callback?: (result: unknown) => void) => unknown;\n\tloadSnapshot: (meta?: RuntimeSnapshotMeta, callback?: (result: unknown) => void) => unknown;\n}\n\nexport function createRuntimeMeta(context: RuntimeApiFactoryContext): Partial<MetaFunctions> {\n\treturn {\n\t\tprint: (text: unknown) => {\n\t\t\tconst vm = context.getVM();\n\t\t\tif ((typeof text === \"object\" || typeof text === \"function\") && vm) {\n\t\t\t\ttext = vm.toString(text);\n\t\t\t}\n\t\t\tif (context.listener.log) {\n\t\t\t\tcontext.listener.log(String(text));\n\t\t\t} else {\n\t\t\t\tconsole.log(text);\n\t\t\t}\n\t\t},\n\t};\n}\n\nexport function createRuntimeGlobalApi(context: RuntimeApiFactoryContext): Partial<GlobalAPI> & {\n\tObjectPool: typeof ObjectPool;\n\tPalette: typeof Palette;\n\thost: {\n\t\temit: (name: string, payload?: unknown) => void;\n\t\trequest: (name: string, payload?: unknown, callback?: (result: unknown) => void) => string | null;\n\t};\n\tsession: {\n\t\tuser: () => RuntimeSessionSnapshot[\"user\"];\n\t\tplayer: () => RuntimeSessionSnapshot[\"player\"];\n\t\tgame: () => RuntimeSessionSnapshot[\"game\"];\n\t\troom: () => RuntimeSessionSnapshot[\"room\"];\n\t};\n\tmemory: {\n\t\texport: () => RuntimeSnapshot;\n\t\timport: (snapshot: RuntimeSnapshot) => Promise<void>;\n\t\treset: (options?: RuntimeResetOptions) => Promise<void>;\n\t\tsave: (meta?: RuntimeSnapshotMeta, callback?: (result: unknown) => void) => unknown;\n\t\tload: (meta?: RuntimeSnapshotMeta, callback?: (result: unknown) => void) => unknown;\n\t};\n} {\n\tconst inputStates = context.input.getStates();\n\tconst session = {\n\t\tuser: () => cloneValue(context.getSessionSnapshot()?.user ?? null),\n\t\tplayer: () => cloneValue(context.getSessionSnapshot()?.player ?? null),\n\t\tgame: () => cloneValue(context.getSessionSnapshot()?.game ?? null),\n\t\troom: () => cloneValue(context.getSessionSnapshot()?.room ?? null),\n\t};\n\tconst host = {\n\t\temit: (name: string, payload?: unknown) => {\n\t\t\tcontext.sendHostEvent({\n\t\t\t\ttype: name,\n\t\t\t\tpayload,\n\t\t\t\tsource: \"host\",\n\t\t\t});\n\t\t},\n\t\trequest: (name: string, payload?: unknown, callback?: (result: unknown) => void) =>\n\t\t\tcontext.sendHostRequest(name, payload, callback),\n\t};\n\tconst memory = {\n\t\texport: () => context.exportSnapshot(),\n\t\timport: (snapshot: RuntimeSnapshot) => context.importSnapshot(snapshot),\n\t\treset: (options?: RuntimeResetOptions) => context.resetRuntime(options),\n\t\tsave: (meta?: RuntimeSnapshotMeta, callback?: (result: unknown) => void) => context.saveSnapshot(meta, callback),\n\t\tload: (meta?: RuntimeSnapshotMeta, callback?: (result: unknown) => void) => context.loadSnapshot(meta, callback),\n\t};\n\n\treturn {\n\t\tscreen: context.screen.getInterface(),\n\t\taudio: context.audio.getInterface(),\n\t\tkeyboard: inputStates.keyboard,\n\t\tmouse: inputStates.mouse,\n\t\ttouch: inputStates.touch,\n\t\tgamepad: inputStates.gamepad,\n\t\tsprites: context.assets.sprites,\n\t\tmaps: context.assets.maps,\n\t\tsounds: context.assets.sounds,\n\t\tmusic: context.assets.music,\n\t\tassets: context.assets.assets,\n\t\tplayer: context.playerService.getInterface(),\n\t\thost,\n\t\tsession,\n\t\tmemory,\n\t\tsystem: context.system.getAPI(),\n\t\tscene: (name: string, definition: unknown) => {\n\t\t\tconst convertedDefinition = convertSceneDefinition(asSceneDefinition(definition), context.getVM(), context.listener);\n\t\t\tcontext.sceneManager.registerScene(name, convertedDefinition);\n\t\t},\n\t\troute: (path: string, sceneName: string) => context.sceneManager.registerRoute(path, sceneName),\n\t\trouter: context.sceneManager.router.getInterface(),\n\t\tImage,\n\t\tSprite,\n\t\tTileMap,\n\t\tSound,\n\t\tPalette,\n\t\tRandom,\n\t\tObjectPool,\n\t};\n}\n\nexport function convertSceneDefinition(\n\tdefinition: SceneDefinition,\n\tvm: L8BVM | null,\n\tlistener: RuntimeListener,\n): SceneDefinition {\n\tif (!vm?.runner?.main_thread?.processor) {\n\t\tlistener.log?.(\"[RuntimeController] VM not ready for scene conversion. Scene functions may not work correctly.\");\n\t\treturn definition;\n\t}\n\n\tconst processor = vm.runner.main_thread.processor;\n\tconst context = vm.context;\n\tconst converted: Record<string, unknown> = {};\n\n\tfor (const [key, value] of Object.entries(definition)) {\n\t\tif (value instanceof Routine) {\n\t\t\tconverted[key] = processor.routineAsFunction(value, context);\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (value && typeof value === \"object\" && !Array.isArray(value)) {\n\t\t\tconverted[key] = convertSceneDefinition(value, vm, listener);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconverted[key] = value;\n\t}\n\n\treturn converted as SceneDefinition;\n}\n\nfunction asSceneDefinition(definition: unknown): SceneDefinition {\n\tif (!definition || typeof definition !== \"object\" || Array.isArray(definition)) {\n\t\tthrow new Error(\"Scene definition must be an object.\");\n\t}\n\n\treturn definition as SceneDefinition;\n}\n\nfunction cloneValue<T>(value: T): T {\n\tif (value == null) {\n\t\treturn value;\n\t}\n\n\treturn JSON.parse(JSON.stringify(value)) as T;\n}\n","/**\n * Dynamic asset constructors\n *\n * Provides constructors for creating assets at runtime\n */\n\nimport { Sound } from \"@al8b/audio\";\nimport { TileMap } from \"@al8b/map\";\nimport { Image } from \"@al8b/image\";\nimport { Sprite } from \"@al8b/sprites\";\n\n/**\n * Export constructors for game code\n */\nexport { Image, Sprite, TileMap, Sound };\n","/**\n * Object Pool utility for game entities\n *\n * Provides object pooling to reduce GC pressure and improve performance\n * for frequently created/destroyed game objects.\n */\n\n/**\n * Object pool for reusing objects\n *\n * @template T - Type of objects in the pool\n */\nexport class ObjectPool<T> {\n\tprivate pool: T[] = [];\n\tprivate factory: () => T;\n\tprivate reset: (obj: T) => void;\n\tprivate maxSize: number;\n\n\t/**\n\t * Create a new object pool\n\t *\n\t * @param factory - Function to create new objects\n\t * @param reset - Function to reset object state for reuse\n\t * @param maxSize - Maximum pool size (default: 100)\n\t */\n\tconstructor(factory: () => T, reset: (obj: T) => void, maxSize: number = 100) {\n\t\tthis.factory = factory;\n\t\tthis.reset = reset;\n\t\tthis.maxSize = maxSize;\n\t}\n\n\t/**\n\t * Acquire an object from the pool\n\t *\n\t * Returns a new object if pool is empty, otherwise reuses a pooled object.\n\t *\n\t * @returns Object from pool or newly created\n\t */\n\tacquire(): T {\n\t\tif (this.pool.length > 0) {\n\t\t\treturn this.pool.pop()!;\n\t\t}\n\t\treturn this.factory();\n\t}\n\n\t/**\n\t * Release an object back to the pool\n\t *\n\t * Resets the object and adds it back to the pool for reuse.\n\t * If pool is at max size, the object is discarded.\n\t *\n\t * @param obj - Object to release\n\t */\n\trelease(obj: T): void {\n\t\tif (this.pool.length >= this.maxSize) {\n\t\t\t// Pool is full, discard object\n\t\t\treturn;\n\t\t}\n\n\t\tthis.reset(obj);\n\t\tthis.pool.push(obj);\n\t}\n\n\t/**\n\t * Clear all objects from the pool\n\t */\n\tclear(): void {\n\t\tthis.pool = [];\n\t}\n\n\t/**\n\t * Get current pool size\n\t *\n\t * @returns Number of objects in pool\n\t */\n\tsize(): number {\n\t\treturn this.pool.length;\n\t}\n\n\t/**\n\t * Get maximum pool size\n\t *\n\t * @returns Maximum pool size\n\t */\n\tgetMaxSize(): number {\n\t\treturn this.maxSize;\n\t}\n\n\t/**\n\t * Set maximum pool size\n\t *\n\t * @param maxSize - New maximum pool size\n\t */\n\tsetMaxSize(maxSize: number): void {\n\t\tthis.maxSize = maxSize;\n\t\t// Trim pool if it exceeds new max size\n\t\tif (this.pool.length > maxSize) {\n\t\t\tthis.pool = this.pool.slice(0, maxSize);\n\t\t}\n\t}\n}\n"],"mappings":"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","names":["Palette","Random","Routine","Sound","TileMap","Image","Sprite","ObjectPool","pool","factory","reset","maxSize","acquire","length","pop","release","obj","push","clear","size","getMaxSize","setMaxSize","slice","createRuntimeMeta","context","print","text","vm","getVM","toString","listener","log","String","console","createRuntimeGlobalApi","inputStates","input","getStates","session","user","cloneValue","getSessionSnapshot","player","game","room","host","emit","name","payload","sendHostEvent","type","source","request","callback","sendHostRequest","memory","export","exportSnapshot","import","snapshot","importSnapshot","reset","options","resetRuntime","save","meta","saveSnapshot","load","loadSnapshot","screen","getInterface","audio","keyboard","mouse","touch","gamepad","sprites","assets","maps","sounds","music","playerService","system","getAPI","scene","definition","convertedDefinition","convertSceneDefinition","asSceneDefinition","sceneManager","registerScene","route","path","sceneName","registerRoute","router","Image","Sprite","TileMap","Sound","Palette","Random","ObjectPool","runner","main_thread","processor","converted","key","value","Object","entries","Routine","routineAsFunction","Array","isArray","Error","JSON","parse","stringify"]}

package/dist/core/assets-registry.d.mts

@@ -0,0 +1,14 @@
+import { AssetCollections } from '../types/assets.mjs';
+
+declare class RuntimeAssetsRegistry {
+    private collections;
+    replace(collections: AssetCollections): void;
+    getCollections(): AssetCollections;
+    get sprites(): AssetCollections["sprites"];
+    get maps(): AssetCollections["maps"];
+    get sounds(): AssetCollections["sounds"];
+    get music(): AssetCollections["music"];
+    get assets(): AssetCollections["assets"];
+}
+
+export { RuntimeAssetsRegistry };

package/dist/core/assets-registry.d.ts

@@ -0,0 +1,14 @@
+import { AssetCollections } from '../types/assets.js';
+
+declare class RuntimeAssetsRegistry {
+    private collections;
+    replace(collections: AssetCollections): void;
+    getCollections(): AssetCollections;
+    get sprites(): AssetCollections["sprites"];
+    get maps(): AssetCollections["maps"];
+    get sounds(): AssetCollections["sounds"];
+    get music(): AssetCollections["music"];
+    get assets(): AssetCollections["assets"];
+}
+
+export { RuntimeAssetsRegistry };

package/dist/core/assets-registry.js

@@ -0,0 +1,64 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+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/core/assets-registry.ts
+var assets_registry_exports = {};
+__export(assets_registry_exports, {
+  RuntimeAssetsRegistry: () => RuntimeAssetsRegistry
+});
+module.exports = __toCommonJS(assets_registry_exports);
+var RuntimeAssetsRegistry = class {
+  static {
+    __name(this, "RuntimeAssetsRegistry");
+  }
+  collections = {
+    sprites: {},
+    maps: {},
+    sounds: {},
+    music: {},
+    assets: {}
+  };
+  replace(collections) {
+    this.collections = collections;
+  }
+  getCollections() {
+    return this.collections;
+  }
+  get sprites() {
+    return this.collections.sprites;
+  }
+  get maps() {
+    return this.collections.maps;
+  }
+  get sounds() {
+    return this.collections.sounds;
+  }
+  get music() {
+    return this.collections.music;
+  }
+  get assets() {
+    return this.collections.assets;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RuntimeAssetsRegistry
+});
+//# sourceMappingURL=assets-registry.js.map

package/dist/core/assets-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/assets-registry.ts"],"sourcesContent":["import type { AssetCollections } from \"../types\";\n\nexport class RuntimeAssetsRegistry {\n\tprivate collections: AssetCollections = {\n\t\tsprites: {},\n\t\tmaps: {},\n\t\tsounds: {},\n\t\tmusic: {},\n\t\tassets: {},\n\t};\n\n\treplace(collections: AssetCollections): void {\n\t\tthis.collections = collections;\n\t}\n\n\tgetCollections(): AssetCollections {\n\t\treturn this.collections;\n\t}\n\n\tget sprites(): AssetCollections[\"sprites\"] {\n\t\treturn this.collections.sprites;\n\t}\n\n\tget maps(): AssetCollections[\"maps\"] {\n\t\treturn this.collections.maps;\n\t}\n\n\tget sounds(): AssetCollections[\"sounds\"] {\n\t\treturn this.collections.sounds;\n\t}\n\n\tget music(): AssetCollections[\"music\"] {\n\t\treturn this.collections.music;\n\t}\n\n\tget assets(): AssetCollections[\"assets\"] {\n\t\treturn this.collections.assets;\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAEA;;;;;AAAO,IAAMA,wBAAN,MAAMA;EAAb,OAAaA;;;EACJC,cAAgC;IACvCC,SAAS,CAAC;IACVC,MAAM,CAAC;IACPC,QAAQ,CAAC;IACTC,OAAO,CAAC;IACRC,QAAQ,CAAC;EACV;EAEAC,QAAQN,aAAqC;AAC5C,SAAKA,cAAcA;EACpB;EAEAO,iBAAmC;AAClC,WAAO,KAAKP;EACb;EAEA,IAAIC,UAAuC;AAC1C,WAAO,KAAKD,YAAYC;EACzB;EAEA,IAAIC,OAAiC;AACpC,WAAO,KAAKF,YAAYE;EACzB;EAEA,IAAIC,SAAqC;AACxC,WAAO,KAAKH,YAAYG;EACzB;EAEA,IAAIC,QAAmC;AACtC,WAAO,KAAKJ,YAAYI;EACzB;EAEA,IAAIC,SAAqC;AACxC,WAAO,KAAKL,YAAYK;EACzB;AACD;","names":["RuntimeAssetsRegistry","collections","sprites","maps","sounds","music","assets","replace","getCollections"]}

package/dist/core/assets-registry.mjs

@@ -0,0 +1,41 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/core/assets-registry.ts
+var RuntimeAssetsRegistry = class {
+  static {
+    __name(this, "RuntimeAssetsRegistry");
+  }
+  collections = {
+    sprites: {},
+    maps: {},
+    sounds: {},
+    music: {},
+    assets: {}
+  };
+  replace(collections) {
+    this.collections = collections;
+  }
+  getCollections() {
+    return this.collections;
+  }
+  get sprites() {
+    return this.collections.sprites;
+  }
+  get maps() {
+    return this.collections.maps;
+  }
+  get sounds() {
+    return this.collections.sounds;
+  }
+  get music() {
+    return this.collections.music;
+  }
+  get assets() {
+    return this.collections.assets;
+  }
+};
+export {
+  RuntimeAssetsRegistry
+};
+//# sourceMappingURL=assets-registry.mjs.map

package/dist/core/assets-registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/assets-registry.ts"],"sourcesContent":["import type { AssetCollections } from \"../types\";\n\nexport class RuntimeAssetsRegistry {\n\tprivate collections: AssetCollections = {\n\t\tsprites: {},\n\t\tmaps: {},\n\t\tsounds: {},\n\t\tmusic: {},\n\t\tassets: {},\n\t};\n\n\treplace(collections: AssetCollections): void {\n\t\tthis.collections = collections;\n\t}\n\n\tgetCollections(): AssetCollections {\n\t\treturn this.collections;\n\t}\n\n\tget sprites(): AssetCollections[\"sprites\"] {\n\t\treturn this.collections.sprites;\n\t}\n\n\tget maps(): AssetCollections[\"maps\"] {\n\t\treturn this.collections.maps;\n\t}\n\n\tget sounds(): AssetCollections[\"sounds\"] {\n\t\treturn this.collections.sounds;\n\t}\n\n\tget music(): AssetCollections[\"music\"] {\n\t\treturn this.collections.music;\n\t}\n\n\tget assets(): AssetCollections[\"assets\"] {\n\t\treturn this.collections.assets;\n\t}\n}\n"],"mappings":";;;;AAEO,IAAMA,wBAAN,MAAMA;EAAb,OAAaA;;;EACJC,cAAgC;IACvCC,SAAS,CAAC;IACVC,MAAM,CAAC;IACPC,QAAQ,CAAC;IACTC,OAAO,CAAC;IACRC,QAAQ,CAAC;EACV;EAEAC,QAAQN,aAAqC;AAC5C,SAAKA,cAAcA;EACpB;EAEAO,iBAAmC;AAClC,WAAO,KAAKP;EACb;EAEA,IAAIC,UAAuC;AAC1C,WAAO,KAAKD,YAAYC;EACzB;EAEA,IAAIC,OAAiC;AACpC,WAAO,KAAKF,YAAYE;EACzB;EAEA,IAAIC,SAAqC;AACxC,WAAO,KAAKH,YAAYG;EACzB;EAEA,IAAIC,QAAmC;AACtC,WAAO,KAAKJ,YAAYI;EACzB;EAEA,IAAIC,SAAqC;AACxC,WAAO,KAAKL,YAAYK;EACzB;AACD;","names":["RuntimeAssetsRegistry","collections","sprites","maps","sounds","music","assets","replace","getCollections"]}

package/dist/core/controller.d.mts

@@ -0,0 +1,109 @@
+import { AudioCore } from '@al8b/audio';
+import { PlayerService } from '@al8b/player';
+import { SceneManager } from '@al8b/scene';
+import { Screen } from '@al8b/screen';
+import { TimeMachine } from '@al8b/time';
+import { L8BVM } from '@al8b/vm';
+import { InputManager } from '../input/manager.mjs';
+import { System } from '../system/api.mjs';
+import { RuntimeOptions } from '../types/runtime.mjs';
+import { RuntimeResetOptions, RuntimeSnapshot, HostEvent, RuntimeSessionSnapshot } from '../types/bridge.mjs';
+import '@al8b/input';
+import '../types/assets.mjs';
+import '@al8b/framework-shared';
+
+interface RuntimeController {
+    readonly screen: Screen;
+    readonly audio: AudioCore;
+    readonly input: InputManager;
+    readonly system: System;
+    readonly playerService: PlayerService;
+    readonly sceneManager: SceneManager;
+    readonly vm: L8BVM | null;
+    readonly timeMachine: TimeMachine | null;
+    readonly sprites: Record<string, any>;
+    readonly maps: Record<string, any>;
+    readonly sounds: Record<string, any>;
+    readonly music: Record<string, any>;
+    readonly assets: Record<string, any>;
+    readonly stopped: boolean;
+    start(): Promise<void>;
+    stop(): void;
+    resume(): void;
+    reset(options?: RuntimeResetOptions): Promise<void>;
+    exportSnapshot(): RuntimeSnapshot;
+    importSnapshot(snapshot: RuntimeSnapshot): Promise<void>;
+    updateSource(file: string, src: string, reinit?: boolean): boolean;
+    handleMessage(message: any): void;
+    sendHostEvent(event: HostEvent): void;
+    getCanvas(): HTMLCanvasElement;
+    getSession(): RuntimeSessionSnapshot | null;
+}
+declare function createRuntime(options?: RuntimeOptions): RuntimeController;
+declare class RuntimeControllerImpl implements RuntimeController {
+    private readonly options;
+    private readonly listener;
+    private readonly assetRegistry;
+    private readonly assetLoader;
+    private readonly debugLogger;
+    private readonly DEBUG_UPDATE_FREQUENCY;
+    private readonly snapshotRestorer;
+    private bridgeUnsubscribe;
+    private sourceUpdater;
+    private gameLoop;
+    private frameCount;
+    private lastUpdateRate;
+    private isStopped;
+    private preserveStorageOnNextBoot;
+    private sessionSnapshot;
+    readonly screen: Screen;
+    readonly audio: AudioCore;
+    readonly input: InputManager;
+    readonly system: System;
+    readonly playerService: PlayerService;
+    readonly sceneManager: SceneManager;
+    vm: L8BVM | null;
+    timeMachine: TimeMachine | null;
+    constructor(options?: RuntimeOptions);
+    get sprites(): Record<string, any>;
+    get maps(): Record<string, any>;
+    get sounds(): Record<string, any>;
+    get music(): Record<string, any>;
+    get assets(): Record<string, any>;
+    get stopped(): boolean;
+    getSession(): RuntimeSessionSnapshot | null;
+    start(): Promise<void>;
+    stop(): void;
+    resume(): void;
+    reset(options?: RuntimeResetOptions): Promise<void>;
+    exportSnapshot(): RuntimeSnapshot;
+    importSnapshot(snapshot: RuntimeSnapshot): Promise<void>;
+    updateSource(file: string, src: string, reinit?: boolean): boolean;
+    handleMessage(message: any): void;
+    sendHostEvent(event: HostEvent): void;
+    getCanvas(): HTMLCanvasElement;
+    private loadAssets;
+    private waitForAssetsReady;
+    private initializeVM;
+    private loadPrograms;
+    private initializeScenesAndRouter;
+    private startGameLoop;
+    private updateGameLoopUpdateRate;
+    private handleUpdate;
+    private handleDraw;
+    private handleTick;
+    private handleWatchStep;
+    private ensureBridgeSubscription;
+    private handleHostEvent;
+    private emitPlayerMessage;
+    private emitBridgeEvent;
+    private sendBridgeRequest;
+    private saveSnapshot;
+    private loadSnapshot;
+    private hydrateSession;
+    private mergeSession;
+    private teardownRuntimeState;
+    private logStep;
+}
+
+export { type RuntimeController, RuntimeControllerImpl, createRuntime };

package/dist/core/controller.d.ts

@@ -0,0 +1,109 @@
+import { AudioCore } from '@al8b/audio';
+import { PlayerService } from '@al8b/player';
+import { SceneManager } from '@al8b/scene';
+import { Screen } from '@al8b/screen';
+import { TimeMachine } from '@al8b/time';
+import { L8BVM } from '@al8b/vm';
+import { InputManager } from '../input/manager.js';
+import { System } from '../system/api.js';
+import { RuntimeOptions } from '../types/runtime.js';
+import { RuntimeResetOptions, RuntimeSnapshot, HostEvent, RuntimeSessionSnapshot } from '../types/bridge.js';
+import '@al8b/input';
+import '../types/assets.js';
+import '@al8b/framework-shared';
+
+interface RuntimeController {
+    readonly screen: Screen;
+    readonly audio: AudioCore;
+    readonly input: InputManager;
+    readonly system: System;
+    readonly playerService: PlayerService;
+    readonly sceneManager: SceneManager;
+    readonly vm: L8BVM | null;
+    readonly timeMachine: TimeMachine | null;
+    readonly sprites: Record<string, any>;
+    readonly maps: Record<string, any>;
+    readonly sounds: Record<string, any>;
+    readonly music: Record<string, any>;
+    readonly assets: Record<string, any>;
+    readonly stopped: boolean;
+    start(): Promise<void>;
+    stop(): void;
+    resume(): void;
+    reset(options?: RuntimeResetOptions): Promise<void>;
+    exportSnapshot(): RuntimeSnapshot;
+    importSnapshot(snapshot: RuntimeSnapshot): Promise<void>;
+    updateSource(file: string, src: string, reinit?: boolean): boolean;
+    handleMessage(message: any): void;
+    sendHostEvent(event: HostEvent): void;
+    getCanvas(): HTMLCanvasElement;
+    getSession(): RuntimeSessionSnapshot | null;
+}
+declare function createRuntime(options?: RuntimeOptions): RuntimeController;
+declare class RuntimeControllerImpl implements RuntimeController {
+    private readonly options;
+    private readonly listener;
+    private readonly assetRegistry;
+    private readonly assetLoader;
+    private readonly debugLogger;
+    private readonly DEBUG_UPDATE_FREQUENCY;
+    private readonly snapshotRestorer;
+    private bridgeUnsubscribe;
+    private sourceUpdater;
+    private gameLoop;
+    private frameCount;
+    private lastUpdateRate;
+    private isStopped;
+    private preserveStorageOnNextBoot;
+    private sessionSnapshot;
+    readonly screen: Screen;
+    readonly audio: AudioCore;
+    readonly input: InputManager;
+    readonly system: System;
+    readonly playerService: PlayerService;
+    readonly sceneManager: SceneManager;
+    vm: L8BVM | null;
+    timeMachine: TimeMachine | null;
+    constructor(options?: RuntimeOptions);
+    get sprites(): Record<string, any>;
+    get maps(): Record<string, any>;
+    get sounds(): Record<string, any>;
+    get music(): Record<string, any>;
+    get assets(): Record<string, any>;
+    get stopped(): boolean;
+    getSession(): RuntimeSessionSnapshot | null;
+    start(): Promise<void>;
+    stop(): void;
+    resume(): void;
+    reset(options?: RuntimeResetOptions): Promise<void>;
+    exportSnapshot(): RuntimeSnapshot;
+    importSnapshot(snapshot: RuntimeSnapshot): Promise<void>;
+    updateSource(file: string, src: string, reinit?: boolean): boolean;
+    handleMessage(message: any): void;
+    sendHostEvent(event: HostEvent): void;
+    getCanvas(): HTMLCanvasElement;
+    private loadAssets;
+    private waitForAssetsReady;
+    private initializeVM;
+    private loadPrograms;
+    private initializeScenesAndRouter;
+    private startGameLoop;
+    private updateGameLoopUpdateRate;
+    private handleUpdate;
+    private handleDraw;
+    private handleTick;
+    private handleWatchStep;
+    private ensureBridgeSubscription;
+    private handleHostEvent;
+    private emitPlayerMessage;
+    private emitBridgeEvent;
+    private sendBridgeRequest;
+    private saveSnapshot;
+    private loadSnapshot;
+    private hydrateSession;
+    private mergeSession;
+    private teardownRuntimeState;
+    private logStep;
+}
+
+export { type RuntimeController, RuntimeControllerImpl, createRuntime };