@vercel/geistdocs 1.24.1 → 1.25.1-canary.47f1ad5

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 (405) hide show
  1. package/dist/cli/index.js +1 -1
  2. package/dist/components/blockquote.d.ts +3 -0
  3. package/dist/components/blockquote.d.ts.map +1 -0
  4. package/dist/components/blockquote.js +3 -0
  5. package/dist/components/callout.d.ts +13 -10
  6. package/dist/components/callout.d.ts.map +1 -1
  7. package/dist/components/callout.js +7 -7
  8. package/dist/components/code-block-tabs.d.ts +5 -2
  9. package/dist/components/code-block-tabs.d.ts.map +1 -1
  10. package/dist/components/code-block-tabs.js +30 -5
  11. package/dist/components/code-block.d.ts +2 -6
  12. package/dist/components/code-block.d.ts.map +1 -1
  13. package/dist/components/code-block.js +22 -68
  14. package/dist/components/command-prompt.d.ts.map +1 -1
  15. package/dist/components/command-prompt.js +18 -25
  16. package/dist/components/copy-prompt.d.ts +2 -1
  17. package/dist/components/copy-prompt.d.ts.map +1 -1
  18. package/dist/components/copy-prompt.js +5 -5
  19. package/dist/components/heading.d.ts +7 -0
  20. package/dist/components/heading.d.ts.map +1 -0
  21. package/dist/components/heading.js +14 -0
  22. package/dist/components/mermaid.js +1 -1
  23. package/dist/components/table.d.ts +3 -0
  24. package/dist/components/table.d.ts.map +1 -0
  25. package/dist/components/table.js +3 -0
  26. package/dist/controls.d.ts +8 -4
  27. package/dist/controls.d.ts.map +1 -1
  28. package/dist/controls.js +14 -14
  29. package/dist/footer.d.ts.map +1 -1
  30. package/dist/footer.js +6 -6
  31. package/dist/home-layout.js +1 -1
  32. package/dist/internal/app-route-manifest.d.ts +19 -0
  33. package/dist/internal/app-route-manifest.d.ts.map +1 -0
  34. package/dist/internal/app-route-manifest.js +121 -0
  35. package/dist/internal/app-route-scanner.d.ts +9 -0
  36. package/dist/internal/app-route-scanner.d.ts.map +1 -0
  37. package/dist/internal/app-route-scanner.js +149 -0
  38. package/dist/internal/chat/conversation.d.ts +4 -3
  39. package/dist/internal/chat/conversation.d.ts.map +1 -1
  40. package/dist/internal/chat/conversation.js +5 -5
  41. package/dist/internal/chat/copy-chat.d.ts.map +1 -1
  42. package/dist/internal/chat/copy-chat.js +13 -10
  43. package/dist/internal/chat/dots-spinner.d.ts +5 -0
  44. package/dist/internal/chat/dots-spinner.d.ts.map +1 -0
  45. package/dist/internal/chat/dots-spinner.js +21 -0
  46. package/dist/internal/chat/message-metadata.d.ts.map +1 -1
  47. package/dist/internal/chat/message-metadata.js +8 -7
  48. package/dist/internal/chat/message.d.ts.map +1 -1
  49. package/dist/internal/chat/message.js +5 -5
  50. package/dist/internal/chat/prompt-input.d.ts +1 -1
  51. package/dist/internal/chat/prompt-input.d.ts.map +1 -1
  52. package/dist/internal/chat/prompt-input.js +25 -27
  53. package/dist/internal/chat/shell.d.ts.map +1 -1
  54. package/dist/internal/chat/shell.js +28 -20
  55. package/dist/internal/chat/sources.d.ts +3 -1
  56. package/dist/internal/chat/sources.d.ts.map +1 -1
  57. package/dist/internal/chat/sources.js +6 -6
  58. package/dist/internal/chat/suggestion.d.ts +11 -6
  59. package/dist/internal/chat/suggestion.d.ts.map +1 -1
  60. package/dist/internal/chat/suggestion.js +5 -5
  61. package/dist/internal/docs-page-error-boundary.d.ts.map +1 -1
  62. package/dist/internal/docs-page-error-boundary.js +3 -3
  63. package/dist/internal/external-arrow.d.ts.map +1 -1
  64. package/dist/internal/external-arrow.js +1 -1
  65. package/dist/internal/footer/rss-button.d.ts.map +1 -1
  66. package/dist/internal/footer/rss-button.js +3 -3
  67. package/dist/internal/github-button.d.ts.map +1 -1
  68. package/dist/internal/github-button.js +3 -3
  69. package/dist/internal/navbar/desktop-menu.d.ts.map +1 -1
  70. package/dist/internal/navbar/desktop-menu.js +3 -3
  71. package/dist/internal/navbar/mobile-menu.d.ts.map +1 -1
  72. package/dist/internal/navbar/mobile-menu.js +11 -16
  73. package/dist/internal/navbar/navbar-logo.d.ts.map +1 -1
  74. package/dist/internal/navbar/navbar-logo.js +6 -8
  75. package/dist/internal/navbar/navbar-shell.d.ts.map +1 -1
  76. package/dist/internal/navbar/navbar-shell.js +1 -1
  77. package/dist/internal/page-actions-client.d.ts.map +1 -1
  78. package/dist/internal/page-actions-client.js +49 -29
  79. package/dist/internal/page-breadcrumb.d.ts.map +1 -1
  80. package/dist/internal/page-breadcrumb.js +3 -3
  81. package/dist/internal/page-footer.d.ts.map +1 -1
  82. package/dist/internal/page-footer.js +2 -2
  83. package/dist/internal/provider-client.d.ts.map +1 -1
  84. package/dist/internal/provider-client.js +9 -9
  85. package/dist/internal/search.d.ts.map +1 -1
  86. package/dist/internal/search.js +2 -2
  87. package/dist/internal/sidebar-responsive.d.ts +0 -1
  88. package/dist/internal/sidebar-responsive.d.ts.map +1 -1
  89. package/dist/internal/sidebar-responsive.js +0 -9
  90. package/dist/internal/sidebar-tree.d.ts.map +1 -1
  91. package/dist/internal/sidebar-tree.js +9 -7
  92. package/dist/internal/sidebar.d.ts.map +1 -1
  93. package/dist/internal/sidebar.js +66 -40
  94. package/dist/internal/table-of-contents.d.ts.map +1 -1
  95. package/dist/internal/table-of-contents.js +1 -1
  96. package/dist/internal/toc-items.d.ts.map +1 -1
  97. package/dist/internal/toc-items.js +17 -7
  98. package/dist/internal/ui/dropdown-menu.d.ts.map +1 -1
  99. package/dist/internal/ui/dropdown-menu.js +8 -8
  100. package/dist/internal/ui/navigation-menu.d.ts.map +1 -1
  101. package/dist/internal/ui/navigation-menu.js +4 -4
  102. package/dist/internal/ui/popover.d.ts.map +1 -1
  103. package/dist/internal/ui/popover.js +1 -1
  104. package/dist/internal/ui/scroll-area.d.ts.map +1 -1
  105. package/dist/internal/ui/scroll-area.js +1 -1
  106. package/dist/internal/use-mobile.d.ts.map +1 -1
  107. package/dist/internal/use-mobile.js +2 -12
  108. package/dist/layout.d.ts +1 -0
  109. package/dist/layout.d.ts.map +1 -1
  110. package/dist/layout.js +3 -1
  111. package/dist/mdx.d.ts.map +1 -1
  112. package/dist/mdx.js +18 -3
  113. package/dist/mobile-docs-bar.d.ts.map +1 -1
  114. package/dist/mobile-docs-bar.js +1 -2
  115. package/dist/navbar.js +3 -2
  116. package/dist/next.d.ts +6 -0
  117. package/dist/next.d.ts.map +1 -0
  118. package/dist/next.js +52 -0
  119. package/dist/pages/docs.d.ts.map +1 -1
  120. package/dist/pages/docs.js +8 -3
  121. package/dist/proxy.d.ts +2 -1
  122. package/dist/proxy.d.ts.map +1 -1
  123. package/dist/proxy.js +28 -5
  124. package/dist/routes/llms.d.ts +1 -1
  125. package/dist/routes/llms.d.ts.map +1 -1
  126. package/dist/routes/llms.js +1 -1
  127. package/dist/source.d.ts.map +1 -1
  128. package/dist/source.js +0 -2
  129. package/dist/versions.d.ts.map +1 -1
  130. package/dist/versions.js +5 -5
  131. package/docs/agents.md +2 -3
  132. package/docs/llms.txt +231 -98
  133. package/docs/manifest.json +2 -11
  134. package/docs/pages/configuration.md +8 -0
  135. package/docs/pages/md.md +8 -5
  136. package/docs/pages/migration.md +12 -12
  137. package/docs/pages/proxy.md +20 -1
  138. package/docs/pages/syntax.md +178 -11
  139. package/docs/pages/versioned-docs.md +3 -3
  140. package/docs/sitemap.md +1 -2
  141. package/package.json +15 -102
  142. package/styles.css +3 -2
  143. package/template/AGENTS.md +12 -0
  144. package/template/app/[lang]/(home)/components/hero.tsx +2 -2
  145. package/template/app/[lang]/(home)/components/one-two-section.tsx +9 -1
  146. package/template/app/[lang]/(home)/components/text-grid-section.tsx +1 -1
  147. package/template/app/[lang]/(home)/page.tsx +5 -6
  148. package/template/app/[lang]/layout.tsx +11 -4
  149. package/template/app/[lang]/llms.mdx/[[...slug]]/route.ts +0 -1
  150. package/template/app/styles/geistdocs.css +18 -15
  151. package/template/components/ui/button.tsx +1 -1
  152. package/template/content/docs/configuration.cn.mdx +2 -2
  153. package/template/content/docs/configuration.mdx +8 -0
  154. package/template/content/docs/md.mdx +8 -5
  155. package/template/content/docs/migration.mdx +12 -12
  156. package/template/content/docs/proxy.mdx +20 -1
  157. package/template/content/docs/syntax.mdx +183 -11
  158. package/template/content/docs/versioned-docs.mdx +3 -3
  159. package/template/lib/geistdocs/config.tsx +0 -5
  160. package/template/next.config.ts +19 -5
  161. package/template/package.json +5 -7
  162. package/theme.css +39 -695
  163. package/dist/assets/icons/icon-acronym-ts.d.ts +0 -5
  164. package/dist/assets/icons/icon-acronym-ts.d.ts.map +0 -1
  165. package/dist/assets/icons/icon-acronym-ts.js +0 -4
  166. package/dist/assets/icons/icon-agents.d.ts +0 -5
  167. package/dist/assets/icons/icon-agents.d.ts.map +0 -1
  168. package/dist/assets/icons/icon-agents.js +0 -4
  169. package/dist/assets/icons/icon-api.d.ts +0 -5
  170. package/dist/assets/icons/icon-api.d.ts.map +0 -1
  171. package/dist/assets/icons/icon-api.js +0 -4
  172. package/dist/assets/icons/icon-arrow-up-right-small.d.ts +0 -8
  173. package/dist/assets/icons/icon-arrow-up-right-small.d.ts.map +0 -1
  174. package/dist/assets/icons/icon-arrow-up-right-small.js +0 -4
  175. package/dist/assets/icons/icon-arrow-up-right.d.ts +0 -5
  176. package/dist/assets/icons/icon-arrow-up-right.d.ts.map +0 -1
  177. package/dist/assets/icons/icon-arrow-up-right.js +0 -4
  178. package/dist/assets/icons/icon-check.d.ts +0 -5
  179. package/dist/assets/icons/icon-check.d.ts.map +0 -1
  180. package/dist/assets/icons/icon-check.js +0 -4
  181. package/dist/assets/icons/icon-chevron-down-small.d.ts +0 -8
  182. package/dist/assets/icons/icon-chevron-down-small.d.ts.map +0 -1
  183. package/dist/assets/icons/icon-chevron-down-small.js +0 -7
  184. package/dist/assets/icons/icon-chevron-right.d.ts +0 -5
  185. package/dist/assets/icons/icon-chevron-right.d.ts.map +0 -1
  186. package/dist/assets/icons/icon-chevron-right.js +0 -4
  187. package/dist/assets/icons/icon-clock.d.ts +0 -5
  188. package/dist/assets/icons/icon-clock.d.ts.map +0 -1
  189. package/dist/assets/icons/icon-clock.js +0 -4
  190. package/dist/assets/icons/icon-copy.d.ts +0 -5
  191. package/dist/assets/icons/icon-copy.d.ts.map +0 -1
  192. package/dist/assets/icons/icon-copy.js +0 -4
  193. package/dist/assets/icons/icon-display-small.d.ts +0 -5
  194. package/dist/assets/icons/icon-display-small.d.ts.map +0 -1
  195. package/dist/assets/icons/icon-display-small.js +0 -4
  196. package/dist/assets/icons/icon-display.d.ts +0 -5
  197. package/dist/assets/icons/icon-display.d.ts.map +0 -1
  198. package/dist/assets/icons/icon-display.js +0 -4
  199. package/dist/assets/icons/icon-file-text.d.ts +0 -5
  200. package/dist/assets/icons/icon-file-text.d.ts.map +0 -1
  201. package/dist/assets/icons/icon-file-text.js +0 -4
  202. package/dist/assets/icons/icon-folder-open.d.ts +0 -5
  203. package/dist/assets/icons/icon-folder-open.d.ts.map +0 -1
  204. package/dist/assets/icons/icon-folder-open.js +0 -4
  205. package/dist/assets/icons/icon-linked.d.ts +0 -5
  206. package/dist/assets/icons/icon-linked.d.ts.map +0 -1
  207. package/dist/assets/icons/icon-linked.js +0 -4
  208. package/dist/assets/icons/icon-logs.d.ts +0 -5
  209. package/dist/assets/icons/icon-logs.d.ts.map +0 -1
  210. package/dist/assets/icons/icon-logs.js +0 -4
  211. package/dist/assets/icons/icon-menu-alt.d.ts +0 -5
  212. package/dist/assets/icons/icon-menu-alt.d.ts.map +0 -1
  213. package/dist/assets/icons/icon-menu-alt.js +0 -4
  214. package/dist/assets/icons/icon-message.d.ts +0 -5
  215. package/dist/assets/icons/icon-message.d.ts.map +0 -1
  216. package/dist/assets/icons/icon-message.js +0 -4
  217. package/dist/assets/icons/icon-moon-small.d.ts +0 -5
  218. package/dist/assets/icons/icon-moon-small.d.ts.map +0 -1
  219. package/dist/assets/icons/icon-moon-small.js +0 -4
  220. package/dist/assets/icons/icon-moon.d.ts +0 -5
  221. package/dist/assets/icons/icon-moon.d.ts.map +0 -1
  222. package/dist/assets/icons/icon-moon.js +0 -4
  223. package/dist/assets/icons/icon-openai.d.ts +0 -5
  224. package/dist/assets/icons/icon-openai.d.ts.map +0 -1
  225. package/dist/assets/icons/icon-openai.js +0 -4
  226. package/dist/assets/icons/icon-plus-circle.d.ts +0 -5
  227. package/dist/assets/icons/icon-plus-circle.d.ts.map +0 -1
  228. package/dist/assets/icons/icon-plus-circle.js +0 -4
  229. package/dist/assets/icons/icon-refresh-counter-clockwise.d.ts +0 -5
  230. package/dist/assets/icons/icon-refresh-counter-clockwise.d.ts.map +0 -1
  231. package/dist/assets/icons/icon-refresh-counter-clockwise.js +0 -4
  232. package/dist/assets/icons/icon-robot.d.ts +0 -5
  233. package/dist/assets/icons/icon-robot.d.ts.map +0 -1
  234. package/dist/assets/icons/icon-robot.js +0 -4
  235. package/dist/assets/icons/icon-sandbox.d.ts +0 -5
  236. package/dist/assets/icons/icon-sandbox.d.ts.map +0 -1
  237. package/dist/assets/icons/icon-sandbox.js +0 -4
  238. package/dist/assets/icons/icon-slash-forward.d.ts +0 -8
  239. package/dist/assets/icons/icon-slash-forward.d.ts.map +0 -1
  240. package/dist/assets/icons/icon-slash-forward.js +0 -4
  241. package/dist/assets/icons/icon-sparkles.d.ts +0 -5
  242. package/dist/assets/icons/icon-sparkles.d.ts.map +0 -1
  243. package/dist/assets/icons/icon-sparkles.js +0 -4
  244. package/dist/assets/icons/icon-sun-small.d.ts +0 -5
  245. package/dist/assets/icons/icon-sun-small.d.ts.map +0 -1
  246. package/dist/assets/icons/icon-sun-small.js +0 -4
  247. package/dist/assets/icons/icon-sun.d.ts +0 -5
  248. package/dist/assets/icons/icon-sun.d.ts.map +0 -1
  249. package/dist/assets/icons/icon-sun.js +0 -4
  250. package/dist/assets/icons/icon-trash.d.ts +0 -5
  251. package/dist/assets/icons/icon-trash.d.ts.map +0 -1
  252. package/dist/assets/icons/icon-trash.js +0 -4
  253. package/dist/assets/icons/icon-user.d.ts +0 -5
  254. package/dist/assets/icons/icon-user.d.ts.map +0 -1
  255. package/dist/assets/icons/icon-user.js +0 -4
  256. package/dist/assets/icons/icon-workflow.d.ts +0 -5
  257. package/dist/assets/icons/icon-workflow.d.ts.map +0 -1
  258. package/dist/assets/icons/icon-workflow.js +0 -4
  259. package/dist/assets/icons/icon-wrench.d.ts +0 -5
  260. package/dist/assets/icons/icon-wrench.d.ts.map +0 -1
  261. package/dist/assets/icons/icon-wrench.js +0 -4
  262. package/dist/assets/icons/index.d.ts +0 -35
  263. package/dist/assets/icons/index.d.ts.map +0 -1
  264. package/dist/assets/icons/index.js +0 -35
  265. package/dist/assets/logos/index.d.ts +0 -17
  266. package/dist/assets/logos/index.d.ts.map +0 -1
  267. package/dist/assets/logos/index.js +0 -17
  268. package/dist/assets/logos/logo-ai-elements.d.ts +0 -5
  269. package/dist/assets/logos/logo-ai-elements.d.ts.map +0 -1
  270. package/dist/assets/logos/logo-ai-elements.js +0 -5
  271. package/dist/assets/logos/logo-ai-sdk.d.ts +0 -5
  272. package/dist/assets/logos/logo-ai-sdk.d.ts.map +0 -1
  273. package/dist/assets/logos/logo-ai-sdk.js +0 -5
  274. package/dist/assets/logos/logo-chat-sdk.d.ts +0 -5
  275. package/dist/assets/logos/logo-chat-sdk.d.ts.map +0 -1
  276. package/dist/assets/logos/logo-chat-sdk.js +0 -5
  277. package/dist/assets/logos/logo-eve.d.ts +0 -5
  278. package/dist/assets/logos/logo-eve.d.ts.map +0 -1
  279. package/dist/assets/logos/logo-eve.js +0 -5
  280. package/dist/assets/logos/logo-flags-sdk.d.ts +0 -5
  281. package/dist/assets/logos/logo-flags-sdk.d.ts.map +0 -1
  282. package/dist/assets/logos/logo-flags-sdk.js +0 -5
  283. package/dist/assets/logos/logo-icon-vercel.d.ts +0 -5
  284. package/dist/assets/logos/logo-icon-vercel.d.ts.map +0 -1
  285. package/dist/assets/logos/logo-icon-vercel.js +0 -4
  286. package/dist/assets/logos/logo-nextjs.d.ts +0 -5
  287. package/dist/assets/logos/logo-nextjs.d.ts.map +0 -1
  288. package/dist/assets/logos/logo-nextjs.js +0 -9
  289. package/dist/assets/logos/logo-streamdown.d.ts +0 -5
  290. package/dist/assets/logos/logo-streamdown.d.ts.map +0 -1
  291. package/dist/assets/logos/logo-streamdown.js +0 -5
  292. package/dist/assets/logos/logo-svelte-kit.d.ts +0 -5
  293. package/dist/assets/logos/logo-svelte-kit.d.ts.map +0 -1
  294. package/dist/assets/logos/logo-svelte-kit.js +0 -4
  295. package/dist/assets/logos/logo-turborepo.d.ts +0 -5
  296. package/dist/assets/logos/logo-turborepo.d.ts.map +0 -1
  297. package/dist/assets/logos/logo-turborepo.js +0 -5
  298. package/dist/assets/logos/logo-vercel-oss.d.ts +0 -5
  299. package/dist/assets/logos/logo-vercel-oss.d.ts.map +0 -1
  300. package/dist/assets/logos/logo-vercel-oss.js +0 -4
  301. package/dist/assets/logos/logo-workflow-sdk.d.ts +0 -5
  302. package/dist/assets/logos/logo-workflow-sdk.d.ts.map +0 -1
  303. package/dist/assets/logos/logo-workflow-sdk.js +0 -5
  304. package/dist/components/badge.d.ts +0 -11
  305. package/dist/components/badge.d.ts.map +0 -1
  306. package/dist/components/badge.js +0 -22
  307. package/dist/components/button-group.d.ts +0 -2
  308. package/dist/components/button-group.d.ts.map +0 -1
  309. package/dist/components/button-group.js +0 -2
  310. package/dist/components/button.d.ts +0 -2
  311. package/dist/components/button.d.ts.map +0 -1
  312. package/dist/components/button.js +0 -2
  313. package/dist/components/card.d.ts +0 -2
  314. package/dist/components/card.d.ts.map +0 -1
  315. package/dist/components/card.js +0 -2
  316. package/dist/components/dialog.d.ts +0 -13
  317. package/dist/components/dialog.d.ts.map +0 -1
  318. package/dist/components/dialog.js +0 -35
  319. package/dist/components/drawer.d.ts +0 -2
  320. package/dist/components/drawer.d.ts.map +0 -1
  321. package/dist/components/drawer.js +0 -3
  322. package/dist/components/input-group.d.ts +0 -2
  323. package/dist/components/input-group.d.ts.map +0 -1
  324. package/dist/components/input-group.js +0 -3
  325. package/dist/components/input.d.ts +0 -2
  326. package/dist/components/input.d.ts.map +0 -1
  327. package/dist/components/input.js +0 -2
  328. package/dist/components/kbd.d.ts +0 -2
  329. package/dist/components/kbd.d.ts.map +0 -1
  330. package/dist/components/kbd.js +0 -2
  331. package/dist/components/separator.d.ts +0 -2
  332. package/dist/components/separator.d.ts.map +0 -1
  333. package/dist/components/separator.js +0 -3
  334. package/dist/components/sheet.d.ts +0 -2
  335. package/dist/components/sheet.d.ts.map +0 -1
  336. package/dist/components/sheet.js +0 -3
  337. package/dist/components/sonner.d.ts +0 -2
  338. package/dist/components/sonner.d.ts.map +0 -1
  339. package/dist/components/sonner.js +0 -3
  340. package/dist/components/spinner.d.ts +0 -2
  341. package/dist/components/spinner.d.ts.map +0 -1
  342. package/dist/components/spinner.js +0 -2
  343. package/dist/components/switch.d.ts +0 -11
  344. package/dist/components/switch.d.ts.map +0 -1
  345. package/dist/components/switch.js +0 -12
  346. package/dist/components/textarea.d.ts +0 -2
  347. package/dist/components/textarea.d.ts.map +0 -1
  348. package/dist/components/textarea.js +0 -2
  349. package/dist/components/theme-aware-image.d.ts +0 -12
  350. package/dist/components/theme-aware-image.d.ts.map +0 -1
  351. package/dist/components/theme-aware-image.js +0 -8
  352. package/dist/components/theme-switcher.d.ts +0 -8
  353. package/dist/components/theme-switcher.d.ts.map +0 -1
  354. package/dist/components/theme-switcher.js +0 -37
  355. package/dist/components/tooltip.d.ts +0 -2
  356. package/dist/components/tooltip.d.ts.map +0 -1
  357. package/dist/components/tooltip.js +0 -3
  358. package/dist/internal/chat/shimmer.d.ts +0 -11
  359. package/dist/internal/chat/shimmer.d.ts.map +0 -1
  360. package/dist/internal/chat/shimmer.js +0 -22
  361. package/dist/internal/cn.d.ts +0 -3
  362. package/dist/internal/cn.d.ts.map +0 -1
  363. package/dist/internal/cn.js +0 -47
  364. package/dist/internal/ui/button-group.d.ts +0 -13
  365. package/dist/internal/ui/button-group.d.ts.map +0 -1
  366. package/dist/internal/ui/button-group.js +0 -26
  367. package/dist/internal/ui/button.d.ts +0 -12
  368. package/dist/internal/ui/button.d.ts.map +0 -1
  369. package/dist/internal/ui/button.js +0 -33
  370. package/dist/internal/ui/card.d.ts +0 -6
  371. package/dist/internal/ui/card.d.ts.map +0 -1
  372. package/dist/internal/ui/card.js +0 -14
  373. package/dist/internal/ui/drawer.d.ts +0 -8
  374. package/dist/internal/ui/drawer.d.ts.map +0 -1
  375. package/dist/internal/ui/drawer.js +0 -19
  376. package/dist/internal/ui/input-group.d.ts +0 -15
  377. package/dist/internal/ui/input-group.d.ts.map +0 -1
  378. package/dist/internal/ui/input-group.js +0 -44
  379. package/dist/internal/ui/input.d.ts +0 -3
  380. package/dist/internal/ui/input.d.ts.map +0 -1
  381. package/dist/internal/ui/input.js +0 -5
  382. package/dist/internal/ui/kbd.d.ts +0 -4
  383. package/dist/internal/ui/kbd.d.ts.map +0 -1
  384. package/dist/internal/ui/kbd.js +0 -8
  385. package/dist/internal/ui/separator.d.ts +0 -4
  386. package/dist/internal/ui/separator.d.ts.map +0 -1
  387. package/dist/internal/ui/separator.js +0 -7
  388. package/dist/internal/ui/sheet.d.ts +0 -13
  389. package/dist/internal/ui/sheet.d.ts.map +0 -1
  390. package/dist/internal/ui/sheet.js +0 -24
  391. package/dist/internal/ui/sonner.d.ts +0 -3
  392. package/dist/internal/ui/sonner.d.ts.map +0 -1
  393. package/dist/internal/ui/sonner.js +0 -20
  394. package/dist/internal/ui/spinner.d.ts +0 -3
  395. package/dist/internal/ui/spinner.d.ts.map +0 -1
  396. package/dist/internal/ui/spinner.js +0 -6
  397. package/dist/internal/ui/textarea.d.ts +0 -3
  398. package/dist/internal/ui/textarea.d.ts.map +0 -1
  399. package/dist/internal/ui/textarea.js +0 -5
  400. package/dist/internal/ui/tooltip.d.ts +0 -7
  401. package/dist/internal/ui/tooltip.d.ts.map +0 -1
  402. package/dist/internal/ui/tooltip.js +0 -16
  403. package/docs/pages/theme-aware-image.md +0 -59
  404. package/template/app/[lang]/(home)/components/centered-section.tsx +0 -32
  405. package/template/content/docs/theme-aware-image.mdx +0 -57
package/docs/llms.txt CHANGED
@@ -1,6 +1,6 @@
1
1
  # Geistdocs Package Documentation
2
2
 
3
- These docs are bundled with `@vercel/geistdocs` 1.24.1.
3
+ These docs are bundled with `@vercel/geistdocs` 1.25.1-canary.47f1ad5.
4
4
  They describe how to build package-backed Geistdocs sites and how to use the package APIs from generated project adapters.
5
5
 
6
6
  ## Documentation Index
@@ -14,7 +14,7 @@ They describe how to build package-backed Geistdocs sites and how to use the pac
14
14
  - [Syntax](pages/syntax.md): Supported MDX syntax including text formatting, code blocks, line highlighting, and Mermaid diagrams.
15
15
  - [Geistdocs Provider](pages/provider.md): The root provider component that wraps your application to handle toast notifications, search, and analytics.
16
16
  - [Versioned docs](pages/versioned-docs.md): Use createVersionedSources to configure stable, pre-release, or host-based documentation versions.
17
- - [Proxy and markdown routes](pages/proxy.md): Configure createProxy with before and after hooks, markdown route mappings, and a static Next.js matcher.
17
+ - [Proxy and markdown routes](pages/proxy.md): Configure createProxy with generated route discovery, request hooks, markdown mappings, and a static Next.js matcher.
18
18
  - [.md Extension](pages/md.md): Access any documentation page as raw Markdown by appending .md or .mdx to the URL for AI tool consumption.
19
19
  - [Agent readiness](pages/agent-readiness.md): Generate /agents.md and /.well-known/mcp.json from Geistdocs config so agents can find docs, Markdown surfaces, API specs, and MCP endpoints.
20
20
  - [Ask AI](pages/ask-ai.md): An AI-powered chat assistant with context-aware search, persistent history, and suggested prompts for your documentation.
@@ -26,7 +26,6 @@ They describe how to build package-backed Geistdocs sites and how to use the pac
26
26
  - [Open in Chat](pages/open-in-chat.md): Transfer documentation context to AI chat platforms like ChatGPT, Claude, Cursor, and v0 with a single click.
27
27
  - [RSS](pages/rss.md): An automatically generated RSS 2.0 feed that keeps users informed when documentation is published or updated.
28
28
  - [Table of contents](pages/table-of-contents.md): Geistdocs builds the "On this page" outline from your headings, indents sub-headings under their parent, and tracks the active section along a straight vertical guide rail.
29
- - [Theme-Aware Image](pages/theme-aware-image.md): A component that swaps images based on the active theme, built on top of Next.js Image.
30
29
 
31
30
  ---
32
31
 
@@ -424,7 +423,7 @@ Fix unrelated build failures first. A migration is safer when the starting point
424
423
 
425
424
  ## Install Geistdocs
426
425
 
427
- Add `@vercel/geistdocs` and align the supported Fumadocs and Next.js dependencies for the package version you are adopting.
426
+ Add `@vercel/geistdocs` and align the supported Fumadocs and Next.js dependencies for the package version you are adopting. Geistdocs requires Next.js 16.3.3 or later within 16.x. Earlier 16.3 releases can retain an optional catch-all route's index content after a client navigation to a child page when Cache Components and Partial Prefetching are enabled.
428
427
 
429
428
  For an existing project, use your package manager directly:
430
429
 
@@ -438,24 +437,26 @@ If you are starting from a generated Geistdocs project and moving content into i
438
437
  pnpm dlx @vercel/geistdocs init --name my-docs
439
438
  ```
440
439
 
441
- ## Enable Cache Components
440
+ ## Configure Next.js
442
441
 
443
- Geistdocs uses Next.js Cache Components to prerender static application shells while dynamic content streams from the server. Enable Cache Components in `next.config.ts`:
442
+ The Geistdocs Next.js integration composes Fumadocs MDX, enables automatic app-route discovery for agent-readable 404s, and preserves your Next.js configuration. Enable Cache Components in the same file:
444
443
 
445
444
  ```ts title="next.config.ts"
446
- import { createMDX } from "fumadocs-mdx/next";
445
+ import { createGeistdocs } from "@vercel/geistdocs/next";
447
446
  import type { NextConfig } from "next";
448
447
 
449
- const withMDX = createMDX();
448
+ const withGeistdocs = createGeistdocs();
450
449
 
451
450
  const config: NextConfig = {
452
451
  cacheComponents: true,
453
452
  partialPrefetching: true,
454
453
  };
455
454
 
456
- export default withMDX(config);
455
+ export default withGeistdocs(config);
457
456
  ```
458
457
 
458
+ Restart `next dev` after adding, deleting, or renaming an App Router page or route. Production builds always regenerate the route manifest.
459
+
459
460
  Every root dynamic parameter needs at least one value from `generateStaticParams`. For a site with a `[lang]` root segment, return every configured language from the root layout:
460
461
 
461
462
  ```tsx title="app/[lang]/layout.tsx"
@@ -755,16 +756,14 @@ For a base-path application whose root page is documentation, add `"/"` to the s
755
756
  Tailwind CSS v4 requires `@source` entries for package components and related dependencies.
756
757
 
757
758
  ```css title="app/styles/geistdocs.css"
758
- @import "tailwindcss";
759
+ @import "@vercel/geistcn/tailwind.css";
760
+ @import "@vercel/geistcn/styles.css";
759
761
  @import "fumadocs-ui/css/shadcn.css";
760
762
  @import "fumadocs-ui/css/preset.css";
761
- @import "tw-animate-css";
762
-
763
- @source "../../node_modules/@vercel/geistdocs/dist/**/*.js";
764
- @source "../../node_modules/streamdown/dist/*.js";
763
+ @import "@vercel/geistdocs/theme.css";
765
764
  ```
766
765
 
767
- Move Tailwind CSS v3 plugin utilities into CSS-first v4 utilities or theme variables. Keep custom token names stable while you migrate components.
766
+ Geistcn owns the Geist tokens, theme, typography, preflight, and animation utilities. The Geistdocs theme entry point remains during the compatibility migration for documentation and Fumadocs integration rules and to source the compiled runtime dependencies.
768
767
 
769
768
  ## Handle environment variables
770
769
 
@@ -836,6 +835,7 @@ Configure Geistdocs through user-owned files in the generated project. Runtime f
836
835
  | File | Purpose |
837
836
  | --- | --- |
838
837
  | `geistdocs.tsx` | Site-level settings, including logo, nav, GitHub repo, AI prompt, agent-readiness metadata, translations, and feature flags. |
838
+ | `next.config.ts` | Composes Fumadocs MDX, discovers App Router routes, and configures Next.js. |
839
839
  | `source.config.ts` | Configures Fumadocs collections with the package-provided schema, Markdown plugins, and syntax theme. |
840
840
  | `lib/geistdocs/config.tsx` | Converts `geistdocs.tsx` exports into the package config using `defineConfig`. |
841
841
  | `source.config.ts` | Configures Fumadocs collections with package-safe schemas and Markdown processing. |
@@ -1025,11 +1025,18 @@ To serve docs from the site root, use `route: "/"` in `content` and `baseUrl: "/
1025
1025
  When Next.js mounts the application below a path, set the same value in `next.config.ts` and Geistdocs config:
1026
1026
 
1027
1027
  ```ts title="next.config.ts"
1028
+ import { createGeistdocs } from "@vercel/geistdocs/next";
1029
+ import type { NextConfig } from "next";
1030
+
1031
+ const withGeistdocs = createGeistdocs();
1032
+
1028
1033
  const config: NextConfig = {
1029
1034
  basePath: "/docs",
1030
1035
  cacheComponents: true,
1031
1036
  partialPrefetching: true,
1032
1037
  };
1038
+
1039
+ export default withGeistdocs(config);
1033
1040
  ```
1034
1041
 
1035
1042
  ```tsx title="geistdocs.tsx"
@@ -1195,7 +1202,9 @@ related:
1195
1202
 
1196
1203
  Geistdocs supports MDX, a superset of Markdown that allows you to use JSX components within your documentation. This guide covers all the formatting options available.
1197
1204
 
1198
- Help me write a Geistdocs MDX page. Use this page as a syntax reference and create an example page with frontmatter, headings, links, a code block, a `Callout`, and a `CopyPrompt` component.
1205
+ Help me write a Geistdocs MDX page. Use this page as a syntax reference and
1206
+ create an example page with frontmatter, headings, links, a code block, a
1207
+ `Callout`, and a `CopyPrompt` component.
1199
1208
 
1200
1209
  ## Frontmatter
1201
1210
 
@@ -1247,11 +1256,17 @@ Headings automatically generate anchor links for navigation and deep linking.
1247
1256
 
1248
1257
  Create unordered lists with `-`, `*`, or `+`:
1249
1258
 
1250
- - First item
1251
- - Second item
1252
- - Nested item
1253
- - Another nested item
1254
- - Third item
1259
+ ```md
1260
+ - Install the required packages
1261
+ - Configure your project
1262
+ - Start the development server
1263
+ ```
1264
+
1265
+ This renders as:
1266
+
1267
+ - Install the required packages
1268
+ - Configure your project
1269
+ - Start the development server
1255
1270
 
1256
1271
  Create ordered lists with numbers:
1257
1272
 
@@ -1263,7 +1278,64 @@ Create ordered lists with numbers:
1263
1278
 
1264
1279
  Use `>` to create blockquotes:
1265
1280
 
1266
- > This is a blockquote. You can use it to highlight important information or quotes from external sources.
1281
+ > **Watch:** Learn more about how to use `next/image` → [YouTube (9 minutes)](https://youtu.be/IU_qq_c_lKA).
1282
+
1283
+ ### Callouts
1284
+
1285
+ Use `<Callout>` for a highlighted informational note:
1286
+
1287
+ ```mdx
1288
+ <Callout>This is automatically set when deploying to Vercel.</Callout>
1289
+ ```
1290
+
1291
+ This renders as:
1292
+
1293
+ > This is automatically set when deploying to Vercel.
1294
+
1295
+ Callouts can also contain a title and lists:
1296
+
1297
+ > Note:
1298
+ - The `App Router` uses [React canary
1299
+ releases](https://react.dev/blog/2023/05/03/react-canaries) built-in, which
1300
+ include all the stable React 19 changes, as well as newer features being
1301
+ validated in frameworks, but you should still declare react and react-dom in
1302
+ package.json for tooling and ecosystem compatibility.
1303
+ - The `Pages Router` uses the React version from your `package.json`.
1304
+
1305
+ ### Copy Prompts
1306
+
1307
+ Short prompts render in full without an expansion control:
1308
+
1309
+ ```mdx
1310
+ <CopyPrompt text="Summarize this documentation page and list the key concepts.">
1311
+ Summarize this documentation page and list the key concepts.
1312
+ </CopyPrompt>
1313
+ ```
1314
+
1315
+ This renders as:
1316
+
1317
+ Summarize this documentation page and list the key concepts.
1318
+
1319
+ Long prompts initially show a preview with a **Show more** control:
1320
+
1321
+ ```mdx
1322
+ <CopyPrompt collapsible text="Write a detailed migration plan for this project.">
1323
+ Write a detailed migration plan for this project. Include prerequisites,
1324
+ implementation steps, validation, rollback guidance, and common pitfalls.
1325
+ </CopyPrompt>
1326
+ ```
1327
+
1328
+ Set the boolean `collapsible` prop when the prompt should initially render as a
1329
+ two-line preview. This renders as:
1330
+
1331
+ Review this Geistdocs project in detail. Explain how the `@vercel/geistdocs`
1332
+ package, application layouts, local adapter files, source configuration,
1333
+ `content/docs` directory, navigation metadata, MDX components, syntax
1334
+ highlighting, search routes, and deployment configuration work together.
1335
+ Then identify the safest first files to edit, describe the effect of each
1336
+ change, call out common mistakes, and propose a step-by-step plan for
1337
+ customizing the documentation site without breaking routing, generated
1338
+ Markdown, or accessibility behavior.
1267
1339
 
1268
1340
  ### Links
1269
1341
 
@@ -1272,6 +1344,26 @@ Create links with `[text](url)`:
1272
1344
  - [External link](https://vercel.com)
1273
1345
  - [Internal link](/docs/getting-started)
1274
1346
 
1347
+ Use an absolute `https://` or `http://` URL to mark a link as external. External
1348
+ links open outside the docs site and display an arrow icon. Use a root-relative
1349
+ path beginning with `/` for internal links:
1350
+
1351
+ ```md
1352
+ [External link](https://vercel.com)
1353
+ [Internal link](/docs/getting-started)
1354
+ ```
1355
+
1356
+ External links can also contain inline code. The underline applies to the text,
1357
+ but not the external-link icon:
1358
+
1359
+ ```md
1360
+ Run independent requests in parallel with [`Promise.all`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise/all).
1361
+ ```
1362
+
1363
+ This renders as:
1364
+
1365
+ Run independent requests in parallel with [`Promise.all`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise/all).
1366
+
1275
1367
  ### Images
1276
1368
 
1277
1369
  Add images with `![alt text](url)`:
@@ -1304,6 +1396,16 @@ This renders as:
1304
1396
  | GFM | GitHub extensions | Supported |
1305
1397
  | MDX | JSX in Markdown | Supported |
1306
1398
 
1399
+ Tables can also include inline code, as commonly used for file references:
1400
+
1401
+ | File | Description |
1402
+ | -------------------- | ------------------------------------------------ |
1403
+ | `next.config.js` | Configuration file for Next.js |
1404
+ | `package.json` | Project dependencies and scripts |
1405
+ | `instrumentation.ts` | OpenTelemetry and instrumentation file |
1406
+ | `.env.local` | Local environment variables |
1407
+ | `tsconfig.json` | Configuration file for TypeScript |
1408
+
1307
1409
  ### Task Lists
1308
1410
 
1309
1411
  Create interactive task lists:
@@ -1376,6 +1478,78 @@ export const Button = ({ children }) => {
1376
1478
  };
1377
1479
  ```
1378
1480
 
1481
+ ### Tabs and switchers
1482
+
1483
+ Use consecutive fences with `tab` metadata for code tabs that expose every
1484
+ option at once:
1485
+
1486
+ ````md
1487
+ ```ts tab="TypeScript" title="example.ts"
1488
+ export const greeting: string = "Hello from TypeScript";
1489
+ ```
1490
+
1491
+ ```js tab="JavaScript" title="example.js"
1492
+ export const greeting = "Hello from JavaScript";
1493
+ ```
1494
+ ````
1495
+
1496
+ This renders as:
1497
+
1498
+ ```ts tab="TypeScript" title="example.ts"
1499
+ export const greeting: string = "Hello from TypeScript";
1500
+ ```
1501
+
1502
+ ```js tab="JavaScript" title="example.js"
1503
+ export const greeting = "Hello from JavaScript";
1504
+ ```
1505
+
1506
+ Wrap the same fences in `<CodeBlockTabs compact>` to move the selector into the
1507
+ code-block header:
1508
+
1509
+ ````mdx
1510
+ <CompactCodeBlockTabs defaultValue="TypeScript">
1511
+ <CodeBlockTabsList>
1512
+ <CodeBlockTabsTrigger value="TypeScript">TypeScript</CodeBlockTabsTrigger>
1513
+ <CodeBlockTabsTrigger value="JavaScript">JavaScript</CodeBlockTabsTrigger>
1514
+ </CodeBlockTabsList>
1515
+ <CodeBlockTab value="TypeScript">
1516
+ ```ts title="example.ts"
1517
+ export const greeting: string = "Hello from TypeScript";
1518
+ ```
1519
+ </CodeBlockTab>
1520
+ <CodeBlockTab value="JavaScript">
1521
+ ```js title="example.js"
1522
+ export const greeting = "Hello from JavaScript";
1523
+ ```
1524
+ </CodeBlockTab>
1525
+ </CompactCodeBlockTabs>
1526
+ ````
1527
+
1528
+ This renders as:
1529
+
1530
+ <CompactCodeBlockTabs defaultValue="TypeScript">
1531
+ <CodeBlockTabsList>
1532
+ <CodeBlockTabsTrigger value="TypeScript">TypeScript</CodeBlockTabsTrigger>
1533
+ <CodeBlockTabsTrigger value="JavaScript">JavaScript</CodeBlockTabsTrigger>
1534
+ </CodeBlockTabsList>
1535
+ <CodeBlockTab value="TypeScript">
1536
+ ```ts title="example.ts"
1537
+ export const greeting: string = "Hello from TypeScript";
1538
+ ```
1539
+ </CodeBlockTab>
1540
+ <CodeBlockTab value="JavaScript">
1541
+ ```js title="example.js"
1542
+ export const greeting = "Hello from JavaScript";
1543
+ ```
1544
+ </CodeBlockTab>
1545
+ </CompactCodeBlockTabs>
1546
+
1547
+ When migrating an existing site such as next-site, translate adjacent
1548
+ `switcher` fences to `tab="TypeScript"` and `tab="JavaScript"`, then wrap the
1549
+ pair with `<CodeBlockTabs compact>`. Import `@vercel/geistdocs/styles.css` (or
1550
+ `theme.css` with the documented Geist dependencies) so Tailwind scans the
1551
+ package's compiled components and emits the tab layout utilities.
1552
+
1379
1553
  ### Framework icons
1380
1554
 
1381
1555
  Append `#<framework>` to the title to show a framework logo instead of the
@@ -1384,22 +1558,22 @@ values are `#next` / `#nextjs` and `#svelte` / `#sveltekit`:
1384
1558
 
1385
1559
  ````md
1386
1560
  ```ts title="flags.ts#next"
1387
- import { flag } from 'flags/next';
1561
+ import { flag } from "flags/next";
1388
1562
  ```
1389
1563
 
1390
1564
  ```ts title="flags.ts#svelte"
1391
- import { flag } from 'flags/sveltekit';
1565
+ import { flag } from "flags/sveltekit";
1392
1566
  ```
1393
1567
  ````
1394
1568
 
1395
1569
  This renders as:
1396
1570
 
1397
1571
  ```ts title="flags.ts#next"
1398
- import { flag } from 'flags/next';
1572
+ import { flag } from "flags/next";
1399
1573
  ```
1400
1574
 
1401
1575
  ```ts title="flags.ts#svelte"
1402
- import { flag } from 'flags/sveltekit';
1576
+ import { flag } from "flags/sveltekit";
1403
1577
  ```
1404
1578
 
1405
1579
  ### Line Numbers
@@ -1888,7 +2062,7 @@ Each version can define an `icon` to override the default current/previous versi
1888
2062
  Use `GeistdocsRouteSelect` for framework, product, or route switchers that should not use version-specific labels:
1889
2063
 
1890
2064
  ```tsx
1891
- import { LogoNextjs, LogoSvelteKit } from "@vercel/geistdocs/assets/logos";
2065
+ import { LogoIconNextSvg, LogoSvelte } from "@vercel/geistcn-assets/logos";
1892
2066
  import { GeistdocsRouteSelect } from "@vercel/geistdocs/versions";
1893
2067
 
1894
2068
  <GeistdocsRouteSelect
@@ -1899,14 +2073,14 @@ import { GeistdocsRouteSelect } from "@vercel/geistdocs/versions";
1899
2073
  id: "nextjs",
1900
2074
  label: "Next.js",
1901
2075
  description: "React framework",
1902
- icon: <LogoNextjs height={18} />,
2076
+ icon: <LogoIconNextSvg size={18} />,
1903
2077
  href: "/:path*",
1904
2078
  },
1905
2079
  {
1906
2080
  id: "sveltekit",
1907
2081
  label: "SvelteKit",
1908
2082
  description: "Svelte framework",
1909
- icon: <LogoSvelteKit height={18} />,
2083
+ icon: <LogoSvelte height={18} />,
1910
2084
  routePrefix: "/sveltekit",
1911
2085
  href: "/sveltekit/:path*",
1912
2086
  },
@@ -2012,7 +2186,7 @@ Each public route family needs a matching markdown route in `proxy.ts`. Read [Pr
2012
2186
  title: Proxy and markdown routes
2013
2187
  description: Add custom request logic while keeping Geistdocs markdown negotiation in the package
2014
2188
  type: reference
2015
- summary: Configure createProxy with before and after hooks, markdown route mappings, and a static Next.js matcher.
2189
+ summary: Configure createProxy with generated route discovery, request hooks, markdown mappings, and a static Next.js matcher.
2016
2190
  url: /docs/proxy
2017
2191
  source: apps/template/content/docs/proxy.mdx
2018
2192
  prerequisites:
@@ -2189,6 +2363,25 @@ export const config = {
2189
2363
 
2190
2364
  The package keeps `llms.txt`, `sitemap.md`, `agents.md`, MCP discovery, and RSS out of root page-Markdown negotiation. Continue to exclude site-specific application and API routes with the matcher or a `before` hook. A root Markdown page is exposed as `/index.md`, or `<basePath>/index.md` publicly.
2191
2365
 
2366
+ ## Recover unmatched Markdown requests
2367
+
2368
+ `createGeistdocs` in `next.config.ts` generates a lightweight manifest from App Router pages and route handlers. When `agent` is enabled, `createProxy` uses this manifest to return a Markdown 404 only when a `GET` or `HEAD` request matches neither a Markdown mapping nor an application route.
2369
+
2370
+ The manifest contains route patterns, not page modules or content. Static, dynamic, catch-all, optional catch-all, grouped, and localized routes continue to Next.js. Root catch-all pages are treated as potentially valid, so the app remains responsible for their 404 behavior. The package's own `[...not-found]` route handler is excluded so it does not claim every path.
2371
+
2372
+ The integration also resolves `next.config.ts` rewrites. Static rewrite sources are matched exactly, while parameterized sources protect their safe static prefix. If a rewrite begins with a dynamic root segment, Geistdocs disables automatic recovery rather than risk returning a Markdown 404 for a real rewritten route.
2373
+
2374
+ No proxy option is required. Pass `markdownNotFound: false` only when the site needs to disable automatic recovery:
2375
+
2376
+ ```ts title="proxy.ts"
2377
+ const proxy = createProxy({
2378
+ config: geistdocsConfig,
2379
+ markdownNotFound: false,
2380
+ });
2381
+ ```
2382
+
2383
+ Existing sites that use `createMDX` directly do not receive a generated manifest and keep the previous opt-in behavior. Restart `next dev` after adding, deleting, or renaming a route; production builds always regenerate the manifest.
2384
+
2192
2385
  ## Hook context
2193
2386
 
2194
2387
  Both `before` and `after` receive the same context:
@@ -2282,7 +2475,6 @@ import { geistdocsSource } from "@/lib/geistdocs/source";
2282
2475
 
2283
2476
  export const { GET, generateStaticParams } =
2284
2477
  createDocsMarkdownRoute({
2285
- notFound: {},
2286
2478
  sources: [geistdocsSource],
2287
2479
  });
2288
2480
  ```
@@ -2306,7 +2498,7 @@ When a Markdown request does not match a page, Geistdocs returns an agent-readab
2306
2498
 
2307
2499
  For example, a request for `/docs/env-vars` can suggest `/docs/environment-variables.md`. The response uses a short cache lifetime and returns a real `404` status. It also sends `X-Robots-Tag: noindex` and no canonical link because the requested page does not exist. Regular HTML requests keep the app's standard not-found behavior.
2308
2500
 
2309
- Enable the suggestion response with `notFound: {}` on `createDocsMarkdownRoute`. Pass `notFound: { status: 410 }` for permanently removed pages. Legacy `status: 200` values are treated as `404` so missing pages always return a real error status. Without `notFound`, Markdown requests use the standard Next.js not-found response.
2501
+ The suggestion response is enabled by default. Pass `notFound: { status: 410 }` for permanently removed pages, or `notFound: false` to use the standard Next.js not-found response. Legacy `status: 200` values are treated as `404` so missing pages always return a real error status.
2310
2502
 
2311
2503
  If a custom `markdownRoutes` mapping changes the public path shape, set `notFound.getRequestedPath` to reconstruct the app-local public pathname. This also keeps page lookup and suggestions within the right source when a flattened route serves multiple sources:
2312
2504
 
@@ -2323,17 +2515,21 @@ Set `notFound.getPageMarkdownUrl` as well when suggested pages use a custom app-
2323
2515
 
2324
2516
  ### Unmatched application paths
2325
2517
 
2326
- Set `markdownNotFound: true` on `createProxy` only when every valid app page has a Markdown mapping. Unmapped Markdown or detected-agent requests then receive a concise 404 with links to the docs, `sitemap.md`, and `llms.txt`, while browser requests continue to the app's existing Next.js not-found UI.
2518
+ When `agent` is enabled, `createGeistdocs` scans App Router pages and route handlers during `next dev` and `next build`. `createProxy` uses that generated manifest to distinguish valid application routes from unknown paths. Valid routes continue to the app's HTML or route-handler response. Unknown Markdown or detected-agent `GET` and `HEAD` requests receive a concise 404 with links to the docs, `sitemap.md`, and `llms.txt`.
2327
2519
 
2328
- Sites with valid custom pages outside their Markdown mappings should pass a predicate instead. Return `false` for route families that should continue to Next.js:
2520
+ Markdown mappings take precedence over generated app routes, so a route that has both HTML and Markdown continues to negotiate Markdown. Dynamic app routes are treated as potentially valid; the app remains responsible for returning its own 404 when a specific slug does not exist.
2521
+
2522
+ Pass `markdownNotFound: false` to disable automatic unmatched-path recovery:
2329
2523
 
2330
2524
  ```ts title="proxy.ts"
2331
2525
  const proxy = createProxy({
2332
2526
  config: geistdocsConfig,
2333
- markdownNotFound: ({ pathname }) => !pathname.startsWith("/playground"),
2527
+ markdownNotFound: false,
2334
2528
  });
2335
2529
  ```
2336
2530
 
2531
+ Sites that do not use `createGeistdocs` keep the previous opt-in behavior. Existing boolean and predicate forms remain supported for compatibility.
2532
+
2337
2533
  `createNotFoundRoute` remains available for apps that prefer an explicit catch-all Route Handler with Geistdocs' minimal HTML response.
2338
2534
 
2339
2535
 
@@ -3575,66 +3771,3 @@ On mobile, Geistdocs replaces the sidebar outline with a compact menu in the pag
3575
3771
 
3576
3772
  Keep headings short and descriptive so the outline reads like a summary of the page. Name each heading after the goal of its section, and avoid stacking two headings with no content between them.
3577
3773
 
3578
-
3579
- ---
3580
-
3581
- ---
3582
- title: Theme-Aware Image
3583
- description: Display different images based on the user's light or dark theme preference
3584
- type: reference
3585
- summary: A component that swaps images based on the active theme, built on top of Next.js Image.
3586
- url: /docs/theme-aware-image
3587
- source: apps/template/content/docs/theme-aware-image.mdx
3588
- prerequisites:
3589
- - /docs/getting-started
3590
- - /docs/provider
3591
- related:
3592
- - /docs/syntax
3593
- - /docs/configuration
3594
- ---
3595
-
3596
- # Theme-Aware Image
3597
-
3598
- The `ThemeAwareImage` component renders different images depending on whether the user is viewing your documentation in light or dark mode. It extends the Next.js `Image` component, so you get all the same optimization benefits like lazy loading, responsive sizing, and format conversion.
3599
-
3600
- Help me add a theme-aware image to a Geistdocs MDX page. Create a usage example with light and dark image sources, alt text, width, and height, then explain where to place the image files.
3601
-
3602
- ## Usage
3603
-
3604
- Import the component and pass a `src` object with `light` and `dark` variants:
3605
-
3606
- ```tsx
3607
- import { ThemeAwareImage } from "@vercel/geistdocs/components/theme-aware-image";
3608
-
3609
- <ThemeAwareImage
3610
- src={{
3611
- light: "/images/diagram-light.png",
3612
- dark: "/images/diagram-dark.png",
3613
- }}
3614
- alt="Architecture diagram"
3615
- width={800}
3616
- height={400}
3617
- />
3618
- ```
3619
-
3620
- The component reads the current theme from `next-themes` and resolves the correct image source automatically. All standard Next.js `Image` props (such as `width`, `height`, `alt`, `priority`, and `className`) are supported.
3621
-
3622
- ## How it works
3623
-
3624
- `ThemeAwareImage` uses the `resolvedTheme` value from the `useTheme` hook provided by `next-themes`. This ensures it responds to the actual rendered theme, even when the user's preference is set to "system".
3625
-
3626
- - When `resolvedTheme` is `"dark"`, the `src.dark` image is displayed.
3627
- - Otherwise, the `src.light` image is used.
3628
-
3629
- Because this component relies on client-side theme detection, it is a client component (`"use client"`).
3630
-
3631
- ## Props
3632
-
3633
- | Prop | Type | Description |
3634
- | --- | --- | --- |
3635
- | `src` | `{ light: ImageProps["src"]; dark: ImageProps["src"] }` | An object containing the light and dark image sources |
3636
- | `alt` | `string` | Accessible alt text for the image |
3637
- | `width` | `number` | The width of the image in pixels |
3638
- | `height` | `number` | The height of the image in pixels |
3639
- | `...rest` | `ImageProps` | Any additional props supported by the Next.js `Image` component |
3640
-
@@ -93,7 +93,7 @@
93
93
  "description": "Add custom request logic while keeping Geistdocs markdown negotiation in the package",
94
94
  "path": "pages/proxy.md",
95
95
  "source": "apps/template/content/docs/proxy.mdx",
96
- "summary": "Configure createProxy with before and after hooks, markdown route mappings, and a static Next.js matcher.",
96
+ "summary": "Configure createProxy with generated route discovery, request hooks, markdown mappings, and a static Next.js matcher.",
97
97
  "title": "Proxy and markdown routes",
98
98
  "type": "reference",
99
99
  "url": "/docs/proxy"
@@ -196,17 +196,8 @@
196
196
  "title": "Table of contents",
197
197
  "type": "reference",
198
198
  "url": "/docs/table-of-contents"
199
- },
200
- {
201
- "description": "Display different images based on the user's light or dark theme preference",
202
- "path": "pages/theme-aware-image.md",
203
- "source": "apps/template/content/docs/theme-aware-image.mdx",
204
- "summary": "A component that swaps images based on the active theme, built on top of Next.js Image.",
205
- "title": "Theme-Aware Image",
206
- "type": "reference",
207
- "url": "/docs/theme-aware-image"
208
199
  }
209
200
  ],
210
201
  "source": "apps/template/content/docs",
211
- "version": "1.24.1"
202
+ "version": "1.25.1-canary.47f1ad5"
212
203
  }
@@ -27,6 +27,7 @@ Configure Geistdocs through user-owned files in the generated project. Runtime f
27
27
  | File | Purpose |
28
28
  | --- | --- |
29
29
  | `geistdocs.tsx` | Site-level settings, including logo, nav, GitHub repo, AI prompt, agent-readiness metadata, translations, and feature flags. |
30
+ | `next.config.ts` | Composes Fumadocs MDX, discovers App Router routes, and configures Next.js. |
30
31
  | `source.config.ts` | Configures Fumadocs collections with the package-provided schema, Markdown plugins, and syntax theme. |
31
32
  | `lib/geistdocs/config.tsx` | Converts `geistdocs.tsx` exports into the package config using `defineConfig`. |
32
33
  | `source.config.ts` | Configures Fumadocs collections with package-safe schemas and Markdown processing. |
@@ -216,11 +217,18 @@ To serve docs from the site root, use `route: "/"` in `content` and `baseUrl: "/
216
217
  When Next.js mounts the application below a path, set the same value in `next.config.ts` and Geistdocs config:
217
218
 
218
219
  ```ts title="next.config.ts"
220
+ import { createGeistdocs } from "@vercel/geistdocs/next";
221
+ import type { NextConfig } from "next";
222
+
223
+ const withGeistdocs = createGeistdocs();
224
+
219
225
  const config: NextConfig = {
220
226
  basePath: "/docs",
221
227
  cacheComponents: true,
222
228
  partialPrefetching: true,
223
229
  };
230
+
231
+ export default withGeistdocs(config);
224
232
  ```
225
233
 
226
234
  ```tsx title="geistdocs.tsx"
package/docs/pages/md.md CHANGED
@@ -71,7 +71,6 @@ import { geistdocsSource } from "@/lib/geistdocs/source";
71
71
 
72
72
  export const { GET, generateStaticParams } =
73
73
  createDocsMarkdownRoute({
74
- notFound: {},
75
74
  sources: [geistdocsSource],
76
75
  });
77
76
  ```
@@ -95,7 +94,7 @@ When a Markdown request does not match a page, Geistdocs returns an agent-readab
95
94
 
96
95
  For example, a request for `/docs/env-vars` can suggest `/docs/environment-variables.md`. The response uses a short cache lifetime and returns a real `404` status. It also sends `X-Robots-Tag: noindex` and no canonical link because the requested page does not exist. Regular HTML requests keep the app's standard not-found behavior.
97
96
 
98
- Enable the suggestion response with `notFound: {}` on `createDocsMarkdownRoute`. Pass `notFound: { status: 410 }` for permanently removed pages. Legacy `status: 200` values are treated as `404` so missing pages always return a real error status. Without `notFound`, Markdown requests use the standard Next.js not-found response.
97
+ The suggestion response is enabled by default. Pass `notFound: { status: 410 }` for permanently removed pages, or `notFound: false` to use the standard Next.js not-found response. Legacy `status: 200` values are treated as `404` so missing pages always return a real error status.
99
98
 
100
99
  If a custom `markdownRoutes` mapping changes the public path shape, set `notFound.getRequestedPath` to reconstruct the app-local public pathname. This also keeps page lookup and suggestions within the right source when a flattened route serves multiple sources:
101
100
 
@@ -112,15 +111,19 @@ Set `notFound.getPageMarkdownUrl` as well when suggested pages use a custom app-
112
111
 
113
112
  ### Unmatched application paths
114
113
 
115
- Set `markdownNotFound: true` on `createProxy` only when every valid app page has a Markdown mapping. Unmapped Markdown or detected-agent requests then receive a concise 404 with links to the docs, `sitemap.md`, and `llms.txt`, while browser requests continue to the app's existing Next.js not-found UI.
114
+ When `agent` is enabled, `createGeistdocs` scans App Router pages and route handlers during `next dev` and `next build`. `createProxy` uses that generated manifest to distinguish valid application routes from unknown paths. Valid routes continue to the app's HTML or route-handler response. Unknown Markdown or detected-agent `GET` and `HEAD` requests receive a concise 404 with links to the docs, `sitemap.md`, and `llms.txt`.
116
115
 
117
- Sites with valid custom pages outside their Markdown mappings should pass a predicate instead. Return `false` for route families that should continue to Next.js:
116
+ Markdown mappings take precedence over generated app routes, so a route that has both HTML and Markdown continues to negotiate Markdown. Dynamic app routes are treated as potentially valid; the app remains responsible for returning its own 404 when a specific slug does not exist.
117
+
118
+ Pass `markdownNotFound: false` to disable automatic unmatched-path recovery:
118
119
 
119
120
  ```ts title="proxy.ts"
120
121
  const proxy = createProxy({
121
122
  config: geistdocsConfig,
122
- markdownNotFound: ({ pathname }) => !pathname.startsWith("/playground"),
123
+ markdownNotFound: false,
123
124
  });
124
125
  ```
125
126
 
127
+ Sites that do not use `createGeistdocs` keep the previous opt-in behavior. Existing boolean and predicate forms remain supported for compatibility.
128
+
126
129
  `createNotFoundRoute` remains available for apps that prefer an explicit catch-all Route Handler with Geistdocs' minimal HTML response.