@lets-ship/site 0.0.0-stage → 1.0.0

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 (337) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +59 -2
  3. package/bin/ship-site.js +5 -0
  4. package/dist/badge/badge.d.ts +14 -0
  5. package/dist/badge/badge.d.ts.map +1 -0
  6. package/dist/badge/badge.js +16 -0
  7. package/dist/badge/badge.js.map +1 -0
  8. package/dist/blog/arrow.d.ts +6 -0
  9. package/dist/blog/arrow.d.ts.map +1 -0
  10. package/dist/blog/arrow.js +6 -0
  11. package/dist/blog/arrow.js.map +1 -0
  12. package/dist/blog/article-view.d.ts +20 -0
  13. package/dist/blog/article-view.d.ts.map +1 -0
  14. package/dist/blog/article-view.js +71 -0
  15. package/dist/blog/article-view.js.map +1 -0
  16. package/dist/blog/article.d.ts +72 -0
  17. package/dist/blog/article.d.ts.map +1 -0
  18. package/dist/blog/article.js +90 -0
  19. package/dist/blog/article.js.map +1 -0
  20. package/dist/blog/featured.d.ts +18 -0
  21. package/dist/blog/featured.d.ts.map +1 -0
  22. package/dist/blog/featured.js +19 -0
  23. package/dist/blog/featured.js.map +1 -0
  24. package/dist/blog/frontmatter.d.ts +155 -0
  25. package/dist/blog/frontmatter.d.ts.map +1 -0
  26. package/dist/blog/frontmatter.js +96 -0
  27. package/dist/blog/frontmatter.js.map +1 -0
  28. package/dist/blog/index-view.d.ts +21 -0
  29. package/dist/blog/index-view.d.ts.map +1 -0
  30. package/dist/blog/index-view.js +70 -0
  31. package/dist/blog/index-view.js.map +1 -0
  32. package/dist/blog/inline-markdown.d.ts +15 -0
  33. package/dist/blog/inline-markdown.d.ts.map +1 -0
  34. package/dist/blog/inline-markdown.js +44 -0
  35. package/dist/blog/inline-markdown.js.map +1 -0
  36. package/dist/blog/post-card.d.ts +37 -0
  37. package/dist/blog/post-card.d.ts.map +1 -0
  38. package/dist/blog/post-card.js +68 -0
  39. package/dist/blog/post-card.js.map +1 -0
  40. package/dist/blog/site.d.ts +57 -0
  41. package/dist/blog/site.d.ts.map +1 -0
  42. package/dist/blog/site.js +76 -0
  43. package/dist/blog/site.js.map +1 -0
  44. package/dist/blog/toc.d.ts +32 -0
  45. package/dist/blog/toc.d.ts.map +1 -0
  46. package/dist/blog/toc.js +46 -0
  47. package/dist/blog/toc.js.map +1 -0
  48. package/dist/config/context.d.ts +16 -0
  49. package/dist/config/context.d.ts.map +1 -0
  50. package/dist/config/context.js +11 -0
  51. package/dist/config/context.js.map +1 -0
  52. package/dist/config/identity.d.ts +41 -0
  53. package/dist/config/identity.d.ts.map +1 -0
  54. package/dist/config/identity.js +28 -0
  55. package/dist/config/identity.js.map +1 -0
  56. package/dist/config/json-schema.d.ts +11 -0
  57. package/dist/config/json-schema.d.ts.map +1 -0
  58. package/dist/config/json-schema.js +14 -0
  59. package/dist/config/json-schema.js.map +1 -0
  60. package/dist/config/site-config.d.ts +145 -0
  61. package/dist/config/site-config.d.ts.map +1 -0
  62. package/dist/config/site-config.js +130 -0
  63. package/dist/config/site-config.js.map +1 -0
  64. package/dist/docs/page-view.d.ts +21 -0
  65. package/dist/docs/page-view.d.ts.map +1 -0
  66. package/dist/docs/page-view.js +27 -0
  67. package/dist/docs/page-view.js.map +1 -0
  68. package/dist/feeds/feeds.d.ts +33 -0
  69. package/dist/feeds/feeds.d.ts.map +1 -0
  70. package/dist/feeds/feeds.js +122 -0
  71. package/dist/feeds/feeds.js.map +1 -0
  72. package/dist/format/dates.d.ts +5 -0
  73. package/dist/format/dates.d.ts.map +1 -0
  74. package/dist/format/dates.js +17 -0
  75. package/dist/format/dates.js.map +1 -0
  76. package/dist/format/node-text.d.ts +7 -0
  77. package/dist/format/node-text.d.ts.map +1 -0
  78. package/dist/format/node-text.js +15 -0
  79. package/dist/format/node-text.js.map +1 -0
  80. package/dist/format/toc-depth.d.ts +11 -0
  81. package/dist/format/toc-depth.d.ts.map +1 -0
  82. package/dist/format/toc-depth.js +14 -0
  83. package/dist/format/toc-depth.js.map +1 -0
  84. package/dist/i18n/fumadocs-keys.d.ts +13 -0
  85. package/dist/i18n/fumadocs-keys.d.ts.map +1 -0
  86. package/dist/i18n/fumadocs-keys.js +136 -0
  87. package/dist/i18n/fumadocs-keys.js.map +1 -0
  88. package/dist/i18n/strings.d.ts +19 -0
  89. package/dist/i18n/strings.d.ts.map +1 -0
  90. package/dist/i18n/strings.js +59 -0
  91. package/dist/i18n/strings.js.map +1 -0
  92. package/dist/i18n/tables/de.d.ts +3 -0
  93. package/dist/i18n/tables/de.d.ts.map +1 -0
  94. package/dist/i18n/tables/de.js +82 -0
  95. package/dist/i18n/tables/de.js.map +1 -0
  96. package/dist/i18n/tables/en.d.ts +3 -0
  97. package/dist/i18n/tables/en.d.ts.map +1 -0
  98. package/dist/i18n/tables/en.js +25 -0
  99. package/dist/i18n/tables/en.js.map +1 -0
  100. package/dist/i18n/tables/es.d.ts +3 -0
  101. package/dist/i18n/tables/es.d.ts.map +1 -0
  102. package/dist/i18n/tables/es.js +82 -0
  103. package/dist/i18n/tables/es.js.map +1 -0
  104. package/dist/i18n/tables/fr.d.ts +3 -0
  105. package/dist/i18n/tables/fr.d.ts.map +1 -0
  106. package/dist/i18n/tables/fr.js +82 -0
  107. package/dist/i18n/tables/fr.js.map +1 -0
  108. package/dist/i18n/tables/nl.d.ts +3 -0
  109. package/dist/i18n/tables/nl.d.ts.map +1 -0
  110. package/dist/i18n/tables/nl.js +82 -0
  111. package/dist/i18n/tables/nl.js.map +1 -0
  112. package/dist/i18n/tables/pt.d.ts +3 -0
  113. package/dist/i18n/tables/pt.d.ts.map +1 -0
  114. package/dist/i18n/tables/pt.js +82 -0
  115. package/dist/i18n/tables/pt.js.map +1 -0
  116. package/dist/i18n/tables/tr.d.ts +3 -0
  117. package/dist/i18n/tables/tr.d.ts.map +1 -0
  118. package/dist/i18n/tables/tr.js +82 -0
  119. package/dist/i18n/tables/tr.js.map +1 -0
  120. package/dist/i18n/types.d.ts +39 -0
  121. package/dist/i18n/types.d.ts.map +1 -0
  122. package/dist/i18n/types.js +2 -0
  123. package/dist/i18n/types.js.map +1 -0
  124. package/dist/layout/analytics.d.ts +9 -0
  125. package/dist/layout/analytics.d.ts.map +1 -0
  126. package/dist/layout/analytics.js +18 -0
  127. package/dist/layout/analytics.js.map +1 -0
  128. package/dist/layout/brand-files.d.ts +15 -0
  129. package/dist/layout/brand-files.d.ts.map +1 -0
  130. package/dist/layout/brand-files.js +15 -0
  131. package/dist/layout/brand-files.js.map +1 -0
  132. package/dist/layout/footer.d.ts +10 -0
  133. package/dist/layout/footer.d.ts.map +1 -0
  134. package/dist/layout/footer.js +21 -0
  135. package/dist/layout/footer.js.map +1 -0
  136. package/dist/layout/not-found.d.ts +7 -0
  137. package/dist/layout/not-found.d.ts.map +1 -0
  138. package/dist/layout/not-found.js +8 -0
  139. package/dist/layout/not-found.js.map +1 -0
  140. package/dist/layout/provider.d.ts +17 -0
  141. package/dist/layout/provider.d.ts.map +1 -0
  142. package/dist/layout/provider.js +14 -0
  143. package/dist/layout/provider.js.map +1 -0
  144. package/dist/layout/root.d.ts +17 -0
  145. package/dist/layout/root.d.ts.map +1 -0
  146. package/dist/layout/root.js +47 -0
  147. package/dist/layout/root.js.map +1 -0
  148. package/dist/lint/source.d.ts +19 -0
  149. package/dist/lint/source.d.ts.map +1 -0
  150. package/dist/lint/source.js +43 -0
  151. package/dist/lint/source.js.map +1 -0
  152. package/dist/llms/llms.d.ts +22 -0
  153. package/dist/llms/llms.d.ts.map +1 -0
  154. package/dist/llms/llms.js +24 -0
  155. package/dist/llms/llms.js.map +1 -0
  156. package/dist/markdown/article.d.ts +44 -0
  157. package/dist/markdown/article.d.ts.map +1 -0
  158. package/dist/markdown/article.js +108 -0
  159. package/dist/markdown/article.js.map +1 -0
  160. package/dist/markdown/inline.d.ts +40 -0
  161. package/dist/markdown/inline.d.ts.map +1 -0
  162. package/dist/markdown/inline.js +74 -0
  163. package/dist/markdown/inline.js.map +1 -0
  164. package/dist/markdown/page.d.ts +13 -0
  165. package/dist/markdown/page.d.ts.map +1 -0
  166. package/dist/markdown/page.js +21 -0
  167. package/dist/markdown/page.js.map +1 -0
  168. package/dist/marker.d.ts +37 -0
  169. package/dist/marker.d.ts.map +1 -0
  170. package/dist/marker.js +36 -0
  171. package/dist/marker.js.map +1 -0
  172. package/dist/mdx/allow-list.d.ts +23 -0
  173. package/dist/mdx/allow-list.d.ts.map +1 -0
  174. package/dist/mdx/allow-list.js +79 -0
  175. package/dist/mdx/allow-list.js.map +1 -0
  176. package/dist/mdx/components.d.ts +8 -0
  177. package/dist/mdx/components.d.ts.map +1 -0
  178. package/dist/mdx/components.js +68 -0
  179. package/dist/mdx/components.js.map +1 -0
  180. package/dist/mdx/remark-alerts.d.ts +4 -0
  181. package/dist/mdx/remark-alerts.d.ts.map +1 -0
  182. package/dist/mdx/remark-alerts.js +39 -0
  183. package/dist/mdx/remark-alerts.js.map +1 -0
  184. package/dist/next.d.ts +24 -0
  185. package/dist/next.d.ts.map +1 -0
  186. package/dist/next.js +55 -0
  187. package/dist/next.js.map +1 -0
  188. package/dist/node/bin.d.ts +3 -0
  189. package/dist/node/bin.d.ts.map +1 -0
  190. package/dist/node/bin.js +13 -0
  191. package/dist/node/bin.js.map +1 -0
  192. package/dist/node/brand.d.ts +13 -0
  193. package/dist/node/brand.d.ts.map +1 -0
  194. package/dist/node/brand.js +48 -0
  195. package/dist/node/brand.js.map +1 -0
  196. package/dist/node/build.d.ts +31 -0
  197. package/dist/node/build.d.ts.map +1 -0
  198. package/dist/node/build.js +151 -0
  199. package/dist/node/build.js.map +1 -0
  200. package/dist/node/cli.d.ts +11 -0
  201. package/dist/node/cli.d.ts.map +1 -0
  202. package/dist/node/cli.js +80 -0
  203. package/dist/node/cli.js.map +1 -0
  204. package/dist/node/config-file.d.ts +5 -0
  205. package/dist/node/config-file.d.ts.map +1 -0
  206. package/dist/node/config-file.js +31 -0
  207. package/dist/node/config-file.js.map +1 -0
  208. package/dist/node/content.d.ts +6 -0
  209. package/dist/node/content.d.ts.map +1 -0
  210. package/dist/node/content.js +36 -0
  211. package/dist/node/content.js.map +1 -0
  212. package/dist/node/errors.d.ts +26 -0
  213. package/dist/node/errors.d.ts.map +1 -0
  214. package/dist/node/errors.js +34 -0
  215. package/dist/node/errors.js.map +1 -0
  216. package/dist/node/files.d.ts +12 -0
  217. package/dist/node/files.d.ts.map +1 -0
  218. package/dist/node/files.js +43 -0
  219. package/dist/node/files.js.map +1 -0
  220. package/dist/node/og.d.ts +17 -0
  221. package/dist/node/og.d.ts.map +1 -0
  222. package/dist/node/og.js +43 -0
  223. package/dist/node/og.js.map +1 -0
  224. package/dist/node/project-root.d.ts +12 -0
  225. package/dist/node/project-root.d.ts.map +1 -0
  226. package/dist/node/project-root.js +27 -0
  227. package/dist/node/project-root.js.map +1 -0
  228. package/dist/node/serve.d.ts +32 -0
  229. package/dist/node/serve.d.ts.map +1 -0
  230. package/dist/node/serve.js +133 -0
  231. package/dist/node/serve.js.map +1 -0
  232. package/dist/node/theme.d.ts +15 -0
  233. package/dist/node/theme.d.ts.map +1 -0
  234. package/dist/node/theme.js +46 -0
  235. package/dist/node/theme.js.map +1 -0
  236. package/dist/search/dialog.d.ts +14 -0
  237. package/dist/search/dialog.d.ts.map +1 -0
  238. package/dist/search/dialog.js +17 -0
  239. package/dist/search/dialog.js.map +1 -0
  240. package/dist/search/language.d.ts +8 -0
  241. package/dist/search/language.d.ts.map +1 -0
  242. package/dist/search/language.js +30 -0
  243. package/dist/search/language.js.map +1 -0
  244. package/dist/search/route.d.ts +9 -0
  245. package/dist/search/route.d.ts.map +1 -0
  246. package/dist/search/route.js +11 -0
  247. package/dist/search/route.js.map +1 -0
  248. package/dist/seo/article.d.ts +84 -0
  249. package/dist/seo/article.d.ts.map +1 -0
  250. package/dist/seo/article.js +117 -0
  251. package/dist/seo/article.js.map +1 -0
  252. package/dist/seo/collection.d.ts +19 -0
  253. package/dist/seo/collection.d.ts.map +1 -0
  254. package/dist/seo/collection.js +30 -0
  255. package/dist/seo/collection.js.map +1 -0
  256. package/dist/seo/dataset.d.ts +31 -0
  257. package/dist/seo/dataset.d.ts.map +1 -0
  258. package/dist/seo/dataset.js +33 -0
  259. package/dist/seo/dataset.js.map +1 -0
  260. package/dist/seo/json-ld.d.ts +6 -0
  261. package/dist/seo/json-ld.d.ts.map +1 -0
  262. package/dist/seo/json-ld.js +8 -0
  263. package/dist/seo/json-ld.js.map +1 -0
  264. package/dist/seo/script-json.d.ts +8 -0
  265. package/dist/seo/script-json.d.ts.map +1 -0
  266. package/dist/seo/script-json.js +12 -0
  267. package/dist/seo/script-json.js.map +1 -0
  268. package/dist/seo/title.d.ts +11 -0
  269. package/dist/seo/title.d.ts.map +1 -0
  270. package/dist/seo/title.js +11 -0
  271. package/dist/seo/title.js.map +1 -0
  272. package/dist/seo/x-handle.d.ts +9 -0
  273. package/dist/seo/x-handle.d.ts.map +1 -0
  274. package/dist/seo/x-handle.js +21 -0
  275. package/dist/seo/x-handle.js.map +1 -0
  276. package/dist/site/app.d.ts +56 -0
  277. package/dist/site/app.d.ts.map +1 -0
  278. package/dist/site/app.js +79 -0
  279. package/dist/site/app.js.map +1 -0
  280. package/dist/site/features.d.ts +26 -0
  281. package/dist/site/features.d.ts.map +1 -0
  282. package/dist/site/features.js +46 -0
  283. package/dist/site/features.js.map +1 -0
  284. package/dist/site/metadata.d.ts +6 -0
  285. package/dist/site/metadata.d.ts.map +1 -0
  286. package/dist/site/metadata.js +78 -0
  287. package/dist/site/metadata.js.map +1 -0
  288. package/dist/site/outputs.d.ts +24 -0
  289. package/dist/site/outputs.d.ts.map +1 -0
  290. package/dist/site/outputs.js +113 -0
  291. package/dist/site/outputs.js.map +1 -0
  292. package/dist/site/posts.d.ts +6 -0
  293. package/dist/site/posts.d.ts.map +1 -0
  294. package/dist/site/posts.js +9 -0
  295. package/dist/site/posts.js.map +1 -0
  296. package/dist/site/routes.d.ts +43 -0
  297. package/dist/site/routes.d.ts.map +1 -0
  298. package/dist/site/routes.js +94 -0
  299. package/dist/site/routes.js.map +1 -0
  300. package/dist/site/site-page.d.ts +11 -0
  301. package/dist/site/site-page.d.ts.map +1 -0
  302. package/dist/site/site-page.js +70 -0
  303. package/dist/site/site-page.js.map +1 -0
  304. package/dist/site/sources.d.ts +58 -0
  305. package/dist/site/sources.d.ts.map +1 -0
  306. package/dist/site/sources.js +2 -0
  307. package/dist/site/sources.js.map +1 -0
  308. package/dist/site/url-style.d.ts +21 -0
  309. package/dist/site/url-style.d.ts.map +1 -0
  310. package/dist/site/url-style.js +18 -0
  311. package/dist/site/url-style.js.map +1 -0
  312. package/dist/website/blocks/commerce.d.ts +41 -0
  313. package/dist/website/blocks/commerce.d.ts.map +1 -0
  314. package/dist/website/blocks/commerce.js +26 -0
  315. package/dist/website/blocks/commerce.js.map +1 -0
  316. package/dist/website/blocks/content.d.ts +41 -0
  317. package/dist/website/blocks/content.d.ts.map +1 -0
  318. package/dist/website/blocks/content.js +25 -0
  319. package/dist/website/blocks/content.js.map +1 -0
  320. package/dist/website/blocks/marketing.d.ts +32 -0
  321. package/dist/website/blocks/marketing.d.ts.map +1 -0
  322. package/dist/website/blocks/marketing.js +23 -0
  323. package/dist/website/blocks/marketing.js.map +1 -0
  324. package/dist/website/blocks/parts.d.ts +26 -0
  325. package/dist/website/blocks/parts.d.ts.map +1 -0
  326. package/dist/website/blocks/parts.js +13 -0
  327. package/dist/website/blocks/parts.js.map +1 -0
  328. package/dist/website/page-view.d.ts +12 -0
  329. package/dist/website/page-view.d.ts.map +1 -0
  330. package/dist/website/page-view.js +10 -0
  331. package/dist/website/page-view.js.map +1 -0
  332. package/dist/zod.d.ts +8 -0
  333. package/dist/zod.d.ts.map +1 -0
  334. package/dist/zod.js +8 -0
  335. package/dist/zod.js.map +1 -0
  336. package/package.json +187 -3
  337. package/styles.css +326 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"page-view.d.ts","sourceRoot":"","sources":["../../src/docs/page-view.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAKnF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,UAAU,EACV,KAAK,GACL,EAAE;IACF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAC9B,GAAG,YAAY,CAiBf"}
@@ -0,0 +1,27 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { DocsBody, DocsDescription, DocsPage, DocsTitle, EditOnGitHub, PageFooter, } from "fumadocs-ui/layouts/docs/page";
3
+ /**
4
+ * Where "Edit on GitHub" points for a page: the config's repo URL, then the docs content folder,
5
+ * then the page's file. None when the config sets `editUrl: false`.
6
+ */
7
+ export function editLink(context, entry) {
8
+ const docs = context.config.sections.docs;
9
+ if (!docs || docs.editUrl === false)
10
+ return undefined;
11
+ const folder = docs.content.replace(/^\.\//, "").replace(/\/$/, "");
12
+ return `${docs.editUrl.replace(/\/$/, "")}/${folder}/${entry.file}`;
13
+ }
14
+ /**
15
+ * A docs page: its title and summary, the body, the contents on the side, the previous and next
16
+ * pages from the sidebar tree, and the edit link. `after` takes what follows the page, such as the
17
+ * site footer.
18
+ */
19
+ export function DocsPageView({ context, entry, components, after, }) {
20
+ const Body = entry.body;
21
+ const edit = editLink(context, entry);
22
+ return (
23
+ // The page's own footer is off and drawn here, so `after` (the site footer) comes below the
24
+ // previous and next links instead of above them.
25
+ _jsxs(DocsPage, { toc: entry.toc, footer: { enabled: false }, children: [_jsx(DocsTitle, { children: entry.title }), entry.description ? _jsx(DocsDescription, { children: entry.description }) : null, _jsx(DocsBody, { children: _jsx(Body, { components: components }) }), edit ? _jsx(EditOnGitHub, { href: edit }) : null, _jsx(PageFooter, {}), after] }));
26
+ }
27
+ //# sourceMappingURL=page-view.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"page-view.js","sourceRoot":"","sources":["../../src/docs/page-view.tsx"],"names":[],"mappings":";AAAA,OAAO,EACN,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,GACV,MAAM,+BAA+B,CAAC;AAMvC;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAoB,EAAE,KAAgB;IAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC1C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACpE,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,UAAU,EACV,KAAK,GAML;IACA,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO;IACN,4FAA4F;IAC5F,iDAAiD;IACjD,MAAC,QAAQ,IAAC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,aACnD,KAAC,SAAS,cAAE,KAAK,CAAC,KAAK,GAAa,EACnC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,KAAC,eAAe,cAAE,KAAK,CAAC,WAAW,GAAmB,CAAC,CAAC,CAAC,IAAI,EAClF,KAAC,QAAQ,cACR,KAAC,IAAI,IAAC,UAAU,EAAE,UAAU,GAAI,GACtB,EACV,IAAI,CAAC,CAAC,CAAC,KAAC,YAAY,IAAC,IAAI,EAAE,IAAI,GAAI,CAAC,CAAC,CAAC,IAAI,EAC3C,KAAC,UAAU,KAAG,EACb,KAAK,IACI,CACX,CAAC;AACH,CAAC"}
@@ -0,0 +1,33 @@
1
+ import { type BlogSite } from "../blog/site.js";
2
+ /** A published post, as a feed lists it. Drafts never reach here. */
3
+ export interface FeedPost {
4
+ readonly slug: string;
5
+ readonly title: string;
6
+ readonly description?: string;
7
+ readonly author: string;
8
+ readonly date: Date;
9
+ readonly updated?: Date;
10
+ readonly category?: string;
11
+ }
12
+ /** The three feed files, at fixed names under the blog's path. */
13
+ export interface FeedPaths {
14
+ readonly rss: string;
15
+ readonly atom: string;
16
+ readonly json: string;
17
+ }
18
+ /** Feeds asked for with no published post: there is nothing to date them by. */
19
+ export declare class FeedError extends Error {
20
+ constructor();
21
+ }
22
+ /**
23
+ * The feeds sit at the site root wherever the blog is: a site has one blog, and a template serves
24
+ * each feed from a fixed file route, which cannot move with the blog's path.
25
+ */
26
+ export declare function feedPaths(_site: BlogSite): FeedPaths;
27
+ /** RSS 2.0, with an atom:link to itself as the RSS Advisory Board recommends. */
28
+ export declare function rssFeed(site: BlogSite, posts: ReadonlyArray<FeedPost>): string;
29
+ /** Atom (RFC 4287). */
30
+ export declare function atomFeed(site: BlogSite, posts: ReadonlyArray<FeedPost>): string;
31
+ /** JSON Feed 1.1. */
32
+ export declare function jsonFeed(site: BlogSite, posts: ReadonlyArray<FeedPost>): string;
33
+ //# sourceMappingURL=feeds.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"feeds.d.ts","sourceRoot":"","sources":["../../src/feeds/feeds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,iBAAiB,CAAC;AAI9D,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,kEAAkE;AAClE,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,gFAAgF;AAChF,qBAAa,SAAU,SAAQ,KAAK;;CAKnC;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAEpD;AAiCD,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,MAAM,CAiB9E;AAmBD,uBAAuB;AACvB,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,MAAM,CAgB/E;AAED,qBAAqB;AACrB,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,MAAM,CAsB/E"}
@@ -0,0 +1,122 @@
1
+ import { postCategory } from "../blog/site.js";
2
+ import { fill } from "../i18n/strings.js";
3
+ import { stripInlineMarkdown } from "../markdown/inline.js";
4
+ /** Feeds asked for with no published post: there is nothing to date them by. */
5
+ export class FeedError extends Error {
6
+ constructor() {
7
+ super("feeds: no published post. Publish a post, or set sections.blog.feeds to false in the site config.");
8
+ this.name = "FeedError";
9
+ }
10
+ }
11
+ /**
12
+ * The feeds sit at the site root wherever the blog is: a site has one blog, and a template serves
13
+ * each feed from a fixed file route, which cannot move with the blog's path.
14
+ */
15
+ export function feedPaths(_site) {
16
+ return { rss: "/feed.xml", atom: "/atom.xml", json: "/feed.json" };
17
+ }
18
+ const escapeXml = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
19
+ /** Newest first, with the feed's own date taken from the newest change, never from the clock. */
20
+ function ordered(posts) {
21
+ if (posts.length === 0)
22
+ throw new FeedError();
23
+ const sorted = [...posts].sort((a, b) => b.date.getTime() - a.date.getTime() || a.slug.localeCompare(b.slug));
24
+ const updated = new Date(Math.max(...sorted.map((p) => (p.updated ?? p.date).getTime())));
25
+ return { posts: sorted, updated };
26
+ }
27
+ const postUrl = (site, post) => `${site.origin}${site.postPath(post.slug)}`;
28
+ const homeUrl = (site) => `${site.origin}${site.blogPath === "/" ? "" : site.blogPath}`;
29
+ const title = (site) => fill(site.strings.feedTitle, site.publisher);
30
+ function rssItem(site, post) {
31
+ const url = postUrl(site, post);
32
+ const category = postCategory(site, post.category);
33
+ return [
34
+ "<item>",
35
+ `<title>${escapeXml(stripInlineMarkdown(post.title))}</title>`,
36
+ `<link>${escapeXml(url)}</link>`,
37
+ `<guid isPermaLink="true">${escapeXml(url)}</guid>`,
38
+ `<pubDate>${post.date.toUTCString()}</pubDate>`,
39
+ `<dc:creator>${escapeXml(post.author)}</dc:creator>`,
40
+ ...(post.description ? [`<description>${escapeXml(stripInlineMarkdown(post.description))}</description>`] : []),
41
+ ...(category ? [`<category>${escapeXml(category.name)}</category>`] : []),
42
+ "</item>",
43
+ ].join("");
44
+ }
45
+ /** RSS 2.0, with an atom:link to itself as the RSS Advisory Board recommends. */
46
+ export function rssFeed(site, posts) {
47
+ const feed = ordered(posts);
48
+ return [
49
+ '<?xml version="1.0" encoding="UTF-8"?>',
50
+ '<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">',
51
+ "<channel>",
52
+ `<title>${escapeXml(title(site))}</title>`,
53
+ `<link>${escapeXml(homeUrl(site))}</link>`,
54
+ `<description>${escapeXml(site.description)}</description>`,
55
+ `<language>${escapeXml(site.locale)}</language>`,
56
+ `<lastBuildDate>${feed.updated.toUTCString()}</lastBuildDate>`,
57
+ `<atom:link href="${escapeXml(site.origin + feedPaths(site).rss)}" rel="self" type="application/rss+xml"/>`,
58
+ ...feed.posts.map((post) => rssItem(site, post)),
59
+ "</channel>",
60
+ "</rss>",
61
+ "",
62
+ ].join("\n");
63
+ }
64
+ function atomEntry(site, post) {
65
+ const url = postUrl(site, post);
66
+ const category = postCategory(site, post.category);
67
+ return [
68
+ "<entry>",
69
+ `<id>${escapeXml(url)}</id>`,
70
+ `<title>${escapeXml(stripInlineMarkdown(post.title))}</title>`,
71
+ `<link href="${escapeXml(url)}"/>`,
72
+ `<published>${post.date.toISOString()}</published>`,
73
+ `<updated>${(post.updated ?? post.date).toISOString()}</updated>`,
74
+ `<author><name>${escapeXml(post.author)}</name></author>`,
75
+ ...(post.description ? [`<summary>${escapeXml(stripInlineMarkdown(post.description))}</summary>`] : []),
76
+ ...(category ? [`<category term="${escapeXml(post.category ?? "")}" label="${escapeXml(category.name)}"/>`] : []),
77
+ "</entry>",
78
+ ].join("");
79
+ }
80
+ /** Atom (RFC 4287). */
81
+ export function atomFeed(site, posts) {
82
+ const feed = ordered(posts);
83
+ return [
84
+ '<?xml version="1.0" encoding="UTF-8"?>',
85
+ `<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="${escapeXml(site.locale)}">`,
86
+ `<id>${escapeXml(homeUrl(site))}</id>`,
87
+ `<title>${escapeXml(title(site))}</title>`,
88
+ `<subtitle>${escapeXml(site.description)}</subtitle>`,
89
+ `<updated>${feed.updated.toISOString()}</updated>`,
90
+ `<link href="${escapeXml(homeUrl(site))}"/>`,
91
+ `<link rel="self" href="${escapeXml(site.origin + feedPaths(site).atom)}" type="application/atom+xml"/>`,
92
+ `<author><name>${escapeXml(site.publisher)}</name></author>`,
93
+ ...feed.posts.map((post) => atomEntry(site, post)),
94
+ "</feed>",
95
+ "",
96
+ ].join("\n");
97
+ }
98
+ /** JSON Feed 1.1. */
99
+ export function jsonFeed(site, posts) {
100
+ const feed = ordered(posts);
101
+ const document = {
102
+ version: "https://jsonfeed.org/version/1.1",
103
+ title: title(site),
104
+ home_page_url: homeUrl(site),
105
+ feed_url: site.origin + feedPaths(site).json,
106
+ description: site.description,
107
+ language: site.locale,
108
+ authors: [{ name: site.publisher }],
109
+ items: feed.posts.map((post) => ({
110
+ id: postUrl(site, post),
111
+ url: postUrl(site, post),
112
+ title: stripInlineMarkdown(post.title),
113
+ ...(post.description ? { summary: stripInlineMarkdown(post.description) } : {}),
114
+ date_published: post.date.toISOString(),
115
+ date_modified: (post.updated ?? post.date).toISOString(),
116
+ authors: [{ name: post.author }],
117
+ ...(post.category ? { tags: [postCategory(site, post.category)?.name] } : {}),
118
+ })),
119
+ };
120
+ return `${JSON.stringify(document, null, 2)}\n`;
121
+ }
122
+ //# sourceMappingURL=feeds.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"feeds.js","sourceRoot":"","sources":["../../src/feeds/feeds.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ /** "October 17, 2026" in en, "17 October 2026" in en-GB. */
2
+ export declare function formatLongDate(at: Date, locale: string): string;
3
+ /** "Oct 17, 2026" in en. */
4
+ export declare function formatShortDate(at: Date, locale: string): string;
5
+ //# sourceMappingURL=dates.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/format/dates.ts"],"names":[],"mappings":"AASA,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,4BAA4B;AAC5B,wBAAgB,eAAe,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhE"}
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Dates as a site shows them: always UTC, in the site's language. A static page is rendered at
3
+ * build time and again in the reader's browser, and a formatter that leaves the zone to the
4
+ * runtime can name a different day on each.
5
+ */
6
+ function utc(locale, options) {
7
+ return new Intl.DateTimeFormat(locale, { ...options, timeZone: "UTC" });
8
+ }
9
+ /** "October 17, 2026" in en, "17 October 2026" in en-GB. */
10
+ export function formatLongDate(at, locale) {
11
+ return utc(locale, { year: "numeric", month: "long", day: "numeric" }).format(at);
12
+ }
13
+ /** "Oct 17, 2026" in en. */
14
+ export function formatShortDate(at, locale) {
15
+ return utc(locale, { year: "numeric", month: "short", day: "numeric" }).format(at);
16
+ }
17
+ //# sourceMappingURL=dates.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dates.js","sourceRoot":"","sources":["../../src/format/dates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,SAAS,GAAG,CAAC,MAAc,EAAE,OAAmC;IAC/D,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,cAAc,CAAC,EAAQ,EAAE,MAAc;IACtD,OAAO,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,eAAe,CAAC,EAAQ,EAAE,MAAc;IACvD,OAAO,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACpF,CAAC"}
@@ -0,0 +1,7 @@
1
+ import { type ReactNode } from "react";
2
+ /**
3
+ * The plain text of a rendered node, e.g. a contents-tree heading that carries
4
+ * inline code. Used to match structured-data steps against visible headings.
5
+ */
6
+ export declare function nodeText(node: ReactNode): string;
7
+ //# sourceMappingURL=node-text.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-text.d.ts","sourceRoot":"","sources":["../../src/format/node-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAKhD"}
@@ -0,0 +1,15 @@
1
+ import { isValidElement } from "react";
2
+ /**
3
+ * The plain text of a rendered node, e.g. a contents-tree heading that carries
4
+ * inline code. Used to match structured-data steps against visible headings.
5
+ */
6
+ export function nodeText(node) {
7
+ if (typeof node === "string" || typeof node === "number")
8
+ return String(node);
9
+ if (Array.isArray(node))
10
+ return node.map(nodeText).join("");
11
+ if (isValidElement(node))
12
+ return nodeText(node.props.children);
13
+ return "";
14
+ }
15
+ //# sourceMappingURL=node-text.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-text.js","sourceRoot":"","sources":["../../src/format/node-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAkB,MAAM,OAAO,CAAC;AAEvD;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAe;IACvC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,IAAI,cAAc,CAA2B,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzF,OAAO,EAAE,CAAC;AACX,CAAC"}
@@ -0,0 +1,11 @@
1
+ import type { TOCItemType } from "fumadocs-core/toc";
2
+ /**
3
+ * Trim a contents tree to the heading levels a post wants listed.
4
+ *
5
+ * A long post with many subsections gets a sidebar longer than the section it
6
+ * describes, so `tocDepth: 2` lists the top-level sections only. Absent depth
7
+ * keeps every entry, which is what every post did before this existed - the knob
8
+ * is opt-in, and no post changes shape unless it asks to.
9
+ */
10
+ export declare function tocToDepth(toc: TOCItemType[], depth: number | undefined): TOCItemType[];
11
+ //# sourceMappingURL=toc-depth.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"toc-depth.d.ts","sourceRoot":"","sources":["../../src/format/toc-depth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,EAAE,CAGvF"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Trim a contents tree to the heading levels a post wants listed.
3
+ *
4
+ * A long post with many subsections gets a sidebar longer than the section it
5
+ * describes, so `tocDepth: 2` lists the top-level sections only. Absent depth
6
+ * keeps every entry, which is what every post did before this existed - the knob
7
+ * is opt-in, and no post changes shape unless it asks to.
8
+ */
9
+ export function tocToDepth(toc, depth) {
10
+ if (depth === undefined)
11
+ return toc;
12
+ return toc.filter((item) => item.depth <= depth);
13
+ }
14
+ //# sourceMappingURL=toc-depth.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"toc-depth.js","sourceRoot":"","sources":["../../src/format/toc-depth.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,GAAkB,EAAE,KAAyB;IACvE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACpC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;AAClD,CAAC"}
@@ -0,0 +1,13 @@
1
+ /**
2
+ * fumadocs-ui looks its interface text up by a key made of the English text and its context
3
+ * notes, such as `Search(search trigger)`. These are the keys of fumadocs-ui 16.17.5, from its
4
+ * `dist/.translations/keys.js` without `displayName`. tests/i18n.test.ts compares them with the
5
+ * installed copy, so a fumadocs upgrade that adds a key fails until every table has it.
6
+ */
7
+ export declare const FUMADOCS_KEYS: readonly ["Ask AI(AI chat button)", "Back to Home(404 not found page)", "Choose a language(language switcher)", "Choose a language(language switcher)(aria-label)", "Close Banner(banner)(aria-label)", "Close Search(search dialog)(aria-label)", "Close Sidebar(aria-label)", "Close Sidebar(sidebar)(aria-label)", "Close(image zoom)(aria-label)", "Collapse Sidebar(sidebar)(aria-label)", "Copied Anchor Link(heading anchor)(aria-label)", "Copied Link(accordion)(aria-label)", "Copied Markdown(page actions)", "Copied Text(code block)(aria-label)", "Copy Anchor Link(heading anchor)(aria-label)", "Copy Link(accordion)(aria-label)", "Copy Markdown(page actions)", "Copy Text(code block)(aria-label)", "Dark(theme switcher)(aria-label)", "Default(type table)", "Edit on GitHub(edit page)", "Hide Sidebar(sidebar)", "Image Viewer(image zoom)(aria-label)", "Language(language switcher)", "Last updated on(page footer)", "Layout Tab(layout tab trigger)", "Light(theme switcher)(aria-label)", "Next Image(image zoom)(aria-label)", "Next Page(pagination)", "No Headings(table of contents)", "No results found(search dialog)", "On this page(table of contents)", "Open Search(search trigger)(aria-label)", "Open Sidebar(aria-label)", "Open Sidebar(sidebar)(aria-label)", "Open in ChatGPT(page actions)", "Open in Claude(page actions)", "Open in Cursor(page actions)", "Open in GitHub(page actions)", "Open in Scira AI(page actions)", "Open(page actions)", "Options(aria-label)", "Page Not Found(404 not found page)", "Parameters(type table)", "Previous Image(image zoom)(aria-label)", "Previous Page(pagination)", "Prop(type table)", "Read {url}, I want to ask questions about it.(page actions)", "Returns(type table)", "Search failed(search dialog)", "Search failed, showing results for {query}(search dialog)", "Search(search dialog)", "Search(search trigger)", "Show Sidebar(sidebar)", "System(theme switcher)(aria-label)", "Table of Contents(inline table of contents)", "The page you are looking for might have been removed, had its name changed, or is temporarily unavailable.(404 not found page)", "Theme(site menu)", "Toggle Menu(home layout header)(aria-label)", "Toggle Theme(theme switcher)(aria-label)", "Type(type table)", "View as Markdown(page actions)"];
8
+ /** The English text a key translates: the key without its trailing `(note)` groups. */
9
+ export declare function baseOf(key: string): string;
10
+ /** Every English text the keys translate, once each. A language table holds one entry per text. */
11
+ export declare const UI_TEXTS: readonly ["Ask AI", "Back to Home", "Choose a language", "Close", "Close Banner", "Close Search", "Close Sidebar", "Collapse Sidebar", "Copied Anchor Link", "Copied Link", "Copied Markdown", "Copied Text", "Copy Anchor Link", "Copy Link", "Copy Markdown", "Copy Text", "Dark", "Default", "Edit on GitHub", "Hide Sidebar", "Image Viewer", "Language", "Last updated on", "Layout Tab", "Light", "Next Image", "Next Page", "No Headings", "No results found", "On this page", "Open", "Open Search", "Open Sidebar", "Open in ChatGPT", "Open in Claude", "Open in Cursor", "Open in GitHub", "Open in Scira AI", "Options", "Page Not Found", "Parameters", "Previous Image", "Previous Page", "Prop", "Read {url}, I want to ask questions about it.", "Returns", "Search", "Search failed", "Search failed, showing results for {query}", "Show Sidebar", "System", "Table of Contents", "The page you are looking for might have been removed, had its name changed, or is temporarily unavailable.", "Theme", "Toggle Menu", "Toggle Theme", "Type", "View as Markdown"];
12
+ export type UiText = (typeof UI_TEXTS)[number];
13
+ //# sourceMappingURL=fumadocs-keys.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fumadocs-keys.d.ts","sourceRoot":"","sources":["../../src/i18n/fumadocs-keys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,aAAa,itEA+DhB,CAAC;AAEX,uFAAuF;AACvF,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,mGAAmG;AACnG,eAAO,MAAM,QAAQ,uhCA2DX,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC"}
@@ -0,0 +1,136 @@
1
+ /**
2
+ * fumadocs-ui looks its interface text up by a key made of the English text and its context
3
+ * notes, such as `Search(search trigger)`. These are the keys of fumadocs-ui 16.17.5, from its
4
+ * `dist/.translations/keys.js` without `displayName`. tests/i18n.test.ts compares them with the
5
+ * installed copy, so a fumadocs upgrade that adds a key fails until every table has it.
6
+ */
7
+ export const FUMADOCS_KEYS = [
8
+ "Ask AI(AI chat button)",
9
+ "Back to Home(404 not found page)",
10
+ "Choose a language(language switcher)",
11
+ "Choose a language(language switcher)(aria-label)",
12
+ "Close Banner(banner)(aria-label)",
13
+ "Close Search(search dialog)(aria-label)",
14
+ "Close Sidebar(aria-label)",
15
+ "Close Sidebar(sidebar)(aria-label)",
16
+ "Close(image zoom)(aria-label)",
17
+ "Collapse Sidebar(sidebar)(aria-label)",
18
+ "Copied Anchor Link(heading anchor)(aria-label)",
19
+ "Copied Link(accordion)(aria-label)",
20
+ "Copied Markdown(page actions)",
21
+ "Copied Text(code block)(aria-label)",
22
+ "Copy Anchor Link(heading anchor)(aria-label)",
23
+ "Copy Link(accordion)(aria-label)",
24
+ "Copy Markdown(page actions)",
25
+ "Copy Text(code block)(aria-label)",
26
+ "Dark(theme switcher)(aria-label)",
27
+ "Default(type table)",
28
+ "Edit on GitHub(edit page)",
29
+ "Hide Sidebar(sidebar)",
30
+ "Image Viewer(image zoom)(aria-label)",
31
+ "Language(language switcher)",
32
+ "Last updated on(page footer)",
33
+ "Layout Tab(layout tab trigger)",
34
+ "Light(theme switcher)(aria-label)",
35
+ "Next Image(image zoom)(aria-label)",
36
+ "Next Page(pagination)",
37
+ "No Headings(table of contents)",
38
+ "No results found(search dialog)",
39
+ "On this page(table of contents)",
40
+ "Open Search(search trigger)(aria-label)",
41
+ "Open Sidebar(aria-label)",
42
+ "Open Sidebar(sidebar)(aria-label)",
43
+ "Open in ChatGPT(page actions)",
44
+ "Open in Claude(page actions)",
45
+ "Open in Cursor(page actions)",
46
+ "Open in GitHub(page actions)",
47
+ "Open in Scira AI(page actions)",
48
+ "Open(page actions)",
49
+ "Options(aria-label)",
50
+ "Page Not Found(404 not found page)",
51
+ "Parameters(type table)",
52
+ "Previous Image(image zoom)(aria-label)",
53
+ "Previous Page(pagination)",
54
+ "Prop(type table)",
55
+ "Read {url}, I want to ask questions about it.(page actions)",
56
+ "Returns(type table)",
57
+ "Search failed(search dialog)",
58
+ "Search failed, showing results for {query}(search dialog)",
59
+ "Search(search dialog)",
60
+ "Search(search trigger)",
61
+ "Show Sidebar(sidebar)",
62
+ "System(theme switcher)(aria-label)",
63
+ "Table of Contents(inline table of contents)",
64
+ "The page you are looking for might have been removed, had its name changed, or is temporarily unavailable.(404 not found page)",
65
+ "Theme(site menu)",
66
+ "Toggle Menu(home layout header)(aria-label)",
67
+ "Toggle Theme(theme switcher)(aria-label)",
68
+ "Type(type table)",
69
+ "View as Markdown(page actions)",
70
+ ];
71
+ /** The English text a key translates: the key without its trailing `(note)` groups. */
72
+ export function baseOf(key) {
73
+ return key.replace(/(\([^()]*\))+$/, "");
74
+ }
75
+ /** Every English text the keys translate, once each. A language table holds one entry per text. */
76
+ export const UI_TEXTS = [
77
+ "Ask AI",
78
+ "Back to Home",
79
+ "Choose a language",
80
+ "Close",
81
+ "Close Banner",
82
+ "Close Search",
83
+ "Close Sidebar",
84
+ "Collapse Sidebar",
85
+ "Copied Anchor Link",
86
+ "Copied Link",
87
+ "Copied Markdown",
88
+ "Copied Text",
89
+ "Copy Anchor Link",
90
+ "Copy Link",
91
+ "Copy Markdown",
92
+ "Copy Text",
93
+ "Dark",
94
+ "Default",
95
+ "Edit on GitHub",
96
+ "Hide Sidebar",
97
+ "Image Viewer",
98
+ "Language",
99
+ "Last updated on",
100
+ "Layout Tab",
101
+ "Light",
102
+ "Next Image",
103
+ "Next Page",
104
+ "No Headings",
105
+ "No results found",
106
+ "On this page",
107
+ "Open",
108
+ "Open Search",
109
+ "Open Sidebar",
110
+ "Open in ChatGPT",
111
+ "Open in Claude",
112
+ "Open in Cursor",
113
+ "Open in GitHub",
114
+ "Open in Scira AI",
115
+ "Options",
116
+ "Page Not Found",
117
+ "Parameters",
118
+ "Previous Image",
119
+ "Previous Page",
120
+ "Prop",
121
+ "Read {url}, I want to ask questions about it.",
122
+ "Returns",
123
+ "Search",
124
+ "Search failed",
125
+ "Search failed, showing results for {query}",
126
+ "Show Sidebar",
127
+ "System",
128
+ "Table of Contents",
129
+ "The page you are looking for might have been removed, had its name changed, or is temporarily unavailable.",
130
+ "Theme",
131
+ "Toggle Menu",
132
+ "Toggle Theme",
133
+ "Type",
134
+ "View as Markdown",
135
+ ];
136
+ //# sourceMappingURL=fumadocs-keys.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fumadocs-keys.js","sourceRoot":"","sources":["../../src/i18n/fumadocs-keys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC5B,wBAAwB;IACxB,kCAAkC;IAClC,sCAAsC;IACtC,kDAAkD;IAClD,kCAAkC;IAClC,yCAAyC;IACzC,2BAA2B;IAC3B,oCAAoC;IACpC,+BAA+B;IAC/B,uCAAuC;IACvC,gDAAgD;IAChD,oCAAoC;IACpC,+BAA+B;IAC/B,qCAAqC;IACrC,8CAA8C;IAC9C,kCAAkC;IAClC,6BAA6B;IAC7B,mCAAmC;IACnC,kCAAkC;IAClC,qBAAqB;IACrB,2BAA2B;IAC3B,uBAAuB;IACvB,sCAAsC;IACtC,6BAA6B;IAC7B,8BAA8B;IAC9B,gCAAgC;IAChC,mCAAmC;IACnC,oCAAoC;IACpC,uBAAuB;IACvB,gCAAgC;IAChC,iCAAiC;IACjC,iCAAiC;IACjC,yCAAyC;IACzC,0BAA0B;IAC1B,mCAAmC;IACnC,+BAA+B;IAC/B,8BAA8B;IAC9B,8BAA8B;IAC9B,8BAA8B;IAC9B,gCAAgC;IAChC,oBAAoB;IACpB,qBAAqB;IACrB,oCAAoC;IACpC,wBAAwB;IACxB,wCAAwC;IACxC,2BAA2B;IAC3B,kBAAkB;IAClB,6DAA6D;IAC7D,qBAAqB;IACrB,8BAA8B;IAC9B,2DAA2D;IAC3D,uBAAuB;IACvB,wBAAwB;IACxB,uBAAuB;IACvB,oCAAoC;IACpC,6CAA6C;IAC7C,gIAAgI;IAChI,kBAAkB;IAClB,6CAA6C;IAC7C,0CAA0C;IAC1C,kBAAkB;IAClB,gCAAgC;CACvB,CAAC;AAEX,uFAAuF;AACvF,MAAM,UAAU,MAAM,CAAC,GAAW;IACjC,OAAO,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,MAAM,QAAQ,GAAG;IACvB,QAAQ;IACR,cAAc;IACd,mBAAmB;IACnB,OAAO;IACP,cAAc;IACd,cAAc;IACd,eAAe;IACf,kBAAkB;IAClB,oBAAoB;IACpB,aAAa;IACb,iBAAiB;IACjB,aAAa;IACb,kBAAkB;IAClB,WAAW;IACX,eAAe;IACf,WAAW;IACX,MAAM;IACN,SAAS;IACT,gBAAgB;IAChB,cAAc;IACd,cAAc;IACd,UAAU;IACV,iBAAiB;IACjB,YAAY;IACZ,OAAO;IACP,YAAY;IACZ,WAAW;IACX,aAAa;IACb,kBAAkB;IAClB,cAAc;IACd,MAAM;IACN,aAAa;IACb,cAAc;IACd,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,kBAAkB;IAClB,SAAS;IACT,gBAAgB;IAChB,YAAY;IACZ,gBAAgB;IAChB,eAAe;IACf,MAAM;IACN,+CAA+C;IAC/C,SAAS;IACT,QAAQ;IACR,eAAe;IACf,4CAA4C;IAC5C,cAAc;IACd,QAAQ;IACR,mBAAmB;IACnB,4GAA4G;IAC5G,OAAO;IACP,aAAa;IACb,cAAc;IACd,MAAM;IACN,kBAAkB;CACT,CAAC"}
@@ -0,0 +1,19 @@
1
+ import type { LanguageTable, SiteStrings } from "./types.js";
2
+ export type { LanguageTable, SiteStrings } from "./types.js";
3
+ export declare const LANGUAGE_TABLES: Readonly<Record<string, LanguageTable>>;
4
+ /** A site locale the engine has no table for. */
5
+ export declare class SiteLocaleError extends Error {
6
+ constructor(locale: string);
7
+ }
8
+ /** The table for a BCP-47 locale, matched on its language: en-GB reads en. */
9
+ export declare function tableFor(locale: string): LanguageTable;
10
+ /** The engine's own words for a locale. */
11
+ export declare function stringsFor(locale: string): SiteStrings;
12
+ /**
13
+ * fumadocs-ui's translations for a locale, keyed as its RootProvider wants them. English is
14
+ * empty, because fumadocs-ui's own text is English.
15
+ */
16
+ export declare function uiTranslations(locale: string): Record<string, string>;
17
+ /** A string with its %s replaced, for the few entries that carry a value. */
18
+ export declare function fill(template: string, value: string): string;
19
+ //# sourceMappingURL=strings.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/i18n/strings.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAQnE,CAAC;AAEF,iDAAiD;AACjD,qBAAa,eAAgB,SAAQ,KAAK;gBAC7B,MAAM,EAAE,MAAM;CAO1B;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAKtD;AAED,2CAA2C;AAC3C,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAEtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIrE;AAED,6EAA6E;AAC7E,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG5D"}
@@ -0,0 +1,59 @@
1
+ /**
2
+ * The interface text of a site, per language (D35): fumadocs-ui's own text and the words the
3
+ * engine's views print. Every other word on a site comes from its content, its config or its
4
+ * brand DNA. The site language is the DNA's first locale. A language with no table is an error:
5
+ * a site in Norwegian with English chrome is a wrong page, not a degraded one.
6
+ */
7
+ import { baseOf, FUMADOCS_KEYS } from "./fumadocs-keys.js";
8
+ import { DE } from "./tables/de.js";
9
+ import { EN } from "./tables/en.js";
10
+ import { ES } from "./tables/es.js";
11
+ import { FR } from "./tables/fr.js";
12
+ import { NL } from "./tables/nl.js";
13
+ import { PT } from "./tables/pt.js";
14
+ import { TR } from "./tables/tr.js";
15
+ export const LANGUAGE_TABLES = {
16
+ en: EN,
17
+ de: DE,
18
+ fr: FR,
19
+ es: ES,
20
+ nl: NL,
21
+ pt: PT,
22
+ tr: TR,
23
+ };
24
+ /** A site locale the engine has no table for. */
25
+ export class SiteLocaleError extends Error {
26
+ constructor(locale) {
27
+ super(`site strings: no table for locale "${locale}". Supported: ${Object.keys(LANGUAGE_TABLES).join(", ")}. ` +
28
+ "Add one to @lets-ship/site/i18n or change brand.locales[0] in the brand DNA.");
29
+ this.name = "SiteLocaleError";
30
+ }
31
+ }
32
+ /** The table for a BCP-47 locale, matched on its language: en-GB reads en. */
33
+ export function tableFor(locale) {
34
+ const language = locale.toLowerCase().split("-")[0] ?? "";
35
+ const table = LANGUAGE_TABLES[language];
36
+ if (!table)
37
+ throw new SiteLocaleError(locale);
38
+ return table;
39
+ }
40
+ /** The engine's own words for a locale. */
41
+ export function stringsFor(locale) {
42
+ return tableFor(locale).site;
43
+ }
44
+ /**
45
+ * fumadocs-ui's translations for a locale, keyed as its RootProvider wants them. English is
46
+ * empty, because fumadocs-ui's own text is English.
47
+ */
48
+ export function uiTranslations(locale) {
49
+ const table = tableFor(locale);
50
+ if (table === EN)
51
+ return {};
52
+ return Object.fromEntries(FUMADOCS_KEYS.map((key) => [key, table.ui[baseOf(key)]]));
53
+ }
54
+ /** A string with its %s replaced, for the few entries that carry a value. */
55
+ export function fill(template, value) {
56
+ // A function replacer, so a `$` in the value (a price, "$$$") stays as written.
57
+ return template.replace("%s", () => value);
58
+ }
59
+ //# sourceMappingURL=strings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"strings.js","sourceRoot":"","sources":["../../src/i18n/strings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAe,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAKpC,MAAM,CAAC,MAAM,eAAe,GAA4C;IACvE,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;CACN,CAAC;AAEF,iDAAiD;AACjD,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACzC,YAAY,MAAc;QACzB,KAAK,CACJ,sCAAsC,MAAM,iBAAiB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACvG,8EAA8E,CAC/E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAC/B,CAAC;CACD;AAED,8EAA8E;AAC9E,MAAM,UAAU,QAAQ,CAAC,MAAc;IACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC;AACd,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,UAAU,CAAC,MAAc;IACxC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC5B,OAAO,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/F,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,IAAI,CAAC,QAAgB,EAAE,KAAa;IACnD,gFAAgF;IAChF,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { LanguageTable } from "../types.js";
2
+ export declare const DE: LanguageTable;
3
+ //# sourceMappingURL=de.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"de.d.ts","sourceRoot":"","sources":["../../../src/i18n/tables/de.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,eAAO,MAAM,EAAE,EAAE,aAiFhB,CAAC"}