npm - boltdocs - Versions diffs - 1.0.0 - Mend

boltdocs 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (137) hide show

package/dist/CodeBlock-37XMKCYY.mjs +7 -0
package/dist/PackageManagerTabs-4NWXLXQO.mjs +314 -0
package/dist/Playground-OE2OE6B6.mjs +7 -0
package/dist/SearchDialog-FTOQZ763.mjs +187 -0
package/dist/SearchDialog-ZAZXYIFX.css +2147 -0
package/dist/Video-I6QY4X7J.mjs +7 -0
package/dist/chunk-2YRDWM6O.mjs +56 -0
package/dist/chunk-PN4GCTYG.mjs +67 -0
package/dist/chunk-X2TDGMTR.mjs +64 -0
package/dist/chunk-X6BYQHVC.mjs +12 -0
package/dist/chunk-Z7JHYNAS.mjs +57 -0
package/dist/chunk-ZFCOLEXN.mjs +1644 -0
package/dist/client/index.css +2147 -0
package/dist/client/index.d.mts +298 -0
package/dist/client/index.d.ts +298 -0
package/dist/client/index.js +2793 -0
package/dist/client/index.mjs +63 -0
package/dist/client/ssr.css +2147 -0
package/dist/client/ssr.d.mts +25 -0
package/dist/client/ssr.d.ts +25 -0
package/dist/client/ssr.js +2727 -0
package/dist/client/ssr.mjs +32 -0
package/dist/config-D2XmHJYe.d.mts +122 -0
package/dist/config-D2XmHJYe.d.ts +122 -0
package/dist/index-CRQKWAeo.d.mts +82 -0
package/dist/index-CRQKWAeo.d.ts +82 -0
package/dist/node/cli/index.d.mts +1 -0
package/dist/node/cli/index.d.ts +1 -0
package/dist/node/cli/index.js +199 -0
package/dist/node/cli/index.mjs +154 -0
package/dist/node/index.d.mts +79 -0
package/dist/node/index.d.ts +79 -0
package/dist/node/index.js +797 -0
package/dist/node/index.mjs +719 -0
package/package.json +79 -0
package/src/client/app/index.tsx +422 -0
package/src/client/app/preload.tsx +56 -0
package/src/client/index.ts +40 -0
package/src/client/ssr.tsx +50 -0
package/src/client/theme/components/CodeBlock/CodeBlock.tsx +76 -0
package/src/client/theme/components/CodeBlock/index.ts +1 -0
package/src/client/theme/components/PackageManagerTabs/PackageManagerTabs.tsx +154 -0
package/src/client/theme/components/PackageManagerTabs/index.ts +1 -0
package/src/client/theme/components/PackageManagerTabs/pkg-tabs.css +64 -0
package/src/client/theme/components/Playground/Playground.tsx +86 -0
package/src/client/theme/components/Playground/index.ts +1 -0
package/src/client/theme/components/Playground/playground.css +168 -0
package/src/client/theme/components/Video/Video.tsx +84 -0
package/src/client/theme/components/Video/index.ts +1 -0
package/src/client/theme/components/Video/video.css +41 -0
package/src/client/theme/components/mdx/Admonition.tsx +80 -0
package/src/client/theme/components/mdx/Badge.tsx +31 -0
package/src/client/theme/components/mdx/Button.tsx +50 -0
package/src/client/theme/components/mdx/Card.tsx +80 -0
package/src/client/theme/components/mdx/List.tsx +57 -0
package/src/client/theme/components/mdx/Tabs.tsx +94 -0
package/src/client/theme/components/mdx/index.ts +18 -0
package/src/client/theme/components/mdx/mdx-components.css +405 -0
package/src/client/theme/icons/bun.tsx +62 -0
package/src/client/theme/icons/deno.tsx +20 -0
package/src/client/theme/icons/discord.tsx +12 -0
package/src/client/theme/icons/github.tsx +15 -0
package/src/client/theme/icons/npm.tsx +13 -0
package/src/client/theme/icons/pnpm.tsx +72 -0
package/src/client/theme/icons/twitter.tsx +12 -0
package/src/client/theme/styles/home.css +60 -0
package/src/client/theme/styles/markdown.css +343 -0
package/src/client/theme/styles/variables.css +162 -0
package/src/client/theme/styles.css +38 -0
package/src/client/theme/ui/BackgroundGradient/BackgroundGradient.tsx +10 -0
package/src/client/theme/ui/BackgroundGradient/index.ts +1 -0
package/src/client/theme/ui/Breadcrumbs/Breadcrumbs.tsx +68 -0
package/src/client/theme/ui/Breadcrumbs/index.ts +1 -0
package/src/client/theme/ui/Footer/footer.css +32 -0
package/src/client/theme/ui/Head/Head.tsx +69 -0
package/src/client/theme/ui/Head/index.ts +1 -0
package/src/client/theme/ui/LanguageSwitcher/LanguageSwitcher.tsx +125 -0
package/src/client/theme/ui/LanguageSwitcher/index.ts +1 -0
package/src/client/theme/ui/LanguageSwitcher/language-switcher.css +98 -0
package/src/client/theme/ui/Layout/Layout.tsx +213 -0
package/src/client/theme/ui/Layout/base.css +76 -0
package/src/client/theme/ui/Layout/index.ts +2 -0
package/src/client/theme/ui/Layout/pagination.css +72 -0
package/src/client/theme/ui/Layout/responsive.css +40 -0
package/src/client/theme/ui/Link/Link.tsx +202 -0
package/src/client/theme/ui/Link/index.ts +2 -0
package/src/client/theme/ui/Loading/Loading.tsx +10 -0
package/src/client/theme/ui/Loading/index.ts +1 -0
package/src/client/theme/ui/Loading/loading.css +30 -0
package/src/client/theme/ui/Navbar/GithubStars.tsx +27 -0
package/src/client/theme/ui/Navbar/Navbar.tsx +145 -0
package/src/client/theme/ui/Navbar/index.ts +2 -0
package/src/client/theme/ui/Navbar/navbar.css +233 -0
package/src/client/theme/ui/NotFound/NotFound.tsx +20 -0
package/src/client/theme/ui/NotFound/index.ts +1 -0
package/src/client/theme/ui/NotFound/not-found.css +64 -0
package/src/client/theme/ui/OnThisPage/OnThisPage.tsx +192 -0
package/src/client/theme/ui/OnThisPage/index.ts +1 -0
package/src/client/theme/ui/OnThisPage/toc.css +132 -0
package/src/client/theme/ui/PoweredBy/PoweredBy.tsx +18 -0
package/src/client/theme/ui/PoweredBy/index.ts +1 -0
package/src/client/theme/ui/PoweredBy/powered-by.css +76 -0
package/src/client/theme/ui/SearchDialog/SearchDialog.tsx +199 -0
package/src/client/theme/ui/SearchDialog/index.ts +1 -0
package/src/client/theme/ui/SearchDialog/search.css +152 -0
package/src/client/theme/ui/Sidebar/Sidebar.tsx +200 -0
package/src/client/theme/ui/Sidebar/index.ts +1 -0
package/src/client/theme/ui/Sidebar/sidebar.css +269 -0
package/src/client/theme/ui/ThemeToggle/ThemeToggle.tsx +69 -0
package/src/client/theme/ui/ThemeToggle/index.ts +1 -0
package/src/client/theme/ui/VersionSwitcher/VersionSwitcher.tsx +136 -0
package/src/client/theme/ui/VersionSwitcher/index.ts +1 -0
package/src/client/utils.ts +26 -0
package/src/node/cache.ts +94 -0
package/src/node/cli/commands/config.ts +15 -0
package/src/node/cli/commands/generate-css.ts +24 -0
package/src/node/cli/constants.ts +70 -0
package/src/node/cli/index.ts +22 -0
package/src/node/config.ts +185 -0
package/src/node/index.ts +21 -0
package/src/node/mdx.ts +41 -0
package/src/node/plugin/entry.ts +58 -0
package/src/node/plugin/html.ts +55 -0
package/src/node/plugin/index.ts +190 -0
package/src/node/plugin/types.ts +11 -0
package/src/node/routes/cache.ts +24 -0
package/src/node/routes/index.ts +152 -0
package/src/node/routes/parser.ts +127 -0
package/src/node/routes/sorter.ts +42 -0
package/src/node/routes/types.ts +49 -0
package/src/node/ssg/index.ts +110 -0
package/src/node/ssg/meta.ts +34 -0
package/src/node/ssg/options.ts +13 -0
package/src/node/ssg/sitemap.ts +54 -0
package/src/node/utils.ts +134 -0
package/tsconfig.json +20 -0
package/tsup.config.ts +22 -0

package/src/client/theme/ui/Head/Head.tsx ADDED Viewed

@@ -0,0 +1,69 @@
+import { useEffect } from "react";
+import { useLocation } from "react-router-dom";
+interface HeadProps {
+  siteTitle: string;
+  siteDescription?: string;
+  routes: Array<{ path: string; title: string; description?: string }>;
+}
+export function Head({ siteTitle, siteDescription, routes }: HeadProps) {
+  const location = useLocation();
+  useEffect(() => {
+    // Find the current route's metadata
+    const currentRoute = routes.find((r) => r.path === location.pathname);
+    const pageTitle = currentRoute?.title;
+    const pageDescription = currentRoute?.description || siteDescription || "";
+    // Update document title
+    document.title = pageTitle ? `${pageTitle} | ${siteTitle}` : siteTitle;
+    // Update or create meta description
+    let metaDesc = document.querySelector(
+      'meta[name="description"]',
+    ) as HTMLMetaElement | null;
+    if (!metaDesc) {
+      metaDesc = document.createElement("meta");
+      metaDesc.name = "description";
+      document.head.appendChild(metaDesc);
+    }
+    metaDesc.content = pageDescription;
+    // Update OG tags
+    setMetaTag("property", "og:title", document.title);
+    setMetaTag("property", "og:description", pageDescription);
+    setMetaTag("property", "og:type", "article");
+    setMetaTag("property", "og:url", window.location.href);
+    // Twitter card
+    setMetaTag("name", "twitter:card", "summary");
+    setMetaTag("name", "twitter:title", document.title);
+    setMetaTag("name", "twitter:description", pageDescription);
+    // Canonical URL
+    let canonical = document.querySelector(
+      'link[rel="canonical"]',
+    ) as HTMLLinkElement | null;
+    if (!canonical) {
+      canonical = document.createElement("link");
+      canonical.rel = "canonical";
+      document.head.appendChild(canonical);
+    }
+    canonical.href = window.location.origin + location.pathname;
+  }, [location.pathname, siteTitle, siteDescription, routes]);
+  return null; // This component only manages <head>, no visual output
+}
+function setMetaTag(attr: "name" | "property", key: string, content: string) {
+  let tag = document.querySelector(
+    `meta[${attr}="${key}"]`,
+  ) as HTMLMetaElement | null;
+  if (!tag) {
+    tag = document.createElement("meta");
+    tag.setAttribute(attr, key);
+    document.head.appendChild(tag);
+  }
+  tag.content = content;
+}

package/src/client/theme/ui/Head/index.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export { Head } from "./Head";

package/src/client/theme/ui/LanguageSwitcher/LanguageSwitcher.tsx ADDED Viewed

@@ -0,0 +1,125 @@
+import React, { useState, useRef, useEffect } from "react";
+import { Globe, ChevronDown } from "lucide-react";
+import { useNavigate, useLocation } from "react-router-dom";
+import { BoltdocsI18nConfig } from "../../../../node/config";
+import { ComponentRoute } from "../../../app";
+function getBaseFilePath(
+  filePath: string,
+  version: string | undefined,
+  locale: string | undefined,
+): string {
+  let path = filePath;
+  if (version && (path === version || path.startsWith(version + "/"))) {
+    path = path === version ? "index.md" : path.slice(version.length + 1);
+  }
+  if (locale && (path === locale || path.startsWith(locale + "/"))) {
+    path = path === locale ? "index.md" : path.slice(locale.length + 1);
+  }
+  return path;
+}
+export function LanguageSwitcher({
+  i18n,
+  currentLocale,
+  allRoutes,
+}: {
+  i18n: BoltdocsI18nConfig;
+  currentLocale: string;
+  allRoutes: ComponentRoute[];
+}) {
+  const [isOpen, setIsOpen] = useState(false);
+  const dropdownRef = useRef<HTMLDivElement>(null);
+  const navigate = useNavigate();
+  const location = useLocation();
+  useEffect(() => {
+    function handleClickOutside(event: MouseEvent) {
+      if (
+        dropdownRef.current &&
+        !dropdownRef.current.contains(event.target as Node)
+      ) {
+        setIsOpen(false);
+      }
+    }
+    document.addEventListener("mousedown", handleClickOutside);
+    return () => document.removeEventListener("mousedown", handleClickOutside);
+  }, []);
+  const handleSelect = (locale: string) => {
+    setIsOpen(false);
+    if (locale === currentLocale) return;
+    const currentRoute = allRoutes.find((r) => r.path === location.pathname);
+    let targetPath = "/";
+    if (currentRoute) {
+      const baseFile = getBaseFilePath(
+        currentRoute.filePath,
+        currentRoute.version,
+        currentRoute.locale,
+      );
+      const targetRoute = allRoutes.find(
+        (r) =>
+          getBaseFilePath(r.filePath, r.version, r.locale) === baseFile &&
+          (r.locale || i18n.defaultLocale) === locale &&
+          r.version === currentRoute.version,
+      );
+      if (targetRoute) {
+        targetPath = targetRoute.path;
+      } else {
+        const defaultIndexRoute = allRoutes.find(
+          (r) =>
+            getBaseFilePath(r.filePath, r.version, r.locale) === "index.md" &&
+            (r.locale || i18n.defaultLocale) === locale &&
+            r.version === currentRoute.version,
+        );
+        targetPath = defaultIndexRoute
+          ? defaultIndexRoute.path
+          : locale === i18n.defaultLocale
+            ? currentRoute.version
+              ? `/${currentRoute.version}`
+              : "/"
+            : currentRoute.version
+              ? `/${currentRoute.version}/${locale}`
+              : `/${locale}`;
+      }
+    } else {
+      targetPath = locale === i18n.defaultLocale ? "/" : `/${locale}`;
+    }
+    navigate(targetPath);
+  };
+  return (
+    <div className="boltdocs-language-switcher" ref={dropdownRef}>
+      <button
+        className="language-btn"
+        onClick={() => setIsOpen(!isOpen)}
+        aria-label="Switch language"
+        aria-expanded={isOpen}
+        aria-haspopup="listbox"
+      >
+        <Globe size={18} />
+        <span className="language-label">
+          {i18n.locales[currentLocale] || currentLocale}
+        </span>
+        <ChevronDown size={14} />
+      </button>
+      {isOpen && (
+        <div className="language-dropdown">
+          {Object.entries(i18n.locales).map(([key, label]) => (
+            <button
+              key={key}
+              className={`language-option ${key === currentLocale ? "active" : ""}`}
+              onClick={() => handleSelect(key)}
+            >
+              {label}
+            </button>
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}

package/src/client/theme/ui/LanguageSwitcher/index.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export { LanguageSwitcher } from "./LanguageSwitcher";

package/src/client/theme/ui/LanguageSwitcher/language-switcher.css ADDED Viewed

@@ -0,0 +1,98 @@
+.boltdocs-language-switcher {
+  position: relative;
+  display: flex;
+  align-items: center;
+}
+.language-btn {
+  display: flex;
+  align-items: center;
+  gap: 0.35rem;
+  padding: 0.4rem 0.6rem;
+  background: transparent;
+  color: var(--ld-text-muted);
+  border: none;
+  border-radius: var(--ld-radius-md);
+  font-size: 0.8125rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition:
+    background-color 0.2s,
+    color 0.2s;
+}
+.language-btn svg {
+  width: 15px;
+  height: 15px;
+  opacity: 0.8;
+}
+.language-btn:hover {
+  background-color: var(--ld-bg-mute);
+  color: var(--ld-text-main);
+}
+.language-dropdown {
+  position: absolute;
+  top: 100%;
+  right: 0;
+  margin-top: 0.35rem;
+  min-width: 130px;
+  background-color: rgba(15, 15, 24, 0.85); /* Smooth translucent dark match */
+  backdrop-filter: blur(12px);
+  -webkit-backdrop-filter: blur(12px);
+  border: 1px solid var(--ld-border-strong);
+  border-radius: var(--ld-radius-md);
+  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.4);
+  padding: 0.35rem;
+  z-index: 200;
+  display: flex;
+  flex-direction: column;
+  gap: 0.15rem;
+  animation: languageDropdownIn 0.15s ease-out;
+}
+@keyframes languageDropdownIn {
+  from {
+    opacity: 0;
+    transform: translateY(-4px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+/* Light mode fallback */
+[data-theme="light"] .language-dropdown,
+.theme-light .language-dropdown {
+  background-color: rgba(255, 255, 255, 0.9);
+  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.08);
+}
+.language-option {
+  display: block;
+  width: 100%;
+  text-align: left;
+  padding: 0.4rem 0.6rem;
+  background: transparent;
+  border: none;
+  border-radius: var(--ld-radius-sm);
+  color: var(--ld-text-muted);
+  font-size: 0.8125rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition:
+    background-color 0.2s,
+    color 0.2s;
+}
+.language-option:hover {
+  background-color: var(--ld-bg-mute);
+  color: var(--ld-text-main);
+}
+.language-option.active {
+  background-color: var(--ld-color-primary-muted);
+  color: var(--ld-color-primary);
+}

package/src/client/theme/ui/Layout/Layout.tsx ADDED Viewed

@@ -0,0 +1,213 @@
+import React, { useState } from "react";
+import { useLocation } from "react-router-dom";
+import { Link } from "../Link";
+import { ChevronLeft, ChevronRight, Menu } from "lucide-react";
+import { usePreload } from "../../../app/preload";
+import { BoltdocsConfig } from "../../../../node/config";
+import { ComponentRoute } from "../../../app";
+export { Navbar } from "../Navbar";
+export { Sidebar } from "../Sidebar";
+export { OnThisPage } from "../OnThisPage";
+export { Head } from "../Head";
+export { Breadcrumbs } from "../Breadcrumbs";
+export { BackgroundGradient } from "../BackgroundGradient";
+import { Navbar } from "../Navbar";
+import { Sidebar } from "../Sidebar";
+import { OnThisPage } from "../OnThisPage";
+import { Head } from "../Head";
+import { Breadcrumbs } from "../Breadcrumbs";
+import { BackgroundGradient } from "../BackgroundGradient";
+import "../../styles.css";
+export interface ThemeLayoutProps {
+  config: BoltdocsConfig;
+  routes: ComponentRoute[];
+  children: React.ReactNode;
+  /** Custom navbar component (slots) */
+  navbar?: React.ReactNode;
+  /** Custom sidebar component (slots) */
+  sidebar?: React.ReactNode;
+  /** Custom table of contents (OnThisPage) component (slots) */
+  toc?: React.ReactNode;
+  /** Custom background component (slots) */
+  background?: React.ReactNode;
+  /** Custom head/metadata component (slots) */
+  head?: React.ReactNode;
+  /** Custom breadcrumbs component (slots) */
+  breadcrumbs?: React.ReactNode;
+  /** Custom class name for the root layout element */
+  className?: string;
+  /** Custom styles for the root layout element */
+  style?: React.CSSProperties;
+}
+/**
+ * The main structural layout for documentation pages.
+ * Integrates the Navbar, Sidebar, and OnThisPage components into a cohesive shell.
+ * It also manages mobile interaction states like the sidebar overlay toggle.
+ *
+ * @param config - The global Boltdocs configuration object
+ * @param routes - The array of available doc routes (used to render the sidebar)
+ */
+export function ThemeLayout({
+  config,
+  routes,
+  children,
+  navbar,
+  sidebar,
+  toc,
+  background,
+  head,
+  breadcrumbs,
+  className = "",
+  style,
+}: ThemeLayoutProps) {
+  const [isSidebarOpen, setIsSidebarOpen] = useState(true);
+  const siteTitle = config.themeConfig?.title || "Boltdocs";
+  const siteDescription = config.themeConfig?.description || "";
+  const location = useLocation();
+  // Compute prev/next pages and locale
+  const currentIndex = routes.findIndex((r) => r.path === location.pathname);
+  const currentRoute = routes[currentIndex];
+  // Determine current locale (fallback to default)
+  const currentLocale = config.i18n
+    ? currentRoute?.locale || config.i18n.defaultLocale
+    : undefined;
+  // Determine current version (fallback to default)
+  const currentVersion = config.versions
+    ? currentRoute?.version || config.versions.defaultVersion
+    : undefined;
+  // Filter routes for sidebar, search, and navigation to only ones in the current locale and version
+  const filteredRoutes = routes.filter((r) => {
+    const localeMatch = config.i18n
+      ? (r.locale || config.i18n.defaultLocale) === currentLocale
+      : true;
+    const versionMatch = config.versions
+      ? (r.version || config.versions.defaultVersion) === currentVersion
+      : true;
+    return localeMatch && versionMatch;
+  });
+  const localIndex = filteredRoutes.findIndex(
+    (r) => r.path === location.pathname,
+  );
+  const prevPage = localIndex > 0 ? filteredRoutes[localIndex - 1] : null;
+  const nextPage =
+    localIndex >= 0 && localIndex < filteredRoutes.length - 1
+      ? filteredRoutes[localIndex + 1]
+      : null;
+  const { preload } = usePreload();
+  React.useEffect(() => {
+    if (prevPage?.path) preload(prevPage.path);
+    if (nextPage?.path) preload(nextPage.path);
+  }, [prevPage, nextPage, preload]);
+  return (
+    <div className={`boltdocs-layout ${className}`} style={style}>
+      {background !== undefined ? background : <BackgroundGradient />}
+      {head !== undefined ? (
+        head
+      ) : (
+        <Head
+          siteTitle={siteTitle}
+          siteDescription={siteDescription}
+          routes={routes}
+        />
+      )}
+      {navbar !== undefined ? (
+        navbar
+      ) : (
+        <Navbar
+          config={config}
+          routes={filteredRoutes}
+          allRoutes={routes}
+          currentLocale={currentLocale}
+          currentVersion={currentVersion}
+        />
+      )}
+      <div
+        className={`boltdocs-main-container ${!isSidebarOpen ? "sidebar-collapsed" : ""}`}
+      >
+        {sidebar !== undefined ? (
+          sidebar
+        ) : (
+          <Sidebar
+            routes={filteredRoutes}
+            config={config}
+            onCollapse={() => setIsSidebarOpen(false)}
+          />
+        )}
+        {/* Floating Expand Button when Sidebar is Collapsed */}
+        {sidebar === undefined && (
+          <button
+            className="sidebar-toggle-floating"
+            onClick={() => setIsSidebarOpen(true)}
+            aria-label="Expand Sidebar"
+            title="Expand Sidebar"
+          >
+            <Menu size={20} />
+          </button>
+        )}
+        <main className="boltdocs-content">
+          {breadcrumbs !== undefined ? (
+            breadcrumbs
+          ) : (
+            <Breadcrumbs routes={filteredRoutes} config={config} />
+          )}
+          <div className="boltdocs-page">{children}</div>
+          {/* Prev / Next Navigation */}
+          {(prevPage || nextPage) && (
+            <nav className="page-nav" aria-label="Pagination">
+              {prevPage ? (
+                <Link
+                  to={prevPage.path || "/"}
+                  className="page-nav-link page-nav-link--prev"
+                >
+                  <div className="page-nav-info">
+                    <span className="page-nav-label">Previous</span>
+                    <span className="page-nav-title">{prevPage.title}</span>
+                  </div>
+                  <ChevronLeft className="page-nav-arrow" size={16} />
+                </Link>
+              ) : (
+                <span />
+              )}
+              {nextPage ? (
+                <Link
+                  to={nextPage.path || "/"}
+                  className="page-nav-link page-nav-link--next"
+                >
+                  <div className="page-nav-info">
+                    <span className="page-nav-label">Next</span>
+                    <span className="page-nav-title">{nextPage.title}</span>
+                  </div>
+                  <ChevronRight className="page-nav-arrow" size={16} />
+                </Link>
+              ) : (
+                <span />
+              )}
+            </nav>
+          )}
+        </main>
+        {toc !== undefined ? (
+          toc
+        ) : (
+          <OnThisPage
+            headings={routes[currentIndex]?.headings}
+            editLink={config.themeConfig?.editLink}
+            communityHelp={config.themeConfig?.communityHelp}
+            filePath={routes[currentIndex]?.filePath}
+          />
+        )}
+      </div>
+    </div>
+  );
+}

package/src/client/theme/ui/Layout/base.css ADDED Viewed

@@ -0,0 +1,76 @@
+/* ─── Reset ──────────────────────────────────────────────── */
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+body {
+  margin: 0;
+  font-family: var(--ld-font-sans);
+  background-color: var(--ld-bg-main);
+  color: var(--ld-text-main);
+  line-height: 1.7;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+a {
+  text-decoration: none;
+  &:hover {
+    text-decoration: none;
+  }
+}
+/* ─── Layout Shell ───────────────────────────────────────── */
+.boltdocs-layout {
+  display: flex;
+  flex-direction: column;
+  min-height: 100vh;
+}
+.boltdocs-main-container {
+  display: flex;
+  flex: 1;
+  width: 100%;
+  max-width: 1440px;
+  margin: 0 auto;
+  padding: 0 1.5rem;
+  /* aligns with navbar */
+}
+/* ─── Background Glow ────────────────────────────────────── */
+.boltdocs-background-glow {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  height: 100vh;
+  overflow: hidden;
+  z-index: -1;
+  pointer-events: none;
+}
+.glow-shape {
+  position: absolute;
+  border-radius: 50%;
+  filter: blur(100px);
+  opacity: 0.15;
+  top: -100px;
+}
+.glow-1 {
+  width: 600px;
+  height: 600px;
+  background: var(--ld-glow-1-bg);
+  left: -200px;
+}
+.glow-2 {
+  width: 800px;
+  height: 800px;
+  background: var(--ld-glow-2-bg);
+  right: -300px;
+  top: -200px;
+}

package/src/client/theme/ui/Layout/index.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export { ThemeLayout } from "./Layout";
2	+ export type { ThemeLayoutProps } from "./Layout";

package/src/client/theme/ui/Layout/pagination.css ADDED Viewed

@@ -0,0 +1,72 @@
+/* ═══════════════════════════════════════════════════════════
+   PREV / NEXT NAVIGATION
+   ═══════════════════════════════════════════════════════════ */
+.page-nav {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 0.75rem;
+  margin-top: 2.5rem;
+  padding-top: 1.5rem;
+  border-top: 1px solid var(--ld-border-subtle);
+}
+.page-nav-link {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.75rem;
+  padding: 0.875rem 1rem;
+  border-radius: var(--ld-radius-md);
+  border: 1px solid var(--ld-border-subtle);
+  text-decoration: none;
+  transition: all 0.2s;
+}
+.page-nav-link:hover {
+  border-color: var(--ld-color-primary);
+  background-color: var(--ld-color-primary-muted);
+}
+.page-nav-link--prev {
+  flex-direction: row-reverse;
+}
+.page-nav-link--next {
+  text-align: left;
+}
+.page-nav-info {
+  display: flex;
+  flex-direction: column;
+  gap: 0.15rem;
+  min-width: 0;
+}
+.page-nav-label {
+  font-size: 0.6875rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--ld-text-dim);
+  display: block;
+}
+.page-nav-title {
+  font-size: 0.8125rem;
+  font-weight: 600;
+  color: var(--ld-text-main);
+  display: block;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.page-nav-arrow {
+  color: var(--ld-text-dim);
+  flex-shrink: 0;
+  transition: color 0.2s;
+}
+.page-nav-link:hover .page-nav-arrow {
+  color: var(--ld-color-primary);
+}

package/src/client/theme/ui/Layout/responsive.css ADDED Viewed

@@ -0,0 +1,40 @@
+/* ═══════════════════════════════════════════════════════════
+   RESPONSIVE
+   ═══════════════════════════════════════════════════════════ */
+@media (max-width: 1100px) {
+  .boltdocs-on-this-page {
+    display: none;
+  }
+}
+@media (max-width: 768px) {
+  .boltdocs-sidebar {
+    display: none;
+  }
+  .sidebar-toggle-floating {
+    display: none !important;
+  }
+  .boltdocs-content {
+    padding: 1.5rem 1rem 3rem;
+  }
+  .hero-title {
+    font-size: 2.25rem;
+  }
+  .ld-cards--2,
+  .ld-cards--3,
+  .ld-cards--4 {
+    grid-template-columns: 1fr;
+  }
+  .navbar-search {
+    display: none;
+  }
+  .page-nav {
+    flex-direction: column;
+  }
+}