@dogsbay/format-astro 0.2.0-beta.5 → 0.2.0-beta.50

package/dist/base-path.d.ts

@@ -1,10 +1,12 @@
 /**
  * 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.
+ * `basePath` is the path-under-host where docs are served. The default
+ * is `""` (host root, matching every other SSG); set
+ * `site.basePath: "/docs"` in `dogsbay.config.yml` for the legacy
+ * "docs nested under marketing site" shape, or `"/handbook"` (etc.)
+ * for any other prefix. See plans/default-basepath-root.md for the
+ * rationale behind the default flip in v0.3.
  *
  * Every emitter that builds URLs, file paths, or rewrites links
  * reads from `AstroProjectOptions.basePath` and runs it through
@@ -22,8 +24,18 @@
  *
  * See plans/configurable-base-path.md.
  */
-/** Default `basePath` when no override is supplied. */
-export declare const DEFAULT_BASE_PATH = "/docs";
+/**
+ * Default `basePath` when no override is supplied.
+ *
+ * Changed in v0.3 from `"/docs"` to `""` (host root) so the default
+ * matches the plurality of doc-site deployments (GH Pages project
+ * sites, `docs.acme.com` subdomains, standalone wikis) and aligns
+ * with peer SSGs (Astro, Next, MkDocs, Docusaurus). The `cli`'s
+ * `site build` emits a one-shot migration warning when this default
+ * is hit so users from the `/docs` era can opt in to either value
+ * explicitly. See plans/default-basepath-root.md.
+ */
+export declare const DEFAULT_BASE_PATH = "";
 /**
  * Normalize a user-supplied `basePath` to canonical form.
  *
@@ -33,7 +45,7 @@ export declare const DEFAULT_BASE_PATH = "/docs";
  *   non-empty prefix.
  *
  * Examples:
- * - `undefined` → `"/docs"` (default)
+ * - `undefined` → `""` (default in v0.3+; was `"/docs"` previously)
  * - `""` → `""`
  * - `"/"` → `""`
  * - `"docs"` → `"/docs"`
@@ -68,6 +80,92 @@ export declare function basePathSegments(basePath: string): string[];
  * - `joinBaseUrl("", undefined, "")` → `"/"`
  */
 export declare function joinBaseUrl(basePath: string, section: string | undefined, slug: string): string;
+/**
+ * Prepend the normalized `basePath` onto a raw config-supplied
+ * `indexPath` (e.g. `/tags` from `taxonomies.tags.indexPath`),
+ * producing the URL prefix that components use to compose hrefs.
+ *
+ * Different from `joinBaseUrl` because it preserves absolute paths
+ * with internal `/` segments and does NOT add a trailing slash —
+ * downstream consumers do `${out}/<term>/` themselves.
+ *
+ * - `withBasePath("/docs", "/tags")` → `"/docs/tags"`
+ * - `withBasePath("/docs", "tags")`  → `"/docs/tags"`
+ * - `withBasePath("",      "/tags")` → `"/tags"`
+ * - `withBasePath("/docs", "/by-type")` → `"/docs/by-type"`
+ *
+ * Used for the URL-bearing `indexPath` baked into the taxonomy data
+ * file and the `tagsIndexPath` / `taxonomyIndexPaths` Astro props,
+ * so components like `<TagList>`, `<TaxonomyIndex>`, `<TaxonomyTerm>`,
+ * and `<TypeBadge>` produce hrefs that resolve under the configured
+ * site base. Without this prefix, taxonomy navigation 404s on any
+ * site with `site.basePath` set.
+ */
+export declare function withBasePath(basePath: string, indexPath: string): string;
+/**
+ * Parse `site.url` into its origin and path-component parts. The
+ * path component (if any) becomes the **urlBase** — the prefix the
+ * host serves dist/ at, distinct from `basePath` (which is the
+ * filesystem position of content within that served space).
+ *
+ * Used by emitters that need to (a) emit Astro's `base` config
+ * (= urlBase), (b) produce absolute URLs in sitemap / canonical /
+ * llms.txt (= origin + combined prefix + slug), or (c) build the
+ * combined prefix that internal hrefs need (`combinePrefix` below).
+ *
+ * Returns `origin` undefined when `siteUrl` is missing or unparseable
+ * — the caller then degrades to relative URLs (existing behavior).
+ *
+ * - `undefined` → `{ origin: undefined, urlBase: "" }`
+ * - `"https://example.com"` → `{ origin: "https://example.com", urlBase: "" }`
+ * - `"https://example.com/"` → `{ origin: "https://example.com", urlBase: "" }`
+ * - `"https://example.com/docs"` → `{ origin: "https://example.com", urlBase: "/docs" }`
+ * - `"https://example.com/docs/"` → `{ origin: "https://example.com", urlBase: "/docs" }`
+ * - `"https://user.github.io/dogsbay-docs"` → `{ origin: "https://user.github.io", urlBase: "/dogsbay-docs" }`
+ * - `"/relative-path"` → `{ origin: undefined, urlBase: "" }` (not a full URL)
+ *
+ * See plans/astro-base-from-site-url.md.
+ */
+export declare function parseSiteUrl(siteUrl: string | undefined): {
+    origin: string | undefined;
+    urlBase: string;
+};
+/**
+ * Combine a urlBase (host subpath, from `site.url`) with a
+ * basePath (filesystem layout prefix, from `site.basePath`) into the
+ * single prefix that nav hrefs, sitemap URLs, llms.txt, and the
+ * link rewriter all need.
+ *
+ * Both inputs MUST already be normalized (output of `normalizeBasePath`
+ * or `parseSiteUrl`): empty string OR a single leading slash with no
+ * trailing slash. The output respects the same shape.
+ *
+ * - `combinePrefix("", "")` → `""`
+ * - `combinePrefix("", "/docs")` → `"/docs"`
+ * - `combinePrefix("/repo", "")` → `"/repo"`
+ * - `combinePrefix("/repo", "/docs")` → `"/repo/docs"`
+ * - `combinePrefix("/handbook", "/team-docs")` → `"/handbook/team-docs"`
+ *
+ * See plans/astro-base-from-site-url.md.
+ */
+export declare function combinePrefix(urlBase: string, basePath: string): string;
+/**
+ * One-shot resolver: given the user's `site.url` + `site.basePath`,
+ * return everything emitters need. Convenience wrapper around
+ * `parseSiteUrl` + `normalizeBasePath` + `combinePrefix` so callers
+ * only do the math once.
+ *
+ * Used at the boundary in cli/site-build and cli/site-init to compute
+ * the effective prefixes before threading them into the emit tier.
+ *
+ * See plans/astro-base-from-site-url.md.
+ */
+export declare function resolvePrefixes(siteUrl: string | undefined, basePath: string | undefined): {
+    origin: string | undefined;
+    urlBase: string;
+    basePath: string;
+    combined: string;
+};
 /**
  * Build the `currentPath` value embedded in generated `.astro` pages
  * for `getPagination` lookups. No trailing slash so it matches the

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

@@ -1 +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"}
+{"version":3,"file":"base-path.d.ts","sourceRoot":"","sources":["../src/base-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG;IACzD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,CAiBA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B;IACD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CASA;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

@@ -1,10 +1,12 @@
 /**
  * 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.
+ * `basePath` is the path-under-host where docs are served. The default
+ * is `""` (host root, matching every other SSG); set
+ * `site.basePath: "/docs"` in `dogsbay.config.yml` for the legacy
+ * "docs nested under marketing site" shape, or `"/handbook"` (etc.)
+ * for any other prefix. See plans/default-basepath-root.md for the
+ * rationale behind the default flip in v0.3.
  *
  * Every emitter that builds URLs, file paths, or rewrites links
  * reads from `AstroProjectOptions.basePath` and runs it through
@@ -22,8 +24,18 @@
  *
  * See plans/configurable-base-path.md.
  */
-/** Default `basePath` when no override is supplied. */
-export const DEFAULT_BASE_PATH = "/docs";
+/**
+ * Default `basePath` when no override is supplied.
+ *
+ * Changed in v0.3 from `"/docs"` to `""` (host root) so the default
+ * matches the plurality of doc-site deployments (GH Pages project
+ * sites, `docs.acme.com` subdomains, standalone wikis) and aligns
+ * with peer SSGs (Astro, Next, MkDocs, Docusaurus). The `cli`'s
+ * `site build` emits a one-shot migration warning when this default
+ * is hit so users from the `/docs` era can opt in to either value
+ * explicitly. See plans/default-basepath-root.md.
+ */
+export const DEFAULT_BASE_PATH = "";
 /**
  * Normalize a user-supplied `basePath` to canonical form.
  *
@@ -33,7 +45,7 @@ export const DEFAULT_BASE_PATH = "/docs";
  *   non-empty prefix.
  *
  * Examples:
- * - `undefined` → `"/docs"` (default)
+ * - `undefined` → `""` (default in v0.3+; was `"/docs"` previously)
  * - `""` → `""`
  * - `"/"` → `""`
  * - `"docs"` → `"/docs"`
@@ -86,6 +98,123 @@ export function joinBaseUrl(basePath, section, slug) {
         parts.push(slug);
     return parts.length === 0 ? "/" : `/${parts.join("/")}/`;
 }
+/**
+ * Prepend the normalized `basePath` onto a raw config-supplied
+ * `indexPath` (e.g. `/tags` from `taxonomies.tags.indexPath`),
+ * producing the URL prefix that components use to compose hrefs.
+ *
+ * Different from `joinBaseUrl` because it preserves absolute paths
+ * with internal `/` segments and does NOT add a trailing slash —
+ * downstream consumers do `${out}/<term>/` themselves.
+ *
+ * - `withBasePath("/docs", "/tags")` → `"/docs/tags"`
+ * - `withBasePath("/docs", "tags")`  → `"/docs/tags"`
+ * - `withBasePath("",      "/tags")` → `"/tags"`
+ * - `withBasePath("/docs", "/by-type")` → `"/docs/by-type"`
+ *
+ * Used for the URL-bearing `indexPath` baked into the taxonomy data
+ * file and the `tagsIndexPath` / `taxonomyIndexPaths` Astro props,
+ * so components like `<TagList>`, `<TaxonomyIndex>`, `<TaxonomyTerm>`,
+ * and `<TypeBadge>` produce hrefs that resolve under the configured
+ * site base. Without this prefix, taxonomy navigation 404s on any
+ * site with `site.basePath` set.
+ */
+export function withBasePath(basePath, indexPath) {
+    const cleanIndex = indexPath.startsWith("/") ? indexPath : `/${indexPath}`;
+    return basePath ? `${basePath}${cleanIndex}` : cleanIndex;
+}
+/**
+ * Parse `site.url` into its origin and path-component parts. The
+ * path component (if any) becomes the **urlBase** — the prefix the
+ * host serves dist/ at, distinct from `basePath` (which is the
+ * filesystem position of content within that served space).
+ *
+ * Used by emitters that need to (a) emit Astro's `base` config
+ * (= urlBase), (b) produce absolute URLs in sitemap / canonical /
+ * llms.txt (= origin + combined prefix + slug), or (c) build the
+ * combined prefix that internal hrefs need (`combinePrefix` below).
+ *
+ * Returns `origin` undefined when `siteUrl` is missing or unparseable
+ * — the caller then degrades to relative URLs (existing behavior).
+ *
+ * - `undefined` → `{ origin: undefined, urlBase: "" }`
+ * - `"https://example.com"` → `{ origin: "https://example.com", urlBase: "" }`
+ * - `"https://example.com/"` → `{ origin: "https://example.com", urlBase: "" }`
+ * - `"https://example.com/docs"` → `{ origin: "https://example.com", urlBase: "/docs" }`
+ * - `"https://example.com/docs/"` → `{ origin: "https://example.com", urlBase: "/docs" }`
+ * - `"https://user.github.io/dogsbay-docs"` → `{ origin: "https://user.github.io", urlBase: "/dogsbay-docs" }`
+ * - `"/relative-path"` → `{ origin: undefined, urlBase: "" }` (not a full URL)
+ *
+ * See plans/astro-base-from-site-url.md.
+ */
+export function parseSiteUrl(siteUrl) {
+    if (!siteUrl)
+        return { origin: undefined, urlBase: "" };
+    // Only accept absolute http(s) URLs as full site URLs. Anything else
+    // (relative paths, mailto:, tel:, …) yields no origin — emitters
+    // fall back to whatever they do today when site.url is missing.
+    if (!/^https?:\/\//i.test(siteUrl)) {
+        return { origin: undefined, urlBase: "" };
+    }
+    let parsed;
+    try {
+        parsed = new URL(siteUrl);
+    }
+    catch {
+        return { origin: undefined, urlBase: "" };
+    }
+    const origin = `${parsed.protocol}//${parsed.host}`;
+    const urlBase = normalizeBasePath(parsed.pathname);
+    return { origin, urlBase };
+}
+/**
+ * Combine a urlBase (host subpath, from `site.url`) with a
+ * basePath (filesystem layout prefix, from `site.basePath`) into the
+ * single prefix that nav hrefs, sitemap URLs, llms.txt, and the
+ * link rewriter all need.
+ *
+ * Both inputs MUST already be normalized (output of `normalizeBasePath`
+ * or `parseSiteUrl`): empty string OR a single leading slash with no
+ * trailing slash. The output respects the same shape.
+ *
+ * - `combinePrefix("", "")` → `""`
+ * - `combinePrefix("", "/docs")` → `"/docs"`
+ * - `combinePrefix("/repo", "")` → `"/repo"`
+ * - `combinePrefix("/repo", "/docs")` → `"/repo/docs"`
+ * - `combinePrefix("/handbook", "/team-docs")` → `"/handbook/team-docs"`
+ *
+ * See plans/astro-base-from-site-url.md.
+ */
+export function combinePrefix(urlBase, basePath) {
+    // Both already normalized — concatenation is safe; no double slashes
+    // appear because each is empty OR starts with `/` and has no trailing.
+    if (!urlBase)
+        return basePath;
+    if (!basePath)
+        return urlBase;
+    return `${urlBase}${basePath}`;
+}
+/**
+ * One-shot resolver: given the user's `site.url` + `site.basePath`,
+ * return everything emitters need. Convenience wrapper around
+ * `parseSiteUrl` + `normalizeBasePath` + `combinePrefix` so callers
+ * only do the math once.
+ *
+ * Used at the boundary in cli/site-build and cli/site-init to compute
+ * the effective prefixes before threading them into the emit tier.
+ *
+ * See plans/astro-base-from-site-url.md.
+ */
+export function resolvePrefixes(siteUrl, basePath) {
+    const { origin, urlBase } = parseSiteUrl(siteUrl);
+    const normalizedBasePath = normalizeBasePath(basePath);
+    return {
+        origin,
+        urlBase,
+        basePath: normalizedBasePath,
+        combined: combinePrefix(urlBase, normalizedBasePath),
+    };
+}
 /**
  * Build the `currentPath` value embedded in generated `.astro` pages
  * for `getPagination` lookups. No trailing slash so it matches the

package/dist/base-path.js.map

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

package/dist/index.d.ts

@@ -2,11 +2,13 @@ export { treeToAstro, escapeExpr, escapeAttr, escapeTemplate } from "./serialize
 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 { DEFAULT_BASE_PATH, normalizeBasePath, basePathSegments, joinBaseUrl, buildCurrentPath, parseSiteUrl, combinePrefix, resolvePrefixes, } 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 { buildSitemap, buildSitemapIndex } from "./sitemap.js";
+export type { BuildSitemapOptions } from "./sitemap.js";
+export { exportAstroProject, emitSiteScaffold, emitSiteConfig, emitAstroPages, emitConfigDerivedFiles, emitAgentReadinessFiles, emitSwitcherMap, emitMissingTranslationStubs, emitPassthroughAstroPages, emitDeployArtifacts, } from "./project.js";
+export type { AstroProjectOptions, SwitcherMap, PassthroughCopy, } 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";

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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,EAChB,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,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;AAGvB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAaxD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,2BAA2B,EAC3B,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,eAAe,GAChB,MAAM,cAAc,CAAC;AAKtB,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

@@ -8,9 +8,11 @@ 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";
+export { DEFAULT_BASE_PATH, normalizeBasePath, basePathSegments, joinBaseUrl, buildCurrentPath, parseSiteUrl, combinePrefix, resolvePrefixes, } from "./base-path.js";
 // llms.txt + llms-full.txt builders (LLM discovery files)
 export { buildLlmsTxt, buildSectionLlmsTxt, buildLlmsFullTxt, extractFirstParagraph, } from "./llms-txt.js";
+// Sitemap builders (per-mount, sitemaps.org 0.9)
+export { buildSitemap, buildSitemapIndex } from "./sitemap.js";
 // Project export — orchestrator + per-tier emitters
 //
 // `exportAstroProject` is the high-level entry: generates a complete
@@ -22,7 +24,7 @@ export { buildLlmsTxt, buildSectionLlmsTxt, buildLlmsFullTxt, extractFirstParagr
 // 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";
+export { exportAstroProject, emitSiteScaffold, emitSiteConfig, emitAstroPages, emitConfigDerivedFiles, emitAgentReadinessFiles, emitSwitcherMap, emitMissingTranslationStubs, emitPassthroughAstroPages, emitDeployArtifacts, } 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.

package/dist/index.js.map

@@ -1 +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"}
+{"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,EAChB,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,0DAA0D;AAC1D,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAMvB,iDAAiD;AACjD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG/D,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,EAC3B,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAOtB,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/llms-txt.d.ts

@@ -35,6 +35,14 @@ export interface BuildLlmsTxtOptions {
      * Default: "Documentation".
      */
     topLevelLabel?: string;
+    /**
+     * Label for pages that exist in `pages` but are not reachable via
+     * `nav`. They're appended under a final section so agents see the
+     * full content surface even when nav curates a subset for human
+     * sidebars. Default: "Other pages". Set to `false` to suppress
+     * orphan emission entirely (matches pre-decoupling behavior).
+     */
+    otherPagesLabel?: string | false;
 }
 export interface BuildLlmsFullTxtOptions extends BuildLlmsTxtOptions {
     /**
@@ -56,8 +64,11 @@ export interface BuildLlmsFullTxtOptions extends BuildLlmsTxtOptions {
  * 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.
+ *     `## {topLevelLabel}` block.
+ *   - 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.
  */
 export declare function buildLlmsTxt(siteConfig: Pick<SiteConfig, "siteName" | "description" | "siteUrl">, nav: NavItem[], pages: ExportPage[], options?: BuildLlmsTxtOptions): string;
 /**

package/dist/llms-txt.d.ts.map

@@ -1 +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"}
+{"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;AAWxB,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;IACvB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAClC;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;;;;;;;;;;;GAWG;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,CA6ER;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,CAyDR;AAmJD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,CAO9D"}

package/dist/llms-txt.js

@@ -2,6 +2,7 @@ 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";
+const DEFAULT_OTHER_PAGES_LABEL = "Other pages";
 // ── Public builders ─────────────────────────────────────────────
 /**
  * Build the top-level llms.txt index for a site.
@@ -9,15 +10,22 @@ const DEFAULT_TOP_LEVEL_LABEL = "Documentation";
  * 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.
+ *     `## {topLevelLabel}` block.
+ *   - 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.
  */
 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("");
@@ -34,11 +42,11 @@ export function buildLlmsTxt(siteConfig, nav, pages, options = {}) {
             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);
+                const entry = renderEntry(item, slugIndex, hrefPrefix, siteUrl, descLimit, emittedSlugs);
                 if (entry)
                     lines.push(entry);
             }
-            collectEntries(item.children, slugIndex, hrefPrefix, siteUrl, descLimit, lines);
+            collectEntries(item.children, slugIndex, hrefPrefix, siteUrl, descLimit, lines, emittedSlugs);
             lines.push("");
             groupSections.push(lines);
         }
@@ -50,7 +58,7 @@ export function buildLlmsTxt(siteConfig, nav, pages, options = {}) {
         out.push(`## ${topLevelLabel}`);
         out.push("");
         for (const leaf of topLevelLeaves) {
-            const entry = renderEntry(leaf, slugIndex, hrefPrefix, siteUrl, descLimit);
+            const entry = renderEntry(leaf, slugIndex, hrefPrefix, siteUrl, descLimit, emittedSlugs);
             if (entry)
                 out.push(entry);
         }
@@ -59,6 +67,19 @@ export function buildLlmsTxt(siteConfig, nav, pages, options = {}) {
     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";
 }
 /**
@@ -100,6 +121,16 @@ export function buildLlmsFullTxt(siteConfig, nav, pages, options = {}) {
     }
     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("");
@@ -108,7 +139,7 @@ export function buildLlmsFullTxt(siteConfig, nav, pages, options = {}) {
         out.push("");
     }
     let firstPage = true;
-    for (const slug of navOrder) {
+    for (const slug of allSlugs) {
         const page = slugIndex.get(slug);
         if (!page)
             continue;
@@ -133,19 +164,19 @@ export function buildLlmsFullTxt(siteConfig, nav, pages, options = {}) {
     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) {
+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);
+            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);
+            collectEntries(item.children, slugIndex, hrefPrefix, siteUrl, descLimit, out, emitted);
         }
     }
 }
-function renderEntry(item, slugIndex, hrefPrefix, siteUrl, descLimit) {
+function renderEntry(item, slugIndex, hrefPrefix, siteUrl, descLimit, emitted) {
     if (!item.href)
         return null;
     const slug = hrefToSlug(item.href, hrefPrefix);
@@ -155,10 +186,33 @@ function renderEntry(item, slugIndex, hrefPrefix, siteUrl, descLimit) {
     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();
@@ -204,8 +258,21 @@ function slugToHref(slug, hrefPrefix) {
 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) {