@xivdyetools/core 5.1.0 → 5.2.0

package/dist/services/dye/HarmonySelector.js

@@ -28,6 +28,7 @@
  */
 import { HARMONY_OFFSETS } from '../../constants/index.js';
 import { ColorService } from '../ColorService.js';
+import { DEFAULT_COLOR_WHEEL, getColorWheel } from './wheels/ColorWheel.js';
 /**
  * The single definition of "how far is this dye from the slot's target".
  *
@@ -91,7 +92,17 @@ export function generateHarmonySlots(baseHex, harmonyType, candidates, config, o
     if (!isKnownHarmonyType(harmonyType))
         return [];
     const offsets = HARMONY_OFFSETS[harmonyType];
-    const baseHsv = ColorService.hexToHsv(baseHex);
+    const wheel = getColorWheel(config.wheel ?? DEFAULT_COLOR_WHEEL);
+    // A wheel that keeps the base's OKLab L and C instead of its HSV S/V has no
+    // meaningful hue-distance ranking: scoring by degrees against `targetHue`
+    // throws away the lightness the wheel was chosen for, and returns a partner
+    // at some other lightness entirely. Built once, used for every scoring call
+    // below (pins included) so a slot can never be scored in different units
+    // from its neighbours — the BUG-064 rule.
+    const effective = wheel.carriesBaseHsv
+        ? config
+        : { ...config, usePerceptualMatching: true };
+    const baseWheelHue = wheel.hueOf(baseHex);
     const companionCount = config.companionCount ?? 0;
     const preventDuplicates = config.preventDuplicates ?? false;
     // Two different questions, and they were one set until 2026-09-03.
@@ -116,12 +127,12 @@ export function generateHarmonySlots(baseHex, harmonyType, candidates, config, o
     const slots = [];
     offsets.forEach((offset, index) => {
         const normalisedOffset = ((offset % 360) + 360) % 360;
-        const targetHue = (baseHsv.h + normalisedOffset) % 360;
-        // The ideal carries the BASE's saturation and value onto the rotated hue.
-        // That is the whole reason a desaturated base finds desaturated dyes, and
-        // the single biggest difference from the per-type find*Dyes() methods.
-        const targetHex = ColorService.hsvToHex(targetHue, baseHsv.s, baseHsv.v);
-        const ranked = rankCandidates(candidates, targetHue, targetHex, config);
+        const wheelHue = (baseWheelHue + normalisedOffset) % 360;
+        // The wheel builds the ideal. Warp wheels carry the BASE's saturation and
+        // value onto the mapped hue — the whole reason a desaturated base finds
+        // desaturated dyes; the constant-lightness wheel carries L and C instead.
+        const { targetHex, targetHue } = wheel.target(baseHex, wheelHue);
+        const ranked = rankCandidates(candidates, targetHue, targetHex, effective);
         const pin = options?.pinned?.get(index);
         // Every branch below assigns, so no initialiser: an unread `= null` here
         // would be one more place for a future edit to leave a slot silently empty.
@@ -129,7 +140,7 @@ export function generateHarmonySlots(baseHex, harmonyType, candidates, config, o
         if (pin) {
             // An explicit hand-swap wins its slot outright, exclusions included: the
             // user naming a dye outranks our guess about which dyes are eligible.
-            chosen = { dye: pin, deviance: devianceFor(pin, targetHue, targetHex, config) };
+            chosen = { dye: pin, deviance: devianceFor(pin, targetHue, targetHex, effective) };
         }
         else if (preventDuplicates) {
             // First eligible-and-unused, else the nearest eligible even if already
@@ -165,6 +176,7 @@ export function generateHarmonySlots(baseHex, harmonyType, candidates, config, o
             index,
             offset: normalisedOffset,
             targetHue,
+            wheelHue,
             targetHex,
             dye: chosen?.dye ?? null,
             deviance: chosen?.deviance ?? 0,

package/dist/services/dye/HarmonySelector.js.map

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

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

@@ -0,0 +1,29 @@
+/**
+ * The colour-wheel registry — the ONE list every surface reads.
+ *
+ * @module services/dye/wheels/ColorWheel
+ */
+import type { ColorWheelId } from '@xivdyetools/types';
+import type { ColorWheel } from './types.js';
+export type { ColorWheel } from './types.js';
+/** Display order. `rgb` first, and the default. */
+export declare const COLOR_WHEEL_IDS: readonly ["rgb", "ryb", "munsell", "oklch-hue", "oklch-lightness"];
+export declare const DEFAULT_COLOR_WHEEL: ColorWheelId;
+export declare function isColorWheelId(value: unknown): value is ColorWheelId;
+/** Lower-cased, trimmed id when recognised; undefined for anything else (absent, empty, unknown). */
+export declare function parseColorWheelId(value: unknown): ColorWheelId | undefined;
+/** `parseColorWheelId(value) ?? DEFAULT_COLOR_WHEEL` — "absent or unknown means rgb", in one place. */
+export declare function normalizeColorWheelId(value: unknown): ColorWheelId;
+/**
+ * The short tag each wheel prints in a card footer. Identifiers, never
+ * localised — the OG footer tag sits beside `algoTag`, which is the same kind
+ * of token, and a translated one would make two cards of the same wheel
+ * unrecognisable as such.
+ */
+export declare const COLOR_WHEEL_TAGS: Record<ColorWheelId, string>;
+/**
+ * Own-property lookup: the id arrives from a share URL, and
+ * `WHEELS['toString']` would be truthy under a plain index.
+ */
+export declare function getColorWheel(id: ColorWheelId): ColorWheel;
+//# sourceMappingURL=ColorWheel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ColorWheel.d.ts","sourceRoot":"","sources":["../../../../src/services/dye/wheels/ColorWheel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,mDAAmD;AACnD,eAAO,MAAM,eAAe,oEAMgB,CAAC;AAE7C,eAAO,MAAM,mBAAmB,EAAE,YAAoB,CAAC;AAEvD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED,qGAAqG;AACrG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAI1E;AAED,uGAAuG;AACvG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAElE;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAMzD,CAAC;AAUF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,UAAU,CAK1D"}

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

@@ -0,0 +1,63 @@
+/**
+ * The colour-wheel registry — the ONE list every surface reads.
+ *
+ * @module services/dye/wheels/ColorWheel
+ */
+import { MUNSELL_WHEEL } from './munsell.js';
+import { OKLCH_HUE_WHEEL } from './oklch-hue.js';
+import { OKLCH_LIGHTNESS_WHEEL } from './oklch-lightness.js';
+import { RGB_WHEEL, RYB_WHEEL } from './rgb-ryb.js';
+/** Display order. `rgb` first, and the default. */
+export const COLOR_WHEEL_IDS = [
+    'rgb',
+    'ryb',
+    'munsell',
+    'oklch-hue',
+    'oklch-lightness',
+];
+export const DEFAULT_COLOR_WHEEL = 'rgb';
+export function isColorWheelId(value) {
+    return typeof value === 'string' && COLOR_WHEEL_IDS.includes(value);
+}
+/** Lower-cased, trimmed id when recognised; undefined for anything else (absent, empty, unknown). */
+export function parseColorWheelId(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const v = value.trim().toLowerCase();
+    return isColorWheelId(v) ? v : undefined;
+}
+/** `parseColorWheelId(value) ?? DEFAULT_COLOR_WHEEL` — "absent or unknown means rgb", in one place. */
+export function normalizeColorWheelId(value) {
+    return parseColorWheelId(value) ?? DEFAULT_COLOR_WHEEL;
+}
+/**
+ * The short tag each wheel prints in a card footer. Identifiers, never
+ * localised — the OG footer tag sits beside `algoTag`, which is the same kind
+ * of token, and a translated one would make two cards of the same wheel
+ * unrecognisable as such.
+ */
+export const COLOR_WHEEL_TAGS = {
+    rgb: 'RGB',
+    ryb: 'RYB',
+    munsell: 'MUNSELL',
+    'oklch-hue': 'OKLCH·H',
+    'oklch-lightness': 'OKLCH·L',
+};
+const WHEELS = {
+    rgb: RGB_WHEEL,
+    ryb: RYB_WHEEL,
+    munsell: MUNSELL_WHEEL,
+    'oklch-hue': OKLCH_HUE_WHEEL,
+    'oklch-lightness': OKLCH_LIGHTNESS_WHEEL,
+};
+/**
+ * Own-property lookup: the id arrives from a share URL, and
+ * `WHEELS['toString']` would be truthy under a plain index.
+ */
+export function getColorWheel(id) {
+    if (!Object.hasOwn(WHEELS, id)) {
+        throw new RangeError(`Unknown colour wheel: ${String(id)}`);
+    }
+    return WHEELS[id];
+}
+//# sourceMappingURL=ColorWheel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ColorWheel.js","sourceRoot":"","sources":["../../../../src/services/dye/wheels/ColorWheel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAKpD,mDAAmD;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK;IACL,KAAK;IACL,SAAS;IACT,WAAW;IACX,iBAAiB;CACyB,CAAC;AAE7C,MAAM,CAAC,MAAM,mBAAmB,GAAiB,KAAK,CAAC;AAEvD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,eAAqC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7F,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3C,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,iBAAiB,CAAC,KAAK,CAAC,IAAI,mBAAmB,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiC;IAC5D,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,SAAS;IACtB,iBAAiB,EAAE,SAAS;CAC7B,CAAC;AAEF,MAAM,MAAM,GAA+C;IACzD,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,aAAa;IACtB,WAAW,EAAE,eAAe;IAC5B,iBAAiB,EAAE,qBAAqB;CACzC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAAgB;IAC5C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,UAAU,CAAC,yBAAyB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,40 @@
+/**
+ * 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 type { ColorWheel, ColorWheelId, WarpTable } from './types.js';
+/**
+ * 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 declare function assertMonotoneTable(table: WarpTable, id: string): void;
+/** sRGB/HSV hue → wheel angle. */
+export declare function toWheelHue(table: WarpTable, hsvHue: number): number;
+/** Wheel angle → sRGB/HSV hue. */
+export declare function fromWheelHue(table: WarpTable, wheelHue: number): number;
+export interface NormalizeOptions {
+    /** Largest running-max correction tolerated, in degrees. Default 1. */
+    maxCorrectionDeg?: number;
+}
+/**
+ * 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 declare function normalizeWarpTable(raw: ReadonlyArray<readonly [number, number]>, id: string, options?: NormalizeOptions): WarpTable;
+/** Build a wheel from a table. Throws at construction on a bad table. */
+export declare function hueWarpWheel(id: ColorWheelId, table: WarpTable): ColorWheel;
+//# sourceMappingURL=hue-warp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hue-warp.d.ts","sourceRoot":"","sources":["../../../../src/services/dye/wheels/hue-warp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAItE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAiBtE;AAkBD,kCAAkC;AAClC,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,kCAAkC;AAClC,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC7C,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAoDX;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,CAuB3E"}

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"}