{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "breadcrumb",
  "title": "Breadcrumb",
  "description": "Hierarchical navigation trail (<nav aria-label=\"Breadcrumb\"> + <ol>) with aria-current=\"page\", presentation separators, ellipsis, and asChild link composition.",
  "registryDependencies": [
    "https://frame12.dev/r/frame12-styles.json"
  ],
  "files": [
    {
      "path": "ui/breadcrumb.tsx",
      "content": "'use client';\n\nimport * as React from 'react';\n\nexport type BreadcrumbDensity = 'comfortable' | 'compact';\n\nexport interface BreadcrumbEntry {\n  label: React.ReactNode;\n  /**\n   * Real destination URL. The crumb renders as an `<a>`, so open-in-new-tab, copy-link and\n   * history all work. Only use it for an address that loads the right view on its own.\n   */\n  href?: string;\n  current?: boolean;\n  /**\n   * Runs on a plain primary click of an `href` crumb (e.g. client-side routing). Modified\n   * clicks (Ctrl/⌘/Shift/Alt) skip it so the browser can open the link natively.\n   */\n  onClick?: React.MouseEventHandler<HTMLAnchorElement>;\n  /**\n   * In-page action for a crumb without a URL (switching a tab, clearing a drill-down filter).\n   * The crumb renders as a `<button type=\"button\">` styled like a link. Ignored when `href`\n   * is set or the crumb is current.\n   */\n  onSelect?: React.MouseEventHandler<HTMLButtonElement>;\n}\n\nfunction isModifiedClick(event: React.MouseEvent<HTMLElement>): boolean {\n  return (\n    event.metaKey ||\n    event.ctrlKey ||\n    event.shiftKey ||\n    event.altKey ||\n    (typeof event.button === 'number' && event.button !== 0)\n  );\n}\n\nconst BreadcrumbContext = React.createContext<{\n  separator: React.ReactNode;\n  density: BreadcrumbDensity;\n}>({\n  separator: '/',\n  density: 'comfortable',\n});\n\nconst BreadcrumbItemContext = React.createContext<boolean>(false);\n\nfunction mergeRefs<T>(\n  ...refs: Array<React.Ref<T> | undefined>\n): React.RefCallback<T> {\n  let activeCleanups: Array<() => void> = [];\n  const runCleanups = () => {\n    const toRun = activeCleanups;\n    activeCleanups = [];\n    for (const cleanup of toRun) {\n      cleanup();\n    }\n  };\n  return (value: T | null) => {\n    runCleanups();\n    if (value === null) {\n      return;\n    }\n    const cleanups: Array<() => void> = [];\n    for (const ref of refs) {\n      if (typeof ref === 'function') {\n        const cleanup = ref(value);\n        if (typeof cleanup === 'function') {\n          cleanups.push(cleanup);\n        } else {\n          cleanups.push(() => {\n            ref(null);\n          });\n        }\n      } else if (ref != null) {\n        (ref as React.MutableRefObject<T | null>).current = value;\n        cleanups.push(() => {\n          (ref as React.MutableRefObject<T | null>).current = null;\n        });\n      }\n    }\n    activeCleanups = cleanups;\n  };\n}\n\nfunction getElementRef(element: React.ReactElement): React.Ref<unknown> | undefined {\n  const propsObj = (element.props || {}) as Record<string, unknown>;\n  let getter = Object.getOwnPropertyDescriptor(propsObj, 'ref')?.get;\n  let mayWarn =\n    getter && 'isReactWarning' in getter && (getter as { isReactWarning?: boolean }).isReactWarning;\n  if (mayWarn) {\n    return (element as unknown as { ref?: React.Ref<unknown> }).ref;\n  }\n  getter = Object.getOwnPropertyDescriptor(element, 'ref')?.get;\n  mayWarn =\n    getter && 'isReactWarning' in getter && (getter as { isReactWarning?: boolean }).isReactWarning;\n  if (mayWarn) {\n    return (propsObj as { ref?: React.Ref<unknown> }).ref;\n  }\n  return (\n    (propsObj as { ref?: React.Ref<unknown> }).ref ||\n    (element as unknown as { ref?: React.Ref<unknown> }).ref\n  );\n}\n\nexport interface BreadcrumbProps extends React.HTMLAttributes<HTMLElement> {\n  items?: BreadcrumbEntry[];\n  separator?: React.ReactNode;\n  density?: BreadcrumbDensity;\n  ariaLabel?: string;\n}\n\nexport const Breadcrumb = React.forwardRef<HTMLElement, BreadcrumbProps>(function Breadcrumb(\n  {\n    items,\n    separator = '/',\n    density = 'comfortable',\n    ariaLabel = 'Breadcrumb',\n    'aria-label': userAriaLabel,\n    className = '',\n    children,\n    ...rest\n  },\n  ref,\n) {\n  const isCompact = density === 'compact';\n  const ctxValue = React.useMemo(\n    () => ({ separator, density }),\n    [separator, density],\n  );\n\n  return (\n    <BreadcrumbContext.Provider value={ctxValue}>\n      <nav\n        ref={ref}\n        aria-label={userAriaLabel ?? ariaLabel}\n        data-density={isCompact ? 'compact' : undefined}\n        className={`f12-breadcrumb${isCompact ? ' f12-breadcrumb-compact' : ''}${className ? ` ${className}` : ''}`}\n        {...rest}\n      >\n        {items ? (\n          <BreadcrumbList>\n            {(() => {\n              const hasExplicitCurrent = items.some((entry) => entry.current === true);\n              return items.map((item, idx) => {\n                const isLast = idx === items.length - 1;\n                const isCurrent = item.current ?? (!hasExplicitCurrent && isLast);\n                return (\n                  <React.Fragment key={idx}>\n                    <BreadcrumbItem>\n                      {isCurrent || (!item.href && !item.onSelect) ? (\n                        <BreadcrumbPage aria-current={isCurrent ? 'page' : false}>\n                          {item.label}\n                        </BreadcrumbPage>\n                      ) : item.href ? (\n                        <BreadcrumbLink\n                          href={item.href}\n                          onClick={\n                            item.onClick\n                              ? (event) => {\n                                  if (!isModifiedClick(event)) item.onClick?.(event);\n                                }\n                              : undefined\n                          }\n                        >\n                          {item.label}\n                        </BreadcrumbLink>\n                      ) : (\n                        <BreadcrumbButton onClick={item.onSelect}>{item.label}</BreadcrumbButton>\n                      )}\n                    </BreadcrumbItem>\n                    {!isLast && <BreadcrumbSeparator>{separator}</BreadcrumbSeparator>}\n                  </React.Fragment>\n                );\n              });\n            })()}\n          </BreadcrumbList>\n        ) : (\n          children\n        )}\n      </nav>\n    </BreadcrumbContext.Provider>\n  );\n});\n\nexport type BreadcrumbListProps = React.OlHTMLAttributes<HTMLOListElement>;\n\nexport const BreadcrumbList = React.forwardRef<HTMLOListElement, BreadcrumbListProps>(\n  function BreadcrumbList({ className = '', children, ...rest }, ref) {\n    return (\n      <ol\n        ref={ref}\n        className={`f12-breadcrumb-list${className ? ` ${className}` : ''}`}\n        {...rest}\n      >\n        {children}\n      </ol>\n    );\n  },\n);\n\nexport type BreadcrumbItemProps = React.LiHTMLAttributes<HTMLLIElement>;\n\nexport const BreadcrumbItem = React.forwardRef<HTMLLIElement, BreadcrumbItemProps>(\n  function BreadcrumbItem({ className = '', children, ...rest }, ref) {\n    return (\n      <BreadcrumbItemContext.Provider value={true}>\n        <li\n          ref={ref}\n          className={`f12-breadcrumb-item${className ? ` ${className}` : ''}`}\n          {...rest}\n        >\n          {children}\n        </li>\n      </BreadcrumbItemContext.Provider>\n    );\n  },\n);\n\nexport interface BreadcrumbLinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {\n  asChild?: boolean;\n}\n\nexport const BreadcrumbLink = React.forwardRef<HTMLAnchorElement, BreadcrumbLinkProps>(\n  function BreadcrumbLink({ asChild = false, className = '', onClick, children, ...rest }, forwardedRef) {\n    const mergedClass = `f12-breadcrumb-link${className ? ` ${className}` : ''}`;\n    const childRef =\n      asChild && React.isValidElement(children)\n        ? (getElementRef(children) as React.Ref<HTMLAnchorElement> | undefined)\n        : undefined;\n    const composedRef = React.useMemo(\n      () => mergeRefs(forwardedRef, childRef),\n      [forwardedRef, childRef],\n    );\n\n    if (asChild && React.isValidElement<Record<string, unknown>>(children)) {\n      const childProps = children.props || {};\n      const childClass =\n        typeof childProps.className === 'string' ? childProps.className : '';\n      const mergedProps: Record<string, unknown> = {\n        ...rest,\n        ...childProps,\n        ref: composedRef,\n        className: [mergedClass, childClass].filter(Boolean).join(' '),\n      };\n      const parentProps: Record<string, unknown> = { ...rest, onClick };\n      for (const evt of new Set([...Object.keys(parentProps), ...Object.keys(childProps)])) {\n        if (!/^on[A-Z]/.test(evt)) continue;\n        const parentHandler = parentProps[evt];\n        const childHandler = childProps[evt];\n        if (typeof parentHandler === 'function' && typeof childHandler === 'function') {\n          mergedProps[evt] = (...args: unknown[]) => {\n            (parentHandler as (...a: unknown[]) => void)(...args);\n            (childHandler as (...a: unknown[]) => void)(...args);\n          };\n        } else if (typeof parentHandler === 'function') {\n          mergedProps[evt] = parentHandler;\n        } else if (typeof childHandler === 'function') {\n          mergedProps[evt] = childHandler;\n        }\n      }\n      return React.cloneElement(children, mergedProps);\n    }\n\n    return (\n      <a ref={forwardedRef} className={mergedClass} onClick={onClick} {...rest}>\n        {children}\n      </a>\n    );\n  },\n);\n\nexport type BreadcrumbButtonProps = React.ButtonHTMLAttributes<HTMLButtonElement>;\n\n/**\n * A crumb that performs an in-page action instead of navigating to a URL. Prefer this over an\n * `<a href=\"#…\">` whose click handler calls `preventDefault()`: a fake hash link offers\n * open-in-new-tab and copy-link affordances that lead nowhere.\n */\nexport const BreadcrumbButton = React.forwardRef<HTMLButtonElement, BreadcrumbButtonProps>(\n  function BreadcrumbButton({ className = '', type = 'button', children, ...rest }, ref) {\n    return (\n      <button\n        ref={ref}\n        type={type}\n        className={`f12-breadcrumb-link f12-breadcrumb-button${className ? ` ${className}` : ''}`}\n        {...rest}\n      >\n        {children}\n      </button>\n    );\n  },\n);\n\nexport interface BreadcrumbPageProps\n  extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'aria-current'> {\n  'aria-current'?: React.AriaAttributes['aria-current'] | false;\n}\n\nexport const BreadcrumbPage = React.forwardRef<HTMLSpanElement, BreadcrumbPageProps>(\n  function BreadcrumbPage(\n    { 'aria-current': ariaCurrent = 'page', className = '', children, ...rest },\n    ref,\n  ) {\n    const resolvedAriaCurrent =\n      ariaCurrent === false || ariaCurrent === 'false' ? undefined : ariaCurrent;\n    return (\n      <span\n        ref={ref}\n        aria-current={resolvedAriaCurrent}\n        className={`f12-breadcrumb-page${className ? ` ${className}` : ''}`}\n        {...rest}\n      >\n        {children}\n      </span>\n    );\n  },\n);\n\nexport type BreadcrumbSeparatorProps = React.HTMLAttributes<HTMLElement>;\n\nexport const BreadcrumbSeparator = React.forwardRef<HTMLElement, BreadcrumbSeparatorProps>(\n  function BreadcrumbSeparator({ className = '', children, ...rest }, ref) {\n    const { separator } = React.useContext(BreadcrumbContext);\n    const inItem = React.useContext(BreadcrumbItemContext);\n    const Tag = inItem ? 'span' : 'li';\n\n    return (\n      <Tag\n        ref={ref as React.Ref<HTMLLIElement & HTMLSpanElement>}\n        role=\"presentation\"\n        aria-hidden=\"true\"\n        className={`f12-breadcrumb-separator${className ? ` ${className}` : ''}`}\n        {...rest}\n      >\n        {children ?? separator}\n      </Tag>\n    );\n  },\n);\n\nexport type BreadcrumbEllipsisProps = React.HTMLAttributes<HTMLSpanElement>;\n\nexport const BreadcrumbEllipsis = React.forwardRef<HTMLSpanElement, BreadcrumbEllipsisProps>(\n  function BreadcrumbEllipsis(\n    { 'aria-label': ariaLabel = 'More breadcrumb levels', className = '', children, ...rest },\n    ref,\n  ) {\n    return (\n      <span\n        ref={ref}\n        className={`f12-breadcrumb-ellipsis${className ? ` ${className}` : ''}`}\n        {...rest}\n      >\n        <span aria-hidden=\"true\">{children ?? '…'}</span>\n        <span className=\"f12-sr-only\">{ariaLabel}</span>\n      </span>\n    );\n  },\n);\n",
      "type": "registry:ui",
      "target": "components/frame12/breadcrumb.tsx"
    }
  ],
  "type": "registry:ui"
}