davaux 0.8.0

package/dist/oml/types.js

@@ -0,0 +1,64 @@
+function isObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function parseNode(v) {
+  if (v === null) return null;
+  if (!isObject(v)) throw new Error(`OML: expected node object, got ${typeof v}`);
+  const { type } = v;
+  if (type === "#text") {
+    if (typeof v.value !== "string") throw new Error("OML: #text node missing string value");
+    return { type: "#text", value: v.value };
+  }
+  if (type === "#fragment") {
+    return { type: "#fragment", children: parseChildren(v.children) };
+  }
+  if (type === "#component") {
+    if (typeof v.name !== "string") throw new Error("OML: #component node missing name");
+    const parsed = {
+      type: "#component",
+      name: v.name,
+      id: typeof v.id === "string" ? v.id : void 0,
+      props: isObject(v.props) ? v.props : {},
+      output: parseNode(v.output)
+    };
+    if (Array.isArray(v.children) && v.children.length > 0) {
+      parsed.children = parseChildren(v.children);
+    }
+    return parsed;
+  }
+  if (type === "element") {
+    if (typeof v.tag !== "string") throw new Error("OML: element node missing tag");
+    return {
+      type: "element",
+      tag: v.tag,
+      id: typeof v.id === "string" ? v.id : void 0,
+      props: isObject(v.props) ? v.props : {},
+      children: parseChildren(v.children)
+    };
+  }
+  throw new Error(`OML: unknown node type "${type}"`);
+}
+function parseChildren(v) {
+  if (!Array.isArray(v)) return [];
+  return v.map(parseNode);
+}
+function parseOml(json) {
+  return parseNode(json);
+}
+function parseOmlBlueprint(json) {
+  if (!isObject(json)) throw new Error("OML: blueprint must be an object");
+  if (typeof json.id !== "string") throw new Error("OML: blueprint missing id");
+  if (typeof json.name !== "string") throw new Error("OML: blueprint missing name");
+  return {
+    id: json.id,
+    name: json.name,
+    props: isObject(json.props) ? json.props : {},
+    output: parseNode(json.output),
+    imports: isObject(json.imports) ? json.imports : void 0
+  };
+}
+export {
+  parseOml,
+  parseOmlBlueprint
+};
+//# sourceMappingURL=types.js.map

package/dist/oml/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/oml/types.ts"],
+  "sourcesContent": ["// OML \u2014 Object Markup Language\n// A stable, serializable intermediate representation of a rendered component tree.\n// Produced by the OML JSX runtime; consumed by the OML renderer and visual editor.\n\nexport type OmlProps = Record<string, unknown>\n\n/** A plain text node. */\nexport type OmlText = {\n  type: '#text'\n  value: string\n}\n\n/** A raw HTML passthrough node \u2014 not escaped; used for island server stubs and similar. */\nexport type OmlRaw = {\n  type: '#raw'\n  value: string\n}\n\n/** A rendered HTML element. */\nexport type OmlElement = {\n  type: 'element'\n  /** The HTML tag name (div, span, button, etc.). */\n  tag: string\n  /** Stable identity from the JSX `key` prop \u2014 used for diffing and caching. */\n  id?: string\n  props: OmlProps\n  children: OmlNode[]\n}\n\n/**\n * A rendered component call \u2014 preserves component boundaries for the visual\n * editor and inspector. The `return` field is what the component rendered.\n */\nexport type OmlComponent = {\n  type: '#component'\n  /** Component function name \u2014 shown in the inspector. */\n  name: string\n  id?: string\n  /** Props passed to the component (children excluded). */\n  props: OmlProps\n  /**\n   * Resolved JSX children passed to the component \u2014 stored separately from `output`\n   * so the visual editor can show the JSX hierarchy even when `output` is #raw\n   * (i.e. when a library component renders to an HTML string).\n   */\n  children?: OmlNode[]\n  /** The component's rendered output. */\n  output: OmlNode\n}\n\n/** A JSX Fragment \u2014 a grouping with no wrapper element. */\nexport type OmlFragment = {\n  type: '#fragment'\n  children: OmlNode[]\n}\n\nexport type OmlNode = OmlElement | OmlComponent | OmlFragment | OmlText | OmlRaw | null\n\n// \u2500\u2500\u2500 Blueprint \u2014 JSON component definition \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n// Stored in .oml.json files; naturally maps to SurrealDB records.\n\nexport type OmlPropType = 'string' | 'number' | 'boolean' | 'function' | 'node' | 'array'\n\nexport type OmlPropSchema = {\n  type: OmlPropType\n  default?: unknown\n  required?: boolean\n  description?: string\n}\n\n/**\n * A component definition stored in a Blueprint JSON file.\n * The `return` field is the root OmlNode of the component's render tree.\n * Wires (signal connections) between nodes are stored as id references.\n * `imports` maps component names used in the tree to their module paths,\n * enabling round-trip export back to .tsx without losing import information.\n */\nexport type OmlBlueprint = {\n  id: string\n  name: string\n  props: Record<string, OmlPropSchema>\n  output: OmlNode\n  imports?: Record<string, string>\n}\n\n// \u2500\u2500\u2500 JSON parse / validate \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction isObject(v: unknown): v is Record<string, unknown> {\n  return typeof v === 'object' && v !== null && !Array.isArray(v)\n}\n\nfunction parseNode(v: unknown): OmlNode {\n  if (v === null) return null\n  if (!isObject(v)) throw new Error(`OML: expected node object, got ${typeof v}`)\n\n  const { type } = v\n  if (type === '#text') {\n    if (typeof v.value !== 'string') throw new Error('OML: #text node missing string value')\n    return { type: '#text', value: v.value }\n  }\n  if (type === '#fragment') {\n    return { type: '#fragment', children: parseChildren(v.children) }\n  }\n  if (type === '#component') {\n    if (typeof v.name !== 'string') throw new Error('OML: #component node missing name')\n    const parsed: OmlComponent = {\n      type: '#component',\n      name: v.name,\n      id: typeof v.id === 'string' ? v.id : undefined,\n      props: isObject(v.props) ? (v.props as OmlProps) : {},\n      output: parseNode(v.output),\n    }\n    if (Array.isArray(v.children) && v.children.length > 0) {\n      parsed.children = parseChildren(v.children)\n    }\n    return parsed\n  }\n  if (type === 'element') {\n    if (typeof v.tag !== 'string') throw new Error('OML: element node missing tag')\n    return {\n      type: 'element',\n      tag: v.tag,\n      id: typeof v.id === 'string' ? v.id : undefined,\n      props: isObject(v.props) ? (v.props as OmlProps) : {},\n      children: parseChildren(v.children),\n    }\n  }\n  throw new Error(`OML: unknown node type \"${type}\"`)\n}\n\nfunction parseChildren(v: unknown): OmlNode[] {\n  if (!Array.isArray(v)) return []\n  return v.map(parseNode)\n}\n\n/**\n * Parse and validate an `OmlNode` from untrusted JSON (e.g. a Blueprint file).\n * Throws a descriptive error if the shape is invalid.\n */\nexport function parseOml(json: unknown): OmlNode {\n  return parseNode(json)\n}\n\n/**\n * Parse and validate an `OmlBlueprint` from untrusted JSON.\n * Throws a descriptive error if the shape is invalid.\n */\nexport function parseOmlBlueprint(json: unknown): OmlBlueprint {\n  if (!isObject(json)) throw new Error('OML: blueprint must be an object')\n  if (typeof json.id !== 'string') throw new Error('OML: blueprint missing id')\n  if (typeof json.name !== 'string') throw new Error('OML: blueprint missing name')\n  return {\n    id: json.id,\n    name: json.name,\n    props: isObject(json.props) ? (json.props as Record<string, OmlPropSchema>) : {},\n    output: parseNode(json.output),\n    imports: isObject(json.imports) ? (json.imports as Record<string, string>) : undefined,\n  }\n}\n"],
+  "mappings": "AAuFA,SAAS,SAAS,GAA0C;AAC1D,SAAO,OAAO,MAAM,YAAY,MAAM,QAAQ,CAAC,MAAM,QAAQ,CAAC;AAChE;AAEA,SAAS,UAAU,GAAqB;AACtC,MAAI,MAAM,KAAM,QAAO;AACvB,MAAI,CAAC,SAAS,CAAC,EAAG,OAAM,IAAI,MAAM,kCAAkC,OAAO,CAAC,EAAE;AAE9E,QAAM,EAAE,KAAK,IAAI;AACjB,MAAI,SAAS,SAAS;AACpB,QAAI,OAAO,EAAE,UAAU,SAAU,OAAM,IAAI,MAAM,sCAAsC;AACvF,WAAO,EAAE,MAAM,SAAS,OAAO,EAAE,MAAM;AAAA,EACzC;AACA,MAAI,SAAS,aAAa;AACxB,WAAO,EAAE,MAAM,aAAa,UAAU,cAAc,EAAE,QAAQ,EAAE;AAAA,EAClE;AACA,MAAI,SAAS,cAAc;AACzB,QAAI,OAAO,EAAE,SAAS,SAAU,OAAM,IAAI,MAAM,mCAAmC;AACnF,UAAM,SAAuB;AAAA,MAC3B,MAAM;AAAA,MACN,MAAM,EAAE;AAAA,MACR,IAAI,OAAO,EAAE,OAAO,WAAW,EAAE,KAAK;AAAA,MACtC,OAAO,SAAS,EAAE,KAAK,IAAK,EAAE,QAAqB,CAAC;AAAA,MACpD,QAAQ,UAAU,EAAE,MAAM;AAAA,IAC5B;AACA,QAAI,MAAM,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,SAAS,GAAG;AACtD,aAAO,WAAW,cAAc,EAAE,QAAQ;AAAA,IAC5C;AACA,WAAO;AAAA,EACT;AACA,MAAI,SAAS,WAAW;AACtB,QAAI,OAAO,EAAE,QAAQ,SAAU,OAAM,IAAI,MAAM,+BAA+B;AAC9E,WAAO;AAAA,MACL,MAAM;AAAA,MACN,KAAK,EAAE;AAAA,MACP,IAAI,OAAO,EAAE,OAAO,WAAW,EAAE,KAAK;AAAA,MACtC,OAAO,SAAS,EAAE,KAAK,IAAK,EAAE,QAAqB,CAAC;AAAA,MACpD,UAAU,cAAc,EAAE,QAAQ;AAAA,IACpC;AAAA,EACF;AACA,QAAM,IAAI,MAAM,2BAA2B,IAAI,GAAG;AACpD;AAEA,SAAS,cAAc,GAAuB;AAC5C,MAAI,CAAC,MAAM,QAAQ,CAAC,EAAG,QAAO,CAAC;AAC/B,SAAO,EAAE,IAAI,SAAS;AACxB;AAMO,SAAS,SAAS,MAAwB;AAC/C,SAAO,UAAU,IAAI;AACvB;AAMO,SAAS,kBAAkB,MAA6B;AAC7D,MAAI,CAAC,SAAS,IAAI,EAAG,OAAM,IAAI,MAAM,kCAAkC;AACvE,MAAI,OAAO,KAAK,OAAO,SAAU,OAAM,IAAI,MAAM,2BAA2B;AAC5E,MAAI,OAAO,KAAK,SAAS,SAAU,OAAM,IAAI,MAAM,6BAA6B;AAChF,SAAO;AAAA,IACL,IAAI,KAAK;AAAA,IACT,MAAM,KAAK;AAAA,IACX,OAAO,SAAS,KAAK,KAAK,IAAK,KAAK,QAA0C,CAAC;AAAA,IAC/E,QAAQ,UAAU,KAAK,MAAM;AAAA,IAC7B,SAAS,SAAS,KAAK,OAAO,IAAK,KAAK,UAAqC;AAAA,EAC/E;AACF;",
+  "names": []
+}

package/dist/router/handler.d.ts

@@ -0,0 +1,53 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { OmlCacheConfig } from '../config.js';
+import type { OmlNode } from '../oml/types.js';
+import type { LayoutFile, MiddlewareFile, RouteFile, ScanResult } from '../types.js';
+import { type MatchFn } from './matcher.js';
+/** A route file paired with its compiled URL matcher, ready for dispatch. */
+export interface CompiledRoute {
+    route: RouteFile;
+    match: MatchFn;
+}
+/** The compiled representation of a Davaux application, ready to dispatch requests. */
+export interface CompiledApp {
+    routes: CompiledRoute[];
+    layouts: LayoutFile[];
+    middlewares: MiddlewareFile[];
+    /** Compiled path to `src/middleware.ts` — runs on every request before route matching. */
+    appMiddlewarePath?: string;
+    isDev: boolean;
+    /** Whether the visual editor and inspector overlay are active. Requires `editor.enabled: true` in config. */
+    editorEnabled: boolean;
+    clientScripts: string[];
+    clientStylesheets: string[];
+    errorPage?: string;
+    basePath: string;
+    /**
+     * In-process OML cache. Keyed by filePath::pathname+search. Only populated in production
+     * for routes matched by `omlCacheConfig`. Stores the OmlNode and pre-rendered HTML string
+     * so cache hits require zero renderToHtml traversal.
+     */
+    omlCache: Map<string, {
+        node: OmlNode;
+        html: string;
+    }>;
+    /** In dev mode, stores the last rendered OmlNode per URL for the inspector. Not populated in production. */
+    devOmlStore?: Map<string, OmlNode>;
+    /**
+     * OML production cache configuration from `davaux.config.ts` `oml.cache`.
+     * When absent, no routes are cached in production.
+     */
+    omlCacheConfig?: OmlCacheConfig;
+}
+/**
+ * Compile a scan result into a `CompiledApp` ready to dispatch requests.
+ * Typically called once at startup (or on each rebuild in dev mode).
+ */
+export declare function buildApp(result: ScanResult, isDev?: boolean, clientScripts?: string[], clientStylesheets?: string[], appMiddlewarePath?: string, basePath?: string, editorEnabled?: boolean, omlCacheConfig?: OmlCacheConfig): CompiledApp;
+/**
+ * Dispatch a single HTTP request through the compiled app.
+ * Runs app middleware → route matching → scoped middleware → route handler.
+ * Handles redirects, validation errors, payload-too-large, and 404s internally.
+ */
+export declare function dispatch(req: IncomingMessage, res: ServerResponse, app: CompiledApp): Promise<void>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/router/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/router/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAIV,UAAU,EAEV,cAAc,EAGd,SAAS,EACT,UAAU,EACX,MAAM,aAAa,CAAA;AAOpB,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAY1D,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,WAAW,EAAE,cAAc,EAAE,CAAA;IAC7B,0FAA0F;IAC1F,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,KAAK,EAAE,OAAO,CAAA;IACd,6GAA6G;IAC7G,aAAa,EAAE,OAAO,CAAA;IACtB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtD,4GAA4G;IAC5G,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAA;CAChC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,UAAU,EAClB,KAAK,UAAQ,EACb,aAAa,GAAE,MAAM,EAAO,EAC5B,iBAAiB,GAAE,MAAM,EAAO,EAChC,iBAAiB,CAAC,EAAE,MAAM,EAC1B,QAAQ,SAAK,EACb,aAAa,UAAQ,EACrB,cAAc,CAAC,EAAE,cAAc,GAC9B,WAAW,CAmBb;AAwOD;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAsJf"}

package/dist/router/handler.js

@@ -0,0 +1,342 @@
+import { dirname } from "node:path";
+import { renderToHtml, renderToHtmlDev } from "../oml/render.js";
+import {
+  makeContext
+} from "../types.js";
+import { createMatcher } from "./matcher.js";
+const METHOD_TYPES = {
+  GET: ["page", "get"],
+  POST: ["post", "page"],
+  // 'page' to support defineAction exports
+  PUT: ["put"],
+  PATCH: ["patch"],
+  DELETE: ["delete"],
+  HEAD: ["head", "page", "get"],
+  OPTIONS: ["options"]
+};
+function buildApp(result, isDev = false, clientScripts = [], clientStylesheets = [], appMiddlewarePath, basePath = "", editorEnabled = false, omlCacheConfig) {
+  return {
+    routes: result.routes.map((route) => ({
+      route,
+      match: createMatcher(route.urlPattern)
+    })),
+    layouts: result.layouts,
+    middlewares: result.middlewares,
+    appMiddlewarePath,
+    isDev,
+    editorEnabled,
+    clientScripts,
+    clientStylesheets,
+    errorPage: result.errorPage,
+    basePath,
+    omlCache: /* @__PURE__ */ new Map(),
+    devOmlStore: isDev && editorEnabled ? /* @__PURE__ */ new Map() : void 0,
+    omlCacheConfig
+  };
+}
+function matchesCachePattern(pathname, pattern) {
+  const regexStr = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/:[^/]+/g, "[^/]+").replace(/\*/g, ".*");
+  return new RegExp(`^${regexStr}$`).test(pathname);
+}
+function isOmlCacheable(pathname, config) {
+  if (!config) return false;
+  if ("include" in config) return config.include.some((p) => matchesCachePattern(pathname, p));
+  return !config.exclude.some((p) => matchesCachePattern(pathname, p));
+}
+function isOmlNode(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
+  const t = value.type;
+  return t === "element" || t === "#component" || t === "#fragment" || t === "#text" || t === "#raw";
+}
+async function importModule(filePath, isDev) {
+  const url = isDev ? `${filePath}?t=${Date.now()}` : filePath;
+  try {
+    return await import(url);
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    throw new Error(`[davaux] Failed to load module: ${filePath}
+  ${detail}`, { cause: err });
+  }
+}
+function findLayouts(routeFilePath, layouts) {
+  const routeDir = dirname(routeFilePath);
+  return layouts.filter((l) => routeDir === l.dirPath || routeDir.startsWith(`${l.dirPath}/`)).sort((a, b) => b.dirPath.length - a.dirPath.length);
+}
+function findMiddlewares(routeFilePath, middlewares) {
+  const routeDir = dirname(routeFilePath);
+  return middlewares.filter((m) => routeDir === m.dirPath || routeDir.startsWith(`${m.dirPath}/`)).sort((a, b) => a.dirPath.length - b.dirPath.length);
+}
+async function runWithMiddleware(middlewares, ctx, isDev, handler) {
+  const step = async (i) => {
+    if (i < middlewares.length) {
+      const mod = await importModule(middlewares[i].filePath, isDev);
+      const fn = mod.default;
+      await fn(ctx, () => step(i + 1));
+    } else {
+      await handler();
+    }
+  };
+  await step(0);
+}
+function sendPage(html, res) {
+  if (!res.headersSent) {
+    const trimmed = html.trimStart();
+    const full = trimmed.startsWith("<") && !trimmed.startsWith("<!DOCTYPE") ? `<!DOCTYPE html>${html}` : html;
+    res.writeHead(res.statusCode, {
+      "Content-Type": "text/html; charset=utf-8"
+    });
+    res.end(full);
+  } else if (!res.writableEnded) {
+    res.end(html);
+  }
+}
+async function sendPageWithDeferred(html, ctx, res) {
+  if (ctx._deferredSlots.size === 0) {
+    sendPage(html, res);
+    return;
+  }
+  if (res.headersSent) return;
+  const trimmed = html.trimStart();
+  const shell = trimmed.startsWith("<") && !trimmed.startsWith("<!DOCTYPE") ? `<!DOCTYPE html>${html}` : html;
+  res.writeHead(res.statusCode, { "Content-Type": "text/html; charset=utf-8" });
+  res.write(shell);
+  for (const [name, contentPromise] of ctx._deferredSlots) {
+    const content = await contentPromise;
+    const slotHtml = isOmlNode(content) ? renderToHtml(content) : content;
+    res.write(`<template for="${name}">${slotHtml}</template>`);
+  }
+  res.end();
+}
+async function renderPage(route, ctx, layouts, isDev, omlCache, opts) {
+  const { preloadedMod, devOmlStore, omlCacheConfig } = opts ?? {};
+  const mod = preloadedMod ?? await importModule(route.filePath, isDev);
+  const handler = mod.default;
+  const cacheKey = !isDev && isOmlCacheable(ctx.url.pathname, omlCacheConfig) ? `${route.filePath}::${ctx.url.pathname}${ctx.url.search}` : null;
+  const cached = cacheKey ? omlCache.get(cacheKey) : void 0;
+  let html;
+  if (cached !== void 0) {
+    html = cached.html;
+  } else {
+    const result = await handler(ctx);
+    if (isOmlNode(result)) {
+      html = isDev && devOmlStore ? renderToHtmlDev(result) : renderToHtml(result);
+      if (cacheKey) omlCache.set(cacheKey, { node: result, html });
+      if (devOmlStore) {
+        const sp = new URLSearchParams(ctx.url.search);
+        sp.delete("_editor");
+        const search = sp.toString();
+        devOmlStore.set(ctx.url.pathname + (search ? `?${search}` : ""), result);
+      }
+    } else {
+      html = result;
+    }
+  }
+  const applicable = findLayouts(route.filePath, layouts);
+  for (const layout of applicable) {
+    const lmod = await importModule(layout.filePath, isDev);
+    const lhandler = lmod.default;
+    const lresult = await lhandler({
+      children: Object.assign(Promise.resolve(html), { toString: () => html }),
+      ctx
+    });
+    html = isOmlNode(lresult) ? renderToHtml(lresult) : lresult;
+  }
+  return html;
+}
+function initCtx(req, res, params, url, app) {
+  const ctx = makeContext(req, res, params, url, app.basePath);
+  ctx.head.stylesheets.push(...app.clientStylesheets);
+  ctx.head.scripts.push(...app.clientScripts);
+  if (app.isDev) {
+    ctx.head.scripts.push("/_davaux/livereload.js");
+    if (app.editorEnabled && !url.searchParams.has("_editor")) {
+      ctx.head.scripts.push("/_davaux/inspector.js");
+    }
+  }
+  return ctx;
+}
+async function sendErrorPage(status, message, req, res, url, app, existingCtx) {
+  if (res.headersSent) return;
+  if (!app.errorPage) {
+    res.writeHead(status, { "Content-Type": "text/plain" });
+    res.end(message);
+    return;
+  }
+  try {
+    const ctx = existingCtx ?? initCtx(req, res, {}, url, app);
+    const mod = await importModule(app.errorPage, app.isDev);
+    const handler = mod.default;
+    const rawErrorResult = await handler({ status, message, ctx });
+    let html = isOmlNode(rawErrorResult) ? renderToHtml(rawErrorResult) : rawErrorResult;
+    const applicable = findLayouts(app.errorPage, app.layouts);
+    for (const layout of applicable) {
+      const lmod = await importModule(layout.filePath, app.isDev);
+      const lhandler = lmod.default;
+      const lresult = await lhandler({
+        children: Object.assign(Promise.resolve(html), { toString: () => html }),
+        ctx
+      });
+      html = isOmlNode(lresult) ? renderToHtml(lresult) : lresult;
+    }
+    const trimmed = html.trimStart();
+    const full = trimmed.startsWith("<") && !trimmed.startsWith("<!DOCTYPE") ? `<!DOCTYPE html>${html}` : html;
+    res.writeHead(status, { "Content-Type": "text/html; charset=utf-8" });
+    res.end(full);
+  } catch {
+    res.writeHead(status, { "Content-Type": "text/plain" });
+    res.end(message);
+  }
+}
+async function dispatch(req, res, app) {
+  const method = (req.method ?? "GET").toUpperCase();
+  const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+  const allowed = METHOD_TYPES[method] ?? [];
+  const ctx = initCtx(req, res, {}, url, app);
+  const handleRoutes = async () => {
+    for (const { route, match } of app.routes) {
+      if (!allowed.includes(route.type)) continue;
+      const result = match(url.pathname);
+      if (!result) continue;
+      Object.assign(ctx.params, result.params);
+      const applicable = findMiddlewares(route.filePath, app.middlewares);
+      try {
+        await runWithMiddleware(applicable, ctx, app.isDev, async () => {
+          if (route.type === "page") {
+            if (method === "POST") {
+              const mod = await importModule(route.filePath, app.isDev);
+              const actionFn = mod.action;
+              if (typeof actionFn !== "function") {
+                if (!res.headersSent) {
+                  res.writeHead(405, {
+                    Allow: "GET, HEAD",
+                    "Content-Type": "text/plain"
+                  });
+                  res.end("Method Not Allowed");
+                }
+                return;
+              }
+              const result2 = await actionFn(ctx);
+              if (result2 !== void 0) ctx.state.actionResult = result2;
+              await sendPageWithDeferred(
+                await renderPage(route, ctx, app.layouts, app.isDev, app.omlCache, {
+                  preloadedMod: mod,
+                  devOmlStore: app.devOmlStore,
+                  omlCacheConfig: app.omlCacheConfig
+                }),
+                ctx,
+                res
+              );
+            } else {
+              await sendPageWithDeferred(
+                await renderPage(route, ctx, app.layouts, app.isDev, app.omlCache, {
+                  devOmlStore: app.devOmlStore,
+                  omlCacheConfig: app.omlCacheConfig
+                }),
+                ctx,
+                res
+              );
+            }
+          } else {
+            const mod = await importModule(route.filePath, app.isDev);
+            const handler = mod.default;
+            const value = await handler(ctx);
+            if (!res.headersSent && value !== void 0) {
+              if (value instanceof Response) {
+                await writeWebResponse(value, res);
+              } else {
+                res.writeHead(res.statusCode, {
+                  "Content-Type": "application/json; charset=utf-8"
+                });
+                res.end(JSON.stringify(value));
+              }
+            }
+          }
+        });
+      } catch (err) {
+        if (isRedirect(err)) throw err;
+        if (isValidation(err)) throw err;
+        if (isPayloadTooLarge(err)) throw err;
+        console.error(`[davaux] Error in ${route.filePath}:`, err);
+        await sendErrorPage(
+          500,
+          err instanceof Error ? err.message : "Internal Server Error",
+          req,
+          res,
+          url,
+          app,
+          ctx
+        );
+      }
+      return;
+    }
+    await sendErrorPage(404, "Not Found", req, res, url, app, ctx);
+  };
+  try {
+    if (app.appMiddlewarePath) {
+      const mod = await importModule(app.appMiddlewarePath, app.isDev);
+      const fn = mod.default;
+      await fn(ctx, handleRoutes);
+    } else {
+      await handleRoutes();
+    }
+  } catch (err) {
+    if (isRedirect(err)) {
+      if (!res.headersSent) {
+        res.writeHead(err.status, { Location: err.url });
+        res.end();
+      }
+      return;
+    }
+    if (isValidation(err)) {
+      const body = { error: err.message };
+      const cause = err.cause;
+      if (cause != null && typeof cause === "object" && Array.isArray(cause.issues)) {
+        body.issues = cause.issues;
+      }
+      if (!res.headersSent) {
+        res.writeHead(400, { "Content-Type": "application/json; charset=utf-8" });
+        res.end(JSON.stringify(body));
+      }
+      return;
+    }
+    if (isPayloadTooLarge(err)) {
+      if (!res.headersSent) {
+        res.writeHead(413, { "Content-Type": "text/plain" });
+        res.end(err.message);
+      }
+      return;
+    }
+    console.error("[davaux] Error in global middleware:", err);
+    await sendErrorPage(
+      500,
+      err instanceof Error ? err.message : "Internal Server Error",
+      req,
+      res,
+      url,
+      app,
+      ctx
+    );
+  }
+}
+async function writeWebResponse(webRes, res) {
+  const headers = {};
+  webRes.headers.forEach((value, key) => {
+    headers[key] = value;
+  });
+  res.writeHead(webRes.status, headers);
+  res.end(Buffer.from(await webRes.arrayBuffer()));
+}
+function isRedirect(err) {
+  return err?.isRedirect === true;
+}
+function isValidation(err) {
+  return err?.isValidation === true;
+}
+function isPayloadTooLarge(err) {
+  return err?.isPayloadTooLarge === true;
+}
+export {
+  buildApp,
+  dispatch
+};
+//# sourceMappingURL=handler.js.map

package/dist/router/handler.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/router/handler.ts"],
+  "sourcesContent": ["import type { IncomingMessage, ServerResponse } from 'node:http'\nimport { dirname } from 'node:path'\nimport type { OmlCacheConfig } from '../config.js'\nimport { renderToHtml, renderToHtmlDev } from '../oml/render.js'\nimport type { OmlNode } from '../oml/types.js'\nimport type {\n  ActionFn,\n  ErrorPageHandler,\n  ErrorPageProps,\n  LayoutFile,\n  LayoutProps,\n  MiddlewareFile,\n  MiddlewareFn,\n  RequestContext,\n  RouteFile,\n  ScanResult,\n} from '../types.js'\nimport {\n  makeContext,\n  type PayloadTooLargeError,\n  type RedirectError,\n  type ValidationError,\n} from '../types.js'\nimport { createMatcher, type MatchFn } from './matcher.js'\n\nconst METHOD_TYPES: Record<string, string[]> = {\n  GET: ['page', 'get'],\n  POST: ['post', 'page'], // 'page' to support defineAction exports\n  PUT: ['put'],\n  PATCH: ['patch'],\n  DELETE: ['delete'],\n  HEAD: ['head', 'page', 'get'],\n  OPTIONS: ['options'],\n}\n\n/** A route file paired with its compiled URL matcher, ready for dispatch. */\nexport interface CompiledRoute {\n  route: RouteFile\n  match: MatchFn\n}\n\n/** The compiled representation of a Davaux application, ready to dispatch requests. */\nexport interface CompiledApp {\n  routes: CompiledRoute[]\n  layouts: LayoutFile[]\n  middlewares: MiddlewareFile[]\n  /** Compiled path to `src/middleware.ts` \u2014 runs on every request before route matching. */\n  appMiddlewarePath?: string\n  isDev: boolean\n  /** Whether the visual editor and inspector overlay are active. Requires `editor.enabled: true` in config. */\n  editorEnabled: boolean\n  clientScripts: string[]\n  clientStylesheets: string[]\n  errorPage?: string\n  basePath: string\n  /**\n   * In-process OML cache. Keyed by filePath::pathname+search. Only populated in production\n   * for routes matched by `omlCacheConfig`. Stores the OmlNode and pre-rendered HTML string\n   * so cache hits require zero renderToHtml traversal.\n   */\n  omlCache: Map<string, { node: OmlNode; html: string }>\n  /** In dev mode, stores the last rendered OmlNode per URL for the inspector. Not populated in production. */\n  devOmlStore?: Map<string, OmlNode>\n  /**\n   * OML production cache configuration from `davaux.config.ts` `oml.cache`.\n   * When absent, no routes are cached in production.\n   */\n  omlCacheConfig?: OmlCacheConfig\n}\n\n/**\n * Compile a scan result into a `CompiledApp` ready to dispatch requests.\n * Typically called once at startup (or on each rebuild in dev mode).\n */\nexport function buildApp(\n  result: ScanResult,\n  isDev = false,\n  clientScripts: string[] = [],\n  clientStylesheets: string[] = [],\n  appMiddlewarePath?: string,\n  basePath = '',\n  editorEnabled = false,\n  omlCacheConfig?: OmlCacheConfig,\n): CompiledApp {\n  return {\n    routes: result.routes.map((route) => ({\n      route,\n      match: createMatcher(route.urlPattern),\n    })),\n    layouts: result.layouts,\n    middlewares: result.middlewares,\n    appMiddlewarePath,\n    isDev,\n    editorEnabled,\n    clientScripts,\n    clientStylesheets,\n    errorPage: result.errorPage,\n    basePath,\n    omlCache: new Map(),\n    devOmlStore: isDev && editorEnabled ? new Map() : undefined,\n    omlCacheConfig,\n  }\n}\n\n// \u2500\u2500\u2500 OML cache helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction matchesCachePattern(pathname: string, pattern: string): boolean {\n  const regexStr = pattern\n    .replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&') // escape regex special chars (not * or :)\n    .replace(/:[^/]+/g, '[^/]+') // :param \u2192 any non-slash segment\n    .replace(/\\*/g, '.*') // * \u2192 anything\n  return new RegExp(`^${regexStr}$`).test(pathname)\n}\n\nfunction isOmlCacheable(pathname: string, config: OmlCacheConfig | undefined): boolean {\n  if (!config) return false\n  if ('include' in config) return config.include.some((p) => matchesCachePattern(pathname, p))\n  return !config.exclude.some((p) => matchesCachePattern(pathname, p))\n}\n\nfunction isOmlNode(value: unknown): value is OmlNode {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) return false\n  const t = (value as Record<string, unknown>).type\n  return t === 'element' || t === '#component' || t === '#fragment' || t === '#text' || t === '#raw'\n}\n\nasync function importModule(filePath: string, isDev: boolean): Promise<Record<string, unknown>> {\n  const url = isDev ? `${filePath}?t=${Date.now()}` : filePath\n  try {\n    return await (import(url) as Promise<Record<string, unknown>>)\n  } catch (err) {\n    const detail = err instanceof Error ? err.message : String(err)\n    throw new Error(`[davaux] Failed to load module: ${filePath}\\n  ${detail}`, { cause: err })\n  }\n}\n\n// Find layouts that apply to a given route file, ordered innermost \u2192 outermost.\nfunction findLayouts(routeFilePath: string, layouts: LayoutFile[]): LayoutFile[] {\n  const routeDir = dirname(routeFilePath)\n  return layouts\n    .filter((l) => routeDir === l.dirPath || routeDir.startsWith(`${l.dirPath}/`))\n    .sort((a, b) => b.dirPath.length - a.dirPath.length) // deepest first\n}\n\n// Find middlewares that apply to a given route file, ordered outermost \u2192 innermost.\nfunction findMiddlewares(routeFilePath: string, middlewares: MiddlewareFile[]): MiddlewareFile[] {\n  const routeDir = dirname(routeFilePath)\n  return middlewares\n    .filter((m) => routeDir === m.dirPath || routeDir.startsWith(`${m.dirPath}/`))\n    .sort((a, b) => a.dirPath.length - b.dirPath.length) // shallowest first\n}\n\nasync function runWithMiddleware(\n  middlewares: MiddlewareFile[],\n  ctx: RequestContext,\n  isDev: boolean,\n  handler: () => Promise<void>,\n): Promise<void> {\n  const step = async (i: number): Promise<void> => {\n    if (i < middlewares.length) {\n      const mod = await importModule(middlewares[i].filePath, isDev)\n      const fn = mod.default as MiddlewareFn\n      await fn(ctx, () => step(i + 1))\n    } else {\n      await handler()\n    }\n  }\n  await step(0)\n}\n\nfunction sendPage(html: string, res: ServerResponse): void {\n  if (!res.headersSent) {\n    const trimmed = html.trimStart()\n    const full =\n      trimmed.startsWith('<') && !trimmed.startsWith('<!DOCTYPE') ? `<!DOCTYPE html>${html}` : html\n    res.writeHead(res.statusCode, {\n      'Content-Type': 'text/html; charset=utf-8',\n    })\n    res.end(full)\n  } else if (!res.writableEnded) {\n    res.end(html)\n  }\n}\n\nasync function sendPageWithDeferred(\n  html: string,\n  ctx: import('../types.js').RequestContext,\n  res: ServerResponse,\n): Promise<void> {\n  if (ctx._deferredSlots.size === 0) {\n    sendPage(html, res)\n    return\n  }\n  if (res.headersSent) return\n  const trimmed = html.trimStart()\n  const shell =\n    trimmed.startsWith('<') && !trimmed.startsWith('<!DOCTYPE') ? `<!DOCTYPE html>${html}` : html\n  res.writeHead(res.statusCode, { 'Content-Type': 'text/html; charset=utf-8' })\n  res.write(shell)\n  for (const [name, contentPromise] of ctx._deferredSlots) {\n    const content = await contentPromise\n    const slotHtml = isOmlNode(content) ? renderToHtml(content) : (content as string)\n    res.write(`<template for=\"${name}\">${slotHtml}</template>`)\n  }\n  res.end()\n}\n\nasync function renderPage(\n  route: RouteFile,\n  ctx: RequestContext,\n  layouts: LayoutFile[],\n  isDev: boolean,\n  omlCache: Map<string, { node: OmlNode; html: string }>,\n  opts?: {\n    preloadedMod?: Record<string, unknown>\n    devOmlStore?: Map<string, OmlNode>\n    omlCacheConfig?: OmlCacheConfig\n  },\n): Promise<string> {\n  const { preloadedMod, devOmlStore, omlCacheConfig } = opts ?? {}\n  const mod = preloadedMod ?? (await importModule(route.filePath, isDev))\n  const handler = mod.default as (\n    ctx: RequestContext,\n  ) => string | OmlNode | Promise<string | OmlNode>\n\n  const cacheKey =\n    !isDev && isOmlCacheable(ctx.url.pathname, omlCacheConfig)\n      ? `${route.filePath}::${ctx.url.pathname}${ctx.url.search}`\n      : null\n  const cached = cacheKey ? omlCache.get(cacheKey) : undefined\n\n  let html: string\n  if (cached !== undefined) {\n    html = cached.html\n  } else {\n    const result = await handler(ctx)\n    if (isOmlNode(result)) {\n      html = isDev && devOmlStore ? renderToHtmlDev(result) : renderToHtml(result)\n      if (cacheKey) omlCache.set(cacheKey, { node: result, html })\n      if (devOmlStore) {\n        const sp = new URLSearchParams(ctx.url.search)\n        sp.delete('_editor')\n        const search = sp.toString()\n        devOmlStore.set(ctx.url.pathname + (search ? `?${search}` : ''), result)\n      }\n    } else {\n      html = result as string\n    }\n  }\n\n  // Wrap in applicable layouts from innermost to outermost\n  const applicable = findLayouts(route.filePath, layouts)\n  for (const layout of applicable) {\n    const lmod = await importModule(layout.filePath, isDev)\n    const lhandler = lmod.default as (\n      props: LayoutProps,\n    ) => string | OmlNode | Promise<string | OmlNode>\n    // Pass children as Promise<string> so the JSX runtime renders it without escaping\n    const lresult = await lhandler({\n      children: Object.assign(Promise.resolve(html), { toString: () => html }),\n      ctx,\n    })\n    html = isOmlNode(lresult) ? renderToHtml(lresult) : (lresult as string)\n  }\n\n  return html\n}\n\nfunction initCtx(\n  req: IncomingMessage,\n  res: ServerResponse,\n  params: Record<string, string>,\n  url: URL,\n  app: CompiledApp,\n): RequestContext {\n  const ctx = makeContext(req, res, params, url, app.basePath)\n  ctx.head.stylesheets.push(...app.clientStylesheets)\n  ctx.head.scripts.push(...app.clientScripts)\n  if (app.isDev) {\n    ctx.head.scripts.push('/_davaux/livereload.js')\n    if (app.editorEnabled && !url.searchParams.has('_editor')) {\n      ctx.head.scripts.push('/_davaux/inspector.js')\n    }\n  }\n  return ctx\n}\n\nasync function sendErrorPage(\n  status: number,\n  message: string,\n  req: IncomingMessage,\n  res: ServerResponse,\n  url: URL,\n  app: CompiledApp,\n  existingCtx?: RequestContext,\n): Promise<void> {\n  if (res.headersSent) return\n  if (!app.errorPage) {\n    res.writeHead(status, { 'Content-Type': 'text/plain' })\n    res.end(message)\n    return\n  }\n  try {\n    const ctx = existingCtx ?? initCtx(req, res, {}, url, app)\n    const mod = await importModule(app.errorPage, app.isDev)\n    const handler = mod.default as ErrorPageHandler\n    const rawErrorResult = await handler({ status, message, ctx } satisfies ErrorPageProps)\n    let html = isOmlNode(rawErrorResult) ? renderToHtml(rawErrorResult) : (rawErrorResult as string)\n\n    // Apply layouts so error pages inherit site chrome\n    const applicable = findLayouts(app.errorPage, app.layouts)\n    for (const layout of applicable) {\n      const lmod = await importModule(layout.filePath, app.isDev)\n      const lhandler = lmod.default as (\n        props: LayoutProps,\n      ) => string | OmlNode | Promise<string | OmlNode>\n      const lresult = await lhandler({\n        children: Object.assign(Promise.resolve(html), { toString: () => html }),\n        ctx,\n      })\n      html = isOmlNode(lresult) ? renderToHtml(lresult) : (lresult as string)\n    }\n\n    const trimmed = html.trimStart()\n    const full =\n      trimmed.startsWith('<') && !trimmed.startsWith('<!DOCTYPE') ? `<!DOCTYPE html>${html}` : html\n    res.writeHead(status, { 'Content-Type': 'text/html; charset=utf-8' })\n    res.end(full)\n  } catch {\n    res.writeHead(status, { 'Content-Type': 'text/plain' })\n    res.end(message)\n  }\n}\n\n/**\n * Dispatch a single HTTP request through the compiled app.\n * Runs app middleware \u2192 route matching \u2192 scoped middleware \u2192 route handler.\n * Handles redirects, validation errors, payload-too-large, and 404s internally.\n */\nexport async function dispatch(\n  req: IncomingMessage,\n  res: ServerResponse,\n  app: CompiledApp,\n): Promise<void> {\n  const method = (req.method ?? 'GET').toUpperCase()\n  const url = new URL(req.url ?? '/', `http://${req.headers.host ?? 'localhost'}`)\n  const allowed = METHOD_TYPES[method] ?? []\n\n  // ctx is created once and shared between global middleware and route handlers.\n  // params starts empty and is populated in-place after a route match.\n  const ctx = initCtx(req, res, {}, url, app)\n\n  // Inner handler: route matching \u2192 scoped middleware \u2192 route handler \u2192 404.\n  // Never throws \u2014 all errors are caught and turned into responses here.\n  const handleRoutes = async (): Promise<void> => {\n    for (const { route, match } of app.routes) {\n      if (!allowed.includes(route.type)) continue\n\n      const result = match(url.pathname)\n      if (!result) continue\n\n      // Populate params into the shared ctx now that we have a match\n      Object.assign(ctx.params, result.params)\n\n      const applicable = findMiddlewares(route.filePath, app.middlewares)\n\n      try {\n        await runWithMiddleware(applicable, ctx, app.isDev, async () => {\n          if (route.type === 'page') {\n            if (method === 'POST') {\n              const mod = await importModule(route.filePath, app.isDev)\n              const actionFn = mod.action as ActionFn | undefined\n              if (typeof actionFn !== 'function') {\n                if (!res.headersSent) {\n                  res.writeHead(405, {\n                    Allow: 'GET, HEAD',\n                    'Content-Type': 'text/plain',\n                  })\n                  res.end('Method Not Allowed')\n                }\n                return\n              }\n              const result = await actionFn(ctx)\n              if (result !== undefined) ctx.state.actionResult = result\n              await sendPageWithDeferred(\n                await renderPage(route, ctx, app.layouts, app.isDev, app.omlCache, {\n                  preloadedMod: mod,\n                  devOmlStore: app.devOmlStore,\n                  omlCacheConfig: app.omlCacheConfig,\n                }),\n                ctx,\n                res,\n              )\n            } else {\n              await sendPageWithDeferred(\n                await renderPage(route, ctx, app.layouts, app.isDev, app.omlCache, {\n                  devOmlStore: app.devOmlStore,\n                  omlCacheConfig: app.omlCacheConfig,\n                }),\n                ctx,\n                res,\n              )\n            }\n          } else {\n            // API route\n            const mod = await importModule(route.filePath, app.isDev)\n            const handler = mod.default as (ctx: RequestContext) => unknown\n            const value = await handler(ctx)\n            if (!res.headersSent && value !== undefined) {\n              if (value instanceof Response) {\n                await writeWebResponse(value, res)\n              } else {\n                res.writeHead(res.statusCode, {\n                  'Content-Type': 'application/json; charset=utf-8',\n                })\n                res.end(JSON.stringify(value))\n              }\n            }\n          }\n        })\n      } catch (err) {\n        if (isRedirect(err)) throw err\n        if (isValidation(err)) throw err\n        if (isPayloadTooLarge(err)) throw err\n        console.error(`[davaux] Error in ${route.filePath}:`, err)\n        await sendErrorPage(\n          500,\n          err instanceof Error ? err.message : 'Internal Server Error',\n          req,\n          res,\n          url,\n          app,\n          ctx,\n        )\n      }\n      return // route matched \u2014 stop iterating\n    }\n\n    await sendErrorPage(404, 'Not Found', req, res, url, app, ctx)\n  }\n\n  // App middleware (src/middleware.ts) \u2192 routes.\n  // Errors thrown anywhere in the chain are caught here.\n  try {\n    if (app.appMiddlewarePath) {\n      const mod = await importModule(app.appMiddlewarePath, app.isDev)\n      const fn = mod.default as MiddlewareFn\n      await fn(ctx, handleRoutes)\n    } else {\n      await handleRoutes()\n    }\n  } catch (err) {\n    if (isRedirect(err)) {\n      if (!res.headersSent) {\n        res.writeHead(err.status, { Location: err.url })\n        res.end()\n      }\n      return\n    }\n    if (isValidation(err)) {\n      const body: Record<string, unknown> = { error: err.message }\n      const cause = err.cause\n      if (\n        cause != null &&\n        typeof cause === 'object' &&\n        Array.isArray((cause as { issues?: unknown }).issues)\n      ) {\n        body.issues = (cause as { issues: unknown }).issues\n      }\n      if (!res.headersSent) {\n        res.writeHead(400, { 'Content-Type': 'application/json; charset=utf-8' })\n        res.end(JSON.stringify(body))\n      }\n      return\n    }\n    if (isPayloadTooLarge(err)) {\n      if (!res.headersSent) {\n        res.writeHead(413, { 'Content-Type': 'text/plain' })\n        res.end(err.message)\n      }\n      return\n    }\n    console.error('[davaux] Error in global middleware:', err)\n    await sendErrorPage(\n      500,\n      err instanceof Error ? err.message : 'Internal Server Error',\n      req,\n      res,\n      url,\n      app,\n      ctx,\n    )\n  }\n}\n\nasync function writeWebResponse(webRes: Response, res: ServerResponse): Promise<void> {\n  const headers: Record<string, string> = {}\n  webRes.headers.forEach((value, key) => {\n    headers[key] = value\n  })\n  res.writeHead(webRes.status, headers)\n  res.end(Buffer.from(await webRes.arrayBuffer()))\n}\n\nfunction isRedirect(err: unknown): err is RedirectError {\n  return (err as RedirectError)?.isRedirect === true\n}\n\nfunction isValidation(err: unknown): err is ValidationError {\n  return (err as ValidationError)?.isValidation === true\n}\n\nfunction isPayloadTooLarge(err: unknown): err is PayloadTooLargeError {\n  return (err as PayloadTooLargeError)?.isPayloadTooLarge === true\n}\n"],
+  "mappings": "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",
+  "names": ["result"]
+}

package/dist/router/matcher.d.ts

@@ -0,0 +1,21 @@
+/** Result of a successful URL pattern match, containing the extracted named params. */
+export interface MatchResult {
+    params: Record<string, string>;
+}
+/** A compiled URL matcher. Returns a `MatchResult` on match, `null` on miss. */
+export type MatchFn = (pathname: string) => MatchResult | null;
+/**
+ * Compile a URL pattern string into a fast matcher function.
+ *
+ * Pattern segments:
+ * - `:param` — matches a single path segment and captures it by name.
+ * - `*param` — catch-all; matches the rest of the path including slashes.
+ * - anything else — matched literally.
+ *
+ * @example
+ * const match = createMatcher('/blog/:slug')
+ * match('/blog/hello') // → { params: { slug: 'hello' } }
+ * match('/about')      // → null
+ */
+export declare function createMatcher(urlPattern: string): MatchFn;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/router/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/router/matcher.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED,gFAAgF;AAChF,MAAM,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAA;AAE9D;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CA8BzD"}

package/dist/router/matcher.js

@@ -0,0 +1,28 @@
+function createMatcher(urlPattern) {
+  const paramNames = [];
+  const regexParts = urlPattern.split("/").map((segment) => {
+    if (segment.startsWith("*")) {
+      paramNames.push(segment.slice(1));
+      return "(.+)";
+    }
+    if (segment.startsWith(":")) {
+      paramNames.push(segment.slice(1));
+      return "([^/]+)";
+    }
+    return segment.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  });
+  const pattern = new RegExp(`^${regexParts.join("\\/")}$`);
+  return (pathname) => {
+    const match = pathname.match(pattern);
+    if (!match) return null;
+    const params = {};
+    paramNames.forEach((name, i) => {
+      params[name] = decodeURIComponent(match[i + 1]);
+    });
+    return { params };
+  };
+}
+export {
+  createMatcher
+};
+//# sourceMappingURL=matcher.js.map

package/dist/router/matcher.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/router/matcher.ts"],
+  "sourcesContent": ["/** Result of a successful URL pattern match, containing the extracted named params. */\nexport interface MatchResult {\n  params: Record<string, string>\n}\n\n/** A compiled URL matcher. Returns a `MatchResult` on match, `null` on miss. */\nexport type MatchFn = (pathname: string) => MatchResult | null\n\n/**\n * Compile a URL pattern string into a fast matcher function.\n *\n * Pattern segments:\n * - `:param` \u2014 matches a single path segment and captures it by name.\n * - `*param` \u2014 catch-all; matches the rest of the path including slashes.\n * - anything else \u2014 matched literally.\n *\n * @example\n * const match = createMatcher('/blog/:slug')\n * match('/blog/hello') // \u2192 { params: { slug: 'hello' } }\n * match('/about')      // \u2192 null\n */\nexport function createMatcher(urlPattern: string): MatchFn {\n  const paramNames: string[] = []\n\n  // Build regex from pattern segments\n  const regexParts = urlPattern.split('/').map((segment) => {\n    if (segment.startsWith('*')) {\n      paramNames.push(segment.slice(1))\n      return '(.+)' // catch-all: matches multiple path segments including slashes\n    }\n    if (segment.startsWith(':')) {\n      paramNames.push(segment.slice(1))\n      return '([^/]+)'\n    }\n    // Escape regex special chars in static segments\n    return segment.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n  })\n\n  const pattern = new RegExp(`^${regexParts.join('\\\\/')}$`)\n\n  return (pathname: string): MatchResult | null => {\n    const match = pathname.match(pattern)\n    if (!match) return null\n\n    const params: Record<string, string> = {}\n    paramNames.forEach((name, i) => {\n      params[name] = decodeURIComponent(match[i + 1])\n    })\n\n    return { params }\n  }\n}\n"],
+  "mappings": "AAqBO,SAAS,cAAc,YAA6B;AACzD,QAAM,aAAuB,CAAC;AAG9B,QAAM,aAAa,WAAW,MAAM,GAAG,EAAE,IAAI,CAAC,YAAY;AACxD,QAAI,QAAQ,WAAW,GAAG,GAAG;AAC3B,iBAAW,KAAK,QAAQ,MAAM,CAAC,CAAC;AAChC,aAAO;AAAA,IACT;AACA,QAAI,QAAQ,WAAW,GAAG,GAAG;AAC3B,iBAAW,KAAK,QAAQ,MAAM,CAAC,CAAC;AAChC,aAAO;AAAA,IACT;AAEA,WAAO,QAAQ,QAAQ,uBAAuB,MAAM;AAAA,EACtD,CAAC;AAED,QAAM,UAAU,IAAI,OAAO,IAAI,WAAW,KAAK,KAAK,CAAC,GAAG;AAExD,SAAO,CAAC,aAAyC;AAC/C,UAAM,QAAQ,SAAS,MAAM,OAAO;AACpC,QAAI,CAAC,MAAO,QAAO;AAEnB,UAAM,SAAiC,CAAC;AACxC,eAAW,QAAQ,CAAC,MAAM,MAAM;AAC9B,aAAO,IAAI,IAAI,mBAAmB,MAAM,IAAI,CAAC,CAAC;AAAA,IAChD,CAAC;AAED,WAAO,EAAE,OAAO;AAAA,EAClB;AACF;",
+  "names": []
+}

package/dist/router/scanner.d.ts

@@ -0,0 +1,17 @@
+import type { IslandFile, RouteType, ScanResult } from '../types.js';
+/**
+ * Recursively scan `islandsDir` for client island component files.
+ * Files beginning with `_` are ignored. Returns an empty array when the
+ * directory does not exist.
+ */
+export declare function scanIslands(islandsDir: string): Promise<IslandFile[]>;
+/**
+ * Recursively scan `routesDir` for route, layout, middleware, and error-page files.
+ * Routes are sorted so static segments beat dynamic segments, and explicit
+ * HTTP-method routes beat page routes at the same URL pattern.
+ *
+ * @param extraSuffixes - Additional `[suffix, RouteType]` pairs contributed by
+ *   plugins (e.g. `[['.page.md', 'page']]` from `@davaux/markdown`).
+ */
+export declare function scanRoutes(routesDir: string, extraSuffixes?: [string, RouteType][]): Promise<ScanResult>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/router/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/router/scanner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EAIV,SAAS,EACT,UAAU,EACX,MAAM,aAAa,CAAA;AA6FpB;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAoB3E;AAwDD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAO,GACxC,OAAO,CAAC,UAAU,CAAC,CA4ErB"}