@pixerate/editor 0.160.0 → 0.161.0

package/dist/paint-editor/index.cjs

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6; var _class7; var _class8; var _class9; var _class10; var _class11; var _class12;
 
-var _chunkVKF3PWKRcjs = require('../chunk-VKF3PWKR.cjs');
+var _chunk3OSXHLITcjs = require('../chunk-3OSXHLIT.cjs');
 
 
 
@@ -3155,7 +3155,7 @@ function timeLapseVideo(frameCount, width, height, fps, holdMs, name = "Time-lap
   }
   const video = { version: 1, name, width: w, height: h, fps, background: "#000000", assets, tracks: [{ id: "v1", kind: "video", clips }] };
   const durationMs = frameCount ? clips[clips.length - 1].start + clips[clips.length - 1].duration : 0;
-  return { video, ffmpeg: _chunkVKF3PWKRcjs.toVideoFfmpeg.call(void 0, video, { output: "timelapse.mp4" }), durationMs };
+  return { video, ffmpeg: _chunk3OSXHLITcjs.toVideoFfmpeg.call(void 0, video, { output: "timelapse.mp4" }), durationMs };
 }
 async function buildTimeLapse(source, target, options = {}) {
   const maxSide = Math.max(32, Math.min(4096, Math.round(_nullishCoalesce(options.maxSide, () => ( 720)))));

package/dist/paint-editor/index.js

@@ -1,6 +1,6 @@
 import {
   toVideoFfmpeg
-} from "../chunk-IQ6KKXOU.js";
+} from "../chunk-YN4AYYBJ.js";
 import {
   deserializeLayers,
   exportPsd,

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

@@ -15,6 +15,15 @@ export interface VideoAudioPeaks {
     blockSize: number;
     /** `levels[k]` is `[min, max, min, max, …]`, one pair per block of `blockSize × 4^k` samples. */
     levels: Float32Array[];
+    /**
+     * Loudness as ITU-R BS.1770 measures it: the K-weighted mean square of the channels, summed,
+     * per `hop` ms of audio (100 ms). `videoAudioLoudness` gates it into LUFS for any stretch.
+     * Absent from peaks built before it existed; `buildVideoAudioPeaks` always adds it.
+     */
+    loudness?: {
+        hop: number;
+        energy: Float32Array;
+    };
 }
 /** Samples per level-0 block (well under a millisecond at common rates). */
 export declare const VIDEO_PEAK_BLOCK = 32;

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

@@ -15,6 +15,15 @@ export interface VideoAudioPeaks {
     blockSize: number;
     /** `levels[k]` is `[min, max, min, max, …]`, one pair per block of `blockSize × 4^k` samples. */
     levels: Float32Array[];
+    /**
+     * Loudness as ITU-R BS.1770 measures it: the K-weighted mean square of the channels, summed,
+     * per `hop` ms of audio (100 ms). `videoAudioLoudness` gates it into LUFS for any stretch.
+     * Absent from peaks built before it existed; `buildVideoAudioPeaks` always adds it.
+     */
+    loudness?: {
+        hop: number;
+        energy: Float32Array;
+    };
 }
 /** Samples per level-0 block (well under a millisecond at common rates). */
 export declare const VIDEO_PEAK_BLOCK = 32;

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

@@ -6,7 +6,7 @@ export declare function videoClipKeyframes(clip: VideoClip): {
     keys: ReturnType<typeof videoKeysOf>;
 }[];
 export type VideoIssueSeverity = 'error' | 'warning' | 'note';
-export declare const VIDEO_ISSUE_CODES: readonly ["missing-asset", "missing-sequence", "sequence-cycle", "wrong-track", "overlap", "source-overrun", "transition-without-cut", "transition-too-long", "transition-handles", "fades-too-long", "animations-too-long", "animation-keyed", "keyframes-outside-clip", "unknown-duration", "unused-asset", "unused-sequence", "marker-past-end", "empty"];
+export declare const VIDEO_ISSUE_CODES: readonly ["missing-asset", "missing-sequence", "sequence-cycle", "wrong-track", "overlap", "source-overrun", "transition-without-cut", "transition-too-long", "transition-handles", "fades-too-long", "animations-too-long", "animation-keyed", "keyframes-outside-clip", "unknown-duration", "unused-asset", "unused-sequence", "marker-past-end", "missing-target-track", "empty"];
 export type VideoIssueCode = (typeof VIDEO_ISSUE_CODES)[number];
 export interface VideoIssue {
     code: VideoIssueCode;

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

@@ -6,7 +6,7 @@ export declare function videoClipKeyframes(clip: VideoClip): {
     keys: ReturnType<typeof videoKeysOf>;
 }[];
 export type VideoIssueSeverity = 'error' | 'warning' | 'note';
-export declare const VIDEO_ISSUE_CODES: readonly ["missing-asset", "missing-sequence", "sequence-cycle", "wrong-track", "overlap", "source-overrun", "transition-without-cut", "transition-too-long", "transition-handles", "fades-too-long", "animations-too-long", "animation-keyed", "keyframes-outside-clip", "unknown-duration", "unused-asset", "unused-sequence", "marker-past-end", "empty"];
+export declare const VIDEO_ISSUE_CODES: readonly ["missing-asset", "missing-sequence", "sequence-cycle", "wrong-track", "overlap", "source-overrun", "transition-without-cut", "transition-too-long", "transition-handles", "fades-too-long", "animations-too-long", "animation-keyed", "keyframes-outside-clip", "unknown-duration", "unused-asset", "unused-sequence", "marker-past-end", "missing-target-track", "empty"];
 export type VideoIssueCode = (typeof VIDEO_ISSUE_CODES)[number];
 export interface VideoIssue {
     code: VideoIssueCode;

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

@@ -17,6 +17,7 @@ import { EffectsSlot } from '../effects/helpers.cjs';
 import type { EffectDescription, EffectProvider, EffectValue } from '../effects/types.cjs';
 import { VideoEffectsEngine, type VideoEffectPlace } from './effects.cjs';
 import { type VideoAnimatable, type VideoKey } from './keyframes.cjs';
+import { type VideoEditPlan, type VideoEditPlanInput } from './plan.cjs';
 export interface VideoEditorOptions {
     /** The project to open (default: an empty 1920 × 1080, 30 fps project with tracks v1 and a1). */
     project?: VideoProject;
@@ -83,9 +84,20 @@ export interface VideoEditorState {
     previewScale: VideoPreviewScale;
     /** The registered effects provider, or `null` (effects are then drawn as placeholders and cannot be added). */
     effectsProvider: EffectProvider | null;
+    /** Proposed edit plans waiting for review, oldest first (see `proposePlan`). Not part of the project or its undo history. */
+    plans: readonly VideoEditPlan[];
     /** Bumped on every change. */
     revision: number;
 }
+/** What `applyPlan` returns: the edit result, the plan applied and whether the project had changed since it was made. */
+export type VideoPlanApplyResult = (VideoEditResult & {
+    ok: true;
+    plan: VideoEditPlan;
+    stale: boolean;
+}) | {
+    ok: false;
+    error: string;
+};
 /**
  * Headless non-linear video editor: a `VideoProject` of assets and tracks of clips, edited with
  * undoable, all-or-nothing edits (insert, ripple, trim, split, move, transitions), played on an
@@ -121,6 +133,10 @@ export declare class VideoEditorController {
     private readonly listeners;
     private readonly unsubscribers;
     private state;
+    private plans;
+    /** The project each open plan was worked out against. */
+    private readonly planBasis;
+    private planCount;
     constructor(options?: VideoEditorOptions);
     private connect;
     /** Pauses and stops listening to the player and history. Subscribing again reconnects (React StrictMode). */
@@ -145,6 +161,37 @@ export declare class VideoEditorController {
         dryRun?: boolean;
         merge?: string;
     }): VideoEditResult;
+    /** Most plans kept open at once; proposing another drops the oldest. */
+    static readonly MAX_PLANS = 20;
+    /**
+     * Works out a batch of edits without applying it and keeps it for review (see `VideoEditPlan`):
+     * the result says what it would do. Allowed while read-only (nothing changes); applying is not.
+     * A plan with the id of an open one replaces it.
+     */
+    proposePlan(input: VideoEditPlanInput): {
+        ok: true;
+        plan: VideoEditPlan;
+    } | {
+        ok: false;
+        error: string;
+    };
+    /** An open plan, or `undefined`. */
+    getPlan(id: string): VideoEditPlan | undefined;
+    /** Whether the project changed since a plan was made (its summary may then be out of date). */
+    isPlanStale(id: string): boolean;
+    /** The project as an open plan would leave it, worked out against the current project; `null` when it no longer applies. */
+    planPreview(id: string): VideoProject | null;
+    /**
+     * Applies an open plan as one undo step labelled with its title and closes it. If the project
+     * changed since it was made, its edits are checked again against the project as it is now and
+     * refused (the plan stays open) when they no longer apply.
+     */
+    applyPlan(id: string): VideoPlanApplyResult;
+    /** Closes an open plan without applying it. False when there is no such plan. */
+    discardPlan(id: string): boolean;
+    /** Closes every open plan. */
+    discardPlans(): void;
+    private dropPlan;
     /** Opens a project (JSON or object). `clearHistory` drops the undo stack (opening a file); otherwise it is one undo step. */
     load(project: VideoProject | string, options?: {
         clearHistory?: boolean;

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

@@ -17,6 +17,7 @@ import { EffectsSlot } from '../effects/helpers.js';
 import type { EffectDescription, EffectProvider, EffectValue } from '../effects/types.js';
 import { VideoEffectsEngine, type VideoEffectPlace } from './effects.js';
 import { type VideoAnimatable, type VideoKey } from './keyframes.js';
+import { type VideoEditPlan, type VideoEditPlanInput } from './plan.js';
 export interface VideoEditorOptions {
     /** The project to open (default: an empty 1920 × 1080, 30 fps project with tracks v1 and a1). */
     project?: VideoProject;
@@ -83,9 +84,20 @@ export interface VideoEditorState {
     previewScale: VideoPreviewScale;
     /** The registered effects provider, or `null` (effects are then drawn as placeholders and cannot be added). */
     effectsProvider: EffectProvider | null;
+    /** Proposed edit plans waiting for review, oldest first (see `proposePlan`). Not part of the project or its undo history. */
+    plans: readonly VideoEditPlan[];
     /** Bumped on every change. */
     revision: number;
 }
+/** What `applyPlan` returns: the edit result, the plan applied and whether the project had changed since it was made. */
+export type VideoPlanApplyResult = (VideoEditResult & {
+    ok: true;
+    plan: VideoEditPlan;
+    stale: boolean;
+}) | {
+    ok: false;
+    error: string;
+};
 /**
  * Headless non-linear video editor: a `VideoProject` of assets and tracks of clips, edited with
  * undoable, all-or-nothing edits (insert, ripple, trim, split, move, transitions), played on an
@@ -121,6 +133,10 @@ export declare class VideoEditorController {
     private readonly listeners;
     private readonly unsubscribers;
     private state;
+    private plans;
+    /** The project each open plan was worked out against. */
+    private readonly planBasis;
+    private planCount;
     constructor(options?: VideoEditorOptions);
     private connect;
     /** Pauses and stops listening to the player and history. Subscribing again reconnects (React StrictMode). */
@@ -145,6 +161,37 @@ export declare class VideoEditorController {
         dryRun?: boolean;
         merge?: string;
     }): VideoEditResult;
+    /** Most plans kept open at once; proposing another drops the oldest. */
+    static readonly MAX_PLANS = 20;
+    /**
+     * Works out a batch of edits without applying it and keeps it for review (see `VideoEditPlan`):
+     * the result says what it would do. Allowed while read-only (nothing changes); applying is not.
+     * A plan with the id of an open one replaces it.
+     */
+    proposePlan(input: VideoEditPlanInput): {
+        ok: true;
+        plan: VideoEditPlan;
+    } | {
+        ok: false;
+        error: string;
+    };
+    /** An open plan, or `undefined`. */
+    getPlan(id: string): VideoEditPlan | undefined;
+    /** Whether the project changed since a plan was made (its summary may then be out of date). */
+    isPlanStale(id: string): boolean;
+    /** The project as an open plan would leave it, worked out against the current project; `null` when it no longer applies. */
+    planPreview(id: string): VideoProject | null;
+    /**
+     * Applies an open plan as one undo step labelled with its title and closes it. If the project
+     * changed since it was made, its edits are checked again against the project as it is now and
+     * refused (the plan stays open) when they no longer apply.
+     */
+    applyPlan(id: string): VideoPlanApplyResult;
+    /** Closes an open plan without applying it. False when there is no such plan. */
+    discardPlan(id: string): boolean;
+    /** Closes every open plan. */
+    discardPlans(): void;
+    private dropPlan;
     /** Opens a project (JSON or object). `clearHistory` drops the undo stack (opening a file); otherwise it is one undo step. */
     load(project: VideoProject | string, options?: {
         clearHistory?: boolean;

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

@@ -0,0 +1,19 @@
+/**
+ * Agent tools for talking-head cleanup: find fillers, long pauses and stutters in one pass, and
+ * propose cutting them as one plan for review (plan first, then `apply_video_edit_plan`). Skill:
+ * `pixerate-talking-head-edit`.
+ */
+import type { AgentToolProvider } from '../tools/registry.cjs';
+import type { VideoEditorController } from './controller.cjs';
+export interface VideoDialogueToolProviderOptions {
+    /** Provider id (unique per registry). Default `video-dialogue`. */
+    id?: string;
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
+    namespace?: string;
+    /** The project cannot be edited: the planning tool is hidden. A string is the reason. */
+    readOnly?: boolean | string | (() => boolean | string);
+    /** The agent playback surface its calls are acted out on (default `video`). */
+    playbackSurface?: string;
+}
+/** The talking-head cleanup tools for a video editor (see the module comment). */
+export declare function createVideoDialogueToolProvider(controller: VideoEditorController, options?: VideoDialogueToolProviderOptions): AgentToolProvider;

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

@@ -0,0 +1,19 @@
+/**
+ * Agent tools for talking-head cleanup: find fillers, long pauses and stutters in one pass, and
+ * propose cutting them as one plan for review (plan first, then `apply_video_edit_plan`). Skill:
+ * `pixerate-talking-head-edit`.
+ */
+import type { AgentToolProvider } from '../tools/registry.js';
+import type { VideoEditorController } from './controller.js';
+export interface VideoDialogueToolProviderOptions {
+    /** Provider id (unique per registry). Default `video-dialogue`. */
+    id?: string;
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id, `''` for bare names. */
+    namespace?: string;
+    /** The project cannot be edited: the planning tool is hidden. A string is the reason. */
+    readOnly?: boolean | string | (() => boolean | string);
+    /** The agent playback surface its calls are acted out on (default `video`). */
+    playbackSurface?: string;
+}
+/** The talking-head cleanup tools for a video editor (see the module comment). */
+export declare function createVideoDialogueToolProvider(controller: VideoEditorController, options?: VideoDialogueToolProviderOptions): AgentToolProvider;

package/dist/video-editor/effect-authoring.d.cts

@@ -0,0 +1,54 @@
+import { type AnimationEasing } from '../animation/easing.cjs';
+import { type GenericAuthoringOptions } from '../effects/authoring-session.cjs';
+import type { EffectAuthoringDocument, EffectAuthoringSession } from '../effects/authoring.cjs';
+import type { EffectValue } from '../effects/types.cjs';
+import type { VideoEditorController, VideoEffectEditResult } from './controller.cjs';
+import { type VideoEase, type VideoKeyframes } from './keyframes.cjs';
+import type { VideoClip, VideoClipEffect } from './types.cjs';
+/**
+ * One keyframe model for clip effects and the effect authoring editor: a clip effect's values
+ * (plain values, or `{ keys }` in clip ms) open as an `EffectAuthoringDocument` (values and
+ * keyframe tracks in ms from the effect's start, which is the clip's start), are tuned and
+ * keyframed in an `EffectAuthoringSession` / `<EffectAuthoringEditor>`, and are written back to the
+ * clip as one undo step. Adjustment clips use this to tune the effects they apply to the pictures
+ * beneath them.
+ */
+/** A video ease as an animation easing (they share CSS cubic-bezier semantics). */
+export declare function videoEaseToAnimationEasing(ease: VideoEase | undefined): AnimationEasing;
+/**
+ * An animation easing as a video ease, or `null` when video keyframes cannot hold it (springs,
+ * elastics): those segments are sampled into several keys instead (see `videoEffectValuesFromDocument`).
+ */
+export declare function animationEasingToVideoEase(easing: AnimationEasing | undefined): VideoEase | null;
+/** A clip effect as an authoring document (values, keyframe tracks, the clip's length as the timeline). */
+export declare function videoClipEffectDocument(clip: VideoClip, instance: string, providerId: string): EffectAuthoringDocument;
+/**
+ * An authoring document's values and tracks as clip effect values: numeric tracks become `{ keys }`
+ * (springs and elastics sampled into several keys), other tracks keep their value at the start
+ * (video keyframes are numbers only). `notes` says what was sampled or dropped.
+ */
+export declare function videoEffectValuesFromDocument(doc: Pick<EffectAuthoringDocument, 'values' | 'tracks'>): {
+    values: Record<string, EffectValue | VideoKeyframes>;
+    notes: string[];
+};
+/** An effect authoring session opened on a clip effect, and the way to write it back. */
+export interface VideoClipEffectAuthoring {
+    readonly clip: string;
+    readonly instance: string;
+    readonly session: EffectAuthoringSession;
+    /** Writes the session's values and keyframes back to the clip effect as one undo step. */
+    commit(): Promise<VideoEffectEditResult & {
+        notes?: string[];
+    }>;
+    /** Closes the session without writing back. */
+    dispose(): void;
+}
+/**
+ * Opens a clip's effect (on any clip, adjustment clips included) in an `EffectAuthoringSession`
+ * using the editor's effects provider, with the clip's length as the timeline and its keyframes as
+ * tracks, so `<EffectAuthoringEditor>` can tune and keyframe it. Nothing changes on the clip until
+ * `commit`. Rejects with a readable error for an unknown clip or effect, or without a provider.
+ */
+export declare function openVideoClipEffectAuthoring(controller: VideoEditorController, clip: string, instance: string, options?: Omit<GenericAuthoringOptions, 'provider'>): Promise<VideoClipEffectAuthoring>;
+/** The effects of a clip a host can open for authoring (enabled or not). */
+export declare const videoAuthorableEffects: (clip: VideoClip) => readonly VideoClipEffect[];

package/dist/video-editor/effect-authoring.d.ts

@@ -0,0 +1,54 @@
+import { type AnimationEasing } from '../animation/easing.js';
+import { type GenericAuthoringOptions } from '../effects/authoring-session.js';
+import type { EffectAuthoringDocument, EffectAuthoringSession } from '../effects/authoring.js';
+import type { EffectValue } from '../effects/types.js';
+import type { VideoEditorController, VideoEffectEditResult } from './controller.js';
+import { type VideoEase, type VideoKeyframes } from './keyframes.js';
+import type { VideoClip, VideoClipEffect } from './types.js';
+/**
+ * One keyframe model for clip effects and the effect authoring editor: a clip effect's values
+ * (plain values, or `{ keys }` in clip ms) open as an `EffectAuthoringDocument` (values and
+ * keyframe tracks in ms from the effect's start, which is the clip's start), are tuned and
+ * keyframed in an `EffectAuthoringSession` / `<EffectAuthoringEditor>`, and are written back to the
+ * clip as one undo step. Adjustment clips use this to tune the effects they apply to the pictures
+ * beneath them.
+ */
+/** A video ease as an animation easing (they share CSS cubic-bezier semantics). */
+export declare function videoEaseToAnimationEasing(ease: VideoEase | undefined): AnimationEasing;
+/**
+ * An animation easing as a video ease, or `null` when video keyframes cannot hold it (springs,
+ * elastics): those segments are sampled into several keys instead (see `videoEffectValuesFromDocument`).
+ */
+export declare function animationEasingToVideoEase(easing: AnimationEasing | undefined): VideoEase | null;
+/** A clip effect as an authoring document (values, keyframe tracks, the clip's length as the timeline). */
+export declare function videoClipEffectDocument(clip: VideoClip, instance: string, providerId: string): EffectAuthoringDocument;
+/**
+ * An authoring document's values and tracks as clip effect values: numeric tracks become `{ keys }`
+ * (springs and elastics sampled into several keys), other tracks keep their value at the start
+ * (video keyframes are numbers only). `notes` says what was sampled or dropped.
+ */
+export declare function videoEffectValuesFromDocument(doc: Pick<EffectAuthoringDocument, 'values' | 'tracks'>): {
+    values: Record<string, EffectValue | VideoKeyframes>;
+    notes: string[];
+};
+/** An effect authoring session opened on a clip effect, and the way to write it back. */
+export interface VideoClipEffectAuthoring {
+    readonly clip: string;
+    readonly instance: string;
+    readonly session: EffectAuthoringSession;
+    /** Writes the session's values and keyframes back to the clip effect as one undo step. */
+    commit(): Promise<VideoEffectEditResult & {
+        notes?: string[];
+    }>;
+    /** Closes the session without writing back. */
+    dispose(): void;
+}
+/**
+ * Opens a clip's effect (on any clip, adjustment clips included) in an `EffectAuthoringSession`
+ * using the editor's effects provider, with the clip's length as the timeline and its keyframes as
+ * tracks, so `<EffectAuthoringEditor>` can tune and keyframe it. Nothing changes on the clip until
+ * `commit`. Rejects with a readable error for an unknown clip or effect, or without a provider.
+ */
+export declare function openVideoClipEffectAuthoring(controller: VideoEditorController, clip: string, instance: string, options?: Omit<GenericAuthoringOptions, 'provider'>): Promise<VideoClipEffectAuthoring>;
+/** The effects of a clip a host can open for authoring (enabled or not). */
+export declare const videoAuthorableEffects: (clip: VideoClip) => readonly VideoClipEffect[];

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

@@ -1,3 +1,4 @@
+import { type VideoLayerMask } from './mask.cjs';
 import type { EffectValue } from '../effects/types.cjs';
 import type { VideoEffectValues } from './types.cjs';
 import type { VideoAsset, VideoBlendMode, VideoGrade, VideoClip, VideoFadeCurve, VideoFit, VideoProject, VideoTextClip, VideoWipeDirection } from './types.cjs';
@@ -65,6 +66,16 @@ export interface VideoLayer {
     grade?: VideoGrade;
     /** The clip's enabled provider effects, in order, with values at this moment (see `VideoClipEffect`). */
     effects?: VideoLayerEffect[];
+    /** The clip's mask, resolved to an outline in frame pixels (before `rotation`): only what it keeps shows. */
+    mask?: VideoLayerMask;
+    /**
+     * For an adjustment clip: the scope it changed (`layers` holds the pictures it changed, drawn as
+     * one picture like a compound's, which its grade, effects and mask then apply to).
+     */
+    adjustment?: {
+        scope: 'underneath' | 'all' | 'track';
+        track?: string;
+    };
     /** For an effect clip: the provider effect drawing the picture, at `time` ms into the clip. */
     generator?: {
         effect: string;

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

@@ -1,3 +1,4 @@
+import { type VideoLayerMask } from './mask.js';
 import type { EffectValue } from '../effects/types.js';
 import type { VideoEffectValues } from './types.js';
 import type { VideoAsset, VideoBlendMode, VideoGrade, VideoClip, VideoFadeCurve, VideoFit, VideoProject, VideoTextClip, VideoWipeDirection } from './types.js';
@@ -65,6 +66,16 @@ export interface VideoLayer {
     grade?: VideoGrade;
     /** The clip's enabled provider effects, in order, with values at this moment (see `VideoClipEffect`). */
     effects?: VideoLayerEffect[];
+    /** The clip's mask, resolved to an outline in frame pixels (before `rotation`): only what it keeps shows. */
+    mask?: VideoLayerMask;
+    /**
+     * For an adjustment clip: the scope it changed (`layers` holds the pictures it changed, drawn as
+     * one picture like a compound's, which its grade, effects and mask then apply to).
+     */
+    adjustment?: {
+        scope: 'underneath' | 'all' | 'track';
+        track?: string;
+    };
     /** For an effect clip: the provider effect drawing the picture, at `time` ms into the clip. */
     generator?: {
         effect: string;

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

@@ -14,7 +14,7 @@ export interface VideoEdlOptions {
  * One track as a CMX 3600 edit decision list, for conforming in another NLE: an event per clip with
  * source and record timecode at the project's frame rate (drop-frame at 29.97 and 59.94), dissolves (`D`) for crossfades, dips and
  * wipes (`W001`), `M2` lines for speed changes, and `* FROM CLIP NAME` comments. Titles, colour
- * clips and compound clips (not flattened yet) become black (`BL`) events.
+ * clips and compound clips (not flattened yet) become black (`BL`) events; adjustment clips are left out.
  */
 export declare function toVideoEdl(project: VideoProject, options?: VideoEdlOptions): string;
 export interface VideoFfmpegOptions {
@@ -59,6 +59,12 @@ export interface VideoFfmpegOptions {
 }
 /** The provider effects in a project's video tracks that ffmpeg's filters cannot draw. */
 export declare function videoFfmpegUnsupportedEffects(project: VideoProject): VideoEffectUse[];
+/**
+ * What ffmpeg's filters cannot draw besides provider effects: clip masks, and adjustment clips
+ * other than a plain grade (and LUT at full strength) over what is underneath or the whole frame
+ * at full opacity. Each is one sentence naming the clip. Exports refuse them unless given `frames`.
+ */
+export declare function videoFfmpegUnsupportedFeatures(project: VideoProject): string[];
 /** A loudness to normalise the mix to (`loudnorm`'s I, TP and LRA). */
 export interface VideoLoudnessTarget {
     /** Integrated loudness, in LUFS (default -14, as streaming services play; -16 for podcasts, -23 for EBU R128 broadcast). */

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

@@ -14,7 +14,7 @@ export interface VideoEdlOptions {
  * One track as a CMX 3600 edit decision list, for conforming in another NLE: an event per clip with
  * source and record timecode at the project's frame rate (drop-frame at 29.97 and 59.94), dissolves (`D`) for crossfades, dips and
  * wipes (`W001`), `M2` lines for speed changes, and `* FROM CLIP NAME` comments. Titles, colour
- * clips and compound clips (not flattened yet) become black (`BL`) events.
+ * clips and compound clips (not flattened yet) become black (`BL`) events; adjustment clips are left out.
  */
 export declare function toVideoEdl(project: VideoProject, options?: VideoEdlOptions): string;
 export interface VideoFfmpegOptions {
@@ -59,6 +59,12 @@ export interface VideoFfmpegOptions {
 }
 /** The provider effects in a project's video tracks that ffmpeg's filters cannot draw. */
 export declare function videoFfmpegUnsupportedEffects(project: VideoProject): VideoEffectUse[];
+/**
+ * What ffmpeg's filters cannot draw besides provider effects: clip masks, and adjustment clips
+ * other than a plain grade (and LUT at full strength) over what is underneath or the whole frame
+ * at full opacity. Each is one sentence naming the clip. Exports refuse them unless given `frames`.
+ */
+export declare function videoFfmpegUnsupportedFeatures(project: VideoProject): string[];
 /** A loudness to normalise the mix to (`loudnorm`'s I, TP and LRA). */
 export interface VideoLoudnessTarget {
     /** Integrated loudness, in LUFS (default -14, as streaming services play; -16 for podcasts, -23 for EBU R128 broadcast). */