@jant/core 0.3.39 → 1.0.0

package/src/services/export.ts

@@ -1,9 +1,22 @@
 /**
  * Export Service
  *
- * Generates a ready-to-use Zola static site as a ZIP archive.
- * Threads are merged into single pages with reply marker comments.
- * Media URLs point to the original site (not exported).
+ * Generates a ready-to-use Hugo static site as a ZIP archive.
+ *
+ * Content layout:
+ *   - Each thread root is a Hugo branch bundle
+ *     (`content/{root-slug}/_index.md`).
+ *   - Each reply is a nested leaf bundle
+ *     (`content/{root-slug}/{reply-slug}/index.md`) with
+ *     `build: { render: never, list: local }` so only the parent thread
+ *     page renders it while it still appears in `.Pages`.
+ *   - `/{reply-slug}/` URLs redirect to the parent thread via Hugo's
+ *     `aliases:` mechanism and a custom `_default/alias.html` that injects
+ *     the reply anchor at runtime.
+ *   - Media is emitted next to each bundle as Hugo page resources.
+ *
+ * Real Hugo templates and CSS are scaffolded as placeholders here and
+ * filled in by Commit 5.
  */
 
 import type { PostService } from "./post.js";
@@ -11,41 +24,86 @@ import type { PathService } from "./path.js";
 import type { CollectionService } from "./collection.js";
 import type { MediaService } from "./media.js";
 import {
-  buildJantLogoSvgMarkup,
   getDefaultJantAppleTouchIconBytes,
   getDefaultJantFaviconIcoBytes,
-  HOME_BRANDING_LINK_LABEL,
-  HOME_BRANDING_PREFIX,
-  JANT_REPO_URL,
 } from "../lib/jant-branding.js";
 import { tiptapJsonToMarkdown } from "../lib/tiptap-to-markdown.js";
 import { getMediaUrl, getPublicUrlForProvider } from "../lib/image.js";
-import { FEATURED_SPARKLE_PATH } from "../lib/featured-icons.js";
-import { escapeHtml } from "../lib/html.js";
 import { render as renderMarkdown } from "../lib/markdown.js";
-import { toISOString } from "../lib/time.js";
+import { formatRelativeAge, toISOString } from "../lib/time.js";
+import {
+  formatFrontMatter,
+  type HugoCollectionRef,
+  type HugoFrontMatter,
+  type JantMedia,
+} from "../lib/hugo-markdown.js";
+// Shared design tokens — single source of truth for colors, typography,
+// and layout variables. Consumed verbatim by both the main site (via
+// Tailwind) and the Hugo export (written to static/tokens.css). Using
+// ?raw inlines the file contents as a string at build time so the
+// Worker bundle ships without any filesystem access.
+import TOKENS_CSS from "../styles/tokens.css?raw";
+
+// Placeholder Hugo theme files — real templates and styles land in Commit 5.
+// We import them as Vite `?raw` strings so the Worker bundle has no runtime
+// filesystem dependency.
+import THEME_TOML from "./export-theme/theme.toml?raw";
+import THEME_STYLE_MAIN_CSS from "./export-theme/styles/main.css?raw";
+// Static-site client bundle — Lit-based lightbox, feed video autoplay, audio
+// waveform, and gallery scroll hints. Built by `vite.config.site.ts` into
+// `export-theme/assets/client-site.{js,css}` and shipped under the theme's
+// reserved `_jant/` static directory so the theme stays version-aligned with
+// `@jant/core`. The assets folder is regenerated on every build, so the
+// checked-in files are source-of-truth for the most recent release.
+import CLIENT_SITE_JS from "./export-theme/assets/client-site.js?raw";
+import CLIENT_SITE_CSS from "./export-theme/assets/client-site.css?raw";
+import LAYOUT_BASEOF from "./export-theme/layouts/_default/baseof.html?raw";
+import LAYOUT_SINGLE from "./export-theme/layouts/_default/single.html?raw";
+import LAYOUT_LIST from "./export-theme/layouts/_default/list.html?raw";
+import LAYOUT_ALIAS from "./export-theme/layouts/_default/alias.html?raw";
+import LAYOUT_INDEX from "./export-theme/layouts/index.html?raw";
+import LAYOUT_POST_LIST from "./export-theme/layouts/post/list.html?raw";
+import LAYOUT_FEATURED_LIST from "./export-theme/layouts/featured/list.html?raw";
+import LAYOUT_ARCHIVE_LIST from "./export-theme/layouts/archive/list.html?raw";
+import LAYOUT_COLLECTIONS_LIST from "./export-theme/layouts/collections/list.html?raw";
+import LAYOUT_COLLECTION_SINGLE from "./export-theme/layouts/collection/single.html?raw";
+import PARTIAL_HEAD from "./export-theme/layouts/partials/head.html?raw";
+import PARTIAL_HEADER from "./export-theme/layouts/partials/header.html?raw";
+import PARTIAL_FOOTER from "./export-theme/layouts/partials/footer.html?raw";
+import PARTIAL_PAGINATION from "./export-theme/layouts/partials/pagination.html?raw";
+import PARTIAL_POST_CARD from "./export-theme/layouts/partials/post-card.html?raw";
+import PARTIAL_MEDIA_GALLERY from "./export-theme/layouts/partials/media-gallery.html?raw";
+import PARTIAL_REPLY from "./export-theme/layouts/partials/reply.html?raw";
+import PARTIAL_THREAD_PREVIEW from "./export-theme/layouts/partials/thread-preview.html?raw";
+import LAYOUT_RSS from "./export-theme/layouts/_default/rss.xml?raw";
+import PARTIAL_FEED_POST_CONTENT from "./export-theme/layouts/partials/feed-post-content.xml?raw";
+
 import type { StorageDriver } from "../lib/storage.js";
 import { base64ToUint8Array } from "../lib/favicon.js";
-import type {
-  Post,
-  Collection,
-  Media,
-  NavItem,
-  TextAttachmentContent,
-} from "../types.js";
+import type { Post, Collection, Media, NavItem } from "../types.js";
+
+/** A file entry in the exported Hugo site. */
+export interface ExportFile {
+  path: string;
+  content: string | Uint8Array;
+}
 
 export interface ExportService {
-  generateZolaSite(): Promise<Uint8Array>;
+  /** Generate a flat list of files for a complete Hugo site. */
+  generateHugoFiles(): Promise<ExportFile[]>;
+  /** Generate a ZIP archive of the Hugo site. */
+  generateHugoSite(): Promise<Uint8Array>;
 }
 
-interface SiteConfig {
+export interface SiteConfig {
   siteName: string;
   siteUrl: string;
   siteDescription: string;
   siteLanguage: string;
   showJantBrandingOnHome: boolean;
   homeDefaultView: string;
-  headerNavMaxVisible: number;
+  /** "latest" or "featured" — drives the default RSS nav link in the exported site. */
+  mainRssFeed: string;
   siteFooter: string;
   showHeaderAvatar: boolean;
   siteAvatarUrl: string;
@@ -66,31 +124,58 @@ interface SiteConfig {
   sitePathPrefix?: string;
   navItems: Pick<
     NavItem,
-    "type" | "systemKey" | "label" | "url" | "position"
+    "type" | "systemKey" | "label" | "url" | "position" | "placement"
   >[];
-}
-
-interface AttachmentExportMeta {
-  kind: Media["mediaKind"];
-  src?: string;
-  poster?: string | null;
-  mimeType: string;
-  originalName: string;
-  size: number;
-  width: number | null;
-  height: number | null;
-  alt: string | null;
-  position: string;
-  blurhash: string | null;
-  waveform: string | null;
-  summary: string | null;
-  chars: number | null;
-  contentFormat?: TextAttachmentContent["contentFormat"];
-  content?: string;
+  /** Items per page for Hugo pagination — kept in sync with the main site's PAGE_SIZE. */
+  pageSize: number;
+  /** Items per archive page — kept in sync with the main site's ARCHIVE_PAGE_SIZE. */
+  archivePageSize: number;
+  /** Max items per Atom feed — kept in sync with the main site's rssFeedLimit. */
+  rssFeedLimit: number;
 }
 
 type IconExportMode = "default" | "custom";
 
+type ExportedCollectionDirectoryItem =
+  | {
+      type: "collection";
+      sequence: string;
+      slug: string;
+      title: string;
+      /** Rendered HTML of the collection description, or null if empty. */
+      descriptionHtml?: string | null;
+      entryCount?: number;
+      recentActivityLabel?: string | null;
+      recentActivityIso?: string | null;
+    }
+  | {
+      type: "divider";
+      label: string | null;
+    }
+  | {
+      type: "link";
+      sequence: string;
+      label: string;
+      url: string;
+      /** Rendered HTML of the link description, or null if empty. */
+      descriptionHtml?: string | null;
+    };
+
+interface ExportCollectionDirectorySourceItem {
+  type: "collection" | "divider" | "link";
+  label?: string | null;
+  url?: string | null;
+  description?: string | null;
+  collection?: {
+    id: string;
+    slug: string;
+    title: string;
+    description?: string | null;
+    postCount?: number;
+    recentActivityAt?: number;
+  };
+}
+
 interface SiteIconAssets {
   faviconBytes: Uint8Array;
   faviconMode: IconExportMode;
@@ -98,6 +183,41 @@ interface SiteIconAssets {
   appleTouchMode: IconExportMode;
 }
 
+interface ExportedCollectionMetrics {
+  postCount: number;
+  recentActivityAt: number;
+}
+
+/**
+ * A single `collections:` front-matter entry, already resolved to its
+ * Hugo-visible slug. Assembled from
+ * `collectionService.getCollectionEntriesByPostIds` + `collectionSlugMap`.
+ */
+interface ExportedCollectionEntry {
+  slug: string;
+  /**
+   * Denormalized collection title. Kept alongside the slug so the exported
+   * front matter can render a tag label without templates having to resolve
+   * another page. Optional because legacy call sites may not supply it.
+   */
+  title?: string;
+  /** Unix seconds. */
+  collectedAt: number;
+  position: number;
+  /** Unix seconds, or null when not pinned in this collection. */
+  pinnedAt: number | null;
+}
+
+function buildDefaultAppleTouchAsset(): Pick<
+  SiteIconAssets,
+  "appleTouchBytes" | "appleTouchMode"
+> {
+  return {
+    appleTouchBytes: getDefaultJantAppleTouchIconBytes(),
+    appleTouchMode: "default",
+  };
+}
+
 export function createExportService(
   services: {
     posts: PostService;
@@ -109,15 +229,22 @@ export function createExportService(
   deps: { storage?: StorageDriver | null } = {},
 ): ExportService {
   return {
-    async generateZolaSite() {
+    async generateHugoFiles() {
+      const collectionDirectoryDataPromise =
+        typeof services.collections.listDirectoryData === "function"
+          ? services.collections.listDirectoryData()
+          : Promise.resolve(null);
+
       // 1. Query all data
-      const [allPosts, allCollections] = await Promise.all([
-        services.posts.list({
-          excludeReplies: false,
-          limit: 10000,
-        }),
-        services.collections.list(),
-      ]);
+      const [allPosts, allCollections, collectionDirectoryData] =
+        await Promise.all([
+          services.posts.list({
+            excludeReplies: false,
+            limit: 10000,
+          }),
+          services.collections.list(),
+          collectionDirectoryDataPromise,
+        ]);
 
       const allPostIds = allPosts.map((p) => p.id);
       const roots = allPosts.filter((p) => p.replyToId === null);
@@ -126,23 +253,45 @@ export function createExportService(
 
       const [
         collectionsByPost,
+        collectionEntriesByPost,
         rawMediaByPost,
         slugMap,
         aliasMap,
         collectionSlugMap,
       ] = await Promise.all([
         services.collections.getCollectionsByPostIds(allPostIds),
+        services.collections.getCollectionEntriesByPostIds(allPostIds),
         services.media.getByPostIds(allPostIds),
         services.paths.getPostSlugMap(allPostIds),
         services.paths.getPostAliases(rootPostIds),
         services.paths.getCollectionSlugMap(allCollections.map((c) => c.id)),
       ]);
-      const textAttachmentContents = await buildTextAttachmentContentMap(
-        rawMediaByPost,
-        services.media,
-        deps.storage,
-      );
+      // Denormalized title lookup so front-matter collection refs can
+      // include a title label without templates having to resolve another
+      // page. Source of truth is still `slug` on round-trip; `title` is
+      // refreshed from DB on every export.
+      const collectionTitleMap = new Map<string, string>();
+      for (const collection of allCollections) {
+        collectionTitleMap.set(collection.id, collection.title);
+      }
+
       const iconAssets = await buildSiteIconAssets(siteConfig, deps.storage);
+      const collectionMetrics = buildExportedCollectionMetrics(
+        allCollections,
+        allPosts,
+        collectionsByPost,
+      );
+      const exportedCollectionDirectoryItems =
+        buildExportedCollectionDirectoryItems(
+          collectionDirectoryData?.items ??
+            allCollections.map((collection) => ({
+              id: collection.id,
+              type: "collection" as const,
+              collection,
+            })),
+          collectionSlugMap,
+          collectionMetrics,
+        );
 
       // 2. Group replies by threadId
       const repliesByThread = new Map<string, Post[]>();
@@ -156,90 +305,236 @@ export function createExportService(
         list.sort((a, b) => a.createdAt - b.createdAt);
       }
 
-      // 3. Build ZIP file structure
-      const { zipSync } = await import("fflate");
-      const files: Record<string, Uint8Array> = {};
+      // 3. Build file list
+      const exportFiles: ExportFile[] = [];
 
-      // Generate post files
+      // Generate thread bundles (root _index.md + per-reply index.md).
       for (const root of roots) {
         const slug = slugMap.get(root.id) ?? root.slug;
         const threadReplies = repliesByThread.get(root.id) ?? [];
-        const postCollections = collectionsByPost.get(root.id) ?? [];
         const rootAliases = [...(aliasMap.get(root.id) ?? [])];
-        const zolaAliases = [...rootAliases];
-        const rootMedia = rawMediaByPost.get(root.id) ?? [];
-
-        // Reply URLs must resolve back to the merged thread page in Zola, but
-        // they are not root aliases when round-tripping into Jant.
-        for (const reply of threadReplies) {
-          const replySlug = slugMap.get(reply.id) ?? reply.slug;
-          zolaAliases.push(`/${replySlug}`);
-        }
 
-        const markdown = buildPostMarkdown(
+        const rootCollectionEntries = buildExportedCollectionEntriesForPost(
+          root.id,
+          collectionEntriesByPost,
+          collectionSlugMap,
+          collectionTitleMap,
+        );
+
+        const bundleFiles = await buildThreadBundle(
           root,
           threadReplies,
-          postCollections,
-          { rootAliases, zolaAliases },
+          slug,
+          rootAliases,
+          rootCollectionEntries,
           slugMap,
+          collectionEntriesByPost,
           collectionSlugMap,
-          rootMedia,
+          collectionTitleMap,
           rawMediaByPost,
           siteConfig,
-          textAttachmentContents,
+          deps.storage ?? null,
         );
-
-        files[`content/${slug}/index.md`] = new TextEncoder().encode(markdown);
+        exportFiles.push(...bundleFiles);
       }
 
+      // Collection landing pages (`content/{slug}/_index.md`).
       for (const collection of allCollections) {
         const slug = collectionSlugMap.get(collection.id) ?? collection.slug;
-        const section = buildCollectionSection(collection);
-        files[`content/c/${slug}/_index.md`] = new TextEncoder().encode(
-          section,
-        );
+        const entryCount = collectionMetrics.get(collection.id)?.postCount ?? 0;
+        exportFiles.push({
+          path: `content/${slug}/_index.md`,
+          content: await buildCollectionSection(collection, slug, entryCount),
+        });
       }
 
-      // Generate scaffold
-      files["config.toml"] = new TextEncoder().encode(
-        buildConfigToml(siteConfig, iconAssets),
-      );
-      files["content/_index.md"] = new TextEncoder().encode(buildRootSection());
-      files["content/archive/_index.md"] = new TextEncoder().encode(
-        buildArchiveSection(),
-      );
-      files["templates/base.html"] = new TextEncoder().encode(TEMPLATE_BASE);
-      files["templates/archive.html"] = new TextEncoder().encode(
-        TEMPLATE_ARCHIVE,
-      );
-      files["templates/index.html"] = new TextEncoder().encode(TEMPLATE_INDEX);
-      files["templates/page.html"] = new TextEncoder().encode(TEMPLATE_PAGE);
-      files["templates/section.html"] = new TextEncoder().encode(
-        TEMPLATE_SECTION,
-      );
-      files["templates/taxonomy_list.html"] = new TextEncoder().encode(
-        TEMPLATE_TAXONOMY_LIST,
-      );
-      files["templates/taxonomy_single.html"] = new TextEncoder().encode(
-        TEMPLATE_TAXONOMY_SINGLE,
-      );
-      files["templates/atom.xml"] = new TextEncoder().encode(TEMPLATE_ATOM);
-      files["templates/macros.html"] = new TextEncoder().encode(
-        TEMPLATE_MACROS,
-      );
-      files["static/style.css"] = new TextEncoder().encode(STYLE_CSS);
-      files["static/theme.css"] = new TextEncoder().encode(
-        siteConfig.themeCss ?? "",
-      );
-      files["static/custom.css"] = new TextEncoder().encode(
-        siteConfig.customCss ?? "",
-      );
-      files["static/favicon.ico"] = iconAssets.faviconBytes;
-      files["static/apple-touch-icon.png"] = iconAssets.appleTouchBytes;
-      files["README.md"] = new TextEncoder().encode(
-        buildReadme(siteConfig.siteName),
-      );
+      // Section + home scaffolding.
+      exportFiles.push({
+        path: "hugo.toml",
+        content: buildHugoToml(siteConfig),
+      });
+      exportFiles.push({
+        path: "content/_index.md",
+        content: await buildHomeSection(siteConfig),
+      });
+      exportFiles.push({
+        path: "content/collections/_index.md",
+        content: await buildCollectionsSection(),
+      });
+      exportFiles.push({
+        path: "content/archive/_index.md",
+        content: await buildArchiveSection(),
+      });
+
+      const usedSlugs = new Set<string>();
+      for (const s of slugMap.values()) usedSlugs.add(s);
+      for (const s of collectionSlugMap.values()) usedSlugs.add(s);
+      if (!usedSlugs.has("featured")) {
+        exportFiles.push({
+          path: "content/featured/_index.md",
+          content: await buildFeaturedSection(),
+        });
+      }
+
+      // Single data file consumed by templates via `hugo.Data.jant`. The
+      // collection directory lives on the same object as `directory` so
+      // everything Jant owns round-trips in one place.
+      exportFiles.push({
+        path: "data/jant.toml",
+        content: buildJantDataToml(
+          siteConfig,
+          iconAssets,
+          exportedCollectionDirectoryItems,
+        ),
+      });
+
+      // Theme scaffolding (real templates + styles land in Commit 5).
+      exportFiles.push({
+        path: "themes/jant/theme.toml",
+        content: THEME_TOML,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/_default/baseof.html",
+        content: LAYOUT_BASEOF,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/_default/single.html",
+        content: LAYOUT_SINGLE,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/_default/list.html",
+        content: LAYOUT_LIST,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/_default/alias.html",
+        content: LAYOUT_ALIAS,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/index.html",
+        content: LAYOUT_INDEX,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/post/list.html",
+        content: LAYOUT_POST_LIST,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/featured/list.html",
+        content: LAYOUT_FEATURED_LIST,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/archive/list.html",
+        content: LAYOUT_ARCHIVE_LIST,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/collections/list.html",
+        content: LAYOUT_COLLECTIONS_LIST,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/collection/single.html",
+        content: LAYOUT_COLLECTION_SINGLE,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/partials/head.html",
+        content: PARTIAL_HEAD,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/partials/header.html",
+        content: PARTIAL_HEADER,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/partials/footer.html",
+        content: PARTIAL_FOOTER,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/partials/pagination.html",
+        content: PARTIAL_PAGINATION,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/partials/post-card.html",
+        content: PARTIAL_POST_CARD,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/partials/media-gallery.html",
+        content: PARTIAL_MEDIA_GALLERY,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/partials/reply.html",
+        content: PARTIAL_REPLY,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/partials/thread-preview.html",
+        content: PARTIAL_THREAD_PREVIEW,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/_default/rss.xml",
+        content: LAYOUT_RSS,
+      });
+      exportFiles.push({
+        path: "themes/jant/layouts/partials/feed-post-content.xml",
+        content: PARTIAL_FEED_POST_CONTENT,
+      });
+
+      // Static assets. Load order in the template's <head> is
+      // tokens → main → theme → custom (wired up by the Commit 5 partial).
+      exportFiles.push({
+        path: "themes/jant/static/tokens.css",
+        content: TOKENS_CSS,
+      });
+      exportFiles.push({
+        path: "themes/jant/static/main.css",
+        content: THEME_STYLE_MAIN_CSS,
+      });
+      exportFiles.push({
+        path: "themes/jant/static/theme.css",
+        content: siteConfig.themeCss ?? "",
+      });
+      exportFiles.push({
+        path: "themes/jant/static/custom.css",
+        content: siteConfig.customCss ?? "",
+      });
+      // Client-side interactions: media lightbox, feed video autoplay,
+      // audio waveform, gallery scroll hints. Reserved namespace keeps these
+      // from colliding with user-authored static files.
+      exportFiles.push({
+        path: "themes/jant/static/_jant/client-site.js",
+        content: CLIENT_SITE_JS,
+      });
+      exportFiles.push({
+        path: "themes/jant/static/_jant/client-site.css",
+        content: CLIENT_SITE_CSS,
+      });
+      exportFiles.push({
+        path: "themes/jant/static/favicon.ico",
+        content: iconAssets.faviconBytes,
+      });
+      exportFiles.push({
+        path: "themes/jant/static/apple-touch-icon.png",
+        content: iconAssets.appleTouchBytes,
+      });
+
+      exportFiles.push({
+        path: "README.md",
+        content: buildReadme(siteConfig.siteName),
+      });
+      exportFiles.push({
+        path: ".gitignore",
+        content: buildGitignore(),
+      });
+
+      return exportFiles;
+    },
 
+    async generateHugoSite() {
+      const exportFiles = await this.generateHugoFiles();
+      const { zipSync } = await import("fflate");
+      const encoder = new TextEncoder();
+      const files: Record<string, Uint8Array> = {};
+      for (const file of exportFiles) {
+        files[file.path] =
+          typeof file.content === "string"
+            ? encoder.encode(file.content)
+            : file.content;
+      }
       return zipSync(files);
     },
   };
@@ -272,25 +567,38 @@ async function buildSiteIconAssets(
     return {
       faviconBytes,
       faviconMode,
-      appleTouchBytes: getDefaultJantAppleTouchIconBytes(),
-      appleTouchMode: "default",
+      ...buildDefaultAppleTouchAsset(),
     };
   }
 
   if (!storage) {
-    throw new Error(
-      "Custom apple-touch icon is configured but no storage driver is available for export",
+    return {
+      faviconBytes,
+      faviconMode,
+      ...buildDefaultAppleTouchAsset(),
+    };
+  }
+
+  let appleTouchBytes: Uint8Array | null;
+  try {
+    appleTouchBytes = await readStorageObjectBytes(
+      storage,
+      config.appleTouchIconStorageKey,
     );
+  } catch {
+    return {
+      faviconBytes,
+      faviconMode,
+      ...buildDefaultAppleTouchAsset(),
+    };
   }
 
-  const appleTouchBytes = await readStorageObjectBytes(
-    storage,
-    config.appleTouchIconStorageKey,
-  );
   if (!appleTouchBytes) {
-    throw new Error(
-      `Custom apple-touch icon "${config.appleTouchIconStorageKey}" is unavailable for export`,
-    );
+    return {
+      faviconBytes,
+      faviconMode,
+      ...buildDefaultAppleTouchAsset(),
+    };
   }
 
   return {
@@ -302,563 +610,1033 @@ async function buildSiteIconAssets(
 }
 
 // ---------------------------------------------------------------------------
-// Markdown generation
+// Thread bundle generation
 // ---------------------------------------------------------------------------
 
-/** Escape a string for use inside a TOML double-quoted value */
-function escapeToml(value: string): string {
-  return value
-    .replace(/\\/g, "\\\\")
-    .replace(/"/g, '\\"')
-    .replace(/\r/g, "\\r")
-    .replace(/\n/g, "\\n");
+function buildExportedCollectionEntriesForPost(
+  postId: string,
+  collectionEntriesByPost: Map<
+    string,
+    {
+      collectionId: string;
+      createdAt: number;
+      position: number;
+      pinnedAt: number | null;
+    }[]
+  >,
+  collectionSlugMap: Map<string, string>,
+  collectionTitleMap: Map<string, string>,
+): ExportedCollectionEntry[] {
+  const entries = collectionEntriesByPost.get(postId) ?? [];
+  const resolved: ExportedCollectionEntry[] = [];
+  for (const entry of entries) {
+    const slug = collectionSlugMap.get(entry.collectionId);
+    if (!slug) continue;
+    const title = collectionTitleMap.get(entry.collectionId);
+    resolved.push({
+      slug,
+      title,
+      collectedAt: entry.createdAt,
+      position: entry.position,
+      pinnedAt: entry.pinnedAt,
+    });
+  }
+  return resolved;
+}
+
+function collectionEntriesToRefs(
+  entries: readonly ExportedCollectionEntry[],
+): HugoCollectionRef[] {
+  return entries.map((entry) => ({
+    slug: entry.slug,
+    title: entry.title,
+    collected_at: toISOString(entry.collectedAt),
+    position: entry.position,
+    pinned_at: entry.pinnedAt !== null ? toISOString(entry.pinnedAt) : null,
+  }));
+}
+
+interface MediaEmission {
+  /** Flat `media:` front-matter entry. */
+  entry: JantMedia;
+  /**
+   * Site-relative path under `static/` where the primary bytes should
+   * land, or null when the media links to a remote public URL and no
+   * bytes need to be emitted.
+   */
+  inlinePath: string | null;
+  /**
+   * Site-relative path under `static/` where the poster bytes should
+   * land, or null when there's no poster or the poster is linked via
+   * a public URL.
+   */
+  inlinePosterPath: string | null;
+}
+
+/**
+ * Build a flat `media:` entry for a Media record plus a decision about
+ * whether the primary bytes (and poster) should be bundled into the
+ * export's `static/media/` directory.
+ *
+ * When the media's provider has a reachable public URL (R2/S3/local
+ * proxy configured with a `*_public_url`), `src` points at that absolute
+ * URL and no bytes are emitted — the exported site stays small and the
+ * media keeps being served from wherever it already lives. Without a
+ * public URL the bytes are written to `static/media/{id}.ext` and `src`
+ * is the site-relative path.
+ */
+function buildMediaEmission(
+  media: Media,
+  siteConfig: SiteConfig,
+): MediaEmission {
+  const publicUrl = getPublicUrlForProvider(
+    media.provider,
+    siteConfig.r2PublicUrl,
+    siteConfig.s3PublicUrl,
+    siteConfig.localPublicUrl,
+  );
+  const hasPublic = Boolean(publicUrl);
+
+  const ext = extOfFilename(media.filename);
+  const localName = `${media.id}${ext}`;
+  const localPath = `/media/${localName}`;
+  const src = hasPublic ? getMediaUrl(media.storageKey, publicUrl) : localPath;
+
+  const entry: JantMedia = {
+    id: media.id,
+    kind: media.mediaKind,
+    src,
+    position: parsePositionForSort(media.position),
+  };
+  if (media.alt !== null && media.alt !== "") entry.alt = media.alt;
+  if (media.width !== null) entry.width = media.width;
+  if (media.height !== null) entry.height = media.height;
+  if (media.blurhash !== null && media.blurhash !== "")
+    entry.blurhash = media.blurhash;
+  if (media.originalName) entry.original_name = media.originalName;
+  if (media.mimeType) entry.mime_type = media.mimeType;
+  if (typeof media.size === "number") entry.size = media.size;
+  if (media.waveform) entry.waveform = media.waveform;
+  if (media.summary) entry.summary = media.summary;
+  if (typeof media.chars === "number") entry.chars = media.chars;
+  if (media.durationSeconds !== null && media.durationSeconds !== undefined) {
+    entry.duration_seconds = media.durationSeconds;
+  }
+  entry.provider = media.provider;
+  entry.storage_key = media.storageKey;
+
+  let inlinePosterPath: string | null = null;
+  if (media.posterKey) {
+    const posterExt = extOfStorageKey(media.posterKey);
+    const posterLocalName = `${media.id}-poster.${posterExt}`;
+    entry.poster = hasPublic
+      ? getMediaUrl(media.posterKey, publicUrl)
+      : `/media/${posterLocalName}`;
+    entry.poster_key = media.posterKey;
+    if (!hasPublic) {
+      inlinePosterPath = `static/media/${posterLocalName}`;
+    }
+  }
+
+  return {
+    entry,
+    inlinePath: hasPublic ? null : `static/media/${localName}`,
+    inlinePosterPath,
+  };
 }
 
-/** Escape a string for use in YAML (wrap in quotes if needed) */
-function yamlString(value: string): string {
-  // If value contains characters that need quoting in YAML
-  if (
-    /[:#{}[\],&*?|>!%@`"'\n\\]/.test(value) ||
-    value.startsWith(" ") ||
-    value.endsWith(" ") ||
-    value === "" ||
-    value === "true" ||
-    value === "false" ||
-    value === "null"
-  ) {
-    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n")}"`;
+function parsePositionForSort(position: string): number {
+  // Fractional indexing keys sort lexicographically, but downstream
+  // consumers (and the UI) expect a numeric fallback. Keep a stable
+  // ordering by hashing the string into an integer.
+  let hash = 0;
+  for (let i = 0; i < position.length; i++) {
+    hash = (hash * 31 + position.charCodeAt(i)) | 0;
   }
-  return value;
+  return hash;
+}
+
+function extOfFilename(filename: string): string {
+  const dot = filename.lastIndexOf(".");
+  return dot >= 0 ? filename.slice(dot) : "";
+}
+
+function extOfStorageKey(key: string): string {
+  const dot = key.lastIndexOf(".");
+  return dot >= 0 ? key.slice(dot + 1) : "webp";
 }
 
-function buildPostMarkdown(
+/**
+ * Build a complete set of ExportFile entries for a single thread bundle:
+ * the root `_index.md`, one `index.md` per reply, and resource blobs for
+ * attached media when the storage driver can fetch them.
+ */
+async function buildThreadBundle(
   root: Post,
   threadReplies: Post[],
-  postCollections: Collection[],
-  aliasData: {
-    rootAliases: string[];
-    zolaAliases: string[];
-  },
+  rootSlug: string,
+  rootAliases: string[],
+  rootCollectionEntries: ExportedCollectionEntry[],
   slugMap: Map<string, string>,
+  collectionEntriesByPost: Map<
+    string,
+    {
+      collectionId: string;
+      createdAt: number;
+      position: number;
+      pinnedAt: number | null;
+    }[]
+  >,
   collectionSlugMap: Map<string, string>,
-  rootMedia: Media[],
+  collectionTitleMap: Map<string, string>,
   mediaByPost: Map<string, Media[]>,
   siteConfig: SiteConfig,
-  textAttachmentContents: Map<string, TextAttachmentContent>,
-): string {
-  const parts: string[] = [];
-
-  // Front matter (YAML)
-  parts.push("---");
-  if (root.title && root.format !== "quote") {
-    parts.push(`title: ${yamlString(root.title)}`);
-  }
-  const date = root.publishedAt ?? root.createdAt;
-  if (date) {
-    parts.push(`date: ${toISOString(date)}`);
-  }
-  if (root.updatedAt && root.updatedAt !== root.publishedAt) {
-    parts.push(`updated: ${toISOString(root.updatedAt)}`);
-  }
-  if (root.status === "draft" || root.visibility === "private") {
-    parts.push("draft: true");
+  storage: StorageDriver | null,
+): Promise<ExportFile[]> {
+  const files: ExportFile[] = [];
+
+  // Root aliases = historical root slugs + every reply slug (so
+  // /{reply-slug}/ gets a Hugo alias page that redirects/anchors to
+  // the thread root).
+  const aliases = [...rootAliases];
+  for (const reply of threadReplies) {
+    const replySlug = slugMap.get(reply.id) ?? reply.slug;
+    aliases.push(`/${replySlug}/`);
   }
 
-  const slug = slugMap.get(root.id) ?? root.slug;
-  parts.push(`slug: ${yamlString(slug)}`);
+  // Root front matter.
+  const rootMedia = mediaByPost.get(root.id) ?? [];
+  const rootEmissions = rootMedia.map((m) => buildMediaEmission(m, siteConfig));
+  const rootMediaList = rootEmissions.map((e) => e.entry);
+  const rootFrontMatter: HugoFrontMatter = {
+    id: root.id,
+    title: root.format !== "quote" ? (root.title ?? undefined) : undefined,
+    date:
+      root.publishedAt !== null
+        ? toISOString(root.publishedAt)
+        : toISOString(root.createdAt),
+    updated:
+      root.updatedAt && root.updatedAt !== root.publishedAt
+        ? toISOString(root.updatedAt)
+        : undefined,
+    // `updated` only reflects edits to the root post itself; when a reply
+    // lands, it does NOT bump. For RSS we want the thread's last activity
+    // (max of all published reply timestamps) so readers re-surface a
+    // thread when a new reply appears. Kept alongside `updated` so the
+    // importer round-trips cleanly.
+    last_activity_at:
+      root.lastActivityAt !== null && root.lastActivityAt !== root.publishedAt
+        ? toISOString(root.lastActivityAt)
+        : undefined,
+    slug: rootSlug,
+    type: "post",
+    draft:
+      root.status === "draft" || root.visibility === "private"
+        ? true
+        : undefined,
+    aliases: aliases.length > 0 ? aliases : undefined,
+    format: root.format,
+    status: root.status,
+    visibility: root.visibility,
+    summary_text: getArchiveSummaryText(root) ?? undefined,
+    link_url: root.format === "link" && root.url ? root.url : undefined,
+    source_name: root.format === "quote" && root.title ? root.title : undefined,
+    source_url: root.format === "quote" && root.url ? root.url : undefined,
+    quote_text: root.quoteText ?? undefined,
+    rating: root.rating ?? undefined,
+    featured_at:
+      root.featuredAt !== null ? toISOString(root.featuredAt) : undefined,
+    pinned_at: root.pinnedAt !== null ? toISOString(root.pinnedAt) : undefined,
+    root_aliases: rootAliases.length > 0 ? rootAliases : undefined,
+    collections:
+      rootCollectionEntries.length > 0
+        ? collectionEntriesToRefs(rootCollectionEntries)
+        : undefined,
+    media: rootMediaList.length > 0 ? rootMediaList : undefined,
+  };
 
-  if (aliasData.zolaAliases.length > 0) {
-    parts.push("aliases:");
-    for (const a of aliasData.zolaAliases) {
-      parts.push(`  - ${yamlString(a)}`);
+  const rootBody = root.body ? tiptapJsonToMarkdown(root.body) : "";
+  files.push({
+    path: `content/${rootSlug}/_index.md`,
+    content: `${await formatFrontMatter(rootFrontMatter)}\n${rootBody}${rootBody.endsWith("\n") ? "" : "\n"}`,
+  });
+
+  // Emit media bytes under static/media/ for any media without a
+  // reachable public URL. Media whose provider has a configured public
+  // URL keeps `src` pointing at that absolute URL and skips inlining —
+  // this avoids re-downloading every attachment when the site is going
+  // to keep serving media from the existing CDN/proxy anyway.
+  for (const { emission, media } of rootEmissions.map((e, i) => ({
+    emission: e,
+    media: rootMedia[i] as Media,
+  }))) {
+    if (emission.inlinePath) {
+      const file = await readMediaResourceFile(
+        storage,
+        media.storageKey,
+        emission.inlinePath,
+      );
+      if (file) files.push(file);
     }
-  }
-
-  // Taxonomies
-  if (postCollections.length > 0) {
-    parts.push("taxonomies:");
-    parts.push("  c:");
-    for (const c of postCollections) {
-      const colSlug = collectionSlugMap.get(c.id) ?? c.slug;
-      parts.push(`    - ${yamlString(colSlug)}`);
+    if (emission.inlinePosterPath && media.posterKey) {
+      const posterFile = await readMediaResourceFile(
+        storage,
+        media.posterKey,
+        emission.inlinePosterPath,
+      );
+      if (posterFile) files.push(posterFile);
     }
   }
 
-  // Extra metadata
-  parts.push("extra:");
-  parts.push(`  format: ${root.format}`);
-  parts.push(`  status: ${root.status}`);
-  parts.push(`  visibility: ${root.visibility}`);
-  const summaryText = getArchiveSummaryText(root);
-  if (summaryText) {
-    parts.push(`  summary_text: ${yamlString(summaryText)}`);
-  }
-  if (root.format === "link" && root.url) {
-    parts.push(`  link_url: ${yamlString(root.url)}`);
-  }
-  if (root.format === "quote" && root.title) {
-    parts.push(`  source_name: ${yamlString(root.title)}`);
-  }
-  if (root.format === "quote" && root.url) {
-    parts.push(`  source_url: ${yamlString(root.url)}`);
-  }
-  if (root.quoteText) {
-    parts.push(`  quote_text: ${yamlString(root.quoteText)}`);
-  }
-  if (root.rating !== null) {
-    parts.push(`  rating: ${root.rating}`);
-  }
-  if (root.pinnedAt !== null) {
-    parts.push("  pinned: true");
-  }
-  if (root.featuredAt !== null) {
-    parts.push("  featured: true");
-  }
-  if (aliasData.rootAliases.length > 0) {
-    parts.push("  jant:");
-    parts.push("    root_aliases:");
-    for (const alias of aliasData.rootAliases) {
-      parts.push(`      - ${yamlString(alias)}`);
-    }
-  }
+  // Replies as nested leaf bundles.
+  for (const reply of threadReplies) {
+    const replySlug = slugMap.get(reply.id) ?? reply.slug;
+    const replyMedia = mediaByPost.get(reply.id) ?? [];
+    const replyEmissions = replyMedia.map((m) =>
+      buildMediaEmission(m, siteConfig),
+    );
+    const replyMediaList = replyEmissions.map((e) => e.entry);
+    const replyCollectionEntries = buildExportedCollectionEntriesForPost(
+      reply.id,
+      collectionEntriesByPost,
+      collectionSlugMap,
+      collectionTitleMap,
+    );
 
-  parts.push("---");
-  parts.push("");
+    const replyFrontMatter: HugoFrontMatter = {
+      id: reply.id,
+      title: reply.format !== "quote" ? (reply.title ?? undefined) : undefined,
+      date:
+        reply.publishedAt !== null
+          ? toISOString(reply.publishedAt)
+          : toISOString(reply.createdAt),
+      updated:
+        reply.updatedAt && reply.updatedAt !== reply.publishedAt
+          ? toISOString(reply.updatedAt)
+          : undefined,
+      slug: replySlug,
+      type: "post",
+      draft:
+        reply.status === "draft" || reply.visibility === "private"
+          ? true
+          : undefined,
+      build: { render: "never", list: "local" },
+      format: reply.format,
+      status: reply.status,
+      visibility: reply.visibility,
+      summary_text: getArchiveSummaryText(reply) ?? undefined,
+      link_url: reply.format === "link" && reply.url ? reply.url : undefined,
+      source_name:
+        reply.format === "quote" && reply.title ? reply.title : undefined,
+      source_url: reply.format === "quote" && reply.url ? reply.url : undefined,
+      quote_text: reply.quoteText ?? undefined,
+      rating: reply.rating ?? undefined,
+      featured_at:
+        reply.featuredAt !== null ? toISOString(reply.featuredAt) : undefined,
+      pinned_at:
+        reply.pinnedAt !== null ? toISOString(reply.pinnedAt) : undefined,
+      collections:
+        replyCollectionEntries.length > 0
+          ? collectionEntriesToRefs(replyCollectionEntries)
+          : undefined,
+      media: replyMediaList.length > 0 ? replyMediaList : undefined,
+    };
 
-  // Root body
-  const rootBlocks = [
-    root.body ? tiptapJsonToMarkdown(root.body) : "",
-    buildAttachmentBlock(rootMedia, siteConfig, textAttachmentContents),
-  ].filter(Boolean);
-  if (rootBlocks.length > 0) {
-    parts.push(rootBlocks.join("\n\n"));
+    const replyBody = reply.body ? tiptapJsonToMarkdown(reply.body) : "";
+    files.push({
+      path: `content/${rootSlug}/${replySlug}/index.md`,
+      content: `${await formatFrontMatter(replyFrontMatter)}\n${replyBody}${replyBody.endsWith("\n") ? "" : "\n"}`,
+    });
+
+    for (const { emission, media } of replyEmissions.map((e, i) => ({
+      emission: e,
+      media: replyMedia[i] as Media,
+    }))) {
+      if (emission.inlinePath) {
+        const file = await readMediaResourceFile(
+          storage,
+          media.storageKey,
+          emission.inlinePath,
+        );
+        if (file) files.push(file);
+      }
+      if (emission.inlinePosterPath && media.posterKey) {
+        const posterFile = await readMediaResourceFile(
+          storage,
+          media.posterKey,
+          emission.inlinePosterPath,
+        );
+        if (posterFile) files.push(posterFile);
+      }
+    }
   }
 
-  // Thread replies
-  for (const reply of threadReplies) {
-    parts.push("");
+  return files;
+}
 
-    // Reply marker comment
-    const replySlug = slugMap.get(reply.id) ?? reply.slug;
-    const esc = escapeCommentAttribute;
-    let marker = `<!-- jant:reply date="${reply.publishedAt ? toISOString(reply.publishedAt) : ""}" slug="${esc(replySlug)}" format="${reply.format}" status="${reply.status}" visibility="${reply.visibility}"`;
+/**
+ * Read a media record's bytes from storage and return an ExportFile so
+ * they can be bundled next to the post as a Hugo page resource. Returns
+ * null when storage is unavailable or the object cannot be read, in
+ * which case the front matter entry still points at the resource name
+ * and the CLI's pull-media step (or a later sync) can fill it in.
+ */
+async function readMediaResourceFile(
+  storage: StorageDriver | null,
+  storageKey: string,
+  bundlePath: string,
+): Promise<ExportFile | null> {
+  if (!storage) return null;
+  try {
+    const bytes = await readStorageObjectBytes(storage, storageKey);
+    if (!bytes) return null;
+    return { path: bundlePath, content: bytes };
+  } catch {
+    return null;
+  }
+}
 
-    if (reply.format === "link" && reply.url) {
-      marker += ` url="${esc(reply.url)}"`;
-    }
-    if (reply.format === "quote" && reply.quoteText) {
-      marker += ` quote_text="${encodeURIComponent(reply.quoteText)}"`;
-    }
-    if (reply.format === "quote" && reply.title) {
-      marker += ` source_name="${esc(reply.title)}"`;
-    }
-    if (reply.format === "quote" && reply.url) {
-      marker += ` source_url="${esc(reply.url)}"`;
-    }
-    if (reply.rating !== null) {
-      marker += ` rating="${reply.rating}"`;
-    }
-    if (reply.title && reply.format !== "quote") {
-      marker += ` title="${esc(reply.title)}"`;
-    }
-    marker += " -->";
+// ---------------------------------------------------------------------------
+// Section + landing pages
+// ---------------------------------------------------------------------------
 
-    parts.push(marker);
-    parts.push("");
+async function buildHomeSection(siteConfig: SiteConfig): Promise<string> {
+  const frontMatter: HugoFrontMatter = {
+    title: siteConfig.siteName,
+    type: "home",
+  };
+  return `${await formatFrontMatter(frontMatter)}\n`;
+}
 
-    const replyBlocks = [
-      reply.body ? tiptapJsonToMarkdown(reply.body) : "",
-      buildAttachmentBlock(
-        mediaByPost.get(reply.id) ?? [],
-        siteConfig,
-        textAttachmentContents,
-      ),
-    ].filter(Boolean);
-    if (replyBlocks.length > 0) {
-      parts.push(replyBlocks.join("\n\n"));
-    }
-  }
+async function buildCollectionsSection(): Promise<string> {
+  const frontMatter: HugoFrontMatter = {
+    title: "Collections",
+    type: "collections",
+  };
+  return `${await formatFrontMatter(frontMatter)}\n`;
+}
 
-  return parts.join("\n");
+async function buildArchiveSection(): Promise<string> {
+  const frontMatter: HugoFrontMatter = {
+    title: "Archive",
+    type: "archive",
+    // Opt into Atom output at /archive/index.xml.
+    outputs: ["html", "rss"],
+  };
+  return `${await formatFrontMatter(frontMatter)}\n`;
 }
 
-function buildCollectionSection(collection: Collection): string {
-  const parts: string[] = ["+++"];
-  parts.push(`title = "${escapeToml(collection.title)}"`);
-  parts.push("render = false");
-  if (collection.description) {
-    parts.push(`description = "${escapeToml(collection.description)}"`);
-  }
-  parts.push("[extra]");
-  parts.push(`sort_order = "${escapeToml(collection.sortOrder)}"`);
-  parts.push("jant_collection = true");
-  parts.push("+++");
-  parts.push("");
-  return parts.join("\n");
+async function buildFeaturedSection(): Promise<string> {
+  const frontMatter: HugoFrontMatter = {
+    title: "Featured",
+    type: "featured",
+    // Opt into Atom output at /featured/index.xml.
+    outputs: ["html", "rss"],
+  };
+  return `${await formatFrontMatter(frontMatter)}\n`;
+}
+
+async function buildCollectionSection(
+  collection: Collection,
+  slug: string,
+  entryCount: number,
+): Promise<string> {
+  const frontMatter: HugoFrontMatter = {
+    title: collection.title,
+    slug,
+    type: "collection",
+    summary_text: collection.description ?? undefined,
+    sort_order: collection.sortOrder,
+    entry_count: entryCount,
+    // Opt into Atom output at /{slug}/index.xml.
+    outputs: ["html", "rss"],
+  };
+  return `${await formatFrontMatter(frontMatter)}\n`;
 }
 
+// ---------------------------------------------------------------------------
+// Summary extraction (kept from the previous exporter)
+// ---------------------------------------------------------------------------
+
 function normalizeArchiveText(text: string | null | undefined): string {
   return (text ?? "").replace(/\s+/g, " ").trim();
 }
 
 function getArchiveSummaryText(post: Post): string | null {
+  // `summary_text` is a plain-text projection of the post's primary content,
+  // used for `<meta name="description">`, `og:description`, and archive/card
+  // fallbacks when the rendered body is empty. The candidate list differs
+  // per format so the description reflects the right "primary content":
+  //
+  // - Quote: body (commentary) → quoteText. Quotes have no title, so we
+  //   fall back to the quote itself to guarantee a meaningful description.
+  // - Link: body only. Links have a title + domain; the URL is already
+  //   serialized as `link_url` and rendered as a domain badge, so using
+  //   it as `summary_text` would duplicate that information.
+  // - Note: body only. If the body is empty, there's nothing to describe.
   const candidates =
     post.format === "quote"
-      ? [post.summary, post.quoteText, post.bodyText, post.url]
-      : [post.summary, post.bodyText, post.quoteText, post.url];
+      ? [post.summary, post.bodyText, post.quoteText]
+      : [post.summary, post.bodyText];
 
   for (const candidate of candidates) {
     const normalized = normalizeArchiveText(candidate);
     if (normalized) return normalized;
   }
-
   return null;
 }
 
-function buildAttachmentBlock(
-  mediaList: Media[],
-  siteConfig: SiteConfig,
-  textAttachmentContents: Map<string, TextAttachmentContent>,
-): string {
-  if (mediaList.length === 0) return "";
+// ---------------------------------------------------------------------------
+// Collection metrics + directory items (kept from the previous exporter)
+// ---------------------------------------------------------------------------
 
-  const figures = mediaList
-    .map((media) =>
-      buildAttachmentFigure(media, siteConfig, textAttachmentContents),
-    )
-    .join("\n");
+function formatCollectionActivityLabel(
+  timestamp: number | undefined,
+): string | null {
+  if (typeof timestamp !== "number") {
+    return null;
+  }
 
-  return `<div data-jant-node="attachments">\n${figures}\n</div>`;
+  return formatRelativeAge(timestamp);
 }
 
-function buildAttachmentFigure(
-  media: Media,
-  siteConfig: SiteConfig,
-  textAttachmentContents: Map<string, TextAttachmentContent>,
-): string {
-  const meta = buildAttachmentMeta(
-    media,
-    siteConfig,
-    textAttachmentContents.get(media.id),
-  );
-  const metaJson = safeJsonForHtml(meta);
-  const name = escapeHtml(meta.originalName);
-  const caption =
-    media.summary && media.summary !== media.originalName
-      ? `<figcaption>${escapeHtml(media.summary)}</figcaption>`
-      : "";
-
-  if (
-    meta.kind === "text" &&
-    meta.contentFormat === "markdown" &&
-    typeof meta.content === "string"
-  ) {
-    const summaryLabel = escapeHtml(
-      media.summary?.trim() || meta.originalName || "Text attachment",
-    );
-    return `<figure data-jant-node="attachment" data-jant-kind="text">
-  <script type="application/json" data-jant-meta>${metaJson}</script>
-  <details>
-    <summary>${summaryLabel}</summary>
-    <div class="prose jant-attachment-text-preview">${renderMarkdown(meta.content)}</div>
-  </details>
-</figure>`;
+function formatCollectionActivityIso(
+  timestamp: number | undefined,
+): string | null {
+  if (typeof timestamp !== "number") {
+    return null;
   }
 
-  const src = meta.src;
-  if (!src) {
-    throw new Error(`Attachment ${media.id} is missing an export URL`);
-  }
+  return toISOString(timestamp);
+}
 
-  if (meta.kind === "image") {
-    const alt = media.alt ? ` alt="${escapeHtml(media.alt)}"` : ' alt=""';
-    return `<figure data-jant-node="attachment" data-jant-kind="image">
-  <script type="application/json" data-jant-meta>${metaJson}</script>
-  <img src="${escapeHtml(src)}"${alt}>
-  ${caption}
-</figure>`;
+/**
+ * Group-aware sequence labels for the exported collection directory.
+ *
+ * Mirrors the main site's `computeSequenceLabels` in
+ * `ui/shared/CollectionDirectory.tsx` so Hugo exports render the same numeric
+ * indices (e.g. "00" "01" under the first divider, "10" "11" under the
+ * second). Dividers themselves receive an empty string — their slot is
+ * reserved so the returned array is index-aligned with the source list.
+ */
+function computeCollectionDirectorySequenceLabels(
+  items: readonly ExportCollectionDirectorySourceItem[],
+): string[] {
+  const isContentItem = (item: ExportCollectionDirectorySourceItem) =>
+    (item.type === "collection" && item.collection) ||
+    (item.type === "link" && item.label && item.url);
+
+  const groupSizes: number[] = [];
+  let seenDivider = false;
+  let ungroupedCount = 0;
+  for (const item of items) {
+    if (item.type === "divider") {
+      seenDivider = true;
+      groupSizes.push(0);
+    } else if (isContentItem(item)) {
+      if (seenDivider) {
+        const lastGroupIndex = groupSizes.length - 1;
+        const lastGroupSize = groupSizes[lastGroupIndex];
+        if (lastGroupSize !== undefined) {
+          groupSizes[lastGroupIndex] = lastGroupSize + 1;
+        }
+      } else {
+        ungroupedCount += 1;
+      }
+    }
   }
 
-  if (meta.kind === "video") {
-    const posterAttr = meta.poster
-      ? ` poster="${escapeHtml(meta.poster)}"`
-      : "";
-    return `<figure data-jant-node="attachment" data-jant-kind="video">
-  <script type="application/json" data-jant-meta>${metaJson}</script>
-  <video controls preload="metadata"${posterAttr}>
-    <source src="${escapeHtml(src)}" type="${escapeHtml(meta.mimeType)}">
-  </video>
-  ${caption}
-</figure>`;
-  }
+  const hasGroups = groupSizes.length > 0;
+  const maxGroupIndex = Math.max(0, groupSizes.length - 1);
+  const groupWidth = hasGroups
+    ? Math.max(1, maxGroupIndex.toString(36).length)
+    : 0;
+  const ungroupedItemWidth = Math.max(
+    2,
+    String(Math.max(0, ungroupedCount - 1)).length,
+  );
 
-  if (meta.kind === "audio") {
-    return `<figure data-jant-node="attachment" data-jant-kind="audio">
-  <script type="application/json" data-jant-meta>${metaJson}</script>
-  <audio controls preload="metadata" src="${escapeHtml(src)}"></audio>
-  ${caption}
-</figure>`;
+  const labels: string[] = [];
+  let groupIndex = -1;
+  let itemIndex = 0;
+
+  for (const item of items) {
+    if (item.type === "divider") {
+      groupIndex += 1;
+      itemIndex = 0;
+      labels.push("");
+    } else if (isContentItem(item)) {
+      if (hasGroups) {
+        const g = Math.max(0, groupIndex)
+          .toString(36)
+          .padStart(groupWidth, "0");
+        const i = itemIndex.toString(36);
+        labels.push(g + i);
+      } else {
+        labels.push(String(itemIndex).padStart(ungroupedItemWidth, "0"));
+      }
+      itemIndex += 1;
+    } else {
+      labels.push("");
+    }
   }
 
-  const description = buildAttachmentTextDescription(media);
-  const figcaption = description
-    ? `<figcaption>${escapeHtml(description)}</figcaption>`
-    : "";
-  return `<figure data-jant-node="attachment" data-jant-kind="${escapeHtml(meta.kind)}">
-  <script type="application/json" data-jant-meta>${metaJson}</script>
-  <a href="${escapeHtml(src)}">${name}</a>
-  ${figcaption}
-</figure>`;
+  return labels;
 }
 
-function buildAttachmentTextDescription(media: Media): string {
-  if (media.mediaKind === "text") {
-    const summary = media.summary?.trim();
-    if (summary) return summary;
-    if (media.chars) return `${media.chars} chars`;
-  }
+function buildExportedCollectionDirectoryItems(
+  items: readonly ExportCollectionDirectorySourceItem[],
+  collectionSlugMap: Map<string, string>,
+  collectionMetrics: Map<string, ExportedCollectionMetrics>,
+): ExportedCollectionDirectoryItem[] {
+  const sequenceLabels = computeCollectionDirectorySequenceLabels(items);
+  const exportedItems: ExportedCollectionDirectoryItem[] = [];
+
+  items.forEach((item, index) => {
+    if (item.type === "divider") {
+      exportedItems.push({
+        type: "divider",
+        label: item.label ?? null,
+      });
+      return;
+    }
 
-  if (media.summary?.trim()) {
-    return media.summary.trim();
-  }
+    if (item.type === "link") {
+      if (!item.label || !item.url) {
+        return;
+      }
 
-  return media.mimeType;
-}
+      const description = item.description?.trim();
+      exportedItems.push({
+        type: "link",
+        sequence: sequenceLabels[index] ?? "",
+        label: item.label,
+        url: item.url,
+        descriptionHtml: description ? renderMarkdown(description) : null,
+      });
+      return;
+    }
 
-function buildAttachmentMeta(
-  media: Media,
-  siteConfig: SiteConfig,
-  textAttachmentContent?: TextAttachmentContent,
-): AttachmentExportMeta {
-  if (media.mimeType === "text/x-tiptap+json") {
-    if (!textAttachmentContent) {
-      throw new Error(
-        `Text attachment ${media.id} content is unavailable for export`,
-      );
+    const collection = item.collection;
+    if (!collection?.id) {
+      return;
     }
 
-    return {
-      kind: media.mediaKind,
-      mimeType: media.mimeType,
-      originalName: media.originalName,
-      size: media.size,
-      width: media.width,
-      height: media.height,
-      alt: media.alt,
-      position: media.position,
-      blurhash: media.blurhash,
-      waveform: media.waveform,
-      summary: media.summary,
-      chars: media.chars,
-      contentFormat: textAttachmentContent.contentFormat,
-      content: textAttachmentContent.content,
-    };
+    const slug = collectionSlugMap.get(collection.id) ?? collection.slug;
+    if (!slug) {
+      return;
+    }
+    const metrics = collectionMetrics.get(collection.id);
+    const activityTimestamp =
+      metrics?.recentActivityAt ?? collection.recentActivityAt;
+
+    const collectionDescription = collection.description?.trim();
+    exportedItems.push({
+      type: "collection",
+      sequence: sequenceLabels[index] ?? "",
+      slug,
+      title: collection.title || slug,
+      descriptionHtml: collectionDescription
+        ? renderMarkdown(collectionDescription)
+        : null,
+      entryCount:
+        metrics?.postCount ??
+        (typeof collection.postCount === "number"
+          ? collection.postCount
+          : undefined),
+      recentActivityLabel: formatCollectionActivityLabel(activityTimestamp),
+      recentActivityIso: formatCollectionActivityIso(activityTimestamp),
+    });
+  });
+
+  return exportedItems;
+}
+
+function buildExportedCollectionMetrics(
+  collections: readonly Collection[],
+  posts: readonly Post[],
+  collectionsByPost: ReadonlyMap<string, readonly Collection[]>,
+): Map<string, ExportedCollectionMetrics> {
+  const metrics = new Map<string, ExportedCollectionMetrics>();
+
+  for (const collection of collections) {
+    metrics.set(collection.id, {
+      postCount: 0,
+      recentActivityAt: collection.updatedAt,
+    });
   }
 
-  const publicUrl = getPublicUrlForProvider(
-    media.provider,
-    siteConfig.r2PublicUrl,
-    siteConfig.s3PublicUrl,
-    siteConfig.localPublicUrl,
-  );
-
-  return {
-    kind: media.mediaKind,
-    src: getMediaUrl(media.storageKey, publicUrl, siteConfig.sitePathPrefix),
-    poster: media.posterKey
-      ? getMediaUrl(media.posterKey, publicUrl, siteConfig.sitePathPrefix)
-      : null,
-    mimeType: media.mimeType,
-    originalName: media.originalName,
-    size: media.size,
-    width: media.width,
-    height: media.height,
-    alt: media.alt,
-    position: media.position,
-    blurhash: media.blurhash,
-    waveform: media.waveform,
-    summary: media.summary,
-    chars: media.chars,
-  };
-}
-
-async function buildTextAttachmentContentMap(
-  mediaByPost: Map<string, Media[]>,
-  mediaService: Pick<MediaService, "getTextAttachmentContent">,
-  storage?: StorageDriver | null,
-): Promise<Map<string, TextAttachmentContent>> {
-  const textAttachments = [...mediaByPost.values()]
-    .flat()
-    .filter((media) => media.mimeType === "text/x-tiptap+json");
+  for (const post of posts) {
+    if (post.deletedAt !== null) {
+      continue;
+    }
+    // Drafts and private posts are excluded — they won't reach Hugo.
+    if (post.status === "draft" || post.visibility === "private") {
+      continue;
+    }
+    // Replies roll up into their thread root for directory metrics.
+    if (post.replyToId !== null) {
+      continue;
+    }
 
-  if (textAttachments.length === 0) {
-    return new Map();
-  }
+    const activityAt =
+      post.lastActivityAt ??
+      post.publishedAt ??
+      post.updatedAt ??
+      post.createdAt;
+    const postCollections = collectionsByPost.get(post.id) ?? [];
+
+    for (const collection of postCollections) {
+      const current = metrics.get(collection.id);
+      if (!current) {
+        continue;
+      }
 
-  const contents = await Promise.all(
-    textAttachments.map(async (media) => {
-      const content = await mediaService.getTextAttachmentContent(
-        media.id,
-        storage,
-      );
-      if (!content) {
-        throw new Error(
-          `Text attachment ${media.id} content is unavailable for export`,
+      if (current.postCount === 0) {
+        current.recentActivityAt = activityAt;
+      } else {
+        current.recentActivityAt = Math.max(
+          current.recentActivityAt,
+          activityAt,
         );
       }
-      return [media.id, content] as const;
-    }),
-  );
+      current.postCount += 1;
+    }
+  }
 
-  return new Map(contents);
+  return metrics;
 }
 
-function escapeCommentAttribute(value: string): string {
-  return value
-    .replace(/\\/g, "\\\\")
-    .replace(/"/g, '\\"')
-    .replace(/\n/g, "\\n");
-}
+// ---------------------------------------------------------------------------
+// Nav item resolution
+// ---------------------------------------------------------------------------
 
-function safeJsonForHtml(value: unknown): string {
-  return JSON.stringify(value)
-    .replace(/</g, "\\u003c")
-    .replace(/>/g, "\\u003e")
-    .replace(/&/g, "\\u0026");
+/**
+ * System nav items on the main site store an empty `label` in the DB and
+ * resolve their display text at render time through i18n
+ * (`getNavItemDisplayLabel`). The Hugo export has no i18n runtime, so fall
+ * back to these English defaults when serializing to `data/jant.toml`.
+ * Users can still override by setting a custom label on the nav item.
+ */
+const SYSTEM_NAV_FALLBACK_LABELS: Record<string, string> = {
+  latest: "Latest",
+  featured: "Featured",
+  collections: "Collections",
+  archive: "Archive",
+  rss: "RSS",
+  settings: "Settings",
+};
+
+function resolveNavItemLabel(item: SiteConfig["navItems"][number]): string {
+  if (item.label) return item.label;
+  if (item.systemKey) {
+    const fallback = SYSTEM_NAV_FALLBACK_LABELS[item.systemKey];
+    if (fallback) return fallback;
+  }
+  return item.label;
 }
 
-function buildConfigToml(
-  config: SiteConfig,
-  iconAssets: SiteIconAssets,
+/**
+ * Resolve a nav item's final href for the Hugo export.
+ *
+ * Mirrors the runtime logic in `lib/view.ts:toNavItemView`. System URLs
+ * stored in the DB ("/latest", "/featured") are not real routes — they get
+ * rewritten to "/" when they match `homeDefaultView`, otherwise they
+ * resolve to the dedicated path.
+ *
+ * The "rss" system nav item points at whichever Atom feed the site has
+ * configured as its main feed: `mainRssFeed === "featured"` → the featured
+ * section feed at `/featured/index.xml`, otherwise the home feed at
+ * `/index.xml` (which mirrors the homepage's "latest" timeline).
+ */
+function resolveNavItemUrl(
+  item: SiteConfig["navItems"][number],
+  homeDefaultView: string,
+  mainRssFeed: string,
 ): string {
-  const footerHtml = config.siteFooter ? renderMarkdown(config.siteFooter) : "";
-  const parts = [
-    `base_url = "${escapeToml(config.siteUrl || "https://example.com")}"`,
-    `title = "${escapeToml(config.siteName)}"`,
-    `description = "${escapeToml(config.siteDescription)}"`,
-    `default_language = "${escapeToml(config.siteLanguage)}"`,
-    "generate_feeds = true",
-    "compile_sass = false",
+  if (item.systemKey === "latest") {
+    return homeDefaultView === "latest" ? "/" : "/latest/";
+  }
+  if (item.systemKey === "featured") {
+    return homeDefaultView === "featured" ? "/" : "/featured/";
+  }
+  if (item.systemKey === "collections") return "/collections/";
+  if (item.systemKey === "archive") return "/archive/";
+  if (item.systemKey === "rss") {
+    return mainRssFeed === "featured" ? "/featured/index.xml" : "/index.xml";
+  }
+  return item.url;
+}
+
+// ---------------------------------------------------------------------------
+// hugo.toml + data TOMLs
+// ---------------------------------------------------------------------------
+
+/** Escape a string for use inside a TOML double-quoted value. */
+function escapeTomlString(value: string): string {
+  return value
+    .replace(/\\/g, "\\\\")
+    .replace(/"/g, '\\"')
+    .replace(/\r/g, "\\r")
+    .replace(/\n/g, "\\n");
+}
+
+function buildHugoToml(config: SiteConfig): string {
+  const baseUrl = (config.siteUrl || "https://example.com").replace(/\/+$/, "");
+  // Hugo requires language codes to be all lowercase (it rejects the BCP-47
+  // casing `zh-Hant` / `zh-Hans` with "must be all lower case and no spaces").
+  const language = config.siteLanguage.toLowerCase();
+  const parts: string[] = [
+    `baseURL = "${escapeTomlString(baseUrl)}/"`,
+    `title = "${escapeTomlString(config.siteName)}"`,
+    `languageCode = "${escapeTomlString(language)}"`,
+    `defaultContentLanguage = "${escapeTomlString(language)}"`,
+    'theme = "jant"',
+    `paginate = ${config.pageSize}`,
+    "enableRobotsTXT = true",
+    // Disable Hugo's built-in taxonomies — jant has no tags or categories
+    // and the default empty /tags/ and /categories/ pages are noise. This
+    // must stay at the root (before any `[table]` header) so TOML doesn't
+    // nest it under the previous table.
+    "disableKinds = ['taxonomy', 'term']",
+    "",
+    "[permalinks]",
+    '  post = "/:slug/"',
+    "",
+    "[markup]",
+    "  [markup.goldmark]",
+    "    [markup.goldmark.renderer]",
+    "      unsafe = true",
     "",
-    'feed_filenames = ["atom.xml"]',
+    // Emit an Atom 2005 feed at the site root (/index.xml). Per-section
+    // feeds (featured, archive, each collection) are opted in via each
+    // section's front matter `outputs: ["html", "rss"]` — enabling RSS on
+    // `section` globally here would also create a feed at every root post's
+    // URL, since root posts are themselves branch bundles / sections.
+    // Override the built-in RSS output format to emit Atom instead of
+    // RSS 2.0 so the wire format mirrors the main site's `lib/feed.ts`.
+    "[outputs]",
+    '  home = ["html", "rss"]',
+    // Hugo's default for sections is ["html", "rss"] — without overriding
+    // it here every root post (which is a section) would get its own
+    // /{slug}/index.xml. Turn sections off by default and re-enable RSS
+    // on just featured, archive, and each collection via per-section
+    // front matter `outputs: ["html", "rss"]`.
+    '  section = ["html"]',
     "",
-    "[extra.jant_export]",
+    "[outputFormats]",
+    "  [outputFormats.RSS]",
+    '    mediaType = "application/atom+xml"',
+    '    baseName = "index"',
+    // Use text/template (not html/template) so Hugo doesn't HTML-escape
+    // the XML prologue, CDATA markers, or tag literals. Every dynamic
+    // value inside the template passes through `transform.XMLEscape`.
+    "    isPlainText = true",
+    '    rel = "alternate"',
+    "",
+    "[mediaTypes]",
+    '  [mediaTypes."application/atom+xml"]',
+    '    suffixes = ["xml"]',
+    "",
+    "[params]",
+    `  description = "${escapeTomlString(config.siteDescription)}"`,
+    `  home_default_view = "${escapeTomlString(config.homeDefaultView)}"`,
+    `  main_rss_feed = "${escapeTomlString(config.mainRssFeed)}"`,
+    `  show_jant_branding_on_home = ${config.showJantBrandingOnHome}`,
+    `  show_header_avatar = ${config.showHeaderAvatar}`,
+    `  noindex = ${config.noindex}`,
+    `  theme_id = "${escapeTomlString(config.themeId)}"`,
+    `  default_theme_id = "${escapeTomlString(config.defaultThemeId)}"`,
+    `  font_theme_id = "${escapeTomlString(config.fontThemeId)}"`,
+    `  theme_mode = "${escapeTomlString(config.themeMode)}"`,
+    `  page_size = ${config.pageSize}`,
+    `  archive_page_size = ${config.archivePageSize}`,
+    `  rss_feed_limit = ${config.rssFeedLimit}`,
+  ];
+  if (config.siteAvatarUrl) {
+    parts.push(
+      `  site_avatar_url = "${escapeTomlString(config.siteAvatarUrl)}"`,
+    );
+  }
+  if (config.faviconVersion) {
+    parts.push(
+      `  favicon_version = "${escapeTomlString(config.faviconVersion)}"`,
+    );
+  }
+
+  return `${parts.join("\n")}\n`;
+}
+
+function buildJantDataToml(
+  config: SiteConfig,
+  iconAssets: SiteIconAssets,
+  directoryItems: readonly ExportedCollectionDirectoryItem[],
+): string {
+  const footerHtml = config.siteFooter ? renderMarkdown(config.siteFooter) : "";
+  const parts: string[] = [
     'format = "jant-site"',
     "version = 1",
-    `generated_at = "${escapeToml(toISOString(Math.floor(Date.now() / 1000)))}"`,
-    "",
-    "[extra.jant]",
-    `home_default_view = "${escapeToml(config.homeDefaultView)}"`,
-    `header_nav_max_visible = ${config.headerNavMaxVisible}`,
+    `generated_at = "${escapeTomlString(toISOString(Math.floor(Date.now() / 1000)))}"`,
+    `site_name = "${escapeTomlString(config.siteName)}"`,
+    `site_description = "${escapeTomlString(config.siteDescription)}"`,
+    `site_language = "${escapeTomlString(config.siteLanguage)}"`,
+    `home_default_view = "${escapeTomlString(config.homeDefaultView)}"`,
+    `main_rss_feed = "${escapeTomlString(config.mainRssFeed)}"`,
     `show_jant_branding_on_home = ${config.showJantBrandingOnHome}`,
     `show_header_avatar = ${config.showHeaderAvatar}`,
     `noindex = ${config.noindex}`,
     `site_avatar_mode = "${config.siteAvatarUrl ? "custom" : "none"}"`,
     `favicon_mode = "${iconAssets.faviconMode}"`,
     `apple_touch_mode = "${iconAssets.appleTouchMode}"`,
-    "nav_exported = true",
-    `theme_id = "${escapeToml(config.themeId || config.defaultThemeId)}"`,
-    `default_theme_id = "${escapeToml(config.defaultThemeId)}"`,
-    `font_theme_id = "${escapeToml(config.fontThemeId)}"`,
-    `theme_mode = "${escapeToml(config.themeMode)}"`,
+    `theme_id = "${escapeTomlString(config.themeId)}"`,
+    `default_theme_id = "${escapeTomlString(config.defaultThemeId)}"`,
+    `font_theme_id = "${escapeTomlString(config.fontThemeId)}"`,
+    `theme_mode = "${escapeTomlString(config.themeMode)}"`,
+    `page_size = ${config.pageSize}`,
+    `archive_page_size = ${config.archivePageSize}`,
+    `rss_feed_limit = ${config.rssFeedLimit}`,
+    'favicon_path = "/favicon.ico"',
+    'apple_touch_icon_path = "/apple-touch-icon.png"',
   ];
-
   if (config.siteAvatarUrl) {
-    parts.push(`site_avatar_url = "${escapeToml(config.siteAvatarUrl)}"`);
+    parts.push(`site_avatar_url = "${escapeTomlString(config.siteAvatarUrl)}"`);
   }
   if (config.faviconVersion) {
-    parts.push(`favicon_version = "${escapeToml(config.faviconVersion)}"`);
+    parts.push(
+      `favicon_version = "${escapeTomlString(config.faviconVersion)}"`,
+    );
   }
   if (footerHtml) {
-    parts.push(`site_footer_html = "${escapeToml(footerHtml)}"`);
+    parts.push(`site_footer_html = "${escapeTomlString(footerHtml)}"`);
   }
   if (config.siteFooter) {
-    parts.push(`site_footer_markdown = "${escapeToml(config.siteFooter)}"`);
+    parts.push(
+      `site_footer_markdown = "${escapeTomlString(config.siteFooter)}"`,
+    );
   }
 
   for (const item of config.navItems) {
+    // `settings` is authenticated-only and has no corresponding page in the
+    // static Hugo site — drop it at export time so it never shows up in nav.
+    if (item.systemKey === "settings") continue;
     parts.push("");
-    parts.push("[[extra.jant.nav]]");
-    parts.push(`type = "${escapeToml(item.type)}"`);
-    parts.push(`label = "${escapeToml(item.label)}"`);
-    parts.push(`url = "${escapeToml(item.url)}"`);
-    if (item.systemKey) {
-      parts.push(`system_key = "${escapeToml(item.systemKey)}"`);
-    }
+    parts.push("[[nav]]");
+    parts.push(`type = "${escapeTomlString(item.type)}"`);
+    parts.push(`label = "${escapeTomlString(resolveNavItemLabel(item))}"`);
+    parts.push(
+      `url = "${escapeTomlString(resolveNavItemUrl(item, config.homeDefaultView, config.mainRssFeed))}"`,
+    );
+    parts.push(`system_key = "${escapeTomlString(item.systemKey ?? "")}"`);
+    parts.push(`placement = "${escapeTomlString(item.placement ?? "header")}"`);
   }
 
-  parts.push("");
-  parts.push("[[taxonomies]]");
-  parts.push('name = "c"');
-  parts.push("feed = true");
-  parts.push("");
-  parts.push("[markdown]");
-  parts.push("highlight_code = true");
-  parts.push('highlight_theme = "css"');
+  for (const item of directoryItems) {
+    parts.push("");
+    parts.push("[[directory]]");
+    parts.push(`type = "${escapeTomlString(item.type)}"`);
+    if (item.type === "collection") {
+      parts.push(`sequence = "${escapeTomlString(item.sequence)}"`);
+      parts.push(`slug = "${escapeTomlString(item.slug)}"`);
+      parts.push(`title = "${escapeTomlString(item.title)}"`);
+      if (item.descriptionHtml) {
+        parts.push(
+          `description_html = "${escapeTomlString(item.descriptionHtml)}"`,
+        );
+      }
+      if (typeof item.entryCount === "number") {
+        parts.push(`entry_count = ${item.entryCount}`);
+      }
+      if (item.recentActivityLabel) {
+        parts.push(
+          `recent_activity_label = "${escapeTomlString(item.recentActivityLabel)}"`,
+        );
+      }
+      if (item.recentActivityIso) {
+        parts.push(
+          `recent_activity_iso = "${escapeTomlString(item.recentActivityIso)}"`,
+        );
+      }
+    } else if (item.type === "divider") {
+      if (item.label !== null) {
+        parts.push(`label = "${escapeTomlString(item.label)}"`);
+      }
+    } else {
+      parts.push(`sequence = "${escapeTomlString(item.sequence)}"`);
+      parts.push(`label = "${escapeTomlString(item.label)}"`);
+      parts.push(`url = "${escapeTomlString(item.url)}"`);
+      if (item.descriptionHtml) {
+        parts.push(
+          `description_html = "${escapeTomlString(item.descriptionHtml)}"`,
+        );
+      }
+    }
+  }
 
-  return `${parts.join("\n")}
-`;
+  return `${parts.join("\n")}\n`;
 }
 
-function buildRootSection(): string {
-  return `+++
-sort_by = "date"
-paginate_by = 20
-+++
-`;
-}
+// ---------------------------------------------------------------------------
+// README + .gitignore
+// ---------------------------------------------------------------------------
+
+function buildGitignore(): string {
+  return `# Hugo build output
+public/
+resources/
+.hugo_build.lock
+
+# OS
+.DS_Store
+Thumbs.db
 
-function buildArchiveSection(): string {
-  return `+++
-title = "Archive"
-template = "archive.html"
-+++
+# Editors
+.vscode/
+.idea/
+*.swp
 `;
 }
 
 function buildReadme(siteName: string): string {
-  return `# ${siteName} — Zola Export
+  return `# ${siteName} — Hugo Export
 
-This is a static site exported from [Jant](https://github.com/jant-me/jant), ready to build with [Zola](https://www.getzola.org/).
+This is a static site exported from [Jant](https://github.com/jant-me/jant), ready to build with [Hugo](https://gohugo.io/).
 
-## Install Zola
+## Install Hugo
+
+This export targets Hugo **extended 0.160.1+**.
 
 **macOS (Homebrew):**
 
 \`\`\`sh
-brew install zola
+brew install hugo
 \`\`\`
 
 **Windows (Scoop):**
 
 \`\`\`sh
-scoop install zola
+scoop install hugo-extended
 \`\`\`
 
-**Linux (Snap):**
-
-\`\`\`sh
-snap install zola --edge
-\`\`\`
+**Linux:**
 
-Or download a binary from <https://github.com/getzola/zola/releases>.
+Download the extended build from <https://github.com/gohugoio/hugo/releases>.
 
-See the [Zola installation docs](https://www.getzola.org/documentation/getting-started/installation/) for more options.
+See the [Hugo installation docs](https://gohugo.io/installation/) for more options.
 
 ## Quick start
 
 Preview locally:
 
 \`\`\`sh
-zola serve
+hugo serve
 \`\`\`
 
-Then open <http://127.0.0.1:1111> in your browser.
+Then open <http://localhost:1313> in your browser.
 
 Build the site for deployment:
 
 \`\`\`sh
-zola build
+hugo --minify
 \`\`\`
 
 The output goes to the \`public/\` directory. Upload it to any static host (Netlify, Vercel, Cloudflare Pages, GitHub Pages, etc.).
@@ -866,1886 +1644,61 @@ The output goes to the \`public/\` directory. Upload it to any static host (Netl
 ## Project structure
 
 \`\`\`
-config.toml          — Site configuration (title, URL, language)
+hugo.toml                 — Site configuration (baseURL, title, theme, params)
 content/
-  _index.md          — Root section (homepage settings)
-  {slug}/index.md    — Individual posts (threads are merged into one page)
-  c/{slug}/_index.md — Collection display metadata for taxonomy pages and round-trip import
-templates/           — Tera templates (Zola's template engine)
-static/
-  style.css          — Base exported stylesheet
-  theme.css          — Resolved Jant theme variables
-  custom.css         — Exported custom CSS overrides
-  favicon.ico        — Exported site favicon (custom or default fallback)
-  apple-touch-icon.png — Exported Apple touch icon (custom or default fallback)
+  _index.md               — Home section
+  archive/_index.md       — Archive section
+  collections/_index.md   — Collections directory section
+  featured/_index.md      — Featured section
+  {slug}/
+    _index.md             — Thread root (branch bundle)
+    {reply-slug}/
+      index.md            — Reply (leaf bundle, not rendered as its own URL)
+data/
+  jant.toml               — Nav items, branding, display preferences, ordered collections directory
+themes/jant/              — Bundled Hugo theme (overrideable via layouts/ at the site root)
+static/                   — Copy files here to add them to the published site
 \`\`\`
 
 ## Customizing
 
-- **Site settings** — edit \`config.toml\` to change the title, URL, or language.
-- **Jant metadata** — \`config.toml\` stores \`[extra.jant_export]\` and \`[extra.jant]\` for round-trip import.
-- **Styles** — edit \`static/style.css\`. The theme supports light and dark modes via \`prefers-color-scheme\`.
-- **Templates** — edit files in \`templates/\`. Zola uses the [Tera](https://keats.github.io/tera/) template engine.
-- **Debugging** — export to a directory with \`jant site export --directory ./my-site\`, then run \`cd my-site && zola serve\`.
-- **Collections** — posts are tagged with collections via the \`c\` taxonomy. Browse them at \`/c/\`.
-
-## Notes
-
-- The raw export API only writes content files. The CLI localizes media by default unless you pass \`--no-localize-media\`.
-- Thread replies are merged into the root post as a single page. Reply metadata is preserved in HTML comments (\`<!-- jant:reply ... -->\`).
-- Attachments are preserved as Jant HTML blocks (\`data-jant-node="attachments"\`). Text attachments embed canonical Markdown in the block metadata, while the rendered preview is display-only and ignored by \`jant site import\`.
-- Posts with \`draft: true\` in front matter are only built when you pass the \`--drafts\` flag to \`zola build\` or \`zola serve\`.
-`;
-}
-
-// ---------------------------------------------------------------------------
-// Zola theme templates
-// ---------------------------------------------------------------------------
-
-const DECORATIVE_QUOTE_MARK_SVG = `<span class="decorative-quote-mark feed-quote-mark" aria-hidden="true">
-  <svg viewBox="0 0 96 96" role="presentation" focusable="false">
-    <path fill="currentColor" d="M24.4 10.5C16.9 17.7 11.5 26.8 8.2 37.7C4.9 48.7 4.8 58.9 7.8 68.2C10.3 75.7 15.4 79.5 22.9 79.5C28 79.5 32.2 77.8 35.4 74.2C38.6 70.7 40.2 66.5 40.2 61.4C40.2 56.5 38.8 52.6 36 49.6C33.3 46.6 29.7 45.1 25.2 45.1C23.4 45.1 21.8 45.3 20.2 45.8C22.2 37.3 26.7 29.2 33.6 21.4L24.4 10.5Z" />
-    <path fill="currentColor" d="M60.8 10.5C53.3 17.7 47.9 26.8 44.6 37.7C41.3 48.7 41.2 58.9 44.2 68.2C46.7 75.7 51.8 79.5 59.3 79.5C64.4 79.5 68.6 77.8 71.8 74.2C75 70.7 76.6 66.5 76.6 61.4C76.6 56.5 75.2 52.6 72.4 49.6C69.7 46.6 66.1 45.1 61.6 45.1C59.8 45.1 58.2 45.3 56.6 45.8C58.6 37.3 63.1 29.2 70 21.4L60.8 10.5Z" />
-  </svg>
-</span>`;
-
-const TEMPLATE_BASE = `<!DOCTYPE html>
-<html lang="{{ config.default_language }}" data-theme-mode="{{ config.extra.jant.theme_mode | default(value='auto') }}">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>{% block title %}{{ config.title }}{% endblock %}</title>
-  {% if config.description %}
-  <meta name="description" content="{{ config.description }}">
-  {% endif %}
-  {% if config.extra.jant.noindex %}
-  <meta name="robots" content="noindex, nofollow">
-  {% endif %}
-  {% set favicon_href = get_url(path='favicon.ico') %}
-  {% set apple_touch_href = get_url(path='apple-touch-icon.png') %}
-  {% if config.extra.jant.favicon_version %}
-  <link rel="icon" href="{{ favicon_href }}?v={{ config.extra.jant.favicon_version }}" sizes="16x16 32x32">
-  <link rel="apple-touch-icon" href="{{ apple_touch_href }}?v={{ config.extra.jant.favicon_version }}">
-  {% else %}
-  <link rel="icon" href="{{ favicon_href }}" sizes="16x16 32x32">
-  <link rel="apple-touch-icon" href="{{ apple_touch_href }}">
-  {% endif %}
-  <link rel="stylesheet" href="{{ get_url(path='style.css') }}">
-  <link rel="stylesheet" href="{{ get_url(path='theme.css') }}">
-  <link rel="stylesheet" href="{{ get_url(path='custom.css') }}">
-  <link rel="alternate" type="application/atom+xml" title="{{ config.title }}" href="{{ get_url(path='atom.xml') }}">
-</head>
-<body>
-  <div class="site-page">
-    <header class="site-header">
-      <div class="site-header-inner">
-        <div class="{% block header_top_class %}site-header-top site-header-top-bordered{% endblock %}">
-          <a href="{{ config.base_url }}" class="site-logo">
-            {% if config.extra.jant.show_header_avatar and config.extra.jant.site_avatar_url %}
-            <img src="{{ config.extra.jant.site_avatar_url }}" class="site-logo-avatar" alt="">
-            {% endif %}
-            <span>{{ config.title }}</span>
-          </a>
-          <div class="site-header-right">
-            <nav class="site-header-nav" aria-label="Primary">
-              {% if config.extra.jant.nav and config.extra.jant.nav | length > 0 %}
-                {% for item in config.extra.jant.nav %}
-                  {% if item.system_key == "settings" %}
-                  {% elif item.system_key == "collections" %}
-                <a href="{{ get_url(path='c') }}" class="site-header-link">{{ item.label }}</a>
-                  {% elif item.system_key == "rss" %}
-                <a href="{{ get_url(path='atom.xml') }}" class="site-header-link">{{ item.label }}</a>
-                  {% elif item.system_key == "archive" %}
-                <a href="{{ get_url(path='archive') }}" class="site-header-link">{{ item.label }}</a>
-                  {% else %}
-                <a href="{{ item.url }}" class="site-header-link">{{ item.label }}</a>
-                  {% endif %}
-                {% endfor %}
-              {% else %}
-              <a href="{{ config.base_url }}/c/" class="site-header-link">Collections</a>
-              <a href="{{ get_url(path='atom.xml') }}" class="site-header-link">RSS</a>
-              {% endif %}
-            </nav>
-          </div>
-        </div>
-      </div>
-    </header>
-
-    <main class="site-main">
-      <div class="site-container">
-        <div class="{% block site_content_class %}site-content{% endblock %}">
-          {% block content %}{% endblock %}
-        </div>
-      </div>
-    </main>
-
-    {% if config.extra.jant.site_footer_html %}
-    <footer class="site-footer" data-footer>
-      <div class="site-container">
-        <div class="prose">{{ config.extra.jant.site_footer_html | safe }}</div>
-      </div>
-    </footer>
-    {% endif %}
-  </div>
-</body>
-</html>
-`;
-
-const TEMPLATE_INDEX = `{% extends "base.html" %}
-{% import "macros.html" as macros %}
-
-{% block title %}{{ config.title }}{% endblock %}
-{% block header_top_class %}site-header-top site-header-top-bordered site-header-top-home{% endblock %}
-{% block site_content_class %}site-content site-content-home{% endblock %}
-
-{% block content %}
-<div data-page="home">
-  {% if paginator.current_index > 1 %}
-  <p class="page-context-label">Page {{ paginator.current_index }}</p>
-  {% endif %}
-  <div data-feed>
-    <div id="timeline-feed">
-      <div id="timeline-items">
-        {% for page in paginator.pages %}
-          {% if page.extra.visibility | default(value="public") != "latest_hidden" %}
-          <div class="feed-item" data-timeline-item data-timeline-item-content>
-            {% if not loop.first %}<hr class="feed-divider">{% endif %}
-            {{ macros::post_card(page=page) }}
-          </div>
-          {% endif %}
-        {% endfor %}
-      </div>
-    </div>
-  </div>
-
-  {% if paginator.previous or paginator.next %}
-  <nav class="pagination" aria-label="Pagination">
-    <div class="pagination-side">
-      {% if paginator.previous %}
-      <a href="{{ paginator.previous }}" class="pagination-link">&larr; Previous</a>
-      {% endif %}
-    </div>
-    <div class="pagination-center">
-      {% if paginator.number_pagers > 1 %}
-      <span class="pagination-label">Page {{ paginator.current_index }} of {{ paginator.number_pagers }}</span>
-      {% endif %}
-    </div>
-    <div class="pagination-side pagination-side-end">
-      {% if paginator.next %}
-      <a href="{{ paginator.next }}" class="pagination-link">Next &rarr;</a>
-      {% endif %}
-    </div>
-  </nav>
-  {% endif %}
-
-  {% if config.extra.jant.show_jant_branding_on_home %}
-  <footer class="home-branding-credit">
-    ${HOME_BRANDING_PREFIX}
-    <a href="${JANT_REPO_URL}" target="_blank" rel="noopener noreferrer">
-      ${buildJantLogoSvgMarkup("positive")}
-      <span>${HOME_BRANDING_LINK_LABEL}</span>
-    </a>
-  </footer>
-  {% endif %}
-</div>
-{% endblock %}
-`;
-
-const TEMPLATE_PAGE = `{% extends "base.html" %}
-{% import "macros.html" as macros %}
+- **Site settings** — edit \`hugo.toml\` to change the baseURL, title, or pagination.
+- **Jant metadata** — \`data/jant.toml\` drives nav and the collections directory, and is preserved across round-trip import.
+- **Styles** — edit \`themes/jant/static/main.css\`, or drop a \`static/main.css\` at the site root to override.
+- **Templates** — add files under \`layouts/\` at the site root to override the bundled theme.
+- **Debugging** — from a Jant site project, run \`npx jant site export --directory ./my-site\`, then \`cd my-site && hugo serve\`.
 
-{% block title %}{% if page.title %}{{ page.title }} &mdash; {% endif %}{{ config.title }}{% endblock %}
+## Fetching media locally
 
-{% block content %}
-<div data-page="post">
-  {{ macros::post_card(page=page, detail=true) }}
-</div>
-{% endblock %}
-`;
-
-const TEMPLATE_SECTION = `{% extends "base.html" %}
-{% import "macros.html" as macros %}
-
-{% block title %}{{ section.title }} &mdash; {{ config.title }}{% endblock %}
-
-{% block content %}
-<div class="section-shell">
-  <header class="section-header">
-    <h1 class="section-title">{{ section.title }}</h1>
-    {% if section.description %}
-    <p class="section-description">{{ section.description }}</p>
-    {% endif %}
-  </header>
-
-  <div data-feed>
-    <div id="timeline-feed">
-      <div id="timeline-items">
-        {% for page in section.pages %}
-          {% if page.extra.visibility | default(value="public") != "latest_hidden" %}
-          <div class="feed-item" data-timeline-item data-timeline-item-content>
-            {% if not loop.first %}<hr class="feed-divider">{% endif %}
-            {{ macros::post_card(page=page) }}
-          </div>
-          {% endif %}
-        {% endfor %}
-      </div>
-    </div>
-  </div>
-</div>
-{% endblock %}
-`;
+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.
 
-const TEMPLATE_ARCHIVE = `{% extends "base.html" %}
-
-{% block title %}Archive &mdash; {{ config.title }}{% endblock %}
-
-{% block content %}
-{% set root = get_section(path="_index.md") %}
-<div class="section-shell archive-shell">
-  <header class="section-header">
-    <h1 class="section-title">Archive</h1>
-    <p class="section-description">Every exported post in one chronological list.</p>
-  </header>
-
-  <div class="archive-list">
-    {% for year, year_pages in root.pages | group_by(attribute="year") %}
-      {% for month, month_pages in year_pages | group_by(attribute="month") %}
-    <section class="archive-month-group">
-      <header class="archive-month-heading">
-        {{ month_pages[0].date | date(format="%B %Y") }}
-      </header>
-        {% for page in month_pages %}
-          {% if page.extra.visibility | default(value="public") == "public" %}
-          {% set archive_title = page.title | default(value="") %}
-          {% if archive_title == "" %}
-            {% set archive_title = page.extra.summary_text | default(value="") %}
-          {% endif %}
-          {% if archive_title == "" %}
-            {% set archive_title = page.summary | default(value=page.content) | striptags | trim %}
-          {% endif %}
-          <article class="archive-entry">
-            <time class="archive-entry-date" datetime="{{ page.date }}">
-              {{ page.date | date(format="%b %e, %Y") }}
-            </time>
-            <div class="archive-entry-main">
-              <a href="{{ page.permalink }}" class="archive-entry-title">
-                {{ archive_title | default(value="Untitled") | truncate(length=92) }}
-              </a>
-              <div class="archive-entry-meta">
-                <span class="archive-entry-format">{{ page.extra.format | default(value="note") }}</span>
-                {% set collections = page.taxonomies.c | default(value=[]) %}
-                {% for col in collections %}
-                {% set col_meta = get_section(path='c/' ~ col ~ '/_index.md') %}
-                <a href="{{ get_taxonomy_url(kind='c', name=col) }}" class="archive-entry-tag">{{ col_meta.title | default(value=col) }}</a>
-                {% endfor %}
-              </div>
-            </div>
-          </article>
-          {% endif %}
-        {% endfor %}
-    </section>
-      {% endfor %}
-    {% endfor %}
-  </div>
-</div>
-{% endblock %}
-`;
+To download every referenced media file into \`static/media/\` and rewrite the references to local paths, run this from the root of the export:
 
-const TEMPLATE_TAXONOMY_LIST = `{% extends "base.html" %}
-
-{% block title %}Collections &mdash; {{ config.title }}{% endblock %}
-
-{% block content %}
-<div class="section-shell">
-  <header class="section-header">
-    <h1 class="section-title">Collections</h1>
-    <p class="section-description">Browse exported posts by collection.</p>
-  </header>
-  <ol class="collection-list">
-    {% for term in terms %}
-    {% set term_meta = get_section(path='c/' ~ term.name ~ '/_index.md') %}
-    {% set latest_page = term.pages | first %}
-    <li class="collection-list-item">
-      <a href="{{ term.permalink }}" class="collection-list-link">
-        <span class="collection-list-sequence" aria-hidden="true"></span>
-        <span class="collection-list-content">
-          <span class="collection-list-title">{{ term_meta.title | default(value=term.name) }}</span>
-          <span class="collection-list-meta">
-            <span>{{ term.pages | length }} entries</span>
-            {% if latest_page %}
-            <span>Updated {{ latest_page.updated | default(value=latest_page.date) | date(format="%Y-%m-%d") }}</span>
-            {% endif %}
-          </span>
-        </span>
-      </a>
-    </li>
-    {% endfor %}
-  </ol>
-</div>
-{% endblock %}
-`;
-
-const TEMPLATE_TAXONOMY_SINGLE = `{% extends "base.html" %}
-{% import "macros.html" as macros %}
-
-{% block title %}{% set term_meta = get_section(path='c/' ~ term.name ~ '/_index.md') %}{{ term_meta.title | default(value=term.name) }} &mdash; {{ config.title }}{% endblock %}
-
-{% block content %}
-{% set term_meta = get_section(path='c/' ~ term.name ~ '/_index.md') %}
-<div class="section-shell">
-  <header class="section-header">
-    <h1 class="section-title">{{ term_meta.title | default(value=term.name) }}</h1>
-    {% if term_meta.description %}
-    <p class="section-description">{{ term_meta.description }}</p>
-    {% endif %}
-  </header>
-  <div data-feed>
-    <div id="timeline-feed">
-      <div id="timeline-items">
-        {% for page in term.pages %}
-          {% if page.extra.visibility | default(value="public") != "latest_hidden" %}
-          <div class="feed-item" data-timeline-item data-timeline-item-content>
-            {% if not loop.first %}<hr class="feed-divider">{% endif %}
-            {{ macros::post_card(page=page) }}
-          </div>
-          {% endif %}
-        {% endfor %}
-      </div>
-    </div>
-  </div>
-</div>
-{% endblock %}
-`;
+\`\`\`sh
+npx @jant/core site pull-media --path .
+\`\`\`
 
-const TEMPLATE_ATOM = `<?xml version="1.0" encoding="utf-8"?>
-<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="{{ lang }}">
-  <title>{% if section is defined and section.title %}{{ section.title }} · {% elif term is defined and taxonomy.name == "c" %}{% set term_meta = get_section(path='c/' ~ term.name ~ '/_index.md') %}{{ term_meta.title | default(value=term.name) }} · {% elif term is defined and term.name %}{{ term.name }} · {% endif %}{{ config.title }}</title>
-  {% if config.description %}
-  <subtitle>{{ config.description }}</subtitle>
-  {% endif %}
-  <link rel="self" type="application/atom+xml" href="{{ feed_url | safe }}" />
-  <link rel="alternate" type="text/html" href="{% if section is defined %}{{ section.permalink }}{% elif term is defined %}{{ term.permalink }}{% else %}{{ config.base_url }}{% endif %}" />
-  <id>{{ feed_url | safe }}</id>
-  {% if last_updated is defined %}
-  <updated>{{ last_updated | date(format="%+") }}</updated>
-  {% else %}
-  <updated>{{ config.extra.jant_export.generated_at | default(value="1970-01-01T00:00:00Z") }}</updated>
-  {% endif %}
-  {% set author_name = config.author | default(value="") %}
-  {% if author_name %}
-  <author><name>{{ author_name }}</name></author>
-  {% endif %}
-  {% for page in pages %}
-    {% if page.extra.visibility | default(value="public") == "public" %}
-  <entry>
-    {% set entry_title = page.title | default(value="") %}
-    {% set entry_summary = page.extra.summary_text | default(value="") %}
-    {% if entry_summary == "" %}
-      {% set entry_summary = page.summary | default(value=page.content) | striptags | trim %}
-    {% endif %}
-    {% if entry_summary == "" %}
-      {% set entry_summary = page.permalink %}
-    {% endif %}
-    <title>{{ entry_title }}</title>
-    <link rel="alternate" type="text/html" href="{{ page.permalink | safe }}" />
-    <published>{{ page.date | date(format="%+") }}</published>
-    <updated>{{ page.updated | default(value=page.date) | date(format="%+") }}</updated>
-    <id>{{ page.permalink | safe }}</id>
-    <summary type="text">{{ entry_summary }}</summary>
-    <content type="html">&lt;p&gt;{{ entry_summary }}&lt;/p&gt;</content>
-  </entry>
-    {% endif %}
-  {% endfor %}
-</feed>
-`;
+Safe to re-run; files already on disk are reused. Anything that fails to download keeps its original URL so the site still builds.
 
-// ---------------------------------------------------------------------------
-// Shared macro — single post card used by all list/detail templates
-// ---------------------------------------------------------------------------
+## Notes
 
-const TEMPLATE_MACROS = `{% macro post_status_badges() %}
-<div class="post-status-badges">
-  <span class="post-status-badge post-status-pinned">
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">
-      <line x1="12" x2="12" y1="17" y2="22" />
-      <path d="M5 17h14v-1.76a2 2 0 0 0-1.11-1.79l-1.78-.9A2 2 0 0 1 15 10.76V6h1a2 2 0 0 0 0-4H8a2 2 0 0 0 0 4h1v4.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24Z" />
-    </svg>
-    Pinned
-  </span>
-  <span class="post-status-badge post-status-private">
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">
-      <path d="M10.733 5.076a10.744 10.744 0 0 1 11.205 6.575 1 1 0 0 1 0 .696 10.747 10.747 0 0 1-1.444 2.49" />
-      <path d="M14.084 14.158a3 3 0 0 1-4.242-4.242" />
-      <path d="M17.479 17.499a10.75 10.75 0 0 1-15.417-5.151 1 1 0 0 1 0-.696 10.75 10.75 0 0 1 4.446-5.143" />
-      <path d="m2 2 20 20" />
-    </svg>
-    Private
-  </span>
-</div>
-{% endmacro %}
-
-{% macro post_rating(page) %}
-{% if page.extra.rating %}
-<div class="post-rating" aria-label="{{ page.extra.rating }} out of 5">
-  {% for i in range(end=5) %}
-  <span class="{% if i < page.extra.rating %}post-star-filled{% else %}post-star-empty{% endif %}">★</span>
-  {% endfor %}
-</div>
-{% endif %}
-{% endmacro %}
-
-{% macro post_footer(page, detail=false) %}
-{% set collections = page.taxonomies.c | default(value=[]) %}
-<footer class="post-menu-footer{% if detail %} post-footer-detail{% endif %}" data-post-meta>
-  <div class="post-footer-meta">
-    <span class="post-footer-featured" title="Featured">
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.35" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
-        <path d="${FEATURED_SPARKLE_PATH}" />
-      </svg>
-      <span class="sr-only">Featured</span>
-    </span>
-    <a href="{{ page.permalink }}" class="u-url post-date-link">
-      <time class="dt-published" datetime="{{ page.date }}" title="{{ page.date }}">
-        {{ page.date | date(format="%b %e, %Y") }}
-      </time>
-    </a>
-    {% if page.extra.format == "link" and page.extra.link_url %}
-    <a href="{{ page.extra.link_url }}" class="post-footer-external-link" target="_blank" rel="noopener noreferrer" aria-label="Open external link">
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-        <path d="M7 17 17 7" />
-        <path d="M9 7h8v8" />
-      </svg>
-    </a>
-    {% endif %}
-    {% if collections | length > 0 %}
-    {% set first_collection = collections | first %}
-    {% set first_collection_meta = get_section(path='c/' ~ first_collection ~ '/_index.md') %}
-    {% set hidden_collection_count = collections | length %}
-    <span class="post-collection-tags">
-      <span class="post-collection-sep" aria-hidden="true">&middot;</span>
-      <a href="{{ get_taxonomy_url(kind='c', name=first_collection) }}" class="post-collection-tag">{{ first_collection_meta.title | default(value=first_collection) }}</a>
-      {% if hidden_collection_count > 1 %}
-      <span class="post-collection-more-wrap">
-        <button type="button" class="post-collection-more" aria-haspopup="menu" data-collection-popover-trigger>
-          and {{ hidden_collection_count - 1 }} more
-        </button>
-        <span class="post-collection-popover" role="menu" data-collection-popover>
-          {% for col in collections %}
-          {% if not loop.first %}
-          {% set col_meta = get_section(path='c/' ~ col ~ '/_index.md') %}
-          <a href="{{ get_taxonomy_url(kind='c', name=col) }}" class="post-collection-popover-item" role="menuitem">{{ col_meta.title | default(value=col) }}</a>
-          {% endif %}
-          {% endfor %}
-        </span>
-      </span>
-      {% endif %}
-    </span>
-    {% endif %}
-  </div>
-</footer>
-{% endmacro %}
-
-{% macro note_card(page, detail=false) %}
-<article
-  class="h-entry post-menu-target {% if detail %}post-detail-shell{% else %}post-card-shell{% endif %}"
-  {% if detail %}data-page="post"{% endif %}
-  data-post
-  data-format="note"
-  data-post-permalink="{{ page.permalink }}"
-  {% if page.title %}data-post-has-title{% endif %}
-  {% if page.extra.pinned %}data-post-pinned{% endif %}
-  {% if page.extra.featured %}data-post-featured{% endif %}
-  data-post-visibility="{{ page.extra.visibility | default(value='public') }}"
->
-  {{ self::post_status_badges() }}
-  {% if page.title %}
-    {% if detail %}
-    <div class="post-header-block">
-      <h1 class="p-name detail-title">{{ page.title }}</h1>
-      {{ self::post_rating(page=page) }}
-    </div>
-    {% else %}
-    <h2 class="p-name feed-note-title">
-      <a href="{{ page.permalink }}" class="u-url post-title-link">{{ page.title }}</a>
-    </h2>
-    {% endif %}
-  {% endif %}
-  {% if detail and page.content %}
-  <div class="e-content prose" data-post-body>{{ page.content | safe }}</div>
-  {% elif not detail and page.summary %}
-  <div class="e-content prose {% if page.title %}post-body-summary{% endif %}" data-post-body>{{ page.summary | safe }}</div>
-  {% elif page.content %}
-  <div class="e-content prose {% if page.title and not detail %}post-body-summary{% endif %}" data-post-body>{{ page.content | safe }}</div>
-  {% endif %}
-  {% if not detail or not page.title %}
-  {{ self::post_rating(page=page) }}
-  {% endif %}
-  {{ self::post_footer(page=page, detail=detail) }}
-</article>
-{% endmacro %}
-
-{% macro link_card(page, detail=false) %}
-<article
-  class="h-entry post-menu-target {% if detail %}post-detail-shell post-detail-link{% else %}feed-link-post{% endif %}"
-  {% if detail %}data-page="post"{% endif %}
-  data-post
-  data-format="link"
-  data-post-permalink="{{ page.permalink }}"
-  {% if page.title %}data-post-has-title{% endif %}
-  {% if page.extra.pinned %}data-post-pinned{% endif %}
-  {% if page.extra.featured %}data-post-featured{% endif %}
-  data-post-visibility="{{ page.extra.visibility | default(value='public') }}"
->
-  {% if not detail %}
-  <div class="feed-card feed-card-link">
-  {% endif %}
-  {{ self::post_status_badges() }}
-  {% if page.extra.link_url %}
-  <a href="{{ page.extra.link_url }}" class="feed-link-domain" rel="noopener noreferrer" target="_blank">
-    <svg class="feed-link-domain-icon" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor">
-      <path d="M13.5 6H5.25A2.25 2.25 0 0 0 3 8.25v10.5A2.25 2.25 0 0 0 5.25 21h10.5A2.25 2.25 0 0 0 18 18.75V10.5m-10.5 6L21 3m0 0h-5.25M21 3v5.25" />
-    </svg>
-    <span>{{ page.extra.link_url | split(pat='//') | nth(n=1) | split(pat='/') | first }}</span>
-  </a>
-  {% endif %}
-  {% if page.title %}
-    {% if detail %}
-    <div class="post-header-block">
-      <h1 class="p-name detail-title feed-link-title">
-        <a href="{{ page.extra.link_url | default(value=page.permalink) }}" class="u-url feed-link-title-link" {% if page.extra.link_url %}target="_blank" rel="noopener noreferrer"{% endif %}>{{ page.title }}</a>
-      </h1>
-      {{ self::post_rating(page=page) }}
-    </div>
-    {% else %}
-    <h2 class="p-name feed-link-title">
-      <a href="{{ page.extra.link_url | default(value=page.permalink) }}" class="u-url feed-link-title-link" {% if page.extra.link_url %}target="_blank" rel="noopener noreferrer"{% endif %}>{{ page.title }}</a>
-    </h2>
-    {% endif %}
-  {% endif %}
-  {% if detail and page.content %}
-  <div class="e-content prose feed-link-summary" data-post-body>{{ page.content | safe }}</div>
-  {% elif not detail and page.summary %}
-  <div class="e-content prose feed-link-summary" data-post-body>{{ page.summary | safe }}</div>
-  {% elif page.content %}
-  <div class="e-content prose feed-link-summary" data-post-body>{{ page.content | safe }}</div>
-  {% endif %}
-  {% if not detail or not page.title %}
-  {{ self::post_rating(page=page) }}
-  {% endif %}
-  {% if not detail %}
-  </div>
-  {% endif %}
-  {{ self::post_footer(page=page, detail=detail) }}
-</article>
-{% endmacro %}
-
-{% macro quote_card(page, detail=false) %}
-<article
-  class="h-entry post-menu-target feed-quote-post {% if detail %}post-detail-shell{% endif %}"
-  {% if detail %}data-page="post"{% endif %}
-  data-post
-  data-format="quote"
-  data-post-permalink="{{ page.permalink }}"
-  {% if page.extra.pinned %}data-post-pinned{% endif %}
-  {% if page.extra.featured %}data-post-featured{% endif %}
-  data-post-visibility="{{ page.extra.visibility | default(value='public') }}"
->
-  {{ self::post_status_badges() }}
-  {% if page.extra.quote_text %}
-  <blockquote class="feed-quote feed-quote-card">
-    ${DECORATIVE_QUOTE_MARK_SVG}
-    <div class="e-content feed-quote-content">{{ page.extra.quote_text }}</div>
-  </blockquote>
-  {% endif %}
-  {% if page.extra.source_name or page.extra.source_url %}
-  <div class="feed-quote-attribution">
-    {% if page.extra.source_url %}
-    <a href="{{ page.extra.source_url }}" class="feed-quote-source" target="_blank" rel="noopener noreferrer">
-      {{ page.extra.source_name | default(value=page.extra.source_url | split(pat='//') | nth(n=1) | split(pat='/') | first) }}
-    </a>
-    {% else %}
-    <span>{{ page.extra.source_name }}</span>
-    {% endif %}
-  </div>
-  {% endif %}
-  {% if detail and page.content %}
-  <div class="feed-quote-commentary prose" data-post-body>{{ page.content | safe }}</div>
-  {% elif not detail and page.summary %}
-  <div class="feed-quote-commentary prose" data-post-body>{{ page.summary | safe }}</div>
-  {% elif page.content %}
-  <div class="feed-quote-commentary prose" data-post-body>{{ page.content | safe }}</div>
-  {% endif %}
-  {{ self::post_rating(page=page) }}
-  {{ self::post_footer(page=page, detail=detail) }}
-</article>
-{% endmacro %}
-
-{% macro post_card(page, detail=false) %}
-{% if page.extra.format == "link" %}
-{{ self::link_card(page=page, detail=detail) }}
-{% elif page.extra.format == "quote" %}
-{{ self::quote_card(page=page, detail=detail) }}
-{% else %}
-{{ self::note_card(page=page, detail=detail) }}
-{% endif %}
-{% endmacro %}
+- 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.
+- \`/{reply-slug}/\` URLs are preserved via \`aliases:\` on the root post, so old links still land on the right thread anchor.
+- 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.
+- Posts with \`draft: true\` in front matter are only built when you pass \`--buildDrafts\` to \`hugo\` / \`hugo serve\`.
 `;
+}
 
 // ---------------------------------------------------------------------------
-// CSS — Jant "Organic Minimalism" approximation
+// Re-exports for consumers (kept so existing entry points compile)
 // ---------------------------------------------------------------------------
 
-const STYLE_CSS = `/* Jant Export Theme */
-
-:root {
-  color-scheme: light;
-  --site-width: 500px;
-  --font-cjk-serif-fallback:
-    "Songti SC", STSong, SimSun, "Songti TC", PMingLiU, MingLiU,
-    "Noto Serif SC", "Noto Serif CJK SC", "Noto Serif TC", "Noto Serif CJK TC";
-  --font-body:
-    system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
-    "Helvetica Neue", Helvetica, Arial, "PingFang TC", "PingFang SC",
-    "Hiragino Sans CNS", "Hiragino Sans GB", "Microsoft JhengHei",
-    "Microsoft YaHei", "Noto Sans CJK TC", "Noto Sans CJK SC", sans-serif;
-  --font-heading:
-    "New York Small", "New York", "Iowan Old Style", Charter,
-    "Bitstream Charter", "Source Serif 4", Cambria, "Sitka Text", Georgia,
-    var(--font-cjk-serif-fallback), ui-serif, serif;
-  --font-site-title:
-    "New York Small", "New York", "Iowan Old Style", Charter,
-    "Bitstream Charter", "Source Serif 4", Cambria, "Sitka Text", Georgia,
-    var(--font-cjk-serif-fallback), ui-serif, serif;
-  --font-serif:
-    var(--font-cjk-serif-fallback), ui-serif, "New York Small", "New York",
-    "Iowan Old Style", Charter, Georgia, "Times New Roman", Times, serif;
-  --font-mono:
-    ui-monospace, Menlo, Monaco, Consolas, "Cascadia Code", "Courier New",
-    monospace;
-  --fw-regular: 400;
-  --fw-medium: 500;
-  --fw-semibold: 600;
-  --text-sm: 0.8125rem;
-  --text-base: 0.9375rem;
-  --feed-note-title-size: 1.25rem;
-  --feed-note-title-leading: 1.3;
-  --type-body-size: var(--text-base);
-  --type-body-leading: 1.66;
-  --type-body-tracking: 0.002em;
-  --type-heading-weight: var(--fw-medium);
-  --type-heading-leading: 1.26;
-  --type-heading-tracking: -0.02em;
-  --type-display-leading: 1.04;
-  --type-label-weight: var(--fw-medium);
-  --type-label-tracking: 0.08em;
-  --site-padding: 1.5rem;
-  --content-gap: 1rem;
-  --space-xl: 2rem;
-  --avatar-size: 28px;
-  --avatar-radius: 50%;
-  --media-radius: 0.5rem;
-  --background: oklch(0.975 0.015 92);
-  --foreground: oklch(0.29 0.01 70);
-  --card: oklch(0.975 0.015 92);
-  --primary: oklch(0.3633 0.0697 159.95);
-  --primary-foreground: oklch(0.985 0.008 92);
-  --muted: oklch(0.942 0.014 96);
-  --muted-foreground: oklch(0.52 0.008 70);
-  --accent: oklch(0.942 0.014 96);
-  --border: oklch(0.892 0.014 98);
-  --site-accent: oklch(0.4406 0.0568 159.95);
-  --site-accent-text: var(--primary-foreground);
-  --site-page-bg: var(--background);
-  --site-elevated-bg: var(--background);
-  --site-nav-hover-bg: var(--accent);
-  --site-text-primary: var(--foreground);
-  --site-text-secondary: var(--muted-foreground);
-  --site-text-placeholder: oklch(from var(--muted-foreground) l c h / 0.5);
-  --site-divider: var(--border);
-  --site-feed-card-bg: color-mix(
-    in srgb,
-    var(--site-elevated-bg) 88%,
-    var(--site-nav-hover-bg)
-  );
-  --site-feed-card-border: color-mix(
-    in srgb,
-    var(--site-divider) 78%,
-    transparent
-  );
-  --site-feed-card-shadow: color-mix(
-    in srgb,
-    var(--site-text-primary) 12%,
-    transparent
-  );
-  --site-feed-divider-color: color-mix(
-    in srgb,
-    var(--site-text-secondary) 30%,
-    transparent
-  );
-}
-
-@media (prefers-color-scheme: dark) {
-  :root:not([data-theme-mode="light"]) {
-    color-scheme: dark;
-    --background: oklch(0.182 0.003 95);
-    --foreground: oklch(0.895 0.006 88);
-    --card: oklch(0.182 0.003 95);
-    --primary: oklch(0.6966 0.0528 159.95);
-    --primary-foreground: oklch(0.17 0.003 95);
-    --muted: oklch(0.238 0.003 95);
-    --muted-foreground: oklch(0.67 0.005 88);
-    --accent: oklch(0.238 0.003 95);
-    --border: oklch(0.305 0.003 95);
-    --site-accent: oklch(0.7306 0.0478 159.95);
-  }
-}
-
-*,
-*::before,
-*::after {
-  box-sizing: border-box;
-}
-
-html {
-  font-size: 16px;
-  background-color: var(--site-page-bg);
-  color: var(--site-text-primary);
-}
-
-body {
-  margin: 0;
-  font-family: var(--font-body);
-  font-size: var(--type-body-size);
-  line-height: var(--type-body-leading);
-  letter-spacing: var(--type-body-tracking);
-  color: var(--site-text-primary);
-  background: var(--site-page-bg);
-  text-rendering: optimizeLegibility;
-  -webkit-font-smoothing: antialiased;
-}
-
-a {
-  color: inherit;
-  text-decoration-thickness: 1px;
-  text-underline-offset: 3px;
-}
-
-img,
-svg,
-video {
-  display: block;
-  max-width: 100%;
-}
-
-img {
-  height: auto;
-}
-
-.site-page {
-  min-height: 100vh;
-  min-height: 100dvh;
-  background-color: var(--site-page-bg);
-}
-
-.site-header {
-  max-width: var(--site-width);
-  margin: 0 auto;
-  padding: 24px var(--site-padding) 0;
-}
-
-.site-header-inner {
-  display: flex;
-  flex-direction: column;
-  align-items: flex-start;
-}
-
-.site-header-top {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 0.85rem;
-  flex-wrap: wrap;
-  min-height: 2.5rem;
-  width: 100%;
-}
-
-.site-header-top-bordered {
-  padding-bottom: 15px;
-  border-bottom: 0.5px solid
-    color-mix(in srgb, var(--site-divider) 72%, transparent);
-}
-
-.site-header-top-home {
-  border-bottom-color: color-mix(in srgb, var(--site-divider) 72%, transparent);
-  padding-bottom: 14px;
-}
-
-.site-header-right {
-  display: flex;
-  align-items: center;
-  gap: 0.55rem;
-  margin-left: auto;
-  min-width: 0;
-}
-
-.site-logo {
-  display: inline-flex;
-  align-items: center;
-  gap: 10px;
-  padding: 0.15rem 0;
-  font-size: clamp(1.18rem, 1.08rem + 0.45vw, 1.34rem);
-  font-weight: var(--fw-medium);
-  font-family: var(--font-site-title);
-  letter-spacing: -0.03em;
-  color: var(--site-text-primary);
-  text-decoration: none;
-  line-height: var(--type-display-leading);
-}
-
-.site-logo-avatar {
-  width: calc(var(--avatar-size) + 2px);
-  height: calc(var(--avatar-size) + 2px);
-  border-radius: var(--avatar-radius);
-  object-fit: cover;
-  box-shadow: 0 0 0 1px color-mix(in srgb, var(--site-divider) 82%, transparent);
-}
-
-.site-header-nav {
-  display: flex;
-  align-items: center;
-  flex-wrap: wrap;
-  justify-content: flex-end;
-  gap: 1rem;
-}
-
-.site-header-link {
-  display: inline-flex;
-  align-items: center;
-  position: relative;
-  min-height: 2rem;
-  padding: 0.2rem 0 0.5rem;
-  cursor: pointer;
-  font-size: 0.84rem;
-  line-height: 1;
-  letter-spacing: 0.01em;
-  color: var(--site-text-secondary);
-  text-decoration: none;
-  transition:
-    color 0.15s,
-    opacity 0.15s;
-}
-
-.site-header-link::after {
-  content: "";
-  position: absolute;
-  right: 0;
-  bottom: 0;
-  left: 0;
-  height: 1.5px;
-  border-radius: 999px;
-  background: color-mix(in srgb, var(--site-accent) 62%, var(--site-divider));
-  opacity: 0;
-  transform: scaleX(0.52);
-  transform-origin: center;
-  transition:
-    opacity 0.18s ease,
-    transform 0.18s ease;
-}
-
-.site-header-link:hover {
-  color: var(--site-text-primary);
-  opacity: 1;
-}
-
-.site-header-link:hover::after {
-  opacity: 0.42;
-  transform: scaleX(0.82);
-}
-
-.site-container {
-  max-width: var(--site-width);
-  margin: 0 auto;
-}
-
-.site-content {
-  background-color: var(--site-elevated-bg);
-  padding: 1rem var(--site-padding) var(--space-xl);
-}
-
-.site-content-home {
-  padding-top: 0.75rem;
-  padding-bottom: calc(var(--space-xl) - 0.25rem);
-  border-bottom: 0.5px solid
-    color-mix(in srgb, var(--site-divider) 84%, transparent);
-}
-
-.site-home-header {
-  display: flex;
-  flex-direction: column;
-  gap: 0.15rem;
-  margin-bottom: var(--space-xl);
-}
-
-.site-browse-nav {
-  display: flex;
-  align-items: baseline;
-  flex-wrap: wrap;
-  gap: 0.55rem;
-  padding: 14px 0 4px;
-}
-
-.site-browse-link {
-  font-size: var(--text-base);
-  font-weight: var(--fw-regular);
-  color: var(--site-text-primary);
-  opacity: 0.42;
-}
-
-.site-browse-link-active {
-  opacity: 1;
-  font-weight: var(--fw-medium);
-}
-
-.page-context-label {
-  margin: 0 0 1rem;
-  color: var(--site-text-secondary);
-  font-size: var(--text-sm);
-}
-
-.feed-item {
-  position: relative;
-}
-
-.site-content hr.feed-divider {
-  border: none;
-  width: 30px;
-  height: 9px;
-  margin: 2.5rem auto;
-  color: var(--site-feed-divider-color);
-  background-color: currentColor;
-  -webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 45 13'%3E%3Cpath fill='black' transform='translate(0,0) rotate(90 6 6.5)' d='M6.765.5.177 6.093l2.61 5.966 8.39-3.17L6.765.5Z'/%3E%3Cpath fill='black' transform='translate(16,0) rotate(100 6 6.5)' d='M6.765.5.177 6.093l2.61 5.966 8.39-3.17L6.765.5Z'/%3E%3Cpath fill='black' transform='translate(32,0) rotate(80 6 6.5)' d='M6.765.5.177 6.093l2.61 5.966 8.39-3.17L6.765.5Z'/%3E%3C/svg%3E");
-  mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 45 13'%3E%3Cpath fill='black' transform='translate(0,0) rotate(90 6 6.5)' d='M6.765.5.177 6.093l2.61 5.966 8.39-3.17L6.765.5Z'/%3E%3Cpath fill='black' transform='translate(16,0) rotate(100 6 6.5)' d='M6.765.5.177 6.093l2.61 5.966 8.39-3.17L6.765.5Z'/%3E%3Cpath fill='black' transform='translate(32,0) rotate(80 6 6.5)' d='M6.765.5.177 6.093l2.61 5.966 8.39-3.17L6.765.5Z'/%3E%3C/svg%3E");
-  -webkit-mask-repeat: no-repeat;
-  mask-repeat: no-repeat;
-  -webkit-mask-position: center;
-  mask-position: center;
-  -webkit-mask-size: contain;
-  mask-size: contain;
-}
-
-.post-menu-target {
-  position: relative;
-}
-
-.post-card-shell,
-.post-detail-shell {
-  position: relative;
-  padding: 0.45rem 0 0.35rem;
-}
-
-.feed-card {
-  position: relative;
-  padding: 1rem 1.1rem 0.95rem;
-  border: 1px solid color-mix(in srgb, var(--site-divider) 78%, transparent);
-  border-radius: 18px;
-  background:
-    linear-gradient(
-      180deg,
-      color-mix(in srgb, var(--site-accent) 4%, transparent),
-      transparent 58%
-    ),
-    color-mix(in srgb, var(--site-elevated-bg) 88%, var(--site-nav-hover-bg));
-  box-shadow: 0 20px 40px -36px var(--site-feed-card-shadow);
-}
-
-.feed-card-link {
-  border-radius: 14px;
-}
-
-.feed-link-post {
-  --feed-link-post-footer-inset: 0.65rem;
-  display: flex;
-  flex-direction: column;
-}
-
-.feed-link-post > .post-menu-footer {
-  margin-top: 0.5rem;
-  padding-inline: 0;
-  padding-inline-start: var(--feed-link-post-footer-inset);
-  padding-inline-end: 0.15rem;
-}
-
-.feed-link-domain {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.25rem;
-  max-width: 100%;
-  margin-bottom: 0.65rem;
-  color: var(--site-text-secondary);
-  font-size: 0.75rem;
-  font-weight: var(--type-label-weight);
-  line-height: 1;
-  letter-spacing: var(--type-label-tracking);
-  text-decoration: none;
-}
-
-.feed-link-domain-icon {
-  width: 0.72rem;
-  height: 0.72rem;
-  flex-shrink: 0;
-}
-
-.feed-link-title,
-.feed-note-title,
-.detail-title,
-.section-title,
-.p-name {
-  font-family: var(--font-heading);
-}
-
-.feed-link-title {
-  margin: 0;
-  font-size: 0.98rem;
-  font-weight: var(--type-heading-weight);
-  line-height: var(--type-heading-leading);
-  letter-spacing: var(--type-heading-tracking);
-}
-
-.feed-link-title-link,
-.post-title-link {
-  color: inherit;
-  text-decoration: none;
-}
-
-.feed-link-title-link:hover,
-.post-title-link:hover {
-  text-decoration: underline;
-}
-
-.feed-note-title {
-  margin: 0 0 0.48rem;
-  font-size: var(--feed-note-title-size);
-  line-height: var(--feed-note-title-leading);
-  letter-spacing: var(--type-heading-tracking);
-  text-wrap: pretty;
-}
-
-.post-header-block {
-  margin-bottom: 1rem;
-}
-
-.post-header-block .feed-link-title,
-.post-header-block .feed-note-title,
-.post-header-block .detail-title {
-  margin-bottom: 0;
-}
-
-.post-header-block .post-rating {
-  margin-top: 0.45rem;
-}
-
-.detail-title {
-  margin: 0 0 1rem;
-  font-size: clamp(1.56rem, 1.34rem + 1vw, 2.02rem);
-  font-weight: var(--fw-medium);
-  line-height: 1.08;
-  letter-spacing: -0.03em;
-  text-wrap: balance;
-}
-
-.feed-quote-post {
-  position: relative;
-  padding: 0.45rem 0 0.35rem;
-}
-
-.feed-quote {
-  margin: 0;
-}
-
-.feed-quote-card {
-  padding-left: 0;
-  border-left: none;
-}
-
-.decorative-quote-mark {
-  display: block;
-  line-height: 0;
-}
-
-.decorative-quote-mark svg {
-  display: block;
-  width: 100%;
-  height: auto;
-}
-
-.feed-quote-mark {
-  width: clamp(1.46rem, 1.38rem + 0.36vw, 1.76rem);
-  margin-bottom: -0.1rem;
-  margin-left: -0.04rem;
-  color: color-mix(in srgb, var(--site-accent) 14%, var(--site-divider));
-  opacity: 0.66;
-}
-
-.feed-quote-content {
-  font-family: var(--font-serif);
-  color: var(--site-text-primary);
-  font-size: clamp(1.34rem, 1.23rem + 0.44vw, 1.58rem);
-  line-height: 1.36;
-  letter-spacing: -0.02em;
-  text-wrap: pretty;
-}
-
-.feed-quote-attribution {
-  display: flex;
-  align-items: center;
-  gap: 0.45rem;
-  flex-wrap: wrap;
-  margin-top: 0.95rem;
-  color: var(--site-text-secondary);
-  font-size: 0.75rem;
-  letter-spacing: 0.08em;
-  line-height: 1.4;
-}
-
-.feed-quote-attribution::before {
-  content: "";
-  width: 0.9rem;
-  height: 1px;
-  background: color-mix(in srgb, var(--site-text-secondary) 38%, var(--site-divider));
-}
-
-.feed-quote-source {
-  color: inherit;
-  text-decoration: underline;
-  text-decoration-color: color-mix(in srgb, var(--site-text-secondary) 55%, transparent);
-}
-
-.feed-quote-commentary {
-  position: relative;
-  max-width: 34rem;
-  margin-top: 1.1rem;
-  padding-top: 0.95rem;
-  color: color-mix(in srgb, var(--site-text-secondary) 84%, var(--site-text-primary));
-}
-
-.feed-quote-commentary::before {
-  content: "";
-  position: absolute;
-  left: 0;
-  right: 0;
-  top: 0;
-  height: 1px;
-  background: linear-gradient(
-    90deg,
-    transparent 0%,
-    color-mix(in srgb, var(--site-divider) 48%, transparent) 16%,
-    color-mix(in srgb, var(--site-divider) 78%, transparent) 50%,
-    color-mix(in srgb, var(--site-divider) 48%, transparent) 84%,
-    transparent 100%
-  );
-}
-
-.post-status-badges {
-  display: none;
-  align-items: center;
-  gap: 6px;
-  margin-bottom: 4px;
-  font-size: 11px;
-  font-weight: 500;
-  letter-spacing: 0.05em;
-  text-transform: uppercase;
-  color: var(--site-text-placeholder);
-}
-
-article[data-post-pinned] .post-status-badges,
-article[data-post-visibility="private"] .post-status-badges {
-  display: flex;
-}
-
-.post-status-badge {
-  display: none;
-  align-items: center;
-  gap: 4px;
-}
-
-article[data-post-pinned] .post-status-pinned,
-article[data-post-visibility="private"] .post-status-private {
-  display: inline-flex;
-}
-
-.post-status-badge svg {
-  width: 12px;
-  height: 12px;
-}
-
-.post-footer-featured {
-  display: none;
-  align-items: center;
-  justify-content: center;
-  color: color-mix(in srgb, var(--search-mark-color) 72%, var(--site-text-secondary));
-  --icon-stroke: 1.35;
-  flex-shrink: 0;
-}
-
-article[data-post-featured] .post-footer-featured {
-  display: inline-flex;
-}
-
-.post-footer-featured svg {
-  width: 1.12rem;
-  height: 1.12rem;
-  opacity: 0.88;
-}
-
-[data-page="featured"] article[data-post-featured] .post-footer-featured {
-  display: none;
-}
-
-.sr-only {
-  position: absolute;
-  width: 1px;
-  height: 1px;
-  padding: 0;
-  margin: -1px;
-  overflow: hidden;
-  clip: rect(0, 0, 0, 0);
-  white-space: nowrap;
-  border: 0;
-}
-
-.prose {
-  max-width: 35rem;
-  font-size: var(--type-body-size);
-  line-height: var(--type-body-leading);
-  letter-spacing: var(--type-body-tracking);
-  color: var(--site-text-primary);
-}
-
-.post-body-summary {
-  color: color-mix(in srgb, var(--site-text-secondary) 88%, var(--site-text-primary));
-}
-
-.prose > :first-child {
-  margin-top: 0;
-}
-
-.prose > :last-child {
-  margin-bottom: 0;
-}
-
-.prose p {
-  margin: 0;
-}
-
-.prose p + p,
-.prose ul,
-.prose ol,
-.prose blockquote,
-.prose pre,
-.prose table,
-.prose figure {
-  margin-top: 1.05rem;
-}
-
-.prose :is(h1, h2, h3, h4) {
-  margin: 1.25rem 0 0.35rem;
-  font-family: var(--font-heading);
-  font-weight: var(--type-heading-weight);
-  line-height: var(--type-heading-leading);
-  letter-spacing: var(--type-heading-tracking);
-}
-
-.prose ul,
-.prose ol {
-  padding-left: 1.3rem;
-}
-
-.prose li {
-  margin: 0.2rem 0;
-}
-
-.prose blockquote {
-  padding-left: 0.95rem;
-  border-left: 2px solid color-mix(in srgb, var(--site-divider) 75%, transparent);
-  color: var(--site-text-secondary);
-}
-
-.prose code {
-  font-family: var(--font-mono);
-  font-size: 0.875em;
-  background: color-mix(in srgb, var(--site-nav-hover-bg) 80%, transparent);
-  padding: 0.1rem 0.35rem;
-  border-radius: 0.32rem;
-}
-
-.prose pre {
-  overflow-x: auto;
-  padding: 0.9rem 1rem;
-  border-radius: 14px;
-  border: 1px solid color-mix(in srgb, var(--site-divider) 82%, transparent);
-  background: color-mix(in srgb, var(--site-nav-hover-bg) 78%, transparent);
-}
-
-.prose pre code {
-  background: transparent;
-  padding: 0;
-}
-
-.prose table {
-  width: 100%;
-  border-collapse: collapse;
-  font-size: var(--text-sm);
-}
-
-.prose th,
-.prose td {
-  border: 1px solid color-mix(in srgb, var(--site-divider) 86%, transparent);
-  padding: 0.45rem 0.7rem;
-  text-align: left;
-}
-
-.prose th {
-  background: color-mix(in srgb, var(--site-nav-hover-bg) 74%, transparent);
-}
-
-.prose img,
-.prose video {
-  width: 100%;
-  border-radius: var(--media-radius);
-}
-
-.prose figure[data-jant-node="image"] {
-  margin-inline: 0;
-}
-
-.prose figcaption {
-  margin-top: 0.55rem;
-  color: var(--site-text-secondary);
-  font-size: var(--text-sm);
-}
-
-[data-jant-node="attachments"] {
-  display: grid;
-  gap: 0.85rem;
-  margin-top: 1rem;
-}
-
-[data-jant-node="attachment"] {
-  margin: 0;
-  padding: 0.95rem;
-  border: 1px solid color-mix(in srgb, var(--site-divider) 84%, transparent);
-  border-radius: 16px;
-  background: color-mix(in srgb, var(--site-nav-hover-bg) 66%, transparent);
-}
-
-[data-jant-node="attachment"] > script[data-jant-meta] {
-  display: none;
-}
-
-[data-jant-node="attachment"][data-jant-kind="image"] {
-  padding: 0;
-  overflow: hidden;
-  background: transparent;
-}
-
-[data-jant-node="attachment"] audio,
-[data-jant-node="attachment"] video {
-  width: 100%;
-}
-
-[data-jant-node="attachment"] > a {
-  display: inline-flex;
-  font-weight: var(--fw-medium);
-  text-decoration: none;
-}
-
-[data-jant-node="attachment"][data-jant-kind="text"] details {
-  width: 100%;
-}
-
-[data-jant-node="attachment"][data-jant-kind="text"] summary {
-  cursor: pointer;
-  font-weight: var(--fw-medium);
-}
-
-.jant-attachment-text-preview {
-  margin-top: 0.85rem;
-}
-
-.jant-attachment-text-preview > :first-child {
-  margin-top: 0;
-}
-
-.jant-attachment-text-preview > :last-child {
-  margin-bottom: 0;
-}
-
-.post-rating {
-  display: flex;
-  gap: 1px;
-  margin-top: 8px;
-  font-size: 14px;
-  line-height: 1;
-}
-
-.post-star-filled {
-  color: oklch(0.75 0.15 70);
-}
-
-.post-star-empty {
-  color: var(--site-divider);
-}
-
-.post-menu-footer {
-  display: flex;
-  justify-content: flex-start;
-  align-items: center;
-  margin-top: 0.9rem;
-}
-
-.post-footer-detail {
-  margin-top: 1.35rem;
-  padding-top: 1rem;
-  border-top: 1px solid color-mix(in srgb, var(--site-divider) 86%, transparent);
-}
-
-.post-footer-meta {
-  display: flex;
-  align-items: center;
-  gap: 5px;
-  flex-wrap: wrap;
-  line-height: 1.35;
-  min-width: 0;
-}
-
-.post-date-link {
-  color: var(--site-text-secondary);
-  text-decoration: none;
-  font-size: 13px;
-  white-space: nowrap;
-  flex-shrink: 0;
-}
-
-.post-date-link:hover {
-  color: var(--site-text-primary);
-  text-decoration: underline;
-}
-
-.post-footer-detail .post-date-link {
-  font-size: inherit;
-}
-
-.post-footer-external-link {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  width: 0.9rem;
-  height: 0.9rem;
-  color: var(--site-text-secondary);
-  flex-shrink: 0;
-}
-
-.post-footer-external-link svg {
-  width: 0.82rem;
-  height: 0.82rem;
-}
-
-.post-collection-tags {
-  display: inline-flex;
-  align-items: center;
-  gap: 4px;
-  font-size: 13px;
-  min-width: 0;
-  max-width: 100%;
-  flex: 1 1 auto;
-}
-
-.post-collection-sep {
-  color: var(--site-text-secondary);
-}
-
-.post-collection-tag {
-  display: inline-block;
-  color: var(--site-text-secondary);
-  text-decoration: none;
-  min-width: 0;
-  max-width: min(100%, 22ch);
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-
-.post-collection-tag:hover {
-  color: var(--site-text-primary);
-  text-decoration: underline;
-}
-
-.post-collection-more-wrap {
-  position: relative;
-  display: inline-flex;
-  align-items: center;
-  flex-shrink: 0;
-}
-
-.post-collection-more-wrap::after {
-  content: "";
-  position: absolute;
-  top: 100%;
-  left: -6px;
-  right: -6px;
-  height: 10px;
-}
-
-.post-collection-more {
-  display: inline-flex;
-  align-items: center;
-  background: none;
-  border: none;
-  padding: 0;
-  font: inherit;
-  font-size: inherit;
-  color: var(--site-text-secondary);
-  text-decoration: underline dotted;
-  text-underline-offset: 2px;
-  cursor: pointer;
-}
-
-.post-collection-more-wrap:hover .post-collection-more,
-.post-collection-more-wrap:focus-within .post-collection-more {
-  color: var(--site-text-primary);
-}
-
-.post-collection-popover {
-  display: none;
-  position: absolute;
-  top: calc(100% + 4px);
-  left: 0;
-  z-index: 50;
-  flex-direction: column;
-  min-width: 160px;
-  padding: 4px;
-  border-radius: 6px;
-  background: var(--site-elevated-bg);
-  border: 1px solid var(--site-divider);
-  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.08);
-}
-
-.post-collection-more-wrap:hover .post-collection-popover,
-.post-collection-more-wrap:focus-within .post-collection-popover {
-  display: flex;
-}
-
-.post-collection-popover-item {
-  display: flex;
-  align-items: center;
-  gap: 6px;
-  padding: 6px 8px;
-  border-radius: 4px;
-  font-size: 12px;
-  color: var(--site-text-secondary);
-  text-decoration: none;
-}
-
-.post-collection-popover-item:hover {
-  background: var(--site-nav-hover-bg);
-  color: var(--site-text-primary);
-}
-
-.section-shell {
-  display: flex;
-  flex-direction: column;
-  gap: 1.15rem;
-}
-
-.section-header {
-  display: flex;
-  flex-direction: column;
-  gap: 0.45rem;
-}
-
-.section-title {
-  margin: 0;
-  font-size: clamp(1.45rem, 1.3rem + 0.5vw, 1.85rem);
-  font-weight: var(--fw-medium);
-  line-height: 1.12;
-  letter-spacing: -0.03em;
-}
-
-.section-description {
-  margin: 0;
-  max-width: 38rem;
-  color: var(--site-text-secondary);
-}
-
-.collection-list {
-  margin: 0;
-  padding: 0;
-  list-style: none;
-  counter-reset: collection-list;
-}
-
-.collection-list-item {
-  counter-increment: collection-list;
-  border-top: 1px solid color-mix(in srgb, var(--site-divider) 84%, transparent);
-}
-
-.collection-list-link {
-  display: grid;
-  grid-template-columns: 3.5ch minmax(0, 1fr);
-  gap: 0.8rem;
-  align-items: start;
-  padding: 0.95rem 0;
-  text-decoration: none;
-}
-
-.collection-list-link:hover .collection-list-title {
-  text-decoration: underline;
-}
-
-.collection-list-link:hover .collection-list-sequence {
-  color: var(--site-text-primary);
-}
-
-.collection-list-sequence {
-  display: block;
-  width: 3.5ch;
-  padding-top: 0.2rem;
-  font-family: var(--font-mono);
-  font-size: 0.68rem;
-  font-variant-numeric: tabular-nums;
-  line-height: 1.18;
-  letter-spacing: 0.14em;
-  color: var(--site-text-secondary);
-  transition: color 0.15s ease;
-}
-
-.collection-list-sequence::before {
-  content: counter(collection-list, decimal-leading-zero);
-}
-
-.collection-list-content {
-  min-width: 0;
-  display: flex;
-  flex-direction: column;
-  gap: 0.28rem;
-}
-
-.collection-list-title {
-  min-width: 0;
-  display: inline-flex;
-  align-items: center;
-  gap: 0.45rem;
-  font-family: var(--font-heading);
-  font-size: clamp(1rem, 1.5vw, 1.12rem);
-  font-weight: var(--fw-medium);
-  line-height: 1.18;
-  letter-spacing: -0.01em;
-}
-
-.collection-list-meta {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 0.5rem 1rem;
-  color: var(--site-text-secondary);
-  font-size: var(--text-sm);
-}
-
-.archive-shell {
-  gap: 1.35rem;
-}
-
-.archive-list {
-  display: grid;
-  gap: 0;
-}
-
-.archive-month-group + .archive-month-group {
-  margin-top: 1.35rem;
-}
-
-.archive-month-heading {
-  margin: 0 0 0.45rem;
-  color: var(--site-text-secondary);
-  font-size: 0.82rem;
-  font-weight: var(--fw-medium);
-  letter-spacing: 0.08em;
-  text-transform: uppercase;
-}
-
-.archive-entry {
-  display: grid;
-  grid-template-columns: minmax(6.75rem, auto) minmax(0, 1fr);
-  gap: 0.9rem 1.25rem;
-  align-items: start;
-  padding: 0.9rem 0;
-  border-top: 1px solid color-mix(in srgb, var(--site-divider) 84%, transparent);
-}
-
-.archive-entry:first-child {
-  border-top: none;
-  padding-top: 0;
-}
-
-.archive-entry-date {
-  color: var(--site-text-secondary);
-  font-size: var(--text-sm);
-  line-height: 1.5;
-  text-decoration: none;
-}
-
-.archive-entry-main {
-  min-width: 0;
-}
-
-.archive-entry-title {
-  display: inline-block;
-  color: var(--site-text-primary);
-  font-family: var(--font-heading);
-  font-size: 1.03rem;
-  font-weight: var(--type-heading-weight);
-  line-height: 1.34;
-  letter-spacing: var(--type-heading-tracking);
-  text-decoration: none;
-  text-wrap: pretty;
-}
-
-.archive-entry-title:hover {
-  text-decoration: underline;
-}
-
-.archive-entry-meta {
-  display: flex;
-  align-items: center;
-  gap: 0.45rem;
-  flex-wrap: wrap;
-  margin-top: 0.38rem;
-  color: var(--site-text-secondary);
-  font-size: 0.72rem;
-  line-height: 1.45;
-  letter-spacing: 0.06em;
-  text-transform: uppercase;
-}
-
-.archive-entry-format {
-  opacity: 0.7;
-}
-
-.archive-entry-tag {
-  color: inherit;
-  text-decoration: none;
-  border-bottom: 0.5px solid color-mix(in srgb, var(--site-divider) 82%, transparent);
-}
-
-.archive-entry-tag:hover {
-  color: var(--site-text-primary);
-  border-bottom-color: currentColor;
-}
-
-.pagination {
-  display: grid;
-  grid-template-columns: 1fr auto 1fr;
-  align-items: center;
-  gap: 1rem;
-  padding: 2rem 0 0.5rem;
-}
-
-.pagination-side-end {
-  text-align: right;
-}
-
-.pagination-center {
-  text-align: center;
-}
-
-.pagination-link {
-  color: var(--site-text-secondary);
-  text-decoration: underline;
-}
-
-.pagination-link:hover {
-  color: var(--site-text-primary);
-}
-
-.pagination-label {
-  color: var(--site-text-secondary);
-  font-size: var(--text-sm);
-}
-
-.site-footer {
-  max-width: var(--site-width);
-  margin: var(--space-xl) auto 0;
-  padding: 0 var(--site-padding) var(--space-xl);
-  color: var(--site-text-secondary);
-  font-size: var(--text-sm);
-}
-
-.site-footer > .site-container {
-  border-top: 0.5px solid var(--site-divider);
-  padding-top: var(--content-gap);
-}
-
-.home-branding-credit {
-  margin-top: var(--space-xl);
-  text-align: center;
-  color: var(--site-text-secondary);
-  font-size: var(--text-sm);
-}
-
-.home-branding-credit a {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.38rem;
-  color: inherit;
-  text-decoration: none;
-  border-bottom: 0.5px solid
-    color-mix(in srgb, var(--site-text-secondary) 45%, transparent);
-}
-
-.home-branding-credit a svg {
-  width: 1rem;
-  height: 1rem;
-  flex: none;
-}
-
-@media (min-width: 700px) {
-  .site-header {
-    padding-top: 30px;
-  }
-
-  .site-header-top-bordered {
-    padding-bottom: 18px;
-  }
-}
-
-@media (max-width: 699px) {
-  :root {
-    --site-padding: 1.875rem;
-  }
-
-  .site-header-right {
-    width: 100%;
-    justify-content: flex-start;
-  }
-
-  .site-header-nav {
-    justify-content: flex-start;
-  }
-}
-
-@media (max-width: 640px) {
-  .archive-entry {
-    grid-template-columns: 1fr;
-    gap: 0.3rem;
-  }
-
-  .pagination {
-    grid-template-columns: 1fr;
-    gap: 0.55rem;
-  }
-
-  .pagination-side-end,
-  .pagination-center {
-    text-align: left;
-  }
-}
-`;
+export {
+  buildSiteIconAssets,
+  buildExportedCollectionMetrics,
+  buildExportedCollectionDirectoryItems,
+  readStorageObjectBytes,
+  getArchiveSummaryText,
+  getMediaUrl,
+  getPublicUrlForProvider,
+};