@timber-js/app 0.2.0-alpha.98 → 0.2.0-alpha.99

package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts}

@@ -19,15 +19,7 @@ import type { ViteDevServer } from 'vite';
 export type ErrorPhase = 'module-transform' | 'proxy' | 'middleware' | 'access' | 'render' | 'handler';
 /** Labels for terminal output. */
 export declare const PHASE_LABELS: Record<ErrorPhase, string>;
-export type FrameType = 'app' | 'framework' | 'internal';
-/**
- * Classify a stack frame line by origin.
- *
- * - 'app': user application code (in project root, not node_modules)
- * - 'framework': timber-app internal code
- * - 'internal': node_modules, Node.js internals
- */
-export declare function classifyFrame(frameLine: string, projectRoot: string): FrameType;
+export { classifyFrame, classifyStack, type FrameType, type ClassifiedFrame } from './stack-classifier.js';
 /**
  * Extract the React component stack from an error, if present.
  * React attaches this as `componentStack` during renderToReadableStream errors.
@@ -48,7 +40,7 @@ export declare function parseFirstAppFrame(stack: string, projectRoot: string):
  * Falls back to 'render' if no specific phase can be determined.
  */
 export declare function classifyErrorPhase(error: Error, projectRoot: string): ErrorPhase;
-import { formatTerminalError as _formatTerminalError } from './dev-terminal-error.js';
+import { formatTerminalError as _formatTerminalError } from './terminal.js';
 export declare const formatTerminalError: typeof _formatTerminalError;
 /**
  * Component info extracted from the RSC debug channel.
@@ -96,5 +88,4 @@ export declare function fixErrorStacktrace(server: ViteDevServer, error: Error,
  * The dev server remains running — errors are handled, not fatal.
  */
 export declare function sendErrorToOverlay(server: ViteDevServer, error: Error, phase: ErrorPhase, projectRoot: string, rscDebugComponents?: RscDebugComponentInfo[]): void;
-export {};
-//# sourceMappingURL=dev-error-overlay.d.ts.map
+//# sourceMappingURL=overlay.d.ts.map

package/dist/dev-tools/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/dev-tools/overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,MAAM,CAAC;AAqC1D,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAClB,kBAAkB,GAClB,OAAO,GACP,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,SAAS,CAAC;AAEd,kCAAkC;AAClC,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAOnD,CAAC;AAIF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI3G;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAUnE;AAID,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAqB5F;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CAehF;AAOD,OAAO,EAAE,mBAAmB,IAAI,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC5E,eAAO,MAAM,mBAAmB,6BAAuB,CAAC;AAIxD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAiCjF;AAkBD,wBAAgB,2BAA2B,IAAI,MAAM,CAyBpD;AAmHD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAMhG;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,EACnB,kBAAkB,CAAC,EAAE,qBAAqB,EAAE,GAC3C,IAAI,CA0CN"}

package/dist/dev-tools/stack-classifier.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Stack trace frame classifier — categorizes stack frames by origin.
+ *
+ * Provides `classifyFrame` (single frame) and `classifyStack` (full stack
+ * string) as the shared primitives used by the error page, terminal
+ * formatter, and overlay.
+ *
+ * Dev-only: this module is only imported by other dev-tools modules.
+ */
+export type FrameType = 'app' | 'framework' | 'internal';
+export interface ClassifiedFrame {
+    raw: string;
+    type: FrameType;
+    file?: string;
+    line?: number;
+    col?: number;
+}
+/**
+ * Classify a single stack frame line by origin.
+ *
+ * - 'app': user application code (in project root, not node_modules)
+ * - 'framework': timber-app internal code
+ * - 'internal': node_modules, Node.js internals
+ */
+export declare function classifyFrame(frameLine: string, projectRoot: string): FrameType;
+/**
+ * Classify all frames in a full stack trace string.
+ *
+ * Parses the stack, skips the first line (error message), filters to
+ * lines starting with "at ", and returns classified frames with optional
+ * file/line/col metadata.
+ */
+export declare function classifyStack(stack: string, projectRoot: string): ClassifiedFrame[];
+//# sourceMappingURL=stack-classifier.d.ts.map

package/dist/dev-tools/stack-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-classifier.d.ts","sourceRoot":"","sources":["../../src/dev-tools/stack-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,WAAW,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAmBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAS/E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe,EAAE,CAUnF"}

package/dist/{plugins/dev-terminal-error.d.ts → dev-tools/terminal.d.ts}

@@ -13,7 +13,7 @@
  *
  * Design doc: 21-dev-server.md §"Error Overlay"
  */
-import { type ErrorPhase } from './dev-error-overlay.js';
+import { type ErrorPhase } from './overlay.js';
 /**
  * Format an error for terminal output with a boxed layout.
  *
@@ -25,4 +25,4 @@ import { type ErrorPhase } from './dev-error-overlay.js';
  * 5. Component stack (if present)
  */
 export declare function formatTerminalError(error: Error, phase: ErrorPhase, projectRoot: string): string;
-//# sourceMappingURL=dev-terminal-error.d.ts.map
+//# sourceMappingURL=terminal.d.ts.map

package/dist/dev-tools/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/dev-tools/terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AA4EtB;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAkEhG"}

package/dist/{server/dev-warnings.d.ts → dev-tools/warnings.d.ts}

@@ -106,4 +106,4 @@ export declare function _resetWarnings(): void;
  * @internal
  */
 export declare function _getEmitted(): ReadonlySet<string>;
-//# sourceMappingURL=dev-warnings.d.ts.map
+//# sourceMappingURL=warnings.d.ts.map

package/dist/dev-tools/warnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.d.ts","sourceRoot":"","sources":["../../src/dev-tools/warnings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAK1C,eAAO,MAAM,SAAS;;;;;;;CAOZ,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAInE,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AASD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAEhE;AA0CD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CASrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAUpE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CASxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAU5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQnF;AAKD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAQtF;AAID;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,WAAW,CAAC,MAAM,CAAC,CAEjD"}

package/dist/index.d.ts

@@ -12,6 +12,7 @@
 import type { PluginOption } from 'vite';
 import type { TimberUserConfig } from './config-types.js';
 export type { TimberUserConfig } from './config-types.js';
+export type { Metadata, MetadataRoute, MetadataHandler, MetadataResult } from './server/types.js';
 /**
  * Route map interface — augmented by the generated timber-routes.d.ts.
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAU,YAAY,EAAE,MAAM,MAAM,CAAC;AA0BjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAc1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;GASG;AAEH,MAAM,WAAW,MAAM;CAAG;AAE1B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAEvE;AAgGD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CA+ShE;AAED,eAAe,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAU,YAAY,EAAE,MAAM,MAAM,CAAC;AA0BjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAc1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQ1D,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAElG;;;;;;;;;GASG;AAEH,MAAM,WAAW,MAAM;CAAG;AAE1B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAEvE;AAgGD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CA+ShE;AAED,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -1,7 +1,8 @@
 import { a as __toCommonJS, i as __require, n as __esmMin, o as __toESM, r as __exportAll, t as __commonJSMin } from "./_chunks/chunk-BYIpzuS7.js";
-import { n as setViteServer } from "./_chunks/dev-warnings-DpGRGoDi.js";
-import { i as scanRoutes, n as collectInterceptionRewrites, r as generateRouteMap, t as collectLeafRoutes } from "./_chunks/walkers-VOXgavMF.js";
-import { t as formatSize } from "./_chunks/format-CYBGxKtc.js";
+import { n as setViteServer } from "./_chunks/warnings-Cg47l5sk.js";
+import { h as swallow } from "./_chunks/logger-0m8MsKdc.js";
+import { i as scanRoutes, n as collectInterceptionRewrites, r as generateRouteMap, t as collectLeafRoutes } from "./_chunks/walkers-Tg0Alwcg.js";
+import { t as formatSize } from "./_chunks/format-Bcn-Iv1x.js";
 import { dirname, extname, join, normalize, resolve } from "node:path";
 import { createRequire } from "node:module";
 import react, { reactCompilerPreset } from "@vitejs/plugin-react";
@@ -98,7 +99,60 @@ function timberContent(ctx) {
 	};
 }
 //#endregion
-//#region src/plugins/dev-terminal-error.ts
+//#region src/dev-tools/stack-classifier.ts
+/** Parse file/line/col from a stack frame line. */
+function parseFrame(frameLine) {
+	const parenMatch = /\(([^)]+):(\d+):(\d+)\)/.exec(frameLine);
+	if (parenMatch) return {
+		file: parenMatch[1],
+		line: Number(parenMatch[2]),
+		col: Number(parenMatch[3])
+	};
+	const bareMatch = /at (\/[^:]+):(\d+):(\d+)/.exec(frameLine);
+	if (bareMatch) return {
+		file: bareMatch[1],
+		line: Number(bareMatch[2]),
+		col: Number(bareMatch[3])
+	};
+	return {};
+}
+/**
+* Classify a single stack frame line by origin.
+*
+* - 'app': user application code (in project root, not node_modules)
+* - 'framework': timber-app internal code
+* - 'internal': node_modules, Node.js internals
+*/
+function classifyFrame(frameLine, projectRoot) {
+	const trimmed = frameLine.trim();
+	if (trimmed.includes("packages/timber-app/")) return "framework";
+	if (trimmed.includes("node_modules/")) return "internal";
+	if (trimmed.startsWith("at node:") || trimmed.includes("(node:")) return "internal";
+	if (trimmed.includes(projectRoot)) return "app";
+	return "internal";
+}
+/**
+* Classify all frames in a full stack trace string.
+*
+* Parses the stack, skips the first line (error message), filters to
+* lines starting with "at ", and returns classified frames with optional
+* file/line/col metadata.
+*/
+function classifyStack(stack, projectRoot) {
+	return stack.split("\n").slice(1).filter((line) => line.trim().startsWith("at ")).map((raw) => {
+		const type = classifyFrame(raw, projectRoot);
+		const { file, line, col } = parseFrame(raw);
+		return {
+			raw,
+			type,
+			file,
+			line,
+			col
+		};
+	});
+}
+//#endregion
+//#region src/dev-tools/terminal.ts
 /**
 * Terminal error formatting — boxed, color-coded error output for dev mode.
 *
@@ -165,35 +219,6 @@ function box(lines, borderColor, width = 80) {
 	output.push(`${borderColor}${BOX.bottomLeft}${bar}${BOX.bottomRight}${RESET$2}`);
 	return output.join("\n");
 }
-/** Parse file/line/col from a stack frame line. */
-function parseFrame(frameLine) {
-	const parenMatch = /\(([^)]+):(\d+):(\d+)\)/.exec(frameLine);
-	if (parenMatch) return {
-		file: parenMatch[1],
-		line: Number(parenMatch[2]),
-		col: Number(parenMatch[3])
-	};
-	const bareMatch = /at (\/[^:]+):(\d+):(\d+)/.exec(frameLine);
-	if (bareMatch) return {
-		file: bareMatch[1],
-		line: Number(bareMatch[2]),
-		col: Number(bareMatch[3])
-	};
-	return {};
-}
-function classifyFrames(stack, projectRoot) {
-	return stack.split("\n").slice(1).filter((l) => l.trim().startsWith("at ")).map((raw) => {
-		const type = classifyFrame(raw, projectRoot);
-		const { file, line, col } = parseFrame(raw);
-		return {
-			raw,
-			type,
-			file,
-			line,
-			col
-		};
-	});
-}
 /**
 * Format an error for terminal output with a boxed layout.
 *
@@ -208,7 +233,7 @@ function formatTerminalError$1(error, phase, projectRoot) {
 	const sections = [];
 	const componentStack = extractComponentStack(error);
 	const loc = parseFirstAppFrame(error.stack ?? "", projectRoot);
-	const frames = error.stack ? classifyFrames(error.stack, projectRoot) : [];
+	const frames = error.stack ? classifyStack(error.stack, projectRoot) : [];
 	const appFrames = frames.filter((f) => f.type === "app");
 	const internalCount = frames.filter((f) => f.type !== "app").length;
 	const boxLines = [];
@@ -247,7 +272,7 @@ function extractFnName(frameLine) {
 	return match ? match[1] : "";
 }
 //#endregion
-//#region src/plugins/dev-error-overlay.ts
+//#region src/dev-tools/overlay.ts
 var _traceMapping = null;
 /**
 * Lazy-load @jridgewell/trace-mapping from Vite's dependency tree.
@@ -269,21 +294,6 @@ var PHASE_LABELS$1 = {
 	"handler": "Route Handler"
 };
 /**
-* Classify a stack frame line by origin.
-*
-* - 'app': user application code (in project root, not node_modules)
-* - 'framework': timber-app internal code
-* - 'internal': node_modules, Node.js internals
-*/
-function classifyFrame(frameLine, projectRoot) {
-	const trimmed = frameLine.trim();
-	if (trimmed.includes("packages/timber-app/")) return "framework";
-	if (trimmed.includes("node_modules/")) return "internal";
-	if (trimmed.startsWith("at node:") || trimmed.includes("(node:")) return "internal";
-	if (trimmed.includes(projectRoot)) return "app";
-	return "internal";
-}
-/**
 * Extract the React component stack from an error, if present.
 * React attaches this as `componentStack` during renderToReadableStream errors.
 */
@@ -528,7 +538,24 @@ function sendErrorToOverlay(server, error, phase, projectRoot, rscDebugComponent
 	} catch {}
 }
 //#endregion
-//#region src/plugins/dev-error-page.ts
+//#region src/server/utils/escape-html.ts
+/**
+* Shared HTML escaping utility.
+*
+* Used by both dev-only paths (error pages, 404 page) and production
+* paths (deny-renderer, RSC helpers). Lives in server/utils/ because
+* it's not dev-only.
+*/
+/**
+* Escape a string for safe embedding in HTML content or attributes.
+*
+* Replaces `&`, `<`, `>`, and `"` with their HTML entity equivalents.
+*/
+function escapeHtml(str) {
+	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+//#endregion
+//#region src/dev-tools/error-page.ts
 /**
 * Dev error page — self-contained HTML error page for dev server 500s.
 *
@@ -560,12 +587,6 @@ var PHASE_HINTS = {
 	"render": "This error occurred while rendering a server component. Check the component for runtime errors.",
 	"handler": "This error occurred in a route handler (route.ts). Check the handler function."
 };
-function classifyStack(stack, projectRoot) {
-	return stack.split("\n").slice(1).filter((line) => line.trim().startsWith("at ")).map((line) => ({
-		raw: line,
-		type: classifyFrame(line, projectRoot)
-	}));
-}
 /**
 * Try to read a few lines of source code around the error location.
 * Returns null if the file can't be read (e.g., virtual modules).
@@ -588,9 +609,7 @@ function readSourceContext(filePath, line, contextLines = 3) {
 		return null;
 	}
 }
-function esc(str) {
-	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-}
+var esc = escapeHtml;
 /**
 * Escape a JSON string for safe embedding in an HTML `<script>` block.
 *
@@ -12856,7 +12875,8 @@ function checkFile(filePath, extension, fileType, warnings) {
 	let code;
 	try {
 		code = readFileSync(filePath, "utf-8");
-	} catch {
+	} catch (err) {
+		swallow(err, `status-file-lint: unreadable file ${filePath}`);
 		return;
 	}
 	if (!detectFileDirective(code, ["use client"])) warnings.push({
@@ -12988,7 +13008,9 @@ function checkRouteExports(node, warnings) {
 					level: "warn"
 				});
 			}
-		} catch {}
+		} catch (err) {
+			swallow(err, `convention-lint: unreadable route.ts ${filePath}`);
+		}
 	}
 	for (const child of node.children) checkRouteExports(child, warnings);
 	for (const slot of Object.values(node.slots)) checkRouteExports(slot, warnings);
@@ -13046,7 +13068,9 @@ function checkFileDefaultExport(filePath, fileType, warnings) {
 			details: `  File: ${filePath}\n\n  ${fileType}.tsx files must export a default React component.\n  Without a default export, the ${fileType === "page" ? "page renders nothing" : "layout has no component to wrap children"}.\n\n  To fix: Add a default export:\n\n    export default function My${fileType === "page" ? "Page" : "Layout"}(${fileType === "layout" ? "{ children }" : ""}) {\n      return ${fileType === "layout" ? "<div>{children}</div>" : "<h1>Hello</h1>"};\n    }\n`,
 			level: "warn"
 		});
-	} catch {}
+	} catch (err) {
+		swallow(err, `convention-lint: unreadable ${fileType} file ${filePath}`);
+	}
 }
 /**
 * Check if the app/ directory exists. Called before scanning.
@@ -13590,7 +13614,7 @@ export const headers = stub;
 export const cookies = stub;
 export const getHeaders = stub;
 export const getHeader = stub;
-export const getCookies = stub;
+export const getCookieJar = stub;
 export const getCookie = stub;
 export const getSearchParams = stub;
 export const getSegmentParams = stub;
@@ -15214,8 +15238,8 @@ function timberFonts(ctx) {
 */
 var DYNAMIC_API_PATTERNS = [
 	{
-		pattern: /\bgetCookies\s*\(/,
-		name: "getCookies()"
+		pattern: /\bgetCookieJar\s*\(/,
+		name: "getCookieJar()"
 	},
 	{
 		pattern: /\bgetHeaders\s*\(/,
@@ -15592,7 +15616,7 @@ function timberBuildManifest(ctx) {
 	};
 }
 //#endregion
-//#region src/plugins/dev-logs.ts
+//#region src/dev-tools/logs.ts
 var LOG_LEVELS = [
 	"log",
 	"warn",
@@ -15671,7 +15695,7 @@ function extractCallerLocation(projectRoot) {
 	const lines = stack.split("\n");
 	for (let i = 1; i < lines.length; i++) {
 		const line = lines[i].trim();
-		if (line.includes("dev-logs")) continue;
+		if (line.includes("dev-tools/logs")) continue;
 		if (line.includes("node:") || line.includes("node_modules")) continue;
 		const match = line.match(/\((.+?):(\d+):(\d+)\)/) ?? line.match(/at (.+?):(\d+):(\d+)/);
 		if (match) {
@@ -15699,7 +15723,7 @@ function isFrameworkInternalCaller() {
 	const lines = stack.split("\n");
 	for (let i = 1; i < lines.length; i++) {
 		const line = lines[i].trim();
-		if (line.includes("dev-logs")) continue;
+		if (line.includes("dev-tools/logs")) continue;
 		if (line.includes("node:")) continue;
 		if (!(line.includes("timber-app/") || line.includes("@timber-js/app/"))) return false;
 		return line.includes("/plugins/") || line.includes("/adapters/");
@@ -15757,7 +15781,7 @@ function timberDevLogs(_ctx) {
 	};
 }
 //#endregion
-//#region src/plugins/dev-browser-logs.ts
+//#region src/dev-tools/browser-logs.ts
 /** Max message size in bytes before truncation. */
 var MAX_MESSAGE_BYTES = 2048;
 /** HMR event name for browser→server log forwarding. */
@@ -16163,7 +16187,8 @@ async function stripJsFromRscAssetsManifests(buildDir) {
 		let manifest;
 		try {
 			manifest = JSON.parse(jsonStr);
-		} catch {
+		} catch (err) {
+			swallow(err, `corrupted RSC assets manifest: ${path}`, { level: "warn" });
 			continue;
 		}
 		const deps = manifest.clientReferenceDeps;
@@ -16534,7 +16559,7 @@ function validateKeyFormat(key) {
 	}
 }
 //#endregion
-//#region src/server/dev-holding-server.ts
+//#region src/dev-tools/holding-server.ts
 /**
 * Dev holding server — serves a loading page while Vite initializes.
 *