@pixerate/editor 0.159.0 → 0.161.0

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

@@ -68,6 +68,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             fadeOut?: number;
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
+            mask?: import("./types.cjs").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -96,6 +97,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             fadeOut?: number;
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
+            mask?: import("./types.cjs").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -119,6 +121,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             fadeOut?: number;
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
+            mask?: import("./types.cjs").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -147,6 +150,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             fadeOut?: number;
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
+            mask?: import("./types.cjs").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -169,9 +173,35 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             fadeOut?: number;
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
+            mask?: import("./types.cjs").VideoClipMask;
             effect: string;
             provider?: string;
             values?: import("./types.cjs").VideoEffectValues;
+        } | {
+            source?: {
+                in: number;
+                out: number;
+            } | null | undefined;
+            end: number;
+            type: "adjustment";
+            scope?: import("./types.cjs").VideoAdjustmentScope;
+            targetTrack?: string;
+            id: string;
+            name?: string;
+            start: number;
+            duration: number;
+            opacity?: VideoAnimatable;
+            transform?: import("./types.cjs").VideoTransform;
+            fit?: import("./types.cjs").VideoFit;
+            blend?: import("./types.cjs").VideoBlendMode;
+            grade?: import("./types.cjs").VideoGrade;
+            animateIn?: import("./types.cjs").VideoClipAnimation;
+            animateOut?: import("./types.cjs").VideoClipAnimation;
+            fadeIn?: number;
+            fadeOut?: number;
+            transition?: import("./types.cjs").VideoTransition;
+            effects?: import("./types.cjs").VideoClipEffect[];
+            mask?: import("./types.cjs").VideoClipMask;
         })[];
         volume?: number | undefined;
         syncLocked?: boolean | undefined;
@@ -255,6 +285,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 fadeOut?: number;
                 transition?: import("./types.cjs").VideoTransition;
                 effects?: import("./types.cjs").VideoClipEffect[];
+                mask?: import("./types.cjs").VideoClipMask;
             } | {
                 source?: {
                     in: number;
@@ -283,6 +314,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 fadeOut?: number;
                 transition?: import("./types.cjs").VideoTransition;
                 effects?: import("./types.cjs").VideoClipEffect[];
+                mask?: import("./types.cjs").VideoClipMask;
             } | {
                 source?: {
                     in: number;
@@ -306,6 +338,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 fadeOut?: number;
                 transition?: import("./types.cjs").VideoTransition;
                 effects?: import("./types.cjs").VideoClipEffect[];
+                mask?: import("./types.cjs").VideoClipMask;
             } | {
                 source?: {
                     in: number;
@@ -334,6 +367,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 fadeOut?: number;
                 transition?: import("./types.cjs").VideoTransition;
                 effects?: import("./types.cjs").VideoClipEffect[];
+                mask?: import("./types.cjs").VideoClipMask;
             } | {
                 source?: {
                     in: number;
@@ -356,9 +390,35 @@ export declare function describeVideoProject(project: VideoProject): {
                 fadeOut?: number;
                 transition?: import("./types.cjs").VideoTransition;
                 effects?: import("./types.cjs").VideoClipEffect[];
+                mask?: import("./types.cjs").VideoClipMask;
                 effect: string;
                 provider?: string;
                 values?: import("./types.cjs").VideoEffectValues;
+            } | {
+                source?: {
+                    in: number;
+                    out: number;
+                } | null | undefined;
+                end: number;
+                type: "adjustment";
+                scope?: import("./types.cjs").VideoAdjustmentScope;
+                targetTrack?: string;
+                id: string;
+                name?: string;
+                start: number;
+                duration: number;
+                opacity?: VideoAnimatable;
+                transform?: import("./types.cjs").VideoTransform;
+                fit?: import("./types.cjs").VideoFit;
+                blend?: import("./types.cjs").VideoBlendMode;
+                grade?: import("./types.cjs").VideoGrade;
+                animateIn?: import("./types.cjs").VideoClipAnimation;
+                animateOut?: import("./types.cjs").VideoClipAnimation;
+                fadeIn?: number;
+                fadeOut?: number;
+                transition?: import("./types.cjs").VideoTransition;
+                effects?: import("./types.cjs").VideoClipEffect[];
+                mask?: import("./types.cjs").VideoClipMask;
             })[];
             volume?: number | undefined;
             syncLocked?: boolean | undefined;
@@ -462,6 +522,7 @@ export declare function describeVideoProject(project: VideoProject): {
             fadeOut?: number;
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
+            mask?: import("./types.cjs").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -490,6 +551,7 @@ export declare function describeVideoProject(project: VideoProject): {
             fadeOut?: number;
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
+            mask?: import("./types.cjs").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -513,6 +575,7 @@ export declare function describeVideoProject(project: VideoProject): {
             fadeOut?: number;
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
+            mask?: import("./types.cjs").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -541,6 +604,7 @@ export declare function describeVideoProject(project: VideoProject): {
             fadeOut?: number;
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
+            mask?: import("./types.cjs").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -563,9 +627,35 @@ export declare function describeVideoProject(project: VideoProject): {
             fadeOut?: number;
             transition?: import("./types.cjs").VideoTransition;
             effects?: import("./types.cjs").VideoClipEffect[];
+            mask?: import("./types.cjs").VideoClipMask;
             effect: string;
             provider?: string;
             values?: import("./types.cjs").VideoEffectValues;
+        } | {
+            source?: {
+                in: number;
+                out: number;
+            } | null | undefined;
+            end: number;
+            type: "adjustment";
+            scope?: import("./types.cjs").VideoAdjustmentScope;
+            targetTrack?: string;
+            id: string;
+            name?: string;
+            start: number;
+            duration: number;
+            opacity?: VideoAnimatable;
+            transform?: import("./types.cjs").VideoTransform;
+            fit?: import("./types.cjs").VideoFit;
+            blend?: import("./types.cjs").VideoBlendMode;
+            grade?: import("./types.cjs").VideoGrade;
+            animateIn?: import("./types.cjs").VideoClipAnimation;
+            animateOut?: import("./types.cjs").VideoClipAnimation;
+            fadeIn?: number;
+            fadeOut?: number;
+            transition?: import("./types.cjs").VideoTransition;
+            effects?: import("./types.cjs").VideoClipEffect[];
+            mask?: import("./types.cjs").VideoClipMask;
         })[];
         volume?: number | undefined;
         syncLocked?: boolean | undefined;

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

@@ -68,6 +68,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             fadeOut?: number;
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
+            mask?: import("./types.js").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -96,6 +97,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             fadeOut?: number;
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
+            mask?: import("./types.js").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -119,6 +121,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             fadeOut?: number;
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
+            mask?: import("./types.js").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -147,6 +150,7 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             fadeOut?: number;
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
+            mask?: import("./types.js").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -169,9 +173,35 @@ export declare function describeVideoSequence(project: VideoProject, sequence: V
             fadeOut?: number;
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
+            mask?: import("./types.js").VideoClipMask;
             effect: string;
             provider?: string;
             values?: import("./types.js").VideoEffectValues;
+        } | {
+            source?: {
+                in: number;
+                out: number;
+            } | null | undefined;
+            end: number;
+            type: "adjustment";
+            scope?: import("./types.js").VideoAdjustmentScope;
+            targetTrack?: string;
+            id: string;
+            name?: string;
+            start: number;
+            duration: number;
+            opacity?: VideoAnimatable;
+            transform?: import("./types.js").VideoTransform;
+            fit?: import("./types.js").VideoFit;
+            blend?: import("./types.js").VideoBlendMode;
+            grade?: import("./types.js").VideoGrade;
+            animateIn?: import("./types.js").VideoClipAnimation;
+            animateOut?: import("./types.js").VideoClipAnimation;
+            fadeIn?: number;
+            fadeOut?: number;
+            transition?: import("./types.js").VideoTransition;
+            effects?: import("./types.js").VideoClipEffect[];
+            mask?: import("./types.js").VideoClipMask;
         })[];
         volume?: number | undefined;
         syncLocked?: boolean | undefined;
@@ -255,6 +285,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 fadeOut?: number;
                 transition?: import("./types.js").VideoTransition;
                 effects?: import("./types.js").VideoClipEffect[];
+                mask?: import("./types.js").VideoClipMask;
             } | {
                 source?: {
                     in: number;
@@ -283,6 +314,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 fadeOut?: number;
                 transition?: import("./types.js").VideoTransition;
                 effects?: import("./types.js").VideoClipEffect[];
+                mask?: import("./types.js").VideoClipMask;
             } | {
                 source?: {
                     in: number;
@@ -306,6 +338,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 fadeOut?: number;
                 transition?: import("./types.js").VideoTransition;
                 effects?: import("./types.js").VideoClipEffect[];
+                mask?: import("./types.js").VideoClipMask;
             } | {
                 source?: {
                     in: number;
@@ -334,6 +367,7 @@ export declare function describeVideoProject(project: VideoProject): {
                 fadeOut?: number;
                 transition?: import("./types.js").VideoTransition;
                 effects?: import("./types.js").VideoClipEffect[];
+                mask?: import("./types.js").VideoClipMask;
             } | {
                 source?: {
                     in: number;
@@ -356,9 +390,35 @@ export declare function describeVideoProject(project: VideoProject): {
                 fadeOut?: number;
                 transition?: import("./types.js").VideoTransition;
                 effects?: import("./types.js").VideoClipEffect[];
+                mask?: import("./types.js").VideoClipMask;
                 effect: string;
                 provider?: string;
                 values?: import("./types.js").VideoEffectValues;
+            } | {
+                source?: {
+                    in: number;
+                    out: number;
+                } | null | undefined;
+                end: number;
+                type: "adjustment";
+                scope?: import("./types.js").VideoAdjustmentScope;
+                targetTrack?: string;
+                id: string;
+                name?: string;
+                start: number;
+                duration: number;
+                opacity?: VideoAnimatable;
+                transform?: import("./types.js").VideoTransform;
+                fit?: import("./types.js").VideoFit;
+                blend?: import("./types.js").VideoBlendMode;
+                grade?: import("./types.js").VideoGrade;
+                animateIn?: import("./types.js").VideoClipAnimation;
+                animateOut?: import("./types.js").VideoClipAnimation;
+                fadeIn?: number;
+                fadeOut?: number;
+                transition?: import("./types.js").VideoTransition;
+                effects?: import("./types.js").VideoClipEffect[];
+                mask?: import("./types.js").VideoClipMask;
             })[];
             volume?: number | undefined;
             syncLocked?: boolean | undefined;
@@ -462,6 +522,7 @@ export declare function describeVideoProject(project: VideoProject): {
             fadeOut?: number;
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
+            mask?: import("./types.js").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -490,6 +551,7 @@ export declare function describeVideoProject(project: VideoProject): {
             fadeOut?: number;
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
+            mask?: import("./types.js").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -513,6 +575,7 @@ export declare function describeVideoProject(project: VideoProject): {
             fadeOut?: number;
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
+            mask?: import("./types.js").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -541,6 +604,7 @@ export declare function describeVideoProject(project: VideoProject): {
             fadeOut?: number;
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
+            mask?: import("./types.js").VideoClipMask;
         } | {
             source?: {
                 in: number;
@@ -563,9 +627,35 @@ export declare function describeVideoProject(project: VideoProject): {
             fadeOut?: number;
             transition?: import("./types.js").VideoTransition;
             effects?: import("./types.js").VideoClipEffect[];
+            mask?: import("./types.js").VideoClipMask;
             effect: string;
             provider?: string;
             values?: import("./types.js").VideoEffectValues;
+        } | {
+            source?: {
+                in: number;
+                out: number;
+            } | null | undefined;
+            end: number;
+            type: "adjustment";
+            scope?: import("./types.js").VideoAdjustmentScope;
+            targetTrack?: string;
+            id: string;
+            name?: string;
+            start: number;
+            duration: number;
+            opacity?: VideoAnimatable;
+            transform?: import("./types.js").VideoTransform;
+            fit?: import("./types.js").VideoFit;
+            blend?: import("./types.js").VideoBlendMode;
+            grade?: import("./types.js").VideoGrade;
+            animateIn?: import("./types.js").VideoClipAnimation;
+            animateOut?: import("./types.js").VideoClipAnimation;
+            fadeIn?: number;
+            fadeOut?: number;
+            transition?: import("./types.js").VideoTransition;
+            effects?: import("./types.js").VideoClipEffect[];
+            mask?: import("./types.js").VideoClipMask;
         })[];
         volume?: number | undefined;
         syncLocked?: boolean | undefined;

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

@@ -0,0 +1,106 @@
+import type { VideoEditorController } from './controller.cjs';
+import type { VideoEditResult } from './edit.cjs';
+import type { VideoEditPlan } from './plan.cjs';
+import { type VideoDisfluency, type VideoDisfluencyKind, type VideoDisfluencyOptions, type VideoTimelineWord } from './transcript.cjs';
+/** A snapshot of a transcript editor. The same object is returned until something changes. */
+export interface TranscriptVideoState {
+    /** The track whose words are shown, or `null` when nothing is transcribed. */
+    track: string | null;
+    /** The words the timeline plays on that track, in order. */
+    words: readonly VideoTimelineWord[];
+    /** The words joined with single spaces: what `textOffset` and `timeAtOffset` count in. */
+    text: string;
+    /** Index of the word under the playhead, or -1. */
+    current: number;
+    /** Selected words, first and last index (inclusive), or `null`. */
+    selection: readonly [number, number] | null;
+    /** Fillers, pauses and stutters found in the words (see `detectVideoDisfluencies`). */
+    disfluencies: readonly VideoDisfluency[];
+    /** For each word index, the kinds of disfluency it is part of (absent when none). */
+    flags: Readonly<Record<number, readonly VideoDisfluencyKind[]>>;
+    /** Whether text edits may change the timeline (false while the project is read-only). */
+    editable: boolean;
+    /** Why the last action was refused, if it was. */
+    error: string | null;
+}
+export interface TranscriptVideoOptions {
+    /** Track whose words to follow (default: the first audio track with a transcribed clip, else the first video track with one). */
+    track?: string;
+    /** How disfluencies are found (see `detectVideoDisfluencies`). */
+    disfluencies?: VideoDisfluencyOptions;
+    /**
+     * Deleting words proposes a plan for review instead of cutting at once (default false). Cleanup
+     * (`planCleanup`) always proposes one.
+     */
+    planFirst?: boolean;
+}
+/** What deleting or cleaning up did: the cut it applied, or the plan it proposed. */
+export type TranscriptVideoResult = {
+    ok: true;
+    applied: VideoEditResult & {
+        ok: true;
+    };
+    plan?: undefined;
+} | {
+    ok: true;
+    plan: VideoEditPlan;
+    applied?: undefined;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Edit video by its words: a transcript view model over a `VideoEditorController`. It keeps the
+ * words the timeline plays (from the media's transcripts), the word under the playhead, a word
+ * selection and the disfluencies found, and turns text actions into timeline edits both ways:
+ * clicking a word seeks there, playing highlights the word, deleting words cuts that stretch out on
+ * every sync-locked track, and cleanup proposes one plan for every filler, pause and stutter. Each
+ * cut is one undo step. Framework bindings render it; agents use the same functions through tools.
+ */
+export declare class TranscriptVideoController {
+    readonly controller: VideoEditorController;
+    private readonly options;
+    private readonly listeners;
+    private unsubscribe;
+    private track;
+    private selection;
+    private error;
+    private state;
+    /** Words and disfluencies are worked out once per project. */
+    private cache;
+    constructor(controller: VideoEditorController, options?: TranscriptVideoOptions);
+    getState: () => TranscriptVideoState;
+    private connect;
+    /** Listens for changes. Subscribing after `destroy` follows the editor again (React StrictMode remounts). */
+    subscribe: (listener: (state: TranscriptVideoState) => void) => (() => void);
+    /** Stops following the editor. */
+    destroy(): void;
+    private words;
+    private compute;
+    private refresh;
+    /** Follows another track's words (`undefined`: the default track). */
+    setTrack(track: string | undefined): void;
+    /** Moves the playhead to the start of a word. */
+    seekToWord(index: number): void;
+    /** Selects words `a` to `b` (either order), or clears the selection with `null`. */
+    select(a: number | null, b?: number | null): void;
+    /** Index of the word playing at a timeline time, or -1. */
+    wordAt(time: number): number;
+    /** Where word `index` begins in `text` (characters). */
+    textOffset(index: number): number;
+    /** The word a caret at `offset` characters into `text` is in (or just after), as an index; -1 when there are no words. */
+    wordAtOffset(offset: number): number;
+    /** The timeline time a caret at `offset` characters into `text` stands for: the start of its word. */
+    timeAtOffset(offset: number): number | null;
+    private fail;
+    /** Cuts ranges out (or proposes a plan to, with `plan`), as one undo step. */
+    private cut;
+    /** Deletes the selected words, cutting their stretch out of the timeline (or proposing it with `planFirst`). */
+    deleteSelection(options?: {
+        plan?: boolean;
+    }): TranscriptVideoResult;
+    /** Cuts one disfluency out at once (its index in `disfluencies`), as one undo step. */
+    removeDisfluency(index: number): TranscriptVideoResult;
+    /** Proposes one plan that cuts every disfluency of the given kinds (default all), for review. */
+    planCleanup(kinds?: readonly VideoDisfluencyKind[]): TranscriptVideoResult;
+}

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

@@ -0,0 +1,106 @@
+import type { VideoEditorController } from './controller.js';
+import type { VideoEditResult } from './edit.js';
+import type { VideoEditPlan } from './plan.js';
+import { type VideoDisfluency, type VideoDisfluencyKind, type VideoDisfluencyOptions, type VideoTimelineWord } from './transcript.js';
+/** A snapshot of a transcript editor. The same object is returned until something changes. */
+export interface TranscriptVideoState {
+    /** The track whose words are shown, or `null` when nothing is transcribed. */
+    track: string | null;
+    /** The words the timeline plays on that track, in order. */
+    words: readonly VideoTimelineWord[];
+    /** The words joined with single spaces: what `textOffset` and `timeAtOffset` count in. */
+    text: string;
+    /** Index of the word under the playhead, or -1. */
+    current: number;
+    /** Selected words, first and last index (inclusive), or `null`. */
+    selection: readonly [number, number] | null;
+    /** Fillers, pauses and stutters found in the words (see `detectVideoDisfluencies`). */
+    disfluencies: readonly VideoDisfluency[];
+    /** For each word index, the kinds of disfluency it is part of (absent when none). */
+    flags: Readonly<Record<number, readonly VideoDisfluencyKind[]>>;
+    /** Whether text edits may change the timeline (false while the project is read-only). */
+    editable: boolean;
+    /** Why the last action was refused, if it was. */
+    error: string | null;
+}
+export interface TranscriptVideoOptions {
+    /** Track whose words to follow (default: the first audio track with a transcribed clip, else the first video track with one). */
+    track?: string;
+    /** How disfluencies are found (see `detectVideoDisfluencies`). */
+    disfluencies?: VideoDisfluencyOptions;
+    /**
+     * Deleting words proposes a plan for review instead of cutting at once (default false). Cleanup
+     * (`planCleanup`) always proposes one.
+     */
+    planFirst?: boolean;
+}
+/** What deleting or cleaning up did: the cut it applied, or the plan it proposed. */
+export type TranscriptVideoResult = {
+    ok: true;
+    applied: VideoEditResult & {
+        ok: true;
+    };
+    plan?: undefined;
+} | {
+    ok: true;
+    plan: VideoEditPlan;
+    applied?: undefined;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Edit video by its words: a transcript view model over a `VideoEditorController`. It keeps the
+ * words the timeline plays (from the media's transcripts), the word under the playhead, a word
+ * selection and the disfluencies found, and turns text actions into timeline edits both ways:
+ * clicking a word seeks there, playing highlights the word, deleting words cuts that stretch out on
+ * every sync-locked track, and cleanup proposes one plan for every filler, pause and stutter. Each
+ * cut is one undo step. Framework bindings render it; agents use the same functions through tools.
+ */
+export declare class TranscriptVideoController {
+    readonly controller: VideoEditorController;
+    private readonly options;
+    private readonly listeners;
+    private unsubscribe;
+    private track;
+    private selection;
+    private error;
+    private state;
+    /** Words and disfluencies are worked out once per project. */
+    private cache;
+    constructor(controller: VideoEditorController, options?: TranscriptVideoOptions);
+    getState: () => TranscriptVideoState;
+    private connect;
+    /** Listens for changes. Subscribing after `destroy` follows the editor again (React StrictMode remounts). */
+    subscribe: (listener: (state: TranscriptVideoState) => void) => (() => void);
+    /** Stops following the editor. */
+    destroy(): void;
+    private words;
+    private compute;
+    private refresh;
+    /** Follows another track's words (`undefined`: the default track). */
+    setTrack(track: string | undefined): void;
+    /** Moves the playhead to the start of a word. */
+    seekToWord(index: number): void;
+    /** Selects words `a` to `b` (either order), or clears the selection with `null`. */
+    select(a: number | null, b?: number | null): void;
+    /** Index of the word playing at a timeline time, or -1. */
+    wordAt(time: number): number;
+    /** Where word `index` begins in `text` (characters). */
+    textOffset(index: number): number;
+    /** The word a caret at `offset` characters into `text` is in (or just after), as an index; -1 when there are no words. */
+    wordAtOffset(offset: number): number;
+    /** The timeline time a caret at `offset` characters into `text` stands for: the start of its word. */
+    timeAtOffset(offset: number): number | null;
+    private fail;
+    /** Cuts ranges out (or proposes a plan to, with `plan`), as one undo step. */
+    private cut;
+    /** Deletes the selected words, cutting their stretch out of the timeline (or proposing it with `planFirst`). */
+    deleteSelection(options?: {
+        plan?: boolean;
+    }): TranscriptVideoResult;
+    /** Cuts one disfluency out at once (its index in `disfluencies`), as one undo step. */
+    removeDisfluency(index: number): TranscriptVideoResult;
+    /** Proposes one plan that cuts every disfluency of the given kinds (default all), for review. */
+    planCleanup(kinds?: readonly VideoDisfluencyKind[]): TranscriptVideoResult;
+}

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

@@ -85,3 +85,43 @@ export declare function videoWordsRange(words: readonly VideoTimelineWord[], a:
 export declare function videoTranscriptEdit(assetId: string, text: string): VideoEdit;
 /** The word playing at a timeline time, as its index in `words`, or -1. */
 export declare function videoWordAt(words: readonly VideoTimelineWord[], time: number): number;
+export interface VideoRepetitionOptions {
+    /** Longest phrase to look for repeated (words, default 3). */
+    maxPhrase?: number;
+    /** Longest gap between a phrase and its repeat that still counts as a stutter (ms, default 1000). */
+    maxGap?: number;
+}
+/**
+ * Words said twice in a row ("I I think", "we should we should"), as timeline ranges covering the
+ * first saying and the gap up to the repeat, so cutting them leaves the phrase said once. Longer
+ * phrases are tried first; "I I I" gives two ranges. Some repeats are meant ("very very"): check them.
+ */
+export declare function findVideoRepetitions(words: readonly VideoTimelineWord[], options?: VideoRepetitionOptions): VideoTranscriptRange[];
+export type VideoDisfluencyKind = 'filler' | 'pause' | 'repetition';
+export declare const VIDEO_DISFLUENCY_KINDS: readonly ["filler", "pause", "repetition"];
+/** Something to tidy out of speech: where it is (timeline ms), what kind and what was said. */
+export interface VideoDisfluency extends VideoTranscriptRange {
+    kind: VideoDisfluencyKind;
+    /** Indexes in the word list of the first and last word it covers (for a pause: the words either side). */
+    words: [number, number];
+}
+export interface VideoDisfluencyOptions {
+    /** Which kinds to look for (default all). */
+    kinds?: readonly VideoDisfluencyKind[];
+    /** Filler words and phrases (default `VIDEO_DEFAULT_FILLERS`). */
+    fillers?: readonly string[];
+    /** How pauses are measured (default: over 700 ms, keeping 150 ms of breath either side). */
+    pauses?: VideoPauseOptions;
+    repetitions?: VideoRepetitionOptions;
+}
+/**
+ * Fillers, long pauses and stutters in one pass, in time order, each with the words it covers, so
+ * a transcript can mark them and an agent can review them before cutting. Overlapping finds are
+ * all kept (a filler inside a repetition): `mergeVideoRanges` joins them when they are cut.
+ */
+export declare function detectVideoDisfluencies(words: readonly VideoTimelineWord[], options?: VideoDisfluencyOptions): VideoDisfluency[];
+/** Cut ranges shrunk by `keep` ms at each end, so a little breath stays either side; ranges that vanish are dropped. */
+export declare function videoCutsWithMargin<T extends {
+    from: number;
+    to: number;
+}>(ranges: readonly T[], keep: number): T[];