@xivdyetools/core 5.1.0 → 5.3.0

package/dist/services/dye/wheels/hue-warp.js

@@ -0,0 +1,144 @@
+/**
+ * Hue-warp wheels: a monotone piecewise-linear bijection between sRGB/HSV hue
+ * and a wheel angle. RGB (identity), RYB, Munsell and OKLCH-hue are all this.
+ *
+ * The target keeps the BASE's HSV saturation and value on the mapped hue —
+ * the contract the 2026-09-03 harmony convergence rests on — so on the
+ * identity table this reproduces today's output bit for bit.
+ *
+ * @module services/dye/wheels/hue-warp
+ */
+import { ColorConverter } from '../../color/ColorConverter.js';
+const mod360 = (x) => (x >= 0 && x < 360 ? x : ((x % 360) + 360) % 360);
+/**
+ * Every table must be strictly increasing in both columns and run exactly
+ * from `[0,0]` to `[360,360]`; otherwise the inverse is ambiguous and a
+ * linear-search inverse returns a hue wrong by far more than the dent
+ * (research 05 §7: a 0.16° reversal produced a 13° error, silently).
+ */
+export function assertMonotoneTable(table, id) {
+    if (table.length < 2) {
+        throw new Error(`ColorWheel ${id}: table needs at least two pairs`);
+    }
+    const first = table[0];
+    const last = table[table.length - 1];
+    if (first[0] !== 0 || first[1] !== 0) {
+        throw new Error(`ColorWheel ${id}: table must start at [0,0]`);
+    }
+    if (last[0] !== 360 || last[1] !== 360) {
+        throw new Error(`ColorWheel ${id}: table must end at [360,360]`);
+    }
+    for (let i = 1; i < table.length; i++) {
+        if (!(table[i][0] > table[i - 1][0]) || !(table[i][1] > table[i - 1][1])) {
+            throw new Error(`ColorWheel ${id}: table is not strictly increasing at row ${i}`);
+        }
+    }
+}
+/** Piecewise-linear map of `x` from column `from` to column `to`. */
+function interpolate(table, x, from, to) {
+    const v = mod360(x);
+    let lo = 0;
+    let hi = table.length - 1;
+    while (hi - lo > 1) {
+        const mid = (lo + hi) >> 1;
+        if (table[mid][from] <= v)
+            lo = mid;
+        else
+            hi = mid;
+    }
+    const a = table[lo];
+    const b = table[hi];
+    const t = (v - a[from]) / (b[from] - a[from]);
+    return mod360(a[to] + t * (b[to] - a[to]));
+}
+/** sRGB/HSV hue → wheel angle. */
+export function toWheelHue(table, hsvHue) {
+    return table.length === 2 ? mod360(hsvHue) : interpolate(table, hsvHue, 1, 0);
+}
+/** Wheel angle → sRGB/HSV hue. */
+export function fromWheelHue(table, wheelHue) {
+    return table.length === 2 ? mod360(wheelHue) : interpolate(table, wheelHue, 0, 1);
+}
+/**
+ * Turn measured `[wheelAngle, hsvHue]` pairs — in any order, with the wheel
+ * column wrapping wherever the measurement put its zero — into a valid
+ * {@link WarpTable}: sorted by HSV hue, wheel column unwrapped, small dents
+ * monotonised with a running maximum, re-zeroed so HSV 0° ↦ wheel 0°, and
+ * closed with `[0,0]` and `[360,360]`.
+ *
+ * Every warp wheel is zeroed at sRGB red, so wheels differ in SPACING only;
+ * that is what lets the ring, the nodes and the base spoke share one origin.
+ */
+export function normalizeWarpTable(raw, id, options = {}) {
+    const maxCorrection = options.maxCorrectionDeg ?? 1;
+    if (raw.length < 3) {
+        throw new Error(`ColorWheel ${id}: need at least three measured pairs`);
+    }
+    const sorted = raw
+        .map(([w, h]) => [mod360(w), mod360(h)])
+        .sort((a, b) => a[1] - b[1]);
+    // Unwrap the wheel column: a backward step larger than half a turn is the
+    // measurement's own zero crossing, not a dent.
+    const unwrapped = [];
+    let offset = 0;
+    for (let i = 0; i < sorted.length; i++) {
+        let w = sorted[i][0] + offset;
+        if (i > 0 && w < unwrapped[i - 1][0] - 180) {
+            offset += 360;
+            w += 360;
+        }
+        unwrapped.push([w, sorted[i][1]]);
+    }
+    // Monotonise small dents; refuse large ones.
+    for (let i = 1; i < unwrapped.length; i++) {
+        const prev = unwrapped[i - 1][0];
+        if (unwrapped[i][0] <= prev) {
+            const correction = prev - unwrapped[i][0];
+            if (correction > maxCorrection) {
+                throw new Error(`ColorWheel ${id}: wheel column reverses by ${correction.toFixed(3)}° at HSV ` +
+                    `${unwrapped[i][1].toFixed(2)}°, more than the ${maxCorrection}° tolerance`);
+            }
+            unwrapped[i][0] = prev + 1e-6;
+        }
+    }
+    // Wheel angle at HSV 0°, by interpolating across the wrap-around segment.
+    const [wFirst, hFirst] = unwrapped[0];
+    const [wLast, hLast] = unwrapped[unwrapped.length - 1];
+    const t = (360 - hLast) / (hFirst + 360 - hLast);
+    const w0 = wLast + t * (wFirst + 360 - wLast);
+    const table = [[0, 0]];
+    for (const [w, h] of unwrapped) {
+        const shifted = w - w0 + 360; // wFirst ≥ w0 − 360 by construction
+        if (h > 0 && shifted > 0 && shifted < 360)
+            table.push([shifted, h]);
+    }
+    table.push([360, 360]);
+    assertMonotoneTable(table, id);
+    return table;
+}
+/** Build a wheel from a table. Throws at construction on a bad table. */
+export function hueWarpWheel(id, table) {
+    assertMonotoneTable(table, id);
+    return {
+        id,
+        // Every warp wheel's target is the base's own S/V on a re-spaced hue, so
+        // angular hue distance to `targetHue` is a meaningful ranking here.
+        carriesBaseHsv: true,
+        hueOf(hex) {
+            return toWheelHue(table, ColorConverter.hexToHsv(hex).h);
+        },
+        target(baseHex, wheelHue) {
+            const base = ColorConverter.hexToHsv(baseHex);
+            const targetHue = fromWheelHue(table, wheelHue);
+            return { targetHex: ColorConverter.hsvToHex(targetHue, base.s, base.v), targetHue };
+        },
+        ringStops(count) {
+            const stops = [];
+            for (let i = 0; i < count; i++) {
+                stops.push(ColorConverter.hsvToHex(fromWheelHue(table, (i * 360) / count), 100, 100));
+            }
+            return stops;
+        },
+    };
+}
+//# sourceMappingURL=hue-warp.js.map

package/dist/services/dye/wheels/hue-warp.js.map

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

package/dist/services/dye/wheels/munsell.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The Munsell hue wheel: 40 principal hues at 3.6° per ASTM step, anchored
+ * to sRGB by the renotation data at Value 6 / Chroma 8 (see NOTICE).
+ * Red's complement is 5BG, a blue-green — the third answer after RGB (cyan)
+ * and RYB (green), and the one Japan's JIS Z 8721 teaches.
+ *
+ * The 40 raw renotation anchors the table was derived from live in the
+ * separate `data/munsell-anchors.json`, which nothing at runtime imports —
+ * only `munsell.test.ts`, for its cross-check. Keeping them out of this module
+ * keeps them out of every bundle that draws a wheel.
+ *
+ * @module services/dye/wheels/munsell
+ */
+import type { WarpTable } from './types.js';
+export declare const MUNSELL_TABLE: WarpTable;
+export declare const MUNSELL_WHEEL: import("./types.js").ColorWheel;
+//# sourceMappingURL=munsell.d.ts.map

package/dist/services/dye/wheels/munsell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"munsell.d.ts","sourceRoot":"","sources":["../../../../src/services/dye/wheels/munsell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,aAAa,EAAE,SAAqD,CAAC;AAElF,eAAO,MAAM,aAAa,iCAAyC,CAAC"}

package/dist/services/dye/wheels/munsell.js

@@ -0,0 +1,18 @@
+/**
+ * The Munsell hue wheel: 40 principal hues at 3.6° per ASTM step, anchored
+ * to sRGB by the renotation data at Value 6 / Chroma 8 (see NOTICE).
+ * Red's complement is 5BG, a blue-green — the third answer after RGB (cyan)
+ * and RYB (green), and the one Japan's JIS Z 8721 teaches.
+ *
+ * The 40 raw renotation anchors the table was derived from live in the
+ * separate `data/munsell-anchors.json`, which nothing at runtime imports —
+ * only `munsell.test.ts`, for its cross-check. Keeping them out of this module
+ * keeps them out of every bundle that draws a wheel.
+ *
+ * @module services/dye/wheels/munsell
+ */
+import munsellData from '../../../data/munsell-hues.json' with { type: 'json' };
+import { hueWarpWheel } from './hue-warp.js';
+export const MUNSELL_TABLE = munsellData.table;
+export const MUNSELL_WHEEL = hueWarpWheel('munsell', MUNSELL_TABLE);
+//# sourceMappingURL=munsell.js.map

package/dist/services/dye/wheels/munsell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"munsell.js","sourceRoot":"","sources":["../../../../src/services/dye/wheels/munsell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,WAAW,MAAM,iCAAiC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,CAAC,MAAM,aAAa,GAAc,WAAW,CAAC,KAA6B,CAAC;AAElF,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC"}

package/dist/services/dye/wheels/oklch-hue.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The OKLCH-hue wheel: the sRGB hue circle re-spaced so equal angles are equal
+ * OKLab hue steps. Targets still carry the base's HSV saturation and value, so
+ * it behaves like RYB (a different spacing), not like a different colour space.
+ *
+ * The raw OKLab hue of the pure-hue circle reverses by 0.16° across HSV
+ * 231.4°–240° — invisible on the ring, a 13° inverse error if left alone
+ * (research 05 §7). `normalizeWarpTable` monotonises it and the tests pin the
+ * result.
+ *
+ * The table is DATA, generated by `scripts/build-oklch-hue-table.ts` and
+ * committed: deriving it here meant 72 `hsvToHex` + `hexToOklch` round trips
+ * on every module load, in every bundle that touched a colour wheel.
+ * `scripts/lib/oklch-hue-table.test.ts` re-runs the derivation and compares,
+ * so the JSON cannot drift from the maths that produced it.
+ *
+ * @module services/dye/wheels/oklch-hue
+ */
+import type { WarpTable } from './types.js';
+export declare const OKLCH_HUE_TABLE: WarpTable;
+export declare const OKLCH_HUE_WHEEL: import("./types.js").ColorWheel;
+//# sourceMappingURL=oklch-hue.d.ts.map

package/dist/services/dye/wheels/oklch-hue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oklch-hue.d.ts","sourceRoot":"","sources":["../../../../src/services/dye/wheels/oklch-hue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,eAAe,EAAE,SAAsD,CAAC;AAErF,eAAO,MAAM,eAAe,iCAA6C,CAAC"}

package/dist/services/dye/wheels/oklch-hue.js

@@ -0,0 +1,23 @@
+/**
+ * The OKLCH-hue wheel: the sRGB hue circle re-spaced so equal angles are equal
+ * OKLab hue steps. Targets still carry the base's HSV saturation and value, so
+ * it behaves like RYB (a different spacing), not like a different colour space.
+ *
+ * The raw OKLab hue of the pure-hue circle reverses by 0.16° across HSV
+ * 231.4°–240° — invisible on the ring, a 13° inverse error if left alone
+ * (research 05 §7). `normalizeWarpTable` monotonises it and the tests pin the
+ * result.
+ *
+ * The table is DATA, generated by `scripts/build-oklch-hue-table.ts` and
+ * committed: deriving it here meant 72 `hsvToHex` + `hexToOklch` round trips
+ * on every module load, in every bundle that touched a colour wheel.
+ * `scripts/lib/oklch-hue-table.test.ts` re-runs the derivation and compares,
+ * so the JSON cannot drift from the maths that produced it.
+ *
+ * @module services/dye/wheels/oklch-hue
+ */
+import oklchHueData from '../../../data/oklch-hue-table.json' with { type: 'json' };
+import { hueWarpWheel } from './hue-warp.js';
+export const OKLCH_HUE_TABLE = oklchHueData.table;
+export const OKLCH_HUE_WHEEL = hueWarpWheel('oklch-hue', OKLCH_HUE_TABLE);
+//# sourceMappingURL=oklch-hue.js.map

package/dist/services/dye/wheels/oklch-hue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oklch-hue.js","sourceRoot":"","sources":["../../../../src/services/dye/wheels/oklch-hue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,YAAY,MAAM,oCAAoC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,CAAC,MAAM,eAAe,GAAc,YAAY,CAAC,KAA6B,CAAC;AAErF,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC"}

package/dist/services/dye/wheels/oklch-lightness.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The constant-lightness OKLCH wheel: rotate hue at the base's OKLab L and C,
+ * then gamut-map. Unlike the warp wheels this abandons the base's HSV S/V, so
+ * a light base yields light partners and palettes lean toward mid-tones —
+ * a deliberate product decision (spec §2.2), not a side effect.
+ *
+ * @module services/dye/wheels/oklch-lightness
+ */
+import type { ColorWheel } from './types.js';
+/** Ring stops are painted at this L, at the maximum in-gamut chroma per hue. */
+export declare const RING_LIGHTNESS = 0.65;
+/**
+ * Below this OKLCH chroma a colour is treated as grey: no hue, no rotation.
+ *
+ * Pure White (#F9F8F4) measures OKLCH C ≈ 0.0054 and must stay grey under
+ * this wheel, so the threshold sits just above it — not at the 0.005 a first
+ * draft used, which is just below that dye's real chroma (cross-checked
+ * against culori's oklch converter) and would have let it rotate. 0.006
+ * stays well under the next dye up by chroma, Charcoal Grey at C ≈ 0.0083,
+ * so it does not swallow any colour meant to keep rotating.
+ */
+export declare const ACHROMATIC_CHROMA = 0.006;
+export declare const OKLCH_LIGHTNESS_WHEEL: ColorWheel;
+//# sourceMappingURL=oklch-lightness.d.ts.map

package/dist/services/dye/wheels/oklch-lightness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oklch-lightness.d.ts","sourceRoot":"","sources":["../../../../src/services/dye/wheels/oklch-lightness.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,gFAAgF;AAChF,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAMvC,eAAO,MAAM,qBAAqB,EAAE,UAyCnC,CAAC"}

package/dist/services/dye/wheels/oklch-lightness.js

@@ -0,0 +1,65 @@
+/**
+ * The constant-lightness OKLCH wheel: rotate hue at the base's OKLab L and C,
+ * then gamut-map. Unlike the warp wheels this abandons the base's HSV S/V, so
+ * a light base yields light partners and palettes lean toward mid-tones —
+ * a deliberate product decision (spec §2.2), not a side effect.
+ *
+ * @module services/dye/wheels/oklch-lightness
+ */
+import { ColorConverter } from '../../color/ColorConverter.js';
+/** Ring stops are painted at this L, at the maximum in-gamut chroma per hue. */
+export const RING_LIGHTNESS = 0.65;
+/**
+ * Below this OKLCH chroma a colour is treated as grey: no hue, no rotation.
+ *
+ * Pure White (#F9F8F4) measures OKLCH C ≈ 0.0054 and must stay grey under
+ * this wheel, so the threshold sits just above it — not at the 0.005 a first
+ * draft used, which is just below that dye's real chroma (cross-checked
+ * against culori's oklch converter) and would have let it rotate. 0.006
+ * stays well under the next dye up by chroma, Charcoal Grey at C ≈ 0.0083,
+ * so it does not swallow any colour meant to keep rotating.
+ */
+export const ACHROMATIC_CHROMA = 0.006;
+const mod360 = (x) => ((x % 360) + 360) % 360;
+let ringCache = null;
+export const OKLCH_LIGHTNESS_WHEEL = {
+    id: 'oklch-lightness',
+    // This wheel abandons the base's HSV S/V for its OKLab L and C, so ranking
+    // candidates by angular hue distance would discard exactly the property the
+    // wheel exists to preserve. `HarmonySelector` reads this and forces ΔE.
+    carriesBaseHsv: false,
+    hueOf(hex) {
+        const { C, h } = ColorConverter.hexToOklch(hex);
+        // A grey has no hue: its measured OKLab angle is an artefact of 8-bit
+        // rounding (#808080 reads ≈ 90°, Pure White ≈ 250°), which would park the
+        // base spoke at an arbitrary and unstable angle. Every warp wheel puts a
+        // grey at 0 (HSV hue of a grey is 0); this one does too.
+        if (C < ACHROMATIC_CHROMA)
+            return 0;
+        return mod360(h);
+    },
+    target(baseHex, wheelHue) {
+        const base = ColorConverter.hexToOklch(baseHex);
+        if (base.C < ACHROMATIC_CHROMA) {
+            // A grey has no hue to rotate; every partner of a grey is that grey.
+            const { r, g, b } = ColorConverter.hexToRgb(baseHex);
+            const hex = ColorConverter.rgbToHex(r, g, b);
+            return { targetHex: hex, targetHue: ColorConverter.hexToHsv(hex).h };
+        }
+        const targetHex = ColorConverter.gamutMapOklch(base.L, base.C, mod360(wheelHue));
+        return { targetHex, targetHue: ColorConverter.hexToHsv(targetHex).h };
+    },
+    ringStops(count) {
+        if (ringCache && ringCache.count === count)
+            return ringCache.stops;
+        const stops = [];
+        for (let i = 0; i < count; i++) {
+            const h = (i * 360) / count;
+            const c = ColorConverter.maxChromaOklch(RING_LIGHTNESS, h);
+            stops.push(ColorConverter.gamutMapOklch(RING_LIGHTNESS, c, h));
+        }
+        ringCache = { count, stops };
+        return stops;
+    },
+};
+//# sourceMappingURL=oklch-lightness.js.map

package/dist/services/dye/wheels/oklch-lightness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oklch-lightness.js","sourceRoot":"","sources":["../../../../src/services/dye/wheels/oklch-lightness.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D,gFAAgF;AAChF,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEvC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAE9D,IAAI,SAAS,GAAyD,IAAI,CAAC;AAE3E,MAAM,CAAC,MAAM,qBAAqB,GAAe;IAC/C,EAAE,EAAE,iBAAiB;IAErB,2EAA2E;IAC3E,4EAA4E;IAC5E,wEAAwE;IACxE,cAAc,EAAE,KAAK;IAErB,KAAK,CAAC,GAAW;QACf,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAChD,sEAAsE;QACtE,0EAA0E;QAC1E,yEAAyE;QACzE,yDAAyD;QACzD,IAAI,CAAC,GAAG,iBAAiB;YAAE,OAAO,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,OAAe,EAAE,QAAgB;QACtC,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,CAAC,GAAG,iBAAiB,EAAE,CAAC;YAC/B,qEAAqE;YACrE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACrD,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7C,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,CAAC;QACD,MAAM,SAAS,GAAG,cAAc,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QACjF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,CAAC;IAED,SAAS,CAAC,KAAa;QACrB,IAAI,SAAS,IAAI,SAAS,CAAC,KAAK,KAAK,KAAK;YAAE,OAAO,SAAS,CAAC,KAAK,CAAC;QACnE,MAAM,KAAK,GAAe,EAAE,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;YAC5B,MAAM,CAAC,GAAG,cAAc,CAAC,cAAc,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,SAAS,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC"}

package/dist/services/dye/wheels/rgb-ryb.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The RGB (identity) and RYB (artist's) wheels.
+ *
+ * RYB is the 25-pair NodeBox/Paletton/Adobe hue warp. **Column 1 is the RYB
+ * angle, column 2 the sRGB hue** — the most-read write-up states it the other
+ * way round in prose while implementing it correctly, and reversing it turns
+ * red's complement from green into blue while a naïve "≠ 180°" test still
+ * passes (research 01 §1a). `registry.test.ts` asserts the values.
+ *
+ * @module services/dye/wheels/rgb-ryb
+ */
+import type { WarpTable } from './types.js';
+/** The identity: today's Harmony Explorer, bit for bit. */
+export declare const RGB_WHEEL: import("./types.js").ColorWheel;
+/** `[rybAngle, srgbHue]`. Red's complement (RYB 180°) is sRGB 138°. */
+export declare const RYB_TABLE: WarpTable;
+export declare const RYB_WHEEL: import("./types.js").ColorWheel;
+//# sourceMappingURL=rgb-ryb.d.ts.map

package/dist/services/dye/wheels/rgb-ryb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgb-ryb.d.ts","sourceRoot":"","sources":["../../../../src/services/dye/wheels/rgb-ryb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,2DAA2D;AAC3D,eAAO,MAAM,SAAS,iCAGpB,CAAC;AAEH,uEAAuE;AACvE,eAAO,MAAM,SAAS,EAAE,SA0BvB,CAAC;AAEF,eAAO,MAAM,SAAS,iCAAiC,CAAC"}

package/dist/services/dye/wheels/rgb-ryb.js

@@ -0,0 +1,47 @@
+/**
+ * The RGB (identity) and RYB (artist's) wheels.
+ *
+ * RYB is the 25-pair NodeBox/Paletton/Adobe hue warp. **Column 1 is the RYB
+ * angle, column 2 the sRGB hue** — the most-read write-up states it the other
+ * way round in prose while implementing it correctly, and reversing it turns
+ * red's complement from green into blue while a naïve "≠ 180°" test still
+ * passes (research 01 §1a). `registry.test.ts` asserts the values.
+ *
+ * @module services/dye/wheels/rgb-ryb
+ */
+import { hueWarpWheel } from './hue-warp.js';
+/** The identity: today's Harmony Explorer, bit for bit. */
+export const RGB_WHEEL = hueWarpWheel('rgb', [
+    [0, 0],
+    [360, 360],
+]);
+/** `[rybAngle, srgbHue]`. Red's complement (RYB 180°) is sRGB 138°. */
+export const RYB_TABLE = [
+    [0, 0],
+    [15, 8],
+    [30, 17],
+    [45, 26],
+    [60, 34],
+    [75, 41],
+    [90, 48],
+    [105, 54],
+    [120, 60],
+    [135, 81],
+    [150, 103],
+    [165, 123],
+    [180, 138],
+    [195, 155],
+    [210, 171],
+    [225, 187],
+    [240, 204],
+    [255, 219],
+    [270, 234],
+    [285, 251],
+    [300, 267],
+    [315, 282],
+    [330, 298],
+    [345, 329],
+    [360, 360],
+];
+export const RYB_WHEEL = hueWarpWheel('ryb', RYB_TABLE);
+//# sourceMappingURL=rgb-ryb.js.map

package/dist/services/dye/wheels/rgb-ryb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgb-ryb.js","sourceRoot":"","sources":["../../../../src/services/dye/wheels/rgb-ryb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,2DAA2D;AAC3D,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,EAAE;IAC3C,CAAC,CAAC,EAAE,CAAC,CAAC;IACN,CAAC,GAAG,EAAE,GAAG,CAAC;CACX,CAAC,CAAC;AAEH,uEAAuE;AACvE,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC,CAAC,CAAC,EAAE,CAAC,CAAC;IACN,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,CAAC,EAAE,EAAE,EAAE,CAAC;IACR,CAAC,EAAE,EAAE,EAAE,CAAC;IACR,CAAC,EAAE,EAAE,EAAE,CAAC;IACR,CAAC,EAAE,EAAE,EAAE,CAAC;IACR,CAAC,EAAE,EAAE,EAAE,CAAC;IACR,CAAC,GAAG,EAAE,EAAE,CAAC;IACT,CAAC,GAAG,EAAE,EAAE,CAAC;IACT,CAAC,GAAG,EAAE,EAAE,CAAC;IACT,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;CACX,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC"}

package/dist/services/dye/wheels/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * A colour wheel for the Harmony Explorer: how a colour becomes an angle, how
+ * an angle becomes a target colour, and how the ring is painted.
+ *
+ * Every consumer — the web app, the Discord bot, the OG card — reads wheels
+ * from this package and holds no list of its own (spec §2).
+ *
+ * @module services/dye/wheels/types
+ */
+import type { ColorWheelId, HexColor } from '@xivdyetools/types';
+export type { ColorWheelId };
+export interface ColorWheel {
+    readonly id: ColorWheelId;
+    /**
+     * True when targets carry the base's HSV S/V (hue-distance ranking is
+     * meaningful). False for wheels that preserve lightness/chroma instead,
+     * which must always rank by ΔE.
+     */
+    readonly carriesBaseHsv: boolean;
+    /** Where a colour sits on this wheel, 0–360. */
+    hueOf(hex: string): number;
+    /**
+     * The ideal colour for a slot at `wheelHue`, carrying whatever this wheel
+     * preserves from the base. `targetHue` is always an sRGB/HSV hue, because
+     * the non-perceptual ranking branch compares dye HSV hue against it.
+     */
+    target(baseHex: string, wheelHue: number): {
+        targetHex: HexColor;
+        targetHue: number;
+    };
+    /** Ring paint at `count` evenly spaced wheel angles, plain in-gamut hex. */
+    ringStops(count: number): readonly HexColor[];
+}
+/**
+ * `[wheelAngle, hsvHue]` pairs, both 0–360, first pair `[0, 0]`, last pair
+ * `[360, 360]`, both columns strictly increasing. A hue-warp wheel is defined
+ * entirely by one of these.
+ */
+export type WarpTable = ReadonlyArray<readonly [number, number]>;
+//# sourceMappingURL=types.d.ts.map

package/dist/services/dye/wheels/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/dye/wheels/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEjE,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,gDAAgD;IAChD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,QAAQ,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACtF,4EAA4E;IAC5E,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,QAAQ,EAAE,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC"}

package/dist/services/dye/wheels/types.js

@@ -0,0 +1,11 @@
+/**
+ * A colour wheel for the Harmony Explorer: how a colour becomes an angle, how
+ * an angle becomes a target colour, and how the ring is painted.
+ *
+ * Every consumer — the web app, the Discord bot, the OG card — reads wheels
+ * from this package and holds no list of its own (spec §2).
+ *
+ * @module services/dye/wheels/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/dye/wheels/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/services/dye/wheels/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/services/localization/LocaleLoader.d.ts

@@ -18,6 +18,14 @@ export declare class LocaleLoader {
      * @returns Locale data
      * @throws {AppError} If locale file fails to load or is invalid
      *
+     * Documentation-only note (2026-09-16 audit, coordinator ruling on
+     * BUG-010's sibling finding): the returned object is the **shared bundled
+     * locale module itself**, not a clone — every caller for a given locale
+     * gets back the same reference. Treat it as read-only. It is not cloned
+     * because there are six locale trees (`en`/`ja`/`de`/`fr`/`ko`/`zh`),
+     * loaded per call, and a deep clone on every lookup would be wasted work
+     * for data that is never legitimately mutated at runtime.
+     *
      * @example
      * ```typescript
      * const loader = new LocaleLoader();

package/dist/services/localization/LocaleLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocaleLoader.d.ts","sourceRoot":"","sources":["../../../src/services/localization/LocaleLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAqBjE;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU;IAuB1C;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;CAkB1B"}
+{"version":3,"file":"LocaleLoader.d.ts","sourceRoot":"","sources":["../../../src/services/localization/LocaleLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAqBjE;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU;IAuB1C;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;CAkB1B"}

package/dist/services/localization/LocaleLoader.js

@@ -34,6 +34,14 @@ export class LocaleLoader {
      * @returns Locale data
      * @throws {AppError} If locale file fails to load or is invalid
      *
+     * Documentation-only note (2026-09-16 audit, coordinator ruling on
+     * BUG-010's sibling finding): the returned object is the **shared bundled
+     * locale module itself**, not a clone — every caller for a given locale
+     * gets back the same reference. Treat it as read-only. It is not cloned
+     * because there are six locale trees (`en`/`ja`/`de`/`fr`/`ko`/`zh`),
+     * loaded per call, and a deep clone on every lookup would be wasted work
+     * for data that is never legitimately mutated at runtime.
+     *
      * @example
      * ```typescript
      * const loader = new LocaleLoader();

package/dist/services/localization/LocaleLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"LocaleLoader.js","sourceRoot":"","sources":["../../../src/services/localization/LocaleLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEzD,2DAA2D;AAC3D,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAExE,yCAAyC;AACzC,MAAM,SAAS,GAAgC;IAC7C,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,YAAY;IACvB;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,MAAkB;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YAE/B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,gCAAgC,CAAC,CAAC;YACrE,CAAC;YAED,qBAAqB;YACrB,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,EAAE,CAAC,CAAC;YACjE,CAAC;YAED,OAAO,IAAkB,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,kBAAkB,EAC5B,0BAA0B,MAAM,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,EAChG,OAAO,CACR,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,iBAAiB,CAAC,IAAa;QACrC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GAAG,IAA+B,CAAC;QAEnD,OAAO,CACL,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ;YACrC,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ;YACnC,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ;YACrC,OAAO,UAAU,CAAC,QAAQ,KAAK,QAAQ;YACvC,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ;YACzC,OAAO,UAAU,CAAC,YAAY,KAAK,QAAQ;YAC3C,OAAO,UAAU,CAAC,YAAY,KAAK,QAAQ;YAC3C,OAAO,UAAU,CAAC,WAAW,KAAK,QAAQ,CAC3C,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"LocaleLoader.js","sourceRoot":"","sources":["../../../src/services/localization/LocaleLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEzD,2DAA2D;AAC3D,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAExE,yCAAyC;AACzC,MAAM,SAAS,GAAgC;IAC7C,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,YAAY;IACvB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CAAC,MAAkB;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YAE/B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,gCAAgC,CAAC,CAAC;YACrE,CAAC;YAED,qBAAqB;YACrB,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,EAAE,CAAC,CAAC;YACjE,CAAC;YAED,OAAO,IAAkB,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,kBAAkB,EAC5B,0BAA0B,MAAM,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,EAChG,OAAO,CACR,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,iBAAiB,CAAC,IAAa;QACrC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GAAG,IAA+B,CAAC;QAEnD,OAAO,CACL,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ;YACrC,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ;YACnC,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ;YACrC,OAAO,UAAU,CAAC,QAAQ,KAAK,QAAQ;YACvC,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ;YACzC,OAAO,UAAU,CAAC,YAAY,KAAK,QAAQ;YAC3C,OAAO,UAAU,CAAC,YAAY,KAAK,QAAQ;YAC3C,OAAO,UAAU,CAAC,WAAW,KAAK,QAAQ,CAC3C,CAAC;IACJ,CAAC;CACF"}

package/dist/services/localization/LocaleRegistry.d.ts

@@ -44,6 +44,15 @@ export declare class LocaleRegistry {
      * @param locale - Locale code to retrieve
      * @returns Locale data if cached, null otherwise
      *
+     * Documentation-only note (2026-09-16 audit, coordinator ruling on
+     * BUG-010's sibling finding): this returns the **shared bundled locale
+     * module** registered via {@link registerLocale} (itself the same object
+     * `LocaleLoader.loadLocale` returned) — every caller retrieving a given
+     * locale gets back the same reference. Treat it as read-only; it is not
+     * cloned per lookup for the same reason `LocaleLoader` doesn't clone per
+     * load — six locale trees is real work to redo on every read for data
+     * that is never legitimately mutated at runtime.
+     *
      * @example
      * ```typescript
      * const jaData = registry.getLocale('ja');

package/dist/services/localization/LocaleRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocaleRegistry.d.ts","sourceRoot":"","sources":["../../../src/services/localization/LocaleRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA0C;IAEzD;;;;;;;;;;OAUG;IACH,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAItC;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO;IAItC;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI;IAIhD;;;;;;;;OAQG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}
+{"version":3,"file":"LocaleRegistry.d.ts","sourceRoot":"","sources":["../../../src/services/localization/LocaleRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA0C;IAEzD;;;;;;;;;;OAUG;IACH,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAItC;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO;IAItC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI;IAIhD;;;;;;;;OAQG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/services/localization/LocaleRegistry.js

@@ -47,6 +47,15 @@ export class LocaleRegistry {
      * @param locale - Locale code to retrieve
      * @returns Locale data if cached, null otherwise
      *
+     * Documentation-only note (2026-09-16 audit, coordinator ruling on
+     * BUG-010's sibling finding): this returns the **shared bundled locale
+     * module** registered via {@link registerLocale} (itself the same object
+     * `LocaleLoader.loadLocale` returned) — every caller retrieving a given
+     * locale gets back the same reference. Treat it as read-only; it is not
+     * cloned per lookup for the same reason `LocaleLoader` doesn't clone per
+     * load — six locale trees is real work to redo on every read for data
+     * that is never legitimately mutated at runtime.
+     *
      * @example
      * ```typescript
      * const jaData = registry.getLocale('ja');

package/dist/services/localization/LocaleRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"LocaleRegistry.js","sourceRoot":"","sources":["../../../src/services/localization/LocaleRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,OAAO,cAAc;IACjB,OAAO,GAAgC,IAAI,GAAG,EAAE,CAAC;IAEzD;;;;;;;;;;OAUG;IACH,cAAc,CAAC,IAAgB;QAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,MAAkB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,MAAkB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF"}
+{"version":3,"file":"LocaleRegistry.js","sourceRoot":"","sources":["../../../src/services/localization/LocaleRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,OAAO,cAAc;IACjB,OAAO,GAAgC,IAAI,GAAG,EAAE,CAAC;IAEzD;;;;;;;;;;OAUG;IACH,cAAc,CAAC,IAAgB;QAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,MAAkB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAS,CAAC,MAAkB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF"}

package/dist/services/localization/TranslationProvider.d.ts

@@ -6,7 +6,7 @@
  *
  * @module services/localization
  */
-import type { LocaleCode, TranslationKey, HarmonyTypeKey, VisionType, ToolKey, SheetKey, RaceKey, ClanKey } from '@xivdyetools/types';
+import type { LocaleCode, TranslationKey, HarmonyTypeKey, VisionType, ToolKey, SheetKey, RaceKey, ClanKey, ColorWheelId } from '@xivdyetools/types';
 import type { LocaleRegistry } from './LocaleRegistry.js';
 /**
  * Provides translations with automatic fallback to English
@@ -112,6 +112,11 @@ export declare class TranslationProvider {
      * ```
      */
     getHarmonyType(key: HarmonyTypeKey, locale: LocaleCode): string;
+    /**
+     * Localised display name of a Harmony Explorer colour wheel, with English
+     * fallback and finally the id itself, mirroring {@link getHarmonyType}.
+     */
+    getColorWheelName(id: ColorWheelId, locale: LocaleCode): string;
     /**
      * Get vision type with fallback
      *

package/dist/services/localization/TranslationProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TranslationProvider.d.ts","sourceRoot":"","sources":["../../../src/services/localization/TranslationProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,OAAO,EACP,QAAQ,EACR,OAAO,EACP,OAAO,EACR,MAAM,oBAAoB,CAAC;AAM5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,cAAc;IAE5C;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAqBzD;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IA+B7D;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoBzD;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoB/D;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoBzD;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoB/D;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoB1D;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAiB3D;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAiBrD;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAiBvD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoBjD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoBjD;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAyB5D;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,SAAS;CAMlB"}
+{"version":3,"file":"TranslationProvider.d.ts","sourceRoot":"","sources":["../../../src/services/localization/TranslationProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,OAAO,EACP,QAAQ,EACR,OAAO,EACP,OAAO,EACP,YAAY,EAEb,MAAM,oBAAoB,CAAC;AAM5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,cAAc;IAE5C;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAqBzD;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IA+B7D;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoBzD;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoB/D;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoBzD;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoB/D;;;OAGG;IACH,iBAAiB,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAM/D;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoB1D;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAiB3D;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAiBrD;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAiBvD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoBjD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoBjD;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAyB5D;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,SAAS;CAMlB"}