@writedocs/generator 0.4.2 → 0.4.4

package/astro.config.mjs

@@ -147,6 +147,40 @@ function collectNoindexIds(rootContentDir) {
 
 const noindexIds = siteUrl ? collectNoindexIds(contentDir) : new Set();
 
+/** O @astrojs/sitemap sempre grava um sitemap-index.xml apontando para
+ *  sitemap-0.xml, sitemap-1.xml, ... - mesmo quando há um arquivo só, que é
+ *  o caso de todo site de docs abaixo de 50.000 páginas. Aqui o único
+ *  sitemap-0.xml vira sitemap.xml (o endereço que crawler e ferramenta de
+ *  SEO procuram primeiro) e o índice é apagado. Com mais de um arquivo o
+ *  índice é necessário (o protocolo não permite um único arquivo acima de
+ *  50.000 URLs), então tudo fica como o plugin gravou. Um sitemap.xml
+ *  vindo do public/ do próprio site também não é sobrescrito. */
+function singleSitemapFile() {
+  return {
+    name: 'writedocs-single-sitemap',
+    hooks: {
+      'astro:build:done': ({ dir }) => {
+        const outDir = fileURLToPath(dir);
+        const chunks = fs.readdirSync(outDir).filter((f) => /^sitemap-\d+\.xml$/.test(f));
+        const target = path.join(outDir, 'sitemap.xml');
+        if (chunks.length !== 1) {
+          console.log(`[writedocs] ${chunks.length} sitemap files generated - keeping sitemap-index.xml.`);
+          return;
+        }
+        if (fs.existsSync(target)) {
+          console.log('[writedocs] public/sitemap.xml exists - keeping it and the generated sitemap-index.xml.');
+          return;
+        }
+        fs.renameSync(path.join(outDir, chunks[0]), target);
+        fs.rmSync(path.join(outDir, 'sitemap-index.xml'), { force: true });
+        // O próprio plugin acabou de logar "sitemap-index.xml created"; esta
+        // linha diz o que de fato ficou no build.
+        console.log(`[writedocs] Replaced ${chunks[0]} + sitemap-index.xml with a single sitemap.xml.`);
+      },
+    },
+  };
+}
+
 // writedocs.json's `redirects` array -> Astro's own `redirects` config option
 // (a plain `{ [source]: destination }` record - see redirectSchema in
 // lib/config.ts for why there's no `permanent`/status-code field: this
@@ -207,12 +241,19 @@ export default defineConfig({
     ...(siteUrl
       ? [
           sitemap({
+            // Teto do protocolo de sitemap por arquivo (o default do
+            // @astrojs/sitemap é 45.000). Até aqui, tudo cabe num único
+            // sitemap.xml - ver singleSitemapFile() abaixo.
+            entryLimit: 50000,
             filter: (page) => {
               const pathname = new URL(page).pathname;
               const id = normalizeEntryId(pathname);
               return !noindexIds.has(id);
             },
           }),
+          // Precisa vir depois do sitemap(): o Astro roda os hooks
+          // astro:build:done na ordem deste array, um de cada vez.
+          singleSitemapFile(),
         ]
       : []),
     // Lets styles.favicon/styles.logo/styles.background.images/seo.ogImage/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@writedocs/generator",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Static site generator for docs — a writedocs.json + MDX folder in, a static site out.",
   "type": "module",
   "bin": {
@@ -84,4 +84,4 @@
   "devDependencies": {
     "esbuild": "0.28.2"
   }
-}
+}

package/src/layout/components/AskAiWidget.astro

@@ -25,11 +25,17 @@ interface Props {
 const { config } = Astro.props as Props;
 
 const askAiLoaderScript = `window.DocsBotAI=window.DocsBotAI||{},DocsBotAI.init=function(e){return new Promise((t,r)=>{var n=document.createElement("script");n.type="text/javascript",n.async=!0,n.src="https://widget.docsbot.ai/chat.js";let o=document.getElementsByTagName("script")[0];o.parentNode.insertBefore(n,o),n.addEventListener("load",()=>{let n;Promise.all([new Promise((t,r)=>{window.DocsBotAI.mount(Object.assign({}, e)).then(t).catch(r)}),(n=function e(t){return new Promise(e=>{if(document.querySelector(t))return e(document.querySelector(t));let r=new MutationObserver(n=>{if(document.querySelector(t))return e(document.querySelector(t)),r.disconnect()});r.observe(document.body,{childList:!0,subtree:!0})})})("#docsbotai-root"),]).then(()=>t()).catch(r)}),n.addEventListener("error",e=>{r(e.message)})})};`;
-const askAiInitScript = config.integrations.askAi
-  ? `DocsBotAI.init(${JSON.stringify({ id: config.integrations.askAi.id })});`
+// WRITEDOCS_ASK_AI_ID tem precedência sobre o writedocs.json, pelo mesmo
+// motivo do WRITEDOCS_DISABLE_WATERMARK em Sidebar.astro: quem roda o build
+// (CI, env da hospedagem) define o bot sem mexer no conteúdo versionado.
+// Não é segredo - o id sai em texto puro no HTML de toda página. String
+// vazia conta como não definida e cai no valor do JSON.
+const askAiId = process.env.WRITEDOCS_ASK_AI_ID || config.integrations.askAi?.id;
+const askAiInitScript = askAiId
+  ? `DocsBotAI.init(${JSON.stringify({ id: askAiId })});`
   : null;
 ---
-{config.integrations.askAi && (
+{askAiId && (
   <>
     <script is:inline set:html={askAiLoaderScript} />
     {askAiInitScript && <script is:inline set:html={askAiInitScript} />}