bosbun 0.0.4 → 0.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bosbun",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "type": "module",
   "description": "A minimalist fullstack framework — SSR + Svelte 5 Runes + Bun + ElysiaJS",
   "keywords": [

package/src/core/client/App.svelte

@@ -2,6 +2,7 @@
   import { router } from "./router.svelte.ts";
   import { findMatch } from "../matcher.ts";
   import { clientRoutes } from "bunia:routes";
+  import { consumePrefetch, prefetchCache } from "./prefetch.ts";
 
   let {
     ssrMode = false,
@@ -52,9 +53,13 @@
 
     // Load components + data in parallel, then update state atomically
     // to avoid a flash of stale/empty data before the fetch completes.
-    const dataFetch = match.route.hasServerData
-      ? fetch(`/__bunia/data?path=${encodeURIComponent(path)}`).then(r => r.json()).catch(() => null)
-      : Promise.resolve(null);
+    const cached = match.route.hasServerData ? consumePrefetch(path) : null;
+    prefetchCache.clear(); // clear remaining entries on navigation — matches SvelteKit behavior
+    const dataFetch = cached
+      ? Promise.resolve(cached)
+      : match.route.hasServerData
+        ? fetch(`/__bunia/data?path=${encodeURIComponent(path)}`).then(r => r.json()).catch(() => null)
+        : Promise.resolve(null);
 
     Promise.all([
       match.route.page(),

package/src/core/client/hydrate.ts

@@ -1,6 +1,7 @@
 import { hydrate } from "svelte";
 import App from "./App.svelte";
 import { router } from "./router.svelte.ts";
+import { initPrefetch } from "./prefetch.ts";
 import { findMatch } from "../matcher.ts";
 import { clientRoutes } from "bunia:routes";
 
@@ -11,6 +12,7 @@ async function main() {
 
     router.init();
     router.currentRoute = path;
+    initPrefetch();
 
     // Resolve the current route so we can pre-load the components
     // before handing off to App.svelte (avoids a flash of "Loading...")

package/src/core/client/prefetch.ts

@@ -0,0 +1,109 @@
+// ─── Link Prefetching ─────────────────────────────────────
+// Supports `data-bunia-preload="hover"` and `data-bunia-preload="viewport"`
+// on <a> elements or their ancestors.
+
+export const prefetchCache = new Map<string, any>();
+
+// In-flight fetch deduplication
+const pending = new Set<string>();
+
+/** Returns cached prefetch data for a path and removes it from cache. */
+export function consumePrefetch(path: string): any | null {
+    const data = prefetchCache.get(path);
+    if (data === undefined) return null;
+    prefetchCache.delete(path);
+    return data;
+}
+
+/** Prefetches data for a path and stores in cache. No-op if already cached/in-flight. */
+export async function prefetchPath(path: string): Promise<void> {
+    if (prefetchCache.has(path)) return;
+    if (pending.has(path)) return;
+
+    pending.add(path);
+    try {
+        const res = await fetch(`/__bunia/data?path=${encodeURIComponent(path)}`);
+        if (res.ok) {
+            prefetchCache.set(path, await res.json());
+        }
+    } catch {
+        // Silently ignore — prefetch is best-effort
+    } finally {
+        pending.delete(path);
+    }
+}
+
+function getLinkHref(anchor: HTMLAnchorElement): string | null {
+    if (anchor.origin !== window.location.origin) return null;
+    if (anchor.target) return null;
+    if (anchor.hasAttribute("download")) return null;
+    return anchor.pathname + anchor.search;
+}
+
+function observeViewportLinks(container: Element | Document = document) {
+    const observer = new IntersectionObserver((entries) => {
+        for (const entry of entries) {
+            if (!entry.isIntersecting) continue;
+            const anchor = entry.target as HTMLAnchorElement;
+            const href = getLinkHref(anchor);
+            if (href) prefetchPath(href);
+            observer.unobserve(anchor);
+        }
+    }, { rootMargin: "0px" });
+
+    const links = (container === document ? document : container as Element)
+        .querySelectorAll<HTMLAnchorElement>("a[data-bunia-preload='viewport']");
+
+    for (const link of links) {
+        observer.observe(link);
+    }
+
+    return observer;
+}
+
+export function initPrefetch(): void {
+    // ── Hover strategy (event delegation, 20ms debounce) ─────
+    let hoverTimer: ReturnType<typeof setTimeout> | null = null;
+
+    document.addEventListener("mouseover", (e) => {
+        if (!(e.target instanceof Element)) return;
+        // Early exit: skip if no [data-bunia-preload="hover"] ancestor exists
+        const preloadEl = e.target.closest("[data-bunia-preload]");
+        if (!preloadEl || preloadEl.getAttribute("data-bunia-preload") !== "hover") return;
+        const anchor = e.target.closest("a") as HTMLAnchorElement | null;
+        if (!anchor) return;
+        const href = getLinkHref(anchor);
+        if (!href) return;
+
+        if (hoverTimer) clearTimeout(hoverTimer);
+        hoverTimer = setTimeout(() => prefetchPath(href), 100);
+    });
+
+    document.addEventListener("mouseout", () => {
+        if (hoverTimer) { clearTimeout(hoverTimer); hoverTimer = null; }
+    });
+
+    // ── Viewport strategy ─────────────────────────────────────
+    const observer = observeViewportLinks();
+
+    // Pick up links added after initial render (e.g., after client navigation)
+    const mutation = new MutationObserver((records) => {
+        for (const record of records) {
+            for (const node of record.addedNodes) {
+                if (!(node instanceof Element)) continue;
+                // The node itself might be a viewport link
+                if (node.matches("a[data-bunia-preload='viewport']")) {
+                    observer.observe(node as HTMLAnchorElement);
+                }
+                // Or it might contain viewport links
+                for (const link of node.querySelectorAll<HTMLAnchorElement>(
+                    "a[data-bunia-preload='viewport']"
+                )) {
+                    observer.observe(link);
+                }
+            }
+        }
+    });
+
+    mutation.observe(document.body, { childList: true, subtree: true });
+}

package/src/core/html.ts

@@ -98,7 +98,7 @@ export function buildHtml(
   ${cssLinks}
   <link rel="stylesheet" href="/bunia-tw.css${cacheBust}">
 </head>
-<body>
+<body data-bunia-preload="hover">
   <div id="app">${body}</div>${scripts}
 </body>
 </html>`;
@@ -116,6 +116,7 @@ export function buildHtmlShell(): string {
     return _shell;
 }
 
+
 let _shellOpen: string | null = null;
 
 /** Chunk 1: everything from <!DOCTYPE> through CSS/modulepreload links (head still open) */
@@ -159,7 +160,7 @@ export function buildMetadataChunk(metadata: Metadata | null): string {
     } else {
         out += `  <title>Bunia App</title>\n`;
     }
-    out += `</head>\n<body>\n${SPINNER}`;
+    out += `</head>\n<body data-bunia-preload="hover">\n${SPINNER}`;
     return out;
 }