@silvery/theme 0.3.0

package/src/import/base16.ts

@@ -0,0 +1,150 @@
+/**
+ * Import Base16 YAML/JSON schemes into ColorPalette format.
+ *
+ * Base16 defines 16 colors (base00–base0F). We map them to ColorPalette's
+ * 22 colors, deriving bright variants and special colors.
+ *
+ * @see https://github.com/chriskempson/base16
+ */
+
+import { darken, brighten, hexToRgb } from "../color"
+import type { ColorPalette } from "../types"
+import type { Base16Scheme } from "./types"
+import { BASE16_KEYS } from "./types"
+
+// ============================================================================
+// YAML Parser (minimal — Base16 YAML is just `key: "value"` lines)
+// ============================================================================
+
+/**
+ * Parse Base16 YAML into a Base16Scheme object.
+ * Handles both quoted and unquoted values, comments, and blank lines.
+ */
+function parseBase16Yaml(yaml: string): Base16Scheme {
+  const result: Record<string, string> = {}
+
+  for (const raw of yaml.split("\n")) {
+    const line = raw.trim()
+    if (!line || line.startsWith("#")) continue
+
+    const colonIdx = line.indexOf(":")
+    if (colonIdx === -1) continue
+
+    const key = line.slice(0, colonIdx).trim()
+    let value = line.slice(colonIdx + 1).trim()
+
+    // Strip surrounding quotes (single or double)
+    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+      value = value.slice(1, -1)
+    }
+
+    // Strip inline comments (only after unquoted values)
+    const commentIdx = value.indexOf("#")
+    if (commentIdx > 0) {
+      value = value.slice(0, commentIdx).trim()
+    }
+
+    result[key] = value
+  }
+
+  // Validate required fields
+  if (!result.scheme) {
+    throw new Error("Base16 YAML missing required field: scheme")
+  }
+
+  for (const key of BASE16_KEYS) {
+    if (!result[key]) {
+      throw new Error(`Base16 YAML missing required color: ${key}`)
+    }
+    // Validate hex format (6 hex chars, no # prefix)
+    if (!/^[0-9a-fA-F]{6}$/.test(result[key]!)) {
+      throw new Error(`Base16 color ${key} must be a 6-digit hex string without '#', got: "${result[key]}"`)
+    }
+  }
+
+  return result as unknown as Base16Scheme
+}
+
+// ============================================================================
+// Luminance Detection
+// ============================================================================
+
+/** Compute relative luminance (WCAG 2.0) from a hex color with `#` prefix. */
+function luminance(hex: string): number {
+  const rgb = hexToRgb(hex)
+  if (!rgb) return 0
+  const [r, g, b] = rgb.map((c) => {
+    const s = c / 255
+    return s <= 0.03928 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4)
+  })
+  return 0.2126 * r! + 0.7152 * g! + 0.0722 * b!
+}
+
+// ============================================================================
+// Import
+// ============================================================================
+
+/** Normalize a bare hex string to `#RRGGBB` (uppercase). */
+function hex(bare: string): string {
+  return `#${bare.toUpperCase()}`
+}
+
+/**
+ * Import a Base16 YAML (or JSON) scheme into a ColorPalette.
+ *
+ * Mapping:
+ *   base00 → background, base01 → brightBlack, base02 → selectionBackground,
+ *   base03 → white (muted fg), base05 → foreground/brightWhite,
+ *   base08 → red, base09 → brightRed, base0A → yellow,
+ *   base0B → green, base0C → cyan, base0D → blue, base0E → magenta,
+ *   base0F → brightMagenta.
+ *
+ * Bright color variants are derived by brightening normals.
+ * `dark` is inferred from base00 luminance.
+ */
+export function importBase16(yamlOrJson: string): ColorPalette {
+  const scheme = parseBase16Yaml(yamlOrJson)
+  return base16ToColorPalette(scheme)
+}
+
+/** Convert a parsed Base16Scheme to ColorPalette. */
+export function base16ToColorPalette(scheme: Base16Scheme): ColorPalette {
+  const bg = hex(scheme.base00)
+  const fg = hex(scheme.base05)
+  const isDark = luminance(bg) < 0.179
+
+  const black = isDark ? darken(bg, 0.15) : brighten(bg, 0.15)
+  const red = hex(scheme.base08)
+  const green = hex(scheme.base0B)
+  const yellow = hex(scheme.base0A)
+  const blue = hex(scheme.base0D)
+  const magenta = hex(scheme.base0E)
+  const cyan = hex(scheme.base0C)
+
+  return {
+    name: scheme.scheme,
+    dark: isDark,
+    black,
+    red,
+    green,
+    yellow,
+    blue,
+    magenta,
+    cyan,
+    white: hex(scheme.base03),
+    brightBlack: hex(scheme.base01),
+    brightRed: hex(scheme.base09),
+    brightGreen: brighten(green, 0.15),
+    brightYellow: brighten(yellow, 0.15),
+    brightBlue: brighten(blue, 0.15),
+    brightMagenta: hex(scheme.base0F),
+    brightCyan: brighten(cyan, 0.15),
+    brightWhite: fg,
+    foreground: fg,
+    background: bg,
+    cursorColor: fg,
+    cursorText: bg,
+    selectionBackground: hex(scheme.base02),
+    selectionForeground: fg,
+  }
+}

package/src/import/types.ts

@@ -0,0 +1,47 @@
+/**
+ * Base16 scheme type — the 16-color format used by hundreds of community themes.
+ *
+ * @see https://github.com/chriskempson/base16
+ */
+
+/** A parsed Base16 color scheme. All hex values are WITHOUT `#` prefix. */
+export interface Base16Scheme {
+  scheme: string
+  author: string
+  base00: string
+  base01: string
+  base02: string
+  base03: string
+  base04: string
+  base05: string
+  base06: string
+  base07: string
+  base08: string
+  base09: string
+  base0A: string
+  base0B: string
+  base0C: string
+  base0D: string
+  base0E: string
+  base0F: string
+}
+
+/** All Base16 color keys in order. */
+export const BASE16_KEYS = [
+  "base00",
+  "base01",
+  "base02",
+  "base03",
+  "base04",
+  "base05",
+  "base06",
+  "base07",
+  "base08",
+  "base09",
+  "base0A",
+  "base0B",
+  "base0C",
+  "base0D",
+  "base0E",
+  "base0F",
+] as const

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./ThemeContext"
+export * from "./theme"

package/src/palettes/ayu.ts

@@ -0,0 +1,92 @@
+/**
+ * Ayu palettes — warm, modern theme in three variants.
+ * Source: https://github.com/ayu-theme/ayu-colors
+ * Reference: https://github.com/Shatur/neovim-ayu
+ */
+
+import type { ColorPalette } from "../types"
+import { brighten } from "../color"
+
+/** Ayu Dark — deep dark variant with warm accents. */
+export const ayuDark: ColorPalette = {
+  name: "ayu-dark",
+  dark: true,
+  black: "#05070A",
+  red: "#D95757",
+  green: "#AAD94C",
+  yellow: "#E6B450",
+  blue: "#59C2FF",
+  magenta: "#D2A6FF",
+  cyan: "#95E6CB",
+  white: "#636A72",
+  brightBlack: "#11151C",
+  brightRed: "#F29668",
+  brightGreen: brighten("#AAD94C", 0.15),
+  brightYellow: brighten("#E6B450", 0.15),
+  brightBlue: brighten("#59C2FF", 0.15),
+  brightMagenta: "#F07178",
+  brightCyan: brighten("#95E6CB", 0.15),
+  brightWhite: "#BFBDB6",
+  foreground: "#BFBDB6",
+  background: "#0B0E14",
+  cursorColor: "#BFBDB6",
+  cursorText: "#0B0E14",
+  selectionBackground: "#565B66",
+  selectionForeground: "#BFBDB6",
+}
+
+/** Ayu Mirage — balanced dark variant with softer contrast. */
+export const ayuMirage: ColorPalette = {
+  name: "ayu-mirage",
+  dark: true,
+  black: "#101521",
+  red: "#FF6666",
+  green: "#D5FF80",
+  yellow: "#FFCC66",
+  blue: "#73D0FF",
+  magenta: "#DFBFFF",
+  cyan: "#95E6CB",
+  white: "#6C7A8B",
+  brightBlack: "#171B24",
+  brightRed: "#F29E74",
+  brightGreen: brighten("#D5FF80", 0.15),
+  brightYellow: brighten("#FFCC66", 0.15),
+  brightBlue: brighten("#73D0FF", 0.15),
+  brightMagenta: "#F28779",
+  brightCyan: brighten("#95E6CB", 0.15),
+  brightWhite: "#CCCAC2",
+  foreground: "#CCCAC2",
+  background: "#1F2430",
+  cursorColor: "#CCCAC2",
+  cursorText: "#1F2430",
+  selectionBackground: "#707A8C",
+  selectionForeground: "#CCCAC2",
+}
+
+/** Ayu Light — clean light variant. */
+export const ayuLight: ColorPalette = {
+  name: "ayu-light",
+  dark: false,
+  black: "#E7EAED",
+  red: "#E65050",
+  green: "#86B300",
+  yellow: "#FFAA33",
+  blue: "#399EE6",
+  magenta: "#A37ACC",
+  cyan: "#4CBF99",
+  white: "#ABADB1",
+  brightBlack: "#F3F4F5",
+  brightRed: "#ED9366",
+  brightGreen: brighten("#86B300", 0.15),
+  brightYellow: brighten("#FFAA33", 0.15),
+  brightBlue: brighten("#399EE6", 0.15),
+  brightMagenta: "#F07171",
+  brightCyan: brighten("#4CBF99", 0.15),
+  brightWhite: "#5C6166",
+  foreground: "#5C6166",
+  background: "#F8F9FA",
+  cursorColor: "#5C6166",
+  cursorText: "#F8F9FA",
+  selectionBackground: "#8A9199",
+  selectionForeground: "#5C6166",
+}

package/src/palettes/catppuccin.ts

@@ -0,0 +1,118 @@
+/**
+ * Catppuccin palettes — the most popular 4-flavor theme system.
+ */
+
+import type { ColorPalette } from "../types"
+import { brighten } from "../color"
+
+/** Catppuccin Mocha — the classic dark variant. */
+export const catppuccinMocha: ColorPalette = {
+  name: "catppuccin-mocha",
+  dark: true,
+  black: "#11111B",
+  red: "#F38BA8",
+  green: "#A6E3A1",
+  yellow: "#F9E2AF",
+  blue: "#89B4FA",
+  magenta: "#CBA6F7",
+  cyan: "#94E2D5",
+  white: "#A6ADC8",
+  brightBlack: "#313244",
+  brightRed: "#FAB387",
+  brightGreen: brighten("#A6E3A1", 0.15),
+  brightYellow: brighten("#F9E2AF", 0.15),
+  brightBlue: brighten("#89B4FA", 0.15),
+  brightMagenta: "#F5C2E7",
+  brightCyan: brighten("#94E2D5", 0.15),
+  brightWhite: "#CDD6F4",
+  foreground: "#CDD6F4",
+  background: "#1E1E2E",
+  cursorColor: "#CDD6F4",
+  cursorText: "#1E1E2E",
+  selectionBackground: "#6C7086",
+  selectionForeground: "#CDD6F4",
+}
+
+/** Catppuccin Frappe — muted dark variant. */
+export const catppuccinFrappe: ColorPalette = {
+  name: "catppuccin-frappe",
+  dark: true,
+  black: "#232634",
+  red: "#E78284",
+  green: "#A6D189",
+  yellow: "#E5C890",
+  blue: "#8CAAEE",
+  magenta: "#CA9EE6",
+  cyan: "#81C8BE",
+  white: "#A5ADCE",
+  brightBlack: "#414559",
+  brightRed: "#EF9F76",
+  brightGreen: brighten("#A6D189", 0.15),
+  brightYellow: brighten("#E5C890", 0.15),
+  brightBlue: brighten("#8CAAEE", 0.15),
+  brightMagenta: "#F4B8E4",
+  brightCyan: brighten("#81C8BE", 0.15),
+  brightWhite: "#C6D0F5",
+  foreground: "#C6D0F5",
+  background: "#303446",
+  cursorColor: "#C6D0F5",
+  cursorText: "#303446",
+  selectionBackground: "#737994",
+  selectionForeground: "#C6D0F5",
+}
+
+/** Catppuccin Macchiato — warm dark variant. */
+export const catppuccinMacchiato: ColorPalette = {
+  name: "catppuccin-macchiato",
+  dark: true,
+  black: "#181926",
+  red: "#ED8796",
+  green: "#A6DA95",
+  yellow: "#EED49F",
+  blue: "#8AADF4",
+  magenta: "#C6A0F6",
+  cyan: "#8BD5CA",
+  white: "#A5ADCB",
+  brightBlack: "#363A4F",
+  brightRed: "#F5A97F",
+  brightGreen: brighten("#A6DA95", 0.15),
+  brightYellow: brighten("#EED49F", 0.15),
+  brightBlue: brighten("#8AADF4", 0.15),
+  brightMagenta: "#F5BDE6",
+  brightCyan: brighten("#8BD5CA", 0.15),
+  brightWhite: "#CAD3F5",
+  foreground: "#CAD3F5",
+  background: "#24273A",
+  cursorColor: "#CAD3F5",
+  cursorText: "#24273A",
+  selectionBackground: "#6E738D",
+  selectionForeground: "#CAD3F5",
+}
+
+/** Catppuccin Latte — the light variant. */
+export const catppuccinLatte: ColorPalette = {
+  name: "catppuccin-latte",
+  dark: false,
+  black: "#DCE0E8",
+  red: "#D20F39",
+  green: "#40A02B",
+  yellow: "#DF8E1D",
+  blue: "#1E66F5",
+  magenta: "#8839EF",
+  cyan: "#179299",
+  white: "#6C6F85",
+  brightBlack: "#CCD0DA",
+  brightRed: "#FE640B",
+  brightGreen: brighten("#40A02B", 0.15),
+  brightYellow: brighten("#DF8E1D", 0.15),
+  brightBlue: brighten("#1E66F5", 0.15),
+  brightMagenta: "#EA76CB",
+  brightCyan: brighten("#179299", 0.15),
+  brightWhite: "#4C4F69",
+  foreground: "#4C4F69",
+  background: "#EFF1F5",
+  cursorColor: "#4C4F69",
+  cursorText: "#EFF1F5",
+  selectionBackground: "#9CA0B0",
+  selectionForeground: "#4C4F69",
+}

package/src/palettes/dracula.ts

@@ -0,0 +1,34 @@
+/**
+ * Dracula palette — dark theme with vibrant accents.
+ */
+
+import type { ColorPalette } from "../types"
+import { brighten } from "../color"
+
+/** Dracula — vibrant dark theme. */
+export const dracula: ColorPalette = {
+  name: "dracula",
+  dark: true,
+  black: "#21222C",
+  red: "#FF5555",
+  green: "#50FA7B",
+  yellow: "#F1FA8C",
+  blue: "#BD93F9",
+  magenta: "#BD93F9",
+  cyan: "#8BE9FD",
+  white: "#6272A4",
+  brightBlack: "#44475A",
+  brightRed: "#FFB86C",
+  brightGreen: brighten("#50FA7B", 0.15),
+  brightYellow: brighten("#F1FA8C", 0.15),
+  brightBlue: brighten("#BD93F9", 0.15),
+  brightMagenta: "#FF79C6",
+  brightCyan: brighten("#8BE9FD", 0.15),
+  brightWhite: "#F8F8F2",
+  foreground: "#F8F8F2",
+  background: "#282A36",
+  cursorColor: "#F8F8F2",
+  cursorText: "#282A36",
+  selectionBackground: "#6272A4",
+  selectionForeground: "#F8F8F2",
+}

package/src/palettes/edge.ts

@@ -0,0 +1,63 @@
+/**
+ * Edge palettes — clean, modern theme by sainnhe.
+ * Source: https://github.com/sainnhe/edge (default style)
+ */
+
+import type { ColorPalette } from "../types"
+import { brighten } from "../color"
+
+/** Edge Dark — clean dark variant with balanced accents. */
+export const edgeDark: ColorPalette = {
+  name: "edge-dark",
+  dark: true,
+  black: "#202023",
+  red: "#EC7279",
+  green: "#A0C980",
+  yellow: "#DEB974",
+  blue: "#6CB6EB",
+  magenta: "#D38AEA",
+  cyan: "#5DBBC1",
+  white: "#758094",
+  brightBlack: "#33353F",
+  brightRed: "#DEB974",
+  brightGreen: brighten("#A0C980", 0.15),
+  brightYellow: brighten("#DEB974", 0.15),
+  brightBlue: brighten("#6CB6EB", 0.15),
+  brightMagenta: "#EC7279",
+  brightCyan: brighten("#5DBBC1", 0.15),
+  brightWhite: "#C5CDD9",
+  foreground: "#C5CDD9",
+  background: "#2C2E34",
+  cursorColor: "#C5CDD9",
+  cursorText: "#2C2E34",
+  selectionBackground: "#414550",
+  selectionForeground: "#C5CDD9",
+}
+
+/** Edge Light — clean, readable light variant. */
+export const edgeLight: ColorPalette = {
+  name: "edge-light",
+  dark: false,
+  black: "#DDE2E7",
+  red: "#D05858",
+  green: "#608E32",
+  yellow: "#BE7E05",
+  blue: "#5079BE",
+  magenta: "#B05CCC",
+  cyan: "#3A8B84",
+  white: "#8790A0",
+  brightBlack: "#EEF1F4",
+  brightRed: "#BE7E05",
+  brightGreen: brighten("#608E32", 0.15),
+  brightYellow: brighten("#BE7E05", 0.15),
+  brightBlue: brighten("#5079BE", 0.15),
+  brightMagenta: "#D05858",
+  brightCyan: brighten("#3A8B84", 0.15),
+  brightWhite: "#4B505B",
+  foreground: "#4B505B",
+  background: "#FAFAFA",
+  cursorColor: "#4B505B",
+  cursorText: "#FAFAFA",
+  selectionBackground: "#DDE2E7",
+  selectionForeground: "#4B505B",
+}

package/src/palettes/everforest.ts

@@ -0,0 +1,63 @@
+/**
+ * Everforest palettes — a green-toned comfortable color scheme.
+ * Source: https://github.com/sainnhe/everforest (medium background variants)
+ */
+
+import type { ColorPalette } from "../types"
+import { brighten } from "../color"
+
+/** Everforest Dark — warm green-based dark theme (medium background). */
+export const everforestDark: ColorPalette = {
+  name: "everforest-dark",
+  dark: true,
+  black: "#232a2e", // bg_dim
+  red: "#e67e80",
+  green: "#a7c080",
+  yellow: "#dbbc7f",
+  blue: "#7fbbb3",
+  magenta: "#d699b6",
+  cyan: "#83c092", // aqua
+  white: "#859289", // grey1
+  brightBlack: "#343f44", // bg1
+  brightRed: "#e69875",
+  brightGreen: brighten("#a7c080", 0.15),
+  brightYellow: brighten("#dbbc7f", 0.15),
+  brightBlue: brighten("#7fbbb3", 0.15),
+  brightMagenta: "#e67e80", // everforest has no distinct pink; reuse red
+  brightCyan: brighten("#83c092", 0.15),
+  brightWhite: "#d3c6aa", // fg
+  foreground: "#d3c6aa", // fg
+  background: "#2d353b", // bg0
+  cursorColor: "#d3c6aa", // fg
+  cursorText: "#2d353b", // bg0
+  selectionBackground: "#4f585e", // bg4
+  selectionForeground: "#d3c6aa", // fg
+}
+
+/** Everforest Light — warm green-based light theme (medium background). */
+export const everforestLight: ColorPalette = {
+  name: "everforest-light",
+  dark: false,
+  black: "#efebd4", // bg_dim
+  red: "#f85552",
+  green: "#8da101",
+  yellow: "#dfa000",
+  blue: "#3a94c5",
+  magenta: "#df69ba",
+  cyan: "#35a77c", // aqua
+  white: "#939f91", // grey1
+  brightBlack: "#f4f0d9", // bg1
+  brightRed: "#f57d26",
+  brightGreen: brighten("#8da101", 0.15),
+  brightYellow: brighten("#dfa000", 0.15),
+  brightBlue: brighten("#3a94c5", 0.15),
+  brightMagenta: "#f85552", // everforest has no distinct pink; reuse red
+  brightCyan: brighten("#35a77c", 0.15),
+  brightWhite: "#5c6a72", // fg
+  foreground: "#5c6a72", // fg
+  background: "#fdf6e3", // bg0
+  cursorColor: "#5c6a72", // fg
+  cursorText: "#fdf6e3", // bg0
+  selectionBackground: "#e0dcc7", // bg4
+  selectionForeground: "#5c6a72", // fg
+}

package/src/palettes/gruvbox.ts

@@ -0,0 +1,62 @@
+/**
+ * Gruvbox palettes — retro groove color scheme.
+ */
+
+import type { ColorPalette } from "../types"
+import { brighten } from "../color"
+
+/** Gruvbox Dark — warm retro dark theme. */
+export const gruvboxDark: ColorPalette = {
+  name: "gruvbox-dark",
+  dark: true,
+  black: "#1D2021",
+  red: "#FB4934",
+  green: "#B8BB26",
+  yellow: "#FABD2F",
+  blue: "#83A598",
+  magenta: "#D3869B",
+  cyan: "#8EC07C",
+  white: "#BDAE93",
+  brightBlack: "#3C3836",
+  brightRed: "#FE8019",
+  brightGreen: brighten("#B8BB26", 0.15),
+  brightYellow: brighten("#FABD2F", 0.15),
+  brightBlue: brighten("#83A598", 0.15),
+  brightMagenta: "#D3869B",
+  brightCyan: brighten("#8EC07C", 0.15),
+  brightWhite: "#EBDBB2",
+  foreground: "#EBDBB2",
+  background: "#282828",
+  cursorColor: "#EBDBB2",
+  cursorText: "#282828",
+  selectionBackground: "#665C54",
+  selectionForeground: "#EBDBB2",
+}
+
+/** Gruvbox Light — warm retro light theme. */
+export const gruvboxLight: ColorPalette = {
+  name: "gruvbox-light",
+  dark: false,
+  black: "#F9F5D7",
+  red: "#CC241D",
+  green: "#98971A",
+  yellow: "#D79921",
+  blue: "#458588",
+  magenta: "#B16286",
+  cyan: "#689D6A",
+  white: "#665C54",
+  brightBlack: "#EBDBB2",
+  brightRed: "#D65D0E",
+  brightGreen: brighten("#98971A", 0.15),
+  brightYellow: brighten("#D79921", 0.15),
+  brightBlue: brighten("#458588", 0.15),
+  brightMagenta: "#B16286",
+  brightCyan: brighten("#689D6A", 0.15),
+  brightWhite: "#3C3836",
+  foreground: "#3C3836",
+  background: "#FBF1C7",
+  cursorColor: "#3C3836",
+  cursorText: "#FBF1C7",
+  selectionBackground: "#A89984",
+  selectionForeground: "#3C3836",
+}

package/src/palettes/horizon.ts

@@ -0,0 +1,35 @@
+/**
+ * Horizon palette — beautifully warm theme.
+ * Source: https://github.com/jolaleye/horizon-theme-vscode
+ */
+
+import type { ColorPalette } from "../types"
+import { brighten } from "../color"
+
+/** Horizon — warm dark variant with vivid accents. */
+export const horizon: ColorPalette = {
+  name: "horizon",
+  dark: true,
+  black: "#16161C",
+  red: "#E95678",
+  green: "#29D398",
+  yellow: "#FAC29A",
+  blue: "#26BBD9",
+  magenta: "#B877DB",
+  cyan: "#59E1E3",
+  white: "#6C6F93",
+  brightBlack: "#232530",
+  brightRed: "#FAB795",
+  brightGreen: brighten("#29D398", 0.15),
+  brightYellow: brighten("#FAC29A", 0.15),
+  brightBlue: brighten("#26BBD9", 0.15),
+  brightMagenta: "#EE64AC",
+  brightCyan: brighten("#59E1E3", 0.15),
+  brightWhite: "#D5D8DA",
+  foreground: "#D5D8DA",
+  background: "#1C1E26",
+  cursorColor: "#D5D8DA",
+  cursorText: "#1C1E26",
+  selectionBackground: "#2E303E",
+  selectionForeground: "#D5D8DA",
+}