@codexo/exojs 0.8.4 → 0.10.0

package/dist/esm/resources/factories/MusicFactory.js

@@ -32,27 +32,38 @@ class MusicFactory extends AbstractAssetFactory {
      * load event is received.
      */
     async create(source, options = {}) {
-        const { mimeType, loadEvent, playbackOptions } = options;
+        const { mimeType, loadEvent, playbackOptions, stallTimeout } = options;
         const blob = new Blob([source], { type: mimeType ?? determineMimeType(source) });
         const objectUrl = this.createObjectUrl(blob);
         return new Promise((resolve, reject) => {
             const audio = document.createElement('audio');
             this._audioElements.push(audio);
-            const finalize = () => {
+            let stallTimer;
+            let settled = false;
+            const settle = (fn) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (stallTimer !== undefined) {
+                    clearTimeout(stallTimer);
+                    stallTimer = undefined;
+                }
                 this.revokeObjectUrl(objectUrl);
+                fn();
             };
-            audio.addEventListener('error', () => {
-                finalize();
-                reject(new Error('Error loading audio source.'));
-            }, onceListenerOption);
-            audio.addEventListener('abort', () => {
-                finalize();
-                reject(new Error('Audio loading was canceled.'));
-            }, onceListenerOption);
-            audio.addEventListener(loadEvent ?? 'canplaythrough', () => {
-                finalize();
-                resolve(new Music(audio, playbackOptions));
-            }, onceListenerOption);
+            audio.addEventListener('error', () => settle(() => reject(new Error('Error loading audio source.'))), onceListenerOption);
+            audio.addEventListener('abort', () => settle(() => reject(new Error('Audio loading was canceled.'))), onceListenerOption);
+            audio.addEventListener('emptied', () => settle(() => reject(new Error('Audio loading was emptied.'))), onceListenerOption);
+            audio.addEventListener(loadEvent ?? 'canplaythrough', () => settle(() => resolve(new Music(audio, playbackOptions))), onceListenerOption);
+            if (stallTimeout !== undefined) {
+                audio.addEventListener('stalled', () => {
+                    if (settled)
+                        return;
+                    if (stallTimer !== undefined)
+                        clearTimeout(stallTimer);
+                    stallTimer = setTimeout(() => settle(() => reject(new Error('Audio loading stalled.'))), stallTimeout);
+                });
+            }
             audio.preload = 'auto';
             audio.src = objectUrl;
         });

package/dist/esm/resources/factories/MusicFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"MusicFactory.js","sources":["../../../../../src/resources/factories/MusicFactory.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA,MAAM,kBAAkB,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE;AAiBzC;;;;;;;;;;AAUG;AACG,MAAO,YAAa,SAAQ,oBAA2B,CAAA;IAC3C,WAAW,GAAG,OAAO;IAEpB,cAAc,GAAuB,EAAE;AAExD;;;AAGG;IACI,MAAM,OAAO,CAAC,QAAkB,EAAA;AACrC,QAAA,OAAO,QAAQ,CAAC,WAAW,EAAE;IAC/B;AAEA;;;;;;AAMG;AACI,IAAA,MAAM,MAAM,CAAC,MAAmB,EAAE,UAA+B,EAAE,EAAA;QACxE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,OAAO;QACxD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChF,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QAE5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAI;YACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC;AAC7C,YAAA,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;YAE/B,MAAM,QAAQ,GAAG,MAAW;AAC1B,gBAAA,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC;AACjC,YAAA,CAAC;AAED,YAAA,KAAK,CAAC,gBAAgB,CACpB,OAAO,EACP,MAAK;AACH,gBAAA,QAAQ,EAAE;AACV,gBAAA,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAClD,CAAC,EACD,kBAAkB,CACnB;AACD,YAAA,KAAK,CAAC,gBAAgB,CACpB,OAAO,EACP,MAAK;AACH,gBAAA,QAAQ,EAAE;AACV,gBAAA,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAClD,CAAC,EACD,kBAAkB,CACnB;YACD,KAAK,CAAC,gBAAgB,CACpB,SAAS,IAAI,gBAAgB,EAC7B,MAAK;AACH,gBAAA,QAAQ,EAAE;gBACV,OAAO,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;YAC5C,CAAC,EACD,kBAAkB,CACnB;AAED,YAAA,KAAK,CAAC,OAAO,GAAG,MAAM;AACtB,YAAA,KAAK,CAAC,GAAG,GAAG,SAAS;AACvB,QAAA,CAAC,CAAC;IACJ;AAEA;;;;AAIG;IACa,OAAO,GAAA;AACrB,QAAA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc,EAAE;YACvC,KAAK,CAAC,KAAK,EAAE;AACb,YAAA,KAAK,CAAC,GAAG,GAAG,EAAE;YACd,KAAK,CAAC,IAAI,EAAE;QACd;AACA,QAAA,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QAC9B,KAAK,CAAC,OAAO,EAAE;IACjB;AACD;;;;"}
+{"version":3,"file":"MusicFactory.js","sources":["../../../../../src/resources/factories/MusicFactory.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA,MAAM,kBAAkB,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE;AAwBzC;;;;;;;;;;AAUG;AACG,MAAO,YAAa,SAAQ,oBAA2B,CAAA;IAC3C,WAAW,GAAG,OAAO;IAEpB,cAAc,GAAuB,EAAE;AAExD;;;AAGG;IACI,MAAM,OAAO,CAAC,QAAkB,EAAA;AACrC,QAAA,OAAO,QAAQ,CAAC,WAAW,EAAE;IAC/B;AAEA;;;;;;AAMG;AACI,IAAA,MAAM,MAAM,CAAC,MAAmB,EAAE,UAA+B,EAAE,EAAA;QACxE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,GAAG,OAAO;QACtE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChF,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QAE5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAI;YACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC;AAC7C,YAAA,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;AAE/B,YAAA,IAAI,UAAqD;YACzD,IAAI,OAAO,GAAG,KAAK;AAEnB,YAAA,MAAM,MAAM,GAAG,CAAC,EAAc,KAAU;AACtC,gBAAA,IAAI,OAAO;oBAAE;gBACb,OAAO,GAAG,IAAI;AACd,gBAAA,IAAI,UAAU,KAAK,SAAS,EAAE;oBAC5B,YAAY,CAAC,UAAU,CAAC;oBACxB,UAAU,GAAG,SAAS;gBACxB;AACA,gBAAA,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC;AAC/B,gBAAA,EAAE,EAAE;AACN,YAAA,CAAC;YAED,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC;YACzH,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC;YACzH,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC;AAC1H,YAAA,KAAK,CAAC,gBAAgB,CAAC,SAAS,IAAI,gBAAgB,EAAE,MAAM,MAAM,CAAC,MAAM,OAAO,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC;AAEzI,YAAA,IAAI,YAAY,KAAK,SAAS,EAAE;AAC9B,gBAAA,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAK;AACrC,oBAAA,IAAI,OAAO;wBAAE;oBACb,IAAI,UAAU,KAAK,SAAS;wBAAE,YAAY,CAAC,UAAU,CAAC;oBACtD,UAAU,GAAG,UAAU,CAAC,MAAM,MAAM,CAAC,MAAM,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC;AACxG,gBAAA,CAAC,CAAC;YACJ;AAEA,YAAA,KAAK,CAAC,OAAO,GAAG,MAAM;AACtB,YAAA,KAAK,CAAC,GAAG,GAAG,SAAS;AACvB,QAAA,CAAC,CAAC;IACJ;AAEA;;;;AAIG;IACa,OAAO,GAAA;AACrB,QAAA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc,EAAE;YACvC,KAAK,CAAC,KAAK,EAAE;AACb,YAAA,KAAK,CAAC,GAAG,GAAG,EAAE;YACd,KAAK,CAAC,IAAI,EAAE;QACd;AACA,QAAA,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QAC9B,KAAK,CAAC,OAAO,EAAE;IACjB;AACD;;;;"}

package/dist/esm/resources/factories/SoundFactory.d.ts

@@ -1,7 +1,8 @@
 import { type AudioSpriteClip, Sound } from '@/audio/Sound';
 import type { PlaybackOptions } from '@/core/types';
 import { AbstractAssetFactory } from '@/resources/AbstractAssetFactory';
-interface SoundFactoryOptions {
+/** Construction options for {@link SoundFactory.create}. */
+export interface SoundFactoryOptions {
     /** Initial playback settings forwarded to the {@link Sound} instance. */
     playbackOptions?: Partial<PlaybackOptions>;
     /**
@@ -40,4 +41,3 @@ export declare class SoundFactory extends AbstractAssetFactory<Sound> {
      */
     create(source: ArrayBuffer, options?: SoundFactoryOptions): Promise<Sound>;
 }
-export {};

package/dist/esm/resources/factories/SoundFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"SoundFactory.js","sources":["../../../../../src/resources/factories/SoundFactory.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAsBA;;;;;;;;;AASG;AACG,MAAO,YAAa,SAAQ,oBAA2B,CAAA;IAC3C,WAAW,GAAG,OAAO;AAErC;;;AAGG;IACI,MAAM,OAAO,CAAC,QAAkB,EAAA;AACrC,QAAA,OAAO,QAAQ,CAAC,WAAW,EAAE;IAC/B;AAEA;;;AAGG;AACI,IAAA,MAAM,MAAM,CAAC,MAAmB,EAAE,UAA+B,EAAE,EAAA;AACxE,QAAA,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC;AAEjD,QAAA,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,EAAE;YACnC,GAAG,OAAO,CAAC,eAAe;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;AACzB,SAAA,CAAC;AAEF,QAAA,OAAO,KAAK;IACd;AACD;;;;"}
+{"version":3,"file":"SoundFactory.js","sources":["../../../../../src/resources/factories/SoundFactory.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAuBA;;;;;;;;;AASG;AACG,MAAO,YAAa,SAAQ,oBAA2B,CAAA;IAC3C,WAAW,GAAG,OAAO;AAErC;;;AAGG;IACI,MAAM,OAAO,CAAC,QAAkB,EAAA;AACrC,QAAA,OAAO,QAAQ,CAAC,WAAW,EAAE;IAC/B;AAEA;;;AAGG;AACI,IAAA,MAAM,MAAM,CAAC,MAAmB,EAAE,UAA+B,EAAE,EAAA;AACxE,QAAA,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC;AAEjD,QAAA,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,EAAE;YACnC,GAAG,OAAO,CAAC,eAAe;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;AACzB,SAAA,CAAC;AAEF,QAAA,OAAO,KAAK;IACd;AACD;;;;"}

package/dist/esm/resources/factories/SubtitleFactory.d.ts

@@ -0,0 +1,28 @@
+import { AbstractAssetFactory } from '@/resources/AbstractAssetFactory';
+type SubtitleFormat = 'vtt' | 'srt';
+interface SubtitleIntermediate {
+    fmt: SubtitleFormat;
+    text: string;
+}
+/**
+ * {@link AssetFactory} implementation that parses WebVTT (`.vtt`) and SubRip
+ * (`.srt`) subtitle files and produces an array of {@link VTTCue} instances.
+ *
+ * Format is detected from the file extension of the response URL; unknown
+ * extensions default to VTT parsing. VTT cue settings (`align`, `line`,
+ * `position`, `size`, `vertical`) are applied; SRT cues retain default
+ * positional properties.
+ */
+export declare class SubtitleFactory extends AbstractAssetFactory<VTTCue[]> {
+    readonly storageName = "subtitle";
+    /**
+     * Reads the response body as UTF-8 text and records the subtitle format
+     * derived from the response URL's file extension.
+     */
+    process(response: Response): Promise<SubtitleIntermediate>;
+    /**
+     * Parses the subtitle text into an ordered array of {@link VTTCue} instances.
+     */
+    create(source: SubtitleIntermediate): Promise<VTTCue[]>;
+}
+export {};

package/dist/esm/resources/factories/SubtitleFactory.js

@@ -0,0 +1,203 @@
+import { AbstractAssetFactory } from '../AbstractAssetFactory.js';
+
+// ---------------------------------------------------------------------------
+// VTT helpers
+// ---------------------------------------------------------------------------
+/**
+ * Converts a WebVTT timestamp string (`HH:MM:SS.mmm`, `MM:SS.mmm`, or
+ * `SS.mmm`) into a floating-point number of seconds.
+ *
+ * @internal
+ */
+const parseVttTimestamp = (value) => {
+    const parts = value.split(':');
+    let seconds;
+    if (parts.length === 3) {
+        seconds = Number(parts[0]) * 3600 + Number(parts[1]) * 60 + Number(parts[2]);
+    }
+    else if (parts.length === 2) {
+        seconds = Number(parts[0]) * 60 + Number(parts[1]);
+    }
+    else {
+        seconds = Number(parts[0]);
+    }
+    return seconds;
+};
+const validAlignValues = new Set(['start', 'center', 'end', 'left', 'right']);
+const validLineAlignValues = new Set(['start', 'center', 'end']);
+const validPositionAlignValues = new Set(['auto', 'line-left', 'center', 'line-right']);
+/**
+ * Parses the WebVTT cue-settings tail (`align:center line:80% position:50%`)
+ * and applies each recognized setting to the supplied {@link VTTCue}.
+ *
+ * Unknown keys, malformed values, and unknown enum members are silently
+ * skipped so that one bad token does not invalidate an otherwise valid cue.
+ * Percent signs on numeric values are tolerated and stripped.
+ *
+ * @internal
+ */
+const applyCueSettings = (cue, settings) => {
+    if (!settings) {
+        return;
+    }
+    for (const token of settings.split(/\s+/)) {
+        const colonIndex = token.indexOf(':');
+        if (colonIndex === -1) {
+            continue;
+        }
+        const name = token.slice(0, colonIndex);
+        const value = token.slice(colonIndex + 1);
+        switch (name) {
+            case 'vertical':
+                if (value === 'rl' || value === 'lr' || value === '') {
+                    cue.vertical = value;
+                }
+                break;
+            case 'line': {
+                if (value === 'auto') {
+                    cue.line = 'auto';
+                }
+                else {
+                    const [linePart, alignPart] = value.split(',');
+                    const num = parseFloat(linePart);
+                    if (!Number.isNaN(num)) {
+                        cue.line = num;
+                    }
+                    if (alignPart !== undefined && validLineAlignValues.has(alignPart)) {
+                        cue.lineAlign = alignPart;
+                    }
+                }
+                break;
+            }
+            case 'position': {
+                const [posPart, alignPart] = value.split(',');
+                const num = parseFloat(posPart);
+                if (!Number.isNaN(num)) {
+                    cue.position = num;
+                }
+                if (alignPart !== undefined && validPositionAlignValues.has(alignPart)) {
+                    cue.positionAlign = alignPart;
+                }
+                break;
+            }
+            case 'size': {
+                const num = parseFloat(value);
+                if (!Number.isNaN(num)) {
+                    cue.size = num;
+                }
+                break;
+            }
+            case 'align':
+                if (validAlignValues.has(value)) {
+                    cue.align = value;
+                }
+                break;
+        }
+    }
+};
+const parseVtt = (source) => {
+    const cues = [];
+    const lines = source.replaceAll('\r\n', '\n').replaceAll('\r', '\n').split('\n');
+    let i = 0;
+    // Skip header and any blank lines/metadata before first cue
+    while (i < lines.length && !lines[i].includes('-->')) {
+        i++;
+    }
+    while (i < lines.length) {
+        const line = lines[i].trim();
+        if (line.includes('-->')) {
+            const arrowIndex = line.indexOf('-->');
+            const startString = line.slice(0, arrowIndex).trim();
+            const rest = line.slice(arrowIndex + 3).trim();
+            const restTokens = rest.split(/\s+/);
+            const endString = restTokens[0];
+            const settingsString = restTokens.slice(1).join(' ');
+            const start = parseVttTimestamp(startString);
+            const end = parseVttTimestamp(endString);
+            i++;
+            const textLines = [];
+            while (i < lines.length && lines[i].trim() !== '') {
+                textLines.push(lines[i]);
+                i++;
+            }
+            const cue = new VTTCue(start, end, textLines.join('\n'));
+            applyCueSettings(cue, settingsString);
+            cues.push(cue);
+        }
+        else {
+            i++;
+        }
+    }
+    return cues;
+};
+// ---------------------------------------------------------------------------
+// SRT helpers
+// ---------------------------------------------------------------------------
+/**
+ * Converts an SRT timestamp string (`HH:MM:SS,mmm`) into a floating-point
+ * number of seconds.
+ *
+ * @internal
+ */
+const parseSrtTimestamp = (value) => {
+    const normalized = value.trim().replace(',', '.');
+    const parts = normalized.split(':');
+    return Number(parts[0]) * 3600 + Number(parts[1]) * 60 + Number(parts[2]);
+};
+const parseSrt = (source) => {
+    const cues = [];
+    const normalized = source.replaceAll('\r\n', '\n').replaceAll('\r', '\n');
+    const blocks = normalized.split(/\n[ \t]*\n/);
+    for (const block of blocks) {
+        const lines = block.trim().split('\n');
+        if (lines.length < 2)
+            continue;
+        let timingIndex = 0;
+        if (/^\d+$/.test(lines[0].trim())) {
+            timingIndex = 1;
+        }
+        const timingLine = lines[timingIndex];
+        if (!timingLine?.includes('-->'))
+            continue;
+        const arrowIndex = timingLine.indexOf('-->');
+        const start = parseSrtTimestamp(timingLine.slice(0, arrowIndex));
+        const end = parseSrtTimestamp(timingLine.slice(arrowIndex + 3));
+        const text = lines.slice(timingIndex + 1).join('\n');
+        cues.push(new VTTCue(start, end, text));
+    }
+    return cues;
+};
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * {@link AssetFactory} implementation that parses WebVTT (`.vtt`) and SubRip
+ * (`.srt`) subtitle files and produces an array of {@link VTTCue} instances.
+ *
+ * Format is detected from the file extension of the response URL; unknown
+ * extensions default to VTT parsing. VTT cue settings (`align`, `line`,
+ * `position`, `size`, `vertical`) are applied; SRT cues retain default
+ * positional properties.
+ */
+class SubtitleFactory extends AbstractAssetFactory {
+    storageName = 'subtitle';
+    /**
+     * Reads the response body as UTF-8 text and records the subtitle format
+     * derived from the response URL's file extension.
+     */
+    async process(response) {
+        const text = await response.text();
+        const url = response.url.split('?')[0].toLowerCase();
+        const fmt = url.endsWith('.srt') ? 'srt' : 'vtt';
+        return { fmt, text };
+    }
+    /**
+     * Parses the subtitle text into an ordered array of {@link VTTCue} instances.
+     */
+    async create(source) {
+        return source.fmt === 'srt' ? parseSrt(source.text) : parseVtt(source.text);
+    }
+}
+
+export { SubtitleFactory };
+//# sourceMappingURL=SubtitleFactory.js.map

package/dist/esm/resources/factories/SubtitleFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleFactory.js","sources":["../../../../../src/resources/factories/SubtitleFactory.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAaA;AACA;AACA;AAEA;;;;;AAKG;AACH,MAAM,iBAAiB,GAAG,CAAC,KAAa,KAAY;IAClD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;AAC9B,IAAA,IAAI,OAAe;AAEnB,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;AACtB,QAAA,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9E;AAAO,SAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;AAC7B,QAAA,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpD;SAAO;QACL,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5B;AAEA,IAAA,OAAO,OAAO;AAChB,CAAC;AAED,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACrF,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AACxE,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAS,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AAE/F;;;;;;;;;AASG;AACH,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAE,QAAgB,KAAU;IAC/D,IAAI,CAAC,QAAQ,EAAE;QACb;IACF;IAEA,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QACzC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;AAErC,QAAA,IAAI,UAAU,KAAK,EAAE,EAAE;YACrB;QACF;QAEA,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;QACvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;QAEzC,QAAQ,IAAI;AACV,YAAA,KAAK,UAAU;AACb,gBAAA,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE;AACpD,oBAAA,GAAG,CAAC,QAAQ,GAAG,KAAK;gBACtB;gBACA;YACF,KAAK,MAAM,EAAE;AACX,gBAAA,IAAI,KAAK,KAAK,MAAM,EAAE;AACpB,oBAAA,GAAG,CAAC,IAAI,GAAG,MAAM;gBACnB;qBAAO;AACL,oBAAA,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;AAC9C,oBAAA,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC;oBAEhC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;AACtB,wBAAA,GAAG,CAAC,IAAI,GAAG,GAAG;oBAChB;oBAEA,IAAI,SAAS,KAAK,SAAS,IAAI,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;AAClE,wBAAA,GAAG,CAAC,SAAS,GAAG,SAAgC;oBAClD;gBACF;gBACA;YACF;YACA,KAAK,UAAU,EAAE;AACf,gBAAA,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;AAC7C,gBAAA,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC;gBAE/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;AACtB,oBAAA,GAAG,CAAC,QAAQ,GAAG,GAAG;gBACpB;gBAEA,IAAI,SAAS,KAAK,SAAS,IAAI,wBAAwB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;AACtE,oBAAA,GAAG,CAAC,aAAa,GAAG,SAAoC;gBAC1D;gBACA;YACF;YACA,KAAK,MAAM,EAAE;AACX,gBAAA,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC;gBAE7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;AACtB,oBAAA,GAAG,CAAC,IAAI,GAAG,GAAG;gBAChB;gBACA;YACF;AACA,YAAA,KAAK,OAAO;AACV,gBAAA,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;AAC/B,oBAAA,GAAG,CAAC,KAAK,GAAG,KAAwB;gBACtC;gBACA;;IAEN;AACF,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,MAAc,KAAc;IAC5C,MAAM,IAAI,GAAa,EAAE;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IAChF,IAAI,CAAC,GAAG,CAAC;;AAGT,IAAA,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;AACpD,QAAA,CAAC,EAAE;IACL;AAEA,IAAA,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE;QACvB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;AAE5B,QAAA,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;YACxB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;AACtC,YAAA,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE;AACpD,YAAA,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;YAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;AACpC,YAAA,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC;AAC/B,YAAA,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;AACpD,YAAA,MAAM,KAAK,GAAG,iBAAiB,CAAC,WAAW,CAAC;AAC5C,YAAA,MAAM,GAAG,GAAG,iBAAiB,CAAC,SAAS,CAAC;AAExC,YAAA,CAAC,EAAE;YACH,MAAM,SAAS,GAAa,EAAE;AAE9B,YAAA,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBACjD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxB,gBAAA,CAAC,EAAE;YACL;AAEA,YAAA,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAExD,YAAA,gBAAgB,CAAC,GAAG,EAAE,cAAc,CAAC;AACrC,YAAA,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAChB;aAAO;AACL,YAAA,CAAC,EAAE;QACL;IACF;AAEA,IAAA,OAAO,IAAI;AACb,CAAC;AAED;AACA;AACA;AAEA;;;;;AAKG;AACH,MAAM,iBAAiB,GAAG,CAAC,KAAa,KAAY;AAClD,IAAA,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;IACjD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC;IAEnC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,MAAc,KAAc;IAC5C,MAAM,IAAI,GAAa,EAAE;AACzB,IAAA,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC;IACzE,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC;AAE7C,IAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;QAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;AAEtC,QAAA,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE;QAEtB,IAAI,WAAW,GAAG,CAAC;AAEnB,QAAA,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE;YACjC,WAAW,GAAG,CAAC;QACjB;AAEA,QAAA,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC;AAErC,QAAA,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC;YAAE;QAElC,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;AAC5C,QAAA,MAAM,KAAK,GAAG,iBAAiB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AAChE,QAAA,MAAM,GAAG,GAAG,iBAAiB,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;AAC/D,QAAA,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;AAEpD,QAAA,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC;AAEA,IAAA,OAAO,IAAI;AACb,CAAC;AAED;AACA;AACA;AAEA;;;;;;;;AAQG;AACG,MAAO,eAAgB,SAAQ,oBAA8B,CAAA;IACjD,WAAW,GAAG,UAAU;AAExC;;;AAGG;IACI,MAAM,OAAO,CAAC,QAAkB,EAAA;AACrC,QAAA,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE;AAClC,QAAA,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;AACpD,QAAA,MAAM,GAAG,GAAmB,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,KAAK;AAEhE,QAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE;IACtB;AAEA;;AAEG;IACI,MAAM,MAAM,CAAC,MAA4B,EAAA;QAC9C,OAAO,MAAM,CAAC,GAAG,KAAK,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;IAC7E;AACD;;;;"}

package/dist/esm/resources/factories/SvgFactory.d.ts

@@ -1,4 +1,18 @@
 import { AbstractAssetFactory } from '@/resources/AbstractAssetFactory';
+/** Construction options for {@link SvgFactory.create}. */
+export interface SvgFactoryOptions {
+    /**
+     * Target render width in pixels. When provided, the value is injected into
+     * the root `<svg>` element's `width` attribute before the browser rasterises
+     * the image, overriding any intrinsic width declared in the file.
+     *
+     * SVGs that carry only a `viewBox` (no `width`/`height` attributes) render
+     * as a 0×0 image by default; supplying `width` and `height` here fixes that.
+     */
+    width?: number;
+    /** Target render height in pixels. See {@link width}. */
+    height?: number;
+}
 /**
  * {@link AssetFactory} implementation that loads SVG markup and produces a
  * rasterised {@link HTMLImageElement}.
@@ -17,9 +31,12 @@ export declare class SvgFactory extends AbstractAssetFactory<HTMLImageElement> {
     /**
      * Renders the SVG markup into a fully loaded {@link HTMLImageElement}.
      *
+     * When `options.width` or `options.height` are provided, the values are
+     * injected into the root `<svg>` element before rasterisation so the browser
+     * renders at the requested pixel dimensions rather than the intrinsic size.
      * Creates a temporary `image/svg+xml` object URL, assigns it to an `<img>`
      * element, and revokes the URL once loading settles. Rejects on load error
      * or abort.
      */
-    create(source: string): Promise<HTMLImageElement>;
+    create(source: string, options?: SvgFactoryOptions): Promise<HTMLImageElement>;
 }

package/dist/esm/resources/factories/SvgFactory.js

@@ -20,12 +20,31 @@ class SvgFactory extends AbstractAssetFactory {
     /**
      * Renders the SVG markup into a fully loaded {@link HTMLImageElement}.
      *
+     * When `options.width` or `options.height` are provided, the values are
+     * injected into the root `<svg>` element before rasterisation so the browser
+     * renders at the requested pixel dimensions rather than the intrinsic size.
      * Creates a temporary `image/svg+xml` object URL, assigns it to an `<img>`
      * element, and revokes the URL once loading settles. Rejects on load error
      * or abort.
      */
-    async create(source) {
-        const blob = new Blob([source], { type: 'image/svg+xml' });
+    async create(source, options = {}) {
+        const { width, height } = options;
+        let svgSource = source;
+        if (width !== undefined || height !== undefined) {
+            const svgStart = svgSource.indexOf('<svg');
+            const tagClose = svgSource.indexOf('>', svgStart);
+            if (svgStart !== -1 && tagClose !== -1) {
+                const before = svgSource.slice(0, svgStart);
+                const attrs = svgSource.slice(svgStart + 4, tagClose); // after '<svg', before '>'
+                const after = svgSource.slice(tagClose + 1);
+                const cleaned = String(attrs)
+                    .replaceAll(/\s+width=(?:"[^"]*"|'[^']*')/g, '')
+                    .replaceAll(/\s+height=(?:"[^"]*"|'[^']*')/g, '');
+                const additions = (width !== undefined ? ` width="${width}"` : '') + (height !== undefined ? ` height="${height}"` : '');
+                svgSource = `${before}<svg${cleaned}${additions}>${after}`;
+            }
+        }
+        const blob = new Blob([svgSource], { type: 'image/svg+xml' });
         const objectUrl = this.createObjectUrl(blob);
         return new Promise((resolve, reject) => {
             const image = new Image();

package/dist/esm/resources/factories/SvgFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"SvgFactory.js","sources":["../../../../../src/resources/factories/SvgFactory.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;;;;AAQG;AACG,MAAO,UAAW,SAAQ,oBAAsC,CAAA;IACpD,WAAW,GAAG,KAAK;AAEnC;;AAEG;IACI,MAAM,OAAO,CAAC,QAAkB,EAAA;AACrC,QAAA,OAAO,QAAQ,CAAC,IAAI,EAAE;IACxB;AAEA;;;;;;AAMG;IACI,MAAM,MAAM,CAAC,MAAc,EAAA;AAChC,QAAA,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QAE5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAI;AACrC,YAAA,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE;YACzB,MAAM,QAAQ,GAAG,MAAW;AAC1B,gBAAA,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC;AACjC,YAAA,CAAC;AAED,YAAA,KAAK,CAAC,gBAAgB,CACpB,MAAM,EACN,MAAK;AACH,gBAAA,QAAQ,EAAE;gBACV,OAAO,CAAC,KAAK,CAAC;AAChB,YAAA,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf;AACD,YAAA,KAAK,CAAC,gBAAgB,CACpB,OAAO,EACP,MAAK;AACH,gBAAA,QAAQ,EAAE;AACV,gBAAA,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAClD,YAAA,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf;AACD,YAAA,KAAK,CAAC,gBAAgB,CACpB,OAAO,EACP,MAAK;AACH,gBAAA,QAAQ,EAAE;AACV,gBAAA,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAClD,YAAA,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf;AAED,YAAA,KAAK,CAAC,GAAG,GAAG,SAAS;AACvB,QAAA,CAAC,CAAC;IACJ;AACD;;;;"}
+{"version":3,"file":"SvgFactory.js","sources":["../../../../../src/resources/factories/SvgFactory.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAiBA;;;;;;;;AAQG;AACG,MAAO,UAAW,SAAQ,oBAAsC,CAAA;IACpD,WAAW,GAAG,KAAK;AAEnC;;AAEG;IACI,MAAM,OAAO,CAAC,QAAkB,EAAA;AACrC,QAAA,OAAO,QAAQ,CAAC,IAAI,EAAE;IACxB;AAEA;;;;;;;;;AASG;AACI,IAAA,MAAM,MAAM,CAAC,MAAc,EAAE,UAA6B,EAAE,EAAA;AACjE,QAAA,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO;QACjC,IAAI,SAAS,GAAG,MAAM;QAEtB,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE;YAC/C,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;YAC1C,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC;YAEjD,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,KAAK,EAAE,EAAE;gBACtC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;AAC3C,gBAAA,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;gBACtD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;AAE3C,gBAAA,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK;AACzB,qBAAA,UAAU,CAAC,+BAA+B,EAAE,EAAE;AAC9C,qBAAA,UAAU,CAAC,gCAAgC,EAAE,EAAE,CAAC;AACnD,gBAAA,MAAM,SAAS,GAAG,CAAC,KAAK,KAAK,SAAS,GAAG,CAAA,QAAA,EAAW,KAAK,CAAA,CAAA,CAAG,GAAG,EAAE,KAAK,MAAM,KAAK,SAAS,GAAG,CAAA,SAAA,EAAY,MAAM,GAAG,GAAG,EAAE,CAAC;gBAExH,SAAS,GAAG,CAAA,EAAG,MAAM,CAAA,IAAA,EAAO,OAAO,GAAG,SAAS,CAAA,CAAA,EAAI,KAAK,CAAA,CAAE;YAC5D;QACF;AAEA,QAAA,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;QAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QAE5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAI;AACrC,YAAA,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE;YACzB,MAAM,QAAQ,GAAG,MAAW;AAC1B,gBAAA,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC;AACjC,YAAA,CAAC;AAED,YAAA,KAAK,CAAC,gBAAgB,CACpB,MAAM,EACN,MAAK;AACH,gBAAA,QAAQ,EAAE;gBACV,OAAO,CAAC,KAAK,CAAC;AAChB,YAAA,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf;AACD,YAAA,KAAK,CAAC,gBAAgB,CACpB,OAAO,EACP,MAAK;AACH,gBAAA,QAAQ,EAAE;AACV,gBAAA,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAClD,YAAA,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf;AACD,YAAA,KAAK,CAAC,gBAAgB,CACpB,OAAO,EACP,MAAK;AACH,gBAAA,QAAQ,EAAE;AACV,gBAAA,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAClD,YAAA,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf;AAED,YAAA,KAAK,CAAC,GAAG,GAAG,SAAS;AACvB,QAAA,CAAC,CAAC;IACJ;AACD;;;;"}

package/dist/esm/resources/factories/TextureFactory.d.ts

@@ -28,11 +28,11 @@ export declare class TextureFactory extends AbstractAssetFactory<Texture> {
      */
     process(response: Response): Promise<ArrayBuffer>;
     /**
-     * Decodes image bytes into a fully loaded {@link HTMLImageElement} and
-     * wraps it in a {@link Texture} with the given sampler options.
+     * Decodes image bytes and wraps the result in a {@link Texture}.
      *
-     * Creates a temporary object URL, resolves when the image's `load` event
-     * fires, and revokes the URL regardless of outcome.
+     * Prefers `createImageBitmap` for a zero-copy GPU-upload path. Falls back
+     * to a temporary object URL + `<img>` element on environments that do not
+     * support `createImageBitmap`.
      */
     create(source: ArrayBuffer, options?: TextureFactoryOptions): Promise<Texture>;
 }

package/dist/esm/resources/factories/TextureFactory.js

@@ -21,15 +21,19 @@ class TextureFactory extends AbstractAssetFactory {
         return response.arrayBuffer();
     }
     /**
-     * Decodes image bytes into a fully loaded {@link HTMLImageElement} and
-     * wraps it in a {@link Texture} with the given sampler options.
+     * Decodes image bytes and wraps the result in a {@link Texture}.
      *
-     * Creates a temporary object URL, resolves when the image's `load` event
-     * fires, and revokes the URL regardless of outcome.
+     * Prefers `createImageBitmap` for a zero-copy GPU-upload path. Falls back
+     * to a temporary object URL + `<img>` element on environments that do not
+     * support `createImageBitmap`.
      */
     async create(source, options = {}) {
         const { mimeType, samplerOptions } = options;
         const blob = new Blob([source], { type: mimeType ?? determineMimeType(source) });
+        if (typeof createImageBitmap === 'function') {
+            const bitmap = await createImageBitmap(blob);
+            return new Texture(bitmap, samplerOptions);
+        }
         const objectUrl = this.createObjectUrl(blob);
         return new Promise((resolve, reject) => {
             const image = new Image();

package/dist/esm/resources/factories/TextureFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"TextureFactory.js","sources":["../../../../../src/resources/factories/TextureFactory.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAgBA;;;;;;;;AAQG;AACG,MAAO,cAAe,SAAQ,oBAA6B,CAAA;IAC/C,WAAW,GAAG,SAAS;AAEvC;;;AAGG;IACI,MAAM,OAAO,CAAC,QAAkB,EAAA;AACrC,QAAA,OAAO,QAAQ,CAAC,WAAW,EAAE;IAC/B;AAEA;;;;;;AAMG;AACI,IAAA,MAAM,MAAM,CAAC,MAAmB,EAAE,UAAiC,EAAE,EAAA;AAC1E,QAAA,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO;QAC5C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChF,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QAE5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAI;AACrC,YAAA,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE;YACzB,MAAM,QAAQ,GAAG,MAAW;AAC1B,gBAAA,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC;AACjC,YAAA,CAAC;AAED,YAAA,KAAK,CAAC,gBAAgB,CACpB,MAAM,EACN,MAAK;AACH,gBAAA,QAAQ,EAAE;gBACV,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AAC7C,YAAA,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf;AACD,YAAA,KAAK,CAAC,gBAAgB,CACpB,OAAO,EACP,MAAK;AACH,gBAAA,QAAQ,EAAE;AACV,gBAAA,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAClD,YAAA,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf;AACD,YAAA,KAAK,CAAC,gBAAgB,CACpB,OAAO,EACP,MAAK;AACH,gBAAA,QAAQ,EAAE;AACV,gBAAA,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAClD,YAAA,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf;AAED,YAAA,KAAK,CAAC,GAAG,GAAG,SAAS;AACvB,QAAA,CAAC,CAAC;IACJ;AACD;;;;"}
+{"version":3,"file":"TextureFactory.js","sources":["../../../../../src/resources/factories/TextureFactory.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAgBA;;;;;;;;AAQG;AACG,MAAO,cAAe,SAAQ,oBAA6B,CAAA;IAC/C,WAAW,GAAG,SAAS;AAEvC;;;AAGG;IACI,MAAM,OAAO,CAAC,QAAkB,EAAA;AACrC,QAAA,OAAO,QAAQ,CAAC,WAAW,EAAE;IAC/B;AAEA;;;;;;AAMG;AACI,IAAA,MAAM,MAAM,CAAC,MAAmB,EAAE,UAAiC,EAAE,EAAA;AAC1E,QAAA,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO;QAC5C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;AAEhF,QAAA,IAAI,OAAO,iBAAiB,KAAK,UAAU,EAAE;AAC3C,YAAA,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC;AAC5C,YAAA,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC;QAC5C;QAEA,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QAE5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAI;AACrC,YAAA,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE;YACzB,MAAM,QAAQ,GAAG,MAAW;AAC1B,gBAAA,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC;AACjC,YAAA,CAAC;AAED,YAAA,KAAK,CAAC,gBAAgB,CACpB,MAAM,EACN,MAAK;AACH,gBAAA,QAAQ,EAAE;gBACV,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AAC7C,YAAA,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf;AACD,YAAA,KAAK,CAAC,gBAAgB,CACpB,OAAO,EACP,MAAK;AACH,gBAAA,QAAQ,EAAE;AACV,gBAAA,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAClD,YAAA,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf;AACD,YAAA,KAAK,CAAC,gBAAgB,CACpB,OAAO,EACP,MAAK;AACH,gBAAA,QAAQ,EAAE;AACV,gBAAA,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAClD,YAAA,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf;AAED,YAAA,KAAK,CAAC,GAAG,GAAG,SAAS;AACvB,QAAA,CAAC,CAAC;IACJ;AACD;;;;"}

package/dist/esm/resources/factories/VideoFactory.d.ts

@@ -2,7 +2,8 @@ import type { PlaybackOptions, StreamingLoadEvent } from '@/core/types';
 import type { SamplerOptions } from '@/rendering/texture/Sampler';
 import { Video } from '@/rendering/video/Video';
 import { AbstractAssetFactory } from '@/resources/AbstractAssetFactory';
-interface VideoFactoryOptions {
+/** Construction options for {@link VideoFactory.create}. */
+export interface VideoFactoryOptions {
     /**
      * MIME type for the video blob. Inferred from magic bytes when omitted.
      */
@@ -17,6 +18,12 @@ interface VideoFactoryOptions {
     playbackOptions?: Partial<PlaybackOptions>;
     /** Sampler parameters forwarded to the {@link Video} instance's texture. */
     samplerOptions?: Partial<SamplerOptions>;
+    /**
+     * Milliseconds to wait after a `stalled` event before rejecting the load
+     * promise. When omitted no timeout is applied and a stalled load will wait
+     * indefinitely. Each subsequent `stalled` event resets the timer.
+     */
+    stallTimeout?: number;
 }
 /**
  * {@link AssetFactory} implementation that loads video files (MP4, WebM, OGG,
@@ -52,4 +59,3 @@ export declare class VideoFactory extends AbstractAssetFactory<Video> {
      */
     destroy(): void;
 }
-export {};

package/dist/esm/resources/factories/VideoFactory.js

@@ -32,33 +32,40 @@ class VideoFactory extends AbstractAssetFactory {
      * load event is received.
      */
     async create(source, options = {}) {
-        const { mimeType, loadEvent, playbackOptions, samplerOptions } = options;
+        const { mimeType, loadEvent, playbackOptions, samplerOptions, stallTimeout } = options;
         const blob = new Blob([source], { type: mimeType ?? determineMimeType(source) });
         const objectUrl = this.createObjectUrl(blob);
         return new Promise((resolve, reject) => {
             const video = document.createElement('video');
             this._videoElements.push(video);
-            const finalize = () => {
+            let stallTimer;
+            let settled = false;
+            const settle = (fn) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (stallTimer !== undefined) {
+                    clearTimeout(stallTimer);
+                    stallTimer = undefined;
+                }
                 this.revokeObjectUrl(objectUrl);
+                fn();
             };
-            video.addEventListener('error', () => {
-                finalize();
-                reject(new Error('Video loading error.'));
-            }, onceListenerOption);
-            video.addEventListener('abort', () => {
-                finalize();
-                reject(new Error('Video loading error: cancelled.'));
-            }, onceListenerOption);
-            video.addEventListener('emptied', () => {
-                finalize();
-                reject(new Error('Video loading error: emptied.'));
-            }, onceListenerOption);
-            // 'stalled' is intentionally omitted: it fires transiently during normal buffering
-            // and would cause spurious rejections for large files on slow connections.
-            video.addEventListener(loadEvent ?? 'canplaythrough', () => {
-                finalize();
-                resolve(new Video(video, playbackOptions, samplerOptions));
-            }, onceListenerOption);
+            video.addEventListener('error', () => settle(() => reject(new Error('Video loading error.'))), onceListenerOption);
+            video.addEventListener('abort', () => settle(() => reject(new Error('Video loading error: cancelled.'))), onceListenerOption);
+            video.addEventListener('emptied', () => settle(() => reject(new Error('Video loading error: emptied.'))), onceListenerOption);
+            video.addEventListener(loadEvent ?? 'canplaythrough', () => settle(() => resolve(new Video(video, playbackOptions, samplerOptions))), onceListenerOption);
+            // 'stalled' fires transiently during normal buffering on slow connections and is not
+            // treated as an error by default. Supply stallTimeout to reject after a stall persists.
+            if (stallTimeout !== undefined) {
+                video.addEventListener('stalled', () => {
+                    if (settled)
+                        return;
+                    if (stallTimer !== undefined)
+                        clearTimeout(stallTimer);
+                    stallTimer = setTimeout(() => settle(() => reject(new Error('Video loading stalled.'))), stallTimeout);
+                });
+            }
             video.preload = 'auto';
             video.src = objectUrl;
         });

package/dist/esm/resources/factories/VideoFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"VideoFactory.js","sources":["../../../../../src/resources/factories/VideoFactory.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAMA,MAAM,kBAAkB,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE;AAmBzC;;;;;;;;;;AAUG;AACG,MAAO,YAAa,SAAQ,oBAA2B,CAAA;IAC3C,WAAW,GAAG,OAAO;IAEpB,cAAc,GAAuB,EAAE;AAExD;;;AAGG;IACI,MAAM,OAAO,CAAC,QAAkB,EAAA;AACrC,QAAA,OAAO,QAAQ,CAAC,WAAW,EAAE;IAC/B;AAEA;;;;;;AAMG;AACI,IAAA,MAAM,MAAM,CAAC,MAAmB,EAAE,UAA+B,EAAE,EAAA;QACxE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,OAAO;QACxE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChF,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QAE5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAI;YACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC;AAC7C,YAAA,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;YAE/B,MAAM,QAAQ,GAAG,MAAW;AAC1B,gBAAA,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC;AACjC,YAAA,CAAC;AAED,YAAA,KAAK,CAAC,gBAAgB,CACpB,OAAO,EACP,MAAK;AACH,gBAAA,QAAQ,EAAE;AACV,gBAAA,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAC3C,CAAC,EACD,kBAAkB,CACnB;AACD,YAAA,KAAK,CAAC,gBAAgB,CACpB,OAAO,EACP,MAAK;AACH,gBAAA,QAAQ,EAAE;AACV,gBAAA,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACtD,CAAC,EACD,kBAAkB,CACnB;AACD,YAAA,KAAK,CAAC,gBAAgB,CACpB,SAAS,EACT,MAAK;AACH,gBAAA,QAAQ,EAAE;AACV,gBAAA,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACpD,CAAC,EACD,kBAAkB,CACnB;;;YAGD,KAAK,CAAC,gBAAgB,CACpB,SAAS,IAAI,gBAAgB,EAC7B,MAAK;AACH,gBAAA,QAAQ,EAAE;gBACV,OAAO,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;YAC5D,CAAC,EACD,kBAAkB,CACnB;AAED,YAAA,KAAK,CAAC,OAAO,GAAG,MAAM;AACtB,YAAA,KAAK,CAAC,GAAG,GAAG,SAAS;AACvB,QAAA,CAAC,CAAC;IACJ;AAEA;;;;AAIG;IACa,OAAO,GAAA;AACrB,QAAA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc,EAAE;YACvC,KAAK,CAAC,KAAK,EAAE;AACb,YAAA,KAAK,CAAC,GAAG,GAAG,EAAE;YACd,KAAK,CAAC,IAAI,EAAE;QACd;AACA,QAAA,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QAC9B,KAAK,CAAC,OAAO,EAAE;IACjB;AACD;;;;"}
+{"version":3,"file":"VideoFactory.js","sources":["../../../../../src/resources/factories/VideoFactory.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/resources/factories/XmlFactory.d.ts

@@ -0,0 +1,24 @@
+import { AbstractAssetFactory } from '@/resources/AbstractAssetFactory';
+/**
+ * {@link AssetFactory} implementation that loads XML files and produces a
+ * parsed {@link Document} via the browser's built-in {@link DOMParser}.
+ *
+ * Throws if the response body is not well-formed XML. Use the returned
+ * `Document` directly with standard DOM APIs — `doc.querySelector`,
+ * `doc.getElementsByTagName`, etc. — or pass it to a format-specific parser
+ * (e.g. for Tiled TMX, BMFont, or TexturePacker XML atlas files).
+ */
+export declare class XmlFactory extends AbstractAssetFactory<Document> {
+    readonly storageName = "xml";
+    /**
+     * Reads the response body as a UTF-8 string containing the raw XML markup.
+     */
+    process(response: Response): Promise<string>;
+    /**
+     * Parses the XML string into a {@link Document}.
+     *
+     * Throws if the browser's DOMParser reports a parse error (indicated by a
+     * `<parsererror>` element in the returned document).
+     */
+    create(source: string): Promise<Document>;
+}

package/dist/esm/resources/factories/XmlFactory.js

@@ -0,0 +1,37 @@
+import { AbstractAssetFactory } from '../AbstractAssetFactory.js';
+
+/**
+ * {@link AssetFactory} implementation that loads XML files and produces a
+ * parsed {@link Document} via the browser's built-in {@link DOMParser}.
+ *
+ * Throws if the response body is not well-formed XML. Use the returned
+ * `Document` directly with standard DOM APIs — `doc.querySelector`,
+ * `doc.getElementsByTagName`, etc. — or pass it to a format-specific parser
+ * (e.g. for Tiled TMX, BMFont, or TexturePacker XML atlas files).
+ */
+class XmlFactory extends AbstractAssetFactory {
+    storageName = 'xml';
+    /**
+     * Reads the response body as a UTF-8 string containing the raw XML markup.
+     */
+    async process(response) {
+        return response.text();
+    }
+    /**
+     * Parses the XML string into a {@link Document}.
+     *
+     * Throws if the browser's DOMParser reports a parse error (indicated by a
+     * `<parsererror>` element in the returned document).
+     */
+    async create(source) {
+        const doc = new DOMParser().parseFromString(source, 'text/xml');
+        const parseError = doc.querySelector('parsererror');
+        if (parseError) {
+            throw new Error(`XML parse error: ${parseError.textContent.trim() || 'unknown error'}`);
+        }
+        return doc;
+    }
+}
+
+export { XmlFactory };
+//# sourceMappingURL=XmlFactory.js.map