arcway 0.1.10 → 0.1.12

package/client/fetcher.js

@@ -44,7 +44,7 @@ async function soloFetch(url, init) {
     throw new ApiError(res.status, 'UNKNOWN', json?.message || res.statusText);
   }
 
-  return json.data;
+  return json;
 }
 
 export { ApiError, soloFetch };

package/client/router.js

@@ -1,5 +1,3 @@
-import { jsx, jsxs } from "react/jsx-runtime";
-import React from "react";
 import {
   createContext,
   useContext,
@@ -9,86 +7,96 @@ import {
   useMemo,
   useRef,
   useTransition,
-  createElement
-} from "react";
+  createElement,
+} from 'react';
 import {
   readClientManifest,
   loadPage,
   matchClientRoute,
   loadLoadingComponents,
-  prefetchRoute
-} from "./page-loader.js";
-import { parseQuery } from "./query.js";
-const ROUTER_CTX_KEY = "__router_context__";
-const RouterContext = globalThis[ROUTER_CTX_KEY] ??= createContext(null);
+  prefetchRoute,
+} from './page-loader.js';
+import { parseQuery } from './query.js';
+
+const ROUTER_CTX_KEY = '__router_context__';
+const RouterContext = (globalThis[ROUTER_CTX_KEY] ??= createContext(null));
+
 function wrapInLayouts(element, layouts) {
   for (let i = layouts.length - 1; i >= 0; i--) {
     element = createElement(layouts[i], null, element);
   }
   return element;
 }
+
 function useRouter() {
   const ctx = useContext(RouterContext);
   if (!ctx) {
-    throw new Error("useRouter must be used within a <Router> provider");
+    throw new Error('useRouter must be used within a <Router> provider');
   }
+
   return useMemo(
     () => ({
       pathname: ctx.pathname,
       params: ctx.params,
-      query: typeof window !== "undefined" ? parseQuery(window.location.search) : {},
+      query: typeof window !== 'undefined' ? parseQuery(window.location.search) : {},
       push: (to, options) => ctx.navigate(to, { ...options, replace: false }),
       replace: (to, options) => ctx.navigate(to, { ...options, replace: true }),
       back: () => {
-        if (typeof window !== "undefined") window.history.back();
+        if (typeof window !== 'undefined') window.history.back();
       },
       forward: () => {
-        if (typeof window !== "undefined") window.history.forward();
+        if (typeof window !== 'undefined') window.history.forward();
       },
       refresh: () => {
-        if (typeof window !== "undefined") window.location.reload();
-      }
+        if (typeof window !== 'undefined') window.location.reload();
+      },
     }),
-    [ctx.pathname, ctx.params, ctx.navigate]
+    [ctx.pathname, ctx.params, ctx.navigate],
   );
 }
+
 function usePathname() {
   return useRouter().pathname;
 }
+
 function useParams() {
   return useRouter().params;
 }
+
 function useSearchParams() {
   return useRouter().query;
 }
+
 function Router({
   initialPath,
   initialParams,
   initialComponent,
   initialLayouts,
   initialLoadings,
-  children
+  children,
 }) {
   const [pathname, setPathname] = useState(
-    () => initialPath ?? (typeof window !== "undefined" ? window.location.pathname : "/")
+    () => initialPath ?? (typeof window !== 'undefined' ? window.location.pathname : '/'),
   );
   const [pageState, setPageState] = useState({
     component: initialComponent ?? null,
     layouts: initialLayouts ?? [],
     loadings: initialLoadings ?? [],
-    params: initialParams ?? {}
+    params: initialParams ?? {},
   });
   const [isNavigating, setIsNavigating] = useState(false);
   const [isPending, startTransition] = useTransition();
   const manifestRef = useRef(null);
+
   useEffect(() => {
     manifestRef.current = readClientManifest();
     const onManifestUpdate = () => {
       manifestRef.current = readClientManifest();
     };
-    window.addEventListener("manifest-update", onManifestUpdate);
-    return () => window.removeEventListener("manifest-update", onManifestUpdate);
+    window.addEventListener('manifest-update', onManifestUpdate);
+    return () => window.removeEventListener('manifest-update', onManifestUpdate);
   }, []);
+
   const applyLoaded = useCallback((loaded, newPath) => {
     startTransition(() => {
       setPathname(newPath);
@@ -96,67 +104,78 @@ function Router({
         component: loaded.component,
         layouts: loaded.layouts,
         loadings: loaded.loadings,
-        params: loaded.params
+        params: loaded.params,
       });
       setIsNavigating(false);
     });
   }, []);
+
   const navigateToPage = useCallback(
     async (to, options) => {
       const scroll = options?.scroll !== false;
       const replace = options?.replace === true;
       if (to === pathname) return;
+
       const manifest = manifestRef.current;
       if (!manifest) {
         window.location.href = to;
         return;
       }
+
       const matched = matchClientRoute(manifest, to);
       if (!matched) {
         window.location.href = to;
         return;
       }
+
       setIsNavigating(true);
       if (replace) {
-        window.history.replaceState(null, "", to);
+        window.history.replaceState(null, '', to);
       } else {
-        window.history.pushState(null, "", to);
+        window.history.pushState(null, '', to);
       }
+
       const targetLoadings = await loadLoadingComponents(matched.route);
       if (targetLoadings.length > 0) {
         setPathname(to);
         setPageState((prev) => ({
           ...prev,
           loadings: targetLoadings,
-          params: matched.params
+          params: matched.params,
         }));
       }
+
       try {
         const loaded = await loadPage(manifest, to);
         if (!loaded) {
           window.location.href = to;
           return;
         }
+
         applyLoaded(loaded, to);
+
         if (scroll) {
           window.scrollTo(0, 0);
         }
       } catch (err) {
-        console.error("Client navigation failed, falling back to full page load:", err);
+        console.error('Client navigation failed, falling back to full page load:', err);
         window.location.href = to;
       }
     },
-    [pathname, applyLoaded]
+    [pathname, applyLoaded],
   );
+
   useEffect(() => {
     async function onPopState() {
       const newPath = window.location.pathname;
       const manifest = manifestRef.current;
+
       if (!manifest) {
         setPathname(newPath);
         setPageState((prev) => ({ ...prev, params: {} }));
         return;
       }
+
       try {
         const loaded = await loadPage(manifest, newPath);
         if (loaded) {
@@ -168,60 +187,71 @@ function Router({
         window.location.reload();
       }
     }
-    window.addEventListener("popstate", onPopState);
-    return () => window.removeEventListener("popstate", onPopState);
+
+    window.addEventListener('popstate', onPopState);
+    return () => window.removeEventListener('popstate', onPopState);
   }, [applyLoaded]);
+
   const { component: PageComponent, layouts, loadings, params } = pageState;
+
   let content;
   if (PageComponent) {
-    const inner = isNavigating && loadings.length > 0 ? createElement(loadings.at(-1)) : createElement(PageComponent, params);
+    const inner =
+      isNavigating && loadings.length > 0
+        ? createElement(loadings.at(-1))
+        : createElement(PageComponent, params);
     content = wrapInLayouts(inner, layouts);
   } else {
     content = children;
   }
-  return /* @__PURE__ */ jsxs(
+
+  const progressBar =
+    isNavigating && loadings.length === 0 && !isPending
+      ? createElement('div', {
+          style: {
+            position: 'fixed',
+            top: 0,
+            left: 0,
+            width: '100%',
+            height: '2px',
+            backgroundColor: '#0070f3',
+            zIndex: 99999,
+            animation: 'nav-progress 1s ease-in-out infinite',
+          },
+        })
+      : null;
+
+  return createElement(
     RouterContext.Provider,
     {
       value: {
         pathname,
         params,
-        navigate: navigateToPage
+        navigate: navigateToPage,
       },
-      children: [
-        content,
-        isNavigating && loadings.length === 0 && !isPending && /* @__PURE__ */ jsx(
-          "div",
-          {
-            style: {
-              position: "fixed",
-              top: 0,
-              left: 0,
-              width: "100%",
-              height: "2px",
-              backgroundColor: "#0070f3",
-              zIndex: 99999,
-              animation: "nav-progress 1s ease-in-out infinite"
-            }
-          }
-        )
-      ]
-    }
+    },
+    content,
+    progressBar,
   );
 }
-function Link({ href, children, onClick, scroll, replace, prefetch = "hover", ...rest }) {
+
+function Link({ href, children, onClick, scroll, replace, prefetch = 'hover', ...rest }) {
   const router = useContext(RouterContext);
   const linkRef = useRef(null);
+
   const handleMouseEnter = useCallback(() => {
-    if (prefetch !== "hover") return;
+    if (prefetch !== 'hover') return;
     const manifest = readClientManifest();
     if (manifest) {
       prefetchRoute(manifest, href);
     }
   }, [href, prefetch]);
+
   useEffect(() => {
-    if (prefetch !== "viewport") return;
+    if (prefetch !== 'viewport') return;
     const el = linkRef.current;
-    if (!el || typeof IntersectionObserver === "undefined") return;
+    if (!el || typeof IntersectionObserver === 'undefined') return;
+
     const observer = new IntersectionObserver(
       (entries) => {
         for (const entry of entries) {
@@ -235,40 +265,42 @@ function Link({ href, children, onClick, scroll, replace, prefetch = "hover", ..
           }
         }
       },
-      { rootMargin: "200px" }
+      { rootMargin: '200px' },
     );
+
     observer.observe(el);
     return () => observer.disconnect();
   }, [href, prefetch]);
+
   function handleClick(e) {
     if (onClick) onClick(e);
     if (e.defaultPrevented) return;
     if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
     if (e.button !== 0) return;
-    if (rest.target === "_blank" || rest.download !== void 0) return;
+    if (rest.target === '_blank' || rest.download !== undefined) return;
+
     try {
       const url = new URL(href, window.location.origin);
       if (url.origin !== window.location.origin) return;
     } catch {
       return;
     }
+
     e.preventDefault();
     if (router) {
       router.navigate(href, { scroll, replace });
     } else {
-      window.history.pushState(null, "", href);
-      window.dispatchEvent(new PopStateEvent("popstate"));
+      window.history.pushState(null, '', href);
+      window.dispatchEvent(new PopStateEvent('popstate'));
     }
   }
-  return /* @__PURE__ */ jsx("a", { ref: linkRef, href, onClick: handleClick, onMouseEnter: handleMouseEnter, ...rest, children });
+
+  return createElement(
+    'a',
+    { ref: linkRef, href, onClick: handleClick, onMouseEnter: handleMouseEnter, ...rest },
+    children,
+  );
 }
+
 const SoloRouter = Router;
-export {
-  Link,
-  Router,
-  SoloRouter,
-  useParams,
-  usePathname,
-  useRouter,
-  useSearchParams
-};
+export { Link, Router, SoloRouter, useParams, usePathname, useRouter, useSearchParams };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcway",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "A convention-based framework for building modular monoliths with strict domain boundaries.",
   "license": "MIT",
   "type": "module",
@@ -37,7 +37,8 @@
     "lint": "eslint server/ client/ tests/",
     "lint:fix": "eslint server/ client/ tests/ --fix",
     "storybook": "storybook dev -p 6006",
-    "build-storybook": "storybook build"
+    "build-storybook": "storybook build",
+    "deploy:docs": "cd ~/Projects/home-server/baremetal/ansible && ansible-playbook deploy-arcway-docs.yml"
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.987.0",

package/server/bin/commands/migrate.js

@@ -6,7 +6,10 @@ import { createDB } from '#server/db/index.js';
 async function runMigrateMake(name) {
   const rootDir = process.cwd();
   try {
-    const migrationsDir = path.resolve(rootDir, 'migrations');
+    const mode = process.env.NODE_ENV === 'production' ? 'production' : 'development';
+    loadEnvFiles(rootDir, mode);
+    const config = await makeConfig(rootDir);
+    const migrationsDir = config.database.dir;
     await fs.mkdir(migrationsDir, { recursive: true });
     const now = new Date();
     const timestamp = [

package/server/bin/commands/seed.js

@@ -1,4 +1,3 @@
-import path from 'node:path';
 import { makeConfig } from '#server/config/loader.js';
 import { loadEnvFiles } from '#server/env.js';
 import { createDB } from '#server/db/index.js';
@@ -11,7 +10,7 @@ async function runSeed() {
     const config = await makeConfig(rootDir);
     const db = await createDB(config.database);
     await db.runMigrations();
-    const seedsDir = path.join(rootDir, 'seeds');
+    const seedsDir = config.seeds.dir;
     const results = await runSeeds(db, seedsDir);
     if (results.length === 0) {
       console.log('No seed files found.');

package/server/config/loader.js

@@ -17,6 +17,7 @@ import resolvePages from './modules/pages.js';
 import resolveBuild from './modules/build.js';
 import resolveMcp from './modules/mcp.js';
 import resolveWebsocket from './modules/websocket.js';
+import resolveSeeds from './modules/seeds.js';
 
 function deepMerge(target, source) {
   const result = { ...target };
@@ -53,6 +54,7 @@ const modules = [
   resolveBuild,
   resolveMcp,
   resolveWebsocket,
+  resolveSeeds,
 ];
 
 async function makeConfig(rootDir, { overrides, mode } = {}) {

package/server/config/modules/database.js

@@ -2,7 +2,7 @@ import path from 'node:path';
 
 const DEFAULTS = {
   sqliteFilename: '.build/db/arcway.db',
-  migrationsDir: 'migrations',
+  dir: 'migrations',
 };
 
 const CLIENT_MAP = {
@@ -15,8 +15,8 @@ function resolve(config, { rootDir } = {}) {
   const db = { ...DEFAULTS, ...config.database };
   // Resolve friendly client names to actual knex driver names
   db.client = CLIENT_MAP[db.client] ?? db.client;
-  if (db.migrationsDir && !path.isAbsolute(db.migrationsDir)) {
-    db.migrationsDir = path.resolve(rootDir, db.migrationsDir);
+  if (db.dir && !path.isAbsolute(db.dir)) {
+    db.dir = path.resolve(rootDir, db.dir);
   }
   const isSqlite = db.client === 'better-sqlite3' || db.client === 'sqlite3';
   if (isSqlite && !db.connection) {

package/server/config/modules/events.js

@@ -1,13 +1,13 @@
 import path from 'node:path';
 
 const DEFAULTS = {
-  listenersDir: 'listeners',
+  dir: 'listeners',
 };
 
 function resolve(config, { rootDir } = {}) {
   const events = { ...DEFAULTS, ...config.events };
-  if (events.listenersDir && !path.isAbsolute(events.listenersDir)) {
-    events.listenersDir = path.resolve(rootDir, events.listenersDir);
+  if (events.dir && !path.isAbsolute(events.dir)) {
+    events.dir = path.resolve(rootDir, events.dir);
   }
   return { ...config, events };
 }

package/server/config/modules/jobs.js

@@ -6,13 +6,13 @@ const DEFAULTS = {
   pollIntervalMs: 60000,
   tableName: 'arcway_jobs',
   leaseTable: 'arcway_job_leases',
-  jobsDir: 'jobs',
+  dir: 'jobs',
 };
 
 function resolve(config, { rootDir } = {}) {
   const jobs = { ...DEFAULTS, ...config.jobs };
-  if (jobs.jobsDir && !path.isAbsolute(jobs.jobsDir)) {
-    jobs.jobsDir = path.resolve(rootDir, jobs.jobsDir);
+  if (jobs.dir && !path.isAbsolute(jobs.dir)) {
+    jobs.dir = path.resolve(rootDir, jobs.dir);
   }
   return { ...config, jobs };
 }

package/server/config/modules/seeds.js

@@ -0,0 +1,15 @@
+import path from 'node:path';
+
+const DEFAULTS = {
+  dir: 'seeds',
+};
+
+function resolve(config, { rootDir } = {}) {
+  const seeds = { ...DEFAULTS, ...config.seeds };
+  if (seeds.dir && !path.isAbsolute(seeds.dir)) {
+    seeds.dir = path.resolve(rootDir, seeds.dir);
+  }
+  return { ...config, seeds };
+}
+
+export default resolve;

package/server/db/index.js

@@ -45,6 +45,12 @@ async function createDB(config, { log } = {}) {
     throw new Error(`Database connection failed: ${err}`);
   }
 
+  if (isSqlite) {
+    await db.raw('PRAGMA journal_mode = WAL');
+    await db.raw('PRAGMA busy_timeout = 5000');
+    await db.raw('PRAGMA synchronous = NORMAL');
+  }
+
   const origDestroy = db.destroy.bind(db);
   Object.defineProperty(db, 'destroy', {
     value: async () => {
@@ -56,7 +62,7 @@ async function createDB(config, { log } = {}) {
   });
 
   db.runMigrations = async () => {
-    const migrationsDir = config.migrationsDir;
+    const migrationsDir = config.dir;
     if (!migrationsDir) return;
     const [batch, migrations] = await db.migrate.latest({
       migrationSource: new MigrationSource(migrationsDir),
@@ -69,8 +75,8 @@ async function createDB(config, { log } = {}) {
   };
 
   db.runRollback = async () => {
-    const migrationsDir = config.migrationsDir;
-    if (!migrationsDir) throw new Error('No migrationsDir configured');
+    const migrationsDir = config.dir;
+    if (!migrationsDir) throw new Error('No migrations dir configured');
     const [batch, entries] = await db.migrate.rollback({
       migrationSource: new MigrationSource(migrationsDir),
     });

package/server/events/drivers/memory.js

@@ -6,34 +6,22 @@ class MemoryTransport {
     const regex = patternToRegex(pattern);
     this.subscriptions.push({ pattern, regex, handler });
   }
-  /**
-   * Emit an event. All matching subscribers are called concurrently.
-   * Errors in individual listeners are caught and collected — one failing
-   * listener does not prevent others from running.
-   */
+  /** Emit an event. Handlers run asynchronously — fire-and-forget. */
   async emit(eventName, payload) {
     const matching = this.subscriptions.filter((sub) => sub.regex.test(eventName));
-    if (matching.length === 0) {
-      return;
-    }
-    const errors = [];
-    const results = await Promise.allSettled(
+    if (matching.length === 0) return;
+    Promise.allSettled(
       matching.map((sub) => sub.handler(eventName, payload)),
-    );
-    for (let i = 0; i < results.length; i++) {
-      const result = results[i];
-      if (result.status === 'rejected') {
-        const sub = matching[i];
-        errors.push({ pattern: sub.pattern, error: result.reason });
-        console.error(
-          `Event listener error [${sub.pattern}] for event "${eventName}":`,
-          result.reason,
-        );
+    ).then((results) => {
+      for (let i = 0; i < results.length; i++) {
+        if (results[i].status === 'rejected') {
+          console.error(
+            `Event listener error [${matching[i].pattern}] for event "${eventName}":`,
+            results[i].reason,
+          );
+        }
       }
-    }
-    if (errors.length > 0 && errors.length === matching.length) {
-      throw new Error(`All ${errors.length} listener(s) for event "${eventName}" failed`);
-    }
+    });
   }
   async disconnect() {}
 

package/server/events/handler.js

@@ -20,13 +20,13 @@ function validateHandler(item, filePath, index) {
 
 class EventHandler {
   _events;
-  _listenersDir;
+  _dir;
   _log;
   _appContext;
   _listeners = [];
 
   constructor(config, { events, log, appContext } = {}) {
-    this._listenersDir = config?.listenersDir;
+    this._dir = config?.dir;
     this._events = events;
     this._log = log;
     this._appContext = appContext ?? {
@@ -41,8 +41,8 @@ class EventHandler {
   }
 
   async init() {
-    if (!this._listenersDir) return;
-    const entries = await discoverModules(this._listenersDir, {
+    if (!this._dir) return;
+    const entries = await discoverModules(this._dir, {
       recursive: true,
       label: 'listener file',
     });

package/server/jobs/runner.js

@@ -59,7 +59,7 @@ class JobRunner {
   }
 
   async init() {
-    const jobsDir = this._config?.jobsDir;
+    const jobsDir = this._config?.dir;
     if (!jobsDir) return;
 
     // Discover and register user jobs

package/server/router/api-router.js

@@ -46,7 +46,7 @@ const validateRequest = validateRequestSchema;
 async function serializeResponse(res, response, responseHeaders, statusCode) {
   const customContentType = responseHeaders['Content-Type'] || responseHeaders['content-type'];
   if (!customContentType || customContentType.includes('application/json')) {
-    const responseBody = response.error ? { error: response.error } : { data: response.data };
+    const responseBody = response.error ? { error: response.error } : (response.data ?? null);
     sendJson(res, statusCode, responseBody, responseHeaders);
     return;
   }

package/server/testing/index.js

@@ -128,9 +128,9 @@ async function createTestContext(domainName, options) {
   if (options?.rootDir) {
     const migrationsDir = path.join(options.rootDir, 'migrations');
     await db.migrate.latest({ migrationSource: new MigrationSource(migrationsDir) });
-  } else if (options?.migrationsDir) {
+  } else if (options?.dir || options?.migrationsDir) {
     await db.migrate.latest({
-      migrationSource: new MigrationSource(options.migrationsDir),
+      migrationSource: new MigrationSource(options.dir ?? options.migrationsDir),
     });
   }
   const scopedDb = db;

package/client/router.jsx

@@ -1,303 +0,0 @@
-import React from 'react';
-import {
-  createContext,
-  useContext,
-  useState,
-  useEffect,
-  useCallback,
-  useMemo,
-  useRef,
-  useTransition,
-  createElement,
-} from 'react';
-import {
-  readClientManifest,
-  loadPage,
-  matchClientRoute,
-  loadLoadingComponents,
-  prefetchRoute,
-} from './page-loader.js';
-import { parseQuery } from './query.js';
-
-const ROUTER_CTX_KEY = '__router_context__';
-const RouterContext = (globalThis[ROUTER_CTX_KEY] ??= createContext(null));
-
-function wrapInLayouts(element, layouts) {
-  for (let i = layouts.length - 1; i >= 0; i--) {
-    element = createElement(layouts[i], null, element);
-  }
-  return element;
-}
-
-function useRouter() {
-  const ctx = useContext(RouterContext);
-  if (!ctx) {
-    throw new Error('useRouter must be used within a <Router> provider');
-  }
-
-  return useMemo(
-    () => ({
-      pathname: ctx.pathname,
-      params: ctx.params,
-      query: typeof window !== 'undefined' ? parseQuery(window.location.search) : {},
-      push: (to, options) => ctx.navigate(to, { ...options, replace: false }),
-      replace: (to, options) => ctx.navigate(to, { ...options, replace: true }),
-      back: () => {
-        if (typeof window !== 'undefined') window.history.back();
-      },
-      forward: () => {
-        if (typeof window !== 'undefined') window.history.forward();
-      },
-      refresh: () => {
-        if (typeof window !== 'undefined') window.location.reload();
-      },
-    }),
-    [ctx.pathname, ctx.params, ctx.navigate],
-  );
-}
-
-function usePathname() {
-  return useRouter().pathname;
-}
-
-function useParams() {
-  return useRouter().params;
-}
-
-function useSearchParams() {
-  return useRouter().query;
-}
-
-function Router({
-  initialPath,
-  initialParams,
-  initialComponent,
-  initialLayouts,
-  initialLoadings,
-  children,
-}) {
-  const [pathname, setPathname] = useState(
-    () => initialPath ?? (typeof window !== 'undefined' ? window.location.pathname : '/'),
-  );
-  const [pageState, setPageState] = useState({
-    component: initialComponent ?? null,
-    layouts: initialLayouts ?? [],
-    loadings: initialLoadings ?? [],
-    params: initialParams ?? {},
-  });
-  const [isNavigating, setIsNavigating] = useState(false);
-  const [isPending, startTransition] = useTransition();
-  const manifestRef = useRef(null);
-
-  useEffect(() => {
-    manifestRef.current = readClientManifest();
-    const onManifestUpdate = () => {
-      manifestRef.current = readClientManifest();
-    };
-    window.addEventListener('manifest-update', onManifestUpdate);
-    return () => window.removeEventListener('manifest-update', onManifestUpdate);
-  }, []);
-
-  const applyLoaded = useCallback((loaded, newPath) => {
-    startTransition(() => {
-      setPathname(newPath);
-      setPageState({
-        component: loaded.component,
-        layouts: loaded.layouts,
-        loadings: loaded.loadings,
-        params: loaded.params,
-      });
-      setIsNavigating(false);
-    });
-  }, []);
-
-  const navigateToPage = useCallback(
-    async (to, options) => {
-      const scroll = options?.scroll !== false;
-      const replace = options?.replace === true;
-      if (to === pathname) return;
-
-      const manifest = manifestRef.current;
-      if (!manifest) {
-        window.location.href = to;
-        return;
-      }
-
-      const matched = matchClientRoute(manifest, to);
-      if (!matched) {
-        window.location.href = to;
-        return;
-      }
-
-      setIsNavigating(true);
-      if (replace) {
-        window.history.replaceState(null, '', to);
-      } else {
-        window.history.pushState(null, '', to);
-      }
-
-      const targetLoadings = await loadLoadingComponents(matched.route);
-      if (targetLoadings.length > 0) {
-        setPathname(to);
-        setPageState((prev) => ({
-          ...prev,
-          loadings: targetLoadings,
-          params: matched.params,
-        }));
-      }
-
-      try {
-        const loaded = await loadPage(manifest, to);
-        if (!loaded) {
-          window.location.href = to;
-          return;
-        }
-
-        applyLoaded(loaded, to);
-
-        if (scroll) {
-          window.scrollTo(0, 0);
-        }
-      } catch (err) {
-        console.error('Client navigation failed, falling back to full page load:', err);
-        window.location.href = to;
-      }
-    },
-    [pathname, applyLoaded],
-  );
-
-  useEffect(() => {
-    async function onPopState() {
-      const newPath = window.location.pathname;
-      const manifest = manifestRef.current;
-
-      if (!manifest) {
-        setPathname(newPath);
-        setPageState((prev) => ({ ...prev, params: {} }));
-        return;
-      }
-
-      try {
-        const loaded = await loadPage(manifest, newPath);
-        if (loaded) {
-          applyLoaded(loaded, newPath);
-        } else {
-          window.location.reload();
-        }
-      } catch {
-        window.location.reload();
-      }
-    }
-
-    window.addEventListener('popstate', onPopState);
-    return () => window.removeEventListener('popstate', onPopState);
-  }, [applyLoaded]);
-
-  const { component: PageComponent, layouts, loadings, params } = pageState;
-
-  let content;
-  if (PageComponent) {
-    const inner = isNavigating && loadings.length > 0
-      ? createElement(loadings.at(-1))
-      : createElement(PageComponent, params);
-    content = wrapInLayouts(inner, layouts);
-  } else {
-    content = children;
-  }
-
-  return (
-    <RouterContext.Provider
-      value={{
-        pathname,
-        params,
-        navigate: navigateToPage,
-      }}
-    >
-      {content}
-      {isNavigating && loadings.length === 0 && !isPending && (
-        <div
-          style={{
-            position: 'fixed',
-            top: 0,
-            left: 0,
-            width: '100%',
-            height: '2px',
-            backgroundColor: '#0070f3',
-            zIndex: 99999,
-            animation: 'nav-progress 1s ease-in-out infinite',
-          }}
-        />
-      )}
-    </RouterContext.Provider>
-  );
-}
-
-function Link({ href, children, onClick, scroll, replace, prefetch = 'hover', ...rest }) {
-  const router = useContext(RouterContext);
-  const linkRef = useRef(null);
-
-  const handleMouseEnter = useCallback(() => {
-    if (prefetch !== 'hover') return;
-    const manifest = readClientManifest();
-    if (manifest) {
-      prefetchRoute(manifest, href);
-    }
-  }, [href, prefetch]);
-
-  useEffect(() => {
-    if (prefetch !== 'viewport') return;
-    const el = linkRef.current;
-    if (!el || typeof IntersectionObserver === 'undefined') return;
-
-    const observer = new IntersectionObserver(
-      (entries) => {
-        for (const entry of entries) {
-          if (entry.isIntersecting) {
-            const manifest = readClientManifest();
-            if (manifest) {
-              prefetchRoute(manifest, href);
-            }
-            observer.unobserve(el);
-            break;
-          }
-        }
-      },
-      { rootMargin: '200px' },
-    );
-
-    observer.observe(el);
-    return () => observer.disconnect();
-  }, [href, prefetch]);
-
-  function handleClick(e) {
-    if (onClick) onClick(e);
-    if (e.defaultPrevented) return;
-    if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
-    if (e.button !== 0) return;
-    if (rest.target === '_blank' || rest.download !== undefined) return;
-
-    try {
-      const url = new URL(href, window.location.origin);
-      if (url.origin !== window.location.origin) return;
-    } catch {
-      return;
-    }
-
-    e.preventDefault();
-    if (router) {
-      router.navigate(href, { scroll, replace });
-    } else {
-      window.history.pushState(null, '', href);
-      window.dispatchEvent(new PopStateEvent('popstate'));
-    }
-  }
-
-  return (
-    <a ref={linkRef} href={href} onClick={handleClick} onMouseEnter={handleMouseEnter} {...rest}>
-      {children}
-    </a>
-  );
-}
-
-const SoloRouter = Router;
-export { Link, Router, SoloRouter, useParams, usePathname, useRouter, useSearchParams };