react-cheminfo 0.9.0 → 0.10.0

package/lib/color/core/gradient.d.ts

@@ -0,0 +1,15 @@
+import type { ColorScale } from './interpolate.ts';
+/**
+ * A colour scale written as the CSS gradient that draws it.
+ *
+ * The scale is sampled rather than handed over as its anchors, because a
+ * browser only interpolates the straight line between two colours: a scale
+ * that turns around the colour wheel would otherwise be drawn as the grey
+ * shortcut across it.
+ * @param scale - The scale to draw, from its low end at the left.
+ * @param samples - How many colours to write out; more of them for a scale that turns.
+ * @returns The `linear-gradient(…)` value.
+ * @throws {Error} When the scale has no anchor, or one of them is not a hex colour.
+ */
+export declare function colorScaleGradient(scale: ColorScale, samples: number): string;
+//# sourceMappingURL=gradient.d.ts.map

package/lib/color/core/gradient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient.d.ts","sourceRoot":"","sources":["../../../src/color/core/gradient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAU7E"}

package/lib/color/core/gradient.js

@@ -0,0 +1,28 @@
+import { sampleScale } from "./interpolate.js";
+const PERCENT = 100;
+const DECIMALS = 2;
+/**
+ * A colour scale written as the CSS gradient that draws it.
+ *
+ * The scale is sampled rather than handed over as its anchors, because a
+ * browser only interpolates the straight line between two colours: a scale
+ * that turns around the colour wheel would otherwise be drawn as the grey
+ * shortcut across it.
+ * @param scale - The scale to draw, from its low end at the left.
+ * @param samples - How many colours to write out; more of them for a scale that turns.
+ * @returns The `linear-gradient(…)` value.
+ * @throws {Error} When the scale has no anchor, or one of them is not a hex colour.
+ */
+export function colorScaleGradient(scale, samples) {
+    const colors = sampleScale(scale, samples);
+    const last = colors.length - 1;
+    const stops = [];
+    for (let index = 0; index < colors.length; index++) {
+        const color = colors[index];
+        if (color === undefined)
+            continue;
+        stops.push(`${color} ${((index / last) * PERCENT).toFixed(DECIMALS)}%`);
+    }
+    return `linear-gradient(to right, ${stops.join(', ')})`;
+}
+//# sourceMappingURL=gradient.js.map

package/lib/color/core/gradient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient.js","sourceRoot":"","sources":["../../../src/color/core/gradient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,OAAO,GAAG,GAAG,CAAC;AACpB,MAAM,QAAQ,GAAG,CAAC,CAAC;AAEnB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAiB,EAAE,OAAe;IACnE,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,6BAA6B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAC1D,CAAC"}

package/lib/color/core/hsv.d.ts

@@ -0,0 +1,38 @@
+import type { RgbColor } from './hex.ts';
+/**
+ * A colour in the HSV model — HSB in a drawing program, the same three numbers.
+ *
+ * It is the model a scale is customised in: hue says which colour, and the two
+ * others say how strong and how bright it is, so an author moves along the
+ * wheel without having to think in red, green and blue at once.
+ */
+export interface HsvColor {
+    /** Where it sits on the wheel, in degrees from 0 to 360. Zero on a grey. */
+    hue: number;
+    /** How far it is from grey, from 0 to 1. */
+    saturation: number;
+    /** How bright it is, from 0 for black to 1. */
+    value: number;
+}
+/**
+ * Read three channels as a hue, a saturation and a value.
+ * @param color - The three channels, each from 0 to 255.
+ * @returns The same colour in the HSV model.
+ */
+export declare function rgbToHsv(color: RgbColor): HsvColor;
+/**
+ * Write a hue, a saturation and a value back as three channels.
+ *
+ * The hue is wrapped rather than clamped, so a scale may run past 360 or below
+ * zero and still land on the colour that turn of the wheel names.
+ * @param color - The colour in the HSV model.
+ * @returns The three channels, each from 0 to 255.
+ */
+export declare function hsvToRgb(color: HsvColor): RgbColor;
+/**
+ * A hue brought inside one turn of the wheel.
+ * @param hue - Any angle in degrees, negative or past 360.
+ * @returns The same angle, from 0 up to but not including 360.
+ */
+export declare function wrapHue(hue: number): number;
+//# sourceMappingURL=hsv.d.ts.map

package/lib/color/core/hsv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hsv.d.ts","sourceRoot":"","sources":["../../../src/color/core/hsv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAMzC;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAWlD;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAgBlD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG3C"}

package/lib/color/core/hsv.js

@@ -0,0 +1,92 @@
+const TURN = 360;
+const SECTOR = 60;
+const MAXIMUM_CHANNEL = 255;
+/**
+ * Read three channels as a hue, a saturation and a value.
+ * @param color - The three channels, each from 0 to 255.
+ * @returns The same colour in the HSV model.
+ */
+export function rgbToHsv(color) {
+    const red = channel(color.red);
+    const green = channel(color.green);
+    const blue = channel(color.blue);
+    const value = Math.max(red, green, blue);
+    const chroma = value - Math.min(red, green, blue);
+    return {
+        hue: hueOf(red, green, blue, value, chroma),
+        saturation: value === 0 ? 0 : chroma / value,
+        value,
+    };
+}
+/**
+ * Write a hue, a saturation and a value back as three channels.
+ *
+ * The hue is wrapped rather than clamped, so a scale may run past 360 or below
+ * zero and still land on the colour that turn of the wheel names.
+ * @param color - The colour in the HSV model.
+ * @returns The three channels, each from 0 to 255.
+ */
+export function hsvToRgb(color) {
+    const hue = wrapHue(color.hue) / SECTOR;
+    const saturation = unit(color.saturation);
+    const value = unit(color.value);
+    const sector = Math.floor(hue) % 6;
+    const offset = hue - Math.floor(hue);
+    const low = value * (1 - saturation);
+    const falling = value * (1 - saturation * offset);
+    const rising = value * (1 - saturation * (1 - offset));
+    if (sector === 0)
+        return scale(value, rising, low);
+    if (sector === 1)
+        return scale(falling, value, low);
+    if (sector === 2)
+        return scale(low, value, rising);
+    if (sector === 3)
+        return scale(low, falling, value);
+    if (sector === 4)
+        return scale(rising, low, value);
+    return scale(value, low, falling);
+}
+/**
+ * A hue brought inside one turn of the wheel.
+ * @param hue - Any angle in degrees, negative or past 360.
+ * @returns The same angle, from 0 up to but not including 360.
+ */
+export function wrapHue(hue) {
+    if (!Number.isFinite(hue))
+        return 0;
+    return ((hue % TURN) + TURN) % TURN;
+}
+function hueOf(red, green, blue, value, chroma) {
+    if (chroma === 0)
+        return 0;
+    let hue;
+    if (value === red) {
+        hue = (green - blue) / chroma;
+    }
+    else if (value === green) {
+        hue = 2 + (blue - red) / chroma;
+    }
+    else {
+        hue = 4 + (red - green) / chroma;
+    }
+    return wrapHue(hue * SECTOR);
+}
+function scale(red, green, blue) {
+    return {
+        red: red * MAXIMUM_CHANNEL,
+        green: green * MAXIMUM_CHANNEL,
+        blue: blue * MAXIMUM_CHANNEL,
+    };
+}
+function channel(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.min(1, Math.max(0, value / MAXIMUM_CHANNEL));
+}
+function unit(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.min(1, Math.max(0, value));
+}
+//# sourceMappingURL=hsv.js.map

package/lib/color/core/hsv.js.map

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

package/lib/color/core/index.d.ts

@@ -1,5 +1,16 @@
 export type { ReadableInkOptions } from './contrast.ts';
 export { contrastRatio, readableInk, relativeLuminance } from './contrast.ts';
-export type { PositionInRangeOptions, Swatch } from './scale.ts';
+export type { RgbColor } from './hex.ts';
+export { parseHexColor, toHexColor } from './hex.ts';
+export { colorScaleGradient } from './gradient.ts';
+export type { HsvColor } from './hsv.ts';
+export { hsvToRgb, rgbToHsv, wrapHue } from './hsv.ts';
+export type { ColorInterpolation, ColorScale, ColorStop, Swatch, } from './interpolate.ts';
+export { colorAt, evenScale, sampleScale, swatchAt } from './interpolate.ts';
+export type { PositionInRangeOptions } from './scale.ts';
 export { VIRIDIS_SCALE, colorFromScale, positionInRange, swatchFromScale, } from './scale.ts';
+export type { ColorScaleKind, NamedColorScale } from './scales.ts';
+export { COLOR_SCALES, COLOR_SCALE_KIND_LABELS, DEFAULT_COLOR_SCALE_ID, colorScaleById, } from './scales.ts';
+export type { ResolvedColorScale } from './scaleText.ts';
+export { MAXIMUM_CUSTOM_STOPS, formatColorScale, parseColorScale, resolveColorScale, } from './scaleText.ts';
 //# sourceMappingURL=index.d.ts.map

package/lib/color/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/color/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC9E,YAAY,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EACL,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/color/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC9E,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACvD,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,MAAM,GACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7E,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/lib/color/core/index.js

@@ -1,3 +1,9 @@
 export { contrastRatio, readableInk, relativeLuminance } from "./contrast.js";
+export { parseHexColor, toHexColor } from "./hex.js";
+export { colorScaleGradient } from "./gradient.js";
+export { hsvToRgb, rgbToHsv, wrapHue } from "./hsv.js";
+export { colorAt, evenScale, sampleScale, swatchAt } from "./interpolate.js";
 export { VIRIDIS_SCALE, colorFromScale, positionInRange, swatchFromScale, } from "./scale.js";
+export { COLOR_SCALES, COLOR_SCALE_KIND_LABELS, DEFAULT_COLOR_SCALE_ID, colorScaleById, } from "./scales.js";
+export { MAXIMUM_CUSTOM_STOPS, formatColorScale, parseColorScale, resolveColorScale, } from "./scaleText.js";
 //# sourceMappingURL=index.js.map

package/lib/color/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/color/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,EACL,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/color/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAOvD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE7E,OAAO,EACL,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/lib/color/core/interpolate.d.ts

@@ -0,0 +1,67 @@
+import type { ReadableInkOptions } from './contrast.ts';
+/** A colour, and the ink that stays readable on it. */
+export interface Swatch {
+    /** The colour behind the value. */
+    background: string;
+    /** The ink to write the value in. */
+    foreground: string;
+}
+/** One anchor of a colour scale: a colour, and where it sits. */
+export interface ColorStop {
+    /** Where it sits on the scale, from 0 for its low end to 1 for its high end. */
+    position: number;
+    /** The colour there, as `#rgb` or `#rrggbb`. */
+    color: string;
+}
+/**
+ * The path a scale takes from one anchor to the next.
+ *
+ * - `rgb` mixes the three channels, which is what a browser gradient does and
+ *   what a perceptual map such as viridis is sampled for.
+ * - `hsv` turns along the colour wheel the short way round, so two anchors
+ *   already describe a ramp that keeps its saturation instead of fading
+ *   through the grey in the middle of the straight line between them.
+ * - `hsv-long` turns the other way round, which is how two anchors of the same
+ *   hue draw a full rainbow.
+ */
+export type ColorInterpolation = 'rgb' | 'hsv' | 'hsv-long';
+/** A colour scale: its anchors, and how it moves between them. */
+export interface ColorScale {
+    /** The anchors, in ascending position order. */
+    stops: readonly ColorStop[];
+    /** How it moves from one anchor to the next. */
+    interpolation: ColorInterpolation;
+}
+/**
+ * A scale whose colours are spread evenly from one end to the other.
+ * @param colors - The colours, from the low end to the high end.
+ * @param interpolation - The path between them.
+ * @returns The scale they describe.
+ */
+export declare function evenScale(colors: readonly string[], interpolation?: ColorInterpolation): ColorScale;
+/**
+ * The colour a scale takes at a position.
+ * @param scale - The scale to read, its anchors in ascending position order.
+ * @param position - Where to read it, from 0 to 1; anything outside is clamped.
+ * @returns The colour there, as `#rrggbb`.
+ * @throws {Error} When the scale has no anchor, or one of them is not a hex colour.
+ */
+export declare function colorAt(scale: ColorScale, position: number): string;
+/**
+ * The colour a scale takes at a position, with the ink to write on it.
+ * @param scale - The scale to read.
+ * @param position - Where to read it, from 0 to 1; anything outside is clamped.
+ * @param options - See {@link ReadableInkOptions}.
+ * @returns The background and the readable ink.
+ * @throws {Error} When the scale has no anchor, or one of them is not a hex colour.
+ */
+export declare function swatchAt(scale: ColorScale, position: number, options?: ReadableInkOptions): Swatch;
+/**
+ * A scale read at evenly spaced positions, for a gradient or a legend.
+ * @param scale - The scale to read.
+ * @param count - How many colours to take, both ends included; fewer than two is read as two.
+ * @returns The colours, from the low end to the high end.
+ * @throws {Error} When the scale has no anchor, or one of them is not a hex colour.
+ */
+export declare function sampleScale(scale: ColorScale, count: number): string[];
+//# sourceMappingURL=interpolate.d.ts.map

package/lib/color/core/interpolate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../../../src/color/core/interpolate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AASxD,uDAAuD;AACvD,MAAM,WAAW,MAAM;IACrB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,CAAC;AAE5D,kEAAkE;AAClE,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,gDAAgD;IAChD,aAAa,EAAE,kBAAkB,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,aAAa,GAAE,kBAA0B,GACxC,UAAU,CASZ;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAwBnE;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAGR;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAStE"}

package/lib/color/core/interpolate.js

@@ -0,0 +1,121 @@
+import { readableInk } from "./contrast.js";
+import { parseHexColor, toHexColor } from "./hex.js";
+import { hsvToRgb, rgbToHsv, wrapHue } from "./hsv.js";
+const HALF_TURN = 180;
+const TURN = 360;
+const MINIMUM_SAMPLES = 2;
+/**
+ * A scale whose colours are spread evenly from one end to the other.
+ * @param colors - The colours, from the low end to the high end.
+ * @param interpolation - The path between them.
+ * @returns The scale they describe.
+ */
+export function evenScale(colors, interpolation = 'rgb') {
+    const stops = [];
+    const last = colors.length - 1;
+    for (let index = 0; index < colors.length; index++) {
+        const color = colors[index];
+        if (color === undefined)
+            continue;
+        stops.push({ position: last <= 0 ? 0 : index / last, color });
+    }
+    return { stops, interpolation };
+}
+/**
+ * The colour a scale takes at a position.
+ * @param scale - The scale to read, its anchors in ascending position order.
+ * @param position - Where to read it, from 0 to 1; anything outside is clamped.
+ * @returns The colour there, as `#rrggbb`.
+ * @throws {Error} When the scale has no anchor, or one of them is not a hex colour.
+ */
+export function colorAt(scale, position) {
+    const { stops, interpolation } = scale;
+    if (stops.length === 0) {
+        throw new Error('a colour scale needs at least one stop');
+    }
+    const at = clampUnit(position);
+    const first = stops[0];
+    const last = stops.at(-1);
+    if (first === undefined || last === undefined) {
+        throw new Error(`no colour at position ${String(position)}`);
+    }
+    if (at <= first.position)
+        return toHexColor(parseHexColor(first.color));
+    if (at >= last.position)
+        return toHexColor(parseHexColor(last.color));
+    for (let index = 1; index < stops.length; index++) {
+        const start = stops[index - 1];
+        const end = stops[index];
+        if (start === undefined || end === undefined)
+            continue;
+        if (at > end.position)
+            continue;
+        const span = end.position - start.position;
+        const ratio = span <= 0 ? 0 : (at - start.position) / span;
+        return mix(start.color, end.color, ratio, interpolation);
+    }
+    return toHexColor(parseHexColor(last.color));
+}
+/**
+ * The colour a scale takes at a position, with the ink to write on it.
+ * @param scale - The scale to read.
+ * @param position - Where to read it, from 0 to 1; anything outside is clamped.
+ * @param options - See {@link ReadableInkOptions}.
+ * @returns The background and the readable ink.
+ * @throws {Error} When the scale has no anchor, or one of them is not a hex colour.
+ */
+export function swatchAt(scale, position, options = {}) {
+    const background = colorAt(scale, position);
+    return { background, foreground: readableInk(background, options) };
+}
+/**
+ * A scale read at evenly spaced positions, for a gradient or a legend.
+ * @param scale - The scale to read.
+ * @param count - How many colours to take, both ends included; fewer than two is read as two.
+ * @returns The colours, from the low end to the high end.
+ * @throws {Error} When the scale has no anchor, or one of them is not a hex colour.
+ */
+export function sampleScale(scale, count) {
+    const total = Number.isFinite(count)
+        ? Math.max(MINIMUM_SAMPLES, Math.floor(count))
+        : MINIMUM_SAMPLES;
+    const colors = [];
+    for (let index = 0; index < total; index++) {
+        colors.push(colorAt(scale, index / (total - 1)));
+    }
+    return colors;
+}
+function mix(start, end, ratio, interpolation) {
+    const from = parseHexColor(start);
+    const to = parseHexColor(end);
+    if (interpolation === 'rgb') {
+        return toHexColor({
+            red: from.red + (to.red - from.red) * ratio,
+            green: from.green + (to.green - from.green) * ratio,
+            blue: from.blue + (to.blue - from.blue) * ratio,
+        });
+    }
+    const one = rgbToHsv(from);
+    const other = rgbToHsv(to);
+    const hue = one.hue + hueStep(one.hue, other.hue, interpolation) * ratio;
+    return toHexColor(hsvToRgb({
+        hue: wrapHue(hue),
+        saturation: one.saturation + (other.saturation - one.saturation) * ratio,
+        value: one.value + (other.value - one.value) * ratio,
+    }));
+}
+function hueStep(from, to, interpolation) {
+    const short = (((to - from) % TURN) + TURN + HALF_TURN) % TURN;
+    const shortest = short - HALF_TURN;
+    if (interpolation !== 'hsv-long')
+        return shortest;
+    // Two anchors of the same hue are a full turn apart the long way round,
+    // which is what draws a rainbow from one colour back to itself.
+    return shortest > 0 ? shortest - TURN : shortest + TURN;
+}
+function clampUnit(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.min(1, Math.max(0, value));
+}
+//# sourceMappingURL=interpolate.js.map

package/lib/color/core/interpolate.js.map

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

package/lib/color/core/scale.d.ts

@@ -1,18 +1,14 @@
 import type { ReadableInkOptions } from './contrast.ts';
+import type { Swatch } from './interpolate.ts';
+export type { Swatch } from './interpolate.ts';
 /**
  * Viridis, sampled at nine stops.
  *
  * It stays readable under the common colour deficiencies and is monotone in
  * lightness, so a greyscale print of the same figure still orders the values.
+ * It is the default of `COLOR_SCALES`, which is where the others are.
  */
 export declare const VIRIDIS_SCALE: readonly string[];
-/** A colour, and the ink that stays readable on it. */
-export interface Swatch {
-    /** The colour behind the value. */
-    background: string;
-    /** The ink to write the value in. */
-    foreground: string;
-}
 /** How {@link positionInRange} places a value. */
 export interface PositionInRangeOptions {
     /**
@@ -33,20 +29,20 @@ export interface PositionInRangeOptions {
  */
 export declare function positionInRange(value: number, min: number, max: number, options?: PositionInRangeOptions): number;
 /**
- * The colour a scale takes at a position, interpolated between its stops.
- * @param stops - The scale's colours, from its low end to its high end, as `#rgb` or `#rrggbb`.
- * @param position - Where on the scale to read, from 0 to 1; anything outside is clamped.
+ * The colour a list of evenly spread colours takes at a position.
+ * @param stops - The colours, from the low end to the high end, as `#rgb` or `#rrggbb`.
+ * @param position - Where to read, from 0 to 1; anything outside is clamped.
  * @returns The colour at that position, as `#rrggbb`.
- * @throws {Error} When the scale has no stops, or a stop is not a hex colour.
+ * @throws {Error} When the list is empty, or a colour is not a hex colour.
  */
 export declare function colorFromScale(stops: readonly string[], position: number): string;
 /**
- * The colour a scale takes at a position, together with the ink to write on it.
- * @param stops - The scale's colours, from its low end to its high end.
- * @param position - Where on the scale to read, from 0 to 1; anything outside is clamped.
+ * The colour a list of evenly spread colours takes, with the ink to write on it.
+ * @param stops - The colours, from the low end to the high end.
+ * @param position - Where to read, from 0 to 1; anything outside is clamped.
  * @param options - See {@link ReadableInkOptions}.
  * @returns The background and the readable ink.
- * @throws {Error} When the scale has no stops, or a stop is not a hex colour.
+ * @throws {Error} When the list is empty, or a colour is not a hex colour.
  */
 export declare function swatchFromScale(stops: readonly string[], position: number, options?: ReadableInkOptions): Swatch;
 //# sourceMappingURL=scale.d.ts.map

package/lib/color/core/scale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scale.d.ts","sourceRoot":"","sources":["../../../src/color/core/scale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAIxD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAU1C,CAAC;AAEF,uDAAuD;AACvD,MAAM,WAAW,MAAM;IACrB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,sBAA2B,GACnC,MAAM,CAkBR;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,MAAM,GACf,MAAM,CAmBR;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAGR"}
+{"version":3,"file":"scale.d.ts","sourceRoot":"","sources":["../../../src/color/core/scale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI/C,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAAmB,CAAC;AAE/D,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,sBAA2B,GACnC,MAAM,CAkBR;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAER"}

package/lib/color/core/scale.js

@@ -1,22 +1,13 @@
-import { readableInk } from "./contrast.js";
-import { parseHexColor, toHexColor } from "./hex.js";
+import { colorAt, evenScale, swatchAt } from "./interpolate.js";
+import { VIRIDIS_COLORS } from "./scaleData.js";
 /**
  * Viridis, sampled at nine stops.
  *
  * It stays readable under the common colour deficiencies and is monotone in
  * lightness, so a greyscale print of the same figure still orders the values.
+ * It is the default of `COLOR_SCALES`, which is where the others are.
  */
-export const VIRIDIS_SCALE = [
-    '#440154',
-    '#482878',
-    '#3e4a89',
-    '#31688e',
-    '#26828e',
-    '#1f9e89',
-    '#35b779',
-    '#6dcd59',
-    '#b4de2c',
-];
+export const VIRIDIS_SCALE = VIRIDIS_COLORS;
 /**
  * Where a value sits between two bounds.
  * @param value - The value to place.
@@ -43,43 +34,25 @@ export function positionInRange(value, min, max, options = {}) {
     return clampUnit((Math.log10(Math.max(value, floor)) - Math.log10(floor)) / span);
 }
 /**
- * The colour a scale takes at a position, interpolated between its stops.
- * @param stops - The scale's colours, from its low end to its high end, as `#rgb` or `#rrggbb`.
- * @param position - Where on the scale to read, from 0 to 1; anything outside is clamped.
+ * The colour a list of evenly spread colours takes at a position.
+ * @param stops - The colours, from the low end to the high end, as `#rgb` or `#rrggbb`.
+ * @param position - Where to read, from 0 to 1; anything outside is clamped.
  * @returns The colour at that position, as `#rrggbb`.
- * @throws {Error} When the scale has no stops, or a stop is not a hex colour.
+ * @throws {Error} When the list is empty, or a colour is not a hex colour.
  */
 export function colorFromScale(stops, position) {
-    if (stops.length === 0) {
-        throw new Error('a colour scale needs at least one stop');
-    }
-    const scaled = clampUnit(position) * (stops.length - 1);
-    const lowerIndex = Math.floor(scaled);
-    const start = stops[lowerIndex];
-    const end = stops[Math.min(lowerIndex + 1, stops.length - 1)];
-    if (start === undefined || end === undefined) {
-        throw new Error(`no colour at position ${String(position)}`);
-    }
-    const from = parseHexColor(start);
-    const to = parseHexColor(end);
-    const ratio = scaled - lowerIndex;
-    return toHexColor({
-        red: from.red + (to.red - from.red) * ratio,
-        green: from.green + (to.green - from.green) * ratio,
-        blue: from.blue + (to.blue - from.blue) * ratio,
-    });
+    return colorAt(evenScale(stops), position);
 }
 /**
- * The colour a scale takes at a position, together with the ink to write on it.
- * @param stops - The scale's colours, from its low end to its high end.
- * @param position - Where on the scale to read, from 0 to 1; anything outside is clamped.
+ * The colour a list of evenly spread colours takes, with the ink to write on it.
+ * @param stops - The colours, from the low end to the high end.
+ * @param position - Where to read, from 0 to 1; anything outside is clamped.
  * @param options - See {@link ReadableInkOptions}.
  * @returns The background and the readable ink.
- * @throws {Error} When the scale has no stops, or a stop is not a hex colour.
+ * @throws {Error} When the list is empty, or a colour is not a hex colour.
  */
 export function swatchFromScale(stops, position, options = {}) {
-    const background = colorFromScale(stops, position);
-    return { background, foreground: readableInk(background, options) };
+    return swatchAt(evenScale(stops), position, options);
 }
 function clampUnit(value) {
     if (!Number.isFinite(value))

package/lib/color/core/scale.js.map

@@ -1 +1 @@
-{"version":3,"file":"scale.js","sourceRoot":"","sources":["../../../src/color/core/scale.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scale.js","sourceRoot":"","sources":["../../../src/color/core/scale.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIhD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAsB,cAAc,CAAC;AAa/D;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAa,EACb,GAAW,EACX,GAAW,EACX,UAAkC,EAAE;IAEpC,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACxC,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QACrB,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EACrB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;IAEhE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC3B,OAAO,SAAS,CACd,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAChE,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAwB,EACxB,QAAgB;IAEhB,OAAO,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAwB,EACxB,QAAgB,EAChB,UAA8B,EAAE;IAEhC,OAAO,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,GAAW;IAChD,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACxB,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACvB,OAAO,GAAG,GAAG,KAAK,CAAC;AACrB,CAAC"}

package/lib/color/core/scaleData.d.ts

@@ -0,0 +1,19 @@
+/** Viridis: the default, monotone in lightness and safe under colour deficiency. */
+export declare const VIRIDIS_COLORS: readonly string[];
+/** Plasma: purple to yellow, brighter than viridis at the bottom. */
+export declare const PLASMA_COLORS: readonly string[];
+/** Magma: black to cream through violet and orange. */
+export declare const MAGMA_COLORS: readonly string[];
+/** Inferno: black to pale yellow through red, the warmest of the five. */
+export declare const INFERNO_COLORS: readonly string[];
+/** Cividis: blue to yellow, built to read the same to a deuteranope. */
+export declare const CIVIDIS_COLORS: readonly string[];
+/** Turbo: the colours of a rainbow, ordered so the lightness still climbs. */
+export declare const TURBO_COLORS: readonly string[];
+/** Greys: light to black, for a figure that will be printed or photocopied. */
+export declare const GREYS_COLORS: readonly string[];
+/** Cool to warm: blue through pale yellow to red, for a quantity with a middle. */
+export declare const COOL_WARM_COLORS: readonly string[];
+/** Blue to red through white, the diverging map with the palest middle. */
+export declare const BLUE_RED_COLORS: readonly string[];
+//# sourceMappingURL=scaleData.d.ts.map

package/lib/color/core/scaleData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaleData.d.ts","sourceRoot":"","sources":["../../../src/color/core/scaleData.ts"],"names":[],"mappings":"AAYA,oFAAoF;AACpF,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAU3C,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAU1C,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAUzC,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAU3C,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAU3C,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAUzC,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAUzC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAU7C,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAU5C,CAAC"}