@mappoh/nova 0.2.3 → 0.5.0

package/dist/switch/switch.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Nova Engine — Switch / Toggle
+ *
+ * Accessible toggle switch with animated thumb, keyboard interaction,
+ * ARIA roles, and CSS custom property theming.
+ */
+export interface SwitchOptions {
+    /** Initial checked state. Default: false */
+    checked?: boolean;
+    /** Accessible label for the switch */
+    label?: string;
+    /** Disable interaction. Default: false */
+    disabled?: boolean;
+    /** Callback when the value changes */
+    onChange?: (checked: boolean) => void;
+}
+export interface SwitchInstance {
+    /** Get the current checked state */
+    getValue(): boolean;
+    /** Set the checked state programmatically */
+    setValue(checked: boolean): void;
+    /** Remove from DOM and clean up */
+    destroy(): void;
+}
+/** Create an accessible toggle switch. */
+export declare function createSwitch(container: string | HTMLElement, options?: SwitchOptions): SwitchInstance;
+//# sourceMappingURL=switch.d.ts.map

package/dist/switch/switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../src/switch/switch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,QAAQ,IAAI,OAAO,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,mCAAmC;IACnC,OAAO,IAAI,IAAI,CAAC;CACjB;AA+ED,0CAA0C;AAC1C,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,GAAG,WAAW,EAC/B,OAAO,GAAE,aAAkB,GAC1B,cAAc,CAgGhB"}

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":"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"}

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/tree-view/index.d.ts

@@ -0,0 +1,3 @@
+export { createTreeView } from './tree-view';
+export type { TreeNode, TreeViewOptions, TreeViewInstance } from './tree-view';
+//# sourceMappingURL=index.d.ts.map

package/dist/tree-view/index.d.ts.map

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

package/dist/tree-view/index.js

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

package/dist/tree-view/index.js.map

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

package/dist/tree-view/tree-view.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Nova Engine — Tree View
+ *
+ * Accessible hierarchical tree with expand/collapse, selection, and checkboxes.
+ */
+export interface TreeNode {
+    id: string;
+    label: string;
+    children?: TreeNode[];
+    icon?: string;
+    data?: unknown;
+}
+export interface TreeViewOptions {
+    nodes: TreeNode[];
+    selectable?: boolean;
+    checkable?: boolean;
+    onSelect?: (node: TreeNode) => void;
+    onCheck?: (checked: TreeNode[]) => void;
+    onExpand?: (node: TreeNode, expanded: boolean) => void;
+}
+export interface TreeViewInstance {
+    getSelected(): TreeNode | null;
+    getChecked(): TreeNode[];
+    expandAll(): void;
+    collapseAll(): void;
+    destroy(): void;
+}
+export declare function createTreeView(container: HTMLElement, options: TreeViewOptions): TreeViewInstance;
+//# sourceMappingURL=tree-view.d.ts.map

package/dist/tree-view/tree-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-view.d.ts","sourceRoot":"","sources":["../../src/tree-view/tree-view.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;CACxD;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,IAAI,QAAQ,GAAG,IAAI,CAAC;IAC/B,UAAU,IAAI,QAAQ,EAAE,CAAC;IACzB,SAAS,IAAI,IAAI,CAAC;IAClB,WAAW,IAAI,IAAI,CAAC;IACpB,OAAO,IAAI,IAAI,CAAC;CACjB;AAyBD,wBAAgB,cAAc,CAC5B,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,eAAe,GACvB,gBAAgB,CAoQlB"}

package/dist/tree-view/tree-view.js

@@ -0,0 +1,273 @@
+/**
+ * Nova Engine — Tree View
+ *
+ * Accessible hierarchical tree with expand/collapse, selection, and checkboxes.
+ */
+const STYLE_ID = 'nova-tree-view-styles';
+function injectStyles() {
+    if (document.getElementById(STYLE_ID))
+        return;
+    const style = document.createElement('style');
+    style.id = STYLE_ID;
+    style.textContent = `
+.nova-tv{font-family:inherit;font-size:0.875rem}
+.nova-tv ul{list-style:none;margin:0;padding-left:1.25rem}
+.nova-tv>ul{padding-left:0}
+.nova-tv-item{display:flex;align-items:center;gap:4px;padding:3px 6px;border-radius:4px;cursor:pointer;user-select:none}
+.nova-tv-item:hover{background:#f3f4f6}
+.nova-tv-item[aria-selected="true"]{background:#dbeafe}
+.nova-tv-toggle{display:inline-flex;width:16px;height:16px;align-items:center;justify-content:center;font-size:0.625rem;flex-shrink:0;transition:transform 0.15s}
+.nova-tv-toggle[data-expanded]{transform:rotate(90deg)}
+.nova-tv-toggle[data-leaf]{visibility:hidden}
+.nova-tv-icon{flex-shrink:0}
+.nova-tv-label{flex:1;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.nova-tv-check{margin-right:2px;cursor:pointer}
+.nova-tv ul[data-collapsed]{display:none}`;
+    document.head.appendChild(style);
+}
+export function createTreeView(container, options) {
+    injectStyles();
+    const expanded = new Set();
+    const checked = new Set();
+    let selectedId = null;
+    const root = document.createElement('div');
+    root.className = 'nova-tv';
+    root.setAttribute('role', 'tree');
+    container.appendChild(root);
+    // Flatten for keyboard nav
+    function flatNodes() {
+        const result = [];
+        function walk(nodes) {
+            for (const node of nodes) {
+                result.push(node);
+                if (node.children?.length && expanded.has(node.id)) {
+                    walk(node.children);
+                }
+            }
+        }
+        walk(options.nodes);
+        return result;
+    }
+    function findNode(id, nodes = options.nodes) {
+        for (const node of nodes) {
+            if (node.id === id)
+                return node;
+            if (node.children) {
+                const found = findNode(id, node.children);
+                if (found)
+                    return found;
+            }
+        }
+        return null;
+    }
+    function getAllDescendants(node) {
+        const result = [];
+        function walk(n) {
+            result.push(n);
+            n.children?.forEach(walk);
+        }
+        walk(node);
+        return result;
+    }
+    function renderTree(nodes, parentUl, level) {
+        for (const node of nodes) {
+            const hasChildren = !!node.children?.length;
+            const isExpanded = expanded.has(node.id);
+            const li = document.createElement('li');
+            li.setAttribute('role', 'treeitem');
+            li.setAttribute('aria-level', String(level));
+            if (hasChildren)
+                li.setAttribute('aria-expanded', String(isExpanded));
+            const item = document.createElement('div');
+            item.className = 'nova-tv-item';
+            item.dataset.id = node.id;
+            item.tabIndex = selectedId === node.id ? 0 : -1;
+            if (selectedId === node.id)
+                item.setAttribute('aria-selected', 'true');
+            // Toggle
+            const toggle = document.createElement('span');
+            toggle.className = 'nova-tv-toggle';
+            if (hasChildren) {
+                toggle.textContent = '\u25B6';
+                if (isExpanded)
+                    toggle.setAttribute('data-expanded', '');
+            }
+            else {
+                toggle.setAttribute('data-leaf', '');
+            }
+            item.appendChild(toggle);
+            // Checkbox
+            if (options.checkable) {
+                const cb = document.createElement('input');
+                cb.type = 'checkbox';
+                cb.className = 'nova-tv-check';
+                cb.checked = checked.has(node.id);
+                cb.setAttribute('aria-label', `Check ${node.label}`);
+                cb.addEventListener('click', (e) => {
+                    e.stopPropagation();
+                    const descendants = getAllDescendants(node);
+                    if (cb.checked) {
+                        descendants.forEach((d) => checked.add(d.id));
+                    }
+                    else {
+                        descendants.forEach((d) => checked.delete(d.id));
+                    }
+                    render();
+                    options.onCheck?.(getCheckedNodes());
+                });
+                item.appendChild(cb);
+            }
+            // Icon
+            if (node.icon) {
+                const icon = document.createElement('span');
+                icon.className = 'nova-tv-icon';
+                icon.textContent = node.icon;
+                item.appendChild(icon);
+            }
+            // Label
+            const label = document.createElement('span');
+            label.className = 'nova-tv-label';
+            label.textContent = node.label;
+            item.appendChild(label);
+            // Click handlers
+            item.addEventListener('click', () => {
+                if (hasChildren) {
+                    if (isExpanded)
+                        expanded.delete(node.id);
+                    else
+                        expanded.add(node.id);
+                    options.onExpand?.(node, !isExpanded);
+                    render();
+                }
+                if (options.selectable) {
+                    selectedId = node.id;
+                    options.onSelect?.(node);
+                    render();
+                }
+            });
+            li.appendChild(item);
+            // Children
+            if (hasChildren) {
+                const childUl = document.createElement('ul');
+                childUl.setAttribute('role', 'group');
+                if (!isExpanded)
+                    childUl.setAttribute('data-collapsed', '');
+                renderTree(node.children, childUl, level + 1);
+                li.appendChild(childUl);
+            }
+            parentUl.appendChild(li);
+        }
+    }
+    function render() {
+        while (root.firstChild)
+            root.removeChild(root.firstChild);
+        const ul = document.createElement('ul');
+        ul.setAttribute('role', 'tree');
+        renderTree(options.nodes, ul, 1);
+        // Keyboard nav
+        ul.addEventListener('keydown', (e) => {
+            const flat = flatNodes();
+            const currentIdx = flat.findIndex((n) => n.id === selectedId);
+            if (currentIdx === -1)
+                return;
+            const current = flat[currentIdx];
+            switch (e.key) {
+                case 'ArrowDown':
+                    e.preventDefault();
+                    if (currentIdx < flat.length - 1) {
+                        selectedId = flat[currentIdx + 1].id;
+                        options.onSelect?.(flat[currentIdx + 1]);
+                        render();
+                    }
+                    break;
+                case 'ArrowUp':
+                    e.preventDefault();
+                    if (currentIdx > 0) {
+                        selectedId = flat[currentIdx - 1].id;
+                        options.onSelect?.(flat[currentIdx - 1]);
+                        render();
+                    }
+                    break;
+                case 'ArrowRight':
+                    e.preventDefault();
+                    if (current.children?.length && !expanded.has(current.id)) {
+                        expanded.add(current.id);
+                        options.onExpand?.(current, true);
+                        render();
+                    }
+                    break;
+                case 'ArrowLeft':
+                    e.preventDefault();
+                    if (expanded.has(current.id)) {
+                        expanded.delete(current.id);
+                        options.onExpand?.(current, false);
+                        render();
+                    }
+                    break;
+                case ' ':
+                    e.preventDefault();
+                    if (options.checkable) {
+                        if (checked.has(current.id)) {
+                            getAllDescendants(current).forEach((d) => checked.delete(d.id));
+                        }
+                        else {
+                            getAllDescendants(current).forEach((d) => checked.add(d.id));
+                        }
+                        render();
+                        options.onCheck?.(getCheckedNodes());
+                    }
+                    break;
+            }
+        });
+        root.appendChild(ul);
+        // Focus the selected item
+        const selectedItem = root.querySelector(`[data-id="${selectedId}"]`);
+        selectedItem?.focus();
+    }
+    function getCheckedNodes() {
+        const result = [];
+        function walk(nodes) {
+            for (const node of nodes) {
+                if (checked.has(node.id))
+                    result.push(node);
+                if (node.children)
+                    walk(node.children);
+            }
+        }
+        walk(options.nodes);
+        return result;
+    }
+    // Initial render — select first item
+    if (options.selectable && options.nodes.length > 0) {
+        selectedId = options.nodes[0].id;
+    }
+    render();
+    return {
+        getSelected() {
+            return selectedId ? findNode(selectedId) : null;
+        },
+        getChecked() {
+            return getCheckedNodes();
+        },
+        expandAll() {
+            function walk(nodes) {
+                for (const node of nodes) {
+                    if (node.children?.length) {
+                        expanded.add(node.id);
+                        walk(node.children);
+                    }
+                }
+            }
+            walk(options.nodes);
+            render();
+        },
+        collapseAll() {
+            expanded.clear();
+            render();
+        },
+        destroy() {
+            root.remove();
+        },
+    };
+}
+//# sourceMappingURL=tree-view.js.map