@dogsbay/format-astro 0.2.0-beta.0

package/dist/llms-txt.js

@@ -0,0 +1,288 @@
+import { DEFAULT_BASE_PATH } from "./base-path.js";
+const EXTERNAL_HREF_RE = /^(?:https?:\/\/|mailto:|tel:|#)/i;
+const DEFAULT_DESCRIPTION_LIMIT = 160;
+const DEFAULT_TOP_LEVEL_LABEL = "Documentation";
+// ── Public builders ─────────────────────────────────────────────
+/**
+ * Build the top-level llms.txt index for a site.
+ *
+ * Layout:
+ *   - One `## {label}` section per top-level nav group with children.
+ *   - Top-level leaf nav items collected into a single
+ *     `## {topLevelLabel}` block at the end.
+ *   - External hrefs and pages not in nav 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 slugIndex = indexPagesBySlug(pages);
+    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);
+                if (entry)
+                    lines.push(entry);
+            }
+            collectEntries(item.children, slugIndex, hrefPrefix, siteUrl, descLimit, lines);
+            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);
+            if (entry)
+                out.push(entry);
+        }
+        out.push("");
+    }
+    for (const section of groupSections) {
+        out.push(...section);
+    }
+    return out.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd() + "\n";
+}
+/**
+ * Per-section llms.txt — same shape as the root index, scoped to one
+ * top-level nav group. Useful for `/docs/{section}/llms.txt` so agents
+ * 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";
+}
+/**
+ * Bundle every page reachable from `nav` into a single document, in
+ * nav order. 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);
+    const out = [];
+    out.push(`# ${siteConfig.siteName}`);
+    out.push("");
+    if (siteConfig.description) {
+        out.push(`> ${siteConfig.description}`);
+        out.push("");
+    }
+    let firstPage = true;
+    for (const slug of navOrder) {
+        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) {
+    for (const item of items) {
+        if (item.href && !EXTERNAL_HREF_RE.test(item.href)) {
+            const entry = renderEntry(item, slugIndex, hrefPrefix, siteUrl, descLimit);
+            if (entry)
+                out.push(entry);
+        }
+        if (item.children) {
+            collectEntries(item.children, slugIndex, hrefPrefix, siteUrl, descLimit, out);
+        }
+    }
+}
+function renderEntry(item, slugIndex, hrefPrefix, siteUrl, descLimit) {
+    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);
+    return description
+        ? `- [${label}](${url}): ${description}`
+        : `- [${label}](${url})`;
+}
+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);
+        }
+    };
+    walk(nav);
+    return slugs;
+}
+// ── Internals: page lookup + URL math ───────────────────────────
+function indexPagesBySlug(pages) {
+    const map = new Map();
+    for (const page of pages) {
+        map.set(page.slug || "index", page);
+    }
+    return map;
+}
+function hrefToSlug(href, hrefPrefix) {
+    if (EXTERNAL_HREF_RE.test(href))
+        return null;
+    const prefix = hrefPrefix.endsWith("/") ? hrefPrefix.slice(0, -1) : hrefPrefix;
+    if (href !== prefix && !href.startsWith(`${prefix}/`))
+        return null;
+    let slug = href.slice(prefix.length).replace(/^\//, "").replace(/\/$/, "");
+    return slug === "" ? "index" : slug;
+}
+function slugToHref(slug, hrefPrefix) {
+    const prefix = hrefPrefix.endsWith("/") ? hrefPrefix.slice(0, -1) : hrefPrefix;
+    if (slug === "" || slug === "index")
+        return `${prefix}.md`;
+    return `${prefix}/${slug}.md`;
+}
+function absoluteUrl(path, siteUrl) {
+    if (!siteUrl)
+        return path;
+    const base = siteUrl.replace(/\/$/, "");
+    return path.startsWith("/") ? `${base}${path}` : `${base}/${path}`;
+}
+// ── Internals: description + plain-text extraction ──────────────
+function getPageDescription(page, limit) {
+    const fmDesc = page.frontmatter?.["description"];
+    if (typeof fmDesc === "string" && fmDesc.trim()) {
+        return truncate(fmDesc.trim(), 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/llms-txt.js.map

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

package/dist/plugins.d.ts

@@ -0,0 +1,40 @@
+export interface PluginClientModulesGroup {
+    pluginId: string;
+    paths: string[];
+}
+export interface PluginStylesGroup {
+    pluginId: string;
+    paths: string[];
+}
+export interface PluginClientConfig {
+    pluginId: string;
+    value: unknown;
+}
+export interface PluginWrapperEntry {
+    pluginId: string;
+    /** Slot name (e.g. "MarkdownContent"). */
+    slot: string;
+    /** Absolute path to the wrapper .astro component. */
+    path: string;
+}
+export interface EmitPluginRuntimeOptions {
+    /** Absolute path of the generated Astro project. */
+    outputDir: string;
+    /** clientModules contributions, in plugin order. */
+    clientModules: PluginClientModulesGroup[];
+    /** styles contributions, in plugin order. */
+    styles: PluginStylesGroup[];
+    /** defineClientConfig contributions. */
+    clientConfigs: PluginClientConfig[];
+    /** componentWrappers contributions, in plugin order. */
+    componentWrappers?: PluginWrapperEntry[];
+}
+/**
+ * Emit the plugin-runtime artefacts. Safe to call when there are
+ * no plugins — every emitted file is shaped to compile and behave
+ * as a no-op when no plugin contributes that surface.
+ */
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AA0CA,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C,6CAA6C;IAC7C,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,wCAAwC;IACxC,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC1C;AAsBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAMzE;AA4RD,qDAAqD;AACrD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAM3D"}