@zylem/game-lib 0.3.17 → 0.4.0

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,12 +36,19 @@ 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[];
@@ -45,3 +60,4 @@ export declare function resolveGameConfig(user?: GameConfigLike): GameConfig;
  * 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;AAkBD,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,GAAG,UAAU,CAkBtL;AAED,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,72 @@ 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,
+  B as createDefaultGameConfig,
+  k as gameConfig,
+  C as resolveGameConfig
 };

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

@@ -1,14 +1,14 @@
 import { Stage } from '../stage/stage';
-import type { BasicTypes, GlobalVariablesType, ZylemGameConfig, GameInputConfig } from './game-interfaces';
-export declare const gameDefaultsState: Partial<ZylemGameConfig<Stage, any, GlobalVariablesType>>;
+import type { BasicTypes, BaseGlobals, ZylemGameConfig, GameInputConfig } from './game-interfaces';
+export declare const gameDefaultsState: Partial<ZylemGameConfig<Stage, any, BaseGlobals>>;
 /** Replace multiple defaults at once (shallow merge). */
-export declare function setGameDefaults(partial: Partial<ZylemGameConfig<Stage, any, GlobalVariablesType>>): void;
+export declare function setGameDefaults(partial: Partial<ZylemGameConfig<Stage, any, BaseGlobals>>): void;
 /** Reset defaults back to library defaults. */
 export declare function resetGameDefaults(): void;
 /**
  * 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 +16,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,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAmBnG,eAAO,MAAM,iBAAiB,mDAE7B,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,GAAG,IAAI,CAEhG;AAED,+CAA+C;AAC/C,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;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-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,24 @@
+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.
+ */
+export 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;
+//# 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,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAuDpD,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,81 @@
+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 {
+  n as RetroPresets,
+  h as getDisplayAspect,
+  r as getPresetResolution,
+  l as parseResolution
+};

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

@@ -1,10 +1,11 @@
-import { BasicTypes, GlobalVariablesType } from './game-interfaces';
+import { BaseGlobals } from './game-interfaces';
 declare const state: {
     id: string;
-    globals: GlobalVariablesType;
+    globals: BaseGlobals;
     time: number;
 };
-export declare function setGlobalState<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType, K extends keyof TGlobals = keyof TGlobals>(key: K, value: TGlobals[K]): void;
-export declare function getGlobalState<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType>(): TGlobals;
-export declare function getGlobalState<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType, K extends keyof TGlobals = keyof TGlobals>(key: K): TGlobals[K];
+export declare function setGlobalState<TGlobals extends BaseGlobals, K extends keyof TGlobals = keyof TGlobals>(key: K, value: TGlobals[K]): void;
+export declare function getGlobalState<TGlobals extends BaseGlobals>(): TGlobals;
+export declare function getGlobalState<TGlobals extends BaseGlobals, K extends keyof TGlobals = keyof TGlobals>(key: K): TGlobals[K];
 export { state };
+//# sourceMappingURL=game-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"game-state.d.ts","sourceRoot":"","sources":["../../../src/lib/game/game-state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAE5D,QAAA,MAAM,KAAK;;aAEK,WAAW;;CAEzB,CAAC;AAEH,wBAAgB,cAAc,CAC7B,QAAQ,SAAS,WAAW,EAC5B,CAAC,SAAS,MAAM,QAAQ,GAAG,MAAM,QAAQ,EACxC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AAMpC,wBAAgB,cAAc,CAAC,QAAQ,SAAS,WAAW,KAAK,QAAQ,CAAC;AAEzE,wBAAgB,cAAc,CAC7B,QAAQ,SAAS,WAAW,EAC5B,CAAC,SAAS,MAAM,QAAQ,GAAG,MAAM,QAAQ,EACxC,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AASvB,OAAO,EAAE,KAAK,EAAE,CAAC"}

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

@@ -1,19 +1,18 @@
 import { ZylemGame } from './zylem-game';
-import { Stage } from '../stage/stage';
 import { DestroyFunction, IGame, SetupFunction, UpdateFunction } from '../core/base-node-life-cycle';
-import { BasicTypes, GlobalVariablesType } from './game-interfaces';
+import { BaseGlobals } from './game-interfaces';
 import { GameOptions } from '../core/utility/nodes';
-export declare class Game<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType> implements IGame<TGlobals> {
-    gameRef: ZylemGame<TGlobals> | null;
-    options: GameOptions<TGlobals>;
+export declare class Game<TGlobals extends BaseGlobals> implements IGame<TGlobals> {
+    private wrappedGame;
     private pendingGlobalChangeHandlers;
+    options: GameOptions<TGlobals>;
     update: UpdateFunction<ZylemGame<TGlobals>, TGlobals>;
     setup: SetupFunction<ZylemGame<TGlobals>, TGlobals>;
     destroy: DestroyFunction<ZylemGame<TGlobals>, TGlobals>;
     refErrorMessage: string;
     constructor(options: GameOptions<TGlobals>);
     start(): Promise<this>;
-    load(): Promise<ZylemGame<TGlobals>>;
+    private load;
     setOverrides(): void;
     pause(): Promise<void>;
     resume(): Promise<void>;
@@ -22,7 +21,6 @@ export declare class Game<TGlobals extends Record<string, BasicTypes> = GlobalVa
     previousStage(): Promise<void>;
     goToStage(): Promise<void>;
     end(): Promise<void>;
-    add(...inputs: Array<Stage | Promise<any> | (() => Stage | Promise<any>)>): this;
     getGlobal<K extends keyof TGlobals>(key: K): TGlobals[K];
     setGlobal<K extends keyof TGlobals>(key: K, value: TGlobals[K]): void;
     onGlobalChange<K extends keyof TGlobals>(key: K, callback: (value: TGlobals[K]) => void): void;
@@ -35,4 +33,5 @@ export declare class Game<TGlobals extends Record<string, BasicTypes> = GlobalVa
  * @param options.stages Array of stage objects (when using IGameOptions)
  * @returns Game
  */
-export declare function game<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType>(...options: GameOptions<TGlobals>): Game<TGlobals>;
+export declare function createGame<TGlobals extends BaseGlobals>(...options: GameOptions<TGlobals>): Game<TGlobals>;
+//# sourceMappingURL=game.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../../src/lib/game/game.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAErG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAgB,WAAW,EAAa,MAAM,uBAAuB,CAAC;AAI7E,qBAAa,IAAI,CAAC,QAAQ,SAAS,WAAW,CAAE,YAAW,KAAK,CAAC,QAAQ,CAAC;IACzE,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,2BAA2B,CAAsE;IAEzG,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE/B,MAAM,EAAE,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAa;IAClE,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAa;IAChE,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAa;IAEpE,eAAe,SAA4B;gBAE/B,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC;IAOpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,IAAI;IAYlB,YAAY;IAgBN,KAAK;IAIL,MAAM;IAQN,KAAK;IAQL,SAAS;IAeT,aAAa;IAeb,SAAS;IAET,GAAG;IAET,SAAS,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,EAAE,CAAC;IAO1C,SAAS,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IAQ9D,cAAc,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI;CAOvF;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,QAAQ,SAAS,WAAW,EAAE,GAAG,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAE1G"}

package/dist/lib/game/game.js

@@ -1,13 +1,13 @@
 import { ZylemGame as n } from "./zylem-game.js";
-import { Stage as o } from "../stage/stage.js";
-import { setPaused as r } from "../debug/debug-state.js";
-import { getGlobalState as g, setGlobalState as f } from "./game-state.js";
-import { convertNodes as h } from "../core/utility/nodes.js";
-import { resolveGameConfig as l } from "./game-config.js";
-class u {
-  gameRef = null;
-  options;
+import { setPaused as o } from "../debug/debug-state.js";
+import { getGlobalState as i, setGlobalState as p } from "./game-state.js";
+import { hasStages as d, convertNodes as l } from "../core/utility/nodes.js";
+import { resolveGameConfig as h } from "./game-config.js";
+import { stage as g } from "../stage/stage.js";
+class m {
+  wrappedGame = null;
   pendingGlobalChangeHandlers = [];
+  options;
   update = () => {
   };
   setup = () => {
@@ -15,119 +15,95 @@ class u {
   destroy = () => {
   };
   refErrorMessage = "lost reference to game";
-  constructor(t) {
-    this.options = t;
+  constructor(e) {
+    this.options = e, d(e) || this.options.push(g());
   }
   async start() {
-    const t = await this.load();
-    return this.gameRef = t, this.setOverrides(), t.start(), this;
+    const e = await this.load();
+    return this.wrappedGame = e, this.setOverrides(), e.start(), this;
   }
   async load() {
     console.log("loading game", this.options);
-    const t = await h(this.options), s = l(t), e = new n({
-      ...t,
-      ...s
+    const e = await l(this.options), a = h(e), t = new n({
+      ...e,
+      ...a
     }, this);
-    return await e.loadStage(t.stages[0]), e;
+    return await t.loadStage(e.stages[0]), t;
   }
   setOverrides() {
-    if (!this.gameRef) {
+    if (!this.wrappedGame) {
       console.error(this.refErrorMessage);
       return;
     }
-    if (this.gameRef.customSetup = this.setup, this.gameRef.customUpdate = this.update, this.gameRef.customDestroy = this.destroy, this.pendingGlobalChangeHandlers.length) {
-      for (const { key: t, callback: s } of this.pendingGlobalChangeHandlers)
-        this.gameRef.onGlobalChange(t, s);
+    if (this.wrappedGame.customSetup = this.setup, this.wrappedGame.customUpdate = this.update, this.wrappedGame.customDestroy = this.destroy, this.pendingGlobalChangeHandlers.length) {
+      for (const { key: e, callback: a } of this.pendingGlobalChangeHandlers)
+        this.wrappedGame.onGlobalChange(e, a);
       this.pendingGlobalChangeHandlers = [];
     }
   }
   async pause() {
-    r(!0);
+    o(!0);
   }
   async resume() {
-    r(!1), this.gameRef && (this.gameRef.previousTimeStamp = 0, this.gameRef.timer.reset());
+    o(!1), this.wrappedGame && (this.wrappedGame.previousTimeStamp = 0, this.wrappedGame.timer.reset());
   }
   async reset() {
-    if (!this.gameRef) {
+    if (!this.wrappedGame) {
       console.error(this.refErrorMessage);
       return;
     }
-    await this.gameRef.loadStage(this.gameRef.stages[0]);
+    await this.wrappedGame.loadStage(this.wrappedGame.stages[0]);
   }
   async nextStage() {
-    if (!this.gameRef) {
+    if (!this.wrappedGame) {
       console.error(this.refErrorMessage);
       return;
     }
-    const t = this.gameRef.currentStageId, s = this.gameRef.stages.findIndex((a) => a.stageRef.uuid === t), e = this.gameRef.stages[s + 1];
-    if (!e) {
+    const e = this.wrappedGame.currentStageId, a = this.wrappedGame.stages.findIndex((r) => r.wrappedStage.uuid === e), t = this.wrappedGame.stages[a + 1];
+    if (!t) {
       console.error("next stage called on last stage");
       return;
     }
-    await this.gameRef.loadStage(e);
+    await this.wrappedGame.loadStage(t);
   }
   async previousStage() {
-    if (!this.gameRef) {
+    if (!this.wrappedGame) {
       console.error(this.refErrorMessage);
       return;
     }
-    const t = this.gameRef.currentStageId, s = this.gameRef.stages.findIndex((a) => a.stageRef.uuid === t), e = this.gameRef.stages[s - 1];
-    if (!e) {
+    const e = this.wrappedGame.currentStageId, a = this.wrappedGame.stages.findIndex((r) => r.wrappedStage.uuid === e), t = this.wrappedGame.stages[a - 1];
+    if (!t) {
       console.error("previous stage called on first stage");
       return;
     }
-    await this.gameRef.loadStage(e);
+    await this.wrappedGame.loadStage(t);
   }
   async goToStage() {
   }
   async end() {
   }
-  add(...t) {
-    for (const s of t)
-      if (s) {
-        if (s instanceof o) {
-          this.gameRef ? (this.gameRef.stages.push(s), this.gameRef.stageMap.set(s.stageRef.uuid, s)) : this.options.push(s);
-          continue;
-        }
-        if (typeof s == "function") {
-          try {
-            const e = s();
-            e instanceof o ? this.gameRef ? (this.gameRef.stages.push(e), this.gameRef.stageMap.set(e.stageRef.uuid, e)) : this.options.push(e) : e && typeof e.then == "function" && e.then((a) => {
-              a instanceof o && (this.gameRef ? (this.gameRef.stages.push(a), this.gameRef.stageMap.set(a.stageRef.uuid, a)) : this.options.push(a));
-            }).catch((a) => console.error("Failed to add async stage", a));
-          } catch (e) {
-            console.error("Error executing stage factory", e);
-          }
-          continue;
-        }
-        s && typeof s.then == "function" && s.then((e) => {
-          e instanceof o && (this.gameRef ? (this.gameRef.stages.push(e), this.gameRef.stageMap.set(e.stageRef.uuid, e)) : this.options.push(e));
-        }).catch((e) => console.error("Failed to add async stage", e));
-      }
-    return this;
-  }
-  getGlobal(t) {
-    return this.gameRef ? this.gameRef.getGlobal(t) : g(t);
+  getGlobal(e) {
+    return this.wrappedGame ? this.wrappedGame.getGlobal(e) : i(e);
   }
-  setGlobal(t, s) {
-    if (this.gameRef) {
-      this.gameRef.setGlobal(t, s);
+  setGlobal(e, a) {
+    if (this.wrappedGame) {
+      this.wrappedGame.setGlobal(e, a);
       return;
     }
-    f(t, s);
+    p(e, a);
   }
-  onGlobalChange(t, s) {
-    if (this.gameRef) {
-      this.gameRef.onGlobalChange(t, s);
+  onGlobalChange(e, a) {
+    if (this.wrappedGame) {
+      this.wrappedGame.onGlobalChange(e, a);
       return;
     }
-    this.pendingGlobalChangeHandlers.push({ key: t, callback: s });
+    this.pendingGlobalChangeHandlers.push({ key: e, callback: a });
   }
 }
-function S(...i) {
-  return new u(i);
+function b(...s) {
+  return new m(s);
 }
 export {
-  u as Game,
-  S as game
+  m as Game,
+  b as createGame
 };

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

@@ -4,12 +4,12 @@ import { InputManager } from '../input/input-manager';
 import { Timer } from '../core/three-addons/Timer';
 import { ZylemCamera } from '~/lib/camera/zylem-camera';
 import { Stage } from '../stage/stage';
-import { BasicTypes, GlobalVariablesType, ZylemGameConfig } from './game-interfaces';
+import { BaseGlobals, ZylemGameConfig } from './game-interfaces';
 import { GameConfig } from './game-config';
 import { AspectRatioDelegate } from '../device/aspect-ratio';
 import { GameCanvas } from './game-canvas';
-type ZylemGameOptions<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType> = ZylemGameConfig<Stage, ZylemGame<TGlobals>, TGlobals> & Partial<GameConfig>;
-export declare class ZylemGame<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType> {
+type ZylemGameOptions<TGlobals extends BaseGlobals> = ZylemGameConfig<Stage, ZylemGame<TGlobals>, TGlobals> & Partial<GameConfig>;
+export declare class ZylemGame<TGlobals extends BaseGlobals> {
     id: string;
     initialGlobals: TGlobals;
     customSetup: ((params: SetupContext<ZylemGame<TGlobals>, TGlobals>) => void) | null;
@@ -55,3 +55,4 @@ export declare class ZylemGame<TGlobals extends Record<string, BasicTypes> = Glo
     onGlobalChange<K extends keyof TGlobals>(key: K, callback: (value: TGlobals[K]) => void): void;
 }
 export default ZylemGame;
+//# sourceMappingURL=zylem-game.d.ts.map

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

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