doccupine 0.0.89 → 0.0.90

package/dist/index.js

@@ -12,9 +12,13 @@ import { ConfigManager } from "./lib/config-manager.js";
 import { findAvailablePort, generateSlug, getFullSlug, escapeTemplateContent, } from "./lib/utils.js";
 import { generateMetadataBlock, generateRuntimeOnlyMetadataBlock, generateJsonLdScript, } from "./lib/metadata.js";
 import { nextConfigTemplate } from "./templates/next.config.js";
+import { pnpmWorkspaceTemplate } from "./templates/pnpmWorkspace.js";
 import { proxyTemplate } from "./templates/proxy.js";
 import { robotsTemplate } from "./templates/app/robots.js";
 import { sitemapTemplate } from "./templates/app/sitemap.js";
+import { llmsIndexTemplate } from "./templates/llms/llmsIndex.js";
+import { llmsFullTemplate, } from "./templates/llms/llmsFull.js";
+import { llmsPageTemplate } from "./templates/llms/llmsPage.js";
 export { generateSlug, getFullSlug, escapeTemplateContent, } from "./lib/utils.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -43,6 +47,8 @@ class MDXToNextJSGenerator {
     sectionsConfig = null;
     /** Guards against recursive reprocessing when maybeUpdateSections() triggers processAllMDXFiles() */
     isReprocessing = false;
+    /** Tracks per-page .md files written under public/ so we can clean up stale ones on rename/delete */
+    generatedLlmsPagePaths = new Set();
     constructor(watchDir, outputDir) {
         this.watchDir = path.resolve(watchDir);
         this.outputDir = path.resolve(outputDir);
@@ -78,6 +84,7 @@ class MDXToNextJSGenerator {
         const structure = {
             ...appStructure,
             "next.config.ts": nextConfigTemplate(this.analyticsConfig),
+            "pnpm-workspace.yaml": pnpmWorkspaceTemplate,
             "proxy.ts": proxyTemplate(this.analyticsConfig),
             "analytics.json": `{}\n`,
             "config.json": `{}\n`,
@@ -94,6 +101,7 @@ class MDXToNextJSGenerator {
             await fs.writeFile(fullPath, String(await content), "utf8");
         }
         await this.updateSitemap();
+        await this.updateLlmsFiles();
     }
     async createStartingDocs() {
         const structure = startingDocsStructure;
@@ -334,6 +342,7 @@ class MDXToNextJSGenerator {
                 if (fileName === "config.json") {
                     await this.updateSitemap();
                     await this.updateRobots();
+                    await this.updateLlmsFiles();
                 }
             }
             catch (error) {
@@ -356,6 +365,7 @@ class MDXToNextJSGenerator {
                 if (fileName === "config.json") {
                     await this.updateSitemap();
                     await this.updateRobots();
+                    await this.updateLlmsFiles();
                 }
             }
             catch (error) {
@@ -681,6 +691,7 @@ class MDXToNextJSGenerator {
             await this.updatePagesIndex();
             await this.updateRootLayout();
             await this.updateSitemap();
+            await this.updateLlmsFiles();
             await this.generateSectionIndexPages();
             console.log(chalk.green(`✅ Generated page for: ${filePath}`));
             await this.maybeUpdateSections();
@@ -705,6 +716,7 @@ class MDXToNextJSGenerator {
             await this.updatePagesIndex();
             await this.updateRootLayout();
             await this.updateSitemap();
+            await this.updateLlmsFiles();
             console.log(chalk.green(`✅ Removed page for: ${filePath}`));
             await this.maybeUpdateSections();
         }
@@ -1018,6 +1030,120 @@ export default function Page() {
             ? `🤖 Regenerated robots.ts with sitemap link`
             : `🤖 Regenerated robots.ts (no sitemap link)`));
     }
+    async loadSiteMetadata() {
+        const configPath = path.join(this.rootDir, "config.json");
+        let url = null;
+        let name = "Documentation";
+        let description = "";
+        try {
+            if (await fs.pathExists(configPath)) {
+                const content = await fs.readFile(configPath, "utf8");
+                const parsed = JSON.parse(content);
+                if (typeof parsed.url === "string" && parsed.url.trim() !== "") {
+                    url = parsed.url.trim().replace(/\/$/, "");
+                }
+                if (typeof parsed.name === "string" && parsed.name.trim() !== "") {
+                    name = parsed.name.trim();
+                }
+                else if (typeof parsed.title === "string" &&
+                    parsed.title.trim() !== "") {
+                    name = parsed.title.trim();
+                }
+                if (typeof parsed.description === "string" &&
+                    parsed.description.trim() !== "") {
+                    description = parsed.description.trim();
+                }
+            }
+        }
+        catch (error) {
+            console.warn(chalk.yellow("⚠️ Error reading config.json for llms metadata"), error);
+        }
+        return { url, name, description };
+    }
+    async readPageWithBody(page) {
+        const fullPath = path.join(this.watchDir, page.path);
+        const raw = await fs.readFile(fullPath, "utf8");
+        const { content: body } = matter(raw);
+        return { ...page, body };
+    }
+    llmsManifestPath() {
+        return path.join(this.outputDir, ".doccupine-llms-manifest.json");
+    }
+    async readLlmsManifest() {
+        const manifestPath = this.llmsManifestPath();
+        try {
+            if (await fs.pathExists(manifestPath)) {
+                const raw = await fs.readFile(manifestPath, "utf8");
+                const parsed = JSON.parse(raw);
+                if (Array.isArray(parsed.pageFiles)) {
+                    return new Set(parsed.pageFiles.filter((entry) => typeof entry === "string"));
+                }
+            }
+        }
+        catch {
+            // ignore corrupted manifest
+        }
+        return new Set();
+    }
+    async writeLlmsManifest(pageFiles) {
+        const manifestPath = this.llmsManifestPath();
+        const payload = { pageFiles: Array.from(pageFiles).sort() };
+        const json = JSON.stringify(payload, null, 2) + "\n";
+        await fs.writeFile(manifestPath, json, "utf8");
+    }
+    async updateLlmsFiles() {
+        const publicDir = path.join(this.outputDir, "public");
+        await fs.ensureDir(publicDir);
+        const { url: baseUrl, name, description } = await this.loadSiteMetadata();
+        const pages = await this.buildAllPagesMeta();
+        const pagesWithBodies = await Promise.all(pages.map((page) => this.readPageWithBody(page)));
+        const indexContent = llmsIndexTemplate({
+            siteName: name,
+            siteDescription: description,
+            baseUrl,
+            pages,
+            sectionsConfig: this.sectionsConfig,
+        });
+        const fullContent = llmsFullTemplate({
+            siteName: name,
+            siteDescription: description,
+            baseUrl,
+            pages: pagesWithBodies,
+            sectionsConfig: this.sectionsConfig,
+        });
+        await fs.writeFile(path.join(publicDir, "llms.txt"), indexContent, "utf8");
+        await fs.writeFile(path.join(publicDir, "llms-full.txt"), fullContent, "utf8");
+        const nextRelativePaths = new Set();
+        await Promise.all(pagesWithBodies.map(async (page) => {
+            if (page.slug === "")
+                return;
+            const relPath = `${page.slug}.md`;
+            const targetPath = path.join(publicDir, relPath);
+            await fs.ensureDir(path.dirname(targetPath));
+            await fs.writeFile(targetPath, llmsPageTemplate(page, baseUrl), "utf8");
+            nextRelativePaths.add(relPath);
+        }));
+        const previousRelativePaths = new Set([
+            ...this.generatedLlmsPagePaths,
+            ...(await this.readLlmsManifest()),
+        ]);
+        for (const stale of previousRelativePaths) {
+            if (!nextRelativePaths.has(stale)) {
+                try {
+                    const stalePath = path.join(publicDir, stale);
+                    if (await fs.pathExists(stalePath)) {
+                        await fs.remove(stalePath);
+                    }
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+        this.generatedLlmsPagePaths = nextRelativePaths;
+        await this.writeLlmsManifest(nextRelativePaths);
+        console.log(chalk.green(`🤖 Generated llms.txt and llms-full.txt with ${pages.length} page(s)${baseUrl ? ` using ${baseUrl}` : " (relative URLs)"}`));
+    }
     async stop() {
         if (this.watcher) {
             await this.watcher.close();
@@ -1077,7 +1203,7 @@ program
     console.log(chalk.blue(`📦 Using ${packageManager}...`));
     const install = spawn(packageManager, ["install"], {
         cwd: config.outputDir,
-        stdio: "pipe",
+        stdio: "inherit",
     });
     await new Promise((resolve, reject) => {
         install.on("close", (code) => {

package/dist/templates/components/layout/Button.d.ts

@@ -1 +1 @@
-export declare const buttonTemplate = "\"use client\";\nimport Link from \"next/link\";\nimport styled from \"styled-components\";\nimport {\n  theme as localTheme,\n  ButtonProps,\n  buttonStyles,\n} from \"cherry-styled-components\";\nimport { Icon } from \"@/components/layout/Icon\";\n\ninterface LinkButtonProps extends ButtonProps {\n  href?: string;\n  target?: \"_blank\" | \"_self\" | \"_parent\" | \"_top\";\n  variant?: \"primary\" | \"secondary\" | \"tertiary\";\n  size?: \"default\" | \"big\";\n  outline?: boolean;\n  fullWidth?: boolean;\n  icon?: string;\n  iconPosition?: \"left\" | \"right\";\n  theme?: typeof localTheme;\n}\n\n// Cherry's buttonStyles picks filled-button text via `isDark ? colors.dark : colors.light`.\n// Our theme's isDark is a stub (false) because mode switching lives in CSS vars, so\n// the fallback resolves to --color-light (black in dark mode). Re-pin to `surface`,\n// which resolves to white in both modes, for the filled, non-disabled case.\nconst StyledLinkButton = styled(Link)<LinkButtonProps>`\n  ${({ theme, $variant, $size, $outline, $fullWidth, disabled }) =>\n    buttonStyles(theme, $variant, $size, $outline, $fullWidth, disabled)}\n\n  ${({ theme, $outline, disabled }) =>\n    !disabled && !$outline && `color: ${theme.colors.surface};`}\n\n  & p {\n    color: inherit !important;\n  }\n\n  & svg.lucide {\n    margin: auto 0;\n    min-width: min-content;\n    color: inherit;\n  }\n`;\n\nconst ButtonBase = styled.button<ButtonProps>`\n  ${({ theme, $variant, $size, $outline, $fullWidth, disabled }) =>\n    buttonStyles(theme, $variant, $size, $outline, $fullWidth, disabled)}\n\n  ${({ theme, $outline, disabled }) =>\n    !disabled && !$outline && `color: ${theme.colors.surface};`}\n\n  & p {\n    color: inherit !important;\n  }\n\n  & svg.lucide {\n    margin: auto 0;\n    min-width: min-content;\n    color: inherit;\n  }\n`;\n\nfunction Button({\n  variant = \"primary\",\n  size,\n  outline,\n  fullWidth,\n  icon,\n  iconPosition = \"left\",\n  theme: _theme = localTheme,\n  href,\n  ...props\n}: LinkButtonProps) {\n  return href ? (\n    <div>\n      <StyledLinkButton\n        {...props}\n        href={href}\n        $variant={variant}\n        $size={size}\n        $outline={outline}\n        $fullWidth={fullWidth}\n      >\n        {iconPosition === \"left\" && icon && <Icon name={icon} size={16} />}\n        {props.children}\n        {iconPosition === \"right\" && icon && <Icon name={icon} size={16} />}\n      </StyledLinkButton>\n    </div>\n  ) : (\n    <div>\n      <ButtonBase\n        {...props}\n        $variant={variant}\n        $size={size}\n        $outline={outline}\n        $fullWidth={fullWidth}\n      >\n        {iconPosition === \"left\" && icon && <Icon name={icon} size={16} />}\n        {props.children}\n        {iconPosition === \"right\" && icon && <Icon name={icon} size={16} />}\n      </ButtonBase>\n    </div>\n  );\n}\n\nexport { Button };\n";
+export declare const buttonTemplate = "\"use client\";\nimport Link from \"next/link\";\nimport styled from \"styled-components\";\nimport {\n  theme as localTheme,\n  ButtonProps,\n  buttonStyles,\n} from \"cherry-styled-components\";\nimport { Icon } from \"@/components/layout/Icon\";\n\ninterface LinkButtonProps extends ButtonProps {\n  href?: string;\n  target?: \"_blank\" | \"_self\" | \"_parent\" | \"_top\";\n  rel?: string;\n  variant?: \"primary\" | \"secondary\" | \"tertiary\";\n  size?: \"default\" | \"big\";\n  outline?: boolean;\n  fullWidth?: boolean;\n  icon?: string;\n  iconPosition?: \"left\" | \"right\";\n  theme?: typeof localTheme;\n}\n\n// Cherry's buttonStyles picks filled-button text via `isDark ? colors.dark : colors.light`.\n// Our theme's isDark is a stub (false) because mode switching lives in CSS vars, so\n// the fallback resolves to --color-light (black in dark mode). Re-pin to `surface`,\n// which resolves to white in both modes, for the filled, non-disabled case.\nconst StyledLinkButton = styled(Link)<LinkButtonProps>`\n  ${({ theme, $variant, $size, $outline, $fullWidth, disabled }) =>\n    buttonStyles(theme, $variant, $size, $outline, $fullWidth, disabled)}\n\n  ${({ theme, $outline, disabled }) =>\n    !disabled && !$outline && `color: ${theme.colors.surface};`}\n\n  & p {\n    color: inherit !important;\n  }\n\n  & svg.lucide {\n    margin: auto 0;\n    min-width: min-content;\n    color: inherit;\n  }\n`;\n\nconst ButtonBase = styled.button<ButtonProps>`\n  ${({ theme, $variant, $size, $outline, $fullWidth, disabled }) =>\n    buttonStyles(theme, $variant, $size, $outline, $fullWidth, disabled)}\n\n  ${({ theme, $outline, disabled }) =>\n    !disabled && !$outline && `color: ${theme.colors.surface};`}\n\n  & p {\n    color: inherit !important;\n  }\n\n  & svg.lucide {\n    margin: auto 0;\n    min-width: min-content;\n    color: inherit;\n  }\n`;\n\nfunction Button({\n  variant = \"primary\",\n  size,\n  outline,\n  fullWidth,\n  icon,\n  iconPosition = \"left\",\n  theme: _theme = localTheme,\n  href,\n  target,\n  rel,\n  ...props\n}: LinkButtonProps) {\n  const isExternal = typeof href === \"string\" && /^(https?:)?\\/\\//i.test(href);\n  const resolvedTarget = target ?? (isExternal ? \"_blank\" : undefined);\n  const resolvedRel =\n    rel ?? (resolvedTarget === \"_blank\" ? \"noopener noreferrer\" : undefined);\n  return href ? (\n    <div>\n      <StyledLinkButton\n        {...props}\n        href={href}\n        target={resolvedTarget}\n        rel={resolvedRel}\n        $variant={variant}\n        $size={size}\n        $outline={outline}\n        $fullWidth={fullWidth}\n      >\n        {iconPosition === \"left\" && icon && <Icon name={icon} size={16} />}\n        {props.children}\n        {iconPosition === \"right\" && icon && <Icon name={icon} size={16} />}\n      </StyledLinkButton>\n    </div>\n  ) : (\n    <div>\n      <ButtonBase\n        {...props}\n        $variant={variant}\n        $size={size}\n        $outline={outline}\n        $fullWidth={fullWidth}\n      >\n        {iconPosition === \"left\" && icon && <Icon name={icon} size={16} />}\n        {props.children}\n        {iconPosition === \"right\" && icon && <Icon name={icon} size={16} />}\n      </ButtonBase>\n    </div>\n  );\n}\n\nexport { Button };\n";

package/dist/templates/components/layout/Button.js

@@ -11,6 +11,7 @@ import { Icon } from "@/components/layout/Icon";
 interface LinkButtonProps extends ButtonProps {
   href?: string;
   target?: "_blank" | "_self" | "_parent" | "_top";
+  rel?: string;
   variant?: "primary" | "secondary" | "tertiary";
   size?: "default" | "big";
   outline?: boolean;
@@ -69,13 +70,21 @@ function Button({
   iconPosition = "left",
   theme: _theme = localTheme,
   href,
+  target,
+  rel,
   ...props
 }: LinkButtonProps) {
+  const isExternal = typeof href === "string" && /^(https?:)?\\/\\//i.test(href);
+  const resolvedTarget = target ?? (isExternal ? "_blank" : undefined);
+  const resolvedRel =
+    rel ?? (resolvedTarget === "_blank" ? "noopener noreferrer" : undefined);
   return href ? (
     <div>
       <StyledLinkButton
         {...props}
         href={href}
+        target={resolvedTarget}
+        rel={resolvedRel}
         $variant={variant}
         $size={size}
         $outline={outline}

package/dist/templates/components/layout/Footer.d.ts

@@ -1 +1 @@
-export declare const footerTemplate = "\"use client\";\nimport { useContext } from \"react\";\nimport styled, { css } from \"styled-components\";\nimport { Space, styledSmall } from \"cherry-styled-components\";\nimport { ChatContext } from \"@/components/Chat\";\nimport { mq, Theme } from \"@/app/theme\";\nimport { GitHubLogo } from \"@/components/layout/Pictograms\";\nimport linksData from \"@/links.json\";\n\ninterface LinkProps {\n  title: string;\n  url: string;\n  icon?: string;\n}\n\nconst links = linksData as LinkProps[];\n\nconst StyledFooter = styled.footer<{\n  theme: Theme;\n  $isChatOpen?: boolean;\n  $hasLinks?: boolean;\n}>`\n  padding: 0 20px;\n  transition: all 0.3s ease;\n\n  ${({ $hasLinks }) =>\n    $hasLinks &&\n    css`\n      margin-top: 20px;\n    `}\n\n  ${mq(\"lg\")} {\n    margin: 0;\n    padding: 0 300px 0 300px;\n\n    ${({ $isChatOpen }) =>\n      $isChatOpen &&\n      css`\n        padding: 0 440px 0 300px;\n      `}\n  }\n`;\n\nconst StyledFooterInner = styled.div<{ theme: Theme }>`\n  border-top: solid 1px ${({ theme }) => theme.colors.grayLight};\n  max-width: 640px;\n  margin: 0 auto;\n  padding: 28px 0;\n  color: ${({ theme }) => theme.colors.grayDark};\n  ${({ theme }) => styledSmall(theme)};\n\n  ${mq(\"lg\")} {\n    padding: 20px 0;\n  }\n\n  & a {\n    font-weight: 700;\n    color: ${({ theme }) => theme.colors.accent};\n    text-decoration: none;\n    transition: all 0.3s ease;\n    display: inline-flex;\n\n    &:hover {\n      color: ${({ theme }) => theme.colors.primaryDark};\n    }\n\n    & svg {\n      width: 18px;\n      height: 18px;\n    }\n  }\n`;\n\nconst StyledFooterFlex = styled.div`\n  display: flex;\n  justify-content: flex-start;\n  align-items: center;\n  gap: 20px;\n\n  ${mq(\"lg\")} {\n    justify-content: space-between;\n  }\n`;\n\nfunction Footer({ hideBranding }: { hideBranding?: boolean }) {\n  const { isOpen } = useContext(ChatContext);\n\n  if (hideBranding) return <Space $xs={80} $lg=\"none\" />;\n\n  return (\n    <StyledFooter $isChatOpen={isOpen} $hasLinks={links.length > 0}>\n      <StyledFooterInner>\n        <StyledFooterFlex>\n          <span>\n            Powered by <a href=\"https://doccupine.com\">Doccupine</a>\n          </span>\n          <a\n            href=\"https://github.com/doccupine/cli\"\n            target=\"_blank\"\n            aria-label=\"Doccupine on GitHub\"\n          >\n            <GitHubLogo />\n          </a>\n        </StyledFooterFlex>\n      </StyledFooterInner>\n    </StyledFooter>\n  );\n}\n\nexport { Footer };\n";
+export declare const footerTemplate = "\"use client\";\nimport { useContext } from \"react\";\nimport styled, { css } from \"styled-components\";\nimport { Space, styledSmall } from \"cherry-styled-components\";\nimport { ChatContext } from \"@/components/Chat\";\nimport { mq, Theme } from \"@/app/theme\";\nimport { GitHubLogo } from \"@/components/layout/Pictograms\";\nimport linksData from \"@/links.json\";\n\ninterface LinkProps {\n  title: string;\n  url: string;\n  icon?: string;\n}\n\nconst links = linksData as LinkProps[];\n\nconst StyledFooter = styled.footer<{\n  theme: Theme;\n  $isChatOpen?: boolean;\n  $hasLinks?: boolean;\n}>`\n  padding: 0 20px;\n  transition: all 0.3s ease;\n\n  ${({ $hasLinks }) =>\n    $hasLinks &&\n    css`\n      margin-top: 20px;\n    `}\n\n  ${mq(\"lg\")} {\n    margin: 0;\n    padding: 0 300px 0 300px;\n\n    ${({ $isChatOpen }) =>\n      $isChatOpen &&\n      css`\n        padding: 0 440px 0 300px;\n      `}\n  }\n`;\n\nconst StyledFooterInner = styled.div<{ theme: Theme }>`\n  border-top: solid 1px ${({ theme }) => theme.colors.grayLight};\n  max-width: 640px;\n  margin: 0 auto;\n  padding: 28px 0;\n  color: ${({ theme }) => theme.colors.grayDark};\n  ${({ theme }) => styledSmall(theme)};\n\n  ${mq(\"lg\")} {\n    padding: 20px 0;\n  }\n\n  & a {\n    font-weight: 700;\n    color: ${({ theme }) => theme.colors.accent};\n    text-decoration: none;\n    transition: all 0.3s ease;\n    display: inline-flex;\n\n    &:hover {\n      color: ${({ theme }) => theme.colors.primary};\n    }\n\n    & svg {\n      width: 18px;\n      height: 18px;\n    }\n  }\n`;\n\nconst StyledFooterFlex = styled.div`\n  display: flex;\n  justify-content: flex-start;\n  align-items: center;\n  gap: 20px;\n\n  ${mq(\"lg\")} {\n    justify-content: space-between;\n  }\n`;\n\nfunction Footer({ hideBranding }: { hideBranding?: boolean }) {\n  const { isOpen } = useContext(ChatContext);\n\n  if (hideBranding) return <Space $xs={80} $lg=\"none\" />;\n\n  return (\n    <StyledFooter $isChatOpen={isOpen} $hasLinks={links.length > 0}>\n      <StyledFooterInner>\n        <StyledFooterFlex>\n          <span>\n            Powered by <a href=\"https://doccupine.com\">Doccupine</a>\n          </span>\n          <a\n            href=\"https://github.com/doccupine/cli\"\n            target=\"_blank\"\n            aria-label=\"Doccupine on GitHub\"\n          >\n            <GitHubLogo />\n          </a>\n        </StyledFooterFlex>\n      </StyledFooterInner>\n    </StyledFooter>\n  );\n}\n\nexport { Footer };\n";

package/dist/templates/components/layout/Footer.js

@@ -62,7 +62,7 @@ const StyledFooterInner = styled.div<{ theme: Theme }>\`
     display: inline-flex;
 
     &:hover {
-      color: \${({ theme }) => theme.colors.primaryDark};
+      color: \${({ theme }) => theme.colors.primary};
     }
 
     & svg {

package/dist/templates/llms/llmsFull.d.ts

@@ -0,0 +1,12 @@
+import type { PageMeta, SectionConfig } from "../../lib/types.js";
+export interface PageWithBody extends PageMeta {
+    body: string;
+}
+export interface LlmsFullArgs {
+    siteName: string;
+    siteDescription?: string;
+    baseUrl: string | null;
+    pages: PageWithBody[];
+    sectionsConfig: SectionConfig[] | null;
+}
+export declare function llmsFullTemplate(args: LlmsFullArgs): string;

package/dist/templates/llms/llmsFull.js

@@ -0,0 +1,59 @@
+function pageUrl(slug, baseUrl) {
+    if (baseUrl) {
+        return slug === "" ? `${baseUrl}/` : `${baseUrl}/${slug}`;
+    }
+    return slug === "" ? "/" : `/${slug}`;
+}
+function orderedPages(pages, sectionsConfig) {
+    const sectionOrderIndex = new Map();
+    sectionOrderIndex.set("", 0);
+    if (sectionsConfig) {
+        sectionsConfig.forEach((section, idx) => {
+            sectionOrderIndex.set(section.slug, idx + 1);
+        });
+    }
+    return [...pages].sort((a, b) => {
+        const sa = sectionOrderIndex.get(a.section) ?? 999;
+        const sb = sectionOrderIndex.get(b.section) ?? 999;
+        if (sa !== sb)
+            return sa - sb;
+        if (a.categoryOrder !== b.categoryOrder)
+            return a.categoryOrder - b.categoryOrder;
+        if (a.category !== b.category)
+            return a.category.localeCompare(b.category);
+        if (a.order !== b.order)
+            return a.order - b.order;
+        return a.title.localeCompare(b.title);
+    });
+}
+export function llmsFullTemplate(args) {
+    const { siteName, siteDescription, baseUrl, pages, sectionsConfig } = args;
+    const lines = [];
+    lines.push(`# ${siteName}`);
+    lines.push("");
+    lines.push(`> Full documentation for ${siteName}.`);
+    if (siteDescription && siteDescription.trim() !== "") {
+        lines.push("");
+        lines.push(siteDescription.trim());
+    }
+    lines.push("");
+    if (pages.length === 0) {
+        return lines.join("\n") + "\n";
+    }
+    const sorted = orderedPages(pages, sectionsConfig);
+    for (const page of sorted) {
+        lines.push("---");
+        lines.push("");
+        lines.push(`# ${page.title}`);
+        lines.push("");
+        if (page.description && page.description.trim() !== "") {
+            lines.push(`> ${page.description.trim()}`);
+            lines.push("");
+        }
+        lines.push(`Source: ${pageUrl(page.slug, baseUrl)}`);
+        lines.push("");
+        lines.push(page.body.trim());
+        lines.push("");
+    }
+    return lines.join("\n").replace(/\n+$/, "\n");
+}

package/dist/templates/llms/llmsIndex.d.ts

@@ -0,0 +1,9 @@
+import type { PageMeta, SectionConfig } from "../../lib/types.js";
+export interface LlmsIndexArgs {
+    siteName: string;
+    siteDescription?: string;
+    baseUrl: string | null;
+    pages: PageMeta[];
+    sectionsConfig: SectionConfig[] | null;
+}
+export declare function llmsIndexTemplate(args: LlmsIndexArgs): string;

package/dist/templates/llms/llmsIndex.js

@@ -0,0 +1,105 @@
+function pageUrl(slug, baseUrl) {
+    if (baseUrl) {
+        return slug === "" ? `${baseUrl}/` : `${baseUrl}/${slug}`;
+    }
+    return slug === "" ? "/" : `/${slug}`;
+}
+function comparePages(a, b) {
+    if (a.order !== b.order)
+        return a.order - b.order;
+    return a.title.localeCompare(b.title);
+}
+function buildSectionGroups(pages, sectionsConfig) {
+    const sectionOrderIndex = new Map();
+    sectionOrderIndex.set("", 0);
+    if (sectionsConfig) {
+        sectionsConfig.forEach((section, idx) => {
+            sectionOrderIndex.set(section.slug, idx + 1);
+        });
+    }
+    const sectionLabelByslug = new Map();
+    if (sectionsConfig) {
+        for (const section of sectionsConfig) {
+            sectionLabelByslug.set(section.slug, section.label);
+        }
+    }
+    const bySection = new Map();
+    for (const page of pages) {
+        const key = page.section || "";
+        const list = bySection.get(key) ?? [];
+        list.push(page);
+        bySection.set(key, list);
+    }
+    const groups = [];
+    for (const [sectionSlug, sectionPages] of bySection) {
+        const byCategory = new Map();
+        for (const page of sectionPages) {
+            const key = page.category || "";
+            const list = byCategory.get(key) ?? [];
+            list.push(page);
+            byCategory.set(key, list);
+        }
+        const categories = [];
+        for (const [category, catPages] of byCategory) {
+            catPages.sort(comparePages);
+            const minCategoryOrder = catPages.reduce((min, p) => Math.min(min, p.categoryOrder), Number.POSITIVE_INFINITY);
+            categories.push({
+                category,
+                minCategoryOrder: Number.isFinite(minCategoryOrder)
+                    ? minCategoryOrder
+                    : 0,
+                pages: catPages,
+            });
+        }
+        categories.sort((a, b) => {
+            if (a.minCategoryOrder !== b.minCategoryOrder) {
+                return a.minCategoryOrder - b.minCategoryOrder;
+            }
+            return a.category.localeCompare(b.category);
+        });
+        groups.push({
+            sectionSlug,
+            sectionLabel: sectionLabelByslug.get(sectionSlug) ??
+                (sectionSlug === "" ? "Documentation" : sectionSlug),
+            sectionOrder: sectionOrderIndex.get(sectionSlug) ?? 999,
+            categories,
+        });
+    }
+    groups.sort((a, b) => a.sectionOrder - b.sectionOrder);
+    return groups;
+}
+export function llmsIndexTemplate(args) {
+    const { siteName, siteDescription, baseUrl, pages, sectionsConfig } = args;
+    const lines = [];
+    lines.push(`# ${siteName}`);
+    lines.push("");
+    if (siteDescription && siteDescription.trim() !== "") {
+        lines.push(`> ${siteDescription.trim()}`);
+        lines.push("");
+    }
+    if (pages.length === 0) {
+        return lines.join("\n") + "\n";
+    }
+    const groups = buildSectionGroups(pages, sectionsConfig);
+    for (const group of groups) {
+        lines.push(`## ${group.sectionLabel}`);
+        lines.push("");
+        const useCategoryHeadings = group.categories.length > 1 ||
+            (group.categories.length === 1 && group.categories[0].category !== "");
+        for (const cat of group.categories) {
+            if (useCategoryHeadings && cat.category !== "") {
+                lines.push(`### ${cat.category}`);
+                lines.push("");
+            }
+            for (const page of cat.pages) {
+                const url = pageUrl(page.slug, baseUrl);
+                const desc = page.description && page.description.trim() !== ""
+                    ? `: ${page.description.trim()}`
+                    : "";
+                lines.push(`- [${page.title}](${url})${desc}`);
+            }
+            lines.push("");
+        }
+    }
+    return lines.join("\n").replace(/\n+$/, "\n");
+}

package/dist/templates/llms/llmsPage.d.ts

@@ -0,0 +1,2 @@
+import type { PageWithBody } from "./llmsFull.js";
+export declare function llmsPageTemplate(page: PageWithBody, baseUrl: string | null): string;

package/dist/templates/llms/llmsPage.js

@@ -0,0 +1,20 @@
+function pageUrl(slug, baseUrl) {
+    if (baseUrl) {
+        return slug === "" ? `${baseUrl}/` : `${baseUrl}/${slug}`;
+    }
+    return slug === "" ? "/" : `/${slug}`;
+}
+export function llmsPageTemplate(page, baseUrl) {
+    const lines = [];
+    lines.push(`# ${page.title}`);
+    lines.push("");
+    if (page.description && page.description.trim() !== "") {
+        lines.push(`> ${page.description.trim()}`);
+        lines.push("");
+    }
+    lines.push(`Source: ${pageUrl(page.slug, baseUrl)}`);
+    lines.push("");
+    lines.push(page.body.trim());
+    lines.push("");
+    return lines.join("\n");
+}

package/dist/templates/mdx/accordion.mdx.d.ts

@@ -1 +1 @@
-export declare const accordionMdxTemplate = "---\ntitle: \"Accordion\"\ndescription: \"Interactive panels for toggling visibility of content.\"\ndate: \"2026-02-19\"\ncategory: \"Components\"\ncategoryOrder: 1\norder: 4\n---\n# Accordion\nInteractive panels for toggling visibility of content.\n\nAccordion elements help organize information by letting users show or hide sections as needed. They\u2019re an effective way to manage progressive disclosure and simplify navigation through dense or optional content.\n\n## Accordion Usage\nYou can use the Accordion component directly within your MDX files without any import. The following example shows a basic usage:\n\n~~~mdx\n<Accordion title=\"What is MDX?\">\n    You can put any content in here, including other components, like code:\n\n   ```java HelloWorld.java\n    class HelloWorld {\n        public static void main(String[] args) {\n            System.out.println(\"Hello, World!\");\n        }\n    }\n  ```\n</Accordion>\n~~~\n\n<Accordion title=\"What is MDX?\">\n    You can put any content in here, including other components, like code:\n\n   ```java HelloWorld.java\n    class HelloWorld {\n        public static void main(String[] args) {\n            System.out.println(\"Hello, World!\");\n        }\n    }\n  ```\n</Accordion>\n\n## Properties\n\n<Field value=\"title\" type=\"string\" required>\n  The title of the accordion.\n</Field>\n\n<Field value=\"children\" type=\"node\" required>\n  The content of the accordion.\n</Field>";
+export declare const accordionMdxTemplate = "---\ntitle: \"Accordion\"\ndescription: \"Interactive panels for toggling visibility of content.\"\ndate: \"2026-02-19\"\ncategory: \"Components\"\ncategoryOrder: 1\norder: 4\n---\n\n# Accordion\n\nInteractive panels for toggling visibility of content.\n\nAccordion elements help organize information by letting users show or hide sections as needed. They\u2019re an effective way to manage progressive disclosure and simplify navigation through dense or optional content.\n\n## Accordion Usage\n\nYou can use the Accordion component directly within your MDX files without any import. The following example shows a basic usage:\n\n````mdx\n<Accordion title=\"What is MDX?\">\n    You can put any content in here, including other components, like code:\n\n```java HelloWorld.java\n class HelloWorld {\n     public static void main(String[] args) {\n         System.out.println(\"Hello, World!\");\n     }\n }\n```\n\n</Accordion>\n````\n\n<Accordion title=\"What is MDX?\">\n    You can put any content in here, including other components, like code:\n\n```java HelloWorld.java\n class HelloWorld {\n     public static void main(String[] args) {\n         System.out.println(\"Hello, World!\");\n     }\n }\n```\n\n</Accordion>\n\n## Properties\n\n<Field value=\"title\" type=\"string\" required>\n  The title of the accordion.\n</Field>\n\n<Field value=\"children\" type=\"node\" required>\n  The content of the accordion.\n</Field>";

package/dist/templates/mdx/accordion.mdx.js

@@ -6,38 +6,43 @@ category: "Components"
 categoryOrder: 1
 order: 4
 ---
+
 # Accordion
+
 Interactive panels for toggling visibility of content.
 
 Accordion elements help organize information by letting users show or hide sections as needed. They’re an effective way to manage progressive disclosure and simplify navigation through dense or optional content.
 
 ## Accordion Usage
+
 You can use the Accordion component directly within your MDX files without any import. The following example shows a basic usage:
 
-~~~mdx
+\`\`\`\`mdx
 <Accordion title="What is MDX?">
     You can put any content in here, including other components, like code:
 
-   \`\`\`java HelloWorld.java
-    class HelloWorld {
-        public static void main(String[] args) {
-            System.out.println("Hello, World!");
-        }
-    }
-  \`\`\`
+\`\`\`java HelloWorld.java
+ class HelloWorld {
+     public static void main(String[] args) {
+         System.out.println("Hello, World!");
+     }
+ }
+\`\`\`
+
 </Accordion>
-~~~
+\`\`\`\`
 
 <Accordion title="What is MDX?">
     You can put any content in here, including other components, like code:
 
-   \`\`\`java HelloWorld.java
-    class HelloWorld {
-        public static void main(String[] args) {
-            System.out.println("Hello, World!");
-        }
-    }
-  \`\`\`
+\`\`\`java HelloWorld.java
+ class HelloWorld {
+     public static void main(String[] args) {
+         System.out.println("Hello, World!");
+     }
+ }
+\`\`\`
+
 </Accordion>
 
 ## Properties

package/dist/templates/mdx/ai-assistant.mdx.d.ts

@@ -1 +1 @@
-export declare const aiAssistantMdxTemplate = "---\ntitle: \"AI Assistant\"\ndescription: \"Integrate AI capabilities into your Doccupine documentation using OpenAI, Anthropic, or Google Gemini.\"\ndate: \"2026-02-19\"\ncategory: \"Configuration\"\ncategoryOrder: 3\norder: 8\n---\n# AI Assistant\nDoccupine supports AI integration to enhance your documentation experience. You can use OpenAI, Anthropic, or Google Gemini to power AI features in your documentation site. The AI assistant uses your documentation content as context, allowing users to ask questions about your docs and receive accurate answers based on the documentation.\n\n## Setup\nTo enable AI features, create an `.env` file in the directory where your website is generated. By default, this is the `nextjs-app/` directory.\n\n## Configuration\nCreate an `.env` file with the following configuration options:\n\n```env\n# LLM Provider Configuration\n# Choose your preferred LLM provider: openai, anthropic, or google\nLLM_PROVIDER=openai\n\n# API Keys (set the one matching your provider)\nOPENAI_API_KEY=your_openai_api_key_here\nANTHROPIC_API_KEY=your_anthropic_api_key_here\nGOOGLE_API_KEY=your_google_api_key_here\n\n# Optional: Override default chat model (see your provider's docs for available models)\n# LLM_CHAT_MODEL=your-model-id\n\n# Optional: Override default embedding model (see your provider's docs for available models)\n# Note: Anthropic doesn't provide embeddings, will fallback to OpenAI\n# LLM_EMBEDDING_MODEL=your-embedding-model-id\n\n# Optional: Set temperature (0-1, default: 0)\n# LLM_TEMPERATURE=0\n```\n\n## Provider Selection\nSet `LLM_PROVIDER` to one of the following values:\n- `openai` - Use OpenAI's models\n- `anthropic` - Use Anthropic's models\n- `google` - Use Google's models\n\n## API Keys\nYou need to set the API key that matches your chosen provider:\n- For OpenAI: Set `OPENAI_API_KEY`\n- For Anthropic: Set `ANTHROPIC_API_KEY`\n- For Google: Set `GOOGLE_API_KEY`\n\n<Callout type=\"warning\">\n  Keep your API keys secure. Never commit your `.env` file to version control.\n</Callout>\n\n<Callout type=\"note\">\n  Doccupine automatically adds `.env` to your `.gitignore` file.\n</Callout>\n\n## Using Anthropic with OpenAI\nIf you want to use Anthropic as your LLM provider, you must also have an OpenAI API key set. Here's why:\n\n### The Situation\nAnthropic (Claude) does not provide an embeddings API. They only offer chat/completion models, not text embeddings.\n\nYour RAG (Retrieval-Augmented Generation) system has two components:\n- **Chat/Completion** - Generates answers, works with Anthropic.\n- **Embeddings** - Creates vector representations of text for search, Anthropic doesn't provide this.\n\nWhen using Anthropic as your `LLM_PROVIDER`, Doccupine will use Anthropic for chat/completion tasks, but will automatically fallback to OpenAI for embeddings. This means you need both API keys configured:\n\n```env\nLLM_PROVIDER=anthropic\nANTHROPIC_API_KEY=your_anthropic_api_key_here\nOPENAI_API_KEY=your_openai_api_key_here\n```\n\nThis hybrid approach allows you to leverage Anthropic's powerful chat models while still having access to embeddings functionality through OpenAI.\n\n## Default models\n\n| Provider | Chat model | Embedding model |\n|---|---|---|\n| OpenAI | `gpt-4.1-nano` | `text-embedding-3-small` |\n| Anthropic | `claude-sonnet-4-5-20250929` | OpenAI fallback |\n| Google | `gemini-2.5-flash-lite` | `gemini-embedding-001` |\n\n## Optional Settings\n\n### Chat Model\nOverride the default chat model by uncommenting and setting `LLM_CHAT_MODEL`. You can use any available model from your chosen provider. For a complete list of available models, refer to the official documentation:\n- [OpenAI Models](https://platform.openai.com/docs/models)\n- [Anthropic Models](https://docs.anthropic.com/claude/docs/models-overview)\n- [Google Gemini Models](https://ai.google.dev/models/gemini)\n\n### Embedding Model\nOverride the default embedding model by uncommenting and setting `LLM_EMBEDDING_MODEL`. For a complete list of available embedding models, refer to the official documentation:\n- [OpenAI Embeddings](https://platform.openai.com/docs/guides/embeddings)\n- [Google Gemini Embeddings](https://ai.google.dev/gemini-api/docs/embeddings)\n- **Anthropic**: Anthropic doesn't provide embeddings. If you use Anthropic as your provider, Doccupine will fallback to OpenAI for embeddings.\n\n### Temperature\nControl the randomness of AI responses by setting `LLM_TEMPERATURE` to a value between 0 and 1:\n- `0` - More deterministic and focused responses (default)\n- `1` - More creative and varied responses";
+export declare const aiAssistantMdxTemplate = "---\ntitle: \"AI Assistant\"\ndescription: \"Integrate AI capabilities into your Doccupine documentation using OpenAI, Anthropic, or Google Gemini.\"\ndate: \"2026-02-19\"\ncategory: \"Configuration\"\ncategoryOrder: 3\norder: 8\n---\n\n# AI Assistant\n\nDoccupine supports AI integration to enhance your documentation experience. You can use OpenAI, Anthropic, or Google Gemini to power AI features in your documentation site. The AI assistant uses your documentation content as context, allowing users to ask questions about your docs and receive accurate answers based on the documentation.\n\n## Setup\n\nTo enable AI features, create an `.env` file in the directory where your website is generated. By default, this is the `nextjs-app/` directory.\n\n## Configuration\n\nCreate an `.env` file with the following configuration options:\n\n```env\n# LLM Provider Configuration\n# Choose your preferred LLM provider: openai, anthropic, or google\nLLM_PROVIDER=openai\n\n# API Keys (set the one matching your provider)\nOPENAI_API_KEY=your_openai_api_key_here\nANTHROPIC_API_KEY=your_anthropic_api_key_here\nGOOGLE_API_KEY=your_google_api_key_here\n\n# Optional: Override default chat model (see your provider's docs for available models)\n# LLM_CHAT_MODEL=your-model-id\n\n# Optional: Override default embedding model (see your provider's docs for available models)\n# Note: Anthropic doesn't provide embeddings, will fallback to OpenAI\n# LLM_EMBEDDING_MODEL=your-embedding-model-id\n\n# Optional: Set temperature (0-1, default: 0)\n# LLM_TEMPERATURE=0\n```\n\n## Provider Selection\n\nSet `LLM_PROVIDER` to one of the following values:\n\n- `openai` - Use OpenAI's models\n- `anthropic` - Use Anthropic's models\n- `google` - Use Google's models\n\n## API Keys\n\nYou need to set the API key that matches your chosen provider:\n\n- For OpenAI: Set `OPENAI_API_KEY`\n- For Anthropic: Set `ANTHROPIC_API_KEY`\n- For Google: Set `GOOGLE_API_KEY`\n\n<Callout type=\"warning\">\n  Keep your API keys secure. Never commit your `.env` file to version control.\n</Callout>\n\n<Callout type=\"note\">\n  Doccupine automatically adds `.env` to your `.gitignore` file.\n</Callout>\n\n## Using Anthropic with OpenAI\n\nIf you want to use Anthropic as your LLM provider, you must also have an OpenAI API key set. Here's why:\n\n### The Situation\n\nAnthropic (Claude) does not provide an embeddings API. They only offer chat/completion models, not text embeddings.\n\nYour RAG (Retrieval-Augmented Generation) system has two components:\n\n- **Chat/Completion** - Generates answers, works with Anthropic.\n- **Embeddings** - Creates vector representations of text for search, Anthropic doesn't provide this.\n\nWhen using Anthropic as your `LLM_PROVIDER`, Doccupine will use Anthropic for chat/completion tasks, but will automatically fallback to OpenAI for embeddings. This means you need both API keys configured:\n\n```env\nLLM_PROVIDER=anthropic\nANTHROPIC_API_KEY=your_anthropic_api_key_here\nOPENAI_API_KEY=your_openai_api_key_here\n```\n\nThis hybrid approach allows you to leverage Anthropic's powerful chat models while still having access to embeddings functionality through OpenAI.\n\n## Default models\n\n| Provider  | Chat model                   | Embedding model          |\n| --------- | ---------------------------- | ------------------------ |\n| OpenAI    | `gpt-4.1-nano`               | `text-embedding-3-small` |\n| Anthropic | `claude-sonnet-4-5-20250929` | OpenAI fallback          |\n| Google    | `gemini-2.5-flash-lite`      | `gemini-embedding-001`   |\n\n## Optional Settings\n\n### Chat Model\n\nOverride the default chat model by uncommenting and setting `LLM_CHAT_MODEL`. You can use any available model from your chosen provider. For a complete list of available models, refer to the official documentation:\n\n- [OpenAI Models](https://platform.openai.com/docs/models)\n- [Anthropic Models](https://docs.anthropic.com/claude/docs/models-overview)\n- [Google Gemini Models](https://ai.google.dev/models/gemini)\n\n### Embedding Model\n\nOverride the default embedding model by uncommenting and setting `LLM_EMBEDDING_MODEL`. For a complete list of available embedding models, refer to the official documentation:\n\n- [OpenAI Embeddings](https://platform.openai.com/docs/guides/embeddings)\n- [Google Gemini Embeddings](https://ai.google.dev/gemini-api/docs/embeddings)\n- **Anthropic**: Anthropic doesn't provide embeddings. If you use Anthropic as your provider, Doccupine will fallback to OpenAI for embeddings.\n\n### Temperature\n\nControl the randomness of AI responses by setting `LLM_TEMPERATURE` to a value between 0 and 1:\n\n- `0` - More deterministic and focused responses (default)\n- `1` - More creative and varied responses";