[elpa] externals/ef-themes 1d7e6e78df: Update to version 0.11.0

[ELPA Syncer]

branch: externals/ef-themes
commit 1d7e6e78df914e8829e6511a935616b0895403ae
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Update to version 0.11.0
---
 CHANGELOG.org | 238 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 README.org    |  22 ++----
 ef-themes.el  |   2 +-
 3 files changed, 245 insertions(+), 17 deletions(-)

diff --git a/CHANGELOG.org b/CHANGELOG.org
index ef5331419a..dcd086cb3f 100644
--- a/CHANGELOG.org
+++ b/CHANGELOG.org
@@ -9,6 +9,244 @@ project's main git repository: 
<https://git.sr.ht/~protesilaos/ef-themes>.
 The newest release is at the top.  For further details, please consult
 the manual: <https://protesilaos.com/emacs/ef-themes>.
 
+* Version 0.11.0 on 2023-03-13
+
+** New options to override the colour palette
+
+It is now possible to tweak the colour values of each theme's palette
+and to change how named colours are mapped to semantic constructs.
+Concretely, each theme's palette consists of two subsets: (i) named
+colours that associate an arbitrary symbol, like =blue-warmer= to a
+colour value such as =#5250ef=, and (ii) semantic colour mappings that
+assign a named colour to constructs like =date-weekend=.
+
+[ For a video demo of the same idea that I implemented in the
+  ~modus-themes~, check /mutatis mutandis/:
+  https://protesilaos.com/codelog/2022-12-17-modus-themes-v4-demo/. ]
+
+The feature is not as fully fledged as in my ~modus-themes~ because
+the latter have a broader scope than the ~ef-themes~.  Still, it is
+comprehensive and will likely cover the needs of users who want to
+tinker with colours.
+
+** The "preview palette" commands have new aliases
+
+The command ~ef-themes-preview-colors~ can now also be called with
+~ef-themes-list-colors~.  Same for ~ef-themes-preview-colors-current~
+which is also known as ~ef-themes-list-colors-current~.
+
+These new names make it easier to "preview" or "list" the given
+palette entries.
+
+** Palette preview commands can show semantic colour mappings
+
+When called with a prefix argument (=C-u= with default key bindings),
+the commands ~ef-themes-preview-colors~, ~ef-themes-preview-colors-current~
+will produce a buffer with the mappings specified in the given palette
+and in user-defined overrides.  Whereas their normal behaviour without
+the prefix argument is to list all the named colours.
+
+In this context, "named colours" are associations between a symbol and
+a colour value like =(blue-warmer "#5250ef")=, whereas "semantic
+colour mappings" describe associations between an abstract construct
+of the interface and a named colour, such as =(variable blue-warmer)=.
+
+** Automatically disable other themes when loading an Ef theme
+
+The user option ~ef-themes-disable-other-themes~ makes the commands
+that load an Ef theme run ~disable-theme~ on anything that is not part
+of the collection.  These commands are ~ef-themes-select~,
+~ef-themes-toggle~, ~ef-themes-load-random~.
+
+The user option is enabled by default.  The reason is that Emacs will
+blithely blend multiple themes that a user loads, leading to a design
+that ranges from mildly annoying to outright unusable.  It is a bad
+default behaviour that hinders accessibility.
+
+Expert users who know what they are doing when blending themes can
+simply disable this user option (or not use the Ef commands for
+loading a theme).
+
+** Stylistic changes
+
+*** Refined deuteranopia warning colours
+
+[ "Deuteranopia" is the technical term for red-green colour deficiency. ]
+
+This concerns the themes ~ef-deuteranopia-dark~ and
+~ef-deuteranopia-light~.  The slightly adjusted colours help further
+differentiate certain constructs in various contexts, such as the Org
+agenda buffer where =SCHEDULED= and =DEADLINE= items need to be told
+apart.
+
+*** Implemented appropriate colour-coded foregrounds in Magit/diff-mode
+
+~diff-mode~ and Magit diff buffers now affect the text colour of the
+added/removed/changed lines to improve their usability.  Before, the
+combination was of a colour-coded background with the main foreground,
+which could make it a bit harder to track lines.
+
+*** Removed the bold weight from Magit diff hunk headings
+  
+Inactive diff hunk headings do not need to be bold, as they are
+already easy to tell apart from their context.  The added bold is
+useful for the currently selected diff hunk, as it draws attention to
+it.
+
+*** Revised all mail-related semantic colour mappings
+
+Buffers such as those of viewing messages with Notmuch, Mu4e, Gnus
+have more appropriate colour combinations in the interest of avoiding
+exaggerations.  Same for the message composition buffers (e.g. what we
+get with the ~compose-mail~ command and its email-client-specific
+counterparts).
+
+*** The background of Notmuch message headers is more noticeable
+
+The ~notmuch~ email client for Emacs has a thread-based view of
+messages where each email starts with its own header.  The slightly
+more noticeable background makes it easier to discern where a new
+message starts.
+
+*** Added support for the powerline package
+
+I added support for this package because other packages depend on it.
+Note though that I have encountered visual glitches with ~powerline~.
+Those occur while switching themes and require a re-run of the
+Powerline setup with =M-x powerline-reset=.
+
+*** Removed the background colour from ~consult~ lines
+  
+The default value of ~consult-line-number-prefix~ inherits from the
+~line-number~ face.  The Ef themes make the latter inherit from
+~default~ in order to have the lines increase/decrease in font size
+when the user calls the ~text-scale-adjust~ command.  This arrangement
+meant that Consult was implicitly getting the main background which
+caused commands like ~consult-line~ to not be highlighted from their
+absolute beginning but only after the line number.
+
+Thanks to Daniel Mendler for bringing this matter to my attention:
+<https://lists.sr.ht/~protesilaos/ef-themes/%3Cb03413a6-cb77-615d-145d-db4eb710bfca%40daniel-mendler.de%3E>.
+
+*** Defined ~consult-file~ to look the same as file names in Grep buffers
+
+This face is used when the user option ~vertico-group-format~ is set
+to nil.  With this change, we keep things consistent in the common
+workflow of using ~consult-grep~ and exporting to a grep buffer via
+~embark-export~.  The packages involved are ~vertico~, ~consult~,
+~embark~.
+
+Thanks to Daniel Mendler for bringing this matter to my attention:
+<https://lists.sr.ht/~protesilaos/ef-themes/%3Cb03413a6-cb77-615d-145d-db4eb710bfca%40daniel-mendler.de%3E#%3C37f01118-1102-d0a9-ce8d-5101f3d44679@daniel-mendler.de%3E>.
+
+
+*** Made ~eglot-diagnostic-tag-unnecessary-face~ a warning
+
+By default it inherits the ~shadow~ face, which makes it
+counter-intuitive as it dims the text instead of bringing it to our
+attention.  The intent of ~eglot-diagnostic-tag-unnecessary-face~ is
+to highlight unused symbols, so this is better presented as an
+informational warning.
+
+Thanks to Augusto Stoffel for bringing this matter to my attention.
+This was done via a private channel and the information is shared with
+permission.
+
+*** Configured ~dashboard~ icons to retain their underlying colour
+  
+The default value of the ~dashboard-items-face~ made all icons use the
+same colour, detracting from their distinctiveness.  Thanks to Thanos
+Apollo for bringing this matter to my attention.  It was done via a
+private channel and the information is shared with permission.
+
+*** Removed the bold weight from Org agenda deadline/scheduled
+
+This makes agenda buffers less noisy.  The original intent was to
+differentiate current/imminent from past/future items, though I feel
+that was the wrong design.  We first want to deal with current tasks
+and do not want to feel overwhelmed by the design.
+
+*** Removed the bold weight from regular expression constructs
+
+This was used for escaped parentheses and the like.  It was making
+certain strings harder to read, such as:
+
+#+begin_example
+"\\(?:\\.\\(?:m\\(?:kv\\|p4\\)\\|ogg\\|webm\\)\\)"
+#+end_example
+
+*** Retrieve any colour value from the palette
+
+[ This is for do-it-yourself users who need to apply colours in custom
+  code they maintain.  As such, it is a bit technical.  Skip to the
+  next heading if you are not such a user. ]
+
+The fuction ~ef-themes-get-color-value~ can be called from Lisp to
+return the value of a color from the active Ef theme palette.  It
+takea a =COLOR= argument and an optional =OVERRIDES=.
+
+=COLOR= is a symbol that represents a named color entry in the
+palette.
+
+<https://protesilaos.com/emacs/ef-themes#h:8dd67bf5-879e-46e5-b277-5bac141f53d1>
+
+If the value is the name of another color entry in the palette (so a
+mapping), this function recurs until it finds the underlying color
+value.
+
+With an optional =OVERRIDES= argument as a non-nil value, it accounts
+for palette overrides.  Else it reads only the default palette.
+
+<https://protesilaos.com/emacs/ef-themes#h:4b923795-4b23-4345-81e5-d1c108a84b6a>
+
+With optional =THEME= as a symbol among ~ef-themes-collection~, use
+the palette of that item.  Else use the current Ef theme.
+
+If =COLOR= is not present in the palette, this function returns the
+=unspecified= symbol, which is safe when used as a face attribute's
+value.
+
+An example with ~ef-summer~ to show how this function behaves
+with/without overrides and when recursive mappings are introduced.
+
+#+begin_src emacs-lisp
+;; Here we show the recursion of palette mappings.  In general, it is
+;; better for the user to specify named colors to avoid possible
+;; confusion with their configuration, though those still work as
+;; expected.
+(setq ef-themes-common-palette-overrides
+      '((cursor red)
+        (prompt cursor)
+        (variable prompt)))
+
+;; Ignore the overrides and get the original value.
+(ef-themes-get-color-value 'variable)
+;; => "#5250ef"
+
+;; Read from the overrides and deal with any recursion to find the
+;; underlying value.
+(ef-themes-get-color-value 'variable :overrides)
+;; => "#d3303a"
+#+end_src
+
+*** Miscellaneous
+
+- Recalibrated the mouse hover background of the ~ef-frost~ theme to
+  stand out a bit more than before.  This is a minor usability
+  enhancement.
+
+- Revised the ~keycast-key~ face for easier use and thematic
+  consistency.  It has a faint border around it but is otherwise
+  consistent with what was present before.
+
+- Improved how the palette preview is rendered.
+
+- Made several internal tweaks that keep the code clean and reusable.
+
+- Clarified the wording of various statements in the manual.
+
+- Expanded the outline headings of all theme files.
+
 * Version 0.10.0 on 2022-12-02
 :PROPERTIES:
 :CUSTOM_ID: h:763e6cf6-78b4-43a0-a582-7b00ce9210cc
diff --git a/README.org b/README.org
index 17997ff8ef..d6a6b76efc 100644
--- a/README.org
+++ b/README.org
@@ -4,9 +4,9 @@
 #+language:              en
 #+options:               ':t toc:nil author:t email:t num:t
 #+startup:               content
-#+macro:                 stable-version 0.10.0
-#+macro:                 release-date 2022-12-02
-#+macro:                 development-version 0.11.0-dev
+#+macro:                 stable-version 0.11.0
+#+macro:                 release-date 2023-03-13
+#+macro:                 development-version 1.0.0-dev
 #+export_file_name:      ef-themes.texi
 #+texinfo_filename:      ef-themes.info
 #+texinfo_dir_category:  Emacs misc features
@@ -212,8 +212,6 @@ change thus requires a theme re-load 
([[#h:a6dd030c-6b6c-4992-83e8-3438b4607b51]
 :CUSTOM_ID: h:b22371a2-9428-4f83-a3ca-884be559cf1d
 :END:
 
-[ Part of {{{development-version}}}. ]
-
 #+vindex: ef-themes-disable-other-themes
 The user option ~ef-themes-disable-other-themes~ controls which themes
 to disable when loading an Ef theme.
@@ -448,10 +446,6 @@ Other examples:
 :END:
 #+cindex: Override color values and semantic color mappings
 
-[ Part of {{{development-version}}}.  For a video demo of the same
-idea that I implemented in the ~modus-themes~, check:
-https://protesilaos.com/codelog/2022-12-17-modus-themes-v4-demo/. ]
-
 Each theme defines its own color palette as well as semantic color
 mappings.  The former is the set of color values such as what shade of
 blue to use.  The latter refers to associations between a color value
@@ -640,8 +634,6 @@ light/dark theme and then loads an appropriate Ef theme at 
random:
 :CUSTOM_ID: h:8dd67bf5-879e-46e5-b277-5bac141f53d1
 :END:
 
-[ Updated as part of {{{development-version}}}. ]
-
 #+findex: ef-themes-preview-colors
 The command ~ef-themes-preview-colors~ uses minibuffer completion to
 select an item from the Ef themes and then produces a buffer with
@@ -720,8 +712,6 @@ their liking.
 :CUSTOM_ID: h:cc1633d3-8e83-45b5-b258-804935f9ee0d
 :END:
 
-[ Part of {{{development-version}}}. ]
-
 [[#h:ec0adf54-c037-4c53-81b8-7eab2303794d][The general approach to advanced 
DIY changes]].
 
 #+findex: ef-themes-get-color-value
@@ -1183,7 +1173,7 @@ everything most users need.
 - consult
 - corfu
 - custom (=M-x customize=)
-- dashboard [part of {{{development-version}}}]
+- dashboard
 - denote
 - dictionary
 - diff-hl
@@ -1214,7 +1204,7 @@ everything most users need.
 - image-dired
 - info
 - isearch, occur, query-replace
-- jit-spell [Part of {{{development-version}}}]
+- jit-spell
 - keycast
 - lin
 - line numbers (~display-line-numbers-mode~ and global variant)
@@ -1236,7 +1226,7 @@ everything most users need.
 - outline-minor-faces
 - package (=M-x list-packages=)
 - perspective
-- powerline [ Part of {{{development-version}}} ]
+- powerline
 - pulsar
 - pulse
 - rainbow-delimiters
diff --git a/ef-themes.el b/ef-themes.el
index dbfbf246ec..a35b1ea01f 100644
--- a/ef-themes.el
+++ b/ef-themes.el
@@ -6,7 +6,7 @@
 ;; Maintainer: Ef-Themes Development <~protesilaos/ef-themes@lists.sr.ht>
 ;; URL: https://git.sr.ht/~protesilaos/ef-themes
 ;; Mailing-List: https://lists.sr.ht/~protesilaos/ef-themes
-;; Version: 0.10.0
+;; Version: 0.11.0
 ;; Package-Requires: ((emacs "27.1"))
 ;; Keywords: faces, theme, accessibility