react-cheminfo 0.8.0 → 0.10.0

package/lib/orbital/ui/viewer.js.map

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

package/lib/overlay/core/emptiestCorner.d.ts

@@ -0,0 +1,47 @@
+import type { OverlayCorner } from './overlayPlacement.ts';
+/** What {@link emptiestCorner} has to know about the figure. */
+export interface EmptiestCornerOptions {
+    /** Width of the plot, in pixels. */
+    width: number;
+    /** Height of the plot, in pixels. */
+    height: number;
+    /**
+     * Width the card is expected to take. It is an estimate on purpose: the card
+     * has not been laid out when the corner is chosen.
+     * @default 210
+     */
+    cardWidth?: number;
+    /**
+     * Height the card is expected to take.
+     * @default 76
+     */
+    cardHeight?: number;
+    /**
+     * The corner kept when two are equally empty, which is the common case on a
+     * sparse plot. Keeping a preference is what stops the card hopping between
+     * corners as one point is added.
+     * @default 'top-right'
+     */
+    preferred?: OverlayCorner;
+}
+/**
+ * The corner of a plot with the fewest marks under it.
+ *
+ * A card in a fixed corner eventually sits on the one cluster the reader came
+ * for. Counting first costs four comparisons per point, once per relayout, and
+ * it is the difference between chrome and an obstruction.
+ *
+ * Ties are settled by a fixed order so the answer never depends on which mark
+ * was read first: the preferred corner, then the one diagonally across from it,
+ * then the remaining two clockwise from the top left. The diagonal comes second
+ * because the preferred corner only loses when it holds marks, and the far side
+ * of the plot is the least likely place for the rest of that same cluster.
+ * @param x - Horizontal position of every mark, in pixels from the plot's left.
+ * @param y - Vertical position of every mark, in pixels from the plot's top.
+ * @param options - See {@link EmptiestCornerOptions}.
+ * @returns The emptiest corner; the preferred one when several tie. An empty
+ * plot, or one whose size has not been measured, is entirely empty and so
+ * returns the preferred corner too.
+ */
+export declare function emptiestCorner(x: ArrayLike<number>, y: ArrayLike<number>, options: EmptiestCornerOptions): OverlayCorner;
+//# sourceMappingURL=emptiestCorner.d.ts.map

package/lib/overlay/core/emptiestCorner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emptiestCorner.d.ts","sourceRoot":"","sources":["../../../src/overlay/core/emptiestCorner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EACpB,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EACpB,OAAO,EAAE,qBAAqB,GAC7B,aAAa,CA4Cf"}

package/lib/overlay/core/emptiestCorner.js

@@ -0,0 +1,84 @@
+/**
+ * The corner of a plot with the fewest marks under it.
+ *
+ * A card in a fixed corner eventually sits on the one cluster the reader came
+ * for. Counting first costs four comparisons per point, once per relayout, and
+ * it is the difference between chrome and an obstruction.
+ *
+ * Ties are settled by a fixed order so the answer never depends on which mark
+ * was read first: the preferred corner, then the one diagonally across from it,
+ * then the remaining two clockwise from the top left. The diagonal comes second
+ * because the preferred corner only loses when it holds marks, and the far side
+ * of the plot is the least likely place for the rest of that same cluster.
+ * @param x - Horizontal position of every mark, in pixels from the plot's left.
+ * @param y - Vertical position of every mark, in pixels from the plot's top.
+ * @param options - See {@link EmptiestCornerOptions}.
+ * @returns The emptiest corner; the preferred one when several tie. An empty
+ * plot, or one whose size has not been measured, is entirely empty and so
+ * returns the preferred corner too.
+ */
+export function emptiestCorner(x, y, options) {
+    const { width, height, cardWidth = DEFAULT_CARD_WIDTH, cardHeight = DEFAULT_CARD_HEIGHT, preferred = 'top-right', } = options;
+    const leftEdge = cardWidth;
+    const rightEdge = width - cardWidth;
+    const topEdge = cardHeight;
+    const bottomEdge = height - cardHeight;
+    const counts = {
+        'top-left': 0,
+        'top-right': 0,
+        'bottom-left': 0,
+        'bottom-right': 0,
+    };
+    const total = Math.min(x.length, y.length);
+    for (let index = 0; index < total; index++) {
+        const pointX = x[index];
+        const pointY = y[index];
+        if (pointX === undefined || pointY === undefined)
+            continue;
+        const inLeft = pointX <= leftEdge;
+        const inRight = pointX >= rightEdge;
+        const inTop = pointY <= topEdge;
+        const inBottom = pointY >= bottomEdge;
+        if (inTop && inLeft)
+            counts['top-left']++;
+        if (inTop && inRight)
+            counts['top-right']++;
+        if (inBottom && inLeft)
+            counts['bottom-left']++;
+        if (inBottom && inRight)
+            counts['bottom-right']++;
+    }
+    let best = preferred;
+    let fewest = counts[preferred];
+    for (const corner of tieOrder(preferred)) {
+        if (counts[corner] >= fewest)
+            continue;
+        best = corner;
+        fewest = counts[corner];
+    }
+    return best;
+}
+const DEFAULT_CARD_WIDTH = 210;
+const DEFAULT_CARD_HEIGHT = 76;
+const CORNERS = [
+    'top-left',
+    'top-right',
+    'bottom-right',
+    'bottom-left',
+];
+const OPPOSITE = {
+    'top-left': 'bottom-right',
+    'top-right': 'bottom-left',
+    'bottom-left': 'top-right',
+    'bottom-right': 'top-left',
+};
+function tieOrder(preferred) {
+    const opposite = OPPOSITE[preferred];
+    const order = [opposite];
+    for (const corner of CORNERS) {
+        if (corner !== preferred && corner !== opposite)
+            order.push(corner);
+    }
+    return order;
+}
+//# sourceMappingURL=emptiestCorner.js.map

package/lib/overlay/core/emptiestCorner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emptiestCorner.js","sourceRoot":"","sources":["../../../src/overlay/core/emptiestCorner.ts"],"names":[],"mappings":"AA4BA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAC5B,CAAoB,EACpB,CAAoB,EACpB,OAA8B;IAE9B,MAAM,EACJ,KAAK,EACL,MAAM,EACN,SAAS,GAAG,kBAAkB,EAC9B,UAAU,GAAG,mBAAmB,EAChC,SAAS,GAAG,WAAW,GACxB,GAAG,OAAO,CAAC;IAEZ,MAAM,QAAQ,GAAG,SAAS,CAAC;IAC3B,MAAM,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC;IACpC,MAAM,OAAO,GAAG,UAAU,CAAC;IAC3B,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;IAEvC,MAAM,MAAM,GAAkC;QAC5C,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,CAAC;QAChB,cAAc,EAAE,CAAC;KAClB,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAC3C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;YAAE,SAAS;QAC3D,MAAM,MAAM,GAAG,MAAM,IAAI,QAAQ,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,IAAI,SAAS,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,IAAI,OAAO,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,UAAU,CAAC;QACtC,IAAI,KAAK,IAAI,MAAM;YAAE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,IAAI,KAAK,IAAI,OAAO;YAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5C,IAAI,QAAQ,IAAI,MAAM;YAAE,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAChD,IAAI,QAAQ,IAAI,OAAO;YAAE,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;IACpD,CAAC;IAED,IAAI,IAAI,GAAG,SAAS,CAAC;IACrB,IAAI,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM;YAAE,SAAS;QACvC,IAAI,GAAG,MAAM,CAAC;QACd,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,MAAM,OAAO,GAA6B;IACxC,UAAU;IACV,WAAW;IACX,cAAc;IACd,aAAa;CACd,CAAC;AAEF,MAAM,QAAQ,GAAyC;IACrD,UAAU,EAAE,cAAc;IAC1B,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,WAAW;IAC1B,cAAc,EAAE,UAAU;CAC3B,CAAC;AAEF,SAAS,QAAQ,CAAC,SAAwB;IACxC,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,KAAK,GAAoB,CAAC,QAAQ,CAAC,CAAC;IAC1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Where a floating control sits over a figure, and how big it is.
+ *
+ * The geometry lives apart from the components that use it so it can be
+ * reasoned about and tested without a browser: which corner of a scatter is
+ * emptiest, whether a panel has room for a labelled strip or only a gear, and
+ * where a card must flip so it stays on screen.
+ */
+export type { EmptiestCornerOptions } from './emptiestCorner.ts';
+export { emptiestCorner } from './emptiestCorner.ts';
+export { shouldCollapseOverlay } from './overlayCollapse.ts';
+export type { OverlayMarkShape } from './overlayMarks.ts';
+export { OVERLAY_MARK_SHAPES, isFilledMark } from './overlayMarks.ts';
+export type { OverlayDensity, OverlayMetrics, OverlayPointerKind, } from './overlayMetrics.ts';
+export { overlayMetrics } from './overlayMetrics.ts';
+export type { OverlayCorner, OverlayCornerStyle, OverlayPlacement, } from './overlayPlacement.ts';
+export { overlayCornerStyle } from './overlayPlacement.ts';
+export type { OverlayTierRoom, OverlayTierSetting } from './overlayTierRoom.ts';
+export type { OverlayTier, OverlayTierWidths } from './overlayTiers.ts';
+export { overlayTier, overlayTierWidths } from './overlayTiers.ts';
+export type { OverlayCardPlacement, OverlayCardPlacementOptions, } from './placeOverlayCard.ts';
+export { placeOverlayCard } from './placeOverlayCard.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/overlay/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EACV,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAChF,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EACV,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/overlay/core/index.js

@@ -0,0 +1,16 @@
+/**
+ * Where a floating control sits over a figure, and how big it is.
+ *
+ * The geometry lives apart from the components that use it so it can be
+ * reasoned about and tested without a browser: which corner of a scatter is
+ * emptiest, whether a panel has room for a labelled strip or only a gear, and
+ * where a card must flip so it stays on screen.
+ */
+export { emptiestCorner } from "./emptiestCorner.js";
+export { shouldCollapseOverlay } from "./overlayCollapse.js";
+export { OVERLAY_MARK_SHAPES, isFilledMark } from "./overlayMarks.js";
+export { overlayMetrics } from "./overlayMetrics.js";
+export { overlayCornerStyle } from "./overlayPlacement.js";
+export { overlayTier, overlayTierWidths } from "./overlayTiers.js";
+export { placeOverlayCard } from "./placeOverlayCard.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/overlay/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAKnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/overlay/core/overlayCollapse.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Whether a floating card folds into a single button at this figure width.
+ *
+ * A width of zero — which is what a figure reports before it has been measured,
+ * and what a server render always reports — keeps the card expanded, so the
+ * string-rendering tests and the first paint both see the real controls. A
+ * threshold that is not a real number is read the same way, so a missing
+ * breakpoint never silently hides every control on the figure.
+ * @param width - Width of the figure, in pixels.
+ * @param collapseBelow - The width under which the card folds.
+ * @returns Whether it folds.
+ */
+export declare function shouldCollapseOverlay(width: number, collapseBelow: number): boolean;
+//# sourceMappingURL=overlayCollapse.d.ts.map

package/lib/overlay/core/overlayCollapse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayCollapse.d.ts","sourceRoot":"","sources":["../../../src/overlay/core/overlayCollapse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,OAAO,CAIT"}

package/lib/overlay/core/overlayCollapse.js

@@ -0,0 +1,20 @@
+/**
+ * Whether a floating card folds into a single button at this figure width.
+ *
+ * A width of zero — which is what a figure reports before it has been measured,
+ * and what a server render always reports — keeps the card expanded, so the
+ * string-rendering tests and the first paint both see the real controls. A
+ * threshold that is not a real number is read the same way, so a missing
+ * breakpoint never silently hides every control on the figure.
+ * @param width - Width of the figure, in pixels.
+ * @param collapseBelow - The width under which the card folds.
+ * @returns Whether it folds.
+ */
+export function shouldCollapseOverlay(width, collapseBelow) {
+    if (!Number.isFinite(width) || width <= 0)
+        return false;
+    if (!Number.isFinite(collapseBelow))
+        return false;
+    return width < collapseBelow;
+}
+//# sourceMappingURL=overlayCollapse.js.map

package/lib/overlay/core/overlayCollapse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayCollapse.js","sourceRoot":"","sources":["../../../src/overlay/core/overlayCollapse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,aAAqB;IAErB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,KAAK,GAAG,aAAa,CAAC;AAC/B,CAAC"}

package/lib/overlay/core/overlayMarks.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The marks a legend entry, a reference point or a series can be drawn with.
+ *
+ * It lives in the framework-free half although only a component ever draws
+ * one, because the data that names a mark is written far from the drawing: a
+ * k-means centroid says it is a cross while it is still a plain object, long
+ * before any of it reaches React. Keeping the union here is what lets a result
+ * describe its own marks without a `core` module reaching into a `ui` one.
+ */
+/** Which mark a legend entry, a marker or a series stands for. */
+export type OverlayMarkShape = 'dot' | 'ring' | 'square' | 'line' | 'dashed' | 'cross';
+/**
+ * Every mark, in the order a picker offers them.
+ *
+ * The first three separate one filled thing from another by colour alone; the
+ * last three carry a second meaning on one figure — a line for a component
+ * beside dots for the samples — which is what keeps a figure readable when the
+ * colours run out or the reader does not separate two of them.
+ */
+export declare const OVERLAY_MARK_SHAPES: readonly OverlayMarkShape[];
+/**
+ * Whether a mark is drawn as a solid area rather than as a stroke.
+ *
+ * A solid mark takes its colour as a fill and a stroked one as a stroke, which
+ * is the one thing every renderer of a mark has to know and the one thing that
+ * is easy to get wrong in each of them separately.
+ * @param shape - The mark.
+ * @returns `true` for the filled marks, `false` for the drawn ones.
+ */
+export declare function isFilledMark(shape: OverlayMarkShape): boolean;
+//# sourceMappingURL=overlayMarks.d.ts.map

package/lib/overlay/core/overlayMarks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayMarks.d.ts","sourceRoot":"","sources":["../../../src/overlay/core/overlayMarks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GAC1B,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAO1D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAE7D"}

package/lib/overlay/core/overlayMarks.js

@@ -0,0 +1,38 @@
+/**
+ * The marks a legend entry, a reference point or a series can be drawn with.
+ *
+ * It lives in the framework-free half although only a component ever draws
+ * one, because the data that names a mark is written far from the drawing: a
+ * k-means centroid says it is a cross while it is still a plain object, long
+ * before any of it reaches React. Keeping the union here is what lets a result
+ * describe its own marks without a `core` module reaching into a `ui` one.
+ */
+/**
+ * Every mark, in the order a picker offers them.
+ *
+ * The first three separate one filled thing from another by colour alone; the
+ * last three carry a second meaning on one figure — a line for a component
+ * beside dots for the samples — which is what keeps a figure readable when the
+ * colours run out or the reader does not separate two of them.
+ */
+export const OVERLAY_MARK_SHAPES = [
+    'dot',
+    'ring',
+    'square',
+    'line',
+    'dashed',
+    'cross',
+];
+/**
+ * Whether a mark is drawn as a solid area rather than as a stroke.
+ *
+ * A solid mark takes its colour as a fill and a stroked one as a stroke, which
+ * is the one thing every renderer of a mark has to know and the one thing that
+ * is easy to get wrong in each of them separately.
+ * @param shape - The mark.
+ * @returns `true` for the filled marks, `false` for the drawn ones.
+ */
+export function isFilledMark(shape) {
+    return shape === 'dot' || shape === 'square';
+}
+//# sourceMappingURL=overlayMarks.js.map

package/lib/overlay/core/overlayMarks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayMarks.js","sourceRoot":"","sources":["../../../src/overlay/core/overlayMarks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAgC;IAC9D,KAAK;IACL,MAAM;IACN,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,OAAO;CACR,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,KAAuB;IAClD,OAAO,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,QAAQ,CAAC;AAC/C,CAAC"}

package/lib/overlay/core/overlayMetrics.d.ts

@@ -0,0 +1,41 @@
+/** How tightly a floating card packs its controls. */
+export type OverlayDensity = 'compact' | 'comfortable';
+/**
+ * What kind of pointer the reader has.
+ *
+ * A finger cannot hover and cannot aim at a twenty-four pixel target, so a
+ * coarse pointer overrides the density outright rather than nudging it.
+ */
+export type OverlayPointerKind = 'fine' | 'coarse';
+/** Every measurement a floating card and its controls are drawn from. */
+export interface OverlayMetrics {
+    /** Height of a control, in pixels. */
+    controlHeight: number;
+    /** Space between two controls, and between a caption and its control. */
+    gap: number;
+    /** Space inside the card, left and right. */
+    paddingX: number;
+    /** Space inside the card, top and bottom. */
+    paddingY: number;
+    /** Size of the text a control says. */
+    fontSize: number;
+    /** Size of the caption in front of a control. */
+    labelSize: number;
+    /** Corner radius of a control; the card itself uses `--radius`. */
+    controlRadius: number;
+    /** Space kept between the card and the edge of the figure. */
+    inset: number;
+    /** Side of the square button the card collapses to. */
+    buttonSize: number;
+    /** The size Blueprint's own controls are asked for. */
+    blueprintSize: 'small' | 'medium' | 'large';
+}
+/**
+ * The measurements a card is drawn from.
+ * @param density - How tightly the caller asked for the controls to be packed.
+ * @param pointer - What the reader is pointing with. Defaults to `'fine'`.
+ * @returns The measurements. A coarse pointer always gets the largest set,
+ * whatever the density says.
+ */
+export declare function overlayMetrics(density: OverlayDensity, pointer?: OverlayPointerKind): OverlayMetrics;
+//# sourceMappingURL=overlayMetrics.d.ts.map

package/lib/overlay/core/overlayMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayMetrics.d.ts","sourceRoot":"","sources":["../../../src/overlay/core/overlayMetrics.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,aAAa,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,kBAA2B,GACnC,cAAc,CAGhB"}

package/lib/overlay/core/overlayMetrics.js

@@ -0,0 +1,73 @@
+/**
+ * The measurements a card is drawn from.
+ * @param density - How tightly the caller asked for the controls to be packed.
+ * @param pointer - What the reader is pointing with. Defaults to `'fine'`.
+ * @returns The measurements. A coarse pointer always gets the largest set,
+ * whatever the density says.
+ */
+export function overlayMetrics(density, pointer = 'fine') {
+    if (pointer === 'coarse')
+        return COARSE_METRICS;
+    return density === 'compact' ? COMPACT_METRICS : COMFORTABLE_METRICS;
+}
+/**
+ * The set a figure embedded in somebody else's page is drawn from.
+ *
+ * A figure that is a guest on a page it does not own has to spend as little of
+ * that page as it can, so every measurement here is the smallest one that is
+ * still honest. The control stays at twenty-four pixels — the floor a mouse
+ * can be aimed at, and the reason nothing below it is offered at all — while
+ * the room around it goes: a four pixel gap, a three pixel band above and
+ * below, and a six pixel inset from the figure's edge. A bar built from these
+ * stands thirty pixels tall, which is one line of the host's own text.
+ *
+ * The type steps down a size with it. Eleven pixels is what a control says and
+ * ten is what its caption says, because the caption is read once to find the
+ * control and the control's own words are read every time it is used.
+ */
+const COMPACT_METRICS = {
+    controlHeight: 24,
+    gap: 4,
+    paddingX: 6,
+    paddingY: 3,
+    fontSize: 11,
+    labelSize: 10,
+    controlRadius: 5,
+    inset: 6,
+    buttonSize: 24,
+    blueprintSize: 'small',
+};
+/** The everyday set: room to read the captions without crowding the figure. */
+const COMFORTABLE_METRICS = {
+    controlHeight: 30,
+    gap: 8,
+    paddingX: 8,
+    paddingY: 6,
+    fontSize: 12,
+    labelSize: 11,
+    controlRadius: 6,
+    inset: 8,
+    buttonSize: 30,
+    blueprintSize: 'medium',
+};
+/**
+ * Forty pixels is the smallest target a fingertip hits reliably, and the type
+ * grows with it because a phone is held further from the eye than a screen.
+ *
+ * Nothing here follows the density down. A finger does not become smaller
+ * because the figure was embedded, so a compact chart on a phone is a compact
+ * chart whose controls are still forty pixels across.
+ */
+const COARSE_METRICS = {
+    controlHeight: 40,
+    gap: 10,
+    paddingX: 10,
+    paddingY: 8,
+    fontSize: 13,
+    labelSize: 12,
+    controlRadius: 8,
+    inset: 10,
+    buttonSize: 40,
+    blueprintSize: 'large',
+};
+//# sourceMappingURL=overlayMetrics.js.map

package/lib/overlay/core/overlayMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayMetrics.js","sourceRoot":"","sources":["../../../src/overlay/core/overlayMetrics.ts"],"names":[],"mappings":"AAmCA;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAuB,EACvB,UAA8B,MAAM;IAEpC,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,cAAc,CAAC;IAChD,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB,CAAC;AACvE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,eAAe,GAAmB;IACtC,aAAa,EAAE,EAAE;IACjB,GAAG,EAAE,CAAC;IACN,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,EAAE;IACb,aAAa,EAAE,CAAC;IAChB,KAAK,EAAE,CAAC;IACR,UAAU,EAAE,EAAE;IACd,aAAa,EAAE,OAAO;CACvB,CAAC;AAEF,+EAA+E;AAC/E,MAAM,mBAAmB,GAAmB;IAC1C,aAAa,EAAE,EAAE;IACjB,GAAG,EAAE,CAAC;IACN,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,EAAE;IACb,aAAa,EAAE,CAAC;IAChB,KAAK,EAAE,CAAC;IACR,UAAU,EAAE,EAAE;IACd,aAAa,EAAE,QAAQ;CACxB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,cAAc,GAAmB;IACrC,aAAa,EAAE,EAAE;IACjB,GAAG,EAAE,EAAE;IACP,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,EAAE;IACb,aAAa,EAAE,CAAC;IAChB,KAAK,EAAE,EAAE;IACT,UAAU,EAAE,EAAE;IACd,aAAa,EAAE,OAAO;CACvB,CAAC"}

package/lib/overlay/core/overlayPlacement.d.ts

@@ -0,0 +1,60 @@
+/** Which corner of a figure a floating card sits in. */
+export type OverlayCorner = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+/**
+ * Where a floating card sits: over one of the figure's corners, or docked
+ * outside the picture entirely.
+ *
+ * The three docked forms are the escape hatch for a figure whose data reaches
+ * all four corners. A chart that cannot spare a corner should move its
+ * controls out rather than cover the one cluster the reader came for.
+ *
+ * `stretch` is the one that spans the whole width rather than sitting at one
+ * end of the row: the settings bar of a figure embedded in somebody else's
+ * page, which is chrome above the picture and not a card floating on it. It is
+ * deliberately not offered as a floating placement — a full-width strip over a
+ * figure covers the very data it is there to explain.
+ */
+export type OverlayPlacement = OverlayCorner | 'above' | 'below' | 'stretch';
+/**
+ * The offsets a placement gives a card.
+ *
+ * Written out as a plain object of numbers rather than borrowed from React, so
+ * the whole of this entry point stays free of the framework that eventually
+ * spreads it onto a `style` prop. Only the two edges a corner is actually
+ * measured from are present: a key carrying `undefined` would still win over
+ * an offset the caller had merged in underneath it.
+ */
+export interface OverlayCornerStyle {
+    /** Whether the card is lifted out of the flow, or left in it and docked. */
+    position: 'absolute' | 'static';
+    /**
+     * Distance from the figure's top edge, in pixels.
+     * @default undefined — absent unless the card sits in a top corner
+     */
+    top?: number;
+    /**
+     * Distance from the figure's right edge, in pixels.
+     * @default undefined — absent unless the card sits in a right corner
+     */
+    right?: number;
+    /**
+     * Distance from the figure's bottom edge, in pixels.
+     * @default undefined — absent unless the card sits in a bottom corner
+     */
+    bottom?: number;
+    /**
+     * Distance from the figure's left edge, in pixels.
+     * @default undefined — absent unless the card sits in a left corner
+     */
+    left?: number;
+}
+/**
+ * The positioning a placement gives a card.
+ * @param placement - Where the card sits.
+ * @param inset - Distance kept between the card and the figure's edge, in pixels.
+ * @returns The style to spread onto the card. Every docked placement returns
+ * `position: 'static'`, so the same component lays out in the flow without a
+ * second code path.
+ */
+export declare function overlayCornerStyle(placement: OverlayPlacement, inset: number): OverlayCornerStyle;
+//# sourceMappingURL=overlayPlacement.d.ts.map

package/lib/overlay/core/overlayPlacement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayPlacement.d.ts","sourceRoot":"","sources":["../../../src/overlay/core/overlayPlacement.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,MAAM,aAAa,GACvB,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7E;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,QAAQ,EAAE,UAAU,GAAG,QAAQ,CAAC;IAChC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,MAAM,GACZ,kBAAkB,CAcpB"}

package/lib/overlay/core/overlayPlacement.js

@@ -0,0 +1,24 @@
+/**
+ * The positioning a placement gives a card.
+ * @param placement - Where the card sits.
+ * @param inset - Distance kept between the card and the figure's edge, in pixels.
+ * @returns The style to spread onto the card. Every docked placement returns
+ * `position: 'static'`, so the same component lays out in the flow without a
+ * second code path.
+ */
+export function overlayCornerStyle(placement, inset) {
+    if (placement === 'top-left') {
+        return { position: 'absolute', top: inset, left: inset };
+    }
+    if (placement === 'top-right') {
+        return { position: 'absolute', top: inset, right: inset };
+    }
+    if (placement === 'bottom-left') {
+        return { position: 'absolute', bottom: inset, left: inset };
+    }
+    if (placement === 'bottom-right') {
+        return { position: 'absolute', bottom: inset, right: inset };
+    }
+    return { position: 'static' };
+}
+//# sourceMappingURL=overlayPlacement.js.map

package/lib/overlay/core/overlayPlacement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayPlacement.js","sourceRoot":"","sources":["../../../src/overlay/core/overlayPlacement.ts"],"names":[],"mappings":"AAsDA;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAA2B,EAC3B,KAAa;IAEb,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;QAC9B,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;QAChC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC9D,CAAC;IACD,IAAI,SAAS,KAAK,cAAc,EAAE,CAAC;QACjC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC"}

package/lib/overlay/core/overlayTierRoom.d.ts

@@ -0,0 +1,89 @@
+/**
+ * What a bar of controls is holding, and how much room each part of it needs.
+ *
+ * Every width here is an estimate of laid-out type rather than a measurement.
+ * Measuring the real labels would mean putting them in the document and
+ * reading their boxes back, which costs a layout pass on every render of every
+ * embedded figure on the page — and the answer would still arrive one frame
+ * after the width that prompted it. The estimate is deliberately generous: a
+ * bar that folds a word early costs the reader a caret, while one that folds
+ * late runs its controls off the edge of the figure.
+ *
+ * The geometry is restated here rather than read off the styles that draw it,
+ * because those styles are React's and this has to answer on a server, before
+ * anything exists to measure. Being an estimate is the point — it is allowed
+ * to be a few pixels out, and it is not allowed to need a browser.
+ */
+import type { OverlayMetrics } from './overlayMetrics.ts';
+/** One setting at the far end of a bar, for the room needed to write it. */
+export interface OverlayTierSetting {
+    /**
+     * The word written in front of the value where there is room — `Outlines`,
+     * `Colour`. It is the first thing dropped, because the name of a setting is
+     * read once and its value is read every time.
+     */
+    key: string;
+    /** What the setting currently reads: `Species`, `95%`. */
+    value: string;
+    /**
+     * Whether a row of the figure's own colours rides in front of the words.
+     * @default false
+     */
+    swatches?: boolean;
+}
+/** What a bar is holding, for the widths it needs to hold it. */
+export interface OverlayTierRoom {
+    /** What each tab reads. Empty for a figure with a single view. */
+    tabs: readonly string[];
+    /**
+     * The short form of each tab, in the same order — `Explains` for `How much
+     * each explains`. A tab with no short form keeps its long one, so shortening
+     * the two labels that are long does not blank the two that are not.
+     * @default the tabs themselves, which shortens nothing
+     */
+    shortTabs?: readonly string[];
+    /** The settings at the far end, in the order they are written. */
+    settings: readonly OverlayTierSetting[];
+    /**
+     * How many bare glyphs ride at the end: the `?` and the cog.
+     * @default 2
+     */
+    glyphs?: number;
+}
+/**
+ * The tab strip, sunken track and all.
+ * @param labels - What each tab reads.
+ * @param metrics - The measurements the bar is drawn from.
+ * @returns The width in pixels; `0` where there is no strip at all.
+ */
+export declare function overlayStripWidth(labels: readonly string[], metrics: OverlayMetrics): number;
+/**
+ * The settings, each written as a value button of its own.
+ * @param settings - What the bar holds at its far end.
+ * @param withKeys - Whether each value still carries its key word.
+ * @param metrics - The measurements the bar is drawn from.
+ * @returns The width in pixels, the gaps between the buttons included.
+ */
+export declare function overlaySettingsWidth(settings: readonly OverlayTierSetting[], withKeys: boolean, metrics: OverlayMetrics): number;
+/**
+ * Every setting gathered into one chip.
+ *
+ * What the chip saves is one button's worth of padding and one caret per
+ * setting it swallows — never the words themselves, which are the whole reason
+ * the reader is given a chip rather than a cog.
+ * @param settings - What the bar holds at its far end.
+ * @param metrics - The measurements the bar is drawn from.
+ * @returns The width in pixels.
+ */
+export declare function overlayChipRoom(settings: readonly OverlayTierSetting[], metrics: OverlayMetrics): number;
+/**
+ * The bare glyphs at the very end of the bar, with the bar's own padding.
+ *
+ * One extra gap is counted for the space between the two ends of the row,
+ * which is what a bar spanning the figure pushes its ends apart with.
+ * @param glyphs - How many bare glyphs ride at the end.
+ * @param metrics - The measurements the bar is drawn from.
+ * @returns The width in pixels.
+ */
+export declare function overlayTailWidth(glyphs: number, metrics: OverlayMetrics): number;
+//# sourceMappingURL=overlayTierRoom.d.ts.map