@shotstack/shotstack-studio 2.6.1 → 2.7.0

package/dist/index.d.ts

@@ -92,10 +92,15 @@ export declare class Controls {
     private seekDistance;
     private seekDistanceLarge;
     private frameTime;
+    private pendingPaste;
     constructor(edit: Edit);
     load(): Promise<void>;
     private shouldIgnoreKeyboardEvent;
     private handleKeyDown;
+    private handlePaste;
+    /** Resolve Ctrl/Cmd+V across all paste sources. */
+    private dispatchPaste;
+    private tryAddSvgClip;
     private handleKeyUp;
 }
 
@@ -152,6 +157,21 @@ export declare class Edit {
     private loadSoundtrack;
     getEdit(): Edit_2;
     addClip(trackIdx: number, clip: Clip): void | Promise<void>;
+    addSvgClip(svgMarkup: string, opts?: {
+        trackIndex?: number;
+        start?: Seconds;
+        length?: Seconds;
+    }): Promise<void>;
+    /** Add a clip to the timeline from a Clip object or JSON string. */
+    addClipFromJson(clipOrJson: Clip | string, opts?: {
+        trackIndex?: number;
+        start?: Seconds;
+        length?: Seconds;
+    }): Promise<void>;
+    /** Paste one or more Track JSONs onto the timeline as new top tracks. */
+    addTracksFromJson(tracksOrJson: Track[] | Track | string, opts?: {
+        start?: Seconds;
+    }): Promise<void>;
     getClip(trackIdx: number, clipIdx: number): Clip | null;
     /**
      * Clear the error for a deleted clip and shift indices for remaining errors.
@@ -384,6 +404,16 @@ declare interface ReadonlyEventEmitter<TEventPayloadMap extends EventPayloadMap>
     off<K extends keyof TEventPayloadMap>(name: K, listener: Listener<TEventPayloadMap[K]>): void;
 }
 
+/**
+ * A number representing time in seconds.
+ * Used at API/configuration boundaries where users specify timing.
+ */
+declare type Seconds = number & {
+    readonly [SecondsSymbol]: typeof SecondsSymbol;
+};
+
+declare const SecondsSymbol: unique symbol;
+
 export declare class Timeline {
     private readonly edit;
     readonly element: HTMLElement;

package/dist/internal.d.ts

@@ -69,6 +69,21 @@ export declare class Edit {
     private loadSoundtrack;
     getEdit(): Edit_2;
     addClip(trackIdx: number, clip: Clip): void | Promise<void>;
+    addSvgClip(svgMarkup: string, opts?: {
+        trackIndex?: number;
+        start?: Seconds;
+        length?: Seconds;
+    }): Promise<void>;
+    /** Add a clip to the timeline from a Clip object or JSON string. */
+    addClipFromJson(clipOrJson: Clip | string, opts?: {
+        trackIndex?: number;
+        start?: Seconds;
+        length?: Seconds;
+    }): Promise<void>;
+    /** Paste one or more Track JSONs onto the timeline as new top tracks. */
+    addTracksFromJson(tracksOrJson: Track[] | Track | string, opts?: {
+        start?: Seconds;
+    }): Promise<void>;
     getClip(trackIdx: number, clipIdx: number): Clip | null;
     /**
      * Clear the error for a deleted clip and shift indices for remaining errors.
@@ -366,6 +381,16 @@ declare interface ReadonlyEventEmitter<TEventPayloadMap extends EventPayloadMap>
     off<K extends keyof TEventPayloadMap>(name: K, listener: Listener<TEventPayloadMap[K]>): void;
 }
 
+/**
+ * A number representing time in seconds.
+ * Used at API/configuration boundaries where users specify timing.
+ */
+declare type Seconds = number & {
+    readonly [SecondsSymbol]: typeof SecondsSymbol;
+};
+
+declare const SecondsSymbol: unique symbol;
+
 /**
  * Serialized format for JSON export (matches Shotstack API).
  * The replace value can be any type - strings, numbers, booleans, objects.