@dogsbay/format-astro 0.2.0-beta.12 → 0.2.0-beta.120

package/dist/granularity.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Granularity views — assemble a whole-book page from topic pages + nav.
+ *
+ * The additive-MVP core (see plans/granularity-views.md). Given the topic-grained
+ * `ExportPage[]` + the `NavItem[]` tree a site already produces, this reassembles
+ * an entire nav subtree into ONE "book" page:
+ *   - each nav node becomes a heading (level = nav depth; book title is the
+ *     implicit H1, so a top-level node is H2, its children H3, … clamped at H6);
+ *   - a topic's own body headings are shifted down by `level − 1` so they nest
+ *     under their topic's title;
+ *   - every node gets a stable, page-unique anchor, so a topic resolves to
+ *     `<book>/_book#<anchor>` (the "Read as single page" button target).
+ *
+ * Pure + source-agnostic: it never touches the network or the original source,
+ * only the already-converted `TreeNode` trees ("convert once, project many").
+ * The original topic trees are NOT mutated — each is deep-cloned before its
+ * headings are shifted.
+ *
+ * This is a platform generalization of `format-fluidtopics-rest/src/single-page.ts`
+ * (which is khub-coupled). The FT `--single-page` branch will fold into this.
+ */
+import type { ExportPage, NavItem, TreeNode } from "@dogsbay/types";
+/**
+ * Reserved route segment for the book rollup. NOT `_`-prefixed: Astro treats
+ * `src/pages/` files/dirs starting with `_` as private (non-routable), so a
+ * `_book.astro` would 404. `~book` is collision-proof instead — `slugify`
+ * strips `~`, so no content slug can ever produce this segment (no slugifier
+ * reservation needed).
+ */
+export declare const BOOK_SEGMENT = "~book";
+export interface AssembleBookOptions {
+    /** Route prefix the nav hrefs carry (e.g. "/docs" or ""); stripped to get slugs. */
+    hrefPrefix?: string;
+    /** Book page title; defaults to the first nav item's label. */
+    title?: string;
+    /** Reserved suffix segment for the rollup route. Default `_book`. */
+    bookSegment?: string;
+}
+export interface BookView {
+    /** The assembled book page (noindex; excluded from nav/sitemap/search/llms). */
+    page: ExportPage;
+    /**
+     * topic slug → its anchor on the book page. Powers the per-topic
+     * "Read as single page" button (`<bookRoute>#<anchor>`).
+     */
+    topicAnchors: Map<string, string>;
+}
+/**
+ * Rough estimate of a TreeNode[]'s textual content size in bytes — the sum of
+ * its prose text, pre-rendered html, and string prop values (code, etc.). Used
+ * as the granularity size cap's input: it tracks source size closely enough to
+ * catch the 10 MB+ rollups (rest_api, installing) that blow up build + DOM,
+ * without a full serialize. See docs-dev/granularity-book-perf.md.
+ */
+export declare function estimateTreeBytes(tree: TreeNode[]): number;
+/**
+ * Assemble one book page from a nav subtree + the topic pages it references.
+ * Returns null when the subtree references no actual pages.
+ */
+export declare function assembleBook(nav: NavItem[], pages: ExportPage[], opts?: AssembleBookOptions): BookView | null;
+/** The "Open as page ↗" affordance — a link from a book section back to its topic page. */
+export declare function openAsPageNode(slug: string, hrefPrefix: string): TreeNode;
+/** A heading node for a nav entry's title, carrying the explicit anchor id. */
+export declare function bookHeading(level: number, title: string, anchor: string): TreeNode;
+/** Shift every heading in a (topic body) tree down by `offset` ranks (max H6). */
+export declare function shiftHeadings(tree: TreeNode[], offset: number): void;
+/**
+ * Rewrite **intra-book** xrefs to in-page anchors so the reader stays in the
+ * book. A link is rewritten iff its target slug is in *this* book's
+ * `topicAnchors` (the "is it in this book?" test). Cross-book links (target not
+ * in the book) and external links are left untouched — they keep pointing at the
+ * canonical topic page, which is correct. Mutates `tree` (already a clone).
+ */
+export declare function rewriteIntraBookLinks(tree: TreeNode[], topicAnchors: Map<string, string>, hrefPrefix: string): void;
+/**
+ * Longest common path prefix (slash-segment-wise) of the member slugs — the
+ * book's base route (e.g. the FT book base `…/16.0`). Falls back to `fallback`.
+ */
+export declare function bookSlugFrom(slugs: string[], fallback: string): string;
+/** Strip the route prefix + leading slash + anchor/query from a nav href → slug. */
+export declare function slugFromHref(href: string | undefined, hrefPrefix: string): string;
+export declare function slugify(text: string): string;
+//# sourceMappingURL=granularity.d.ts.map

package/dist/granularity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"granularity.d.ts","sourceRoot":"","sources":["../src/granularity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAW,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE7E;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC,MAAM,WAAW,mBAAmB;IAClC,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,gFAAgF;IAChF,IAAI,EAAE,UAAU,CAAC;IACjB;;;OAGG;IACH,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,CAoB1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,OAAO,EAAE,EACd,KAAK,EAAE,UAAU,EAAE,EACnB,IAAI,GAAE,mBAAwB,GAC7B,QAAQ,GAAG,IAAI,CAuEjB;AAID,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ,CAOzE;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAMlF;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAUpE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,EAAE,EAChB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,UAAU,EAAE,MAAM,GACjB,IAAI,CAmBN;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUtE;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAKjF;AAuCD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU5C"}

package/dist/granularity.js

@@ -0,0 +1,247 @@
+/**
+ * Reserved route segment for the book rollup. NOT `_`-prefixed: Astro treats
+ * `src/pages/` files/dirs starting with `_` as private (non-routable), so a
+ * `_book.astro` would 404. `~book` is collision-proof instead — `slugify`
+ * strips `~`, so no content slug can ever produce this segment (no slugifier
+ * reservation needed).
+ */
+export const BOOK_SEGMENT = "~book";
+/**
+ * Rough estimate of a TreeNode[]'s textual content size in bytes — the sum of
+ * its prose text, pre-rendered html, and string prop values (code, etc.). Used
+ * as the granularity size cap's input: it tracks source size closely enough to
+ * catch the 10 MB+ rollups (rest_api, installing) that blow up build + DOM,
+ * without a full serialize. See docs-dev/granularity-book-perf.md.
+ */
+export function estimateTreeBytes(tree) {
+    let bytes = 0;
+    const walk = (nodes) => {
+        for (const node of nodes) {
+            const n = node;
+            if (typeof n.html === "string")
+                bytes += n.html.length;
+            if (n.props) {
+                for (const v of Object.values(n.props))
+                    if (typeof v === "string")
+                        bytes += v.length;
+            }
+            if (Array.isArray(n.inline)) {
+                for (const i of n.inline) {
+                    if (typeof i.text === "string")
+                        bytes += i.text.length;
+                    else if (typeof i.value === "string")
+                        bytes += i.value.length;
+                }
+            }
+            if (n.children?.length)
+                walk(n.children);
+        }
+    };
+    walk(tree);
+    return bytes;
+}
+/**
+ * Assemble one book page from a nav subtree + the topic pages it references.
+ * Returns null when the subtree references no actual pages.
+ */
+export function assembleBook(nav, pages, opts = {}) {
+    const hrefPrefix = opts.hrefPrefix ?? "";
+    const bookSegment = opts.bookSegment ?? BOOK_SEGMENT;
+    const bySlug = new Map(pages.map((p) => [p.slug, p]));
+    const topicAnchors = new Map();
+    const memberSlugs = [];
+    const seenAnchor = new Map();
+    const uniqueAnchor = (base) => {
+        const b = base || "section";
+        const n = seenAnchor.get(b) ?? 0;
+        seenAnchor.set(b, n + 1);
+        return n === 0 ? b : `${b}-${n}`;
+    };
+    const ordered = [];
+    const assign = (items, depth) => {
+        for (const item of items) {
+            const level = Math.min(depth + 2, 6);
+            const slug = slugFromHref(item.href, hrefPrefix);
+            const anchor = uniqueAnchor(slugify(slug ? lastSegment(slug) : item.label));
+            ordered.push({ label: item.label, level, slug, anchor });
+            if (slug && bySlug.has(slug)) {
+                topicAnchors.set(slug, anchor);
+                memberSlugs.push(slug);
+            }
+            if (item.children?.length)
+                assign(item.children, depth + 1);
+        }
+    };
+    assign(nav, 0);
+    if (memberSlugs.length === 0)
+        return null;
+    // Pass 2 — assemble: a heading per node, then the topic body (cloned, headings
+    // shifted to nest, and intra-book xrefs rewritten to in-page anchors).
+    const tree = [];
+    for (const { label, level, slug, anchor } of ordered) {
+        tree.push(bookHeading(level, label, anchor));
+        const page = slug ? bySlug.get(slug) : undefined;
+        if (page) {
+            // "Open as page ↗" — the way back from the book to the focused topic.
+            // Pushed OUTSIDE the body so rewriteIntraBookLinks (which runs on the
+            // clone only) doesn't collapse it to an in-page anchor.
+            tree.push(openAsPageNode(slug, hrefPrefix));
+            // Clone so we never mutate the topic page that is also emitted standalone.
+            const body = structuredClone(page.tree);
+            shiftHeadings(body, level - 1);
+            rewriteIntraBookLinks(body, topicAnchors, hrefPrefix);
+            tree.push(...body);
+        }
+    }
+    const title = opts.title ?? nav[0]?.label ?? "Book";
+    const base = bookSlugFrom(memberSlugs, slugify(title));
+    const slug = `${base}/${bookSegment}`;
+    const page = {
+        slug,
+        title,
+        tree,
+        headings: extractBookHeadings(tree),
+        // Quarantine marker — the emitters keep the book out of search / sitemap /
+        // llms and tag it noindex. Kept in frontmatter so it round-trips + is visible.
+        frontmatter: { noindex: true, granularity: "book" },
+    };
+    return { page, topicAnchors };
+}
+// ── pure helpers (ported from format-fluidtopics-rest/single-page.ts) ──────
+/** The "Open as page ↗" affordance — a link from a book section back to its topic page. */
+export function openAsPageNode(slug, hrefPrefix) {
+    const route = hrefPrefix ? `${hrefPrefix}/${slug}` : `/${slug}`;
+    return {
+        type: "paragraph",
+        props: { class: "dsb-open-as-page" },
+        children: [{ type: "prose", inline: [{ type: "link", href: route, children: [{ type: "text", text: "Open as page ↗" }] }] }],
+    };
+}
+/** A heading node for a nav entry's title, carrying the explicit anchor id. */
+export function bookHeading(level, title, anchor) {
+    return {
+        type: "heading",
+        props: { level, slug: anchor, text: title },
+        children: [{ type: "prose", inline: [{ type: "text", text: title }] }],
+    };
+}
+/** Shift every heading in a (topic body) tree down by `offset` ranks (max H6). */
+export function shiftHeadings(tree, offset) {
+    if (offset <= 0)
+        return;
+    for (const n of tree) {
+        if (n.type === "heading") {
+            const lvl = n.props?.level ?? 1;
+            if (!n.props)
+                n.props = {};
+            n.props.level = Math.min(lvl + offset, 6);
+        }
+        if (n.children)
+            shiftHeadings(n.children, offset);
+    }
+}
+/**
+ * Rewrite **intra-book** xrefs to in-page anchors so the reader stays in the
+ * book. A link is rewritten iff its target slug is in *this* book's
+ * `topicAnchors` (the "is it in this book?" test). Cross-book links (target not
+ * in the book) and external links are left untouched — they keep pointing at the
+ * canonical topic page, which is correct. Mutates `tree` (already a clone).
+ */
+export function rewriteIntraBookLinks(tree, topicAnchors, hrefPrefix) {
+    const rewriteInline = (nodes) => {
+        for (const n of nodes) {
+            if (n.type === "link" && typeof n.href === "string") {
+                const slug = slugFromHref(n.href, hrefPrefix);
+                const anchor = slug ? topicAnchors.get(slug) : undefined;
+                if (anchor)
+                    n.href = `#${anchor}`;
+            }
+            if (Array.isArray(n.children))
+                rewriteInline(n.children);
+        }
+    };
+    const walk = (ns) => {
+        for (const n of ns) {
+            if (n.inline)
+                rewriteInline(n.inline);
+            if (n.children)
+                walk(n.children);
+        }
+    };
+    walk(tree);
+}
+/**
+ * Longest common path prefix (slash-segment-wise) of the member slugs — the
+ * book's base route (e.g. the FT book base `…/16.0`). Falls back to `fallback`.
+ */
+export function bookSlugFrom(slugs, fallback) {
+    const parts = slugs.filter(Boolean).map((s) => s.split("/"));
+    if (!parts.length)
+        return fallback;
+    const first = parts[0];
+    let i = 0;
+    for (; i < first.length; i++) {
+        const seg = first[i];
+        if (!parts.every((p) => p[i] === seg))
+            break;
+    }
+    return first.slice(0, i).join("/") || fallback;
+}
+/** Strip the route prefix + leading slash + anchor/query from a nav href → slug. */
+export function slugFromHref(href, hrefPrefix) {
+    if (!href)
+        return "";
+    let s = href.split("#")[0].split("?")[0].trim();
+    if (hrefPrefix && s.startsWith(hrefPrefix))
+        s = s.slice(hrefPrefix.length);
+    return s.replace(/^\/+/, "").replace(/\/+$/, "");
+}
+function lastSegment(slug) {
+    return slug.split("/").pop() ?? slug;
+}
+/** Collect Heading[] from an assembled tree (nodes already carry props.slug/level/text). */
+function extractBookHeadings(tree) {
+    const out = [];
+    const walk = (ns) => {
+        for (const n of ns) {
+            if (n.type === "heading") {
+                out.push({
+                    depth: n.props?.level ?? 1,
+                    slug: n.props?.slug ?? "",
+                    text: n.props?.text ?? inlineText(n),
+                });
+            }
+            if (n.children)
+                walk(n.children);
+        }
+    };
+    walk(tree);
+    return out;
+}
+function inlineText(node) {
+    const parts = [];
+    const fromInline = (ns = []) => {
+        for (const n of ns) {
+            if (typeof n.text === "string")
+                parts.push(n.text);
+            else if (Array.isArray(n.children))
+                fromInline(n.children);
+        }
+    };
+    if (node.inline)
+        fromInline(node.inline);
+    if (node.children)
+        for (const c of node.children)
+            parts.push(inlineText(c));
+    return parts.join("").trim();
+}
+export function slugify(text) {
+    return (text
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, "")
+        .replace(/\s+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .trim() || "section");
+}
+//# sourceMappingURL=granularity.js.map

package/dist/granularity.js.map

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

package/dist/head-metadata.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Head metadata per page (dogsbay-ssg plans/head-metadata.md, Blume item 2):
+ * whether it is a home page (JSON-LD `WebSite`, og:type website), its
+ * `hreflang` alternates across languages, and its nav trail for JSON-LD
+ * `BreadcrumbList`. The builders are @dogsbay/site-files', shared with
+ * dogsbay-ssg; this file finds the inputs in the imported pages and the nav.
+ */
+import type { ExportPage, NavItem } from "@dogsbay/types";
+import { type HreflangLink } from "@dogsbay/site-files";
+export interface HeadMetadata {
+    home: boolean;
+    alternates: HreflangLink[];
+    breadcrumbJsonLd?: Record<string, unknown>;
+}
+export interface HeadMetadataOptions {
+    siteUrl?: string;
+    /** urlBase + basePath, as the sitemap takes it. */
+    basePath?: string;
+    defaultLocale?: string;
+    /** Pages the build writes (not fragments or excluded routes); others are never an alternate. Drafts and redirects are left out as well. */
+    isEmitted?: (p: ExportPage) => boolean;
+    /** Pages that list alternates: their own canonical and indexable (hreflang between non-canonical URLs is ignored by search engines). */
+    indexable?: (p: ExportPage) => boolean;
+}
+export declare function headMetadata(pages: ExportPage[], nav: NavItem[], o: HeadMetadataOptions): Map<string, HeadMetadata>;
+//# sourceMappingURL=head-metadata.d.ts.map

package/dist/head-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head-metadata.d.ts","sourceRoot":"","sources":["../src/head-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAA6C,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2IAA2I;IAC3I,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC;IACvC,wIAAwI;IACxI,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC;CACxC;AAQD,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,mBAAmB,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CA+CnH"}

package/dist/head-metadata.js

@@ -0,0 +1,56 @@
+import { buildBreadcrumbJsonLd, buildHreflangLinks } from "@dogsbay/site-files";
+import { normalizePrefix, originOf, pageHref } from "./sitemap.js";
+/** Path inside the page's source (`guide/install`), `index` for a home page. */
+function inside(p) {
+    const orig = (p.multiSource?.originalSlug ?? p.slug).replace(/^\/+|\/+$/g, "");
+    return orig === "" || orig === "index" ? "index" : orig.replace(/\/index$/, "");
+}
+export function headMetadata(pages, nav, o) {
+    const plan = new Map();
+    const live = (p) => !p.redirect && p.frontmatter?.draft !== true && p.frontmatter?.status !== "draft" && (o.isEmitted?.(p) ?? true);
+    const prefix = normalizePrefix(o.basePath);
+    const origin = o.siteUrl && /^https?:\/\//.test(o.siteUrl) ? originOf(o.siteUrl).replace(/\/+$/, "") : undefined;
+    const url = (slug) => (origin ? `${origin}${pageHref(slug, prefix)}` : undefined);
+    // Copies of one page across languages: same namespace, version and path inside the source.
+    const copies = new Map();
+    const locales = new Set(pages.map((p) => p.multiSource?.locale).filter(Boolean));
+    if (origin && locales.size >= 2) {
+        for (const p of pages) {
+            const m = p.multiSource;
+            if (!m?.locale || !live(p))
+                continue;
+            const key = `${m.namespace ?? ""}\0${m.version ?? ""}\0${inside(p)}`;
+            const list = copies.get(key) ?? [];
+            list.push({ lang: m.locale, url: url(p.slug) });
+            copies.set(key, list);
+        }
+    }
+    // The nav trail to each page: labels and hrefs from the top level down.
+    const trails = new Map();
+    const clean = (href) => href.replace(/[?#].*$/, "").replace(/^\/+|\/+$/g, "").replace(/(^|\/)index$/, "");
+    const mount = prefix.replace(/^\/+/, "");
+    const key = (href) => {
+        const h = clean(href);
+        return mount && (h === mount || h.startsWith(`${mount}/`)) ? h.slice(mount.length).replace(/^\/+/, "") : h;
+    };
+    const walk = (items, chain) => {
+        for (const it of items) {
+            const here = [...chain, { name: it.label, href: it.href }];
+            if (it.href && !/^[a-z][a-z0-9+.-]*:/i.test(it.href) && !it.href.includes("#") && !trails.has(key(it.href)))
+                trails.set(key(it.href), here);
+            if (it.children?.length)
+                walk(it.children, here);
+        }
+    };
+    walk(nav, []);
+    for (const p of pages) {
+        const home = inside(p) === "index";
+        const m = p.multiSource;
+        const alternates = m?.locale && live(p) && (o.indexable?.(p) ?? true) ? buildHreflangLinks(copies.get(`${m.namespace ?? ""}\0${m.version ?? ""}\0${inside(p)}`) ?? [], o.defaultLocale) : [];
+        const trail = origin && !home ? trails.get(clean(p.slug)) : undefined;
+        const breadcrumbJsonLd = trail ? buildBreadcrumbJsonLd(trail.map((t) => ({ name: t.name, url: t.href ? url(key(t.href)) : undefined }))) : undefined;
+        plan.set(p.slug, { home, alternates, ...(breadcrumbJsonLd ? { breadcrumbJsonLd } : {}) });
+    }
+    return plan;
+}
+//# sourceMappingURL=head-metadata.js.map

package/dist/head-metadata.js.map

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

package/dist/index.d.ts

@@ -1,14 +1,34 @@
 export { treeToAstro, escapeExpr, escapeAttr, escapeTemplate } from "./serialize.js";
-export { detectLeadingNodes } from "./lead.js";
+export { writeFileSync, copyFileSync } from "./write-if-changed.js";
+export { detectLeadingNodes, deriveDescription } from "./lead.js";
 export type { LeadingNodeInfo } from "./lead.js";
 export type { AstroGenResult, AstroGenOptions, AstroRenderMode } from "./serialize.js";
-export { DEFAULT_BASE_PATH, normalizeBasePath, basePathSegments, joinBaseUrl, buildCurrentPath, } from "./base-path.js";
+export { DEFAULT_BASE_PATH, normalizeBasePath, basePathSegments, joinBaseUrl, buildCurrentPath, parseSiteUrl, combinePrefix, resolvePrefixes, } from "./base-path.js";
 export { buildLlmsTxt, buildSectionLlmsTxt, buildLlmsFullTxt, extractFirstParagraph, } from "./llms-txt.js";
 export type { BuildLlmsTxtOptions, BuildLlmsFullTxtOptions, } from "./llms-txt.js";
-export { exportAstroProject, emitSiteScaffold, emitSiteConfig, emitAstroPages, emitConfigDerivedFiles, emitAgentReadinessFiles, emitSwitcherMap, emitMissingTranslationStubs, } from "./project.js";
-export type { AstroProjectOptions, SwitcherMap } from "./project.js";
+export { assertLeafSitemap, buildSitemap, buildSitemapFiles, buildSitemapIndex } from "./sitemap.js";
+export { buildBlogData, blogAdjacency, emitBlogFiles, indexPageCount, readingMinutes, countWords, BLOG_DEFAULTS, } from "./blog.js";
+export type { BlogEmitConfig, BlogData, BlogPostRef, BlogAdjacency, } from "./blog.js";
+export type { BuildSitemapOptions } from "./sitemap.js";
+export { exportAstroProject, emitSiteScaffold, emitSiteConfig, emitAstroPages, emitConfigDerivedFiles, syncSiteDependencies, copyComponents, emitAgentReadinessFiles, emitSwitcherMap, emitMissingTranslationStubs, emitPassthroughAstroPages, emitDeployArtifacts, workersSubpathOutDir, makeSlugExcluder, dropUnsafeNavHrefs, } from "./project.js";
+export type { AstroProjectOptions, SwitcherMap, PassthroughCopy, } from "./project.js";
 export { emitPluginRuntime } from "./plugins.js";
 export type { EmitPluginRuntimeOptions, PluginClientModulesGroup, PluginStylesGroup, PluginClientConfig, } from "./plugins.js";
 export { buildTaxonomyData, emitTaxonomyForName, emitTaxonomyRoutes, getPageTerms, } from "./taxonomy.js";
 export type { TaxonomyEmitConfig, TaxonomyTerm, TaxonomyPageRef, TaxonomyData, } from "./taxonomy.js";
+export { DIFF_CSS, decorateDiff, diffMarksOf, hasDiffMarks, injectAttrs, inlineSegmentsToHtml, } from "./diff-decoration.js";
+export type { DiffMarks } from "./diff-decoration.js";
+/**
+ * Granularity book view — assemble a nav subtree into one page.
+ *
+ * Exported because it is the PLATFORM generalization of the same algorithm
+ * `format-fluidtopics-rest/src/single-page.ts` implements against khub TOCs:
+ * without an export, no other package could reach it, which is a large part of
+ * why the fold described in that module never happened.
+ *
+ * See plans/granularity-views.md and docs/single-page-view.md.
+ */
+export { BOOK_SEGMENT, assembleBook, bookHeading, bookSlugFrom, estimateTreeBytes, openAsPageNode, rewriteIntraBookLinks, shiftHeadings, slugFromHref, } from "./granularity.js";
+export type { AssembleBookOptions, BookView } from "./granularity.js";
+export { pageUnitPrefix, inPageUnit, normalizeTarget } from "./redirects.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAKvF,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAavB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EACV,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAKtB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAMpE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAKvF,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAKrG,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAaxD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,eAAe,EACf,2BAA2B,EAC3B,yBAAyB,EACzB,mBAAmB,EAKnB,oBAAoB,EACpB,gBAAgB,EAEhB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,eAAe,GAChB,MAAM,cAAc,CAAC;AAKtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EACV,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAKtB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;;;GASG;AACH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,16 +1,23 @@
 // Astro serializer (TreeNode[] → Astro component markup)
 export { treeToAstro, escapeExpr, escapeAttr, escapeTemplate } from "./serialize.js";
+export { writeFileSync, copyFileSync } from "./write-if-changed.js";
 // Auto-lede detection — figures out whether a page tree already
 // has a leading H1 / paragraph so format-astro can decide whether
 // to inject frontmatter title + description at the top of <main>.
 // See plans/auto-lede.md.
-export { detectLeadingNodes } from "./lead.js";
+export { detectLeadingNodes, deriveDescription } from "./lead.js";
 // Base-path helpers — single source of truth for the `basePath` URL
 // prefix shared across project / nav / llms-txt / taxonomy emitters.
 // See plans/configurable-base-path.md.
-export { DEFAULT_BASE_PATH, normalizeBasePath, basePathSegments, joinBaseUrl, buildCurrentPath, } from "./base-path.js";
+export { DEFAULT_BASE_PATH, normalizeBasePath, basePathSegments, joinBaseUrl, buildCurrentPath, parseSiteUrl, combinePrefix, resolvePrefixes, } from "./base-path.js";
 // llms.txt + llms-full.txt builders (LLM discovery files)
 export { buildLlmsTxt, buildSectionLlmsTxt, buildLlmsFullTxt, extractFirstParagraph, } from "./llms-txt.js";
+// Sitemap builders (per-mount, sitemaps.org 0.9)
+export { assertLeafSitemap, buildSitemap, buildSitemapFiles, buildSitemapIndex } from "./sitemap.js";
+// Blog emission — reverse-chron index + post adjacency. The sibling of
+// taxonomy.ts: same data-file + generated-route + writer-override shape,
+// sorted by date instead of grouped by term. See plans/blog-capability.md.
+export { buildBlogData, blogAdjacency, emitBlogFiles, indexPageCount, readingMinutes, countWords, BLOG_DEFAULTS, } from "./blog.js";
 // Project export — orchestrator + per-tier emitters
 //
 // `exportAstroProject` is the high-level entry: generates a complete
@@ -22,7 +29,14 @@ export { buildLlmsTxt, buildSectionLlmsTxt, buildLlmsFullTxt, extractFirstParagr
 // alone; `dogsbay site build` calls `emitAstroPages` +
 // `emitConfigDerivedFiles` + `emitAgentReadinessFiles`. Pure
 // `dogsbay convert --to astro` (Step 7) calls only `emitAstroPages`.
-export { exportAstroProject, emitSiteScaffold, emitSiteConfig, emitAstroPages, emitConfigDerivedFiles, emitAgentReadinessFiles, emitSwitcherMap, emitMissingTranslationStubs, } from "./project.js";
+export { exportAstroProject, emitSiteScaffold, emitSiteConfig, emitAstroPages, emitConfigDerivedFiles, syncSiteDependencies, copyComponents, emitAgentReadinessFiles, emitSwitcherMap, emitMissingTranslationStubs, emitPassthroughAstroPages, emitDeployArtifacts, 
+// Where a Workers subpath-mounted build actually lands. Consumers that
+// read the BUILT site (e.g. `dogsbay site check --dist`) must resolve
+// the same directory the emitter told Astro to write to, or they audit
+// an empty dist/ root.
+workersSubpathOutDir, makeSlugExcluder, 
+// Drops nav hrefs with a scheme other than http(s)/mailto/tel.
+dropUnsafeNavHrefs, } from "./project.js";
 // Plugin runtime codegen — emits the entry, virtual config modules,
 // stylesheets, and Vite alias file each plugin needs to participate
 // in the Astro / Vite build. See plans/plugin-api.md.
@@ -31,4 +45,17 @@ export { emitPluginRuntime } from "./plugins.js";
 // Per declared taxonomy in `dogsbay.config.yml`'s `taxonomies:` block,
 // emits a JSON data file + index/term .astro route files.
 export { buildTaxonomyData, emitTaxonomyForName, emitTaxonomyRoutes, getPageTerms, } from "./taxonomy.js";
+export { DIFF_CSS, decorateDiff, diffMarksOf, hasDiffMarks, injectAttrs, inlineSegmentsToHtml, } from "./diff-decoration.js";
+/**
+ * Granularity book view — assemble a nav subtree into one page.
+ *
+ * Exported because it is the PLATFORM generalization of the same algorithm
+ * `format-fluidtopics-rest/src/single-page.ts` implements against khub TOCs:
+ * without an export, no other package could reach it, which is a large part of
+ * why the fold described in that module never happened.
+ *
+ * See plans/granularity-views.md and docs/single-page-view.md.
+ */
+export { BOOK_SEGMENT, assembleBook, bookHeading, bookSlugFrom, estimateTreeBytes, openAsPageNode, rewriteIntraBookLinks, shiftHeadings, slugFromHref, } from "./granularity.js";
+export { pageUnitPrefix, inPageUnit, normalizeTarget } from "./redirects.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErF,gEAAgE;AAChE,kEAAkE;AAClE,kEAAkE;AAClE,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAI/C,oEAAoE;AACpE,qEAAqE;AACrE,uCAAuC;AACvC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,0DAA0D;AAC1D,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAMvB,oDAAoD;AACpD,EAAE;AACF,qEAAqE;AACrE,kEAAkE;AAClE,mBAAmB;AACnB,EAAE;AACF,gEAAgE;AAChE,sEAAsE;AACtE,uDAAuD;AACvD,6DAA6D;AAC7D,qEAAqE;AACrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AAGtB,oEAAoE;AACpE,oEAAoE;AACpE,sDAAsD;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAQjD,kEAAkE;AAClE,uEAAuE;AACvE,0DAA0D;AAC1D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACb,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEpE,gEAAgE;AAChE,kEAAkE;AAClE,kEAAkE;AAClE,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAIlE,oEAAoE;AACpE,qEAAqE;AACrE,uCAAuC;AACvC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,0DAA0D;AAC1D,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAMvB,iDAAiD;AACjD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAErG,uEAAuE;AACvE,yEAAyE;AACzE,2EAA2E;AAC3E,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,aAAa,GACd,MAAM,WAAW,CAAC;AASnB,oDAAoD;AACpD,EAAE;AACF,qEAAqE;AACrE,kEAAkE;AAClE,mBAAmB;AACnB,EAAE;AACF,gEAAgE;AAChE,sEAAsE;AACtE,uDAAuD;AACvD,6DAA6D;AAC7D,qEAAqE;AACrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,eAAe,EACf,2BAA2B,EAC3B,yBAAyB,EACzB,mBAAmB;AACnB,uEAAuE;AACvE,sEAAsE;AACtE,uEAAuE;AACvE,uBAAuB;AACvB,oBAAoB,EACpB,gBAAgB;AAChB,+DAA+D;AAC/D,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAOtB,oEAAoE;AACpE,oEAAoE;AACpE,sDAAsD;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAQjD,kEAAkE;AAClE,uEAAuE;AACvE,0DAA0D;AAC1D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACb,MAAM,eAAe,CAAC;AAOvB,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B;;;;;;;;;GASG;AACH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lead.d.ts

@@ -1,39 +1,2 @@
-/**
- * Detect whether a page's body tree already provides a level-1
- * heading and / or a leading paragraph.
- *
- * `format-astro` uses this to decide whether to auto-inject the
- * frontmatter `title` and `description` at the top of `<main>` —
- * we never overwrite writer-authored content, only fill in what
- * the body doesn't already cover.
- *
- * See plans/auto-lede.md.
- */
-import type { TreeNode } from "@dogsbay/types";
-export interface LeadingNodeInfo {
-    /**
-     * `true` when `tree[0]` is a level-1 heading. Heading depth
-     * lives at either `node.depth` (some importers) or
-     * `node.props.level` (others); both shapes are recognized.
-     */
-    hasH1: boolean;
-    /**
-     * `true` when the body's first non-heading node is a paragraph.
-     * Used to decide whether the description should be auto-rendered
-     * as a lede `<p>` — if the writer already wrote a lede
-     * paragraph, we leave it alone.
-     *
-     * "First non-heading node" means: `tree[1]` when `tree[0]` is a
-     * heading; otherwise `tree[0]`. So `# Title\nLede paragraph`
-     * yields `{ hasH1: true, hasLede: true }`.
-     */
-    hasLede: boolean;
-}
-/**
- * Inspect the leading nodes of a page tree.
- *
- * Defensive against empty trees and missing properties — returns
- * `false` for both flags when the tree is empty.
- */
-export declare function detectLeadingNodes(tree: TreeNode[] | undefined): LeadingNodeInfo;
+export { detectLeadingNodes, deriveDescription, type LeadingNodeInfo } from "@dogsbay/serialize-core";
 //# sourceMappingURL=lead.d.ts.map

package/dist/lead.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lead.d.ts","sourceRoot":"","sources":["../src/lead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;;;;;;;;OASG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,QAAQ,EAAE,GAAG,SAAS,GAC3B,eAAe,CAcjB"}
+{"version":3,"file":"lead.d.ts","sourceRoot":"","sources":["../src/lead.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC"}