react-cheminfo 0.9.0 → 0.10.0

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":"AAMA,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,6CAA6C;AAC7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,MAAM,UAAU,GAAG,6BAA6B,CAAC;AACjD,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,cAAc,GAAkC;IACpD,KAAK;IACL,KAAK;IACL,UAAU;CACX,CAAC;AAYF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAwB,EACxB,aAAqB,sBAAsB;IAE3C,MAAM,MAAM,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAEjD,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAEzE,MAAM,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrD,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAErC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,IAAI,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1D,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC;QAC3C,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;KACrC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,MAAM,MAAM,GAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS;QACtC,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,SAAS,CAAC,KAAsB;IACvC,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE,EAAE,CAAC;AAC9E,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;QAC3C,IAAI,aAAa,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,GAAG,CAAC;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC"}

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

package/lib/color/ui/ColorScaleBar.d.ts

@@ -0,0 +1,39 @@
+import type { CSSProperties, ReactElement } from 'react';
+import type { ColorScale } from '../core/interpolate.ts';
+/** What {@link ColorScaleBar} draws. */
+export interface ColorScaleBarProps {
+    /** The scale to draw, from its low end at the left. */
+    scale: ColorScale;
+    /**
+     * How tall the strip is, in pixels.
+     * @default 10
+     */
+    height?: number;
+    /**
+     * How many colours the gradient is written from. A scale that turns around
+     * the colour wheel needs more of them than one that mixes three channels,
+     * because the browser can only interpolate the straight line between two.
+     * @default 24
+     */
+    samples?: number;
+    /**
+     * What a screen reader is told the strip shows.
+     * @default '' — the strip is decoration, and is hidden from the reader
+     */
+    label?: string;
+    /**
+     * Anything the caller has to set on the strip itself, a width above all.
+     * @default {}
+     */
+    style?: CSSProperties;
+}
+/**
+ * A colour scale as one strip of colour.
+ *
+ * The picker, the editor and any caller who has to show a ramp without its end
+ * values draw the same strip, so a scale looks the same wherever it is offered.
+ * @param props - See {@link ColorScaleBarProps}.
+ * @returns The strip.
+ */
+export declare function ColorScaleBar(props: ColorScaleBarProps): ReactElement;
+//# sourceMappingURL=ColorScaleBar.d.ts.map

package/lib/color/ui/ColorScaleBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorScaleBar.d.ts","sourceRoot":"","sources":["../../../src/color/ui/ColorScaleBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAGzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAKzD,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,KAAK,EAAE,UAAU,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,YAAY,CAsBrE"}

package/lib/color/ui/ColorScaleBar.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { colorScaleGradient } from "../core/gradient.js";
+const DEFAULT_HEIGHT = 10;
+const DEFAULT_SAMPLES = 24;
+/**
+ * A colour scale as one strip of colour.
+ *
+ * The picker, the editor and any caller who has to show a ramp without its end
+ * values draw the same strip, so a scale looks the same wherever it is offered.
+ * @param props - See {@link ColorScaleBarProps}.
+ * @returns The strip.
+ */
+export function ColorScaleBar(props) {
+    const { scale, height = DEFAULT_HEIGHT, samples = DEFAULT_SAMPLES, label = '', style = {}, } = props;
+    return (_jsx("span", { role: label === '' ? undefined : 'img', "aria-label": label === '' ? undefined : label, "aria-hidden": label === '' ? true : undefined, style: {
+            ...BAR_STYLE,
+            height,
+            backgroundImage: colorScaleGradient(scale, samples),
+            ...style,
+        } }));
+}
+const BAR_STYLE = {
+    display: 'block',
+    width: '100%',
+    borderRadius: 3,
+};
+//# sourceMappingURL=ColorScaleBar.js.map

package/lib/color/ui/ColorScaleBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorScaleBar.js","sourceRoot":"","sources":["../../../src/color/ui/ColorScaleBar.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,eAAe,GAAG,EAAE,CAAC;AA8B3B;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,EACJ,KAAK,EACL,MAAM,GAAG,cAAc,EACvB,OAAO,GAAG,eAAe,EACzB,KAAK,GAAG,EAAE,EACV,KAAK,GAAG,EAAE,GACX,GAAG,KAAK,CAAC;IAEV,OAAO,CACL,eACE,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,gBAC1B,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,iBAC/B,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAC5C,KAAK,EAAE;YACL,GAAG,SAAS;YACZ,MAAM;YACN,eAAe,EAAE,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC;YACnD,GAAG,KAAK;SACT,GACD,CACH,CAAC;AACJ,CAAC;AAED,MAAM,SAAS,GAAG;IAChB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,MAAM;IACb,YAAY,EAAE,CAAC;CACiB,CAAC"}

package/lib/color/ui/ColorScaleEditor.d.ts

@@ -0,0 +1,21 @@
+import type { ReactElement } from 'react';
+import type { ColorScale } from '../core/interpolate.ts';
+/** What {@link ColorScaleEditor} edits. */
+export interface ColorScaleEditorProps {
+    /** The scale being edited; every anchor is a `#rgb` or `#rrggbb` colour. */
+    value: ColorScale;
+    /** Called with the edited scale on every change. */
+    onChange: (scale: ColorScale) => void;
+}
+/**
+ * A colour scale of the reader's own: the colours it passes through, where
+ * each one sits, and the path it takes between them.
+ *
+ * A colour is anchored rather than typed into a list, so two anchors and the
+ * HSV path already describe a whole rainbow, and an anchor never crosses its
+ * neighbours — the scale it draws is always the one the strip above shows.
+ * @param props - See {@link ColorScaleEditorProps}.
+ * @returns The preview, the anchors, and the picker of the path between them.
+ */
+export declare function ColorScaleEditor(props: ColorScaleEditorProps): ReactElement;
+//# sourceMappingURL=ColorScaleEditor.d.ts.map

package/lib/color/ui/ColorScaleEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorScaleEditor.d.ts","sourceRoot":"","sources":["../../../src/color/ui/ColorScaleEditor.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAGzD,OAAO,KAAK,EAEV,UAAU,EAEX,MAAM,wBAAwB,CAAC;AAqBhC,2CAA2C;AAC3C,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,KAAK,EAAE,UAAU,CAAC;IAClB,oDAAoD;IACpD,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,YAAY,CAoF3E"}