react-cheminfo 0.50.0 → 0.52.0

package/README.md

@@ -30,22 +30,24 @@ would mean two Blueprint style trees in one page.
 Subpaths are **bundle boundaries, not taxonomy**: a feature gets its own door
 only when it drags a heavy dependency behind it.
 
-| Import                             | Holds                                             | Costs                                            |
-| ---------------------------------- | ------------------------------------------------- | ------------------------------------------------ |
-| `react-cheminfo/core`              | every framework-free helper — 140 value exports   | nothing                                          |
-| `react-cheminfo/ui`                | every React component and hook — 60 value exports | React                                            |
-| `react-cheminfo/vite`              | the prerender plugin and the OG card              | nothing; React on the card                       |
-| `react-cheminfo/pages`             | the Cloudflare Pages analytics middleware         | nothing                                          |
-| `react-cheminfo/orbital`           | the 3D atomic-orbital viewer                      | React, molstar                                   |
-| `react-cheminfo/molecule3d`        | the 3D molecule viewer and its toolbar            | React, molstar                                   |
-| `react-cheminfo/structure`         | the structure editor and renderer                 | React, react-ocl, OCL                            |
-| `react-cheminfo/conformers`        | conformer generation, ranking and refinement      | OCL                                              |
-| `react-cheminfo/slides`            | the deck format and the slideshow player          | React, react-markdown                            |
-| `react-cheminfo/spectra`           | the spectra processing settings editors           | React; types only from spectra-processor, ml-pca |
-| `react-cheminfo/ir`                | the infrared chart, band table and editor         | React, ir-spectrum, convert-to-jcamp             |
-| `react-cheminfo/xtb`               | GFN2-xTB as a geometry relaxer                    | nothing on import; xtb-wasm on the first call    |
-| `react-cheminfo/styles/chrome.css` | the shared tokens and site-header stylesheet      | nothing                                          |
-| `react-cheminfo/styles/slides.css` | the deck stylesheet, themed on the site's colours | nothing                                          |
+| Import                             | Holds                                                 | Costs                                            |
+| ---------------------------------- | ----------------------------------------------------- | ------------------------------------------------ |
+| `react-cheminfo/core`              | every framework-free helper — 140 value exports       | nothing                                          |
+| `react-cheminfo/ui`                | every React component and hook — 60 value exports     | React                                            |
+| `react-cheminfo/vite`              | the prerender plugin and the OG card                  | nothing; React on the card                       |
+| `react-cheminfo/pages`             | the Cloudflare Pages analytics middleware             | nothing                                          |
+| `react-cheminfo/orbital`           | the 3D atomic-orbital viewer                          | React, molstar                                   |
+| `react-cheminfo/molecule3d`        | the 3D molecule viewer and its toolbar                | React, molstar                                   |
+| `react-cheminfo/structure`         | the structure editor and renderer                     | React, react-ocl, OCL                            |
+| `react-cheminfo/conformers`        | conformer generation, ranking and refinement          | OCL                                              |
+| `react-cheminfo/slides`            | the deck format and the slideshow player              | React, react-markdown                            |
+| `react-cheminfo/spectra`           | the spectra processing settings editors               | React; types only from spectra-processor, ml-pca |
+| `react-cheminfo/ir`                | the infrared chart, band table and editor             | React, ir-spectrum, convert-to-jcamp             |
+| `react-cheminfo/xtb`               | GFN2-xTB as a geometry relaxer                        | nothing on import; xtb-wasm on the first call    |
+| `react-cheminfo/host`              | data handed over by a page that frames the tool       | nothing on import; ajv once the page is framed   |
+| `react-cheminfo/host-testing`      | a stand-in host and SciPeaks' messages, for e2e tests | nothing; Node only                               |
+| `react-cheminfo/styles/chrome.css` | the shared tokens and site-header stylesheet          | nothing                                          |
+| `react-cheminfo/styles/slides.css` | the deck stylesheet, themed on the site's colours     | nothing                                          |
 
 A backend serving an RIS endpoint, a prerender script writing a sitemap, and
 every unit test of that logic therefore load no React at all — and a worker
@@ -116,6 +118,7 @@ through a wildcard subpath exactly as `react-science` serves its own.
 | **Parallel coordinates**   | `parallelAxisOf`, `parallelAxisLayouts`, `parallelIncludedMask`, `parallelKeptCount`, `parallelNearestRow`, `parallelSegmentAt`, `parallelBandAt`, `parallelRangeOf`, `parallelPalette`, `parallelColorSteps`, `paintParallelLines`                                        | `ParallelCoordinates`                                                                                                                                                                                                                                                                               |
 | **Periodic table**         | `PERIODIC_ELEMENTS`, `elementBySymbol`, `elementByAtomicNumber`, `cellOf`, `placedElements`, `elementByArrowKey`, `EMPTY_BLOCK`, `categorySwatch`, `CATEGORY_LABELS`                                                                                                       | `PeriodicTable`, `ElementCell`, `CategoryLegend`                                                                                                                                                                                                                                                    |
 | **Taxonomy**               | `TAXON_RANKS`, `PRINCIPAL_RANKS`, `rankOrder`, `isPrincipalRank`, `isGenusOrBelow`, `isAboveGenus`, `principalLineage`, `lineageFromNodes`, `lineageFromRanks`, `genusOrBelow`, `ncbiTaxonomyUrl`, `splitOrganismName`                                                     | `TaxonLineage`, `OrganismName`, `useRankLabel`                                                                                                                                                                                                                                                      |
+| **Framed by a host**       | `hostStructureLoader`, `readHostMolecule`, `STRUCTURE_KINDS`, `connectHost`, `selectInputs`, `checkValue`, `kindAccepts`, `parseRequest` (all `/host`); `startStandInHost`, `SCIPEAKS_ETHYLBENZENE_LOAD` (`/host-testing`)                                                 | `useHostConnection` (`/host`)                                                                                                                                                                                                                                                                       |
 
 Everything in that table is exported from `./core`, `./ui`, `./slides`,
 `./vite` or `./structure` and nothing else is: the sub-components a component is built
@@ -836,6 +839,58 @@ const included = useMemo(
   subject — a formula through `react-mf`, a structure, a name — and a readout of
   strings cannot hold any of that.
 
+## Framed by a notebook
+
+A page that frames a tool — an electronic lab notebook such as SciPeaks, a
+course — can hand it typed data instead of writing it into the link. The tool
+says `cheminfo:hello` to its parent, the parent answers `cheminfo:connect` with
+a private `MessageChannel` port, and the data arrives on that port as
+`{ kind, value }` items, each checked against pipeline.cheminfo.org's JSON
+Schema before the tool reads it. A tool taking a structure writes two things:
+
+```ts
+// src/tool.ts
+import type { ToolInterface } from 'react-cheminfo/host';
+import { STRUCTURE_KINDS, hostStructureLoader } from 'react-cheminfo/host';
+
+export const TOOL: ToolInterface = {
+  name: '3d',
+  inputs: [{ key: 'structure', kinds: STRUCTURE_KINDS }],
+  outputs: [],
+};
+
+export const loadFromHost = hostStructureLoader((molecule, label) => {
+  loadSmiles(molecule.toIsomericSmiles(), label);
+});
+```
+
+```tsx
+// App.tsx, right after the hook that applies the address
+useHostConnection(TOOL, { load: loadFromHost, build: BUILD_INFO });
+```
+
+- **Nothing is downloaded unless the page is framed**: the connection and ajv
+  are one lazy chunk, fetched once a parent or an opener exists.
+- **A structure that does not read is answered, not shown**: the host gets
+  `unreadable` with one sentence it can display, and the screen does not change.
+  A molfile whose atoms all sit on one point — SciPeaks stores some that way —
+  is laid out again.
+- **The same document twice is applied once**, so a host re-sending a sample
+  never overwrites what the visitor did with it.
+
+`react-cheminfo/host-testing` serves a stand-in host for Playwright on
+`127.0.0.1`, and exports `SCIPEAKS_ETHYLBENZENE_LOAD`: the message SciPeaks'
+tool tab sends for a sample, byte for byte. visualizer-helper's tests pin the
+same message, so a change on either side fails a test rather than a notebook.
+
+```ts
+const host = await startStandInHost();
+await page.goto(
+  host.pageUrl(`${origin}/?embed=1`, [SCIPEAKS_ETHYLBENZENE_LOAD]),
+);
+const { results } = await page.evaluate(readStandInHostLog);
+```
+
 ## Speaking four languages
 
 Every word this library puts on a page — the header, the Tools menu, the Cite

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

@@ -1,4 +1,3 @@
-export { writeImageToClipboard } from './copyPng.ts';
 export type { WriteBlobToClipboardOptions } from './writeBlobToClipboard.ts';
 export { writeBlobToClipboard } from './writeBlobToClipboard.ts';
 export type { ClipboardContent, ClipboardText } from './writeToClipboard.ts';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/clipboard/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/clipboard/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/clipboard/core/index.js

@@ -1,4 +1,3 @@
-export { writeImageToClipboard } from "./copyPng.js";
 export { writeBlobToClipboard } from "./writeBlobToClipboard.js";
 export { writeToClipboard } from "./writeToClipboard.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/clipboard/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/clipboard/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/clipboard/ui/CopyButton.d.ts

@@ -61,6 +61,12 @@ export interface CopyButtonProps {
      * @default undefined
      */
     className?: string;
+    /**
+     * Called once the clipboard has taken the content — never when it refused —
+     * for a dialog whose whole purpose was that copy and that closes on it.
+     * @default undefined
+     */
+    onCopied?: () => void;
 }
 /**
  * A button that puts a piece of text on the clipboard and says so — with a

package/lib/clipboard/ui/CopyButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CopyButton.d.ts","sourceRoot":"","sources":["../../../src/clipboard/ui/CopyButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAU,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAU1C,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CA0C/D"}
+{"version":3,"file":"CopyButton.d.ts","sourceRoot":"","sources":["../../../src/clipboard/ui/CopyButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAU,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAU1C,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CA+C/D"}

package/lib/clipboard/ui/CopyButton.js

@@ -10,7 +10,7 @@ import { DEFAULT_COPY_RESET_AFTER, useCopyToClipboard, } from "./useCopyToClipbo
  * @returns The copy button.
  */
 export function CopyButton(props) {
-    const { content, label, copiedLabel, failedLabel, minimal = false, small = false, icon = 'clipboard', disabled = false, resetAfter = DEFAULT_COPY_RESET_AFTER, title, className, } = props;
+    const { content, label, copiedLabel, failedLabel, minimal = false, small = false, icon = 'clipboard', disabled = false, resetAfter = DEFAULT_COPY_RESET_AFTER, title, className, onCopied, } = props;
     const t = useChromeT();
     const { copied, failed, copy } = useCopyToClipboard(resetAfter);
     const hoverTitle = title ?? t('clipboard.copyToClipboard');
@@ -23,7 +23,10 @@ export function CopyButton(props) {
         failedLabel: failedLabel ?? t('clipboard.failed'),
     });
     return (_jsx(Button, { className: joinClassNames('no-print', className), variant: minimal ? 'minimal' : 'solid', size: small ? 'small' : 'medium', icon: look.icon, intent: look.intent, text: look.text, disabled: disabled, title: hoverTitle, "aria-label": label ?? hoverTitle, onClick: () => {
-            void copy(typeof content === 'function' ? content() : content);
+            void copy(typeof content === 'function' ? content() : content).then((written) => {
+                if (written)
+                    onCopied?.();
+            });
         } }));
 }
 function buttonLook(input) {

package/lib/clipboard/ui/CopyButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"CopyButton.js","sourceRoot":"","sources":["../../../src/clipboard/ui/CopyButton.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,OAAO,EACL,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAiEjC;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,EACJ,OAAO,EACP,KAAK,EACL,WAAW,EACX,WAAW,EACX,OAAO,GAAG,KAAK,EACf,KAAK,GAAG,KAAK,EACb,IAAI,GAAG,WAAW,EAClB,QAAQ,GAAG,KAAK,EAChB,UAAU,GAAG,wBAAwB,EACrC,KAAK,EACL,SAAS,GACV,GAAG,KAAK,CAAC;IACV,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,KAAK,IAAI,CAAC,CAAC,2BAA2B,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,UAAU,CAAC;QACtB,MAAM;QACN,MAAM;QACN,IAAI;QACJ,KAAK;QACL,WAAW,EAAE,WAAW,IAAI,CAAC,CAAC,kBAAkB,CAAC;QACjD,WAAW,EAAE,WAAW,IAAI,CAAC,CAAC,kBAAkB,CAAC;KAClD,CAAC,CAAC;IAEH,OAAO,CACL,KAAC,MAAM,IACL,SAAS,EAAE,cAAc,CAAC,UAAU,EAAE,SAAS,CAAC,EAChD,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EACtC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAChC,IAAI,EAAE,IAAI,CAAC,IAAI,EACf,MAAM,EAAE,IAAI,CAAC,MAAM,EACnB,IAAI,EAAE,IAAI,CAAC,IAAI,EACf,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,UAAU,gBACL,KAAK,IAAI,UAAU,EAC/B,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,IAAI,CAAC,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACjE,CAAC,GACD,CACH,CAAC;AACJ,CAAC;AAWD,SAAS,UAAU,CAAC,KAAsB;IAKxC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IACxE,MAAM,QAAQ,GAAG,KAAK,KAAK,SAAS,CAAC;IACrC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;SACzC,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;SACzC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"CopyButton.js","sourceRoot":"","sources":["../../../src/clipboard/ui/CopyButton.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,OAAO,EACL,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAuEjC;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,EACJ,OAAO,EACP,KAAK,EACL,WAAW,EACX,WAAW,EACX,OAAO,GAAG,KAAK,EACf,KAAK,GAAG,KAAK,EACb,IAAI,GAAG,WAAW,EAClB,QAAQ,GAAG,KAAK,EAChB,UAAU,GAAG,wBAAwB,EACrC,KAAK,EACL,SAAS,EACT,QAAQ,GACT,GAAG,KAAK,CAAC;IACV,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,KAAK,IAAI,CAAC,CAAC,2BAA2B,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,UAAU,CAAC;QACtB,MAAM;QACN,MAAM;QACN,IAAI;QACJ,KAAK;QACL,WAAW,EAAE,WAAW,IAAI,CAAC,CAAC,kBAAkB,CAAC;QACjD,WAAW,EAAE,WAAW,IAAI,CAAC,CAAC,kBAAkB,CAAC;KAClD,CAAC,CAAC;IAEH,OAAO,CACL,KAAC,MAAM,IACL,SAAS,EAAE,cAAc,CAAC,UAAU,EAAE,SAAS,CAAC,EAChD,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EACtC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAChC,IAAI,EAAE,IAAI,CAAC,IAAI,EACf,MAAM,EAAE,IAAI,CAAC,MAAM,EACnB,IAAI,EAAE,IAAI,CAAC,IAAI,EACf,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,UAAU,gBACL,KAAK,IAAI,UAAU,EAC/B,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,IAAI,CAAC,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CACjE,CAAC,OAAO,EAAE,EAAE;gBACV,IAAI,OAAO;oBAAE,QAAQ,EAAE,EAAE,CAAC;YAC5B,CAAC,CACF,CAAC;QACJ,CAAC,GACD,CACH,CAAC;AACJ,CAAC;AAWD,SAAS,UAAU,CAAC,KAAsB;IAKxC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IACxE,MAAM,QAAQ,GAAG,KAAK,KAAK,SAAS,CAAC;IACrC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;SACzC,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;SACzC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC"}

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

@@ -11,6 +11,9 @@ export type { PositionInRangeOptions } from './scale.ts';
 export { positionInRange } 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 { UNIFORM_COLOR_SCALE_ID, UNIFORM_SWATCH, formatUniformColorScale, isUniformColorScale, uniformSwatch, } from './uniform.ts';
+export type { ScaleTone } from './tone.ts';
+export { scaleTone, setScaleTone } from './tone.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,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACxE,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,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,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"}
+{"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,iBAAiB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACxE,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,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACpD,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

@@ -5,5 +5,7 @@ export { hsvToRgb, rgbToHsv, wrapHue } from "./hsv.js";
 export { colorAt, evenScale, sampleScale, swatchAt } from "./interpolate.js";
 export { positionInRange } from "./scale.js";
 export { COLOR_SCALES, COLOR_SCALE_KIND_LABELS, DEFAULT_COLOR_SCALE_ID, colorScaleById, } from "./scales.js";
+export { UNIFORM_COLOR_SCALE_ID, UNIFORM_SWATCH, formatUniformColorScale, isUniformColorScale, uniformSwatch, } from "./uniform.js";
+export { scaleTone, setScaleTone } from "./tone.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,EAAE,iBAAiB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACxE,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,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,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"}
+{"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,iBAAiB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACxE,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,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

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

@@ -21,8 +21,10 @@ export interface ColorStop {
  * - `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.
+ * - `hsv-long` turns the whole scale one way round the wheel: the long way
+ *   between its two ends, which is how two anchors draw a rainbow. Each anchor
+ *   in between is reached by turning that same way, never by a turn of its own,
+ *   so adding one where the scale already has its colour changes nothing.
  */
 export type ColorInterpolation = 'rgb' | 'hsv' | 'hsv-long';
 /** A colour scale: its anchors, and how it moves between them. */

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

@@ -1 +1 @@
-{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../../../src/color/core/interpolate.ts"],"names":[],"mappings":"AAEA,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"}
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../../../src/color/core/interpolate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAUxD,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;;;;;;;;;;;;GAYG;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,CA4BnE;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

@@ -53,7 +53,11 @@ export function colorAt(scale, 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 mix(start.color, end.color, ratio, {
+            interpolation,
+            turn: longTurn(first.color, last.color),
+            whole: stops.length === MINIMUM_SAMPLES,
+        });
     }
     return toHexColor(parseHexColor(last.color));
 }
@@ -86,10 +90,10 @@ export function sampleScale(scale, count) {
     }
     return colors;
 }
-function mix(start, end, ratio, interpolation) {
+function mix(start, end, ratio, path) {
     const from = parseHexColor(start);
     const to = parseHexColor(end);
-    if (interpolation === 'rgb') {
+    if (path.interpolation === 'rgb') {
         return toHexColor({
             red: from.red + (to.red - from.red) * ratio,
             green: from.green + (to.green - from.green) * ratio,
@@ -98,20 +102,38 @@ function mix(start, end, ratio, interpolation) {
     }
     const one = rgbToHsv(from);
     const other = rgbToHsv(to);
-    const hue = one.hue + hueStep(one.hue, other.hue, interpolation) * ratio;
+    const [fromHue, toHue] = pairHues(one, other);
+    const hue = fromHue + hueStep(fromHue, toHue, path) * 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;
+// A grey, black or white has no hue of its own, so it takes the other one's:
+// the path then fades to it instead of sweeping through red on the way.
+function pairHues(one, other) {
+    if (one.saturation === 0)
+        return [other.hue, other.hue];
+    if (other.saturation === 0)
+        return [one.hue, one.hue];
+    return [one.hue, other.hue];
+}
+function hueStep(from, to, path) {
+    if (path.interpolation !== 'hsv-long')
+        return shortestStep(from, to);
+    const step = path.turn > 0 ? upStep(from, to) : -upStep(to, from);
+    return step === 0 && path.whole ? path.turn * TURN : step;
+}
+function longTurn(first, last) {
+    const [from, to] = pairHues(rgbToHsv(parseHexColor(first)), rgbToHsv(parseHexColor(last)));
+    // Two ends of one hue are a full turn apart, taken up the wheel.
+    return shortestStep(from, to) > 0 ? -1 : 1;
+}
+function shortestStep(from, to) {
+    return ((((to - from) % TURN) + TURN + HALF_TURN) % TURN) - HALF_TURN;
+}
+function upStep(from, to) {
+    return (((to - from) % TURN) + TURN) % TURN;
 }
 //# sourceMappingURL=interpolate.js.map

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

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

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

@@ -0,0 +1,43 @@
+import type { ColorScale, ColorStop } from './interpolate.ts';
+/** How few anchors a scale may have: one at each end of what it draws. */
+export declare const MINIMUM_CUSTOM_STOPS = 2;
+/** The anchors after an edit, and where the edited one now stands among them. */
+export interface EditedStops {
+    /** The anchors, from the low end. */
+    stops: ColorStop[];
+    /** The index of the anchor that was added or moved. */
+    index: number;
+}
+/**
+ * Add an anchor where the reader clicked, in the colour the scale already has
+ * there — so adding one changes nothing until it is moved or recoloured.
+ * @param scale - The scale being edited.
+ * @param position - Where to add it, from 0 at the low end to 1 at the high end.
+ * @returns The anchors with the new one, or `null` when the scale already holds as many as a link may carry.
+ */
+export declare function addColorStop(scale: ColorScale, position: number): EditedStops | null;
+/**
+ * Move an anchor. It may pass its neighbours: the anchors are kept in order,
+ * and the returned index follows the one that moved.
+ * @param stops - The anchors, from the low end.
+ * @param index - Which of them moves.
+ * @param position - Where to, clamped to the scale.
+ * @returns The anchors in their new order, and where the moved one landed.
+ */
+export declare function moveColorStop(stops: readonly ColorStop[], index: number, position: number): EditedStops;
+/**
+ * Remove an anchor, unless the scale would be left with fewer than two.
+ * @param stops - The anchors, from the low end.
+ * @param index - Which of them to remove.
+ * @returns The remaining anchors, or the same ones when none may go.
+ */
+export declare function removeColorStop(stops: readonly ColorStop[], index: number): ColorStop[];
+/**
+ * Recolour an anchor.
+ * @param stops - The anchors, from the low end.
+ * @param index - Which of them to recolour.
+ * @param color - Its new colour.
+ * @returns The anchors, with that one recoloured.
+ */
+export declare function recolorColorStop(stops: readonly ColorStop[], index: number, color: string): ColorStop[];
+//# sourceMappingURL=stops.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stops.d.ts","sourceRoot":"","sources":["../../../src/color/core/stops.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAI9D,0EAA0E;AAC1E,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAKtC,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,GACf,WAAW,GAAG,IAAI,CAKpB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,WAAW,CAUb;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,KAAK,EAAE,MAAM,GACZ,SAAS,EAAE,CAGb;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,SAAS,EAAE,CAEb"}

package/lib/color/core/stops.js

@@ -0,0 +1,66 @@
+import { clamp } from "../../format/core/clamp.js";
+import { colorAt } from "./interpolate.js";
+import { MAXIMUM_CUSTOM_STOPS } from "./scaleText.js";
+/** How few anchors a scale may have: one at each end of what it draws. */
+export const MINIMUM_CUSTOM_STOPS = 2;
+// A link writes three decimals, so an anchor is held where the link puts it.
+const POSITION_FACTOR = 1000;
+/**
+ * Add an anchor where the reader clicked, in the colour the scale already has
+ * there — so adding one changes nothing until it is moved or recoloured.
+ * @param scale - The scale being edited.
+ * @param position - Where to add it, from 0 at the low end to 1 at the high end.
+ * @returns The anchors with the new one, or `null` when the scale already holds as many as a link may carry.
+ */
+export function addColorStop(scale, position) {
+    if (scale.stops.length >= MAXIMUM_CUSTOM_STOPS)
+        return null;
+    const at = roundPosition(position);
+    const added = { position: at, color: colorAt(scale, at) };
+    return sortAround([...scale.stops, added], added);
+}
+/**
+ * Move an anchor. It may pass its neighbours: the anchors are kept in order,
+ * and the returned index follows the one that moved.
+ * @param stops - The anchors, from the low end.
+ * @param index - Which of them moves.
+ * @param position - Where to, clamped to the scale.
+ * @returns The anchors in their new order, and where the moved one landed.
+ */
+export function moveColorStop(stops, index, position) {
+    const stop = stops[index];
+    if (stop === undefined || !Number.isFinite(position)) {
+        return { stops: [...stops], index };
+    }
+    const moved = { ...stop, position: roundPosition(position) };
+    return sortAround(stops.map((other, at) => (at === index ? moved : other)), moved);
+}
+/**
+ * Remove an anchor, unless the scale would be left with fewer than two.
+ * @param stops - The anchors, from the low end.
+ * @param index - Which of them to remove.
+ * @returns The remaining anchors, or the same ones when none may go.
+ */
+export function removeColorStop(stops, index) {
+    if (stops.length <= MINIMUM_CUSTOM_STOPS)
+        return [...stops];
+    return stops.filter((_, at) => at !== index);
+}
+/**
+ * Recolour an anchor.
+ * @param stops - The anchors, from the low end.
+ * @param index - Which of them to recolour.
+ * @param color - Its new colour.
+ * @returns The anchors, with that one recoloured.
+ */
+export function recolorColorStop(stops, index, color) {
+    return stops.map((stop, at) => (at === index ? { ...stop, color } : stop));
+}
+function roundPosition(position) {
+    return Math.round(clamp(position, 0, 1) * POSITION_FACTOR) / POSITION_FACTOR;
+}
+function sortAround(stops, edited) {
+    const sorted = stops.toSorted((one, other) => one.position - other.position);
+    return { stops: sorted, index: sorted.indexOf(edited) };
+}
+//# sourceMappingURL=stops.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stops.js","sourceRoot":"","sources":["../../../src/color/core/stops.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAGnD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAEtC,6EAA6E;AAC7E,MAAM,eAAe,GAAG,IAAI,CAAC;AAU7B;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAiB,EACjB,QAAgB;IAEhB,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,oBAAoB;QAAE,OAAO,IAAI,CAAC;IAC5D,MAAM,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,KAAK,GAAc,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;IACrE,OAAO,UAAU,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,KAA2B,EAC3B,KAAa,EACb,QAAgB;IAEhB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;IACtC,CAAC;IACD,MAAM,KAAK,GAAc,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;IACxE,OAAO,UAAU,CACf,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EACxD,KAAK,CACN,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,KAA2B,EAC3B,KAAa;IAEb,IAAI,KAAK,CAAC,MAAM,IAAI,oBAAoB;QAAE,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IAC5D,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAA2B,EAC3B,KAAa,EACb,KAAa;IAEb,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,eAAe,CAAC,GAAG,eAAe,CAAC;AAC/E,CAAC;AAED,SAAS,UAAU,CAAC,KAAkB,EAAE,MAAiB;IACvD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC7E,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { ColorStop } from './interpolate.ts';
+/** How strong and how bright a scale's colours are, taken over all its anchors. */
+export interface ScaleTone {
+    /** How far the anchors are from grey, from 0 to 1. */
+    saturation: number;
+    /** How bright they are, from 0 for black to 1. */
+    value: number;
+}
+/**
+ * The saturation and the brightness of a scale's anchors, averaged: what a
+ * control setting both for the whole scale opens on.
+ * @param stops - The anchors.
+ * @returns Their mean saturation and mean value; both 0 when there is no anchor.
+ */
+export declare function scaleTone(stops: readonly ColorStop[]): ScaleTone;
+/**
+ * Give every anchor the same saturation, the same brightness, or both, keeping
+ * each one's hue — so the scale then only turns round the wheel. A grey anchor
+ * has no hue of its own and takes the hue of the nearest one that has.
+ * @param stops - The anchors.
+ * @param tone - What to set; a field left out keeps each anchor's own.
+ * @returns The recoloured anchors, in the same order.
+ */
+export declare function setScaleTone(stops: readonly ColorStop[], tone: Partial<ScaleTone>): ColorStop[];
+//# sourceMappingURL=tone.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tone.d.ts","sourceRoot":"","sources":["../../../src/color/core/tone.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,mFAAmF;AACnF,MAAM,WAAW,SAAS;IACxB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAahE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,GACvB,SAAS,EAAE,CAeb"}

package/lib/color/core/tone.js

@@ -0,0 +1,67 @@
+import { clamp } from "../../format/core/clamp.js";
+import { parseHexColor, toHexColor } from "./hex.js";
+import { hsvToRgb, rgbToHsv } from "./hsv.js";
+/**
+ * The saturation and the brightness of a scale's anchors, averaged: what a
+ * control setting both for the whole scale opens on.
+ * @param stops - The anchors.
+ * @returns Their mean saturation and mean value; both 0 when there is no anchor.
+ */
+export function scaleTone(stops) {
+    const colors = toHsv(stops);
+    if (colors.length === 0)
+        return { saturation: 0, value: 0 };
+    let saturation = 0;
+    let value = 0;
+    for (const color of colors) {
+        saturation += color.saturation;
+        value += color.value;
+    }
+    return {
+        saturation: saturation / colors.length,
+        value: value / colors.length,
+    };
+}
+/**
+ * Give every anchor the same saturation, the same brightness, or both, keeping
+ * each one's hue — so the scale then only turns round the wheel. A grey anchor
+ * has no hue of its own and takes the hue of the nearest one that has.
+ * @param stops - The anchors.
+ * @param tone - What to set; a field left out keeps each anchor's own.
+ * @returns The recoloured anchors, in the same order.
+ */
+export function setScaleTone(stops, tone) {
+    const colors = toHsv(stops);
+    const result = [];
+    for (let index = 0; index < stops.length; index++) {
+        const stop = stops[index];
+        const color = colors[index];
+        if (stop === undefined || color === undefined)
+            continue;
+        const toned = hsvToRgb({
+            hue: hueNear(colors, index),
+            saturation: clamp(tone.saturation ?? color.saturation, 0, 1),
+            value: clamp(tone.value ?? color.value, 0, 1),
+        });
+        result.push({ ...stop, color: toHexColor(toned) });
+    }
+    return result;
+}
+function toHsv(stops) {
+    const colors = [];
+    for (const stop of stops)
+        colors.push(rgbToHsv(parseHexColor(stop.color)));
+    return colors;
+}
+function hueNear(colors, index) {
+    for (let distance = 0; distance < colors.length; distance++) {
+        const before = colors[index - distance];
+        if (before !== undefined && before.saturation > 0)
+            return before.hue;
+        const after = colors[index + distance];
+        if (after !== undefined && after.saturation > 0)
+            return after.hue;
+    }
+    return 0;
+}
+//# sourceMappingURL=tone.js.map

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

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

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

@@ -0,0 +1,36 @@
+import type { Swatch } from './interpolate.ts';
+/**
+ * What a colour-scale picker offering one colour writes for it, and a link
+ * carries: every value the same colour, so the figure needs no key. Followed by
+ * `-` and a hex colour, e.g. `uniform-1c6e42`, it names that colour.
+ */
+export declare const UNIFORM_COLOR_SCALE_ID = "uniform";
+/**
+ * The one colour of a uniform scale that names none: the family's border grey
+ * rather than white, so a cell still stands out from a white page and from the
+ * white ground of a saved figure.
+ */
+export declare const UNIFORM_SWATCH: Swatch;
+/**
+ * Whether a scale text asks for one colour.
+ * @param text - A scale id or a custom scale, as a link carries it.
+ * @returns `true` for {@link UNIFORM_COLOR_SCALE_ID}, with or without a colour.
+ */
+export declare function isUniformColorScale(text: string | undefined): boolean;
+/**
+ * The colour a uniform scale text names, and the ink to write on it.
+ *
+ * A colour with a typo in it falls back to the grey rather than failing, so a
+ * link written by hand still opens the figure.
+ * @param text - A scale text, e.g. `uniform` or `uniform-1c6e42`.
+ * @returns The swatch it names, or {@link UNIFORM_SWATCH}.
+ */
+export declare function uniformSwatch(text: string | undefined): Swatch;
+/**
+ * Write one colour as the scale text a link carries; the `#` is dropped, since
+ * a query string is cut in two at the first one.
+ * @param color - The colour, as `#rgb` or `#rrggbb`.
+ * @returns E.g. `uniform-1c6e42`, or {@link UNIFORM_COLOR_SCALE_ID} when the colour is not a hex colour.
+ */
+export declare function formatUniformColorScale(color: string): string;
+//# sourceMappingURL=uniform.d.ts.map