@zylem/game-lib 0.5.1 → 0.6.0

package/dist/{core-C2mjetAd.d.ts → core-CZhozNRH.d.ts}

@@ -1,7 +1,7 @@
-import { I as InputGamepad, b as UpdateFunction, f as InputPlayerNumber, g as Inputs, h as ButtonState, A as AnalogState, c as SetupContext, U as UpdateContext, d as DestroyContext, i as GameEntityLifeCycle, e as BaseNode, j as IGame, S as SetupFunction, D as DestroyFunction, L as LoadingEvent, k as LoadedContext, C as CleanupContext } from './entity-bQElAdpo.js';
-import { Z as ZylemCamera } from './camera-Dk-fOVZE.js';
-import { B as BaseEntityInterface, a as Stage } from './stage-CrmY7V0i.js';
-import { Color, Vector3 } from 'three';
+import { I as InputGamepad, c as UpdateFunction, f as InputPlayerNumber, g as Inputs, h as ButtonState, A as AnalogState, S as SetupContext, U as UpdateContext, d as DestroyContext, i as GameEntityLifeCycle, e as BaseNode, j as IGame, b as SetupFunction, D as DestroyFunction, k as LoadedContext, C as CleanupContext } from './entity-COvRtFNG.js';
+import { Z as ZylemCamera } from './camera-CpbDr4-V.js';
+import { d as StageInterface, b as Stage } from './stage-types-CD21XoIU.js';
+import { Vector3 } from 'three';
 import { Vector3 as Vector3$1 } from '@dimforge/rapier3d-compat';
 
 interface InputProvider {
@@ -141,30 +141,6 @@ declare class Timer {
     update(timestamp?: number): Timer;
 }
 
-/**
- * Stage state interface - minimal to prevent circular dependencies
- */
-interface StageStateInterface {
-    backgroundColor: Color;
-    backgroundImage: string | null;
-    inputs: {
-        p1: string[];
-        p2: string[];
-    };
-    variables: Record<string, any>;
-    gravity: Vector3;
-    entities: Partial<BaseEntityInterface>[];
-    stageRef?: any;
-}
-/**
- * Minimal stage interface to break circular dependencies
- */
-interface StageInterface {
-    uuid: string;
-    children: any[];
-    state: StageStateInterface;
-}
-
 declare const AspectRatio: {
     readonly FourByThree: number;
     readonly SixteenByNine: number;
@@ -309,6 +285,19 @@ declare class GameCanvas {
     private ensureContainer;
 }
 
+/**
+ * Game-level loading event that includes stage context.
+ */
+interface GameLoadingEvent {
+    type: 'start' | 'progress' | 'complete';
+    stageName?: string;
+    stageIndex?: number;
+    message: string;
+    progress: number;
+    current?: number;
+    total?: number;
+}
+
 type ZylemGameOptions<TGlobals extends BaseGlobals> = ZylemGameConfig<Stage, ZylemGame<TGlobals>, TGlobals> & Partial<GameConfig>;
 declare class ZylemGame<TGlobals extends BaseGlobals> {
     id: string;
@@ -324,12 +313,6 @@ declare class ZylemGame<TGlobals extends BaseGlobals> {
     timer: Timer;
     inputManager: InputManager;
     wrapperRef: Game<TGlobals>;
-    statsRef: {
-        begin: () => void;
-        end: () => void;
-        showPanel: (panel: number) => void;
-        dom: HTMLElement;
-    } | null;
     defaultCamera: ZylemCamera | null;
     container: HTMLElement | null;
     canvas: HTMLCanvasElement | null;
@@ -338,13 +321,17 @@ declare class ZylemGame<TGlobals extends BaseGlobals> {
     gameCanvas: GameCanvas | null;
     private animationFrameId;
     private isDisposed;
+    private debugDelegate;
+    private loadingDelegate;
+    private rendererObserver;
+    private eventBusUnsubscribes;
     static FRAME_LIMIT: number;
     static FRAME_DURATION: number;
     static MAX_DELTA_SECONDS: number;
     constructor(options: ZylemGameOptions<TGlobals>, wrapperRef: Game<TGlobals>);
     loadGameCanvas(config: GameConfig): void;
     loadDebugOptions(options: ZylemGameOptions<TGlobals>): void;
-    loadStage(stage: Stage): Promise<void>;
+    loadStage(stage: Stage, stageIndex?: number): Promise<void>;
     unloadCurrentStage(): void;
     setGlobals(options: ZylemGameConfig<Stage, ZylemGame<TGlobals>, TGlobals>): void;
     params(): UpdateContext<ZylemGame<TGlobals>, TGlobals>;
@@ -354,6 +341,18 @@ declare class ZylemGame<TGlobals extends BaseGlobals> {
     outOfLoop(): void;
     getStage(id: string): Stage | undefined;
     currentStage(): Stage | undefined;
+    /**
+     * Subscribe to loading events from the game.
+     * Events include stage context (stageName, stageIndex).
+     * @param callback Invoked for each loading event
+     * @returns Unsubscribe function
+     */
+    onLoading(callback: (event: GameLoadingEvent) => void): () => void;
+    /**
+     * Subscribe to the game event bus for stage loading and state events.
+     * Emits window events for cross-application communication.
+     */
+    private subscribeToEventBus;
 }
 
 type GameOptions<TGlobals extends BaseGlobals> = Array<ZylemGameConfig<Stage, any, TGlobals> | GameConfigLike | Stage | GameEntityLifeCycle | BaseNode>;
@@ -361,24 +360,60 @@ type GameOptions<TGlobals extends BaseGlobals> = Array<ZylemGameConfig<Stage, an
 declare class Game<TGlobals extends BaseGlobals> implements IGame<TGlobals> {
     private wrappedGame;
     options: GameOptions<TGlobals>;
-    update: UpdateFunction<ZylemGame<TGlobals>, TGlobals>;
-    setup: SetupFunction<ZylemGame<TGlobals>, TGlobals>;
-    destroy: DestroyFunction<ZylemGame<TGlobals>, TGlobals>;
+    private setupCallbacks;
+    private updateCallbacks;
+    private destroyCallbacks;
+    private pendingLoadingCallbacks;
+    private globalChangeCallbacks;
+    private globalChangesCallbacks;
+    private activeGlobalSubscriptions;
     refErrorMessage: string;
     constructor(options: GameOptions<TGlobals>);
+    onSetup(...callbacks: Array<SetupFunction<ZylemGame<TGlobals>, TGlobals>>): this;
+    onUpdate(...callbacks: Array<UpdateFunction<ZylemGame<TGlobals>, TGlobals>>): this;
+    onDestroy(...callbacks: Array<DestroyFunction<ZylemGame<TGlobals>, TGlobals>>): this;
     start(): Promise<this>;
     private load;
-    setOverrides(): void;
+    private setOverrides;
+    /**
+     * Subscribe to changes on a global value. Subscriptions are registered
+     * when the game starts and cleaned up when disposed.
+     * The callback receives the value and the current stage.
+     * @example game.onGlobalChange('score', (val, stage) => console.log(val));
+     */
+    onGlobalChange<T = unknown>(path: string, callback: (value: T, stage: Stage | null) => void): this;
+    /**
+     * Subscribe to changes on multiple global paths. Subscriptions are registered
+     * when the game starts and cleaned up when disposed.
+     * The callback receives the values and the current stage.
+     * @example game.onGlobalChanges(['score', 'lives'], ([score, lives], stage) => console.log(score, lives));
+     */
+    onGlobalChanges<T extends unknown[] = unknown[]>(paths: string[], callback: (values: T, stage: Stage | null) => void): this;
+    /**
+     * Register all stored global change callbacks.
+     * Called internally during start().
+     */
+    private registerGlobalSubscriptions;
+    /**
+     * Get the current stage wrapper.
+     */
+    getCurrentStage(): Stage | null;
     pause(): Promise<void>;
     resume(): Promise<void>;
     reset(): Promise<void>;
-    previousStage(): Promise<void>;
+    previousStage(): void;
     loadStageFromId(stageId: string): Promise<void>;
-    nextStage(): Promise<void>;
+    nextStage(): void;
     goToStage(): Promise<void>;
     end(): Promise<void>;
     dispose(): void;
-    onLoading(callback: (event: LoadingEvent) => void): void;
+    /**
+     * Subscribe to loading events from the game.
+     * Events include stage context (stageName, stageIndex).
+     * @param callback Invoked for each loading event
+     * @returns Unsubscribe function
+     */
+    onLoading(callback: (event: GameLoadingEvent) => void): () => void;
 }
 /**
  * create a new game

package/dist/core.d.ts

@@ -1,9 +1,10 @@
-export { V as Vect3, Z as ZylemGameConfig, c as createGame, a as globalChange, b as globalChanges, d as variableChange, e as variableChanges, v as vessel } from './core-C2mjetAd.js';
-import './entity-bQElAdpo.js';
+export { V as Vect3, Z as ZylemGameConfig, c as createGame, a as globalChange, b as globalChanges, d as variableChange, e as variableChanges, v as vessel } from './core-CZhozNRH.js';
+import './entity-COvRtFNG.js';
 import 'three';
 import '@dimforge/rapier3d-compat';
 import 'bitecs';
-import './camera-Dk-fOVZE.js';
-import 'three/addons/controls/OrbitControls.js';
+import './camera-CpbDr4-V.js';
 import 'three/examples/jsm/postprocessing/EffectComposer.js';
-import './stage-CrmY7V0i.js';
+import './entity-Bq_eNEDI.js';
+import './stage-types-CD21XoIU.js';
+import './entities-BAxfJOkk.js';