@mappoh/nova 0.1.16

package/dist/supabase/client.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Nova Engine — Supabase Client
+ *
+ * Singleton Supabase client. Call initSupabase() in your app entry point,
+ * or fall back to VITE_SUPABASE_* environment variables.
+ */
+import { type SupabaseClient } from '@supabase/supabase-js';
+/**
+ * Initialize the Supabase client with explicit credentials.
+ * Call this once at app startup before any other supabase module is used.
+ */
+export declare function initSupabase(url: string, anonKey: string): SupabaseClient;
+/**
+ * Get the Supabase client singleton.
+ * If initSupabase() was not called, falls back to import.meta.env variables.
+ */
+export declare function getSupabase(): SupabaseClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/supabase/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/supabase/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAM1E;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAKzE;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,cAAc,CAc5C"}

package/dist/supabase/client.js

@@ -0,0 +1,36 @@
+/**
+ * Nova Engine — Supabase Client
+ *
+ * Singleton Supabase client. Call initSupabase() in your app entry point,
+ * or fall back to VITE_SUPABASE_* environment variables.
+ */
+import { createClient } from '@supabase/supabase-js';
+let client = null;
+let configUrl;
+let configKey;
+/**
+ * Initialize the Supabase client with explicit credentials.
+ * Call this once at app startup before any other supabase module is used.
+ */
+export function initSupabase(url, anonKey) {
+    configUrl = url;
+    configKey = anonKey;
+    client = createClient(url, anonKey);
+    return client;
+}
+/**
+ * Get the Supabase client singleton.
+ * If initSupabase() was not called, falls back to import.meta.env variables.
+ */
+export function getSupabase() {
+    if (!client) {
+        const url = configUrl ?? import.meta.env?.VITE_SUPABASE_URL;
+        const key = configKey ?? import.meta.env?.VITE_SUPABASE_ANON_KEY;
+        if (!url || !key) {
+            throw new Error('[Nova] Supabase not configured. Call initSupabase(url, key) or set VITE_SUPABASE_URL and VITE_SUPABASE_ANON_KEY.');
+        }
+        client = createClient(url, key);
+    }
+    return client;
+}
+//# sourceMappingURL=client.js.map

package/dist/supabase/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/supabase/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAuB,MAAM,uBAAuB,CAAC;AAE1E,IAAI,MAAM,GAA0B,IAAI,CAAC;AACzC,IAAI,SAA6B,CAAC;AAClC,IAAI,SAA6B,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,OAAe;IACvD,SAAS,GAAG,GAAG,CAAC;IAChB,SAAS,GAAG,OAAO,CAAC;IACpB,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,SAAS,IAAK,MAAM,CAAC,IAAY,CAAC,GAAG,EAAE,iBAAiB,CAAC;QACrE,MAAM,GAAG,GAAG,SAAS,IAAK,MAAM,CAAC,IAAY,CAAC,GAAG,EAAE,sBAAsB,CAAC;QAE1E,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,kHAAkH,CACnH,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/supabase/realtime.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Nova Engine — Realtime Subscription Manager
+ *
+ * Subscribe to Supabase table changes with easy cleanup.
+ */
+import type { RealtimePostgresChangesPayload } from '@supabase/supabase-js';
+type ChangeEvent = 'INSERT' | 'UPDATE' | 'DELETE' | '*';
+interface SubscribeOptions<T extends Record<string, unknown>> {
+    table: string;
+    event?: ChangeEvent;
+    schema?: string;
+    filter?: string;
+    onInsert?: (record: T) => void;
+    onUpdate?: (record: T, old: Partial<T>) => void;
+    onDelete?: (old: Partial<T>) => void;
+    onChange?: (payload: RealtimePostgresChangesPayload<T>) => void;
+}
+export declare function subscribe<T extends Record<string, unknown>>(id: string, options: SubscribeOptions<T>): () => void;
+export declare function unsubscribe(id: string): void;
+export declare function unsubscribeAll(): void;
+export {};
+//# sourceMappingURL=realtime.d.ts.map

package/dist/supabase/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../src/supabase/realtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAmB,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAE7F,KAAK,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,GAAG,CAAC;AAExD,UAAU,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACrC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,8BAA8B,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACjE;AAID,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC3B,MAAM,IAAI,CAwCZ;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAM5C;AAED,wBAAgB,cAAc,IAAI,IAAI,CAIrC"}

package/dist/supabase/realtime.js

@@ -0,0 +1,51 @@
+/**
+ * Nova Engine — Realtime Subscription Manager
+ *
+ * Subscribe to Supabase table changes with easy cleanup.
+ */
+import { getSupabase } from './client';
+const channels = new Map();
+export function subscribe(id, options) {
+    // Unsubscribe existing channel with same id
+    unsubscribe(id);
+    const { table, event = '*', schema = 'public', filter } = options;
+    const channelConfig = {
+        event,
+        schema,
+        table,
+        ...(filter ? { filter } : {}),
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const channel = getSupabase()
+        .channel(id)
+        .on('postgres_changes', channelConfig, (payload) => {
+        options.onChange?.(payload);
+        switch (payload.eventType) {
+            case 'INSERT':
+                options.onInsert?.(payload.new);
+                break;
+            case 'UPDATE':
+                options.onUpdate?.(payload.new, payload.old);
+                break;
+            case 'DELETE':
+                options.onDelete?.(payload.old);
+                break;
+        }
+    })
+        .subscribe();
+    channels.set(id, channel);
+    return () => unsubscribe(id);
+}
+export function unsubscribe(id) {
+    const channel = channels.get(id);
+    if (channel) {
+        getSupabase().removeChannel(channel);
+        channels.delete(id);
+    }
+}
+export function unsubscribeAll() {
+    for (const id of channels.keys()) {
+        unsubscribe(id);
+    }
+}
+//# sourceMappingURL=realtime.js.map

package/dist/supabase/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../src/supabase/realtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAgBvC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEpD,MAAM,UAAU,SAAS,CACvB,EAAU,EACV,OAA4B;IAE5B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,CAAC,CAAC;IAEhB,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAElE,MAAM,aAAa,GAAG;QACpB,KAAK;QACL,MAAM;QACN,KAAK;QACL,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrB,CAAC;IAEX,8DAA8D;IAC9D,MAAM,OAAO,GAAI,WAAW,EAAE;SAC3B,OAAO,CAAC,EAAE,CAAS;SACnB,EAAE,CACD,kBAAkB,EAClB,aAAa,EACb,CAAC,OAA0C,EAAE,EAAE;QAC7C,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC;QAE5B,QAAQ,OAAO,CAAC,SAAS,EAAE,CAAC;YAC1B,KAAK,QAAQ;gBACX,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAQ,CAAC,CAAC;gBACrC,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAQ,EAAE,OAAO,CAAC,GAAiB,CAAC,CAAC;gBAChE,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAiB,CAAC,CAAC;gBAC9C,MAAM;QACV,CAAC;IACH,CAAC,CACF;SACA,SAAS,EAAqB,CAAC;IAElC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAE1B,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,OAAO,EAAE,CAAC;QACZ,WAAW,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACjC,WAAW,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/sw/index.d.ts

@@ -0,0 +1,3 @@
+export { generateSW, registerSW, unregisterAllSW } from './sw';
+export type { CacheStrategy, RouteRule, SWOptions } from './sw';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/sw/index.js

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

package/dist/sw/index.js.map

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

package/dist/sw/sw.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Nova Engine — Service Worker Toolkit
+ *
+ * Precaching, runtime caching strategies, and offline fallback utilities.
+ * This module provides helpers to GENERATE service worker code,
+ * not to run inside the SW context directly.
+ */
+export type CacheStrategy = 'cache-first' | 'network-first' | 'stale-while-revalidate' | 'network-only' | 'cache-only';
+export interface RouteRule {
+    /** URL pattern to match (string prefix or RegExp) */
+    match: string | RegExp;
+    /** Caching strategy for matched requests */
+    strategy: CacheStrategy;
+    /** Cache name. Default: 'nova-runtime' */
+    cacheName?: string;
+    /** Max entries in cache. Default: 50 */
+    maxEntries?: number;
+    /** Max age in seconds. Default: 86400 (1 day) */
+    maxAge?: number;
+}
+export interface SWOptions {
+    /** Cache name for precached assets. Default: 'nova-precache-v1' */
+    precacheName?: string;
+    /** URLs to precache on install */
+    precache?: string[];
+    /** Runtime caching rules */
+    routes?: RouteRule[];
+    /** Offline fallback page URL */
+    offlineFallback?: string;
+    /** Skip waiting on install. Default: true */
+    skipWaiting?: boolean;
+    /** Claim clients on activate. Default: true */
+    claimClients?: boolean;
+}
+/**
+ * Generate service worker JavaScript code as a string.
+ * Write this to a .js file and register it.
+ */
+export declare function generateSW(options?: SWOptions): string;
+/**
+ * Register a service worker from a given URL.
+ * Returns the ServiceWorkerRegistration.
+ */
+export declare function registerSW(url: string, scope?: string): Promise<ServiceWorkerRegistration>;
+/**
+ * Unregister all service workers.
+ */
+export declare function unregisterAllSW(): Promise<void>;
+//# sourceMappingURL=sw.d.ts.map

package/dist/sw/sw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sw.d.ts","sourceRoot":"","sources":["../../src/sw/sw.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,eAAe,GAAG,wBAAwB,GAAG,cAAc,GAAG,YAAY,CAAC;AAEvH,MAAM,WAAW,SAAS;IACxB,qDAAqD;IACrD,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,EAAE,aAAa,CAAC;IACxB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,gCAAgC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,SAAc,GAAG,MAAM,CAmG1D;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAOhG;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAIrD"}

package/dist/sw/sw.js

@@ -0,0 +1,125 @@
+/**
+ * Nova Engine — Service Worker Toolkit
+ *
+ * Precaching, runtime caching strategies, and offline fallback utilities.
+ * This module provides helpers to GENERATE service worker code,
+ * not to run inside the SW context directly.
+ */
+/**
+ * Generate service worker JavaScript code as a string.
+ * Write this to a .js file and register it.
+ */
+export function generateSW(options = {}) {
+    const { precacheName = 'nova-precache-v1', precache = [], routes = [], offlineFallback, skipWaiting = true, claimClients = true, } = options;
+    const precacheList = JSON.stringify(precache);
+    const routeHandlers = routes.map((rule) => {
+        const match = rule.match instanceof RegExp ? rule.match.toString() : `'${rule.match}'`;
+        const cacheName = rule.cacheName ?? 'nova-runtime';
+        const maxEntries = rule.maxEntries ?? 50;
+        const maxAge = rule.maxAge ?? 86400;
+        return `  { match: ${match}, strategy: '${rule.strategy}', cacheName: '${cacheName}', maxEntries: ${maxEntries}, maxAge: ${maxAge} }`;
+    }).join(',\n');
+    return `// Nova Service Worker — Auto-generated
+const PRECACHE_NAME = '${precacheName}';
+const PRECACHE_URLS = ${precacheList};
+const ROUTES = [\n${routeHandlers}\n];
+${offlineFallback ? `const OFFLINE_FALLBACK = '${offlineFallback}';` : 'const OFFLINE_FALLBACK = null;'}
+
+self.addEventListener('install', (event) => {
+  ${skipWaiting ? 'self.skipWaiting();' : ''}
+  event.waitUntil(
+    caches.open(PRECACHE_NAME).then((cache) => cache.addAll(PRECACHE_URLS))
+  );
+});
+
+self.addEventListener('activate', (event) => {
+  ${claimClients ? 'event.waitUntil(self.clients.claim());' : ''}
+});
+
+function matchRoute(url) {
+  for (const route of ROUTES) {
+    if (typeof route.match === 'string') {
+      if (url.startsWith(route.match) || url.includes(route.match)) return route;
+    } else if (route.match.test && route.match.test(url)) {
+      return route;
+    }
+  }
+  return null;
+}
+
+async function cacheFirst(request, cacheName, maxAge) {
+  const cached = await caches.match(request);
+  if (cached) return cached;
+  const response = await fetch(request);
+  if (response.ok) {
+    const cache = await caches.open(cacheName);
+    cache.put(request, response.clone());
+  }
+  return response;
+}
+
+async function networkFirst(request, cacheName) {
+  try {
+    const response = await fetch(request);
+    if (response.ok) {
+      const cache = await caches.open(cacheName);
+      cache.put(request, response.clone());
+    }
+    return response;
+  } catch {
+    const cached = await caches.match(request);
+    return cached || (OFFLINE_FALLBACK ? caches.match(OFFLINE_FALLBACK) : new Response('Offline', { status: 503 }));
+  }
+}
+
+async function staleWhileRevalidate(request, cacheName) {
+  const cache = await caches.open(cacheName);
+  const cached = await cache.match(request);
+  const fetchPromise = fetch(request).then((response) => {
+    if (response.ok) cache.put(request, response.clone());
+    return response;
+  });
+  return cached || fetchPromise;
+}
+
+self.addEventListener('fetch', (event) => {
+  const url = event.request.url;
+  const route = matchRoute(url);
+  if (!route) return;
+
+  if (route.strategy === 'cache-first') {
+    event.respondWith(cacheFirst(event.request, route.cacheName, route.maxAge));
+  } else if (route.strategy === 'network-first') {
+    event.respondWith(networkFirst(event.request, route.cacheName));
+  } else if (route.strategy === 'stale-while-revalidate') {
+    event.respondWith(staleWhileRevalidate(event.request, route.cacheName));
+  } else if (route.strategy === 'cache-only') {
+    event.respondWith(caches.match(event.request).then(r => r || new Response('Not cached', { status: 404 })));
+  }
+  // network-only: do nothing, let browser handle
+});
+`;
+}
+/**
+ * Register a service worker from a given URL.
+ * Returns the ServiceWorkerRegistration.
+ */
+export async function registerSW(url, scope) {
+    if (!('serviceWorker' in navigator)) {
+        throw new Error('Service Workers are not supported in this browser.');
+    }
+    const opts = {};
+    if (scope)
+        opts.scope = scope;
+    return navigator.serviceWorker.register(url, opts);
+}
+/**
+ * Unregister all service workers.
+ */
+export async function unregisterAllSW() {
+    if (!('serviceWorker' in navigator))
+        return;
+    const registrations = await navigator.serviceWorker.getRegistrations();
+    await Promise.all(registrations.map((r) => r.unregister()));
+}
+//# sourceMappingURL=sw.js.map

package/dist/sw/sw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sw.js","sourceRoot":"","sources":["../../src/sw/sw.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgCH;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,UAAqB,EAAE;IAChD,MAAM,EACJ,YAAY,GAAG,kBAAkB,EACjC,QAAQ,GAAG,EAAE,EACb,MAAM,GAAG,EAAE,EACX,eAAe,EACf,WAAW,GAAG,IAAI,EAClB,YAAY,GAAG,IAAI,GACpB,GAAG,OAAO,CAAC;IAEZ,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,YAAY,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC;QACvF,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,cAAc,CAAC;QACnD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;QACpC,OAAO,cAAc,KAAK,gBAAgB,IAAI,CAAC,QAAQ,kBAAkB,SAAS,kBAAkB,UAAU,aAAa,MAAM,IAAI,CAAC;IACxI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEf,OAAO;yBACgB,YAAY;wBACb,YAAY;oBAChB,aAAa;EAC/B,eAAe,CAAC,CAAC,CAAC,6BAA6B,eAAe,IAAI,CAAC,CAAC,CAAC,gCAAgC;;;IAGnG,WAAW,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE;;;;;;;IAOxC,YAAY,CAAC,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiE/D,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,KAAc;IAC1D,IAAI,CAAC,CAAC,eAAe,IAAI,SAAS,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,IAAI,GAAwB,EAAE,CAAC;IACrC,IAAI,KAAK;QAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAC9B,OAAO,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC,CAAC,eAAe,IAAI,SAAS,CAAC;QAAE,OAAO;IAC5C,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC,gBAAgB,EAAE,CAAC;IACvE,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/tabs/index.d.ts

@@ -0,0 +1,3 @@
+export { createTabs } from './tabs';
+export type { TabsOptions, TabsInstance } from './tabs';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/tabs/index.js

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

package/dist/tabs/index.js.map

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

package/dist/tabs/tabs.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Nova Engine — Tabs
+ *
+ * Accessible tab panel switcher with full keyboard navigation,
+ * ARIA roles, and optional URL hash synchronisation.
+ * Purely behavioural — no injected styles.
+ */
+export interface TabsOptions {
+    /** Container element holding tabs and panels */
+    container: HTMLElement;
+    /** Tab button selector or elements. Auto-discovers [role="tab"] if omitted */
+    tabs?: string | HTMLElement[];
+    /** Panel selector or elements. Auto-discovers [role="tabpanel"] if omitted */
+    panels?: string | HTMLElement[];
+    /** Initially active tab index. Default: 0 */
+    defaultIndex?: number;
+    /** Sync active tab with URL hash. Default: false */
+    syncHash?: boolean;
+    /** Vertical layout — use ArrowUp/Down instead of Left/Right. Default: false */
+    vertical?: boolean;
+    /** Callback when active tab changes */
+    onChange?: (index: number) => void;
+}
+export interface TabsInstance {
+    /** Programmatically switch to a tab by index */
+    select(index: number): void;
+    /** Current active tab index */
+    readonly index: number;
+    /** Cleanup all listeners and ARIA attributes */
+    destroy(): void;
+}
+/** Create an accessible tab switcher. */
+export declare function createTabs(options: TabsOptions): TabsInstance;
+//# sourceMappingURL=tabs.d.ts.map

package/dist/tabs/tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/tabs/tabs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,SAAS,EAAE,WAAW,CAAC;IACvB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAC9B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAChC,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,OAAO,IAAI,IAAI,CAAC;CACjB;AA2BD,yCAAyC;AACzC,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAyK7D"}

package/dist/tabs/tabs.js

@@ -0,0 +1,173 @@
+/**
+ * Nova Engine — Tabs
+ *
+ * Accessible tab panel switcher with full keyboard navigation,
+ * ARIA roles, and optional URL hash synchronisation.
+ * Purely behavioural — no injected styles.
+ */
+/* ---- Helpers ---- */
+let idCounter = 0;
+function ensureId(el, prefix) {
+    if (!el.id)
+        el.id = `${prefix}-${++idCounter}`;
+    return el.id;
+}
+function resolveElements(container, option, fallbackSelector) {
+    if (!option) {
+        return Array.from(container.querySelectorAll(fallbackSelector));
+    }
+    if (typeof option === 'string') {
+        return Array.from(container.querySelectorAll(option));
+    }
+    return option;
+}
+/* ---- Factory ---- */
+/** Create an accessible tab switcher. */
+export function createTabs(options) {
+    const { container, defaultIndex = 0, syncHash = false, vertical = false, onChange, } = options;
+    const tabEls = resolveElements(container, options.tabs, '[role="tab"]');
+    const panelEls = resolveElements(container, options.panels, '[role="tabpanel"]');
+    if (tabEls.length === 0 || panelEls.length === 0) {
+        throw new Error('[Nova Tabs] No tabs or panels found in container.');
+    }
+    let activeIndex = -1;
+    let destroyed = false;
+    const listeners = [];
+    function on(target, evt, fn) {
+        target.addEventListener(evt, fn);
+        listeners.push([target, evt, fn]);
+    }
+    // --- ARIA setup ---
+    // Find or designate the tablist
+    let tablist = container.querySelector('[role="tablist"]');
+    if (!tablist) {
+        // Use the container itself or the common parent of tabs
+        const parent = tabEls[0].parentElement;
+        tablist = parent && container.contains(parent) ? parent : container;
+        tablist.setAttribute('role', 'tablist');
+    }
+    if (vertical) {
+        tablist.setAttribute('aria-orientation', 'vertical');
+    }
+    for (let i = 0; i < tabEls.length; i++) {
+        const tab = tabEls[i];
+        const panel = panelEls[i];
+        if (!panel)
+            continue;
+        const tabId = ensureId(tab, 'nova-tab');
+        const panelId = ensureId(panel, 'nova-tabpanel');
+        tab.setAttribute('role', 'tab');
+        tab.setAttribute('aria-controls', panelId);
+        panel.setAttribute('role', 'tabpanel');
+        panel.setAttribute('aria-labelledby', tabId);
+    }
+    // --- Selection logic ---
+    function select(index, focus = true) {
+        if (destroyed)
+            return;
+        if (index < 0 || index >= tabEls.length)
+            return;
+        if (index === activeIndex)
+            return;
+        // Deactivate previous
+        if (activeIndex >= 0 && activeIndex < tabEls.length) {
+            tabEls[activeIndex].setAttribute('aria-selected', 'false');
+            tabEls[activeIndex].setAttribute('tabindex', '-1');
+            if (panelEls[activeIndex]) {
+                panelEls[activeIndex].setAttribute('hidden', '');
+            }
+        }
+        // Activate new
+        activeIndex = index;
+        tabEls[index].setAttribute('aria-selected', 'true');
+        tabEls[index].setAttribute('tabindex', '0');
+        if (focus)
+            tabEls[index].focus();
+        if (panelEls[index]) {
+            panelEls[index].removeAttribute('hidden');
+        }
+        // Hash sync
+        if (syncHash) {
+            const hash = tabEls[index].getAttribute('data-hash') || tabEls[index].id;
+            if (hash)
+                history.replaceState(null, '', `#${hash}`);
+        }
+        onChange?.(index);
+    }
+    // --- Click handler ---
+    for (let i = 0; i < tabEls.length; i++) {
+        on(tabEls[i], 'click', () => select(i));
+    }
+    // --- Keyboard handler ---
+    on(container, 'keydown', ((e) => {
+        const target = e.target;
+        if (!tabEls.includes(target))
+            return;
+        const prevKey = vertical ? 'ArrowUp' : 'ArrowLeft';
+        const nextKey = vertical ? 'ArrowDown' : 'ArrowRight';
+        let newIndex = activeIndex;
+        if (e.key === nextKey) {
+            e.preventDefault();
+            newIndex = activeIndex < tabEls.length - 1 ? activeIndex + 1 : 0;
+        }
+        else if (e.key === prevKey) {
+            e.preventDefault();
+            newIndex = activeIndex > 0 ? activeIndex - 1 : tabEls.length - 1;
+        }
+        else if (e.key === 'Home') {
+            e.preventDefault();
+            newIndex = 0;
+        }
+        else if (e.key === 'End') {
+            e.preventDefault();
+            newIndex = tabEls.length - 1;
+        }
+        if (newIndex !== activeIndex) {
+            select(newIndex);
+        }
+    }));
+    // --- Hash sync: initial check ---
+    function indexFromHash() {
+        const hash = location.hash.slice(1);
+        if (!hash)
+            return -1;
+        for (let i = 0; i < tabEls.length; i++) {
+            const tabHash = tabEls[i].getAttribute('data-hash') || tabEls[i].id;
+            if (tabHash === hash)
+                return i;
+        }
+        return -1;
+    }
+    if (syncHash) {
+        on(window, 'hashchange', () => {
+            const idx = indexFromHash();
+            if (idx >= 0)
+                select(idx, false);
+        });
+    }
+    // --- Initialise ---
+    const initialIndex = syncHash ? Math.max(indexFromHash(), 0) : defaultIndex;
+    // Set all tabs to inactive first
+    for (let i = 0; i < tabEls.length; i++) {
+        tabEls[i].setAttribute('aria-selected', 'false');
+        tabEls[i].setAttribute('tabindex', '-1');
+        if (panelEls[i])
+            panelEls[i].setAttribute('hidden', '');
+    }
+    // Activate the initial tab (without focus on init)
+    activeIndex = -1; // Reset so select() doesn't bail
+    select(initialIndex, false);
+    // --- Instance ---
+    return {
+        select(index) { select(index); },
+        get index() { return activeIndex; },
+        destroy() {
+            if (destroyed)
+                return;
+            destroyed = true;
+            for (const [t, e, fn] of listeners)
+                t.removeEventListener(e, fn);
+        },
+    };
+}
+//# sourceMappingURL=tabs.js.map

package/dist/tabs/tabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.js","sourceRoot":"","sources":["../../src/tabs/tabs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4BH,uBAAuB;AAEvB,IAAI,SAAS,GAAG,CAAC,CAAC;AAElB,SAAS,QAAQ,CAAC,EAAe,EAAE,MAAc;IAC/C,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,IAAI,EAAE,SAAS,EAAE,CAAC;IAC/C,OAAO,EAAE,CAAC,EAAE,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CACtB,SAAsB,EACtB,MAA0C,EAC1C,gBAAwB;IAExB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAc,gBAAgB,CAAC,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAc,MAAM,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uBAAuB;AAEvB,yCAAyC;AACzC,MAAM,UAAU,UAAU,CAAC,OAAoB;IAC7C,MAAM,EACJ,SAAS,EACT,YAAY,GAAG,CAAC,EAChB,QAAQ,GAAG,KAAK,EAChB,QAAQ,GAAG,KAAK,EAChB,QAAQ,GACT,GAAG,OAAO,CAAC;IAEZ,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAEjF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,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,qBAAqB;IAErB,gCAAgC;IAChC,IAAI,OAAO,GAAG,SAAS,CAAC,aAAa,CAAC,kBAAkB,CAAuB,CAAC;IAChF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,wDAAwD;QACxD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;QACvC,OAAO,GAAG,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,YAAY,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QAEjD,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAChC,GAAG,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAC3C,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACvC,KAAK,CAAC,YAAY,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,0BAA0B;IAE1B,SAAS,MAAM,CAAC,KAAa,EAAE,KAAK,GAAG,IAAI;QACzC,IAAI,SAAS;YAAE,OAAO;QACtB,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,MAAM,CAAC,MAAM;YAAE,OAAO;QAChD,IAAI,KAAK,KAAK,WAAW;YAAE,OAAO;QAElC,sBAAsB;QACtB,IAAI,WAAW,IAAI,CAAC,IAAI,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YACpD,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACnD,IAAI,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC1B,QAAQ,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QAED,eAAe;QACf,WAAW,GAAG,KAAK,CAAC;QACpB,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC5C,IAAI,KAAK;YAAE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,QAAQ,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;QAED,YAAY;QACZ,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACzE,IAAI,IAAI;gBAAE,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,wBAAwB;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,2BAA2B;IAE3B,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,CAAgB,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAG,CAAC,CAAC,MAAqB,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO;QAErC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;QACnD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;QAEtD,IAAI,QAAQ,GAAG,WAAW,CAAC;QAE3B,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;YACtB,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;YAC7B,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,QAAQ,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACnE,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,KAAK,MAAM,EAAE,CAAC;YAC5B,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,QAAQ,GAAG,CAAC,CAAC;QACf,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;YAC3B,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,QAAQ,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7B,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAkB,CAAC,CAAC;IAErB,mCAAmC;IAEnC,SAAS,aAAa;QACpB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,IAAI,OAAO,KAAK,IAAI;gBAAE,OAAO,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE;YAC5B,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;YAC5B,IAAI,GAAG,IAAI,CAAC;gBAAE,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,qBAAqB;IAErB,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAE5E,iCAAiC;IACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,QAAQ,CAAC,CAAC,CAAC;YAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,mDAAmD;IACnD,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,iCAAiC;IACnD,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAE5B,mBAAmB;IAEnB,OAAO;QACL,MAAM,CAAC,KAAa,IAAU,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,KAAK,KAAa,OAAO,WAAW,CAAC,CAAC,CAAC;QAC3C,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;QACnE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/test/index.d.ts

@@ -0,0 +1,3 @@
+export { mount, simulate, waitForElement, flush, shadowSnapshot } from './test';
+export type { MountOptions, MountedComponent } from './test';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/test/index.js

@@ -0,0 +1,2 @@
+export { mount, simulate, waitForElement, flush, shadowSnapshot } from './test';
+//# sourceMappingURL=index.js.map

package/dist/test/index.js.map

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

package/dist/test/test.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Nova Engine — Testing Utilities
+ *
+ * Shadow DOM querying helpers, event simulation, and component lifecycle
+ * testing utilities for Nova components.
+ */
+export interface MountOptions {
+    /** HTML attributes to set on the element */
+    attributes?: Record<string, string>;
+    /** Slot content (light DOM) as text */
+    slotText?: string;
+    /** Container to mount into. Default: creates a detached div */
+    container?: HTMLElement;
+}
+export interface MountedComponent {
+    element: HTMLElement;
+    shadow: ShadowRoot | null;
+    shadowQuery<T extends HTMLElement = HTMLElement>(selector: string): T | null;
+    shadowQueryAll<T extends HTMLElement = HTMLElement>(selector: string): T[];
+    query<T extends HTMLElement = HTMLElement>(selector: string): T | null;
+    shadowText(selector: string): string;
+    shadowClick(selector: string): void;
+    shadowInput(selector: string, value: string): void;
+    waitForUpdate(): Promise<void>;
+    unmount(): void;
+}
+/** Mount a custom element for testing. */
+export declare function mount(tag: string, options?: MountOptions): MountedComponent;
+/** Simulate a DOM event on an element. */
+export declare function simulate(target: Element, eventType: string, options?: EventInit & Record<string, unknown>): void;
+/** Wait for a custom element to be defined. */
+export declare function waitForElement(tag: string, timeout?: number): Promise<void>;
+/** Flush pending microtasks and animation frames. */
+export declare function flush(): Promise<void>;
+/** Create a text snapshot of a shadow DOM for comparison. */
+export declare function shadowSnapshot(element: HTMLElement): string;
+//# sourceMappingURL=test.d.ts.map