id: icon
kind: component
name: Icon
description: A single glyph from the system's icon set, rendered at a fixed size.

metadata:
  status: {status: stable}
  since: 1.0.0
  tags: [visual, icon]

sections:
  - kind: guidelines
    for: all
    items:
      - statement: Pair with a text label unless the glyph's meaning is already established by context (e.g. a close icon inside a dialog's own header).
        level: should
      - statement: Do not convey information (like an error state) through color alone - pair with text or a shape change too.
        level: must-not
