@unseenco/theatre-core 0.4.1 → 0.4.3

package/dist/index.d.ts

@@ -1705,6 +1705,13 @@ declare function setCoreRafDriver(driver: IRafDriver): void;
  */
 declare function isRemoteEditorWindow(): boolean;
 
+/**
+ * Drives registered GSAP animations from the sheet sequence playhead.
+ *
+ * @returns Disposer — call to detach the bridge.
+ */
+declare function attachGsapSequenceBridge(sheet: ISheet): () => void;
+
 /**
  * Returns a project of the given id, or creates one if it doesn't already exist.
  *
@@ -1790,4 +1797,4 @@ declare function val<T>(pointer: PointerType<T>): T;
  */
 type __UNSTABLE_Project_OnDiskState = OnDiskState;
 
-export { IProject, IProjectConfig, IRafDriver, ISequence, ISheet, ISheetObject, ISheetObjectOptions, ISheetOptions, UnknownShorthandCompoundProps, __UNSTABLE_Project_OnDiskState, createRafDriver, getProject, isRemoteEditorWindow, notify, onChange, setCoreRafDriver, index_d as types, val };
+export { IProject, IProjectConfig, IRafDriver, ISequence, ISheet, ISheetObject, ISheetObjectOptions, ISheetOptions, UnknownShorthandCompoundProps, __UNSTABLE_Project_OnDiskState, attachGsapSequenceBridge, createRafDriver, getProject, isRemoteEditorWindow, notify, onChange, setCoreRafDriver, index_d as types, val };

package/dist/index.js

@@ -241,28 +241,34 @@ var require_propose = __commonJS({
 // core/src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  attachGsapSequenceBridge: () => attachGsapSequenceBridge,
   createRafDriver: () => createRafDriver,
   getProject: () => getProject,
   isRemoteEditorWindow: () => isRemoteEditorWindow,
   notify: () => notify,
   onChange: () => onChange,
+  privateAPI: () => privateAPI,
   setCoreRafDriver: () => setCoreRafDriver,
+  setPrivateAPI: () => setPrivateAPI,
   types: () => propTypes_exports,
-  val: () => val10
+  val: () => val11
 });
 module.exports = __toCommonJS(index_exports);
 
 // core/src/coreExports.ts
 var coreExports_exports = {};
 __export(coreExports_exports, {
+  attachGsapSequenceBridge: () => attachGsapSequenceBridge,
   createRafDriver: () => createRafDriver,
   getProject: () => getProject,
   isRemoteEditorWindow: () => isRemoteEditorWindow,
   notify: () => notify,
   onChange: () => onChange,
+  privateAPI: () => privateAPI,
   setCoreRafDriver: () => setCoreRafDriver,
+  setPrivateAPI: () => setPrivateAPI,
   types: () => propTypes_exports,
-  val: () => val10
+  val: () => val11
 });
 
 // core/src/projects/projectsSingleton.ts
@@ -3230,11 +3236,11 @@ function sanitizeCompoundProps(props) {
         );
       }
     }
-    const val11 = props[key];
-    if (isLonghandPropType(val11)) {
-      sanitizedProps[key] = val11;
+    const val12 = props[key];
+    if (isLonghandPropType(val12)) {
+      sanitizedProps[key] = val12;
     } else {
-      sanitizedProps[key] = toLonghandProp(val11);
+      sanitizedProps[key] = toLonghandProp(val12);
     }
   }
   return sanitizedProps;
@@ -3332,15 +3338,15 @@ var file = (defaultValue, opts = {}) => {
     deserializeAndSanitize: _ensureFile
   };
 };
-var _ensureFile = (val11) => {
-  if (!val11) return void 0;
+var _ensureFile = (val12) => {
+  if (!val12) return void 0;
   let valid = true;
-  if (typeof val11.id !== "string" && ![null, void 0].includes(val11.id)) {
+  if (typeof val12.id !== "string" && ![null, void 0].includes(val12.id)) {
     valid = false;
   }
-  if (val11.type !== "file") valid = false;
+  if (val12.type !== "file") valid = false;
   if (!valid) return void 0;
-  return val11;
+  return val12;
 };
 var image = (defaultValue, opts = {}) => {
   if (process.env.NODE_ENV !== "production") {
@@ -3364,15 +3370,15 @@ var image = (defaultValue, opts = {}) => {
     deserializeAndSanitize: _ensureImage
   };
 };
-var _ensureImage = (val11) => {
-  if (!val11) return void 0;
+var _ensureImage = (val12) => {
+  if (!val12) return void 0;
   let valid = true;
-  if (typeof val11.id !== "string" && ![null, void 0].includes(val11.id)) {
+  if (typeof val12.id !== "string" && ![null, void 0].includes(val12.id)) {
     valid = false;
   }
-  if (val11.type !== "image") valid = false;
+  if (val12.type !== "image") valid = false;
   if (!valid) return void 0;
-  return val11;
+  return val12;
 };
 var number = (defaultValue, opts = {}) => {
   if (process.env.NODE_ENV !== "production") {
@@ -3495,11 +3501,11 @@ var rgba = (defaultValue = { r: 0, g: 0, b: 0, a: 1 }, opts = {}) => {
     deserializeAndSanitize: _sanitizeRgba
   };
 };
-var _sanitizeRgba = (val11) => {
-  if (!val11) return void 0;
+var _sanitizeRgba = (val12) => {
+  if (!val12) return void 0;
   let valid = true;
   for (const c2 of ["r", "g", "b", "a"]) {
-    if (!Object.prototype.hasOwnProperty.call(val11, c2) || typeof val11[c2] !== "number") {
+    if (!Object.prototype.hasOwnProperty.call(val12, c2) || typeof val12[c2] !== "number") {
       valid = false;
     }
   }
@@ -3508,7 +3514,7 @@ var _sanitizeRgba = (val11) => {
   for (const c2 of ["r", "g", "b", "a"]) {
     ;
     sanitized[c2] = Math.min(
-      Math.max(val11[c2], 0),
+      Math.max(val12[c2], 0),
       1
     );
   }
@@ -3547,8 +3553,8 @@ var boolean = (defaultValue, opts = {}) => {
     deserializeAndSanitize: _ensureBoolean
   };
 };
-var _ensureBoolean = (val11) => {
-  return typeof val11 === "boolean" ? val11 : void 0;
+var _ensureBoolean = (val12) => {
+  return typeof val12 === "boolean" ? val12 : void 0;
 };
 function leftInterpolate(left) {
   return left;
@@ -3755,8 +3761,8 @@ var TheatreSheetObject = class {
     }
     return der.getValue();
   }
-  set initialValue(val11) {
-    privateAPI(this).setInitialValue(val11);
+  set initialValue(val12) {
+    privateAPI(this).setInitialValue(val12);
   }
   showPropsOf(objects) {
     const host = privateAPI(this);
@@ -4524,9 +4530,9 @@ var SheetObject = class {
   }
   validateValue(pointer3, value) {
   }
-  setInitialValue(val11) {
-    this.validateValue(this.propsP, val11);
-    this._initialValue.set(val11);
+  setInitialValue(val12) {
+    this.validateValue(this.propsP, val12);
+    this._initialValue.set(val12);
   }
   setSessionOverride(path, value) {
     const propConfig = getPropConfigByPath(this.template.staticConfig, path);
@@ -4546,8 +4552,8 @@ var SheetObject = class {
    * Internal: called by `RemoteSync` when a value update for this object
    * arrives from a remote editor window. Not exposed on the public API.
    */
-  setRemoteOverride(val11) {
-    this._remoteOverride.set(val11);
+  setRemoteOverride(val12) {
+    this._remoteOverride.set(val12);
   }
   /**
    * Internal: used by `RemoteSync` to subscribe to this object's fully
@@ -6219,6 +6225,19 @@ function isBasicKeyframedTrack(track) {
 function isGsapClipTrack(track) {
   return track.type === "GsapClipTrack";
 }
+function gsapClipEndTime(clip) {
+  return clip.start + clip.duration;
+}
+function gsapClipSyncProgress(sequencePosition, clip) {
+  if (clip.duration <= 0) return 0;
+  if (sequencePosition < clip.start) return 0;
+  const clipEnd = gsapClipEndTime(clip);
+  if (sequencePosition >= clipEnd - 1e-5) return 1;
+  const raw = (sequencePosition - clip.start) / clip.duration;
+  if (raw <= 0) return 0;
+  if (raw >= 1) return 1;
+  return raw;
+}
 
 // core/src/sequences/Sequence.ts
 var possibleDirections = [
@@ -8347,13 +8366,13 @@ var Project = class {
 };
 
 // shared/src/utils/sanitizers.ts
-var _validateSym = (val11, thingy, range) => {
-  if (typeof val11 !== "string") {
-    return "".concat(thingy, " must be a string. ").concat(userReadableTypeOfValue_default(val11), " given.");
-  } else if (val11.trim().length !== val11.length) {
-    return "".concat(thingy, " must not have leading or trailing spaces. '").concat(val11, "' given.");
-  } else if (val11.length < range[0] || val11.length > range[1]) {
-    return "".concat(thingy, " must have between ").concat(range[0], " and ").concat(range[1], " characters. '").concat(val11, "' given.");
+var _validateSym = (val12, thingy, range) => {
+  if (typeof val12 !== "string") {
+    return "".concat(thingy, " must be a string. ").concat(userReadableTypeOfValue_default(val12), " given.");
+  } else if (val12.trim().length !== val12.length) {
+    return "".concat(thingy, " must not have leading or trailing spaces. '").concat(val12, "' given.");
+  } else if (val12.length < range[0] || val12.length > range[1]) {
+    return "".concat(thingy, " must have between ").concat(range[0], " and ").concat(range[1], " characters. '").concat(val12, "' given.");
   }
 };
 var validateName = (name, thingy, shouldThrow = false) => {
@@ -8469,8 +8488,194 @@ var TheatreProject = class {
 
 // core/src/coreExports.ts
 var import_fast_deep_equal3 = __toESM(require_fast_deep_equal());
+var import_theatre_dataverse23 = require("@unseenco/theatre-dataverse");
+var import_theatre_dataverse24 = require("@unseenco/theatre-dataverse");
+
+// shared/src/gsap/applyTimelineChildTiming.ts
+function applyTimelineChildTimingToGsap(rootAnimation, timelineChildren, childById, onRebuild) {
+  if (!timelineChildren.length) return true;
+  let ok = applyTimelineChildTimingToGsapInner(
+    rootAnimation,
+    timelineChildren,
+    childById
+  );
+  if (!ok && onRebuild) {
+    const rebuilt = onRebuild();
+    if (rebuilt) {
+      ok = applyTimelineChildTimingToGsapInner(
+        rebuilt,
+        timelineChildren,
+        childById
+      );
+    }
+  }
+  return ok;
+}
+function applyTimelineChildTimingToGsapInner(rootAnimation, timelineChildren, childById) {
+  if (!childById || timelineChildren.length === 0) return true;
+  let ok = true;
+  for (const childState of timelineChildren) {
+    const tween = childById.get(childState.childId);
+    if (!tween) continue;
+    try {
+      const t2 = tween;
+      if (typeof t2.startTime === "function") {
+        t2.startTime(childState.localStart);
+      }
+      if (typeof t2.duration === "function") {
+        t2.duration(childState.localDuration);
+      }
+    } catch {
+      ok = false;
+    }
+  }
+  return ok;
+}
+
+// shared/src/gsap/syncGsapClipProgress.ts
+function getGsapAnimationTargetKey(animation, fallbackAnimationId) {
+  const tween = animation;
+  const targets = tween.targets?.();
+  if (targets && targets.length > 0) {
+    return targets[0];
+  }
+  return fallbackAnimationId;
+}
+function syncRegisteredGsapAnimationsForClips(sequencePosition, clips) {
+  const enriched = [];
+  for (const clip of clips) {
+    const entry = getAnimationEntryBySheetAddressKey(
+      clip.sheetObjectAddressKey,
+      clip.gsapAnimationId
+    );
+    if (!entry?.animation) continue;
+    enriched.push({
+      ...clip,
+      entry,
+      targetKey: getGsapAnimationTargetKey(
+        entry.animation,
+        clip.gsapAnimationId
+      )
+    });
+  }
+  const byTarget = /* @__PURE__ */ new Map();
+  for (const item of enriched) {
+    const list = byTarget.get(item.targetKey) ?? [];
+    list.push(item);
+    byTarget.set(item.targetKey, list);
+  }
+  for (const group of byTarget.values()) {
+    const sorted = [...group].sort((a2, b2) => a2.start - b2.start);
+    for (const clip of sorted) {
+      const progress = gsapClipSyncProgress(sequencePosition, clip);
+      const entry = clip.entry;
+      const animation = entry.animation;
+      if (entry.kind === "timeline" && clip.timelineChildren && clip.timelineChildren.length > 0) {
+        applyTimelineChildTimingToGsap(
+          entry.animation,
+          clip.timelineChildren,
+          entry.timelineChildById,
+          entry.onRebuildTimeline
+        );
+        const span = clip.timelineSpan ?? readGsapTweenTimelineDuration(entry.animation);
+        const t2 = progress * Math.max(span, 0.01);
+        if (typeof animation.time === "function") {
+          animation.time(t2, true);
+        } else {
+          animation.progress?.(progress, true);
+        }
+      } else {
+        animation.progress?.(progress, true);
+      }
+    }
+  }
+}
+function readGsapTweenTimelineDuration(animation) {
+  const tween = animation;
+  const total = tween.totalDuration?.();
+  if (typeof total === "number" && total > 0) return total;
+  const d2 = tween.duration();
+  return d2 > 0 ? d2 : 1;
+}
+
+// shared/src/gsap/gsapStudioRegistryRevision.ts
 var import_theatre_dataverse21 = require("@unseenco/theatre-dataverse");
+var revisionAtom = new import_theatre_dataverse21.Atom(0);
+var gsapStudioRegistryRevisionPointer = revisionAtom.pointer;
+
+// shared/src/gsap/gsapAnimationRegistry.ts
+var DEFAULT_SHEET_INSTANCE_ID = "default";
+var REGISTRY_KEY = "__unseenco_theatre_gsap_animationRegistry__";
+function sheetObjectAddressKeyFromParts(address) {
+  const sheetInstanceId = address.sheetInstanceId ?? DEFAULT_SHEET_INSTANCE_ID;
+  return "".concat(address.projectId, "|").concat(address.sheetId, "|").concat(sheetInstanceId, "|").concat(address.objectKey);
+}
+function getStore() {
+  const g2 = globalThis;
+  if (!g2[REGISTRY_KEY]) {
+    g2[REGISTRY_KEY] = {
+      bySheetAddress: /* @__PURE__ */ new Map()
+    };
+  }
+  return g2[REGISTRY_KEY];
+}
+function getAnimationEntryBySheetAddressKey(sheetObjectAddressKey, animationId) {
+  return getStore().bySheetAddress.get(sheetObjectAddressKey)?.get(animationId);
+}
+
+// shared/src/gsap/subscribeGsapClipSyncAtPlayhead.ts
 var import_theatre_dataverse22 = require("@unseenco/theatre-dataverse");
+
+// shared/src/gsap/syncGsapClipsAtSequencePosition.ts
+function syncGsapClipsAtSequencePosition(position, clips) {
+  syncRegisteredGsapAnimationsForClips(
+    position,
+    clips
+  );
+}
+
+// shared/src/gsap/subscribeGsapClipSyncAtPlayhead.ts
+function subscribeGsapClipSyncAtPlayhead(source) {
+  const positionPointer = source.pointer.position;
+  const positionPrism = (0, import_theatre_dataverse22.pointerToPrism)(positionPointer);
+  const clipsPrism = (0, import_theatre_dataverse22.prism)(() => source.getGsapClipTimings());
+  const syncNow = () => {
+    const clips = clipsPrism.getValue();
+    if (clips.length === 0) return;
+    syncGsapClipsAtSequencePosition((0, import_theatre_dataverse22.val)(positionPointer), clips);
+  };
+  const untapPosition = positionPrism.onStale(syncNow);
+  const untapClips = clipsPrism.onStale(syncNow);
+  syncNow();
+  return () => {
+    untapPosition();
+    untapClips();
+  };
+}
+
+// core/src/gsap/attachGsapSequenceBridge.ts
+function attachGsapSequenceBridge(sheet) {
+  const sequence = sheet.sequence;
+  const sheetAddress = privateAPI(sheet).address;
+  return subscribeGsapClipSyncAtPlayhead({
+    pointer: sequence.pointer,
+    getGsapClipTimings: () => sequence.__experimental_getGsapClips().map(({ objectKey, clip }) => ({
+      sheetObjectAddressKey: sheetObjectAddressKeyFromParts({
+        projectId: sheetAddress.projectId,
+        sheetId: sheetAddress.sheetId,
+        sheetInstanceId: sheetAddress.sheetInstanceId,
+        objectKey
+      }),
+      gsapAnimationId: clip.gsapAnimationId,
+      start: clip.start,
+      duration: clip.duration,
+      timelineChildren: clip.timelineChildren,
+      timelineSpan: clip.timelineSpan
+    }))
+  });
+}
+
+// core/src/coreExports.ts
 function getProject(id, config = {}) {
   const existingProject = projectsSingleton_default.get(id);
   if (existingProject) {
@@ -8550,10 +8755,10 @@ var validateProjectIdOrThrow = (value) => {
 };
 function onChange(pointer3, callback, rafDriver) {
   const ticker = rafDriver ? privateAPI(rafDriver).ticker : getCoreTicker();
-  if ((0, import_theatre_dataverse21.isPointer)(pointer3)) {
-    const pr = (0, import_theatre_dataverse22.pointerToPrism)(pointer3);
+  if ((0, import_theatre_dataverse23.isPointer)(pointer3)) {
+    const pr = (0, import_theatre_dataverse24.pointerToPrism)(pointer3);
     return pr.onChange(ticker, callback, true);
-  } else if ((0, import_theatre_dataverse22.isPrism)(pointer3)) {
+  } else if ((0, import_theatre_dataverse24.isPrism)(pointer3)) {
     return pointer3.onChange(ticker, callback, true);
   } else {
     throw new Error(
@@ -8561,9 +8766,9 @@ function onChange(pointer3, callback, rafDriver) {
     );
   }
 }
-function val10(pointer3) {
-  if ((0, import_theatre_dataverse21.isPointer)(pointer3)) {
-    return (0, import_theatre_dataverse22.pointerToPrism)(pointer3).getValue();
+function val11(pointer3) {
+  if ((0, import_theatre_dataverse23.isPointer)(pointer3)) {
+    return (0, import_theatre_dataverse24.pointerToPrism)(pointer3).getValue();
   } else {
     throw new Error("Called val(p) where p is not a pointer.");
   }
@@ -8578,7 +8783,7 @@ var CoreBundle = class {
     return "Theatre_CoreBundle";
   }
   get version() {
-    return "0.4.1";
+    return "0.4.3";
   }
   getBitsForStudio(studio, callback) {
     if (this._studio) {