@nexus_js/runtime 0.6.0

package/dist/optimistic.js

@@ -0,0 +1,104 @@
+/**
+ * Nexus Optimistic UI — `$optimistic` rune.
+ *
+ * Updates the UI instantly before the server responds.
+ * Rolls back automatically if the server action fails.
+ *
+ * Usage:
+ *   const likes = $state(post.likes);
+ *
+ *   function handleLike() {
+ *     $optimistic(
+ *       likes,
+ *       () => likePost(post.id),    // Server Action
+ *       post.likes                   // rollback value
+ *     );
+ *   }
+ *
+ * What happens:
+ *   1. `likes.value` jumps to `likes.value + 1` immediately (UI updates)
+ *   2. Server Action runs in background
+ *   3a. Success → server value is confirmed (or replaced with server result)
+ *   3b. Failure → `likes.value` rolls back to `post.likes`
+ */
+import { $state } from './runes.js';
+/**
+ * Wraps a server action with optimistic UI.
+ * The signal is updated immediately; rolls back on error.
+ *
+ * @param signal  - A $state signal to update optimistically
+ * @param action  - Async function that calls the server (returns new value or void)
+ * @param rollback - Value to restore if the action fails (defaults to current value)
+ */
+export async function $optimistic(signal, action, rollback) {
+    const savedValue = rollback ?? signal.value;
+    // Apply optimistic update immediately — UI reflects change before server
+    const optimisticResult = guessNextValue(signal.value);
+    if (optimisticResult !== undefined) {
+        signal.value = optimisticResult;
+    }
+    try {
+        const serverResult = await action();
+        // Server returned a canonical value — use it
+        if (serverResult !== undefined && serverResult !== null) {
+            signal.value = serverResult;
+        }
+    }
+    catch (err) {
+        // Roll back to the saved value on any error
+        signal.value = savedValue;
+        console.warn('[Nexus $optimistic] Action failed, rolling back:', err);
+    }
+}
+/**
+ * Creates a full optimistic action controller with pending/error state.
+ * More powerful than bare $optimistic — gives you loading indicators too.
+ *
+ * @example
+ * const likeAction = createOptimistic(likes, () => likePost(post.id));
+ * <button onclick={likeAction.execute} disabled={likeAction.pending}>
+ *   {likeAction.pending ? '...' : likes.value} likes
+ * </button>
+ */
+export function createOptimistic(signal, action, opts = {}) {
+    const pending = $state(false);
+    const error = $state(null);
+    const execute = async () => {
+        if (pending.value)
+            return; // Prevent double-submit
+        const savedValue = signal.value;
+        error.value = null;
+        pending.value = true;
+        // Apply optimistic update
+        if (opts.optimisticValue) {
+            signal.value = opts.optimisticValue(savedValue);
+        }
+        try {
+            const result = await action(savedValue);
+            if (result !== undefined && result !== null) {
+                signal.value = result;
+            }
+        }
+        catch (err) {
+            signal.value = savedValue;
+            const msg = err instanceof Error ? err.message : String(err);
+            error.value = msg;
+            opts.onError?.(err);
+        }
+        finally {
+            pending.value = false;
+        }
+    };
+    return { execute, pending, error };
+}
+/** Heuristic: guess next value for common types (numbers, booleans, arrays) */
+function guessNextValue(current) {
+    if (typeof current === 'number')
+        return (current + 1);
+    if (typeof current === 'boolean')
+        return (!current);
+    if (Array.isArray(current))
+        return [...current]; // shallow clone
+    return undefined;
+}
+//# sourceMappingURL=optimistic.js.map

package/dist/optimistic.js.map

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

package/dist/prefetch-ai.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Nexus AI Prefetch — Network-Aware Predictive Prefetching.
+ *
+ * Philosophy: "Spend better, not more."
+ *
+ * Pipeline:
+ *   1. Network check (Network Information API)
+ *      → Save-Data ON  → kill switch, log reason, exit
+ *      → effectiveType 2g/3g → skip, log reason, exit
+ *      → budget exhausted → skip, log reason
+ *   2. Read server probability manifest (/nexus-prefetch-manifest.json)
+ *      → Cached in sessionStorage, refreshed every 5min
+ *   3. Look up predictions for current route
+ *      → Only prefetch if probability ≥ threshold (default 0.85)
+ *   4. Inject <link rel="prefetch"> for HTML only (Zero-JS prefetch)
+ *      → Island JS is NOT prefetched until hover/focus
+ *   5. Track session budget — stop when exceeded
+ */
+export type PrefetchMode = 'aggressive' | 'smart' | 'conservative' | 'off';
+export interface AIPrefetchConfig {
+    /** Prefetch strategy (default: 'smart') */
+    mode: PrefetchMode;
+    /** Confidence threshold 0–1 to trigger prefetch (default: 0.85) */
+    threshold: number;
+    /** Max bytes to prefetch per browser session (default: 500KB) */
+    budget: number;
+    /** Only prefetch on WiFi or 4G (default: true) */
+    wifiOnly: boolean;
+    /** Respect navigator.connection.saveData (default: true) */
+    respectSaveData: boolean;
+    /** URL of the server-generated probability manifest */
+    manifestUrl: string;
+}
+export interface PrefetchPrediction {
+    to: string;
+    probability: number;
+    /** Estimated bytes of the prefetched resource */
+    estimatedBytes?: number;
+}
+export interface PrefetchManifest {
+    generated: number;
+    routes: Record<string, PrefetchPrediction[]>;
+    version: string;
+}
+export interface PrefetchDecision {
+    willPrefetch: boolean;
+    reason: SkipReason | null;
+    predictions: PrefetchPrediction[];
+    prefetched: string[];
+}
+export type SkipReason = 'mode-off' | 'save-data' | 'slow-connection' | 'budget-exhausted' | 'no-predictions' | 'low-confidence' | 'already-prefetched';
+/**
+ * Run the AI prefetch engine for the current route.
+ * Call this after each navigation or on page load.
+ *
+ * @param currentPath - Current route pathname
+ * @param config      - Optional config overrides (merged with defaults)
+ * @returns PrefetchDecision — what was prefetched and why (or why not)
+ */
+export declare function runAIPrefetch(currentPath: string, config?: Partial<AIPrefetchConfig>): Promise<PrefetchDecision>;
+/**
+ * Record a navigation transition for the client-side Markov chain.
+ * Call this on every route change: recordNavigation('/pokemon/25', '/pokemon/26').
+ */
+export declare function recordNavigation(from: string, to: string): void;
+/**
+ * Build an in-browser probability manifest from observed navigation patterns.
+ * Useful for apps that can't generate a server-side manifest.
+ */
+export declare function buildClientManifest(minConfidence?: number): PrefetchManifest;
+/**
+ * Creates a configured AI prefetch runner — use this in your nexus.config.ts.
+ *
+ * @example
+ * // nexus.config.ts
+ * import { defineAIPrefetch } from '@nexus_js/runtime/prefetch-ai';
+ * export default defineNexusConfig({
+ *   ai: defineAIPrefetch({
+ *     mode: 'smart',
+ *     budget: '500kb',
+ *     wifiOnly: true,
+ *   })
+ * });
+ */
+export declare function defineAIPrefetch(config?: Partial<AIPrefetchConfig> & {
+    budget?: string | number;
+}): AIPrefetchConfig;
+//# sourceMappingURL=prefetch-ai.d.ts.map

package/dist/prefetch-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch-ai.d.ts","sourceRoot":"","sources":["../src/prefetch-ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,OAAO,GAAG,cAAc,GAAG,KAAK,CAAC;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,IAAI,EAAa,YAAY,CAAC;IAC9B,mEAAmE;IACnE,SAAS,EAAQ,MAAM,CAAC;IACxB,iEAAiE;IACjE,MAAM,EAAW,MAAM,CAAC;IACxB,kDAAkD;IAClD,QAAQ,EAAS,OAAO,CAAC;IACzB,4DAA4D;IAC5D,eAAe,EAAE,OAAO,CAAC;IACzB,uDAAuD;IACvD,WAAW,EAAM,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAW,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAI,MAAM,CAAC;IACpB,MAAM,EAAO,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAClD,OAAO,EAAM,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAQ,UAAU,GAAG,IAAI,CAAC;IAChC,WAAW,EAAG,kBAAkB,EAAE,CAAC;IACnC,UAAU,EAAI,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,CAAC;AA0HzB;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACrC,OAAO,CAAC,gBAAgB,CAAC,CA4E3B;AAiBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAM/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,SAAM,GAAG,gBAAgB,CAczE;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAO,GAAG,gBAAgB,CAMxH"}

package/dist/prefetch-ai.js

@@ -0,0 +1,277 @@
+/**
+ * Nexus AI Prefetch — Network-Aware Predictive Prefetching.
+ *
+ * Philosophy: "Spend better, not more."
+ *
+ * Pipeline:
+ *   1. Network check (Network Information API)
+ *      → Save-Data ON  → kill switch, log reason, exit
+ *      → effectiveType 2g/3g → skip, log reason, exit
+ *      → budget exhausted → skip, log reason
+ *   2. Read server probability manifest (/nexus-prefetch-manifest.json)
+ *      → Cached in sessionStorage, refreshed every 5min
+ *   3. Look up predictions for current route
+ *      → Only prefetch if probability ≥ threshold (default 0.85)
+ *   4. Inject <link rel="prefetch"> for HTML only (Zero-JS prefetch)
+ *      → Island JS is NOT prefetched until hover/focus
+ *   5. Track session budget — stop when exceeded
+ */
+// ── Internal state ─────────────────────────────────────────────────────────────
+const SESSION_KEY_BUDGET = '__nexus_prefetch_budget__';
+const SESSION_KEY_PREFETCHED = '__nexus_prefetched__';
+const SESSION_KEY_MANIFEST = '__nexus_manifest__';
+const MANIFEST_TTL_MS = 5 * 60 * 1000; // 5 minutes
+const DEFAULT_CONFIG = {
+    mode: 'smart',
+    threshold: 0.85,
+    budget: 500 * 1024, // 500KB
+    wifiOnly: true,
+    respectSaveData: true,
+    manifestUrl: '/nexus-prefetch-manifest.json',
+};
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function getConnection() {
+    const nav = navigator;
+    return nav.connection ?? nav.mozConnection ?? nav.webkitConnection ?? null;
+}
+function getEffectiveType() {
+    return getConnection()?.effectiveType ?? 'unknown';
+}
+function isSaveDataEnabled() {
+    return getConnection()?.saveData === true;
+}
+function isConnectionFast(wifiOnly) {
+    const type = getEffectiveType();
+    if (type === '4g')
+        return true;
+    if (type === '3g' && !wifiOnly)
+        return true;
+    if (type === '2g' || type === 'slow-2g')
+        return false;
+    // Unknown — assume ok (desktop, no Network API)
+    return true;
+}
+function getBudgetUsed() {
+    return parseInt(sessionStorage.getItem(SESSION_KEY_BUDGET) ?? '0', 10);
+}
+function addBudgetUsed(bytes) {
+    sessionStorage.setItem(SESSION_KEY_BUDGET, String(getBudgetUsed() + bytes));
+}
+function getPrefetched() {
+    try {
+        return new Set(JSON.parse(sessionStorage.getItem(SESSION_KEY_PREFETCHED) ?? '[]'));
+    }
+    catch {
+        return new Set();
+    }
+}
+function markPrefetched(url) {
+    const set = getPrefetched();
+    set.add(url);
+    sessionStorage.setItem(SESSION_KEY_PREFETCHED, JSON.stringify([...set]));
+}
+function devLog(msg, data) {
+    if (typeof window === 'undefined')
+        return;
+    const isDev = window['__NEXUS_DEV__'];
+    if (!isDev)
+        return;
+    const args = [
+        `%c[Nexus] 🧠 AI%c ${msg}`,
+        'color:#7c3aed;font-weight:700',
+        'color:#64748b',
+    ];
+    if (data !== undefined)
+        args.push(data);
+    console.log(...args);
+}
+// ── Manifest fetching ─────────────────────────────────────────────────────────
+async function fetchManifest(url) {
+    try {
+        const cached = sessionStorage.getItem(SESSION_KEY_MANIFEST);
+        if (cached) {
+            const parsed = JSON.parse(cached);
+            if (Date.now() - parsed._cachedAt < MANIFEST_TTL_MS)
+                return parsed;
+        }
+    }
+    catch { /* ignore */ }
+    try {
+        const res = await fetch(url, { priority: 'low' });
+        if (!res.ok)
+            return null;
+        const manifest = await res.json();
+        sessionStorage.setItem(SESSION_KEY_MANIFEST, JSON.stringify({ ...manifest, _cachedAt: Date.now() }));
+        return manifest;
+    }
+    catch {
+        return null;
+    }
+}
+// ── Zero-JS HTML prefetch ─────────────────────────────────────────────────────
+function injectPrefetchLink(href) {
+    if (document.querySelector(`link[rel="prefetch"][href="${href}"]`))
+        return;
+    const link = document.createElement('link');
+    link.rel = 'prefetch';
+    link.href = href;
+    link.as = 'document';
+    document.head.appendChild(link);
+}
+// ── Main logic ────────────────────────────────────────────────────────────────
+/**
+ * Run the AI prefetch engine for the current route.
+ * Call this after each navigation or on page load.
+ *
+ * @param currentPath - Current route pathname
+ * @param config      - Optional config overrides (merged with defaults)
+ * @returns PrefetchDecision — what was prefetched and why (or why not)
+ */
+export async function runAIPrefetch(currentPath, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    const noop = (reason) => ({
+        willPrefetch: false, reason, predictions: [], prefetched: [],
+    });
+    if (typeof window === 'undefined')
+        return noop('mode-off');
+    if (cfg.mode === 'off') {
+        devLog('Prefetch disabled (mode: off)');
+        return noop('mode-off');
+    }
+    // ── Network checks ──────────────────────────────────────────────────────────
+    if (cfg.respectSaveData && isSaveDataEnabled()) {
+        devLog('🚫 Save-Data mode detected — prefetch disabled. Saved ~0MB (by policy).');
+        return noop('save-data');
+    }
+    if (cfg.wifiOnly && !isConnectionFast(true)) {
+        const type = getEffectiveType();
+        devLog(`🚫 Slow connection (${type}) — prefetch skipped. Your data is safe.`);
+        return noop('slow-connection');
+    }
+    if (!isConnectionFast(cfg.wifiOnly)) {
+        devLog(`⚠️  Connection is ${getEffectiveType()} — conservative mode activated.`);
+    }
+    // ── Budget check ────────────────────────────────────────────────────────────
+    const budgetUsed = getBudgetUsed();
+    if (budgetUsed >= cfg.budget) {
+        const usedKB = (budgetUsed / 1024).toFixed(0);
+        const maxKB = (cfg.budget / 1024).toFixed(0);
+        devLog(`🚫 Session budget exhausted (${usedKB}KB / ${maxKB}KB) — no more prefetches.`);
+        return noop('budget-exhausted');
+    }
+    // ── Load manifest ───────────────────────────────────────────────────────────
+    const manifest = await fetchManifest(cfg.manifestUrl);
+    if (!manifest) {
+        devLog('ℹ️  No probability manifest found — skipping AI prefetch.');
+        return noop('no-predictions');
+    }
+    const predictions = (manifest.routes[currentPath] ?? [])
+        .filter((p) => p.probability >= cfg.threshold)
+        .sort((a, b) => b.probability - a.probability);
+    if (predictions.length === 0) {
+        devLog(`ℹ️  No high-confidence predictions for "${currentPath}".`);
+        return noop(manifest.routes[currentPath] ? 'low-confidence' : 'no-predictions');
+    }
+    // ── Prefetch ────────────────────────────────────────────────────────────────
+    const prefetched = [];
+    const alreadyPrefetched = getPrefetched();
+    for (const pred of predictions) {
+        if (alreadyPrefetched.has(pred.to))
+            continue;
+        const estBytes = pred.estimatedBytes ?? 8_000; // ~8KB default for a Nexus HTML page
+        if (getBudgetUsed() + estBytes > cfg.budget) {
+            devLog(`🛑 Budget would be exceeded by prefetching "${pred.to}" — stopping.`);
+            break;
+        }
+        injectPrefetchLink(pred.to);
+        markPrefetched(pred.to);
+        addBudgetUsed(estBytes);
+        const pct = Math.round(pred.probability * 100);
+        const estKB = (estBytes / 1024).toFixed(1);
+        devLog(`✅ Predicting next hop → ${pred.to} (${pct}% confidence) — prefetched ${estKB}KB HTML-only.`);
+        prefetched.push(pred.to);
+    }
+    const totalBudgetUsed = getBudgetUsed();
+    const remaining = cfg.budget - totalBudgetUsed;
+    devLog(`💾 Session budget: ${(totalBudgetUsed / 1024).toFixed(0)}KB used / ${(cfg.budget / 1024).toFixed(0)}KB max — ${(remaining / 1024).toFixed(0)}KB remaining.`);
+    return { willPrefetch: prefetched.length > 0, reason: null, predictions, prefetched };
+}
+// ── Markov-chain recorder (client-side training) ──────────────────────────────
+const MARKOV_KEY = '__nexus_markov__';
+function loadMarkov() {
+    try {
+        return JSON.parse(sessionStorage.getItem(MARKOV_KEY) ?? '{}');
+    }
+    catch {
+        return {};
+    }
+}
+function saveMarkov(chain) {
+    try {
+        sessionStorage.setItem(MARKOV_KEY, JSON.stringify(chain));
+    }
+    catch { /* quota */ }
+}
+/**
+ * Record a navigation transition for the client-side Markov chain.
+ * Call this on every route change: recordNavigation('/pokemon/25', '/pokemon/26').
+ */
+export function recordNavigation(from, to) {
+    if (typeof window === 'undefined')
+        return;
+    const chain = loadMarkov();
+    if (!chain[from])
+        chain[from] = {};
+    chain[from][to] = (chain[from][to] ?? 0) + 1;
+    saveMarkov(chain);
+}
+/**
+ * Build an in-browser probability manifest from observed navigation patterns.
+ * Useful for apps that can't generate a server-side manifest.
+ */
+export function buildClientManifest(minConfidence = 0.5) {
+    const chain = loadMarkov();
+    const routes = {};
+    for (const [from, targets] of Object.entries(chain)) {
+        const total = Object.values(targets).reduce((a, b) => a + b, 0);
+        routes[from] = Object.entries(targets)
+            .map(([to, count]) => ({ to, probability: count / total }))
+            .filter((p) => p.probability >= minConfidence)
+            .sort((a, b) => b.probability - a.probability)
+            .slice(0, 3); // top 3 predictions per route
+    }
+    return { generated: Date.now(), routes, version: 'client-1.0' };
+}
+// ── nexus.config.ts integration helper ───────────────────────────────────────
+/**
+ * Creates a configured AI prefetch runner — use this in your nexus.config.ts.
+ *
+ * @example
+ * // nexus.config.ts
+ * import { defineAIPrefetch } from '@nexus_js/runtime/prefetch-ai';
+ * export default defineNexusConfig({
+ *   ai: defineAIPrefetch({
+ *     mode: 'smart',
+ *     budget: '500kb',
+ *     wifiOnly: true,
+ *   })
+ * });
+ */
+export function defineAIPrefetch(config = {}) {
+    const budget = typeof config.budget === 'string'
+        ? parseBudget(config.budget)
+        : (config.budget ?? DEFAULT_CONFIG.budget);
+    return { ...DEFAULT_CONFIG, ...config, budget };
+}
+function parseBudget(s) {
+    const m = /^(\d+(?:\.\d+)?)(kb|mb|b)?$/i.exec(s.trim());
+    if (!m)
+        return DEFAULT_CONFIG.budget;
+    const n = parseFloat(m[1] ?? '0');
+    switch (m[2]?.toLowerCase()) {
+        case 'mb': return n * 1024 * 1024;
+        case 'b': return n;
+        default: return n * 1024; // kb
+    }
+}
+//# sourceMappingURL=prefetch-ai.js.map

package/dist/prefetch-ai.js.map

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

package/dist/runes.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Nexus Runes — Fine-grained reactive primitives inspired by Svelte 5.
+ * Zero Virtual DOM. The runtime surgically updates only what changed.
+ */
+type Cleanup = () => void;
+/**
+ * Creates a reactive signal. Reading `.value` inside an `$effect` or
+ * `$derived` automatically creates a dependency subscription.
+ *
+ * @example
+ * const count = $state(0);
+ * count.value++; // triggers all subscribers
+ */
+export declare function $state<T>(initial: T): {
+    value: T;
+};
+/**
+ * Creates a computed value that automatically updates when its dependencies
+ * change. Computed lazily — only recalculates when accessed after a change.
+ *
+ * @example
+ * const count = $state(0);
+ * const doubled = $derived(() => count.value * 2);
+ * console.log(doubled.value); // 0
+ * count.value = 5;
+ * console.log(doubled.value); // 10
+ */
+export declare function $derived<T>(computation: () => T): {
+    readonly value: T;
+};
+/**
+ * Runs a side effect whenever its reactive dependencies change.
+ * Returns a cleanup function to stop tracking.
+ *
+ * @example
+ * const count = $state(0);
+ * $effect(() => {
+ *   document.title = `Count: ${count.value}`;
+ * });
+ */
+export declare function $effect(fn: () => Cleanup | void): Cleanup;
+/**
+ * Declares component props with optional defaults.
+ * Props are reactive — parent changes flow down automatically.
+ *
+ * @example
+ * const { name, age = 18 } = $props<{ name: string; age?: number }>();
+ */
+export declare function $props<T extends Record<string, unknown>>(defaults?: Partial<T>): T;
+/**
+ * Batches multiple state updates into a single re-render pass.
+ *
+ * @example
+ * batch(() => {
+ *   x.value = 1;
+ *   y.value = 2; // only one re-render happens
+ * });
+ */
+export declare function batch(fn: () => void): void;
+export {};
+//# sourceMappingURL=runes.d.ts.map

package/dist/runes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runes.d.ts","sourceRoot":"","sources":["../src/runes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,KAAK,OAAO,GAAG,MAAM,IAAI,CAAC;AAqB1B;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,CAyBlD;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAgBvE;AAID;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,OAAO,GAAG,IAAI,GAAG,OAAO,CA8BzD;AAID;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,QAAQ,GAAE,OAAO,CAAC,CAAC,CAAM,GACxB,CAAC,CAQH;AAOD;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAc1C"}