Files
christopherkindl 97c8060917 [docs] Sync docs with @vercel/geistdocs 1.2.0 + 1.2.1 (#364)
* Sync docs template with @vercel/geistdocs 1.2.0 + 1.2.1

Pulls in template updates via `@vercel/geistdocs@1.2.1 update --sync`:

- 1.2.0: new NavbarLogo (oss product switcher variant), geist theme
  tokens + icons, updated docs layout, MobileDocsBar, redesigned navbar
  and mobile menu
- 1.2.1: CommandPrompt UI component, IconCheck / IconCopy fallback
  icons, supporting CSS tokens and @utility rules (material-small,
  text-label-13, text-label-14-mono, text-label-16-mono,
  --ds-shadow-border-small light/dark)

Home page intentionally left untouched because flags-sdk uses a custom
home/[code] routing structure. package.json left untouched to preserve
workspace/catalog references and app-specific deps (flags,
@vercel/toolbar, newer Next).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Cap footer max-w and use LogoFlagsSdk in navbar

- Cap the footer inner row at max-w-[1448px] so it aligns with the
  navbar on very wide screens
- Render the Flags SDK wordmark (LogoFlagsSdk) directly in the navbar
  via the oss NavbarLogo trigger; drop the duplicate entry from the
  product switcher dropdown

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Use bg-background-200 for docs container

Matches the navbar background so docs pages (principles, frameworks,
providers, etc.) no longer sit on a lighter surface than the header.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Use CommandPrompt humans/agents switcher in hero CTA

Replaces the Get Started button + CopySnippet in the home hero with
the CommandPrompt switcher. Triggers and surface are aligned to the
left via `items-start` on the root so they line up with the hero
heading instead of being centered.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Use full npm install command in hero CommandPrompt

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Default hero CommandPrompt to the agents tab

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Bump navbar Flags SDK logo to height 22

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Use MobileDocsBar for docs mobile navigation

Disables the default Fumadocs TOC popover and renders the
MobileDocsBar (sidebar trigger + TOC sheet) above the docs title,
matching the geistdocs template.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Override fumadocs primary at :root so prose links render gray-1000

Matches the workflow docs tweak — broadens the fd-primary override
from #nd-toc to :root so in-content links pick up the design-system
foreground color instead of the default blue.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Use new --ds-shadow-menu on hero "Try the Flags SDK" card

- Update --ds-shadow-menu to the 4-layer geist menu shadow
- Apply it to the flags-toggle card via `shadow-(--ds-shadow-menu)`;
  drop the stock `shadow-md` and redundant border

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Use LogoFlagsSdk as the app Logo; add AI SDK to product switcher

- Replace the inline triangle SVG + "Flags SDK" text in geistdocs.tsx
  with `<LogoFlagsSdk height={22} />`, so navbar & template consumers
  get the real wordmark
- Revert navbar.tsx to import `Logo` from `@/geistdocs` (single source
  of truth) — the direct LogoFlagsSdk import is no longer needed
- Add `LogoAiSdk` to OSS_PRODUCT_LINKS at the top of the list
  (`ai-sdk.dev`)
- Give LogoAiSdk the same `color` prop pattern as the other SDK logos
- Formatter cleanup in app/[lang]/layout.tsx

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Restore FrameworkSwitcher and theme the Next.js icon

- Re-mount <FrameworkSwitcher /> at the top of the desktop sidebar and
  the mobile Sheet (lost during the 1.2.x template sync)
- Rewrite the Next.js icon to mirror LogoIconNextSvg from
  @vercel/geistcn-assets: circle uses currentColor + text-gray-1000 so
  it auto-inverts per theme; gradient stops for the "N" use
  var(--ds-background-100) so the highlight stays readable in light
  and dark

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Docs: active nav state, geist shadow, restored framework icon + TOC offset

- DesktopMenu: mark nav items active when pathname falls under the
  item's section (match on first three path segments, ignore locale
  prefix); add `data-[active]:text-gray-1000` to the selector
- CodeBlock: restore the `#next` / `#svelte` title-suffix parser so
  framework icons render in code block headers again
- FrameworkSwitcher: apply `--ds-shadow-menu` to the popover content
- geistdocs.css: push `#nd-toc` over with `md:pl-8`

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-17 19:18:06 +02:00

162 lines
4.3 KiB
TypeScript

"use client";
import { CheckIcon, CopyIcon } from "lucide-react";
import {
type CSSProperties,
type ReactNode,
useCallback,
useRef,
useState,
} from "react";
import { toast } from "sonner";
import { NextLogo } from "@/components/custom/logos/next";
import { SvelteKitLogo } from "@/components/custom/logos/sveltekit";
import { Button } from "@/components/ui/button";
import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
import { cn } from "@/lib/utils";
const FRAMEWORK_ICONS: Record<string, ReactNode> = {
next: <NextLogo className="dark:invert" />,
svelte: <SvelteKitLogo className="grayscale" />,
};
function parseFrameworkFromTitle(title: string): {
cleanTitle: string;
frameworkIcon: ReactNode | undefined;
} {
const match = title.match(/#(\w+)$/);
if (!match) return { cleanTitle: title, frameworkIcon: undefined };
return {
cleanTitle: title.slice(0, -match[0].length),
frameworkIcon: FRAMEWORK_ICONS[match[1]],
};
}
interface CodeBlockProps {
children: ReactNode;
className?: string;
"data-line-highlighting"?: string;
"data-line-numbers"?: string;
icon?: ReactNode;
style?: CSSProperties;
tabIndex?: number;
title?: string;
}
export const CodeBlock = ({
children,
className,
icon,
style,
tabIndex,
title,
...rest
}: CodeBlockProps) => {
const ref = useRef<HTMLPreElement>(null);
const [isCopied, setIsCopied] = useState(false);
const { "data-line-numbers": lineNumbers } = rest;
const copyToClipboard = useCallback(async () => {
if (typeof window === "undefined" || !navigator?.clipboard?.writeText) {
toast.error("Clipboard API not available");
return;
}
const code = ref.current?.innerText;
if (!code) {
toast.error("No code to copy");
return;
}
try {
await navigator.clipboard.writeText(code);
setIsCopied(true);
setTimeout(() => setIsCopied(false), 2000);
} catch (error) {
const message = error instanceof Error ? error.message : "Unknown error";
toast.error(message);
}
}, []);
const Icon = isCopied ? CheckIcon : CopyIcon;
const CodeBlockComponent = useCallback(
(props: { className?: string }) => (
<pre
className={cn(
"not-prose flex-1 overflow-x-auto rounded-sm border bg-background py-3 text-sm outline-none",
"[&>code]:grid [&>code]:min-w-max",
className,
props.className
)}
ref={ref}
style={style}
tabIndex={tabIndex}
>
{children}
</pre>
),
[children, style, tabIndex, className]
);
if (!title) {
return (
<div className="relative mb-6">
<CodeBlockComponent
className={cn(lineNumbers ? "line-numbers" : "", className)}
/>
<Button
className="absolute top-[5px] right-[5px] bg-background/80 backdrop-blur-sm"
onClick={copyToClipboard}
size="icon"
variant="ghost"
>
<Icon size={14} />
</Button>
</div>
);
}
const { cleanTitle, frameworkIcon } = parseFrameworkFromTitle(title);
return (
<Card className="not-prose mb-6 gap-0 overflow-hidden rounded-sm p-0 shadow-none">
<CardHeader className="flex items-center gap-2 border-b bg-sidebar py-1.5! pr-1.5 pl-4 text-muted-foreground">
{frameworkIcon ? (
<div className="flex size-3.5 shrink-0 items-center justify-center">
{frameworkIcon}
</div>
) : (
<div
className="flex size-3.5 shrink-0"
// biome-ignore lint/security/noDangerouslySetInnerHtml: "Required for icon prop."
dangerouslySetInnerHTML={{ __html: icon as unknown as TrustedHTML }}
/>
)}
<CardTitle className="flex-1 font-mono font-normal text-sm tracking-tight">
{cleanTitle}
</CardTitle>
<Button
className={cn("shrink-0", className)}
onClick={copyToClipboard}
size="icon"
variant="ghost"
>
<Icon size={14} />
</Button>
</CardHeader>
<CardContent className="p-0">
<CodeBlockComponent
className={cn(
className,
"rounded-none border-none",
lineNumbers ? "line-numbers" : ""
)}
/>
</CardContent>
</Card>
);
};