boltdocs 1.0.4 → 1.3.1

package/src/client/app/preload.tsx

@@ -1,56 +1,56 @@
-import React, { createContext, useContext, useCallback } from "react";
-import { ComponentRoute } from "../types";
-
-interface PreloadContextType {
-  preload: (path: string) => void;
-}
-
-const PreloadContext = createContext<PreloadContextType>({
-  preload: () => {},
-});
-
-export function usePreload() {
-  return useContext(PreloadContext);
-}
-
-export function PreloadProvider({
-  routes,
-  modules,
-  children,
-}: {
-  routes: ComponentRoute[];
-  modules: Record<string, () => Promise<any>>;
-  children: React.ReactNode;
-}) {
-  const preload = useCallback(
-    (path: string) => {
-      // Normalize path (remove hash and search)
-      const cleanPath = path.split("#")[0].split("?")[0];
-
-      // Support index routes matching "/"
-      const route = routes.find(
-        (r) => r.path === cleanPath || (cleanPath === "/" && r.path === ""),
-      );
-
-      if (route && route.filePath) {
-        const loaderKey = Object.keys(modules).find((k) =>
-          k.endsWith("/" + route.filePath),
-        );
-
-        if (loaderKey) {
-          // Trigger the dynamic import
-          modules[loaderKey]().catch((err: any) => {
-            console.error(`[boltdocs] Failed to preload route ${path}:`, err);
-          });
-        }
-      }
-    },
-    [routes, modules],
-  );
-
-  return (
-    <PreloadContext.Provider value={{ preload }}>
-      {children}
-    </PreloadContext.Provider>
-  );
-}
+import React, { createContext, useContext, useCallback } from "react";
+import { ComponentRoute } from "../types";
+
+interface PreloadContextType {
+  preload: (path: string) => void;
+}
+
+const PreloadContext = createContext<PreloadContextType>({
+  preload: () => {},
+});
+
+export function usePreload() {
+  return useContext(PreloadContext);
+}
+
+export function PreloadProvider({
+  routes,
+  modules,
+  children,
+}: {
+  routes: ComponentRoute[];
+  modules: Record<string, () => Promise<any>>;
+  children: React.ReactNode;
+}) {
+  const preload = useCallback(
+    (path: string) => {
+      // Normalize path (remove hash and search)
+      const cleanPath = path.split("#")[0].split("?")[0];
+
+      // Support index routes matching "/"
+      const route = routes.find(
+        (r) => r.path === cleanPath || (cleanPath === "/" && r.path === ""),
+      );
+
+      if (route && route.filePath) {
+        const loaderKey = Object.keys(modules).find((k) =>
+          k.endsWith("/" + route.filePath),
+        );
+
+        if (loaderKey) {
+          // Trigger the dynamic import
+          modules[loaderKey]().catch((err: any) => {
+            console.error(`[boltdocs] Failed to preload route ${path}:`, err);
+          });
+        }
+      }
+    },
+    [routes, modules],
+  );
+
+  return (
+    <PreloadContext.Provider value={{ preload }}>
+      {children}
+    </PreloadContext.Provider>
+  );
+}

package/src/client/index.ts

@@ -1,40 +1,40 @@
-export type { BoltdocsConfig, BoltdocsThemeConfig } from "../node/config";
-export type { ComponentRoute, CreateBoltdocsAppOptions } from "./types";
-export { createBoltdocsApp } from "./app";
-export { ThemeLayout } from "./theme/ui/Layout";
-export { Navbar } from "./theme/ui/Navbar";
-export { Sidebar } from "./theme/ui/Sidebar";
-export { OnThisPage } from "./theme/ui/OnThisPage";
-export { Head } from "./theme/ui/Head";
-export { Breadcrumbs } from "./theme/ui/Breadcrumbs";
-export { BackgroundGradient } from "./theme/ui/BackgroundGradient";
-export { Playground } from "./theme/components/Playground";
-export { NotFound } from "./theme/ui/NotFound";
-export { Loading } from "./theme/ui/Loading";
-export { CodeBlock } from "./theme/components/CodeBlock";
-export { Video } from "./theme/components/Video";
-export {
-  Button,
-  Badge,
-  Card,
-  Cards,
-  Tabs,
-  Tab,
-  Admonition,
-  Note,
-  Tip,
-  Warning,
-  Danger,
-  InfoBox,
-  List,
-} from "./theme/components/mdx";
-export type {
-  ButtonProps,
-  BadgeProps,
-  CardProps,
-  CardsProps,
-  TabsProps,
-  TabProps,
-  AdmonitionProps,
-  ListProps,
-} from "./theme/components/mdx";
+export type { BoltdocsConfig, BoltdocsThemeConfig } from "../node/config";
+export type { ComponentRoute, CreateBoltdocsAppOptions } from "./types";
+export { createBoltdocsApp } from "./app";
+export { ThemeLayout } from "./theme/ui/Layout";
+export { Navbar } from "./theme/ui/Navbar";
+export { Sidebar } from "./theme/ui/Sidebar";
+export { OnThisPage } from "./theme/ui/OnThisPage";
+export { Head } from "./theme/ui/Head";
+export { Breadcrumbs } from "./theme/ui/Breadcrumbs";
+export { BackgroundGradient } from "./theme/ui/BackgroundGradient";
+export { Playground } from "./theme/components/Playground";
+export { NotFound } from "./theme/ui/NotFound";
+export { Loading } from "./theme/ui/Loading";
+export { CodeBlock } from "./theme/components/CodeBlock";
+export { Video } from "./theme/components/Video";
+export {
+  Button,
+  Badge,
+  Card,
+  Cards,
+  Tabs,
+  Tab,
+  Admonition,
+  Note,
+  Tip,
+  Warning,
+  Danger,
+  InfoBox,
+  List,
+} from "./theme/components/mdx";
+export type {
+  ButtonProps,
+  BadgeProps,
+  CardProps,
+  CardsProps,
+  TabsProps,
+  TabProps,
+  AdmonitionProps,
+  ListProps,
+} from "./theme/components/mdx";

package/src/client/ssr.tsx

@@ -1,51 +1,51 @@
-import React from "react";
-import ReactDOMServer from "react-dom/server";
-import { StaticRouter } from "react-router-dom/server";
-import { AppShell } from "./app";
-import { ComponentRoute } from "./types";
-
-/**
- * Options for rendering the Boltdocs application on the server (SSG).
- */
-export interface RenderOptions {
-  /** The URL path currently being rendered */
-  path: string;
-  /** Initial routes generated by the Vite plugin (`virtual:boltdocs-routes`) */
-  routes: ComponentRoute[];
-  /** Site configuration (`virtual:boltdocs-config`) */
-  config: any;
-  /** Optional custom React component to render when visiting the root path ('/') */
-  homePage?: React.ComponentType;
-  /** Preloaded modules (since SSR cannot use dynamic imports easily) */
-  modules: Record<string, any>;
-}
-
-/**
- * Renders the full React application into an HTML string for a specific route.
- * This is called by the Node SSG script during the Vite build process.
- */
-export async function render(options: RenderOptions): Promise<string> {
-  const { path, routes, config, modules, homePage } = options;
-
-  // For SSR, we must resolve modules synchronously. We create a mock 'loader'
-  // that instantly returns the module since the SSG script already loaded it.
-  const resolvedModules: Record<string, () => Promise<any>> = {};
-  for (const [key, mod] of Object.entries(modules)) {
-    resolvedModules[key] = () => Promise.resolve(mod);
-  }
-
-  const html = ReactDOMServer.renderToString(
-    <React.StrictMode>
-      <StaticRouter location={path}>
-        <AppShell
-          initialRoutes={routes}
-          initialConfig={config}
-          modules={resolvedModules}
-          homePage={homePage}
-        />
-      </StaticRouter>
-    </React.StrictMode>,
-  );
-
-  return html;
-}
+import React from "react";
+import ReactDOMServer from "react-dom/server";
+import { StaticRouter } from "react-router-dom/server";
+import { AppShell } from "./app";
+import { ComponentRoute } from "./types";
+
+/**
+ * Options for rendering the Boltdocs application on the server (SSG).
+ */
+export interface RenderOptions {
+  /** The URL path currently being rendered */
+  path: string;
+  /** Initial routes generated by the Vite plugin (`virtual:boltdocs-routes`) */
+  routes: ComponentRoute[];
+  /** Site configuration (`virtual:boltdocs-config`) */
+  config: any;
+  /** Optional custom React component to render when visiting the root path ('/') */
+  homePage?: React.ComponentType;
+  /** Preloaded modules (since SSR cannot use dynamic imports easily) */
+  modules: Record<string, any>;
+}
+
+/**
+ * Renders the full React application into an HTML string for a specific route.
+ * This is called by the Node SSG script during the Vite build process.
+ */
+export async function render(options: RenderOptions): Promise<string> {
+  const { path, routes, config, modules, homePage } = options;
+
+  // For SSR, we must resolve modules synchronously. We create a mock 'loader'
+  // that instantly returns the module since the SSG script already loaded it.
+  const resolvedModules: Record<string, () => Promise<any>> = {};
+  for (const [key, mod] of Object.entries(modules)) {
+    resolvedModules[key] = () => Promise.resolve(mod);
+  }
+
+  const html = ReactDOMServer.renderToString(
+    <React.StrictMode>
+      <StaticRouter location={path}>
+        <AppShell
+          initialRoutes={routes}
+          initialConfig={config}
+          modules={resolvedModules}
+          homePage={homePage}
+        />
+      </StaticRouter>
+    </React.StrictMode>,
+  );
+
+  return html;
+}

package/src/client/theme/components/CodeBlock/CodeBlock.tsx

@@ -1,76 +1,76 @@
-import React, { useState, useRef, useCallback } from "react";
-import { Copy, Check } from "lucide-react";
-
-interface CodeBlockProps {
-  children?: React.ReactNode;
-  className?: string;
-  [key: string]: any;
-}
-
-/**
- * A specialized wrapper for code snippets compiled from MDX blocks.
- * Provides syntax highlighting styling scaffolding and a "Copy to Clipboard" button.
- */
-export function CodeBlock({ children, ...props }: CodeBlockProps) {
-  const [copied, setCopied] = useState(false);
-  const preRef = useRef<HTMLPreElement>(null);
-
-  // Extract language from the child <code> element's data-language or className
-  let language = "";
-  if (React.isValidElement(children)) {
-    const childProps = children.props as any;
-    language = childProps?.["data-language"] || "";
-    if (!language && childProps?.className) {
-      const match = childProps.className.match(/language-(\w+)/);
-      if (match) language = match[1];
-    }
-  }
-
-  const handleCopy = useCallback(async () => {
-    const code = preRef.current?.textContent || "";
-    try {
-      await navigator.clipboard.writeText(code);
-      setCopied(true);
-      setTimeout(() => setCopied(false), 2000);
-    } catch {
-      // Fallback
-      const textarea = document.createElement("textarea");
-      textarea.value = code;
-      textarea.style.position = "fixed";
-      textarea.style.opacity = "0";
-      document.body.appendChild(textarea);
-      textarea.select();
-      document.execCommand("copy");
-      document.body.removeChild(textarea);
-      setCopied(true);
-      setTimeout(() => setCopied(false), 2000);
-    }
-  }, []);
-
-  return (
-    <div className="code-block-wrapper">
-      <div className="code-block-header">
-        <span className="code-block-lang">{language || "code"}</span>
-        <button
-          className={`code-block-copy ${copied ? "copied" : ""}`}
-          onClick={handleCopy}
-          type="button"
-          aria-label="Copy code"
-        >
-          {copied ? (
-            <>
-              <Check size={20} />
-            </>
-          ) : (
-            <>
-              <Copy size={20} />
-            </>
-          )}
-        </button>
-      </div>
-      <pre ref={preRef} {...props}>
-        {children}
-      </pre>
-    </div>
-  );
-}
+import React, { useState, useRef, useCallback } from "react";
+import { Copy, Check } from "lucide-react";
+
+interface CodeBlockProps {
+  children?: React.ReactNode;
+  className?: string;
+  [key: string]: any;
+}
+
+/**
+ * A specialized wrapper for code snippets compiled from MDX blocks.
+ * Provides syntax highlighting styling scaffolding and a "Copy to Clipboard" button.
+ */
+export function CodeBlock({ children, ...props }: CodeBlockProps) {
+  const [copied, setCopied] = useState(false);
+  const preRef = useRef<HTMLPreElement>(null);
+
+  // Extract language from the child <code> element's data-language or className
+  let language = "";
+  if (React.isValidElement(children)) {
+    const childProps = children.props as any;
+    language = childProps?.["data-language"] || "";
+    if (!language && childProps?.className) {
+      const match = childProps.className.match(/language-(\w+)/);
+      if (match) language = match[1];
+    }
+  }
+
+  const handleCopy = useCallback(async () => {
+    const code = preRef.current?.textContent || "";
+    try {
+      await navigator.clipboard.writeText(code);
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2000);
+    } catch {
+      // Fallback
+      const textarea = document.createElement("textarea");
+      textarea.value = code;
+      textarea.style.position = "fixed";
+      textarea.style.opacity = "0";
+      document.body.appendChild(textarea);
+      textarea.select();
+      document.execCommand("copy");
+      document.body.removeChild(textarea);
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2000);
+    }
+  }, []);
+
+  return (
+    <div className="code-block-wrapper">
+      <div className="code-block-header">
+        <span className="code-block-lang">{language || "code"}</span>
+        <button
+          className={`code-block-copy ${copied ? "copied" : ""}`}
+          onClick={handleCopy}
+          type="button"
+          aria-label="Copy code"
+        >
+          {copied ? (
+            <>
+              <Check size={20} />
+            </>
+          ) : (
+            <>
+              <Copy size={20} />
+            </>
+          )}
+        </button>
+      </div>
+      <pre ref={preRef} {...props}>
+        {children}
+      </pre>
+    </div>
+  );
+}

package/src/client/theme/components/CodeBlock/index.ts

@@ -1 +1 @@
-export { CodeBlock } from "./CodeBlock";
+export { CodeBlock } from "./CodeBlock";