@brett_lamy/docstream 1.18.1 → 1.19.1

package/dist/site/tree.d.ts

@@ -0,0 +1,105 @@
+/** A file's contents: text, or a `Blob` for binary assets (images, models). Pages must be text. */
+export type DocsFileContent = string | Blob;
+export type DocsFiles = Record<string, DocsFileContent> | ReadonlyArray<{
+    path: string;
+    content: DocsFileContent;
+}>;
+export interface DocsPage {
+    /** Source path relative to the docs root, e.g. `01-guides/02-install.md`. */
+    path: string;
+    /** URL path without leading slash: `guides/install`, `""` for the home page. */
+    slug: string;
+    title: string;
+    description?: string;
+    /** The file as written (frontmatter included). */
+    markdown: string;
+    /** The page body as the site renders it: no site-only frontmatter, no leading `# title`. */
+    body: string;
+    /** Frontmatter (all keys), `{}` when there is none. */
+    frontmatter: Record<string, unknown>;
+    hidden: boolean;
+    /** Titles of the sidebar groups/folders above the page, outermost first. */
+    breadcrumbs: string[];
+}
+export type DocsNavItem = {
+    kind: "group";
+    title: string;
+    children: DocsNavItem[];
+} | {
+    kind: "page";
+    title: string;
+    slug: string;
+    children: DocsNavItem[];
+} | {
+    kind: "folder";
+    title: string;
+    children: DocsNavItem[];
+} | {
+    kind: "link";
+    title: string;
+    href: string;
+};
+export interface DocsTree {
+    /** Every page, sidebar order first, then pages the sidebar leaves out. */
+    pages: DocsPage[];
+    /** Pages in reading order (what Previous / Next walk): listed, not hidden. */
+    order: DocsPage[];
+    nav: DocsNavItem[];
+    bySlug: Map<string, DocsPage>;
+    byPath: Map<string, DocsPage>;
+    /** The common folder stripped from every input path (`"docs/"`), or `""`. */
+    root: string;
+    /** Every non-Markdown file under the root, by path relative to it (`specs/api.json`). */
+    assets: Map<string, DocsFileContent>;
+}
+export interface BuildDocsTreeOptions {
+    /** Folder to treat as the docs root; default: the deepest folder shared by every Markdown file. */
+    root?: string;
+    /** Extra file filter, applied after the Markdown filter. */
+    include?: (path: string) => boolean;
+    /** Use `SUMMARY.md` when there is one (default true). */
+    summary?: boolean;
+    /** Sidebar title for a folder without a README, given its name with the prefix removed. */
+    folderTitle?: (name: string, path: string) => string;
+}
+/** Frontmatter keys that describe the page to the site rather than the reader. */
+export declare const SITE_FRONTMATTER_KEYS: readonly ["title", "description", "order", "hidden", "icon"];
+export declare function isMarkdownPath(path: string): boolean;
+/** `./docs//a/../b.md` → `docs/b.md`. Leading slashes and `.` segments are dropped. */
+export declare function normalizePath(path: string): string;
+/** `"03-quick-start"` → `{ name: "quick-start", order: 3 }`. */
+export declare function stripOrderPrefix(name: string): {
+    name: string;
+    order?: number;
+};
+/** `"quick-start"` → `"Quick start"`; `"api_reference"` → `"Api reference"`. */
+export declare function humanize(name: string): string;
+/** The URL slug for a source path: `01-guides/README.md` → `guides`, `README.md` → `""`. */
+export declare function slugForPath(path: string): string;
+/** Resolve `href` (as written in `fromPath`'s Markdown) against the docs root; null when external. */
+export declare function resolveRelativePath(fromPath: string, href: string): {
+    path: string;
+    hash: string;
+} | null;
+interface Frontmatter {
+    values: Record<string, unknown>;
+    /** Byte length of the `---` block (and the blank lines after it), 0 when absent. */
+    length: number;
+}
+export declare function readFrontmatter(markdown: string): Frontmatter;
+/** Inline Markdown in a heading → plain text for the sidebar and `<title>`. */
+export declare function plainTitle(text: string): string;
+/** Build pages and the sidebar from a set of files. Non-Markdown files are ignored. */
+export declare function buildDocsTree(files: DocsFiles, options?: BuildDocsTreeOptions): DocsTree;
+/** The asset (non-Markdown file) `href` names from `from`, with its root-relative path; null when none. */
+export declare function findLinkedAsset(tree: DocsTree, from: DocsPage, href: string): {
+    path: string;
+    content: DocsFileContent;
+} | null;
+/** The page `href` points at from `from` — a relative `.md` path, a folder, or a slug. */
+export declare function findLinkedPage(tree: DocsTree, from: DocsPage, href: string): {
+    page: DocsPage;
+    hash: string;
+} | null;
+export {};
+//# sourceMappingURL=tree.d.ts.map

package/dist/site/tree.d.ts.map

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

package/dist/site/tree.js

@@ -0,0 +1,411 @@
+/* A docs site from a virtual file system: every Markdown file becomes a page, and the
+   folder structure (or a GitBook `SUMMARY.md`) becomes the sidebar.
+
+   Conventions, GitBook's where it has one:
+   - `README.md` (or `index.md`) is its folder's page; the top-level one is the home page.
+   - `SUMMARY.md` at the root, when present, *is* the sidebar: `## Group` headings and
+     nested `* [Title](path.md)` lists. Pages it leaves out stay reachable by URL.
+   - Without one, top-level folders become sidebar groups and deeper folders nest.
+   - Numeric prefixes (`01-intro.md`, `2_guides/`) order entries and are dropped from URLs
+     and titles. Frontmatter `order` overrides the prefix.
+   - A page's title is, in order: its SUMMARY.md label, frontmatter `title`, its first
+     `# heading`, then the file name (`quick-start.md` → "Quick start"). Frontmatter
+     `description` is its lede and `hidden: true` keeps it out of the sidebar.
+   - Every other file in the docs root is an asset (`tree.assets`): DocsSite serves it to the
+     pages, so `![logo](images/logo.svg)` or an OpenAPI block's `[api](specs/api.json)` loads
+     the file from the VFS.
+   Everything here is pure (no React, no DOM), so a static build or a test can use it. */
+import { parseDocument, isMap } from "yaml";
+/** Frontmatter keys that describe the page to the site rather than the reader. */
+export const SITE_FRONTMATTER_KEYS = ["title", "description", "order", "hidden", "icon"];
+const MARKDOWN = /\.(md|markdown|mdx)$/i;
+const INDEX = /^(readme|index)$/i;
+const PREFIX = /^(\d+)[-_. ]+(?=.)/;
+const isBlob = (v) => typeof Blob !== "undefined" && v instanceof Blob;
+export function isMarkdownPath(path) {
+    return MARKDOWN.test(path);
+}
+/** `./docs//a/../b.md` → `docs/b.md`. Leading slashes and `.` segments are dropped. */
+export function normalizePath(path) {
+    const out = [];
+    for (const part of path.replace(/\\/g, "/").split("/")) {
+        if (!part || part === ".")
+            continue;
+        if (part === "..")
+            out.pop();
+        else
+            out.push(part);
+    }
+    return out.join("/");
+}
+/** `"03-quick-start"` → `{ name: "quick-start", order: 3 }`. */
+export function stripOrderPrefix(name) {
+    const m = PREFIX.exec(name);
+    return m ? { name: name.slice(m[0].length), order: Number(m[1]) } : { name };
+}
+/** `"quick-start"` → `"Quick start"`; `"api_reference"` → `"Api reference"`. */
+export function humanize(name) {
+    const words = name.replace(/[-_]+/g, " ").replace(/\s+/g, " ").trim();
+    return words ? words[0].toUpperCase() + words.slice(1) : name;
+}
+const segmentSlug = (segment) => encodeURIComponent(stripOrderPrefix(segment).name.replace(/\s+/g, "-")).replace(/%2F/g, "/");
+/** The URL slug for a source path: `01-guides/README.md` → `guides`, `README.md` → `""`. */
+export function slugForPath(path) {
+    const parts = normalizePath(path).replace(MARKDOWN, "").split("/");
+    if (INDEX.test(parts[parts.length - 1] ?? ""))
+        parts.pop();
+    return parts.map(segmentSlug).join("/");
+}
+/** Resolve `href` (as written in `fromPath`'s Markdown) against the docs root; null when external. */
+export function resolveRelativePath(fromPath, href) {
+    if (/^[a-z][a-z0-9+.-]*:/i.test(href) || href.startsWith("//"))
+        return null;
+    const hashAt = href.indexOf("#");
+    const raw = hashAt >= 0 ? href.slice(0, hashAt) : href;
+    const hash = hashAt >= 0 ? href.slice(hashAt + 1) : "";
+    const clean = raw.split("?")[0];
+    let decoded = clean;
+    try {
+        decoded = decodeURI(clean);
+    }
+    catch {
+        // keep as written
+    }
+    if (!decoded)
+        return { path: normalizePath(fromPath), hash };
+    const dir = fromPath.includes("/") ? fromPath.slice(0, fromPath.lastIndexOf("/")) : "";
+    const path = decoded.startsWith("/") ? normalizePath(decoded) : normalizePath(`${dir}/${decoded}`);
+    return { path, hash };
+}
+const FRONTMATTER = /^---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/;
+export function readFrontmatter(markdown) {
+    const m = FRONTMATTER.exec(markdown);
+    if (!m)
+        return { values: {}, length: 0 };
+    let values = {};
+    try {
+        const doc = parseDocument(m[1]);
+        if (!doc.errors.length && isMap(doc.contents))
+            values = (doc.toJS() ?? {});
+    }
+    catch {
+        // Unreadable YAML stays in the body, where the property sheet reports it.
+        return { values: {}, length: 0 };
+    }
+    const rest = markdown.slice(m[0].length);
+    return { values, length: m[0].length + (rest.length - rest.replace(/^(?:[ \t]*\r?\n)+/, "").length) };
+}
+const H1 = /^#[ \t]+(.+?)[ \t]*#*[ \t]*$/;
+const FENCE = /^(`{3,}|~{3,})/;
+/** The first line that is a `# heading` before any other content, with its offsets. */
+function leadingH1(body) {
+    let offset = 0;
+    for (const line of body.split("\n")) {
+        const t = line.replace(/\r$/, "");
+        if (t.trim() === "") {
+            offset += line.length + 1;
+            continue;
+        }
+        const m = H1.exec(t);
+        if (!m)
+            return null;
+        const after = body.slice(offset + line.length + 1);
+        return { text: m[1], end: offset + line.length + 1 + (after.length - after.replace(/^(?:[ \t]*\r?\n)+/, "").length) };
+    }
+    return null;
+}
+/** The first `# heading` anywhere outside code fences (for titles only). */
+function firstH1(body) {
+    let fence = null;
+    for (const line of body.split("\n")) {
+        const f = FENCE.exec(line.trim());
+        if (f) {
+            if (!fence)
+                fence = f[1][0];
+            else if (f[1][0] === fence)
+                fence = null;
+            continue;
+        }
+        if (fence)
+            continue;
+        const m = H1.exec(line.replace(/\r$/, ""));
+        if (m)
+            return m[1];
+    }
+    return null;
+}
+/** Inline Markdown in a heading → plain text for the sidebar and `<title>`. */
+export function plainTitle(text) {
+    return text
+        .replace(/!\[([^\]]*)\]\([^)]*\)/g, "$1")
+        .replace(/\[([^\]]*)\]\([^)]*\)/g, "$1")
+        .replace(/`([^`]*)`/g, "$1")
+        .replace(/(\*\*|__|\*|_|~~)(.+?)\1/g, "$2")
+        .replace(/\\([\\`*_{}[\]()#+\-.!@])/g, "$1")
+        .trim();
+}
+function toEntries(files) {
+    return Array.isArray(files)
+        ? files.map((f) => ({ path: f.path, content: f.content }))
+        : Object.entries(files).map(([path, content]) => ({ path, content }));
+}
+function commonRoot(paths) {
+    if (!paths.length)
+        return "";
+    const dirs = paths.map((p) => p.split("/").slice(0, -1));
+    const first = dirs[0];
+    let n = first.length;
+    for (const d of dirs) {
+        let i = 0;
+        while (i < n && i < d.length && d[i] === first[i])
+            i++;
+        n = i;
+    }
+    return n ? `${first.slice(0, n).join("/")}/` : "";
+}
+function draftPage(path, markdown) {
+    const fm = readFrontmatter(markdown);
+    const fmKeys = Object.keys(fm.values);
+    const siteOnly = fmKeys.every((k) => SITE_FRONTMATTER_KEYS.includes(k));
+    let body = siteOnly ? markdown.slice(fm.length) : markdown;
+    const fmTitle = typeof fm.values.title === "string" ? fm.values.title : undefined;
+    let title = fmTitle;
+    // The site renders the title itself, so a leading `# Title` leaves the body.
+    if (siteOnly) {
+        const h1 = leadingH1(body);
+        if (h1) {
+            title ??= plainTitle(h1.text);
+            body = body.slice(h1.end);
+        }
+    }
+    title ??= (() => {
+        const h = firstH1(markdown.slice(fm.length));
+        return h ? plainTitle(h) : undefined;
+    })();
+    const parts = path.replace(MARKDOWN, "").split("/");
+    const file = parts[parts.length - 1];
+    const named = INDEX.test(file) ? parts[parts.length - 2] : file;
+    const fromFile = !title;
+    title ??= named ? humanize(stripOrderPrefix(named).name) : "Home";
+    const order = typeof fm.values.order === "number" ? fm.values.order : stripOrderPrefix(INDEX.test(file) ? (parts[parts.length - 2] ?? "") : file).order;
+    return {
+        path,
+        slug: slugForPath(path),
+        title,
+        description: typeof fm.values.description === "string" ? fm.values.description : undefined,
+        markdown,
+        body,
+        frontmatter: fm.values,
+        hidden: fm.values.hidden === true,
+        breadcrumbs: [],
+        order,
+        titleFromFile: fromFile,
+    };
+}
+const byOrder = (a, b) => (a.order ?? Number.POSITIVE_INFINITY) - (b.order ?? Number.POSITIVE_INFINITY) || a.title.localeCompare(b.title);
+function folderTree(drafts) {
+    const root = { name: "", path: "", pages: [], folders: new Map() };
+    for (const d of drafts) {
+        const parts = d.path.split("/");
+        const file = parts.pop();
+        let node = root;
+        for (const part of parts) {
+            let next = node.folders.get(part);
+            if (!next) {
+                next = { name: part, path: node.path ? `${node.path}/${part}` : part, pages: [], folders: new Map() };
+                node.folders.set(part, next);
+            }
+            node = next;
+        }
+        if (INDEX.test(file.replace(MARKDOWN, "")) && !node.index)
+            node.index = d;
+        else
+            node.pages.push(d);
+    }
+    return root;
+}
+function autoNav(root, folderTitle) {
+    const folderItem = (f, crumbs) => {
+        const title = f.index && !f.index.titleFromFile ? f.index.title : folderTitle(stripOrderPrefix(f.name).name, f.path);
+        const children = entries(f, [...crumbs, title]);
+        if (f.index)
+            f.index.breadcrumbs = crumbs;
+        const order = f.index?.frontmatter.order ?? stripOrderPrefix(f.name).order;
+        return {
+            item: f.index && !f.index.hidden ? { kind: "page", title, slug: f.index.slug, children } : { kind: "folder", title, children },
+            order,
+            title,
+        };
+    };
+    const entries = (f, crumbs) => {
+        const list = [];
+        for (const p of f.pages) {
+            p.breadcrumbs = crumbs;
+            if (!p.hidden)
+                list.push({ item: { kind: "page", title: p.title, slug: p.slug, children: [] }, order: p.order, title: p.title });
+        }
+        for (const sub of f.folders.values()) {
+            const e = folderItem(sub, crumbs);
+            if (e.item.kind === "page" || (e.item.kind === "folder" && e.item.children.length))
+                list.push(e);
+        }
+        return list.sort(byOrder).map((e) => e.item);
+    };
+    const top = [];
+    if (root.index) {
+        root.index.breadcrumbs = [];
+        if (!root.index.hidden)
+            top.push({ kind: "page", title: root.index.title, slug: root.index.slug, children: [] });
+    }
+    // Loose top-level pages come first, then one group per top-level folder.
+    const loose = [];
+    for (const p of root.pages) {
+        p.breadcrumbs = [];
+        if (!p.hidden)
+            loose.push({ item: { kind: "page", title: p.title, slug: p.slug, children: [] }, order: p.order, title: p.title });
+    }
+    top.push(...loose.sort(byOrder).map((e) => e.item));
+    const groups = [...root.folders.values()]
+        .map((f) => {
+        const title = f.index && !f.index.titleFromFile ? f.index.title : folderTitle(stripOrderPrefix(f.name).name, f.path);
+        const children = entries(f, [title]);
+        if (f.index) {
+            f.index.breadcrumbs = [title];
+            if (!f.index.hidden)
+                children.unshift({ kind: "page", title: "Overview", slug: f.index.slug, children: [] });
+        }
+        return { item: { kind: "group", title, children }, order: f.index?.frontmatter.order ?? stripOrderPrefix(f.name).order, title };
+    })
+        .filter((g) => g.item.kind === "group" && g.item.children.length)
+        .sort(byOrder);
+    top.push(...groups.map((g) => g.item));
+    return top;
+}
+const LIST_ITEM = /^(\s*)[*+-][ \t]+\[([^\]]*)\]\(([^)\s]*)(?:\s+"[^"]*")?\)\s*$/;
+const GROUP = /^#{1,6}[ \t]+(.+?)[ \t]*#*[ \t]*$/;
+/** GitBook's SUMMARY.md: `## Group` headings, nested `* [Title](path.md)` lists, `---` ignored. */
+function summaryNav(summary, summaryPath, byPath) {
+    const top = [];
+    let group = null;
+    const stack = [];
+    let firstHeading = true;
+    for (const line of summary.split("\n")) {
+        const t = line.replace(/\r$/, "");
+        const g = GROUP.exec(t);
+        if (g) {
+            // The first `# Table of contents` heading is the file's own title, not a group.
+            if (firstHeading && /^#\s/.test(t) && /contents|summary/i.test(g[1])) {
+                firstHeading = false;
+                continue;
+            }
+            firstHeading = false;
+            group = { kind: "group", title: plainTitle(g[1]), children: [] };
+            top.push(group);
+            stack.length = 0;
+            continue;
+        }
+        const m = LIST_ITEM.exec(t);
+        if (!m)
+            continue;
+        firstHeading = false;
+        const indent = m[1].replace(/\t/g, "  ").length;
+        const label = plainTitle(m[2]);
+        const href = m[3];
+        while (stack.length && stack[stack.length - 1].indent >= indent)
+            stack.pop();
+        const parent = stack[stack.length - 1];
+        const siblings = parent ? parent.children : group ? group.children : top;
+        const crumbs = parent ? parent.crumbs : group ? [group.title] : [];
+        const resolved = resolveRelativePath(summaryPath, href);
+        const page = resolved ? byPath.get(resolved.path) : undefined;
+        let item;
+        if (page) {
+            page.title = label || page.title;
+            page.breadcrumbs = crumbs;
+            item = { kind: "page", title: page.title, slug: page.slug, children: [] };
+        }
+        else if (!href || !resolved) {
+            item = href ? { kind: "link", title: label, href } : { kind: "folder", title: label, children: [] };
+        }
+        else {
+            continue;
+        }
+        siblings.push(item);
+        if (item.kind === "page" || item.kind === "folder")
+            stack.push({ indent, children: item.children, crumbs: [...crumbs, label] });
+    }
+    return top;
+}
+function walkPages(nav, bySlug, out = []) {
+    for (const item of nav) {
+        if (item.kind === "page") {
+            const p = bySlug.get(item.slug);
+            if (p && !out.includes(p))
+                out.push(p);
+        }
+        if (item.kind !== "link")
+            walkPages(item.children, bySlug, out);
+    }
+    return out;
+}
+/** Build pages and the sidebar from a set of files. Non-Markdown files are ignored. */
+export function buildDocsTree(files, options = {}) {
+    const all = toEntries(files)
+        .map((f) => ({ path: normalizePath(f.path), content: f.content }))
+        .filter((f) => !options.include || options.include(f.path));
+    const entries = all.filter((f) => isMarkdownPath(f.path) && typeof f.content === "string");
+    const root = options.root !== undefined ? (normalizePath(options.root) ? `${normalizePath(options.root)}/` : "") : commonRoot(entries.map((f) => f.path));
+    const inRoot = entries.filter((f) => f.path.startsWith(root)).map((f) => ({ path: f.path.slice(root.length), content: f.content }));
+    const assets = new Map();
+    for (const f of all) {
+        if (!isMarkdownPath(f.path) && f.path.startsWith(root) && (typeof f.content === "string" || isBlob(f.content))) {
+            assets.set(f.path.slice(root.length), f.content);
+        }
+    }
+    const summaryFile = options.summary === false ? undefined : inRoot.find((f) => /^summary\.md$/i.test(f.path));
+    const drafts = inRoot.filter((f) => f !== summaryFile).map((f) => draftPage(f.path, f.content));
+    const byPath = new Map(drafts.map((d) => [d.path, d]));
+    const folderTitle = options.folderTitle ?? ((name) => humanize(name));
+    const nav = summaryFile ? summaryNav(summaryFile.content, summaryFile.path, byPath) : autoNav(folderTree(drafts), folderTitle);
+    const bySlug = new Map();
+    for (const d of drafts)
+        if (!bySlug.has(d.slug))
+            bySlug.set(d.slug, d);
+    const listed = walkPages(nav, bySlug);
+    const pages = [...listed, ...drafts.filter((d) => !listed.includes(d))].map(({ order: _order, titleFromFile: _fromFile, ...page }) => page);
+    // Keep the maps pointing at the cleaned objects.
+    const finalBySlug = new Map();
+    const finalByPath = new Map();
+    for (const p of pages) {
+        if (!finalBySlug.has(p.slug))
+            finalBySlug.set(p.slug, p);
+        finalByPath.set(p.path, p);
+    }
+    const order = listed.map((p) => finalBySlug.get(p.slug)).filter((p) => !p.hidden);
+    return { pages, order, nav, bySlug: finalBySlug, byPath: finalByPath, root, assets };
+}
+/** The asset (non-Markdown file) `href` names from `from`, with its root-relative path; null when none. */
+export function findLinkedAsset(tree, from, href) {
+    const resolved = resolveRelativePath(from.path, href);
+    if (!resolved)
+        return null;
+    const content = tree.assets.get(resolved.path);
+    return content === undefined ? null : { path: resolved.path, content };
+}
+/** The page `href` points at from `from` — a relative `.md` path, a folder, or a slug. */
+export function findLinkedPage(tree, from, href) {
+    const resolved = resolveRelativePath(from.path, href);
+    if (!resolved)
+        return null;
+    const { path, hash } = resolved;
+    if (!href.split("#")[0])
+        return { page: from, hash };
+    const direct = tree.byPath.get(path) ??
+        tree.byPath.get(`${path}/README.md`) ??
+        tree.byPath.get(`${path}/readme.md`) ??
+        tree.byPath.get(`${path}/index.md`) ??
+        tree.bySlug.get(path) ??
+        tree.bySlug.get(slugForPath(path));
+    return direct ? { page: direct, hash } : null;
+}
+//# sourceMappingURL=tree.js.map

package/dist/site/tree.js.map

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

package/dist/styles.css

@@ -1,5 +1,6 @@
 @import "./docs/properties.css";
 @import "./docs/tasks.css";
+@import "./site/site.css";
 
 [data-docstream],
 .docs-article {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brett_lamy/docstream",
-  "version": "1.18.1",
+  "version": "1.19.1",
   "description": "GitBook-aware readonly markdown and AI stream renderer.",
   "publishConfig": {
     "access": "public"
@@ -136,6 +136,13 @@
       "import": "./dist/vite/index.js",
       "default": "./dist/vite/index.js"
     },
+    "./site": {
+      "source": "./src/site/index.ts",
+      "types": "./dist/site/index.d.ts",
+      "import": "./dist/site/index.js",
+      "default": "./dist/site/index.js"
+    },
+    "./site/styles.css": "./dist/site/site.css",
     "./styles.css": "./dist/styles.css"
   },
   "dependencies": {

package/src/docs/DocsRenderer.tsx

@@ -358,8 +358,10 @@ function BlockView({ block, liveRenderer, sourceRenderer }: { block: Block } & R
     }
     case "heading": {
       const Tag = `h${block.level}` as const
+      // The same anchor `documentOutline` reports, so a table of contents can link to it.
+      const text = plainText(block.children)
       return (
-        <Tag>
+        <Tag id={text ? slugify(text) : undefined}>
           <InlineText nodes={block.children} />
         </Tag>
       )
@@ -483,7 +485,7 @@ function BlockView({ block, liveRenderer, sourceRenderer }: { block: Block } & R
         <a className="docs-content-ref" href={block.url}>
           <File className="size-4" />
           <span>
-            <InlineText nodes={block.children} />
+            <InlineText nodes={withoutLinks(block.children)} />
           </span>
           <ChevronRight className="size-4 ml-auto" />
         </a>
@@ -520,7 +522,7 @@ function BlockView({ block, liveRenderer, sourceRenderer }: { block: Block } & R
     case "list": {
       const Tag = block.ordered ? "ol" : "ul"
       return (
-        <Tag className={block.task ? "docs-tasklist" : undefined}>
+        <Tag className={block.task ? "docs-tasklist" : undefined} start={block.ordered && block.start !== undefined && block.start !== 1 ? block.start : undefined}>
           {block.items.map((item, i) => (
             <li key={i} data-task-state={block.task ? getTaskState(item) : undefined}>
               {block.task && <TaskCheckbox state={getTaskState(item)} label={item.children.filter((b) => b.type === "paragraph").map((b) => b.type === "paragraph" ? plainText(b.children) : "").join(" ") || "Task"}
@@ -662,6 +664,15 @@ function Blocks({ blocks, inline, liveRenderer, sourceRenderer }: { blocks: Bloc
   )
 }
 
+/** A card that is itself a link shows its label's links as text: an `<a>` can't hold another. */
+function withoutLinks(nodes: Inline[]): Inline[] {
+  return nodes.map((n) => {
+    if (n.type === "reference" || !("link" in n) || n.link === undefined) return n
+    const { link: _link, ...rest } = n as Inline & { link?: string }
+    return rest as Inline
+  })
+}
+
 export interface DocRenderOptions {
   /** Make rendered task checkboxes interactive. Update the supplied item and re-render to persist a choice. */
   onTaskStateChange?: TaskStateChangeHandler