@unseenco/theatre-gsap 0.4.0

package/dist/animationRegistry.d.ts

@@ -0,0 +1,17 @@
+import type SheetObject from '@unseenco/theatre-core/sheetObjects/SheetObject';
+import type { GsapTweenLike } from './gsapTypes';
+export type GsapAnimationRegistryEntry = {
+    id: string;
+    label: string;
+    animation: GsapTweenLike;
+    sheetObject?: SheetObject;
+    defaultDuration?: number;
+    onRebuildTimeline?: () => GsapTweenLike;
+};
+export declare function registerAnimationInRegistry(entry: GsapAnimationRegistryEntry): void;
+export declare function getAnimationEntry(sheetObject: SheetObject, animationId?: string): GsapAnimationRegistryEntry | undefined;
+export declare function getAnimationEntryById(id: string): GsapAnimationRegistryEntry | undefined;
+export declare function getAnimationEntryForSheetObject(sheetObject: SheetObject): GsapAnimationRegistryEntry | undefined;
+export declare function listAnimationEntries(): GsapAnimationRegistryEntry[];
+export declare function clearAnimationRegistryForTests(): void;
+//# sourceMappingURL=animationRegistry.d.ts.map

package/dist/animationRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animationRegistry.d.ts","sourceRoot":"","sources":["../src/animationRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,iDAAiD,CAAA;AAC9E,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,aAAa,CAAA;AAU9C,MAAM,MAAM,0BAA0B,GAAG;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,aAAa,CAAA;IACxB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,iBAAiB,CAAC,EAAE,MAAM,aAAa,CAAA;CACxC,CAAA;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,0BAA0B,GAChC,IAAI,CASN;AAsBD,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,WAAW,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,0BAA0B,GAAG,SAAS,CAExC;AAED,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,GACT,0BAA0B,GAAG,SAAS,CAIxC;AAED,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,WAAW,GACvB,0BAA0B,GAAG,SAAS,CAExC;AAED,wBAAgB,oBAAoB,IAAI,0BAA0B,EAAE,CASnE;AAED,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}

package/dist/animationRegistry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=animationRegistry.test.d.ts.map

package/dist/animationRegistry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animationRegistry.test.d.ts","sourceRoot":"","sources":["../src/animationRegistry.test.ts"],"names":[],"mappings":""}

package/dist/attachGsapSequenceBridge.d.ts

@@ -0,0 +1,8 @@
+import type { ISheet } from '@unseenco/theatre-core';
+/**
+ * Drives registered GSAP animations from the sheet sequence playhead.
+ *
+ * @returns Disposer — call to detach the bridge.
+ */
+export declare function attachGsapSequenceBridge(sheet: ISheet): () => void;
+//# sourceMappingURL=attachGsapSequenceBridge.d.ts.map

package/dist/attachGsapSequenceBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachGsapSequenceBridge.d.ts","sourceRoot":"","sources":["../src/attachGsapSequenceBridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,wBAAwB,CAAA;AAMlD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,IAAI,CAqBlE"}

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+import type { OutlineNamespaceConfig } from '@unseenco/theatre-shared/utils/outlineNamespaces';
+export type TheatreGsapConfig = {
+    /** Outline namespace segment for GSAP proxy objects (default `GSAP`). */
+    namespace?: string;
+    /** Applied to each sheet when the first GSAP object is registered on it. */
+    outlineNamespace?: OutlineNamespaceConfig;
+};
+export declare function configureTheatreGsap(config: TheatreGsapConfig): {
+    reset: () => void;
+};
+export declare function getTheatreGsapConfig(): TheatreGsapConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,kDAAkD,CAAA;AAG5F,MAAM,MAAM,iBAAiB,GAAG;IAC9B,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,sBAAsB,CAAA;CAC1C,CAAA;AASD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG;IAC/D,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB,CAYA;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD"}

package/dist/gsapTypes.d.ts

@@ -0,0 +1,11 @@
+/** Minimal GSAP tween surface used by Theatre (avoids tight coupling to GSAP's TS exports). */
+export type GsapTweenLike = {
+    pause(): void;
+    progress(value: number, suppressEvents?: boolean): number;
+    duration(): number;
+    totalDuration?(): number;
+    time?(value: number, suppressEvents?: boolean): number;
+    getChildren?(nested: boolean, tweens: boolean, timelines: boolean): GsapTweenLike[];
+    startTime?(value?: number): number;
+};
+//# sourceMappingURL=gsapTypes.d.ts.map

package/dist/gsapTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsapTypes.d.ts","sourceRoot":"","sources":["../src/gsapTypes.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,IAAI,IAAI,CAAA;IACb,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACzD,QAAQ,IAAI,MAAM,CAAA;IAClB,aAAa,CAAC,IAAI,MAAM,CAAA;IACxB,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACtD,WAAW,CAAC,CACV,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,OAAO,GACjB,aAAa,EAAE,CAAA;IAClB,SAAS,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACnC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { registerGsapAnimation } from './registerGsapAnimation';
+export type { RegisterGsapAnimationOptions, RegisterGsapAnimationResult, } from './registerGsapAnimation';
+export { attachGsapSequenceBridge } from './attachGsapSequenceBridge';
+export { configureTheatreGsap, getTheatreGsapConfig } from './config';
+export type { TheatreGsapConfig } from './config';
+export { getAnimationEntry, getAnimationEntryById, getAnimationEntryForSheetObject, listAnimationEntries, } from './animationRegistry';
+export type { GsapAnimationRegistryEntry } from './animationRegistry';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAA;AAC7D,YAAY,EACV,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAC,wBAAwB,EAAC,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAC,oBAAoB,EAAE,oBAAoB,EAAC,MAAM,UAAU,CAAA;AACnE,YAAY,EAAC,iBAAiB,EAAC,MAAM,UAAU,CAAA;AAC/C,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAC,0BAA0B,EAAC,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -0,0 +1,161 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  attachGsapSequenceBridge: () => attachGsapSequenceBridge,
+  configureTheatreGsap: () => configureTheatreGsap,
+  getAnimationEntry: () => getAnimationEntry,
+  getAnimationEntryById: () => getAnimationEntryById,
+  getAnimationEntryForSheetObject: () => getAnimationEntryForSheetObject,
+  getTheatreGsapConfig: () => getTheatreGsapConfig,
+  listAnimationEntries: () => listAnimationEntries,
+  registerGsapAnimation: () => registerGsapAnimation
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/registerGsapAnimation.ts
+var import_privateAPIs = require("@unseenco/theatre-core/privateAPIs");
+var import_buildGsapSheetObjectKey = require("@unseenco/theatre-shared/gsap/buildGsapSheetObjectKey");
+var import_gsapAnimationRegistry2 = require("@unseenco/theatre-shared/gsap/gsapAnimationRegistry");
+
+// src/config.ts
+var import_gsapSheetObjectKey = require("@unseenco/theatre-shared/gsap/gsapSheetObjectKey");
+var activeConfig = {
+  namespace: "GSAP",
+  outlineNamespace: { defaultCollapsed: false }
+};
+(0, import_gsapSheetObjectKey.setConfiguredGsapSheetObjectNamespace)(activeConfig.namespace);
+function configureTheatreGsap(config) {
+  const prev = activeConfig;
+  activeConfig = {
+    namespace: config.namespace ?? prev.namespace ?? "GSAP",
+    outlineNamespace: config.outlineNamespace ?? prev.outlineNamespace
+  };
+  (0, import_gsapSheetObjectKey.setConfiguredGsapSheetObjectNamespace)(activeConfig.namespace ?? "GSAP");
+  return {
+    reset() {
+      activeConfig = prev;
+    }
+  };
+}
+function getTheatreGsapConfig() {
+  return activeConfig;
+}
+
+// src/animationRegistry.ts
+var import_gsapAnimationRegistry = require("@unseenco/theatre-shared/gsap/gsapAnimationRegistry");
+var import_syncGsapClipProgress = require("@unseenco/theatre-shared/gsap/syncGsapClipProgress");
+function registerAnimationInRegistry(entry) {
+  (0, import_gsapAnimationRegistry.registerAnimationInRegistry)({
+    ...entry,
+    animation: entry.animation,
+    defaultDuration: entry.defaultDuration ?? defaultClipDuration(entry.animation),
+    onRebuildTimeline: entry.onRebuildTimeline
+  });
+}
+function defaultClipDuration(animation) {
+  return (0, import_syncGsapClipProgress.readGsapTweenTimelineDuration)(animation);
+}
+function toPackageEntry(entry) {
+  if (!entry || !entry.animation)
+    return void 0;
+  return {
+    id: entry.id,
+    label: entry.label,
+    animation: entry.animation,
+    sheetObject: entry.sheetObject,
+    defaultDuration: entry.defaultDuration,
+    onRebuildTimeline: entry.onRebuildTimeline
+  };
+}
+function getAnimationEntry(sheetObject, animationId) {
+  return toPackageEntry((0, import_gsapAnimationRegistry.getAnimationEntry)(sheetObject, animationId));
+}
+function getAnimationEntryById(id) {
+  return toPackageEntry(
+    (0, import_gsapAnimationRegistry.listAnimationEntries)().find((entry) => entry.id === id)
+  );
+}
+function getAnimationEntryForSheetObject(sheetObject) {
+  return toPackageEntry((0, import_gsapAnimationRegistry.getAnimationEntryForSheetObject)(sheetObject));
+}
+function listAnimationEntries() {
+  return (0, import_gsapAnimationRegistry.listAnimationEntries)().filter((e) => !!e.animation).map((entry) => ({
+    id: entry.id,
+    label: entry.label,
+    animation: entry.animation,
+    sheetObject: entry.sheetObject
+  }));
+}
+
+// src/registerGsapAnimation.ts
+var import_outlineNamespaces = require("@unseenco/theatre-shared/utils/outlineNamespaces");
+function registerGsapAnimation(animation, sheet, options) {
+  const config = getTheatreGsapConfig();
+  const namespace = options.namespace ?? config.namespace ?? "GSAP";
+  const objectKey = (0, import_buildGsapSheetObjectKey.buildGsapSheetObjectKey)(namespace, options.label);
+  const id = options.id ?? objectKey;
+  animation.pause();
+  const sheetObjectPublic = sheet.object(objectKey, {}, { reconfigure: false });
+  const sheetObjectInternal = (0, import_privateAPIs.privateAPI)(sheetObjectPublic);
+  const existing = (0, import_gsapAnimationRegistry2.getAnimationEntry)(sheetObjectInternal, id);
+  if (config.outlineNamespace && !existing) {
+    (0, import_privateAPIs.privateAPI)(sheet).template.setOutlineNamespaceConfig(
+      (0, import_outlineNamespaces.formatOutlineNamespacePathKey)([namespace]),
+      config.outlineNamespace
+    );
+  }
+  registerAnimationInRegistry({
+    id,
+    label: options.label,
+    animation,
+    sheetObject: sheetObjectInternal,
+    defaultDuration: options.defaultDuration,
+    onRebuildTimeline: options.onRebuildTimeline
+  });
+  return { id, sheetObject: sheetObjectPublic };
+}
+
+// src/attachGsapSequenceBridge.ts
+var import_privateAPIs2 = require("@unseenco/theatre-core/privateAPIs");
+var import_gsapAnimationRegistry3 = require("@unseenco/theatre-shared/gsap/gsapAnimationRegistry");
+var import_subscribeGsapClipSyncAtPlayhead = require("@unseenco/theatre-shared/gsap/subscribeGsapClipSyncAtPlayhead");
+function attachGsapSequenceBridge(sheet) {
+  const sequence = sheet.sequence;
+  const sheetAddress = (0, import_privateAPIs2.privateAPI)(sheet).address;
+  return (0, import_subscribeGsapClipSyncAtPlayhead.subscribeGsapClipSyncAtPlayhead)({
+    pointer: sequence.pointer,
+    getGsapClipTimings: () => sequence.__experimental_getGsapClips().map(({ objectKey, clip }) => ({
+      sheetObjectAddressKey: (0, import_gsapAnimationRegistry3.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
+    }))
+  });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/registerGsapAnimation.ts", "../src/config.ts", "../src/animationRegistry.ts", "../src/attachGsapSequenceBridge.ts"],
+  "sourcesContent": ["export {registerGsapAnimation} from './registerGsapAnimation'\r\nexport type {\r\n  RegisterGsapAnimationOptions,\r\n  RegisterGsapAnimationResult,\r\n} from './registerGsapAnimation'\r\nexport {attachGsapSequenceBridge} from './attachGsapSequenceBridge'\r\nexport {configureTheatreGsap, getTheatreGsapConfig} from './config'\r\nexport type {TheatreGsapConfig} from './config'\r\nexport {\r\n  getAnimationEntry,\r\n  getAnimationEntryById,\r\n  getAnimationEntryForSheetObject,\r\n  listAnimationEntries,\r\n} from './animationRegistry'\r\nexport type {GsapAnimationRegistryEntry} from './animationRegistry'\r\n", "import type {ISheet, ISheetObject} from '@unseenco/theatre-core'\r\nimport type {GsapTweenLike} from './gsapTypes'\r\nimport {privateAPI} from '@unseenco/theatre-core/privateAPIs'\r\nimport {buildGsapSheetObjectKey} from '@unseenco/theatre-shared/gsap/buildGsapSheetObjectKey'\r\nimport {getAnimationEntry} from '@unseenco/theatre-shared/gsap/gsapAnimationRegistry'\r\nimport {getTheatreGsapConfig} from './config'\r\nimport {registerAnimationInRegistry} from './animationRegistry'\r\nimport {formatOutlineNamespacePathKey} from '@unseenco/theatre-shared/utils/outlineNamespaces'\r\n\r\nexport type RegisterGsapAnimationOptions = {\r\n  /** Theatre object label (shown after the `GSAP/` namespace). */\r\n  label: string\r\n  /** Override namespace from {@link configureTheatreGsap}. */\r\n  namespace?: string\r\n  /**\r\n   * Stable id for this animation on the sheet object. When omitted, defaults to\r\n   * the sanitised sheet object key (e.g. `GSAP / Panel show`).\r\n   * Re-registering with the same id updates the registry entry in place.\r\n   */\r\n  id?: string\r\n  /** Clip length when adding to the sequence (defaults to tween duration). */\r\n  defaultDuration?: number\r\n  /** Rebuild the timeline when native child timing edits fail. */\r\n  onRebuildTimeline?: () => GsapTweenLike\r\n}\r\n\r\nexport type RegisterGsapAnimationResult = {\r\n  id: string\r\n  sheetObject: ISheetObject<{}>\r\n}\r\n\r\n/**\r\n * Registers a GSAP tween for Theatre sequence bridging and creates an outline\r\n * proxy object under `GSAP/<label>` (namespace configurable).\r\n *\r\n * The animation is paused immediately so Theatre can drive progress.\r\n */\r\nexport function registerGsapAnimation(\r\n  animation: GsapTweenLike,\r\n  sheet: ISheet,\r\n  options: RegisterGsapAnimationOptions,\r\n): RegisterGsapAnimationResult {\r\n  const config = getTheatreGsapConfig()\r\n  const namespace = options.namespace ?? config.namespace ?? 'GSAP'\r\n  const objectKey = buildGsapSheetObjectKey(namespace, options.label)\r\n  const id = options.id ?? objectKey\r\n\r\n  animation.pause()\r\n\r\n  const sheetObjectPublic = sheet.object(objectKey, {}, {reconfigure: false})\r\n  const sheetObjectInternal = privateAPI(sheetObjectPublic)\r\n\r\n  const existing = getAnimationEntry(sheetObjectInternal, id)\r\n\r\n  if (config.outlineNamespace && !existing) {\r\n    privateAPI(sheet).template.setOutlineNamespaceConfig(\r\n      formatOutlineNamespacePathKey([namespace]),\r\n      config.outlineNamespace,\r\n    )\r\n  }\r\n\r\n  registerAnimationInRegistry({\r\n    id,\r\n    label: options.label,\r\n    animation,\r\n    sheetObject: sheetObjectInternal,\r\n    defaultDuration: options.defaultDuration,\r\n    onRebuildTimeline: options.onRebuildTimeline,\r\n  })\r\n\r\n  return {id, sheetObject: sheetObjectPublic}\r\n}\r\n", "import type {OutlineNamespaceConfig} from '@unseenco/theatre-shared/utils/outlineNamespaces'\r\nimport {setConfiguredGsapSheetObjectNamespace} from '@unseenco/theatre-shared/gsap/gsapSheetObjectKey'\r\n\r\nexport type TheatreGsapConfig = {\r\n  /** Outline namespace segment for GSAP proxy objects (default `GSAP`). */\r\n  namespace?: string\r\n  /** Applied to each sheet when the first GSAP object is registered on it. */\r\n  outlineNamespace?: OutlineNamespaceConfig\r\n}\r\n\r\nlet activeConfig: TheatreGsapConfig = {\r\n  namespace: 'GSAP',\r\n  outlineNamespace: {defaultCollapsed: false},\r\n}\r\n\r\nsetConfiguredGsapSheetObjectNamespace(activeConfig.namespace!)\r\n\r\nexport function configureTheatreGsap(config: TheatreGsapConfig): {\r\n  reset: () => void\r\n} {\r\n  const prev = activeConfig\r\n  activeConfig = {\r\n    namespace: config.namespace ?? prev.namespace ?? 'GSAP',\r\n    outlineNamespace: config.outlineNamespace ?? prev.outlineNamespace,\r\n  }\r\n  setConfiguredGsapSheetObjectNamespace(activeConfig.namespace ?? 'GSAP')\r\n  return {\r\n    reset() {\r\n      activeConfig = prev\r\n    },\r\n  }\r\n}\r\n\r\nexport function getTheatreGsapConfig(): TheatreGsapConfig {\r\n  return activeConfig\r\n}\r\n", "import type SheetObject from '@unseenco/theatre-core/sheetObjects/SheetObject'\r\nimport type {GsapTweenLike} from './gsapTypes'\r\nimport {\r\n  clearAnimationRegistryForTests as clearSharedAnimationRegistryForTests,\r\n  getAnimationEntry as getSharedAnimationEntry,\r\n  getAnimationEntryForSheetObject as getSharedAnimationEntryForSheetObject,\r\n  listAnimationEntries as listSharedAnimationEntries,\r\n  registerAnimationInRegistry as registerSharedAnimationInRegistry,\r\n} from '@unseenco/theatre-shared/gsap/gsapAnimationRegistry'\r\nimport {readGsapTweenTimelineDuration} from '@unseenco/theatre-shared/gsap/syncGsapClipProgress'\r\n\r\nexport type GsapAnimationRegistryEntry = {\r\n  id: string\r\n  label: string\r\n  animation: GsapTweenLike\r\n  sheetObject?: SheetObject\r\n  defaultDuration?: number\r\n  onRebuildTimeline?: () => GsapTweenLike\r\n}\r\n\r\nexport function registerAnimationInRegistry(\r\n  entry: GsapAnimationRegistryEntry,\r\n): void {\r\n  registerSharedAnimationInRegistry({\r\n    ...entry,\r\n    animation: entry.animation,\r\n    defaultDuration:\r\n      entry.defaultDuration ??\r\n      defaultClipDuration(entry.animation as GsapTweenLike),\r\n    onRebuildTimeline: entry.onRebuildTimeline,\r\n  })\r\n}\r\n\r\nfunction defaultClipDuration(animation: GsapTweenLike): number {\r\n  return readGsapTweenTimelineDuration(animation)\r\n}\r\n\r\nfunction toPackageEntry(\r\n  entry: ReturnType<typeof getSharedAnimationEntryForSheetObject>,\r\n): GsapAnimationRegistryEntry | undefined {\r\n  if (!entry || !entry.animation) return undefined\r\n  return {\r\n    id: entry.id,\r\n    label: entry.label,\r\n    animation: entry.animation as GsapTweenLike,\r\n    sheetObject: entry.sheetObject,\r\n    defaultDuration: entry.defaultDuration,\r\n    onRebuildTimeline: entry.onRebuildTimeline as\r\n      | (() => GsapTweenLike)\r\n      | undefined,\r\n  }\r\n}\r\n\r\nexport function getAnimationEntry(\r\n  sheetObject: SheetObject,\r\n  animationId?: string,\r\n): GsapAnimationRegistryEntry | undefined {\r\n  return toPackageEntry(getSharedAnimationEntry(sheetObject, animationId))\r\n}\r\n\r\nexport function getAnimationEntryById(\r\n  id: string,\r\n): GsapAnimationRegistryEntry | undefined {\r\n  return toPackageEntry(\r\n    listSharedAnimationEntries().find((entry) => entry.id === id),\r\n  )\r\n}\r\n\r\nexport function getAnimationEntryForSheetObject(\r\n  sheetObject: SheetObject,\r\n): GsapAnimationRegistryEntry | undefined {\r\n  return toPackageEntry(getSharedAnimationEntryForSheetObject(sheetObject))\r\n}\r\n\r\nexport function listAnimationEntries(): GsapAnimationRegistryEntry[] {\r\n  return listSharedAnimationEntries()\r\n    .filter((e): e is typeof e & {animation: GsapTweenLike} => !!e.animation)\r\n    .map((entry) => ({\r\n      id: entry.id,\r\n      label: entry.label,\r\n      animation: entry.animation as GsapTweenLike,\r\n      sheetObject: entry.sheetObject,\r\n    }))\r\n}\r\n\r\nexport function clearAnimationRegistryForTests(): void {\r\n  clearSharedAnimationRegistryForTests()\r\n}\r\n", "import type {ISheet} from '@unseenco/theatre-core'\r\nimport {privateAPI} from '@unseenco/theatre-core/privateAPIs'\r\nimport {sheetObjectAddressKeyFromParts} from '@unseenco/theatre-shared/gsap/gsapAnimationRegistry'\r\nimport type {ObjectAddressKey} from '@unseenco/theatre-shared/utils/ids'\r\nimport {subscribeGsapClipSyncAtPlayhead} from '@unseenco/theatre-shared/gsap/subscribeGsapClipSyncAtPlayhead'\r\n\r\n/**\r\n * Drives registered GSAP animations from the sheet sequence playhead.\r\n *\r\n * @returns Disposer \u2014 call to detach the bridge.\r\n */\r\nexport function attachGsapSequenceBridge(sheet: ISheet): () => void {\r\n  const sequence = sheet.sequence\r\n  const sheetAddress = privateAPI(sheet).address\r\n\r\n  return subscribeGsapClipSyncAtPlayhead({\r\n    pointer: sequence.pointer,\r\n    getGsapClipTimings: () =>\r\n      sequence.__experimental_getGsapClips().map(({objectKey, clip}) => ({\r\n        sheetObjectAddressKey: sheetObjectAddressKeyFromParts({\r\n          projectId: sheetAddress.projectId,\r\n          sheetId: sheetAddress.sheetId,\r\n          sheetInstanceId: sheetAddress.sheetInstanceId,\r\n          objectKey: objectKey as ObjectAddressKey,\r\n        }),\r\n        gsapAnimationId: clip.gsapAnimationId,\r\n        start: clip.start,\r\n        duration: clip.duration,\r\n        timelineChildren: clip.timelineChildren,\r\n        timelineSpan: clip.timelineSpan,\r\n      })),\r\n  })\r\n}\r\n"],
+  "mappings": "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",
+  "names": ["import_gsapAnimationRegistry", "registerSharedAnimationInRegistry", "getSharedAnimationEntry", "listSharedAnimationEntries", "getSharedAnimationEntryForSheetObject", "import_privateAPIs", "import_gsapAnimationRegistry"]
+}

package/dist/index.mjs

@@ -0,0 +1,144 @@
+// src/registerGsapAnimation.ts
+import { privateAPI } from "@unseenco/theatre-core/privateAPIs";
+import { buildGsapSheetObjectKey } from "@unseenco/theatre-shared/gsap/buildGsapSheetObjectKey";
+import { getAnimationEntry as getAnimationEntry2 } from "@unseenco/theatre-shared/gsap/gsapAnimationRegistry";
+
+// src/config.ts
+import { setConfiguredGsapSheetObjectNamespace } from "@unseenco/theatre-shared/gsap/gsapSheetObjectKey";
+var activeConfig = {
+  namespace: "GSAP",
+  outlineNamespace: { defaultCollapsed: false }
+};
+setConfiguredGsapSheetObjectNamespace(activeConfig.namespace);
+function configureTheatreGsap(config) {
+  const prev = activeConfig;
+  activeConfig = {
+    namespace: config.namespace ?? prev.namespace ?? "GSAP",
+    outlineNamespace: config.outlineNamespace ?? prev.outlineNamespace
+  };
+  setConfiguredGsapSheetObjectNamespace(activeConfig.namespace ?? "GSAP");
+  return {
+    reset() {
+      activeConfig = prev;
+    }
+  };
+}
+function getTheatreGsapConfig() {
+  return activeConfig;
+}
+
+// src/animationRegistry.ts
+import {
+  clearAnimationRegistryForTests as clearSharedAnimationRegistryForTests,
+  getAnimationEntry as getSharedAnimationEntry,
+  getAnimationEntryForSheetObject as getSharedAnimationEntryForSheetObject,
+  listAnimationEntries as listSharedAnimationEntries,
+  registerAnimationInRegistry as registerSharedAnimationInRegistry
+} from "@unseenco/theatre-shared/gsap/gsapAnimationRegistry";
+import { readGsapTweenTimelineDuration } from "@unseenco/theatre-shared/gsap/syncGsapClipProgress";
+function registerAnimationInRegistry(entry) {
+  registerSharedAnimationInRegistry({
+    ...entry,
+    animation: entry.animation,
+    defaultDuration: entry.defaultDuration ?? defaultClipDuration(entry.animation),
+    onRebuildTimeline: entry.onRebuildTimeline
+  });
+}
+function defaultClipDuration(animation) {
+  return readGsapTweenTimelineDuration(animation);
+}
+function toPackageEntry(entry) {
+  if (!entry || !entry.animation)
+    return void 0;
+  return {
+    id: entry.id,
+    label: entry.label,
+    animation: entry.animation,
+    sheetObject: entry.sheetObject,
+    defaultDuration: entry.defaultDuration,
+    onRebuildTimeline: entry.onRebuildTimeline
+  };
+}
+function getAnimationEntry(sheetObject, animationId) {
+  return toPackageEntry(getSharedAnimationEntry(sheetObject, animationId));
+}
+function getAnimationEntryById(id) {
+  return toPackageEntry(
+    listSharedAnimationEntries().find((entry) => entry.id === id)
+  );
+}
+function getAnimationEntryForSheetObject(sheetObject) {
+  return toPackageEntry(getSharedAnimationEntryForSheetObject(sheetObject));
+}
+function listAnimationEntries() {
+  return listSharedAnimationEntries().filter((e) => !!e.animation).map((entry) => ({
+    id: entry.id,
+    label: entry.label,
+    animation: entry.animation,
+    sheetObject: entry.sheetObject
+  }));
+}
+
+// src/registerGsapAnimation.ts
+import { formatOutlineNamespacePathKey } from "@unseenco/theatre-shared/utils/outlineNamespaces";
+function registerGsapAnimation(animation, sheet, options) {
+  const config = getTheatreGsapConfig();
+  const namespace = options.namespace ?? config.namespace ?? "GSAP";
+  const objectKey = buildGsapSheetObjectKey(namespace, options.label);
+  const id = options.id ?? objectKey;
+  animation.pause();
+  const sheetObjectPublic = sheet.object(objectKey, {}, { reconfigure: false });
+  const sheetObjectInternal = privateAPI(sheetObjectPublic);
+  const existing = getAnimationEntry2(sheetObjectInternal, id);
+  if (config.outlineNamespace && !existing) {
+    privateAPI(sheet).template.setOutlineNamespaceConfig(
+      formatOutlineNamespacePathKey([namespace]),
+      config.outlineNamespace
+    );
+  }
+  registerAnimationInRegistry({
+    id,
+    label: options.label,
+    animation,
+    sheetObject: sheetObjectInternal,
+    defaultDuration: options.defaultDuration,
+    onRebuildTimeline: options.onRebuildTimeline
+  });
+  return { id, sheetObject: sheetObjectPublic };
+}
+
+// src/attachGsapSequenceBridge.ts
+import { privateAPI as privateAPI2 } from "@unseenco/theatre-core/privateAPIs";
+import { sheetObjectAddressKeyFromParts } from "@unseenco/theatre-shared/gsap/gsapAnimationRegistry";
+import { subscribeGsapClipSyncAtPlayhead } from "@unseenco/theatre-shared/gsap/subscribeGsapClipSyncAtPlayhead";
+function attachGsapSequenceBridge(sheet) {
+  const sequence = sheet.sequence;
+  const sheetAddress = privateAPI2(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
+    }))
+  });
+}
+export {
+  attachGsapSequenceBridge,
+  configureTheatreGsap,
+  getAnimationEntry,
+  getAnimationEntryById,
+  getAnimationEntryForSheetObject,
+  getTheatreGsapConfig,
+  listAnimationEntries,
+  registerGsapAnimation
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/registerGsapAnimation.ts", "../src/config.ts", "../src/animationRegistry.ts", "../src/attachGsapSequenceBridge.ts"],
+  "sourcesContent": ["import type {ISheet, ISheetObject} from '@unseenco/theatre-core'\r\nimport type {GsapTweenLike} from './gsapTypes'\r\nimport {privateAPI} from '@unseenco/theatre-core/privateAPIs'\r\nimport {buildGsapSheetObjectKey} from '@unseenco/theatre-shared/gsap/buildGsapSheetObjectKey'\r\nimport {getAnimationEntry} from '@unseenco/theatre-shared/gsap/gsapAnimationRegistry'\r\nimport {getTheatreGsapConfig} from './config'\r\nimport {registerAnimationInRegistry} from './animationRegistry'\r\nimport {formatOutlineNamespacePathKey} from '@unseenco/theatre-shared/utils/outlineNamespaces'\r\n\r\nexport type RegisterGsapAnimationOptions = {\r\n  /** Theatre object label (shown after the `GSAP/` namespace). */\r\n  label: string\r\n  /** Override namespace from {@link configureTheatreGsap}. */\r\n  namespace?: string\r\n  /**\r\n   * Stable id for this animation on the sheet object. When omitted, defaults to\r\n   * the sanitised sheet object key (e.g. `GSAP / Panel show`).\r\n   * Re-registering with the same id updates the registry entry in place.\r\n   */\r\n  id?: string\r\n  /** Clip length when adding to the sequence (defaults to tween duration). */\r\n  defaultDuration?: number\r\n  /** Rebuild the timeline when native child timing edits fail. */\r\n  onRebuildTimeline?: () => GsapTweenLike\r\n}\r\n\r\nexport type RegisterGsapAnimationResult = {\r\n  id: string\r\n  sheetObject: ISheetObject<{}>\r\n}\r\n\r\n/**\r\n * Registers a GSAP tween for Theatre sequence bridging and creates an outline\r\n * proxy object under `GSAP/<label>` (namespace configurable).\r\n *\r\n * The animation is paused immediately so Theatre can drive progress.\r\n */\r\nexport function registerGsapAnimation(\r\n  animation: GsapTweenLike,\r\n  sheet: ISheet,\r\n  options: RegisterGsapAnimationOptions,\r\n): RegisterGsapAnimationResult {\r\n  const config = getTheatreGsapConfig()\r\n  const namespace = options.namespace ?? config.namespace ?? 'GSAP'\r\n  const objectKey = buildGsapSheetObjectKey(namespace, options.label)\r\n  const id = options.id ?? objectKey\r\n\r\n  animation.pause()\r\n\r\n  const sheetObjectPublic = sheet.object(objectKey, {}, {reconfigure: false})\r\n  const sheetObjectInternal = privateAPI(sheetObjectPublic)\r\n\r\n  const existing = getAnimationEntry(sheetObjectInternal, id)\r\n\r\n  if (config.outlineNamespace && !existing) {\r\n    privateAPI(sheet).template.setOutlineNamespaceConfig(\r\n      formatOutlineNamespacePathKey([namespace]),\r\n      config.outlineNamespace,\r\n    )\r\n  }\r\n\r\n  registerAnimationInRegistry({\r\n    id,\r\n    label: options.label,\r\n    animation,\r\n    sheetObject: sheetObjectInternal,\r\n    defaultDuration: options.defaultDuration,\r\n    onRebuildTimeline: options.onRebuildTimeline,\r\n  })\r\n\r\n  return {id, sheetObject: sheetObjectPublic}\r\n}\r\n", "import type {OutlineNamespaceConfig} from '@unseenco/theatre-shared/utils/outlineNamespaces'\r\nimport {setConfiguredGsapSheetObjectNamespace} from '@unseenco/theatre-shared/gsap/gsapSheetObjectKey'\r\n\r\nexport type TheatreGsapConfig = {\r\n  /** Outline namespace segment for GSAP proxy objects (default `GSAP`). */\r\n  namespace?: string\r\n  /** Applied to each sheet when the first GSAP object is registered on it. */\r\n  outlineNamespace?: OutlineNamespaceConfig\r\n}\r\n\r\nlet activeConfig: TheatreGsapConfig = {\r\n  namespace: 'GSAP',\r\n  outlineNamespace: {defaultCollapsed: false},\r\n}\r\n\r\nsetConfiguredGsapSheetObjectNamespace(activeConfig.namespace!)\r\n\r\nexport function configureTheatreGsap(config: TheatreGsapConfig): {\r\n  reset: () => void\r\n} {\r\n  const prev = activeConfig\r\n  activeConfig = {\r\n    namespace: config.namespace ?? prev.namespace ?? 'GSAP',\r\n    outlineNamespace: config.outlineNamespace ?? prev.outlineNamespace,\r\n  }\r\n  setConfiguredGsapSheetObjectNamespace(activeConfig.namespace ?? 'GSAP')\r\n  return {\r\n    reset() {\r\n      activeConfig = prev\r\n    },\r\n  }\r\n}\r\n\r\nexport function getTheatreGsapConfig(): TheatreGsapConfig {\r\n  return activeConfig\r\n}\r\n", "import type SheetObject from '@unseenco/theatre-core/sheetObjects/SheetObject'\r\nimport type {GsapTweenLike} from './gsapTypes'\r\nimport {\r\n  clearAnimationRegistryForTests as clearSharedAnimationRegistryForTests,\r\n  getAnimationEntry as getSharedAnimationEntry,\r\n  getAnimationEntryForSheetObject as getSharedAnimationEntryForSheetObject,\r\n  listAnimationEntries as listSharedAnimationEntries,\r\n  registerAnimationInRegistry as registerSharedAnimationInRegistry,\r\n} from '@unseenco/theatre-shared/gsap/gsapAnimationRegistry'\r\nimport {readGsapTweenTimelineDuration} from '@unseenco/theatre-shared/gsap/syncGsapClipProgress'\r\n\r\nexport type GsapAnimationRegistryEntry = {\r\n  id: string\r\n  label: string\r\n  animation: GsapTweenLike\r\n  sheetObject?: SheetObject\r\n  defaultDuration?: number\r\n  onRebuildTimeline?: () => GsapTweenLike\r\n}\r\n\r\nexport function registerAnimationInRegistry(\r\n  entry: GsapAnimationRegistryEntry,\r\n): void {\r\n  registerSharedAnimationInRegistry({\r\n    ...entry,\r\n    animation: entry.animation,\r\n    defaultDuration:\r\n      entry.defaultDuration ??\r\n      defaultClipDuration(entry.animation as GsapTweenLike),\r\n    onRebuildTimeline: entry.onRebuildTimeline,\r\n  })\r\n}\r\n\r\nfunction defaultClipDuration(animation: GsapTweenLike): number {\r\n  return readGsapTweenTimelineDuration(animation)\r\n}\r\n\r\nfunction toPackageEntry(\r\n  entry: ReturnType<typeof getSharedAnimationEntryForSheetObject>,\r\n): GsapAnimationRegistryEntry | undefined {\r\n  if (!entry || !entry.animation) return undefined\r\n  return {\r\n    id: entry.id,\r\n    label: entry.label,\r\n    animation: entry.animation as GsapTweenLike,\r\n    sheetObject: entry.sheetObject,\r\n    defaultDuration: entry.defaultDuration,\r\n    onRebuildTimeline: entry.onRebuildTimeline as\r\n      | (() => GsapTweenLike)\r\n      | undefined,\r\n  }\r\n}\r\n\r\nexport function getAnimationEntry(\r\n  sheetObject: SheetObject,\r\n  animationId?: string,\r\n): GsapAnimationRegistryEntry | undefined {\r\n  return toPackageEntry(getSharedAnimationEntry(sheetObject, animationId))\r\n}\r\n\r\nexport function getAnimationEntryById(\r\n  id: string,\r\n): GsapAnimationRegistryEntry | undefined {\r\n  return toPackageEntry(\r\n    listSharedAnimationEntries().find((entry) => entry.id === id),\r\n  )\r\n}\r\n\r\nexport function getAnimationEntryForSheetObject(\r\n  sheetObject: SheetObject,\r\n): GsapAnimationRegistryEntry | undefined {\r\n  return toPackageEntry(getSharedAnimationEntryForSheetObject(sheetObject))\r\n}\r\n\r\nexport function listAnimationEntries(): GsapAnimationRegistryEntry[] {\r\n  return listSharedAnimationEntries()\r\n    .filter((e): e is typeof e & {animation: GsapTweenLike} => !!e.animation)\r\n    .map((entry) => ({\r\n      id: entry.id,\r\n      label: entry.label,\r\n      animation: entry.animation as GsapTweenLike,\r\n      sheetObject: entry.sheetObject,\r\n    }))\r\n}\r\n\r\nexport function clearAnimationRegistryForTests(): void {\r\n  clearSharedAnimationRegistryForTests()\r\n}\r\n", "import type {ISheet} from '@unseenco/theatre-core'\r\nimport {privateAPI} from '@unseenco/theatre-core/privateAPIs'\r\nimport {sheetObjectAddressKeyFromParts} from '@unseenco/theatre-shared/gsap/gsapAnimationRegistry'\r\nimport type {ObjectAddressKey} from '@unseenco/theatre-shared/utils/ids'\r\nimport {subscribeGsapClipSyncAtPlayhead} from '@unseenco/theatre-shared/gsap/subscribeGsapClipSyncAtPlayhead'\r\n\r\n/**\r\n * Drives registered GSAP animations from the sheet sequence playhead.\r\n *\r\n * @returns Disposer \u2014 call to detach the bridge.\r\n */\r\nexport function attachGsapSequenceBridge(sheet: ISheet): () => void {\r\n  const sequence = sheet.sequence\r\n  const sheetAddress = privateAPI(sheet).address\r\n\r\n  return subscribeGsapClipSyncAtPlayhead({\r\n    pointer: sequence.pointer,\r\n    getGsapClipTimings: () =>\r\n      sequence.__experimental_getGsapClips().map(({objectKey, clip}) => ({\r\n        sheetObjectAddressKey: sheetObjectAddressKeyFromParts({\r\n          projectId: sheetAddress.projectId,\r\n          sheetId: sheetAddress.sheetId,\r\n          sheetInstanceId: sheetAddress.sheetInstanceId,\r\n          objectKey: objectKey as ObjectAddressKey,\r\n        }),\r\n        gsapAnimationId: clip.gsapAnimationId,\r\n        start: clip.start,\r\n        duration: clip.duration,\r\n        timelineChildren: clip.timelineChildren,\r\n        timelineSpan: clip.timelineSpan,\r\n      })),\r\n  })\r\n}\r\n"],
+  "mappings": "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",
+  "names": ["getAnimationEntry", "getAnimationEntry", "privateAPI"]
+}

package/dist/registerGsapAnimation.d.ts

@@ -0,0 +1,30 @@
+import type { ISheet, ISheetObject } from '@unseenco/theatre-core';
+import type { GsapTweenLike } from './gsapTypes';
+export type RegisterGsapAnimationOptions = {
+    /** Theatre object label (shown after the `GSAP/` namespace). */
+    label: string;
+    /** Override namespace from {@link configureTheatreGsap}. */
+    namespace?: string;
+    /**
+     * Stable id for this animation on the sheet object. When omitted, defaults to
+     * the sanitised sheet object key (e.g. `GSAP / Panel show`).
+     * Re-registering with the same id updates the registry entry in place.
+     */
+    id?: string;
+    /** Clip length when adding to the sequence (defaults to tween duration). */
+    defaultDuration?: number;
+    /** Rebuild the timeline when native child timing edits fail. */
+    onRebuildTimeline?: () => GsapTweenLike;
+};
+export type RegisterGsapAnimationResult = {
+    id: string;
+    sheetObject: ISheetObject<{}>;
+};
+/**
+ * Registers a GSAP tween for Theatre sequence bridging and creates an outline
+ * proxy object under `GSAP/<label>` (namespace configurable).
+ *
+ * The animation is paused immediately so Theatre can drive progress.
+ */
+export declare function registerGsapAnimation(animation: GsapTweenLike, sheet: ISheet, options: RegisterGsapAnimationOptions): RegisterGsapAnimationResult;
+//# sourceMappingURL=registerGsapAnimation.d.ts.map

package/dist/registerGsapAnimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerGsapAnimation.d.ts","sourceRoot":"","sources":["../src/registerGsapAnimation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAE,YAAY,EAAC,MAAM,wBAAwB,CAAA;AAChE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,aAAa,CAAA;AAQ9C,MAAM,MAAM,4BAA4B,GAAG;IACzC,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,aAAa,CAAA;CACxC,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG;IACxC,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,YAAY,CAAC,EAAE,CAAC,CAAA;CAC9B,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,4BAA4B,GACpC,2BAA2B,CA8B7B"}

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.18.11"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@unseenco/theatre-gsap",
+  "version": "0.4.0",
+  "license": "AGPL-3.0-only",
+  "description": "GSAP time-mode bridge for Theatre.js",
+  "author": {
+    "name": "Aria Minaei",
+    "email": "aria@theatrejs.com",
+    "url": "https://github.com/AriaMinaei"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/craftedbygc/theatre",
+    "directory": "packages/gsap"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "prepack": "node ../../devEnv/ensurePublishing.js",
+    "typecheck": "yarn run build:ts",
+    "build": "run-s build:ts build:js build:api-json",
+    "build:ts": "tsc --build ./tsconfig.json",
+    "build:js": "node -r esbuild-register ./devEnv/build.ts",
+    "build:api-json": "api-extractor run --local --config devEnv/api-extractor.json",
+    "prepublish": "node ../../devEnv/ensurePublishing.js",
+    "clean": "rm -rf ./dist && rm -f tsconfig.tsbuildinfo"
+  },
+  "devDependencies": {
+    "@microsoft/api-extractor": "^7.18.11",
+    "@types/node": "^15.6.2",
+    "@unseenco/theatre-core": "0.4.0",
+    "esbuild": "^0.18.18",
+    "esbuild-register": "^2.5.0",
+    "gsap": "^3.12.5",
+    "npm-run-all": "^4.1.5",
+    "typescript": "5.1.6"
+  },
+  "peerDependencies": {
+    "@unseenco/theatre-core": "*",
+    "gsap": ">=3.0.0"
+  }
+}