@vpmedia/phaser 1.11.0 → 1.13.0

package/README.md

@@ -1,7 +1,7 @@
 @vpmedia/phaser
 ===============
 
-[![npm version](https://badge.fury.io/js/@vpmedia%2Fphaser.svg?v=1.11.0)](https://badge.fury.io/js/@vpmedia%2Fphaser)
+[![npm version](https://badge.fury.io/js/@vpmedia%2Fphaser.svg?v=1.13.0)](https://badge.fury.io/js/@vpmedia%2Fphaser)
 [![Node.js CI](https://github.com/vpmedia/phaser/actions/workflows/node.js.yml/badge.svg)](https://github.com/vpmedia/phaser/actions/workflows/node.js.yml)
 
 @vpmedia/phaser is the modern ECMAScript port of the popular Phaser game engine v2.6.2.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpmedia/phaser",
-  "version": "1.11.0",
+  "version": "1.13.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",
@@ -20,22 +20,25 @@
     "canvas"
   ],
   "main": "./src/index.js",
+  "types": "./types/index.d.ts",
   "devDependencies": {
-    "eslint": "^8.36.0",
+    "eslint": "^8.38.0",
     "eslint-config-prettier": "^8.8.0",
     "eslint-plugin-import": "^2.27.5",
     "eslint-plugin-jest": "^27.2.1",
-    "eslint-plugin-jsdoc": "^40.1.0",
+    "eslint-plugin-jsdoc": "^41.1.2",
     "eslint-plugin-prettier": "^4.2.1",
     "husky": "^8.0.3",
     "jest": "^29.5.0",
-    "lint-staged": "^13.2.0",
-    "prettier": "^2.8.7"
+    "lint-staged": "^13.2.1",
+    "prettier": "^2.8.7",
+    "typescript": "^5.0.4"
   },
   "scripts": {
     "test": "NODE_OPTIONS=--experimental-vm-modules jest --passWithNoTests",
     "lint": "eslint \"**/*.js\"",
     "lint-fix": "eslint \"**/*.js\" --fix",
+    "typecheck": "tsc",
     "format": "prettier --write \"**/*.{js,json}\"",
     "lint-staged": "lint-staged"
   },

package/src/index.js

@@ -1,32 +1,32 @@
 /**
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
 // core
 import * as Const from './phaser/core/const';
-import Game from './phaser/core/game';
-import Signal from './phaser/core/signal';
+import { Game } from './phaser/core/game';
+import { Signal } from  './phaser/core/signal';
 import * as MathUtils from './phaser/util/math';
 // texture
-import BaseTexture from './phaser/display/webgl/base_texture';
-import Texture from './phaser/display/webgl/texture';
+import { BaseTexture } from './phaser/display/webgl/base_texture';
+import { Texture } from './phaser/display/webgl/texture';
 // geom
-import Circle from './phaser/geom/circle';
-import Ellipse from './phaser/geom/ellipse';
-import Line from './phaser/geom/line';
-import Matrix from './phaser/geom/matrix';
-import Point from './phaser/geom/point';
-import Polygon from './phaser/geom/polygon';
-import Rectangle from './phaser/geom/rectangle';
-import RoundedRectangle from './phaser/geom/rounded_rectangle';
+import { Circle } from  './phaser/geom/circle';
+import { Ellipse } from  './phaser/geom/ellipse';
+import { Line } from  './phaser/geom/line';
+import { Matrix } from  './phaser/geom/matrix';
+import { Point } from './phaser/geom/point';
+import { Polygon } from  './phaser/geom/polygon';
+import { Rectangle } from  './phaser/geom/rectangle';
+import { RoundedRectangle } from  './phaser/geom/rounded_rectangle';
 // display
-import BitmapText from './phaser/display/bitmap_text';
-import DisplayObject from './phaser/display/display_object';
-import Button from './phaser/display/button';
-import Image from './phaser/display/image';
-import Group from './phaser/display/group';
-import Text from './phaser/display/text';
+import { BitmapText } from  './phaser/display/bitmap_text';
+import { DisplayObject } from  './phaser/display/display_object';
+import { Button } from  './phaser/display/button';
+import { Image } from './phaser/display/image';
+import { Group } from  './phaser/display/group';
+import { Text } from  './phaser/display/text';
 // exports
 export {
   Const,

package/src/phaser/core/animation.js

@@ -1,12 +1,11 @@
 /**
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
-import Signal from './signal';
-
-export default class {
+import { Signal } from  './signal';
 
+export class Animation {
   constructor(game, parent, name, frameData, frames, frameRate, loop = false) {
     this.game = game;
     this._parent = parent;
@@ -158,7 +157,7 @@ export default class {
       if (this._frameDiff > this.delay) {
         //  We need to skip a frame, work out how many
         this._frameSkip = Math.floor(this._frameDiff / this.delay);
-        this._frameDiff -= (this._frameSkip * this.delay);
+        this._frameDiff -= this._frameSkip * this.delay;
       }
       //  And what's left now?
       this._timeNextFrame = this.game.time.time + (this.delay - this._frameDiff);
@@ -167,7 +166,10 @@ export default class {
       } else {
         this._frameIndex += this._frameSkip;
       }
-      if (!this.isReversed && this._frameIndex >= this._frames.length || this.isReversed && this._frameIndex <= -1) {
+      if (
+        (!this.isReversed && this._frameIndex >= this._frames.length) ||
+        (this.isReversed && this._frameIndex <= -1)
+      ) {
         if (this.loop) {
           // Update current state before event callback
           this._frameIndex = Math.abs(this._frameIndex) % this._frames.length;
@@ -249,7 +251,9 @@ export default class {
 
   updateFrameData(frameData) {
     this._frameData = frameData;
-    this.currentFrame = this._frameData ? this._frameData.getFrame(this._frames[this._frameIndex % this._frames.length]) : null;
+    this.currentFrame = this._frameData
+      ? this._frameData.getFrame(this._frames[this._frameIndex % this._frames.length])
+      : null;
   }
 
   destroy() {
@@ -340,7 +344,7 @@ export default class {
   }
 
   get enableUpdate() {
-    return (this.onUpdate !== null);
+    return this.onUpdate !== null;
   }
 
   set enableUpdate(value) {
@@ -351,5 +355,4 @@ export default class {
       this.onUpdate = null;
     }
   }
-
 }

package/src/phaser/core/animation_manager.js

@@ -1,12 +1,11 @@
 /**
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
-import Animation from './animation';
+import { Animation } from './animation';
 
 export default class {
-
   constructor(sprite) {
     this.sprite = sprite;
     this.game = sprite.game;
@@ -90,7 +89,15 @@ export default class {
     }
     this._outputFrames = [];
     this._frameData.getFrameIndexes(frames, useNumericIndex, this._outputFrames);
-    this._anims[name] = new Animation(this.game, this.sprite, name, this._frameData, this._outputFrames, frameRate, loop);
+    this._anims[name] = new Animation(
+      this.game,
+      this.sprite,
+      name,
+      this._frameData,
+      this._outputFrames,
+      frameRate,
+      loop
+    );
     this.currentAnim = this._anims[name];
     if (this.sprite.tilingTexture) {
       this.sprite.refreshTexture = true;
@@ -224,7 +231,11 @@ export default class {
   }
 
   set frameName(value) {
-    if (typeof value === 'string' && this._frameData && this._frameData.getFrameByName(value) !== null) {
+    if (
+      typeof value === 'string' &&
+      this._frameData &&
+      this._frameData.getFrameByName(value) !== null
+    ) {
       this.currentFrame = this._frameData.getFrameByName(value);
       if (this.currentFrame) {
         this._frameIndex = this.currentFrame.index;
@@ -234,5 +245,4 @@ export default class {
       console.warn('Cannot set frameName: ' + value);
     }
   }
-
 }

package/src/phaser/core/animation_parser.js

@@ -1,21 +1,22 @@
 /**
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
-import Frame from './frame';
-import FrameData from './frame_data';
+import { Frame } from './frame';
+import { FrameData } from './frame_data';
 
 /**
+ * TBD.
  *
- * @param {object} game TBD
- * @param {object} key TBD
- * @param {number} frameWidth TBD
- * @param {number} frameHeight TBD
- * @param {number} frameMax TBD
- * @param {number} margin TBD
- * @param {number} spacing TBD
- * @returns {object} TBD
+ * @param {object} game - TBD.
+ * @param {object} key - TBD.
+ * @param {number} frameWidth - TBD.
+ * @param {number} frameHeight - TBD.
+ * @param {number} frameMax - TBD.
+ * @param {number} margin - TBD.
+ * @param {number} spacing - TBD.
+ * @returns {object} TBD.
  */
 export function spriteSheet(game, key, frameWidth, frameHeight, frameMax, margin, spacing) {
   let img = key;
@@ -41,7 +42,11 @@ export function spriteSheet(game, key, frameWidth, frameHeight, frameMax, margin
   }
   //  Zero or smaller than frame sizes?
   if (width === 0 || height === 0 || width < frameWidth || height < frameHeight || total === 0) {
-    console.warn("AnimationParser.spriteSheet: '" + key + "'s width/height zero or width/height < given frameWidth/frameHeight");
+    console.warn(
+      "AnimationParser.spriteSheet: '" +
+        key +
+        "'s width/height zero or width/height < given frameWidth/frameHeight"
+    );
     return null;
   }
   //  Let's create some frames then
@@ -60,10 +65,11 @@ export function spriteSheet(game, key, frameWidth, frameHeight, frameMax, margin
 }
 
 /**
+ * TBD.
  *
- * @param {object} game TBD
- * @param {object} json TBD
- * @returns {object} TBD
+ * @param {object} game - TBD.
+ * @param {object} json - TBD.
+ * @returns {object} TBD.
  */
 export function JSONDataHash(game, json) {
   if (!json.frames) {
@@ -79,9 +85,26 @@ export function JSONDataHash(game, json) {
   const keys = Object.keys(frames);
   for (let k = 0; k < keys.length; k += 1) {
     const key = keys[k];
-    newFrame = data.addFrame(new Frame(i, frames[key].frame.x, frames[key].frame.y, frames[key].frame.w, frames[key].frame.h, key));
+    newFrame = data.addFrame(
+      new Frame(
+        i,
+        frames[key].frame.x,
+        frames[key].frame.y,
+        frames[key].frame.w,
+        frames[key].frame.h,
+        key
+      )
+    );
     if (frames[key].trimmed) {
-      newFrame.setTrim(frames[key].trimmed, frames[key].sourceSize.w, frames[key].sourceSize.h, frames[key].spriteSourceSize.x, frames[key].spriteSourceSize.y, frames[key].spriteSourceSize.w, frames[key].spriteSourceSize.h);
+      newFrame.setTrim(
+        frames[key].trimmed,
+        frames[key].sourceSize.w,
+        frames[key].sourceSize.h,
+        frames[key].spriteSourceSize.x,
+        frames[key].spriteSourceSize.y,
+        frames[key].spriteSourceSize.w,
+        frames[key].spriteSourceSize.h
+      );
     }
     i += 1;
   }

package/src/phaser/core/array_set.js

@@ -1,10 +1,9 @@
 /**
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
-export default class {
-
+export class ArraySet {
   constructor(list = []) {
     this.position = 0;
     this.list = list;
@@ -33,7 +32,7 @@ export default class {
   }
 
   exists(item) {
-    return (this.list.indexOf(item) > -1);
+    return this.list.indexOf(item) > -1;
   }
 
   reset() {
@@ -103,5 +102,4 @@ export default class {
     }
     return null;
   }
-
 }

package/src/phaser/core/cache.js

@@ -1,13 +1,13 @@
 /**
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
-import Texture from '../display/webgl/texture';
-import BaseTexture from '../display/webgl/base_texture';
-import Signal from './signal';
-import Frame from './frame';
-import FrameData from './frame_data';
+import { Texture } from '../display/webgl/texture';
+import { BaseTexture } from '../display/webgl/base_texture';
+import { Signal } from  './signal';
+import { Frame } from './frame';
+import { FrameData } from './frame_data';
 import { JSONDataHash } from './animation_parser';
 import { jsonBitmapFont, xmlBitmapFont } from './loader_parser';
 
@@ -23,7 +23,6 @@ export const XML = 8;
 export const RENDER_TEXTURE = 9;
 
 export default class {
-
   constructor(game) {
     this.game = game;
     this.autoResolveURL = false;
@@ -60,7 +59,8 @@ export default class {
 
   addDefaultImage() {
     const img = new Image();
-    img.src = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgAQMAAABJtOi3AAAAA1BMVEX///+nxBvIAAAAAXRSTlMAQObYZgAAABVJREFUeF7NwIEAAAAAgKD9qdeocAMAoAABm3DkcAAAAABJRU5ErkJggg==';
+    img.src =
+      'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgAQMAAABJtOi3AAAAA1BMVEX///+nxBvIAAAAAXRSTlMAQObYZgAAABVJREFUeF7NwIEAAAAAgKD9qdeocAMAoAABm3DkcAAAAABJRU5ErkJggg==';
     const obj = this.addImage('__default', null, img);
     obj.base.skipRender = true; // invisible texture
     window.PhaserRegistry.CACHE_DEFAULT_IMAGE = new Texture(obj.base);
@@ -68,7 +68,8 @@ export default class {
 
   addMissingImage() {
     const img = new Image();
-    img.src = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAIAAAD8GO2jAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAJ9JREFUeNq01ssOwyAMRFG46v//Mt1ESmgh+DFmE2GPOBARKb2NVjo+17PXLD8a1+pl5+A+wSgFygymWYHBb0FtsKhJDdZlncG2IzJ4ayoMDv20wTmSMzClEgbWYNTAkQ0Z+OJ+A/eWnAaR9+oxCF4Os0H8htsMUp+pwcgBBiMNnAwF8GqIgL2hAzaGFFgZauDPKABmowZ4GL369/0rwACp2yA/ttmvsQAAAABJRU5ErkJggg==';
+    img.src =
+      'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAIAAAD8GO2jAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAJ9JREFUeNq01ssOwyAMRFG46v//Mt1ESmgh+DFmE2GPOBARKb2NVjo+17PXLD8a1+pl5+A+wSgFygymWYHBb0FtsKhJDdZlncG2IzJ4ayoMDv20wTmSMzClEgbWYNTAkQ0Z+OJ+A/eWnAaR9+oxCF4Os0H8htsMUp+pwcgBBiMNnAwF8GqIgL2hAzaGFFgZauDPKABmowZ4GL369/0rwACp2yA/ttmvsQAAAABJRU5ErkJggg==';
     const obj = this.addImage('__missing', null, img);
     window.PhaserRegistry.CACHE_MISSING_IMAGE = new Texture(obj.base);
   }
@@ -193,7 +194,7 @@ export default class {
   isSoundReady(key) {
     const sound = this.getItem(key, SOUND, 'isSoundDecoded');
     if (sound) {
-      return (sound.decoded && !this.game.sound.isLocked);
+      return sound.decoded && !this.game.sound.isLocked;
     }
     return false;
   }
@@ -337,7 +338,7 @@ export default class {
   }
 
   hasFrameData(key, cache = IMAGE) {
-    return (this.getItem(key, cache, '', 'frameData') !== null);
+    return this.getItem(key, cache, '', 'frameData') !== null;
   }
 
   updateFrameData(key, frameData, cache = IMAGE) {
@@ -476,5 +477,4 @@ export default class {
     this._urlResolver = null;
     this._urlTemp = null;
   }
-
 }

package/src/phaser/core/const.js

@@ -1,7 +1,7 @@
 /**
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
 // rectangle
 export const TOP_LEFT = 0;

package/src/phaser/core/device.js

@@ -1,11 +1,10 @@
 /**
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
 
-export default class {
-
+export class Device {
   constructor() {
     this.desktop = false;
     this.iOS = false;
@@ -36,5 +35,4 @@ export default class {
     this.cancelFullscreen = '';
     this.fullscreenKeyboard = false;
   }
-
 }

package/src/phaser/core/device_util.js

@@ -1,14 +1,16 @@
 /**
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
+import { Device } from "./device";
 
 /**
+ * TBD.
  *
- * @param {object} device TBD
- * @param {string} type TBD
- * @returns {boolean} TBD
+ * @param {Device} device - TBD.
+ * @param {string} type - TBD.
+ * @returns {boolean} TBD.
  */
 export function canPlayAudio(device, type) {
   if (type === 'mp3' && device.mp3) {
@@ -30,8 +32,9 @@ export function canPlayAudio(device, type) {
 }
 
 /**
+ * TBD.
  *
- * @param {object} device TBD
+ * @param {Device} device - TBD.
  */
 export function checkOS(device) {
   const ua = navigator.userAgent;
@@ -62,17 +65,26 @@ export function checkOS(device) {
     device.desktop = true;
   }
   // iOS / Windows Phone / Tablet reset
-  if (device.android || device.iOS || device.windowsPhone || ((/Windows NT/i.test(ua)) && (/Touch/i.test(ua)))) {
+  if (
+    device.android ||
+    device.iOS ||
+    device.windowsPhone ||
+    (/Windows NT/i.test(ua) && /Touch/i.test(ua))
+  ) {
     device.desktop = false;
   }
 }
 
 /**
+ * TBD.
  *
- * @param {object} device TBD
+ * @param {Device} device - TBD.
  */
 export function checkInput(device) {
-  if ('ontouchstart' in document.documentElement || (window.navigator.maxTouchPoints && window.navigator.maxTouchPoints >= 1)) {
+  if (
+    'ontouchstart' in document.documentElement ||
+    (window.navigator.maxTouchPoints && window.navigator.maxTouchPoints >= 1)
+  ) {
     device.touch = true;
   }
   // if (window.navigator.msPointerEnabled || window.navigator.pointerEnabled) {
@@ -85,8 +97,9 @@ export function checkInput(device) {
 }
 
 /**
+ * TBD.
  *
- * @param {object} device TBD
+ * @param {Device} device - TBD.
  */
 export function checkFullScreenSupport(device) {
   const fs = [
@@ -131,8 +144,9 @@ export function checkFullScreenSupport(device) {
 }
 
 /**
+ * TBD.
  *
- * @param {object} device TBD
+ * @param {Device} device - TBD.
  */
 export function checkBrowser(device) {
   const ua = navigator.userAgent;
@@ -152,8 +166,9 @@ export function checkBrowser(device) {
 }
 
 /**
+ * TBD.
  *
- * @param {object} device TBD
+ * @param {Device} device - TBD.
  */
 export function checkAudio(device) {
   const audioElement = document.createElement('audio');
@@ -162,7 +177,10 @@ export function checkAudio(device) {
       if (audioElement.canPlayType('audio/ogg; codecs="vorbis"').replace(/^no$/, '')) {
         device.ogg = true;
       }
-      if (audioElement.canPlayType('audio/ogg; codecs="opus"').replace(/^no$/, '') || audioElement.canPlayType('audio/opus;').replace(/^no$/, '')) {
+      if (
+        audioElement.canPlayType('audio/ogg; codecs="opus"').replace(/^no$/, '') ||
+        audioElement.canPlayType('audio/opus;').replace(/^no$/, '')
+      ) {
         device.opus = true;
       }
       if (audioElement.canPlayType('audio/mpeg;').replace(/^no$/, '')) {
@@ -174,7 +192,10 @@ export function checkAudio(device) {
       if (audioElement.canPlayType('audio/wav; codecs="1"').replace(/^no$/, '')) {
         device.wav = true;
       }
-      if (audioElement.canPlayType('audio/x-m4a;') || audioElement.canPlayType('audio/aac;').replace(/^no$/, '')) {
+      if (
+        audioElement.canPlayType('audio/x-m4a;') ||
+        audioElement.canPlayType('audio/aac;').replace(/^no$/, '')
+      ) {
         device.m4a = true;
       }
       if (audioElement.canPlayType('audio/webm; codecs="vorbis"').replace(/^no$/, '')) {
@@ -192,20 +213,22 @@ export function checkAudio(device) {
 }
 
 /**
+ * TBD.
  *
- * @param {object} device TBD
+ * @param {Device} device - TBD.
  */
 export function checkImage(device) {
   device.avif = false;
   device.webp = false;
   try {
     const avif = new Image();
-    avif.src = "data:image/avif;base64,AAAAIGZ0eXBhdmlmAAAAAGF2aWZtaWYxbWlhZk1BMUIAAADybWV0YQAAAAAAAAAoaGRscgAAAAAAAAAAcGljdAAAAAAAAAAAAAAAAGxpYmF2aWYAAAAADnBpdG0AAAAAAAEAAAAeaWxvYwAAAABEAAABAAEAAAABAAABGgAAAB0AAAAoaWluZgAAAAAAAQAAABppbmZlAgAAAAABAABhdjAxQ29sb3IAAAAAamlwcnAAAABLaXBjbwAAABRpc3BlAAAAAAAAAAIAAAACAAAAEHBpeGkAAAAAAwgICAAAAAxhdjFDgQ0MAAAAABNjb2xybmNseAACAAIAAYAAAAAXaXBtYQAAAAAAAAABAAEEAQKDBAAAACVtZGF0EgAKCBgANogQEAwgMg8f8D///8WfhwB8+ErK42A=";
+    avif.src =
+      'data:image/avif;base64,AAAAIGZ0eXBhdmlmAAAAAGF2aWZtaWYxbWlhZk1BMUIAAADybWV0YQAAAAAAAAAoaGRscgAAAAAAAAAAcGljdAAAAAAAAAAAAAAAAGxpYmF2aWYAAAAADnBpdG0AAAAAAAEAAAAeaWxvYwAAAABEAAABAAEAAAABAAABGgAAAB0AAAAoaWluZgAAAAAAAQAAABppbmZlAgAAAAABAABhdjAxQ29sb3IAAAAAamlwcnAAAABLaXBjbwAAABRpc3BlAAAAAAAAAAIAAAACAAAAEHBpeGkAAAAAAwgICAAAAAxhdjFDgQ0MAAAAABNjb2xybmNseAACAAIAAYAAAAAXaXBtYQAAAAAAAAABAAEEAQKDBAAAACVtZGF0EgAKCBgANogQEAwgMg8f8D///8WfhwB8+ErK42A=';
     avif.onload = function () {
       device.avif = true;
     };
     const webp = new Image();
-    webp.src = "data:image/webp;base64,UklGRh4AAABXRUJQVlA4TBEAAAAvAAAAAAfQ//73v/+BiOh/AAA=";
+    webp.src = 'data:image/webp;base64,UklGRh4AAABXRUJQVlA4TBEAAAAvAAAAAAfQ//73v/+BiOh/AAA=';
     webp.onload = function () {
       device.webp = true;
     };
@@ -215,8 +238,9 @@ export function checkImage(device) {
 }
 
 /**
+ * TBD.
  *
- * @param {object} device TBD
+ * @param {Device} device - TBD.
  */
 export function initialize(device) {
   checkOS(device);
@@ -226,3 +250,12 @@ export function initialize(device) {
   checkFullScreenSupport(device);
   checkInput(device);
 }
+
+/**
+ * TBD.
+ *
+ * @returns {Device} TBD.
+ */
+export function createDevice() {
+  return new Device();
+}