@vpmedia/phaser 1.116.0 → 1.118.0

package/src/phaser/core/cache.ts

@@ -1,3 +1,4 @@
+import type { TextureSource } from '../display/webgl/base_texture.js';
 import { BaseTexture } from '../display/webgl/base_texture.js';
 import { Texture } from '../display/webgl/texture.js';
 import { JSONDataHash, spriteSheet } from './animation_parser.js';
@@ -5,6 +6,7 @@ import { Frame } from './frame.js';
 import { FrameData } from './frame_data.js';
 import { jsonBitmapFont, xmlBitmapFont } from './loader_parser.js';
 import { Signal } from './signal.js';
+import type { BitmapFontData } from './loader_parser.js';
 import type { Game } from './game.js';
 
 export const CANVAS = 0;
@@ -18,28 +20,66 @@ export const JSONDATA = 7;
 export const XML = 8;
 export const RENDER_TEXTURE = 9;
 
+/** An image, sprite sheet or texture atlas: the source bitmap and the frames cut from it. */
+export type ImageCacheEntry = {
+  key: string;
+  url: string;
+  data: TextureSource;
+  base: BaseTexture;
+  frame?: Frame;
+  frameData: FrameData | null;
+};
+
+/** Audio as the cache holds it: the raw bytes on load, an AudioBuffer once decoded. */
+export type SoundData = ArrayBuffer | AudioBuffer;
+
+/** A sound and how far its decoding has got. */
+export type SoundCacheEntry = {
+  url: string;
+  data: SoundData;
+  isDecoding: boolean;
+  decoded: boolean;
+};
+
+/** A bitmap font: the glyph atlas and the descriptor parsed from it. */
+export type BitmapFontCacheEntry = {
+  url: string;
+  data: TextureSource;
+  font: BitmapFontData;
+  base: BaseTexture;
+};
+
+/** A text, JSON or XML payload under the URL it came from. */
+export type DataCacheEntry<T> = {
+  url: string;
+  data: T;
+};
+
+/** Anything the cache can hold, whichever bucket it lives in. */
+export type CacheEntry = ImageCacheEntry | SoundCacheEntry | BitmapFontCacheEntry | DataCacheEntry<unknown>;
+
 interface CacheBuckets {
-  canvas: Record<string, any>;
-  image: Record<string, any>;
-  texture: Record<string, any>;
-  sound: Record<string, any>;
-  text: Record<string, any>;
-  json: Record<string, any>;
-  xml: Record<string, any>;
-  bitmapData: Record<string, any>;
-  bitmapFont: Record<string, any>;
-  renderTexture: Record<string, any>;
+  canvas: Record<string, CacheEntry>;
+  image: Record<string, ImageCacheEntry>;
+  texture: Record<string, CacheEntry>;
+  sound: Record<string, SoundCacheEntry>;
+  text: Record<string, DataCacheEntry<string>>;
+  json: Record<string, DataCacheEntry<unknown>>;
+  xml: Record<string, DataCacheEntry<XMLDocument>>;
+  bitmapData: Record<string, CacheEntry>;
+  bitmapFont: Record<string, BitmapFontCacheEntry>;
+  renderTexture: Record<string, CacheEntry>;
 }
 
 export class Cache {
   public game!: Game;
-  public autoResolveURL!: any;
+  public autoResolveURL!: boolean;
   public _cache!: CacheBuckets;
-  public _urlMap!: any;
-  public _urlResolver!: any;
-  public _urlTemp!: any;
-  public onSoundUnlock!: any;
-  public _cacheMap!: Record<string, any>[];
+  public _urlMap!: Record<string, object> | null;
+  public _urlResolver!: HTMLImageElement | null;
+  public _urlTemp!: string | null;
+  public onSoundUnlock!: Signal;
+  public _cacheMap!: Record<string, CacheEntry>[];
   /**
    * Creates a new Cache instance.
    * @param {Game} game - The game instance.
@@ -81,7 +121,7 @@ export class Cache {
   /**
    * Adds the default image to the cache.
    */
-  public addDefaultImage() {
+  public addDefaultImage(): void {
     const img = new Image();
     img.src =
       'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgAQMAAABJtOi3AAAAA1BMVEX///+nxBvIAAAAAXRSTlMAQObYZgAAABVJREFUeF7NwIEAAAAAgKD9qdeocAMAoAABm3DkcAAAAABJRU5ErkJggg==';
@@ -93,7 +133,7 @@ export class Cache {
   /**
    * Adds the missing image to the cache.
    */
-  public addMissingImage() {
+  public addMissingImage(): void {
     const img = new Image();
     img.src =
       'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAIAAAD8GO2jAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAJ9JREFUeNq01ssOwyAMRFG46v//Mt1ESmgh+DFmE2GPOBARKb2NVjo+17PXLD8a1+pl5+A+wSgFygymWYHBb0FtsKhJDdZlncG2IzJ4ayoMDv20wTmSMzClEgbWYNTAkQ0Z+OJ+A/eWnAaR9+oxCF4Os0H8htsMUp+pwcgBBiMNnAwF8GqIgL2hAzaGFFgZauDPKABmowZ4GL369/0rwACp2yA/ttmvsQAAAABJRU5ErkJggg==';
@@ -108,7 +148,7 @@ export class Cache {
    * @param {HTMLImageElement} data - The image data to cache.
    * @returns {object} The cached image object.
    */
-  public addImage(key: string, url: string | null, data: HTMLImageElement) {
+  public addImage(key: string, url: string | null, data: HTMLImageElement): ImageCacheEntry {
     const resolvedUrl = url ?? '';
     if (this.checkImageKey(key)) {
       this.removeImage(key);
@@ -150,7 +190,7 @@ export class Cache {
     frameMax = -1,
     margin = 0,
     spacing = 0
-  ) {
+  ): void {
     const obj = {
       key,
       url,
@@ -169,14 +209,14 @@ export class Cache {
    * @param {HTMLCanvasElement} data - The canvas data for the atlas.
    * @param {object} atlasData - The atlas data to cache.
    */
-  public addTextureAtlas(key: string, url: string, data: HTMLCanvasElement, atlasData: any) {
-    const obj: any = {
+  public addTextureAtlas(key: string, url: string, data: TextureSource, atlasData: unknown): void {
+    const obj: ImageCacheEntry = {
       key,
       url,
       data,
       base: new BaseTexture(data),
+      frameData: JSONDataHash(this.game, atlasData, key),
     };
-    obj.frameData = JSONDataHash(this.game, atlasData, key);
     this._cache.image[key] = obj;
     this._resolveURL(url, obj);
   }
@@ -187,14 +227,15 @@ export class Cache {
    * @param {string} url - The URL the sound was loaded from.
    * @param {object} data - The sound data to cache.
    */
-  public addSound(key: string, url: string, data: any) {
-    this._cache.sound[key] = {
+  public addSound(key: string, url: string, data: SoundData): void {
+    const obj: SoundCacheEntry = {
       url,
       data,
       isDecoding: false,
       decoded: false,
     };
-    this._resolveURL(url, this._cache.sound[key]);
+    this._cache.sound[key] = obj;
+    this._resolveURL(url, obj);
   }
 
   /**
@@ -203,9 +244,10 @@ export class Cache {
    * @param {string} url - The URL the text was loaded from.
    * @param {string} data - The text data to cache.
    */
-  public addText(key: string, url: string, data: string) {
-    this._cache.text[key] = { url, data };
-    this._resolveURL(url, this._cache.text[key]);
+  public addText(key: string, url: string, data: string): void {
+    const obj: DataCacheEntry<string> = { url, data };
+    this._cache.text[key] = obj;
+    this._resolveURL(url, obj);
   }
 
   /**
@@ -221,23 +263,18 @@ export class Cache {
   public addBitmapFont(
     key: string,
     url: string,
-    data: HTMLCanvasElement,
-    atlasData: any,
+    data: TextureSource,
+    atlasData: unknown,
     atlasType: string,
     xSpacing = 0,
     ySpacing = 0
-  ) {
-    const obj: { url: string; data: unknown; font: object | null; base: BaseTexture } = {
-      url,
-      data,
-      font: null,
-      base: new BaseTexture(data),
-    };
-    if (atlasType === 'json') {
-      obj.font = jsonBitmapFont(atlasData, obj.base, xSpacing, ySpacing);
-    } else {
-      obj.font = xmlBitmapFont(atlasData, obj.base, xSpacing, ySpacing);
-    }
+  ): void {
+    const base = new BaseTexture(data);
+    const font =
+      atlasType === 'json'
+        ? jsonBitmapFont(atlasData, base, xSpacing, ySpacing)
+        : xmlBitmapFont(atlasData as XMLDocument, base, xSpacing, ySpacing);
+    const obj: BitmapFontCacheEntry = { url, data, font, base };
     this._cache.bitmapFont[key] = obj;
     this._resolveURL(url, obj);
   }
@@ -248,9 +285,10 @@ export class Cache {
    * @param {string} url - The URL the JSON was loaded from.
    * @param {object} data - The JSON data to cache.
    */
-  public addJSON(key: string, url: string, data: any) {
-    this._cache.json[key] = { url, data };
-    this._resolveURL(url, this._cache.json[key]);
+  public addJSON(key: string, url: string, data: unknown): void {
+    const obj: DataCacheEntry<unknown> = { url, data };
+    this._cache.json[key] = obj;
+    this._resolveURL(url, obj);
   }
 
   /**
@@ -259,9 +297,10 @@ export class Cache {
    * @param {string} url - The URL the XML was loaded from.
    * @param {XMLDocument} data - The XML data to cache.
    */
-  public addXML(key: string, url: string, data: XMLDocument) {
-    this._cache.xml[key] = { url, data };
-    this._resolveURL(url, this._cache.xml[key]);
+  public addXML(key: string, url: string, data: XMLDocument): void {
+    const obj: DataCacheEntry<XMLDocument> = { url, data };
+    this._cache.xml[key] = obj;
+    this._resolveURL(url, obj);
   }
 
   // SOUND
@@ -272,7 +311,7 @@ export class Cache {
    * @param {string} property - The property to update.
    * @param {any} value - The new value for the property.
    */
-  public updateSound(key: string, property: string, value: any) {
+  public updateSound<K extends keyof SoundCacheEntry>(key: string, property: K, value: SoundCacheEntry[K]): void {
     const sound = this.getSound(key);
     if (sound) {
       sound[property] = value;
@@ -284,8 +323,11 @@ export class Cache {
    * @param {string} key - The unique key for the cached sound.
    * @param {AudioBuffer} data - The decoded audio buffer.
    */
-  public decodedSound(key: string, data: AudioBuffer) {
+  public decodedSound(key: string, data: AudioBuffer): void {
     const sound = this.getSound(key);
+    if (!sound) {
+      return;
+    }
     sound.data = data;
     sound.decoded = true;
     sound.isDecoding = false;
@@ -296,8 +338,8 @@ export class Cache {
    * @param {string} key - The unique key for the cached sound.
    * @returns {boolean} True if the sound is decoded, false otherwise.
    */
-  public isSoundDecoded(key: string) {
-    const sound = this.getItem(key, SOUND, 'isSoundDecoded');
+  public isSoundDecoded(key: string): boolean | null {
+    const sound = this.getSound(key);
     if (sound) {
       return sound.decoded;
     }
@@ -309,8 +351,8 @@ export class Cache {
    * @param {string} key - The unique key for the cached sound.
    * @returns {boolean} True if the sound is ready, false otherwise.
    */
-  public isSoundReady(key: string) {
-    const sound = this.getItem(key, SOUND, 'isSoundDecoded');
+  public isSoundReady(key: string): boolean {
+    const sound = this.getSound(key);
     if (sound) {
       return sound.decoded && !this.game.sound.isLocked;
     }
@@ -325,7 +367,7 @@ export class Cache {
    * @param {string} key - The unique key for the cache entry.
    * @returns {boolean} True if the entry exists, false otherwise.
    */
-  public checkKey(cache: number, key: string) {
+  public checkKey(cache: number, key: string): boolean {
     if (this._cacheMap[cache]?.[key]) {
       return true;
     }
@@ -337,8 +379,9 @@ export class Cache {
    * @param {string} url - The URL to check.
    * @returns {boolean} True if the URL has been resolved and cached, false otherwise.
    */
-  public checkURL(url: string) {
-    if (this._urlMap[this._resolveURL(url)]) {
+  public checkURL(url: string): boolean {
+    const resolved = this._resolveURL(url);
+    if (resolved && this._urlMap?.[resolved]) {
       return true;
     }
     return false;
@@ -349,7 +392,7 @@ export class Cache {
    * @param {string} key - The unique key for the cache entry.
    * @returns {boolean} True if the entry exists, false otherwise.
    */
-  public checkCanvasKey(key: string) {
+  public checkCanvasKey(key: string): boolean {
     return this.checkKey(CANVAS, key);
   }
 
@@ -358,7 +401,7 @@ export class Cache {
    * @param {string} key - The unique key for the cache entry.
    * @returns {boolean} True if the entry exists, false otherwise.
    */
-  public checkImageKey(key: string) {
+  public checkImageKey(key: string): boolean {
     return this.checkKey(IMAGE, key);
   }
 
@@ -367,7 +410,7 @@ export class Cache {
    * @param {string} key - The unique key for the cache entry.
    * @returns {boolean} True if the entry exists, false otherwise.
    */
-  public checkTextureKey(key: string) {
+  public checkTextureKey(key: string): boolean {
     return this.checkKey(TEXTURE, key);
   }
 
@@ -376,7 +419,7 @@ export class Cache {
    * @param {string} key - The unique key for the cache entry.
    * @returns {boolean} True if the entry exists, false otherwise.
    */
-  public checkSoundKey(key: string) {
+  public checkSoundKey(key: string): boolean {
     return this.checkKey(SOUND, key);
   }
 
@@ -385,7 +428,7 @@ export class Cache {
    * @param {string} key - The unique key for the cache entry.
    * @returns {boolean} True if the entry exists, false otherwise.
    */
-  public checkTextKey(key: string) {
+  public checkTextKey(key: string): boolean {
     return this.checkKey(TEXT, key);
   }
 
@@ -394,7 +437,7 @@ export class Cache {
    * @param {string} key - The unique key for the cache entry.
    * @returns {boolean} True if the entry exists, false otherwise.
    */
-  public checkBitmapDataKey(key: string) {
+  public checkBitmapDataKey(key: string): boolean {
     return this.checkKey(BITMAPDATA, key);
   }
 
@@ -403,7 +446,7 @@ export class Cache {
    * @param {string} key - The unique key for the cache entry.
    * @returns {boolean} True if the entry exists, false otherwise.
    */
-  public checkBitmapFontKey(key: string) {
+  public checkBitmapFontKey(key: string): boolean {
     return this.checkKey(BITMAPFONT, key);
   }
 
@@ -412,7 +455,7 @@ export class Cache {
    * @param {string} key - The unique key for the cache entry.
    * @returns {boolean} True if the entry exists, false otherwise.
    */
-  public checkJSONKey(key: string) {
+  public checkJSONKey(key: string): boolean {
     return this.checkKey(JSONDATA, key);
   }
 
@@ -421,7 +464,7 @@ export class Cache {
    * @param {string} key - The unique key for the cache entry.
    * @returns {boolean} True if the entry exists, false otherwise.
    */
-  public checkXMLKey(key: string) {
+  public checkXMLKey(key: string): boolean {
     return this.checkKey(XML, key);
   }
 
@@ -435,13 +478,13 @@ export class Cache {
    * @param {string} property - TBD.
    * @returns {*} TBD.
    */
-  public getItem(key: string, cache: number, _method: string, property: string | null = null) {
+  public getItem(key: string, cache: number, _method: string, property: string | null = null): unknown {
     if (this.checkKey(cache, key)) {
-      const entry = this._cacheMap[cache]![key];
+      const entry = this._cacheMap[cache]![key]!;
       if (!property) {
         return entry;
       }
-      return entry[property];
+      return (entry as Record<string, unknown>)[property];
     }
     return null;
   }
@@ -451,8 +494,8 @@ export class Cache {
    * @param {string} key - TBD.
    * @returns {HTMLCanvasElement} TBD.
    */
-  public getCanvas(key: string) {
-    return this.getItem(key, CANVAS, 'getCanvas', 'canvas');
+  public getCanvas(key: string): HTMLCanvasElement | null {
+    return this.getItem(key, CANVAS, 'getCanvas', 'canvas') as HTMLCanvasElement | null;
   }
 
   /**
@@ -461,11 +504,11 @@ export class Cache {
    * @param {boolean} full - TBD.
    * @returns {HTMLImageElement} TBD.
    */
-  public getImage(key: any = '__default', full = false) {
-    let img = this.getItem(key, IMAGE, 'getImage');
-    if (img === null) {
-      img = this.getItem('__missing', IMAGE, 'getImage');
-    }
+  public getImage(key?: string | number, full?: false): TextureSource;
+  public getImage(key: string | number | undefined, full: true): ImageCacheEntry;
+  public getImage(key: string | number = '__default', full = false): TextureSource | ImageCacheEntry {
+    const img = (this.getItem(String(key), IMAGE, 'getImage') ??
+      this.getItem('__missing', IMAGE, 'getImage')) as ImageCacheEntry;
     if (full) {
       return img;
     }
@@ -477,8 +520,8 @@ export class Cache {
    * @param {string} key - TBD.
    * @returns {object} TBD.
    */
-  public getTextureFrame(key: string) {
-    return this.getItem(key, TEXTURE, 'getTextureFrame', 'frame');
+  public getTextureFrame(key: string): Frame | null {
+    return this.getItem(key, TEXTURE, 'getTextureFrame', 'frame') as Frame | null;
   }
 
   /**
@@ -486,8 +529,8 @@ export class Cache {
    * @param {string} key - TBD.
    * @returns {object} TBD.
    */
-  public getSound(key: string) {
-    return this.getItem(key, SOUND, 'getSound');
+  public getSound(key: string): SoundCacheEntry | null {
+    return this.getItem(key, SOUND, 'getSound') as SoundCacheEntry | null;
   }
 
   /**
@@ -495,8 +538,8 @@ export class Cache {
    * @param {string} key - TBD.
    * @returns {object} TBD.
    */
-  public getSoundData(key: string) {
-    return this.getItem(key, SOUND, 'getSoundData', 'data');
+  public getSoundData(key: string): SoundData | null {
+    return this.getItem(key, SOUND, 'getSoundData', 'data') as SoundData | null;
   }
 
   /**
@@ -504,8 +547,8 @@ export class Cache {
    * @param {string} key - TBD.
    * @returns {object} TBD.
    */
-  public getText(key: string) {
-    return this.getItem(key, TEXT, 'getText', 'data');
+  public getText(key: string): string | null {
+    return this.getItem(key, TEXT, 'getText', 'data') as string | null;
   }
 
   /**
@@ -513,7 +556,7 @@ export class Cache {
    * @param {string} key - TBD.
    * @returns {object} TBD.
    */
-  public getBitmapData(key: string) {
+  public getBitmapData(key: string): unknown {
     return this.getItem(key, BITMAPDATA, 'getBitmapData', 'data');
   }
 
@@ -522,8 +565,8 @@ export class Cache {
    * @param {string} key - TBD.
    * @returns {object} TBD.
    */
-  public getBitmapFont(key: string) {
-    return this.getItem(key, BITMAPFONT, 'getBitmapFont');
+  public getBitmapFont(key: string): BitmapFontCacheEntry | null {
+    return this.getItem(key, BITMAPFONT, 'getBitmapFont') as BitmapFontCacheEntry | null;
   }
 
   /**
@@ -534,7 +577,7 @@ export class Cache {
    * @returns {T} The cached JSON data.
    */
   public getJSON<T = unknown>(key: string, isClone = false): T {
-    const data = this.getItem(key, JSONDATA, 'getJSON', 'data');
+    const data = this.getItem(key, JSONDATA, 'getJSON', 'data') as T;
     return isClone ? structuredClone(data) : data;
   }
 
@@ -543,8 +586,8 @@ export class Cache {
    * @param {string} key - TBD.
    * @returns {XMLDocument} TBD.
    */
-  public getXML(key: string) {
-    return this.getItem(key, XML, 'getXML', 'data');
+  public getXML(key: string): XMLDocument | null {
+    return this.getItem(key, XML, 'getXML', 'data') as XMLDocument | null;
   }
 
   /**
@@ -552,8 +595,8 @@ export class Cache {
    * @param {string} key - TBD.
    * @returns {RenderTexture} TBD.
    */
-  public getRenderTexture(key: string) {
-    return this.getItem(key, RENDER_TEXTURE, 'getRenderTexture');
+  public getRenderTexture(key: string): CacheEntry | null {
+    return this.getItem(key, RENDER_TEXTURE, 'getRenderTexture') as CacheEntry | null;
   }
 
   // FRAME
@@ -564,8 +607,8 @@ export class Cache {
    * @param {number} cache - The cache type (CANVAS, IMAGE, etc.).
    * @returns {BaseTexture} The base texture.
    */
-  public getBaseTexture(key: string, cache: number = IMAGE) {
-    return this.getItem(key, cache, 'getBaseTexture', 'base');
+  public getBaseTexture(key: string, cache: number = IMAGE): BaseTexture | null {
+    return this.getItem(key, cache, 'getBaseTexture', 'base') as BaseTexture | null;
   }
 
   /**
@@ -574,8 +617,8 @@ export class Cache {
    * @param {number} cache - The cache type (CANVAS, IMAGE, etc.).
    * @returns {Frame} The frame.
    */
-  public getFrame(key: string, cache: number = IMAGE) {
-    return this.getItem(key, cache, 'getFrame', 'frame');
+  public getFrame(key: string, cache: number = IMAGE): Frame | null {
+    return this.getItem(key, cache, 'getFrame', 'frame') as Frame | null;
   }
 
   /**
@@ -584,7 +627,7 @@ export class Cache {
    * @param {number} cache - The cache type (CANVAS, IMAGE, etc.).
    * @returns {number} The number of frames.
    */
-  public getFrameCount(key: string, cache: number = IMAGE) {
+  public getFrameCount(key: string, cache: number = IMAGE): number {
     const data = this.getFrameData(key, cache);
     if (data) {
       return data.total;
@@ -599,7 +642,7 @@ export class Cache {
    * @returns {FrameData | null} The frame data, or null when the entry has none.
    */
   public getFrameData(key: string, cache: number = IMAGE): FrameData | null {
-    return this.getItem(key, cache, 'getFrameData', 'frameData');
+    return this.getItem(key, cache, 'getFrameData', 'frameData') as FrameData | null;
   }
 
   /**
@@ -608,7 +651,7 @@ export class Cache {
    * @param {number} cache - The cache type (CANVAS, IMAGE, etc.).
    * @returns {boolean} True if the entry has frame data, false otherwise.
    */
-  public hasFrameData(key: string, cache: number = IMAGE) {
+  public hasFrameData(key: string, cache: number = IMAGE): boolean {
     return this.getItem(key, cache, '', 'frameData') !== null;
   }
 
@@ -618,10 +661,10 @@ export class Cache {
    * @param {FrameData} frameData - The new frame data.
    * @param {number} cache - The cache type (CANVAS, IMAGE, etc.).
    */
-  public updateFrameData(key: string, frameData: FrameData, cache: number = IMAGE) {
+  public updateFrameData(key: string, frameData: FrameData, cache: number = IMAGE): void {
     const entry = this._cacheMap[cache]?.[key];
     if (entry) {
-      entry.frameData = frameData;
+      (entry as ImageCacheEntry).frameData = frameData;
     }
   }
 
@@ -632,7 +675,7 @@ export class Cache {
    * @param {number} cache - The cache type (CANVAS, IMAGE, etc.).
    * @returns {Frame} The frame at the specified index.
    */
-  public getFrameByIndex(key: string, index: number, cache: number = IMAGE) {
+  public getFrameByIndex(key: string, index: number, cache: number = IMAGE): Frame | null {
     const data = this.getFrameData(key, cache);
     if (data) {
       return data.getFrame(index);
@@ -647,7 +690,7 @@ export class Cache {
    * @param {number} cache - The cache type (CANVAS, IMAGE, etc.).
    * @returns {Frame} The frame with the specified name.
    */
-  public getFrameByName(key: string, name: string, cache: number = IMAGE) {
+  public getFrameByName(key: string, name: string, cache: number = IMAGE): Frame | null {
     const data = this.getFrameData(key, cache);
     if (data) {
       return data.getFrameByName(name);
@@ -663,7 +706,7 @@ export class Cache {
   public getURL(url: string) {
     const resolvedURL = this._resolveURL(url);
     if (resolvedURL) {
-      return this._urlMap[resolvedURL];
+      return this._urlMap?.[resolvedURL] ?? null;
     }
     this.game.logger.warn('Cache invalid url', { resolvedURL });
     return null;
@@ -674,10 +717,11 @@ export class Cache {
    * @param {object} cache - The cache type (CANVAS, IMAGE, etc.).
    * @returns {string[]} An array of cache keys.
    */
-  public getKeys(cache: any = IMAGE) {
+  public getKeys(cache: number = IMAGE): string[] {
     const result = [];
-    if (this._cacheMap[cache]) {
-      const keys = Object.keys(this._cacheMap[cache]);
+    const bucket = this._cacheMap[cache];
+    if (bucket) {
+      const keys = Object.keys(bucket);
       for (const key of keys) {
         if (key !== '__default' && key !== '__missing') {
           result.push(key);
@@ -693,7 +737,7 @@ export class Cache {
    * Removes a canvas cache entry.
    * @param {string} key - The unique key for the cache entry to remove.
    */
-  public removeCanvas(key: string) {
+  public removeCanvas(key: string): void {
     delete this._cache.canvas[key];
   }
 
@@ -702,9 +746,9 @@ export class Cache {
    * @param {string} key - The unique key for the cache entry to remove.
    * @param {boolean} destroyBaseTexture - Whether to destroy the base texture (default: true).
    */
-  public removeImage(key: string, destroyBaseTexture = true) {
+  public removeImage(key: string, destroyBaseTexture = true): void {
     const img = this.getImage(key, true);
-    if (destroyBaseTexture && img.base) {
+    if (destroyBaseTexture) {
       img.base.destroy();
     }
     delete this._cache.image[key];
@@ -714,7 +758,7 @@ export class Cache {
    * Removes a sound cache entry.
    * @param {string} key - The unique key for the cache entry to remove.
    */
-  public removeSound(key: string) {
+  public removeSound(key: string): void {
     delete this._cache.sound[key];
   }
 
@@ -722,7 +766,7 @@ export class Cache {
    * Removes a text cache entry.
    * @param {string} key - The unique key for the cache entry to remove.
    */
-  public removeText(key: string) {
+  public removeText(key: string): void {
     delete this._cache.text[key];
   }
 
@@ -730,7 +774,7 @@ export class Cache {
    * Removes a bitmap data cache entry.
    * @param {string} key - The unique key for the cache entry to remove.
    */
-  public removeBitmapData(key: string) {
+  public removeBitmapData(key: string): void {
     delete this._cache.bitmapData[key];
   }
 
@@ -738,7 +782,7 @@ export class Cache {
    * Removes a bitmap font cache entry.
    * @param {string} key - The unique key for the cache entry to remove.
    */
-  public removeBitmapFont(key: string) {
+  public removeBitmapFont(key: string): void {
     delete this._cache.bitmapFont[key];
   }
 
@@ -746,7 +790,7 @@ export class Cache {
    * Removes a JSON cache entry.
    * @param {string} key - The unique key for the cache entry to remove.
    */
-  public removeJSON(key: string) {
+  public removeJSON(key: string): void {
     delete this._cache.json[key];
   }
 
@@ -754,7 +798,7 @@ export class Cache {
    * Removes an XML cache entry.
    * @param {string} key - The unique key for the cache entry to remove.
    */
-  public removeXML(key: string) {
+  public removeXML(key: string): void {
     delete this._cache.xml[key];
   }
 
@@ -762,7 +806,7 @@ export class Cache {
    * Removes a render texture cache entry.
    * @param {string} key - The unique key for the cache entry to remove.
    */
-  public removeRenderTexture(key: string) {
+  public removeRenderTexture(key: string): void {
     delete this._cache.renderTexture[key];
   }
 
@@ -770,7 +814,7 @@ export class Cache {
    * Removes a sprite sheet cache entry.
    * @param {string} key - The unique key for the cache entry to remove.
    */
-  public removeSpriteSheet(key: string) {
+  public removeSpriteSheet(key: string): void {
     delete this._cache.image[key];
   }
 
@@ -778,17 +822,16 @@ export class Cache {
    * Removes a texture atlas cache entry.
    * @param {string} key - The unique key for the cache entry to remove.
    */
-  public removeTextureAtlas(key: string) {
+  public removeTextureAtlas(key: string): void {
     delete this._cache.image[key];
   }
 
   /**
    * Clears all GL textures from the cache.
    */
-  public clearGLTextures() {
-    const keys = Object.keys(this._cache.image);
-    for (const key of keys) {
-      this._cache.image[key].base._glTextures = [];
+  public clearGLTextures(): void {
+    for (const entry of Object.values(this._cache.image)) {
+      entry.base._glTextures = [];
     }
   }
 
@@ -798,16 +841,19 @@ export class Cache {
    * @param {object} data - The data to associate with the resolved URL.
    * @returns {string} The resolved URL or null if not enabled.
    */
-  public _resolveURL(url: string, data: any | null = null) {
+  public _resolveURL(url: string, data: object | null = null): string | null {
     if (!this.autoResolveURL) {
       return null;
     }
+    if (!this._urlResolver) {
+      return null;
+    }
     this._urlResolver.src = this.game.load.baseURL + url;
     this._urlTemp = this._urlResolver.src;
     //  Ensure no request is actually made
     this._urlResolver.src = '';
     //  Record the URL to the map
-    if (data) {
+    if (data && this._urlMap) {
       this._urlMap[this._urlTemp] = data;
     }
     return this._urlTemp;
@@ -816,14 +862,12 @@ export class Cache {
   /**
    * Destroys the cache and cleans up resources.
    */
-  public destroy() {
+  public destroy(): void {
     for (const cache of this._cacheMap) {
       const keys = cache ? Object.keys(cache) : [];
       for (const key of keys) {
         if (key !== '__default' && key !== '__missing') {
-          if (cache[key].destroy) {
-            cache[key].destroy();
-          }
+          (cache[key] as { destroy?: () => void }).destroy?.();
           delete cache[key];
         }
       }