273be90d42
Now we can load them in via JSON files at launch time. They are embded in the final exe though...
82 lines
2.2 KiB
Markdown
82 lines
2.2 KiB
Markdown
# Theme JSON Format (v1)
|
|
|
|
This document defines the JSON structure for editor themes.
|
|
|
|
- All color values are 6-digit hex strings (for example `#d4d8e1`).
|
|
- Capture keys must be lowercase and must not include `@`.
|
|
- `syntax.exact` overrides `syntax.group`. **These can be any values!**
|
|
- If a capture is missing from both maps, the editor should fall back to the base `line` style.
|
|
|
|
## Full structure
|
|
|
|
```json
|
|
{
|
|
"name": "default",
|
|
"line": { "fg": "#d4d8e1", "bg": "#111418" },
|
|
"background": { "bg": "#111418" },
|
|
"visual_highlight": { "bg": "#2f334d" },
|
|
|
|
"cursors": {
|
|
"normal": { "fg": "#111418", "bg": "#d4d8e1" },
|
|
"insert": { "fg": "#d4d8e1", "bg": "#111418" },
|
|
"command": { "fg": "#111418", "bg": "#d4d8e1" },
|
|
"replace": { "fg": "#d4d8e1", "bg": "#111418" }
|
|
},
|
|
|
|
"gutter": {
|
|
"default": { "fg": "#6b7280", "bg": "#0d1014" },
|
|
"current_line": { "fg": "#c0c8d8", "bg": "#0d1014" }
|
|
},
|
|
|
|
"status_bar": {
|
|
"default": { "fg": "#8f99aa", "bg": "#0d1014" }
|
|
},
|
|
|
|
"command_line": {
|
|
"error": { "fg": "#bf616a", "bg": "#111418" },
|
|
"output_border": { "fg": "#d4d8e1", "bg": "#0d1014" },
|
|
"continue_message": { "fg": "#81a1c1", "bg": "#111418" }
|
|
},
|
|
|
|
"syntax": {
|
|
"group": {
|
|
"comment": "#7f8795",
|
|
"function": "#81a1c1",
|
|
"keyword": "#b48ead",
|
|
"number": "#88c0d0",
|
|
"string": "#a3be8c",
|
|
"type": "#ebcb8b",
|
|
"variable": "#d4d8e1"
|
|
...
|
|
},
|
|
"exact": {
|
|
"comment.documentation": "#8f99aa",
|
|
"function.call": "#81a1c1",
|
|
"keyword.return": "#b48ead",
|
|
"string.escape": "#d08770",
|
|
"variable.parameter": "#c0c8d8",
|
|
...
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Field notes
|
|
|
|
- `name`: theme name shown by `:colorscheme`.
|
|
- `line`: base text style used as the default fallback.
|
|
- `background`: background fill style used for empty space.
|
|
- `visual_highlight`: selection background style.
|
|
- `syntax.group`: fallback colors by capture group (`keyword`, `string`, `comment`, etc.).
|
|
- `syntax.exact`: exact capture overrides (`keyword.function`, `string.escape`, etc.).
|
|
|
|
## Future ideas
|
|
|
|
For now, styles only support foreground/background colors.
|
|
|
|
In a future version we may add optional text attributes such as:
|
|
|
|
- `bold`
|
|
- `italic`
|
|
- `underline`
|