@shotstack/shotstack-studio 2.0.0-beta.1 → 2.0.0-beta.2

package/dist/index.d.ts

@@ -4469,6 +4469,7 @@ export declare class Edit extends Entity {
     mergeFields: MergeFieldService;
     private canvas;
     private lumaMaskController;
+    private clipErrors;
     /**
      * Create an Edit instance from a template configuration.
      *
@@ -4534,6 +4535,14 @@ export declare class Edit extends Entity {
     getOriginalEdit(): ResolvedEdit | null;
     addClip(trackIdx: number, clip: ResolvedClip): void | Promise<void>;
     getClip(trackIdx: number, clipIdx: number): ResolvedClip | null;
+    /**
+     * Get the error state for a clip that failed to load.
+     * Returns null if the clip loaded successfully.
+     */
+    getClipError(trackIdx: number, clipIdx: number): {
+        error: string;
+        assetType: string;
+    } | null;
     getPlayerClip(trackIdx: number, clipIdx: number): Player | null;
     /** Get the exportable asset for a clip, preserving merge field templates */
     getOriginalAsset(trackIndex: number, clipIndex: number): unknown | undefined;
@@ -4758,6 +4767,8 @@ export declare class Edit extends Entity {
      * This does NOT use the command pattern (no undo) - it's for live preview updates.
      */
     updateMergeFieldValueLive(fieldName: string, newValue: string): void;
+    /** Helper: Update merge field binding resolvedValues for a player */
+    private updateMergeFieldBindings;
     /** Helper: Update merge field occurrences in an object */
     private updateMergeFieldInObject;
     /**
@@ -4807,6 +4818,7 @@ export declare const EditEvent: {
     readonly ClipDeleted: "clip:deleted";
     readonly ClipRestored: "clip:restored";
     readonly ClipCopied: "clip:copied";
+    readonly ClipLoadFailed: "clip:loadFailed";
     readonly SelectionCleared: "selection:cleared";
     readonly EditChanged: "edit:changed";
     readonly EditUndo: "edit:undo";
@@ -4851,6 +4863,10 @@ export declare type EditEventMap = {
     [EditEvent.ClipDeleted]: ClipLocation;
     [EditEvent.ClipRestored]: ClipLocation;
     [EditEvent.ClipCopied]: ClipLocation;
+    [EditEvent.ClipLoadFailed]: ClipLocation & {
+        error: string;
+        assetType: string;
+    };
     [EditEvent.SelectionCleared]: void;
     [EditEvent.EditChanged]: {
         source: string;
@@ -10993,6 +11009,7 @@ export declare class Timeline extends TimelineEntity {
     private readonly handlePlaybackPlay;
     private readonly handlePlaybackPause;
     private readonly handleClipSelected;
+    private readonly handleClipLoadFailed;
     constructor(edit: Edit, container: HTMLElement, options?: TimelineOptions);
     /** Initialize and mount the timeline */
     load(): Promise<void>;

package/dist/schema/index.d.ts

@@ -4469,6 +4469,7 @@ export declare class Edit extends Entity {
     mergeFields: MergeFieldService;
     private canvas;
     private lumaMaskController;
+    private clipErrors;
     /**
      * Create an Edit instance from a template configuration.
      *
@@ -4534,6 +4535,14 @@ export declare class Edit extends Entity {
     getOriginalEdit(): ResolvedEdit | null;
     addClip(trackIdx: number, clip: ResolvedClip): void | Promise<void>;
     getClip(trackIdx: number, clipIdx: number): ResolvedClip | null;
+    /**
+     * Get the error state for a clip that failed to load.
+     * Returns null if the clip loaded successfully.
+     */
+    getClipError(trackIdx: number, clipIdx: number): {
+        error: string;
+        assetType: string;
+    } | null;
     getPlayerClip(trackIdx: number, clipIdx: number): Player | null;
     /** Get the exportable asset for a clip, preserving merge field templates */
     getOriginalAsset(trackIndex: number, clipIndex: number): unknown | undefined;
@@ -4758,6 +4767,8 @@ export declare class Edit extends Entity {
      * This does NOT use the command pattern (no undo) - it's for live preview updates.
      */
     updateMergeFieldValueLive(fieldName: string, newValue: string): void;
+    /** Helper: Update merge field binding resolvedValues for a player */
+    private updateMergeFieldBindings;
     /** Helper: Update merge field occurrences in an object */
     private updateMergeFieldInObject;
     /**
@@ -4807,6 +4818,7 @@ export declare const EditEvent: {
     readonly ClipDeleted: "clip:deleted";
     readonly ClipRestored: "clip:restored";
     readonly ClipCopied: "clip:copied";
+    readonly ClipLoadFailed: "clip:loadFailed";
     readonly SelectionCleared: "selection:cleared";
     readonly EditChanged: "edit:changed";
     readonly EditUndo: "edit:undo";
@@ -4851,6 +4863,10 @@ export declare type EditEventMap = {
     [EditEvent.ClipDeleted]: ClipLocation;
     [EditEvent.ClipRestored]: ClipLocation;
     [EditEvent.ClipCopied]: ClipLocation;
+    [EditEvent.ClipLoadFailed]: ClipLocation & {
+        error: string;
+        assetType: string;
+    };
     [EditEvent.SelectionCleared]: void;
     [EditEvent.EditChanged]: {
         source: string;
@@ -10993,6 +11009,7 @@ export declare class Timeline extends TimelineEntity {
     private readonly handlePlaybackPlay;
     private readonly handlePlaybackPause;
     private readonly handleClipSelected;
+    private readonly handleClipLoadFailed;
     constructor(edit: Edit, container: HTMLElement, options?: TimelineOptions);
     /** Initialize and mount the timeline */
     load(): Promise<void>;