@mappoh/nova 0.1.16

package/dist/animation/parallax.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Nova Engine — Parallax
+ *
+ * Scroll-linked transform effects. Elements move at different speeds
+ * relative to scroll position, creating depth.
+ */
+interface ParallaxOptions {
+    /** Speed multiplier: 0.5 = half scroll speed, -0.5 = opposite direction. Default: 0.5 */
+    speed?: number;
+    /** Axis of movement. Default: 'y' */
+    direction?: 'x' | 'y';
+    /** Only animate when element is in viewport. Default: true */
+    inViewOnly?: boolean;
+}
+/**
+ * Apply parallax effect to elements matching a selector.
+ * Returns a cleanup function.
+ */
+export declare function parallax(selector: string | HTMLElement | HTMLElement[], options?: ParallaxOptions): () => void;
+/** Remove all parallax effects */
+export declare function destroyParallax(): void;
+export {};
+//# sourceMappingURL=parallax.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parallax.d.ts","sourceRoot":"","sources":["../../src/animation/parallax.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,UAAU,eAAe;IACvB,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IACtB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA0DD;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,EAAE,EAC9C,OAAO,GAAE,eAAoB,GAC5B,MAAM,IAAI,CAiCZ;AAED,kCAAkC;AAClC,wBAAgB,eAAe,IAAI,IAAI,CAStC"}

package/dist/animation/parallax.js

@@ -0,0 +1,96 @@
+/**
+ * Nova Engine — Parallax
+ *
+ * Scroll-linked transform effects. Elements move at different speeds
+ * relative to scroll position, creating depth.
+ */
+import { ticker } from './ticker';
+const items = [];
+let observer = null;
+let active = false;
+function ensureObserver() {
+    if (!observer) {
+        observer = new IntersectionObserver((entries) => {
+            for (const entry of entries) {
+                const item = items.find((i) => i.element === entry.target);
+                if (item)
+                    item.inView = entry.isIntersecting;
+            }
+        }, { rootMargin: '100px' });
+    }
+    return observer;
+}
+function update() {
+    for (const item of items) {
+        if (item.inViewOnly && !item.inView)
+            continue;
+        const rect = item.element.getBoundingClientRect();
+        const elementCenter = rect.top + rect.height / 2;
+        const viewportCenter = window.innerHeight / 2;
+        const offset = (elementCenter - viewportCenter) * item.speed;
+        if (item.direction === 'y') {
+            item.element.style.transform = `translate3d(0, ${offset}px, 0)`;
+        }
+        else {
+            item.element.style.transform = `translate3d(${offset}px, 0, 0)`;
+        }
+    }
+}
+function startTicker() {
+    if (active)
+        return;
+    active = true;
+    ticker.add('nova-parallax', () => update());
+}
+function stopTicker() {
+    if (!active)
+        return;
+    active = false;
+    ticker.remove('nova-parallax');
+}
+/**
+ * Apply parallax effect to elements matching a selector.
+ * Returns a cleanup function.
+ */
+export function parallax(selector, options = {}) {
+    const { speed = 0.5, direction = 'y', inViewOnly = true } = options;
+    const targets = typeof selector === 'string'
+        ? Array.from(document.querySelectorAll(selector))
+        : selector instanceof HTMLElement
+            ? [selector]
+            : selector;
+    const obs = inViewOnly ? ensureObserver() : null;
+    const newItems = [];
+    for (const el of targets) {
+        el.style.willChange = 'transform';
+        const item = { element: el, speed, direction, inViewOnly, inView: !inViewOnly };
+        items.push(item);
+        newItems.push(item);
+        obs?.observe(el);
+    }
+    startTicker();
+    return () => {
+        for (const item of newItems) {
+            const idx = items.indexOf(item);
+            if (idx !== -1)
+                items.splice(idx, 1);
+            item.element.style.willChange = '';
+            item.element.style.transform = '';
+            obs?.unobserve(item.element);
+        }
+        if (items.length === 0)
+            stopTicker();
+    };
+}
+/** Remove all parallax effects */
+export function destroyParallax() {
+    for (const item of items) {
+        item.element.style.willChange = '';
+        item.element.style.transform = '';
+    }
+    items.length = 0;
+    observer?.disconnect();
+    observer = null;
+    stopTicker();
+}
+//# sourceMappingURL=parallax.js.map

package/dist/animation/parallax.js.map

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

package/dist/animation/scroll-animate.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Nova Engine — CSS Scroll-Driven Animations
+ *
+ * Uses native CSS `animation-timeline: view()` when supported,
+ * falls back to IntersectionObserver + class toggle.
+ */
+export interface ScrollAnimateOptions {
+    /** CSS @keyframes animation name (must be defined in your stylesheet) */
+    animation: string;
+    /** Scroll timeline range. Default: 'entry 0% entry 100%' */
+    range?: string;
+    /** Animation fill mode. Default: 'forwards' */
+    fill?: string;
+    /** Fallback class added when element enters viewport. Default: 'is-visible' */
+    fallbackClass?: string;
+    /** IntersectionObserver root margin for fallback. Default: '0px 0px -10% 0px' */
+    rootMargin?: string;
+}
+/**
+ * Apply scroll-driven animations to elements.
+ * Uses native CSS scroll-driven animations if supported, falls back to IntersectionObserver.
+ *
+ * @returns Cleanup function that removes animations/observers.
+ *
+ * @example
+ * // In your CSS: @keyframes fade-in { from { opacity: 0 } to { opacity: 1 } }
+ * const cleanup = scrollAnimate('.reveal', { animation: 'fade-in' });
+ */
+export declare function scrollAnimate(target: string | Element | Element[], options: ScrollAnimateOptions): () => void;
+//# sourceMappingURL=scroll-animate.d.ts.map

package/dist/animation/scroll-animate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-animate.d.ts","sourceRoot":"","sources":["../../src/animation/scroll-animate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAUD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,EACpC,OAAO,EAAE,oBAAoB,GAC5B,MAAM,IAAI,CAgDZ"}

package/dist/animation/scroll-animate.js

@@ -0,0 +1,65 @@
+/**
+ * Nova Engine — CSS Scroll-Driven Animations
+ *
+ * Uses native CSS `animation-timeline: view()` when supported,
+ * falls back to IntersectionObserver + class toggle.
+ */
+function resolveElements(target) {
+    if (typeof target === 'string') {
+        return Array.from(document.querySelectorAll(target));
+    }
+    if (Array.isArray(target))
+        return target;
+    return [target];
+}
+/**
+ * Apply scroll-driven animations to elements.
+ * Uses native CSS scroll-driven animations if supported, falls back to IntersectionObserver.
+ *
+ * @returns Cleanup function that removes animations/observers.
+ *
+ * @example
+ * // In your CSS: @keyframes fade-in { from { opacity: 0 } to { opacity: 1 } }
+ * const cleanup = scrollAnimate('.reveal', { animation: 'fade-in' });
+ */
+export function scrollAnimate(target, options) {
+    const elements = resolveElements(target);
+    if (elements.length === 0)
+        return () => { };
+    const supportsScrollTimeline = CSS.supports('animation-timeline', 'view()');
+    if (supportsScrollTimeline) {
+        const range = options.range ?? 'entry 0% entry 100%';
+        const fill = options.fill ?? 'forwards';
+        for (const el of elements) {
+            const s = el.style;
+            s.animationName = options.animation;
+            s.setProperty('animation-timeline', 'view()');
+            s.setProperty('animation-range', range);
+            s.animationFillMode = fill;
+        }
+        return () => {
+            for (const el of elements) {
+                const s = el.style;
+                s.animationName = '';
+                s.removeProperty('animation-timeline');
+                s.removeProperty('animation-range');
+                s.animationFillMode = '';
+            }
+        };
+    }
+    // Fallback: IntersectionObserver with class toggle
+    const className = options.fallbackClass ?? 'is-visible';
+    const rootMargin = options.rootMargin ?? '0px 0px -10% 0px';
+    const observer = new IntersectionObserver((entries) => {
+        for (const entry of entries) {
+            if (entry.isIntersecting) {
+                entry.target.classList.add(className);
+                observer.unobserve(entry.target);
+            }
+        }
+    }, { rootMargin });
+    for (const el of elements)
+        observer.observe(el);
+    return () => observer.disconnect();
+}
+//# sourceMappingURL=scroll-animate.js.map

package/dist/animation/scroll-animate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-animate.js","sourceRoot":"","sources":["../../src/animation/scroll-animate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,SAAS,eAAe,CAAC,MAAoC;IAC3D,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACzC,OAAO,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAoC,EACpC,OAA6B;IAE7B,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAE3C,MAAM,sBAAsB,GAAG,GAAG,CAAC,QAAQ,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IAE5E,IAAI,sBAAsB,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,qBAAqB,CAAC;QACrD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC;QAExC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAI,EAAkB,CAAC,KAAK,CAAC;YACpC,CAAC,CAAC,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;YACpC,CAAC,CAAC,WAAW,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;YAC9C,CAAC,CAAC,WAAW,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;YACxC,CAAC,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC7B,CAAC;QAED,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1B,MAAM,CAAC,GAAI,EAAkB,CAAC,KAAK,CAAC;gBACpC,CAAC,CAAC,aAAa,GAAG,EAAE,CAAC;gBACrB,CAAC,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;gBACvC,CAAC,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;gBACpC,CAAC,CAAC,iBAAiB,GAAG,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,mDAAmD;IACnD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,IAAI,YAAY,CAAC;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,CAAC;IAE5D,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CACvC,CAAC,OAAO,EAAE,EAAE;QACV,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;gBACzB,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACtC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC,EACD,EAAE,UAAU,EAAE,CACf,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,QAAQ;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEhD,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;AACrC,CAAC"}

package/dist/animation/scroll-observer.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Nova Engine — Scroll Observer
+ *
+ * IntersectionObserver wrapper for scroll-triggered animations.
+ * Elements animate in as they enter the viewport.
+ */
+interface ObserveOptions {
+    /** Visibility threshold to trigger (0-1). Default: 0.15 */
+    threshold?: number;
+    /** Root margin for early/late trigger. Default: '0px' */
+    rootMargin?: string;
+    /** Callback when element enters viewport */
+    onEnter?: (el: Element) => void;
+    /** Callback when element leaves viewport */
+    onLeave?: (el: Element) => void;
+    /** Only trigger once (default: true) */
+    once?: boolean;
+}
+/**
+ * Observe elements matching a selector for scroll-triggered animations.
+ * Returns an unsubscribe function.
+ */
+export declare function observe(selector: string | Element | Element[], options?: ObserveOptions): () => void;
+/**
+ * Observe elements within a Shadow DOM root.
+ * Useful for components that need scroll animations internally.
+ */
+export declare function observeIn(root: ShadowRoot | HTMLElement, selector: string, options?: ObserveOptions): () => void;
+/** Disconnect all observers */
+export declare function disconnectAll(): void;
+export {};
+//# sourceMappingURL=scroll-observer.d.ts.map

package/dist/animation/scroll-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-observer.d.ts","sourceRoot":"","sources":["../../src/animation/scroll-observer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,UAAU,cAAc;IACtB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAC;IAChC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAC;IAChC,wCAAwC;IACxC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAUD;;;GAGG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,EACtC,OAAO,GAAE,cAAmB,GAC3B,MAAM,IAAI,CAiDZ;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,UAAU,GAAG,WAAW,EAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,cAAmB,GAC3B,MAAM,IAAI,CAGZ;AAED,+BAA+B;AAC/B,wBAAgB,aAAa,IAAI,IAAI,CAKpC"}

package/dist/animation/scroll-observer.js

@@ -0,0 +1,63 @@
+/**
+ * Nova Engine — Scroll Observer
+ *
+ * IntersectionObserver wrapper for scroll-triggered animations.
+ * Elements animate in as they enter the viewport.
+ */
+const observers = new Map();
+let idCounter = 0;
+/**
+ * Observe elements matching a selector for scroll-triggered animations.
+ * Returns an unsubscribe function.
+ */
+export function observe(selector, options = {}) {
+    const { threshold = 0.15, rootMargin = '0px', onEnter = (el) => el.classList.add('is-visible'), onLeave, once = true, } = options;
+    const id = `nova-scroll-${++idCounter}`;
+    const elements = new Set();
+    const observer = new IntersectionObserver((entries) => {
+        for (const entry of entries) {
+            if (entry.isIntersecting) {
+                onEnter(entry.target);
+                if (once) {
+                    observer.unobserve(entry.target);
+                    elements.delete(entry.target);
+                }
+            }
+            else if (onLeave) {
+                onLeave(entry.target);
+            }
+        }
+    }, { threshold, rootMargin });
+    // Resolve elements
+    const targets = typeof selector === 'string'
+        ? document.querySelectorAll(selector)
+        : selector instanceof Element
+            ? [selector]
+            : selector;
+    for (const el of targets) {
+        observer.observe(el);
+        elements.add(el);
+    }
+    observers.set(id, { observer, elements });
+    // Return cleanup function
+    return () => {
+        observer.disconnect();
+        observers.delete(id);
+    };
+}
+/**
+ * Observe elements within a Shadow DOM root.
+ * Useful for components that need scroll animations internally.
+ */
+export function observeIn(root, selector, options = {}) {
+    const elements = Array.from(root.querySelectorAll(selector));
+    return observe(elements, options);
+}
+/** Disconnect all observers */
+export function disconnectAll() {
+    for (const { observer } of observers.values()) {
+        observer.disconnect();
+    }
+    observers.clear();
+}
+//# sourceMappingURL=scroll-observer.js.map

package/dist/animation/scroll-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-observer.js","sourceRoot":"","sources":["../../src/animation/scroll-observer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;AACrD,IAAI,SAAS,GAAG,CAAC,CAAC;AAElB;;;GAGG;AACH,MAAM,UAAU,OAAO,CACrB,QAAsC,EACtC,UAA0B,EAAE;IAE5B,MAAM,EACJ,SAAS,GAAG,IAAI,EAChB,UAAU,GAAG,KAAK,EAClB,OAAO,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,EAChD,OAAO,EACP,IAAI,GAAG,IAAI,GACZ,GAAG,OAAO,CAAC;IAEZ,MAAM,EAAE,GAAG,eAAe,EAAE,SAAS,EAAE,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAW,CAAC;IAEpC,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CACvC,CAAC,OAAO,EAAE,EAAE;QACV,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACtB,IAAI,IAAI,EAAE,CAAC;oBACT,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;oBACjC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;iBAAM,IAAI,OAAO,EAAE,CAAC;gBACnB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC,EACD,EAAE,SAAS,EAAE,UAAU,EAAE,CAC1B,CAAC;IAEF,mBAAmB;IACnB,MAAM,OAAO,GACX,OAAO,QAAQ,KAAK,QAAQ;QAC1B,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC;QACrC,CAAC,CAAC,QAAQ,YAAY,OAAO;YAC3B,CAAC,CAAC,CAAC,QAAQ,CAAC;YACZ,CAAC,CAAC,QAAQ,CAAC;IAEjB,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE1C,0BAA0B;IAC1B,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,UAAU,EAAE,CAAC;QACtB,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,IAA8B,EAC9B,QAAgB,EAChB,UAA0B,EAAE;IAE5B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,OAAO,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,aAAa;IAC3B,KAAK,MAAM,EAAE,QAAQ,EAAE,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9C,QAAQ,CAAC,UAAU,EAAE,CAAC;IACxB,CAAC;IACD,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,47 @@
+/**
+ * Nova Engine — Smooth Scroll
+ *
+ * Lerp-based smooth scrolling that overrides native scroll behavior.
+ * Creates the buttery feel seen on proto.xyz.
+ */
+interface SmoothScrollOptions {
+    /** Lerp factor: 0.05 = very smooth, 0.15 = snappy. Default: 0.08 */
+    lerp?: number;
+    /** Scroll container. Default: window/documentElement */
+    wrapper?: HTMLElement;
+    /** Enable/disable on touch devices. Default: false (disabled) */
+    touchEnabled?: boolean;
+}
+declare class NovaSmoothScroll {
+    private lerp;
+    private wrapper;
+    private targetScroll;
+    private currentScroll;
+    private active;
+    private isTouch;
+    private touchEnabled;
+    private _origScrollTo;
+    constructor(options?: SmoothScrollOptions);
+    /** Initialize smooth scrolling */
+    init(): void;
+    /** Destroy smooth scrolling */
+    destroy(): void;
+    /** Scroll to a specific position */
+    scrollTo(target: number, immediate?: boolean): void;
+    /** Get current interpolated scroll position */
+    get scroll(): number;
+    /** Get the target scroll position */
+    get target(): number;
+    /** Check if currently scrolling (lerp hasn't settled) */
+    get isScrolling(): boolean;
+    private getScroll;
+    private getMaxScroll;
+    private applyScroll;
+    private update;
+    private onWheel;
+    private onKeyDown;
+}
+export declare function createSmoothScroll(options?: SmoothScrollOptions): NovaSmoothScroll;
+export declare function useSmoothScroll(): NovaSmoothScroll;
+export {};
+//# sourceMappingURL=smooth-scroll.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"smooth-scroll.d.ts","sourceRoot":"","sources":["../../src/animation/smooth-scroll.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,UAAU,mBAAmB;IAC3B,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,iEAAiE;IACjE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,cAAM,gBAAgB;IACpB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,aAAa,CAA+C;gBAExD,OAAO,GAAE,mBAAwB;IAO7C,kCAAkC;IAClC,IAAI,IAAI,IAAI;IAwCZ,+BAA+B;IAC/B,OAAO,IAAI,IAAI;IAgBf,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,IAAI;IAQjD,+CAA+C;IAC/C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,qCAAqC;IACrC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,yDAAyD;IACzD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAID,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,OAAO,CAIb;IAEF,OAAO,CAAC,SAAS,CAyBf;CACH;AAID,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,gBAAgB,CAIlF;AAED,wBAAgB,eAAe,IAAI,gBAAgB,CAGlD"}

package/dist/animation/smooth-scroll.js

@@ -0,0 +1,169 @@
+/**
+ * Nova Engine — Smooth Scroll
+ *
+ * Lerp-based smooth scrolling that overrides native scroll behavior.
+ * Creates the buttery feel seen on proto.xyz.
+ */
+import { ticker } from './ticker';
+class NovaSmoothScroll {
+    lerp;
+    wrapper;
+    targetScroll = 0;
+    currentScroll = 0;
+    active = false;
+    isTouch = false;
+    touchEnabled;
+    _origScrollTo = null;
+    constructor(options = {}) {
+        this.lerp = options.lerp ?? 0.08;
+        this.wrapper = options.wrapper ?? null;
+        this.touchEnabled = options.touchEnabled ?? false;
+        this.isTouch = 'ontouchstart' in window;
+    }
+    /** Initialize smooth scrolling */
+    init() {
+        if (this.active)
+            return;
+        if (this.isTouch && !this.touchEnabled)
+            return;
+        this.active = true;
+        this.currentScroll = this.getScroll();
+        this.targetScroll = this.currentScroll;
+        // Intercept wheel events
+        window.addEventListener('wheel', this.onWheel, { passive: false });
+        // Listen for keyboard scroll
+        window.addEventListener('keydown', this.onKeyDown);
+        // Override window.scrollTo so programmatic calls (router, scroll
+        // restoration) sync with our internal state instead of fighting it.
+        if (!this.wrapper) {
+            this._origScrollTo = window.scrollTo.bind(window);
+            const self = this;
+            window.scrollTo = function (...args) {
+                let y = 0;
+                if (typeof args[0] === 'number') {
+                    // scrollTo(x, y)
+                    y = args[1] ?? 0;
+                }
+                else if (args[0] && typeof args[0] === 'object') {
+                    // scrollTo({ top, behavior })
+                    const opts = args[0];
+                    y = opts.top ?? 0;
+                }
+                self.scrollTo(y, true);
+            };
+        }
+        // Start the tick loop
+        ticker.add('nova-smooth-scroll', (delta) => this.update(delta));
+        // Apply styles to prevent native smooth behavior
+        document.documentElement.style.scrollBehavior = 'auto';
+    }
+    /** Destroy smooth scrolling */
+    destroy() {
+        if (!this.active)
+            return;
+        this.active = false;
+        window.removeEventListener('wheel', this.onWheel);
+        window.removeEventListener('keydown', this.onKeyDown);
+        ticker.remove('nova-smooth-scroll');
+        document.documentElement.style.scrollBehavior = '';
+        // Restore original window.scrollTo
+        if (this._origScrollTo) {
+            window.scrollTo = this._origScrollTo;
+            this._origScrollTo = null;
+        }
+    }
+    /** Scroll to a specific position */
+    scrollTo(target, immediate = false) {
+        this.targetScroll = Math.max(0, Math.min(target, this.getMaxScroll()));
+        if (immediate) {
+            this.currentScroll = this.targetScroll;
+            this.applyScroll();
+        }
+    }
+    /** Get current interpolated scroll position */
+    get scroll() {
+        return this.currentScroll;
+    }
+    /** Get the target scroll position */
+    get target() {
+        return this.targetScroll;
+    }
+    /** Check if currently scrolling (lerp hasn't settled) */
+    get isScrolling() {
+        return Math.abs(this.targetScroll - this.currentScroll) > 0.5;
+    }
+    // --- Internal ---
+    getScroll() {
+        return this.wrapper ? this.wrapper.scrollTop : window.scrollY;
+    }
+    getMaxScroll() {
+        if (this.wrapper) {
+            return this.wrapper.scrollHeight - this.wrapper.clientHeight;
+        }
+        return document.documentElement.scrollHeight - window.innerHeight;
+    }
+    applyScroll() {
+        if (this.wrapper) {
+            this.wrapper.scrollTop = this.currentScroll;
+        }
+        else if (this._origScrollTo) {
+            this._origScrollTo(0, this.currentScroll);
+        }
+        else {
+            window.scrollTo(0, this.currentScroll);
+        }
+    }
+    update(_delta) {
+        const diff = this.targetScroll - this.currentScroll;
+        // Stop updating if close enough (sub-pixel)
+        if (Math.abs(diff) < 0.5) {
+            this.currentScroll = this.targetScroll;
+            return;
+        }
+        this.currentScroll += diff * this.lerp;
+        this.applyScroll();
+    }
+    onWheel = (e) => {
+        e.preventDefault();
+        this.targetScroll += e.deltaY;
+        this.targetScroll = Math.max(0, Math.min(this.targetScroll, this.getMaxScroll()));
+    };
+    onKeyDown = (e) => {
+        const scrollAmount = 100;
+        switch (e.key) {
+            case 'ArrowDown':
+                this.targetScroll += scrollAmount;
+                break;
+            case 'ArrowUp':
+                this.targetScroll -= scrollAmount;
+                break;
+            case 'PageDown':
+                this.targetScroll += window.innerHeight;
+                break;
+            case 'PageUp':
+                this.targetScroll -= window.innerHeight;
+                break;
+            case 'Home':
+                this.targetScroll = 0;
+                break;
+            case 'End':
+                this.targetScroll = this.getMaxScroll();
+                break;
+            default:
+                return;
+        }
+        this.targetScroll = Math.max(0, Math.min(this.targetScroll, this.getMaxScroll()));
+    };
+}
+let instance = null;
+export function createSmoothScroll(options) {
+    instance = new NovaSmoothScroll(options);
+    instance.init();
+    return instance;
+}
+export function useSmoothScroll() {
+    if (!instance)
+        throw new Error('[Nova] Smooth scroll not initialized.');
+    return instance;
+}
+//# sourceMappingURL=smooth-scroll.js.map

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

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

package/dist/animation/text-reveal.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Nova Engine — Text Reveal
+ *
+ * Scroll-triggered staggered text entrance — words or lines
+ * slide up one by one as the element enters the viewport.
+ */
+export interface TextRevealOptions {
+    /** Split mode: reveal per word or per line. Default: 'word' */
+    split?: 'word' | 'line';
+    /** Delay between each unit in ms. Default: 50 */
+    stagger?: number;
+    /** Y offset in px units start from. Default: 20 */
+    distance?: number;
+    /** Duration per unit in ms. Default: 600 */
+    duration?: number;
+    /** CSS easing function. Default: 'cubic-bezier(0.16, 1, 0.3, 1)' */
+    easing?: string;
+    /** IntersectionObserver threshold (0-1). Default: 0.15 */
+    threshold?: number;
+    /** IntersectionObserver rootMargin. Default: '0px' */
+    rootMargin?: string;
+    /** Only animate once. Default: true */
+    once?: boolean;
+}
+/**
+ * Apply scroll-triggered staggered text reveal to elements.
+ * Returns a cleanup function that restores original DOM.
+ */
+export declare function textReveal(selector: string | Element | Element[], options?: TextRevealOptions): () => void;
+//# sourceMappingURL=text-reveal.d.ts.map

package/dist/animation/text-reveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-reveal.d.ts","sourceRoot":"","sources":["../../src/animation/text-reveal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA8HD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,EACtC,OAAO,GAAE,iBAAsB,GAC9B,MAAM,IAAI,CAyDZ"}