@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.
- package/bin/commands/assets/prepare.js +3 -3
- package/bin/commands/db/export.js +115 -2
- package/bin/commands/deploy.js +11 -3
- package/bin/commands/{search-reindex.js → search/reindex.js} +5 -5
- package/bin/commands/setup.js +136 -0
- package/bin/commands/site/export.js +117 -68
- package/bin/commands/site/import.js +3074 -2
- package/bin/commands/site/pull-media.js +2 -6
- package/bin/commands/site/snapshot/export.js +18 -60
- package/bin/commands/site/snapshot/import.js +24 -23
- package/bin/commands/telegram/register-webhooks.js +48 -23
- package/bin/jant.js +16 -11
- package/bin/lib/command-registry.js +120 -0
- package/bin/lib/d1-query.js +87 -2
- package/bin/lib/hugo-markdown.js +4 -0
- package/bin/lib/migration-artifacts.js +19 -0
- package/bin/lib/renamed-arguments.js +56 -0
- package/bin/lib/site-pull-media.js +21 -28
- package/bin/lib/site-selection.js +10 -1
- package/bin/lib/site-snapshot.js +421 -4
- package/bin/lib/sql-export.js +68 -5
- package/bin/lib/wrangler-cli.js +9 -0
- package/bin/lib/zip-archive.js +187 -0
- package/dist/{app-K_Aa1MMn.js → app-CFsmRVJN.js} +8629 -697
- package/dist/client/.vite/manifest.json +20 -20
- package/dist/client/_assets/chunks/{create-editor-CD3FhrOB.js → create-editor-B-m7X7S5.js} +50 -46
- package/dist/client/_assets/chunks/{sortable-list-CgaL2jCs.js → sortable-list-BJyd-LXE.js} +1 -1
- package/dist/client/_assets/chunks/{unsafe-svg-0QCkP0vZ.js → unsafe-svg-BkscJx69.js} +2 -2
- package/dist/client/_assets/{client-GiYENVw8.css → client-BCumu1-D.css} +1 -1
- package/dist/client/_assets/{client-VnFxJN7G.js → client-DTLBOHqD.js} +1 -1
- package/dist/client/_assets/{client-auth-k8gJ6QJj.js → client-auth-D6Ix6SmE.js} +1 -1
- package/dist/client/_assets/{client-compose-B_kDtWkW.js → client-compose-D6rExKVK.js} +1 -1
- package/dist/client/_assets/{client-manage-M90aSTOk.js → client-manage-sVOkqVbH.js} +1 -1
- package/dist/client/_assets/{client-settings-DfYs9n1F.js → client-settings-CGR_nZ78.js} +7 -7
- package/dist/index.js +2 -3
- package/dist/node.js +8 -5
- package/dist/url-CKlGzvdN.js +428 -0
- package/package.json +13 -7
- package/src/__tests__/cli-commands.test.ts +144 -0
- package/src/__tests__/config-docs.test.ts +148 -0
- package/src/__tests__/dev-scripts.test.ts +203 -0
- package/src/__tests__/export-collection-order.test.ts +276 -0
- package/src/__tests__/export-feed-ids.test.ts +184 -0
- package/src/__tests__/export-feed-order.test.ts +294 -0
- package/src/__tests__/export-hugo-build.test.ts +130 -0
- package/src/__tests__/export-import-roundtrip.test.ts +95 -1
- package/src/__tests__/export-service.test.ts +611 -28
- package/src/__tests__/export-smart-collection.test.ts +329 -0
- package/src/__tests__/feed-docs.test.ts +36 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/README.md +89 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/0x4nv/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/_index.md +41 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/faqyt/index.md +28 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/_index.md +4 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +32 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/archive/_index.md +7 -0
- 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
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/bought-too-many-lemons-again/_index.md +34 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/city-walks/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/collections/_index.md +4 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/current-tea-rotation/_index.md +31 -0
- 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
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/desk-but-better/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/e0kcg/_index.md +19 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/featured/_index.md +7 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-basho/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-epictetus/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-marcus-aurelius/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-seneca/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-thoreau/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/2cl6d/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/3zqv7/index.md +28 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/5oxsv/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/_index.md +36 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/home-cooking/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/_index.md +29 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/a83qu/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +19 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/_index.md +29 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/c91j0/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/qyucy/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/wsgck/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +43 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/reading-notes/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/_index.md +41 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/cxiu6/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/t77ms/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/telk3/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/telk3/from-thoreau-pawt2/index.md +17 -0
- 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
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +29 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/tiny-projects/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/useful-links/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/weekend-notes/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +49 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/data/jant.toml +119 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/hugo.toml +43 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/021801c20ab3-med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/0f868ce9ac84-med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/50c2ad911bad-med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/7a91f0960491-med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/8714116d3c8e-med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/8a0b4277443f-med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/a7d1c8a1afd9-med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/e25570b405f5-med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/e89ea4eabf01-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/custom.css +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/favicon.ico +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/snapshot/db.sql +218 -0
- package/src/__tests__/fixtures/releases/0.7.0/snapshot/meta.json +9 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/README.md +89 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/0x4nv/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/_index.md +41 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/faqyt/index.md +28 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/_index.md +4 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +32 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/archive/_index.md +7 -0
- 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
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/bought-too-many-lemons-again/_index.md +34 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/city-walks/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/collections/_index.md +4 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/current-tea-rotation/_index.md +31 -0
- 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
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/desk-but-better/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/e0kcg/_index.md +19 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/featured/_index.md +7 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-basho/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-epictetus/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-marcus-aurelius/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-seneca/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-thoreau/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/2cl6d/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/3zqv7/index.md +28 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/5oxsv/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/_index.md +36 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/home-cooking/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/_index.md +29 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/a83qu/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/from-seneca-5hibo/index.md +19 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/mynoise-for-rainy-afternoons/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/nts-archives-are-good-cleaning-music/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/_index.md +29 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/c91j0/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/qyucy/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/wsgck/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +43 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/reading-notes/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/_index.md +41 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/cxiu6/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/t77ms/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/the-soup-trick-i-always-forget/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/telk3/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/telk3/from-thoreau-pawt2/index.md +17 -0
- 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
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +29 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/tiny-projects/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/useful-links/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/weekend-notes/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/what-i-actually-use-my-notebook-for/_index.md +49 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/data/jant.toml +119 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/hugo.toml +43 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/021801c20ab3-med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/0f868ce9ac84-med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/50c2ad911bad-med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/7a91f0960491-med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/8714116d3c8e-med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/8a0b4277443f-med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/a7d1c8a1afd9-med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/e25570b405f5-med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/e89ea4eabf01-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/apple-touch-icon.png +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/custom.css +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/favicon.ico +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/snapshot/db.sql +322 -0
- package/src/__tests__/fixtures/releases/0.7.1/snapshot/meta.json +9 -0
- package/src/__tests__/helpers/hugo-site.ts +146 -0
- package/src/__tests__/helpers/site-export-import.ts +97 -0
- package/src/__tests__/import-site-command.test.ts +514 -2
- package/src/__tests__/mise-config.test.ts +75 -4
- package/src/__tests__/node-dev-tasks.test.ts +264 -0
- package/src/__tests__/release-fixtures.test.ts +132 -0
- package/src/__tests__/site-export-canonical-import.test.ts +113 -0
- package/src/__tests__/snapshot-canonical-replay.test.ts +179 -0
- package/src/__tests__/snapshot-settings.test.ts +97 -0
- package/src/__tests__/snapshot-tables.test.ts +219 -0
- package/src/__tests__/sql-export.test.ts +173 -0
- package/src/__tests__/theme-docs.test.ts +109 -0
- package/src/__tests__/zip-archive.test.ts +106 -0
- package/src/app.tsx +16 -11
- package/src/client/components/__tests__/jant-settings-avatar.test.ts +1 -1
- package/src/client/components/__tests__/jant-settings-general.test.ts +21 -1
- package/src/client/components/jant-repo-picker-types.ts +6 -1
- package/src/client/components/jant-repo-picker.ts +4 -7
- package/src/client/components/jant-settings-general.ts +17 -12
- package/src/client/tiptap/__tests__/list-editing.test.ts +224 -86
- package/src/client/tiptap/__tests__/mark-exit.test.ts +1 -2
- package/src/client/tiptap/__tests__/markdown-clipboard.test.ts +26 -0
- package/src/client/tiptap/extensions.ts +0 -3
- package/src/client/tiptap/structural-keymap.ts +158 -47
- package/src/db/__tests__/d1-query.test.ts +56 -1
- package/src/db/rehearsal-fixtures/pg-demo-current.json +55 -0
- package/src/db/rehearsal-fixtures/pg-demo-current.sql +431 -0
- package/src/i18n/locales/public/en.po +0 -2
- package/src/i18n/locales/public/zh-Hans.po +0 -2
- package/src/i18n/locales/public/zh-Hant.po +0 -2
- package/src/i18n/locales/settings/en.po +8 -8
- package/src/i18n/locales/settings/en.ts +1 -1
- package/src/i18n/locales/settings/zh-Hans.po +8 -8
- package/src/i18n/locales/settings/zh-Hans.ts +1 -1
- package/src/i18n/locales/settings/zh-Hant.po +8 -8
- package/src/i18n/locales/settings/zh-Hant.ts +1 -1
- package/src/index.ts +6 -77
- package/src/lib/__tests__/github-sync-repo-name.test.ts +40 -0
- package/src/lib/__tests__/image.test.ts +27 -1
- package/src/lib/__tests__/markdown-to-tiptap.test.ts +105 -0
- package/src/lib/__tests__/markdown.test.ts +10 -0
- package/src/lib/__tests__/resolve-config.test.ts +67 -0
- package/src/lib/__tests__/schemas.test.ts +27 -1
- package/src/lib/__tests__/timeline.test.ts +87 -0
- package/src/lib/__tests__/tiptap-to-markdown.test.ts +172 -4
- package/src/lib/__tests__/view.test.ts +0 -46
- package/src/lib/discover.ts +3 -1
- package/src/lib/feed.ts +0 -6
- package/src/lib/github-sync-repo-name.ts +45 -0
- package/src/lib/hugo-markdown.ts +46 -0
- package/src/lib/image.ts +17 -4
- package/src/lib/markdown-manager.ts +392 -2
- package/src/lib/post-body-html.ts +11 -4
- package/src/lib/resolve-config.ts +58 -1
- package/src/lib/schemas.ts +50 -5
- package/src/lib/thread-fold.ts +3 -3
- package/src/lib/timeline.ts +1 -1
- package/src/lib/tiptap-to-markdown.ts +13 -7
- package/src/lib/url.ts +20 -0
- package/src/lib/view.ts +2 -29
- package/src/node/__tests__/cli-export.test.ts +2 -2
- package/src/node/__tests__/cli-setup.test.ts +163 -0
- package/src/node/__tests__/cli-site-snapshot.test.ts +73 -0
- package/src/node/__tests__/cli-site-token-env.test.ts +4 -1
- package/src/node/__tests__/cli-snapshot-meta.test.ts +84 -0
- package/src/node/__tests__/runtime.test.ts +38 -0
- package/src/node/index.ts +2 -0
- package/src/node/request-handler.ts +3 -1
- package/src/routes/api/__tests__/posts.test.ts +24 -0
- package/src/routes/api/__tests__/upload.test.ts +34 -0
- package/src/routes/api/export.ts +3 -3
- package/src/routes/api/internal/search-reindex.ts +1 -1
- package/src/routes/api/internal/sites.ts +0 -1
- package/src/routes/api/posts.ts +2 -0
- package/src/routes/api/public/posts.ts +21 -1
- package/src/routes/api/upload.ts +10 -3
- package/src/routes/compose.tsx +4 -0
- package/src/routes/dash/__tests__/github-sync-app.test.ts +365 -0
- package/src/routes/dash/settings.tsx +212 -70
- package/src/routes/pages/__tests__/post-page-round-trips.test.ts +211 -0
- package/src/routes/pages/__tests__/thread-order.test.ts +179 -0
- package/src/routes/pages/archive.tsx +17 -11
- package/src/routes/pages/featured.tsx +11 -5
- package/src/routes/pages/page.tsx +53 -31
- package/src/routes/pages/search.tsx +4 -2
- package/src/runtime/__tests__/readiness.test.ts +23 -0
- package/src/runtime/node.ts +49 -0
- package/src/runtime/readiness.ts +15 -0
- package/src/services/__tests__/bootstrap-setup-instance.test.ts +230 -0
- package/src/services/__tests__/custom-url.test.ts +34 -0
- package/src/services/__tests__/github-app-installations.test.ts +153 -0
- package/src/services/__tests__/github-sync-push.test.ts +46 -0
- package/src/services/__tests__/media.test.ts +31 -271
- package/src/services/__tests__/path.test.ts +56 -0
- package/src/services/__tests__/post-timeline.test.ts +127 -0
- package/src/services/__tests__/post.test.ts +74 -0
- package/src/services/bootstrap.ts +263 -44
- package/src/services/custom-url.ts +2 -2
- package/src/services/export-theme/layouts/_default/alias.html +27 -1
- package/src/services/export-theme/layouts/_default/list.html +2 -63
- package/src/services/export-theme/layouts/_default/rss.xml +27 -38
- package/src/services/export-theme/layouts/collections/list.html +3 -3
- package/src/services/export-theme/layouts/featured/list.html +1 -4
- package/src/services/export-theme/layouts/index.html +40 -26
- package/src/services/export-theme/layouts/partials/collection-members.html +100 -0
- package/src/services/export-theme/layouts/partials/collection-threads.html +33 -0
- package/src/services/export-theme/layouts/partials/featured-members.html +35 -0
- package/src/services/export-theme/layouts/partials/featured-thread.html +1 -1
- package/src/services/export-theme/layouts/partials/footer.html +1 -1
- package/src/services/export-theme/layouts/partials/head.html +1 -1
- package/src/services/export-theme/layouts/partials/header.html +5 -3
- package/src/services/export-theme/layouts/partials/jant-data.html +23 -0
- package/src/services/export-theme/layouts/partials/latest-members.html +48 -0
- package/src/services/export-theme/layouts/partials/smart-collection-members.html +129 -0
- package/src/services/export-theme/layouts/partials/thread-preview.html +1 -1
- package/src/services/export-theme/layouts/post/list.html +1 -1
- package/src/services/export-theme/layouts/smart_collection/list.html +24 -0
- package/src/services/export-theme/styles/main.css +0 -1
- package/src/services/export-theme/theme.toml +1 -1
- package/src/services/export.ts +630 -73
- package/src/services/github-app-installations.ts +171 -4
- package/src/services/github-sync.ts +69 -15
- package/src/services/mcp.ts +19 -1
- package/src/services/media.ts +9 -220
- package/src/services/path.ts +34 -1
- package/src/services/post.ts +214 -39
- package/src/services/site-admin.ts +3 -7
- package/src/services/site.ts +83 -31
- package/src/styles/ui.css +7 -119
- package/src/types/app-context.ts +16 -0
- package/src/types/bindings.ts +5 -0
- package/src/types/operations.ts +10 -0
- package/src/ui/dash/settings/GeneralContent.tsx +10 -8
- package/bin/commands/export.js +0 -118
- package/bin/commands/import-site.js +0 -2561
- package/bin/commands/migrate-text-attachments.js +0 -181
- package/dist/github-sync-BPAvT999.js +0 -7709
- package/src/client/multipart-upload.ts +0 -206
- package/src/client/tiptap/exitable-marks.ts +0 -73
- package/src/routes/api/__tests__/upload-multipart.test.ts +0 -739
- package/src/routes/api/internal/text-attachments.ts +0 -60
- package/src/routes/api/upload-multipart.ts +0 -366
|
@@ -0,0 +1,329 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A smart collection on an exported site lists what it lists on Jant.
|
|
3
|
+
*
|
|
4
|
+
* The export carries a smart collection's conditions, not its matches, and
|
|
5
|
+
* the theme's `smart-collection-members` partial evaluates them against the
|
|
6
|
+
* posts' front matter. That is a second implementation of every condition and
|
|
7
|
+
* every order, in Go templates, so this builds the export with the real Hugo
|
|
8
|
+
* binary and compares each page with the list Jant's own services produce
|
|
9
|
+
* from the same database.
|
|
10
|
+
*
|
|
11
|
+
* Skips when `hugo` is not on PATH, like the other Hugo build tests.
|
|
12
|
+
*/
|
|
13
|
+
|
|
14
|
+
import { rm } from "node:fs/promises";
|
|
15
|
+
import { afterAll, beforeAll, describe, expect, it } from "vitest";
|
|
16
|
+
import { createTestDatabase, DEFAULT_TEST_SITE_ID } from "./helpers/db.js";
|
|
17
|
+
import { makeSiteConfig } from "./helpers/export-fixtures.js";
|
|
18
|
+
import {
|
|
19
|
+
buildHugoSite,
|
|
20
|
+
hugoAvailable,
|
|
21
|
+
readFeedSlugs,
|
|
22
|
+
readThreadSlugs,
|
|
23
|
+
} from "./helpers/hugo-site.js";
|
|
24
|
+
import { createCollectionService } from "../services/collection.js";
|
|
25
|
+
import { createExportService } from "../services/export.js";
|
|
26
|
+
import { createMediaService } from "../services/media.js";
|
|
27
|
+
import { createPathService } from "../services/path.js";
|
|
28
|
+
import { createPostService } from "../services/post.js";
|
|
29
|
+
import { createSmartCollectionService } from "../services/smart-collection.js";
|
|
30
|
+
import { supportsCollectionRatingSort } from "../lib/collection-sort.js";
|
|
31
|
+
import type { Database } from "../db/index.js";
|
|
32
|
+
import type { CreatePost } from "../types/operations.js";
|
|
33
|
+
import type { MediaKind, SmartCollection } from "../types.js";
|
|
34
|
+
|
|
35
|
+
const SITE_URL = "https://example.com";
|
|
36
|
+
|
|
37
|
+
const at = (iso: string) => Math.floor(Date.parse(iso) / 1000);
|
|
38
|
+
|
|
39
|
+
/** Every condition value and every order, each on its own smart collection. */
|
|
40
|
+
const SMART_COLLECTIONS: {
|
|
41
|
+
slug: string;
|
|
42
|
+
selection: SmartCollection["selection"] | "ideas";
|
|
43
|
+
sort?: SmartCollection["sort"];
|
|
44
|
+
}[] = [
|
|
45
|
+
{ slug: "sc-all-newest", selection: {} },
|
|
46
|
+
{ slug: "sc-all-oldest", selection: {}, sort: "oldest" },
|
|
47
|
+
{ slug: "sc-all-rated", selection: {}, sort: "rating_desc" },
|
|
48
|
+
{ slug: "sc-notes", selection: { format: "note" } },
|
|
49
|
+
// One rated link of two: too few to rank, so the page falls back to newest.
|
|
50
|
+
{ slug: "sc-links", selection: { format: "link" }, sort: "rating_desc" },
|
|
51
|
+
{ slug: "sc-quotes", selection: { format: "quote" } },
|
|
52
|
+
{ slug: "sc-titled", selection: { title: true } },
|
|
53
|
+
{ slug: "sc-untitled", selection: { title: false } },
|
|
54
|
+
{ slug: "sc-2024", selection: { year: 2024 } },
|
|
55
|
+
{ slug: "sc-2025", selection: { year: 2025 } },
|
|
56
|
+
{ slug: "sc-media", selection: { media: "any" } },
|
|
57
|
+
{ slug: "sc-no-media", selection: { media: "none" } },
|
|
58
|
+
{ slug: "sc-images", selection: { media: ["image"] } },
|
|
59
|
+
{ slug: "sc-text-or-video", selection: { media: ["text", "video"] } },
|
|
60
|
+
{ slug: "sc-replies", selection: { replies: true } },
|
|
61
|
+
{ slug: "sc-no-replies", selection: { replies: false } },
|
|
62
|
+
{ slug: "sc-public", selection: { visibility: "public" } },
|
|
63
|
+
{ slug: "sc-hidden", selection: { visibility: "latest_hidden" } },
|
|
64
|
+
{ slug: "sc-featured", selection: { visibility: "featured" } },
|
|
65
|
+
{ slug: "sc-ideas", selection: "ideas" },
|
|
66
|
+
{
|
|
67
|
+
slug: "sc-thoughts",
|
|
68
|
+
selection: { format: "note", title: false },
|
|
69
|
+
sort: "oldest",
|
|
70
|
+
},
|
|
71
|
+
];
|
|
72
|
+
|
|
73
|
+
describe.skipIf(!hugoAvailable)("smart collections on an exported site", () => {
|
|
74
|
+
let siteDir: string;
|
|
75
|
+
const expected = new Map<string, string[]>();
|
|
76
|
+
const built = new Map<string, string[]>();
|
|
77
|
+
const expectedFeed = new Map<string, string[]>();
|
|
78
|
+
const builtFeed = new Map<string, string[]>();
|
|
79
|
+
|
|
80
|
+
beforeAll(async () => {
|
|
81
|
+
const { db: testDb } = createTestDatabase();
|
|
82
|
+
const db = testDb as unknown as Database;
|
|
83
|
+
const siteId = DEFAULT_TEST_SITE_ID;
|
|
84
|
+
const paths = createPathService(db, siteId);
|
|
85
|
+
const posts = createPostService(db, { slugIdLength: 5 }, siteId);
|
|
86
|
+
const smartCollections = createSmartCollectionService(
|
|
87
|
+
db,
|
|
88
|
+
siteId,
|
|
89
|
+
paths,
|
|
90
|
+
posts,
|
|
91
|
+
);
|
|
92
|
+
const collections = createCollectionService(
|
|
93
|
+
db,
|
|
94
|
+
siteId,
|
|
95
|
+
paths,
|
|
96
|
+
undefined,
|
|
97
|
+
undefined,
|
|
98
|
+
smartCollections,
|
|
99
|
+
);
|
|
100
|
+
const media = createMediaService(db, siteId);
|
|
101
|
+
|
|
102
|
+
const ideas = await collections.create({ slug: "ideas", title: "Ideas" });
|
|
103
|
+
|
|
104
|
+
async function post(
|
|
105
|
+
slug: string,
|
|
106
|
+
data: Omit<CreatePost, "slug" | "bodyMarkdown">,
|
|
107
|
+
attachments: MediaKind[] = [],
|
|
108
|
+
) {
|
|
109
|
+
const created = await posts.create({
|
|
110
|
+
slug,
|
|
111
|
+
bodyMarkdown: `Body of ${slug}.`,
|
|
112
|
+
status: "published",
|
|
113
|
+
...data,
|
|
114
|
+
createdAt: data.createdAt ?? data.publishedAt,
|
|
115
|
+
});
|
|
116
|
+
for (const [index, kind] of attachments.entries()) {
|
|
117
|
+
await media.create({
|
|
118
|
+
postId: created.id,
|
|
119
|
+
filename: `${slug}-${index}.bin`,
|
|
120
|
+
originalName: `${slug}-${index}.bin`,
|
|
121
|
+
mimeType: "application/octet-stream",
|
|
122
|
+
size: 1,
|
|
123
|
+
storageKey: `media/${slug}-${index}.bin`,
|
|
124
|
+
mediaKind: kind,
|
|
125
|
+
});
|
|
126
|
+
}
|
|
127
|
+
return created;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
await post("a-2024-note", {
|
|
131
|
+
format: "note",
|
|
132
|
+
publishedAt: at("2024-03-01T00:00:00Z"),
|
|
133
|
+
rating: 5,
|
|
134
|
+
});
|
|
135
|
+
const titled = await post(
|
|
136
|
+
"b-titled-note",
|
|
137
|
+
{
|
|
138
|
+
format: "note",
|
|
139
|
+
title: "Titled note",
|
|
140
|
+
publishedAt: at("2025-01-10T00:00:00Z"),
|
|
141
|
+
collectionIds: [ideas.id],
|
|
142
|
+
},
|
|
143
|
+
["image"],
|
|
144
|
+
);
|
|
145
|
+
await post("b-reply", {
|
|
146
|
+
format: "note",
|
|
147
|
+
replyToId: titled.id,
|
|
148
|
+
publishedAt: at("2025-06-01T00:00:00Z"),
|
|
149
|
+
});
|
|
150
|
+
await post(
|
|
151
|
+
"c-hidden-link",
|
|
152
|
+
{
|
|
153
|
+
format: "link",
|
|
154
|
+
title: "A link",
|
|
155
|
+
url: "https://example.org/",
|
|
156
|
+
visibility: "latest_hidden",
|
|
157
|
+
publishedAt: at("2025-02-01T00:00:00Z"),
|
|
158
|
+
rating: 3,
|
|
159
|
+
},
|
|
160
|
+
["video"],
|
|
161
|
+
);
|
|
162
|
+
await post("k-newer-link", {
|
|
163
|
+
format: "link",
|
|
164
|
+
title: "Another link",
|
|
165
|
+
url: "https://example.net/",
|
|
166
|
+
publishedAt: at("2025-05-01T00:00:00Z"),
|
|
167
|
+
});
|
|
168
|
+
await post("d-featured-quote", {
|
|
169
|
+
format: "quote",
|
|
170
|
+
title: "Seneca",
|
|
171
|
+
quoteText: "We suffer more in imagination than in reality.",
|
|
172
|
+
publishedAt: at("2023-05-05T00:00:00Z"),
|
|
173
|
+
featuredAt: at("2023-06-01T00:00:00Z"),
|
|
174
|
+
});
|
|
175
|
+
await post(
|
|
176
|
+
"e-untitled-quote",
|
|
177
|
+
{
|
|
178
|
+
format: "quote",
|
|
179
|
+
quoteText: "Unattributed.",
|
|
180
|
+
publishedAt: at("2025-03-01T00:00:00Z"),
|
|
181
|
+
collectionIds: [ideas.id],
|
|
182
|
+
},
|
|
183
|
+
["text"],
|
|
184
|
+
);
|
|
185
|
+
await post("f-private", {
|
|
186
|
+
format: "note",
|
|
187
|
+
visibility: "private",
|
|
188
|
+
publishedAt: at("2025-01-01T00:00:00Z"),
|
|
189
|
+
});
|
|
190
|
+
await post("g-draft", { format: "note", status: "draft" });
|
|
191
|
+
// Two roots published in the same second: the ID decides.
|
|
192
|
+
const tied = await post("h-tied", {
|
|
193
|
+
format: "note",
|
|
194
|
+
publishedAt: at("2025-04-01T12:00:00Z"),
|
|
195
|
+
rating: 4,
|
|
196
|
+
});
|
|
197
|
+
await post("h-draft-reply", {
|
|
198
|
+
format: "note",
|
|
199
|
+
replyToId: tied.id,
|
|
200
|
+
status: "draft",
|
|
201
|
+
});
|
|
202
|
+
await post("i-tied", {
|
|
203
|
+
format: "note",
|
|
204
|
+
publishedAt: at("2025-04-01T12:00:00Z"),
|
|
205
|
+
});
|
|
206
|
+
// The last second of 2024 in UTC, whatever the build machine's zone.
|
|
207
|
+
await post(
|
|
208
|
+
"j-new-years-eve",
|
|
209
|
+
{ format: "note", publishedAt: at("2024-12-31T23:59:59Z") },
|
|
210
|
+
["audio"],
|
|
211
|
+
);
|
|
212
|
+
|
|
213
|
+
const anonymous = { isAuthenticated: false };
|
|
214
|
+
for (const definition of SMART_COLLECTIONS) {
|
|
215
|
+
const smartCollection = await smartCollections.create({
|
|
216
|
+
slug: definition.slug,
|
|
217
|
+
title: definition.slug,
|
|
218
|
+
selection:
|
|
219
|
+
definition.selection === "ideas"
|
|
220
|
+
? { collection: [ideas.id] }
|
|
221
|
+
: definition.selection,
|
|
222
|
+
sort: definition.sort,
|
|
223
|
+
});
|
|
224
|
+
// What the page shows: the stored order, unless it ranks by rating
|
|
225
|
+
// and too little is rated for that to mean anything.
|
|
226
|
+
const rated = await posts.countUpTo(
|
|
227
|
+
{
|
|
228
|
+
...smartCollections.toPostFilters(smartCollection, anonymous),
|
|
229
|
+
hasRating: true,
|
|
230
|
+
},
|
|
231
|
+
2,
|
|
232
|
+
);
|
|
233
|
+
const sort =
|
|
234
|
+
smartCollection.sort === "rating_desc" &&
|
|
235
|
+
!supportsCollectionRatingSort(rated)
|
|
236
|
+
? "newest"
|
|
237
|
+
: smartCollection.sort;
|
|
238
|
+
const list = await posts.list({
|
|
239
|
+
...smartCollections.toPostFilters(
|
|
240
|
+
{ ...smartCollection, sort },
|
|
241
|
+
anonymous,
|
|
242
|
+
),
|
|
243
|
+
limit: 1000,
|
|
244
|
+
});
|
|
245
|
+
expected.set(
|
|
246
|
+
definition.slug,
|
|
247
|
+
list.map((item) => item.slug),
|
|
248
|
+
);
|
|
249
|
+
// The feed keeps the stored order, fallback or not.
|
|
250
|
+
const feedList = await posts.list({
|
|
251
|
+
...smartCollections.toPostFilters(smartCollection, anonymous),
|
|
252
|
+
limit: 50,
|
|
253
|
+
});
|
|
254
|
+
expectedFeed.set(
|
|
255
|
+
definition.slug,
|
|
256
|
+
feedList.map((item) => item.slug),
|
|
257
|
+
);
|
|
258
|
+
}
|
|
259
|
+
|
|
260
|
+
// A small page size, so the pages are read across pagination.
|
|
261
|
+
siteDir = await buildHugoSite(
|
|
262
|
+
await createExportService(
|
|
263
|
+
{ posts, paths, collections, media },
|
|
264
|
+
makeSiteConfig({ siteUrl: SITE_URL, pageSize: 4 }),
|
|
265
|
+
{ storage: null, bundleMedia: false },
|
|
266
|
+
).generateHugoFiles(),
|
|
267
|
+
);
|
|
268
|
+
for (const { slug } of SMART_COLLECTIONS) {
|
|
269
|
+
built.set(slug, await readThreadSlugs(siteDir, slug));
|
|
270
|
+
builtFeed.set(slug, await readFeedSlugs(siteDir, slug, SITE_URL));
|
|
271
|
+
}
|
|
272
|
+
}, 60_000);
|
|
273
|
+
|
|
274
|
+
afterAll(async () => {
|
|
275
|
+
if (siteDir) await rm(siteDir, { recursive: true, force: true });
|
|
276
|
+
});
|
|
277
|
+
|
|
278
|
+
it.each(SMART_COLLECTIONS.map(({ slug }) => slug))(
|
|
279
|
+
"%s lists the posts Jant lists, in its order",
|
|
280
|
+
(slug) => {
|
|
281
|
+
expect(built.get(slug)).toEqual(expected.get(slug));
|
|
282
|
+
},
|
|
283
|
+
);
|
|
284
|
+
|
|
285
|
+
// Equal lists prove nothing if the fixture leaves them empty or alike.
|
|
286
|
+
it("runs on a fixture that tells the conditions apart", () => {
|
|
287
|
+
expect(expected.get("sc-thoughts")).toEqual([
|
|
288
|
+
"a-2024-note",
|
|
289
|
+
"j-new-years-eve",
|
|
290
|
+
"h-tied",
|
|
291
|
+
"i-tied",
|
|
292
|
+
]);
|
|
293
|
+
expect(expected.get("sc-all-rated")?.slice(0, 3)).toEqual([
|
|
294
|
+
"a-2024-note",
|
|
295
|
+
"h-tied",
|
|
296
|
+
"c-hidden-link",
|
|
297
|
+
]);
|
|
298
|
+
expect(expected.get("sc-links")).toEqual(["k-newer-link", "c-hidden-link"]);
|
|
299
|
+
// The page falls back to newest with one rated link; the feed doesn't.
|
|
300
|
+
expect(expectedFeed.get("sc-links")).toEqual([
|
|
301
|
+
"c-hidden-link",
|
|
302
|
+
"k-newer-link",
|
|
303
|
+
]);
|
|
304
|
+
expect(expected.get("sc-titled")).toEqual([
|
|
305
|
+
"b-titled-note",
|
|
306
|
+
"k-newer-link",
|
|
307
|
+
"c-hidden-link",
|
|
308
|
+
"d-featured-quote",
|
|
309
|
+
]);
|
|
310
|
+
expect(expected.get("sc-2024")).toEqual(["j-new-years-eve", "a-2024-note"]);
|
|
311
|
+
expect(expected.get("sc-replies")).toEqual(["b-titled-note"]);
|
|
312
|
+
expect(expected.get("sc-text-or-video")).toEqual([
|
|
313
|
+
"e-untitled-quote",
|
|
314
|
+
"c-hidden-link",
|
|
315
|
+
]);
|
|
316
|
+
expect(expected.get("sc-all-newest")).not.toContain("f-private");
|
|
317
|
+
expect(expected.get("sc-all-newest")).not.toContain("g-draft");
|
|
318
|
+
for (const { slug } of SMART_COLLECTIONS) {
|
|
319
|
+
expect(expected.get(slug)?.length, slug).toBeGreaterThan(0);
|
|
320
|
+
}
|
|
321
|
+
});
|
|
322
|
+
|
|
323
|
+
it.each(SMART_COLLECTIONS.map(({ slug }) => slug))(
|
|
324
|
+
"%s feed carries what Jant's feed carries, in its order",
|
|
325
|
+
(slug) => {
|
|
326
|
+
expect(builtFeed.get(slug)).toEqual(expectedFeed.get(slug));
|
|
327
|
+
},
|
|
328
|
+
);
|
|
329
|
+
});
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Every name Jant writes in its feed namespace is documented for consumers.
|
|
3
|
+
*
|
|
4
|
+
* `docs/feed-reading.md` is the public contract for the `https://jant.me/ns`
|
|
5
|
+
* elements and attributes; `docs/feeds.md` covers `jant:discover`. Before the
|
|
6
|
+
* handout was published, `jant:post`, `jant:thread`, `jant:truncated`, and
|
|
7
|
+
* `jant:page` were described only in an internal document. A new name the
|
|
8
|
+
* renderer starts writing fails this until the docs describe it.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
import { readFileSync } from "node:fs";
|
|
12
|
+
import { join, resolve } from "node:path";
|
|
13
|
+
import { describe, expect, it } from "vitest";
|
|
14
|
+
|
|
15
|
+
const CORE_DIR = resolve(import.meta.dirname, "../..");
|
|
16
|
+
const REPO_ROOT = resolve(CORE_DIR, "../..");
|
|
17
|
+
const RENDERERS = ["src/lib/feed.ts", "src/lib/discover.ts"];
|
|
18
|
+
const FEED_DOCS = ["docs/feed-reading.md", "docs/feeds.md"];
|
|
19
|
+
|
|
20
|
+
describe("feed docs", () => {
|
|
21
|
+
it("document every jant: name the feed renderers write", () => {
|
|
22
|
+
const written = new Set(
|
|
23
|
+
RENDERERS.flatMap((path) => [
|
|
24
|
+
...readFileSync(join(CORE_DIR, path), "utf8").matchAll(
|
|
25
|
+
/jant:([a-z]+)/g,
|
|
26
|
+
),
|
|
27
|
+
]).flatMap((match) => (match[1] ? [`jant:${match[1]}`] : [])),
|
|
28
|
+
);
|
|
29
|
+
const docs = FEED_DOCS.map((path) =>
|
|
30
|
+
readFileSync(join(REPO_ROOT, path), "utf8"),
|
|
31
|
+
).join("\n");
|
|
32
|
+
|
|
33
|
+
expect(written.size).toBeGreaterThan(0);
|
|
34
|
+
expect([...written].filter((name) => !docs.includes(name))).toEqual([]);
|
|
35
|
+
});
|
|
36
|
+
});
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# Jant — Hugo Export
|
|
2
|
+
|
|
3
|
+
This is a static site exported from [Jant](https://github.com/jant-me/jant), ready to build with [Hugo](https://gohugo.io/).
|
|
4
|
+
|
|
5
|
+
## Install Hugo
|
|
6
|
+
|
|
7
|
+
This export targets Hugo **extended 0.160.1+**.
|
|
8
|
+
|
|
9
|
+
**macOS (Homebrew):**
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
brew install hugo
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
**Windows (Scoop):**
|
|
16
|
+
|
|
17
|
+
```sh
|
|
18
|
+
scoop install hugo-extended
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
**Linux:**
|
|
22
|
+
|
|
23
|
+
Download the extended build from <https://github.com/gohugoio/hugo/releases>.
|
|
24
|
+
|
|
25
|
+
See the [Hugo installation docs](https://gohugo.io/installation/) for more options.
|
|
26
|
+
|
|
27
|
+
## Quick start
|
|
28
|
+
|
|
29
|
+
Preview locally:
|
|
30
|
+
|
|
31
|
+
```sh
|
|
32
|
+
hugo serve
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Then open <http://localhost:1313> in your browser.
|
|
36
|
+
|
|
37
|
+
Build the site for deployment:
|
|
38
|
+
|
|
39
|
+
```sh
|
|
40
|
+
hugo --minify
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
The output goes to the `public/` directory. Upload it to any static host (Netlify, Vercel, Cloudflare Pages, GitHub Pages, etc.).
|
|
44
|
+
|
|
45
|
+
## Project structure
|
|
46
|
+
|
|
47
|
+
```
|
|
48
|
+
hugo.toml — Site configuration (baseURL, title, theme, params)
|
|
49
|
+
content/
|
|
50
|
+
_index.md — Home section
|
|
51
|
+
archive/_index.md — Archive section
|
|
52
|
+
collections/_index.md — Collections directory section
|
|
53
|
+
featured/_index.md — Featured section
|
|
54
|
+
{slug}/
|
|
55
|
+
_index.md — Thread root (branch bundle)
|
|
56
|
+
{reply-slug}/
|
|
57
|
+
index.md — Reply (leaf bundle, not rendered as its own URL)
|
|
58
|
+
data/
|
|
59
|
+
jant.toml — Nav items, branding, display preferences, ordered collections directory
|
|
60
|
+
themes/jant/ — Bundled Hugo theme (overrideable via layouts/ at the site root)
|
|
61
|
+
static/ — Copy files here to add them to the published site
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
## Customizing
|
|
65
|
+
|
|
66
|
+
- **Site settings** — edit `hugo.toml` to change the baseURL, title, or pagination.
|
|
67
|
+
- **Jant metadata** — `data/jant.toml` drives nav and the collections directory, and is preserved across round-trip import.
|
|
68
|
+
- **Styles** — edit `themes/jant/static/main.css`, or drop a `static/main.css` at the site root to override.
|
|
69
|
+
- **Templates** — add files under `layouts/` at the site root to override the bundled theme.
|
|
70
|
+
- **Debugging** — from a Jant site project, run `npx jant site export --directory ./my-site`, then `cd my-site && hugo serve`.
|
|
71
|
+
|
|
72
|
+
## Fetching media locally
|
|
73
|
+
|
|
74
|
+
When the source site has a storage provider configured (R2/S3/local proxy), images and attachments in this export link to the provider URL instead of being bundled. That keeps the repo small but means the files aren't on disk — fine if Hugo can reach the internet, not fine if you want a fully self-contained archive.
|
|
75
|
+
|
|
76
|
+
To download every referenced media file into `static/media/` and rewrite the references to local paths, run this from the root of the export:
|
|
77
|
+
|
|
78
|
+
```sh
|
|
79
|
+
npx @jant/core site pull-media --path .
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
Safe to re-run; files already on disk are reused. Anything that fails to download keeps its original URL so the site still builds.
|
|
83
|
+
|
|
84
|
+
## Notes
|
|
85
|
+
|
|
86
|
+
- Each thread is a Hugo branch bundle. Replies live as nested leaf bundles with `build.render = "never"` so they do not produce standalone URLs; they render inside the thread page.
|
|
87
|
+
- `/{reply-slug}/` URLs are preserved via `aliases:` on the root post, so old links still land on the right thread anchor.
|
|
88
|
+
- Media is emitted under `static/media/{id}.ext` and referenced from a flat `media:` array on each post. When a storage provider has a configured public URL (R2/S3/local proxy), the exporter links to the provider URL instead of re-bundling the bytes.
|
|
89
|
+
- Posts with `draft: true` in front matter are only built when you pass `--buildDrafts` to `hugo` / `hugo serve`.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: "pst_01kn8jtzmzenf98tnj3x0bzmzk"
|
|
3
|
+
date: "2025-09-27T09:00:00.000Z"
|
|
4
|
+
updated: "2026-04-03T02:30:29.000Z"
|
|
5
|
+
slug: "0x4nv"
|
|
6
|
+
type: "post"
|
|
7
|
+
build:
|
|
8
|
+
render: "never"
|
|
9
|
+
list: "local"
|
|
10
|
+
format: "note"
|
|
11
|
+
status: "published"
|
|
12
|
+
visibility: "public"
|
|
13
|
+
summary_text: "I keep forgetting that plants mostly want consistency, not inspiration. Fair enough."
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
I keep forgetting that plants mostly want consistency, not inspiration. Fair enough.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: "pst_01kn8jty2henf98tmnw0xzbhet"
|
|
3
|
+
date: "2025-09-27T08:15:00.000Z"
|
|
4
|
+
updated: "2026-04-03T02:30:27.000Z"
|
|
5
|
+
slug: "41q27"
|
|
6
|
+
type: "post"
|
|
7
|
+
aliases:
|
|
8
|
+
- "/the-potting-mix-guide-i-keep-rereading/"
|
|
9
|
+
- "/0x4nv/"
|
|
10
|
+
- "/faqyt/"
|
|
11
|
+
format: "note"
|
|
12
|
+
status: "published"
|
|
13
|
+
visibility: "public"
|
|
14
|
+
summary_text: "Repotted the balcony herbs before breakfast. Basil was dramatic. Mint did not care at all."
|
|
15
|
+
collections:
|
|
16
|
+
- slug: "tiny-projects"
|
|
17
|
+
title: "Tiny Projects"
|
|
18
|
+
collected_at: "2026-04-03T02:30:27.000Z"
|
|
19
|
+
position: 0
|
|
20
|
+
pinned_at: null
|
|
21
|
+
- slug: "weekend-notes"
|
|
22
|
+
title: "Weekend Notes"
|
|
23
|
+
collected_at: "2026-04-03T02:30:27.000Z"
|
|
24
|
+
position: 1
|
|
25
|
+
pinned_at: null
|
|
26
|
+
media:
|
|
27
|
+
- id: "med_01kn8jtx8qenf98tm9ahxr48sw"
|
|
28
|
+
kind: "image"
|
|
29
|
+
src: "/media/0f868ce9ac84-med_01kn8jtx8qenf98tm9ahxr48sw.webp"
|
|
30
|
+
position: 3055
|
|
31
|
+
width: 1200
|
|
32
|
+
height: 900
|
|
33
|
+
original_name: "herbs-window.webp"
|
|
34
|
+
mime_type: "image/webp"
|
|
35
|
+
size: 13352
|
|
36
|
+
provider: "r2"
|
|
37
|
+
storage_key: "media/sit_01kn8jq3t4famtyg9hjd074ckr/files/med_01kn8jtx8qenf98tm9ahxr48sw.webp"
|
|
38
|
+
last_activity_at: "2025-09-27T16:50:00.000Z"
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
Repotted the balcony herbs before breakfast. Basil was dramatic. Mint did not care at all.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: "pst_01kn8jv1anenf98tp9ngn8jbyj"
|
|
3
|
+
date: "2025-09-27T16:50:00.000Z"
|
|
4
|
+
updated: "2026-04-03T02:30:30.000Z"
|
|
5
|
+
slug: "faqyt"
|
|
6
|
+
type: "post"
|
|
7
|
+
build:
|
|
8
|
+
render: "never"
|
|
9
|
+
list: "local"
|
|
10
|
+
format: "note"
|
|
11
|
+
status: "published"
|
|
12
|
+
visibility: "public"
|
|
13
|
+
summary_text: "By late afternoon the basil was standing up again. I respect a fast recovery."
|
|
14
|
+
media:
|
|
15
|
+
- id: "med_01kn8jv0jdenf98tp6qr9zgjjc"
|
|
16
|
+
kind: "image"
|
|
17
|
+
src: "/media/8a0b4277443f-med_01kn8jv0jdenf98tp6qr9zgjjc.webp"
|
|
18
|
+
position: 3055
|
|
19
|
+
width: 1200
|
|
20
|
+
height: 900
|
|
21
|
+
original_name: "balcony-light.webp"
|
|
22
|
+
mime_type: "image/webp"
|
|
23
|
+
size: 15058
|
|
24
|
+
provider: "r2"
|
|
25
|
+
storage_key: "media/sit_01kn8jq3t4famtyg9hjd074ckr/files/med_01kn8jv0jdenf98tp6qr9zgjjc.webp"
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
By late afternoon the basil was standing up again. I respect a fast recovery.
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: "pst_01kn8jtys8enf98tn2zvcq2hsm"
|
|
3
|
+
title: "The potting mix guide I keep rereading"
|
|
4
|
+
date: "2025-09-27T09:40:00.000Z"
|
|
5
|
+
updated: "2026-04-03T02:30:28.000Z"
|
|
6
|
+
slug: "the-potting-mix-guide-i-keep-rereading"
|
|
7
|
+
type: "post"
|
|
8
|
+
build:
|
|
9
|
+
render: "never"
|
|
10
|
+
list: "local"
|
|
11
|
+
format: "link"
|
|
12
|
+
status: "published"
|
|
13
|
+
visibility: "public"
|
|
14
|
+
summary_text: "Basic, clear, and good for confidence when I start overthinking dirt."
|
|
15
|
+
link_url: "https://www.rhs.org.uk/plants/types/houseplants/repotting"
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
Basic, clear, and good for confidence when I start overthinking dirt.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: "pst_01kn8jv2anenf98tpt6kqt3xg6"
|
|
3
|
+
title: "A night heron field guide for my walk folder"
|
|
4
|
+
date: "2026-03-05T09:10:00.000Z"
|
|
5
|
+
updated: "2026-04-03T02:30:32.000Z"
|
|
6
|
+
slug: "a-night-heron-field-guide-for-my-walk-folder"
|
|
7
|
+
type: "post"
|
|
8
|
+
format: "link"
|
|
9
|
+
status: "published"
|
|
10
|
+
visibility: "public"
|
|
11
|
+
summary_text: "Posting this here so I can find it again the next time I see a suspiciously patient bird near the water."
|
|
12
|
+
link_url: "https://www.audubon.org/field-guide/bird/black-crowned-night-heron"
|
|
13
|
+
rating: 4
|
|
14
|
+
collections:
|
|
15
|
+
- slug: "city-walks"
|
|
16
|
+
title: "City Walks"
|
|
17
|
+
collected_at: "2026-04-03T02:30:32.000Z"
|
|
18
|
+
position: 0
|
|
19
|
+
pinned_at: null
|
|
20
|
+
- slug: "useful-links"
|
|
21
|
+
title: "Useful Links"
|
|
22
|
+
collected_at: "2026-04-03T02:30:32.000Z"
|
|
23
|
+
position: 1
|
|
24
|
+
pinned_at: null
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
Posting this here so I can find it again the next time I see a suspiciously patient bird near the water.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: "pst_01kn8jv2x0enf98tqf9hm0deme"
|
|
3
|
+
title: "A Quiet Saturday After a Busy Week"
|
|
4
|
+
date: "2025-08-03T09:10:00.000Z"
|
|
5
|
+
updated: "2026-04-03T02:30:32.000Z"
|
|
6
|
+
slug: "a-quiet-saturday-after-a-busy-week"
|
|
7
|
+
type: "post"
|
|
8
|
+
format: "note"
|
|
9
|
+
status: "published"
|
|
10
|
+
visibility: "public"
|
|
11
|
+
summary_text: "Last week felt like six weeks compressed into five days. I spent most of it answering things, moving things, and promising myself I would slow down later. Today was the later I had in mind. Breakfast took an hour. I opened the windows even though it was still cold. I put the phone on the bookshelf and left it there long enough to hear the apartment settle down."
|
|
12
|
+
featured_at: "2026-04-03T02:30:32.000Z"
|
|
13
|
+
featured_post_ids:
|
|
14
|
+
- "pst_01kn8jv2x0enf98tqf9hm0deme"
|
|
15
|
+
featured_sort_at: "2025-08-03T09:10:00.000Z"
|
|
16
|
+
collections:
|
|
17
|
+
- slug: "weekend-notes"
|
|
18
|
+
title: "Weekend Notes"
|
|
19
|
+
collected_at: "2026-04-03T02:30:32.000Z"
|
|
20
|
+
position: 0
|
|
21
|
+
pinned_at: null
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
Last week felt like six weeks compressed into five days. I spent most of it answering things, moving things, and promising myself I would slow down later. Today was the later I had in mind.
|
|
25
|
+
|
|
26
|
+
Breakfast took an hour. I opened the windows even though it was still cold. I put the phone on the bookshelf and left it there long enough to hear the apartment settle down.
|
|
27
|
+
|
|
28
|
+
<!--more-->
|
|
29
|
+
|
|
30
|
+
What helped most was not turning the free day into a project. I made coffee, wiped the kitchen counter, read twenty pages, and sat in the chair by the window without trying to optimize anything.
|
|
31
|
+
|
|
32
|
+
A good day does not always need a headline. Sometimes it only needs enough room to happen.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: "pst_01kn8jv3exenf98tqxkzk0sjck"
|
|
3
|
+
title: "Are.na is the only bookmark pile I still revisit"
|
|
4
|
+
date: "2025-10-15T14:15:00.000Z"
|
|
5
|
+
updated: "2026-04-03T02:30:33.000Z"
|
|
6
|
+
slug: "are-na-is-the-only-bookmark-pile-i-still-revisit"
|
|
7
|
+
type: "post"
|
|
8
|
+
format: "link"
|
|
9
|
+
status: "published"
|
|
10
|
+
visibility: "public"
|
|
11
|
+
summary_text: "Most saved links disappear into a hole. This one still feels calm enough to browse on purpose."
|
|
12
|
+
link_url: "https://www.are.na/"
|
|
13
|
+
rating: 4
|
|
14
|
+
collections:
|
|
15
|
+
- slug: "tiny-projects"
|
|
16
|
+
title: "Tiny Projects"
|
|
17
|
+
collected_at: "2026-04-03T02:30:33.000Z"
|
|
18
|
+
position: 0
|
|
19
|
+
pinned_at: null
|
|
20
|
+
- slug: "useful-links"
|
|
21
|
+
title: "Useful Links"
|
|
22
|
+
collected_at: "2026-04-03T02:30:33.000Z"
|
|
23
|
+
position: 1
|
|
24
|
+
pinned_at: null
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
Most saved links disappear into a hole. This one still feels calm enough to browse on purpose.
|