@zylem/game-lib 0.8.0 → 0.8.3

package/dist/debug.d.ts

@@ -1,12 +1,12 @@
-export { D as DebugTools, d as debugState, s as setDebugTool, a as setPaused, b as setSelectedEntity } from './debug-state-BPT6jEog.js';
+export { k as DebugEntityResolver, D as DebugTools, d as debugState, i as getHoveredEntity, h as getHoveredEntityId, e as getSelectedEntity, g as getSelectedEntityId, r as registerDebugEntityResolver, j as resolveDebugEntity, s as setDebugTool, f as setHoveredEntityId, a as setPaused, b as setSelectedEntity, c as setSelectedEntityId } from './debug-state-Dp9CQQZ4.js';
 import { Object3D, Vector3 } from 'three';
-import { G as GameEntity } from './entity-BdSI8CL3.js';
+import { G as GameEntity } from './entity-BGEq1yfC.js';
 import { WebGPURenderer } from 'three/webgpu';
 import '@zylem/behaviors/core';
-import './vector-CiSHbivc.js';
-import './material-9vJ6SZaI.js';
-import './collision-builder-jF-toPIl.js';
-import './base-node-life-cycle-D2NuN1VB.js';
+import './vector-DN6zlPoE.js';
+import './material-DbSuZBbP.js';
+import './collision-builder-B_tm8OVy.js';
+import './base-node-life-cycle-BK9xebT9.js';
 import './stage-transition-CmGpV4tc.js';
 import './events.js';
 import 'mitt';
@@ -44,6 +44,10 @@ interface ObjectBounds {
 }
 
 interface EntityThumbnailResult {
+    /**
+     * Preview image URL. Blob URL when the payload worker is available
+     * (encoded off-thread), PNG data URL on the synchronous fallback path.
+     */
     dataUrl: string;
     bounds: Pick<ObjectBounds, 'width' | 'height' | 'depth'>;
 }
@@ -59,15 +63,30 @@ declare class EntityThumbnailCache {
     private inFlight;
     private renderer;
     private size;
-    constructor(size?: number);
+    private maxEntries;
+    private queue;
+    private activeRenders;
+    constructor(size?: number, maxEntries?: number);
     setRenderer(renderer: WebGPURenderer | null): void;
     get(uuid: string): EntityThumbnailCacheEntry | null;
     invalidate(uuid: string): void;
     clear(): void;
+    /** Number of thumbnails currently cached. */
+    get cacheSize(): number;
+    /** Entities waiting for a render slot. */
+    get pendingCount(): number;
     /**
-     * Return a cached thumbnail or generate one asynchronously.
+     * Return a cached thumbnail, or schedule one. Renders are throttled to
+     * {@link MAX_CONCURRENT_RENDERS} at a time behind a bounded queue, so a
+     * burst of spawns cannot flood the renderer with pixel readbacks.
      */
     ensure(uuid: string, object: Object3D | null | undefined): Promise<EntityThumbnailCacheEntry | null>;
+    /** Start queued renders until the concurrency budget is spent. */
+    private drainQueue;
+    /** Move an entry to the end of the Map so it is evicted last. */
+    private touch;
+    /** Evict least-recently-used entries down to the cap. */
+    private evictOverflow;
     private render;
 }
 /** Shared cache used by the running game to feed editor entity payloads. */

package/dist/debug.js

@@ -1 +1 @@
-import"./chunk-DFLI7ICU.js";import{a as e,b as f}from"./chunk-COM6HJ2L.js";import{c as g,d as h}from"./chunk-VS2D4B3W.js";import{a,c as b,e as c,f as d}from"./chunk-JQKS42G4.js";export{e as EntityThumbnailCache,a as debugState,f as entityThumbnailCache,h as focusEntity,g as registerEntityFocusContext,c as setDebugTool,b as setPaused,d as setSelectedEntity};
+import"./chunk-DFLI7ICU.js";import{a as m,b as n}from"./chunk-2VSVOPQN.js";import"./chunk-C5NEGC3S.js";import{a as o,b as p}from"./chunk-LKFF6XJC.js";import{a,b,c,e as d,g as e,h as f,i as g,j as h,k as i,m as j,n as k,o as l}from"./chunk-W5SXED5T.js";export{m as EntityThumbnailCache,a as debugState,n as entityThumbnailCache,p as focusEntity,k as getHoveredEntity,h as getHoveredEntityId,j as getSelectedEntity,f as getSelectedEntityId,b as registerDebugEntityResolver,o as registerEntityFocusContext,c as resolveDebugEntity,e as setDebugTool,i as setHoveredEntityId,d as setPaused,l as setSelectedEntity,g as setSelectedEntityId};

package/dist/{default-controls-0-vCnli7.d.ts → default-controls-CAKJ5zlo.d.ts}

@@ -1,5 +1,5 @@
-import { b as InputPlayer } from './base-node-life-cycle-D2NuN1VB.js';
-import { d as VirtualTouchButtonSlot, e as VirtualTouchConfig, G as GameInputConfig } from './game-interfaces-mchNYSZE.js';
+import { b as InputPlayer } from './base-node-life-cycle-BK9xebT9.js';
+import { d as VirtualTouchButtonSlot, e as VirtualTouchConfig, G as GameInputConfig } from './game-interfaces-vF5sRi1n.js';
 
 /**
  * Color tokens consumed by the SVG factories in `svg-assets.ts` and the

package/dist/{entity-DZbFQ1Wg.d.ts → entity-B9yZeBm4.d.ts}

@@ -1,5 +1,5 @@
 import { Group, Mesh } from 'three';
-import { l as SimulationBody } from './vector-CiSHbivc.js';
+import { l as SimulationBody } from './vector-DN6zlPoE.js';
 
 type LifecycleFunction<T> = (params?: any) => void;
 interface Entity<T = any> {
@@ -20,6 +20,12 @@ interface StageEntity extends Entity {
     instanceId: number;
     isInstanced?: boolean;
     isBundled?: boolean;
+    /**
+     * When true, `syncRenderPoses` leaves the entity's Three.js transform alone.
+     * Used for camera-parented viewmodels so physics pose sync cannot overwrite
+     * the local offset.
+     */
+    skipRenderPoseSync?: boolean;
     controlledRotation: boolean;
     name: string;
     markedForRemoval: boolean;

package/dist/{entity-BdSI8CL3.d.ts → entity-BGEq1yfC.d.ts}

@@ -1,9 +1,9 @@
 import { BufferGeometry, Material, Mesh, Group, Vector3, Color, ShaderMaterial } from 'three';
 import { SimulationColliderDefinition, TransformState, SimulationBodyDefinition, MoveableEntity, BehaviorRuntime, Vector, BehaviorDescriptor, BehaviorHandle, BehaviorRef } from '@zylem/behaviors/core';
-import { c as Vec3, e as Vec3Input, b as Vec2Input, l as SimulationBody } from './vector-CiSHbivc.js';
-import { M as MaterialBuilder, e as MaterialOptions } from './material-9vJ6SZaI.js';
-import { C as CollisionBuilder, a as CollisionOptions } from './collision-builder-jF-toPIl.js';
-import { a as SetupContext, U as UpdateContext, D as DestroyContext, h as SetupFunction, i as LoadedFunction, g as UpdateFunction, j as DestroyFunction, C as CleanupFunction, k as LoadedContext, l as CleanupContext } from './base-node-life-cycle-D2NuN1VB.js';
+import { c as Vec3, e as Vec3Input, b as Vec2Input, l as SimulationBody } from './vector-DN6zlPoE.js';
+import { M as MaterialBuilder, e as MaterialOptions } from './material-DbSuZBbP.js';
+import { C as CollisionBuilder, L as LockAxesInput, a as CollisionOptions } from './collision-builder-B_tm8OVy.js';
+import { a as SetupContext, U as UpdateContext, D as DestroyContext, h as SetupFunction, i as LoadedFunction, g as UpdateFunction, j as DestroyFunction, C as CleanupFunction, k as LoadedContext, l as CleanupContext } from './base-node-life-cycle-BK9xebT9.js';
 import { EventEmitterDelegate, EntityEvents } from './events.js';
 
 interface NodeInterface {
@@ -252,6 +252,12 @@ interface BaseCollisionOptions {
     collisionType?: string;
     /** Allowed collision types for filtering */
     collisionFilter?: string[];
+    /** Gravity scale applied at body spawn (no live setter FFI; default 1). */
+    gravityScale?: number;
+    /** Lock rotation axes at body spawn: `true` for all, or per-axis tuple. */
+    lockRotations?: LockAxesInput;
+    /** Lock translation axes at body spawn: `true` for all, or per-axis tuple. */
+    lockTranslations?: LockAxesInput;
 }
 interface BoxCollisionOptions extends BaseCollisionOptions {
     /** Box dimensions (default: 1x1x1) */
@@ -402,6 +408,17 @@ type GameEntityOptions = {
     color?: Color;
     size?: Vec3Input;
     position?: Vec3Input;
+    /**
+     * Spawn visibility behavior:
+     * - `undefined` (default): hidden while `spawnEntity` runs, revealed once
+     *   the spawn finalizes — even if no position was assigned.
+     * - `true` (strict): stays hidden until the first `setPosition`/`setPose`,
+     *   for spawner patterns that place the entity frames after spawn.
+     * - `false`: never hidden during spawn.
+     */
+    hideUntilPositioned?: boolean;
+    /** Explicit render visibility. When false, entity stays hidden until {@link GameEntity.reveal}. */
+    visible?: boolean;
     /** Render path: `environment` (bundle), `pack` (instanced), or `none` (default). */
     category?: RenderCategory;
     runtime?: RuntimeEntityOptions;
@@ -482,6 +499,14 @@ declare class GameEntity<O extends GameEntityOptions> extends BaseNode<O> implem
     private trackAddedComponents;
     private trackedComponents;
     transformStore: TransformState;
+    /** Hide render target until spawn placement is confirmed. */
+    _spawnPlacementPending: boolean;
+    /** Author passed `position` in create options. */
+    _spawnPositionExplicit: boolean;
+    /** setPosition / setPose assigned a spawn placement during this spawn. */
+    _spawnPlacementReady: boolean;
+    /** True while {@link StageEntityDelegate.spawnEntity} is running for this entity. */
+    _spawnInProgress: boolean;
     moveX: (delta: number) => void;
     moveY: (delta: number) => void;
     moveZ: (delta: number) => void;
@@ -514,6 +539,9 @@ declare class GameEntity<O extends GameEntityOptions> extends BaseNode<O> implem
     setRotation: (x: number, y: number, z: number) => void;
     getRotation: () => any;
     constructor();
+    private wrapSpawnPlacementMutators;
+    /** Make the entity visible, clearing spawn placement pending state. */
+    reveal(): void;
     /**
      * Read the entity's pose from the wasm simulation. Returns `null` when
      * the entity has not been spawned into the runtime yet.

package/dist/{entity-type-map-Bd69SpAS.d.ts → entity-type-map-CW6RHQkx.d.ts}

@@ -1,10 +1,10 @@
 import { Vector3, Sprite, Color, Object3D, ColorRepresentation, Light, Fog, FogExp2, Scene, Raycaster } from 'three';
-import { G as GameEntity, a as GameEntityOptions, B as BaseNode } from './entity-BdSI8CL3.js';
-import { d as Vec3Components, e as Vec3Input, b as Vec2Input } from './vector-CiSHbivc.js';
-import { U as UpdateContext, a as SetupContext, D as DestroyContext, l as CleanupContext } from './base-node-life-cycle-D2NuN1VB.js';
-import { T as TexturePath, e as MaterialOptions } from './material-9vJ6SZaI.js';
+import { G as GameEntity, a as GameEntityOptions, B as BaseNode } from './entity-BGEq1yfC.js';
+import { d as Vec3Components, e as Vec3Input, b as Vec2Input } from './vector-DN6zlPoE.js';
+import { U as UpdateContext, a as SetupContext, D as DestroyContext, l as CleanupContext } from './base-node-life-cycle-BK9xebT9.js';
+import { T as TexturePath, e as MaterialOptions } from './material-DbSuZBbP.js';
 import { Simulation } from '@zylem/behaviors/core';
-import { E as Entity } from './entity-DZbFQ1Wg.js';
+import { E as Entity } from './entity-B9yZeBm4.js';
 import { ParticleEmitterBehaviorOptions, ParticleEffectDefinition, ParticleEmitterHandle } from '@zylem/behaviors/particle-emitter';
 import { Line2 } from 'three/addons/lines/webgpu/Line2.js';
 

package/dist/entity.d.ts

@@ -1,16 +1,16 @@
-export { A as ACTOR_TYPE, $ as AmbientLightOptions, B as BOX_TYPE, z as CONE_TYPE, J as CYLINDER_TYPE, C as CollisionShapeType, D as DISK_TYPE, a1 as DirectionalLightOptions, aj as EntityForType, ai as EntityTypeMap, a7 as FOG_TYPE, a0 as HemisphereLightOptions, Y as LIGHT_TYPE, aa as LINE_TYPE, a4 as LightShadowOptions, ad as LinePickResult, n as OnEnterParams, o as OnExitParams, O as OnHeldParams, U as PARTICLE_SYSTEM_TYPE, M as PILL_TYPE, P as PLANE_TYPE, G as PYRAMID_TYPE, a2 as PointLightOptions, R as RECT_TYPE, S as SPHERE_TYPE, f as SPRITE_TYPE, a3 as SpotLightOptions, h as SpriteAnimation, g as SpriteImage, T as TEXT_TYPE, m as ZONE_TYPE, q as ZylemActor, Z as ZylemBox, y as ZylemCone, I as ZylemCylinder, w as ZylemDisk, a6 as ZylemFog, ag as ZylemFogHeightOptions, ah as ZylemFogNoiseOptions, ae as ZylemFogOptions, af as ZylemFogType, X as ZylemLight, _ as ZylemLightOptions, a9 as ZylemLine, ac as ZylemLineOptions, Q as ZylemParticleSystem, V as ZylemParticleSystemOptions, L as ZylemPill, j as ZylemPlane, F as ZylemPyramid, u as ZylemRect, b as ZylemSphere, e as ZylemSprite, s as ZylemText, l as ZylemZone, p as createActor, c as createBox, x as createCone, H as createCylinder, v as createDisk, a5 as createFog, W as createLight, a8 as createLine, N as createParticleSystem, K as createPill, i as createPlane, E as createPyramid, t as createRect, a as createSphere, d as createSprite, r as createText, k as createZone, ab as pickZylemLine } from './entity-type-map-Bd69SpAS.js';
-import { G as GameEntity, a as GameEntityOptions, E as EntityBuilder, D as EntityMeshBuilder, F as EntityCollisionBuilder, B as BaseNode } from './entity-BdSI8CL3.js';
-export { C as CollisionComponent, b as boxCollision, d as coneCollision, c as create, e as cylinderCollision, f as pillCollision, g as planeCollision, p as pyramidCollision, s as sphereCollision, z as zoneCollision } from './entity-BdSI8CL3.js';
+export { A as ACTOR_TYPE, $ as AmbientLightOptions, B as BOX_TYPE, z as CONE_TYPE, J as CYLINDER_TYPE, C as CollisionShapeType, D as DISK_TYPE, a1 as DirectionalLightOptions, aj as EntityForType, ai as EntityTypeMap, a7 as FOG_TYPE, a0 as HemisphereLightOptions, Y as LIGHT_TYPE, aa as LINE_TYPE, a4 as LightShadowOptions, ad as LinePickResult, n as OnEnterParams, o as OnExitParams, O as OnHeldParams, U as PARTICLE_SYSTEM_TYPE, M as PILL_TYPE, P as PLANE_TYPE, G as PYRAMID_TYPE, a2 as PointLightOptions, R as RECT_TYPE, S as SPHERE_TYPE, f as SPRITE_TYPE, a3 as SpotLightOptions, h as SpriteAnimation, g as SpriteImage, T as TEXT_TYPE, m as ZONE_TYPE, q as ZylemActor, Z as ZylemBox, y as ZylemCone, I as ZylemCylinder, w as ZylemDisk, a6 as ZylemFog, ag as ZylemFogHeightOptions, ah as ZylemFogNoiseOptions, ae as ZylemFogOptions, af as ZylemFogType, X as ZylemLight, _ as ZylemLightOptions, a9 as ZylemLine, ac as ZylemLineOptions, Q as ZylemParticleSystem, V as ZylemParticleSystemOptions, L as ZylemPill, j as ZylemPlane, F as ZylemPyramid, u as ZylemRect, b as ZylemSphere, e as ZylemSprite, s as ZylemText, l as ZylemZone, p as createActor, c as createBox, x as createCone, H as createCylinder, v as createDisk, a5 as createFog, W as createLight, a8 as createLine, N as createParticleSystem, K as createPill, i as createPlane, E as createPyramid, t as createRect, a as createSphere, d as createSprite, r as createText, k as createZone, ab as pickZylemLine } from './entity-type-map-CW6RHQkx.js';
+import { G as GameEntity, a as GameEntityOptions, E as EntityBuilder, D as EntityMeshBuilder, F as EntityCollisionBuilder, B as BaseNode } from './entity-BGEq1yfC.js';
+export { C as CollisionComponent, b as boxCollision, d as coneCollision, c as create, e as cylinderCollision, f as pillCollision, g as planeCollision, p as pyramidCollision, s as sphereCollision, z as zoneCollision } from './entity-BGEq1yfC.js';
 import { Color, Mesh } from 'three';
-import { b as Vec2Input, e as Vec3Input } from './vector-CiSHbivc.js';
-import { e as MaterialOptions } from './material-9vJ6SZaI.js';
-import './base-node-life-cycle-D2NuN1VB.js';
+import { b as Vec2Input, e as Vec3Input } from './vector-DN6zlPoE.js';
+import { e as MaterialOptions } from './material-DbSuZBbP.js';
+import './base-node-life-cycle-BK9xebT9.js';
 import './stage-transition-CmGpV4tc.js';
 import '@zylem/behaviors/core';
-import './entity-DZbFQ1Wg.js';
+import './entity-B9yZeBm4.js';
 import '@zylem/behaviors/particle-emitter';
 import 'three/addons/lines/webgpu/Line2.js';
-import './collision-builder-jF-toPIl.js';
+import './collision-builder-B_tm8OVy.js';
 import './events.js';
 import 'mitt';
 import 'three/webgpu';
@@ -52,8 +52,10 @@ interface TemplateFactory<E extends GameEntity<O>, O extends GameEntityOptions =
  * 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);
+ * asteroids.forEach((asteroid) => {
+ *     asteroid.onSetup(({ me }) => {
+ *         me.setPosition(Math.random() * 20 - 10, Math.random() * 15 - 7.5, 0);
+ *     });
  *     stage.add(asteroid);
  * });
  * ```

package/dist/entity.js

@@ -1 +1 @@
-import{A as $,B as aa,C as ba,D as ca,E as da,F as ea,G as fa,H as ga,I as ha,J as ia,K as ja,L as ka,M as la,N as ma,O as na,P as oa,Q as pa,R as qa,a as B,b as C,c as D,d as E,e as F,f as G,g as H,h as I,i as J,j as K,k as L,l as M,m as N,n as O,o as P,p as Q,q as R,r as S,s as T,t as U,u as V,v as W,w as X,x as Y,y as Z,z as _}from"./chunk-7FR5JSQ2.js";import{b as q,c as r,d as s,e as t,f as u,g as v,h as w,i as x,j as y,k as z,m as A}from"./chunk-XNDS4YFR.js";import{c as a,d as b,e as c,f as d,g as e,h as f,i as g,j as h,n as i,p as j,t as k,u as l,v as m,w as n,x as o,y as p}from"./chunk-XNHVRFAK.js";import"./chunk-CM5YRNBJ.js";import"./chunk-YHEWKN7N.js";import"./chunk-QXVH6POE.js";import"./chunk-E3UBSUPX.js";import"./chunk-4QLJUQSJ.js";import"./chunk-7WRQ2UAN.js";import"./chunk-XRP4JJXL.js";export{k as ACTOR_TYPE,H as BOX_TYPE,Z as CONE_TYPE,da as CYLINDER_TYPE,W as DISK_TYPE,n as FOG_TYPE,ma as LIGHT_TYPE,w as LINE_TYPE,ja as PARTICLE_SYSTEM_TYPE,ga as PILL_TYPE,N as PLANE_TYPE,aa as PYRAMID_TYPE,T as RECT_TYPE,K as SPHERE_TYPE,t as SPRITE_TYPE,q as TEXT_TYPE,Q as ZONE_TYPE,l as ZylemActor,I as ZylemBox,_ as ZylemCone,ea as ZylemCylinder,X as ZylemDisk,o as ZylemFog,na as ZylemLight,y as ZylemLine,ka as ZylemParticleSystem,ha as ZylemPill,O as ZylemPlane,ba as ZylemPyramid,U as ZylemRect,L as ZylemSphere,u as ZylemSprite,r as ZylemText,R as ZylemZone,a as boxCollision,B as boxMesh,c as coneCollision,D as coneMesh,i as create,m as createActor,J as createBox,$ as createCone,pa as createCooldownIcon,fa as createCylinder,Y as createDisk,j as createEntity,A as createEntityFactory,p as createFog,oa as createLight,z as createLine,la as createParticleSystem,ia as createPill,P as createPlane,ca as createPyramid,V as createRect,M as createSphere,v as createSprite,s as createText,S as createZone,e as cylinderCollision,F as cylinderMesh,qa as destroy,x as pickZylemLine,f as pillCollision,G as pillMesh,g as planeCollision,d as pyramidCollision,E as pyramidMesh,b as sphereCollision,C as sphereMesh,h as zoneCollision};
+import{A as $,B as aa,C as ba,D as ca,E as da,F as ea,G as fa,H as ga,I as ha,J as ia,K as ja,L as ka,M as la,N as ma,O as na,P as oa,Q as pa,R as qa,a as B,b as C,c as D,d as E,e as F,f as G,g as H,h as I,i as J,j as K,k as L,l as M,m as N,n as O,o as P,p as Q,q as R,r as S,s as T,t as U,u as V,v as W,w as X,x as Y,y as Z,z as _}from"./chunk-CV75NSES.js";import{b as q,c as r,d as s,e as t,f as u,g as v,h as w,i as x,j as y,k as z,m as A}from"./chunk-LGS5N5M4.js";import{A as m,B as n,C as o,D as p,c as a,d as b,e as c,f as d,g as e,h as f,i as g,j as h,s as i,u as j,y as k,z as l}from"./chunk-3I537JFL.js";import"./chunk-CM5YRNBJ.js";import"./chunk-AIQ6IVT5.js";import"./chunk-QXVH6POE.js";import"./chunk-EVYHPR3J.js";import"./chunk-4QLJUQSJ.js";import"./chunk-7WRQ2UAN.js";import"./chunk-XRP4JJXL.js";export{k as ACTOR_TYPE,H as BOX_TYPE,Z as CONE_TYPE,da as CYLINDER_TYPE,W as DISK_TYPE,n as FOG_TYPE,ma as LIGHT_TYPE,w as LINE_TYPE,ja as PARTICLE_SYSTEM_TYPE,ga as PILL_TYPE,N as PLANE_TYPE,aa as PYRAMID_TYPE,T as RECT_TYPE,K as SPHERE_TYPE,t as SPRITE_TYPE,q as TEXT_TYPE,Q as ZONE_TYPE,l as ZylemActor,I as ZylemBox,_ as ZylemCone,ea as ZylemCylinder,X as ZylemDisk,o as ZylemFog,na as ZylemLight,y as ZylemLine,ka as ZylemParticleSystem,ha as ZylemPill,O as ZylemPlane,ba as ZylemPyramid,U as ZylemRect,L as ZylemSphere,u as ZylemSprite,r as ZylemText,R as ZylemZone,a as boxCollision,B as boxMesh,c as coneCollision,D as coneMesh,i as create,m as createActor,J as createBox,$ as createCone,pa as createCooldownIcon,fa as createCylinder,Y as createDisk,j as createEntity,A as createEntityFactory,p as createFog,oa as createLight,z as createLine,la as createParticleSystem,ia as createPill,P as createPlane,ca as createPyramid,V as createRect,M as createSphere,v as createSprite,s as createText,S as createZone,e as cylinderCollision,F as cylinderMesh,qa as destroy,x as pickZylemLine,f as pillCollision,G as pillMesh,g as planeCollision,d as pyramidCollision,E as pyramidMesh,b as sphereCollision,C as sphereMesh,h as zoneCollision};

package/dist/events.d.ts

@@ -1,5 +1,5 @@
 import * as mitt from 'mitt';
-import { L as LoadingEvent } from './base-node-life-cycle-D2NuN1VB.js';
+import { L as LoadingEvent } from './base-node-life-cycle-BK9xebT9.js';
 import 'three';
 import './stage-transition-CmGpV4tc.js';
 
@@ -45,68 +45,6 @@ interface GameLoadingPayload extends LoadingEvent {
     stageName?: string;
     stageIndex?: number;
 }
-/** Payload for stage configuration sent to editor. */
-interface StageConfigPayload {
-    id: string;
-    backgroundColor: string;
-    backgroundImage: string | null;
-    gravity: {
-        x: number;
-        y: number;
-        z: number;
-    };
-    inputs: Record<string, string[]>;
-    variables: Record<string, unknown>;
-}
-/** Payload for entity configuration sent to editor. */
-interface EntityConfigPayload {
-    uuid: string;
-    name: string;
-    type: string;
-    position: {
-        x: number;
-        y: number;
-        z: number;
-    };
-    rotation: {
-        x: number;
-        y: number;
-        z: number;
-    };
-    scale: {
-        x: number;
-        y: number;
-        z: number;
-    };
-    /** PNG data URL of a framed entity preview, when available. */
-    thumbnail?: string | null;
-    /** World-space AABB size used for thumbnail rulers. */
-    bounds?: {
-        width: number;
-        height: number;
-        depth: number;
-    };
-}
-/** Payload for state dispatch events from game to editor. */
-interface StateDispatchPayload {
-    scope: 'game' | 'stage' | 'entity';
-    path: string;
-    value: unknown;
-    previousValue?: unknown;
-    config?: {
-        id: string;
-        aspectRatio: number;
-        fullscreen: boolean;
-        bodyBackground: string | undefined;
-        internalResolution: {
-            width: number;
-            height: number;
-        } | undefined;
-        debug: boolean;
-    } | null;
-    stageConfig?: StageConfigPayload | null;
-    entities?: EntityConfigPayload[] | null;
-}
 type GameEvents = {
     'loading:start': GameLoadingPayload;
     'loading:progress': GameLoadingPayload;
@@ -117,7 +55,6 @@ type GameEvents = {
     'debug': {
         enabled: boolean;
     };
-    'state:dispatch': StateDispatchPayload;
 };
 type StageEvents = {
     'stage:loaded': {
@@ -178,4 +115,4 @@ type ZylemEvents = GameEvents & StageEvents & EntityEvents;
  */
 declare const zylemEventBus: mitt.Emitter<ZylemEvents>;
 
-export { type EntityConfigPayload, type EntityEvents, EventEmitterDelegate, type GameEvents, type GameLoadingPayload, type StageConfigPayload, type StageEvents, type StateDispatchPayload, type ZylemEvents, zylemEventBus };
+export { type EntityEvents, EventEmitterDelegate, type GameEvents, type GameLoadingPayload, type StageEvents, type ZylemEvents, zylemEventBus };

package/dist/events.js

@@ -1 +1 @@
-import"./chunk-BIGH6D34.js";import{a,b}from"./chunk-YHEWKN7N.js";import"./chunk-QXVH6POE.js";export{a as EventEmitterDelegate,b as zylemEventBus};
+import"./chunk-BIGH6D34.js";import{a,b}from"./chunk-AIQ6IVT5.js";import"./chunk-QXVH6POE.js";export{a as EventEmitterDelegate,b as zylemEventBus};

package/dist/{game-C1FHVqXl.d.ts → game-NHkubIfI.d.ts}

@@ -1,15 +1,15 @@
-import { e as InputPlayerNumber, f as InputProvider, I as Inputs, h as SetupFunction, g as UpdateFunction, j as DestroyFunction, a as SetupContext, U as UpdateContext, D as DestroyContext, L as LoadingEvent, m as IGame, S as StageNavigationOptions } from './base-node-life-cycle-D2NuN1VB.js';
-import { G as GameInputConfig, B as BaseGlobals, Z as ZylemGameConfig } from './game-interfaces-mchNYSZE.js';
-import { G as GameEntity, a as GameEntityOptions, B as BaseNode, y as GameEntityLifeCycle } from './entity-BdSI8CL3.js';
+import { e as InputPlayerNumber, f as InputProvider, I as Inputs, h as SetupFunction, g as UpdateFunction, j as DestroyFunction, a as SetupContext, U as UpdateContext, D as DestroyContext, L as LoadingEvent, m as IGame, S as StageNavigationOptions } from './base-node-life-cycle-BK9xebT9.js';
+import { G as GameInputConfig, B as BaseGlobals, Z as ZylemGameConfig } from './game-interfaces-vF5sRi1n.js';
+import { G as GameEntity, a as GameEntityOptions, B as BaseNode, y as GameEntityLifeCycle } from './entity-BGEq1yfC.js';
 import { Scene, Color, Object3D, Vector3, BufferGeometry, Material, Group, Texture } from 'three';
-import { ak as ZylemWorld, ai as EntityTypeMap } from './entity-type-map-Bd69SpAS.js';
-import { E as Entity, L as LifecycleFunction, S as StageEntity } from './entity-DZbFQ1Wg.js';
-import { k as ZylemCamera, R as RendererManager, e as CameraPerspective, d as CameraContext, C as CameraPose, P as PerspectiveType, f as CameraBehavior, g as CameraAction, h as CameraPipelineState, V as Viewport, Z as ZylemPostEffect } from './zylem-camera-C3bn6BTI.js';
-import { d as ZylemShader } from './material-9vJ6SZaI.js';
-import { l as SimulationBody, e as Vec3Input, b as Vec2Input, d as Vec3Components } from './vector-CiSHbivc.js';
+import { ak as ZylemWorld, ai as EntityTypeMap } from './entity-type-map-CW6RHQkx.js';
+import { E as Entity, L as LifecycleFunction, S as StageEntity } from './entity-B9yZeBm4.js';
+import { k as ZylemCamera, R as RendererManager, e as CameraPerspective, d as CameraContext, C as CameraPose, P as PerspectiveType, f as CameraBehavior, g as CameraAction, h as CameraPipelineState, V as Viewport, Z as ZylemPostEffect } from './zylem-camera-Du2UPW9O.js';
+import { d as ZylemShader } from './material-DbSuZBbP.js';
+import { l as SimulationBody, e as Vec3Input, b as Vec2Input, d as Vec3Components } from './vector-DN6zlPoE.js';
 import { BehaviorSystem, BehaviorEntityLink, BehaviorRuntime, BehaviorSystemFactory, Simulation } from '@zylem/behaviors/core';
 import { StageEvents, GameEvents } from './events.js';
-import { D as DefaultTouchControlsOptions } from './default-controls-0-vCnli7.js';
+import { D as DefaultTouchControlsOptions } from './default-controls-CAKJ5zlo.js';
 import { S as StageTransitionConfig } from './stage-transition-CmGpV4tc.js';
 
 declare class InputManager {
@@ -144,6 +144,10 @@ declare class CameraManager {
     private _activeCameras;
     /** Auto-created debug camera with orbit controls */
     private _debugCamera;
+    /** Gameplay primary camera saved while the debug camera is active. */
+    private _preDebugPrimary;
+    /** Scene anchor at world origin for debug orbit when nothing is selected. */
+    private _debugOrbitTargetAnchor;
     /** Reference to the shared renderer manager */
     private _rendererManager;
     /** Scene reference */
@@ -163,6 +167,10 @@ declare class CameraManager {
      * Get the debug camera.
      */
     get debugCamera(): ZylemCamera | null;
+    /**
+     * Gameplay primary camera that was active before debug mode was enabled.
+     */
+    get preDebugPrimary(): ZylemCamera | null;
     /**
      * Get all registered cameras.
      */
@@ -206,6 +214,16 @@ declare class CameraManager {
      * Also creates the debug camera.
      */
     setup(scene: Scene, rendererManager: RendererManager): Promise<void>;
+    /**
+     * Switch the primary viewport to the debug orbit camera, remembering the
+     * previous primary so gameplay cameras (e.g. first-person) can be restored.
+     */
+    activateDebugCamera(): boolean;
+    /**
+     * Restore the gameplay primary camera that was active before
+     * {@link activateDebugCamera}.
+     */
+    deactivateDebugCamera(): boolean;
     /**
      * Update all active cameras' controllers.
      */
@@ -227,8 +245,14 @@ declare class CameraManager {
     dispose(): void;
     /**
      * Create the always-available debug camera with orbit controls.
+     * Registered for lookup/activation, but not added to the active list.
      */
     private createDebugCamera;
+    /**
+     * Seed the debug camera orbit pose on first activation, framing the origin
+     * or offsetting from the saved gameplay primary.
+     */
+    private seedDebugCameraPose;
     /**
      * Resolve a camera from a name or reference.
      */
@@ -630,6 +654,8 @@ declare class FirstPersonPerspective implements CameraPerspective {
     look(deltaYaw: number, deltaPitch: number): void;
     /** Set absolute yaw and pitch. Pitch is clamped to the configured limit. */
     setLook(yaw: number, pitch: number): void;
+    /** Set eye height above the followed target (used when syncing from FirstPersonBehavior). */
+    setEyeHeight(height: number): void;
     /** Current yaw in radians. */
     get yaw(): number;
     /** Current pitch in radians. */
@@ -857,16 +883,33 @@ declare class StageDebugDelegate {
     private cameraDebugDelegate;
     private debugStateUnsubscribe;
     private focusContextUnregister;
+    private entityResolverUnregister;
+    private lastDebugEnabled;
+    private warnedMissingAddFactory;
     constructor(stage: ZylemStage, options?: StageDebugDelegateOptions);
+    /**
+     * Supply the factory the `add` tool uses to spawn entities at the clicked
+     * point. Without one the tool warns instead of silently doing nothing.
+     */
+    setAddEntityFactory(factory: AddEntityFactory | null): void;
+    /** Camera used for debug orbit / raycasts (active primary, usually `__debug__`). */
+    private getDebugViewCamera;
     private resolveEntity;
     /** Copy all stage children into debugMap so raycast/select tools work after enabling debug mid-session. */
     private populateDebugMap;
     private ensureCameraDebugDelegate;
+    /**
+     * Activate/deactivate only when `debugState.enabled` actually flips.
+     * Hover and selection write to `debugState` every frame, and `activate()`
+     * rebuilds post-processing, so reacting to every notification would
+     * rebuild the render pipeline once per frame.
+     */
     private syncWithDebugState;
-    /** Initialize DOM listeners and camera debug delegate when debug is turned on. */
+    /** Initialize DOM listeners and switch rendering to the debug orbit camera. */
     private activate;
-    /** Tear down visuals and camera debug delegate when debug is turned off. */
+    /** Tear down visuals and restore the gameplay primary camera. */
     private deactivate;
+    private rebindPostProcessing;
     private initDebugVisuals;
     private disposeDebugVisuals;
     update(): void;
@@ -1665,16 +1708,10 @@ declare class ZylemGame<TGlobals extends BaseGlobals> {
     private rendererObserver;
     private eventBusUnsubscribes;
     private thumbnailUnsubscribes;
-    /**
-     * Trailing-debounce timer for entity-driven state dispatches. Building a
-     * `state:dispatch` payload is O(entities) (and downstream editor stores
-     * re-proxy/reconcile every entity), so bursts of thumbnail/destroy events
-     * must coalesce into a single dispatch instead of one per entity.
-     */
-    private entityDispatchTimer;
-    private pendingEntityDispatchPath;
-    /** Debounce window (ms) for coalescing entity-driven state dispatches. */
-    private static readonly ENTITY_DISPATCH_DEBOUNCE_MS;
+    /** Serialized last-published game config, for dirty-checking resize churn. */
+    private lastPublishedGameConfig;
+    /** Editor ↔ game bridge adapter (RAF-coalesced publishes, command intake). */
+    private gameBridge;
     private readonly gameUpdateParams;
     private readonly stageSetupParams;
     private readonly stageUpdateParams;
@@ -1728,27 +1765,47 @@ declare class ZylemGame<TGlobals extends BaseGlobals> {
      */
     private buildStageConfigPayload;
     /**
-     * Build the entities payload for the current stage.
+     * Build a bridge entity summary for one entity, or null for entities on
+     * the managed render path (instanced packs/bundles), which can number in
+     * the thousands and are not useful in the editor panel.
+     */
+    private buildEntitySummary;
+    /**
+     * Build the full entities payload for the current stage.
      */
     private buildEntitiesPayload;
     /**
-     * Generate entity thumbnails as entities become available, then refresh editor state.
+     * Generate entity thumbnails as entities become available, streaming
+     * upserts/thumbnails/removals to the editor through the bridge
+     * (RAF-coalesced, merged by uuid).
+     *
+     * All of this work exists only to feed the editor, and thumbnails in
+     * particular cost an offscreen render plus a pixel readback on the shared
+     * renderer. Each publisher therefore checks the bridge for a live listener
+     * first, and a late-connecting editor is backfilled from
+     * {@link wireEditorBackfill}.
      */
     private wireEntityThumbnails;
-    private clearEntityThumbnailWiring;
     /**
-     * Coalesce entity-driven state dispatches (thumbnail resolutions, entity
-     * destruction) into one trailing `emitStateDispatch` per burst.
+     * Republish the current stage when an editor subscribes after the game
+     * started. Without this, entities added while nothing was listening would
+     * never appear, since the per-entity publishers were skipped.
      */
-    private queueEntityStateDispatch;
+    private wireEditorBackfill;
+    private clearEntityThumbnailWiring;
+    private buildGameConfigPayload;
+    /** Publish the resolved display config over the bridge. */
     /**
-     * Emit a state:dispatch event to the zylemEventBus.
-     * Called after stage load and on global state changes.
+     * Publish the display config, skipping unchanged payloads. The
+     * `ResizeObserver` on `<zylem-game>` funnels into `setDisplayRuntime`, which
+     * fires on every layout tick even when nothing about the config moved.
      */
-    private emitStateDispatch;
+    private publishGameConfig;
+    /** Publish a full stage snapshot (config + entity list) over the bridge. */
+    private publishStageSnapshot;
     /**
-     * Subscribe to the game event bus for stage loading and state events.
-     * Emits events to zylemEventBus for cross-package communication.
+     * Subscribe to the game event bus for stage loading and state events,
+     * mirroring global-variable updates to the editor over the bridge.
      */
     private subscribeToEventBus;
 }

package/dist/game-default-5TB3T5N7.js

@@ -0,0 +1 @@
+import{v as e}from"./chunk-WVSYUWTT.js";import"./chunk-C5NEGC3S.js";import"./chunk-GKHAJ3MW.js";import"./chunk-LKFF6XJC.js";import"./chunk-W5SXED5T.js";import"./chunk-YAOXFYOD.js";import"./chunk-3I537JFL.js";import"./chunk-CM5YRNBJ.js";import"./chunk-AIQ6IVT5.js";import"./chunk-QXVH6POE.js";import"./chunk-EVYHPR3J.js";import"./chunk-D2PATZCC.js";import"./chunk-4QLJUQSJ.js";import"./chunk-7WRQ2UAN.js";import"./chunk-BH53MBAZ.js";import"./chunk-XRP4JJXL.js";import"./chunk-UG22Z42P.js";import{proxy as t}from"valtio/vanilla";var s=()=>({id:"zylem",globals:{},stages:[e()],debug:!1,time:0,input:void 0}),a=t({...s()});function o(){return{id:a.id??"zylem",globals:a.globals??{},stages:a.stages??[e()],debug:a.debug,time:a.time,input:a.input}}export{o as getGameDefaultConfig};

package/dist/{game-interfaces-mchNYSZE.d.ts → game-interfaces-vF5sRi1n.d.ts}

@@ -1,4 +1,4 @@
-import { g as UpdateFunction } from './base-node-life-cycle-D2NuN1VB.js';
+import { g as UpdateFunction } from './base-node-life-cycle-BK9xebT9.js';
 
 type BasicTypes = number | string | boolean;
 type BaseGlobals = Record<string, BasicTypes>;
@@ -60,6 +60,12 @@ interface MouseConfig {
     pointerLock?: boolean;
     /** Sensitivity multiplier for mouse movement (default 0.002). */
     sensitivity?: number;
+    /** How mouse position drives look: delta (movement) or screenCenter (cursor offset from viewport center). */
+    lookMode?: 'delta' | 'screenCenter';
+    /** Max yaw/pitch in degrees when `lookMode` is `screenCenter` (default 45). */
+    maxLookDegrees?: number;
+    /** Screen-center follow rate toward cursor-mapped target (lower = snappier; default 2). */
+    lookSensitivity?: number;
 }
 interface GameInputPlayerConfig {
     key?: KeyboardMapping;

package/dist/globals.d.ts

@@ -1,4 +1,4 @@
-import { U as UpdateContext } from './base-node-life-cycle-D2NuN1VB.js';
+import { U as UpdateContext } from './base-node-life-cycle-BK9xebT9.js';
 import 'three';
 import './stage-transition-CmGpV4tc.js';
 

package/dist/graphics.d.ts

@@ -1,13 +1,13 @@
-import { b as ZylemTSLShader } from './material-9vJ6SZaI.js';
-export { d as ZylemShader, Z as ZylemShaderObject, c as createNodeMaterialFromTSL, a as isGLSLShader, i as isTSLShader } from './material-9vJ6SZaI.js';
-export { Z as ZylemPostEffect } from './zylem-camera-C3bn6BTI.js';
+import { b as ZylemTSLShader } from './material-DbSuZBbP.js';
+export { d as ZylemShader, Z as ZylemShaderObject, c as createNodeMaterialFromTSL, a as isGLSLShader, i as isTSLShader } from './material-DbSuZBbP.js';
+export { Z as ZylemPostEffect } from './zylem-camera-Du2UPW9O.js';
 export { S as StageTransitionConfig, a as StageTransitionEasing, Z as ZylemTransitionShader, c as crossfadeTransitionShader } from './stage-transition-CmGpV4tc.js';
 export { Fn, abs, asin, atan, clamp, cos, dot, exp, float, floor, fract, length, max, min, mix, mod, normalize, positionWorld, positionWorldDirection, pow, sin, smoothstep, step, time, uniform, uv, vec2, vec3, vec4 } from 'three/tsl';
 import 'three';
 import 'three/webgpu';
-import './vector-CiSHbivc.js';
+import './vector-DN6zlPoE.js';
 import '@zylem/behaviors/core';
-import './entity-DZbFQ1Wg.js';
+import './entity-B9yZeBm4.js';
 
 declare const standardShader: {
     vertex: string;

package/dist/input-ui.d.ts

@@ -1,9 +1,9 @@
-import { T as TouchTheme, b as TouchThemeName } from './default-controls-0-vCnli7.js';
-export { D as DefaultTouchControlsOptions, J as JoystickSelection, d as defaultTouchControls, a as resolveButtonAccent, r as resolveTouchTheme, t as touchThemes } from './default-controls-0-vCnli7.js';
-import './base-node-life-cycle-D2NuN1VB.js';
+import { T as TouchTheme, b as TouchThemeName } from './default-controls-CAKJ5zlo.js';
+export { D as DefaultTouchControlsOptions, J as JoystickSelection, d as defaultTouchControls, a as resolveButtonAccent, r as resolveTouchTheme, t as touchThemes } from './default-controls-CAKJ5zlo.js';
+import './base-node-life-cycle-BK9xebT9.js';
 import 'three';
 import './stage-transition-CmGpV4tc.js';
-import './game-interfaces-mchNYSZE.js';
+import './game-interfaces-vF5sRi1n.js';
 
 type TouchThemeInput = TouchTheme | TouchThemeName;
 interface TouchButtonSvgOptions {

package/dist/input-ui.js

@@ -1 +1 @@
-import"./chunk-ORIDWL3T.js";import{a,b,c,d,e,f,g}from"./chunk-RXDTAWI2.js";import"./chunk-MSC2BEO5.js";export{g as defaultTouchControls,d as joystickBaseSvg,e as joystickThumbSvg,c as resolveButtonAccent,b as resolveTouchTheme,f as touchButtonSvg,a as touchThemes};
+import"./chunk-ORIDWL3T.js";import{a,b,c,d,e,f,g}from"./chunk-PCFF4LLO.js";import"./chunk-UG22Z42P.js";export{g as defaultTouchControls,d as joystickBaseSvg,e as joystickThumbSvg,c as resolveButtonAccent,b as resolveTouchTheme,f as touchButtonSvg,a as touchThemes};