@bytechain.cn/colamd-themes 0.3.0

package/dist/contrast.d.ts

@@ -0,0 +1,15 @@
+/** WCAG 2.1 relative luminance and contrast ratio calculations. */
+/** WCAG 2.1 relative luminance of a hex color. */
+export declare function relativeLuminance(hex: string): number;
+/** WCAG 2.1 contrast ratio between two hex colors. Range: 1-21. */
+export declare function contrastRatio(hex1: string, hex2: string): number;
+/** Get HSL lightness (0-1) from a hex color. */
+export declare function hslLightness(hex: string): number;
+/** Get HSL saturation (0-1) from a hex color. */
+export declare function hslSaturation(hex: string): number;
+/** Get HSL hue (0-360) from a hex color. */
+export declare function hslHue(hex: string): number;
+/** Check if two colors are on the same hue axis (within tolerance degrees). */
+export declare function sameHueAxis(h1: string, h2: string, tolerance?: number): boolean;
+/** Determine if a palette is light mode (bg luminance > 0.5). */
+export declare function isLightMode(bgHex: string): boolean;

package/dist/contrast.js

@@ -0,0 +1,63 @@
+/** 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) {
+    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) {
+    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, hex2) {
+    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) {
+    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) {
+    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) {
+    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, h2, tolerance = 5) {
+    return Math.abs(hslHue(h1) - hslHue(h2)) <= tolerance;
+}
+/** Determine if a palette is light mode (bg luminance > 0.5). */
+export function isLightMode(bgHex) {
+    return hslLightness(bgHex) > 0.5;
+}
+//# sourceMappingURL=contrast.js.map

package/dist/contrast.js.map

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

package/dist/docx-style-paradigm.d.ts

@@ -0,0 +1,153 @@
+/**
+ * DOCX 文档样式规范体系 — v1.0
+ *
+ * 核心功能：
+ * 1. 定义完整的文档元素样式层级（标题 H1-H6、正文、表格等）
+ * 2. 提供 WCAG 2.1 AAA 级对比度合规的标准参考值
+ * 3. 实现打印友好型灰度/低饱和度配色方案
+ * 4. 提供样式提取 fallback 与规范化工具
+ *
+ * 设计原则：
+ * - 文字色使用灰度轴（HSL S ≤ 0.05）或极低饱和度（S ≤ 0.15）
+ * - 背景色保持近白/近黑中性，饱和度 ≤ 0.03
+ * - 所有前景/背景对比度满足 WCAG AA (4.5:1) 或 AAA (7:1)
+ * - 行间距遵循中文排版规范（正文 1.5-1.9，标题 1.25-1.4）
+ */
+/** 单个字体样式的完整定义 */
+export interface FontStyleDefinition {
+    /** 字体家族（CSS font-family 值） */
+    fontFamily: string;
+    /** 字号（px） */
+    fontSize: number;
+    /** 字重（100-900） */
+    fontWeight: number;
+    /** 文字颜色（hex） */
+    color: string;
+    /** 行高倍率 */
+    lineHeight: number;
+    /** 字间距（em，可选） */
+    letterSpacing?: number;
+    /** 段后间距（em，可选） */
+    marginBottom?: number;
+}
+/** 表格单元格样式定义 */
+export interface TableCellStyle {
+    /** 表头字体家族 */
+    headerFontFamily: string;
+    /** 表头字号（px） */
+    headerFontSize: number;
+    /** 表头字重 */
+    headerFontWeight: number;
+    /** 表头文字颜色 */
+    headerColor: string;
+    /** 表头背景颜色 */
+    headerBgColor: string;
+    /** 表头行高 */
+    headerLineHeight: number;
+    /** 单元格字体家族 */
+    cellFontFamily: string;
+    /** 单元格字号（px） */
+    cellFontSize: number;
+    /** 单元格文字颜色 */
+    cellColor: string;
+    /** 单元格背景颜色 */
+    cellBgColor: string;
+    /** 单元格行高 */
+    cellLineHeight: number;
+    /** 单元格内边距 */
+    cellPadding: string;
+    /** 边框颜色 */
+    borderColor: string;
+    /** 边框宽度 */
+    borderWidth: string;
+}
+/** 完整的文档样式规范 */
+export interface DocumentStyleParadigm {
+    /** 文档背景颜色 */
+    pageBackground: string;
+    /** 各级标题样式映射 */
+    headings: Record<"h1" | "h2" | "h3" | "h4" | "h5" | "h6", FontStyleDefinition>;
+    /** 正文样式 */
+    body: FontStyleDefinition;
+    /** 引用块样式 */
+    blockquote: FontStyleDefinition & {
+        borderLeftColor: string;
+        bgColor: string;
+    };
+    /** 代码块样式 */
+    codeBlock: FontStyleDefinition & {
+        bgColor: string;
+    };
+    /** 内联代码样式 */
+    inlineCode: {
+        fontSize: number;
+        color: string;
+        bgColor: string;
+    };
+    /** 表格样式 */
+    table: TableCellStyle;
+    /** 链接/强调色 */
+    accentColor: string;
+    /** 弱化文字颜色（脚注、辅助信息） */
+    mutedTextColor: string;
+    /** 选区高亮色 */
+    selectionBg: string;
+}
+/** 打印优化配置 */
+export interface PrintOptimization {
+    /** 是否启用纯灰度模式（强制所有彩色转灰度） */
+    forceGrayscale: boolean;
+    /** 最大文字饱和度阈值（0-1） */
+    maxTextSaturation: number;
+    /** 最小对比度要求（WCAG 级别） */
+    minContrastRatio: "AA" | "AAA";
+    /** 背景色亮度调整（-1 到 1，负值变亮） */
+    bgBrightnessOffset: number;
+}
+/**
+ * 学术论文标准参考值
+ * 基于 GB/T 7713-1987 中文学术论文编排规则 + WCAG AAA
+ */
+export declare const ACADEMIC_PAPER_DEFAULTS: DocumentStyleParadigm;
+/**
+ * 商务报告标准参考值
+ * 现代、简洁、打印友好
+ */
+export declare const BUSINESS_REPORT_DEFAULTS: DocumentStyleParadigm;
+/**
+ * 技术文档标准参考值
+ * 适合 API 文档、技术手册
+ */
+export declare const TECHNICAL_DOC_DEFAULTS: DocumentStyleParadigm;
+/**
+ * 生成打印优化的灰度色板
+ * @param baseBrightness 页面基础亮度（0=纯黑，1=纯白）
+ * @param options 打印优化配置
+ */
+export declare function generatePrintFriendlyGrayscale(baseBrightness?: number, options?: Partial<PrintOptimization>): DocumentStyleParadigm;
+/**
+ * 生成低饱和度莫兰迪风格色板（适合打印）
+ * 保持微弱色相但大幅降低饱和度
+ */
+export declare function generateMorandiPrintPalette(hueDeg?: number, saturation?: number): DocumentStyleParadigm;
+export interface StyleValidationIssue {
+    level: "error" | "warning" | "info";
+    element: string;
+    message: string;
+    actualValue?: string;
+    expectedRange?: string;
+}
+/**
+ * 验证文档样式是否满足 WCAG 对比度要求和打印友好性
+ */
+export declare function validateDocumentStyle(style: DocumentStyleParadigm): StyleValidationIssue[];
+/**
+ * 强制将样式规范化为打印友好格式
+ * 降低饱和度、确保对比度达标
+ */
+export declare function normalizeForPrinting(style: DocumentStyleParadigm, forceGrayscale?: boolean): DocumentStyleParadigm;
+export declare const DOCUMENT_STYLE_PRESETS: Record<string, DocumentStyleParadigm>;
+/**
+ * 根据文档类型获取推荐预设
+ */
+export declare function getRecommendedPreset(docType?: string): DocumentStyleParadigm;