@zylem/game-lib 0.6.0 → 0.6.2

package/dist/{stage-types-CD21XoIU.d.ts → stage-types-Bd-KtcYT.d.ts}

@@ -1,15 +1,17 @@
-import { b as SetupFunction, G as GameEntity, c as UpdateFunction, D as DestroyFunction, S as SetupContext, U as UpdateContext, d as DestroyContext, e as BaseNode, L as LoadingEvent } from './entity-COvRtFNG.js';
+import { S as SetupFunction, Z as ZylemShaderObject, G as GameEntity, U as UpdateFunction, D as DestroyFunction, a as SetupContext, b as UpdateContext, c as DestroyContext, d as ZylemWorld, B as BaseNode, L as LoadingEvent, e as BehaviorSystem, f as BehaviorSystemFactory, g as GameEntityOptions, h as StageEvents } from './world-C8tQ7Plj.js';
 import * as bitecs from 'bitecs';
 import { defineSystem, IWorld } from 'bitecs';
-import { Scene, Color, Object3D, Vector3, Group } from 'three';
-import { f as ZylemWorld, S as SPRITE_TYPE, g as ZylemSprite, d as SPHERE_TYPE, h as ZylemSphere, R as RECT_TYPE, i as ZylemRect, T as TEXT_TYPE, j as ZylemText, B as BOX_TYPE, Z as ZylemBox, P as PLANE_TYPE, k as ZylemPlane, e as ZONE_TYPE, l as ZylemZone, A as ACTOR_TYPE, m as ZylemActor } from './entities-BAxfJOkk.js';
+import { Scene, Color, Object3D, Vector3 } from 'three';
 import { E as Entity, L as LifecycleFunction, S as StageEntity } from './entity-Bq_eNEDI.js';
-import { Z as ZylemCamera, C as CameraDebugDelegate, b as CameraDebugState, d as CameraWrapper } from './camera-CpbDr4-V.js';
-import RAPIER__default, { RigidBody, Collider } from '@dimforge/rapier3d-compat';
+import { Z as ZylemCamera, C as CameraDebugDelegate, a as CameraDebugState, b as CameraWrapper } from './camera-CeJPAgGg.js';
+import { G as GameEntityInterface, B as BaseEntityInterface } from './entity-types-DAu8sGJH.js';
+import RAPIER__default from '@dimforge/rapier3d-compat';
+import { S as SPRITE_TYPE, Z as ZylemSprite, a as SPHERE_TYPE, b as ZylemSphere, R as RECT_TYPE, c as ZylemRect, T as TEXT_TYPE, d as ZylemText, B as BOX_TYPE, e as ZylemBox, P as PLANE_TYPE, f as ZylemPlane, g as ZONE_TYPE, h as ZylemZone, A as ACTOR_TYPE, i as ZylemActor } from './entities-DvByhMGU.js';
 
 interface SceneState {
     backgroundColor: Color | string;
     backgroundImage: string | null;
+    backgroundShader?: ZylemShaderObject | null;
 }
 declare class ZylemScene implements Entity<ZylemScene> {
     type: string;
@@ -22,7 +24,13 @@ declare class ZylemScene implements Entity<ZylemScene> {
     _destroy?: ((globals?: any) => void) | undefined;
     name?: string | undefined;
     tag?: Set<string> | undefined;
+    private skyboxMaterial;
     constructor(id: string, camera: ZylemCamera, state: SceneState);
+    /**
+     * Create a large inverted box with the shader for skybox effect
+     * Uses the pos.xyww trick to ensure skybox is always at maximum depth
+     */
+    private setupBackgroundShader;
     setup(): void;
     destroy(): void;
     /**
@@ -45,32 +53,19 @@ declare class ZylemScene implements Entity<ZylemScene> {
      * Add game entity to scene
      */
     addEntity(entity: GameEntity<any>): void;
+    /**
+     * Add an entity's group or mesh to the scene (for late-loaded models).
+     * Uses entity's current body position if physics is active.
+     */
+    addEntityGroup(entity: GameEntity<any>): void;
     /**
      * Add debug helpers to scene
      */
     debugScene(): void;
-}
-
-/**
- * Base entity interface - shared across modules to prevent circular dependencies
- */
-interface BaseEntityInterface {
-    uuid: string;
-    name: string;
-    eid: number;
-    group: Group | null;
-    body: RigidBody | null;
-    collider: Collider | null;
-}
-/**
- * Game entity interface - minimal interface to break circular dependencies
- */
-interface GameEntityInterface extends BaseEntityInterface {
-    type: string;
-    isStatic: boolean;
-    setPosition(x: number, y: number, z: number): void;
-    setRotation(x: number, y: number, z: number): void;
-    setScale(x: number, y: number, z: number): void;
+    /**
+     * Update skybox shader uniforms
+     */
+    updateSkybox(delta: number): void;
 }
 
 /**
@@ -118,6 +113,8 @@ declare class StageDebugDelegate {
     private debugCursor;
     private debugLines;
     constructor(stage: ZylemStage, options?: StageDebugDelegateOptions);
+    private initDebugVisuals;
+    private disposeDebugVisuals;
     update(): void;
     dispose(): void;
     private handleActionOnHit;
@@ -139,6 +136,7 @@ interface ZylemStageConfig {
     inputs: Record<string, string[]>;
     backgroundColor: Color | string;
     backgroundImage: string | null;
+    backgroundShader: any | null;
     gravity: Vector3;
     variables: Record<string, any>;
     stageRef?: Stage;
@@ -178,6 +176,8 @@ declare class ZylemStage extends LifeCycleBase<ZylemStage> {
     ecs: bitecs.IWorld;
     testSystem: any;
     transformSystem: ReturnType<typeof createTransformSystem> | null;
+    private behaviorSystems;
+    private registeredSystemKeys;
     debugDelegate: StageDebugDelegate | null;
     cameraDebugDelegate: StageCameraDebugDelegate | null;
     private debugStateUnsubscribe;
@@ -187,6 +187,7 @@ declare class ZylemStage extends LifeCycleBase<ZylemStage> {
     cameraRef?: ZylemCamera | null;
     private cameraDelegate;
     private loadingDelegate;
+    private entityModelDelegate;
     /**
      * Create a new stage.
      * @param options Stage options: partial config, camera, and initial entities or factories
@@ -238,6 +239,12 @@ declare class ZylemStage extends LifeCycleBase<ZylemStage> {
         replayExisting?: boolean;
     }): () => void;
     onLoading(callback: (event: LoadingEvent) => void): () => void;
+    /**
+     * Register an ECS behavior system to run each frame.
+     * @param systemOrFactory A BehaviorSystem instance or factory function
+     * @returns this for chaining
+     */
+    registerSystem(systemOrFactory: BehaviorSystem | BehaviorSystemFactory): this;
     /**
      * Remove an entity and its resources by its UUID.
      * @returns true if removed, false if not found or stage not ready
@@ -257,6 +264,20 @@ declare class ZylemStage extends LifeCycleBase<ZylemStage> {
     enqueue(...items: StageEntityInput[]): void;
 }
 
+type ZylemDiskOptions = GameEntityOptions & {
+    innerRadius?: number;
+    outerRadius?: number;
+    thetaSegments?: number;
+};
+declare const DISK_TYPE: unique symbol;
+declare class ZylemDisk extends GameEntity<ZylemDiskOptions> {
+    static type: symbol;
+    constructor(options?: ZylemDiskOptions);
+    buildInfo(): Record<string, any>;
+}
+type DiskOptions = BaseNode | Partial<ZylemDiskOptions>;
+declare function createDisk(...args: Array<DiskOptions>): ZylemDisk;
+
 /**
  * Maps entity type symbols to their class types.
  * Used by getEntityByName to infer return types.
@@ -270,6 +291,7 @@ interface EntityTypeMap {
     [PLANE_TYPE]: ZylemPlane;
     [ZONE_TYPE]: ZylemZone;
     [ACTOR_TYPE]: ZylemActor;
+    [DISK_TYPE]: ZylemDisk;
 }
 
 type NodeLike = {
@@ -285,6 +307,7 @@ declare class Stage {
     private updateCallbacks;
     private destroyCallbacks;
     private pendingLoadingCallbacks;
+    private eventDelegate;
     constructor(options: StageOptions);
     load(id: string, camera?: ZylemCamera | CameraWrapper | null): Promise<void>;
     private applyLifecycleCallbacks;
@@ -305,6 +328,20 @@ declare class Stage {
      * @example stage.getEntityByName('scoreText', TEXT_TYPE)
      */
     getEntityByName<T extends symbol | void = void>(name: string, type?: T): T extends keyof EntityTypeMap ? EntityTypeMap[T] | undefined : BaseNode | undefined;
+    /**
+     * Dispatch an event from the stage.
+     * Events are emitted both locally and to the global event bus.
+     */
+    dispatch<K extends keyof StageEvents>(event: K, payload: StageEvents[K]): void;
+    /**
+     * Listen for events on this stage instance.
+     * @returns Unsubscribe function
+     */
+    listen<K extends keyof StageEvents>(event: K, handler: (payload: StageEvents[K]) => void): () => void;
+    /**
+     * Clean up stage resources including event subscriptions.
+     */
+    dispose(): void;
 }
 /**
  * Create a stage with optional camera
@@ -335,4 +372,4 @@ interface StageInterface {
     state: StageStateInterface;
 }
 
-export { type StageStateInterface as S, type StageOptions as a, Stage as b, createStage as c, type StageInterface as d };
+export { type StageStateInterface as S, type StageOptions as a, Stage as b, createStage as c, createDisk as d, type StageInterface as e };

package/dist/stage.d.ts

@@ -1,14 +1,16 @@
-import { S as StageStateInterface } from './stage-types-CD21XoIU.js';
-export { a as StageOptions, c as createStage } from './stage-types-CD21XoIU.js';
-export { S as StageBlueprint, e as entitySpawner } from './blueprints-BOCc3Wve.js';
-import './entity-COvRtFNG.js';
+import { S as StageStateInterface } from './stage-types-Bd-KtcYT.js';
+export { a as StageOptions, c as createStage } from './stage-types-Bd-KtcYT.js';
+export { S as StageBlueprint, e as entitySpawner } from './blueprints-Cq3Ko6_G.js';
+import './world-C8tQ7Plj.js';
 import 'three';
 import '@dimforge/rapier3d-compat';
-import 'bitecs';
-import './entities-BAxfJOkk.js';
 import './entity-Bq_eNEDI.js';
-import './camera-CpbDr4-V.js';
+import 'bitecs';
+import 'mitt';
+import './camera-CeJPAgGg.js';
 import 'three/examples/jsm/postprocessing/EffectComposer.js';
+import './entity-types-DAu8sGJH.js';
+import './entities-DvByhMGU.js';
 import '@sinclair/typebox';
 
 /**