@xivdyetools/core 2.3.0 → 2.5.0

package/dist/utils/index.d.ts

@@ -162,181 +162,6 @@ export declare class AsyncLRUCache<K, V> {
      */
     get pendingSize(): number;
 }
-/**
- * @internal
- * Clamp a number between min and max values
- *
- * @param value - The value to clamp
- * @param min - Minimum allowed value
- * @param max - Maximum allowed value
- * @returns Clamped value between min and max
- *
- * @example
- * ```typescript
- * clamp(150, 0, 100)  // Returns 100
- * clamp(-10, 0, 100)  // Returns 0
- * clamp(50, 0, 100)   // Returns 50
- * ```
- *
- * Edge cases:
- * - NaN values return NaN
- * - Infinity is clamped to max
- * - -Infinity is clamped to min
- */
-export declare function clamp(value: number, min: number, max: number): number;
-/**
- * @internal
- * Linear interpolation between two values
- *
- * @param a - Start value
- * @param b - End value
- * @param t - Interpolation factor (0 = a, 1 = b, 0.5 = midpoint)
- * @returns Interpolated value
- *
- * @example
- * ```typescript
- * lerp(0, 100, 0.5)   // Returns 50
- * lerp(0, 100, 0)     // Returns 0
- * lerp(0, 100, 1)     // Returns 100
- * lerp(10, 20, 0.25)  // Returns 12.5
- * ```
- *
- * Edge cases:
- * - t can be outside [0, 1] for extrapolation
- * - NaN values return NaN
- * - Handles Infinity correctly
- */
-export declare function lerp(a: number, b: number, t: number): number;
-/**
- * @internal
- * Round a number to a specific decimal place
- *
- * @param value - The number to round
- * @param decimals - Number of decimal places (default: 0)
- * @returns Rounded number
- *
- * @example
- * ```typescript
- * round(3.14159, 2)    // Returns 3.14
- * round(2.5)           // Returns 3 (rounds to nearest integer)
- * round(123.456, 1)    // Returns 123.5
- * round(-2.5)          // Returns -2
- * ```
- *
- * Edge cases:
- * - NaN returns NaN
- * - Infinity returns Infinity/-Infinity
- * - Negative decimals round to left of decimal point
- */
-export declare function round(value: number, decimals?: number): number;
-/**
- * @internal
- * Calculate Euclidean distance between two points in 2D space
- *
- * @param x1 - X coordinate of first point
- * @param y1 - Y coordinate of first point
- * @param x2 - X coordinate of second point
- * @param y2 - Y coordinate of second point
- * @returns Distance between the two points (always >= 0)
- *
- * @example
- * ```typescript
- * distance(0, 0, 3, 4)  // Returns 5 (Pythagorean theorem)
- * distance(0, 0, 0, 0)  // Returns 0 (same point)
- * distance(1, 1, 4, 5)  // Returns 5
- * ```
- *
- * Edge cases:
- * - NaN values return NaN
- * - Infinity values may return Infinity
- * - Always returns non-negative value
- */
-export declare function distance(x1: number, y1: number, x2: number, y2: number): number;
-/**
- * @internal
- * Get unique values from an array
- *
- * @param array - Input array (may contain duplicates)
- * @returns New array with only unique values (preserves first occurrence order)
- *
- * @example
- * ```typescript
- * unique([1, 2, 2, 3, 1])         // Returns [1, 2, 3]
- * unique(['a', 'b', 'a'])         // Returns ['a', 'b']
- * unique([])                      // Returns []
- * ```
- *
- * Edge cases:
- * - Empty array returns empty array
- * - Uses Set equality (NaN === NaN, +0 === -0)
- * - Preserves object/array references
- */
-export declare function unique<T>(array: T[]): T[];
-/**
- * @internal
- * Group array items by a key function
- *
- * @param array - Input array to group
- * @param keyFn - Function that extracts grouping key from each item
- * @returns Object with keys as groups and values as arrays of items
- *
- * @example
- * ```typescript
- * const items = [
- *   { type: 'fruit', name: 'apple' },
- *   { type: 'fruit', name: 'banana' },
- *   { type: 'vegetable', name: 'carrot' }
- * ];
- * groupBy(items, item => item.type)
- * // Returns { fruit: [...], vegetable: [...] }
- * ```
- *
- * Edge cases:
- * - Empty array returns empty object
- * - Handles undefined/null keys as string keys
- */
-export declare function groupBy<T, K extends string | number>(array: T[], keyFn: (item: T) => K): Record<K, T[]>;
-/**
- * @internal
- * Sort array by property value
- *
- * @param array - Input array to sort
- * @param property - Property key to sort by
- * @param order - Sort order ('asc' or 'desc', default: 'asc')
- * @returns New sorted array (does not mutate original)
- *
- * @example
- * ```typescript
- * const items = [{ age: 30 }, { age: 20 }, { age: 25 }];
- * sortByProperty(items, 'age')           // Sorted by age ascending
- * sortByProperty(items, 'age', 'desc')   // Sorted by age descending
- * ```
- *
- * Edge cases:
- * - Returns shallow copy of array
- * - Handles undefined properties (sorted to end)
- * - Stable sort (preserves relative order of equal elements)
- */
-export declare function sortByProperty<T>(array: T[], property: keyof T, order?: 'asc' | 'desc'): T[];
-/**
- * @internal
- * Filter array items, removing null and undefined values
- *
- * @param array - Input array with possibly null/undefined items
- * @returns New array with null and undefined values removed
- *
- * @example
- * ```typescript
- * filterNulls([1, null, 2, undefined, 3])  // Returns [1, 2, 3]
- * filterNulls([null, undefined])           // Returns []
- * filterNulls([0, false, ''])              // Returns [0, false, ''] (keeps falsy values)
- * ```
- *
- * Edge cases:
- * - Keeps falsy values (0, false, empty string)
- * - Type guard ensures return type doesn't include null|undefined
- */
-export declare function filterNulls<T>(array: (T | null | undefined)[]): T[];
 /**
  * Validate a hexadecimal color string
  *
@@ -360,106 +185,6 @@ export declare function filterNulls<T>(array: (T | null | undefined)[]): T[];
  * Security: Input length is validated before regex to prevent ReDoS
  */
 export declare function isValidHexColor(hex: string): boolean;
-/**
- * @internal
- * Validate RGB color values
- *
- * @param r - Red value
- * @param g - Green value
- * @param b - Blue value
- * @returns true if all values are valid (0-255, finite, not NaN), false otherwise
- *
- * @example
- * ```typescript
- * isValidRGB(255, 0, 0)       // Returns true
- * isValidRGB(0, 128, 255)     // Returns true
- * isValidRGB(256, 0, 0)       // Returns false (r > 255)
- * isValidRGB(-1, 0, 0)        // Returns false (r < 0)
- * isValidRGB(NaN, 0, 0)       // Returns false
- * isValidRGB(Infinity, 0, 0)  // Returns false
- * ```
- *
- * Valid range: 0-255 (inclusive) for all channels
- */
-export declare function isValidRGB(r: number, g: number, b: number): boolean;
-/**
- * @internal
- * Validate HSV color values
- *
- * @param h - Hue value (0-360)
- * @param s - Saturation value (0-100)
- * @param v - Value/brightness (0-100)
- * @returns true if all values are valid (finite, not NaN, within ranges), false otherwise
- *
- * @example
- * ```typescript
- * isValidHSV(180, 50, 100)    // Returns true
- * isValidHSV(0, 0, 0)         // Returns true
- * isValidHSV(360, 100, 100)   // Returns true (edge of range)
- * isValidHSV(361, 50, 50)     // Returns false (h > 360)
- * isValidHSV(180, -1, 50)     // Returns false (s < 0)
- * isValidHSV(NaN, 50, 50)     // Returns false
- * ```
- *
- * Valid ranges:
- * - Hue: 0-360 (degrees)
- * - Saturation: 0-100 (percent)
- * - Value: 0-100 (percent)
- */
-export declare function isValidHSV(h: number, s: number, v: number): boolean;
-/**
- * @internal
- * Type guard: Check if a value is a string
- *
- * @param value - Value to check
- * @returns true if value is a string, false otherwise
- *
- * @example
- * ```typescript
- * isString('hello')        // Returns true
- * isString('')             // Returns true (empty string)
- * isString(123)            // Returns false
- * isString(new String('')) // Returns false (String object, not primitive)
- * ```
- */
-export declare function isString(value: unknown): value is string;
-/**
- * @internal
- * Type guard: Check if a value is a finite number (excludes NaN and Infinity)
- *
- * @param value - Value to check
- * @returns true if value is a number and finite (not NaN, not Infinity), false otherwise
- *
- * @example
- * ```typescript
- * isNumber(42)              // Returns true
- * isNumber(0)               // Returns true
- * isNumber(-3.14)           // Returns true
- * isNumber(NaN)             // Returns false
- * isNumber(Infinity)        // Returns false
- * isNumber('123')           // Returns false (string)
- * isNumber(new Number(5))   // Returns false (Number object)
- * ```
- *
- * Note: This excludes NaN and Infinity for safer numeric operations
- */
-export declare function isNumber(value: unknown): value is number;
-/**
- * @internal
- * Type guard: Check if a value is an array
- *
- * @param value - Value to check
- * @returns true if value is an array, false otherwise
- *
- * @example
- * ```typescript
- * isArray([1, 2, 3])       // Returns true
- * isArray([])              // Returns true
- * isArray('not array')     // Returns false
- * isArray({ length: 0 })   // Returns false (array-like object)
- * ```
- */
-export declare function isArray<T = unknown>(value: unknown): value is T[];
 /**
  * Type guard: Check if a value is a plain object (not array, not null)
  *
@@ -516,25 +241,6 @@ export declare function isNullish(value: unknown): value is null | undefined;
  * Note: Negative values are clamped to 0 (immediate resolution)
  */
 export declare function sleep(ms: number): Promise<void>;
-/**
- * @internal
- * Check if an error is an AbortError (from AbortController timeout)
- *
- * @param error - Error to check
- * @returns true if error is an AbortError, false otherwise
- *
- * @example
- * ```typescript
- * try {
- *   await fetch(url, { signal: controller.signal });
- * } catch (error) {
- *   if (isAbortError(error)) {
- *     console.log('Request timed out or was aborted');
- *   }
- * }
- * ```
- */
-export declare function isAbortError(error: unknown): boolean;
 /**
  * Retry a function multiple times with exponential backoff
  *

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAM1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAa;IAKlC;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAKjB;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAO1B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAa3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,aAAa,CAAC,CAAC,EAAE,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAa;IAMlC;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAKjB;;;;;;;;;;;;;;;;;;OAkBG;IACG,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA+BjE;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAO1B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAa3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;CACF;AA6PD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAUpD;AA6ID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,SAAS,CAEnE;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/C;AA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,GAAE,MAAU,EACvB,OAAO,GAAE,MAAa,EACtB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAStD"}

package/dist/version.d.ts

@@ -7,5 +7,5 @@
  * Current library version
  * Automatically synced with package.json version
  */
-export declare const VERSION = "2.3.0";
+export declare const VERSION = "2.5.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -7,5 +7,5 @@
  * Current library version
  * Automatically synced with package.json version
  */
-export const VERSION = '2.3.0';
+export const VERSION = '2.5.0';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xivdyetools/core",
-  "version": "2.3.0",
+  "version": "2.5.0",
   "description": "Core color algorithms and dye database for XIV Dye Tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -36,16 +36,16 @@
   "dependencies": {
     "spectral.js": "^3.0.0",
     "@xivdyetools/logger": "1.2.2",
-    "@xivdyetools/types": "1.11.0"
+    "@xivdyetools/types": "1.13.0"
   },
   "devDependencies": {
-    "@types/node": "^25.5.0",
-    "@vitest/coverage-v8": "^4.1.2",
+    "@types/node": "^25.6.0",
+    "@vitest/coverage-v8": "^4.1.5",
     "csv-parse": "^6.2.1",
     "tsx": "^4.7.0",
-    "typedoc": "^0.28.18",
+    "typedoc": "^0.28.19",
     "typedoc-plugin-markdown": "^4.11.0",
-    "vitest": "^4.1.2",
+    "vitest": "^4.1.5",
     "yaml": "^2.8.3"
   },
   "engines": {