@adea-ai/themes 0.5.1 → 0.6.1

package/src/generated/schemes.ts

@@ -303,6 +303,70 @@ export const generatedSchemes: Readonly<Record<string, Base24Scheme>> = Object.f
       "base17": "#f398da"
     }
   },
+  "contrast-dark": {
+    "system": "base24",
+    "name": "High Contrast Dark",
+    "author": "Adea",
+    "variant": "dark",
+    "palette": {
+      "base00": "#000000",
+      "base01": "#8f8f8f",
+      "base02": "#264f78",
+      "base03": "#8f8f8f",
+      "base04": "#e5e5e5",
+      "base05": "#ffffff",
+      "base06": "#ffffff",
+      "base07": "#ffffff",
+      "base08": "#ff8183",
+      "base09": "#e3b341",
+      "base0A": "#e3b341",
+      "base0B": "#56d364",
+      "base0C": "#39c5cf",
+      "base0D": "#6ca4f8",
+      "base0E": "#db61a2",
+      "base0F": "#f0c264",
+      "base10": "#8f8f8f",
+      "base11": "#8f8f8f",
+      "base12": "#ff9494",
+      "base13": "#f0c264",
+      "base14": "#79dd8a",
+      "base15": "#66d3dc",
+      "base16": "#8db9ff",
+      "base17": "#e87cb4"
+    }
+  },
+  "contrast-light": {
+    "system": "base24",
+    "name": "High Contrast Light",
+    "author": "Adea",
+    "variant": "light",
+    "palette": {
+      "base00": "#ffffff",
+      "base01": "#767676",
+      "base02": "#b6c7ff",
+      "base03": "#767676",
+      "base04": "#333333",
+      "base05": "#000000",
+      "base06": "#000000",
+      "base07": "#000000",
+      "base08": "#b91c1c",
+      "base09": "#8a5a1b",
+      "base0A": "#8a5a1b",
+      "base0B": "#116a2e",
+      "base0C": "#0e7490",
+      "base0D": "#0b57d0",
+      "base0E": "#a0186f",
+      "base0F": "#a9752c",
+      "base10": "#767676",
+      "base11": "#767676",
+      "base12": "#c94d4d",
+      "base13": "#a9752c",
+      "base14": "#1f9d4f",
+      "base15": "#0891b2",
+      "base16": "#3b82f6",
+      "base17": "#c04a92"
+    }
+  },
   "dracula": {
     "system": "base24",
     "name": "Dracula",
@@ -687,6 +751,70 @@ export const generatedSchemes: Readonly<Record<string, Base24Scheme>> = Object.f
       "base17": "#c4a7e7"
     }
   },
+  "slate-dark": {
+    "system": "base24",
+    "name": "Slate Dark",
+    "author": "Adea",
+    "variant": "dark",
+    "palette": {
+      "base00": "#0f172a",
+      "base01": "#64748b",
+      "base02": "#264f78",
+      "base03": "#64748b",
+      "base04": "#94a3b8",
+      "base05": "#f1f5f9",
+      "base06": "#f1f5f9",
+      "base07": "#f1f5f9",
+      "base08": "#ff8183",
+      "base09": "#e3b341",
+      "base0A": "#e3b341",
+      "base0B": "#56d364",
+      "base0C": "#39c5cf",
+      "base0D": "#6ca4f8",
+      "base0E": "#db61a2",
+      "base0F": "#f0c264",
+      "base10": "#94a3b8",
+      "base11": "#94a3b8",
+      "base12": "#ff9494",
+      "base13": "#f0c264",
+      "base14": "#79dd8a",
+      "base15": "#66d3dc",
+      "base16": "#8db9ff",
+      "base17": "#e87cb4"
+    }
+  },
+  "slate-light": {
+    "system": "base24",
+    "name": "Slate Light",
+    "author": "Adea",
+    "variant": "light",
+    "palette": {
+      "base00": "#f8fafc",
+      "base01": "#64748b",
+      "base02": "#b6c7ff",
+      "base03": "#64748b",
+      "base04": "#475569",
+      "base05": "#0f172a",
+      "base06": "#0f172a",
+      "base07": "#0f172a",
+      "base08": "#b91c1c",
+      "base09": "#8a5a1b",
+      "base0A": "#8a5a1b",
+      "base0B": "#116a2e",
+      "base0C": "#0e7490",
+      "base0D": "#0b57d0",
+      "base0E": "#a0186f",
+      "base0F": "#a9752c",
+      "base10": "#cbd5e1",
+      "base11": "#cbd5e1",
+      "base12": "#c94d4d",
+      "base13": "#a9752c",
+      "base14": "#1f9d4f",
+      "base15": "#0891b2",
+      "base16": "#3b82f6",
+      "base17": "#c04a92"
+    }
+  },
   "solarized-dark": {
     "system": "base24",
     "name": "iTerm2 Solarized Dark",

package/src/generated/themes/contrast-dark.ts

@@ -0,0 +1,77 @@
+/**
+ * Generated by `bun run catalogue:build`. Do not edit.
+ *
+ * The catalogue is committed so that a palette change is a reviewable diff, and
+ * `bun run catalogue:check` fails the build when this file and its inputs
+ * disagree.
+ */
+
+import type { AdeaThemeRecord } from '../../schema.js'
+
+const theme: AdeaThemeRecord = {
+  "id": "contrast-dark",
+  "name": "High Contrast Dark",
+  "appearance": "dark",
+  "colors": {
+    "background": "oklch(0 0 0)",
+    "foreground": "oklch(1 0 0)",
+    "surface": "oklch(0.1448 0 0)",
+    "surfaceElevated": "oklch(0.1448 0 0)",
+    "surfaceHover": "oklch(0.2178 0 0)",
+    "surfaceActive": "oklch(0.2178 0 0)",
+    "border": "oklch(0.65 0 0)",
+    "borderMuted": "oklch(0.65 0 0)",
+    "text": "oklch(1 0 0)",
+    "textMuted": "oklch(0.9219 0 0)",
+    "textSubtle": "oklch(0.65 0 0)",
+    "accent": "oklch(0.7693 0.1175 261.56)",
+    "accentForeground": "oklch(0 0 0)",
+    "success": "oklch(0.8003 0.1821 151.71)",
+    "warning": "oklch(0.7904 0.1386 85.24)",
+    "error": "oklch(0.7116 0.1812 22.84)",
+    "info": "oklch(0.7162 0.1369 258.28)"
+  },
+  "ansi": {
+    "black": "oklch(0.3339 0.0223 256.4)",
+    "red": "oklch(0.7465 0.1536 20.48)",
+    "green": "oklch(0.7717 0.188 145.48)",
+    "yellow": "oklch(0.7904 0.1386 85.24)",
+    "blue": "oklch(0.7162 0.1369 258.28)",
+    "magenta": "oklch(0.662 0.168 349.52)",
+    "cyan": "oklch(0.7555 0.1155 202.14)",
+    "white": "oklch(0.8938 0.014 247.98)",
+    "brightBlack": "oklch(0.4849 0.0196 251.02)",
+    "brightRed": "oklch(0.7793 0.1291 20.43)",
+    "brightGreen": "oklch(0.8159 0.1496 147.95)",
+    "brightYellow": "oklch(0.8363 0.1238 83.41)",
+    "brightBlue": "oklch(0.7814 0.1113 259.45)",
+    "brightMagenta": "oklch(0.723 0.1473 349.04)",
+    "brightCyan": "oklch(0.8063 0.1005 202.61)",
+    "brightWhite": "oklch(0.9593 0.0069 247.9)"
+  },
+  "cursor": "oklch(0.9425 0.0111 243.66)",
+  "selection": "oklch(0.4184 0.0829 250.44)",
+  "family": "contrast",
+  "familyLabel": "High Contrast",
+  "label": "Dark",
+  "description": "Adea’s high-contrast palette for dark appearance.",
+  "provenance": {
+    "project": "Adea",
+    "url": "https://github.com/adea-ai/adea",
+    "license": "Apache-2.0"
+  },
+  "tags": [
+    "dark",
+    "high-contrast"
+  ],
+  "shadcn": {
+    "card": "#0a0a0a",
+    "popover": "#0a0a0a",
+    "secondary": "#1a1a1a",
+    "muted": "#1a1a1a",
+    "border": "#8f8f8f",
+    "input": "#8f8f8f",
+    "ring": "#ffffff"
+  }
+}
+export default theme

package/src/generated/themes/contrast-light.ts

@@ -0,0 +1,77 @@
+/**
+ * Generated by `bun run catalogue:build`. Do not edit.
+ *
+ * The catalogue is committed so that a palette change is a reviewable diff, and
+ * `bun run catalogue:check` fails the build when this file and its inputs
+ * disagree.
+ */
+
+import type { AdeaThemeRecord } from '../../schema.js'
+
+const theme: AdeaThemeRecord = {
+  "id": "contrast-light",
+  "name": "High Contrast Light",
+  "appearance": "light",
+  "colors": {
+    "background": "oklch(1 0 0)",
+    "foreground": "oklch(0 0 0)",
+    "surface": "oklch(1 0 0)",
+    "surfaceElevated": "oklch(1 0 0)",
+    "surfaceHover": "oklch(0.9551 0 0)",
+    "surfaceActive": "oklch(0.9551 0 0)",
+    "border": "oklch(0.5658 0 0)",
+    "borderMuted": "oklch(0.5658 0 0)",
+    "text": "oklch(0 0 0)",
+    "textMuted": "oklch(0.3211 0 0)",
+    "textSubtle": "oklch(0.5658 0 0)",
+    "accent": "oklch(0.3862 0.1436 262.12)",
+    "accentForeground": "oklch(1 0 0)",
+    "success": "oklch(0.3925 0.0896 152.54)",
+    "warning": "oklch(0.5091 0.0985 68.76)",
+    "error": "oklch(0.5054 0.1905 27.52)",
+    "info": "oklch(0.4949 0.1992 260.6)"
+  },
+  "ansi": {
+    "black": "oklch(0.2373 0.0113 254.06)",
+    "red": "oklch(0.5054 0.1905 27.52)",
+    "green": "oklch(0.4606 0.1227 148.77)",
+    "yellow": "oklch(0.5091 0.0985 68.76)",
+    "blue": "oklch(0.4949 0.1992 260.6)",
+    "magenta": "oklch(0.4773 0.185 347.85)",
+    "cyan": "oklch(0.5198 0.0936 223.13)",
+    "white": "oklch(0.4849 0.0196 251.02)",
+    "brightBlack": "oklch(0.4849 0.0196 251.02)",
+    "brightRed": "oklch(0.5864 0.1586 23.34)",
+    "brightGreen": "oklch(0.6127 0.1559 150.57)",
+    "brightYellow": "oklch(0.6026 0.1091 71.79)",
+    "brightBlue": "oklch(0.6231 0.188 259.81)",
+    "brightMagenta": "oklch(0.5889 0.1701 345.97)",
+    "brightCyan": "oklch(0.6089 0.1109 221.72)",
+    "brightWhite": "oklch(0.2785 0.0132 253.04)"
+  },
+  "cursor": "oklch(0.2785 0.0132 253.04)",
+  "selection": "oklch(0.8363 0.081 271.45)",
+  "family": "contrast",
+  "familyLabel": "High Contrast",
+  "label": "Light",
+  "description": "Adea’s high-contrast palette for light appearance.",
+  "provenance": {
+    "project": "Adea",
+    "url": "https://github.com/adea-ai/adea",
+    "license": "Apache-2.0"
+  },
+  "tags": [
+    "light",
+    "high-contrast"
+  ],
+  "shadcn": {
+    "card": "#ffffff",
+    "popover": "#ffffff",
+    "secondary": "#f0f0f0",
+    "muted": "#f0f0f0",
+    "border": "#767676",
+    "input": "#767676",
+    "ring": "#000000"
+  }
+}
+export default theme

package/src/generated/themes/slate-dark.ts

@@ -0,0 +1,79 @@
+/**
+ * Generated by `bun run catalogue:build`. Do not edit.
+ *
+ * The catalogue is committed so that a palette change is a reviewable diff, and
+ * `bun run catalogue:check` fails the build when this file and its inputs
+ * disagree.
+ */
+
+import type { AdeaThemeRecord } from '../../schema.js'
+
+const theme: AdeaThemeRecord = {
+  "id": "slate-dark",
+  "name": "Slate Dark",
+  "appearance": "dark",
+  "colors": {
+    "background": "oklch(0.2077 0.0398 265.75)",
+    "foreground": "oklch(0.9683 0.0069 247.9)",
+    "surface": "oklch(0.2795 0.0368 260.03)",
+    "surfaceElevated": "oklch(0.2795 0.0368 260.03)",
+    "surfaceHover": "oklch(0.3717 0.0392 257.29)",
+    "surfaceActive": "oklch(0.3717 0.0392 257.29)",
+    "border": "oklch(0.7107 0.0351 256.79)",
+    "borderMuted": "oklch(0.7107 0.0351 256.79)",
+    "text": "oklch(0.9683 0.0069 247.9)",
+    "textMuted": "oklch(0.7107 0.0351 256.79)",
+    "textSubtle": "oklch(0.5544 0.0407 257.42)",
+    "accent": "oklch(0.9288 0.0126 255.51)",
+    "accentForeground": "oklch(0.2077 0.0398 265.75)",
+    "success": "oklch(0.8003 0.1821 151.71)",
+    "warning": "oklch(0.7904 0.1386 85.24)",
+    "error": "oklch(0.7106 0.1661 22.22)",
+    "info": "oklch(0.7162 0.1369 258.28)"
+  },
+  "ansi": {
+    "black": "oklch(0.3339 0.0223 256.4)",
+    "red": "oklch(0.7465 0.1536 20.48)",
+    "green": "oklch(0.7717 0.188 145.48)",
+    "yellow": "oklch(0.7904 0.1386 85.24)",
+    "blue": "oklch(0.7162 0.1369 258.28)",
+    "magenta": "oklch(0.662 0.168 349.52)",
+    "cyan": "oklch(0.7555 0.1155 202.14)",
+    "white": "oklch(0.8938 0.014 247.98)",
+    "brightBlack": "oklch(0.4849 0.0196 251.02)",
+    "brightRed": "oklch(0.7793 0.1291 20.43)",
+    "brightGreen": "oklch(0.8159 0.1496 147.95)",
+    "brightYellow": "oklch(0.8363 0.1238 83.41)",
+    "brightBlue": "oklch(0.7814 0.1113 259.45)",
+    "brightMagenta": "oklch(0.723 0.1473 349.04)",
+    "brightCyan": "oklch(0.8063 0.1005 202.61)",
+    "brightWhite": "oklch(0.9593 0.0069 247.9)"
+  },
+  "cursor": "oklch(0.9425 0.0111 243.66)",
+  "selection": "oklch(0.4184 0.0829 250.44)",
+  "family": "slate",
+  "familyLabel": "Slate",
+  "label": "Dark",
+  "description": "Adea’s slate neutral palette for dark appearance.",
+  "provenance": {
+    "project": "Adea",
+    "url": "https://github.com/adea-ai/adea",
+    "license": "Apache-2.0"
+  },
+  "tags": [
+    "dark",
+    "slate",
+    "neutral"
+  ],
+  "shadcn": {
+    "card": "#1e293b",
+    "popover": "#1e293b",
+    "secondary": "#334155",
+    "muted": "#334155",
+    "mutedForeground": "oklch(0.7427 0.0351 256.79)",
+    "border": "rgba(148, 163, 184, 0.2)",
+    "input": "rgba(148, 163, 184, 0.25)",
+    "ring": "#64748b"
+  }
+}
+export default theme

package/src/generated/themes/slate-light.ts

@@ -0,0 +1,78 @@
+/**
+ * Generated by `bun run catalogue:build`. Do not edit.
+ *
+ * The catalogue is committed so that a palette change is a reviewable diff, and
+ * `bun run catalogue:check` fails the build when this file and its inputs
+ * disagree.
+ */
+
+import type { AdeaThemeRecord } from '../../schema.js'
+
+const theme: AdeaThemeRecord = {
+  "id": "slate-light",
+  "name": "Slate Light",
+  "appearance": "light",
+  "colors": {
+    "background": "oklch(0.9842 0.0034 247.86)",
+    "foreground": "oklch(0.2077 0.0398 265.75)",
+    "surface": "oklch(0.9842 0.0034 247.86)",
+    "surfaceElevated": "oklch(0.9842 0.0034 247.86)",
+    "surfaceHover": "oklch(0.9288 0.0126 255.51)",
+    "surfaceActive": "oklch(0.9288 0.0126 255.51)",
+    "border": "oklch(0.869 0.0198 252.89)",
+    "borderMuted": "oklch(0.869 0.0198 252.89)",
+    "text": "oklch(0.2077 0.0398 265.75)",
+    "textMuted": "oklch(0.4455 0.0374 257.28)",
+    "textSubtle": "oklch(0.5544 0.0407 257.42)",
+    "accent": "oklch(0.2077 0.0398 265.75)",
+    "accentForeground": "oklch(0.9842 0.0034 247.86)",
+    "success": "oklch(0.5273 0.1371 150.07)",
+    "warning": "oklch(0.5091 0.0985 68.76)",
+    "error": "oklch(0.5054 0.1905 27.52)",
+    "info": "oklch(0.4949 0.1992 260.6)"
+  },
+  "ansi": {
+    "black": "oklch(0.2373 0.0113 254.06)",
+    "red": "oklch(0.5054 0.1905 27.52)",
+    "green": "oklch(0.4606 0.1227 148.77)",
+    "yellow": "oklch(0.5091 0.0985 68.76)",
+    "blue": "oklch(0.4949 0.1992 260.6)",
+    "magenta": "oklch(0.4773 0.185 347.85)",
+    "cyan": "oklch(0.5198 0.0936 223.13)",
+    "white": "oklch(0.4849 0.0196 251.02)",
+    "brightBlack": "oklch(0.4849 0.0196 251.02)",
+    "brightRed": "oklch(0.5864 0.1586 23.34)",
+    "brightGreen": "oklch(0.6127 0.1559 150.57)",
+    "brightYellow": "oklch(0.6026 0.1091 71.79)",
+    "brightBlue": "oklch(0.6231 0.188 259.81)",
+    "brightMagenta": "oklch(0.5889 0.1701 345.97)",
+    "brightCyan": "oklch(0.6089 0.1109 221.72)",
+    "brightWhite": "oklch(0.2785 0.0132 253.04)"
+  },
+  "cursor": "oklch(0.2785 0.0132 253.04)",
+  "selection": "oklch(0.8363 0.081 271.45)",
+  "family": "slate",
+  "familyLabel": "Slate",
+  "label": "Light",
+  "description": "Adea’s slate neutral palette for light appearance.",
+  "provenance": {
+    "project": "Adea",
+    "url": "https://github.com/adea-ai/adea",
+    "license": "Apache-2.0"
+  },
+  "tags": [
+    "light",
+    "slate",
+    "neutral"
+  ],
+  "shadcn": {
+    "card": "#ffffff",
+    "popover": "#ffffff",
+    "secondary": "#e2e8f0",
+    "muted": "#e2e8f0",
+    "border": "#cbd5e1",
+    "input": "#cbd5e1",
+    "ring": "#64748b"
+  }
+}
+export default theme

package/src/generated/themes.ts

@@ -16,24 +16,28 @@ import theme5 from './themes/catppuccin-frappe.js'
 import theme6 from './themes/catppuccin-latte.js'
 import theme7 from './themes/catppuccin-macchiato.js'
 import theme8 from './themes/catppuccin-mocha.js'
-import theme9 from './themes/dracula.js'
-import theme10 from './themes/everforest-dark.js'
-import theme11 from './themes/everforest-light.js'
-import theme12 from './themes/gruvbox-dark.js'
-import theme13 from './themes/gruvbox-light.js'
-import theme14 from './themes/kanagawa.js'
-import theme15 from './themes/monokai.js'
-import theme16 from './themes/nord.js'
-import theme17 from './themes/one-dark.js'
-import theme18 from './themes/rosepine.js'
-import theme19 from './themes/rosepine-dawn.js'
-import theme20 from './themes/rosepine-moon.js'
-import theme21 from './themes/solarized-dark.js'
-import theme22 from './themes/solarized-light.js'
-import theme23 from './themes/tokyonight-day.js'
-import theme24 from './themes/tokyonight-night.js'
-import theme25 from './themes/tokyonight-storm.js'
-import theme26 from './themes/vesper.js'
+import theme9 from './themes/contrast-dark.js'
+import theme10 from './themes/contrast-light.js'
+import theme11 from './themes/dracula.js'
+import theme12 from './themes/everforest-dark.js'
+import theme13 from './themes/everforest-light.js'
+import theme14 from './themes/gruvbox-dark.js'
+import theme15 from './themes/gruvbox-light.js'
+import theme16 from './themes/kanagawa.js'
+import theme17 from './themes/monokai.js'
+import theme18 from './themes/nord.js'
+import theme19 from './themes/one-dark.js'
+import theme20 from './themes/rosepine.js'
+import theme21 from './themes/rosepine-dawn.js'
+import theme22 from './themes/rosepine-moon.js'
+import theme23 from './themes/slate-dark.js'
+import theme24 from './themes/slate-light.js'
+import theme25 from './themes/solarized-dark.js'
+import theme26 from './themes/solarized-light.js'
+import theme27 from './themes/tokyonight-day.js'
+import theme28 from './themes/tokyonight-night.js'
+import theme29 from './themes/tokyonight-storm.js'
+import theme30 from './themes/vesper.js'
 
 /** Every theme in the catalogue, ordered by id. */
 export const generatedThemes: readonly AdeaThemeRecord[] = Object.freeze([
@@ -64,4 +68,8 @@ export const generatedThemes: readonly AdeaThemeRecord[] = Object.freeze([
   theme24,
   theme25,
   theme26,
+  theme27,
+  theme28,
+  theme29,
+  theme30,
 ])

package/src/index.ts

@@ -9,11 +9,11 @@
  * The design is described in four decisions, and the rest of this package follows
  * from them.
  *
- * **Adea owns the schema and the transformation, not the colours.** The seventeen
- * surface roles in `schema.ts` are the contract, and no upstream project is asked
- * to satisfy it. The palettes in `palettes/` are other people's, reproduced from a
- * pinned revision, each recording the project it belongs to and the licence it is
- * used under. Normalizing them is this package's job and it happens once, here.
+ * **Adea owns the schema and the transformation.** The seventeen surface roles in
+ * `schema.ts` are the contract, and no upstream project is asked to satisfy it. The
+ * Base24 palettes in `palettes/` are reproduced from a pinned revision; the Slate
+ * and High Contrast families are Adea-authored semantic palettes. Normalizing inputs
+ * is this package's job and it happens once, here.
  *
  * **OKLCH is the representation.** Every role is an `oklch()` string. Lightness in
  * OKLCH is perceptually uniform, which is what lets a surface ladder be built by
@@ -55,6 +55,7 @@ export type {
   ThemeFamily,
   ThemeMetadata,
   ThemeProvenance,
+  ShadcnThemeProjection,
 } from './schema.js'
 export { ANSI_KEYS, THEME_COLOR_KEYS } from './schema.js'
 
@@ -122,11 +123,12 @@ export type { NormalizationFinding, NormalizedTheme, ThemeSourceSpec } from './n
 export { CONTRAST_FLOORS, normalizeTheme } from './normalize.js'
 
 /* --- Derived colours --------------------------------------------------- */
-export type { StatusRole, SyntaxRole } from './derive.js'
+export type { EditorRole, StatusRole, SyntaxRole } from './derive.js'
 export {
   CHART_SERIES,
   STATUS_ROLES,
   chartSeries,
+  editorRolesHex,
   statusForeground,
   statusForegroundHex,
   syntaxRoles,

package/src/normalize.ts

@@ -50,6 +50,7 @@ import type {
   AdeaThemeColors,
   AdeaThemeRecord,
   AnsiKey,
+  ShadcnThemeProjection,
   ThemeAppearance,
   ThemeProvenance,
 } from './schema.js'
@@ -212,6 +213,8 @@ export interface ThemeSourceSpec {
   accentSlot?: AnsiKey
   /** Explicit roles for authored themes, applied after derivation. */
   colors?: Partial<AdeaThemeColors>
+  /** Exact adapter values for authored distinctions outside the canonical roles. */
+  shadcn?: ShadcnThemeProjection
   ansi?: Partial<AdeaAnsi>
   cursor?: string
   selection?: string
@@ -1196,6 +1199,7 @@ export function normalizeTheme(source: ThemeSourceSpec): NormalizedTheme {
       description: source.description,
       provenance: source.provenance ?? { project: '', url: '', license: '' },
       tags: source.tags,
+      ...(source.shadcn ? { shadcn: source.shadcn } : {}),
     },
     findings,
   }

package/src/schema.ts

@@ -148,6 +148,34 @@ export interface ThemeProvenance {
   bootstrappedFrom?: readonly string[]
 }
 
+/**
+ * Exact shadcn token projections for legacy sources whose vocabulary carries
+ * distinctions the canonical surface roles do not encode.
+ *
+ * These are optional presentation values, not a second palette: canonical roles
+ * remain the default for every adapter, while the shadcn bridge can retain a
+ * source's separate secondary/muted fills, input outline, border alpha, or focus
+ * ring when those were explicitly authored.
+ */
+export interface ShadcnThemeProjection {
+  /** A source surface distinct from the canonical first rung. */
+  card?: string
+  /** A source surface distinct from the canonical second rung. */
+  popover?: string
+  /** A fill distinct from the canonical card surface. */
+  secondary?: string
+  /** A fill distinct from the canonical card surface. */
+  muted?: string
+  /** Text used on a source-specific muted fill. */
+  mutedForeground?: string
+  /** A divider that may carry source-authored alpha. */
+  border?: string
+  /** An input outline that may differ from the divider. */
+  input?: string
+  /** A focus ring that may differ from the canonical interactive accent. */
+  ring?: string
+}
+
 /**
  * A catalogue entry: the theme, plus what a picker and an audit need.
  *
@@ -168,6 +196,11 @@ export interface AdeaThemeRecord extends AdeaTheme {
   provenance: ThemeProvenance
   /** Search and filter terms, e.g. `['dark', 'muted', 'popular']`. */
   tags: readonly string[]
+  /**
+   * Optional exact shadcn presentation values for source roles that do not map
+   * one-to-one onto the canonical schema. Consumed only by the shadcn adapter.
+   */
+  shadcn?: ShadcnThemeProjection
 }
 
 /** A family of themes: one project, one or more variants. */