@zylem/game-lib 0.8.8 → 0.8.9

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

@@ -6,6 +6,7 @@
 
 import { abs } from 'three/tsl';
 import { announceBridgeReady } from '@zylem/bridge';
+import { applySwatchesToSelection } from '@zylem/bridge';
 import { asin } from 'three/tsl';
 import { atan } from 'three/tsl';
 import { BehaviorDescriptor } from '@zylem/behaviors';
@@ -34,6 +35,7 @@ import { BridgeHandler } from '@zylem/bridge';
 import { GameLoadingPayload as BridgeLoadingPayload } from '@zylem/bridge';
 import { BridgeMessages } from '@zylem/bridge';
 import { BridgeMessageType } from '@zylem/bridge';
+import { BridgeNdc } from '@zylem/bridge';
 import { BridgePose } from '@zylem/bridge';
 import { BridgeVec3 } from '@zylem/bridge';
 import { BufferGeometry } from 'three';
@@ -94,7 +96,10 @@ 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 { EntityPickPayload } from '@zylem/bridge';
+import { EntityPickResultPayload } from '@zylem/bridge';
 import { EntitySummaryPayload } from '@zylem/bridge';
+import { EntitySwatchAppliedPayload } from '@zylem/bridge';
 import { EntityThumbnailPayload } from '@zylem/bridge';
 import { EntityTypeDescriptor } from '@zylem/bridge';
 import { exp } from 'three/tsl';
@@ -282,6 +287,7 @@ import { RuntimeTriggerRegion2DEvent } from '@zylem/behaviors/runtime-2d';
 import { RuntimeTriggerRegion2DHandle } from '@zylem/behaviors/runtime-2d';
 import { RuntimeTriggerRegion2DOptions } from '@zylem/behaviors/runtime-2d';
 import { Scene } from 'three';
+import { SceneOperationEntry } from '@zylem/bridge';
 import { SceneOperationPayload } from '@zylem/bridge';
 import { ScreenVisibilityBehavior } from '@zylem/behaviors';
 import { ScreenVisibilityChangeContext } from '@zylem/behaviors';
@@ -342,6 +348,10 @@ import { StageSnapshotPayload } from '@zylem/bridge';
 import { StageTopDownPlane } from '@zylem/behaviors/core';
 import { Static } from '@sinclair/typebox';
 import { step } from 'three/tsl';
+import { SwatchApplyFailureReason } from '@zylem/bridge';
+import { SwatchApplyResult } from '@zylem/bridge';
+import { SwatchKind } from '@zylem/bridge';
+import { SwatchSpec } from '@zylem/bridge';
 import { Texture } from 'three';
 import * as three from 'three';
 import { ThrusterBehavior } from '@zylem/behaviors';
@@ -438,6 +448,8 @@ export interface AnalogState {
 
 export { announceBridgeReady }
 
+export { applySwatchesToSelection }
+
 // Warning: (ae-forgotten-export) The symbol "TransformableEntity" needs to be exported by the entry point public.d.ts
 //
 // @public
@@ -510,6 +522,8 @@ export { BridgeMessages }
 
 export { BridgeMessageType }
 
+export { BridgeNdc }
+
 export { BridgeVec3 }
 
 // @public
@@ -1164,6 +1178,10 @@ export const EntityJsonSchema: _sinclair_typebox.TUnion<[_sinclair_typebox.TObje
     data: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TUnknown>>;
 }>]>;
 
+export { EntityPickPayload }
+
+export { EntityPickResultPayload }
+
 // @public
 export const EntitySchema: _sinclair_typebox.TObject<{
     id: _sinclair_typebox.TString;
@@ -1179,6 +1197,8 @@ export function entitySpawner(factory: (x: number, y: number) => Promise<any> |
 
 export { EntitySummaryPayload }
 
+export { EntitySwatchAppliedPayload }
+
 // @public
 export class EntityThumbnailCache {
     constructor(size?: number, maxEntries?: number);
@@ -1485,8 +1505,11 @@ export class GameBridge {
 // @public
 export interface GameBridgeHost {
     applySceneOperation?(op: SceneOperationPayload, direction: 'undo' | 'redo'): void;
-    applySwatch?(payload: EntityApplySwatchPayload): void;
+    applySwatches?(payload: EntityApplySwatchPayload & {
+        opId: string;
+    }): SwatchApplyOutcome;
     createEntity?(typeId: string, props: Record<string, unknown> | undefined, pose: BridgePose | undefined): void;
+    pickEntity?(ndc: BridgeNdc): EntitySummaryPayload | null;
     resolveEntity(uuid: string): GameEntity<any> | null;
     setStageVariable?(key: string, value: unknown): void;
 }
@@ -1702,6 +1725,7 @@ export class GameEntity<O extends GameEntityOptions> extends BaseNode<O> impleme
     protected eventDelegate: EventEmitterDelegate<EntityEvents>;
     // (undocumented)
     finalizeCloneSupport(factory: (options?: Partial<O>) => GameEntity<O>): this;
+    getBehaviorRef<O extends Record<string, any>>(descriptor: BehaviorDescriptor_2<O, any>): BehaviorRef_2<O> | null;
     getBehaviorRefs(): BehaviorRef_2[];
     // (undocumented)
     getCollisionCallbacks(): Array<(params: CollisionContext<this, O>) => void>;
@@ -1709,6 +1733,7 @@ export class GameEntity<O extends GameEntityOptions> extends BaseNode<O> impleme
     //
     // (undocumented)
     getCollisionRegistrations(): Array<CollisionRegistration<this, O>>;
+    getMaterials(): Material[];
     getPose(): {
         position: Vec3;
         rotation: {
@@ -1727,6 +1752,9 @@ export class GameEntity<O extends GameEntityOptions> extends BaseNode<O> impleme
     getVelocity: () => Vector | null;
     // (undocumented)
     group: Group | undefined;
+    // (undocumented)
+    hasBehavior(descriptor: BehaviorDescriptor_2<any, any>): boolean;
+    hasMaterial(): boolean;
     instanceId: number;
     isBundled: boolean;
     isInstanced: boolean;
@@ -1762,8 +1790,13 @@ export class GameEntity<O extends GameEntityOptions> extends BaseNode<O> impleme
     // (undocumented)
     physicsAttached: boolean;
     physicsWorldRef: unknown;
+    removeBehavior(target: BehaviorDescriptor_2<any, any> | BehaviorRef_2<any>): BehaviorRef_2<any> | null;
+    replaceMaterials(materials: Material[], settings?: {
+        disposePrevious?: boolean;
+    }): Material[] | null;
     // (undocumented)
     resetVelocity: () => void;
+    restoreBehaviorRef(ref: BehaviorRef_2<any>): void;
     reveal(): void;
     // (undocumented)
     rotateEuler: (eulerRotation: Vector3) => void;
@@ -1780,6 +1813,10 @@ export class GameEntity<O extends GameEntityOptions> extends BaseNode<O> impleme
     runAction<A extends Action>(action: A): A;
     runtimeAttached: boolean;
     runtimeHandle: number;
+    // Warning: (ae-forgotten-export) The symbol "MaterialOptions" needs to be exported by the entry point public.d.ts
+    setMaterial(options: Partial<MaterialOptions>, settings?: {
+        disposePrevious?: boolean;
+    }): Material[] | null;
     setPose(input: {
         position?: Vec3Input;
         rotation?: {
@@ -3658,6 +3695,22 @@ export const standardShader: {
 
 export { step }
 
+export { SwatchApplyFailureReason }
+
+// @public
+export interface SwatchApplyOutcome {
+    // (undocumented)
+    entries: SceneOperationEntry[];
+    // (undocumented)
+    results: SwatchApplyResult[];
+}
+
+export { SwatchApplyResult }
+
+export { SwatchKind }
+
+export { SwatchSpec }
+
 // @public
 export interface TemplateFactory<E extends GameEntity<O>, O extends GameEntityOptions = GameEntityOptions> {
     generate(count: number): E[];
@@ -4823,16 +4876,15 @@ export class ZylemZone extends GameEntity<ZylemZoneOptions> implements Collision
 
 // Warnings were encountered during analysis:
 //
-// dist/entity-XZNGBeca.d.ts:332:5 - (ae-forgotten-export) The symbol "RenderCategory_2" needs to be exported by the entry point public.d.ts
-// dist/entity-XZNGBeca.d.ts:333:5 - (ae-forgotten-export) The symbol "RuntimeEntityOptions" needs to be exported by the entry point public.d.ts
-// dist/entity-XZNGBeca.d.ts:334:5 - (ae-forgotten-export) The symbol "CollisionOptions" needs to be exported by the entry point public.d.ts
-// dist/entity-XZNGBeca.d.ts:335:5 - (ae-forgotten-export) The symbol "MaterialOptions" needs to be exported by the entry point public.d.ts
-// dist/entity-XZNGBeca.d.ts:343:9 - (ae-forgotten-export) The symbol "IBuilder" needs to be exported by the entry point public.d.ts
-// 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-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
+// dist/entity-XqvuWgPm.d.ts:332:5 - (ae-forgotten-export) The symbol "RenderCategory_2" needs to be exported by the entry point public.d.ts
+// dist/entity-XqvuWgPm.d.ts:333:5 - (ae-forgotten-export) The symbol "RuntimeEntityOptions" needs to be exported by the entry point public.d.ts
+// dist/entity-XqvuWgPm.d.ts:334:5 - (ae-forgotten-export) The symbol "CollisionOptions" needs to be exported by the entry point public.d.ts
+// dist/entity-XqvuWgPm.d.ts:343:9 - (ae-forgotten-export) The symbol "IBuilder" needs to be exported by the entry point public.d.ts
+// dist/entity-XqvuWgPm.d.ts:343:9 - (ae-forgotten-export) The symbol "EntityMeshBuilder" needs to be exported by the entry point public.d.ts
+// dist/entity-XqvuWgPm.d.ts:344:9 - (ae-forgotten-export) The symbol "EntityCollisionBuilder" needs to be exported by the entry point public.d.ts
+// dist/entity-XqvuWgPm.d.ts:345:9 - (ae-forgotten-export) The symbol "MaterialBuilder" needs to be exported by the entry point public.d.ts
+// dist/game-DyKbOeck.d.ts:1097:5 - (ae-forgotten-export) The symbol "StageAssetLoaderConfig" needs to be exported by the entry point public.d.ts
+// dist/game-DyKbOeck.d.ts:1796: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

@@ -1,5 +1,6 @@
 import { abs } from 'three/tsl';
 import { announceBridgeReady } from '@zylem/bridge';
+import { applySwatchesToSelection } from '@zylem/bridge';
 import { asin } from 'three/tsl';
 import { atan } from 'three/tsl';
 import { BehaviorDescriptor } from '@zylem/behaviors';
@@ -28,6 +29,7 @@ import { BridgeHandler } from '@zylem/bridge';
 import { GameLoadingPayload as BridgeLoadingPayload } from '@zylem/bridge';
 import { BridgeMessages } from '@zylem/bridge';
 import { BridgeMessageType } from '@zylem/bridge';
+import { BridgeNdc } from '@zylem/bridge';
 import { BridgePose } from '@zylem/bridge';
 import { BridgeVec3 } from '@zylem/bridge';
 import { BufferGeometry } from 'three';
@@ -88,7 +90,10 @@ 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 { EntityPickPayload } from '@zylem/bridge';
+import { EntityPickResultPayload } from '@zylem/bridge';
 import { EntitySummaryPayload } from '@zylem/bridge';
+import { EntitySwatchAppliedPayload } from '@zylem/bridge';
 import { EntityThumbnailPayload } from '@zylem/bridge';
 import { EntityTypeDescriptor } from '@zylem/bridge';
 import { exp } from 'three/tsl';
@@ -276,6 +281,7 @@ import { RuntimeTriggerRegion2DEvent } from '@zylem/behaviors/runtime-2d';
 import { RuntimeTriggerRegion2DHandle } from '@zylem/behaviors/runtime-2d';
 import { RuntimeTriggerRegion2DOptions } from '@zylem/behaviors/runtime-2d';
 import { Scene } from 'three';
+import { SceneOperationEntry } from '@zylem/bridge';
 import { SceneOperationPayload } from '@zylem/bridge';
 import { ScreenVisibilityBehavior } from '@zylem/behaviors';
 import { ScreenVisibilityChangeContext } from '@zylem/behaviors';
@@ -336,6 +342,10 @@ import { StageSnapshotPayload } from '@zylem/bridge';
 import { StageTopDownPlane } from '@zylem/behaviors/core';
 import { Static } from '@sinclair/typebox';
 import { step } from 'three/tsl';
+import { SwatchApplyFailureReason } from '@zylem/bridge';
+import { SwatchApplyResult } from '@zylem/bridge';
+import { SwatchKind } from '@zylem/bridge';
+import { SwatchSpec } from '@zylem/bridge';
 import { Texture } from 'three';
 import * as three from 'three';
 import { ThrusterBehavior } from '@zylem/behaviors';
@@ -471,6 +481,8 @@ export { announceBridgeReady }
 
 declare type AnyNode = NodeLike | Promise<NodeLike>;
 
+export { applySwatchesToSelection }
+
 /**
  * Apply accumulated transformations from the store to the physics body.
  *
@@ -724,6 +736,8 @@ export { BridgeMessages }
 
 export { BridgeMessageType }
 
+export { BridgeNdc }
+
 export { BridgeVec3 }
 
 /** Cuboid collider sized as `size.xyz` (full extents — half-extents are computed). */
@@ -2104,6 +2118,10 @@ declare abstract class EntityMeshBuilder extends MeshBuilder {
     postBuild(): void;
 }
 
+export { EntityPickPayload }
+
+export { EntityPickResultPayload }
+
 /**
  * Runtime entity blueprint (open `data` for factory spreading).
  * Prefer {@link EntityJsonSchema} for editor / Monaco JSON Schema.
@@ -2134,6 +2152,8 @@ export declare function entitySpawner(factory: (x: number, y: number) => Promise
 
 export { EntitySummaryPayload }
 
+export { EntitySwatchAppliedPayload }
+
 /**
  * Generates and caches entity thumbnail previews for the editor entity list.
  * Renders a cloned Object3D into an offscreen RenderTarget on the shared WebGPU renderer.
@@ -2616,6 +2636,15 @@ export declare class GameBridge {
      */
     connect(host: GameBridgeHost, announceTarget?: EventTarget): void;
     disconnect(): void;
+    /**
+     * Run a swatch batch and report back.
+     *
+     * Order matters for the consumer: selection changes first (so a following
+     * `entity:selection` describes the new targets), then the undo record, then
+     * the ack — a consumer that persists on `ok` sees the operation already on
+     * the stack.
+     */
+    private handleApplySwatch;
     /**
      * Publish only the parts of `debugState` the editor does not already know.
      * Values that arrived as editor commands are recorded on `editorKnown`
@@ -2708,8 +2737,19 @@ 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;
+    /**
+     * Raycast at normalized device coordinates and describe the entity hit
+     * (`entity:pick`). Hover should follow the pick only while pick mode is on.
+     */
+    pickEntity?(ndc: BridgeNdc): EntitySummaryPayload | null;
+    /**
+     * Apply every swatch to every uuid (`entity:apply-swatch`). Must report one
+     * result per uuid × swatch pair and return a `scene:operation` entry for
+     * each success so the batch is undoable as a single step.
+     */
+    applySwatches?(payload: EntityApplySwatchPayload & {
+        opId: string;
+    }): SwatchApplyOutcome;
 }
 
 /**
@@ -3164,6 +3204,30 @@ export declare class GameEntity<O extends GameEntityOptions> extends BaseNode<O>
      * Used by the stage to auto-register required systems.
      */
     getBehaviorRefs(): BehaviorRef_2[];
+    /**
+     * Find the attached ref for a behavior, matched by descriptor key so a
+     * re-imported copy of the same descriptor still resolves.
+     */
+    getBehaviorRef<O extends Record<string, any>>(descriptor: BehaviorDescriptor_2<O, any>): BehaviorRef_2<O> | null;
+    hasBehavior(descriptor: BehaviorDescriptor_2<any, any>): boolean;
+    /**
+     * Detach a behavior from this entity.
+     *
+     * Removes the ref so future spawns skip it. If the entity is live in a
+     * stage, the stage must also drop the system link (see
+     * `StageEntityDelegate.detachBehaviorLink`); `StageDebugDelegate` does this
+     * for editor-driven removals.
+     *
+     * @param target The descriptor (matched by key) or the exact ref to remove.
+     * @returns The removed ref, or `null` when nothing matched.
+     */
+    removeBehavior(target: BehaviorDescriptor_2<any, any> | BehaviorRef_2<any>): BehaviorRef_2<any> | null;
+    /**
+     * Re-attach a previously removed ref as-is (options, FSM state and all).
+     * Used by undo so a restored behavior is the same object, not a re-created
+     * one.
+     */
+    restoreBehaviorRef(ref: BehaviorRef_2<any>): void;
     getCollisionCallbacks(): Array<(params: CollisionContext<this, O>) => void>;
     getCollisionRegistrations(): Array<CollisionRegistration<this, O>>;
     private copyBehaviorRefsTo;
@@ -3194,6 +3258,36 @@ export declare class GameEntity<O extends GameEntityOptions> extends BaseNode<O>
      */
     protected _cleanup(_params: CleanupContext<this>): void;
     _collision(other: GameEntity<O>, globals?: any, dispatch?: CollisionDispatchMetadata): void;
+    /**
+     * Whether this entity renders a mesh that a material can be assigned to.
+     * Lights, zones, and other mesh-less entities return `false`.
+     */
+    hasMaterial(): boolean;
+    /** The materials currently driving this entity's meshes. */
+    getMaterials(): Material[];
+    /**
+     * Rebuild this entity's material from creation-style options and swap it in
+     * on the live mesh, so a runtime change (an editor applying a shader swatch)
+     * renders exactly like a restart with `material: options` would.
+     *
+     * @param options Same shape as `GameEntityOptions.material`.
+     * @param settings `disposePrevious` (default `true`) frees the replaced
+     *   materials; pass `false` when keeping them for undo.
+     * @returns The replaced materials, or `null` when the entity has no mesh.
+     */
+    setMaterial(options: Partial<MaterialOptions>, settings?: {
+        disposePrevious?: boolean;
+    }): Material[] | null;
+    /**
+     * Assign already-built materials to every mesh this entity renders. Meshes
+     * that carried a material array keep the array shape, cycling through the
+     * supplied list so multi-material geometry stays fully covered.
+     *
+     * @returns The replaced materials, or `null` when the entity has no mesh.
+     */
+    replaceMaterials(materials: Material[], settings?: {
+        disposePrevious?: boolean;
+    }): Material[] | null;
     protected updateMaterials(params: any): void;
     buildInfo(): Record<string, string>;
     /**
@@ -5974,6 +6068,7 @@ declare class StageDebugDelegate {
     private lastDebugEnabled;
     private warnedMissingAddFactory;
     private transformTool;
+    private swatchApplier;
     private grid;
     private lastTool;
     /** Element the current gizmo drag captured, so pointerup is never missed. */
@@ -6032,13 +6127,27 @@ declare class StageDebugDelegate {
     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.
+     * events, e.g. an overlay sitting on a preview iframe, or the bridge's
+     * `entity:pick`).
+     *
+     * Hover follows the pick only while pick mode is armed (a drag in flight),
+     * so a one-shot pick from an inspector does not disturb the user's hover.
+     * While armed, the next `update()` paints the highlight.
      */
-    pickAtNdc(ndcX: number, ndcY: number): {
+    pickAtNdc(ndcX: number, ndcY: number, options?: {
+        updateHover?: boolean;
+    }): {
         uuid: string;
         name: string;
     } | null;
+    /**
+     * Apply swatches to live entities (`entity:apply-swatch`). Every uuid ×
+     * swatch pair is attempted and reported; successful pairs are recorded so
+     * the operation can be undone exactly via {@link applySceneOperation}.
+     */
+    applySwatches(payload: EntityApplySwatchPayload & {
+        opId: string;
+    }): SwatchApplyOutcome_2;
     /** Collider wireframes, straight from the wasm simulation. */
     private updateColliderWireframes;
     /**
@@ -6286,11 +6395,35 @@ declare class StageEntityDelegate {
      */
     destroyAll(): void;
     private registerBehaviorLinks;
+    /**
+     * Index one ref, lazily create its system, and attach. Shared by spawn-time
+     * registration and late per-ref attaches.
+     */
+    private linkBehaviorRef;
+    private unlinkBehaviorLink;
     /**
      * Re-index an entity's behavior refs after a late `entity.use(...)`.
      * Spawn-time registration only sees refs that existed at attach.
+     *
+     * Detaches and re-attaches every behavior on the entity, which resets their
+     * per-link state. Prefer {@link attachBehaviorLink} /
+     * {@link detachBehaviorLink} when only one ref changed.
      */
     syncBehaviorLinks(entity: any): void;
+    /**
+     * Attach a single ref that was added to a live entity (`entity.use(...)`
+     * after spawn) without disturbing the entity's other behaviors.
+     *
+     * @returns `false` when the stage is not loaded or the ref is already linked.
+     */
+    attachBehaviorLink(entity: any, ref: BehaviorRef_2): boolean;
+    /**
+     * Detach a single ref's system link from a live entity, leaving its other
+     * behaviors attached.
+     *
+     * @returns `false` when no link for that ref exists.
+     */
+    detachBehaviorLink(entity: any, ref: BehaviorRef_2): boolean;
     private unregisterBehaviorLinks;
 }
 
@@ -6611,6 +6744,42 @@ export declare const standardShader: {
 
 export { step }
 
+export { SwatchApplyFailureReason }
+
+/** What a host reports back from a swatch batch. */
+export declare interface SwatchApplyOutcome {
+    results: SwatchApplyResult[];
+    entries: SceneOperationEntry[];
+}
+
+/**
+ * Applies swatches (configured shaders / behaviors) to live entities and
+ * inverts those applications for undo.
+ *
+ * One `entity:apply-swatch` message is a batch: every swatch is applied to
+ * every uuid, in order, under a single operation id. Each pair reports its own
+ * result so a multi-select apply can partially succeed (a light in the
+ * selection has no material) while the rest still land.
+ *
+ * Undo follows the stage's "editor holds the history, game holds the
+ * instances" rule. The original material and any displaced behavior refs are
+ * kept here per operation, so undo puts back the exact objects rather than a
+ * reconstruction — the pre-swatch material (texture, tint, standard shader) is
+ * usually not describable as a swatch at all.
+ */
+
+declare interface SwatchApplyOutcome_2 {
+    results: SwatchApplyResult[];
+    /** One entry per successful pair, ready for a `scene:operation`. */
+    entries: SceneOperationEntry[];
+}
+
+export { SwatchApplyResult }
+
+export { SwatchKind }
+
+export { SwatchSpec }
+
 /**
  * Factory interface for generating entity copies
  */
@@ -8276,6 +8445,12 @@ declare class ZylemGame<TGlobals extends BaseGlobals> {
     static FRAME_DURATION: number;
     static MAX_DELTA_SECONDS: number;
     constructor(options: ZylemGameOptions<TGlobals>, wrapperRef: Game<TGlobals>, displayRuntime?: ResolveGameConfigRuntime);
+    /**
+     * Raycast at normalized device coordinates (editor `entity:pick`) and
+     * describe the hit the same way the entity list does, so a consumer can
+     * show name, type, and pose for whatever is under the pointer.
+     */
+    private pickEntityAtNdc;
     /** Publish the placeable entity types the editor's Add palette lists. */
     private publishEntityCatalog;
     /** Spawn a catalog type programmatically (editor `entity:create`). */