@mappoh/nova 0.3.0 → 0.5.1

package/dist/animation/flip.js

@@ -56,23 +56,36 @@ export async function flip(elements, mutation, options = {}) {
  */
 export function autoFlip(container, options = {}) {
     const { duration = 300, easing = 'ease-out' } = options;
+    // Snapshot of child positions, taken before each mutation batch
+    let childRects = new Map();
+    function snapshot() {
+        childRects = new Map();
+        for (const child of Array.from(container.children)) {
+            childRects.set(child, child.getBoundingClientRect());
+        }
+    }
+    // Take initial snapshot
+    snapshot();
     const observer = new MutationObserver((mutations) => {
         if (prefersReduced())
             return;
-        // Collect all children that existed before the mutation
-        const rects = new Map();
+        // Identify newly added nodes
+        const addedNodes = new Set();
         for (const m of mutations) {
             for (const node of m.addedNodes) {
                 if (node instanceof HTMLElement) {
+                    addedNodes.add(node);
                     // New nodes fade in
                     node.animate([{ opacity: 0 }, { opacity: 1 }], { duration: duration / 2, easing });
                 }
             }
         }
-        // Animate existing children from their old positions
+        // Animate existing children from their old positions (FLIP)
         const children = Array.from(container.children);
         for (const child of children) {
-            const rect = rects.get(child);
+            if (addedNodes.has(child) && !childRects.has(child))
+                continue;
+            const rect = childRects.get(child);
             if (!rect)
                 continue;
             const last = child.getBoundingClientRect();
@@ -85,15 +98,9 @@ export function autoFlip(container, options = {}) {
                 ], { duration, easing });
             }
         }
+        // Re-snapshot for the next mutation batch
+        snapshot();
     });
-    // Before mutations, snapshot positions
-    const childRects = new Map();
-    function snapshot() {
-        childRects.clear();
-        for (const child of Array.from(container.children)) {
-            childRects.set(child, child.getBoundingClientRect());
-        }
-    }
     // Use a MutationObserver to detect changes
     observer.observe(container, { childList: true });
     // Expose snapshot for manual triggering before DOM mutations

package/dist/animation/flip.js.map

@@ -1 +1 @@
-{"version":3,"file":"flip.js","sourceRoot":"","sources":[""],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,cAAc,GAAG,GAAY,EAAE,CACnC,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,CAAC;AAEjG;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,QAAqC,EACrC,QAAoC,EACpC,UAAuB,EAAE;IAEzB,MAAM,EAAE,QAAQ,GAAG,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE5D,kCAAkC;IAClC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAwB,CAAC;IACnD,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,8BAA8B;IAC9B,MAAM,QAAQ,EAAE,CAAC;IAEjB,iCAAiC;IACjC,IAAI,cAAc,EAAE,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO;IAE/C,uBAAuB;IACvB,MAAM,UAAU,GAAgB,EAAE,CAAC;IAEnC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC;QAExC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAClC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QAChC,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;QAC3C,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;QAE7C,wBAAwB;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;YAAE,SAAS;QAE3D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CACrB;YACE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE;YAChE,EAAE,SAAS,EAAE,6BAA6B,EAAE;SAC7C,EACD,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CACnC,CAAC;QAEF,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,sCAAsC;IACtC,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,SAAsB,EACtB,UAAuB,EAAE;IAEzB,MAAM,EAAE,QAAQ,GAAG,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IAExD,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,CAAC,SAAS,EAAE,EAAE;QAClD,IAAI,cAAc,EAAE;YAAE,OAAO;QAE7B,wDAAwD;QACxD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;QAC9C,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBAChC,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;oBAChC,oBAAoB;oBACpB,IAAI,CAAC,OAAO,CACV,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAChC,EAAE,QAAQ,EAAE,QAAQ,GAAG,CAAC,EAAE,MAAM,EAAE,CACnC,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,qDAAqD;QACrD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAkB,CAAC;QACjE,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,MAAM,IAAI,GAAG,KAAK,CAAC,qBAAqB,EAAE,CAAC;YAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACjC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;YAE/B,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,OAAO,CACX;oBACE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE;oBAC5C,EAAE,SAAS,EAAE,iBAAiB,EAAE;iBACjC,EACD,EAAE,QAAQ,EAAE,MAAM,EAAE,CACrB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,uCAAuC;IACvC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEnD,SAAS,QAAQ;QACf,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAkB,EAAE,CAAC;YACpE,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,qBAAqB,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjD,6DAA6D;IAC5D,SAA2D,CAAC,cAAc,GAAG,QAAQ,CAAC;IAEvF,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,UAAU,EAAE,CAAC;QACtB,OAAQ,SAA2D,CAAC,cAAc,CAAC;IACrF,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"flip.js","sourceRoot":"","sources":[""],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,cAAc,GAAG,GAAY,EAAE,CACnC,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,CAAC;AAEjG;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,QAAqC,EACrC,QAAoC,EACpC,UAAuB,EAAE;IAEzB,MAAM,EAAE,QAAQ,GAAG,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE5D,kCAAkC;IAClC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAwB,CAAC;IACnD,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,8BAA8B;IAC9B,MAAM,QAAQ,EAAE,CAAC;IAEjB,iCAAiC;IACjC,IAAI,cAAc,EAAE,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO;IAE/C,uBAAuB;IACvB,MAAM,UAAU,GAAgB,EAAE,CAAC;IAEnC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC;QAExC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAClC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QAChC,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;QAC3C,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;QAE7C,wBAAwB;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;YAAE,SAAS;QAE3D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CACrB;YACE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE;YAChE,EAAE,SAAS,EAAE,6BAA6B,EAAE;SAC7C,EACD,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CACnC,CAAC;QAEF,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,sCAAsC;IACtC,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,SAAsB,EACtB,UAAuB,EAAE;IAEzB,MAAM,EAAE,QAAQ,GAAG,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IAExD,gEAAgE;IAChE,IAAI,UAAU,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEjD,SAAS,QAAQ;QACf,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAkB,EAAE,CAAC;YACpE,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,qBAAqB,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,QAAQ,EAAE,CAAC;IAEX,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,CAAC,SAAS,EAAE,EAAE;QAClD,IAAI,cAAc,EAAE;YAAE,OAAO;QAE7B,6BAA6B;QAC7B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAe,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBAChC,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;oBAChC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACrB,oBAAoB;oBACpB,IAAI,CAAC,OAAO,CACV,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAChC,EAAE,QAAQ,EAAE,QAAQ,GAAG,CAAC,EAAE,MAAM,EAAE,CACnC,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAkB,CAAC;QACjE,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YAC9D,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,MAAM,IAAI,GAAG,KAAK,CAAC,qBAAqB,EAAE,CAAC;YAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACjC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;YAE/B,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,OAAO,CACX;oBACE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE;oBAC5C,EAAE,SAAS,EAAE,iBAAiB,EAAE;iBACjC,EACD,EAAE,QAAQ,EAAE,MAAM,EAAE,CACrB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,0CAA0C;QAC1C,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjD,6DAA6D;IAC5D,SAA2D,CAAC,cAAc,GAAG,QAAQ,CAAC;IAEvF,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,UAAU,EAAE,CAAC;QACtB,OAAQ,SAA2D,CAAC,cAAc,CAAC;IACrF,CAAC,CAAC;AACJ,CAAC"}

package/dist/animation/stagger.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Nova Engine — Stagger Animations
+ *
+ * Apply animations to a list of elements with incremental delays.
+ */
+import type { SpringOptions } from './spring';
+export interface StaggerOptions {
+    /** Delay in ms between each element. Default: 50 */
+    delay?: number;
+    /** Which element starts first. Default: 'start' */
+    from?: 'start' | 'center' | 'end';
+    /** Total duration per element in ms. Default: 300 */
+    duration?: number;
+    /** CSS easing. Default: 'ease-out' */
+    easing?: string;
+}
+/**
+ * Animate a list of elements with staggered delays using the Web Animations API.
+ *
+ * Each element plays the same keyframes but starts after an incremental delay
+ * determined by the `from` option.
+ *
+ * Respects `prefers-reduced-motion` — when reduced, all elements are animated
+ * instantly (duration: 0, delay: 0).
+ */
+export declare function stagger(elements: HTMLElement[], keyframes: Keyframe[], options?: StaggerOptions): {
+    cancel: () => void;
+    finished: Promise<void>;
+};
+/**
+ * Animate a list of elements with staggered spring physics.
+ *
+ * Each element's CSS property is animated toward `to` using a spring
+ * simulation, with an incremental start delay based on the `from` option.
+ *
+ * Respects `prefers-reduced-motion` — when reduced, all elements jump
+ * to the target value instantly.
+ */
+export declare function staggerSpring(elements: HTMLElement[], property: string, to: number, options?: StaggerOptions & SpringOptions): {
+    cancel: () => void;
+    finished: Promise<void>;
+};
+//# sourceMappingURL=stagger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stagger.d.ts","sourceRoot":"","sources":["../../src/animation/stagger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoCD;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,WAAW,EAAE,EACvB,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,CAAC,EAAE,cAAc,GACvB;IAAE,MAAM,EAAE,MAAM,IAAI,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CA0CjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EAAE,EACvB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,GACvC;IAAE,MAAM,EAAE,MAAM,IAAI,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAmEjD"}

package/dist/animation/stagger.js

@@ -0,0 +1,150 @@
+/**
+ * Nova Engine — Stagger Animations
+ *
+ * Apply animations to a list of elements with incremental delays.
+ */
+import { spring } from './spring';
+const prefersReduced = () => typeof window !== 'undefined' && window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+/**
+ * Calculate the delay offset for each element index based on the `from` option.
+ *
+ * - 'start': element 0 has 0 delay, last element has max delay.
+ * - 'end':   last element has 0 delay, first element has max delay.
+ * - 'center': middle element has 0 delay, edges have max delay.
+ */
+function computeDelays(count, delay, from) {
+    if (count === 0)
+        return [];
+    const delays = new Array(count);
+    if (from === 'end') {
+        for (let i = 0; i < count; i++) {
+            delays[i] = (count - 1 - i) * delay;
+        }
+    }
+    else if (from === 'center') {
+        const center = (count - 1) / 2;
+        for (let i = 0; i < count; i++) {
+            delays[i] = Math.abs(i - center) * delay;
+        }
+    }
+    else {
+        // 'start' (default)
+        for (let i = 0; i < count; i++) {
+            delays[i] = i * delay;
+        }
+    }
+    return delays;
+}
+/**
+ * Animate a list of elements with staggered delays using the Web Animations API.
+ *
+ * Each element plays the same keyframes but starts after an incremental delay
+ * determined by the `from` option.
+ *
+ * Respects `prefers-reduced-motion` — when reduced, all elements are animated
+ * instantly (duration: 0, delay: 0).
+ */
+export function stagger(elements, keyframes, options) {
+    const { delay = 50, from = 'start', duration = 300, easing = 'ease-out', } = options ?? {};
+    const count = elements.length;
+    // Reduced motion: apply final state instantly
+    if (prefersReduced()) {
+        const animations = [];
+        for (const el of elements) {
+            const anim = el.animate(keyframes, { duration: 0, fill: 'forwards' });
+            animations.push(anim);
+        }
+        return {
+            cancel: () => { for (const a of animations)
+                a.cancel(); },
+            finished: Promise.all(animations.map((a) => a.finished)).then(() => { }),
+        };
+    }
+    const delays = computeDelays(count, delay, from);
+    const animations = [];
+    for (let i = 0; i < count; i++) {
+        const anim = elements[i].animate(keyframes, {
+            duration,
+            easing,
+            delay: delays[i],
+            fill: 'both',
+        });
+        animations.push(anim);
+    }
+    return {
+        cancel() {
+            for (const a of animations)
+                a.cancel();
+        },
+        finished: Promise.all(animations.map((a) => a.finished)).then(() => { }),
+    };
+}
+/**
+ * Animate a list of elements with staggered spring physics.
+ *
+ * Each element's CSS property is animated toward `to` using a spring
+ * simulation, with an incremental start delay based on the `from` option.
+ *
+ * Respects `prefers-reduced-motion` — when reduced, all elements jump
+ * to the target value instantly.
+ */
+export function staggerSpring(elements, property, to, options) {
+    const { delay = 50, from = 'start', 
+    // duration and easing are unused for spring — included for StaggerOptions compat
+    duration: _duration, easing: _easing, ...springOpts } = options ?? {};
+    void _duration;
+    void _easing;
+    const count = elements.length;
+    // Reduced motion: jump all elements instantly
+    if (prefersReduced()) {
+        for (const el of elements) {
+            el.style.setProperty(property, String(to));
+        }
+        return { cancel: () => { }, finished: Promise.resolve() };
+    }
+    const delays = computeDelays(count, delay, from);
+    const cancellers = [];
+    const promises = [];
+    for (let i = 0; i < count; i++) {
+        const el = elements[i];
+        const elementDelay = delays[i];
+        if (elementDelay === 0) {
+            // Start immediately
+            const result = spring(el, property, to, springOpts);
+            cancellers.push(result.cancel);
+            promises.push(result.finished);
+        }
+        else {
+            // Delay start via setTimeout
+            let cancelled = false;
+            let springCancel = null;
+            const promise = new Promise((resolve) => {
+                const timerId = setTimeout(() => {
+                    if (cancelled) {
+                        resolve();
+                        return;
+                    }
+                    const result = spring(el, property, to, springOpts);
+                    springCancel = result.cancel;
+                    result.finished.then(resolve);
+                }, elementDelay);
+                cancellers.push(() => {
+                    cancelled = true;
+                    clearTimeout(timerId);
+                    if (springCancel)
+                        springCancel();
+                    resolve();
+                });
+            });
+            promises.push(promise);
+        }
+    }
+    return {
+        cancel() {
+            for (const fn of cancellers)
+                fn();
+        },
+        finished: Promise.all(promises).then(() => { }),
+    };
+}
+//# sourceMappingURL=stagger.js.map

package/dist/animation/stagger.js.map

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

package/dist/avatar/avatar.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Nova Engine — Avatar
+ *
+ * Circular avatar with image source, initials fallback derived
+ * from a name, and deterministic background color hashing.
+ */
+export interface AvatarOptions {
+    /** Image URL. Falls back to initials if omitted or fails to load. */
+    src?: string;
+    /** Full name — used to generate initials fallback */
+    name?: string;
+    /** Diameter in px. Default: 40 */
+    size?: number;
+    /** Custom fallback text (overrides name-based initials) */
+    fallback?: string;
+    /** Alt text for the image. Defaults to name or 'Avatar'. */
+    alt?: string;
+}
+export interface AvatarInstance {
+    /** Update the image source */
+    setSrc(src: string): void;
+    /** Remove the avatar from DOM and clean up */
+    destroy(): void;
+}
+/** Create a circular avatar with image and initials fallback. */
+export declare function createAvatar(container: string | HTMLElement, options?: AvatarOptions): AvatarInstance;
+//# sourceMappingURL=avatar.d.ts.map

package/dist/avatar/avatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../../src/avatar/avatar.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,8CAA8C;IAC9C,OAAO,IAAI,IAAI,CAAC;CACjB;AAiED,iEAAiE;AACjE,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,GAAG,WAAW,EAC/B,OAAO,GAAE,aAAkB,GAC1B,cAAc,CA6EhB"}

package/dist/avatar/avatar.js

@@ -0,0 +1,132 @@
+/**
+ * Nova Engine — Avatar
+ *
+ * Circular avatar with image source, initials fallback derived
+ * from a name, and deterministic background color hashing.
+ */
+const STYLE_ID = 'nova-avatar-styles';
+function injectStyles() {
+    if (document.getElementById(STYLE_ID))
+        return;
+    const s = document.createElement('style');
+    s.id = STYLE_ID;
+    s.textContent = `
+.nova-avatar {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
+  overflow: hidden;
+  flex-shrink: 0;
+  user-select: none;
+  vertical-align: middle;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  font-weight: 600;
+  color: var(--color-avatar-text, #fff);
+  background: var(--color-avatar-bg, rgba(255, 255, 255, 0.12));
+}
+.nova-avatar__img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  border-radius: inherit;
+}`;
+    document.head.appendChild(s);
+}
+/**
+ * Generate initials from a name string.
+ * Takes the first letter of each word (max 2).
+ */
+function getInitials(name) {
+    const parts = name.trim().split(/\s+/);
+    if (parts.length === 0)
+        return '';
+    if (parts.length === 1)
+        return parts[0].charAt(0).toUpperCase();
+    return (parts[0].charAt(0) + parts[parts.length - 1].charAt(0)).toUpperCase();
+}
+/**
+ * Deterministically hash a string to a hue value (0-360).
+ * Produces a consistent background color per name.
+ */
+function nameToHue(name) {
+    let hash = 0;
+    for (let i = 0; i < name.length; i++) {
+        hash = name.charCodeAt(i) + ((hash << 5) - hash);
+        hash = hash & hash; // Convert to 32-bit integer
+    }
+    return Math.abs(hash) % 360;
+}
+function resolveContainer(container) {
+    if (typeof container === 'string') {
+        const el = document.querySelector(container);
+        if (!el)
+            throw new Error(`[Nova Avatar] Container not found: ${container}`);
+        return el;
+    }
+    return container;
+}
+/** Create a circular avatar with image and initials fallback. */
+export function createAvatar(container, options = {}) {
+    const { src, name = '', size = 40, fallback, alt, } = options;
+    let destroyed = false;
+    injectStyles();
+    const wrapper = document.createElement('span');
+    wrapper.className = 'nova-avatar';
+    wrapper.setAttribute('role', 'img');
+    wrapper.setAttribute('aria-label', alt || name || 'Avatar');
+    wrapper.style.width = `${size}px`;
+    wrapper.style.height = `${size}px`;
+    wrapper.style.fontSize = `${Math.round(size * 0.4)}px`;
+    // Compute deterministic background from name
+    if (name) {
+        const hue = nameToHue(name);
+        wrapper.style.backgroundColor = `hsl(${hue}, 55%, 45%)`;
+    }
+    const initialsText = fallback || getInitials(name) || '?';
+    let imgEl = null;
+    function showInitials() {
+        if (imgEl) {
+            imgEl.remove();
+            imgEl = null;
+        }
+        // Only set text if not already showing
+        if (!wrapper.textContent) {
+            wrapper.textContent = initialsText;
+        }
+    }
+    function loadImage(url) {
+        // Clear any initials text
+        wrapper.textContent = '';
+        imgEl = document.createElement('img');
+        imgEl.className = 'nova-avatar__img';
+        imgEl.alt = alt || name || 'Avatar';
+        imgEl.src = url;
+        imgEl.addEventListener('error', () => {
+            showInitials();
+        }, { once: true });
+        wrapper.appendChild(imgEl);
+    }
+    if (src) {
+        loadImage(src);
+    }
+    else {
+        showInitials();
+    }
+    const parent = resolveContainer(container);
+    parent.appendChild(wrapper);
+    return {
+        setSrc(newSrc) {
+            if (destroyed)
+                return;
+            loadImage(newSrc);
+        },
+        destroy() {
+            if (destroyed)
+                return;
+            destroyed = true;
+            wrapper.remove();
+        },
+    };
+}
+//# sourceMappingURL=avatar.js.map

package/dist/avatar/avatar.js.map

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

package/dist/avatar/index.d.ts

@@ -0,0 +1,3 @@
+export { createAvatar } from './avatar';
+export type { AvatarOptions, AvatarInstance } from './avatar';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/avatar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/avatar/index.js

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

package/dist/avatar/index.js.map

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

package/dist/badge/badge.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Nova Engine — Badge
+ *
+ * Inline status indicator with semantic color variants,
+ * configurable sizes, and optional pill shape.
+ */
+export interface BadgeOptions {
+    /** Text content displayed inside the badge */
+    text: string;
+    /** Semantic color variant. Default: 'default' */
+    variant?: 'default' | 'primary' | 'success' | 'warning' | 'error';
+    /** Badge size. Default: 'md' */
+    size?: 'sm' | 'md' | 'lg';
+    /** Use fully rounded pill shape. Default: false */
+    rounded?: boolean;
+}
+export interface BadgeInstance {
+    /** Update the badge text */
+    setText(text: string): void;
+    /** Update the badge variant */
+    setVariant(variant: BadgeOptions['variant']): void;
+    /** Remove the badge from DOM and clean up */
+    destroy(): void;
+}
+/** Create an inline badge indicator. */
+export declare function createBadge(container: string | HTMLElement, options: BadgeOptions): BadgeInstance;
+//# sourceMappingURL=badge.d.ts.map

package/dist/badge/badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../src/badge/badge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAClE,gCAAgC;IAChC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,+BAA+B;IAC/B,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IACnD,6CAA6C;IAC7C,OAAO,IAAI,IAAI,CAAC;CACjB;AAuED,wCAAwC;AACxC,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,GAAG,WAAW,EAC/B,OAAO,EAAE,YAAY,GACpB,aAAa,CAoDf"}

package/dist/badge/badge.js

@@ -0,0 +1,118 @@
+/**
+ * Nova Engine — Badge
+ *
+ * Inline status indicator with semantic color variants,
+ * configurable sizes, and optional pill shape.
+ */
+const STYLE_ID = 'nova-badge-styles';
+const VARIANT_COLORS = {
+    default: {
+        bg: 'var(--color-bg-elevated, rgba(255, 255, 255, 0.08))',
+        text: 'var(--color-text-primary, #e5e5e5)',
+        border: 'var(--color-border, rgba(255, 255, 255, 0.08))',
+    },
+    primary: {
+        bg: 'var(--color-badge-primary-bg, rgba(167, 139, 250, 0.15))',
+        text: 'var(--color-badge-primary-text, #a78bfa)',
+        border: 'var(--color-badge-primary-border, rgba(167, 139, 250, 0.25))',
+    },
+    success: {
+        bg: 'var(--color-badge-success-bg, rgba(34, 197, 94, 0.15))',
+        text: 'var(--color-badge-success-text, #22c55e)',
+        border: 'var(--color-badge-success-border, rgba(34, 197, 94, 0.25))',
+    },
+    warning: {
+        bg: 'var(--color-badge-warning-bg, rgba(245, 158, 11, 0.15))',
+        text: 'var(--color-badge-warning-text, #f59e0b)',
+        border: 'var(--color-badge-warning-border, rgba(245, 158, 11, 0.25))',
+    },
+    error: {
+        bg: 'var(--color-badge-error-bg, rgba(239, 68, 68, 0.15))',
+        text: 'var(--color-badge-error-text, #ef4444)',
+        border: 'var(--color-badge-error-border, rgba(239, 68, 68, 0.25))',
+    },
+};
+const SIZE_MAP = {
+    sm: { height: '20px', fontSize: '11px', padding: '0 6px' },
+    md: { height: '24px', fontSize: '12px', padding: '0 8px' },
+    lg: { height: '28px', fontSize: '13px', padding: '0 10px' },
+};
+function injectStyles() {
+    if (document.getElementById(STYLE_ID))
+        return;
+    const s = document.createElement('style');
+    s.id = STYLE_ID;
+    s.textContent = `
+.nova-badge {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  font-weight: 500;
+  line-height: 1;
+  white-space: nowrap;
+  border: 1px solid;
+  vertical-align: middle;
+  box-sizing: border-box;
+  border-radius: 6px;
+}
+.nova-badge--rounded {
+  border-radius: 9999px;
+}`;
+    document.head.appendChild(s);
+}
+function resolveContainer(container) {
+    if (typeof container === 'string') {
+        const el = document.querySelector(container);
+        if (!el)
+            throw new Error(`[Nova Badge] Container not found: ${container}`);
+        return el;
+    }
+    return container;
+}
+/** Create an inline badge indicator. */
+export function createBadge(container, options) {
+    const { text, variant = 'default', size = 'md', rounded = false, } = options;
+    let destroyed = false;
+    let currentVariant = variant;
+    injectStyles();
+    const el = document.createElement('span');
+    el.className = 'nova-badge';
+    if (rounded)
+        el.classList.add('nova-badge--rounded');
+    el.textContent = text;
+    // Apply size
+    const sizeStyles = SIZE_MAP[size] || SIZE_MAP.md;
+    el.style.height = sizeStyles.height;
+    el.style.fontSize = sizeStyles.fontSize;
+    el.style.padding = sizeStyles.padding;
+    function applyVariant(v) {
+        const colors = VARIANT_COLORS[v] || VARIANT_COLORS.default;
+        el.style.backgroundColor = colors.bg;
+        el.style.color = colors.text;
+        el.style.borderColor = colors.border;
+    }
+    applyVariant(currentVariant);
+    const parent = resolveContainer(container);
+    parent.appendChild(el);
+    return {
+        setText(newText) {
+            if (destroyed)
+                return;
+            el.textContent = newText;
+        },
+        setVariant(newVariant) {
+            if (destroyed)
+                return;
+            currentVariant = newVariant || 'default';
+            applyVariant(currentVariant);
+        },
+        destroy() {
+            if (destroyed)
+                return;
+            destroyed = true;
+            el.remove();
+        },
+    };
+}
+//# sourceMappingURL=badge.js.map

package/dist/badge/badge.js.map

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

package/dist/badge/index.d.ts

@@ -0,0 +1,3 @@
+export { createBadge } from './badge';
+export type { BadgeOptions, BadgeInstance } from './badge';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/badge/index.js

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

package/dist/badge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":[""],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}