@meekojs/meeko 0.0.2 → 0.0.4

package/dist/framework/init.js

@@ -0,0 +1,362 @@
+import { mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
+const allowedEntries = new Set(["package.json", "package-lock.json", "pnpm-lock.yaml", "pnpm-workspace.yaml", "yarn.lock", "node_modules", ".npmrc", ".git"]);
+const files = {
+    ".gitignore": "node_modules/\n.meeko/\n",
+    "public/.gitkeep": "",
+    "meeko.config.ts": `import { defineMeekoConfig } from "@meekojs/meeko/framework";
+
+export default defineMeekoConfig({
+  extends: [],
+  modules: [],
+  imports: { serverDirs: [] },
+});
+`,
+    "vite.config.ts": `import { defineConfig } from "vite";
+import { meeko } from "@meekojs/meeko/vite";
+
+export default defineConfig({
+  plugins: [meeko()],
+  build: {
+    outDir: ".meeko/output/client",
+    manifest: true,
+    rollupOptions: { input: "app/entry-client.ts" },
+  },
+});
+`,
+    "vite.server.config.ts": `import { defineConfig } from "vite";
+import { meeko } from "@meekojs/meeko/vite";
+
+export default defineConfig({
+  plugins: [meeko()],
+  build: {
+    ssr: "server/entry.ts",
+    outDir: ".meeko/output/server",
+    rollupOptions: { output: { entryFileNames: "entry.js" } },
+  },
+});
+`,
+    "tsconfig.json": `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022", "DOM"],
+    "types": ["node", "vite/client"],
+    "strict": true,
+    "noEmit": true,
+    "allowArbitraryExtensions": true,
+    "skipLibCheck": true
+  },
+  "include": ["vite.config.ts", "vite.server.config.ts"]
+}
+`,
+    "tsconfig.app.json": `{
+  "extends": "./tsconfig.json",
+  "compilerOptions": { "rootDirs": [".", ".meeko/types"] },
+  "include": ["app/**/*.ts", "layers/**/app/**/*.ts", "modules/**/app/**/*.ts", ".meeko/types/**/*.d.meeko.ts", ".meeko/types/routes.d.ts", ".meeko/types/virtual-pages.d.ts", ".meeko/types/server-contracts.d.ts", ".meeko/types/autoimports/client.d.ts"],
+  "exclude": ["app/pages/**/*.route.ts", "layers/**/app/pages/**/*.route.ts", "modules/**/app/pages/**/*.route.ts"]
+}
+`,
+    "tsconfig.server.json": `{
+  "extends": "./tsconfig.json",
+  "include": ["server/**/*.ts", "app/pages/**/*.route.ts", "layers/**/app/pages/**/*.route.ts", "modules/**/app/pages/**/*.route.ts", "layers/**/server/**/*.ts", "modules/**/server/**/*.ts", ".meeko/types/virtual-pages.d.ts", ".meeko/types/autoimports/server.d.ts"]
+}
+`,
+    "tsconfig.shared.json": `{
+  "extends": "./tsconfig.json",
+  "include": ["shared/**/*.ts", "layers/**/shared/**/*.ts", "modules/**/shared/**/*.ts", ".meeko/types/autoimports/shared.d.ts"]
+}
+`,
+    "app/pages/index.meeko": `<script lang="ts">
+import { signal } from "@meekojs/meeko";
+
+export interface Props {
+  params: Record<string, string>;
+  search: Record<string, string>;
+  data?: unknown;
+}
+
+const count = signal(0);
+</script>
+
+<template>
+  <section>
+    <h1>Welcome to Meeko</h1>
+    <p>File routes, server rendering, and hydration are ready.</p>
+    <button type="button" on:click="() => count.value++">Count: {count.value}</button>
+  </section>
+</template>
+`,
+    "app/pages/index.route.ts": `import { definePage } from "@meekojs/meeko/framework";
+
+export const route = definePage({ render: "prerender" });
+`,
+    "app/app.meeko": `<script lang="ts">
+import type { ComponentModule } from "@meekojs/meeko";
+
+export interface Props {
+  outlet: ComponentModule<Record<string, unknown>>;
+}
+
+const props = defineProps<Props>();
+</script>
+
+<template>
+  <div class="site-root"><component is="props.outlet"></component></div>
+</template>
+`,
+    "app/pages/+layout.meeko": `<script lang="ts">
+import type { ComponentModule } from "@meekojs/meeko";
+
+export interface Props {
+  outlet: ComponentModule<Record<string, unknown>>;
+}
+
+const props = defineProps<Props>();
+</script>
+
+<template>
+  <div class="app-shell">
+    <header><a href="/">Meeko</a></header>
+    <main><component is="props.outlet"></component></main>
+  </div>
+</template>
+
+<style scoped>
+.app-shell { max-width: 64rem; margin: 0 auto; padding: 2rem; font-family: system-ui, sans-serif; }
+header { margin-bottom: 2rem; }
+</style>
+`,
+    "app/entry-client.ts": `import { mountClientApp, type ClientComponent, type RouteRecord } from "@meekojs/meeko/framework";
+import { modules as pages } from "virtual:meeko-client-pages";
+
+const root = document.getElementById("app");
+const payload = document.getElementById("meeko-payload")?.textContent;
+const routesText = document.getElementById("meeko-routes")?.textContent;
+if (!root || !payload || !routesText) throw new Error("Missing Meeko SSR data");
+const routes = JSON.parse(routesText) as RouteRecord[];
+
+await mountClientApp({
+  root, payload, routes, serverData: true,
+  async loadPage(file) {
+    const load = pages[file];
+    if (!load) throw new Error("Page module missing: " + file);
+    return await load() as ClientComponent;
+  },
+});
+`,
+    "server/entry.ts": `import { createFrameworkHandler, createLocalServerFetch, createRequestContext, createServerDispatcher, createSocketHub, discoverServerManifest, loadSocketChannels, type FrameworkHandlerOptions } from "@meekojs/meeko/server";
+import type { RouteRecord } from "@meekojs/meeko/framework";
+import { modules as pages } from "virtual:meeko-server-pages";
+import { modules as routeModules } from "virtual:meeko-server-routes";
+import { createSessionManager } from "./session.js";
+
+const handlers = import.meta.glob(["/server/api/**/*.ts", "/server/rpc/**/*.ts", "/server/socket/**/*.ts"], { eager: true });
+
+function keyFor(root: string, file: string): string {
+  return "/" + file.slice(root.length).replaceAll("\\\\", "/").replace(/^\\//, "");
+}
+
+export const loadPage = async (root: string, file: string): Promise<Awaited<ReturnType<FrameworkHandlerOptions["loadPage"]>>> => {
+  const key = keyFor(root, file);
+  const module = pages[key];
+  if (!module) throw new Error("Page module missing: " + key);
+  return module as Awaited<ReturnType<FrameworkHandlerOptions["loadPage"]>>;
+};
+
+export const loadRoute = async (root: string, file: string): Promise<Awaited<ReturnType<NonNullable<FrameworkHandlerOptions["loadRoute"]>>>> => {
+  const key = keyFor(root, file);
+  const module = routeModules[key] as Record<string, unknown> | undefined;
+  if (!module) throw new Error("Route module missing: " + key);
+  return (module.route ?? module.default ?? module) as Awaited<ReturnType<NonNullable<FrameworkHandlerOptions["loadRoute"]>>>;
+};
+
+export async function createAppRuntime(root: string, routes: readonly RouteRecord[], clientEntry: string, production: boolean) {
+  const sessions = createSessionManager(production);
+  const manifest = await discoverServerManifest(root);
+  const load = async (file: string) => {
+    const module = handlers[keyFor(root, file)];
+    if (!module) throw new Error("Server handler missing: " + file);
+    return module;
+  };
+  const services = {};
+  const pageHandler = createFrameworkHandler({
+    routes,
+    loadPage: (file) => loadPage(root, file),
+    loadRoute: (file) => loadRoute(root, file),
+    clientEntry,
+    createContext: async (request) => createRequestContext(request, services, await sessions.load(request)),
+    serverFetch: createLocalServerFetch({ manifest, sessions, load }),
+  });
+  const endpointHandler = createServerDispatcher({ manifest, sessions, services, load });
+  const channels = await loadSocketChannels(manifest, load);
+  const socketHub = createSocketHub({ channels, sessions, services });
+  return { pageHandler, endpointHandler, socketHub, sessions, manifest };
+}
+`,
+    "server/session.ts": `import { MemorySessionStore, SessionManager } from "@meekojs/meeko/server";
+
+export function createSessionManager(production: boolean) {
+  if (production) throw new Error("Configure a persistent SessionStore in server/session.ts before production startup");
+  return new SessionManager({ store: new MemorySessionStore(), production: false });
+}
+`,
+    "server.mjs": `import { createServer } from "node:http";
+import { readFile, realpath } from "node:fs/promises";
+import { dirname, extname, relative, resolve, sep } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { createServer as createViteServer } from "vite";
+import { attachNodeWebSocketServer, discoverConfiguredRoutes, toNodeListener } from "@meekojs/meeko/server";
+import { serializeJson } from "@meekojs/meeko";
+
+const root = dirname(fileURLToPath(import.meta.url));
+const production = process.argv.includes("--production");
+const vite = production ? undefined : await createViteServer({
+  root, configFile: resolve(root, "vite.config.ts"),
+  server: { middlewareMode: true }, appType: "custom",
+});
+const clientRoot = resolve(root, ".meeko/output/client");
+const publicRoot = resolve(root, "public");
+const routes = await discoverConfiguredRoutes(root);
+let clientEntry = "/app/entry-client.ts";
+if (production) {
+  const manifest = JSON.parse(await readFile(resolve(clientRoot, ".vite/manifest.json"), "utf8"));
+  const entry = manifest["app/entry-client.ts"];
+  if (!entry?.file) throw new Error("Missing client entry in Vite manifest");
+  clientEntry = "/" + entry.file;
+}
+const serverEntry = production
+  ? await import(pathToFileURL(resolve(root, ".meeko/output/server/entry.js")).href)
+  : await vite.ssrLoadModule("/server/entry.ts");
+const portable = routes.map((route) => ({
+  id: route.id,
+  file: "/" + relative(root, route.file).replaceAll("\\\\", "/"),
+  layouts: route.layouts.map((file) => "/" + relative(root, file).replaceAll("\\\\", "/")),
+  ...(route.error ? { error: "/" + relative(root, route.error).replaceAll("\\\\", "/") } : {}),
+}));
+const runtime = await serverEntry.createAppRuntime(root, routes, clientEntry, production);
+const handler = runtime.pageHandler;
+const decorated = async (request) => {
+  const path = new URL(request.url).pathname;
+  if (path.startsWith("/api/") || path.startsWith("/_meeko/rpc/")) return runtime.endpointHandler(request);
+  const result = await handler(request);
+  if (result.status !== 200 || !(result.headers.get("content-type") || "").includes("text/html")) return result;
+  let html = (await result.text()).replace("</body>", '<script id="meeko-routes" type="application/json">' + serializeJson(portable) + "</script></body>");
+  if (vite) html = await vite.transformIndexHtml(new URL(request.url).pathname, html);
+  return new Response(request.method === "HEAD" ? null : html, { status: result.status, headers: result.headers });
+};
+const pageListener = toNodeListener(decorated);
+const types = { ".js": "text/javascript", ".css": "text/css", ".svg": "image/svg+xml", ".png": "image/png" };
+async function readAsset(assetRoot, path) {
+  const file = resolve(assetRoot, "." + path);
+  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) };
+}
+const server = createServer((request, response) => {
+  const path = new URL(request.url || "/", "http://localhost").pathname;
+  if (production && /\\.[a-z0-9]+$/i.test(path)) {
+    void (async () => {
+      const asset = await readAsset(clientRoot, path) ?? await readAsset(publicRoot, path);
+      if (!asset || asset.status !== 200) { response.writeHead(asset?.status ?? 404); response.end(); return; }
+      response.writeHead(200, { "content-type": types[extname(path)] || "application/octet-stream" });
+      response.end(asset.body);
+    })().catch(() => { response.writeHead(404); response.end(); });
+    return;
+  }
+  if (vite) {
+    vite.middlewares(request, response, () => pageListener(request, response));
+    return;
+  }
+  pageListener(request, response);
+});
+const port = Number(process.env.PORT || 4173);
+const socketServer = runtime.manifest.socket?.length ? attachNodeWebSocketServer({
+  server, hub: runtime.socketHub, publicOrigin: process.env.PUBLIC_ORIGIN || "http://127.0.0.1:" + port,
+}) : undefined;
+server.listen(port, "127.0.0.1", () => console.log("http://127.0.0.1:" + port));
+process.on("SIGINT", () => { void socketServer?.close(); server.close(); void runtime.sessions.close(); void vite?.close(); });
+`,
+    "README.md": `# Meeko framework starter
+
+Requires Node 24.
+
+\`\`\`sh
+npm install
+npm run dev
+\`\`\`
+
+Routes live in \`app/pages\`. \`+layout.meeko\` keeps the shared shell during client navigation. Run \`npm run build\` and \`npm start\` for production SSR. Generated files live under \`.meeko/\`.
+`,
+};
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Creates a framework project without overwriting unrelated user files. */
+export async function initFrameworkProject(directory) {
+    const target = resolve(directory);
+    const name = basename(target).toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^[._-]+|[._-]+$/g, "") || "meeko-app";
+    const metadata = JSON.parse(await readFile(new URL("../../package.json", import.meta.url), "utf8"));
+    if (!record(metadata) || typeof metadata.version !== "string")
+        throw new Error("Meeko package version is unavailable");
+    let entries = [];
+    try {
+        if (!(await stat(target)).isDirectory())
+            throw new Error(`Destination is not a directory: ${target}`);
+        entries = await readdir(target);
+    }
+    catch (error) {
+        if (!(error instanceof Error && "code" in error && error.code === "ENOENT"))
+            throw error;
+    }
+    const unexpected = entries.filter((entry) => !allowedEntries.has(entry));
+    if (unexpected.length || (entries.length && !entries.includes("package.json"))) {
+        throw new Error(`Destination is not empty: ${target}`);
+    }
+    const existing = entries.includes("package.json") ? JSON.parse(await readFile(join(target, "package.json"), "utf8")) : {};
+    if (!record(existing) || (existing.scripts !== undefined && !record(existing.scripts))
+        || (existing.dependencies !== undefined && !record(existing.dependencies))
+        || (existing.devDependencies !== undefined && !record(existing.devDependencies))) {
+        throw new Error(`Invalid package.json in ${target}`);
+    }
+    const scripts = {
+        dev: "node server.mjs",
+        check: "meeko routes . && meeko check-app . && tsc -p tsconfig.json --noEmit && tsc -p tsconfig.shared.json --noEmit && tsc -p tsconfig.app.json --noEmit && tsc -p tsconfig.server.json --noEmit",
+        build: "npm run check && vite build --config vite.config.ts && vite build --config vite.server.config.ts && meeko prerender .",
+        start: "node server.mjs --production",
+    };
+    const oldScripts = existing.scripts;
+    for (const command of Object.keys(scripts))
+        if (oldScripts && command in oldScripts) {
+            throw new Error(`Destination already defines the ${command} script: ${target}`);
+        }
+    const manifest = {
+        ...existing,
+        name: typeof existing.name === "string" ? existing.name : name,
+        private: true,
+        type: "module",
+        engines: { ...(record(existing.engines) ? existing.engines : {}), node: ">=24" },
+        scripts: { ...oldScripts, ...scripts },
+        dependencies: { ...existing.dependencies, "@meekojs/meeko": metadata.version },
+        devDependencies: {
+            ...existing.devDependencies,
+            "@types/node": "^24.0.0", typescript: "^7.0.2", vite: "^8.3.5",
+        },
+    };
+    await mkdir(target, { recursive: true });
+    for (const [filename, content] of Object.entries(files)) {
+        const output = join(target, filename);
+        await mkdir(dirname(output), { recursive: true });
+        await writeFile(output, content, { encoding: "utf8", flag: "wx" });
+    }
+    await writeFile(join(target, "package.json"), JSON.stringify(manifest, null, 2) + "\n", {
+        encoding: "utf8", flag: entries.includes("package.json") ? "w" : "wx",
+    });
+    return target;
+}
+//# sourceMappingURL=init.js.map

package/dist/framework/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/framework/init.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir, readFile, readdir, stat, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\n\nconst allowedEntries = new Set([\"package.json\", \"package-lock.json\", \"pnpm-lock.yaml\", \"pnpm-workspace.yaml\", \"yarn.lock\", \"node_modules\", \".npmrc\", \".git\"]);\n\nconst files: Readonly<Record<string, string>> = {\n  \".gitignore\": \"node_modules/\\n.meeko/\\n\",\n  \"public/.gitkeep\": \"\",\n  \"meeko.config.ts\": `import { defineMeekoConfig } from \"@meekojs/meeko/framework\";\n\nexport default defineMeekoConfig({\n  extends: [],\n  modules: [],\n  imports: { serverDirs: [] },\n});\n`,\n  \"vite.config.ts\": `import { defineConfig } from \"vite\";\nimport { meeko } from \"@meekojs/meeko/vite\";\n\nexport default defineConfig({\n  plugins: [meeko()],\n  build: {\n    outDir: \".meeko/output/client\",\n    manifest: true,\n    rollupOptions: { input: \"app/entry-client.ts\" },\n  },\n});\n`,\n  \"vite.server.config.ts\": `import { defineConfig } from \"vite\";\nimport { meeko } from \"@meekojs/meeko/vite\";\n\nexport default defineConfig({\n  plugins: [meeko()],\n  build: {\n    ssr: \"server/entry.ts\",\n    outDir: \".meeko/output/server\",\n    rollupOptions: { output: { entryFileNames: \"entry.js\" } },\n  },\n});\n`,\n  \"tsconfig.json\": `{\n  \"compilerOptions\": {\n    \"target\": \"ES2022\",\n    \"module\": \"NodeNext\",\n    \"moduleResolution\": \"NodeNext\",\n    \"lib\": [\"ES2022\", \"DOM\"],\n    \"types\": [\"node\", \"vite/client\"],\n    \"strict\": true,\n    \"noEmit\": true,\n    \"allowArbitraryExtensions\": true,\n    \"skipLibCheck\": true\n  },\n  \"include\": [\"vite.config.ts\", \"vite.server.config.ts\"]\n}\n`,\n  \"tsconfig.app.json\": `{\n  \"extends\": \"./tsconfig.json\",\n  \"compilerOptions\": { \"rootDirs\": [\".\", \".meeko/types\"] },\n  \"include\": [\"app/**/*.ts\", \"layers/**/app/**/*.ts\", \"modules/**/app/**/*.ts\", \".meeko/types/**/*.d.meeko.ts\", \".meeko/types/routes.d.ts\", \".meeko/types/virtual-pages.d.ts\", \".meeko/types/server-contracts.d.ts\", \".meeko/types/autoimports/client.d.ts\"],\n  \"exclude\": [\"app/pages/**/*.route.ts\", \"layers/**/app/pages/**/*.route.ts\", \"modules/**/app/pages/**/*.route.ts\"]\n}\n`,\n  \"tsconfig.server.json\": `{\n  \"extends\": \"./tsconfig.json\",\n  \"include\": [\"server/**/*.ts\", \"app/pages/**/*.route.ts\", \"layers/**/app/pages/**/*.route.ts\", \"modules/**/app/pages/**/*.route.ts\", \"layers/**/server/**/*.ts\", \"modules/**/server/**/*.ts\", \".meeko/types/virtual-pages.d.ts\", \".meeko/types/autoimports/server.d.ts\"]\n}\n`,\n  \"tsconfig.shared.json\": `{\n  \"extends\": \"./tsconfig.json\",\n  \"include\": [\"shared/**/*.ts\", \"layers/**/shared/**/*.ts\", \"modules/**/shared/**/*.ts\", \".meeko/types/autoimports/shared.d.ts\"]\n}\n`,\n  \"app/pages/index.meeko\": `<script lang=\"ts\">\nimport { signal } from \"@meekojs/meeko\";\n\nexport interface Props {\n  params: Record<string, string>;\n  search: Record<string, string>;\n  data?: unknown;\n}\n\nconst count = signal(0);\n</script>\n\n<template>\n  <section>\n    <h1>Welcome to Meeko</h1>\n    <p>File routes, server rendering, and hydration are ready.</p>\n    <button type=\"button\" on:click=\"() => count.value++\">Count: {count.value}</button>\n  </section>\n</template>\n`,\n  \"app/pages/index.route.ts\": `import { definePage } from \"@meekojs/meeko/framework\";\n\nexport const route = definePage({ render: \"prerender\" });\n`,\n  \"app/app.meeko\": `<script lang=\"ts\">\nimport type { ComponentModule } from \"@meekojs/meeko\";\n\nexport interface Props {\n  outlet: ComponentModule<Record<string, unknown>>;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n  <div class=\"site-root\"><component is=\"props.outlet\"></component></div>\n</template>\n`,\n  \"app/pages/+layout.meeko\": `<script lang=\"ts\">\nimport type { ComponentModule } from \"@meekojs/meeko\";\n\nexport interface Props {\n  outlet: ComponentModule<Record<string, unknown>>;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n  <div class=\"app-shell\">\n    <header><a href=\"/\">Meeko</a></header>\n    <main><component is=\"props.outlet\"></component></main>\n  </div>\n</template>\n\n<style scoped>\n.app-shell { max-width: 64rem; margin: 0 auto; padding: 2rem; font-family: system-ui, sans-serif; }\nheader { margin-bottom: 2rem; }\n</style>\n`,\n  \"app/entry-client.ts\": `import { mountClientApp, type ClientComponent, type RouteRecord } from \"@meekojs/meeko/framework\";\nimport { modules as pages } from \"virtual:meeko-client-pages\";\n\nconst root = document.getElementById(\"app\");\nconst payload = document.getElementById(\"meeko-payload\")?.textContent;\nconst routesText = document.getElementById(\"meeko-routes\")?.textContent;\nif (!root || !payload || !routesText) throw new Error(\"Missing Meeko SSR data\");\nconst routes = JSON.parse(routesText) as RouteRecord[];\n\nawait mountClientApp({\n  root, payload, routes, serverData: true,\n  async loadPage(file) {\n    const load = pages[file];\n    if (!load) throw new Error(\"Page module missing: \" + file);\n    return await load() as ClientComponent;\n  },\n});\n`,\n  \"server/entry.ts\": `import { createFrameworkHandler, createLocalServerFetch, createRequestContext, createServerDispatcher, createSocketHub, discoverServerManifest, loadSocketChannels, type FrameworkHandlerOptions } from \"@meekojs/meeko/server\";\nimport type { RouteRecord } from \"@meekojs/meeko/framework\";\nimport { modules as pages } from \"virtual:meeko-server-pages\";\nimport { modules as routeModules } from \"virtual:meeko-server-routes\";\nimport { createSessionManager } from \"./session.js\";\n\nconst handlers = import.meta.glob([\"/server/api/**/*.ts\", \"/server/rpc/**/*.ts\", \"/server/socket/**/*.ts\"], { eager: true });\n\nfunction keyFor(root: string, file: string): string {\n  return \"/\" + file.slice(root.length).replaceAll(\"\\\\\\\\\", \"/\").replace(/^\\\\//, \"\");\n}\n\nexport const loadPage = async (root: string, file: string): Promise<Awaited<ReturnType<FrameworkHandlerOptions[\"loadPage\"]>>> => {\n  const key = keyFor(root, file);\n  const module = pages[key];\n  if (!module) throw new Error(\"Page module missing: \" + key);\n  return module as Awaited<ReturnType<FrameworkHandlerOptions[\"loadPage\"]>>;\n};\n\nexport const loadRoute = async (root: string, file: string): Promise<Awaited<ReturnType<NonNullable<FrameworkHandlerOptions[\"loadRoute\"]>>>> => {\n  const key = keyFor(root, file);\n  const module = routeModules[key] as Record<string, unknown> | undefined;\n  if (!module) throw new Error(\"Route module missing: \" + key);\n  return (module.route ?? module.default ?? module) as Awaited<ReturnType<NonNullable<FrameworkHandlerOptions[\"loadRoute\"]>>>;\n};\n\nexport async function createAppRuntime(root: string, routes: readonly RouteRecord[], clientEntry: string, production: boolean) {\n  const sessions = createSessionManager(production);\n  const manifest = await discoverServerManifest(root);\n  const load = async (file: string) => {\n    const module = handlers[keyFor(root, file)];\n    if (!module) throw new Error(\"Server handler missing: \" + file);\n    return module;\n  };\n  const services = {};\n  const pageHandler = createFrameworkHandler({\n    routes,\n    loadPage: (file) => loadPage(root, file),\n    loadRoute: (file) => loadRoute(root, file),\n    clientEntry,\n    createContext: async (request) => createRequestContext(request, services, await sessions.load(request)),\n    serverFetch: createLocalServerFetch({ manifest, sessions, load }),\n  });\n  const endpointHandler = createServerDispatcher({ manifest, sessions, services, load });\n  const channels = await loadSocketChannels(manifest, load);\n  const socketHub = createSocketHub({ channels, sessions, services });\n  return { pageHandler, endpointHandler, socketHub, sessions, manifest };\n}\n`,\n  \"server/session.ts\": `import { MemorySessionStore, SessionManager } from \"@meekojs/meeko/server\";\n\nexport function createSessionManager(production: boolean) {\n  if (production) throw new Error(\"Configure a persistent SessionStore in server/session.ts before production startup\");\n  return new SessionManager({ store: new MemorySessionStore(), production: false });\n}\n`,\n  \"server.mjs\": `import { createServer } from \"node:http\";\nimport { readFile, realpath } from \"node:fs/promises\";\nimport { dirname, extname, relative, resolve, sep } from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { createServer as createViteServer } from \"vite\";\nimport { attachNodeWebSocketServer, discoverConfiguredRoutes, toNodeListener } from \"@meekojs/meeko/server\";\nimport { serializeJson } from \"@meekojs/meeko\";\n\nconst root = dirname(fileURLToPath(import.meta.url));\nconst production = process.argv.includes(\"--production\");\nconst vite = production ? undefined : await createViteServer({\n  root, configFile: resolve(root, \"vite.config.ts\"),\n  server: { middlewareMode: true }, appType: \"custom\",\n});\nconst clientRoot = resolve(root, \".meeko/output/client\");\nconst publicRoot = resolve(root, \"public\");\nconst routes = await discoverConfiguredRoutes(root);\nlet clientEntry = \"/app/entry-client.ts\";\nif (production) {\n  const manifest = JSON.parse(await readFile(resolve(clientRoot, \".vite/manifest.json\"), \"utf8\"));\n  const entry = manifest[\"app/entry-client.ts\"];\n  if (!entry?.file) throw new Error(\"Missing client entry in Vite manifest\");\n  clientEntry = \"/\" + entry.file;\n}\nconst serverEntry = production\n  ? await import(pathToFileURL(resolve(root, \".meeko/output/server/entry.js\")).href)\n  : await vite.ssrLoadModule(\"/server/entry.ts\");\nconst portable = routes.map((route) => ({\n  id: route.id,\n  file: \"/\" + relative(root, route.file).replaceAll(\"\\\\\\\\\", \"/\"),\n  layouts: route.layouts.map((file) => \"/\" + relative(root, file).replaceAll(\"\\\\\\\\\", \"/\")),\n  ...(route.error ? { error: \"/\" + relative(root, route.error).replaceAll(\"\\\\\\\\\", \"/\") } : {}),\n}));\nconst runtime = await serverEntry.createAppRuntime(root, routes, clientEntry, production);\nconst handler = runtime.pageHandler;\nconst decorated = async (request) => {\n  const path = new URL(request.url).pathname;\n  if (path.startsWith(\"/api/\") || path.startsWith(\"/_meeko/rpc/\")) return runtime.endpointHandler(request);\n  const result = await handler(request);\n  if (result.status !== 200 || !(result.headers.get(\"content-type\") || \"\").includes(\"text/html\")) return result;\n  let html = (await result.text()).replace(\"</body>\", '<script id=\"meeko-routes\" type=\"application/json\">' + serializeJson(portable) + \"</script></body>\");\n  if (vite) html = await vite.transformIndexHtml(new URL(request.url).pathname, html);\n  return new Response(request.method === \"HEAD\" ? null : html, { status: result.status, headers: result.headers });\n};\nconst pageListener = toNodeListener(decorated);\nconst types = { \".js\": \"text/javascript\", \".css\": \"text/css\", \".svg\": \"image/svg+xml\", \".png\": \"image/png\" };\nasync function readAsset(assetRoot, path) {\n  const file = resolve(assetRoot, \".\" + path);\n  if (!file.startsWith(assetRoot + sep)) return { status: 403 };\n  let actual;\n  try { actual = await realpath(file); }\n  catch (error) { if (error?.code === \"ENOENT\") return null; throw error; }\n  const actualRoot = await realpath(assetRoot);\n  if (!actual.startsWith(actualRoot + sep)) return { status: 403 };\n  return { status: 200, body: await readFile(actual) };\n}\nconst server = createServer((request, response) => {\n  const path = new URL(request.url || \"/\", \"http://localhost\").pathname;\n  if (production && /\\\\.[a-z0-9]+$/i.test(path)) {\n    void (async () => {\n      const asset = await readAsset(clientRoot, path) ?? await readAsset(publicRoot, path);\n      if (!asset || asset.status !== 200) { response.writeHead(asset?.status ?? 404); response.end(); return; }\n      response.writeHead(200, { \"content-type\": types[extname(path)] || \"application/octet-stream\" });\n      response.end(asset.body);\n    })().catch(() => { response.writeHead(404); response.end(); });\n    return;\n  }\n  if (vite) {\n    vite.middlewares(request, response, () => pageListener(request, response));\n    return;\n  }\n  pageListener(request, response);\n});\nconst port = Number(process.env.PORT || 4173);\nconst socketServer = runtime.manifest.socket?.length ? attachNodeWebSocketServer({\n  server, hub: runtime.socketHub, publicOrigin: process.env.PUBLIC_ORIGIN || \"http://127.0.0.1:\" + port,\n}) : undefined;\nserver.listen(port, \"127.0.0.1\", () => console.log(\"http://127.0.0.1:\" + port));\nprocess.on(\"SIGINT\", () => { void socketServer?.close(); server.close(); void runtime.sessions.close(); void vite?.close(); });\n`,\n  \"README.md\": `# Meeko framework starter\n\nRequires Node 24.\n\n\\`\\`\\`sh\nnpm install\nnpm run dev\n\\`\\`\\`\n\nRoutes live in \\`app/pages\\`. \\`+layout.meeko\\` keeps the shared shell during client navigation. Run \\`npm run build\\` and \\`npm start\\` for production SSR. Generated files live under \\`.meeko/\\`.\n`,\n};\n\nfunction record(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** Creates a framework project without overwriting unrelated user files. */\nexport async function initFrameworkProject(directory: string): Promise<string> {\n  const target = resolve(directory);\n  const name = basename(target).toLowerCase().replace(/[^a-z0-9._-]+/g, \"-\").replace(/^[._-]+|[._-]+$/g, \"\") || \"meeko-app\";\n  const metadata: unknown = JSON.parse(await readFile(new URL(\"../../package.json\", import.meta.url), \"utf8\"));\n  if (!record(metadata) || typeof metadata.version !== \"string\") throw new Error(\"Meeko package version is unavailable\");\n  let entries: string[] = [];\n  try {\n    if (!(await stat(target)).isDirectory()) throw new Error(`Destination is not a directory: ${target}`);\n    entries = await readdir(target);\n  } catch (error) {\n    if (!(error instanceof Error && \"code\" in error && error.code === \"ENOENT\")) throw error;\n  }\n  const unexpected = entries.filter((entry) => !allowedEntries.has(entry));\n  if (unexpected.length || (entries.length && !entries.includes(\"package.json\"))) {\n    throw new Error(`Destination is not empty: ${target}`);\n  }\n  const existing: unknown = entries.includes(\"package.json\") ? JSON.parse(await readFile(join(target, \"package.json\"), \"utf8\")) : {};\n  if (!record(existing) || (existing.scripts !== undefined && !record(existing.scripts))\n    || (existing.dependencies !== undefined && !record(existing.dependencies))\n    || (existing.devDependencies !== undefined && !record(existing.devDependencies))) {\n    throw new Error(`Invalid package.json in ${target}`);\n  }\n  const scripts = {\n    dev: \"node server.mjs\",\n    check: \"meeko routes . && meeko check-app . && tsc -p tsconfig.json --noEmit && tsc -p tsconfig.shared.json --noEmit && tsc -p tsconfig.app.json --noEmit && tsc -p tsconfig.server.json --noEmit\",\n    build: \"npm run check && vite build --config vite.config.ts && vite build --config vite.server.config.ts && meeko prerender .\",\n    start: \"node server.mjs --production\",\n  };\n  const oldScripts = existing.scripts as Record<string, unknown> | undefined;\n  for (const command of Object.keys(scripts)) if (oldScripts && command in oldScripts) {\n    throw new Error(`Destination already defines the ${command} script: ${target}`);\n  }\n  const manifest = {\n    ...existing,\n    name: typeof existing.name === \"string\" ? existing.name : name,\n    private: true,\n    type: \"module\",\n    engines: { ...(record(existing.engines) ? existing.engines : {}), node: \">=24\" },\n    scripts: { ...oldScripts, ...scripts },\n    dependencies: { ...(existing.dependencies as Record<string, unknown> | undefined), \"@meekojs/meeko\": metadata.version },\n    devDependencies: {\n      ...(existing.devDependencies as Record<string, unknown> | undefined),\n      \"@types/node\": \"^24.0.0\", typescript: \"^7.0.2\", vite: \"^8.3.5\",\n    },\n  };\n  await mkdir(target, { recursive: true });\n  for (const [filename, content] of Object.entries(files)) {\n    const output = join(target, filename);\n    await mkdir(dirname(output), { recursive: true });\n    await writeFile(output, content, { encoding: \"utf8\", flag: \"wx\" });\n  }\n  await writeFile(join(target, \"package.json\"), JSON.stringify(manifest, null, 2) + \"\\n\", {\n    encoding: \"utf8\", flag: entries.includes(\"package.json\") ? \"w\" : \"wx\",\n  });\n  return target;\n}\n"]}

package/dist/framework/modules.d.ts

@@ -0,0 +1,22 @@
+import type { RouteRecord } from "./router.js";
+export interface RouteLayer {
+    /** Stable identifier used in diagnostics and generated manifests. */
+    readonly name: string;
+    /** Directory containing the layer's app/pages tree. */
+    readonly root: string;
+}
+export interface RouteModule {
+    /** Stable identifier for a module contributing explicit route records. */
+    readonly name: string;
+    routes(): readonly RouteRecord[] | Promise<readonly RouteRecord[]>;
+}
+export interface ComposeRoutesOptions {
+    readonly projectRoot: string;
+    readonly layers?: readonly RouteLayer[];
+    readonly modules?: readonly RouteModule[];
+}
+/**
+ * Composes explicit route sources. Every URL collision is an error; no source
+ * silently overrides the app, a layer, or another module.
+ */
+export declare function composeFrameworkRoutes(options: ComposeRoutesOptions): Promise<readonly RouteRecord[]>;

package/dist/framework/modules.js

@@ -0,0 +1,29 @@
+import { resolve } from "node:path";
+import { createRouteManifest } from "./router.js";
+import { discoverRoutes } from "./server.js";
+/**
+ * Composes explicit route sources. Every URL collision is an error; no source
+ * silently overrides the app, a layer, or another module.
+ */
+export async function composeFrameworkRoutes(options) {
+    const names = new Set(["app"]);
+    const roots = new Set([resolve(options.projectRoot).toLowerCase()]);
+    for (const source of [...options.layers ?? [], ...options.modules ?? []]) {
+        if (!/^[a-z][a-z0-9-]*$/.test(source.name) || names.has(source.name)) {
+            throw new Error(`Invalid or duplicate route source name: ${source.name}`);
+        }
+        names.add(source.name);
+    }
+    const routes = [...await discoverRoutes(options.projectRoot)];
+    for (const layer of options.layers ?? []) {
+        const root = resolve(layer.root);
+        if (roots.has(root.toLowerCase()))
+            throw new Error(`Duplicate route root: ${root}`);
+        roots.add(root.toLowerCase());
+        routes.push(...await discoverRoutes(root));
+    }
+    for (const module of options.modules ?? [])
+        routes.push(...await module.routes());
+    return createRouteManifest(routes);
+}
+//# sourceMappingURL=modules.js.map

package/dist/framework/modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../src/framework/modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAqB7C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAA6B;IACxE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACpE,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QACzE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,2CAA2C,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,MAAM,GAAkB,CAAC,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAC7E,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QACpF,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAClF,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC","sourcesContent":["import { resolve } from \"node:path\";\nimport { createRouteManifest } from \"./router.js\";\nimport type { RouteRecord } from \"./router.js\";\nimport { discoverRoutes } from \"./server.js\";\n\nexport interface RouteLayer {\n  /** Stable identifier used in diagnostics and generated manifests. */\n  readonly name: string;\n  /** Directory containing the layer's app/pages tree. */\n  readonly root: string;\n}\n\nexport interface RouteModule {\n  /** Stable identifier for a module contributing explicit route records. */\n  readonly name: string;\n  routes(): readonly RouteRecord[] | Promise<readonly RouteRecord[]>;\n}\n\nexport interface ComposeRoutesOptions {\n  readonly projectRoot: string;\n  readonly layers?: readonly RouteLayer[];\n  readonly modules?: readonly RouteModule[];\n}\n\n/**\n * Composes explicit route sources. Every URL collision is an error; no source\n * silently overrides the app, a layer, or another module.\n */\nexport async function composeFrameworkRoutes(options: ComposeRoutesOptions): Promise<readonly RouteRecord[]> {\n  const names = new Set([\"app\"]);\n  const roots = new Set([resolve(options.projectRoot).toLowerCase()]);\n  for (const source of [...options.layers ?? [], ...options.modules ?? []]) {\n    if (!/^[a-z][a-z0-9-]*$/.test(source.name) || names.has(source.name)) {\n      throw new Error(`Invalid or duplicate route source name: ${source.name}`);\n    }\n    names.add(source.name);\n  }\n  const routes: RouteRecord[] = [...await discoverRoutes(options.projectRoot)];\n  for (const layer of options.layers ?? []) {\n    const root = resolve(layer.root);\n    if (roots.has(root.toLowerCase())) throw new Error(`Duplicate route root: ${root}`);\n    roots.add(root.toLowerCase());\n    routes.push(...await discoverRoutes(root));\n  }\n  for (const module of options.modules ?? []) routes.push(...await module.routes());\n  return createRouteManifest(routes);\n}\n"]}

package/dist/framework/page.d.ts

@@ -0,0 +1,60 @@
+/** Browser-safe subset of Standard Schema v1, implemented by Valibot schemas. */
+import type { StateStore } from "./state.js";
+import type { PageRoute } from "./server.js";
+export interface PageSchema<I = unknown, O = I> {
+    readonly "~standard": {
+        readonly version: 1;
+        readonly validate: (value: unknown) => {
+            value: O;
+            issues?: undefined;
+        } | {
+            issues: readonly unknown[];
+        } | Promise<{
+            value: O;
+            issues?: undefined;
+        } | {
+            issues: readonly unknown[];
+        }>;
+        readonly types?: {
+            readonly input: I;
+            readonly output: O;
+        } | undefined;
+    };
+}
+type Output<S> = S extends PageSchema<unknown, infer O> ? O : never;
+type Params<P> = P extends PageSchema ? Output<P> : Readonly<Record<string, string>>;
+type Search<S> = S extends PageSchema ? Output<S> : Readonly<Record<string, string | string[]>>;
+export interface PageLoadContext<P extends PageSchema | undefined, S extends PageSchema | undefined, C = unknown> {
+    readonly params: Params<P>;
+    readonly search: Search<S>;
+    readonly request: Request;
+    readonly signal: AbortSignal;
+    readonly state: StateStore;
+    readonly context?: C;
+}
+export interface PageDefinition<P extends PageSchema | undefined, S extends PageSchema | undefined, D, C = unknown> {
+    readonly params?: P;
+    readonly search?: S;
+    readonly render?: "ssr" | "prerender" | "client";
+    readonly prerenderEntries?: readonly Readonly<Record<string, string>>[] | (() => Promise<readonly Readonly<Record<string, string>>[]>);
+    readonly load?: (args: PageLoadContext<P, S, C>) => Promise<D> | D;
+    readonly head?: (args: PageLoadContext<P, S, C> & {
+        data: D;
+    }) => {
+        title?: string;
+    };
+}
+/** Captures route schemas and keeps loader/head inference in one declaration. */
+export declare function definePage<const P extends PageSchema | undefined = undefined, const S extends PageSchema | undefined = undefined, D = unknown, C = unknown>(definition: PageDefinition<P, S, D, C>): PageDefinition<P, S, D, C> & PageRoute;
+export declare class PageInputError extends Error {
+    readonly code: "INVALID_PARAMS" | "INVALID_SEARCH";
+    constructor(code: "INVALID_PARAMS" | "INVALID_SEARCH");
+}
+/** Validates both inputs before a page loader executes. */
+export declare function validatePageInputs(definition: Pick<PageDefinition<PageSchema | undefined, PageSchema | undefined, unknown>, "params" | "search"> | undefined, params: Readonly<Record<string, string>>, search: Readonly<Record<string, string | string[]>>): Promise<{
+    params: Readonly<Record<string, unknown>>;
+    search: Readonly<Record<string, unknown>>;
+}>;
+/** Preserves duplicate search keys for schema validation. */
+export declare function pageSearchObject(searchParams: URLSearchParams): Record<string, string | string[]>;
+export {};

package/dist/framework/page.js

@@ -0,0 +1,42 @@
+/** Captures route schemas and keeps loader/head inference in one declaration. */
+export function definePage(definition) {
+    return definition;
+}
+export class PageInputError extends Error {
+    code;
+    constructor(code) {
+        super(code);
+        this.code = code;
+    }
+}
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function parse(schema, raw, code) {
+    if (!schema)
+        return raw;
+    const result = await schema["~standard"].validate(raw);
+    if ("issues" in result && result.issues)
+        throw new PageInputError(code);
+    const value = result.value;
+    if (!record(value))
+        throw new PageInputError(code);
+    return value;
+}
+/** Validates both inputs before a page loader executes. */
+export async function validatePageInputs(definition, params, search) {
+    return {
+        params: await parse(definition?.params, { ...params }, "INVALID_PARAMS"),
+        search: await parse(definition?.search, { ...search }, "INVALID_SEARCH"),
+    };
+}
+/** Preserves duplicate search keys for schema validation. */
+export function pageSearchObject(searchParams) {
+    const result = Object.create(null);
+    for (const [key, value] of searchParams) {
+        const previous = result[key];
+        result[key] = previous === undefined ? value : Array.isArray(previous) ? [...previous, value] : [previous, value];
+    }
+    return result;
+}
+//# sourceMappingURL=page.js.map

package/dist/framework/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/framework/page.ts"],"names":[],"mappings":"AAqCA,iFAAiF;AACjF,MAAM,UAAU,UAAU,CAKxB,UAAsC;IACtC,OAAO,UAAoD,CAAC;AAC9D,CAAC;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IACX,IAAI;IAAhC,YAA4B,IAAyC;QACnE,KAAK,CAAC,IAAI,CAAC,CAAC;oBADc,IAAI;IAEhC,CAAC;CACF;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,KAAK,UAAU,KAAK,CAAC,MAA8B,EAAE,GAA4B,EAAE,IAA4B;IAC7G,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,CAAC;IACxB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvD,IAAI,QAAQ,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACxE,MAAM,KAAK,GAAI,MAA6B,CAAC,KAAK,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAA0H,EAC1H,MAAwC,EACxC,MAAmD;IAEnD,OAAO;QACL,MAAM,EAAE,MAAM,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,gBAAgB,CAAC;QACxE,MAAM,EAAE,MAAM,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,gBAAgB,CAAC;KACzE,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,gBAAgB,CAAC,YAA6B;IAC5D,MAAM,MAAM,GAAsC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACpH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["/** Browser-safe subset of Standard Schema v1, implemented by Valibot schemas. */\nimport type { StateStore } from \"./state.js\";\nimport type { PageRoute } from \"./server.js\";\n\nexport interface PageSchema<I = unknown, O = I> {\n  readonly \"~standard\": {\n    readonly version: 1;\n    readonly validate: (value: unknown) =>\n      | { value: O; issues?: undefined }\n      | { issues: readonly unknown[] }\n      | Promise<{ value: O; issues?: undefined } | { issues: readonly unknown[] }>;\n    readonly types?: { readonly input: I; readonly output: O } | undefined;\n  };\n}\n\ntype Output<S> = S extends PageSchema<unknown, infer O> ? O : never;\ntype Params<P> = P extends PageSchema ? Output<P> : Readonly<Record<string, string>>;\ntype Search<S> = S extends PageSchema ? Output<S> : Readonly<Record<string, string | string[]>>;\n\nexport interface PageLoadContext<P extends PageSchema | undefined, S extends PageSchema | undefined, C = unknown> {\n  readonly params: Params<P>;\n  readonly search: Search<S>;\n  readonly request: Request;\n  readonly signal: AbortSignal;\n  readonly state: StateStore;\n  readonly context?: C;\n}\n\nexport interface PageDefinition<P extends PageSchema | undefined, S extends PageSchema | undefined, D, C = unknown> {\n  readonly params?: P;\n  readonly search?: S;\n  readonly render?: \"ssr\" | \"prerender\" | \"client\";\n  readonly prerenderEntries?: readonly Readonly<Record<string, string>>[] | (() => Promise<readonly Readonly<Record<string, string>>[]>);\n  readonly load?: (args: PageLoadContext<P, S, C>) => Promise<D> | D;\n  readonly head?: (args: PageLoadContext<P, S, C> & { data: D }) => { title?: string };\n}\n\n/** Captures route schemas and keeps loader/head inference in one declaration. */\nexport function definePage<\n  const P extends PageSchema | undefined = undefined,\n  const S extends PageSchema | undefined = undefined,\n  D = unknown,\n  C = unknown,\n>(definition: PageDefinition<P, S, D, C>): PageDefinition<P, S, D, C> & PageRoute {\n  return definition as PageDefinition<P, S, D, C> & PageRoute;\n}\n\nexport class PageInputError extends Error {\n  constructor(public readonly code: \"INVALID_PARAMS\" | \"INVALID_SEARCH\") {\n    super(code);\n  }\n}\n\nfunction record(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nasync function parse(schema: PageSchema | undefined, raw: Record<string, unknown>, code: PageInputError[\"code\"]): Promise<Record<string, unknown>> {\n  if (!schema) return raw;\n  const result = await schema[\"~standard\"].validate(raw);\n  if (\"issues\" in result && result.issues) throw new PageInputError(code);\n  const value = (result as { value: unknown }).value;\n  if (!record(value)) throw new PageInputError(code);\n  return value;\n}\n\n/** Validates both inputs before a page loader executes. */\nexport async function validatePageInputs(\n  definition: Pick<PageDefinition<PageSchema | undefined, PageSchema | undefined, unknown>, \"params\" | \"search\"> | undefined,\n  params: Readonly<Record<string, string>>,\n  search: Readonly<Record<string, string | string[]>>,\n): Promise<{ params: Readonly<Record<string, unknown>>; search: Readonly<Record<string, unknown>> }> {\n  return {\n    params: await parse(definition?.params, { ...params }, \"INVALID_PARAMS\"),\n    search: await parse(definition?.search, { ...search }, \"INVALID_SEARCH\"),\n  };\n}\n\n/** Preserves duplicate search keys for schema validation. */\nexport function pageSearchObject(searchParams: URLSearchParams): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = Object.create(null);\n  for (const [key, value] of searchParams) {\n    const previous = result[key];\n    result[key] = previous === undefined ? value : Array.isArray(previous) ? [...previous, value] : [previous, value];\n  }\n  return result;\n}\n"]}

package/dist/framework/prerender.d.ts

@@ -0,0 +1,14 @@
+import type { RouteRecord } from "./router.js";
+import type { PageRoute } from "./server.js";
+export interface PrerenderOptions {
+    readonly routes: readonly RouteRecord[];
+    readonly handler: (request: Request) => Promise<Response>;
+    readonly loadRoute?: (file: string) => Promise<PageRoute>;
+    readonly outputRoot: string;
+    readonly origin?: string;
+    readonly transformHtml?: (html: string) => string | Promise<string>;
+}
+/** Writes only fully resolved, successful HTML responses to the prerender output. */
+export declare function prerenderRoutes(options: PrerenderOptions): Promise<string[]>;
+/** Renders from the production server bundle and client manifest. */
+export declare function prerenderProject(projectRoot: string): Promise<string[]>;