"use client" import * as React from "react" import type { ComponentDocSpec } from "@/lib/design-system/component-doc-types" import { BreadcrumbPreview, BreadcrumbTrailCollapsePreview, BreadcrumbTrailShapesPreview, } from "@/components/design-system/navigation-previews" export const breadcrumbComponentDoc: ComponentDocSpec = { slug: "breadcrumb", summary: "Ancestor trail paired with SiteHeader — one H1 on the page, breadcrumbs are wayfinding only.", sections: [ { id: "default", title: "Default", children: , description: "Primitives only. The current page uses BreadcrumbPage with font-medium, as the product trail does; ancestors are muted links.", }, { id: "trail-shapes", title: "PageBreadcrumbTrail shapes", children: , description: "The product trail: ancestors only, ancestors plus the current page, a current-page switcher, and a single ancestor. The current page is not a link and carries aria-current.", }, { id: "trail-collapse", title: "Collapse and truncation", children: , description: "The trail shows every crumb that fits. In a tight row the middle crumbs move into More, shallowest first; long labels truncate, the current page last.", }, ], guidelines: { do: [ "Compose via SiteHeader + PageBreadcrumbTrail.", "Let the trail decide: it shows every segment that fits and moves the middle ones into More (BreadcrumbEllipsis + dropdown) only when the row runs out of room.", ], dont: [ "Do not add a Back button when breadcrumbs exist (P1).", "Do not use breadcrumb as the only page title.", "Do not hide segments by crumb count or at a breakpoint. A trail that fits shows all of it.", ], }, relatedSlugs: ["site-header", "page-header"], }