react-cheminfo 0.9.0 → 0.11.0

package/lib/overlay/ui/OverlayBarCard.js

@@ -0,0 +1,28 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { OverlayBarButton } from "./OverlayBarButton.js";
+import { overlayCardStyle, overlayContentStyle, overlayGroundStyle, overlayRestingOpacity, } from "./overlayStyles.js";
+import { useOverlaySurface } from "./overlaySurface.js";
+/**
+ * The small card of controls floating in a corner of a figure.
+ *
+ * It rests at three quarters strength and wakes when the pointer reaches the
+ * figure or the keyboard reaches one of its controls; only the ground fades,
+ * never the text, and the tab order is the same whether it is resting or
+ * awake, so the fade is a courtesy to the eye and never a gate on the
+ * interaction.
+ *
+ * Folded, it is the button alone: a card has only the one tier, and a corner
+ * of a narrow figure is not somewhere half a strip of controls can live — the
+ * tools fold away with the controls, since what they act on is the very figure
+ * the card would then be covering.
+ * @param props - See {@link OverlayBarCardProps}.
+ * @returns The card.
+ */
+export function OverlayBarCard(props) {
+    const { children, end, tools, info, more, placement, label } = props;
+    const { moreIcon, morePadded, folded, testId, restingOpacity } = props;
+    const { metrics, awake, busy } = useOverlaySurface();
+    const opener = folded || more !== undefined ? (_jsxs(OverlayBarButton, { placement: placement, label: label, icon: moreIcon, padded: morePadded, children: [folded ? children : null, more] })) : null;
+    return (_jsxs("div", { style: overlayCardStyle(placement, metrics), "data-testid": testId, children: [_jsx("div", { style: overlayGroundStyle(awake ? 1 : overlayRestingOpacity(restingOpacity), busy) }), folded ? (_jsx("div", { style: overlayContentStyle(metrics), children: opener })) : (_jsxs("div", { role: "group", "aria-label": label, style: overlayContentStyle(metrics), children: [children, end, tools, info, opener] }))] }));
+}
+//# sourceMappingURL=OverlayBarCard.js.map

package/lib/overlay/ui/OverlayBarCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayBarCard.js","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayBarCard.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAwB,CAAC;AAE1D,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQxD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACrE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IACvE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAErD,MAAM,MAAM,GACV,MAAM,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAC7B,MAAC,gBAAgB,IACf,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,UAAU,aAEjB,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EACxB,IAAI,IACY,CACpB,CAAC,CAAC,CAAC,IAAI,CAAC;IAEX,OAAO,CACL,eAAK,KAAK,EAAE,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,iBAAe,MAAM,aACnE,cACE,KAAK,EAAE,kBAAkB,CACvB,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,cAAc,CAAC,EACjD,IAAI,CACL,GACD,EACD,MAAM,CAAC,CAAC,CAAC,CACR,cAAK,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,YAAG,MAAM,GAAO,CACzD,CAAC,CAAC,CAAC,CACF,eACE,IAAI,EAAC,OAAO,gBACA,KAAK,EACjB,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,aAElC,QAAQ,EACR,GAAG,EACH,KAAK,EACL,IAAI,EACJ,MAAM,IACH,CACP,IACG,CACP,CAAC;AACJ,CAAC"}

package/lib/overlay/ui/OverlayBarStrip.d.ts

@@ -0,0 +1,18 @@
+import type { ReactElement } from 'react';
+import type { OverlayBarShapeProps } from './overlayBarShape.ts';
+/**
+ * The bar that spans the width of the figure, its two ends pushed apart.
+ *
+ * It is in the flow above the picture rather than on it, and its ground is
+ * solid rather than translucent, because a strip reaching from one edge of the
+ * figure to the other is chrome the picture is mounted in — a floating card
+ * that wide would cover the very data it is there to explain.
+ *
+ * What folds when the figure is too narrow is the far end alone: the start
+ * holds the strip a reader moves between views with, and a reader who cannot
+ * leave the view they are on is stuck rather than merely short of options.
+ * @param props - See {@link OverlayBarShapeProps}.
+ * @returns The bar.
+ */
+export declare function OverlayBarStrip(props: OverlayBarShapeProps): ReactElement;
+//# sourceMappingURL=OverlayBarStrip.d.ts.map

package/lib/overlay/ui/OverlayBarStrip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayBarStrip.d.ts","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayBarStrip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AASjE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,CAmCzE"}

package/lib/overlay/ui/OverlayBarStrip.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { OverlayBarButton } from "./OverlayBarButton.js";
+import { OVERLAY_BAR_GROUND_STYLE, overlayBarContentStyle, overlayBarSideStyle, overlayCardStyle, } from "./overlayStyles.js";
+import { useOverlaySurface } from "./overlaySurface.js";
+/**
+ * The bar that spans the width of the figure, its two ends pushed apart.
+ *
+ * It is in the flow above the picture rather than on it, and its ground is
+ * solid rather than translucent, because a strip reaching from one edge of the
+ * figure to the other is chrome the picture is mounted in — a floating card
+ * that wide would cover the very data it is there to explain.
+ *
+ * What folds when the figure is too narrow is the far end alone: the start
+ * holds the strip a reader moves between views with, and a reader who cannot
+ * leave the view they are on is stuck rather than merely short of options.
+ * @param props - See {@link OverlayBarShapeProps}.
+ * @returns The bar.
+ */
+export function OverlayBarStrip(props) {
+    const { children, end, tools, info, more, placement, label } = props;
+    const { moreIcon, morePadded, folded, testId } = props;
+    const { metrics } = useOverlaySurface();
+    const opens = more !== undefined || (folded && end !== undefined);
+    return (_jsxs("div", { style: overlayCardStyle(placement, metrics), "data-testid": testId, children: [_jsx("div", { style: OVERLAY_BAR_GROUND_STYLE }), _jsxs("div", { style: overlayBarContentStyle(metrics), children: [_jsx("div", { style: overlayBarSideStyle(metrics), children: children }), _jsxs("div", { role: "group", "aria-label": label, style: overlayBarSideStyle(metrics), children: [folded ? null : end, tools, info, opens ? (_jsxs(OverlayBarButton, { placement: placement, label: label, icon: moreIcon, padded: morePadded, children: [folded ? end : null, more] })) : null] })] })] }));
+}
+//# sourceMappingURL=OverlayBarStrip.js.map

package/lib/overlay/ui/OverlayBarStrip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayBarStrip.js","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayBarStrip.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAwB,CAAC;AAE1D,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACrE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACvD,MAAM,EAAE,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAExC,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS,IAAI,CAAC,MAAM,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC;IAElE,OAAO,CACL,eAAK,KAAK,EAAE,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,iBAAe,MAAM,aACnE,cAAK,KAAK,EAAE,wBAAwB,GAAI,EACxC,eAAK,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,aACzC,cAAK,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,YAAG,QAAQ,GAAO,EAC1D,eACE,IAAI,EAAC,OAAO,gBACA,KAAK,EACjB,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,aAElC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EACnB,KAAK,EACL,IAAI,EACJ,KAAK,CAAC,CAAC,CAAC,CACP,MAAC,gBAAgB,IACf,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,UAAU,aAEjB,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EACnB,IAAI,IACY,CACpB,CAAC,CAAC,CAAC,IAAI,IACJ,IACF,IACF,CACP,CAAC;AACJ,CAAC"}

package/lib/overlay/ui/OverlayCaption.d.ts

@@ -0,0 +1,52 @@
+import type { ReactElement, ReactNode } from 'react';
+/** What {@link OverlayCaption} says, and where. */
+export interface OverlayCaptionProps {
+    /**
+     * One sentence, in words the reader already has. It is the figure's own
+     * explanation, so it names what a mark is before it names what an axis is.
+     */
+    children: ReactNode;
+    /**
+     * Whether it floats over the figure or is laid out in the flow beneath it.
+     *
+     * A figure reserves the foot of its own box for the horizontal axis title, so
+     * a band floating there prints the sentence over the axis name. `below` is
+     * therefore what a standing explanation wants: it explains the picture rather
+     * than annotating a gesture, and nothing it says is worth covering the axis
+     * for. `over` is left for a sentence that has to reach the reader without the
+     * figure moving under their pointer.
+     * @default 'over'
+     */
+    placement?: 'over' | 'below';
+    /**
+     * Which edge it sits against, when it floats over the figure. A docked
+     * caption ignores it — it has only the one place to be.
+     * @default 'bottom'
+     */
+    edge?: 'top' | 'bottom';
+    /**
+     * How loud it is. `quiet` is the standing explanation; `strong` is live
+     * state the reader has just caused — `Adding to selection`, `31 samples
+     * selected`.
+     * @default 'quiet'
+     */
+    tone?: 'quiet' | 'strong';
+    /**
+     * Whether a screen reader is told about it as it changes. Turn it on for
+     * `strong`, so a selection made by keyboard is announced.
+     * @default false
+     */
+    live?: boolean;
+}
+/**
+ * The band across a figure that says, in one sentence, what it is showing.
+ *
+ * Floating, it is a gradient rather than a filled strip: the sentence stays
+ * readable while the marks under its far edge stay visible, so it never looks
+ * as though it has cropped the data. Docked, it needs neither — there is
+ * nothing under it to see through to.
+ * @param props - See {@link OverlayCaptionProps}.
+ * @returns The band.
+ */
+export declare function OverlayCaption(props: OverlayCaptionProps): ReactElement;
+//# sourceMappingURL=OverlayCaption.d.ts.map

package/lib/overlay/ui/OverlayCaption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayCaption.d.ts","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayCaption.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOpE,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B;;;;OAIG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IACxB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CAkBvE"}

package/lib/overlay/ui/OverlayCaption.js

@@ -0,0 +1,62 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { overlayCaptionStyle } from "./overlayFigureStyles.js";
+import { useOverlaySurface } from "./overlaySurface.js";
+/**
+ * The band across a figure that says, in one sentence, what it is showing.
+ *
+ * Floating, it is a gradient rather than a filled strip: the sentence stays
+ * readable while the marks under its far edge stay visible, so it never looks
+ * as though it has cropped the data. Docked, it needs neither — there is
+ * nothing under it to see through to.
+ * @param props - See {@link OverlayCaptionProps}.
+ * @returns The band.
+ */
+export function OverlayCaption(props) {
+    const { children, placement = 'over', edge = 'bottom' } = props;
+    const { tone = 'quiet', live = false } = props;
+    const { metrics } = useOverlaySurface();
+    return (_jsx("div", { style: placement === 'below' ? DOCKED_STYLE : bandStyle(edge, metrics), children: _jsx("span", { style: overlayCaptionStyle(metrics, tone), "aria-live": live ? 'polite' : undefined, "aria-atomic": live ? true : undefined, children: children }) }));
+}
+/**
+ * The band is the one piece of chrome that spans the whole figure, so it keeps
+ * the pointer away from itself even though a card takes it back: a sentence
+ * across the foot of a scatter would otherwise swallow the start of every
+ * lasso drawn near the bottom edge.
+ * @param edge - Which edge the sentence sits against.
+ * @param metrics - The measurements the chrome is drawn from.
+ * @returns The band's rules.
+ */
+function bandStyle(edge, metrics) {
+    return {
+        position: 'absolute',
+        left: 0,
+        right: 0,
+        top: edge === 'top' ? 0 : undefined,
+        bottom: edge === 'bottom' ? 0 : undefined,
+        display: 'flex',
+        alignItems: 'center',
+        padding: `${metrics.paddingY}px ${metrics.inset}px`,
+        background: `linear-gradient(to ${edge === 'bottom' ? 'top' : 'bottom'}, ${GROUND}, ${GROUND} 45%, ${CLEAR})`,
+        pointerEvents: 'none',
+    };
+}
+/**
+ * Nearly the page's own surface where the words are, and the same colour at
+ * zero strength where they stop. Fading to plain `transparent` interpolates
+ * through transparent black, which draws a grey bruise across the middle of a
+ * light figure.
+ */
+const GROUND = 'color-mix(in srgb, var(--surface) 86%, transparent)';
+const CLEAR = 'color-mix(in srgb, var(--surface) 0%, transparent)';
+/**
+ * A docked caption's own row: a block in the flow, with no ground of its own.
+ *
+ * It keeps the pointer, unlike the floating band. Below the figure there is no
+ * lasso to start underneath it, and a sentence a reader cannot select is a
+ * sentence they cannot quote.
+ */
+const DOCKED_STYLE = {
+    display: 'flex',
+    alignItems: 'center',
+};
+//# sourceMappingURL=OverlayCaption.js.map

package/lib/overlay/ui/OverlayCaption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayCaption.js","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayCaption.tsx"],"names":[],"mappings":";AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AA0CxD;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,MAAM,EAAE,IAAI,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAC;IAChE,MAAM,EAAE,IAAI,GAAG,OAAO,EAAE,IAAI,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAExC,OAAO,CACL,cACE,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,YAEtE,eACE,KAAK,EAAE,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,eAC9B,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,iBACzB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,YAEnC,QAAQ,GACJ,GACH,CACP,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,SAAS,CAChB,IAAsB,EACtB,OAAuB;IAEvB,OAAO;QACL,QAAQ,EAAE,UAAU;QACpB,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,GAAG,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QACnC,MAAM,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QACzC,OAAO,EAAE,MAAM;QACf,UAAU,EAAE,QAAQ;QACpB,OAAO,EAAE,GAAG,OAAO,CAAC,QAAQ,MAAM,OAAO,CAAC,KAAK,IAAI;QACnD,UAAU,EAAE,sBAAsB,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,KAAK,MAAM,SAAS,KAAK,GAAG;QAC7G,aAAa,EAAE,MAAM;KACtB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,MAAM,GAAG,qDAAqD,CAAC;AACrE,MAAM,KAAK,GAAG,oDAAoD,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,YAAY,GAAG;IACnB,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,QAAQ;CACY,CAAC"}

package/lib/overlay/ui/OverlayChip.d.ts

@@ -0,0 +1,60 @@
+import type { PopoverNextPlacement } from '@blueprintjs/core';
+import type { ReactElement, ReactNode } from 'react';
+/** One setting a chip reads out. */
+export interface OverlayChipSetting {
+    /**
+     * What the setting is called, in full: `Colour by`, `Group outlines`. It is
+     * never written on the chip — it is what the chip announces, so a screen
+     * reader is told which question each value answers.
+     */
+    label: string;
+    /** What the setting is currently on, which is what the chip writes. */
+    value: string;
+    /**
+     * The figure's own colours, drawn as a row of dots at the head of the chip.
+     * @default undefined — no dots are drawn
+     */
+    swatches?: readonly string[];
+}
+/** What {@link OverlayChip} needs. */
+export interface OverlayChipProps {
+    /** What the settings are called together, written over the panel it opens. */
+    label: string;
+    /** The settings it reads out, in the order they are written. */
+    settings: readonly OverlayChipSetting[];
+    /**
+     * The controls behind it, each with its own caption — the same controls the
+     * bar holds when it has room for them, rather than a reduced set.
+     */
+    children: ReactNode;
+    /**
+     * Whether none of the settings can be reached.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Which way the panel opens.
+     * @default 'bottom-end'
+     */
+    placement?: PopoverNextPlacement;
+    /**
+     * Value of the `data-testid` attribute of the chip.
+     * @default undefined
+     */
+    testId?: string;
+}
+/**
+ * Several settings gathered into one rounded chip that still reads them out.
+ *
+ * This is what a narrow bar folds its settings into, and the whole argument
+ * for it is that it is not a cog. A cog says only that there are settings; a
+ * reader looking at a scatter of coloured dots on a phone wants to know what
+ * the colours mean and how wide the outlines are drawn, and `Species · 95%`
+ * answers both without being opened. What the fold actually buys is one
+ * button's padding and one caret per setting swallowed — which is why the
+ * words survive it and only the boxes around them go.
+ * @param props - See {@link OverlayChipProps}.
+ * @returns The chip and its panel.
+ */
+export declare function OverlayChip(props: OverlayChipProps): ReactElement;
+//# sourceMappingURL=OverlayChip.d.ts.map

package/lib/overlay/ui/OverlayChip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayChip.d.ts","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayChip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAcrD,oCAAoC;AACpC,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,CAsEjE"}

package/lib/overlay/ui/OverlayChip.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Icon, PopoverNext } from '@blueprintjs/core';
+import { Fragment, useId, useState } from 'react';
+import { OverlaySwatchIcon } from "./OverlaySwatchIcon.js";
+import { overlayGroupTitleStyle } from "./overlayControlStyles.js";
+import { overlayPanelStyle } from "./overlayStyles.js";
+import { useOverlaySurface } from "./overlaySurface.js";
+import { overlayCaretStyle, overlayChipSeparatorStyle, overlayChipStyle, overlayValueTextStyle, } from "./overlayValueStyles.js";
+/**
+ * Several settings gathered into one rounded chip that still reads them out.
+ *
+ * This is what a narrow bar folds its settings into, and the whole argument
+ * for it is that it is not a cog. A cog says only that there are settings; a
+ * reader looking at a scatter of coloured dots on a phone wants to know what
+ * the colours mean and how wide the outlines are drawn, and `Species · 95%`
+ * answers both without being opened. What the fold actually buys is one
+ * button's padding and one caret per setting swallowed — which is why the
+ * words survive it and only the boxes around them go.
+ * @param props - See {@link OverlayChipProps}.
+ * @returns The chip and its panel.
+ */
+export function OverlayChip(props) {
+    const { label, settings, children, disabled = false } = props;
+    const { placement = 'bottom-end', testId } = props;
+    const { metrics } = useOverlaySurface();
+    const headingId = useId();
+    const [open, setOpen] = useState(false);
+    const [hovered, setHovered] = useState(false);
+    const [focused, setFocused] = useState(false);
+    const swatches = leadingSwatches(settings);
+    const name = announce(settings);
+    return (_jsx(PopoverNext, { isOpen: open, disabled: disabled, placement: placement, onInteraction: (next) => setOpen(next), content: _jsxs("div", { role: "group", "aria-labelledby": headingId, style: overlayPanelStyle(metrics), children: [_jsx("span", { id: headingId, style: overlayGroupTitleStyle(metrics), children: label }), children] }), children: _jsxs("button", { type: "button", title: name, "aria-label": name, "aria-haspopup": "menu", "aria-expanded": open, disabled: disabled, "data-testid": testId, style: overlayChipStyle(metrics, {
+                hovered,
+                focused,
+                active: open,
+                disabled,
+            }), onPointerEnter: () => setHovered(true), onPointerLeave: () => setHovered(false), onFocus: () => setFocused(true), onBlur: () => setFocused(false), children: [swatches === undefined ? null : (_jsx(OverlaySwatchIcon, { colors: swatches })), settings.map((setting, index) => (_jsxs(Fragment, { children: [index === 0 ? null : (_jsx("span", { "aria-hidden": "true", style: overlayChipSeparatorStyle(metrics) })), _jsx("span", { style: overlayValueTextStyle(), children: setting.value })] }, setting.label))), _jsx("span", { "aria-hidden": "true", style: overlayCaretStyle(), children: _jsx(Icon, { icon: "caret-down", size: metrics.fontSize + 2 }) })] }) }));
+}
+/**
+ * What the chip is called, which is every setting spelled out in full.
+ *
+ * The chip writes bare values, so a reader who cannot see it would otherwise
+ * be told `Species · 95%` and left to guess which question each answers.
+ * @param settings - The settings it reads out.
+ * @returns The name.
+ */
+function announce(settings) {
+    let name = '';
+    for (const setting of settings) {
+        if (name !== '')
+            name += ', ';
+        name += `${setting.label} — ${setting.value}`;
+    }
+    return name;
+}
+/**
+ * The colours drawn at the head of the chip.
+ *
+ * The first setting that has any, and only that one: two rows of dots inside
+ * one chip read as one palette of eight colours, which is the one thing this
+ * glyph exists not to say.
+ * @param settings - The settings it reads out.
+ * @returns The colours, or nothing.
+ */
+function leadingSwatches(settings) {
+    for (const setting of settings) {
+        const { swatches } = setting;
+        if (swatches !== undefined && swatches.length > 0)
+            return swatches;
+    }
+    return undefined;
+}
+//# sourceMappingURL=OverlayChip.js.map

package/lib/overlay/ui/OverlayChip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayChip.js","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayChip.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAyB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AA+CjC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IAC9D,MAAM,EAAE,SAAS,GAAG,YAAY,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACnD,MAAM,EAAE,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,KAAK,EAAE,CAAC;IAC1B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE9C,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEhC,OAAO,CACL,KAAC,WAAW,IACV,MAAM,EAAE,IAAI,EACZ,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EACtC,OAAO,EACL,eACE,IAAI,EAAC,OAAO,qBACK,SAAS,EAC1B,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,aAEjC,eAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,YACxD,KAAK,GACD,EACN,QAAQ,IACL,YAGR,kBACE,IAAI,EAAC,QAAQ,EACb,KAAK,EAAE,IAAI,gBACC,IAAI,mBACF,MAAM,mBACL,IAAI,EACnB,QAAQ,EAAE,QAAQ,iBACL,MAAM,EACnB,KAAK,EAAE,gBAAgB,CAAC,OAAO,EAAE;gBAC/B,OAAO;gBACP,OAAO;gBACP,MAAM,EAAE,IAAI;gBACZ,QAAQ;aACT,CAAC,EACF,cAAc,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EACtC,cAAc,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EACvC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAC/B,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,aAE9B,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC/B,KAAC,iBAAiB,IAAC,MAAM,EAAE,QAAQ,GAAI,CACxC,EACA,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAChC,MAAC,QAAQ,eACN,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACpB,8BACc,MAAM,EAClB,KAAK,EAAE,yBAAyB,CAAC,OAAO,CAAC,GACzC,CACH,EACD,eAAM,KAAK,EAAE,qBAAqB,EAAE,YAAG,OAAO,CAAC,KAAK,GAAQ,KAP/C,OAAO,CAAC,KAAK,CAQjB,CACZ,CAAC,EACF,8BAAkB,MAAM,EAAC,KAAK,EAAE,iBAAiB,EAAE,YACjD,KAAC,IAAI,IAAC,IAAI,EAAC,YAAY,EAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,GAAI,GACjD,IACA,GACG,CACf,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,QAAQ,CAAC,QAAuC;IACvD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,IAAI,KAAK,EAAE;YAAE,IAAI,IAAI,IAAI,CAAC;QAC9B,IAAI,IAAI,GAAG,OAAO,CAAC,KAAK,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,eAAe,CACtB,QAAuC;IAEvC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAC7B,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,QAAQ,CAAC;IACrE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/overlay/ui/OverlayDivider.d.ts

@@ -0,0 +1,11 @@
+import type { ReactElement } from 'react';
+/**
+ * A hairline between two clusters of controls.
+ *
+ * It is a real separator rather than a decorative line, so a reader moving
+ * through the card with a screen reader is told where one group of controls
+ * ends — which is the whole reason the line is there for everyone else.
+ * @returns The rule.
+ */
+export declare function OverlayDivider(): ReactElement;
+//# sourceMappingURL=OverlayDivider.d.ts.map

package/lib/overlay/ui/OverlayDivider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayDivider.d.ts","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayDivider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAK1C;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,YAAY,CAU7C"}

package/lib/overlay/ui/OverlayDivider.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { overlayDividerStyle } from "./overlayControlStyles.js";
+import { useOverlaySurface } from "./overlaySurface.js";
+/**
+ * A hairline between two clusters of controls.
+ *
+ * It is a real separator rather than a decorative line, so a reader moving
+ * through the card with a screen reader is told where one group of controls
+ * ends — which is the whole reason the line is there for everyone else.
+ * @returns The rule.
+ */
+export function OverlayDivider() {
+    const { metrics } = useOverlaySurface();
+    return (_jsx("span", { role: "separator", "aria-orientation": "vertical", style: overlayDividerStyle(metrics) }));
+}
+//# sourceMappingURL=OverlayDivider.js.map

package/lib/overlay/ui/OverlayDivider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayDivider.js","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayDivider.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,EAAE,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAExC,OAAO,CACL,eACE,IAAI,EAAC,WAAW,sBACC,UAAU,EAC3B,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACnC,CACH,CAAC;AACJ,CAAC"}

package/lib/overlay/ui/OverlayGroup.d.ts

@@ -0,0 +1,53 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { HelpContent } from '../../help/ui/HelpBody.tsx';
+/** What {@link OverlayGroup} needs. */
+export interface OverlayGroupProps {
+    /** The controls it holds. */
+    children: ReactNode;
+    /**
+     * What the cluster is about, written over it in small capitals. In a panel
+     * this is the section heading, and it is worth reaching for only past about
+     * four rows: three settings under two headings is a panel that has been
+     * filed rather than laid out. Nothing enforces that — a panel is allowed to
+     * be wrong about its own length — but it is the line to hold.
+     * @default undefined — the controls are drawn with no heading
+     */
+    label?: string;
+    /**
+     * What the cluster is for, in a sentence. Like a control's own help it hangs
+     * off the heading, which is underlined with dots to say so.
+     * @default undefined
+     */
+    help?: HelpContent;
+    /**
+     * Whether a hairline is drawn above the heading. Turn it off on the first
+     * section of a panel: a rule immediately under the panel header's own rule
+     * reads as a doubled line rather than as a division. Only consulted in a
+     * panel.
+     * @default true
+     */
+    divider?: boolean;
+    /**
+     * How the controls inside are stacked. A row wraps as one unit, so a cluster
+     * never breaks across two lines of the card mid-thought. Only consulted on a
+     * bar; a section of a panel is always a column.
+     * @default 'row'
+     */
+    direction?: 'row' | 'column';
+}
+/**
+ * Controls that answer one question, kept together.
+ *
+ * On a bar, two controls that only make sense read together — a mode and the
+ * number it takes — have to move together as the card reflows, or the reader
+ * meets the number on a line of its own with nothing saying what it counts.
+ *
+ * In a panel it is a section instead: a small-capitals heading over a hairline
+ * that gives the eye somewhere to rest on the way down a long list. A heading
+ * is worth adding once the cluster's idea has a name the names inside it do
+ * not already spell out.
+ * @param props - See {@link OverlayGroupProps}.
+ * @returns The cluster.
+ */
+export declare function OverlayGroup(props: OverlayGroupProps): ReactElement;
+//# sourceMappingURL=OverlayGroup.d.ts.map

package/lib/overlay/ui/OverlayGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayGroup.d.ts","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAkB9D,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAkEnE"}

package/lib/overlay/ui/OverlayGroup.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useId } from 'react';
+import { HelpTooltip } from "../../help/ui/HelpTooltip.js";
+import { overlayGroupStyle, overlayGroupTitleStyle, } from "./overlayControlStyles.js";
+import { useOverlayPanelShape } from "./overlayPanelContext.js";
+import { overlaySectionHeadingStyle, overlaySectionStyle, } from "./overlayPanelStyles.js";
+import { OVERLAY_HELP_NAME_STYLE, overlayStackedRowStyle, } from "./overlayRowStyles.js";
+import { useOverlaySurface } from "./overlaySurface.js";
+/**
+ * Controls that answer one question, kept together.
+ *
+ * On a bar, two controls that only make sense read together — a mode and the
+ * number it takes — have to move together as the card reflows, or the reader
+ * meets the number on a line of its own with nothing saying what it counts.
+ *
+ * In a panel it is a section instead: a small-capitals heading over a hairline
+ * that gives the eye somewhere to rest on the way down a long list. A heading
+ * is worth adding once the cluster's idea has a name the names inside it do
+ * not already spell out.
+ * @param props - See {@link OverlayGroupProps}.
+ * @returns The cluster.
+ */
+export function OverlayGroup(props) {
+    const { children, label, help, divider = true, direction = 'row' } = props;
+    const { metrics } = useOverlaySurface();
+    const panel = useOverlayPanelShape();
+    const headingId = useId();
+    if (panel !== undefined) {
+        if (label === undefined) {
+            return _jsx("div", { style: overlaySectionStyle(metrics), children: children });
+        }
+        return (_jsxs("div", { role: "group", "aria-labelledby": headingId, style: overlaySectionStyle(metrics), children: [_jsx(Explained, { help: help, children: _jsx("span", { id: headingId, className: help === undefined ? undefined : 'help-name', tabIndex: help === undefined ? undefined : 0, style: overlaySectionHeadingStyle(metrics, {
+                            divider,
+                            help: help !== undefined,
+                        }), children: label }) }), children] }));
+    }
+    const controls = (_jsx("div", { style: overlayGroupStyle(metrics, direction), children: children }));
+    if (label === undefined)
+        return controls;
+    return (_jsxs("div", { role: "group", "aria-labelledby": headingId, style: overlayStackedRowStyle(metrics), children: [_jsx(Explained, { help: help, children: _jsx("span", { id: headingId, className: help === undefined ? undefined : 'help-name', tabIndex: help === undefined ? undefined : 0, style: help === undefined
+                        ? overlayGroupTitleStyle(metrics)
+                        : {
+                            ...overlayGroupTitleStyle(metrics),
+                            ...OVERLAY_HELP_NAME_STYLE,
+                        }, children: label }) }), controls] }));
+}
+/**
+ * A heading, with its explanation behind it when it has one.
+ *
+ * The two shapes a group takes both need this, and writing the conditional
+ * twice is how one of them quietly loses its help.
+ * @param props - The heading and what it explains.
+ * @param props.help - The explanation, or nothing.
+ * @param props.children - The heading.
+ * @returns The heading.
+ */
+function Explained(props) {
+    const { help, children } = props;
+    if (help === undefined)
+        return _jsx(_Fragment, { children: children });
+    return _jsx(HelpTooltip, { content: help, children: children });
+}
+//# sourceMappingURL=OverlayGroup.js.map

package/lib/overlay/ui/OverlayGroup.js.map

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

package/lib/overlay/ui/OverlayIconButton.d.ts

@@ -0,0 +1,75 @@
+import type { IconName } from '@blueprintjs/core';
+import type { ReactElement } from 'react';
+/** What {@link OverlayIconButton} needs. */
+export interface OverlayIconButtonProps {
+    /**
+     * The glyph: a Blueprint icon name, or an element of the caller's own — an
+     * inline `<svg>` drawing the very mark the figure draws, which is the one
+     * kind of icon a reader does not have to learn.
+     */
+    icon: IconName | ReactElement;
+    /**
+     * What the setting is called, phrased as the question the reader already
+     * has: `Colour by`, `Group outlines`. It is written into both `title` and
+     * `aria-label`, because a glyph says nothing until it is named — that is the
+     * price of an icon-only bar, and it is paid here rather than left to each
+     * caller to remember.
+     */
+    label: string;
+    /**
+     * What the setting is currently on, written after the name as
+     * `label — value`. Give it wherever there is one: `Colour by — species`
+     * answers the reader's actual question, where `Colour by` alone only tells
+     * them which question the button asks.
+     * @default undefined — the name alone
+     */
+    value?: string;
+    /**
+     * Whether the choices behind it are showing, or the thing it turns on is on.
+     * @default false
+     */
+    active?: boolean;
+    /**
+     * Whether it cannot be pressed.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Why it cannot be pressed, which the pointer is told in place of the name.
+     * A greyed glyph that does not say why is the one thing worse than a glyph.
+     * @default undefined — the pointer is still told the name
+     */
+    disabledReason?: string;
+    /**
+     * Whether pressing it opens a menu. Its state is then announced as a menu
+     * that is open or shut rather than as a button that is pressed, which is
+     * what tells a screen reader there is more behind it.
+     * @default false
+     */
+    opensMenu?: boolean;
+    /**
+     * Called when it is pressed. Leave it out inside a popover, which listens on
+     * the wrapper it puts around the button and would otherwise be told twice.
+     * @default undefined — nothing of its own happens
+     */
+    onClick?: () => void;
+    /**
+     * Value of the `data-testid` attribute.
+     * @default undefined
+     */
+    testId?: string;
+}
+/**
+ * One setting reduced to its glyph.
+ *
+ * A bar of named controls over an embedded figure spends more of the picture
+ * on its own words than the figure spends on the data, so on the bar a setting
+ * is a glyph and its name is what the pointer and the screen reader are told.
+ * That trade is only honest while the name is always there, which is why the
+ * label is required rather than optional and why it carries the current value
+ * with it: an icon nobody can name is a control nobody presses.
+ * @param props - See {@link OverlayIconButtonProps}.
+ * @returns The button.
+ */
+export declare function OverlayIconButton(props: OverlayIconButtonProps): ReactElement;
+//# sourceMappingURL=OverlayIconButton.d.ts.map

package/lib/overlay/ui/OverlayIconButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayIconButton.d.ts","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayIconButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAM1C,4CAA4C;AAC5C,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;IAC9B;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CAqC7E"}