@al8b/runtime 0.1.0

package/dist/assets/index.mjs

@@ -0,0 +1,247 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// 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/assets/loader.ts
+import { Sound as Sound2, Music } from "@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
+import { LoadMap } from "@al8b/map";
+import { LoadSprite } from "@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) => 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) => 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 Sound2(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 Sound2(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 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 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;
+  }
+};
+export {
+  AssetLoader,
+  Image,
+  Sound,
+  Sprite,
+  TileMap
+};
+//# sourceMappingURL=index.mjs.map

package/dist/assets/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/assets/constructors.ts","../../src/assets/loader.ts","../../src/constants.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","/**\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":["Sound","TileMap","Image","Sprite","Sound","Music","DEFAULT_FPS","FRAME_TIME_MS","DEFAULT_FPS","DEFAULT_BLOCK_SIZE","LOADING_BAR_THROTTLE_MS","ASSET_LOAD_TIMEOUT_MS","LoadMap","LoadSprite","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"]}

package/dist/assets/loader.d.mts

@@ -0,0 +1,83 @@
+import { AudioCore } from '@al8b/audio';
+import '@al8b/map';
+import '@al8b/image';
+import '@al8b/sprites';
+import { Resources, AssetCollections } from '../types/assets.mjs';
+import { RuntimeListener } from '../types/runtime.mjs';
+import '@al8b/framework-shared';
+import '@al8b/vm';
+import '../types/bridge.mjs';
+import '@al8b/time';
+
+/**
+ * AssetLoader - Handles loading of game assets
+ *
+ * Responsibilities:
+ * - Load sprites, maps, sounds, music
+ * - Track loading progress
+ * - Show loading bar
+ */
+
+declare class AssetLoader {
+    private url;
+    private resources;
+    private collections;
+    private loadingBarTime;
+    private audioCore;
+    private listener?;
+    constructor(url: string, resources: Resources, audioCore: AudioCore, listener?: RuntimeListener);
+    /**
+     * Load all assets
+     */
+    loadAll(): Promise<AssetCollections>;
+    /**
+     * Load a set of callback-based assets (sprites or maps) with timeout and placeholder fallback.
+     */
+    private loadCallbackAssets;
+    /**
+     * Load sprites
+     */
+    private loadSprites;
+    /**
+     * Load maps
+     */
+    private loadMaps;
+    /**
+     * Load sounds
+     */
+    private loadSounds;
+    /**
+     * Load music
+     */
+    private loadMusic;
+    /**
+     * Load generic assets
+     */
+    private loadGenericAssets;
+    /**
+     * Check if all assets are ready
+     */
+    isReady(): boolean;
+    /**
+     * Get loading progress (0-1)
+     */
+    getProgress(): number;
+    /**
+     * Count total assets
+     */
+    private countTotal;
+    /**
+     * Count ready assets
+     */
+    private countReady;
+    /**
+     * Show loading bar on screen
+     */
+    showLoadingBar(screenInterface: any): void;
+    /**
+     * Get loaded collections
+     */
+    getCollections(): AssetCollections;
+}
+
+export { AssetLoader };

package/dist/assets/loader.d.ts

@@ -0,0 +1,83 @@
+import { AudioCore } from '@al8b/audio';
+import '@al8b/map';
+import '@al8b/image';
+import '@al8b/sprites';
+import { Resources, AssetCollections } from '../types/assets.js';
+import { RuntimeListener } from '../types/runtime.js';
+import '@al8b/framework-shared';
+import '@al8b/vm';
+import '../types/bridge.js';
+import '@al8b/time';
+
+/**
+ * AssetLoader - Handles loading of game assets
+ *
+ * Responsibilities:
+ * - Load sprites, maps, sounds, music
+ * - Track loading progress
+ * - Show loading bar
+ */
+
+declare class AssetLoader {
+    private url;
+    private resources;
+    private collections;
+    private loadingBarTime;
+    private audioCore;
+    private listener?;
+    constructor(url: string, resources: Resources, audioCore: AudioCore, listener?: RuntimeListener);
+    /**
+     * Load all assets
+     */
+    loadAll(): Promise<AssetCollections>;
+    /**
+     * Load a set of callback-based assets (sprites or maps) with timeout and placeholder fallback.
+     */
+    private loadCallbackAssets;
+    /**
+     * Load sprites
+     */
+    private loadSprites;
+    /**
+     * Load maps
+     */
+    private loadMaps;
+    /**
+     * Load sounds
+     */
+    private loadSounds;
+    /**
+     * Load music
+     */
+    private loadMusic;
+    /**
+     * Load generic assets
+     */
+    private loadGenericAssets;
+    /**
+     * Check if all assets are ready
+     */
+    isReady(): boolean;
+    /**
+     * Get loading progress (0-1)
+     */
+    getProgress(): number;
+    /**
+     * Count total assets
+     */
+    private countTotal;
+    /**
+     * Count ready assets
+     */
+    private countReady;
+    /**
+     * Show loading bar on screen
+     */
+    showLoadingBar(screenInterface: any): void;
+    /**
+     * Get loaded collections
+     */
+    getCollections(): AssetCollections;
+}
+
+export { AssetLoader };