@vercel/geistdocs 1.2.1 → 1.2.3-canary.1d733b2

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 (384) hide show
  1. package/dist/assets/icons/icon-arrow-up-right-small.d.ts +8 -0
  2. package/dist/assets/icons/icon-arrow-up-right-small.d.ts.map +1 -0
  3. package/dist/assets/icons/icon-arrow-up-right-small.js +4 -0
  4. package/dist/assets/icons/icon-arrow-up-right.d.ts +5 -0
  5. package/dist/assets/icons/icon-arrow-up-right.d.ts.map +1 -0
  6. package/dist/assets/icons/icon-arrow-up-right.js +4 -0
  7. package/dist/assets/icons/icon-check.d.ts +5 -0
  8. package/dist/assets/icons/icon-check.d.ts.map +1 -0
  9. package/dist/assets/icons/icon-check.js +4 -0
  10. package/dist/assets/icons/icon-chevron-down-small.d.ts +8 -0
  11. package/dist/assets/icons/icon-chevron-down-small.d.ts.map +1 -0
  12. package/dist/assets/icons/icon-chevron-down-small.js +7 -0
  13. package/dist/assets/icons/icon-chevron-right.d.ts +5 -0
  14. package/dist/assets/icons/icon-chevron-right.d.ts.map +1 -0
  15. package/dist/assets/icons/icon-chevron-right.js +4 -0
  16. package/dist/assets/icons/icon-copy.d.ts +5 -0
  17. package/dist/assets/icons/icon-copy.d.ts.map +1 -0
  18. package/dist/assets/icons/icon-copy.js +4 -0
  19. package/dist/assets/icons/icon-file-text.d.ts +5 -0
  20. package/dist/assets/icons/icon-file-text.d.ts.map +1 -0
  21. package/dist/assets/icons/icon-file-text.js +4 -0
  22. package/dist/assets/icons/icon-menu-alt.d.ts +5 -0
  23. package/dist/assets/icons/icon-menu-alt.d.ts.map +1 -0
  24. package/dist/assets/icons/icon-menu-alt.js +4 -0
  25. package/dist/assets/icons/icon-slash-forward.d.ts +8 -0
  26. package/dist/assets/icons/icon-slash-forward.d.ts.map +1 -0
  27. package/dist/assets/icons/icon-slash-forward.js +4 -0
  28. package/dist/assets/icons/index.d.ts +10 -0
  29. package/dist/assets/icons/index.d.ts.map +1 -0
  30. package/dist/assets/icons/index.js +10 -0
  31. package/dist/assets/logos/index.d.ts +15 -0
  32. package/dist/assets/logos/index.d.ts.map +1 -0
  33. package/dist/assets/logos/index.js +15 -0
  34. package/dist/assets/logos/logo-ai-elements.d.ts +8 -0
  35. package/dist/assets/logos/logo-ai-elements.d.ts.map +1 -0
  36. package/dist/assets/logos/logo-ai-elements.js +8 -0
  37. package/dist/assets/logos/logo-ai-sdk.d.ts +8 -0
  38. package/dist/assets/logos/logo-ai-sdk.d.ts.map +1 -0
  39. package/dist/assets/logos/logo-ai-sdk.js +8 -0
  40. package/dist/assets/logos/logo-chat-sdk.d.ts +8 -0
  41. package/dist/assets/logos/logo-chat-sdk.d.ts.map +1 -0
  42. package/dist/assets/logos/logo-chat-sdk.js +8 -0
  43. package/dist/assets/logos/logo-flags-sdk.d.ts +8 -0
  44. package/dist/assets/logos/logo-flags-sdk.d.ts.map +1 -0
  45. package/dist/assets/logos/logo-flags-sdk.js +8 -0
  46. package/dist/assets/logos/logo-icon-vercel.d.ts +9 -0
  47. package/dist/assets/logos/logo-icon-vercel.d.ts.map +1 -0
  48. package/dist/assets/logos/logo-icon-vercel.js +8 -0
  49. package/dist/assets/logos/logo-nextjs.d.ts +8 -0
  50. package/dist/assets/logos/logo-nextjs.d.ts.map +1 -0
  51. package/dist/assets/logos/logo-nextjs.js +7 -0
  52. package/dist/assets/logos/logo-streamdown.d.ts +8 -0
  53. package/dist/assets/logos/logo-streamdown.d.ts.map +1 -0
  54. package/dist/assets/logos/logo-streamdown.js +8 -0
  55. package/dist/assets/logos/logo-svelte-kit.d.ts +8 -0
  56. package/dist/assets/logos/logo-svelte-kit.d.ts.map +1 -0
  57. package/dist/assets/logos/logo-svelte-kit.js +7 -0
  58. package/dist/assets/logos/logo-vercel-oss.d.ts +8 -0
  59. package/dist/assets/logos/logo-vercel-oss.d.ts.map +1 -0
  60. package/dist/assets/logos/logo-vercel-oss.js +7 -0
  61. package/dist/assets/logos/logo-workflow-sdk.d.ts +8 -0
  62. package/dist/assets/logos/logo-workflow-sdk.d.ts.map +1 -0
  63. package/dist/assets/logos/logo-workflow-sdk.js +8 -0
  64. package/dist/cli/index.js +3 -0
  65. package/dist/components/callout.d.ts +12 -0
  66. package/dist/components/callout.d.ts.map +1 -0
  67. package/dist/components/callout.js +7 -0
  68. package/dist/components/code-block-tabs.d.ts +7 -0
  69. package/dist/components/code-block-tabs.d.ts.map +1 -0
  70. package/dist/components/code-block-tabs.js +7 -0
  71. package/dist/components/code-block.d.ts +14 -0
  72. package/dist/components/code-block.d.ts.map +1 -0
  73. package/dist/components/code-block.js +45 -0
  74. package/dist/components/copy-prompt.d.ts +11 -0
  75. package/dist/components/copy-prompt.d.ts.map +1 -0
  76. package/dist/components/copy-prompt.js +58 -0
  77. package/dist/components/mermaid.d.ts +4 -0
  78. package/dist/components/mermaid.d.ts.map +1 -0
  79. package/dist/components/mermaid.js +44 -0
  80. package/dist/components/theme-aware-image.d.ts +12 -0
  81. package/dist/components/theme-aware-image.d.ts.map +1 -0
  82. package/dist/components/theme-aware-image.js +8 -0
  83. package/dist/components/video.d.ts +6 -0
  84. package/dist/components/video.d.ts.map +1 -0
  85. package/dist/components/video.js +3 -0
  86. package/dist/config.d.ts +117 -0
  87. package/dist/config.d.ts.map +1 -0
  88. package/dist/config.js +1 -0
  89. package/dist/controls.d.ts +15 -0
  90. package/dist/controls.d.ts.map +1 -0
  91. package/dist/controls.js +52 -0
  92. package/dist/footer.d.ts +8 -0
  93. package/dist/footer.d.ts.map +1 -0
  94. package/dist/footer.js +6 -0
  95. package/dist/home-layout.d.ts +11 -0
  96. package/dist/home-layout.d.ts.map +1 -0
  97. package/dist/home-layout.js +31 -0
  98. package/dist/internal/chat/context.d.ts +19 -0
  99. package/dist/internal/chat/context.d.ts.map +1 -0
  100. package/dist/internal/chat/context.js +36 -0
  101. package/dist/internal/chat/conversation.d.ts +10 -0
  102. package/dist/internal/chat/conversation.d.ts.map +1 -0
  103. package/dist/internal/chat/conversation.js +16 -0
  104. package/dist/internal/chat/copy-chat.d.ts +5 -0
  105. package/dist/internal/chat/copy-chat.d.ts.map +1 -0
  106. package/dist/internal/chat/copy-chat.js +35 -0
  107. package/dist/internal/chat/db.d.ts +13 -0
  108. package/dist/internal/chat/db.d.ts.map +1 -0
  109. package/dist/internal/chat/db.js +19 -0
  110. package/dist/internal/chat/message-metadata.d.ts +8 -0
  111. package/dist/internal/chat/message-metadata.d.ts.map +1 -0
  112. package/dist/internal/chat/message-metadata.js +29 -0
  113. package/dist/internal/chat/message.d.ts +11 -0
  114. package/dist/internal/chat/message.d.ts.map +1 -0
  115. package/dist/internal/chat/message.js +11 -0
  116. package/dist/internal/chat/prompt-input.d.ts +13 -0
  117. package/dist/internal/chat/prompt-input.d.ts.map +1 -0
  118. package/dist/internal/chat/prompt-input.js +39 -0
  119. package/dist/internal/chat/shell.d.ts +2 -0
  120. package/dist/internal/chat/shell.d.ts.map +1 -0
  121. package/dist/internal/chat/shell.js +194 -0
  122. package/dist/internal/chat/shimmer.d.ts +11 -0
  123. package/dist/internal/chat/shimmer.d.ts.map +1 -0
  124. package/dist/internal/chat/shimmer.js +18 -0
  125. package/dist/internal/chat/sources.d.ts +13 -0
  126. package/dist/internal/chat/sources.d.ts.map +1 -0
  127. package/dist/internal/chat/sources.js +9 -0
  128. package/dist/internal/chat/suggestion.d.ts +11 -0
  129. package/dist/internal/chat/suggestion.d.ts.map +1 -0
  130. package/dist/internal/chat/suggestion.js +12 -0
  131. package/dist/internal/cn.d.ts +3 -0
  132. package/dist/internal/cn.d.ts.map +1 -0
  133. package/dist/internal/cn.js +3 -0
  134. package/dist/internal/config-context.d.ts +10 -0
  135. package/dist/internal/config-context.d.ts.map +1 -0
  136. package/dist/internal/config-context.js +15 -0
  137. package/dist/internal/feedback-action.d.ts +14 -0
  138. package/dist/internal/feedback-action.d.ts.map +1 -0
  139. package/dist/internal/feedback-action.js +34 -0
  140. package/dist/internal/footer/github-button.d.ts +7 -0
  141. package/dist/internal/footer/github-button.d.ts.map +1 -0
  142. package/dist/internal/footer/github-button.js +10 -0
  143. package/dist/internal/footer/rss-button.d.ts +2 -0
  144. package/dist/internal/footer/rss-button.d.ts.map +1 -0
  145. package/dist/internal/footer/rss-button.js +4 -0
  146. package/dist/internal/i18n.d.ts +6 -0
  147. package/dist/internal/i18n.d.ts.map +1 -0
  148. package/dist/internal/i18n.js +18 -0
  149. package/dist/internal/languages.d.ts +7 -0
  150. package/dist/internal/languages.d.ts.map +1 -0
  151. package/dist/internal/languages.js +18 -0
  152. package/dist/internal/localized-link.d.ts +8 -0
  153. package/dist/internal/localized-link.d.ts.map +1 -0
  154. package/dist/internal/localized-link.js +13 -0
  155. package/dist/internal/navbar/desktop-menu.d.ts +10 -0
  156. package/dist/internal/navbar/desktop-menu.d.ts.map +1 -0
  157. package/dist/internal/navbar/desktop-menu.js +11 -0
  158. package/dist/internal/navbar/mobile-menu.d.ts +7 -0
  159. package/dist/internal/navbar/mobile-menu.d.ts.map +1 -0
  160. package/dist/internal/navbar/mobile-menu.js +44 -0
  161. package/dist/internal/navbar/navbar-logo.d.ts +16 -0
  162. package/dist/internal/navbar/navbar-logo.d.ts.map +1 -0
  163. package/dist/internal/navbar/navbar-logo.js +30 -0
  164. package/dist/internal/not-implemented.d.ts +2 -0
  165. package/dist/internal/not-implemented.d.ts.map +1 -0
  166. package/dist/internal/not-implemented.js +4 -0
  167. package/dist/internal/page-actions-client.d.ts +13 -0
  168. package/dist/internal/page-actions-client.d.ts.map +1 -0
  169. package/dist/internal/page-actions-client.js +171 -0
  170. package/dist/internal/page-actions.d.ts +18 -0
  171. package/dist/internal/page-actions.d.ts.map +1 -0
  172. package/dist/internal/page-actions.js +4 -0
  173. package/dist/internal/page-visibility.d.ts +18 -0
  174. package/dist/internal/page-visibility.d.ts.map +1 -0
  175. package/dist/internal/page-visibility.js +24 -0
  176. package/dist/internal/provider-client.d.ts +9 -0
  177. package/dist/internal/provider-client.d.ts.map +1 -0
  178. package/dist/internal/provider-client.js +24 -0
  179. package/dist/internal/search.d.ts +5 -0
  180. package/dist/internal/search.d.ts.map +1 -0
  181. package/dist/internal/search.js +14 -0
  182. package/dist/internal/sidebar.d.ts +9 -0
  183. package/dist/internal/sidebar.d.ts.map +1 -0
  184. package/dist/internal/sidebar.js +38 -0
  185. package/dist/internal/table-of-contents.d.ts +9 -0
  186. package/dist/internal/table-of-contents.d.ts.map +1 -0
  187. package/dist/internal/table-of-contents.js +5 -0
  188. package/dist/internal/ui/button-group.d.ts +13 -0
  189. package/dist/internal/ui/button-group.d.ts.map +1 -0
  190. package/dist/internal/ui/button-group.js +26 -0
  191. package/dist/internal/ui/button.d.ts +12 -0
  192. package/dist/internal/ui/button.d.ts.map +1 -0
  193. package/dist/internal/ui/button.js +33 -0
  194. package/dist/internal/ui/card.d.ts +6 -0
  195. package/dist/internal/ui/card.d.ts.map +1 -0
  196. package/dist/internal/ui/card.js +14 -0
  197. package/dist/internal/ui/collapsible.d.ts +6 -0
  198. package/dist/internal/ui/collapsible.d.ts.map +1 -0
  199. package/dist/internal/ui/collapsible.js +12 -0
  200. package/dist/internal/ui/drawer.d.ts +6 -0
  201. package/dist/internal/ui/drawer.d.ts.map +1 -0
  202. package/dist/internal/ui/drawer.js +13 -0
  203. package/dist/internal/ui/dropdown-menu.d.ts +22 -0
  204. package/dist/internal/ui/dropdown-menu.d.ts.map +1 -0
  205. package/dist/internal/ui/dropdown-menu.js +41 -0
  206. package/dist/internal/ui/input-group.d.ts +15 -0
  207. package/dist/internal/ui/input-group.d.ts.map +1 -0
  208. package/dist/internal/ui/input-group.js +44 -0
  209. package/dist/internal/ui/input.d.ts +3 -0
  210. package/dist/internal/ui/input.d.ts.map +1 -0
  211. package/dist/internal/ui/input.js +5 -0
  212. package/dist/internal/ui/kbd.d.ts +4 -0
  213. package/dist/internal/ui/kbd.d.ts.map +1 -0
  214. package/dist/internal/ui/kbd.js +8 -0
  215. package/dist/internal/ui/navigation-menu.d.ts +17 -0
  216. package/dist/internal/ui/navigation-menu.d.ts.map +1 -0
  217. package/dist/internal/ui/navigation-menu.js +38 -0
  218. package/dist/internal/ui/popover.d.ts +6 -0
  219. package/dist/internal/ui/popover.d.ts.map +1 -0
  220. package/dist/internal/ui/popover.js +13 -0
  221. package/dist/internal/ui/scroll-area.d.ts +5 -0
  222. package/dist/internal/ui/scroll-area.d.ts.map +1 -0
  223. package/dist/internal/ui/scroll-area.js +12 -0
  224. package/dist/internal/ui/separator.d.ts +4 -0
  225. package/dist/internal/ui/separator.d.ts.map +1 -0
  226. package/dist/internal/ui/separator.js +7 -0
  227. package/dist/internal/ui/sheet.d.ts +10 -0
  228. package/dist/internal/ui/sheet.d.ts.map +1 -0
  229. package/dist/internal/ui/sheet.js +24 -0
  230. package/dist/internal/ui/sonner.d.ts +3 -0
  231. package/dist/internal/ui/sonner.d.ts.map +1 -0
  232. package/dist/internal/ui/sonner.js +20 -0
  233. package/dist/internal/ui/spinner.d.ts +3 -0
  234. package/dist/internal/ui/spinner.d.ts.map +1 -0
  235. package/dist/internal/ui/spinner.js +6 -0
  236. package/dist/internal/ui/textarea.d.ts +3 -0
  237. package/dist/internal/ui/textarea.d.ts.map +1 -0
  238. package/dist/internal/ui/textarea.js +5 -0
  239. package/dist/internal/ui/tooltip.d.ts +7 -0
  240. package/dist/internal/ui/tooltip.d.ts.map +1 -0
  241. package/dist/internal/ui/tooltip.js +16 -0
  242. package/dist/internal/use-mobile.d.ts +2 -0
  243. package/dist/internal/use-mobile.d.ts.map +1 -0
  244. package/dist/internal/use-mobile.js +16 -0
  245. package/dist/layout.d.ts +14 -0
  246. package/dist/layout.d.ts.map +1 -0
  247. package/dist/layout.js +31 -0
  248. package/dist/mdx.d.ts +67 -0
  249. package/dist/mdx.d.ts.map +1 -0
  250. package/dist/mdx.js +35 -0
  251. package/dist/mobile-docs-bar.d.ts +7 -0
  252. package/dist/mobile-docs-bar.d.ts.map +1 -0
  253. package/dist/mobile-docs-bar.js +13 -0
  254. package/dist/navbar.d.ts +7 -0
  255. package/dist/navbar.d.ts.map +1 -0
  256. package/dist/navbar.js +10 -0
  257. package/dist/pages/docs.d.ts +83 -0
  258. package/dist/pages/docs.d.ts.map +1 -0
  259. package/dist/pages/docs.js +98 -0
  260. package/dist/proxy.d.ts +37 -0
  261. package/dist/proxy.d.ts.map +1 -0
  262. package/dist/proxy.js +189 -0
  263. package/dist/routes/agents.d.ts +21 -0
  264. package/dist/routes/agents.d.ts.map +1 -0
  265. package/dist/routes/agents.js +201 -0
  266. package/dist/routes/chat.d.ts +14 -0
  267. package/dist/routes/chat.d.ts.map +1 -0
  268. package/dist/routes/chat.js +251 -0
  269. package/dist/routes/llms.d.ts +52 -0
  270. package/dist/routes/llms.d.ts.map +1 -0
  271. package/dist/routes/llms.js +110 -0
  272. package/dist/routes/search.d.ts +13 -0
  273. package/dist/routes/search.d.ts.map +1 -0
  274. package/dist/routes/search.js +81 -0
  275. package/dist/routes/sitemap.d.ts +47 -0
  276. package/dist/routes/sitemap.d.ts.map +1 -0
  277. package/dist/routes/sitemap.js +176 -0
  278. package/dist/shiki-theme.d.ts +20 -0
  279. package/dist/shiki-theme.d.ts.map +1 -0
  280. package/dist/shiki-theme.js +110 -0
  281. package/dist/sidebar.d.ts +11 -0
  282. package/dist/sidebar.d.ts.map +1 -0
  283. package/dist/sidebar.js +16 -0
  284. package/dist/source-config.d.ts +68 -0
  285. package/dist/source-config.d.ts.map +1 -0
  286. package/dist/source-config.js +161 -0
  287. package/dist/source.d.ts +181 -0
  288. package/dist/source.d.ts.map +1 -0
  289. package/dist/source.js +142 -0
  290. package/dist/versions.d.ts +45 -0
  291. package/dist/versions.d.ts.map +1 -0
  292. package/dist/versions.js +79 -0
  293. package/package.json +186 -9
  294. package/source-config.js +174 -0
  295. package/styles.css +556 -0
  296. package/template/AGENTS.md +82 -0
  297. package/template/_gitignore +29 -0
  298. package/template/app/[lang]/(home)/components/centered-section.tsx +24 -0
  299. package/template/app/[lang]/(home)/components/cta.tsx +19 -0
  300. package/template/app/[lang]/(home)/components/hero.tsx +27 -0
  301. package/template/app/[lang]/(home)/components/one-two-section.tsx +23 -0
  302. package/template/app/[lang]/(home)/components/templates.tsx +48 -0
  303. package/template/app/[lang]/(home)/components/text-grid-section.tsx +20 -0
  304. package/template/app/[lang]/(home)/layout.tsx +15 -0
  305. package/template/app/[lang]/(home)/page.tsx +126 -0
  306. package/template/app/[lang]/agents.md/route.ts +6 -0
  307. package/template/app/[lang]/docs/[[...slug]]/page.tsx +22 -0
  308. package/template/app/[lang]/docs/layout.tsx +14 -0
  309. package/template/app/[lang]/layout.tsx +29 -0
  310. package/template/app/[lang]/llms.mdx/[[...slug]]/route.ts +7 -0
  311. package/template/app/[lang]/llms.txt/route.ts +6 -0
  312. package/template/app/[lang]/og/[...slug]/background.png +0 -0
  313. package/template/app/[lang]/og/[...slug]/geist-sans-regular.ttf +0 -0
  314. package/template/app/[lang]/og/[...slug]/geist-sans-semibold.ttf +0 -0
  315. package/template/app/[lang]/og/[...slug]/route.tsx +95 -0
  316. package/template/app/[lang]/rss.xml/route.ts +52 -0
  317. package/template/app/[lang]/sitemap.md/route.ts +9 -0
  318. package/template/app/api/chat/route.ts +8 -0
  319. package/template/app/api/search/route.ts +5 -0
  320. package/template/app/favicon.ico +0 -0
  321. package/template/app/global.css +2 -0
  322. package/template/app/robots.ts +14 -0
  323. package/template/app/sitemap.ts +36 -0
  324. package/template/app/styles/geistdocs.css +595 -0
  325. package/template/components/geistdocs/docs-layout.tsx +20 -0
  326. package/template/components/geistdocs/mdx-components.tsx +5 -0
  327. package/template/components/geistdocs/provider.tsx +31 -0
  328. package/template/components/ui/badge.tsx +46 -0
  329. package/template/components/ui/button.tsx +60 -0
  330. package/template/components/ui/command-prompt.tsx +488 -0
  331. package/template/components.json +22 -0
  332. package/template/content/docs/agent-readiness.mdx +103 -0
  333. package/template/content/docs/ask-ai.cn.mdx +85 -0
  334. package/template/content/docs/ask-ai.mdx +89 -0
  335. package/template/content/docs/configuration.cn.mdx +155 -0
  336. package/template/content/docs/configuration.mdx +275 -0
  337. package/template/content/docs/deployment.cn.mdx +34 -0
  338. package/template/content/docs/deployment.mdx +40 -0
  339. package/template/content/docs/edit-on-github.cn.mdx +47 -0
  340. package/template/content/docs/edit-on-github.mdx +51 -0
  341. package/template/content/docs/env.cn.mdx +25 -0
  342. package/template/content/docs/env.mdx +29 -0
  343. package/template/content/docs/feedback.cn.mdx +85 -0
  344. package/template/content/docs/feedback.mdx +89 -0
  345. package/template/content/docs/getting-started.cn.mdx +86 -0
  346. package/template/content/docs/getting-started.mdx +108 -0
  347. package/template/content/docs/index.cn.mdx +57 -0
  348. package/template/content/docs/index.mdx +95 -0
  349. package/template/content/docs/internationalization.cn.mdx +111 -0
  350. package/template/content/docs/internationalization.mdx +122 -0
  351. package/template/content/docs/llms-txt.cn.mdx +72 -0
  352. package/template/content/docs/llms-txt.mdx +86 -0
  353. package/template/content/docs/md.cn.mdx +65 -0
  354. package/template/content/docs/md.mdx +82 -0
  355. package/template/content/docs/meta.json +25 -0
  356. package/template/content/docs/migration.mdx +321 -0
  357. package/template/content/docs/open-in-chat.cn.mdx +78 -0
  358. package/template/content/docs/open-in-chat.mdx +80 -0
  359. package/template/content/docs/provider.cn.mdx +70 -0
  360. package/template/content/docs/provider.mdx +74 -0
  361. package/template/content/docs/proxy.cn.mdx +96 -0
  362. package/template/content/docs/proxy.mdx +178 -0
  363. package/template/content/docs/rss.cn.mdx +104 -0
  364. package/template/content/docs/rss.mdx +108 -0
  365. package/template/content/docs/syntax.cn.mdx +416 -0
  366. package/template/content/docs/syntax.mdx +411 -0
  367. package/template/content/docs/theme-aware-image.mdx +57 -0
  368. package/template/content/docs/versioned-docs.cn.mdx +117 -0
  369. package/template/content/docs/versioned-docs.mdx +228 -0
  370. package/template/geistdocs.tsx +77 -0
  371. package/template/lib/geistdocs/config.tsx +30 -0
  372. package/template/lib/geistdocs/fonts.ts +18 -0
  373. package/template/lib/geistdocs/i18n.ts +13 -0
  374. package/template/lib/geistdocs/md-tracking.ts +56 -0
  375. package/template/lib/geistdocs/source.ts +12 -0
  376. package/template/lib/utils.ts +6 -0
  377. package/template/next.config.ts +22 -0
  378. package/template/package.json +63 -0
  379. package/template/postcss.config.mjs +5 -0
  380. package/template/proxy.ts +17 -0
  381. package/template/source.config.ts +23 -0
  382. package/template/tsconfig.json +37 -0
  383. package/dist/index.js +0 -2
  384. /package/dist/{index.d.ts → cli/index.d.ts} +0 -0
@@ -0,0 +1,98 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { DocsBody as FumadocsDocsBody, DocsDescription as FumadocsDocsDescription, DocsPage as FumadocsDocsPage, DocsTitle as FumadocsDocsTitle, } from "fumadocs-ui/layouts/docs/page";
3
+ import { createRelativeLink } from "fumadocs-ui/mdx";
4
+ import { notFound } from "next/navigation";
5
+ import { cn } from "../internal/cn";
6
+ import { createPageActions as createInternalPageActions } from "../internal/page-actions";
7
+ import { GeistdocsPageActions } from "../internal/page-actions-client";
8
+ import { getPageRobots, } from "../internal/page-visibility";
9
+ import { GeistdocsTableOfContents } from "../internal/table-of-contents";
10
+ import { createMdxComponents } from "../mdx";
11
+ const DocsTitle = ({ className, ...props }) => (_jsx(FumadocsDocsTitle, { className: cn("mb-4 text-4xl tracking-tight", className), ...props }));
12
+ const DocsDescription = (props) => _jsx(FumadocsDocsDescription, { ...props });
13
+ const DocsBody = ({ className, ...props }) => (_jsx(FumadocsDocsBody, { className: cn("mx-auto w-full", className), ...props }));
14
+ export const createDocsPage = ({ config, source, mdx, pageActions = createInternalPageActions({ config }), filterStaticParams, getPageUrl, metadata, openGraph, renderTop, resolveLink, tableOfContentPopover, }) => {
15
+ const Page = async ({ params, }) => {
16
+ const resolvedParams = await params;
17
+ const { slug, lang } = resolvedParams;
18
+ const page = source.source.getPage(slug, lang);
19
+ if (!page) {
20
+ notFound();
21
+ }
22
+ const data = page.data;
23
+ const MDX = data.body;
24
+ const defaultLink = createRelativeLink(source.source, page);
25
+ const link = resolveLink
26
+ ? resolveLink({ link: defaultLink, page, source })
27
+ : defaultLink;
28
+ const resolvedMdx = typeof mdx === "function" ? mdx({ link, page, source }) : mdx;
29
+ const pageUrl = getPageUrl?.({ page, params: resolvedParams }) ?? page.url;
30
+ const markdown = pageActions.getExtraActions || renderTop
31
+ ? await source.getPageMarkdown(page)
32
+ : undefined;
33
+ const footerActions = markdown
34
+ ? (pageActions.getExtraActions?.({
35
+ markdown,
36
+ page: {
37
+ path: page.path,
38
+ url: pageUrl,
39
+ },
40
+ }) ?? [])
41
+ : [];
42
+ const tocFooter = (_jsx("div", { className: "mt-3 border-gray-alpha-400 border-t pt-3", children: _jsx("nav", { "aria-label": "Page actions", className: "flex min-w-0 flex-col gap-1", children: _jsx(GeistdocsPageActions, { config: pageActions.config, extraActions: footerActions, page: {
43
+ path: page.path,
44
+ url: pageUrl,
45
+ } }) }) }));
46
+ return (_jsxs(FumadocsDocsPage, { full: data.full, tableOfContent: {
47
+ enabled: true,
48
+ single: true,
49
+ component: (_jsx(GeistdocsTableOfContents, { footer: tocFooter, toc: data.toc ?? [] })),
50
+ }, tableOfContentPopover: tableOfContentPopover, toc: data.toc, children: [renderTop?.({ data, markdown: markdown ?? "", page, pageUrl }), _jsx(DocsTitle, { children: data.title }), _jsx(DocsDescription, { children: data.description }), _jsx(DocsBody, { children: _jsx(MDX, { components: {
51
+ ...createMdxComponents({ a: link }),
52
+ ...resolvedMdx,
53
+ } }) })] }));
54
+ };
55
+ const generateStaticParams = () => {
56
+ const params = source.source.generateParams();
57
+ return filterStaticParams ? params.filter(filterStaticParams) : params;
58
+ };
59
+ const generateMetadata = async ({ params, }) => {
60
+ const resolvedParams = await params;
61
+ const { slug, lang } = resolvedParams;
62
+ const page = source.source.getPage(slug, lang);
63
+ if (!page) {
64
+ notFound();
65
+ }
66
+ const data = page.data;
67
+ const pageUrl = getPageUrl?.({ page, params: resolvedParams }) ?? page.url;
68
+ const openGraphImages = openGraph?.images === true
69
+ ? source.getPageImage(page).url
70
+ : openGraph?.images;
71
+ const defaultMetadata = {
72
+ title: data.title,
73
+ description: data.description,
74
+ keywords: data.keywords,
75
+ robots: getPageRobots(page),
76
+ ...(openGraphImages ? { openGraph: { images: openGraphImages } } : {}),
77
+ alternates: {
78
+ canonical: data.canonical,
79
+ types: {
80
+ "text/markdown": pageUrl === "/docs" ? "/docs.md" : `${pageUrl}.md`,
81
+ },
82
+ },
83
+ };
84
+ return metadata
85
+ ? await metadata({
86
+ metadata: defaultMetadata,
87
+ page,
88
+ params: resolvedParams,
89
+ })
90
+ : defaultMetadata;
91
+ };
92
+ return {
93
+ Page,
94
+ generateStaticParams,
95
+ generateMetadata,
96
+ };
97
+ };
98
+ export const createPageActions = createInternalPageActions;
@@ -0,0 +1,37 @@
1
+ import { type NextFetchEvent, type NextRequest } from "next/server";
2
+ import type { GeistdocsConfig } from "./config";
3
+ export type DetectionMethod = "ua-match" | "signature-agent" | "heuristic" | null;
4
+ export interface TrackMarkdownRequestEvent {
5
+ acceptHeader: string | null;
6
+ detectionMethod?: DetectionMethod;
7
+ path: string;
8
+ referer: string | null;
9
+ requestType?: "md-url" | "header-negotiated" | "agent-rewrite";
10
+ userAgent: string | null;
11
+ }
12
+ export interface GeistdocsProxyContext {
13
+ context: NextFetchEvent;
14
+ defaultLanguage: string;
15
+ languages: string[];
16
+ request: NextRequest;
17
+ }
18
+ type ProxyHookResult = Response | undefined | null;
19
+ export type GeistdocsProxyHook = (context: GeistdocsProxyContext) => Promise<ProxyHookResult> | ProxyHookResult;
20
+ export interface GeistdocsMarkdownRoute {
21
+ from: `/${string}`;
22
+ to: `/${string}` | ((context: {
23
+ defaultLanguage: string;
24
+ path: string[];
25
+ pathname: string;
26
+ }) => `/${string}`);
27
+ }
28
+ export interface CreateProxyOptions {
29
+ after?: GeistdocsProxyHook | GeistdocsProxyHook[];
30
+ before?: GeistdocsProxyHook | GeistdocsProxyHook[];
31
+ config: Pick<GeistdocsConfig, "content" | "defaultLanguage" | "translations">;
32
+ markdownRoutes?: GeistdocsMarkdownRoute[];
33
+ trackMarkdownRequest?: (event: TrackMarkdownRequestEvent) => Promise<void> | void;
34
+ }
35
+ export declare const createProxy: ({ after, before, config, markdownRoutes, trackMarkdownRequest, }: CreateProxyOptions) => (request: NextRequest, context: NextFetchEvent) => Promise<import("next/dist/server/web/types").NextMiddlewareResult>;
36
+ export {};
37
+ //# sourceMappingURL=proxy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,iBAAiB,GACjB,WAAW,GACX,IAAI,CAAC;AAET,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,QAAQ,GAAG,mBAAmB,GAAG,eAAe,CAAC;IAC/D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,cAAc,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,KAAK,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC;AAEhD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;IACnB,EAAE,EACE,IAAI,MAAM,EAAE,GACZ,CAAC,CAAC,OAAO,EAAE;QACT,eAAe,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;IAClD,MAAM,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;IACnD,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,iBAAiB,GAAG,cAAc,CAAC,CAAC;IAC9E,cAAc,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAC1C,oBAAoB,CAAC,EAAE,CACrB,KAAK,EAAE,yBAAyB,KAC7B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3B;AAiFD,eAAO,MAAM,WAAW,GAAI,kEAMzB,kBAAkB,MAkJL,SAAS,WAAW,EAAE,SAAS,cAAc,uEAmD5D,CAAC"}
package/dist/proxy.js ADDED
@@ -0,0 +1,189 @@
1
+ import { generateNotFoundMarkdown, isAIAgent } from "@vercel/agent-readability";
2
+ import { defineI18n } from "fumadocs-core/i18n";
3
+ import { createI18nMiddleware } from "fumadocs-core/i18n/middleware";
4
+ import { isMarkdownPreferred } from "fumadocs-core/negotiation";
5
+ import { NextResponse, } from "next/server";
6
+ const MDX_EXTENSION_PATTERN = /\.mdx?$/;
7
+ const PATH_TOKEN_PATTERN = /\*path|:path\*/g;
8
+ const PATH_WILDCARD_PATTERN = /\/\*path$/;
9
+ const DEFAULT_MARKDOWN_ROUTE = {
10
+ from: "/docs/*path",
11
+ to: "/[lang]/llms.mdx/*path",
12
+ };
13
+ const TRAILING_SLASH_PATTERN = /\/$/;
14
+ const getLanguages = (config) => {
15
+ const defaultLanguage = config.defaultLanguage ?? "en";
16
+ const languages = Object.keys(config.translations ?? {});
17
+ return {
18
+ defaultLanguage,
19
+ languages: Array.from(new Set([defaultLanguage, ...languages])),
20
+ };
21
+ };
22
+ const normalizeHooks = (hooks) => {
23
+ if (!hooks) {
24
+ return [];
25
+ }
26
+ return Array.isArray(hooks) ? hooks : [hooks];
27
+ };
28
+ const normalizeBaseUrl = (baseUrl) => {
29
+ if (baseUrl === "/") {
30
+ return "";
31
+ }
32
+ return baseUrl.replace(TRAILING_SLASH_PATTERN, "");
33
+ };
34
+ const inferMarkdownRoutes = (config) => {
35
+ if (!config.content || config.content.length === 0) {
36
+ return undefined;
37
+ }
38
+ const sections = config.content.filter((section) => normalizeBaseUrl(section.route) !== "");
39
+ const includeBaseUrlInDestination = config.content.length > 1;
40
+ return sections.map((section) => {
41
+ const baseUrl = normalizeBaseUrl(section.route) || "/";
42
+ const from = `${baseUrl === "/" ? "" : baseUrl}/*path`;
43
+ const toBase = includeBaseUrlInDestination
44
+ ? `${normalizeBaseUrl(section.route)}/*path`
45
+ : "/*path";
46
+ return {
47
+ from: from,
48
+ to: `/[lang]/llms.mdx${toBase}`,
49
+ };
50
+ });
51
+ };
52
+ const runHooks = async (hooks, proxyContext) => {
53
+ for (const hook of hooks) {
54
+ const response = await hook(proxyContext);
55
+ if (response) {
56
+ return response;
57
+ }
58
+ }
59
+ return null;
60
+ };
61
+ export const createProxy = ({ after, before, config, markdownRoutes, trackMarkdownRequest, }) => {
62
+ const routeMappings = markdownRoutes ??
63
+ inferMarkdownRoutes(config) ?? [DEFAULT_MARKDOWN_ROUTE];
64
+ const { defaultLanguage, languages } = getLanguages(config);
65
+ const i18n = defineI18n({
66
+ defaultLanguage,
67
+ languages,
68
+ hideLocale: "default-locale",
69
+ });
70
+ const internationalizer = createI18nMiddleware(i18n);
71
+ const beforeHooks = normalizeHooks(before);
72
+ const afterHooks = normalizeHooks(after);
73
+ const trackRequest = (context, event) => {
74
+ if (!trackMarkdownRequest) {
75
+ return;
76
+ }
77
+ context.waitUntil(Promise.resolve(trackMarkdownRequest(event)));
78
+ };
79
+ const resolveMarkdownRewrite = (pathname) => {
80
+ for (const route of routeMappings) {
81
+ const hasWildcard = PATH_WILDCARD_PATTERN.test(route.from);
82
+ const basePath = route.from.replace(PATH_WILDCARD_PATTERN, "");
83
+ const matches = hasWildcard
84
+ ? pathname === basePath || pathname.startsWith(`${basePath}/`)
85
+ : pathname === route.from;
86
+ if (!matches) {
87
+ continue;
88
+ }
89
+ const path = hasWildcard && pathname !== basePath
90
+ ? pathname
91
+ .slice(basePath.length + 1)
92
+ .split("/")
93
+ .filter(Boolean)
94
+ : [];
95
+ if (typeof route.to === "function") {
96
+ return route.to({ defaultLanguage, path, pathname });
97
+ }
98
+ const destination = route.to.replace("[lang]", defaultLanguage);
99
+ const pathValue = path.join("/");
100
+ const rewritten = destination.replace(PATH_TOKEN_PATTERN, pathValue);
101
+ return rewritten.endsWith("/") ? rewritten.slice(0, -1) : rewritten;
102
+ }
103
+ return null;
104
+ };
105
+ const tryMarkdownRewrite = (request, context, pathname, options) => {
106
+ const result = resolveMarkdownRewrite(pathname);
107
+ if (!result) {
108
+ return null;
109
+ }
110
+ trackRequest(context, {
111
+ path: options?.trackPath ?? pathname,
112
+ userAgent: request.headers.get("user-agent"),
113
+ referer: request.headers.get("referer"),
114
+ acceptHeader: request.headers.get("accept"),
115
+ requestType: options?.requestType,
116
+ detectionMethod: options?.detectionMethod,
117
+ });
118
+ return NextResponse.rewrite(new URL(result, request.nextUrl));
119
+ };
120
+ const isMdExtensionRequest = (pathname) => (pathname.endsWith(".md") || pathname.endsWith(".mdx")) &&
121
+ Boolean(resolveMarkdownRewrite(pathname.replace(MDX_EXTENSION_PATTERN, "")));
122
+ const handleMarkdownExtensionRequest = (request, context, pathname) => {
123
+ if (!isMdExtensionRequest(pathname)) {
124
+ return null;
125
+ }
126
+ return tryMarkdownRewrite(request, context, pathname.replace(MDX_EXTENSION_PATTERN, ""), {
127
+ requestType: "md-url",
128
+ trackPath: pathname,
129
+ });
130
+ };
131
+ const handleAgentRewrite = (request, context, pathname) => {
132
+ const agentResult = isAIAgent(request);
133
+ if (!agentResult.detected || isMarkdownPreferred(request)) {
134
+ return null;
135
+ }
136
+ const response = tryMarkdownRewrite(request, context, pathname, {
137
+ requestType: "agent-rewrite",
138
+ detectionMethod: agentResult.method,
139
+ });
140
+ if (response) {
141
+ return response;
142
+ }
143
+ return new NextResponse(generateNotFoundMarkdown(pathname), {
144
+ headers: { "Content-Type": "text/markdown; charset=utf-8" },
145
+ });
146
+ };
147
+ const handlePreferredMarkdownRequest = (request, context) => isMarkdownPreferred(request)
148
+ ? tryMarkdownRewrite(request, context, request.nextUrl.pathname, {
149
+ requestType: "header-negotiated",
150
+ })
151
+ : null;
152
+ return async (request, context) => {
153
+ const pathname = request.nextUrl.pathname;
154
+ const proxyContext = {
155
+ context,
156
+ defaultLanguage,
157
+ languages,
158
+ request,
159
+ };
160
+ const beforeResponse = await runHooks(beforeHooks, proxyContext);
161
+ if (beforeResponse) {
162
+ return beforeResponse;
163
+ }
164
+ if (pathname === "/llms.txt") {
165
+ trackRequest(context, {
166
+ path: "/llms.txt",
167
+ userAgent: request.headers.get("user-agent"),
168
+ referer: request.headers.get("referer"),
169
+ acceptHeader: request.headers.get("accept"),
170
+ });
171
+ }
172
+ const extensionResponse = handleMarkdownExtensionRequest(request, context, pathname);
173
+ if (extensionResponse) {
174
+ return extensionResponse;
175
+ }
176
+ if (resolveMarkdownRewrite(pathname) && !pathname.includes("/llms.mdx/")) {
177
+ const response = handleAgentRewrite(request, context, pathname);
178
+ if (response) {
179
+ return response;
180
+ }
181
+ }
182
+ const preferredMarkdownResponse = handlePreferredMarkdownRequest(request, context);
183
+ if (preferredMarkdownResponse) {
184
+ return preferredMarkdownResponse;
185
+ }
186
+ const afterResponse = await runHooks(afterHooks, proxyContext);
187
+ return afterResponse ?? internationalizer(request, context);
188
+ };
189
+ };
@@ -0,0 +1,21 @@
1
+ import type { NextRequest } from "next/server";
2
+ import type { GeistdocsConfig } from "../config";
3
+ export interface CreateAgentsRouteOptions {
4
+ config: Pick<GeistdocsConfig, "agent" | "basePath" | "content" | "defaultLanguage" | "github" | "nav" | "title" | "translations" | "versions">;
5
+ transform?: (markdown: string, context: {
6
+ lang?: string;
7
+ request: NextRequest;
8
+ }) => Promise<string> | string;
9
+ }
10
+ export declare const createAgentsRoute: ({ config, transform, }: CreateAgentsRouteOptions) => {
11
+ GET: (request: NextRequest, { params }?: {
12
+ params?: Promise<{
13
+ lang?: string;
14
+ }>;
15
+ }) => Promise<Response>;
16
+ generateStaticParams: () => {
17
+ lang: string;
18
+ }[];
19
+ revalidate: false;
20
+ };
21
+ //# sourceMappingURL=agents.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/routes/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,WAAW,CAAC;AAEnE,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,IAAI,CACV,eAAe,EACb,OAAO,GACP,UAAU,GACV,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,KAAK,GACL,OAAO,GACP,cAAc,GACd,UAAU,CACb,CAAC;IACF,SAAS,CAAC,EAAE,CACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAC7C,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CAC/B;AAgTD,eAAO,MAAM,iBAAiB,GAAI,wBAG/B,wBAAwB;mBAEd,WAAW,eACR;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE;;;;;CA2BtD,CAAC"}
@@ -0,0 +1,201 @@
1
+ const ABSOLUTE_URL_PATTERN = /^[a-z][a-z\d+.-]*:/i;
2
+ const TRAILING_SLASH_PATTERN = /\/$/;
3
+ const DEFAULT_AGENT_INSTRUCTIONS = [
4
+ "Use /sitemap.md to identify the most relevant documentation pages before answering broad questions.",
5
+ "Use /llms.txt when you need the complete documentation corpus as Markdown context.",
6
+ "Fetch individual documentation pages with a .md or .mdx extension for focused page-level context.",
7
+ "Do not assume API, authentication, OpenAPI, or MCP support unless it is listed in this file.",
8
+ ];
9
+ const getLanguages = (config) => {
10
+ const defaultLanguage = config.defaultLanguage ?? "en";
11
+ const languages = Object.keys(config.translations ?? {});
12
+ return Array.from(new Set([defaultLanguage, ...languages]));
13
+ };
14
+ const normalizeBasePath = (basePath) => basePath?.replace(TRAILING_SLASH_PATTERN, "") ?? "";
15
+ const withBasePath = (href, basePath) => {
16
+ if (!(href.startsWith("/") && basePath)) {
17
+ return href;
18
+ }
19
+ const normalizedBasePath = normalizeBasePath(basePath);
20
+ if (href === normalizedBasePath ||
21
+ href.startsWith(`${normalizedBasePath}/`)) {
22
+ return href;
23
+ }
24
+ return `${normalizedBasePath}${href}`;
25
+ };
26
+ const toAbsoluteUrl = ({ basePath, href, origin, }) => {
27
+ if (ABSOLUTE_URL_PATTERN.test(href) || href.startsWith("#")) {
28
+ return href;
29
+ }
30
+ return new URL(withBasePath(href, basePath), origin).toString();
31
+ };
32
+ const toSiteUrl = (config, origin, href) => toAbsoluteUrl({ basePath: config.basePath, href, origin });
33
+ const escapeMarkdown = (value) => value.replace(/([\\[\]])/g, "\\$1");
34
+ const renderLink = (label, href, description) => {
35
+ const link = `- [${escapeMarkdown(label)}](${href})`;
36
+ return description ? `${link}: ${description}` : link;
37
+ };
38
+ const renderList = (items) => items.map((item) => `- ${item}`).join("\n");
39
+ const getDocsLinks = (config, origin) => {
40
+ const contentLinks = (config.content ?? []).map((section) => ({
41
+ label: section.label,
42
+ href: toAbsoluteUrl({
43
+ basePath: config.basePath,
44
+ href: section.route,
45
+ origin,
46
+ }),
47
+ description: `Documentation section: ${section.id}`,
48
+ }));
49
+ if (contentLinks.length > 0) {
50
+ return contentLinks;
51
+ }
52
+ return [
53
+ {
54
+ label: "Documentation",
55
+ href: toAbsoluteUrl({ basePath: config.basePath, href: "/docs", origin }),
56
+ description: "Primary human-readable documentation",
57
+ },
58
+ ];
59
+ };
60
+ const getNavigationLinks = (nav, config, origin) => (nav ?? []).map((item) => ({
61
+ label: item.label,
62
+ href: toAbsoluteUrl({ basePath: config.basePath, href: item.href, origin }),
63
+ description: item.external ? "External navigation link" : undefined,
64
+ }));
65
+ const renderDocumentationSection = (config, origin) => [
66
+ "## Documentation Surfaces",
67
+ "",
68
+ ...getDocsLinks(config, origin).map((link) => renderLink(link.label, link.href, link.description)),
69
+ renderLink("Full documentation context", toSiteUrl(config, origin, "/llms.txt"), "All configured documentation as Markdown"),
70
+ renderLink("Semantic documentation sitemap", toSiteUrl(config, origin, "/sitemap.md"), "High-level documentation map for agent navigation"),
71
+ "- Page-level Markdown: append .md or .mdx to a documentation URL",
72
+ "",
73
+ ];
74
+ const renderProductSection = (product = {}) => {
75
+ if (!(product.category || product.audience?.length || product.useCases?.length)) {
76
+ return [];
77
+ }
78
+ const lines = ["## Product Context", ""];
79
+ if (product.category) {
80
+ lines.push(`- Category: ${product.category}`);
81
+ }
82
+ if (product.audience?.length) {
83
+ lines.push(`- Audience: ${product.audience.join(", ")}`);
84
+ }
85
+ if (product.useCases?.length) {
86
+ lines.push("Common use cases:", "", renderList(product.useCases));
87
+ }
88
+ lines.push("");
89
+ return lines;
90
+ };
91
+ const getApiLinks = (api, config, origin) => [
92
+ api?.openApiUrl &&
93
+ renderLink("OpenAPI specification", toSiteUrl(config, origin, api.openApiUrl)),
94
+ api?.authDocsUrl &&
95
+ renderLink("Authentication documentation", toSiteUrl(config, origin, api.authDocsUrl)),
96
+ api?.scopesDocsUrl &&
97
+ renderLink("Permission scopes", toSiteUrl(config, origin, api.scopesDocsUrl)),
98
+ api?.rateLimitsUrl &&
99
+ renderLink("Rate limits", toSiteUrl(config, origin, api.rateLimitsUrl)),
100
+ api?.errorsUrl &&
101
+ renderLink("Error handling", toSiteUrl(config, origin, api.errorsUrl)),
102
+ ].filter((link) => Boolean(link));
103
+ const renderApiSection = (api, config, origin) => {
104
+ const links = getApiLinks(api, config, origin);
105
+ return links.length > 0 ? ["## API and Auth", "", ...links, ""] : [];
106
+ };
107
+ const renderMcpSection = (mcp, config, origin) => {
108
+ const links = [
109
+ mcp?.manifestUrl &&
110
+ renderLink("MCP manifest", toSiteUrl(config, origin, mcp.manifestUrl)),
111
+ ...(mcp?.servers ?? []).map((server) => renderLink(server.name, toSiteUrl(config, origin, server.url), server.description)),
112
+ ].filter((link) => Boolean(link));
113
+ return links.length > 0 ? ["## MCP", "", ...links, ""] : [];
114
+ };
115
+ const renderImportantLinksSection = (agent, config, origin) => {
116
+ const links = [
117
+ ...getNavigationLinks(config.nav, config, origin),
118
+ ...(agent.links ?? []).map((link) => ({
119
+ ...link,
120
+ href: toSiteUrl(config, origin, link.href),
121
+ })),
122
+ ];
123
+ if (config.github) {
124
+ links.push({
125
+ label: "GitHub repository",
126
+ href: `https://github.com/${config.github.owner}/${config.github.repo}`,
127
+ description: "Source repository",
128
+ });
129
+ }
130
+ return links.length > 0
131
+ ? [
132
+ "## Important Links",
133
+ "",
134
+ ...links.map((link) => renderLink(link.label, link.href, link.description)),
135
+ "",
136
+ ]
137
+ : [];
138
+ };
139
+ const renderVersionsSection = (config, origin) => {
140
+ if (!config.versions?.items.length) {
141
+ return [];
142
+ }
143
+ return [
144
+ "## Versions",
145
+ "",
146
+ ...config.versions.items.map((version) => {
147
+ const marker = version.id === config.versions?.current ? " current" : "";
148
+ const href = version.href ?? version.routePrefix;
149
+ return href
150
+ ? renderLink(`${version.label}${marker}`, toSiteUrl(config, origin, href), version.description)
151
+ : `- ${version.label}${marker}${version.description ? `: ${version.description}` : ""}`;
152
+ }),
153
+ "",
154
+ ];
155
+ };
156
+ const renderInstructionsSection = (agent) => [
157
+ "## Agent Instructions",
158
+ "",
159
+ renderList(agent.instructions?.length ? agent.instructions : DEFAULT_AGENT_INSTRUCTIONS),
160
+ "",
161
+ ];
162
+ const renderAgentsMarkdown = (config, request) => {
163
+ const agent = config.agent ?? {};
164
+ const product = agent.product ?? {};
165
+ const origin = request.nextUrl.origin;
166
+ const name = product.name ?? config.title;
167
+ return [
168
+ `# ${name}`,
169
+ "",
170
+ ...(product.description ? [product.description, ""] : []),
171
+ "This file helps AI agents understand and use this documentation site.",
172
+ "",
173
+ ...renderDocumentationSection(config, origin),
174
+ ...renderProductSection(product),
175
+ ...renderApiSection(agent.api, config, origin),
176
+ ...renderMcpSection(agent.mcp, config, origin),
177
+ ...renderImportantLinksSection(agent, config, origin),
178
+ ...renderVersionsSection(config, origin),
179
+ ...renderInstructionsSection(agent),
180
+ ].join("\n");
181
+ };
182
+ export const createAgentsRoute = ({ config, transform, }) => {
183
+ const GET = async (request, { params } = {}) => {
184
+ if (config.agent?.enabled === false) {
185
+ return new Response("Not found", { status: 404 });
186
+ }
187
+ const { lang } = (await params) ?? {};
188
+ const markdown = renderAgentsMarkdown(config, request);
189
+ return new Response(transform ? await transform(markdown, { lang, request }) : markdown, {
190
+ headers: {
191
+ "Content-Type": "text/markdown; charset=utf-8",
192
+ },
193
+ });
194
+ };
195
+ const generateStaticParams = () => getLanguages(config).map((lang) => ({ lang }));
196
+ return {
197
+ GET,
198
+ generateStaticParams,
199
+ revalidate: false,
200
+ };
201
+ };
@@ -0,0 +1,14 @@
1
+ import type { GeistdocsConfig } from "../config";
2
+ import type { GeistdocsSourceBundle } from "../source";
3
+ type SourceBundle = GeistdocsSourceBundle;
4
+ interface CreateChatRouteOptions {
5
+ config: Pick<GeistdocsConfig, "ai" | "defaultLanguage">;
6
+ source?: SourceBundle;
7
+ sources?: SourceBundle[];
8
+ }
9
+ export declare const createChatRoute: ({ config, source, sources, }: CreateChatRouteOptions) => {
10
+ POST: (req: Request) => Promise<Response>;
11
+ maxDuration: 800;
12
+ };
13
+ export {};
14
+ //# sourceMappingURL=chat.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/routes/chat.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,KAAK,YAAY,GAAG,qBAAqB,CAAC;AAwB1C,UAAU,sBAAsB;IAC9B,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,iBAAiB,CAAC,CAAC;IACxD,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AA6PD,eAAO,MAAM,eAAe,GAAI,8BAI7B,sBAAsB;gBAIE,OAAO;;CA+EjC,CAAC"}