@unseenco/theatre-core 0.3.0 → 0.4.1

package/dist/index.d.ts

@@ -210,12 +210,12 @@ type HistoricPositionalSequence = {
     }>;
 };
 /**
- * Currently just {@link BasicKeyframedTrack}.
+ * Discriminated union of sequence track kinds.
  *
  * Future: Other types of tracks can be added in, such as `MixedTrack` which would
  * look like `[keyframes, expression, moreKeyframes, anotherExpression, …]`.
  */
-type TrackData = BasicKeyframedTrack;
+type TrackData = BasicKeyframedTrack | GsapClipTrack;
 type KeyframeType = 'bezier' | 'hold';
 type Keyframe = {
     id: KeyframeId;
@@ -247,6 +247,52 @@ type BasicKeyframedTrack = TrackDataCommon<'BasicKeyframedTrack'> & {
      */
     keyframes: Keyframe[];
 };
+/**
+ * A GSAP tween segment on the Theatre sequence timeline, bridged at runtime
+ * via `@unseenco/theatre-gsap`.
+ */
+type GsapTimelineChildClip = {
+    /** Stable id for this child tween within the parent timeline clip. */
+    childId: string;
+    /** Display label in the sequence editor. */
+    label: string;
+    /** Start time in seconds on the parent GSAP timeline (at progress 0). */
+    localStart: number;
+    /** Duration in seconds on the parent GSAP timeline. */
+    localDuration: number;
+};
+/** Timing snapshot captured when a GSAP clip is first added to the sequence. */
+type GsapClipBaselineTiming = {
+    duration: number;
+    timelineSpan?: number;
+    timelineChildren?: GsapTimelineChildClip[];
+};
+type GsapClipTrack = TrackDataCommon<'GsapClipTrack'> & {
+    /**
+     * Registry animation id for this clip. Defaults to the sanitised GSAP sheet
+     * object key (e.g. `GSAP / Panel show`) when set via Studio; may differ if
+     * {@link registerGsapAnimation} was called with an explicit `id` override.
+     */
+    gsapAnimationId: string;
+    /** Sequence position where the clip starts (same units as the sequence). */
+    start: number;
+    /** Clip length on the sequence timeline. Must be &gt; 0. */
+    duration: number;
+    /**
+     * One-level child tweens when the registered animation is a GSAP timeline.
+     * Omitted for single tweens.
+     */
+    timelineChildren?: GsapTimelineChildClip[];
+    /**
+     * Parent timeline total duration in seconds when {@link timelineChildren} was
+     * last synced (used to map child local times into sequence space).
+     */
+    timelineSpan?: number;
+    /**
+     * Default clip timing before Studio edits; used by "Reset to original state".
+     */
+    baselineTiming?: GsapClipBaselineTiming;
+};
 
 type SequenceVariantId = string;
 
@@ -1144,6 +1190,16 @@ interface ISequence {
      * ```
      */
     __experimental_getKeyframes(prop: Pointer<{}>): Keyframe[];
+    /**
+     * Returns GSAP clip tracks on the active sequence variant for all objects.
+     *
+     * @experimental
+     */
+    __experimental_getGsapClips(): Array<{
+        objectKey: string;
+        trackId: SequenceTrackId;
+        clip: GsapClipTrack;
+    }>;
     /**
      * Attaches an audio source to the sequence. Playing the sequence automatically
      * plays the audio source and their times are kept in sync.

package/dist/index.js

@@ -985,6 +985,8 @@ function interpolationTripleAtPosition(ctx, trackP, timeD) {
           return (0, import_theatre_dataverse2.prism)(() => void 0);
         } else if (track.type === "BasicKeyframedTrack") {
           return _forKeyframedTrack(ctx, track, timeD);
+        } else if (track.type === "GsapClipTrack") {
+          return (0, import_theatre_dataverse2.prism)(() => void 0);
         } else {
           ctx.logger.error("Track type not yet supported.");
           return (0, import_theatre_dataverse2.prism)(() => void 0);
@@ -4002,9 +4004,13 @@ function getOrphanedTopLevelPropPathEncodings(config, sheetState, objectKey) {
 }
 function stripTransientPropsFromObjectInSheetState(sheetState, objectKey, prefixes) {
   if (prefixes.size === 0) return;
-  const staticOverrides = sheetState.staticOverrides.byObject[objectKey];
-  if (staticOverrides) {
-    sheetState.staticOverrides.byObject[objectKey] = stripTransientPathsFromSerializableMap(staticOverrides, prefixes);
+  const byObject = sheetState.staticOverrides?.byObject;
+  const staticOverrides = byObject?.[objectKey];
+  if (staticOverrides && byObject) {
+    byObject[objectKey] = stripTransientPathsFromSerializableMap(
+      staticOverrides,
+      prefixes
+    );
   }
   if (sheetState.staticOverridesByVariant) {
     for (const variantOverrides of Object.values(
@@ -6098,6 +6104,9 @@ var TheatreSequence = class {
   __experimental_getKeyframes(prop) {
     return privateAPI(this).getKeyframesOfSimpleProp(prop);
   }
+  __experimental_getGsapClips() {
+    return privateAPI(this).getGsapClips();
+  }
   async attachAudio(args) {
     const { audioContext, destinationNode, decodedBuffer, gainNode } = await resolveAudioBuffer(args);
     const playbackController = new AudioPlaybackController(
@@ -6203,6 +6212,14 @@ async function resolveAudioBuffer(args) {
   };
 }
 
+// shared/src/sequence/trackData.ts
+function isBasicKeyframedTrack(track) {
+  return track.type === "BasicKeyframedTrack";
+}
+function isGsapClipTrack(track) {
+  return track.type === "GsapClipTrack";
+}
+
 // core/src/sequences/Sequence.ts
 var possibleDirections = [
   "normal",
@@ -6303,11 +6320,57 @@ var Sequence = class {
       return [];
     }
     const track = trackData[id];
-    if (!track) {
+    if (!track || !isBasicKeyframedTrack(track)) {
       return [];
     }
     return track.keyframes;
   }
+  /**
+   * @internal Used by the public sequence API.
+   */
+  getGsapClipsForObject(objectKey) {
+    const sheetState = (0, import_theatre_dataverse14.val)(
+      this._project.pointers.historic.sheetsById[this._sheet.address.sheetId]
+    );
+    const tracksOfObject = getSequenceStateFromSheet(
+      sheetState,
+      this._sequenceVariant
+    )?.tracksByObject[objectKey];
+    if (!tracksOfObject) return [];
+    const result = [];
+    for (const [trackId, track] of Object.entries(tracksOfObject.trackData)) {
+      if (track && isGsapClipTrack(track)) {
+        result.push({ trackId, clip: track });
+      }
+    }
+    return result.sort((a2, b2) => a2.clip.start - b2.clip.start);
+  }
+  getGsapClips() {
+    const sheetState = (0, import_theatre_dataverse14.val)(
+      this._project.pointers.historic.sheetsById[this._sheet.address.sheetId]
+    );
+    const sequenceState = getSequenceStateFromSheet(
+      sheetState,
+      this._sequenceVariant
+    );
+    if (!sequenceState) return [];
+    const result = [];
+    for (const [objectKey, tracksOfObject] of Object.entries(
+      sequenceState.tracksByObject
+    )) {
+      if (!tracksOfObject) continue;
+      for (const [trackId, track] of Object.entries(tracksOfObject.trackData)) {
+        if (track && isGsapClipTrack(track)) {
+          result.push({
+            objectKey,
+            trackId,
+            clip: track
+          });
+        }
+      }
+    }
+    return result.sort((a2, b2) => a2.clip.start - b2.clip.start);
+  }
   get positionFormatter() {
     return this._positionFormatterD.getValue();
   }
@@ -8515,7 +8578,7 @@ var CoreBundle = class {
     return "Theatre_CoreBundle";
   }
   get version() {
-    return "0.3.0";
+    return "0.4.1";
   }
   getBitsForStudio(studio, callback) {
     if (this._studio) {