@cosmictraveler002/anim-kit 1.0.0

package/dist/core/gsap.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Central GSAP bootstrap: registers every plugin anim-kit touches, and the
+ * custom eases that give the DZ!NR feel.
+ *
+ * Importing this module twice is safe — registration is idempotent.
+ */
+import { gsap } from "gsap";
+import { ScrollTrigger } from "gsap/ScrollTrigger";
+import { SplitText } from "gsap/SplitText";
+import { Draggable } from "gsap/Draggable";
+import { CustomEase } from "gsap/CustomEase";
+import { ScrollSmoother } from "gsap/ScrollSmoother";
+import type { TargetLike } from "./types.js";
+export { gsap, ScrollTrigger, SplitText, Draggable, CustomEase, ScrollSmoother };
+/** Named eases recovered from dzinrstudio.com's bundles. */
+export declare const EASES: {
+    /** `.76,0,.2,1` — the studio's signature menu / nav curtain ease. */
+    readonly curtain: "ak-curtain";
+    /** SVG path used for the stacked service-card cascade. */
+    readonly cardStack: "ak-card-stack";
+    /** `.165,.84,.44,1` — their headline mask reveal. */
+    readonly reveal: "ak-reveal";
+    /** `.895,.03,.685,.22` — preloader logo scale-out. */
+    readonly preloadOut: "ak-preload-out";
+};
+/** Register all plugins + custom eases exactly once. */
+export declare function initGSAP(): void;
+/**
+ * Kill every tween that animates `target`.
+ *
+ * Deliberately **not** `gsap.killTweensOf()`. That forwards to
+ * `tween.kill(targets, …)`, which walks each tween's *initialised*
+ * prop-tween lookup — but a tween created between ticker frames is still
+ * lazy (`_initted === false`), its lookup is empty, and the kill silently
+ * no-ops. Such a tween then fires *after* teardown (e.g. an equaliser batch
+ * rewriting `height` post-destroy). The no-arg `tween.kill()` takes the
+ * full-kill path and removes both initialised and lazy tweens from the
+ * timeline.
+ *
+ * Internal helper — effects import it from `core/gsap.js`; it is not part of
+ * the public barrel.
+ */
+export declare function killTweens(target: TargetLike | Array<Element | null | undefined>): void;
+//# sourceMappingURL=gsap.d.ts.map

package/dist/core/gsap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsap.d.ts","sourceRoot":"","sources":["../../src/core/gsap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AAEjF,4DAA4D;AAC5D,eAAO,MAAM,KAAK;IAChB,qEAAqE;;IAErE,0DAA0D;;IAE1D,qDAAqD;;IAErD,sDAAsD;;CAE9C,CAAC;AAIX,wDAAwD;AACxD,wBAAgB,QAAQ,IAAI,IAAI,CAuB/B;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,CAIvF"}

package/dist/core/gsap.js

@@ -0,0 +1,71 @@
+/**
+ * Central GSAP bootstrap: registers every plugin anim-kit touches, and the
+ * custom eases that give the DZ!NR feel.
+ *
+ * Importing this module twice is safe — registration is idempotent.
+ */
+import { gsap } from "gsap";
+import { ScrollTrigger } from "gsap/ScrollTrigger";
+import { SplitText } from "gsap/SplitText";
+import { Draggable } from "gsap/Draggable";
+import { CustomEase } from "gsap/CustomEase";
+import { ScrollSmoother } from "gsap/ScrollSmoother";
+import { toArray } from "./util.js";
+export { gsap, ScrollTrigger, SplitText, Draggable, CustomEase, ScrollSmoother };
+/** Named eases recovered from dzinrstudio.com's bundles. */
+export const EASES = {
+    /** `.76,0,.2,1` — the studio's signature menu / nav curtain ease. */
+    curtain: "ak-curtain",
+    /** SVG path used for the stacked service-card cascade. */
+    cardStack: "ak-card-stack",
+    /** `.165,.84,.44,1` — their headline mask reveal. */
+    reveal: "ak-reveal",
+    /** `.895,.03,.685,.22` — preloader logo scale-out. */
+    preloadOut: "ak-preload-out",
+};
+let initted = false;
+/** Register all plugins + custom eases exactly once. */
+export function initGSAP() {
+    if (initted || typeof window === "undefined")
+        return;
+    initted = true;
+    gsap.registerPlugin(ScrollTrigger, SplitText, Draggable, CustomEase);
+    // ScrollSmoother is a bonus for people who prefer it over Lenis; it is only
+    // registered so `ScrollSmoother.create()` works if you call it yourself.
+    try {
+        gsap.registerPlugin(ScrollSmoother);
+    }
+    catch {
+        /* not fatal — smoother is optional */
+    }
+    if (!CustomEase.get(EASES.curtain)) {
+        CustomEase.create(EASES.curtain, ".76,0,.2,1");
+        CustomEase.create(EASES.cardStack, "M0,0 C0,0 0.098,0.613 0.5,0.5 0.899,0.386 1,1 1,1");
+        CustomEase.create(EASES.reveal, ".165,.84,.44,1");
+        CustomEase.create(EASES.preloadOut, ".895,.03,.685,.22");
+    }
+    // Keep ScrollTrigger honest when images/fonts land late.
+    ScrollTrigger.config({ ignoreMobileResize: true });
+}
+initGSAP();
+/**
+ * Kill every tween that animates `target`.
+ *
+ * Deliberately **not** `gsap.killTweensOf()`. That forwards to
+ * `tween.kill(targets, …)`, which walks each tween's *initialised*
+ * prop-tween lookup — but a tween created between ticker frames is still
+ * lazy (`_initted === false`), its lookup is empty, and the kill silently
+ * no-ops. Such a tween then fires *after* teardown (e.g. an equaliser batch
+ * rewriting `height` post-destroy). The no-arg `tween.kill()` takes the
+ * full-kill path and removes both initialised and lazy tweens from the
+ * timeline.
+ *
+ * Internal helper — effects import it from `core/gsap.js`; it is not part of
+ * the public barrel.
+ */
+export function killTweens(target) {
+    const raw = Array.isArray(target) ? target : toArray(target);
+    const list = raw.filter((el) => el instanceof Element);
+    gsap.getTweensOf(list).forEach((t) => t.kill());
+}
+//# sourceMappingURL=gsap.js.map

package/dist/core/gsap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsap.js","sourceRoot":"","sources":["../../src/core/gsap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AAEjF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,qEAAqE;IACrE,OAAO,EAAE,YAAY;IACrB,0DAA0D;IAC1D,SAAS,EAAE,eAAe;IAC1B,qDAAqD;IACrD,MAAM,EAAE,WAAW;IACnB,sDAAsD;IACtD,UAAU,EAAE,gBAAgB;CACpB,CAAC;AAEX,IAAI,OAAO,GAAG,KAAK,CAAC;AAEpB,wDAAwD;AACxD,MAAM,UAAU,QAAQ;IACtB,IAAI,OAAO,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IACrD,OAAO,GAAG,IAAI,CAAC;IAEf,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAErE,4EAA4E;IAC5E,yEAAyE;IACzE,IAAI,CAAC;QACH,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC/C,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,mDAAmD,CAAC,CAAC;QACxF,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAClD,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;IAC3D,CAAC;IAED,yDAAyD;IACzD,aAAa,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,QAAQ,EAAE,CAAC;AAEX;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CAAC,MAAsD;IAC/E,MAAM,GAAG,GAAsC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChG,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAiB,EAAE,CAAC,EAAE,YAAY,OAAO,CAAC,CAAC;IACtE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/core/guard.d.ts

@@ -0,0 +1,3 @@
+import type { CommonOptions, Destroy } from "./types.js";
+export declare function guard(options: CommonOptions, run: () => Destroy): Destroy;
+//# sourceMappingURL=guard.d.ts.map

package/dist/core/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/core/guard.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEzD,wBAAgB,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,OAAO,GAAG,OAAO,CAIzE"}

package/dist/core/guard.js

@@ -0,0 +1,18 @@
+/**
+ * Reduced-motion helper.
+ *
+ * Every effect calls `guard(options, run)`.
+ *  - normal motion  -> runs `run()` and returns its destroy fn
+ *  - reduced motion -> returns a no-op so nothing animates. Effects that need
+ *                      content visible in both states should render the final
+ *                      state in CSS (see styles/anim-kit.css).
+ */
+import { initGSAP } from "./gsap.js";
+import { prefersReducedMotion } from "./util.js";
+export function guard(options, run) {
+    initGSAP();
+    if (prefersReducedMotion() && !options.force)
+        return () => { };
+    return run();
+}
+//# sourceMappingURL=guard.js.map

package/dist/core/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/core/guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAGjD,MAAM,UAAU,KAAK,CAAC,OAAsB,EAAE,GAAkB;IAC9D,QAAQ,EAAE,CAAC;IACX,IAAI,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAC9D,OAAO,GAAG,EAAE,CAAC;AACf,CAAC"}

package/dist/core/smooth-scroll.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Lenis smooth scrolling wired into GSAP ScrollTrigger.
+ *
+ * Uses the canonical Lenis + GSAP recipe:
+ *   lenis.on("scroll", ScrollTrigger.update)
+ *   gsap.ticker.add(t => lenis.raf(t * 1000))
+ *   gsap.ticker.lagSmoothing(0)
+ *
+ * Driving Lenis from GSAP's ticker (rather than its own rAF) keeps both
+ * clocks on the same frame, which is what stops ScrollTrigger from stuttering.
+ *
+ * `useScrollerProxy: true` additionally proxies `document.documentElement`,
+ * matching dzinrstudio.com's setup — only needed if you scroll a nested
+ * element instead of the window.
+ */
+import Lenis from "lenis";
+import type { CommonOptions, Destroy } from "./types.js";
+export interface SmoothScrollOptions extends CommonOptions {
+    /** Interpolation factor — lower = floatier. @default 0.08 */
+    lerp?: number;
+    /** Smooth mouse-wheel input. @default true */
+    smoothWheel?: boolean;
+    /** Smooth touch input (can fight native scrolling). @default false */
+    smoothTouch?: boolean;
+    /** Direction to smooth. @default "vertical" */
+    orientation?: "vertical" | "horizontal";
+    /** Initial scroll position in px. @default 0 */
+    initialScroll?: number;
+    /** Proxy documentElement through ScrollTrigger (nested scrollers). @default false */
+    useScrollerProxy?: boolean;
+}
+export interface SmoothScrollHandle {
+    /** The Lenis instance, or null when smooth scrolling was skipped. */
+    lenis: Lenis | null;
+    /** Programmatic scroll that respects the smooth scroller. */
+    scrollTo: (target: number | string | HTMLElement, opts?: {
+        duration?: number;
+        immediate?: boolean;
+    }) => void;
+    /** True when Lenis is actually driving the page. */
+    active: boolean;
+    destroy: Destroy;
+}
+export declare function smoothScroll(options?: SmoothScrollOptions): SmoothScrollHandle;
+//# sourceMappingURL=smooth-scroll.d.ts.map

package/dist/core/smooth-scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smooth-scroll.d.ts","sourceRoot":"","sources":["../../src/core/smooth-scroll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACxC,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7G,oDAAoD;IACpD,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AASD,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,kBAAkB,CA0FlF"}

package/dist/core/smooth-scroll.js

@@ -0,0 +1,98 @@
+/**
+ * Lenis smooth scrolling wired into GSAP ScrollTrigger.
+ *
+ * Uses the canonical Lenis + GSAP recipe:
+ *   lenis.on("scroll", ScrollTrigger.update)
+ *   gsap.ticker.add(t => lenis.raf(t * 1000))
+ *   gsap.ticker.lagSmoothing(0)
+ *
+ * Driving Lenis from GSAP's ticker (rather than its own rAF) keeps both
+ * clocks on the same frame, which is what stops ScrollTrigger from stuttering.
+ *
+ * `useScrollerProxy: true` additionally proxies `document.documentElement`,
+ * matching dzinrstudio.com's setup — only needed if you scroll a nested
+ * element instead of the window.
+ */
+import Lenis from "lenis";
+import { gsap, ScrollTrigger, initGSAP } from "./gsap.js";
+import { prefersReducedMotion } from "./util.js";
+const INERT = {
+    lenis: null,
+    scrollTo: () => { },
+    active: false,
+    destroy: () => { },
+};
+export function smoothScroll(options = {}) {
+    initGSAP();
+    const { force = false, lerp = 0.08, smoothWheel = true, smoothTouch = false, orientation = "vertical", initialScroll = 0, useScrollerProxy = false, } = options;
+    if (typeof window === "undefined")
+        return INERT;
+    // Honour the OS-level preference: fall back to native scrolling.
+    if (prefersReducedMotion() && !force)
+        return INERT;
+    const lenis = new Lenis({
+        lerp,
+        smoothWheel,
+        syncTouch: smoothTouch,
+        orientation,
+        autoRaf: false,
+    });
+    if (initialScroll)
+        lenis.scrollTo(initialScroll, { immediate: true });
+    // 1. Let ScrollTrigger know whenever Lenis moves.
+    const onScroll = () => ScrollTrigger.update();
+    lenis.on("scroll", onScroll);
+    // 2. Run Lenis off GSAP's ticker so both share one frame clock.
+    const tick = (time) => lenis.raf(time * 1000);
+    gsap.ticker.add(tick);
+    gsap.ticker.lagSmoothing(0);
+    // 3. Optional: proxy the scroller (for nested/element scrollers).
+    if (useScrollerProxy) {
+        ScrollTrigger.scrollerProxy(document.documentElement, {
+            scrollTop(value) {
+                if (arguments.length && typeof value === "number") {
+                    lenis.scrollTo(value, { immediate: true });
+                    return value;
+                }
+                return lenis.scroll;
+            },
+            getBoundingClientRect: () => ({
+                top: 0,
+                left: 0,
+                width: window.innerWidth,
+                height: window.innerHeight,
+            }),
+            // Lenis drives the window, so the documentElement is always visible.
+            pinType: "fixed",
+        });
+        ScrollTrigger.defaults({ scroller: document.documentElement });
+    }
+    const onResize = () => {
+        lenis.resize();
+        ScrollTrigger.refresh();
+    };
+    window.addEventListener("resize", onResize);
+    // Fonts and late images change layout; refresh once they land.
+    const refresh = () => ScrollTrigger.refresh();
+    window.addEventListener("load", refresh);
+    lenis.resize();
+    ScrollTrigger.refresh();
+    const destroy = () => {
+        window.removeEventListener("resize", onResize);
+        window.removeEventListener("load", refresh);
+        gsap.ticker.remove(tick);
+        lenis.off("scroll", onScroll);
+        if (useScrollerProxy) {
+            ScrollTrigger.scrollerProxy(document.documentElement, {});
+            ScrollTrigger.defaults({ scroller: window });
+        }
+        lenis.destroy();
+    };
+    return {
+        lenis,
+        active: true,
+        scrollTo: (target, opts) => lenis.scrollTo(target, opts),
+        destroy,
+    };
+}
+//# sourceMappingURL=smooth-scroll.js.map

package/dist/core/smooth-scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smooth-scroll.js","sourceRoot":"","sources":["../../src/core/smooth-scroll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AA4BjD,MAAM,KAAK,GAAuB;IAChC,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;IAClB,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;CAClB,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,UAA+B,EAAE;IAC5D,QAAQ,EAAE,CAAC;IAEX,MAAM,EACJ,KAAK,GAAG,KAAK,EACb,IAAI,GAAG,IAAI,EACX,WAAW,GAAG,IAAI,EAClB,WAAW,GAAG,KAAK,EACnB,WAAW,GAAG,UAAU,EACxB,aAAa,GAAG,CAAC,EACjB,gBAAgB,GAAG,KAAK,GACzB,GAAG,OAAO,CAAC;IAEZ,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAEhD,iEAAiE;IACjE,IAAI,oBAAoB,EAAE,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEnD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACtB,IAAI;QACJ,WAAW;QACX,SAAS,EAAE,WAAW;QACtB,WAAW;QACX,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;IAEH,IAAI,aAAa;QAAE,KAAK,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtE,kDAAkD;IAClD,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;IAC9C,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE7B,gEAAgE;IAChE,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtB,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAE5B,kEAAkE;IAClE,IAAI,gBAAgB,EAAE,CAAC;QACrB,aAAa,CAAC,aAAa,CAAC,QAAQ,CAAC,eAAe,EAAE;YACpD,SAAS,CAAC,KAAc;gBACtB,IAAI,SAAS,CAAC,MAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAClD,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC3C,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,OAAO,KAAK,CAAC,MAAM,CAAC;YACtB,CAAC;YACD,qBAAqB,EAAE,GAAG,EAAE,CAAC,CAAC;gBAC5B,GAAG,EAAE,CAAC;gBACN,IAAI,EAAE,CAAC;gBACP,KAAK,EAAE,MAAM,CAAC,UAAU;gBACxB,MAAM,EAAE,MAAM,CAAC,WAAW;aAC3B,CAAC;YACF,qEAAqE;YACrE,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QACH,aAAa,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,KAAK,CAAC,MAAM,EAAE,CAAC;QACf,aAAa,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC,CAAC;IACF,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE5C,+DAA+D;IAC/D,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;IAC9C,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC,KAAK,CAAC,MAAM,EAAE,CAAC;IACf,aAAa,CAAC,OAAO,EAAE,CAAC;IAExB,MAAM,OAAO,GAAY,GAAG,EAAE;QAC5B,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/C,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9B,IAAI,gBAAgB,EAAE,CAAC;YACrB,aAAa,CAAC,aAAa,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAW,CAAC,CAAC;YACnE,aAAa,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO;QACL,KAAK;QACL,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAe,EAAE,IAAI,CAAC;QACjE,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/core/split.d.ts

@@ -0,0 +1,24 @@
+export type SplitType = "chars" | "words" | "lines";
+export interface SplitResult {
+    /** The elements that were produced (chars, words or lines). */
+    elements: HTMLElement[];
+    /** Undo the split and restore the original markup. */
+    revert: () => void;
+}
+export interface SplitOptions {
+    type: SplitType | Array<SplitType>;
+    /** Wrap each line in an overflow-hidden mask so it can slide up. */
+    mask?: boolean;
+    /** Class template for generated elements — `++` becomes the index. */
+    linesClass?: string;
+    wordsClass?: string;
+    charsClass?: string;
+    /** Ignore lines shorter than this fraction of the container. @default 0.05 */
+    lineThreshold?: number;
+}
+/**
+ * Split an element's text into chars/words/lines.
+ * Always returns a `revert()` that restores the original DOM.
+ */
+export declare function split(target: Element | string, options: SplitOptions): SplitResult;
+//# sourceMappingURL=split.d.ts.map

package/dist/core/split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../src/core/split.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,sDAAsD;IACtD,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;IACnC,oEAAoE;IACpE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,WAAW,CAuClF"}

package/dist/core/split.js

@@ -0,0 +1,117 @@
+/**
+ * Text splitting utilities.
+ *
+ * anim-kit prefers GSAP's SplitText when it is available (it ships with the
+ * free GSAP package), but keeps a dependency-free fallback so the library
+ * still works if SplitText is ever tree-shaken out or unavailable.
+ */
+import { gsap, SplitText, initGSAP } from "./gsap.js";
+/**
+ * Split an element's text into chars/words/lines.
+ * Always returns a `revert()` that restores the original DOM.
+ */
+export function split(target, options) {
+    initGSAP();
+    const el = typeof target === "string"
+        ? (document.querySelector(target) ?? null)
+        : target;
+    if (!el)
+        return { elements: [], revert: () => { } };
+    // Prefer SplitText: it handles nested markup, <br> and font metrics properly.
+    if (typeof SplitText !== "undefined" && SplitText?.create) {
+        try {
+            const st = SplitText.create(el, {
+                type: options.type,
+                mask: options.mask ? "lines" : undefined,
+                linesClass: options.linesClass ?? "ak-line++",
+                wordsClass: options.wordsClass ?? "ak-word++",
+                charsClass: options.charsClass ?? "ak-char++",
+                lineThreshold: options.lineThreshold ?? 0.05,
+            });
+            const elements = collect(st, options.type);
+            return {
+                elements,
+                revert: () => {
+                    try {
+                        st.revert();
+                    }
+                    catch {
+                        /* already reverted */
+                    }
+                },
+            };
+        }
+        catch {
+            /* fall through to the manual splitter */
+        }
+    }
+    return manualSplit(el, options);
+}
+function collect(st, type) {
+    const wanted = Array.isArray(type) ? type : [type];
+    const out = [];
+    if (wanted.includes("lines") && st.lines)
+        out.push(...st.lines);
+    else if (wanted.includes("words") && st.words)
+        out.push(...st.words);
+    else if (wanted.includes("chars") && st.chars)
+        out.push(...st.chars);
+    return out;
+}
+/* ------------------------------------------------------------------ */
+/* Fallback: char / word splitting only (line detection is best-effort) */
+/* ------------------------------------------------------------------ */
+function manualSplit(el, options) {
+    const original = el.innerHTML;
+    const type = Array.isArray(options.type) ? options.type[0] : options.type;
+    const nodes = Array.from(el.childNodes);
+    const generated = [];
+    const wrap = (text, cls, i) => {
+        const span = document.createElement("span");
+        span.className = cls.replace("++", String(i));
+        span.textContent = text;
+        generated.push(span);
+        return span;
+    };
+    const frag = document.createDocumentFragment();
+    let index = 0;
+    for (const node of nodes) {
+        if (node.nodeType === Node.TEXT_NODE) {
+            const text = node.textContent ?? "";
+            if (type === "chars") {
+                for (const ch of text) {
+                    frag.appendChild(ch === " "
+                        ? document.createTextNode(" ")
+                        : wrap(ch, options.charsClass ?? "ak-char++", index++));
+                }
+            }
+            else {
+                const parts = text.split(/(\s+)/);
+                for (const part of parts) {
+                    if (!part)
+                        continue;
+                    if (/^\s+$/.test(part))
+                        frag.appendChild(document.createTextNode(part));
+                    else
+                        frag.appendChild(wrap(part, options.wordsClass ?? "ak-word++", index++));
+                }
+            }
+        }
+        else if (node.nodeType === Node.ELEMENT_NODE) {
+            frag.appendChild(node.cloneNode(true));
+        }
+    }
+    el.innerHTML = "";
+    el.appendChild(frag);
+    if (options.mask) {
+        gsap.set(generated, { display: "inline-block" });
+    }
+    return {
+        elements: generated,
+        revert: () => {
+            el.innerHTML = original;
+            generated.length = 0;
+        },
+    };
+}
+//# sourceMappingURL=split.js.map

package/dist/core/split.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared types for anim-kit.
+ *
+ * Every effect in this library follows the same contract:
+ *   effect(target, options) => destroy
+ * so effects can be composed, torn down and re-created safely.
+ */
+/** Anything that can be resolved to a list of elements. */
+export type TargetLike = string | Element | Element[] | NodeListOf<Element> | null | undefined;
+/** Dispose function returned by every effect. */
+export type Destroy = () => void;
+export interface CommonOptions {
+    /**
+     * Run the effect even when the user has `prefers-reduced-motion: reduce`.
+     * @default false
+     */
+    force?: boolean;
+}
+/** The animation state an effect should snap to when motion is reduced. */
+export type ReducedState = Record<string, string | number>;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,OAAO,GACP,OAAO,EAAE,GACT,UAAU,CAAC,OAAO,CAAC,GACnB,IAAI,GACJ,SAAS,CAAC;AAEd,iDAAiD;AACjD,MAAM,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC;AAEjC,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC"}

package/dist/core/types.js

@@ -0,0 +1,9 @@
+/**
+ * Shared types for anim-kit.
+ *
+ * Every effect in this library follows the same contract:
+ *   effect(target, options) => destroy
+ * so effects can be composed, torn down and re-created safely.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/core/util.d.ts

@@ -0,0 +1,19 @@
+import type { Destroy, TargetLike } from "./types.js";
+/**
+ * Resolve a selector / element / list into a real array of elements.
+ *
+ * When `scope` is given, string targets are queried inside it — this is what
+ * lets effects take both `".card"` and `".card" within container`.
+ */
+export declare function toArray<T extends Element = HTMLElement>(target: TargetLike, scope?: ParentNode | null): T[];
+/** Resolve to a single element, or null. */
+export declare function one<T extends Element = HTMLElement>(target: TargetLike, scope?: ParentNode | null): T | null;
+/** Run `fn` once the DOM is ready (no-op if it is already interactive/complete). */
+export declare function onReady(fn: () => void): void;
+/** Compose several destroy functions into one. */
+export declare function compose(...fns: Array<Destroy | undefined | null>): Destroy;
+/** Schedule a callback on the next animation frame; returns a cancel fn. */
+export declare function raf(fn: () => void): () => void;
+/** Read the user's motion preference (safe outside the browser). */
+export declare function prefersReducedMotion(): boolean;
+//# sourceMappingURL=util.d.ts.map

package/dist/core/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/core/util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,OAAO,GAAG,WAAW,EACrD,MAAM,EAAE,UAAU,EAClB,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,GACxB,CAAC,EAAE,CAWL;AAED,4CAA4C;AAC5C,wBAAgB,GAAG,CAAC,CAAC,SAAS,OAAO,GAAG,WAAW,EACjD,MAAM,EAAE,UAAU,EAClB,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,GACxB,CAAC,GAAG,IAAI,CAEV;AAED,oFAAoF;AACpF,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAO5C;AAED,kDAAkD;AAClD,wBAAgB,OAAO,CAAC,GAAG,GAAG,EAAE,KAAK,CAAC,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,OAAO,CAU1E;AAED,4EAA4E;AAC5E,wBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAc9C;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,IAAI,OAAO,CAK9C"}

package/dist/core/util.js

@@ -0,0 +1,73 @@
+/**
+ * Resolve a selector / element / list into a real array of elements.
+ *
+ * When `scope` is given, string targets are queried inside it — this is what
+ * lets effects take both `".card"` and `".card" within container`.
+ */
+export function toArray(target, scope) {
+    if (!target)
+        return [];
+    if (typeof target === "string") {
+        const root = scope ?? document;
+        return Array.from(root.querySelectorAll(target));
+    }
+    if (target instanceof Element)
+        return [target];
+    if (target instanceof NodeList || Array.isArray(target)) {
+        return Array.from(target);
+    }
+    return [];
+}
+/** Resolve to a single element, or null. */
+export function one(target, scope) {
+    return toArray(target, scope)[0] ?? null;
+}
+/** Run `fn` once the DOM is ready (no-op if it is already interactive/complete). */
+export function onReady(fn) {
+    if (typeof document === "undefined")
+        return;
+    if (document.readyState === "loading") {
+        document.addEventListener("DOMContentLoaded", fn, { once: true });
+    }
+    else {
+        fn();
+    }
+}
+/** Compose several destroy functions into one. */
+export function compose(...fns) {
+    return () => {
+        for (let i = fns.length - 1; i >= 0; i--) {
+            try {
+                fns[i]?.();
+            }
+            catch {
+                /* destroying twice must never throw */
+            }
+        }
+    };
+}
+/** Schedule a callback on the next animation frame; returns a cancel fn. */
+export function raf(fn) {
+    let id = 0;
+    let pending = false;
+    const run = () => {
+        pending = false;
+        fn();
+    };
+    const schedule = () => {
+        if (pending)
+            return;
+        pending = true;
+        id = requestAnimationFrame(run);
+    };
+    schedule();
+    return () => cancelAnimationFrame(id);
+}
+/** Read the user's motion preference (safe outside the browser). */
+export function prefersReducedMotion() {
+    if (typeof window === "undefined" || typeof window.matchMedia !== "function") {
+        return false;
+    }
+    return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+//# sourceMappingURL=util.js.map

package/dist/core/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/core/util.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CACrB,MAAkB,EAClB,KAAyB;IAEzB,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAe,KAAK,IAAI,QAAQ,CAAC;QAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAI,MAAM,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,MAAM,YAAY,OAAO;QAAE,OAAO,CAAC,MAAW,CAAC,CAAC;IACpD,IAAI,MAAM,YAAY,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAQ,CAAC;IACnC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,GAAG,CACjB,MAAkB,EAClB,KAAyB;IAEzB,OAAO,OAAO,CAAI,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC9C,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,OAAO,CAAC,EAAc;IACpC,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO;IAC5C,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACtC,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,EAAE,EAAE,CAAC;IACP,CAAC;AACH,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,OAAO,CAAC,GAAG,GAAsC;IAC/D,OAAO,GAAG,EAAE;QACV,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC;gBACH,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACb,CAAC;YAAC,MAAM,CAAC;gBACP,uCAAuC;YACzC,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,GAAG,CAAC,EAAc;IAChC,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,OAAO,GAAG,KAAK,CAAC;QAChB,EAAE,EAAE,CAAC;IACP,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,EAAE,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC,CAAC;IACF,QAAQ,EAAE,CAAC;IACX,OAAO,GAAG,EAAE,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,oBAAoB;IAClC,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC7E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,CAAC;AACvE,CAAC"}