@meekojs/meeko 0.0.4 → 0.1.0

package/dist/framework/project.d.ts

@@ -0,0 +1,9 @@
+import type { Server } from "node:http";
+export declare const frameworkClientEntry = ".meeko/generated/entry-client.ts";
+export declare const frameworkServerEntry = ".meeko/generated/entry-server.ts";
+/** Writes framework-owned Vite entries; no application file is overwritten. */
+export declare function prepareProject(projectRoot: string): Promise<void>;
+/** Builds both Vite targets and prerenders routes with the same generated entries. */
+export declare function buildProject(projectRoot: string): Promise<void>;
+/** Starts the package-owned Node 24 HTTP host for development or production. */
+export declare function startProject(projectRoot: string, production: boolean): Promise<Server>;

package/dist/framework/project.js

@@ -0,0 +1,272 @@
+import { randomUUID } from "node:crypto";
+import { createServer } from "node:http";
+import { mkdir, readFile, realpath, stat, writeFile } from "node:fs/promises";
+import { extname, isAbsolute, relative, resolve, sep } from "node:path";
+import { pathToFileURL } from "node:url";
+import { serializeJson } from "../server.js";
+import { attachNodeWebSocketServer, toNodeListener } from "../node.js";
+import { errorResponse, reportServerError } from "../framework-server/contracts.js";
+import { composeServerMiddleware } from "../framework-server/middleware.js";
+import { discoverConfiguredRoutes } from "./config.js";
+import { prerenderProject } from "./prerender.js";
+import { clientEntrySource, serverEntrySource } from "./project-templates.js";
+import { stylesheetLinks } from "./styles.js";
+export const frameworkClientEntry = ".meeko/generated/entry-client.ts";
+export const frameworkServerEntry = ".meeko/generated/entry-server.ts";
+const clientManifestFile = ".meeko/output/client/.vite/manifest.json";
+const serverBundleFile = ".meeko/output/server/entry.js";
+/** Writes framework-owned Vite entries; no application file is overwritten. */
+export async function prepareProject(projectRoot) {
+    const root = resolve(projectRoot);
+    const generated = resolve(root, ".meeko/generated");
+    await mkdir(generated, { recursive: true });
+    await Promise.all([
+        writeFile(resolve(root, frameworkClientEntry), clientEntrySource, "utf8"),
+        writeFile(resolve(root, frameworkServerEntry), serverEntrySource, "utf8"),
+    ]);
+}
+/** Builds both Vite targets and prerenders routes with the same generated entries. */
+export async function buildProject(projectRoot) {
+    const root = resolve(projectRoot);
+    await prepareProject(root);
+    const { build } = await import("vite");
+    const { meeko } = await import("../vite.js");
+    await build({
+        root, configFile: false, plugins: [meeko()],
+        build: {
+            outDir: ".meeko/output/client", manifest: true,
+            rollupOptions: { input: frameworkClientEntry },
+        },
+    });
+    await build({
+        root, configFile: false, plugins: [meeko()],
+        ssr: { external: ["@meekojs/meeko"] },
+        build: {
+            ssr: frameworkServerEntry,
+            outDir: ".meeko/output/server",
+            rollupOptions: { output: { entryFileNames: "entry.js" } },
+        },
+    });
+    await prerenderProject(root);
+}
+function portableRoutes(root, routes) {
+    const relativeFile = (file) => {
+        const path = relative(root, file);
+        if (path === ".." || path.startsWith(`..${sep}`) || isAbsolute(path) || resolve(file) === root) {
+            throw new Error(`Route file escaped project: ${file}`);
+        }
+        return "/" + path.replaceAll("\\", "/");
+    };
+    return routes.map((route) => ({
+        id: route.id,
+        file: relativeFile(route.file),
+        layouts: route.layouts.map(relativeFile),
+        ...(route.error ? { error: relativeFile(route.error) } : {}),
+    }));
+}
+async function readAsset(assetRoot, pathname) {
+    const file = resolve(assetRoot, "." + pathname);
+    if (!file.startsWith(assetRoot + sep))
+        return { status: 403 };
+    let actual;
+    try {
+        actual = await realpath(file);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw error;
+    }
+    const actualRoot = await realpath(assetRoot);
+    if (!actual.startsWith(actualRoot + sep))
+        return { status: 403 };
+    return { status: 200, body: await readFile(actual) };
+}
+/** Starts the package-owned Node 24 HTTP host for development or production. */
+export async function startProject(projectRoot, production) {
+    const root = resolve(projectRoot);
+    const port = Number(process.env.PORT || 4173);
+    if (!production)
+        await prepareProject(root);
+    let vite;
+    let runtime;
+    let socketServer;
+    const reportError = (error, requestId) => {
+        reportServerError(error, requestId, (failure, id) => {
+            process.stderr.write(`[meeko] request error ${id} (${failure instanceof Error ? failure.name : "UnknownError"})\n`);
+            if (!production)
+                console.error(failure);
+        });
+    };
+    try {
+        if (!production) {
+            const { createServer: createViteServer } = await import("vite");
+            const { meeko } = await import("../vite.js");
+            vite = await createViteServer({
+                root, configFile: false, plugins: [meeko()],
+                server: {
+                    middlewareMode: true,
+                    // Middleware mode opens a separate Vite WebSocket server. Derive its
+                    // port from the app port so concurrent projects do not share 24678.
+                    hmr: { host: "127.0.0.1", port: process.env.MEEKO_HMR_PORT
+                            ? Number(process.env.MEEKO_HMR_PORT)
+                            : ((port + 32767) % 65535) + 1 },
+                },
+                appType: "custom",
+            });
+        }
+        const clientRoot = resolve(root, ".meeko/output/client");
+        const publicRoot = resolve(root, "public");
+        const routes = await discoverConfiguredRoutes(root);
+        let clientEntry = "/" + frameworkClientEntry;
+        let productionStyles = "";
+        if (production) {
+            const manifest = JSON.parse(await readFile(resolve(root, clientManifestFile), "utf8"));
+            const entry = manifest[frameworkClientEntry];
+            if (!entry?.file)
+                throw new Error(`Missing ${frameworkClientEntry} in Vite client manifest`);
+            clientEntry = "/" + entry.file;
+            productionStyles = stylesheetLinks((entry.css ?? []).map((file) => "/" + file));
+        }
+        const globalCss = resolve(root, "app/styles/main.css");
+        const serverEntry = production
+            ? await import(pathToFileURL(resolve(root, serverBundleFile)).href)
+            : await vite.ssrLoadModule("/" + frameworkServerEntry);
+        const loadDevModule = vite
+            ? (file) => vite.ssrLoadModule("/" + relative(root, file).replaceAll("\\", "/"))
+            : undefined;
+        const appRuntime = await serverEntry.createAppRuntime(root, routes, clientEntry, production, loadDevModule);
+        runtime = appRuntime;
+        const portable = portableRoutes(root, routes);
+        const decorated = composeServerMiddleware(appRuntime.serverMiddleware, async (request) => {
+            const pathname = new URL(request.url).pathname;
+            if (pathname.startsWith("/api/") || pathname.startsWith("/_meeko/rpc/"))
+                return appRuntime.endpointHandler(request);
+            const result = await appRuntime.pageHandler(request);
+            if (result.status !== 200 || !(result.headers.get("content-type") ?? "").includes("text/html"))
+                return result;
+            const developmentStyles = !production && (await stat(globalCss).catch((error) => {
+                if (error.code === "ENOENT")
+                    return undefined;
+                throw error;
+            }))?.isFile() ? stylesheetLinks(["/app/styles/main.css?direct"]) : "";
+            let html = (await result.text())
+                .replace("</head>", `${production ? productionStyles : developmentStyles}</head>`)
+                .replace("</body>", `<script id="meeko-routes" type="application/json">${serializeJson(portable)}</script></body>`);
+            if (vite)
+                html = await vite.transformIndexHtml(pathname, html);
+            return new Response(request.method === "HEAD" ? null : html, { status: result.status, headers: result.headers });
+        });
+        const pageListener = toNodeListener(decorated, { onError: reportError });
+        const types = { ".js": "text/javascript", ".css": "text/css", ".svg": "image/svg+xml", ".png": "image/png" };
+        const server = createServer((request, response) => {
+            let pathname;
+            try {
+                pathname = new URL(request.url || "/", "http://localhost").pathname;
+            }
+            catch {
+                pageListener(request, response);
+                return;
+            }
+            if (production && /\.[a-z0-9]+$/i.test(pathname)) {
+                void (async () => {
+                    const asset = await readAsset(clientRoot, pathname) ?? await readAsset(publicRoot, pathname);
+                    if (!asset || asset.status !== 200) {
+                        response.writeHead(asset?.status ?? 404);
+                        response.end();
+                        return;
+                    }
+                    response.writeHead(200, { "content-type": types[extname(pathname)] || "application/octet-stream" });
+                    response.end(asset.body);
+                })().catch(async (error) => {
+                    const requestId = randomUUID();
+                    reportError(error, requestId);
+                    const destroySafely = (cause, previous) => {
+                        try {
+                            response.destroy(cause instanceof Error ? cause : undefined);
+                        }
+                        catch (destroyError) {
+                            if (!Object.is(destroyError, error) && !Object.is(destroyError, cause) && !Object.is(destroyError, previous)) {
+                                reportError(destroyError, requestId);
+                            }
+                        }
+                    };
+                    try {
+                        if (response.headersSent) {
+                            destroySafely(error);
+                            return;
+                        }
+                        const failure = errorResponse(error, requestId);
+                        const failureHeaders = {};
+                        failure.headers.forEach((value, name) => { failureHeaders[name] = value; });
+                        const cookies = failure.headers.getSetCookie();
+                        if (cookies.length)
+                            failureHeaders["set-cookie"] = cookies;
+                        response.writeHead(failure.status, failureHeaders);
+                        response.end(await failure.text());
+                    }
+                    catch (failure) {
+                        if (!Object.is(failure, error))
+                            reportError(failure, requestId);
+                        destroySafely(failure, error);
+                    }
+                });
+                return;
+            }
+            if (vite) {
+                vite.middlewares(request, response, () => pageListener(request, response));
+                return;
+            }
+            pageListener(request, response);
+        });
+        socketServer = appRuntime.manifest.socket?.length ? attachNodeWebSocketServer({
+            server, hub: appRuntime.socketHub,
+            publicOrigin: process.env.PUBLIC_ORIGIN || `http://127.0.0.1:${port}`,
+            onError: (error) => reportError(error, randomUUID()),
+        }) : undefined;
+        await new Promise((done, fail) => {
+            server.once("error", fail);
+            server.listen(port, "127.0.0.1", () => {
+                server.off("error", fail);
+                done();
+            });
+        });
+        let stopping = false;
+        const shutdown = () => {
+            if (stopping)
+                return;
+            stopping = true;
+            process.off("SIGINT", shutdown);
+            process.off("SIGTERM", shutdown);
+            void (async () => {
+                const steps = [
+                    () => socketServer?.close() ?? Promise.resolve(),
+                    () => new Promise((done, fail) => server.close((error) => error ? fail(error) : done())),
+                    () => appRuntime.sessions.close(),
+                    () => vite?.close() ?? Promise.resolve(),
+                ];
+                for (const close of steps) {
+                    try {
+                        await close();
+                    }
+                    catch (error) {
+                        reportError(error, randomUUID());
+                    }
+                }
+            })();
+        };
+        process.once("SIGINT", shutdown);
+        process.once("SIGTERM", shutdown);
+        process.stdout.write(`http://127.0.0.1:${port}\n`);
+        return server;
+    }
+    catch (error) {
+        const cleanup = await Promise.allSettled([socketServer?.close(), runtime?.sessions.close(), vite?.close()]);
+        for (const result of cleanup) {
+            if (result.status === "rejected")
+                reportError(result.reason, randomUUID());
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/framework/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/framework/project.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { createServer } from \"node:http\";\nimport { mkdir, readFile, realpath, stat, writeFile } from \"node:fs/promises\";\nimport { extname, isAbsolute, relative, resolve, sep } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport type { Server } from \"node:http\";\nimport type { ViteDevServer } from \"vite\";\nimport { serializeJson } from \"../server.js\";\nimport { attachNodeWebSocketServer, toNodeListener } from \"../node.js\";\nimport { errorResponse, reportServerError } from \"../framework-server/contracts.js\";\nimport { composeServerMiddleware } from \"../framework-server/middleware.js\";\nimport type { ServerMiddleware } from \"../framework-server/middleware.js\";\nimport { discoverConfiguredRoutes } from \"./config.js\";\nimport { prerenderProject } from \"./prerender.js\";\nimport { clientEntrySource, serverEntrySource } from \"./project-templates.js\";\nimport { stylesheetLinks } from \"./styles.js\";\nimport type { RouteRecord } from \"./router.js\";\n\nexport const frameworkClientEntry = \".meeko/generated/entry-client.ts\";\nexport const frameworkServerEntry = \".meeko/generated/entry-server.ts\";\nconst clientManifestFile = \".meeko/output/client/.vite/manifest.json\";\nconst serverBundleFile = \".meeko/output/server/entry.js\";\n\ninterface AppRuntime {\n  readonly pageHandler: (request: Request) => Promise<Response>;\n  readonly endpointHandler: (request: Request) => Promise<Response>;\n  readonly socketHub: Parameters<typeof attachNodeWebSocketServer>[0][\"hub\"];\n  readonly sessions: { close(): Promise<void> };\n  readonly manifest: { readonly socket?: readonly unknown[] };\n  readonly serverMiddleware: readonly ServerMiddleware[];\n}\n\ninterface AppEntry {\n  createAppRuntime(\n    root: string,\n    routes: readonly RouteRecord[],\n    clientEntry: string,\n    production: boolean,\n    loadDevModule?: (file: string) => Promise<Record<string, unknown>>,\n  ): Promise<AppRuntime>;\n}\n\n/** Writes framework-owned Vite entries; no application file is overwritten. */\nexport async function prepareProject(projectRoot: string): Promise<void> {\n  const root = resolve(projectRoot);\n  const generated = resolve(root, \".meeko/generated\");\n  await mkdir(generated, { recursive: true });\n  await Promise.all([\n    writeFile(resolve(root, frameworkClientEntry), clientEntrySource, \"utf8\"),\n    writeFile(resolve(root, frameworkServerEntry), serverEntrySource, \"utf8\"),\n  ]);\n}\n\n/** Builds both Vite targets and prerenders routes with the same generated entries. */\nexport async function buildProject(projectRoot: string): Promise<void> {\n  const root = resolve(projectRoot);\n  await prepareProject(root);\n  const { build } = await import(\"vite\");\n  const { meeko } = await import(\"../vite.js\");\n  await build({\n    root, configFile: false, plugins: [meeko()],\n    build: {\n      outDir: \".meeko/output/client\", manifest: true,\n      rollupOptions: { input: frameworkClientEntry },\n    },\n  });\n  await build({\n    root, configFile: false, plugins: [meeko()],\n    ssr: { external: [\"@meekojs/meeko\"] },\n    build: {\n      ssr: frameworkServerEntry,\n      outDir: \".meeko/output/server\",\n      rollupOptions: { output: { entryFileNames: \"entry.js\" } },\n    },\n  });\n  await prerenderProject(root);\n}\n\nfunction portableRoutes(root: string, routes: readonly RouteRecord[]): unknown[] {\n  const relativeFile = (file: string): string => {\n    const path = relative(root, file);\n    if (path === \"..\" || path.startsWith(`..${sep}`) || isAbsolute(path) || resolve(file) === root) {\n      throw new Error(`Route file escaped project: ${file}`);\n    }\n    return \"/\" + path.replaceAll(\"\\\\\", \"/\");\n  };\n  return routes.map((route) => ({\n    id: route.id,\n    file: relativeFile(route.file),\n    layouts: route.layouts.map(relativeFile),\n    ...(route.error ? { error: relativeFile(route.error) } : {}),\n  }));\n}\n\nasync function readAsset(assetRoot: string, pathname: string): Promise<{ status: number; body?: Buffer } | null> {\n  const file = resolve(assetRoot, \".\" + pathname);\n  if (!file.startsWith(assetRoot + sep)) return { status: 403 };\n  let actual: string;\n  try { actual = await realpath(file); }\n  catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return null;\n    throw error;\n  }\n  const actualRoot = await realpath(assetRoot);\n  if (!actual.startsWith(actualRoot + sep)) return { status: 403 };\n  return { status: 200, body: await readFile(actual) };\n}\n\n/** Starts the package-owned Node 24 HTTP host for development or production. */\nexport async function startProject(projectRoot: string, production: boolean): Promise<Server> {\n  const root = resolve(projectRoot);\n  const port = Number(process.env.PORT || 4173);\n  if (!production) await prepareProject(root);\n  let vite: ViteDevServer | undefined;\n  let runtime: AppRuntime | undefined;\n  let socketServer: ReturnType<typeof attachNodeWebSocketServer> | undefined;\n  const reportError = (error: unknown, requestId: string): void => {\n    reportServerError(error, requestId, (failure, id) => {\n      process.stderr.write(`[meeko] request error ${id} (${failure instanceof Error ? failure.name : \"UnknownError\"})\\n`);\n      if (!production) console.error(failure);\n    });\n  };\n  try {\n    if (!production) {\n      const { createServer: createViteServer } = await import(\"vite\");\n      const { meeko } = await import(\"../vite.js\");\n      vite = await createViteServer({\n        root, configFile: false, plugins: [meeko()],\n        server: {\n          middlewareMode: true,\n          // Middleware mode opens a separate Vite WebSocket server. Derive its\n          // port from the app port so concurrent projects do not share 24678.\n          hmr: { host: \"127.0.0.1\", port: process.env.MEEKO_HMR_PORT\n            ? Number(process.env.MEEKO_HMR_PORT)\n            : ((port + 32767) % 65535) + 1 },\n        },\n        appType: \"custom\",\n      });\n    }\n    const clientRoot = resolve(root, \".meeko/output/client\");\n    const publicRoot = resolve(root, \"public\");\n    const routes = await discoverConfiguredRoutes(root);\n    let clientEntry = \"/\" + frameworkClientEntry;\n    let productionStyles = \"\";\n    if (production) {\n      const manifest = JSON.parse(await readFile(resolve(root, clientManifestFile), \"utf8\")) as Record<string, { file?: string; css?: string[] }>;\n      const entry = manifest[frameworkClientEntry];\n      if (!entry?.file) throw new Error(`Missing ${frameworkClientEntry} in Vite client manifest`);\n      clientEntry = \"/\" + entry.file;\n      productionStyles = stylesheetLinks((entry.css ?? []).map((file) => \"/\" + file));\n    }\n    const globalCss = resolve(root, \"app/styles/main.css\");\n    const serverEntry = production\n      ? await import(pathToFileURL(resolve(root, serverBundleFile)).href) as AppEntry\n      : await vite!.ssrLoadModule(\"/\" + frameworkServerEntry) as AppEntry;\n    const loadDevModule = vite\n      ? (file: string) => vite!.ssrLoadModule(\"/\" + relative(root, file).replaceAll(\"\\\\\", \"/\")) as Promise<Record<string, unknown>>\n      : undefined;\n    const appRuntime = await serverEntry.createAppRuntime(root, routes, clientEntry, production, loadDevModule);\n    runtime = appRuntime;\n    const portable = portableRoutes(root, routes);\n    const decorated = composeServerMiddleware(appRuntime.serverMiddleware, async (request: Request): Promise<Response> => {\n      const pathname = new URL(request.url).pathname;\n      if (pathname.startsWith(\"/api/\") || pathname.startsWith(\"/_meeko/rpc/\")) return appRuntime.endpointHandler(request);\n      const result = await appRuntime.pageHandler(request);\n      if (result.status !== 200 || !(result.headers.get(\"content-type\") ?? \"\").includes(\"text/html\")) return result;\n      const developmentStyles = !production && (await stat(globalCss).catch((error: NodeJS.ErrnoException) => {\n        if (error.code === \"ENOENT\") return undefined;\n        throw error;\n      }))?.isFile() ? stylesheetLinks([\"/app/styles/main.css?direct\"]) : \"\";\n      let html = (await result.text())\n        .replace(\"</head>\", `${production ? productionStyles : developmentStyles}</head>`)\n        .replace(\"</body>\", `<script id=\"meeko-routes\" type=\"application/json\">${serializeJson(portable)}</script></body>`);\n      if (vite) html = await vite.transformIndexHtml(pathname, html);\n      return new Response(request.method === \"HEAD\" ? null : html, { status: result.status, headers: result.headers });\n    });\n    const pageListener = toNodeListener(decorated, { onError: reportError });\n    const types: Record<string, string> = { \".js\": \"text/javascript\", \".css\": \"text/css\", \".svg\": \"image/svg+xml\", \".png\": \"image/png\" };\n    const server = createServer((request, response) => {\n      let pathname: string;\n      try { pathname = new URL(request.url || \"/\", \"http://localhost\").pathname; }\n      catch { pageListener(request, response); return; }\n      if (production && /\\.[a-z0-9]+$/i.test(pathname)) {\n        void (async () => {\n          const asset = await readAsset(clientRoot, pathname) ?? await readAsset(publicRoot, pathname);\n          if (!asset || asset.status !== 200) { response.writeHead(asset?.status ?? 404); response.end(); return; }\n          response.writeHead(200, { \"content-type\": types[extname(pathname)] || \"application/octet-stream\" });\n          response.end(asset.body);\n        })().catch(async (error: unknown) => {\n          const requestId = randomUUID();\n          reportError(error, requestId);\n          const destroySafely = (cause: unknown, previous?: unknown): void => {\n            try { response.destroy(cause instanceof Error ? cause : undefined); }\n            catch (destroyError) {\n              if (!Object.is(destroyError, error) && !Object.is(destroyError, cause) && !Object.is(destroyError, previous)) {\n                reportError(destroyError, requestId);\n              }\n            }\n          };\n          try {\n            if (response.headersSent) { destroySafely(error); return; }\n            const failure = errorResponse(error, requestId);\n            const failureHeaders: Record<string, string | string[]> = {};\n            failure.headers.forEach((value, name) => { failureHeaders[name] = value; });\n            const cookies = failure.headers.getSetCookie();\n            if (cookies.length) failureHeaders[\"set-cookie\"] = cookies;\n            response.writeHead(failure.status, failureHeaders);\n            response.end(await failure.text());\n          } catch (failure) {\n            if (!Object.is(failure, error)) reportError(failure, requestId);\n            destroySafely(failure, error);\n          }\n        });\n        return;\n      }\n      if (vite) {\n        vite.middlewares(request, response, () => pageListener(request, response));\n        return;\n      }\n      pageListener(request, response);\n    });\n    socketServer = appRuntime.manifest.socket?.length ? attachNodeWebSocketServer({\n      server, hub: appRuntime.socketHub,\n      publicOrigin: process.env.PUBLIC_ORIGIN || `http://127.0.0.1:${port}`,\n      onError: (error) => reportError(error, randomUUID()),\n    }) : undefined;\n    await new Promise<void>((done, fail) => {\n      server.once(\"error\", fail);\n      server.listen(port, \"127.0.0.1\", () => {\n        server.off(\"error\", fail);\n        done();\n      });\n    });\n    let stopping = false;\n    const shutdown = () => {\n      if (stopping) return;\n      stopping = true;\n      process.off(\"SIGINT\", shutdown);\n      process.off(\"SIGTERM\", shutdown);\n      void (async () => {\n        const steps: Array<() => Promise<unknown>> = [\n          () => socketServer?.close() ?? Promise.resolve(),\n          () => new Promise<void>((done, fail) => server.close((error) => error ? fail(error) : done())),\n          () => appRuntime.sessions.close(),\n          () => vite?.close() ?? Promise.resolve(),\n        ];\n        for (const close of steps) {\n          try { await close(); }\n          catch (error) { reportError(error, randomUUID()); }\n        }\n      })();\n    };\n    process.once(\"SIGINT\", shutdown);\n    process.once(\"SIGTERM\", shutdown);\n    process.stdout.write(`http://127.0.0.1:${port}\\n`);\n    return server;\n  } catch (error) {\n    const cleanup = await Promise.allSettled([socketServer?.close(), runtime?.sessions.close(), vite?.close()]);\n    for (const result of cleanup) {\n      if (result.status === \"rejected\") reportError(result.reason, randomUUID());\n    }\n    throw error;\n  }\n}\n"]}

package/dist/framework/router.d.ts

@@ -32,8 +32,10 @@ export interface Navigator {
     }): Promise<boolean>;
     dispose(): void;
 }
+/** Browser events cannot return a navigation promise, so surface failures safely. */
+export declare function reportNavigationError(browser: Window, error: unknown, observer?: (error: unknown) => void): void;
 /**
  * The host owns actual DOM outlet rendering. Its callback receives layout
  * identity so it can retain matching layout instances and release exited ones.
  */
-export declare function createNavigator(routes: readonly RouteRecord[], render: (context: NavigationContext) => Promise<void> | void, browser?: Window): Navigator;
+export declare function createNavigator(routes: readonly RouteRecord[], render: (context: NavigationContext) => Promise<void | boolean> | void | boolean, browser?: Window, onError?: (error: unknown) => void): Navigator;

package/dist/framework/router.js

@@ -1,3 +1,4 @@
+import { observeCallback } from "../error-observer.js";
 function segments(id) {
     if (!id.startsWith("/"))
         throw new TypeError(`Route must start with /: ${id}`);
@@ -119,12 +120,27 @@ export function href(routes, id, options = {}) {
             url.searchParams.set(key, String(value));
     return url.pathname + url.search;
 }
+/** Browser events cannot return a navigation promise, so surface failures safely. */
+export function reportNavigationError(browser, error, observer) {
+    const logger = browser.console ?? console;
+    const reportObserverFailure = (observerError) => {
+        try {
+            logger.error("Meeko navigation error observer failed", observerError, error);
+        }
+        catch { /* A broken console must not produce an unhandled rejection. */ }
+    };
+    if (observer)
+        observeCallback(() => observer(error), reportObserverFailure);
+    else
+        observeCallback(() => logger.error("Meeko navigation failed", error), () => { });
+}
 /**
  * The host owns actual DOM outlet rendering. Its callback receives layout
  * identity so it can retain matching layout instances and release exited ones.
  */
-export function createNavigator(routes, render, browser = window) {
+export function createNavigator(routes, render, browser = window, onError) {
     let current = matchRoute(routes, browser.location.pathname);
+    let currentUrl = browser.location.href;
     let pending;
     let disposed = false;
     const navigate = async (to, options = {}) => {
@@ -134,8 +150,23 @@ export function createNavigator(routes, render, browser = window) {
         if (url.origin !== browser.location.origin)
             throw new TypeError("External navigation is not a Meeko route");
         const match = matchRoute(routes, url.pathname);
-        if (!match)
+        if (!match) {
+            if (options.replace && browser.location.href === url.href) {
+                try {
+                    browser.history.replaceState(null, "", currentUrl);
+                }
+                catch (historyError) {
+                    try {
+                        browser.location.replace(currentUrl);
+                    }
+                    catch (recoveryError) {
+                        throw new AggregateError([historyError, recoveryError], "Meeko history and URL recovery failed");
+                    }
+                    throw historyError;
+                }
+            }
             return false;
+        }
         pending?.abort();
         const controller = new AbortController();
         pending = controller;
@@ -146,19 +177,74 @@ export function createNavigator(routes, render, browser = window) {
                 && retainedLayouts < match.route.layouts.length)
                 retainedLayouts++;
         }
-        await render({ url, match, signal: controller.signal, retainedLayouts });
+        let result;
+        try {
+            result = await render({ url, match, signal: controller.signal, retainedLayouts });
+        }
+        catch (error) {
+            if (pending === controller)
+                pending = undefined;
+            if (options.replace && !controller.signal.aborted && !disposed && browser.location.href === url.href) {
+                try {
+                    browser.history.replaceState(null, "", currentUrl);
+                }
+                catch (historyError) {
+                    try {
+                        browser.location.replace(currentUrl);
+                    }
+                    catch (recoveryError) {
+                        throw new AggregateError([error, historyError, recoveryError], "Meeko navigation and URL recovery failed");
+                    }
+                    throw new AggregateError([error, historyError], "Meeko navigation and history recovery failed");
+                }
+            }
+            throw error;
+        }
+        if (result === false) {
+            if (pending === controller)
+                pending = undefined;
+            if (options.replace && !controller.signal.aborted && browser.location.href === url.href) {
+                try {
+                    browser.history.replaceState(null, "", currentUrl);
+                }
+                catch (historyError) {
+                    try {
+                        browser.location.replace(currentUrl);
+                    }
+                    catch (recoveryError) {
+                        throw new AggregateError([historyError, recoveryError], "Meeko history and URL recovery failed");
+                    }
+                    throw historyError;
+                }
+            }
+            return false;
+        }
         if (controller.signal.aborted || disposed)
             return false;
-        if (options.replace)
-            browser.history.replaceState(null, "", url);
-        else
-            browser.history.pushState(null, "", url);
+        try {
+            if (options.replace)
+                browser.history.replaceState(null, "", url);
+            else
+                browser.history.pushState(null, "", url);
+        }
+        catch (error) {
+            if (pending === controller)
+                pending = undefined;
+            try {
+                browser.location.replace(currentUrl);
+            }
+            catch (recoveryError) {
+                throw new AggregateError([error, recoveryError], "Meeko history update and navigation recovery failed");
+            }
+            throw error;
+        }
         current = match;
+        currentUrl = url.href;
         pending = undefined;
         return true;
     };
     const onPop = () => {
-        void navigate(browser.location.href, { replace: true });
+        void navigate(browser.location.href, { replace: true }).catch((error) => reportNavigationError(browser, error, onError));
     };
     browser.addEventListener("popstate", onPop);
     return {

package/dist/framework/router.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/framework/router.ts"],"names":[],"mappings":"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","sourcesContent":["/** A route manifest is shared by the server renderer and browser navigator. */\nexport interface RouteRecord {\n  readonly id: string;\n  readonly file: string;\n  readonly layouts: readonly string[];\n  readonly error?: string;\n  readonly sidecar?: string;\n}\n\nexport interface RouteMatch {\n  readonly route: RouteRecord;\n  readonly params: Readonly<Record<string, string>>;\n}\n\ntype Segment = { kind: \"static\" | \"param\" | \"rest\"; value: string };\n\nfunction segments(id: string): Segment[] {\n  if (!id.startsWith(\"/\")) throw new TypeError(`Route must start with /: ${id}`);\n  return id.split(\"/\").slice(1).filter(Boolean).map((part, index, all) => {\n    if (/^\\[\\.\\.\\.[A-Za-z_$][\\w$]*\\]$/.test(part)) {\n      if (index !== all.length - 1) throw new TypeError(`Catch-all must be final: ${id}`);\n      return { kind: \"rest\", value: part.slice(4, -1) };\n    }\n    if (/^\\[[A-Za-z_$][\\w$]*\\]$/.test(part)) return { kind: \"param\", value: part.slice(1, -1) };\n    if (part.includes(\"[\") || part.includes(\"]\")) throw new TypeError(`Invalid route segment: ${part}`);\n    return { kind: \"static\", value: part };\n  });\n}\n\nfunction rank(id: string): number[] {\n  return segments(id).map((part) => part.kind === \"static\" ? 3 : part.kind === \"param\" ? 2 : 1);\n}\n\nfunction compareRoute(a: RouteRecord, b: RouteRecord): number {\n  const left = rank(a.id);\n  const right = rank(b.id);\n  for (let index = 0; index < Math.max(left.length, right.length); index++) {\n    const score = (right[index] ?? 0) - (left[index] ?? 0);\n    if (score) return score;\n  }\n  return a.id.localeCompare(b.id);\n}\n\nfunction collisionKey(id: string): string {\n  return segments(id).map((part) => part.kind === \"static\" ? part.value : part.kind === \"param\" ? \"[]\" : \"[...]\").join(\"/\");\n}\n\nfunction decodePart(part: string): string | undefined {\n  try {\n    const value = decodeURIComponent(part);\n    return value.includes(\"/\") || value.includes(\"\\\\\") || value === \".\" || value === \"..\" ? undefined : value;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Validates collisions before sorting static routes ahead of parameters. */\nexport function createRouteManifest(routes: readonly RouteRecord[]): readonly RouteRecord[] {\n  const keys = new Map<string, string>();\n  for (const route of routes) {\n    const key = collisionKey(route.id);\n    const previous = keys.get(key);\n    if (previous) throw new Error(`Route collision: ${previous} and ${route.file} both resolve to ${key || \"/\"}`);\n    keys.set(key, route.file);\n  }\n  return Object.freeze([...routes].sort(compareRoute));\n}\n\n/** Resolves a URL against the same manifest used for SSR and client navigation. */\nexport function matchRoute(routes: readonly RouteRecord[], pathname: string): RouteMatch | undefined {\n  if (!pathname.startsWith(\"/\")) return undefined;\n  const raw = pathname.split(\"/\").slice(1).filter(Boolean);\n  const path = raw.map(decodePart);\n  if (path.some((part) => part === undefined)) return undefined;\n  for (const route of routes) {\n    const pattern = segments(route.id);\n    const params: Record<string, string> = {};\n    let index = 0;\n    let matched = true;\n    for (const part of pattern) {\n      if (part.kind === \"rest\") {\n        if (index === path.length) { matched = false; break; }\n        params[part.value] = path.slice(index).join(\"/\");\n        index = path.length;\n        break;\n      }\n      const value = path[index++];\n      if (value === undefined || (part.kind === \"static\" && part.value !== value)) { matched = false; break; }\n      if (part.kind === \"param\") params[part.value] = value;\n    }\n    if (matched && index === path.length) return { route, params };\n  }\n  return undefined;\n}\n\n/** Builds a URL from a manifest route and rejects absent or extra parameters. */\nexport function href(routes: readonly RouteRecord[], id: string, options: {\n  params?: Readonly<Record<string, string>>;\n  search?: Readonly<Record<string, string | number | boolean | null | undefined>>;\n} = {}): string {\n  if (!routes.some((route) => route.id === id)) throw new Error(`Unknown route: ${id}`);\n  const params = options.params ?? {};\n  const used = new Set<string>();\n  const path = segments(id).map((part) => {\n    if (part.kind === \"static\") return encodeURIComponent(part.value);\n    const value = params[part.value];\n    if (!value) throw new Error(`Missing route parameter: ${part.value}`);\n    used.add(part.value);\n    if (part.kind === \"rest\") {\n      const pieces = value.split(\"/\");\n      if (pieces.some((piece) => !piece || piece === \".\" || piece === \"..\")) throw new Error(`Invalid catch-all parameter: ${part.value}`);\n      return pieces.map(encodeURIComponent).join(\"/\");\n    }\n    if (value.includes(\"/\") || value === \".\" || value === \"..\") throw new Error(`Invalid route parameter: ${part.value}`);\n    return encodeURIComponent(value);\n  });\n  for (const key of Object.keys(params)) if (!used.has(key)) throw new Error(`Unknown route parameter: ${key}`);\n  const url = new URL(path.length ? `/${path.join(\"/\")}` : \"/\", \"http://meeko.local\");\n  for (const [key, value] of Object.entries(options.search ?? {})) if (value !== null && value !== undefined) url.searchParams.set(key, String(value));\n  return url.pathname + url.search;\n}\n\nexport interface NavigationContext {\n  readonly url: URL;\n  readonly match: RouteMatch;\n  readonly signal: AbortSignal;\n  /** Longest prefix shared with the previous route's layout chain. */\n  readonly retainedLayouts: number;\n}\n\nexport interface Navigator {\n  navigate(to: string, options?: { replace?: boolean }): Promise<boolean>;\n  dispose(): void;\n}\n\n/**\n * The host owns actual DOM outlet rendering. Its callback receives layout\n * identity so it can retain matching layout instances and release exited ones.\n */\nexport function createNavigator(routes: readonly RouteRecord[], render: (context: NavigationContext) => Promise<void> | void, browser: Window = window): Navigator {\n  let current = matchRoute(routes, browser.location.pathname);\n  let pending: AbortController | undefined;\n  let disposed = false;\n  const navigate = async (to: string, options: { replace?: boolean } = {}): Promise<boolean> => {\n    if (disposed) throw new Error(\"Navigator disposed\");\n    const url = new URL(to, browser.location.href);\n    if (url.origin !== browser.location.origin) throw new TypeError(\"External navigation is not a Meeko route\");\n    const match = matchRoute(routes, url.pathname);\n    if (!match) return false;\n    pending?.abort();\n    const controller = new AbortController();\n    pending = controller;\n    let retainedLayouts = 0;\n    if (current) {\n      while (current.route.layouts[retainedLayouts] === match.route.layouts[retainedLayouts]\n        && retainedLayouts < current.route.layouts.length\n        && retainedLayouts < match.route.layouts.length) retainedLayouts++;\n    }\n    await render({ url, match, signal: controller.signal, retainedLayouts });\n    if (controller.signal.aborted || disposed) return false;\n    if (options.replace) browser.history.replaceState(null, \"\", url);\n    else browser.history.pushState(null, \"\", url);\n    current = match;\n    pending = undefined;\n    return true;\n  };\n  const onPop = () => {\n    void navigate(browser.location.href, { replace: true });\n  };\n  browser.addEventListener(\"popstate\", onPop);\n  return {\n    navigate,\n    dispose() {\n      disposed = true;\n      pending?.abort();\n      browser.removeEventListener(\"popstate\", onPop);\n    },\n  };\n}\n"]}
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/framework/router.ts"],"names":[],"mappings":"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","sourcesContent":["import { observeCallback } from \"../error-observer.js\";\n\n/** A route manifest is shared by the server renderer and browser navigator. */\nexport interface RouteRecord {\n  readonly id: string;\n  readonly file: string;\n  readonly layouts: readonly string[];\n  readonly error?: string;\n  readonly sidecar?: string;\n}\n\nexport interface RouteMatch {\n  readonly route: RouteRecord;\n  readonly params: Readonly<Record<string, string>>;\n}\n\ntype Segment = { kind: \"static\" | \"param\" | \"rest\"; value: string };\n\nfunction segments(id: string): Segment[] {\n  if (!id.startsWith(\"/\")) throw new TypeError(`Route must start with /: ${id}`);\n  return id.split(\"/\").slice(1).filter(Boolean).map((part, index, all) => {\n    if (/^\\[\\.\\.\\.[A-Za-z_$][\\w$]*\\]$/.test(part)) {\n      if (index !== all.length - 1) throw new TypeError(`Catch-all must be final: ${id}`);\n      return { kind: \"rest\", value: part.slice(4, -1) };\n    }\n    if (/^\\[[A-Za-z_$][\\w$]*\\]$/.test(part)) return { kind: \"param\", value: part.slice(1, -1) };\n    if (part.includes(\"[\") || part.includes(\"]\")) throw new TypeError(`Invalid route segment: ${part}`);\n    return { kind: \"static\", value: part };\n  });\n}\n\nfunction rank(id: string): number[] {\n  return segments(id).map((part) => part.kind === \"static\" ? 3 : part.kind === \"param\" ? 2 : 1);\n}\n\nfunction compareRoute(a: RouteRecord, b: RouteRecord): number {\n  const left = rank(a.id);\n  const right = rank(b.id);\n  for (let index = 0; index < Math.max(left.length, right.length); index++) {\n    const score = (right[index] ?? 0) - (left[index] ?? 0);\n    if (score) return score;\n  }\n  return a.id.localeCompare(b.id);\n}\n\nfunction collisionKey(id: string): string {\n  return segments(id).map((part) => part.kind === \"static\" ? part.value : part.kind === \"param\" ? \"[]\" : \"[...]\").join(\"/\");\n}\n\nfunction decodePart(part: string): string | undefined {\n  try {\n    const value = decodeURIComponent(part);\n    return value.includes(\"/\") || value.includes(\"\\\\\") || value === \".\" || value === \"..\" ? undefined : value;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Validates collisions before sorting static routes ahead of parameters. */\nexport function createRouteManifest(routes: readonly RouteRecord[]): readonly RouteRecord[] {\n  const keys = new Map<string, string>();\n  for (const route of routes) {\n    const key = collisionKey(route.id);\n    const previous = keys.get(key);\n    if (previous) throw new Error(`Route collision: ${previous} and ${route.file} both resolve to ${key || \"/\"}`);\n    keys.set(key, route.file);\n  }\n  return Object.freeze([...routes].sort(compareRoute));\n}\n\n/** Resolves a URL against the same manifest used for SSR and client navigation. */\nexport function matchRoute(routes: readonly RouteRecord[], pathname: string): RouteMatch | undefined {\n  if (!pathname.startsWith(\"/\")) return undefined;\n  const raw = pathname.split(\"/\").slice(1).filter(Boolean);\n  const path = raw.map(decodePart);\n  if (path.some((part) => part === undefined)) return undefined;\n  for (const route of routes) {\n    const pattern = segments(route.id);\n    const params: Record<string, string> = {};\n    let index = 0;\n    let matched = true;\n    for (const part of pattern) {\n      if (part.kind === \"rest\") {\n        if (index === path.length) { matched = false; break; }\n        params[part.value] = path.slice(index).join(\"/\");\n        index = path.length;\n        break;\n      }\n      const value = path[index++];\n      if (value === undefined || (part.kind === \"static\" && part.value !== value)) { matched = false; break; }\n      if (part.kind === \"param\") params[part.value] = value;\n    }\n    if (matched && index === path.length) return { route, params };\n  }\n  return undefined;\n}\n\n/** Builds a URL from a manifest route and rejects absent or extra parameters. */\nexport function href(routes: readonly RouteRecord[], id: string, options: {\n  params?: Readonly<Record<string, string>>;\n  search?: Readonly<Record<string, string | number | boolean | null | undefined>>;\n} = {}): string {\n  if (!routes.some((route) => route.id === id)) throw new Error(`Unknown route: ${id}`);\n  const params = options.params ?? {};\n  const used = new Set<string>();\n  const path = segments(id).map((part) => {\n    if (part.kind === \"static\") return encodeURIComponent(part.value);\n    const value = params[part.value];\n    if (!value) throw new Error(`Missing route parameter: ${part.value}`);\n    used.add(part.value);\n    if (part.kind === \"rest\") {\n      const pieces = value.split(\"/\");\n      if (pieces.some((piece) => !piece || piece === \".\" || piece === \"..\")) throw new Error(`Invalid catch-all parameter: ${part.value}`);\n      return pieces.map(encodeURIComponent).join(\"/\");\n    }\n    if (value.includes(\"/\") || value === \".\" || value === \"..\") throw new Error(`Invalid route parameter: ${part.value}`);\n    return encodeURIComponent(value);\n  });\n  for (const key of Object.keys(params)) if (!used.has(key)) throw new Error(`Unknown route parameter: ${key}`);\n  const url = new URL(path.length ? `/${path.join(\"/\")}` : \"/\", \"http://meeko.local\");\n  for (const [key, value] of Object.entries(options.search ?? {})) if (value !== null && value !== undefined) url.searchParams.set(key, String(value));\n  return url.pathname + url.search;\n}\n\nexport interface NavigationContext {\n  readonly url: URL;\n  readonly match: RouteMatch;\n  readonly signal: AbortSignal;\n  /** Longest prefix shared with the previous route's layout chain. */\n  readonly retainedLayouts: number;\n}\n\nexport interface Navigator {\n  navigate(to: string, options?: { replace?: boolean }): Promise<boolean>;\n  dispose(): void;\n}\n\n/** Browser events cannot return a navigation promise, so surface failures safely. */\nexport function reportNavigationError(browser: Window, error: unknown, observer?: (error: unknown) => void): void {\n  const logger = (browser as Window & { console?: { error(...args: unknown[]): void } }).console ?? console;\n  const reportObserverFailure = (observerError: unknown) => {\n    try { logger.error(\"Meeko navigation error observer failed\", observerError, error); }\n    catch { /* A broken console must not produce an unhandled rejection. */ }\n  };\n  if (observer) observeCallback(() => observer(error), reportObserverFailure);\n  else observeCallback(() => logger.error(\"Meeko navigation failed\", error), () => {});\n}\n\n/**\n * The host owns actual DOM outlet rendering. Its callback receives layout\n * identity so it can retain matching layout instances and release exited ones.\n */\nexport function createNavigator(routes: readonly RouteRecord[], render: (context: NavigationContext) => Promise<void | boolean> | void | boolean, browser: Window = window, onError?: (error: unknown) => void): Navigator {\n  let current = matchRoute(routes, browser.location.pathname);\n  let currentUrl = browser.location.href;\n  let pending: AbortController | undefined;\n  let disposed = false;\n  const navigate = async (to: string, options: { replace?: boolean } = {}): Promise<boolean> => {\n    if (disposed) throw new Error(\"Navigator disposed\");\n    const url = new URL(to, browser.location.href);\n    if (url.origin !== browser.location.origin) throw new TypeError(\"External navigation is not a Meeko route\");\n    const match = matchRoute(routes, url.pathname);\n    if (!match) {\n      if (options.replace && browser.location.href === url.href) {\n        try { browser.history.replaceState(null, \"\", currentUrl); }\n        catch (historyError) {\n          try { browser.location.replace(currentUrl); }\n          catch (recoveryError) {\n            throw new AggregateError([historyError, recoveryError], \"Meeko history and URL recovery failed\");\n          }\n          throw historyError;\n        }\n      }\n      return false;\n    }\n    pending?.abort();\n    const controller = new AbortController();\n    pending = controller;\n    let retainedLayouts = 0;\n    if (current) {\n      while (current.route.layouts[retainedLayouts] === match.route.layouts[retainedLayouts]\n        && retainedLayouts < current.route.layouts.length\n        && retainedLayouts < match.route.layouts.length) retainedLayouts++;\n    }\n    let result: void | boolean;\n    try { result = await render({ url, match, signal: controller.signal, retainedLayouts }); }\n    catch (error) {\n      if (pending === controller) pending = undefined;\n      if (options.replace && !controller.signal.aborted && !disposed && browser.location.href === url.href) {\n        try { browser.history.replaceState(null, \"\", currentUrl); }\n        catch (historyError) {\n          try { browser.location.replace(currentUrl); }\n          catch (recoveryError) {\n            throw new AggregateError([error, historyError, recoveryError], \"Meeko navigation and URL recovery failed\");\n          }\n          throw new AggregateError([error, historyError], \"Meeko navigation and history recovery failed\");\n        }\n      }\n      throw error;\n    }\n    if (result === false) {\n      if (pending === controller) pending = undefined;\n      if (options.replace && !controller.signal.aborted && browser.location.href === url.href) {\n        try { browser.history.replaceState(null, \"\", currentUrl); }\n        catch (historyError) {\n          try { browser.location.replace(currentUrl); }\n          catch (recoveryError) {\n            throw new AggregateError([historyError, recoveryError], \"Meeko history and URL recovery failed\");\n          }\n          throw historyError;\n        }\n      }\n      return false;\n    }\n    if (controller.signal.aborted || disposed) return false;\n    try {\n      if (options.replace) browser.history.replaceState(null, \"\", url);\n      else browser.history.pushState(null, \"\", url);\n    } catch (error) {\n      if (pending === controller) pending = undefined;\n      try { browser.location.replace(currentUrl); }\n      catch (recoveryError) {\n        throw new AggregateError([error, recoveryError], \"Meeko history update and navigation recovery failed\");\n      }\n      throw error;\n    }\n    current = match;\n    currentUrl = url.href;\n    pending = undefined;\n    return true;\n  };\n  const onPop = () => {\n    void navigate(browser.location.href, { replace: true }).catch((error: unknown) => reportNavigationError(browser, error, onError));\n  };\n  browser.addEventListener(\"popstate\", onPop);\n  return {\n    navigate,\n    dispose() {\n      disposed = true;\n      pending?.abort();\n      browser.removeEventListener(\"popstate\", onPop);\n    },\n  };\n}\n"]}

package/dist/framework/server.d.ts

@@ -1,5 +1,6 @@
 import type { RequestContext } from "../framework-server/context.js";
 import type { ServerFetch } from "../framework-server/context.js";
+import type { RouteMiddleware } from "./middleware.js";
 import type { PageSchema } from "./page.js";
 import { StateStore } from "./state.js";
 import type { RouteRecord } from "./router.js";
@@ -22,7 +23,7 @@ export interface PageRoute {
     }) => {
         title?: string;
     };
-    render?: "ssr" | "prerender" | "client";
+    render?: "ssr" | "prerender";
     prerenderEntries?: readonly Readonly<Record<string, string>>[] | (() => Promise<readonly Readonly<Record<string, string>>[]>);
 }
 export interface PageRequestContext {
@@ -36,16 +37,29 @@ export interface PageRequestContext {
     /** Present when the host supplies a per-request context. */
     readonly context?: RequestContext;
 }
-export interface FrameworkHandlerOptions {
+export interface FrameworkHandlerOptions<Route = PageRoute> {
     readonly routes: readonly RouteRecord[];
     readonly loadPage: (file: string) => Promise<PageModule>;
-    readonly loadRoute?: (file: string) => Promise<PageRoute>;
+    readonly loadRoute?: (file: string) => Promise<Route>;
+    /** Isomorphic route middleware, evaluated before the route sidecar loader. */
+    readonly loadMiddleware?: () => Promise<readonly RouteMiddleware[]>;
     readonly createContext?: (request: Request) => RequestContext | Promise<RequestContext>;
     /** Optional in-process dispatcher for automatic API/RPC calls during SSR. */
     readonly serverFetch?: ServerFetch;
+    /** Receives internal page failures with the request ID; never sent to the browser. */
+    readonly onError?: (error: unknown, requestId: string) => void;
     /** Optional host layout renderer; default composition uses <component is="props.outlet"/>. */
     readonly renderLayout?: (file: string, children: string, context: PageRequestContext) => Promise<string> | string;
     readonly clientEntry?: string;
 }
+/** A typed sidecar may narrow callback arguments after its schemas validate them. */
+type TypedPageRoute = Omit<PageRoute, "load" | "head"> & {
+    load?: (context: never) => Promise<unknown> | unknown;
+    head?: (context: never) => {
+        title?: string;
+    };
+};
 /** Portable Fetch handler. Node adapters can pass their Request directly. */
 export declare function createFrameworkHandler(options: FrameworkHandlerOptions): (request: Request) => Promise<Response>;
+export declare function createFrameworkHandler<Route extends TypedPageRoute>(options: FrameworkHandlerOptions<Route>): (request: Request) => Promise<Response>;
+export {};