@dogsbay/format-astro 0.2.0-beta.14 → 0.2.0-beta.140

package/dist/lead.d.ts

@@ -1,39 +1 @@
-/**
- * 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;
-//# sourceMappingURL=lead.d.ts.map
+export { detectLeadingNodes, deriveDescription, type LeadingNodeInfo } from "@dogsbay/serialize-core";

package/dist/lead.js

@@ -1,38 +1,3 @@
-/**
- * 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 function detectLeadingNodes(tree) {
-    if (!tree || tree.length === 0) {
-        return { hasH1: false, hasLede: false };
-    }
-    const first = tree[0];
-    const firstIsH1 = isH1(first);
-    if (firstIsH1) {
-        const second = tree[1];
-        return { hasH1: true, hasLede: isParagraph(second) };
-    }
-    return { hasH1: false, hasLede: isParagraph(first) };
-}
-function isH1(node) {
-    if (!node || node.type !== "heading")
-        return false;
-    // Some importers (dogsbay-md, mkdocs) attach depth as a top-level
-    // field; others (Starlight via mdx-jsx) use props.level. Both
-    // conventions are valid — check both.
-    const depth = node.depth;
-    if (typeof depth === "number")
-        return depth === 1;
-    const level = node.props?.level;
-    if (typeof level === "number")
-        return level === 1;
-    return false;
-}
-function isParagraph(node) {
-    if (!node)
-        return false;
-    return node.type === "paragraph";
-}
-//# sourceMappingURL=lead.js.map
+// Moved to @dogsbay/serialize-core (src/lead.ts), so @dogsbay/site-check can use
+// these without depending on format-astro, which brings @dogsbay/ui and astro.
+export { detectLeadingNodes, deriveDescription } from "@dogsbay/serialize-core";

package/dist/llms-txt.d.ts

@@ -14,7 +14,9 @@
  * dependency-free (only @dogsbay/types). Callers wire the actual
  * `treeToDogsbayMd` serializer when they want full-body bundles.
  */
-import type { ExportPage, NavItem, SiteConfig, TreeNode } from "@dogsbay/types";
+import type { ExportPage, NavItem, SiteConfig } from "@dogsbay/types";
+import { extractFirstParagraph } from "@dogsbay/serialize-core";
+export { extractFirstParagraph };
 export interface BuildLlmsTxtOptions {
     /**
      * Used to derive page slugs from nav hrefs. Defaults to
@@ -43,6 +45,41 @@ export interface BuildLlmsTxtOptions {
      * orphan emission entirely (matches pre-decoupling behavior).
      */
     otherPagesLabel?: string | false;
+    /**
+     * Other sites on this host to link at the end of the index — the
+     * `llms.txt` half of `site.aggregates`.
+     *
+     * Emitted as links, NOT inlined. Inlining would give an agent
+     * everything in one fetch but go stale on the aggregated site's next
+     * build, and this file is generated by a DIFFERENT build that has no
+     * way to know that happened.
+     */
+    aggregates?: AggregateEntry[];
+    /** Heading for the aggregates section. Default "Other sites". */
+    aggregatesLabel?: string;
+    /**
+     * Free-form guidance placed directly under the site description:
+     * what this site is good for and when an agent should reach for it.
+     *
+     * The llms.txt spec gives you a title, a blockquote and a link
+     * index — all of which describe what EXISTS. None of them say when
+     * the site is the right answer, which is the question an agent is
+     * actually holding. An audit put it as "generic marketing copy does
+     * not read as guidance", and that is fair: this is worth writing
+     * only if it names concrete jobs.
+     *
+     * Emitted verbatim as markdown so an author can use a list, and
+     * omitted entirely when unset rather than filled with a default —
+     * an invented "when to use" is worse than none.
+     */
+    whenToUse?: string;
+}
+/** One entry in the aggregates section. See `site.aggregates`. */
+export interface AggregateEntry {
+    name: string;
+    description?: string;
+    url?: string;
+    llmsTxt?: string;
 }
 export interface BuildLlmsFullTxtOptions extends BuildLlmsTxtOptions {
     /**
@@ -68,7 +105,7 @@ export interface BuildLlmsFullTxtOptions extends BuildLlmsTxtOptions {
  *   - Pages reachable in `pages` but absent from `nav` appended under
  *     a final `## {otherPagesLabel}` section. Set `otherPagesLabel`
  *     to `false` to suppress (e.g. when nav is the publish list).
- *   - External hrefs are skipped.
+ *   - External hrefs, and hrefs outside `hrefPrefix`, are skipped.
  */
 export declare function buildLlmsTxt(siteConfig: Pick<SiteConfig, "siteName" | "description" | "siteUrl">, nav: NavItem[], pages: ExportPage[], options?: BuildLlmsTxtOptions): string;
 /**
@@ -78,15 +115,8 @@ export declare function buildLlmsTxt(siteConfig: Pick<SiteConfig, "siteName" | "
  */
 export declare function buildSectionLlmsTxt(siteConfig: Pick<SiteConfig, "siteName" | "siteUrl">, group: NavItem, pages: ExportPage[], options?: BuildLlmsTxtOptions): string;
 /**
- * Bundle every page reachable from `nav` into a single document, in
- * nav order. Each page is delimited by a `# Title` header and `URL:`
+ * Bundle every page into a single document: nav order, then pages outside
+ * the nav by slug. Each page is delimited by a `# Title` header and `URL:`
  * line, then either the full body (default) or just a description.
  */
 export declare function buildLlmsFullTxt(siteConfig: Pick<SiteConfig, "siteName" | "description" | "siteUrl">, nav: NavItem[], pages: ExportPage[], options?: BuildLlmsFullTxtOptions): string;
-/**
- * Extract plain text of the first paragraph in a page tree. Cross-shape
- * tolerant: handles `node.inline` (dogsbay-md parser) and
- * `node.children[{type: "prose", inline}]` (Starlight importer).
- */
-export declare function extractFirstParagraph(tree: TreeNode[]): string;
-//# sourceMappingURL=llms-txt.d.ts.map

package/dist/llms-txt.js

@@ -1,9 +1,16 @@
+import { extractFirstParagraph } from "@dogsbay/serialize-core";
 import { DEFAULT_BASE_PATH } from "./base-path.js";
+import { DESCRIPTION_LIMIT, buildLlmsFullTxt as buildLlmsFullTxtFile, buildLlmsTxt as buildLlmsTxtFile, buildSectionLlmsTxt as buildSectionLlmsTxtFile, llmsFullOrder, truncate, } from "@dogsbay/site-files";
+// Moved to serialize-core so @dogsbay/site-check need not depend on format-astro
+export { extractFirstParagraph };
 const EXTERNAL_HREF_RE = /^(?:https?:\/\/|mailto:|tel:|#)/i;
-const DEFAULT_DESCRIPTION_LIMIT = 160;
-const DEFAULT_TOP_LEVEL_LABEL = "Documentation";
-const DEFAULT_OTHER_PAGES_LABEL = "Other pages";
+const DEFAULT_DESCRIPTION_LIMIT = DESCRIPTION_LIMIT;
 // ── Public builders ─────────────────────────────────────────────
+//
+// The files themselves are written by @dogsbay/site-files, shared with
+// dogsbay-ssg. This module maps ExportPage and NavItem onto its records:
+// keys are slugs ("index" for the home page), URLs are `<prefix>/<slug>.md`,
+// descriptions come from front matter or the first paragraph.
 /**
  * Build the top-level llms.txt index for a site.
  *
@@ -14,73 +21,18 @@ const DEFAULT_OTHER_PAGES_LABEL = "Other pages";
  *   - Pages reachable in `pages` but absent from `nav` appended under
  *     a final `## {otherPagesLabel}` section. Set `otherPagesLabel`
  *     to `false` to suppress (e.g. when nav is the publish list).
- *   - External hrefs are skipped.
+ *   - External hrefs, and hrefs outside `hrefPrefix`, are skipped.
  */
 export function buildLlmsTxt(siteConfig, nav, pages, options = {}) {
-    const hrefPrefix = options.hrefPrefix ?? DEFAULT_BASE_PATH;
-    const siteUrl = options.siteUrl ?? siteConfig.siteUrl;
-    const descLimit = options.descriptionLimit ?? DEFAULT_DESCRIPTION_LIMIT;
-    const topLevelLabel = options.topLevelLabel ?? DEFAULT_TOP_LEVEL_LABEL;
-    const otherPagesLabel = options.otherPagesLabel === undefined
-        ? DEFAULT_OTHER_PAGES_LABEL
-        : options.otherPagesLabel;
-    const slugIndex = indexPagesBySlug(pages);
-    const emittedSlugs = new Set();
-    const out = [];
-    out.push(`# ${siteConfig.siteName}`);
-    out.push("");
-    if (siteConfig.description) {
-        out.push(`> ${siteConfig.description}`);
-        out.push("");
-    }
-    const topLevelLeaves = [];
-    const groupSections = [];
-    for (const item of nav) {
-        if (item.children && item.children.length > 0) {
-            const lines = [];
-            lines.push(`## ${item.label}`);
-            lines.push("");
-            // Group's own landing page first, if it has one
-            if (item.href && !EXTERNAL_HREF_RE.test(item.href)) {
-                const entry = renderEntry(item, slugIndex, hrefPrefix, siteUrl, descLimit, emittedSlugs);
-                if (entry)
-                    lines.push(entry);
-            }
-            collectEntries(item.children, slugIndex, hrefPrefix, siteUrl, descLimit, lines, emittedSlugs);
-            lines.push("");
-            groupSections.push(lines);
-        }
-        else if (item.href && !EXTERNAL_HREF_RE.test(item.href)) {
-            topLevelLeaves.push(item);
-        }
-    }
-    if (topLevelLeaves.length > 0) {
-        out.push(`## ${topLevelLabel}`);
-        out.push("");
-        for (const leaf of topLevelLeaves) {
-            const entry = renderEntry(leaf, slugIndex, hrefPrefix, siteUrl, descLimit, emittedSlugs);
-            if (entry)
-                out.push(entry);
-        }
-        out.push("");
-    }
-    for (const section of groupSections) {
-        out.push(...section);
-    }
-    // Orphan pass — pages that exist in `pages` but were never hit by
-    // the nav walk. Emit so agents see the full surface even when nav
-    // curates a subset (the common case: a sidebar trims internal /
-    // sub-utility pages, but agents still want to find them).
-    if (otherPagesLabel !== false) {
-        const orphans = collectOrphanEntries(pages, emittedSlugs, hrefPrefix, siteUrl, descLimit);
-        if (orphans.length > 0) {
-            out.push(`## ${otherPagesLabel}`);
-            out.push("");
-            out.push(...orphans);
-            out.push("");
-        }
-    }
-    return out.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd() + "\n";
+    const m = mapInputs(siteConfig, nav, pages, options);
+    return buildLlmsTxtFile({ name: siteConfig.siteName, description: siteConfig.description, whenToUse: options.whenToUse, aggregates: options.aggregates }, m.nav, m.pages, {
+        url: m.url,
+        // A nav entry whose page is missing is still linked, by its label.
+        missing: "link",
+        topLevelLabel: options.topLevelLabel,
+        otherPagesLabel: options.otherPagesLabel,
+        aggregatesLabel: options.aggregatesLabel,
+    });
 }
 /**
  * Per-section llms.txt — same shape as the root index, scoped to one
@@ -88,149 +40,44 @@ export function buildLlmsTxt(siteConfig, nav, pages, options = {}) {
  * can pull only the section they care about.
  */
 export function buildSectionLlmsTxt(siteConfig, group, pages, options = {}) {
-    const hrefPrefix = options.hrefPrefix ?? DEFAULT_BASE_PATH;
-    const siteUrl = options.siteUrl ?? siteConfig.siteUrl;
-    const descLimit = options.descriptionLimit ?? DEFAULT_DESCRIPTION_LIMIT;
-    const slugIndex = indexPagesBySlug(pages);
-    const out = [];
-    out.push(`# ${siteConfig.siteName} — ${group.label}`);
-    out.push("");
-    out.push(`## ${group.label}`);
-    out.push("");
-    if (group.href && !EXTERNAL_HREF_RE.test(group.href)) {
-        const entry = renderEntry(group, slugIndex, hrefPrefix, siteUrl, descLimit);
-        if (entry)
-            out.push(entry);
-    }
-    if (group.children) {
-        collectEntries(group.children, slugIndex, hrefPrefix, siteUrl, descLimit, out);
-    }
-    return out.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd() + "\n";
+    const m = mapInputs(siteConfig, [group], pages, options);
+    return buildSectionLlmsTxtFile({ name: siteConfig.siteName }, m.nav[0], m.pages, { url: m.url, missing: "link" });
 }
 /**
- * Bundle every page reachable from `nav` into a single document, in
- * nav order. Each page is delimited by a `# Title` header and `URL:`
+ * Bundle every page into a single document: nav order, then pages outside
+ * the nav by slug. Each page is delimited by a `# Title` header and `URL:`
  * line, then either the full body (default) or just a description.
  */
 export function buildLlmsFullTxt(siteConfig, nav, pages, options = {}) {
-    const hrefPrefix = options.hrefPrefix ?? DEFAULT_BASE_PATH;
-    const siteUrl = options.siteUrl ?? siteConfig.siteUrl;
     const summary = options.summary ?? (options.serializePage ? "body" : "description");
     if (summary === "body" && !options.serializePage) {
         throw new Error(`buildLlmsFullTxt: summary "body" requires options.serializePage`);
     }
-    const slugIndex = indexPagesBySlug(pages);
-    const navOrder = flattenNavToSlugs(nav, hrefPrefix);
-    // Append page slugs not reachable from nav (sorted for stable
-    // output). Same rationale as buildLlmsTxt's orphan pass: the bundle
-    // is for agents, and curated nav usually trims internal pages that
-    // agents still want to read.
-    const seen = new Set(navOrder);
-    const orphanSlugs = pages
-        .map((p) => p.slug || "index")
-        .filter((s) => !seen.has(s))
-        .sort((a, b) => a.localeCompare(b));
-    const allSlugs = [...navOrder, ...orphanSlugs];
-    const out = [];
-    out.push(`# ${siteConfig.siteName}`);
-    out.push("");
-    if (siteConfig.description) {
-        out.push(`> ${siteConfig.description}`);
-        out.push("");
-    }
-    let firstPage = true;
-    for (const slug of allSlugs) {
-        const page = slugIndex.get(slug);
-        if (!page)
-            continue;
-        if (!firstPage) {
-            out.push("---");
-            out.push("");
-        }
-        firstPage = false;
-        out.push(`# ${page.title}`);
-        out.push("");
-        out.push(`URL: ${absoluteUrl(slugToHref(slug, hrefPrefix), siteUrl)}`);
-        out.push("");
-        if (summary === "body") {
-            out.push(options.serializePage(page).trimEnd());
-        }
-        else {
-            const desc = getPageDescription(page, options.descriptionLimit ?? DEFAULT_DESCRIPTION_LIMIT);
-            out.push(desc || page.title);
-        }
-        out.push("");
-    }
-    return out.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd() + "\n";
-}
-// ── Internals: nav walking + entry rendering ────────────────────
-function collectEntries(items, slugIndex, hrefPrefix, siteUrl, descLimit, out, emitted) {
-    for (const item of items) {
-        if (item.href && !EXTERNAL_HREF_RE.test(item.href)) {
-            const entry = renderEntry(item, slugIndex, hrefPrefix, siteUrl, descLimit, emitted);
-            if (entry)
-                out.push(entry);
-        }
-        if (item.children) {
-            collectEntries(item.children, slugIndex, hrefPrefix, siteUrl, descLimit, out, emitted);
-        }
-    }
-}
-function renderEntry(item, slugIndex, hrefPrefix, siteUrl, descLimit, emitted) {
-    if (!item.href)
-        return null;
-    const slug = hrefToSlug(item.href, hrefPrefix);
-    if (slug === null)
-        return null;
-    const page = slugIndex.get(slug);
-    const label = item.label || page?.title || slug;
-    const description = page ? getPageDescription(page, descLimit) : "";
-    const url = absoluteUrl(`${item.href.replace(/\/$/, "")}.md`, siteUrl);
-    if (emitted && page)
-        emitted.add(slug);
-    return description
-        ? `- [${label}](${url}): ${description}`
-        : `- [${label}](${url})`;
-}
-/**
- * Render entries for pages that exist but weren't reached during the
- * nav walk. Sorted alphabetically by slug for stable output (nav
- * order isn't meaningful for these — they're not in nav).
- */
-function collectOrphanEntries(pages, emitted, hrefPrefix, siteUrl, descLimit) {
-    const orphans = [];
-    const sorted = pages
-        .filter((p) => !emitted.has(p.slug || "index"))
-        .sort((a, b) => (a.slug || "index").localeCompare(b.slug || "index"));
-    for (const page of sorted) {
-        const slug = page.slug || "index";
-        const label = page.title || slug;
-        const description = getPageDescription(page, descLimit);
-        const url = absoluteUrl(slugToHref(slug, hrefPrefix), siteUrl);
-        orphans.push(description
-            ? `- [${label}](${url}): ${description}`
-            : `- [${label}](${url})`);
-    }
-    return orphans;
-}
-function flattenNavToSlugs(nav, hrefPrefix) {
-    const slugs = [];
-    const seen = new Set();
-    const walk = (items) => {
-        for (const item of items) {
-            if (item.href && !EXTERNAL_HREF_RE.test(item.href)) {
-                const slug = hrefToSlug(item.href, hrefPrefix);
-                if (slug !== null && !seen.has(slug)) {
-                    seen.add(slug);
-                    slugs.push(slug);
-                }
-            }
-            if (item.children)
-                walk(item.children);
-        }
+    const m = mapInputs(siteConfig, nav, pages, options);
+    const load = (key) => {
+        const page = m.byKey.get(key);
+        if (summary === "body")
+            return options.serializePage(page);
+        return m.pages.get(key).description || page.title;
     };
-    walk(nav);
-    return slugs;
+    return buildLlmsFullTxtFile({ name: siteConfig.siteName, description: siteConfig.description, whenToUse: options.whenToUse }, llmsFullOrder(m.nav, m.pages), m.pages, m.url, load);
+}
+/** ExportPage and NavItem as @dogsbay/site-files records. */
+function mapInputs(siteConfig, nav, pages, options) {
+    const hrefPrefix = options.hrefPrefix ?? DEFAULT_BASE_PATH;
+    const siteUrl = options.siteUrl ?? siteConfig.siteUrl;
+    const limit = options.descriptionLimit ?? DEFAULT_DESCRIPTION_LIMIT;
+    const byKey = indexPagesBySlug(pages);
+    const records = new Map();
+    for (const [key, page] of byKey) {
+        const description = getPageDescription(page, limit);
+        records.set(key, { title: page.title, ...(description ? { description } : {}) });
+    }
+    const toNav = (items) => items.map((item) => {
+        const key = item.href ? hrefToSlug(item.href, hrefPrefix) : null;
+        return { label: item.label, ...(key !== null ? { key } : {}), children: toNav(item.children ?? []) };
+    });
+    return { pages: records, byKey, nav: toNav(nav), url: (key) => absoluteUrl(slugToHref(key, hrefPrefix), siteUrl) };
 }
 // ── Internals: page lookup + URL math ───────────────────────────
 function indexPagesBySlug(pages) {
@@ -252,14 +99,45 @@ function hrefToSlug(href, hrefPrefix) {
 function slugToHref(slug, hrefPrefix) {
     const prefix = hrefPrefix.endsWith("/") ? hrefPrefix.slice(0, -1) : hrefPrefix;
     if (slug === "" || slug === "index")
-        return `${prefix}.md`;
+        return indexMirrorHref(prefix);
     return `${prefix}/${slug}.md`;
 }
+/**
+ * The site index's markdown mirror.
+ *
+ * At a mount this is `<prefix>.md` — verified against the deployed
+ * blog, where `/blog.md` serves and `/blog/index.md` 404s.
+ *
+ * At the HOST ROOT the prefix is empty, so that form degenerates to
+ * `.md`: a relative path that resolves against whatever directory the
+ * reader happens to be in, and absolutises to `https://host/.md`. The
+ * route Astro actually emits there is `dist/index.md`.
+ *
+ * The bug was invisible on every site we had, because a mounted site
+ * takes the other branch and the one host-root site had no index entry
+ * in its llms.txt.
+ */
+function indexMirrorHref(prefix) {
+    return prefix ? `${prefix}.md` : "/index.md";
+}
 function absoluteUrl(path, siteUrl) {
     if (!siteUrl)
         return path;
-    const base = siteUrl.replace(/\/$/, "");
-    return path.startsWith("/") ? `${base}${path}` : `${base}/${path}`;
+    // Strip the path component from siteUrl. With the two-prefix
+    // model (urlBase from site.url's path drives Astro's `base`,
+    // basePath stays as filesystem prefix), `path` already carries
+    // the combined prefix. Concatenating siteUrl-with-path would
+    // double-count. Use only the origin.
+    // See plans/astro-base-from-site-url.md.
+    let origin;
+    try {
+        const u = new URL(siteUrl);
+        origin = `${u.protocol}//${u.host}`;
+    }
+    catch {
+        origin = siteUrl.replace(/\/$/, "");
+    }
+    return path.startsWith("/") ? `${origin}${path}` : `${origin}/${path}`;
 }
 // ── Internals: description + plain-text extraction ──────────────
 function getPageDescription(page, limit) {
@@ -270,73 +148,3 @@ function getPageDescription(page, limit) {
     const firstPara = extractFirstParagraph(page.tree);
     return firstPara ? truncate(firstPara, limit) : "";
 }
-/**
- * Extract plain text of the first paragraph in a page tree. Cross-shape
- * tolerant: handles `node.inline` (dogsbay-md parser) and
- * `node.children[{type: "prose", inline}]` (Starlight importer).
- */
-export function extractFirstParagraph(tree) {
-    for (const node of tree) {
-        if (node.type !== "paragraph")
-            continue;
-        const inline = node.inline ?? findProseInline(node.children);
-        if (inline)
-            return inlineToPlainText(inline).trim();
-    }
-    return "";
-}
-function findProseInline(children) {
-    if (!children)
-        return undefined;
-    for (const child of children) {
-        if (child.type === "prose" && child.inline)
-            return child.inline;
-    }
-    return undefined;
-}
-function inlineToPlainText(inline) {
-    let out = "";
-    for (const node of inline) {
-        switch (node.type) {
-            case "text":
-                out += node.text;
-                break;
-            case "code":
-                out += node.text;
-                break;
-            case "link":
-            case "highlight":
-                out += inlineToPlainText(node.children);
-                break;
-            case "kbd":
-                out += node.keys.join("+");
-                break;
-            case "math":
-                out += node.latex;
-                break;
-            case "image":
-                if (node.alt)
-                    out += node.alt;
-                break;
-            case "break":
-                out += " ";
-                break;
-            case "html-inline":
-            case "footnote-ref":
-            case "icon":
-                // No useful plain text; skip.
-                break;
-        }
-    }
-    return out;
-}
-function truncate(text, limit) {
-    const collapsed = text.replace(/\s+/g, " ").trim();
-    if (collapsed.length <= limit)
-        return collapsed;
-    const slice = collapsed.slice(0, limit);
-    const lastSpace = slice.lastIndexOf(" ");
-    const cut = lastSpace > limit * 0.5 ? slice.slice(0, lastSpace) : slice;
-    return `${cut.trimEnd()}…`;
-}
-//# sourceMappingURL=llms-txt.js.map

package/dist/plugins.d.ts

@@ -37,4 +37,3 @@ export interface EmitPluginRuntimeOptions {
 export declare function emitPluginRuntime(options: EmitPluginRuntimeOptions): void;
 /** Test-only: clear emitted plugin runtime files. */
 export declare function _clearPluginRuntime(outputDir: string): void;
-//# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.js

@@ -37,7 +37,9 @@
  *
  * See plans/plugin-api.md.
  */
-import { writeFileSync, readFileSync, existsSync, mkdirSync, copyFileSync, rmSync } from "node:fs";
+import { readFileSync, existsSync, mkdirSync, rmSync } from "node:fs";
+// Unchanged files are not rewritten, so `site dev` reloads only what changed
+import { writeFileSync, copyFileSync } from "./write-if-changed.js";
 import { dirname, join, basename, extname } from "node:path";
 /**
  * Slots the runtime emits stack files for. Each entry is always
@@ -46,7 +48,7 @@ import { dirname, join, basename, extname } from "node:path";
  * requires both an entry here and a usage site in format-astro's
  * page emitter.
  */
-const KNOWN_SLOTS = ["MarkdownContent"];
+const KNOWN_SLOTS = ["MarkdownContent", "RightRail"];
 const PLUGIN_RUNTIME_REL = "src/lib/plugin-runtime.ts";
 const PLUGIN_CONFIG_DIR_REL = "src/lib/plugin-config";
 const PLUGIN_STYLES_DIR_REL = "src/styles/plugins";
@@ -336,4 +338,3 @@ export function _clearPluginRuntime(outputDir) {
     rmSync(join(outputDir, PLUGIN_CONFIG_DIR_REL), { recursive: true, force: true });
     rmSync(join(outputDir, PLUGIN_STYLES_DIR_REL), { recursive: true, force: true });
 }
-//# sourceMappingURL=plugins.js.map