@zylem/game-lib 0.8.6 → 0.8.7

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

@@ -91,6 +91,7 @@ import { EditorToGameMessages } from '@zylem/bridge';
 import { emitRuntimeGoal } from '@zylem/behaviors/runtime-2d';
 import { emitRuntimeRicochet } from '@zylem/behaviors/runtime-2d';
 import { emitRuntimeTriggerRegionEnter } from '@zylem/behaviors/runtime-2d';
+import { EntityApplySwatchPayload } from '@zylem/bridge';
 import { EntityDefinition } from '@zylem/behaviors/core';
 import { EntityHandle } from '@zylem/behaviors/core';
 import { EntitySummaryPayload } from '@zylem/bridge';
@@ -1065,6 +1066,8 @@ export { emitRuntimeRicochet }
 
 export { emitRuntimeTriggerRegionEnter }
 
+export { EntityApplySwatchPayload }
+
 // @public (undocumented)
 export type EntityBlueprint = Static<typeof EntitySchema>;
 
@@ -1482,6 +1485,7 @@ export class GameBridge {
 // @public
 export interface GameBridgeHost {
     applySceneOperation?(op: SceneOperationPayload, direction: 'undo' | 'redo'): void;
+    applySwatch?(payload: EntityApplySwatchPayload): void;
     createEntity?(typeId: string, props: Record<string, unknown> | undefined, pose: BridgePose | undefined): void;
     resolveEntity(uuid: string): GameEntity<any> | null;
     setStageVariable?(key: string, value: unknown): void;
@@ -2286,6 +2290,9 @@ export function isManagedRenderEntity(entity: {
     isBundled?: boolean;
 }): boolean;
 
+// @public (undocumented)
+export function isPickMode(): boolean;
+
 // @public (undocumented)
 export function isTransformTool(tool: DebugTools): tool is TransformTool;
 
@@ -3114,6 +3121,9 @@ export function setHoveredEntityId(uuid: string | null): void;
 // @public (undocumented)
 export function setPaused(paused: boolean): void;
 
+// @public
+export function setPickMode(enabled: boolean): void;
+
 export { setPosition }
 
 export { setPositionX }
@@ -4821,8 +4831,8 @@ export class ZylemZone extends GameEntity<ZylemZoneOptions> implements Collision
 // dist/entity-XZNGBeca.d.ts:343:9 - (ae-forgotten-export) The symbol "EntityMeshBuilder" needs to be exported by the entry point public.d.ts
 // dist/entity-XZNGBeca.d.ts:344:9 - (ae-forgotten-export) The symbol "EntityCollisionBuilder" needs to be exported by the entry point public.d.ts
 // dist/entity-XZNGBeca.d.ts:345:9 - (ae-forgotten-export) The symbol "MaterialBuilder" needs to be exported by the entry point public.d.ts
-// dist/game-Cy8f6gJm.d.ts:1051:5 - (ae-forgotten-export) The symbol "StageAssetLoaderConfig" needs to be exported by the entry point public.d.ts
-// dist/game-Cy8f6gJm.d.ts:1721:5 - (ae-forgotten-export) The symbol "StageInterface" needs to be exported by the entry point public.d.ts
+// dist/game-BPOr7zTB.d.ts:1060:5 - (ae-forgotten-export) The symbol "StageAssetLoaderConfig" needs to be exported by the entry point public.d.ts
+// dist/game-BPOr7zTB.d.ts:1735:5 - (ae-forgotten-export) The symbol "StageInterface" needs to be exported by the entry point public.d.ts
 
 // (No @packageDocumentation comment for this package)
 

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

@@ -85,6 +85,7 @@ import { EditorToGameMessages } from '@zylem/bridge';
 import { emitRuntimeGoal } from '@zylem/behaviors/runtime-2d';
 import { emitRuntimeRicochet } from '@zylem/behaviors/runtime-2d';
 import { emitRuntimeTriggerRegionEnter } from '@zylem/behaviors/runtime-2d';
+import { EntityApplySwatchPayload } from '@zylem/bridge';
 import { EntityDefinition } from '@zylem/behaviors/core';
 import { EntityHandle } from '@zylem/behaviors/core';
 import { EntitySummaryPayload } from '@zylem/bridge';
@@ -1777,6 +1778,11 @@ declare interface DebugState {
     addTypeId: string | null;
     /** Creation options merged over the armed type's defaults. */
     addTypeProps: Record<string, unknown> | null;
+    /**
+     * Host-driven hover picking (e.g. Creator swatch drag). Raycasts even when
+     * the Select tool is not armed, and keeps the hover highlight painted.
+     */
+    pickMode: boolean;
     flags: Set<string>;
 }
 
@@ -1946,6 +1952,8 @@ declare interface Entity<T = any> {
     tag?: Set<string>;
 }
 
+export { EntityApplySwatchPayload }
+
 export declare type EntityBlueprint = Static<typeof EntitySchema>;
 
 declare abstract class EntityBuilder<T extends GameEntity<U> & P, U extends GameEntityOptions, P = any> {
@@ -2700,6 +2708,8 @@ export declare interface GameBridgeHost {
     createEntity?(typeId: string, props: Record<string, unknown> | undefined, pose: BridgePose | undefined): void;
     /** Undo or redo a committed scene operation (`scene:operation:apply`). */
     applySceneOperation?(op: SceneOperationPayload, direction: 'undo' | 'redo'): void;
+    /** Attach a catalog shader or behavior to a live entity (`entity:apply-swatch`). */
+    applySwatch?(payload: EntityApplySwatchPayload): void;
 }
 
 /**
@@ -3805,6 +3815,8 @@ export declare function isManagedRenderEntity(entity: {
     isBundled?: boolean;
 }): boolean;
 
+export declare function isPickMode(): boolean;
+
 declare interface IStage {
     onUpdate: (callback: UpdateFunction<IStage>) => void;
     onSetup: (callback: SetupFunction<IStage>) => void;
@@ -5405,6 +5417,9 @@ export declare function setHoveredEntityId(uuid: string | null): void;
 
 export declare function setPaused(paused: boolean): void;
 
+/** Hosts arm this while forwarding pointer coords for entity hover (no Select tool). */
+export declare function setPickMode(enabled: boolean): void;
+
 export { setPosition }
 
 export { setPositionX }
@@ -6015,6 +6030,15 @@ declare class StageDebugDelegate {
     private parkToolVisuals;
     private disposeToolVisuals;
     update(): void;
+    /**
+     * Raycast at NDC coordinates (from a host that cannot send DOM pointer
+     * events, e.g. an overlay sitting on a preview iframe). Updates hover so
+     * the next `update()` paints the highlight.
+     */
+    pickAtNdc(ndcX: number, ndcY: number): {
+        uuid: string;
+        name: string;
+    } | null;
     /** Collider wireframes, straight from the wasm simulation. */
     private updateColliderWireframes;
     /**
@@ -6262,6 +6286,11 @@ declare class StageEntityDelegate {
      */
     destroyAll(): void;
     private registerBehaviorLinks;
+    /**
+     * Re-index an entity's behavior refs after a late `entity.use(...)`.
+     * Spawn-time registration only sees refs that existed at attach.
+     */
+    syncBehaviorLinks(entity: any): void;
     private unregisterBehaviorLinks;
 }