blodemd 0.0.12 → 0.0.14

package/docs/app/globals.css

@@ -212,7 +212,7 @@
   }
 
   html {
-    @apply overscroll-y-none scroll-smooth;
+    @apply scroll-smooth;
   }
 
   html.dark {

package/docs/components/api/api-playground.tsx

@@ -7,7 +7,6 @@ import { Button } from "@/components/ui/button";
 import { Field, FieldLabel } from "@/components/ui/field";
 import { Input } from "@/components/ui/input";
 import type { OpenApiEntry } from "@/lib/openapi";
-import { TENANT_HEADERS } from "@/lib/tenant-headers";
 
 interface OperationParameter {
   description?: string;
@@ -321,15 +320,13 @@ export const ApiPlayground = ({
         headers: requestHeaders,
         method,
         url,
+        ...(tenantSlug ? { tenantSlug } : {}),
       };
 
       const requestUrl = useProxy ? proxyPath : url;
       const requestMethod = useProxy ? "POST" : method;
       const requestHeadersToSend = useProxy
-        ? {
-            "Content-Type": "application/json",
-            ...(tenantSlug ? { [TENANT_HEADERS.SLUG]: tenantSlug } : {}),
-          }
+        ? { "Content-Type": "application/json" }
         : requestHeaders;
 
       let requestBody: string | undefined;

package/docs/components/api/api-reference.tsx

@@ -92,9 +92,35 @@ export const ApiReference = ({
       {requestBody?.content ? (
         <section className="mt-7 grid gap-3">
           <h2>Request Body</h2>
-          <pre className="overflow-x-auto rounded-lg bg-code p-3 text-code-foreground">
-            {JSON.stringify(requestBody.content, null, 2)}
-          </pre>
+          <div className="grid gap-2">
+            {Object.entries(requestBody.content).map(([mediaType, value]) => {
+              const { schema } = value as { schema?: unknown };
+              const ref =
+                schema &&
+                typeof schema === "object" &&
+                "$ref" in schema &&
+                typeof (schema as { $ref?: unknown }).$ref === "string"
+                  ? ((schema as { $ref: string }).$ref.split("/").pop() ??
+                    "object")
+                  : null;
+              const type =
+                schema &&
+                typeof schema === "object" &&
+                "type" in schema &&
+                typeof (schema as { type?: unknown }).type === "string"
+                  ? (schema as { type: string }).type
+                  : "object";
+              return (
+                <div
+                  className="flex justify-between rounded-lg border border-border bg-background/60 p-2.5"
+                  key={mediaType}
+                >
+                  <span className="font-mono">{mediaType}</span>
+                  <span className="text-muted-foreground">{ref ?? type}</span>
+                </div>
+              );
+            })}
+          </div>
         </section>
       ) : null}
 

package/docs/components/docs/contextual-menu.tsx

@@ -414,39 +414,43 @@ export const ContextualMenu = ({
       </div>
 
       <PopoverContent align="end" className="w-[320px] rounded-xl p-1">
-        {resolved.slice(1).map((item) => {
-          const itemFeedback =
-            feedback?.id === item.key ? feedback.state : null;
-          const itemLabel = getFeedbackLabel(itemFeedback, item.title);
-          const itemDescription = getFeedbackDescription(
-            itemFeedback,
-            item.description
-          );
-          const ItemIcon = getFeedbackIcon(itemFeedback, item.icon);
-
-          return (
-            <MenuItem
-              href={item.type === "link" ? item.href : undefined}
-              key={item.key}
-              onSelect={
-                item.type === "action" ? actionHandlers[item.key] : closeMenu
-              }
-            >
-              <MenuIcon>
-                <ItemIcon aria-hidden="true" className="size-[18px]" />
-              </MenuIcon>
-              <div className="flex-1">
-                <div className="font-medium">
-                  {itemLabel}
-                  {item.type === "link" ? <ExternalArrow /> : null}
-                </div>
-                <div className="text-xs text-muted-foreground">
-                  {itemDescription}
-                </div>
-              </div>
-            </MenuItem>
-          );
-        })}
+        {menuOpen
+          ? resolved.slice(1).map((item) => {
+              const itemFeedback =
+                feedback?.id === item.key ? feedback.state : null;
+              const itemLabel = getFeedbackLabel(itemFeedback, item.title);
+              const itemDescription = getFeedbackDescription(
+                itemFeedback,
+                item.description
+              );
+              const ItemIcon = getFeedbackIcon(itemFeedback, item.icon);
+
+              return (
+                <MenuItem
+                  href={item.type === "link" ? item.href : undefined}
+                  key={item.key}
+                  onSelect={
+                    item.type === "action"
+                      ? actionHandlers[item.key]
+                      : closeMenu
+                  }
+                >
+                  <MenuIcon>
+                    <ItemIcon aria-hidden="true" className="size-[18px]" />
+                  </MenuIcon>
+                  <div className="flex-1">
+                    <div className="font-medium">
+                      {itemLabel}
+                      {item.type === "link" ? <ExternalArrow /> : null}
+                    </div>
+                    <div className="text-xs text-muted-foreground">
+                      {itemDescription}
+                    </div>
+                  </div>
+                </MenuItem>
+              );
+            })
+          : null}
       </PopoverContent>
     </Popover>
   );

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

@@ -6,6 +6,7 @@ import {
   ChevronDownSmallIcon,
   ClaudeaiIcon,
   CopySimpleIcon,
+  FileTextIcon,
   OpenaiIcon,
 } from "blode-icons-react";
 import type React from "react";
@@ -295,6 +296,23 @@ export const CopyPageMenu = ({
       </div>
 
       <PopoverContent align="end" className="w-[280px] rounded-xl p-1">
+        {contentUrl ? (
+          <MenuItem href={contentUrl} onSelect={closeMenu}>
+            <MenuIcon>
+              <FileTextIcon aria-hidden="true" className="size-[18px]" />
+            </MenuIcon>
+            <div className="flex-1">
+              <div className="font-medium">
+                View as markdown
+                <ExternalArrow />
+              </div>
+              <div className="text-xs text-muted-foreground">
+                Open the raw .md source in a new tab
+              </div>
+            </div>
+          </MenuItem>
+        ) : null}
+
         <MenuItem onSelect={handleCopy}>
           <MenuIcon>
             <CopyIcon aria-hidden="true" className="size-[18px]" />

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

@@ -125,7 +125,10 @@ export const DocHeader = ({
   );
 
   return (
-    <header className="sticky top-0 z-50 w-full bg-background">
+    <header
+      className="sticky top-0 z-50 w-full bg-background"
+      data-markdown-ignore=""
+    >
       <div className="container-wrapper px-4 lg:px-8">
         <div className="flex h-(--header-height) items-center">
           <MobileNav

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

@@ -100,6 +100,7 @@ export const DocShell = ({
   markdownHref,
   rawContent,
   tabs,
+  tenantSlug,
   mode,
   deprecated,
   hideFooterPagination,
@@ -120,6 +121,7 @@ export const DocShell = ({
   markdownHref?: string;
   rawContent?: string;
   tabs?: NavTab[] | null;
+  tenantSlug?: string;
   mode?: PageMode;
   deprecated?: boolean;
   hideFooterPagination?: boolean;
@@ -183,7 +185,26 @@ export const DocShell = ({
               )}
             >
               <div className="flex flex-col gap-2">
-                <Breadcrumbs basePath={basePath} breadcrumbs={breadcrumbs} />
+                <p
+                  className="sr-only"
+                  data-agent-directive=""
+                  data-markdown-ignore=""
+                >
+                  AI agents: fetch the documentation index at{" "}
+                  <Link href={toDocHref("llms.txt", basePath)}>llms.txt</Link>.
+                  Markdown versions are available by appending .md to any page
+                  URL
+                  {markdownHref ? (
+                    <>
+                      , including{" "}
+                      <Link href={markdownHref}>this page&apos;s markdown</Link>
+                    </>
+                  ) : null}
+                  .
+                </p>
+                <div data-markdown-ignore="">
+                  <Breadcrumbs basePath={basePath} breadcrumbs={breadcrumbs} />
+                </div>
                 <div className="flex flex-col gap-2">
                   <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">
@@ -194,16 +215,18 @@ export const DocShell = ({
                         </span>
                       ) : null}
                     </h1>
-                    {headerContextualMenu ??
-                      (rawContent === undefined &&
-                      markdownHref === undefined ? null : (
-                        <CopyPageMenu
-                          content={markdownHref ? undefined : rawContent}
-                          contentUrl={markdownHref}
-                          key={`copy-${currentPath}`}
-                          title={pageTitle}
-                        />
-                      ))}
+                    <div data-markdown-ignore="">
+                      {headerContextualMenu ??
+                        (rawContent === undefined &&
+                        markdownHref === undefined ? null : (
+                          <CopyPageMenu
+                            content={markdownHref ? undefined : rawContent}
+                            contentUrl={markdownHref}
+                            key={`copy-${currentPath}`}
+                            title={pageTitle}
+                          />
+                        ))}
+                    </div>
                   </div>
                   {pageDescription ? (
                     <p className="text-[1.05rem] text-muted-foreground sm:text-balance sm:text-base md:max-w-[80%]">
@@ -218,6 +241,7 @@ export const DocShell = ({
               {!hideFooterPagination && (prevPage || nextPage) ? (
                 <nav
                   className="flex w-full rounded-2xl bg-muted/50 p-1 text-sm"
+                  data-markdown-ignore=""
                   id="pagination"
                 >
                   {prevPage ? (
@@ -283,6 +307,7 @@ export const DocShell = ({
     >
       <a
         className="sr-only focus:not-sr-only focus:fixed focus:left-4 focus:top-4 focus:z-[100] focus:rounded-md focus:bg-background focus:px-4 focus:py-2 focus:text-sm focus:font-medium focus:shadow-sm"
+        data-markdown-ignore=""
         href="#main-content"
       >
         Skip to content
@@ -305,13 +330,18 @@ export const DocShell = ({
               } as React.CSSProperties
             }
           >
-            <DocSidebar
-              anchors={anchors}
-              basePath={basePath}
-              currentPath={currentPath}
-              entries={nav}
-            />
-            {innerContent}
+            <div className="min-w-0 lg:col-start-2 lg:row-start-1">
+              {innerContent}
+            </div>
+            <div className="self-stretch lg:col-start-1 lg:row-start-1">
+              <DocSidebar
+                activeTabIndex={activeTabIndex ?? 0}
+                anchors={anchors}
+                basePath={basePath}
+                nav={nav}
+                tenantSlug={tenantSlug}
+              />
+            </div>
           </div>
         ) : (
           <div className="min-h-min flex-1 items-start px-0 [--top-spacing:0] lg:[--top-spacing:calc(var(--spacing)*4)]">

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

@@ -1,9 +1,10 @@
-import { normalizePath } from "@repo/common";
 import { ArrowUpRightIcon } from "blode-icons-react";
 import Image from "next/image";
 import Link from "next/link";
 
+import { SidebarActiveHighlight } from "@/components/docs/sidebar-active-highlight";
 import { DocIcon } from "@/components/icons/doc-icon";
+import { getTenantSidebarData } from "@/lib/docs-runtime";
 import { getNavPageHref, getNavPageTitle } from "@/lib/navigation";
 import type { NavEntry, NavPage } from "@/lib/navigation";
 import { isExternalHref, toDocHref } from "@/lib/routes";
@@ -39,11 +40,9 @@ const NavIcon = ({ icon }: { icon: string }) => {
 const NavPageLink = ({
   item,
   basePath,
-  isActive,
 }: {
   item: NavPage;
   basePath: string;
-  isActive: boolean;
 }) => {
   const displayTitle = getNavPageTitle(item);
   const href = getNavPageHref(item, basePath);
@@ -74,16 +73,11 @@ const NavPageLink = ({
     </>
   );
 
-  const className = cn(
-    MENU_BUTTON_CLASS,
-    isActive && "border-accent bg-accent text-foreground"
-  );
-
   if (isExternal) {
     return (
       <a
-        className={className}
-        data-active={isActive || undefined}
+        className={MENU_BUTTON_CLASS}
+        data-sidebar-link=""
         href={href}
         rel="noopener noreferrer"
         target="_blank"
@@ -94,7 +88,12 @@ const NavPageLink = ({
   }
 
   return (
-    <Link className={className} data-active={isActive || undefined} href={href}>
+    <Link
+      className={MENU_BUTTON_CLASS}
+      data-path={item.path}
+      data-sidebar-link=""
+      href={href}
+    >
       {linkContent}
     </Link>
   );
@@ -124,91 +123,134 @@ const Section = ({
   </section>
 );
 
-export const DocSidebar = ({
-  entries,
-  currentPath,
+const renderSidebarTree = ({
   anchors,
   basePath,
+  entries,
 }: {
+  anchors: { label: string; href: string }[];
+  basePath: string;
   entries: NavEntry[];
-  currentPath: string;
+}) => (
+  <>
+    {anchors.length ? (
+      <Section paddedTop title="Pinned">
+        <ul className="space-y-1">
+          {anchors.map((anchor) => (
+            <li key={anchor.href}>
+              <a
+                className={cn(MENU_BUTTON_CLASS, "text-foreground")}
+                href={
+                  anchor.href.startsWith("http")
+                    ? anchor.href
+                    : toDocHref(anchor.href, basePath)
+                }
+              >
+                {anchor.label}
+              </a>
+            </li>
+          ))}
+        </ul>
+      </Section>
+    ) : null}
+    {entries.map((entry, index) => {
+      if (entry.type === "page") {
+        return (
+          <Section key={entry.path} paddedTop={index === 0 && !anchors.length}>
+            <ul>
+              <li>
+                <NavPageLink basePath={basePath} item={entry} />
+              </li>
+            </ul>
+          </Section>
+        );
+      }
+
+      return (
+        <Section
+          key={entry.title}
+          paddedTop={index === 0 && !anchors.length}
+          title={entry.title}
+        >
+          <ul className="space-y-0.5">
+            {entry.items.map((item) => (
+              <li key={item.path}>
+                <NavPageLink basePath={basePath} item={item} />
+              </li>
+            ))}
+          </ul>
+        </Section>
+      );
+    })}
+  </>
+);
+
+const CachedSidebarTree = async ({
+  activeTabIndex,
+  anchors,
+  basePath,
+  entries,
+  tenantSlug,
+}: {
+  activeTabIndex: number;
   anchors?: { label: string; href: string }[];
   basePath: string;
+  entries?: NavEntry[];
+  tenantSlug?: string;
 }) => {
-  const activePath = normalizePath(currentPath);
-  const isActive = (path: string) => normalizePath(path) === activePath;
+  if (tenantSlug) {
+    const data = await getTenantSidebarData(tenantSlug, activeTabIndex);
+    if (data) {
+      return renderSidebarTree({
+        anchors: data.anchors,
+        basePath,
+        entries: data.entries,
+      });
+    }
+  }
 
-  return (
-    <aside
-      className="sticky top-[calc(var(--header-height)+0.6rem)] z-30 hidden h-[calc(100svh-10rem)] w-[calc(var(--spacing)*56)] shrink-0 flex-col overscroll-none bg-transparent lg:flex"
-      aria-label="Documentation navigation"
-    >
-      <div className="h-9" />
-      <div className="absolute top-8 z-10 h-8 w-full shrink-0 bg-gradient-to-b from-background via-background/80 to-background/50 blur-xs" />
-      <div className="absolute top-12 right-2 bottom-0 hidden h-full w-px bg-gradient-to-b from-transparent via-border to-transparent lg:flex" />
-      <SidebarScrollArea className="no-scrollbar mx-auto flex min-h-0 w-full flex-1 flex-col gap-2 overflow-y-auto overflow-x-hidden px-2">
-        {anchors?.length ? (
-          <Section paddedTop title="Pinned">
-            <ul className="space-y-1">
-              {anchors.map((anchor) => (
-                <li key={anchor.href}>
-                  <a
-                    className={cn(MENU_BUTTON_CLASS, "text-foreground")}
-                    href={
-                      anchor.href.startsWith("http")
-                        ? anchor.href
-                        : toDocHref(anchor.href, basePath)
-                    }
-                  >
-                    {anchor.label}
-                  </a>
-                </li>
-              ))}
-            </ul>
-          </Section>
-        ) : null}
-        {entries.map((entry, index) => {
-          if (entry.type === "page") {
-            return (
-              <Section
-                key={entry.path}
-                paddedTop={index === 0 && !anchors?.length}
-              >
-                <ul>
-                  <li>
-                    <NavPageLink
-                      basePath={basePath}
-                      isActive={isActive(entry.path)}
-                      item={entry}
-                    />
-                  </li>
-                </ul>
-              </Section>
-            );
-          }
+  if (!entries || entries.length === 0) {
+    return null;
+  }
 
-          return (
-            <Section
-              key={entry.title}
-              paddedTop={index === 0 && !anchors?.length}
-              title={entry.title}
-            >
-              <ul className="space-y-0.5">
-                {entry.items.map((item) => (
-                  <li key={item.path}>
-                    <NavPageLink
-                      basePath={basePath}
-                      isActive={isActive(item.path)}
-                      item={item}
-                    />
-                  </li>
-                ))}
-              </ul>
-            </Section>
-          );
-        })}
-        <div className="sticky -bottom-1 z-10 h-16 shrink-0 bg-gradient-to-t from-background via-background/80 to-background/50 blur-xs" />
-      </SidebarScrollArea>
-    </aside>
-  );
+  return renderSidebarTree({
+    anchors: anchors ?? [],
+    basePath,
+    entries,
+  });
 };
+
+export const DocSidebar = ({
+  activeTabIndex,
+  anchors,
+  basePath,
+  nav,
+  tenantSlug,
+}: {
+  activeTabIndex: number;
+  anchors?: { label: string; href: string }[];
+  basePath: string;
+  nav?: NavEntry[];
+  tenantSlug?: string;
+}) => (
+  <aside
+    aria-label="Documentation navigation"
+    className="sticky top-[calc(var(--header-height)+0.6rem)] z-30 hidden h-[calc(100svh-10rem)] w-[calc(var(--spacing)*56)] shrink-0 flex-col overscroll-none bg-transparent lg:flex"
+    data-markdown-ignore=""
+  >
+    <div className="h-9" />
+    <div className="absolute top-8 z-10 h-8 w-full shrink-0 bg-gradient-to-b from-background via-background/80 to-background/50 blur-xs" />
+    <div className="absolute top-12 right-2 bottom-0 hidden h-full w-px bg-gradient-to-b from-transparent via-border to-transparent lg:flex" />
+    <SidebarScrollArea className="no-scrollbar mx-auto flex min-h-0 w-full flex-1 flex-col gap-2 overflow-y-auto overflow-x-hidden px-2">
+      <CachedSidebarTree
+        activeTabIndex={activeTabIndex}
+        anchors={anchors}
+        basePath={basePath}
+        entries={nav}
+        tenantSlug={tenantSlug}
+      />
+      <div className="sticky -bottom-1 z-10 h-16 shrink-0 bg-gradient-to-t from-background via-background/80 to-background/50 blur-xs" />
+    </SidebarScrollArea>
+    <SidebarActiveHighlight basePath={basePath} />
+  </aside>
+);

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

@@ -17,6 +17,7 @@ export const DocToc = ({
     <nav
       aria-label="Table of contents"
       className="sticky top-[calc(var(--header-height)+1px)] z-30 ml-auto hidden h-[90svh] w-(--sidebar-width) flex-col gap-4 overflow-hidden overscroll-none pb-8 xl:flex"
+      data-markdown-ignore=""
     >
       <div className="no-scrollbar flex flex-col gap-8 overflow-y-auto px-8">
         <div className="flex flex-col gap-2 p-4 pt-0 text-sm">