@dogsbay/format-astro 0.2.0-beta.0

package/dist/base-path.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Single source of truth for the `basePath` URL prefix.
+ *
+ * `basePath` is the path-under-host where docs are served. By default
+ * it's `/docs` (every existing dogsbay site uses this); set
+ * `site.basePath: ""` in `dogsbay.config.yml` to serve at the host
+ * root, or `"/handbook"` (etc.) for any other prefix.
+ *
+ * Every emitter that builds URLs, file paths, or rewrites links
+ * reads from `AstroProjectOptions.basePath` and runs it through
+ * `normalizeBasePath` so the prefix is consistent across:
+ *
+ *   - generated page URLs (`/<basePath>/<slug>/`)
+ *   - emitted file paths (`src/pages/<basePath segments>/<slug>.astro`)
+ *   - nav.json hrefs
+ *   - llms.txt URL prefixes
+ *   - taxonomy term URLs
+ *   - draft-pruning slug → href matching
+ *
+ * Changing the default lives here. Don't hardcode `/docs` anywhere
+ * else in `format-astro/src/`.
+ *
+ * See plans/configurable-base-path.md.
+ */
+/** Default `basePath` when no override is supplied. */
+export declare const DEFAULT_BASE_PATH = "/docs";
+/**
+ * Normalize a user-supplied `basePath` to canonical form.
+ *
+ * Output shape:
+ * - `""` (empty string) → site is served at host root.
+ * - `"/<segments>"` (single leading slash, no trailing slash) for any
+ *   non-empty prefix.
+ *
+ * Examples:
+ * - `undefined` → `"/docs"` (default)
+ * - `""` → `""`
+ * - `"/"` → `""`
+ * - `"docs"` → `"/docs"`
+ * - `"/docs"` → `"/docs"`
+ * - `"/docs/"` → `"/docs"`
+ * - `"docs/"` → `"/docs"`
+ * - `"/handbook/team"` → `"/handbook/team"`
+ *
+ * Schema validation in `@dogsbay/cli`'s `loadConfig` rejects values
+ * that contain `?`, `#`, whitespace, or repeated slashes, so this
+ * function only handles the trim/prepend cases.
+ */
+export declare function normalizeBasePath(input: string | undefined): string;
+/**
+ * Split a normalized basePath into its path segments. `""` produces
+ * an empty array; `"/docs"` produces `["docs"]`; `"/handbook/team"`
+ * produces `["handbook", "team"]`.
+ *
+ * Useful for `path.join(outputDir, "src", "pages", ...segments)`.
+ */
+export declare function basePathSegments(basePath: string): string[];
+/**
+ * Join a normalized basePath with a section name (when set), then a
+ * slug. Produces a URL path with leading slash and trailing slash for
+ * non-leaf paths. Empty basePath collapses cleanly.
+ *
+ * - `joinBaseUrl("/docs", "workers", "auth")` → `"/docs/workers/auth/"`
+ * - `joinBaseUrl("/docs", undefined, "auth")` → `"/docs/auth/"`
+ * - `joinBaseUrl("", "workers", "auth")` → `"/workers/auth/"`
+ * - `joinBaseUrl("", undefined, "auth")` → `"/auth/"`
+ * - `joinBaseUrl("/docs", undefined, "")` → `"/docs/"`
+ * - `joinBaseUrl("", undefined, "")` → `"/"`
+ */
+export declare function joinBaseUrl(basePath: string, section: string | undefined, slug: string): string;
+/**
+ * Build the `currentPath` value embedded in generated `.astro` pages
+ * for `getPagination` lookups. No trailing slash so it matches the
+ * shape `getPagination` compares against in `nav.json` hrefs.
+ *
+ * - default basePath, no section, slug "auth" → `"/docs/auth"`
+ * - default basePath, section "workers", slug "auth" → `"/docs/workers/auth"`
+ * - default basePath, empty slug → `"/docs"`
+ * - empty basePath, slug "auth" → `"/auth"`
+ * - empty basePath, empty slug → `"/"`
+ */
+export declare function buildCurrentPath(basePath: string, section: string | undefined, slug: string): string;
+//# sourceMappingURL=base-path.d.ts.map

package/dist/base-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-path.d.ts","sourceRoot":"","sources":["../src/base-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKnE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,GACX,MAAM,CAMR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,GACX,MAAM,CAMR"}

package/dist/base-path.js

@@ -0,0 +1,110 @@
+/**
+ * Single source of truth for the `basePath` URL prefix.
+ *
+ * `basePath` is the path-under-host where docs are served. By default
+ * it's `/docs` (every existing dogsbay site uses this); set
+ * `site.basePath: ""` in `dogsbay.config.yml` to serve at the host
+ * root, or `"/handbook"` (etc.) for any other prefix.
+ *
+ * Every emitter that builds URLs, file paths, or rewrites links
+ * reads from `AstroProjectOptions.basePath` and runs it through
+ * `normalizeBasePath` so the prefix is consistent across:
+ *
+ *   - generated page URLs (`/<basePath>/<slug>/`)
+ *   - emitted file paths (`src/pages/<basePath segments>/<slug>.astro`)
+ *   - nav.json hrefs
+ *   - llms.txt URL prefixes
+ *   - taxonomy term URLs
+ *   - draft-pruning slug → href matching
+ *
+ * Changing the default lives here. Don't hardcode `/docs` anywhere
+ * else in `format-astro/src/`.
+ *
+ * See plans/configurable-base-path.md.
+ */
+/** Default `basePath` when no override is supplied. */
+export const DEFAULT_BASE_PATH = "/docs";
+/**
+ * Normalize a user-supplied `basePath` to canonical form.
+ *
+ * Output shape:
+ * - `""` (empty string) → site is served at host root.
+ * - `"/<segments>"` (single leading slash, no trailing slash) for any
+ *   non-empty prefix.
+ *
+ * Examples:
+ * - `undefined` → `"/docs"` (default)
+ * - `""` → `""`
+ * - `"/"` → `""`
+ * - `"docs"` → `"/docs"`
+ * - `"/docs"` → `"/docs"`
+ * - `"/docs/"` → `"/docs"`
+ * - `"docs/"` → `"/docs"`
+ * - `"/handbook/team"` → `"/handbook/team"`
+ *
+ * Schema validation in `@dogsbay/cli`'s `loadConfig` rejects values
+ * that contain `?`, `#`, whitespace, or repeated slashes, so this
+ * function only handles the trim/prepend cases.
+ */
+export function normalizeBasePath(input) {
+    if (input === undefined)
+        return DEFAULT_BASE_PATH;
+    const trimmed = input.replace(/^\/+/, "").replace(/\/+$/, "");
+    if (trimmed.length === 0)
+        return "";
+    return `/${trimmed}`;
+}
+/**
+ * Split a normalized basePath into its path segments. `""` produces
+ * an empty array; `"/docs"` produces `["docs"]`; `"/handbook/team"`
+ * produces `["handbook", "team"]`.
+ *
+ * Useful for `path.join(outputDir, "src", "pages", ...segments)`.
+ */
+export function basePathSegments(basePath) {
+    return basePath.split("/").filter((s) => s.length > 0);
+}
+/**
+ * Join a normalized basePath with a section name (when set), then a
+ * slug. Produces a URL path with leading slash and trailing slash for
+ * non-leaf paths. Empty basePath collapses cleanly.
+ *
+ * - `joinBaseUrl("/docs", "workers", "auth")` → `"/docs/workers/auth/"`
+ * - `joinBaseUrl("/docs", undefined, "auth")` → `"/docs/auth/"`
+ * - `joinBaseUrl("", "workers", "auth")` → `"/workers/auth/"`
+ * - `joinBaseUrl("", undefined, "auth")` → `"/auth/"`
+ * - `joinBaseUrl("/docs", undefined, "")` → `"/docs/"`
+ * - `joinBaseUrl("", undefined, "")` → `"/"`
+ */
+export function joinBaseUrl(basePath, section, slug) {
+    const parts = [];
+    for (const seg of basePathSegments(basePath))
+        parts.push(seg);
+    if (section)
+        parts.push(section);
+    if (slug && slug !== "index")
+        parts.push(slug);
+    return parts.length === 0 ? "/" : `/${parts.join("/")}/`;
+}
+/**
+ * Build the `currentPath` value embedded in generated `.astro` pages
+ * for `getPagination` lookups. No trailing slash so it matches the
+ * shape `getPagination` compares against in `nav.json` hrefs.
+ *
+ * - default basePath, no section, slug "auth" → `"/docs/auth"`
+ * - default basePath, section "workers", slug "auth" → `"/docs/workers/auth"`
+ * - default basePath, empty slug → `"/docs"`
+ * - empty basePath, slug "auth" → `"/auth"`
+ * - empty basePath, empty slug → `"/"`
+ */
+export function buildCurrentPath(basePath, section, slug) {
+    const parts = [];
+    for (const seg of basePathSegments(basePath))
+        parts.push(seg);
+    if (section)
+        parts.push(section);
+    if (slug)
+        parts.push(slug);
+    return parts.length === 0 ? "/" : `/${parts.join("/")}`;
+}
+//# sourceMappingURL=base-path.js.map

package/dist/base-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-path.js","sourceRoot":"","sources":["../src/base-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,iBAAiB,CAAC;IAClD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,OAAO,IAAI,OAAO,EAAE,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,OAA2B,EAC3B,IAAY;IAEZ,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,gBAAgB,CAAC,QAAQ,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9D,IAAI,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,IAAI,IAAI,IAAI,KAAK,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,OAA2B,EAC3B,IAAY;IAEZ,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,gBAAgB,CAAC,QAAQ,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9D,IAAI,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC1D,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,22 @@
+import type { FormatPlugin } from "@dogsbay/types";
+/**
+ * `dogsbay convert --to astro` plugin.
+ *
+ * Pure content-format primitive. Emits the .astro pages, .md mirror
+ * endpoints (when enabled), `nav.json`, and the index redirect — but
+ * NOT site scaffold, site.json, robots.txt, llms.txt, middleware,
+ * or any other SSG-tier file. For a complete project, run
+ * `dogsbay site init && dogsbay site build`.
+ *
+ * Format-specific knobs accepted here are content-tier only:
+ *   --local                   monorepo dev-mode dependency style (used
+ *                             only when these pages will be consumed
+ *                             by site init / build)
+ *   --dynamic / --keep-dynamic  experimental [...slug].astro routing
+ *
+ * Site-level config (siteUrl, description, deploy, AI permissions,
+ * llms.txt, md-mirror, etc.) lives in dogsbay.config.yml and is
+ * applied by `dogsbay site build`.
+ */
+export declare const plugin: FormatPlugin;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,gBAAgB,CAAC;AAGxE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,MAAM,EAAE,YAuCpB,CAAC"}

package/dist/cli.js

@@ -0,0 +1,53 @@
+import { emitAstroPages } from "./project.js";
+/**
+ * `dogsbay convert --to astro` plugin.
+ *
+ * Pure content-format primitive. Emits the .astro pages, .md mirror
+ * endpoints (when enabled), `nav.json`, and the index redirect — but
+ * NOT site scaffold, site.json, robots.txt, llms.txt, middleware,
+ * or any other SSG-tier file. For a complete project, run
+ * `dogsbay site init && dogsbay site build`.
+ *
+ * Format-specific knobs accepted here are content-tier only:
+ *   --local                   monorepo dev-mode dependency style (used
+ *                             only when these pages will be consumed
+ *                             by site init / build)
+ *   --dynamic / --keep-dynamic  experimental [...slug].astro routing
+ *
+ * Site-level config (siteUrl, description, deploy, AI permissions,
+ * llms.txt, md-mirror, etc.) lives in dogsbay.config.yml and is
+ * applied by `dogsbay site build`.
+ */
+export const plugin = {
+    name: "astro",
+    canImport: false,
+    canExport: true,
+    detectSource: () => false,
+    exportOptions: [
+        { flags: "--local", description: "Use file: references to local monorepo packages (for development)" },
+        { flags: "--dynamic", description: "Use dynamic catch-all route instead of static .astro pages" },
+        { flags: "--keep-dynamic", description: "Keep the dynamic [..slug] route alongside static pages (for comparison)" },
+    ],
+    async export(pages, nav, output, opts) {
+        const codeTitles = opts.codeTitles;
+        const codeBlockTitle = codeTitles === "auto" ? "auto"
+            : codeTitles === "never" ? false
+                : true;
+        await emitAstroPages(pages, nav, output, {
+            siteName: opts.siteName,
+            theme: opts.theme,
+            local: opts.local,
+            sourceDir: opts.sourceDir,
+            imageOptimization: opts.optimizeImages,
+            codeBlockTitle,
+            section: opts.section,
+            // mdMirror defaults to true inside emitAstroPages — content tier
+            // emits the .md endpoints alongside .astro pages so the agent-
+            // readiness story works without site build (when llms.txt / Accept
+            // negotiation aren't needed). Site build re-emits these as part
+            // of the agent-tier; idempotent either way.
+            mdMirror: opts.mdMirror,
+        });
+    },
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAiB;IAClC,IAAI,EAAE,OAAO;IACb,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,IAAI;IACf,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK;IACzB,aAAa,EAAE;QACb,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,mEAAmE,EAAE;QACtG,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,4DAA4D,EAAE;QACjG,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,yEAAyE,EAAE;KACpH;IAED,KAAK,CAAC,MAAM,CACV,KAAmB,EACnB,GAAc,EACd,MAAc,EACd,IAA6B;QAE7B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAgC,CAAC;QACzD,MAAM,cAAc,GAClB,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM;YAC9B,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK;gBAChC,CAAC,CAAC,IAAI,CAAC;QAET,MAAM,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE;YACvC,QAAQ,EAAE,IAAI,CAAC,QAA8B;YAC7C,KAAK,EAAE,IAAI,CAAC,KAA2B;YACvC,KAAK,EAAE,IAAI,CAAC,KAA4B;YACxC,SAAS,EAAE,IAAI,CAAC,SAA+B;YAC/C,iBAAiB,EAAE,IAAI,CAAC,cAAqC;YAC7D,cAAc;YACd,OAAO,EAAE,IAAI,CAAC,OAA6B;YAC3C,iEAAiE;YACjE,+DAA+D;YAC/D,mEAAmE;YACnE,gEAAgE;YAChE,4CAA4C;YAC5C,QAAQ,EAAE,IAAI,CAAC,QAA+B;SAC/C,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { treeToAstro, escapeExpr, escapeAttr, escapeTemplate } from "./serialize.js";
+export { detectLeadingNodes } from "./lead.js";
+export type { LeadingNodeInfo } from "./lead.js";
+export type { AstroGenResult, AstroGenOptions, AstroRenderMode } from "./serialize.js";
+export { DEFAULT_BASE_PATH, normalizeBasePath, basePathSegments, joinBaseUrl, buildCurrentPath, } from "./base-path.js";
+export { buildLlmsTxt, buildSectionLlmsTxt, buildLlmsFullTxt, extractFirstParagraph, } from "./llms-txt.js";
+export type { BuildLlmsTxtOptions, BuildLlmsFullTxtOptions, } from "./llms-txt.js";
+export { exportAstroProject, emitSiteScaffold, emitSiteConfig, emitAstroPages, emitConfigDerivedFiles, emitAgentReadinessFiles, emitSwitcherMap, emitMissingTranslationStubs, } from "./project.js";
+export type { AstroProjectOptions, SwitcherMap } from "./project.js";
+export { emitPluginRuntime } from "./plugins.js";
+export type { EmitPluginRuntimeOptions, PluginClientModulesGroup, PluginStylesGroup, PluginClientConfig, } from "./plugins.js";
+export { buildTaxonomyData, emitTaxonomyForName, emitTaxonomyRoutes, getPageTerms, } from "./taxonomy.js";
+export type { TaxonomyEmitConfig, TaxonomyTerm, TaxonomyPageRef, TaxonomyData, } from "./taxonomy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAKvF,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAavB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EACV,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAKtB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+// Astro serializer (TreeNode[] → Astro component markup)
+export { treeToAstro, escapeExpr, escapeAttr, escapeTemplate } from "./serialize.js";
+// Auto-lede detection — figures out whether a page tree already
+// has a leading H1 / paragraph so format-astro can decide whether
+// to inject frontmatter title + description at the top of <main>.
+// See plans/auto-lede.md.
+export { detectLeadingNodes } from "./lead.js";
+// Base-path helpers — single source of truth for the `basePath` URL
+// prefix shared across project / nav / llms-txt / taxonomy emitters.
+// See plans/configurable-base-path.md.
+export { DEFAULT_BASE_PATH, normalizeBasePath, basePathSegments, joinBaseUrl, buildCurrentPath, } from "./base-path.js";
+// llms.txt + llms-full.txt builders (LLM discovery files)
+export { buildLlmsTxt, buildSectionLlmsTxt, buildLlmsFullTxt, extractFirstParagraph, } from "./llms-txt.js";
+// Project export — orchestrator + per-tier emitters
+//
+// `exportAstroProject` is the high-level entry: generates a complete
+// Astro project. `dogsbay convert` and the legacy `import-mkdocs`
+// command call it.
+//
+// The four `emit*` functions are the per-tier emitters that the
+// orchestrator composes. `dogsbay site init` calls `emitSiteScaffold`
+// alone; `dogsbay site build` calls `emitAstroPages` +
+// `emitConfigDerivedFiles` + `emitAgentReadinessFiles`. Pure
+// `dogsbay convert --to astro` (Step 7) calls only `emitAstroPages`.
+export { exportAstroProject, emitSiteScaffold, emitSiteConfig, emitAstroPages, emitConfigDerivedFiles, emitAgentReadinessFiles, emitSwitcherMap, emitMissingTranslationStubs, } from "./project.js";
+// Plugin runtime codegen — emits the entry, virtual config modules,
+// stylesheets, and Vite alias file each plugin needs to participate
+// in the Astro / Vite build. See plans/plugin-api.md.
+export { emitPluginRuntime } from "./plugins.js";
+// Taxonomy emission — Step 4 of plans/metadata-and-taxonomies.md.
+// Per declared taxonomy in `dogsbay.config.yml`'s `taxonomies:` block,
+// emits a JSON data file + index/term .astro route files.
+export { buildTaxonomyData, emitTaxonomyForName, emitTaxonomyRoutes, getPageTerms, } from "./taxonomy.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErF,gEAAgE;AAChE,kEAAkE;AAClE,kEAAkE;AAClE,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAI/C,oEAAoE;AACpE,qEAAqE;AACrE,uCAAuC;AACvC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,0DAA0D;AAC1D,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAMvB,oDAAoD;AACpD,EAAE;AACF,qEAAqE;AACrE,kEAAkE;AAClE,mBAAmB;AACnB,EAAE;AACF,gEAAgE;AAChE,sEAAsE;AACtE,uDAAuD;AACvD,6DAA6D;AAC7D,qEAAqE;AACrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AAGtB,oEAAoE;AACpE,oEAAoE;AACpE,sDAAsD;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAQjD,kEAAkE;AAClE,uEAAuE;AACvE,0DAA0D;AAC1D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACb,MAAM,eAAe,CAAC"}

package/dist/lead.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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

package/dist/lead.d.ts.map

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

package/dist/lead.js

@@ -0,0 +1,38 @@
+/**
+ * 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

package/dist/lead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lead.js","sourceRoot":"","sources":["../src/lead.ts"],"names":[],"mappings":"AAiCA;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAA4B;IAE5B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAE9B,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,IAAI,CAAC,IAA0B;IACtC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACnD,kEAAkE;IAClE,8DAA8D;IAC9D,sCAAsC;IACtC,MAAM,KAAK,GAAI,IAAsC,CAAC,KAAK,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,KAAK,CAAC,CAAC;IAClD,MAAM,KAAK,GAAI,IAAI,CAAC,KAAwC,EAAE,KAAK,CAAC;IACpE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,KAAK,CAAC,CAAC;IAClD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,IAA0B;IAC7C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC;AACnC,CAAC"}

package/dist/llms-txt.d.ts

@@ -0,0 +1,81 @@
+/**
+ * llms.txt + llms-full.txt builders.
+ *
+ * Produces the LLM-discovery files defined at llmstxt.org and recommended
+ * by Cloudflare's agent-readiness post. Pure functions: each builder
+ * takes (siteConfig, nav, pages) and returns a string.
+ *
+ * Three outputs:
+ *   - `buildLlmsTxt(...)`           → top-level index, grouped by nav
+ *   - `buildSectionLlmsTxt(...)`    → per-section index for one nav group
+ *   - `buildLlmsFullTxt(...)`       → bundled body of every page
+ *
+ * Body serialization is opt-in via a callback so this module stays
+ * 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";
+export interface BuildLlmsTxtOptions {
+    /**
+     * Used to derive page slugs from nav hrefs. Defaults to
+     * `DEFAULT_BASE_PATH` (`"/docs"`). Set to `""` for sites served at
+     * the host root.
+     */
+    hrefPrefix?: string;
+    /**
+     * When the site has a siteUrl, emitted entry URLs become absolute
+     * (e.g. `https://example.com/docs/x.md`). When omitted, URLs stay
+     * relative (`/docs/x.md`).
+     */
+    siteUrl?: string;
+    /** Cap on description text length. Default: 160. */
+    descriptionLimit?: number;
+    /**
+     * Label for top-level leaf pages that aren't under a nav group.
+     * Default: "Documentation".
+     */
+    topLevelLabel?: string;
+}
+export interface BuildLlmsFullTxtOptions extends BuildLlmsTxtOptions {
+    /**
+     * "body"        → full markdown body of each page (requires `serializePage`)
+     * "description" → page title + description only
+     * Default: "body" if `serializePage` is provided, else "description".
+     */
+    summary?: "body" | "description";
+    /**
+     * Required when `summary === "body"`. Returns the canonical markdown
+     * body for a page (typically `treeToDogsbayMd(page.tree)`). Kept as a
+     * callback so this module doesn't pull in format-dogsbay-md.
+     */
+    serializePage?: (page: ExportPage) => string;
+}
+/**
+ * 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 declare function buildLlmsTxt(siteConfig: Pick<SiteConfig, "siteName" | "description" | "siteUrl">, nav: NavItem[], pages: ExportPage[], options?: BuildLlmsTxtOptions): string;
+/**
+ * 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 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:`
+ * 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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt.d.ts","sourceRoot":"","sources":["../src/llms-txt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EACV,UAAU,EAEV,OAAO,EACP,UAAU,EACV,QAAQ,EACT,MAAM,gBAAgB,CAAC;AAUxB,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAClE;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IACjC;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,MAAM,CAAC;CAC9C;AAID;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC,EACpE,GAAG,EAAE,OAAO,EAAE,EACd,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAoDR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC,EACpD,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAqBR;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC,EACpE,GAAG,EAAE,OAAO,EAAE,EACd,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,GAAE,uBAA4B,GACpC,MAAM,CA8CR;AAsGD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,CAO9D"}