@xivdyetools/core 1.3.7

package/dist/services/color/ColorConverter.js

@@ -0,0 +1,393 @@
+/**
+ * Color Converter
+ * Per R-4: Focused class for color format conversions
+ * Handles conversions between hex, RGB, and HSV color formats
+ */
+import { createHexColor } from '../../types/index.js';
+import { ErrorCode, AppError } from '../../types/index.js';
+import { RGB_MIN, RGB_MAX, HUE_MAX } from '../../constants/index.js';
+import { clamp, round, isValidHexColor, isValidRGB, isValidHSV } from '../../utils/index.js';
+/**
+ * Simple LRU cache implementation
+ * Per P-1: Caching for color conversions (60-80% speedup)
+ */
+class LRUCache {
+    constructor(maxSize = 1000) {
+        this.cache = new Map();
+        this.maxSize = maxSize;
+    }
+    get(key) {
+        // CORE-PERF-001: Use has() check first to properly handle undefined values
+        // and ensure atomic move-to-end operation for LRU ordering
+        if (!this.cache.has(key))
+            return undefined;
+        const value = this.cache.get(key);
+        // Move to end (most recently used) - delete + set is atomic in synchronous JS
+        this.cache.delete(key);
+        this.cache.set(key, value);
+        return value;
+    }
+    set(key, value) {
+        if (this.cache.has(key)) {
+            // Update existing
+            this.cache.delete(key);
+        }
+        else if (this.cache.size >= this.maxSize) {
+            // Remove least recently used (first item)
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined) {
+                this.cache.delete(firstKey);
+            }
+        }
+        this.cache.set(key, value);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    get size() {
+        return this.cache.size;
+    }
+}
+/**
+ * Color format converter with LRU caching
+ * Per R-4: Single Responsibility - format conversions only
+ *
+ * Refactored for testability: Supports dependency injection of cache configuration
+ */
+export class ColorConverter {
+    /**
+     * Constructor with optional cache configuration
+     * @param config Configuration for cache sizes (default: 1000 entries per cache)
+     */
+    constructor(config = {}) {
+        const cacheSize = config.cacheSize ?? 1000;
+        this.hexToRgbCache = new LRUCache(cacheSize);
+        this.rgbToHexCache = new LRUCache(cacheSize);
+        this.rgbToHsvCache = new LRUCache(cacheSize);
+        this.hsvToRgbCache = new LRUCache(cacheSize);
+        this.hexToHsvCache = new LRUCache(cacheSize);
+    }
+    /**
+     * Get the default singleton instance
+     * Per Issue #6: Returns eagerly-initialized instance to avoid race conditions
+     */
+    static getDefault() {
+        return this.defaultInstance;
+    }
+    /**
+     * Clear all caches (useful for testing or memory management)
+     */
+    clearCaches() {
+        this.hexToRgbCache.clear();
+        this.rgbToHexCache.clear();
+        this.rgbToHsvCache.clear();
+        this.hsvToRgbCache.clear();
+        this.hexToHsvCache.clear();
+    }
+    /**
+     * Static method: Clear all caches of the default instance
+     */
+    static clearCaches() {
+        this.getDefault().clearCaches();
+    }
+    /**
+     * Get cache statistics (for monitoring)
+     */
+    getCacheStats() {
+        return {
+            hexToRgb: this.hexToRgbCache.size,
+            rgbToHex: this.rgbToHexCache.size,
+            rgbToHsv: this.rgbToHsvCache.size,
+            hsvToRgb: this.hsvToRgbCache.size,
+            hexToHsv: this.hexToHsvCache.size,
+        };
+    }
+    /**
+     * Static method: Get cache statistics from default instance
+     */
+    static getCacheStats() {
+        return this.getDefault().getCacheStats();
+    }
+    /**
+     * Convert hexadecimal color to RGB
+     * Per P-1: Cached for performance
+     * @example hexToRgb("#FF0000") -> { r: 255, g: 0, b: 0 }
+     */
+    hexToRgb(hex) {
+        if (!isValidHexColor(hex)) {
+            throw new AppError(ErrorCode.INVALID_HEX_COLOR, `Invalid hex color: ${hex}. Use format #RRGGBB or #RGB`, 'error');
+        }
+        // Normalize hex for cache key
+        let hexForCache = hex.toUpperCase().replace('#', '');
+        if (hexForCache.length === 3) {
+            hexForCache = hexForCache
+                .split('')
+                .map((c) => c + c)
+                .join('');
+        }
+        const cacheKey = hexForCache;
+        // Check cache
+        const cached = this.hexToRgbCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        // Remove # and expand shorthand (#RGB -> #RRGGBB)
+        let normalizedHex = hex.replace('#', '');
+        if (normalizedHex.length === 3) {
+            normalizedHex = normalizedHex
+                .split('')
+                .map((char) => char + char)
+                .join('');
+        }
+        const r = parseInt(normalizedHex.substring(0, 2), 16);
+        const g = parseInt(normalizedHex.substring(2, 4), 16);
+        const b = parseInt(normalizedHex.substring(4, 6), 16);
+        const result = { r, g, b };
+        // Cache result
+        this.hexToRgbCache.set(cacheKey, result);
+        return result;
+    }
+    /**
+     * Static method: Convert hex to RGB using default instance
+     */
+    static hexToRgb(hex) {
+        return this.getDefault().hexToRgb(hex);
+    }
+    /**
+     * Convert RGB to hexadecimal color
+     * Per P-1: Cached for performance
+     * @example rgbToHex(255, 0, 0) -> "#FF0000"
+     */
+    rgbToHex(r, g, b) {
+        if (!isValidRGB(r, g, b)) {
+            throw new AppError(ErrorCode.INVALID_RGB_VALUE, `Invalid RGB values: r=${r}, g=${g}, b=${b}. Values must be 0-255`, 'error');
+        }
+        // Create cache key
+        const cacheKey = `${r},${g},${b}`;
+        // Check cache
+        const cached = this.rgbToHexCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        const toHex = (value) => {
+            const hex = Math.round(value).toString(16);
+            return hex.length === 1 ? '0' + hex : hex;
+        };
+        const result = createHexColor(`#${toHex(r)}${toHex(g)}${toHex(b)}`.toUpperCase());
+        // Cache result
+        this.rgbToHexCache.set(cacheKey, result);
+        return result;
+    }
+    /**
+     * Static method: Convert RGB to hex using default instance
+     */
+    static rgbToHex(r, g, b) {
+        return this.getDefault().rgbToHex(r, g, b);
+    }
+    /**
+     * Convert RGB to HSV
+     * Per P-1: Cached for performance, optimized single-pass min/max
+     * @example rgbToHsv(255, 0, 0) -> { h: 0, s: 100, v: 100 }
+     */
+    rgbToHsv(r, g, b) {
+        if (!isValidRGB(r, g, b)) {
+            throw new AppError(ErrorCode.INVALID_RGB_VALUE, `Invalid RGB values: r=${r}, g=${g}, b=${b}`, 'error');
+        }
+        // Create cache key
+        const cacheKey = `${r},${g},${b}`;
+        // Check cache
+        const cached = this.rgbToHsvCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        // Per P-1: Optimized single-pass min/max calculation
+        // Normalize RGB to 0-1 range
+        const rNorm = r / 255;
+        const gNorm = g / 255;
+        const bNorm = b / 255;
+        // Single-pass min/max (optimized)
+        const max = Math.max(rNorm, gNorm, bNorm);
+        const min = Math.min(rNorm, gNorm, bNorm);
+        const delta = max - min;
+        // Calculate Value (brightness)
+        const v = max * 100;
+        // Calculate Saturation
+        const s = max === 0 ? 0 : (delta / max) * 100;
+        // Calculate Hue
+        let h = 0;
+        if (delta !== 0) {
+            if (max === rNorm) {
+                h = ((gNorm - bNorm) / delta + (gNorm < bNorm ? 6 : 0)) * 60;
+            }
+            else if (max === gNorm) {
+                h = ((bNorm - rNorm) / delta + 2) * 60;
+            }
+            else {
+                h = ((rNorm - gNorm) / delta + 4) * 60;
+            }
+        }
+        const result = { h: round(h, 2), s: round(s, 2), v: round(v, 2) };
+        // Cache result
+        this.rgbToHsvCache.set(cacheKey, result);
+        return result;
+    }
+    /**
+     * Static method: Convert RGB to HSV using default instance
+     */
+    static rgbToHsv(r, g, b) {
+        return this.getDefault().rgbToHsv(r, g, b);
+    }
+    /**
+     * Normalize hue to [0, 360) range.
+     * CORE-BUG-001: Ensures consistent cache keys for equivalent hue values
+     * (e.g., h=359.9999 and h=0.0001 both produce similar cache keys after rounding)
+     * Also handles negative values and values >= 360.
+     */
+    normalizeHue(h) {
+        return ((h % HUE_MAX) + HUE_MAX) % HUE_MAX;
+    }
+    /**
+     * Convert HSV to RGB
+     * Per P-1: Cached for performance
+     * @example hsvToRgb(0, 100, 100) -> { r: 255, g: 0, b: 0 }
+     */
+    hsvToRgb(h, s, v) {
+        if (!isValidHSV(h, s, v)) {
+            throw new AppError(ErrorCode.INVALID_RGB_VALUE, `Invalid HSV values: h=${h}, s=${s}, v=${v}`, 'error');
+        }
+        // CORE-BUG-001: Normalize hue BEFORE creating cache key
+        // This ensures h=359.9999 and h=0.0001 produce consistent cache keys
+        // after rounding, preventing cache thrashing for equivalent colors
+        const hNormalized = this.normalizeHue(h);
+        // Create cache key using consistent rounding (2 decimal places)
+        // Per Issue #17: Use same round() utility as rgbToHsv for consistency
+        const cacheKey = `${round(hNormalized, 2)},${round(s, 2)},${round(v, 2)}`;
+        // Check cache
+        const cached = this.hsvToRgbCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        // Normalize HSV (use already normalized hue)
+        const hNorm = hNormalized / 60;
+        const sNorm = s / 100;
+        const vNorm = v / 100;
+        const c = vNorm * sNorm;
+        const x = c * (1 - Math.abs((hNorm % 2) - 1));
+        const m = vNorm - c;
+        let rNorm = 0, gNorm = 0, bNorm = 0;
+        if (hNorm >= 0 && hNorm < 1) {
+            [rNorm, gNorm, bNorm] = [c, x, 0];
+        }
+        else if (hNorm >= 1 && hNorm < 2) {
+            [rNorm, gNorm, bNorm] = [x, c, 0];
+        }
+        else if (hNorm >= 2 && hNorm < 3) {
+            [rNorm, gNorm, bNorm] = [0, c, x];
+        }
+        else if (hNorm >= 3 && hNorm < 4) {
+            [rNorm, gNorm, bNorm] = [0, x, c];
+        }
+        else if (hNorm >= 4 && hNorm < 5) {
+            [rNorm, gNorm, bNorm] = [x, 0, c];
+        }
+        else {
+            [rNorm, gNorm, bNorm] = [c, 0, x];
+        }
+        const r = Math.round((rNorm + m) * 255);
+        const g = Math.round((gNorm + m) * 255);
+        const b = Math.round((bNorm + m) * 255);
+        const result = {
+            r: clamp(r, RGB_MIN, RGB_MAX),
+            g: clamp(g, RGB_MIN, RGB_MAX),
+            b: clamp(b, RGB_MIN, RGB_MAX),
+        };
+        // Cache result
+        this.hsvToRgbCache.set(cacheKey, result);
+        return result;
+    }
+    /**
+     * Static method: Convert HSV to RGB using default instance
+     */
+    static hsvToRgb(h, s, v) {
+        return this.getDefault().hsvToRgb(h, s, v);
+    }
+    /**
+     * Convert hex to HSV
+     * Per P-1: Cached for performance
+     */
+    hexToHsv(hex) {
+        // Normalize hex for cache key
+        let hexForCache = hex.toUpperCase().replace('#', '');
+        if (hexForCache.length === 3) {
+            hexForCache = hexForCache
+                .split('')
+                .map((c) => c + c)
+                .join('');
+        }
+        const cacheKey = hexForCache;
+        // Check cache
+        const cached = this.hexToHsvCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        const rgb = this.hexToRgb(hex);
+        const result = this.rgbToHsv(rgb.r, rgb.g, rgb.b);
+        // Cache result
+        this.hexToHsvCache.set(cacheKey, result);
+        return result;
+    }
+    /**
+     * Static method: Convert hex to HSV using default instance
+     */
+    static hexToHsv(hex) {
+        return this.getDefault().hexToHsv(hex);
+    }
+    /**
+     * Convert HSV to hex
+     */
+    hsvToHex(h, s, v) {
+        const rgb = this.hsvToRgb(h, s, v);
+        return this.rgbToHex(rgb.r, rgb.g, rgb.b);
+    }
+    /**
+     * Static method: Convert HSV to hex using default instance
+     */
+    static hsvToHex(h, s, v) {
+        return this.getDefault().hsvToHex(h, s, v);
+    }
+    /**
+     * Normalize a hex color to #RRGGBB format
+     */
+    normalizeHex(hex) {
+        const rgb = this.hexToRgb(hex);
+        return this.rgbToHex(rgb.r, rgb.g, rgb.b);
+    }
+    /**
+     * Static method: Normalize hex using default instance
+     */
+    static normalizeHex(hex) {
+        return this.getDefault().normalizeHex(hex);
+    }
+    /**
+     * Calculate Euclidean distance between two RGB colors
+     * Returns 0 for identical colors, ~441.67 for white vs black
+     */
+    getColorDistance(hex1, hex2) {
+        const rgb1 = this.hexToRgb(hex1);
+        const rgb2 = this.hexToRgb(hex2);
+        const dr = rgb1.r - rgb2.r;
+        const dg = rgb1.g - rgb2.g;
+        const db = rgb1.b - rgb2.b;
+        return Math.sqrt(dr * dr + dg * dg + db * db);
+    }
+    /**
+     * Static method: Calculate color distance using default instance
+     */
+    static getColorDistance(hex1, hex2) {
+        return this.getDefault().getColorDistance(hex1, hex2);
+    }
+}
+// Default singleton instance for static API compatibility
+// Per Issue #6: Eager initialization to avoid race conditions in concurrent scenarios
+ColorConverter.defaultInstance = new ColorConverter();
+//# sourceMappingURL=ColorConverter.js.map

package/dist/services/color/ColorConverter.js.map

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

package/dist/services/color/ColorManipulator.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Color Manipulator
+ * Per R-4: Focused class for color manipulation operations
+ * Handles brightness, saturation, hue rotation, inversion, and desaturation
+ */
+import type { HexColor } from '../../types/index.js';
+/**
+ * Color manipulation utilities
+ * Per R-4: Single Responsibility - color manipulation only
+ */
+export declare class ColorManipulator {
+    /**
+     * Adjust brightness of a color
+     * @param amount -100 to 100 (negative = darker, positive = lighter)
+     */
+    static adjustBrightness(hex: string, amount: number): HexColor;
+    /**
+     * Adjust saturation of a color
+     * @param amount -100 to 100 (negative = less saturated, positive = more saturated)
+     */
+    static adjustSaturation(hex: string, amount: number): HexColor;
+    /**
+     * Rotate hue of a color
+     * @param degrees Amount to rotate hue (can be negative or positive)
+     */
+    static rotateHue(hex: string, degrees: number): HexColor;
+    /**
+     * Invert a color (create complementary color)
+     */
+    static invert(hex: string): HexColor;
+    /**
+     * Desaturate a color (convert to grayscale)
+     */
+    static desaturate(hex: string): HexColor;
+}
+//# sourceMappingURL=ColorManipulator.d.ts.map

package/dist/services/color/ColorManipulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorManipulator.d.ts","sourceRoot":"","sources":["../../../src/services/color/ColorManipulator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIrD;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ;IAM9D;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ;IAM9D;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ;IAOxD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAKpC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;CAIzC"}

package/dist/services/color/ColorManipulator.js

@@ -0,0 +1,56 @@
+/**
+ * Color Manipulator
+ * Per R-4: Focused class for color manipulation operations
+ * Handles brightness, saturation, hue rotation, inversion, and desaturation
+ */
+import { clamp } from '../../utils/index.js';
+import { ColorConverter } from './ColorConverter.js';
+/**
+ * Color manipulation utilities
+ * Per R-4: Single Responsibility - color manipulation only
+ */
+export class ColorManipulator {
+    /**
+     * Adjust brightness of a color
+     * @param amount -100 to 100 (negative = darker, positive = lighter)
+     */
+    static adjustBrightness(hex, amount) {
+        const hsv = ColorConverter.hexToHsv(hex);
+        hsv.v = clamp(hsv.v + amount, 0, 100);
+        return ColorConverter.hsvToHex(hsv.h, hsv.s, hsv.v);
+    }
+    /**
+     * Adjust saturation of a color
+     * @param amount -100 to 100 (negative = less saturated, positive = more saturated)
+     */
+    static adjustSaturation(hex, amount) {
+        const hsv = ColorConverter.hexToHsv(hex);
+        hsv.s = clamp(hsv.s + amount, 0, 100);
+        return ColorConverter.hsvToHex(hsv.h, hsv.s, hsv.v);
+    }
+    /**
+     * Rotate hue of a color
+     * @param degrees Amount to rotate hue (can be negative or positive)
+     */
+    static rotateHue(hex, degrees) {
+        const hsv = ColorConverter.hexToHsv(hex);
+        // Normalize to 0-360 to handle negative values properly
+        hsv.h = (((hsv.h + degrees) % 360) + 360) % 360;
+        return ColorConverter.hsvToHex(hsv.h, hsv.s, hsv.v);
+    }
+    /**
+     * Invert a color (create complementary color)
+     */
+    static invert(hex) {
+        const rgb = ColorConverter.hexToRgb(hex);
+        return ColorConverter.rgbToHex(255 - rgb.r, 255 - rgb.g, 255 - rgb.b);
+    }
+    /**
+     * Desaturate a color (convert to grayscale)
+     */
+    static desaturate(hex) {
+        const hsv = ColorConverter.hexToHsv(hex);
+        return ColorConverter.hsvToHex(hsv.h, 0, hsv.v);
+    }
+}
+//# sourceMappingURL=ColorManipulator.js.map

package/dist/services/color/ColorManipulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorManipulator.js","sourceRoot":"","sources":["../../../src/services/color/ColorManipulator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAW,EAAE,MAAc;QACjD,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QACtC,OAAO,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAW,EAAE,MAAc;QACjD,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QACtC,OAAO,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,GAAW,EAAE,OAAe;QAC3C,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzC,wDAAwD;QACxD,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAChD,OAAO,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,GAAW;QACvB,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO,cAAc,CAAC,QAAQ,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAW;QAC3B,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/services/color/ColorblindnessSimulator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Colorblindness Simulator
+ * Per R-4: Focused class for colorblindness simulation
+ * Uses Brettel 1997 transformation matrices
+ */
+import type { RGB, HexColor, VisionType } from '../../types/index.js';
+/**
+ * Colorblindness simulator using Brettel 1997 matrices
+ * Per R-4: Single Responsibility - colorblindness simulation only
+ */
+export declare class ColorblindnessSimulator {
+    private static readonly colorblindCache;
+    /**
+     * Clear colorblindness cache
+     */
+    static clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    static getCacheStats(): {
+        colorblind: number;
+    };
+    /**
+     * Simulate colorblindness on an RGB color
+     * Uses Brettel 1997 transformation matrices (pre-computed constants)
+     * Per P-1: Cached by ${r},${g},${b}_${visionType} key
+     * @example simulateColorblindness({ r: 255, g: 0, b: 0 }, 'deuteranopia')
+     */
+    static simulateColorblindness(rgb: RGB, visionType: VisionType): RGB;
+    /**
+     * Simulate colorblindness on a hex color
+     */
+    static simulateColorblindnessHex(hex: string, visionType: VisionType): HexColor;
+}
+//# sourceMappingURL=ColorblindnessSimulator.d.ts.map

package/dist/services/color/ColorblindnessSimulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorblindnessSimulator.d.ts","sourceRoot":"","sources":["../../../src/services/color/ColorblindnessSimulator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAgDtE;;;GAGG;AACH,qBAAa,uBAAuB;IAElC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAmC;IAE1E;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE;IAM9C;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,UAAU,GAAG,GAAG;IA+CpE;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,QAAQ;CAKhF"}

package/dist/services/color/ColorblindnessSimulator.js

@@ -0,0 +1,110 @@
+/**
+ * Colorblindness Simulator
+ * Per R-4: Focused class for colorblindness simulation
+ * Uses Brettel 1997 transformation matrices
+ */
+import { ErrorCode, AppError } from '../../types/index.js';
+import { BRETTEL_MATRICES } from '../../constants/index.js';
+import { clamp, round, isValidRGB } from '../../utils/index.js';
+import { ColorConverter } from './ColorConverter.js';
+/**
+ * Simple LRU cache implementation
+ */
+class LRUCache {
+    constructor(maxSize = 1000) {
+        this.cache = new Map();
+        this.maxSize = maxSize;
+    }
+    get(key) {
+        const value = this.cache.get(key);
+        if (value !== undefined) {
+            this.cache.delete(key);
+            this.cache.set(key, value);
+        }
+        return value;
+    }
+    set(key, value) {
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        else if (this.cache.size >= this.maxSize) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined) {
+                this.cache.delete(firstKey);
+            }
+        }
+        this.cache.set(key, value);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    get size() {
+        return this.cache.size;
+    }
+}
+/**
+ * Colorblindness simulator using Brettel 1997 matrices
+ * Per R-4: Single Responsibility - colorblindness simulation only
+ */
+export class ColorblindnessSimulator {
+    /**
+     * Clear colorblindness cache
+     */
+    static clearCache() {
+        this.colorblindCache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    static getCacheStats() {
+        return {
+            colorblind: this.colorblindCache.size,
+        };
+    }
+    /**
+     * Simulate colorblindness on an RGB color
+     * Uses Brettel 1997 transformation matrices (pre-computed constants)
+     * Per P-1: Cached by ${r},${g},${b}_${visionType} key
+     * @example simulateColorblindness({ r: 255, g: 0, b: 0 }, 'deuteranopia')
+     */
+    static simulateColorblindness(rgb, visionType) {
+        if (visionType === 'normal') {
+            return { ...rgb };
+        }
+        if (!isValidRGB(rgb.r, rgb.g, rgb.b)) {
+            throw new AppError(ErrorCode.INVALID_RGB_VALUE, 'Invalid RGB values for colorblindness simulation', 'error');
+        }
+        // Per P-1: Cache key format: ${r},${g},${b}_${visionType}
+        const cacheKey = `${rgb.r},${rgb.g},${rgb.b}_${visionType}`;
+        // Check cache
+        const cached = this.colorblindCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        // Per P-1: BRETTEL_MATRICES are already pre-computed constants (no recalculation needed)
+        const matrix = BRETTEL_MATRICES[visionType];
+        // Normalize RGB to 0-1 range
+        const rNorm = rgb.r / 255;
+        const gNorm = rgb.g / 255;
+        const bNorm = rgb.b / 255;
+        // Apply transformation matrix
+        const transformedR = round(clamp((matrix[0][0] * rNorm + matrix[0][1] * gNorm + matrix[0][2] * bNorm) * 255, 0, 255));
+        const transformedG = round(clamp((matrix[1][0] * rNorm + matrix[1][1] * gNorm + matrix[1][2] * bNorm) * 255, 0, 255));
+        const transformedB = round(clamp((matrix[2][0] * rNorm + matrix[2][1] * gNorm + matrix[2][2] * bNorm) * 255, 0, 255));
+        const result = { r: transformedR, g: transformedG, b: transformedB };
+        // Cache result
+        this.colorblindCache.set(cacheKey, result);
+        return result;
+    }
+    /**
+     * Simulate colorblindness on a hex color
+     */
+    static simulateColorblindnessHex(hex, visionType) {
+        const rgb = ColorConverter.hexToRgb(hex);
+        const simulated = this.simulateColorblindness(rgb, visionType);
+        return ColorConverter.rgbToHex(simulated.r, simulated.g, simulated.b);
+    }
+}
+// Per P-1: LRU cache for colorblindness simulation
+ColorblindnessSimulator.colorblindCache = new LRUCache(1000);
+//# sourceMappingURL=ColorblindnessSimulator.js.map

package/dist/services/color/ColorblindnessSimulator.js.map

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