{
  "schemaVersion": 1,
  "theme": "j3w1-theme",
  "version": "1.1.0",
  "profile": "default",
  "profileStatus": "approved",
  "release": {
    "version": "1.1.0",
    "stability": "release",
    "policy": "Use the pinned approved default profile. Pending roles in that profile use-and-report their decision IDs; this does not approve them. Proposed profiles are preview-only and blocked for delivery. Heritage profiles are historical-only. Deprecated or heritage roles are blocked for new approved-profile mappings. Consume roles within their documented scope, never primitives. Release numbering does not approve profiles or tokens."
  },
  "sourceDigest": "sha256-C+iD5Q7l0XPU/boMj003wPbPLBOq3C3ZM7s4OfzJ6mc=",
  "id": "toolbar",
  "family": "navigation",
  "maturity": "stable",
  "priority": "R1",
  "coverage": {
    "family": "navigation",
    "priority": "R1",
    "maturity": "stable",
    "specified": true,
    "demonstrated": true,
    "tested": false,
    "testImplemented": false,
    "states": 5
  },
  "title": "Toolbar",
  "summary": "A row of related controls under one tab stop with arrow-key movement; ghost buttons, a vertical separator, and a \"more\" button when the row overflows.",
  "anchors": {
    "site": "https://j3w1.github.io/theme/reference/#c-toolbar",
    "spec": "spec/components/toolbar.md",
    "brief": "exports/components/toolbar.brief.txt"
  },
  "native": false,
  "aria": {
    "pattern": "APG toolbar with roving tabindex; buttons, toggle buttons with aria-pressed, and a separator",
    "apg": "https://www.w3.org/WAI/ARIA/apg/patterns/toolbar/",
    "role": "toolbar"
  },
  "variants": [
    {
      "id": "default",
      "name": "Default"
    },
    {
      "id": "overflow",
      "name": "Overflow",
      "description": "The trailing controls collapse behind a \"More\" menu button when the row is narrower than its contents."
    }
  ],
  "sizes": [
    "compact",
    "comfortable"
  ],
  "states": [
    "default",
    "hover",
    "focus-visible",
    "disabled",
    "toggled"
  ],
  "tokens": {
    "root.bg": {
      "alias": "color.surface.chrome",
      "value": "#090707",
      "status": "approved",
      "deprecated": false,
      "decisionId": "D-023",
      "eligibility": {
        "action": "use",
        "reason": "Use within the role's documented scope and restrictions.",
        "decisionIds": []
      }
    },
    "root.border": {
      "alias": "color.border.divider",
      "value": "#2b0e0d",
      "status": "proposed",
      "deprecated": false,
      "decisionId": "D-008",
      "eligibility": {
        "action": "use-and-report",
        "reason": "Use the pinned value and disclose every pending decision ID; approval statuses are unchanged.",
        "decisionIds": [
          "D-008"
        ]
      }
    },
    "button.text": {
      "alias": "color.text.default",
      "value": "#e99499",
      "status": "observed",
      "deprecated": false,
      "decisionId": null,
      "eligibility": {
        "action": "use",
        "reason": "Use within the role's documented scope and restrictions.",
        "decisionIds": []
      }
    },
    "button.bg-hover": {
      "alias": "color.interaction.hover.bg",
      "value": "#1c0a09",
      "status": "observed",
      "deprecated": false,
      "decisionId": null,
      "eligibility": {
        "action": "use",
        "reason": "Use within the role's documented scope and restrictions.",
        "decisionIds": []
      }
    },
    "button.bg-pressed": {
      "alias": "color.interaction.pressed.bg",
      "value": "#420f0c",
      "status": "observed",
      "deprecated": false,
      "decisionId": null,
      "eligibility": {
        "action": "use",
        "reason": "Use within the role's documented scope and restrictions.",
        "decisionIds": []
      }
    },
    "button.ring": {
      "alias": "color.interaction.focus.ring",
      "value": "#e53935",
      "status": "observed",
      "deprecated": false,
      "decisionId": null,
      "eligibility": {
        "action": "use",
        "reason": "Use within the role's documented scope and restrictions.",
        "decisionIds": []
      }
    },
    "button.text-disabled": {
      "alias": "color.text.disabled",
      "value": "#8a5559",
      "status": "approved",
      "deprecated": false,
      "decisionId": "D-003",
      "eligibility": {
        "action": "use",
        "reason": "Use within the role's documented scope and restrictions.",
        "decisionIds": []
      }
    },
    "toggled.bg": {
      "alias": "color.interaction.pressed.bg",
      "value": "#420f0c",
      "status": "observed",
      "deprecated": false,
      "decisionId": null,
      "eligibility": {
        "action": "use",
        "reason": "Use within the role's documented scope and restrictions.",
        "decisionIds": []
      }
    },
    "toggled.border": {
      "alias": "color.border.active",
      "value": "#e53935",
      "status": "observed",
      "deprecated": false,
      "decisionId": null,
      "eligibility": {
        "action": "use",
        "reason": "Use within the role's documented scope and restrictions.",
        "decisionIds": []
      }
    },
    "toggled.text": {
      "alias": "color.text.bright",
      "value": "#ffa2a7",
      "status": "observed",
      "deprecated": false,
      "decisionId": null,
      "eligibility": {
        "action": "use",
        "reason": "Use within the role's documented scope and restrictions.",
        "decisionIds": []
      }
    },
    "separator.color": {
      "alias": "color.border.default",
      "value": "#531310",
      "status": "observed",
      "deprecated": false,
      "decisionId": null,
      "eligibility": {
        "action": "use",
        "reason": "Use within the role's documented scope and restrictions.",
        "decisionIds": []
      }
    },
    "more.chevron": {
      "alias": "color.icon.decorative",
      "value": "#a3676b",
      "status": "observed",
      "deprecated": false,
      "decisionId": null,
      "eligibility": {
        "action": "use",
        "reason": "Use within the role's documented scope and restrictions.",
        "decisionIds": []
      }
    }
  },
  "stateRules": [
    {
      "state": "default",
      "visual": "text {color.text.default}; no fill; transparent border",
      "channel": "—",
      "tokens": {
        "fg": {
          "alias": "color.text.default",
          "value": "#e99499",
          "status": "observed",
          "deprecated": false,
          "decisionId": null,
          "eligibility": {
            "action": "use",
            "reason": "Use within the role's documented scope and restrictions.",
            "decisionIds": []
          }
        },
        "bg": {
          "alias": "color.surface.chrome",
          "value": "#090707",
          "status": "approved",
          "deprecated": false,
          "decisionId": "D-023",
          "eligibility": {
            "action": "use",
            "reason": "Use within the role's documented scope and restrictions.",
            "decisionIds": []
          }
        }
      }
    },
    {
      "state": "hover",
      "visual": "background → {color.interaction.hover.bg}",
      "channel": "cursor: pointer",
      "tokens": {
        "fg": {
          "alias": "color.text.default",
          "value": "#e99499",
          "status": "observed",
          "deprecated": false,
          "decisionId": null,
          "eligibility": {
            "action": "use",
            "reason": "Use within the role's documented scope and restrictions.",
            "decisionIds": []
          }
        },
        "bg": {
          "alias": "color.interaction.hover.bg",
          "value": "#1c0a09",
          "status": "observed",
          "deprecated": false,
          "decisionId": null,
          "eligibility": {
            "action": "use",
            "reason": "Use within the role's documented scope and restrictions.",
            "decisionIds": []
          }
        }
      }
    },
    {
      "state": "focus-visible",
      "visual": "ring 1px dashed {color.interaction.focus.ring} at −2px",
      "channel": "the ring",
      "tokens": {
        "fg": {
          "alias": "color.text.default",
          "value": "#e99499",
          "status": "observed",
          "deprecated": false,
          "decisionId": null,
          "eligibility": {
            "action": "use",
            "reason": "Use within the role's documented scope and restrictions.",
            "decisionIds": []
          }
        },
        "bg": {
          "alias": "color.surface.chrome",
          "value": "#090707",
          "status": "approved",
          "deprecated": false,
          "decisionId": "D-023",
          "eligibility": {
            "action": "use",
            "reason": "Use within the role's documented scope and restrictions.",
            "decisionIds": []
          }
        },
        "outline": {
          "alias": "color.interaction.focus.ring",
          "value": "#e53935",
          "status": "observed",
          "deprecated": false,
          "decisionId": null,
          "eligibility": {
            "action": "use",
            "reason": "Use within the role's documented scope and restrictions.",
            "decisionIds": []
          }
        }
      }
    },
    {
      "state": "disabled",
      "visual": "text {color.text.disabled}; no fill; no hover",
      "channel": "`disabled`; cursor: not-allowed; skipped by the arrow keys",
      "tokens": {}
    },
    {
      "state": "toggled",
      "visual": "fill {color.interaction.pressed.bg}; 1px {color.border.active} border; text {color.text.bright}",
      "channel": "`aria-pressed=\"true\"`; the border",
      "tokens": {
        "fg": {
          "alias": "color.text.bright",
          "value": "#ffa2a7",
          "status": "observed",
          "deprecated": false,
          "decisionId": null,
          "eligibility": {
            "action": "use",
            "reason": "Use within the role's documented scope and restrictions.",
            "decisionIds": []
          }
        },
        "bg": {
          "alias": "color.interaction.pressed.bg",
          "value": "#420f0c",
          "status": "observed",
          "deprecated": false,
          "decisionId": null,
          "eligibility": {
            "action": "use",
            "reason": "Use within the role's documented scope and restrictions.",
            "decisionIds": []
          }
        },
        "border": {
          "alias": "color.border.active",
          "value": "#e53935",
          "status": "observed",
          "deprecated": false,
          "decisionId": null,
          "eligibility": {
            "action": "use",
            "reason": "Use within the role's documented scope and restrictions.",
            "decisionIds": []
          }
        }
      }
    }
  ],
  "keyboard": [
    {
      "key": "Tab / Shift+Tab",
      "action": "Enters or leaves the toolbar; one control has tabindex 0 (roving tabindex)."
    },
    {
      "key": "Left / Right",
      "action": "Moves focus to the previous or next enabled control; wraps at the ends; Up and Down when aria-orientation is vertical."
    },
    {
      "key": "Home / End",
      "action": "Moves focus to the first or last control."
    },
    {
      "key": "Enter / Space",
      "action": "Activates the focused button or toggles a toggle button."
    },
    {
      "key": "Escape",
      "action": "Restores the previous value in a toolbar that edits, otherwise nothing."
    }
  ],
  "responsive": "The row never wraps: below its intrinsic width the trailing controls move into the More menu (the overflow variant); at 320px only the leading controls and the more button remain visible. RTL mirrors the order and the arrow keys follow the reading direction.",
  "portability": {
    "web": "A div with role toolbar and aria-label; native buttons inside, toggles with aria-pressed; a div with role separator and aria-orientation vertical; roving tabindex maintained by script; without script every button stays in the tab order, which is the acceptable no-JS fallback.",
    "nativeFallbacks": [
      "GTK4 Box in the toolbar style class with flat Buttons and ToggleButtons; a Separator between groups.",
      "Qt QToolBar with QActions; checkable actions draw the pressed fill and active border.",
      "Terminal UI: a one-line row of bracketed labels; the toggled one inverted."
    ]
  },
  "fixtures": [
    "FX-320",
    "FX-ZOOM-200",
    "FX-I18N",
    "FX-RTL",
    "FX-RM",
    "FX-HC",
    "FX-OVERFLOW",
    "FX-STATE-MATRIX"
  ],
  "related": [
    "button",
    "icon-button",
    "menu",
    "tabs",
    "button-group"
  ],
  "specimens": [
    "filterable-table",
    "i3-window-frame"
  ],
  "nonExamples": "Buttons with a visible border at rest. A filled primary button inside the\ntoolbar. Rounded buttons or a pill-shaped toolbar. Every button in the tab\norder when script is available. A toggled state shown by colour alone without\n`aria-pressed`. A toolbar that wraps to two lines. A separator that receives\nfocus. Disabling by opacity.",
  "contrast": [
    {
      "label": "toolbar default text",
      "state": "default",
      "kind": "text",
      "min": 4.5,
      "fg": "color.text.default",
      "bg": "color.surface.chrome",
      "fgHex": "#e99499",
      "bgHex": "#090707",
      "ratio": 8.77,
      "pass": true,
      "waiver": null
    },
    {
      "label": "toolbar hover text",
      "state": "hover",
      "kind": "text",
      "min": 4.5,
      "fg": "color.text.default",
      "bg": "color.interaction.hover.bg",
      "fgHex": "#e99499",
      "bgHex": "#1c0a09",
      "ratio": 8.35,
      "pass": true,
      "waiver": null
    },
    {
      "label": "toolbar focus-visible text",
      "state": "focus-visible",
      "kind": "text",
      "min": 4.5,
      "fg": "color.text.default",
      "bg": "color.surface.chrome",
      "fgHex": "#e99499",
      "bgHex": "#090707",
      "ratio": 8.77,
      "pass": true,
      "waiver": null
    },
    {
      "label": "toolbar focus-visible outline",
      "state": "focus-visible",
      "kind": "ui",
      "min": 3,
      "fg": "color.interaction.focus.ring",
      "bg": "color.surface.chrome",
      "fgHex": "#e53935",
      "bgHex": "#090707",
      "ratio": 4.75,
      "pass": true,
      "waiver": null
    },
    {
      "label": "toolbar toggled text",
      "state": "toggled",
      "kind": "text",
      "min": 4.5,
      "fg": "color.text.bright",
      "bg": "color.interaction.pressed.bg",
      "fgHex": "#ffa2a7",
      "bgHex": "#420f0c",
      "ratio": 8.41,
      "pass": true,
      "waiver": null
    },
    {
      "label": "toolbar toggled border",
      "state": "toggled",
      "kind": "ui",
      "min": 3,
      "fg": "color.border.active",
      "bg": "color.interaction.pressed.bg",
      "fgHex": "#e53935",
      "bgHex": "#420f0c",
      "ratio": 3.81,
      "pass": true,
      "waiver": null
    },
    {
      "label": "disabled button text (exempt; house floor 3:1)",
      "state": "disabled",
      "kind": "ui",
      "min": 3,
      "fg": "color.text.disabled",
      "bg": "color.surface.chrome",
      "fgHex": "#8a5559",
      "bgHex": "#090707",
      "ratio": 3.37,
      "pass": true,
      "waiver": null
    },
    {
      "label": "separator (decorative; role separator carries the grouping)",
      "state": null,
      "kind": "ui",
      "min": 1,
      "fg": "color.border.default",
      "bg": "color.surface.chrome",
      "fgHex": "#531310",
      "bgHex": "#090707",
      "ratio": 1.41,
      "pass": true,
      "waiver": "the separator groups controls that are already distinct targets; it is not a control boundary"
    },
    {
      "label": "toolbar bottom edge (decorative)",
      "state": null,
      "kind": "ui",
      "min": 1,
      "fg": "color.border.divider",
      "bg": "color.surface.chrome",
      "fgHex": "#2b0e0d",
      "bgHex": "#090707",
      "ratio": 1.12,
      "pass": true,
      "waiver": "the edge separates chrome from content; the controls are the boundaries"
    }
  ]
}