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 Helix Normal mode indicator.
179    pub vim_helix_normal_background: Hsla,
180    /// Background color for Vim Helix Select mode indicator.
181    pub vim_helix_select_background: Hsla,
182    /// Foreground color for Vim Normal mode indicator.
183    pub vim_normal_foreground: Hsla,
184    /// Foreground color for Vim Insert mode indicator.
185    pub vim_insert_foreground: Hsla,
186    /// Foreground color for Vim Replace mode indicator.
187    pub vim_replace_foreground: Hsla,
188    /// Foreground color for Vim Visual mode indicator.
189    pub vim_visual_foreground: Hsla,
190    /// Foreground color for Vim Visual Line mode indicator.
191    pub vim_visual_line_foreground: Hsla,
192    /// Foreground color for Vim Visual Block mode indicator.
193    pub vim_visual_block_foreground: Hsla,
194    /// Foreground color for Vim Helix Normal mode indicator.
195    pub vim_helix_normal_foreground: Hsla,
196    /// Foreground color for Vim Helix Select mode indicator.
197    pub vim_helix_select_foreground: Hsla,
198
199    // ===
200    // Editor
201    // ===
202    pub editor_foreground: Hsla,
203    pub editor_background: Hsla,
204    pub editor_gutter_background: Hsla,
205    pub editor_subheader_background: Hsla,
206    pub editor_active_line_background: Hsla,
207    pub editor_highlighted_line_background: Hsla,
208    /// Line color of the line a debugger is currently stopped at
209    pub editor_debugger_active_line_background: Hsla,
210    /// Text Color. Used for the text of the line number in the editor gutter.
211    pub editor_line_number: Hsla,
212    /// Text Color. Used for the text of the line number in the editor gutter when the line is highlighted.
213    pub editor_active_line_number: Hsla,
214    /// Text Color. Used for the text of the line number in the editor gutter when the line is hovered over.
215    pub editor_hover_line_number: Hsla,
216    /// Text Color. Used to mark invisible characters in the editor.
217    ///
218    /// Example: spaces, tabs, carriage returns, etc.
219    pub editor_invisible: Hsla,
220    pub editor_wrap_guide: Hsla,
221    pub editor_active_wrap_guide: Hsla,
222    pub editor_indent_guide: Hsla,
223    pub editor_indent_guide_active: Hsla,
224    /// Read-access of a symbol, like reading a variable.
225    ///
226    /// A document highlight is a range inside a text document which deserves
227    /// special attention. Usually a document highlight is visualized by changing
228    /// the background color of its range.
229    pub editor_document_highlight_read_background: Hsla,
230    /// Read-access of a symbol, like reading a variable.
231    ///
232    /// A document highlight is a range inside a text document which deserves
233    /// special attention. Usually a document highlight is visualized by changing
234    /// the background color of its range.
235    pub editor_document_highlight_write_background: Hsla,
236    /// Highlighted brackets background color.
237    ///
238    /// Matching brackets in the cursor scope are highlighted with this background color.
239    pub editor_document_highlight_bracket_background: Hsla,
240
241    // ===
242    // Terminal
243    // ===
244    /// Terminal layout background color.
245    pub terminal_background: Hsla,
246    /// Terminal foreground color.
247    pub terminal_foreground: Hsla,
248    /// Bright terminal foreground color.
249    pub terminal_bright_foreground: Hsla,
250    /// Dim terminal foreground color.
251    pub terminal_dim_foreground: Hsla,
252    /// Terminal ANSI background color.
253    pub terminal_ansi_background: Hsla,
254    /// Black ANSI terminal color.
255    pub terminal_ansi_black: Hsla,
256    /// Bright black ANSI terminal color.
257    pub terminal_ansi_bright_black: Hsla,
258    /// Dim black ANSI terminal color.
259    pub terminal_ansi_dim_black: Hsla,
260    /// Red ANSI terminal color.
261    pub terminal_ansi_red: Hsla,
262    /// Bright red ANSI terminal color.
263    pub terminal_ansi_bright_red: Hsla,
264    /// Dim red ANSI terminal color.
265    pub terminal_ansi_dim_red: Hsla,
266    /// Green ANSI terminal color.
267    pub terminal_ansi_green: Hsla,
268    /// Bright green ANSI terminal color.
269    pub terminal_ansi_bright_green: Hsla,
270    /// Dim green ANSI terminal color.
271    pub terminal_ansi_dim_green: Hsla,
272    /// Yellow ANSI terminal color.
273    pub terminal_ansi_yellow: Hsla,
274    /// Bright yellow ANSI terminal color.
275    pub terminal_ansi_bright_yellow: Hsla,
276    /// Dim yellow ANSI terminal color.
277    pub terminal_ansi_dim_yellow: Hsla,
278    /// Blue ANSI terminal color.
279    pub terminal_ansi_blue: Hsla,
280    /// Bright blue ANSI terminal color.
281    pub terminal_ansi_bright_blue: Hsla,
282    /// Dim blue ANSI terminal color.
283    pub terminal_ansi_dim_blue: Hsla,
284    /// Magenta ANSI terminal color.
285    pub terminal_ansi_magenta: Hsla,
286    /// Bright magenta ANSI terminal color.
287    pub terminal_ansi_bright_magenta: Hsla,
288    /// Dim magenta ANSI terminal color.
289    pub terminal_ansi_dim_magenta: Hsla,
290    /// Cyan ANSI terminal color.
291    pub terminal_ansi_cyan: Hsla,
292    /// Bright cyan ANSI terminal color.
293    pub terminal_ansi_bright_cyan: Hsla,
294    /// Dim cyan ANSI terminal color.
295    pub terminal_ansi_dim_cyan: Hsla,
296    /// White ANSI terminal color.
297    pub terminal_ansi_white: Hsla,
298    /// Bright white ANSI terminal color.
299    pub terminal_ansi_bright_white: Hsla,
300    /// Dim white ANSI terminal color.
301    pub terminal_ansi_dim_white: Hsla,
302
303    /// Represents a link text hover color.
304    pub link_text_hover: Hsla,
305
306    /// Represents an added entry or hunk in vcs, like git.
307    pub version_control_added: Hsla,
308    /// Represents a deleted entry in version control systems.
309    pub version_control_deleted: Hsla,
310    /// Represents a modified entry in version control systems.
311    pub version_control_modified: Hsla,
312    /// Represents a renamed entry in version control systems.
313    pub version_control_renamed: Hsla,
314    /// Represents a conflicting entry in version control systems.
315    pub version_control_conflict: Hsla,
316    /// Represents an ignored entry in version control systems.
317    pub version_control_ignored: Hsla,
318    /// Represents an added word in a word diff.
319    pub version_control_word_added: Hsla,
320    /// Represents a deleted word in a word diff.
321    pub version_control_word_deleted: Hsla,
322    /// Represents the "ours" region of a merge conflict.
323    pub version_control_conflict_marker_ours: Hsla,
324    /// Represents the "theirs" region of a merge conflict.
325    pub version_control_conflict_marker_theirs: Hsla,
326}
327
328#[derive(EnumIter, Debug, Clone, Copy, AsRefStr)]
329#[strum(serialize_all = "snake_case")]
330pub enum ThemeColorField {
331    Border,
332    BorderVariant,
333    BorderFocused,
334    BorderSelected,
335    BorderTransparent,
336    BorderDisabled,
337    ElevatedSurfaceBackground,
338    SurfaceBackground,
339    Background,
340    ElementBackground,
341    ElementHover,
342    ElementActive,
343    ElementSelected,
344    ElementDisabled,
345    DropTargetBackground,
346    DropTargetBorder,
347    GhostElementBackground,
348    GhostElementHover,
349    GhostElementActive,
350    GhostElementSelected,
351    GhostElementDisabled,
352    Text,
353    TextMuted,
354    TextPlaceholder,
355    TextDisabled,
356    TextAccent,
357    Icon,
358    IconMuted,
359    IconDisabled,
360    IconPlaceholder,
361    IconAccent,
362    StatusBarBackground,
363    TitleBarBackground,
364    TitleBarInactiveBackground,
365    ToolbarBackground,
366    TabBarBackground,
367    TabInactiveBackground,
368    TabActiveBackground,
369    SearchMatchBackground,
370    SearchActiveMatchBackground,
371    PanelBackground,
372    PanelFocusedBorder,
373    PanelIndentGuide,
374    PanelIndentGuideHover,
375    PanelIndentGuideActive,
376    PanelOverlayBackground,
377    PanelOverlayHover,
378    PaneFocusedBorder,
379    PaneGroupBorder,
380    ScrollbarThumbBackground,
381    ScrollbarThumbHoverBackground,
382    ScrollbarThumbActiveBackground,
383    ScrollbarThumbBorder,
384    ScrollbarTrackBackground,
385    ScrollbarTrackBorder,
386    MinimapThumbBackground,
387    MinimapThumbHoverBackground,
388    MinimapThumbActiveBackground,
389    MinimapThumbBorder,
390    EditorForeground,
391    EditorBackground,
392    EditorGutterBackground,
393    EditorSubheaderBackground,
394    EditorActiveLineBackground,
395    EditorHighlightedLineBackground,
396    EditorLineNumber,
397    EditorActiveLineNumber,
398    EditorInvisible,
399    EditorWrapGuide,
400    EditorActiveWrapGuide,
401    EditorIndentGuide,
402    EditorIndentGuideActive,
403    EditorDocumentHighlightReadBackground,
404    EditorDocumentHighlightWriteBackground,
405    EditorDocumentHighlightBracketBackground,
406    TerminalBackground,
407    TerminalForeground,
408    TerminalBrightForeground,
409    TerminalDimForeground,
410    TerminalAnsiBackground,
411    TerminalAnsiBlack,
412    TerminalAnsiBrightBlack,
413    TerminalAnsiDimBlack,
414    TerminalAnsiRed,
415    TerminalAnsiBrightRed,
416    TerminalAnsiDimRed,
417    TerminalAnsiGreen,
418    TerminalAnsiBrightGreen,
419    TerminalAnsiDimGreen,
420    TerminalAnsiYellow,
421    TerminalAnsiBrightYellow,
422    TerminalAnsiDimYellow,
423    TerminalAnsiBlue,
424    TerminalAnsiBrightBlue,
425    TerminalAnsiDimBlue,
426    TerminalAnsiMagenta,
427    TerminalAnsiBrightMagenta,
428    TerminalAnsiDimMagenta,
429    TerminalAnsiCyan,
430    TerminalAnsiBrightCyan,
431    TerminalAnsiDimCyan,
432    TerminalAnsiWhite,
433    TerminalAnsiBrightWhite,
434    TerminalAnsiDimWhite,
435    LinkTextHover,
436    VersionControlAdded,
437    VersionControlDeleted,
438    VersionControlModified,
439    VersionControlRenamed,
440    VersionControlConflict,
441    VersionControlIgnored,
442}
443
444impl ThemeColors {
445    pub fn color(&self, field: ThemeColorField) -> Hsla {
446        match field {
447            ThemeColorField::Border => self.border,
448            ThemeColorField::BorderVariant => self.border_variant,
449            ThemeColorField::BorderFocused => self.border_focused,
450            ThemeColorField::BorderSelected => self.border_selected,
451            ThemeColorField::BorderTransparent => self.border_transparent,
452            ThemeColorField::BorderDisabled => self.border_disabled,
453            ThemeColorField::ElevatedSurfaceBackground => self.elevated_surface_background,
454            ThemeColorField::SurfaceBackground => self.surface_background,
455            ThemeColorField::Background => self.background,
456            ThemeColorField::ElementBackground => self.element_background,
457            ThemeColorField::ElementHover => self.element_hover,
458            ThemeColorField::ElementActive => self.element_active,
459            ThemeColorField::ElementSelected => self.element_selected,
460            ThemeColorField::ElementDisabled => self.element_disabled,
461            ThemeColorField::DropTargetBackground => self.drop_target_background,
462            ThemeColorField::DropTargetBorder => self.drop_target_border,
463            ThemeColorField::GhostElementBackground => self.ghost_element_background,
464            ThemeColorField::GhostElementHover => self.ghost_element_hover,
465            ThemeColorField::GhostElementActive => self.ghost_element_active,
466            ThemeColorField::GhostElementSelected => self.ghost_element_selected,
467            ThemeColorField::GhostElementDisabled => self.ghost_element_disabled,
468            ThemeColorField::Text => self.text,
469            ThemeColorField::TextMuted => self.text_muted,
470            ThemeColorField::TextPlaceholder => self.text_placeholder,
471            ThemeColorField::TextDisabled => self.text_disabled,
472            ThemeColorField::TextAccent => self.text_accent,
473            ThemeColorField::Icon => self.icon,
474            ThemeColorField::IconMuted => self.icon_muted,
475            ThemeColorField::IconDisabled => self.icon_disabled,
476            ThemeColorField::IconPlaceholder => self.icon_placeholder,
477            ThemeColorField::IconAccent => self.icon_accent,
478            ThemeColorField::StatusBarBackground => self.status_bar_background,
479            ThemeColorField::TitleBarBackground => self.title_bar_background,
480            ThemeColorField::TitleBarInactiveBackground => self.title_bar_inactive_background,
481            ThemeColorField::ToolbarBackground => self.toolbar_background,
482            ThemeColorField::TabBarBackground => self.tab_bar_background,
483            ThemeColorField::TabInactiveBackground => self.tab_inactive_background,
484            ThemeColorField::TabActiveBackground => self.tab_active_background,
485            ThemeColorField::SearchMatchBackground => self.search_match_background,
486            ThemeColorField::SearchActiveMatchBackground => self.search_active_match_background,
487            ThemeColorField::PanelBackground => self.panel_background,
488            ThemeColorField::PanelFocusedBorder => self.panel_focused_border,
489            ThemeColorField::PanelIndentGuide => self.panel_indent_guide,
490            ThemeColorField::PanelIndentGuideHover => self.panel_indent_guide_hover,
491            ThemeColorField::PanelIndentGuideActive => self.panel_indent_guide_active,
492            ThemeColorField::PanelOverlayBackground => self.panel_overlay_background,
493            ThemeColorField::PanelOverlayHover => self.panel_overlay_hover,
494            ThemeColorField::PaneFocusedBorder => self.pane_focused_border,
495            ThemeColorField::PaneGroupBorder => self.pane_group_border,
496            ThemeColorField::ScrollbarThumbBackground => self.scrollbar_thumb_background,
497            ThemeColorField::ScrollbarThumbHoverBackground => self.scrollbar_thumb_hover_background,
498            ThemeColorField::ScrollbarThumbActiveBackground => {
499                self.scrollbar_thumb_active_background
500            }
501            ThemeColorField::ScrollbarThumbBorder => self.scrollbar_thumb_border,
502            ThemeColorField::ScrollbarTrackBackground => self.scrollbar_track_background,
503            ThemeColorField::ScrollbarTrackBorder => self.scrollbar_track_border,
504            ThemeColorField::MinimapThumbBackground => self.minimap_thumb_background,
505            ThemeColorField::MinimapThumbHoverBackground => self.minimap_thumb_hover_background,
506            ThemeColorField::MinimapThumbActiveBackground => self.minimap_thumb_active_background,
507            ThemeColorField::MinimapThumbBorder => self.minimap_thumb_border,
508            ThemeColorField::EditorForeground => self.editor_foreground,
509            ThemeColorField::EditorBackground => self.editor_background,
510            ThemeColorField::EditorGutterBackground => self.editor_gutter_background,
511            ThemeColorField::EditorSubheaderBackground => self.editor_subheader_background,
512            ThemeColorField::EditorActiveLineBackground => self.editor_active_line_background,
513            ThemeColorField::EditorHighlightedLineBackground => {
514                self.editor_highlighted_line_background
515            }
516            ThemeColorField::EditorLineNumber => self.editor_line_number,
517            ThemeColorField::EditorActiveLineNumber => self.editor_active_line_number,
518            ThemeColorField::EditorInvisible => self.editor_invisible,
519            ThemeColorField::EditorWrapGuide => self.editor_wrap_guide,
520            ThemeColorField::EditorActiveWrapGuide => self.editor_active_wrap_guide,
521            ThemeColorField::EditorIndentGuide => self.editor_indent_guide,
522            ThemeColorField::EditorIndentGuideActive => self.editor_indent_guide_active,
523            ThemeColorField::EditorDocumentHighlightReadBackground => {
524                self.editor_document_highlight_read_background
525            }
526            ThemeColorField::EditorDocumentHighlightWriteBackground => {
527                self.editor_document_highlight_write_background
528            }
529            ThemeColorField::EditorDocumentHighlightBracketBackground => {
530                self.editor_document_highlight_bracket_background
531            }
532            ThemeColorField::TerminalBackground => self.terminal_background,
533            ThemeColorField::TerminalForeground => self.terminal_foreground,
534            ThemeColorField::TerminalBrightForeground => self.terminal_bright_foreground,
535            ThemeColorField::TerminalDimForeground => self.terminal_dim_foreground,
536            ThemeColorField::TerminalAnsiBackground => self.terminal_ansi_background,
537            ThemeColorField::TerminalAnsiBlack => self.terminal_ansi_black,
538            ThemeColorField::TerminalAnsiBrightBlack => self.terminal_ansi_bright_black,
539            ThemeColorField::TerminalAnsiDimBlack => self.terminal_ansi_dim_black,
540            ThemeColorField::TerminalAnsiRed => self.terminal_ansi_red,
541            ThemeColorField::TerminalAnsiBrightRed => self.terminal_ansi_bright_red,
542            ThemeColorField::TerminalAnsiDimRed => self.terminal_ansi_dim_red,
543            ThemeColorField::TerminalAnsiGreen => self.terminal_ansi_green,
544            ThemeColorField::TerminalAnsiBrightGreen => self.terminal_ansi_bright_green,
545            ThemeColorField::TerminalAnsiDimGreen => self.terminal_ansi_dim_green,
546            ThemeColorField::TerminalAnsiYellow => self.terminal_ansi_yellow,
547            ThemeColorField::TerminalAnsiBrightYellow => self.terminal_ansi_bright_yellow,
548            ThemeColorField::TerminalAnsiDimYellow => self.terminal_ansi_dim_yellow,
549            ThemeColorField::TerminalAnsiBlue => self.terminal_ansi_blue,
550            ThemeColorField::TerminalAnsiBrightBlue => self.terminal_ansi_bright_blue,
551            ThemeColorField::TerminalAnsiDimBlue => self.terminal_ansi_dim_blue,
552            ThemeColorField::TerminalAnsiMagenta => self.terminal_ansi_magenta,
553            ThemeColorField::TerminalAnsiBrightMagenta => self.terminal_ansi_bright_magenta,
554            ThemeColorField::TerminalAnsiDimMagenta => self.terminal_ansi_dim_magenta,
555            ThemeColorField::TerminalAnsiCyan => self.terminal_ansi_cyan,
556            ThemeColorField::TerminalAnsiBrightCyan => self.terminal_ansi_bright_cyan,
557            ThemeColorField::TerminalAnsiDimCyan => self.terminal_ansi_dim_cyan,
558            ThemeColorField::TerminalAnsiWhite => self.terminal_ansi_white,
559            ThemeColorField::TerminalAnsiBrightWhite => self.terminal_ansi_bright_white,
560            ThemeColorField::TerminalAnsiDimWhite => self.terminal_ansi_dim_white,
561            ThemeColorField::LinkTextHover => self.link_text_hover,
562            ThemeColorField::VersionControlAdded => self.version_control_added,
563            ThemeColorField::VersionControlDeleted => self.version_control_deleted,
564            ThemeColorField::VersionControlModified => self.version_control_modified,
565            ThemeColorField::VersionControlRenamed => self.version_control_renamed,
566            ThemeColorField::VersionControlConflict => self.version_control_conflict,
567            ThemeColorField::VersionControlIgnored => self.version_control_ignored,
568        }
569    }
570
571    pub fn iter(&self) -> impl Iterator<Item = (ThemeColorField, Hsla)> + '_ {
572        ThemeColorField::iter().map(move |field| (field, self.color(field)))
573    }
574
575    pub fn to_vec(&self) -> Vec<(ThemeColorField, Hsla)> {
576        self.iter().collect()
577    }
578}
579
580pub fn all_theme_colors(cx: &mut App) -> Vec<(Hsla, SharedString)> {
581    let theme = cx.theme();
582    ThemeColorField::iter()
583        .map(|field| {
584            let color = theme.colors().color(field);
585            let name = field.as_ref().to_string();
586            (color, SharedString::from(name))
587        })
588        .collect()
589}
590
591#[derive(Refineable, Clone, Debug, PartialEq)]
592pub struct ThemeStyles {
593    /// The background appearance of the window.
594    pub window_background_appearance: WindowBackgroundAppearance,
595    pub system: SystemColors,
596    /// An array of colors used for theme elements that iterate through a series of colors.
597    ///
598    /// Example: Player colors, rainbow brackets and indent guides, etc.
599    pub accents: AccentColors,
600
601    #[refineable]
602    pub colors: ThemeColors,
603
604    #[refineable]
605    pub status: StatusColors,
606
607    pub player: PlayerColors,
608
609    pub syntax: Arc<SyntaxTheme>,
610}
611
612#[cfg(test)]
613mod tests {
614    use serde_json::json;
615
616    use super::*;
617
618    #[test]
619    fn override_a_single_theme_color() {
620        let mut colors = ThemeColors::light();
621
622        let magenta: Hsla = gpui::rgb(0xff00ff).into();
623
624        assert_ne!(colors.text, magenta);
625
626        let overrides = ThemeColorsRefinement {
627            text: Some(magenta),
628            ..Default::default()
629        };
630
631        colors.refine(&overrides);
632
633        assert_eq!(colors.text, magenta);
634    }
635
636    #[test]
637    fn override_multiple_theme_colors() {
638        let mut colors = ThemeColors::light();
639
640        let magenta: Hsla = gpui::rgb(0xff00ff).into();
641        let green: Hsla = gpui::rgb(0x00ff00).into();
642
643        assert_ne!(colors.text, magenta);
644        assert_ne!(colors.background, green);
645
646        let overrides = ThemeColorsRefinement {
647            text: Some(magenta),
648            background: Some(green),
649            ..Default::default()
650        };
651
652        colors.refine(&overrides);
653
654        assert_eq!(colors.text, magenta);
655        assert_eq!(colors.background, green);
656    }
657
658    #[test]
659    fn deserialize_theme_colors_refinement_from_json() {
660        let colors: ThemeColorsRefinement = serde_json::from_value(json!({
661            "background": "#ff00ff",
662            "text": "#ff0000"
663        }))
664        .unwrap();
665
666        assert_eq!(colors.background, Some(gpui::rgb(0xff00ff).into()));
667        assert_eq!(colors.text, Some(gpui::rgb(0xff0000).into()));
668    }
669}