blodemd 0.0.8 → 0.0.10

package/docs/components/docs/copy-page-menu.tsx

@@ -11,12 +11,20 @@ import {
 import type React from "react";
 import { useCallback, useEffect, useRef, useState } from "react";
 
+import {
+  Popover,
+  PopoverContent,
+  PopoverTrigger,
+} from "@/components/ui/popover";
+
 interface CopyPageMenuProps {
   content?: string;
   contentUrl?: string;
   title: string;
 }
 
+type CopyStatus = "copied" | "error" | "idle";
+
 const LEADING_H1_REGEX = /^#\s+([^\r\n]+)(?:\r?\n(?:\r?\n)?)?/;
 
 const stripMatchingLeadingH1 = (source: string, title: string) => {
@@ -43,6 +51,37 @@ const formatMarkdownForCopy = (source: string, title: string) => {
   return `# ${title}\n\n${content}`;
 };
 
+const getCopyLabel = (copyStatus: CopyStatus) => {
+  switch (copyStatus) {
+    case "copied": {
+      return "Copied";
+    }
+    case "error": {
+      return "Copy failed";
+    }
+    default: {
+      return "Copy page";
+    }
+  }
+};
+
+const getCopyDescription = (copyStatus: CopyStatus) => {
+  switch (copyStatus) {
+    case "copied": {
+      return "Copied page markdown to clipboard";
+    }
+    case "error": {
+      return "Clipboard access was blocked or the page markdown could not be loaded";
+    }
+    default: {
+      return "Copy page as Markdown for LLMs";
+    }
+  }
+};
+
+const getCopyIcon = (copyStatus: CopyStatus) =>
+  copyStatus === "copied" ? Checkmark1Icon : CopySimpleIcon;
+
 const MenuItem = ({
   children,
   href,
@@ -50,11 +89,11 @@ const MenuItem = ({
 }: {
   children: React.ReactNode;
   href?: string;
-  onSelect?: () => void;
+  onSelect?: () => Promise<void> | void;
 }) =>
   href ? (
     <a
-      className="flex items-center gap-3 rounded-lg px-3 py-2.5 text-sm transition-colors hover:bg-secondary/25"
+      className="flex items-center gap-3 rounded-lg px-3 py-2.5 text-sm transition-colors hover:bg-secondary/25 focus-visible:bg-secondary/25 focus-visible:outline-none"
       href={href}
       onClick={onSelect}
       rel="noopener noreferrer"
@@ -64,7 +103,7 @@ const MenuItem = ({
     </a>
   ) : (
     <button
-      className="flex w-full items-center gap-3 rounded-lg px-3 py-2.5 text-left text-sm transition-colors hover:bg-secondary/25"
+      className="flex w-full items-center gap-3 rounded-lg px-3 py-2.5 text-left text-sm transition-colors hover:bg-secondary/25 focus-visible:bg-secondary/25 focus-visible:outline-none"
       onClick={onSelect}
       type="button"
     >
@@ -98,47 +137,48 @@ export const CopyPageMenu = ({
   contentUrl,
   title,
 }: CopyPageMenuProps) => {
-  const menuRef = useRef<HTMLDivElement>(null);
-  const [copied, setCopied] = useState(false);
+  const resetTimerRef = useRef<number | null>(null);
+  const [copyStatus, setCopyStatus] = useState<CopyStatus>("idle");
+  const [fetchedContent, setFetchedContent] = useState<string | null>(null);
   const [menuOpen, setMenuOpen] = useState(false);
   const [pageUrl, setPageUrl] = useState("");
-  const [resolvedContent, setResolvedContent] = useState(content ?? "");
-
-  useEffect(() => {
-    setPageUrl(window.location.href);
-  }, []);
-
-  useEffect(() => {
-    if (content !== undefined) {
-      setResolvedContent(content);
-    }
-  }, [content]);
-
-  useEffect(() => {
-    if (!menuOpen) {
-      return;
-    }
 
-    const handlePointerDown = (event: MouseEvent) => {
-      if (menuRef.current?.contains(event.target as Node)) {
-        return;
+  useEffect(
+    () => () => {
+      if (resetTimerRef.current !== null) {
+        window.clearTimeout(resetTimerRef.current);
       }
-      setMenuOpen(false);
-    };
+    },
+    []
+  );
 
-    document.addEventListener("mousedown", handlePointerDown);
-    return () => document.removeEventListener("mousedown", handlePointerDown);
-  }, [menuOpen]);
+  useEffect(() => {
+    setPageUrl(
+      new URL(contentUrl ?? window.location.href, window.location.href).href
+    );
+  }, [contentUrl]);
 
   const closeMenu = useCallback(() => {
     setMenuOpen(false);
   }, []);
 
-  const toggleMenu = useCallback(() => {
-    setMenuOpen((current) => !current);
-  }, []);
+  const setTemporaryCopyStatus = useCallback(
+    (nextStatus: "copied" | "error") => {
+      if (resetTimerRef.current !== null) {
+        window.clearTimeout(resetTimerRef.current);
+      }
+
+      setCopyStatus(nextStatus);
+      resetTimerRef.current = window.setTimeout(() => {
+        setCopyStatus("idle");
+        resetTimerRef.current = null;
+      }, 2000);
+    },
+    []
+  );
 
   const getContent = useCallback(async () => {
+    const resolvedContent = content ?? fetchedContent;
     if (resolvedContent) {
       return resolvedContent;
     }
@@ -157,68 +197,89 @@ export const CopyPageMenu = ({
     }
 
     const nextContent = await response.text();
-    setResolvedContent(nextContent);
+    setFetchedContent(nextContent);
     return nextContent;
-  }, [contentUrl, resolvedContent]);
+  }, [content, contentUrl, fetchedContent]);
 
   const handleCopy = useCallback(async () => {
-    const nextContent = await getContent();
-    const markdown = formatMarkdownForCopy(nextContent, title);
-    await navigator.clipboard.writeText(markdown);
-    setCopied(true);
-    closeMenu();
-    setTimeout(() => setCopied(false), 2000);
-  }, [closeMenu, getContent, title]);
+    try {
+      // iOS Safari loses the user gesture context after any async gap (e.g. a
+      // fetch). To keep clipboard access working, we call clipboard.write()
+      // synchronously within the gesture and pass a Promise to ClipboardItem
+      // so the content resolves later while the gesture context stays alive.
+      const blobPromise = (async () => {
+        const nextContent = await getContent();
+        const markdown = formatMarkdownForCopy(nextContent, title);
+        return new Blob([markdown], { type: "text/plain" });
+      })();
+
+      if (typeof ClipboardItem === "undefined") {
+        const blob = await blobPromise;
+        await navigator.clipboard.writeText(await blob.text());
+      } else {
+        await navigator.clipboard.write([
+          new ClipboardItem({ "text/plain": blobPromise }),
+        ]);
+      }
+
+      setTemporaryCopyStatus("copied");
+      closeMenu();
+    } catch {
+      setTemporaryCopyStatus("error");
+    }
+  }, [closeMenu, getContent, setTemporaryCopyStatus, title]);
 
   const chatgptUrl = pageUrl
     ? `https://chatgpt.com/?hints=search&q=${encodeURIComponent(`Read from ${pageUrl} so I can ask questions about it.`)}`
-    : "#";
+    : undefined;
   const claudeUrl = pageUrl
     ? `https://claude.ai/new?q=${encodeURIComponent(`Read from ${pageUrl} so I can ask questions about it.`)}`
-    : "#";
+    : undefined;
+  const copyLabel = getCopyLabel(copyStatus);
+  const copyDescription = getCopyDescription(copyStatus);
+  const CopyIcon = getCopyIcon(copyStatus);
 
   return (
-    <div className="relative flex shrink-0 items-center" ref={menuRef}>
-      <button
-        className="inline-flex items-center gap-2 rounded-l-xl border border-r-0 border-border px-3 py-1.5 text-sm font-medium transition-colors hover:bg-secondary/25"
-        onClick={handleCopy}
-        type="button"
-      >
-        {copied ? (
-          <Checkmark1Icon aria-hidden="true" className="size-[18px]" />
-        ) : (
-          <CopySimpleIcon aria-hidden="true" className="size-[18px]" />
-        )}
-        <span>{copied ? "Copied" : "Copy page"}</span>
-      </button>
-
-      <button
-        aria-expanded={menuOpen}
-        aria-label="More actions"
-        className="inline-flex items-center self-stretch rounded-r-xl border border-border px-2 transition-colors hover:bg-secondary/25"
-        onClick={toggleMenu}
-        type="button"
-      >
-        <ChevronDownSmallIcon
-          aria-hidden="true"
-          className="size-[18px] text-muted-foreground"
-        />
-      </button>
-
-      {menuOpen ? (
-        <div className="absolute right-0 top-[calc(100%+0.25rem)] z-50 min-w-[280px] rounded-xl border border-border bg-background p-1 shadow-lg">
-          <MenuItem onSelect={handleCopy}>
-            <MenuIcon>
-              <CopySimpleIcon aria-hidden="true" className="size-[18px]" />
-            </MenuIcon>
-            <div>
-              <div className="font-medium">Copy page</div>
-              <div className="text-xs text-muted-foreground">
-                Copy page as Markdown for LLMs
-              </div>
+    <Popover onOpenChange={setMenuOpen} open={menuOpen}>
+      <div className="flex shrink-0 items-center">
+        <button
+          className="inline-flex items-center gap-2 rounded-l-xl border border-r-0 border-border px-3 py-1.5 text-sm font-medium transition-colors hover:bg-secondary/25"
+          onClick={handleCopy}
+          type="button"
+        >
+          <CopyIcon aria-hidden="true" className="size-[18px]" />
+          <span>{copyLabel}</span>
+        </button>
+
+        <PopoverTrigger asChild>
+          <button
+            aria-expanded={menuOpen}
+            aria-label="More actions"
+            className="inline-flex items-center self-stretch rounded-r-xl border border-border px-2 transition-colors hover:bg-secondary/25"
+            type="button"
+          >
+            <ChevronDownSmallIcon
+              aria-hidden="true"
+              className="size-[18px] text-muted-foreground"
+            />
+          </button>
+        </PopoverTrigger>
+      </div>
+
+      <PopoverContent align="end" className="w-[280px] rounded-xl p-1">
+        <MenuItem onSelect={handleCopy}>
+          <MenuIcon>
+            <CopyIcon aria-hidden="true" className="size-[18px]" />
+          </MenuIcon>
+          <div>
+            <div className="font-medium">{copyLabel}</div>
+            <div className="text-xs text-muted-foreground">
+              {copyDescription}
             </div>
-          </MenuItem>
+          </div>
+        </MenuItem>
 
+        {chatgptUrl ? (
           <MenuItem href={chatgptUrl} onSelect={closeMenu}>
             <MenuIcon>
               <OpenaiIcon aria-hidden="true" className="size-[18px]" />
@@ -233,7 +294,9 @@ export const CopyPageMenu = ({
               </div>
             </div>
           </MenuItem>
+        ) : null}
 
+        {claudeUrl ? (
           <MenuItem href={claudeUrl} onSelect={closeMenu}>
             <MenuIcon>
               <ClaudeaiIcon aria-hidden="true" className="size-[18px]" />
@@ -248,8 +311,8 @@ export const CopyPageMenu = ({
               </div>
             </div>
           </MenuItem>
-        </div>
-      ) : null}
-    </div>
+        ) : null}
+      </PopoverContent>
+    </Popover>
   );
 };

package/docs/components/docs/doc-header.tsx

@@ -9,6 +9,8 @@ import type { NavEntry, NavTab } from "@/lib/navigation";
 import { isExternalHref, resolveHref, toDocHref } from "@/lib/routes";
 import { cn } from "@/lib/utils";
 
+const EMPTY_NAV: NavEntry[] = [];
+
 const Dropdown = ({
   label,
   items,
@@ -102,7 +104,7 @@ export const DocHeader = ({
   basePath,
   tabs,
   activeTabIndex,
-  nav = [],
+  nav = EMPTY_NAV,
 }: {
   config: SiteConfig;
   basePath: string;
@@ -117,6 +119,10 @@ export const DocHeader = ({
   const [primaryLanguage] = languages;
   const searchDisabled = config.features?.search === false;
   const themeToggleDisabled = config.features?.themeToggle === false;
+  const logoHref = config.logo?.href ?? toDocHref("index", basePath);
+  const logoIsExternal = Boolean(
+    config.logo?.href && isExternalHref(config.logo.href)
+  );
 
   return (
     <header className="sticky top-0 z-50 w-full bg-background">
@@ -132,7 +138,9 @@ export const DocHeader = ({
           />
           <Link
             className="flex items-center gap-2.5"
-            href={toDocHref("index", basePath)}
+            href={logoHref}
+            rel={logoIsExternal ? "noopener noreferrer" : undefined}
+            target={logoIsExternal ? "_blank" : undefined}
           >
             {config.logo?.light ? (
               <Image
@@ -186,7 +194,9 @@ export const DocHeader = ({
             ))}
           </nav>
           <div className="ml-auto flex items-center gap-2 md:flex-1 md:justify-end">
-            {searchDisabled ? null : <Search basePath={basePath} />}
+            {searchDisabled ? null : (
+              <Search basePath={basePath} key={basePath} />
+            )}
             {primaryVersion ? (
               <Dropdown
                 basePath={basePath}

package/docs/components/docs/doc-shell.tsx

@@ -27,13 +27,21 @@ import { themeStylesFromConfig } from "@/lib/theme";
 import type { TocItem } from "@/lib/toc";
 import { cn } from "@/lib/utils";
 
-const renderScripts = (
-  scripts?: string[],
-  strategy: "afterInteractive" | "lazyOnload" = "afterInteractive"
-) =>
-  scripts?.map((script) => (
+const DocScripts = ({
+  scripts,
+  strategy = "afterInteractive",
+}: {
+  scripts?: string[];
+  strategy?: "afterInteractive" | "lazyOnload";
+}) => {
+  if (!scripts?.length) {
+    return null;
+  }
+
+  return scripts.map((script) => (
     <Script key={script} src={script} strategy={strategy} />
-  )) ?? null;
+  ));
+};
 
 const Breadcrumbs = ({
   basePath,
@@ -134,9 +142,10 @@ export const DocShell = ({
     (toc.length > 0 || (contextual && contextualDisplay === "toc"));
 
   const contextualTocItems =
-    contextual && contextualDisplay === "toc" && rawContent !== undefined ? (
+    contextual && contextualDisplay === "toc" ? (
       <ContextualTocItems
         content={rawContent}
+        key={`toc-${currentPath}`}
         options={contextual.options}
         pagePath={currentPath}
         title={pageTitle}
@@ -144,9 +153,10 @@ export const DocShell = ({
     ) : null;
 
   const headerContextualMenu =
-    contextual && contextualDisplay === "header" && rawContent !== undefined ? (
+    contextual && contextualDisplay === "header" ? (
       <ContextualMenu
         content={rawContent}
+        key={`header-${currentPath}`}
         options={contextual.options}
         pagePath={currentPath}
         title={pageTitle}
@@ -175,8 +185,8 @@ export const DocShell = ({
             <div className="flex flex-col gap-2">
               <Breadcrumbs basePath={basePath} breadcrumbs={breadcrumbs} />
               <div className="flex flex-col gap-2">
-                <div className="flex items-center justify-between md:items-start">
-                  <h1 className="scroll-m-24 text-3xl font-semibold tracking-tight sm:text-3xl">
+                <div className="flex flex-col items-start gap-3 sm:flex-row sm:justify-between">
+                  <h1 className="min-w-0 scroll-m-24 text-3xl font-semibold tracking-tight sm:text-3xl">
                     {pageTitle}
                     {deprecated ? (
                       <span className="ml-3 inline-flex translate-y-[-2px] items-center rounded-md bg-yellow-100 px-2 py-0.5 align-middle text-xs font-medium text-yellow-800 dark:bg-yellow-900/40 dark:text-yellow-300">
@@ -188,8 +198,9 @@ export const DocShell = ({
                     (rawContent === undefined &&
                     markdownHref === undefined ? null : (
                       <CopyPageMenu
-                        content={rawContent}
+                        content={markdownHref ? undefined : rawContent}
                         contentUrl={markdownHref}
+                        key={`copy-${currentPath}`}
                         title={pageTitle}
                       />
                     ))}
@@ -201,7 +212,7 @@ export const DocShell = ({
                 ) : null}
               </div>
             </div>
-            <div className="grid gap-4.5 leading-relaxed [&_blockquote]:border-l-3 [&_blockquote]:border-primary [&_blockquote]:pl-3.5 [&_blockquote]:text-muted-foreground [&_h2]:mt-10 [&_h2]:mb-3 [&_h2]:text-2xl [&_h2]:font-bold [&_h3]:mt-8 [&_h3]:mb-2 [&_h3]:text-[1.375rem] [&_h3]:font-semibold [&_h4]:mt-6 [&_h4]:mb-2 [&_h4]:text-base [&_h4]:font-semibold [&_ol]:list-decimal [&_ol]:pl-5 [&_table]:w-full [&_table]:border-collapse [&_table]:text-sm [&_td]:border-b [&_td]:border-border [&_td]:px-2.5 [&_td]:py-2 [&_td]:text-left [&_th]:border-b [&_th]:border-border [&_th]:px-2.5 [&_th]:py-2 [&_th]:text-left [&_ul]:list-disc [&_ul]:pl-5">
+            <div className="grid min-w-0 grid-cols-1 gap-4.5 leading-relaxed [&_blockquote]:border-l-3 [&_blockquote]:border-primary [&_blockquote]:pl-3.5 [&_blockquote]:text-muted-foreground [&_h2]:mt-10 [&_h2]:mb-3 [&_h2]:text-2xl [&_h2]:font-bold [&_h3]:mt-8 [&_h3]:mb-2 [&_h3]:text-[1.375rem] [&_h3]:font-semibold [&_h4]:mt-6 [&_h4]:mb-2 [&_h4]:text-base [&_h4]:font-semibold [&_ol]:list-decimal [&_ol]:pl-6 [&_table]:w-full [&_table]:border-collapse [&_table]:text-sm [&_td]:border-b [&_td]:border-border [&_td]:px-2.5 [&_td]:py-2 [&_td]:text-left [&_th]:border-b [&_th]:border-border [&_th]:px-2.5 [&_th]:py-2 [&_th]:text-left [&_ul]:list-disc [&_ul]:pl-6">
               {content}
             </div>
             {!hideFooterPagination && (prevPage || nextPage) ? (
@@ -275,7 +286,7 @@ export const DocShell = ({
       >
         Skip to content
       </a>
-      {renderScripts(config.scripts?.head)}
+      <DocScripts scripts={config.scripts?.head} />
       <DocHeader
         activeTabIndex={activeTabIndex}
         basePath={basePath}
@@ -307,7 +318,7 @@ export const DocShell = ({
           </div>
         )}
       </div>
-      {renderScripts(config.scripts?.body, "lazyOnload")}
+      <DocScripts scripts={config.scripts?.body} strategy="lazyOnload" />
     </div>
   );
 };

package/docs/components/docs/mobile-nav.tsx

@@ -108,9 +108,6 @@ export const MobileNav = ({
             </div>
             <span className="sr-only">Toggle Menu</span>
           </div>
-          <span className="flex h-8 items-center text-lg font-medium leading-none">
-            Menu
-          </span>
         </Button>
       </PopoverTrigger>
       <PopoverContent
@@ -164,9 +161,6 @@ export const MobileNav = ({
           ) : null}
           {globalLinks.length > 0 ? (
             <div className="flex flex-col gap-4">
-              <div className="text-sm font-medium text-muted-foreground">
-                Menu
-              </div>
               <div className="flex flex-col gap-3">
                 {globalLinks.map((link) => (
                   <MobileLink