@bytechain.cn/colamd-themes 0.5.0 → 0.5.2

package/src/generator.ts

@@ -1,197 +0,0 @@
-/** CSS theme file generator — v4.0 seed palette pipeline (ColaMD 2.7.7 contract). */
-
-import Handlebars from "handlebars";
-import { readFileSync, writeFileSync, mkdirSync, existsSync, statSync } from "node:fs";
-import { join, dirname, isAbsolute } from "node:path";
-import { fileURLToPath } from "node:url";
-import type { ThemeStyle } from "./models.js";
-import { paletteToSeed } from "./models.js";
-import { toRgba, normalizeThemeStyle } from "./color-utils.js";
-import { matchColorSystem } from "./color-systems.js";
-import { contrastRatio } from "./contrast.js";
-import { validateSeedPalette, validateThemeCss, summarizeIssues } from "./validators.js";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const templatePath = join(__dirname, "templates", "theme-template.hbs");
-
-// ── Handlebars helpers ──
-
-Handlebars.registerHelper("rgba", (hex: unknown, alpha: unknown) => {
-  return toRgba(String(hex), Number(alpha));
-});
-
-// ── Template Cache with Size Limits and Auto-Invalidation ──
-
-/** 模板上下文：ThemeStyle + 生成阶段算出的派生值。 */
-type TemplateContext = ThemeStyle & { codeBlockText: string };
-
-interface CachedTemplate {
-  compiled: HandlebarsTemplateDelegate<TemplateContext>;
-  mtimeMs: number;
-  compiledAt: number;
-}
-
-const TEMPLATE_CACHE_MAX_SIZE = 10;
-const TEMPLATE_CACHE_TTL_MS = 30 * 60 * 1000; // 30 minutes
-const templateCache = new Map<string, CachedTemplate>();
-
-/**
- * Get or compile a Handlebars template with caching.
- *
- * Features:
- * - LRU-style cache (max 10 templates)
- * - File modification time detection for auto-invalidation
- * - TTL-based expiration (30 minutes)
- * - Automatic cleanup of expired entries on access
- */
-function getTemplate(path?: string): HandlebarsTemplateDelegate<TemplateContext> {
-  const key = path || templatePath;
-
-  // Check cache hit
-  const cached = templateCache.get(key);
-  if (cached) {
-    // Check TTL expiration
-    if (Date.now() - cached.compiledAt > TEMPLATE_CACHE_TTL_MS) {
-      templateCache.delete(key);
-    }
-    // Check file modification time
-    else {
-      try {
-        const stats = statSync(key);
-        if (stats.mtimeMs > cached.mtimeMs) {
-          templateCache.delete(key);
-        } else {
-          return cached.compiled;
-        }
-      } catch {
-        return cached.compiled;
-      }
-    }
-  }
-
-  // Enforce max cache size (evict oldest entry)
-  if (templateCache.size >= TEMPLATE_CACHE_MAX_SIZE) {
-    let oldestKey: string | null = null;
-    let oldestTime = Infinity;
-
-    for (const [k, v] of templateCache.entries()) {
-      if (v.compiledAt < oldestTime) {
-        oldestTime = v.compiledAt;
-        oldestKey = k;
-      }
-    }
-
-    if (oldestKey) {
-      templateCache.delete(oldestKey);
-    }
-  }
-
-  // Compile new template
-  const source = readFileSync(key, "utf-8");
-  const compiled = Handlebars.compile(source, { noEscape: true });
-
-  // Get modification time for invalidation
-  let mtimeMs = 0;
-  try {
-    mtimeMs = statSync(key).mtimeMs;
-  } catch {
-    mtimeMs = Date.now();
-  }
-
-  templateCache.set(key, {
-    compiled,
-    mtimeMs,
-    compiledAt: Date.now(),
-  });
-
-  return compiled;
-}
-
-/**
- * Clear all cached templates to free memory.
- */
-export function clearTemplateCache(): void {
-  templateCache.clear();
-}
-
-/**
- * 代码块文字色：从代码块底色出发，在白、浅灰、种子正文色里挑对比度最高的一档。
- * 深色代码块（如 elegant）因此拿到浅色文字，浅色代码块拿到正文色。
- */
-function pickCodeBlockText(bg: string, seed: ThemeStyle["seed"]): string {
-  const candidates = Array.from(new Set(["#ffffff", "#f5f5f5", seed.surface, seed.ink]));
-  let best = candidates[0];
-  let bestRatio = 0;
-  for (const candidate of candidates) {
-    const ratio = contrastRatio(candidate, bg);
-    if (ratio > bestRatio) {
-      bestRatio = ratio;
-      best = candidate;
-    }
-  }
-  return best;
-}
-
-// ── Pipeline ──
-
-export function generateCss(style: ThemeStyle): string {
-  // 1. Map legacy palette → seed palette if seed is still default
-  if (style.seed.accent === "#6366f1") {
-    style.seed = paletteToSeed(style.palette);
-  }
-
-  // 2. Normalize from legacy extractor path
-  normalizeThemeStyle(style);
-
-  // 3. Match color system
-  if (!style.colorSystemId) {
-    const cs = matchColorSystem(style.seed.accent, style.seed.surface);
-    style.colorSystemId = cs.id;
-  }
-
-  // 4. Validate seed palette against paradigm
-  const issues = validateSeedPalette(style.seed);
-  if (issues.filter((i) => i.level === "MUST" || i.level === "MUST_NOT").length > 0) {
-    console.warn("Paradigm validation issues:", summarizeIssues(issues));
-  }
-
-  // 5. Render
-  const template = getTemplate();
-  const css = template({
-    ...style,
-    codeBlockText: pickCodeBlockText(style.seed.panelAlt, style.seed),
-  });
-
-  // 6. Self-check the rendered CSS against the 2.7.7 contract
-  const cssIssues = validateThemeCss(css).filter(
-    (i) => i.level === "MUST" || i.level === "MUST_NOT"
-  );
-  if (cssIssues.length > 0) {
-    console.warn("CSS contract issues:", summarizeIssues(cssIssues));
-  }
-
-  return css;
-}
-
-export function writeThemeFile(
-  style: ThemeStyle,
-  target: string = "themes"
-): string {
-  const css = generateCss(style);
-  const safeName = style.name.replace(/[^a-zA-Z0-9_-]/g, "-").replace(/-+/g, "-");
-
-  let filePath: string;
-  if (target.endsWith(".css")) {
-    filePath = isAbsolute(target) ? target : join(process.cwd(), target);
-  } else {
-    const dirPath = isAbsolute(target) ? target : join(process.cwd(), target);
-    if (!existsSync(dirPath)) mkdirSync(dirPath, { recursive: true });
-    filePath = join(dirPath, `${safeName}.css`);
-  }
-
-  const parent = dirname(filePath);
-  if (!existsSync(parent)) mkdirSync(parent, { recursive: true });
-
-  writeFileSync(filePath, css, "utf-8");
-  return filePath;
-}

package/src/index.ts

@@ -1,29 +0,0 @@
-/** ColaMD Theme Development Tool. */
-
-export * from "./models.js";
-export * from "./color-utils.js";
-export * from "./generator.js";
-export { UrlExtractor } from "./extractors/url-extractor.js";
-export { DocxExtractor } from "./extractors/docx-extractor.js";
-export { PdfExtractor } from "./extractors/pdf-extractor.js";
-export type { Extractor } from "./extractors/base.js";
-
-export {
-  ACADEMIC_PAPER_DEFAULTS,
-  BUSINESS_REPORT_DEFAULTS,
-  TECHNICAL_DOC_DEFAULTS,
-  generatePrintFriendlyGrayscale,
-  generateMorandiPrintPalette,
-  validateDocumentStyle,
-  normalizeForPrinting,
-  getRecommendedPreset,
-  DOCUMENT_STYLE_PRESETS,
-} from "./docx-style-paradigm.js";
-
-export type {
-  DocumentStyleParadigm,
-  FontStyleDefinition,
-  TableCellStyle,
-  PrintOptimization,
-  StyleValidationIssue,
-} from "./docx-style-paradigm.js";

package/src/models.ts

@@ -1,212 +0,0 @@
-/** Theme style data models — v4.0 Seed Palette paradigm (ColaMD 2.7.7 contract). */
-
-// ═══════════════════════════════════════════════════════════
-// Legacy model (kept for extractor compatibility)
-// ═══════════════════════════════════════════════════════════
-
-export interface ColorPalette {
-  bgColor: string;
-  textColor: string;
-  headingColor: string;
-  borderColor: string;
-  accentColor: string;
-  codeBg: string;
-  codeColor: string;
-  codeBlockBg: string;
-  codeBlockText: string;
-  blockquoteBg: string;
-  blockquoteBorder: string;
-  tableHeaderBg: string;
-  selectionBg: string;
-  textMuted: string;
-}
-
-export interface Typography {
-  bodyFontFamily: string;
-  headingFontFamily: string;
-  codeFontFamily: string;
-  baseFontSize: string;
-  baseLineHeight: number;
-  headingWeight: number;
-}
-
-export interface Spacing {
-  contentMaxWidth: string;
-  contentPadding: string;
-  paragraphMargin: string;
-  headingMarginTop: string;
-  headingMarginBottom: string;
-}
-
-export interface SyntaxHighlighting {
-  comment: string;
-  punctuation: string;
-  keyword: string;
-  booleanBuiltinTag: string;
-  string: string;
-  number: string;
-  functionClass: string;
-  operator: string;
-  variable: string;
-  regex: string;
-}
-
-// ═══════════════════════════════════════════════════════════
-// 2.7 Seed Palette model
-// ═══════════════════════════════════════════════════════════
-
-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 interface SeedTypography {
-  fontBody: string;
-  fontHeading: string;
-  fontCode: string;
-  /** @deprecated 2.7 起图表改用 Pele，Mermaid 字段仅为提取器兼容保留 */
-  fontMermaid: string;
-  fontSizeRoot: string;      // e.g. "16px"
-  fontScaleH1: number;
-  fontScaleH2: number;
-  fontScaleH3: number;
-  fontScaleH4: number;
-  fontScaleH5: number;
-  fontScaleH6: number;
-  /** @deprecated 2.7 起图表改用 Pele */
-  fontSizeMermaid: string;
-  lineHeightBody: number;
-  lineHeightHeading: number;
-  lineHeightCode: number;
-}
-
-export interface ThemeStyle {
-  name: string;
-  description: string;
-  /** Legacy — populated by extractors, then mapped to seed */
-  palette: ColorPalette;
-  typography: Typography;
-  spacing: Spacing;
-  syntax: SyntaxHighlighting;
-  /** 2.7 seed palette */
-  seed: SeedPalette;
-  seedTypography: SeedTypography;
-  /** Selected color system */
-  colorSystemId: string;
-  /** Metadata */
-  sourceUrl: string;
-  sourceType: string;
-  /** Computed radius and width */
-  radiusSm: string;
-  radiusMd: string;
-  radiusLg: string;
-  contentWidth: string;
-}
-
-// ═══════════════════════════════════════════════════════════
-// Defaults
-// ═══════════════════════════════════════════════════════════
-
-export function defaultPalette(): ColorPalette {
-  return {
-    bgColor: "#ffffff", textColor: "#000000", headingColor: "",
-    borderColor: "#cccccc", accentColor: "#0000ff", codeBg: "#f5f5f5",
-    codeColor: "", codeBlockBg: "#1e1e1e", codeBlockText: "#d4d4d4",
-    blockquoteBg: "#f9f9f9", blockquoteBorder: "",
-    tableHeaderBg: "#f0f0f0", selectionBg: "", textMuted: "#666666",
-  };
-}
-
-export function defaultTypography(): Typography {
-  return {
-    bodyFontFamily: "Georgia, serif", headingFontFamily: "",
-    codeFontFamily: "'JetBrains Mono', 'Fira Code', monospace",
-    baseFontSize: "16px", baseLineHeight: 1.9, headingWeight: 700,
-  };
-}
-
-export function defaultSpacing(): Spacing {
-  return {
-    contentMaxWidth: "820px", contentPadding: "30px 60px 100px",
-    paragraphMargin: "0.8em 0", headingMarginTop: "1.8em",
-    headingMarginBottom: "0.6em",
-  };
-}
-
-export function defaultSyntax(): SyntaxHighlighting {
-  return { comment: "", punctuation: "", keyword: "", booleanBuiltinTag: "",
-    string: "", number: "", functionClass: "", operator: "", variable: "", regex: "" };
-}
-
-export function defaultSeedPalette(): SeedPalette {
-  return {
-    accent: "#6366f1", accentLight: "#eef2ff", accentDark: "#4f46e5",
-    surface: "#ffffff", panel: "#f8f9fb", panelAlt: "#f1f3f5",
-    ink: "#1a1d26", inkMuted: "#6b7280", inkDim: "#9ca3af",
-    border: "#e5e7eb", borderStrong: "#d1d5db",
-  };
-}
-
-export function defaultSeedTypography(): SeedTypography {
-  return {
-    fontBody: `"Inter", "SF Pro Text", -apple-system, "Noto Serif SC", "Source Han Serif SC", Georgia, serif`,
-    fontHeading: `"Inter", "SF Pro Display", -apple-system, "Noto Sans SC", "PingFang SC", sans-serif`,
-    fontCode: `"JetBrains Mono", "SF Mono", "Fira Code", Menlo, Consolas, monospace`,
-    fontMermaid: `var(--font-body)`,
-    fontSizeRoot: "16px",
-    fontScaleH1: 2.0, fontScaleH2: 1.5, fontScaleH3: 1.25,
-    fontScaleH4: 1.1, fontScaleH5: 1.0, fontScaleH6: 0.95,
-    fontSizeMermaid: "13px",
-    lineHeightBody: 1.75, lineHeightHeading: 1.35, lineHeightCode: 1.6,
-  };
-}
-
-// ═══════════════════════════════════════════════════════════
-// Factory
-// ═══════════════════════════════════════════════════════════
-
-export function makeThemeStyle(name: string, sourceType: string, sourceUrl: string): ThemeStyle {
-  return {
-    name,
-    description: `Theme extracted from ${sourceType}`,
-    palette: defaultPalette(),
-    typography: defaultTypography(),
-    spacing: defaultSpacing(),
-    syntax: defaultSyntax(),
-    seed: defaultSeedPalette(),
-    seedTypography: defaultSeedTypography(),
-    colorSystemId: "",
-    sourceUrl,
-    sourceType,
-    radiusSm: "3px",
-    radiusMd: "6px",
-    radiusLg: "10px",
-    contentWidth: "820px",
-  };
-}
-
-/** Map legacy ColorPalette to SeedPalette. */
-export function paletteToSeed(palette: ColorPalette): SeedPalette {
-  return {
-    accent: palette.accentColor,
-    accentLight: palette.selectionBg || palette.accentColor,
-    accentDark: palette.accentColor,
-    surface: palette.bgColor,
-    panel: palette.codeBg,
-    panelAlt: palette.codeBlockBg,
-    ink: palette.textColor,
-    inkMuted: palette.textMuted,
-    inkDim: palette.textMuted,
-    border: palette.borderColor,
-    borderStrong: palette.borderColor,
-  };
-}