@mappoh/nova 0.1.16

package/dist/image/image.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Nova Engine — Image Optimization
+ *
+ * Responsive `<picture>` generation, blur-up placeholders (LQIP/BlurHash),
+ * format detection (WebP/AVIF), and progressive loading.
+ */
+export interface ImageSource {
+    /** Image URL */
+    src: string;
+    /** Width of this source variant in pixels */
+    width?: number;
+    /** Image format (auto-detected from extension if omitted) */
+    format?: 'webp' | 'avif' | 'jpeg' | 'png' | 'gif' | 'svg';
+    /** Media query for this source */
+    media?: string;
+}
+export interface ImageOptions {
+    /** Primary image source URL */
+    src: string;
+    /** Alt text (required for accessibility) */
+    alt: string;
+    /** Responsive source variants */
+    sources?: ImageSource[];
+    /** Width attribute */
+    width?: number;
+    /** Height attribute */
+    height?: number;
+    /** Loading strategy. Default: 'lazy' */
+    loading?: 'lazy' | 'eager';
+    /** Decoding hint. Default: 'async' */
+    decoding?: 'async' | 'sync' | 'auto';
+    /** Fetch priority. Default: 'auto' */
+    fetchPriority?: 'high' | 'low' | 'auto';
+    /** Sizes attribute for responsive images */
+    sizes?: string;
+    /** BlurHash or base64 LQIP placeholder string */
+    placeholder?: string;
+    /** Placeholder type. Default: 'blur' */
+    placeholderType?: 'blur' | 'color' | 'none';
+    /** Fade-in duration when loaded in ms. Default: 300 */
+    fadeDuration?: number;
+    /** CSS class on the wrapper */
+    class?: string;
+    /** CSS object-fit. Default: 'cover' */
+    objectFit?: 'cover' | 'contain' | 'fill' | 'none' | 'scale-down';
+    /** CSS aspect-ratio */
+    aspectRatio?: string;
+    /** Called when image loads */
+    onLoad?: (img: HTMLImageElement) => void;
+    /** Called on error */
+    onError?: (err: Event) => void;
+}
+export interface ImageInstance {
+    /** The wrapper element */
+    element: HTMLElement;
+    /** The <img> element */
+    img: HTMLImageElement;
+    /** Update the image source */
+    setSrc(src: string): void;
+    /** Destroy and cleanup */
+    destroy(): void;
+}
+/** Check if the browser supports WebP. */
+export declare function supportsWebP(): Promise<boolean>;
+/** Check if the browser supports AVIF. */
+export declare function supportsAVIF(): Promise<boolean>;
+/** Create a high-fidelity responsive image element with progressive loading. */
+export declare function createImage(options: ImageOptions): ImageInstance;
+/**
+ * Generate a tiny BlurHash-style placeholder from a canvas.
+ * Downscales the image to a very small resolution, draws to canvas, returns base64.
+ */
+export declare function generateLQIP(src: string, size?: number): Promise<string>;
+/**
+ * Preload an image and return when it's fully decoded.
+ */
+export declare function preloadImage(src: string): Promise<HTMLImageElement>;
+/**
+ * Auto-enhance all images matching a selector with progressive loading.
+ * Returns a cleanup function.
+ */
+export declare function enhanceImages(selector: string, options?: Partial<ImageOptions>): () => void;
+//# sourceMappingURL=image.d.ts.map

package/dist/image/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/image/image.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAC1D,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,iCAAiC;IACjC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IACxC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC5C,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;IACjE,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzC,sBAAsB;IACtB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,OAAO,EAAE,WAAW,CAAC;IACrB,wBAAwB;IACxB,GAAG,EAAE,gBAAgB,CAAC;IACtB,8BAA8B;IAC9B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,0BAA0B;IAC1B,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD,0CAA0C;AAC1C,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAQrD;AAED,0CAA0C;AAC1C,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAQrD;AAsCD,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,CAkIhE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB1E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAKzE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAClC,MAAM,IAAI,CAuBZ"}

package/dist/image/image.js

@@ -0,0 +1,236 @@
+/**
+ * Nova Engine — Image Optimization
+ *
+ * Responsive `<picture>` generation, blur-up placeholders (LQIP/BlurHash),
+ * format detection (WebP/AVIF), and progressive loading.
+ */
+// Format detection cache
+let _supportsWebP = null;
+let _supportsAVIF = null;
+/** Check if the browser supports WebP. */
+export async function supportsWebP() {
+    if (_supportsWebP !== null)
+        return _supportsWebP;
+    return new Promise((resolve) => {
+        const img = new Image();
+        img.onload = () => { _supportsWebP = img.width > 0; resolve(_supportsWebP); };
+        img.onerror = () => { _supportsWebP = false; resolve(false); };
+        img.src = 'data:image/webp;base64,UklGRiIAAABXRUJQVlA4IBYAAAAwAQCdASoBAAEADsD+JaQAA3AAAAAA';
+    });
+}
+/** Check if the browser supports AVIF. */
+export async function supportsAVIF() {
+    if (_supportsAVIF !== null)
+        return _supportsAVIF;
+    return new Promise((resolve) => {
+        const img = new Image();
+        img.onload = () => { _supportsAVIF = img.width > 0; resolve(_supportsAVIF); };
+        img.onerror = () => { _supportsAVIF = false; resolve(false); };
+        img.src = 'data:image/avif;base64,AAAAIGZ0eXBhdmlmAAAAAGF2aWZtaWYxbWlhZk1BMUEAAADybWV0YQAAAAAAAAAoaGRscgAAAAAAAAAAcGljdAAAAAAAAAAAAAAAAGxpYmF2aWYAAAAADnBpdG0AAAAAAAEAAAAeaWxvYwAAAABEAAABAAEAAAABAAABGgAAABcAAAAoaWluZgAAAAAAAQAAABppbmZlAgAAAAABAABhdjAxQ29sb3IAAAAAamlwcnAAAABLaXBjbwAAABRpc3BlAAAAAAAAAAEAAAABAAAAEHBpeGkAAAAAAwgICAAAAAxhdjFDgQAMAAAAABNjb2xybmNseAACAAIABoAAAAAXaXBtYQAAAAAAAAABAAEEAQKDBAAAAB9tZGF0EgAKCBgABogQEDQgMgkQAAAAB8dSLfI=';
+    });
+}
+function detectFormat(url) {
+    const ext = url.split('.').pop()?.split('?')[0]?.toLowerCase() ?? '';
+    const map = {
+        webp: 'image/webp', avif: 'image/avif', jpg: 'image/jpeg',
+        jpeg: 'image/jpeg', png: 'image/png', gif: 'image/gif', svg: 'image/svg+xml',
+    };
+    return map[ext] ?? '';
+}
+const STYLE_ID = 'nova-image-styles';
+function injectStyles() {
+    if (document.getElementById(STYLE_ID))
+        return;
+    const s = document.createElement('style');
+    s.id = STYLE_ID;
+    s.textContent = `
+.nova-image { position: relative; overflow: hidden; display: inline-block; }
+.nova-image__placeholder {
+  position: absolute; inset: 0; z-index: 1;
+  background-size: cover; background-position: center;
+  filter: blur(20px); transform: scale(1.1);
+  transition: opacity 0.3s ease-out;
+}
+.nova-image__placeholder--hidden { opacity: 0; pointer-events: none; }
+.nova-image__img {
+  display: block; width: 100%; height: 100%;
+  opacity: 0; transition: opacity 0.3s ease-out;
+}
+.nova-image__img--loaded { opacity: 1; }
+@media (prefers-reduced-motion: reduce) {
+  .nova-image__placeholder, .nova-image__img { transition: none; }
+  .nova-image__img { opacity: 1; }
+}`;
+    document.head.appendChild(s);
+}
+/** Create a high-fidelity responsive image element with progressive loading. */
+export function createImage(options) {
+    const { src, alt, sources = [], width, height, loading = 'lazy', decoding = 'async', fetchPriority = 'auto', sizes, placeholder, placeholderType = 'blur', fadeDuration = 300, class: className, objectFit = 'cover', aspectRatio, onLoad, onError, } = options;
+    injectStyles();
+    // Wrapper
+    const wrapper = document.createElement('div');
+    wrapper.className = 'nova-image' + (className ? ` ${className}` : '');
+    if (aspectRatio)
+        wrapper.style.aspectRatio = aspectRatio;
+    if (width)
+        wrapper.style.width = `${width}px`;
+    if (height)
+        wrapper.style.height = `${height}px`;
+    // Placeholder
+    let placeholderEl = null;
+    if (placeholder && placeholderType !== 'none') {
+        placeholderEl = document.createElement('div');
+        placeholderEl.className = 'nova-image__placeholder';
+        if (placeholderType === 'blur') {
+            // Could be a base64 LQIP, a BlurHash decoded to data URL, or a tiny image URL
+            placeholderEl.style.backgroundImage = `url('${placeholder}')`;
+        }
+        else if (placeholderType === 'color') {
+            placeholderEl.style.backgroundColor = placeholder;
+        }
+        wrapper.appendChild(placeholderEl);
+    }
+    // Build <picture> or <img>
+    let container;
+    if (sources.length > 0) {
+        const picture = document.createElement('picture');
+        // Group sources by format for <source> elements
+        for (const source of sources) {
+            const sourceEl = document.createElement('source');
+            if (source.format) {
+                const mimeMap = {
+                    webp: 'image/webp', avif: 'image/avif', jpeg: 'image/jpeg',
+                    png: 'image/png', gif: 'image/gif', svg: 'image/svg+xml',
+                };
+                sourceEl.type = mimeMap[source.format] ?? '';
+            }
+            else {
+                const detected = detectFormat(source.src);
+                if (detected)
+                    sourceEl.type = detected;
+            }
+            sourceEl.srcset = source.src + (source.width ? ` ${source.width}w` : '');
+            if (source.media)
+                sourceEl.media = source.media;
+            picture.appendChild(sourceEl);
+        }
+        container = picture;
+    }
+    else {
+        container = wrapper;
+    }
+    // <img> element
+    const img = document.createElement('img');
+    img.className = 'nova-image__img';
+    img.alt = alt;
+    img.loading = loading;
+    img.decoding = decoding;
+    if (fetchPriority !== 'auto')
+        img.setAttribute('fetchpriority', fetchPriority);
+    if (sizes)
+        img.sizes = sizes;
+    if (width)
+        img.width = width;
+    if (height)
+        img.height = height;
+    img.style.objectFit = objectFit;
+    // Set custom fade duration
+    if (fadeDuration !== 300) {
+        img.style.transitionDuration = `${fadeDuration}ms`;
+        if (placeholderEl)
+            placeholderEl.style.transitionDuration = `${fadeDuration}ms`;
+    }
+    // Generate srcset from sources if provided with widths
+    const srcsetParts = sources
+        .filter((s) => s.width)
+        .map((s) => `${s.src} ${s.width}w`);
+    if (srcsetParts.length > 0)
+        img.srcset = srcsetParts.join(', ');
+    img.src = src;
+    img.addEventListener('load', () => {
+        img.classList.add('nova-image__img--loaded');
+        if (placeholderEl) {
+            placeholderEl.classList.add('nova-image__placeholder--hidden');
+        }
+        onLoad?.(img);
+    });
+    img.addEventListener('error', (e) => {
+        onError?.(e);
+    });
+    if (sources.length > 0) {
+        container.appendChild(img);
+        wrapper.appendChild(container);
+    }
+    else {
+        wrapper.appendChild(img);
+    }
+    return {
+        element: wrapper,
+        img,
+        setSrc(newSrc) {
+            img.classList.remove('nova-image__img--loaded');
+            if (placeholderEl)
+                placeholderEl.classList.remove('nova-image__placeholder--hidden');
+            img.src = newSrc;
+        },
+        destroy() {
+            wrapper.remove();
+        },
+    };
+}
+/**
+ * Generate a tiny BlurHash-style placeholder from a canvas.
+ * Downscales the image to a very small resolution, draws to canvas, returns base64.
+ */
+export async function generateLQIP(src, size = 16) {
+    return new Promise((resolve, reject) => {
+        const img = new Image();
+        img.crossOrigin = 'anonymous';
+        img.onload = () => {
+            const canvas = document.createElement('canvas');
+            const aspect = img.naturalWidth / img.naturalHeight;
+            canvas.width = size;
+            canvas.height = Math.round(size / aspect);
+            const ctx = canvas.getContext('2d');
+            ctx.drawImage(img, 0, 0, canvas.width, canvas.height);
+            resolve(canvas.toDataURL('image/jpeg', 0.5));
+        };
+        img.onerror = reject;
+        img.src = src;
+    });
+}
+/**
+ * Preload an image and return when it's fully decoded.
+ */
+export async function preloadImage(src) {
+    const img = new Image();
+    img.src = src;
+    await img.decode();
+    return img;
+}
+/**
+ * Auto-enhance all images matching a selector with progressive loading.
+ * Returns a cleanup function.
+ */
+export function enhanceImages(selector, options = {}) {
+    injectStyles();
+    const images = document.querySelectorAll(selector);
+    const instances = [];
+    for (const originalImg of images) {
+        const instance = createImage({
+            src: originalImg.src,
+            alt: originalImg.alt || '',
+            width: originalImg.width || undefined,
+            height: originalImg.height || undefined,
+            placeholder: originalImg.getAttribute('data-placeholder') ?? undefined,
+            ...options,
+        });
+        originalImg.parentNode?.replaceChild(instance.element, originalImg);
+        instances.push(instance);
+    }
+    return () => {
+        for (const inst of instances)
+            inst.destroy();
+    };
+}
+//# sourceMappingURL=image.js.map

package/dist/image/image.js.map

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

package/dist/image/index.d.ts

@@ -0,0 +1,5 @@
+export { createImage, supportsWebP, supportsAVIF, generateLQIP, preloadImage, enhanceImages, } from './image';
+export type { ImageSource, ImageOptions, ImageInstance } from './image';
+export { applyFilter, createFilterPipeline, extractDominantColor } from './effects';
+export type { FilterType, FilterOptions, FilterPipeline } from './effects';
+//# sourceMappingURL=index.d.ts.map

package/dist/image/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/image/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACpF,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/image/index.js

@@ -0,0 +1,3 @@
+export { createImage, supportsWebP, supportsAVIF, generateLQIP, preloadImage, enhanceImages, } from './image';
+export { applyFilter, createFilterPipeline, extractDominantColor } from './effects';
+//# sourceMappingURL=index.js.map

package/dist/image/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/image/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC"}

package/dist/interaction/index.d.ts

@@ -0,0 +1,3 @@
+export { tilt } from './tilt';
+export type { TiltOptions } from './tilt';
+//# sourceMappingURL=index.d.ts.map

package/dist/interaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC"}

package/dist/interaction/index.js

@@ -0,0 +1,2 @@
+export { tilt } from './tilt';
+//# sourceMappingURL=index.js.map

package/dist/interaction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC"}

package/dist/interaction/tilt.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Nova Engine — 3D Tilt Interaction
+ *
+ * Mouse-tracking perspective transforms with glare overlay.
+ * Creates a premium 3D card effect on any element.
+ */
+export interface TiltOptions {
+    /** Max rotation in degrees. Default: 6 */
+    max?: number;
+    /** Scale on hover. Default: 1.02 */
+    scale?: number;
+    /** Transition speed in ms. Default: 120 */
+    speed?: number;
+    /** Show glare overlay. Default: true */
+    glare?: boolean;
+    /** Max glare opacity (0–1). Default: 0.08 */
+    glareMax?: number;
+    /** CSS perspective value. Default: 1200 */
+    perspective?: number;
+    /** Constrain rotation axis. Default: 'both' */
+    axis?: 'x' | 'y' | 'both';
+    /** Reset transform on mouse leave. Default: true */
+    reset?: boolean;
+}
+/**
+ * Apply 3D tilt effect to elements.
+ * Returns a cleanup function.
+ */
+export declare function tilt(selector: string | Element | Element[], options?: TiltOptions): () => void;
+//# sourceMappingURL=tilt.d.ts.map

package/dist/interaction/tilt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tilt.d.ts","sourceRoot":"","sources":["../../src/interaction/tilt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;IAC1B,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAuCD;;;GAGG;AACH,wBAAgB,IAAI,CAClB,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,EACtC,OAAO,GAAE,WAAgB,GACxB,MAAM,IAAI,CA4HZ"}

package/dist/interaction/tilt.js

@@ -0,0 +1,131 @@
+/**
+ * Nova Engine — 3D Tilt Interaction
+ *
+ * Mouse-tracking perspective transforms with glare overlay.
+ * Creates a premium 3D card effect on any element.
+ */
+const items = [];
+function applyStyles(el, opts) {
+    el.style.perspective = `${opts.perspective}px`;
+    el.style.transformStyle = 'preserve-3d';
+}
+function createGlare(el, opts) {
+    const glare = document.createElement('div');
+    glare.setAttribute('data-nova-glare', '');
+    Object.assign(glare.style, {
+        position: 'absolute',
+        inset: '0',
+        pointerEvents: 'none',
+        opacity: '0',
+        transition: `opacity ${opts.speed}ms ease-out`,
+        background: 'radial-gradient(600px circle at 50% 50%, rgba(255,255,255,0.08) 0%, transparent 60%)',
+        zIndex: '10',
+        borderRadius: 'inherit',
+    });
+    // Ensure parent is positioned
+    const computed = getComputedStyle(el);
+    if (computed.position === 'static') {
+        el.style.position = 'relative';
+    }
+    el.style.overflow = 'hidden';
+    el.appendChild(glare);
+    return glare;
+}
+/**
+ * Apply 3D tilt effect to elements.
+ * Returns a cleanup function.
+ */
+export function tilt(selector, options = {}) {
+    const { max = 6, scale = 1.02, speed = 120, glare = true, glareMax = 0.08, perspective = 1200, axis = 'both', reset = true, } = options;
+    const opts = { max, scale, speed, glare, glareMax, perspective, axis, reset };
+    const targets = typeof selector === 'string'
+        ? Array.from(document.querySelectorAll(selector))
+        : selector instanceof Element
+            ? [selector]
+            : selector;
+    const newItems = [];
+    for (const el of targets) {
+        applyStyles(el, opts);
+        el.style.willChange = 'transform';
+        el.style.transition = `transform ${speed}ms ease-out`;
+        const glareEl = glare ? createGlare(el, opts) : null;
+        const listeners = [];
+        const onMove = (e) => {
+            const me = e;
+            const rect = el.getBoundingClientRect();
+            const x = me.clientX - rect.left;
+            const y = me.clientY - rect.top;
+            const cx = rect.width / 2;
+            const cy = rect.height / 2;
+            const rotX = axis !== 'x' ? ((y - cy) / cy) * -max : 0;
+            const rotY = axis !== 'y' ? ((x - cx) / cx) * max : 0;
+            el.style.transform = `rotateX(${rotX}deg) rotateY(${rotY}deg) scale3d(${scale},${scale},${scale})`;
+            if (glareEl) {
+                const pctX = (x / rect.width) * 100;
+                const pctY = (y / rect.height) * 100;
+                glareEl.style.background =
+                    `radial-gradient(600px circle at ${pctX}% ${pctY}%, rgba(255,255,255,${glareMax}) 0%, transparent 60%)`;
+            }
+        };
+        const onEnter = () => {
+            el.style.transition = `transform ${speed}ms ease-out`;
+            if (glareEl)
+                glareEl.style.opacity = '1';
+        };
+        const onLeave = () => {
+            if (reset) {
+                el.style.transition = `transform ${speed * 3}ms ease-out`;
+                el.style.transform = 'rotateX(0) rotateY(0) scale3d(1,1,1)';
+            }
+            if (glareEl)
+                glareEl.style.opacity = '0';
+        };
+        // Touch support
+        const onTouchMove = (e) => {
+            const te = e;
+            if (!te.touches.length)
+                return;
+            const touch = te.touches[0];
+            const rect = el.getBoundingClientRect();
+            const x = touch.clientX - rect.left;
+            const y = touch.clientY - rect.top;
+            const cx = rect.width / 2;
+            const cy = rect.height / 2;
+            const rotX = axis !== 'x' ? ((y - cy) / cy) * -max : 0;
+            const rotY = axis !== 'y' ? ((x - cx) / cx) * max : 0;
+            el.style.transform = `rotateX(${rotX}deg) rotateY(${rotY}deg) scale3d(${scale},${scale},${scale})`;
+        };
+        const onTouchEnd = () => {
+            if (reset) {
+                el.style.transition = `transform ${speed * 3}ms ease-out`;
+                el.style.transform = 'rotateX(0) rotateY(0) scale3d(1,1,1)';
+            }
+        };
+        el.addEventListener('mousemove', onMove);
+        el.addEventListener('mouseenter', onEnter);
+        el.addEventListener('mouseleave', onLeave);
+        el.addEventListener('touchmove', onTouchMove, { passive: true });
+        el.addEventListener('touchend', onTouchEnd);
+        listeners.push(['mousemove', onMove], ['mouseenter', onEnter], ['mouseleave', onLeave], ['touchmove', onTouchMove], ['touchend', onTouchEnd]);
+        const item = { el, glare: glareEl, listeners };
+        items.push(item);
+        newItems.push(item);
+    }
+    return () => {
+        for (const item of newItems) {
+            for (const [evt, fn] of item.listeners) {
+                item.el.removeEventListener(evt, fn);
+            }
+            item.glare?.remove();
+            item.el.style.willChange = '';
+            item.el.style.transform = '';
+            item.el.style.transition = '';
+            item.el.style.perspective = '';
+            item.el.style.transformStyle = '';
+            const idx = items.indexOf(item);
+            if (idx !== -1)
+                items.splice(idx, 1);
+        }
+    };
+}
+//# sourceMappingURL=tilt.js.map

package/dist/interaction/tilt.js.map

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

package/dist/lazy/index.d.ts

@@ -0,0 +1,3 @@
+export { createLazy, lazy, lazyLoad } from './lazy';
+export type { LazyOptions, LazyInstance } from './lazy';
+//# sourceMappingURL=index.d.ts.map

package/dist/lazy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lazy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC"}

package/dist/lazy/index.js

@@ -0,0 +1,2 @@
+export { createLazy, lazy, lazyLoad } from './lazy';
+//# sourceMappingURL=index.js.map

package/dist/lazy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lazy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC"}

package/dist/lazy/lazy.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Nova Engine — Lazy Loading
+ *
+ * Intersection Observer-based lazy loading for elements, images, and components.
+ */
+export interface LazyOptions {
+    /** Root element for intersection. Default: null (viewport) */
+    root?: Element | null;
+    /** Margin around root. Default: '200px' (preload before visible) */
+    rootMargin?: string;
+    /** Visibility threshold (0-1). Default: 0 */
+    threshold?: number;
+    /** CSS class added when element is visible. Default: 'nova-lazy--visible' */
+    visibleClass?: string;
+    /** Only trigger once per element. Default: true */
+    once?: boolean;
+}
+export interface LazyInstance {
+    /** Observe a new element */
+    observe(el: Element): void;
+    /** Stop observing an element */
+    unobserve(el: Element): void;
+    /** Cleanup observer */
+    destroy(): void;
+}
+/**
+ * Create a lazy loader that triggers when elements enter the viewport.
+ * Uses `data-src` → `src` and `data-srcset` → `srcset` for images.
+ * Adds the visible class for CSS-driven reveal animations.
+ */
+export declare function createLazy(options?: LazyOptions): LazyInstance;
+/**
+ * Convenience: auto-observe all elements matching a selector.
+ * Returns a cleanup function.
+ */
+export declare function lazy(selector: string, options?: LazyOptions): () => void;
+/**
+ * Lazy-load a module/component when an element becomes visible.
+ * Calls the factory function only once when the element first enters viewport.
+ */
+export declare function lazyLoad<T>(element: Element, factory: () => Promise<T>, options?: LazyOptions): Promise<T>;
+//# sourceMappingURL=lazy.d.ts.map

package/dist/lazy/lazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../src/lazy/lazy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,gCAAgC;IAChC,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,uBAAuB;IACvB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,WAAgB,GAAG,YAAY,CA8ClE;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,IAAI,CAKxE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,CAAC,CAAC,CAgBZ"}