colors.rs

  1#![allow(missing_docs)]
  2
  3use gpui::{App, Hsla, SharedString, WindowBackgroundAppearance};
  4use refineable::Refineable;
  5use std::sync::Arc;
  6use strum::{AsRefStr, EnumIter, IntoEnumIterator};
  7
  8use crate::{
  9    AccentColors, ActiveTheme, PlayerColors, StatusColors, StatusColorsRefinement, SyntaxTheme,
 10    SystemColors,
 11};
 12
 13#[derive(Refineable, Clone, Debug, PartialEq)]
 14#[refineable(Debug, serde::Deserialize)]
 15pub struct ThemeColors {
 16    /// Border color. Used for most borders, is usually a high contrast color.
 17    pub border: Hsla,
 18    /// Border color. Used for deemphasized borders, like a visual divider between two sections
 19    pub border_variant: Hsla,
 20    /// Border color. Used for focused elements, like keyboard focused list item.
 21    pub border_focused: Hsla,
 22    /// Border color. Used for selected elements, like an active search filter or selected checkbox.
 23    pub border_selected: Hsla,
 24    /// Border color. Used for transparent borders. Used for placeholder borders when an element gains a border on state change.
 25    pub border_transparent: Hsla,
 26    /// Border color. Used for disabled elements, like a disabled input or button.
 27    pub border_disabled: Hsla,
 28    /// Border color. Used for elevated surfaces, like a context menu, popup, or dialog.
 29    pub elevated_surface_background: Hsla,
 30    /// Background Color. Used for grounded surfaces like a panel or tab.
 31    pub surface_background: Hsla,
 32    /// Background Color. Used for the app background and blank panels or windows.
 33    pub background: Hsla,
 34    /// Background Color. Used for the background of an element that should have a different background than the surface it's on.
 35    ///
 36    /// Elements might include: Buttons, Inputs, Checkboxes, Radio Buttons...
 37    ///
 38    /// For an element that should have the same background as the surface it's on, use `ghost_element_background`.
 39    pub element_background: Hsla,
 40    /// Background Color. Used for the hover state of an element that should have a different background than the surface it's on.
 41    ///
 42    /// Hover states are triggered by the mouse entering an element, or a finger touching an element on a touch screen.
 43    pub element_hover: Hsla,
 44    /// Background Color. Used for the active state of an element that should have a different background than the surface it's on.
 45    ///
 46    /// Active states are triggered by the mouse button being pressed down on an element, or the Return button or other activator being pressed.
 47    pub element_active: Hsla,
 48    /// Background Color. Used for the selected state of an element that should have a different background than the surface it's on.
 49    ///
 50    /// Selected states are triggered by the element being selected (or "activated") by the user.
 51    ///
 52    /// This could include a selected checkbox, a toggleable button that is toggled on, etc.
 53    pub element_selected: Hsla,
 54    /// Background Color. Used for the background of selections in a UI element.
 55    pub element_selection_background: Hsla,
 56    /// Background Color. Used for the disabled state of an element that should have a different background than the surface it's on.
 57    ///
 58    /// Disabled states are shown when a user cannot interact with an element, like a disabled button or input.
 59    pub element_disabled: Hsla,
 60    /// Background Color. Used for the area that shows where a dragged element will be dropped.
 61    pub drop_target_background: Hsla,
 62    /// Border Color. Used for the border that shows where a dragged element will be dropped.
 63    pub drop_target_border: Hsla,
 64    /// Used for the background of a ghost element that should have the same background as the surface it's on.
 65    ///
 66    /// Elements might include: Buttons, Inputs, Checkboxes, Radio Buttons...
 67    ///
 68    /// For an element that should have a different background than the surface it's on, use `element_background`.
 69    pub ghost_element_background: Hsla,
 70    /// Background Color. Used for the hover state of a ghost element that should have the same background as the surface it's on.
 71    ///
 72    /// Hover states are triggered by the mouse entering an element, or a finger touching an element on a touch screen.
 73    pub ghost_element_hover: Hsla,
 74    /// Background Color. Used for the active state of a ghost element that should have the same background as the surface it's on.
 75    ///
 76    /// Active states are triggered by the mouse button being pressed down on an element, or the Return button or other activator being pressed.
 77    pub ghost_element_active: Hsla,
 78    /// Background Color. Used for the selected state of a ghost element that should have the same background as the surface it's on.
 79    ///
 80    /// Selected states are triggered by the element being selected (or "activated") by the user.
 81    ///
 82    /// This could include a selected checkbox, a toggleable button that is toggled on, etc.
 83    pub ghost_element_selected: Hsla,
 84    /// Background Color. Used for the disabled state of a ghost element that should have the same background as the surface it's on.
 85    ///
 86    /// Disabled states are shown when a user cannot interact with an element, like a disabled button or input.
 87    pub ghost_element_disabled: Hsla,
 88    /// Text Color. Default text color used for most text.
 89    pub text: Hsla,
 90    /// Text Color. Color of muted or deemphasized text. It is a subdued version of the standard text color.
 91    pub text_muted: Hsla,
 92    /// Text Color. Color of the placeholder text typically shown in input fields to guide the user to enter valid data.
 93    pub text_placeholder: Hsla,
 94    /// Text Color. Color used for text denoting disabled elements. Typically, the color is faded or grayed out to emphasize the disabled state.
 95    pub text_disabled: Hsla,
 96    /// Text Color. Color used for emphasis or highlighting certain text, like an active filter or a matched character in a search.
 97    pub text_accent: Hsla,
 98    /// Fill Color. Used for the default fill color of an icon.
 99    pub icon: Hsla,
100    /// Fill Color. Used for the muted or deemphasized fill color of an icon.
101    ///
102    /// This might be used to show an icon in an inactive pane, or to deemphasize a series of icons to give them less visual weight.
103    pub icon_muted: Hsla,
104    /// Fill Color. Used for the disabled fill color of an icon.
105    ///
106    /// Disabled states are shown when a user cannot interact with an element, like a icon button.
107    pub icon_disabled: Hsla,
108    /// Fill Color. Used for the placeholder fill color of an icon.
109    ///
110    /// This might be used to show an icon in an input that disappears when the user enters text.
111    pub icon_placeholder: Hsla,
112    /// Fill Color. Used for the accent fill color of an icon.
113    ///
114    /// This might be used to show when a toggleable icon button is selected.
115    pub icon_accent: Hsla,
116    /// Color used to accent some debugger elements
117    /// Is used by breakpoints
118    pub debugger_accent: Hsla,
119
120    // ===
121    // UI Elements
122    // ===
123    pub status_bar_background: Hsla,
124    pub title_bar_background: Hsla,
125    pub title_bar_inactive_background: Hsla,
126    pub toolbar_background: Hsla,
127    pub tab_bar_background: Hsla,
128    pub tab_inactive_background: Hsla,
129    pub tab_active_background: Hsla,
130    pub search_match_background: Hsla,
131    pub search_active_match_background: Hsla,
132    pub panel_background: Hsla,
133    pub panel_focused_border: Hsla,
134    pub panel_indent_guide: Hsla,
135    pub panel_indent_guide_hover: Hsla,
136    pub panel_indent_guide_active: Hsla,
137
138    /// The color of the overlay surface on top of panel.
139    pub panel_overlay_background: Hsla,
140    /// The color of the overlay surface on top of panel when hovered over.
141    pub panel_overlay_hover: Hsla,
142
143    pub pane_focused_border: Hsla,
144    pub pane_group_border: Hsla,
145    /// The color of the scrollbar thumb.
146    pub scrollbar_thumb_background: Hsla,
147    /// The color of the scrollbar thumb when hovered over.
148    pub scrollbar_thumb_hover_background: Hsla,
149    /// The color of the scrollbar thumb whilst being actively dragged.
150    pub scrollbar_thumb_active_background: Hsla,
151    /// The border color of the scrollbar thumb.
152    pub scrollbar_thumb_border: Hsla,
153    /// The background color of the scrollbar track.
154    pub scrollbar_track_background: Hsla,
155    /// The border color of the scrollbar track.
156    pub scrollbar_track_border: Hsla,
157    /// The color of the minimap thumb.
158    pub minimap_thumb_background: Hsla,
159    /// The color of the minimap thumb when hovered over.
160    pub minimap_thumb_hover_background: Hsla,
161    /// The color of the minimap thumb whilst being actively dragged.
162    pub minimap_thumb_active_background: Hsla,
163    /// The border color of the minimap thumb.
164    pub minimap_thumb_border: Hsla,
165
166    /// Background color for Vim Normal mode indicator.
167    pub vim_normal_background: Hsla,
168    /// Background color for Vim Insert mode indicator.
169    pub vim_insert_background: Hsla,
170    /// Background color for Vim Replace mode indicator.
171    pub vim_replace_background: Hsla,
172    /// Background color for Vim Visual mode indicator.
173    pub vim_visual_background: Hsla,
174    /// Background color for Vim Visual Line mode indicator.
175    pub vim_visual_line_background: Hsla,
176    /// Background color for Vim Visual Block mode indicator.
177    pub vim_visual_block_background: Hsla,
178    /// Background color for Vim yank highlight.
179    pub vim_yank_background: Hsla,
180    /// Background color for Vim Helix Normal mode indicator.
181    pub vim_helix_normal_background: Hsla,
182    /// Background color for Vim Helix Select mode indicator.
183    pub vim_helix_select_background: Hsla,
184    /// Foreground color for Vim Normal mode indicator.
185    pub vim_normal_foreground: Hsla,
186    /// Foreground color for Vim Insert mode indicator.
187    pub vim_insert_foreground: Hsla,
188    /// Foreground color for Vim Replace mode indicator.
189    pub vim_replace_foreground: Hsla,
190    /// Foreground color for Vim Visual mode indicator.
191    pub vim_visual_foreground: Hsla,
192    /// Foreground color for Vim Visual Line mode indicator.
193    pub vim_visual_line_foreground: Hsla,
194    /// Foreground color for Vim Visual Block mode indicator.
195    pub vim_visual_block_foreground: Hsla,
196    /// Foreground color for Vim Helix Normal mode indicator.
197    pub vim_helix_normal_foreground: Hsla,
198    /// Foreground color for Vim Helix Select mode indicator.
199    pub vim_helix_select_foreground: Hsla,
200
201    // ===
202    // Editor
203    // ===
204    pub editor_foreground: Hsla,
205    pub editor_background: Hsla,
206    pub editor_gutter_background: Hsla,
207    pub editor_subheader_background: Hsla,
208    pub editor_active_line_background: Hsla,
209    pub editor_highlighted_line_background: Hsla,
210    /// Line color of the line a debugger is currently stopped at
211    pub editor_debugger_active_line_background: Hsla,
212    /// Text Color. Used for the text of the line number in the editor gutter.
213    pub editor_line_number: Hsla,
214    /// Text Color. Used for the text of the line number in the editor gutter when the line is highlighted.
215    pub editor_active_line_number: Hsla,
216    /// Text Color. Used for the text of the line number in the editor gutter when the line is hovered over.
217    pub editor_hover_line_number: Hsla,
218    /// Text Color. Used to mark invisible characters in the editor.
219    ///
220    /// Example: spaces, tabs, carriage returns, etc.
221    pub editor_invisible: Hsla,
222    pub editor_wrap_guide: Hsla,
223    pub editor_active_wrap_guide: Hsla,
224    pub editor_indent_guide: Hsla,
225    pub editor_indent_guide_active: Hsla,
226    /// Read-access of a symbol, like reading a variable.
227    ///
228    /// A document highlight is a range inside a text document which deserves
229    /// special attention. Usually a document highlight is visualized by changing
230    /// the background color of its range.
231    pub editor_document_highlight_read_background: Hsla,
232    /// Read-access of a symbol, like reading a variable.
233    ///
234    /// A document highlight is a range inside a text document which deserves
235    /// special attention. Usually a document highlight is visualized by changing
236    /// the background color of its range.
237    pub editor_document_highlight_write_background: Hsla,
238    /// Highlighted brackets background color.
239    ///
240    /// Matching brackets in the cursor scope are highlighted with this background color.
241    pub editor_document_highlight_bracket_background: Hsla,
242
243    // ===
244    // Terminal
245    // ===
246    /// Terminal layout background color.
247    pub terminal_background: Hsla,
248    /// Terminal foreground color.
249    pub terminal_foreground: Hsla,
250    /// Bright terminal foreground color.
251    pub terminal_bright_foreground: Hsla,
252    /// Dim terminal foreground color.
253    pub terminal_dim_foreground: Hsla,
254    /// Terminal ANSI background color.
255    pub terminal_ansi_background: Hsla,
256    /// Black ANSI terminal color.
257    pub terminal_ansi_black: Hsla,
258    /// Bright black ANSI terminal color.
259    pub terminal_ansi_bright_black: Hsla,
260    /// Dim black ANSI terminal color.
261    pub terminal_ansi_dim_black: Hsla,
262    /// Red ANSI terminal color.
263    pub terminal_ansi_red: Hsla,
264    /// Bright red ANSI terminal color.
265    pub terminal_ansi_bright_red: Hsla,
266    /// Dim red ANSI terminal color.
267    pub terminal_ansi_dim_red: Hsla,
268    /// Green ANSI terminal color.
269    pub terminal_ansi_green: Hsla,
270    /// Bright green ANSI terminal color.
271    pub terminal_ansi_bright_green: Hsla,
272    /// Dim green ANSI terminal color.
273    pub terminal_ansi_dim_green: Hsla,
274    /// Yellow ANSI terminal color.
275    pub terminal_ansi_yellow: Hsla,
276    /// Bright yellow ANSI terminal color.
277    pub terminal_ansi_bright_yellow: Hsla,
278    /// Dim yellow ANSI terminal color.
279    pub terminal_ansi_dim_yellow: Hsla,
280    /// Blue ANSI terminal color.
281    pub terminal_ansi_blue: Hsla,
282    /// Bright blue ANSI terminal color.
283    pub terminal_ansi_bright_blue: Hsla,
284    /// Dim blue ANSI terminal color.
285    pub terminal_ansi_dim_blue: Hsla,
286    /// Magenta ANSI terminal color.
287    pub terminal_ansi_magenta: Hsla,
288    /// Bright magenta ANSI terminal color.
289    pub terminal_ansi_bright_magenta: Hsla,
290    /// Dim magenta ANSI terminal color.
291    pub terminal_ansi_dim_magenta: Hsla,
292    /// Cyan ANSI terminal color.
293    pub terminal_ansi_cyan: Hsla,
294    /// Bright cyan ANSI terminal color.
295    pub terminal_ansi_bright_cyan: Hsla,
296    /// Dim cyan ANSI terminal color.
297    pub terminal_ansi_dim_cyan: Hsla,
298    /// White ANSI terminal color.
299    pub terminal_ansi_white: Hsla,
300    /// Bright white ANSI terminal color.
301    pub terminal_ansi_bright_white: Hsla,
302    /// Dim white ANSI terminal color.
303    pub terminal_ansi_dim_white: Hsla,
304
305    /// Represents a link text hover color.
306    pub link_text_hover: Hsla,
307
308    /// Represents an added entry or hunk in vcs, like git.
309    pub version_control_added: Hsla,
310    /// Represents a deleted entry in version control systems.
311    pub version_control_deleted: Hsla,
312    /// Represents a modified entry in version control systems.
313    pub version_control_modified: Hsla,
314    /// Represents a renamed entry in version control systems.
315    pub version_control_renamed: Hsla,
316    /// Represents a conflicting entry in version control systems.
317    pub version_control_conflict: Hsla,
318    /// Represents an ignored entry in version control systems.
319    pub version_control_ignored: Hsla,
320    /// Represents an added word in a word diff.
321    pub version_control_word_added: Hsla,
322    /// Represents a deleted word in a word diff.
323    pub version_control_word_deleted: Hsla,
324    /// Represents the "ours" region of a merge conflict.
325    pub version_control_conflict_marker_ours: Hsla,
326    /// Represents the "theirs" region of a merge conflict.
327    pub version_control_conflict_marker_theirs: Hsla,
328}
329
330#[derive(EnumIter, Debug, Clone, Copy, AsRefStr)]
331#[strum(serialize_all = "snake_case")]
332pub enum ThemeColorField {
333    Border,
334    BorderVariant,
335    BorderFocused,
336    BorderSelected,
337    BorderTransparent,
338    BorderDisabled,
339    ElevatedSurfaceBackground,
340    SurfaceBackground,
341    Background,
342    ElementBackground,
343    ElementHover,
344    ElementActive,
345    ElementSelected,
346    ElementDisabled,
347    DropTargetBackground,
348    DropTargetBorder,
349    GhostElementBackground,
350    GhostElementHover,
351    GhostElementActive,
352    GhostElementSelected,
353    GhostElementDisabled,
354    Text,
355    TextMuted,
356    TextPlaceholder,
357    TextDisabled,
358    TextAccent,
359    Icon,
360    IconMuted,
361    IconDisabled,
362    IconPlaceholder,
363    IconAccent,
364    StatusBarBackground,
365    TitleBarBackground,
366    TitleBarInactiveBackground,
367    ToolbarBackground,
368    TabBarBackground,
369    TabInactiveBackground,
370    TabActiveBackground,
371    SearchMatchBackground,
372    SearchActiveMatchBackground,
373    PanelBackground,
374    PanelFocusedBorder,
375    PanelIndentGuide,
376    PanelIndentGuideHover,
377    PanelIndentGuideActive,
378    PanelOverlayBackground,
379    PanelOverlayHover,
380    PaneFocusedBorder,
381    PaneGroupBorder,
382    ScrollbarThumbBackground,
383    ScrollbarThumbHoverBackground,
384    ScrollbarThumbActiveBackground,
385    ScrollbarThumbBorder,
386    ScrollbarTrackBackground,
387    ScrollbarTrackBorder,
388    MinimapThumbBackground,
389    MinimapThumbHoverBackground,
390    MinimapThumbActiveBackground,
391    MinimapThumbBorder,
392    EditorForeground,
393    EditorBackground,
394    EditorGutterBackground,
395    EditorSubheaderBackground,
396    EditorActiveLineBackground,
397    EditorHighlightedLineBackground,
398    EditorLineNumber,
399    EditorActiveLineNumber,
400    EditorInvisible,
401    EditorWrapGuide,
402    EditorActiveWrapGuide,
403    EditorIndentGuide,
404    EditorIndentGuideActive,
405    EditorDocumentHighlightReadBackground,
406    EditorDocumentHighlightWriteBackground,
407    EditorDocumentHighlightBracketBackground,
408    TerminalBackground,
409    TerminalForeground,
410    TerminalBrightForeground,
411    TerminalDimForeground,
412    TerminalAnsiBackground,
413    TerminalAnsiBlack,
414    TerminalAnsiBrightBlack,
415    TerminalAnsiDimBlack,
416    TerminalAnsiRed,
417    TerminalAnsiBrightRed,
418    TerminalAnsiDimRed,
419    TerminalAnsiGreen,
420    TerminalAnsiBrightGreen,
421    TerminalAnsiDimGreen,
422    TerminalAnsiYellow,
423    TerminalAnsiBrightYellow,
424    TerminalAnsiDimYellow,
425    TerminalAnsiBlue,
426    TerminalAnsiBrightBlue,
427    TerminalAnsiDimBlue,
428    TerminalAnsiMagenta,
429    TerminalAnsiBrightMagenta,
430    TerminalAnsiDimMagenta,
431    TerminalAnsiCyan,
432    TerminalAnsiBrightCyan,
433    TerminalAnsiDimCyan,
434    TerminalAnsiWhite,
435    TerminalAnsiBrightWhite,
436    TerminalAnsiDimWhite,
437    LinkTextHover,
438    VersionControlAdded,
439    VersionControlDeleted,
440    VersionControlModified,
441    VersionControlRenamed,
442    VersionControlConflict,
443    VersionControlIgnored,
444}
445
446impl ThemeColors {
447    pub fn color(&self, field: ThemeColorField) -> Hsla {
448        match field {
449            ThemeColorField::Border => self.border,
450            ThemeColorField::BorderVariant => self.border_variant,
451            ThemeColorField::BorderFocused => self.border_focused,
452            ThemeColorField::BorderSelected => self.border_selected,
453            ThemeColorField::BorderTransparent => self.border_transparent,
454            ThemeColorField::BorderDisabled => self.border_disabled,
455            ThemeColorField::ElevatedSurfaceBackground => self.elevated_surface_background,
456            ThemeColorField::SurfaceBackground => self.surface_background,
457            ThemeColorField::Background => self.background,
458            ThemeColorField::ElementBackground => self.element_background,
459            ThemeColorField::ElementHover => self.element_hover,
460            ThemeColorField::ElementActive => self.element_active,
461            ThemeColorField::ElementSelected => self.element_selected,
462            ThemeColorField::ElementDisabled => self.element_disabled,
463            ThemeColorField::DropTargetBackground => self.drop_target_background,
464            ThemeColorField::DropTargetBorder => self.drop_target_border,
465            ThemeColorField::GhostElementBackground => self.ghost_element_background,
466            ThemeColorField::GhostElementHover => self.ghost_element_hover,
467            ThemeColorField::GhostElementActive => self.ghost_element_active,
468            ThemeColorField::GhostElementSelected => self.ghost_element_selected,
469            ThemeColorField::GhostElementDisabled => self.ghost_element_disabled,
470            ThemeColorField::Text => self.text,
471            ThemeColorField::TextMuted => self.text_muted,
472            ThemeColorField::TextPlaceholder => self.text_placeholder,
473            ThemeColorField::TextDisabled => self.text_disabled,
474            ThemeColorField::TextAccent => self.text_accent,
475            ThemeColorField::Icon => self.icon,
476            ThemeColorField::IconMuted => self.icon_muted,
477            ThemeColorField::IconDisabled => self.icon_disabled,
478            ThemeColorField::IconPlaceholder => self.icon_placeholder,
479            ThemeColorField::IconAccent => self.icon_accent,
480            ThemeColorField::StatusBarBackground => self.status_bar_background,
481            ThemeColorField::TitleBarBackground => self.title_bar_background,
482            ThemeColorField::TitleBarInactiveBackground => self.title_bar_inactive_background,
483            ThemeColorField::ToolbarBackground => self.toolbar_background,
484            ThemeColorField::TabBarBackground => self.tab_bar_background,
485            ThemeColorField::TabInactiveBackground => self.tab_inactive_background,
486            ThemeColorField::TabActiveBackground => self.tab_active_background,
487            ThemeColorField::SearchMatchBackground => self.search_match_background,
488            ThemeColorField::SearchActiveMatchBackground => self.search_active_match_background,
489            ThemeColorField::PanelBackground => self.panel_background,
490            ThemeColorField::PanelFocusedBorder => self.panel_focused_border,
491            ThemeColorField::PanelIndentGuide => self.panel_indent_guide,
492            ThemeColorField::PanelIndentGuideHover => self.panel_indent_guide_hover,
493            ThemeColorField::PanelIndentGuideActive => self.panel_indent_guide_active,
494            ThemeColorField::PanelOverlayBackground => self.panel_overlay_background,
495            ThemeColorField::PanelOverlayHover => self.panel_overlay_hover,
496            ThemeColorField::PaneFocusedBorder => self.pane_focused_border,
497            ThemeColorField::PaneGroupBorder => self.pane_group_border,
498            ThemeColorField::ScrollbarThumbBackground => self.scrollbar_thumb_background,
499            ThemeColorField::ScrollbarThumbHoverBackground => self.scrollbar_thumb_hover_background,
500            ThemeColorField::ScrollbarThumbActiveBackground => {
501                self.scrollbar_thumb_active_background
502            }
503            ThemeColorField::ScrollbarThumbBorder => self.scrollbar_thumb_border,
504            ThemeColorField::ScrollbarTrackBackground => self.scrollbar_track_background,
505            ThemeColorField::ScrollbarTrackBorder => self.scrollbar_track_border,
506            ThemeColorField::MinimapThumbBackground => self.minimap_thumb_background,
507            ThemeColorField::MinimapThumbHoverBackground => self.minimap_thumb_hover_background,
508            ThemeColorField::MinimapThumbActiveBackground => self.minimap_thumb_active_background,
509            ThemeColorField::MinimapThumbBorder => self.minimap_thumb_border,
510            ThemeColorField::EditorForeground => self.editor_foreground,
511            ThemeColorField::EditorBackground => self.editor_background,
512            ThemeColorField::EditorGutterBackground => self.editor_gutter_background,
513            ThemeColorField::EditorSubheaderBackground => self.editor_subheader_background,
514            ThemeColorField::EditorActiveLineBackground => self.editor_active_line_background,
515            ThemeColorField::EditorHighlightedLineBackground => {
516                self.editor_highlighted_line_background
517            }
518            ThemeColorField::EditorLineNumber => self.editor_line_number,
519            ThemeColorField::EditorActiveLineNumber => self.editor_active_line_number,
520            ThemeColorField::EditorInvisible => self.editor_invisible,
521            ThemeColorField::EditorWrapGuide => self.editor_wrap_guide,
522            ThemeColorField::EditorActiveWrapGuide => self.editor_active_wrap_guide,
523            ThemeColorField::EditorIndentGuide => self.editor_indent_guide,
524            ThemeColorField::EditorIndentGuideActive => self.editor_indent_guide_active,
525            ThemeColorField::EditorDocumentHighlightReadBackground => {
526                self.editor_document_highlight_read_background
527            }
528            ThemeColorField::EditorDocumentHighlightWriteBackground => {
529                self.editor_document_highlight_write_background
530            }
531            ThemeColorField::EditorDocumentHighlightBracketBackground => {
532                self.editor_document_highlight_bracket_background
533            }
534            ThemeColorField::TerminalBackground => self.terminal_background,
535            ThemeColorField::TerminalForeground => self.terminal_foreground,
536            ThemeColorField::TerminalBrightForeground => self.terminal_bright_foreground,
537            ThemeColorField::TerminalDimForeground => self.terminal_dim_foreground,
538            ThemeColorField::TerminalAnsiBackground => self.terminal_ansi_background,
539            ThemeColorField::TerminalAnsiBlack => self.terminal_ansi_black,
540            ThemeColorField::TerminalAnsiBrightBlack => self.terminal_ansi_bright_black,
541            ThemeColorField::TerminalAnsiDimBlack => self.terminal_ansi_dim_black,
542            ThemeColorField::TerminalAnsiRed => self.terminal_ansi_red,
543            ThemeColorField::TerminalAnsiBrightRed => self.terminal_ansi_bright_red,
544            ThemeColorField::TerminalAnsiDimRed => self.terminal_ansi_dim_red,
545            ThemeColorField::TerminalAnsiGreen => self.terminal_ansi_green,
546            ThemeColorField::TerminalAnsiBrightGreen => self.terminal_ansi_bright_green,
547            ThemeColorField::TerminalAnsiDimGreen => self.terminal_ansi_dim_green,
548            ThemeColorField::TerminalAnsiYellow => self.terminal_ansi_yellow,
549            ThemeColorField::TerminalAnsiBrightYellow => self.terminal_ansi_bright_yellow,
550            ThemeColorField::TerminalAnsiDimYellow => self.terminal_ansi_dim_yellow,
551            ThemeColorField::TerminalAnsiBlue => self.terminal_ansi_blue,
552            ThemeColorField::TerminalAnsiBrightBlue => self.terminal_ansi_bright_blue,
553            ThemeColorField::TerminalAnsiDimBlue => self.terminal_ansi_dim_blue,
554            ThemeColorField::TerminalAnsiMagenta => self.terminal_ansi_magenta,
555            ThemeColorField::TerminalAnsiBrightMagenta => self.terminal_ansi_bright_magenta,
556            ThemeColorField::TerminalAnsiDimMagenta => self.terminal_ansi_dim_magenta,
557            ThemeColorField::TerminalAnsiCyan => self.terminal_ansi_cyan,
558            ThemeColorField::TerminalAnsiBrightCyan => self.terminal_ansi_bright_cyan,
559            ThemeColorField::TerminalAnsiDimCyan => self.terminal_ansi_dim_cyan,
560            ThemeColorField::TerminalAnsiWhite => self.terminal_ansi_white,
561            ThemeColorField::TerminalAnsiBrightWhite => self.terminal_ansi_bright_white,
562            ThemeColorField::TerminalAnsiDimWhite => self.terminal_ansi_dim_white,
563            ThemeColorField::LinkTextHover => self.link_text_hover,
564            ThemeColorField::VersionControlAdded => self.version_control_added,
565            ThemeColorField::VersionControlDeleted => self.version_control_deleted,
566            ThemeColorField::VersionControlModified => self.version_control_modified,
567            ThemeColorField::VersionControlRenamed => self.version_control_renamed,
568            ThemeColorField::VersionControlConflict => self.version_control_conflict,
569            ThemeColorField::VersionControlIgnored => self.version_control_ignored,
570        }
571    }
572
573    pub fn iter(&self) -> impl Iterator<Item = (ThemeColorField, Hsla)> + '_ {
574        ThemeColorField::iter().map(move |field| (field, self.color(field)))
575    }
576
577    pub fn to_vec(&self) -> Vec<(ThemeColorField, Hsla)> {
578        self.iter().collect()
579    }
580}
581
582pub fn all_theme_colors(cx: &mut App) -> Vec<(Hsla, SharedString)> {
583    let theme = cx.theme();
584    ThemeColorField::iter()
585        .map(|field| {
586            let color = theme.colors().color(field);
587            let name = field.as_ref().to_string();
588            (color, SharedString::from(name))
589        })
590        .collect()
591}
592
593#[derive(Refineable, Clone, Debug, PartialEq)]
594pub struct ThemeStyles {
595    /// The background appearance of the window.
596    pub window_background_appearance: WindowBackgroundAppearance,
597    pub system: SystemColors,
598    /// An array of colors used for theme elements that iterate through a series of colors.
599    ///
600    /// Example: Player colors, rainbow brackets and indent guides, etc.
601    pub accents: AccentColors,
602
603    #[refineable]
604    pub colors: ThemeColors,
605
606    #[refineable]
607    pub status: StatusColors,
608
609    pub player: PlayerColors,
610
611    pub syntax: Arc<SyntaxTheme>,
612}
613
614#[cfg(test)]
615mod tests {
616    use serde_json::json;
617
618    use super::*;
619
620    #[test]
621    fn override_a_single_theme_color() {
622        let mut colors = ThemeColors::light();
623
624        let magenta: Hsla = gpui::rgb(0xff00ff).into();
625
626        assert_ne!(colors.text, magenta);
627
628        let overrides = ThemeColorsRefinement {
629            text: Some(magenta),
630            ..Default::default()
631        };
632
633        colors.refine(&overrides);
634
635        assert_eq!(colors.text, magenta);
636    }
637
638    #[test]
639    fn override_multiple_theme_colors() {
640        let mut colors = ThemeColors::light();
641
642        let magenta: Hsla = gpui::rgb(0xff00ff).into();
643        let green: Hsla = gpui::rgb(0x00ff00).into();
644
645        assert_ne!(colors.text, magenta);
646        assert_ne!(colors.background, green);
647
648        let overrides = ThemeColorsRefinement {
649            text: Some(magenta),
650            background: Some(green),
651            ..Default::default()
652        };
653
654        colors.refine(&overrides);
655
656        assert_eq!(colors.text, magenta);
657        assert_eq!(colors.background, green);
658    }
659
660    #[test]
661    fn deserialize_theme_colors_refinement_from_json() {
662        let colors: ThemeColorsRefinement = serde_json::from_value(json!({
663            "background": "#ff00ff",
664            "text": "#ff0000"
665        }))
666        .unwrap();
667
668        assert_eq!(colors.background, Some(gpui::rgb(0xff00ff).into()));
669        assert_eq!(colors.text, Some(gpui::rgb(0xff0000).into()));
670    }
671}