@timber-js/app 0.2.0-alpha.242 → 0.2.0-alpha.244

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (248) hide show
  1. package/dist/_chunks/{actions-BkwgRwCl.js → actions-D_LiN5xG.js} +57 -39
  2. package/dist/_chunks/actions-D_LiN5xG.js.map +1 -0
  3. package/dist/_chunks/als-registry-C-iwbtvI.js.map +1 -1
  4. package/dist/_chunks/{cache-api-BGA7c5qJ.js → cache-api-D3HmgsFh.js} +4 -4
  5. package/dist/_chunks/{cache-api-BGA7c5qJ.js.map → cache-api-D3HmgsFh.js.map} +1 -1
  6. package/dist/_chunks/{chains-Cuwwjv6T.js → chains-BpvDwp08.js} +2 -2
  7. package/dist/_chunks/{chains-Cuwwjv6T.js.map → chains-BpvDwp08.js.map} +1 -1
  8. package/dist/_chunks/chains-CjlZZ5ad.js +1 -0
  9. package/dist/_chunks/{classify-Y8S9C0Na.js → classify-Bbb_lKjH.js} +2 -2
  10. package/dist/_chunks/{classify-Y8S9C0Na.js.map → classify-Bbb_lKjH.js.map} +1 -1
  11. package/dist/_chunks/{cli-check-KeE1QaIx.js → cli-check-BE9BnXwi.js} +6 -6
  12. package/dist/_chunks/cli-check-BE9BnXwi.js.map +1 -0
  13. package/dist/_chunks/{cli-schema-sync-DZEF31wd.js → cli-schema-sync-CWkGFlYu.js} +2 -2
  14. package/dist/_chunks/{cli-schema-sync-DZEF31wd.js.map → cli-schema-sync-CWkGFlYu.js.map} +1 -1
  15. package/dist/_chunks/{cli-schema-sync-_y5O6MIg.js → cli-schema-sync-Dyvdkv_I.js} +1 -1
  16. package/dist/_chunks/{client-dep-entries-DpiwvoDi.js → client-dep-entries-Dka67elj.js} +2 -2
  17. package/dist/_chunks/{client-dep-entries-DpiwvoDi.js.map → client-dep-entries-Dka67elj.js.map} +1 -1
  18. package/dist/_chunks/{convention-lint-0AEsPK2T.js → convention-lint-DkSDlsPH.js} +38 -10
  19. package/dist/_chunks/convention-lint-DkSDlsPH.js.map +1 -0
  20. package/dist/_chunks/{dev-server-DYDr8KIc.js → dev-server-BZxFJNih.js} +68 -11
  21. package/dist/_chunks/{dev-server-DYDr8KIc.js.map → dev-server-BZxFJNih.js.map} +1 -1
  22. package/dist/_chunks/dev-server-C72bB9Kg.js +1 -0
  23. package/dist/_chunks/error-boundary-wuNvAJ4n.js.map +1 -1
  24. package/dist/_chunks/{flight-source-node-KQsX_OhS.js → flight-source-node-BeF00Wo_.js} +2 -2
  25. package/dist/_chunks/{flight-source-node-KQsX_OhS.js.map → flight-source-node-BeF00Wo_.js.map} +1 -1
  26. package/dist/_chunks/{interception-CtNt9jPt.js → interception-D1dCGNmQ.js} +6 -6
  27. package/dist/_chunks/{interception-CtNt9jPt.js.map → interception-D1dCGNmQ.js.map} +1 -1
  28. package/dist/_chunks/{json-lossy-check-BVDALqMf.js → json-lossy-check-DpXneTBm.js} +2 -2
  29. package/dist/_chunks/{json-lossy-check-BVDALqMf.js.map → json-lossy-check-DpXneTBm.js.map} +1 -1
  30. package/dist/_chunks/{key-headers-uIig1_mU.js → key-headers-CVpa6fpW.js} +6 -2
  31. package/dist/_chunks/key-headers-CVpa6fpW.js.map +1 -0
  32. package/dist/_chunks/{live-graph-VhzO7Ol9.js → live-graph-DXhz6A_X.js} +4 -4
  33. package/dist/_chunks/{live-graph-VhzO7Ol9.js.map → live-graph-DXhz6A_X.js.map} +1 -1
  34. package/dist/_chunks/{logger-C4m8rfMy.js → logger-D1sWX2I0.js} +17 -2
  35. package/dist/_chunks/logger-D1sWX2I0.js.map +1 -0
  36. package/dist/_chunks/{node-response-8Vz29cGS.js → node-response-Cp62CtH1.js} +2 -2
  37. package/dist/_chunks/{node-response-8Vz29cGS.js.map → node-response-Cp62CtH1.js.map} +1 -1
  38. package/dist/_chunks/{poison-scan-Dpl3ibG-.js → poison-scan-DdkJoHvP.js} +2 -2
  39. package/dist/_chunks/{poison-scan-Dpl3ibG-.js.map → poison-scan-DdkJoHvP.js.map} +1 -1
  40. package/dist/_chunks/{scanner-CCEHN9Jg.js → scanner-B6V2RqqF.js} +20 -3
  41. package/dist/_chunks/scanner-B6V2RqqF.js.map +1 -0
  42. package/dist/_chunks/{sizeof-CIF7fwSJ.js → sizeof-BKA6qOZq.js} +2 -2
  43. package/dist/_chunks/{sizeof-CIF7fwSJ.js.map → sizeof-BKA6qOZq.js.map} +1 -1
  44. package/dist/_chunks/{walkers-BbotBhNG.js → walkers-BAZoAlfI.js} +3 -3
  45. package/dist/_chunks/{walkers-BbotBhNG.js.map → walkers-BAZoAlfI.js.map} +1 -1
  46. package/dist/adapters/cloudflare-kv-cache.js +1 -1
  47. package/dist/analyze/crawl-entry.js +3 -3
  48. package/dist/analyze/graph-command.js +2 -2
  49. package/dist/cache/index.js +2 -2
  50. package/dist/cache/stores/memory.js +1 -1
  51. package/dist/cli-check.d.ts +3 -3
  52. package/dist/cli-check.d.ts.map +1 -1
  53. package/dist/cli.js +3 -3
  54. package/dist/client/document-withdrawal.d.ts +2 -0
  55. package/dist/client/document-withdrawal.d.ts.map +1 -0
  56. package/dist/client/outlet-content-cache.d.ts +13 -1
  57. package/dist/client/outlet-content-cache.d.ts.map +1 -1
  58. package/dist/client/outlet-scope-context.d.ts +5 -0
  59. package/dist/client/outlet-scope-context.d.ts.map +1 -1
  60. package/dist/client/segment-outlet.d.ts.map +1 -1
  61. package/dist/config-types.d.ts +43 -21
  62. package/dist/config-types.d.ts.map +1 -1
  63. package/dist/config-validation.d.ts.map +1 -1
  64. package/dist/index.d.ts +1 -1
  65. package/dist/index.d.ts.map +1 -1
  66. package/dist/index.js +9 -9
  67. package/dist/index.js.map +1 -1
  68. package/dist/native/rsc/manifest.json +2 -0
  69. package/dist/native/rsc/server/als-registry.js.map +1 -1
  70. package/dist/native/rsc/server/cookie-context.js +7 -7
  71. package/dist/native/rsc/server/cookie-context.js.map +1 -1
  72. package/dist/native/rsc/server/deny-boundary.js +2 -1
  73. package/dist/native/rsc/server/deny-boundary.js.map +1 -1
  74. package/dist/native/rsc/server/dev-overlay-report.js +13 -0
  75. package/dist/native/rsc/server/dev-overlay-report.js.map +1 -0
  76. package/dist/native/rsc/server/logger.js +6 -1
  77. package/dist/native/rsc/server/logger.js.map +1 -1
  78. package/dist/native/rsc/server/pipeline-interception.js +4 -1
  79. package/dist/native/rsc/server/pipeline-interception.js.map +1 -1
  80. package/dist/native/rsc/server/pipeline.js.map +1 -1
  81. package/dist/native/rsc/server/request-context.js +4 -4
  82. package/dist/native/rsc/server/request-context.js.map +1 -1
  83. package/dist/native/rsc/server/route-element-builder.js +1 -1
  84. package/dist/native/rsc/server/route-element-builder.js.map +1 -1
  85. package/dist/native/rsc/server/route-module-loader.js +5 -4
  86. package/dist/native/rsc/server/route-module-loader.js.map +1 -1
  87. package/dist/native/rsc/server/rsc-entry/render-route.js +1 -1
  88. package/dist/native/rsc/server/rsc-entry/render-route.js.map +1 -1
  89. package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js +1 -1
  90. package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js.map +1 -1
  91. package/dist/native/rsc/server/segment-lifetime/outlet-gate.js +2 -1
  92. package/dist/native/rsc/server/segment-lifetime/outlet-gate.js.map +1 -1
  93. package/dist/native/rsc/server/segment-lifetime/read-rule.js +31 -20
  94. package/dist/native/rsc/server/segment-lifetime/read-rule.js.map +1 -1
  95. package/dist/native/rsc/server/segment-lifetime/read-scope.js +48 -7
  96. package/dist/native/rsc/server/segment-lifetime/read-scope.js.map +1 -1
  97. package/dist/native/rsc/server/segment-lifetime/segment-key.js +13 -8
  98. package/dist/native/rsc/server/segment-lifetime/segment-key.js.map +1 -1
  99. package/dist/native/rsc/server/segment-lifetime/slot-outlets.js +5 -4
  100. package/dist/native/rsc/server/segment-lifetime/slot-outlets.js.map +1 -1
  101. package/dist/native/rsc/server/slot-resolver.js +5 -4
  102. package/dist/native/rsc/server/slot-resolver.js.map +1 -1
  103. package/dist/native/rsc/server/slot-subtree-contain.js +2 -1
  104. package/dist/native/rsc/server/slot-subtree-contain.js.map +1 -1
  105. package/dist/native/rsc/server/subtree-walk.js +14 -5
  106. package/dist/native/rsc/server/subtree-walk.js.map +1 -1
  107. package/dist/native/rsc/server/vite-handoff-rsc.js.map +1 -1
  108. package/dist/native/rsc/shared/key-headers.js +4 -1
  109. package/dist/native/rsc/shared/key-headers.js.map +1 -1
  110. package/dist/native/rsc/shared/layout-defaults.js +19 -0
  111. package/dist/native/rsc/shared/layout-defaults.js.map +1 -0
  112. package/dist/native/ssr/client/document-withdrawal.js +17 -0
  113. package/dist/native/ssr/client/document-withdrawal.js.map +1 -0
  114. package/dist/native/ssr/client/outlet-content-cache.js +6 -1
  115. package/dist/native/ssr/client/outlet-content-cache.js.map +1 -1
  116. package/dist/native/ssr/client/outlet-scope-context.js.map +1 -1
  117. package/dist/native/ssr/client/segment-outlet.js +11 -2
  118. package/dist/native/ssr/client/segment-outlet.js.map +1 -1
  119. package/dist/native/ssr/manifest.json +6 -0
  120. package/dist/native/ssr/server/als-registry.js.map +1 -1
  121. package/dist/native/ssr/server/cookie-context.js +7 -7
  122. package/dist/native/ssr/server/cookie-context.js.map +1 -1
  123. package/dist/native/ssr/server/deny-boundary.js +2 -1
  124. package/dist/native/ssr/server/deny-boundary.js.map +1 -1
  125. package/dist/native/ssr/server/dev-overlay-report.js +6 -0
  126. package/dist/native/ssr/server/dev-overlay-report.js.map +1 -0
  127. package/dist/native/ssr/server/logger.js +6 -1
  128. package/dist/native/ssr/server/logger.js.map +1 -1
  129. package/dist/native/ssr/server/pipeline-interception.js +4 -1
  130. package/dist/native/ssr/server/pipeline-interception.js.map +1 -1
  131. package/dist/native/ssr/server/pipeline.js.map +1 -1
  132. package/dist/native/ssr/server/request-context.js +4 -4
  133. package/dist/native/ssr/server/request-context.js.map +1 -1
  134. package/dist/native/ssr/server/segment-lifetime/outlet-gate.js +12 -0
  135. package/dist/native/ssr/server/segment-lifetime/outlet-gate.js.map +1 -0
  136. package/dist/native/ssr/server/segment-lifetime/read-rule.js +31 -20
  137. package/dist/native/ssr/server/segment-lifetime/read-rule.js.map +1 -1
  138. package/dist/native/ssr/server/segment-lifetime/read-scope.js +16 -0
  139. package/dist/native/ssr/server/segment-lifetime/read-scope.js.map +1 -0
  140. package/dist/native/ssr/server/subtree-walk.js +149 -0
  141. package/dist/native/ssr/server/subtree-walk.js.map +1 -0
  142. package/dist/native/ssr/server/utils/element-type.js +21 -9
  143. package/dist/native/ssr/server/utils/element-type.js.map +1 -1
  144. package/dist/native/ssr/server/vite-handoff-rsc.js.map +1 -1
  145. package/dist/native/ssr/shared/key-headers.js +4 -1
  146. package/dist/native/ssr/shared/key-headers.js.map +1 -1
  147. package/dist/native/ssr/shared/layout-defaults.js +9 -0
  148. package/dist/native/ssr/shared/layout-defaults.js.map +1 -0
  149. package/dist/plugins/entries.d.ts.map +1 -1
  150. package/dist/routing/convention-lint.d.ts +2 -2
  151. package/dist/routing/convention-lint.d.ts.map +1 -1
  152. package/dist/routing/index.js +3 -3
  153. package/dist/routing/route-options-lint.d.ts +2 -2
  154. package/dist/routing/route-options-lint.d.ts.map +1 -1
  155. package/dist/routing/slot-placement.d.ts +23 -4
  156. package/dist/routing/slot-placement.d.ts.map +1 -1
  157. package/dist/server/als-registry.d.ts +18 -0
  158. package/dist/server/als-registry.d.ts.map +1 -1
  159. package/dist/server/deny-boundary.d.ts.map +1 -1
  160. package/dist/server/dev-overlay-report.d.ts +13 -0
  161. package/dist/server/dev-overlay-report.d.ts.map +1 -0
  162. package/dist/server/index.js +2 -2
  163. package/dist/server/internal.js +97 -8
  164. package/dist/server/internal.js.map +1 -1
  165. package/dist/server/logger.d.ts +10 -0
  166. package/dist/server/logger.d.ts.map +1 -1
  167. package/dist/server/pipeline-interception.d.ts.map +1 -1
  168. package/dist/server/pipeline.d.ts +13 -1
  169. package/dist/server/pipeline.d.ts.map +1 -1
  170. package/dist/server/route-module-loader.d.ts +4 -3
  171. package/dist/server/route-module-loader.d.ts.map +1 -1
  172. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  173. package/dist/server/rsc-entry/render-route.d.ts +3 -3
  174. package/dist/server/rsc-entry/render-route.d.ts.map +1 -1
  175. package/dist/server/rsc-entry/revalidate-renderer.d.ts +3 -3
  176. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -1
  177. package/dist/server/segment-lifetime/outlet-gate.d.ts +5 -5
  178. package/dist/server/segment-lifetime/outlet-gate.d.ts.map +1 -1
  179. package/dist/server/segment-lifetime/read-rule.d.ts +14 -18
  180. package/dist/server/segment-lifetime/read-rule.d.ts.map +1 -1
  181. package/dist/server/segment-lifetime/read-scope.d.ts +47 -6
  182. package/dist/server/segment-lifetime/read-scope.d.ts.map +1 -1
  183. package/dist/server/segment-lifetime/segment-key.d.ts +21 -18
  184. package/dist/server/segment-lifetime/segment-key.d.ts.map +1 -1
  185. package/dist/server/segment-lifetime/slot-outlets.d.ts +3 -4
  186. package/dist/server/segment-lifetime/slot-outlets.d.ts.map +1 -1
  187. package/dist/server/slot-resolver.d.ts.map +1 -1
  188. package/dist/server/slot-subtree-contain.d.ts.map +1 -1
  189. package/dist/server/subtree-walk.d.ts +17 -3
  190. package/dist/server/subtree-walk.d.ts.map +1 -1
  191. package/dist/server/types.d.ts +4 -3
  192. package/dist/server/types.d.ts.map +1 -1
  193. package/dist/server/vite-handoff-rsc.d.ts +2 -0
  194. package/dist/server/vite-handoff-rsc.d.ts.map +1 -1
  195. package/dist/shared/key-headers.d.ts +2 -0
  196. package/dist/shared/key-headers.d.ts.map +1 -1
  197. package/dist/shared/layout-defaults.d.ts +30 -0
  198. package/dist/shared/layout-defaults.d.ts.map +1 -0
  199. package/docs/api/30-api-server.mdx +1 -1
  200. package/docs/api/34-api-config.mdx +20 -3
  201. package/package.json +1 -1
  202. package/src/cli-check.ts +6 -6
  203. package/src/client/document-withdrawal.tsx +41 -0
  204. package/src/client/outlet-content-cache.ts +18 -2
  205. package/src/client/outlet-scope-context.ts +5 -0
  206. package/src/client/segment-outlet.tsx +9 -3
  207. package/src/config-types.ts +44 -21
  208. package/src/config-validation.ts +96 -20
  209. package/src/index.ts +1 -1
  210. package/src/plugins/entries.ts +6 -3
  211. package/src/plugins/routing.ts +1 -1
  212. package/src/routing/convention-lint.ts +5 -3
  213. package/src/routing/interception.ts +5 -5
  214. package/src/routing/route-options-lint.ts +6 -6
  215. package/src/routing/slot-placement.ts +41 -4
  216. package/src/server/als-registry.ts +14 -0
  217. package/src/server/cookie-context.ts +7 -7
  218. package/src/server/deny-boundary.ts +4 -1
  219. package/src/server/dev-overlay-report.ts +22 -0
  220. package/src/server/logger.ts +13 -0
  221. package/src/server/pipeline-interception.ts +11 -2
  222. package/src/server/pipeline.ts +13 -1
  223. package/src/server/request-context.ts +6 -6
  224. package/src/server/route-element-builder.ts +3 -3
  225. package/src/server/route-module-loader.ts +7 -6
  226. package/src/server/rsc-entry/index.ts +14 -8
  227. package/src/server/rsc-entry/render-route.ts +4 -4
  228. package/src/server/rsc-entry/revalidate-renderer.ts +4 -4
  229. package/src/server/segment-lifetime/outlet-gate.ts +6 -6
  230. package/src/server/segment-lifetime/read-rule.ts +67 -33
  231. package/src/server/segment-lifetime/read-scope.ts +128 -14
  232. package/src/server/segment-lifetime/segment-key.ts +32 -24
  233. package/src/server/segment-lifetime/slot-outlets.ts +8 -12
  234. package/src/server/slot-resolver.ts +22 -10
  235. package/src/server/slot-subtree-contain.ts +2 -1
  236. package/src/server/subtree-walk.ts +34 -9
  237. package/src/server/types.ts +4 -3
  238. package/src/server/vite-handoff-rsc.ts +2 -0
  239. package/src/shared/key-headers.ts +5 -0
  240. package/src/shared/layout-defaults.ts +43 -0
  241. package/dist/_chunks/actions-BkwgRwCl.js.map +0 -1
  242. package/dist/_chunks/chains-LGjBHfSN.js +0 -1
  243. package/dist/_chunks/cli-check-KeE1QaIx.js.map +0 -1
  244. package/dist/_chunks/convention-lint-0AEsPK2T.js.map +0 -1
  245. package/dist/_chunks/dev-server-CboXr8zX.js +0 -1
  246. package/dist/_chunks/key-headers-uIig1_mU.js.map +0 -1
  247. package/dist/_chunks/logger-C4m8rfMy.js.map +0 -1
  248. package/dist/_chunks/scanner-CCEHN9Jg.js.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"file":"convention-lint-0AEsPK2T.js","names":[],"sources":["../../src/routing/segment-codegen.ts","../../src/routing/codegen-write.ts","../../src/shared/route-options-export.ts","../../src/routing/route-options.ts","../../src/routing/route-options-lint.ts","../../src/routing/convention-lint.ts"],"sourcesContent":["/**\n * $segment type generation and directory-to-route mapping.\n *\n * Generates per-route $segment.d.ts files in .timber/types/ that mirror\n * the app/ directory structure. TypeScript's rootDirs feature makes these\n * importable as './$segment' from route files.\n *\n * Design doc: design/41-global-params.md §The $segment Module\n */\n\nimport { mkdir } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { writeFileAtomic } from '../utils/write-file-atomic.ts';\nimport type { RouteTree, SegmentNode } from './types.ts';\n\n/** Info carried per directory for type generation. */\nexport interface SegmentInfo {\n /** The URL route pattern (groups and slots stripped). e.g. '/[artistSlug]/[year]' */\n route: string;\n /** The full tree path including groups and slots — uniquely identifies a segment.\n * e.g. '/(browse)/[artistSlug]/@shows/[year]' */\n segmentPath: string;\n}\n\n/**\n * Build a map of absolute filesystem directory → segment info.\n * Used by resolveId to map a $segment import's importer to the correct route,\n * and by writeSegmentTypes to generate per-route $segment.d.ts files.\n *\n * Walks every segment (not just leaves) so layouts and middleware\n * at any depth can import $segment.\n */\nexport function buildDirToRouteMap(tree: RouteTree, appDir: string): Map<string, SegmentInfo> {\n const map = new Map<string, SegmentInfo>();\n\n function walk(node: SegmentNode, fsPath: string, treePath: string): void {\n map.set(fsPath, {\n route: node.urlPath || '/',\n segmentPath: treePath || '/',\n });\n\n for (const child of node.children) {\n const childDir = join(fsPath, child.segmentName);\n const childTreePath = `${treePath}/${child.segmentName}`;\n walk(child, childDir, childTreePath);\n }\n for (const [slotName, slotNode] of Object.entries(node.slots)) {\n const slotDir = join(fsPath, `@${slotName}`);\n const slotTreePath = `${treePath}/@${slotName}`;\n walk(slotNode, slotDir, slotTreePath);\n }\n }\n\n walk(tree.root, appDir, '');\n return map;\n}\n\n/**\n * Generate the full $segment.d.ts content for a segment.\n */\nexport function generateSegmentDts(info: SegmentInfo): string {\n return [\n `export const ROUTE: '${info.route}';`,\n `export const SEGMENT_PATH: '${info.segmentPath}';`,\n '',\n ].join('\\n');\n}\n\n/**\n * Generate per-route $segment.d.ts files in .timber/types/ mirroring\n * the app/ directory structure. These files are importable via TypeScript's\n * rootDirs feature.\n */\nexport async function writeSegmentTypes(\n routeTree: RouteTree,\n appDir: string,\n root: string\n): Promise<void> {\n // Compute the relative prefix from project root to appDir.\n // e.g. if appDir is /project/src/app, relative is 'src/app'\n const relative = appDir.slice(root.length + 1);\n const typesBase = join(root, '.timber', 'types', relative);\n const map = buildDirToRouteMap(routeTree, appDir);\n\n const writes: Promise<void>[] = [];\n for (const [fsDir, info] of map) {\n // Mirror the app/ structure under .timber/types/\n const relDir = fsDir.slice(appDir.length); // e.g. '/[artistSlug]/[year]'\n const segmentDir = join(typesBase, relDir);\n const segmentFile = join(segmentDir, '$segment.d.ts');\n const content = generateSegmentDts(info);\n\n writes.push(\n mkdir(segmentDir, { recursive: true }).then(() => writeFileAtomic(segmentFile, content))\n );\n }\n\n await Promise.all(writes);\n}\n","/**\n * Route-map codegen writer.\n *\n * Materializes the generated route types on disk: `.timber/timber-routes.d.ts`,\n * `.timber/segment-types.d.ts` (via `writeSegmentTypes`), and the root\n * `timber-env.d.ts` that references them.\n *\n * Lives outside `plugins/routing.ts` because it has two callers with two\n * different failure policies: the dev/build plugin starts the write off the hot\n * path and logs failures, while `timber check` awaits it and treats a failure as\n * fatal — a type check run against absent or stale route types reports errors\n * about code that is fine. One implementation, two policies, so the bytes on\n * disk cannot drift between the two commands.\n *\n * Design docs: 09-typescript.md §\"Typed Routes\", 18-build-system.md\n */\n\nimport { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { generateRouteMap } from './codegen.ts';\nimport { writeSegmentTypes } from './segment-codegen.ts';\nimport { writeFileAtomic } from '../utils/write-file-atomic.ts';\nimport type { RouteTree } from './types.ts';\n\n/**\n * Path (relative to the project root) of the generated route map declaration\n * file, and the name of the root file that `/// <reference>`s it.\n *\n * Exported because `timber check` has to answer whether the user's tsconfig\n * pulls these into the program — a question about these exact paths. It derives\n * them from here rather than restating them, so a rename cannot leave the check\n * looking for a file nothing writes.\n */\nexport const CODEGEN_OUTPUT = '.timber/timber-routes.d.ts';\n\n/** Root-level file that references the generated declarations. */\nexport const ENV_DTS_FILENAME = 'timber-env.d.ts';\n\n/**\n * Content of the timber-env.d.ts file written to the project root.\n *\n * Uses a triple-slash reference so TypeScript auto-discovers the generated\n * route map without the user needing to edit tsconfig.json — same pattern\n * as Next.js's next-env.d.ts.\n *\n * Also references `vite/client` so side-effect imports like\n * `import './globals.css'` type-check without ts(2882), and so\n * `import.meta.env`, `import.meta.hot`, `import.meta.glob`, asset\n * imports (`*.png`, `*.svg`, …), CSS modules, and `?url`/`?raw`/\n * `?inline` query variants all resolve without the user editing\n * tsconfig.json themselves. Next.js's next-env.d.ts plays the same\n * role via `next/types/global`.\n *\n * `vite` is a peer dep of `@timber-js/app`, so the reference always\n * resolves in a correctly-installed project.\n */\nconst TIMBER_ENV_DTS = [\n '// This file is auto-generated by timber.js. Do not edit.',\n '// It ensures TypeScript picks up the generated route types and',\n '// Vite-provided ambient types (CSS, assets, import.meta.env, HMR).',\n '/* eslint-disable @typescript-eslint/triple-slash-reference */',\n '/// <reference path=\".timber/timber-routes.d.ts\" />',\n '/// <reference types=\"vite/client\" />',\n '/// <reference types=\"react/canary\" />',\n '/// <reference types=\"react-dom/canary\" />',\n '',\n].join('\\n');\n\n/**\n * Codegen writes that have been started but have not yet landed on disk.\n *\n * `writeRouteCodegen` is deliberately unawaited on the dev/build hot path,\n * which leaves that caller no way to know the files exist yet. Anything that\n * tears down the project root — a build process exiting, a test removing its\n * temp root — then races the writes: `rmSync` empties a directory that a\n * pending `mkdir` immediately recreates, and the removal fails with ENOTEMPTY.\n *\n * Every started write registers here and deregisters when it settles, so\n * `flushCodegenWrites()` can await them instead of guessing at a delay.\n */\nconst pendingCodegenWrites = new Set<Promise<void>>();\n\n/**\n * Resolve once every codegen write started so far has landed on disk.\n *\n * Safe to call at any time and from anywhere — writes are tracked per process,\n * not per plugin instance, so a caller does not need a handle on the plugin\n * that started them. Never rejects: the tracked copy of each write has its\n * rejection swallowed, so a failing write cannot turn a teardown barrier into\n * an unhandled rejection. Callers that care about failure await the promise\n * `writeRouteCodegen` returned instead.\n */\nexport async function flushCodegenWrites(): Promise<void> {\n // Loop rather than a single Promise.all: a write started while we were\n // awaiting would otherwise be missed, and the set would still be non-empty\n // on return.\n //\n // Each round drops what it awaited rather than trusting the per-write\n // `finally` to have run, so the two removal paths are independent — a\n // deregistration that stopped firing would leak memory in dev, but it can\n // never turn this into a spin.\n while (pendingCodegenWrites.size > 0) {\n const inFlight = [...pendingCodegenWrites];\n await Promise.all(inFlight);\n for (const write of inFlight) pendingCodegenWrites.delete(write);\n }\n}\n\n/**\n * Write the generated route map, segment types, and the timber-env.d.ts\n * reference file for `tree`.\n *\n * Returns a promise that **rejects** if any write fails. The dev/build plugin\n * does not await it (types are a developer convenience there, not a runtime\n * dependency) and logs instead; `timber check` awaits it and fails the command.\n * Either way the write is registered with `flushCodegenWrites()`.\n */\n/**\n * Write `timber-env.d.ts` only when its content differs.\n *\n * Its content is constant per timber version, so almost every call is a no-op\n * — and a file that is not rewritten cannot be read half-written. It is not\n * replaced atomically because it lives in the user's project root, often\n * committed: a rename would turn a symlink into a regular file, reset its\n * permissions, and a process killed mid-write would leave a temp file next to\n * their source. The in-place write happens only on first run or a timber\n * upgrade.\n */\nasync function writeEnvDts(envPath: string): Promise<void> {\n const existing = await readFile(envPath, 'utf-8').catch(() => null);\n if (existing !== TIMBER_ENV_DTS) await writeFile(envPath, TIMBER_ENV_DTS, 'utf-8');\n}\n\nexport function writeRouteCodegen(tree: RouteTree, appDir: string, root: string): Promise<void> {\n const timberDir = join(root, '.timber');\n const content = generateRouteMap(tree, { appDir, outputDir: timberDir });\n const routesPath = join(root, CODEGEN_OUTPUT);\n const envPath = join(root, ENV_DTS_FILENAME);\n\n const done = mkdir(timberDir, { recursive: true })\n .then(() =>\n // The type checker can read these while they are being rewritten — an\n // editor's TS server during `timber dev`, a `tsgo` run during `vite\n // build`. A truncating write shows it an empty route map for the length\n // of the write, and every typed route degrades to `any` (TIM-1562).\n // The generated files under `.timber/` are replaced atomically.\n Promise.all([\n writeFileAtomic(routesPath, content),\n writeEnvDts(envPath),\n writeSegmentTypes(tree, appDir, root),\n ])\n )\n .then(() => undefined);\n\n // The tracked copy swallows rejection so `flushCodegenWrites` — a teardown\n // barrier — never rejects and never leaves an unhandled rejection behind.\n // The returned promise keeps its rejection for callers that want it.\n const tracked = done.catch(() => undefined);\n pendingCodegenWrites.add(tracked);\n void tracked.finally(() => pendingCodegenWrites.delete(tracked));\n\n return done;\n}\n","/**\n * The export a layout or page declares its options under (design/53\n * §\"Route-module options\"). One table for both readers: the build-time source\n * reader (`routing/route-options.ts`) and the runtime module loader\n * (`server/route-module-loader.ts`), which cannot import the source reader\n * because it pulls in `node:fs` and Vite's parser.\n */\n\nexport type RouteOptionsKind = 'layout' | 'page';\n\nexport const ROUTE_OPTIONS_EXPORT = {\n layout: 'layoutOptions',\n page: 'pageOptions',\n} as const satisfies Record<RouteOptionsKind, string>;\n","/**\n * Route-module options: `export const layoutOptions = { … }` in a layout and\n * `export const pageOptions = { … }` in a page, read from source.\n *\n * Design doc: design/53-segment-lifetime.md §\"Route-module options\".\n *\n * `prerender` is read here at build time, before any route module loads:\n * `plugins/prerender-sugar.ts` decides from it which pages to wrap in\n * `cache.component(...)`. Every other option is validated here and read at\n * runtime from the loaded module (`deferSuspenseFor`, in\n * `server/route-module-loader.ts`; `lifetime` and `key`, in\n * `server/segment-lifetime/segment-key.ts`). A key's `searchParams` and\n * `cookies` name definitions, so they are the one place a non-literal value is\n * accepted; `segmentParams` is checked against the segment's path by\n * `routing/route-options-lint.ts`. The whole object follows one rule so that\n * every key is checkable: this reader accepts one spelling —\n * `export const xOptions = { … }` of literal values, optionally behind\n * `satisfies` / `as` — and reports the others it can see as problems.\n * `routing/convention-lint.ts` turns problems into build errors:\n *\n * - a spread, a computed key, a getter or method, or a non-literal value\n * - an unknown key (a misspelled `prerendr`)\n * - `pageOptions` in a layout or `layoutOptions` in a page\n * - options in a `'use client'` file, whose exports the server never sees\n * - the removed floating exports, `export const prerender` and\n * `export const deferSuspenseFor`\n * - `let`, a destructured binding, a specifier or a named re-export\n * (`export { pageOptions } from`, `export * as pageOptions from`)\n *\n * What it cannot see is not reported: `export * from` is not followed, a\n * file that does not parse reads as having no options (the compiler reports\n * it), and MDX pages are not read at all, so `prerender` in an MDX page does\n * nothing and its `deferSuspenseFor` is unvalidated.\n */\n\nimport { headerKeyProblem } from '../shared/key-headers.ts';\nimport { existsSync } from 'node:fs';\nimport type {\n LayoutOptions,\n PageOptions,\n RoutePrerender,\n SegmentKey,\n SegmentLifetime,\n} from '../server/types.ts';\nimport { patternBinds, TRANSPARENT_WRAPPERS, tryParse } from './export-detect.ts';\nimport { readFileCached } from './file-cache.ts';\nimport { ROUTE_OPTIONS_EXPORT, type RouteOptionsKind } from '../shared/route-options-export.ts';\n\nconst OPTIONS_TYPE = { layout: 'LayoutOptions', page: 'PageOptions' } as const;\n\n/** Floating exports the options objects replaced (design/53). */\nconst REMOVED_EXPORTS = ['prerender', 'deferSuspenseFor'] as const;\n\nexport interface RouteOptionsRead {\n /**\n * The declared options. Undefined when the file declares none or when any\n * problem was found — a half-read object is never acted on.\n */\n options: LayoutOptions | PageOptions | undefined;\n /** One line per problem, each naming what to write instead. */\n problems: string[];\n}\n\n// ─── AST access ────────────────────────────────────────────────────────────\n\n/** An ESTree node as oxc's `parseAst` produces it, read field by field. */\ntype Node = { readonly type: string; readonly [field: string]: unknown };\n\nfunction isNode(value: unknown): value is Node {\n return (\n typeof value === 'object' && value !== null && 'type' in value && typeof value.type === 'string'\n );\n}\n\nfunction child(node: Node, field: string): Node | undefined {\n const value = node[field];\n return isNode(value) ? value : undefined;\n}\n\nfunction list(node: Node, field: string): unknown[] {\n const value = node[field];\n return Array.isArray(value) ? value : [];\n}\n\n/** Strip `satisfies T`, `as T`, `(x)` and friends, which compile away. */\nfunction unwrap(node: Node): Node {\n let current = node;\n while (TRANSPARENT_WRAPPERS.has(current.type)) {\n const inner = child(current, 'expression');\n if (!inner) break;\n current = inner;\n }\n return current;\n}\n\n/** An identifier's name or a string literal's value (`export { x as \"y\" }`). */\nfunction nameOf(node: Node | undefined): string | undefined {\n if (!node) return undefined;\n if (typeof node.value === 'string') return node.value;\n return typeof node.name === 'string' ? node.name : undefined;\n}\n\n/** A literal's value; a template literal with no `${}` counts as a string. */\nfunction literal(node: Node): unknown {\n const n = unwrap(node);\n if (n.type === 'Literal') return n.value;\n if (n.type !== 'TemplateLiteral' || list(n, 'expressions').length > 0) return undefined;\n const [quasi] = list(n, 'quasis');\n // A TemplateElement's `value` is `{ raw, cooked }`, not a node.\n const parts = isNode(quasi) ? quasi.value : undefined;\n const value =\n typeof parts === 'object' && parts !== null && 'cooked' in parts ? parts.cooked : undefined;\n return typeof value === 'string' ? value : undefined;\n}\n\n/** `key: undefined` — the same as leaving the key out, as the types allow. */\nfunction isUndefined(node: Node): boolean {\n const n = unwrap(node);\n return n.type === 'Identifier' && n.name === 'undefined';\n}\n\n// ─── Value readers, one per option ────────────────────────────────────────\n\ntype Read<T> = { value: T } | { problem: string };\n\n/** A numeric literal is never negative (`-1` is a unary expression), so finite is enough. */\nfunction readNonNegativeNumber(node: Node, label: string): Read<number> {\n const value = literal(node);\n if (typeof value === 'number' && Number.isFinite(value)) return { value };\n return { problem: `${label} must be a non-negative number literal.` };\n}\n\nfunction readPrerender(node: Node): Read<RoutePrerender> {\n const value = literal(node);\n if (typeof value === 'boolean') return { value };\n const n = unwrap(node);\n if (n.type !== 'ObjectExpression') {\n return {\n problem: 'prerender must be `true`, `false`, or an object literal `{ ttl?, tags? }`.',\n };\n }\n const result: { ttl?: number; tags?: string[] } = {};\n for (const entry of readProperties(n, 'prerender')) {\n if ('problem' in entry) return entry;\n if (entry.key === 'ttl') {\n const ttl = readNonNegativeNumber(entry.value, 'prerender.ttl');\n if ('problem' in ttl) return ttl;\n result.ttl = ttl.value;\n } else if (entry.key === 'tags') {\n const tags = readStringArray(entry.value);\n if (!tags) return { problem: 'prerender.tags must be an array of string literals.' };\n result.tags = tags;\n } else {\n return { problem: `Unknown key \"${entry.key}\" in prerender. Allowed: ttl, tags.` };\n }\n }\n return { value: result };\n}\n\nfunction readStringArray(node: Node): string[] | undefined {\n const n = unwrap(node);\n if (n.type !== 'ArrayExpression') return undefined;\n const result: string[] = [];\n for (const element of list(n, 'elements')) {\n const value = isNode(element) ? literal(element) : undefined;\n if (typeof value !== 'string') return undefined;\n result.push(value);\n }\n return result;\n}\n\n/**\n * One reader per option key. Typed against the public option types, so an\n * option added to `PageOptions` / `LayoutOptions` without a reader here (or a\n * reader without the option) fails typecheck — the two lists cannot drift.\n */\ntype Readers<T> = {\n [K in keyof Required<T>]: (\n node: Node\n ) => Read<NonNullable<T[K]> extends SegmentKey ? BuildTimeKey : NonNullable<T[K]>>;\n};\n\nconst deferSuspenseFor = (node: Node) => readNonNegativeNumber(node, 'deferSuspenseFor');\n\nconst LIFETIMES: readonly SegmentLifetime[] = ['request', 'document'];\n\nfunction readLifetime(node: Node): Read<SegmentLifetime> {\n const value = literal(node);\n const lifetime = LIFETIMES.find((l) => l === value);\n if (lifetime) return { value: lifetime };\n return { problem: \"lifetime must be 'request' or 'document'.\" };\n}\n\n/**\n * What the build can read of a segment key: the param and header names. `searchParams`\n * and `cookies` name definitions — code the build cannot evaluate — so only\n * their shape is checked here; their values take effect from the loaded\n * module (`server/segment-lifetime/`). The route-options lint checks the\n * param names against the segment's path.\n */\ntype BuildTimeKey = Pick<SegmentKey, 'segmentParams' | 'headers'>;\n\nfunction readHeaderNames(node: Node): Read<string[]> {\n const names = readStringArray(node);\n if (!names) return { problem: 'key.headers must be an array of header-name string literals.' };\n for (const name of names) {\n const problem = headerKeyProblem(name);\n if (problem) return { problem };\n }\n return { value: names };\n}\n\n/** A value written in place, which cannot be a definition imported or declared elsewhere. */\nfunction isInlineValue(node: Node): boolean {\n const type = unwrap(node).type;\n return (\n literal(node) !== undefined ||\n type === 'ObjectExpression' ||\n type === 'ArrayExpression' ||\n type === 'Literal' ||\n type === 'TemplateLiteral'\n );\n}\n\nfunction readKey(node: Node): Read<BuildTimeKey> {\n const n = unwrap(node);\n if (n.type !== 'ObjectExpression') {\n return {\n problem:\n 'key must be an object literal `{ segmentParams?, searchParams?, cookies?, headers? }`.',\n };\n }\n const result: BuildTimeKey = {};\n for (const entry of readProperties(n, 'key')) {\n if ('problem' in entry) return entry;\n if (entry.key === 'segmentParams') {\n const names = readStringArray(entry.value);\n if (!names) return { problem: 'key.segmentParams must be an array of string literals.' };\n result.segmentParams = names;\n } else if (entry.key === 'searchParams') {\n if (isInlineValue(entry.value)) {\n return {\n problem:\n 'key.searchParams must name a search-params definition (`defineSearchParams`, or a `.pick()` of one).',\n };\n }\n } else if (entry.key === 'cookies') {\n const array = unwrap(entry.value);\n const elements = list(array, 'elements');\n const definitions = elements.every(\n (e) => isNode(e) && e.type !== 'SpreadElement' && !isInlineValue(e)\n );\n if (array.type !== 'ArrayExpression' || !definitions) {\n return {\n problem: 'key.cookies must be an array literal of cookie definitions (`defineCookie`).',\n };\n }\n } else if (entry.key === 'headers') {\n const headers = readHeaderNames(entry.value);\n if ('problem' in headers) return headers;\n result.headers = headers.value;\n } else {\n return {\n problem: `Unknown key \"${entry.key}\" in key. Allowed: segmentParams, searchParams, cookies, headers.`,\n };\n }\n }\n return { value: result };\n}\n\nconst READERS = {\n layout: {\n lifetime: readLifetime,\n key: readKey,\n prerender: readPrerender,\n deferSuspenseFor,\n } satisfies Readers<LayoutOptions>,\n page: {\n lifetime: readLifetime,\n key: readKey,\n prerender: readPrerender,\n deferSuspenseFor,\n } satisfies Readers<PageOptions>,\n};\n\n// ─── Object literal ───────────────────────────────────────────────────────\n\ntype Entry = { key: string; value: Node } | { problem: string };\n\n/**\n * The `key: value` entries of an object literal, or a problem per entry that\n * has none. `key: undefined` entries are dropped: they mean \"not set\".\n */\nfunction readProperties(object: Node, label: string): Entry[] {\n return list(object, 'properties').flatMap((prop): Entry[] => {\n if (!isNode(prop) || prop.type === 'SpreadElement') {\n return [{ problem: `${label} cannot use a spread; write every key in the literal.` }];\n }\n if (prop.computed === true) {\n return [{ problem: `${label} cannot use a computed key; write the key name.` }];\n }\n const value = child(prop, 'value');\n const key = nameOf(child(prop, 'key'));\n if (prop.kind !== 'init' || prop.method === true || !value || key === undefined) {\n return [{ problem: `${label} entries must be plain \\`key: value\\` pairs.` }];\n }\n return isUndefined(value) ? [] : [{ key, value }];\n });\n}\n\nfunction readOptionsObject(init: Node, kind: RouteOptionsKind, problems: string[]) {\n const name = ROUTE_OPTIONS_EXPORT[kind];\n const object = unwrap(init);\n if (object.type !== 'ObjectExpression') {\n problems.push(`${name} must be an object literal: \\`export const ${name} = { … }\\`.`);\n return undefined;\n }\n const readers: Record<string, (node: Node) => Read<unknown>> = READERS[kind];\n const options: Record<string, unknown> = {};\n for (const entry of readProperties(object, name)) {\n if ('problem' in entry) {\n problems.push(entry.problem);\n continue;\n }\n const reader = Object.hasOwn(readers, entry.key) ? readers[entry.key] : undefined;\n if (!reader) {\n problems.push(\n `Unknown key \"${entry.key}\" in ${name}. Allowed: ${Object.keys(readers).join(', ')}.`\n );\n continue;\n }\n const read = reader(entry.value);\n if ('problem' in read) problems.push(read.problem);\n else options[entry.key] = read.value;\n }\n return options;\n}\n\n// ─── File ─────────────────────────────────────────────────────────────────\n\nconst NONE: RouteOptionsRead = Object.freeze({ options: undefined, problems: [] });\n\n/** Every name the reader reacts to; a file containing none of them is not parsed. */\nconst MENTIONS = /Options|prerender|deferSuspenseFor/;\n\n/**\n * Read a layout's `layoutOptions` or a page's `pageOptions` from source.\n *\n * A missing or unparseable file reads as no options and no problems: the\n * compiler reports syntax errors, and guessing at a half-written file would\n * misreport it. `.ts` files are parsed as TypeScript, not TSX, so an\n * angle-bracket cast does not hide a file from this check.\n */\nexport function readRouteOptions(filePath: string, kind: RouteOptionsKind): RouteOptionsRead {\n if (!existsSync(filePath)) return NONE;\n const source = readFileCached(filePath);\n // Runs on every page and layout on each rescan; most declare nothing.\n if (!MENTIONS.test(source)) return NONE;\n const program = tryParse(source, /\\.[mc]?ts$/.test(filePath) ? 'ts' : 'tsx');\n if (!program) return NONE;\n\n const own = ROUTE_OPTIONS_EXPORT[kind];\n const otherKind: RouteOptionsKind = kind === 'page' ? 'layout' : 'page';\n const other = ROUTE_OPTIONS_EXPORT[otherKind];\n const problems: string[] = [];\n let init: Node | undefined;\n\n /** An export of a watched name in a form the build cannot read. */\n const report = (name: string | undefined) => {\n if (name === own) {\n problems.push(\n `${own} must be declared in this file as \\`export const ${own} = { … } satisfies ${OPTIONS_TYPE[kind]}\\`. ` +\n '`let`, destructuring, `export { … }` and re-exports cannot be read at build time.'\n );\n } else if (name === other) {\n problems.push(\n `${other} configures a ${otherKind}; this file is a ${kind}. Use \\`export const ${own}\\`.`\n );\n } else if (name && (REMOVED_EXPORTS as readonly string[]).includes(name)) {\n problems.push(\n `\\`export const ${name}\\` was removed. Move it into the options object: ` +\n `\\`export const ${own} = { ${name}: … } satisfies ${OPTIONS_TYPE[kind]}\\`.`\n );\n }\n };\n const watched = [own, other, ...REMOVED_EXPORTS];\n\n for (const stmt of program.body) {\n if (!isNode(stmt) || stmt.exportKind === 'type') continue;\n // `export * as pageOptions from` names an export; bare `export * from` does not.\n if (stmt.type === 'ExportAllDeclaration') report(nameOf(child(stmt, 'exported')));\n if (stmt.type !== 'ExportNamedDeclaration') continue;\n for (const spec of list(stmt, 'specifiers')) {\n if (isNode(spec) && spec.exportKind !== 'type') report(nameOf(child(spec, 'exported')));\n }\n const decl = child(stmt, 'declaration');\n if (!decl) continue;\n if (decl.type !== 'VariableDeclaration') {\n report(nameOf(child(decl, 'id'))); // function or class\n continue;\n }\n for (const declarator of list(decl, 'declarations')) {\n if (!isNode(declarator)) continue;\n const id = child(declarator, 'id');\n const value = child(declarator, 'init');\n if (id?.type !== 'Identifier') {\n for (const name of watched) if (patternBinds(id, name)) report(name);\n } else if (id.name === own && decl.kind === 'const' && value) {\n init = value;\n } else {\n report(nameOf(id));\n }\n }\n }\n\n if (init && isClientModule(program.body)) {\n problems.push(\n `A 'use client' ${kind} cannot declare ${own}: the server sees a client reference, ` +\n `not the object. Move ${own} to a server ${kind} that renders the client component.`\n );\n }\n const options = init ? readOptionsObject(init, kind, problems) : undefined;\n return { options: problems.length === 0 ? options : undefined, problems };\n}\n\n/** Whether the module starts with a 'use client' directive. */\nfunction isClientModule(body: readonly unknown[]): boolean {\n for (const stmt of body) {\n if (\n !isNode(stmt) ||\n stmt.type !== 'ExpressionStatement' ||\n typeof stmt.directive !== 'string'\n ) {\n return false;\n }\n if (stmt.directive === 'use client') return true;\n }\n return false;\n}\n","/**\n * Convention-lint check for route-module options (design/53 §\"Route-module\n * options\"): `layoutOptions` / `pageOptions` the build cannot read, and\n * options declared where nothing reads them. Called from\n * `lintConventions` in `convention-lint.ts`.\n */\n\nimport type { ConventionWarning } from './convention-lint.ts';\nimport { fileHasAnyExport, isScriptExtension } from './export-detect.ts';\nimport { readRouteOptions } from './route-options.ts';\nimport type { RouteFile, SegmentNode } from './types.ts';\nimport type { LayoutOptions, PageOptions, SegmentLifetime } from '../server/types.ts';\nimport { ROUTE_OPTIONS_EXPORT, type RouteOptionsKind } from '../shared/route-options-export.ts';\n\n/**\n * Fail the build on a `layoutOptions` / `pageOptions` the build cannot read.\n *\n * Proven from source and fatal in the sense the error level requires: the\n * developer declared an option that would otherwise silently do nothing — a\n * misspelled key, a value the build cannot read, an options object in the\n * wrong file kind, or a floating `export const prerender` that no longer\n * prerenders. See `routing/route-options.ts` for what is accepted.\n */\nexport function checkRouteOptions(\n node: SegmentNode,\n warnings: ConventionWarning[],\n position: RoutePosition,\n /** The app's `defaultLayoutLifetime` (design/53 §\"App-wide default\"). */\n defaultLayoutLifetime: SegmentLifetime,\n /** The params named on the path above this segment. */\n ancestorParams: readonly string[] = []\n): void {\n const here: RoutePosition = node.segmentType === 'intercepting' ? 'intercepting' : position;\n const pathParams = node.paramName ? [...ancestorParams, node.paramName] : ancestorParams;\n const files: Array<[RouteOptionsKind, RouteFile | undefined]> = [\n ['layout', node.layout],\n ['page', node.page],\n ];\n for (const [kind, file] of files) {\n if (!file || !isScriptExtension(file.extension)) continue;\n const { options, problems } = readRouteOptions(file.filePath, kind);\n problems.push(\n ...inertOptions(options, here),\n ...paramsOffPath(options, pathParams),\n ...keyWithoutDocument(options, kind === 'layout' ? defaultLayoutLifetime : 'request')\n );\n if (problems.length === 0) continue;\n warnings.push({\n id: `ROUTE_OPTIONS_INVALID:${file.filePath}`,\n summary: `${kind}.${file.extension} has invalid ${ROUTE_OPTIONS_EXPORT[kind]}: ${file.filePath}`,\n details:\n ` File: ${file.filePath}\\n\\n` +\n problems.map((problem) => ` - ${problem}\\n`).join('') +\n '\\n Options are read from source at build time, so they must be one object\\n' +\n ' literal of literal values.\\n',\n level: 'error',\n });\n }\n if (node.default && isScriptExtension(node.default.extension)) {\n const declared = fileHasAnyExport(node.default.filePath, OPTION_EXPORT_NAMES);\n if (declared.size > 0) {\n warnings.push({\n id: `ROUTE_OPTIONS_INVALID:${node.default.filePath}`,\n summary: `default.${node.default.extension} takes no route options: ${node.default.filePath}`,\n details:\n ` File: ${node.default.filePath}\\n\\n` +\n ` default.tsx exports ${[...declared].join(', ')}, which nothing reads.\\n` +\n ' To fix: remove the export; declare options on the slot page or layout.\\n',\n level: 'error',\n });\n }\n }\n for (const child of node.children) {\n checkRouteOptions(child, warnings, here, defaultLayoutLifetime, pathParams);\n }\n for (const slot of Object.values(node.slots)) {\n const slotPosition = here === 'intercepting' ? here : 'slot';\n checkRouteOptions(slot, warnings, slotPosition, defaultLayoutLifetime, pathParams);\n }\n}\n\n/**\n * A `key` applies only to a `'document'` segment; on any other it would\n * silently do nothing. A layout that declares no lifetime takes the app's\n * `defaultLayoutLifetime`, so under a `'document'` default it may declare a\n * key alone. A page always defaults to `'request'`.\n */\nfunction keyWithoutDocument(\n options: LayoutOptions | PageOptions | undefined,\n defaultLifetime: SegmentLifetime\n): string[] {\n if (options?.key === undefined || (options.lifetime ?? defaultLifetime) === 'document') return [];\n return [\n \"key applies only to lifetime: 'document'. Declare `lifetime: 'document'` or remove key.\",\n ];\n}\n\n/**\n * A key's `segmentParams` must name params on the segment's path — the\n * segment's own and every ancestor's, slots included. Anything else could\n * never change, so the key would silently ignore what the author meant\n * (design/53 §\"Segment keys\").\n */\nfunction paramsOffPath(\n options: LayoutOptions | PageOptions | undefined,\n pathParams: readonly string[]\n): string[] {\n const declared = options?.key?.segmentParams ?? [];\n return declared\n .filter((name) => !pathParams.includes(name))\n .map(\n (name) =>\n `key.segmentParams names \"${name}\", which is not a param on this segment's path. ` +\n (pathParams.length > 0\n ? `Params on the path: ${pathParams.join(', ')}.`\n : 'This path has no params.')\n );\n}\n\n/**\n * Where a segment sits decides which options take effect there.\n * - `main`: the matched route chain. Every option applies.\n * - `slot`: a parallel slot. `prerender` applies to slot pages (the sugar\n * walks slots); `deferSuspenseFor` does not — the hold is read from the\n * main chain's modules only (`server/route-module-loader.ts`).\n * - `intercepting`: an intercepting route and everything under it. It renders\n * only on a soft navigation, through the slot resolver, and the sugar skips\n * it, so no option applies.\n */\ntype RoutePosition = 'main' | 'slot' | 'intercepting';\n\nconst OPTION_EXPORT_NAMES = [\n ...Object.values(ROUTE_OPTIONS_EXPORT),\n 'prerender',\n 'deferSuspenseFor',\n] as const;\n\nfunction inertOptions(\n options: LayoutOptions | PageOptions | undefined,\n position: RoutePosition\n): string[] {\n if (!options || position === 'main') return [];\n const inert = Object.keys(options).filter(\n (key) => position === 'intercepting' || key === 'deferSuspenseFor'\n );\n return inert.map((key) =>\n position === 'intercepting'\n ? `${key} has no effect on an intercepting route: it renders only on a soft navigation, ` +\n 'through the slot that intercepts it. Declare it on the route being intercepted.'\n : `${key} has no effect in a parallel slot: the hold is read from the main route's ` +\n 'layouts and page. Declare it there.'\n );\n}\n","/**\n * Convention linter — validates common misconfigurations in the route tree.\n *\n * Runs at scan time (build and dev startup). Each check produces a warning\n * with the file path, what's wrong, and what to do about it.\n *\n * Most checks are warnings — they don't block the build. The goal is to catch\n * issues that would otherwise produce cryptic runtime behavior (silent 404s,\n * empty pages, confusing React errors).\n *\n * A check emits `level: 'error'` only when the misconfiguration is *proven*\n * (never inferred from an absence the analysis cannot see through) and either\n * fatal to rendering or a declaration that provably does nothing — a CSRF\n * exemption the gate never reads, a route option the build cannot read, a\n * middleware.ts in a slot. The developer believes the declaration is in\n * effect, so silence would ship the wrong behavior. `plugins/routing.ts` turns those into a thrown build error,\n * so a false positive there refuses a working app — see\n * `classifyClientBoundaryFile` for how that bar is met.\n *\n * Design doc: 07-routing.md, 10-error-handling.md\n */\n\nimport { existsSync } from 'node:fs';\nimport type { RouteFile, RouteTree, SegmentNode } from './types.ts';\nimport { swallow } from '../server/logger.ts';\nimport { HTTP_METHODS } from '../server/route-methods.ts';\nimport {\n fileDefaultExportIsLocalValue,\n fileHasAnyExport,\n fileHasDefaultExport,\n fileHasDirective,\n fileHasStarExport,\n getCsrfExport,\n isScriptExtension,\n} from './export-detect.ts';\nimport { checkRouteOptions } from './route-options-lint.ts';\nimport type { SegmentLifetime } from '../server/types.ts';\n\n// ─── Types ──────────────────────────────────────────────────────────────────\n\nexport interface ConventionWarning {\n /** Warning ID for deduplication and filtering. */\n id: string;\n /** Human-readable single-line summary. */\n summary: string;\n /** Multi-line details with file path and fix suggestion. */\n details: string;\n /** Severity: 'warn' for potential issues, 'error' for definite misconfigurations. */\n level: 'warn' | 'error';\n}\n\n// ─── Lint Rules ─────────────────────────────────────────────────────────────\n\n/**\n * Run all convention lint checks on a route tree.\n *\n * Returns an array of warnings. Empty array means everything looks good.\n */\nexport function lintConventions(\n tree: RouteTree,\n appDir: string,\n /** The config the checks depend on, as the build resolved it. */\n config: { defaultLayoutLifetime: SegmentLifetime | undefined }\n): ConventionWarning[] {\n const warnings: ConventionWarning[] = [];\n\n // Check 1: app/ directory exists (caller should check before scanning,\n // but we validate the root has at least one routable file)\n checkEmptyApp(tree.root, appDir, warnings);\n\n // Check 2: route.ts without recognized HTTP method exports\n checkRouteExports(tree.root, warnings);\n\n // Check 3: Segments with layout but no page/route anywhere in subtree\n // (not a misconfiguration per se — layouts without pages are valid for\n // route groups. Skip this check.)\n\n // Check 4: Root segment has no layout.tsx (no HTML shell)\n checkRootLayout(tree.root, warnings);\n\n // Check 5: page.tsx / layout.tsx without default export\n checkDefaultExports(tree.root, warnings);\n\n // Check 6: Client layouts cannot suppress server children before Flight\n // serializes them. They remain valid UI boundaries, but not authorization\n // or data-hiding boundaries.\n checkClientLayouts(tree.root, warnings);\n\n // Check 7: error.tsx / 404.tsx / 4xx.tsx / … without 'use client' directive\n checkClientBoundaryFiles(tree.root, warnings);\n if (tree.globalError) {\n checkFileUseClientDirective(tree.globalError, 'global-error', warnings);\n }\n\n // Check 8: middleware.ts inside a parallel slot subtree (silently dead)\n checkSlotMiddleware(tree.root, warnings);\n\n // Check 9: `export const csrf` anywhere but route.ts, or in a form the\n // scanner cannot read (TIM-1543)\n checkCsrfExports(tree.root, warnings);\n if (tree.proxy) checkCsrfExport(tree.proxy, 'proxy.ts', warnings);\n if (tree.globalError) checkCsrfExport(tree.globalError, 'global-error', warnings);\n\n // Check 10: layoutOptions / pageOptions the build cannot read, unknown\n // keys, and the removed floating exports (design/53)\n checkRouteOptions(tree.root, warnings, 'main', config.defaultLayoutLifetime ?? 'request');\n\n return warnings;\n}\n\nfunction checkClientLayouts(node: SegmentNode, warnings: ConventionWarning[]): void {\n if (node.layout && isScriptExtension(node.layout.extension)) {\n try {\n const isClient = fileHasDirective(node.layout.filePath, 'use client');\n const isProvablyServer = fileDefaultExportIsLocalValue(node.layout.filePath);\n if (isClient || !isProvablyServer) {\n const certainty = isClient\n ? `This layout is a client component.`\n : `Timber cannot prove this layout is a server component because its default export comes from another module or an opaque expression.`;\n warnings.push({\n id: `CLIENT_LAYOUT_NOT_AUTH_BOUNDARY:${node.layout.filePath}`,\n summary: isClient\n ? `Client layout cannot securely suppress server children: ${node.layout.filePath}`\n : `Layout may resolve to a client component and cannot be trusted as an auth boundary: ${node.layout.filePath}`,\n details:\n ` File: ${node.layout.filePath}\\n\\n` +\n ` ${certainty}\\n` +\n ` React Flight resolves server content passed to a client layout before the layout runs in the browser.\\n` +\n ` Conditionally omitting children here does not prevent descendant server components from executing or being serialized.\\n\\n` +\n ` To fix: Put authorization in access.ts or a provably server layout with a locally defined default component, and keep client components inside that boundary.\\n`,\n level: 'warn',\n });\n }\n } catch (err) {\n swallow(err, `convention-lint: unreadable layout file ${node.layout.filePath}`);\n }\n }\n for (const child of node.children) checkClientLayouts(child, warnings);\n for (const slot of Object.values(node.slots)) checkClientLayouts(slot, warnings);\n}\n\n// ─── Check: CSRF Exemption Export ──────────────────────────────────────────\n\n/** Single-file segment conventions other than route.ts. */\nconst NON_ROUTE_FILE_KEYS = [\n 'page',\n 'layout',\n 'middleware',\n 'access',\n 'error',\n 'default',\n 'denied',\n] as const satisfies readonly (keyof SegmentNode)[];\n\n/**\n * Fail the build on a `csrf` export the CSRF gate would not honor.\n *\n * Both findings are proven from source, and both are fatal in the sense\n * the error level requires: the developer wrote an exemption that silently\n * does nothing, so a legitimate cross-site POST they meant to accept gets\n * a 403 in production, or they believe a page or action is exempt when\n * the gate still protects it. The exemption exists only on route.ts —\n * server actions always get the check (design/08 §\"Per-route exemption\").\n * A `'use server'` module cannot export it at all: plugin-rsc rejects every\n * non-async-function export there.\n */\nfunction checkCsrfExports(node: SegmentNode, warnings: ConventionWarning[]): void {\n if (node.route) checkCsrfExport(node.route, 'route.ts', warnings);\n for (const key of NON_ROUTE_FILE_KEYS) {\n const file = node[key];\n if (file) checkCsrfExport(file, key, warnings);\n }\n // Status files and metadata routes (sitemap.ts, opengraph-image.tsx, …).\n // JSON status files are skipped by the script-extension check.\n for (const [name, file] of Object.entries(node.statusFiles ?? {})) {\n checkCsrfExport(file, name, warnings);\n }\n for (const [name, file] of Object.entries(node.metadataRoutes ?? {})) {\n checkCsrfExport(file, name, warnings);\n }\n for (const child of node.children) checkCsrfExports(child, warnings);\n for (const slot of Object.values(node.slots)) checkCsrfExports(slot, warnings);\n}\n\nfunction checkCsrfExport(file: RouteFile, convention: string, warnings: ConventionWarning[]): void {\n if (!isScriptExtension(file.extension)) return;\n const found = getCsrfExport(file.filePath);\n if (found === 'absent') return;\n const isRoute = convention === 'route.ts';\n if (isRoute && found === 'exempt') return;\n warnings.push({\n id: `CSRF_EXPORT_INVALID:${file.filePath}`,\n summary: isRoute\n ? `route.ts csrf export must be exactly \\`export const csrf = false\\`: ${file.filePath}`\n : `\\`csrf\\` can only be exported from route.ts, not ${convention}: ${file.filePath}`,\n details:\n ` File: ${file.filePath}\\n\\n` +\n (isRoute\n ? ' The CSRF gate reads this export from source before any module loads, so only\\n' +\n ' the literal form counts. Other values, `let`, and re-exports are not read.\\n\\n' +\n ' To fix: write `export const csrf = false;` in this file, or remove the export.\\n'\n : ' The per-route CSRF exemption applies only to route.ts handlers. Pages, layouts\\n' +\n ' and server actions always get the CSRF check.\\n\\n' +\n ' To fix: remove the export. To accept a cross-site POST, handle it in a route.ts\\n' +\n ' that exports `const csrf = false`.\\n'),\n level: 'error',\n });\n}\n\n// ─── Check: Empty App ───────────────────────────────────────────────────────\n\n/**\n * Warn when the app/ directory has no routable files at all.\n *\n * This catches the \"I created app/ but didn't add any pages\" case where\n * every request silently 404s with no guidance.\n */\nfunction checkEmptyApp(root: SegmentNode, appDir: string, warnings: ConventionWarning[]): void {\n if (hasAnyRoutable(root)) return;\n\n warnings.push({\n id: 'EMPTY_APP',\n summary: 'No pages or route handlers found in app/',\n details:\n ` Directory: ${appDir}\\n\\n` +\n ' Your app/ directory has no page.tsx or route.ts files.\\n' +\n ' Every request will return 404.\\n\\n' +\n ' To fix: Create app/page.tsx with a default export:\\n\\n' +\n ' export default function Home() {\\n return <h1>Hello</h1>;\\n }\\n',\n level: 'warn',\n });\n}\n\n/**\n * Check if a segment tree has any routable files (page or route) anywhere.\n */\nfunction hasAnyRoutable(node: SegmentNode): boolean {\n if (node.page || node.route) return true;\n for (const child of node.children) {\n if (hasAnyRoutable(child)) return true;\n }\n for (const slot of Object.values(node.slots)) {\n if (hasAnyRoutable(slot)) return true;\n }\n return false;\n}\n\n/**\n * Check if a segment tree has any page files (not just route handlers).\n * Used by checkRootLayout to avoid false positives for API-only apps (TIM-794).\n * API-only apps (just route.ts handlers) don't need a root layout.\n */\nfunction hasAnyPage(node: SegmentNode): boolean {\n if (node.page) return true;\n for (const child of node.children) {\n if (hasAnyPage(child)) return true;\n }\n for (const slot of Object.values(node.slots)) {\n if (hasAnyPage(slot)) return true;\n }\n return false;\n}\n\n// ─── Check: Route Exports ───────────────────────────────────────────────────\n\n/**\n * Warn when a route.ts file doesn't appear to export any recognized HTTP methods.\n *\n * Uses AST-based detection via parseAst for precise matching.\n * Falls back silently when the file can't be parsed (syntax errors produce\n * no spurious warning — the TS compiler will catch those).\n */\nfunction checkRouteExports(node: SegmentNode, warnings: ConventionWarning[]): void {\n if (node.route) {\n const filePath = node.route.filePath;\n try {\n const methods = fileHasAnyExport(filePath, HTTP_METHODS);\n if (methods.size === 0 && !fileHasStarExport(filePath)) {\n const hasDefault = fileHasDefaultExport(filePath);\n const hint = hasDefault\n ? ' It looks like you have a default export. route.ts uses named exports\\n' +\n ' for HTTP methods (GET, POST, etc.), not a default export.\\n'\n : '';\n\n warnings.push({\n id: 'ROUTE_NO_METHODS',\n summary: `route.ts has no HTTP method exports: ${filePath}`,\n details:\n ` File: ${filePath}\\n\\n` +\n ' route.ts files must export named HTTP method handlers.\\n' +\n ' Without them, the route matches but returns 405 Method Not Allowed.\\n\\n' +\n hint +\n ' Example:\\n\\n' +\n ' export function GET(ctx: RouteContext) {\\n' +\n \" return Response.json({ hello: 'world' });\\n\" +\n ' }\\n',\n level: 'warn',\n });\n }\n } catch (err) {\n swallow(err, `convention-lint: unreadable route.ts ${filePath}`);\n }\n }\n\n // Recurse\n for (const child of node.children) {\n checkRouteExports(child, warnings);\n }\n for (const slot of Object.values(node.slots)) {\n checkRouteExports(slot, warnings);\n }\n}\n\n// ─── Check: Root Layout ─────────────────────────────────────────────────────\n\n/**\n * Warn when the root segment has no layout.tsx.\n *\n * Without a root layout, there's no HTML shell (<html>, <body>).\n * The page will render but may have hydration issues or no proper document structure.\n */\nfunction checkRootLayout(root: SegmentNode, warnings: ConventionWarning[]): void {\n if (root.layout) return;\n\n // Only warn if there are pages — API-only apps (just route.ts handlers)\n // don't need a root layout (TIM-794).\n if (!hasAnyPage(root)) return;\n\n warnings.push({\n id: 'NO_ROOT_LAYOUT',\n summary: 'No root layout.tsx found',\n details:\n ' Your app has pages but no root layout.\\n' +\n ' Without app/layout.tsx, pages have no <html> or <body> wrapper.\\n\\n' +\n ' To fix: Create app/layout.tsx:\\n\\n' +\n ' export default function RootLayout({ children }: { children: React.ReactNode }) {\\n' +\n ' return (\\n' +\n ' <html lang=\"en\">\\n' +\n ' <body>{children}</body>\\n' +\n ' </html>\\n' +\n ' );\\n' +\n ' }\\n',\n level: 'warn',\n });\n}\n\n// ─── Check: Default Exports ───────────────────────────────────────────\n\n/**\n * Warn when page.tsx or layout.tsx files don't have a default export.\n *\n * Without a default export:\n * - page.tsx: the page renders nothing (empty content)\n * - layout.tsx: the layout module loads but has no component to render\n *\n * Uses AST-based detection via parseAst for precise matching. Falls back\n * silently when the file can't be parsed (no spurious warning on syntax errors).\n */\nfunction checkDefaultExports(node: SegmentNode, warnings: ConventionWarning[]): void {\n // Check page files (tsx/ts/jsx/js only — not mdx, which is default-exported by the mdx compiler)\n if (node.page && isScriptExtension(node.page.extension)) {\n checkFileDefaultExport(node.page.filePath, 'page', warnings);\n }\n\n // Check layout files\n if (node.layout && isScriptExtension(node.layout.extension)) {\n checkFileDefaultExport(node.layout.filePath, 'layout', warnings);\n }\n\n // Recurse\n for (const child of node.children) {\n checkDefaultExports(child, warnings);\n }\n for (const slot of Object.values(node.slots)) {\n checkDefaultExports(slot, warnings);\n }\n}\n\nfunction checkFileDefaultExport(\n filePath: string,\n fileType: string,\n warnings: ConventionWarning[]\n): void {\n try {\n if (!fileHasDefaultExport(filePath)) {\n warnings.push({\n id: `NO_DEFAULT_EXPORT:${filePath}`,\n summary: `${fileType}.tsx has no default export: ${filePath}`,\n details:\n ` File: ${filePath}\\n\\n` +\n ` ${fileType}.tsx files must export a default React component.\\n` +\n ` Without a default export, the ${fileType === 'page' ? 'page renders nothing' : 'layout has no component to wrap children'}.\\n\\n` +\n ` To fix: Add a default export:\\n\\n` +\n ` export default function My${fileType === 'page' ? 'Page' : 'Layout'}(${fileType === 'layout' ? '{ children }' : ''}) {\\n` +\n ` return ${fileType === 'layout' ? '<div>{children}</div>' : '<h1>Hello</h1>'};\\n` +\n ` }\\n`,\n level: 'warn',\n });\n }\n } catch (err) {\n swallow(err, `convention-lint: unreadable ${fileType} file ${filePath}`);\n }\n}\n\n// ─── Check: Client Boundary Directive ───────────────────────────────────────\n\n/**\n * Check every file the renderer hands to `TimberErrorBoundary` as a component\n * prop: `error.tsx`, `global-error.tsx`, and the status-code family\n * (`404.tsx`, `4xx.tsx`, `503.tsx`, …).\n *\n * `TimberErrorBoundary` is a client component, so a server component passed as\n * `fallbackComponent` is a function crossing the RSC → client boundary. React\n * Flight refuses to serialize it, and because the boundary wraps the segment's\n * *children*, the failure hits every page under that segment — not just the\n * error path. The raw message (\"Functions cannot be passed directly to Client\n * Components\") names neither the file nor the fix (TIM-1329).\n *\n * `.json` status files never reach React at all, and are not in `statusFiles`.\n */\nfunction checkClientBoundaryFiles(node: SegmentNode, warnings: ConventionWarning[]): void {\n if (node.error) {\n checkFileUseClientDirective(node.error, 'error', warnings);\n }\n\n for (const [key, file] of Object.entries(node.statusFiles ?? {})) {\n checkFileUseClientDirective(file, key, warnings);\n }\n\n for (const child of node.children) {\n checkClientBoundaryFiles(child, warnings);\n }\n for (const slot of Object.values(node.slots)) {\n checkClientBoundaryFiles(slot, warnings);\n }\n}\n\n/**\n * `'client'` — carries the directive.\n * `'server'` — proven server component: no directive, and the default export is\n * a function or class built by this very module, so no other file's directive\n * can be governing it.\n * `'unknown'` — no directive, but the exported value may come from elsewhere\n * (`export { default } from './client-thing'`), or the file could not be\n * read or parsed. Never escalated to a build error.\n */\ntype ClientBoundaryVerdict = 'client' | 'server' | 'unknown';\n\nfunction classifyClientBoundaryFile(filePath: string): ClientBoundaryVerdict {\n if (fileHasDirective(filePath, 'use client')) return 'client';\n if (fileDefaultExportIsLocalValue(filePath)) return 'server';\n return 'unknown';\n}\n\n/** Example component name for the fix snippet, keyed by convention name. */\nfunction exampleComponentName(convention: string): string {\n if (convention === 'global-error') return 'GlobalError';\n if (convention === 'error') return 'ErrorBoundary';\n if (convention === '404') return 'NotFound';\n return 'StatusPage';\n}\n\n/**\n * @param file the route file (its extension decides whether the check applies)\n * @param convention the convention name — `error`, `global-error`, `404`, `4xx`, …\n */\nfunction checkFileUseClientDirective(\n file: RouteFile,\n convention: string,\n warnings: ConventionWarning[]\n): void {\n // Only script extensions need the 'use client' check — .json status files\n // never reach React at all, and are not in `statusFiles`.\n if (!isScriptExtension(file.extension)) return;\n\n const filePath = file.filePath;\n const label = `${convention}.${file.extension}`;\n let verdict: ClientBoundaryVerdict;\n try {\n verdict = classifyClientBoundaryFile(filePath);\n } catch (err) {\n swallow(err, `convention-lint: unreadable ${label} file ${filePath}`);\n return;\n }\n if (verdict === 'client') return;\n\n const isError = verdict === 'server';\n const name = exampleComponentName(convention);\n const props =\n convention === 'error' || convention === 'global-error' ? '{ error, reset }' : '{ status }';\n\n warnings.push({\n id: `NEEDS_USE_CLIENT:${filePath}`,\n summary: isError\n ? `${label} is a server component and must be a client component: ${filePath}`\n : `${label} may be missing 'use client': ${filePath}`,\n details:\n ` File: ${filePath}\\n\\n` +\n ` ${label} is handed to timber's error boundary — a client\\n` +\n ' component — as a prop. A server component cannot cross that boundary:\\n' +\n ' React fails with \"Functions cannot be passed directly to Client\\n' +\n ' Components\", and every page under this segment fails to render.\\n\\n' +\n (isError\n ? \" To fix: Add 'use client' as the first line of the file:\\n\\n\" +\n \" 'use client';\\n\\n\" +\n ` export default function ${name}(${props}) {\\n` +\n ' return <h1>…</h1>;\\n' +\n ' }\\n'\n : // The default export comes from somewhere this analysis cannot follow\n // — a re-export, an imported binding, a wrapper call. It may well\n // already be a client component, so say what was checked rather than\n // assert a break.\n \" This file has no 'use client' directive, and its default export\\n\" +\n ' comes from elsewhere, so timber cannot tell which it is. If the\\n' +\n \" module it re-exports starts with 'use client', nothing is wrong\\n\" +\n ' and you can ignore this. Otherwise add the directive there.\\n'),\n level: isError ? 'error' : 'warn',\n });\n}\n\n// ─── Check: Slot Middleware ─────────────────────────────────────────────────\n\n/**\n * Error when middleware.ts appears inside a parallel slot subtree.\n *\n * Middleware is collected from the main matched segment chain only\n * (route-matcher.ts `collectMiddlewareChain`). The slot resolver never\n * walks `middleware` on its matched chain, so a middleware.ts under any\n * `@slot/` directory silently never executes. `access.ts` in slot chains\n * DOES run (via SlotAccessGate), making the asymmetry invisible unless\n * you know to look.\n *\n * This is a build error rather than a warning: the file provably cannot\n * run and its presence misleads the author into thinking the slot is\n * middleware-protected.\n *\n * See design/07-routing.md §\"Parallel Routes\"\n */\nfunction checkSlotMiddleware(node: SegmentNode, warnings: ConventionWarning[]): void {\n for (const [slotName, slotRoot] of Object.entries(node.slots)) {\n collectSlotMiddleware(slotRoot, slotName, warnings);\n }\n for (const child of node.children) {\n checkSlotMiddleware(child, warnings);\n }\n}\n\n/**\n * Walk a slot subtree and report every middleware.ts found.\n */\nfunction collectSlotMiddleware(\n node: SegmentNode,\n slotName: string,\n warnings: ConventionWarning[]\n): void {\n if (node.middleware) {\n warnings.push({\n id: `SLOT_MIDDLEWARE:${node.middleware.filePath}`,\n summary: `middleware.ts inside slot @${slotName} never executes: ${node.middleware.filePath}`,\n details:\n ` File: ${node.middleware.filePath}\\n\\n` +\n ` Middleware is collected from the main route chain only.\\n` +\n ` The slot resolver does not run middleware — this file is silently dead.\\n` +\n ` (access.ts in slots does run via SlotAccessGate; middleware.ts does not.)\\n\\n` +\n ` To fix: Move the middleware logic into access.ts for slot-scoped auth,\\n` +\n ` or into a middleware.ts on the main route chain outside the slot.\\n`,\n level: 'error',\n });\n }\n for (const child of node.children) {\n collectSlotMiddleware(child, slotName, warnings);\n }\n for (const [nestedSlotName, nestedSlot] of Object.entries(node.slots)) {\n collectSlotMiddleware(nestedSlot, nestedSlotName, warnings);\n }\n}\n\n// ─── Check: App Directory Exists ────────────────────────────────────────────\n\n/**\n * Check if the app/ directory exists. Called before scanning.\n * Returns a warning if missing, or null if the directory exists.\n */\nexport function checkAppDirExists(appDir: string): ConventionWarning | null {\n if (existsSync(appDir)) return null;\n\n return {\n id: 'NO_APP_DIR',\n summary: 'No app/ directory found',\n details:\n ` Expected: ${appDir}\\n\\n` +\n ' timber.js requires an app/ directory for file-system routing.\\n' +\n ' Every request will return 404 until you create it.\\n\\n' +\n ' To fix: Create the app/ directory with a page:\\n\\n' +\n ' mkdir -p app\\n' +\n ' # Create app/layout.tsx and app/page.tsx\\n',\n level: 'error',\n };\n}\n\n// ─── Formatting ─────────────────────────────────────────────────────────────\n\nimport type { InspectColor } from 'node:util';\nimport { styleText } from 'node:util';\n\ntype Format = InspectColor | readonly InspectColor[];\nconst noValidate = { validateStream: false } as const;\n\nexport interface FormatOptions {\n /**\n * Emit ANSI escapes. Off when the text becomes an `Error` message —\n * whoever prints it decides its formatting, and colored escapes inside\n * an exception leak into logs and stack traces.\n */\n color?: boolean;\n}\n\n/**\n * Format warnings for terminal output.\n *\n * Groups by severity, uses colors, and includes fix suggestions.\n */\nexport function formatConventionWarnings(\n warnings: ConventionWarning[],\n options: FormatOptions = {}\n): string {\n const { color = true } = options;\n const style = (fmt: Format, text: string) => (color ? styleText(fmt, text, noValidate) : text);\n if (warnings.length === 0) return '';\n\n const errors = warnings.filter((w) => w.level === 'error');\n const warns = warnings.filter((w) => w.level === 'warn');\n\n const lines: string[] = [];\n\n if (errors.length > 0) {\n lines.push(\n `${style(['red', 'bold'], '[timber]')} ${style('red', `${errors.length} configuration error${errors.length !== 1 ? 's' : ''}:`)}`\n );\n for (const e of errors) {\n lines.push('');\n lines.push(` ${style('red', '✗')} ${e.summary}`);\n lines.push(style('dim', e.details));\n }\n }\n\n if (warns.length > 0) {\n if (errors.length > 0) lines.push('');\n lines.push(\n `${style(['yellow', 'bold'], '[timber]')} ${style('yellow', `${warns.length} configuration warning${warns.length !== 1 ? 's' : ''}:`)}`\n );\n for (const w of warns) {\n lines.push('');\n lines.push(` ${style('yellow', '⚠')} ${w.summary}`);\n lines.push(style('dim', w.details));\n }\n }\n\n return lines.join('\\n');\n}\n"],"mappings":"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"}
@@ -1 +0,0 @@
1
- export { t as RESTART_EXIT_CODE } from "./dev-server-DYDr8KIc.js";
@@ -1 +0,0 @@
1
- {"version":3,"file":"key-headers-uIig1_mU.js","names":[],"sources":["../../src/shared/key-headers.ts"],"sourcesContent":["/**\n * Which request headers a `'document'` segment's key may name\n * (design/53-segment-lifetime.md §\"Segment keys\"). One rule for the build\n * (`routing/route-options.ts`), which reports it from source, and for the\n * runtime (`server/segment-lifetime/segment-key.ts`), which refuses it too —\n * the build cannot read every file kind (MDX pages are not linted), and a\n * credential must not become keyable by skipping the lint.\n */\n\n/** RFC 9110 §5.6.2 `token`: what a header field name may be. */\nconst HEADER_NAME = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/;\n\n/**\n * Headers a key may not name. `cookie` is read through cookie definitions\n * (`key.cookies`). Credentials are secret, and a key answers guesses about\n * its values to whoever holds a digest (design/53 §\"The key digest\").\n */\nconst CREDENTIAL = 'It carries a credential, and a key must not hold secret values.';\n\n/**\n * A `Map`, not an object literal: a header may be named `constructor` or\n * `__proto__`, and an index lookup would find `Object.prototype`'s.\n */\nconst UNKEYABLE_HEADERS: ReadonlyMap<string, string> = new Map([\n ['cookie', 'Key on cookie definitions with key.cookies instead.'],\n ['authorization', CREDENTIAL],\n ['proxy-authorization', CREDENTIAL],\n ['x-api-key', CREDENTIAL],\n]);\n\n/** Why a key may not name `name`, or undefined when it may. */\nexport function headerKeyProblem(name: string): string | undefined {\n if (!HEADER_NAME.test(name))\n return `key.headers names \"${name}\", which is not a valid header name.`;\n const refused = UNKEYABLE_HEADERS.get(name.toLowerCase());\n return refused ? `key.headers may not name \"${name}\". ${refused}` : undefined;\n}\n\n/** Whether a key may never name `name` (case-insensitive): a cookie or credential header. */\nexport function isUnkeyableHeader(name: string): boolean {\n return UNKEYABLE_HEADERS.has(name.toLowerCase());\n}\n"],"mappings":";;;;;;;;;;AAUA,IAAM,cAAc;;;;;;AAOpB,IAAM,aAAa;;;;;AAMnB,IAAM,oCAAiD,IAAI,IAAI;CAC7D,CAAC,UAAU,qDAAqD;CAChE,CAAC,iBAAiB,UAAU;CAC5B,CAAC,uBAAuB,UAAU;CAClC,CAAC,aAAa,UAAU;AAC1B,CAAC;;AAGD,SAAgB,iBAAiB,MAAkC;CACjE,IAAI,CAAC,YAAY,KAAK,IAAI,GACxB,OAAO,sBAAsB,KAAK;CACpC,MAAM,UAAU,kBAAkB,IAAI,KAAK,YAAY,CAAC;CACxD,OAAO,UAAU,6BAA6B,KAAK,KAAK,YAAY,KAAA;AACtE;;AAGA,SAAgB,kBAAkB,MAAuB;CACvD,OAAO,kBAAkB,IAAI,KAAK,YAAY,CAAC;AACjD"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"logger-C4m8rfMy.js","names":[],"sources":["../../src/server/signal-identity.ts","../../src/server/tracing.ts","../../src/server/debug.ts","../../src/server/error-formatter.ts","../../src/server/default-logger.ts","../../src/server/logger.ts"],"sourcesContent":["// Signal identity — the brands framework signals carry, the predicates that\n// recognise them, and SsrStreamError.\n//\n// No runtime imports (the one import is type-only), so any environment can\n// load it. The SSR entry's import graph\n// must not reach RSC request state (`request-context.ts` and friends, held\n// to that by `tests/ssr-import-boundary.test.ts`), and the signal classes\n// in primitives.ts sit beside `deny()` and `redirect()`, which read it. SSR\n// code that has to recognise a signal (the logger skips them) imports the\n// predicates from here; the classes stamp the brands exported here.\n\nimport type { DenySignal, RedirectSignal } from './primitives.ts';\n\n// ─── Signal branding ────────────────────────────────────────────────────────\n//\n// Catch sites must NOT use `instanceof` on these classes. In dev, an HMR\n// program reload clears the RSC module cache; a request that is mid-render\n// still holds the catch sites from the old evaluation of primitives.ts while\n// user code loaded after the reload throws from the new one. The two\n// evaluations are distinct classes, so `instanceof` fails and a correct\n// deny() falls through every catch site as an unhandled 500 (TIM-1499).\n//\n// Each class stamps a `Symbol.for` brand on its instances in the constructor.\n// `Symbol.for` keys live in the realm-wide symbol registry, so every\n// evaluation of these modules — and every module graph in the same process —\n// agrees on the key. The `is*` predicates below check the brand and are the\n// only supported way to detect a signal. The classes themselves are NOT\n// anchored on globalThis: a re-evaluated module must hand out its own\n// (possibly updated) class, not a stale one.\n//\n// See design/18-build-system.md §\"Dev Mode: Signal Identity Across Program Reloads\".\n\nexport const DENY_BRAND: unique symbol = Symbol.for('timber:signal.deny');\nexport const REDIRECT_BRAND: unique symbol = Symbol.for('timber:signal.redirect');\nconst SSR_STREAM_ERROR_BRAND: unique symbol = Symbol.for('timber:signal.ssr-stream-error');\n\nfunction hasBrand(value: unknown, brand: symbol): boolean {\n return typeof value === 'object' && value !== null && brand in value;\n}\n\n/** True for any `DenySignal`, regardless of which module evaluation created it. */\nexport function isDenySignal(error: unknown): error is DenySignal {\n return hasBrand(error, DENY_BRAND);\n}\n\n/** True for any `RedirectSignal`, regardless of which module evaluation created it. */\nexport function isRedirectSignal(error: unknown): error is RedirectSignal {\n return hasBrand(error, REDIRECT_BRAND);\n}\n\n/**\n * True for any `SsrStreamError`. This one also crosses Vite environments:\n * it is thrown in SSR and caught in RSC, which are separate module graphs in\n * the same process — the brand is the only identity the two share.\n */\nexport function isSsrStreamError(error: unknown): error is SsrStreamError {\n return hasBrand(error, SSR_STREAM_ERROR_BRAND);\n}\n\n/**\n * Returns true if the error is a framework control-flow signal (RedirectSignal\n * or DenySignal) rather than a genuine application error. Works both for direct\n * instances (RSC-side) and deserialized digest errors (SSR cross-boundary).\n *\n * See also: isFrameworkSignalError() in client/browser-dev.ts (client-only).\n */\nexport function isControlFlowSignal(error: unknown): boolean {\n if (isDenySignal(error) || isRedirectSignal(error)) {\n return true;\n }\n return signalDigest(error) !== null;\n}\n\n/**\n * The HTTP status a control-flow signal answers with: a signal's own, or the\n * one its digest carries once revived on the SSR side. `undefined` for\n * anything that is not a signal.\n */\nexport function controlFlowStatus(error: unknown): number | undefined {\n if (isDenySignal(error) || isRedirectSignal(error)) return error.status;\n const status = signalDigest(error)?.status;\n return typeof status === 'number' ? status : undefined;\n}\n\n/** A revived signal's parsed digest (`rsc-stream.ts` writes it), or null. */\nfunction signalDigest(error: unknown): { type: 'deny' | 'redirect'; status?: unknown } | null {\n if (!error || typeof error !== 'object') return null;\n const digest = (error as { digest?: unknown }).digest;\n if (typeof digest !== 'string') return null;\n try {\n const parsed = JSON.parse(digest) as { type?: unknown; status?: unknown } | null;\n if (\n parsed &&\n typeof parsed === 'object' &&\n (parsed.type === 'redirect' || parsed.type === 'deny')\n ) {\n return { type: parsed.type, status: parsed.status };\n }\n } catch {\n // Not valid digest JSON\n }\n return null;\n}\n\n// ─── SsrStreamError ─────────────────────────────────────────────────────────\n\n/**\n * Error thrown when SSR's renderToReadableStream fails due to an error\n * in the decoded RSC stream (e.g., uncontained slot errors).\n *\n * The RSC entry checks for this error type in its catch block. A captured\n * deny or redirect is rethrown to the pipeline first; with no captured\n * signal, it renders the error page for the uncontained error.\n *\n * Not defined in ssr-entry.ts because ssr-entry.ts imports react-dom/server,\n * which cannot be loaded in the RSC environment.\n *\n * Detect with `isSsrStreamError()` — it is thrown in the SSR environment and\n * caught in RSC, so `instanceof` never matches. See \"Signal branding\" above.\n */\nexport class SsrStreamError extends Error {\n readonly [SSR_STREAM_ERROR_BRAND] = true;\n override readonly cause: unknown;\n\n constructor(message: string, cause: unknown) {\n super(message);\n this.name = 'SsrStreamError';\n this.cause = cause;\n }\n}\n","/**\n * Tracing — per-request trace ID via AsyncLocalStorage, OTEL span helpers.\n *\n * getTraceId() is always available in server code (middleware, access, components, actions).\n * Returns a 32-char lowercase hex string — the OTEL trace ID when an SDK is active,\n * or a crypto.randomUUID()-derived fallback otherwise.\n *\n * See design/17-logging.md §\"trace_id is Always Set\"\n */\n\nimport { randomUUID } from 'node:crypto';\nimport { trace, SpanStatusCode, type Span, type Tracer } from '@opentelemetry/api';\nimport { traceAls, type TraceStore } from './als-registry.ts';\nimport { controlFlowStatus, isSsrStreamError } from './signal-identity.ts';\n\n// Re-export the TraceStore type for public API consumers.\nexport type { TraceStore } from './als-registry.ts';\n\n// ─── Public API ───────────────────────────────────────────────────────────\n\n/**\n * Returns the current request's trace ID — always a 32-char lowercase hex string.\n *\n * With OTEL: the real OTEL trace ID (matches Jaeger/Honeycomb/Datadog).\n * Without OTEL: crypto.randomUUID() with hyphens stripped.\n *\n * Throws if called outside a request context (no ALS store).\n */\nexport function getTraceId(): string {\n const store = traceAls.getStore();\n if (!store) {\n throw new Error(\n '[timber] getTraceId() called outside of a request context. ' +\n 'It can only be used in middleware, access checks, server components, and server actions.'\n );\n }\n return store.request.traceId;\n}\n\n/**\n * Returns the current OTEL span ID if available, undefined otherwise.\n */\nexport function getSpanId(): string | undefined {\n return traceAls.getStore()?.spanId;\n}\n\n// ─── Framework-Internal Helpers ───────────────────────────────────────────\n\n/**\n * Generate a 32-char lowercase hex ID from crypto.randomUUID().\n * Same format as OTEL trace IDs — zero-friction upgrade path.\n */\nexport function generateTraceId(): string {\n return randomUUID().replace(/-/g, '');\n}\n\n/**\n * Run a callback within a trace context. Used by the pipeline to establish\n * per-request ALS scope.\n */\nexport function runWithTraceId<T>(id: string, fn: () => T): T {\n return traceAls.run({ request: { traceId: id } }, fn);\n}\n\n/**\n * Replace the request's trace ID. Used when OTEL creates the root span and\n * we want to switch from the UUID fallback to the real OTEL trace ID. Writes\n * the request's shared trace, so every scope in the request sees it —\n * including the ones outside the span this runs in.\n */\nexport function replaceTraceId(newTraceId: string): void {\n const store = traceAls.getStore();\n if (store) {\n store.request.traceId = newTraceId;\n }\n}\n\n/**\n * Run `fn` in a new trace scope for one span: the enclosing scope's request\n * trace, with this span's pointers. A scope per span, not a save/restore on\n * a shared store — spans overlap (MetadataCollector does not await\n * `timber.metadata`), and a restore that runs after a sibling's would\n * leave the sibling's pointer behind (TIM-1538).\n */\nfunction runInSpanScope<T>(\n pointers: Pick<TraceStore, 'spanId'> | Pick<TraceStore, 'platformSpan'>,\n fn: () => T\n): T {\n const store = traceAls.getStore();\n return store ? traceAls.run({ ...store, ...pointers }, fn) : fn();\n}\n\n/**\n * Get the current trace store, or undefined if outside a request context.\n * Framework-internal — use getTraceId()/getSpanId() in user code.\n */\nexport function getTraceStore(): TraceStore | undefined {\n return traceAls.getStore();\n}\n\n// ─── Dev-Mode OTEL Auto-Init ─────────────────────────────────────────────\n\n/**\n * Well-known key marking dev tracing as initialized.\n *\n * The RSC entry module re-evaluates on every HMR invalidation and calls\n * initDevTracing() again — without this guard, each call would register a\n * fresh provider/processor and duplicate every span's output. Symbol.for()\n * survives module re-evaluation. See TIM-1067, B49.\n */\nconst DEV_TRACING_INIT_KEY = Symbol.for('timber.dev.tracing-initialized');\n\n/**\n * Initialize a minimal OTEL SDK in dev mode so spans are recorded and\n * fed to the DevSpanProcessor for dev log output.\n *\n * If the user already configured an OTEL SDK in register(), we add\n * our DevSpanProcessor alongside theirs. If no SDK is configured,\n * we create a BasicTracerProvider with our processor.\n *\n * Idempotent across module re-evaluations (HMR) — only the first call\n * registers. Called in dev, and in production only when TIMBER_DEBUG is\n * set — otherwise production never loads the OTEL SDK.\n */\nexport async function initDevTracing(\n config: import('../dev-tools/logger.ts').DevLoggerConfig\n): Promise<void> {\n const globals = globalThis as Record<symbol, unknown>;\n if (globals[DEV_TRACING_INIT_KEY]) return;\n\n // Tracing is a diagnostic: any failure to load or construct the SDK\n // disables it with a warning and never fails the server's boot (TIM-1554).\n try {\n const { registerDevTracing } = await import('../dev-tools/instrumentation.ts');\n registerDevTracing(config);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n console.warn(`[timber] Dev tracing disabled — failed to set up OTEL:\\n ${msg}`);\n return;\n }\n\n globals[DEV_TRACING_INIT_KEY] = true;\n}\n\n// ─── Platform Tracer ─────────────────────────────────────────────────────\n\n/**\n * A native platform span. Mirrors the subset of the Cloudflare Workers\n * `Span` API that timber uses. See design/17-logging.md §\"Cloudflare Native\n * Spans\" and TIM-1135.\n */\nexport interface PlatformSpan {\n setAttribute(key: string, value: string | number | boolean): void;\n}\n\n/**\n * Adapter-provided native tracer. Callback-scoped like Cloudflare's\n * `tracing.enterSpan()` — the span starts when the callback is invoked and\n * ends when it returns or its promise settles. Nesting follows the\n * platform's async context.\n *\n * When registered, withSpan() wraps every framework span in a native span\n * *in addition to* the OTEL emission — dual emission, so external OTEL\n * collectors keep working alongside the platform's native trace view.\n *\n * Register via setPlatformTracer(), or by writing the\n * Symbol.for('timber:platform-tracer') key on globalThis from\n * adapter-generated entry code (what the Cloudflare _worker.js does).\n */\nexport interface PlatformTracer {\n enterSpan<T>(name: string, fn: (span: PlatformSpan) => T): T;\n}\n\n// globalThis + Symbol.for so a tracer registered by adapter-generated entry\n// code (a separate module instance) is visible in both the RSC and SSR\n// environments — same pattern as the cf-bindings ALS.\nconst PLATFORM_TRACER_KEY = Symbol.for('timber:platform-tracer');\n\n/** Register (or clear) the native platform tracer for this runtime. */\nexport function setPlatformTracer(tracer: PlatformTracer | undefined): void {\n (globalThis as Record<symbol, unknown>)[PLATFORM_TRACER_KEY] = tracer;\n}\n\n/** The registered native platform tracer, if any. */\nexport function getPlatformTracer(): PlatformTracer | undefined {\n return (globalThis as Record<symbol, unknown>)[PLATFORM_TRACER_KEY] as PlatformTracer | undefined;\n}\n\n// ─── OTEL Span Helpers ───────────────────────────────────────────────────\n\n/**\n * The timber.js OTEL tracer.\n *\n * `@opentelemetry/api` is a direct dependency and a no-op until an SDK\n * registers a provider (the user's `register()`, or dev tracing). Imported\n * statically, not lazily, so `withSpan()` can invoke its callback in the\n * same synchronous frame it was called in: a server component wrapped in a\n * span (`timber.page`, `timber.layout`) must run while React's render\n * dispatcher is still set, or a synchronous component that calls `use()`\n * fails with an invalid hook call. Looked up per span — the API's proxy\n * tracer follows a provider registered after boot.\n */\nfunction getTracer(): Tracer {\n return trace.getTracer('timber.js');\n}\n\n/**\n * Run a function within a framework span. Composes two emission channels:\n *\n * - **Native platform span** — when an adapter registered a PlatformTracer\n * (Cloudflare Workers), the fn is wrapped in platformTracer.enterSpan()\n * so it appears in the platform's native trace view.\n * - **OTEL span** — when an OTEL SDK is active, the fn also runs inside an\n * OTEL span (dual emission). With no SDK the OTEL span is the API's\n * non-recording no-op.\n *\n * Automatically:\n * - Invokes fn synchronously, in the caller's frame — a wrapped server\n * component still sees React's render dispatcher (see getTracer())\n * - Creates the span as a child of the current context\n * - Runs fn in its own trace scope carrying the span's IDs, for log–trace\n * correlation and setSpanAttribute()\n * - Ends the span when the function completes\n * - Records exceptions on error (OTEL channel)\n */\nexport async function withSpan<T>(\n name: string,\n attributes: Record<string, string | number | boolean>,\n fn: () => T | PromiseLike<T>\n): Promise<T> {\n return traceCall(name, attributes, fn);\n}\n\n/**\n * The span core of {@link withSpan}, keeping the shape of the call: `fn` runs\n * synchronously, a value it returns comes back as that value, a promise as a\n * promise, and a synchronous throw is rethrown synchronously.\n *\n * For a framework wrapper that invokes a server component inside a span.\n * React drives a synchronous component through throws: `use()` on a pending\n * promise throws, and Flight retries the component once it settles. That only\n * works if the throw leaves the wrapper synchronously — `withSpan()` would\n * turn it into a rejection, which Flight reports as a render error.\n */\nexport function traceCall<T>(\n name: string,\n attributes: Record<string, string | number | boolean>,\n fn: () => T | PromiseLike<T>\n): T | Promise<T> {\n const platformTracer = getPlatformTracer();\n if (!platformTracer) {\n return runOtelSpan(name, attributes, fn);\n }\n\n // Native platform span wraps the OTEL emission (dual emission). The\n // span is tracked on its own trace scope so setSpanAttribute() can reach\n // it after creation — the platform API has no getActiveSpan() equivalent.\n return platformTracer.enterSpan(name, (span) => {\n for (const key of Object.keys(attributes)) {\n span.setAttribute(key, attributes[key]);\n }\n return runInSpanScope({ platformSpan: span }, () => runOtelSpan(name, attributes, fn));\n });\n}\n\n/**\n * The OTEL half of withSpan() — a non-recording span when no SDK is active.\n * Calls `fn` synchronously; see {@link getTracer}.\n */\nfunction runOtelSpan<T>(\n name: string,\n attributes: Record<string, string | number | boolean>,\n fn: () => T | PromiseLike<T>\n): T | Promise<T> {\n return getTracer().startActiveSpan(name, { attributes }, (span) =>\n runInSpanScope({ spanId: span.spanContext().spanId }, () => settleOtelSpan(span, fn))\n );\n}\n\n/**\n * True when `error` is a `redirect()`, or a `deny()` below 500: an outcome the\n * span observed, not a failure. Such a span ends with its status unset and no\n * exception event, so an OTEL backend does not count every 404 from an access\n * check, a page, a layout or a metadata() as an error (TIM-1597). A\n * `deny(5xx)` is a server failure by HTTP's own account and stays an error.\n *\n * SSR wraps the revived signal its shell failed on in an `SsrStreamError`;\n * the cause is the outcome, so `timber.ssr` follows the same rule.\n */\nfunction isOutcomeSignal(error: unknown): boolean {\n const status = controlFlowStatus(isSsrStreamError(error) ? error.cause : error);\n return status !== undefined && status < 500;\n}\n\n/**\n * Run `fn` and end `span` with its outcome (see {@link isOutcomeSignal}),\n * keeping the call's shape (see {@link traceCall}).\n */\nfunction settleOtelSpan<T>(span: Span, fn: () => T | PromiseLike<T>): T | Promise<T> {\n let result: T | PromiseLike<T>;\n try {\n result = fn();\n } catch (error) {\n endSpanWithError(span, error);\n throw error;\n }\n if (isPlainPromise(result)) {\n // One promise, not two: a plain native promise's `then` cannot throw or\n // run work, so the wrapper below would only add a promise. Dev tracing\n // pays for every promise made inside a render (React's async debug hook\n // captures a stack for each), ~10µs per traced call (TIM-1627).\n return result.then(\n (value) => {\n endSpanOk(span);\n return value;\n },\n (error: unknown) => {\n endSpanWithError(span, error);\n throw error;\n }\n );\n }\n if (isPromiseLike(result)) {\n // Any thenable, not only a native Promise — a custom or cross-realm one\n // must hold the span open too, as `await` would. Its `then` is called\n // here, synchronously, so a lazy thenable starts its work in this span.\n const thenable = result;\n return new Promise<T>((resolve, reject) => {\n const fail = (error: unknown) => {\n endSpanWithError(span, error);\n reject(error);\n };\n try {\n thenable.then((value) => {\n endSpanOk(span);\n resolve(value);\n }, fail);\n } catch (error) {\n // A `then` that throws is a rejection, as for `await`; end the span.\n fail(error);\n }\n });\n }\n endSpanOk(span);\n return result;\n}\n\n/**\n * A native promise of this realm whose `then` is the built-in one: neither a\n * subclass (its `then` may be overridden, and its `then()` constructs the\n * subclass) nor an instance with its own `then` property.\n */\nfunction isPlainPromise<T>(value: T | PromiseLike<T>): value is Promise<T> {\n return (\n value instanceof Promise &&\n Object.getPrototypeOf(value) === Promise.prototype &&\n !Object.hasOwn(value, 'then')\n );\n}\n\nfunction isPromiseLike<T>(value: T | PromiseLike<T>): value is PromiseLike<T> {\n return (\n (typeof value === 'object' || typeof value === 'function') &&\n value !== null &&\n 'then' in value &&\n typeof value.then === 'function'\n );\n}\n\nfunction endSpanOk(span: Span): void {\n span.setStatus({ code: SpanStatusCode.OK });\n span.end();\n}\n\n/**\n * True when `error` is React suspending the component, not failing it: a\n * thrown thenable, or the `SuspenseException` that `use()` throws on a\n * pending promise. Flight retries the component once the promise settles, so\n * a span around a synchronous component (see {@link traceCall}) that suspends\n * is not an error span — the retry's span carries the real outcome.\n *\n * React does not export `SuspenseException`; Flight recognises it by\n * identity, and its message — which React keeps stable because it is the\n * user-facing explanation when one is caught by mistake — is the only handle\n * outside React.\n */\nfunction isReactSuspension(error: unknown): boolean {\n if (typeof error !== 'object' || error === null) return false;\n if ('then' in error && typeof error.then === 'function') return true;\n return error instanceof Error && error.message.startsWith('Suspense Exception:');\n}\n\nfunction endSpanWithError(span: Span, error: unknown): void {\n if (!isOutcomeSignal(error) && !isReactSuspension(error)) {\n span.setStatus({ code: SpanStatusCode.ERROR });\n if (error instanceof Error) {\n span.recordException(error);\n }\n }\n span.end();\n}\n\n/**\n * Set an attribute on the current active span (if any).\n * Used for setting span attributes after span creation (e.g. timber.result on access spans).\n */\nexport async function setSpanAttribute(\n key: string,\n value: string | number | boolean\n): Promise<void> {\n // Forward to the innermost active native platform span, if any.\n const platformSpan = traceAls.getStore()?.platformSpan;\n if (platformSpan) {\n platformSpan.setAttribute(key, value);\n }\n\n const activeSpan = trace.getActiveSpan();\n if (activeSpan?.isRecording()) {\n activeSpan.setAttribute(key, value);\n }\n}\n\n/**\n * Add a span event to the current active span (if any).\n * Used for timber.cache HIT/MISS events — recorded as span events, not child spans.\n */\nexport async function addSpanEvent(\n name: string,\n attributes?: Record<string, string | number | boolean>\n): Promise<void> {\n const activeSpan = trace.getActiveSpan();\n if (activeSpan?.isRecording()) {\n activeSpan.addEvent(name, attributes);\n }\n}\n\n/**\n * Fire-and-forget span event — no await, no microtask overhead.\n *\n * Used on the cache hot path where awaiting addSpanEvent creates an\n * unnecessary microtask per cache operation.\n *\n * See TIM-370 for perf motivation.\n */\nexport function addSpanEventSync(\n name: string,\n attributes?: Record<string, string | number | boolean>\n): void {\n const activeSpan = trace.getActiveSpan();\n if (activeSpan?.isRecording()) {\n activeSpan.addEvent(name, attributes);\n }\n}\n\n/**\n * Try to extract the OTEL trace ID from the current active span context.\n * Returns undefined if OTEL is not active or no span exists. (The span ID\n * reaches logs through the span's own trace scope, not from here.)\n */\nexport async function getOtelTraceId(): Promise<string | undefined> {\n const activeSpan = trace.getActiveSpan();\n if (!activeSpan) return undefined;\n\n const ctx = activeSpan.spanContext();\n // OTEL uses \"0000000000000000\" as invalid trace IDs\n if (!ctx.traceId || ctx.traceId === '00000000000000000000000000000000') {\n return undefined;\n }\n\n return ctx.traceId;\n}\n","/**\n * Runtime debug flag for timber.js.\n *\n * Two distinct functions for two distinct security levels:\n *\n * ## `isDebug()` — server-side logging only\n *\n * Returns true when timber's debug/warning messages should be written to\n * stderr / the server console. This NEVER affects what is sent to the\n * client (no error details, no timing headers, no stack traces).\n *\n * Active when any of:\n * - `NODE_ENV !== 'production'` (standard dev mode)\n * - `TIMBER_DEBUG` env var is set to a truthy value at runtime\n * - `timber.config.ts` has `debug: true`\n *\n * ## `isDevMode()` — client-visible dev behavior\n *\n * Returns true ONLY when `NODE_ENV !== 'production'`. This gates anything\n * that changes what clients can observe:\n * - Dev error pages with stack traces (fallback-error.ts)\n * - Detailed Server-Timing headers (pipeline.ts)\n * - Error messages in action INTERNAL_ERROR payloads (action-client.ts)\n * - Pipeline error handler wiring (Vite overlay)\n *\n * `isDevMode()` is statically replaced in production builds → the guarded\n * code is tree-shaken to zero bytes. TIMBER_DEBUG cannot enable it.\n *\n * Usage:\n * In Cloudflare Workers wrangler.toml:\n * [vars]\n * TIMBER_DEBUG = \"1\"\n *\n * In Node.js:\n * TIMBER_DEBUG=1 node server.js\n *\n * In timber.config.ts:\n * export default { debug: true }\n *\n * See design/13-security.md for the security taxonomy.\n * See design/18-build-system.md for build pipeline details.\n */\n\n// ─── Dev Mode (client-visible) ──────────────────────────────────────────────\n\n/**\n * Check if the application is running in development mode.\n *\n * This is the ONLY function that should gate client-visible dev behavior:\n * - Dev error pages with stack traces\n * - Error messages in action `INTERNAL_ERROR` payloads\n * - Pipeline error handler wiring (Vite overlay)\n *\n * Returns `process.env.NODE_ENV !== 'production'`, which is statically\n * replaced by the bundler in production builds. Code guarded by this\n * function is tree-shaken to zero bytes in production.\n *\n * TIMBER_DEBUG does NOT enable this — that would leak server internals\n * to clients. Use `isDebug()` for server-side-only logging.\n */\nexport function isDevMode(): boolean {\n return process.env.NODE_ENV !== 'production';\n}\n\n// ─── Debug Flag (server-side logging only) ──────────────────────────────────\n\n/**\n * Config-level debug override. Set via `setDebugFromConfig()` during\n * initialization when timber.config.ts has `debug: true`.\n */\nlet _configDebug = false;\n\n/**\n * Set the debug flag from timber.config.ts.\n * Called during handler initialization.\n */\nexport function setDebugFromConfig(debug: boolean): void {\n _configDebug = debug;\n}\n\n/**\n * Check if timber debug logging is active (server-side only).\n *\n * Returns true if ANY of these conditions hold:\n * - NODE_ENV is not 'production' (standard dev mode)\n * - TIMBER_DEBUG environment variable is set to a truthy value at runtime\n * - timber.config.ts has `debug: true`\n *\n * This function controls ONLY server-side logging — messages written to\n * stderr or the server console. It NEVER affects client-visible behavior\n * (error pages, response headers, action payloads). For client-visible\n * behavior, use `isDevMode()`.\n *\n * The TIMBER_DEBUG check is deliberately written as a dynamic property\n * access so bundlers cannot statically replace it.\n */\nexport function isDebug(): boolean {\n // Fast path: dev mode (statically replaced to `true` in dev, `false` in prod)\n if (process.env.NODE_ENV !== 'production') return true;\n\n // Config override\n if (_configDebug) return true;\n\n // Runtime env var check — uses dynamic access to prevent static replacement.\n // In production builds, process.env.NODE_ENV is statically replaced, but\n // TIMBER_DEBUG must survive as a runtime check. The dynamic key access\n // pattern ensures the bundler treats this as opaque.\n return _readTimberDebugEnv();\n}\n\n/**\n * Read TIMBER_DEBUG from the environment at runtime.\n *\n * Extracted to a separate function to:\n * 1. Prevent bundler inlining (cross-module function calls are not inlined)\n * 2. Handle platforms where `process` may not exist (Cloudflare Workers)\n * 3. Support globalThis.__TIMBER_DEBUG for programmatic control\n */\nfunction _readTimberDebugEnv(): boolean {\n // globalThis override — useful for programmatic control and testing\n if ((globalThis as Record<string, unknown>).__TIMBER_DEBUG) return true;\n\n // process.env — works in Node.js and platforms that polyfill process\n try {\n const key = 'TIMBER_DEBUG';\n const val =\n typeof process !== 'undefined' && process.env\n ? (process.env as Record<string, string | undefined>)[key]\n : undefined;\n if (val && val !== '0' && val !== 'false') return true;\n } catch {\n // process may not exist or env may throw — safe to ignore\n }\n\n return false;\n}\n","/**\n * Error Formatter — rewrites SSR/RSC error messages to surface user code.\n *\n * When React or Vite throw errors during SSR, stack traces reference\n * vendored dependency paths (e.g. `.vite/deps_ssr/@vitejs_plugin-rsc_vendor_...`)\n * and mangled export names (`__vite_ssr_export_default__`). This module\n * rewrites error messages and stack traces to point at user code instead.\n *\n * Dev-only — in production, errors go through the structured logger\n * without formatting.\n */\n\n// ─── Stack Trace Rewriting ──────────────────────────────────────────────────\n\n/**\n * Patterns that identify internal Vite/RSC vendor paths in stack traces.\n * These are replaced with human-readable labels.\n */\nconst VENDOR_PATH_PATTERNS: Array<{ pattern: RegExp; replacement: string }> = [\n {\n pattern: /node_modules\\/\\.vite\\/deps_ssr\\/@vitejs_plugin-rsc_vendor_react-server-dom[^\\s)]+/g,\n replacement: '<react-server-dom>',\n },\n {\n pattern: /node_modules\\/\\.vite\\/deps_ssr\\/@vitejs_plugin-rsc_vendor[^\\s)]+/g,\n replacement: '<rsc-vendor>',\n },\n {\n pattern: /node_modules\\/\\.vite\\/deps_ssr\\/[^\\s)]+/g,\n replacement: '<vite-dep>',\n },\n {\n pattern: /node_modules\\/\\.vite\\/deps\\/[^\\s)]+/g,\n replacement: '<vite-dep>',\n },\n];\n\n/**\n * Patterns that identify Vite-mangled export names in error messages.\n */\nconst MANGLED_NAME_PATTERNS: Array<{ pattern: RegExp; replacement: string }> = [\n {\n pattern: /__vite_ssr_export_default__/g,\n replacement: '<default export>',\n },\n {\n pattern: /__vite_ssr_export_(\\w+)__/g,\n replacement: '<export $1>',\n },\n];\n\n/**\n * Rewrite an error's message and stack to replace internal Vite paths\n * and mangled names with human-readable labels.\n */\nexport function formatSsrError(error: unknown): string {\n if (!(error instanceof Error)) {\n return String(error);\n }\n\n let message = error.message;\n let stack = error.stack ?? '';\n\n // Rewrite mangled names in the message\n for (const { pattern, replacement } of MANGLED_NAME_PATTERNS) {\n message = message.replace(pattern, replacement);\n }\n\n // Rewrite vendor paths in the stack\n for (const { pattern, replacement } of VENDOR_PATH_PATTERNS) {\n stack = stack.replace(pattern, replacement);\n }\n\n // Rewrite mangled names in the stack too\n for (const { pattern, replacement } of MANGLED_NAME_PATTERNS) {\n stack = stack.replace(pattern, replacement);\n }\n\n // Extract hints from React-specific error patterns\n const hint = extractErrorHint(error.message);\n\n // Build formatted output: cleaned message, hint (if any), then cleaned stack\n const parts: string[] = [];\n parts.push(message);\n if (hint) {\n parts.push(` → ${hint}`);\n }\n\n // Include only the user-code frames from the stack (skip the first line\n // which is the message itself, and filter out vendor-only frames)\n const userFrames = extractUserFrames(stack);\n if (userFrames.length > 0) {\n parts.push('');\n parts.push(' User code in stack:');\n for (const frame of userFrames) {\n parts.push(` ${frame}`);\n }\n }\n\n return parts.join('\\n');\n}\n\n// ─── Error Hint Extraction ──────────────────────────────────────────────────\n\n/**\n * Extract a human-readable hint from common React/RSC error messages.\n *\n * React error messages contain useful information but the surrounding\n * context (vendor paths, mangled names) obscures it. This extracts the\n * actionable part as a one-line hint.\n */\nfunction extractErrorHint(message: string): string | null {\n // \"Functions cannot be passed directly to Client Components\"\n // Extract the component and prop name from the JSX-like syntax in the message\n const fnPassedMatch = message.match(/Functions cannot be passed directly to Client Components/);\n if (fnPassedMatch) {\n // Try to extract the prop name from the message\n // React formats: <... propName={function ...} ...>\n const propMatch = message.match(/<[^>]*?\\s(\\w+)=\\{function/);\n if (propMatch) {\n return `Prop \"${propMatch[1]}\" is a function — mark it \"use server\" or call it before passing`;\n }\n return 'A function prop was passed to a Client Component — mark it \"use server\" or call it before passing';\n }\n\n // \"Objects are not valid as a React child\"\n if (message.includes('Objects are not valid as a React child')) {\n return 'An object was rendered as JSX children — convert to string or extract the value';\n }\n\n // \"Cannot read properties of undefined/null\"\n const nullRefMatch = message.match(\n /Cannot read propert(?:y|ies) of (undefined|null) \\(reading '(\\w+)'\\)/\n );\n if (nullRefMatch) {\n return `Accessed .${nullRefMatch[2]} on ${nullRefMatch[1]} — check that the value exists`;\n }\n\n // \"X is not a function\"\n const notFnMatch = message.match(/(\\w+) is not a function/);\n if (notFnMatch) {\n return `\"${notFnMatch[1]}\" is not a function — check imports and exports`;\n }\n\n // \"Element type is invalid\"\n if (message.includes('Element type is invalid')) {\n return 'A component resolved to undefined/null — check default exports and import paths';\n }\n\n // \"Invalid hook call\" — hooks called outside React's render context.\n // In RSC, this typically means a 'use client' component was executed as a\n // server component instead of being serialized as a client reference.\n if (message.includes('Invalid hook call')) {\n return (\n 'A hook was called outside of a React component render. ' +\n \"If this is a 'use client' component, ensure the directive is at the very top of the file \" +\n '(before any imports) and that @vitejs/plugin-rsc is loaded correctly. ' +\n \"Barrel re-exports from non-'use client' files do not propagate the directive.\"\n );\n }\n\n return null;\n}\n\n// ─── Stack Frame Filtering ──────────────────────────────────────────────────\n\n/**\n * Extract stack frames that reference user code (not node_modules,\n * not framework internals).\n *\n * Returns at most 5 frames to keep output concise.\n */\nfunction extractUserFrames(stack: string): string[] {\n const lines = stack.split('\\n');\n const userFrames: string[] = [];\n\n for (const line of lines) {\n const trimmed = line.trim();\n // Skip non-frame lines\n if (!trimmed.startsWith('at ')) continue;\n // Skip node_modules, vendor, and internal frames\n if (\n trimmed.includes('node_modules') ||\n trimmed.includes('<react-server-dom>') ||\n trimmed.includes('<rsc-vendor>') ||\n trimmed.includes('<vite-dep>') ||\n trimmed.includes('node:internal')\n ) {\n continue;\n }\n userFrames.push(trimmed);\n if (userFrames.length >= 5) break;\n }\n\n return userFrames;\n}\n","/**\n * DefaultLogger — human-readable stderr logging when no custom logger is configured.\n *\n * Ships as the fallback so production deployments always have error visibility,\n * even without an `instrumentation.ts` logger export. Output is one line per\n * event, designed for `fly logs`, `kubectl logs`, Cloudflare dashboard tails, etc.\n *\n * Format:\n * [timber] ERROR message key=value key=value trace_id=4bf92f35\n * [timber] WARN message key=value key=value trace_id=4bf92f35\n * [timber] INFO message method=GET path=/dashboard status=200 durationMs=43 trace_id=4bf92f35\n *\n * Behavior:\n * - `info` and `debug` suppressed in dev mode (dev logging handles them);\n * `warn` and `error` are always written (TIM-555)\n * - `debug` suppressed unless TIMBER_DEBUG is set\n * - Replaced entirely when a custom logger is set via `setLogger()`\n *\n * See design/17-logging.md §\"DefaultLogger\"\n */\n\nimport { isDevMode, isDebug } from './debug.ts';\nimport { formatSsrError } from './error-formatter.ts';\nimport type { TimberLogger } from './logger.ts';\n\n/**\n * Format data fields as `key=value` pairs for human-readable output.\n * - `error` key is serialized via formatSsrError for stack trace cleanup\n * - `trace_id` is truncated to 8 chars for readability (full ID in OTEL)\n * - Other values are stringified inline\n */\nfunction formatDataFields(data?: Record<string, unknown>): string {\n if (!data) return '';\n\n const parts: string[] = [];\n let traceId: string | undefined;\n\n for (const [key, value] of Object.entries(data)) {\n if (key === 'trace_id') {\n // Defer trace_id to the end\n traceId = typeof value === 'string' ? value : String(value);\n continue;\n }\n if (key === 'error') {\n // Serialize errors with formatSsrError for clean output\n parts.push(`error=${formatSsrError(value)}`);\n continue;\n }\n if (value === undefined || value === null) continue;\n parts.push(`${key}=${value}`);\n }\n\n // trace_id always last, truncated to 8 chars for readability\n if (traceId) {\n parts.push(`trace_id=${traceId.slice(0, 8)}`);\n }\n\n return parts.length > 0 ? ' ' + parts.join(' ') : '';\n}\n\n/** Pad level string to fixed width for alignment. */\nfunction padLevel(level: string): string {\n return level.padEnd(5);\n}\n\nexport function createDefaultLogger(): TimberLogger {\n return {\n error(msg: string, data?: Record<string, unknown>): void {\n // Errors are ALWAYS logged, including dev mode. Suppressing errors\n // in dev causes silent 500s with no stack trace, making route.ts\n // and render errors impossible to debug. See TIM-555.\n const fields = formatDataFields(data);\n process.stderr.write(`[timber] ${padLevel('ERROR')} ${msg}${fields}\\n`);\n },\n\n warn(msg: string, data?: Record<string, unknown>): void {\n // Warnings are always logged — same rationale as errors.\n const fields = formatDataFields(data);\n process.stderr.write(`[timber] ${padLevel('WARN')} ${msg}${fields}\\n`);\n },\n\n info(msg: string, data?: Record<string, unknown>): void {\n // info is suppressed by default — per-request lines are too noisy\n // without a custom logger. Enable with TIMBER_DEBUG.\n if (isDevMode()) return;\n if (!isDebug()) return;\n const fields = formatDataFields(data);\n process.stderr.write(`[timber] ${padLevel('INFO')} ${msg}${fields}\\n`);\n },\n\n debug(msg: string, data?: Record<string, unknown>): void {\n // debug is suppressed in dev (dev logger handles it) and in\n // production unless TIMBER_DEBUG is explicitly set.\n if (isDevMode()) return;\n if (!isDebug()) return;\n const fields = formatDataFields(data);\n process.stderr.write(`[timber] ${padLevel('DEBUG')} ${msg}${fields}\\n`);\n },\n };\n}\n","/**\n * Logger — structured logging with environment-aware formatting.\n *\n * timber.js ships a DefaultLogger that writes human-readable lines to stderr\n * in production. Users can export a custom logger from instrumentation.ts to\n * replace it with pino, winston, or any TimberLogger-compatible object.\n *\n * See design/17-logging.md §\"Production Logging\"\n */\n\nimport { generateTraceId, getTraceStore } from './tracing.ts';\nimport { createDefaultLogger } from './default-logger.ts';\nimport { isDevMode } from './debug.ts';\nimport { isControlFlowSignal } from './signal-identity.ts';\nimport type { CsrfRejectReason } from './csrf.ts';\n\n// ─── Logger Interface ─────────────────────────────────────────────────────\n\n/** Any object with standard log methods satisfies this — pino, winston, consola, console. */\nexport interface TimberLogger {\n info(msg: string, data?: Record<string, unknown>): void;\n warn(msg: string, data?: Record<string, unknown>): void;\n error(msg: string, data?: Record<string, unknown>): void;\n debug(msg: string, data?: Record<string, unknown>): void;\n}\n\n// ─── Logger Registry ──────────────────────────────────────────────────────\n\n// Initialize with DefaultLogger so production errors are never silent.\n// Replaced when setLogger() is called from instrumentation.ts.\nlet _logger: TimberLogger = createDefaultLogger();\n\n/**\n * Set the user-provided logger. Called by the instrumentation loader\n * when it finds a `logger` export in instrumentation.ts. Replaces\n * the DefaultLogger entirely.\n */\nexport function setLogger(logger: TimberLogger): void {\n _logger = logger;\n}\n\n/**\n * Get the current logger. Always non-null — returns DefaultLogger when\n * no custom logger is configured.\n */\nexport function getLogger(): TimberLogger {\n return _logger;\n}\n\n// ─── Framework Log Helpers ────────────────────────────────────────────────\n\n/**\n * Inject trace_id and span_id into log data for log–trace correlation.\n * Always injects trace_id (never undefined). Injects span_id only when OTEL is active.\n */\nfunction withTraceContext(data?: Record<string, unknown>): Record<string, unknown> {\n const store = getTraceStore();\n const enriched: Record<string, unknown> = { ...data };\n if (store) {\n enriched.trace_id = store.request.traceId;\n if (store.spanId) {\n enriched.span_id = store.spanId;\n }\n }\n return enriched;\n}\n\n// ─── Framework Event Emitters ─────────────────────────────────────────────\n\n/**\n * Log a CSRF rejection. Level: warn — the 403 body is deliberately terse,\n * so this line is the only place the rejected origin is visible (TIM-1459).\n * `detail` names the observed origin and, where one exists, the expected one.\n *\n * The gate runs inside the pipeline's trace scope, so the line carries the\n * request's `trace_id`. A caller outside any scope still gets one minted\n * here — the field is always present (design/17-logging.md §\"trace_id is\n * Always Set\").\n */\nexport function logCsrfRejected(\n detail: string,\n data: { method: string; path: string; reason: CsrfRejectReason }\n): void {\n const fields = withTraceContext(data);\n fields.trace_id ??= generateTraceId();\n _logger.warn(`CSRF origin check failed: ${detail}`, fields);\n}\n\n/** Log a completed request. Level: info. */\nexport function logRequestCompleted(data: {\n method: string;\n path: string;\n status: number;\n durationMs: number;\n /** Number of concurrent in-flight requests (including this one) at completion time. */\n concurrency?: number;\n}): void {\n _logger.info('request completed', withTraceContext(data));\n}\n\n/** Log request received. Level: debug. */\nexport function logRequestReceived(data: { method: string; path: string }): void {\n _logger.debug('request received', withTraceContext(data));\n}\n\n/** Log a slow request warning. Level: warn. */\nexport function logSlowRequest(data: {\n method: string;\n path: string;\n durationMs: number;\n threshold: number;\n /** Number of concurrent in-flight requests at the time the slow request completed. */\n concurrency?: number;\n}): void {\n _logger.warn('slow request exceeded threshold', withTraceContext(data));\n}\n\n/** Log middleware short-circuit. Level: debug. */\nexport function logMiddlewareShortCircuit(data: {\n method: string;\n path: string;\n status: number;\n}): void {\n _logger.debug('middleware short-circuited', withTraceContext(data));\n}\n\n/** Log unhandled error in middleware phase. Level: error. */\nexport function logMiddlewareError(data: { method: string; path: string; error: unknown }): void {\n if (isControlFlowSignal(data.error)) return;\n _logger.error('unhandled error in middleware phase', withTraceContext(data));\n}\n\n/** Log unhandled error in route setup (matching, param coercion). Level: error. */\nexport function logRouteSetupError(data: { method: string; path: string; error: unknown }): void {\n if (isControlFlowSignal(data.error)) return;\n _logger.error('unhandled error in route setup', withTraceContext(data));\n}\n\n/** Log unhandled render-phase error. Level: error. */\nexport function logRenderError(data: {\n method: string;\n path: string;\n error: unknown;\n errorId?: string;\n}): void {\n if (isControlFlowSignal(data.error)) return;\n _logger.error('unhandled render-phase error', withTraceContext(data));\n}\n\n/**\n * Log a status page, error page, `global-error.tsx` or fallback layout that\n * failed to load and was skipped: the next fallback tier answers in its place.\n * Level: error — a boundary that vanished is a bug in the app, even though the\n * request still gets a page. The caller writes it once per file and failure.\n */\nexport function logSkippedModule(data: {\n method: string;\n path: string;\n file: string;\n error: unknown;\n}): void {\n _logger.error('route file failed to load and was skipped', withTraceContext(data));\n}\n\n/** Log proxy.ts uncaught error. Level: error. */\nexport function logProxyError(data: { error: unknown }): void {\n _logger.error('proxy.ts threw uncaught error', withTraceContext(data));\n}\n\n/** Log unhandled error in server action. Level: error. */\nexport function logActionError(data: {\n method: string;\n path: string;\n error: unknown;\n errorId?: string;\n}): void {\n if (isControlFlowSignal(data.error)) return;\n _logger.error('unhandled server action error', withTraceContext(data));\n}\n\n/**\n * Log a server action request rejected as the client's mistake before the\n * action ran: a reference that does not exist, a body that will not decode.\n * Level: warn, with the reason but no stack — any client can send these, so\n * they must not read as server faults (TIM-1601).\n */\nexport function logActionRejected(data: {\n method: string;\n path: string;\n status: number;\n reason: string;\n}): void {\n _logger.warn('server action request rejected', withTraceContext(data));\n}\n\n/** Log unhandled error in route handler. Level: error. */\nexport function logRouteError(data: { method: string; path: string; error: unknown }): void {\n if (isControlFlowSignal(data.error)) return;\n _logger.error('unhandled route handler error', withTraceContext(data));\n}\n\n/** Log SSR streaming error (post-shell). Level: error. */\nexport function logStreamingError(data: { error: unknown }): void {\n _logger.error('SSR streaming error (post-shell)', withTraceContext(data));\n}\n\n/** Log waitUntil() adapter missing (once at startup). Level: warn. */\nexport function logWaitUntilUnsupported(): void {\n _logger.warn('adapter does not support waitUntil()');\n}\n\n/** Log waitUntil() promise rejection. Level: warn. */\nexport function logWaitUntilRejected(data: { error: unknown }): void {\n _logger.warn('waitUntil() promise rejected', withTraceContext(data));\n}\n\n/**\n * Log a cached value computed from request context its key leaves out\n * (design/45 §Enforcement). Level: error.\n */\nexport function logKeyDisciplineViolation(event: string, data: Record<string, unknown>): void {\n _logger.error(event, withTraceContext(data));\n}\n\n/** Log staleWhileRevalidate refetch failure. Level: warn. */\nexport function logSwrRefetchFailed(data: { cacheKey: string; error: unknown }): void {\n _logger.warn('staleWhileRevalidate refetch failed', withTraceContext(data));\n}\n\n/** Log a cache value that loses fidelity through JSON serialization. Level: warn. */\nexport function logLossyCacheValue(data: { cacheKey: string; types: string }): void {\n _logger.warn(\n 'cache value contains types that lose fidelity through JSON serialization in ' +\n 'Redis/KV cache handlers: Date becomes an ISO string, Map/Set become {}, BigInt throws. ' +\n 'The MemoryCacheHandler preserves them. Transform values to JSON-safe types before ' +\n 'caching, or use MemoryCacheHandler for values that require type preservation.',\n withTraceContext(data)\n );\n}\n\n/** Log cache miss. Level: debug. */\nexport function logCacheMiss(data: { cacheKey: string }): void {\n _logger.debug('timber.cache MISS', withTraceContext(data));\n}\n\n/**\n * Log a cache read that threw or timed out and was served as a miss.\n * Level: warn — the request still succeeds, but a failing store (Redis down,\n * KV erroring) means every read is paying for a live fetch.\n */\nexport function logCacheReadFailed(data: { cacheKey: string; error: unknown }): void {\n _logger.warn('cache read failed — treating as a miss', withTraceContext(data));\n}\n\n// ─── Swallow Helper ───────────────────────────────────────────────────────\n\n/**\n * Log an intentionally swallowed error. Provides observability into catch\n * blocks that are deliberately empty — the error is consumed, never rethrown.\n *\n * Default level: `warn` in dev (so the overlay surfaces patterns), `debug`\n * in production (low noise unless TIMBER_DEBUG is set). Pass `opts.level`\n * to override.\n *\n * **Infallible** — swallow() itself never throws, even if the logger is\n * broken. A thrown swallow would turn a benign catch into a crash.\n */\nexport function swallow(err: unknown, reason: string, opts?: { level?: 'debug' | 'warn' }): void {\n try {\n const level = opts?.level ?? (isDevMode() ? 'warn' : 'debug');\n _logger[level](`swallowed: ${reason}`, withTraceContext({ error: err }));\n } catch {\n // swallow() must never throw.\n }\n}\n"],"mappings":"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"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"scanner-CCEHN9Jg.js","names":[],"sources":["../../src/routing/collision-spaces.ts","../../src/routing/slot-placement.ts","../../src/routing/file-cache.ts","../../src/routing/export-detect.ts","../../src/routing/scanner.ts"],"sourcesContent":["/**\n * Route collision spaces.\n *\n * A collision space is a set of routes that compete for URLs with each other,\n * and there are three: the main tree, each parallel slot, and each intercepting\n * subtree. This module owns the first two; `interception.ts` owns the third.\n * All of them decide order-dependence with the one oracle in\n * `collision-probe.ts`, so they cannot drift on what counts as two routes\n * answering a single URL.\n *\n * See design/07-routing.md §\"Route Collisions\".\n */\n\nimport type { SegmentNode } from './types.ts';\nimport { computeInterceptedUrlBase } from './interception.ts';\nimport { findOrderDependentCollision, type ProbeLeaf } from './collision-probe.ts';\n\n/**\n * Validate that no two pages/routes in one collision space answer the same URL.\n *\n * Two route groups like (auth)/login/page.tsx and (marketing)/login/page.tsx both claim\n * /login — the scanner must detect and reject this at build time.\n *\n * Each parallel slot is validated as its OWN collision space: a slot's pages\n * intentionally share URL paths with the parent tree (that's the point of\n * parallel routes), but two route groups INSIDE one slot claiming the same\n * URL — e.g. @side/(a)/x/page.tsx + @side/(b)/x/page.tsx — still collide.\n */\nexport function validateRouteGroupCollisions(root: SegmentNode): void {\n validateCollisionSpace(root, '', root.urlPath);\n}\n\n/**\n * Validate one collision space — the main tree, or one parallel slot.\n *\n * **Two checks, and the difference between them matters.** Two leaves at the\n * same `urlPath` are decided by string equality, which is exact and needs no\n * probing: `(auth)/login` and `(marketing)/login` claim one set of URLs\n * whatever the precedence rules are, and naming the shared path is the clearest\n * thing to tell the author.\n *\n * Everything else is decided by asking the matcher, through the shared oracle\n * in `collision-probe.ts` (TIM-1308). Comparing `urlPath` spellings misses\n * every pair that matches the same URLs while being *spelled* differently:\n * `x/(a)/[id]` beside `x/(b)/[slug]` are two bare dynamics in one priority\n * tier, and `x/(a)/page.tsx` beside `x/(b)/[[...rest]]` both answer `/x`\n * because an optional catch-all also matches zero parts. Both built before\n * TIM-1308 with filesystem enumeration order deciding which page renders,\n * which is precisely what this validator and `validateAffixedSiblingConflicts`\n * exist to reject.\n *\n * Segment *kinds* stay distinct without any special-casing here, because the\n * oracle inherits `matchNode`'s priority ordering: `x/(a)/[id]` beside\n * `x/(b)/[...rest]` resolves the same way in either `children` order, so it is\n * not reported. So does an affixed sibling against a bare one; the\n * equal-specificity affix tie is `validateAffixedSiblingConflicts`' job, and\n * duplicating it here would double-report.\n */\nfunction validateCollisionSpace(spaceRoot: SegmentNode, segmentPath: string, base: string): void {\n const leaves: ProbeLeaf[] = [];\n collectRoutableLeaves(spaceRoot, new Map(), segmentPath, [], leaves, base);\n\n const collision = findOrderDependentCollision(spaceRoot, leaves, base);\n if (!collision) return;\n\n throw new Error(\n `Build error: route collision — two pages/routes answer the same URL.\\n` +\n ` URL: ${collision.url}\\n` +\n ` File 1: ${collision.first}\\n` +\n ` File 2: ${collision.second}\\n` +\n `Both match it, so which one renders would be decided by filesystem enumeration ` +\n `order — renaming a route group can flip it. Rename or move one of them.\\n` +\n `Routes are compared by the URLs they match, not by how they are spelled: [id] and ` +\n `[slug] match the same URLs, and an optional catch-all also matches with zero ` +\n `segments.`\n );\n}\n\n/**\n * Walk one collision space and collect its routable leaves (page or route\n * files), throwing on an exact `urlPath` collision. Each slot recurses as its\n * OWN space — slots are parallel routes that intentionally share URL paths with\n * their parent tree, but collisions within a single slot are real errors.\n *\n * The early return at an intercepting node drops that subtree's own pages from\n * this space, but not its slots: a slot is its own collision space wherever it\n * sits, so `validateSlotsInsideInterceptingSubtree` picks those up before\n * returning.\n *\n * `chain` accumulates the URL-contributing nodes from the space root down, for\n * the probe oracle. Route groups are excluded because they are transparent for\n * matching, and the space root itself is excluded because `matchUrlParts`\n * matches parts against its *children* — the root consumes nothing.\n */\nfunction collectRoutableLeaves(\n node: SegmentNode,\n seen: Map<string, { filePath: string; segmentPath: string }>,\n segmentPath: string,\n chain: SegmentNode[],\n leaves: ProbeLeaf[],\n base: string\n): void {\n // Intercepting routes are resolved by the interception resolvers, not URL\n // matching, and their computed urlPaths are not addresses — an interception\n // mirrors the canonical route it replaces, so comparing those paths here\n // would reject every correct interception. Skipping is not \"unvalidated\":\n // `assertNoInterceptedPatternCollisions` gives each intercepting subtree its\n // own collision space, keyed by the intercepted pattern rather than by these\n // paths (TIM-1305). See design/07-routing.md §\"Collisions Inside an\n // Intercepting Subtree\" and §\"Why urlPath Stays Parent-Relative Inside an\n // Intercepting Subtree\".\n const currentPath = segmentPath\n ? `${segmentPath}/${node.segmentName}`\n : node.segmentName || '(root)';\n\n // The intercepting subtree's own pages leave this space — but its SLOTS do\n // not leave every space, so they are picked up before returning. See\n // `validateSlotsInsideInterceptingSubtree`.\n if (node.segmentType === 'intercepting') {\n // `node.urlPath` on an intercepting node is its OWNER's path — the input\n // `computeInterceptedUrlBase` wants — because an intercepting segment adds\n // no URL depth.\n validateSlotsInsideInterceptingSubtree(\n node,\n currentPath,\n interceptedBaseOf(node, node.urlPath)\n );\n return;\n }\n\n const routableFile = node.page ?? node.route;\n if (routableFile) {\n const existing = seen.get(node.urlPath);\n if (existing) {\n throw new Error(\n `Build error: route collision — multiple route groups produce a page/route at the same URL path.\\n` +\n ` URL path: ${urlFromChain(base, chain)}\\n` +\n ` File 1: ${existing.filePath} (via ${existing.segmentPath})\\n` +\n ` File 2: ${routableFile.filePath} (via ${currentPath})\\n` +\n `Each URL path must map to exactly one page or route handler. ` +\n `Rename or move one of the conflicting files.`\n );\n }\n seen.set(node.urlPath, { filePath: routableFile.filePath, segmentPath: currentPath });\n leaves.push({ filePath: routableFile.filePath, chain });\n }\n\n // Recurse into children. A route group contributes no URL part, so it is\n // absent from the chain — exactly as `collectEffectiveChildren` flattens it\n // away in the matcher.\n for (const child of node.children) {\n const isGroup = child.segmentType === 'group';\n collectRoutableLeaves(\n child,\n seen,\n currentPath,\n isGroup ? chain : [...chain, child],\n leaves,\n base\n );\n }\n\n // Recurse into slots — each slot is its own collision space, with its own\n // seen map, its own leaf set and its own probe run.\n //\n // The base is accumulated from this space's own base rather than read off\n // `slotNode.urlPath`, because this walk also runs on slot spaces nested inside\n // an intercepting subtree, where `urlPath` is parent-relative and not an\n // address. Outside one the two are identical by construction.\n for (const slotNode of Object.values(node.slots)) {\n validateCollisionSpace(slotNode, currentPath, urlFromChain(base, chain));\n }\n}\n\n/**\n * Validate every parallel slot nested anywhere inside an intercepting subtree.\n *\n * Two walks each skip these slots for their own good reason, and together they\n * left them checked by nothing: `collectRoutableLeaves` returns at the\n * intercepting node before it reaches them, and `walkInterceptedLeaves`\n * deliberately does not descend slots — correct for rewrite generation, since a\n * slot inside an intercepting subtree produces no rewrite. But \"produces no\n * rewrite\" answers the rewrite question and not the resolution one, so\n * `@side/(a)/x/page.tsx` beside `@side/(b)/x/page.tsx` under an interceptor\n * built with filesystem order picking the page — the ordinary per-slot\n * collision that fails the build anywhere else in the tree (codex, on PR #1002).\n *\n * A slot is its own collision space wherever it sits, so each one is validated\n * as one.\n *\n * **Which interception shape this still applies to.** TIM-1311 answered the\n * question this was written under — whether such a slot renders at all — and\n * the answer is per-shape:\n *\n * - **Children path** (`(browse)/(...)photo/@side`): the intercepting node\n * joins the main route chain, so `route-element-builder.ts` resolves slots on\n * it and below it like any other chain segment. They render, and this is the\n * space where the check is load-bearing.\n * - **Modal** (`feed/@modal/(.)photo/@side`): the slot sits inside another\n * slot's subtree, which no renderer descends for slots — so it never renders,\n * and `validateSlotPlacement` now rejects the placement before this runs.\n * That rule subsumes this one for the modal shape rather than conflicting\n * with it, exactly as anticipated.\n *\n * So this walk is reached only for children-path interceptors in a valid tree.\n * It is not narrowed to them: the rule it states — a slot is its own collision\n * space wherever it sits — is shape-independent, and making it conditional on a\n * property the placement validator already guarantees would just be a second\n * place for the two to disagree.\n *\n * The walk covers the whole subtree, not just the interceptor's direct slot\n * children: `(...)photo/[id]/@side` is reached by neither walk for exactly the\n * same reason as `(...)photo/@side`.\n */\nfunction validateSlotsInsideInterceptingSubtree(\n node: SegmentNode,\n segmentPath: string,\n base: string\n): void {\n for (const slotNode of Object.values(node.slots)) {\n // A slot adds no URL depth, so it answers its owner's base.\n validateCollisionSpace(slotNode, segmentPath, base);\n }\n for (const child of node.children) {\n validateSlotsInsideInterceptingSubtree(\n child,\n `${segmentPath}/${child.segmentName}`,\n childInterceptedBase(child, base)\n );\n }\n}\n\n/**\n * The URL a leaf answers, built from its space's base and its own chain.\n *\n * Read instead of `node.urlPath` because `urlPath` inside an intercepting\n * subtree is parent-relative and is not an address — the collision URL has to\n * be one the author can actually find. Outside an intercepting subtree the two\n * are identical by construction: the base is the space root's `urlPath` and the\n * chain is every URL-contributing segment below it.\n */\nfunction urlFromChain(base: string, chain: SegmentNode[]): string {\n if (chain.length === 0) return base || '/';\n const tail = chain.map((n) => n.segmentName).join('/');\n return `${base === '/' ? '' : base}/${tail}`;\n}\n\n/**\n * The intercepted URL an intercepting directory's own page sits at.\n *\n * `urlPath` inside an intercepting subtree is deliberately parent-relative and\n * is **not** an address (see design/07-routing.md §\"Why urlPath Stays\n * Parent-Relative Inside an Intercepting Subtree\"), so a collision reported\n * from one names a URL the author cannot find. The intercepted base is the real\n * address, and it is what rewrite generation and the interception collision\n * validator both already use.\n */\nfunction interceptedBaseOf(node: SegmentNode, ownerUrlPath: string): string {\n return computeInterceptedUrlBase(\n ownerUrlPath,\n node.interceptionMarker ?? '(.)',\n node.interceptedSegmentName ?? node.segmentName\n );\n}\n\n/**\n * Extend an intercepted base by one child segment.\n *\n * Route groups are transparent and contribute nothing. A nested intercepting\n * node re-bases from its own marker rather than appending — that tree is\n * rejected by `validateInterceptionPlacement`, but collision validation runs\n * first, so it still has to produce a sensible URL rather than one containing a\n * literal \"(.)b\".\n */\nfunction childInterceptedBase(child: SegmentNode, base: string): string {\n // Slots are not in `children` — `scanChildren` files them under `slots` — so\n // only groups are transparent here.\n if (child.segmentType === 'group') return base;\n if (child.segmentType === 'intercepting') return interceptedBaseOf(child, base);\n return base === '/' ? `/${child.segmentName}` : `${base}/${child.segmentName}`;\n}\n","/**\n * Parallel slot placement.\n *\n * One rule: a slot is resolved only for a segment on the **matched route\n * chain**, and a slot's own subtree is never on that chain. So a slot declared\n * anywhere inside another slot's subtree can never render, and is rejected at\n * build time rather than left as a directory the author will keep editing.\n *\n * See design/07-routing.md §\"Parallel Routes\".\n */\n\nimport type { SegmentNode } from './types.ts';\n\n/**\n * Reject every parallel slot that no renderer reaches.\n *\n * **Where slots are resolved.** Two places read `segment.slots`, and both walk\n * the main route chain: `route-element-builder.ts` (the RSC render).\n * It is not reachable from inside a slot. The slot's own\n * subtree is rendered by `slot-resolver.ts`, which walks the slot's matched\n * chain to apply that chain's layouts, error boundaries and access gates\n * (`wrapWithIntermediateSegments`, `wrapWithLayout`) and never reads `.slots`\n * on any of those nodes. So `app/feed/@modal/photo/@side/page.tsx` and\n * everything below it is dead: the file is scanned, typed, code-split and\n * shipped, and no request can render it.\n *\n * That is the TIM-1278 failure — a directory that silently never renders —\n * and the reason it is a build error rather than a documented limit is that\n * nothing at request time can report it. A slot that does not match renders\n * `default.tsx` or `null`, which is exactly what a slot the resolver never\n * looked at also produces, so the author sees the *designed* behaviour of a\n * non-matching slot and has no signal to distinguish it from a slot that\n * cannot match at all.\n *\n * **Interception is incidental.** TIM-1311 arrived as\n * `feed/@modal/(.)photo/@side`, and the interception contributes nothing: the\n * identical `feed/@modal/photo/@side` never renders either, for the same\n * reason and with no marker anywhere. Rejecting only the intercepting spelling\n * would have drawn a line the author cannot see from the directory names.\n *\n * The children-path interception shape is **not** affected and must not be:\n * its intercepting node joins the main chain (`server/children-interception.ts`\n * splices `[…owner ancestors, interceptingNode, …descendants]` into an ordinary\n * `RouteMatch`), so `route-element-builder.ts` resolves slots on it and below\n * it exactly as it does for any other chain segment. `(browse)/(...)photo/[id]/@side`\n * renders; `feed/@modal/(.)photo/@side` does not. The discriminator is the slot\n * boundary, which is what this walk tracks — not the marker.\n */\nexport function validateSlotPlacement(root: SegmentNode): void {\n walkForSlotPlacement(root, '', null);\n}\n\n/**\n * `enclosingSlotPath` is the `app/`-relative path of the nearest slot at or\n * above `node`, or null on the main chain. It is carried rather than recomputed\n * so the error can name the slot that swallows the offender — \"this is inside\n * @modal\" is the part of the diagnosis the author cannot see from the offending\n * path alone.\n */\nfunction walkForSlotPlacement(\n node: SegmentNode,\n path: string,\n enclosingSlotPath: string | null\n): void {\n for (const [slotName, slotNode] of Object.entries(node.slots)) {\n const slotPath = path ? `${path}/@${slotName}` : `@${slotName}`;\n if (enclosingSlotPath !== null) {\n throwNestedSlot(slotPath, enclosingSlotPath);\n }\n walkForSlotPlacement(slotNode, slotPath, slotPath);\n }\n\n for (const child of node.children) {\n walkForSlotPlacement(\n child,\n path ? `${path}/${child.segmentName}` : child.segmentName,\n enclosingSlotPath\n );\n }\n}\n\nfunction throwNestedSlot(slotPath: string, enclosingSlotPath: string): never {\n throw new Error(\n `Build error: parallel slot nested inside another parallel slot.\\n` +\n ` Directory: app/${slotPath}\\n` +\n ` Inside: app/${enclosingSlotPath}\\n` +\n `A parallel slot is resolved only for a segment on the matched route chain, and a ` +\n `slot's own subtree is never on that chain — the slot resolver walks the slot's ` +\n `matched chain to apply its layouts, error boundaries and access gates, and never ` +\n `looks at slots declared inside it. So app/${slotPath} and everything below it can ` +\n `never render, and no request-time signal can tell you: an unreachable slot ` +\n `produces exactly what a slot that simply did not match produces.\\n` +\n `Declare the slot on a segment of the main route chain instead, or move its pages ` +\n `into app/${enclosingSlotPath}'s own subtree.\\n` +\n `See design/07-routing.md §\"Parallel Routes\".`\n );\n}\n","import { readFileSync, statSync } from 'node:fs';\n\nconst cache = new Map<string, { mtimeMs: number; size: number; content: string }>();\n\n/**\n * Read a file's text content, returning a cached copy when the file\n * hasn't been modified since the last read (checked via mtime + size).\n *\n * Falls back to a fresh read on any stat/read error.\n */\nexport function readFileCached(filePath: string): string {\n try {\n const stat = statSync(filePath);\n const entry = cache.get(filePath);\n if (entry && entry.mtimeMs === stat.mtimeMs && entry.size === stat.size) return entry.content;\n const content = readFileSync(filePath, 'utf-8');\n cache.set(filePath, { mtimeMs: stat.mtimeMs, size: stat.size, content });\n return content;\n } catch {\n cache.delete(filePath);\n return readFileSync(filePath, 'utf-8');\n }\n}\n","/**\n * AST-based export detection for route files.\n *\n * Uses Vite's `parseAst` (backed by oxc) to precisely detect named and\n * default exports, replacing the regex-based approach that was fragile\n * with TypeScript syntax (type exports, `as` aliases, comments, etc.).\n */\n\nimport { existsSync } from 'node:fs';\nimport { parseAst } from 'vite';\nimport { readFileCached } from './file-cache.ts';\n\ninterface AstNode {\n type: string;\n exportKind?: string;\n declaration?: AstNode;\n specifiers?: Array<{\n exported?: { name: string };\n local?: { name: string };\n exportKind?: string;\n }>;\n id?: { name: string };\n declarations?: Array<{ id?: { name: string }; init?: AstNode }>;\n /** Set on re-exports: `export { X } from './y'`. Absent on local exports. */\n source?: { value?: string } | null;\n /** Set on runtime-transparent wrappers: `X as T`, `X satisfies T`, `(X)`, `X!`. */\n expression?: AstNode;\n /** Set on `Identifier` nodes. */\n name?: string;\n}\n\ninterface ProgramNode {\n body: AstNode[];\n}\n\n/**\n * Parse a module. `lang` defaults to `tsx`; pass `ts` for `.ts` files, where\n * an angle-bracket cast or a generic arrow (`<T>(x: T) => x`) is valid\n * TypeScript but a TSX parse error.\n */\nexport function tryParse(source: string, lang: 'ts' | 'tsx' = 'tsx'): ProgramNode | null {\n try {\n return parseAst(source, { lang }) as unknown as ProgramNode;\n } catch {\n return null;\n }\n}\n\n/**\n * Collect all named export identifiers from a parsed program.\n * Handles: `export function X`, `export const X`, `export { X }`,\n * `export { X } from '...'`, `export { Y as X }`.\n */\nfunction collectNamedExports(program: ProgramNode): Set<string> {\n const names = new Set<string>();\n for (const stmt of program.body) {\n if (stmt.type !== 'ExportNamedDeclaration') continue;\n // Skip `export type ...` declarations — they're erased at runtime\n if (stmt.exportKind === 'type') continue;\n\n if (stmt.declaration) {\n if (stmt.declaration.id?.name) {\n names.add(stmt.declaration.id.name);\n }\n if (stmt.declaration.declarations) {\n for (const decl of stmt.declaration.declarations) {\n if (decl.id?.name) names.add(decl.id.name);\n }\n }\n }\n\n if (stmt.specifiers) {\n for (const spec of stmt.specifiers) {\n // Skip `export { type X }` — per-specifier type exports\n if (spec.exportKind === 'type') continue;\n if (spec.exported?.name && spec.exported.name !== 'default') {\n names.add(spec.exported.name);\n }\n }\n }\n }\n return names;\n}\n\n/**\n * The specifier exporting a *runtime* default from this statement, if any.\n *\n * Type-only exports erase, so they are not default exports at runtime — and\n * TypeScript spells that two ways, on two different nodes: `export type { X as\n * default }` marks the **statement**, `export { type X as default }` marks the\n * **specifier**. Both have to be checked, or a type alias reads as a component:\n * a status file whose only default is a type has nothing for the error boundary\n * to receive (the renderer's `mod?.default` skips it), so treating it as one\n * would fail a build over a file that cannot break anything.\n *\n * One implementation because two callers must agree on what \"has a default\n * export\" means: `hasDefaultExport` decides whether to warn that a page has\n * none, and `fileDefaultExportIsLocalValue` decides whether to fail the build.\n */\nfunction defaultSpecifier(stmt: AstNode): NonNullable<AstNode['specifiers']>[number] | null {\n if (stmt.type !== 'ExportNamedDeclaration' || !stmt.specifiers) return null;\n if (stmt.exportKind === 'type') return null;\n for (const spec of stmt.specifiers) {\n if (spec.exportKind === 'type') continue;\n if (spec.exported?.name === 'default') return spec;\n }\n return null;\n}\n\n/**\n * Check whether a program has a default export.\n * Handles: `export default ...`, `export { X as default }`,\n * `export { default } from '...'`. Type-only defaults do not count —\n * see `defaultSpecifier`.\n */\nfunction hasDefaultExport(program: ProgramNode): boolean {\n for (const stmt of program.body) {\n if (stmt.type === 'ExportDefaultDeclaration') return true;\n if (defaultSpecifier(stmt)) return true;\n }\n return false;\n}\n\n/**\n * Check whether a program has any bare `export * from '...'` declarations.\n * Excludes `export * as X from '...'` (namespace re-exports) since those\n * create a namespace object, not individual top-level exports.\n */\nfunction hasStarExport(program: ProgramNode): boolean {\n return program.body.some(\n (stmt) =>\n stmt.type === 'ExportAllDeclaration' && !(stmt as any).exported && stmt.exportKind !== 'type'\n );\n}\n\n/**\n * Check if a file exports a specific named export.\n * Returns false if the file doesn't exist or can't be parsed.\n */\nexport function fileHasExport(filePath: string, exportName: string): boolean {\n if (!existsSync(filePath)) return false;\n try {\n const source = readFileCached(filePath);\n const program = tryParse(source);\n if (!program) return false;\n return collectNamedExports(program).has(exportName);\n } catch {\n return false;\n }\n}\n\n/**\n * Check if a file has any of the given named exports.\n * Returns the set of matching export names.\n */\nexport function fileHasAnyExport(filePath: string, exportNames: readonly string[]): Set<string> {\n const matches = new Set<string>();\n try {\n const source = readFileCached(filePath);\n const program = tryParse(source);\n if (!program) return matches;\n const exports = collectNamedExports(program);\n for (const name of exportNames) {\n if (exports.has(name)) matches.add(name);\n }\n } catch {\n // Graceful fallback: return empty set\n }\n return matches;\n}\n\n/**\n * Check if a file has a default export.\n * Returns false if the file doesn't exist or can't be parsed.\n */\nexport function fileHasDefaultExport(filePath: string): boolean {\n if (!existsSync(filePath)) return false;\n try {\n const source = readFileCached(filePath);\n const program = tryParse(source);\n if (!program) return false;\n return hasDefaultExport(program);\n } catch {\n return false;\n }\n}\n\n/** Node types whose value is unambiguously constructed by this module. */\nconst FUNCTION_LIKE = new Set([\n 'FunctionDeclaration',\n 'FunctionExpression',\n 'ArrowFunctionExpression',\n 'ClassDeclaration',\n 'ClassExpression',\n]);\n\n/**\n * Expression wrappers that erase at runtime and so cannot change where a value\n * was constructed: `X as T`, `X satisfies T`, `<T>X`, `X!`, `X<T>`, `(X)`.\n */\nexport const TRANSPARENT_WRAPPERS: ReadonlySet<string> = new Set([\n 'TSAsExpression',\n 'TSSatisfiesExpression',\n 'TSTypeAssertion',\n 'TSNonNullExpression',\n 'TSInstantiationExpression',\n 'ParenthesizedExpression',\n]);\n\n/**\n * Strip runtime-transparent wrappers so the node underneath can be classified.\n *\n * Without this, `(() => <h1 />) satisfies React.FC` reads as a\n * `TSSatisfiesExpression` rather than the arrow function it compiles to, and a\n * provably-local component is misread as one whose origin cannot be\n * determined — turning a build error into a warning.\n */\nfunction unwrapTransparent(node: AstNode): AstNode {\n let current = node;\n while (TRANSPARENT_WRAPPERS.has(current.type) && current.expression) {\n current = current.expression;\n }\n return current;\n}\n\n/**\n * Whether `name` is bound at module top level to a function or class written\n * in this file. An imported binding can never match: imports are\n * `ImportDeclaration` specifiers, not function/class/variable declarations,\n * and a module-level name cannot be both.\n */\nfunction bindsLocalFunction(program: ProgramNode, name: string): boolean {\n for (const stmt of program.body) {\n // `export function X() {}` binds X locally too — unwrap the export.\n const decl = stmt.type === 'ExportNamedDeclaration' ? stmt.declaration : stmt;\n if (!decl) continue;\n if (\n (decl.type === 'FunctionDeclaration' || decl.type === 'ClassDeclaration') &&\n decl.id?.name === name\n ) {\n return true;\n }\n if (decl.type === 'VariableDeclaration') {\n for (const d of decl.declarations ?? []) {\n if (d.id?.name === name && d.init && FUNCTION_LIKE.has(unwrapTransparent(d.init).type)) {\n return true;\n }\n }\n }\n }\n return false;\n}\n\n/**\n * Whether the default export is *provably* a value constructed by this module:\n * `export default function/class/() => {}`, or a name bound to a function or\n * class declared here — whether it leaves via `export default Name` or\n * `export { Name as default }`. Both spellings are the same fact about where\n * the value was built, so both must answer the same way.\n *\n * This is the sound half of \"is this a server component?\". A file with no\n * `'use client'` directive whose default export is built here is a server\n * component, full stop. Everything else — `export { default } from\n * './client-thing'`, `export default Imported`, `export default memo(X)`,\n * an unparseable file — returns false, because the exported value may have\n * been minted in a module that *does* carry the directive. Callers must not\n * infer \"server component\" from a missing directive alone.\n */\nexport function fileDefaultExportIsLocalValue(filePath: string): boolean {\n if (!existsSync(filePath)) return false;\n try {\n const source = readFileCached(filePath);\n const program = tryParse(source);\n if (!program) return false;\n for (const stmt of program.body) {\n if (stmt.type === 'ExportDefaultDeclaration') {\n const decl = stmt.declaration && unwrapTransparent(stmt.declaration);\n if (!decl) return false;\n if (FUNCTION_LIKE.has(decl.type)) return true;\n if (decl.type === 'Identifier' && decl.name) {\n return bindsLocalFunction(program, decl.name);\n }\n return false;\n }\n\n // `export { Name as default }` — the same default export by another\n // spelling. `hasDefaultExport` already counts it, so an analysis that\n // skipped it here would let the exact defect this powers slip through\n // as a warning.\n const spec = defaultSpecifier(stmt);\n if (spec) {\n // `export { X as default } from './client-thing'` re-exports another\n // module's value — the directive governing it lives over there.\n if (stmt.source) return false;\n return spec.local?.name ? bindsLocalFunction(program, spec.local.name) : false;\n }\n }\n return false;\n } catch {\n return false;\n }\n}\n\n/**\n * Check if a file has any `export * from '...'` declarations.\n * Returns false if the file doesn't exist or can't be parsed.\n */\nexport function fileHasStarExport(filePath: string): boolean {\n if (!existsSync(filePath)) return false;\n try {\n const source = readFileCached(filePath);\n const program = tryParse(source);\n if (!program) return false;\n return hasStarExport(program);\n } catch {\n return false;\n }\n}\n\n/**\n * How a file declares the per-route CSRF exemption.\n *\n * - `'absent'` — no runtime export named `csrf`.\n * - `'exempt'` — exactly `export const csrf = false` (wrappers like\n * `false as const` allowed), declared in this file.\n * - `'invalid'` — some other `csrf` export: another value, `let`, a\n * destructured binding, a specifier or named re-export (`export { csrf }`,\n * `export { x as \"csrf\" }`), a function or class. `export * from` is not\n * followed: a `csrf` it carries is neither exempt nor an error.\n *\n * The exemption is read from source at build time, never from the loaded\n * module, because the CSRF gate runs before any user code (see\n * design/08-forms-and-actions.md §\"Per-route exemption\"). Only the literal\n * form can be read that way; any other spelling is a build error rather\n * than a silent \"not exempt\", so what the developer wrote is what runs.\n */\nexport type CsrfExport = 'absent' | 'exempt' | 'invalid';\n\nexport function getCsrfExport(filePath: string): CsrfExport {\n if (!existsSync(filePath)) return 'absent';\n // Unparseable: not exempt (fail closed). The compiler reports the syntax\n // error; guessing at a half-written file would misreport it.\n const program = tryParse(readFileCached(filePath));\n if (!program) return 'absent';\n\n // Walk the statements directly rather than through `collectNamedExports`:\n // every spelling that exports a runtime `csrf` must be seen here, and\n // that helper does not see destructured declarations or string-literal\n // specifier names. What cannot be seen at all — `export * from` — is\n // not read, and is documented as such.\n let found: CsrfExport = 'absent';\n for (const stmt of program.body) {\n if (stmt.type !== 'ExportNamedDeclaration' || stmt.exportKind === 'type') continue;\n for (const spec of stmt.specifiers ?? []) {\n if (spec.exportKind !== 'type' && specifierName(spec.exported) === 'csrf') {\n return 'invalid';\n }\n }\n const decl = stmt.declaration as (AstNode & { kind?: string }) | undefined;\n if (!decl) continue;\n if (decl.id?.name === 'csrf') return 'invalid'; // function or class\n if (decl.type !== 'VariableDeclaration') continue;\n for (const d of decl.declarations ?? []) {\n const id = d.id as AstNode | undefined;\n if (id?.type === 'Identifier') {\n if (id.name !== 'csrf') continue;\n const init = d.init && (unwrapTransparent(d.init) as AstNode & { value?: unknown });\n const literalFalse = init?.type === 'Literal' && init.value === false;\n if (decl.kind !== 'const' || !literalFalse) return 'invalid';\n found = 'exempt';\n } else if (id && patternBinds(id, 'csrf')) {\n return 'invalid'; // `export const { csrf } = …`\n }\n }\n }\n return found;\n}\n\n/** An export specifier's name: `csrf` or the string literal `\"csrf\"`. */\nfunction specifierName(node: { name?: string; value?: unknown } | undefined): string | undefined {\n if (!node) return undefined;\n return typeof node.value === 'string' ? node.value : node.name;\n}\n\n/** Whether a destructuring pattern binds `name` anywhere inside it. */\nexport function patternBinds(node: unknown, name: string): boolean {\n if (!node || typeof node !== 'object') return false;\n const n = node as Record<string, unknown>;\n switch (n.type) {\n case 'Identifier':\n return n.name === name;\n case 'ObjectPattern':\n return ((n.properties as unknown[]) ?? []).some((prop) => {\n const p = prop as Record<string, unknown>;\n return patternBinds(p.type === 'RestElement' ? p.argument : p.value, name);\n });\n case 'ArrayPattern':\n return ((n.elements as unknown[]) ?? []).some((el) => patternBinds(el, name));\n case 'RestElement':\n return patternBinds(n.argument, name);\n case 'AssignmentPattern':\n return patternBinds(n.left, name);\n default:\n return false;\n }\n}\n\n/**\n * Check if a file starts with a specific directive (e.g. \"use client\").\n * Directives are string literal expression statements at the top of the file.\n */\nexport function fileHasDirective(filePath: string, directive: string): boolean {\n if (!existsSync(filePath)) return false;\n try {\n const source = readFileCached(filePath);\n const program = tryParse(source);\n if (!program) return false;\n for (const stmt of program.body) {\n if (stmt.type !== 'ExpressionStatement') break;\n const expr = (stmt as any).expression;\n if (expr?.type !== 'Literal' || typeof expr.value !== 'string') break;\n if (expr.value === directive) return true;\n }\n return false;\n } catch {\n return false;\n }\n}\n\n/** Route files the AST checks can read; `.mdx` and `.json` are skipped. */\nexport function isScriptExtension(ext: string): boolean {\n return ext === 'tsx' || ext === 'ts' || ext === 'jsx' || ext === 'js';\n}\n","/**\n * Route discovery scanner.\n *\n * Pure function: (appDir, config) → RouteTree\n *\n * Scans the app/ directory and builds a segment tree recognizing all\n * timber.js file conventions. Does NOT handle request matching — this\n * is discovery only.\n */\n\nimport { readdirSync, statSync } from 'node:fs';\nimport { join, extname, basename } from 'node:path';\nimport type {\n RouteTree,\n SegmentNode,\n SegmentType,\n RouteFile,\n ScannerConfig,\n InterceptionMarker,\n} from './types.ts';\nimport { classifySegment, effectiveUrlSegment } from './segment-classify.ts';\nimport { validateInterceptionPlacement, computeInterceptedBase } from './interception.ts';\nimport { validateRouteGroupCollisions } from './collision-spaces.ts';\nimport { validateSlotPlacement } from './slot-placement.ts';\nimport { DEFAULT_PAGE_EXTENSIONS } from './types.ts';\nimport { classifyMetadataRoute, isDynamicMetadataExtension } from '../server/metadata-routes.ts';\nimport { swallow } from '../server/logger.ts';\nimport { getCsrfExport } from './export-detect.ts';\nimport { ENCODED_SEPARATOR_RE, NULL_BYTE_RE } from '../server/canonicalize.ts';\n\n/**\n * File convention names that use pageExtensions (can be .tsx, .ts, .jsx, .js, .mdx, etc.)\n * `error` is excluded — it only accepts script extensions (TIM-1505).\n */\nconst PAGE_EXT_CONVENTIONS = new Set(['page', 'layout', 'default', 'denied']);\n\n/**\n * File convention names that are always .ts/.tsx (never .mdx etc.)\n */\nconst FIXED_CONVENTIONS = new Set(['middleware', 'access', 'route']);\n\n/**\n * Status-code file patterns:\n * - Exact 3-digit codes: 401.tsx, 429.tsx, 503.tsx\n * - Category catch-alls: 4xx.tsx, 5xx.tsx\n */\nconst STATUS_CODE_PATTERN = /^(\\d{3}|[45]xx)$/;\n\n/**\n * Whether a basename + extension pair is a route-convention file the\n * framework itself imports: page/layout/default/denied on pageExtensions,\n * error/global-error and status-code files on script extensions only,\n * middleware/access/route/proxy on .ts/.tsx/.js/.jsx only, and\n * status-code .json files — mirroring this scanner's own recognition\n * rules per family.\n *\n * Exported for the analyze classifier so its provisional classification\n * (design/47 §2) derives from the scanner's real conventions instead of\n * a duplicate list that can drift.\n */\nexport function isRouteConventionFile(\n base: string,\n ext: string,\n pageExtensions: readonly string[] = DEFAULT_PAGE_EXTENSIONS\n): boolean {\n const isPageExt = pageExtensions.includes(ext);\n const isScriptExt = /^[jt]sx?$/.test(ext);\n if (PAGE_EXT_CONVENTIONS.has(base) && isPageExt) return true;\n if ((base === 'error' || base === 'global-error') && isScriptExt) return true;\n if ((FIXED_CONVENTIONS.has(base) || base === 'proxy') && isScriptExt) return true;\n if (STATUS_CODE_PATTERN.test(base) && (isScriptExt || ext === 'json')) return true;\n return false;\n}\n\n/**\n * Scan the app/ directory and build the route tree.\n *\n * @param appDir - Absolute path to the app/ directory\n * @param config - Scanner configuration\n * @returns The complete route tree\n */\nexport function scanRoutes(appDir: string, config: ScannerConfig = {}): RouteTree {\n const pageExtensions = config.pageExtensions ?? DEFAULT_PAGE_EXTENSIONS;\n const extSet = new Set(pageExtensions);\n\n const tree: RouteTree = {\n root: createSegmentNode('', 'static', '/'),\n };\n\n // Check for proxy.ts at app root\n const proxyFile = findFixedFile(appDir, 'proxy');\n if (proxyFile) {\n tree.proxy = proxyFile;\n }\n\n // Check for global-error.{tsx,ts,jsx,js} at app root.\n // Tier 2 error page — renders standalone (no layouts) when no segment-level\n // error file is found. Script extensions only — MDX not supported (TIM-1505).\n // See design/10-error-handling.md §\"Tier 2\".\n const globalErrorFile = findScriptExtFile(appDir, 'global-error');\n if (globalErrorFile) {\n tree.globalError = globalErrorFile;\n }\n\n // Scan the root directory's files\n scanSegmentFiles(appDir, tree.root, extSet);\n\n // Scan children recursively\n scanChildren(appDir, tree.root, extSet);\n\n // Validate: every parallel slot sits where a renderer reaches it. First,\n // because a slot nested inside another slot never renders, and a collision\n // reported from inside one would send the author to fix an ambiguity between\n // two pages that were both already dead.\n validateSlotPlacement(tree.root);\n\n // Validate: detect route group collisions (different groups producing pages at the same URL)\n validateRouteGroupCollisions(tree.root);\n\n // Validate: detect duplicate param names in nested dynamic segments\n // e.g., /[id]/items/[id] — same param name in ancestor and descendant\n validateDuplicateParamNames(tree.root);\n\n // Validate: detect same param name used with different bracket forms\n // e.g., [id] in one route and [...id] in another\n validateUniqueBracketForms(tree.root);\n\n // Validate: detect affixed dynamic siblings with equal specificity\n // e.g., a-[id] and [slug]-b both have prefix+suffix length = 2\n validateAffixedSiblingConflicts(tree.root);\n\n // Validate: intercepting routes must be direct children of a parallel slot —\n // the slot resolver is the only thing that can render one.\n validateInterceptionPlacement(tree.root);\n\n return tree;\n}\n\n/**\n * Create an empty segment node.\n */\nfunction createSegmentNode(\n segmentName: string,\n segmentType: SegmentType,\n urlPath: string,\n paramName?: string,\n interceptionMarker?: InterceptionMarker,\n interceptedSegmentName?: string,\n paramPrefix?: string,\n paramSuffix?: string\n): SegmentNode {\n return {\n segmentName,\n segmentType,\n urlPath,\n paramName,\n paramPrefix,\n paramSuffix,\n interceptionMarker,\n interceptedSegmentName,\n children: [],\n slots: {},\n };\n}\n\n/**\n * Compute the URL path for a child segment given its parent's URL path.\n * Route groups, slots, and intercepting routes do NOT add URL depth.\n */\nfunction computeUrlPath(parentUrlPath: string, dirName: string, segmentType: SegmentType): string {\n // Groups, slots, and intercepting routes don't add to URL path\n if (segmentType === 'group' || segmentType === 'slot' || segmentType === 'intercepting') {\n return parentUrlPath;\n }\n\n const parentPath = parentUrlPath === '/' ? '' : parentUrlPath;\n return `${parentPath}/${dirName}`;\n}\n\n/**\n * Scan a directory for file conventions and populate the segment node.\n */\nfunction scanSegmentFiles(dirPath: string, node: SegmentNode, extSet: Set<string>): void {\n let entries: string[];\n try {\n entries = readdirSync(dirPath);\n } catch (err) {\n swallow(err, `scanSegmentFiles: unreadable directory ${dirPath}`, { level: 'warn' });\n return;\n }\n\n for (const entry of entries) {\n const fullPath = join(dirPath, entry);\n\n // Skip directories — handled by scanChildren\n try {\n if (statSync(fullPath).isDirectory()) continue;\n } catch {\n continue;\n }\n\n const ext = extname(entry).slice(1); // remove leading dot\n const name = basename(entry, `.${ext}`);\n\n // Page-extension conventions (page, layout, default, denied)\n if (PAGE_EXT_CONVENTIONS.has(name) && extSet.has(ext)) {\n const key = name as 'page' | 'layout' | 'default' | 'denied';\n const existing = node[key];\n if (existing) {\n throwDuplicateConvention(name, existing.filePath, fullPath);\n }\n node[key] = { filePath: fullPath, extension: ext };\n continue;\n }\n\n // error.tsx — script extensions only, not MDX/MD (TIM-1505).\n if (name === 'error' && /^[jt]sx?$/.test(ext)) {\n const existing = node.error;\n if (existing) {\n throwDuplicateConvention('error', existing.filePath, fullPath);\n }\n node.error = { filePath: fullPath, extension: ext };\n continue;\n }\n\n // Fixed conventions (middleware, access, route) — only\n // .ts/.tsx/.js/.jsx, never pageExtensions like .mdx. The regex is\n // anchored: mts/cts/mjs/cjs (and stray tail matches like `.foots`)\n // are NOT recognized. See design/07-routing.md §\"Page Extensions\".\n if (FIXED_CONVENTIONS.has(name) && /^[jt]sx?$/.test(ext)) {\n const key = name as 'middleware' | 'access' | 'route';\n const existing = node[key];\n if (existing) {\n throwDuplicateConvention(name, existing.filePath, fullPath);\n }\n node[key] = { filePath: fullPath, extension: ext };\n continue;\n }\n\n // JSON status-code files (401.json, 4xx.json, 503.json, 5xx.json)\n // Recognized regardless of pageExtensions — .json is a data format, not a page extension.\n if (STATUS_CODE_PATTERN.test(name) && ext === 'json') {\n if (!node.jsonStatusFiles) {\n node.jsonStatusFiles = {};\n }\n node.jsonStatusFiles[name] = { filePath: fullPath, extension: ext };\n continue;\n }\n\n // Status-code files (401.tsx, 4xx.tsx, 503.tsx, 5xx.tsx) — script extensions only (TIM-1505)\n if (STATUS_CODE_PATTERN.test(name) && /^[jt]sx?$/.test(ext)) {\n if (!node.statusFiles) {\n node.statusFiles = {};\n }\n const existing = node.statusFiles[name];\n if (existing) {\n throwDuplicateConvention(name, existing.filePath, fullPath);\n }\n node.statusFiles[name] = { filePath: fullPath, extension: ext };\n continue;\n }\n\n // Metadata route files (sitemap.ts, robots.ts, icon.tsx, opengraph-image.tsx, etc.)\n // Both static (.xml, .txt, .png, .ico, etc.) and dynamic (.ts, .tsx) files are recognized.\n // When both exist for the same base name, dynamic takes precedence.\n // Two files of the SAME kind (static+static or dynamic+dynamic) are a\n // build error — picking one by readdir order is platform-dependent.\n // See design/16-metadata.md §\"Metadata Routes\"\n const metaInfo = classifyMetadataRoute(entry);\n if (metaInfo) {\n if (!metaInfo.nestable && node.segmentName !== '') {\n throw new Error(\n `Build error: '${name}' is a root-only metadata convention and must be in the app root directory.\\n` +\n ` File: ${fullPath}\\n` +\n ` Move this file to the app root (not a route group or nested segment).`\n );\n }\n if (!node.metadataRoutes) {\n node.metadataRoutes = {};\n }\n const existing = node.metadataRoutes[name];\n if (existing) {\n const existingIsDynamic = isDynamicMetadataExtension(name, existing.extension);\n const newIsDynamic = isDynamicMetadataExtension(name, ext);\n if (existingIsDynamic === newIsDynamic) {\n throwDuplicateConvention(name, existing.filePath, fullPath);\n }\n // Dynamic > static precedence: overwrite only when the new file is dynamic.\n if (newIsDynamic) {\n node.metadataRoutes[name] = { filePath: fullPath, extension: ext };\n }\n } else {\n node.metadataRoutes[name] = { filePath: fullPath, extension: ext };\n }\n }\n }\n\n // Validate: route.ts + page.* is a hard build error\n if (node.route && node.page) {\n throw new Error(\n `Build error: route.ts and page.* cannot coexist in the same segment.\\n` +\n ` route.ts: ${node.route.filePath}\\n` +\n ` page: ${node.page.filePath}\\n` +\n `A URL is either an API endpoint or a rendered page, not both.`\n );\n }\n\n // The per-route CSRF exemption is read from source here, at scan time, so\n // the manifest carries it and the request gate never loads user code to\n // decide it. Any other spelling of the export is a lint error\n // (convention-lint.ts `checkCsrfExports`).\n if (node.route && getCsrfExport(node.route.filePath) === 'exempt') {\n node.csrfExempt = true;\n }\n}\n\n/**\n * Throw a build error for two files claiming the same convention slot in\n * one segment (e.g. page.tsx + page.jsx). Which file readdir returns first\n * is platform-dependent (APFS sorts entries, ext4 does not) — silently\n * picking one would let macOS dev and Linux CI serve different\n * implementations of the same route.\n */\nfunction throwDuplicateConvention(\n convention: string,\n firstPath: string,\n secondPath: string\n): never {\n throw new Error(\n `Build error: duplicate '${convention}' files in the same route segment.\\n` +\n ` File 1: ${firstPath}\\n` +\n ` File 2: ${secondPath}\\n` +\n `Each segment may define '${convention}' at most once. Remove one of the files.`\n );\n}\n\n/**\n * Recursively scan child directories and build the segment tree.\n */\nfunction scanChildren(dirPath: string, parentNode: SegmentNode, extSet: Set<string>): void {\n let entries: string[];\n try {\n entries = readdirSync(dirPath);\n } catch (err) {\n swallow(err, `scanChildren: unreadable directory ${dirPath}`, { level: 'warn' });\n return;\n }\n\n for (const entry of entries) {\n const fullPath = join(dirPath, entry);\n\n try {\n if (!statSync(fullPath).isDirectory()) continue;\n } catch {\n continue;\n }\n\n // Reject directories with encoded path delimiters or null bytes.\n // These can cause route collisions when decoded at the URL boundary.\n // See design/13-security.md §\"Encoded separators rejected\" and §\"Null bytes rejected\".\n if (ENCODED_SEPARATOR_RE.test(entry)) {\n throw new Error(\n `Build error: directory name contains an encoded path delimiter (%2F or %5C).\\n` +\n ` Directory: ${fullPath}\\n` +\n `Encoded separators in directory names cause route collisions when decoded. ` +\n `Rename the directory to remove the encoded delimiter.`\n );\n }\n // `@children` is the implicit slot a layout's `children` prop fills, and\n // the key of the outlet that carries it (`childrenOutletKey`). A slot\n // directory by that name would claim the same outlet and be rendered in\n // place of the children.\n if (entry === '@children') {\n throw new Error(\n `Build error: \"@children\" is reserved and cannot be a slot directory.\\n` +\n ` Directory: ${fullPath}\\n` +\n `A layout's children fill the implicit children slot. Put this content in the ` +\n `parent segment's page, or give the slot another name.`\n );\n }\n if (NULL_BYTE_RE.test(entry)) {\n throw new Error(\n `Build error: directory name contains an encoded null byte (%00).\\n` +\n ` Directory: ${fullPath}\\n` +\n `Encoded null bytes in directory names are not allowed. ` +\n `Rename the directory to remove the null byte encoding.`\n );\n }\n\n const {\n type,\n paramName,\n paramPrefix,\n paramSuffix,\n interceptionMarker,\n interceptedSegmentName,\n } = classifySegment(entry);\n\n // Skip private folders — underscore-prefixed dirs are excluded from routing\n if (type === 'private') continue;\n\n const urlPath = computeUrlPath(parentNode.urlPath, entry, type);\n const childNode = createSegmentNode(\n entry,\n type,\n urlPath,\n paramName,\n interceptionMarker,\n interceptedSegmentName,\n paramPrefix,\n paramSuffix\n );\n\n // Scan this segment's files\n scanSegmentFiles(fullPath, childNode, extSet);\n\n // Recurse into subdirectories\n scanChildren(fullPath, childNode, extSet);\n\n // Attach to parent: slots go into slots record, everything else is a child\n if (type === 'slot') {\n const slotName = entry.slice(1); // remove @\n parentNode.slots[slotName] = childNode;\n } else {\n parentNode.children.push(childNode);\n }\n }\n}\n\n/**\n * Validate that no route chain contains duplicate dynamic param names.\n *\n * Example violation:\n * app/[id]/items/[id]/page.tsx — 'id' appears twice in the ancestor chain.\n *\n * Route groups are transparent — params accumulate through them.\n * Slots are independent — duplicate detection does NOT cross slot boundaries.\n *\n * See design/07-routing.md §\"Duplicate Param Name Detection\"\n */\nfunction validateDuplicateParamNames(root: SegmentNode): void {\n walkForDuplicateParams(root, new Map());\n}\n\n/**\n * Recursively walk the segment tree, tracking seen param names → segment paths.\n * Throws on the first duplicate found.\n */\nfunction walkForDuplicateParams(node: SegmentNode, seen: Map<string, string>): void {\n // Read through the effective identity so an intercepting directory is seen\n // as the segment it intercepts: the scanner leaves `paramName` unset on\n // `(.)[id]`, so a validator reading the node directly is blind to a param\n // the resolver goes on to bind — `@modal/(.)[id]/[id]` would pass here and\n // then silently overwrite the outer `id` at match time, where the ordinary\n // `/[id]/[id]` is rejected. See TIM-1288.\n const { paramName } = effectiveUrlSegment(node);\n\n // If this node introduces a param name, check for duplicates\n if (paramName) {\n const existing = seen.get(paramName);\n if (existing) {\n throw new Error(\n `[timber] Duplicate param name '${paramName}' in route chain.\\n` +\n ` First defined at: ${existing}\\n` +\n ` Duplicate at: ${node.urlPath || '/'}\\n` +\n ` Rename one of the segments to avoid ambiguity.`\n );\n }\n // Add to seen for descendants (use a new Map to avoid polluting siblings)\n seen = new Map(seen);\n seen.set(paramName, node.urlPath || '/');\n }\n\n // Recurse into children (they inherit the accumulated params)\n for (const child of node.children) {\n walkForDuplicateParams(child, seen);\n }\n\n // A slot INHERITS the ancestor params rather than starting fresh: a slot\n // child may not reuse a name its owner already bound\n // (`app/gallery/[id]/@modal/[id]` is rejected). The copy is so sibling\n // slots don't see each other's names, not so the chain is reset.\n //\n // Whether that rule is right is a separate question — slot params are\n // merged over the main route's at read time, so a collision is defined\n // rather than ambiguous — but changing it would change every slot.\n // Tracked as TIM-1287; do not \"fix\" this by making the map fresh without\n // deciding that.\n for (const slotNode of Object.values(node.slots)) {\n walkForDuplicateParams(slotNode, new Map(seen));\n }\n}\n\n/**\n * Validate that each param name uses a single bracket form across the entire route tree.\n *\n * Different bracket forms produce different types:\n * [id] → string\n * [...id] → string[]\n * [[...id]] → string[] | undefined\n *\n * If the same param name appears with multiple forms, the no-argument\n * getSegmentParams() / useSegmentParams() return type becomes ambiguous.\n *\n * Same name + same form across different routes is fine and expected.\n */\nfunction validateUniqueBracketForms(root: SegmentNode): void {\n const forms = new Map<string, { segmentType: SegmentType; urlPath: string }>();\n collectBracketForms(root, forms);\n}\n\nfunction collectBracketForms(\n node: SegmentNode,\n forms: Map<string, { segmentType: SegmentType; urlPath: string }>\n): void {\n // Effective identity, so `(.)[...rest]` is compared as the catch-all it\n // intercepts rather than skipped as an 'intercepting' node (TIM-1288).\n const { paramName, segmentType } = effectiveUrlSegment(node);\n\n if (paramName && segmentType !== 'static' && segmentType !== 'group') {\n const existing = forms.get(paramName);\n if (existing && existing.segmentType !== segmentType) {\n const bracketExamples: Record<string, string> = {\n 'dynamic': `[${paramName}]`,\n 'catch-all': `[...${paramName}]`,\n 'optional-catch-all': `[[...${paramName}]]`,\n };\n throw new Error(\n `[timber] Param name '${paramName}' uses multiple bracket forms.\\n` +\n ` ${bracketExamples[existing.segmentType] ?? existing.segmentType} at: ${existing.urlPath}\\n` +\n ` ${bracketExamples[segmentType] ?? segmentType} at: ${node.urlPath || '/'}\\n` +\n ` Each param name must use a single bracket form across all routes.\\n` +\n ` Rename one of the segments to fix this (e.g., [${paramName}] → [${paramName}Id]).`\n );\n }\n if (!existing) {\n forms.set(paramName, {\n segmentType,\n urlPath: node.urlPath || '/',\n });\n }\n }\n\n for (const child of node.children) {\n collectBracketForms(child, forms);\n }\n for (const slotNode of Object.values(node.slots)) {\n collectBracketForms(slotNode, forms);\n }\n}\n\n/**\n * Validate that no sibling affixed dynamic segments have equal specificity.\n *\n * Among affixed siblings, longer combined prefix+suffix length wins. When two\n * siblings tie (same total affix length), the router would fall back to\n * filesystem scan order — which is platform-dependent. This is a build error.\n *\n * Route groups are URL-transparent, so affixed segments inside different groups\n * at the same level still conflict with each other.\n *\n * Ambiguity requires the two segments to be candidates for the *same* URL\n * part, which is narrower than \"same parent\" once interception is involved:\n *\n * - Plain children and intercepting children never compete. They are resolved\n * by different walks — `findSlotMatch` matches the slot subtree (where\n * `tree-match.ts` ignores intercepting nodes outright) and\n * `findInterceptingMatch` builds a synthetic parent holding only\n * interceptors.\n * - Two interceptors compete only at the same anchor. `(.)a-[id]` and\n * `(..)[slug]-b` in one slot are based at different URL depths, so no\n * pathname reaches both, and `anchorIndex` rejects the one whose base does\n * not match the target. Grouping them together would fail the build for a\n * pair that can never be ambiguous.\n *\n * So candidates are keyed by the position they contend for, then by affix\n * length. See design/07-routing.md §\"Priority\" and §\"Intercepting Routes\".\n */\nfunction validateAffixedSiblingConflicts(node: SegmentNode): void {\n const affixed = collectEffectiveAffixed(node);\n\n if (affixed.length >= 2) {\n const byLength = new Map<string, SegmentNode[]>();\n for (const child of affixed) {\n // `\\0` as the separator, written as the escape rather than a literal\n // byte: a raw NUL in the source makes git and grep treat this file as\n // binary. A contention key is a URL path, which cannot contain one, so\n // the two halves of the key can never run together.\n const key = `${contentionKey(node, child)}\\0${affixLengthOf(child)}`;\n const group = byLength.get(key);\n if (group) {\n group.push(child);\n } else {\n byLength.set(key, [child]);\n }\n }\n\n for (const [, group] of byLength) {\n if (group.length >= 2) {\n throw new Error(\n `Build error: ambiguous affixed dynamic siblings with equal specificity.\\n` +\n ` Parent: ${node.urlPath || '/'}\\n` +\n ` Segments: ${group.map((s) => s.segmentName).join(', ')}\\n` +\n ` Combined prefix+suffix length: ${affixLengthOf(group[0]!)}\\n` +\n `The router cannot deterministically choose between these — filesystem scan order is platform-dependent.\\n` +\n `Rename one segment to give it a longer or shorter combined affix.`\n );\n }\n }\n }\n\n for (const child of node.children) {\n validateAffixedSiblingConflicts(child);\n }\n for (const slotNode of Object.values(node.slots)) {\n validateAffixedSiblingConflicts(slotNode);\n }\n}\n\n/**\n * The URL position a child contends for, as a comparable key.\n *\n * Plain children contend for the parent's next part. An intercepting child\n * contends for a part determined by its marker's intercepted base, so two\n * markers of different depth are simply different positions — and two markers\n * that compute the *same* base do contend, which is why the key is the base\n * rather than the marker (`(..)` and `(...)` under `/feed` both base at `/`).\n *\n * `groupByInterceptedAnchor` (`routing/interception.ts`) is the canonical\n * statement of that grouping — it is what the resolver walks and what the\n * collision validator checks. This computes the same key from the same\n * `computeInterceptedBase` rather than calling it, because affix ambiguity is\n * decided per *child* and `collectEffectiveAffixed` looks through route groups,\n * so the two do not partition the same set of nodes.\n */\nfunction contentionKey(parent: SegmentNode, child: SegmentNode): string {\n if (child.segmentType !== 'intercepting') return 'child';\n return `intercept:${computeInterceptedBase(parent.urlPath, child.interceptionMarker ?? '(.)')}`;\n}\n\n/** Combined affix length of a node, read through its effective identity. */\nfunction affixLengthOf(node: SegmentNode): number {\n const { paramPrefix, paramSuffix } = effectiveUrlSegment(node);\n return (paramPrefix?.length ?? 0) + (paramSuffix?.length ?? 0);\n}\n\n/**\n * Collect affixed dynamic segments that are effective children of a node.\n * Route groups are URL-transparent, so we look through them recursively.\n *\n * Segments are read through `effectiveUrlSegment`, so an intercepting\n * directory counts as the affixed segment it intercepts: `(.)a-[id]` is\n * `a-[id]`. The proxy the slot resolver builds hands those affixes to\n * `matchUrlParts`, whose equal-length sort is not stable across equal\n * specificity — so two intercepting siblings with the same combined affix\n * length would resolve by filesystem enumeration order, which is precisely\n * what this validator exists to prevent for ordinary siblings (TIM-1288).\n */\nfunction collectEffectiveAffixed(node: SegmentNode): SegmentNode[] {\n const result: SegmentNode[] = [];\n for (const child of node.children) {\n const { segmentType, paramPrefix, paramSuffix } = effectiveUrlSegment(child);\n if (segmentType === 'dynamic' && (paramPrefix || paramSuffix)) {\n result.push(child);\n } else if (segmentType === 'group') {\n result.push(...collectEffectiveAffixed(child));\n }\n }\n return result;\n}\n\n/**\n * Find a fixed-extension file (proxy.ts) in a directory.\n */\nfunction findFixedFile(dirPath: string, name: string): RouteFile | undefined {\n for (const ext of ['ts', 'tsx']) {\n const fullPath = join(dirPath, `${name}.${ext}`);\n try {\n if (statSync(fullPath).isFile()) {\n return { filePath: fullPath, extension: ext };\n }\n } catch {\n // File doesn't exist\n }\n }\n return undefined;\n}\n\n/**\n * Find a file with script extensions (tsx, ts, jsx, js) in a directory.\n * Used for app-root conventions like global-error that only accept script\n * extensions (TIM-1505).\n */\nfunction findScriptExtFile(dirPath: string, name: string): RouteFile | undefined {\n for (const ext of ['tsx', 'ts', 'jsx', 'js']) {\n const fullPath = join(dirPath, `${name}.${ext}`);\n try {\n if (statSync(fullPath).isFile()) {\n return { filePath: fullPath, extension: ext };\n }\n } catch {\n // File doesn't exist\n }\n }\n return undefined;\n}\n"],"mappings":"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"}