vscode-bauhaus-theme 1.0.1 → 1.2.0

package/.vscodeignore

@@ -9,3 +9,4 @@ palettes.json
 .npmignore
 icon.svg
 screenshot.*
+terminal

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+# [1.2.0](https://github.com/dmnsgn/vscode-bauhaus-theme/compare/v1.1.0...v1.2.0) (2026-10-26)
+
+### Features
+
+* use a dedicated caret color fitted to WCAG 2.1 non-text contrast ([9353c25](https://github.com/dmnsgn/vscode-bauhaus-theme/commit/9353c25d172f46f6a2f67e9bd9a627fd2dd511a4))
+
+# [1.1.0](https://github.com/dmnsgn/vscode-bauhaus-theme/compare/v1.0.1...v1.1.0) (2026-10-01)
+
+### Features
+
+* update terminal colors ([7e64545](https://github.com/dmnsgn/vscode-bauhaus-theme/commit/7e64545df5ad05aae0e25ea694c6804cabe3302e))
+
 ## [1.0.1](https://github.com/dmnsgn/vscode-bauhaus-theme/compare/v1.0.0...v1.0.1) (2026-09-25)
 
 # 1.0.0 (2026-09-25)

package/README.md

@@ -141,9 +141,16 @@ To switch, add the matching snippet to your `settings.json`.
 
 </details>
 
+## Terminal themes
+
+The same colors for the macOS Terminal and iTerm2, generated from the VS Code themes.
+
+- **Terminal**: download [Bauhaus Dark](terminal/macos/Bauhaus%20Dark.terminal) or [Bauhaus Light](terminal/macos/Bauhaus%20Light.terminal), then in `Settings… > Profiles`, click <kbd>…</kbd> > `Import…`.
+- **iTerm2**: download [Bauhaus Dark](terminal/iterm2/Bauhaus%20Dark.itermcolors) or [Bauhaus Light](terminal/iterm2/Bauhaus%20Light.itermcolors), then in `Settings > Profiles > Colors`, pick `Color Presets… > Import…`.
+
 ## Palettes
 
-Contrast is WCAG 2.0 against the editor background.
+Contrast is WCAG 2.0 against the editor background. Terminal hues reach AA (bright: AAA) against the terminal background.
 
 <details>
 <summary>Colors and contrast ratios</summary>
@@ -160,15 +167,15 @@ Contrast is WCAG 2.0 against the editor background.
 | fg.default | `#f2f2f2` |
 | fg.muted   | `#9a9a9a` |
 
-| Hue    | Ink       | Bright (terminal) |
-| ------ | --------- | ----------------- |
-| red    | `#ff6963` | `#ffaba3`         |
-| orange | `#ef7a04` | `#feaf7b`         |
-| yellow | `#c59208` | `#f6b606`         |
-| green  | `#8aa441` | `#afcc69`         |
-| cyan   | `#15acaa` | `#52d3d1`         |
-| blue   | `#769ae2` | `#a2c1fe`         |
-| violet | `#d873e1` | `#f8a2ff`         |
+| Hue    | Ink       | Terminal  | Terminal bright |
+| ------ | --------- | --------- | --------------- |
+| red    | `#ff6963` | `#ff3e42` | `#ff8d84`       |
+| orange | `#ef7a04` | `#d66c03` | `#ff9240`       |
+| yellow | `#c59208` | `#b18201` | `#dea301`       |
+| green  | `#8aa441` | `#79932d` | `#9cb855`       |
+| cyan   | `#15acaa` | `#099997` | `#38bfbc`       |
+| blue   | `#769ae2` | `#6689cf` | `#88adf6`       |
+| violet | `#d873e1` | `#c661cf` | `#ed86f6`       |
 
 | Syntax role | Color     | Contrast on editor | WCAG 2.0 |
 | ----------- | --------- | ------------------ | -------- |
@@ -200,15 +207,15 @@ Contrast is WCAG 2.0 against the editor background.
 | fg.default | `#2b2119` |
 | fg.muted   | `#616161` |
 
-| Hue    | Ink       | Bright (terminal) |
-| ------ | --------- | ----------------- |
-| red    | `#c5031e` | `#8f0113`         |
-| orange | `#9a4c00` | `#703500`         |
-| yellow | `#7e5c05` | `#5a4100`         |
-| green  | `#546903` | `#3b4b01`         |
-| cyan   | `#036d6c` | `#034d4c`         |
-| blue   | `#4060a3` | `#254283`         |
-| violet | `#9935a3` | `#790d83`         |
+| Hue    | Ink       | Terminal  | Terminal bright |
+| ------ | --------- | --------- | --------------- |
+| red    | `#c5031e` | `#c5031f` | `#8f0113`       |
+| orange | `#9a4c00` | `#9a4c00` | `#703500`       |
+| yellow | `#7e5c05` | `#7e5c05` | `#5a4100`       |
+| green  | `#546903` | `#546903` | `#3b4b01`       |
+| cyan   | `#036d6c` | `#036d6c` | `#034d4d`       |
+| blue   | `#4060a3` | `#4060a3` | `#254283`       |
+| violet | `#9935a3` | `#9935a2` | `#790d83`       |
 
 | Syntax role | Color     | Contrast on editor | WCAG 2.0 |
 | ----------- | --------- | ------------------ | -------- |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vscode-bauhaus-theme",
   "displayName": "Bauhaus Theme",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "Bauhaus primary colors on warm black and paper. Dark and light themes, every syntax color WCAG AA.",
   "categories": [
     "Themes"
@@ -39,10 +39,12 @@
   "publisher": "dmnsgn",
   "type": "module",
   "scripts": {
-    "build": "node scripts/build.js",
+    "build": "node scripts/build.js && node scripts/terminal.js",
+    "dev": "code --extensionDevelopmentPath=\"$PWD\" samples",
     "icon": "node scripts/icon.js",
     "reference": "node scripts/reference.js",
-    "screenshot": "node scripts/screenshot.js"
+    "screenshot": "node scripts/screenshot.js",
+    "terminal": "node scripts/terminal.js"
   },
   "contributes": {
     "themes": [
@@ -60,10 +62,11 @@
   },
   "devDependencies": {
     "@resvg/resvg-js": "^2.6.2",
-    "pex-color": "^2.3.0"
+    "pex-color": "^2.3.0",
+    "value-format-table": "^1.0.0"
   },
   "engines": {
-    "node": ">=22.0.0",
+    "node": ">=24.0.0",
     "npm": ">=10.5.1",
     "snowdev": ">=3.0.0-alpha.3",
     "vscode": "^1.90.0"

package/palettes.json

@@ -20,14 +20,23 @@
       "blue": "#769ae2",
       "violet": "#d873e1"
     },
+    "ansi": {
+      "red": "#ff3e42",
+      "orange": "#d66c03",
+      "yellow": "#b18201",
+      "green": "#79932d",
+      "cyan": "#099997",
+      "blue": "#6689cf",
+      "violet": "#c661cf"
+    },
     "bright": {
-      "red": "#ffaba3",
-      "orange": "#feaf7b",
-      "yellow": "#f6b606",
-      "green": "#afcc69",
-      "cyan": "#52d3d1",
-      "blue": "#a2c1fe",
-      "violet": "#f8a2ff"
+      "red": "#ff8d84",
+      "orange": "#ff9240",
+      "yellow": "#dea301",
+      "green": "#9cb855",
+      "cyan": "#38bfbc",
+      "blue": "#88adf6",
+      "violet": "#ed86f6"
     },
     "fill": {
       "red": "#95171d",
@@ -155,12 +164,21 @@
       "blue": "#4060a3",
       "violet": "#9935a3"
     },
+    "ansi": {
+      "red": "#c5031f",
+      "orange": "#9a4c00",
+      "yellow": "#7e5c05",
+      "green": "#546903",
+      "cyan": "#036d6c",
+      "blue": "#4060a3",
+      "violet": "#9935a2"
+    },
     "bright": {
       "red": "#8f0113",
       "orange": "#703500",
       "yellow": "#5a4100",
       "green": "#3b4b01",
-      "cyan": "#034d4c",
+      "cyan": "#034d4d",
       "blue": "#254283",
       "violet": "#790d83"
     },

package/scripts/build.js

@@ -1,5 +1,6 @@
 import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
 
+import { valueFormatTableAsMarkdown } from "value-format-table";
 import reference from "../reference/theme-colors.json" with { type: "json" };
 import { accents } from "../src/accents.js";
 import { contrast } from "../src/color.js";
@@ -92,29 +93,56 @@ const report = palettes.map((palette) => {
 });
 await writeJson("palettes.json", report);
 
+const table = (rows) => valueFormatTableAsMarkdown(rows).trim();
+const code = (color) => `\`${color}\``;
+
 const markdown = report
   .map(
-    ({ type, bg, fg, ink, bright, syntax, fills }) => `### ${capitalize(type)}
-
-| Surface | Color |
-| --- | --- |
-${Object.entries({ ...bg, "fg.default": fg.default, "fg.muted": fg.muted })
-  .map(([key, color]) => `| ${key} | \`${color}\` |`)
-  .join("\n")}
-
-| Hue | Ink | Bright (terminal) |
-| --- | --- | --- |
-${Object.keys(ink)
-  .map((hue) => `| ${hue} | \`${ink[hue]}\` | \`${bright[hue]}\` |`)
-  .join("\n")}
-
-| Syntax role | Color | Contrast on editor | WCAG 2.0 |
-| --- | --- | --- | --- |
-${syntax.map(({ role, color, ratio, grade }) => `| ${role} | \`${color}\` | ${ratio}:1 | ${grade} |`).join("\n")}
-
-| Fill | Text | Contrast | WCAG 2.0 |
-| --- | --- | --- | --- |
-${fills.map(({ hue, color, text, ratio, grade }) => `| ${hue} \`${color}\` | \`${text}\` | ${ratio}:1 | ${grade} |`).join("\n")}
+    ({
+      type,
+      bg,
+      fg,
+      ink,
+      ansi,
+      bright,
+      syntax,
+      fills,
+    }) => `### ${capitalize(type)}
+
+${table(
+  Object.entries({
+    ...bg,
+    "fg.default": fg.default,
+    "fg.muted": fg.muted,
+  }).map(([surface, color]) => ({ Surface: surface, Color: code(color) })),
+)}
+
+${table(
+  Object.keys(ink).map((hue) => ({
+    Hue: hue,
+    Ink: code(ink[hue]),
+    Terminal: code(ansi[hue]),
+    "Terminal bright": code(bright[hue]),
+  })),
+)}
+
+${table(
+  syntax.map(({ role, color, ratio, grade }) => ({
+    "Syntax role": role,
+    Color: code(color),
+    "Contrast on editor": `${ratio}:1`,
+    "WCAG 2.0": grade,
+  })),
+)}
+
+${table(
+  fills.map(({ hue, color, text, ratio, grade }) => ({
+    Fill: `${hue} ${code(color)}`,
+    Text: code(text),
+    Contrast: `${ratio}:1`,
+    "WCAG 2.0": grade,
+  })),
+)}
 `,
   )
   .join("\n");

package/scripts/terminal.js

@@ -0,0 +1,131 @@
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+
+import { flatten, toRgb } from "../src/color.js";
+import { plist } from "../src/plist.js";
+
+const root = new URL("../", import.meta.url);
+const ANSI = [
+  "Black",
+  "Red",
+  "Green",
+  "Yellow",
+  "Blue",
+  "Magenta",
+  "Cyan",
+  "White",
+];
+
+// The VS Code themes are the source: terminal colors are read back from the build output.
+function scheme(colors) {
+  const background = colors["terminal.background"];
+  const foreground = colors["terminal.foreground"];
+  return {
+    background,
+    foreground,
+    cursor: colors["terminalCursor.foreground"],
+    cursorText: background,
+    // Neither terminal blends a translucent selection like VS Code does.
+    selection: flatten(colors["terminal.selectionBackground"], background),
+    link: colors["textLink.foreground"],
+    ansi: [
+      ...ANSI.map((name) => colors[`terminal.ansi${name}`]),
+      ...ANSI.map((name) => colors[`terminal.ansiBright${name}`]),
+    ],
+  };
+}
+
+// iTerm2
+function itermColor(hex) {
+  const [r, g, b] = toRgb(hex);
+  return {
+    "Alpha Component": 1,
+    "Blue Component": b,
+    "Color Space": "sRGB",
+    "Green Component": g,
+    "Red Component": r,
+  };
+}
+
+const iterm = (s) => ({
+  ...Object.fromEntries(
+    s.ansi.map((hex, i) => [`Ansi ${i} Color`, itermColor(hex)]),
+  ),
+  "Background Color": itermColor(s.background),
+  "Bold Color": itermColor(s.foreground),
+  "Cursor Color": itermColor(s.cursor),
+  "Cursor Text Color": itermColor(s.cursorText),
+  "Foreground Color": itermColor(s.foreground),
+  "Link Color": itermColor(s.link),
+  "Selected Text Color": itermColor(s.foreground),
+  "Selection Color": itermColor(s.selection),
+});
+
+// Terminal.app stores each color as an NSKeyedArchiver NSColor. The XML archive format is
+// accepted, and NSID 7 resolves to sRGB without embedding its ICC profile. NSRGB is the
+// fallback for readers ignoring NSCustomColorSpace.
+const uid = (id) => ({ CF$UID: BigInt(id) });
+const classDef = (name) => ({ $classes: [name, "NSObject"], $classname: name });
+
+function archive(hex) {
+  const rgb = toRgb(hex).join(" ");
+  return Buffer.from(
+    plist({
+      $archiver: "NSKeyedArchiver",
+      $objects: [
+        "$null",
+        {
+          $class: uid(4),
+          NSColorSpace: 1n,
+          NSComponents: Buffer.from(`${rgb} 1`),
+          NSCustomColorSpace: uid(2),
+          NSRGB: Buffer.from(`${rgb}\0`),
+        },
+        { $class: uid(3), NSID: 7n },
+        classDef("NSColorSpace"),
+        classDef("NSColor"),
+      ],
+      $top: { root: uid(1) },
+      $version: 100_000n,
+    }),
+  );
+}
+
+const terminal = (s, name) => ({
+  name,
+  type: "Window Settings",
+  ProfileCurrentVersion: 2.09,
+  BackgroundColor: archive(s.background),
+  TextColor: archive(s.foreground),
+  TextBoldColor: archive(s.foreground),
+  CursorColor: archive(s.cursor),
+  SelectionColor: archive(s.selection),
+  ...Object.fromEntries(
+    s.ansi.map((hex, i) => [
+      `ANSI${i < 8 ? "" : "Bright"}${ANSI[i % 8]}Color`,
+      archive(hex),
+    ]),
+  ),
+});
+
+const TARGETS = [
+  { dir: "terminal/iterm2", extension: "itermcolors", format: iterm },
+  { dir: "terminal/macos", extension: "terminal", format: terminal },
+];
+
+await rm(new URL("terminal", root), { recursive: true, force: true });
+for (const { dir } of TARGETS)
+  await mkdir(new URL(dir, root), { recursive: true });
+
+const pkg = JSON.parse(await readFile(new URL("package.json", root)));
+for (const { label, path } of pkg.contributes.themes) {
+  const { colors } = JSON.parse(await readFile(new URL(path, root)));
+  const s = scheme(colors);
+  for (const { dir, extension, format } of TARGETS)
+    await writeFile(
+      new URL(`${dir}/${label}.${extension}`, root),
+      plist(format(s, label)),
+    );
+}
+console.log(
+  `${pkg.contributes.themes.length * TARGETS.length} terminal themes written`,
+);

package/src/accents.js

@@ -1,3 +1,6 @@
+import { fit } from "./color.js";
+import { CHROMA } from "./palettes.js";
+
 /** @typedef {import("./palettes.js").Palette} Palette */
 
 /**
@@ -15,7 +18,8 @@
 
 /**
  * @typedef {object} Accent
- * @property {string} focus Focus border, cursor, progress, links.
+ * @property {string} focus Focus border, progress, links.
+ * @property {string} caret Editor and terminal cursors.
  * @property {ActiveItems} active
  * @property {Pair} statusBar
  * @property {Pair} debugging
@@ -29,6 +33,9 @@ const fill = (p, hue) => ({
   background: p.fill[hue],
   foreground: p.onFill[hue],
 });
+// WCAG 2.1 non-text contrast, on both surfaces a cursor can blink on.
+const caret = (p, hue) =>
+  fit(p.fill[hue], [p.bg.editor, p.bg.chrome], 3, { chroma: CHROMA });
 const chrome = (p) => ({ background: p.bg.chrome, foreground: p.fg.muted });
 const active = (p, activity, panel = activity) => ({
   tab: p.ink.red,
@@ -42,12 +49,13 @@ const active = (p, activity, panel = activity) => ({
  * @property {function(Palette): Accent} accent
  */
 
-/** @type {Object<string, AccentStyle>} */
+/** @type {Record<string, AccentStyle>} */
 export const accents = {
   blocks: {
     name: "Blocks",
     accent: (p) => ({
       focus: p.ink.red,
+      caret: caret(p, "red"),
       active: active(p, "red"),
       statusBar: fill(p, "red"),
       debugging: fill(p, "yellow"),
@@ -61,6 +69,7 @@ export const accents = {
     name: "Restrained",
     accent: (p) => ({
       focus: p.ink.red,
+      caret: caret(p, "red"),
       active: active(p, "red"),
       statusBar: chrome(p),
       debugging: fill(p, "red"),
@@ -74,6 +83,7 @@ export const accents = {
     name: "Tricolor",
     accent: (p) => ({
       focus: p.ink.red,
+      caret: caret(p, "red"),
       active: active(p, "yellow", "blue"),
       statusBar: fill(p, "blue"),
       debugging: fill(p, "red"),

package/src/color.js

@@ -9,8 +9,7 @@ import {
   toOklch as colorToOklch,
 } from "pex-color";
 
-const parse = (hex) => fromHex(create(), hex);
-const format = (color) => toHex(color).toLowerCase();
+const toLowerCaseHex = (color) => toHex(color).toLowerCase();
 const lerp = (a, b, t) => a + (b - a) * t;
 
 /**
@@ -21,7 +20,7 @@ const lerp = (a, b, t) => a + (b - a) * t;
  */
 export function luminance(hex) {
   // WCAG 2.0's 0.03928 linearization threshold and sRGB's 0.04045 give the same result on 8-bit channels.
-  const [r, g, b] = toLinear(parse(hex));
+  const [r, g, b] = toLinear(fromHex([], hex));
   return 0.2126 * r + 0.7152 * g + 0.0722 * b;
 }
 
@@ -37,19 +36,25 @@ export function contrast(a, b) {
   return (hi + 0.05) / (lo + 0.05);
 }
 
+/**
+ * Convert to sRGB channels.
+ *
+ * @param {string} hex
+ * @returns {[number, number, number]} Red, green, blue from 0 to 1.
+ */
+export const toRgb = (hex) => fromHex([], hex);
+
 /**
  * Convert to OKLCH.
  *
  * @param {string} hex
  * @returns {[number, number, number]} Lightness, chroma, hue in turns.
  */
-export const toOklch = (hex) => colorToOklch(parse(hex)).slice(0, 3);
+export const toOklch = (hex) => colorToOklch(fromHex([], hex));
 
 // Tolerance applies to linear values: gamma encoding would make it ~13x stricter near 0.
 const inGamut = (color) =>
-  toLinear(color)
-    .slice(0, 3)
-    .every((v) => v >= -1e-4 && v <= 1 + 1e-4);
+  toLinear(color).every((v) => v >= -1e-4 && v <= 1 + 1e-4);
 
 /**
  * Convert from OKLCH, reducing chroma until the color fits in sRGB.
@@ -58,9 +63,9 @@ const inGamut = (color) =>
  * @returns {string}
  */
 export function fromOklch([L, C, H]) {
-  const color = create();
+  const color = [];
   while (!inGamut(colorFromOklch(color, L, C, H))) C = Math.max(0, C - 0.002);
-  return format(color);
+  return toLowerCaseHex(color);
 }
 
 /**
@@ -72,10 +77,10 @@ export function fromOklch([L, C, H]) {
  * @returns {string}
  */
 export function mix(a, b, t = 0.5) {
-  const [La, Aa, Ba] = toOklab(parse(a));
-  const [Lb, Ab, Bb] = toOklab(parse(b));
-  return format(
-    fromOklab(create(), lerp(La, Lb, t), lerp(Aa, Ab, t), lerp(Ba, Bb, t)),
+  const [La, Aa, Ba] = toOklab(fromHex([], a));
+  const [Lb, Ab, Bb] = toOklab(fromHex([], b));
+  return toLowerCaseHex(
+    fromOklab([], lerp(La, Lb, t), lerp(Aa, Ab, t), lerp(Ba, Bb, t)),
   );
 }
 
@@ -156,7 +161,21 @@ export const mostContrasted = (bg, candidates) =>
  * @returns {string} #RRGGBBAA, or #RRGGBB when opaque.
  */
 export function alpha(hex, opacity) {
-  const color = parse(hex);
+  const color = fromHex([], hex);
   color[3] = opacity;
-  return format(color);
+  return toLowerCaseHex(color);
+}
+
+/**
+ * Composite a translucent color over an opaque background, in sRGB as browsers
+ * do.
+ *
+ * @param {string} hex #RRGGBBAA or #RRGGBB.
+ * @param {string} bg
+ * @returns {string} #RRGGBB.
+ */
+export function flatten(hex, bg) {
+  const [r, g, b, a] = fromHex(create(), hex);
+  const [R, G, B] = fromHex([], bg);
+  return toLowerCaseHex([lerp(R, r, a), lerp(G, g, a), lerp(B, b, a), 1]);
 }

package/src/palettes.js

@@ -34,7 +34,7 @@ const mapValues = (object, fn) =>
 // keeps the tint.
 // Light surfaces have no source match: a paper tint at the same hue.
 // Lines (borders, guides, selected rows) keep the grey-40 on grey-22 step: 1.53:1.
-const [, , WARM_HUE] = toOklch(black);
+const WARM_HUE = toOklch(black)[2];
 const darkEditor = fit(black, black, 1.23);
 const lightEditor = fromOklch([0.945, 0.015, WARM_HUE]);
 
@@ -58,7 +58,8 @@ const SURFACES = {
 const AA = 4.5;
 const AAA = 7;
 // Source blue, green and cyan are greyish (OKLCH chroma ~0.07): too close to the text color once dark.
-const INK = { exact: true, chroma: 1.6 };
+export const CHROMA = 1.6;
+const INK = { exact: true, chroma: CHROMA };
 
 /**
  * @typedef {object} Palette
@@ -66,7 +67,8 @@ const INK = { exact: true, chroma: 1.6 };
  * @property {"dark" | "light"} type
  * @property {Backgrounds} bg
  * @property {Foregrounds} fg
- * @property {Hues} ink Hues for text and marks on backgrounds.
+ * @property {Hues} ink Hues for text on backgrounds.
+ * @property {Hues} ansi Terminal hues.
  * @property {Hues} bright Terminal bright variants.
  * @property {Fills} fill Hues as solid surfaces.
  * @property {Fills} onFill Text on each fill.
@@ -118,6 +120,7 @@ function source(type) {
     bg: { editor, chrome, line },
     fg: { default: text, muted },
     ink: HUES,
+    ansi: HUES,
     bright: mapValues(HUES, (hue) => mix(hue, text, 0.3)),
     fill: FILLS,
     onFill: mapValues(FILLS, (fill) => mostContrasted(fill, [white, black])),
@@ -127,7 +130,8 @@ function source(type) {
 /**
  * Source hues, saturated, at the lightness closest to the backgrounds that
  * reaches WCAG 2.0 AA against editor and chrome. Equal contrast keeps hues
- * apart from the text color on both sides.
+ * apart from the text color on both sides. Terminal hues reach AA (bright: AAA)
+ * against the terminal background only.
  *
  * @param {"dark" | "light"} type
  * @returns {Palette}
@@ -139,7 +143,8 @@ function wcag(type) {
     ...base,
     fg: { ...base.fg, muted: fit(base.fg.muted, backgrounds, AA) },
     ink: mapValues(HUES, (hue) => fit(hue, backgrounds, AA, INK)),
-    bright: mapValues(HUES, (hue) => fit(hue, backgrounds, AAA, INK)),
+    ansi: mapValues(HUES, (hue) => fit(hue, base.bg.chrome, AA, INK)),
+    bright: mapValues(HUES, (hue) => fit(hue, base.bg.chrome, AAA, INK)),
   };
 }
 

package/src/plist.js

@@ -0,0 +1,42 @@
+const escape = (text) =>
+  text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+
+function node(value, depth) {
+  const pad = "\t".repeat(depth);
+  if (Buffer.isBuffer(value))
+    return `${pad}<data>${value.toString("base64")}</data>`;
+  if (Array.isArray(value))
+    return [
+      `${pad}<array>`,
+      ...value.map((item) => node(item, depth + 1)),
+      `${pad}</array>`,
+    ].join("\n");
+  if (typeof value === "object")
+    return [
+      `${pad}<dict>`,
+      ...Object.entries(value).flatMap(([key, item]) => [
+        `${pad}\t<key>${escape(key)}</key>`,
+        node(item, depth + 1),
+      ]),
+      `${pad}</dict>`,
+    ].join("\n");
+  if (typeof value === "boolean") return `${pad}<${value}/>`;
+  if (typeof value === "bigint") return `${pad}<integer>${value}</integer>`;
+  return typeof value === "number"
+    ? `${pad}<real>${value}</real>`
+    : `${pad}<string>${escape(String(value))}</string>`;
+}
+
+/**
+ * Serialize to an XML property list.
+ *
+ * @param {unknown} value Objects become dicts, Buffers become data, BigInts
+ *   become integers and numbers become reals.
+ * @returns {string}
+ */
+export const plist = (value) => `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+${node(value, 0)}
+</plist>
+`;

package/src/syntax.js

@@ -6,6 +6,7 @@
  * tags, constants) → violet, other hues keep their role.
  *
  * @param {Palette} p
+ * @returns {Record<string, string>}
  */
 export const roles = (p) => ({
   text: p.fg.default,
@@ -43,6 +44,7 @@ const jsonKeys = (colors) =>
  * TextMate rules. Later rules win on equal specificity.
  *
  * @param {Palette} p
+ * @returns {object[]}
  */
 export function tokenColors(p) {
   const r = roles(p);
@@ -251,6 +253,7 @@ export function tokenColors(p) {
  * mapping.
  *
  * @param {Palette} p
+ * @returns {Record<string, string | object>}
  */
 export function semanticTokenColors(p) {
   const r = roles(p);