From cd24eedbf4871dd5ecd91a228bcff586c6494f92 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Mon, 8 Jun 2026 06:35:06 -0500 Subject: docs(theme-selector): document underline and strike in the theme.json contract Record the two new face booleans in the README contract and the spec's state-and-export-policy block, including that the converter writes them as :underline t and :strike-through t. --- docs/design/theme-selector-package-faces-spec.org | 3 ++- scripts/theme-selector/README.md | 8 +++++--- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/design/theme-selector-package-faces-spec.org b/docs/design/theme-selector-package-faces-spec.org index 973f3d72..def6a430 100644 --- a/docs/design/theme-selector-package-faces-spec.org +++ b/docs/design/theme-selector-package-faces-spec.org @@ -307,7 +307,8 @@ Each package face object carries a =source= marker so export can tell a seeded default from a user edit from a deliberate clear: #+begin_src js -{ fg:"#67809c", bg:null, bold:true, italic:false, inherit:null, height:1.0, source:"default" } +{ fg:"#67809c", bg:null, bold:true, italic:false, underline:false, strike:false, inherit:null, height:1.0, source:"default" } +// underline / strike: booleans -> the converter writes :underline t / :strike-through t // height: float multiplier off the base font (1.0 = unchanged); see Relative height // source: "default" (seeded) | "user" (edited) | "cleared" (user removed a default) #+end_src diff --git a/scripts/theme-selector/README.md b/scripts/theme-selector/README.md index b7e8f155..8f63383c 100644 --- a/scripts/theme-selector/README.md +++ b/scripts/theme-selector/README.md @@ -118,6 +118,7 @@ The export (and what a build step consumes): "packages": { "org-mode": { "org-level-1": {"fg": "#67809c", "bg": null, "bold": true, "italic": false, + "underline": false, "strike": false, "inherit": null, "height": 1.3, "source": "default"} } } @@ -127,9 +128,10 @@ The export (and what a build step consumes): - `assignments` maps syntax category keys to hexes; `bg` is the `default` face background, `p` the foreground. - `ui` and `packages` faces carry `fg`/`bg` (hex or `null`), `bold`, `italic`, - and for package faces `inherit` (a face name or `null`), `height` (a float, - omitted at 1.0), and `source` (`"default"` seeded, `"user"` edited, - `"cleared"`). + `underline`, `strike`, and for package faces `inherit` (a face name or + `null`), `height` (a float, omitted at 1.0), and `source` (`"default"` seeded, + `"user"` edited, `"cleared"`). The converter writes `underline` as + `:underline t` and `strike` as `:strike-through t`. - The theme name is both the `name` field and the download filename. Import a `theme.json` to start from a prior theme; a file with no `packages` key still loads. -- cgit v1.2.3