Document highlight queries

[postsolar]

A brief few words on which each one is supposed to mean wouldn't hurt. For example what's the difference between keyword.control.import and include is not obvious. If documentation already exists elsewhere, the comment in config.toml should link to it.

[postsolar]

Potential colorscheme contributors would need unambiguous (to the possible extent) mapping between languages, capture groups and KTS faces. Here's my first try. I left comments marked with ? where I don't myself understand the purpose of a group.

Details

attribute -- "Class attributes, HTML tag attributes" per Helix docs
comment -- Comments
comment.block -- Block comments, like /* ... */ in JavaScript
comment.line -- Single line comments, like // in JavaScript
constant -- Constant values
constant.builtin -- Various builtin constant values
constant.builtin.boolean -- Booleans
constant.character -- Characters
constant.character.escape -- Escaped characters like \n, \r, etc
constant.macro -- ?
constant.numeric -- Numbers
constant.numeric.float -- Floats
constant.numeric.integer -- Integers
constructor -- Constructors
diff.plus -- Additions
diff.minus -- Deletions
diff.delta -- Modifications
diff.delta.moved -- Renamed or moved files or changes
embedded -- ?
error -- Errors
function -- Functions
function.builtin -- Builtin functions
function.macro -- Macros
function.method -- Object methods (?)
function.special -- "Preprocessor in C" per Helix docs
hint -- Is this actually a common TS group?
include -- ?
info -- Is this actually a common TS group?
keyword -- Keywords
keyword.conditional -- ?
keyword.control -- ?
keyword.control.conditional -- Conditional keywords (if/else, cond, case, match, etc)
keyword.control.except -- Duplicate with the one below?
keyword.control.exception -- Exceptions-related keywords (try, catch, throw, etc)
keyword.control.import -- Imports-related keywords (import, export, require, etc)
keyword.control.repeat -- Looping-related keywords (for, while, etc)
keyword.control.return -- Return statements keywords
keyword.directive -- Preprocessor directives
keyword.function -- Function declaration-related keywords (fn, func, etc)
keyword.operator -- Operator keywords (&&, >=, etc)
keyword.special -- ?
keyword.storage -- "Keywords describing how things are stored" per Helix docs
keyword.storage.modifier -- Keywords like const, mut, ref, static, etc
keyword.storage.modifier.mut -- Keywords introducing mutable values
keyword.storage.modifier.ref -- Keywords introducing references
keyword.storage.type -- "The type of something" per Helix docs. Very vague IMO
label -- ?
load -- ?
markup.bold -- Bold text
markup.heading -- Heading text
markup.heading.1 -- Heading size 1 text
markup.heading.2 -- Heading size 2 text
markup.heading.3 -- Heading size 3 text
markup.heading.4 -- Heading size 4 text
markup.heading.5 -- Heading size 5 text
markup.heading.6 -- Heading size 6 text
markup.heading.marker -- ?
markup.italic -- Italic text
markup.link.label -- Non-URL link references
markup.link.text -- URL and image descriptions in links
markup.link.url -- URLs pointed to by links
markup.link.uri -- URIs pointed to by links (?)
markup.list.checked -- Lists' checked items
markup.list.numbered -- Numbered lists' items
markup.list.unchecked -- Lists' unchecked items
markup.list.unnumbered -- Unordered lists (?)
markup.quote -- Quotes
markup.raw -- Simple text (?)
markup.raw.block
markup.raw.inline
markup.strikethrough -- Strike-through text
namespace -- Namespaces
operator -- Operators
punctuation -- General punctuation
punctuation.bracket -- Brackets, braces, etc
punctuation.delimiter -- Commas, pipes, semicolons, etc
punctuation.special -- ?
special -- ?
string -- Strings
string.escape -- Escaped characters in strings (?)
string.regexp -- Regular expressions
string.special -- ?
string.special.path -- Filesystem paths (?)
string.special.symbol -- "Erlang/Elixir atoms, Ruby symbols, Clojure keywords" per Helix docs
string.symbol -- how would this be different from the one above ?
tag -- Tags in HTML, XML, etc
tag.error -- ?
text -- General text
type -- Types
type.builtin -- Builtin types
type.enum.variant -- Enumerations (?) would it apply to sum types as well?
variable -- Variables
variable.builtin -- Builtin variables like self, this, etc
variable.other.member -- "Fields of composite data types (e.g. structs, unions)" per Helix docs
variable.parameter -- Function parameter (?) at the definition site, call site, or both?
warning -- ?

[hadronized]

There is no documentation, and I assume some of them are duplicates / specifications in some specific languages.

I appreciate the effort, we should definitely update the wiki page for colorscheme (here) based from your work. I’ll review a bit more tomorrow and include your ideas.