@vpmedia/phaser 1.116.0 → 1.118.0

package/src/phaser/core/loader.ts

@@ -8,6 +8,37 @@ import { Signal } from './signal.js';
 
 const TEXTURE_ATLAS_JSON_HASH = 1;
 
+/**
+ * What a completed load carries. Which member applies is decided by the file's type, so the
+ * completion handlers narrow before handing it to the cache.
+ */
+/** One entry in a pack manifest: the arguments for the loader call it stands for. */
+export type PackEntry = {
+  type: string;
+  key: string;
+  url?: string;
+  overwrite?: boolean;
+  frameWidth?: number;
+  frameHeight?: number;
+  frameMax?: number;
+  margin?: number;
+  spacing?: number;
+  urls?: string[] | string;
+  autoDecode?: boolean;
+  textureURL?: string;
+  atlasURL?: string;
+  atlasData?: unknown;
+  audioURL?: string;
+  jsonURL?: string;
+  jsonData?: unknown;
+  fontDataURL?: string;
+  xSpacing?: number;
+  ySpacing?: number;
+  format?: unknown;
+};
+
+export type LoaderFileData = HTMLImageElement | XMLDocument | ArrayBuffer | string | Record<string, unknown> | null;
+
 /** An audio source, either a plain URL or a URL paired with its format. */
 export type AudioSource = string | { uri: string; type?: string };
 
@@ -21,7 +52,7 @@ export type LoaderFile = {
   path: string;
   url: string | AudioSource[];
   syncPoint: boolean;
-  data: any;
+  data: LoaderFileData;
   loading: boolean;
   loaded: boolean;
   error: boolean;
@@ -124,7 +155,7 @@ export class Loader {
    * @param {Image} sprite - The image to use as the preload sprite.
    * @param {number} direction - The direction of the progress (0 = horizontal, 1 = vertical).
    */
-  public setPreloadSprite(sprite: Image, direction = 0) {
+  public setPreloadSprite(sprite: Image, direction = 0): void {
     this.preloadSprite = {
       sprite,
       direction,
@@ -146,7 +177,7 @@ export class Loader {
   /**
    * Resizes the preload sprite when the window is resized.
    */
-  public resize() {
+  public resize(): void {
     if (this.preloadSprite && this.preloadSprite.height !== this.preloadSprite.sprite.height) {
       this.preloadSprite.rect.height = this.preloadSprite.sprite.height;
     }
@@ -158,7 +189,7 @@ export class Loader {
    * @param {string} key - The key of the file to check for.
    * @returns {boolean} True if the file exists, false otherwise.
    */
-  public checkKeyExists(type: string, key: string) {
+  public checkKeyExists(type: string, key: string): boolean {
     return this.getAssetIndex(type, key) > -1;
   }
 
@@ -168,7 +199,7 @@ export class Loader {
    * @param {string} key - The key of the file to find.
    * @returns {number} The index of the file in the list, or -1 if not found.
    */
-  public getAssetIndex(type: string, key: string) {
+  public getAssetIndex(type: string, key: string): number {
     let bestFound = -1;
     for (let i = 0; i < this._fileList.length; i += 1) {
       const file = this._fileList[i]!;
@@ -203,7 +234,7 @@ export class Loader {
    * @param {boolean} hard - Whether to perform a hard reset (clears preload sprite).
    * @param {boolean} clearEvents - Whether to clear event listeners.
    */
-  public reset(hard = false, clearEvents = false) {
+  public reset(hard = false, clearEvents = false): void {
     if (hard) {
       this.preloadSprite = null;
     }
@@ -243,7 +274,7 @@ export class Loader {
     properties: Partial<LoaderFile> | null = null,
     overwrite = false,
     extension: string | null = null
-  ) {
+  ): this {
     if (key === undefined || key === '') {
       this.game.logger.warn(`Loader: Invalid or no key given of type ${type}`);
       return this;
@@ -292,7 +323,7 @@ export class Loader {
    * @param {object} properties - The new properties for the file.
    * @returns {Loader} This Loader instance for chaining.
    */
-  public replaceInFileList(type: string, key: string, url: string, properties: Partial<LoaderFile>) {
+  public replaceInFileList(type: string, key: string, url: string, properties: Partial<LoaderFile>): this {
     return this.addToFileList(type, key, url, properties, true);
   }
 
@@ -304,14 +335,14 @@ export class Loader {
    * @param {object} callbackContext - The context in which to call the callback.
    * @returns {Loader} This Loader instance for chaining.
    */
-  public pack(key: string, url: string, data: unknown, callbackContext: unknown) {
+  public pack(key: string, url: string, data: unknown, callbackContext: unknown): this {
     const pack = {
       type: 'packfile',
       key,
       url,
       path: this.path,
       syncPoint: true,
-      data: null as unknown,
+      data: null as LoaderFileData,
       loading: false,
       loaded: false,
       error: false,
@@ -321,7 +352,7 @@ export class Loader {
       if (typeof data === 'string') {
         data = JSON.parse(data);
       }
-      pack.data = data ?? {};
+      pack.data = (data ?? {}) as LoaderFileData;
       pack.loaded = true;
     }
     for (let i = 0; i < this._fileList.length + 1; i += 1) {
@@ -342,7 +373,7 @@ export class Loader {
    * @param {boolean} overwrite - Whether to overwrite an existing file with the same key.
    * @returns {Loader} This Loader instance for chaining.
    */
-  public image(key: string, url?: string, overwrite = false) {
+  public image(key: string, url?: string, overwrite = false): this {
     return this.addToFileList('image', key, url, undefined, overwrite, '.png');
   }
 
@@ -352,7 +383,7 @@ export class Loader {
    * @param {string[]} urls - The URLs of the image files to load.
    * @returns {Loader} This Loader instance for chaining.
    */
-  public images(keys: string[], urls: string[]) {
+  public images(keys: string[], urls: string[]): this {
     if (Array.isArray(urls)) {
       for (let i = 0; i < keys.length; i += 1) {
         this.image(keys[i]!, urls[i]);
@@ -372,7 +403,7 @@ export class Loader {
    * @param {boolean} overwrite - Whether to overwrite an existing file with the same key.
    * @returns {Loader} This Loader instance for chaining.
    */
-  public text(key: string, url: string, overwrite = false) {
+  public text(key: string, url: string, overwrite = false): this {
     return this.addToFileList('text', key, url, undefined, overwrite, '.txt');
   }
 
@@ -383,7 +414,7 @@ export class Loader {
    * @param {boolean} overwrite - Whether to overwrite an existing file with the same key.
    * @returns {Loader} This Loader instance for chaining.
    */
-  public json(key: string, url: string, overwrite = false) {
+  public json(key: string, url: string, overwrite = false): this {
     return this.addToFileList('json', key, url, undefined, overwrite, '.json');
   }
 
@@ -394,7 +425,7 @@ export class Loader {
    * @param {boolean} overwrite - Whether to overwrite an existing file with the same key.
    * @returns {Loader} This Loader instance for chaining.
    */
-  public xml(key: string, url: string, overwrite = false) {
+  public xml(key: string, url: string, overwrite = false): this {
     return this.addToFileList('xml', key, url, undefined, overwrite, '.xml');
   }
 
@@ -417,7 +448,7 @@ export class Loader {
     frameMax = -1,
     margin = 0,
     spacing = 0
-  ) {
+  ): this {
     return this.addToFileList(
       'spritesheet',
       key,
@@ -435,7 +466,7 @@ export class Loader {
    * @param {boolean} autoDecode - Whether to automatically decode the audio file.
    * @returns {Loader} This Loader instance for chaining.
    */
-  public audio(key: string, urls: string | string[], autoDecode = true) {
+  public audio(key: string, urls: string | string[], autoDecode = true): this {
     if (this.game.sound.noAudio || this.game.device.noAudioFormat) {
       return this;
     }
@@ -454,7 +485,7 @@ export class Loader {
    * @param {boolean} autoDecode - Whether to automatically decode the audio file.
    * @returns {Loader} This Loader instance for chaining.
    */
-  public audioSprite(key: string, urls: string, jsonURL: string, jsonData: unknown, autoDecode = true) {
+  public audioSprite(key: string, urls: string, jsonURL: string, jsonData: unknown, autoDecode = true): this {
     if (this.game.sound.noAudio || this.game.device.noAudioFormat) {
       return this;
     }
@@ -488,7 +519,7 @@ export class Loader {
     atlasData: unknown = null,
     xSpacing = 0,
     ySpacing = 0
-  ) {
+  ): this {
     textureURL ??= `${key}.png`;
     if (atlasURL === null && atlasData === null) {
       atlasURL = `${key}.xml`;
@@ -534,7 +565,7 @@ export class Loader {
     atlasURL: string | null = null,
     atlasData: unknown = null,
     format: number = TEXTURE_ATLAS_JSON_HASH
-  ) {
+  ): this {
     textureURL ??= `${key}.png`;
     if (!atlasURL && !atlasData) {
       atlasURL = `${key}.json`;
@@ -554,7 +585,7 @@ export class Loader {
    * @param {object} callbackContext - The context in which to call the callback.
    * @returns {Loader} This Loader instance for chaining.
    */
-  public withSyncPoint(callback: Function, callbackContext: unknown) {
+  public withSyncPoint(callback: Function, callbackContext: unknown): this {
     this._withSyncPointDepth += 1;
     try {
       callback.call(callbackContext ?? this, this);
@@ -570,7 +601,7 @@ export class Loader {
    * @param {string} key - The key of the file to add a sync point to.
    * @returns {Loader} This Loader instance for chaining.
    */
-  public addSyncPoint(type: string, key: string) {
+  public addSyncPoint(type: string, key: string): this {
     const asset = this.getAsset(type, key);
     if (asset) {
       asset.file.syncPoint = true;
@@ -583,7 +614,7 @@ export class Loader {
    * @param {string} type - The type of file to remove.
    * @param {string} key - The key of the file to remove.
    */
-  public removeFile(type: string, key: string) {
+  public removeFile(type: string, key: string): void {
     const asset = this.getAsset(type, key);
     if (asset) {
       if (!asset.file.loaded && !asset.file.loading) {
@@ -595,7 +626,7 @@ export class Loader {
   /**
    * Removes all files from the file list.
    */
-  public removeAll() {
+  public removeAll(): void {
     this._fileList.length = 0;
     this._flightQueue.length = 0;
   }
@@ -603,7 +634,7 @@ export class Loader {
   /**
    * Starts the loading process for all queued files.
    */
-  public start() {
+  public start(): void {
     if (this.isLoading) {
       return;
     }
@@ -616,7 +647,7 @@ export class Loader {
   /**
    * Processes the loading queue, loading files as appropriate.
    */
-  public processLoadQueue() {
+  public processLoadQueue(): void {
     if (!this.isLoading) {
       this.game.logger.warn('Active loading canceled / reset');
       this.finishedLoading(true);
@@ -705,7 +736,7 @@ export class Loader {
       // This indicates a critical internal error with no known recovery.
       this.game.logger.warn('Aborting: processing queue empty, loading may have stalled');
       const scope = this;
-      setTimeout(() => {
+      setTimeout((): void => {
         scope.finishedLoading(true);
       }, 2000);
     }
@@ -715,7 +746,7 @@ export class Loader {
    * Finishes the loading process, optionally reporting an abnormal termination.
    * @param {boolean} abnormal - Whether the loading was terminated abnormally.
    */
-  public finishedLoading(abnormal = false) {
+  public finishedLoading(abnormal = false): void {
     if (this.hasLoaded) {
       return;
     }
@@ -739,7 +770,7 @@ export class Loader {
    * @param {object} file - The file to complete or mark as failed.
    * @param {string} errorMessage - An error message if the file failed to load.
    */
-  public asyncComplete(file: LoaderFile, errorMessage = '') {
+  public asyncComplete(file: LoaderFile, errorMessage = ''): void {
     file.loaded = true;
     file.error = Boolean(errorMessage);
     if (file.error) {
@@ -754,53 +785,54 @@ export class Loader {
    * Processes a pack file, adding its contained files to the loader.
    * @param {object} pack - The pack file object to process.
    */
-  public processPack(pack: LoaderFile) {
-    const packData = pack.data[pack.key];
+  public processPack(pack: LoaderFile): void {
+    const manifest = (pack.data ?? {}) as Record<string, unknown>;
+    const packData = manifest[pack.key] as { files?: unknown[] } | unknown[] | undefined;
     if (!packData) {
       this.game.logger.warn('Missing loader pack key', { key: pack.key });
       return;
     }
-    const packDataCompat = Array.isArray(packData) ? packData : packData.files;
+    const packDataCompat = (Array.isArray(packData) ? packData : (packData.files ?? [])) as PackEntry[];
     for (const file of packDataCompat) {
       switch (file.type) {
         case 'image': {
-          this.image(file.key, file.url, file.overwrite);
+          this.image(file.key, file.url ?? file.key, file.overwrite);
           break;
         }
         case 'text': {
-          this.text(file.key, file.url, file.overwrite);
+          this.text(file.key, file.url ?? file.key, file.overwrite);
           break;
         }
         case 'json': {
-          this.json(file.key, file.url, file.overwrite);
+          this.json(file.key, file.url ?? file.key, file.overwrite);
           break;
         }
         case 'xml': {
-          this.xml(file.key, file.url, file.overwrite);
+          this.xml(file.key, file.url ?? file.key, file.overwrite);
           break;
         }
         case 'spritesheet': {
           this.spritesheet(
             file.key,
-            file.url,
-            file.frameWidth,
-            file.frameHeight,
-            file.frameMax,
+            file.url ?? file.key,
+            file.frameWidth ?? 0,
+            file.frameHeight ?? 0,
+            file.frameMax ?? -1,
             file.margin,
             file.spacing
           );
           break;
         }
         case 'audio': {
-          this.audio(file.key, file.urls ?? file.url);
+          this.audio(file.key, file.urls ?? file.url ?? file.key);
           break;
         }
         case 'audiosprite': {
-          this.audioSprite(file.key, file.urls ?? file.url, file.jsonURL, file.jsonData);
+          this.audioSprite(file.key, String(file.urls ?? file.url ?? file.key), file.jsonURL ?? '', file.jsonData);
           break;
         }
         case 'audioSprite': {
-          this.audioSprite(file.key, file.audioURL, file.jsonURL, file.jsonData);
+          this.audioSprite(file.key, file.audioURL ?? file.key, file.jsonURL ?? '', file.jsonData);
           break;
         }
         case 'bitmapFont': {
@@ -815,7 +847,7 @@ export class Loader {
           break;
         }
         case 'atlas': {
-          this.atlas(file.key, file.textureURL, file.atlasURL, file.atlasData, TEXTURE_ATLAS_JSON_HASH);
+          this.atlas(file.key, file.textureURL ?? file.key, file.atlasURL, file.atlasData, TEXTURE_ATLAS_JSON_HASH);
           break;
         }
       }
@@ -845,7 +877,7 @@ export class Loader {
    * Loads a file using XMLHttpRequest, handling image files specially.
    * @param {object} file - The file object to load.
    */
-  public loadFile(file: LoaderFile) {
+  public loadFile(file: LoaderFile): void {
     switch (file.type) {
       case 'packfile': {
         this.xhrLoad(file, this.transformUrl(file.url, file), 'text', this.fileComplete);
@@ -895,34 +927,40 @@ export class Loader {
    * Loads an image file using the Image DOM element.
    * @param {object} file - The file object to load.
    */
-  public loadImageTag(file: LoaderFile) {
+  public loadImageTag(file: LoaderFile): void {
     this.log('loadImageTag', file);
     const scope = this;
-    file.data = new globalThis.Image();
-    file.data.name = file.key;
-    if (this.crossOrigin) {
-      file.data.crossOrigin = this.crossOrigin;
+    const image = new globalThis.Image();
+    file.data = image;
+    image.name = file.key;
+    if (typeof this.crossOrigin === 'string' && this.crossOrigin) {
+      image.crossOrigin = this.crossOrigin;
     }
-    file.data.onload = () => {
-      if (file.data.onload) {
-        file.data.onload = null;
-        file.data.onerror = null;
+    image.onload = (): void => {
+      if (image.onload) {
+        image.onload = null;
+        image.onerror = null;
         scope.fileComplete(file);
       }
     };
-    file.data.onerror = () => {
+    image.onerror = (): void => {
       if (scope.isUseRetry && (!file.numRetry || file.numRetry < scope.maxRetry)) {
-        setTimeout(() => {
+        setTimeout((): void => {
           file.numRetry = !file.numRetry ? 1 : (file.numRetry += 1);
           scope.loadImageTag(file);
         }, 1000);
-      } else if (file.data.onload) {
-        file.data.onload = null;
-        file.data.onerror = null;
+      } else if (image.onload) {
+        image.onload = null;
+        image.onerror = null;
         scope.fileError(file);
       }
     };
-    file.data.src = this.transformUrl(file.url, file);
+    const src = this.transformUrl(file.url, file);
+    if (src === false) {
+      this.fileError(file, null, 'Could not resolve the file URL');
+      return;
+    }
+    image.src = src;
   }
 
   /**
@@ -939,7 +977,7 @@ export class Loader {
     type: XMLHttpRequestResponseType,
     onload: Function,
     onerror: Function | null = null
-  ) {
+  ): void {
     if (url === false) {
       this.fileError(file, null, 'Could not resolve the file URL');
       return;
@@ -963,7 +1001,7 @@ export class Loader {
         if (xhr.readyState === 4 && xhr.status >= 400 && xhr.status <= 599) {
           // Handle HTTP status codes of 4xx and 5xx as errors, even if xhr.onerror was not called.
           if (scope.isUseRetry && (!file.numRetry || file.numRetry < scope.maxRetry)) {
-            setTimeout(() => {
+            setTimeout((): void => {
               file.numRetry = !file.numRetry ? 1 : (file.numRetry += 1);
               scope.xhrLoad(file, url, type, onload, onerror);
             }, 1000);
@@ -986,7 +1024,7 @@ export class Loader {
     };
     xhr.onerror = () => {
       if (scope.isUseRetry && (!file.numRetry || file.numRetry < scope.maxRetry)) {
-        setTimeout(() => {
+        setTimeout((): void => {
           file.numRetry = !file.numRetry ? 1 : (file.numRetry += 1);
           scope.xhrLoad(file, url, type, onload, onerror);
         }, 1000);
@@ -1012,7 +1050,7 @@ export class Loader {
   /**
    * Placeholder for XDomainRequest loading (not implemented).
    */
-  public xhrLoadWithXDR() {
+  public xhrLoadWithXDR(): void {
     // TODO
     this.game.logger.warn('loader.xhrLoadWithXDR() is not implemented');
   }
@@ -1022,7 +1060,7 @@ export class Loader {
    * @param {object[]} urls - The array of URLs to check for supported audio formats.
    * @returns {string} The first URL with a supported audio format, or null if none found.
    */
-  public getAudioURL(urls: string | AudioSource[]) {
+  public getAudioURL(urls: string | AudioSource[]): string | null {
     if (this.game.sound.noAudio || this.game.device.noAudioFormat) {
       return null;
     }
@@ -1064,7 +1102,7 @@ export class Loader {
    * @param {XMLHttpRequest} xhr - The XMLHttpRequest object that failed.
    * @param {number | string} reason - The error code or message explaining the failure.
    */
-  public fileError(file: LoaderFile, xhr: XMLHttpRequest | null = null, reason: unknown = 0) {
+  public fileError(file: LoaderFile, xhr: XMLHttpRequest | null = null, reason: unknown = 0): void {
     // const url = file.requestUrl || this.transformUrl(file.url, file);
     if (!reason && xhr) {
       reason = xhr.status;
@@ -1079,7 +1117,7 @@ export class Loader {
    * @param {XMLHttpRequest} xhr - TBD.
    * @throws {Error}
    */
-  public fileComplete(file: LoaderFile, xhr?: XMLHttpRequest) {
+  public fileComplete(file: LoaderFile, xhr?: XMLHttpRequest): void {
     let loadNext = true;
     // By this point the audio candidate list has been resolved to a single URL.
     const url = typeof file.url === 'string' ? file.url : '';
@@ -1091,14 +1129,14 @@ export class Loader {
         break;
       }
       case 'image': {
-        this.cache.addImage(file.key, url, file.data);
+        this.cache.addImage(file.key, url, file.data as HTMLImageElement);
         break;
       }
       case 'spritesheet': {
         this.cache.addSpriteSheet(
           file.key,
           url,
-          file.data,
+          file.data as HTMLImageElement,
           file.frameWidth ?? 0,
           file.frameHeight ?? 0,
           file.frameMax ?? -1,
@@ -1109,7 +1147,7 @@ export class Loader {
       }
       case 'textureatlas': {
         if (file.atlasURL == null) {
-          this.cache.addTextureAtlas(file.key, url, file.data, file.atlasData);
+          this.cache.addTextureAtlas(file.key, url, file.data as HTMLImageElement, file.atlasData);
         } else {
           loadNext = false;
           if (file.format === TEXTURE_ATLAS_JSON_HASH) {
@@ -1125,7 +1163,7 @@ export class Loader {
           this.cache.addBitmapFont(
             file.key,
             url,
-            file.data,
+            file.data as HTMLImageElement,
             file.atlasData,
             file.atlasType ?? 'xml',
             file.xSpacing ?? 0,
@@ -1138,7 +1176,7 @@ export class Loader {
             file,
             this.transformUrl(file.atlasURL, file),
             'text',
-            (bitmapFontFile: LoaderFile, bitmapFontXhr: XMLHttpRequest) => {
+            (bitmapFontFile: LoaderFile, bitmapFontXhr: XMLHttpRequest): void => {
               let json;
               try {
                 // Try to parse as JSON, if it fails, then it's hopefully XML
@@ -1159,16 +1197,18 @@ export class Loader {
         break;
       }
       case 'audio': {
-        file.data = response.response;
-        this.cache.addSound(file.key, url, file.data);
+        const audio = response.response as ArrayBuffer;
+        file.data = audio;
+        this.cache.addSound(file.key, url, audio);
         if (file.autoDecode) {
           this.game.sound.decode(file.key);
         }
         break;
       }
       case 'text': {
-        file.data = response.responseText;
-        this.cache.addText(file.key, url, file.data);
+        const { responseText } = response;
+        file.data = responseText;
+        this.cache.addText(file.key, url, responseText);
         break;
       }
       default: {
@@ -1186,14 +1226,14 @@ export class Loader {
    * @param {object} file - The file object that was loaded successfully.
    * @param {XMLHttpRequest} xhr - The XMLHttpRequest object containing the file data.
    */
-  public jsonLoadComplete(file: LoaderFile, xhr: XMLHttpRequest) {
+  public jsonLoadComplete(file: LoaderFile, xhr: XMLHttpRequest): void {
     const data = JSON.parse(xhr.responseText);
     const url = typeof file.url === 'string' ? file.url : '';
     if (file.type === 'bitmapfont') {
       this.cache.addBitmapFont(
         file.key,
         url,
-        file.data,
+        file.data as HTMLImageElement,
         data,
         file.atlasType ?? 'json',
         file.xSpacing ?? 0,
@@ -1202,7 +1242,7 @@ export class Loader {
     } else if (file.type === 'json') {
       this.cache.addJSON(file.key, url, data);
     } else {
-      this.cache.addTextureAtlas(file.key, url, file.data, data);
+      this.cache.addTextureAtlas(file.key, url, file.data as HTMLImageElement, data);
     }
     this.asyncComplete(file);
   }
@@ -1210,7 +1250,7 @@ export class Loader {
   /**
    * TBD.
    */
-  public csvLoadComplete() {
+  public csvLoadComplete(): void {
     // TODO
     this.game.logger.warn('loader.csvLoadComplete() is not implemented');
   }
@@ -1220,7 +1260,7 @@ export class Loader {
    * @param {object} file - The file object containing the JSON data.
    * @param {XMLHttpRequest} xhr - The XMLHttpRequest object containing the file data.
    */
-  public xmlLoadComplete(file: LoaderFile, xhr: XMLHttpRequest) {
+  public xmlLoadComplete(file: LoaderFile, xhr: XMLHttpRequest): void {
     // Always try parsing the content as XML, regardless of actually response type
     const data = xhr.responseText;
     const xml = this.parseXml(data);
@@ -1235,14 +1275,14 @@ export class Loader {
       this.cache.addBitmapFont(
         file.key,
         url,
-        file.data,
+        file.data as HTMLImageElement,
         xml,
         file.atlasType ?? 'xml',
         file.xSpacing ?? 0,
         file.ySpacing ?? 0
       );
     } else if (file.type === 'textureatlas') {
-      this.cache.addTextureAtlas(file.key, url, file.data, xml);
+      this.cache.addTextureAtlas(file.key, url, file.data as HTMLImageElement, xml);
     } else if (file.type === 'xml') {
       this.cache.addXML(file.key, url, xml);
     }
@@ -1278,7 +1318,7 @@ export class Loader {
   /**
    * Updates the preload sprite's progress indicator.
    */
-  public updateProgress() {
+  public updateProgress(): void {
     if (this.preloadSprite) {
       if (this.preloadSprite.direction === 0) {
         this.preloadSprite.rect.width = Math.floor((this.preloadSprite.width / 100) * this.progress);
@@ -1299,7 +1339,7 @@ export class Loader {
    * @param {string} message - The message to log.
    * @param {string|object} data - Additional data to log with the message.
    */
-  public log(message: string, data: string | any = '') {
+  public log(message: string, data: string | any = ''): void {
     if (!this.isUseLog) {
       return;
     }
@@ -1310,7 +1350,7 @@ export class Loader {
    * Gets the number of files that have been loaded.
    * @returns {number} The total number of loaded files.
    */
-  public totalLoadedFiles() {
+  public totalLoadedFiles(): number {
     return this._loadedFileCount;
   }
 
@@ -1318,7 +1358,7 @@ export class Loader {
    * Gets the number of files that are still queued for loading.
    * @returns {number} The total number of queued files.
    */
-  public totalQueuedFiles() {
+  public totalQueuedFiles(): number {
     return this._totalFileCount - this._loadedFileCount;
   }
 
@@ -1326,7 +1366,7 @@ export class Loader {
    * Gets the number of pack files that have been loaded.
    * @returns {number} The total number of loaded pack files.
    */
-  public totalLoadedPacks() {
+  public totalLoadedPacks(): number {
     return this._totalPackCount;
   }
 
@@ -1334,7 +1374,7 @@ export class Loader {
    * Gets the number of pack files that are still queued for loading.
    * @returns {number} The total number of queued pack files.
    */
-  public totalQueuedPacks() {
+  public totalQueuedPacks(): number {
     return this._totalPackCount - this._loadedPackCount;
   }
 
@@ -1342,7 +1382,7 @@ export class Loader {
    * Gets the loading progress as a percentage (0-100).
    * @returns {number} The current loading progress as a percentage.
    */
-  public get progressFloat() {
+  public get progressFloat(): number {
     const progress = (this._loadedFileCount / this._totalFileCount) * 100;
     return Math.max(0, Math.min(100, progress || 0));
   }
@@ -1351,7 +1391,7 @@ export class Loader {
    * Gets the loading progress as a rounded percentage (0-100).
    * @returns {number} The current loading progress as a rounded percentage.
    */
-  public get progress() {
+  public get progress(): number {
     return Math.round(this.progressFloat);
   }
 }