@pixerate/editor 0.232.0 → 0.234.0

package/dist/video-editor/index.js

@@ -1,6 +1,6 @@
 import {
   createEffectAuthoringSession
-} from "../chunk-MUSZYMBX.js";
+} from "../chunk-TEFQISBY.js";
 import {
   VIDEO_ADJUSTMENT_SCOPES,
   VIDEO_BLEND_MODES,
@@ -149,11 +149,11 @@ import {
   videoTransitionEase,
   videoValueAt,
   videoWipeRect
-} from "../chunk-6QLTUGMO.js";
-import "../chunk-EHLOCVWB.js";
+} from "../chunk-WDDUPWVG.js";
 import {
   namedWithSuggestion
-} from "../chunk-TYCJGFCF.js";
+} from "../chunk-EUKY4KFX.js";
+import "../chunk-EHLOCVWB.js";
 import {
   CAMERA_MOVE_MAX_MS,
   EffectsSlot,
@@ -163,7 +163,7 @@ import {
   isEffectError,
   resolveCameraMoveSpec,
   sampleEffectCameraMove
-} from "../chunk-PQYDJ2AV.js";
+} from "../chunk-SIK3LT6M.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   defineEditorDocument

package/package.json

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

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

@@ -172,6 +172,9 @@ refuse.
 | `remove_shot_layer` | Remove a layer. |
 | `set_shot_transition` | Set the transition into a shot from the one before (a provider effect with use `transition`, its `ms`, `preset`, `values`). Not on the first shot. Returns the transition with `start` / `end`. |
 | `clear_shot_transition` | Remove a shot's transition, so it cuts (or the camera eases) again. |
+| `list_templates` | List the provider's sequence templates (`query`, `tags`): ids, names, shot counts, lengths. Returns `available: false` without templates. Call before `describe_template`. |
+| `describe_template` | Read a template's slots (type, label, default, limits), its `valuesSchema` and `exampleValues`. Call before `fill_template`. |
+| `fill_template` | Fill a template (`template`, `values`, `name`, `mode` replace or append) and load its shots as one undo step. Every value that does not fit is refused at once. Returns the new `shots`, `layers`, `openSlots` and `notes`. |
 
 ### Save and open
 
@@ -228,6 +231,13 @@ Flair's scenes do:
    `layer-not-drawn` and `transition-not-played` (no provider: effect layers are left out and
    transitions crossfade).
 
+A provider's **sequence templates** are whole scenes of such shots with slots to fill (a
+product reveal, before and after, a stat countdown): `list_templates`, `describe_template`, then
+`fill_template` with `values` (start from `exampleValues`). `mode` replace (default) makes a new
+scene the size of the template's stage; append adds its shots after yours, scaled to the
+artwork. Titles and captions become overlay word layers. Fill the `openSlots` it reports with
+`update_shot_layer` (`subject`), then animate artwork over the shots as usual.
+
 Layers are pixels: the Flair `SvgMotion` export leaves them out. Use them for backgrounds, looks
 and titles, and keep what should animate node by node in the artwork.
 

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

@@ -68,6 +68,8 @@ This skill is the method. `pixerate-animation-editor` has the full tool referenc
 | 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` |
+| A background, look or title behind or over a shot | `add_shot_layer` (a generator for a background, an overlay or title over it); `set_shot_transition` between shots |
+| A whole ready-made sequence (a reveal, a countdown) | `list_templates`, `describe_template`, `fill_template` (mode append keeps your shots), then animate artwork over it |
 
 ## Recipes
 
@@ -98,6 +100,8 @@ This skill is the method. `pixerate-animation-editor` has the full tool referenc
 - `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
+- `add_shot_layer`, `set_shot_transition`: provider effect layers and transitions on shots
+- `list_templates`, `describe_template`, `fill_template`: a provider's sequence template as shots
 - `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-canvas/SKILL.md

@@ -168,12 +168,12 @@ the reason (for example a variant combination that already exists, or a cycle).
 
 ### Save and open
 
-The host may add the shared document tools (see `pixerate-agent-tools`). A canvas document is `{ nodes, edges, scenes }`: every node (`id`, `position`, `data`, `type`, `parentId`...) and edge without selection or measurement, plus the saved scenes.
+The host may add the shared document tools (see `pixerate-agent-tools`). A canvas document is `{ nodes, edges, scenes, viewport }`: every node (`id`, `position`, `data`, `type`, `parentId`...) and edge without selection, measurement or the fields the host leaves out, plus the saved scenes and, when the host saves it, the `viewport` (`{ x, y, zoom }`) the canvas was looking at. Large inline images in node data may come back as `pixerate-asset:` references: pass them back unchanged, they are only valid in this session.
 
 | Tool | Use |
 | --- | --- |
 | `get_canvas_document` | Take a copy of the whole canvas as `{ kind, formatVersion, revision, document }` before a risky rewrite, or to hand it on. To read the canvas, use `get_editor_state`: it is smaller and says more. Refuses very large canvases. |
-| `load_canvas_document` | Put back a copy from `get_canvas_document` (its `document`, or the whole result). Checked first: duplicate ids, edges to missing nodes and parents that do not exist are refused and nothing changes. One undo step (`undo_canvas` brings the previous canvas back). To add or change a few nodes use `canvas_add_node` / `canvas_update_node`. |
+| `load_canvas_document` | Put back a copy from `get_canvas_document` (its `document`, or the whole result). Checked first: duplicate ids, edges to missing nodes, parents that do not exist, a bad `viewport` and anything the host's own node check rejects (the error names the node and says why) are refused and nothing changes. A `viewport` in the document moves the view; leave it out to keep the current view. One undo step (`undo_canvas` brings the previous canvas back). To add or change a few nodes use `canvas_add_node` / `canvas_update_node`. |
 | `undo_canvas` | Undo the last canvas change (one tool call, command or user gesture such as a drag). Returns `undone` (the step's name) and whether more can be undone. Fails with "Nothing to undo." when there is nothing. |
 | `redo_canvas` | Redo the last undone canvas change. |
 | `save_canvas_document` | Save the canvas under a `name` in the host's storage (the same name replaces that copy). Returns the `key`. Only listed when the host has storage. Save when the user asks, not after every edit. |

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

@@ -89,6 +89,14 @@ the pitfalls, and uses the tools below.
     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`.
+13. **Sequence templates** (a provider with templates): for a ready-made opening, reveal or
+    countdown, `list_templates`, then `describe_template` for its slots, then `fill_template`
+    with `values` (start from its `exampleValues`) and `at`. It lands on new tracks above the
+    others as one undo step: each shot's bottom layer on a base track carrying the shot's
+    transition, other layers as effect, picture and text clips by role. Open slots come back as
+    grey placeholder clips (`placeholders`); put the real picture over one with
+    `add_video_asset` and `add_video_clip` in `overwrite` mode. Camera moves are not carried
+    over: add them with `set_clip_camera_move`.
 
 ## Best practices
 
@@ -302,6 +310,9 @@ and every write tool is refused with the reason.
 | `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. |
+| `list_templates` | List the provider's sequence templates (`query`, `tags`): ids, names, shot counts, lengths. Returns `available: false` without templates. Call before `describe_template`. |
+| `describe_template` | Read a template's slots (type, label, default, limits), its `valuesSchema` and `exampleValues`. Call before `fill_template`. |
+| `fill_template` | Fill a template (`template`, `values`, `name`, `at` ms) and put it on new tracks at `at` as one undo step. Every value that does not fit is refused at once. Returns the new `tracks`, `clips`, `assets`, `start`, `end`, `placeholders` by open slot, and `notes`. |
 
 ### Save and open
 

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

@@ -66,6 +66,7 @@ music track and cutting to them, see `pixerate-bgm-alignment`.
 | 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: 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 |
+| An opening or closing sequence the provider has as a template | `list_templates`, `describe_template`, then `fill_template` with `at` the start; put the real pictures over its placeholders |
 
 ## Recipes
 
@@ -97,4 +98,5 @@ start: 0, duration: <sequence>, fadeOut: 2000 }`; `update_video_clip` on the las
 - `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)
+- `list_templates`, `describe_template`, `fill_template`: a provider's sequence template as clips on new tracks
 - `undo_video`: take back a step

package/dist/{chunk-PQYDJ2AV.js → chunk-SIK3LT6M.js}

@@ -2,6 +2,15 @@ import {
   validateJsonSchema
 } from "./chunk-V2ZCJRDM.js";
 
+// src/effects/types.ts
+var EFFECT_KINDS = ["shader", "vector", "motion", "camera"];
+var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive", "camera"];
+var CAMERA_MOVE_ROLES = ["transition", "hold"];
+var EFFECT_SUBJECT_KINDS = ["image", "video", "svg", "text", "slot"];
+var EFFECT_LAYER_ROLES = ["background", "subject", "overlay"];
+var EFFECT_TRANSITION_MS = 800;
+var EFFECT_TEMPLATE_SLOT_TYPES = ["image", "video", "svg", "text", "color", "number"];
+
 // src/effects/errors.ts
 var EFFECT_ERROR_CODES = ["unknown_effect", "invalid_values", "unsupported", "disposed", "no_provider", "unknown_template"];
 var EffectError = class extends Error {
@@ -281,15 +290,6 @@ function cameraBoxOfView(view, stage) {
   return { x: -view.scrollX, y: -view.scrollY, width, height };
 }
 
-// src/effects/types.ts
-var EFFECT_KINDS = ["shader", "vector", "motion", "camera"];
-var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive", "camera"];
-var CAMERA_MOVE_ROLES = ["transition", "hold"];
-var EFFECT_SUBJECT_KINDS = ["image", "video", "svg", "text", "slot"];
-var EFFECT_LAYER_ROLES = ["background", "subject", "overlay"];
-var EFFECT_TRANSITION_MS = 800;
-var EFFECT_TEMPLATE_SLOT_TYPES = ["image", "video", "svg", "text", "color", "number"];
-
 // src/effects/tools.ts
 var ANNOTATIONS = {
   read: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
@@ -528,6 +528,13 @@ function createEffectToolProvider(host) {
 }
 
 export {
+  EFFECT_KINDS,
+  EFFECT_USES,
+  CAMERA_MOVE_ROLES,
+  EFFECT_SUBJECT_KINDS,
+  EFFECT_LAYER_ROLES,
+  EFFECT_TRANSITION_MS,
+  EFFECT_TEMPLATE_SLOT_TYPES,
   EFFECT_ERROR_CODES,
   EffectError,
   UnknownEffectError,
@@ -562,12 +569,5 @@ export {
   resolveCameraMoveSpec,
   cameraViewOfBox,
   cameraBoxOfView,
-  EFFECT_KINDS,
-  EFFECT_USES,
-  CAMERA_MOVE_ROLES,
-  EFFECT_SUBJECT_KINDS,
-  EFFECT_LAYER_ROLES,
-  EFFECT_TRANSITION_MS,
-  EFFECT_TEMPLATE_SLOT_TYPES,
   createEffectToolProvider
 };