react-cheminfo 0.9.0 → 0.11.0

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

package/lib/color/core/scaleData.js

@@ -0,0 +1,120 @@
+/*
+ * The colours of the maps the family reads a quantity with, each sampled at
+ * nine evenly spaced stops.
+ *
+ * They are values rather than code: viridis, magma, inferno, plasma and
+ * cividis come from matplotlib (CC0), turbo from Google (Apache-2.0) and the
+ * diverging pair from ColorBrewer (Apache-2.0), all sampled through
+ * `d3-scale-chromatic`. Nine stops interpolated in sRGB reproduce each map
+ * closely enough that no eye separates the two, and keeps a scale a plain list
+ * a legend and a CSS gradient can both be written from.
+ */
+/** Viridis: the default, monotone in lightness and safe under colour deficiency. */
+export const VIRIDIS_COLORS = [
+    '#440154',
+    '#472d7b',
+    '#3b528b',
+    '#2c728e',
+    '#21918c',
+    '#28ae80',
+    '#5ec962',
+    '#addc30',
+    '#fde725',
+];
+/** Plasma: purple to yellow, brighter than viridis at the bottom. */
+export const PLASMA_COLORS = [
+    '#0d0887',
+    '#4c02a1',
+    '#7e03a8',
+    '#aa2395',
+    '#cc4778',
+    '#e66c5c',
+    '#f89540',
+    '#fdc527',
+    '#f0f921',
+];
+/** Magma: black to cream through violet and orange. */
+export const MAGMA_COLORS = [
+    '#000004',
+    '#1d1147',
+    '#51127c',
+    '#832681',
+    '#b73779',
+    '#e75263',
+    '#fc8961',
+    '#fec488',
+    '#fcfdbf',
+];
+/** Inferno: black to pale yellow through red, the warmest of the five. */
+export const INFERNO_COLORS = [
+    '#000004',
+    '#210c4a',
+    '#57106e',
+    '#8a226a',
+    '#bc3754',
+    '#e45a31',
+    '#f98e09',
+    '#f9cb35',
+    '#fcffa4',
+];
+/** Cividis: blue to yellow, built to read the same to a deuteranope. */
+export const CIVIDIS_COLORS = [
+    '#002051',
+    '#11366c',
+    '#3c4d6e',
+    '#62646f',
+    '#7f7c75',
+    '#9a9478',
+    '#bbaf71',
+    '#e2cb5c',
+    '#fdea45',
+];
+/** Turbo: the colours of a rainbow, ordered so the lightness still climbs. */
+export const TURBO_COLORS = [
+    '#23171b',
+    '#4569ee',
+    '#26bce1',
+    '#3ff393',
+    '#95fb51',
+    '#ecd12e',
+    '#ff821d',
+    '#cb2f0d',
+    '#900c00',
+];
+/** Greys: light to black, for a figure that will be printed or photocopied. */
+export const GREYS_COLORS = [
+    '#ebebeb',
+    '#d7d7d7',
+    '#bebebe',
+    '#a0a0a0',
+    '#818181',
+    '#646464',
+    '#444444',
+    '#202020',
+    '#000000',
+];
+/** Cool to warm: blue through pale yellow to red, for a quantity with a middle. */
+export const COOL_WARM_COLORS = [
+    '#313695',
+    '#5382bb',
+    '#90c2dd',
+    '#d1ebef',
+    '#faf8c1',
+    '#fed284',
+    '#f88d52',
+    '#dd4030',
+    '#a50026',
+];
+/** Blue to red through white, the diverging map with the palest middle. */
+export const BLUE_RED_COLORS = [
+    '#053061',
+    '#2a71ae',
+    '#6bacd0',
+    '#bfdceb',
+    '#f2efee',
+    '#faccb4',
+    '#e48268',
+    '#b82d35',
+    '#67001f',
+];
+//# sourceMappingURL=scaleData.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaleData.js","sourceRoot":"","sources":["../../../src/color/core/scaleData.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,oFAAoF;AACpF,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF,uDAAuD;AACvD,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC"}

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

@@ -0,0 +1,43 @@
+import type { ColorScale } from './interpolate.ts';
+/** How many anchors a link may spell out. */
+export declare const MAXIMUM_CUSTOM_STOPS = 12;
+/** The scale a piece of text names, whether it named one of ours or spelled out its own. */
+export interface ResolvedColorScale {
+    /** The registry entry it named, or `null` when the text spelled out its own scale. */
+    id: string | null;
+    /** What to call it. */
+    label: string;
+    /** The ramp itself. */
+    scale: ColorScale;
+}
+/**
+ * The scale a link, a stored preference or a picker asks for.
+ *
+ * Nothing here throws and nothing is rejected outright: a scale renamed since
+ * the link was written, a colour with a typo in it, a position out of range —
+ * each falls back to the scale the site reads by default, because a link
+ * handed out in a course two years ago must still open the tool.
+ * @param text - A scale id, e.g. `plasma`, or a custom scale as {@link formatColorScale} writes it, e.g. `hsv-long,0-0000ff,1-ff0000`.
+ * @param fallbackId - The scale to read when the text names none.
+ * @returns The scale, and the id when it was one of ours.
+ */
+export declare function resolveColorScale(text: string | undefined, fallbackId?: string): ResolvedColorScale;
+/**
+ * Read a custom scale out of the text a link carries.
+ *
+ * Everything in it is comma-separated, and a browser escapes none of it, so
+ * the link a teacher hands out stays the one they can read and retype.
+ * @param text - The path, then the anchors, e.g. `hsv-long,0-0000ff,1-ff0000`. The path may be left out, and is then `rgb`.
+ * @returns The scale, or `null` when the text does not spell out at least two usable anchors.
+ */
+export declare function parseColorScale(text: string): ColorScale | null;
+/**
+ * Write a custom scale as the text a link carries.
+ *
+ * The `#` of each colour is dropped: a query string that carries one is cut in
+ * two at the first of them, and everything after it never reaches the site.
+ * @param scale - The scale to write.
+ * @returns Its text, e.g. `hsv-long,0-0000ff,1-ff0000`.
+ */
+export declare function formatColorScale(scale: ColorScale): string;
+//# sourceMappingURL=scaleText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaleText.d.ts","sourceRoot":"","sources":["../../../src/color/core/scaleText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,UAAU,EAEX,MAAM,kBAAkB,CAAC;AAQ1B,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAUvC,4FAA4F;AAC5F,MAAM,WAAW,kBAAkB;IACjC,sFAAsF;IACtF,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,UAAU,GAAE,MAA+B,GAC1C,kBAAkB,CAapB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAiB/D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAQ1D"}

package/lib/color/core/scaleText.js

@@ -0,0 +1,109 @@
+import { COLOR_SCALES, DEFAULT_COLOR_SCALE_ID, colorScaleById, } from "./scales.js";
+/** How many anchors a link may spell out. */
+export const MAXIMUM_CUSTOM_STOPS = 12;
+const HEX_DIGITS = /^(?:[\da-f]{3}|[\da-f]{6})$/;
+const POSITION_DECIMALS = 3;
+const INTERPOLATIONS = [
+    'rgb',
+    'hsv',
+    'hsv-long',
+];
+/**
+ * The scale a link, a stored preference or a picker asks for.
+ *
+ * Nothing here throws and nothing is rejected outright: a scale renamed since
+ * the link was written, a colour with a typo in it, a position out of range —
+ * each falls back to the scale the site reads by default, because a link
+ * handed out in a course two years ago must still open the tool.
+ * @param text - A scale id, e.g. `plasma`, or a custom scale as {@link formatColorScale} writes it, e.g. `hsv-long,0-0000ff,1-ff0000`.
+ * @param fallbackId - The scale to read when the text names none.
+ * @returns The scale, and the id when it was one of ours.
+ */
+export function resolveColorScale(text, fallbackId = DEFAULT_COLOR_SCALE_ID) {
+    const wanted = (text ?? '').trim().toLowerCase();
+    const named = colorScaleById(wanted);
+    if (named !== undefined)
+        return fromNamed(named);
+    const custom = parseColorScale(wanted);
+    if (custom !== null)
+        return { id: null, label: 'Custom', scale: custom };
+    const fallback = colorScaleById(fallbackId) ?? COLOR_SCALES[0];
+    if (fallback === undefined) {
+        throw new Error('no colour scale is registered');
+    }
+    return fromNamed(fallback);
+}
+/**
+ * Read a custom scale out of the text a link carries.
+ *
+ * Everything in it is comma-separated, and a browser escapes none of it, so
+ * the link a teacher hands out stays the one they can read and retype.
+ * @param text - The path, then the anchors, e.g. `hsv-long,0-0000ff,1-ff0000`. The path may be left out, and is then `rgb`.
+ * @returns The scale, or `null` when the text does not spell out at least two usable anchors.
+ */
+export function parseColorScale(text) {
+    const pieces = text.split(',');
+    const first = (pieces[0] ?? '').trim().toLowerCase();
+    const named = isInterpolation(first);
+    const stops = [];
+    for (const piece of named ? pieces.slice(1) : pieces) {
+        const stop = parseStop(piece);
+        if (stop !== null)
+            stops.push(stop);
+    }
+    if (stops.length < 2)
+        return null;
+    stops.sort((one, other) => one.position - other.position);
+    return {
+        stops: stops.slice(0, MAXIMUM_CUSTOM_STOPS),
+        interpolation: named ? first : 'rgb',
+    };
+}
+/**
+ * Write a custom scale as the text a link carries.
+ *
+ * The `#` of each colour is dropped: a query string that carries one is cut in
+ * two at the first of them, and everything after it never reaches the site.
+ * @param scale - The scale to write.
+ * @returns Its text, e.g. `hsv-long,0-0000ff,1-ff0000`.
+ */
+export function formatColorScale(scale) {
+    const pieces = [scale.interpolation];
+    for (const stop of scale.stops) {
+        const color = stop.color.trim().toLowerCase().replace('#', '');
+        if (!HEX_DIGITS.test(color))
+            continue;
+        pieces.push(`${formatPosition(stop.position)}-${color}`);
+    }
+    return pieces.join(',');
+}
+function fromNamed(named) {
+    return { id: named.id, label: named.label, scale: named.scale };
+}
+function parseStop(piece) {
+    const text = piece.trim().toLowerCase();
+    const separator = text.lastIndexOf('-');
+    if (separator <= 0)
+        return null;
+    const position = Number.parseFloat(text.slice(0, separator));
+    if (!Number.isFinite(position))
+        return null;
+    const color = text.slice(separator + 1).replace('#', '');
+    if (!HEX_DIGITS.test(color))
+        return null;
+    return { position: Math.min(1, Math.max(0, position)), color: `#${color}` };
+}
+function isInterpolation(value) {
+    for (const interpolation of INTERPOLATIONS) {
+        if (interpolation === value)
+            return true;
+    }
+    return false;
+}
+function formatPosition(position) {
+    const inside = Math.min(1, Math.max(0, position));
+    if (!Number.isFinite(inside))
+        return '0';
+    return String(Number(inside.toFixed(POSITION_DECIMALS)));
+}
+//# sourceMappingURL=scaleText.js.map

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

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

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

@@ -0,0 +1,42 @@
+import type { ColorScale } from './interpolate.ts';
+/**
+ * What a scale is for, which is what the picker groups it under.
+ *
+ * A `sequential` one climbs from a low end to a high end; a `diverging` one
+ * reads away from a middle in both directions; a `cyclic` one turns around the
+ * colour wheel and orders nothing, so it is offered for the reader who wants
+ * the rainbow their course used and never chosen for them.
+ */
+export type ColorScaleKind = 'sequential' | 'diverging' | 'cyclic';
+/** One of the scales the family reads a quantity with. */
+export interface NamedColorScale {
+    /** The word a link and the picker carry, e.g. `viridis`. */
+    id: string;
+    /** What it is called in the picker. */
+    label: string;
+    /** What it is for. */
+    kind: ColorScaleKind;
+    /** One line on when to reach for it. */
+    description: string;
+    /** The ramp itself. */
+    scale: ColorScale;
+}
+/** What the picker calls each kind. */
+export declare const COLOR_SCALE_KIND_LABELS: Record<ColorScaleKind, string>;
+/** The scale a site reads a quantity with unless a link says otherwise. */
+export declare const DEFAULT_COLOR_SCALE_ID = "viridis";
+/**
+ * Every scale the picker offers, in the order it lists them.
+ *
+ * Viridis leads because it is the only one of them that survives every way a
+ * figure is read: printed in grey, projected, and seen by the one student in
+ * twelve who does not separate red from green.
+ */
+export declare const COLOR_SCALES: readonly NamedColorScale[];
+/**
+ * The scale a link names.
+ * @param id - The word a link carries, e.g. `plasma`.
+ * @returns Its entry, or `undefined` when no scale is called that.
+ */
+export declare function colorScaleById(id: string): NamedColorScale | undefined;
+//# sourceMappingURL=scales.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scales.d.ts","sourceRoot":"","sources":["../../../src/color/core/scales.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAcnD;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEnE,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,IAAI,EAAE,cAAc,CAAC;IACrB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,uCAAuC;AACvC,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAIlE,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,eAAe,EAgFlD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAKtE"}

package/lib/color/core/scales.js

@@ -0,0 +1,110 @@
+import { evenScale } from "./interpolate.js";
+import { BLUE_RED_COLORS, CIVIDIS_COLORS, COOL_WARM_COLORS, GREYS_COLORS, INFERNO_COLORS, MAGMA_COLORS, PLASMA_COLORS, TURBO_COLORS, VIRIDIS_COLORS, } from "./scaleData.js";
+/** What the picker calls each kind. */
+export const COLOR_SCALE_KIND_LABELS = {
+    sequential: 'Low to high',
+    diverging: 'Away from a middle',
+    cyclic: 'Around the wheel',
+};
+/** The scale a site reads a quantity with unless a link says otherwise. */
+export const DEFAULT_COLOR_SCALE_ID = 'viridis';
+/**
+ * Every scale the picker offers, in the order it lists them.
+ *
+ * Viridis leads because it is the only one of them that survives every way a
+ * figure is read: printed in grey, projected, and seen by the one student in
+ * twelve who does not separate red from green.
+ */
+export const COLOR_SCALES = [
+    {
+        id: 'viridis',
+        label: 'Viridis',
+        kind: 'sequential',
+        description: 'Purple to yellow. Prints in grey and reads colour-blind.',
+        scale: evenScale(VIRIDIS_COLORS),
+    },
+    {
+        id: 'plasma',
+        label: 'Plasma',
+        kind: 'sequential',
+        description: 'Blue to yellow through magenta, brighter than viridis.',
+        scale: evenScale(PLASMA_COLORS),
+    },
+    {
+        id: 'magma',
+        label: 'Magma',
+        kind: 'sequential',
+        description: 'Black to cream through violet and orange.',
+        scale: evenScale(MAGMA_COLORS),
+    },
+    {
+        id: 'inferno',
+        label: 'Inferno',
+        kind: 'sequential',
+        description: 'Black to pale yellow through red.',
+        scale: evenScale(INFERNO_COLORS),
+    },
+    {
+        id: 'cividis',
+        label: 'Cividis',
+        kind: 'sequential',
+        description: 'Blue to yellow, built to read the same to a deuteranope.',
+        scale: evenScale(CIVIDIS_COLORS),
+    },
+    {
+        id: 'turbo',
+        label: 'Turbo',
+        kind: 'sequential',
+        description: 'Rainbow colours, ordered so the lightness still climbs.',
+        scale: evenScale(TURBO_COLORS),
+    },
+    {
+        id: 'greys',
+        label: 'Greys',
+        kind: 'sequential',
+        description: 'Light to black, for a figure that will be photocopied.',
+        scale: evenScale(GREYS_COLORS),
+    },
+    {
+        id: 'cool-warm',
+        label: 'Cool to warm',
+        kind: 'diverging',
+        description: 'Blue through pale yellow to red.',
+        scale: evenScale(COOL_WARM_COLORS),
+    },
+    {
+        id: 'blue-red',
+        label: 'Blue to red',
+        kind: 'diverging',
+        description: 'Blue to red through white, the palest middle.',
+        scale: evenScale(BLUE_RED_COLORS),
+    },
+    {
+        id: 'rainbow',
+        label: 'Rainbow',
+        kind: 'cyclic',
+        description: 'Blue through green and yellow to red. Orders nothing in grey.',
+        // Two anchors and the long way round the wheel: the whole rainbow, and the
+        // shortest thing in this file that shows what the HSV model buys.
+        scale: {
+            stops: [
+                { position: 0, color: '#0000ff' },
+                { position: 1, color: '#ff0000' },
+            ],
+            interpolation: 'hsv-long',
+        },
+    },
+];
+/**
+ * The scale a link names.
+ * @param id - The word a link carries, e.g. `plasma`.
+ * @returns Its entry, or `undefined` when no scale is called that.
+ */
+export function colorScaleById(id) {
+    for (const scale of COLOR_SCALES) {
+        if (scale.id === id)
+            return scale;
+    }
+    return undefined;
+}
+//# sourceMappingURL=scales.js.map

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

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