@jant/core 0.7.0 → 0.8.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 (331) hide show
  1. package/bin/commands/assets/prepare.js +3 -3
  2. package/bin/commands/db/export.js +115 -2
  3. package/bin/commands/deploy.js +11 -3
  4. package/bin/commands/{search-reindex.js → search/reindex.js} +5 -5
  5. package/bin/commands/setup.js +136 -0
  6. package/bin/commands/site/export.js +117 -68
  7. package/bin/commands/site/import.js +3074 -2
  8. package/bin/commands/site/pull-media.js +2 -6
  9. package/bin/commands/site/snapshot/export.js +18 -60
  10. package/bin/commands/site/snapshot/import.js +24 -23
  11. package/bin/commands/telegram/register-webhooks.js +48 -23
  12. package/bin/jant.js +16 -11
  13. package/bin/lib/command-registry.js +120 -0
  14. package/bin/lib/d1-query.js +87 -2
  15. package/bin/lib/hugo-markdown.js +4 -0
  16. package/bin/lib/migration-artifacts.js +19 -0
  17. package/bin/lib/renamed-arguments.js +56 -0
  18. package/bin/lib/site-pull-media.js +21 -28
  19. package/bin/lib/site-selection.js +10 -1
  20. package/bin/lib/site-snapshot.js +421 -4
  21. package/bin/lib/sql-export.js +68 -5
  22. package/bin/lib/wrangler-cli.js +9 -0
  23. package/bin/lib/zip-archive.js +187 -0
  24. package/dist/{app-K_Aa1MMn.js → app-CFsmRVJN.js} +8629 -697
  25. package/dist/client/.vite/manifest.json +20 -20
  26. package/dist/client/_assets/chunks/{create-editor-CD3FhrOB.js → create-editor-B-m7X7S5.js} +50 -46
  27. package/dist/client/_assets/chunks/{sortable-list-CgaL2jCs.js → sortable-list-BJyd-LXE.js} +1 -1
  28. package/dist/client/_assets/chunks/{unsafe-svg-0QCkP0vZ.js → unsafe-svg-BkscJx69.js} +2 -2
  29. package/dist/client/_assets/{client-GiYENVw8.css → client-BCumu1-D.css} +1 -1
  30. package/dist/client/_assets/{client-VnFxJN7G.js → client-DTLBOHqD.js} +1 -1
  31. package/dist/client/_assets/{client-auth-k8gJ6QJj.js → client-auth-D6Ix6SmE.js} +1 -1
  32. package/dist/client/_assets/{client-compose-B_kDtWkW.js → client-compose-D6rExKVK.js} +1 -1
  33. package/dist/client/_assets/{client-manage-M90aSTOk.js → client-manage-sVOkqVbH.js} +1 -1
  34. package/dist/client/_assets/{client-settings-DfYs9n1F.js → client-settings-CGR_nZ78.js} +7 -7
  35. package/dist/index.js +2 -3
  36. package/dist/node.js +8 -5
  37. package/dist/url-CKlGzvdN.js +428 -0
  38. package/package.json +13 -7
  39. package/src/__tests__/cli-commands.test.ts +144 -0
  40. package/src/__tests__/config-docs.test.ts +148 -0
  41. package/src/__tests__/dev-scripts.test.ts +203 -0
  42. package/src/__tests__/export-collection-order.test.ts +276 -0
  43. package/src/__tests__/export-feed-ids.test.ts +184 -0
  44. package/src/__tests__/export-feed-order.test.ts +294 -0
  45. package/src/__tests__/export-hugo-build.test.ts +130 -0
  46. package/src/__tests__/export-import-roundtrip.test.ts +95 -1
  47. package/src/__tests__/export-service.test.ts +611 -28
  48. package/src/__tests__/export-smart-collection.test.ts +329 -0
  49. package/src/__tests__/feed-docs.test.ts +36 -0
  50. package/src/__tests__/fixtures/releases/0.7.0/site-export/README.md +89 -0
  51. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/0x4nv/index.md +16 -0
  52. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/_index.md +41 -0
  53. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/faqyt/index.md +28 -0
  54. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +18 -0
  55. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/_index.md +4 -0
  56. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +27 -0
  57. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +32 -0
  58. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/archive/_index.md +7 -0
  59. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +27 -0
  60. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/bought-too-many-lemons-again/_index.md +34 -0
  61. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/city-walks/_index.md +11 -0
  62. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/collections/_index.md +4 -0
  63. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/current-tea-rotation/_index.md +31 -0
  64. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +27 -0
  65. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/desk-but-better/_index.md +22 -0
  66. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/e0kcg/_index.md +19 -0
  67. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/featured/_index.md +7 -0
  68. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-basho/_index.md +22 -0
  69. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-epictetus/_index.md +22 -0
  70. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-marcus-aurelius/_index.md +22 -0
  71. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-seneca/_index.md +22 -0
  72. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-thoreau/_index.md +22 -0
  73. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/2cl6d/index.md +16 -0
  74. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/3zqv7/index.md +28 -0
  75. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/5oxsv/index.md +16 -0
  76. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/_index.md +36 -0
  77. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/home-cooking/_index.md +11 -0
  78. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/_index.md +29 -0
  79. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +18 -0
  80. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/a83qu/index.md +16 -0
  81. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +19 -0
  82. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +27 -0
  83. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +27 -0
  84. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/_index.md +29 -0
  85. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/c91j0/index.md +16 -0
  86. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/qyucy/index.md +16 -0
  87. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/wsgck/index.md +16 -0
  88. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +43 -0
  89. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/reading-notes/_index.md +11 -0
  90. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +27 -0
  91. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/_index.md +41 -0
  92. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/cxiu6/index.md +16 -0
  93. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/t77ms/index.md +16 -0
  94. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +18 -0
  95. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/telk3/_index.md +27 -0
  96. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/telk3/from-thoreau-pawt2/index.md +17 -0
  97. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +32 -0
  98. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +29 -0
  99. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +27 -0
  100. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/tiny-projects/_index.md +11 -0
  101. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/useful-links/_index.md +11 -0
  102. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/weekend-notes/_index.md +11 -0
  103. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +49 -0
  104. package/src/__tests__/fixtures/releases/0.7.0/site-export/data/jant.toml +119 -0
  105. package/src/__tests__/fixtures/releases/0.7.0/site-export/hugo.toml +43 -0
  106. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/021801c20ab3-med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  107. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/0f868ce9ac84-med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  108. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/50c2ad911bad-med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  109. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/7a91f0960491-med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  110. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/8714116d3c8e-med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  111. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/8a0b4277443f-med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  112. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/a7d1c8a1afd9-med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  113. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/e25570b405f5-med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  114. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/e89ea4eabf01-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  115. package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  116. package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/custom.css +0 -0
  117. package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/favicon.ico +0 -0
  118. package/src/__tests__/fixtures/releases/0.7.0/snapshot/db.sql +218 -0
  119. package/src/__tests__/fixtures/releases/0.7.0/snapshot/meta.json +9 -0
  120. package/src/__tests__/fixtures/releases/0.7.1/site-export/README.md +89 -0
  121. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/0x4nv/index.md +16 -0
  122. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/_index.md +41 -0
  123. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/faqyt/index.md +28 -0
  124. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +18 -0
  125. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/_index.md +4 -0
  126. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +27 -0
  127. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +32 -0
  128. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/archive/_index.md +7 -0
  129. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +27 -0
  130. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/bought-too-many-lemons-again/_index.md +34 -0
  131. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/city-walks/_index.md +11 -0
  132. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/collections/_index.md +4 -0
  133. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/current-tea-rotation/_index.md +31 -0
  134. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +27 -0
  135. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/desk-but-better/_index.md +22 -0
  136. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/e0kcg/_index.md +19 -0
  137. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/featured/_index.md +7 -0
  138. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-basho/_index.md +22 -0
  139. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-epictetus/_index.md +22 -0
  140. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-marcus-aurelius/_index.md +22 -0
  141. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-seneca/_index.md +22 -0
  142. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-thoreau/_index.md +22 -0
  143. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/2cl6d/index.md +16 -0
  144. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/3zqv7/index.md +28 -0
  145. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/5oxsv/index.md +16 -0
  146. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/_index.md +36 -0
  147. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/home-cooking/_index.md +11 -0
  148. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/_index.md +29 -0
  149. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +18 -0
  150. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/a83qu/index.md +16 -0
  151. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/from-seneca-5hibo/index.md +19 -0
  152. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/mynoise-for-rainy-afternoons/_index.md +27 -0
  153. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/nts-archives-are-good-cleaning-music/_index.md +27 -0
  154. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/_index.md +29 -0
  155. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/c91j0/index.md +16 -0
  156. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/qyucy/index.md +16 -0
  157. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/wsgck/index.md +16 -0
  158. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +43 -0
  159. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/reading-notes/_index.md +11 -0
  160. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +27 -0
  161. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/_index.md +41 -0
  162. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/cxiu6/index.md +16 -0
  163. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/t77ms/index.md +16 -0
  164. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/the-soup-trick-i-always-forget/index.md +18 -0
  165. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/telk3/_index.md +27 -0
  166. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/telk3/from-thoreau-pawt2/index.md +17 -0
  167. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +32 -0
  168. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +29 -0
  169. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +27 -0
  170. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/tiny-projects/_index.md +11 -0
  171. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/useful-links/_index.md +11 -0
  172. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/weekend-notes/_index.md +11 -0
  173. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/what-i-actually-use-my-notebook-for/_index.md +49 -0
  174. package/src/__tests__/fixtures/releases/0.7.1/site-export/data/jant.toml +119 -0
  175. package/src/__tests__/fixtures/releases/0.7.1/site-export/hugo.toml +43 -0
  176. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/021801c20ab3-med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  177. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/0f868ce9ac84-med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  178. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/50c2ad911bad-med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  179. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/7a91f0960491-med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  180. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/8714116d3c8e-med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  181. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/8a0b4277443f-med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  182. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/a7d1c8a1afd9-med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  183. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/e25570b405f5-med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  184. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/e89ea4eabf01-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  185. package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  186. package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/custom.css +0 -0
  187. package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/favicon.ico +0 -0
  188. package/src/__tests__/fixtures/releases/0.7.1/snapshot/db.sql +322 -0
  189. package/src/__tests__/fixtures/releases/0.7.1/snapshot/meta.json +9 -0
  190. package/src/__tests__/helpers/hugo-site.ts +146 -0
  191. package/src/__tests__/helpers/site-export-import.ts +97 -0
  192. package/src/__tests__/import-site-command.test.ts +514 -2
  193. package/src/__tests__/mise-config.test.ts +75 -4
  194. package/src/__tests__/node-dev-tasks.test.ts +264 -0
  195. package/src/__tests__/release-fixtures.test.ts +132 -0
  196. package/src/__tests__/site-export-canonical-import.test.ts +113 -0
  197. package/src/__tests__/snapshot-canonical-replay.test.ts +179 -0
  198. package/src/__tests__/snapshot-settings.test.ts +97 -0
  199. package/src/__tests__/snapshot-tables.test.ts +219 -0
  200. package/src/__tests__/sql-export.test.ts +173 -0
  201. package/src/__tests__/theme-docs.test.ts +109 -0
  202. package/src/__tests__/zip-archive.test.ts +106 -0
  203. package/src/app.tsx +16 -11
  204. package/src/client/components/__tests__/jant-settings-avatar.test.ts +1 -1
  205. package/src/client/components/__tests__/jant-settings-general.test.ts +21 -1
  206. package/src/client/components/jant-repo-picker-types.ts +6 -1
  207. package/src/client/components/jant-repo-picker.ts +4 -7
  208. package/src/client/components/jant-settings-general.ts +17 -12
  209. package/src/client/tiptap/__tests__/list-editing.test.ts +224 -86
  210. package/src/client/tiptap/__tests__/mark-exit.test.ts +1 -2
  211. package/src/client/tiptap/__tests__/markdown-clipboard.test.ts +26 -0
  212. package/src/client/tiptap/extensions.ts +0 -3
  213. package/src/client/tiptap/structural-keymap.ts +158 -47
  214. package/src/db/__tests__/d1-query.test.ts +56 -1
  215. package/src/db/rehearsal-fixtures/pg-demo-current.json +55 -0
  216. package/src/db/rehearsal-fixtures/pg-demo-current.sql +431 -0
  217. package/src/i18n/locales/public/en.po +0 -2
  218. package/src/i18n/locales/public/zh-Hans.po +0 -2
  219. package/src/i18n/locales/public/zh-Hant.po +0 -2
  220. package/src/i18n/locales/settings/en.po +8 -8
  221. package/src/i18n/locales/settings/en.ts +1 -1
  222. package/src/i18n/locales/settings/zh-Hans.po +8 -8
  223. package/src/i18n/locales/settings/zh-Hans.ts +1 -1
  224. package/src/i18n/locales/settings/zh-Hant.po +8 -8
  225. package/src/i18n/locales/settings/zh-Hant.ts +1 -1
  226. package/src/index.ts +6 -77
  227. package/src/lib/__tests__/github-sync-repo-name.test.ts +40 -0
  228. package/src/lib/__tests__/image.test.ts +27 -1
  229. package/src/lib/__tests__/markdown-to-tiptap.test.ts +105 -0
  230. package/src/lib/__tests__/markdown.test.ts +10 -0
  231. package/src/lib/__tests__/resolve-config.test.ts +67 -0
  232. package/src/lib/__tests__/schemas.test.ts +27 -1
  233. package/src/lib/__tests__/timeline.test.ts +87 -0
  234. package/src/lib/__tests__/tiptap-to-markdown.test.ts +172 -4
  235. package/src/lib/__tests__/view.test.ts +0 -46
  236. package/src/lib/discover.ts +3 -1
  237. package/src/lib/feed.ts +0 -6
  238. package/src/lib/github-sync-repo-name.ts +45 -0
  239. package/src/lib/hugo-markdown.ts +46 -0
  240. package/src/lib/image.ts +17 -4
  241. package/src/lib/markdown-manager.ts +392 -2
  242. package/src/lib/post-body-html.ts +11 -4
  243. package/src/lib/resolve-config.ts +58 -1
  244. package/src/lib/schemas.ts +50 -5
  245. package/src/lib/thread-fold.ts +3 -3
  246. package/src/lib/timeline.ts +1 -1
  247. package/src/lib/tiptap-to-markdown.ts +13 -7
  248. package/src/lib/url.ts +20 -0
  249. package/src/lib/view.ts +2 -29
  250. package/src/node/__tests__/cli-export.test.ts +2 -2
  251. package/src/node/__tests__/cli-setup.test.ts +163 -0
  252. package/src/node/__tests__/cli-site-snapshot.test.ts +73 -0
  253. package/src/node/__tests__/cli-site-token-env.test.ts +4 -1
  254. package/src/node/__tests__/cli-snapshot-meta.test.ts +84 -0
  255. package/src/node/__tests__/runtime.test.ts +38 -0
  256. package/src/node/index.ts +2 -0
  257. package/src/node/request-handler.ts +3 -1
  258. package/src/routes/api/__tests__/posts.test.ts +24 -0
  259. package/src/routes/api/__tests__/upload.test.ts +34 -0
  260. package/src/routes/api/export.ts +3 -3
  261. package/src/routes/api/internal/search-reindex.ts +1 -1
  262. package/src/routes/api/internal/sites.ts +0 -1
  263. package/src/routes/api/posts.ts +2 -0
  264. package/src/routes/api/public/posts.ts +21 -1
  265. package/src/routes/api/upload.ts +10 -3
  266. package/src/routes/compose.tsx +4 -0
  267. package/src/routes/dash/__tests__/github-sync-app.test.ts +365 -0
  268. package/src/routes/dash/settings.tsx +212 -70
  269. package/src/routes/pages/__tests__/post-page-round-trips.test.ts +211 -0
  270. package/src/routes/pages/__tests__/thread-order.test.ts +179 -0
  271. package/src/routes/pages/archive.tsx +17 -11
  272. package/src/routes/pages/featured.tsx +11 -5
  273. package/src/routes/pages/page.tsx +53 -31
  274. package/src/routes/pages/search.tsx +4 -2
  275. package/src/runtime/__tests__/readiness.test.ts +23 -0
  276. package/src/runtime/node.ts +49 -0
  277. package/src/runtime/readiness.ts +15 -0
  278. package/src/services/__tests__/bootstrap-setup-instance.test.ts +230 -0
  279. package/src/services/__tests__/custom-url.test.ts +34 -0
  280. package/src/services/__tests__/github-app-installations.test.ts +153 -0
  281. package/src/services/__tests__/github-sync-push.test.ts +46 -0
  282. package/src/services/__tests__/media.test.ts +31 -271
  283. package/src/services/__tests__/path.test.ts +56 -0
  284. package/src/services/__tests__/post-timeline.test.ts +127 -0
  285. package/src/services/__tests__/post.test.ts +74 -0
  286. package/src/services/bootstrap.ts +263 -44
  287. package/src/services/custom-url.ts +2 -2
  288. package/src/services/export-theme/layouts/_default/alias.html +27 -1
  289. package/src/services/export-theme/layouts/_default/list.html +2 -63
  290. package/src/services/export-theme/layouts/_default/rss.xml +27 -38
  291. package/src/services/export-theme/layouts/collections/list.html +3 -3
  292. package/src/services/export-theme/layouts/featured/list.html +1 -4
  293. package/src/services/export-theme/layouts/index.html +40 -26
  294. package/src/services/export-theme/layouts/partials/collection-members.html +100 -0
  295. package/src/services/export-theme/layouts/partials/collection-threads.html +33 -0
  296. package/src/services/export-theme/layouts/partials/featured-members.html +35 -0
  297. package/src/services/export-theme/layouts/partials/featured-thread.html +1 -1
  298. package/src/services/export-theme/layouts/partials/footer.html +1 -1
  299. package/src/services/export-theme/layouts/partials/head.html +1 -1
  300. package/src/services/export-theme/layouts/partials/header.html +5 -3
  301. package/src/services/export-theme/layouts/partials/jant-data.html +23 -0
  302. package/src/services/export-theme/layouts/partials/latest-members.html +48 -0
  303. package/src/services/export-theme/layouts/partials/smart-collection-members.html +129 -0
  304. package/src/services/export-theme/layouts/partials/thread-preview.html +1 -1
  305. package/src/services/export-theme/layouts/post/list.html +1 -1
  306. package/src/services/export-theme/layouts/smart_collection/list.html +24 -0
  307. package/src/services/export-theme/styles/main.css +0 -1
  308. package/src/services/export-theme/theme.toml +1 -1
  309. package/src/services/export.ts +630 -73
  310. package/src/services/github-app-installations.ts +171 -4
  311. package/src/services/github-sync.ts +69 -15
  312. package/src/services/mcp.ts +19 -1
  313. package/src/services/media.ts +9 -220
  314. package/src/services/path.ts +34 -1
  315. package/src/services/post.ts +214 -39
  316. package/src/services/site-admin.ts +3 -7
  317. package/src/services/site.ts +83 -31
  318. package/src/styles/ui.css +7 -119
  319. package/src/types/app-context.ts +16 -0
  320. package/src/types/bindings.ts +5 -0
  321. package/src/types/operations.ts +10 -0
  322. package/src/ui/dash/settings/GeneralContent.tsx +10 -8
  323. package/bin/commands/export.js +0 -118
  324. package/bin/commands/import-site.js +0 -2561
  325. package/bin/commands/migrate-text-attachments.js +0 -181
  326. package/dist/github-sync-BPAvT999.js +0 -7709
  327. package/src/client/multipart-upload.ts +0 -206
  328. package/src/client/tiptap/exitable-marks.ts +0 -73
  329. package/src/routes/api/__tests__/upload-multipart.test.ts +0 -739
  330. package/src/routes/api/internal/text-attachments.ts +0 -60
  331. package/src/routes/api/upload-multipart.ts +0 -366
@@ -733,6 +733,93 @@ describe("Timeline data assembly", () => {
733
733
  ]);
734
734
  });
735
735
 
736
+ // A reply can be older than its root (a post moved into the Thread keeps
737
+ // its creation time; an export without `created` dates posts by
738
+ // publication). The Thread still opens on its root.
739
+ async function createThreadWithOlderReplies() {
740
+ const root = await postService.create({
741
+ format: "note",
742
+ bodyMarkdown: "Root",
743
+ featured: true,
744
+ publishedAt: 3000,
745
+ });
746
+ const first = await postService.create({
747
+ format: "note",
748
+ bodyMarkdown: "First reply",
749
+ replyToId: root.id,
750
+ publishedAt: 1000,
751
+ });
752
+ const second = await postService.create({
753
+ format: "note",
754
+ bodyMarkdown: "Second reply",
755
+ replyToId: first.id,
756
+ publishedAt: 2000,
757
+ });
758
+ for (const [id, createdAt] of [
759
+ [root.id, 3000],
760
+ [first.id, 1000],
761
+ [second.id, 2000],
762
+ ] as const) {
763
+ await db.update(postTable).set({ createdAt }).where(eq(postTable.id, id));
764
+ }
765
+ return { root, first, second };
766
+ }
767
+
768
+ it("keeps a Featured Thread whose replies are older than its root", async () => {
769
+ const { root, second } = await createThreadWithOlderReplies();
770
+
771
+ const result = await assembleFeaturedTimeline(createTimelineContext(), {
772
+ isAuthenticated: true,
773
+ });
774
+
775
+ expect(result.items).toHaveLength(1);
776
+ expect(result.items[0]?.post.id).toBe(root.id);
777
+ expect(result.items[0]?.curatedThread?.segments).toEqual([
778
+ expect.objectContaining({
779
+ post: expect.objectContaining({ id: root.id }),
780
+ hiddenBeforeCount: 0,
781
+ highlighted: true,
782
+ }),
783
+ expect.objectContaining({
784
+ post: expect.objectContaining({ id: second.id }),
785
+ hiddenBeforeCount: 1,
786
+ highlighted: false,
787
+ }),
788
+ ]);
789
+ });
790
+
791
+ it("renders a collected Thread whose replies are older than its root", async () => {
792
+ const collection = await collectionService.create({
793
+ slug: "older-replies",
794
+ title: "Older replies",
795
+ });
796
+ const { root, first, second } = await createThreadWithOlderReplies();
797
+ await collectionService.addThread(collection.id, root.id);
798
+
799
+ const result = await assembleCollectionTimeline(createTimelineContext(), {
800
+ collectionIds: [collection.id],
801
+ isAuthenticated: true,
802
+ sortOrder: "newest",
803
+ });
804
+
805
+ expect(result.items).toHaveLength(1);
806
+ expect(result.items[0]?.post.id).toBe(root.id);
807
+ expect(result.items[0]?.curatedThread?.segments).toEqual([
808
+ expect.objectContaining({
809
+ post: expect.objectContaining({ id: root.id }),
810
+ highlighted: false,
811
+ }),
812
+ expect.objectContaining({
813
+ post: expect.objectContaining({ id: first.id }),
814
+ highlighted: false,
815
+ }),
816
+ expect.objectContaining({
817
+ post: expect.objectContaining({ id: second.id }),
818
+ highlighted: true,
819
+ }),
820
+ ]);
821
+ });
822
+
736
823
  it("deduplicates Threads selected through multiple collections", async () => {
737
824
  const smart = await collectionService.create({
738
825
  slug: "smart",
@@ -361,6 +361,154 @@ describe("tiptapJsonToMarkdown", () => {
361
361
  );
362
362
  expect(tiptapJsonToMarkdown(json)).toBe("Line 1 \nLine 2");
363
363
  });
364
+
365
+ // Trailing spaces on a line with nothing else on it make a blank line,
366
+ // which ends the paragraph (or leaves a list item empty).
367
+ it("keeps two hard breaks in a row inside one paragraph", () => {
368
+ const br = { type: "hardBreak" };
369
+ const json = doc(p(text("A"), br, br, text("B")));
370
+ const markdown = tiptapJsonToMarkdown(json);
371
+ expect(markdown).toBe("A \n\\\nB");
372
+ expect(JSON.parse(markdownToTiptapJson(markdown))).toEqual(
373
+ JSON.parse(json),
374
+ );
375
+ });
376
+
377
+ it("keeps a list item that opens with a hard break in the list", () => {
378
+ const json = doc({
379
+ type: "bulletList",
380
+ content: [
381
+ {
382
+ type: "listItem",
383
+ content: [p({ type: "hardBreak" }, text("Ships in 3–7 days"))],
384
+ },
385
+ { type: "listItem", content: [p(text("Next"))] },
386
+ ],
387
+ });
388
+ const markdown = tiptapJsonToMarkdown(json);
389
+ expect(JSON.parse(markdownToTiptapJson(markdown))).toEqual(
390
+ JSON.parse(json),
391
+ );
392
+ });
393
+ });
394
+
395
+ // CommonMark only closes `**` after punctuation when a space or another
396
+ // punctuation mark follows, so `**句子。**后文` stays literal asterisks in
397
+ // Hugo and in Jant. Those runs use HTML tags, which both read.
398
+ describe("emphasis a delimiter can't open or close", () => {
399
+ const bold = [{ type: "bold" }];
400
+
401
+ it.each([
402
+ [
403
+ "bold ending in CJK punctuation before a letter",
404
+ [text("而是:"), text("固定时间,一群人。", bold), text("来的人")],
405
+ "而是:<strong>固定时间,一群人。</strong>来的人",
406
+ ],
407
+ [
408
+ "bold opening on CJK punctuation after a letter",
409
+ [text("说"), text("「引用」", bold), text("后")],
410
+ "说<strong>「引用」</strong>后",
411
+ ],
412
+ [
413
+ "italic ending in punctuation before a letter",
414
+ [text("这是"), text("强调。", [{ type: "italic" }]), text("后面")],
415
+ "这是<em>强调。</em>后面",
416
+ ],
417
+ [
418
+ "strike ending in punctuation before a letter",
419
+ [text("价格"), text("100元。", [{ type: "strike" }]), text("现在")],
420
+ "价格<s>100元。</s>现在",
421
+ ],
422
+ [
423
+ "English bold ending in a period before a letter",
424
+ [text("Say "), text("hello.", bold), text("World")],
425
+ "Say <strong>hello.</strong>World",
426
+ ],
427
+ ])("writes %s as HTML", (_label, content, expected) => {
428
+ const json = doc(p(...content));
429
+ expect(tiptapJsonToMarkdown(json)).toBe(expected);
430
+ expect(JSON.parse(markdownToTiptapJson(expected))).toEqual(
431
+ JSON.parse(json),
432
+ );
433
+ });
434
+
435
+ it.each([
436
+ [
437
+ "between spaces",
438
+ [text("a "), text("bold", bold), text(" b")],
439
+ "a **bold** b",
440
+ ],
441
+ [
442
+ "inside CJK text",
443
+ [text("中"), text("加粗", bold), text("文")],
444
+ "中**加粗**文",
445
+ ],
446
+ [
447
+ "ending in punctuation before punctuation",
448
+ [text("说"), text("好。", bold), text("」")],
449
+ "说**好。**」",
450
+ ],
451
+ ])("keeps Markdown delimiters %s", (_label, content, expected) => {
452
+ const json = doc(p(...content));
453
+ expect(tiptapJsonToMarkdown(json)).toBe(expected);
454
+ expect(JSON.parse(markdownToTiptapJson(expected))).toEqual(
455
+ JSON.parse(json),
456
+ );
457
+ });
458
+ });
459
+
460
+ // Text that happens to open a line with block syntax must come back as the
461
+ // same paragraph, not as a list, heading, or setext underline.
462
+ describe("block markers at the start of a line", () => {
463
+ const br = { type: "hardBreak" };
464
+
465
+ it.each([
466
+ ["a numbered line", [text("1986. A good year")], "1986\\. A good year"],
467
+ ["a parenthesized number", [text("2) Second")], "2\\) Second"],
468
+ ["a dash", [text("- not a list")], "\\- not a list"],
469
+ ["a plus", [text("+ not a list")], "\\+ not a list"],
470
+ ["a hash", [text("# not a heading")], "\\# not a heading"],
471
+ [
472
+ "numbered lines after hard breaks",
473
+ [text("Update:"), br, text("1. Pony"), br, text("2. Next")],
474
+ "Update: \n1\\. Pony \n2\\. Next",
475
+ ],
476
+ [
477
+ "a dash rule after a hard break",
478
+ [text("Title"), br, text("---")],
479
+ "Title \n\\---",
480
+ ],
481
+ [
482
+ "an equals rule after a hard break",
483
+ [text("Title"), br, text("===")],
484
+ "Title \n\\===",
485
+ ],
486
+ ])("escapes %s", (_label, content, expected) => {
487
+ const json = doc(p(...content));
488
+ expect(tiptapJsonToMarkdown(json)).toBe(expected);
489
+ expect(JSON.parse(markdownToTiptapJson(expected))).toEqual(
490
+ JSON.parse(json),
491
+ );
492
+ });
493
+
494
+ it("leaves markers in the middle of a line alone", () => {
495
+ expect(tiptapJsonToMarkdown(doc(p(text("Step 1. then 2."))))).toBe(
496
+ "Step 1. then 2.",
497
+ );
498
+ });
499
+
500
+ it("escapes a numbered line inside a list item", () => {
501
+ const json = doc({
502
+ type: "orderedList",
503
+ content: [
504
+ { type: "listItem", content: [p(text("1. nested-looking"))] },
505
+ ],
506
+ });
507
+ expect(tiptapJsonToMarkdown(json)).toBe("1. 1\\. nested-looking");
508
+ expect(
509
+ JSON.parse(markdownToTiptapJson("1. 1\\. nested-looking")),
510
+ ).toEqual(JSON.parse(json));
511
+ });
364
512
  });
365
513
 
366
514
  describe("round-trip", () => {
@@ -411,12 +559,32 @@ describe("tiptapJsonToMarkdown", () => {
411
559
  });
412
560
 
413
561
  describe("edge cases", () => {
414
- it("returns empty string for invalid JSON", () => {
415
- expect(tiptapJsonToMarkdown("not json")).toBe("");
562
+ it("throws for invalid JSON instead of returning nothing", () => {
563
+ expect(() => tiptapJsonToMarkdown("not json")).toThrow();
416
564
  });
417
565
 
418
- it("returns empty string for non-doc node", () => {
419
- expect(tiptapJsonToMarkdown('{"type":"paragraph"}')).toBe("");
566
+ it("throws for a root that is not a doc", () => {
567
+ expect(() => tiptapJsonToMarkdown('{"type":"paragraph"}')).toThrow(/doc/);
568
+ });
569
+
570
+ // A stored body with an empty list item made the serializer throw, and
571
+ // the catch-all turned the whole post into "" in the export.
572
+ it("fills an empty list item instead of dropping the document", () => {
573
+ const json = doc(
574
+ { type: "heading", attrs: { level: 2 }, content: [text("Setup")] },
575
+ {
576
+ type: "orderedList",
577
+ content: [
578
+ { type: "listItem", content: [] },
579
+ { type: "listItem", content: [p(text("Install"))] },
580
+ ],
581
+ },
582
+ { type: "codeBlock", content: [text("nix run")] },
583
+ );
584
+ const markdown = tiptapJsonToMarkdown(json);
585
+ expect(markdown).toContain("## Setup");
586
+ expect(markdown).toContain("Install");
587
+ expect(markdown).toContain("nix run");
420
588
  });
421
589
 
422
590
  it("handles empty doc", () => {
@@ -10,7 +10,6 @@ import {
10
10
  toNavItemView,
11
11
  toNavItemViews,
12
12
  toSearchResultView,
13
- toArchiveGroups,
14
13
  } from "../view.js";
15
14
  import type { MediaContext } from "../view.js";
16
15
  import type {
@@ -984,48 +983,3 @@ describe("toSearchResultView", () => {
984
983
  expect(view.post.permalink).toBe("/my-link");
985
984
  });
986
985
  });
987
-
988
- // =============================================================================
989
- // toArchiveGroups
990
- // =============================================================================
991
-
992
- describe("toArchiveGroups", () => {
993
- it("converts grouped map to ArchiveGroup array", () => {
994
- const grouped = new Map<string, Post[]>();
995
- grouped.set("2024-02", [
996
- makePost({ id: UUID_1, publishedAt: 1706745600 }),
997
- makePost({ id: UUID_2, publishedAt: 1706832000 }),
998
- ]);
999
- grouped.set("2024-01", [makePost({ id: UUID_3, publishedAt: 1704067200 })]);
1000
-
1001
- const groups = toArchiveGroups(grouped, EMPTY_CTX);
1002
- expect(groups).toHaveLength(2);
1003
-
1004
- expect(groups[0]).toHaveProperty("year", "2024");
1005
- expect(groups[0]).toHaveProperty("month", "02");
1006
- expect(groups[0]).toHaveProperty("label", "February 2024");
1007
- expect(groups[0]).toHaveProperty("posts");
1008
- expect(groups[0]?.posts).toHaveLength(2);
1009
-
1010
- expect(groups[1]).toHaveProperty("year", "2024");
1011
- expect(groups[1]).toHaveProperty("month", "01");
1012
- expect(groups[1]).toHaveProperty("label", "January 2024");
1013
- expect(groups[1]?.posts).toHaveLength(1);
1014
- });
1015
-
1016
- it("converts posts to PostView within groups", () => {
1017
- const grouped = new Map<string, Post[]>();
1018
- grouped.set("2024-02", [makePost({ id: UUID_1 })]);
1019
-
1020
- const groups = toArchiveGroups(grouped, EMPTY_CTX);
1021
- const post = groups[0]?.posts[0];
1022
- expect(post).toBeDefined();
1023
- expect(post?.permalink).toBeDefined();
1024
- expect(post?.publishedAtFormatted).toBeDefined();
1025
- });
1026
-
1027
- it("handles empty map", () => {
1028
- const groups = toArchiveGroups(new Map(), EMPTY_CTX);
1029
- expect(groups).toHaveLength(0);
1030
- });
1031
- });
@@ -400,7 +400,9 @@ export function linkTerms(
400
400
  * than on the checkbox label. The settings page and the setup screen both
401
401
  * render their line through here, so the two can never link different words;
402
402
  * setup's line is the settings line's opening sentence, so only the name is
403
- * there to find.
403
+ * there to find. The notice that replaces the settings line while the box is
404
+ * locked in demo mode goes through here too, and it also names only the
405
+ * directory.
404
406
  *
405
407
  * @param intro - The translated help line
406
408
  * @param terms - The translated directory and rules-page names, as `intro`
package/src/lib/feed.ts CHANGED
@@ -2,12 +2,6 @@
2
2
  * Default Feed Renderers
3
3
  *
4
4
  * Atom and Sitemap XML generators.
5
- * Theme authors can import these to extend/wrap the defaults:
6
- *
7
- * @example
8
- * ```typescript
9
- * import { defaultFeedRenderer } from "@jant/core/lib/feed";
10
- * ```
11
5
  */
12
6
 
13
7
  import type {
@@ -0,0 +1,45 @@
1
+ /**
2
+ * The repository name Jant proposes for a site's GitHub Sync mirror.
3
+ *
4
+ * The settings page prefills it on github.com/new, and a site export with no
5
+ * repository behind it uses it as the Worker name in `wrangler.jsonc`.
6
+ * Cloudflare names a Worker imported from a repository after the repository,
7
+ * so an export and a repository created with the default name agree without
8
+ * anyone editing either.
9
+ */
10
+
11
+ /** Used when the site URL yields no host label. */
12
+ const FALLBACK_REPO_NAME = "jant-site-sync";
13
+
14
+ /**
15
+ * Derive the default repository name for a site's sync mirror.
16
+ *
17
+ * Uses the first DNS label of the site's host — a stable, URL-safe
18
+ * identifier tied to this Jant instance. A leading `www` is skipped: it
19
+ * names nothing about the site, and every `www.` site would otherwise
20
+ * propose the same `www-jant-sync`. It is kept when only a top-level domain
21
+ * follows it, since that label would say even less. The `-jant-sync` suffix
22
+ * tells the sync mirror apart from a user's own `{slug}-jant` source repo.
23
+ *
24
+ * @param siteUrl - The site's public URL.
25
+ * @returns A GitHub-safe repository name; `jant-site-sync` when the URL has
26
+ * no usable host.
27
+ * @example
28
+ * suggestSyncRepoName("https://notes.example.com"); // "notes-jant-sync"
29
+ * suggestSyncRepoName("https://www.example.com"); // "example-jant-sync"
30
+ */
31
+ export function suggestSyncRepoName(siteUrl: string): string {
32
+ let labels: string[] = [];
33
+ try {
34
+ labels = new URL(siteUrl).host.split(".");
35
+ } catch {
36
+ /* fall through */
37
+ }
38
+ const [first = "", second = "", ...more] = labels;
39
+ const label = first === "www" && more.length > 0 ? second : first;
40
+ const slug = label
41
+ .toLowerCase()
42
+ .replace(/[^a-z0-9-_]+/g, "-")
43
+ .replace(/^-+|-+$/g, "");
44
+ return slug ? `${slug}-jant-sync` : FALLBACK_REPO_NAME;
45
+ }
@@ -34,6 +34,24 @@ export interface HugoCollectionRef {
34
34
  pinned_at?: string | null;
35
35
  }
36
36
 
37
+ /**
38
+ * A smart collection's conditions on its section page (`type:
39
+ * smart_collection`). The stored selection, with two changes of spelling:
40
+ * `collection` is one collection's slug rather than a list of IDs, and
41
+ * `media` is `any`, `none`, or a list of kinds. The theme's
42
+ * `smart-collection-members` partial evaluates it; an import recreates the
43
+ * smart collection from it.
44
+ */
45
+ export interface HugoSmartCollectionSelection {
46
+ collection?: string;
47
+ format?: string;
48
+ title?: boolean;
49
+ year?: number;
50
+ media?: "any" | "none" | string[];
51
+ replies?: boolean;
52
+ visibility?: string;
53
+ }
54
+
37
55
  /**
38
56
  * Jant media attachment descriptor. Stored flat inside the `media:` front-
39
57
  * matter array. `src` is either:
@@ -90,6 +108,12 @@ export interface HugoFrontMatter {
90
108
  id?: string;
91
109
  title?: string;
92
110
  date?: string;
111
+ /**
112
+ * When the post was created, written only when it differs from `date` (a
113
+ * published post dated before or after it was written). Restored on import
114
+ * so thread order and "last edited" survive a move.
115
+ */
116
+ created?: string;
93
117
  updated?: string;
94
118
  slug?: string;
95
119
  type?: string;
@@ -97,7 +121,20 @@ export interface HugoFrontMatter {
97
121
 
98
122
  // Hugo routing
99
123
  aliases?: string[];
124
+ /**
125
+ * Published root bundles only: the `<id>` Jant's feeds gave the Thread's
126
+ * entry — its permalink, absolute, with no trailing slash. The theme's feed
127
+ * writes it as the entry's `<id>` so readers don't show the post again after
128
+ * a move. Written by the export, never read by the import.
129
+ */
130
+ feed_id?: string;
100
131
  build?: HugoBuildOptions;
132
+ /**
133
+ * Reply bundles only: 1-based position in the Thread. Jant orders a Thread
134
+ * by creation time, then ID; replies written in the same second tie on
135
+ * `date`, so the theme and the importer order by this instead.
136
+ */
137
+ weight?: number;
101
138
 
102
139
  // Jant post payload (flat — no `extra` nesting)
103
140
  format?: string;
@@ -143,6 +180,14 @@ export interface HugoFrontMatter {
143
180
  collections?: HugoCollectionRef[];
144
181
  media?: JantMedia[];
145
182
 
183
+ // Smart collection section pages
184
+ selection?: HugoSmartCollectionSelection;
185
+ /**
186
+ * `list` or `grid`; absent when the smart collection follows the site's
187
+ * archive layout. Not `layout`, which Hugo reads as a template name.
188
+ */
189
+ display_layout?: string;
190
+
146
191
  // Escape hatch for page-specific export metadata.
147
192
  [key: string]: unknown;
148
193
  }
@@ -213,6 +258,7 @@ const FRONT_MATTER_KEY_ORDER: readonly string[] = [
213
258
  "type",
214
259
  "draft",
215
260
  "aliases",
261
+ "feed_id",
216
262
  "build",
217
263
 
218
264
  // Post payload
package/src/lib/image.ts CHANGED
@@ -34,7 +34,11 @@ export interface ImageOptions {
34
34
  * - Cloudinary
35
35
  * - Any service with similar URL-based transformation API
36
36
  *
37
- * @param originalUrl - The original image URL
37
+ * A root-relative source is written without its leading slash, the form the
38
+ * transformation service resolves against its own host. Kept, it would produce
39
+ * `…/width=200//media/abc123`, which Cloudflare cannot fetch (`err=9404`).
40
+ *
41
+ * @param originalUrl - The original image URL, absolute or root-relative
38
42
  * @param transformUrl - The base URL for transformations (e.g., `https://example.com/cdn-cgi/image`)
39
43
  * @param options - Transformation options (width, height, quality, format, fit)
40
44
  * @returns The transformed URL or original URL if transformations are not configured
@@ -45,9 +49,13 @@ export interface ImageOptions {
45
49
  * getImageUrl("/media/abc123", undefined, { width: 200 });
46
50
  * // Returns: "/media/abc123"
47
51
  *
48
- * // With transform URL - returns transformed
52
+ * // With transform URL and a root-relative source
49
53
  * getImageUrl("/media/abc123", "https://example.com/cdn-cgi/image", { width: 200, quality: 80 });
50
- * // Returns: "https://example.com/cdn-cgi/image/width=200,quality=80/https://example.com/media/abc123"
54
+ * // Returns: "https://example.com/cdn-cgi/image/width=200,quality=80/media/abc123"
55
+ *
56
+ * // With transform URL and an absolute source
57
+ * getImageUrl("https://cdn.example.com/media/abc123", "https://example.com/cdn-cgi/image", { width: 200 });
58
+ * // Returns: "https://example.com/cdn-cgi/image/width=200/https://cdn.example.com/media/abc123"
51
59
  * ```
52
60
  */
53
61
  export function getImageUrl(
@@ -70,7 +78,12 @@ export function getImageUrl(
70
78
  return originalUrl;
71
79
  }
72
80
 
73
- return `${transformUrl}/${params.join(",")}/${originalUrl}`;
81
+ const base = transformUrl.replace(/\/+$/, "");
82
+ const source =
83
+ originalUrl.startsWith("/") && !originalUrl.startsWith("//")
84
+ ? originalUrl.slice(1)
85
+ : originalUrl;
86
+ return `${base}/${params.join(",")}/${source}`;
74
87
  }
75
88
 
76
89
  /**