@pixerate/editor 0.234.0 → 0.235.0

package/dist/animation-editor/controller.d.cts

@@ -71,6 +71,19 @@ export type MotionShotLayerResult = ({
     ok: false;
     error: string;
 };
+/** What filling a template did: the shots and layers it made, slots left open, and notes. */
+export type MotionTemplateResult = {
+    ok: true;
+    template: string;
+    mode: 'replace' | 'append';
+    shots: string[];
+    layers: string[];
+    openSlots: string[];
+    notes: string[];
+} | {
+    ok: false;
+    error: string;
+};
 /** A layer as `addShotLayer` takes it: its id is made when left out. */
 export type MotionShotLayerInput = Omit<MotionShotLayer, 'id' | 'provider' | 'name'> & {
     id?: string;
@@ -143,6 +156,8 @@ export interface AnimationEditorState {
     revision: number;
     /** The registered effects provider, or `null`. */
     effectsProvider: EffectProvider | null;
+    /** Goes up each time shot layer or transition pictures come in, so a stage that caches its frame draws again. */
+    layerPictures: number;
     /** The take being recorded, or `null`. While recording, frames show the take so far. */
     recording: AnimationEditorRecording | null;
 }
@@ -323,6 +338,16 @@ export declare class AnimationEditorController {
     }): Promise<MotionShotLayerResult>;
     /** Removes a shot's transition. One undo step. Works without a provider. */
     clearShotTransition(shot: string): MotionShotLayerResult;
+    /**
+     * Fills a provider sequence template and loads it: `replace` (default) makes a new scene the
+     * size of the template's stage from its shots; `append` adds its shots after the current ones,
+     * scaled to the artwork. Values are checked first and every problem is refused at once. One
+     * undo step. Returns the new shot and layer ids, slots left open and notes.
+     */
+    fillTemplate(template: string, values?: Record<string, unknown>, options?: {
+        name?: string;
+        mode?: 'replace' | 'append';
+    }): Promise<MotionTemplateResult>;
     /**
      * Starts recording a take: the playhead goes to where the take's shot will start (default:
      * the end of the scene) and plays on, and every `recordSample` (or stage gesture) is a value

package/dist/animation-editor/controller.d.ts

@@ -71,6 +71,19 @@ export type MotionShotLayerResult = ({
     ok: false;
     error: string;
 };
+/** What filling a template did: the shots and layers it made, slots left open, and notes. */
+export type MotionTemplateResult = {
+    ok: true;
+    template: string;
+    mode: 'replace' | 'append';
+    shots: string[];
+    layers: string[];
+    openSlots: string[];
+    notes: string[];
+} | {
+    ok: false;
+    error: string;
+};
 /** A layer as `addShotLayer` takes it: its id is made when left out. */
 export type MotionShotLayerInput = Omit<MotionShotLayer, 'id' | 'provider' | 'name'> & {
     id?: string;
@@ -143,6 +156,8 @@ export interface AnimationEditorState {
     revision: number;
     /** The registered effects provider, or `null`. */
     effectsProvider: EffectProvider | null;
+    /** Goes up each time shot layer or transition pictures come in, so a stage that caches its frame draws again. */
+    layerPictures: number;
     /** The take being recorded, or `null`. While recording, frames show the take so far. */
     recording: AnimationEditorRecording | null;
 }
@@ -323,6 +338,16 @@ export declare class AnimationEditorController {
     }): Promise<MotionShotLayerResult>;
     /** Removes a shot's transition. One undo step. Works without a provider. */
     clearShotTransition(shot: string): MotionShotLayerResult;
+    /**
+     * Fills a provider sequence template and loads it: `replace` (default) makes a new scene the
+     * size of the template's stage from its shots; `append` adds its shots after the current ones,
+     * scaled to the artwork. Values are checked first and every problem is refused at once. One
+     * undo step. Returns the new shot and layer ids, slots left open and notes.
+     */
+    fillTemplate(template: string, values?: Record<string, unknown>, options?: {
+        name?: string;
+        mode?: 'replace' | 'append';
+    }): Promise<MotionTemplateResult>;
     /**
      * Starts recording a take: the playhead goes to where the take's shot will start (default:
      * the end of the scene) and plays on, and every `recordSample` (or stage gesture) is a value