boltdocs 1.10.2 → 1.11.0

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

@@ -1,125 +0,0 @@
-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 "../../../types";
-
-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

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

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

@@ -1,98 +0,0 @@
-.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

@@ -1,203 +0,0 @@
-import React from "react";
-import { useLocation } from "react-router-dom";
-import { Link } from "../Link";
-import { ChevronLeft, ChevronRight } from "lucide-react";
-import { usePreload } from "../../../app/preload";
-import { BoltdocsConfig } from "../../../../node/config";
-import { ComponentRoute } from "../../../types";
-export { Navbar } from "../Navbar";
-export { Sidebar } from "../Sidebar";
-export { OnThisPage } from "../OnThisPage";
-export { Head } from "../Head";
-export { Breadcrumbs } from "../Breadcrumbs";
-
-import { Navbar } from "../Navbar";
-import { Sidebar } from "../Sidebar";
-import { OnThisPage } from "../OnThisPage";
-import { Head } from "../Head";
-import { Breadcrumbs } from "../Breadcrumbs";
-import { ProgressBar } from "../ProgressBar";
-import { ErrorBoundary } from "../ErrorBoundary";
-import { CopyMarkdown } from "../CopyMarkdown";
-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 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}>
-      <ProgressBar />
-      {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">
-        {sidebar !== undefined ? (
-          sidebar
-        ) : (
-          <Sidebar routes={filteredRoutes} config={config} />
-        )}
-
-        <main className="boltdocs-content">
-          {breadcrumbs !== undefined ? (
-            breadcrumbs
-          ) : (
-            <Breadcrumbs routes={filteredRoutes} config={config} />
-          )}
-          <div className="boltdocs-page">
-            <div className="boltdocs-page-header">
-              <CopyMarkdown
-                content={routes[currentIndex]?._rawContent}
-                config={config.themeConfig?.copyMarkdown}
-              />
-            </div>
-            <ErrorBoundary>{children}</ErrorBoundary>
-          </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

@@ -1,106 +0,0 @@
-/* ─── Reset ──────────────────────────────────────────────── */
-*,
-*::before,
-*::after {
-  box-sizing: border-box;
-}
-
-html,
-body {
-  margin: 0;
-  padding: 0;
-  height: 100%;
-  overflow: hidden; /* Lock the window scroll */
-}
-
-body {
-  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;
-  height: 100vh;
-  width: 100vw;
-  overflow: hidden;
-}
-
-.boltdocs-main-container {
-  display: flex;
-  flex: 1;
-  width: 100%;
-  max-width: 1440px;
-  margin: 0 auto;
-  padding: 0 0.5rem;
-  /* Fixed height layout */
-  height: calc(100vh - var(--ld-header-height));
-  overflow: hidden;
-  align-items: stretch; /* Sidebars fill height naturally */
-}
-
-/* ─── 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);
-  top: -200px;
-}
-
-.boltdocs-page {
-  position: relative;
-}
-
-.boltdocs-page-header {
-  position: absolute;
-  top: -0.5rem; /* Move up slightly to overlap less with title body */
-  right: 0;
-  display: flex;
-  justify-content: flex-end;
-  padding: 1rem 0;
-  pointer-events: none;
-  z-index: 101; /* Ensure it stays above everything */
-}
-
-.boltdocs-page-header > * {
-  pointer-events: auto;
-}

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

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

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

@@ -1,72 +0,0 @@
-/* ═══════════════════════════════════════════════════════════
-   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

@@ -1,47 +0,0 @@
-/* ═══════════════════════════════════════════════════════════
-   RESPONSIVE
-   ═══════════════════════════════════════════════════════════ */
-@media (max-width: 1100px) {
-  .boltdocs-on-this-page {
-    display: none;
-  }
-}
-
-@media (max-width: 768px) {
-  .boltdocs-sidebar {
-    display: none;
-  }
-
-  .boltdocs-content {
-    padding: 1.5rem 1rem 3rem;
-  }
-
-  .hero-title {
-    font-size: 2.25rem;
-  }
-
-  .boltdocs-page h1 {
-    padding-right: 0;
-  }
-
-  .boltdocs-page-header {
-    position: static;
-    justify-content: flex-start;
-    margin-bottom: 1rem;
-    padding: 0;
-  }
-
-  .ld-cards--2,
-  .ld-cards--3,
-  .ld-cards--4 {
-    grid-template-columns: 1fr;
-  }
-
-  .navbar-search {
-    display: none;
-  }
-
-  .page-nav {
-    flex-direction: column;
-  }
-}