@meekojs/meeko 0.0.3 → 0.1.0

package/dist/framework/generate.js

@@ -0,0 +1,67 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join, relative, resolve } from "node:path";
+import { discoverConfiguredRoutes } from "./config.js";
+function paramsFor(id) {
+    const params = [];
+    for (const part of id.split("/").filter(Boolean)) {
+        const match = /^\[(?:\.\.\.)?([A-Za-z_$][\w$]*)\]$/.exec(part);
+        if (!match)
+            continue;
+        const name = match[1];
+        if (params.includes(name))
+            throw new Error(`Duplicate route parameter ${name} in ${id}`);
+        params.push(name);
+    }
+    return params;
+}
+function portable(root, file) {
+    const path = relative(root, file).replaceAll("\\", "/");
+    if (path.startsWith("../") || path === "..")
+        throw new Error(`Route file escapes project root: ${file}`);
+    return path;
+}
+/** Generates public route types and a portable manifest from one route discovery pass. */
+export async function generateRoutes(projectRoot) {
+    const root = resolve(projectRoot);
+    const routes = await discoverConfiguredRoutes(root);
+    const types = join(root, ".meeko", "types", "routes.d.ts");
+    const manifest = join(root, ".meeko", "manifests", "routes.json");
+    const virtualTypes = join(root, ".meeko", "types", "virtual-pages.d.ts");
+    const lines = routes.map((route) => {
+        const params = paramsFor(route.id);
+        const shape = params.length ? `{ ${params.map((param) => `${JSON.stringify(param)}: string`).join("; ")} }` : "Record<never, never>";
+        return `    ${JSON.stringify(route.id)}: ${shape};`;
+    });
+    const declarations = [
+        "// Generated by Meeko. Edit app/pages instead.",
+        'import "@meekojs/meeko/framework";',
+        'declare module "@meekojs/meeko/framework" {',
+        "  interface GeneratedRoutes {",
+        ...lines,
+        "  }",
+        "}",
+        `export type RouteId = ${routes.length ? routes.map((route) => JSON.stringify(route.id)).join(" | ") : "never"};`,
+        'export type RouteParams<Id extends RouteId> = import("@meekojs/meeko/framework").GeneratedRoutes[Id];',
+        "export {};",
+        "",
+    ].join("\n");
+    const portableRoutes = routes.map((route) => ({
+        id: route.id,
+        file: portable(root, route.file),
+        layouts: route.layouts.map((layout) => portable(root, layout)),
+        ...(route.error ? { error: portable(root, route.error) } : {}),
+        ...(route.sidecar ? { sidecar: portable(root, route.sidecar) } : {}),
+    }));
+    await mkdir(join(root, ".meeko", "types"), { recursive: true });
+    await mkdir(join(root, ".meeko", "manifests"), { recursive: true });
+    await writeFile(types, declarations, "utf8");
+    await writeFile(virtualTypes, [
+        'declare module "virtual:meeko-client-pages" { export const modules: Record<string, () => Promise<unknown>>; }',
+        'declare module "virtual:meeko-server-pages" { export const modules: Record<string, unknown>; }',
+        'declare module "virtual:meeko-server-routes" { export const modules: Record<string, unknown>; }',
+        "",
+    ].join("\n"), "utf8");
+    await writeFile(manifest, `${JSON.stringify({ version: 1, routes: portableRoutes }, null, 2)}\n`, "utf8");
+    return { types, manifest, count: routes.length };
+}
+//# sourceMappingURL=generate.js.map

package/dist/framework/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/framework/generate.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport { join, relative, resolve } from \"node:path\";\nimport { discoverConfiguredRoutes } from \"./config.js\";\n\nexport interface GeneratedRouteFiles {\n  readonly types: string;\n  readonly manifest: string;\n  readonly count: number;\n}\n\nfunction paramsFor(id: string): readonly string[] {\n  const params: string[] = [];\n  for (const part of id.split(\"/\").filter(Boolean)) {\n    const match = /^\\[(?:\\.\\.\\.)?([A-Za-z_$][\\w$]*)\\]$/.exec(part);\n    if (!match) continue;\n    const name = match[1]!;\n    if (params.includes(name)) throw new Error(`Duplicate route parameter ${name} in ${id}`);\n    params.push(name);\n  }\n  return params;\n}\n\nfunction portable(root: string, file: string): string {\n  const path = relative(root, file).replaceAll(\"\\\\\", \"/\");\n  if (path.startsWith(\"../\") || path === \"..\") throw new Error(`Route file escapes project root: ${file}`);\n  return path;\n}\n\n/** Generates public route types and a portable manifest from one route discovery pass. */\nexport async function generateRoutes(projectRoot: string): Promise<GeneratedRouteFiles> {\n  const root = resolve(projectRoot);\n  const routes = await discoverConfiguredRoutes(root);\n  const types = join(root, \".meeko\", \"types\", \"routes.d.ts\");\n  const manifest = join(root, \".meeko\", \"manifests\", \"routes.json\");\n  const virtualTypes = join(root, \".meeko\", \"types\", \"virtual-pages.d.ts\");\n  const lines = routes.map((route) => {\n    const params = paramsFor(route.id);\n    const shape = params.length ? `{ ${params.map((param) => `${JSON.stringify(param)}: string`).join(\"; \")} }` : \"Record<never, never>\";\n    return `    ${JSON.stringify(route.id)}: ${shape};`;\n  });\n  const declarations = [\n    \"// Generated by Meeko. Edit app/pages instead.\",\n    'import \"@meekojs/meeko/framework\";',\n    'declare module \"@meekojs/meeko/framework\" {',\n    \"  interface GeneratedRoutes {\",\n    ...lines,\n    \"  }\",\n    \"}\",\n    `export type RouteId = ${routes.length ? routes.map((route) => JSON.stringify(route.id)).join(\" | \") : \"never\"};`,\n    'export type RouteParams<Id extends RouteId> = import(\"@meekojs/meeko/framework\").GeneratedRoutes[Id];',\n    \"export {};\",\n    \"\",\n  ].join(\"\\n\");\n  const portableRoutes = routes.map((route) => ({\n    id: route.id,\n    file: portable(root, route.file),\n    layouts: route.layouts.map((layout) => portable(root, layout)),\n    ...(route.error ? { error: portable(root, route.error) } : {}),\n    ...(route.sidecar ? { sidecar: portable(root, route.sidecar) } : {}),\n  }));\n  await mkdir(join(root, \".meeko\", \"types\"), { recursive: true });\n  await mkdir(join(root, \".meeko\", \"manifests\"), { recursive: true });\n  await writeFile(types, declarations, \"utf8\");\n  await writeFile(virtualTypes, [\n    'declare module \"virtual:meeko-client-pages\" { export const modules: Record<string, () => Promise<unknown>>; }',\n    'declare module \"virtual:meeko-server-pages\" { export const modules: Record<string, unknown>; }',\n    'declare module \"virtual:meeko-server-routes\" { export const modules: Record<string, unknown>; }',\n    \"\",\n  ].join(\"\\n\"), \"utf8\");\n  await writeFile(manifest, `${JSON.stringify({ version: 1, routes: portableRoutes }, null, 2)}\\n`, \"utf8\");\n  return { types, manifest, count: routes.length };\n}\n"]}

package/dist/framework/init.d.ts

@@ -0,0 +1,2 @@
+/** Creates a framework project without overwriting unrelated user files. */
+export declare function initFrameworkProject(directory: string): Promise<string>;

package/dist/framework/init.js

@@ -0,0 +1,183 @@
+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": "",
+    "app/styles/main.css": `:root { color-scheme: light dark; font-family: system-ui, sans-serif; }
+* { box-sizing: border-box; }
+body { margin: 0; }
+`,
+    "meeko.config.ts": `import { defineMeekoConfig } from "@meekojs/meeko/framework";
+
+export default defineMeekoConfig({
+  extends: [],
+  modules: [],
+  imports: { serverDirs: [] },
+});
+`,
+    "tsconfig.json": `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022", "DOM"],
+    "types": ["node", "vite/client"],
+    "strict": true,
+    "noEmit": true,
+    "allowArbitraryExtensions": true,
+    "skipLibCheck": true
+  },
+  "files": [],
+  "references": [
+    { "path": "./.meeko/tsconfig.app.json" },
+    { "path": "./.meeko/tsconfig.server.json" },
+    { "path": "./.meeko/tsconfig.shared.json" }
+  ]
+}
+`,
+    "app/pages/index.meeko": `<script lang="ts">
+import { signal } from "@meekojs/meeko";
+
+export interface Props {
+  params: Record<string, string>;
+  search: Record<string, 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 { Component } from "@meekojs/meeko";
+
+export interface Props {
+  outlet: Component<Record<string, unknown>>;
+}
+
+const props = defineProps<Props>();
+</script>
+
+<template>
+  <div class="site-root"><component is="props.outlet"></component></div>
+</template>
+`,
+    "app/layouts/default.meeko": `<script lang="ts">
+import type { Component } from "@meekojs/meeko";
+
+export interface Props {
+  outlet: Component<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>
+`,
+    "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 });
+}
+`,
+    "README.md": `# Meeko framework starter
+
+Requires Node 24.
+
+\`\`\`sh
+npm install
+npm run dev
+\`\`\`
+
+Routes live in \`app/pages\`. \`app/layouts/default.meeko\` keeps the shared shell during client navigation. Put shared route guards in \`app/middleware\` with \`defineRouteMiddleware\`, and Node request middleware in \`server/middleware\` with \`defineServerMiddleware\`; see the framework guide for their execution and security boundaries. Global styles in \`app/styles/main.css\` load automatically; component styles stay in \`<style>\` blocks. Run \`npm run check\` for types, then \`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: "meeko dev .",
+        check: "meeko check .",
+        build: "meeko build .",
+        start: "meeko start .",
+    };
+    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  \"app/styles/main.css\": `:root { color-scheme: light dark; font-family: system-ui, sans-serif; }\n* { box-sizing: border-box; }\nbody { margin: 0; }\n`,\n  \"meeko.config.ts\": `import { defineMeekoConfig } from \"@meekojs/meeko/framework\";\n\nexport default defineMeekoConfig({\n  extends: [],\n  modules: [],\n  imports: { serverDirs: [] },\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  \"files\": [],\n  \"references\": [\n    { \"path\": \"./.meeko/tsconfig.app.json\" },\n    { \"path\": \"./.meeko/tsconfig.server.json\" },\n    { \"path\": \"./.meeko/tsconfig.shared.json\" }\n  ]\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 | 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 { Component } from \"@meekojs/meeko\";\n\nexport interface Props {\n  outlet: Component<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/layouts/default.meeko\": `<script lang=\"ts\">\nimport type { Component } from \"@meekojs/meeko\";\n\nexport interface Props {\n  outlet: Component<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  \"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  \"README.md\": `# Meeko framework starter\n\nRequires Node 24.\n\n\\`\\`\\`sh\nnpm install\nnpm run dev\n\\`\\`\\`\n\nRoutes live in \\`app/pages\\`. \\`app/layouts/default.meeko\\` keeps the shared shell during client navigation. Put shared route guards in \\`app/middleware\\` with \\`defineRouteMiddleware\\`, and Node request middleware in \\`server/middleware\\` with \\`defineServerMiddleware\\`; see the framework guide for their execution and security boundaries. Global styles in \\`app/styles/main.css\\` load automatically; component styles stay in \\`<style>\\` blocks. Run \\`npm run check\\` for types, then \\`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: \"meeko dev .\",\n    check: \"meeko check .\",\n    build: \"meeko build .\",\n    start: \"meeko start .\",\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/middleware.d.ts

@@ -0,0 +1,14 @@
+import type { RouteMatch } from "./router.js";
+/** Runs for matched page requests and browser navigations before the loader. */
+export interface RouteMiddlewareContext {
+    readonly url: URL;
+    readonly match: RouteMatch;
+    readonly signal: AbortSignal;
+    readonly phase: "server" | "client";
+    /** Only present during SSR. Never serialize this request to the browser. */
+    readonly request?: Request;
+}
+export type RouteMiddleware = (context: RouteMiddlewareContext) => void | Response | Promise<void | Response>;
+export declare function defineRouteMiddleware(middleware: RouteMiddleware): RouteMiddleware;
+/** Stops at the first response; middleware files are supplied in filename order. */
+export declare function runRouteMiddleware(middlewares: readonly RouteMiddleware[], context: RouteMiddlewareContext): Promise<Response | undefined>;

package/dist/framework/middleware.js

@@ -0,0 +1,16 @@
+export function defineRouteMiddleware(middleware) {
+    return middleware;
+}
+/** Stops at the first response; middleware files are supplied in filename order. */
+export async function runRouteMiddleware(middlewares, context) {
+    for (const middleware of middlewares) {
+        const result = await middleware(context);
+        if (result === undefined)
+            continue;
+        if (!(result instanceof Response))
+            throw new TypeError("Route middleware must return a Response or nothing");
+        return result;
+    }
+    return undefined;
+}
+//# sourceMappingURL=middleware.js.map

package/dist/framework/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/framework/middleware.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,qBAAqB,CAAC,UAA2B;IAC/D,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAuC,EACvC,OAA+B;IAE/B,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,MAAM,KAAK,SAAS;YAAE,SAAS;QACnC,IAAI,CAAC,CAAC,MAAM,YAAY,QAAQ,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;QAC7G,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import type { RouteMatch } from \"./router.js\";\n\n/** Runs for matched page requests and browser navigations before the loader. */\nexport interface RouteMiddlewareContext {\n  readonly url: URL;\n  readonly match: RouteMatch;\n  readonly signal: AbortSignal;\n  readonly phase: \"server\" | \"client\";\n  /** Only present during SSR. Never serialize this request to the browser. */\n  readonly request?: Request;\n}\n\nexport type RouteMiddleware = (context: RouteMiddlewareContext) => void | Response | Promise<void | Response>;\n\nexport function defineRouteMiddleware(middleware: RouteMiddleware): RouteMiddleware {\n  return middleware;\n}\n\n/** Stops at the first response; middleware files are supplied in filename order. */\nexport async function runRouteMiddleware(\n  middlewares: readonly RouteMiddleware[],\n  context: RouteMiddlewareContext,\n): Promise<Response | undefined> {\n  for (const middleware of middlewares) {\n    const result = await middleware(context);\n    if (result === undefined) continue;\n    if (!(result instanceof Response)) throw new TypeError(\"Route middleware must return a Response or nothing\");\n    return result;\n  }\n  return undefined;\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-contracts-check.d.ts

@@ -0,0 +1,8 @@
+export interface PageContractDiagnostic {
+    readonly filename: string;
+    readonly offset: number;
+    readonly code: "MEEK_PAGE_PROPS" | "MEEK_LAYOUT_PROPS" | "MEEK_ERROR_PROPS";
+    readonly message: string;
+}
+/** Checks generated route/component contracts after a saved project change. */
+export declare function checkFrameworkPageContracts(projectRoot: string): Promise<PageContractDiagnostic[]>;

package/dist/framework/page-contracts-check.js

@@ -0,0 +1,110 @@
+import { execFile } from "node:child_process";
+import { readFile, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+import ts from "@typescript/typescript6";
+import { parseSfc } from "../compiler/sfc.js";
+import { prepareFrameworkTypeDeclarations } from "./type-declarations.js";
+const execute = promisify(execFile);
+const typescriptPackage = fileURLToPath(import.meta.resolve("typescript/package.json"));
+function contractSourceOffset(source, filename) {
+    const script = parseSfc(source, filename).script;
+    const ast = ts.createSourceFile(filename, script.content, ts.ScriptTarget.Latest, true);
+    for (const statement of ast.statements) {
+        if (!ts.isVariableStatement(statement))
+            continue;
+        for (const declaration of statement.declarationList.declarations) {
+            const call = declaration.initializer;
+            if (call && ts.isCallExpression(call) && ts.isIdentifier(call.expression) && call.expression.text === "defineProps") {
+                return script.contentStart + (call.typeArguments?.[0]?.getStart(ast) ?? call.getStart(ast));
+            }
+        }
+    }
+    return script.contentStart;
+}
+function contractAliases(source, filename) {
+    const ast = ts.createSourceFile(filename, source, ts.ScriptTarget.Latest, true);
+    const aliases = new Map();
+    const literal = (node) => node && ts.isLiteralTypeNode(node) && ts.isStringLiteral(node.literal) ? node.literal.text : undefined;
+    for (const statement of ast.statements) {
+        if (!ts.isTypeAliasDeclaration(statement) || !ts.isTypeReferenceNode(statement.type))
+            continue;
+        const check = statement.type.typeArguments?.[0];
+        if (!check || !ts.isTypeReferenceNode(check))
+            continue;
+        const file = literal(check.typeArguments?.[2]);
+        if (!file)
+            continue;
+        const kind = statement.name.text.startsWith("__layout") ? "MEEK_LAYOUT_PROPS"
+            : statement.name.text.startsWith("__error") ? "MEEK_ERROR_PROPS" : "MEEK_PAGE_PROPS";
+        const sidecar = kind === "MEEK_PAGE_PROPS" ? literal(check.typeArguments?.[3]) : undefined;
+        aliases.set(ast.getLineAndCharacterOfPosition(statement.getStart(ast)).line + 1, {
+            file, kind, ...(sidecar === undefined ? {} : { sidecar }),
+        });
+    }
+    return aliases;
+}
+function samePath(left, right) {
+    const a = resolve(left);
+    const b = resolve(right);
+    return process.platform === "win32" ? a.toLowerCase() === b.toLowerCase() : a === b;
+}
+/** Checks generated route/component contracts after a saved project change. */
+export async function checkFrameworkPageContracts(projectRoot) {
+    const root = resolve(projectRoot);
+    await prepareFrameworkTypeDeclarations(root);
+    const generated = join(root, ".meeko", "generated", "page-contracts.server.ts");
+    const aliases = contractAliases(await readFile(generated, "utf8"), generated);
+    // The editor's isolated consumer may not install the optional Vite peer or
+    // @types/node. The contract itself only needs component declarations.
+    const config = join(root, ".meeko", "tsconfig.page-contracts.json");
+    const configSource = `${JSON.stringify({
+        compilerOptions: {
+            target: "ES2022", module: "NodeNext", moduleResolution: "NodeNext", lib: ["ES2022", "DOM"],
+            types: [], strict: true, noEmit: true, skipLibCheck: true, allowArbitraryExtensions: true,
+            rootDirs: ["..", "./types"],
+        },
+        include: ["generated/page-contracts.server.ts", "types/**/*.d.meeko.ts", "types/routes.d.ts"],
+    }, null, 2)}\n`;
+    try {
+        if (await readFile(config, "utf8") !== configSource)
+            await writeFile(config, configSource);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            await writeFile(config, configSource);
+        else
+            throw error;
+    }
+    const compiler = join(dirname(typescriptPackage), "bin", "tsc");
+    let output = "";
+    try {
+        await execute(process.execPath, [compiler, "-p", config, "--noEmit", "--pretty", "false"]);
+    }
+    catch (error) {
+        const failure = error;
+        output = `${failure.stdout ?? ""}${failure.stderr ?? ""}`;
+        if (!output.trim())
+            throw error;
+    }
+    const diagnostics = [];
+    for (const line of output.split(/\r?\n/)) {
+        const match = /^(.*page-contracts\.server\.ts)\((\d+),\d+\): error TS2344: (.*)$/.exec(line);
+        if (!match || !samePath(match[1], generated))
+            continue;
+        const alias = aliases.get(Number(match[2]));
+        if (!alias)
+            continue;
+        const filename = resolve(root, alias.file);
+        const source = await readFile(filename, "utf8");
+        const unsafe = match[3].includes("props cannot be any, never or unknown");
+        const title = alias.kind === "MEEK_PAGE_PROPS" ? "Page" : alias.kind === "MEEK_LAYOUT_PROPS" ? "Layout" : "Error page";
+        const message = unsafe ? `${title} ${alias.file} props cannot be any, never or unknown`
+            : alias.kind === "MEEK_PAGE_PROPS" ? `Page ${alias.file} props do not match loader ${alias.sidecar ?? "(no sidecar)"}`
+                : `${title} ${alias.file} props do not match the values supplied by Meeko`;
+        diagnostics.push({ filename, offset: contractSourceOffset(source, filename), code: alias.kind, message });
+    }
+    return diagnostics;
+}
+//# sourceMappingURL=page-contracts-check.js.map

package/dist/framework/page-contracts-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-contracts-check.js","sourceRoot":"","sources":["../../src/framework/page-contracts-check.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFile } from \"node:child_process\";\nimport { readFile, writeFile } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { promisify } from \"node:util\";\nimport ts from \"@typescript/typescript6\";\nimport { parseSfc } from \"../compiler/sfc.js\";\nimport { prepareFrameworkTypeDeclarations } from \"./type-declarations.js\";\n\nconst execute = promisify(execFile);\nconst typescriptPackage = fileURLToPath(import.meta.resolve(\"typescript/package.json\"));\n\nexport interface PageContractDiagnostic {\n  readonly filename: string;\n  readonly offset: number;\n  readonly code: \"MEEK_PAGE_PROPS\" | \"MEEK_LAYOUT_PROPS\" | \"MEEK_ERROR_PROPS\";\n  readonly message: string;\n}\n\nfunction contractSourceOffset(source: string, filename: string): number {\n  const script = parseSfc(source, filename).script;\n  const ast = ts.createSourceFile(filename, script.content, ts.ScriptTarget.Latest, true);\n  for (const statement of ast.statements) {\n    if (!ts.isVariableStatement(statement)) continue;\n    for (const declaration of statement.declarationList.declarations) {\n      const call = declaration.initializer;\n      if (call && ts.isCallExpression(call) && ts.isIdentifier(call.expression) && call.expression.text === \"defineProps\") {\n        return script.contentStart + (call.typeArguments?.[0]?.getStart(ast) ?? call.getStart(ast));\n      }\n    }\n  }\n  return script.contentStart;\n}\n\nfunction contractAliases(source: string, filename: string): Map<number, { file: string; kind: PageContractDiagnostic[\"code\"]; sidecar?: string }> {\n  const ast = ts.createSourceFile(filename, source, ts.ScriptTarget.Latest, true);\n  const aliases = new Map<number, { file: string; kind: PageContractDiagnostic[\"code\"]; sidecar?: string }>();\n  const literal = (node: ts.TypeNode | undefined): string | undefined =>\n    node && ts.isLiteralTypeNode(node) && ts.isStringLiteral(node.literal) ? node.literal.text : undefined;\n  for (const statement of ast.statements) {\n    if (!ts.isTypeAliasDeclaration(statement) || !ts.isTypeReferenceNode(statement.type)) continue;\n    const check = statement.type.typeArguments?.[0];\n    if (!check || !ts.isTypeReferenceNode(check)) continue;\n    const file = literal(check.typeArguments?.[2]);\n    if (!file) continue;\n    const kind = statement.name.text.startsWith(\"__layout\") ? \"MEEK_LAYOUT_PROPS\"\n      : statement.name.text.startsWith(\"__error\") ? \"MEEK_ERROR_PROPS\" : \"MEEK_PAGE_PROPS\";\n    const sidecar = kind === \"MEEK_PAGE_PROPS\" ? literal(check.typeArguments?.[3]) : undefined;\n    aliases.set(ast.getLineAndCharacterOfPosition(statement.getStart(ast)).line + 1, {\n      file, kind, ...(sidecar === undefined ? {} : { sidecar }),\n    });\n  }\n  return aliases;\n}\n\nfunction samePath(left: string, right: string): boolean {\n  const a = resolve(left);\n  const b = resolve(right);\n  return process.platform === \"win32\" ? a.toLowerCase() === b.toLowerCase() : a === b;\n}\n\n/** Checks generated route/component contracts after a saved project change. */\nexport async function checkFrameworkPageContracts(projectRoot: string): Promise<PageContractDiagnostic[]> {\n  const root = resolve(projectRoot);\n  await prepareFrameworkTypeDeclarations(root);\n  const generated = join(root, \".meeko\", \"generated\", \"page-contracts.server.ts\");\n  const aliases = contractAliases(await readFile(generated, \"utf8\"), generated);\n  // The editor's isolated consumer may not install the optional Vite peer or\n  // @types/node. The contract itself only needs component declarations.\n  const config = join(root, \".meeko\", \"tsconfig.page-contracts.json\");\n  const configSource = `${JSON.stringify({\n    compilerOptions: {\n      target: \"ES2022\", module: \"NodeNext\", moduleResolution: \"NodeNext\", lib: [\"ES2022\", \"DOM\"],\n      types: [], strict: true, noEmit: true, skipLibCheck: true, allowArbitraryExtensions: true,\n      rootDirs: [\"..\", \"./types\"],\n    },\n    include: [\"generated/page-contracts.server.ts\", \"types/**/*.d.meeko.ts\", \"types/routes.d.ts\"],\n  }, null, 2)}\\n`;\n  try { if (await readFile(config, \"utf8\") !== configSource) await writeFile(config, configSource); }\n  catch (error) { if ((error as NodeJS.ErrnoException).code === \"ENOENT\") await writeFile(config, configSource); else throw error; }\n  const compiler = join(dirname(typescriptPackage), \"bin\", \"tsc\");\n  let output = \"\";\n  try { await execute(process.execPath, [compiler, \"-p\", config, \"--noEmit\", \"--pretty\", \"false\"]); }\n  catch (error) {\n    const failure = error as Error & { stdout?: string; stderr?: string };\n    output = `${failure.stdout ?? \"\"}${failure.stderr ?? \"\"}`;\n    if (!output.trim()) throw error;\n  }\n  const diagnostics: PageContractDiagnostic[] = [];\n  for (const line of output.split(/\\r?\\n/)) {\n    const match = /^(.*page-contracts\\.server\\.ts)\\((\\d+),\\d+\\): error TS2344: (.*)$/.exec(line);\n    if (!match || !samePath(match[1]!, generated)) continue;\n    const alias = aliases.get(Number(match[2]));\n    if (!alias) continue;\n    const filename = resolve(root, alias.file);\n    const source = await readFile(filename, \"utf8\");\n    const unsafe = match[3]!.includes(\"props cannot be any, never or unknown\");\n    const title = alias.kind === \"MEEK_PAGE_PROPS\" ? \"Page\" : alias.kind === \"MEEK_LAYOUT_PROPS\" ? \"Layout\" : \"Error page\";\n    const message = unsafe ? `${title} ${alias.file} props cannot be any, never or unknown`\n      : alias.kind === \"MEEK_PAGE_PROPS\" ? `Page ${alias.file} props do not match loader ${alias.sidecar ?? \"(no sidecar)\"}`\n        : `${title} ${alias.file} props do not match the values supplied by Meeko`;\n    diagnostics.push({ filename, offset: contractSourceOffset(source, filename), code: alias.kind, message });\n  }\n  return diagnostics;\n}\n"]}

package/dist/framework/page-contracts-generate.d.ts

@@ -0,0 +1,2 @@
+/** Checks that each page accepts its route params, search and loader data. */
+export declare function generatePageContracts(projectRoot: string): Promise<string>;