@bytechain.cn/colamd-themes 0.3.0

package/dist/templates/theme-template.hbs

@@ -0,0 +1,370 @@
+/*
+ * ColaMD Theme: {{ name }}
+ * {{ description }}
+ * Generated by colamd-themes ({{ sourceType }}: {{ sourceUrl }})
+ *
+ * ═══════════════════════════════════════════════════════════
+ *   SECTION 1 — Design Tokens
+ *   Modify the 5 seed colors + 3 font stacks to change the theme
+ * ═══════════════════════════════════════════════════════════ */
+
+body.theme-custom {
+
+  /* ── 1.1 Seed Palette ── */
+  --seed-accent:        {{ seed.accent }};
+  --seed-accent-light:  {{ seed.accentLight }};
+  --seed-accent-dark:   {{ seed.accentDark }};
+  --seed-surface:       {{ seed.surface }};
+  --seed-panel:         {{ seed.panel }};
+  --seed-panel-alt:     {{ seed.panelAlt }};
+  --seed-ink:           {{ seed.ink }};
+  --seed-ink-muted:     {{ seed.inkMuted }};
+  --seed-ink-dim:       {{ seed.inkDim }};
+  --seed-border:        {{ seed.border }};
+  --seed-border-strong: {{ seed.borderStrong }};
+
+  /* ── 1.2 Typography ── */
+  --font-body:    {{{ seedTypography.fontBody }}};
+  --font-heading: {{{ seedTypography.fontHeading }}};
+  --font-code:    {{{ seedTypography.fontCode }}};
+  --font-mermaid: {{ seedTypography.fontMermaid }};
+
+  /* ── 1.3 Font Sizing ── */
+  --font-size-root:     {{ seedTypography.fontSizeRoot }};
+  --font-scale-h1:      {{ seedTypography.fontScaleH1 }};
+  --font-scale-h2:      {{ seedTypography.fontScaleH2 }};
+  --font-scale-h3:      {{ seedTypography.fontScaleH3 }};
+  --font-scale-h4:      {{ seedTypography.fontScaleH4 }};
+  --font-scale-h5:      {{ seedTypography.fontScaleH5 }};
+  --font-scale-h6:      {{ seedTypography.fontScaleH6 }};
+  --font-size-mermaid:  {{ seedTypography.fontSizeMermaid }};
+  --line-height-body:   {{ seedTypography.lineHeightBody }};
+  --line-height-heading: {{ seedTypography.lineHeightHeading }};
+  --line-height-code:   {{ seedTypography.lineHeightCode }};
+
+  /* ── 1.4 Radii & Spacing ── */
+  --radius-sm: {{ radiusSm }};
+  --radius-md: {{ radiusMd }};
+  --radius-lg: {{ radiusLg }};
+  --content-width: {{ contentWidth }};
+
+  /* ═══════════════════════════════════════════════════════════
+     SECTION 2 — Semantic Mapping
+     Auto-maps seed tokens → ColaMD built-in variables
+     ═══════════════════════════════════════════════════════════ */
+
+  /* ── 2.1 Surface ── */
+  --bg-color:      var(--seed-surface);
+  --surface-color: var(--seed-panel);
+  --surface-alt:   var(--seed-panel-alt);
+
+  /* ── 2.2 Text ── */
+  --text-color:    var(--seed-ink);
+  --heading-color: var(--seed-ink);
+  --text-muted:    var(--seed-ink-muted);
+  --text-dim:      var(--seed-ink-dim);
+
+  /* ── 2.3 Links & Accent ── */
+  --link-color:   var(--seed-accent);
+  --accent-color: var(--seed-accent);
+  --accent-dark:  var(--seed-accent-dark);
+  --accent-light: var(--seed-accent-light);
+  --selection-bg: {{rgba seed.accent 0.15}};
+
+  /* ── 2.4 Borders ── */
+  --border-color:      var(--seed-border);
+  --blockquote-border: var(--seed-accent);
+  --hr-color:          var(--seed-border);
+
+  /* ── 2.5 Inline Code ── */
+  --code-bg:    var(--seed-panel);
+  --code-color: var(--seed-accent-dark);
+
+  /* ── 2.6 Code Blocks ── */
+  --code-block-bg:    var(--seed-panel-alt);
+  --code-block-text:  var(--seed-ink);
+  --code-block-color: var(--seed-ink);
+
+  /* ── 2.7 Blockquote ── */
+  --blockquote-bg: var(--seed-panel);
+
+  /* ── 2.8 Tables ── */
+  --table-header-bg: var(--seed-panel);
+  --table-border:    var(--seed-border);
+
+  /* ── 2.9 Scrollbar ── */
+  --scrollbar-thumb:       var(--seed-border-strong);
+  --scrollbar-thumb-hover: var(--seed-ink-muted);
+
+  /* ═══════════════════════════════════════════════════════════
+     SECTION 3 — Mermaid 20 Core Variables
+     Auto-consumed by built-in variables.css for 22 diagram types
+     ═══════════════════════════════════════════════════════════ */
+
+  /* ── 3.1 Container ── */
+  --mermaid-background:    var(--seed-panel);
+  --mermaid-border-color:  var(--seed-border);
+  --mermaid-border-radius: var(--radius-md);
+  --mermaid-padding:       20px;
+
+  /* ── 3.2 Font ── */
+  --mermaid-font-family: var(--font-mermaid);
+  --mermaid-font-size:   var(--font-size-mermaid);
+
+  /* ── 3.3 Nodes ── */
+  --mermaid-node-fill:         var(--seed-panel);
+  --mermaid-node-stroke:       var(--seed-accent);
+  --mermaid-node-stroke-width: 1.5px;
+  --mermaid-node-text:         var(--seed-ink);
+
+  /* ── 3.4 Edges ── */
+  --mermaid-edge-stroke:       var(--seed-ink-muted);
+  --mermaid-edge-stroke-width: 1.5px;
+
+  /* ── 3.5 Clusters ── */
+  --mermaid-cluster-fill:   {{rgba seed.accent 0.06}};
+  --mermaid-cluster-stroke: var(--seed-accent);
+
+  /* ── 3.6 Labels ── */
+  --mermaid-label-text:      var(--seed-ink);
+  --mermaid-edge-label-text: var(--seed-ink-muted);
+  --mermaid-edge-label-bg:   var(--seed-surface);
+
+  /* ── 3.7 Titles & Axes ── */
+  --mermaid-title-text: var(--seed-ink);
+  --mermaid-axis-text:  var(--seed-ink-muted);
+  --mermaid-highlight:  var(--seed-accent);
+
+  /* ── 3.8 Person Nodes ── */
+  --mermaid-person-stroke: var(--seed-ink);
+  --mermaid-person-fill:   var(--seed-panel);
+
+  /* ── 3.9 Label Offset ── */
+  --mermaid-label-offset-y: 0px;
+
+  /* ── 4. Fine Tuning ── */
+  --line-height-base: var(--line-height-body);
+}
+
+/* ═══════════════════════════════════════════════════════════
+   SECTION 5 — Selector-Level Micro Adjustments
+   Only where base.css doesn't cover. All values via var(--*).
+   ═══════════════════════════════════════════════════════════ */
+
+html { font-size: var(--font-size-root); }
+body.theme-custom, html, body {
+  background-color: var(--bg-color);
+  color: var(--text-color);
+  font-family: var(--font-body);
+  line-height: var(--line-height-body);
+}
+
+#write {
+  max-width: var(--content-width);
+  margin: 0 auto;
+  padding: 30px 60px 100px;
+}
+
+body.theme-custom h1, body.theme-custom h2, body.theme-custom h3,
+body.theme-custom h4, body.theme-custom h5, body.theme-custom h6 {
+  font-family: var(--font-heading);
+  color: var(--heading-color);
+  font-weight: 700;
+  line-height: var(--line-height-heading);
+}
+
+body.theme-custom h1 { font-size: calc(var(--font-size-root) * var(--font-scale-h1)); }
+body.theme-custom h2 { font-size: calc(var(--font-size-root) * var(--font-scale-h2)); }
+body.theme-custom h3 { font-size: calc(var(--font-size-root) * var(--font-scale-h3)); }
+body.theme-custom h4 { font-size: calc(var(--font-size-root) * var(--font-scale-h4)); }
+body.theme-custom h5 { font-size: calc(var(--font-size-root) * var(--font-scale-h5)); }
+body.theme-custom h6 { font-size: calc(var(--font-size-root) * var(--font-scale-h6)); }
+
+body.theme-custom strong { color: var(--accent-color); }
+body.theme-custom code {
+  font-family: var(--font-code);
+  background: var(--code-bg);
+  color: var(--code-color);
+}
+
+body.theme-custom pre {
+  background: var(--code-block-bg);
+  font-family: var(--font-code);
+  line-height: var(--line-height-code);
+}
+body.theme-custom pre code { color: var(--code-block-text); background: transparent; }
+
+body.theme-custom blockquote {
+  background: var(--blockquote-bg);
+  border-left: 4px solid var(--blockquote-border);
+}
+
+body.theme-custom table th {
+  background: var(--table-header-bg);
+  font-weight: 700;
+  border-bottom: 2px solid var(--accent-color);
+}
+
+body.theme-custom hr {
+  border: none;
+  border-top: 1px solid var(--hr-color);
+}
+
+body.theme-custom img { max-width: 100%; }
+
+/* ── 5.11 Mermaid caption ── */
+body.theme-custom .mermaid-block + p {
+  text-align: center;
+  font-family: var(--font-heading);
+  font-size: calc(var(--font-size-mermaid) + 2px);
+  color: var(--text-muted);
+}
+
+/* ── 5.12 Responsive ── */
+@media only screen and (max-width: 768px) {
+  #write { padding: 20px; }
+  body.theme-custom .mermaid-block { padding: 12px; }
+}
+
+/* ═══════════════════════════════════════════════════════════
+   SECTION 6 — Print / Export
+   Screen mirror: every screen property restated with !important.
+   ═══════════════════════════════════════════════════════════ */
+@media print {
+  @page { margin: 20mm; }
+
+  /* ── 6.0 Variable re-declaration (Chromium strips CSS variables in print) ── */
+  body.theme-custom {
+    --seed-accent:       {{ seed.accent }};
+    --seed-accent-dark:  {{ seed.accentDark }};
+    --seed-surface:      {{ seed.surface }};
+    --seed-ink:          {{ seed.ink }};
+    --seed-ink-muted:    {{ seed.inkMuted }};
+    --seed-panel:        {{ seed.panel }};
+    --seed-panel-alt:    {{ seed.panelAlt }};
+    --seed-border:       {{ seed.border }};
+    --font-size-root:    {{ seedTypography.fontSizeRoot }};
+    --line-height-body:  {{ seedTypography.lineHeightBody }};
+    --line-height-heading: {{ seedTypography.lineHeightHeading }};
+    --line-height-code:  {{ seedTypography.lineHeightCode }};
+    --font-scale-h1:     {{ seedTypography.fontScaleH1 }};
+    --font-scale-h2:     {{ seedTypography.fontScaleH2 }};
+    --font-scale-h3:     {{ seedTypography.fontScaleH3 }};
+    --font-scale-h4:     {{ seedTypography.fontScaleH4 }};
+    --font-scale-h5:     {{ seedTypography.fontScaleH5 }};
+    --font-scale-h6:     {{ seedTypography.fontScaleH6 }};
+    --content-width:     {{ contentWidth }};
+    --font-size-mermaid: {{ seedTypography.fontSizeMermaid }};
+    --accent-color:      var(--seed-accent);
+    --accent-dark:       var(--seed-accent-dark);
+    --code-bg:           var(--seed-panel);
+    --code-color:        var(--seed-accent-dark);
+    --code-block-bg:     var(--seed-panel-alt);
+    --code-block-text:   var(--seed-ink);
+    --blockquote-bg:     var(--seed-panel);
+    --table-header-bg:   var(--seed-panel);
+    --border-color:      var(--seed-border);
+    --hr-color:          var(--seed-border);
+  }
+
+  html, body, body.theme-custom {
+    background: var(--seed-surface) !important;
+    color: var(--seed-ink) !important;
+    font-family: var(--font-body) !important;
+    line-height: var(--line-height-body) !important;
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+  }
+
+  #write {
+    max-width: var(--content-width) !important;
+    margin: 0 auto !important;
+    padding: 30px 60px 100px !important;
+  }
+
+  body.theme-custom h1, body.theme-custom h2, body.theme-custom h3,
+  body.theme-custom h4, body.theme-custom h5, body.theme-custom h6 {
+    font-family: var(--font-heading) !important;
+    color: var(--seed-ink) !important;
+    font-weight: 700 !important;
+    line-height: var(--line-height-heading) !important;
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+  }
+  body.theme-custom h1 { font-size: calc(var(--font-size-root) * var(--font-scale-h1)) !important; }
+  body.theme-custom h2 { font-size: calc(var(--font-size-root) * var(--font-scale-h2)) !important; }
+  body.theme-custom h3 { font-size: calc(var(--font-size-root) * var(--font-scale-h3)) !important; }
+  body.theme-custom h4 { font-size: calc(var(--font-size-root) * var(--font-scale-h4)) !important; }
+  body.theme-custom h5 { font-size: calc(var(--font-size-root) * var(--font-scale-h5)) !important; }
+  body.theme-custom h6 { font-size: calc(var(--font-size-root) * var(--font-scale-h6)) !important; }
+
+  body.theme-custom strong {
+    color: var(--accent-color) !important;
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+  }
+
+  body.theme-custom code {
+    font-family: var(--font-code) !important;
+    background: var(--code-bg) !important;
+    color: var(--code-color) !important;
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+  }
+
+  body.theme-custom pre {
+    background: var(--code-block-bg) !important;
+    font-family: var(--font-code) !important;
+    line-height: var(--line-height-code) !important;
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+  }
+  body.theme-custom pre code { color: var(--code-block-text) !important; background: transparent !important; }
+
+  body.theme-custom blockquote {
+    background: var(--blockquote-bg) !important;
+    border-left: 4px solid var(--seed-accent) !important;
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+  }
+
+  body.theme-custom table th {
+    background: var(--table-header-bg) !important;
+    color: var(--seed-ink) !important;
+    font-weight: 700 !important;
+    border-bottom: 2px solid var(--accent-color) !important;
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+  }
+
+  body.theme-custom a {
+    color: var(--seed-accent) !important;
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+  }
+
+  body.theme-custom hr {
+    border: none !important;
+    border-top: 1px solid var(--hr-color) !important;
+  }
+
+  body.theme-custom img { max-width: 100% !important; }
+
+  body.theme-custom .mermaid-block {
+    background: var(--seed-surface) !important;
+    border-color: var(--seed-border) !important;
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+  }
+  body.theme-custom .mermaid-preview svg * {
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+  }
+
+  body.theme-custom .mermaid-block + p {
+    color: var(--seed-ink-muted) !important;
+    text-align: center !important;
+    font-family: var(--font-heading) !important;
+    font-size: calc(var(--font-size-mermaid) + 2px) !important;
+  }
+}

package/dist/theme-store.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Theme configuration persistence.
+ *
+ * Stores default theme and registered custom themes in ~/.colamd-themes/config.json
+ */
+/** Built-in themes provided by @bytechain.cn/colamd */
+export declare const BUILTIN_THEMES: readonly ["light", "dark", "elegant", "newsprint"];
+export type BuiltinTheme = (typeof BUILTIN_THEMES)[number];
+export interface ThemeConfig {
+    /** Default theme name (built-in or custom) */
+    defaultTheme: string;
+    /** Registered custom themes: name → CSS file path */
+    themes: Record<string, string>;
+}
+/** Get the full config. */
+export declare function getConfig(): ThemeConfig;
+/** Set the default theme (built-in name or registered custom name). */
+export declare function setDefaultTheme(name: string): void;
+/**
+ * Register a custom theme.
+ * @param name  Unique name (will be prefixed with "custom:" when applied)
+ * @param cssPath  Absolute path to the CSS file
+ */
+export declare function registerTheme(name: string, cssPath: string): void;
+/** Remove a registered custom theme. */
+export declare function unregisterTheme(name: string): boolean;
+/**
+ * Resolve a theme name to the arguments needed by the ColaMD renderer.
+ *
+ * @param name  Theme name. If omitted, uses the configured default.
+ * @returns { themeName, customCSS? } — themeName is either a built-in name
+ *          or "custom:<name>"; customCSS is the CSS content for custom themes.
+ */
+export declare function resolveTheme(name?: string): {
+    themeName: string;
+    customCSS?: string;
+};

package/dist/theme-store.js

@@ -0,0 +1,90 @@
+/**
+ * Theme configuration persistence.
+ *
+ * Stores default theme and registered custom themes in ~/.colamd-themes/config.json
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const CONFIG_DIR = join(homedir(), ".colamd-themes");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+/** Built-in themes provided by @bytechain.cn/colamd */
+export const BUILTIN_THEMES = ["light", "dark", "elegant", "newsprint"];
+function readConfig() {
+    if (!existsSync(CONFIG_FILE))
+        return { defaultTheme: "elegant", themes: {} };
+    try {
+        return JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
+    }
+    catch {
+        return { defaultTheme: "elegant", themes: {} };
+    }
+}
+function writeConfig(config) {
+    if (!existsSync(CONFIG_DIR))
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
+}
+/** Get the full config. */
+export function getConfig() {
+    return readConfig();
+}
+/** Set the default theme (built-in name or registered custom name). */
+export function setDefaultTheme(name) {
+    const config = readConfig();
+    config.defaultTheme = name;
+    writeConfig(config);
+}
+/**
+ * Register a custom theme.
+ * @param name  Unique name (will be prefixed with "custom:" when applied)
+ * @param cssPath  Absolute path to the CSS file
+ */
+export function registerTheme(name, cssPath) {
+    const config = readConfig();
+    config.themes[name] = cssPath;
+    writeConfig(config);
+}
+/** Remove a registered custom theme. */
+export function unregisterTheme(name) {
+    const config = readConfig();
+    if (!(name in config.themes))
+        return false;
+    delete config.themes[name];
+    writeConfig(config);
+    return true;
+}
+/**
+ * Resolve a theme name to the arguments needed by the ColaMD renderer.
+ *
+ * @param name  Theme name. If omitted, uses the configured default.
+ * @returns { themeName, customCSS? } — themeName is either a built-in name
+ *          or "custom:<name>"; customCSS is the CSS content for custom themes.
+ */
+export function resolveTheme(name) {
+    const config = readConfig();
+    const resolved = name ?? config.defaultTheme;
+    // Check if it's a registered custom theme
+    if (config.themes[resolved]) {
+        const cssPath = config.themes[resolved];
+        if (!existsSync(cssPath)) {
+            throw new Error(`Custom theme CSS file not found: ${cssPath}`);
+        }
+        return { themeName: `custom:${resolved}`, customCSS: readFileSync(cssPath, "utf-8") };
+    }
+    // Check if it's a built-in theme
+    if (BUILTIN_THEMES.includes(resolved)) {
+        return { themeName: resolved };
+    }
+    // Treat as a direct CSS file path
+    if (existsSync(resolved)) {
+        const nameFromPath = resolved.replace(/\.css$/i, "").split("/").pop() ?? "custom";
+        return {
+            themeName: `custom:${nameFromPath}`,
+            customCSS: readFileSync(resolved, "utf-8"),
+        };
+    }
+    throw new Error(`Unknown theme: "${resolved}". Use a built-in theme (${BUILTIN_THEMES.join(", ")}), ` +
+        `a registered custom theme, or a path to a .css file.`);
+}
+//# sourceMappingURL=theme-store.js.map

package/dist/theme-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-store.js","sourceRoot":"","sources":["../src/theme-store.ts"],"names":[],"mappings":"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"}

package/dist/validators.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Paradigm validation engine — checks SeedPalette against v3.0 design constraints.
+ * Based on theme-paradigm.md Section 2.
+ */
+export interface ValidationIssue {
+    ruleId: string;
+    level: "MUST" | "MUST_NOT" | "SHOULD" | "SHOULD_NOT";
+    message: string;
+    fix?: string;
+}
+export interface SeedPalette {
+    accent: string;
+    accentLight: string;
+    accentDark: string;
+    surface: string;
+    panel: string;
+    panelAlt: string;
+    ink: string;
+    inkMuted: string;
+    inkDim: string;
+    border: string;
+    borderStrong: string;
+}
+export declare function validateSeedPalette(palette: SeedPalette): ValidationIssue[];
+/** Summarize validation results. */
+export declare function summarizeIssues(issues: ValidationIssue[]): string;

package/dist/validators.js

@@ -0,0 +1,144 @@
+/**
+ * Paradigm validation engine — checks SeedPalette against v3.0 design constraints.
+ * Based on theme-paradigm.md Section 2.
+ */
+import { contrastRatio, hslSaturation, hslLightness, sameHueAxis, isLightMode } from "./contrast.js";
+export function validateSeedPalette(palette) {
+    const issues = [];
+    const light = isLightMode(palette.surface);
+    // CR-01: ink vs surface ≥ 7:1
+    const crInk = contrastRatio(palette.ink, palette.surface);
+    if (crInk < 7.0) {
+        issues.push({
+            ruleId: "CR-01",
+            level: "MUST",
+            message: `正文-底色对比度 ${crInk.toFixed(1)}:1 < 7:1 (WCAG AAA)`,
+            fix: `建议加深 ink 或调浅 surface`,
+        });
+    }
+    // CR-02: inkMuted vs surface ≥ 4.5:1
+    const crMuted = contrastRatio(palette.inkMuted, palette.surface);
+    if (crMuted < 4.5) {
+        issues.push({
+            ruleId: "CR-02",
+            level: "MUST",
+            message: `次要文字-底色对比度 ${crMuted.toFixed(1)}:1 < 4.5:1 (WCAG AA)`,
+        });
+    }
+    // CR-04: accent vs surface ≥ 4.5:1
+    const crAccent = contrastRatio(palette.accent, palette.surface);
+    if (crAccent < 4.5) {
+        issues.push({
+            ruleId: "CR-04",
+            level: "MUST",
+            message: `点缀色-底色对比度 ${crAccent.toFixed(1)}:1 < 4.5:1`,
+        });
+    }
+    // SL-01: surface saturation ≤ 0.05
+    const sSurface = hslSaturation(palette.surface);
+    if (sSurface > 0.05) {
+        issues.push({
+            ruleId: "SL-01",
+            level: "MUST",
+            message: `底色饱和度 ${(sSurface * 100).toFixed(1)}% > 5%，页面会偏色`,
+        });
+    }
+    // SL-02: panel/panelAlt saturation ≤ 0.10
+    for (const [name, hex] of [["panel", palette.panel], ["panelAlt", palette.panelAlt]]) {
+        const s = hslSaturation(hex);
+        if (s > 0.10) {
+            issues.push({
+                ruleId: "SL-02",
+                level: "MUST_NOT",
+                message: `表面色 ${name} 饱和度 ${(s * 100).toFixed(1)}% > 10%`,
+            });
+        }
+    }
+    // SL-03: surface/panel/panelAlt same hue axis
+    if (!sameHueAxis(palette.surface, palette.panel, 5) || !sameHueAxis(palette.surface, palette.panelAlt, 5)) {
+        issues.push({
+            ruleId: "SL-03",
+            level: "SHOULD",
+            message: "三层表面色应保持相同色相轴（H 偏差 ≤ 5°）",
+        });
+    }
+    // SL-04: L(surface) > L(panel) > L(panelAlt) for light
+    const lSurface = hslLightness(palette.surface);
+    const lPanel = hslLightness(palette.panel);
+    const lPanelAlt = hslLightness(palette.panelAlt);
+    if (light) {
+        if (!(lSurface > lPanel && lPanel > lPanelAlt)) {
+            issues.push({
+                ruleId: "SL-04",
+                level: "MUST",
+                message: `浅色主题要求 L(surface) > L(panel) > L(panelAlt)`,
+            });
+        }
+    }
+    else {
+        if (!(lSurface < lPanel && lPanel < lPanelAlt)) {
+            issues.push({
+                ruleId: "SL-04",
+                level: "MUST",
+                message: `深色主题要求 L(surface) < L(panel) < L(panelAlt)`,
+            });
+        }
+    }
+    // NT-01: ink/inkMuted/inkDim same hue axis
+    if (!sameHueAxis(palette.ink, palette.inkMuted, 3) || !sameHueAxis(palette.ink, palette.inkDim, 3)) {
+        issues.push({
+            ruleId: "NT-01",
+            level: "MUST",
+            message: "文字色必须位于同一色相轴（H 偏差 ≤ 3°）",
+        });
+    }
+    // NT-02: border vs panel lightness diff ≥ 0.08
+    const lBorder = hslLightness(palette.border);
+    if (Math.abs(lBorder - lPanel) < 0.08) {
+        issues.push({
+            ruleId: "NT-02",
+            level: "MUST",
+            message: `边框色与 panel 明度差 ${Math.abs(lBorder - lPanel).toFixed(3)} < 0.08，边框不可见`,
+        });
+    }
+    // NT-03: border should be neutral gray
+    const sBorder = hslSaturation(palette.border);
+    if (sBorder > 0.05) {
+        issues.push({
+            ruleId: "NT-03",
+            level: "SHOULD",
+            message: `边框色饱和度 ${(sBorder * 100).toFixed(1)}% > 5%，应使用中性灰`,
+        });
+    }
+    // HR-01: accent saturation ≥ 0.30 for light themes
+    const sAccent = hslSaturation(palette.accent);
+    if (light && sAccent < 0.30) {
+        issues.push({
+            ruleId: "HR-01",
+            level: "SHOULD",
+            message: `点缀色饱和度 ${(sAccent * 100).toFixed(1)}% < 30%，建议选暖色或冷色`,
+        });
+    }
+    return issues;
+}
+/** Summarize validation results. */
+export function summarizeIssues(issues) {
+    const errors = issues.filter((i) => i.level === "MUST" || i.level === "MUST_NOT");
+    const warnings = issues.filter((i) => i.level === "SHOULD" || i.level === "SHOULD_NOT");
+    const lines = [];
+    if (errors.length > 0) {
+        lines.push(`ERRORS (${errors.length}):`);
+        for (const e of errors)
+            lines.push(`  [${e.ruleId}] ${e.message}`);
+    }
+    if (warnings.length > 0) {
+        lines.push(`WARNINGS (${warnings.length}):`);
+        for (const w of warnings)
+            lines.push(`  [${w.ruleId}] ${w.message}`);
+    }
+    if (errors.length === 0 && warnings.length === 0) {
+        lines.push("All validations passed.");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"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"}