@zylem/game-lib 0.8.8 → 0.9.0

package/dist/cutscene-definition-C479fkei.d.ts

@@ -0,0 +1,509 @@
+import * as _sinclair_typebox from '@sinclair/typebox';
+import { Static } from '@sinclair/typebox';
+
+/**
+ * TypeBox schema for a cutscene the cinematics module can play: a timeline in
+ * seconds split into scenes, cameras (static, dolly along a spline, or
+ * following an entity) placed on camera tracks as shots, camera keyframes,
+ * and event/audio tracks that fire gameplay hooks at points in time.
+ *
+ * Creator's Director mode authors `.cutscene.json` documents that strip down
+ * to this shape (`toRuntimeCutscene` in `@zylem-creator/shared`).
+ */
+declare const Vec3Schema: _sinclair_typebox.TObject<{
+    x: _sinclair_typebox.TNumber;
+    y: _sinclair_typebox.TNumber;
+    z: _sinclair_typebox.TNumber;
+}>;
+type Vec3Def = Static<typeof Vec3Schema>;
+declare const CutsceneEasingSchema: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"linear">, _sinclair_typebox.TLiteral<"easeIn">, _sinclair_typebox.TLiteral<"easeOut">, _sinclair_typebox.TLiteral<"easeInOut">]>;
+type CutsceneEasing = Static<typeof CutsceneEasingSchema>;
+declare const SceneTransitionTypeSchema: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"cut">, _sinclair_typebox.TLiteral<"fade">, _sinclair_typebox.TLiteral<"wipe">, _sinclair_typebox.TLiteral<"radial">, _sinclair_typebox.TLiteral<"noise">, _sinclair_typebox.TLiteral<"cells">]>;
+type SceneTransitionType = Static<typeof SceneTransitionTypeSchema>;
+declare const SceneTransitionSchema: _sinclair_typebox.TObject<{
+    type: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"cut">, _sinclair_typebox.TLiteral<"fade">, _sinclair_typebox.TLiteral<"wipe">, _sinclair_typebox.TLiteral<"radial">, _sinclair_typebox.TLiteral<"noise">, _sinclair_typebox.TLiteral<"cells">]>;
+    /** Seconds; ignored for `cut`. */
+    duration: _sinclair_typebox.TNumber;
+    easing: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"linear">, _sinclair_typebox.TLiteral<"easeIn">, _sinclair_typebox.TLiteral<"easeOut">, _sinclair_typebox.TLiteral<"easeInOut">]>;
+}>;
+type SceneTransition = Static<typeof SceneTransitionSchema>;
+declare const CutsceneSceneSchema: _sinclair_typebox.TObject<{
+    id: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TString;
+    /** Seconds from the cutscene start. */
+    start: _sinclair_typebox.TNumber;
+    end: _sinclair_typebox.TNumber;
+    /** How the picture arrives at this scene's start. */
+    transitionIn: _sinclair_typebox.TObject<{
+        type: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"cut">, _sinclair_typebox.TLiteral<"fade">, _sinclair_typebox.TLiteral<"wipe">, _sinclair_typebox.TLiteral<"radial">, _sinclair_typebox.TLiteral<"noise">, _sinclair_typebox.TLiteral<"cells">]>;
+        /** Seconds; ignored for `cut`. */
+        duration: _sinclair_typebox.TNumber;
+        easing: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"linear">, _sinclair_typebox.TLiteral<"easeIn">, _sinclair_typebox.TLiteral<"easeOut">, _sinclair_typebox.TLiteral<"easeInOut">]>;
+    }>;
+}>;
+type CutsceneScene = Static<typeof CutsceneSceneSchema>;
+declare const CameraPoseDefSchema: _sinclair_typebox.TObject<{
+    position: _sinclair_typebox.TObject<{
+        x: _sinclair_typebox.TNumber;
+        y: _sinclair_typebox.TNumber;
+        z: _sinclair_typebox.TNumber;
+    }>;
+    lookAt: _sinclair_typebox.TObject<{
+        x: _sinclair_typebox.TNumber;
+        y: _sinclair_typebox.TNumber;
+        z: _sinclair_typebox.TNumber;
+    }>;
+}>;
+type CameraPoseDef = Static<typeof CameraPoseDefSchema>;
+declare const CameraKeyframeSchema: _sinclair_typebox.TObject<{
+    id: _sinclair_typebox.TString;
+    /** Seconds from the cutscene start. */
+    time: _sinclair_typebox.TNumber;
+    position: _sinclair_typebox.TOptional<_sinclair_typebox.TObject<{
+        x: _sinclair_typebox.TNumber;
+        y: _sinclair_typebox.TNumber;
+        z: _sinclair_typebox.TNumber;
+    }>>;
+    lookAt: _sinclair_typebox.TOptional<_sinclair_typebox.TObject<{
+        x: _sinclair_typebox.TNumber;
+        y: _sinclair_typebox.TNumber;
+        z: _sinclair_typebox.TNumber;
+    }>>;
+    fov: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+    /** Easing used to arrive at this keyframe from the previous one. */
+    easing: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"linear">, _sinclair_typebox.TLiteral<"easeIn">, _sinclair_typebox.TLiteral<"easeOut">, _sinclair_typebox.TLiteral<"easeInOut">]>;
+}>;
+type CameraKeyframe = Static<typeof CameraKeyframeSchema>;
+declare const CutsceneCameraKindSchema: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"static">, _sinclair_typebox.TLiteral<"dolly">, _sinclair_typebox.TLiteral<"follow">]>;
+type CutsceneCameraKind = Static<typeof CutsceneCameraKindSchema>;
+declare const CutsceneCameraSchema: _sinclair_typebox.TObject<{
+    id: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TString;
+    kind: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"static">, _sinclair_typebox.TLiteral<"dolly">, _sinclair_typebox.TLiteral<"follow">]>;
+    /** Vertical field of view in degrees. */
+    fov: _sinclair_typebox.TNumber;
+    /** Base pose; `static` cameras hold it, keyframes and dollies start from it. */
+    pose: _sinclair_typebox.TObject<{
+        position: _sinclair_typebox.TObject<{
+            x: _sinclair_typebox.TNumber;
+            y: _sinclair_typebox.TNumber;
+            z: _sinclair_typebox.TNumber;
+        }>;
+        lookAt: _sinclair_typebox.TObject<{
+            x: _sinclair_typebox.TNumber;
+            y: _sinclair_typebox.TNumber;
+            z: _sinclair_typebox.TNumber;
+        }>;
+    }>;
+    /** `dolly` cameras ride this path over each shot. */
+    dollyId: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+    /** Progress curve along the dolly path (0 → 1 over the shot). */
+    dollyEasing: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"linear">, _sinclair_typebox.TLiteral<"easeIn">, _sinclair_typebox.TLiteral<"easeOut">, _sinclair_typebox.TLiteral<"easeInOut">]>;
+    /** Entity name a `follow` camera tracks, and what a dolly looks at when set. */
+    target: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+    /** Offset from the target for `follow` cameras. */
+    offset: _sinclair_typebox.TOptional<_sinclair_typebox.TObject<{
+        x: _sinclair_typebox.TNumber;
+        y: _sinclair_typebox.TNumber;
+        z: _sinclair_typebox.TNumber;
+    }>>;
+    /** Smoothing for `follow` cameras, 0 (instant) … 1 (very slow). */
+    damping: _sinclair_typebox.TNumber;
+    keyframes: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TString;
+        /** Seconds from the cutscene start. */
+        time: _sinclair_typebox.TNumber;
+        position: _sinclair_typebox.TOptional<_sinclair_typebox.TObject<{
+            x: _sinclair_typebox.TNumber;
+            y: _sinclair_typebox.TNumber;
+            z: _sinclair_typebox.TNumber;
+        }>>;
+        lookAt: _sinclair_typebox.TOptional<_sinclair_typebox.TObject<{
+            x: _sinclair_typebox.TNumber;
+            y: _sinclair_typebox.TNumber;
+            z: _sinclair_typebox.TNumber;
+        }>>;
+        fov: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+        /** Easing used to arrive at this keyframe from the previous one. */
+        easing: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"linear">, _sinclair_typebox.TLiteral<"easeIn">, _sinclair_typebox.TLiteral<"easeOut">, _sinclair_typebox.TLiteral<"easeInOut">]>;
+    }>>;
+}>;
+type CutsceneCamera = Static<typeof CutsceneCameraSchema>;
+declare const DollyPathSchema: _sinclair_typebox.TObject<{
+    id: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TString;
+    points: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        x: _sinclair_typebox.TNumber;
+        y: _sinclair_typebox.TNumber;
+        z: _sinclair_typebox.TNumber;
+    }>>;
+    closed: _sinclair_typebox.TBoolean;
+    /** Catmull-Rom tension; 0.5 is centripetal. */
+    tension: _sinclair_typebox.TNumber;
+}>;
+type DollyPath = Static<typeof DollyPathSchema>;
+declare const ShotBlendSchema: _sinclair_typebox.TObject<{
+    /** Seconds spent blending from the previous shot's camera; 0 is a hard cut. */
+    duration: _sinclair_typebox.TNumber;
+    easing: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"linear">, _sinclair_typebox.TLiteral<"easeIn">, _sinclair_typebox.TLiteral<"easeOut">, _sinclair_typebox.TLiteral<"easeInOut">]>;
+}>;
+type ShotBlend = Static<typeof ShotBlendSchema>;
+declare const CameraShotSchema: _sinclair_typebox.TObject<{
+    id: _sinclair_typebox.TString;
+    cameraId: _sinclair_typebox.TString;
+    start: _sinclair_typebox.TNumber;
+    end: _sinclair_typebox.TNumber;
+    blend: _sinclair_typebox.TObject<{
+        /** Seconds spent blending from the previous shot's camera; 0 is a hard cut. */
+        duration: _sinclair_typebox.TNumber;
+        easing: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"linear">, _sinclair_typebox.TLiteral<"easeIn">, _sinclair_typebox.TLiteral<"easeOut">, _sinclair_typebox.TLiteral<"easeInOut">]>;
+    }>;
+}>;
+type CameraShot = Static<typeof CameraShotSchema>;
+declare const CutsceneEventSchema: _sinclair_typebox.TUnion<[_sinclair_typebox.TObject<{
+    type: _sinclair_typebox.TLiteral<"emit">;
+    /** Stage event name. */
+    name: _sinclair_typebox.TString;
+    payload: _sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TUnion<[_sinclair_typebox.TString, _sinclair_typebox.TNumber, _sinclair_typebox.TBoolean]>>;
+}>, _sinclair_typebox.TObject<{
+    type: _sinclair_typebox.TLiteral<"playAnimation">;
+    /** Entity name. */
+    entity: _sinclair_typebox.TString;
+    /** Animation key as passed to `playAnimation({ key })`. */
+    key: _sinclair_typebox.TString;
+}>, _sinclair_typebox.TObject<{
+    type: _sinclair_typebox.TLiteral<"playSong">;
+    /** Song slug or URL; resolved by the host. */
+    song: _sinclair_typebox.TString;
+    loop: _sinclair_typebox.TBoolean;
+}>, _sinclair_typebox.TObject<{
+    type: _sinclair_typebox.TLiteral<"stopSong">;
+    song: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+}>, _sinclair_typebox.TObject<{
+    type: _sinclair_typebox.TLiteral<"setVariable">;
+    name: _sinclair_typebox.TString;
+    value: _sinclair_typebox.TUnion<[_sinclair_typebox.TString, _sinclair_typebox.TNumber, _sinclair_typebox.TBoolean]>;
+}>]>;
+type CutsceneEvent = Static<typeof CutsceneEventSchema>;
+declare const EventItemSchema: _sinclair_typebox.TObject<{
+    id: _sinclair_typebox.TString;
+    time: _sinclair_typebox.TNumber;
+    event: _sinclair_typebox.TUnion<[_sinclair_typebox.TObject<{
+        type: _sinclair_typebox.TLiteral<"emit">;
+        /** Stage event name. */
+        name: _sinclair_typebox.TString;
+        payload: _sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TUnion<[_sinclair_typebox.TString, _sinclair_typebox.TNumber, _sinclair_typebox.TBoolean]>>;
+    }>, _sinclair_typebox.TObject<{
+        type: _sinclair_typebox.TLiteral<"playAnimation">;
+        /** Entity name. */
+        entity: _sinclair_typebox.TString;
+        /** Animation key as passed to `playAnimation({ key })`. */
+        key: _sinclair_typebox.TString;
+    }>, _sinclair_typebox.TObject<{
+        type: _sinclair_typebox.TLiteral<"playSong">;
+        /** Song slug or URL; resolved by the host. */
+        song: _sinclair_typebox.TString;
+        loop: _sinclair_typebox.TBoolean;
+    }>, _sinclair_typebox.TObject<{
+        type: _sinclair_typebox.TLiteral<"stopSong">;
+        song: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+    }>, _sinclair_typebox.TObject<{
+        type: _sinclair_typebox.TLiteral<"setVariable">;
+        name: _sinclair_typebox.TString;
+        value: _sinclair_typebox.TUnion<[_sinclair_typebox.TString, _sinclair_typebox.TNumber, _sinclair_typebox.TBoolean]>;
+    }>]>;
+}>;
+type EventItem = Static<typeof EventItemSchema>;
+declare const AudioItemSchema: _sinclair_typebox.TObject<{
+    id: _sinclair_typebox.TString;
+    time: _sinclair_typebox.TNumber;
+    kind: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"song">, _sinclair_typebox.TLiteral<"sfx">]>;
+    /** Song slug for `song`, asset URL for `sfx`. */
+    ref: _sinclair_typebox.TString;
+    loop: _sinclair_typebox.TBoolean;
+    /** Gain in dB. */
+    volume: _sinclair_typebox.TNumber;
+}>;
+type AudioItem = Static<typeof AudioItemSchema>;
+declare const CameraTrackSchema: _sinclair_typebox.TObject<{
+    kind: _sinclair_typebox.TLiteral<"camera">;
+    id: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TString;
+    items: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TString;
+        cameraId: _sinclair_typebox.TString;
+        start: _sinclair_typebox.TNumber;
+        end: _sinclair_typebox.TNumber;
+        blend: _sinclair_typebox.TObject<{
+            /** Seconds spent blending from the previous shot's camera; 0 is a hard cut. */
+            duration: _sinclair_typebox.TNumber;
+            easing: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"linear">, _sinclair_typebox.TLiteral<"easeIn">, _sinclair_typebox.TLiteral<"easeOut">, _sinclair_typebox.TLiteral<"easeInOut">]>;
+        }>;
+    }>>;
+}>;
+declare const EventTrackSchema: _sinclair_typebox.TObject<{
+    kind: _sinclair_typebox.TLiteral<"event">;
+    id: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TString;
+    items: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TString;
+        time: _sinclair_typebox.TNumber;
+        event: _sinclair_typebox.TUnion<[_sinclair_typebox.TObject<{
+            type: _sinclair_typebox.TLiteral<"emit">;
+            /** Stage event name. */
+            name: _sinclair_typebox.TString;
+            payload: _sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TUnion<[_sinclair_typebox.TString, _sinclair_typebox.TNumber, _sinclair_typebox.TBoolean]>>;
+        }>, _sinclair_typebox.TObject<{
+            type: _sinclair_typebox.TLiteral<"playAnimation">;
+            /** Entity name. */
+            entity: _sinclair_typebox.TString;
+            /** Animation key as passed to `playAnimation({ key })`. */
+            key: _sinclair_typebox.TString;
+        }>, _sinclair_typebox.TObject<{
+            type: _sinclair_typebox.TLiteral<"playSong">;
+            /** Song slug or URL; resolved by the host. */
+            song: _sinclair_typebox.TString;
+            loop: _sinclair_typebox.TBoolean;
+        }>, _sinclair_typebox.TObject<{
+            type: _sinclair_typebox.TLiteral<"stopSong">;
+            song: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+        }>, _sinclair_typebox.TObject<{
+            type: _sinclair_typebox.TLiteral<"setVariable">;
+            name: _sinclair_typebox.TString;
+            value: _sinclair_typebox.TUnion<[_sinclair_typebox.TString, _sinclair_typebox.TNumber, _sinclair_typebox.TBoolean]>;
+        }>]>;
+    }>>;
+}>;
+declare const AudioTrackSchema: _sinclair_typebox.TObject<{
+    kind: _sinclair_typebox.TLiteral<"audio">;
+    id: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TString;
+    items: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TString;
+        time: _sinclair_typebox.TNumber;
+        kind: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"song">, _sinclair_typebox.TLiteral<"sfx">]>;
+        /** Song slug for `song`, asset URL for `sfx`. */
+        ref: _sinclair_typebox.TString;
+        loop: _sinclair_typebox.TBoolean;
+        /** Gain in dB. */
+        volume: _sinclair_typebox.TNumber;
+    }>>;
+}>;
+declare const CutsceneTrackSchema: _sinclair_typebox.TUnion<[_sinclair_typebox.TObject<{
+    kind: _sinclair_typebox.TLiteral<"camera">;
+    id: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TString;
+    items: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TString;
+        cameraId: _sinclair_typebox.TString;
+        start: _sinclair_typebox.TNumber;
+        end: _sinclair_typebox.TNumber;
+        blend: _sinclair_typebox.TObject<{
+            /** Seconds spent blending from the previous shot's camera; 0 is a hard cut. */
+            duration: _sinclair_typebox.TNumber;
+            easing: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"linear">, _sinclair_typebox.TLiteral<"easeIn">, _sinclair_typebox.TLiteral<"easeOut">, _sinclair_typebox.TLiteral<"easeInOut">]>;
+        }>;
+    }>>;
+}>, _sinclair_typebox.TObject<{
+    kind: _sinclair_typebox.TLiteral<"event">;
+    id: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TString;
+    items: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TString;
+        time: _sinclair_typebox.TNumber;
+        event: _sinclair_typebox.TUnion<[_sinclair_typebox.TObject<{
+            type: _sinclair_typebox.TLiteral<"emit">;
+            /** Stage event name. */
+            name: _sinclair_typebox.TString;
+            payload: _sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TUnion<[_sinclair_typebox.TString, _sinclair_typebox.TNumber, _sinclair_typebox.TBoolean]>>;
+        }>, _sinclair_typebox.TObject<{
+            type: _sinclair_typebox.TLiteral<"playAnimation">;
+            /** Entity name. */
+            entity: _sinclair_typebox.TString;
+            /** Animation key as passed to `playAnimation({ key })`. */
+            key: _sinclair_typebox.TString;
+        }>, _sinclair_typebox.TObject<{
+            type: _sinclair_typebox.TLiteral<"playSong">;
+            /** Song slug or URL; resolved by the host. */
+            song: _sinclair_typebox.TString;
+            loop: _sinclair_typebox.TBoolean;
+        }>, _sinclair_typebox.TObject<{
+            type: _sinclair_typebox.TLiteral<"stopSong">;
+            song: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+        }>, _sinclair_typebox.TObject<{
+            type: _sinclair_typebox.TLiteral<"setVariable">;
+            name: _sinclair_typebox.TString;
+            value: _sinclair_typebox.TUnion<[_sinclair_typebox.TString, _sinclair_typebox.TNumber, _sinclair_typebox.TBoolean]>;
+        }>]>;
+    }>>;
+}>, _sinclair_typebox.TObject<{
+    kind: _sinclair_typebox.TLiteral<"audio">;
+    id: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TString;
+    items: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TString;
+        time: _sinclair_typebox.TNumber;
+        kind: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"song">, _sinclair_typebox.TLiteral<"sfx">]>;
+        /** Song slug for `song`, asset URL for `sfx`. */
+        ref: _sinclair_typebox.TString;
+        loop: _sinclair_typebox.TBoolean;
+        /** Gain in dB. */
+        volume: _sinclair_typebox.TNumber;
+    }>>;
+}>]>;
+type CameraTrack = Static<typeof CameraTrackSchema>;
+type EventTrack = Static<typeof EventTrackSchema>;
+type AudioTrack = Static<typeof AudioTrackSchema>;
+type CutsceneTrack = Static<typeof CutsceneTrackSchema>;
+declare const CutsceneDefinitionSchema: _sinclair_typebox.TObject<{
+    id: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TString;
+    /** Seconds. */
+    duration: _sinclair_typebox.TNumber;
+    /** Stage the cutscene was authored against; informational. */
+    stage: _sinclair_typebox.TUnion<[_sinclair_typebox.TString, _sinclair_typebox.TNull]>;
+    skippable: _sinclair_typebox.TBoolean;
+    scenes: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TString;
+        name: _sinclair_typebox.TString;
+        /** Seconds from the cutscene start. */
+        start: _sinclair_typebox.TNumber;
+        end: _sinclair_typebox.TNumber;
+        /** How the picture arrives at this scene's start. */
+        transitionIn: _sinclair_typebox.TObject<{
+            type: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"cut">, _sinclair_typebox.TLiteral<"fade">, _sinclair_typebox.TLiteral<"wipe">, _sinclair_typebox.TLiteral<"radial">, _sinclair_typebox.TLiteral<"noise">, _sinclair_typebox.TLiteral<"cells">]>;
+            /** Seconds; ignored for `cut`. */
+            duration: _sinclair_typebox.TNumber;
+            easing: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"linear">, _sinclair_typebox.TLiteral<"easeIn">, _sinclair_typebox.TLiteral<"easeOut">, _sinclair_typebox.TLiteral<"easeInOut">]>;
+        }>;
+    }>>;
+    cameras: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TString;
+        name: _sinclair_typebox.TString;
+        kind: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"static">, _sinclair_typebox.TLiteral<"dolly">, _sinclair_typebox.TLiteral<"follow">]>;
+        /** Vertical field of view in degrees. */
+        fov: _sinclair_typebox.TNumber;
+        /** Base pose; `static` cameras hold it, keyframes and dollies start from it. */
+        pose: _sinclair_typebox.TObject<{
+            position: _sinclair_typebox.TObject<{
+                x: _sinclair_typebox.TNumber;
+                y: _sinclair_typebox.TNumber;
+                z: _sinclair_typebox.TNumber;
+            }>;
+            lookAt: _sinclair_typebox.TObject<{
+                x: _sinclair_typebox.TNumber;
+                y: _sinclair_typebox.TNumber;
+                z: _sinclair_typebox.TNumber;
+            }>;
+        }>;
+        /** `dolly` cameras ride this path over each shot. */
+        dollyId: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+        /** Progress curve along the dolly path (0 → 1 over the shot). */
+        dollyEasing: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"linear">, _sinclair_typebox.TLiteral<"easeIn">, _sinclair_typebox.TLiteral<"easeOut">, _sinclair_typebox.TLiteral<"easeInOut">]>;
+        /** Entity name a `follow` camera tracks, and what a dolly looks at when set. */
+        target: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+        /** Offset from the target for `follow` cameras. */
+        offset: _sinclair_typebox.TOptional<_sinclair_typebox.TObject<{
+            x: _sinclair_typebox.TNumber;
+            y: _sinclair_typebox.TNumber;
+            z: _sinclair_typebox.TNumber;
+        }>>;
+        /** Smoothing for `follow` cameras, 0 (instant) … 1 (very slow). */
+        damping: _sinclair_typebox.TNumber;
+        keyframes: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+            id: _sinclair_typebox.TString;
+            /** Seconds from the cutscene start. */
+            time: _sinclair_typebox.TNumber;
+            position: _sinclair_typebox.TOptional<_sinclair_typebox.TObject<{
+                x: _sinclair_typebox.TNumber;
+                y: _sinclair_typebox.TNumber;
+                z: _sinclair_typebox.TNumber;
+            }>>;
+            lookAt: _sinclair_typebox.TOptional<_sinclair_typebox.TObject<{
+                x: _sinclair_typebox.TNumber;
+                y: _sinclair_typebox.TNumber;
+                z: _sinclair_typebox.TNumber;
+            }>>;
+            fov: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+            /** Easing used to arrive at this keyframe from the previous one. */
+            easing: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"linear">, _sinclair_typebox.TLiteral<"easeIn">, _sinclair_typebox.TLiteral<"easeOut">, _sinclair_typebox.TLiteral<"easeInOut">]>;
+        }>>;
+    }>>;
+    dollies: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TString;
+        name: _sinclair_typebox.TString;
+        points: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+            x: _sinclair_typebox.TNumber;
+            y: _sinclair_typebox.TNumber;
+            z: _sinclair_typebox.TNumber;
+        }>>;
+        closed: _sinclair_typebox.TBoolean;
+        /** Catmull-Rom tension; 0.5 is centripetal. */
+        tension: _sinclair_typebox.TNumber;
+    }>>;
+    tracks: _sinclair_typebox.TArray<_sinclair_typebox.TUnion<[_sinclair_typebox.TObject<{
+        kind: _sinclair_typebox.TLiteral<"camera">;
+        id: _sinclair_typebox.TString;
+        name: _sinclair_typebox.TString;
+        items: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+            id: _sinclair_typebox.TString;
+            cameraId: _sinclair_typebox.TString;
+            start: _sinclair_typebox.TNumber;
+            end: _sinclair_typebox.TNumber;
+            blend: _sinclair_typebox.TObject<{
+                /** Seconds spent blending from the previous shot's camera; 0 is a hard cut. */
+                duration: _sinclair_typebox.TNumber;
+                easing: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"linear">, _sinclair_typebox.TLiteral<"easeIn">, _sinclair_typebox.TLiteral<"easeOut">, _sinclair_typebox.TLiteral<"easeInOut">]>;
+            }>;
+        }>>;
+    }>, _sinclair_typebox.TObject<{
+        kind: _sinclair_typebox.TLiteral<"event">;
+        id: _sinclair_typebox.TString;
+        name: _sinclair_typebox.TString;
+        items: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+            id: _sinclair_typebox.TString;
+            time: _sinclair_typebox.TNumber;
+            event: _sinclair_typebox.TUnion<[_sinclair_typebox.TObject<{
+                type: _sinclair_typebox.TLiteral<"emit">;
+                /** Stage event name. */
+                name: _sinclair_typebox.TString;
+                payload: _sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TUnion<[_sinclair_typebox.TString, _sinclair_typebox.TNumber, _sinclair_typebox.TBoolean]>>;
+            }>, _sinclair_typebox.TObject<{
+                type: _sinclair_typebox.TLiteral<"playAnimation">;
+                /** Entity name. */
+                entity: _sinclair_typebox.TString;
+                /** Animation key as passed to `playAnimation({ key })`. */
+                key: _sinclair_typebox.TString;
+            }>, _sinclair_typebox.TObject<{
+                type: _sinclair_typebox.TLiteral<"playSong">;
+                /** Song slug or URL; resolved by the host. */
+                song: _sinclair_typebox.TString;
+                loop: _sinclair_typebox.TBoolean;
+            }>, _sinclair_typebox.TObject<{
+                type: _sinclair_typebox.TLiteral<"stopSong">;
+                song: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            }>, _sinclair_typebox.TObject<{
+                type: _sinclair_typebox.TLiteral<"setVariable">;
+                name: _sinclair_typebox.TString;
+                value: _sinclair_typebox.TUnion<[_sinclair_typebox.TString, _sinclair_typebox.TNumber, _sinclair_typebox.TBoolean]>;
+            }>]>;
+        }>>;
+    }>, _sinclair_typebox.TObject<{
+        kind: _sinclair_typebox.TLiteral<"audio">;
+        id: _sinclair_typebox.TString;
+        name: _sinclair_typebox.TString;
+        items: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+            id: _sinclair_typebox.TString;
+            time: _sinclair_typebox.TNumber;
+            kind: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"song">, _sinclair_typebox.TLiteral<"sfx">]>;
+            /** Song slug for `song`, asset URL for `sfx`. */
+            ref: _sinclair_typebox.TString;
+            loop: _sinclair_typebox.TBoolean;
+            /** Gain in dB. */
+            volume: _sinclair_typebox.TNumber;
+        }>>;
+    }>]>>;
+}>;
+type CutsceneDefinition = Static<typeof CutsceneDefinitionSchema>;
+
+export { AudioItemSchema as A, CutsceneDefinitionSchema as C, DollyPathSchema as D, EventItemSchema as E, SceneTransitionSchema as S, type Vec3Def as V, CutsceneSceneSchema as a, CutsceneCameraSchema as b, CameraKeyframeSchema as c, CameraShotSchema as d, CutsceneEventSchema as e, CutsceneTrackSchema as f, type CutsceneDefinition as g, type CutsceneScene as h, type CutsceneCamera as i, type CutsceneCameraKind as j, type CutsceneEasing as k, type CameraKeyframe as l, type CameraPoseDef as m, type CameraShot as n, type CameraTrack as o, type EventTrack as p, type AudioTrack as q, type CutsceneTrack as r, type DollyPath as s, type ShotBlend as t, type CutsceneEvent as u, type EventItem as v, type AudioItem as w, type SceneTransition as x, type SceneTransitionType as y };

package/dist/{debug-state-CpnNRUFh.d.ts → debug-state-Cg3f5FB6.d.ts}

@@ -1,4 +1,4 @@
-import { G as GameEntity } from './entity-XZNGBeca.js';
+import { G as GameEntity } from './entity-XqvuWgPm.js';
 
 type DebugTools = 'select' | 'translate' | 'rotate' | 'scale' | 'delete' | 'add' | 'none';
 /** Tools that manipulate a selected entity's transform via the gizmo. */

package/dist/debug.d.ts

@@ -1,8 +1,9 @@
-export { D as DEFAULT_SNAP_SETTINGS, w as DebugEntityResolver, v as DebugTools, S as SnapSettings, T as TRANSFORM_TOOLS, x as TransformTool, d as debugState, k as getHoveredEntity, j as getHoveredEntityId, e as getSelectedEntity, g as getSelectedEntityId, h as getSelectedEntityIds, m as getSnapSettings, t as isPickMode, u as isTransformTool, r as registerDebugEntityResolver, l as resolveDebugEntity, p as setAddType, s as setDebugTool, o as setGridVisible, i as setHoveredEntityId, a as setPaused, q as setPickMode, b as setSelectedEntity, c as setSelectedEntityId, f as setSelectedEntityIds, n as setSnapSettings } from './debug-state-CpnNRUFh.js';
+export { D as DEFAULT_SNAP_SETTINGS, w as DebugEntityResolver, v as DebugTools, S as SnapSettings, T as TRANSFORM_TOOLS, x as TransformTool, d as debugState, k as getHoveredEntity, j as getHoveredEntityId, e as getSelectedEntity, g as getSelectedEntityId, h as getSelectedEntityIds, m as getSnapSettings, t as isPickMode, u as isTransformTool, r as registerDebugEntityResolver, l as resolveDebugEntity, p as setAddType, s as setDebugTool, o as setGridVisible, i as setHoveredEntityId, a as setPaused, q as setPickMode, b as setSelectedEntity, c as setSelectedEntityId, f as setSelectedEntityIds, n as setSnapSettings } from './debug-state-Cg3f5FB6.js';
 import * as three from 'three';
 import { Group, Scene, Vector3, Camera, Object3D } from 'three';
 import { c as Vec3 } from './vector-D3eDzvcA.js';
-import { G as GameEntity } from './entity-XZNGBeca.js';
+import { G as GameEntity } from './entity-XqvuWgPm.js';
+export { S as SELECTION_BOUNDS_MARGIN, a as SELECTION_THIN_AXIS_FRACTION, c as SELECTION_THIN_AXIS_MAX, b as SELECTION_THIN_AXIS_MIN, d as SelectionBoundsProvider, m as measureObjectSelectionBounds, p as padSelectionBounds, r as resolveSelectionBounds } from './selection-bounds-BKmSo9aG.js';
 import { WebGPURenderer } from 'three/webgpu';
 import '@zylem/behaviors/core';
 import './simulation-body-zQw-emOr.js';

package/dist/debug.js

@@ -1 +1 @@
-import"./chunk-MSCVL5OK.js";import{a as x,b as y}from"./chunk-Q2YDBMVY.js";import{c as I,d as J,e as K,f as L}from"./chunk-BCFFS3FP.js";import{a as z,b as A,c as B,d as C,e as D,f as E,g as F,h as G,i as H}from"./chunk-CBUQBP2U.js";import{A as w,a,b,c,d,e,f,h as g,j as h,l as i,m as j,n as k,o as l,p as m,q as n,r as o,s as p,t as q,u as r,v as s,w as t,y as u,z as v}from"./chunk-EVMLNMGU.js";export{I as ConstructionGrid,c as DEFAULT_SNAP_SETTINGS,x as EntityThumbnailCache,a as TRANSFORM_TOOLS,L as TransformGizmo,J as closestAxisValue,d as debugState,G as degreesToRadians,y as entityThumbnailCache,B as eulerToQuaternion,A as focusEntity,v as getHoveredEntity,s as getHoveredEntityId,u as getSelectedEntity,k as getSelectedEntityId,m as getSelectedEntityIds,o as getSnapSettings,K as intersectPlane,j as isPickMode,b as isTransformTool,C as quaternionToEuler,H as radiansToDegrees,e as registerDebugEntityResolver,z as registerEntityFocusContext,f as resolveDebugEntity,r as setAddType,h as setDebugTool,q as setGridVisible,t as setHoveredEntityId,g as setPaused,i as setPickMode,w as setSelectedEntity,l as setSelectedEntityId,n as setSelectedEntityIds,p as setSnapSettings,F as snapScale,D as snapToIncrement,E as snapVec3};
+import"./chunk-ELQN62PQ.js";import{a as x,b as y}from"./chunk-Q2YDBMVY.js";import{c as P,d as Q,e as R,f as S}from"./chunk-BCFFS3FP.js";import{a as z,b as A,c as B,d as C,e as D,f as E,g as F,h as G,i as H}from"./chunk-BQRMYLYD.js";import{B as u,C as v,D as w,a,b,c,d,e,f,h as g,j as h,l as i,m as j,n as k,o as l,p as m,q as n,u as o,v as p,w as q,x as r,y as s,z as t}from"./chunk-GPCSX3M6.js";import{a as I,b as J,c as K,d as L,e as M,f as N,g as O}from"./chunk-UUOPT2N4.js";import"./chunk-WOT6VMZA.js";export{P as ConstructionGrid,c as DEFAULT_SNAP_SETTINGS,x as EntityThumbnailCache,I as SELECTION_BOUNDS_MARGIN,J as SELECTION_THIN_AXIS_FRACTION,L as SELECTION_THIN_AXIS_MAX,K as SELECTION_THIN_AXIS_MIN,a as TRANSFORM_TOOLS,S as TransformGizmo,Q as closestAxisValue,d as debugState,G as degreesToRadians,y as entityThumbnailCache,B as eulerToQuaternion,A as focusEntity,v as getHoveredEntity,s as getHoveredEntityId,u as getSelectedEntity,k as getSelectedEntityId,m as getSelectedEntityIds,o as getSnapSettings,R as intersectPlane,j as isPickMode,b as isTransformTool,N as measureObjectSelectionBounds,M as padSelectionBounds,C as quaternionToEuler,H as radiansToDegrees,e as registerDebugEntityResolver,z as registerEntityFocusContext,f as resolveDebugEntity,O as resolveSelectionBounds,r as setAddType,h as setDebugTool,q as setGridVisible,t as setHoveredEntityId,g as setPaused,i as setPickMode,w as setSelectedEntity,l as setSelectedEntityId,n as setSelectedEntityIds,p as setSnapSettings,F as snapScale,D as snapToIncrement,E as snapVec3};

package/dist/{entity-XZNGBeca.d.ts → entity-XqvuWgPm.d.ts}

@@ -561,6 +561,30 @@ declare class GameEntity<O extends GameEntityOptions> extends BaseNode<O> implem
      * Used by the stage to auto-register required systems.
      */
     getBehaviorRefs(): BehaviorRef[];
+    /**
+     * 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<O, any>): BehaviorRef<O> | null;
+    hasBehavior(descriptor: BehaviorDescriptor<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<any, any> | BehaviorRef<any>): BehaviorRef<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<any>): void;
     getCollisionCallbacks(): Array<(params: CollisionContext<this, O>) => void>;
     getCollisionRegistrations(): Array<CollisionRegistration<this, O>>;
     private copyBehaviorRefsTo;
@@ -591,6 +615,36 @@ declare class GameEntity<O extends GameEntityOptions> extends BaseNode<O> implem
      */
     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>;
     /**

package/dist/{entity-type-map-CkkFMSrL.d.ts → entity-type-map-CrsrKT8c.d.ts}

@@ -1,9 +1,10 @@
-import { Vector3, Sprite, Texture, Color, Object3D, ColorRepresentation, Light, Fog, FogExp2, Scene, Raycaster } from 'three';
+import { Vector3, Sprite, Texture, Color, Box3, Object3D, ColorRepresentation, Light, Fog, FogExp2, Scene, Raycaster } from 'three';
 import { B as BaseNode } from './base-node-idopiSw5.js';
-import { G as GameEntity, a as GameEntityOptions } from './entity-XZNGBeca.js';
+import { G as GameEntity, a as GameEntityOptions } from './entity-XqvuWgPm.js';
 import { d as Vec3Components, e as Vec3Input, b as Vec2Input } from './vector-D3eDzvcA.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-CxxAyJYp.js';
+import { d as SelectionBoundsProvider } from './selection-bounds-BKmSo9aG.js';
 import { Simulation } from '@zylem/behaviors/core';
 import { E as Entity } from './entity-BIf_a4dl.js';
 import { ParticleEmitterBehaviorOptions, ParticleEffectDefinition, ParticleEmitterHandle } from '@zylem/behaviors/particle-emitter';
@@ -373,12 +374,18 @@ type ZylemZoneOptions = GameEntityOptions & {
     onExit?: (params: OnExitParams) => void;
 };
 declare const ZONE_TYPE: unique symbol;
-declare class ZylemZone extends GameEntity<ZylemZoneOptions> implements CollisionHandlerDelegate {
+declare class ZylemZone extends GameEntity<ZylemZoneOptions> implements CollisionHandlerDelegate, SelectionBoundsProvider {
     static type: symbol;
     private _enteredZone;
     private _exitedZone;
     private _zoneEntities;
     constructor(options?: ZylemZoneOptions);
+    /**
+     * A zone has no render object, so the editor cannot measure it. Its
+     * selection view is the sensor volume itself: `options.size` centred on
+     * the live pose (or the configured position before spawn).
+     */
+    getSelectionBounds(target: Box3): Box3 | null;
     handlePostCollision({ delta }: {
         delta: number;
     }): boolean;
@@ -614,10 +621,12 @@ type ZylemParticleSystemOptions = GameEntityOptions & ParticleEmitterBehaviorOpt
     preset?: ParticleEffectDefinition;
 };
 declare const PARTICLE_SYSTEM_TYPE: unique symbol;
-declare class ZylemParticleSystem extends GameEntity<ZylemParticleSystemOptions> {
+declare class ZylemParticleSystem extends GameEntity<ZylemParticleSystemOptions> implements SelectionBoundsProvider {
     static type: symbol;
     __zylemParticleSystemEntity: true;
     private particleHandle;
+    /** The emitter's `group` is empty, so measuring it yields nothing; see {@link PARTICLE_SYSTEM_SELECTION_EXTENT}. */
+    getSelectionBounds(target: Box3): Box3 | null;
     constructor(options?: Partial<ZylemParticleSystemOptions>, initializeBehavior?: boolean);
     private bindStandaloneTransforms;
     private resolveParticleHandle;