Library icons
Design References
Contract
Icon renders shared SVG icon paths by names registered
in the bus-ui icon registry. Authors discover valid names with
bus ui inspect icons --format json or from the generated icon registry
published by the host. Unknown icon names fail validation before render,
including when a later control component passes through an icon name. Components
that use an icon must still provide visible text or an accessible label when
the control has meaning beyond decoration.
Icons are presentational. They do not define events, status meaning, provider state, permissions, or navigation.
Consequence
Icon selection improves scannability without becoming a product-state contract.