@barodoc/theme-docs 6.1.0 → 7.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barodoc/theme-docs",
-  "version": "6.1.0",
+  "version": "7.0.0",
   "description": "Documentation theme for Barodoc",
   "type": "module",
   "exports": {
@@ -34,7 +34,7 @@
     "rehype-katex": "^7.0.1",
     "remark-math": "^6.0.0",
     "tailwind-merge": "^3.4.0",
-    "@barodoc/core": "6.0.0"
+    "@barodoc/core": "7.0.0"
   },
   "peerDependencies": {
     "astro": "^5.0.0",

package/src/components/Contributors.astro

@@ -27,11 +27,21 @@ if (filePath) {
       for (const line of raw.split("\n")) {
         const [name, email] = line.split("|");
         if (!name || seen.has(email)) continue;
-        const hash = email.trim().toLowerCase();
-        seen.set(email, {
-          name: name.trim(),
-          email: email.trim(),
-          avatarUrl: `https://gravatar.com/avatar/${await computeHash(hash)}?s=64&d=mp`,
+
+        const trimmedEmail = email.trim();
+        const trimmedName = name.trim();
+
+        const noreplyMatch = trimmedEmail.match(
+          /^(\d+\+)?([^@]+)@users\.noreply\.github\.com$/
+        );
+        const avatarUrl = noreplyMatch
+          ? `https://github.com/${noreplyMatch[2]}.png?size=64`
+          : `https://gravatar.com/avatar/${await computeHash(trimmedEmail.toLowerCase())}?s=64&d=mp`;
+
+        seen.set(trimmedEmail, {
+          name: trimmedName,
+          email: trimmedEmail,
+          avatarUrl,
         });
       }
       contributors = Array.from(seen.values());
@@ -55,17 +65,23 @@ async function computeHash(input: string): Promise<string> {
   <div class="bd-contributors">
     <span class="bd-contributors-label">Contributors</span>
     <div class="bd-contributors-avatars">
-      {contributors.map((c) => (
-        <img
-          src={c.avatarUrl}
-          alt={c.name}
-          title={c.name}
-          class="bd-contributor-avatar"
-          loading="lazy"
-          width="28"
-          height="28"
-        />
-      ))}
+      <img
+        src={contributors[0].avatarUrl}
+        alt={contributors[0].name}
+        title={contributors[0].name}
+        class="bd-contributor-avatar"
+        loading="lazy"
+        width="28"
+        height="28"
+      />
+      {contributors.length > 1 && (
+        <span
+          class="bd-contributor-count"
+          title={contributors.slice(1).map((c) => c.name).join(", ")}
+        >
+          +{contributors.length - 1}
+        </span>
+      )}
     </div>
   </div>
 )}

package/src/components/DocHeader.tsx

@@ -10,9 +10,15 @@ import {
 } from "./ui/tooltip";
 import { cn } from "../lib/utils";
 
+interface TabItem {
+  label: string;
+  href: string;
+}
+
 interface DocHeaderProps {
   siteName: string;
   logo?: string;
+  tabs?: TabItem[];
   githubUrl?: string;
   hasMultipleLocales?: boolean;
   currentLocale?: string;
@@ -46,6 +52,7 @@ function getLocalizedUrl(
 export function DocHeader({
   siteName,
   logo,
+  tabs = [],
   githubUrl,
   hasMultipleLocales,
   currentLocale = "en",
@@ -92,7 +99,7 @@ export function DocHeader({
     <TooltipProvider>
       <header className="sticky top-0 z-50 w-full min-w-0 border-b border-[var(--bd-border)] bg-[var(--bd-bg)]/95 backdrop-blur-md supports-[backdrop-filter]:bg-[var(--bd-bg)]/80">
         <div className="flex h-14 items-center justify-between gap-2 px-4 sm:px-6 max-w-[1280px] mx-auto min-w-0">
-          {/* Logo */}
+          {/* Logo + Tabs */}
           <div className="flex items-center gap-6 min-w-0 shrink">
             <a
               href="/"
@@ -101,6 +108,27 @@ export function DocHeader({
               {logo && <img src={logo} alt={siteName} className="h-7 w-7 shrink-0" />}
               <span className="text-[15px] tracking-tight truncate">{siteName}</span>
             </a>
+            {tabs.length > 0 && (
+              <nav className="hidden md:flex items-center gap-1">
+                {tabs.map((tab) => {
+                  const isActive = currentPath === tab.href || currentPath.startsWith(tab.href + "/");
+                  return (
+                    <a
+                      key={tab.href}
+                      href={tab.href}
+                      className={cn(
+                        "px-3 py-1.5 text-[13px] font-medium rounded-lg transition-colors",
+                        isActive
+                          ? "text-primary-600 dark:text-primary-400 bg-primary-50 dark:bg-primary-950/50"
+                          : "text-[var(--bd-text-secondary)] hover:text-[var(--bd-text)] hover:bg-[var(--bd-bg-subtle)]"
+                      )}
+                    >
+                      {tab.label}
+                    </a>
+                  );
+                })}
+              </nav>
+            )}
           </div>
 
           {/* Right side actions */}

package/src/components/Header.astro

@@ -18,6 +18,7 @@ const localeLabels: Record<string, string> = config.i18n?.labels || {};
   client:load
   siteName={config.name}
   logo={config.logo}
+  tabs={config.tabs}
   githubUrl={config.topbar?.github}
   hasMultipleLocales={hasMultipleLocales}
   currentLocale={currentLocale}

package/src/components/MobileNav.astro

@@ -58,4 +58,6 @@ const groups = config.navigation.map((group) => ({
   groups={groups} 
   siteName={config.name}
   logo={config.logo}
+  tabs={config.tabs}
+  currentPath={currentPath}
 />

package/src/components/MobileNavSheet.tsx

@@ -21,13 +21,20 @@ interface NavGroup {
   defaultOpen?: boolean;
 }
 
+interface TabItem {
+  label: string;
+  href: string;
+}
+
 interface MobileNavSheetProps {
   groups: NavGroup[];
   siteName: string;
   logo?: string;
+  tabs?: TabItem[];
+  currentPath?: string;
 }
 
-export function MobileNavSheet({ groups, siteName, logo }: MobileNavSheetProps) {
+export function MobileNavSheet({ groups, siteName, logo, tabs = [], currentPath = "" }: MobileNavSheetProps) {
   const [open, setOpen] = React.useState(false);
 
   React.useEffect(() => {
@@ -61,6 +68,27 @@ export function MobileNavSheet({ groups, siteName, logo }: MobileNavSheetProps)
           </SheetTitle>
         </SheetHeader>
         <ScrollArea className="h-[calc(100vh-65px)]">
+          {tabs.length > 0 && (
+            <div className="px-4 pt-4 pb-2 flex flex-col gap-1 border-b border-[var(--bd-border)]">
+              {tabs.map((tab) => {
+                const isActive = currentPath === tab.href || currentPath.startsWith(tab.href + "/");
+                return (
+                  <a
+                    key={tab.href}
+                    href={tab.href}
+                    className={cn(
+                      "px-3 py-2 text-sm font-medium rounded-lg transition-colors",
+                      isActive
+                        ? "text-primary-600 dark:text-primary-400 bg-primary-50 dark:bg-primary-950/50"
+                        : "text-[var(--bd-text-secondary)] hover:text-[var(--bd-text)] hover:bg-[var(--bd-bg-subtle)]"
+                    )}
+                  >
+                    {tab.label}
+                  </a>
+                );
+              })}
+            </div>
+          )}
           <div className="px-2 py-4">
             <DocsSidebar groups={groups} />
           </div>

package/src/layouts/BlogLayout.astro

@@ -2,6 +2,7 @@
 import BaseLayout from "./BaseLayout.astro";
 import Header from "../components/Header.astro";
 import Banner from "../components/Banner.astro";
+import CodeCopy from "../components/CodeCopy.astro";
 import { defaultLocale } from "virtual:barodoc/i18n";
 import { getLocaleFromPath } from "@barodoc/core";
 
@@ -10,12 +11,13 @@ interface Props {
   description?: string;
   date?: Date;
   author?: string;
+  avatar?: string;
   image?: string;
   tags?: string[];
   readingTime?: string;
 }
 
-const { title, description, date, author, image, tags = [], readingTime } = Astro.props;
+const { title, description, date, author, avatar, image, tags = [], readingTime } = Astro.props;
 const currentPath = Astro.url.pathname;
 const i18nConfig = { defaultLocale, locales: [defaultLocale] };
 const currentLocale = getLocaleFromPath(currentPath, i18nConfig);
@@ -47,7 +49,18 @@ const currentLocale = getLocaleFromPath(currentPath, i18nConfig);
           </p>
         )}
         <div class="mt-4 flex items-center gap-3 text-sm text-[var(--bd-text-muted)]">
-          {author && <span>{author}</span>}
+          {author && (
+            <span class="flex items-center gap-2">
+              {avatar && (
+                <img
+                  src={avatar}
+                  alt={author}
+                  class="w-6 h-6 rounded-full object-cover ring-1 ring-[var(--bd-border)]"
+                />
+              )}
+              <span>{author}</span>
+            </span>
+          )}
           {author && date && <span class="text-[var(--bd-border)]">&middot;</span>}
           {date && (
             <time datetime={date.toISOString()}>
@@ -75,6 +88,7 @@ const currentLocale = getLocaleFromPath(currentPath, i18nConfig);
       <div class="prose prose-gray dark:prose-invert max-w-none">
         <slot />
       </div>
+      <CodeCopy />
 
       <!-- Back to blog -->
       <div class="mt-12 pt-8 border-t border-[var(--bd-border)]">

package/src/pages/blog/[...slug].astro

@@ -31,6 +31,7 @@ const readTime = readingTime(post.body ?? "");
   description={post.data.description || post.data.excerpt}
   date={post.data.date ? new Date(post.data.date) : undefined}
   author={post.data.author}
+  avatar={post.data.avatar}
   image={post.data.image}
   tags={post.data.tags}
   readingTime={readTime.text}

package/src/pages/blog/index.astro

@@ -74,7 +74,18 @@ const sortedPosts = posts.sort((a, b) => {
                   </p>
                 )}
                 <div class="mt-auto pt-2 flex items-center gap-2 text-xs text-[var(--bd-text-muted)]">
-                  {post.data.author && <span>{post.data.author}</span>}
+                  {post.data.author && (
+                    <span class="flex items-center gap-1.5">
+                      {post.data.avatar && (
+                        <img
+                          src={post.data.avatar}
+                          alt={post.data.author}
+                          class="w-4 h-4 rounded-full object-cover"
+                        />
+                      )}
+                      <span>{post.data.author}</span>
+                    </span>
+                  )}
                   {post.data.author && post.data.date && <span>&middot;</span>}
                   {post.data.date && (
                     <time datetime={new Date(post.data.date).toISOString()}>

package/src/pages/docs/[...slug].astro

@@ -125,7 +125,7 @@ breadcrumbs.push({ label: doc.data.title });
   lastUpdated={lastUpdated}
   breadcrumbs={breadcrumbs}
   readingTime={readTime.text}
-  filePath={doc.id}
+  filePath={`src/content/docs/${doc.id}`}
 >
   {category && (
     <p class="text-xs font-semibold uppercase tracking-widest text-primary-600 dark:text-primary-400 mb-3">

package/src/pages/index.astro

@@ -43,10 +43,24 @@ const features = [
     <header class="sticky top-0 z-50 border-b border-[var(--bd-border)] bg-[var(--bd-bg)]/95 backdrop-blur-md">
       <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
         <div class="flex h-16 items-center justify-between">
-          <a href="/" class="flex items-center gap-2.5 font-semibold text-[var(--bd-text)]">
-            {config.logo && <img src={config.logo} alt={config.name} class="h-7 w-7" />}
-            <span class="text-lg">{config.name}</span>
-          </a>
+          <div class="flex items-center gap-6">
+            <a href="/" class="flex items-center gap-2.5 font-semibold text-[var(--bd-text)]">
+              {config.logo && <img src={config.logo} alt={config.name} class="h-7 w-7" />}
+              <span class="text-lg">{config.name}</span>
+            </a>
+            {config.tabs && config.tabs.length > 0 && (
+              <nav class="hidden md:flex items-center gap-1">
+                {config.tabs.map((tab: { label: string; href: string }) => (
+                  <a
+                    href={tab.href}
+                    class="px-3 py-1.5 text-sm font-medium rounded-lg text-[var(--bd-text-secondary)] hover:text-[var(--bd-text)] hover:bg-[var(--bd-bg-subtle)] transition-colors"
+                  >
+                    {tab.label}
+                  </a>
+                ))}
+              </nav>
+            )}
+          </div>
           <div class="flex items-center gap-2">
             {config.topbar?.github && (
               <a

package/src/styles/global.css

@@ -983,6 +983,22 @@
   margin-left: 0;
 }
 
+.bd-contributor-count {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 1.75rem;
+  height: 1.75rem;
+  border-radius: 9999px;
+  border: 2px solid var(--bd-bg);
+  margin-left: -0.375rem;
+  background: var(--bd-bg-subtle);
+  color: var(--bd-text-muted);
+  font-size: 0.6875rem;
+  font-weight: 600;
+  cursor: default;
+}
+
 /* ==========================================================================
    Version Switcher
    ========================================================================== */