@vpmedia/phaser 1.126.0 → 1.127.0

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

@@ -0,0 +1,49 @@
+/**
+ * A minimal page lifecycle observer.
+ * @see https://developer.chrome.com/docs/web-platform/page-lifecycle-api
+ */
+/** The page is visible and has focus. */
+export declare const PAGE_STATE_ACTIVE = "active";
+/** The page is visible but does not have focus. */
+export declare const PAGE_STATE_PASSIVE = "passive";
+/** The page is not visible. */
+export declare const PAGE_STATE_HIDDEN = "hidden";
+/** The browser has frozen the page to reclaim its resources. */
+export declare const PAGE_STATE_FROZEN = "frozen";
+/** The page is being unloaded. */
+export declare const PAGE_STATE_TERMINATED = "terminated";
+/** One of the states a page can be in. */
+export type PageState = typeof PAGE_STATE_ACTIVE | typeof PAGE_STATE_PASSIVE | typeof PAGE_STATE_HIDDEN | typeof PAGE_STATE_FROZEN | typeof PAGE_STATE_TERMINATED;
+/** Called with the state the page has just entered and the one it left. */
+export type PageStateListener = (state: PageState, previous: PageState) => void;
+/**
+ * Reads the state the page is in right now.
+ * @returns {PageState} The current page state.
+ */
+export declare const readPageState: () => PageState;
+/**
+ * Starts observing the page, if it is not observed already.
+ */
+export declare const startPageLifecycle: () => void;
+/**
+ * Returns the state the page is in, starting the observer on first use.
+ * @returns {PageState} The current page state.
+ */
+export declare const getPageState: () => PageState;
+/**
+ * Registers a listener for every state change.
+ * @param {PageStateListener} listener - The listener to call on each change.
+ * @returns {() => void} A function that removes the listener again.
+ */
+export declare const onPageStateChange: (listener: PageStateListener) => (() => void);
+/**
+ * Runs a callback the next time the page becomes active, once.
+ * @param {() => void} callback - The callback to run.
+ * @returns {() => void} A function that cancels the pending callback.
+ */
+export declare const oncePageActive: (callback: () => void) => (() => void);
+/**
+ * Drops every listener and stops tracking. Only the tests need this.
+ */
+export declare const resetPageLifecycle: () => void;
+//# sourceMappingURL=page_lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"page_lifecycle.d.ts","sourceRoot":"","sources":["../../../src/phaser/core/page_lifecycle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yCAAyC;AACzC,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAC1C,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAC5C,+BAA+B;AAC/B,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAC1C,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAC1C,kCAAkC;AAClC,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD,0CAA0C;AAC1C,MAAM,MAAM,SAAS,GACjB,OAAO,iBAAiB,GACxB,OAAO,kBAAkB,GACzB,OAAO,iBAAiB,GACxB,OAAO,iBAAiB,GACxB,OAAO,qBAAqB,CAAC;AAEjC,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,KAAK,IAAI,CAAC;AAMhF;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAO,SAKhC,CAAC;AAkBF;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAO,IAkCrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAO,SAG/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAAc,iBAAiB,KAAG,CAAC,MAAM,IAAI,CAM1E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,aAAc,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAQhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAO,IAIrC,CAAC"}

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpmedia/phaser",
-  "version": "1.126.0",
+  "version": "1.127.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",
@@ -35,7 +35,6 @@
   },
   "dependencies": {
     "@logtape/logtape": "^2.3.3",
-    "@vpmedia/simplify": "^1.79.0",
     "uuid": "^14.0.2"
   },
   "devDependencies": {

package/src/index.ts

@@ -3,6 +3,19 @@ export * as Const from './phaser/core/const.js';
 export { GameObjectFactory } from './phaser/core/factory.js';
 export { Game } from './phaser/core/game.js';
 export type { GameConfig } from './phaser/core/game.js';
+export {
+  getPageState,
+  onPageStateChange,
+  oncePageActive,
+  PAGE_STATE_ACTIVE,
+  PAGE_STATE_FROZEN,
+  PAGE_STATE_HIDDEN,
+  PAGE_STATE_PASSIVE,
+  PAGE_STATE_TERMINATED,
+  readPageState,
+  startPageLifecycle,
+} from './phaser/core/page_lifecycle.js';
+export type { PageState, PageStateListener } from './phaser/core/page_lifecycle.js';
 export type {
   AppliedCallback,
   Callback,

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

@@ -0,0 +1,178 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import {
+  getPageState,
+  onPageStateChange,
+  oncePageActive,
+  PAGE_STATE_ACTIVE,
+  PAGE_STATE_FROZEN,
+  PAGE_STATE_HIDDEN,
+  PAGE_STATE_PASSIVE,
+  PAGE_STATE_TERMINATED,
+  readPageState,
+  resetPageLifecycle,
+  startPageLifecycle,
+} from './page_lifecycle.js';
+
+const setVisibility = (value: DocumentVisibilityState): void => {
+  Object.defineProperty(document, 'visibilityState', { value, configurable: true });
+};
+
+const setFocus = (value: boolean): void => {
+  document.hasFocus = (): boolean => value;
+};
+
+const dispatch = (type: string, init: EventInit = {}): void => {
+  globalThis.dispatchEvent(new Event(type, init));
+};
+
+describe('page lifecycle', () => {
+  afterEach(() => {
+    resetPageLifecycle();
+    setVisibility('visible');
+    setFocus(true);
+  });
+
+  describe('readPageState', () => {
+    it('reads a visible, focused page as active', () => {
+      setVisibility('visible');
+      setFocus(true);
+      expect(readPageState()).toBe(PAGE_STATE_ACTIVE);
+    });
+
+    it('reads a visible, unfocused page as passive', () => {
+      setVisibility('visible');
+      setFocus(false);
+      expect(readPageState()).toBe(PAGE_STATE_PASSIVE);
+    });
+
+    it('reads a hidden page as hidden', () => {
+      setVisibility('hidden');
+      setFocus(false);
+      expect(readPageState()).toBe(PAGE_STATE_HIDDEN);
+    });
+  });
+
+  describe('getPageState', () => {
+    it('starts the observer and reports the current state', () => {
+      setVisibility('visible');
+      setFocus(true);
+      expect(getPageState()).toBe(PAGE_STATE_ACTIVE);
+    });
+  });
+
+  describe('onPageStateChange', () => {
+    it('reports the state the page moved to and the one it left', () => {
+      setFocus(true);
+      startPageLifecycle();
+      const seen: string[][] = [];
+      onPageStateChange((state, previous) => {
+        seen.push([state, previous]);
+      });
+      setVisibility('hidden');
+      dispatch('visibilitychange');
+      expect(seen).toStrictEqual([[PAGE_STATE_HIDDEN, PAGE_STATE_ACTIVE]]);
+    });
+
+    it('says nothing when the state has not moved', () => {
+      setFocus(true);
+      startPageLifecycle();
+      const listener = vi.fn<(state: string, previous: string) => void>();
+      onPageStateChange(listener);
+      dispatch('visibilitychange');
+      expect(listener).not.toHaveBeenCalled();
+    });
+
+    it('stops reporting once the listener is removed', () => {
+      setFocus(true);
+      startPageLifecycle();
+      const listener = vi.fn<(state: string, previous: string) => void>();
+      onPageStateChange(listener)();
+      setVisibility('hidden');
+      dispatch('visibilitychange');
+      expect(listener).not.toHaveBeenCalled();
+    });
+
+    it('reports a freeze', () => {
+      startPageLifecycle();
+      const listener = vi.fn<(state: string, previous: string) => void>();
+      onPageStateChange(listener);
+      dispatch('freeze');
+      expect(listener).toHaveBeenCalledWith(PAGE_STATE_FROZEN, PAGE_STATE_ACTIVE);
+    });
+
+    it('reports an unloading page as terminated', () => {
+      startPageLifecycle();
+      const listener = vi.fn<(state: string, previous: string) => void>();
+      onPageStateChange(listener);
+      globalThis.dispatchEvent(new Event('pagehide'));
+      expect(listener).toHaveBeenCalledWith(PAGE_STATE_TERMINATED, PAGE_STATE_ACTIVE);
+    });
+
+    it('ignores focus events that came from an element rather than the page', () => {
+      setFocus(true);
+      startPageLifecycle();
+      const listener = vi.fn<(state: string, previous: string) => void>();
+      onPageStateChange(listener);
+      const input = document.createElement('input');
+      document.body.append(input);
+      setFocus(false);
+      input.dispatchEvent(new Event('blur', { bubbles: true }));
+      expect(listener).not.toHaveBeenCalled();
+      input.remove();
+    });
+  });
+
+  describe('oncePageActive', () => {
+    it('runs the callback the next time the page becomes active', () => {
+      setFocus(false);
+      setVisibility('hidden');
+      startPageLifecycle();
+      const callback = vi.fn<() => void>();
+      oncePageActive(callback);
+      setVisibility('visible');
+      setFocus(true);
+      dispatch('visibilitychange');
+      expect(callback).toHaveBeenCalledTimes(1);
+    });
+
+    it('runs the callback only once', () => {
+      setFocus(false);
+      setVisibility('hidden');
+      startPageLifecycle();
+      const callback = vi.fn<() => void>();
+      oncePageActive(callback);
+      setVisibility('visible');
+      setFocus(true);
+      dispatch('visibilitychange');
+      setVisibility('hidden');
+      setFocus(false);
+      dispatch('visibilitychange');
+      setVisibility('visible');
+      setFocus(true);
+      dispatch('visibilitychange');
+      expect(callback).toHaveBeenCalledTimes(1);
+    });
+
+    it('does not run the callback while the page stays hidden', () => {
+      setFocus(false);
+      setVisibility('hidden');
+      startPageLifecycle();
+      const callback = vi.fn<() => void>();
+      oncePageActive(callback);
+      dispatch('freeze');
+      expect(callback).not.toHaveBeenCalled();
+    });
+
+    it('cancels a pending callback', () => {
+      setFocus(false);
+      setVisibility('hidden');
+      startPageLifecycle();
+      const callback = vi.fn<() => void>();
+      oncePageActive(callback)();
+      setVisibility('visible');
+      setFocus(true);
+      dispatch('visibilitychange');
+      expect(callback).not.toHaveBeenCalled();
+    });
+  });
+});

package/src/phaser/core/page_lifecycle.ts

@@ -0,0 +1,142 @@
+/**
+ * A minimal page lifecycle observer.
+ * @see https://developer.chrome.com/docs/web-platform/page-lifecycle-api
+ */
+
+/** The page is visible and has focus. */
+export const PAGE_STATE_ACTIVE = 'active';
+/** The page is visible but does not have focus. */
+export const PAGE_STATE_PASSIVE = 'passive';
+/** The page is not visible. */
+export const PAGE_STATE_HIDDEN = 'hidden';
+/** The browser has frozen the page to reclaim its resources. */
+export const PAGE_STATE_FROZEN = 'frozen';
+/** The page is being unloaded. */
+export const PAGE_STATE_TERMINATED = 'terminated';
+
+/** One of the states a page can be in. */
+export type PageState =
+  | typeof PAGE_STATE_ACTIVE
+  | typeof PAGE_STATE_PASSIVE
+  | typeof PAGE_STATE_HIDDEN
+  | typeof PAGE_STATE_FROZEN
+  | typeof PAGE_STATE_TERMINATED;
+
+/** Called with the state the page has just entered and the one it left. */
+export type PageStateListener = (state: PageState, previous: PageState) => void;
+
+const listeners = new Set<PageStateListener>();
+let currentState: PageState | null = null;
+let started = false;
+
+/**
+ * Reads the state the page is in right now.
+ * @returns {PageState} The current page state.
+ */
+export const readPageState = (): PageState => {
+  if (document.visibilityState === 'hidden') {
+    return PAGE_STATE_HIDDEN;
+  }
+  return document.hasFocus() ? PAGE_STATE_ACTIVE : PAGE_STATE_PASSIVE;
+};
+
+/**
+ * Records a new state and tells the listeners, ignoring transitions to the state already held.
+ * @param {PageState} next - The state the page has entered.
+ */
+const enterState = (next: PageState): void => {
+  const previous = currentState ?? readPageState();
+  if (next === previous) {
+    return;
+  }
+  currentState = next;
+  const current = [...listeners];
+  for (const listener of current) {
+    listener(next, previous);
+  }
+};
+
+/**
+ * Starts observing the page, if it is not observed already.
+ */
+export const startPageLifecycle = (): void => {
+  if (started) {
+    return;
+  }
+  started = true;
+  currentState = readPageState();
+  for (const type of ['pageshow', 'focus', 'blur', 'visibilitychange', 'resume']) {
+    globalThis.addEventListener(
+      type,
+      (event: Event): void => {
+        // blur and focus also fire for elements inside the page, which say nothing about the page
+        const fromElement = event.target !== globalThis && event.target !== document;
+        if ((event.type === 'blur' || event.type === 'focus') && fromElement) {
+          return;
+        }
+        enterState(readPageState());
+      },
+      true
+    );
+  }
+  globalThis.addEventListener(
+    'freeze',
+    (): void => {
+      enterState(PAGE_STATE_FROZEN);
+    },
+    true
+  );
+  globalThis.addEventListener(
+    'pagehide',
+    (event: Event): void => {
+      enterState((event as PageTransitionEvent).persisted ? PAGE_STATE_FROZEN : PAGE_STATE_TERMINATED);
+    },
+    true
+  );
+};
+
+/**
+ * Returns the state the page is in, starting the observer on first use.
+ * @returns {PageState} The current page state.
+ */
+export const getPageState = (): PageState => {
+  startPageLifecycle();
+  return currentState ?? readPageState();
+};
+
+/**
+ * Registers a listener for every state change.
+ * @param {PageStateListener} listener - The listener to call on each change.
+ * @returns {() => void} A function that removes the listener again.
+ */
+export const onPageStateChange = (listener: PageStateListener): (() => void) => {
+  startPageLifecycle();
+  listeners.add(listener);
+  return (): void => {
+    listeners.delete(listener);
+  };
+};
+
+/**
+ * Runs a callback the next time the page becomes active, once.
+ * @param {() => void} callback - The callback to run.
+ * @returns {() => void} A function that cancels the pending callback.
+ */
+export const oncePageActive = (callback: () => void): (() => void) => {
+  const stop = onPageStateChange((state: PageState): void => {
+    if (state === PAGE_STATE_ACTIVE) {
+      stop();
+      callback();
+    }
+  });
+  return stop;
+};
+
+/**
+ * Drops every listener and stops tracking. Only the tests need this.
+ */
+export const resetPageLifecycle = (): void => {
+  listeners.clear();
+  currentState = null;
+  started = false;
+};

package/src/phaser/core/sound_manager.ts

@@ -1,10 +1,4 @@
 import type { Game } from './game.js';
-import {
-  addPageLifecycleCallback,
-  getPageLifecycleEventEmitter,
-  PAGE_LIFECYCLE_STATE_ACTIVE,
-  PAGE_LIFECYCLE_STATE_CHANGE_EVENT,
-} from '@vpmedia/simplify';
 import { ArraySet } from './array_set.js';
 import { AUDIO_DISABLED, AUDIO_STANDARD, AUDIO_WEBKIT } from './const.js';
 import { ENGINE_ERROR_CREATING_AUDIO_CONTEXT } from './error_code.js';
@@ -12,6 +6,7 @@ import { Signal } from './signal.js';
 import { Sound } from './sound.js';
 import { SoundSprite } from './sound_sprite.js';
 import type { Callback } from './callback.js';
+import { onPageStateChange, oncePageActive } from './page_lifecycle.js';
 
 export class SoundManager {
   public game!: Game;
@@ -115,7 +110,7 @@ export class SoundManager {
       this.addUnlockHandlers();
     }
     this.context.addEventListener('statechange', this.onContextStateChange, false);
-    getPageLifecycleEventEmitter().on(PAGE_LIFECYCLE_STATE_CHANGE_EVENT, this.onPageLifecycleChange);
+    onPageStateChange(this.onPageLifecycleChange);
   }
 
   /**
@@ -293,7 +288,7 @@ export class SoundManager {
       const typedError = error instanceof Error ? error : new Error(String(error));
       this.game.logger.fatal('SoundManager', { error: typedError, tags: { 'asset.key': key } });
       if (typedError.name === 'InvalidStateError') {
-        addPageLifecycleCallback(PAGE_LIFECYCLE_STATE_ACTIVE, (): void => {
+        oncePageActive((): void => {
           void this.decode(key);
         });
       } else if (typedError.name === 'EncodingError') {