react-cheminfo 0.8.0 → 0.10.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayBar.js","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayBar.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAIjC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AA2GxD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IACnD,MAAM,EAAE,SAAS,GAAG,WAAW,EAAE,GAAG,KAAK,CAAC;IAC1C,MAAM,EAAE,KAAK,GAAG,SAAS,EAAE,cAAc,GAAG,uBAAuB,EAAE,GAAG,KAAK,CAAC;IAC9E,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,KAAK,EAAE,iBAAiB,EAAE,GAAG,KAAK,CAAC;IACzE,MAAM,EAAE,aAAa,GAAG,GAAG,EAAE,QAAQ,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAChE,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACpC,MAAM,EAAE,KAAK,EAAE,GAAG,iBAAiB,EAAE,CAAC;IACtC,MAAM,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAEnD,MAAM,MAAM,GAAG,gBAAgB,CAAC;QAC9B,SAAS;QACT,aAAa;QACb,KAAK;QACL,aAAa;KACd,CAAC,CAAC;IACH,aAAa,CACX,MAAM,EACN,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CACxD,CAAC;IAEF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,CACL,KAAC,eAAe,IACd,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,YAEb,QAAQ,GACO,CACnB,CAAC;IACJ,CAAC;IAED,OAAO,CACL,KAAC,cAAc,IACb,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,MAAM,YAEb,QAAQ,GACM,CAClB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,38 @@
+import type { IconName } from '@blueprintjs/core';
+import type { ReactElement, ReactNode } from 'react';
+import type { OverlayPlacement } from '../core/overlayPlacement.ts';
+/** What {@link OverlayBarButton} opens. */
+export interface OverlayBarButtonProps {
+    /**
+     * The controls it holds: whatever has folded away, then the second tier —
+     * everything an expert changes and a reader never does.
+     */
+    children: ReactNode;
+    /** Where the bar sits, which is what decides the way the panel opens. */
+    placement: OverlayPlacement;
+    /** What the button is called, for the pointer and for a screen reader. */
+    label: string;
+    /** Its glyph. */
+    icon: IconName;
+    /**
+     * Whether the panel is drawn with the card's own padding around it. Turn it
+     * off for an {@link OverlayPanel}, which brings its own: nested inside a
+     * padded surface a panel's header rule stops short of both edges and reads
+     * as a mis-drawn line rather than as a header.
+     * @default true
+     */
+    padded?: boolean;
+}
+/**
+ * The button at the end of a bar, and the panel behind it.
+ *
+ * Both shapes of bar draw this one, so a reader who has opened the controls of
+ * a floating card knows where the controls of an embedded figure are. It is
+ * the domain's own icon button rather than a general one, which is what keeps
+ * it the same weight of ink as the glyph beside it and lets it say, while the
+ * panel is open, that it is the thing holding the panel open.
+ * @param props - See {@link OverlayBarButtonProps}.
+ * @returns The button and its panel.
+ */
+export declare function OverlayBarButton(props: OverlayBarButtonProps): ReactElement;
+//# sourceMappingURL=OverlayBarButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayBarButton.d.ts","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayBarButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAwB,MAAM,mBAAmB,CAAC;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAMpE,2CAA2C;AAC3C,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB,yEAAyE;IACzE,SAAS,EAAE,gBAAgB,CAAC;IAC5B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,YAAY,CAoB3E"}

package/lib/overlay/ui/OverlayBarButton.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { PopoverNext } from '@blueprintjs/core';
+import { useState } from 'react';
+import { OverlayIconButton } from "./OverlayIconButton.js";
+import { overlayPanelStyle } from "./overlayStyles.js";
+import { useOverlaySurface } from "./overlaySurface.js";
+/**
+ * The button at the end of a bar, and the panel behind it.
+ *
+ * Both shapes of bar draw this one, so a reader who has opened the controls of
+ * a floating card knows where the controls of an embedded figure are. It is
+ * the domain's own icon button rather than a general one, which is what keeps
+ * it the same weight of ink as the glyph beside it and lets it say, while the
+ * panel is open, that it is the thing holding the panel open.
+ * @param props - See {@link OverlayBarButtonProps}.
+ * @returns The button and its panel.
+ */
+export function OverlayBarButton(props) {
+    const { children, placement, label, icon, padded = true } = props;
+    const { metrics } = useOverlaySurface();
+    const [open, setOpen] = useState(false);
+    return (_jsx(PopoverNext, { placement: POPOVER_PLACEMENTS[placement], onInteraction: (next) => setOpen(next), content: padded ? (_jsx("div", { style: overlayPanelStyle(metrics), children: children })) : (_jsx(_Fragment, { children: children })), children: _jsx(OverlayIconButton, { icon: icon, label: label, active: open, opensMenu: true }) }));
+}
+/**
+ * Which way the panel opens, per placement.
+ *
+ * Away from the nearest edge in both axes, so the panel that opens is never
+ * the thing that pushes the reader's attention off the figure. A docked bar
+ * opens over the figure, which is the only direction it has.
+ */
+const POPOVER_PLACEMENTS = {
+    'top-left': 'bottom-start',
+    'top-right': 'bottom-end',
+    'bottom-left': 'top-start',
+    'bottom-right': 'top-end',
+    above: 'bottom-end',
+    below: 'top-end',
+    stretch: 'bottom-end',
+};
+//# sourceMappingURL=OverlayBarButton.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayBarButton.js","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayBarButton.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAIjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAyBxD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAClE,MAAM,EAAE,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAAC;IACxC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAExC,OAAO,CACL,KAAC,WAAW,IACV,SAAS,EAAE,kBAAkB,CAAC,SAAS,CAAC,EACxC,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EACtC,OAAO,EACL,MAAM,CAAC,CAAC,CAAC,CACP,cAAK,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,YAAG,QAAQ,GAAO,CACzD,CAAC,CAAC,CAAC,CACF,4BAAG,QAAQ,GAAI,CAChB,YAGH,KAAC,iBAAiB,IAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,SAAG,GAC3D,CACf,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,kBAAkB,GAAmD;IACzE,UAAU,EAAE,cAAc;IAC1B,WAAW,EAAE,YAAY;IACzB,aAAa,EAAE,WAAW;IAC1B,cAAc,EAAE,SAAS;IACzB,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,YAAY;CACtB,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { ReactElement } from 'react';
+import type { OverlayBarShapeProps } from './overlayBarShape.ts';
+/** What {@link OverlayBarCard} needs on top of the shape both bars share. */
+export interface OverlayBarCardProps extends OverlayBarShapeProps {
+    /** How opaque the ground is while nothing is pointing at the figure. */
+    restingOpacity: number;
+}
+/**
+ * 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 declare function OverlayBarCard(props: OverlayBarCardProps): ReactElement;
+//# sourceMappingURL=OverlayBarCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayBarCard.d.ts","sourceRoot":"","sources":["../../../src/overlay/ui/OverlayBarCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AASjE,6EAA6E;AAC7E,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,wEAAwE;IACxE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CA2CvE"}

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":"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"}

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"}