@unseenco/theatre-gsap 0.4.2 → 0.5.0

package/dist/attachGsapSequenceBridge.d.ts

@@ -1,8 +1,2 @@
-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;
+export { attachGsapSequenceBridge } from '@unseenco/theatre-core';
 //# sourceMappingURL=attachGsapSequenceBridge.d.ts.map

package/dist/attachGsapSequenceBridge.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"attachGsapSequenceBridge.d.ts","sourceRoot":"","sources":["../src/attachGsapSequenceBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,wBAAwB,EAAC,MAAM,wBAAwB,CAAA"}

package/dist/attachTheatrePageScroll.d.ts

@@ -0,0 +1,10 @@
+import type { AttachTheatrePageScrollOptions, ISheet, PageScrollContext, PageScrollScroller, ScrollDriver } from '@unseenco/theatre-core';
+export declare function getTheatrePageScrollContext(): PageScrollContext;
+export declare function createDefaultPageScrollDriver(scroller?: PageScrollScroller): ScrollDriver;
+export type { AttachTheatrePageScrollOptions };
+/**
+ * @deprecated Import from `@unseenco/theatre-core` for page scroll without GSAP.
+ * This wrapper applies ScrollTrigger defaults when `configureTheatreGsap({ pageScroll })` is used.
+ */
+export declare function attachTheatrePageScroll(sheet: ISheet, options?: AttachTheatrePageScrollOptions): () => void;
+//# sourceMappingURL=attachTheatrePageScroll.d.ts.map

package/dist/attachTheatrePageScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachTheatrePageScroll.d.ts","sourceRoot":"","sources":["../src/attachTheatrePageScroll.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,MAAM,EACN,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACb,MAAM,wBAAwB,CAAA;AA0B/B,wBAAgB,2BAA2B,IAAI,iBAAiB,CAY/D;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,GAAE,kBAA2D,GACpE,YAAY,CAGd;AAED,YAAY,EAAC,8BAA8B,EAAC,CAAA;AAE5C;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,8BAAmC,GAC3C,MAAM,IAAI,CAGZ"}

package/dist/config.d.ts

@@ -1,9 +1,23 @@
 import type { OutlineNamespaceConfig } from '@unseenco/theatre-shared/utils/outlineNamespaces';
+import type { PageScrollAxis, PageScrollScroller } from '@unseenco/theatre-shared/sheets/pageScrollContext';
+export type TheatreGsapPageScrollConfig = {
+    /** Default scroller for ScrollTrigger layout and guards; `null` = native document. */
+    scroller?: PageScrollScroller;
+    /** Page scroll axis (default vertical). */
+    axis?: PageScrollAxis;
+    /**
+     * @deprecated ScrollTrigger.defaults is applied automatically when `pageScroll` is configured.
+     */
+    applyScrollTriggerDefaults?: boolean;
+};
 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;
+    /** When true, skips the one-time gsap.ticker / core rAF integration warning. */
+    suppressGsapTickerRafWarning?: boolean;
+    pageScroll?: TheatreGsapPageScrollConfig;
 };
 export declare function configureTheatreGsap(config: TheatreGsapConfig): {
     reset: () => void;

package/dist/config.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,kDAAkD,CAAA;AAC5F,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EACnB,MAAM,mDAAmD,CAAA;AAQ1D,MAAM,MAAM,2BAA2B,GAAG;IACxC,sFAAsF;IACtF,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB;;OAEG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,sBAAsB,CAAA;IACzC,gFAAgF;IAChF,4BAA4B,CAAC,EAAE,OAAO,CAAA;IACtC,UAAU,CAAC,EAAE,2BAA2B,CAAA;CACzC,CAAA;AA8BD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG;IAC/D,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB,CA8BA;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD"}

package/dist/gsapScrollTriggerPlugin.d.ts

@@ -0,0 +1,10 @@
+import type { GsapScrollTriggerStaticLike } from './gsapScrollTriggerTypes';
+/**
+ * Optional: bind the ScrollTrigger plugin instance your app registered with GSAP.
+ * When omitted, Theatre resolves ScrollTrigger from `gsap/ScrollTrigger` (ESM) or `globalThis.ScrollTrigger`.
+ */
+export declare function bindGsapScrollTriggerPlugin(scrollTrigger: GsapScrollTriggerStaticLike): void;
+export declare function getGsapScrollTriggerPlugin(): GsapScrollTriggerStaticLike | undefined;
+export declare function requireGsapScrollTriggerPlugin(): GsapScrollTriggerStaticLike;
+export declare function refreshGsapScrollTriggers(): void;
+//# sourceMappingURL=gsapScrollTriggerPlugin.d.ts.map

package/dist/gsapScrollTriggerPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsapScrollTriggerPlugin.d.ts","sourceRoot":"","sources":["../src/gsapScrollTriggerPlugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,0BAA0B,CAAA;AAIzE;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,2BAA2B,GACzC,IAAI,CAEN;AAED,wBAAgB,0BAA0B,IACtC,2BAA2B,GAC3B,SAAS,CAWZ;AAED,wBAAgB,8BAA8B,IAAI,2BAA2B,CAQ5E;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/gsapScrollTriggerTypes.d.ts

@@ -0,0 +1,23 @@
+/** Minimal GSAP ScrollTrigger surface for Theatre (avoids tight GSAP coupling). */
+export type GsapScrollTriggerLike = {
+    start: number;
+    end: number;
+    horizontal?: boolean;
+    scroller?: unknown;
+    trigger?: unknown;
+    animation?: unknown;
+    vars?: {
+        id?: string;
+        animation?: unknown;
+        horizontal?: boolean;
+        scroller?: unknown;
+    };
+};
+export type GsapScrollTriggerStaticLike = {
+    refresh(): void;
+    getAll(): GsapScrollTriggerLike[];
+    defaults?(vars: {
+        scroller?: unknown;
+    }): void;
+};
+//# sourceMappingURL=gsapScrollTriggerTypes.d.ts.map

package/dist/gsapScrollTriggerTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsapScrollTriggerTypes.d.ts","sourceRoot":"","sources":["../src/gsapScrollTriggerTypes.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,IAAI,CAAC,EAAE;QACL,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,UAAU,CAAC,EAAE,OAAO,CAAA;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;KACnB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,IAAI,IAAI,CAAA;IACf,MAAM,IAAI,qBAAqB,EAAE,CAAA;IACjC,QAAQ,CAAC,CAAC,IAAI,EAAE;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAC,GAAG,IAAI,CAAA;CAC5C,CAAA"}

package/dist/gsapTickerRafBridge.d.ts

@@ -0,0 +1,23 @@
+import type { IRafDriver } from '@unseenco/theatre-core';
+export type GsapTickerLike = {
+    ticker: {
+        add(fn: (time: number) => void): unknown;
+        remove(fn: (time: number) => void): unknown;
+    };
+};
+/**
+ * Drives a Theatre `rafDriver` from `gsap.ticker` (GSAP time in seconds → Theatre ms).
+ * Returns a cleanup that removes the ticker listener and unmarks the driver.
+ */
+export declare function bindGsapTickerToRafDriver(rafDriver: IRafDriver, gsap: GsapTickerLike): () => void;
+export declare function isRafDriverDrivenByGsapTicker(rafDriver: IRafDriver): boolean;
+/**
+ * Schedules a deferred check so same-turn `setCoreRafDriver` → `bindGsapTickerToRafDriver`
+ * → `registerGsapAnimation` does not warn before the bind runs.
+ */
+export declare function scheduleGsapTickerRafWarningCheck(): void;
+/**
+ * Warns once per page load when Theatre's core rAF is not driven by `gsap.ticker`.
+ */
+export declare function warnIfGsapTickerNotDrivingTheatreRaf(): void;
+//# sourceMappingURL=gsapTickerRafBridge.d.ts.map

package/dist/gsapTickerRafBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsapTickerRafBridge.d.ts","sourceRoot":"","sources":["../src/gsapTickerRafBridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,wBAAwB,CAAA;AAMtD,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE;QACN,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAA;QACxC,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAA;KAC5C,CAAA;CACF,CAAA;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,UAAU,EACrB,IAAI,EAAE,cAAc,GACnB,MAAM,IAAI,CAUZ;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAE5E;AAKD;;;GAGG;AACH,wBAAgB,iCAAiC,IAAI,IAAI,CAOxD;AAED;;GAEG;AACH,wBAAgB,oCAAoC,IAAI,IAAI,CAY3D"}

package/dist/gsapTickerRafBridge.test.d.ts

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

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

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

package/dist/index.d.ts

@@ -1,8 +1,18 @@
 export { registerGsapAnimation } from './registerGsapAnimation';
 export type { RegisterGsapAnimationOptions, RegisterGsapAnimationResult, } from './registerGsapAnimation';
+export { registerGsapScrollTrigger } from './registerGsapScrollTrigger';
+export type { RegisterGsapScrollTriggerOptions, RegisterGsapScrollTriggerResult, } from './registerGsapScrollTrigger';
+export { registerAllGsapScrollTriggers } from './registerAllGsapScrollTriggers';
+export type { RegisterAllGsapScrollTriggersResult } from './registerAllGsapScrollTriggers';
+export { refreshRegisteredGsapScrollTriggerLayouts } from './registerGsapScrollTrigger';
+export type { GsapScrollTriggerLike } from './gsapScrollTriggerTypes';
 export { attachGsapSequenceBridge } from './attachGsapSequenceBridge';
 export { configureTheatreGsap, getTheatreGsapConfig } from './config';
-export type { TheatreGsapConfig } from './config';
+export type { TheatreGsapConfig, TheatreGsapPageScrollConfig } from './config';
+export { attachTheatrePageScroll, createDefaultPageScrollDriver, getTheatrePageScrollContext, } from './attachTheatrePageScroll';
+export { bindGsapScrollTriggerPlugin } from './gsapScrollTriggerPlugin';
+export { bindGsapTickerToRafDriver, isRafDriverDrivenByGsapTicker, scheduleGsapTickerRafWarningCheck, warnIfGsapTickerNotDrivingTheatreRaf, } from './gsapTickerRafBridge';
+export type { GsapTickerLike } from './gsapTickerRafBridge';
 export { getAnimationEntry, getAnimationEntryById, getAnimationEntryForSheetObject, listAnimationEntries, } from './animationRegistry';
 export type { GsapAnimationRegistryEntry } from './animationRegistry';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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,yBAAyB,EAAC,MAAM,6BAA6B,CAAA;AACrE,YAAY,EACV,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAC,6BAA6B,EAAC,MAAM,iCAAiC,CAAA;AAC7E,YAAY,EAAC,mCAAmC,EAAC,MAAM,iCAAiC,CAAA;AACxF,OAAO,EAAC,yCAAyC,EAAC,MAAM,6BAA6B,CAAA;AACrF,YAAY,EAAC,qBAAqB,EAAC,MAAM,0BAA0B,CAAA;AACnE,OAAO,EAAC,wBAAwB,EAAC,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAC,oBAAoB,EAAE,oBAAoB,EAAC,MAAM,UAAU,CAAA;AACnE,YAAY,EAAC,iBAAiB,EAAE,2BAA2B,EAAC,MAAM,UAAU,CAAA;AAC5E,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAC,2BAA2B,EAAC,MAAM,2BAA2B,CAAA;AACrE,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,iCAAiC,EACjC,oCAAoC,GACrC,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAA;AACzD,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAC,0BAA0B,EAAC,MAAM,qBAAqB,CAAA"}