@cosmictraveler002/anim-kit 1.0.0

package/dist/effects/mask-reveal.js

@@ -0,0 +1,102 @@
+/**
+ * Mask reveal — the inline `overflow:hidden` + `y:100%` heading reveal.
+ *
+ * This is the studio's lighter alternative to `lineReveal`: you write
+ * `overflow-hidden` wrappers yourself and animate the inner spans.
+ *
+ *   <h1>
+ *     <span class="ak-mask"><span class="ak-mask__inner">Se</span></span>
+ *   </h1>
+ *
+ *   maskReveal("h1 .ak-mask__inner", { start: "top 90%" })
+ *
+ * On the site it runs at `duration:.5, ease:[.165,.84,.44,1]` (their `ak-reveal`)
+ * and the second line settles at `y:"-8%"` rather than 0 — configurable here.
+ */
+import { gsap, ScrollTrigger, initGSAP, EASES } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { toArray } from "../core/util.js";
+export function maskReveal(target, options = {}) {
+    initGSAP();
+    const els = toArray(target);
+    if (!els.length)
+        return () => { };
+    const { from = "100%", to = "0%", duration = 0.5, ease = EASES.reveal, stagger = 0.1, delay = 0, start = "top 90%", end = "bottom 10%", mode = "scroll", } = options;
+    return guard(options, run);
+    function run() {
+        // Group by parent so siblings stagger together rather than individually.
+        const groups = new Map();
+        els.forEach((el) => {
+            const parent = el.parentElement ?? el;
+            const list = groups.get(parent) ?? [];
+            list.push(el);
+            groups.set(parent, list);
+        });
+        const tweens = [];
+        gsap.set(els, { y: from });
+        groups.forEach((members) => {
+            const vars = {
+                y: to,
+                duration,
+                stagger,
+                delay,
+                ease,
+                overwrite: "auto",
+            };
+            if (mode === "scroll") {
+                vars.scrollTrigger = {
+                    trigger: members[0].parentElement ?? members[0],
+                    start,
+                    end,
+                    toggleActions: "play reverse play reverse",
+                };
+            }
+            tweens.push(gsap.to(members, vars));
+        });
+        ScrollTrigger.refresh();
+        return () => {
+            tweens.forEach((t) => {
+                t.scrollTrigger?.kill();
+                t.kill();
+            });
+            gsap.set(els, { clearProps: "transform" });
+            ScrollTrigger.refresh();
+        };
+    }
+}
+/**
+ * Rule reveal — the thin line that draws itself out to full width.
+ *
+ *   <div class="ak-rule"></div>
+ *   revealRule(".ak-rule")
+ *
+ * `initial:{width:0}` → `whileInView:{width:"100%"}`, duration 1s, same ease.
+ */
+export function revealRule(target, options = {}) {
+    initGSAP();
+    const els = toArray(target);
+    if (!els.length)
+        return () => { };
+    const { duration = 1, delay = 0, ease = EASES.reveal } = options;
+    return guard(options, () => {
+        gsap.set(els, { width: 0 });
+        const tween = gsap.to(els, {
+            width: "100%",
+            duration,
+            delay,
+            ease,
+            stagger: 0.1,
+            scrollTrigger: {
+                trigger: els[0],
+                start: "top 92%",
+                toggleActions: "play none none reverse",
+            },
+        });
+        return () => {
+            tween.scrollTrigger?.kill();
+            tween.kill();
+            gsap.set(els, { clearProps: "width" });
+        };
+    });
+}
+//# sourceMappingURL=mask-reveal.js.map

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

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

package/dist/effects/menu-overlay.d.ts

@@ -0,0 +1,32 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface MenuOverlayOptions extends CommonOptions {
+    /** The fixed full-screen panel. */
+    overlay: TargetLike;
+    /** Element that opens the menu (or a boolean-ish toggle target). */
+    openTrigger?: TargetLike;
+    /** Element that closes the menu. */
+    closeTrigger?: TargetLike;
+    /** Nav bar that slides away while the menu is open. */
+    nav?: TargetLike;
+    /** Selector for the menu links inside `overlay`. @default ".menu-link a" */
+    link?: string;
+    /** Elements in the overlay chrome that rise into view. @default "[data-menu-chrome]" */
+    chrome?: string;
+    /** Duration of the curtain, seconds. @default 1 */
+    duration?: number;
+    /** Stagger between links, seconds. @default 0.1 */
+    stagger?: number;
+    /** Start open. @default false */
+    initialOpen?: boolean;
+    onOpen?: () => void;
+    onClose?: () => void;
+}
+export interface MenuOverlayHandle {
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    isOpen: () => boolean;
+    destroy: Destroy;
+}
+export declare function menuOverlay(options: MenuOverlayOptions): MenuOverlayHandle;
+//# sourceMappingURL=menu-overlay.d.ts.map

package/dist/effects/menu-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-overlay.d.ts","sourceRoot":"","sources":["../../src/effects/menu-overlay.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,mCAAmC;IACnC,OAAO,EAAE,UAAU,CAAC;IACpB,oEAAoE;IACpE,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,oCAAoC;IACpC,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,uDAAuD;IACvD,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,wBAAgB,WAAW,CACzB,OAAO,EAAE,kBAAkB,GAC1B,iBAAiB,CAmKnB"}

package/dist/effects/menu-overlay.js

@@ -0,0 +1,150 @@
+/**
+ * Menu overlay — the full-screen curtain menu.
+ *
+ * The panel is a `position:fixed` layer whose `clip-path` polygon animates
+ * between collapsed-at-bottom and fully-open, using the studio's `ak-curtain`
+ * ease (`.76,0,.2,1`). Menu links slide in/out of their own masks with a
+ * stagger, and the nav logo + toggle lift out of the way first.
+ *
+ *   menuOverlay({ overlay: ".menu-overlay", open: ".menu-toggle-open", close: … })
+ *
+ * Requires the markup contract in styles/anim-kit.css (`.menu-overlay`,
+ * `.menu-link`, `.menu-overlay-bar`).
+ */
+import { gsap, ScrollTrigger, initGSAP, EASES } from "../core/gsap.js";
+import { one, toArray, prefersReducedMotion } from "../core/util.js";
+const COLLAPSED_BOTTOM = "polygon(0% 100%, 100% 100%, 100% 100%, 0% 100%)";
+const COLLAPSED_TOP = "polygon(0% 0%, 100% 0%, 100% 0%, 0% 0%)";
+const OPEN = "polygon(0% 0%, 100% 0%, 100% 100%, 0% 100%)";
+export function menuOverlay(options) {
+    initGSAP();
+    const { overlay: overlayTarget, openTrigger, closeTrigger, nav: navTarget, link = ".menu-link a", chrome = "[data-menu-chrome]", duration = 1, stagger = 0.1, initialOpen = false, onOpen, onClose, } = options;
+    const noop = { open: () => { }, close: () => { }, toggle: () => { }, isOpen: () => false, destroy: () => { } };
+    const overlay = one(overlayTarget);
+    if (!overlay)
+        return noop;
+    const nav = navTarget ? one(navTarget) : null;
+    const openBtns = toArray(openTrigger);
+    const closeBtns = toArray(closeTrigger);
+    const links = toArray(link, overlay);
+    const chromeEls = toArray(chrome, overlay);
+    // Reduced motion: leave the overlay collapsed and expose inert controls.
+    if (prefersReducedMotion() && !options.force) {
+        gsap.set(overlay, { clipPath: COLLAPSED_BOTTOM, pointerEvents: "none" });
+        return noop;
+    }
+    return setup();
+    function setup() {
+        let open = initialOpen;
+        const ease = EASES.curtain;
+        // Initial state: curtain collapsed at the bottom edge, links waiting below.
+        gsap.set(overlay, {
+            clipPath: COLLAPSED_BOTTOM,
+            pointerEvents: "none",
+        });
+        if (links.length)
+            gsap.set(links, { y: "100%" });
+        if (chromeEls.length)
+            gsap.set(chromeEls, { y: 20 });
+        const tweens = [];
+        const openMenu = () => {
+            if (open)
+                return;
+            open = true;
+            const tl = gsap.timeline({ onComplete: () => onOpen?.() });
+            // Curtain sweeps up to fill the viewport.
+            tl.to(overlay, {
+                clipPath: OPEN,
+                duration,
+                ease,
+                onStart: () => {
+                    gsap.set(overlay, { pointerEvents: "all" });
+                    if (nav)
+                        gsap.set(nav, { pointerEvents: "none" });
+                },
+            }, 0);
+            // Nav chrome lifts out of the way ahead of the curtain.
+            if (nav) {
+                const navBits = toArray("a, p", nav);
+                if (navBits.length) {
+                    gsap.set(navBits, { y: 0 });
+                    tl.to(navBits, { y: -20, duration, stagger, ease }, 0);
+                }
+            }
+            // Links slide up into place.
+            if (links.length) {
+                tl.fromTo(links, { y: "100%" }, { y: "0%", duration, stagger: stagger / 2, ease: "power3.out" }, duration * 0.5);
+            }
+            if (chromeEls.length) {
+                tl.to(chromeEls, { y: 0, duration, stagger, ease }, duration * 0.5);
+            }
+            tweens.push(tl);
+        };
+        const closeMenu = () => {
+            if (!open)
+                return;
+            open = false;
+            const tl = gsap.timeline({ onComplete: () => onClose?.() });
+            if (chromeEls.length) {
+                tl.to(chromeEls, { y: -20, duration: duration * 0.75, stagger: stagger / 2, ease }, 0);
+            }
+            if (links.length) {
+                tl.to(links, {
+                    y: "100%",
+                    duration: duration * 0.75,
+                    stagger: 0.05,
+                    ease: "power4.in",
+                }, 0);
+            }
+            tl.to(overlay, {
+                clipPath: COLLAPSED_TOP,
+                duration,
+                delay: 0.5,
+                ease,
+                onComplete: () => {
+                    gsap.set(overlay, { pointerEvents: "none" });
+                    if (nav)
+                        gsap.set(nav, { pointerEvents: "all" });
+                    // Reset for next open so the curtain always starts at the bottom.
+                    gsap.set(overlay, { clipPath: COLLAPSED_BOTTOM });
+                    if (links.length)
+                        gsap.set(links, { y: "100%" });
+                    if (chromeEls.length)
+                        gsap.set(chromeEls, { y: 20 });
+                },
+            }, 0);
+            if (nav) {
+                const navBits = toArray("a, p", nav);
+                if (navBits.length)
+                    tl.to(navBits, { y: 0, duration, stagger, ease }, duration * 0.5);
+            }
+            tweens.push(tl);
+        };
+        const toggle = () => (open ? closeMenu() : openMenu());
+        const listeners = [];
+        openBtns.forEach((el) => {
+            el.addEventListener("click", openMenu);
+            listeners.push([el, "click", openMenu]);
+        });
+        closeBtns.forEach((el) => {
+            el.addEventListener("click", closeMenu);
+            listeners.push([el, "click", closeMenu]);
+        });
+        if (initialOpen)
+            openMenu();
+        return {
+            open: openMenu,
+            close: closeMenu,
+            toggle,
+            isOpen: () => open,
+            destroy: () => {
+                listeners.forEach(([el, type, fn]) => el.removeEventListener(type, fn));
+                tweens.forEach((t) => t.kill());
+                gsap.set(overlay, { clearProps: "all" });
+                gsap.set([...links, ...chromeEls], { clearProps: "all" });
+                void ScrollTrigger;
+            },
+        };
+    }
+}
+//# sourceMappingURL=menu-overlay.js.map

package/dist/effects/menu-overlay.js.map

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

package/dist/effects/nav-hide.d.ts

@@ -0,0 +1,13 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface NavHideOptions extends CommonOptions {
+    /** Distance from the top under which the nav is hidden. @default 200 */
+    threshold?: number;
+    /** Hide offset in px. @default -100 */
+    hideY?: number;
+    /** Below this width the nav is pinned visible. @default 768 */
+    mobileBreakpoint?: number;
+    /** Start hidden. @default true */
+    startHidden?: boolean;
+}
+export declare function navHide(target: TargetLike, options?: NavHideOptions): Destroy;
+//# sourceMappingURL=nav-hide.d.ts.map

package/dist/effects/nav-hide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-hide.d.ts","sourceRoot":"","sources":["../../src/effects/nav-hide.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kCAAkC;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CA+DjF"}

package/dist/effects/nav-hide.js

@@ -0,0 +1,68 @@
+/**
+ * Hide-on-scroll nav — the header that slides away when you scroll down and
+ * snaps back when you scroll up.
+ *
+ * Their exact rules:
+ *   - within `threshold` px of the top  → hide (slow, 1s power2.out)
+ *   - scrolling down                     → hide (fast, 0.3s)
+ *   - scrolling up                       → show  (fast, 0.3s)
+ * On viewports under 768px the nav is always visible.
+ */
+import { gsap, initGSAP, killTweens } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { one } from "../core/util.js";
+export function navHide(target, options = {}) {
+    initGSAP();
+    const nav = one(target);
+    if (!nav)
+        return () => { };
+    const { threshold = 200, hideY = -100, mobileBreakpoint = 768, startHidden = true, } = options;
+    return guard(options, () => {
+        let last = window.scrollY;
+        let visible = !startHidden;
+        const isMobile = () => window.innerWidth < mobileBreakpoint;
+        const setHidden = (hidden, duration) => {
+            if (hidden === !visible)
+                return;
+            visible = !hidden;
+            gsap.to(nav, {
+                y: hidden ? hideY : 0,
+                duration,
+                ease: "power2.out",
+                overwrite: "auto",
+            });
+        };
+        // Initial placement — no animation, just the right resting state.
+        gsap.set(nav, { y: isMobile() || !startHidden ? 0 : hideY });
+        visible = !isMobile() && !startHidden ? true : startHidden ? false : true;
+        const onScroll = () => {
+            const y = window.scrollY;
+            if (isMobile()) {
+                setHidden(false, 0.3);
+            }
+            else if (y <= threshold) {
+                // Near the top: park the nav out of the way.
+                if (visible)
+                    setHidden(true, 1);
+            }
+            else if (y > last) {
+                setHidden(true, 0.3);
+            }
+            else if (y < last) {
+                setHidden(false, 0.3);
+            }
+            last = y;
+        };
+        window.addEventListener("scroll", onScroll, { passive: true });
+        onScroll();
+        return () => {
+            window.removeEventListener("scroll", onScroll);
+            // A destroy() must not leave new work behind: kill any in-flight slide
+            // and drop the transform we own instead of tweening back (the old code
+            // started a fresh 0.3s tween *from* destroy, which also survived it).
+            killTweens(nav);
+            gsap.set(nav, { clearProps: "transform" });
+        };
+    });
+}
+//# sourceMappingURL=nav-hide.js.map

package/dist/effects/nav-hide.js.map

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

package/dist/effects/parallax.d.ts

@@ -0,0 +1,11 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface ParallaxOptions extends CommonOptions {
+    /** Attribute holding the speed multiplier. @default "data-speed" */
+    attribute?: string;
+    /** Multiplier applied to the attribute value. @default 50 */
+    scale?: number;
+    start?: string;
+    end?: string;
+}
+export declare function parallax(target: TargetLike, options?: ParallaxOptions): Destroy;
+//# sourceMappingURL=parallax.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parallax.d.ts","sourceRoot":"","sources":["../../src/effects/parallax.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CA4CnF"}

package/dist/effects/parallax.js

@@ -0,0 +1,48 @@
+/**
+ * Parallax — the studio's `data-speed` utility.
+ *
+ *   <img data-speed="-0.4" />
+ *
+ * Each matching element is tweened `yPercent: 50 * speed` across
+ * `start:"50% bottom"` → `end:"bottom top"` with `scrub:true`, so negative
+ * speeds drift up and positive speeds lag down. Pure `ease:"none"`.
+ */
+import { gsap, ScrollTrigger, initGSAP } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { one } from "../core/util.js";
+export function parallax(target, options = {}) {
+    initGSAP();
+    const root = one(target);
+    if (!root)
+        return () => { };
+    const { attribute = "data-speed", scale = 50, start = "50% bottom", end = "bottom top", } = options;
+    return guard(options, () => {
+        const items = [];
+        root.querySelectorAll(`[${attribute}]`).forEach((el) => {
+            const raw = parseFloat(el.getAttribute(attribute) || "0");
+            if (Number.isNaN(raw))
+                return;
+            const speed = raw * scale;
+            const tw = gsap.to(el, {
+                yPercent: speed,
+                ease: "none",
+                scrollTrigger: { trigger: el, start, end, scrub: true },
+            });
+            items.push({ el, st: tw.scrollTrigger });
+            // Track tweens for cleanup via a WeakMap-free trick: kill through ST.
+            el.__akParallax = tw;
+        });
+        ScrollTrigger.refresh();
+        return () => {
+            items.forEach(({ el, st }) => {
+                st?.kill();
+                const tw = el.__akParallax;
+                tw?.kill();
+                delete el.__akParallax;
+                gsap.set(el, { clearProps: "transform" });
+            });
+            ScrollTrigger.refresh();
+        };
+    });
+}
+//# sourceMappingURL=parallax.js.map

package/dist/effects/parallax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallax.js","sourceRoot":"","sources":["../../src/effects/parallax.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;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;AAYtC,MAAM,UAAU,QAAQ,CAAC,MAAkB,EAAE,UAA2B,EAAE;IACxE,QAAQ,EAAE,CAAC;IAEX,MAAM,IAAI,GAAG,GAAG,CAAc,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAE3B,MAAM,EACJ,SAAS,GAAG,YAAY,EACxB,KAAK,GAAG,EAAE,EACV,KAAK,GAAG,YAAY,EACpB,GAAG,GAAG,YAAY,GACnB,GAAG,OAAO,CAAC;IAEZ,OAAO,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE;QACzB,MAAM,KAAK,GAAmD,EAAE,CAAC;QAEjE,IAAI,CAAC,gBAAgB,CAAc,IAAI,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;YAClE,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,CAAC;YAC1D,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;gBAAE,OAAO;YAC9B,MAAM,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC;YAE1B,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE;gBACrB,QAAQ,EAAE,KAAK;gBACf,IAAI,EAAE,MAAM;gBACZ,aAAa,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE;aACxD,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;YACzC,sEAAsE;YACrE,EAAyC,CAAC,YAAY,GAAG,EAAE,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,aAAa,CAAC,OAAO,EAAE,CAAC;QAExB,OAAO,GAAG,EAAE;YACV,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;gBAC3B,EAAE,EAAE,IAAI,EAAE,CAAC;gBACX,MAAM,EAAE,GAAI,EAAoD,CAAC,YAAY,CAAC;gBAC9E,EAAE,EAAE,IAAI,EAAE,CAAC;gBACX,OAAQ,EAAyC,CAAC,YAAY,CAAC;gBAC/D,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC;YACH,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/effects/preloader.d.ts

@@ -0,0 +1,33 @@
+import type { CommonOptions, Destroy, TargetLike } from "../core/types.js";
+export interface PreloaderOptions extends CommonOptions {
+    /** Root overlay element. */
+    root: string | HTMLElement;
+    /** The SVG glyph that fills up. Defaults to the first svg inside `root`. */
+    glyph?: string | HTMLElement;
+    /** Element receiving the 0→100 number. Defaults to first element with `[data-counter]`. */
+    counter?: string | HTMLElement;
+    /** Solid backdrop behind the glyph. Defaults to `[data-backdrop]`. */
+    backdrop?: string | HTMLElement;
+    /** Total counter duration in seconds. @default 4 */
+    duration?: number;
+    /** Counter increment per tick. @default 5 */
+    step?: number;
+    /** Interval between ticks in ms. @default 200 */
+    interval?: number;
+    /** Hide when already shown this session. @default true */
+    sessionGuard?: boolean;
+    /** sessionStorage key. @default "ak-preloader-shown" */
+    storageKey?: string;
+    /** Called once the overlay has finished and should be removed. */
+    onComplete?: () => void;
+}
+/**
+ * Intro preloader — 0→100 counter, glyph `inset()` fill, scale-out exit.
+ *
+ * Accepts the library's standard positional form **or** an options object:
+ *   preloader("#preloader", { duration: 4 })
+ *   preloader({ root: "#preloader", duration: 4 })
+ */
+export declare function preloader(options: PreloaderOptions): Destroy;
+export declare function preloader(target: TargetLike, options?: Partial<PreloaderOptions>): Destroy;
+//# sourceMappingURL=preloader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preloader.d.ts","sourceRoot":"","sources":["../../src/effects/preloader.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,4BAA4B;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7B,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAChC,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC;AAC9D,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC"}

package/dist/effects/preloader.js

@@ -0,0 +1,128 @@
+/**
+ * Preloader — the full-screen intro from dzinrstudio.com.
+ *
+ * What it does on the real site:
+ *   1. A big number counts 0 → 100 in the bottom-left corner (steps of 5,
+ *      every 200ms — i.e. a 4s counter), sliding in from x:-100px.
+ *   2. An SVG "!" glyph is revealed bottom-up via `clip-path: inset(N% 0 0 0)`
+ *      driven by the same progress.
+ *   3. When the count hits 100 the glyph scales to 35x and fades out with the
+ *      `ak-preload-out` ease (delay 5s), then the backdrop fades (delay 5.5s).
+ *   4. The whole overlay unmounts ~1s later. A `sessionStorage` flag skips the
+ *      preloader on subsequent visits within the session.
+ */
+import { gsap, initGSAP, EASES, killTweens } from "../core/gsap.js";
+import { guard } from "../core/guard.js";
+import { one, prefersReducedMotion } from "../core/util.js";
+export function preloader(targetOrOptions, maybeOptions = {}) {
+    initGSAP();
+    const options = isTargetArg(targetOrOptions)
+        ? { ...maybeOptions, root: (targetOrOptions ?? maybeOptions.root) }
+        : targetOrOptions;
+    const { duration = 4, step = 5, interval = 200, sessionGuard = true, storageKey = "ak-preloader-shown", onComplete, } = options;
+    const root = one(options.root);
+    if (!root)
+        return () => { };
+    const overlay = root;
+    const glyph = options.glyph ? one(options.glyph) : root.querySelector("svg");
+    const counterEl = options.counter
+        ? one(options.counter)
+        : root.querySelector("[data-counter]");
+    const backdrop = options.backdrop
+        ? one(options.backdrop)
+        : root.querySelector("[data-backdrop]");
+    if (sessionGuard && sessionStorage.getItem(storageKey)) {
+        overlay.style.display = "none";
+        onComplete?.();
+        return () => { };
+    }
+    // Reduced motion: never block the page behind a counting intro.
+    if (prefersReducedMotion() && !options.force) {
+        overlay.style.display = "none";
+        onComplete?.();
+        return () => { };
+    }
+    return guard(options, () => run());
+    function run() {
+        const timers = [];
+        let value = 0;
+        let done = false;
+        // Entrance: number slides in from the left.
+        if (counterEl) {
+            gsap.fromTo(counterEl, { opacity: 0, x: -100 }, { opacity: 1, x: 0, duration: 0.5, ease: "power2.out" });
+        }
+        // Glyph fills bottom → top, tied to the counter.
+        if (glyph) {
+            gsap.set(glyph, { clipPath: "inset(100% 0px 0px 0px)" });
+            gsap.to(glyph, {
+                clipPath: "inset(0% 0px 0px 0px)",
+                duration,
+                ease: "power1.inOut",
+            });
+        }
+        const tick = () => {
+            value = Math.min(100, value + step);
+            if (counterEl)
+                counterEl.textContent = String(value);
+            if (value >= 100) {
+                finish();
+                return;
+            }
+            timers.push(window.setTimeout(tick, interval));
+        };
+        timers.push(window.setTimeout(tick, interval));
+        function finish() {
+            if (done)
+                return;
+            done = true;
+            const tl = gsap.timeline({
+                onComplete: () => {
+                    sessionStorage.setItem(storageKey, "true");
+                    overlay.style.display = "none";
+                    onComplete?.();
+                },
+            });
+            // Glyph blows up and dissolves…
+            if (glyph) {
+                tl.to(glyph, {
+                    scale: 35,
+                    opacity: 0,
+                    duration: 0.6,
+                    ease: EASES.preloadOut,
+                    transformOrigin: "center 50%",
+                }, 1);
+            }
+            // …the number exits, …
+            if (counterEl) {
+                tl.to(counterEl, { opacity: 0, x: -40, duration: 0.35, ease: "power2.in" }, 1.15);
+            }
+            // …then the backdrop fades to reveal the page.
+            if (backdrop) {
+                tl.to(backdrop, { opacity: 0, duration: 0.5, ease: "power2.out" }, 1.5);
+            }
+            else {
+                tl.to(root, { opacity: 0, duration: 0.5 }, 1.5);
+            }
+            tl.set(root, { pointerEvents: "none" }, 1.6);
+            tl.call(() => onComplete?.(), undefined, ">-0.1");
+        }
+        return () => {
+            timers.forEach(clearTimeout);
+            killTweens([root, glyph, counterEl, backdrop]);
+        };
+    }
+}
+/** Distinguish a positional DOM target from an options object. */
+function isTargetArg(v) {
+    if (typeof v === "string" || v == null)
+        return true;
+    if (typeof v !== "object")
+        return false;
+    if (Array.isArray(v))
+        return true;
+    const rec = v;
+    if ("nodeType" in rec)
+        return true; // Element / Node
+    return typeof rec.length === "number" && "item" in rec; // NodeList
+}
+//# sourceMappingURL=preloader.js.map

package/dist/effects/preloader.js.map

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