boltdocs 1.10.2 → 1.11.0

package/src/node/ssg/sitemap.ts

@@ -1,5 +1,5 @@
-import { BoltdocsConfig } from "../config";
-import { escapeXml } from "../utils";
+import type { BoltdocsConfig } from '../config'
+import { escapeXml } from '../utils'
 
 /**
  * Generates a standard XML sitemap for search engine crawlers.
@@ -12,20 +12,20 @@ export function generateSitemap(
   routePaths: string[],
   config?: BoltdocsConfig,
 ): string {
-  const baseUrl = config?.siteUrl?.replace(/\/$/, "") || "https://example.com";
-  const today = new Date().toISOString().split("T")[0];
+  const baseUrl = config?.siteUrl?.replace(/\/$/, '') || 'https://example.com'
+  const today = new Date().toISOString().split('T')[0]
 
-  const rootEntries = [{ url: "/", priority: "1.0", changefreq: "daily" }];
+  const rootEntries = [{ url: '/', priority: '1.0', changefreq: 'daily' }]
 
   if (config?.i18n) {
-    const defaultLocale = config.i18n.defaultLocale;
+    const defaultLocale = config.i18n.defaultLocale
     for (const locale of Object.keys(config.i18n.locales)) {
       if (locale !== defaultLocale) {
         rootEntries.push({
           url: `/${locale}/`,
-          priority: "1.0",
-          changefreq: "daily",
-        });
+          priority: '1.0',
+          changefreq: 'daily',
+        })
       }
     }
   }
@@ -34,10 +34,10 @@ export function generateSitemap(
     ...rootEntries,
     ...routePaths.map((p) => ({
       url: p,
-      priority: "0.8",
-      changefreq: "weekly",
+      priority: '0.8',
+      changefreq: 'weekly',
     })),
-  ];
+  ]
 
   return `<?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
@@ -50,6 +50,6 @@ ${entries
     <priority>${e.priority}</priority>
   </url>`,
   )
-  .join("\n")}
-</urlset>`;
+  .join('\n')}
+</urlset>`
 }

package/src/node/utils.ts

@@ -1,5 +1,5 @@
-import fs from "fs";
-import matter from "gray-matter";
+import fs from 'fs'
+import matter from 'gray-matter'
 
 /**
  * Normalizes a file path by replacing Windows backslashes with forward slashes.
@@ -9,7 +9,7 @@ import matter from "gray-matter";
  * @returns The normalized path using forward slashes
  */
 export function normalizePath(p: string): string {
-  return p.replace(/\\/g, "/");
+  return p.replace(/\\/g, '/')
 }
 
 /**
@@ -19,7 +19,7 @@ export function normalizePath(p: string): string {
  * @returns The name without the numeric prefix
  */
 export function stripNumberPrefix(name: string): string {
-  return name.replace(/^\d+\./, "");
+  return name.replace(/^\d+\./, '')
 }
 
 /**
@@ -29,8 +29,8 @@ export function stripNumberPrefix(name: string): string {
  * @returns The extracted number, or undefined if none exists
  */
 export function extractNumberPrefix(name: string): number | undefined {
-  const match = name.match(/^(\d+)\./);
-  return match ? parseInt(match[1], 10) : undefined;
+  const match = name.match(/^(\d+)\./)
+  return match ? parseInt(match[1], 10) : undefined
 }
 
 /**
@@ -40,7 +40,7 @@ export function extractNumberPrefix(name: string): number | undefined {
  * @returns True if the file ends with .md or .mdx, false otherwise
  */
 export function isDocFile(filePath: string): boolean {
-  return /\.mdx?$/.test(filePath);
+  return /\.mdx?$/.test(filePath)
 }
 
 /**
@@ -53,9 +53,9 @@ export function isDocFile(filePath: string): boolean {
  */
 export function getFileMtime(filePath: string): number {
   try {
-    return fs.statSync(filePath).mtimeMs;
+    return fs.statSync(filePath).mtimeMs
   } catch {
-    return 0;
+    return 0
   }
 }
 
@@ -67,12 +67,12 @@ export function getFileMtime(filePath: string): number {
  * @returns An object containing the parsed metadata (`data`) and the raw markdown (`content`)
  */
 export function parseFrontmatter(filePath: string): {
-  data: Record<string, any>;
-  content: string;
+  data: Record<string, any>
+  content: string
 } {
-  const raw = fs.readFileSync(filePath, "utf-8");
-  const { data, content } = matter(raw);
-  return { data, content };
+  const raw = fs.readFileSync(filePath, 'utf-8')
+  const { data, content } = matter(raw)
+  return { data, content }
 }
 
 /**
@@ -84,11 +84,11 @@ export function parseFrontmatter(filePath: string): {
  */
 export function escapeHtml(str: string): string {
   return str
-    .replace(/&/g, "&amp;")
-    .replace(/"/g, "&quot;")
-    .replace(/'/g, "&apos;")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;");
+    .replace(/&/g, '&amp;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&apos;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
 }
 
 /**
@@ -98,7 +98,7 @@ export function escapeHtml(str: string): string {
  * @returns The escaped string
  */
 export function escapeXml(str: string): string {
-  return escapeHtml(str);
+  return escapeHtml(str)
 }
 
 /**
@@ -111,29 +111,29 @@ export function escapeXml(str: string): string {
  */
 export function fileToRoutePath(relativePath: string): string {
   // Strip number prefixes from every segment
-  let cleanedPath = relativePath.split("/").map(stripNumberPrefix).join("/");
+  let cleanedPath = relativePath.split('/').map(stripNumberPrefix).join('/')
 
   // Remove trailing slash if present
-  let routePath = cleanedPath.replace(/\/$/, "");
+  let routePath = cleanedPath.replace(/\/$/, '')
 
-  routePath = routePath.replace(/\.mdx?$/, "");
+  routePath = routePath.replace(/\.mdx?$/, '')
 
   // Handle index files → directory root
-  if (routePath === "index" || routePath.endsWith("/index")) {
-    routePath = routePath.replace(/index$/, "");
+  if (routePath === 'index' || routePath.endsWith('/index')) {
+    routePath = routePath.replace(/index$/, '')
   }
 
   // Ensure leading slash
-  if (!routePath.startsWith("/")) {
-    routePath = "/" + routePath;
+  if (!routePath.startsWith('/')) {
+    routePath = '/' + routePath
   }
 
   // Remove trailing slash (except for root '/')
-  if (routePath.length > 1 && routePath.endsWith("/")) {
-    routePath = routePath.slice(0, -1);
+  if (routePath.length > 1 && routePath.endsWith('/')) {
+    routePath = routePath.slice(0, -1)
   }
 
-  return routePath;
+  return routePath
 }
 
 /**
@@ -144,5 +144,5 @@ export function fileToRoutePath(relativePath: string): string {
  * @returns The capitalized string
  */
 export function capitalize(str: string): string {
-  return str.charAt(0).toUpperCase() + str.slice(1);
+  return str.charAt(0).toUpperCase() + str.slice(1)
 }

package/tsconfig.json

@@ -1,21 +1,26 @@
 {
-    "compilerOptions": {
-        "target": "ES2022",
-        "module": "ESNext",
-        "moduleResolution": "Bundler",
-        "esModuleInterop": true,
-        "strict": true,
-        "skipLibCheck": true,
-        "jsx": "react-jsx",
-        "declaration": true,
-        "outDir": "dist"
-    },
-    "include": [
-        "src"
-    ],
-    "exclude": [
-        "node_modules",
-        "dist",
-        "src/node/cli"
-    ]
-}
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "jsx": "react-jsx",
+    "declaration": true,
+    "outDir": "dist",
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"],
+      "@client/*": ["src/client/*"],
+      "@node/*": ["src/node/*"],
+      "@theme/*": ["src/client/theme/*"],
+      "@components/*": ["src/client/components/*"],
+      "@integrations/*": ["src/client/integrations/*"],
+      "@hooks/*": ["src/client/hooks/*"],
+      "@primitives/*": ["src/client/components/primitives/*"]
+    }
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist", "src/node/cli"]
+}

package/tsup.config.ts

@@ -1,22 +1,31 @@
-import { defineConfig } from "tsup";
+import { defineConfig } from 'tsup'
 
 export default defineConfig({
   entry: [
-    "src/node/index.ts",
-    "src/node/cli/index.ts",
-    "src/client/index.ts",
-    "src/client/ssr.tsx",
+    'src/node/index.ts',
+    'src/client/index.ts',
+    'src/client/ssr.tsx',
+    'src/client/hooks/index.ts',
+    'src/client/components/mdx/index.ts',
   ],
-  format: ["cjs", "esm"],
+  format: ['cjs', 'esm'],
   dts: true,
-  tsconfig: "./tsconfig.json",
+  tsconfig: './tsconfig.json',
   clean: true,
+  minify: true,
+  minifySyntax: true,
+  minifyWhitespace: true,
+  minifyIdentifiers: true,
+  shims: true,
   external: [
-    "vite",
-    "react",
-    "react-dom",
-    "react-router-dom",
-    "virtual:boltdocs-routes",
-    "virtual:boltdocs-config",
+    'vite',
+    'react',
+    'react-dom',
+    'react-router-dom',
+    'virtual:boltdocs-routes',
+    'virtual:boltdocs-config',
+    'virtual:boltdocs-layout',
+    'virtual:boltdocs-mdx-components',
+    'virtual:boltdocs-entry',
   ],
-});
+})

package/dist/PackageManagerTabs-NVT7G625.mjs

@@ -1,99 +0,0 @@
-import {
-  Bun,
-  Deno,
-  NPM,
-  Pnpm
-} from "./chunk-7SFUJWTB.mjs";
-import {
-  copyToClipboard
-} from "./chunk-FMTOYQLO.mjs";
-
-// src/client/theme/components/PackageManagerTabs/PackageManagerTabs.tsx
-import { useState, useCallback } from "react";
-import { Copy, Check } from "lucide-react";
-import { jsx, jsxs } from "react/jsx-runtime";
-var MANAGERS = [
-  { id: "npm", label: "npm", icon: NPM },
-  { id: "pnpm", label: "pnpm", icon: Pnpm },
-  { id: "bun", label: "bun", icon: Bun },
-  { id: "deno", label: "deno", icon: Deno }
-];
-function getCommandForManager(manager, command, pkg) {
-  const isInstall = command === "install" || command === "add" || command === "i";
-  const isCreate = command === "create" || command === "init";
-  const isRun = command === "run" || command === "exec";
-  if (isInstall) {
-    const pkgArgs2 = pkg ? ` ${pkg}` : "";
-    if (manager === "npm") return `npm install${pkgArgs2}`;
-    if (manager === "pnpm") return pkg ? `pnpm add${pkgArgs2}` : `pnpm install`;
-    if (manager === "bun") return pkg ? `bun add${pkgArgs2}` : `bun install`;
-    if (manager === "deno")
-      return pkg ? `deno install npm:${pkg}` : `deno install`;
-  }
-  if (isCreate) {
-    const pkgArgs2 = pkg ? ` ${pkg}` : "";
-    if (manager === "npm") return `npm create${pkgArgs2}`;
-    if (manager === "pnpm") return `pnpm create${pkgArgs2}`;
-    if (manager === "bun") return `bun create${pkgArgs2}`;
-    if (manager === "deno") return `deno run -A npm:create-${pkg}`;
-  }
-  if (isRun) {
-    const pkgArgs2 = pkg ? ` ${pkg}` : "";
-    if (manager === "npm") return `npm run${pkgArgs2}`;
-    if (manager === "pnpm") return `pnpm run${pkgArgs2}`;
-    if (manager === "bun") return `bun run${pkgArgs2}`;
-    if (manager === "deno") return `deno task ${pkg}`;
-  }
-  const pkgArgs = pkg ? ` ${pkg}` : "";
-  return `${manager} ${command}${pkgArgs}`;
-}
-function PackageManagerTabs({
-  command,
-  pkg = "",
-  className = ""
-}) {
-  const [activeTab, setActiveTab] = useState("npm");
-  const [copied, setCopied] = useState(false);
-  const activeCommand = getCommandForManager(activeTab, command, pkg);
-  const handleCopy = useCallback(async () => {
-    copyToClipboard(activeCommand);
-    setCopied(true);
-    setTimeout(() => setCopied(false), 2e3);
-  }, [activeCommand]);
-  return /* @__PURE__ */ jsxs("div", { className: `pkg-tabs-wrapper ${className}`, children: [
-    /* @__PURE__ */ jsx("div", { className: "pkg-tabs-header", children: MANAGERS.map((mgr) => {
-      const Icon = mgr.icon;
-      const isActive = activeTab === mgr.id;
-      return /* @__PURE__ */ jsxs(
-        "button",
-        {
-          className: `pkg-tab-btn ${isActive ? "active" : ""}`,
-          onClick: () => setActiveTab(mgr.id),
-          "aria-selected": isActive,
-          role: "tab",
-          children: [
-            /* @__PURE__ */ jsx(Icon, { className: "pkg-tab-icon", width: "16", height: "16" }),
-            /* @__PURE__ */ jsx("span", { children: mgr.label })
-          ]
-        },
-        mgr.id
-      );
-    }) }),
-    /* @__PURE__ */ jsxs("div", { className: "code-block-wrapper pkg-tabs-content", children: [
-      /* @__PURE__ */ jsx(
-        "button",
-        {
-          className: `code-block-copy ${copied ? "copied" : ""}`,
-          onClick: handleCopy,
-          type: "button",
-          "aria-label": "Copy code",
-          children: copied ? /* @__PURE__ */ jsx(Check, { size: 14 }) : /* @__PURE__ */ jsx(Copy, { size: 14 })
-        }
-      ),
-      /* @__PURE__ */ jsx("pre", { children: /* @__PURE__ */ jsx("code", { children: /* @__PURE__ */ jsx("span", { className: "line", children: activeCommand }) }) })
-    ] })
-  ] });
-}
-export {
-  PackageManagerTabs
-};

package/dist/SearchDialog-AGVF6JBO.mjs

@@ -1,194 +0,0 @@
-import {
-  Link
-} from "./chunk-TKLQWU7H.mjs";
-import "./chunk-FMTOYQLO.mjs";
-
-// src/client/theme/ui/SearchDialog/SearchDialog.tsx
-import React, { useState, useEffect, useRef } from "react";
-import { createPortal } from "react-dom";
-import { Search } from "lucide-react";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-function SearchDialog({ routes }) {
-  const [isOpen, setIsOpen] = useState(false);
-  const [query, setQuery] = useState("");
-  const inputRef = useRef(null);
-  useEffect(() => {
-    const handleKeyDown = (e) => {
-      if ((e.metaKey || e.ctrlKey) && e.key === "k") {
-        e.preventDefault();
-        setIsOpen((prev) => !prev);
-      }
-      if (e.key === "Escape" && isOpen) {
-        setIsOpen(false);
-      }
-    };
-    window.addEventListener("keydown", handleKeyDown);
-    return () => window.removeEventListener("keydown", handleKeyDown);
-  }, [isOpen]);
-  useEffect(() => {
-    if (isOpen) {
-      setTimeout(() => inputRef.current?.focus(), 50);
-    } else {
-      setQuery("");
-    }
-  }, [isOpen]);
-  const searchResults = React.useMemo(() => {
-    if (!query) {
-      return routes.slice(0, 10).map((r) => ({
-        title: r.title,
-        path: r.path,
-        groupTitle: r.groupTitle
-      }));
-    }
-    const results = [];
-    const lowerQuery = query.toLowerCase();
-    for (const route of routes) {
-      if (route.title && route.title.toLowerCase().includes(lowerQuery)) {
-        results.push({
-          title: route.title,
-          path: route.path,
-          groupTitle: route.groupTitle
-        });
-      }
-      if (route.headings) {
-        for (const heading of route.headings) {
-          if (heading.text.toLowerCase().includes(lowerQuery)) {
-            results.push({
-              title: heading.text,
-              path: `${route.path}#${heading.id}`,
-              groupTitle: route.title,
-              isHeading: true
-            });
-          }
-        }
-      }
-      if (route._content && route._content.toLowerCase().includes(lowerQuery)) {
-        results.push({
-          title: route.title,
-          path: route.path,
-          groupTitle: route.groupTitle
-        });
-      }
-    }
-    const uniqueResults = [];
-    const seenPaths = /* @__PURE__ */ new Set();
-    for (const res of results) {
-      if (!seenPaths.has(res.path)) {
-        seenPaths.add(res.path);
-        uniqueResults.push(res);
-      }
-    }
-    return uniqueResults.slice(0, 10);
-  }, [routes, query]);
-  return /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsxs(
-      "div",
-      {
-        className: "navbar-search",
-        role: "button",
-        tabIndex: 0,
-        onClick: () => setIsOpen(true),
-        onKeyDown: (e) => {
-          if (e.key === "Enter" || e.key === " ") {
-            e.preventDefault();
-            setIsOpen(true);
-          }
-        },
-        "aria-label": "Open search dialog",
-        children: [
-          /* @__PURE__ */ jsx(Search, { className: "boltdocs-search-icon", size: 18 }),
-          "Search docs...",
-          /* @__PURE__ */ jsx("kbd", { children: "\u2318K" })
-        ]
-      }
-    ),
-    isOpen && createPortal(
-      /* @__PURE__ */ jsx(
-        "div",
-        {
-          className: "boltdocs-search-overlay",
-          onPointerDown: () => setIsOpen(false),
-          children: /* @__PURE__ */ jsxs(
-            "div",
-            {
-              className: "boltdocs-search-modal",
-              role: "dialog",
-              "aria-modal": "true",
-              "aria-label": "Search",
-              onPointerDown: (e) => e.stopPropagation(),
-              children: [
-                /* @__PURE__ */ jsxs("div", { className: "boltdocs-search-header", children: [
-                  /* @__PURE__ */ jsx(Search, { size: 18 }),
-                  /* @__PURE__ */ jsx(
-                    "input",
-                    {
-                      ref: inputRef,
-                      type: "text",
-                      "aria-label": "Search documentation input",
-                      placeholder: "Search documentation...",
-                      value: query,
-                      onChange: (e) => setQuery(e.target.value)
-                    }
-                  ),
-                  /* @__PURE__ */ jsx(
-                    "button",
-                    {
-                      className: "boltdocs-search-close",
-                      onClick: () => setIsOpen(false),
-                      "aria-label": "Close search",
-                      children: "ESC"
-                    }
-                  )
-                ] }),
-                /* @__PURE__ */ jsx("div", { className: "boltdocs-search-results", children: searchResults.length > 0 ? searchResults.map((result) => /* @__PURE__ */ jsxs(
-                  Link,
-                  {
-                    to: result.path === "" ? "/" : result.path,
-                    className: `boltdocs-search-result-item ${result.isHeading ? "is-heading" : ""}`,
-                    onClick: (e) => {
-                      const isSamePath = result.path.split("#")[0] === window.location.pathname;
-                      if (isSamePath && result.isHeading) {
-                        e.preventDefault();
-                        const id = result.path.split("#")[1];
-                        const el = document.getElementById(id);
-                        if (el) {
-                          const offset = 80;
-                          const bodyRect = document.body.getBoundingClientRect().top;
-                          const elementRect = el.getBoundingClientRect().top;
-                          const elementPosition = elementRect - bodyRect;
-                          const offsetPosition = elementPosition - offset;
-                          window.scrollTo({
-                            top: offsetPosition,
-                            behavior: "smooth"
-                          });
-                          window.history.pushState(null, "", `#${id}`);
-                        }
-                      }
-                      setIsOpen(false);
-                    },
-                    children: [
-                      /* @__PURE__ */ jsxs("span", { className: "boltdocs-search-result-title", children: [
-                        result.isHeading ? /* @__PURE__ */ jsx("span", { className: "heading-indicator", children: "#" }) : null,
-                        result.title
-                      ] }),
-                      result.groupTitle && /* @__PURE__ */ jsx("span", { className: "boltdocs-search-result-group", children: result.groupTitle })
-                    ]
-                  },
-                  result.path
-                )) : /* @__PURE__ */ jsxs("div", { className: "boltdocs-search-empty", children: [
-                  'No results found for "',
-                  query,
-                  '"'
-                ] }) })
-              ]
-            }
-          )
-        }
-      ),
-      document.body
-    )
-  ] });
-}
-export {
-  SearchDialog
-};