@cosmictraveler002/anim-kit 1.0.0 → 1.2.0

package/dist/effects/line-reveal.js

@@ -2,7 +2,9 @@
  * Line reveal — the masked, staggered text reveal used all over DZ!NR.
  *
  * Text is split into lines, each line gets an `overflow:hidden` mask, and the
- * inner line slides up from `y:100%` to `y:0%`.
+ * inner line slides up from `y:100%` to `y:0%`. `split: "chars"` runs the
+ * same masked rise per character (`.ak-char-mask > .ak-char`) with a tighter
+ * default stagger — the per-letter headline reveal.
  *
  * Two modes:
  *   mode: "scroll"   → plays when the element enters the viewport and reverses
@@ -17,7 +19,8 @@ import { split } from "../core/split.js";
 import { toArray } from "../core/util.js";
 export function lineReveal(target, options = {}) {
     initGSAP();
-    const { mode = "scroll", stagger = 0.1, duration = 1, ease = "power4.out", delay = 0, start = "top 90%", end = "bottom 10%", } = options;
+    const { mode = "scroll", split: splitType = "lines", stagger, duration = 1, ease = "power4.out", delay = 0, start = "top 90%", end = "bottom 10%", } = options;
+    const stag = stagger ?? (splitType === "chars" ? 0.03 : 0.1);
     const els = toArray(target);
     if (!els.length)
         return () => { };
@@ -27,9 +30,10 @@ export function lineReveal(target, options = {}) {
         const tweens = [];
         els.forEach((el) => {
             const res = split(el, {
-                type: "lines",
+                type: splitType,
                 mask: true,
                 linesClass: "ak-line++",
+                charsClass: "ak-char++",
                 lineThreshold: 0.05,
             });
             splits.push(res);
@@ -41,7 +45,7 @@ export function lineReveal(target, options = {}) {
             const vars = {
                 y: "0%",
                 duration,
-                stagger,
+                stagger: stag,
                 ease,
                 delay,
                 overwrite: "auto",

package/dist/effects/line-reveal.js.map

@@ -1 +1 @@
-{"version":3,"file":"line-reveal.js","sourceRoot":"","sources":["../../src/effects/line-reveal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAoB,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAoB1C,MAAM,UAAU,UAAU,CAAC,MAAkB,EAAE,UAA6B,EAAE;IAC5E,QAAQ,EAAE,CAAC;IAEX,MAAM,EACJ,IAAI,GAAG,QAAQ,EACf,OAAO,GAAG,GAAG,EACb,QAAQ,GAAG,CAAC,EACZ,IAAI,GAAG,YAAY,EACnB,KAAK,GAAG,CAAC,EACT,KAAK,GAAG,SAAS,EACjB,GAAG,GAAG,YAAY,GACnB,GAAG,OAAO,CAAC;IAEZ,MAAM,GAAG,GAAG,OAAO,CAAc,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAEjC,OAAO,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAE3B,SAAS,GAAG;QACV,MAAM,MAAM,GAAkB,EAAE,CAAC;QACjC,MAAM,MAAM,GAAsB,EAAE,CAAC;QAErC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;YACjB,MAAM,GAAG,GAAG,KAAK,CAAC,EAAE,EAAE;gBACpB,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,WAAW;gBACvB,aAAa,EAAE,IAAI;aACpB,CAAC,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEjB,uEAAuE;YACvE,EAAE,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;YAEpF,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM;gBAAE,OAAO;YAEjC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;YAEtC,MAAM,IAAI,GAAmB;gBAC3B,CAAC,EAAE,IAAI;gBACP,QAAQ;gBACR,OAAO;gBACP,IAAI;gBACJ,KAAK;gBACL,SAAS,EAAE,MAAM;aAClB,CAAC;YAEF,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,IAAI,CAAC,aAAa,GAAG;oBACnB,OAAO,EAAE,EAAE;oBACX,KAAK;oBACL,GAAG;oBACH,aAAa,EAAE,2BAA2B;iBAC3C,CAAC;YACJ,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,aAAa,CAAC,OAAO,EAAE,CAAC;QAExB,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;gBACnB,CAAC,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;gBACxB,CAAC,CAAC,IAAI,EAAE,CAAC;YACX,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAClC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"line-reveal.js","sourceRoot":"","sources":["../../src/effects/line-reveal.ts"],"names":[],"mappings":"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"}

package/dist/effects/magnetic.d.ts

@@ -0,0 +1,15 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface MagneticOptions extends CommonOptions {
+    /** How far the element follows the pointer — fraction of its own box. @default 0.4 */
+    strength?: number;
+    /** Max tilt in degrees at full pull (0 disables rotation). @default 8 */
+    rotation?: number;
+    /** Scale held while the pointer is over the element (1 = none). @default 1 */
+    scale?: number;
+    /** Spring-back duration, seconds. @default 1.2 */
+    duration?: number;
+    /** Spring-back ease. @default "elastic.out(1, 0.35)" */
+    ease?: string;
+}
+export declare function magnetic(target: TargetLike, options?: MagneticOptions): Destroy;
+//# sourceMappingURL=magnetic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"magnetic.d.ts","sourceRoot":"","sources":["../../src/effects/magnetic.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAuDnF"}

package/dist/effects/magnetic.js

@@ -0,0 +1,59 @@
+/**
+ * Magnetic hover — buttons and links that pull toward the pointer.
+ *
+ * While the pointer is over the element it follows the cursor (a fraction
+ * of its own box), tilts toward the pull, and optionally grows a touch.
+ * On leave it springs back to rest with an elastic snap:
+ *
+ *   magnetic("[data-magnet]", { strength: 0.5, rotation: 10 });
+ *
+ * Attach it to individual buttons/links (or a container's children — pass
+ * the list). destroy() removes the listeners, kills in-flight tweens and
+ * restores the inline transform.
+ */
+import { gsap, initGSAP, killTweens } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { toArray } from "../core/util.js";
+export function magnetic(target, options = {}) {
+    initGSAP();
+    const els = toArray(target);
+    if (!els.length)
+        return () => { };
+    const { strength = 0.4, rotation = 8, scale = 1, duration = 1.2, ease = "elastic.out(1, 0.35)", } = options;
+    return guard(options, () => {
+        const prevTransform = els.map((el) => el.style.transform);
+        const listeners = [];
+        els.forEach((el) => {
+            const onMove = (e) => {
+                const ptr = e;
+                const r = el.getBoundingClientRect();
+                const dx = ptr.clientX - (r.left + r.width / 2);
+                const dy = ptr.clientY - (r.top + r.height / 2);
+                const nx = r.width ? dx / (r.width / 2) : 0; // -1 … 1 across the box
+                gsap.to(el, {
+                    x: dx * strength,
+                    y: dy * strength,
+                    rotation: rotation ? nx * rotation : 0,
+                    scale,
+                    duration: 0.4,
+                    ease: "power3.out",
+                    overwrite: "auto",
+                });
+            };
+            const onLeave = () => {
+                gsap.to(el, { x: 0, y: 0, rotation: 0, scale: 1, duration, ease, overwrite: "auto" });
+            };
+            el.addEventListener("pointermove", onMove);
+            el.addEventListener("pointerleave", onLeave);
+            listeners.push({ el, type: "pointermove", fn: onMove }, { el, type: "pointerleave", fn: onLeave });
+        });
+        return () => {
+            listeners.forEach(({ el, type, fn }) => el.removeEventListener(type, fn));
+            killTweens(els);
+            els.forEach((el, i) => {
+                el.style.transform = prevTransform[i];
+            });
+        };
+    });
+}
+//# sourceMappingURL=magnetic.js.map

package/dist/effects/magnetic.js.map

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

package/dist/effects/media-settle.d.ts

@@ -0,0 +1,30 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface MediaSettleOptions extends CommonOptions {
+    /** Starting scale — settles down to 1. @default 1.15 */
+    from?: number;
+    /** Animation duration, seconds (enter mode). @default 1.5 */
+    duration?: number;
+    /** GSAP ease. @default "power2.out" */
+    ease?: string;
+    /** transformOrigin. @default "center" */
+    origin?: string;
+    /** Stagger between targets, seconds. @default 0.06 */
+    stagger?: number;
+    /** Delay before playing, seconds. @default 0 */
+    delay?: number;
+    /** "scroll" plays on enter, "immediate" plays at once. @default "scroll" */
+    mode?: "scroll" | "immediate";
+    /** ScrollTrigger start position. @default "top 75%" */
+    start?: string;
+    /** ScrollTrigger end position (scrub mode). @default "bottom top" */
+    end?: string;
+    /** Re-settle when leaving / re-entering the viewport (enter mode). @default false */
+    replay?: boolean;
+    /**
+     * Bind the settle to scroll progress instead of playing it on enter —
+     * number = scrub smoothing seconds, `true` = immediate. unset = one-shot.
+     */
+    scrub?: number | boolean;
+}
+export declare function mediaSettle(target: TargetLike, options?: MediaSettleOptions): Destroy;
+//# sourceMappingURL=media-settle.d.ts.map

package/dist/effects/media-settle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-settle.d.ts","sourceRoot":"","sources":["../../src/effects/media-settle.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC9B,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CA2DzF"}

package/dist/effects/media-settle.js

@@ -0,0 +1,55 @@
+/**
+ * Media settle — images that arrive slightly oversized and settle to size.
+ *
+ * The classic entrance for grids and heroes: media enters at `scale > 1`
+ * and eases down to 1 as the section arrives (or across the scroll range in
+ * `scrub` mode), so content lands instead of popping in.
+ *
+ *   mediaSettle("[data-settle]", { from: 1.3 });            // on enter
+ *   mediaSettle("[data-settle]", { scrub: 0.5 });           // scroll-bound
+ *   mediaSettle("[data-settle]", { replay: true });         // reverse on leave-back, replay on re-enter
+ *
+ * destroy() kills the tween and restores the original scale.
+ */
+import { gsap, ScrollTrigger, initGSAP } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { toArray } from "../core/util.js";
+export function mediaSettle(target, options = {}) {
+    initGSAP();
+    const { from = 1.15, duration = 1.5, ease = "power2.out", origin = "center", stagger = 0.06, delay = 0, mode = "scroll", start = "top 75%", end = "bottom top", replay = false, scrub, } = options;
+    const els = toArray(target);
+    if (!els.length)
+        return () => { };
+    return guard(options, run);
+    function run() {
+        gsap.set(els, { scale: from, transformOrigin: origin });
+        const vars = { scale: 1, stagger, delay, overwrite: "auto" };
+        if (scrub !== undefined) {
+            vars.ease = "none";
+            vars.scrollTrigger = {
+                trigger: els[0],
+                start,
+                end,
+                scrub: scrub === true ? true : scrub,
+            };
+        }
+        else {
+            vars.duration = duration;
+            vars.ease = ease;
+            if (mode === "scroll") {
+                vars.scrollTrigger = replay
+                    ? { trigger: els[0], start, toggleActions: "play reverse play reverse" }
+                    : { trigger: els[0], start, once: true };
+            }
+        }
+        const tween = gsap.fromTo(els, { scale: from, transformOrigin: origin }, { ...vars, immediateRender: true });
+        ScrollTrigger.refresh();
+        return () => {
+            tween.scrollTrigger?.kill();
+            tween.kill();
+            gsap.set(els, { clearProps: "transform,transformOrigin" });
+            ScrollTrigger.refresh();
+        };
+    }
+}
+//# sourceMappingURL=media-settle.js.map

package/dist/effects/media-settle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-settle.js","sourceRoot":"","sources":["../../src/effects/media-settle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AA+B1C,MAAM,UAAU,WAAW,CAAC,MAAkB,EAAE,UAA8B,EAAE;IAC9E,QAAQ,EAAE,CAAC;IAEX,MAAM,EACJ,IAAI,GAAG,IAAI,EACX,QAAQ,GAAG,GAAG,EACd,IAAI,GAAG,YAAY,EACnB,MAAM,GAAG,QAAQ,EACjB,OAAO,GAAG,IAAI,EACd,KAAK,GAAG,CAAC,EACT,IAAI,GAAG,QAAQ,EACf,KAAK,GAAG,SAAS,EACjB,GAAG,GAAG,YAAY,EAClB,MAAM,GAAG,KAAK,EACd,KAAK,GACN,GAAG,OAAO,CAAC;IAEZ,MAAM,GAAG,GAAG,OAAO,CAAc,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAEjC,OAAO,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAE3B,SAAS,GAAG;QACV,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC;QAExD,MAAM,IAAI,GAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAE7E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;YACnB,IAAI,CAAC,aAAa,GAAG;gBACnB,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;gBACf,KAAK;gBACL,GAAG;gBACH,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;aACrC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;YACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,IAAI,CAAC,aAAa,GAAG,MAAM;oBACzB,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,2BAA2B,EAAE;oBACxE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CACvB,GAAG,EACH,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,EACxC,EAAE,GAAG,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,CACnC,CAAC;QACF,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,GAAG,EAAE,EAAE,UAAU,EAAE,2BAA2B,EAAE,CAAC,CAAC;YAC3D,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/effects/roll-text.d.ts

@@ -0,0 +1,13 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface RollTextOptions extends CommonOptions {
+    /** Seconds each row is shown (including the roll). @default 2.2 */
+    interval?: number;
+    /** Roll duration, seconds. @default 0.6 */
+    duration?: number;
+    /** GSAP ease for the roll. @default "power4.inOut" */
+    ease?: string;
+    /** "up" rolls rows upward, "down" walks them in reverse. @default "up" */
+    direction?: "up" | "down";
+}
+export declare function rollText(target: TargetLike, options?: RollTextOptions): Destroy;
+//# sourceMappingURL=roll-text.d.ts.map

package/dist/effects/roll-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roll-text.d.ts","sourceRoot":"","sources":["../../src/effects/roll-text.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC3B;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAsFnF"}

package/dist/effects/roll-text.js

@@ -0,0 +1,91 @@
+/**
+ * Roll text — the rolling word rotator.
+ *
+ * The target holds two or more rows; they are stacked into a hidden overflow
+ * box one row tall, and the box rolls to the next row on an interval — the
+ * first row is cloned at the end so the wrap is seamless (same trick as
+ * `marquee()`).
+ *
+ *   <span class="ak-roll" data-roll>
+ *     <span>Design</span><span>Code</span><span>Motion</span>
+ *   </span>
+ *
+ * destroy() unwraps the rows, removes the clone and restores every inline
+ * style it touched — markup comes back byte-identical.
+ */
+import { gsap, initGSAP, killTweens } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { toArray } from "../core/util.js";
+export function rollText(target, options = {}) {
+    initGSAP();
+    const { interval = 2.2, duration = 0.6, ease = "power4.inOut", direction = "up" } = options;
+    const els = toArray(target);
+    if (!els.length)
+        return () => { };
+    return guard(options, () => {
+        const setups = [];
+        els.forEach((el) => {
+            const rows = Array.from(el.children).filter((n) => n instanceof HTMLElement);
+            if (rows.length < 2)
+                return;
+            // Snapshot inline styles BEFORE touching them (restored on destroy).
+            const snapshots = [
+                { el, cssText: el.style.cssText },
+                ...rows.map((r) => ({ el: r, cssText: r.style.cssText })),
+            ];
+            // Rows must stack as blocks for the box to measure one row.
+            rows.forEach((r) => (r.style.display = "block"));
+            if (window.getComputedStyle(el).display === "inline")
+                el.style.display = "inline-block";
+            const inner = document.createElement("div");
+            inner.className = "ak-roll__inner";
+            el.insertBefore(inner, rows[0]);
+            rows.forEach((r) => inner.appendChild(r));
+            const clone = rows[0].cloneNode(true);
+            clone.setAttribute("data-ak-roll-clone", "");
+            inner.appendChild(clone);
+            const rowH = rows[0].getBoundingClientRect().height;
+            el.style.overflow = "hidden";
+            el.style.height = `${rowH}px`;
+            el.dataset.akRoll = String(rows.length);
+            let timeline = null;
+            if (rowH > 0) {
+                const n = rows.length;
+                const hold = Math.max(0.01, interval - duration);
+                const tl = gsap.timeline({ repeat: -1, defaults: { ease } });
+                if (direction === "up") {
+                    gsap.set(inner, { y: 0 });
+                    for (let i = 1; i <= n; i++) {
+                        tl.to(inner, { y: -i * rowH, duration });
+                        tl.to({}, { duration: hold });
+                    }
+                    tl.set(inner, { y: 0 });
+                }
+                else {
+                    gsap.set(inner, { y: -n * rowH });
+                    for (let i = n - 1; i >= 0; i--) {
+                        tl.to(inner, { y: -i * rowH, duration });
+                        tl.to({}, { duration: hold });
+                    }
+                    tl.set(inner, { y: -n * rowH });
+                }
+                timeline = tl;
+            }
+            setups.push({ el, inner, rows, snapshots, timeline });
+            // Clone lives inside inner — remember it for teardown via the attribute.
+        });
+        return () => {
+            setups.forEach(({ el, inner, rows, snapshots, timeline }) => {
+                timeline?.kill();
+                // Unwrap: rows home first, then drop the (now empty) inner box.
+                rows.forEach((r) => el.appendChild(r));
+                inner.remove();
+                killTweens(inner);
+                snapshots.forEach(({ el: node, cssText }) => (node.style.cssText = cssText));
+                delete el.dataset.akRoll;
+            });
+            setups.length = 0;
+        };
+    });
+}
+//# sourceMappingURL=roll-text.js.map

package/dist/effects/roll-text.js.map

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

package/dist/effects/scramble-text.d.ts

@@ -0,0 +1,17 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface ScrambleTextOptions extends CommonOptions {
+    /** "scroll" plays on enter, "immediate" now, "hover" on pointerenter. @default "scroll" */
+    mode?: "scroll" | "immediate" | "hover";
+    /** Glyphs each letter churns through. @default "abcdefghijklmnopqrstuvwxyz" */
+    charset?: string;
+    /** Seconds each character spends scrambling. @default 0.18 */
+    durationPerChar?: number;
+    /** Delay between character starts, seconds. @default 0.04 */
+    stagger?: number;
+    /** Delay before the timeline starts, seconds. @default 0 */
+    delay?: number;
+    /** ScrollTrigger start position (mode: "scroll"). @default "top 80%" */
+    start?: string;
+}
+export declare function scrambleText(target: TargetLike, options?: ScrambleTextOptions): Destroy;
+//# sourceMappingURL=scramble-text.d.ts.map

package/dist/effects/scramble-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scramble-text.d.ts","sourceRoot":"","sources":["../../src/effects/scramble-text.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,2FAA2F;IAC3F,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;IACxC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAwF3F"}

package/dist/effects/scramble-text.js

@@ -0,0 +1,93 @@
+/**
+ * Scramble text — the decode / cipher reveal.
+ *
+ * Each character churns through the charset and settles on its final glyph,
+ * left to right; letters scramble, everything else (digits, punctuation,
+ * spaces) stays put, and case is preserved. Three triggers:
+ *
+ *   mode: "scroll"    → plays once when the element enters the viewport.
+ *   mode: "immediate" → plays at once (above the fold).
+ *   mode: "hover"     → re-scrambles on every pointer enter.
+ *
+ * The element's textContent is restored exactly on destroy.
+ */
+import { gsap, ScrollTrigger, initGSAP } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { toArray } from "../core/util.js";
+export function scrambleText(target, options = {}) {
+    initGSAP();
+    const { mode = "scroll", charset = "abcdefghijklmnopqrstuvwxyz", durationPerChar = 0.18, stagger = 0.04, delay = 0, start = "top 80%", } = options;
+    const els = toArray(target);
+    if (!els.length)
+        return () => { };
+    return guard(options, () => {
+        const originals = new Map();
+        const timelines = [];
+        const cleanups = [];
+        /** Fill a timeline with one eased scramble tween per letter. */
+        const fill = (el, original, tl) => {
+            Array.from(original).forEach((ch, i) => {
+                if (!/[a-z]/i.test(ch))
+                    return; // digits / punctuation / spaces stay put
+                const upper = ch === ch.toUpperCase();
+                const state = { p: 0 };
+                tl.to(state, {
+                    p: 1,
+                    duration: durationPerChar,
+                    ease: "power3.out",
+                    onUpdate: () => {
+                        if (state.p >= 1)
+                            return;
+                        const glyph = charset[Math.floor(Math.random() * charset.length)];
+                        el.textContent =
+                            original.slice(0, i) + (upper ? glyph.toUpperCase() : glyph) + original.slice(i + 1);
+                    },
+                }, i * stagger);
+            });
+            tl.eventCallback("onComplete", () => (el.textContent = original));
+        };
+        els.forEach((el) => {
+            const original = el.textContent ?? "";
+            if (!original)
+                return;
+            originals.set(el, original);
+            el.dataset.akScramble = "true";
+            if (mode === "scroll") {
+                const tl = gsap.timeline({
+                    delay,
+                    scrollTrigger: { trigger: el, start, once: true },
+                });
+                fill(el, original, tl);
+                timelines.push(tl);
+            }
+            else if (mode === "immediate") {
+                const tl = gsap.timeline({ delay });
+                fill(el, original, tl);
+                timelines.push(tl);
+            }
+            else {
+                const tl = gsap.timeline({ delay, paused: true });
+                fill(el, original, tl);
+                timelines.push(tl);
+                const onEnter = () => tl.restart();
+                el.addEventListener("pointerenter", onEnter);
+                cleanups.push(() => el.removeEventListener("pointerenter", onEnter));
+            }
+        });
+        ScrollTrigger.refresh();
+        return () => {
+            cleanups.forEach((fn) => fn());
+            timelines.forEach((tl) => {
+                tl.scrollTrigger?.kill();
+                tl.kill();
+            });
+            originals.forEach((text, el) => {
+                el.textContent = text;
+                delete el.dataset.akScramble;
+            });
+            originals.clear();
+            ScrollTrigger.refresh();
+        };
+    });
+}
+//# sourceMappingURL=scramble-text.js.map

package/dist/effects/scramble-text.js.map

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

package/dist/effects/unfold-reveal.d.ts

@@ -0,0 +1,23 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface UnfoldRevealOptions extends CommonOptions {
+    /** Which axis grows open. @default "y" */
+    axis?: "y" | "x";
+    /** transformOrigin — defaults to "top" (y) / "left" (x). */
+    origin?: string;
+    /** Animation duration, seconds. @default 0.7 */
+    duration?: number;
+    /** GSAP ease. @default "power3.out" */
+    ease?: string;
+    /** Stagger between targets, seconds. @default 0.08 */
+    stagger?: number;
+    /** Delay before playing, seconds. @default 0 */
+    delay?: number;
+    /** "scroll" plays on enter, "immediate" plays at once. @default "scroll" */
+    mode?: "scroll" | "immediate";
+    /** ScrollTrigger start position. @default "top 85%" */
+    start?: string;
+    /** Re-unfold when leaving / re-entering the viewport. @default false */
+    replay?: boolean;
+}
+export declare function unfoldReveal(target: TargetLike, options?: UnfoldRevealOptions): Destroy;
+//# sourceMappingURL=unfold-reveal.d.ts.map

package/dist/effects/unfold-reveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unfold-reveal.d.ts","sourceRoot":"","sources":["../../src/effects/unfold-reveal.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,0CAA0C;IAC1C,IAAI,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IACjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC9B,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAoD3F"}

package/dist/effects/unfold-reveal.js

@@ -0,0 +1,53 @@
+/**
+ * Unfold reveal — blocks that grow open from an edge.
+ *
+ * `scaleY: 0 → 1` from the top (or bottom) edge for a vertical unfold,
+ * `scaleX: 0 → 1` from the left for a horizontal one — the staggered block
+ * grow-in used for labels, headings and buttons as a section enters.
+ *
+ *   unfoldReveal("[data-unfold]", { axis: "y", origin: "top" });
+ *   unfoldReveal("[data-unfold-x]", { axis: "x", origin: "left" });
+ *
+ * Targets stagger together off the first match's trigger. destroy() kills the
+ * tween and clears the transform, so elements rest exactly as authored.
+ */
+import { gsap, ScrollTrigger, initGSAP } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { toArray } from "../core/util.js";
+export function unfoldReveal(target, options = {}) {
+    initGSAP();
+    const { axis = "y", origin, duration = 0.7, ease = "power3.out", stagger = 0.08, delay = 0, mode = "scroll", start = "top 85%", replay = false, } = options;
+    const els = toArray(target);
+    if (!els.length)
+        return () => { };
+    return guard(options, run);
+    function run() {
+        const prop = axis === "x" ? "scaleX" : "scaleY";
+        const from = origin ?? (axis === "x" ? "left" : "top");
+        gsap.set(els, { [prop]: 0, transformOrigin: from });
+        const vars = {
+            [prop]: 1,
+            duration,
+            ease,
+            stagger,
+            delay,
+            overwrite: "auto",
+        };
+        if (mode === "scroll") {
+            vars.scrollTrigger = {
+                trigger: els[0],
+                start,
+                toggleActions: replay ? "play reverse play reverse" : "play none none none",
+            };
+        }
+        const tween = gsap.to(els, vars);
+        ScrollTrigger.refresh();
+        return () => {
+            tween.scrollTrigger?.kill();
+            tween.kill();
+            gsap.set(els, { clearProps: "transform,transformOrigin" });
+            ScrollTrigger.refresh();
+        };
+    }
+}
+//# sourceMappingURL=unfold-reveal.js.map

package/dist/effects/unfold-reveal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unfold-reveal.js","sourceRoot":"","sources":["../../src/effects/unfold-reveal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAwB1C,MAAM,UAAU,YAAY,CAAC,MAAkB,EAAE,UAA+B,EAAE;IAChF,QAAQ,EAAE,CAAC;IAEX,MAAM,EACJ,IAAI,GAAG,GAAG,EACV,MAAM,EACN,QAAQ,GAAG,GAAG,EACd,IAAI,GAAG,YAAY,EACnB,OAAO,GAAG,IAAI,EACd,KAAK,GAAG,CAAC,EACT,IAAI,GAAG,QAAQ,EACf,KAAK,GAAG,SAAS,EACjB,MAAM,GAAG,KAAK,GACf,GAAG,OAAO,CAAC;IAEZ,MAAM,GAAG,GAAG,OAAO,CAAc,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAEjC,OAAO,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAE3B,SAAS,GAAG;QACV,MAAM,IAAI,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAEvD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,MAAM,IAAI,GAAmB;YAC3B,CAAC,IAAI,CAAC,EAAE,CAAC;YACT,QAAQ;YACR,IAAI;YACJ,OAAO;YACP,KAAK;YACL,SAAS,EAAE,MAAM;SAClB,CAAC;QACF,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,IAAI,CAAC,aAAa,GAAG;gBACnB,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;gBACf,KAAK;gBACL,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,qBAAqB;aAC5E,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACjC,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,GAAG,EAAE,EAAE,UAAU,EAAE,2BAA2B,EAAE,CAAC,CAAC;YAC3D,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC,CAAC;IACJ,CAAC;AACH,CAAC"}