@zylem/game-lib 0.3.17 → 0.4.1

package/dist/lib/entities/text.js

@@ -1,9 +1,9 @@
-import { Vector2 as u, Group as H, CanvasTexture as w, LinearFilter as l, SpriteMaterial as k, Sprite as M, ClampToEdgeWrapping as C, Color as v } from "three";
-import { GameEntity as R } from "./entity.js";
-import { EntityBuilder as W } from "./builder.js";
-import { createEntity as E } from "./create.js";
-import { DebugDelegate as D } from "./delegates/debug.js";
-const x = {
+import { Vector2 as m, Group as v, CanvasTexture as d, LinearFilter as l, SpriteMaterial as y, Sprite as T, ClampToEdgeWrapping as _, Color as f } from "three";
+import { GameEntity as S } from "./entity.js";
+import { EntityBuilder as F } from "./builder.js";
+import { createEntity as R } from "./create.js";
+import { DebugDelegate as H } from "./delegates/debug.js";
+const u = {
   position: void 0,
   text: "",
   fontFamily: 'Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace',
@@ -12,17 +12,17 @@ const x = {
   backgroundColor: null,
   padding: 4,
   stickToViewport: !0,
-  screenPosition: new u(24, 24),
+  screenPosition: new m(24, 24),
   zDistance: 1
 };
-class P extends W {
+class k extends F {
   createEntity(t) {
-    return new o(t);
+    return new c(t);
   }
 }
-const z = Symbol("Text");
-class o extends R {
-  static type = z;
+const b = Symbol("Text");
+class c extends S {
+  static type = b;
   _sprite = null;
   _texture = null;
   _canvas = null;
@@ -31,81 +31,110 @@ class o extends R {
   _lastCanvasW = 0;
   _lastCanvasH = 0;
   constructor(t) {
-    super(), this.options = { ...x, ...t }, this.group = new H(), this.createSprite(), this.lifeCycleDelegate = {
+    super(), this.options = { ...u, ...t }, this.group = new v(), this.createSprite(), this.lifeCycleDelegate = {
       setup: [this.textSetup.bind(this)],
       update: [this.textUpdate.bind(this)]
     };
   }
   createSprite() {
-    this._canvas = document.createElement("canvas"), this._ctx = this._canvas.getContext("2d"), this._texture = new w(this._canvas), this._texture.minFilter = l, this._texture.magFilter = l;
-    const t = new k({
+    this._canvas = document.createElement("canvas"), this._ctx = this._canvas.getContext("2d"), this._texture = new d(this._canvas), this._texture.minFilter = l, this._texture.magFilter = l;
+    const t = new y({
       map: this._texture,
       transparent: !0,
       depthTest: !1,
       depthWrite: !1,
       alphaTest: 0.5
     });
-    this._sprite = new M(t), this.group?.add(this._sprite), this.redrawText(this.options.text ?? "");
+    this._sprite = new T(t), this.group?.add(this._sprite), this.redrawText(this.options.text ?? "");
+  }
+  measureAndResizeCanvas(t, e, s, a) {
+    if (!this._canvas || !this._ctx)
+      return { sizeChanged: !1 };
+    this._ctx.font = `${e}px ${s}`;
+    const i = this._ctx.measureText(t), n = Math.ceil(i.width), r = Math.ceil(e * 1.4), o = Math.max(2, n + a * 2), h = Math.max(2, r + a * 2), p = o !== this._lastCanvasW || h !== this._lastCanvasH;
+    return this._canvas.width = o, this._canvas.height = h, this._lastCanvasW = o, this._lastCanvasH = h, { sizeChanged: p };
+  }
+  drawCenteredText(t, e, s) {
+    !this._canvas || !this._ctx || (this._ctx.font = `${e}px ${s}`, this._ctx.textAlign = "center", this._ctx.textBaseline = "middle", this._ctx.clearRect(0, 0, this._canvas.width, this._canvas.height), this.options.backgroundColor && (this._ctx.fillStyle = this.toCssColor(this.options.backgroundColor), this._ctx.fillRect(0, 0, this._canvas.width, this._canvas.height)), this._ctx.fillStyle = this.toCssColor(this.options.fontColor ?? "#FFFFFF"), this._ctx.fillText(t, this._canvas.width / 2, this._canvas.height / 2));
+  }
+  updateTexture(t) {
+    !this._texture || !this._canvas || (t && (this._texture.dispose(), this._texture = new d(this._canvas), this._texture.minFilter = l, this._texture.magFilter = l, this._texture.wrapS = _, this._texture.wrapT = _), this._texture.image = this._canvas, this._texture.needsUpdate = !0, this._sprite && this._sprite.material && (this._sprite.material.map = this._texture, this._sprite.material.needsUpdate = !0));
   }
   redrawText(t) {
     if (!this._canvas || !this._ctx)
       return;
-    const e = this.options.fontSize ?? 18, r = this.options.fontFamily ?? x.fontFamily, a = this.options.padding ?? 4;
-    this._ctx.font = `${e}px ${r}`;
-    const p = this._ctx.measureText(t), _ = Math.ceil(p.width), h = Math.ceil(e * 1.4), n = Math.max(2, _ + a * 2), s = Math.max(2, h + a * 2), f = n !== this._lastCanvasW || s !== this._lastCanvasH;
-    this._canvas.width = n, this._canvas.height = s, this._lastCanvasW = n, this._lastCanvasH = s, this._ctx.font = `${e}px ${r}`, this._ctx.textBaseline = "top", this._ctx.clearRect(0, 0, this._canvas.width, this._canvas.height), this.options.backgroundColor && (this._ctx.fillStyle = this.toCssColor(this.options.backgroundColor), this._ctx.fillRect(0, 0, this._canvas.width, this._canvas.height)), this._ctx.fillStyle = this.toCssColor(this.options.fontColor ?? "#FFFFFF"), this._ctx.fillText(t, a, a), this._texture && (f && (this._texture.dispose(), this._texture = new w(this._canvas), this._texture.minFilter = l, this._texture.magFilter = l, this._texture.wrapS = C, this._texture.wrapT = C), this._texture.image = this._canvas, this._texture.needsUpdate = !0, this._sprite && this._sprite.material && (this._sprite.material.map = this._texture, this._sprite.material.needsUpdate = !0));
+    const e = this.options.fontSize ?? 18, s = this.options.fontFamily ?? u.fontFamily, a = this.options.padding ?? 4, { sizeChanged: i } = this.measureAndResizeCanvas(t, e, s, a);
+    this.drawCenteredText(t, e, s), this.updateTexture(!!i), this.options.stickToViewport && this._cameraRef && this.updateStickyTransform();
   }
   toCssColor(t) {
-    return typeof t == "string" ? t : `#${(t instanceof v ? t : new v(t)).getHexString()}`;
+    return typeof t == "string" ? t : `#${(t instanceof f ? t : new f(t)).getHexString()}`;
   }
   textSetup(t) {
-    this._cameraRef = t.camera, this.options.stickToViewport && this._cameraRef && this._cameraRef.camera.add(this.group);
+    this._cameraRef = t.camera, this.options.stickToViewport && this._cameraRef && (this._cameraRef.camera.add(this.group), this.updateStickyTransform());
   }
   textUpdate(t) {
     this._sprite && this.options.stickToViewport && this._cameraRef && this.updateStickyTransform();
   }
-  updateStickyTransform() {
-    if (!this._sprite || !this._cameraRef)
-      return;
-    const t = this._cameraRef.camera, e = this._cameraRef.renderer.domElement, r = e.clientWidth, a = e.clientHeight, p = (this.options.screenPosition ?? new u(24, 24)).x, _ = (this.options.screenPosition ?? new u(24, 24)).y, h = Math.max(1e-3, this.options.zDistance ?? 1);
-    let n = 1, s = 1;
+  getResolution() {
+    return {
+      width: this._cameraRef?.screenResolution.x ?? 1,
+      height: this._cameraRef?.screenResolution.y ?? 1
+    };
+  }
+  getScreenPixels(t, e, s) {
+    const a = t.x >= 0 && t.x <= 1, i = t.y >= 0 && t.y <= 1;
+    return {
+      px: a ? t.x * e : t.x,
+      py: i ? t.y * s : t.y
+    };
+  }
+  computeWorldExtents(t, e) {
+    let s = 1, a = 1;
     if (t.isPerspectiveCamera) {
-      const i = t, c = Math.tan(i.fov * Math.PI / 180 / 2) * h;
-      n = c * i.aspect, s = c;
+      const i = t, n = Math.tan(i.fov * Math.PI / 180 / 2) * e;
+      s = n * i.aspect, a = n;
     } else if (t.isOrthographicCamera) {
       const i = t;
-      n = (i.right - i.left) / 2, s = (i.top - i.bottom) / 2;
-    }
-    const f = p / r * 2 - 1, y = 1 - _ / a * 2, T = f * n, F = y * s;
-    if (this.group?.position.set(T, F, -h), this._canvas) {
-      const c = s * 2 / a, m = this._canvas.height, g = Math.max(1e-4, m * c), S = this._canvas.width / this._canvas.height, b = g * S;
-      this._sprite.scale.set(b, g, 1);
+      s = (i.right - i.left) / 2, a = (i.top - i.bottom) / 2;
     }
+    return { worldHalfW: s, worldHalfH: a };
+  }
+  updateSpriteScale(t, e) {
+    if (!this._canvas || !this._sprite)
+      return;
+    const a = t * 2 / e, i = this._canvas.height, n = Math.max(1e-4, i * a), r = this._canvas.width / this._canvas.height, o = n * r;
+    this._sprite.scale.set(o, n, 1);
+  }
+  updateStickyTransform() {
+    if (!this._sprite || !this._cameraRef)
+      return;
+    const t = this._cameraRef.camera, { width: e, height: s } = this.getResolution(), a = this.options.screenPosition ?? new m(24, 24), { px: i, py: n } = this.getScreenPixels(a, e, s), r = Math.max(1e-3, this.options.zDistance ?? 1), { worldHalfW: o, worldHalfH: h } = this.computeWorldExtents(t, r), p = i / e * 2 - 1, g = 1 - n / s * 2, w = p * o, C = g * h;
+    this.group?.position.set(w, C, -r), this.updateSpriteScale(h, s);
   }
   updateText(t) {
     this.options.text = t, this.redrawText(t), this.options.stickToViewport && this._cameraRef && this.updateStickyTransform();
   }
   buildInfo() {
     return {
-      ...new D(this).buildDebugInfo(),
-      type: String(o.type),
+      ...new H(this).buildDebugInfo(),
+      type: String(c.type),
       text: this.options.text ?? "",
       sticky: this.options.stickToViewport
     };
   }
 }
-async function X(...d) {
-  return E({
-    args: d,
-    defaultConfig: { ...x },
-    EntityClass: o,
-    BuilderClass: P,
-    entityType: o.type
+async function D(...x) {
+  return R({
+    args: x,
+    defaultConfig: { ...u },
+    EntityClass: c,
+    BuilderClass: k,
+    entityType: c.type
   });
 }
 export {
-  z as TEXT_TYPE,
-  P as TextBuilder,
-  o as ZylemText,
-  X as text
+  b as TEXT_TYPE,
+  k as TextBuilder,
+  c as ZylemText,
+  D as text
 };

package/dist/lib/entities/zone.d.ts

@@ -51,3 +51,4 @@ export declare class ZylemZone extends GameEntity<ZylemZoneOptions> implements C
 type ZoneOptions = BaseNode | Partial<ZylemZoneOptions>;
 export declare function zone(...args: Array<ZoneOptions>): Promise<ZylemZone>;
 export {};
+//# sourceMappingURL=zone.d.ts.map

package/dist/lib/entities/zone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/zone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAG3E,MAAM,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,GAAG,CAAC;CACb,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;AAC/E,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;AAE9E,KAAK,gBAAgB,GAAG,iBAAiB,GAAG;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;CACxC,CAAC;AAaF,qBAAa,oBAAqB,SAAQ,sBAAsB;IAC/D,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY;CAQjD;AAED,qBAAa,WAAY,SAAQ,aAAa,CAAC,SAAS,EAAE,gBAAgB,CAAC;IAC1E,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS;CAGrE;AAED,eAAO,MAAM,SAAS,eAAiB,CAAC;AAExC,qBAAa,SAAU,SAAQ,UAAU,CAAC,gBAAgB,CAAE,YAAW,wBAAwB;IAC9F,MAAM,CAAC,IAAI,SAAa;IAExB,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,aAAa,CAA+B;gBAExC,OAAO,CAAC,EAAE,gBAAgB;IAK/B,mBAAmB,CAAC,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAO1D,uBAAuB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAU9E,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI;IAKjD,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI;IAK/C,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI;IAK/C,OAAO,CAAC,KAAK,EAAE,GAAG;IAWlB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAkBjC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;CAc9B;AAED,KAAK,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAExD,wBAAsB,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAS1E"}

package/dist/lib/game/game-blueprint.d.ts

@@ -1,12 +1,11 @@
 import type { Stage } from '../stage/stage';
-import type { BasicTypes, GlobalVariablesType, ZylemGameConfig } from './game-interfaces';
-import type { GameOptions } from '../core/utility/nodes';
+import type { BaseGlobals, ZylemGameConfig } from './game-interfaces';
 /**
  * A lightweight, serializable blueprint representing the initial configuration
  * of a `Game`. It should not include runtime references. Use blueprints only to
  * build games.
  */
-export interface GameBlueprint<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType> {
+export interface GameBlueprint<TGlobals extends BaseGlobals = BaseGlobals> {
     id: string;
     name?: string;
     config: Partial<ZylemGameConfig<Stage, any, TGlobals>>;
@@ -19,13 +18,13 @@ export declare const gameBlueprintsState: {
 /** Reset the blueprints store back to its initial empty state. */
 export declare function resetGameBlueprints(): void;
 /** Create and register a new `GameBlueprint`. */
-export declare function createGameBlueprint<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType>(config: Partial<ZylemGameConfig<Stage, any, TGlobals>>, options?: {
+export declare function createGameBlueprint<TGlobals extends BaseGlobals>(config: Partial<ZylemGameConfig<Stage, any, TGlobals>>, options?: {
     id?: string;
     name?: string;
     setCurrent?: boolean;
 }): GameBlueprint<TGlobals>;
 /** Upsert a blueprint into the store. */
-export declare function upsertGameBlueprint<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType>(blueprint: GameBlueprint<TGlobals>): void;
+export declare function upsertGameBlueprint<TGlobals extends BaseGlobals>(blueprint: GameBlueprint<TGlobals>): void;
 /** Remove a blueprint by id. */
 export declare function removeGameBlueprint(id: string): void;
 /** Get a blueprint by id. */
@@ -36,9 +35,4 @@ export declare function listGameBlueprints(): GameBlueprint[];
 export declare function setCurrentGameBlueprint(id: string | null): void;
 /** Get the current blueprint object, if any. */
 export declare function getCurrentGameBlueprint(): GameBlueprint | null;
-/**
- * Build a `Game` instance from a blueprint and optional extra `GameOptions`
- * (e.g., additional stages or nodes). This returns a `Game` wrapper instance;
- * call `.start()` to run it.
- */
-export declare function buildGameFromBlueprint<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType>(input: string | GameBlueprint<TGlobals>, ...extras: GameOptions<TGlobals>): import("./game").Game<TGlobals>;
+//# sourceMappingURL=game-blueprint.d.ts.map

package/dist/lib/game/game-blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-blueprint.d.ts","sourceRoot":"","sources":["../../../src/lib/game/game-blueprint.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEtE;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;CACvD;AAYD,eAAO,MAAM,mBAAmB;UALnB,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;WAC5B,MAAM,EAAE;eACF,MAAM,GAAG,IAAI;CAG8C,CAAC;AAEhF,kEAAkE;AAClE,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,WAAW,EAC/D,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,EACtD,OAAO,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAAE,GAC7D,aAAa,CAAC,QAAQ,CAAC,CAWzB;AAED,yCAAyC;AACzC,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,WAAW,EAC/D,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,GAChC,IAAI,CAKN;AAED,gCAAgC;AAChC,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAMpD;AAED,6BAA6B;AAC7B,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEtE;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,IAAI,aAAa,EAAE,CAIpD;AAED,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE/D;AAED,gDAAgD;AAChD,wBAAgB,uBAAuB,IAAI,aAAa,GAAG,IAAI,CAG9D"}

package/dist/lib/game/game-canvas.d.ts

@@ -32,3 +32,4 @@ export declare class GameCanvas {
     destroy(): void;
     private ensureContainer;
 }
+//# sourceMappingURL=game-canvas.d.ts.map

package/dist/lib/game/game-canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-canvas.d.ts","sourceRoot":"","sources":["../../../src/lib/game/game-canvas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,gBAAgB,GAAG,MAAM,CAAC;CACvC;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAG,WAAW,CAAC;IACxB,MAAM,EAAG,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,aAAa,CAAoC;gBAE7C,OAAO,EAAE,iBAAiB;IAStC,mBAAmB;IAMnB,WAAW;IAOX,aAAa,CAAC,WAAW,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI;IAS/F,kBAAkB;IAUlB,iBAAiB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI;IAiBnE,OAAO;IAKP,OAAO,CAAC,eAAe;CAevB"}

package/dist/lib/game/game-canvas.js

@@ -18,10 +18,10 @@ class o {
       this.container.removeChild(this.container.firstChild);
     this.container.appendChild(this.canvas);
   }
-  mountRenderer(t, i) {
+  mountRenderer(t, a) {
     for (; this.container.firstChild; )
       this.container.removeChild(this.container.firstChild);
-    this.container.appendChild(t), this.canvas = t, this.attachAspectRatio(i);
+    this.container.appendChild(t), this.canvas = t, this.attachAspectRatio(a);
   }
   centerIfFullscreen() {
     if (!this.fullscreen)
@@ -30,7 +30,7 @@ class o {
     t.display = "flex", t.alignItems = "center", t.justifyContent = "center", t.position = "fixed", t.inset = "0";
   }
   attachAspectRatio(t) {
-    this.ratioDelegate ? this.ratioDelegate.apply() : (this.ratioDelegate = new s({
+    this.ratioDelegate ? (this.ratioDelegate.canvas = this.canvas, this.ratioDelegate.onResize = t, this.ratioDelegate.aspectRatio = this.aspectRatio, this.ratioDelegate.apply()) : (this.ratioDelegate = new s({
       container: this.container,
       canvas: this.canvas,
       aspectRatio: this.aspectRatio,
@@ -40,13 +40,13 @@ class o {
   destroy() {
     this.ratioDelegate?.detach(), this.ratioDelegate = null;
   }
-  ensureContainer(t, i) {
-    if (i)
-      return i;
+  ensureContainer(t, a) {
+    if (a)
+      return a;
     if (t) {
-      const a = document.getElementById(t);
-      if (a)
-        return a;
+      const i = document.getElementById(t);
+      if (i)
+        return i;
     }
     const n = t || this.id || "zylem-root", e = document.createElement("main");
     return e.setAttribute("id", n), e.style.position = "relative", e.style.width = "100%", e.style.height = "100%", document.body.appendChild(e), e;

package/dist/lib/game/game-config.d.ts

@@ -1,6 +1,7 @@
 import { StageInterface } from "../types";
 import { GameInputConfig } from "./game-interfaces";
 import { AspectRatio, AspectRatioValue } from "../device/aspect-ratio";
+import { RetroPresetKey } from "./game-retro-resolutions";
 export type GameConfigLike = Partial<{
     id: string;
     globals: Record<string, any>;
@@ -10,6 +11,13 @@ export type GameConfigLike = Partial<{
     input: GameInputConfig;
     /** numeric value or key in AspectRatio */
     aspectRatio: AspectRatioValue | keyof typeof AspectRatio;
+    /** console/display preset to derive aspect ratio */
+    preset: RetroPresetKey;
+    /** lock internal render buffer to this resolution (e.g., '256x240' or { width, height }) */
+    resolution: string | {
+        width: number;
+        height: number;
+    };
     fullscreen: boolean;
     /** CSS background value for document body */
     bodyBackground: string;
@@ -28,20 +36,24 @@ export declare class GameConfig {
     time: number;
     input: GameInputConfig | undefined;
     aspectRatio: number;
+    internalResolution: {
+        width: number;
+        height: number;
+    } | undefined;
     fullscreen: boolean;
     bodyBackground: string | undefined;
     container: HTMLElement;
     containerId?: string | undefined;
     canvas?: HTMLCanvasElement | undefined;
-    constructor(id: string, globals: Record<string, any>, stages: StageInterface[], debug: boolean, time: number, input: GameInputConfig | undefined, aspectRatio: number, fullscreen: boolean, bodyBackground: string | undefined, container: HTMLElement, containerId?: string | undefined, canvas?: HTMLCanvasElement | undefined);
+    constructor(id: string, globals: Record<string, any>, stages: StageInterface[], debug: boolean, time: number, input: GameInputConfig | undefined, aspectRatio: number, internalResolution: {
+        width: number;
+        height: number;
+    } | undefined, fullscreen: boolean, bodyBackground: string | undefined, container: HTMLElement, containerId?: string | undefined, canvas?: HTMLCanvasElement | undefined);
 }
-export declare function createDefaultGameConfig(base?: Partial<Pick<GameConfig, 'id' | 'debug' | 'time' | 'input'>> & {
-    stages?: StageInterface[];
-    globals?: Record<string, any>;
-}): GameConfig;
 export declare function resolveGameConfig(user?: GameConfigLike): GameConfig;
 /**
  * Factory for authoring configuration objects in user code.
  * Returns a plain object that can be passed to `game(...)`.
  */
 export declare function gameConfig(config: GameConfigLike): GameConfigLike;
+//# sourceMappingURL=game-config.d.ts.map

package/dist/lib/game/game-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-config.d.ts","sourceRoot":"","sources":["../../../src/lib/game/game-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAA0D,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAElH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,eAAe,CAAC;IACvB,0CAA0C;IAC1C,WAAW,EAAE,gBAAgB,GAAG,MAAM,OAAO,WAAW,CAAC;IACzD,oDAAoD;IACpD,MAAM,EAAE,cAAc,CAAC;IACvB,4FAA4F;IAC5F,UAAU,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,UAAU,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,SAAS,EAAE,WAAW,CAAC;IACvB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,MAAM,EAAE,iBAAiB,CAAC;CAC1B,CAAC,CAAC;AAEH,qBAAa,UAAU;IAEd,EAAE,EAAE,MAAM;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC5B,MAAM,EAAE,cAAc,EAAE;IACxB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,eAAe,GAAG,SAAS;IAClC,WAAW,EAAE,MAAM;IACnB,kBAAkB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IACjE,UAAU,EAAE,OAAO;IACnB,cAAc,EAAE,MAAM,GAAG,SAAS;IAClC,SAAS,EAAE,WAAW;IACtB,WAAW,CAAC,EAAE,MAAM;IACpB,MAAM,CAAC,EAAE,iBAAiB;gBAZ1B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,MAAM,EAAE,cAAc,EAAE,EACxB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,eAAe,GAAG,SAAS,EAClC,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,EACjE,UAAU,EAAE,OAAO,EACnB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,SAAS,EAAE,WAAW,EACtB,WAAW,CAAC,EAAE,MAAM,YAAA,EACpB,MAAM,CAAC,EAAE,iBAAiB,YAAA;CAElC;AAsCD,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,UAAU,CAoEnE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAEjE"}

package/dist/lib/game/game-config.js

@@ -1,5 +1,6 @@
-import { AspectRatio as d } from "../device/aspect-ratio.js";
-class g {
+import { AspectRatio as p } from "../device/aspect-ratio.js";
+import { getDisplayAspect as b, parseResolution as y, getPresetResolution as R } from "./game-retro-resolutions.js";
+class f {
   id;
   globals;
   stages;
@@ -7,47 +8,71 @@ class g {
   time;
   input;
   aspectRatio;
+  internalResolution;
   fullscreen;
   bodyBackground;
   container;
   containerId;
   canvas;
-  constructor(n, o, e, i, a, c, s, l, u, m, f, p) {
-    this.id = n, this.globals = o, this.stages = e, this.debug = i, this.time = a, this.input = c, this.aspectRatio = s, this.fullscreen = l, this.bodyBackground = u, this.container = m, this.containerId = f, this.canvas = p;
+  constructor(i, o, n, e, l, d, r, a, g, c, s, h, m) {
+    this.id = i, this.globals = o, this.stages = n, this.debug = e, this.time = l, this.input = d, this.aspectRatio = r, this.internalResolution = a, this.fullscreen = g, this.bodyBackground = c, this.container = s, this.containerId = h, this.canvas = m;
   }
 }
-function r(t, n) {
-  if (n)
-    return n;
+function u(t, i) {
+  if (i)
+    return i;
   if (t) {
-    const i = document.getElementById(t);
-    if (i)
-      return i;
+    const e = document.getElementById(t);
+    if (e)
+      return e;
   }
-  const o = t || "zylem-root", e = document.createElement("main");
-  return e.setAttribute("id", o), e.style.position = "relative", e.style.width = "100%", e.style.height = "100%", document.body.appendChild(e), e;
+  const o = t || "zylem-root", n = document.createElement("main");
+  return n.setAttribute("id", o), n.style.position = "relative", n.style.width = "100%", n.style.height = "100%", document.body.appendChild(n), n;
 }
-function b(t) {
-  const n = t?.id ?? "zylem", o = r(n);
-  return new g(n, t?.globals ?? {}, t?.stages ?? [], !!t?.debug, t?.time ?? 0, t?.input, d.SixteenByNine, !0, "#000000", o, n, void 0);
+function B(t) {
+  const i = t?.id ?? "zylem", o = u(i);
+  return new f(i, t?.globals ?? {}, t?.stages ?? [], !!t?.debug, t?.time ?? 0, t?.input, p.SixteenByNine, void 0, !0, "#000000", o, i, void 0);
 }
-function y(t) {
-  const n = b({
+function C(t) {
+  const i = B({
     id: t?.id ?? "zylem",
     debug: !!t?.debug,
     time: t?.time ?? 0,
     input: t?.input,
     stages: t?.stages ?? [],
     globals: t?.globals ?? {}
-  }), o = t?.containerId ?? n.containerId, e = r(o, t?.container ?? null), i = t?.aspectRatio ?? n.aspectRatio, a = typeof i == "number" ? i : d[i] ?? d.SixteenByNine, c = t?.fullscreen ?? n.fullscreen, s = t?.bodyBackground ?? n.bodyBackground, l = t?.canvas ?? void 0;
-  return new g(t?.id ?? n.id, t?.globals ?? n.globals, t?.stages ?? n.stages, !!(t?.debug ?? n.debug), t?.time ?? n.time, t?.input ?? n.input, a, c, s, e, o, l);
+  }), o = t?.containerId ?? i.containerId, n = u(o, t?.container ?? null), e = t?.aspectRatio;
+  let l = i.aspectRatio;
+  if (typeof e == "number" || e && typeof e == "string")
+    l = typeof e == "number" ? e : p[e] ?? i.aspectRatio;
+  else if (t?.preset)
+    try {
+      l = b(t.preset) || i.aspectRatio;
+    } catch {
+      l = i.aspectRatio;
+    }
+  const d = t?.fullscreen ?? i.fullscreen, r = t?.bodyBackground ?? i.bodyBackground;
+  let a;
+  if (t?.resolution) {
+    if (typeof t.resolution == "string") {
+      const c = y(t.resolution);
+      if (c && (a = c), !a && t.preset) {
+        const s = R(t.preset, t.resolution);
+        s && (a = { width: s.width, height: s.height });
+      }
+    } else if (typeof t.resolution == "object") {
+      const c = t.resolution.width, s = t.resolution.height;
+      Number.isFinite(c) && Number.isFinite(s) && (a = { width: c, height: s });
+    }
+  }
+  const g = t?.canvas ?? void 0;
+  return new f(t?.id ?? i.id, t?.globals ?? i.globals, t?.stages ?? i.stages, !!(t?.debug ?? i.debug), t?.time ?? i.time, t?.input ?? i.input, l, a, d, r, n, o, g);
 }
-function B(t) {
+function k(t) {
   return { ...t };
 }
 export {
-  g as GameConfig,
-  b as createDefaultGameConfig,
-  B as gameConfig,
-  y as resolveGameConfig
+  f as GameConfig,
+  k as gameConfig,
+  C as resolveGameConfig
 };

package/dist/lib/game/game-default.d.ts

@@ -1,14 +1,9 @@
 import { Stage } from '../stage/stage';
-import type { BasicTypes, GlobalVariablesType, ZylemGameConfig, GameInputConfig } from './game-interfaces';
-export declare const gameDefaultsState: Partial<ZylemGameConfig<Stage, any, GlobalVariablesType>>;
-/** Replace multiple defaults at once (shallow merge). */
-export declare function setGameDefaults(partial: Partial<ZylemGameConfig<Stage, any, GlobalVariablesType>>): void;
-/** Reset defaults back to library defaults. */
-export declare function resetGameDefaults(): void;
+import type { BasicTypes, BaseGlobals, GameInputConfig } from './game-interfaces';
 /**
  * Get a plain object copy of the current defaults.
  */
-export declare function getGameDefaultConfig<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType>(): {
+export declare function getGameDefaultConfig<TGlobals extends Record<string, BasicTypes> = BaseGlobals>(): {
     id: string;
     globals: TGlobals;
     stages: Stage[];
@@ -16,3 +11,4 @@ export declare function getGameDefaultConfig<TGlobals extends Record<string, Bas
     time?: number;
     input?: GameInputConfig;
 };
+//# sourceMappingURL=game-default.d.ts.map

package/dist/lib/game/game-default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-default.d.ts","sourceRoot":"","sources":["../../../src/lib/game/game-default.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAmB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAiCnG;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,WAAW,KAAK;IAClG,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,QAAQ,CAAC;IAClB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,eAAe,CAAC;CACxB,CASA"}

package/dist/lib/game/game-default.js

@@ -19,6 +19,5 @@ function g() {
   };
 }
 export {
-  t as gameDefaultsState,
   g as getGameDefaultConfig
 };

package/dist/lib/game/game-interfaces.d.ts

@@ -1,6 +1,6 @@
 import { UpdateFunction } from "../core/base-node-life-cycle";
 export type BasicTypes = number | string | boolean;
-export type GlobalVariablesType = Record<string, BasicTypes>;
+export type BaseGlobals = Record<string, BasicTypes>;
 export type KeyboardMapping = Record<string, string[]>;
 export type MouseMapping = Record<string, string[]>;
 export interface GameInputPlayerConfig {
@@ -17,7 +17,7 @@ export interface GameInputConfig {
     p7?: GameInputPlayerConfig;
     p8?: GameInputPlayerConfig;
 }
-export interface ZylemGameConfig<StageInterface, GameInterface, TGlobals extends Record<string, BasicTypes> = GlobalVariablesType> {
+export interface ZylemGameConfig<StageInterface, GameInterface, TGlobals extends BaseGlobals> {
     id: string;
     globals?: TGlobals;
     stages?: StageInterface[];
@@ -26,3 +26,4 @@ export interface ZylemGameConfig<StageInterface, GameInterface, TGlobals extends
     time?: number;
     input?: GameInputConfig;
 }
+//# sourceMappingURL=game-interfaces.d.ts.map

package/dist/lib/game/game-interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-interfaces.d.ts","sourceRoot":"","sources":["../../../src/lib/game/game-interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACnD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAErD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACrC,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,EAAE,CAAC,EAAE,qBAAqB,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe,CAAC,cAAc,EAAE,aAAa,EAAE,QAAQ,SAAS,WAAW;IAC3F,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,eAAe,CAAC;CACxB"}

package/dist/lib/game/game-retro-resolutions.d.ts

@@ -0,0 +1,25 @@
+export type RetroResolution = {
+    key: string;
+    width: number;
+    height: number;
+    notes?: string;
+};
+export type RetroPreset = {
+    displayAspect: number;
+    resolutions: RetroResolution[];
+};
+/**
+ * Retro and console display presets.
+ * displayAspect represents the intended display aspect (letterboxing target),
+ * not necessarily the raw pixel aspect of internal buffers.
+ */
+declare const RetroPresets: Record<string, RetroPreset>;
+export type RetroPresetKey = keyof typeof RetroPresets;
+export declare function getDisplayAspect(preset: RetroPresetKey): number;
+export declare function getPresetResolution(preset: RetroPresetKey, key?: string): RetroResolution | undefined;
+export declare function parseResolution(text: string): {
+    width: number;
+    height: number;
+} | null;
+export {};
+//# sourceMappingURL=game-retro-resolutions.d.ts.map

package/dist/lib/game/game-retro-resolutions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-retro-resolutions.d.ts","sourceRoot":"","sources":["../../../src/lib/game/game-retro-resolutions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7F,MAAM,MAAM,WAAW,GAAG;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,eAAe,EAAE,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAuD7C,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,YAAY,CAAC;AAEvD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAE/D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAKrG;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAStF"}

package/dist/lib/game/game-retro-resolutions.js

@@ -0,0 +1,80 @@
+const n = {
+  NES: {
+    displayAspect: 1.3333333333333333,
+    resolutions: [
+      { key: "256x240", width: 256, height: 240, notes: "Standard NTSC; effective 240p." }
+    ]
+  },
+  SNES: {
+    displayAspect: 1.3333333333333333,
+    resolutions: [
+      { key: "256x224", width: 256, height: 224, notes: "Common 240p-equivalent mode." },
+      { key: "512x448", width: 512, height: 448, notes: "Hi-res interlaced (480i)." }
+    ]
+  },
+  N64: {
+    displayAspect: 1.3333333333333333,
+    resolutions: [
+      { key: "320x240", width: 320, height: 240, notes: "Common 240p mode." },
+      { key: "640x480", width: 640, height: 480, notes: "Higher resolution (480i)." }
+    ]
+  },
+  PS1: {
+    displayAspect: 1.3333333333333333,
+    resolutions: [
+      { key: "320x240", width: 320, height: 240, notes: "Progressive 240p common." },
+      { key: "640x480", width: 640, height: 480, notes: "Interlaced 480i for higher detail." }
+    ]
+  },
+  PS2: {
+    displayAspect: 1.3333333333333333,
+    resolutions: [
+      { key: "640x480", width: 640, height: 480, notes: "480i/480p baseline." },
+      { key: "720x480", width: 720, height: 480, notes: "480p (widescreen capable in some titles)." },
+      { key: "1280x720", width: 1280, height: 720, notes: "720p (select titles)." }
+    ]
+  },
+  PS5: {
+    displayAspect: 1.7777777777777777,
+    resolutions: [
+      { key: "720x480", width: 720, height: 480, notes: "Legacy compatibility." },
+      { key: "1280x720", width: 1280, height: 720, notes: "720p." },
+      { key: "1920x1080", width: 1920, height: 1080, notes: "1080p." },
+      { key: "2560x1440", width: 2560, height: 1440, notes: "1440p." },
+      { key: "3840x2160", width: 3840, height: 2160, notes: "4K (up to 120Hz)." },
+      { key: "7680x4320", width: 7680, height: 4320, notes: "8K (limited)." }
+    ]
+  },
+  XboxOne: {
+    displayAspect: 1.7777777777777777,
+    resolutions: [
+      { key: "1280x720", width: 1280, height: 720, notes: "720p (original)." },
+      { key: "1920x1080", width: 1920, height: 1080, notes: "1080p (original)." },
+      { key: "3840x2160", width: 3840, height: 2160, notes: "4K UHD (S/X models)." }
+    ]
+  }
+};
+function h(e) {
+  return n[e].displayAspect;
+}
+function r(e, o) {
+  const t = n[e]?.resolutions || [];
+  if (!o)
+    return t[0];
+  const i = o.toLowerCase().replace(/\s+/g, "").replace("×", "x");
+  return t.find((s) => s.key.toLowerCase() === i);
+}
+function l(e) {
+  if (!e)
+    return null;
+  const t = String(e).toLowerCase().trim().replace(/\s+/g, "").replace("×", "x").match(/^(\d+)x(\d+)$/);
+  if (!t)
+    return null;
+  const i = parseInt(t[1], 10), s = parseInt(t[2], 10);
+  return !Number.isFinite(i) || !Number.isFinite(s) ? null : { width: i, height: s };
+}
+export {
+  h as getDisplayAspect,
+  r as getPresetResolution,
+  l as parseResolution
+};