@writedocs/generator 0.4.6 → 0.4.8

package/src/pages/llms-full.txt.ts

@@ -4,6 +4,7 @@ import path from 'node:path';
 import type { APIRoute } from 'astro';
 import { loadDocsConfig, normalizeEntryId, findAllPages } from '../lib/config';
 import { writedocsTempDir } from '../lib/writedocs-temp-dir.js';
+import { applyVisibilityForAgents } from '../lib/visibility.js';
 
 // The "everything, concatenated" half of the llms.txt pair - see
 // llms.txt.ts (right next to this file) for the lightweight index half,
@@ -49,9 +50,12 @@ export const GET: APIRoute = async () => {
     // Same noindex exclusion llms.txt.ts applies to its own listing -
     // see that file's comment.
     .filter((entry) => !entry.data.seo?.noindex)
+    // Same `url` exclusion as llms.txt.ts - a redirect, not a page.
+    .filter((entry) => !entry.data.url)
     .map((entry: DocsEntry) => {
       const slug = normalizeEntryId(entry.id);
-      const body = entry.body ?? '';
+      // Agents' view of <Visibility> blocks, same as the .md route.
+      const body = applyVisibilityForAgents(entry.body ?? '');
       return { slug, title: entry.data.title, body };
     })
     .sort((a, b) => a.slug.localeCompare(b.slug));

package/src/pages/llms.txt.ts

@@ -85,6 +85,9 @@ export const GET: APIRoute = async () => {
     // same reason: llms.txt exists to help external tools discover
     // pages, exactly what `noindex` asked not to happen.
     .filter((entry) => !entry.data.seo?.noindex)
+    // A frontmatter `url` page (Mintlify's external link) has no content -
+    // its own URL only redirects to the link.
+    .filter((entry) => !entry.data.url)
     .map((entry: DocsEntry) => {
       const slug = normalizeEntryId(entry.id);
       // Same URL Astro's own router resolves this entry to - see

package/src/styles/global.css

@@ -16,3 +16,13 @@
    classes available with zero effect on existing unstyled elements. */
 @import "tailwindcss/theme.css";
 @import "tailwindcss/utilities.css";
+
+/* Tailwind's `dark:` variant follows the site's own theme toggle
+   ([data-theme="dark"] on <html>, set by BaseLayout.astro), not the OS
+   setting it defaults to - otherwise Mintlify-style light/dark image
+   pairs (className="block dark:hidden" / "hidden dark:block") show the
+   wrong one whenever the reader's toggle and their OS disagree. The
+   site's content directory is added as a Tailwind source at build time
+   by astro.config.mjs's contentTailwindSource() plugin, since it lives
+   outside this package where Tailwind looks by default. */
+@custom-variant dark (&:where([data-theme="dark"], [data-theme="dark"] *));