@cosmictraveler002/anim-kit 1.0.0

package/dist/effects/counter.d.ts

@@ -0,0 +1,52 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface CounterOptions extends CommonOptions {
+    /** Start value. @default 0 */
+    from?: number;
+    /** End value. @default 100 */
+    to?: number;
+    /** Duration in seconds. @default 4 */
+    duration?: number;
+    /** GSAP ease. @default "power1.inOut" */
+    ease?: string;
+    /** Pad with leading zeros to this width. @default 0 (no padding) */
+    pad?: number;
+    /** Suffix appended to the number, e.g. "+". @default "" */
+    suffix?: string;
+    /** Animate when scrolled into view instead of immediately. @default false */
+    onScroll?: boolean;
+    start?: string;
+    onComplete?: (value: number) => void;
+}
+export declare function counter(target: TargetLike, options?: CounterOptions): Destroy;
+/**
+ * Audio bars — the 5-bar equaliser inside the background-music button.
+ *
+ * Heights re-randomise on an interval and each bar springs to its new height,
+ * giving that loose, twitchy look. `stop()` collapses the bars back down.
+ *
+ *   const eq = audioBars(".ak-eq");
+ *   eq.start();          // on play
+ *   eq.stop();           // on pause
+ */
+export interface AudioBarsOptions extends CommonOptions {
+    /** Bars inside the container. @default ":scope > *" */
+    bar?: string;
+    /** Re-randomise interval in ms. @default 100 */
+    interval?: number;
+    /** Min bar height px. @default 4 */
+    minHeight?: number;
+    /** Max bar height px. @default 14 */
+    maxHeight?: number;
+    /**
+     * Spring feel, 0..1. Higher = bouncier. Used to pick the overshoot ease.
+     * @default 0.75
+     */
+    bounce?: number;
+}
+export interface AudioBarsHandle {
+    start: () => void;
+    stop: () => void;
+    destroy: Destroy;
+}
+export declare function audioBars(target: TargetLike, options?: AudioBarsOptions): AudioBarsHandle;
+//# sourceMappingURL=counter.d.ts.map

package/dist/effects/counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter.d.ts","sourceRoot":"","sources":["../../src/effects/counter.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CA0DjF;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CA+DjB"}

package/dist/effects/counter.js

@@ -0,0 +1,106 @@
+/**
+ * Counter — the big tabular-nums number that ticks up.
+ *
+ * Drives an element's `textContent` from `from` to `to` with an easing curve,
+ * optionally triggered by ScrollTrigger. Uses integer stepping so there is no
+ * fractional flicker, and pairs with `tabular-nums` for stable layout.
+ *
+ *   counter("[data-count]", { to: 100, duration: 4, ease: "power1.inOut" })
+ */
+import { gsap, ScrollTrigger, initGSAP, killTweens } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { toArray } from "../core/util.js";
+export function counter(target, options = {}) {
+    initGSAP();
+    const els = toArray(target);
+    if (!els.length)
+        return () => { };
+    const { from = 0, to = 100, duration = 4, ease = "power1.inOut", pad = 0, suffix = "", onScroll = false, start = "top 90%", onComplete, } = options;
+    return guard(options, run);
+    function run() {
+        const tweens = [];
+        els.forEach((el) => {
+            const state = { v: from };
+            const render = () => {
+                const n = Math.round(state.v);
+                el.textContent = (pad ? String(n).padStart(pad, "0") : String(n)) + suffix;
+            };
+            render();
+            const vars = {
+                v: to,
+                duration,
+                ease,
+                onUpdate: render,
+                onComplete: () => {
+                    render();
+                    onComplete?.(Math.round(state.v));
+                },
+            };
+            if (onScroll) {
+                vars.scrollTrigger = { trigger: el, start, once: true };
+            }
+            tweens.push(gsap.to(state, vars));
+        });
+        if (onScroll)
+            ScrollTrigger.refresh();
+        return () => {
+            tweens.forEach((t) => {
+                t.scrollTrigger?.kill();
+                t.kill();
+            });
+        };
+    }
+}
+export function audioBars(target, options = {}) {
+    initGSAP();
+    const inert = { start: () => { }, stop: () => { }, destroy: () => { } };
+    const root = toArray(target)[0];
+    if (!root)
+        return inert;
+    const { bar = ":scope > *", interval = 100, minHeight = 4, maxHeight = 14, bounce = 0.75, } = options;
+    const bars = toArray(bar, root);
+    if (!bars.length)
+        return inert;
+    let timer = 0;
+    const start = () => {
+        if (timer)
+            return;
+        randomise();
+        timer = window.setInterval(randomise, interval);
+    };
+    const stop = () => {
+        if (timer)
+            window.clearInterval(timer);
+        timer = 0;
+        bars.forEach((b) => gsap.to(b, { height: minHeight, duration: 0.4, ease: "power2.out", overwrite: "auto" }));
+    };
+    const destroy = guard(options, () => {
+        gsap.set(bars, { height: minHeight, force3D: true });
+        start();
+        return () => {
+            if (timer)
+                window.clearInterval(timer); // match window.setInterval in start()
+            timer = 0;
+            // Kill in-flight bar tweens first — otherwise their next frame would
+            // rewrite `height` *after* clearProps, mutating the DOM post-destroy.
+            // killTweens() (not killTweensOf) also catches batches created since
+            // the last ticker frame — those are still lazy and survive killTweensOf.
+            killTweens(bars);
+            gsap.set(bars, { clearProps: "height" });
+        };
+    });
+    return { start, stop, destroy };
+    function randomise() {
+        bars.forEach((b) => {
+            const v = Math.random() * 0.8 + 0.2;
+            gsap.to(b, {
+                height: Math.max(minHeight, maxHeight * v),
+                duration: 0.45,
+                // Underdamped springs overshoot; map the bounce option onto back.out.
+                ease: `back.out(${(bounce * 1.8).toFixed(2)})`,
+                overwrite: "auto",
+            });
+        });
+    }
+}
+//# sourceMappingURL=counter.js.map

package/dist/effects/counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter.js","sourceRoot":"","sources":["../../src/effects/counter.ts"],"names":[],"mappings":"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"}

package/dist/effects/cursor-follower.d.ts

@@ -0,0 +1,19 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface CursorFollowerOptions extends CommonOptions {
+    /** The floating element. Defaults to the first `[data-cursor]` in the document. */
+    follower?: TargetLike;
+    /** Offset added to the pointer position, px. @default 14 */
+    offset?: number;
+    /** Spring config for the follower. @default { mass: 0.1, stiffness: 120 } */
+    spring?: {
+        mass?: number;
+        stiffness?: number;
+        damping?: number;
+    };
+    /** Blend mode applied to the follower. @default "exclusion" */
+    blendMode?: string;
+    /** Fade the follower in/out with the pointer. @default true */
+    fade?: boolean;
+}
+export declare function cursorFollower(zone: TargetLike, options?: CursorFollowerOptions): Destroy;
+//# sourceMappingURL=cursor-follower.d.ts.map

package/dist/effects/cursor-follower.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-follower.d.ts","sourceRoot":"","sources":["../../src/effects/cursor-follower.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,mFAAmF;IACnF,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAyET"}

package/dist/effects/cursor-follower.js

@@ -0,0 +1,76 @@
+/**
+ * Cursor follower — the "Play Showreel" tag that trails the pointer.
+ *
+ * Two springs drive X and Y independently (mass 0.1, as on the site), and the
+ * whole thing fades/blurs in when the pointer enters the hot zone. The label
+ * uses `mix-blend-mode: exclusion` so it inverts over any background.
+ *
+ *   cursorFollower(zone, { follower: ".ak-cursor" })
+ */
+import { gsap, initGSAP, killTweens } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { one } from "../core/util.js";
+export function cursorFollower(zone, options = {}) {
+    initGSAP();
+    const el = (options.follower ? one(options.follower) : null) ??
+        document.querySelector("[data-cursor]");
+    const area = one(zone);
+    if (!el || !area)
+        return () => { };
+    const { offset = 14, spring = { mass: 0.1, stiffness: 120 }, blendMode = "exclusion", fade = true } = options;
+    return guard(options, () => {
+        const prevStyle = {
+            mixBlendMode: el.style.mixBlendMode,
+            position: el.style.position,
+            left: el.style.left,
+            top: el.style.top,
+            pointerEvents: el.style.pointerEvents,
+        };
+        el.style.mixBlendMode = blendMode;
+        el.style.position = "absolute";
+        el.style.left = "0";
+        el.style.top = "0";
+        el.style.pointerEvents = "none";
+        gsap.set(el, { opacity: fade ? 0 : 1, x: 0, y: 0 });
+        const xTo = gsap.quickTo(el, "x", { ...spring, duration: 0.4, ease: "power3" });
+        const yTo = gsap.quickTo(el, "y", { ...spring, duration: 0.4, ease: "power3" });
+        const onMove = (e) => {
+            const r = area.getBoundingClientRect();
+            xTo(e.clientX - r.left + offset);
+            yTo(e.clientY - r.top + offset);
+            if (fade)
+                gsap.to(el, { opacity: 1, duration: 0.25, overwrite: "auto" });
+        };
+        const onLeave = () => {
+            if (fade)
+                gsap.to(el, { opacity: 0, duration: 0.25, overwrite: "auto" });
+        };
+        const onKey = (e) => {
+            if (e.key === "Enter" || e.key === " ") {
+                /* host app handles activation; keep zone keyboard-reachable */
+            }
+        };
+        area.addEventListener("pointermove", onMove);
+        area.addEventListener("pointerleave", onLeave);
+        area.addEventListener("keydown", onKey);
+        return () => {
+            area.removeEventListener("pointermove", onMove);
+            area.removeEventListener("pointerleave", onLeave);
+            area.removeEventListener("keydown", onKey);
+            // quickTo tweens are paused at creation and would otherwise sit on the
+            // global timeline forever; fade tweens may still be in flight.
+            xTo.tween.kill();
+            yTo.tween.kill();
+            killTweens(el);
+            // Restore the inline styles we overwrote, clear only what gsap set
+            // (the old clearProps:"all" also wiped the consumer's own styles).
+            el.style.mixBlendMode = prevStyle.mixBlendMode;
+            el.style.position = prevStyle.position;
+            el.style.left = prevStyle.left;
+            el.style.top = prevStyle.top;
+            el.style.pointerEvents = prevStyle.pointerEvents;
+            gsap.set(el, { clearProps: "opacity,transform" });
+        };
+    });
+}
+//# sourceMappingURL=cursor-follower.js.map

package/dist/effects/cursor-follower.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-follower.js","sourceRoot":"","sources":["../../src/effects/cursor-follower.ts"],"names":[],"mappings":"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"}

package/dist/effects/drag-strip.d.ts

@@ -0,0 +1,17 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface DragStripOptions extends CommonOptions {
+    /** Max rotation at full drag speed, degrees. @default 100 */
+    maxRotation?: number;
+    /** Rotation response — divisor on the normalised drag speed. @default 100 */
+    rotationScale?: number;
+    /** Spring-back duration on release, seconds. @default 1 */
+    settleDuration?: number;
+    /** Enable inertia after release (requires GSAP InertiaPlugin). @default false */
+    inertia?: boolean;
+    /** Duplicate content so the loop is seamless; `false` clamps instead. @default true */
+    clone?: boolean;
+    /** Items inside the strip that rotate. @default ":scope > *" */
+    item?: string;
+}
+export declare function dragStrip(target: TargetLike, options?: DragStripOptions): Destroy;
+//# sourceMappingURL=drag-strip.d.ts.map

package/dist/effects/drag-strip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag-strip.d.ts","sourceRoot":"","sources":["../../src/effects/drag-strip.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uFAAuF;IACvF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAiLrF"}

package/dist/effects/drag-strip.js

@@ -0,0 +1,186 @@
+/**
+ * Drag strip — the grabbable, infinitely looping image carousel.
+ *
+ * Built on GSAP Draggable. Why it is shaped this way (audit notes):
+ *
+ * - **Single writer.** Draggable owns the track's X transform; the loop is a
+ *   `liveSnap` function Draggable itself calls on every move (and every frame
+ *   of an inertia throw). Nothing else writes X — the first version let a
+ *   0.5s `quickTo` fight Draggable's own transform, which stuttered between
+ *   wrapped and unwrapped positions. (Note: Draggable has no `modifiers`
+ *   option; `liveSnap` is the supported hook.)
+ * - **Seamless loop.** Folding positions is only invisible when the content
+ *   tiles: with `clone: true` (default) the strip duplicates itself until one
+ *   tile is at least as wide as the viewport, and the fold distance is always
+ *   a whole multiple of the tile width — the same trick `marquee()` uses.
+ *   Without cloning there is nothing to fold against, so the strip clamps at
+ *   the content edges instead (finite, but never a gap).
+ * - **Rotation on pull.** Children tilt against pointer *speed* (normalised to
+ *   a 60fps frame so mouse and touch event rates feel identical) and spring
+ *   back to 0 on release. Pointer movement is used rather than Draggable's
+ *   `deltaX`, because deltaX jumps by a full loop at the seam.
+ * - **Fidelity.** `destroy()` kills the Draggable and both rotation tweens,
+ *   removes cloned tiles (original markup back) and restores the inline
+ *   cursor/user-select/touch-action the effect had overwritten.
+ *
+ *   dragStrip(".ak-drag-track", { maxRotation: 60 })
+ *
+ * CSS: viewport `overflow: hidden`; track `display: flex; width: max-content;
+ * gap: 1rem; cursor: grab; user-select: none; touch-action: pan-y`.
+ */
+import { gsap, Draggable, initGSAP } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { one, toArray } from "../core/util.js";
+export function dragStrip(target, options = {}) {
+    initGSAP();
+    const track = one(target);
+    if (!track)
+        return () => { };
+    const { maxRotation = 100, rotationScale = 100, settleDuration = 1, inertia = false, clone = true, item = ":scope > *", } = options;
+    return guard(options, () => {
+        const viewport = track.parentElement;
+        const prevStyle = {
+            cursor: track.style.cursor,
+            userSelect: track.style.userSelect,
+            touchAction: track.style.touchAction,
+        };
+        /* ---------------- tiling (seamless infinite) ---------------- */
+        const originalCount = track.children.length;
+        const originalNodes = Array.from(track.children);
+        const trackWidth = () => Math.max(track.scrollWidth, track.clientWidth);
+        let tile = originalCount > 0 ? trackWidth() : 0; // width of one copy
+        let viewportW = 1; // width of the scroll viewport (the parent)
+        let loop = 0; // fold distance — whole tiles, or 0 when nothing to fold
+        let pointerDown = false;
+        let throwing = false;
+        /** Clone a tile, stripping ids so duplicated markup stays valid. */
+        const cloneTile = () => originalNodes.map((node) => {
+            const copy = node.cloneNode(true);
+            if (copy instanceof Element) {
+                if (copy.id)
+                    copy.removeAttribute("id");
+                copy.querySelectorAll("[id]").forEach((el) => el.removeAttribute("id"));
+            }
+            return copy;
+        });
+        const measure = () => {
+            viewportW = Math.max(1, viewport?.clientWidth || track.clientWidth || 1);
+            if (tile > 0 && clone) {
+                // One tile must be ≥ the viewport, with a spare tile to fold into.
+                for (let i = 8; i > 0 && trackWidth() - tile < viewportW; i--) {
+                    track.append(...cloneTile());
+                }
+            }
+            if (tile <= 0) {
+                loop = 0; // unmeasurable (hidden / jsdom) — drag without folding
+            }
+            else if (clone) {
+                // Largest multiple of `tile` that still leaves room for the viewport.
+                loop = Math.max(0, Math.floor((trackWidth() - viewportW) / tile)) * tile;
+            }
+            else {
+                // Finite mode: keep the content aligned, never an empty gap.
+                loop = Math.max(0, trackWidth() - viewportW);
+            }
+        };
+        const fold = (value) => {
+            if (loop <= 0)
+                return value;
+            return clone
+                ? gsap.utils.wrap(-loop, 0, value)
+                : Math.max(-loop, Math.min(0, value));
+        };
+        /**
+         * Handed to Draggable as `liveSnap.x`. Folds while Draggable is driving
+         * the value (pointer down, or a throw in progress). InertiaPlugin parses
+         * its *end target* with both flags false — that value stays raw so the
+         * throw keeps its direction; syncXY folds every frame of the throw instead.
+         */
+        const foldWhenDriven = (value) => pointerDown || throwing ? fold(value) : value;
+        measure();
+        /* ---------------- rotation on pull ---------------- */
+        const items = toArray(item, track); // after cloning: tiles tilt too
+        gsap.set(items, { transformOrigin: "50% 100%" });
+        const followRotation = gsap.quickTo(items, "rotation", {
+            duration: 0.12,
+            ease: "power2.out",
+        });
+        const settleRotation = gsap.quickTo(items, "rotation", {
+            duration: settleDuration,
+            ease: "power3.out",
+        });
+        let lastPointerX = 0;
+        let lastMoveTime = 0;
+        /* ---------------- drag ---------------- */
+        track.style.cursor = "grab";
+        track.style.userSelect = "none";
+        track.style.touchAction = "pan-y";
+        const draggable = Draggable.create(track, {
+            type: "x",
+            dragClickables: true,
+            inertia,
+            liveSnap: { x: foldWhenDriven },
+            onPress() {
+                pointerDown = true;
+                throwing = false;
+                // A spring from the previous release has had its chance — start fresh.
+                if (settleRotation.tween.isActive())
+                    settleRotation.tween.totalProgress(1);
+                lastPointerX = this.pointerX || 0;
+                lastMoveTime = performance.now();
+                track.style.cursor = "grabbing";
+            },
+            onDrag() {
+                const now = performance.now();
+                const dt = Math.min(64, Math.max(8, now - lastMoveTime));
+                const pointerX = this.pointerX || 0;
+                const dx = pointerX - lastPointerX;
+                lastPointerX = pointerX;
+                lastMoveTime = now;
+                // Pointer speed normalised to a 60fps frame → same feel for every
+                // event rate (mouse vs touch), unlike a raw per-event delta.
+                const speed = (dx / dt) * 16.667;
+                const rotation = gsap.utils.clamp(-maxRotation, maxRotation, -(speed / rotationScale) * 100);
+                followRotation(rotation);
+            },
+            onRelease() {
+                pointerDown = false;
+                track.style.cursor = prevStyle.cursor || "grab";
+                // Hold the last tilt, then spring it back over settleDuration.
+                if (followRotation.tween.isActive())
+                    followRotation.tween.totalProgress(1);
+                settleRotation(0);
+            },
+            onThrowUpdate: () => {
+                throwing = true; // from here on, liveSnap folds each frame
+            },
+            onThrowComplete: () => {
+                throwing = false;
+            },
+            // (throw interruption resets `throwing` on the next press)
+        })[0];
+        /* ---------------- resize ---------------- */
+        const onResize = () => {
+            const x = parseFloat(String(gsap.getProperty(track, "x") ?? 0)) || 0;
+            measure(); // widen if the viewport grew; never removes tiles
+            gsap.set(track, { x: fold(x) }); // re-fold into the new range
+        };
+        window.addEventListener("resize", onResize);
+        return () => {
+            window.removeEventListener("resize", onResize);
+            followRotation.tween.kill();
+            settleRotation.tween.kill();
+            draggable.kill();
+            // Restore the exact inline styles we overwrote (not clearProps:"all",
+            // which would also wipe the consumer's own inline styles).
+            track.style.cursor = prevStyle.cursor;
+            track.style.userSelect = prevStyle.userSelect;
+            track.style.touchAction = prevStyle.touchAction;
+            // Original markup back: drop cloned tiles, then clear our transforms.
+            while (track.children.length > originalCount)
+                track.removeChild(track.lastElementChild);
+            gsap.set([track, ...track.children], { clearProps: "transform,transformOrigin" });
+        };
+    });
+}
+//# sourceMappingURL=drag-strip.js.map

package/dist/effects/drag-strip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag-strip.js","sourceRoot":"","sources":["../../src/effects/drag-strip.ts"],"names":[],"mappings":"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"}

package/dist/effects/hero-shrink.d.ts

@@ -0,0 +1,15 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface HeroShrinkOptions extends CommonOptions {
+    /** How far down the element drifts, as a CSS length. @default "49vh" */
+    offsetY?: string;
+    /** Final scale. @default 0.23 */
+    scale?: number;
+    /** Scrub smoothing — higher = laggier. @default 1 */
+    scrub?: number;
+    start?: string;
+    end?: string;
+    /** Shift on X at the end. @default 0 */
+    offsetX?: string;
+}
+export declare function heroShrink(target: TargetLike, options?: HeroShrinkOptions): Destroy;
+//# sourceMappingURL=hero-shrink.d.ts.map

package/dist/effects/hero-shrink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hero-shrink.d.ts","sourceRoot":"","sources":["../../src/effects/hero-shrink.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAsCvF"}

package/dist/effects/hero-shrink.js

@@ -0,0 +1,40 @@
+/**
+ * Hero shrink — the showreel video that scales down as you scroll away.
+ *
+ *   fromTo(el, { scale: 1, x: 0, y: 0 },
+ *              { x: 0, y: "49vh", scale: 0.23, force3D: true,
+ *                scrollTrigger: { trigger: el, start: "top top",
+ *                                 end: "bottom top", scrub: 1 } })
+ *
+ * The video stays full-bleed at the top of the page and shrinks toward the
+ * bottom-centre as the section scrolls past, with `scrub: 1` giving it that
+ * heavy, lagging feel.
+ */
+import { gsap, ScrollTrigger, initGSAP } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { one } from "../core/util.js";
+export function heroShrink(target, options = {}) {
+    initGSAP();
+    const el = one(target);
+    if (!el)
+        return () => { };
+    const { offsetY = "49vh", offsetX = "0px", scale = 0.23, scrub = 1, start = "top top", end = "bottom top", } = options;
+    return guard(options, () => {
+        const tween = gsap.fromTo(el, { scale: 1, x: 0, y: 0 }, {
+            x: offsetX,
+            y: offsetY,
+            scale,
+            force3D: true,
+            ease: "none",
+            scrollTrigger: { trigger: el, start, end, scrub },
+        });
+        ScrollTrigger.refresh();
+        return () => {
+            tween.scrollTrigger?.kill();
+            tween.kill();
+            gsap.set(el, { clearProps: "transform" });
+            ScrollTrigger.refresh();
+        };
+    });
+}
+//# sourceMappingURL=hero-shrink.js.map

package/dist/effects/hero-shrink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hero-shrink.js","sourceRoot":"","sources":["../../src/effects/hero-shrink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAgBtC,MAAM,UAAU,UAAU,CAAC,MAAkB,EAAE,UAA6B,EAAE;IAC5E,QAAQ,EAAE,CAAC;IAEX,MAAM,EAAE,GAAG,GAAG,CAAc,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAEzB,MAAM,EACJ,OAAO,GAAG,MAAM,EAChB,OAAO,GAAG,KAAK,EACf,KAAK,GAAG,IAAI,EACZ,KAAK,GAAG,CAAC,EACT,KAAK,GAAG,SAAS,EACjB,GAAG,GAAG,YAAY,GACnB,GAAG,OAAO,CAAC;IAEZ,OAAO,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CACvB,EAAE,EACF,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EACxB;YACE,CAAC,EAAE,OAAO;YACV,CAAC,EAAE,OAAO;YACV,KAAK;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,MAAM;YACZ,aAAa,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE;SAClD,CACF,CAAC;QAEF,aAAa,CAAC,OAAO,EAAE,CAAC;QAExB,OAAO,GAAG,EAAE;YACV,KAAK,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;YAC1C,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/effects/horizontal-scroll.d.ts

@@ -0,0 +1,17 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface HorizontalScrollOptions extends CommonOptions {
+    /** Pinned section (trigger). Defaults to the first argument's parent. */
+    section?: TargetLike;
+    /** Selector for images inside panels that get extra parallax. */
+    panelImage?: string | null;
+    /** Scrub smoothing for the horizontal movement. @default 0.5 */
+    scrub?: number;
+    /** Scrub smoothing for the image parallax. @default 0.2 */
+    imageScrub?: number;
+    /** Final X for the track; defaults to `track.scrollWidth - innerWidth`. */
+    travel?: () => number;
+    /** Kill ScrollTriggers created for the images. @default true */
+    imageParallax?: boolean;
+}
+export declare function horizontalScroll(target: TargetLike, options?: HorizontalScrollOptions): Destroy;
+//# sourceMappingURL=horizontal-scroll.d.ts.map

package/dist/effects/horizontal-scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"horizontal-scroll.d.ts","sourceRoot":"","sources":["../../src/effects/horizontal-scroll.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,uBAAwB,SAAQ,aAAa;IAC5D,yEAAyE;IACzE,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,gEAAgE;IAChE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAqFT"}