@al8b/runtime 0.1.0

package/README.md

@@ -0,0 +1,87 @@
+# @al8b/runtime
+
+Browser runtime facade for AL8B games. It owns asset loading, VM bootstrap, the frame loop, script-facing globals, bridge-based host integration, hot reload integration, and runtime lifecycle control.
+
+## Public API
+
+- `createRuntime`
+- `RuntimeController`
+- `RuntimeBridge`
+- `RuntimeSnapshot`
+- `RuntimeSessionSnapshot`
+- Re-exports from `assets`, `core`, `hot-reload`, `input`, `loop`, `storage`, `system`, `types`, `utils`, and `vm`
+
+## Runtime Responsibilities
+
+- Build the global script API (`screen`, `audio`, `input`, `player`, `scene`, `router`, `system`)
+- Expose host-facing built-ins (`host`, `session`, `memory`)
+- Load assets and compiled routine artifacts or development sources
+- Coordinate the game loop and debug time-machine hooks
+- Route runtime errors, warnings, and bridge events back to the host shell
+
+## Host Bridge
+
+Use `bridge` to connect the runtime to your app shell, backend, or realtime layer.
+
+```ts
+import { createRuntime, type RuntimeBridge } from "@al8b/runtime";
+
+const bridge: RuntimeBridge = {
+  emit(name, payload) {
+    console.log("game event", name, payload);
+  },
+  request(name, payload) {
+    return fetch(`/api/runtime/${name}`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }).then((response) => response.json());
+  },
+  getSession() {
+    return {
+      user: { id: "user-1" },
+      game: { id: "hello" }
+    };
+  }
+};
+
+const runtime = createRuntime({
+  canvas,
+  sources,
+  resources,
+  bridge
+});
+```
+
+LootiScript can use:
+
+- `host.emit(name, payload)`
+- `host.request(name, payload, callback)`
+- `session.user()`, `session.player()`, `session.game()`, `session.room()`
+- `memory.export()`, `memory.import(snapshot)`, `memory.reset()`, `memory.save(meta, callback)`, `memory.load(meta, callback)`
+
+## Runtime Lifecycle
+
+`RuntimeController` now exposes lifecycle and state transfer primitives needed by host apps:
+
+- `start()`
+- `stop()`
+- `resume()`
+- `reset(options?)`
+- `exportSnapshot()`
+- `importSnapshot(snapshot)`
+- `sendHostEvent(event)`
+- `getSession()`
+
+## Notes
+
+- This package is the integration point for most `@al8b/*` engine packages.
+- `createRuntime()` is the only supported top-level runtime constructor.
+- Backend access, auth, multiplayer transport, and hub UX stay in the host app or bridge layer, not in runtime core.
+
+## Scripts
+
+```bash
+bun run build
+bun run test
+bun run clean
+```

package/dist/assets/constructors.d.mts

@@ -0,0 +1,6 @@
+export { Sound } from '@al8b/audio';
+export { TileMap } from '@al8b/map';
+export { Image } from '@al8b/image';
+export { Sprite } from '@al8b/sprites';
+import '@al8b/vm';
+import '@al8b/io';

package/dist/assets/constructors.d.ts

@@ -0,0 +1,6 @@
+export { Sound } from '@al8b/audio';
+export { TileMap } from '@al8b/map';
+export { Image } from '@al8b/image';
+export { Sprite } from '@al8b/sprites';
+import '@al8b/vm';
+import '@al8b/io';

package/dist/assets/constructors.js

@@ -0,0 +1,40 @@
+"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/assets/constructors.ts
+var constructors_exports = {};
+__export(constructors_exports, {
+  Image: () => import_image.Image,
+  Sound: () => import_audio.Sound,
+  Sprite: () => import_sprites.Sprite,
+  TileMap: () => import_map.TileMap
+});
+module.exports = __toCommonJS(constructors_exports);
+var import_audio = require("@al8b/audio");
+var import_map = require("@al8b/map");
+var import_image = require("@al8b/image");
+var import_sprites = require("@al8b/sprites");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Image,
+  Sound,
+  Sprite,
+  TileMap
+});
+//# sourceMappingURL=constructors.js.map

package/dist/assets/constructors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/assets/constructors.ts"],"sourcesContent":["/**\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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;AAMA,mBAAsB;AACtB,iBAAwB;AACxB,mBAAsB;AACtB,qBAAuB;","names":[]}

package/dist/assets/constructors.mjs

@@ -0,0 +1,12 @@
+// src/assets/constructors.ts
+import { Sound } from "@al8b/audio";
+import { TileMap } from "@al8b/map";
+import { Image } from "@al8b/image";
+import { Sprite } from "@al8b/sprites";
+export {
+  Image,
+  Sound,
+  Sprite,
+  TileMap
+};
+//# sourceMappingURL=constructors.mjs.map

package/dist/assets/constructors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/assets/constructors.ts"],"sourcesContent":["/**\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"],"mappings":";AAMA,SAASA,aAAa;AACtB,SAASC,eAAe;AACxB,SAASC,aAAa;AACtB,SAASC,cAAc;","names":["Sound","TileMap","Image","Sprite"]}

package/dist/assets/index.d.mts

@@ -0,0 +1,11 @@
+export { Sound } from '@al8b/audio';
+export { TileMap } from '@al8b/map';
+export { Image } from '@al8b/image';
+export { Sprite } from '@al8b/sprites';
+export { AssetLoader } from './loader.mjs';
+import '../types/assets.mjs';
+import '../types/runtime.mjs';
+import '@al8b/framework-shared';
+import '@al8b/vm';
+import '../types/bridge.mjs';
+import '@al8b/time';

package/dist/assets/index.d.ts

@@ -0,0 +1,11 @@
+export { Sound } from '@al8b/audio';
+export { TileMap } from '@al8b/map';
+export { Image } from '@al8b/image';
+export { Sprite } from '@al8b/sprites';
+export { AssetLoader } from './loader.js';
+import '../types/assets.js';
+import '../types/runtime.js';
+import '@al8b/framework-shared';
+import '@al8b/vm';
+import '../types/bridge.js';
+import '@al8b/time';

package/dist/assets/index.js

@@ -0,0 +1,276 @@
+"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/assets/index.ts
+var assets_exports = {};
+__export(assets_exports, {
+  AssetLoader: () => AssetLoader,
+  Image: () => import_image.Image,
+  Sound: () => import_audio.Sound,
+  Sprite: () => import_sprites.Sprite,
+  TileMap: () => import_map.TileMap
+});
+module.exports = __toCommonJS(assets_exports);
+
+// 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/assets/loader.ts
+var import_audio2 = require("@al8b/audio");
+
+// src/constants.ts
+var DEFAULT_FPS = 60;
+var FRAME_TIME_MS = 1e3 / DEFAULT_FPS;
+var DEFAULT_BLOCK_SIZE = 16;
+var LOADING_BAR_THROTTLE_MS = 16;
+var ASSET_LOAD_TIMEOUT_MS = 3e4;
+
+// src/assets/loader.ts
+var import_map2 = require("@al8b/map");
+var import_sprites2 = require("@al8b/sprites");
+function withTimeout(promise, ms) {
+  return Promise.race([
+    promise,
+    new Promise((_, reject) => setTimeout(() => reject(new Error(`Asset load timed out after ${ms}ms`)), ms))
+  ]);
+}
+__name(withTimeout, "withTimeout");
+var AssetLoader = class {
+  static {
+    __name(this, "AssetLoader");
+  }
+  url;
+  resources;
+  collections;
+  loadingBarTime = null;
+  audioCore;
+  listener;
+  constructor(url, resources, audioCore, listener) {
+    this.url = url;
+    this.resources = resources;
+    this.audioCore = audioCore;
+    this.listener = listener;
+    this.collections = {
+      sprites: {},
+      maps: {},
+      sounds: {},
+      music: {},
+      assets: {}
+    };
+  }
+  /**
+  * Load all assets
+  */
+  async loadAll() {
+    await Promise.all([
+      this.loadSprites(),
+      this.loadMaps(),
+      this.loadSounds(),
+      this.loadMusic(),
+      this.loadGenericAssets()
+    ]);
+    return this.collections;
+  }
+  /**
+  * Load a set of callback-based assets (sprites or maps) with timeout and placeholder fallback.
+  */
+  async loadCallbackAssets(resources, urlPrefix, collectionKey, load, createPlaceholder) {
+    if (!resources) return;
+    const promises = resources.map((res) => new Promise((resolve) => {
+      const name = res.file.split(".")[0].replace(/-/g, "/");
+      const url = `${this.url}${urlPrefix}/${res.file}?v=${res.version || 0}`;
+      try {
+        const inner = new Promise((onReady) => {
+          this.collections[collectionKey][name] = load(url, res, onReady);
+        });
+        withTimeout(inner, ASSET_LOAD_TIMEOUT_MS).then(resolve).catch((err) => {
+          this.listener?.log?.(`[AssetLoader] Failed to load ${collectionKey.slice(0, -1)} "${name}": ${String(err)}`);
+          this.collections[collectionKey][name] = createPlaceholder(name, res);
+          resolve();
+        });
+      } catch (err) {
+        this.listener?.log?.(`[AssetLoader] Failed to load ${collectionKey.slice(0, -1)} "${name}": ${String(err)}`);
+        this.collections[collectionKey][name] = createPlaceholder(name, res);
+        resolve();
+      }
+    }));
+    await Promise.all(promises);
+  }
+  /**
+  * Load sprites
+  */
+  async loadSprites() {
+    await this.loadCallbackAssets(this.resources.images, "sprites", "sprites", (url, img, onReady) => (0, import_sprites2.LoadSprite)(url, img.properties, onReady), (name, img) => ({
+      name,
+      ready: false,
+      frames: [],
+      fps: img.properties?.fps || 5,
+      width: 0,
+      height: 0
+    }));
+  }
+  /**
+  * Load maps
+  */
+  async loadMaps() {
+    await this.loadCallbackAssets(this.resources.maps, "maps", "maps", (url, _mapRes, onReady) => (0, import_map2.LoadMap)(url, this.collections.sprites, onReady), (name) => ({
+      name,
+      ready: false,
+      width: 0,
+      height: 0,
+      block_width: DEFAULT_BLOCK_SIZE,
+      block_height: DEFAULT_BLOCK_SIZE,
+      data: []
+    }));
+  }
+  /**
+  * Load sounds
+  */
+  async loadSounds() {
+    if (!this.resources.sounds) return;
+    const promises = this.resources.sounds.map((sound) => {
+      return new Promise((resolve) => {
+        const name = sound.file.split(".")[0];
+        const url = `${this.url}sounds/${sound.file}?v=${sound.version || 0}`;
+        try {
+          const soundInstance = new import_audio2.Sound(this.audioCore, url);
+          this.collections.sounds[name] = soundInstance;
+          resolve();
+        } catch (err) {
+          this.listener?.log?.(`[AssetLoader] Failed to load sound "${name}": ${String(err)}`);
+          this.collections.sounds[name] = new import_audio2.Sound(this.audioCore, url);
+          resolve();
+        }
+      });
+    });
+    await Promise.all(promises);
+  }
+  /**
+  * Load music
+  */
+  async loadMusic() {
+    if (!this.resources.music) return;
+    const promises = this.resources.music.map((mus) => {
+      return new Promise((resolve) => {
+        const name = mus.file.split(".")[0];
+        const url = `${this.url}music/${mus.file}?v=${mus.version || 0}`;
+        try {
+          const musicInstance = new import_audio2.Music(this.audioCore, url);
+          this.collections.music[name] = musicInstance;
+          resolve();
+        } catch (err) {
+          this.listener?.log?.(`[AssetLoader] Failed to load music "${name}": ${String(err)}`);
+          this.collections.music[name] = new import_audio2.Music(this.audioCore, url);
+          resolve();
+        }
+      });
+    });
+    await Promise.all(promises);
+  }
+  /**
+  * Load generic assets
+  */
+  async loadGenericAssets() {
+    if (!this.resources.assets) return;
+    for (const asset of this.resources.assets) {
+      const name = asset.file.split(".")[0].replace(/-/g, "/");
+      this.collections.assets[name] = {
+        name,
+        file: asset.file,
+        version: asset.version
+      };
+    }
+  }
+  /**
+  * Check if all assets are ready
+  */
+  isReady() {
+    return this.countReady() === this.countTotal();
+  }
+  /**
+  * Get loading progress (0-1)
+  */
+  getProgress() {
+    const total = this.countTotal();
+    if (total === 0) return 1;
+    return this.countReady() / total;
+  }
+  /**
+  * Count total assets
+  */
+  countTotal() {
+    let count = 0;
+    count += Object.keys(this.collections.sprites).length;
+    count += Object.keys(this.collections.maps).length;
+    count += Object.keys(this.collections.sounds).length;
+    count += Object.keys(this.collections.music).length;
+    return count;
+  }
+  /**
+  * Count ready assets
+  */
+  countReady() {
+    let ready = 0;
+    for (const sprite of Object.values(this.collections.sprites)) {
+      if (sprite.ready) ready++;
+    }
+    for (const map of Object.values(this.collections.maps)) {
+      if (map.ready) ready++;
+    }
+    for (const sound of Object.values(this.collections.sounds)) {
+      if (sound.ready) ready++;
+    }
+    for (const mus of Object.values(this.collections.music)) {
+      if (mus.ready) ready++;
+    }
+    return ready;
+  }
+  /**
+  * Show loading bar on screen
+  */
+  showLoadingBar(screenInterface) {
+    if (this.loadingBarTime && Date.now() < this.loadingBarTime + LOADING_BAR_THROTTLE_MS) {
+      return;
+    }
+    this.loadingBarTime = Date.now();
+    const progress = this.getProgress();
+    screenInterface.clear("#000");
+    screenInterface.drawRect(0, 0, 100, 10, "#DDD");
+    screenInterface.fillRect(-(1 - progress) * 48, 0, progress * 96, 6, "#DDD");
+  }
+  /**
+  * Get loaded collections
+  */
+  getCollections() {
+    return this.collections;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AssetLoader,
+  Image,
+  Sound,
+  Sprite,
+  TileMap
+});
+//# sourceMappingURL=index.js.map

package/dist/assets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/assets/index.ts","../../src/assets/constructors.ts","../../src/assets/loader.ts","../../src/constants.ts"],"sourcesContent":["/**\n * Asset management exports\n */\n\nexport {\n\tImage,\n\tTileMap,\n\tSound,\n\tSprite,\n} from \"./constructors\";\nexport { AssetLoader } from \"./loader\";\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 * AssetLoader - Handles loading of game assets\n *\n * Responsibilities:\n * - Load sprites, maps, sounds, music\n * - Track loading progress\n * - Show loading bar\n */\n\nimport { AudioCore, Sound, Music } from \"@al8b/audio\";\nimport { ASSET_LOAD_TIMEOUT_MS, DEFAULT_BLOCK_SIZE, LOADING_BAR_THROTTLE_MS } from \"../constants\";\nimport { LoadMap } from \"@al8b/map\";\nimport { LoadSprite } from \"@al8b/sprites\";\nimport type { AssetCollections, ResourceFile, Resources } from \"../types\";\nimport type { RuntimeListener } from \"../types\";\n\n/**\n * Race a promise against a timeout.\n * Rejects with a descriptive error if `ms` elapses before the promise settles.\n */\nfunction withTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {\n\treturn Promise.race([\n\t\tpromise,\n\t\tnew Promise<T>((_, reject) =>\n\t\t\tsetTimeout(() => reject(new Error(`Asset load timed out after ${ms}ms`)), ms),\n\t\t),\n\t]);\n}\n\nexport class AssetLoader {\n\tprivate url: string;\n\tprivate resources: Resources;\n\tprivate collections: AssetCollections;\n\tprivate loadingBarTime: number | null = null;\n\tprivate audioCore: AudioCore;\n\tprivate listener?: RuntimeListener;\n\n\tconstructor(url: string, resources: Resources, audioCore: AudioCore, listener?: RuntimeListener) {\n\t\tthis.url = url;\n\t\tthis.resources = resources;\n\t\tthis.audioCore = audioCore;\n\t\tthis.listener = listener;\n\t\tthis.collections = {\n\t\t\tsprites: {},\n\t\t\tmaps: {},\n\t\t\tsounds: {},\n\t\t\tmusic: {},\n\t\t\tassets: {},\n\t\t};\n\t}\n\n\t/**\n\t * Load all assets\n\t */\n\tasync loadAll(): Promise<AssetCollections> {\n\t\tawait Promise.all([\n\t\t\tthis.loadSprites(),\n\t\t\tthis.loadMaps(),\n\t\t\tthis.loadSounds(),\n\t\t\tthis.loadMusic(),\n\t\t\tthis.loadGenericAssets(),\n\t\t]);\n\n\t\treturn this.collections;\n\t}\n\n\t/**\n\t * Load a set of callback-based assets (sprites or maps) with timeout and placeholder fallback.\n\t */\n\tprivate async loadCallbackAssets<TRes extends ResourceFile>(\n\t\tresources: TRes[] | undefined,\n\t\turlPrefix: string,\n\t\tcollectionKey: \"sprites\" | \"maps\",\n\t\tload: (url: string, res: TRes, onReady: () => void) => any,\n\t\tcreatePlaceholder: (name: string, res: TRes) => any,\n\t): Promise<void> {\n\t\tif (!resources) return;\n\n\t\tconst promises = resources.map(\n\t\t\t(res) =>\n\t\t\t\tnew Promise<void>((resolve) => {\n\t\t\t\t\tconst name = res.file.split(\".\")[0].replace(/-/g, \"/\");\n\t\t\t\t\tconst url = `${this.url}${urlPrefix}/${res.file}?v=${res.version || 0}`;\n\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst inner = new Promise<void>((onReady) => {\n\t\t\t\t\t\t\tthis.collections[collectionKey][name] = load(url, res, onReady);\n\t\t\t\t\t\t});\n\n\t\t\t\t\t\twithTimeout(inner, ASSET_LOAD_TIMEOUT_MS).then(resolve).catch((err) => {\n\t\t\t\t\t\t\tthis.listener?.log?.(`[AssetLoader] Failed to load ${collectionKey.slice(0, -1)} \"${name}\": ${String(err)}`);\n\t\t\t\t\t\t\tthis.collections[collectionKey][name] = createPlaceholder(name, res);\n\t\t\t\t\t\t\tresolve();\n\t\t\t\t\t\t});\n\t\t\t\t\t} catch (err) {\n\t\t\t\t\t\tthis.listener?.log?.(`[AssetLoader] Failed to load ${collectionKey.slice(0, -1)} \"${name}\": ${String(err)}`);\n\t\t\t\t\t\tthis.collections[collectionKey][name] = createPlaceholder(name, res);\n\t\t\t\t\t\tresolve();\n\t\t\t\t\t}\n\t\t\t\t}),\n\t\t);\n\n\t\tawait Promise.all(promises);\n\t}\n\n\t/**\n\t * Load sprites\n\t */\n\tprivate async loadSprites(): Promise<void> {\n\t\tawait this.loadCallbackAssets(\n\t\t\tthis.resources.images,\n\t\t\t\"sprites\",\n\t\t\t\"sprites\",\n\t\t\t(url, img, onReady) => LoadSprite(url, img.properties, onReady),\n\t\t\t(name, img) => ({\n\t\t\t\tname,\n\t\t\t\tready: false,\n\t\t\t\tframes: [],\n\t\t\t\tfps: (img.properties as any)?.fps || 5,\n\t\t\t\twidth: 0,\n\t\t\t\theight: 0,\n\t\t\t}),\n\t\t);\n\t}\n\n\t/**\n\t * Load maps\n\t */\n\tprivate async loadMaps(): Promise<void> {\n\t\tawait this.loadCallbackAssets(\n\t\t\tthis.resources.maps,\n\t\t\t\"maps\",\n\t\t\t\"maps\",\n\t\t\t(url, _mapRes, onReady) => LoadMap(url, this.collections.sprites, onReady),\n\t\t\t(name) => ({\n\t\t\t\tname,\n\t\t\t\tready: false,\n\t\t\t\twidth: 0,\n\t\t\t\theight: 0,\n\t\t\t\tblock_width: DEFAULT_BLOCK_SIZE,\n\t\t\t\tblock_height: DEFAULT_BLOCK_SIZE,\n\t\t\t\tdata: [],\n\t\t\t}),\n\t\t);\n\t}\n\n\t/**\n\t * Load sounds\n\t */\n\tprivate async loadSounds(): Promise<void> {\n\t\tif (!this.resources.sounds) return;\n\n\t\tconst promises = this.resources.sounds.map((sound) => {\n\t\t\treturn new Promise<void>((resolve) => {\n\t\t\t\tconst name = sound.file.split(\".\")[0];\n\t\t\t\tconst url = `${this.url}sounds/${sound.file}?v=${sound.version || 0}`;\n\n\t\t\t\ttry {\n\t\t\t\t\t// Sound class handles loading via XMLHttpRequest and AudioBuffer internally.\n\t\t\t\t\t// Resolve immediately — readiness is polled via isReady()/getProgress() in the game loop.\n\t\t\t\t\tconst soundInstance = new Sound(this.audioCore, url);\n\t\t\t\t\tthis.collections.sounds[name] = soundInstance;\n\t\t\t\t\tresolve();\n\t\t\t\t} catch (err) {\n\t\t\t\t\tthis.listener?.log?.(`[AssetLoader] Failed to load sound \"${name}\": ${String(err)}`);\n\t\t\t\t\tthis.collections.sounds[name] = new Sound(this.audioCore, url);\n\t\t\t\t\tresolve();\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\n\t\tawait Promise.all(promises);\n\t}\n\n\t/**\n\t * Load music\n\t */\n\tprivate async loadMusic(): Promise<void> {\n\t\tif (!this.resources.music) return;\n\n\t\tconst promises = this.resources.music.map((mus) => {\n\t\t\treturn new Promise<void>((resolve) => {\n\t\t\t\tconst name = mus.file.split(\".\")[0];\n\t\t\t\tconst url = `${this.url}music/${mus.file}?v=${mus.version || 0}`;\n\n\t\t\t\ttry {\n\t\t\t\t\t// Music class handles HTML5 Audio internally (streaming — ready immediately).\n\t\t\t\t\tconst musicInstance = new Music(this.audioCore, url);\n\t\t\t\t\tthis.collections.music[name] = musicInstance;\n\t\t\t\t\tresolve();\n\t\t\t\t} catch (err) {\n\t\t\t\t\tthis.listener?.log?.(`[AssetLoader] Failed to load music \"${name}\": ${String(err)}`);\n\t\t\t\t\tthis.collections.music[name] = new Music(this.audioCore, url);\n\t\t\t\t\tresolve();\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\n\t\tawait Promise.all(promises);\n\t}\n\n\t/**\n\t * Load generic assets\n\t */\n\tprivate async loadGenericAssets(): Promise<void> {\n\t\tif (!this.resources.assets) return;\n\n\t\tfor (const asset of this.resources.assets) {\n\t\t\tconst name = asset.file.split(\".\")[0].replace(/-/g, \"/\");\n\t\t\tthis.collections.assets[name] = {\n\t\t\t\tname,\n\t\t\t\tfile: asset.file,\n\t\t\t\tversion: asset.version,\n\t\t\t};\n\t\t}\n\t}\n\n\t/**\n\t * Check if all assets are ready\n\t */\n\tisReady(): boolean {\n\t\treturn this.countReady() === this.countTotal();\n\t}\n\n\t/**\n\t * Get loading progress (0-1)\n\t */\n\tgetProgress(): number {\n\t\tconst total = this.countTotal();\n\t\tif (total === 0) return 1;\n\t\treturn this.countReady() / total;\n\t}\n\n\t/**\n\t * Count total assets\n\t */\n\tprivate countTotal(): number {\n\t\tlet count = 0;\n\t\tcount += Object.keys(this.collections.sprites).length;\n\t\tcount += Object.keys(this.collections.maps).length;\n\t\tcount += Object.keys(this.collections.sounds).length;\n\t\tcount += Object.keys(this.collections.music).length;\n\t\treturn count;\n\t}\n\n\t/**\n\t * Count ready assets\n\t */\n\tprivate countReady(): number {\n\t\tlet ready = 0;\n\n\t\tfor (const sprite of Object.values(this.collections.sprites)) {\n\t\t\tif (sprite.ready) ready++;\n\t\t}\n\t\tfor (const map of Object.values(this.collections.maps)) {\n\t\t\tif (map.ready) ready++;\n\t\t}\n\t\tfor (const sound of Object.values(this.collections.sounds)) {\n\t\t\tif (sound.ready) ready++;\n\t\t}\n\t\tfor (const mus of Object.values(this.collections.music)) {\n\t\t\tif (mus.ready) ready++;\n\t\t}\n\n\t\treturn ready;\n\t}\n\n\t/**\n\t * Show loading bar on screen\n\t */\n\tshowLoadingBar(screenInterface: any): void {\n\t\t// Throttle redraws\n\t\tif (this.loadingBarTime && Date.now() < this.loadingBarTime + LOADING_BAR_THROTTLE_MS) {\n\t\t\treturn;\n\t\t}\n\t\tthis.loadingBarTime = Date.now();\n\n\t\tconst progress = this.getProgress();\n\t\tscreenInterface.clear(\"#000\");\n\t\tscreenInterface.drawRect(0, 0, 100, 10, \"#DDD\");\n\t\tscreenInterface.fillRect(-(1 - progress) * 48, 0, progress * 96, 6, \"#DDD\");\n\t}\n\n\t/**\n\t * Get loaded collections\n\t */\n\tgetCollections(): AssetCollections {\n\t\treturn this.collections;\n\t}\n}\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"],"mappings":"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","names":["import_audio","DEFAULT_FPS","FRAME_TIME_MS","DEFAULT_FPS","DEFAULT_BLOCK_SIZE","LOADING_BAR_THROTTLE_MS","ASSET_LOAD_TIMEOUT_MS","import_map","import_sprites","withTimeout","promise","ms","Promise","race","_","reject","setTimeout","Error","AssetLoader","url","resources","collections","loadingBarTime","audioCore","listener","sprites","maps","sounds","music","assets","loadAll","all","loadSprites","loadMaps","loadSounds","loadMusic","loadGenericAssets","loadCallbackAssets","urlPrefix","collectionKey","load","createPlaceholder","promises","map","res","resolve","name","file","split","replace","version","inner","onReady","ASSET_LOAD_TIMEOUT_MS","then","catch","err","log","slice","String","images","img","LoadSprite","properties","ready","frames","fps","width","height","_mapRes","LoadMap","block_width","DEFAULT_BLOCK_SIZE","block_height","data","sound","soundInstance","Sound","mus","musicInstance","Music","asset","isReady","countReady","countTotal","getProgress","total","count","Object","keys","length","sprite","values","showLoadingBar","screenInterface","Date","now","LOADING_BAR_THROTTLE_MS","progress","clear","drawRect","fillRect","getCollections"]}