@xivdyetools/core 1.6.0 → 1.8.0

package/dist/data/locales/de.json

@@ -2,7 +2,7 @@
   "locale": "de",
   "meta": {
     "version": "1.0.0",
-    "generated": "2026-01-08T06:40:47.306Z",
+    "generated": "2026-01-11T15:20:52.073Z",
     "dyeCount": 125
   },
   "labels": {

package/dist/data/locales/en.json

@@ -2,7 +2,7 @@
   "locale": "en",
   "meta": {
     "version": "1.0.0",
-    "generated": "2026-01-08T06:40:47.303Z",
+    "generated": "2026-01-11T15:20:52.071Z",
     "dyeCount": 125
   },
   "labels": {

package/dist/data/locales/fr.json

@@ -2,7 +2,7 @@
   "locale": "fr",
   "meta": {
     "version": "1.0.0",
-    "generated": "2026-01-08T06:40:47.307Z",
+    "generated": "2026-01-11T15:20:52.074Z",
     "dyeCount": 125
   },
   "labels": {

package/dist/data/locales/ja.json

@@ -2,7 +2,7 @@
   "locale": "ja",
   "meta": {
     "version": "1.0.0",
-    "generated": "2026-01-08T06:40:47.305Z",
+    "generated": "2026-01-11T15:20:52.073Z",
     "dyeCount": 125
   },
   "labels": {

package/dist/index.d.ts

@@ -6,11 +6,15 @@ export { LocalizationService } from './services/LocalizationService.js';
 export { PresetService } from './services/PresetService.js';
 export { PaletteService } from './services/PaletteService.js';
 export type { PaletteExtractionOptions, ExtractedColor, PaletteMatch, PaletteServiceOptions, } from './services/PaletteService.js';
-export type { Dye, LocalizedDye, RGB, HSV, HexColor, VisionType, Matrix3x3, ColorblindMatrices, ErrorSeverity, PriceData, CachedData, LocaleCode, TranslationKey, HarmonyTypeKey, JobKey, GrandCompanyKey, LocaleData, LocalePreference, Logger, PresetCategory, CategoryMeta, PresetPalette, ResolvedPreset, PresetData, PresetStatus, CommunityPreset, PresetSubmission, PresetListResponse, PresetSubmitResponse, VoteResponse, PresetFilters, } from './types/index.js';
-export { AppError, ErrorCode, createHexColor, NoOpLogger, ConsoleLogger } from './types/index.js';
+export { CharacterColorService } from './services/CharacterColorService.js';
+export type { Dye, LocalizedDye, RGB, HSV, LAB, HexColor, VisionType, Matrix3x3, ColorblindMatrices, ErrorSeverity, PriceData, CachedData, LocaleCode, TranslationKey, HarmonyTypeKey, JobKey, GrandCompanyKey, LocaleData, LocalePreference, Logger, PresetCategory, CategoryMeta, PresetPalette, ResolvedPreset, PresetData, PresetStatus, CommunityPreset, PresetSubmission, PresetListResponse, PresetSubmitResponse, VoteResponse, PresetFilters, CharacterColor, CharacterColorMatch, SubRace, Gender, Race, } from './types/index.js';
+export type { HarmonyOptions, HarmonyMatchingAlgorithm, } from './services/dye/HarmonyGenerator.js';
+export type { DeltaEFormula } from './services/color/ColorConverter.js';
+export { AppError, ErrorCode, createHexColor, NoOpLogger, ConsoleLogger, RACE_SUBRACES, SUBRACE_TO_RACE, COLOR_GRID_DIMENSIONS, } from './types/index.js';
 export { RGB_MIN, RGB_MAX, HUE_MIN, HUE_MAX, SATURATION_MIN, SATURATION_MAX, VALUE_MIN, VALUE_MAX, COLOR_DISTANCE_MAX, VISION_TYPES, VISION_TYPE_LABELS, BRETTEL_MATRICES, PATTERNS, UNIVERSALIS_API_BASE, UNIVERSALIS_API_TIMEOUT, UNIVERSALIS_API_RETRY_COUNT, UNIVERSALIS_API_RETRY_DELAY, API_CACHE_TTL, API_DEBOUNCE_DELAY, API_CACHE_VERSION, API_MAX_RESPONSE_SIZE, API_RATE_LIMIT_DELAY, } from './constants/index.js';
 export { clamp, lerp, round, distance, unique, groupBy, sortByProperty, filterNulls, isValidHexColor, isValidRGB, isValidHSV, isString, isNumber, isArray, isObject, isNullish, sleep, retry, isAbortError, generateChecksum, } from './utils/index.js';
 export { default as dyeDatabase } from './data/colors_xiv.json';
 export { default as presetData } from './data/presets.json';
+export { default as characterColorData } from './data/character_colors.json';
 export { VERSION } from './version.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EACV,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AAGtC,YAAY,EACV,GAAG,EACH,YAAY,EACZ,GAAG,EACH,GAAG,EACH,QAAQ,EACR,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,MAAM,EACN,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,MAAM,EAEN,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,UAAU,EAEV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGlG,OAAO,EACL,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,cAAc,EACd,cAAc,EACd,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,2BAA2B,EAC3B,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,KAAK,EACL,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,cAAc,EACd,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,EACL,KAAK,EACL,YAAY,EACZ,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAuB;AACtF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAuB;AAGlF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EACV,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAG5E,YAAY,EACV,GAAG,EACH,YAAY,EACZ,GAAG,EACH,GAAG,EACH,GAAG,EACH,QAAQ,EACR,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,MAAM,EACN,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,MAAM,EAEN,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,UAAU,EAEV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EAEb,cAAc,EACd,mBAAmB,EACnB,OAAO,EACP,MAAM,EACN,IAAI,GACL,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,cAAc,EACd,wBAAwB,GACzB,MAAM,oCAAoC,CAAC;AAG5C,YAAY,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EACL,QAAQ,EACR,SAAS,EACT,cAAc,EACd,UAAU,EACV,aAAa,EAEb,aAAa,EACb,eAAe,EACf,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,cAAc,EACd,cAAc,EACd,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,2BAA2B,EAC3B,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,KAAK,EACL,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,cAAc,EACd,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,EACL,KAAK,EACL,YAAY,EACZ,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAuB;AACtF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAuB;AAClF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,8BAA8B,CAAuB;AAGnG,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -5,7 +5,10 @@ export { APIService, MemoryCacheBackend } from './services/APIService.js';
 export { LocalizationService } from './services/LocalizationService.js';
 export { PresetService } from './services/PresetService.js';
 export { PaletteService } from './services/PaletteService.js';
-export { AppError, ErrorCode, createHexColor, NoOpLogger, ConsoleLogger } from './types/index.js';
+export { CharacterColorService } from './services/CharacterColorService.js';
+export { AppError, ErrorCode, createHexColor, NoOpLogger, ConsoleLogger, 
+// Character constants
+RACE_SUBRACES, SUBRACE_TO_RACE, COLOR_GRID_DIMENSIONS, } from './types/index.js';
 // Constants
 export { RGB_MIN, RGB_MAX, HUE_MIN, HUE_MAX, SATURATION_MIN, SATURATION_MAX, VALUE_MIN, VALUE_MAX, COLOR_DISTANCE_MAX, VISION_TYPES, VISION_TYPE_LABELS, BRETTEL_MATRICES, PATTERNS, UNIVERSALIS_API_BASE, UNIVERSALIS_API_TIMEOUT, UNIVERSALIS_API_RETRY_COUNT, UNIVERSALIS_API_RETRY_DELAY, API_CACHE_TTL, API_DEBOUNCE_DELAY, API_CACHE_VERSION, API_MAX_RESPONSE_SIZE, API_RATE_LIMIT_DELAY, } from './constants/index.js';
 // Utils
@@ -13,6 +16,7 @@ export { clamp, lerp, round, distance, unique, groupBy, sortByProperty, filterNu
 // Data (for browser environments - to be injected)
 export { default as dyeDatabase } from './data/colors_xiv.json' with { type: 'json' };
 export { default as presetData } from './data/presets.json' with { type: 'json' };
+export { default as characterColorData } from './data/character_colors.json' with { type: 'json' };
 // Version (auto-generated from package.json during build)
 export { VERSION } from './version.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AA4C9D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAElG,YAAY;AACZ,OAAO,EACL,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,cAAc,EACd,cAAc,EACd,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,2BAA2B,EAC3B,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,QAAQ;AACR,OAAO,EACL,KAAK,EACL,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,cAAc,EACd,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,EACL,KAAK,EACL,YAAY,EACZ,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,mDAAmD;AACnD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAElF,0DAA0D;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAO9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAsD5E,OAAO,EACL,QAAQ,EACR,SAAS,EACT,cAAc,EACd,UAAU,EACV,aAAa;AACb,sBAAsB;AACtB,aAAa,EACb,eAAe,EACf,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,YAAY;AACZ,OAAO,EACL,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,cAAc,EACd,cAAc,EACd,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,2BAA2B,EAC3B,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,QAAQ;AACR,OAAO,EACL,KAAK,EACL,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,cAAc,EACd,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,EACL,KAAK,EACL,YAAY,EACZ,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,mDAAmD;AACnD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,8BAA8B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEnG,0DAA0D;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/services/CharacterColorService.d.ts

@@ -0,0 +1,125 @@
+/**
+ * @xivdyetools/core - Character Color Service
+ *
+ * Service for accessing FFXIV character customization colors and
+ * finding matching dyes for hair, eye, skin tones etc.
+ *
+ * @module services/CharacterColorService
+ * @example
+ * ```typescript
+ * import { CharacterColorService, DyeService, dyeDatabase } from '@xivdyetools/core';
+ *
+ * const characterColors = new CharacterColorService();
+ * const dyeService = new DyeService(dyeDatabase);
+ *
+ * // Get all eye colors
+ * const eyeColors = characterColors.getEyeColors();
+ *
+ * // Find closest dyes to an eye color
+ * const matches = characterColors.findClosestDyes(eyeColors[47], dyeService, 3);
+ * ```
+ */
+import type { CharacterColor, CharacterColorMatch, SharedColorCategory, RaceSpecificColorCategory, SubRace, Gender } from '@xivdyetools/types';
+import type { DyeService } from './DyeService.js';
+/**
+ * Service for accessing FFXIV character customization colors
+ */
+export declare class CharacterColorService {
+    private data;
+    constructor();
+    /**
+     * Get all eye colors (192 colors)
+     */
+    getEyeColors(): CharacterColor[];
+    /**
+     * Get all hair highlight colors (192 colors)
+     */
+    getHighlightColors(): CharacterColor[];
+    /**
+     * Get all dark lip colors (96 colors)
+     */
+    getLipColorsDark(): CharacterColor[];
+    /**
+     * Get all light lip colors (96 colors)
+     */
+    getLipColorsLight(): CharacterColor[];
+    /**
+     * Get all tattoo/limbal ring colors (192 colors)
+     */
+    getTattooColors(): CharacterColor[];
+    /**
+     * Get all dark face paint colors (96 colors)
+     */
+    getFacePaintColorsDark(): CharacterColor[];
+    /**
+     * Get all light face paint colors (96 colors)
+     */
+    getFacePaintColorsLight(): CharacterColor[];
+    /**
+     * Get shared colors by category
+     */
+    getSharedColors(category: SharedColorCategory): CharacterColor[];
+    /**
+     * Get hair colors for a specific subrace and gender (192 colors each)
+     */
+    getHairColors(subrace: SubRace, gender: Gender): CharacterColor[];
+    /**
+     * Get skin colors for a specific subrace and gender (192 colors each)
+     */
+    getSkinColors(subrace: SubRace, gender: Gender): CharacterColor[];
+    /**
+     * Get race-specific colors by category
+     */
+    getRaceSpecificColors(category: RaceSpecificColorCategory, subrace: SubRace, gender: Gender): CharacterColor[];
+    /**
+     * Find the closest matching dyes to a character color
+     *
+     * @param color - The character color to match
+     * @param dyeService - DyeService instance for dye lookup
+     * @param count - Number of matches to return (default: 3)
+     * @returns Array of matches sorted by distance (closest first)
+     *
+     * @example
+     * ```typescript
+     * const eyeColor = characterColors.getEyeColors()[47];
+     * const matches = characterColors.findClosestDyes(eyeColor, dyeService, 3);
+     *
+     * console.log(matches[0].dye.name); // "Chestnut Brown"
+     * console.log(matches[0].distance); // 4.2
+     * ```
+     */
+    findClosestDyes(color: CharacterColor, dyeService: DyeService, count?: number): CharacterColorMatch[];
+    /**
+     * Find the single closest dye to a character color
+     */
+    findClosestDye(color: CharacterColor, dyeService: DyeService): CharacterColorMatch | null;
+    /**
+     * Find all dyes within a color distance threshold
+     */
+    findDyesWithinDistance(color: CharacterColor, dyeService: DyeService, maxDistance: number): CharacterColorMatch[];
+    /**
+     * Get a specific color by index from a shared category
+     */
+    getSharedColorByIndex(category: SharedColorCategory, index: number): CharacterColor | null;
+    /**
+     * Get a specific color by index from a race-specific category
+     */
+    getRaceSpecificColorByIndex(category: RaceSpecificColorCategory, subrace: SubRace, gender: Gender, index: number): CharacterColor | null;
+    /**
+     * Get all available subraces
+     */
+    getAvailableSubraces(): SubRace[];
+    /**
+     * Get the data version
+     */
+    getVersion(): string;
+    /**
+     * Get grid column count (always 8)
+     */
+    getGridColumns(): number;
+    /**
+     * Calculate Euclidean distance in RGB space
+     */
+    private calculateDistance;
+}
+//# sourceMappingURL=CharacterColorService.d.ts.map

package/dist/services/CharacterColorService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CharacterColorService.d.ts","sourceRoot":"","sources":["../../src/services/CharacterColorService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,OAAO,EACP,MAAM,EACP,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAqBlD;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,IAAI,CAAqB;;IAUjC;;OAEG;IACH,YAAY,IAAI,cAAc,EAAE;IAIhC;;OAEG;IACH,kBAAkB,IAAI,cAAc,EAAE;IAItC;;OAEG;IACH,gBAAgB,IAAI,cAAc,EAAE;IAIpC;;OAEG;IACH,iBAAiB,IAAI,cAAc,EAAE;IAIrC;;OAEG;IACH,eAAe,IAAI,cAAc,EAAE;IAInC;;OAEG;IACH,sBAAsB,IAAI,cAAc,EAAE;IAI1C;;OAEG;IACH,uBAAuB,IAAI,cAAc,EAAE;IAI3C;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,mBAAmB,GAAG,cAAc,EAAE;IAQhE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAIjE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAIjE;;OAEG;IACH,qBAAqB,CACnB,QAAQ,EAAE,yBAAyB,EACnC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GACb,cAAc,EAAE;IAQnB;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CACb,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE,UAAU,EACtB,KAAK,GAAE,MAAU,GAChB,mBAAmB,EAAE;IAuBxB;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,GAAG,mBAAmB,GAAG,IAAI;IAKzF;;OAEG;IACH,sBAAsB,CACpB,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,MAAM,GAClB,mBAAmB,EAAE;IA2BxB;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAK1F;;OAEG;IACH,2BAA2B,CACzB,QAAQ,EAAE,yBAAyB,EACnC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,cAAc,GAAG,IAAI;IASxB;;OAEG;IACH,oBAAoB,IAAI,OAAO,EAAE;IAKjC;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,cAAc,IAAI,MAAM;IAQxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAM1B"}

package/dist/services/CharacterColorService.js

@@ -0,0 +1,223 @@
+/**
+ * @xivdyetools/core - Character Color Service
+ *
+ * Service for accessing FFXIV character customization colors and
+ * finding matching dyes for hair, eye, skin tones etc.
+ *
+ * @module services/CharacterColorService
+ * @example
+ * ```typescript
+ * import { CharacterColorService, DyeService, dyeDatabase } from '@xivdyetools/core';
+ *
+ * const characterColors = new CharacterColorService();
+ * const dyeService = new DyeService(dyeDatabase);
+ *
+ * // Get all eye colors
+ * const eyeColors = characterColors.getEyeColors();
+ *
+ * // Find closest dyes to an eye color
+ * const matches = characterColors.findClosestDyes(eyeColors[47], dyeService, 3);
+ * ```
+ */
+// Import character color data
+import characterColorData from '../data/character_colors.json';
+/**
+ * Service for accessing FFXIV character customization colors
+ */
+export class CharacterColorService {
+    constructor() {
+        this.data = characterColorData;
+    }
+    // ==========================================================================
+    // Shared Colors (Race-Agnostic)
+    // ==========================================================================
+    /**
+     * Get all eye colors (192 colors)
+     */
+    getEyeColors() {
+        return this.data.shared.eyeColors || [];
+    }
+    /**
+     * Get all hair highlight colors (192 colors)
+     */
+    getHighlightColors() {
+        return this.data.shared.highlightColors || [];
+    }
+    /**
+     * Get all dark lip colors (96 colors)
+     */
+    getLipColorsDark() {
+        return this.data.shared.lipColorsDark || [];
+    }
+    /**
+     * Get all light lip colors (96 colors)
+     */
+    getLipColorsLight() {
+        return this.data.shared.lipColorsLight || [];
+    }
+    /**
+     * Get all tattoo/limbal ring colors (192 colors)
+     */
+    getTattooColors() {
+        return this.data.shared.tattooColors || [];
+    }
+    /**
+     * Get all dark face paint colors (96 colors)
+     */
+    getFacePaintColorsDark() {
+        return this.data.shared.facePaintColorsDark || [];
+    }
+    /**
+     * Get all light face paint colors (96 colors)
+     */
+    getFacePaintColorsLight() {
+        return this.data.shared.facePaintColorsLight || [];
+    }
+    /**
+     * Get shared colors by category
+     */
+    getSharedColors(category) {
+        return this.data.shared[category] || [];
+    }
+    // ==========================================================================
+    // Race-Specific Colors
+    // ==========================================================================
+    /**
+     * Get hair colors for a specific subrace and gender (192 colors each)
+     */
+    getHairColors(subrace, gender) {
+        return this.data.raceSpecific.hairColors?.[subrace]?.[gender] || [];
+    }
+    /**
+     * Get skin colors for a specific subrace and gender (192 colors each)
+     */
+    getSkinColors(subrace, gender) {
+        return this.data.raceSpecific.skinColors?.[subrace]?.[gender] || [];
+    }
+    /**
+     * Get race-specific colors by category
+     */
+    getRaceSpecificColors(category, subrace, gender) {
+        return this.data.raceSpecific[category]?.[subrace]?.[gender] || [];
+    }
+    // ==========================================================================
+    // Color Matching
+    // ==========================================================================
+    /**
+     * Find the closest matching dyes to a character color
+     *
+     * @param color - The character color to match
+     * @param dyeService - DyeService instance for dye lookup
+     * @param count - Number of matches to return (default: 3)
+     * @returns Array of matches sorted by distance (closest first)
+     *
+     * @example
+     * ```typescript
+     * const eyeColor = characterColors.getEyeColors()[47];
+     * const matches = characterColors.findClosestDyes(eyeColor, dyeService, 3);
+     *
+     * console.log(matches[0].dye.name); // "Chestnut Brown"
+     * console.log(matches[0].distance); // 4.2
+     * ```
+     */
+    findClosestDyes(color, dyeService, count = 3) {
+        const allDyes = dyeService.getAllDyes();
+        const results = [];
+        for (const dye of allDyes) {
+            // Skip Facewear dyes (not usable for regular glamour)
+            if (dye.category === 'Facewear') {
+                continue;
+            }
+            const distance = this.calculateDistance(color.rgb, dye.rgb);
+            results.push({
+                characterColor: color,
+                dye,
+                distance,
+            });
+        }
+        // Sort by distance and return top N
+        results.sort((a, b) => a.distance - b.distance);
+        return results.slice(0, count);
+    }
+    /**
+     * Find the single closest dye to a character color
+     */
+    findClosestDye(color, dyeService) {
+        const matches = this.findClosestDyes(color, dyeService, 1);
+        return matches[0] || null;
+    }
+    /**
+     * Find all dyes within a color distance threshold
+     */
+    findDyesWithinDistance(color, dyeService, maxDistance) {
+        const allDyes = dyeService.getAllDyes();
+        const results = [];
+        for (const dye of allDyes) {
+            if (dye.category === 'Facewear') {
+                continue;
+            }
+            const distance = this.calculateDistance(color.rgb, dye.rgb);
+            if (distance <= maxDistance) {
+                results.push({
+                    characterColor: color,
+                    dye,
+                    distance,
+                });
+            }
+        }
+        results.sort((a, b) => a.distance - b.distance);
+        return results;
+    }
+    // ==========================================================================
+    // Color Lookup
+    // ==========================================================================
+    /**
+     * Get a specific color by index from a shared category
+     */
+    getSharedColorByIndex(category, index) {
+        const colors = this.getSharedColors(category);
+        return colors.find((c) => c.index === index) || null;
+    }
+    /**
+     * Get a specific color by index from a race-specific category
+     */
+    getRaceSpecificColorByIndex(category, subrace, gender, index) {
+        const colors = this.getRaceSpecificColors(category, subrace, gender);
+        return colors.find((c) => c.index === index) || null;
+    }
+    // ==========================================================================
+    // Metadata
+    // ==========================================================================
+    /**
+     * Get all available subraces
+     */
+    getAvailableSubraces() {
+        const hairColors = this.data.raceSpecific.hairColors || {};
+        return Object.keys(hairColors);
+    }
+    /**
+     * Get the data version
+     */
+    getVersion() {
+        return this.data.meta.version;
+    }
+    /**
+     * Get grid column count (always 8)
+     */
+    getGridColumns() {
+        return this.data.meta.gridColumns;
+    }
+    // ==========================================================================
+    // Private Helpers
+    // ==========================================================================
+    /**
+     * Calculate Euclidean distance in RGB space
+     */
+    calculateDistance(rgb1, rgb2) {
+        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);
+    }
+}
+//# sourceMappingURL=CharacterColorService.js.map

package/dist/services/CharacterColorService.js.map

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

package/dist/services/DyeService.d.ts

@@ -25,6 +25,7 @@
  * ```
  */
 import type { Dye, LocalizedDye, Logger } from '../types/index.js';
+import { type HarmonyOptions } from './dye/HarmonyGenerator.js';
 /**
  * Configuration options for DyeService
  */
@@ -131,41 +132,61 @@ export declare class DyeService {
     getDyesSortedByHue(ascending?: boolean): Dye[];
     /**
      * Find dyes that form a complementary color pair
+     * @param hex Base hex color
+     * @param options Matching algorithm options (optional)
      */
-    findComplementaryPair(hex: string): Dye | null;
+    findComplementaryPair(hex: string, options?: HarmonyOptions): Dye | null;
     /**
      * Find analogous dyes (adjacent on color wheel)
      * Returns dyes at ±angle degrees from the base color
+     * @param hex Base hex color
+     * @param angle Hue offset in degrees (default: 30)
+     * @param options Matching algorithm options (optional)
      */
-    findAnalogousDyes(hex: string, angle?: number): Dye[];
+    findAnalogousDyes(hex: string, angle?: number, options?: HarmonyOptions): Dye[];
     /**
      * Find triadic color scheme (colors 120° apart on color wheel)
+     * @param hex Base hex color
+     * @param options Matching algorithm options (optional)
      */
-    findTriadicDyes(hex: string): Dye[];
+    findTriadicDyes(hex: string, options?: HarmonyOptions): Dye[];
     /**
      * Find square color scheme (colors 90° apart on color wheel)
+     * @param hex Base hex color
+     * @param options Matching algorithm options (optional)
      */
-    findSquareDyes(hex: string): Dye[];
+    findSquareDyes(hex: string, options?: HarmonyOptions): Dye[];
     /**
      * Find tetradic color scheme (two complementary pairs)
+     * @param hex Base hex color
+     * @param options Matching algorithm options (optional)
      */
-    findTetradicDyes(hex: string): Dye[];
+    findTetradicDyes(hex: string, options?: HarmonyOptions): Dye[];
     /**
      * Find monochromatic dyes (same hue, varying saturation/brightness)
+     * @param hex Base hex color
+     * @param limit Maximum number of dyes to return (default: 6)
+     * @param options Matching algorithm options (optional)
      */
-    findMonochromaticDyes(hex: string, limit?: number): Dye[];
+    findMonochromaticDyes(hex: string, limit?: number, options?: HarmonyOptions): Dye[];
     /**
      * Find compound harmony (analogous + complementary)
+     * @param hex Base hex color
+     * @param options Matching algorithm options (optional)
      */
-    findCompoundDyes(hex: string): Dye[];
+    findCompoundDyes(hex: string, options?: HarmonyOptions): Dye[];
     /**
      * Find split-complementary harmony (±30° from the complementary hue)
+     * @param hex Base hex color
+     * @param options Matching algorithm options (optional)
      */
-    findSplitComplementaryDyes(hex: string): Dye[];
+    findSplitComplementaryDyes(hex: string, options?: HarmonyOptions): Dye[];
     /**
      * Find shades (similar tones, ±15°)
+     * @param hex Base hex color
+     * @param options Matching algorithm options (optional)
      */
-    findShadesDyes(hex: string): Dye[];
+    findShadesDyes(hex: string, options?: HarmonyOptions): Dye[];
     /**
      * Search dyes by name (searches both English + localized names)
      * If no locale is loaded, falls back to English-only search

package/dist/services/DyeService.d.ts.map

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

package/dist/services/DyeService.js

@@ -165,58 +165,78 @@ export class DyeService {
     // ============================================================================
     /**
      * Find dyes that form a complementary color pair
+     * @param hex Base hex color
+     * @param options Matching algorithm options (optional)
      */
-    findComplementaryPair(hex) {
-        return this.harmony.findComplementaryPair(hex);
+    findComplementaryPair(hex, options) {
+        return this.harmony.findComplementaryPair(hex, options);
     }
     /**
      * Find analogous dyes (adjacent on color wheel)
      * Returns dyes at ±angle degrees from the base color
+     * @param hex Base hex color
+     * @param angle Hue offset in degrees (default: 30)
+     * @param options Matching algorithm options (optional)
      */
-    findAnalogousDyes(hex, angle = 30) {
-        return this.harmony.findAnalogousDyes(hex, angle);
+    findAnalogousDyes(hex, angle = 30, options) {
+        return this.harmony.findAnalogousDyes(hex, angle, options);
     }
     /**
      * Find triadic color scheme (colors 120° apart on color wheel)
+     * @param hex Base hex color
+     * @param options Matching algorithm options (optional)
      */
-    findTriadicDyes(hex) {
-        return this.harmony.findTriadicDyes(hex);
+    findTriadicDyes(hex, options) {
+        return this.harmony.findTriadicDyes(hex, options);
     }
     /**
      * Find square color scheme (colors 90° apart on color wheel)
+     * @param hex Base hex color
+     * @param options Matching algorithm options (optional)
      */
-    findSquareDyes(hex) {
-        return this.harmony.findSquareDyes(hex);
+    findSquareDyes(hex, options) {
+        return this.harmony.findSquareDyes(hex, options);
     }
     /**
      * Find tetradic color scheme (two complementary pairs)
+     * @param hex Base hex color
+     * @param options Matching algorithm options (optional)
      */
-    findTetradicDyes(hex) {
-        return this.harmony.findTetradicDyes(hex);
+    findTetradicDyes(hex, options) {
+        return this.harmony.findTetradicDyes(hex, options);
     }
     /**
      * Find monochromatic dyes (same hue, varying saturation/brightness)
+     * @param hex Base hex color
+     * @param limit Maximum number of dyes to return (default: 6)
+     * @param options Matching algorithm options (optional)
      */
-    findMonochromaticDyes(hex, limit = 6) {
-        return this.harmony.findMonochromaticDyes(hex, limit);
+    findMonochromaticDyes(hex, limit = 6, options) {
+        return this.harmony.findMonochromaticDyes(hex, limit, options);
     }
     /**
      * Find compound harmony (analogous + complementary)
+     * @param hex Base hex color
+     * @param options Matching algorithm options (optional)
      */
-    findCompoundDyes(hex) {
-        return this.harmony.findCompoundDyes(hex);
+    findCompoundDyes(hex, options) {
+        return this.harmony.findCompoundDyes(hex, options);
     }
     /**
      * Find split-complementary harmony (±30° from the complementary hue)
+     * @param hex Base hex color
+     * @param options Matching algorithm options (optional)
      */
-    findSplitComplementaryDyes(hex) {
-        return this.harmony.findSplitComplementaryDyes(hex);
+    findSplitComplementaryDyes(hex, options) {
+        return this.harmony.findSplitComplementaryDyes(hex, options);
     }
     /**
      * Find shades (similar tones, ±15°)
+     * @param hex Base hex color
+     * @param options Matching algorithm options (optional)
      */
-    findShadesDyes(hex) {
-        return this.harmony.findShadesDyes(hex);
+    findShadesDyes(hex, options) {
+        return this.harmony.findShadesDyes(hex, options);
     }
     // ============================================================================
     // Localization Support (NEW)