@zylem/game-lib 0.9.7 → 0.9.8

package/dist/api/game-lib.api.md

@@ -62,7 +62,9 @@ import { ILogger } from 'typescript-fsm';
 import { ITransition } from 'typescript-fsm';
 import { length as length_2 } from 'three/tsl';
 import { LevelBuffer } from '@zylem/bridge';
+import { LevelDocument } from '@zylem/bridge';
 import { LevelEntry } from '@zylem/bridge';
+import { LevelSyncPayload } from '@zylem/bridge';
 import { Light } from 'three';
 import { Line2 } from 'three/addons/lines/webgpu/Line2.js';
 import { Material } from 'three';
@@ -1144,7 +1146,7 @@ export function coneCollision(opts?: ConeCollisionOptions): CollisionComponent;
 // @public
 export function coneMesh(opts?: ConeMeshOptions): Mesh;
 
-// @public
+// @public (undocumented)
 export class ConstructionGrid {
     constructor();
     // (undocumented)
@@ -1152,6 +1154,9 @@ export class ConstructionGrid {
     // (undocumented)
     dispose(): void;
     setIncrement(increment: number): void;
+    // Warning: (ae-forgotten-export) The symbol "GridPlane" needs to be exported by the entry point public.d.ts
+    // Warning: (ae-forgotten-export) The symbol "GridPoint" needs to be exported by the entry point public.d.ts
+    setPlane(plane: GridPlane | null, focus?: GridPoint): void;
     // (undocumented)
     setVisible(visible: boolean): void;
     // (undocumented)
@@ -1903,7 +1908,7 @@ export type DebugEntityResolver = (uuid: string) => GameEntity<any> | null;
 export const debugState: DebugState;
 
 // @public (undocumented)
-export type DebugTools = 'select' | 'translate' | 'rotate' | 'scale' | 'delete' | 'add' | 'brush' | 'clip' | 'vertex' | 'none';
+export type DebugTools = 'select' | 'translate' | 'rotate' | 'scale' | 'delete' | 'add' | 'brush' | 'clip' | 'shear' | 'none';
 
 // @public (undocumented)
 export const DEFAULT_SNAP_SETTINGS: SnapSettings;
@@ -2744,6 +2749,7 @@ export class GameBridge {
     publishLoading(payload: BridgeLoadingPayload): void;
     publishNotice(level: GameNoticePayload['level'], message: string): void;
     publishSceneOperation(op: SceneOperationPayload): void;
+    publishSelectedPoses(): void;
     // (undocumented)
     publishStageSnapshot(snapshot: StageSnapshotPayload): void;
     // (undocumented)
@@ -2778,7 +2784,6 @@ export interface GameBridgeHost {
     };
     levelClose?(): void;
     levelPlay?(document: LevelDocument): void;
-    // Warning: (ae-forgotten-export) The symbol "LevelSyncPayload" needs to be exported by the entry point public.d.ts
     levelSync?(payload: LevelSyncPayload): void;
     pickEntity?(ndc: BridgeNdc): EntitySummaryPayload | null;
     resolveEntity(uuid: string): GameEntity<any> | null;
@@ -4063,23 +4068,7 @@ export function lerpVec3(a: Vec3Def, b: Vec3Def, t: number): Vec3Def;
 
 export { LevelBuffer }
 
-// @public
-export interface LevelDocument {
-    // Warning: (ae-forgotten-export) The symbol "DoodadPlacement" needs to be exported by the entry point public.d.ts
-    //
-    // (undocumented)
-    doodads: DoodadPlacement[];
-    // Warning: (ae-forgotten-export) The symbol "EntityPlacement" needs to be exported by the entry point public.d.ts
-    //
-    // (undocumented)
-    entities: EntityPlacement[];
-    // Warning: (ae-forgotten-export) The symbol "BrushSolid" needs to be exported by the entry point public.d.ts
-    //
-    // (undocumented)
-    solids: BrushSolid[];
-    // (undocumented)
-    version: 2;
-}
+export { LevelDocument }
 
 // @public
 export interface LevelStage {
@@ -9365,8 +9354,8 @@ export class ZylemZone extends GameEntity<ZylemZoneOptions> implements Collision
 // dist/entity-CY75JJSw.d.ts:410:9 - (ae-forgotten-export) The symbol "EntityMeshBuilder" needs to be exported by the entry point public.d.ts
 // dist/entity-CY75JJSw.d.ts:411:9 - (ae-forgotten-export) The symbol "EntityCollisionBuilder" needs to be exported by the entry point public.d.ts
 // dist/entity-CY75JJSw.d.ts:412:9 - (ae-forgotten-export) The symbol "MaterialBuilder" needs to be exported by the entry point public.d.ts
-// dist/game-CmkhPP-9.d.ts:258:5 - (ae-forgotten-export) The symbol "StageInterface" needs to be exported by the entry point public.d.ts
-// dist/stage-CCGJh9TD.d.ts:1193:5 - (ae-forgotten-export) The symbol "StageAssetLoaderConfig" needs to be exported by the entry point public.d.ts
+// dist/game-uQd7k6-m.d.ts:258:5 - (ae-forgotten-export) The symbol "StageInterface" needs to be exported by the entry point public.d.ts
+// dist/stage-Dez16Gxm.d.ts:1194:5 - (ae-forgotten-export) The symbol "StageAssetLoaderConfig" needs to be exported by the entry point public.d.ts
 
 // (No @packageDocumentation comment for this package)
 

package/dist/api/game-lib.d.ts

@@ -56,7 +56,9 @@ import { ILogger } from 'typescript-fsm';
 import { ITransition } from 'typescript-fsm';
 import { length as length_2 } from 'three/tsl';
 import { LevelBuffer } from '@zylem/bridge';
+import { LevelDocument } from '@zylem/bridge';
 import { LevelEntry } from '@zylem/bridge';
+import { LevelSyncPayload } from '@zylem/bridge';
 import { Light } from 'three';
 import { Line2 } from 'three/addons/lines/webgpu/Line2.js';
 import { Material } from 'three';
@@ -1336,35 +1338,6 @@ export { BridgeNdc }
 
 export { BridgeVec3 }
 
-declare interface BrushPlane {
-    normal: BrushVec3;
-    /** The solid is `normal · point <= distance`. */
-    distance: number;
-}
-
-/** One convex solid. Planes are world-space half-spaces. */
-declare interface BrushSolid {
-    id: string;
-    planes: BrushPlane[];
-}
-
-/**
- * Convex brush kernel.
- *
- * A brush is the intersection of half-spaces: a point is inside when
- * `normal · point <= distance` for every plane. The normal points outward.
- * Planes are world-space, so moving a brush shifts every distance by
- * `normal · delta`. No Three.js and no physics types.
- *
- * Copy of `packages/bridge/src/level/brush.ts`, kept inside this package so
- * the declaration build does not reach outside `src`.
- */
-declare interface BrushVec3 {
-    x: number;
-    y: number;
-    z: number;
-}
-
 /** Cuboid collider sized as `size.xyz` (full extents — half-extents are computed). */
 export declare function buildBoxCollider(size: Vec3Input, options?: RuntimeColliderOptions): StageColliderConfig;
 
@@ -1515,7 +1488,7 @@ export declare const CameraKeyframeSchema: _sinclair_typebox.TObject<{
  * Responsibilities:
  * - Named camera registry (add/remove/get by name or reference)
  * - Active camera list management (determines which cameras render)
- * - Editor view cameras (side, top, isometric, free), created only while an editor is attached
+ * - Editor view cameras, created only while an editor is attached
  * - Per-frame update of all active cameras' perspective controllers
  * - Coordinating rendering via RendererManager for all active viewports
  */
@@ -1561,11 +1534,11 @@ export declare class CameraManager implements EditorCameraHost {
      * Get the primary active camera (first in the active list).
      */
     get primaryCamera(): ZylemCamera | null;
-    /** True while side, top, isometric, or free is the main view. */
+    /** True while an editor view is the main camera. */
     isEditorViewActive(): boolean;
     /** Id of the editor view that is currently the main camera, if one is. */
     activeEditorCameraId(): string | null;
-    /** True after the four editor views have been created. */
+    /** True after the editor views have been created. */
     hasEditorCameras(): boolean;
     /**
      * World boxes used the first time side, top, or isometric is shown.
@@ -1623,13 +1596,13 @@ export declare class CameraManager implements EditorCameraHost {
      */
     setup(scene: Scene, rendererManager: RendererManager): Promise<void>;
     /**
-     * Create side, top, isometric, and free cameras seeded from the current
-     * game camera. Does not change which camera is rendering.
+     * Create the editor view cameras seeded from the current game camera.
+     * Does not change which camera is rendering.
      */
     ensureEditorCameras(): Promise<void>;
     /**
      * Restore the game camera when an editor view is showing, then destroy
-     * the four editor cameras.
+     * the editor cameras.
      */
     destroyEditorCameras(): void;
     /**
@@ -2354,14 +2327,6 @@ declare interface ConeMeshOptions extends BaseMeshOptions {
 
 declare type ConeOptions = BaseNode | Partial<ZylemConeOptions>;
 
-/**
- * The y=0 construction plane, drawn so the snap lattice is legible.
- *
- * Two overlaid grids: fine lines at the translation snap increment, and heavier
- * lines every metre. Without the coarse pass a 0.25 grid over any useful area
- * reads as flat grey noise.
- */
-
 export declare class ConstructionGrid {
     private group;
     private scene;
@@ -2374,8 +2339,17 @@ export declare class ConstructionGrid {
     setIncrement(increment: number): void;
     setVisible(visible: boolean): void;
     get visible(): boolean;
+    /**
+     * Lay the grid on a plane, or back on y=0 with `null`.
+     *
+     * The plane's `u` runs along the grid's X. The grid centres on the lines
+     * nearest `focus`, shifted by whole cells, so it stays on the world lattice.
+     */
+    setPlane(plane: GridPlane | null, focus?: GridPoint): void;
     dispose(): void;
     private rebuild;
+    /** The shortest shift that is whole fine steps and whole metres, so neither set of lines moves. */
+    private wholeCell;
     private clearHelpers;
 }
 
@@ -3437,7 +3411,7 @@ declare interface DebugState {
 
 export declare const debugState: DebugState;
 
-export declare type DebugTools = 'select' | 'translate' | 'rotate' | 'scale' | 'delete' | 'add' | 'brush' | 'clip' | 'vertex' | 'none';
+export declare type DebugTools = 'select' | 'translate' | 'rotate' | 'scale' | 'delete' | 'add' | 'brush' | 'clip' | 'shear' | 'none';
 
 export declare const DEFAULT_SNAP_SETTINGS: SnapSettings;
 
@@ -3929,14 +3903,6 @@ export declare const DollyPathSchema: _sinclair_typebox.TObject<{
 /** Point along a dolly path at `u` in 0…1 (arc-length parameterised). */
 export declare function dollyPointAt(path: DollyPath, u: number): Vec3Def;
 
-/** A visual placement. Spawned with no collider. */
-declare interface DoodadPlacement {
-    id: string;
-    typeId: string;
-    pose: BridgePose;
-    props: Record<string, unknown>;
-}
-
 export { dot }
 
 declare function drizzle(options?: SemanticParticlePresetOptions): ParticleEffectDefinition;
@@ -3975,7 +3941,7 @@ export declare function easeValue(easing: CutsceneEasing, t: number): number;
  *
  * `GameBridge.connect()` runs for every game, so it is not the signal. The
  * bridge marks the session attached when an editor subscribes, and every live
- * camera manager creates or destroys its four view cameras from that flag.
+ * camera manager creates or destroys its view cameras from that flag.
  */
 declare interface EditorCameraHost {
     ensureEditorCameras(): Promise<void>;
@@ -4352,20 +4318,6 @@ export { EntityPickPayload }
 
 export { EntityPickResultPayload }
 
-/**
- * A gameplay marker.
- *
- * `typeId` is `spawn` or `zone`. Spawn props carry `spawnKind`
- * (`player` | `enemy` | `item`) and `archetype`. Trigger props carry `size`.
- */
-declare interface EntityPlacement {
-    id: string;
-    typeId: string;
-    name: string;
-    pose: BridgePose;
-    props: Record<string, unknown>;
-}
-
 export declare interface EntityRepresentative {
     source: RepresentativeSource;
     options: EntityRepresentativeOptions;
@@ -5356,6 +5308,8 @@ export declare class GameBridge {
     private applyingSceneOperation;
     /** Frame watch used when the channel cannot report subscriber removal. */
     private editorCameraFrame;
+    /** Last pose published for each selected entity, so one at rest sends nothing. */
+    private publishedPoses;
     constructor();
     /**
      * Subscribe to editor commands and announce the game side as ready.
@@ -5368,6 +5322,17 @@ export declare class GameBridge {
     /** The previewing camera's projection, for Director mode's viewport overlays. */
     publishCutsceneView(view: CutsceneViewPayload): void;
     disconnect(): void;
+    /**
+     * Echo the live pose of each selected entity that moved since its pose was
+     * last published. The game loop calls this every frame.
+     *
+     * One watcher covers every mover — gizmo drags, undo/redo, physics, scripts —
+     * so the editor's transform fields follow the selection without each of them
+     * publishing for itself. Only the selection is watched: it is all the
+     * inspector shows, and watching the whole stage would cost a pose read per
+     * entity per frame.
+     */
+    publishSelectedPoses(): void;
     /**
      * Run a swatch batch and report back.
      *
@@ -6446,10 +6411,12 @@ export { GameVariablePayload }
 /**
  * The stage's picture of the level document.
  *
- * The editor owns the file. This session draws it, reports finished gestures,
- * and on play swaps the brush faces for one static body of convex hulls.
- * Nothing it creates is a normal stage entity except play-mode trigger zones,
- * and those are marked editor-owned so they are not published back.
+ * The editor owns the file. This session draws it, routes level pointer
+ * gestures to the tools, reports what they finish, and on play swaps the
+ * brush faces for one merged mesh and one static body of convex hulls per
+ * sector. Nothing it creates is a normal stage entity except play-mode
+ * trigger zones, and those are marked editor-owned so they are not published
+ * back.
  */
 
 /** The document currently previewed or playing, for hosts that spawn from markers. */
@@ -6566,6 +6533,28 @@ export declare function globalChanges<T = any>(keys: string[], callback: (values
 
 declare type GlobalRecord = Record<string, unknown>;
 
+/** A plane as a draw frame names it: a point on it, its in-plane `u`, and its normal. */
+declare interface GridPlane {
+    origin: GridPoint;
+    u: GridPoint;
+    normal: GridPoint;
+}
+
+/**
+ * The construction plane, drawn so the snap lattice is legible. It lies on
+ * y=0 unless a level draw lays it on the draw plane.
+ *
+ * Two overlaid grids: fine lines at the translation snap increment, and heavier
+ * lines every metre. Without the coarse pass a 0.25 grid over any useful area
+ * reads as flat grey noise.
+ */
+
+declare interface GridPoint {
+    x: number;
+    y: number;
+    z: number;
+}
+
 export declare function hasAnyWorldBoundary2DHit(hits: WorldBoundary2DHits): boolean;
 
 export declare function hasAnyWorldBoundary3DHit(hits: WorldBoundary3DHits): boolean;
@@ -7309,40 +7298,7 @@ export declare function lerpVec3(a: Vec3Def, b: Vec3Def, t: number): Vec3Def;
 
 export { LevelBuffer }
 
-/**
- * The level file. The editor owns it; the stage only previews and plays it.
- *
- * `version` is 2 so a v1 catalog buffer is recognisable and left alone.
- */
-export declare interface LevelDocument {
-    version: 2;
-    solids: BrushSolid[];
-    doodads: DoodadPlacement[];
-    entities: EntityPlacement[];
-}
-
-/**
- * Level document shapes shared with the editor over the bridge.
- *
- * Defined here, matching `packages/bridge/src/protocol.ts`, because the
- * installed `@zylem/bridge` build does not export them yet and the
- * declaration build cannot import files outside this package.
- */
-
-/** Which list in a level document an edit or a visibility toggle addresses. */
-declare type LevelLayerId = 'solid' | 'doodad' | 'entity';
-
-/** What the Add tool will write into the document on the next click. */
-declare type LevelPlacementArm = {
-    kind: 'doodad';
-    typeId: string;
-    props?: Record<string, unknown>;
-} | {
-    kind: 'spawn';
-} | {
-    kind: 'trigger';
-    size: BridgeVec3;
-};
+export { LevelDocument }
 
 /**
  * Stream a level buffer into a stage through the catalog.
@@ -7357,15 +7313,6 @@ export declare interface LevelStage {
     spawnEntity(node: BaseNode): Promise<void> | void;
 }
 
-/** Edit-time preview. Hidden layers are omitted; play ignores this and streams everything. */
-declare interface LevelSyncPayload {
-    document: LevelDocument;
-    hiddenLayers: LevelLayerId[];
-    selectedIds: string[];
-    activeLayer: LevelLayerId;
-    placement: LevelPlacementArm | null;
-}
-
 /** B171–B180. Eight rows per table; 128 contexts. Calendar commands close exactly one day.
  * Day 0 is weekday 0; seasons are floor(day / seasonLength) % 4. Masks select bits 0..3/0..6.
  * Daily order: growth/care, calendar, withering, moisture decay + new-day rain, reward reset,
@@ -14029,6 +13976,8 @@ declare class StageDebugDelegate {
     private syncWithDebugState;
     /** Hand the transform tool its mode whenever the active tool changes. */
     private syncToolMode;
+    /** The entity gizmo stands down while a level is edited; the level session runs its own. */
+    private syncTransformTool;
     private syncGrid;
     /** Initialize DOM listeners. The rendering camera stays whatever the editor selected. */
     private activate;