@zylem/game-lib 0.3.16 → 0.4.0

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,20 +1,18 @@
-import { BaseNode } from '../core/base-node';
 import { ZylemGame } from './zylem-game';
-import { Stage } from '../stage/stage';
 import { DestroyFunction, IGame, SetupFunction, UpdateFunction } from '../core/base-node-life-cycle';
-import { GameEntityLifeCycle } from '../entities/entity';
-import { BasicTypes, GlobalVariablesType, ZylemGameConfig } from './game-interfaces';
-export declare class Game<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType> implements IGame<TGlobals> {
-    gameRef: ZylemGame<TGlobals> | null;
-    options: GameOptions<TGlobals>;
+import { BaseGlobals } from './game-interfaces';
+import { GameOptions } from '../core/utility/nodes';
+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>;
@@ -23,12 +21,10 @@ 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;
 }
-type GameOptions<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType> = Array<ZylemGameConfig<Stage, Game<TGlobals>, TGlobals> | Stage | GameEntityLifeCycle | BaseNode>;
 /**
  * create a new game
  * @param options GameOptions - Array of IGameOptions, Stage, GameEntity, or BaseNode objects
@@ -37,5 +33,5 @@ type GameOptions<TGlobals extends Record<string, BasicTypes> = GlobalVariablesTy
  * @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 {};
+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,40 +1,13 @@
-import { BaseNode as h } from "../core/base-node.js";
-import { ZylemGame as c } from "./zylem-game.js";
-import { Stage as o, stage as l } from "../stage/stage.js";
-import { setPaused as r } from "../debug/debug-state.js";
-import { GameEntity as u } from "../entities/entity.js";
-import { getGlobalState as m, setGlobalState as p } from "./game-state.js";
-const f = {
-  id: "zylem",
-  globals: {},
-  stages: [
-    l()
-  ]
-};
-function d(n) {
-  let e = { ...f };
-  const t = [], s = [], a = [];
-  return Object.values(n).forEach((i) => {
-    if (i instanceof o)
-      s.push(i);
-    else if (i instanceof u)
-      a.push(i);
-    else if (i instanceof h)
-      a.push(i);
-    else if (i.constructor.name === "Object" && typeof i == "object") {
-      const g = Object.assign(f, { ...i });
-      t.push(g);
-    }
-  }), t.forEach((i) => {
-    e = Object.assign(e, { ...i });
-  }), s.forEach((i) => {
-    i.addEntities(a);
-  }), s.length ? e.stages = s : e.stages[0].addEntities(a), e;
-}
-class R {
-  gameRef = null;
-  options;
+import { ZylemGame as n } from "./zylem-game.js";
+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 = () => {
@@ -43,115 +16,94 @@ class R {
   };
   refErrorMessage = "lost reference to game";
   constructor(e) {
-    this.options = e;
+    this.options = e, d(e) || this.options.push(g());
   }
   async start() {
     const e = await this.load();
-    return this.gameRef = e, this.setOverrides(), e.start(), this;
+    return this.wrappedGame = e, this.setOverrides(), e.start(), this;
   }
   async load() {
     console.log("loading game", this.options);
-    const e = d(this.options), t = new c(e, this);
+    const e = await l(this.options), a = h(e), t = new n({
+      ...e,
+      ...a
+    }, this);
     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: e, callback: t } of this.pendingGlobalChangeHandlers)
-        this.gameRef.onGlobalChange(e, t);
+    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 e = this.gameRef.currentStageId, t = this.gameRef.stages.findIndex((a) => a.stageRef.uuid === e), s = this.gameRef.stages[t + 1];
-    if (!s) {
+    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(s);
+    await this.wrappedGame.loadStage(t);
   }
   async previousStage() {
-    if (!this.gameRef) {
+    if (!this.wrappedGame) {
       console.error(this.refErrorMessage);
       return;
     }
-    const e = this.gameRef.currentStageId, t = this.gameRef.stages.findIndex((a) => a.stageRef.uuid === e), s = this.gameRef.stages[t - 1];
-    if (!s) {
+    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(s);
+    await this.wrappedGame.loadStage(t);
   }
   async goToStage() {
   }
   async end() {
   }
-  add(...e) {
-    for (const t of e)
-      if (t) {
-        if (t instanceof o) {
-          this.gameRef ? (this.gameRef.stages.push(t), this.gameRef.stageMap.set(t.stageRef.uuid, t)) : this.options.push(t);
-          continue;
-        }
-        if (typeof t == "function") {
-          try {
-            const s = t();
-            s instanceof o ? this.gameRef ? (this.gameRef.stages.push(s), this.gameRef.stageMap.set(s.stageRef.uuid, s)) : this.options.push(s) : s && typeof s.then == "function" && s.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 (s) {
-            console.error("Error executing stage factory", s);
-          }
-          continue;
-        }
-        t && typeof t.then == "function" && t.then((s) => {
-          s instanceof o && (this.gameRef ? (this.gameRef.stages.push(s), this.gameRef.stageMap.set(s.stageRef.uuid, s)) : this.options.push(s));
-        }).catch((s) => console.error("Failed to add async stage", s));
-      }
-    return this;
-  }
   getGlobal(e) {
-    return this.gameRef ? this.gameRef.getGlobal(e) : m(e);
+    return this.wrappedGame ? this.wrappedGame.getGlobal(e) : i(e);
   }
-  setGlobal(e, t) {
-    if (this.gameRef) {
-      this.gameRef.setGlobal(e, t);
+  setGlobal(e, a) {
+    if (this.wrappedGame) {
+      this.wrappedGame.setGlobal(e, a);
       return;
     }
-    p(e, t);
+    p(e, a);
   }
-  onGlobalChange(e, t) {
-    if (this.gameRef) {
-      this.gameRef.onGlobalChange(e, t);
+  onGlobalChange(e, a) {
+    if (this.wrappedGame) {
+      this.wrappedGame.onGlobalChange(e, a);
       return;
     }
-    this.pendingGlobalChangeHandlers.push({ key: e, callback: t });
+    this.pendingGlobalChangeHandlers.push({ key: e, callback: a });
   }
 }
-function M(...n) {
-  return new R(n);
+function b(...s) {
+  return new m(s);
 }
 export {
-  R as Game,
-  M as game
+  m as Game,
+  b as createGame
 };

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

@@ -4,8 +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';
-export declare class ZylemGame<TGlobals extends Record<string, BasicTypes> = GlobalVariablesType> {
+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 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;
@@ -26,10 +30,17 @@ export declare class ZylemGame<TGlobals extends Record<string, BasicTypes> = Glo
         dom: HTMLElement;
     } | null;
     defaultCamera: ZylemCamera | null;
+    container: HTMLElement | null;
+    canvas: HTMLCanvasElement | null;
+    aspectRatioDelegate: AspectRatioDelegate | null;
+    resolvedConfig: GameConfig | null;
+    gameCanvas: GameCanvas | null;
     static FRAME_LIMIT: number;
     static FRAME_DURATION: number;
     static MAX_DELTA_SECONDS: number;
-    constructor(options: ZylemGameConfig<Stage, ZylemGame<TGlobals>, TGlobals>, wrapperRef: Game<TGlobals>);
+    constructor(options: ZylemGameOptions<TGlobals>, wrapperRef: Game<TGlobals>);
+    loadGameCanvas(config: GameConfig): void;
+    loadDebugOptions(options: ZylemGameOptions<TGlobals>): void;
     loadStage(stage: Stage): Promise<void>;
     unloadCurrentStage(): void;
     setGlobals(options: ZylemGameConfig<Stage, ZylemGame<TGlobals>, TGlobals>): void;
@@ -44,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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"}

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

@@ -1,10 +1,12 @@
-import { state as i, getGlobalState as r, setGlobalState as n } from "./game-state.js";
-import { setDebugFlag as u, isPaused as h } from "../debug/debug-state.js";
-import { InputManager as g } from "../input/input-manager.js";
-import { Timer as c } from "../core/three-addons/Timer.js";
-import { subscribe as m } from "valtio/vanilla";
-import f from "stats.js";
-class l {
+import { state as o, getGlobalState as r, setGlobalState as d } from "./game-state.js";
+import { setDebugFlag as h, isPaused as m } from "../debug/debug-state.js";
+import { InputManager as c } from "../input/input-manager.js";
+import { Timer as p } from "../core/three-addons/Timer.js";
+import { resolveGameConfig as g } from "./game-config.js";
+import { GameCanvas as f } from "./game-canvas.js";
+import { subscribe as S } from "valtio/vanilla";
+import b from "stats.js";
+class n {
   id;
   initialGlobals = {};
   customSetup = null;
@@ -20,27 +22,59 @@ class l {
   wrapperRef;
   statsRef = null;
   defaultCamera = null;
+  container = null;
+  canvas = null;
+  aspectRatioDelegate = null;
+  resolvedConfig = null;
+  gameCanvas = null;
   static FRAME_LIMIT = 120;
-  static FRAME_DURATION = 1e3 / l.FRAME_LIMIT;
+  static FRAME_DURATION = 1e3 / n.FRAME_LIMIT;
   static MAX_DELTA_SECONDS = 1 / 30;
   constructor(t, e) {
-    this.wrapperRef = e, this.inputManager = new g(t.input), this.timer = new c(), this.timer.connect(document), this.id = t.id, this.stages = t.stages || [], this.setGlobals(t), t.debug && (this.statsRef = new f(), this.statsRef.showPanel(0), this.statsRef.dom.style.position = "absolute", this.statsRef.dom.style.bottom = "0", this.statsRef.dom.style.right = "0", this.statsRef.dom.style.top = "auto", this.statsRef.dom.style.left = "auto", document.body.appendChild(this.statsRef.dom));
+    this.wrapperRef = e, this.inputManager = new c(t.input), this.timer = new p(), this.timer.connect(document);
+    const a = g(t);
+    this.id = a.id, this.stages = a.stages || [], this.container = a.container, this.canvas = a.canvas ?? null, this.resolvedConfig = a, this.loadGameCanvas(a), this.loadDebugOptions(t), this.setGlobals(t);
+  }
+  loadGameCanvas(t) {
+    this.gameCanvas = new f({
+      id: t.id,
+      container: t.container,
+      containerId: t.containerId,
+      canvas: this.canvas ?? void 0,
+      bodyBackground: t.bodyBackground,
+      fullscreen: t.fullscreen,
+      aspectRatio: t.aspectRatio
+    }), this.gameCanvas.applyBodyBackground(), this.gameCanvas.mountCanvas(), this.gameCanvas.centerIfFullscreen();
+  }
+  loadDebugOptions(t) {
+    h(!!t.debug), t.debug && (this.statsRef = new b(), this.statsRef.showPanel(0), this.statsRef.dom.style.position = "absolute", this.statsRef.dom.style.bottom = "0", this.statsRef.dom.style.right = "0", this.statsRef.dom.style.top = "auto", this.statsRef.dom.style.left = "auto", document.body.appendChild(this.statsRef.dom));
   }
   async loadStage(t) {
     this.unloadCurrentStage();
     const e = t.options[0];
-    await t.load(this.id, e?.camera), this.stageMap.set(t.stageRef.uuid, t), this.currentStageId = t.stageRef.uuid, this.defaultCamera = t.stageRef.cameraRef;
+    if (await t.load(this.id, e?.camera), this.stageMap.set(t.wrappedStage.uuid, t), this.currentStageId = t.wrappedStage.uuid, this.defaultCamera = t.wrappedStage.cameraRef, this.container && this.defaultCamera) {
+      const a = this.defaultCamera.getDomElement(), s = this.resolvedConfig?.internalResolution;
+      this.gameCanvas?.mountRenderer(a, (i, l) => {
+        if (this.defaultCamera)
+          if (s)
+            this.defaultCamera.setPixelRatio(1), this.defaultCamera.resize(s.width, s.height);
+          else {
+            const u = window.devicePixelRatio || 1;
+            this.defaultCamera.setPixelRatio(u), this.defaultCamera.resize(i, l);
+          }
+      });
+    }
   }
   unloadCurrentStage() {
     if (!this.currentStageId)
       return;
     const t = this.getStage(this.currentStageId);
     if (t) {
-      if (t?.stageRef)
+      if (t?.wrappedStage)
         try {
-          t.stageRef.nodeDestroy({
-            me: t.stageRef,
-            globals: i.globals
+          t.wrappedStage.nodeDestroy({
+            me: t.wrappedStage,
+            globals: o.globals
           });
         } catch (e) {
           console.error("Failed to destroy previous stage", e);
@@ -49,37 +83,37 @@ class l {
     }
   }
   setGlobals(t) {
-    u(t.debug), this.initialGlobals = { ...t.globals };
+    this.initialGlobals = { ...t.globals };
     for (const e in this.initialGlobals) {
-      const s = this.initialGlobals[e];
-      s === void 0 && console.error(`global ${e} is undefined`), this.setGlobal(e, s);
+      const a = this.initialGlobals[e];
+      a === void 0 && console.error(`global ${e} is undefined`), this.setGlobal(e, a);
     }
   }
   params() {
-    const t = this.currentStage(), e = this.timer.getDelta(), s = this.inputManager.getInputs(e), a = t?.stageRef?.cameraRef || this.defaultCamera;
+    const t = this.currentStage(), e = this.timer.getDelta(), a = this.inputManager.getInputs(e), s = t?.wrappedStage?.cameraRef || this.defaultCamera;
     return {
       delta: e,
-      inputs: s,
-      globals: i.globals,
+      inputs: a,
+      globals: o.globals,
       me: this,
-      camera: a
+      camera: s
     };
   }
   start() {
     const t = this.currentStage(), e = this.params();
-    t.start({ ...e, me: t.stageRef }), this.customSetup && this.customSetup(e), this.loop(0);
+    t.start({ ...e, me: t.wrappedStage }), this.customSetup && this.customSetup(e), this.loop(0);
   }
   loop(t) {
-    if (this.statsRef && this.statsRef.begin(), !h()) {
+    if (this.statsRef && this.statsRef.begin(), !m()) {
       this.timer.update(t);
-      const e = this.currentStage(), s = this.params(), a = Math.min(s.delta, l.MAX_DELTA_SECONDS), o = { ...s, delta: a };
-      this.customUpdate && this.customUpdate(o), e && e.stageRef.nodeUpdate({ ...o, me: e.stageRef }), this.totalTime += o.delta, i.time = this.totalTime, this.previousTimeStamp = t;
+      const e = this.currentStage(), a = this.params(), s = Math.min(a.delta, n.MAX_DELTA_SECONDS), i = { ...a, delta: s };
+      this.customUpdate && this.customUpdate(i), e && e.wrappedStage.nodeUpdate({ ...i, me: e.wrappedStage }), this.totalTime += i.delta, o.time = this.totalTime, this.previousTimeStamp = t;
     }
     this.statsRef && this.statsRef.end(), this.outOfLoop(), requestAnimationFrame(this.loop.bind(this));
   }
   outOfLoop() {
     const t = this.currentStage();
-    t && t.stageRef.outOfLoop();
+    t && t.wrappedStage.outOfLoop();
   }
   getStage(t) {
     return this.stageMap.get(t);
@@ -91,17 +125,17 @@ class l {
     return r(t);
   }
   setGlobal(t, e) {
-    n(t, e);
+    d(t, e);
   }
   onGlobalChange(t, e) {
-    let s = r(t);
-    m(i, () => {
-      const a = r(t);
-      a !== s && (s = a, e(a));
+    let a = r(t);
+    S(o, () => {
+      const s = r(t);
+      s !== a && (a = s, e(s));
     });
   }
 }
 export {
-  l as ZylemGame,
-  l as default
+  n as ZylemGame,
+  n as default
 };

package/dist/lib/graphics/geometries/XZPlaneGeometry.d.ts

@@ -5,3 +5,4 @@ declare class XZPlaneGeometry extends BufferGeometry {
     static fromJSON(data: any): XZPlaneGeometry;
 }
 export { XZPlaneGeometry };
+//# sourceMappingURL=XZPlaneGeometry.d.ts.map

package/dist/lib/graphics/geometries/XZPlaneGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XZPlaneGeometry.d.ts","sourceRoot":"","sources":["../../../../src/lib/graphics/geometries/XZPlaneGeometry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAA0B,MAAM,OAAO,CAAC;AAE/D,cAAM,eAAgB,SAAQ,cAAc;gBAE/B,KAAK,SAAI,EAAE,MAAM,SAAI,EAAE,aAAa,SAAI,EAAE,cAAc,SAAI;IAwExE,IAAI,CAAC,MAAM,KAAA;IASX,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAA;CAIpB;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/lib/graphics/material.d.ts

@@ -1,5 +1,5 @@
 import { Color, Material, Vector2 } from 'three';
-import { shortHash } from '../core/utility';
+import { shortHash } from '../core/utility/strings';
 import { ZylemShaderType } from '../core/preset-shader';
 export interface MaterialOptions {
     path?: string;
@@ -26,3 +26,4 @@ export declare class MaterialBuilder {
     setShader(customShader: ZylemShaderType): void;
 }
 export {};
+//# sourceMappingURL=material.d.ts.map

package/dist/lib/graphics/material.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material.d.ts","sourceRoot":"","sources":["../../../src/lib/graphics/material.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,EACL,QAAQ,EAMR,OAAO,EAEP,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,SAAS,EAAmB,MAAM,yBAAyB,CAAC;AACrE,OAAkB,EAAqB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEtF,MAAM,WAAW,eAAe;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,KAAK,CAAC;CACd;AAED,KAAK,gBAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5C,UAAU,sBAAsB;IAC/B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,QAAQ,CAAC;CACnB;AAED,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAE7C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;AAExC,qBAAa,eAAe;IAC3B,MAAM,CAAC,gBAAgB,EAAE,GAAG,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAa;IAE3E,SAAS,EAAE,QAAQ,EAAE,CAAM;IAE3B,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,EAAE,UAAU,EAAE,MAAM;IAmB7D,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,EAAE,UAAU,EAAE,MAAM;IAWjE,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAK7B,UAAU,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAKvC,UAAU,CAAC,WAAW,GAAE,WAAkB,EAAE,MAAM,GAAE,OAA2B;IAerF,QAAQ,CAAC,KAAK,EAAE,KAAK;IAWrB,SAAS,CAAC,YAAY,EAAE,eAAe;CAgBvC"}

package/dist/lib/graphics/material.js

@@ -1,5 +1,5 @@
 import { Color as n, Vector2 as m, TextureLoader as c, RepeatWrapping as o, MeshPhongMaterial as p, MeshStandardMaterial as u, ShaderMaterial as f, Vector3 as d } from "three";
-import { shortHash as M, sortedStringify as w } from "../core/utility.js";
+import { shortHash as M, sortedStringify as w } from "../core/utility/strings.js";
 import h from "../core/preset-shader.js";
 class i {
   static batchMaterialMap = /* @__PURE__ */ new Map();

package/dist/lib/graphics/mesh.d.ts

@@ -16,3 +16,4 @@ export declare class MeshBuilder {
     _build(meshOptions: MeshBuilderOptions, geometry: BufferGeometry, materials: Material[]): Mesh;
     _postBuild(): void;
 }
+//# sourceMappingURL=mesh.d.ts.map

package/dist/lib/graphics/mesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh.d.ts","sourceRoot":"","sources":["../../../src/lib/graphics/mesh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC;AAE1F,qBAAa,WAAW;IAEvB,MAAM,CAAC,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI;IAY9F,UAAU,IAAI,IAAI;CAGlB"}