react-cheminfo 0.2.0 → 0.4.0

package/lib/ecosystem/ui/marks.js

@@ -1,4 +1,6 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { siteById } from "../core/lookup.js";
+import { GLYPHS } from "./glyphs.js";
 // Every mark is drawn in the same 32×32 box, on a plate of the site's own
 // colour, so every mark of the family still reads as one row. Each keeps the
 // geometry of that site's own logo where it has one, and carries the site's
@@ -7,43 +9,20 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 const MARK_STYLE = { display: 'block', flex: 'none' };
 /**
  * The little logo of one site of the family.
- * @param props - The site and the size of its mark.
+ * @param props - Which site, how big, and where its colours come from.
  * @returns The mark, as an inline SVG.
+ * @throws {Error} When neither `site` nor `siteId` is given.
  */
 export function SiteMark(props) {
-    const { site, size = 28 } = props;
-    return (_jsxs("svg", { style: MARK_STYLE, width: size, height: size, viewBox: "0 0 32 32", "aria-hidden": "true", focusable: "false", children: [_jsx("rect", { x: site.mark.edge ? 0.5 : 0, y: site.mark.edge ? 0.5 : 0, width: site.mark.edge ? 31 : 32, height: site.mark.edge ? 31 : 32, rx: site.mark.edge ? 6.5 : 7, fill: site.mark.plate, stroke: site.mark.edge }), GLYPHS[site.id](site.mark.accent)] }));
+    const { site, siteId, size = 28, plate = true, colors = 'literal' } = props;
+    const drawn = site ?? (siteId === undefined ? undefined : siteById(siteId));
+    if (drawn === undefined) {
+        throw new Error('SiteMark needs one of its `site` and `siteId` props');
+    }
+    const usesTokens = colors === 'tokens';
+    const plateFill = usesTokens ? 'var(--brand)' : drawn.mark.plate;
+    const accent = usesTokens ? 'var(--brand-alt)' : drawn.mark.accent;
+    const edge = drawn.mark.edge;
+    return (_jsxs("svg", { style: MARK_STYLE, width: size, height: size, viewBox: "0 0 32 32", "aria-hidden": "true", focusable: "false", children: [plate ? (_jsx("rect", { x: edge ? 0.5 : 0, y: edge ? 0.5 : 0, width: edge ? 31 : 32, height: edge ? 31 : 32, rx: edge ? 6.5 : 7, fill: plateFill, stroke: edge })) : null, GLYPHS[drawn.id](accent)] }));
 }
-/** Every mark, keyed by site, drawn on top of its plate. */
-const GLYPHS = {
-    // A hexagon with a tail: the structure, and the string it hashes into.
-    inchi: (alt) => (_jsxs("g", { fill: "none", stroke: alt, strokeWidth: "2.4", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("polygon", { points: "13,6.5 7.7,9.6 7.7,15.7 13,18.8 18.3,15.7 18.3,9.6" }), _jsx("path", { d: "M16.4 16.2 25.2 25" })] })),
-    // The core carrying three R groups, which is what this tool combines.
-    vcl: (alt) => (_jsxs(_Fragment, { children: [_jsxs("g", { fill: "none", stroke: "#ffffff", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { d: "M16 9.5 10.8 12.5 10.8 18.5 16 21.5 21.2 18.5 21.2 12.5Z" }), _jsx("path", { d: "M16 9.5 16 5.5M21.2 18.5 24.8 20.6M10.8 18.5 7.2 20.6" })] }), _jsx("circle", { cx: "16", cy: "4.6", r: "2.6", fill: alt }), _jsx("circle", { cx: "25.6", cy: "21.2", r: "2.6", fill: alt }), _jsx("circle", { cx: "6.4", cy: "21.2", r: "2.6", fill: alt })] })),
-    // A ring over the line of characters that writes it down.
-    smiles: (alt) => (_jsxs(_Fragment, { children: [_jsx("path", { d: "M16 7.5 22.1 11.1 22.1 18.3 16 21.9 9.9 18.3 9.9 11.1Z", fill: "none", stroke: "#ffffff", strokeWidth: "2.2", strokeLinejoin: "round" }), _jsx("path", { d: "M5.5 25.5h21", fill: "none", stroke: alt, strokeWidth: "3", strokeLinecap: "round" })] })),
-    // An isotopic pattern: the answer this one is asked for most.
-    chemcalc: (alt) => (_jsxs("g", { strokeLinecap: "round", strokeWidth: "3.4", fill: "none", children: [_jsx("path", { d: "M9 24V15", stroke: "#ffffff" }), _jsx("path", { d: "M16 24V7", stroke: alt }), _jsx("path", { d: "M23 24V18", stroke: "#ffffff" })] })),
-    // The official NMRium symbol, from `Logo.tsx` of the NMRium sources: the
-    // orange half is theirs, and the half their logo sets in plum is set in white
-    // here because the plate already is that plum.
-    nmrium: (accent) => (_jsxs("g", { fillRule: "evenodd", transform: "translate(5.25 6.25) scale(0.088)", children: [_jsx("path", { fill: accent, d: "M.64,31.7A31.67,31.67,0,0,1,54.72,9.29l0,0A31.66,31.66,0,0,1,64,31.7V190a13.39,13.39,0,0,0,26.77,0V54a31.7,31.7,0,0,1,31.7-31.7V40.58A13.38,13.38,0,0,0,109.13,54V190a31.71,31.71,0,0,1-63.41,0V31.7a13.29,13.29,0,0,0-3.88-9.46l0,0A13.41,13.41,0,0,0,19,31.7V164.82H.64Z" }), _jsx("path", { fill: "#ffffff", d: "M154.21,54v68.17a13.34,13.34,0,0,0,3.89,9.47h0A13.39,13.39,0,0,0,181,122.14V99.32h-.06a31.63,31.63,0,0,1,9.29-22.38l0,0a31.65,31.65,0,0,1,44.8,0l0,0a31.58,31.58,0,0,1,9.3,22.39V118H226V99.32a13.3,13.3,0,0,0-3.89-9.46h0a13.44,13.44,0,0,0-18.93,0l0,0a13.3,13.3,0,0,0-3.83,8.19v24.09a31.7,31.7,0,0,1-54.11,22.42v0a31.66,31.66,0,0,1-9.3-22.4V54Z" })] })),
-    // One formula branching into every structure it can be.
-    surge: (alt) => (_jsxs(_Fragment, { children: [_jsxs("g", { fill: "none", stroke: "#ffffff", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { d: "M7 16h6" }), _jsx("path", { d: "M13 16 25 8.5M13 16h12M13 16 25 23.5" })] }), _jsx("circle", { cx: "25", cy: "8.5", r: "3", fill: alt }), _jsx("circle", { cx: "25", cy: "16", r: "3", fill: alt }), _jsx("circle", { cx: "25", cy: "23.5", r: "3", fill: alt })] })),
-    // A radical over its radicand: a formula being set.
-    tex: (alt) => (_jsxs(_Fragment, { children: [_jsx("rect", { x: "18.5", y: "12", width: "8.5", height: "8.5", rx: "1.6", fill: alt }), _jsx("path", { d: "M4.5 15.5h3l3.6 8.2L16.8 7.5h10.4", fill: "none", stroke: "#ffffff", strokeWidth: "2.4", strokeLinecap: "round", strokeLinejoin: "round" })] })),
-    // The site's own favicon: two lobes of opposite phase overlapping end-on,
-    // the simplest sigma bond, in the phase palette its viewer renders with.
-    lcao: (alt) => (_jsxs(_Fragment, { children: [_jsx("path", { d: "M16 16C16 10.2 13.3 5 9 5S2 10.2 2 16s2.7 11 7 11 7-5.2 7-11z", fill: "#1565c0" }), _jsx("path", { d: "M16 16c0 5.8 2.7 11 7 11s7-5.2 7-11-2.7-11-7-11-7 5.2-7 11z", fill: alt }), _jsx("circle", { cx: "16", cy: "16", r: "2.25", fill: "#37474f" })] })),
-    // The pattern that matches anything, which is where everyone starts.
-    regexp: (alt) => (_jsx("text", { x: "50%", y: "53%", dominantBaseline: "central", textAnchor: "middle", fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace", fontSize: "18", fontWeight: "700", fill: alt, children: ".*" })),
-    // Three residues of a chain, one of them the ligand you came for.
-    pdb: (alt) => (_jsxs(_Fragment, { children: [_jsx("g", { stroke: "#ffffff", strokeWidth: "1.9", strokeLinecap: "round", fill: "none", opacity: "0.85", children: _jsx("path", { d: "M9.2 12.4 22 15.4 15.6 23Z" }) }), _jsx("circle", { cx: "9.2", cy: "12.4", r: "3.1", fill: "#ffffff" }), _jsx("circle", { cx: "22", cy: "15.4", r: "3.1", fill: "#ffffff" }), _jsx("circle", { cx: "15.6", cy: "23", r: "3.1", fill: alt })] })),
-    // The site's own favicon: a spectrum, and the one signal being assigned.
-    elucidation: (alt) => (_jsxs(_Fragment, { children: [_jsx("path", { d: "M5 24h4l2-11 2 11h4l2-15 2 15h3l1.5-7 1.5 7", fill: "none", stroke: "#ffffff", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round" }), _jsx("circle", { cx: "19", cy: "9", r: "3", fill: alt })] })),
-    // The site's own favicon: the double harpoon, one direction per colour.
-    equilibrium: (alt) => (_jsxs("g", { fill: "none", strokeWidth: "2.5", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { d: "M6.5 12.5h17l-4-4", stroke: "#ffffff" }), _jsx("path", { d: "M25.5 19.5h-17l4 4", stroke: alt })] })),
-    // A chain of monomers, one of them the comonomer written into it.
-    polycarp: (alt) => (_jsxs(_Fragment, { children: [_jsx("path", { d: "M6.5 20 12.5 12 19.5 20 25.5 12", fill: "none", stroke: "#ffffff", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round" }), _jsx("circle", { cx: "6.5", cy: "20", r: "3", fill: "#ffffff" }), _jsx("circle", { cx: "12.5", cy: "12", r: "3", fill: "#ffffff" }), _jsx("circle", { cx: "19.5", cy: "20", r: "3", fill: alt }), _jsx("circle", { cx: "25.5", cy: "12", r: "3", fill: "#ffffff" })] })),
-};
 //# sourceMappingURL=marks.js.map

package/lib/ecosystem/ui/marks.js.map

@@ -1 +1 @@
-{"version":3,"file":"marks.js","sourceRoot":"","sources":["../../../src/ecosystem/ui/marks.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"marks.js","sourceRoot":"","sources":["../../../src/ecosystem/ui/marks.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAc,CAAC;AAEtC,0EAA0E;AAC1E,6EAA6E;AAC7E,4EAA4E;AAC5E,8EAA8E;AAC9E,8BAA8B;AAC9B,MAAM,UAAU,GAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAqCrE;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC;IAE5E,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,KAAK,QAAQ,CAAC;IACvC,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;IACjE,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;IACnE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAE7B,OAAO,CACL,eACE,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,IAAI,EACX,MAAM,EAAE,IAAI,EACZ,OAAO,EAAC,WAAW,iBACP,MAAM,EAClB,SAAS,EAAC,OAAO,aAEhB,KAAK,CAAC,CAAC,CAAC,CACP,eACE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EACjB,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EACjB,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EACrB,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EACtB,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAClB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,IAAI,GACZ,CACH,CAAC,CAAC,CAAC,IAAI,EACP,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,IACrB,CACP,CAAC;AACJ,CAAC"}

package/lib/error/ui/ErrorBoundary.d.ts

@@ -0,0 +1,60 @@
+import type { ErrorInfo, ReactNode } from 'react';
+import { Component } from 'react';
+/** What {@link ErrorBoundary} wraps, and what it does when that part fails. */
+export interface ErrorBoundaryProps {
+    /** The part of the page whose failures are caught here. */
+    children: ReactNode;
+    /**
+     * What is drawn in place of the children once one of them has thrown. The
+     * reset closes the boundary again, so a retry re-renders the children.
+     * @default a non-ideal state naming the error, with a retry button
+     */
+    fallback?: (error: Error, reset: () => void) => ReactNode;
+    /**
+     * Called once with the error and the stack of components it came through, so
+     * a site can report it. Anything it throws is ignored: a failing reporter
+     * must not replace the failure the visitor is already looking at.
+     * @default undefined — the failure is not reported anywhere
+     */
+    onError?: (error: Error, componentStack: string) => void;
+    /**
+     * First line of the default fallback.
+     * @default 'Something went wrong'
+     */
+    title?: string;
+}
+/** Whether the boundary is holding an error, and which one. */
+export interface ErrorBoundaryState {
+    /** The error the boundary caught, or `null` while nothing has failed. */
+    error: Error | null;
+}
+/**
+ * Keep one failing part of the page from taking the whole page with it.
+ *
+ * A viewer that cannot start, a worker that dies, a structure that will not
+ * parse: without a boundary any of these leaves a blank page carrying the
+ * right title, which reads as a routing or a build defect and is neither.
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    /**
+     * Move the boundary into its failed state, whatever was thrown.
+     * @param thrown - The value a child threw.
+     * @returns The state holding it.
+     */
+    static getDerivedStateFromError(thrown: unknown): ErrorBoundaryState;
+    constructor(props: ErrorBoundaryProps);
+    /**
+     * Hand the failure to the site's reporter, if it has one.
+     * @param thrown - The value a child threw.
+     * @param info - Where it came from.
+     */
+    componentDidCatch(thrown: unknown, info: ErrorInfo): void;
+    /** Forget the error and render the children again. */
+    reset: () => void;
+    /**
+     * The children, or what stands in for them once one has failed.
+     * @returns The rendered tree.
+     */
+    render(): ReactNode;
+}
+//# sourceMappingURL=ErrorBoundary.d.ts.map

package/lib/error/ui/ErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../src/error/ui/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKlC,+EAA+E;AAC/E,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC;IAC1D;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,+DAA+D;AAC/D,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAC1C,kBAAkB,EAClB,kBAAkB,CACnB;IACC;;;;OAIG;IACH,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB;gBAIxD,KAAK,EAAE,kBAAkB;IAKrC;;;;OAIG;IACM,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAUlE,sDAAsD;IACtD,KAAK,QAAO,IAAI,CAEd;IAEF;;;OAGG;IACM,MAAM,IAAI,SAAS;CAQ7B"}

package/lib/error/ui/ErrorBoundary.js

@@ -0,0 +1,59 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Component } from 'react';
+import { ErrorFallback } from "./ErrorFallback.js";
+import { toError } from "./toError.js";
+/**
+ * Keep one failing part of the page from taking the whole page with it.
+ *
+ * A viewer that cannot start, a worker that dies, a structure that will not
+ * parse: without a boundary any of these leaves a blank page carrying the
+ * right title, which reads as a routing or a build defect and is neither.
+ */
+export class ErrorBoundary extends Component {
+    /**
+     * Move the boundary into its failed state, whatever was thrown.
+     * @param thrown - The value a child threw.
+     * @returns The state holding it.
+     */
+    static getDerivedStateFromError(thrown) {
+        return { error: toError(thrown) };
+    }
+    constructor(props) {
+        super(props);
+        this.state = { error: null };
+    }
+    /**
+     * Hand the failure to the site's reporter, if it has one.
+     * @param thrown - The value a child threw.
+     * @param info - Where it came from.
+     */
+    componentDidCatch(thrown, info) {
+        const { onError } = this.props;
+        if (onError === undefined)
+            return;
+        try {
+            onError(toError(thrown), info.componentStack ?? '');
+        }
+        catch {
+            // A reporter that fails must not replace the error being shown.
+        }
+    }
+    /** Forget the error and render the children again. */
+    reset = () => {
+        this.setState({ error: null });
+    };
+    /**
+     * The children, or what stands in for them once one has failed.
+     * @returns The rendered tree.
+     */
+    render() {
+        const { children, fallback, title } = this.props;
+        const { error } = this.state;
+        if (error === null)
+            return children;
+        if (fallback !== undefined)
+            return fallback(error, this.reset);
+        return _jsx(ErrorFallback, { error: error, title: title, onRetry: this.reset });
+    }
+}
+//# sourceMappingURL=ErrorBoundary.js.map

package/lib/error/ui/ErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.js","sourceRoot":"","sources":["../../../src/error/ui/ErrorBoundary.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAqB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAgCvC;;;;;;GAMG;AACH,MAAM,OAAO,aAAc,SAAQ,SAGlC;IACC;;;;OAIG;IACH,MAAM,CAAC,wBAAwB,CAAC,MAAe;QAC7C,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IACpC,CAAC;IAED,YAAY,KAAyB;QACnC,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACM,iBAAiB,CAAC,MAAe,EAAE,IAAe;QACzD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAC/B,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO;QAClC,IAAI,CAAC;YACH,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;QAClE,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,KAAK,GAAG,GAAS,EAAE;QACjB,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC;IAEF;;;OAGG;IACM,MAAM;QACb,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACjD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAE7B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,QAAQ,CAAC;QACpC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/D,OAAO,KAAC,aAAa,IAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,GAAI,CAAC;IAC5E,CAAC;CACF"}

package/lib/error/ui/ErrorFallback.d.ts

@@ -0,0 +1,38 @@
+import type { ReactElement } from 'react';
+/** What the page shows in place of the part that failed. */
+export interface ErrorFallbackProps {
+    /** What was thrown, whose message is what the visitor is told. */
+    error: Error;
+    /**
+     * Called when the visitor asks for another attempt. Left out when there is
+     * nothing sensible to retry, and then no button is drawn.
+     * @default undefined — no retry button
+     */
+    onRetry?: () => void;
+    /**
+     * First line, above the message.
+     * @default 'Something went wrong'
+     */
+    title?: string;
+    /**
+     * Text of the retry button.
+     * @default 'Try again'
+     */
+    retryLabel?: string;
+    /**
+     * Class the holder carries, so a site can reach it from its stylesheet.
+     * @default undefined
+     */
+    className?: string;
+}
+/**
+ * The default face of a failure: what happened, and a way out of it.
+ *
+ * The message is written out rather than swallowed, because a visitor who
+ * reports "it says nothing" cannot be helped, whereas one who reports the
+ * sentence can.
+ * @param props - See {@link ErrorFallbackProps}.
+ * @returns The non-ideal state.
+ */
+export declare function ErrorFallback(props: ErrorFallbackProps): ReactElement;
+//# sourceMappingURL=ErrorFallback.d.ts.map

package/lib/error/ui/ErrorFallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorFallback.d.ts","sourceRoot":"","sources":["../../../src/error/ui/ErrorFallback.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,KAAK,EAAE,KAAK,CAAC;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,YAAY,CAwBrE"}

package/lib/error/ui/ErrorFallback.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Button, NonIdealState } from '@blueprintjs/core';
+/**
+ * The default face of a failure: what happened, and a way out of it.
+ *
+ * The message is written out rather than swallowed, because a visitor who
+ * reports "it says nothing" cannot be helped, whereas one who reports the
+ * sentence can.
+ * @param props - See {@link ErrorFallbackProps}.
+ * @returns The non-ideal state.
+ */
+export function ErrorFallback(props) {
+    const { error, onRetry, title = 'Something went wrong', retryLabel = 'Try again', className, } = props;
+    return (_jsx(NonIdealState, { className: className, icon: "error", title: title, description: error.message === '' ? 'No message was given.' : error.message, action: onRetry === undefined ? undefined : (_jsx(Button, { icon: "refresh", text: retryLabel, onClick: onRetry })) }));
+}
+//# sourceMappingURL=ErrorFallback.js.map

package/lib/error/ui/ErrorFallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorFallback.js","sourceRoot":"","sources":["../../../src/error/ui/ErrorFallback.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA8B1D;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,EACJ,KAAK,EACL,OAAO,EACP,KAAK,GAAG,sBAAsB,EAC9B,UAAU,GAAG,WAAW,EACxB,SAAS,GACV,GAAG,KAAK,CAAC;IAEV,OAAO,CACL,KAAC,aAAa,IACZ,SAAS,EAAE,SAAS,EACpB,IAAI,EAAC,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,WAAW,EACT,KAAK,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAEhE,MAAM,EACJ,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAClC,KAAC,MAAM,IAAC,IAAI,EAAC,SAAS,EAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAI,CAC9D,GAEH,CACH,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+export type { ErrorBoundaryProps } from './ErrorBoundary.tsx';
+export { ErrorBoundary } from './ErrorBoundary.tsx';
+export type { ErrorFallbackProps } from './ErrorFallback.tsx';
+export { ErrorFallback } from './ErrorFallback.tsx';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/error/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/lib/error/ui/index.js

@@ -0,0 +1,3 @@
+export { ErrorBoundary } from "./ErrorBoundary.js";
+export { ErrorFallback } from "./ErrorFallback.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/error/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAqB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAqB,CAAC"}

package/lib/error/ui/toError.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Turn whatever a component threw into an `Error`.
+ *
+ * A `throw` is not required to carry an `Error` — a rejected fetch, a worker
+ * message or a library can throw a string, an object or `undefined` — and the
+ * boundary still has to name what happened.
+ * @param thrown - The value that came out of the render.
+ * @returns The value itself when it is an error, otherwise one describing it.
+ */
+export declare function toError(thrown: unknown): Error;
+//# sourceMappingURL=toError.d.ts.map

package/lib/error/ui/toError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toError.d.ts","sourceRoot":"","sources":["../../../src/error/ui/toError.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,CAI9C"}

package/lib/error/ui/toError.js

@@ -0,0 +1,35 @@
+/**
+ * Turn whatever a component threw into an `Error`.
+ *
+ * A `throw` is not required to carry an `Error` — a rejected fetch, a worker
+ * message or a library can throw a string, an object or `undefined` — and the
+ * boundary still has to name what happened.
+ * @param thrown - The value that came out of the render.
+ * @returns The value itself when it is an error, otherwise one describing it.
+ */
+export function toError(thrown) {
+    if (thrown instanceof Error)
+        return thrown;
+    if (typeof thrown === 'string' && thrown !== '')
+        return new Error(thrown);
+    return new Error(describe(thrown));
+}
+const UNPRINTABLE = 'an unprintable value was thrown';
+function describe(thrown) {
+    if (thrown === null)
+        return 'null was thrown';
+    if (thrown === undefined)
+        return 'undefined was thrown';
+    if (typeof thrown === 'number' ||
+        typeof thrown === 'boolean' ||
+        typeof thrown === 'bigint') {
+        return String(thrown);
+    }
+    try {
+        return JSON.stringify(thrown) ?? UNPRINTABLE;
+    }
+    catch {
+        return UNPRINTABLE;
+    }
+}
+//# sourceMappingURL=toError.js.map

package/lib/error/ui/toError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toError.js","sourceRoot":"","sources":["../../../src/error/ui/toError.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO,CAAC,MAAe;IACrC,IAAI,MAAM,YAAY,KAAK;QAAE,OAAO,MAAM,CAAC;IAC3C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1E,OAAO,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,WAAW,GAAG,iCAAiC,CAAC;AAEtD,SAAS,QAAQ,CAAC,MAAe;IAC/B,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,iBAAiB,CAAC;IAC9C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,sBAAsB,CAAC;IACxD,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,OAAO,MAAM,KAAK,SAAS;QAC3B,OAAO,MAAM,KAAK,QAAQ,EAC1B,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,WAAW,CAAC;IACrB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,5 @@
+export { MISSING_VALUE } from './missing.ts';
+export { formatCompact, formatDecimal, formatInteger, formatTrimmed, } from './numbers.ts';
+export { formatBytes, formatDuration } from './units.ts';
+export { pluralize } from './words.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/format/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/lib/format/core/index.js

@@ -0,0 +1,5 @@
+export { MISSING_VALUE } from "./missing.js";
+export { formatCompact, formatDecimal, formatInteger, formatTrimmed, } from "./numbers.js";
+export { formatBytes, formatDuration } from "./units.js";
+export { pluralize } from "./words.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/format/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/lib/format/core/missing.d.ts

@@ -0,0 +1,7 @@
+/**
+ * What every formatter of this module writes when it has nothing to show — a
+ * missing value, or one that is not a finite number. An en dash, so an empty
+ * cell of a table still reads as a cell.
+ */
+export declare const MISSING_VALUE = "\u2013";
+//# sourceMappingURL=missing.d.ts.map

package/lib/format/core/missing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing.d.ts","sourceRoot":"","sources":["../../../src/format/core/missing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,aAAa,WAAM,CAAC"}

package/lib/format/core/missing.js

@@ -0,0 +1,7 @@
+/**
+ * What every formatter of this module writes when it has nothing to show — a
+ * missing value, or one that is not a finite number. An en dash, so an empty
+ * cell of a table still reads as a cell.
+ */
+export const MISSING_VALUE = '–';
+//# sourceMappingURL=missing.js.map

package/lib/format/core/missing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing.js","sourceRoot":"","sources":["../../../src/format/core/missing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC"}

package/lib/format/core/numbers.d.ts

@@ -0,0 +1,40 @@
+/**
+ * A whole number, grouped in thousands: `1,234,567`.
+ *
+ * Anything after the decimal point is rounded away. The locale is fixed to
+ * `en-US`, so the same page reads the same way wherever it is opened.
+ * @param value - The number to write.
+ * @returns The grouped number, or the missing marker when it is not finite.
+ */
+export declare function formatInteger(value: number): string;
+/**
+ * A number grouped in thousands and held to a fixed number of decimals:
+ * `1,234.50`.
+ *
+ * The digits are kept even when they are zeros, which is what a column of
+ * figures wants; use {@link formatTrimmed} for a label that should not carry
+ * them.
+ * @param value - The number to write.
+ * @param digits - Decimals to show. Defaults to `2`; a count outside 0..20 is clamped into it, and one that is not a number falls back to the default.
+ * @returns The formatted number, or the missing marker when it is not finite.
+ */
+export declare function formatDecimal(value: number, digits?: number): string;
+/**
+ * A number rounded to `digits` decimals with the trailing zeros dropped:
+ * `1.5`, `2`, `0.125`.
+ *
+ * The thousands are not grouped, so the result stays a number a reader can
+ * type back in — this is the form an axis tick, a chip or an exported cell
+ * takes.
+ * @param value - The number to write.
+ * @param digits - Decimals to round to. Defaults to `2`; a count outside 0..20 is clamped into it, and one that is not a number falls back to the default.
+ * @returns The rounded number, or the missing marker when it is not finite.
+ */
+export declare function formatTrimmed(value: number, digits?: number): string;
+/**
+ * A number shortened for a cramped axis or a badge: `999`, `1.2K`, `3.4M`.
+ * @param value - The number to write.
+ * @returns The shortened number, or the missing marker when it is not finite.
+ */
+export declare function formatCompact(value: number): string;
+//# sourceMappingURL=numbers.d.ts.map

package/lib/format/core/numbers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../../src/format/core/numbers.ts"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAiB,GAAG,MAAM,CAY5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAiB,GAAG,MAAM,CAG5E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnD"}

package/lib/format/core/numbers.js

@@ -0,0 +1,81 @@
+import { MISSING_VALUE } from "./missing.js";
+const INTEGER_FORMATTER = new Intl.NumberFormat('en-US', {
+    maximumFractionDigits: 0,
+});
+const COMPACT_FORMATTER = new Intl.NumberFormat('en-US', {
+    notation: 'compact',
+    maximumFractionDigits: 1,
+});
+const MAXIMUM_DIGITS = 20;
+const DEFAULT_DIGITS = 2;
+const decimalFormatters = new Map();
+/**
+ * A whole number, grouped in thousands: `1,234,567`.
+ *
+ * Anything after the decimal point is rounded away. The locale is fixed to
+ * `en-US`, so the same page reads the same way wherever it is opened.
+ * @param value - The number to write.
+ * @returns The grouped number, or the missing marker when it is not finite.
+ */
+export function formatInteger(value) {
+    if (!Number.isFinite(value))
+        return MISSING_VALUE;
+    return INTEGER_FORMATTER.format(value);
+}
+/**
+ * A number grouped in thousands and held to a fixed number of decimals:
+ * `1,234.50`.
+ *
+ * The digits are kept even when they are zeros, which is what a column of
+ * figures wants; use {@link formatTrimmed} for a label that should not carry
+ * them.
+ * @param value - The number to write.
+ * @param digits - Decimals to show. Defaults to `2`; a count outside 0..20 is clamped into it, and one that is not a number falls back to the default.
+ * @returns The formatted number, or the missing marker when it is not finite.
+ */
+export function formatDecimal(value, digits = DEFAULT_DIGITS) {
+    if (!Number.isFinite(value))
+        return MISSING_VALUE;
+    const safeDigits = clampDigits(digits);
+    let formatter = decimalFormatters.get(safeDigits);
+    if (formatter === undefined) {
+        formatter = new Intl.NumberFormat('en-US', {
+            minimumFractionDigits: safeDigits,
+            maximumFractionDigits: safeDigits,
+        });
+        decimalFormatters.set(safeDigits, formatter);
+    }
+    return formatter.format(value);
+}
+/**
+ * A number rounded to `digits` decimals with the trailing zeros dropped:
+ * `1.5`, `2`, `0.125`.
+ *
+ * The thousands are not grouped, so the result stays a number a reader can
+ * type back in — this is the form an axis tick, a chip or an exported cell
+ * takes.
+ * @param value - The number to write.
+ * @param digits - Decimals to round to. Defaults to `2`; a count outside 0..20 is clamped into it, and one that is not a number falls back to the default.
+ * @returns The rounded number, or the missing marker when it is not finite.
+ */
+export function formatTrimmed(value, digits = DEFAULT_DIGITS) {
+    if (!Number.isFinite(value))
+        return MISSING_VALUE;
+    return Number.parseFloat(value.toFixed(clampDigits(digits))).toString();
+}
+/**
+ * A number shortened for a cramped axis or a badge: `999`, `1.2K`, `3.4M`.
+ * @param value - The number to write.
+ * @returns The shortened number, or the missing marker when it is not finite.
+ */
+export function formatCompact(value) {
+    if (!Number.isFinite(value))
+        return MISSING_VALUE;
+    return COMPACT_FORMATTER.format(value);
+}
+function clampDigits(digits) {
+    if (!Number.isFinite(digits))
+        return DEFAULT_DIGITS;
+    return Math.min(MAXIMUM_DIGITS, Math.max(0, Math.trunc(digits)));
+}
+//# sourceMappingURL=numbers.js.map

package/lib/format/core/numbers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.js","sourceRoot":"","sources":["../../../src/format/core/numbers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,iBAAiB,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;IACvD,qBAAqB,EAAE,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;IACvD,QAAQ,EAAE,SAAS;IACnB,qBAAqB,EAAE,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA6B,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IAClD,OAAO,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,MAAM,GAAG,cAAc;IAClE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IAClD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAClD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;YACzC,qBAAqB,EAAE,UAAU;YACjC,qBAAqB,EAAE,UAAU;SAClC,CAAC,CAAC;QACH,iBAAiB,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,MAAM,GAAG,cAAc;IAClE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IAClD,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IAClD,OAAO,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,cAAc,CAAC;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/lib/format/core/units.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A byte count in the largest unit that keeps it under a thousand: `512 B`,
+ * `1.5 kB`, `240 MB`.
+ *
+ * Bytes are whole; every larger unit keeps one decimal until the number
+ * reaches a hundred, where the decimal stops carrying information.
+ * @param bytes - The size in bytes.
+ * @returns The size and its unit, or the missing marker when there is no finite, non-negative size.
+ */
+export declare function formatBytes(bytes: number | undefined): string;
+/**
+ * A duration written with its two largest units: `45s`, `3m 20s`, `2h 05m`.
+ * @param milliseconds - The duration in milliseconds.
+ * @returns The duration, or the missing marker when there is no finite, non-negative duration.
+ */
+export declare function formatDuration(milliseconds: number | undefined): string;
+//# sourceMappingURL=units.d.ts.map

package/lib/format/core/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../../src/format/core/units.ts"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAY7D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAoBvE"}

package/lib/format/core/units.js

@@ -0,0 +1,54 @@
+import { MISSING_VALUE } from "./missing.js";
+const BYTE_UNITS = ['B', 'kB', 'MB', 'GB', 'TB', 'PB'];
+const BYTES_PER_UNIT = 1024;
+const SECONDS_PER_MINUTE = 60;
+const MINUTES_PER_HOUR = 60;
+/**
+ * A byte count in the largest unit that keeps it under a thousand: `512 B`,
+ * `1.5 kB`, `240 MB`.
+ *
+ * Bytes are whole; every larger unit keeps one decimal until the number
+ * reaches a hundred, where the decimal stops carrying information.
+ * @param bytes - The size in bytes.
+ * @returns The size and its unit, or the missing marker when there is no finite, non-negative size.
+ */
+export function formatBytes(bytes) {
+    if (bytes === undefined || !Number.isFinite(bytes) || bytes < 0) {
+        return MISSING_VALUE;
+    }
+    let value = bytes;
+    let unitIndex = 0;
+    while (value >= BYTES_PER_UNIT && unitIndex < BYTE_UNITS.length - 1) {
+        value /= BYTES_PER_UNIT;
+        unitIndex += 1;
+    }
+    const digits = unitIndex === 0 || value >= 100 ? 0 : 1;
+    return `${value.toFixed(digits)} ${BYTE_UNITS[unitIndex] ?? 'B'}`;
+}
+/**
+ * A duration written with its two largest units: `45s`, `3m 20s`, `2h 05m`.
+ * @param milliseconds - The duration in milliseconds.
+ * @returns The duration, or the missing marker when there is no finite, non-negative duration.
+ */
+export function formatDuration(milliseconds) {
+    if (milliseconds === undefined ||
+        !Number.isFinite(milliseconds) ||
+        milliseconds < 0) {
+        return MISSING_VALUE;
+    }
+    const seconds = Math.round(milliseconds / 1000);
+    if (seconds < SECONDS_PER_MINUTE)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / SECONDS_PER_MINUTE);
+    const remainingSeconds = seconds % SECONDS_PER_MINUTE;
+    if (minutes < MINUTES_PER_HOUR) {
+        return `${minutes}m ${pad(remainingSeconds)}s`;
+    }
+    const hours = Math.floor(minutes / MINUTES_PER_HOUR);
+    const remainingMinutes = minutes % MINUTES_PER_HOUR;
+    return `${hours}h ${pad(remainingMinutes)}m`;
+}
+function pad(value) {
+    return value.toString().padStart(2, '0');
+}
+//# sourceMappingURL=units.js.map