react-cheminfo 0.47.0 → 0.49.0

package/lib/taxonomy/ui/TaxonLineage.d.ts

@@ -0,0 +1,67 @@
+import type { ReactElement } from 'react';
+import type { Taxon, TaxonLineage as Lineage } from '../core/lineage.ts';
+/** What a {@link TaxonLineage} needs. */
+export interface TaxonLineageProps {
+    /** The lineage, from the top of the tree down to the taxon it leads to. */
+    lineage: Lineage;
+    /**
+     * Whether only the principal ranks are shown — domain, kingdom, phylum,
+     * class, order, family, genus, species — with the last taxon kept whatever
+     * its rank. Off, every taxon is shown, the clades included.
+     * @default true
+     */
+    principal?: boolean;
+    /**
+     * The address of a taxon's page on the site. A taxon it answers `undefined`
+     * for is written as plain text, and so is every taxon without it.
+     * @default undefined
+     */
+    taxonHref?: (taxon: Taxon) => string | undefined;
+    /**
+     * What the site does when a taxon's link is followed with a plain click —
+     * move to its page without a reload. A modified click is left to the
+     * browser, so a taxon still opens in a tab of its own.
+     * @default undefined
+     */
+    onTaxonSelect?: (taxon: Taxon) => void;
+    /**
+     * Whether each taxon carries its rank as a small label over its name.
+     * Without it the rank is the taxon's tooltip, and is read to a screen reader
+     * after the name.
+     * @default false
+     */
+    showRanks?: boolean;
+    /**
+     * Whether a link to the last taxon's page in the NCBI Taxonomy Browser
+     * follows the lineage, when that taxon has an id.
+     * @default false
+     */
+    ncbiLink?: boolean;
+    /**
+     * Whether the last taxon is the page being read: it is then marked as the
+     * current page and is never a link.
+     * @default false
+     */
+    current?: boolean;
+    /**
+     * What names the breadcrumb to a screen reader.
+     * @default the catalog's "Lineage"
+     */
+    label?: string;
+    /**
+     * Class names added to the root element.
+     * @default undefined
+     */
+    className?: string;
+}
+/**
+ * A lineage as a breadcrumb: the taxa from the top of the tree down, each
+ * named with its rank, the last one emphasised.
+ *
+ * The names under a genus are set in italics as nomenclature sets them, by
+ * {@link OrganismName}; the ranks are the chrome's words, translated with it.
+ * @param props - See {@link TaxonLineageProps}.
+ * @returns The breadcrumb, or nothing for an empty lineage.
+ */
+export declare function TaxonLineage(props: TaxonLineageProps): ReactElement | null;
+//# sourceMappingURL=TaxonLineage.d.ts.map

package/lib/taxonomy/ui/TaxonLineage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaxonLineage.d.ts","sourceRoot":"","sources":["../../../src/taxonomy/ui/TaxonLineage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,OAAO,CAAC;AAKrD,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAOzE,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,GAAG,SAAS,CAAC;IACjD;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACvC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,GAAG,IAAI,CA0G1E"}

package/lib/taxonomy/ui/TaxonLineage.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { isModifiedClick } from "../../chrome/ui/navItem.js";
+import { useChromeT } from "../../i18n/ui/useT.js";
+import { joinClassNames } from "../../shared/ui/joinClassNames.js";
+import { genusOrBelow, principalLineage } from "../core/lineage.js";
+import { ncbiTaxonomyUrl } from "../core/ncbi.js";
+import { OrganismName } from "./OrganismName.js";
+import { rankLabel } from "./rankLabel.js";
+/**
+ * A lineage as a breadcrumb: the taxa from the top of the tree down, each
+ * named with its rank, the last one emphasised.
+ *
+ * The names under a genus are set in italics as nomenclature sets them, by
+ * {@link OrganismName}; the ranks are the chrome's words, translated with it.
+ * @param props - See {@link TaxonLineageProps}.
+ * @returns The breadcrumb, or nothing for an empty lineage.
+ */
+export function TaxonLineage(props) {
+    const { lineage, principal = true, taxonHref, onTaxonSelect, showRanks = false, ncbiLink = false, current = false, label, className, } = props;
+    const t = useChromeT();
+    const shown = principal ? principalLineage(lineage) : lineage;
+    if (shown.length === 0)
+        return null;
+    const italic = genusOrBelow(shown);
+    const steps = [];
+    for (let index = 0; index < shown.length; index++) {
+        const taxon = shown[index];
+        const last = index === shown.length - 1;
+        const rank = rankLabel(t, taxon.rank);
+        const name = italic[index] ? (_jsx(OrganismName, { name: taxon.name })) : (taxon.name);
+        const isCurrent = last && current;
+        const href = isCurrent ? undefined : taxonHref?.(taxon);
+        steps.push(_jsxs("li", { className: joinClassNames('taxon-lineage__taxon', last && 'taxon-lineage__taxon--leaf'), title: showRanks ? undefined : rank, children: [_jsxs("span", { className: "taxon-lineage__step", children: [showRanks && _jsx("span", { className: "taxon-lineage__rank", children: rank }), href === undefined ? (_jsx("span", { className: "taxon-lineage__name", "aria-current": isCurrent ? 'page' : undefined, children: name })) : (_jsx("a", { className: "taxon-lineage__name", href: href, onClick: onTaxonSelect === undefined
+                                ? undefined
+                                : (event) => {
+                                    if (isModifiedClick(event) || event.button !== 0)
+                                        return;
+                                    event.preventDefault();
+                                    onTaxonSelect(taxon);
+                                }, children: name })), !showRanks && (_jsxs("span", { className: "taxon-lineage__spoken", children: [' ', t('taxonomy.rankNote', { rank })] }))] }), last ? (ncbiLink &&
+                    taxon.taxId !== undefined && (_jsx("a", { className: "taxon-lineage__ncbi", href: ncbiTaxonomyUrl(taxon.taxId), target: "_blank", rel: "noreferrer", title: t('taxonomy.ncbiTitle', { name: taxon.name }), children: t('taxonomy.ncbi') }))) : (_jsx("span", { className: "taxon-lineage__separator", "aria-hidden": "true", children: "\u203A" }))] }, `${taxon.taxId ?? ''}:${taxon.rank}:${taxon.name}`));
+    }
+    return (_jsx("nav", { className: joinClassNames('taxon-lineage', showRanks && 'taxon-lineage--ranks', className), "aria-label": label ?? t('taxonomy.lineage'), children: _jsx("ol", { className: "taxon-lineage__list", children: steps }) }));
+}
+//# sourceMappingURL=TaxonLineage.js.map

package/lib/taxonomy/ui/TaxonLineage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaxonLineage.js","sourceRoot":"","sources":["../../../src/taxonomy/ui/TaxonLineage.tsx"],"names":[],"mappings":"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"}

package/lib/taxonomy/ui/index.d.ts

@@ -0,0 +1,6 @@
+export type { OrganismNameProps } from './OrganismName.tsx';
+export { OrganismName } from './OrganismName.tsx';
+export type { TaxonLineageProps } from './TaxonLineage.tsx';
+export { TaxonLineage } from './TaxonLineage.tsx';
+export { useRankLabel } from './rankLabel.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/taxonomy/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/taxonomy/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/taxonomy/ui/index.js

@@ -0,0 +1,4 @@
+export { OrganismName } from "./OrganismName.js";
+export { TaxonLineage } from "./TaxonLineage.js";
+export { useRankLabel } from "./rankLabel.js";
+//# sourceMappingURL=index.js.map

package/lib/taxonomy/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/taxonomy/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAoB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/taxonomy/ui/rankLabel.d.ts

@@ -0,0 +1,17 @@
+import type { ChromeKey } from '../../i18n/core/chromeCatalog.ts';
+import type { Translate } from '../../i18n/ui/useT.ts';
+/**
+ * A rank as the reader's language names it.
+ * @param t - The chrome's formatter.
+ * @param rank - The rank, as NCBI writes it.
+ * @returns Its label, or the rank itself when the catalog has none for it.
+ */
+export declare function rankLabel(t: Translate<ChromeKey>, rank: string): string;
+/**
+ * The label of a rank in the reader's language, for a site writing a rank
+ * beside the lineage — a taxon's heading, a list of its children.
+ * @returns `label(rank)`: the rank as NCBI writes it, named the way the chrome
+ * names it; a rank the catalog does not know is returned as it is.
+ */
+export declare function useRankLabel(): (rank: string) => string;
+//# sourceMappingURL=rankLabel.d.ts.map

package/lib/taxonomy/ui/rankLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rankLabel.d.ts","sourceRoot":"","sources":["../../../src/taxonomy/ui/rankLabel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AA2DvD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAGvD"}

package/lib/taxonomy/ui/rankLabel.js

@@ -0,0 +1,77 @@
+import { useChromeT } from "../../i18n/ui/useT.js";
+// Each rank NCBI writes, with the key its label is translated under. Written
+// out rather than built from the rank, so a key the catalog lacks fails the
+// type check instead of rendering raw.
+const RANK_KEYS = {
+    realm: 'taxonomy.rank.realm',
+    domain: 'taxonomy.rank.domain',
+    superkingdom: 'taxonomy.rank.superkingdom',
+    kingdom: 'taxonomy.rank.kingdom',
+    subkingdom: 'taxonomy.rank.subkingdom',
+    superphylum: 'taxonomy.rank.superphylum',
+    phylum: 'taxonomy.rank.phylum',
+    subphylum: 'taxonomy.rank.subphylum',
+    superclass: 'taxonomy.rank.superclass',
+    class: 'taxonomy.rank.class',
+    subclass: 'taxonomy.rank.subclass',
+    infraclass: 'taxonomy.rank.infraclass',
+    cohort: 'taxonomy.rank.cohort',
+    subcohort: 'taxonomy.rank.subcohort',
+    superorder: 'taxonomy.rank.superorder',
+    order: 'taxonomy.rank.order',
+    suborder: 'taxonomy.rank.suborder',
+    infraorder: 'taxonomy.rank.infraorder',
+    parvorder: 'taxonomy.rank.parvorder',
+    superfamily: 'taxonomy.rank.superfamily',
+    family: 'taxonomy.rank.family',
+    subfamily: 'taxonomy.rank.subfamily',
+    tribe: 'taxonomy.rank.tribe',
+    subtribe: 'taxonomy.rank.subtribe',
+    genus: 'taxonomy.rank.genus',
+    subgenus: 'taxonomy.rank.subgenus',
+    section: 'taxonomy.rank.section',
+    subsection: 'taxonomy.rank.subsection',
+    series: 'taxonomy.rank.series',
+    subseries: 'taxonomy.rank.subseries',
+    'species group': 'taxonomy.rank.speciesGroup',
+    'species subgroup': 'taxonomy.rank.speciesSubgroup',
+    species: 'taxonomy.rank.species',
+    'forma specialis': 'taxonomy.rank.formaSpecialis',
+    subspecies: 'taxonomy.rank.subspecies',
+    varietas: 'taxonomy.rank.varietas',
+    subvariety: 'taxonomy.rank.subvariety',
+    forma: 'taxonomy.rank.forma',
+    pathogroup: 'taxonomy.rank.pathogroup',
+    serogroup: 'taxonomy.rank.serogroup',
+    serotype: 'taxonomy.rank.serotype',
+    biotype: 'taxonomy.rank.biotype',
+    genotype: 'taxonomy.rank.genotype',
+    morph: 'taxonomy.rank.morph',
+    strain: 'taxonomy.rank.strain',
+    isolate: 'taxonomy.rank.isolate',
+    'no rank': 'taxonomy.rank.noRank',
+    clade: 'taxonomy.rank.clade',
+    'cellular root': 'taxonomy.rank.cellularRoot',
+    'acellular root': 'taxonomy.rank.acellularRoot',
+};
+/**
+ * A rank as the reader's language names it.
+ * @param t - The chrome's formatter.
+ * @param rank - The rank, as NCBI writes it.
+ * @returns Its label, or the rank itself when the catalog has none for it.
+ */
+export function rankLabel(t, rank) {
+    const key = Object.hasOwn(RANK_KEYS, rank) ? RANK_KEYS[rank] : undefined;
+    return key === undefined ? rank : t(key);
+}
+/**
+ * The label of a rank in the reader's language, for a site writing a rank
+ * beside the lineage — a taxon's heading, a list of its children.
+ * @returns `label(rank)`: the rank as NCBI writes it, named the way the chrome
+ * names it; a rank the catalog does not know is returned as it is.
+ */
+export function useRankLabel() {
+    const t = useChromeT();
+    return (rank) => rankLabel(t, rank);
+}
+//# sourceMappingURL=rankLabel.js.map

package/lib/taxonomy/ui/rankLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rankLabel.js","sourceRoot":"","sources":["../../../src/taxonomy/ui/rankLabel.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,6EAA6E;AAC7E,4EAA4E;AAC5E,uCAAuC;AACvC,MAAM,SAAS,GAAwC;IACrD,KAAK,EAAE,qBAAqB;IAC5B,MAAM,EAAE,sBAAsB;IAC9B,YAAY,EAAE,4BAA4B;IAC1C,OAAO,EAAE,uBAAuB;IAChC,UAAU,EAAE,0BAA0B;IACtC,WAAW,EAAE,2BAA2B;IACxC,MAAM,EAAE,sBAAsB;IAC9B,SAAS,EAAE,yBAAyB;IACpC,UAAU,EAAE,0BAA0B;IACtC,KAAK,EAAE,qBAAqB;IAC5B,QAAQ,EAAE,wBAAwB;IAClC,UAAU,EAAE,0BAA0B;IACtC,MAAM,EAAE,sBAAsB;IAC9B,SAAS,EAAE,yBAAyB;IACpC,UAAU,EAAE,0BAA0B;IACtC,KAAK,EAAE,qBAAqB;IAC5B,QAAQ,EAAE,wBAAwB;IAClC,UAAU,EAAE,0BAA0B;IACtC,SAAS,EAAE,yBAAyB;IACpC,WAAW,EAAE,2BAA2B;IACxC,MAAM,EAAE,sBAAsB;IAC9B,SAAS,EAAE,yBAAyB;IACpC,KAAK,EAAE,qBAAqB;IAC5B,QAAQ,EAAE,wBAAwB;IAClC,KAAK,EAAE,qBAAqB;IAC5B,QAAQ,EAAE,wBAAwB;IAClC,OAAO,EAAE,uBAAuB;IAChC,UAAU,EAAE,0BAA0B;IACtC,MAAM,EAAE,sBAAsB;IAC9B,SAAS,EAAE,yBAAyB;IACpC,eAAe,EAAE,4BAA4B;IAC7C,kBAAkB,EAAE,+BAA+B;IACnD,OAAO,EAAE,uBAAuB;IAChC,iBAAiB,EAAE,8BAA8B;IACjD,UAAU,EAAE,0BAA0B;IACtC,QAAQ,EAAE,wBAAwB;IAClC,UAAU,EAAE,0BAA0B;IACtC,KAAK,EAAE,qBAAqB;IAC5B,UAAU,EAAE,0BAA0B;IACtC,SAAS,EAAE,yBAAyB;IACpC,QAAQ,EAAE,wBAAwB;IAClC,OAAO,EAAE,uBAAuB;IAChC,QAAQ,EAAE,wBAAwB;IAClC,KAAK,EAAE,qBAAqB;IAC5B,MAAM,EAAE,sBAAsB;IAC9B,OAAO,EAAE,uBAAuB;IAChC,SAAS,EAAE,sBAAsB;IACjC,KAAK,EAAE,qBAAqB;IAC5B,eAAe,EAAE,4BAA4B;IAC7C,gBAAgB,EAAE,6BAA6B;CAChD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,CAAuB,EAAE,IAAY;IAC7D,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/lib/ui.d.ts

@@ -31,6 +31,7 @@ export * from './scatter3d/ui/index.ts';
 export * from './share/ui/index.ts';
 export * from './shared/ui/index.ts';
 export * from './split/ui/index.ts';
+export * from './taxonomy/ui/index.ts';
 export type { ConformerTableProps } from './structure/ui/ConformerTable.tsx';
 export { ConformerTable } from './structure/ui/ConformerTable.tsx';
 export type { ConformerColumn } from './structure/ui/conformerColumns.ts';

package/lib/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AAKpC,YAAY,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AAKvC,YAAY,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,MAAM,oCAAoC,CAAC"}

package/lib/ui.js

@@ -31,6 +31,7 @@ export * from "./scatter3d/ui/index.js";
 export * from "./share/ui/index.js";
 export * from "./shared/ui/index.js";
 export * from "./split/ui/index.js";
+export * from "./taxonomy/ui/index.js";
 export { ConformerTable } from "./structure/ui/ConformerTable.js";
 export { CONFORMER_COLUMN_LABELS, PICKER_COLUMNS, RANKING_COLUMNS, } from "./structure/ui/conformerColumns.js";
 //# sourceMappingURL=ui.js.map

package/lib/ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AAMpC,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAmC,CAAC;AAEnE,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AAMvC,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAmC,CAAC;AAEnE,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,MAAM,oCAAoC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-cheminfo",
-  "version": "0.47.0",
+  "version": "0.49.0",
   "license": "MIT",
   "description": "React components, hooks and framework-free helpers shared by the cheminfo sites: site chrome, citations, sharing, routing, pedagogy, charts, and the structure, orbital and 3D molecule viewers",
   "author": "Luc Patiny",

package/src/core.ts

@@ -35,5 +35,6 @@ export * from './state/core/index.ts';
 // 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.ts';
+export * from './taxonomy/core/index.ts';
 export * from './tokens/core/index.ts';
 export * from './worker/core/index.ts';

package/src/download/core/cssPaint.ts

@@ -0,0 +1,71 @@
+/**
+ * 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: string): string | undefined {
+  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: string,
+  width: number,
+): readonly number[] | undefined {
+  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: string,
+  width: number,
+  height: number,
+): number {
+  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*)?%?\)$/;

package/src/download/core/drawingMarkup.ts

@@ -0,0 +1,35 @@
+import { cssTokenNames, resolveCssTokens } from './cssTokens.ts';
+
+/**
+ * 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: SVGSVGElement): string {
+  const clone = drawing.cloneNode(true) as SVGSVGElement;
+  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: SVGSVGElement,
+  names: readonly string[],
+): Record<string, string> {
+  const values: Record<string, string> = {};
+  if (names.length === 0) return values;
+  const styles = window.getComputedStyle(drawing);
+  for (const name of names) {
+    values[name] = styles.getPropertyValue(name);
+  }
+  return values;
+}

package/src/download/core/figureHtml.ts

@@ -0,0 +1,214 @@
+/**
+ * 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.ts';
+import { drawingMarkup } from './drawingMarkup.ts';
+import type { HtmlPaint } from './figureHtmlMarkup.ts';
+import { figureHtmlMarkup } from './figureHtmlMarkup.ts';
+import { lineBoxes } from './textLines.ts';
+
+/** Chrome inside the part, which is not part of the picture. */
+const CHROME = '[data-figure="chrome"]';
+
+/** What every measurement of one part is taken against. */
+interface PaintContext {
+  /** The part's own box: every position is written from its corner. */
+  origin: DOMRect;
+  /** The type the document is set in, which a run need not repeat. */
+  documentFont: string;
+  /** One range, moved over each character in turn. */
+  range: Range;
+}
+
+/**
+ * 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: Element, documentFont: string): string {
+  const context: PaintContext = {
+    origin: part.getBoundingClientRect(),
+    documentFont,
+    range: document.createRange(),
+  };
+  const paints: HtmlPaint[] = [];
+  paintElement(part, context, paints);
+  return figureHtmlMarkup(paints);
+}
+
+function paintElement(
+  element: Element,
+  context: PaintContext,
+  into: HtmlPaint[],
+): void {
+  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: HtmlPaint[] = [];
+  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: DOMRect,
+  styles: CSSStyleDeclaration,
+  context: PaintContext,
+  into: HtmlPaint[],
+): void {
+  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: DOMRect,
+  styles: CSSStyleDeclaration,
+  context: PaintContext,
+  into: HtmlPaint[],
+): void {
+  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: Text,
+  styles: CSSStyleDeclaration,
+  context: PaintContext,
+  into: HtmlPaint[],
+): void {
+  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: string, transform: string): string {
+  if (transform === 'uppercase') return words.toUpperCase();
+  if (transform === 'lowercase') return words.toLowerCase();
+  return words;
+}