Skip to main content

ARC 2.0.0-beta.28 · AUP Web-only widget

breadcrumb

AUP Web-only widget `breadcrumb`: purpose, boundaries, surfaces, fallback, and evidence.

AUP Web-only widget — not a cross-device primitive; not a Web Device layout component.

The name is registered in AUP_WIDGETS (packages/aup/src/aup-types.ts). It can be accepted by structure verification and implemented by a Web runtime (or native target where noted). It is not one of the 18 cross-device AUP_PRIMITIVES, does not enter DeviceCaps.primitives via fillPrimitives, and is not a Web Device theme/site layout component (for example content-card or page-breadcrumb).

Purpose

Server-provided breadcrumb trail (items with label/href). AUP UI component factory in packages/aup/src/components/breadcrumb.ts. Distinct from site layout-component page-breadcrumb.

Boundaries

  • Do not document this type as a portable primitive.
  • Do not mix it with Web Device layout-component reference pages under widgets/.
  • A parser-accepted name is not a portability or product-readiness claim.

Author entry

AUP type: "breadcrumb" via createBreadcrumb or raw node. Path parsing must stay server-side (Renderer Purity).

Surfaces

Interactive Web AUP component. Not Web Device layout page-breadcrumb.

Fallback

No degradation chain. Empty items → empty trail.

Evidence

SourcePath
Registrationpackages/aup/src/aup-types.ts (UI components section)
Factorypackages/aup/src/components/breadcrumb.ts
Rendererproviders/runtime/ui/src/web-page/renderers/breadcrumb.ts
Testspackages/aup/test/components/breadcrumb.test.ts; providers/runtime/ui/test/widget-renderers-993.test.ts

Paths are relative to the Arc repository checkout used for this documentation baseline.

Sample

No docs-safe live sample on this site yet. Use the listed Showcase source / factory API as a source-only reference. Run Showcase locally if you need interactive acceptance.