@xivdyetools/core 2.3.0 → 2.5.0

package/LICENSE

@@ -22,16 +22,7 @@ SOFTWARE.
 
 ---
 
-FINAL FANTASY XIV © SQUARE ENIX CO., LTD. All Rights Reserved.
-
-This project is a fan-made tool and is not affiliated with, endorsed by, or
-sponsored by Square Enix Co., Ltd. FINAL FANTASY is a registered trademark
-of Square Enix Holdings Co., Ltd.
-
-Game data, including dye names, colors, and acquisition methods, are property
-of Square Enix Co., Ltd. and are used under fair use for educational and
-informational purposes only.
-
-Market board data is provided by Universalis (https://universalis.app/),
-an independent third-party service not affiliated with Square Enix.
+FINAL FANTASY XIV © 2010-2026 SQUARE ENIX CO., LTD. All Rights Reserved.
+XIV Dye Tools is a fan-made application and is not affiliated with or endorsed by Square Enix.
+Market board data is provided by Universalis (https://universalis.app/).
 

package/dist/config/consolidated-ids.d.ts

@@ -1,10 +1,38 @@
 /**
- * Consolidated dye item IDs for Patch 7.5.
+ * Consolidated dye configuration for Patch 7.5 (TRAIL TO THE HEAVENS, 2026-04-28).
  *
- * PATCH DAY (2026-04-28): Replace null values with real item IDs from datamining.
- * This is the ONLY file that needs updating on patch day.
+ * itemIDs (52254 / 52255 / 52256) and all six localized names are populated.
+ * The `ko: string | null` / `zh: string | null` types are kept as a safety hatch
+ * for future consolidation patches that may ship before localized names are sourced.
  */
-export declare const CONSOLIDATED_IDS: Record<'A' | 'B' | 'C', number | null>;
+import type { LocaleCode } from '@xivdyetools/types';
+export type ConsolidationType = 'A' | 'B' | 'C';
+/**
+ * Localized name for a consolidated dye.
+ * `ko` and `zh` are typed as nullable so future unsourced patches can ship with
+ * `null` placeholders; `getConsolidatedDyeName` falls back to English in that case.
+ */
+export interface LocalizedDyeName {
+    en: string;
+    ja: string;
+    de: string;
+    fr: string;
+    ko: string | null;
+    zh: string | null;
+}
+export interface ConsolidatedDye {
+    itemID: number | null;
+    names: LocalizedDyeName;
+    acquisition: string;
+    price: number;
+    currency: string;
+}
+export declare const CONSOLIDATED_IDS: Record<ConsolidationType, number | null>;
+/**
+ * Full metadata for the three consolidated dye items shipped in Patch 7.5.
+ * `itemID` mirrors `CONSOLIDATED_IDS` and is filled on patch day.
+ */
+export declare const CONSOLIDATED_DYES: Record<ConsolidationType, ConsolidatedDye>;
 /**
  * Whether dye consolidation is active (all IDs are known).
  * Returns true only when all three consolidated IDs have been set.
@@ -19,6 +47,12 @@ export declare function isConsolidationActive(): boolean;
  */
 export declare function getMarketItemID(dye: {
     itemID: number;
-    consolidationType: 'A' | 'B' | 'C' | null;
+    consolidationType: ConsolidationType | null;
 }): number;
+/**
+ * Get the localized display name for a consolidated dye.
+ * Falls back to English when the requested locale's translation is `null`
+ * (a safety hatch for any future unsourced ko/zh strings; not exercised today).
+ */
+export declare function getConsolidatedDyeName(type: ConsolidationType, locale: LocaleCode): string;
 //# sourceMappingURL=consolidated-ids.d.ts.map

package/dist/config/consolidated-ids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consolidated-ids.d.ts","sourceRoot":"","sources":["../../src/config/consolidated-ids.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,MAAM,GAAG,IAAI,CAInE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAM/C;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;CAC3C,GAAG,MAAM,CAKT"}
+{"version":3,"file":"consolidated-ids.d.ts","sourceRoot":"","sources":["../../src/config/consolidated-ids.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,gBAAgB,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAIrE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,eAAe,CA2CxE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAM/C;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC7C,GAAG,MAAM,CAKT;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAG1F"}

package/dist/config/consolidated-ids.js

@@ -1,13 +1,62 @@
 /**
- * Consolidated dye item IDs for Patch 7.5.
+ * Consolidated dye configuration for Patch 7.5 (TRAIL TO THE HEAVENS, 2026-04-28).
  *
- * PATCH DAY (2026-04-28): Replace null values with real item IDs from datamining.
- * This is the ONLY file that needs updating on patch day.
+ * itemIDs (52254 / 52255 / 52256) and all six localized names are populated.
+ * The `ko: string | null` / `zh: string | null` types are kept as a safety hatch
+ * for future consolidation patches that may ship before localized names are sourced.
  */
 export const CONSOLIDATED_IDS = {
-    A: null, // ARR dyes (85 dyes, itemIDs 5729-5813)
-    B: null, // Ishgardian Restoration dyes (9 dyes, itemIDs 30116-30124)
-    C: null, // Cosmic Exploration dyes (11 dyes, itemIDs 48163-48172, 48227)
+    A: 52254, // Standard Spectrum Dye — covers the 85 ARR dyes (itemIDs 5729-5813)
+    B: 52255, // Wide Spectrum #1 Dye — covers the 9 Ishgardian Restoration dyes (itemIDs 30116-30124)
+    C: 52256, // Wide Spectrum #2 Dye — covers the 11 Cosmic Exploration dyes (itemIDs 48163-48172, 48227)
+};
+/**
+ * Full metadata for the three consolidated dye items shipped in Patch 7.5.
+ * `itemID` mirrors `CONSOLIDATED_IDS` and is filled on patch day.
+ */
+export const CONSOLIDATED_DYES = {
+    A: {
+        itemID: CONSOLIDATED_IDS.A,
+        names: {
+            en: 'Standard Spectrum Dye',
+            ja: 'カララント:ノーマルカラー',
+            de: 'Einfacher Farbstoff',
+            fr: 'Teinture standard',
+            ko: '염료: 기본 색상',
+            zh: '通用染剂',
+        },
+        acquisition: 'Dye Vendor',
+        price: 216,
+        currency: 'Gil',
+    },
+    B: {
+        itemID: CONSOLIDATED_IDS.B,
+        names: {
+            en: 'Wide Spectrum #1 Dye',
+            ja: 'カララント:アディショナルカラー1',
+            de: 'Zusatzfarbstoff 1',
+            fr: 'Teinture additionnelle n°1',
+            ko: '염료: 추가 색상 1',
+            zh: '追加染剂1',
+        },
+        acquisition: 'The Firmament',
+        price: 1000,
+        currency: "Sky Builders' Scrips",
+    },
+    C: {
+        itemID: CONSOLIDATED_IDS.C,
+        names: {
+            en: 'Wide Spectrum #2 Dye',
+            ja: 'カララント:アディショナルカラー2',
+            de: 'Zusatzfarbstoff 2',
+            fr: 'Teinture additionnelle n°2',
+            ko: '염료: 추가 색상 2',
+            zh: '追加染剂2',
+        },
+        acquisition: 'Cosmic Exploration',
+        price: 600,
+        currency: 'Cosmocredits',
+    },
 };
 /**
  * Whether dye consolidation is active (all IDs are known).
@@ -34,4 +83,13 @@ export function getMarketItemID(dye) {
         return dye.itemID; // Pre-patch fallback
     return CONSOLIDATED_IDS[dye.consolidationType];
 }
+/**
+ * Get the localized display name for a consolidated dye.
+ * Falls back to English when the requested locale's translation is `null`
+ * (a safety hatch for any future unsourced ko/zh strings; not exercised today).
+ */
+export function getConsolidatedDyeName(type, locale) {
+    const names = CONSOLIDATED_DYES[type].names;
+    return names[locale] ?? names.en;
+}
 //# sourceMappingURL=consolidated-ids.js.map

package/dist/config/consolidated-ids.js.map

@@ -1 +1 @@
-{"version":3,"file":"consolidated-ids.js","sourceRoot":"","sources":["../../src/config/consolidated-ids.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2C;IACtE,CAAC,EAAE,IAAI,EAAE,wCAAwC;IACjD,CAAC,EAAE,IAAI,EAAE,4DAA4D;IACrE,CAAC,EAAE,IAAI,EAAE,gEAAgE;CAC1E,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,CACL,gBAAgB,CAAC,CAAC,KAAK,IAAI;QAC3B,gBAAgB,CAAC,CAAC,KAAK,IAAI;QAC3B,gBAAgB,CAAC,CAAC,KAAK,IAAI,CAC5B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,GAG/B;IACC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,WAAW;IAClD,IAAI,CAAC,GAAG,CAAC,iBAAiB;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,wBAAwB;IACvE,IAAI,CAAC,qBAAqB,EAAE;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,qBAAqB;IACtE,OAAO,gBAAgB,CAAC,GAAG,CAAC,iBAAiB,CAAE,CAAC;AAClD,CAAC"}
+{"version":3,"file":"consolidated-ids.js","sourceRoot":"","sources":["../../src/config/consolidated-ids.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4BH,MAAM,CAAC,MAAM,gBAAgB,GAA6C;IACxE,CAAC,EAAE,KAAK,EAAE,qEAAqE;IAC/E,CAAC,EAAE,KAAK,EAAE,wFAAwF;IAClG,CAAC,EAAE,KAAK,EAAE,4FAA4F;CACvG,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA+C;IAC3E,CAAC,EAAE;QACD,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAC1B,KAAK,EAAE;YACL,EAAE,EAAE,uBAAuB;YAC3B,EAAE,EAAE,eAAe;YACnB,EAAE,EAAE,qBAAqB;YACzB,EAAE,EAAE,mBAAmB;YACvB,EAAE,EAAE,WAAW;YACf,EAAE,EAAE,MAAM;SACX;QACD,WAAW,EAAE,YAAY;QACzB,KAAK,EAAE,GAAG;QACV,QAAQ,EAAE,KAAK;KAChB;IACD,CAAC,EAAE;QACD,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAC1B,KAAK,EAAE;YACL,EAAE,EAAE,sBAAsB;YAC1B,EAAE,EAAE,mBAAmB;YACvB,EAAE,EAAE,mBAAmB;YACvB,EAAE,EAAE,4BAA4B;YAChC,EAAE,EAAE,aAAa;YACjB,EAAE,EAAE,OAAO;SACZ;QACD,WAAW,EAAE,eAAe;QAC5B,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,sBAAsB;KACjC;IACD,CAAC,EAAE;QACD,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAC1B,KAAK,EAAE;YACL,EAAE,EAAE,sBAAsB;YAC1B,EAAE,EAAE,mBAAmB;YACvB,EAAE,EAAE,mBAAmB;YACvB,EAAE,EAAE,4BAA4B;YAChC,EAAE,EAAE,aAAa;YACjB,EAAE,EAAE,OAAO;SACZ;QACD,WAAW,EAAE,oBAAoB;QACjC,KAAK,EAAE,GAAG;QACV,QAAQ,EAAE,cAAc;KACzB;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,CACL,gBAAgB,CAAC,CAAC,KAAK,IAAI;QAC3B,gBAAgB,CAAC,CAAC,KAAK,IAAI;QAC3B,gBAAgB,CAAC,CAAC,KAAK,IAAI,CAC5B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,GAG/B;IACC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,WAAW;IAClD,IAAI,CAAC,GAAG,CAAC,iBAAiB;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,wBAAwB;IACvE,IAAI,CAAC,qBAAqB,EAAE;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,qBAAqB;IACtE,OAAO,gBAAgB,CAAC,GAAG,CAAC,iBAAiB,CAAE,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAuB,EAAE,MAAkB;IAChF,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;IAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;AACnC,CAAC"}

package/dist/constants/index.d.ts

@@ -5,7 +5,7 @@
  *
  * @module constants
  */
-import type { VisionType, ColorblindMatrices } from '@xivdyetools/types';
+import type { ColorblindMatrices } from '@xivdyetools/types';
 /**
  * RGB value constraints
  */
@@ -20,15 +20,6 @@ export declare const SATURATION_MIN = 0;
 export declare const SATURATION_MAX = 100;
 export declare const VALUE_MIN = 0;
 export declare const VALUE_MAX = 100;
-/**
- * @internal
- * Color distance calculation mode
- */
-export declare const COLOR_DISTANCE_MAX: number;
-/** @internal */
-export declare const VISION_TYPES: readonly VisionType[];
-/** @internal */
-export declare const VISION_TYPE_LABELS: Record<VisionType, string>;
 /**
  * Brettel 1997 transformation matrices for colorblindness simulation
  * These matrices transform RGB values to simulate different types of colorblindness
@@ -52,8 +43,6 @@ export declare const UNIVERSALIS_API_RETRY_DELAY = 1000;
  * API caching and rate limiting
  */
 export declare const API_CACHE_TTL: number;
-/** @internal */
-export declare const API_DEBOUNCE_DELAY = 500;
 export declare const API_CACHE_VERSION = "1.0.0";
 export declare const API_MAX_RESPONSE_SIZE: number;
 export declare const API_RATE_LIMIT_DELAY = 200;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAMzE;;GAEG;AACH,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,OAAO,MAAM,CAAC;AAE3B;;GAEG;AACH,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,OAAO,MAAM,CAAC;AAC3B,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAA4C,CAAC;AAM5E,gBAAgB;AAChB,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAMpC,CAAC;AAEX,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAMzD,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAqB9B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,QAAQ;;;CAGX,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,oBAAoB,mCAAmC,CAAC;AACrE,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,aAAa,QAAgB,CAAC;AAC3C,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,qBAAqB,QAAc,CAAC;AACjD,eAAO,MAAM,oBAAoB,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAc,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAMzE;;GAEG;AACH,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,OAAO,MAAM,CAAC;AAE3B;;GAEG;AACH,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,OAAO,MAAM,CAAC;AAC3B,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,SAAS,MAAM,CAAC;AAkC7B;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAqB9B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,QAAQ;;;CAGX,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,oBAAoB,mCAAmC,CAAC;AACrE,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,aAAa,QAAgB,CAAC;AAG3C,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,qBAAqB,QAAc,CAAC;AACjD,eAAO,MAAM,oBAAoB,MAAM,CAAC"}