"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"],
}