@meekojs/meeko 0.0.3 → 0.1.0

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

@@ -0,0 +1,41 @@
+/** A route manifest is shared by the server renderer and browser navigator. */
+export interface RouteRecord {
+    readonly id: string;
+    readonly file: string;
+    readonly layouts: readonly string[];
+    readonly error?: string;
+    readonly sidecar?: string;
+}
+export interface RouteMatch {
+    readonly route: RouteRecord;
+    readonly params: Readonly<Record<string, string>>;
+}
+/** Validates collisions before sorting static routes ahead of parameters. */
+export declare function createRouteManifest(routes: readonly RouteRecord[]): readonly RouteRecord[];
+/** Resolves a URL against the same manifest used for SSR and client navigation. */
+export declare function matchRoute(routes: readonly RouteRecord[], pathname: string): RouteMatch | undefined;
+/** Builds a URL from a manifest route and rejects absent or extra parameters. */
+export declare function href(routes: readonly RouteRecord[], id: string, options?: {
+    params?: Readonly<Record<string, string>>;
+    search?: Readonly<Record<string, string | number | boolean | null | undefined>>;
+}): string;
+export interface NavigationContext {
+    readonly url: URL;
+    readonly match: RouteMatch;
+    readonly signal: AbortSignal;
+    /** Longest prefix shared with the previous route's layout chain. */
+    readonly retainedLayouts: number;
+}
+export interface Navigator {
+    navigate(to: string, options?: {
+        replace?: boolean;
+    }): 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 | boolean> | void | boolean, browser?: Window, onError?: (error: unknown) => void): Navigator;

package/dist/framework/router.js

@@ -0,0 +1,259 @@
+import { observeCallback } from "../error-observer.js";
+function segments(id) {
+    if (!id.startsWith("/"))
+        throw new TypeError(`Route must start with /: ${id}`);
+    return id.split("/").slice(1).filter(Boolean).map((part, index, all) => {
+        if (/^\[\.\.\.[A-Za-z_$][\w$]*\]$/.test(part)) {
+            if (index !== all.length - 1)
+                throw new TypeError(`Catch-all must be final: ${id}`);
+            return { kind: "rest", value: part.slice(4, -1) };
+        }
+        if (/^\[[A-Za-z_$][\w$]*\]$/.test(part))
+            return { kind: "param", value: part.slice(1, -1) };
+        if (part.includes("[") || part.includes("]"))
+            throw new TypeError(`Invalid route segment: ${part}`);
+        return { kind: "static", value: part };
+    });
+}
+function rank(id) {
+    return segments(id).map((part) => part.kind === "static" ? 3 : part.kind === "param" ? 2 : 1);
+}
+function compareRoute(a, b) {
+    const left = rank(a.id);
+    const right = rank(b.id);
+    for (let index = 0; index < Math.max(left.length, right.length); index++) {
+        const score = (right[index] ?? 0) - (left[index] ?? 0);
+        if (score)
+            return score;
+    }
+    return a.id.localeCompare(b.id);
+}
+function collisionKey(id) {
+    return segments(id).map((part) => part.kind === "static" ? part.value : part.kind === "param" ? "[]" : "[...]").join("/");
+}
+function decodePart(part) {
+    try {
+        const value = decodeURIComponent(part);
+        return value.includes("/") || value.includes("\\") || value === "." || value === ".." ? undefined : value;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Validates collisions before sorting static routes ahead of parameters. */
+export function createRouteManifest(routes) {
+    const keys = new Map();
+    for (const route of routes) {
+        const key = collisionKey(route.id);
+        const previous = keys.get(key);
+        if (previous)
+            throw new Error(`Route collision: ${previous} and ${route.file} both resolve to ${key || "/"}`);
+        keys.set(key, route.file);
+    }
+    return Object.freeze([...routes].sort(compareRoute));
+}
+/** Resolves a URL against the same manifest used for SSR and client navigation. */
+export function matchRoute(routes, pathname) {
+    if (!pathname.startsWith("/"))
+        return undefined;
+    const raw = pathname.split("/").slice(1).filter(Boolean);
+    const path = raw.map(decodePart);
+    if (path.some((part) => part === undefined))
+        return undefined;
+    for (const route of routes) {
+        const pattern = segments(route.id);
+        const params = {};
+        let index = 0;
+        let matched = true;
+        for (const part of pattern) {
+            if (part.kind === "rest") {
+                if (index === path.length) {
+                    matched = false;
+                    break;
+                }
+                params[part.value] = path.slice(index).join("/");
+                index = path.length;
+                break;
+            }
+            const value = path[index++];
+            if (value === undefined || (part.kind === "static" && part.value !== value)) {
+                matched = false;
+                break;
+            }
+            if (part.kind === "param")
+                params[part.value] = value;
+        }
+        if (matched && index === path.length)
+            return { route, params };
+    }
+    return undefined;
+}
+/** Builds a URL from a manifest route and rejects absent or extra parameters. */
+export function href(routes, id, options = {}) {
+    if (!routes.some((route) => route.id === id))
+        throw new Error(`Unknown route: ${id}`);
+    const params = options.params ?? {};
+    const used = new Set();
+    const path = segments(id).map((part) => {
+        if (part.kind === "static")
+            return encodeURIComponent(part.value);
+        const value = params[part.value];
+        if (!value)
+            throw new Error(`Missing route parameter: ${part.value}`);
+        used.add(part.value);
+        if (part.kind === "rest") {
+            const pieces = value.split("/");
+            if (pieces.some((piece) => !piece || piece === "." || piece === ".."))
+                throw new Error(`Invalid catch-all parameter: ${part.value}`);
+            return pieces.map(encodeURIComponent).join("/");
+        }
+        if (value.includes("/") || value === "." || value === "..")
+            throw new Error(`Invalid route parameter: ${part.value}`);
+        return encodeURIComponent(value);
+    });
+    for (const key of Object.keys(params))
+        if (!used.has(key))
+            throw new Error(`Unknown route parameter: ${key}`);
+    const url = new URL(path.length ? `/${path.join("/")}` : "/", "http://meeko.local");
+    for (const [key, value] of Object.entries(options.search ?? {}))
+        if (value !== null && value !== undefined)
+            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, onError) {
+    let current = matchRoute(routes, browser.location.pathname);
+    let currentUrl = browser.location.href;
+    let pending;
+    let disposed = false;
+    const navigate = async (to, options = {}) => {
+        if (disposed)
+            throw new Error("Navigator disposed");
+        const url = new URL(to, browser.location.href);
+        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 (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;
+        let retainedLayouts = 0;
+        if (current) {
+            while (current.route.layouts[retainedLayouts] === match.route.layouts[retainedLayouts]
+                && retainedLayouts < current.route.layouts.length
+                && retainedLayouts < match.route.layouts.length)
+                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;
+        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 }).catch((error) => reportNavigationError(browser, error, onError));
+    };
+    browser.addEventListener("popstate", onPop);
+    return {
+        navigate,
+        dispose() {
+            disposed = true;
+            pending?.abort();
+            browser.removeEventListener("popstate", onPop);
+        },
+    };
+}
+//# sourceMappingURL=router.js.map