@zylem/game-lib 0.6.3 → 0.6.4

package/dist/{core-DAkskq6Y.d.ts → core-CARRaS55.d.ts}

@@ -1,9 +1,9 @@
-import { ak as InputPlayerNumber, al as InputProvider, am as Inputs, L as SetupContext, U as UpdateContext, M as DestroyContext, an as GameEntityLifeCycle, N as BaseNode, ao as IGame, S as SetupFunction, J as UpdateFunction, K as DestroyFunction, aa as GameEvents, ap as LoadedContext, aq as CleanupContext, ar as NodeInterface } from './entity-BpbZqg19.js';
-import { G as GameInputConfig, e as StageInterface, B as BaseGlobals, b as Stage, Z as ZylemGameConfig } from './stage-types-BFsm3qsZ.js';
-import { Z as ZylemCamera, R as RendererManager } from './camera-B5e4c78l.js';
+import { ak as InputPlayerNumber, al as InputProvider, am as Inputs, L as SetupContext, U as UpdateContext, M as DestroyContext, an as GameEntityLifeCycle, O as BaseNode, ao as IGame, S as SetupFunction, J as UpdateFunction, K as DestroyFunction, aa as GameEvents, ap as LoadedContext, aq as CleanupContext, ar as NodeInterface } from './entity-vj-HTjzU.js';
+import { G as GameInputConfig, e as StageInterface, B as BaseGlobals, b as Stage, Z as ZylemGameConfig } from './stage-types-C19IhuzA.js';
+import { Z as ZylemCamera, R as RendererManager } from './camera-4XO5gbQH.js';
 import { Vector3 } from 'three';
 import { Vector3 as Vector3$1 } from '@dimforge/rapier3d-compat';
-import './global-change-Dc8uCKi2.js';
+import './global-change-2JvMaz44.js';
 
 declare class InputManager {
     private inputMap;
@@ -11,8 +11,8 @@ declare class InputManager {
     private previousInputs;
     constructor(config?: GameInputConfig);
     /**
-     * Reconfigure keyboard providers at runtime without affecting gamepad providers.
-     * Disposes existing keyboard providers and creates new ones from the given config.
+     * Reconfigure keyboard and mouse providers at runtime without affecting gamepad providers.
+     * Disposes existing keyboard/mouse providers and creates new ones from the given config.
      */
     configure(config: GameInputConfig): void;
     addInputProvider(playerNumber: InputPlayerNumber, provider: InputProvider): void;
@@ -115,6 +115,7 @@ declare class Timer {
 declare const AspectRatio: {
     readonly FourByThree: number;
     readonly SixteenByNine: number;
+    readonly NineBySixteen: number;
     readonly TwentyOneByNine: number;
     readonly OneByOne: number;
 };
@@ -131,6 +132,7 @@ declare class AspectRatioDelegate {
     aspectRatio: number;
     onResize?: (width: number, height: number) => void;
     private handleResizeBound;
+    private resizeObserver;
     constructor(params: {
         container: HTMLElement;
         canvas: HTMLCanvasElement;
@@ -150,6 +152,11 @@ declare class AspectRatioDelegate {
     apply(): void;
 }
 
+interface ViewportSize {
+    width: number;
+    height: number;
+}
+
 type RetroResolution = {
     key: string;
     width: number;
@@ -161,13 +168,36 @@ type RetroPreset = {
     resolutions: RetroResolution[];
 };
 /**
- * Retro and console display presets.
+ * Retro, console, and device 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>;
 type RetroPresetKey = keyof typeof RetroPresets;
+declare function getDisplayAspect(preset: RetroPresetKey): number;
+declare function getPresetResolution(preset: RetroPresetKey, key?: string): RetroResolution | undefined;
+declare function parseResolution(text: string): {
+    width: number;
+    height: number;
+} | null;
 
+type ResolutionInput = string | {
+    width: number;
+    height: number;
+};
+type DeviceProfile = 'auto' | 'desktop' | 'mobile';
+interface ResolveGameConfigRuntime {
+    deviceProfile?: DeviceProfile;
+    viewportSize?: ViewportSize;
+}
+type GameDeviceConfig = Partial<{
+    /** numeric value or key in AspectRatio */
+    aspectRatio: AspectRatioValue | keyof typeof AspectRatio;
+    /** console/display preset to derive aspect ratio */
+    preset: RetroPresetKey;
+    /** lock internal render buffer for this device profile */
+    resolution: ResolutionInput;
+}>;
 type GameConfigLike = Partial<{
     id: string;
     globals: Record<string, any>;
@@ -179,11 +209,10 @@ type GameConfigLike = Partial<{
     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;
-    };
+    /** lock internal render buffer to this desktop/default resolution */
+    resolution: ResolutionInput;
+    /** mobile-specific aspect/preset/resolution overrides */
+    mobile: GameDeviceConfig;
     fullscreen: boolean;
     /** CSS background value for document body */
     bodyBackground: string;
@@ -252,6 +281,8 @@ declare class GameCanvas {
     mountRenderer(rendererDom: HTMLCanvasElement, onResize: (width: number, height: number) => void): void;
     centerIfFullscreen(): void;
     attachAspectRatio(onResize: (width: number, height: number) => void): void;
+    setAspectRatio(aspectRatio: number): void;
+    reapplyLayout(): void;
     destroy(): void;
     private ensureContainer;
 }
@@ -299,10 +330,17 @@ declare class ZylemGame<TGlobals extends BaseGlobals> {
     private loadingDelegate;
     private rendererObserver;
     private eventBusUnsubscribes;
+    private readonly gameUpdateParams;
+    private readonly stageSetupParams;
+    private readonly stageUpdateParams;
+    private readonly frameCallback;
+    private readonly sourceOptions;
+    private displayRuntime;
     static FRAME_LIMIT: number;
     static FRAME_DURATION: number;
     static MAX_DELTA_SECONDS: number;
-    constructor(options: ZylemGameOptions<TGlobals>, wrapperRef: Game<TGlobals>);
+    constructor(options: ZylemGameOptions<TGlobals>, wrapperRef: Game<TGlobals>, displayRuntime?: ResolveGameConfigRuntime);
+    setDisplayRuntime(runtime: ResolveGameConfigRuntime): void;
     loadGameCanvas(config: GameConfig): void;
     loadDebugOptions(options: ZylemGameOptions<TGlobals>): void;
     loadStage(stage: Stage, stageIndex?: number): Promise<void>;
@@ -378,6 +416,7 @@ declare class Game<TGlobals extends BaseGlobals> implements IGame<TGlobals> {
     private eventDelegate;
     /** Pending global input config set before the game starts. */
     private pendingInputConfig;
+    private displayRuntime;
     refErrorMessage: string;
     constructor(options: GameOptions<TGlobals>);
     onSetup(...callbacks: Array<SetupFunction<ZylemGame<TGlobals>, TGlobals>>): this;
@@ -392,6 +431,9 @@ declare class Game<TGlobals extends BaseGlobals> implements IGame<TGlobals> {
      */
     setInputConfiguration(...configs: GameInputConfig[]): this;
     start(): Promise<this>;
+    setDisplayRuntime(runtime: Partial<ResolveGameConfigRuntime>): this;
+    setDeviceProfile(profile: DeviceProfile): this;
+    setViewportSize(width: number, height: number): this;
     private load;
     private setOverrides;
     /**
@@ -476,6 +518,7 @@ declare class Vessel extends BaseNode<{}, Vessel> {
     protected _destroy(_params: DestroyContext<this>): void;
     protected _cleanup(_params: CleanupContext<this>): void;
     create(): this;
+    clone(): this;
     /**
      * Add one or more child entities to this vessel.
      * Overrides parent to support multiple arguments.
@@ -495,4 +538,4 @@ declare function vessel(...args: Array<BaseNode>): Vessel;
  */
 type Vect3 = Vector3 | Vector3$1;
 
-export { Game as G, type Vect3 as V, createGame as c, gameConfig as g, vessel as v };
+export { AspectRatio as A, type DeviceProfile as D, Game as G, type ResolutionInput as R, type Vect3 as V, type GameConfigLike as a, type GameDeviceConfig as b, createGame as c, type ResolveGameConfigRuntime as d, type AspectRatioValue as e, getDisplayAspect as f, gameConfig as g, getPresetResolution as h, type RetroPreset as i, type RetroPresetKey as j, type RetroResolution as k, parseResolution as p, vessel as v };

package/dist/core.d.ts

@@ -1,16 +1,17 @@
-export { V as Vect3, c as createGame, v as vessel } from './core-DAkskq6Y.js';
-export { Z as ZylemGameConfig } from './stage-types-BFsm3qsZ.js';
-export { g as globalChange, a as globalChanges, v as variableChange, b as variableChanges } from './global-change-Dc8uCKi2.js';
-import './entity-BpbZqg19.js';
+export { V as Vect3, c as createGame, v as vessel } from './core-CARRaS55.js';
+export { Z as ZylemGameConfig } from './stage-types-C19IhuzA.js';
+export { g as globalChange, a as globalChanges, v as variableChange, b as variableChanges } from './global-change-2JvMaz44.js';
+import './entity-vj-HTjzU.js';
 import 'three';
 import '@dimforge/rapier3d-compat';
 import 'bitecs';
 import 'mitt';
-import './behavior-descriptor-BWNWmIjv.js';
-import './camera-B5e4c78l.js';
+import './behavior-descriptor-BXnVR8Ki.js';
+import './camera-4XO5gbQH.js';
 import './entity-Bq_eNEDI.js';
 import 'three/webgpu';
 import 'three/examples/jsm/postprocessing/EffectComposer.js';
-import './world-Be5m1XC1.js';
+import './world-DfgxoNMt.js';
 import './entity-types-DAu8sGJH.js';
-import './entities-DC9ce_vx.js';
+import './physics-pose-DCc4oE44.js';
+import './entities-ChFirVL9.js';