@dogsbay/format-astro 0.2.0-beta.92 → 0.2.0-beta.98

package/dist/base-path.d.ts

@@ -176,6 +176,16 @@ export declare function resolvePrefixes(siteUrl: string | undefined, basePath: s
  * - default basePath, empty slug → `"/docs"`
  * - empty basePath, slug "auth" → `"/auth"`
  * - empty basePath, empty slug → `"/"`
+ * - empty basePath, slug "index" → `"/"` (root home)
+ *
+ * A bare `index` slug means the directory root: `content/index.md` is
+ * deliberately loaded with slug `"index"` (so the root-home and `.md`-mirror
+ * special cases fire — see plans/dir-index-slug-nav-drop.md), but the page is
+ * served at the directory URL and its nav href drops `index` (via
+ * `fileToHref`'s `/index` strip). `currentPath` must match that nav href for
+ * `getPagination` to find the home page, so we drop a whole-slug `index` here
+ * too. Without this the home page's `currentPath` (`/base/index`) never matches
+ * its nav entry (`/base`), so prev/next silently falls back to the first item.
  */
 export declare function buildCurrentPath(basePath: string, section: string | undefined, slug: string): string;
 //# sourceMappingURL=base-path.d.ts.map

package/dist/base-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-path.d.ts","sourceRoot":"","sources":["../src/base-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKnE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,GACX,MAAM,CAMR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG;IACzD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,CAiBA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B;IACD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CASA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,GACX,MAAM,CAMR"}
+{"version":3,"file":"base-path.d.ts","sourceRoot":"","sources":["../src/base-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKnE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,GACX,MAAM,CAMR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG;IACzD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,CAiBA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B;IACD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CASA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,GACX,MAAM,CAMR"}

package/dist/base-path.js

@@ -225,6 +225,16 @@ export function resolvePrefixes(siteUrl, basePath) {
  * - default basePath, empty slug → `"/docs"`
  * - empty basePath, slug "auth" → `"/auth"`
  * - empty basePath, empty slug → `"/"`
+ * - empty basePath, slug "index" → `"/"` (root home)
+ *
+ * A bare `index` slug means the directory root: `content/index.md` is
+ * deliberately loaded with slug `"index"` (so the root-home and `.md`-mirror
+ * special cases fire — see plans/dir-index-slug-nav-drop.md), but the page is
+ * served at the directory URL and its nav href drops `index` (via
+ * `fileToHref`'s `/index` strip). `currentPath` must match that nav href for
+ * `getPagination` to find the home page, so we drop a whole-slug `index` here
+ * too. Without this the home page's `currentPath` (`/base/index`) never matches
+ * its nav entry (`/base`), so prev/next silently falls back to the first item.
  */
 export function buildCurrentPath(basePath, section, slug) {
     const parts = [];
@@ -232,7 +242,7 @@ export function buildCurrentPath(basePath, section, slug) {
         parts.push(seg);
     if (section)
         parts.push(section);
-    if (slug)
+    if (slug && slug !== "index")
         parts.push(slug);
     return parts.length === 0 ? "/" : `/${parts.join("/")}`;
 }

package/dist/base-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-path.js","sourceRoot":"","sources":["../src/base-path.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-path.js","sourceRoot":"","sources":["../src/base-path.ts"],"names":[],"mappings":"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"}

package/dist/blog.d.ts

@@ -0,0 +1,134 @@
+import type { ExportPage } from "@dogsbay/types";
+/** Resolved `blog:` config (defaults filled). */
+export interface BlogEmitConfig {
+    /**
+     * Where the reverse-chronological index lives, relative to the site.
+     * `"/"` (the default) means the site root IS the blog index — the
+     * shape a blog-only site wants.
+     */
+    indexPath: string;
+    /** Posts per index page. */
+    postsPerPage: number;
+    /** Emit an RSS feed route. Phase 4; accepted and ignored for now. */
+    rss: boolean;
+    /** Which `PageMeta` date orders the list. */
+    dateField: "created" | "updated";
+}
+/** Defaults for a `blog:` block that omits fields. */
+export declare const BLOG_DEFAULTS: BlogEmitConfig;
+/** One post in the emitted data file. */
+export interface BlogPostRef {
+    slug: string;
+    title: string;
+    url: string;
+    description?: string;
+    /** ISO date from `meta[dateField]`. Absent when the post carries none. */
+    date?: string;
+    /** Only when it differs from `date` — the layout shows it as "updated". */
+    updated?: string;
+    author?: string[];
+    tags?: string[];
+    heroImage?: string;
+    /** Whole minutes, minimum 1. */
+    readingMinutes: number;
+}
+/** `src/data/blog.json`. */
+export interface BlogData {
+    /** URL-form index path, prefixed with the COMBINED serving prefix. */
+    indexPath: string;
+    /**
+     * Filesystem-layout prefix (`site.basePath`), used to place route
+     * files under `src/pages/`. Deliberately NOT the same field as the URL
+     * prefix: Astro's `base` adds `urlBase` at request time, so baking it
+     * into file paths too would double it. Same split `taxonomy.ts` takes
+     * as `basePath` + `urlPrefix`.
+     */
+    basePath: string;
+    /**
+     * The COMBINED serving prefix (urlBase + basePath). What DocsLayout's
+     * `basePath` prop wants — it composes the llms.txt link, switcher
+     * hrefs and the alternate link from it, all of which are URLs. Kept
+     * separate from `basePath` above, which is a filesystem path.
+     */
+    urlPrefix: string;
+    /** `content.section`, when the build has one. Part of route placement. */
+    section?: string;
+    postsPerPage: number;
+    /** Newest first. */
+    posts: BlogPostRef[];
+    postCount: number;
+}
+/** Prev/next for one post, in date order. */
+export interface BlogAdjacency {
+    /** The OLDER neighbour — back along the timeline, rendered on the left. */
+    prev?: {
+        title: string;
+        href: string;
+    };
+    /** The NEWER neighbour — forward, rendered on the right. */
+    next?: {
+        title: string;
+        href: string;
+    };
+}
+/**
+ * Count words in a page's body.
+ *
+ * Deliberately crude: whitespace-split on the extracted plain text.
+ * Reading time is a reading CUE, not a measurement, and a more precise
+ * count would not change the rendered minutes.
+ */
+export declare function countWords(page: ExportPage): number;
+/** Whole minutes at {@link WORDS_PER_MINUTE}, never less than 1. */
+export declare function readingMinutes(page: ExportPage): number;
+/**
+ * Build the post list from the page set.
+ *
+ * EVERY page is a post except the one that would occupy the index
+ * route itself. A site that declares `blog:` IS a blog; there is no
+ * second "is this a post?" axis to configure, and inventing one would
+ * mean a post silently vanishing because a field was missing.
+ *
+ * Undated posts sort last, in title order, rather than being dropped —
+ * a post with no date is an authoring mistake worth SEEING, not
+ * hiding.
+ */
+export declare function buildBlogData(pages: ExportPage[], opts: {
+    basePath: string;
+    urlPrefix?: string;
+    /** `content.section`, threaded exactly as taxonomy.ts threads it. */
+    section?: string;
+    /** `excludeFromRoutes` predicate — see makeSlugExcluder. */
+    excludeSlug?: (slug: string) => boolean;
+    config: BlogEmitConfig;
+}): BlogData;
+/**
+ * Prev/next per post slug, in TIME order — `prev` older, `next` newer.
+ *
+ * The footer renders prev on the left and next on the right, so this is
+ * the direction a timeline runs: older behind you, newer ahead. It also
+ * matches how a series is read. `data.posts` is newest-first for the
+ * index listing, so the neighbours are deliberately taken the other way
+ * round from the array order.
+ *
+ * The first version had `prev` as the NEWER neighbour, reasoning that a
+ * blog archive is browsed backwards. That made the right-hand link walk
+ * a reader BACKWARDS through a series — part 1's "next" was nothing, and
+ * its left-hand link was part 2.
+ */
+export declare function blogAdjacency(data: BlogData): Map<string, BlogAdjacency>;
+/** Number of index pages at the configured page size. */
+export declare function indexPageCount(data: BlogData): number;
+/**
+ * Emit `src/data/blog.json` plus the index route(s).
+ *
+ * Page 1 lives at the index path; subsequent pages at
+ * `<indexPath>/page/<n>`. Data JSON is overwritten unconditionally —
+ * it is pure derived data — while route files respect the marker.
+ */
+export declare function emitBlogFiles(outputDir: string, data: BlogData, config: BlogEmitConfig): {
+    routes: string[];
+    skipped: string[];
+    pruned: string[];
+};
+//# sourceMappingURL=blog.d.ts.map

package/dist/blog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../src/blog.ts"],"names":[],"mappings":"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"}

package/dist/blog.js

@@ -0,0 +1,319 @@
+/**
+ * Blog emission for `dogsbay site build`.
+ *
+ * Dogsbay has no blog primitive; this adds one. See
+ * plans/blog-capability.md.
+ *
+ * The shape deliberately mirrors `taxonomy.ts`, which already solves
+ * the same problem — turn a page set into a generated list page:
+ *
+ *   - `src/data/blog.json`        — the post list, newest first
+ *   - `src/pages<indexPath>/…`    — the reverse-chron index route(s)
+ *
+ * A blog index is that emitter sorted by DATE rather than grouped by
+ * term. Route files carry the auto-generated marker and are left alone
+ * once a writer edits them, exactly as taxonomy routes are.
+ *
+ * Two things here are not obvious and are load-bearing:
+ *
+ *   - **Adjacency is chronological, not navigational.** `getPagination`
+ *     in `@dogsbay/docs-layout` walks `NavItem[]`, i.e. sidebar order. A
+ *     blog has no sidebar and its prev/next is "the post before this
+ *     one in time". Post pages get their links from {@link blogAdjacency}
+ *     instead.
+ *   - **Reading time is computed HERE, at emit time.** The word count
+ *     never changes after the build, so doing it in the browser would
+ *     re-walk the DOM on every page load for a constant.
+ */
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { basePathSegments, joinBaseUrl, withBasePath } from "./base-path.js";
+import { derivePageDescription, textOfNode } from "./taxonomy.js";
+/** Words per minute used for reading-time estimates. */
+const WORDS_PER_MINUTE = 200;
+/** Marker that makes an emitted route file safe to regenerate. */
+const AUTO_GENERATED_MARKER = "// AUTO-GENERATED by dogsbay";
+/**
+ * The marker `emitAstroPages` puts on its generated ROUTE STUBS (the root
+ * redirect). Matched exactly, because content pages carry a different
+ * banner — `AUTO-GENERATED by \`dogsbay convert\`` — and treating that as
+ * regenerable meant a real `content/index.md` was silently overwritten by
+ * the blog index AND excluded from the post list. The page just vanished.
+ */
+const STUB_MARKER = "// AUTO-GENERATED by dogsbay site build";
+/** Defaults for a `blog:` block that omits fields. */
+export const BLOG_DEFAULTS = {
+    indexPath: "/",
+    postsPerPage: 20,
+    rss: true,
+    dateField: "created",
+};
+/**
+ * Count words in a page's body.
+ *
+ * Deliberately crude: whitespace-split on the extracted plain text.
+ * Reading time is a reading CUE, not a measurement, and a more precise
+ * count would not change the rendered minutes.
+ */
+export function countWords(page) {
+    const text = (page.tree ?? [])
+        .map((node) => textOfNode(node))
+        .join(" ")
+        .replace(/\s+/g, " ")
+        .trim();
+    if (text.length === 0)
+        return 0;
+    return text.split(" ").length;
+}
+/** Whole minutes at {@link WORDS_PER_MINUTE}, never less than 1. */
+export function readingMinutes(page) {
+    const words = countWords(page);
+    if (words === 0)
+        return 1;
+    return Math.max(1, Math.round(words / WORDS_PER_MINUTE));
+}
+function firstString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+/**
+ * Build the post list from the page set.
+ *
+ * EVERY page is a post except the one that would occupy the index
+ * route itself. A site that declares `blog:` IS a blog; there is no
+ * second "is this a post?" axis to configure, and inventing one would
+ * mean a post silently vanishing because a field was missing.
+ *
+ * Undated posts sort last, in title order, rather than being dropped —
+ * a post with no date is an authoring mistake worth SEEING, not
+ * hiding.
+ */
+export function buildBlogData(pages, opts) {
+    const { basePath, section, config } = opts;
+    // URLs use the COMBINED prefix (urlBase + basePath) — the path the host
+    // actually serves under. Falling back to basePath keeps callers that
+    // only have the one value working, but a mounted site MUST pass
+    // urlPrefix or every post link drops the mount and lands on whatever
+    // owns the host root.
+    const urlPrefix = opts.urlPrefix ?? basePath;
+    const posts = [];
+    for (const page of pages) {
+        // The index route is generated from the post list; a page at that
+        // slug would be listing itself.
+        if (page.slug === "index" && config.indexPath === "/")
+            continue;
+        // Only pages that BECOME routes can be posts. emitAstroPages skips
+        // fragments and excludeFromRoutes matches, so listing them produced
+        // index cards and Newer/Older links to pages that never existed.
+        const fm = (page.frontmatter ?? {});
+        if (page.fragment === true || fm._fragment === true)
+            continue;
+        if (opts.excludeSlug?.(page.slug))
+            continue;
+        const meta = page.meta ?? {};
+        const date = meta[config.dateField];
+        const updated = meta.updated;
+        posts.push({
+            slug: page.slug,
+            title: page.title ?? page.slug,
+            // section threaded like taxonomy.ts's pageUrl — without it, a
+            // sectioned build linked /slug/ while the page lives at
+            // /section/slug/, so every blog link 404'd.
+            url: joinBaseUrl(urlPrefix, section, page.slug),
+            description: derivePageDescription(page),
+            ...(typeof date === "string" ? { date } : {}),
+            ...(typeof updated === "string" && updated !== date ? { updated } : {}),
+            ...(meta.author ? { author: meta.author } : {}),
+            ...(meta.tags ? { tags: meta.tags } : {}),
+            ...(firstString(fm.heroImage) ? { heroImage: firstString(fm.heroImage) } : {}),
+            readingMinutes: readingMinutes(page),
+        });
+    }
+    posts.sort((a, b) => {
+        if (a.date && b.date)
+            return a.date < b.date ? 1 : a.date > b.date ? -1 : 0;
+        if (a.date)
+            return -1;
+        if (b.date)
+            return 1;
+        return a.title.localeCompare(b.title);
+    });
+    return {
+        indexPath: config.indexPath === "/"
+            ? urlPrefix || "/"
+            : withBasePath(urlPrefix, config.indexPath),
+        basePath,
+        ...(section ? { section } : {}),
+        urlPrefix,
+        postsPerPage: config.postsPerPage,
+        posts,
+        postCount: posts.length,
+    };
+}
+/**
+ * Prev/next per post slug, in TIME order — `prev` older, `next` newer.
+ *
+ * The footer renders prev on the left and next on the right, so this is
+ * the direction a timeline runs: older behind you, newer ahead. It also
+ * matches how a series is read. `data.posts` is newest-first for the
+ * index listing, so the neighbours are deliberately taken the other way
+ * round from the array order.
+ *
+ * The first version had `prev` as the NEWER neighbour, reasoning that a
+ * blog archive is browsed backwards. That made the right-hand link walk
+ * a reader BACKWARDS through a series — part 1's "next" was nothing, and
+ * its left-hand link was part 2.
+ */
+export function blogAdjacency(data) {
+    const out = new Map();
+    data.posts.forEach((post, i) => {
+        // posts[] is newest-first, so the OLDER neighbour is the next index.
+        const prev = data.posts[i + 1];
+        const next = data.posts[i - 1];
+        out.set(post.slug, {
+            ...(prev ? { prev: { title: prev.title, href: prev.url } } : {}),
+            ...(next ? { next: { title: next.title, href: next.url } } : {}),
+        });
+    });
+    return out;
+}
+/**
+ * Regenerate an emitted route unless a writer has taken it over.
+ *
+ * Same contract as `taxonomy.ts`: the marker means "ours, safe to
+ * overwrite"; its absence means someone edited the file and their work
+ * wins. A content-derived page also counts as ours — it carries a
+ * `dogsbay convert` banner — so a scaffold's placeholder index does not
+ * block the blog index from claiming the route.
+ */
+function shouldRegenerate(path) {
+    if (!existsSync(path))
+        return true;
+    const contents = readFileSync(path, "utf-8");
+    // Ours (a previous blog index) or a generated route stub — replaceable.
+    // Anything else, INCLUDING a content page, belongs to the author.
+    return contents.includes(AUTO_GENERATED_MARKER) || contents.includes(STUB_MARKER);
+}
+/** Number of index pages at the configured page size. */
+export function indexPageCount(data) {
+    return Math.max(1, Math.ceil(data.posts.length / data.postsPerPage));
+}
+/**
+ * Emit `src/data/blog.json` plus the index route(s).
+ *
+ * Page 1 lives at the index path; subsequent pages at
+ * `<indexPath>/page/<n>`. Data JSON is overwritten unconditionally —
+ * it is pure derived data — while route files respect the marker.
+ */
+export function emitBlogFiles(outputDir, data, config) {
+    mkdirSync(join(outputDir, "src", "data"), { recursive: true });
+    writeFileSync(join(outputDir, "src", "data", "blog.json"), JSON.stringify(data, null, 2));
+    const routes = [];
+    const skipped = [];
+    // Routes live where the PAGES live: <basePath>/<section>/… . Missing
+    // the section put the index at the site root while every post sat one
+    // level down.
+    const segments = [
+        ...basePathSegments(data.basePath),
+        ...(data.section ? basePathSegments(`/${data.section}`) : []),
+    ];
+    const indexSegments = config.indexPath === "/" ? [] : basePathSegments(config.indexPath);
+    const total = indexPageCount(data);
+    for (let pageNo = 1; pageNo <= total; pageNo++) {
+        const parts = pageNo === 1
+            ? [...segments, ...indexSegments, "index.astro"]
+            : [...segments, ...indexSegments, "page", `${pageNo}.astro`];
+        const routePath = join(outputDir, "src", "pages", ...parts);
+        if (!shouldRegenerate(routePath)) {
+            skipped.push(routePath);
+            continue;
+        }
+        mkdirSync(dirname(routePath), { recursive: true });
+        writeFileSync(routePath, buildIndexRoute(pageNo, total));
+        routes.push(routePath);
+    }
+    // Prune pagination routes the current post count no longer needs.
+    // Without this, deleting posts (or raising postsPerPage) left the
+    // previous build's page/3.astro in place: it still compiles, slices
+    // past the end of the list, and serves a live "No posts yet. Page 3
+    // of 2".
+    const pruned = [];
+    for (let stale = total + 1;; stale++) {
+        const stalePath = join(outputDir, "src", "pages", ...segments, ...indexSegments, "page", `${stale}.astro`);
+        if (!existsSync(stalePath))
+            break;
+        if (!shouldRegenerate(stalePath))
+            break; // writer took it over
+        rmSync(stalePath, { force: true });
+        pruned.push(stalePath);
+    }
+    return { routes, skipped, pruned };
+}
+/**
+ * One index route file.
+ *
+ * Reads the emitted JSON at build time (not runtime) and hands a slice
+ * to `<BlogIndex>`. Kept deliberately thin: all layout lives in the
+ * component, so a template fix propagates on rebuild rather than being
+ * baked into every generated route.
+ */
+function buildIndexRoute(pageNo, totalPages) {
+    // wideLayout: blog chrome centres prose at max-w-3xl, which is right for
+    // a post and far too narrow for a three-across card grid. The index is
+    // the one blog route that wants the full measure.
+    //
+    // `@/` alias throughout, not relative paths — page 1 and page N sit at
+    // different depths under src/pages, and a hardcoded `../../` is correct
+    // for exactly one of them. Matches the taxonomy route template.
+    return `---
+${AUTO_GENERATED_MARKER} site build — safe to delete; will regenerate next build.
+// To customize this page, remove the marker line above (or modify the file
+// in any way that drops it) and dogsbay will leave your edits alone.
+import "@/styles/global.css";
+import DocsLayout from "@dogsbay/docs-layout/DocsLayout.astro";
+import BlogIndex from "@dogsbay/docs-layout/BlogIndex.astro";
+import type { SiteConfig } from "@dogsbay/types";
+import blog from "@/data/blog.json";
+import navData from "@/data/nav.json";
+import siteConfigData from "@/data/site.json";
+const siteConfig = siteConfigData as SiteConfig;
+// Read untyped: favicon is site.json data, not part of the published
+// SiteConfig type, so this needs no @dogsbay/types release.
+const favicon = (siteConfigData as { favicon?: string }).favicon;
+const pageNo = ${pageNo};
+const totalPages = ${totalPages};
+const start = (pageNo - 1) * blog.postsPerPage;
+const posts = blog.posts.slice(start, start + blog.postsPerPage);
+const title = pageNo === 1 ? siteConfig.siteName : \`\${siteConfig.siteName} — page \${pageNo}\`;
+---
+<DocsLayout
+  siteName={siteConfig.siteName}
+  title={title}
+  nav={navData as any[]}
+  headings={[]}
+  siteUrl={siteConfig.siteUrl || "/"}
+  description={siteConfig.description || undefined}
+  ogImage={siteConfig.ogImage || undefined}
+  twitterHandle={siteConfig.twitterHandle || undefined}
+  themeColor={siteConfig.themeColor || undefined}
+  repoUrl={siteConfig.repoUrl || undefined}
+  plausibleDomain={siteConfig.plausible?.domain}
+  plausibleScriptUrl={siteConfig.plausible?.scriptUrl}
+  tagPrefixes={siteConfig.tagPrefixes}
+  tagLabels={siteConfig.tagLabels}
+  taxonomyIndexPaths={siteConfig.taxonomyIndexPaths}
+  chrome="blog"
+  favicon={favicon}
+  basePath={blog.urlPrefix}
+  autoH1={false}
+  wideLayout={true}
+>
+  <BlogIndex
+    posts={posts}
+    indexPath={blog.indexPath}
+    pageNo={pageNo}
+    totalPages={totalPages}
+  />
+</DocsLayout>
+`;
+}
+//# sourceMappingURL=blog.js.map

package/dist/blog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog.js","sourceRoot":"","sources":["../src/blog.ts"],"names":[],"mappings":"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"}

package/dist/diff-decoration.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Diff decorations — DiffTree marks rendered through the NORMAL
+ * serializer (plans/tree-diff-rendering.md §2).
+ *
+ * `@dogsbay/tree-diff` annotates nodes with structural fields
+ * (`diff`, `diffInline`, `diffPeer`, `diffMovedFrom`); this module
+ * reads them STRUCTURALLY (no dependency on tree-diff) and decorates
+ * the serializer's output:
+ *
+ *  - block marks   → a `data-diff` attribute injected into the
+ *    rendered snippet's first opening tag (attribute injection works
+ *    uniformly for components, table rows, and plain tags — no
+ *    invalid wrapper elements inside tables/tabs), styled by the
+ *    generated theme CSS;
+ *  - changed prose → the word-level segments render as
+ *    `<ins>/<del>` runs (the merged reading view);
+ *  - changed code  → a before/after pair: the old side renders
+ *    through the same code renderer, labeled, above the new side.
+ *
+ * A tree with no marks renders byte-identically to before — the
+ * decoration layer is invisible until a DiffTree arrives.
+ */
+import type { TreeNode } from "@dogsbay/types";
+/** Structural mirror of @dogsbay/tree-diff's DiffNode fields. */
+export interface DiffMarks {
+    diff?: "added" | "removed" | "changed" | "moved";
+    diffInline?: {
+        op: "eq" | "ins" | "del";
+        text: string;
+    }[];
+    diffPeer?: TreeNode;
+    diffMovedFrom?: string[];
+}
+export declare const diffMarksOf: (node: TreeNode) => DiffMarks;
+export declare function hasDiffMarks(node: TreeNode): boolean;
+/**
+ * Inject attributes into the FIRST opening tag of a rendered
+ * snippet. Handles components (`<TableRow`), plain tags (`<p`), and
+ * skips leading whitespace/JSX expressions.
+ */
+export declare function injectAttrs(rendered: string, attrs: string): string;
+/**
+ * Render the merged word-level segments of a changed prose node.
+ * Formatting inside changed prose flattens to text in this view —
+ * the marks are the content (the unchanged siblings keep their full
+ * inline rendering).
+ */
+export declare function inlineSegmentsToHtml(segments: NonNullable<DiffMarks["diffInline"]>): string;
+export interface MergedCodeDiff {
+    /** Unified code: unchanged lines, removed lines, added lines. */
+    code: string;
+    /** 1-based line numbers, for CodeRich's diffAdd/diffRemove props. */
+    addLines: number[];
+    removeLines: number[];
+}
+/**
+ * Merge two code texts into ONE unified block, reporting the changed
+ * lines BY NUMBER rather than by `[!code]` comment markers.
+ *
+ * Markers were the first design and they leak: Shiki can only strip a
+ * marker it recognizes as a comment in the grammar, so in `plaintext`
+ * — which every unknown language (`package-install`, doc-tool tokens)
+ * falls back to — the marker renders as literal text in the reader's
+ * code. Line numbers are language-independent and can't leak.
+ *
+ * Returns null over the line cap; callers fall back to before/after.
+ */
+export declare function buildMergedCodeDiff(oldCode: string, newCode: string): MergedCodeDiff | null;
+/**
+ * Decorate one rendered node. `renderPeer` renders the other side of
+ * a changed pair through the same serializer (code before/after).
+ */
+export declare function decorateDiff(node: TreeNode, rendered: string, renderPeer: (peer: TreeNode) => string): string;
+/**
+ * The diff stylesheet the generated site carries — theme-token based,
+ * both color modes, no hardcoded palette (key-decisions doctrine).
+ */
+export declare const DIFF_CSS = "/* tree-diff decorations \u2014 one DiffTree, rendered by the normal components.\n   Mark styling is GUARDED by html:not([data-diff-hidden]) rather than\n   force-reset under hidden mode: a reset like \"border-left: none\n   !important\" also clobbers a component's OWN border (an added warning\n   callout lost its left edge \u2014 user find, adapters/mysql). Guarded\n   rules simply stop applying, and component styling survives. */\n[data-diff] { position: relative; }\nhtml:not([data-diff-hidden]) [data-diff=\"added\"] {\n  background: color-mix(in oklch, var(--color-success, oklch(0.72 0.19 150)) 12%, transparent);\n  border-left: 3px solid var(--color-success, oklch(0.72 0.19 150));\n  padding-left: 0.75rem;\n}\nhtml:not([data-diff-hidden]) [data-diff=\"removed\"] {\n  background: color-mix(in oklch, var(--color-destructive, oklch(0.64 0.21 25)) 10%, transparent);\n  border-left: 3px solid var(--color-destructive, oklch(0.64 0.21 25));\n  padding-left: 0.75rem;\n  opacity: 0.75;\n}\nhtml:not([data-diff-hidden]) [data-diff=\"removed\"] :is(p, li, code, pre) { text-decoration: line-through; text-decoration-thickness: 1px; }\nhtml:not([data-diff-hidden]) [data-diff=\"changed\"] {\n  border-left: 3px solid var(--color-warning, oklch(0.8 0.16 85));\n  padding-left: 0.75rem;\n}\nhtml:not([data-diff-hidden]) [data-diff=\"moved\"] {\n  border-left: 3px dashed var(--color-info, oklch(0.7 0.14 240));\n  padding-left: 0.75rem;\n}\nhtml:not([data-diff-hidden]) [data-diff=\"moved\"][data-diff-from]::after {\n  content: \"moved from \" attr(data-diff-from);\n  display: block;\n  font-size: 0.75rem;\n  color: var(--color-muted-foreground, inherit);\n  opacity: 0.8;\n}\n\n/* Explicit \"added\"/\"removed\" label pills straddling the block's top\n   edge. Components with their own chrome (callouts, code blocks)\n   camouflage a tint-only mark \u2014 a green-tinted warning callout reads\n   as a callout variant, not as new content (user feedback,\n   better-auth adapters/mysql). Table rows are excluded (a pill can't\n   straddle a tr); nested marks defer to the outermost label. */\nhtml:not([data-diff-hidden]) [data-diff=\"added\"]:not(tr, th, td)::before,\nhtml:not([data-diff-hidden]) [data-diff=\"removed\"]:not(tr, th, td)::before {\n  position: absolute;\n  top: 0;\n  right: 0.6rem;\n  transform: translateY(-55%);\n  font-size: 0.65rem;\n  font-weight: 600;\n  letter-spacing: 0.04em;\n  line-height: 1.4;\n  padding: 0 0.5rem;\n  border-radius: 99px;\n  z-index: 1;\n  text-decoration: none;\n}\nhtml:not([data-diff-hidden]) [data-diff=\"added\"]:not(tr, th, td)::before {\n  content: \"added\";\n  background: color-mix(in oklch, var(--color-success, oklch(0.72 0.19 150)) 25%, var(--color-background, Canvas));\n  border: 1px solid color-mix(in oklch, var(--color-success, oklch(0.72 0.19 150)) 45%, transparent);\n}\nhtml:not([data-diff-hidden]) [data-diff=\"removed\"]:not(tr, th, td)::before {\n  content: \"removed\";\n  background: color-mix(in oklch, var(--color-destructive, oklch(0.64 0.21 25)) 20%, var(--color-background, Canvas));\n  border: 1px solid color-mix(in oklch, var(--color-destructive, oklch(0.64 0.21 25)) 45%, transparent);\n}\n[data-diff] [data-diff]::before { content: none !important; }\n\n/* Nav change markers (the sidebar is client-rendered from nav.json, so\n   the styles ship here rather than with the component). Same contract as\n   the tab markers: a GLYPH carries the meaning, colour reinforces it,\n   visually-hidden text announces it. */\n.db-nav-mark {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  flex-shrink: 0;\n  width: 1rem;\n  height: 1rem;\n  margin-left: auto;\n  border-radius: 99px;\n  font-size: 0.75rem;\n  font-weight: 700;\n  line-height: 1;\n  color: var(--color-muted-foreground, currentColor);\n}\n.db-nav-mark[data-nav-mark=\"added\"] { color: var(--color-success, oklch(0.72 0.19 150)); }\n.db-nav-mark[data-nav-mark=\"changed\"] { color: var(--color-warning, oklch(0.8 0.16 85)); }\n.db-nav-mark[data-nav-mark=\"removed\"] { color: var(--color-destructive, oklch(0.64 0.21 25)); }\n.db-nav-mark[data-nav-mark=\"moved\"] { color: var(--color-info, oklch(0.7 0.14 240)); }\n/* a subtree marker is a hint about descendants, not a claim about this row */\n.db-nav-mark[data-nav-mark-subtree] { opacity: 0.55; }\n/* removed pages get a SECOND non-colour signal */\n/* Belt-and-braces: a subtree mark must never strike through its own row. */\n[data-nav-mark-row=\"removed\"]:not([data-nav-mark-subtree]) { text-decoration: line-through; opacity: 0.7; }\n@media (forced-colors: active) {\n  .db-nav-mark { color: CanvasText; }\n}\n\n/* Which tab changed? A marked panel is invisible until opened, so its\n   trigger carries a marker (the group's bar says \"in here\", the marker\n   says \"this one\"). The marker is a GLYPH, not a colored dot: colour\n   alone fails WCAG 1.4.1 and background-tinted dots vanish entirely in\n   forced-colors mode. Colour reinforces; shape carries the meaning.\n   Visually-hidden text rides along (emitted by the serializer). */\n.db-tab-mark {\n  display: inline-block;\n  margin-left: 0.35rem;\n  font-size: 0.75rem;\n  font-weight: 700;\n  line-height: 1;\n  vertical-align: middle;\n  color: var(--color-muted-foreground, currentColor);\n}\n[data-diff-hidden] .db-tab-mark { display: none; }\n.db-tab-mark[data-diff-tab=\"changed\"] { color: var(--color-warning, oklch(0.8 0.16 85)); }\n.db-tab-mark[data-diff-tab=\"added\"] { color: var(--color-success, oklch(0.72 0.19 150)); }\n.db-tab-mark[data-diff-tab=\"removed\"] { color: var(--color-destructive, oklch(0.64 0.21 25)); }\n.db-tab-mark[data-diff-tab=\"moved\"] { color: var(--color-info, oklch(0.7 0.14 240)); }\n@media (forced-colors: active) {\n  .db-tab-mark { color: CanvasText; }\n}\nins.db-diff-ins {\n  text-decoration: none;\n  background: color-mix(in oklch, var(--color-success, oklch(0.72 0.19 150)) 22%, transparent);\n  border-radius: 2px;\n  padding: 0 1px;\n}\ndel.db-diff-del {\n  background: color-mix(in oklch, var(--color-destructive, oklch(0.64 0.21 25)) 18%, transparent);\n  border-radius: 2px;\n  padding: 0 1px;\n}\n.db-diff-pair { display: grid; gap: 0.25rem; margin-block: 1rem; }\n.db-diff-pair-label {\n  font-size: 0.7rem;\n  text-transform: uppercase;\n  letter-spacing: 0.08em;\n  color: var(--color-muted-foreground, inherit);\n  opacity: 0.8;\n}\ntr[data-diff] { border-left-width: 3px; }\n\n/* Folded unchanged sections are CHROME, not content callouts:\n   dashed, dimmed, compact \u2014 visually \"collapsed context\". */\n.db-diff-fold {\n  border: 1px dashed color-mix(in oklch, currentColor 25%, transparent) !important;\n  border-left-width: 1px !important;\n  background: transparent !important;\n  opacity: 0.7;\n  margin-block: 0.5rem !important;\n}\n.db-diff-fold:hover, .db-diff-fold[open] { opacity: 1; }\n.db-diff-fold summary, .db-diff-fold [data-slot=\"trigger\"] {\n  font-size: 0.85rem;\n}\n\n/* The comparison banner at the top of each reader page. */\n.db-diff-banner-row { display: flex; flex-wrap: wrap; gap: 0.4rem 0.8rem; align-items: center; width: 100%; }\n.db-diff-banner {\n  border: 1px solid color-mix(in oklch, currentColor 15%, transparent);\n  border-radius: 8px;\n  padding: 0.75rem 1rem;\n  margin-block-end: 1.5rem;\n  font-size: 0.85rem;\n  display: flex;\n  flex-wrap: wrap;\n  gap: 0.4rem 1rem;\n  align-items: center;\n}\n.db-diff-banner .db-chip {\n  display: inline-block;\n  border-radius: 99px;\n  padding: 0.05rem 0.6rem;\n  font-size: 0.75rem;\n  border: 1px solid transparent;\n}\n.db-chip-added { background: color-mix(in oklch, var(--color-success, oklch(0.72 0.19 150)) 15%, transparent); }\n.db-chip-removed { background: color-mix(in oklch, var(--color-destructive, oklch(0.64 0.21 25)) 12%, transparent); }\n.db-chip-changed { background: color-mix(in oklch, var(--color-warning, oklch(0.8 0.16 85)) 15%, transparent); }\n.db-chip-moved { background: color-mix(in oklch, var(--color-info, oklch(0.7 0.14 240)) 12%, transparent); }\n.db-chip-muted { border-color: color-mix(in oklch, currentColor 25%, transparent); opacity: 0.8; }\n\n/* The persistent view-switcher bar (Reader / Docs-ops / Agent):\n   perspectives on ONE comparison \u2014 tabs are links, verification\n   lives in the chrome, the Monitor CTA sits next to the value. */\n.db-cmp-bar {\n  position: sticky;\n  /* BELOW the docs header, not under it: both were sticky at top:0 and\n     the header's higher z-index simply swallowed this bar on scroll \u2014\n     the chrome carrying the trust contract was the chrome that vanished.\n     --db-header-height is declared by DocsLayout (the header sizes itself\n     from the same variable, so they cannot drift). */\n  top: var(--db-header-height, 3.25rem);\n  z-index: 30;\n  display: flex;\n  flex-wrap: wrap;\n  gap: 0.4rem 0.9rem;\n  align-items: center;\n  padding: 0.5rem 0.9rem;\n  margin-block-end: 1rem;\n  border: 1px solid color-mix(in oklch, currentColor 15%, transparent);\n  border-radius: 8px;\n  background: var(--color-background, Canvas);\n  font-size: 0.8rem;\n}\n.db-cmp-bar .db-chip {\n  display: inline-block;\n  border-radius: 99px;\n  padding: 0.05rem 0.6rem;\n  font-size: 0.75rem;\n  border: 1px solid transparent;\n}\n.db-cmp-bar button.db-chip { cursor: pointer; background: transparent; font: inherit; font-size: 0.75rem; color: inherit; }\n.db-cmp-tabs {\n  display: inline-flex;\n  gap: 0.15rem;\n  border: 1px solid color-mix(in oklch, currentColor 20%, transparent);\n  border-radius: 99px;\n  padding: 0.1rem;\n}\n.db-cmp-tab {\n  padding: 0.1rem 0.7rem;\n  border-radius: 99px;\n  text-decoration: none;\n  color: inherit;\n}\n.db-cmp-tab[aria-current=\"page\"] {\n  background: color-mix(in oklch, currentColor 12%, transparent);\n  font-weight: 600;\n}\n.db-cmp-pairs { position: relative; display: inline-block; }\n.db-cmp-pairs summary { cursor: pointer; }\n.db-cmp-pairs ul {\n  position: absolute;\n  top: 100%;\n  left: 0;\n  margin: 0.25rem 0 0;\n  padding: 0.35rem 0.75rem;\n  list-style: none;\n  background: var(--color-background, Canvas);\n  border: 1px solid color-mix(in oklch, currentColor 20%, transparent);\n  border-radius: 8px;\n  white-space: nowrap;\n  z-index: 40;\n}\n.db-cmp-monitor { text-decoration: none; border-color: color-mix(in oklch, currentColor 30%, transparent) !important; }\n.db-cmp-monitor:hover { background: color-mix(in oklch, currentColor 10%, transparent); }\n\n/* A wholly added/removed PAGE carries one mark around all its content.\n   The per-block tint would be overwhelming at page scale, so page level\n   gets a stronger edge and a much lighter wash \u2014 legible at a glance,\n   still readable as prose. The \"added\"/\"removed\" pill (the ::before on\n   [data-diff]) rides on this wrapper, which is exactly right: it labels\n   the page, once. */\nhtml:not([data-diff-hidden]) [data-diff].db-diff-page {\n  border-left-width: 5px;\n  padding-left: 1rem;\n  padding-block: 0.5rem;\n  border-radius: 0 6px 6px 0;\n}\nhtml:not([data-diff-hidden]) [data-diff=\"added\"].db-diff-page {\n  background: color-mix(in oklch, var(--color-success, oklch(0.72 0.19 150)) 5%, transparent);\n}\nhtml:not([data-diff-hidden]) [data-diff=\"removed\"].db-diff-page {\n  background: color-mix(in oklch, var(--color-destructive, oklch(0.64 0.21 25)) 5%, transparent);\n  opacity: 1; /* the page is READABLE \u2014 the mark says removed, not the dimming */\n}\n/* \u2026and a removed PAGE is not struck through \u2014 that is for a deleted line,\n   not for a document the reader still needs to read. */\n[data-diff=\"removed\"].db-diff-page :is(p, li, code, pre) { text-decoration: none; }\n\n/* Changed raw HTML: the faithful new render, plus the previous version\n   one click away. Without it a deletion inside opaque markup (a dropped\n   table column) is simply invisible \u2014 the reader is told \"something\n   changed\" and shown no evidence. */\n.db-diff-html-before {\n  margin-block-start: 0.5rem;\n  font-size: 0.8rem;\n  border: 1px dashed color-mix(in oklch, currentColor 25%, transparent);\n  border-radius: 6px;\n  padding: 0.25rem 0.6rem;\n}\n/* Full-strength text: the summary is a CONTROL \u2014 dimming it (opacity or\n   muted-foreground) drops it below 4.5:1 and axe rightly fails it. */\n.db-diff-html-before summary { cursor: pointer; color: inherit; }\n.db-diff-html-before[open] summary { margin-block-end: 0.5rem; }\n[data-diff-hidden] .db-diff-html-before { display: none; }\n\n/* Merged code diffs carry a hidden clean twin (the post-change\n   render); Hide highlights swaps them. */\n.db-diff-code { position: relative; }\n.db-diff-code-clean { display: none; }\n[data-diff-hidden] .db-diff-code-clean { display: block; }\n[data-diff-hidden] .db-diff-code-merged { display: none; }\n\n/* Whitespace-only code edits are still marked (indentation is\n   semantic in YAML/Python/markdown) \u2014 but NAMED, so the reader\n   is not hunting an invisible 3-space shift. */\nhtml:not([data-diff-hidden]) .db-diff-code-ws .db-diff-code-merged::before {\n  content: \"whitespace only\";\n  position: absolute;\n  top: 0;\n  right: 0.6rem;\n  transform: translateY(-55%);\n  z-index: 1;\n  font-size: 0.65rem;\n  font-weight: 600;\n  letter-spacing: 0.04em;\n  line-height: 1.4;\n  padding: 0 0.5rem;\n  border-radius: 99px;\n  background: color-mix(in oklch, var(--color-warning, oklch(0.8 0.16 85)) 22%, var(--color-background, Canvas));\n  border: 1px solid color-mix(in oklch, var(--color-warning, oklch(0.8 0.16 85)) 45%, transparent);\n}\n\n/* Hide highlights \u2014 read the target version clean. One attribute on\n   <html>: the guarded mark rules above stop applying by themselves;\n   only content that does not exist in the target version (removed\n   blocks, del runs, the \"before\" code side) needs hiding, plus the\n   ins tint. */\n[data-diff-hidden] :is([data-diff=\"removed\"], del.db-diff-del, .db-diff-pair-label) { display: none !important; }\n[data-diff-hidden] ins.db-diff-ins { background: transparent; padding: 0; }\n";
+//# sourceMappingURL=diff-decoration.d.ts.map