@xivdyetools/core 2.7.0 → 4.0.1

package/dist/config/learn-links.js

@@ -0,0 +1,171 @@
+/**
+ * /manual topic roster + learn-more link table — shared data for every
+ * surface (web MetricHelp rows, bot /manual embeds, og-worker redirect page).
+ *
+ * Per the confirmed 5.0 rules (design register, cross-cutting):
+ * - Authority order when sourcing: clinical body → medical portal →
+ *   encyclopaedia. Read the target, not its name.
+ * - **A missing URL degrades to no link, never the English one.**
+ * - Embeds print authority + host, never the path; web `<a>`s still name the
+ *   authority.
+ * - The lead sentence and its tail are authored together per locale (JA
+ *   `をご覧ください`; KO takes no tail — position-dependent). Those live in
+ *   the locale string tables, not here.
+ * - Every URL here passed a liveness check on 2026-08-07. Two of five had
+ *   already moved once before that — keep the liveness test in CI-reachable
+ *   form and treat a dead link as an absent link at render time.
+ *
+ * Roster decisions:
+ * - Colour Vision: EN = NEI (clinical body) · DE = Portal der Augenmedizin
+ *   (medical portal) · FR = Wikipédia *Daltonisme* (encyclopaedia; no
+ *   endorsed FR clinical page) · JA = 日本眼科医会 (the JA copy names
+ *   achromatopsia as separate, not a fourth 色覚異常) · KO = KDCA 국가건강정보포털.
+ *   **ZH is deliberately absent** — blocked on a Simplified-Chinese reader.
+ * - Contrast: cite WCAG 1.4.11 in all six locales, but **link only en/fr/zh**
+ *   (the W3C-authorized translations). DE's endorsed 2.0 translation lacks the
+ *   criterion; KO's translation is unofficial http; JA's waic.jp needs its own
+ *   check before it can join.
+ * - Matching Methods: our own docs — no localised authority exists.
+ * - Spectrum & Prices: Lodestone **by game region, not locale**.
+ * - Image Matching Tips and Character File link nothing.
+ */
+const W3C = 'W3C';
+/** Our own documentation site (Matching Methods target, all locales). */
+export const XIVDYETOOLS_DOCS_URL = 'https://developers.xivdyetools.app/';
+/** Lodestone by region — Spectrum & Prices resolves region from the user's world. */
+export const LODESTONE_BY_REGION = {
+    na: {
+        authority: 'The Lodestone',
+        host: 'na.finalfantasyxiv.com',
+        url: 'https://na.finalfantasyxiv.com/lodestone/',
+    },
+    eu: {
+        authority: 'The Lodestone',
+        host: 'eu.finalfantasyxiv.com',
+        url: 'https://eu.finalfantasyxiv.com/lodestone/',
+    },
+    jp: {
+        authority: 'The Lodestone',
+        host: 'jp.finalfantasyxiv.com',
+        url: 'https://jp.finalfantasyxiv.com/lodestone/',
+    },
+    de: {
+        authority: 'The Lodestone',
+        host: 'de.finalfantasyxiv.com',
+        url: 'https://de.finalfantasyxiv.com/lodestone/',
+    },
+    fr: {
+        authority: 'The Lodestone',
+        host: 'fr.finalfantasyxiv.com',
+        url: 'https://fr.finalfantasyxiv.com/lodestone/',
+    },
+};
+const MATCHING_METHODS_LINK = {
+    authority: 'XIV Dye Tools Docs',
+    host: 'developers.xivdyetools.app',
+    url: XIVDYETOOLS_DOCS_URL,
+};
+/**
+ * The /manual topic roster. `match_image` ships today; the other five need
+ * handler + choice registration in the bot (they are part of the 5.0 port).
+ */
+export const MANUAL_TOPICS = [
+    {
+        id: 'match_image',
+        emoji: '📸',
+        links: {},
+    },
+    {
+        id: 'color_vision',
+        emoji: '♿',
+        links: {
+            en: {
+                authority: 'National Eye Institute',
+                host: 'www.nei.nih.gov',
+                url: 'https://www.nei.nih.gov/learn-about-eye-health/eye-conditions-and-diseases/color-blindness',
+            },
+            de: {
+                authority: 'Portal der Augenmedizin',
+                host: 'www.portal-der-augenmedizin.de',
+                url: 'https://www.portal-der-augenmedizin.de/aktuelles/20110405-farbenblindheit-im-alltag.html',
+            },
+            fr: {
+                authority: 'Wikipédia — Daltonisme',
+                host: 'fr.wikipedia.org',
+                url: 'https://fr.wikipedia.org/wiki/Daltonisme',
+            },
+            ja: {
+                authority: '日本眼科医会',
+                host: 'www.gankaikai.or.jp',
+                url: 'https://www.gankaikai.or.jp/health/50/',
+            },
+            ko: {
+                authority: '질병관리청 국가건강정보포털',
+                host: 'health.kdca.go.kr',
+                url: 'https://health.kdca.go.kr/healthinfo/biz/health/gnrlzHealthInfo/gnrlzHealthInfo/gnrlzHealthInfoView.do?cntnts_sn=1469',
+            },
+            // zh: deliberately absent — needs a Simplified-Chinese source found via
+            // a community reader. Absent = no link, never the English one.
+        },
+    },
+    {
+        id: 'contrast',
+        emoji: '🔲',
+        links: {
+            en: {
+                authority: `${W3C} — WCAG 2.1 (1.4.11)`,
+                host: 'www.w3.org',
+                url: 'https://www.w3.org/TR/WCAG21/#non-text-contrast',
+            },
+            fr: {
+                authority: `${W3C} — WCAG 2.1, traduction autorisée (1.4.11)`,
+                host: 'www.w3.org',
+                url: 'https://www.w3.org/Translations/WCAG21-fr/',
+            },
+            zh: {
+                authority: `${W3C} — WCAG 2.1 授权翻译 (1.4.11)`,
+                host: 'www.w3.org',
+                url: 'https://www.w3.org/Translations/WCAG21-zh/',
+            },
+            // de: endorsed WCAG 2.0 translation lacks 1.4.11 (a 2.1 criterion).
+            // ko: only an unofficial http translation exists.
+            // ja: waic.jp candidate not yet verified.
+            // All three cite 1.4.11 in copy but render the absent-link state.
+        },
+    },
+    {
+        id: 'matching_methods',
+        emoji: '📐',
+        links: {
+            en: MATCHING_METHODS_LINK,
+            de: MATCHING_METHODS_LINK,
+            fr: MATCHING_METHODS_LINK,
+            ja: MATCHING_METHODS_LINK,
+            ko: MATCHING_METHODS_LINK,
+            zh: MATCHING_METHODS_LINK,
+        },
+    },
+    {
+        id: 'spectrum_prices',
+        emoji: '🪙',
+        links: {}, // region-keyed — resolve via LODESTONE_BY_REGION, not locale
+    },
+    {
+        id: 'character_file',
+        emoji: '👤',
+        links: {}, // links nothing by decision
+    },
+];
+/**
+ * Learn-more link for a topic + locale. Returns null for the absent state —
+ * consumers render "no link", never the English URL.
+ */
+export function getLearnLink(topic, locale) {
+    const entry = MANUAL_TOPICS.find((t) => t.id === topic);
+    return entry?.links[locale] ?? null;
+}
+/** Lodestone link for a game region (Spectrum & Prices topic). */
+export function getLodestoneLink(region) {
+    return LODESTONE_BY_REGION[region];
+}
+//# sourceMappingURL=learn-links.js.map

package/dist/config/learn-links.js.map

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

package/dist/config/product-links.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Where the product can be found — one home, because both surfaces print it.
+ *
+ * The web app's About modal and the bot's `/about` show the same seven
+ * places. Kept here rather than in each surface for the reason the 5.0
+ * design register keeps giving: a list duplicated across two apps is a list
+ * that drifts, and the drift is invisible until somebody notices the bot is
+ * advertising a repo that moved two releases ago.
+ *
+ * Only `label` and `url` live here. Icons are presentation and stay with the
+ * surface that draws them — the web app maps these onto its SVG set, the bot
+ * renders markdown links.
+ *
+ * @module config/product-links
+ */
+export interface ProductLink {
+    /** Display name. Proper nouns — never localised. */
+    label: string;
+    url: string;
+}
+/**
+ * Social presence, in the order both surfaces display it.
+ *
+ * `github.com/FlashGalatine` is the profile rather than a repository: the
+ * project has moved repos once already (the standalone discord-worker into
+ * the monorepo), and a profile link survives the next move too.
+ */
+export declare const SOCIAL_LINKS: readonly ProductLink[];
+/**
+ * The product itself. The web app does not print these (a modal linking to
+ * the page it is drawn on says nothing); the bot does, because a Discord
+ * reader has no other way in.
+ */
+export declare const PRODUCT_LINKS: {
+    readonly webApp: {
+        readonly label: "Web App";
+        readonly url: "https://xivdyetools.app/";
+    };
+    readonly inviteBot: {
+        readonly label: "Invite Bot";
+        readonly url: "https://discord.com/oauth2/authorize?client_id=1447108133020369048";
+    };
+};
+//# sourceMappingURL=product-links.d.ts.map

package/dist/config/product-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-links.d.ts","sourceRoot":"","sources":["../../src/config/product-links.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,WAAW,EAQrC,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;CAMsB,CAAC"}

package/dist/config/product-links.js

@@ -0,0 +1,44 @@
+/**
+ * Where the product can be found — one home, because both surfaces print it.
+ *
+ * The web app's About modal and the bot's `/about` show the same seven
+ * places. Kept here rather than in each surface for the reason the 5.0
+ * design register keeps giving: a list duplicated across two apps is a list
+ * that drifts, and the drift is invisible until somebody notices the bot is
+ * advertising a repo that moved two releases ago.
+ *
+ * Only `label` and `url` live here. Icons are presentation and stay with the
+ * surface that draws them — the web app maps these onto its SVG set, the bot
+ * renders markdown links.
+ *
+ * @module config/product-links
+ */
+/**
+ * Social presence, in the order both surfaces display it.
+ *
+ * `github.com/FlashGalatine` is the profile rather than a repository: the
+ * project has moved repos once already (the standalone discord-worker into
+ * the monorepo), and a profile link survives the next move too.
+ */
+export const SOCIAL_LINKS = [
+    { label: 'GitHub', url: 'https://github.com/FlashGalatine' },
+    { label: 'X/Twitter', url: 'https://x.com/AsheJunius' },
+    { label: 'Twitch', url: 'https://www.twitch.tv/flashgalatine' },
+    { label: 'Bluesky', url: 'https://bsky.app/profile/projectgalatine.com' },
+    { label: 'Discord', url: 'https://discord.gg/5VUSKTZCe5' },
+    { label: 'Patreon', url: 'https://patreon.com/ProjectGalatine' },
+    { label: 'Ko-fi', url: 'https://ko-fi.com/flashgalatine' },
+];
+/**
+ * The product itself. The web app does not print these (a modal linking to
+ * the page it is drawn on says nothing); the bot does, because a Discord
+ * reader has no other way in.
+ */
+export const PRODUCT_LINKS = {
+    webApp: { label: 'Web App', url: 'https://xivdyetools.app/' },
+    inviteBot: {
+        label: 'Invite Bot',
+        url: 'https://discord.com/oauth2/authorize?client_id=1447108133020369048',
+    },
+};
+//# sourceMappingURL=product-links.js.map

package/dist/config/product-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-links.js","sourceRoot":"","sources":["../../src/config/product-links.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,kCAAkC,EAAE;IAC5D,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,0BAA0B,EAAE;IACvD,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,qCAAqC,EAAE;IAC/D,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,8CAA8C,EAAE;IACzE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,+BAA+B,EAAE;IAC1D,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,qCAAqC,EAAE;IAChE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,iCAAiC,EAAE;CAClD,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,0BAA0B,EAAE;IAC7D,SAAS,EAAE;QACT,KAAK,EAAE,YAAY;QACnB,GAAG,EAAE,oEAAoE;KAC1E;CAC6C,CAAC"}

package/dist/constants/index.d.ts

@@ -25,12 +25,25 @@ export declare const VALUE_MAX = 100;
  * These matrices transform RGB values to simulate different types of colorblindness
  */
 export declare const BRETTEL_MATRICES: ColorblindMatrices;
+/**
+ * Machado, Oliveira & Fernandes (2009) transformation matrices at severity 1.0.
+ *
+ * Unlike {@link BRETTEL_MATRICES} (applied to gamma-encoded sRGB by the legacy
+ * simulator), these matrices are defined over **linear RGB** — use them only
+ * through `ColorblindnessSimulator.simulateColorblindnessMachado`, which
+ * linearizes, transforms, and re-encodes.
+ *
+ * The 5.0 band calibration (SEPARATION cuts) was computed against this set, so
+ * any recomputation of those bands must use the Machado path, not Brettel.
+ * Achromatopsia is not part of the Machado dichromacy model; it is represented
+ * here as Rec. 709 luminance grayscale in linear light.
+ */
+export declare const MACHADO_MATRICES: ColorblindMatrices;
 /**
  * Regex patterns for validation
  */
 export declare const PATTERNS: {
     readonly HEX_COLOR: RegExp;
-    readonly RGB_COLOR: RegExp;
 };
 /**
  * Universalis API configuration

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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAM7D;;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;AAY7B;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAqB9B,CAAC;AAMF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAqB9B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,QAAQ;;CAEX,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,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,qBAAqB,QAAc,CAAC;AACjD,eAAO,MAAM,oBAAoB,MAAM,CAAC"}

package/dist/constants/index.js

@@ -28,25 +28,6 @@ export const VALUE_MAX = 100;
  */
 export const COLOR_DISTANCE_MAX = Math.sqrt(255 ** 2 + 255 ** 2 + 255 ** 2); // ~441.67
 // ============================================================================
-// Vision Type Configuration
-// ============================================================================
-/** @internal */
-export const VISION_TYPES = [
-    'normal',
-    'deuteranopia',
-    'protanopia',
-    'tritanopia',
-    'achromatopsia',
-];
-/** @internal */
-export const VISION_TYPE_LABELS = {
-    normal: 'Normal Vision',
-    deuteranopia: 'Deuteranopia (Red-Green Colorblindness)',
-    protanopia: 'Protanopia (Red-Green Colorblindness)',
-    tritanopia: 'Tritanopia (Blue-Yellow Colorblindness)',
-    achromatopsia: 'Achromatopsia (Total Colorblindness)',
-};
-// ============================================================================
 // Colorblindness Transformation Matrices (Brettel 1997)
 // ============================================================================
 /**
@@ -76,6 +57,44 @@ export const BRETTEL_MATRICES = {
     ],
 };
 // ============================================================================
+// Colorblindness Transformation Matrices (Machado et al. 2009, severity 1.0)
+// ============================================================================
+/**
+ * Machado, Oliveira & Fernandes (2009) transformation matrices at severity 1.0.
+ *
+ * Unlike {@link BRETTEL_MATRICES} (applied to gamma-encoded sRGB by the legacy
+ * simulator), these matrices are defined over **linear RGB** — use them only
+ * through `ColorblindnessSimulator.simulateColorblindnessMachado`, which
+ * linearizes, transforms, and re-encodes.
+ *
+ * The 5.0 band calibration (SEPARATION cuts) was computed against this set, so
+ * any recomputation of those bands must use the Machado path, not Brettel.
+ * Achromatopsia is not part of the Machado dichromacy model; it is represented
+ * here as Rec. 709 luminance grayscale in linear light.
+ */
+export const MACHADO_MATRICES = {
+    protanopia: [
+        [0.152286, 1.052583, -0.204868],
+        [0.114503, 0.786281, 0.099216],
+        [-0.003882, -0.048116, 1.051998],
+    ],
+    deuteranopia: [
+        [0.367322, 0.860646, -0.227968],
+        [0.280085, 0.672501, 0.047413],
+        [-0.01182, 0.04294, 0.968881],
+    ],
+    tritanopia: [
+        [1.255528, -0.076749, -0.178779],
+        [-0.078411, 0.930809, 0.147602],
+        [0.004733, 0.691367, 0.3039],
+    ],
+    achromatopsia: [
+        [0.2126, 0.7152, 0.0722],
+        [0.2126, 0.7152, 0.0722],
+        [0.2126, 0.7152, 0.0722],
+    ],
+};
+// ============================================================================
 // Regular Expressions
 // ============================================================================
 /**
@@ -83,7 +102,6 @@ export const BRETTEL_MATRICES = {
  */
 export const PATTERNS = {
     HEX_COLOR: /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/,
-    RGB_COLOR: /^rgb\(\d+,\s*\d+,\s*\d+\)$/,
 };
 // ============================================================================
 // API Configuration (Universalis)
@@ -99,8 +117,6 @@ export const UNIVERSALIS_API_RETRY_DELAY = 1000; // milliseconds
  * API caching and rate limiting
  */
 export const API_CACHE_TTL = 5 * 60 * 1000; // 5 minutes
-/** @internal */
-export const API_DEBOUNCE_DELAY = 500; // milliseconds
 export const API_CACHE_VERSION = '1.0.0'; // Increment to invalidate all cached data
 export const API_MAX_RESPONSE_SIZE = 1024 * 1024; // 1 MB maximum response size
 export const API_RATE_LIMIT_DELAY = 200; // milliseconds between requests

package/dist/constants/index.js.map

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

package/dist/data/character_colors/race_specific/hair_colors.json

@@ -41543,7 +41543,7 @@
             }
         ]
     },
-    "Helion": {
+    "Helions": {
         "Male": [
             {
                 "index": 0,

package/dist/data/character_colors/race_specific/skin_colors.json

@@ -41543,7 +41543,7 @@
             }
         ]
     },
-    "Helion": {
+    "Helions": {
         "Male": [
             {
                 "index": 0,