@shotstack/shotstack-studio 2.13.1 → 2.13.2

package/dist/index.d.ts

@@ -196,7 +196,8 @@ export declare class Edit {
     }): Edit_2;
     /**
      * Look up a clip by its stable ID.
-     * @returns The clip or null if no clip with that ID exists.
+     * @returns A copy of the clip, or null if no clip with that ID exists. Mutating the
+     * returned object has no effect on the edit — use `updateClipById` to make changes.
      */
     getClipById(clipId: string): Clip | null;
     /**

package/dist/internal.d.ts

@@ -85,7 +85,8 @@ export declare class Edit {
     }): Edit_2;
     /**
      * Look up a clip by its stable ID.
-     * @returns The clip or null if no clip with that ID exists.
+     * @returns A copy of the clip, or null if no clip with that ID exists. Mutating the
+     * returned object has no effect on the edit — use `updateClipById` to make changes.
      */
     getClipById(clipId: string): Clip | null;
     /**

package/dist/internal.es.js

@@ -42433,10 +42433,12 @@ class Da {
   // ─── ID-Based Clip Mutations (public passthroughs) ─────────────────────────
   /**
    * Look up a clip by its stable ID.
-   * @returns The clip or null if no clip with that ID exists.
+   * @returns A copy of the clip, or null if no clip with that ID exists. Mutating the
+   * returned object has no effect on the edit — use `updateClipById` to make changes.
    */
   getClipById(e) {
-    return this.document.getClipById(e)?.clip ?? null;
+    const r = this.document.getClipById(e)?.clip;
+    return r ? structuredClone(r) : null;
   }
   /**
    * Look up the (trackIndex, clipIndex) position of a clip by its stable ID.
@@ -42639,7 +42641,7 @@ class Da {
   }
   getClip(e, r) {
     const n = this.tracks[e];
-    return !n || r < 0 || r >= n.length ? null : n[r].clipConfiguration;
+    return !n || r < 0 || r >= n.length ? null : structuredClone(n[r].clipConfiguration);
   }
   /**
    * Get the error state for a clip that failed to load.
@@ -42849,7 +42851,8 @@ class Da {
   getTrack(e) {
     const r = this.clips.filter((n) => n.layer === e + 1);
     return r.length === 0 ? null : {
-      clips: r.map((n) => n.clipConfiguration)
+      // Copy so callers can't mutate (or freeze) live player state through the return value
+      clips: r.map((n) => structuredClone(n.clipConfiguration))
     };
   }
   /**