@bytechain.cn/colamd-themes 0.5.0 → 0.5.2

package/src/color-systems.ts

@@ -1,289 +0,0 @@
-/**
- * Local color system library — predefined seed palettes for popular color schemes.
- * Each scheme provides a complete SeedPalette (5 seed colors + variants).
- */
-
-import type { SeedPalette } from "./validators.js";
-import { hslHue, hslSaturation, hslLightness } from "./contrast.js";
-
-export interface ColorSystem {
-  id: string;
-  name: string;
-  nameCN: string;
-  description: string;
-  mode: "light" | "dark";
-  palette: SeedPalette;
-}
-
-// ═══════════════════════════════════════════════════════════
-// 莫兰迪 (Morandi) — 低饱和度灰调
-// ═══════════════════════════════════════════════════════════
-
-const morandiPink: ColorSystem = {
-  id: "morandi-pink",
-  name: "Morandi Pink",
-  nameCN: "莫兰迪 灰粉",
-  description: "低饱和度灰粉基调，柔和慵懒",
-  mode: "light",
-  palette: {
-    accent: "#b08a82", accentLight: "#e8ddd8", accentDark: "#8b6b63",
-    surface: "#f5f2f0", panel: "#ece6e2", panelAlt: "#e2dad5",
-    ink: "#3a3533", inkMuted: "#8a807c", inkDim: "#b0a8a4",
-    border: "#d8d2ce", borderStrong: "#c0b8b4",
-  },
-};
-
-const morandiGreen: ColorSystem = {
-  id: "morandi-green",
-  name: "Morandi Green",
-  nameCN: "莫兰迪 灰绿",
-  description: "低饱和度灰绿调，沉静淡雅",
-  mode: "light",
-  palette: {
-    accent: "#8a9b7a", accentLight: "#e2e8dc", accentDark: "#6b7a5e",
-    surface: "#f4f5f2", panel: "#e8ebe4", panelAlt: "#dce0d5",
-    ink: "#3a3d35", inkMuted: "#8a8d82", inkDim: "#b0b4a8",
-    border: "#d4d8ce", borderStrong: "#bcc0b4",
-  },
-};
-
-const morandiBlue: ColorSystem = {
-  id: "morandi-blue",
-  name: "Morandi Blue",
-  nameCN: "莫兰迪 灰蓝",
-  description: "低饱和度灰蓝调，冷静克制",
-  mode: "light",
-  palette: {
-    accent: "#7a8fa0", accentLight: "#dce4e8", accentDark: "#5e7080",
-    surface: "#f2f4f6", panel: "#e6eaee", panelAlt: "#dae0e6",
-    ink: "#353a3f", inkMuted: "#828a92", inkDim: "#a8b0b8",
-    border: "#ced4dc", borderStrong: "#b4bcc4",
-  },
-};
-
-// ═══════════════════════════════════════════════════════════
-// 马卡龙 (Macaron) — 粉彩糖果色
-// ═══════════════════════════════════════════════════════════
-
-const macaronStrawberry: ColorSystem = {
-  id: "macaron-strawberry",
-  name: "Macaron Strawberry",
-  nameCN: "马卡龙 草莓",
-  description: "柔粉奶油色，甜美活泼",
-  mode: "light",
-  palette: {
-    accent: "#e893a6", accentLight: "#fde8ec", accentDark: "#c47082",
-    surface: "#fefafb", panel: "#faf0f2", panelAlt: "#f4e4e8",
-    ink: "#4a3035", inkMuted: "#9a8086", inkDim: "#c0a8ae",
-    border: "#eed4d8", borderStrong: "#dab8be",
-  },
-};
-
-const macaronMint: ColorSystem = {
-  id: "macaron-mint",
-  name: "Macaron Mint",
-  nameCN: "马卡龙 薄荷",
-  description: "清新薄荷绿，轻盈爽朗",
-  mode: "light",
-  palette: {
-    accent: "#8cc9a8", accentLight: "#e6f6ee", accentDark: "#6aaa88",
-    surface: "#f8fcfa", panel: "#eef6f2", panelAlt: "#e2f0e8",
-    ink: "#304538", inkMuted: "#809588", inkDim: "#a8c0b0",
-    border: "#cce8d6", borderStrong: "#b0d4bc",
-  },
-};
-
-const macaronBlueberry: ColorSystem = {
-  id: "macaron-blueberry",
-  name: "Macaron Blueberry",
-  nameCN: "马卡龙 蓝莓",
-  description: "淡紫蓝调，温柔梦幻",
-  mode: "light",
-  palette: {
-    accent: "#9aa8e0", accentLight: "#eaecf8", accentDark: "#7888c0",
-    surface: "#f8f8fc", panel: "#f0f2f8", panelAlt: "#e6e8f4",
-    ink: "#303548", inkMuted: "#808898", inkDim: "#a8b0c0",
-    border: "#d0d4e8", borderStrong: "#b8bcd4",
-  },
-};
-
-// ═══════════════════════════════════════════════════════════
-// 北欧 (Nordic) — 极简自然色
-// ═══════════════════════════════════════════════════════════
-
-const nordicWood: ColorSystem = {
-  id: "nordic-wood",
-  name: "Nordic Wood",
-  nameCN: "北欧 原木",
-  description: "浅木色与暖白搭配，自然温馨",
-  mode: "light",
-  palette: {
-    accent: "#8b7355", accentLight: "#e8e0d4", accentDark: "#6b5a40",
-    surface: "#faf8f4", panel: "#f2eeea", panelAlt: "#e8e2dc",
-    ink: "#3a3530", inkMuted: "#8a8078", inkDim: "#b0a89e",
-    border: "#d8d0c4", borderStrong: "#c0b8aa",
-  },
-};
-
-const nordicMinimal: ColorSystem = {
-  id: "nordic-minimal",
-  name: "Nordic Minimal",
-  nameCN: "北欧 极简白",
-  description: "纯白基调，冷蓝点缀，极致简洁",
-  mode: "light",
-  palette: {
-    accent: "#4a7c96", accentLight: "#dce6ec", accentDark: "#3a6078",
-    surface: "#fefefe", panel: "#f6f8fa", panelAlt: "#eef2f6",
-    ink: "#2a2a2a", inkMuted: "#7a7a7a", inkDim: "#aaaaaa",
-    border: "#e0e0e0", borderStrong: "#c8c8c8",
-  },
-};
-
-const nordicGray: ColorSystem = {
-  id: "nordic-gray",
-  name: "Nordic Gray",
-  nameCN: "北欧 灰调",
-  description: "中灰基调，森林绿点缀，沉稳自然",
-  mode: "light",
-  palette: {
-    accent: "#6b8a7a", accentLight: "#dce6e0", accentDark: "#4e6b5c",
-    surface: "#f6f5f4", panel: "#edebe8", panelAlt: "#e2e0dc",
-    ink: "#3a3a3a", inkMuted: "#8a8a8a", inkDim: "#b0b0b0",
-    border: "#d8d6d2", borderStrong: "#c0beb8",
-  },
-};
-
-// ═══════════════════════════════════════════════════════════
-// 复古 (Vintage) — 暖棕岁月感
-// ═══════════════════════════════════════════════════════════
-
-const vintageWarmBrown: ColorSystem = {
-  id: "vintage-brown",
-  name: "Vintage Warm Brown",
-  nameCN: "复古 暖棕",
-  description: "暖棕纸色，旧时光氛围",
-  mode: "light",
-  palette: {
-    accent: "#8b5e3c", accentLight: "#e8dcd0", accentDark: "#6b4428",
-    surface: "#f8f2ea", panel: "#f0e8dc", panelAlt: "#e6dcc8",
-    ink: "#3a3028", inkMuted: "#8a7a6a", inkDim: "#b0a090",
-    border: "#d4c8b8", borderStrong: "#bca898",
-  },
-};
-
-const vintageNewspaper: ColorSystem = {
-  id: "vintage-newspaper",
-  name: "Vintage Newspaper",
-  nameCN: "复古 旧报纸",
-  description: "泛黄纸色，怀旧阅读感",
-  mode: "light",
-  palette: {
-    accent: "#7a5a3a", accentLight: "#e8dcc8", accentDark: "#5a4028",
-    surface: "#f4f0e0", panel: "#ece4d0", panelAlt: "#e2d8c0",
-    ink: "#3a3528", inkMuted: "#8a8070", inkDim: "#b0a898",
-    border: "#c8c0a8", borderStrong: "#b0a890",
-  },
-};
-
-const vintageWine: ColorSystem = {
-  id: "vintage-wine",
-  name: "Vintage Wine",
-  nameCN: "复古 酒红",
-  description: "暗酒红点缀，浓郁优雅",
-  mode: "light",
-  palette: {
-    accent: "#8b3a3a", accentLight: "#e8d4d4", accentDark: "#6b2828",
-    surface: "#f8f2f2", panel: "#f0e8e8", panelAlt: "#e6dcdc",
-    ink: "#3a2a2a", inkMuted: "#8a7070", inkDim: "#b09898",
-    border: "#d4c0c0", borderStrong: "#bca8a8",
-  },
-};
-
-// ═══════════════════════════════════════════════════════════
-// 薄荷绿 (Mint) — 清新自然
-// ═══════════════════════════════════════════════════════════
-
-const mintFresh: ColorSystem = {
-  id: "mint-fresh",
-  name: "Mint Fresh",
-  nameCN: "薄荷绿 清新",
-  description: "鲜嫩薄荷叶色，清爽宜人",
-  mode: "light",
-  palette: {
-    accent: "#5aaa80", accentLight: "#dceee4", accentDark: "#408860",
-    surface: "#f8fcfa", panel: "#eef6f2", panelAlt: "#e2f0e8",
-    ink: "#2a3a30", inkMuted: "#708a78", inkDim: "#98b0a0",
-    border: "#c8e4d4", borderStrong: "#a8ccb8",
-  },
-};
-
-const mintDeep: ColorSystem = {
-  id: "mint-deep",
-  name: "Mint Deep",
-  nameCN: "薄荷绿 深薄荷",
-  description: "深邃薄荷绿，沉稳清新",
-  mode: "light",
-  palette: {
-    accent: "#3a8a60", accentLight: "#d4e8dc", accentDark: "#286a48",
-    surface: "#f4f8f6", panel: "#e8f0ec", panelAlt: "#dce8e2",
-    ink: "#283830", inkMuted: "#708878", inkDim: "#98b0a0",
-    border: "#b8dcc8", borderStrong: "#98c4ac",
-  },
-};
-
-const mintDew: ColorSystem = {
-  id: "mint-dew",
-  name: "Mint Dew",
-  nameCN: "薄荷绿 晨露",
-  description: "晨露般清透浅绿，轻柔温和",
-  mode: "light",
-  palette: {
-    accent: "#7ab898", accentLight: "#e0f0e8", accentDark: "#5a9878",
-    surface: "#fafdfc", panel: "#f2f8f4", panelAlt: "#e8f2ec",
-    ink: "#2c3832", inkMuted: "#788880", inkDim: "#a0b0a8",
-    border: "#d0e8dc", borderStrong: "#b8d4c4",
-  },
-};
-
-// ── Registry ──
-
-export const COLOR_SYSTEMS: ColorSystem[] = [
-  morandiPink, morandiGreen, morandiBlue,
-  macaronStrawberry, macaronMint, macaronBlueberry,
-  nordicWood, nordicMinimal, nordicGray,
-  vintageWarmBrown, vintageNewspaper, vintageWine,
-  mintFresh, mintDeep, mintDew,
-];
-
-export function getColorSystem(id: string): ColorSystem | undefined {
-  return COLOR_SYSTEMS.find((cs) => cs.id === id);
-}
-
-/** Match extracted accent/surface to the nearest color system by hue + saturation distance. */
-export function matchColorSystem(accent: string, surface: string): ColorSystem {
-  const hAccent = hslHue(accent);
-  const sAccent = hslSaturation(accent);
-  const lSurface = hslLightness(surface);
-
-  let best = COLOR_SYSTEMS[0];
-  let bestDist = Infinity;
-
-  for (const cs of COLOR_SYSTEMS) {
-    const hCs = hslHue(cs.palette.accent);
-    const sCs = hslSaturation(cs.palette.accent);
-    const lCs = hslLightness(cs.palette.surface);
-
-    // Weighted distance: hue 40%, saturation 30%, lightness 30%
-    const dH = Math.abs(hAccent - hCs);
-    const hueDist = Math.min(dH, 360 - dH) / 360; // wrap around
-    const satDist = Math.abs(sAccent - sCs);
-    const lumDist = Math.abs(lSurface - lCs);
-    const dist = hueDist * 0.4 + satDist * 0.3 + lumDist * 0.3;
-
-    if (dist < bestDist) {
-      bestDist = dist;
-      best = cs;
-    }
-  }
-  return best;
-}

package/src/color-utils.ts

@@ -1,137 +0,0 @@
-/** Color manipulation utilities. */
-
-export function hexToRgb(hex: string): [number, number, number] {
-  const trimmed = hex.replace(/^#/, "").trim();
-  if (!/^[0-9a-fA-F]{6}$/.test(trimmed) && !/^[0-9a-fA-F]{3}$/.test(trimmed)) {
-    throw new Error(`Invalid hex color: "${hex}"`);
-  }
-  hex = trimmed;
-  if (hex.length === 3) hex = hex.split("").map((c) => c + c).join("");
-  const r = parseInt(hex.substring(0, 2), 16);
-  const g = parseInt(hex.substring(2, 4), 16);
-  const b = parseInt(hex.substring(4, 6), 16);
-  if ([r, g, b].some((v) => Number.isNaN(v))) {
-    throw new Error(`Invalid hex color: "${hex}"`);
-  }
-  return [r, g, b];
-}
-
-export function rgbToHex(r: number, g: number, b: number): string {
-  const clamp = (v: number) => Math.max(0, Math.min(255, Math.round(v)));
-  return `#${clamp(r).toString(16).padStart(2, "0")}${clamp(g).toString(16).padStart(2, "0")}${clamp(b).toString(16).padStart(2, "0")}`;
-}
-
-export function lighten(hex: string, factor: number = 0.3): string {
-  const [r, g, b] = hexToRgb(hex);
-  return rgbToHex(
-    r + (255 - r) * factor,
-    g + (255 - g) * factor,
-    b + (255 - b) * factor
-  );
-}
-
-export function darken(hex: string, factor: number = 0.15): string {
-  const [r, g, b] = hexToRgb(hex);
-  return rgbToHex(r * (1 - factor), g * (1 - factor), b * (1 - factor));
-}
-
-export function toRgba(hex: string, alpha: number = 0.18): string {
-  const [r, g, b] = hexToRgb(hex);
-  return `rgba(${r}, ${g}, ${b}, ${alpha})`;
-}
-
-export function rgbToHsl(
-  r: number, g: number, b: number
-): [number, number, number] {
-  r /= 255; g /= 255; b /= 255;
-  const max = Math.max(r, g, b);
-  const min = Math.min(r, g, b);
-  let h = 0, s: number;
-  const l = (max + min) / 2;
-
-  if (max === min) {
-    h = s = 0;
-  } else {
-    const d = max - min;
-    s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
-    switch (max) {
-      case r:
-        h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
-        break;
-      case g:
-        h = ((b - r) / d + 2) / 6;
-        break;
-      case b:
-        h = ((r - g) / d + 4) / 6;
-        break;
-    }
-  }
-  return [h, s, l];
-}
-
-export function deriveSyntaxColors(
-  baseHex: string
-): Record<string, string> {
-  const [r, g, b] = hexToRgb(baseHex);
-  const [, , l] = rgbToHsl(r, g, b);
-  const isDark = l < 0.5;
-
-  if (isDark) {
-    return {
-      comment: lighten(baseHex, 0.4),
-      punctuation: lighten(baseHex, 0.2),
-      keyword: "#569cd6",
-      booleanBuiltinTag: "#569cd6",
-      string: "#ce9178",
-      number: "#b5cea8",
-      functionClass: "#dcdcaa",
-      operator: lighten(baseHex, 0.2),
-      variable: lighten(baseHex, 0.2),
-      regex: "#d16969",
-    };
-  } else {
-    return {
-      comment: darken(baseHex, 0.4),
-      punctuation: baseHex,
-      keyword: "#0000ff",
-      booleanBuiltinTag: "#0000ff",
-      string: "#a31515",
-      number: "#098658",
-      functionClass: "#795e26",
-      operator: baseHex,
-      variable: baseHex,
-      regex: "#811f3f",
-    };
-  }
-}
-
-export function sanitizeCssString(value: string): string {
-  // Remove HTML-injection vectors while preserving CSS syntax (quotes, spaces, commas)
-  return value.replace(/[<>]/g, "");
-}
-
-export function normalizeThemeStyle(style: import("./models.js").ThemeStyle): void {
-  const p = style.palette;
-  const t = style.typography;
-  const s = style.syntax;
-
-  if (!p.headingColor) p.headingColor = p.textColor;
-  if (!p.codeColor) p.codeColor = p.textColor;
-  if (!p.blockquoteBorder) p.blockquoteBorder = p.accentColor;
-  if (!p.selectionBg) p.selectionBg = toRgba(p.accentColor);
-  if (!t.headingFontFamily) t.headingFontFamily = t.bodyFontFamily;
-
-  // Sanitize font stacks to prevent CSS injection via crafted input
-  if (t.bodyFontFamily)    t.bodyFontFamily    = sanitizeCssString(t.bodyFontFamily);
-  if (t.headingFontFamily) t.headingFontFamily = sanitizeCssString(t.headingFontFamily);
-  if (t.codeFontFamily)    t.codeFontFamily    = sanitizeCssString(t.codeFontFamily);
-  if (style.seedTypography.fontMermaid) style.seedTypography.fontMermaid = sanitizeCssString(style.seedTypography.fontMermaid);
-
-  if (!s.comment) {
-    const derived = deriveSyntaxColors(p.codeBlockText);
-    for (const [key, value] of Object.entries(derived)) {
-      const k = key as keyof typeof s;
-      if (!s[k]) (s as unknown as Record<string, string>)[key] = value;
-    }
-  }
-}

package/src/contrast.ts

@@ -1,66 +0,0 @@
-/** WCAG 2.1 relative luminance and contrast ratio calculations. */
-
-import { hexToRgb } from "./color-utils.js";
-
-/** Linearize an sRGB channel value (0-255) → (0-1). */
-function linearize(channel: number): number {
-  const c = channel / 255;
-  return c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
-}
-
-/** WCAG 2.1 relative luminance of a hex color. */
-export function relativeLuminance(hex: string): number {
-  const [r, g, b] = hexToRgb(hex);
-  return 0.2126 * linearize(r) + 0.7152 * linearize(g) + 0.0722 * linearize(b);
-}
-
-/** WCAG 2.1 contrast ratio between two hex colors. Range: 1-21. */
-export function contrastRatio(hex1: string, hex2: string): number {
-  const L1 = relativeLuminance(hex1);
-  const L2 = relativeLuminance(hex2);
-  const lighter = Math.max(L1, L2);
-  const darker = Math.min(L1, L2);
-  return (lighter + 0.05) / (darker + 0.05);
-}
-
-/** Get HSL lightness (0-1) from a hex color. */
-export function hslLightness(hex: string): number {
-  const [r, g, b] = hexToRgb(hex);
-  const max = Math.max(r, g, b) / 255;
-  const min = Math.min(r, g, b) / 255;
-  return (max + min) / 2;
-}
-
-/** Get HSL saturation (0-1) from a hex color. */
-export function hslSaturation(hex: string): number {
-  const [r, g, b] = hexToRgb(hex);
-  const max = Math.max(r, g, b) / 255;
-  const min = Math.min(r, g, b) / 255;
-  const l = (max + min) / 2;
-  if (max === min) return 0;
-  return l > 0.5 ? (max - min) / (2 - max - min) : (max - min) / (max + min);
-}
-
-/** Get HSL hue (0-360) from a hex color. */
-export function hslHue(hex: string): number {
-  const [r, g, b] = hexToRgb(hex);
-  const max = Math.max(r, g, b);
-  const min = Math.min(r, g, b);
-  if (max === min) return 0;
-  const d = max - min;
-  let h = 0;
-  if (max === r) h = ((g - b) / d) % 6;
-  else if (max === g) h = (b - r) / d + 2;
-  else h = (r - g) / d + 4;
-  return Math.round(h * 60);
-}
-
-/** Check if two colors are on the same hue axis (within tolerance degrees). */
-export function sameHueAxis(h1: string, h2: string, tolerance: number = 5): boolean {
-  return Math.abs(hslHue(h1) - hslHue(h2)) <= tolerance;
-}
-
-/** Determine if a palette is light mode (bg luminance > 0.5). */
-export function isLightMode(bgHex: string): boolean {
-  return hslLightness(bgHex) > 0.5;
-}