@mappoh/nova 0.3.0 → 0.5.0

package/dist/switch/switch.js

@@ -0,0 +1,163 @@
+/**
+ * Nova Engine — Switch / Toggle
+ *
+ * Accessible toggle switch with animated thumb, keyboard interaction,
+ * ARIA roles, and CSS custom property theming.
+ */
+/* ---- Injected styles ---- */
+const STYLE_ID = 'nova-switch-styles';
+function injectStyles() {
+    if (document.getElementById(STYLE_ID))
+        return;
+    const s = document.createElement('style');
+    s.id = STYLE_ID;
+    s.textContent = `
+.nova-switch {
+  display: inline-flex;
+  align-items: center;
+  gap: 10px;
+  cursor: pointer;
+  -webkit-tap-highlight-color: transparent;
+  user-select: none;
+}
+.nova-switch--disabled {
+  cursor: not-allowed;
+  opacity: 0.5;
+}
+.nova-switch__track {
+  position: relative;
+  width: 44px;
+  height: 24px;
+  border-radius: 12px;
+  background: var(--color-switch-track, rgba(255, 255, 255, 0.12));
+  border: 1px solid var(--color-border, rgba(255, 255, 255, 0.08));
+  transition: background 0.2s ease, border-color 0.2s ease;
+  flex-shrink: 0;
+}
+.nova-switch__track--checked {
+  background: var(--color-accent, #a78bfa);
+  border-color: var(--color-accent, #a78bfa);
+}
+.nova-switch__thumb {
+  position: absolute;
+  top: 2px;
+  left: 2px;
+  width: 18px;
+  height: 18px;
+  border-radius: 50%;
+  background: var(--color-switch-thumb, #fff);
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);
+  transition: transform 0.2s ease;
+}
+.nova-switch__track--checked .nova-switch__thumb {
+  transform: translateX(20px);
+}
+.nova-switch__label {
+  font: 14px/1.5 -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  color: var(--color-text-primary, #e5e5e5);
+}
+.nova-switch:focus-visible .nova-switch__track {
+  outline: 2px solid var(--color-accent, #a78bfa);
+  outline-offset: 2px;
+}
+@media (prefers-reduced-motion: reduce) {
+  .nova-switch__thumb,
+  .nova-switch__track { transition: none; }
+}`;
+    document.head.appendChild(s);
+}
+/* ---- Resolve container ---- */
+function resolveContainer(container) {
+    if (typeof container === 'string') {
+        const el = document.querySelector(container);
+        if (!el)
+            throw new Error(`[Nova Switch] Container not found: ${container}`);
+        return el;
+    }
+    return container;
+}
+/* ---- Factory ---- */
+/** Create an accessible toggle switch. */
+export function createSwitch(container, options = {}) {
+    const { checked: initialChecked = false, label, disabled = false, onChange, } = options;
+    const root = resolveContainer(container);
+    let destroyed = false;
+    let checked = initialChecked;
+    let isDisabled = disabled;
+    injectStyles();
+    // --- DOM construction ---
+    const el = document.createElement('div');
+    el.className = 'nova-switch' + (isDisabled ? ' nova-switch--disabled' : '');
+    el.setAttribute('role', 'switch');
+    el.setAttribute('aria-checked', String(checked));
+    el.setAttribute('tabindex', isDisabled ? '-1' : '0');
+    if (label)
+        el.setAttribute('aria-label', label);
+    const track = document.createElement('div');
+    track.className = 'nova-switch__track' + (checked ? ' nova-switch__track--checked' : '');
+    const thumb = document.createElement('div');
+    thumb.className = 'nova-switch__thumb';
+    track.appendChild(thumb);
+    el.appendChild(track);
+    if (label) {
+        const labelEl = document.createElement('span');
+        labelEl.className = 'nova-switch__label';
+        labelEl.textContent = label;
+        el.appendChild(labelEl);
+    }
+    root.appendChild(el);
+    // --- Toggle logic ---
+    function toggle() {
+        if (destroyed || isDisabled)
+            return;
+        checked = !checked;
+        el.setAttribute('aria-checked', String(checked));
+        if (checked) {
+            track.classList.add('nova-switch__track--checked');
+        }
+        else {
+            track.classList.remove('nova-switch__track--checked');
+        }
+        onChange?.(checked);
+    }
+    // --- Event listeners ---
+    const listeners = [];
+    function on(target, evt, fn) {
+        target.addEventListener(evt, fn);
+        listeners.push([target, evt, fn]);
+    }
+    on(el, 'click', () => toggle());
+    on(el, 'keydown', ((e) => {
+        if (e.key === ' ' || e.key === 'Enter') {
+            e.preventDefault();
+            toggle();
+        }
+    }));
+    // --- Instance ---
+    return {
+        getValue() {
+            return checked;
+        },
+        setValue(value) {
+            if (destroyed || value === checked)
+                return;
+            checked = value;
+            el.setAttribute('aria-checked', String(checked));
+            if (checked) {
+                track.classList.add('nova-switch__track--checked');
+            }
+            else {
+                track.classList.remove('nova-switch__track--checked');
+            }
+        },
+        destroy() {
+            if (destroyed)
+                return;
+            destroyed = true;
+            for (const [t, e, fn] of listeners)
+                t.removeEventListener(e, fn);
+            el.remove();
+        },
+    };
+}
+//# sourceMappingURL=switch.js.map

package/dist/switch/switch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.js","sourceRoot":"","sources":[""],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,+BAA+B;AAE/B,MAAM,QAAQ,GAAG,oBAAoB,CAAC;AAEtC,SAAS,YAAY;IACnB,IAAI,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC;QAAE,OAAO;IAC9C,MAAM,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC;IAChB,CAAC,CAAC,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDhB,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,iCAAiC;AAEjC,SAAS,gBAAgB,CAAC,SAA+B;IACvD,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAc,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,SAAS,EAAE,CAAC,CAAC;QAC5E,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,uBAAuB;AAEvB,0CAA0C;AAC1C,MAAM,UAAU,YAAY,CAC1B,SAA+B,EAC/B,UAAyB,EAAE;IAE3B,MAAM,EACJ,OAAO,EAAE,cAAc,GAAG,KAAK,EAC/B,KAAK,EACL,QAAQ,GAAG,KAAK,EAChB,QAAQ,GACT,GAAG,OAAO,CAAC;IAEZ,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,OAAO,GAAG,cAAc,CAAC;IAC7B,IAAI,UAAU,GAAG,QAAQ,CAAC;IAE1B,YAAY,EAAE,CAAC;IAEf,2BAA2B;IAE3B,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACzC,EAAE,CAAC,SAAS,GAAG,aAAa,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5E,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClC,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,KAAK;QAAE,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAEhD,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC5C,KAAK,CAAC,SAAS,GAAG,oBAAoB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEzF,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC5C,KAAK,CAAC,SAAS,GAAG,oBAAoB,CAAC;IAEvC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACzB,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAEtB,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,CAAC,SAAS,GAAG,oBAAoB,CAAC;QACzC,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC;QAC5B,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAErB,uBAAuB;IAEvB,SAAS,MAAM;QACb,IAAI,SAAS,IAAI,UAAU;YAAE,OAAO;QACpC,OAAO,GAAG,CAAC,OAAO,CAAC;QACnB,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACjD,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAAC;QACxD,CAAC;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,0BAA0B;IAE1B,MAAM,SAAS,GAAgD,EAAE,CAAC;IAClE,SAAS,EAAE,CAAC,MAAmB,EAAE,GAAW,EAAE,EAAiB;QAC7D,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACjC,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IAEhC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAgB,EAAE,EAAE;QACtC,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;YACvC,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAkB,CAAC,CAAC;IAErB,mBAAmB;IAEnB,OAAO;QACL,QAAQ;YACN,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,QAAQ,CAAC,KAAc;YACrB,IAAI,SAAS,IAAI,KAAK,KAAK,OAAO;gBAAE,OAAO;YAC3C,OAAO,GAAG,KAAK,CAAC;YAChB,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YACjD,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;YACrD,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QACD,OAAO;YACL,IAAI,SAAS;gBAAE,OAAO;YACtB,SAAS,GAAG,IAAI,CAAC;YACjB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,SAAS;gBAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjE,EAAE,CAAC,MAAM,EAAE,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/theme/index.d.ts

@@ -1,3 +1,5 @@
 export { createTheme } from './theme';
 export type { ThemeOptions, ThemeInstance } from './theme';
+export { createScale } from './scale';
+export type { ScaleOptions, ScaleInstance } from './scale';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/theme/index.js

@@ -1,2 +1,3 @@
 export { createTheme } from './theme';
+export { createScale } from './scale';
 //# sourceMappingURL=index.js.map

package/dist/theme/index.js.map

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

package/dist/theme/scale.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Nova Engine — Type Scale
+ *
+ * Mathematical font-size scale generator using CSS custom properties.
+ * Replaces manual `_applyFontSize()` patterns with a systematic approach.
+ */
+export interface ScaleOptions {
+    /** Base font size in px. Default: 16 */
+    base?: number;
+    /** Scale ratio (e.g. 1.125 minor second, 1.25 major third, 1.333 perfect fourth). Default: 1.25 */
+    ratio?: number;
+    /** Number of scale steps above base. Default: 6 */
+    steps?: number;
+    /** CSS variable prefix. Default: '--font-size' */
+    prefix?: string;
+    /** Target element to apply CSS vars. Default: document.documentElement */
+    target?: HTMLElement;
+}
+export interface ScaleInstance {
+    /** Get the computed size for a step (positive = larger, negative = smaller) */
+    get(step: number): string;
+    /** Re-apply all CSS custom properties to the target */
+    apply(): void;
+    /** Update the base size and re-apply */
+    setBase(px: number): void;
+    /** Update the ratio and re-apply */
+    setRatio(ratio: number): void;
+    /** Remove all applied CSS custom properties */
+    destroy(): void;
+}
+/**
+ * Create a mathematical type scale that sets CSS custom properties.
+ *
+ * Generated variables (with default prefix):
+ *   --font-size-sm-2, --font-size-sm-1
+ *   --font-size-base
+ *   --font-size-lg-1 through --font-size-lg-{steps}
+ */
+export declare function createScale(options?: ScaleOptions): ScaleInstance;
+//# sourceMappingURL=scale.d.ts.map

package/dist/theme/scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale.d.ts","sourceRoot":"","sources":["../../src/theme/scale.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,uDAAuD;IACvD,KAAK,IAAI,IAAI,CAAC;IACd,wCAAwC;IACxC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,+CAA+C;IAC/C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,YAAiB,GAAG,aAAa,CAyDrE"}

package/dist/theme/scale.js

@@ -0,0 +1,62 @@
+/**
+ * Nova Engine — Type Scale
+ *
+ * Mathematical font-size scale generator using CSS custom properties.
+ * Replaces manual `_applyFontSize()` patterns with a systematic approach.
+ */
+/**
+ * Create a mathematical type scale that sets CSS custom properties.
+ *
+ * Generated variables (with default prefix):
+ *   --font-size-sm-2, --font-size-sm-1
+ *   --font-size-base
+ *   --font-size-lg-1 through --font-size-lg-{steps}
+ */
+export function createScale(options = {}) {
+    let { base = 16, ratio = 1.25, } = options;
+    const { steps = 6, prefix = '--font-size', target = document.documentElement, } = options;
+    function compute(step) {
+        return step >= 0
+            ? base * Math.pow(ratio, step)
+            : base / Math.pow(ratio, Math.abs(step));
+    }
+    function apply() {
+        target.style.setProperty(`${prefix}-base`, `${base}px`);
+        // Smaller steps
+        for (let i = 1; i <= 2; i++) {
+            target.style.setProperty(`${prefix}-sm-${i}`, `${compute(-i).toFixed(2)}px`);
+        }
+        // Larger steps
+        for (let i = 1; i <= steps; i++) {
+            target.style.setProperty(`${prefix}-lg-${i}`, `${compute(i).toFixed(2)}px`);
+        }
+        // Also set a --font-scale var for easy multiplication
+        target.style.setProperty(`${prefix}-scale`, String(base / 16));
+    }
+    apply();
+    return {
+        get(step) {
+            return `${compute(step).toFixed(2)}px`;
+        },
+        apply,
+        setBase(px) {
+            base = px;
+            apply();
+        },
+        setRatio(r) {
+            ratio = r;
+            apply();
+        },
+        destroy() {
+            target.style.removeProperty(`${prefix}-base`);
+            target.style.removeProperty(`${prefix}-scale`);
+            for (let i = 1; i <= 2; i++) {
+                target.style.removeProperty(`${prefix}-sm-${i}`);
+            }
+            for (let i = 1; i <= steps; i++) {
+                target.style.removeProperty(`${prefix}-lg-${i}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=scale.js.map

package/dist/theme/scale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale.js","sourceRoot":"","sources":[""],"names":[],"mappings":"AAAA;;;;;GAKG;AA4BH;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,UAAwB,EAAE;IACpD,IAAI,EACF,IAAI,GAAG,EAAE,EACT,KAAK,GAAG,IAAI,GACb,GAAG,OAAO,CAAC;IACZ,MAAM,EACJ,KAAK,GAAG,CAAC,EACT,MAAM,GAAG,aAAa,EACtB,MAAM,GAAG,QAAQ,CAAC,eAAe,GAClC,GAAG,OAAO,CAAC;IAEZ,SAAS,OAAO,CAAC,IAAY;QAC3B,OAAO,IAAI,IAAI,CAAC;YACd,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC;YAC9B,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,SAAS,KAAK;QACZ,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,MAAM,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC;QACxD,gBAAgB;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/E,CAAC;QACD,eAAe;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9E,CAAC;QACD,sDAAsD;QACtD,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,MAAM,QAAQ,EAAE,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,EAAE,CAAC;IAER,OAAO;QACL,GAAG,CAAC,IAAY;YACd,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACzC,CAAC;QACD,KAAK;QACL,OAAO,CAAC,EAAU;YAChB,IAAI,GAAG,EAAE,CAAC;YACV,KAAK,EAAE,CAAC;QACV,CAAC;QACD,QAAQ,CAAC,CAAS;YAChB,KAAK,GAAG,CAAC,CAAC;YACV,KAAK,EAAE,CAAC;QACV,CAAC;QACD,OAAO;YACL,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,CAAC;YAC9C,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,MAAM,QAAQ,CAAC,CAAC;YAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5B,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Nova Engine — Utility Functions
+ *
+ * Common helpers: debounce, throttle, deepEqual, clamp, lerp, remap, uniqueId.
+ */
+/**
+ * Debounce a function: delays invocation until `ms` milliseconds after the
+ * last call. Returns a debounced function with a `.cancel()` method.
+ */
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, ms: number): T & {
+    cancel(): void;
+};
+/**
+ * Throttle a function: ensures it is called at most once every `ms` milliseconds.
+ */
+export declare function throttle<T extends (...args: any[]) => any>(fn: T, ms: number): T;
+/**
+ * Deep equality comparison for primitives, plain objects, arrays, Date, RegExp, Map, and Set.
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+/** Clamp a value between min and max. */
+export declare function clamp(value: number, min: number, max: number): number;
+/** Linear interpolation between a and b by factor t (0..1). */
+export declare function lerp(a: number, b: number, t: number): number;
+/** Remap a value from one range to another. */
+export declare function remap(value: number, inMin: number, inMax: number, outMin: number, outMax: number): number;
+/** Generate a unique ID string, optionally prefixed. */
+export declare function uniqueId(prefix?: string): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,EAAE,EAAE,MAAM,GACT,CAAC,GAAG;IAAE,MAAM,IAAI,IAAI,CAAA;CAAE,CAaxB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,CAoBhF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAsCzD;AAED,yCAAyC;AACzC,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,+DAA+D;AAC/D,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,+CAA+C;AAC/C,wBAAgB,KAAK,CACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,CAER;AAID,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,MAAM,SAAS,GAAG,MAAM,CAEhD"}

package/dist/utils/index.js

@@ -0,0 +1,114 @@
+/**
+ * Nova Engine — Utility Functions
+ *
+ * Common helpers: debounce, throttle, deepEqual, clamp, lerp, remap, uniqueId.
+ */
+/**
+ * Debounce a function: delays invocation until `ms` milliseconds after the
+ * last call. Returns a debounced function with a `.cancel()` method.
+ */
+export function debounce(fn, ms) {
+    let timer;
+    const debounced = function (...args) {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        timer = setTimeout(() => { timer = undefined; fn.apply(this, args); }, ms);
+    };
+    debounced.cancel = () => {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+            timer = undefined;
+        }
+    };
+    return debounced;
+}
+/**
+ * Throttle a function: ensures it is called at most once every `ms` milliseconds.
+ */
+export function throttle(fn, ms) {
+    let last = 0;
+    let timer;
+    return function (...args) {
+        const now = Date.now();
+        const remaining = ms - (now - last);
+        if (remaining <= 0) {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+            last = now;
+            fn.apply(this, args);
+        }
+        else if (timer === undefined) {
+            timer = setTimeout(() => {
+                last = Date.now();
+                timer = undefined;
+                fn.apply(this, args);
+            }, remaining);
+        }
+    };
+}
+/**
+ * Deep equality comparison for primitives, plain objects, arrays, Date, RegExp, Map, and Set.
+ */
+export function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a == null || b == null)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (a instanceof Date && b instanceof Date)
+        return a.getTime() === b.getTime();
+    if (a instanceof RegExp && b instanceof RegExp)
+        return a.toString() === b.toString();
+    if (Array.isArray(a)) {
+        if (!Array.isArray(b) || a.length !== b.length)
+            return false;
+        return a.every((v, i) => deepEqual(v, b[i]));
+    }
+    if (a instanceof Map && b instanceof Map) {
+        if (a.size !== b.size)
+            return false;
+        for (const [k, v] of a) {
+            if (!b.has(k) || !deepEqual(v, b.get(k)))
+                return false;
+        }
+        return true;
+    }
+    if (a instanceof Set && b instanceof Set) {
+        if (a.size !== b.size)
+            return false;
+        for (const v of a)
+            if (!b.has(v))
+                return false;
+        return true;
+    }
+    if (typeof a === 'object' && typeof b === 'object') {
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        if (keysA.length !== keysB.length)
+            return false;
+        return keysA.every((k) => Object.prototype.hasOwnProperty.call(b, k) &&
+            deepEqual(a[k], b[k]));
+    }
+    return false;
+}
+/** Clamp a value between min and max. */
+export function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+/** Linear interpolation between a and b by factor t (0..1). */
+export function lerp(a, b, t) {
+    return a + (b - a) * t;
+}
+/** Remap a value from one range to another. */
+export function remap(value, inMin, inMax, outMin, outMax) {
+    return outMin + ((value - inMin) / (inMax - inMin)) * (outMax - outMin);
+}
+let _idCounter = 0;
+/** Generate a unique ID string, optionally prefixed. */
+export function uniqueId(prefix = 'nova') {
+    return `${prefix}-${++_idCounter}-${Math.random().toString(36).slice(2, 7)}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

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

package/dist/websocket/index.d.ts

@@ -0,0 +1,3 @@
+export { createWebSocket } from './websocket';
+export type { WebSocketOptions, WebSocketState, WebSocketInstance } from './websocket';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/websocket/index.js

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

package/dist/websocket/index.js.map

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

package/dist/websocket/websocket.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Nova Engine — WebSocket Client
+ *
+ * Typed reconnecting WebSocket with heartbeat, exponential backoff, and event routing.
+ */
+export interface WebSocketOptions {
+    url: string;
+    protocols?: string[];
+    /** Enable automatic reconnection. Default: true */
+    reconnect?: boolean;
+    /** Maximum reconnection attempts. Default: 5 */
+    maxRetries?: number;
+    /** Base delay between reconnection attempts in ms. Default: 1000 */
+    retryDelay?: number;
+    /** Heartbeat ping interval in ms. 0 disables heartbeat. Default: 0 */
+    heartbeat?: number;
+    onOpen?: () => void;
+    onClose?: (code: number) => void;
+    onError?: (error: Event) => void;
+}
+export type WebSocketState = 'connecting' | 'open' | 'closing' | 'closed';
+export interface WebSocketInstance<T = unknown> {
+    send(data: T): void;
+    on(event: string, handler: (data: unknown) => void): () => void;
+    close(): void;
+    readonly state: WebSocketState;
+    subscribe(fn: (state: WebSocketState) => void): () => void;
+}
+/** Create a reconnecting WebSocket client with heartbeat and event routing. */
+export declare function createWebSocket<T = unknown>(options: WebSocketOptions): WebSocketInstance<T>;
+//# sourceMappingURL=websocket.d.ts.map

package/dist/websocket/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/websocket/websocket.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1E,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAChE,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5D;AAYD,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EACzC,OAAO,EAAE,gBAAgB,GACxB,iBAAiB,CAAC,CAAC,CAAC,CAwLtB"}