svelte-docsmith 0.11.0 → 0.12.1

package/dist/buildtime/archive.js

@@ -7,6 +7,7 @@
  * Kept here rather than in `bin/` so they are typechecked and unit-tested; the
  * CLI is a thin wrapper over them. See `docs/adr/0002-archives-are-rewritten-source-copies.md`.
  */
+import { atBoundary, firstSegmentUnder } from '../utils/url.js';
 import { outsideCodeFences, withFrontmatter } from './markdown-source.js';
 /** Route files at the docs root that an archive nested inside it already inherits. */
 export function isInheritedRouteFile(name) {
@@ -28,10 +29,11 @@ export function rewriteDocsLinks(text, options) {
     const skip = new Set([...(options.archivedIds ?? []), versionId]);
     const pattern = new RegExp(`(\\]\\(|href="|href='|\\]:[ \\t]+)(${escapeRe(docsBase)})([^)"'\\s]*)`, 'g');
     return outsideCodeFences(text, (chunk) => chunk.replace(pattern, (match, prefix, base, rest) => {
-        // Guard the segment boundary: `/docsmith` must not become `/docs/v1mith`.
-        if (rest && !/^[/#?]/.test(rest))
+        // The regex has already matched the base, so guard the boundary on what
+        // follows it: `/docsmith` must not become `/docs/v1mith`.
+        if (!atBoundary(rest))
             return match;
-        const firstSegment = rest.startsWith('/') ? rest.slice(1).split(/[/#?]/)[0] : '';
+        const firstSegment = firstSegmentUnder(rest, '');
         if (firstSegment && skip.has(firstSegment))
             return match;
         return `${prefix}${base}/${versionId}${rest}`;

package/dist/buildtime/cli/archive-version.js

@@ -13,7 +13,7 @@ import path from 'node:path';
 import { assertValidVersionId } from '../../core/version.js';
 import { freezeLastUpdated, isInheritedRouteFile, rewriteDocsLinks } from '../archive.js';
 import { ARCHIVE_MARKER, discoverArchives, markerContents } from '../archives.js';
-import { lastCommitDate } from '../git.js';
+import { commitDates } from '../git.js';
 import { docsBaseFrom } from '../paths.js';
 import { isPageFile } from '../vite/pages.js';
 import { CliError } from './error.js';
@@ -79,6 +79,14 @@ export function archiveVersion(options, log) {
                 yield { file, source: path.join(contentDir, path.relative(toDir, file)) };
         }
     }
+    // Read the dates before copying, so the walk sees the docs root as it was
+    // rather than a tree half full of untracked copies. Say so if they could not
+    // be read: an archive is written once and never edited again, so a page that
+    // misses its date here keeps the wrong one for good.
+    const dates = commitDates(contentDir, (reason) => {
+        log(`\n! Could not read commit dates: ${reason}`);
+        log('  Archived pages will keep no last-updated date.\n');
+    });
     copyCurrent(contentDir, toDir);
     fs.writeFileSync(path.join(toDir, ARCHIVE_MARKER), markerContents(id));
     let pages = 0;
@@ -87,12 +95,15 @@ export function archiveVersion(options, log) {
             continue;
         pages++;
         const text = fs.readFileSync(file, 'utf-8');
-        fs.writeFileSync(file, freezeLastUpdated(rewriteDocsLinks(text, { docsBase, versionId: id, archivedIds }), lastCommitDate(source)));
+        fs.writeFileSync(file, freezeLastUpdated(rewriteDocsLinks(text, { docsBase, versionId: id, archivedIds }), dates.get(source)));
     }
     log(`\n✓ Archived the current docs into ${rel(toDir)} (${pages} pages)\n`);
-    log('Links were rewritten to stay inside the archive, and each page kept');
-    log('its real last-updated date. Review the diff, then update');
-    log('docsmith({ versions }) so the archive is served:\n');
+    log('Links were rewritten to stay inside the archive.');
+    // Only claim the dates were kept when the walk actually produced some.
+    if (dates.size)
+        log('Each page kept its real last-updated date.');
+    log('Review the diff, then update docsmith({ versions }) so the archive');
+    log('is served:\n');
     log('  versions: {');
     log("    current: { id: '<new release>', label: '<new release>' },");
     log(`    archived: [{ id: '${id}', label: '${label}' }${archivedIds.size ? ', …' : ''}]`);

package/dist/buildtime/git.d.ts

@@ -1,5 +1,33 @@
-/** Commit day (`YYYY-MM-DD`) a file last changed, or undefined outside a repo. */
-export declare function lastCommitDate(file: string): string | undefined;
+/**
+ * Commit day (`YYYY-MM-DD`) every tracked file under `dir` last changed, keyed by
+ * absolute path. One history walk rather than a `git log` per file: the per-file
+ * form costs a process each, which is the build's largest single expense once a
+ * site has more than a handful of pages.
+ *
+ * `--relative` makes git print paths relative to `dir`, so they join straight
+ * back onto it with no second call to find the repository root. `--no-renames`
+ * makes a rename list both of its paths, which keeps the answer identical to
+ * asking about one file at a time.
+ *
+ * An empty map for a directory outside a repository, or one git could not read.
+ * That is the same "no date" every caller already handles, and it is deliberately
+ * all-or-nothing: a truncated read would date some pages and not others, which
+ * looks like real data and is not.
+ *
+ * Only a truncated read calls `onFail`, because it is the one failure that would
+ * otherwise date some pages and not others. A directory outside a repository, a
+ * missing directory, or a machine without git all yield no dates, which every
+ * caller already handles and which the plugin already reports where it matters.
+ * Reporting is the caller's to do, which is why this takes a callback rather
+ * than writing to the console itself.
+ */
+export declare function commitDates(dir: string, onFail?: (reason: string) => void, 
+/**
+ * Cap on the walk's output. The default is far above any real docs root; it is
+ * a parameter so the truncation path can be exercised without a repository
+ * large enough to produce 256 MB of history.
+ */
+maxBuffer?: number): Map<string, string>;
 /**
  * Release dates keyed by version, read from the commit that introduced each
  * `## <version>` heading in a changelog. Changesets does not write dates, and a

package/dist/buildtime/git.js

@@ -12,14 +12,64 @@
  */
 import { spawnSync } from 'node:child_process';
 import path from 'node:path';
-/** Commit day (`YYYY-MM-DD`) a file last changed, or undefined outside a repo. */
-export function lastCommitDate(file) {
-    const res = spawnSync('git', ['log', '-1', '--format=%cs', '--', file], {
-        cwd: path.dirname(file),
-        encoding: 'utf-8'
-    });
-    const date = res.status === 0 ? res.stdout.trim() : '';
-    return date || undefined;
+/**
+ * Commit day (`YYYY-MM-DD`) every tracked file under `dir` last changed, keyed by
+ * absolute path. One history walk rather than a `git log` per file: the per-file
+ * form costs a process each, which is the build's largest single expense once a
+ * site has more than a handful of pages.
+ *
+ * `--relative` makes git print paths relative to `dir`, so they join straight
+ * back onto it with no second call to find the repository root. `--no-renames`
+ * makes a rename list both of its paths, which keeps the answer identical to
+ * asking about one file at a time.
+ *
+ * An empty map for a directory outside a repository, or one git could not read.
+ * That is the same "no date" every caller already handles, and it is deliberately
+ * all-or-nothing: a truncated read would date some pages and not others, which
+ * looks like real data and is not.
+ *
+ * Only a truncated read calls `onFail`, because it is the one failure that would
+ * otherwise date some pages and not others. A directory outside a repository, a
+ * missing directory, or a machine without git all yield no dates, which every
+ * caller already handles and which the plugin already reports where it matters.
+ * Reporting is the caller's to do, which is why this takes a callback rather
+ * than writing to the console itself.
+ */
+export function commitDates(dir, onFail, 
+/**
+ * Cap on the walk's output. The default is far above any real docs root; it is
+ * a parameter so the truncation path can be exercised without a repository
+ * large enough to produce 256 MB of history.
+ */
+maxBuffer = 256 * 1024 * 1024) {
+    const dates = new Map();
+    const res = spawnSync('git', ['log', '--format=%cs', '--name-only', '--relative', '--no-renames', '--', '.'], 
+    // The 1 MB default would truncate rather than throw on a large history,
+    // which is why the cap is raised and the result checked below.
+    { cwd: dir, encoding: 'utf-8', maxBuffer });
+    // `ENOBUFS` is the output outgrowing maxBuffer, which truncates rather than
+    // throws and is the only failure that could leave a half-filled map. `ENOENT`
+    // (no such directory, or no git installed) and a non-zero status ("not a
+    // repository") both mean no dates at all, which is a state callers expect.
+    if (res.error?.code === 'ENOBUFS') {
+        onFail?.(res.error.message);
+    }
+    if (res.error || res.status !== 0)
+        return dates;
+    let date;
+    for (const line of res.stdout.split('\n')) {
+        if (!line)
+            continue;
+        if (/^\d{4}-\d{2}-\d{2}$/.test(line)) {
+            date = line;
+            continue;
+        }
+        // Newest commit first, so the first date a file appears under is its latest.
+        const file = path.resolve(dir, line);
+        if (date && !dates.has(file))
+            dates.set(file, date);
+    }
+    return dates;
 }
 /**
  * Release dates keyed by version, read from the commit that introduced each

package/dist/buildtime/paths.d.ts

@@ -1,7 +1,12 @@
+/**
+ * The URL a directory under the routes root is served at: `<routes>/docs/intro`
+ * becomes `/docs/intro`. The routes root itself becomes `/`.
+ */
+export declare function urlFor(routesDir: string, dir: string): string;
 /**
  * The docs URL base, e.g. `/docs`, from the content directory's location under
- * the routes directory. This is the same mapping the collectors use to turn a
- * page's directory into its URL, so a page at `<routes>/docs/intro/+page.md` is
- * served at `/docs/intro` under a base of `/docs`.
+ * the routes directory. The same mapping a page's own directory goes through, so
+ * a page at `<routes>/docs/intro/+page.md` is served at `/docs/intro` under a
+ * base of `/docs`.
  */
 export declare function docsBaseFrom(routesDir: string, contentDir: string): string;

package/dist/buildtime/paths.js

@@ -4,12 +4,20 @@
  * separately is how they drift.
  */
 import path from 'node:path';
+/**
+ * The URL a directory under the routes root is served at: `<routes>/docs/intro`
+ * becomes `/docs/intro`. The routes root itself becomes `/`.
+ */
+export function urlFor(routesDir, dir) {
+    const rel = path.relative(routesDir, dir).split(path.sep).join('/');
+    return '/' + rel;
+}
 /**
  * The docs URL base, e.g. `/docs`, from the content directory's location under
- * the routes directory. This is the same mapping the collectors use to turn a
- * page's directory into its URL, so a page at `<routes>/docs/intro/+page.md` is
- * served at `/docs/intro` under a base of `/docs`.
+ * the routes directory. The same mapping a page's own directory goes through, so
+ * a page at `<routes>/docs/intro/+page.md` is served at `/docs/intro` under a
+ * base of `/docs`.
  */
 export function docsBaseFrom(routesDir, contentDir) {
-    return '/' + path.relative(routesDir, contentDir).split(path.sep).join('/');
+    return urlFor(routesDir, contentDir);
 }

package/dist/buildtime/vite/collect.d.ts

@@ -1,24 +1,33 @@
 import type { DocsContentItem, LlmsDoc, SearchDoc } from '../../core/content.js';
 import type { DocsVersions } from '../../core/version.js';
+import { type SourcePage } from './pages.js';
+/** Where the pages sit, which is what turns a page's file into a URL and a version. */
+export type IndexOptions = {
+    /** The docs root the pages were read from. */
+    contentDir: string;
+    /** Routes root, so `<routes>/docs/intro/+page.md` becomes `/docs/intro`. */
+    routesDir: string;
+    /** Declared versions, when the site has them. */
+    versions?: DocsVersions;
+};
 /**
- * Scan `contentDir` for `+page.md`/`+page.svx` files and read the frontmatter
- * fields the sidebar needs (plus the heading list for a server-rendered TOC and
- * an estimated reading time), deriving each page's URL from its directory
- * relative to `routesDir`. Pure and synchronous so it can be unit-tested.
+ * The sidebar's index: the frontmatter fields navigation needs, plus the heading
+ * list for a server-rendered TOC and an estimated reading time. Served as the
+ * eagerly-imported `svelte-docsmith/content` virtual module.
+ *
+ * `lastUpdated` is read off the page rather than looked up here, so pass pages
+ * that have been through `withCommitDates` or the column comes out blank.
  */
-export declare function collectDocs(contentDir: string, routesDir: string, versions?: DocsVersions): DocsContentItem[];
+export declare function contentIndex(pages: SourcePage[], options: IndexOptions): DocsContentItem[];
 /**
- * Build the search records for every page under `contentDir`: title, section,
- * description, heading list, and plain-text body. Served as the lazy-loaded
- * `svelte-docsmith/search` virtual module so search can index bodies without
- * bloating the eagerly-imported nav index. The missing-directory case is
- * already reported by {@link collectDocs}, so this stays quiet.
+ * The search index: title, section, description, heading list, and plain-text
+ * body. Served as the lazy-loaded `svelte-docsmith/search` virtual module so
+ * search can index bodies without bloating the eagerly-imported content index.
  */
-export declare function collectSearchDocs(contentDir: string, routesDir: string, versions?: DocsVersions): SearchDoc[];
+export declare function searchIndex(pages: SourcePage[], options: IndexOptions): SearchDoc[];
 /**
- * Build the LLM records for every page: title, section, description, and the
- * full markdown content. Served as the `svelte-docsmith/llms` virtual module and
- * consumed server-side by `llms.txt` / `llms-full.txt` routes, so it never ships
- * to the client.
+ * The LLM index: title, section, description, and the full markdown content.
+ * Served as the `svelte-docsmith/llms` virtual module and consumed server-side
+ * by `llms.txt` / `llms-full.txt` routes, so it never ships to the client.
  */
-export declare function collectLlmsDocs(contentDir: string, routesDir: string, versions?: DocsVersions): LlmsDoc[];
+export declare function llmsIndex(pages: SourcePage[], options: IndexOptions): LlmsDoc[];

package/dist/buildtime/vite/collect.js

@@ -1,9 +1,51 @@
-import fs from 'node:fs';
+/**
+ * The three generated indexes, each a projection of the same page list. Nothing
+ * here reads the filesystem or spawns a process: a build hands these functions
+ * pages read by `./pages.js`, and a test hands them literals. Both go down the
+ * same path, so what the sidebar, search and llms.txt show is decided in one
+ * place and can be checked without a docs root on disk.
+ */
 import path from 'node:path';
-import { listPageFiles } from './pages.js';
-import { parseFrontmatter } from './frontmatter.js';
+import { firstSegmentUnder } from '../../utils/url.js';
+import { docsBaseFrom, urlFor } from '../paths.js';
+import { titleOf } from './pages.js';
 import { extractLlmsContent, extractSearchText, extractToc, readingMinutes } from './extract.js';
-import { lastCommitDate } from '../git.js';
+/**
+ * Resolve every titled page against the site's layout. Shared by all three
+ * indexes so they can never disagree about which pages exist or where they live.
+ */
+function indexedPages(pages, options) {
+    const resolved = [];
+    const docsBase = docsBaseFrom(options.routesDir, options.contentDir);
+    for (const page of pages) {
+        const title = titleOf(page);
+        if (title === undefined)
+            continue;
+        const url = urlFor(options.routesDir, path.dirname(page.file));
+        resolved.push({ ...page, url, title, version: versionOf(url) });
+    }
+    // Stable output keeps the generated modules diff-friendly across rebuilds.
+    return resolved.sort((a, b) => a.url.localeCompare(b.url));
+    /**
+     * A page belongs to an archived version when the first segment of its URL below
+     * the docs base is that archive's id; everything else is the current version,
+     * which lives unprefixed at the docs base.
+     *
+     * Decided in URL space, by the same rule `activeVersion` applies to the reader's
+     * pathname at runtime. Deciding it from the directory instead would be a second
+     * rule for the same question, in a second vocabulary, free to drift from the one
+     * the reader is actually served by. No versions ⇒ undefined, which keeps an
+     * unversioned site's index byte-for-byte what it was.
+     */
+    function versionOf(url) {
+        const { versions } = options;
+        if (!versions)
+            return undefined;
+        const segment = firstSegmentUnder(url, docsBase);
+        const archived = versions.archived?.find((v) => v.id === segment);
+        return archived ? archived.id : versions.current.id;
+    }
+}
 /**
  * Read a page's `section` frontmatter: a string is one level, an array is a
  * nested group path. Non-string array members are dropped; anything else is
@@ -33,116 +75,68 @@ function sectionKey(value) {
     return Array.isArray(section) ? section.join(' / ') : section;
 }
 /**
- * Walk every nav-worthy page under `contentDir` once: a page is nav-worthy when
- * its frontmatter has a string `title`. Yields the raw source, parsed
- * frontmatter, derived URL, and title so every index (nav, search, llms) can be
- * built from a single read of each file.
+ * A frontmatter field, when it holds the type the index expects. Frontmatter is
+ * whatever the author typed, so a field of the wrong type is dropped rather than
+ * carried into the index as one.
  */
-function* eachTitledPage(contentDir, routesDir, versions) {
-    for (const file of listPageFiles(contentDir)) {
-        const source = fs.readFileSync(file, 'utf-8');
-        const front = parseFrontmatter(source, file);
-        if (typeof front.title !== 'string')
-            continue;
-        const dir = path.dirname(file);
-        const url = '/' + path.relative(routesDir, dir).split(path.sep).join('/');
-        yield { source, front, url, title: front.title, file, version: versionOf(dir) };
-    }
-    /**
-     * A page belongs to an archived version when its first directory segment under
-     * the content dir is that archive's id; everything else is the current
-     * version, which lives unprefixed at the docs root. No versions ⇒ undefined,
-     * which keeps an unversioned site's index byte-for-byte what it was.
-     */
-    function versionOf(dir) {
-        if (!versions)
-            return undefined;
-        const firstSegment = path.relative(contentDir, dir).split(path.sep)[0];
-        const archived = versions.archived?.find((v) => v.id === firstSegment);
-        return archived ? archived.id : versions.current.id;
-    }
+function stringField(front, key) {
+    return typeof front[key] === 'string' ? front[key] : undefined;
+}
+/** As {@link stringField}, for the numeric fields. */
+function numberField(front, key) {
+    return typeof front[key] === 'number' ? front[key] : undefined;
 }
 /**
- * Scan `contentDir` for `+page.md`/`+page.svx` files and read the frontmatter
- * fields the sidebar needs (plus the heading list for a server-rendered TOC and
- * an estimated reading time), deriving each page's URL from its directory
- * relative to `routesDir`. Pure and synchronous so it can be unit-tested.
+ * The sidebar's index: the frontmatter fields navigation needs, plus the heading
+ * list for a server-rendered TOC and an estimated reading time. Served as the
+ * eagerly-imported `svelte-docsmith/content` virtual module.
+ *
+ * `lastUpdated` is read off the page rather than looked up here, so pass pages
+ * that have been through `withCommitDates` or the column comes out blank.
  */
-export function collectDocs(contentDir, routesDir, versions) {
-    if (!fs.existsSync(contentDir)) {
-        console.warn(`[svelte-docsmith] content directory not found: ${contentDir}\n` +
-            `  The sidebar will be empty. Create your doc pages there, or point docsmith() at the right place with \`content\`.`);
-        return [];
-    }
-    const items = [];
-    for (const { source, front, url, title, file, version } of eachTitledPage(contentDir, routesDir, versions)) {
-        items.push({
-            title,
-            path: url,
-            description: typeof front.description === 'string' ? front.description : undefined,
-            section: readSection(front.section),
-            order: typeof front.order === 'number' ? front.order : undefined,
-            sourcePath: path.relative(process.cwd(), file).split(path.sep).join('/'),
-            // Frontmatter wins over git so an archived page keeps the date it last
-            // really changed: archiving copies every page in one commit, which would
-            // otherwise stamp the whole archive with the day it was created.
-            lastUpdated: typeof front.lastUpdated === 'string' ? front.lastUpdated : lastCommitDate(file),
-            readingTime: readingMinutes(extractSearchText(source)),
-            toc: extractToc(source),
-            version
-        });
-    }
-    if (items.length === 0) {
-        console.warn(`[svelte-docsmith] no doc pages found under ${contentDir}\n` +
-            `  Add \`+page.md\` files with at least a \`title:\` in their frontmatter to populate the sidebar.`);
-    }
-    // Stable output keeps the generated module diff-friendly across rebuilds.
-    return items.sort((a, b) => a.path.localeCompare(b.path));
+export function contentIndex(pages, options) {
+    return indexedPages(pages, options).map((page) => ({
+        title: page.title,
+        path: page.url,
+        description: stringField(page.frontmatter, 'description'),
+        section: readSection(page.frontmatter.section),
+        order: numberField(page.frontmatter, 'order'),
+        sourcePath: path.relative(process.cwd(), page.file).split(path.sep).join('/'),
+        lastUpdated: page.lastUpdated,
+        readingTime: readingMinutes(extractSearchText(page.source)),
+        toc: extractToc(page.source),
+        version: page.version
+    }));
 }
 /**
- * Build the search records for every page under `contentDir`: title, section,
- * description, heading list, and plain-text body. Served as the lazy-loaded
- * `svelte-docsmith/search` virtual module so search can index bodies without
- * bloating the eagerly-imported nav index. The missing-directory case is
- * already reported by {@link collectDocs}, so this stays quiet.
+ * The search index: title, section, description, heading list, and plain-text
+ * body. Served as the lazy-loaded `svelte-docsmith/search` virtual module so
+ * search can index bodies without bloating the eagerly-imported content index.
  */
-export function collectSearchDocs(contentDir, routesDir, versions) {
-    if (!fs.existsSync(contentDir))
-        return [];
-    const docs = [];
-    for (const { source, front, url, title, version } of eachTitledPage(contentDir, routesDir, versions)) {
-        docs.push({
-            path: url,
-            title,
-            section: sectionLabel(front.section),
-            description: typeof front.description === 'string' ? front.description : undefined,
-            headings: extractToc(source).map((entry) => entry.title),
-            text: extractSearchText(source),
-            version
-        });
-    }
-    return docs.sort((a, b) => a.path.localeCompare(b.path));
+export function searchIndex(pages, options) {
+    return indexedPages(pages, options).map((page) => ({
+        path: page.url,
+        title: page.title,
+        section: sectionLabel(page.frontmatter.section),
+        description: stringField(page.frontmatter, 'description'),
+        headings: extractToc(page.source).map((entry) => entry.title),
+        text: extractSearchText(page.source),
+        version: page.version
+    }));
 }
 /**
- * Build the LLM records for every page: title, section, description, and the
- * full markdown content. Served as the `svelte-docsmith/llms` virtual module and
- * consumed server-side by `llms.txt` / `llms-full.txt` routes, so it never ships
- * to the client.
+ * The LLM index: title, section, description, and the full markdown content.
+ * Served as the `svelte-docsmith/llms` virtual module and consumed server-side
+ * by `llms.txt` / `llms-full.txt` routes, so it never ships to the client.
  */
-export function collectLlmsDocs(contentDir, routesDir, versions) {
-    if (!fs.existsSync(contentDir))
-        return [];
-    const docs = [];
-    for (const { source, front, url, title, version } of eachTitledPage(contentDir, routesDir, versions)) {
-        docs.push({
-            path: url,
-            title,
-            section: sectionKey(front.section),
-            order: typeof front.order === 'number' ? front.order : undefined,
-            description: typeof front.description === 'string' ? front.description : undefined,
-            content: extractLlmsContent(source, title),
-            version
-        });
-    }
-    return docs.sort((a, b) => a.path.localeCompare(b.path));
+export function llmsIndex(pages, options) {
+    return indexedPages(pages, options).map((page) => ({
+        path: page.url,
+        title: page.title,
+        section: sectionKey(page.frontmatter.section),
+        order: numberField(page.frontmatter, 'order'),
+        description: stringField(page.frontmatter, 'description'),
+        content: extractLlmsContent(page.source, page.title),
+        version: page.version
+    }));
 }

package/dist/buildtime/vite/extract.d.ts

@@ -3,8 +3,6 @@ export type TocEntry = {
     title: string;
     depth: 2 | 3;
 };
-/** Strip inline markdown so a heading's TOC label is plain text. */
-export declare function stripInlineMarkdown(text: string): string;
 /**
  * Reduce a markdown page to plain, searchable body text: prose and heading text
  * with frontmatter, `<script>`/`<style>` blocks, fenced code, HTML/Svelte tags,

package/dist/buildtime/vite/extract.js

@@ -5,7 +5,7 @@ function withoutSetupBlocks(body) {
     return body.replace(/<script[\s\S]*?<\/script>/gi, '').replace(/<style[\s\S]*?<\/style>/gi, '');
 }
 /** Strip inline markdown so a heading's TOC label is plain text. */
-export function stripInlineMarkdown(text) {
+function stripInlineMarkdown(text) {
     return text
         .replace(/!\[([^\]]*)\]\([^)]*\)/g, '$1')
         .replace(/`([^`]+)`/g, '$1')

package/dist/buildtime/vite/index.d.ts

@@ -1,7 +1,5 @@
 import type { Plugin } from 'vite';
 import { type DocsVersions } from '../../core/version.js';
-export { collectDocs, collectLlmsDocs, collectSearchDocs } from './collect.js';
-export { collectReleases } from './releases.js';
 export interface DocsmithViteOptions {
     /** Directory scanned for doc pages. Default: `'src/routes/docs'`. */
     content?: string;