react-cheminfo 0.47.0 → 0.48.0

package/README.md

@@ -114,6 +114,7 @@ through a wildcard subpath exactly as `react-science` serves its own.
 | **Projections**            | `pcaResult`, `embeddingResult`, `projectionTabs`, `loadingProfiles`, `explainedShares`, `confidenceEllipse`, `projectEllipse`, `pointsInPolygon`, `resolveProjectionGroups`, `resolveProjectionShapes`, `PROJECTION_COPY`                                                  | `PcaViewer`, `ProjectionViewer`, `ScatterPlot`, `ScatterMatrix`                                                                                                                                                                                                                                     |
 | **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`                                                                                                                                                                                                                                                      |
 
 Everything in that table is exported from `./core`, `./ui`, `./slides`,
 `./vite` or `./structure` and nothing else is: the sub-components a component is built
@@ -637,6 +638,31 @@ stopped moving. Draw exactly what is on screen; only the box changes.
 A chart that measures its own container can ignore `size`: the copy is mounted
 in a box of exactly that size.
 
+A figure drawn in HTML rather than SVG is saved too. Mark its box
+`data-figure="html"`, and each ground, border, outline and line of words in it
+is painted into the file from where the browser put it, so the copy matches the
+screen. Anything marked `data-figure="chrome"` inside it stays behind. Images,
+gradients, shadows and `::before` / `::after` content are not painted.
+
+`PeriodicTable` is one, so the save glyph can sit wherever the site keeps its
+controls. Point it at a box around the table and anything that belongs in the
+picture, such as the site's own colour key:
+
+```tsx
+<div className="no-print">
+  <PropertySelect … />
+  <FigureDownload targetId="table-figure" fileName="electronegativity" />
+</div>
+<div id="table-figure" data-figure="html">
+  <PeriodicTable headers swatchOf={swatchFor} />
+  <Legend … />
+</div>
+```
+
+Marking the box itself `data-figure="html"` paints everything in it, the key's
+labels included. The corner that selects the whole table shows itself only when
+pointed at or reached from the keyboard, and is neither printed nor saved.
+
 `downloadFigure(target, options)`, `figureSvg` and `figurePng` are the same thing
 without the button, for a site saving a figure from its own menu.
 
@@ -671,6 +697,49 @@ import { RangeSlider } from 'react-cheminfo/ui';
 - **`histogram`** takes one count per equal-width bin, drawn over the track with
   the part the handles keep in the brand colour.
 
+### `TaxonLineage` and `OrganismName`
+
+Where an organism sits in the tree of life, as a breadcrumb, and its name set
+the way nomenclature sets it.
+
+```tsx
+import { lineageFromNodes } from 'react-cheminfo/core';
+import { OrganismName, TaxonLineage } from 'react-cheminfo/ui';
+
+<OrganismName name="Catharanthus roseus (L.) G. Don" />;
+
+<TaxonLineage
+  lineage={lineageFromNodes(taxa, taxId)}
+  taxonHref={(taxon) => `/taxonomy/${taxon.taxId}`}
+  onTaxonSelect={(taxon) => navigate(`/taxonomy/${taxon.taxId}`)}
+  ncbiLink
+/>;
+```
+
+- **A lineage is `{ rank, name, taxId? }[]`, from the top down.** It is read
+  from a map of NCBI nodes pointing at their parents (`lineageFromNodes`), from
+  a record of names by rank as octochemdb stores it (`lineageFromRanks`), or
+  written as it is.
+- **The principal ranks are shown by default** — domain, kingdom, phylum,
+  class, order, family, genus, species — with the last taxon kept whatever its
+  rank. `principal={false}` shows every clade, for a page walking the tree.
+- **Each rank is a tooltip, or a small label over the name** with `showRanks`.
+  The labels are the chrome's words, translated with it; `useRankLabel()` names
+  a rank the same way anywhere else on the page.
+- **A taxon is a link only when `taxonHref` gives it an address**, and
+  `onTaxonSelect` takes over its plain click so the site moves without a
+  reload. `current` marks the last taxon as the page being read; `ncbiLink`
+  adds the way out to the NCBI Taxonomy Browser.
+- **Italics follow the rank, then the name.** The names from the genus down go
+  through `splitOrganismName`, which sets the genus and the epithets in italics
+  and the authority, the strain, `sp.`, a cultivar and the words announcing a
+  rank (`subsp.`, `var.`, `f.`) upright. It reads a name by its shape, as the
+  source wrote it, and leaves upright what it cannot place.
+
+The type is `TaxonLineage` in `react-cheminfo/core` and the component
+`TaxonLineage` in `react-cheminfo/ui`; a file needing both imports one of them
+under another name.
+
 ### `ParallelCoordinates`
 
 Many rows against many properties at once: one vertical axis per column, one

package/lib/core.d.ts

@@ -31,6 +31,7 @@ export * from './slides/core/index.ts';
 export * from './split/core/index.ts';
 export * from './state/core/index.ts';
 export * from './structure/core/index.ts';
+export * from './taxonomy/core/index.ts';
 export * from './tokens/core/index.ts';
 export * from './worker/core/index.ts';
 //# sourceMappingURL=core.d.ts.map

package/lib/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC"}

package/lib/core.js

@@ -35,6 +35,7 @@ export * from "./state/core/index.js";
 // Framework-free molfile and editor-value helpers, so a worker can read a
 // molfile without loading the editor that `react-cheminfo/structure` exports.
 export * from "./structure/core/index.js";
+export * from "./taxonomy/core/index.js";
 export * from "./tokens/core/index.js";
 export * from "./worker/core/index.js";
 //# sourceMappingURL=core.js.map

package/lib/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,+EAA+E;AAC/E,2EAA2E;AAC3E,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,0EAA0E;AAC1E,8EAA8E;AAC9E,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,+EAA+E;AAC/E,2EAA2E;AAC3E,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,0EAA0E;AAC1E,8EAA8E;AAC9E,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC"}

package/lib/download/core/cssPaint.d.ts

@@ -0,0 +1,27 @@
+/**
+ * What a computed style says is painted, read the way a figure file needs it.
+ */
+/**
+ * A colour, or nothing where the page paints nothing with it.
+ * @param color - A computed colour, as `getComputedStyle` writes it.
+ * @returns The colour, or undefined where it is transparent.
+ */
+export declare function visibleColor(color: string): string | undefined;
+/**
+ * The dashes a CSS line style is drawn with.
+ * @param style - The computed `border-*-style` or `outline-style`.
+ * @param width - The line's width, in pixels.
+ * @returns The dashes and gaps in pixels — empty for a solid line — or
+ *   undefined where no line is drawn. `auto` is a focus ring, which is the
+ *   state of the pointer rather than a part of the figure.
+ */
+export declare function lineDash(style: string, width: number): readonly number[] | undefined;
+/**
+ * A corner radius in pixels.
+ * @param radius - The computed `border-*-radius`, in pixels or as a share.
+ * @param width - The box's width, which a share is taken of.
+ * @param height - Its height.
+ * @returns The radius, in pixels.
+ */
+export declare function cornerRadius(radius: string, width: number, height: number): number;
+//# sourceMappingURL=cssPaint.d.ts.map

package/lib/download/core/cssPaint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssPaint.d.ts","sourceRoot":"","sources":["../../../src/download/core/cssPaint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO9D;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,SAAS,MAAM,EAAE,GAAG,SAAS,CAe/B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,MAAM,CAOR"}

package/lib/download/core/cssPaint.js

@@ -0,0 +1,63 @@
+/**
+ * What a computed style says is painted, read the way a figure file needs it.
+ */
+/**
+ * A colour, or nothing where the page paints nothing with it.
+ * @param color - A computed colour, as `getComputedStyle` writes it.
+ * @returns The colour, or undefined where it is transparent.
+ */
+export function visibleColor(color) {
+    const value = color.trim();
+    if (value === '' || value === 'transparent')
+        return undefined;
+    if (ZERO_ALPHA_COMMAS.test(value) || ZERO_ALPHA_SLASH.test(value)) {
+        return undefined;
+    }
+    return value;
+}
+/**
+ * The dashes a CSS line style is drawn with.
+ * @param style - The computed `border-*-style` or `outline-style`.
+ * @param width - The line's width, in pixels.
+ * @returns The dashes and gaps in pixels — empty for a solid line — or
+ *   undefined where no line is drawn. `auto` is a focus ring, which is the
+ *   state of the pointer rather than a part of the figure.
+ */
+export function lineDash(style, width) {
+    if (!(width > 0))
+        return undefined;
+    switch (style) {
+        case 'none':
+        case 'hidden':
+        case 'auto':
+        case '':
+            return undefined;
+        case 'dashed':
+            return [width * 3, width * 3];
+        case 'dotted':
+            return [width, width];
+        default:
+            return [];
+    }
+}
+/**
+ * A corner radius in pixels.
+ * @param radius - The computed `border-*-radius`, in pixels or as a share.
+ * @param width - The box's width, which a share is taken of.
+ * @param height - Its height.
+ * @returns The radius, in pixels.
+ */
+export function cornerRadius(radius, width, height) {
+    const value = Number.parseFloat(radius);
+    if (!Number.isFinite(value) || value <= 0)
+        return 0;
+    if (radius.trim().endsWith('%')) {
+        return (Math.min(width, height) * value) / 100;
+    }
+    return value;
+}
+/** `rgba(r, g, b, 0)`, which is what a transparent ground computes to. */
+const ZERO_ALPHA_COMMAS = /^rgba\((?:[^,]+,){3}\s*0(?:\.0*)?\)$/;
+/** `rgb(r g b / 0)` and `color(srgb r g b / 0)`. */
+const ZERO_ALPHA_SLASH = /\/\s*0(?:\.0*)?%?\)$/;
+//# sourceMappingURL=cssPaint.js.map

package/lib/download/core/cssPaint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssPaint.js","sourceRoot":"","sources":["../../../src/download/core/cssPaint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,aAAa;QAAE,OAAO,SAAS,CAAC;IAC9D,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAa,EACb,KAAa;IAEb,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACnC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM,CAAC;QACZ,KAAK,EAAE;YACL,OAAO,SAAS,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAChC,KAAK,QAAQ;YACX,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxB;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,KAAa,EACb,MAAc;IAEd,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0EAA0E;AAC1E,MAAM,iBAAiB,GAAG,sCAAsC,CAAC;AAEjE,oDAAoD;AACpD,MAAM,gBAAgB,GAAG,sBAAsB,CAAC"}

package/lib/download/core/drawingMarkup.d.ts

@@ -0,0 +1,11 @@
+/**
+ * One drawing, serialized with every token it names written out.
+ *
+ * The copy is taken first and read from the original, because the values are a
+ * property of where the figure sits on the page: a detached clone inherits
+ * nothing and would resolve every token to an empty string.
+ * @param drawing - The drawing, as it sits on the page.
+ * @returns Its markup.
+ */
+export declare function drawingMarkup(drawing: SVGSVGElement): string;
+//# sourceMappingURL=drawingMarkup.d.ts.map

package/lib/download/core/drawingMarkup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawingMarkup.d.ts","sourceRoot":"","sources":["../../../src/download/core/drawingMarkup.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAI5D"}

package/lib/download/core/drawingMarkup.js

@@ -0,0 +1,32 @@
+import { cssTokenNames, resolveCssTokens } from "./cssTokens.js";
+/**
+ * One drawing, serialized with every token it names written out.
+ *
+ * The copy is taken first and read from the original, because the values are a
+ * property of where the figure sits on the page: a detached clone inherits
+ * nothing and would resolve every token to an empty string.
+ * @param drawing - The drawing, as it sits on the page.
+ * @returns Its markup.
+ */
+export function drawingMarkup(drawing) {
+    const clone = drawing.cloneNode(true);
+    const markup = new XMLSerializer().serializeToString(clone);
+    return resolveCssTokens(markup, tokenValues(drawing, cssTokenNames(markup)));
+}
+/**
+ * What each token the markup names is worth where the figure is drawn.
+ * @param drawing - The drawing, as it sits on the page.
+ * @param names - The tokens it asks for.
+ * @returns The values, keyed by token name.
+ */
+function tokenValues(drawing, names) {
+    const values = {};
+    if (names.length === 0)
+        return values;
+    const styles = window.getComputedStyle(drawing);
+    for (const name of names) {
+        values[name] = styles.getPropertyValue(name);
+    }
+    return values;
+}
+//# sourceMappingURL=drawingMarkup.js.map

package/lib/download/core/drawingMarkup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawingMarkup.js","sourceRoot":"","sources":["../../../src/download/core/drawingMarkup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,OAAsB;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAkB,CAAC;IACvD,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC5D,OAAO,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAClB,OAAsB,EACtB,KAAwB;IAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/download/core/figureHtml.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A part of a figure the page draws in HTML, painted from where the browser put
+ * it.
+ *
+ * Some figures are not drawings: a periodic table is a grid of buttons, because
+ * every cell has to be reachable by Tab and read by a screen reader. Saved as
+ * SVG it still has to look like the table the reader saw, so each box, each
+ * line round it and each line of words is measured off the page and painted
+ * again — never re-derived from the styles that made it, so the copy cannot
+ * drift from the screen.
+ *
+ * What is painted: a box's ground, its border (as drawn on its top edge), its
+ * corner, its outline, its opacity, every line of its words in their colour,
+ * size, weight and style, and any `<svg>` inside it. What is not: images,
+ * gradients, shadows, filters and generated `::before` / `::after` content.
+ * Chrome inside the part — `data-figure="chrome"` — is left behind.
+ */
+/**
+ * One part of a figure drawn in HTML, as SVG markup.
+ * @param part - The element the part is drawn in.
+ * @param documentFont - The font family the saved document is set in.
+ * @returns The markup, in the part's own coordinates: the caller places it.
+ */
+export declare function figureHtml(part: Element, documentFont: string): string;
+//# sourceMappingURL=figureHtml.d.ts.map

package/lib/download/core/figureHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figureHtml.d.ts","sourceRoot":"","sources":["../../../src/download/core/figureHtml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAqBH;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAStE"}

package/lib/download/core/figureHtml.js

@@ -0,0 +1,174 @@
+/**
+ * A part of a figure the page draws in HTML, painted from where the browser put
+ * it.
+ *
+ * Some figures are not drawings: a periodic table is a grid of buttons, because
+ * every cell has to be reachable by Tab and read by a screen reader. Saved as
+ * SVG it still has to look like the table the reader saw, so each box, each
+ * line round it and each line of words is measured off the page and painted
+ * again — never re-derived from the styles that made it, so the copy cannot
+ * drift from the screen.
+ *
+ * What is painted: a box's ground, its border (as drawn on its top edge), its
+ * corner, its outline, its opacity, every line of its words in their colour,
+ * size, weight and style, and any `<svg>` inside it. What is not: images,
+ * gradients, shadows, filters and generated `::before` / `::after` content.
+ * Chrome inside the part — `data-figure="chrome"` — is left behind.
+ */
+import { cornerRadius, lineDash, visibleColor } from "./cssPaint.js";
+import { drawingMarkup } from "./drawingMarkup.js";
+import { figureHtmlMarkup } from "./figureHtmlMarkup.js";
+import { lineBoxes } from "./textLines.js";
+/** Chrome inside the part, which is not part of the picture. */
+const CHROME = '[data-figure="chrome"]';
+/**
+ * One part of a figure drawn in HTML, as SVG markup.
+ * @param part - The element the part is drawn in.
+ * @param documentFont - The font family the saved document is set in.
+ * @returns The markup, in the part's own coordinates: the caller places it.
+ */
+export function figureHtml(part, documentFont) {
+    const context = {
+        origin: part.getBoundingClientRect(),
+        documentFont,
+        range: document.createRange(),
+    };
+    const paints = [];
+    paintElement(part, context, paints);
+    return figureHtmlMarkup(paints);
+}
+function paintElement(element, context, into) {
+    if (element.matches(CHROME))
+        return;
+    const styles = window.getComputedStyle(element);
+    if (styles.display === 'none')
+        return;
+    const visible = styles.visibility === 'visible';
+    const box = element.getBoundingClientRect();
+    if (element instanceof SVGSVGElement) {
+        if (!visible || box.width <= 0 || box.height <= 0)
+            return;
+        into.push({
+            kind: 'drawing',
+            markup: drawingMarkup(element),
+            x: box.left - context.origin.left,
+            y: box.top - context.origin.top,
+        });
+        return;
+    }
+    const own = [];
+    if (visible)
+        paintGround(box, styles, context, own);
+    for (const child of element.childNodes) {
+        if (child instanceof Text) {
+            if (visible)
+                paintText(child, styles, context, own);
+        }
+        else if (child instanceof Element) {
+            paintElement(child, context, own);
+        }
+    }
+    if (visible)
+        paintOutline(box, styles, context, own);
+    if (own.length === 0)
+        return;
+    const opacity = Number.parseFloat(styles.opacity);
+    if (Number.isFinite(opacity) && opacity < 1) {
+        into.push({ kind: 'group', opacity, children: own });
+        return;
+    }
+    for (const paint of own)
+        into.push(paint);
+}
+function paintGround(box, styles, context, into) {
+    if (box.width <= 0 || box.height <= 0)
+        return;
+    const x = box.left - context.origin.left;
+    const y = box.top - context.origin.top;
+    const radius = cornerRadius(styles.borderTopLeftRadius, box.width, box.height);
+    const fill = visibleColor(styles.backgroundColor);
+    if (fill !== undefined) {
+        into.push({
+            kind: 'box',
+            x,
+            y,
+            width: box.width,
+            height: box.height,
+            radius,
+            fill,
+        });
+    }
+    // A border lies inside the box, where a stroke straddles its line: the
+    // stroke is drawn half a width in, over the ground the page drew under it.
+    const width = Number.parseFloat(styles.borderTopWidth);
+    const dash = lineDash(styles.borderTopStyle, width);
+    const stroke = visibleColor(styles.borderTopColor);
+    if (dash === undefined || stroke === undefined)
+        return;
+    const half = width / 2;
+    into.push({
+        kind: 'box',
+        x: x + half,
+        y: y + half,
+        width: box.width - width,
+        height: box.height - width,
+        radius: Math.max(0, radius - half),
+        stroke,
+        strokeWidth: width,
+        dash,
+    });
+}
+function paintOutline(box, styles, context, into) {
+    const width = Number.parseFloat(styles.outlineWidth);
+    const dash = lineDash(styles.outlineStyle, width);
+    const stroke = visibleColor(styles.outlineColor);
+    if (dash === undefined || stroke === undefined)
+        return;
+    const offset = Number.parseFloat(styles.outlineOffset) || 0;
+    const grow = offset + width / 2;
+    const radius = cornerRadius(styles.borderTopLeftRadius, box.width, box.height);
+    into.push({
+        kind: 'box',
+        x: box.left - context.origin.left - grow,
+        y: box.top - context.origin.top - grow,
+        width: box.width + grow * 2,
+        height: box.height + grow * 2,
+        radius: radius > 0 ? Math.max(0, radius + grow) : 0,
+        stroke,
+        strokeWidth: width,
+        dash,
+    });
+}
+function paintText(node, styles, context, into) {
+    const color = visibleColor(styles.color);
+    if (color === undefined || node.data.trim() === '')
+        return;
+    const fontSize = Number.parseFloat(styles.fontSize);
+    const fontStyle = styles.fontStyle === 'normal' ? undefined : styles.fontStyle;
+    const fontFamily = styles.fontFamily === context.documentFont ? undefined : styles.fontFamily;
+    for (const line of lineBoxes(node, context.range)) {
+        const words = transformed(node.data.slice(line.start, line.end).replaceAll(/\s+/g, ' ').trim(), styles.textTransform);
+        if (words === '')
+            continue;
+        into.push({
+            kind: 'text',
+            text: words,
+            x: line.left - context.origin.left,
+            y: (line.top + line.bottom) / 2 - context.origin.top,
+            width: line.right - line.left,
+            color,
+            fontSize,
+            fontWeight: styles.fontWeight,
+            fontStyle,
+            fontFamily,
+        });
+    }
+}
+function transformed(words, transform) {
+    if (transform === 'uppercase')
+        return words.toUpperCase();
+    if (transform === 'lowercase')
+        return words.toLowerCase();
+    return words;
+}
+//# sourceMappingURL=figureHtml.js.map

package/lib/download/core/figureHtml.js.map

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

package/lib/download/core/figureHtmlMarkup.d.ts

@@ -0,0 +1,107 @@
+/**
+ * A part of a figure drawn in HTML, written out as SVG.
+ *
+ * The part is measured off the page first (`figureHtml.ts`); what reaches this
+ * module is already a list of boxes, runs of words and drawings with where each
+ * one sits, so the file it becomes can be read — and tested — without a page.
+ */
+/** A box the browser painted: a ground, a line round it, or both. */
+export interface HtmlPaintBox {
+    /** What it is. */
+    kind: 'box';
+    /** Its left edge, in pixels from the left of the part. */
+    x: number;
+    /** Its top edge, in pixels from the top of the part. */
+    y: number;
+    /** Its width, in pixels. */
+    width: number;
+    /** Its height. */
+    height: number;
+    /**
+     * How round its corners are, in pixels.
+     * @default 0
+     */
+    radius?: number;
+    /**
+     * What fills it.
+     * @default undefined — it is not filled
+     */
+    fill?: string;
+    /**
+     * The colour of the line round it, centred on its edge.
+     * @default undefined — no line is drawn
+     */
+    stroke?: string;
+    /**
+     * How heavy that line is, in pixels.
+     * @default 1
+     */
+    strokeWidth?: number;
+    /**
+     * The line's dashes and gaps, in pixels.
+     * @default undefined — a solid line
+     */
+    dash?: readonly number[];
+}
+/** One line of words, set where the browser set it. */
+export interface HtmlPaintText {
+    /** What it is. */
+    kind: 'text';
+    /** What it says, its spaces already collapsed. */
+    text: string;
+    /** Its left edge, in pixels from the left of the part. */
+    x: number;
+    /** The middle of its line, in pixels from the top of the part. */
+    y: number;
+    /**
+     * How wide the browser drew it. The words are fitted to it, so a run the
+     * page condensed stays condensed and a reader opening the file with another
+     * font gets the same layout.
+     */
+    width: number;
+    /** Its colour. */
+    color: string;
+    /** Its size, in pixels. */
+    fontSize: number;
+    /** Its weight. */
+    fontWeight: string;
+    /**
+     * Its style.
+     * @default undefined — upright
+     */
+    fontStyle?: string;
+    /**
+     * Its type, where it is not the one the document is set in.
+     * @default undefined — the document's own
+     */
+    fontFamily?: string;
+}
+/** A drawing inside the part, already an SVG of its own. */
+export interface HtmlPaintDrawing {
+    /** What it is. */
+    kind: 'drawing';
+    /** The `<svg>` element as it was serialized, tokens already resolved. */
+    markup: string;
+    /** Its left edge, in pixels from the left of the part. */
+    x: number;
+    /** Its top edge, in pixels from the top of the part. */
+    y: number;
+}
+/** Everything inside an element the page drew faded. */
+export interface HtmlPaintGroup {
+    /** What it is. */
+    kind: 'group';
+    /** How opaque the whole of it is, from 0 to 1. */
+    opacity: number;
+    /** What it holds, in the order it is painted. */
+    children: readonly HtmlPaint[];
+}
+/** One thing painted from a part of the page. */
+export type HtmlPaint = HtmlPaintBox | HtmlPaintText | HtmlPaintDrawing | HtmlPaintGroup;
+/**
+ * The part, as the markup that goes into the saved figure.
+ * @param paints - What was measured, in the order it is painted.
+ * @returns The markup, in the part's own coordinates: the caller places it.
+ */
+export declare function figureHtmlMarkup(paints: readonly HtmlPaint[]): string;
+//# sourceMappingURL=figureHtmlMarkup.d.ts.map

package/lib/download/core/figureHtmlMarkup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figureHtmlMarkup.d.ts","sourceRoot":"","sources":["../../../src/download/core/figureHtmlMarkup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,kBAAkB;IAClB,IAAI,EAAE,KAAK,CAAC;IACZ,0DAA0D;IAC1D,CAAC,EAAE,MAAM,CAAC;IACV,wDAAwD;IACxD,CAAC,EAAE,MAAM,CAAC;IACV,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,CAAC,EAAE,MAAM,CAAC;IACV,kEAAkE;IAClE,CAAC,EAAE,MAAM,CAAC;IACV;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,CAAC,EAAE,MAAM,CAAC;IACV,wDAAwD;IACxD,CAAC,EAAE,MAAM,CAAC;CACX;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;CAChC;AAED,iDAAiD;AACjD,MAAM,MAAM,SAAS,GACnB,YAAY,GAAG,aAAa,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAIrE"}