@vpmedia/phaser 1.117.0 → 1.118.0

package/dist/phaser/core/tween_manager.d.ts

@@ -1,10 +1,12 @@
 import type { Game } from './game.js';
 import { Tween } from './tween.js';
+/** What a tween can be attached to: any object, or a list of them. */
+export type TweenTarget = object | object[];
 export declare class TweenManager {
     game: Game;
-    _tweens: any;
-    _add: any;
-    easeMap: any;
+    _tweens: Tween[];
+    _add: Tween[];
+    easeMap: Record<string, (k: number) => number>;
     /**
      * Creates a new TweenManager instance.
      * @param {Game} game - The game instance this manager belongs to.
@@ -14,7 +16,7 @@ export declare class TweenManager {
      * Get all tweens managed by this manager.
      * @returns {Tween[]} An array of all active tweens.
      */
-    getAll(): any;
+    getAll(): Tween[];
     /**
      * Remove all tweens from the manager.
      * This method removes all active and pending tweens.
@@ -25,7 +27,7 @@ export declare class TweenManager {
      * @param {object} obj - The object to remove tweens from.
      * @param {object[]} children - Optional array of child objects to remove tweens from.
      */
-    removeFrom(obj: any, children?: any[] | null): void;
+    removeFrom(obj: TweenTarget, children?: object[] | null): void;
     /**
      * Add a tween to the manager.
      * @param {Tween} tween - The tween to add.
@@ -36,7 +38,7 @@ export declare class TweenManager {
      * @param {object} object - The object to create a tween for.
      * @returns {Tween} The created Tween object.
      */
-    create(object: any): Tween;
+    create(object: TweenTarget): Tween;
     /**
      * Remove a tween from the manager.
      * @param {Tween | null | undefined} tween - The tween to remove.

package/dist/phaser/core/tween_manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tween_manager.d.ts","sourceRoot":"","sources":["../../../src/phaser/core/tween_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAmCnC,qBAAa,YAAY;IAChB,IAAI,EAAG,IAAI,CAAC;IACZ,OAAO,EAAG,GAAG,CAAC;IACd,IAAI,EAAG,GAAG,CAAC;IACX,OAAO,EAAG,GAAG,CAAC;IACrB;;;OAGG;IACH,YAAmB,IAAI,EAAE,IAAI,EAqD5B;IAED;;;OAGG;IACI,MAAM,QAEZ;IAED;;;OAGG;IACI,SAAS,IAAI,IAAI,CAKvB;IAED;;;;OAIG;IACI,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,GAAE,GAAG,EAAE,GAAG,IAAW,GAAG,IAAI,CAuB/D;IAED;;;OAGG;IACI,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAG7B;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,KAAK,CAEhC;IAED;;;OAGG;IACI,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAUnD;IAED;;;OAGG;IACI,MAAM,IAAI,OAAO,CAqBvB;IAED;;;;OAIG;IACI,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAE1C;IAED;;;OAGG;IACI,SAAS,IAAI,IAAI,CAIvB;IAED;;;OAGG;IACI,UAAU,IAAI,IAAI,CAIxB;IAED;;;OAGG;IACI,QAAQ,IAAI,IAAI,CAItB;IAED;;;OAGG;IACI,SAAS,IAAI,IAAI,CAIvB;CACF"}
+{"version":3,"file":"tween_manager.d.ts","sourceRoot":"","sources":["../../../src/phaser/core/tween_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAmCnC,sEAAsE;AACtE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAE5C,qBAAa,YAAY;IAChB,IAAI,EAAG,IAAI,CAAC;IACZ,OAAO,EAAG,KAAK,EAAE,CAAC;IAClB,IAAI,EAAG,KAAK,EAAE,CAAC;IACf,OAAO,EAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IACvD;;;OAGG;IACH,YAAmB,IAAI,EAAE,IAAI,EAqD5B;IAED;;;OAGG;IACI,MAAM,YAEZ;IAED;;;OAGG;IACI,SAAS,IAAI,IAAI,CAKvB;IAED;;;;OAIG;IACI,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,GAAE,MAAM,EAAE,GAAG,IAAW,GAAG,IAAI,CAwB1E;IAED;;;OAGG;IACI,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAG7B;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAExC;IAED;;;OAGG;IACI,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAanD;IAED;;;OAGG;IACI,MAAM,IAAI,OAAO,CAqBvB;IAED;;;;OAIG;IACI,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAE1C;IAED;;;OAGG;IACI,SAAS,IAAI,IAAI,CAIvB;IAED;;;OAGG;IACI,UAAU,IAAI,IAAI,CAIxB;IAED;;;OAGG;IACI,QAAQ,IAAI,IAAI,CAItB;IAED;;;OAGG;IACI,SAAS,IAAI,IAAI,CAIvB;CACF"}

package/dist/phaser/display/bitmap_text.d.ts

@@ -1,7 +1,17 @@
 import { Point } from '../geom/point.js';
 import { DisplayObject } from './display_object.js';
 import { Image } from './image.js';
+import type { BitmapFontCacheEntry } from '../core/cache.js';
 import type { Game } from '../core/game.js';
+import type { BitmapFontData } from '../core/loader_parser.js';
+/** One measured line of bitmap text: its width, its content and where each glyph starts. */
+export type BitmapTextLine = {
+    width: number;
+    text: string;
+    end: boolean;
+    chars: number[];
+    y: number;
+};
 export declare class BitmapText extends DisplayObject {
     type: number;
     pendingDestroy: boolean;
@@ -12,7 +22,7 @@ export declare class BitmapText extends DisplayObject {
     _glyphs: Image[];
     _maxWidth: number;
     _text: string;
-    _data: any;
+    _data: BitmapFontCacheEntry | null;
     _font: string;
     _fontSize: number;
     _align: string;
@@ -49,12 +59,7 @@ export declare class BitmapText extends DisplayObject {
      * @param {string} text - The text to scan.
      * @returns {{width: number, text: string, end: boolean, chars: number[]}} An object containing the width, processed text, end status, and character positions.
      */
-    scanLine(data: any, scale: number, text: string): {
-        width: number;
-        text: string;
-        end: boolean;
-        chars: number[];
-    };
+    scanLine(data: BitmapFontData, scale: number, text: string): Omit<BitmapTextLine, 'y'>;
     /**
      * Cleans the provided text by removing invalid characters and replacing them with a specified character.
      * @param {string} text - The text to clean.
@@ -131,7 +136,7 @@ export declare class BitmapText extends DisplayObject {
      * Sets the font size of this bitmap text.
      * @param {number} value - The new font size to use.
      */
-    set fontSize(value: any);
+    set fontSize(value: number | string);
     /**
      * Gets the text content of this bitmap text.
      * @returns {string} The current text content.

package/dist/phaser/display/bitmap_text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bitmap_text.d.ts","sourceRoot":"","sources":["../../../src/phaser/display/bitmap_text.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bitmap_text.d.ts","sourceRoot":"","sources":["../../../src/phaser/display/bitmap_text.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpmedia/phaser",
-  "version": "1.117.0",
+  "version": "1.118.0",
   "description": "@vpmedia/phaser is the modern ECMAScript port of the popular Phaser game engine v2.6.2",
   "author": "Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)",
   "license": "MIT",

package/src/phaser/core/animation_manager.ts

@@ -53,7 +53,7 @@ export class AnimationManager {
    * @param {string|number} frame - The frame index or name to set as current.
    * @returns {boolean} True if the frame data was loaded successfully, false otherwise.
    */
-  public loadFrameData(frameData: FrameData, frame: string | number): boolean {
+  public loadFrameData(frameData: FrameData | null, frame: string | number): boolean {
     if (!frameData) {
       return false;
     }

package/src/phaser/core/cache.test.ts

@@ -0,0 +1,201 @@
+import { beforeEach, describe, expect, it } from 'vitest';
+import { SCALE_LINEAR } from './const.js';
+import { BITMAPFONT, Cache, IMAGE, SOUND } from './cache.js';
+import { getRegistry } from './registry.js';
+import type { Game } from './game.js';
+
+const createGame = (): Game =>
+  ({
+    logger: { warn: (): void => undefined },
+    load: { baseURL: '' },
+    sound: { isLocked: false },
+  }) as unknown as Game;
+
+const createImage = (width = 4, height = 4): HTMLImageElement => {
+  const img = new Image();
+  Object.defineProperty(img, 'width', { value: width });
+  Object.defineProperty(img, 'height', { value: height });
+  return img;
+};
+
+const FONT_XML = `<?xml version="1.0"?>
+<font>
+  <info face="Arial" size="32" />
+  <common lineHeight="40" />
+  <chars>
+    <char id="65" x="0" y="0" width="20" height="30" xoffset="1" yoffset="2" xadvance="21" />
+  </chars>
+</font>`;
+
+describe('Cache', () => {
+  let cache: Cache;
+
+  beforeEach(() => {
+    getRegistry().TEXTURE_SCALE_MODE = SCALE_LINEAR;
+    cache = new Cache(createGame());
+  });
+
+  describe('images', () => {
+    it('seeds the default and missing images', () => {
+      expect(cache.checkImageKey('__default')).toBe(true);
+      expect(cache.checkImageKey('__missing')).toBe(true);
+    });
+
+    it('keeps the default image out of the reported keys', () => {
+      expect(cache.getKeys(IMAGE)).toStrictEqual([]);
+    });
+
+    it('returns the source bitmap by default and the whole entry when asked', () => {
+      const source = createImage();
+      cache.addImage('logo', 'logo.png', source);
+      expect(cache.getImage('logo')).toBe(source);
+      expect(cache.getImage('logo', true).key).toBe('logo');
+    });
+
+    it('falls back to the missing image for an unknown key', () => {
+      expect(cache.getImage('nope', true).key).toBe('__missing');
+    });
+
+    it('gives an image one frame covering the whole bitmap', () => {
+      cache.addImage('logo', 'logo.png', createImage(64, 32));
+      const frame = cache.getFrameByIndex('logo', 0);
+      expect(frame?.width).toBe(64);
+      expect(frame?.height).toBe(32);
+      expect(cache.getFrameCount('logo')).toBe(1);
+    });
+
+    it('reports no frames for a key it does not hold', () => {
+      expect(cache.getFrameData('nope')).toBeNull();
+      expect(cache.getFrameCount('nope')).toBe(0);
+      expect(cache.hasFrameData('nope')).toBe(false);
+    });
+
+    it('drops an image when it is removed', () => {
+      cache.addImage('logo', 'logo.png', createImage());
+      cache.removeImage('logo');
+      expect(cache.checkImageKey('logo')).toBe(false);
+    });
+
+    it('replaces an image registered twice under the same key', () => {
+      cache.addImage('logo', 'a.png', createImage(4, 4));
+      const second = createImage(8, 8);
+      cache.addImage('logo', 'b.png', second);
+      expect(cache.getImage('logo')).toBe(second);
+    });
+
+    it('clears the GL textures of every cached image', () => {
+      cache.addImage('logo', 'logo.png', createImage());
+      const entry = cache.getImage('logo', true);
+      entry.base._glTextures = [null];
+      cache.clearGLTextures();
+      expect(entry.base._glTextures).toStrictEqual([]);
+    });
+  });
+
+  describe('sounds', () => {
+    it('stores a sound as undecoded', () => {
+      cache.addSound('shot', 'shot.ogg', new ArrayBuffer(8));
+      expect(cache.isSoundDecoded('shot')).toBe(false);
+      expect(cache.isSoundReady('shot')).toBe(false);
+    });
+
+    it('reports an unknown sound as neither decoded nor ready', () => {
+      expect(cache.isSoundDecoded('nope')).toBeNull();
+      expect(cache.isSoundReady('nope')).toBe(false);
+    });
+
+    it('updates a single property of a cached sound', () => {
+      cache.addSound('shot', 'shot.ogg', new ArrayBuffer(8));
+      cache.updateSound('shot', 'isDecoding', true);
+      expect(cache.getSound('shot')?.isDecoding).toBe(true);
+    });
+
+    it('swaps in the decoded buffer and marks the sound ready', () => {
+      cache.addSound('shot', 'shot.ogg', new ArrayBuffer(8));
+      const buffer = { duration: 1.5 } as AudioBuffer;
+      cache.decodedSound('shot', buffer);
+      expect(cache.getSoundData('shot')).toBe(buffer);
+      expect(cache.isSoundDecoded('shot')).toBe(true);
+      expect(cache.isSoundReady('shot')).toBe(true);
+    });
+
+    it('ignores a decode result for a sound it never held', () => {
+      expect(() => {
+        cache.decodedSound('nope', {} as AudioBuffer);
+      }).not.toThrow();
+    });
+
+    it('drops a sound when it is removed', () => {
+      cache.addSound('shot', 'shot.ogg', new ArrayBuffer(8));
+      cache.removeSound('shot');
+      expect(cache.getSound('shot')).toBeNull();
+    });
+  });
+
+  describe('data', () => {
+    it('round-trips text', () => {
+      cache.addText('note', 'note.txt', 'hello');
+      expect(cache.getText('note')).toBe('hello');
+      cache.removeText('note');
+      expect(cache.getText('note')).toBeNull();
+    });
+
+    it('round-trips JSON', () => {
+      cache.addJSON('config', 'config.json', { a: 1 });
+      expect(cache.getJSON('config')).toStrictEqual({ a: 1 });
+    });
+
+    it('hands back a detached copy when a clone is asked for', () => {
+      const data = { a: 1 };
+      cache.addJSON('config', 'config.json', data);
+      const clone = cache.getJSON<{ a: number }>('config', true);
+      expect(clone).toStrictEqual(data);
+      expect(clone).not.toBe(data);
+    });
+
+    it('round-trips XML', () => {
+      const xml = new DOMParser().parseFromString('<root/>', 'text/xml');
+      cache.addXML('doc', 'doc.xml', xml);
+      expect(cache.getXML('doc')).toBe(xml);
+    });
+  });
+
+  describe('bitmap fonts', () => {
+    it('parses the descriptor and keeps it beside the atlas', () => {
+      const xml = new DOMParser().parseFromString(FONT_XML, 'text/xml');
+      cache.addBitmapFont('arial', 'arial.png', createImage(256, 256), xml, 'xml');
+      const entry = cache.getBitmapFont('arial');
+      expect(entry?.font.font).toBe('Arial');
+      expect(entry?.font.chars[65]?.xAdvance).toBe(21);
+      expect(entry?.base).toBeDefined();
+    });
+
+    it('reports a font it does not hold as absent', () => {
+      expect(cache.checkBitmapFontKey('nope')).toBe(false);
+      expect(cache.getBitmapFont('nope')).toBeNull();
+    });
+  });
+
+  describe('getItem', () => {
+    it('returns the whole entry when no property is named', () => {
+      cache.addText('note', 'note.txt', 'hello');
+      expect(cache.getItem('note', 4, 'test')).toStrictEqual({ url: 'note.txt', data: 'hello' });
+    });
+
+    it('returns null for a key the bucket does not hold', () => {
+      expect(cache.getItem('nope', SOUND, 'test')).toBeNull();
+      expect(cache.getItem('nope', BITMAPFONT, 'test', 'font')).toBeNull();
+    });
+  });
+
+  describe('destroy', () => {
+    it('empties every bucket but the built-in images', () => {
+      cache.addText('note', 'note.txt', 'hello');
+      cache.addSound('shot', 'shot.ogg', new ArrayBuffer(8));
+      cache.destroy();
+      expect(cache.getText('note')).toBeNull();
+      expect(cache.getSound('shot')).toBeNull();
+      expect(cache.checkImageKey('__default')).toBe(true);
+    });
+  });
+});