@xivdyetools/core 2.6.0 → 4.0.1

package/dist/config/band-vocabulary.d.ts

@@ -0,0 +1,82 @@
+/**
+ * The 5.0 band vocabulary — calibrated per-method tier boundaries.
+ *
+ * Confirmed 2026-08-07 (`Band Calibration.dc.html`): the non-default methods
+ * take empirical accuracy-optimal cuts against ΔE2000's settled tiers,
+ * rounded to display precision and scored on rounded values. The numbers here
+ * are generated by `scripts/calibrate-bands.ts` (algorithm in
+ * `band-calibration.ts`) and guarded by a parity test — do not hand-edit;
+ * re-run the script if `dyes.json` changes.
+ *
+ * Three standing rules, whatever the method:
+ * 1. Print the method wherever a tier or verdict appears.
+ * 2. Never compare a tier across methods.
+ * 3. Only ΔE2000's bands follow the user's match line — every other method's
+ *    bands are fixed, and copy must say so (use
+ *    {@link classifyBandTierWithCuts} for the ΔE2000-with-user-slider case).
+ *
+ * Notes carried from the study:
+ * - ΔEOK prints raw (dp 3); a ×100 display unit converts exactly (same cuts).
+ * - DISTINGUISH % derives exactly from RGB DIST (identical ranks); its bands
+ *   are computed from RGB DIST's cuts, never calibrated separately. Integer
+ *   rounding creates ties — orderings need a sort fallback and ties badge TIE.
+ * - RATIO is not a distance (lightness only) and never joins the tier
+ *   vocabulary; its calibrated cuts exist only for Accessibility + Comparison,
+ *   with the Accessibility top band anchored at 3:1 (WCAG 1.4.11). A first
+ *   band of 1.00 is literal: that tier is unreachable through lightness alone.
+ */
+/** Contexts a band set applies to (per-tool subsets of one vocabulary). */
+export type BandContext = 'match' | 'harmony' | 'separation';
+/** Distance-like methods carrying tier bands. */
+export type BandMethod = 'ciede2000' | 'oklab' | 'cie76' | 'redmean' | 'rgb' | 'distinguish';
+/** Tier index: 0 = best band (below first cut) … 3 = beyond the last cut. */
+export type BandTier = 0 | 1 | 2 | 3;
+export interface MethodBandSet {
+    /** Ascending tier boundaries at display precision */
+    cuts: readonly [number, number, number];
+    /** Display precision (decimal places) — tiers score on the displayed value */
+    dp: number;
+}
+/** Display precision per method (identifiers, not quantities — never localise). */
+export declare const BAND_METHOD_DP: Record<BandMethod, number>;
+/** Derive DISTINGUISH % cuts from RGB DIST cuts (the one legal derivation). */
+export declare function deriveDistinguishCuts(rgbdistCuts: readonly [number, number, number]): [number, number, number];
+/**
+ * The calibrated band vocabulary. ΔE2000 rows are the settled ground truth
+ * (MATCH 5/10/20 · HARMONY 6/12/20 · SEPARATION 8/15/30 ascending — the UI
+ * reads SEPARATION descending, 30/15/8, high = clear).
+ */
+export declare const BAND_VOCABULARY: Record<BandContext, Record<BandMethod, MethodBandSet>>;
+/**
+ * RATIO (WCAG contrast) bands — Accessibility Checker and Dye Comparison
+ * only. Not a distance; prints last after a rule; per-tool cuts and polarity;
+ * ordering still sorts ascending. dp 2.
+ */
+export declare const RATIO_BANDS: {
+    /** Calibrated vs MATCH tiers. All 1.00: no lightness cut separates the
+     *  lower tiers at all on real pairs — a finding about RATIO, not a bug. */
+    readonly comparison: {
+        readonly cuts: readonly [1, 1, 1];
+        readonly dp: 2;
+    };
+    /** Calibrated vs SEPARATION tiers on the pooled lens corpus, top band
+     *  anchored at 3:1 (the WCAG 1.4.11 figure). */
+    readonly accessibility: {
+        readonly cuts: readonly [1, 1.29, 3];
+        readonly dp: 2;
+    };
+};
+/** Round a value to a method's display precision (tier-on-displayed-value). */
+export declare function roundToBandDisplay(value: number, method: BandMethod): number;
+/**
+ * Classify a measured value against explicit cuts, scoring on the
+ * display-rounded value. Use this directly for ΔE2000 when the user's match
+ * line has moved the MATCH cuts; every other method's cuts are fixed.
+ */
+export declare function classifyBandTierWithCuts(value: number, cuts: readonly [number, number, number], dp: number): BandTier;
+/**
+ * Classify a measured value into its band tier for a method + context.
+ * The value must be in the method's native unit (ΔEOK raw, not ×100).
+ */
+export declare function classifyBandTier(value: number, method: BandMethod, context: BandContext): BandTier;
+//# sourceMappingURL=band-vocabulary.d.ts.map

package/dist/config/band-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"band-vocabulary.d.ts","sourceRoot":"","sources":["../../src/config/band-vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,2EAA2E;AAC3E,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC;AAE7D,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,aAAa,CAAC;AAE7F,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAErC,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,mFAAmF;AACnF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAOrD,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC7C,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAM1B;AAYD;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAyBlF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW;IACtB;+EAC2E;;;;;IAE3E;oDACgD;;;;;CAExC,CAAC;AAEX,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAG5E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACvC,EAAE,EAAE,MAAM,GACT,QAAQ,CAIV;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,WAAW,GACnB,QAAQ,CAGV"}

package/dist/config/band-vocabulary.js

@@ -0,0 +1,117 @@
+/**
+ * The 5.0 band vocabulary — calibrated per-method tier boundaries.
+ *
+ * Confirmed 2026-08-07 (`Band Calibration.dc.html`): the non-default methods
+ * take empirical accuracy-optimal cuts against ΔE2000's settled tiers,
+ * rounded to display precision and scored on rounded values. The numbers here
+ * are generated by `scripts/calibrate-bands.ts` (algorithm in
+ * `band-calibration.ts`) and guarded by a parity test — do not hand-edit;
+ * re-run the script if `dyes.json` changes.
+ *
+ * Three standing rules, whatever the method:
+ * 1. Print the method wherever a tier or verdict appears.
+ * 2. Never compare a tier across methods.
+ * 3. Only ΔE2000's bands follow the user's match line — every other method's
+ *    bands are fixed, and copy must say so (use
+ *    {@link classifyBandTierWithCuts} for the ΔE2000-with-user-slider case).
+ *
+ * Notes carried from the study:
+ * - ΔEOK prints raw (dp 3); a ×100 display unit converts exactly (same cuts).
+ * - DISTINGUISH % derives exactly from RGB DIST (identical ranks); its bands
+ *   are computed from RGB DIST's cuts, never calibrated separately. Integer
+ *   rounding creates ties — orderings need a sort fallback and ties badge TIE.
+ * - RATIO is not a distance (lightness only) and never joins the tier
+ *   vocabulary; its calibrated cuts exist only for Accessibility + Comparison,
+ *   with the Accessibility top band anchored at 3:1 (WCAG 1.4.11). A first
+ *   band of 1.00 is literal: that tier is unreachable through lightness alone.
+ */
+import { COLOR_DISTANCE_MAX } from '../constants/index.js';
+/** Display precision per method (identifiers, not quantities — never localise). */
+export const BAND_METHOD_DP = {
+    ciede2000: 1,
+    oklab: 3,
+    cie76: 1,
+    redmean: 1,
+    rgb: 1,
+    distinguish: 0,
+};
+/** Derive DISTINGUISH % cuts from RGB DIST cuts (the one legal derivation). */
+export function deriveDistinguishCuts(rgbdistCuts) {
+    return rgbdistCuts.map((v) => Math.round((v / COLOR_DISTANCE_MAX) * 100));
+}
+function bandSet(cuts, method) {
+    return { cuts, dp: BAND_METHOD_DP[method] };
+}
+const RGBDIST_CUTS = {
+    match: [8.3, 18.9, 55.5],
+    harmony: [11.2, 26.1, 55.5],
+    separation: [34.7, 58.9, 129.9],
+};
+/**
+ * The calibrated band vocabulary. ΔE2000 rows are the settled ground truth
+ * (MATCH 5/10/20 · HARMONY 6/12/20 · SEPARATION 8/15/30 ascending — the UI
+ * reads SEPARATION descending, 30/15/8, high = clear).
+ */
+export const BAND_VOCABULARY = {
+    match: {
+        ciede2000: bandSet([5, 10, 20], 'ciede2000'),
+        oklab: bandSet([0.017, 0.04, 0.107], 'oklab'),
+        cie76: bandSet([5.4, 12.6, 26.2], 'cie76'),
+        redmean: bandSet([13.9, 31.9, 91.1], 'redmean'),
+        rgb: bandSet(RGBDIST_CUTS.match, 'rgb'),
+        distinguish: bandSet(deriveDistinguishCuts(RGBDIST_CUTS.match), 'distinguish'),
+    },
+    harmony: {
+        ciede2000: bandSet([6, 12, 20], 'ciede2000'),
+        oklab: bandSet([0.02, 0.053, 0.107], 'oklab'),
+        cie76: bandSet([6.7, 14.5, 26.2], 'cie76'),
+        redmean: bandSet([16.5, 44.4, 91.1], 'redmean'),
+        rgb: bandSet(RGBDIST_CUTS.harmony, 'rgb'),
+        distinguish: bandSet(deriveDistinguishCuts(RGBDIST_CUTS.harmony), 'distinguish'),
+    },
+    separation: {
+        ciede2000: bandSet([8, 15, 30], 'ciede2000'),
+        oklab: bandSet([0.062, 0.103, 0.252], 'oklab'),
+        cie76: bandSet([10.4, 19.3, 38.4], 'cie76'),
+        redmean: bandSet([54, 102, 222], 'redmean'),
+        rgb: bandSet(RGBDIST_CUTS.separation, 'rgb'),
+        distinguish: bandSet(deriveDistinguishCuts(RGBDIST_CUTS.separation), 'distinguish'),
+    },
+};
+/**
+ * RATIO (WCAG contrast) bands — Accessibility Checker and Dye Comparison
+ * only. Not a distance; prints last after a rule; per-tool cuts and polarity;
+ * ordering still sorts ascending. dp 2.
+ */
+export const RATIO_BANDS = {
+    /** Calibrated vs MATCH tiers. All 1.00: no lightness cut separates the
+     *  lower tiers at all on real pairs — a finding about RATIO, not a bug. */
+    comparison: { cuts: [1, 1, 1], dp: 2 },
+    /** Calibrated vs SEPARATION tiers on the pooled lens corpus, top band
+     *  anchored at 3:1 (the WCAG 1.4.11 figure). */
+    accessibility: { cuts: [1, 1.29, 3], dp: 2 },
+};
+/** Round a value to a method's display precision (tier-on-displayed-value). */
+export function roundToBandDisplay(value, method) {
+    const f = Math.pow(10, BAND_METHOD_DP[method]);
+    return Math.round(value * f) / f;
+}
+/**
+ * Classify a measured value against explicit cuts, scoring on the
+ * display-rounded value. Use this directly for ΔE2000 when the user's match
+ * line has moved the MATCH cuts; every other method's cuts are fixed.
+ */
+export function classifyBandTierWithCuts(value, cuts, dp) {
+    const f = Math.pow(10, dp);
+    const v = Math.round(value * f) / f;
+    return v < cuts[0] ? 0 : v < cuts[1] ? 1 : v < cuts[2] ? 2 : 3;
+}
+/**
+ * Classify a measured value into its band tier for a method + context.
+ * The value must be in the method's native unit (ΔEOK raw, not ×100).
+ */
+export function classifyBandTier(value, method, context) {
+    const { cuts, dp } = BAND_VOCABULARY[context][method];
+    return classifyBandTierWithCuts(value, cuts, dp);
+}
+//# sourceMappingURL=band-vocabulary.js.map

package/dist/config/band-vocabulary.js.map

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

package/dist/config/consolidated-ids.js

@@ -40,8 +40,8 @@ export const CONSOLIDATED_DYES = {
             zh: '追加染剂1',
         },
         acquisition: 'The Firmament',
-        price: 1000,
-        currency: "Sky Builders' Scrips",
+        price: 100,
+        currency: 'Skybuilders Scrips',
     },
     C: {
         itemID: CONSOLIDATED_IDS.C,

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;;;;;;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"}
+{"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,GAAG;QACV,QAAQ,EAAE,oBAAoB;KAC/B;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/config/dye-vocabulary.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Closed vocabularies for the dye database.
+ *
+ * Single source of truth for the category/acquisition/currency value sets and
+ * the acquisition → (price, currency) coupling. Ported from the retired
+ * `apps/maintainer` tool during the Monorepo 2.0 consolidation — but corrected:
+ * the maintainer's lists had drifted badly (8 of its 10 acquisition values
+ * appeared in zero dyes while 3 real ones were missing).
+ *
+ * These constants are enforced against `colors_xiv.json` by
+ * `__tests__/dye-vocabulary.test.ts`, which replaces the maintainer's
+ * validation role (duplicate-ID checks, closed-vocabulary checks) with CI.
+ *
+ * See docs/research/monorepo-2.0/01-dye-data-format.md — under schema v2 the
+ * per-entry `price`/`currency` fields are dropped entirely in favor of
+ * `ACQUISITION_META`.
+ */
+/** Every category value present in the dye database, in display order. */
+export declare const DYE_CATEGORIES: readonly ["Neutral", "Reds", "Browns", "Yellows", "Greens", "Blues", "Purples", "Special"];
+export type DyeCategory = (typeof DYE_CATEGORIES)[number];
+/** Every acquisition source present in the dye database. */
+export declare const DYE_ACQUISITIONS: readonly ["Dye Vendor", "The Firmament", "Cosmic Exploration", "Venture Coffers"];
+export type DyeAcquisition = (typeof DYE_ACQUISITIONS)[number];
+export interface AcquisitionMeta {
+    /** Vendor price in the acquisition's currency. */
+    price: number;
+    /** Currency name. */
+    currency: string;
+}
+/**
+ * The acquisition → (price, currency) coupling. Exactly one pair per
+ * acquisition value — verified 125/125 against the dye database. Under
+ * schema v2 the per-entry price/currency fields no longer exist in the data
+ * file; `DyeDatabase.initialize()` derives `cost`/`currency` from this table.
+ */
+export declare const ACQUISITION_META: Record<DyeAcquisition, AcquisitionMeta>;
+/**
+ * Stain-sheet gloss rows (`IsMetallic = true` in the game's Stain sheet) —
+ * the authoritative metallic set (16 stains). Note this is NOT the same as
+ * `name.startsWith('Metallic')` (14): the game marks Gunmetal Black (92) and
+ * Pearl White (93) as metallic/gloss too. Decided 2026-07-30: the metallic
+ * filter means gloss (research/monorepo-2.0/01 §6 #5).
+ */
+export declare const METALLIC_STAIN_IDS: ReadonlySet<number>;
+//# sourceMappingURL=dye-vocabulary.d.ts.map

package/dist/config/dye-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dye-vocabulary.d.ts","sourceRoot":"","sources":["../../src/config/dye-vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,cAAc,4FASjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,mFAKnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,eAAe,CAKpE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAEjD,CAAC"}

package/dist/config/dye-vocabulary.js

@@ -0,0 +1,58 @@
+/**
+ * Closed vocabularies for the dye database.
+ *
+ * Single source of truth for the category/acquisition/currency value sets and
+ * the acquisition → (price, currency) coupling. Ported from the retired
+ * `apps/maintainer` tool during the Monorepo 2.0 consolidation — but corrected:
+ * the maintainer's lists had drifted badly (8 of its 10 acquisition values
+ * appeared in zero dyes while 3 real ones were missing).
+ *
+ * These constants are enforced against `colors_xiv.json` by
+ * `__tests__/dye-vocabulary.test.ts`, which replaces the maintainer's
+ * validation role (duplicate-ID checks, closed-vocabulary checks) with CI.
+ *
+ * See docs/research/monorepo-2.0/01-dye-data-format.md — under schema v2 the
+ * per-entry `price`/`currency` fields are dropped entirely in favor of
+ * `ACQUISITION_META`.
+ */
+/** Every category value present in the dye database, in display order. */
+export const DYE_CATEGORIES = [
+    'Neutral',
+    'Reds',
+    'Browns',
+    'Yellows',
+    'Greens',
+    'Blues',
+    'Purples',
+    'Special',
+];
+/** Every acquisition source present in the dye database. */
+export const DYE_ACQUISITIONS = [
+    'Dye Vendor',
+    'The Firmament',
+    'Cosmic Exploration',
+    'Venture Coffers',
+];
+/**
+ * The acquisition → (price, currency) coupling. Exactly one pair per
+ * acquisition value — verified 125/125 against the dye database. Under
+ * schema v2 the per-entry price/currency fields no longer exist in the data
+ * file; `DyeDatabase.initialize()` derives `cost`/`currency` from this table.
+ */
+export const ACQUISITION_META = {
+    'Dye Vendor': { price: 216, currency: 'Gil' },
+    'The Firmament': { price: 100, currency: 'Skybuilders Scrips' },
+    'Cosmic Exploration': { price: 600, currency: 'Cosmocredits' },
+    'Venture Coffers': { price: 1, currency: 'Venture Coffer' },
+};
+/**
+ * Stain-sheet gloss rows (`IsMetallic = true` in the game's Stain sheet) —
+ * the authoritative metallic set (16 stains). Note this is NOT the same as
+ * `name.startsWith('Metallic')` (14): the game marks Gunmetal Black (92) and
+ * Pearl White (93) as metallic/gloss too. Decided 2026-07-30: the metallic
+ * filter means gloss (research/monorepo-2.0/01 §6 #5).
+ */
+export const METALLIC_STAIN_IDS = new Set([
+    92, 93, 94, 112, 113, 114, 115, 116, 117, 118, 119, 120, 122, 123, 124, 125,
+]);
+//# sourceMappingURL=dye-vocabulary.js.map

package/dist/config/dye-vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dye-vocabulary.js","sourceRoot":"","sources":["../../src/config/dye-vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS;IACT,MAAM;IACN,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,OAAO;IACP,SAAS;IACT,SAAS;CACD,CAAC;AAIX,4DAA4D;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,YAAY;IACZ,eAAe;IACf,oBAAoB;IACpB,iBAAiB;CACT,CAAC;AAWX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA4C;IACvE,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC7C,eAAe,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,oBAAoB,EAAE;IAC/D,oBAAoB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE;IAC9D,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE;CAC5D,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC;IAC7D,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CAC5E,CAAC,CAAC"}

package/dist/config/facewear.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Facewear colors — the 11 glasses-color entries split out of the dye
+ * database in schema v2 (Monorepo 2.0; docs/research/monorepo-2.0/01 §3).
+ *
+ * They are not stains: no stainID, no market presence, no Stain-sheet row.
+ */
+import type { FacewearColor } from '@xivdyetools/types';
+export declare const facewearColors: readonly FacewearColor[];
+/**
+ * Frozen mapping of the pre-v2 synthetic negative itemIDs to facewear slugs.
+ *
+ * Before schema v2, `DyeDatabase.initialize()` assigned each Facewear entry
+ * `-(1000 + Σ charCode(name))`. Those IDs escaped into serialized data
+ * (api-worker's public negative-ID lookups, potentially localStorage). This
+ * table is FROZEN — computed once from the names as they existed at the
+ * split (2026-07-31) and must never be regenerated from live data, or a
+ * rename would silently orphan persisted references (research/monorepo-2.0/02).
+ */
+export declare const LEGACY_FACEWEAR_ITEM_IDS: Readonly<Record<number, string>>;
+/** Look up a facewear color by its slug id. */
+export declare function getFacewearColor(id: string): FacewearColor | null;
+/** Resolve a pre-v2 synthetic negative itemID to its facewear color. */
+export declare function getFacewearColorByLegacyItemID(legacyId: number): FacewearColor | null;
+//# sourceMappingURL=facewear.d.ts.map

package/dist/config/facewear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facewear.d.ts","sourceRoot":"","sources":["../../src/config/facewear.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,eAAO,MAAM,cAAc,EAAE,SAAS,aAAa,EAAiB,CAAC;AAErE;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYrE,CAAC;AAEF,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAEjE;AAED,wEAAwE;AACxE,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAGrF"}

package/dist/config/facewear.js

@@ -0,0 +1,35 @@
+import facewearData from '../data/facewear_colors.json' with { type: 'json' };
+export const facewearColors = facewearData;
+/**
+ * Frozen mapping of the pre-v2 synthetic negative itemIDs to facewear slugs.
+ *
+ * Before schema v2, `DyeDatabase.initialize()` assigned each Facewear entry
+ * `-(1000 + Σ charCode(name))`. Those IDs escaped into serialized data
+ * (api-worker's public negative-ID lookups, potentially localStorage). This
+ * table is FROZEN — computed once from the names as they existed at the
+ * split (2026-07-31) and must never be regenerated from live data, or a
+ * rename would silently orphan persisted references (research/monorepo-2.0/02).
+ */
+export const LEGACY_FACEWEAR_ITEM_IDS = {
+    [-1629]: 'silver',
+    [-1390]: 'gold',
+    [-1477]: 'black',
+    [-1513]: 'white',
+    [-1407]: 'grey',
+    [-1283]: 'red',
+    [-1392]: 'blue',
+    [-1497]: 'green',
+    [-1507]: 'brass',
+    [-1632]: 'purple',
+    [-1520]: 'brown',
+};
+/** Look up a facewear color by its slug id. */
+export function getFacewearColor(id) {
+    return facewearColors.find((f) => f.id === id) ?? null;
+}
+/** Resolve a pre-v2 synthetic negative itemID to its facewear color. */
+export function getFacewearColorByLegacyItemID(legacyId) {
+    const slug = LEGACY_FACEWEAR_ITEM_IDS[legacyId];
+    return slug ? getFacewearColor(slug) : null;
+}
+//# sourceMappingURL=facewear.js.map

package/dist/config/facewear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facewear.js","sourceRoot":"","sources":["../../src/config/facewear.ts"],"names":[],"mappings":"AAOA,OAAO,YAAY,MAAM,8BAA8B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAE9E,MAAM,CAAC,MAAM,cAAc,GAA6B,YAAY,CAAC;AAErE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACxE,CAAC,CAAC,IAAI,CAAC,EAAE,QAAQ;IACjB,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM;IACf,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO;IAChB,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO;IAChB,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM;IACf,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK;IACd,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM;IACf,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO;IAChB,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO;IAChB,CAAC,CAAC,IAAI,CAAC,EAAE,QAAQ;IACjB,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO;CACjB,CAAC;AAEF,+CAA+C;AAC/C,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC;AACzD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,8BAA8B,CAAC,QAAgB;IAC7D,MAAM,IAAI,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC"}

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

@@ -0,0 +1,70 @@
+/**
+ * /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.
+ */
+import type { LocaleCode } from '@xivdyetools/types';
+/** Manual topic identifiers — stored choice values, verbatim across locales. */
+export type ManualTopicId = 'match_image' | 'color_vision' | 'contrast' | 'matching_methods' | 'spectrum_prices' | 'character_file';
+/** FFXIV Lodestone regions (per-region hosts, not per-locale). */
+export type LodestoneRegion = 'na' | 'eu' | 'jp' | 'de' | 'fr';
+export interface LearnLink {
+    /** The authority to name in UI (never print the URL path) */
+    authority: string;
+    /** Host, printed beside the authority in embeds */
+    host: string;
+    url: string;
+}
+export interface ManualTopic {
+    id: ManualTopicId;
+    /** Emoji prefix used in the /manual choice list (part of the shipped string) */
+    emoji: string;
+    /**
+     * Per-locale learn-more links. An absent locale means NO link — consumers
+     * must render the absent state, never fall back to English.
+     */
+    links: Partial<Record<LocaleCode, LearnLink>>;
+}
+/** Our own documentation site (Matching Methods target, all locales). */
+export declare const XIVDYETOOLS_DOCS_URL = "https://developers.xivdyetools.app/";
+/** Lodestone by region — Spectrum & Prices resolves region from the user's world. */
+export declare const LODESTONE_BY_REGION: Record<LodestoneRegion, LearnLink>;
+/**
+ * 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 declare const MANUAL_TOPICS: readonly ManualTopic[];
+/**
+ * Learn-more link for a topic + locale. Returns null for the absent state —
+ * consumers render "no link", never the English URL.
+ */
+export declare function getLearnLink(topic: ManualTopicId, locale: LocaleCode): LearnLink | null;
+/** Lodestone link for a game region (Spectrum & Prices topic). */
+export declare function getLodestoneLink(region: LodestoneRegion): LearnLink;
+//# sourceMappingURL=learn-links.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"learn-links.d.ts","sourceRoot":"","sources":["../../src/config/learn-links.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,gFAAgF;AAChF,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,cAAc,GACd,UAAU,GACV,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/D,MAAM,WAAW,SAAS;IACxB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,aAAa,CAAC;IAClB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;CAC/C;AAID,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,wCAAwC,CAAC;AAE1E,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,eAAe,EAAE,SAAS,CA0BlE,CAAC;AAQF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAsF/C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAGvF;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAEnE"}