react-cheminfo 0.64.1 → 0.66.0

package/lib/card/core/cardPageUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardPageUrl.js","sourceRoot":"","sources":["../../../src/card/core/cardPageUrl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA4B9C;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,UAA6B,EAAE;IAE/B,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAC9B,MAAM,OAAO,GAAiB,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC;IACnD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,UAA2B,EAAE;IAE7B,MAAM,EAAE,IAAI,GAAG,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAC3C,MAAM,OAAO,GAAiB,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;IACnD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,gBAAgB,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CACvB,OAAe,EACf,OAA8B;IAE9B,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAClC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,GAAG;QACP,CAAC,CAAC,GAAG,CAAC;IACR,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,QAAQ,EAAE,CAAC;AACxE,CAAC"}

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

@@ -0,0 +1,7 @@
+export type { CardLocation, SitePageOptions } from './cardAddress.ts';
+export { CARD_PARAM, isCardAddress, sitePageUrl } from './cardAddress.ts';
+export type { CardPageOptions, FramedPageOptions } from './cardPageUrl.ts';
+export { cardPageUrl, framedPageUrl } from './cardPageUrl.ts';
+export type { OpenPanel } from './panelRoom.ts';
+export { roomForPanels } from './panelRoom.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/card/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1E,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC9D,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/card/core/index.js

@@ -0,0 +1,4 @@
+export { CARD_PARAM, isCardAddress, sitePageUrl } from "./cardAddress.js";
+export { cardPageUrl, framedPageUrl } from "./cardPageUrl.js";
+export { roomForPanels } from "./panelRoom.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/card/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE1E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/card/core/panelRoom.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Room in the frame for a panel a card opens over itself.
+ *
+ * A chat sizes the frame of a card from the card's own height, and a popover
+ * or a dialog opened from the card — the panel that copies or saves a figure,
+ * the notations of a structure — is drawn over the card inside that frame.
+ * Taller than the card, it would be cut off at the frame's edge, its Copy
+ * button with it. So while one is open the card is made as tall as the panel
+ * needs, which grows the frame with it.
+ */
+/** What one open panel needs of the frame. */
+export interface OpenPanel {
+    /**
+     * `dialog`: centred in the frame; `popover`: hung beside or under the
+     * control that opened it.
+     */
+    kind: 'dialog' | 'popover';
+    /**
+     * Its height with nothing scrolled away, in pixels: a dialog's body scrolls
+     * past 70 % of the frame, which is no height at all in a frame of 260. A
+     * dialog's margins are counted in.
+     */
+    height: number;
+    /**
+     * Where a popover ends as it is placed, in pixels from the top of the card:
+     * one opened at the pointer, or from a control outside the card, hangs lower
+     * than the control it is reckoned from.
+     * @default undefined - reckoned from the control alone
+     */
+    bottom?: number;
+}
+/**
+ * How tall the card must be for every open panel to fit in its frame.
+ * @param panels - The panels on screen.
+ * @param anchor - Where the lowest control whose popover is open ends, in
+ *   pixels from the top of the card; a popover hangs from it.
+ * @returns The least height of the card, or 0 when no panel is open.
+ */
+export declare function roomForPanels(panels: readonly OpenPanel[], anchor: number): number;
+//# sourceMappingURL=panelRoom.d.ts.map

package/lib/card/core/panelRoom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panelRoom.d.ts","sourceRoot":"","sources":["../../../src/card/core/panelRoom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAWD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,MAAM,EAAE,MAAM,GACb,MAAM,CAaR"}

package/lib/card/core/panelRoom.js

@@ -0,0 +1,40 @@
+/**
+ * Room in the frame for a panel a card opens over itself.
+ *
+ * A chat sizes the frame of a card from the card's own height, and a popover
+ * or a dialog opened from the card — the panel that copies or saves a figure,
+ * the notations of a structure — is drawn over the card inside that frame.
+ * Taller than the card, it would be cut off at the frame's edge, its Copy
+ * button with it. So while one is open the card is made as tall as the panel
+ * needs, which grows the frame with it.
+ */
+/**
+ * Between a popover and its control, arrow included, and under the popover:
+ * enough for one hung under its control, and a margin for one beside it.
+ */
+const POPOVER_SPACE = 24;
+/** Under a popover placed where it is, so that its shadow is not cut. */
+const POPOVER_GAP = 8;
+/**
+ * How tall the card must be for every open panel to fit in its frame.
+ * @param panels - The panels on screen.
+ * @param anchor - Where the lowest control whose popover is open ends, in
+ *   pixels from the top of the card; a popover hangs from it.
+ * @returns The least height of the card, or 0 when no panel is open.
+ */
+export function roomForPanels(panels, anchor) {
+    let room = 0;
+    for (const panel of panels) {
+        let needed = panel.height;
+        if (panel.kind === 'popover') {
+            needed = anchor + panel.height + POPOVER_SPACE;
+            if (panel.bottom !== undefined && panel.bottom + POPOVER_GAP > needed) {
+                needed = panel.bottom + POPOVER_GAP;
+            }
+        }
+        if (needed > room)
+            room = needed;
+    }
+    return Math.ceil(room);
+}
+//# sourceMappingURL=panelRoom.js.map

package/lib/card/core/panelRoom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panelRoom.js","sourceRoot":"","sources":["../../../src/card/core/panelRoom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwBH;;;GAGG;AACH,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,yEAAyE;AACzE,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA4B,EAC5B,MAAc;IAEd,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC;YAC/C,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,WAAW,GAAG,MAAM,EAAE,CAAC;gBACtE,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;YACtC,CAAC;QACH,CAAC;QACD,IAAI,MAAM,GAAG,IAAI;YAAE,IAAI,GAAG,MAAM,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1,38 @@
+import type { ReactElement } from 'react';
+import type { SitePageOptions } from '../core/cardAddress.ts';
+/** What {@link CardDetailsButton} opens. */
+export interface CardDetailsButtonProps {
+    /**
+     * Writes the address of the page the button opens, when it is pressed.
+     * @default the card's own address without `card`, `embed`, `hide` and
+     *   what `address` says only the card reads — `sitePageUrl` over the page's
+     *   address, the one a sealed link holds in memory included
+     */
+    page?: () => string;
+    /**
+     * How the default page is read off the card's address.
+     * @default {} - `card`, `embed` and `hide` are left out, and nothing else
+     */
+    address?: SitePageOptions;
+    /**
+     * What the tooltip says the button does.
+     * @default the chrome's own line, `Open in a new tab`
+     */
+    tooltip?: string;
+    /**
+     * Value of the `data-testid` attribute of the button.
+     * @default 'card-details'
+     */
+    testId?: string;
+}
+/**
+ * The way from a card to the site's own page it stands for, with its chrome,
+ * at the end of the card: a chat keeps the card's top right corner for its own
+ * control. Framed by a chat, the page opens in a new tab, so the conversation
+ * keeps its place; opened on its own, the card becomes the page. It never
+ * prints.
+ * @param props - See {@link CardDetailsButtonProps}.
+ * @returns The button, with the tooltip saying where the page opens.
+ */
+export declare function CardDetailsButton(props: CardDetailsButtonProps): ReactElement;
+//# sourceMappingURL=CardDetailsButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CardDetailsButton.d.ts","sourceRoot":"","sources":["../../../src/card/ui/CardDetailsButton.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAMzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAU9D,4CAA4C;AAC5C,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CAoC7E"}

package/lib/card/ui/CardDetailsButton.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Button, Tooltip } from '@blueprintjs/core';
+import { useEffect } from 'react';
+import { useChromeT } from "../../i18n/ui/useT.js";
+import { pageLocation } from "../../router/core/pageAddress.js";
+import { useActionTooltip } from "../../shared/ui/useActionTooltip.js";
+import { sitePageUrl } from "../core/cardAddress.js";
+import { CARD_TOOLTIP_CLASS, CARD_TOOLTIP_DELAY, CARD_TOOLTIP_MODIFIERS, } from "./cardTooltip.js";
+import { loadEmbed, loadedEmbed } from "./embed.js";
+/**
+ * The way from a card to the site's own page it stands for, with its chrome,
+ * at the end of the card: a chat keeps the card's top right corner for its own
+ * control. Framed by a chat, the page opens in a new tab, so the conversation
+ * keeps its place; opened on its own, the card becomes the page. It never
+ * prints.
+ * @param props - See {@link CardDetailsButtonProps}.
+ * @returns The button, with the tooltip saying where the page opens.
+ */
+export function CardDetailsButton(props) {
+    const { page, address, tooltip, testId = 'card-details' } = props;
+    const t = useChromeT();
+    const { isOpen, target } = useActionTooltip(false, CARD_TOOLTIP_DELAY);
+    useEffect(() => {
+        loadEmbed().catch(() => undefined);
+    }, []);
+    return (_jsx(Tooltip, { content: tooltip ?? t('card.detailsTitle'), placement: "top-end", modifiers: CARD_TOOLTIP_MODIFIERS, popoverClassName: CARD_TOOLTIP_CLASS, isOpen: isOpen, children: _jsx("span", { className: "no-print", style: WRAP_STYLE, ...target, children: _jsx(Button, { variant: "minimal", size: "small", icon: "share", text: t('card.details'), "aria-label": t('card.detailsLabel'), "data-testid": testId, onClick: () => {
+                    const url = page === undefined ? cardSitePage(address) : page();
+                    const embed = loadedEmbed();
+                    if (embed === undefined) {
+                        void loadEmbed().then((module) => module.openSitePage(url));
+                    }
+                    else {
+                        embed.openSitePage(url);
+                    }
+                } }) }) }));
+}
+/**
+ * The site's page behind the card on screen, read when the button is
+ * pressed: the page's own address — held in memory under a sealed link — on
+ * the origin the card is served from.
+ * @param address - What only the card reads.
+ * @returns The page's absolute address.
+ */
+function cardSitePage(address) {
+    const { origin } = globalThis.location;
+    const { pathname, search } = pageLocation() ?? globalThis.location;
+    return sitePageUrl({ origin, pathname, search }, address);
+}
+const WRAP_STYLE = { display: 'inline-flex' };
+//# sourceMappingURL=CardDetailsButton.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CardDetailsButton.js","sourceRoot":"","sources":["../../../src/card/ui/CardDetailsButton.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAEvE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4BpD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,GAAG,KAAK,CAAC;IAClE,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;IACvE,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,CACL,KAAC,OAAO,IACN,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,mBAAmB,CAAC,EAC1C,SAAS,EAAC,SAAS,EACnB,SAAS,EAAE,sBAAsB,EACjC,gBAAgB,EAAE,kBAAkB,EACpC,MAAM,EAAE,MAAM,YAEd,eAAM,SAAS,EAAC,UAAU,EAAC,KAAK,EAAE,UAAU,KAAM,MAAM,YACtD,KAAC,MAAM,IACL,OAAO,EAAC,SAAS,EACjB,IAAI,EAAC,OAAO,EACZ,IAAI,EAAC,OAAO,EACZ,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC,gBACX,CAAC,CAAC,mBAAmB,CAAC,iBACrB,MAAM,EACnB,OAAO,EAAE,GAAG,EAAE;oBACZ,MAAM,GAAG,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBAChE,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;oBAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;wBACxB,KAAK,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC9D,CAAC;yBAAM,CAAC;wBACN,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;oBAC1B,CAAC;gBACH,CAAC,GACD,GACG,GACC,CACX,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,OAAoC;IACxD,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC;IACvC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,IAAI,UAAU,CAAC,QAAQ,CAAC;IACnE,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,GAAG,EAAE,OAAO,EAAE,aAAa,EAAmC,CAAC"}

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

@@ -0,0 +1,51 @@
+import type { ReactElement, ReactNode } from 'react';
+/** What {@link CardFigure} draws and takes away. */
+export interface CardFigureProps {
+    /** The drawing: a chart, a structure, a grid of them. */
+    children: ReactNode;
+    /** What a saved file is called, without its extension. */
+    fileName: string;
+    /**
+     * Glyphs drawn above the one copying the picture: the copy of the data the
+     * figure is drawn from, the notations of its structure
+     * (`StructureExportButton` of `react-cheminfo/structure`).
+     * @default undefined - the picture's glyph alone
+     */
+    tools?: ReactNode;
+    /**
+     * Class of the box the drawing is in, which is what the picture holds.
+     * @default undefined
+     */
+    className?: string;
+    /**
+     * Take the whole width the card gives, as a grid of structures does.
+     * @default false - as wide as the drawing
+     */
+    fill?: boolean;
+    /**
+     * The drawing is HTML rather than one SVG or canvas — a grid of cells — and
+     * the picture saved is painted from it as it is seen.
+     * @default false
+     */
+    html?: boolean;
+    /**
+     * What the picture's glyph is called, for the pointer and a screen reader.
+     * @default the chrome's own line, `Copy or save the picture`
+     */
+    label?: string;
+}
+/**
+ * A figure of a card with the glyphs that take it away: the picture copied as
+ * a PNG or saved as a PNG or an SVG, as the chat offers it for its own
+ * figures, and whatever else the figure carries.
+ *
+ * The glyphs stand in a column beside the figure's top right corner rather
+ * than over it, so they hide no part of a curve or an atom, and they fade
+ * until the figure is pointed at or one of them holds the focus: a card shown
+ * in a chat is read far more often than it is copied. `styles/card.css` draws
+ * the column.
+ * @param props - See {@link CardFigureProps}.
+ * @returns The figure, with its column of glyphs.
+ */
+export declare function CardFigure(props: CardFigureProps): ReactElement;
+//# sourceMappingURL=CardFigure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CardFigure.d.ts","sourceRoot":"","sources":["../../../src/card/ui/CardFigure.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQrD,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,QAAQ,EAAE,SAAS,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CA4B/D"}

package/lib/card/ui/CardFigure.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId } from 'react';
+import { FigureDownload } from "../../download/ui/FigureDownload.js";
+import { useChromeT } from "../../i18n/ui/useT.js";
+import { OverlayLayer } from "../../overlay/ui/OverlayLayer.js";
+import { joinClassNames } from "../../shared/ui/joinClassNames.js";
+/**
+ * A figure of a card with the glyphs that take it away: the picture copied as
+ * a PNG or saved as a PNG or an SVG, as the chat offers it for its own
+ * figures, and whatever else the figure carries.
+ *
+ * The glyphs stand in a column beside the figure's top right corner rather
+ * than over it, so they hide no part of a curve or an atom, and they fade
+ * until the figure is pointed at or one of them holds the focus: a card shown
+ * in a chat is read far more often than it is copied. `styles/card.css` draws
+ * the column.
+ * @param props - See {@link CardFigureProps}.
+ * @returns The figure, with its column of glyphs.
+ */
+export function CardFigure(props) {
+    const { children, fileName, tools, className, label } = props;
+    const { fill = false, html = false } = props;
+    const t = useChromeT();
+    const id = useId();
+    return (_jsxs("div", { className: joinClassNames('card-figure', fill && 'card-figure--fill'), children: [_jsx("div", { id: id, className: joinClassNames('card-figure__drawing', className), "data-figure": html ? 'html' : undefined, children: children }), _jsx(OverlayLayer, { density: "compact", awake: true, children: _jsxs("div", { className: "card-figure__tools", "data-testid": "figure-tools", children: [tools, _jsx(FigureDownload, { targetId: id, fileName: fileName, label: label ?? t('card.copyPicture'), testId: "card-save-figure" })] }) })] }));
+}
+//# sourceMappingURL=CardFigure.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CardFigure.js","sourceRoot":"","sources":["../../../src/card/ui/CardFigure.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAsC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAmC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAsCnE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAC9D,MAAM,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IAC7C,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,OAAO,CACL,eAAK,SAAS,EAAE,cAAc,CAAC,aAAa,EAAE,IAAI,IAAI,mBAAmB,CAAC,aACxE,cACE,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,cAAc,CAAC,sBAAsB,EAAE,SAAS,CAAC,iBAC/C,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,YAErC,QAAQ,GACL,EAEN,KAAC,YAAY,IAAC,OAAO,EAAC,SAAS,EAAC,KAAK,kBACnC,eAAK,SAAS,EAAC,oBAAoB,iBAAa,cAAc,aAC3D,KAAK,EACN,KAAC,cAAc,IACb,QAAQ,EAAE,EAAE,EACZ,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,KAAK,IAAI,CAAC,CAAC,kBAAkB,CAAC,EACrC,MAAM,EAAC,kBAAkB,GACzB,IACE,GACO,IACX,CACP,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,30 @@
+import type { ReactElement, ReactNode } from 'react';
+/** What {@link CardFrame} holds. */
+export interface CardFrameProps {
+    /** The card: the answer alone, compactly. */
+    children: ReactNode;
+    /**
+     * Class beside `card`, so a site can reach the card from its stylesheet.
+     * @default undefined
+     */
+    className?: string;
+    /**
+     * Value of the `data-testid` attribute.
+     * @default 'card'
+     */
+    testId?: string;
+}
+/**
+ * The page a chat frames inline for one answer: the card, with no header, no
+ * footer and no form, as tall as what it shows. Framed, it reports its height
+ * so the chat fits the frame to it, and grows while a panel it opened is open
+ * so the frame holds that too; opened on its own, it is a page like any other.
+ *
+ * `react-cheminfo/styles/card.css` draws it: no margin on the page around it,
+ * the chat's corner left free by `card__header`, and the row of actions at its
+ * end, `card__end`.
+ * @param props - See {@link CardFrameProps}.
+ * @returns The card's root element.
+ */
+export declare function CardFrame(props: CardFrameProps): ReactElement;
+//# sourceMappingURL=CardFrame.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CardFrame.d.ts","sourceRoot":"","sources":["../../../src/card/ui/CardFrame.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMrD,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CAW7D"}

package/lib/card/ui/CardFrame.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { joinClassNames } from "../../shared/ui/joinClassNames.js";
+import { fitCardToFrame } from "./fitCardToFrame.js";
+/**
+ * The page a chat frames inline for one answer: the card, with no header, no
+ * footer and no form, as tall as what it shows. Framed, it reports its height
+ * so the chat fits the frame to it, and grows while a panel it opened is open
+ * so the frame holds that too; opened on its own, it is a page like any other.
+ *
+ * `react-cheminfo/styles/card.css` draws it: no margin on the page around it,
+ * the chat's corner left free by `card__header`, and the row of actions at its
+ * end, `card__end`.
+ * @param props - See {@link CardFrameProps}.
+ * @returns The card's root element.
+ */
+export function CardFrame(props) {
+    const { children, className, testId = 'card' } = props;
+    return (_jsx("div", { ref: fitCardToFrame, className: joinClassNames('card', className), "data-testid": testId, children: children }));
+}
+//# sourceMappingURL=CardFrame.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CardFrame.js","sourceRoot":"","sources":["../../../src/card/ui/CardFrame.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAkBrD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;IACvD,OAAO,CACL,cACE,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,iBAC/B,MAAM,YAElB,QAAQ,GACL,CACP,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,37 @@
+import type { ReactElement } from 'react';
+/** What {@link CopyTableButton} copies. */
+export interface CopyTableButtonProps {
+    /**
+     * Writes the table, tab-separated and header first, when the button is
+     * pressed: a card holding a long table writes nothing until it is asked.
+     */
+    table: () => string;
+    /**
+     * What the tooltip says the button copies, e.g. `Copy the conformers as a
+     * table, to paste into a spreadsheet`.
+     * @default the chrome's own line, `Copy the table, to paste into a
+     *   spreadsheet`
+     */
+    tooltip?: string;
+    /**
+     * Show the glyph alone, which is what a heading of a few letters has room
+     * for. The label is still the button's accessible name.
+     * @default false - the label shows, and gives way to the glyph on a frame
+     *   narrower than 30rem
+     */
+    glyphOnly?: boolean;
+    /**
+     * Value of the `data-testid` attribute of the button's box.
+     * @default 'card-copy-table'
+     */
+    testId?: string;
+}
+/**
+ * A card's "Copy as table" action: the table, tab-separated and header first,
+ * which a spreadsheet pastes into its cells. A tick says the clipboard took
+ * it, a cross that the browser refused. It never prints.
+ * @param props - See {@link CopyTableButtonProps}.
+ * @returns The button, with the tooltip saying what it copies.
+ */
+export declare function CopyTableButton(props: CopyTableButtonProps): ReactElement;
+//# sourceMappingURL=CopyTableButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CopyTableButton.d.ts","sourceRoot":"","sources":["../../../src/card/ui/CopyTableButton.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAY1C,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,CAgCzE"}

package/lib/card/ui/CopyTableButton.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Tooltip } from '@blueprintjs/core';
+import { CopyButton } from "../../clipboard/ui/CopyButton.js";
+import { useChromeT } from "../../i18n/ui/useT.js";
+import { joinClassNames } from "../../shared/ui/joinClassNames.js";
+import { CARD_TOOLTIP_CLASS, CARD_TOOLTIP_DELAY, CARD_TOOLTIP_MODIFIERS, } from "./cardTooltip.js";
+/**
+ * A card's "Copy as table" action: the table, tab-separated and header first,
+ * which a spreadsheet pastes into its cells. A tick says the clipboard took
+ * it, a cross that the browser refused. It never prints.
+ * @param props - See {@link CopyTableButtonProps}.
+ * @returns The button, with the tooltip saying what it copies.
+ */
+export function CopyTableButton(props) {
+    const { table, tooltip, glyphOnly = false, testId = 'card-copy-table', } = props;
+    const t = useChromeT();
+    return (_jsx(Tooltip, { content: tooltip ?? t('card.copyTableTitle'), placement: "top-end", modifiers: CARD_TOOLTIP_MODIFIERS, popoverClassName: CARD_TOOLTIP_CLASS, hoverOpenDelay: CARD_TOOLTIP_DELAY, children: _jsx("span", { "data-testid": testId, children: _jsx(CopyButton, { content: table, label: t('card.copyTable'), title: "", icon: "th", minimal: true, small: true, className: joinClassNames('card__copy-table', glyphOnly && 'card__copy-table--glyph') }) }) }));
+}
+//# sourceMappingURL=CopyTableButton.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CopyTableButton.js","sourceRoot":"","sources":["../../../src/card/ui/CopyTableButton.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAmC,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AA8B1B;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EACJ,KAAK,EACL,OAAO,EACP,SAAS,GAAG,KAAK,EACjB,MAAM,GAAG,iBAAiB,GAC3B,GAAG,KAAK,CAAC;IACV,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,OAAO,CACL,KAAC,OAAO,IACN,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,qBAAqB,CAAC,EAC5C,SAAS,EAAC,SAAS,EACnB,SAAS,EAAE,sBAAsB,EACjC,gBAAgB,EAAE,kBAAkB,EACpC,cAAc,EAAE,kBAAkB,YAElC,8BAAmB,MAAM,YACvB,KAAC,UAAU,IACT,OAAO,EAAE,KAAK,EACd,KAAK,EAAE,CAAC,CAAC,gBAAgB,CAAC,EAC1B,KAAK,EAAC,EAAE,EACR,IAAI,EAAC,IAAI,EACT,OAAO,QACP,KAAK,QACL,SAAS,EAAE,cAAc,CACvB,kBAAkB,EAClB,SAAS,IAAI,yBAAyB,CACvC,GACD,GACG,GACC,CACX,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { PopoverProps } from '@blueprintjs/core';
+/**
+ * The family's help card, at the width of the few words a card's action
+ * says: `styles/card.css` lets `card-tooltip` shrink to its text.
+ */
+export declare const CARD_TOOLTIP_CLASS = "help-tooltip card-tooltip";
+/**
+ * Where a card's tooltip goes when the frame has no room above its control:
+ * beside it, rather than cut by the frame's edge.
+ */
+export declare const CARD_TOOLTIP_MODIFIERS: PopoverProps['modifiers'];
+/** How long the pointer rests on an action of a card before it is named. */
+export declare const CARD_TOOLTIP_DELAY = 300;
+//# sourceMappingURL=cardTooltip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cardTooltip.d.ts","sourceRoot":"","sources":["../../../src/card/ui/cardTooltip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,YAAY,CAAC,WAAW,CAE5D,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,MAAM,CAAC"}

package/lib/card/ui/cardTooltip.js

@@ -0,0 +1,15 @@
+/**
+ * The family's help card, at the width of the few words a card's action
+ * says: `styles/card.css` lets `card-tooltip` shrink to its text.
+ */
+export const CARD_TOOLTIP_CLASS = 'help-tooltip card-tooltip';
+/**
+ * Where a card's tooltip goes when the frame has no room above its control:
+ * beside it, rather than cut by the frame's edge.
+ */
+export const CARD_TOOLTIP_MODIFIERS = {
+    flip: { options: { fallbackPlacements: ['left'] } },
+};
+/** How long the pointer rests on an action of a card before it is named. */
+export const CARD_TOOLTIP_DELAY = 300;
+//# sourceMappingURL=cardTooltip.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cardTooltip.js","sourceRoot":"","sources":["../../../src/card/ui/cardTooltip.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA8B;IAC/D,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE;CACpD,CAAC;AAEF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC"}

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

@@ -0,0 +1,15 @@
+import type * as Embed from 'cheminfo-mcp-server/embed';
+/**
+ * Load `cheminfo-mcp-server/embed` once, on first use. It is an optional
+ * peer, so `react-cheminfo/card` must import without it; a site that lacks it
+ * gets a card that never talks to a frame.
+ * @returns The module, once loaded.
+ */
+export declare function loadEmbed(): Promise<typeof Embed>;
+/**
+ * The module {@link loadEmbed} loaded, read synchronously — a click must open
+ * its page in the same task, or the browser blocks the new tab.
+ * @returns The module, or undefined while it is still loading.
+ */
+export declare function loadedEmbed(): typeof Embed | undefined;
+//# sourceMappingURL=embed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../../src/card/ui/embed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,2BAA2B,CAAC;AAKxD;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,CAMjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,OAAO,KAAK,GAAG,SAAS,CAEtD"}

package/lib/card/ui/embed.js

@@ -0,0 +1,24 @@
+let loading;
+let loaded;
+/**
+ * Load `cheminfo-mcp-server/embed` once, on first use. It is an optional
+ * peer, so `react-cheminfo/card` must import without it; a site that lacks it
+ * gets a card that never talks to a frame.
+ * @returns The module, once loaded.
+ */
+export function loadEmbed() {
+    loading ??= import('cheminfo-mcp-server/embed').then((module) => {
+        loaded = module;
+        return module;
+    });
+    return loading;
+}
+/**
+ * The module {@link loadEmbed} loaded, read synchronously — a click must open
+ * its page in the same task, or the browser blocks the new tab.
+ * @returns The module, or undefined while it is still loading.
+ */
+export function loadedEmbed() {
+    return loaded;
+}
+//# sourceMappingURL=embed.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../../../src/card/ui/embed.ts"],"names":[],"mappings":"AAEA,IAAI,OAA0C,CAAC;AAC/C,IAAI,MAAgC,CAAC;AAErC;;;;;GAKG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,KAAK,MAAM,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QAC9D,MAAM,GAAG,MAAM,CAAC;QAChB,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { RefObject } from 'react';
+/**
+ * Fit the frame a chat shows a card in to the card: report the card's height
+ * to the view framing it, now and on every change, so nothing scrolls twice,
+ * and grow the card while a panel it opened is open, so the frame holds the
+ * panel too. A card opened on its own is the page: there is no frame to tell
+ * and none to grow, and nothing is done.
+ *
+ * Its shape is a React 19 ref callback's — `ref={fitCardToFrame}` — so it
+ * starts once the card is mounted and stops when it is removed. The first
+ * card waits for `cheminfo-mcp-server/embed` to load; a site without it gets
+ * a card that never reports.
+ * @param card - The element holding the whole card; none reports nothing.
+ * @returns A function that stops both, or undefined when nothing started.
+ */
+export declare function fitCardToFrame(card: HTMLElement | null): (() => void) | undefined;
+/**
+ * {@link fitCardToFrame} for a card held in a ref, from its first render to
+ * its last.
+ * @param card - The ref of the element holding the whole card.
+ */
+export declare function useFitCardToFrame(card: RefObject<HTMLElement | null>): void;
+/**
+ * Keep a card at least as tall as the dialogs and popovers opened over it,
+ * framed or not: {@link holdRoomForPanels} for a card held in a ref. A card
+ * whose height is reported elsewhere uses this; one that only needs its frame
+ * fitted uses {@link useFitCardToFrame}, which does both.
+ * @param card - The ref of the element holding the whole card.
+ */
+export declare function useOverlayRoom(card: RefObject<HTMLElement | null>): void;
+//# sourceMappingURL=fitCardToFrame.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fitCardToFrame.d.ts","sourceRoot":"","sources":["../../../src/card/ui/fitCardToFrame.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,WAAW,GAAG,IAAI,GACvB,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAgB1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,IAAI,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,IAAI,CAKxE"}

package/lib/card/ui/fitCardToFrame.js

@@ -0,0 +1,66 @@
+import { useEffect } from 'react';
+import { loadEmbed, loadedEmbed } from "./embed.js";
+import { holdRoomForPanels } from "./holdRoomForPanels.js";
+/**
+ * Fit the frame a chat shows a card in to the card: report the card's height
+ * to the view framing it, now and on every change, so nothing scrolls twice,
+ * and grow the card while a panel it opened is open, so the frame holds the
+ * panel too. A card opened on its own is the page: there is no frame to tell
+ * and none to grow, and nothing is done.
+ *
+ * Its shape is a React 19 ref callback's — `ref={fitCardToFrame}` — so it
+ * starts once the card is mounted and stops when it is removed. The first
+ * card waits for `cheminfo-mcp-server/embed` to load; a site without it gets
+ * a card that never reports.
+ * @param card - The element holding the whole card; none reports nothing.
+ * @returns A function that stops both, or undefined when nothing started.
+ */
+export function fitCardToFrame(card) {
+    if (card === null)
+        return undefined;
+    const embed = loadedEmbed();
+    if (embed !== undefined)
+        return fitLoaded(embed, card);
+    let stop;
+    let stopped = false;
+    loadEmbed().then((module) => {
+        if (!stopped)
+            stop = fitLoaded(module, card);
+    }, () => undefined);
+    return () => {
+        stopped = true;
+        stop?.();
+    };
+}
+/**
+ * {@link fitCardToFrame} for a card held in a ref, from its first render to
+ * its last.
+ * @param card - The ref of the element holding the whole card.
+ */
+export function useFitCardToFrame(card) {
+    useEffect(() => fitCardToFrame(card.current), [card]);
+}
+/**
+ * Keep a card at least as tall as the dialogs and popovers opened over it,
+ * framed or not: {@link holdRoomForPanels} for a card held in a ref. A card
+ * whose height is reported elsewhere uses this; one that only needs its frame
+ * fitted uses {@link useFitCardToFrame}, which does both.
+ * @param card - The ref of the element holding the whole card.
+ */
+export function useOverlayRoom(card) {
+    useEffect(() => {
+        const element = card.current;
+        return element === null ? undefined : holdRoomForPanels(element);
+    }, [card]);
+}
+function fitLoaded(embed, card) {
+    if (!embed.isFramed())
+        return undefined;
+    const stopRoom = holdRoomForPanels(card);
+    const stopReport = embed.reportEmbedHeight(card);
+    return () => {
+        stopReport();
+        stopRoom();
+    };
+}
+//# sourceMappingURL=fitCardToFrame.js.map