@vpmedia/phaser 1.108.0 → 1.110.0

package/dist/index.js

@@ -1789,8 +1789,8 @@ const getBounds = (target, matrix = null) => {
 const getLocalBounds = (target) => {
 	const matrixCache = target.worldTransform;
 	target.worldTransform = getIdentityMatrix();
-	let i;
-	for (i = 0; i < target.children.length; i += 1) target.children[i].updateTransform();
+	let i = 0;
+	for (; i < target.children.length; i += 1) target.children[i].updateTransform();
 	const bounds = target.getBounds();
 	target.worldTransform = matrixCache;
 	for (i = 0; i < target.children.length; i += 1) target.children[i].updateTransform();
@@ -2104,7 +2104,7 @@ var DisplayObject = class {
 	removeChildAt(index) {
 		const child = this.getChildAt(index);
 		if (child) {
-			child.parent = void 0;
+			child.parent = null;
 			this.children.splice(index, 1);
 		}
 		return child;
@@ -2124,7 +2124,7 @@ var DisplayObject = class {
 			const removed = this.children.splice(beginIndex, range);
 			for (let i = 0; i < removed.length; i += 1) {
 				const child = removed[i];
-				child.parent = void 0;
+				child.parent = null;
 			}
 			return removed;
 		}
@@ -2300,8 +2300,9 @@ var DisplayObject = class {
 	/**
 	* Renders this display object using WebGL.
 	* @param {object} renderSession - The WebGL rendering session.
+	* @param {import('../geom/matrix.js').Matrix | null} _matrix - The transform matrix to render with.
 	*/
-	renderWebGL(renderSession) {
+	renderWebGL(renderSession, _matrix = null) {
 		if (!this.visible || this.alpha <= 0) return;
 		let i;
 		if (this._mask || this._filters) {
@@ -2726,7 +2727,7 @@ var Signal = class {
 	_registerListener(listener, isOnce = false, listenerContext = null, priority = 0, args = null) {
 		const prevIndex = this._indexOfListener(listener, listenerContext);
 		let binding;
-		if (prevIndex !== -1) {
+		if (prevIndex !== -1 && this._bindings) {
 			binding = this._bindings[prevIndex];
 			if (binding.isOnce() !== isOnce) throw new Error(`You cannot add${isOnce ? "" : "Once"}() then add${!isOnce ? "" : "Once"}() the same listener without removing the relationship first.`);
 		} else {
@@ -2807,7 +2808,7 @@ var Signal = class {
 	remove(listener, context = null) {
 		this.validateListener(listener, "remove");
 		const i = this._indexOfListener(listener, context);
-		if (i !== -1) {
+		if (i !== -1 && this._bindings) {
 			this._bindings[i]._destroy();
 			this._bindings.splice(i, 1);
 		}
@@ -2890,7 +2891,9 @@ var Signal = class {
 	*/
 	get boundDispatch() {
 		const _this = this;
-		if (!this._boundDispatch) this._boundDispatch = (...rest) => _this.dispatch(...rest);
+		if (!this._boundDispatch) this._boundDispatch = (...rest) => {
+			_this.dispatch(...rest);
+		};
 		return this._boundDispatch;
 	}
 	/**
@@ -3325,17 +3328,13 @@ var AnimationManager = class {
 	constructor(sprite) {
 		this.sprite = sprite;
 		this.game = sprite.game;
-		/** @type {import('./frame.js').Frame} */
 		this.currentFrame = null;
-		/** @type {Animation} */
 		this.currentAnim = null;
 		this.updateIfVisible = true;
 		this.isLoaded = false;
-		/** @type {import('./frame_data.js').FrameData} */
 		this._frameData = null;
 		/** @type {{[key: string]: Animation}} */
 		this._anims = {};
-		/** @type {number[]} */
 		this._outputFrames = [];
 	}
 	/**
@@ -4252,31 +4251,20 @@ var BitmapText = class extends DisplayObject {
 	*/
 	constructor(game, x = 0, y = 0, font = "", text = "", size = 32, align = "left") {
 		super(game);
-		/** @type {number} */
 		this.type = 6;
 		this.position.setTo(x, y);
-		/** @type {number} */
 		this.textWidth = 0;
-		/** @type {number} */
 		this.textHeight = 0;
-		/** @type {Point} */
 		this._prevAnchor = new Point();
 		this._glyphs = [];
-		/** @type {number} */
 		this._maxWidth = 0;
-		/** @type {string} */
 		this._text = text.toString() || "";
 		this._data = game.cache.getBitmapFont(font);
-		/** @type {string} */
 		this._font = font;
-		/** @type {number} */
 		this._fontSize = size;
-		/** @type {string} */
 		this._align = align;
-		/** @type {number} */
 		this._tint = 16777215;
 		this.updateText();
-		/** @type {boolean} */
 		this.dirty = false;
 	}
 	/**
@@ -4451,7 +4439,6 @@ var BitmapText = class extends DisplayObject {
 		const kept = [];
 		for (let i = 0; i < this._glyphs.length; i += 1) if (this._glyphs[i].parent !== this) this._glyphs[i].destroy();
 		else kept.push(this._glyphs[i]);
-		/** @type {Image[]} */
 		this._glyphs = [];
 		this._glyphs = kept;
 		this.updateText();
@@ -4750,6 +4737,8 @@ var InputHandler = class {
 				id: i,
 				x: 0,
 				y: 0,
+				camX: 0,
+				camY: 0,
 				isDown: false,
 				isUp: false,
 				isOver: false,
@@ -4795,6 +4784,8 @@ var InputHandler = class {
 			id: i,
 			x: 0,
 			y: 0,
+			camX: 0,
+			camY: 0,
 			isDown: false,
 			isUp: false,
 			isOver: false,
@@ -8696,10 +8687,11 @@ var Group = class extends DisplayObject {
 	}
 	/**
 	* Adds a child to this group.
-	* @param {DisplayObject} child - The child to add.
+	* @template T
+	* @param {T} child - The child to add.
 	* @param {boolean} silent - Whether to dispatch events.
 	* @param {number} index - The index to add the child at.
-	* @returns {DisplayObject} The added child.
+	* @returns {T} The added child.
 	*/
 	add(child, silent = false, index = -1) {
 		if (child.parent === this) return child;
@@ -8710,7 +8702,8 @@ var Group = class extends DisplayObject {
 			this.addChildAt(child, index);
 			this.updateZ();
 		}
-		if (this.inputEnableChildren && (!child.input || child.inputEnabled)) child.inputEnabled = true;
+		const inputChild = child;
+		if (this.inputEnableChildren && (!inputChild.input || inputChild.inputEnabled)) inputChild.inputEnabled = true;
 		if (!silent && child.events) child.events.onAddedToGroup$dispatch(child, this);
 		if (this.cursor === null) this.cursor = child;
 		return child;
@@ -11195,8 +11188,8 @@ var WebGLShaderManager = class {
 	* @param {number[]} attribs - The attribute locations to set up.
 	*/
 	setAttribs(attribs) {
-		let i;
-		for (i = 0; i < this.tempAttribState.length; i += 1) this.tempAttribState[i] = false;
+		let i = 0;
+		for (; i < this.tempAttribState.length; i += 1) this.tempAttribState[i] = false;
 		for (i = 0; i < attribs.length; i += 1) {
 			const attribId = attribs[i];
 			this.tempAttribState[attribId] = true;
@@ -12115,6 +12108,44 @@ var Frame = class {
 /**
 * TBD.
 * @param {import('./game.js').Game} game - TBD.
+* @param {string} key - TBD.
+* @param {number} frameWidth - TBD.
+* @param {number} frameHeight - TBD.
+* @param {number} frameMax - TBD.
+* @param {number} margin - TBD.
+* @param {number} spacing - TBD.
+* @returns {FrameData} TBD.
+*/
+const spriteSheet = (game, key, frameWidth, frameHeight, frameMax, margin, spacing) => {
+	let img = key;
+	if (typeof key === "string") img = game.cache.getImage(key);
+	if (img === null) return null;
+	const width = img.width;
+	const height = img.height;
+	if (frameWidth <= 0) frameWidth = Math.floor(-width / Math.min(-1, frameWidth));
+	if (frameHeight <= 0) frameHeight = Math.floor(-height / Math.min(-1, frameHeight));
+	let total = Math.floor((width - margin) / (frameWidth + spacing)) * Math.floor((height - margin) / (frameHeight + spacing));
+	if (frameMax !== -1) total = frameMax;
+	if (width === 0 || height === 0 || width < frameWidth || height < frameHeight || total === 0) {
+		game.logger.warn(`AnimationParser.spriteSheet: '${key}'s width/height zero or width/height < given frameWidth/frameHeight`);
+		return null;
+	}
+	const data = new FrameData();
+	let x = margin;
+	let y = margin;
+	for (let i = 0; i < total; i += 1) {
+		data.addFrame(new Frame(i, x, y, frameWidth, frameHeight, ""));
+		x += frameWidth + spacing;
+		if (x + frameWidth > width) {
+			x = margin;
+			y += frameHeight + spacing;
+		}
+	}
+	return data;
+};
+/**
+* TBD.
+* @param {import('./game.js').Game} game - TBD.
 * @param {object} json - TBD.
 * @returns {FrameData} TBD.
 */
@@ -12313,6 +12344,28 @@ var Cache = class {
 		return img;
 	}
 	/**
+	* Adds a sprite sheet to the cache.
+	* @param {string} key - The unique key for this cache entry.
+	* @param {string} url - The URL the sprite sheet was loaded from.
+	* @param {HTMLImageElement} data - The image data to cache.
+	* @param {number} frameWidth - The width of each frame in the sprite sheet.
+	* @param {number} frameHeight - The height of each frame in the sprite sheet.
+	* @param {number} frameMax - The maximum number of frames to parse (-1 for all).
+	* @param {number} margin - The margin around each frame in pixels.
+	* @param {number} spacing - The spacing between frames in pixels.
+	*/
+	addSpriteSheet(key, url, data, frameWidth, frameHeight, frameMax = -1, margin = 0, spacing = 0) {
+		const obj = {
+			key,
+			url,
+			data,
+			base: new BaseTexture(data),
+			frameData: spriteSheet(this.game, data, frameWidth, frameHeight, frameMax, margin, spacing)
+		};
+		this._cache.image[key] = obj;
+		this._resolveURL(url, obj);
+	}
+	/**
 	* Adds a texture atlas to the cache.
 	* @param {string} key - The unique key for this cache entry.
 	* @param {string} url - The URL the atlas was loaded from.
@@ -12622,10 +12675,11 @@ var Cache = class {
 		return this.getItem(key, 6, "getBitmapFont");
 	}
 	/**
-	* TBD.
-	* @param {string} key - TBD.
-	* @param {boolean} isClone - TBD.
-	* @returns {object} TBD.
+	* Gets JSON data from the cache.
+	* @template T
+	* @param {string} key - The unique key for the cache entry.
+	* @param {boolean} isClone - Whether to return a deep clone of the cached data.
+	* @returns {T} The cached JSON data.
 	*/
 	getJSON(key, isClone = false) {
 		const data = this.getItem(key, 7, "getJSON", "data");
@@ -12680,7 +12734,7 @@ var Cache = class {
 	* Gets the frame data of a cache entry.
 	* @param {string} key - The unique key for the cache entry.
 	* @param {number} cache - The cache type (CANVAS, IMAGE, etc.).
-	* @returns {FrameData} The frame data.
+	* @returns {FrameData | null} The frame data, or null when the entry has none.
 	*/
 	getFrameData(key, cache = 1) {
 		return this.getItem(key, cache, "getFrameData", "frameData");
@@ -12909,86 +12963,26 @@ var Device = class {
 	* This class provides information about the current device and browser capabilities.
 	*/
 	constructor() {
-		/**
-		* @type {boolean}
-		*/
 		this.desktop = false;
-		/**
-		* @type {boolean}
-		*/
 		this.iOS = false;
-		/**
-		* @type {boolean}
-		*/
 		this.android = false;
-		/**
-		* @type {boolean}
-		*/
 		this.chromeOS = false;
-		/**
-		* @type {boolean}
-		*/
 		this.linux = false;
-		/**
-		* @type {boolean}
-		*/
 		this.macOS = false;
-		/**
-		* @type {boolean}
-		*/
 		this.windows = false;
-		/**
-		* @type {boolean}
-		*/
 		this.windowsPhone = false;
-		/**
-		* @type {boolean}
-		*/
 		this.canvas = false;
-		/**
-		* @type {boolean}
-		*/
 		this.touch = false;
-		/**
-		* @type {boolean}
-		*/
 		this.mspointer = false;
 		this.wheelEvent = null;
-		/**
-		* @type {boolean}
-		*/
 		this.chrome = false;
-		/**
-		* @type {boolean}
-		*/
 		this.firefox = false;
-		/**
-		* @type {boolean}
-		*/
 		this.edge = false;
-		/**
-		* @type {boolean}
-		*/
 		this.safari = false;
-		/**
-		* @type {boolean}
-		*/
 		this.fullscreen = false;
-		/**
-		* @type {string}
-		*/
 		this.requestFullscreen = "";
-		/**
-		* @type {string}
-		*/
 		this.cancelFullscreen = "";
-		/**
-		* @type {boolean}
-		*/
 		this.fullscreenKeyboard = false;
-		/**
-		* @type {boolean}
-		*/
 		this.noAudioFormat = false;
 		/**
 		* @type {{[key: string]: boolean}}
@@ -13773,10 +13767,8 @@ var Pointer = class {
 	constructor(game, id, pointerMode) {
 		this.game = game;
 		this.id = id;
-		/** @type {number} */
 		this.type = 19;
 		this.exists = true;
-		/** @type {number} */
 		this.identifier = 0;
 		this.pointerId = null;
 		this.pointerMode = pointerMode || 3;
@@ -13784,43 +13776,27 @@ var Pointer = class {
 		this.button = null;
 		this._holdSent = false;
 		this._history = [];
-		/** @type {number} */
 		this._nextDrop = 0;
 		this._stateReset = false;
 		this.withinGame = false;
 		this.clientX = -1;
-		/** @type {number} */
 		this.clientY = -1;
-		/** @type {number} */
 		this.pageX = -1;
-		/** @type {number} */
 		this.pageY = -1;
-		/** @type {number} */
 		this.screenX = -1;
-		/** @type {number} */
 		this.screenY = -1;
-		/** @type {number} */
 		this.rawMovementX = 0;
-		/** @type {number} */
 		this.rawMovementY = 0;
-		/** @type {number} */
 		this.movementX = 0;
-		/** @type {number} */
 		this.movementY = 0;
-		/** @type {number} */
 		this.x = -1;
-		/** @type {number} */
 		this.y = -1;
 		this.isMouse = id === 0;
 		this.isDown = false;
 		this.isUp = true;
-		/** @type {number} */
 		this.timeDown = 0;
-		/** @type {number} */
 		this.timeUp = 0;
-		/** @type {number} */
 		this.previousTapTime = 0;
-		/** @type {number} */
 		this.totalTouches = 0;
 		this.msSinceLastClick = Number.MAX_VALUE;
 		this.targetObject = null;
@@ -15479,7 +15455,8 @@ var Loader = class {
 		xhr.open("GET", url, true);
 		xhr.responseType = type;
 		if (this.headers.requestedWith !== false) xhr.setRequestHeader("X-Requested-With", this.headers.requestedWith);
-		if (this.headers[file.type]) xhr.setRequestHeader("Accept", this.headers[file.type]);
+		const acceptHeader = this.headers[file.type];
+		if (acceptHeader) xhr.setRequestHeader("Accept", acceptHeader);
 		onerror = onerror || this.fileError;
 		xhr.onload = () => {
 			try {
@@ -15582,7 +15559,7 @@ var Loader = class {
 				this.cache.addSpriteSheet(file.key, file.url, file.data, file.frameWidth, file.frameHeight, file.frameMax, file.margin, file.spacing);
 				break;
 			case "textureatlas":
-				if (file.atlasURL == null) this.cache.addTextureAtlas(file.key, file.url, file.data, file.atlasData, file.format);
+				if (file.atlasURL == null) this.cache.addTextureAtlas(file.key, file.url, file.data, file.atlasData);
 				else {
 					loadNext = false;
 					if (file.format === TEXTURE_ATLAS_JSON_HASH) this.xhrLoad(file, this.transformUrl(file.atlasURL, file), "text", this.jsonLoadComplete);
@@ -15628,7 +15605,7 @@ var Loader = class {
 		const data = JSON.parse(xhr.responseText);
 		if (file.type === "bitmapfont") this.cache.addBitmapFont(file.key, file.url, file.data, data, file.atlasType, file.xSpacing, file.ySpacing);
 		else if (file.type === "json") this.cache.addJSON(file.key, file.url, data);
-		else this.cache.addTextureAtlas(file.key, file.url, file.data, data, file.format);
+		else this.cache.addTextureAtlas(file.key, file.url, file.data, data);
 		this.asyncComplete(file);
 	}
 	/**
@@ -15652,7 +15629,7 @@ var Loader = class {
 			return;
 		}
 		if (file.type === "bitmapfont") this.cache.addBitmapFont(file.key, file.url, file.data, xml, file.atlasType, file.xSpacing, file.ySpacing);
-		else if (file.type === "textureatlas") this.cache.addTextureAtlas(file.key, file.url, file.data, xml, file.format);
+		else if (file.type === "textureatlas") this.cache.addTextureAtlas(file.key, file.url, file.data, xml);
 		else if (file.type === "xml") this.cache.addXML(file.key, file.url, xml);
 		this.asyncComplete(file);
 	}
@@ -16003,7 +15980,7 @@ var DOM = class {
 	* @param {string} primaryFallback - The fallback method to use if screen orientation API is not available.
 	* @returns {string} The screen orientation ('portrait-primary', 'landscape-primary', etc.).
 	*/
-	getScreenOrientation(primaryFallback) {
+	getScreenOrientation(primaryFallback = null) {
 		const screen = window.screen;
 		const orientation = screen.orientation || screen.mozOrientation || screen.msOrientation;
 		if (orientation && typeof orientation.type === "string") return orientation.type;
@@ -16154,7 +16131,6 @@ var ScaleManager = class {
 		this.bounds = new Rectangle();
 		this.aspectRatio = 0;
 		this.sourceAspectRatio = 0;
-		/** @type {Event | null | undefined} */
 		this.event = null;
 		this.windowConstraints = {
 			right: "layout",
@@ -16338,7 +16314,7 @@ var ScaleManager = class {
 			this.onSizeChange.dispatch(this, width, height);
 			if (this.currentScaleMode === 3) {
 				this.game.state.resize(width, height);
-				this.game.load.resize(width, height);
+				this.game.load.resize();
 			}
 		}
 	}
@@ -16710,7 +16686,8 @@ var ScaleManager = class {
 		this.onFullScreenInit.dispatch(this, { targetElement: fsTarget });
 		if (this._createdFullScreenTarget) {
 			const canvas = this.game.canvas;
-			canvas.parentNode.insertBefore(fsTarget, canvas);
+			const parent = canvas.parentNode;
+			if (parent) parent.insertBefore(fsTarget, canvas);
 			fsTarget.appendChild(canvas);
 		}
 		if (this.game.device.fullscreenKeyboard) fsTarget[this.game.device.requestFullscreen](Element.ALLOW_KEYBOARD_INPUT);
@@ -16818,7 +16795,7 @@ var ScaleManager = class {
 	*/
 	get boundingParent() {
 		if (this.parentIsWindow || this.isFullScreen && this.hasPhaserSetFullScreen && !this._createdFullScreenTarget) return null;
-		return this.game.canvas && this.game.canvas.parentNode || null;
+		return (this.game.canvas ? this.game.canvas.parentNode : null) || null;
 	}
 	/**
 	* TBD.
@@ -17165,7 +17142,8 @@ var SceneManager = class {
 	}
 	/**
 	* Get the current scene state.
-	* @returns {Scene} The current scene state.
+	* @template T
+	* @returns {T} The current scene state.
 	*/
 	getCurrentState() {
 		return this.states[this.current];
@@ -18332,43 +18310,24 @@ var Timer = class {
 	*/
 	constructor(game, autoDestroy = false) {
 		this.game = game;
-		/** @type {boolean} */
 		this.running = false;
-		/** @type {boolean} */
 		this.autoDestroy = autoDestroy;
-		/** @type {boolean} */
 		this.expired = false;
-		/** @type {number} */
 		this.elapsed = 0;
-		/** @type {TimerEvent[]} */
 		this.events = [];
-		/** @type {Signal} */
 		this.onComplete = new Signal();
-		/** @type {number} */
 		this.nextTick = 0;
-		/** @type {number} */
 		this.timeCap = 1e3;
-		/** @type {boolean} */
 		this.paused = false;
-		/** @type {boolean} */
 		this._codePaused = false;
-		/** @type {number} */
 		this._started = 0;
-		/** @type {number} */
 		this._pauseStarted = 0;
-		/** @type {number} */
 		this._pauseTotal = 0;
-		/** @type {number} */
 		this._now = Date.now();
-		/** @type {number} */
 		this._len = 0;
-		/** @type {number} */
 		this._marked = 0;
-		/** @type {number} */
 		this._i = 0;
-		/** @type {number} */
 		this._diff = 0;
-		/** @type {number} */
 		this._newTick = 0;
 	}
 	/**
@@ -18686,56 +18645,31 @@ var Time = class {
 	*/
 	constructor(game) {
 		this.game = game;
-		/** @type {number} */
 		this.time = 0;
-		/** @type {number} */
 		this.prevTime = 0;
-		/** @type {number} */
 		this.now = 0;
-		/** @type {number} */
 		this.elapsed = 0;
-		/** @type {number} */
 		this.elapsedMS = 0;
-		/** @type {number} */
 		this.desiredFpsMult = 1 / 60;
-		/** @type {number} */
 		this._desiredFps = 60;
-		/** @type {number} */
 		this.suggestedFps = this.desiredFps;
-		/** @type {boolean} */
 		this.advancedTiming = false;
-		/** @type {number} */
 		this.frames = 0;
-		/** @type {number} */
 		this.fps = 0;
-		/** @type {number} */
 		this.fpsMin = 1e3;
-		/** @type {number} */
 		this.fpsMax = 0;
-		/** @type {number} */
 		this.msMin = 1e3;
-		/** @type {number} */
 		this.msMax = 0;
-		/** @type {number} */
 		this.pauseDuration = 0;
-		/** @type {number} */
 		this.timeToCall = 0;
-		/** @type {number} */
 		this.timeExpected = 0;
-		/** @type {Timer} */
 		this.events = new Timer(this.game, false);
-		/** @type {number} */
 		this._frameCount = 0;
-		/** @type {number} */
 		this._elapsedAccumulator = 0;
 		this._started = 0;
-		/** @type {number} */
 		this._timeLastSecond = 0;
-		/** @type {number} */
 		this._pauseStarted = 0;
-		/** @type {boolean} */
 		this._justResumed = false;
-		/** @type {Timer[]} */
 		this._timers = [];
 	}
 	/**