davaux 0.8.0

package/dist/router/scanner.js

@@ -0,0 +1,197 @@
+import { existsSync } from "node:fs";
+import { readdir } from "node:fs/promises";
+import { basename, dirname, join, relative } from "node:path";
+const SUFFIX_MAP = [
+  [".page.tsx", "page"],
+  [".page.ts", "page"],
+  [".page.jsx", "page"],
+  [".page.js", "page"],
+  [".get.tsx", "get"],
+  [".get.ts", "get"],
+  [".get.jsx", "get"],
+  [".get.js", "get"],
+  [".post.tsx", "post"],
+  [".post.ts", "post"],
+  [".post.jsx", "post"],
+  [".post.js", "post"],
+  [".put.tsx", "put"],
+  [".put.ts", "put"],
+  [".put.jsx", "put"],
+  [".put.js", "put"],
+  [".patch.tsx", "patch"],
+  [".patch.ts", "patch"],
+  [".patch.jsx", "patch"],
+  [".patch.js", "patch"],
+  [".delete.tsx", "delete"],
+  [".delete.ts", "delete"],
+  [".delete.jsx", "delete"],
+  [".delete.js", "delete"],
+  [".head.ts", "head"],
+  [".head.js", "head"],
+  [".options.ts", "options"],
+  [".options.js", "options"]
+];
+const LAYOUT_NAMES = /* @__PURE__ */ new Set(["_layout.tsx", "_layout.ts", "_layout.jsx", "_layout.js"]);
+const ERROR_PAGE_NAMES = /* @__PURE__ */ new Set(["_error.tsx", "_error.ts", "_error.jsx", "_error.js"]);
+const MIDDLEWARE_NAMES = /* @__PURE__ */ new Set([
+  "_middleware.tsx",
+  "_middleware.ts",
+  "_middleware.jsx",
+  "_middleware.js"
+]);
+function resolveRouteSuffix(filename, suffixMap) {
+  for (const [suffix, type] of suffixMap) {
+    if (filename.endsWith(suffix)) return [filename.slice(0, -suffix.length), type];
+  }
+  return null;
+}
+function segmentToParam(segment) {
+  const catchAll = segment.match(/^\[\.\.\.([^\]]+)\]$/);
+  if (catchAll) return { pattern: `*${catchAll[1]}`, param: catchAll[1] };
+  const m = segment.match(/^\[([^\]]+)\]$/);
+  if (m) return { pattern: `:${m[1]}`, param: m[1] };
+  return { pattern: segment, param: null };
+}
+function fileToUrlPattern(rel) {
+  const params = [];
+  const segments = rel.split("/").map((seg) => {
+    const { pattern, param } = segmentToParam(seg);
+    if (param) params.push(param);
+    return pattern;
+  });
+  if (segments.at(-1) === "index") segments.pop();
+  const raw = `/${segments.join("/")}`;
+  return { urlPattern: raw.replace(/\/+$/, "") || "/", params };
+}
+async function walk(dir, files = []) {
+  const entries = await readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const full = join(dir, entry.name);
+    entry.isDirectory() ? await walk(full, files) : files.push(full);
+  }
+  return files;
+}
+async function scanIslands(islandsDir) {
+  if (!existsSync(islandsDir)) return [];
+  const islands = [];
+  async function walkIslands(dir) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const full = join(dir, entry.name);
+      if (entry.isDirectory()) {
+        await walkIslands(full);
+      } else if (/\.(tsx?|jsx?)$/.test(entry.name) && !entry.name.startsWith("_")) {
+        const id = entry.name.replace(/\.(tsx?|jsx?)$/, "");
+        islands.push({ filePath: full, id });
+      }
+    }
+  }
+  await walkIslands(islandsDir);
+  return islands;
+}
+const TYPE_METHODS = {
+  page: ["GET", "HEAD", "POST"],
+  // POST only when an `action` export is present, but we warn conservatively
+  get: ["GET", "HEAD"],
+  // HEAD checks 'get' in its allowed list
+  post: ["POST"],
+  put: ["PUT"],
+  patch: ["PATCH"],
+  delete: ["DELETE"],
+  head: ["HEAD"],
+  options: ["OPTIONS"]
+};
+function checkConflicts(routes, routesDir) {
+  const byPattern = /* @__PURE__ */ new Map();
+  for (const route of routes) {
+    const group = byPattern.get(route.urlPattern) ?? [];
+    group.push(route);
+    byPattern.set(route.urlPattern, group);
+  }
+  for (const [pattern, group] of byPattern) {
+    if (group.length < 2) continue;
+    for (let i = 0; i < group.length; i++) {
+      for (let j = i + 1; j < group.length; j++) {
+        const a = group[i];
+        const b = group[j];
+        const overlap = TYPE_METHODS[a.type].filter((m) => TYPE_METHODS[b.type].includes(m));
+        if (overlap.length === 0) continue;
+        const aRel = relative(routesDir, a.filePath);
+        const bRel = relative(routesDir, b.filePath);
+        if (a.type === b.type) {
+          console.warn(
+            `[davaux] warning: duplicate ${a.type} route at ${pattern}
+  ${aRel}
+  ${bRel}
+  Only the first will be used.`
+          );
+        } else {
+          const winner = a.type !== "page" ? aRel : bRel;
+          console.warn(
+            `[davaux] warning: ${overlap.join(" + ")} ${pattern} matched by both ${aRel} (${a.type}) and ${bRel} (${b.type}) \u2014 ${winner} takes priority`
+          );
+        }
+      }
+    }
+  }
+}
+async function scanRoutes(routesDir, extraSuffixes = []) {
+  const suffixMap = [...SUFFIX_MAP, ...extraSuffixes];
+  const allFiles = await walk(routesDir);
+  const routes = [];
+  const layouts = [];
+  const middlewares = [];
+  let errorPage;
+  for (const filePath of allFiles) {
+    const rel = relative(routesDir, filePath);
+    const name = basename(rel);
+    if (LAYOUT_NAMES.has(name)) {
+      layouts.push({ filePath, dirPath: dirname(filePath) });
+      continue;
+    }
+    if (ERROR_PAGE_NAMES.has(name)) {
+      errorPage ??= filePath;
+      continue;
+    }
+    if (MIDDLEWARE_NAMES.has(name)) {
+      middlewares.push({ filePath, dirPath: dirname(filePath) });
+      continue;
+    }
+    if (name.startsWith("_")) continue;
+    const resolved = resolveRouteSuffix(rel, suffixMap);
+    if (!resolved) {
+      if (name.endsWith(".tsx") && dirname(filePath) === routesDir) {
+        console.warn(
+          `[davaux] warning: ${rel} is not a route file and will be ignored.
+  If this is a shared component, move it to src/components/ or co-locate it
+  in a subdirectory alongside the routes that use it.`
+        );
+      }
+      continue;
+    }
+    const [stripped, type] = resolved;
+    const { urlPattern, params } = fileToUrlPattern(stripped);
+    routes.push({ filePath, urlPattern, type, params });
+  }
+  checkConflicts(routes, routesDir);
+  const TYPE_PRIORITY = { page: 1 };
+  const dynamicWeight = (pattern) => {
+    const segs = pattern.split("/");
+    if (segs.some((s) => s.startsWith("*"))) return 1e3;
+    return segs.filter((s) => s.startsWith(":")).length;
+  };
+  routes.sort((a, b) => {
+    const ad = dynamicWeight(a.urlPattern);
+    const bd = dynamicWeight(b.urlPattern);
+    if (ad !== bd) return ad - bd;
+    if (a.urlPattern.length !== b.urlPattern.length)
+      return a.urlPattern.length - b.urlPattern.length;
+    return (TYPE_PRIORITY[a.type] ?? 0) - (TYPE_PRIORITY[b.type] ?? 0);
+  });
+  return { routes, layouts, middlewares, errorPage };
+}
+export {
+  scanIslands,
+  scanRoutes
+};
+//# sourceMappingURL=scanner.js.map

package/dist/router/scanner.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/router/scanner.ts"],
+  "sourcesContent": ["import { existsSync } from 'node:fs'\nimport { readdir } from 'node:fs/promises'\nimport { basename, dirname, join, relative } from 'node:path'\nimport type {\n  IslandFile,\n  LayoutFile,\n  MiddlewareFile,\n  RouteFile,\n  RouteType,\n  ScanResult,\n} from '../types.js'\n\n// Maps file suffix \u2192 HTTP route type. Longer suffixes first (more specific).\nconst SUFFIX_MAP: [suffix: string, type: RouteType][] = [\n  ['.page.tsx', 'page'],\n  ['.page.ts', 'page'],\n  ['.page.jsx', 'page'],\n  ['.page.js', 'page'],\n  ['.get.tsx', 'get'],\n  ['.get.ts', 'get'],\n  ['.get.jsx', 'get'],\n  ['.get.js', 'get'],\n  ['.post.tsx', 'post'],\n  ['.post.ts', 'post'],\n  ['.post.jsx', 'post'],\n  ['.post.js', 'post'],\n  ['.put.tsx', 'put'],\n  ['.put.ts', 'put'],\n  ['.put.jsx', 'put'],\n  ['.put.js', 'put'],\n  ['.patch.tsx', 'patch'],\n  ['.patch.ts', 'patch'],\n  ['.patch.jsx', 'patch'],\n  ['.patch.js', 'patch'],\n  ['.delete.tsx', 'delete'],\n  ['.delete.ts', 'delete'],\n  ['.delete.jsx', 'delete'],\n  ['.delete.js', 'delete'],\n  ['.head.ts', 'head'],\n  ['.head.js', 'head'],\n  ['.options.ts', 'options'],\n  ['.options.js', 'options'],\n]\n\n// Files beginning with _ are framework-reserved (layouts, middleware, etc.)\nconst LAYOUT_NAMES = new Set(['_layout.tsx', '_layout.ts', '_layout.jsx', '_layout.js'])\n\nconst ERROR_PAGE_NAMES = new Set(['_error.tsx', '_error.ts', '_error.jsx', '_error.js'])\n\nconst MIDDLEWARE_NAMES = new Set([\n  '_middleware.tsx',\n  '_middleware.ts',\n  '_middleware.jsx',\n  '_middleware.js',\n])\n\nfunction resolveRouteSuffix(\n  filename: string,\n  suffixMap: [string, RouteType][],\n): [stripped: string, type: RouteType] | null {\n  for (const [suffix, type] of suffixMap) {\n    if (filename.endsWith(suffix)) return [filename.slice(0, -suffix.length), type]\n  }\n  return null\n}\n\nfunction segmentToParam(segment: string): {\n  pattern: string\n  param: string | null\n} {\n  const catchAll = segment.match(/^\\[\\.\\.\\.([^\\]]+)\\]$/)\n  if (catchAll) return { pattern: `*${catchAll[1]}`, param: catchAll[1] }\n  const m = segment.match(/^\\[([^\\]]+)\\]$/)\n  if (m) return { pattern: `:${m[1]}`, param: m[1] }\n  return { pattern: segment, param: null }\n}\n\nfunction fileToUrlPattern(rel: string): {\n  urlPattern: string\n  params: string[]\n} {\n  const params: string[] = []\n  const segments = rel.split('/').map((seg) => {\n    const { pattern, param } = segmentToParam(seg)\n    if (param) params.push(param)\n    return pattern\n  })\n\n  if (segments.at(-1) === 'index') segments.pop()\n\n  const raw = `/${segments.join('/')}`\n  return { urlPattern: raw.replace(/\\/+$/, '') || '/', params }\n}\n\nasync function walk(dir: string, files: string[] = []): Promise<string[]> {\n  const entries = await readdir(dir, { withFileTypes: true })\n  for (const entry of entries) {\n    const full = join(dir, entry.name)\n    entry.isDirectory() ? await walk(full, files) : files.push(full)\n  }\n  return files\n}\n\n/**\n * Recursively scan `islandsDir` for client island component files.\n * Files beginning with `_` are ignored. Returns an empty array when the\n * directory does not exist.\n */\nexport async function scanIslands(islandsDir: string): Promise<IslandFile[]> {\n  if (!existsSync(islandsDir)) return []\n\n  const islands: IslandFile[] = []\n\n  async function walkIslands(dir: string): Promise<void> {\n    const entries = await readdir(dir, { withFileTypes: true })\n    for (const entry of entries) {\n      const full = join(dir, entry.name)\n      if (entry.isDirectory()) {\n        await walkIslands(full)\n      } else if (/\\.(tsx?|jsx?)$/.test(entry.name) && !entry.name.startsWith('_')) {\n        const id = entry.name.replace(/\\.(tsx?|jsx?)$/, '')\n        islands.push({ filePath: full, id })\n      }\n    }\n  }\n\n  await walkIslands(islandsDir)\n  return islands\n}\n\n// Which HTTP methods does each route type respond to?\n// Mirrors the METHOD_TYPES map in handler.ts, inverted per type.\nconst TYPE_METHODS: Record<RouteType, string[]> = {\n  page: ['GET', 'HEAD', 'POST'], // POST only when an `action` export is present, but we warn conservatively\n  get: ['GET', 'HEAD'], // HEAD checks 'get' in its allowed list\n  post: ['POST'],\n  put: ['PUT'],\n  patch: ['PATCH'],\n  delete: ['DELETE'],\n  head: ['HEAD'],\n  options: ['OPTIONS'],\n}\n\nfunction checkConflicts(routes: RouteFile[], routesDir: string): void {\n  // Group routes by URL pattern \u2014 conflicts only possible within the same pattern.\n  const byPattern = new Map<string, RouteFile[]>()\n  for (const route of routes) {\n    const group = byPattern.get(route.urlPattern) ?? []\n    group.push(route)\n    byPattern.set(route.urlPattern, group)\n  }\n\n  for (const [pattern, group] of byPattern) {\n    if (group.length < 2) continue\n\n    for (let i = 0; i < group.length; i++) {\n      for (let j = i + 1; j < group.length; j++) {\n        const a = group[i]\n        const b = group[j]\n        const overlap = TYPE_METHODS[a.type].filter((m) => TYPE_METHODS[b.type].includes(m))\n        if (overlap.length === 0) continue\n\n        const aRel = relative(routesDir, a.filePath)\n        const bRel = relative(routesDir, b.filePath)\n\n        if (a.type === b.type) {\n          console.warn(\n            `[davaux] warning: duplicate ${a.type} route at ${pattern}\\n` +\n              `  ${aRel}\\n` +\n              `  ${bRel}\\n` +\n              `  Only the first will be used.`,\n          )\n        } else {\n          // Explicit method routes sort before page routes, so they always win.\n          const winner = a.type !== 'page' ? aRel : bRel\n          console.warn(\n            `[davaux] warning: ${overlap.join(' + ')} ${pattern} matched by both ${aRel} (${a.type}) and ${bRel} (${b.type}) \u2014 ${winner} takes priority`,\n          )\n        }\n      }\n    }\n  }\n}\n\n/**\n * Recursively scan `routesDir` for route, layout, middleware, and error-page files.\n * Routes are sorted so static segments beat dynamic segments, and explicit\n * HTTP-method routes beat page routes at the same URL pattern.\n *\n * @param extraSuffixes - Additional `[suffix, RouteType]` pairs contributed by\n *   plugins (e.g. `[['.page.md', 'page']]` from `@davaux/markdown`).\n */\nexport async function scanRoutes(\n  routesDir: string,\n  extraSuffixes: [string, RouteType][] = [],\n): Promise<ScanResult> {\n  const suffixMap: [string, RouteType][] = [...SUFFIX_MAP, ...extraSuffixes]\n  const allFiles = await walk(routesDir)\n  const routes: RouteFile[] = []\n  const layouts: LayoutFile[] = []\n  const middlewares: MiddlewareFile[] = []\n  let errorPage: string | undefined\n\n  for (const filePath of allFiles) {\n    const rel = relative(routesDir, filePath)\n    const name = basename(rel)\n\n    // Framework-reserved file: layout\n    if (LAYOUT_NAMES.has(name)) {\n      layouts.push({ filePath, dirPath: dirname(filePath) })\n      continue\n    }\n\n    // Framework-reserved file: error page (first one wins)\n    if (ERROR_PAGE_NAMES.has(name)) {\n      errorPage ??= filePath\n      continue\n    }\n\n    // Framework-reserved file: scoped middleware\n    if (MIDDLEWARE_NAMES.has(name)) {\n      middlewares.push({ filePath, dirPath: dirname(filePath) })\n      continue\n    }\n\n    // Skip other underscore-prefixed files silently\n    if (name.startsWith('_')) continue\n\n    const resolved = resolveRouteSuffix(rel, suffixMap)\n    if (!resolved) {\n      // Warn about .tsx files sitting directly in the routes root \u2014 they look like\n      // components that belong in src/components/ rather than src/routes/.\n      if (name.endsWith('.tsx') && dirname(filePath) === routesDir) {\n        console.warn(\n          `[davaux] warning: ${rel} is not a route file and will be ignored.\\n` +\n            `  If this is a shared component, move it to src/components/ or co-locate it\\n` +\n            `  in a subdirectory alongside the routes that use it.`,\n        )\n      }\n      continue\n    }\n\n    const [stripped, type] = resolved\n    const { urlPattern, params } = fileToUrlPattern(stripped)\n    routes.push({ filePath, urlPattern, type, params })\n  }\n\n  checkConflicts(routes, routesDir)\n\n  // Explicit method routes (post, get, put, \u2026) beat page routes at the same URL.\n  // This matters for POST: both `login.post.ts` and `login.page.tsx` (with defineAction)\n  // resolve to `/login`, but the explicit file should always win.\n  const TYPE_PRIORITY: Record<string, number> = { page: 1 } // all explicit methods default to 0\n\n  // Static segments before dynamic before catch-all; shorter paths before longer; explicit methods before pages.\n  const dynamicWeight = (pattern: string) => {\n    const segs = pattern.split('/')\n    if (segs.some((s) => s.startsWith('*'))) return 1000\n    return segs.filter((s) => s.startsWith(':')).length\n  }\n\n  routes.sort((a, b) => {\n    const ad = dynamicWeight(a.urlPattern)\n    const bd = dynamicWeight(b.urlPattern)\n    if (ad !== bd) return ad - bd\n    if (a.urlPattern.length !== b.urlPattern.length)\n      return a.urlPattern.length - b.urlPattern.length\n    return (TYPE_PRIORITY[a.type] ?? 0) - (TYPE_PRIORITY[b.type] ?? 0)\n  })\n\n  return { routes, layouts, middlewares, errorPage }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/server/index.d.ts

@@ -0,0 +1,23 @@
+import { type IncomingMessage, type ServerResponse } from 'node:http';
+import type { CompiledApp } from '../router/handler.js';
+/** Options for `startServer()`. */
+export interface ServerOptions {
+    /** TCP port to listen on. Default: `3000` */
+    port?: number;
+    /** Hostname or IP address to bind to. Default: `'localhost'` */
+    hostname?: string;
+    /**
+     * Called before the Davaux dispatcher on every request.
+     * Return `true` to signal that the request was fully handled (the dispatcher is skipped).
+     */
+    onRequest?: (req: IncomingMessage, res: ServerResponse) => boolean | Promise<boolean>;
+}
+/**
+ * Start the HTTP server and begin accepting requests.
+ *
+ * @param app - A compiled app from `buildApp()`, or a factory function that returns one
+ *   (useful in development when the app is rebuilt between requests).
+ * @returns The underlying `http.Server` instance.
+ */
+export declare function startServer(app: CompiledApp | (() => CompiledApp), options?: ServerOptions): import("node:http").Server<typeof IncomingMessage, typeof ServerResponse>;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAGvD,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACtF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,CAAC,EAAE,OAAO,GAAE,aAAkB,6EAwB9F"}

package/dist/server/index.js

@@ -0,0 +1,29 @@
+import { createServer } from "node:http";
+import { dispatch } from "../router/handler.js";
+function startServer(app, options = {}) {
+  const { port = 3e3, hostname = "localhost", onRequest } = options;
+  const getApp = typeof app === "function" ? app : () => app;
+  const server = createServer(async (req, res) => {
+    if (onRequest) {
+      const handled = await onRequest(req, res);
+      if (handled) return;
+    }
+    dispatch(req, res, getApp()).catch((err) => {
+      console.error("[davaux] Unhandled dispatch error:", err);
+      if (!res.headersSent) {
+        res.writeHead(500, { "Content-Type": "text/plain" });
+        res.end("Internal Server Error");
+      }
+    });
+  });
+  server.listen(port, hostname, () => {
+    console.log(`
+  davaux  http://${hostname}:${port}
+`);
+  });
+  return server;
+}
+export {
+  startServer
+};
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/server/index.ts"],
+  "sourcesContent": ["import { createServer, type IncomingMessage, type ServerResponse } from 'node:http'\nimport type { CompiledApp } from '../router/handler.js'\nimport { dispatch } from '../router/handler.js'\n\n/** Options for `startServer()`. */\nexport interface ServerOptions {\n  /** TCP port to listen on. Default: `3000` */\n  port?: number\n  /** Hostname or IP address to bind to. Default: `'localhost'` */\n  hostname?: string\n  /**\n   * Called before the Davaux dispatcher on every request.\n   * Return `true` to signal that the request was fully handled (the dispatcher is skipped).\n   */\n  onRequest?: (req: IncomingMessage, res: ServerResponse) => boolean | Promise<boolean>\n}\n\n/**\n * Start the HTTP server and begin accepting requests.\n *\n * @param app - A compiled app from `buildApp()`, or a factory function that returns one\n *   (useful in development when the app is rebuilt between requests).\n * @returns The underlying `http.Server` instance.\n */\nexport function startServer(app: CompiledApp | (() => CompiledApp), options: ServerOptions = {}) {\n  const { port = 3000, hostname = 'localhost', onRequest } = options\n  const getApp = typeof app === 'function' ? app : () => app\n\n  const server = createServer(async (req, res) => {\n    if (onRequest) {\n      const handled = await onRequest(req, res)\n      if (handled) return\n    }\n\n    dispatch(req, res, getApp()).catch((err) => {\n      console.error('[davaux] Unhandled dispatch error:', err)\n      if (!res.headersSent) {\n        res.writeHead(500, { 'Content-Type': 'text/plain' })\n        res.end('Internal Server Error')\n      }\n    })\n  })\n\n  server.listen(port, hostname, () => {\n    console.log(`\\n  davaux  http://${hostname}:${port}\\n`)\n  })\n\n  return server\n}\n"],
+  "mappings": "AAAA,SAAS,oBAA+D;AAExE,SAAS,gBAAgB;AAsBlB,SAAS,YAAY,KAAwC,UAAyB,CAAC,GAAG;AAC/F,QAAM,EAAE,OAAO,KAAM,WAAW,aAAa,UAAU,IAAI;AAC3D,QAAM,SAAS,OAAO,QAAQ,aAAa,MAAM,MAAM;AAEvD,QAAM,SAAS,aAAa,OAAO,KAAK,QAAQ;AAC9C,QAAI,WAAW;AACb,YAAM,UAAU,MAAM,UAAU,KAAK,GAAG;AACxC,UAAI,QAAS;AAAA,IACf;AAEA,aAAS,KAAK,KAAK,OAAO,CAAC,EAAE,MAAM,CAAC,QAAQ;AAC1C,cAAQ,MAAM,sCAAsC,GAAG;AACvD,UAAI,CAAC,IAAI,aAAa;AACpB,YAAI,UAAU,KAAK,EAAE,gBAAgB,aAAa,CAAC;AACnD,YAAI,IAAI,uBAAuB;AAAA,MACjC;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAED,SAAO,OAAO,MAAM,UAAU,MAAM;AAClC,YAAQ,IAAI;AAAA,mBAAsB,QAAQ,IAAI,IAAI;AAAA,CAAI;AAAA,EACxD,CAAC;AAED,SAAO;AACT;",
+  "names": []
+}

package/dist/signal.d.ts

@@ -0,0 +1,15 @@
+/** A reactive signal: a `[getter, setter]` tuple. On the server this is backed by a plain variable. */
+export type Signal<T> = [get: () => T, set: (value: T) => void];
+/** A read-only derived value: a zero-argument getter that returns the current result. */
+export type ReadonlySignal<T> = () => T;
+/** Server-side stub — returns a getter/setter pair backed by a plain variable. */
+export declare function createSignal<T>(value: T): Signal<T>;
+/** Server-side stub — runs `fn` once synchronously, no reactive tracking. */
+export declare function createEffect(fn: () => void): void;
+/** Server-side stub — evaluates `fn` immediately and returns a static getter. */
+export declare function createMemo<T>(fn: () => T): ReadonlySignal<T>;
+/** Server-side stub — calls `fn` directly with no tracking context. */
+export declare function untrack<T>(fn: () => T): T;
+/** Server-side stub — calls `fn` directly with no batching. */
+export declare function batch<T>(fn: () => T): T;
+//# sourceMappingURL=signal.d.ts.map

package/dist/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"AAGA,uGAAuG;AACvG,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,CAAA;AAE/D,yFAAyF;AACzF,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,MAAM,CAAC,CAAA;AAEvC,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAOnD;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAEjD;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAG5D;AAED,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEzC;AAED,+DAA+D;AAC/D,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEvC"}

package/dist/signal.js

@@ -0,0 +1,29 @@
+function createSignal(value) {
+  return [
+    () => value,
+    (v) => {
+      value = v;
+    }
+  ];
+}
+function createEffect(fn) {
+  fn();
+}
+function createMemo(fn) {
+  const result = fn();
+  return () => result;
+}
+function untrack(fn) {
+  return fn();
+}
+function batch(fn) {
+  return fn();
+}
+export {
+  batch,
+  createEffect,
+  createMemo,
+  createSignal,
+  untrack
+};
+//# sourceMappingURL=signal.js.map

package/dist/signal.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/signal.ts"],
+  "sourcesContent": ["// Server-side stubs \u2014 synchronous values, no reactive graph.\n// The reactive implementations in davaux/client are used inside islands.\n\n/** A reactive signal: a `[getter, setter]` tuple. On the server this is backed by a plain variable. */\nexport type Signal<T> = [get: () => T, set: (value: T) => void]\n\n/** A read-only derived value: a zero-argument getter that returns the current result. */\nexport type ReadonlySignal<T> = () => T\n\n/** Server-side stub \u2014 returns a getter/setter pair backed by a plain variable. */\nexport function createSignal<T>(value: T): Signal<T> {\n  return [\n    () => value,\n    (v: T) => {\n      value = v\n    },\n  ]\n}\n\n/** Server-side stub \u2014 runs `fn` once synchronously, no reactive tracking. */\nexport function createEffect(fn: () => void): void {\n  fn()\n}\n\n/** Server-side stub \u2014 evaluates `fn` immediately and returns a static getter. */\nexport function createMemo<T>(fn: () => T): ReadonlySignal<T> {\n  const result = fn()\n  return () => result\n}\n\n/** Server-side stub \u2014 calls `fn` directly with no tracking context. */\nexport function untrack<T>(fn: () => T): T {\n  return fn()\n}\n\n/** Server-side stub \u2014 calls `fn` directly with no batching. */\nexport function batch<T>(fn: () => T): T {\n  return fn()\n}\n"],
+  "mappings": "AAUO,SAAS,aAAgB,OAAqB;AACnD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,CAAC,MAAS;AACR,cAAQ;AAAA,IACV;AAAA,EACF;AACF;AAGO,SAAS,aAAa,IAAsB;AACjD,KAAG;AACL;AAGO,SAAS,WAAc,IAAgC;AAC5D,QAAM,SAAS,GAAG;AAClB,SAAO,MAAM;AACf;AAGO,SAAS,QAAW,IAAgB;AACzC,SAAO,GAAG;AACZ;AAGO,SAAS,MAAS,IAAgB;AACvC,SAAO,GAAG;AACZ;",
+  "names": []
+}

package/dist/ssg.d.ts

@@ -0,0 +1,45 @@
+import type { ScanResult } from './types.js';
+/** Options for `generateStatic()`. All directory paths should be absolute. */
+export interface SsgOptions {
+    /** Output directory for generated HTML files. */
+    outDir: string;
+    /** Build output directory — used to locate `_davaux` assets to copy across. */
+    distDir: string;
+    /** Public directory to copy into `outDir` after generation. */
+    publicDir: string;
+    /** Scanned route manifest from `scanRoutes()`. */
+    scan: ScanResult;
+    /** Client JS bundle URLs injected into every generated page. */
+    clientScripts: string[];
+    /** Client CSS URLs injected into every generated page. */
+    clientStylesheets: string[];
+    /** Compiled path to `src/middleware.ts` — applied to every SSG render request. */
+    appMiddlewarePath?: string;
+    /**
+     * Controls the URL-to-filename mapping.
+     * - `'always'` — `/about` → `about/index.html` (default)
+     * - `'never'`  — `/about` → `about.html`
+     */
+    trailingSlash?: 'always' | 'never';
+    /** Base path for subdirectory deployments (e.g. `'/docs'`). */
+    basePath?: string;
+    /** Generate a `404.html` from `_error.tsx`. Default: `true` when `_error.tsx` is present. */
+    notFound?: boolean;
+    /**
+     * Generate a `sitemap.xml`. Pass `false` to disable, or `{ baseUrl }` to enable.
+     * `baseUrl` is prepended to every URL (e.g. `'https://example.com'`).
+     */
+    sitemap?: false | {
+        baseUrl: string;
+    };
+}
+/**
+ * Pre-render all static pages in the route manifest and write them to `outDir`.
+ * Pages with `export const prerender = false` are skipped. Dynamic routes must
+ * export `getStaticPaths` to supply the parameter sets to render.
+ *
+ * Also generates `404.html` (from `_error.tsx`) and `sitemap.xml` when
+ * configured, and copies `_davaux` assets and `public/` into `outDir`.
+ */
+export declare function generateStatic(opts: SsgOptions): Promise<void>;
+//# sourceMappingURL=ssg.d.ts.map

package/dist/ssg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssg.d.ts","sourceRoot":"","sources":["../src/ssg.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAA;AAE9D,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,IAAI,EAAE,UAAU,CAAA;IAChB,gEAAgE;IAChE,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,0DAA0D;IAC1D,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CACtC;AA+ED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA8HpE"}

package/dist/ssg.js

@@ -0,0 +1,175 @@
+import { existsSync } from "node:fs";
+import { cp, mkdir, writeFile } from "node:fs/promises";
+import { dirname, join, relative } from "node:path";
+import { frameworkWarn } from "./errors.js";
+import { buildApp, dispatch } from "./router/handler.js";
+function makeMockReq(pathname) {
+  return {
+    method: "GET",
+    url: pathname,
+    headers: { host: "localhost", cookie: "" },
+    on(event, listener) {
+      if (event === "end") setImmediate(() => listener());
+      return this;
+    },
+    removeListener() {
+      return this;
+    }
+  };
+}
+function makeMockRes() {
+  let status = 200;
+  let body = "";
+  let sent = false;
+  let ended = false;
+  const hdrs = {};
+  const res = {
+    get statusCode() {
+      return status;
+    },
+    set statusCode(v) {
+      status = v;
+    },
+    get headersSent() {
+      return sent;
+    },
+    get writableEnded() {
+      return ended;
+    },
+    writeHead(code) {
+      status = code;
+      sent = true;
+    },
+    end(data) {
+      if (data != null) body = typeof data === "string" ? data : data.toString("utf-8");
+      ended = true;
+    },
+    getHeader: (name) => hdrs[name.toLowerCase()],
+    setHeader(name, value) {
+      hdrs[name.toLowerCase()] = value;
+    }
+  };
+  return [res, () => ({ status, html: body })];
+}
+function urlToFile(outDir, url, trailingSlash = "always") {
+  const trimmed = url.replace(/^\//, "").replace(/\/$/, "");
+  if (!trimmed) return join(outDir, "index.html");
+  if (trailingSlash === "never") return join(outDir, `${trimmed}.html`);
+  return join(outDir, trimmed, "index.html");
+}
+function toSitemapUrl(baseUrl, basePath, urlPath, trailingSlash) {
+  const base = baseUrl.replace(/\/$/, "");
+  const bp = basePath.replace(/\/$/, "");
+  const trimmed = urlPath.replace(/\/$/, "");
+  const path = !trimmed ? "/" : trailingSlash === "never" ? trimmed : `${trimmed}/`;
+  return `${base}${bp}${path}`;
+}
+async function generateStatic(opts) {
+  const {
+    outDir,
+    distDir,
+    publicDir,
+    scan,
+    appMiddlewarePath,
+    trailingSlash = "always",
+    basePath = "",
+    notFound,
+    sitemap
+  } = opts;
+  const clientScripts = opts.clientScripts.map((s) => `${basePath}${s}`);
+  const clientStylesheets = opts.clientStylesheets.map((s) => `${basePath}${s}`);
+  const app = buildApp(scan, false, clientScripts, clientStylesheets, appMiddlewarePath, basePath);
+  const toRender = [];
+  for (const route of scan.routes) {
+    if (route.type !== "page") continue;
+    const mod = await import(route.filePath);
+    if (mod.prerender === false) continue;
+    if (route.params.length === 0) {
+      toRender.push(route.urlPattern);
+    } else {
+      const fn = mod.getStaticPaths;
+      if (typeof fn !== "function") {
+        frameworkWarn(
+          `[ssg] skipping ${route.urlPattern} \u2014 dynamic route has no getStaticPaths export`,
+          `Add a getStaticPaths export to ${relative(process.cwd(), route.filePath)}:
+
+  export const getStaticPaths = async () => [
+    { params: { /* param: value */ } },
+  ]`
+        );
+        continue;
+      }
+      const paths = await fn();
+      for (const sp of paths) {
+        let url = route.urlPattern;
+        for (const [k, v] of Object.entries(sp.params)) url = url.replace(`:${k}`, String(v));
+        toRender.push(url);
+      }
+    }
+  }
+  await mkdir(outDir, { recursive: true });
+  let count = 0;
+  const renderedUrls = [];
+  for (const url of toRender) {
+    try {
+      const req = makeMockReq(url);
+      const [res, result] = makeMockRes();
+      await dispatch(req, res, app);
+      const { status, html } = result();
+      if (status >= 300) {
+        frameworkWarn(`[ssg] ${url} \u2192 HTTP ${status} \u2014 skipping`);
+        continue;
+      }
+      const file = urlToFile(outDir, url, trailingSlash);
+      await mkdir(dirname(file), { recursive: true });
+      const full = html.trimStart().startsWith("<!") ? html : `<!DOCTYPE html>${html}`;
+      await writeFile(file, full, "utf-8");
+      renderedUrls.push(url);
+      count++;
+    } catch (err) {
+      const detail = err instanceof Error ? err.message : String(err);
+      frameworkWarn(`[ssg] ${url} failed to render \u2014 skipping
+  ${detail}`);
+    }
+  }
+  const shouldGenerateNotFound = notFound !== false && scan.errorPage != null;
+  if (shouldGenerateNotFound) {
+    try {
+      const req = makeMockReq("/__davaux_404__");
+      const [res, result] = makeMockRes();
+      await dispatch(req, res, app);
+      const { html } = result();
+      const full = html.trimStart().startsWith("<!") ? html : `<!DOCTYPE html>${html}`;
+      await writeFile(join(outDir, "404.html"), full, "utf-8");
+      console.log("[davaux] Generated 404.html");
+    } catch (err) {
+      const detail = err instanceof Error ? err.message : String(err);
+      frameworkWarn(`[ssg] Failed to render 404.html \u2014 skipping
+  ${detail}`);
+    }
+  }
+  if (sitemap !== false && sitemap != null) {
+    const entries = renderedUrls.map(
+      (url) => `  <url><loc>${toSitemapUrl(sitemap.baseUrl, basePath, url, trailingSlash)}</loc></url>`
+    ).join("\n");
+    const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${entries}
+</urlset>
+`;
+    await writeFile(join(outDir, "sitemap.xml"), xml, "utf-8");
+    console.log(`[davaux] Generated sitemap.xml (${renderedUrls.length} URL(s))`);
+  }
+  const assetsDir = join(distDir, "_davaux");
+  if (existsSync(assetsDir)) {
+    await cp(assetsDir, join(outDir, "_davaux"), { recursive: true });
+  }
+  if (existsSync(publicDir)) {
+    await cp(publicDir, outDir, { recursive: true });
+  }
+  console.log(`[davaux] Generated ${count} static page(s) \u2192 ${relative(process.cwd(), outDir)}/`);
+}
+export {
+  generateStatic
+};
+//# sourceMappingURL=ssg.js.map

package/dist/ssg.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/ssg.ts"],
+  "sourcesContent": ["import { existsSync } from 'node:fs'\nimport { cp, mkdir, writeFile } from 'node:fs/promises'\nimport type { IncomingMessage, ServerResponse } from 'node:http'\nimport { dirname, join, relative } from 'node:path'\nimport { frameworkWarn } from './errors.js'\nimport { buildApp, dispatch } from './router/handler.js'\nimport type { GetStaticPathsFn, ScanResult } from './types.js'\n\n/** Options for `generateStatic()`. All directory paths should be absolute. */\nexport interface SsgOptions {\n  /** Output directory for generated HTML files. */\n  outDir: string\n  /** Build output directory \u2014 used to locate `_davaux` assets to copy across. */\n  distDir: string\n  /** Public directory to copy into `outDir` after generation. */\n  publicDir: string\n  /** Scanned route manifest from `scanRoutes()`. */\n  scan: ScanResult\n  /** Client JS bundle URLs injected into every generated page. */\n  clientScripts: string[]\n  /** Client CSS URLs injected into every generated page. */\n  clientStylesheets: string[]\n  /** Compiled path to `src/middleware.ts` \u2014 applied to every SSG render request. */\n  appMiddlewarePath?: string\n  /**\n   * Controls the URL-to-filename mapping.\n   * - `'always'` \u2014 `/about` \u2192 `about/index.html` (default)\n   * - `'never'`  \u2014 `/about` \u2192 `about.html`\n   */\n  trailingSlash?: 'always' | 'never'\n  /** Base path for subdirectory deployments (e.g. `'/docs'`). */\n  basePath?: string\n  /** Generate a `404.html` from `_error.tsx`. Default: `true` when `_error.tsx` is present. */\n  notFound?: boolean\n  /**\n   * Generate a `sitemap.xml`. Pass `false` to disable, or `{ baseUrl }` to enable.\n   * `baseUrl` is prepended to every URL (e.g. `'https://example.com'`).\n   */\n  sitemap?: false | { baseUrl: string }\n}\n\nfunction makeMockReq(pathname: string): IncomingMessage {\n  return {\n    method: 'GET',\n    url: pathname,\n    headers: { host: 'localhost', cookie: '' },\n    on(event: string, listener: (...args: unknown[]) => void) {\n      // Immediately signal end of body so ctx.json()/ctx.form() resolve empty\n      if (event === 'end') setImmediate(() => listener())\n      return this\n    },\n    removeListener() {\n      return this\n    },\n  } as unknown as IncomingMessage\n}\n\nfunction makeMockRes(): [ServerResponse, () => { status: number; html: string }] {\n  let status = 200\n  let body = ''\n  let sent = false\n  let ended = false\n  const hdrs: Record<string, string | string[]> = {}\n\n  const res = {\n    get statusCode() {\n      return status\n    },\n    set statusCode(v: number) {\n      status = v\n    },\n    get headersSent() {\n      return sent\n    },\n    get writableEnded() {\n      return ended\n    },\n    writeHead(code: number) {\n      status = code\n      sent = true\n    },\n    end(data?: string | Buffer) {\n      if (data != null) body = typeof data === 'string' ? data : data.toString('utf-8')\n      ended = true\n    },\n    getHeader: (name: string) => hdrs[name.toLowerCase()],\n    setHeader(name: string, value: string | string[]) {\n      hdrs[name.toLowerCase()] = value\n    },\n  } as unknown as ServerResponse\n\n  return [res, () => ({ status, html: body })]\n}\n\nfunction urlToFile(\n  outDir: string,\n  url: string,\n  trailingSlash: 'always' | 'never' = 'always',\n): string {\n  const trimmed = url.replace(/^\\//, '').replace(/\\/$/, '')\n  if (!trimmed) return join(outDir, 'index.html')\n  if (trailingSlash === 'never') return join(outDir, `${trimmed}.html`)\n  return join(outDir, trimmed, 'index.html')\n}\n\nfunction toSitemapUrl(\n  baseUrl: string,\n  basePath: string,\n  urlPath: string,\n  trailingSlash: 'always' | 'never',\n): string {\n  const base = baseUrl.replace(/\\/$/, '')\n  const bp = basePath.replace(/\\/$/, '')\n  const trimmed = urlPath.replace(/\\/$/, '')\n  const path = !trimmed ? '/' : trailingSlash === 'never' ? trimmed : `${trimmed}/`\n  return `${base}${bp}${path}`\n}\n\n/**\n * Pre-render all static pages in the route manifest and write them to `outDir`.\n * Pages with `export const prerender = false` are skipped. Dynamic routes must\n * export `getStaticPaths` to supply the parameter sets to render.\n *\n * Also generates `404.html` (from `_error.tsx`) and `sitemap.xml` when\n * configured, and copies `_davaux` assets and `public/` into `outDir`.\n */\nexport async function generateStatic(opts: SsgOptions): Promise<void> {\n  const {\n    outDir,\n    distDir,\n    publicDir,\n    scan,\n    appMiddlewarePath,\n    trailingSlash = 'always',\n    basePath = '',\n    notFound,\n    sitemap,\n  } = opts\n\n  // Prepend basePath to injected asset URLs so the rendered HTML references the correct paths\n  const clientScripts = opts.clientScripts.map((s) => `${basePath}${s}`)\n  const clientStylesheets = opts.clientStylesheets.map((s) => `${basePath}${s}`)\n\n  const app = buildApp(scan, false, clientScripts, clientStylesheets, appMiddlewarePath, basePath)\n\n  // Collect all URL paths to render\n  const toRender: string[] = []\n\n  for (const route of scan.routes) {\n    if (route.type !== 'page') continue\n\n    const mod = (await import(route.filePath)) as Record<string, unknown>\n    if (mod.prerender === false) continue\n\n    if (route.params.length === 0) {\n      toRender.push(route.urlPattern)\n    } else {\n      const fn = mod.getStaticPaths as GetStaticPathsFn | undefined\n      if (typeof fn !== 'function') {\n        frameworkWarn(\n          `[ssg] skipping ${route.urlPattern} \u2014 dynamic route has no getStaticPaths export`,\n          `Add a getStaticPaths export to ${relative(process.cwd(), route.filePath)}:\\n\\n` +\n            `  export const getStaticPaths = async () => [\\n` +\n            `    { params: { /* param: value */ } },\\n` +\n            `  ]`,\n        )\n        continue\n      }\n      const paths = await fn()\n      for (const sp of paths) {\n        let url = route.urlPattern\n        for (const [k, v] of Object.entries(sp.params)) url = url.replace(`:${k}`, String(v))\n        toRender.push(url)\n      }\n    }\n  }\n\n  await mkdir(outDir, { recursive: true })\n\n  let count = 0\n  const renderedUrls: string[] = []\n\n  for (const url of toRender) {\n    try {\n      const req = makeMockReq(url)\n      const [res, result] = makeMockRes()\n      await dispatch(req, res, app)\n      const { status, html } = result()\n\n      if (status >= 300) {\n        frameworkWarn(`[ssg] ${url} \u2192 HTTP ${status} \u2014 skipping`)\n        continue\n      }\n\n      const file = urlToFile(outDir, url, trailingSlash)\n      await mkdir(dirname(file), { recursive: true })\n      const full = html.trimStart().startsWith('<!') ? html : `<!DOCTYPE html>${html}`\n      await writeFile(file, full, 'utf-8')\n      renderedUrls.push(url)\n      count++\n    } catch (err) {\n      const detail = err instanceof Error ? err.message : String(err)\n      frameworkWarn(`[ssg] ${url} failed to render \u2014 skipping\\n  ${detail}`)\n    }\n  }\n\n  // Generate 404.html for static hosts (Netlify, GitHub Pages, etc.)\n  const shouldGenerateNotFound = notFound !== false && scan.errorPage != null\n  if (shouldGenerateNotFound) {\n    try {\n      const req = makeMockReq('/__davaux_404__')\n      const [res, result] = makeMockRes()\n      await dispatch(req, res, app)\n      const { html } = result()\n      const full = html.trimStart().startsWith('<!') ? html : `<!DOCTYPE html>${html}`\n      await writeFile(join(outDir, '404.html'), full, 'utf-8')\n      console.log('[davaux] Generated 404.html')\n    } catch (err) {\n      const detail = err instanceof Error ? err.message : String(err)\n      frameworkWarn(`[ssg] Failed to render 404.html \u2014 skipping\\n  ${detail}`)\n    }\n  }\n\n  // Generate sitemap.xml\n  if (sitemap !== false && sitemap != null) {\n    const entries = renderedUrls\n      .map(\n        (url) =>\n          `  <url><loc>${toSitemapUrl(sitemap.baseUrl, basePath, url, trailingSlash)}</loc></url>`,\n      )\n      .join('\\n')\n    const xml =\n      `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\\n` +\n      `<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\\n` +\n      `${entries}\\n` +\n      `</urlset>\\n`\n    await writeFile(join(outDir, 'sitemap.xml'), xml, 'utf-8')\n    console.log(`[davaux] Generated sitemap.xml (${renderedUrls.length} URL(s))`)\n  }\n\n  // Copy _davaux assets (islands, client bundle, CSS)\n  const assetsDir = join(distDir, '_davaux')\n  if (existsSync(assetsDir)) {\n    await cp(assetsDir, join(outDir, '_davaux'), { recursive: true })\n  }\n\n  // Copy public/ directory if present\n  if (existsSync(publicDir)) {\n    await cp(publicDir, outDir, { recursive: true })\n  }\n\n  console.log(`[davaux] Generated ${count} static page(s) \u2192 ${relative(process.cwd(), outDir)}/`)\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/test/actions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=actions.test.d.ts.map

package/dist/test/actions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.test.d.ts","sourceRoot":"","sources":["../../src/test/actions.test.ts"],"names":[],"mappings":""}

package/dist/test/body-limits.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=body-limits.test.d.ts.map

package/dist/test/body-limits.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-limits.test.d.ts","sourceRoot":"","sources":["../../src/test/body-limits.test.ts"],"names":[],"mappings":""}

package/dist/test/errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.test.d.ts.map

package/dist/test/errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.d.ts","sourceRoot":"","sources":["../../src/test/errors.test.ts"],"names":[],"mappings":""}