@pixerate/editor 0.124.1 → 0.126.0

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

@@ -1,19 +1,18 @@
-import { M as MotionCommand, a as MotionShot, b as MotionScene, c as MotionDirection, d as MotionIrisShape, e as MotionSplitOrientation, f as MotionDriver, g as MotionDrivenProperty, h as MotionRect, i as MotionBeatGrid, j as MotionCue, k as MotionCamera, l as MotionTextUnit, m as MotionCascade, n as MotionBlur, o as MotionControl, p as MotionPreset, q as MotionClip, r as FlairSvgMotion, s as FlairVectorEffect, t as FlairExportOptions, u as FlairMotionExport, v as FlairEffectOptions, w as FlairEffectDocument, x as MotionEnterStyle, y as MotionExitStyle, z as MotionCommandType, A as MotionNarration } from '../flair-D7BxyBwL.cjs';
-export { B as FLAIR_EASES, C as FLAIR_EXPORT_VERSION, D as FlairEase, E as FlairEaseName, G as FlairSpringEase, F as FlairSvgAnimation, H as MOTION_BLENDS, I as MOTION_CAMERA_MS, J as MOTION_CASCADES, K as MOTION_CLIP_TARGET, L as MOTION_COMMAND_TYPES, N as MOTION_DEFAULT_DURATIONS, O as MOTION_DEFAULT_HOLD, P as MOTION_DIRECTIONS, Q as MOTION_DRAW_MS_PER_UNIT, R as MOTION_DRAW_RANGE, S as MOTION_DRIVEN_PROPERTIES, T as MOTION_ENTER_STYLES, U as MOTION_EXIT_STYLES, V as MOTION_IRIS_SHAPES, W as MOTION_REPEAT_MODES, X as MOTION_SPLIT_ORIENTATIONS, Y as MOTION_TEXT_UNITS, Z as MOTION_TRIGGERS, _ as MotionColorPulseCommand, $ as MotionCommandBase, a0 as MotionDrawCommand, a1 as MotionDrawOrder, a2 as MotionEffectCommand, a3 as MotionEnterCommand, a4 as MotionExitCommand, a5 as MotionFadeCommand, a6 as MotionFollowCommand, a7 as MotionMatchCommand, a8 as MotionMorphCommand, a9 as MotionMoveCommand, aa as MotionPlayCommand, ab as MotionPulseCommand, ac as MotionRotateCommand, ad as MotionScaleCommand, ae as MotionShakeCommand, af as MotionStyleCommand, ag as MotionTeeterCommand, ah as MotionTrigger, ai as MotionWaitCommand, aj as MotionWaveCommand, ak as MotionWiggleCommand, al as flairAtLeast, am as flairCurveFor, an as flairEaseFor, ao as motionFlairPrimitive, ap as toFlairEffectDocument, aq as toFlairSvgMotion, ar as toFlairVectorEffect } from '../flair-D7BxyBwL.cjs';
+import { a4 as MotionCommand, a5 as MotionShot, a6 as MotionScene, f as VectorNode, i as VectorBounds, a7 as MotionDirection, a8 as MotionIrisShape, a9 as MotionSplitOrientation, aa as MotionDriver, ab as MotionDrivenProperty, ac as MotionRect, ad as MotionBeatGrid, ae as MotionCue, af as MotionCamera, ag as MotionTextUnit, ah as MotionCascade, y as VectorDocument, ai as MotionBlur, aj as MotionControl, ak as MotionPreset, al as MotionClip, am as FlairSvgMotion, an as FlairVectorEffect, C as EffectValue, T as EffectVectorMotion, ao as MotionEffectSource, h as VectorGroupNode, W as EffectsSlot, E as EffectProvider, ap as FlairExportOptions, aq as FlairMotionExport, ar as FlairEffectOptions, as as FlairEffectDocument, at as MotionEnterStyle, au as MotionExitStyle, av as MotionCommandType, aw as MotionNarration } from '../helpers-i95Ob6Vi.cjs';
+export { ax as FLAIR_EASES, ay as FLAIR_EXPORT_VERSION, az as FlairEase, aA as FlairEaseName, aB as FlairSpringEase, aC as FlairSvgAnimation, aD as MOTION_BLENDS, aE as MOTION_CAMERA_MS, aF as MOTION_CASCADES, aG as MOTION_CLIP_TARGET, aH as MOTION_COMMAND_TYPES, aI as MOTION_DEFAULT_DURATIONS, aJ as MOTION_DEFAULT_HOLD, aK as MOTION_DIRECTIONS, aL as MOTION_DRAW_MS_PER_UNIT, aM as MOTION_DRAW_RANGE, aN as MOTION_DRIVEN_PROPERTIES, aO as MOTION_ENTER_STYLES, aP as MOTION_EXIT_STYLES, aQ as MOTION_IRIS_SHAPES, aR as MOTION_REPEAT_MODES, aS as MOTION_SPLIT_ORIENTATIONS, aT as MOTION_TEXT_UNITS, aU as MOTION_TRIGGERS, aV as MotionColorPulseCommand, aW as MotionCommandBase, aX as MotionDrawCommand, aY as MotionDrawOrder, aZ as MotionEffectCommand, a_ as MotionEnterCommand, a$ as MotionExitCommand, b0 as MotionFadeCommand, b1 as MotionFollowCommand, b2 as MotionMatchCommand, b3 as MotionMorphCommand, b4 as MotionMoveCommand, b5 as MotionPlayCommand, b6 as MotionPulseCommand, b7 as MotionRotateCommand, b8 as MotionScaleCommand, b9 as MotionShakeCommand, ba as MotionStyleCommand, bb as MotionTeeterCommand, bc as MotionTrigger, bd as MotionWaitCommand, be as MotionWaveCommand, bf as MotionWiggleCommand, bg as flairAtLeast, bh as flairCurveFor, bi as flairEaseFor, bj as motionFlairPrimitive, bk as toFlairEffectDocument, bl as toFlairSvgMotion, bm as toFlairVectorEffect } from '../helpers-i95Ob6Vi.cjs';
 import { a as MotionBehavior } from '../behavior-Ymbld6jL.cjs';
 import { b as AnimationEasing } from '../easing-lM0Xo9Ni.cjs';
 import { A as AffineMatrix, B as BezierPath } from '../bezier-CBzKKDjl.cjs';
-import { f as VectorNode, i as VectorBounds, V as VectorDocument } from '../types-CznabG7m.cjs';
-import { V as VectorSvgExportOptions } from '../svg-BDrjRnL1.cjs';
+import { V as VectorSvgExportOptions } from '../svg-BkRL-fZJ.cjs';
 import { Z as ZipReadOptions } from '../zip-4nG0YAH7.cjs';
 import { A as AnimationPlayer, C as Clock } from '../player-CBtEoU2x.cjs';
 import { b as AnimationLoopMode } from '../evaluate-2S3vSPLy.cjs';
 import { H as HistoryManager } from '../HistoryManager-DeQQMBCj.cjs';
 import { a as AgentToolProvider } from '../registry-BqA1AZt0.cjs';
 import { J as JsonSchema } from '../schema-Di0CS6Pe.cjs';
-import '../brushTypes-IG7ZZjIN.cjs';
 import '../gradient-KDfCvhuj.cjs';
 import '../types-CwMPoRMU.cjs';
+import '../brushTypes-IG7ZZjIN.cjs';
 import '../types-DsiXGmjo.cjs';
 
 /**
@@ -996,6 +995,73 @@ interface PptxAnimationImport {
 /** A PowerPoint slide's shapes and animation as a scene (see the module notes). */
 declare function fromPptxAnimation(data: ArrayBuffer | ArrayBufferView, options?: PptxAnimationImportOptions): Promise<PptxAnimationImport>;
 
+/**
+ * Provider effects in the animation editor (see `@pixerate/editor/effects`).
+ *
+ * - A **motion** effect (Flair's motion primitives: `entrance.pop`, `emphasis.wiggle`…) is
+ *   applied to nodes of the artwork: the provider animates the artwork's SVG
+ *   (`applyVectorEffect` with `nodeIds`), and its changes become ordinary scene commands, so the
+ *   preview, onion skins and the Flair export and import work on them as on any command.
+ * - A **vector** effect brings its own picture (a lower third, a loader): its SVG is added to the
+ *   artwork as a group, and its changes become shots that animate that group.
+ *
+ * Every command made this way carries `source` (`instance`, `effect`, `values`), so the applied
+ * effect can be listed, changed (made again with new values, in place) or removed as a whole.
+ */
+
+/** One provider effect applied in a scene. */
+interface AppliedMotionEffect {
+    instance: string;
+    effect: string;
+    provider?: string;
+    name?: string;
+    values: Record<string, EffectValue>;
+    /** `motion`: animates artwork nodes; `vector`: its own picture, the artwork group `group`. */
+    kind: 'motion' | 'vector';
+    /** The nodes it animates (for `vector`, the group). */
+    targets: string[];
+    /** The shots holding its commands. */
+    shots: string[];
+    group?: string;
+}
+/** Every provider effect in a scene, in the order they first appear. */
+declare function motionSceneEffects(scene: MotionScene): AppliedMotionEffect[];
+/** A fresh instance id (`fx1`, `fx2`…) not used by an effect, shot or node. */
+declare function nextMotionEffectInstance(scene: MotionScene): string;
+/** The artwork as the SVG a provider animates (node ids become element ids). */
+declare const motionArtworkSvg: (artwork: VectorDocument) => string;
+/** A provider's motion for the artwork as commands (one run, timed as the provider timed it). */
+declare function motionCommandsFromEffect(artwork: VectorDocument, motion: Pick<EffectVectorMotion, 'svg' | 'animate'>, source: MotionEffectSource): {
+    commands: MotionCommand[];
+    notes: string[];
+};
+/**
+ * A vector effect's own picture and motion: a group (id `source.instance`) holding its SVG,
+ * scaled into `box` of the artwork (default the whole artwork), and the shots that animate it.
+ */
+declare function motionPartsFromVectorEffect(artwork: VectorDocument, motion: Pick<EffectVectorMotion, 'svg' | 'animate'>, source: MotionEffectSource, box?: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}): {
+    group: VectorGroupNode;
+    shots: MotionShot[];
+    notes: string[];
+};
+/**
+ * The scene without one applied effect: its commands are removed (and shots left empty by that,
+ * and a vector effect's artwork group). Returns where its commands were, to put new ones back.
+ */
+declare function withoutMotionEffect(scene: MotionScene, instance: string): {
+    scene: MotionScene;
+    place: {
+        shot: string;
+        index: number;
+    } | null;
+    removedShots: string[];
+};
+
 interface AnimationEditorOptions {
     /** The scene to open (default: an empty one over a blank 800 × 450 artwork). */
     scene?: MotionScene;
@@ -1006,7 +1072,22 @@ interface AnimationEditorOptions {
     readOnly?: boolean;
     /** Called after every change to the scene (not on playback or selection). */
     onChange?: (scene: MotionScene) => void;
+    /**
+     * An effects provider (see `@pixerate/editor/effects`) for motion effects on nodes and vector
+     * effects with their own picture. Optional: without one the editor behaves as before, and
+     * scenes keep the commands effects made. Change it later with `setEffectsProvider`.
+     */
+    effects?: EffectProvider | null;
 }
+/** What the effect edits return. */
+type MotionEffectResult = {
+    ok: true;
+    effect: AppliedMotionEffect;
+    notes: string[];
+} | {
+    ok: false;
+    error: string;
+};
 /** What is selected on the timeline: a shot, and optionally one of its commands. */
 interface AnimationEditorSelection {
     shot: string;
@@ -1037,6 +1118,8 @@ interface AnimationEditorState {
     redoLabel: string;
     /** Bumped on every change. */
     revision: number;
+    /** The registered effects provider, or `null`. */
+    effectsProvider: EffectProvider | null;
 }
 /**
  * Headless editor for a vector animation (a `MotionScene`): undoable, all-or-nothing edits,
@@ -1048,6 +1131,8 @@ interface AnimationEditorState {
 declare class AnimationEditorController {
     readonly history: HistoryManager;
     readonly player: AnimationPlayer;
+    /** The effects provider slot (see `setEffectsProvider`). */
+    readonly effects: EffectsSlot;
     private scene;
     private issues;
     private selection;
@@ -1083,9 +1168,55 @@ declare class AnimationEditorController {
      */
     apply(edits: MotionEdit | readonly MotionEdit[], label?: string, options?: {
         dryRun?: boolean;
+        merge?: string;
     }): MotionEditResult;
     /** Replaces the artwork (e.g. from a vector editor's `onChange`), as one undo step. */
     setArtwork(artwork: VectorDocument, label?: string): MotionEditResult;
+    /** The registered effects provider, or `null`. */
+    get effectsProvider(): EffectProvider | null;
+    /** Registers (or with `null` removes) the effects provider. Not an edit: no undo step. */
+    setEffectsProvider(provider: EffectProvider | null): void;
+    /** Registers `provider` and returns a function that removes it again (if it is still the one set). */
+    useEffects(provider: EffectProvider): () => void;
+    /** The provider effects applied in the scene. */
+    appliedEffects(): AppliedMotionEffect[];
+    private effectEdit;
+    private describeFor;
+    private knownNodes;
+    /**
+     * Applies a provider motion effect to artwork nodes: the provider animates them and the changes
+     * become commands, in a new shot (default) or added to the end of `shot`. One undo step.
+     * Returns the applied effect (its `instance` id changes or removes it).
+     */
+    applyMotionEffect(effect: string, targets: readonly string[], options?: {
+        values?: Record<string, EffectValue>;
+        shot?: string;
+        instance?: string;
+    }): Promise<MotionEffectResult>;
+    /**
+     * Adds a provider vector effect (one with its own picture: a lower third, a loader): its SVG as
+     * an artwork group (id: the instance) fitted into `box` (default the whole artwork), and its
+     * motion as shots after the last one. One undo step.
+     */
+    addVectorEffect(effect: string, options?: {
+        values?: Record<string, EffectValue>;
+        box?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        instance?: string;
+    }): Promise<MotionEffectResult>;
+    /**
+     * Makes an applied effect again with new `values` (merged over its own; `null` resets a
+     * control), in the same place. One undo step.
+     */
+    updateMotionEffect(instance: string, values: Record<string, EffectValue | null>, options?: {
+        merge?: string;
+    }): Promise<MotionEffectResult>;
+    /** Removes an applied effect: its commands, shots it alone filled and a vector effect's group. One undo step. Works without a provider. */
+    removeMotionEffect(instance: string): MotionEffectResult;
     /** Opens a scene (JSON or object). `clearHistory` drops the undo stack (opening a file); otherwise it is one undo step. */
     load(scene: MotionScene | string, options?: {
         clearHistory?: boolean;
@@ -1145,7 +1276,7 @@ declare function describeMotionElements(scene: MotionScene): {
     } | undefined;
     effects?: {
         id: string;
-        type: "trim" | "twist" | "roundCorners" | "puckerBloat" | "zigzag" | "wiggle" | "offset" | "merge" | "repeater" | "envelope" | "contour" | "blockShadow";
+        type: "trim" | "offset" | "contour" | "twist" | "roundCorners" | "puckerBloat" | "zigzag" | "wiggle" | "merge" | "repeater" | "envelope" | "blockShadow";
         numericParams: {
             [k: string]: unknown;
         };
@@ -1184,6 +1315,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         order?: "together" | "sequence";
         pace?: "time" | "speed";
         align?: "start" | "end";
@@ -1213,6 +1345,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         order?: "together" | "sequence";
         pace?: "time" | "speed";
         align?: "start" | "end";
@@ -1242,6 +1375,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         order?: "together" | "sequence";
         pace?: "time" | "speed";
         align?: "start" | "end";
@@ -1282,6 +1416,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1303,6 +1438,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1327,6 +1463,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1346,6 +1483,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1367,6 +1505,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1386,6 +1525,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1405,6 +1545,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1425,6 +1566,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1447,6 +1589,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1468,6 +1611,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1490,6 +1634,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1511,6 +1656,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1532,6 +1678,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1556,6 +1703,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1577,6 +1725,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1598,6 +1747,7 @@ declare function describeMotionShots(scene: MotionScene): {
         repeat?: number;
         repeatMode?: "loop" | "mirror" | "offset";
         steps?: number;
+        source?: MotionEffectSource;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1786,4 +1936,21 @@ declare function parseMotionDrivers(text: string): {
     error: string;
 };
 
-export { ANIMATION_EDITOR_AGENT_INSTRUCTIONS, AnimationEditorController, type AnimationEditorOptions, type AnimationEditorSelection, type AnimationEditorState, type AnimationEditorToolProviderOptions, FlairEffectDocument, FlairEffectOptions, FlairExportOptions, type FlairImportOptions, type FlairImportResult, FlairMotionExport, FlairSvgMotion, FlairVectorEffect, type LottieAnimation, type LottieExport, type LottieExportOptions, type LottieKeyframe, type LottieShape, type LottieValue, MOTION_ADDITIVE_PROPERTIES, MOTION_COMMAND_SCHEMA, MOTION_DRAW_EFFECT_ID, MOTION_EASE_CHOICES, MOTION_EASE_IN_OUT, MOTION_EASE_OUT, MOTION_EDIT_OPS, MOTION_ISSUE_CODES, MOTION_MIN_CHANGE_MS, MOTION_SPEED_RANGE, MOTION_TEXT_STAGGER, MotionBeatGrid, MotionBlur, MotionCamera, MotionCascade, MotionClip, type MotionClipItem, type MotionClipShape, MotionCommand, type MotionCommandTiming, MotionCommandType, type MotionContactSheetOptions, MotionControl, MotionCue, MotionDirection, MotionDrivenProperty, MotionDriver, type MotionEasingCurve, type MotionEdit, type MotionEditOp, type MotionEditOutcome, type MotionEditResult, MotionEnterStyle, MotionExitStyle, type MotionFieldInput, type MotionFieldKind, type MotionFieldSpec, type MotionFit, type MotionFitOptions, type MotionFrame, type MotionFrameOptions, type MotionGhost, MotionIrisShape, type MotionIssue, type MotionIssueCode, type MotionIssueSeverity, type MotionMatch, MotionNarration, type MotionNodeEntry, type MotionOnionSkin, type MotionOverlayOptions, type MotionPath, type MotionPathOptions, MotionPreset, type MotionProperty, MotionRect, type MotionReveal, MotionScene, MotionSceneFormatError, type MotionSegment, MotionShot, type MotionShotTiming, type MotionSmoothLeg, MotionSplitOrientation, type MotionSvgOptions, type MotionTextLayout, MotionTextUnit, type MotionTimeline, type MotionValue, type PptxAnimationImport, type PptxAnimationImportOptions, activeSegment, applyMotionControlValues, applyMotionDrivers, applyMotionEdits, checkMotionScene, clipsShapeProblems, commandShapeProblems, compileMotionScene, createAnimationEditorToolProvider, createMotionScene, defaultMotionCommand, describeMotionElements, describeMotionShots, driversShapeProblems, duplicateMotionCommandEdit, fitMotionRect, fitMotionScene, fitMotionSceneEdits, formatMotionDrivers, formatMotionNarration, freshShotId, fromFlairSvgMotion, fromFlairVectorEffect, fromPptxAnimation, highlightMotionSvg, indexMotionNodes, interpolateMotionValue, isMotionCommand, isMotionShot, matchMotionNodes, motionAddTrackKey, motionBeatAt, motionBeatTime, motionBlurTimes, motionCascade, motionClipAttrs, motionClipLayout, motionCommandDuration, motionCommandFields, motionCommandRepeat, motionCommandRows, motionCommandSlots, motionCommandSummary, motionContactSheetSvg, motionCueChoices, motionCueFromKey, motionCueKey, motionCueTime, motionCycleDuration, motionDrivenNodes, motionDriverSources, motionEaseKey, motionEasingCurve, motionEasingGuides, motionEasingPath, motionFieldEdit, motionFieldLabel, motionFollowRoute, motionFrameAt, motionFrameToSvg, motionGhosts, motionIssue, motionIssueKey, motionIssueLine, motionMovingIds, motionNodeAtElement, motionNodeClips, motionNodeOffset, motionPath, motionPathLength, motionPathsSvg, motionPropertyValue, motionRestValue, motionRevealClip, motionRevealPadding, motionRulerTicks, motionSceneShapeProblems, motionSceneToJson, motionShotAt, motionShotCueTime, motionShotTimeScale, motionStageSvg, motionTextLayout, motionTextUnits, motionTrackKey, namedWithSuggestion, parseMotionDrivers, parseMotionFieldInput, parseMotionNarration, parseMotionScene, resolveMotionCamera, resolveMotionEditRefs, segmentProgress, segmentValue, shotShapeProblems, smoothMotionLegs, smoothMotionTimes, suggestName, toLottie, trackValue, withMotionLayers, withViewBox };
+/**
+ * Agent tools for provider effects in the animation editor: the shared effect tools on artwork
+ * nodes (`apply_effect` applies a motion effect, made into commands) and `add_vector_effect`
+ * for vector effects that bring their own picture.
+ */
+
+interface AnimationEffectsToolProviderOptions {
+    /** Provider id (unique per registry). Default `animation-effects`. */
+    id?: string;
+    /** Always prefix tool names with `<namespace>__`. */
+    namespace?: string;
+    /** The scene cannot be edited: write tools are hidden. A string is the reason. */
+    readOnly?: boolean | string | (() => boolean | string);
+}
+/** The effect tools for an animation editor (see the module comment). */
+declare function createAnimationEffectsToolProvider(controller: AnimationEditorController, options?: AnimationEffectsToolProviderOptions): AgentToolProvider;
+
+export { ANIMATION_EDITOR_AGENT_INSTRUCTIONS, AnimationEditorController, type AnimationEditorOptions, type AnimationEditorSelection, type AnimationEditorState, type AnimationEditorToolProviderOptions, type AnimationEffectsToolProviderOptions, type AppliedMotionEffect, FlairEffectDocument, FlairEffectOptions, FlairExportOptions, type FlairImportOptions, type FlairImportResult, FlairMotionExport, FlairSvgMotion, FlairVectorEffect, type LottieAnimation, type LottieExport, type LottieExportOptions, type LottieKeyframe, type LottieShape, type LottieValue, MOTION_ADDITIVE_PROPERTIES, MOTION_COMMAND_SCHEMA, MOTION_DRAW_EFFECT_ID, MOTION_EASE_CHOICES, MOTION_EASE_IN_OUT, MOTION_EASE_OUT, MOTION_EDIT_OPS, MOTION_ISSUE_CODES, MOTION_MIN_CHANGE_MS, MOTION_SPEED_RANGE, MOTION_TEXT_STAGGER, MotionBeatGrid, MotionBlur, MotionCamera, MotionCascade, MotionClip, type MotionClipItem, type MotionClipShape, MotionCommand, type MotionCommandTiming, MotionCommandType, type MotionContactSheetOptions, MotionControl, MotionCue, MotionDirection, MotionDrivenProperty, MotionDriver, type MotionEasingCurve, type MotionEdit, type MotionEditOp, type MotionEditOutcome, type MotionEditResult, type MotionEffectResult, MotionEffectSource, MotionEnterStyle, MotionExitStyle, type MotionFieldInput, type MotionFieldKind, type MotionFieldSpec, type MotionFit, type MotionFitOptions, type MotionFrame, type MotionFrameOptions, type MotionGhost, MotionIrisShape, type MotionIssue, type MotionIssueCode, type MotionIssueSeverity, type MotionMatch, MotionNarration, type MotionNodeEntry, type MotionOnionSkin, type MotionOverlayOptions, type MotionPath, type MotionPathOptions, MotionPreset, type MotionProperty, MotionRect, type MotionReveal, MotionScene, MotionSceneFormatError, type MotionSegment, MotionShot, type MotionShotTiming, type MotionSmoothLeg, MotionSplitOrientation, type MotionSvgOptions, type MotionTextLayout, MotionTextUnit, type MotionTimeline, type MotionValue, type PptxAnimationImport, type PptxAnimationImportOptions, activeSegment, applyMotionControlValues, applyMotionDrivers, applyMotionEdits, checkMotionScene, clipsShapeProblems, commandShapeProblems, compileMotionScene, createAnimationEditorToolProvider, createAnimationEffectsToolProvider, createMotionScene, defaultMotionCommand, describeMotionElements, describeMotionShots, driversShapeProblems, duplicateMotionCommandEdit, fitMotionRect, fitMotionScene, fitMotionSceneEdits, formatMotionDrivers, formatMotionNarration, freshShotId, fromFlairSvgMotion, fromFlairVectorEffect, fromPptxAnimation, highlightMotionSvg, indexMotionNodes, interpolateMotionValue, isMotionCommand, isMotionShot, matchMotionNodes, motionAddTrackKey, motionArtworkSvg, motionBeatAt, motionBeatTime, motionBlurTimes, motionCascade, motionClipAttrs, motionClipLayout, motionCommandDuration, motionCommandFields, motionCommandRepeat, motionCommandRows, motionCommandSlots, motionCommandSummary, motionCommandsFromEffect, motionContactSheetSvg, motionCueChoices, motionCueFromKey, motionCueKey, motionCueTime, motionCycleDuration, motionDrivenNodes, motionDriverSources, motionEaseKey, motionEasingCurve, motionEasingGuides, motionEasingPath, motionFieldEdit, motionFieldLabel, motionFollowRoute, motionFrameAt, motionFrameToSvg, motionGhosts, motionIssue, motionIssueKey, motionIssueLine, motionMovingIds, motionNodeAtElement, motionNodeClips, motionNodeOffset, motionPartsFromVectorEffect, motionPath, motionPathLength, motionPathsSvg, motionPropertyValue, motionRestValue, motionRevealClip, motionRevealPadding, motionRulerTicks, motionSceneEffects, motionSceneShapeProblems, motionSceneToJson, motionShotAt, motionShotCueTime, motionShotTimeScale, motionStageSvg, motionTextLayout, motionTextUnits, motionTrackKey, namedWithSuggestion, nextMotionEffectInstance, parseMotionDrivers, parseMotionFieldInput, parseMotionNarration, parseMotionScene, resolveMotionCamera, resolveMotionEditRefs, segmentProgress, segmentValue, shotShapeProblems, smoothMotionLegs, smoothMotionTimes, suggestName, toLottie, trackValue, withMotionLayers, withViewBox, withoutMotionEffect };