Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | /** |
| 2 | * Adds badges to sidebar entries, frontmatter-driven: |
| 3 | * - pages with `experimental: true` get an amber "Experimental" badge |
| 4 | * - pages with `isNew: true` get a green "New" badge |
| 5 | * |
| 6 | * Legacy pages are NOT badged here: the sidebar already groups them under a |
| 7 | * "...(Legacy)" section header, so a per-item "Legacy" pill is redundant |
| 8 | * (and stacked right under that header it reads as a double "Legacy"). |
| 9 | */ |
| 10 | import type { ReactNode } from 'react'; |
| 11 | import type { Root, Node, Item } from 'fumadocs-core/page-tree'; |
| 12 | |
| 13 | function SidebarBadge({ label, tone }: { label: string; tone: 'experimental' | 'new' }) { |
| 14 | const toneClass = |
| 15 | tone === 'experimental' |
| 16 | ? 'bg-amber-100 text-amber-700 ring-amber-600/20 dark:bg-amber-500/10 dark:text-amber-400 dark:ring-amber-500/25' |
| 17 | : 'bg-emerald-100 text-emerald-700 ring-emerald-600/20 dark:bg-emerald-500/10 dark:text-emerald-400 dark:ring-emerald-500/25'; |
| 18 | return ( |
| 19 | <span |
| 20 | className={`ml-2 inline-flex shrink-0 items-center rounded px-1.5 py-px text-[10px] font-medium uppercase tracking-wide ring-1 ring-inset ${toneClass}`} |
| 21 | > |
| 22 | {label} |
| 23 | </span> |
| 24 | ); |
| 25 | } |
| 26 | |
| 27 | function withBadge(name: ReactNode, badge: ReactNode): ReactNode { |
| 28 | return ( |
| 29 | <span className="inline-flex w-full items-center justify-between gap-2"> |
| 30 | <span className="truncate">{name}</span> |
| 31 | {badge} |
| 32 | </span> |
| 33 | ); |
| 34 | } |
| 35 | |
| 36 | function decorateNode(node: Node, experimental: Set<string>, isNew: Set<string>): Node { |
| 37 | if (node.type === 'folder') { |
| 38 | return { |
| 39 | ...node, |
| 40 | children: node.children.map((child) => decorateNode(child, experimental, isNew)), |
| 41 | }; |
| 42 | } |
| 43 | if (node.type === 'page' && experimental.has(node.url)) { |
| 44 | return { ...node, name: withBadge(node.name, <SidebarBadge label="Exp" tone="experimental" />) } as Item; |
| 45 | } |
| 46 | if (node.type === 'page' && isNew.has(node.url)) { |
| 47 | return { ...node, name: withBadge(node.name, <SidebarBadge label="New" tone="new" />) } as Item; |
| 48 | } |
| 49 | return node; |
| 50 | } |
| 51 | |
| 52 | /** |
| 53 | * Returns a new page tree with experimental/new sidebar badges applied. |
| 54 | * No-op when all sets are empty so the original tree is reused. |
| 55 | */ |
| 56 | export function decorateSidebarBadges( |
| 57 | tree: Root, |
| 58 | experimentalUrls: Set<string>, |
| 59 | newUrls: Set<string>, |
| 60 | ): Root { |
| 61 | if (experimentalUrls.size === 0 && newUrls.size === 0) return tree; |
| 62 | return { |
| 63 | ...tree, |
| 64 | children: tree.children.map((node) => decorateNode(node, experimentalUrls, newUrls)), |
| 65 | }; |
| 66 | } |