@adea-ai/themes 0.5.1 → 0.6.0

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'
 

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. */

package/src/sources.ts

@@ -3,8 +3,8 @@
  *
  * Two lists. {@link VENDORED_SOURCES} names the Base24 schemes that
  * `scripts/vendor-palettes.ts` reproduces from upstream, and {@link AUTHORED_SOURCES}
- * is Adea's own theme, which has no upstream to vendor from. Together they are the
- * catalogue's input; `scripts/build-catalogue.ts` runs them all through the
+ * records Adea-owned themes that have no upstream palette to vendor. Together they
+ * are the catalogue's input; `scripts/build-catalogue.ts` runs them all through the
  * normalizer and writes the committed output.
  *
  * ## Provenance is per-family, and it was checked rather than assumed
@@ -29,8 +29,9 @@
  * which is itself derived from `iTerm2-Color-Schemes` at a pinned revision, which
  * is where the per-family values were first published as terminal schemes. Each
  * family's official project is recorded as the design's origin, and the values were
- * checked against those projects' published palettes — the backgrounds and
- * foregrounds of all fourteen families match the official palettes exactly.
+ * checked against those projects' published palettes — imported backgrounds and
+ * foregrounds match their official palettes exactly. Adea's composed and authored
+ * families are asserted from their own source definitions instead.
  *
  * `tests/provenance.test.ts` holds those official values as assertions, so the
  * claim "this is really Catppuccin Mocha" fails the build rather than drifting.
@@ -38,7 +39,7 @@
 
 import type { Base24Slot } from './adapters/base24.js'
 import { CONTRAST_FLOORS } from './normalize.js'
-import type { ThemeAppearance, ThemeProvenance } from './schema.js'
+import type { ShadcnThemeProjection, ThemeAppearance, ThemeProvenance } from './schema.js'
 
 /** The dataset the Base24 schemes are reproduced from. */
 export const CATALOGUE_REPOSITORY = 'https://github.com/williamzujkowski/oklch-terminal-themes'
@@ -338,6 +339,16 @@ export const COMPOSED_SOURCES: readonly ComposedSource[] = Object.freeze([
  */
 export const FAMILY_PROVENANCE: Readonly<Record<string, ThemeProvenance>> = Object.freeze({
   adea: ADEA_PROVENANCE,
+  slate: {
+    project: 'Adea',
+    url: 'https://github.com/adea-ai/adea',
+    license: 'Apache-2.0',
+  },
+  contrast: {
+    project: 'Adea',
+    url: 'https://github.com/adea-ai/adea',
+    license: 'Apache-2.0',
+  },
   catppuccin: {
     project: 'Catppuccin',
     url: 'https://github.com/catppuccin/catppuccin',
@@ -768,24 +779,13 @@ export const VENDORED_SOURCES: readonly VendoredSource[] = Object.freeze([
 ])
 
 /**
- * Adea's own theme.
- *
- * Authored here rather than vendored, and the only entry whose colours are chosen
- * rather than reproduced. It is deliberately a neutral ladder with a monochrome
- * accent — the design system's default has to work as a default for everyone, which
- * means it cannot be anybody's favourite colour.
+ * Adea-authored themes whose exact semantic values have no external palette to vendor.
  *
- * Intentionally empty, and worth leaving that way until something needs it.
- *
- * This was where both default themes lived. They are now
- * {@link COMPOSED_SOURCES} entries instead, which is a better home for them: a
- * composition names the upstream palettes it came from and can be rebuilt when either
- * moves, while an authored entry is a table of values nobody can refresh.
- *
- * The route stays because it is the only way to specify *semantic* roles directly
- * rather than deriving them through Base24 slots — which is what a brand theme with
- * values handed over by a designer would need. Nothing uses it today; if nothing has by
- * the time someone reads this, delete it.
+ * The default pair is composed above because its donors can be named and refreshed.
+ * Slate and High Contrast are retained from the product's own appearance registry:
+ * these hand-maintained semantic roles are the source, not a transcription of a
+ * third-party palette. Their optional shadcn projection keeps distinctions (including
+ * source-authored alpha) that the canonical opaque roles cannot represent.
  */
 export interface AuthoredSource {
   id: string
@@ -794,6 +794,8 @@ export interface AuthoredSource {
   label: string
   name: string
   description: string
+  /** Palette ownership plus any per-appearance lineage for retained ANSI roles. */
+  provenance?: ThemeProvenance
   appearance: ThemeAppearance
   tags: readonly string[]
   /**
@@ -817,6 +819,8 @@ export interface AuthoredSource {
   }
   accent: string
   accentForeground: string
+  /** Exact shadcn values for authored distinctions outside the canonical schema. */
+  shadcn?: ShadcnThemeProjection
   status: {
     success: string
     warning: string
@@ -853,4 +857,221 @@ export interface AuthoredSource {
   selection: string
 }
 
-export const AUTHORED_SOURCES: readonly AuthoredSource[] = Object.freeze([])
+// The Slate and Contrast ANSI values below are carried forward from Adea's existing
+// product theme definitions; no external terminal-scheme lineage is claimed.
+const SLATE_ANSI: AuthoredSource['ansi'] = {
+  black: '#1b1f24',
+  red: '#b91c1c',
+  green: '#116a2e',
+  yellow: '#8a5a1b',
+  blue: '#0b57d0',
+  magenta: '#a0186f',
+  cyan: '#0e7490',
+  white: '#57606a',
+  brightBlack: '#57606a',
+  brightRed: '#c94d4d',
+  brightGreen: '#1f9d4f',
+  brightYellow: '#a9752c',
+  brightBlue: '#3b82f6',
+  brightMagenta: '#c04a92',
+  brightCyan: '#0891b2',
+  brightWhite: '#24292f',
+}
+
+const CONTRAST_ANSI: AuthoredSource['ansi'] = {
+  black: '#2f3742',
+  red: '#ff8183',
+  green: '#56d364',
+  yellow: '#e3b341',
+  blue: '#6ca4f8',
+  magenta: '#db61a2',
+  cyan: '#39c5cf',
+  white: '#d5dde5',
+  brightBlack: '#57606a',
+  brightRed: '#ff9494',
+  brightGreen: '#79dd8a',
+  brightYellow: '#f0c264',
+  brightBlue: '#8db9ff',
+  brightMagenta: '#e87cb4',
+  brightCyan: '#66d3dc',
+  brightWhite: '#eef2f6',
+}
+
+export const AUTHORED_SOURCES: readonly AuthoredSource[] = Object.freeze([
+  {
+    id: 'slate-light',
+    family: 'slate',
+    familyLabel: 'Slate',
+    label: 'Light',
+    name: 'Slate Light',
+    description: 'Adea’s slate neutral palette for light appearance.',
+    provenance: FAMILY_PROVENANCE.slate,
+    appearance: 'light',
+    tags: ['light', 'slate', 'neutral'],
+    ramp: {
+      background: '#f8fafc',
+      foreground: '#0f172a',
+      surface: '#f8fafc',
+      surfaceElevated: '#f8fafc',
+      surfaceHover: '#e2e8f0',
+      surfaceActive: '#e2e8f0',
+      border: '#cbd5e1',
+      borderMuted: '#cbd5e1',
+      textMuted: '#475569',
+      textSubtle: '#64748b',
+    },
+    accent: '#0f172a',
+    accentForeground: '#f8fafc',
+    status: {
+      success: '#15803d',
+      warning: SLATE_ANSI.yellow,
+      error: '#b91c1c',
+      info: SLATE_ANSI.blue,
+    },
+    ansi: SLATE_ANSI,
+    cursor: '#24292f',
+    selection: '#b6c7ff',
+    shadcn: {
+      card: '#ffffff',
+      popover: '#ffffff',
+      secondary: '#e2e8f0',
+      muted: '#e2e8f0',
+      border: '#cbd5e1',
+      input: '#cbd5e1',
+      ring: '#64748b',
+    },
+  },
+  {
+    id: 'slate-dark',
+    family: 'slate',
+    familyLabel: 'Slate',
+    label: 'Dark',
+    name: 'Slate Dark',
+    description: 'Adea’s slate neutral palette for dark appearance.',
+    provenance: FAMILY_PROVENANCE.slate,
+    appearance: 'dark',
+    tags: ['dark', 'slate', 'neutral'],
+    ramp: {
+      background: '#0f172a',
+      foreground: '#f1f5f9',
+      surface: '#1e293b',
+      surfaceElevated: '#1e293b',
+      surfaceHover: '#334155',
+      surfaceActive: '#334155',
+      border: '#94a3b8',
+      borderMuted: '#94a3b8',
+      textMuted: '#94a3b8',
+      textSubtle: '#64748b',
+    },
+    accent: '#e2e8f0',
+    accentForeground: '#0f172a',
+    status: {
+      success: '#4ade80',
+      warning: CONTRAST_ANSI.yellow,
+      error: '#f87171',
+      info: CONTRAST_ANSI.blue,
+    },
+    ansi: CONTRAST_ANSI,
+    cursor: '#e6edf3',
+    selection: '#264f78',
+    shadcn: {
+      card: '#1e293b',
+      popover: '#1e293b',
+      secondary: '#334155',
+      muted: '#334155',
+      // The old #94a3b8 remains canonical `textMuted`, but shared UI components
+      // also pair this role with the #334155 muted fill. Move lightness by the
+      // smallest 0.032 OKLCH step that clears 4.5:1 after sRGB conversion.
+      mutedForeground: 'oklch(0.7427 0.0351 256.79)',
+      border: 'rgba(148, 163, 184, 0.2)',
+      input: 'rgba(148, 163, 184, 0.25)',
+      ring: '#64748b',
+    },
+  },
+  {
+    id: 'contrast-light',
+    family: 'contrast',
+    familyLabel: 'High Contrast',
+    label: 'Light',
+    name: 'High Contrast Light',
+    description: 'Adea’s high-contrast palette for light appearance.',
+    provenance: FAMILY_PROVENANCE.contrast,
+    appearance: 'light',
+    tags: ['light', 'high-contrast'],
+    ramp: {
+      background: '#ffffff',
+      foreground: '#000000',
+      surface: '#ffffff',
+      surfaceElevated: '#ffffff',
+      surfaceHover: '#f0f0f0',
+      surfaceActive: '#f0f0f0',
+      border: '#767676',
+      borderMuted: '#767676',
+      textMuted: '#333333',
+      textSubtle: '#767676',
+    },
+    accent: '#143d8f',
+    accentForeground: '#ffffff',
+    status: {
+      success: '#14532d',
+      warning: SLATE_ANSI.yellow,
+      error: '#b91c1c',
+      info: SLATE_ANSI.blue,
+    },
+    ansi: SLATE_ANSI,
+    cursor: '#24292f',
+    selection: '#b6c7ff',
+    shadcn: {
+      card: '#ffffff',
+      popover: '#ffffff',
+      secondary: '#f0f0f0',
+      muted: '#f0f0f0',
+      border: '#767676',
+      input: '#767676',
+      ring: '#000000',
+    },
+  },
+  {
+    id: 'contrast-dark',
+    family: 'contrast',
+    familyLabel: 'High Contrast',
+    label: 'Dark',
+    name: 'High Contrast Dark',
+    description: 'Adea’s high-contrast palette for dark appearance.',
+    provenance: FAMILY_PROVENANCE.contrast,
+    appearance: 'dark',
+    tags: ['dark', 'high-contrast'],
+    ramp: {
+      background: '#000000',
+      foreground: '#ffffff',
+      surface: '#0a0a0a',
+      surfaceElevated: '#0a0a0a',
+      surfaceHover: '#1a1a1a',
+      surfaceActive: '#1a1a1a',
+      border: '#8f8f8f',
+      borderMuted: '#8f8f8f',
+      textMuted: '#e5e5e5',
+      textSubtle: '#8f8f8f',
+    },
+    accent: '#8ab4ff',
+    accentForeground: '#000000',
+    status: {
+      success: '#4ade80',
+      warning: CONTRAST_ANSI.yellow,
+      error: '#ff6b6b',
+      info: CONTRAST_ANSI.blue,
+    },
+    ansi: CONTRAST_ANSI,
+    cursor: '#e6edf3',
+    selection: '#264f78',
+    shadcn: {
+      card: '#0a0a0a',
+      popover: '#0a0a0a',
+      secondary: '#1a1a1a',
+      muted: '#1a1a1a',
+      border: '#8f8f8f',
+      input: '#8f8f8f',
+      ring: '#ffffff',
+    },
+  },
+])