react-cheminfo 0.64.1 → 0.65.0

package/lib/card/ui/holdRoomForPanels.js

@@ -0,0 +1,76 @@
+import { roomForPanels } from "../core/panelRoom.js";
+import { anchorBottom, openPanels } from "./openPanels.js";
+/**
+ * Keep a card as tall as the dialogs and popovers open over it need, until
+ * the returned function is called; the card gives the height back as each
+ * closes. A chat frames a card exactly as tall as the card reports, so a
+ * panel taller than the card would otherwise be cut at the frame's edge.
+ *
+ * The room is measured once per animation frame, whenever the document
+ * changes — a panel opening, closing or moving changes the tree or a class —
+ * and whenever an open panel changes size, which one whose content arrives
+ * after it opens does without touching the tree. A card whose view fills the
+ * screen holds no room: its frame is not what is on screen then.
+ * @param card - The element whose height the frame follows.
+ * @returns A function that stops watching and gives the card its height back.
+ */
+export function holdRoomForPanels(card) {
+    let frame = 0;
+    const watched = new Set();
+    const sizes = typeof ResizeObserver === 'undefined'
+        ? undefined
+        : new ResizeObserver(schedule);
+    const mutations = new MutationObserver(schedule);
+    function measure() {
+        frame = 0;
+        const panels = openPanels(card);
+        if (sizes !== undefined)
+            watchSizes(sizes, watched, panels.elements);
+        const room = document.fullscreenElement
+            ? 0
+            : roomForPanels(panels.found, anchorBottom(card));
+        const minHeight = room > 0 ? `${room}px` : '';
+        if (card.style.minHeight !== minHeight)
+            card.style.minHeight = minHeight;
+    }
+    function schedule() {
+        if (frame === 0)
+            frame = requestAnimationFrame(measure);
+    }
+    mutations.observe(document.body, {
+        childList: true,
+        subtree: true,
+        attributes: true,
+        attributeFilter: ['class'],
+    });
+    document.addEventListener('fullscreenchange', schedule);
+    schedule();
+    return () => {
+        mutations.disconnect();
+        sizes?.disconnect();
+        document.removeEventListener('fullscreenchange', schedule);
+        cancelAnimationFrame(frame);
+        card.style.minHeight = '';
+    };
+}
+/**
+ * Watch the size of the panels on screen, and of no other element.
+ * @param sizes - The observer.
+ * @param watched - The elements it watches, kept up to date.
+ * @param panels - The panels open now.
+ */
+function watchSizes(sizes, watched, panels) {
+    for (const element of watched) {
+        if (!panels.includes(element)) {
+            sizes.unobserve(element);
+            watched.delete(element);
+        }
+    }
+    for (const element of panels) {
+        if (!watched.has(element)) {
+            sizes.observe(element);
+            watched.add(element);
+        }
+    }
+}
+//# sourceMappingURL=holdRoomForPanels.js.map

package/lib/card/ui/holdRoomForPanels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"holdRoomForPanels.js","sourceRoot":"","sources":["../../../src/card/ui/holdRoomForPanels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE3D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAiB;IACjD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,OAAO,GAAG,IAAI,GAAG,EAAW,CAAC;IACnC,MAAM,KAAK,GACT,OAAO,cAAc,KAAK,WAAW;QACnC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAEjD,SAAS,OAAO;QACd,KAAK,GAAG,CAAC,CAAC;QACV,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS;YAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,QAAQ,CAAC,iBAAiB;YACrC,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAC3E,CAAC;IAED,SAAS,QAAQ;QACf,IAAI,KAAK,KAAK,CAAC;YAAE,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC/B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,IAAI;QAChB,eAAe,EAAE,CAAC,OAAO,CAAC;KAC3B,CAAC,CAAC;IACH,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IACxD,QAAQ,EAAE,CAAC;IACX,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,UAAU,EAAE,CAAC;QACvB,KAAK,EAAE,UAAU,EAAE,CAAC;QACpB,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;QAC3D,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,UAAU,CACjB,KAAqB,EACrB,OAAqB,EACrB,MAA0B;IAE1B,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,11 @@
+export type { CardDetailsButtonProps } from './CardDetailsButton.tsx';
+export { CardDetailsButton } from './CardDetailsButton.tsx';
+export type { CardFigureProps } from './CardFigure.tsx';
+export { CardFigure } from './CardFigure.tsx';
+export type { CardFrameProps } from './CardFrame.tsx';
+export { CardFrame } from './CardFrame.tsx';
+export type { CopyTableButtonProps } from './CopyTableButton.tsx';
+export { CopyTableButton } from './CopyTableButton.tsx';
+export { fitCardToFrame, useFitCardToFrame, useOverlayRoom, } from './fitCardToFrame.ts';
+export { holdRoomForPanels } from './holdRoomForPanels.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/card/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/lib/card/ui/index.js

@@ -0,0 +1,7 @@
+export { CardDetailsButton } from "./CardDetailsButton.js";
+export { CardFigure } from "./CardFigure.js";
+export { CardFrame } from "./CardFrame.js";
+export { CopyTableButton } from "./CopyTableButton.js";
+export { fitCardToFrame, useFitCardToFrame, useOverlayRoom, } from "./fitCardToFrame.js";
+export { holdRoomForPanels } from "./holdRoomForPanels.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/card/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAyB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAkB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAiB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAuB,CAAC;AACxD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/lib/card/ui/openPanels.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The dialogs and popovers Blueprint has open over a card, measured as the
+ * room each needs of the card's frame.
+ */
+import type { OpenPanel } from '../core/panelRoom.ts';
+/** The panels on screen, and the elements measured for them. */
+export interface FoundPanels {
+    /** What each panel needs. */
+    found: OpenPanel[];
+    /** The elements whose size the panels are read from. */
+    elements: HTMLElement[];
+}
+/**
+ * The dialogs and popovers on screen, and the room each needs.
+ * @param card - The card they are opened over.
+ * @returns The panels, and the elements measured for them.
+ */
+export declare function openPanels(card: HTMLElement): FoundPanels;
+/**
+ * Where the lowest control of the card whose popover is open ends.
+ * @param card - The card.
+ * @returns Its bottom edge, in pixels from the top of the card; 0 for none.
+ */
+export declare function anchorBottom(card: HTMLElement): number;
+//# sourceMappingURL=openPanels.d.ts.map

package/lib/card/ui/openPanels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openPanels.d.ts","sourceRoot":"","sources":["../../../src/card/ui/openPanels.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,wDAAwD;IACxD,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAmBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CA4BzD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAQtD"}

package/lib/card/ui/openPanels.js

@@ -0,0 +1,85 @@
+/**
+ * The dialogs and popovers Blueprint has open over a card, measured as the
+ * room each needs of the card's frame.
+ */
+import { Classes } from '@blueprintjs/core';
+const OPEN = `.${Classes.OVERLAY_OPEN}`;
+/** A tooltip is read in passing and closes as the pointer leaves: no room. */
+const POPOVERS = `${OPEN} .${Classes.POPOVER}:not(.${Classes.TOOLTIP})`;
+const DIALOGS = `${OPEN} .${Classes.DIALOG}`;
+/** A dialog's body, which scrolls past 70 % of the frame's height. */
+const SCROLLED = `.${Classes.DIALOG_BODY_SCROLL_CONTAINER}`;
+/**
+ * A control whose popover is open: Blueprint marks its own target, and a
+ * toolbar that renders its target itself — the 3D view's — says it is
+ * expanded.
+ */
+const OPEN_CONTROLS = `.${Classes.POPOVER_OPEN}, [aria-expanded='true']`;
+/**
+ * The dialogs and popovers on screen, and the room each needs.
+ * @param card - The card they are opened over.
+ * @returns The panels, and the elements measured for them.
+ */
+export function openPanels(card) {
+    const found = [];
+    const elements = [];
+    const top = card.getBoundingClientRect().top;
+    for (const dialog of document.querySelectorAll(DIALOGS)) {
+        const { marginTop, marginBottom } = globalThis.getComputedStyle(dialog);
+        const margins = (parseLength(marginTop) ?? 0) + (parseLength(marginBottom) ?? 0);
+        found.push({ kind: 'dialog', height: unscrolledHeight(dialog) + margins });
+        elements.push(dialog);
+    }
+    for (const popover of document.querySelectorAll(POPOVERS)) {
+        // The box that places a popover is never scaled while it opens, so it
+        // says where the popover ends; the popover itself is, at first.
+        const placed = popover.parentElement?.classList.contains(Classes.POPOVER_TRANSITION_CONTAINER)
+            ? popover.parentElement
+            : popover;
+        const bottom = placed.getBoundingClientRect().bottom - top;
+        found.push({
+            kind: 'popover',
+            height: unscrolledHeight(popover),
+            ...(bottom > 0 && { bottom }),
+        });
+        elements.push(popover);
+    }
+    return { found, elements };
+}
+/**
+ * Where the lowest control of the card whose popover is open ends.
+ * @param card - The card.
+ * @returns Its bottom edge, in pixels from the top of the card; 0 for none.
+ */
+export function anchorBottom(card) {
+    const top = card.getBoundingClientRect().top;
+    let bottom = 0;
+    for (const control of card.querySelectorAll(OPEN_CONTROLS)) {
+        const edge = control.getBoundingClientRect().bottom - top;
+        if (edge > bottom)
+            bottom = edge;
+    }
+    return bottom;
+}
+/**
+ * The panel's height with what its body scrolls away put back.
+ * @param panel - The dialog or the popover.
+ * @returns Its height, in pixels.
+ */
+function unscrolledHeight(panel) {
+    let height = panel.offsetHeight;
+    for (const body of panel.querySelectorAll(SCROLLED)) {
+        height += body.scrollHeight - body.clientHeight;
+    }
+    return height;
+}
+/**
+ * A computed length, in pixels.
+ * @param value - E.g. `30px`; empty where nothing computes it.
+ * @returns The number, or undefined when it is not one.
+ */
+function parseLength(value) {
+    const length = Number.parseFloat(value);
+    return Number.isFinite(length) ? length : undefined;
+}
+//# sourceMappingURL=openPanels.js.map

package/lib/card/ui/openPanels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openPanels.js","sourceRoot":"","sources":["../../../src/card/ui/openPanels.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAY5C,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;AAExC,8EAA8E;AAC9E,MAAM,QAAQ,GAAG,GAAG,IAAI,KAAK,OAAO,CAAC,OAAO,SAAS,OAAO,CAAC,OAAO,GAAG,CAAC;AAExE,MAAM,OAAO,GAAG,GAAG,IAAI,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;AAE7C,sEAAsE;AACtE,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAC,4BAA4B,EAAE,CAAC;AAE5D;;;;GAIG;AACH,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,YAAY,0BAA0B,CAAC;AAEzE;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAiB;IAC1C,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC,GAAG,CAAC;IAC7C,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CAAc,OAAO,CAAC,EAAE,CAAC;QACrE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACxE,MAAM,OAAO,GACX,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC;QAC3E,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,gBAAgB,CAAc,QAAQ,CAAC,EAAE,CAAC;QACvE,sEAAsE;QACtE,gEAAgE;QAChE,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,QAAQ,CACtD,OAAO,CAAC,4BAA4B,CACrC;YACC,CAAC,CAAC,OAAO,CAAC,aAAa;YACvB,CAAC,CAAC,OAAO,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,CAAC,qBAAqB,EAAE,CAAC,MAAM,GAAG,GAAG,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC;YACjC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;SAC9B,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAiB;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC,GAAG,CAAC;IAC7C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,MAAM,GAAG,GAAG,CAAC;QAC1D,IAAI,IAAI,GAAG,MAAM;YAAE,MAAM,GAAG,IAAI,CAAC;IACnC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,KAAkB;IAC1C,IAAI,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,gBAAgB,CAAc,QAAQ,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC"}

package/lib/card.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The card an answer is shown as in a chat: a site's own page under
+ * `?embed=1&card=1`, framed inline by mcp.cheminfo.org.
+ *
+ * An entry point of its own, and not part of `react-cheminfo/ui`, because it
+ * talks to the frame through `cheminfo-mcp-server/embed`: a site that serves
+ * no tools must never be made to install it. The addresses — `CARD_PARAM`,
+ * `sitePageUrl`, `cardPageUrl` — need neither React nor the frame, and are in
+ * `react-cheminfo/core` too.
+ */
+export * from './card/core/index.ts';
+export * from './card/ui/index.ts';
+//# sourceMappingURL=card.d.ts.map

package/lib/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../src/card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}

package/lib/card.js

@@ -0,0 +1,13 @@
+/**
+ * The card an answer is shown as in a chat: a site's own page under
+ * `?embed=1&card=1`, framed inline by mcp.cheminfo.org.
+ *
+ * An entry point of its own, and not part of `react-cheminfo/ui`, because it
+ * talks to the frame through `cheminfo-mcp-server/embed`: a site that serves
+ * no tools must never be made to install it. The addresses — `CARD_PARAM`,
+ * `sitePageUrl`, `cardPageUrl` — need neither React nor the frame, and are in
+ * `react-cheminfo/core` too.
+ */
+export * from "./card/core/index.js";
+export * from "./card/ui/index.js";
+//# sourceMappingURL=card.js.map

package/lib/card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.js","sourceRoot":"","sources":["../src/card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}

package/lib/conformers.d.ts

@@ -24,4 +24,5 @@ export { keepConformerSession, openConformerSession, readPotentialCount, } from
 export type { ConformerShape, PrincipalMoments, } from './structure/core/conformerShape.ts';
 export { conformerShape, hasFiniteCoordinates, } from './structure/core/conformerShape.ts';
 export { registerResources } from './structure/core/oclResources.ts';
+export { OCL_RESOURCES_FILE, oclResourcesUrl, } from './worker/core/oclResourcesUrl.ts';
 //# sourceMappingURL=conformers.d.ts.map

package/lib/conformers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conformers.d.ts","sourceRoot":"","sources":["../src/conformers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,UAAU,GACX,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,eAAe,EACf,6BAA6B,EAC7B,gBAAgB,GACjB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,cAAc,EACd,cAAc,GACf,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,yCAAyC,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EACL,iBAAiB,EACjB,YAAY,GACb,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,WAAW,EACX,eAAe,GAChB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,cAAc,EACd,gBAAgB,GACjB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"conformers.d.ts","sourceRoot":"","sources":["../src/conformers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,UAAU,GACX,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,eAAe,EACf,6BAA6B,EAC7B,gBAAgB,GACjB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,cAAc,EACd,cAAc,GACf,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,yCAAyC,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EACL,iBAAiB,EACjB,YAAY,GACb,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,WAAW,EACX,eAAe,GAChB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,cAAc,EACd,gBAAgB,GACjB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,eAAe,GAChB,MAAM,kCAAkC,CAAC"}

package/lib/conformers.js

@@ -16,4 +16,5 @@ export { CONFORMER_STRATEGIES, DEFAULT_CONFORMER_OPTIONS, MINIMISATION_ALGORITHM
 export { keepConformerSession, openConformerSession, readPotentialCount, } from "./structure/core/conformerSession.js";
 export { conformerShape, hasFiniteCoordinates, } from "./structure/core/conformerShape.js";
 export { registerResources } from "./structure/core/oclResources.js";
+export { OCL_RESOURCES_FILE, oclResourcesUrl, } from "./worker/core/oclResourcesUrl.js";
 //# sourceMappingURL=conformers.js.map

package/lib/conformers.js.map

@@ -1 +1 @@
-{"version":3,"file":"conformers.js","sourceRoot":"","sources":["../src/conformers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AAMxC,OAAO,EACL,eAAe,EACf,6BAA6B,EAC7B,gBAAgB,GACjB,MAAM,qCAAqC,CAAC;AAK7C,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EACL,iBAAiB,EACjB,YAAY,GACb,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,WAAW,EACX,eAAe,GAChB,MAAM,sCAAsC,CAAC;AAM9C,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,sCAAsC,CAAC;AAK9C,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"conformers.js","sourceRoot":"","sources":["../src/conformers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AAMxC,OAAO,EACL,eAAe,EACf,6BAA6B,EAC7B,gBAAgB,GACjB,MAAM,qCAAqC,CAAC;AAK7C,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EACL,iBAAiB,EACjB,YAAY,GACb,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,WAAW,EACX,eAAe,GAChB,MAAM,sCAAsC,CAAC;AAM9C,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,sCAAsC,CAAC;AAK9C,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,eAAe,GAChB,MAAM,kCAAkC,CAAC"}

package/lib/core.d.ts

@@ -1,6 +1,7 @@
 export * from './about/core/index.ts';
 export * from './axis/core/index.ts';
 export * from './build/core/index.ts';
+export * from './card/core/index.ts';
 export * from './chart/core/index.ts';
 export * from './citation/core/index.ts';
 export * from './clipboard/core/index.ts';
@@ -11,9 +12,11 @@ export * from './delimited/core/index.ts';
 export * from './download/core/index.ts';
 export * from './ecosystem/core/index.ts';
 export * from './error/core/index.ts';
+export * from './fetch/core/index.ts';
 export * from './format/core/index.ts';
 export * from './i18n/core/index.ts';
 export * from './language/core/index.ts';
+export * from './moleculesClient/core/index.ts';
 export * from './moleculesSources/core/index.ts';
 export * from './moleculesToken/core/index.ts';
 export * from './number/core/index.ts';
@@ -24,6 +27,7 @@ export * from './parallel/core/index.ts';
 export * from './pedagogy/core/index.ts';
 export * from './periodic/core/index.ts';
 export * from './projection/core/index.ts';
+export * from './property/core/index.ts';
 export * from './range/core/index.ts';
 export * from './router/core/index.ts';
 export * from './scatter/core/index.ts';

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,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,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,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"}
+{"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;AAEtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,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,0BAA0B,CAAC;AACzC,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

@@ -1,6 +1,8 @@
 export * from "./about/core/index.js";
 export * from "./axis/core/index.js";
 export * from "./build/core/index.js";
+// The addresses of an answer's card, which a tool server writes in Node.
+export * from "./card/core/index.js";
 export * from "./chart/core/index.js";
 export * from "./citation/core/index.js";
 export * from "./clipboard/core/index.js";
@@ -11,9 +13,11 @@ export * from "./delimited/core/index.js";
 export * from "./download/core/index.js";
 export * from "./ecosystem/core/index.js";
 export * from "./error/core/index.js";
+export * from "./fetch/core/index.js";
 export * from "./format/core/index.js";
 export * from "./i18n/core/index.js";
 export * from "./language/core/index.js";
+export * from "./moleculesClient/core/index.js";
 export * from "./moleculesSources/core/index.js";
 export * from "./moleculesToken/core/index.js";
 export * from "./number/core/index.js";
@@ -24,6 +28,7 @@ export * from "./parallel/core/index.js";
 export * from "./pedagogy/core/index.js";
 export * from "./periodic/core/index.js";
 export * from "./projection/core/index.js";
+export * from "./property/core/index.js";
 export * from "./range/core/index.js";
 export * from "./router/core/index.js";
 export * from "./scatter/core/index.js";

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,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,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,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"}
+{"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,yEAAyE;AACzE,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,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,0BAA0B,CAAC;AACzC,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/fetch/core/apiError.d.ts

@@ -0,0 +1,56 @@
+/**
+ * A request a backend refused, or could not answer, with the reason it gave.
+ *
+ * `status` tells a refusal worth retrying from one that is final — a job still
+ * running from one that is gone — and `message` is written for the reader.
+ */
+export declare class ApiError extends Error {
+    name: string;
+    /**
+     * The status of the refusal: the envelope's `statusCode` when it names one,
+     * else the response's. 0 when the server could not be reached at all.
+     */
+    readonly status: number;
+    /**
+     * The short name Fastify gives the status, e.g. `Not Found`; the response's
+     * status text when the body names none.
+     */
+    readonly error: string;
+    /**
+     * The body of the refusal as read — the parsed JSON, or the text when it was
+     * none — for a field the envelope does not name.
+     */
+    readonly body: unknown;
+    /**
+     * Name a refusal.
+     * @param message - The reason, written for the reader.
+     * @param options - The status, its name, the body and what caused it.
+     */
+    constructor(message: string, options: ApiErrorOptions);
+    /**
+     * The status, under the name Fastify's envelope gives it.
+     * @returns The same number as `status`.
+     */
+    get statusCode(): number;
+}
+/** What an {@link ApiError} is built from. */
+export interface ApiErrorOptions {
+    /** The status of the refusal, 0 when the server could not be reached. */
+    status: number;
+    /**
+     * The short name of the status.
+     * @default ''
+     */
+    error?: string;
+    /**
+     * The body of the refusal as read.
+     * @default undefined
+     */
+    body?: unknown;
+    /**
+     * What the error was raised from.
+     * @default undefined
+     */
+    cause?: unknown;
+}
+//# sourceMappingURL=apiError.d.ts.map

package/lib/fetch/core/apiError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiError.d.ts","sourceRoot":"","sources":["../../../src/fetch/core/apiError.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACxB,IAAI,SAAc;IAC3B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;IAOrD;;;OAGG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;CACF;AAED,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/lib/fetch/core/apiError.js

@@ -0,0 +1,43 @@
+/**
+ * A request a backend refused, or could not answer, with the reason it gave.
+ *
+ * `status` tells a refusal worth retrying from one that is final — a job still
+ * running from one that is gone — and `message` is written for the reader.
+ */
+export class ApiError extends Error {
+    name = 'ApiError';
+    /**
+     * The status of the refusal: the envelope's `statusCode` when it names one,
+     * else the response's. 0 when the server could not be reached at all.
+     */
+    status;
+    /**
+     * The short name Fastify gives the status, e.g. `Not Found`; the response's
+     * status text when the body names none.
+     */
+    error;
+    /**
+     * The body of the refusal as read — the parsed JSON, or the text when it was
+     * none — for a field the envelope does not name.
+     */
+    body;
+    /**
+     * Name a refusal.
+     * @param message - The reason, written for the reader.
+     * @param options - The status, its name, the body and what caused it.
+     */
+    constructor(message, options) {
+        super(message, { cause: options.cause });
+        this.status = options.status;
+        this.error = options.error ?? '';
+        this.body = options.body;
+    }
+    /**
+     * The status, under the name Fastify's envelope gives it.
+     * @returns The same number as `status`.
+     */
+    get statusCode() {
+        return this.status;
+    }
+}
+//# sourceMappingURL=apiError.js.map

package/lib/fetch/core/apiError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiError.js","sourceRoot":"","sources":["../../../src/fetch/core/apiError.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,GAAG,UAAU,CAAC;IAC3B;;;OAGG;IACM,MAAM,CAAS;IACxB;;;OAGG;IACM,KAAK,CAAS;IACvB;;;OAGG;IACM,IAAI,CAAU;IAEvB;;;;OAIG;IACH,YAAY,OAAe,EAAE,OAAwB;QACnD,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/lib/fetch/core/fetchJson.d.ts

@@ -0,0 +1,47 @@
+/**
+ * One JSON request to one of our backends, and its refusal as an error a page
+ * can show.
+ *
+ * Our backends are Fastify, and a refusal comes back as `{ statusCode, error,
+ * message }`: the message is written for the reader, so it is what the error
+ * says. Nothing here needs more than `fetch`, so it runs in a page, a worker
+ * and Node alike.
+ */
+import { ApiError } from './apiError.ts';
+/**
+ * Ask a backend one question and read its JSON answer.
+ *
+ * A refusal rejects with an {@link ApiError} carrying the server's own words
+ * and its status; a server that cannot be reached rejects with one of status
+ * 0. An abort is passed on untouched, so a caller tells "nobody asked any
+ * more" from a failure by the signal it aborted. A `204`, or an empty body,
+ * answers `undefined`.
+ * @param url - The address, absolute or relative to the page.
+ * @param options - The request, plus a `json` body and the `fetch` to use.
+ * @returns The parsed answer.
+ * @throws {ApiError} When the server refuses, cannot be reached, or answers
+ * something that is not JSON.
+ */
+export declare function fetchJson<T>(url: string, options?: FetchJsonOptions): Promise<T>;
+/**
+ * The error a refusal stands for, in the server's words when it gave any: the
+ * `message` of a Fastify envelope, else a FastAPI `detail`, else the status.
+ * @param response - The response that was not ok.
+ * @returns The error, its body read.
+ */
+export declare function readApiError(response: Response): Promise<ApiError>;
+/** What {@link fetchJson} is handed: a `fetch` request, and two additions. */
+export interface FetchJsonOptions extends RequestInit {
+    /**
+     * A value sent as the JSON body, with its content type; it replaces `body`.
+     * @default undefined — the request carries `body`, if any
+     */
+    json?: unknown;
+    /**
+     * The `fetch` to call: a session's own, which signs the request, or a
+     * stand-in in a test.
+     * @default globalThis.fetch
+     */
+    fetch?: typeof globalThis.fetch;
+}
+//# sourceMappingURL=fetchJson.d.ts.map

package/lib/fetch/core/fetchJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchJson.d.ts","sourceRoot":"","sources":["../../../src/fetch/core/fetchJson.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,CAAC,CAAC,CAiCZ;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoBxE;AAED,8EAA8E;AAC9E,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC"}