@pixerate/editor 0.229.0 → 0.231.0

package/dist/video-editor/parse.d.cts

@@ -1,8 +1,8 @@
 import { type VideoAnimatable, type VideoKeyframes } from './keyframes.cjs';
-import { type VideoClipMask, type VideoAsset, type VideoAssetProxy, type VideoClip, type VideoClipEffect, type VideoEffectRef, type VideoEffectValues, type VideoClipAnimation, type VideoGrade, type VideoGradeLut, type VideoMarker, type VideoProject, type VideoSequence, type VideoTrack, type VideoTranscriptWord, type VideoTransform, type VideoTransition } from './types.cjs';
+import { type VideoClipMask, type VideoClipCamera, type VideoAsset, type VideoAssetProxy, type VideoClip, type VideoClipEffect, type VideoEffectRef, type VideoEffectValues, type VideoClipAnimation, type VideoGrade, type VideoGradeLut, type VideoMarker, type VideoProject, type VideoSequence, type VideoTrack, type VideoTranscriptWord, type VideoTransform, type VideoTransition } from './types.cjs';
 /**
- * Keyframes `{ keys: [{ t, v, ease }] }`: at least one key, in strictly increasing time (clip-relative
- * ms), each value within `range`.
+ * Keyframes `{ keys: [{ t, v, ease }] }`: at least one key, in time order (clip-relative ms; two
+ * at one time make a jump), each value within `range`.
  */
 export declare function parseVideoKeyframes(v: unknown, path: string, { min, max }?: {
     min?: number;
@@ -35,6 +35,8 @@ export declare function parseVideoClipEffects(v: unknown, path: string): VideoCl
 export declare function parseVideoTranscriptWords(v: unknown, path: string): VideoTranscriptWord[] | undefined;
 export declare function parseVideoAsset(v: unknown, path?: string): VideoAsset;
 export declare function parseVideoAssetProxies(v: unknown, path: string): VideoAssetProxy[] | undefined;
+/** A clip's camera moves `{ in, during, from, framing, base }` (see `VideoClipCamera`). */
+export declare function parseVideoClipCamera(v: unknown, path: string): VideoClipCamera | undefined;
 export declare function parseVideoClip(v: unknown, path?: string): VideoClip;
 export declare function parseVideoTrack(v: unknown, path?: string): VideoTrack;
 /** A nested sequence `{ id, name, tracks }` (see `VideoSequence`). */

package/dist/video-editor/parse.d.ts

@@ -1,8 +1,8 @@
 import { type VideoAnimatable, type VideoKeyframes } from './keyframes.js';
-import { type VideoClipMask, type VideoAsset, type VideoAssetProxy, type VideoClip, type VideoClipEffect, type VideoEffectRef, type VideoEffectValues, type VideoClipAnimation, type VideoGrade, type VideoGradeLut, type VideoMarker, type VideoProject, type VideoSequence, type VideoTrack, type VideoTranscriptWord, type VideoTransform, type VideoTransition } from './types.js';
+import { type VideoClipMask, type VideoClipCamera, type VideoAsset, type VideoAssetProxy, type VideoClip, type VideoClipEffect, type VideoEffectRef, type VideoEffectValues, type VideoClipAnimation, type VideoGrade, type VideoGradeLut, type VideoMarker, type VideoProject, type VideoSequence, type VideoTrack, type VideoTranscriptWord, type VideoTransform, type VideoTransition } from './types.js';
 /**
- * Keyframes `{ keys: [{ t, v, ease }] }`: at least one key, in strictly increasing time (clip-relative
- * ms), each value within `range`.
+ * Keyframes `{ keys: [{ t, v, ease }] }`: at least one key, in time order (clip-relative ms; two
+ * at one time make a jump), each value within `range`.
  */
 export declare function parseVideoKeyframes(v: unknown, path: string, { min, max }?: {
     min?: number;
@@ -35,6 +35,8 @@ export declare function parseVideoClipEffects(v: unknown, path: string): VideoCl
 export declare function parseVideoTranscriptWords(v: unknown, path: string): VideoTranscriptWord[] | undefined;
 export declare function parseVideoAsset(v: unknown, path?: string): VideoAsset;
 export declare function parseVideoAssetProxies(v: unknown, path: string): VideoAssetProxy[] | undefined;
+/** A clip's camera moves `{ in, during, from, framing, base }` (see `VideoClipCamera`). */
+export declare function parseVideoClipCamera(v: unknown, path: string): VideoClipCamera | undefined;
 export declare function parseVideoClip(v: unknown, path?: string): VideoClip;
 export declare function parseVideoTrack(v: unknown, path?: string): VideoTrack;
 /** A nested sequence `{ id, name, tracks }` (see `VideoSequence`). */

package/dist/video-editor/tools.d.cts

@@ -69,6 +69,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
             mask?: import("./types.cjs").VideoClipMask;
+            camera?: import("./types.cjs").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -98,6 +99,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
             mask?: import("./types.cjs").VideoClipMask;
+            camera?: import("./types.cjs").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -122,6 +124,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
             mask?: import("./types.cjs").VideoClipMask;
+            camera?: import("./types.cjs").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -151,6 +154,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
             mask?: import("./types.cjs").VideoClipMask;
+            camera?: import("./types.cjs").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -174,6 +178,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
             mask?: import("./types.cjs").VideoClipMask;
+            camera?: import("./types.cjs").VideoClipCamera;
             effect: string;
             provider?: string;
             values?: import("./types.cjs").VideoEffectValues;
@@ -202,6 +207,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
             mask?: import("./types.cjs").VideoClipMask;
+            camera?: import("./types.cjs").VideoClipCamera;
         })[];
         volume?: number | undefined;
         syncLocked?: boolean | undefined;
@@ -286,6 +292,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 transition?: import("./types.cjs").VideoTransition;
                 effects?: import("./types.cjs").VideoClipEffect[];
                 mask?: import("./types.cjs").VideoClipMask;
+                camera?: import("./types.cjs").VideoClipCamera;
             } | {
                 source?: {
                     in: number;
@@ -315,6 +322,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 transition?: import("./types.cjs").VideoTransition;
                 effects?: import("./types.cjs").VideoClipEffect[];
                 mask?: import("./types.cjs").VideoClipMask;
+                camera?: import("./types.cjs").VideoClipCamera;
             } | {
                 source?: {
                     in: number;
@@ -339,6 +347,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 transition?: import("./types.cjs").VideoTransition;
                 effects?: import("./types.cjs").VideoClipEffect[];
                 mask?: import("./types.cjs").VideoClipMask;
+                camera?: import("./types.cjs").VideoClipCamera;
             } | {
                 source?: {
                     in: number;
@@ -368,6 +377,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 transition?: import("./types.cjs").VideoTransition;
                 effects?: import("./types.cjs").VideoClipEffect[];
                 mask?: import("./types.cjs").VideoClipMask;
+                camera?: import("./types.cjs").VideoClipCamera;
             } | {
                 source?: {
                     in: number;
@@ -391,6 +401,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 transition?: import("./types.cjs").VideoTransition;
                 effects?: import("./types.cjs").VideoClipEffect[];
                 mask?: import("./types.cjs").VideoClipMask;
+                camera?: import("./types.cjs").VideoClipCamera;
                 effect: string;
                 provider?: string;
                 values?: import("./types.cjs").VideoEffectValues;
@@ -419,6 +430,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 transition?: import("./types.cjs").VideoTransition;
                 effects?: import("./types.cjs").VideoClipEffect[];
                 mask?: import("./types.cjs").VideoClipMask;
+                camera?: import("./types.cjs").VideoClipCamera;
             })[];
             volume?: number | undefined;
             syncLocked?: boolean | undefined;
@@ -523,6 +535,7 @@ export declare function describeVideoProject(project: VideoProject): {
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
             mask?: import("./types.cjs").VideoClipMask;
+            camera?: import("./types.cjs").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -552,6 +565,7 @@ export declare function describeVideoProject(project: VideoProject): {
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
             mask?: import("./types.cjs").VideoClipMask;
+            camera?: import("./types.cjs").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -576,6 +590,7 @@ export declare function describeVideoProject(project: VideoProject): {
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
             mask?: import("./types.cjs").VideoClipMask;
+            camera?: import("./types.cjs").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -605,6 +620,7 @@ export declare function describeVideoProject(project: VideoProject): {
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
             mask?: import("./types.cjs").VideoClipMask;
+            camera?: import("./types.cjs").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -628,6 +644,7 @@ export declare function describeVideoProject(project: VideoProject): {
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
             mask?: import("./types.cjs").VideoClipMask;
+            camera?: import("./types.cjs").VideoClipCamera;
             effect: string;
             provider?: string;
             values?: import("./types.cjs").VideoEffectValues;
@@ -656,6 +673,7 @@ export declare function describeVideoProject(project: VideoProject): {
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
             mask?: import("./types.cjs").VideoClipMask;
+            camera?: import("./types.cjs").VideoClipCamera;
         })[];
         volume?: number | undefined;
         syncLocked?: boolean | undefined;

package/dist/video-editor/tools.d.ts

@@ -69,6 +69,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
             mask?: import("./types.js").VideoClipMask;
+            camera?: import("./types.js").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -98,6 +99,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
             mask?: import("./types.js").VideoClipMask;
+            camera?: import("./types.js").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -122,6 +124,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
             mask?: import("./types.js").VideoClipMask;
+            camera?: import("./types.js").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -151,6 +154,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
             mask?: import("./types.js").VideoClipMask;
+            camera?: import("./types.js").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -174,6 +178,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
             mask?: import("./types.js").VideoClipMask;
+            camera?: import("./types.js").VideoClipCamera;
             effect: string;
             provider?: string;
             values?: import("./types.js").VideoEffectValues;
@@ -202,6 +207,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
             mask?: import("./types.js").VideoClipMask;
+            camera?: import("./types.js").VideoClipCamera;
         })[];
         volume?: number | undefined;
         syncLocked?: boolean | undefined;
@@ -286,6 +292,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 transition?: import("./types.js").VideoTransition;
                 effects?: import("./types.js").VideoClipEffect[];
                 mask?: import("./types.js").VideoClipMask;
+                camera?: import("./types.js").VideoClipCamera;
             } | {
                 source?: {
                     in: number;
@@ -315,6 +322,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 transition?: import("./types.js").VideoTransition;
                 effects?: import("./types.js").VideoClipEffect[];
                 mask?: import("./types.js").VideoClipMask;
+                camera?: import("./types.js").VideoClipCamera;
             } | {
                 source?: {
                     in: number;
@@ -339,6 +347,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 transition?: import("./types.js").VideoTransition;
                 effects?: import("./types.js").VideoClipEffect[];
                 mask?: import("./types.js").VideoClipMask;
+                camera?: import("./types.js").VideoClipCamera;
             } | {
                 source?: {
                     in: number;
@@ -368,6 +377,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 transition?: import("./types.js").VideoTransition;
                 effects?: import("./types.js").VideoClipEffect[];
                 mask?: import("./types.js").VideoClipMask;
+                camera?: import("./types.js").VideoClipCamera;
             } | {
                 source?: {
                     in: number;
@@ -391,6 +401,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 transition?: import("./types.js").VideoTransition;
                 effects?: import("./types.js").VideoClipEffect[];
                 mask?: import("./types.js").VideoClipMask;
+                camera?: import("./types.js").VideoClipCamera;
                 effect: string;
                 provider?: string;
                 values?: import("./types.js").VideoEffectValues;
@@ -419,6 +430,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 transition?: import("./types.js").VideoTransition;
                 effects?: import("./types.js").VideoClipEffect[];
                 mask?: import("./types.js").VideoClipMask;
+                camera?: import("./types.js").VideoClipCamera;
             })[];
             volume?: number | undefined;
             syncLocked?: boolean | undefined;
@@ -523,6 +535,7 @@ export declare function describeVideoProject(project: VideoProject): {
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
             mask?: import("./types.js").VideoClipMask;
+            camera?: import("./types.js").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -552,6 +565,7 @@ export declare function describeVideoProject(project: VideoProject): {
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
             mask?: import("./types.js").VideoClipMask;
+            camera?: import("./types.js").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -576,6 +590,7 @@ export declare function describeVideoProject(project: VideoProject): {
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
             mask?: import("./types.js").VideoClipMask;
+            camera?: import("./types.js").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -605,6 +620,7 @@ export declare function describeVideoProject(project: VideoProject): {
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
             mask?: import("./types.js").VideoClipMask;
+            camera?: import("./types.js").VideoClipCamera;
         } | {
             source?: {
                 in: number;
@@ -628,6 +644,7 @@ export declare function describeVideoProject(project: VideoProject): {
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
             mask?: import("./types.js").VideoClipMask;
+            camera?: import("./types.js").VideoClipCamera;
             effect: string;
             provider?: string;
             values?: import("./types.js").VideoEffectValues;
@@ -656,6 +673,7 @@ export declare function describeVideoProject(project: VideoProject): {
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
             mask?: import("./types.js").VideoClipMask;
+            camera?: import("./types.js").VideoClipCamera;
         })[];
         volume?: number | undefined;
         syncLocked?: boolean | undefined;

package/dist/video-editor/types.d.cts

@@ -6,7 +6,7 @@
  * track draws over one on a later track. Clips on one track never overlap.
  */
 import type { VideoAnimatable, VideoKeyframes } from './keyframes.cjs';
-import type { EffectValue } from '../effects/types.cjs';
+import type { CameraMoveSpec, EffectValue } from '../effects/types.cjs';
 export type VideoAssetKind = 'video' | 'audio' | 'image';
 /** A spoken word in an asset's transcript, timed in the source (ms). */
 export interface VideoTranscriptWord {
@@ -230,6 +230,42 @@ interface VideoClipBase {
     effects?: VideoClipEffect[];
     /** A shape that cuts the picture out (see `VideoClipMask`). */
     mask?: VideoClipMask;
+    /** Provider camera moves baked into the transform's keyframes (see `VideoClipCamera`). */
+    camera?: VideoClipCamera;
+}
+/**
+ * Where a camera looks at a clip's picture: `zoom` × the picture as placed (default 1), centred
+ * on the point `x`, `y` pixels from the frame's centre (default 0, 0).
+ */
+export interface VideoCameraFraming {
+    zoom?: number;
+    x?: number;
+    y?: number;
+}
+/**
+ * Camera moves from the effects provider played on a clip, the clip being the shot: `in` (a
+ * `transition` move, such as a glide or whip pan) moves from `from` to `framing` over its `ms`
+ * from the clip's start, and `during` (a `hold` move, such as a Ken Burns drift) plays across the
+ * rest of the clip at `framing`. They are baked into the clip's x, y, scale and rotation keys
+ * (one per frame, two at a cut), so previews, renders and exports play them without the provider;
+ * `base` keeps the transform from before, put back when the moves are cleared. Set them with
+ * `VideoEditorController.setClipCameraMove`, which bakes them; edit the keys directly and the
+ * moves no longer describe them.
+ */
+export interface VideoClipCamera {
+    in?: CameraMoveSpec;
+    during?: CameraMoveSpec;
+    /** Where `in` starts (default the whole picture). */
+    from?: VideoCameraFraming;
+    /** Where `in` arrives and `during` plays (default the whole picture). */
+    framing?: VideoCameraFraming;
+    /** The clip's transform before the moves were baked. */
+    base: {
+        x?: number;
+        y?: number;
+        scale?: number;
+        rotation?: number;
+    };
 }
 /**
  * The shape of a clip mask: `rectangle` (with `cornerRadius`), `ellipse`, `linear` (a straight

package/dist/video-editor/types.d.ts

@@ -6,7 +6,7 @@
  * track draws over one on a later track. Clips on one track never overlap.
  */
 import type { VideoAnimatable, VideoKeyframes } from './keyframes.js';
-import type { EffectValue } from '../effects/types.js';
+import type { CameraMoveSpec, EffectValue } from '../effects/types.js';
 export type VideoAssetKind = 'video' | 'audio' | 'image';
 /** A spoken word in an asset's transcript, timed in the source (ms). */
 export interface VideoTranscriptWord {
@@ -230,6 +230,42 @@ interface VideoClipBase {
     effects?: VideoClipEffect[];
     /** A shape that cuts the picture out (see `VideoClipMask`). */
     mask?: VideoClipMask;
+    /** Provider camera moves baked into the transform's keyframes (see `VideoClipCamera`). */
+    camera?: VideoClipCamera;
+}
+/**
+ * Where a camera looks at a clip's picture: `zoom` × the picture as placed (default 1), centred
+ * on the point `x`, `y` pixels from the frame's centre (default 0, 0).
+ */
+export interface VideoCameraFraming {
+    zoom?: number;
+    x?: number;
+    y?: number;
+}
+/**
+ * Camera moves from the effects provider played on a clip, the clip being the shot: `in` (a
+ * `transition` move, such as a glide or whip pan) moves from `from` to `framing` over its `ms`
+ * from the clip's start, and `during` (a `hold` move, such as a Ken Burns drift) plays across the
+ * rest of the clip at `framing`. They are baked into the clip's x, y, scale and rotation keys
+ * (one per frame, two at a cut), so previews, renders and exports play them without the provider;
+ * `base` keeps the transform from before, put back when the moves are cleared. Set them with
+ * `VideoEditorController.setClipCameraMove`, which bakes them; edit the keys directly and the
+ * moves no longer describe them.
+ */
+export interface VideoClipCamera {
+    in?: CameraMoveSpec;
+    during?: CameraMoveSpec;
+    /** Where `in` starts (default the whole picture). */
+    from?: VideoCameraFraming;
+    /** Where `in` arrives and `during` plays (default the whole picture). */
+    framing?: VideoCameraFraming;
+    /** The clip's transform before the moves were baked. */
+    base: {
+        x?: number;
+        y?: number;
+        scale?: number;
+        rotation?: number;
+    };
 }
 /**
  * The shape of a clip mask: `rectangle` (with `cornerRadius`), `ellipse`, `linear` (a straight

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.229.0",
+  "version": "0.231.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",

package/skills/pixerate-animation-editor/SKILL.md

@@ -155,13 +155,16 @@ refuse.
 
 | Tool | Use it to |
 | --- | --- |
-| `search_effects` | Find effects: `kind` motion (primitives to apply to nodes) or vector (effects with their own picture), `query`, `category`. `kind` camera lists camera moves (with `camera`: role transition or hold, `durationMs`, `cut`); they move a scene's camera and cannot be applied with these tools. |
+| `search_effects` | Find effects: `kind` motion (primitives to apply to nodes) or vector (effects with their own picture), `query`, `category`. `kind` camera lists camera moves (with `camera`: role transition or hold, `durationMs`, `cut`); give them to a shot with `set_shot_camera_move`, not `apply_effect`. |
 | `describe_effect` | Read an effect's `controls` (names, ranges, units), `defaults` and `presets`, and whether it `appliesHere` (a motion effect). |
 | `list_applied_effects` | See the provider effects in the scene: their `instance` ids, the nodes they animate, their shots and values. |
 | `apply_effect` | Animate a node (`target`, a group animates as one) with a motion effect: the changes become ordinary commands, tagged with the effect, in a new shot after the last. Returns the instance id. |
 | `update_effect` | Make an applied effect again with new `values`, in the same place (`effect` is its instance id). |
 | `remove_effect` | Remove an applied effect: its commands, shots it alone filled and a vector effect's group. |
 | `add_vector_effect` | Add a vector effect's own picture as an artwork group (fitted into `box`) with its motion as new shots. Returns the instance and group ids. |
+| `list_camera_moves` | List the provider's camera moves for a `role` (`transition`: how the camera gets into a shot; `hold`: how it moves while the shot holds), with `durationMs` and `cut`. Returns `available: false` without camera moves. Call before `set_shot_camera_move`; `describe_effect` gives a move's controls and presets. |
+| `set_shot_camera_move` | Give a shot a camera move (`shot`, `role`, `move`, optional `ms` for a transition, `preset`, `values`): it is saved on the shot's camera as `in` or `during`. Returns the shot's camera and the `window` (ms) the move plays in. A wrong-role id is refused naming the moves that fit. |
+| `clear_shot_camera_move` | Remove a shot's move for a `role`, keeping its framing. Returns the shot's camera (null when nothing is left). |
 
 ### Save and open
 
@@ -175,8 +178,32 @@ The host may add the shared document tools (see `pixerate-agent-tools`). An anim
 | `list_saved_animation_documents` | List saved animations (`key`, `name`, `savedAt`), newest first. |
 | `open_saved_animation_document` | Replace the animation with a saved one by `key`. One undo step. Ask before opening over changes the user has not saved. |
 
+### Camera moves
+
+With a provider that has camera moves (Flair: `camera-glide`, `camera-whip-pan`,
+`camera-punch-zoom`, `camera-cut` to get in; `camera-ken-burns`, `camera-crash-zoom` while
+holding), a shot's camera can play one as it arrives and one while it holds:
+
+1. Frame the shot as usual (`update_shot` with `camera: { frame: "<id>" }` or a rectangle). A
+   move without a framing keeps the one the camera has.
+2. `list_camera_moves` with the `role`, pick by `description`, then `set_shot_camera_move`. Use
+   a preset (`describe_effect` lists them) before hand-tuning `values`.
+3. A transition's `ms` sets how long it takes (default the move's own, written out on the
+   shot); a hold move plays across the shot's `hold`, so lengthen the hold for a slower drift.
+   The next shot's move starts from where a hold move ends.
+4. `render_animation_frame` mid-move to look, and `check_animation`: `camera-move-first-shot`
+   (the first shot cuts, so its transition does not play), `camera-move-unknown`,
+   `camera-move-values`, `camera-move-not-played` (no provider with camera moves: the camera
+   eases between framings instead).
+
+Exports to Flair tag each camera change with `<move>@<shot>`; with the provider set the camera
+is sampled from the move, and a cut stays a jump.
+
 ## Pitfalls
 
+- **One move per role per shot.** Whip pans and cuts jump half way: put them between framings
+  that differ, and do not follow a cut with a long glide into the same framing.
+
 - With agent playback on, the cursor clicks the shot a call names in the timeline and visits the stage elements its commands target. Results are unchanged.
 - **Effect commands are ordinary commands.** You can retime or edit them with `edit_animation` like
   any command, but `update_effect` replaces all of an effect's commands. Change values through the

package/skills/pixerate-animation-motion-graphics/SKILL.md

@@ -66,6 +66,8 @@ This skill is the method. `pixerate-animation-editor` has the full tool referenc
 | Draw a line or outline | `draw`, or `enter` `style: "draw"` |
 | Attention on one element | `pulse`, `shake`, `wiggle` (sparingly) |
 | A set length | `fit_animation` with `seconds`, `keep` for fixed shots |
+| The camera travels to the next part | `update_shot` camera `frame`, then `set_shot_camera_move` role `transition` (a glide; a whip pan for energy) |
+| A slow push while a shot holds | `set_shot_camera_move` role `hold` (a Ken Burns drift), with a longer `hold` |
 
 ## Recipes
 
@@ -95,6 +97,7 @@ This skill is the method. `pixerate-animation-editor` has the full tool referenc
 - `add_commands`, `update_command`, `delete_commands`, `move_command`: refine commands
 - `edit_animation`: several edits as one undo step
 - `fit_animation`, `set_animation_settings`, `get_timing_grid`: length, settings and cues
+- `list_camera_moves`, `set_shot_camera_move`: provider camera moves into and during a shot
 - `check_animation`, `get_motion_path`, `render_animation_frame`: check and look
 - `export_lottie`, `export_flair_motion`: deliver
 - `undo_animation`: take back a step

package/skills/pixerate-video-editor/SKILL.md

@@ -83,6 +83,12 @@ the pitfalls, and uses the tools below.
     or `add_video_effect_clip` (generators and titles). Tune with `update_effect` and
     `set_video_effect_keyframes`; check with `get_video_frame` (layers list `effects`) and
     `list_applied_effects`.
+12. **Camera moves** (a provider with camera moves, such as Flair): a clip is the shot.
+    `list_video_camera_moves` with a `role`, then `set_clip_camera_move`: `transition` moves
+    from `from` to `framing` from the clip's start (a glide, whip pan, punch zoom); `hold`
+    plays across the rest of the clip at `framing` (a Ken Burns drift on a still). The moves are
+    baked into the clip's x, y, scale and rotation keys at the project's fps, two keys at a cut,
+    so the preview and exports play them without the provider. Check with `get_video_frame`.
 
 ## Best practices
 
@@ -284,7 +290,7 @@ and every write tool is refused with the reason.
 
 | Tool | Use it to |
 | --- | --- |
-| `search_effects` | Find effects: words in `query`, filtered by `kind`, `category` or `use` (filter, overlay for clips; transition; generator, title). Returns ids, names, uses, whether they are transparent or loop, and their length. Camera moves (`kind` camera) are listed but not applied to clips (`appliesHere` false). Call `describe_effect` next. |
+| `search_effects` | Find effects: words in `query`, filtered by `kind`, `category` or `use` (filter, overlay for clips; transition; generator, title). Returns ids, names, uses, whether they are transparent or loop, and their length. Camera moves (`kind` camera) are listed but go on clips with `set_clip_camera_move`, not `apply_effect`. Call `describe_effect` next. |
 | `describe_effect` | Read one effect's `controls` (a strict JSON Schema: names, types, ranges, units), `defaults`, `presets` and `inputs`, and whether it `appliesHere` (as a clip effect). Use the names and ranges for values. |
 | `list_applied_effects` | See the effects in the project per clip, in order: clip effects (`fx1`...), an effect clip's own effect (`generator`) and an effect transition (`transition`), with their saved values and `available` (false when the provider lacks it: drawn as a placeholder). |
 | `apply_effect` | Add a filter or overlay effect to a clip's stack (`target` clip id, `effect`, `values`, `index`, `enabled`, `opacity`). Effects run in order on the clip's picture before its grade and placement. Returns the effect's new id and the clip's effects. |
@@ -293,6 +299,9 @@ and every write tool is refused with the reason.
 | `add_video_effect_clip` | Put a generator, title or overlay effect on a video `track` as a clip filling the frame (`start`, `duration` default the effect's own length, `values`, `mode`). Transparent effects show the tracks beneath. Returns the clip id. |
 | `set_video_effect_transition` | Use a transition effect from the effects provider into a `clip` from the one ending where it starts (`duration` centred on the cut, `values`). Needs handles like a crossfade. For a cross dissolve, dip, wipe, push, slide or iris use the built-in `set_video_transition` instead. |
 | `set_video_effect_keyframes` | Animate one number `control` of a clip effect (or an effect clip's `generator`) with `keys` in clip ms, or `null` to stop animating it. |
+| `list_video_camera_moves` | List the provider's camera moves for a `role` (`transition` into a clip, `hold` across it) with `durationMs` and `cut`. Returns `available: false` without camera moves. Call before `set_clip_camera_move`. |
+| `set_clip_camera_move` | Play a camera move on a clip's picture (`clip`, `role`, `move`, `ms` for a transition, `preset`, `values`, `from` and `framing` as `{ zoom, x, y }`): baked into its transform keys, one per frame, two at a cut. Returns the camera, key counts, `cuts`, `windows` and `notes` (tilt, turn and blur cannot be baked). Refuses a clip keyed by hand. |
+| `clear_clip_camera_move` | Remove a clip's move for a `role` and re-bake the other; with none left the transform goes back to what it was. |
 
 ### Save and open
 
@@ -308,6 +317,12 @@ The host may add the shared document tools (see `pixerate-agent-tools`). A video
 
 ## Pitfalls
 
+- **Camera moves are baked keys.** After trimming or splitting a clip, `check_video_project`
+  reports `camera-stale`: set the move again to re-bake it. Editing the clip's x, y, scale or
+  rotation keys by hand leaves the moves no longer describing them; clear the moves first.
+- **A cut is two keys at one time** (the value just before, then the value after). Keys may
+  share a time only in pairs; a speed ramp never takes one.
+
 - **An adjustment clip changes only tracks below it** (scope `underneath`). Put it on a new top
   track (`add_video_track` with `at: 0`), or use scope `all`. Adjustment clips have no sound and
   are left out of EDLs; ffmpeg exports draw a plain grade or full-strength LUT at full opacity

package/skills/pixerate-video-montage/SKILL.md

@@ -65,7 +65,7 @@ music track and cutting to them, see `pixerate-bgm-alignment`.
 | Time passing | Crossfade or dip between shots |
 | A section change | Dip to black or a held shot, then a new rhythm |
 | Continuity of motion | Cut on action (`roll_video_edit` onto the movement) |
-| Photos in a slideshow | Image assets, a slow push-in (`set_video_keyframes` scale 1 to 1.08) |
+| Photos in a slideshow | Image assets, a slow push-in: with a provider that has camera moves, `set_clip_camera_move` role `hold` (a Ken Burns drift) on each photo; otherwise `set_video_keyframes` scale 1 to 1.08 |
 
 ## Recipes
 
@@ -96,4 +96,5 @@ start: 0, duration: <sequence>, fadeOut: 2000 }`; `update_video_clip` on the las
 - `roll_video_edit`, `slip_video_clip`, `trim_video_clip`, `close_video_gaps`: refine the rhythm
 - `set_video_transition`: crossfades and dips
 - `update_video_clip`, `set_video_keyframes`: fades, volume and push-ins
+- `list_video_camera_moves`, `set_clip_camera_move`: provider camera moves (a drift across a photo)
 - `undo_video`: take back a step