color.surface.overlay
D-041 surface.overlay: color.primitive.modern.overlay.
Source revision 9afef8564142e41458748895d16b4df161a67d66
Find related usageSpecification anchorMeasured contrast report (default profile)Report an issue with this token
color.surface.overlay--color-surface-overlaydefault · approved
- Resolved value
#1c1010- Status
- approved
- Consumption
- use — Use within the role's documented scope and restrictions.
- Decisions
- None pending.
- Source
- tokens/semantic.tokens.json:82
/color/surface/overlay - Alias chain
color.primitive.modern.overlay- Used by aliases
- No declared aliases depend on this role.
Provenance and restrictions
{
"status": "approved",
"approval": {
"decision": "D-041"
}
}Declared component and port usage
| Consumer / kind | Part / variant | State / surface | Source declaration |
|---|---|---|---|
| dialog · contrast | — | — · color.surface.overlay | spec/components/dialog.md:62 /contrast/0 |
| dialog · contrast | — | — · color.surface.overlay | spec/components/dialog.md:63 /contrast/1 |
| dialog · contrast | — | — · color.surface.overlay | spec/components/dialog.md:72 /contrast/10 |
| dialog · contrast | — | — · color.surface.overlay | spec/components/dialog.md:64 /contrast/2 |
| dialog · contrast | — | — · color.surface.overlay | spec/components/dialog.md:65 /contrast/3 |
| dialog · contrast | — | — · color.surface.overlay | spec/components/dialog.md:68 /contrast/6 |
| drawer · contrast | — | — · color.surface.overlay | spec/components/drawer.md:48 /contrast/0 |
| drawer · contrast | — | — · color.surface.overlay | spec/components/drawer.md:49 /contrast/1 |
| drawer · contrast | — | — · color.surface.overlay | spec/components/drawer.md:50 /contrast/2 |
| drawer · contrast | — | — · color.surface.overlay | spec/components/drawer.md:51 /contrast/3 |
| drawer · contrast | — | — · color.surface.overlay | spec/components/drawer.md:53 /contrast/5 |
| command-palette · part | dependency.role-color-surface-overlay | — | spec/components/command-palette.md:48 /tokens/dependency.role-color-surface-overlay |
| dialog · part | root.bg | — | spec/components/dialog.md:32 /tokens/root.bg |
| drawer · part | root.bg | — | spec/components/drawer.md:28 /tokens/root.bg |
| popover · part | dependency.role-color-surface-overlay | — | spec/components/popover.md:39 /tokens/dependency.role-color-surface-overlay |
obsidian · port--modal-background | — | — | ports/obsidian/mapping.json:25 /mappings/color.surface.overlay/0 |
telegram · portandroid:actionBarDefaultSubmenuBackground | — | — | ports/telegram/mapping.json:165 /mappings/color.surface.overlay/2 |
telegram · portandroid:chats_menuBackground | — | — | ports/telegram/mapping.json:166 /mappings/color.surface.overlay/3 |
telegram · portandroid:dialogBackground | — | — | ports/telegram/mapping.json:163 /mappings/color.surface.overlay/0 |
telegram · portandroid:dialogBackgroundGray | — | — | ports/telegram/mapping.json:164 /mappings/color.surface.overlay/1 |
windows · portcalculator.resource.ToolTipBackgroundBrush | — | — | ports/windows/mapping.json:2191 /mappings/color.surface.overlay/0 |
telegram · portdesktop:boxBg | — | — | ports/telegram/mapping.json:168 /mappings/color.surface.overlay/5 |
telegram · portdesktop:boxDividerBg | — | — | ports/telegram/mapping.json:169 /mappings/color.surface.overlay/6 |
telegram · portdesktop:notificationBg | — | — | ports/telegram/mapping.json:170 /mappings/color.surface.overlay/7 |
telegram · portdesktop:tooltipBg | — | — | ports/telegram/mapping.json:167 /mappings/color.surface.overlay/4 |
claude-code · portmemoryBackgroundColor | — | — | ports/claude-code/mapping.json:58 /mappings/color.surface.overlay/0 |
windows · portnotepad-chrome.resource.ToolTipBackgroundBrush | — | — | ports/windows/mapping.json:2192 /mappings/color.surface.overlay/1 |
windows · portpaint-chrome.resource.ToolTipBackgroundBrush | — | — | ports/windows/mapping.json:2193 /mappings/color.surface.overlay/2 |
windows · portterminal-chrome.resource.ToolTipBackgroundBrush | — | — | ports/windows/mapping.json:2194 /mappings/color.surface.overlay/3 |
| dialog · state | bg | default · color.surface.overlay | spec/components/dialog.md:55 /stateTokens/default/bg |
| dialog · state | bg | focus-trapped · color.surface.overlay | spec/components/dialog.md:57 /stateTokens/focus-trapped/bg |
| dialog · state | bg | focus-visible · color.surface.overlay | spec/components/dialog.md:59 /stateTokens/focus-visible/bg |
| dialog · state | bg | open · color.surface.overlay | spec/components/dialog.md:56 /stateTokens/open/bg |
| dialog · state | bg | reduced-motion · color.surface.overlay | spec/components/dialog.md:60 /stateTokens/reduced-motion/bg |
| drawer · state | bg | default · color.surface.overlay | spec/components/drawer.md:43 /stateTokens/default/bg |
| drawer · state | bg | focus-trapped · color.surface.overlay | spec/components/drawer.md:45 /stateTokens/focus-trapped/bg |
| drawer · state | bg | open · color.surface.overlay | spec/components/drawer.md:44 /stateTokens/open/bg |
| drawer · state | bg | reduced-motion · color.surface.overlay | spec/components/drawer.md:46 /stateTokens/reduced-motion/bg |
Declared unmapped ports
- chatgpt: ChatGPT has one background; raised, overlay and inset surfaces follow its own derivation from it. · ports/chatgpt/mapping.json:267
/unmapped/color.surface.overlay - codex: Interface colour role; a Codex tmTheme colours code only. · ports/codex/mapping.json:287
/unmapped/color.surface.overlay - ghostty: Interface colour role; a terminal theme file carries terminal colours only. · ports/ghostty/mapping.json:306
/unmapped/color.surface.overlay - orca: No separately mapped public Orca theme key for this role; the host derives or retains this state. The app plugin maps supported chrome and editor keys independently of terminal colours. · ports/orca/mapping.json:493
/unmapped/color.surface.overlay - warp: Interface colour role; a terminal theme file carries terminal colours only. · ports/warp/mapping.json:300
/unmapped/color.surface.overlay
Relevant contrast declarations
- destructive fill against the overlay surface: color.action.destructive.filled-bg on color.surface.overlay · spec/components/dialog.md:68
/contrast/6 - secondary button boundary on the overlay surface: color.action.secondary.border on color.surface.overlay · spec/components/dialog.md:65
/contrast/3 - secondary button text on the overlay surface: color.action.secondary.text on color.surface.overlay · spec/components/dialog.md:64
/contrast/2 - close button on the overlay surface: color.action.tertiary.text on color.surface.overlay · spec/components/drawer.md:50
/contrast/2 - dialog focus-visible fg: color.action.tertiary.text on color.surface.overlay · spec/components/dialog.md:59
/stateTokens/focus-visible - form field boundary on the overlay surface: color.border.control on color.surface.overlay · spec/components/dialog.md:72
/contrast/10 - row dividers (decorative): color.border.divider on color.surface.overlay · spec/components/drawer.md:53
/contrast/5 - dialog default border: color.border.overlay on color.surface.overlay · spec/components/dialog.md:55
/stateTokens/default - dialog focus-trapped border: color.border.overlay on color.surface.overlay · spec/components/dialog.md:57
/stateTokens/focus-trapped - dialog open border: color.border.overlay on color.surface.overlay · spec/components/dialog.md:56
/stateTokens/open - dialog reduced-motion border: color.border.overlay on color.surface.overlay · spec/components/dialog.md:60
/stateTokens/reduced-motion - drawer default border: color.border.overlay on color.surface.overlay · spec/components/drawer.md:43
/stateTokens/default - drawer focus-trapped border: color.border.overlay on color.surface.overlay · spec/components/drawer.md:45
/stateTokens/focus-trapped - drawer open border: color.border.overlay on color.surface.overlay · spec/components/drawer.md:44
/stateTokens/open - drawer reduced-motion border: color.border.overlay on color.surface.overlay · spec/components/drawer.md:46
/stateTokens/reduced-motion - dialog focus-trapped outline: color.interaction.focus.ring-container on color.surface.overlay · spec/components/dialog.md:57
/stateTokens/focus-trapped - drawer focus-trapped outline: color.interaction.focus.ring-container on color.surface.overlay · spec/components/drawer.md:45
/stateTokens/focus-trapped - dialog focus-visible outline: color.interaction.focus.ring on color.surface.overlay · spec/components/dialog.md:59
/stateTokens/focus-visible - ring on the overlay surface: color.interaction.focus.ring on color.surface.overlay · spec/components/drawer.md:51
/contrast/3 - title on the overlay surface: color.text.bright on color.surface.overlay · spec/components/dialog.md:62
/contrast/0 - title on the overlay surface: color.text.bright on color.surface.overlay · spec/components/drawer.md:48
/contrast/0 - dialog default fg: color.text.default on color.surface.overlay · spec/components/dialog.md:55
/stateTokens/default - dialog focus-trapped fg: color.text.default on color.surface.overlay · spec/components/dialog.md:57
/stateTokens/focus-trapped - dialog open fg: color.text.default on color.surface.overlay · spec/components/dialog.md:56
/stateTokens/open - dialog reduced-motion fg: color.text.default on color.surface.overlay · spec/components/dialog.md:60
/stateTokens/reduced-motion - drawer default fg: color.text.default on color.surface.overlay · spec/components/drawer.md:43
/stateTokens/default - drawer focus-trapped fg: color.text.default on color.surface.overlay · spec/components/drawer.md:45
/stateTokens/focus-trapped - drawer open fg: color.text.default on color.surface.overlay · spec/components/drawer.md:44
/stateTokens/open - drawer reduced-motion fg: color.text.default on color.surface.overlay · spec/components/drawer.md:46
/stateTokens/reduced-motion - note on the overlay surface: color.text.muted on color.surface.overlay · spec/components/dialog.md:63
/contrast/1 - note on the overlay surface: color.text.muted on color.surface.overlay · spec/components/drawer.md:49
/contrast/1
heritage-ansi · heritage
- Resolved value
#1c1010- Status
- approved
- Consumption
- historical-only — Historical fidelity only; preserve all documented limitations and deprecations.
- Decisions
- None pending.
- Source
- tokens/semantic.tokens.json:82
/color/surface/overlay - Alias chain
color.primitive.modern.overlay- Used by aliases
- No declared aliases depend on this role.
Provenance and restrictions
{
"status": "approved",
"approval": {
"decision": "D-041"
}
}Declared component and port usage
Relevant contrast declarations
- destructive fill against the overlay surface: color.action.destructive.filled-bg on color.surface.overlay · spec/components/dialog.md:68
/contrast/6 - secondary button boundary on the overlay surface: color.action.secondary.border on color.surface.overlay · spec/components/dialog.md:65
/contrast/3 - secondary button text on the overlay surface: color.action.secondary.text on color.surface.overlay · spec/components/dialog.md:64
/contrast/2 - close button on the overlay surface: color.action.tertiary.text on color.surface.overlay · spec/components/drawer.md:50
/contrast/2 - dialog focus-visible fg: color.action.tertiary.text on color.surface.overlay · spec/components/dialog.md:59
/stateTokens/focus-visible - form field boundary on the overlay surface: color.border.control on color.surface.overlay · spec/components/dialog.md:72
/contrast/10 - row dividers (decorative): color.border.divider on color.surface.overlay · spec/components/drawer.md:53
/contrast/5 - dialog default border: color.border.overlay on color.surface.overlay · spec/components/dialog.md:55
/stateTokens/default - dialog focus-trapped border: color.border.overlay on color.surface.overlay · spec/components/dialog.md:57
/stateTokens/focus-trapped - dialog open border: color.border.overlay on color.surface.overlay · spec/components/dialog.md:56
/stateTokens/open - dialog reduced-motion border: color.border.overlay on color.surface.overlay · spec/components/dialog.md:60
/stateTokens/reduced-motion - drawer default border: color.border.overlay on color.surface.overlay · spec/components/drawer.md:43
/stateTokens/default - drawer focus-trapped border: color.border.overlay on color.surface.overlay · spec/components/drawer.md:45
/stateTokens/focus-trapped - drawer open border: color.border.overlay on color.surface.overlay · spec/components/drawer.md:44
/stateTokens/open - drawer reduced-motion border: color.border.overlay on color.surface.overlay · spec/components/drawer.md:46
/stateTokens/reduced-motion - dialog focus-trapped outline: color.interaction.focus.ring-container on color.surface.overlay · spec/components/dialog.md:57
/stateTokens/focus-trapped - drawer focus-trapped outline: color.interaction.focus.ring-container on color.surface.overlay · spec/components/drawer.md:45
/stateTokens/focus-trapped - dialog focus-visible outline: color.interaction.focus.ring on color.surface.overlay · spec/components/dialog.md:59
/stateTokens/focus-visible - ring on the overlay surface: color.interaction.focus.ring on color.surface.overlay · spec/components/drawer.md:51
/contrast/3 - title on the overlay surface: color.text.bright on color.surface.overlay · spec/components/dialog.md:62
/contrast/0 - title on the overlay surface: color.text.bright on color.surface.overlay · spec/components/drawer.md:48
/contrast/0 - dialog default fg: color.text.default on color.surface.overlay · spec/components/dialog.md:55
/stateTokens/default - dialog focus-trapped fg: color.text.default on color.surface.overlay · spec/components/dialog.md:57
/stateTokens/focus-trapped - dialog open fg: color.text.default on color.surface.overlay · spec/components/dialog.md:56
/stateTokens/open - dialog reduced-motion fg: color.text.default on color.surface.overlay · spec/components/dialog.md:60
/stateTokens/reduced-motion - drawer default fg: color.text.default on color.surface.overlay · spec/components/drawer.md:43
/stateTokens/default - drawer focus-trapped fg: color.text.default on color.surface.overlay · spec/components/drawer.md:45
/stateTokens/focus-trapped - drawer open fg: color.text.default on color.surface.overlay · spec/components/drawer.md:44
/stateTokens/open - drawer reduced-motion fg: color.text.default on color.surface.overlay · spec/components/drawer.md:46
/stateTokens/reduced-motion - note on the overlay surface: color.text.muted on color.surface.overlay · spec/components/dialog.md:63
/contrast/1 - note on the overlay surface: color.text.muted on color.surface.overlay · spec/components/drawer.md:49
/contrast/1
extended · proposed
- Resolved value
#1c1010- Status
- approved
- Consumption
- blocked — Proposed profile: preview only, not downstream delivery.
- Decisions
- None pending.
- Source
- tokens/semantic.tokens.json:82
/color/surface/overlay - Alias chain
color.primitive.modern.overlay- Used by aliases
- No declared aliases depend on this role.
Provenance and restrictions
{
"status": "approved",
"approval": {
"decision": "D-041"
}
}Declared component and port usage
Relevant contrast declarations
- destructive fill against the overlay surface: color.action.destructive.filled-bg on color.surface.overlay · spec/components/dialog.md:68
/contrast/6 - secondary button boundary on the overlay surface: color.action.secondary.border on color.surface.overlay · spec/components/dialog.md:65
/contrast/3 - secondary button text on the overlay surface: color.action.secondary.text on color.surface.overlay · spec/components/dialog.md:64
/contrast/2 - close button on the overlay surface: color.action.tertiary.text on color.surface.overlay · spec/components/drawer.md:50
/contrast/2 - dialog focus-visible fg: color.action.tertiary.text on color.surface.overlay · spec/components/dialog.md:59
/stateTokens/focus-visible - form field boundary on the overlay surface: color.border.control on color.surface.overlay · spec/components/dialog.md:72
/contrast/10 - row dividers (decorative): color.border.divider on color.surface.overlay · spec/components/drawer.md:53
/contrast/5 - dialog default border: color.border.overlay on color.surface.overlay · spec/components/dialog.md:55
/stateTokens/default - dialog focus-trapped border: color.border.overlay on color.surface.overlay · spec/components/dialog.md:57
/stateTokens/focus-trapped - dialog open border: color.border.overlay on color.surface.overlay · spec/components/dialog.md:56
/stateTokens/open - dialog reduced-motion border: color.border.overlay on color.surface.overlay · spec/components/dialog.md:60
/stateTokens/reduced-motion - drawer default border: color.border.overlay on color.surface.overlay · spec/components/drawer.md:43
/stateTokens/default - drawer focus-trapped border: color.border.overlay on color.surface.overlay · spec/components/drawer.md:45
/stateTokens/focus-trapped - drawer open border: color.border.overlay on color.surface.overlay · spec/components/drawer.md:44
/stateTokens/open - drawer reduced-motion border: color.border.overlay on color.surface.overlay · spec/components/drawer.md:46
/stateTokens/reduced-motion - dialog focus-trapped outline: color.interaction.focus.ring-container on color.surface.overlay · spec/components/dialog.md:57
/stateTokens/focus-trapped - drawer focus-trapped outline: color.interaction.focus.ring-container on color.surface.overlay · spec/components/drawer.md:45
/stateTokens/focus-trapped - dialog focus-visible outline: color.interaction.focus.ring on color.surface.overlay · spec/components/dialog.md:59
/stateTokens/focus-visible - ring on the overlay surface: color.interaction.focus.ring on color.surface.overlay · spec/components/drawer.md:51
/contrast/3 - title on the overlay surface: color.text.bright on color.surface.overlay · spec/components/dialog.md:62
/contrast/0 - title on the overlay surface: color.text.bright on color.surface.overlay · spec/components/drawer.md:48
/contrast/0 - dialog default fg: color.text.default on color.surface.overlay · spec/components/dialog.md:55
/stateTokens/default - dialog focus-trapped fg: color.text.default on color.surface.overlay · spec/components/dialog.md:57
/stateTokens/focus-trapped - dialog open fg: color.text.default on color.surface.overlay · spec/components/dialog.md:56
/stateTokens/open - dialog reduced-motion fg: color.text.default on color.surface.overlay · spec/components/dialog.md:60
/stateTokens/reduced-motion - drawer default fg: color.text.default on color.surface.overlay · spec/components/drawer.md:43
/stateTokens/default - drawer focus-trapped fg: color.text.default on color.surface.overlay · spec/components/drawer.md:45
/stateTokens/focus-trapped - drawer open fg: color.text.default on color.surface.overlay · spec/components/drawer.md:44
/stateTokens/open - drawer reduced-motion fg: color.text.default on color.surface.overlay · spec/components/drawer.md:46
/stateTokens/reduced-motion - note on the overlay surface: color.text.muted on color.surface.overlay · spec/components/dialog.md:63
/contrast/1 - note on the overlay surface: color.text.muted on color.surface.overlay · spec/components/drawer.md:49
/contrast/1