mirror of
https://github.com/vercel/flags.git
synced 2026-09-19 03:49:23 +08:00
97c8060917
* 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>
132 lines
4.3 KiB
TypeScript
132 lines
4.3 KiB
TypeScript
"use client";
|
|
|
|
import type { Node } from "fumadocs-core/page-tree";
|
|
import {
|
|
SidebarFolder,
|
|
SidebarFolderContent,
|
|
SidebarFolderLink,
|
|
SidebarFolderTrigger,
|
|
SidebarItem,
|
|
SidebarSeparator,
|
|
} from "fumadocs-ui/components/sidebar/base";
|
|
import type { SidebarPageTreeComponents } from "fumadocs-ui/components/sidebar/page-tree";
|
|
import { useTreeContext, useTreePath } from "fumadocs-ui/contexts/tree";
|
|
import { usePathname } from "next/navigation";
|
|
import { Fragment, useEffect, useRef } from "react";
|
|
import {
|
|
Sheet,
|
|
SheetContent,
|
|
SheetDescription,
|
|
SheetHeader,
|
|
SheetTitle,
|
|
} from "@/components/ui/sheet";
|
|
import { FrameworkSwitcher } from "@/components/custom/framework-switcher";
|
|
import { useSidebarContext } from "@/hooks/geistdocs/use-sidebar";
|
|
import { SearchButton } from "./search";
|
|
|
|
export const Sidebar = () => {
|
|
const { root } = useTreeContext();
|
|
const { isOpen, setIsOpen } = useSidebarContext();
|
|
const pathname = usePathname();
|
|
const previousPathname = useRef(pathname);
|
|
|
|
useEffect(() => {
|
|
if (pathname !== previousPathname.current) {
|
|
setIsOpen(false);
|
|
previousPathname.current = pathname;
|
|
}
|
|
}, [pathname, setIsOpen]);
|
|
|
|
const renderSidebarList = (items: Node[]) =>
|
|
items.map((item) => {
|
|
if (item.type === "separator") {
|
|
return <Separator item={item} key={item.$id} />;
|
|
}
|
|
|
|
if (item.type === "folder") {
|
|
const children = renderSidebarList(item.children);
|
|
return (
|
|
<Folder item={item} key={item.$id}>
|
|
{children}
|
|
</Folder>
|
|
);
|
|
}
|
|
|
|
return <Item item={item} key={item.$id} />;
|
|
});
|
|
|
|
return (
|
|
<div
|
|
className="pointer-events-none sticky top-(--fd-docs-row-1) z-20 h-[calc(var(--fd-docs-height)-var(--fd-docs-row-1))] [grid-area:sidebar] *:pointer-events-auto max-md:hidden md:layout:[--fd-sidebar-width:268px]"
|
|
data-sidebar-placeholder
|
|
>
|
|
<div className="h-full overflow-y-auto px-4 pt-12 pb-4">
|
|
<FrameworkSwitcher />
|
|
<Fragment key={root.$id}>{renderSidebarList(root.children)}</Fragment>
|
|
</div>
|
|
<Sheet onOpenChange={setIsOpen} open={isOpen}>
|
|
<SheetContent className="gap-0" side="left">
|
|
<SheetHeader className="mt-8">
|
|
<SheetTitle className="sr-only">Mobile Menu</SheetTitle>
|
|
<SheetDescription className="sr-only">
|
|
Navigation for the documentation.
|
|
</SheetDescription>
|
|
<SearchButton onClick={() => setIsOpen(false)} />
|
|
</SheetHeader>
|
|
<div className="flex-1 overflow-y-auto px-4 pb-4">
|
|
<FrameworkSwitcher />
|
|
{renderSidebarList(root.children)}
|
|
</div>
|
|
</SheetContent>
|
|
</Sheet>
|
|
</div>
|
|
);
|
|
};
|
|
|
|
export const Folder: SidebarPageTreeComponents["Folder"] = ({
|
|
children,
|
|
item,
|
|
}) => {
|
|
const path = useTreePath();
|
|
const defaultOpen = item.defaultOpen ?? path.includes(item);
|
|
|
|
return (
|
|
<SidebarFolder defaultOpen={defaultOpen}>
|
|
{item.index ? (
|
|
<SidebarFolderLink
|
|
className="flex items-center gap-2 text-pretty py-1.5 text-muted-foreground text-sm transition-colors hover:text-foreground data-[active=true]:text-foreground [&_svg]:size-3.5"
|
|
external={item.index.external}
|
|
href={item.index.url}
|
|
>
|
|
{item.icon}
|
|
{item.name}
|
|
</SidebarFolderLink>
|
|
) : (
|
|
<SidebarFolderTrigger className="flex items-center gap-2 text-pretty py-1.5 text-muted-foreground text-sm transition-colors hover:text-foreground [&_svg]:size-3.5">
|
|
{item.icon}
|
|
{item.name}
|
|
</SidebarFolderTrigger>
|
|
)}
|
|
<SidebarFolderContent className="ml-2">{children}</SidebarFolderContent>
|
|
</SidebarFolder>
|
|
);
|
|
};
|
|
|
|
export const Item: SidebarPageTreeComponents["Item"] = ({ item }) => (
|
|
<SidebarItem
|
|
className="block w-full truncate text-pretty py-1.5 text-muted-foreground text-sm transition-colors hover:text-foreground data-[active=true]:text-foreground"
|
|
external={item.external}
|
|
href={item.url}
|
|
icon={item.icon}
|
|
>
|
|
{item.name}
|
|
</SidebarItem>
|
|
);
|
|
|
|
export const Separator: SidebarPageTreeComponents["Separator"] = ({ item }) => (
|
|
<SidebarSeparator className="mt-4 mb-2 flex items-center gap-2 px-0 font-medium text-sm first-child:mt-0">
|
|
{item.icon}
|
|
{item.name}
|
|
</SidebarSeparator>
|
|
);
|