@al8b/runtime 0.1.0

package/dist/constants.d.mts

@@ -0,0 +1,16 @@
+/** Default frames per second */
+declare const DEFAULT_FPS = 60;
+/** Default update rate (updates per second) */
+declare const DEFAULT_UPDATE_RATE = 60;
+/** Frame time in milliseconds at 60 FPS */
+declare const FRAME_TIME_MS: number;
+/** Threshold in ms to detect long pauses (tab switch, etc.) */
+declare const PAUSE_THRESHOLD_MS = 160;
+/** Default tile/block size in pixels */
+declare const DEFAULT_BLOCK_SIZE = 16;
+/** Minimum interval between loading bar redraws in ms (~60fps) */
+declare const LOADING_BAR_THROTTLE_MS = 16;
+/** Timeout in ms for individual asset loads (sprite/map HTTP requests) */
+declare const ASSET_LOAD_TIMEOUT_MS = 30000;
+
+export { ASSET_LOAD_TIMEOUT_MS, DEFAULT_BLOCK_SIZE, DEFAULT_FPS, DEFAULT_UPDATE_RATE, FRAME_TIME_MS, LOADING_BAR_THROTTLE_MS, PAUSE_THRESHOLD_MS };

package/dist/constants.d.ts

@@ -0,0 +1,16 @@
+/** Default frames per second */
+declare const DEFAULT_FPS = 60;
+/** Default update rate (updates per second) */
+declare const DEFAULT_UPDATE_RATE = 60;
+/** Frame time in milliseconds at 60 FPS */
+declare const FRAME_TIME_MS: number;
+/** Threshold in ms to detect long pauses (tab switch, etc.) */
+declare const PAUSE_THRESHOLD_MS = 160;
+/** Default tile/block size in pixels */
+declare const DEFAULT_BLOCK_SIZE = 16;
+/** Minimum interval between loading bar redraws in ms (~60fps) */
+declare const LOADING_BAR_THROTTLE_MS = 16;
+/** Timeout in ms for individual asset loads (sprite/map HTTP requests) */
+declare const ASSET_LOAD_TIMEOUT_MS = 30000;
+
+export { ASSET_LOAD_TIMEOUT_MS, DEFAULT_BLOCK_SIZE, DEFAULT_FPS, DEFAULT_UPDATE_RATE, FRAME_TIME_MS, LOADING_BAR_THROTTLE_MS, PAUSE_THRESHOLD_MS };

package/dist/constants.js

@@ -0,0 +1,49 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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/constants.ts
+var constants_exports = {};
+__export(constants_exports, {
+  ASSET_LOAD_TIMEOUT_MS: () => ASSET_LOAD_TIMEOUT_MS,
+  DEFAULT_BLOCK_SIZE: () => DEFAULT_BLOCK_SIZE,
+  DEFAULT_FPS: () => DEFAULT_FPS,
+  DEFAULT_UPDATE_RATE: () => DEFAULT_UPDATE_RATE,
+  FRAME_TIME_MS: () => FRAME_TIME_MS,
+  LOADING_BAR_THROTTLE_MS: () => LOADING_BAR_THROTTLE_MS,
+  PAUSE_THRESHOLD_MS: () => PAUSE_THRESHOLD_MS
+});
+module.exports = __toCommonJS(constants_exports);
+var DEFAULT_FPS = 60;
+var DEFAULT_UPDATE_RATE = 60;
+var FRAME_TIME_MS = 1e3 / DEFAULT_FPS;
+var PAUSE_THRESHOLD_MS = 160;
+var DEFAULT_BLOCK_SIZE = 16;
+var LOADING_BAR_THROTTLE_MS = 16;
+var ASSET_LOAD_TIMEOUT_MS = 3e4;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ASSET_LOAD_TIMEOUT_MS,
+  DEFAULT_BLOCK_SIZE,
+  DEFAULT_FPS,
+  DEFAULT_UPDATE_RATE,
+  FRAME_TIME_MS,
+  LOADING_BAR_THROTTLE_MS,
+  PAUSE_THRESHOLD_MS
+});
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;AACO,IAAMA,cAAc;AAGpB,IAAMC,sBAAsB;AAG5B,IAAMC,gBAAgB,MAAOF;AAG7B,IAAMG,qBAAqB;AAG3B,IAAMC,qBAAqB;AAG3B,IAAMC,0BAA0B;AAGhC,IAAMC,wBAAwB;","names":["DEFAULT_FPS","DEFAULT_UPDATE_RATE","FRAME_TIME_MS","PAUSE_THRESHOLD_MS","DEFAULT_BLOCK_SIZE","LOADING_BAR_THROTTLE_MS","ASSET_LOAD_TIMEOUT_MS"]}

package/dist/constants.mjs

@@ -0,0 +1,18 @@
+// src/constants.ts
+var DEFAULT_FPS = 60;
+var DEFAULT_UPDATE_RATE = 60;
+var FRAME_TIME_MS = 1e3 / DEFAULT_FPS;
+var PAUSE_THRESHOLD_MS = 160;
+var DEFAULT_BLOCK_SIZE = 16;
+var LOADING_BAR_THROTTLE_MS = 16;
+var ASSET_LOAD_TIMEOUT_MS = 3e4;
+export {
+  ASSET_LOAD_TIMEOUT_MS,
+  DEFAULT_BLOCK_SIZE,
+  DEFAULT_FPS,
+  DEFAULT_UPDATE_RATE,
+  FRAME_TIME_MS,
+  LOADING_BAR_THROTTLE_MS,
+  PAUSE_THRESHOLD_MS
+};
+//# sourceMappingURL=constants.mjs.map

package/dist/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.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"],"mappings":";AACO,IAAMA,cAAc;AAGpB,IAAMC,sBAAsB;AAG5B,IAAMC,gBAAgB,MAAOF;AAG7B,IAAMG,qBAAqB;AAG3B,IAAMC,qBAAqB;AAG3B,IAAMC,0BAA0B;AAGhC,IAAMC,wBAAwB;","names":["DEFAULT_FPS","DEFAULT_UPDATE_RATE","FRAME_TIME_MS","PAUSE_THRESHOLD_MS","DEFAULT_BLOCK_SIZE","LOADING_BAR_THROTTLE_MS","ASSET_LOAD_TIMEOUT_MS"]}

package/dist/core/api-factory.d.mts

@@ -0,0 +1,63 @@
+import { Palette } from '@al8b/palette';
+import { SceneManager, SceneDefinition } from '@al8b/scene';
+import { L8BVM, GlobalAPI, MetaFunctions } from '@al8b/vm';
+import { InputManager } from '../input/manager.mjs';
+import { RuntimeListener, RuntimeOptions } from '../types/runtime.mjs';
+import { RuntimeBridge, RuntimeSessionSnapshot, HostEvent, RuntimeSnapshot, RuntimeResetOptions, RuntimeSnapshotMeta } from '../types/bridge.mjs';
+import { ObjectPool } from '../utils/object-pool.mjs';
+import { PlayerService } from '@al8b/player';
+import { RuntimeAssetsRegistry } from './assets-registry.mjs';
+import { Screen } from '@al8b/screen';
+import { AudioCore } from '@al8b/audio';
+import { System } from '../system/api.mjs';
+import '@al8b/input';
+import '../types/assets.mjs';
+import '@al8b/framework-shared';
+import '@al8b/time';
+
+interface RuntimeApiFactoryContext {
+    listener: RuntimeListener;
+    options: RuntimeOptions;
+    screen: Screen;
+    audio: AudioCore;
+    input: InputManager;
+    system: System;
+    playerService: PlayerService;
+    sceneManager: SceneManager;
+    assets: RuntimeAssetsRegistry;
+    bridge?: RuntimeBridge;
+    getVM: () => L8BVM | null;
+    getSessionSnapshot: () => RuntimeSessionSnapshot | null;
+    sendHostEvent: (event: HostEvent) => void;
+    sendHostRequest: (name: string, payload?: unknown, callback?: (result: unknown) => void) => string | null;
+    exportSnapshot: () => RuntimeSnapshot;
+    importSnapshot: (snapshot: RuntimeSnapshot) => Promise<void>;
+    resetRuntime: (options?: RuntimeResetOptions) => Promise<void>;
+    saveSnapshot: (meta?: RuntimeSnapshotMeta, callback?: (result: unknown) => void) => unknown;
+    loadSnapshot: (meta?: RuntimeSnapshotMeta, callback?: (result: unknown) => void) => unknown;
+}
+declare function createRuntimeMeta(context: RuntimeApiFactoryContext): Partial<MetaFunctions>;
+declare function createRuntimeGlobalApi(context: RuntimeApiFactoryContext): Partial<GlobalAPI> & {
+    ObjectPool: typeof ObjectPool;
+    Palette: typeof Palette;
+    host: {
+        emit: (name: string, payload?: unknown) => void;
+        request: (name: string, payload?: unknown, callback?: (result: unknown) => void) => string | null;
+    };
+    session: {
+        user: () => RuntimeSessionSnapshot["user"];
+        player: () => RuntimeSessionSnapshot["player"];
+        game: () => RuntimeSessionSnapshot["game"];
+        room: () => RuntimeSessionSnapshot["room"];
+    };
+    memory: {
+        export: () => RuntimeSnapshot;
+        import: (snapshot: RuntimeSnapshot) => Promise<void>;
+        reset: (options?: RuntimeResetOptions) => Promise<void>;
+        save: (meta?: RuntimeSnapshotMeta, callback?: (result: unknown) => void) => unknown;
+        load: (meta?: RuntimeSnapshotMeta, callback?: (result: unknown) => void) => unknown;
+    };
+};
+declare function convertSceneDefinition(definition: SceneDefinition, vm: L8BVM | null, listener: RuntimeListener): SceneDefinition;
+
+export { type RuntimeApiFactoryContext, convertSceneDefinition, createRuntimeGlobalApi, createRuntimeMeta };

package/dist/core/api-factory.d.ts

@@ -0,0 +1,63 @@
+import { Palette } from '@al8b/palette';
+import { SceneManager, SceneDefinition } from '@al8b/scene';
+import { L8BVM, GlobalAPI, MetaFunctions } from '@al8b/vm';
+import { InputManager } from '../input/manager.js';
+import { RuntimeListener, RuntimeOptions } from '../types/runtime.js';
+import { RuntimeBridge, RuntimeSessionSnapshot, HostEvent, RuntimeSnapshot, RuntimeResetOptions, RuntimeSnapshotMeta } from '../types/bridge.js';
+import { ObjectPool } from '../utils/object-pool.js';
+import { PlayerService } from '@al8b/player';
+import { RuntimeAssetsRegistry } from './assets-registry.js';
+import { Screen } from '@al8b/screen';
+import { AudioCore } from '@al8b/audio';
+import { System } from '../system/api.js';
+import '@al8b/input';
+import '../types/assets.js';
+import '@al8b/framework-shared';
+import '@al8b/time';
+
+interface RuntimeApiFactoryContext {
+    listener: RuntimeListener;
+    options: RuntimeOptions;
+    screen: Screen;
+    audio: AudioCore;
+    input: InputManager;
+    system: System;
+    playerService: PlayerService;
+    sceneManager: SceneManager;
+    assets: RuntimeAssetsRegistry;
+    bridge?: RuntimeBridge;
+    getVM: () => L8BVM | null;
+    getSessionSnapshot: () => RuntimeSessionSnapshot | null;
+    sendHostEvent: (event: HostEvent) => void;
+    sendHostRequest: (name: string, payload?: unknown, callback?: (result: unknown) => void) => string | null;
+    exportSnapshot: () => RuntimeSnapshot;
+    importSnapshot: (snapshot: RuntimeSnapshot) => Promise<void>;
+    resetRuntime: (options?: RuntimeResetOptions) => Promise<void>;
+    saveSnapshot: (meta?: RuntimeSnapshotMeta, callback?: (result: unknown) => void) => unknown;
+    loadSnapshot: (meta?: RuntimeSnapshotMeta, callback?: (result: unknown) => void) => unknown;
+}
+declare function createRuntimeMeta(context: RuntimeApiFactoryContext): Partial<MetaFunctions>;
+declare function createRuntimeGlobalApi(context: RuntimeApiFactoryContext): Partial<GlobalAPI> & {
+    ObjectPool: typeof ObjectPool;
+    Palette: typeof Palette;
+    host: {
+        emit: (name: string, payload?: unknown) => void;
+        request: (name: string, payload?: unknown, callback?: (result: unknown) => void) => string | null;
+    };
+    session: {
+        user: () => RuntimeSessionSnapshot["user"];
+        player: () => RuntimeSessionSnapshot["player"];
+        game: () => RuntimeSessionSnapshot["game"];
+        room: () => RuntimeSessionSnapshot["room"];
+    };
+    memory: {
+        export: () => RuntimeSnapshot;
+        import: (snapshot: RuntimeSnapshot) => Promise<void>;
+        reset: (options?: RuntimeResetOptions) => Promise<void>;
+        save: (meta?: RuntimeSnapshotMeta, callback?: (result: unknown) => void) => unknown;
+        load: (meta?: RuntimeSnapshotMeta, callback?: (result: unknown) => void) => unknown;
+    };
+};
+declare function convertSceneDefinition(definition: SceneDefinition, vm: L8BVM | null, listener: RuntimeListener): SceneDefinition;
+
+export { type RuntimeApiFactoryContext, convertSceneDefinition, createRuntimeGlobalApi, createRuntimeMeta };

package/dist/core/api-factory.js

@@ -0,0 +1,239 @@
+"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/api-factory.ts
+var api_factory_exports = {};
+__export(api_factory_exports, {
+  convertSceneDefinition: () => convertSceneDefinition,
+  createRuntimeGlobalApi: () => createRuntimeGlobalApi,
+  createRuntimeMeta: () => createRuntimeMeta
+});
+module.exports = __toCommonJS(api_factory_exports);
+var import_palette = require("@al8b/palette");
+var import_vm = require("@al8b/vm");
+
+// src/assets/constructors.ts
+var import_audio = require("@al8b/audio");
+var import_map = require("@al8b/map");
+var import_image = require("@al8b/image");
+var import_sprites = require("@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: import_image.Image,
+    Sprite: import_sprites.Sprite,
+    TileMap: import_map.TileMap,
+    Sound: import_audio.Sound,
+    Palette: import_palette.Palette,
+    Random: import_vm.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 import_vm.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");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  convertSceneDefinition,
+  createRuntimeGlobalApi,
+  createRuntimeMeta
+});
+//# sourceMappingURL=api-factory.js.map

package/dist/core/api-factory.js.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":["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"]}