@mappoh/nova 0.1.16

package/dist/canvas/sequence.js.map

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

package/dist/component/bind.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Nova Engine — Signal-to-Part Binding
+ *
+ * Bridges the signal system (@nova/store) with the template parts engine.
+ * Usage: html`<span>${bind(count)}</span>` — signal changes update that
+ * DOM node directly without triggering render().
+ */
+import type { Signal, Computed } from '../store/store';
+/** Marker class recognized by NodePart and AttributePart in template.ts */
+export declare class SignalBinding<T = unknown> {
+    readonly signal: Signal<T> | Computed<T>;
+    constructor(signal: Signal<T> | Computed<T>);
+}
+/**
+ * Bind a signal to a template Part.
+ *
+ * When the signal changes, the Part updates directly — no render() call,
+ * no _scheduleRender(), no diffing. One signal change = one DOM mutation.
+ *
+ * Works in both node and attribute positions:
+ *   html`<span>${bind(count)}</span>`          — updates text node
+ *   html`<div class=${bind(activeClass)}></div>` — updates attribute
+ */
+export declare function bind<T>(signal: Signal<T> | Computed<T>): SignalBinding<T>;
+//# sourceMappingURL=bind.d.ts.map

package/dist/component/bind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.d.ts","sourceRoot":"","sources":["../../src/component/bind.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEvD,2EAA2E;AAC3E,qBAAa,aAAa,CAAC,CAAC,GAAG,OAAO;aACR,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;gBAA/B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;CAC5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAEzE"}

package/dist/component/bind.js

@@ -0,0 +1,28 @@
+/**
+ * Nova Engine — Signal-to-Part Binding
+ *
+ * Bridges the signal system (@nova/store) with the template parts engine.
+ * Usage: html`<span>${bind(count)}</span>` — signal changes update that
+ * DOM node directly without triggering render().
+ */
+/** Marker class recognized by NodePart and AttributePart in template.ts */
+export class SignalBinding {
+    signal;
+    constructor(signal) {
+        this.signal = signal;
+    }
+}
+/**
+ * Bind a signal to a template Part.
+ *
+ * When the signal changes, the Part updates directly — no render() call,
+ * no _scheduleRender(), no diffing. One signal change = one DOM mutation.
+ *
+ * Works in both node and attribute positions:
+ *   html`<span>${bind(count)}</span>`          — updates text node
+ *   html`<div class=${bind(activeClass)}></div>` — updates attribute
+ */
+export function bind(signal) {
+    return new SignalBinding(signal);
+}
+//# sourceMappingURL=bind.js.map

package/dist/component/bind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.js","sourceRoot":"","sources":["../../src/component/bind.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,2EAA2E;AAC3E,MAAM,OAAO,aAAa;IACI;IAA5B,YAA4B,MAA+B;QAA/B,WAAM,GAAN,MAAM,CAAyB;IAAG,CAAC;CAChE;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,IAAI,CAAI,MAA+B;IACrD,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}

package/dist/component/component.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Nova Engine — Base Component
+ *
+ * Web Components foundation with reactive state, props, and lifecycle hooks.
+ * Every UI element extends this class.
+ *
+ * Rendering: Uses the template parts engine for surgical DOM updates.
+ * Same template → update only changed Parts. New template → dispose + recreate.
+ * Falls back to innerHTML for SafeHTML (backward compat).
+ */
+import { SafeHTML } from './html';
+import { TemplateResult } from './template';
+export type PropType = typeof String | typeof Number | typeof Boolean;
+export interface PropDefinition {
+    type: PropType;
+    default?: unknown;
+}
+export declare abstract class Component extends HTMLElement {
+    /** Override in subclass: e.g. static tag = 'hero-section' */
+    static tag: string;
+    /** Override in subclass: prop definitions with types */
+    static props: Record<string, PropType | PropDefinition>;
+    /** Override in subclass: CSS styles (scoped in Shadow DOM, ignored in Light DOM) */
+    static styles: string;
+    /** Override to disable Shadow DOM. Light DOM components use global styles. Default: true */
+    static shadow: boolean;
+    /** Internal reactive state */
+    protected _state: Record<string, unknown>;
+    /** Proxy-wrapped state that triggers re-renders on mutation */
+    protected state: Record<string, unknown>;
+    /** Resolved prop values */
+    protected props: Record<string, unknown>;
+    private _root;
+    private _mounted;
+    private _renderScheduled;
+    private _cleanups;
+    private _instance;
+    private _styleInjected;
+    constructor();
+    /** Web Components: observed attributes from prop definitions */
+    static get observedAttributes(): string[];
+    /** Parse attribute value based on prop type */
+    private _parseProp;
+    /** Sync all attributes to props */
+    private _syncProps;
+    /** Schedule a microtask re-render (batches multiple state changes) */
+    protected _scheduleRender(): void;
+    /** Inject scoped <style> once into shadow root */
+    private _ensureStyles;
+    /** Perform the actual DOM update */
+    private _performRender;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /** Return the component's HTML (TemplateResult for surgical updates, SafeHTML for innerHTML fallback) */
+    abstract render(): TemplateResult | SafeHTML;
+    /** Called after first render and DOM attachment */
+    onMount(): void;
+    /** Called after re-renders (state or prop changes) */
+    onUpdate(): void;
+    /** Called when component is removed from DOM */
+    onDestroy(): void;
+    /** Register a cleanup function to run on disconnect (used by useStore/useSignal/useEffect) */
+    _addCleanup(fn: () => void): void;
+    /** Query within shadow DOM */
+    protected $(selector: string): Element | null;
+    /** Query all within shadow DOM */
+    protected $$(selector: string): Element[];
+    /** Emit a custom event */
+    protected emit(name: string, detail?: unknown): void;
+    /** Register a component class as a custom element */
+    static define(): void;
+}
+export { html, raw } from './html';
+export { TemplateResult } from './template';
+//# sourceMappingURL=component.d.ts.map

package/dist/component/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/component/component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,cAAc,EAAoC,MAAM,YAAY,CAAC;AAE9E,MAAM,MAAM,QAAQ,GAAG,OAAO,MAAM,GAAG,OAAO,MAAM,GAAG,OAAO,OAAO,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAOD,8BAAsB,SAAU,SAAQ,WAAW;IACjD,6DAA6D;IAC7D,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,cAAc,CAAC,CAAM;IAE7D,oFAAoF;IACpF,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAE3B,4FAA4F;IAC5F,MAAM,CAAC,MAAM,EAAE,OAAO,CAAQ;IAE9B,8BAA8B;IAC9B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAE/C,+DAA+D;IAC/D,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC,2BAA2B;IAC3B,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAE9C,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,cAAc,CAAS;;IAmB/B,gEAAgE;IAChE,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,+CAA+C;IAC/C,OAAO,CAAC,UAAU;IAqBlB,mCAAmC;IACnC,OAAO,CAAC,UAAU;IAOlB,sEAAsE;IACtE,SAAS,CAAC,eAAe,IAAI,IAAI;IAUjC,kDAAkD;IAClD,OAAO,CAAC,aAAa;IAYrB,oCAAoC;IACpC,OAAO,CAAC,cAAc;IAiDtB,iBAAiB,IAAI,IAAI;IAOzB,oBAAoB,IAAI,IAAI;IAW5B,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAQ9F,yGAAyG;IACzG,QAAQ,CAAC,MAAM,IAAI,cAAc,GAAG,QAAQ;IAE5C,mDAAmD;IACnD,OAAO,IAAI,IAAI;IAEf,sDAAsD;IACtD,QAAQ,IAAI,IAAI;IAEhB,gDAAgD;IAChD,SAAS,IAAI,IAAI;IAIjB,8FAA8F;IAC9F,WAAW,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAIjC,8BAA8B;IAC9B,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAI7C,kCAAkC;IAClC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE;IAIzC,0BAA0B;IAC1B,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAIpD,qDAAqD;IACrD,MAAM,CAAC,MAAM,IAAI,IAAI;CAKtB;AAGD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/component/component.js

@@ -0,0 +1,219 @@
+/**
+ * Nova Engine — Base Component
+ *
+ * Web Components foundation with reactive state, props, and lifecycle hooks.
+ * Every UI element extends this class.
+ *
+ * Rendering: Uses the template parts engine for surgical DOM updates.
+ * Same template → update only changed Parts. New template → dispose + recreate.
+ * Falls back to innerHTML for SafeHTML (backward compat).
+ */
+import { SafeHTML } from './html';
+import { TemplateResult, createInstance } from './template';
+/** Shadow DOM base reset — mirrors the document-level reset.css for encapsulated components.
+ *  NOTE: `*` must NOT set margin/padding — it bleeds into child custom elements' :host
+ *  styles via the encapsulation context cascade (outer styles beat :host). */
+const SHADOW_RESET = `:host{box-sizing:border-box}*,*::before,*::after{box-sizing:border-box}h1,h2,h3,h4,h5,h6,p,figure,blockquote,pre{margin:0}ul,ol{margin:0;padding:0;list-style:none}a{color:inherit;text-decoration:none}button{cursor:pointer;border:none;background:none;margin:0;padding:0}input,button,textarea,select{font:inherit;color:inherit}h1,h2,h3,h4,h5,h6{overflow-wrap:break-word;font-weight:inherit;font-size:inherit}p{overflow-wrap:break-word}img,picture,video,canvas,svg{display:block;max-width:100%}`;
+export class Component extends HTMLElement {
+    /** Override in subclass: e.g. static tag = 'hero-section' */
+    static tag;
+    /** Override in subclass: prop definitions with types */
+    static props = {};
+    /** Override in subclass: CSS styles (scoped in Shadow DOM, ignored in Light DOM) */
+    static styles = '';
+    /** Override to disable Shadow DOM. Light DOM components use global styles. Default: true */
+    static shadow = true;
+    /** Internal reactive state */
+    _state = {};
+    /** Proxy-wrapped state that triggers re-renders on mutation */
+    state;
+    /** Resolved prop values */
+    props = {};
+    _root;
+    _mounted = false;
+    _renderScheduled = false;
+    _cleanups = [];
+    _instance = null;
+    _styleInjected = false;
+    constructor() {
+        super();
+        const ctor = this.constructor;
+        this._root = ctor.shadow ? this.attachShadow({ mode: 'open' }) : this;
+        // Wrap state in Proxy for reactivity
+        this.state = new Proxy(this._state, {
+            set: (target, key, value) => {
+                const old = target[key];
+                if (old === value)
+                    return true;
+                target[key] = value;
+                this._scheduleRender();
+                return true;
+            },
+        });
+    }
+    /** Web Components: observed attributes from prop definitions */
+    static get observedAttributes() {
+        return Object.keys(this.props);
+    }
+    /** Parse attribute value based on prop type */
+    _parseProp(name, value) {
+        const ctor = this.constructor;
+        const def = ctor.props[name];
+        const type = typeof def === 'function' ? def : def.type;
+        if (value === null) {
+            if (typeof def === 'object' && 'default' in def)
+                return def.default;
+            if (type === Boolean)
+                return false;
+            return undefined;
+        }
+        switch (type) {
+            case Boolean:
+                return value !== 'false' && value !== '0';
+            case Number:
+                return Number(value);
+            default:
+                return value;
+        }
+    }
+    /** Sync all attributes to props */
+    _syncProps() {
+        const ctor = this.constructor;
+        for (const name of Object.keys(ctor.props)) {
+            this.props[name] = this._parseProp(name, this.getAttribute(name));
+        }
+    }
+    /** Schedule a microtask re-render (batches multiple state changes) */
+    _scheduleRender() {
+        if (this._renderScheduled)
+            return;
+        this._renderScheduled = true;
+        queueMicrotask(() => {
+            this._renderScheduled = false;
+            this._performRender();
+            if (this._mounted)
+                this.onUpdate();
+        });
+    }
+    /** Inject scoped <style> once into shadow root */
+    _ensureStyles() {
+        if (this._styleInjected)
+            return;
+        this._styleInjected = true;
+        const ctor = this.constructor;
+        if (!ctor.shadow)
+            return;
+        const style = document.createElement('style');
+        style.textContent = SHADOW_RESET + ctor.styles;
+        this._root.insertBefore(style, this._root.firstChild);
+    }
+    /** Perform the actual DOM update */
+    _performRender() {
+        const content = this.render();
+        if (content instanceof TemplateResult) {
+            // Template parts engine — surgical DOM updates
+            if (this._instance &&
+                this._instance.nodes.length > 0 &&
+                this._instance.nodes[0].parentNode) {
+                // Same component, update Parts only
+                this._instance.update(content.values);
+            }
+            else {
+                // First render or template structure changed — create fresh instance
+                if (this._instance)
+                    this._instance.dispose();
+                // Clear any previous innerHTML content (transition from SafeHTML or first render)
+                const ctor = this.constructor;
+                if (ctor.shadow) {
+                    // Keep <style> if injected, clear everything else
+                    while (this._root.childNodes.length > (this._styleInjected ? 1 : 0)) {
+                        this._root.removeChild(this._root.lastChild);
+                    }
+                }
+                else {
+                    this._root.innerHTML = '';
+                }
+                this._ensureStyles();
+                const instance = createInstance(content);
+                this._root.appendChild(instance.fragment);
+                this._instance = instance;
+            }
+        }
+        else if (content instanceof SafeHTML) {
+            // Fallback: innerHTML for raw SafeHTML (backward compat with raw())
+            if (this._instance) {
+                this._instance.dispose();
+                this._instance = null;
+            }
+            this._styleInjected = false;
+            const ctor = this.constructor;
+            if (ctor.shadow) {
+                this._root.innerHTML = `<style>${SHADOW_RESET}${ctor.styles}</style>` + content.content;
+            }
+            else {
+                this._root.innerHTML = content.content;
+            }
+        }
+    }
+    // --- Web Component Lifecycle ---
+    connectedCallback() {
+        this._syncProps();
+        this._performRender();
+        this._mounted = true;
+        this.onMount();
+    }
+    disconnectedCallback() {
+        this._mounted = false;
+        // Dispose template instance (removes event listeners, child instances)
+        if (this._instance) {
+            this._instance.dispose();
+            this._instance = null;
+        }
+        this._styleInjected = false;
+        // Run auto-cleanups registered by useStore/useSignal/useEffect
+        for (const fn of this._cleanups)
+            fn();
+        this._cleanups.length = 0;
+        this.onDestroy();
+    }
+    attributeChangedCallback(name, oldValue, newValue) {
+        if (oldValue === newValue)
+            return;
+        this.props[name] = this._parseProp(name, newValue);
+        if (this._mounted)
+            this._scheduleRender();
+    }
+    /** Called after first render and DOM attachment */
+    onMount() { }
+    /** Called after re-renders (state or prop changes) */
+    onUpdate() { }
+    /** Called when component is removed from DOM */
+    onDestroy() { }
+    // --- Utility ---
+    /** Register a cleanup function to run on disconnect (used by useStore/useSignal/useEffect) */
+    _addCleanup(fn) {
+        this._cleanups.push(fn);
+    }
+    /** Query within shadow DOM */
+    $(selector) {
+        return this._root.querySelector(selector);
+    }
+    /** Query all within shadow DOM */
+    $$(selector) {
+        return Array.from(this._root.querySelectorAll(selector));
+    }
+    /** Emit a custom event */
+    emit(name, detail) {
+        this.dispatchEvent(new CustomEvent(name, { detail, bubbles: true, composed: true }));
+    }
+    /** Register a component class as a custom element */
+    static define() {
+        if (!customElements.get(this.tag)) {
+            customElements.define(this.tag, this);
+        }
+    }
+}
+// Re-export html for convenience
+export { html, raw } from './html';
+export { TemplateResult } from './template';
+//# sourceMappingURL=component.js.map

package/dist/component/component.js.map

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

package/dist/component/connect.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Nova Engine — Component Connection Helpers
+ *
+ * Auto-subscribe components to stores and signals with automatic cleanup on destroy.
+ * Eliminates manual subscribe/unsubscribe boilerplate.
+ */
+import type { Component } from './component';
+/** Minimal signal interface — matches both Signal<T> and Computed<T> from @nova/store */
+interface Subscribable<T> {
+    (): T;
+    subscribe(fn: (value: T) => void): () => void;
+}
+/** Minimal store interface — matches Store<T> from @nova/state */
+interface SubscribableStore<T> {
+    subscribe<K extends keyof T>(key: K, fn: (newVal: T[K], oldVal: T[K]) => void): () => void;
+}
+/**
+ * Connect a signal or computed to a component.
+ * When the value changes, the component re-renders.
+ * Cleanup is automatic on disconnect.
+ *
+ * @returns The current value of the signal.
+ */
+export declare function useSignal<T>(component: Component, signal: Subscribable<T>): T;
+/**
+ * Connect a simple store to a component by key(s).
+ * When any of the specified keys change, the component re-renders.
+ * Cleanup is automatic on disconnect.
+ */
+export declare function useStore<T extends Record<string, any>>(component: Component, store: SubscribableStore<T>, ...keys: (keyof T)[]): void;
+/**
+ * Run a side effect tied to a component's lifecycle.
+ * If the function returns a cleanup, it runs on disconnect.
+ */
+export declare function useEffect(component: Component, fn: () => void | (() => void)): void;
+export interface TickHandle {
+    /** Pause the interval (callback stops firing) */
+    pause(): void;
+    /** Resume after pause */
+    resume(): void;
+    /** Change the interval duration (restarts the timer) */
+    setInterval(ms: number): void;
+    /** Whether the tick is currently running */
+    readonly active: boolean;
+    /** Stop and clean up (also called automatically on component disconnect) */
+    destroy(): void;
+}
+/**
+ * Create an auto-cleaned interval tied to a component's lifecycle.
+ * Automatically pauses when the document tab is hidden and resumes when visible.
+ * Cleanup is automatic on component disconnect.
+ *
+ * @param component  The component to tie lifecycle to
+ * @param callback   Function called on each tick. Receives elapsed ms since start.
+ * @param intervalMs Interval in milliseconds
+ * @returns TickHandle with pause/resume/destroy controls
+ */
+export declare function useTick(component: Component, callback: (elapsed: number) => void, intervalMs: number): TickHandle;
+export {};
+//# sourceMappingURL=connect.d.ts.map

package/dist/component/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/component/connect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,yFAAyF;AACzF,UAAU,YAAY,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC;IACN,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC/C;AAED,kEAAkE;AAClE,UAAU,iBAAiB,CAAC,CAAC;IAC3B,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5F;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAM7E;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACpD,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC3B,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GACnB,IAAI,CAON;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAKnF;AAID,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,KAAK,IAAI,IAAI,CAAC;IACd,yBAAyB;IACzB,MAAM,IAAI,IAAI,CAAC;IACf,wDAAwD;IACxD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,4EAA4E;IAC5E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CACrB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACnC,UAAU,EAAE,MAAM,GACjB,UAAU,CAuDZ"}

package/dist/component/connect.js

@@ -0,0 +1,115 @@
+/**
+ * Nova Engine — Component Connection Helpers
+ *
+ * Auto-subscribe components to stores and signals with automatic cleanup on destroy.
+ * Eliminates manual subscribe/unsubscribe boilerplate.
+ */
+/**
+ * Connect a signal or computed to a component.
+ * When the value changes, the component re-renders.
+ * Cleanup is automatic on disconnect.
+ *
+ * @returns The current value of the signal.
+ */
+export function useSignal(component, signal) {
+    const unsub = signal.subscribe(() => {
+        component._scheduleRender();
+    });
+    component._addCleanup(unsub);
+    return signal();
+}
+/**
+ * Connect a simple store to a component by key(s).
+ * When any of the specified keys change, the component re-renders.
+ * Cleanup is automatic on disconnect.
+ */
+export function useStore(component, store, ...keys) {
+    for (const key of keys) {
+        const unsub = store.subscribe(key, () => {
+            component._scheduleRender();
+        });
+        component._addCleanup(unsub);
+    }
+}
+/**
+ * Run a side effect tied to a component's lifecycle.
+ * If the function returns a cleanup, it runs on disconnect.
+ */
+export function useEffect(component, fn) {
+    const cleanup = fn();
+    if (typeof cleanup === 'function') {
+        component._addCleanup(cleanup);
+    }
+}
+/**
+ * Create an auto-cleaned interval tied to a component's lifecycle.
+ * Automatically pauses when the document tab is hidden and resumes when visible.
+ * Cleanup is automatic on component disconnect.
+ *
+ * @param component  The component to tie lifecycle to
+ * @param callback   Function called on each tick. Receives elapsed ms since start.
+ * @param intervalMs Interval in milliseconds
+ * @returns TickHandle with pause/resume/destroy controls
+ */
+export function useTick(component, callback, intervalMs) {
+    let id = null;
+    let running = false;
+    let ms = intervalMs;
+    const startTime = Date.now();
+    function tick() {
+        callback(Date.now() - startTime);
+    }
+    function start() {
+        if (running)
+            return;
+        running = true;
+        id = setInterval(tick, ms);
+    }
+    function stop() {
+        if (!running)
+            return;
+        running = false;
+        if (id !== null) {
+            clearInterval(id);
+            id = null;
+        }
+    }
+    // Pause when tab is hidden, resume when visible
+    function onVisibility() {
+        if (document.hidden) {
+            if (running)
+                stop();
+        }
+        else {
+            if (!destroyed)
+                start();
+        }
+    }
+    let destroyed = false;
+    document.addEventListener('visibilitychange', onVisibility);
+    // Start immediately
+    start();
+    const handle = {
+        pause() { stop(); },
+        resume() { if (!destroyed)
+            start(); },
+        setInterval(newMs) {
+            ms = newMs;
+            if (running) {
+                stop();
+                start();
+            }
+        },
+        get active() { return running; },
+        destroy() {
+            if (destroyed)
+                return;
+            destroyed = true;
+            stop();
+            document.removeEventListener('visibilitychange', onVisibility);
+        },
+    };
+    component._addCleanup(handle.destroy);
+    return handle;
+}
+//# sourceMappingURL=connect.js.map

package/dist/component/connect.js.map

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

package/dist/component/html.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Nova Engine — HTML Tagged Template Literal
+ *
+ * Returns a TemplateResult for fine-grained DOM updates (template parts engine).
+ * Falls back to string rendering for SSR and backward compat via .content getter.
+ * Usage: html`<div class="${className}">${userInput}</div>`
+ */
+import { TemplateResult } from './template';
+export declare function escapeHtml(value: unknown): string;
+/**
+ * Wrapper indicating pre-sanitized HTML content.
+ *
+ * WARNING: Content is rendered via innerHTML with NO escaping.
+ * Only use with trusted, pre-sanitized content. Never pass user
+ * input directly — use sanitize() from @nova/security first:
+ *
+ *   import { sanitize } from '@nova/security';
+ *   const safe = raw(sanitize(userInput));
+ */
+export declare class SafeHTML {
+    readonly content: string;
+    constructor(content: string);
+    toString(): string;
+}
+/**
+ * Mark a string as already-safe HTML (skip escaping).
+ *
+ * SECURITY: The caller is responsible for ensuring content is safe.
+ * Passing unsanitized user input creates an XSS vulnerability.
+ * Use sanitize() from @nova/security to clean untrusted HTML first.
+ */
+export declare function raw(value: string): SafeHTML;
+/** Tagged template — returns TemplateResult for fine-grained rendering */
+export declare function html(strings: TemplateStringsArray, ...values: unknown[]): TemplateResult;
+//# sourceMappingURL=html.d.ts.map

package/dist/component/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/component/html.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQjD;AAED;;;;;;;;;GASG;AACH,qBAAa,QAAQ;aACS,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM;IAE3C,QAAQ,IAAI,MAAM;CAGnB;AAED;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE3C;AAED,0EAA0E;AAC1E,wBAAgB,IAAI,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,CAExF"}