@dogsbay/format-astro 0.2.0-beta.6 → 0.2.0-beta.60

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

@@ -1,12 +1,14 @@
 export { treeToAstro, escapeExpr, escapeAttr, escapeTemplate } from "./serialize.js";
-export { detectLeadingNodes } from "./lead.js";
+export { detectLeadingNodes, deriveDescription } 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,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAClE,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

@@ -4,13 +4,15 @@ export { treeToAstro, escapeExpr, escapeAttr, escapeTemplate } from "./serialize
 // 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";
+export { detectLeadingNodes, deriveDescription } 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,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAIlE,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/lead.d.ts

@@ -36,4 +36,23 @@ export interface LeadingNodeInfo {
  * `false` for both flags when the tree is empty.
  */
 export declare function detectLeadingNodes(tree: TreeNode[] | undefined): LeadingNodeInfo;
+/**
+ * Derive a `<meta name="description">` from a page body when the
+ * frontmatter doesn't supply one: the first prose paragraph,
+ * whitespace-collapsed and truncated at a word boundary.
+ *
+ * Deliberately Minja-unaware. This only runs at build time, on the
+ * preprocessed (resolved) tree — `{{ var }}` and `{% include %}` are
+ * already gone, so the first paragraph is real prose. (A still-undefined
+ * `{{ var }}` survives `preserve` mode, but that's a content bug equally
+ * visible in the body and already flagged by the `unresolved-directives`
+ * audit — not the description's job to scrub.) The `--no-preprocess` /
+ * `dogsbay convert` paths emit unresolved output by design, where a
+ * slightly-off description is the least of it.
+ *
+ * Scans past a leading H1 / heading / code to the first prose paragraph;
+ * returns `undefined` when the page has no prose. See
+ * plans/auto-meta-description.md.
+ */
+export declare function deriveDescription(tree: TreeNode[] | undefined, maxLen?: number): string | undefined;
 //# sourceMappingURL=lead.d.ts.map

package/dist/lead.d.ts.map

@@ -1 +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"}
+{"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;AAmBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,QAAQ,EAAE,GAAG,SAAS,EAC5B,MAAM,SAAM,GACX,MAAM,GAAG,SAAS,CAYpB"}

package/dist/lead.js

@@ -35,4 +35,75 @@ function isParagraph(node) {
         return false;
     return node.type === "paragraph";
 }
+/**
+ * Derive a `<meta name="description">` from a page body when the
+ * frontmatter doesn't supply one: the first prose paragraph,
+ * whitespace-collapsed and truncated at a word boundary.
+ *
+ * Deliberately Minja-unaware. This only runs at build time, on the
+ * preprocessed (resolved) tree — `{{ var }}` and `{% include %}` are
+ * already gone, so the first paragraph is real prose. (A still-undefined
+ * `{{ var }}` survives `preserve` mode, but that's a content bug equally
+ * visible in the body and already flagged by the `unresolved-directives`
+ * audit — not the description's job to scrub.) The `--no-preprocess` /
+ * `dogsbay convert` paths emit unresolved output by design, where a
+ * slightly-off description is the least of it.
+ *
+ * Scans past a leading H1 / heading / code to the first prose paragraph;
+ * returns `undefined` when the page has no prose. See
+ * plans/auto-meta-description.md.
+ */
+export function deriveDescription(tree, maxLen = 155) {
+    if (!tree || tree.length === 0)
+        return undefined;
+    // Skip a leading H1 (the page title) so the lede is the node after it.
+    let i = isH1(tree[0]) ? 1 : 0;
+    for (; i < tree.length; i++) {
+        const node = tree[i];
+        if (node.type !== "paragraph")
+            continue; // skip headings/code/etc.
+        const text = paragraphText(node).replace(/\s+/g, " ").trim();
+        if (!text)
+            continue;
+        return truncateAtWord(text, maxLen);
+    }
+    return undefined;
+}
+/**
+ * Flatten a paragraph node's text. Tolerant of the three shapes
+ * format-astro already handles: flat `node.inline`, wrapped
+ * `node.children[{ inline }]`, and pre-rendered `node.html`.
+ */
+function paragraphText(node) {
+    const parts = [];
+    const visit = (n) => {
+        if (!n || typeof n !== "object")
+            return;
+        const o = n;
+        if (typeof o.text === "string")
+            parts.push(o.text);
+        if (typeof o.code === "string")
+            parts.push(o.code);
+        if (Array.isArray(o.inline))
+            o.inline.forEach(visit);
+        if (Array.isArray(o.children))
+            o.children.forEach(visit);
+    };
+    if (Array.isArray(node.inline))
+        node.inline.forEach(visit);
+    else if (Array.isArray(node.children))
+        node.children.forEach(visit);
+    else if (typeof node.html === "string") {
+        parts.push(node.html.replace(/<[^>]+>/g, ""));
+    }
+    return parts.join("");
+}
+function truncateAtWord(s, max) {
+    if (s.length <= max)
+        return s;
+    const cut = s.slice(0, max);
+    const lastSpace = cut.lastIndexOf(" ");
+    const base = lastSpace > max * 0.6 ? cut.slice(0, lastSpace) : cut;
+    return base.replace(/[\s.,;:!?-]+$/, "") + "…";
+}
 //# sourceMappingURL=lead.js.map

package/dist/lead.js.map

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

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"}