@dogsbay/format-astro 0.2.0-beta.145 → 0.2.0-beta.146

package/dist/project.d.ts

@@ -206,6 +206,16 @@ export interface AstroProjectOptions {
      * `_dogsbay/versions.js` and `<unit home>_dogsbay/pages.js`.
      */
     products?: ProductModel;
+    /**
+     * The project's own `_headers` / `_redirects` (from the root of a source served at the site
+     * root): written first, the generated rules after, generated ones they already decide left out
+     * (@dogsbay/site-files host-files.ts, as dogsbay-ssg does). With its own `_redirects` the file is
+     * written whatever `deploy` says, since the project's host reads it.
+     */
+    hostFiles?: {
+        headers?: string;
+        redirects?: string;
+    };
     /**
      * Declared locales for the i18n axis. Same role as
      * `versions` for the locale axis.

package/dist/project.js

@@ -30,7 +30,7 @@ import { buildSitemapFiles, buildSitemapIndex } from "./sitemap.js";
 import { canonicalPlan } from "./canonical.js";
 import { headMetadata } from "./head-metadata.js";
 import { buildHeadersFile, buildRobotsTxt as buildRobotsTxtFile } from "@dogsbay/site-files";
-import { productRootRedirects, siteFiles, siteRootTarget, switcher as productSwitcherRows, toPagesScript, toScript, unitKeyString, unitManifest, unitOf, } from "@dogsbay/site-files";
+import { mergeHeaders, mergeRedirects, productRootRedirects, siteFiles, siteRootTarget, switcher as productSwitcherRows, toPagesScript, toScript, unitKeyString, unitManifest, unitOf, } from "@dogsbay/site-files";
 import { assembleBook, estimateTreeBytes } from "./granularity.js";
 /**
  * The per-topic "Read as single page" affordance (granularity book view).
@@ -2473,9 +2473,21 @@ function emitRedirects(outputDir, options, pages) {
     }
     for (const w of warnings)
         console.warn(`  Warning: ${w}`);
+    const publicDir = join(outputDir, "public");
+    const own = options.hostFiles?.redirects;
+    if (own !== undefined) {
+        // The project's _redirects first, ours after: written whatever the deploy target, since their host reads it
+        const merged = mergeRedirects(own, rules.length ? renderRedirectsFile(rules) : undefined, options.deploy === "cloudflare-workers");
+        mkdirSync(publicDir, { recursive: true });
+        writeFileSync(join(publicDir, "_redirects"), merged.text);
+        for (const n of merged.notes)
+            console.warn(`  Warning: ${n}`);
+        console.log(`  Redirects: the project's _redirects, then the generated rules it does not already decide → public/_redirects`);
+        if (options.deploy === "cloudflare-workers")
+            return;
+    }
     if (rules.length === 0)
         return;
-    const publicDir = join(outputDir, "public");
     if (options.deploy === "cloudflare-workers") {
         // Workers Static Assets reads _redirects from the ROOT of the assets
         // directory. On a subpath mount `public/` lands at dist/<mount>/, so the
@@ -2816,6 +2828,15 @@ function buildMissingTranslationStub(defaultUrl, fromLocale, toLocale) {
  * `emitAstroPages` (they share the page-loop's serialization step).
  */
 export function emitAgentReadinessFiles(pages, outputNav, outputDir, siteName, options) {
+    // The project's own _headers first, the generated Link header after (when llms.txt is on)
+    const ownHeaders = options.hostFiles?.headers;
+    if (ownHeaders !== undefined && options.llmsTxt === false) {
+        mkdirSync(join(outputDir, "public"), { recursive: true });
+        const merged = mergeHeaders(ownHeaders, undefined, options.deploy === "cloudflare-workers");
+        writeFileSync(join(outputDir, "public", "_headers"), merged.text);
+        for (const n of merged.notes)
+            console.warn(`  Warning: ${n}`);
+    }
     if (options.llmsTxt !== false) {
         emitLlmsTxtFiles(outputDir, siteName, options, outputNav, pages);
         // public/_headers — Cloudflare Workers / Pages convention. Adds an
@@ -2825,7 +2846,16 @@ export function emitAgentReadinessFiles(pages, outputNav, outputDir, siteName, o
         mkdirSync(join(outputDir, "public"), { recursive: true });
         // _headers Link header points at the per-mount llms.txt at
         // <combined>/llms.txt — the URL agents would actually fetch.
-        writeFileSync(join(outputDir, "public", "_headers"), buildHeadersFile(withBasePath(combinedPrefix(options), "/llms.txt")));
+        const generated = buildHeadersFile(withBasePath(combinedPrefix(options), "/llms.txt"));
+        if (ownHeaders === undefined) {
+            writeFileSync(join(outputDir, "public", "_headers"), generated);
+        }
+        else {
+            const merged = mergeHeaders(ownHeaders, generated, options.deploy === "cloudflare-workers");
+            writeFileSync(join(outputDir, "public", "_headers"), merged.text);
+            for (const n of merged.notes)
+                console.warn(`  Warning: ${n}`);
+        }
     }
     // Sitemap — emitted by Dogsbay (not @astrojs/sitemap) into
     // public/<basePath>/sitemap-{index,0}.xml so multi-mount deploys

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogsbay/format-astro",
-  "version": "0.2.0-beta.145",
+  "version": "0.2.0-beta.146",
   "description": "Astro format plugin for Dogsbay — export TreeNode[] to Astro component markup",
   "type": "module",
   "main": "dist/index.js",
@@ -32,12 +32,12 @@
   "license": "MIT",
   "dependencies": {
     "markdown-it": "^14.3.0",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.145",
-    "@dogsbay/serialize-core": "0.2.0-beta.145",
-    "@dogsbay/render-html": "0.2.0-beta.145",
-    "@dogsbay/site-files": "0.2.0-beta.145",
-    "@dogsbay/ui": "0.2.0-beta.145",
-    "@dogsbay/types": "0.2.0-beta.145"
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.146",
+    "@dogsbay/render-html": "0.2.0-beta.146",
+    "@dogsbay/serialize-core": "0.2.0-beta.146",
+    "@dogsbay/site-files": "0.2.0-beta.146",
+    "@dogsbay/types": "0.2.0-beta.146",
+    "@dogsbay/ui": "0.2.0-beta.146"
   },
   "repository": {
     "type": "git",