@zylem/game-lib 0.6.0 → 0.6.2

package/dist/entity-types-DAu8sGJH.d.ts

@@ -0,0 +1,26 @@
+import { Group } from 'three';
+import { RigidBody, Collider } from '@dimforge/rapier3d-compat';
+
+/**
+ * Base entity interface - shared across modules to prevent circular dependencies
+ */
+interface BaseEntityInterface {
+    uuid: string;
+    name: string;
+    eid: number;
+    group: Group | null | undefined;
+    body: RigidBody | null | undefined;
+    collider: Collider | null | undefined;
+}
+/**
+ * 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;
+}
+
+export type { BaseEntityInterface as B, GameEntityInterface as G };

package/dist/main.d.ts

@@ -1,14 +1,13 @@
-import { G as Game } from './core-CZhozNRH.js';
-export { V as Vect3, Z as ZylemGameConfig, c as createGame, g as gameConfig, a as globalChange, b as globalChanges, d as variableChange, e as variableChanges, v as vessel } from './core-CZhozNRH.js';
-export { a as StageOptions, c as createStage } from './stage-types-CD21XoIU.js';
-import { S as StageBlueprint } from './blueprints-BOCc3Wve.js';
-export { e as entitySpawner } from './blueprints-BOCc3Wve.js';
-export { P as PerspectiveType, a as Perspectives, c as camera } from './camera-CpbDr4-V.js';
-export { A as ACTOR_TYPE, B as BOX_TYPE, P as PLANE_TYPE, R as RECT_TYPE, d as SPHERE_TYPE, S as SPRITE_TYPE, T as TEXT_TYPE, e as ZONE_TYPE, Z as ZylemBox, c as actor, b as box, p as plane, r as rect, s as sphere, a as sprite, t as text, z as zone } from './entities-BAxfJOkk.js';
-import { U as UpdateContext, B as BehaviorCallbackType, G as GameEntity } from './entity-COvRtFNG.js';
-export { a as Behavior, L as LoadingEvent, S as SetupContext } from './entity-COvRtFNG.js';
-export { boundary2d, ricochet2DCollision, ricochet2DInBounds } from './behaviors.js';
-import { M as MoveableEntity } from './moveable-B_vyA6cw.js';
+import { G as Game } from './core-bO8TzV7u.js';
+export { V as Vect3, Z as ZylemGameConfig, c as createGame, g as gameConfig, a as globalChange, b as globalChanges, d as variableChange, e as variableChanges, v as vessel } from './core-bO8TzV7u.js';
+export { a as StageOptions, d as createDisk, c as createStage } from './stage-types-Bd-KtcYT.js';
+import { S as StageBlueprint } from './blueprints-Cq3Ko6_G.js';
+export { e as entitySpawner } from './blueprints-Cq3Ko6_G.js';
+export { P as PerspectiveType, d as Perspectives, c as createCamera } from './camera-CeJPAgGg.js';
+export { A as ACTOR_TYPE, B as BOX_TYPE, P as PLANE_TYPE, R as RECT_TYPE, a as SPHERE_TYPE, S as SPRITE_TYPE, T as TEXT_TYPE, g as ZONE_TYPE, e as ZylemBox, o as createActor, j as createBox, m as createPlane, q as createRect, k as createSphere, l as createSprite, p as createText, n as createZone } from './entities-DvByhMGU.js';
+import { G as GameEntity, g as GameEntityOptions } from './world-C8tQ7Plj.js';
+export { q as BehaviorDescriptor, s as BehaviorHandle, r as BehaviorRef, e as BehaviorSystem, f as BehaviorSystemFactory, t as DefineBehaviorConfig, o as EntityConfigPayload, k as EntityEvents, E as EventEmitterDelegate, j as GameEvents, l as GameLoadingPayload, L as LoadingEvent, a as SetupContext, n as StageConfigPayload, h as StageEvents, m as StateDispatchPayload, b as UpdateContext, i as ZylemEvents, Z as ZylemShaderObject, p as defineBehavior, z as zylemEventBus } from './world-C8tQ7Plj.js';
+export { Behavior, BoundaryRicochetCoordinator, MovementSequence2DBehavior, MovementSequence2DCurrentStep, MovementSequence2DEvent, MovementSequence2DFSM, MovementSequence2DHandle, MovementSequence2DMovement, MovementSequence2DOptions, MovementSequence2DProgress, MovementSequence2DState, MovementSequence2DStep, PhysicsBodyComponent, PhysicsStepBehavior, PhysicsSyncBehavior, PlayerInput, Ricochet2DBehavior, Ricochet2DCollisionContext, Ricochet2DEvent, Ricochet2DFSM, Ricochet2DHandle, Ricochet2DOptions, Ricochet2DResult, Ricochet2DState, ScreenWrapBehavior, ScreenWrapEvent, ScreenWrapFSM, ScreenWrapOptions, ScreenWrapState, ThrusterBehavior, ThrusterBehaviorOptions, ThrusterEntity, ThrusterEvent, ThrusterFSM, ThrusterFSMContext, ThrusterInputComponent, ThrusterMovementBehavior, ThrusterMovementComponent, ThrusterState, ThrusterStateComponent, TransformComponent, WorldBoundary2DBehavior, WorldBoundary2DBounds, WorldBoundary2DEvent, WorldBoundary2DFSM, WorldBoundary2DHandle, WorldBoundary2DHit, WorldBoundary2DHits, WorldBoundary2DOptions, WorldBoundary2DPosition, WorldBoundary2DState, computeWorldBoundary2DHits, createPhysicsBodyComponent, createThrusterInputComponent, createThrusterMovementComponent, createThrusterStateComponent, createTransformComponent, hasAnyWorldBoundary2DHit, useBehavior } from './behaviors.js';
 export { m as makeMoveable, b as move, a as moveable, r as resetVelocity } from './moveable-B_vyA6cw.js';
 export { m as makeRotatable, a as makeTransformable, r as rotatable, b as rotateInDirection } from './transformable-CUhvyuYO.js';
 export { Howl } from 'howler';
@@ -18,8 +17,11 @@ import * as RAPIER from '@dimforge/rapier3d-compat';
 export { RAPIER };
 export { S as StageEntity } from './entity-Bq_eNEDI.js';
 import 'bitecs';
+import './entity-types-DAu8sGJH.js';
 import '@sinclair/typebox';
 import 'three/examples/jsm/postprocessing/EffectComposer.js';
+import 'mitt';
+import 'typescript-fsm';
 
 declare const stageState: {
     previous: StageBlueprint | null;
@@ -37,8 +39,8 @@ declare const StageManager: {
             data?: {
                 [x: string]: any;
             } | undefined;
-            id: string;
             type: string;
+            id: string;
         }[];
     }>;
     registerStaticStage(id: string, blueprint: StageBlueprint): void;
@@ -50,26 +52,38 @@ declare const StageManager: {
     preloadNext(stageId: string, loadStaticStage?: (id: string) => Promise<StageBlueprint>): Promise<void>;
 };
 
-interface MovementSequence2DStep {
-    name: string;
-    moveX?: number;
-    moveY?: number;
-    timeInSeconds: number;
-}
-interface MovementSequence2DOptions {
-    sequence: MovementSequence2DStep[];
-    loop?: boolean;
-}
-type MovementSequence2DCallback = (current: MovementSequence2DStep, index: number, ctx: UpdateContext<MoveableEntity>) => void;
 /**
- * Behavior that sequences 2D movements over time.
- * Each step sets linear velocity via `moveXY` for a duration, then advances.
- * Defaults to looping when the end is reached.
+ * Factory interface for generating entity copies
  */
-declare function movementSequence2D(opts: MovementSequence2DOptions, onStep?: MovementSequence2DCallback): {
-    type: BehaviorCallbackType;
-    handler: (ctx: UpdateContext<MoveableEntity>) => void;
-};
+interface TemplateFactory<E extends GameEntity<O>, O extends GameEntityOptions = GameEntityOptions> {
+    /** The template entity used for cloning */
+    readonly template: E;
+    /**
+     * Generate multiple copies of the template entity
+     * @param count Number of copies to generate
+     * @returns Array of new entity instances
+     */
+    generate(count: number): E[];
+}
+/**
+ * Create an entity factory from a template entity.
+ *
+ * @param template The entity to use as a template for cloning
+ * @returns Factory object with generate() method
+ *
+ * @example
+ * ```typescript
+ * const asteroidTemplate = createSprite({ images: [{ name: 'asteroid', file: asteroidImg }] });
+ * const asteroidFactory = createEntityFactory(asteroidTemplate);
+ * const asteroids = asteroidFactory.generate(10);
+ *
+ * asteroids.forEach((asteroid, i) => {
+ *     asteroid.setPosition(Math.random() * 20 - 10, Math.random() * 15 - 7.5, 0);
+ *     stage.add(asteroid);
+ * });
+ * ```
+ */
+declare function createEntityFactory<E extends GameEntity<O>, O extends GameEntityOptions = GameEntityOptions>(template: E): TemplateFactory<E, O>;
 
 declare function destroy(entity: any, globals?: any): void;
 
@@ -193,6 +207,10 @@ declare class ZylemGameElement extends HTMLElement {
     private _state;
     private container;
     constructor();
+    /**
+     * Focus the game container for keyboard input
+     */
+    focus(): void;
     set game(game: Game<any>);
     get game(): Game<any> | null;
     set state(value: ZylemGameState);
@@ -208,4 +226,26 @@ declare class ZylemGameElement extends HTMLElement {
     disconnectedCallback(): void;
 }
 
-export { type DebugTools, Game, StageBlueprint, StageManager, UpdateContext, ZylemGameElement, type ZylemGameState, clearGlobalSubscriptions, createGlobal, createVariable, debugState, destroy, getGlobal, getGlobals, getVariable, movementSequence2D, onGlobalChange, onGlobalChanges, onVariableChange, onVariableChanges, pingPongBeep, ricochetSound, setDebugTool, setGlobal, setPaused, setVariable, stageState };
+declare const fireShader: {
+    vertex: string;
+    fragment: string;
+};
+
+declare const starShader: {
+    vertex: string;
+    fragment: string;
+};
+
+declare const standardShader: {
+    vertex: string;
+    fragment: string;
+};
+
+declare const debugShader: {
+    vertex: string;
+    fragment: string;
+};
+
+declare const objectVertexShader = "\nuniform vec2 uvScale;\nvarying vec2 vUv;\n\nvoid main() {\n\tvUv = uv;\n\tvec4 mvPosition = modelViewMatrix * vec4( position, 1.0 );\n\tgl_Position = projectionMatrix * mvPosition;\n}\n";
+
+export { type DebugTools, Game, StageBlueprint, StageManager, type TemplateFactory, ZylemGameElement, type ZylemGameState, clearGlobalSubscriptions, createEntityFactory, createGlobal, createVariable, debugShader, debugState, destroy, fireShader, getGlobal, getGlobals, getVariable, objectVertexShader, onGlobalChange, onGlobalChanges, onVariableChange, onVariableChanges, pingPongBeep, ricochetSound, setDebugTool, setGlobal, setPaused, setVariable, stageState, standardShader, starShader };