boltdocs 1.10.2 → 1.11.0

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

@@ -1,392 +0,0 @@
-import React from "react";
-import {
-  Link as RouterLink,
-  NavLink as RouterNavLink,
-  LinkProps as RouterLinkProps,
-  NavLinkProps as RouterNavLinkProps,
-  useLocation,
-  useNavigate,
-} from "react-router-dom";
-import { usePreload } from "../../../app/preload";
-import { useConfig } from "../../../app";
-
-function useLocalizedTo(to: RouterLinkProps["to"]) {
-  const location = useLocation();
-  const config = useConfig();
-  if (!config || typeof to !== "string") return to;
-  if (!config.i18n && !config.versions) return to;
-
-  const basePath = "/docs";
-  if (!to.startsWith(basePath)) return to;
-
-  // 1. Detect current context from location
-  const curSub = location.pathname.substring(basePath.length);
-  const curParts = curSub.split("/").filter(Boolean);
-
-  let currentVersion = config.versions?.defaultVersion;
-  let currentLocale = config.i18n?.defaultLocale;
-
-  let cIdx = 0;
-  if (
-    config.versions &&
-    curParts.length > cIdx &&
-    config.versions.versions[curParts[cIdx]]
-  ) {
-    currentVersion = curParts[cIdx];
-    cIdx++;
-  }
-  if (
-    config.i18n &&
-    curParts.length > cIdx &&
-    config.i18n.locales[curParts[cIdx]]
-  ) {
-    currentLocale = curParts[cIdx];
-  }
-
-  // 2. Parse the target `to` path
-  const toSub = to.substring(basePath.length);
-  const toParts = toSub.split("/").filter(Boolean);
-
-  let tIdx = 0;
-  let hasVersion = false;
-  let hasLocale = false;
-
-  if (
-    config.versions &&
-    toParts.length > tIdx &&
-    config.versions.versions[toParts[tIdx]]
-  ) {
-    hasVersion = true;
-    tIdx++;
-  }
-  if (
-    config.i18n &&
-    toParts.length > tIdx &&
-    config.i18n.locales[toParts[tIdx]]
-  ) {
-    hasLocale = true;
-    tIdx++;
-  }
-
-  // Extract just the actual route parts
-  const routeParts = toParts.slice(tIdx);
-
-  // Reconstruct path
-  const finalParts = [];
-  if (config.versions) {
-    if (hasVersion) {
-      finalParts.push(toParts[0]);
-    } else if (currentVersion) {
-      finalParts.push(currentVersion);
-    }
-  }
-  if (config.i18n) {
-    if (hasLocale) {
-      finalParts.push(toParts[hasVersion ? 1 : 0]);
-    } else if (currentLocale) {
-      finalParts.push(currentLocale);
-    }
-  }
-
-  finalParts.push(...routeParts);
-
-  let finalPath = `${basePath}/${finalParts.join("/")}`;
-  if (finalPath.endsWith("/")) {
-    finalPath = finalPath.slice(0, -1);
-  }
-  return finalPath === basePath ? basePath : finalPath;
-}
-
-import { LinkPreview } from "./LinkPreview";
-
-export interface LinkProps extends Omit<RouterLinkProps, "prefetch"> {
-  /** Should prefetch the page on hover? Options: 'hover' | 'none'. Default 'hover' */
-  boltdocsPrefetch?: "hover" | "none";
-  /** Should show a preview tooltip on hover? Default true */
-  boltdocsPreview?: boolean;
-}
-
-export const Link = React.forwardRef<HTMLAnchorElement, LinkProps>(
-  (props, ref) => {
-    const {
-      boltdocsPrefetch = "hover",
-      boltdocsPreview = true,
-      onMouseEnter,
-      onMouseLeave,
-      onFocus,
-      onBlur,
-      onClick,
-      to,
-      ...rest
-    } = props;
-    const localizedTo = useLocalizedTo(to);
-    const { preload, routes } = usePreload();
-    const config = useConfig();
-    const navigate = useNavigate();
-
-    const shouldShowPreview =
-      boltdocsPreview && config?.themeConfig?.linkPreview !== false;
-
-    const [preview, setPreview] = React.useState<{
-      visible: boolean;
-      x: number;
-      y: number;
-      title: string;
-      summary?: string;
-    }>({ visible: false, x: 0, y: 0, title: "" });
-
-    const handleMouseEnter = (e: React.MouseEvent<HTMLAnchorElement>) => {
-      onMouseEnter?.(e);
-      if (
-        boltdocsPrefetch === "hover" &&
-        typeof localizedTo === "string" &&
-        localizedTo.startsWith("/")
-      ) {
-        preload(localizedTo);
-      }
-
-      if (
-        shouldShowPreview &&
-        typeof localizedTo === "string" &&
-        localizedTo.startsWith("/")
-      ) {
-        const cleanPath = localizedTo.split("#")[0].split("?")[0];
-        const route = routes.find(
-          (r) => r.path === cleanPath || (cleanPath === "/" && r.path === ""),
-        );
-        if (route) {
-          setPreview({
-            visible: true,
-            x: e.clientX,
-            y: e.clientY,
-            title: route.title,
-            summary: route.description,
-          });
-        }
-      }
-    };
-
-    const handleMouseMove = (e: React.MouseEvent<HTMLAnchorElement>) => {
-      if (preview.visible) {
-        setPreview((prev) => ({ ...prev, x: e.clientX, y: e.clientY }));
-      }
-    };
-
-    const handleMouseLeave = (e: React.MouseEvent<HTMLAnchorElement>) => {
-      onMouseLeave?.(e);
-      setPreview((prev) => ({ ...prev, visible: false }));
-    };
-
-    const handleFocus = (e: React.FocusEvent<HTMLAnchorElement>) => {
-      onFocus?.(e);
-      if (
-        boltdocsPrefetch === "hover" &&
-        typeof localizedTo === "string" &&
-        localizedTo.startsWith("/")
-      ) {
-        preload(localizedTo);
-      }
-    };
-
-    const handleBlur = (e: React.FocusEvent<HTMLAnchorElement>) => {
-      onBlur?.(e);
-      setPreview((prev) => ({ ...prev, visible: false }));
-    };
-
-    const handleClick = (e: React.MouseEvent<HTMLAnchorElement>) => {
-      // Allow user onClick to handle defaults or custom logic
-      onClick?.(e);
-      setPreview((prev) => ({ ...prev, visible: false }));
-
-      // If default prevented or not a simple left click, don't handle
-      if (
-        e.defaultPrevented ||
-        e.button !== 0 ||
-        e.metaKey ||
-        e.ctrlKey ||
-        e.shiftKey ||
-        e.altKey
-      ) {
-        return;
-      }
-
-      // Intercept navigation to wrap in startTransition
-      if (typeof localizedTo === "string" && !localizedTo.startsWith("http")) {
-        e.preventDefault();
-        React.startTransition(() => {
-          navigate(localizedTo);
-        });
-      }
-    };
-
-    return (
-      <>
-        <RouterLink
-          ref={ref}
-          to={localizedTo}
-          onMouseEnter={handleMouseEnter}
-          onMouseMove={handleMouseMove}
-          onMouseLeave={handleMouseLeave}
-          onFocus={handleFocus}
-          onBlur={handleBlur}
-          onClick={handleClick}
-          {...rest}
-        />
-        {preview.visible && shouldShowPreview && (
-          <LinkPreview
-            isVisible={preview.visible}
-            title={preview.title}
-            summary={preview.summary}
-            x={preview.x}
-            y={preview.y}
-          />
-        )}
-      </>
-    );
-  },
-);
-Link.displayName = "Link";
-
-export interface NavLinkProps extends Omit<RouterNavLinkProps, "prefetch"> {
-  /** Should prefetch the page on hover? Options: 'hover' | 'none'. Default 'hover' */
-  boltdocsPrefetch?: "hover" | "none";
-  /** Should show a preview tooltip on hover? Default true */
-  boltdocsPreview?: boolean;
-}
-
-export const NavLink = React.forwardRef<HTMLAnchorElement, NavLinkProps>(
-  (props, ref) => {
-    const {
-      boltdocsPrefetch = "hover",
-      boltdocsPreview = true,
-      onMouseEnter,
-      onMouseLeave,
-      onFocus,
-      onBlur,
-      onClick,
-      to,
-      ...rest
-    } = props;
-
-    const localizedTo = useLocalizedTo(to);
-    const { preload, routes } = usePreload();
-    const config = useConfig();
-    const navigate = useNavigate();
-
-    const shouldShowPreview =
-      boltdocsPreview && config?.themeConfig?.linkPreview !== false;
-
-    const [preview, setPreview] = React.useState<{
-      visible: boolean;
-      x: number;
-      y: number;
-      title: string;
-      summary?: string;
-    }>({ visible: false, x: 0, y: 0, title: "" });
-
-    const handleMouseEnter = (e: React.MouseEvent<HTMLAnchorElement>) => {
-      onMouseEnter?.(e);
-      if (
-        boltdocsPrefetch === "hover" &&
-        typeof localizedTo === "string" &&
-        localizedTo.startsWith("/")
-      ) {
-        preload(localizedTo);
-      }
-
-      if (
-        shouldShowPreview &&
-        typeof localizedTo === "string" &&
-        localizedTo.startsWith("/")
-      ) {
-        const cleanPath = localizedTo.split("#")[0].split("?")[0];
-        const route = routes.find(
-          (r) => r.path === cleanPath || (cleanPath === "/" && r.path === ""),
-        );
-        if (route) {
-          setPreview({
-            visible: true,
-            x: e.clientX,
-            y: e.clientY,
-            title: route.title,
-            summary: route.description,
-          });
-        }
-      }
-    };
-
-    const handleMouseMove = (e: React.MouseEvent<HTMLAnchorElement>) => {
-      if (preview.visible) {
-        setPreview((prev) => ({ ...prev, x: e.clientX, y: e.clientY }));
-      }
-    };
-
-    const handleMouseLeave = (e: React.MouseEvent<HTMLAnchorElement>) => {
-      onMouseLeave?.(e);
-      setPreview((prev) => ({ ...prev, visible: false }));
-    };
-
-    const handleFocus = (e: React.FocusEvent<HTMLAnchorElement>) => {
-      onFocus?.(e);
-      if (
-        boltdocsPrefetch === "hover" &&
-        typeof localizedTo === "string" &&
-        localizedTo.startsWith("/")
-      ) {
-        preload(localizedTo);
-      }
-    };
-
-    const handleBlur = (e: React.FocusEvent<HTMLAnchorElement>) => {
-      onBlur?.(e);
-      setPreview((prev) => ({ ...prev, visible: false }));
-    };
-
-    const handleClick = (e: React.MouseEvent<HTMLAnchorElement>) => {
-      onClick?.(e);
-      setPreview((prev) => ({ ...prev, visible: false }));
-      if (
-        e.defaultPrevented ||
-        e.button !== 0 ||
-        e.metaKey ||
-        e.ctrlKey ||
-        e.shiftKey ||
-        e.altKey
-      ) {
-        return;
-      }
-      if (typeof localizedTo === "string" && !localizedTo.startsWith("http")) {
-        e.preventDefault();
-        React.startTransition(() => {
-          navigate(localizedTo);
-        });
-      }
-    };
-
-    return (
-      <>
-        <RouterNavLink
-          ref={ref}
-          to={localizedTo}
-          onMouseEnter={handleMouseEnter}
-          onMouseMove={handleMouseMove}
-          onMouseLeave={handleMouseLeave}
-          onFocus={handleFocus}
-          onBlur={handleBlur}
-          onClick={handleClick}
-          {...rest}
-        />
-        {preview.visible && shouldShowPreview && (
-          <LinkPreview
-            isVisible={preview.visible}
-            title={preview.title}
-            summary={preview.summary}
-            x={preview.x}
-            y={preview.y}
-          />
-        )}
-      </>
-    );
-  },
-);
-NavLink.displayName = "NavLink";

package/src/client/theme/ui/Link/LinkPreview.tsx

@@ -1,59 +0,0 @@
-import { useEffect, useState, useRef } from "react";
-import { createPortal } from "react-dom";
-import "./link-preview.css";
-
-interface LinkPreviewProps {
-  isVisible: boolean;
-  title: string;
-  summary?: string;
-  x: number;
-  y: number;
-}
-
-export function LinkPreview({
-  isVisible,
-  title,
-  summary,
-  x,
-  y,
-}: LinkPreviewProps) {
-  const ref = useRef<HTMLDivElement>(null);
-  const [position, setPosition] = useState({ top: 0, left: 0 });
-
-  useEffect(() => {
-    if (ref.current) {
-      const rect = ref.current.getBoundingClientRect();
-      const padding = 12;
-
-      let top = y + padding;
-      let left = x + padding;
-
-      // Keep within viewport
-      if (left + rect.width > window.innerWidth - 20) {
-        left = x - rect.width - padding;
-      }
-      if (top + rect.height > window.innerHeight - 20) {
-        top = y - rect.height - padding;
-      }
-
-      setPosition({ top, left });
-    }
-  }, [x, y, isVisible]);
-
-  return createPortal(
-    <div
-      ref={ref}
-      className={`boltdocs-link-preview ${isVisible ? "is-visible" : ""}`}
-      style={{
-        top: position.top,
-        left: position.left,
-      }}
-    >
-      <div className="boltdocs-link-preview-content">
-        <span className="boltdocs-link-preview-title">{title}</span>
-        {summary && <p className="boltdocs-link-preview-summary">{summary}</p>}
-      </div>
-    </div>,
-    document.body,
-  );
-}

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

@@ -1,2 +0,0 @@
-export { Link, NavLink } from "./Link";
-export type { LinkProps, NavLinkProps } from "./Link";

package/src/client/theme/ui/Link/link-preview.css

@@ -1,48 +0,0 @@
-.boltdocs-link-preview {
-  position: fixed;
-  z-index: 1000;
-  width: 260px;
-  pointer-events: none;
-  opacity: 0;
-  transform: translateY(8px) scale(0.98);
-  transition:
-    opacity 0.15s cubic-bezier(0.4, 0, 0.2, 1),
-    transform 0.15s cubic-bezier(0.4, 0, 0.2, 1);
-  font-family: var(--ld-font-sans);
-}
-
-.boltdocs-link-preview.is-visible {
-  opacity: 1;
-  transform: translateY(0) scale(1);
-}
-
-.boltdocs-link-preview-content {
-  padding: 0.85rem 1rem;
-  background-color: var(--ld-navbar-bg);
-  border: 1px solid var(--ld-border-subtle);
-  border-radius: var(--ld-radius-lg);
-  box-shadow:
-    0 10px 30px -10px rgba(0, 0, 0, 0.2),
-    0 4px 10px -5px rgba(0, 0, 0, 0.1);
-}
-
-.boltdocs-link-preview-title {
-  display: block;
-  font-weight: 600;
-  font-size: 0.875rem;
-  color: var(--ld-text-main);
-  margin-bottom: 0.35rem;
-  line-height: 1.3;
-}
-
-.boltdocs-link-preview-summary {
-  display: block;
-  font-size: 0.775rem;
-  color: var(--ld-text-muted);
-  line-height: 1.5;
-  display: -webkit-box;
-  -webkit-line-clamp: 3;
-  line-clamp: 3;
-  -webkit-box-orient: vertical;
-  overflow: hidden;
-}

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

@@ -1,10 +0,0 @@
-import React from 'react';
-
-export function Loading() {
-  return (
-    <div className="boltdocs-loading">
-      <div className="loading-spinner" />
-      <p className="loading-text">Loading...</p>
-    </div>
-  );
-}

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

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

package/src/client/theme/ui/Loading/loading.css

@@ -1,30 +0,0 @@
-/* ─── Loading ─────────────────────────────────────────────── */
-.boltdocs-loading {
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  justify-content: center;
-  min-height: 40vh;
-  gap: 1rem;
-}
-
-.loading-spinner {
-  width: 2.5rem;
-  height: 2.5rem;
-  border: 3px solid var(--ld-border-subtle);
-  border-top-color: var(--ld-color-primary);
-  border-radius: 50%;
-  animation: boltdocs-spin 0.7s linear infinite;
-}
-
-@keyframes boltdocs-spin {
-  to {
-    transform: rotate(360deg);
-  }
-}
-
-.loading-text {
-  font-size: 0.875rem;
-  color: var(--ld-text-dim);
-  margin: 0;
-}

package/src/client/theme/ui/Navbar/GithubStars.tsx

@@ -1,27 +0,0 @@
-import { useEffect, useState } from "react";
-import { GitHub } from "../../icons/github";
-import { getStarsRepo } from "../../../utils";
-
-export function GithubStars({ repo }: { repo: string }) {
-  const [stars, setStars] = useState<string | null>(null);
-
-  useEffect(() => {
-    if (repo) {
-      getStarsRepo(repo)
-        .then((stars) => setStars(stars))
-        .catch(() => setStars("0"));
-    }
-  }, [repo]);
-
-  return (
-    <a
-      href={`https://github.com/${repo}`}
-      target="_blank"
-      rel="noopener noreferrer"
-      className="navbar-github-stars"
-    >
-      <GitHub />
-      {stars && <span>{stars}</span>}
-    </a>
-  );
-}