react-cheminfo 0.10.0 → 0.12.0

package/lib/scatter3d/ui/cloudGeometry.js.map

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

package/lib/scatter3d/ui/cloudShellStyles.d.ts

@@ -0,0 +1,34 @@
+/**
+ * How solid the glass is, and how it thickens from the middle to the rim.
+ */
+/**
+ * How solid one wall of the glass is, seen square on, by default.
+ *
+ * Low, because a ray straight through a shell already meets two walls, and two
+ * shells that overlap put four in the reader's way.
+ */
+export declare const SHELL_FILL_OPACITY = 0.1;
+/** One stop of the glass gradient. */
+export interface ShellGlassStop {
+    /** How far out it sits, from `0` at the middle to `1` at the rim. */
+    offset: number;
+    /** How solid the glass is there. */
+    opacity: number;
+}
+/**
+ * The gradient one shell is filled with, which is what gives it its relief.
+ *
+ * A shell is a surface, not a filled solid, so what the reader looks through
+ * is two walls of it. Straight through the middle they are met square on and
+ * the glass is at its thinnest; towards the rim the same two walls are met at
+ * a closing angle and the path through them lengthens as the secant of it, so
+ * the shell swells towards its edge and reads as round.
+ *
+ * The walls are composited rather than added, so two of them at a tenth are
+ * not a fifth but a nineteenth-something — the arithmetic a browser applies
+ * when it lays one translucent layer over another.
+ * @param strength - How solid one wall is, after the group's own opacity.
+ * @returns The stops, from the middle outwards.
+ */
+export declare function shellGlassStops(strength: number): ShellGlassStop[];
+//# sourceMappingURL=cloudShellStyles.d.ts.map

package/lib/scatter3d/ui/cloudShellStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudShellStyles.d.ts","sourceRoot":"","sources":["../../../src/scatter3d/ui/cloudShellStyles.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAYtC,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAQlE"}

package/lib/scatter3d/ui/cloudShellStyles.js

@@ -0,0 +1,61 @@
+/**
+ * How solid the glass is, and how it thickens from the middle to the rim.
+ */
+/**
+ * How solid one wall of the glass is, seen square on, by default.
+ *
+ * Low, because a ray straight through a shell already meets two walls, and two
+ * shells that overlap put four in the reader's way.
+ */
+export const SHELL_FILL_OPACITY = 0.1;
+/**
+ * How many walls' worth of glass the rim is allowed to reach.
+ *
+ * The path through a shell grows as the secant of the angle it is seen at, so
+ * at the silhouette it is unbounded and the rim would go opaque. Held to a few
+ * walls it reads as the swell of a ball; unheld it reads as a ring drawn round
+ * a disc.
+ */
+const RIM_WALLS = 6;
+/**
+ * The gradient one shell is filled with, which is what gives it its relief.
+ *
+ * A shell is a surface, not a filled solid, so what the reader looks through
+ * is two walls of it. Straight through the middle they are met square on and
+ * the glass is at its thinnest; towards the rim the same two walls are met at
+ * a closing angle and the path through them lengthens as the secant of it, so
+ * the shell swells towards its edge and reads as round.
+ *
+ * The walls are composited rather than added, so two of them at a tenth are
+ * not a fifth but a nineteenth-something — the arithmetic a browser applies
+ * when it lays one translucent layer over another.
+ * @param strength - How solid one wall is, after the group's own opacity.
+ * @returns The stops, from the middle outwards.
+ */
+export function shellGlassStops(strength) {
+    const wall = Math.min(1, Math.max(0, strength));
+    const clear = 1 - wall;
+    const stops = [];
+    for (const offset of GLASS_OFFSETS) {
+        stops.push({ offset, opacity: round(1 - clear ** wallsAt(offset)) });
+    }
+    return stops;
+}
+/**
+ * How much glass a ray meets at a given distance out from the middle.
+ * @param offset - How far out, from `0` at the middle to `1` at the rim.
+ * @returns The number of walls' worth, held to {@link RIM_WALLS}.
+ */
+function wallsAt(offset) {
+    const facing = Math.sqrt(Math.max(0, 1 - offset * offset));
+    if (facing <= 0)
+        return RIM_WALLS;
+    return Math.min(RIM_WALLS, 2 / facing);
+}
+/*
+ * Close together near the rim, where the glass thickens quickest, and sparse
+ * through the middle, where it barely changes.
+ */
+const GLASS_OFFSETS = [0, 0.3, 0.5, 0.66, 0.78, 0.87, 0.93, 0.97, 1];
+const round = (value) => Math.round(value * 10000) / 10000;
+//# sourceMappingURL=cloudShellStyles.js.map

package/lib/scatter3d/ui/cloudShellStyles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudShellStyles.js","sourceRoot":"","sources":["../../../src/scatter3d/ui/cloudShellStyles.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,SAAS,GAAG,CAAC,CAAC;AAUpB;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC;IACvB,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAS,OAAO,CAAC,MAAc;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAC3D,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,aAAa,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAErE,MAAM,KAAK,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC"}

package/lib/scatter3d/ui/cloudZoom.d.ts

@@ -0,0 +1,21 @@
+/**
+ * How far the reader may stand back from the box, and how near they may get.
+ *
+ * A cloud without a zoom cannot be read where its groups overlap, which on a
+ * projection is exactly where the reader is looking. The range is kept modest
+ * at both ends: past four the frame is off the picture and there is nothing
+ * left to say which way is which, and below four tenths the cloud is a smudge
+ * in the middle of an empty box.
+ */
+/** How far the wheel may zoom out and in. */
+export declare const CLOUD_ZOOM_RANGE: {
+    readonly min: 0.4;
+    readonly max: 4;
+};
+/**
+ * A zoom held inside what the box can usefully be seen at.
+ * @param zoom - The zoom asked for.
+ * @returns The zoom to draw at; `1` for anything that is not a number.
+ */
+export declare function clampCloudZoom(zoom: number): number;
+//# sourceMappingURL=cloudZoom.d.ts.map

package/lib/scatter3d/ui/cloudZoom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudZoom.d.ts","sourceRoot":"","sources":["../../../src/scatter3d/ui/cloudZoom.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB;;;CAAgC,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/lib/scatter3d/ui/cloudZoom.js

@@ -0,0 +1,21 @@
+import { clamp } from "../../format/core/clamp.js";
+/**
+ * How far the reader may stand back from the box, and how near they may get.
+ *
+ * A cloud without a zoom cannot be read where its groups overlap, which on a
+ * projection is exactly where the reader is looking. The range is kept modest
+ * at both ends: past four the frame is off the picture and there is nothing
+ * left to say which way is which, and below four tenths the cloud is a smudge
+ * in the middle of an empty box.
+ */
+/** How far the wheel may zoom out and in. */
+export const CLOUD_ZOOM_RANGE = { min: 0.4, max: 4 };
+/**
+ * A zoom held inside what the box can usefully be seen at.
+ * @param zoom - The zoom asked for.
+ * @returns The zoom to draw at; `1` for anything that is not a number.
+ */
+export function clampCloudZoom(zoom) {
+    return clamp(zoom, CLOUD_ZOOM_RANGE.min, CLOUD_ZOOM_RANGE.max, 1);
+}
+//# sourceMappingURL=cloudZoom.js.map

package/lib/scatter3d/ui/cloudZoom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudZoom.js","sourceRoot":"","sources":["../../../src/scatter3d/ui/cloudZoom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAEnD;;;;;;;;GAQG;AAEH,6CAA6C;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAW,CAAC;AAE9D;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,KAAK,CAAC,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACpE,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * A cloud of samples in a box the reader can turn.
+ *
+ * It is the `scatter` domain's twin, and deliberately so: the same selection,
+ * the same lasso, the same hover card, the same labels and the same group
+ * colours, so that a reader who has learned the map has learned this too. What
+ * is new is everything the third axis forces — a box to say which way is up, a
+ * drag that turns it, glass shells instead of outlines, and one scale across
+ * all three axes, because a solid seen from an angle has nowhere to write
+ * three sets of tick labels.
+ */
+export type { CloudFrameLayerProps } from './CloudFrameLayer.tsx';
+export { CloudFrameLayer } from './CloudFrameLayer.tsx';
+export type { CloudShell, CloudShellLayerProps } from './CloudShellLayer.tsx';
+export { CloudShellLayer } from './CloudShellLayer.tsx';
+export type { CloudCloud, CloudOutline, CloudSegment, CloudView, } from './cloudGeometry.ts';
+export { CLOUD_FILL, CLOUD_MARGIN, cloudView, projectCloud, projectSegments, projectShellOutline, } from './cloudGeometry.ts';
+export type { ShellGlassStop } from './cloudShellStyles.ts';
+export { SHELL_FILL_OPACITY, shellGlassStops } from './cloudShellStyles.ts';
+export { CLOUD_ZOOM_RANGE, clampCloudZoom } from './cloudZoom.ts';
+export type { CloudShellsInput } from './scatterCloudModel.ts';
+export { cloudLabel, cloudShells } from './scatterCloudModel.ts';
+export type { ScatterCloudProps } from './scatterCloudProps.ts';
+export { ScatterCloud } from './ScatterCloud.tsx';
+export type { OrbitDrag, OrbitDragOptions } from './useOrbitDrag.ts';
+export { useOrbitDrag } from './useOrbitDrag.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scatter3d/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,SAAS,GACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,eAAe,EACf,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/scatter3d/ui/index.js

@@ -0,0 +1,20 @@
+/**
+ * A cloud of samples in a box the reader can turn.
+ *
+ * It is the `scatter` domain's twin, and deliberately so: the same selection,
+ * the same lasso, the same hover card, the same labels and the same group
+ * colours, so that a reader who has learned the map has learned this too. What
+ * is new is everything the third axis forces — a box to say which way is up, a
+ * drag that turns it, glass shells instead of outlines, and one scale across
+ * all three axes, because a solid seen from an angle has nowhere to write
+ * three sets of tick labels.
+ */
+export { CloudFrameLayer } from "./CloudFrameLayer.js";
+export { CloudShellLayer } from "./CloudShellLayer.js";
+export { CLOUD_FILL, CLOUD_MARGIN, cloudView, projectCloud, projectSegments, projectShellOutline, } from "./cloudGeometry.js";
+export { SHELL_FILL_OPACITY, shellGlassStops } from "./cloudShellStyles.js";
+export { CLOUD_ZOOM_RANGE, clampCloudZoom } from "./cloudZoom.js";
+export { cloudLabel, cloudShells } from "./scatterCloudModel.js";
+export { ScatterCloud } from "./ScatterCloud.js";
+export { useOrbitDrag } from "./useOrbitDrag.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scatter3d/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAuB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAuB,CAAC;AAOxD,OAAO,EACL,UAAU,EACV,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,eAAe,EACf,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAoB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/scatter3d/ui/orbitDragTrack.d.ts

@@ -0,0 +1,83 @@
+/**
+ * What a drag over a cloud has done so far.
+ *
+ * Kept out of `useOrbitDrag` the way `lassoGesture` is kept out of the lasso:
+ * how far the pointer has travelled, which turn is waiting for the next frame
+ * and whether a release was a tap are questions with one answer each, and none
+ * of them needs React to be read or checked.
+ */
+/**
+ * How far a press may travel and still be a tap, in pixels of total travel.
+ *
+ * Generous on purpose: a mouse moves a pixel or two under the click of its own
+ * button, and a finger moves rather more, so a stricter number turns "pick
+ * this sample" into "turn the box by nothing at all" for anybody whose hand is
+ * not steady.
+ */
+export declare const ORBIT_TAP_SLACK = 5;
+/** What the pointer has done since the last frame, waiting for the next. */
+export interface PendingTurn {
+    /** Where it is, for a move that is not turning anything. */
+    x: number;
+    /** Where it is. */
+    y: number;
+    /** How far it has moved across since the last frame. */
+    dx: number;
+    /** How far it has moved down. */
+    dy: number;
+}
+/** A drag followed from its press: where the pointer was, and how far it went. */
+export interface OrbitDragTrack {
+    /** Where the pointer was on the last event, in window pixels. */
+    lastX: number;
+    /** Where it was vertically. */
+    lastY: number;
+    /** How far it has travelled since the press: every move's `|dx| + |dy|`. */
+    travel: number;
+    /** What waits for the next frame, or `null` when nothing does. */
+    pending: PendingTurn | null;
+}
+/**
+ * A track with no press behind it.
+ * @returns The track, to be held for the life of the surface.
+ */
+export declare function createOrbitDragTrack(): OrbitDragTrack;
+/**
+ * Start following a press.
+ * @param track - The track, changed in place.
+ * @param clientX - Where the press happened, in the window.
+ * @param clientY - Where it happened vertically.
+ */
+export declare function pressOrbitDrag(track: OrbitDragTrack, clientX: number, clientY: number): void;
+/**
+ * Remember where a pointer that turns nothing has moved to.
+ * @param track - The track, changed in place.
+ * @param x - Where the pointer is on the surface.
+ * @param y - Where it is vertically.
+ */
+export declare function hoverOrbitDrag(track: OrbitDragTrack, x: number, y: number): void;
+/**
+ * Follow a move of the claimed pointer.
+ *
+ * The travel is counted whether or not the drag may turn the box, so a press
+ * that wandered is still not a tap when turning is off.
+ * @param track - The track, changed in place.
+ * @param clientX - Where the pointer is now, in the window.
+ * @param clientY - Where it is vertically.
+ * @param enabled - Whether the drag turns the box at all.
+ * @returns Whether a frame has to be booked for the turn now waiting.
+ */
+export declare function followOrbitDrag(track: OrbitDragTrack, clientX: number, clientY: number, enabled: boolean): boolean;
+/**
+ * Take what was waiting for the frame, leaving nothing behind.
+ * @param track - The track, changed in place.
+ * @returns The waiting turn or move, or `null` when there was none.
+ */
+export declare function takePendingTurn(track: OrbitDragTrack): PendingTurn | null;
+/**
+ * Whether the press being released went nowhere worth calling a turn.
+ * @param track - The track.
+ * @returns `true` when the travel is within {@link ORBIT_TAP_SLACK}.
+ */
+export declare function isOrbitTap(track: OrbitDragTrack): boolean;
+//# sourceMappingURL=orbitDragTrack.d.ts.map

package/lib/scatter3d/ui/orbitDragTrack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orbitDragTrack.d.ts","sourceRoot":"","sources":["../../../src/scatter3d/ui/orbitDragTrack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,CAAC,EAAE,MAAM,CAAC;IACV,mBAAmB;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,IAAI,CAIN;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,EACrB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,IAAI,CAEN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,GACf,OAAO,CAeT;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,GAAG,IAAI,CAIzE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAEzD"}

package/lib/scatter3d/ui/orbitDragTrack.js

@@ -0,0 +1,91 @@
+/**
+ * What a drag over a cloud has done so far.
+ *
+ * Kept out of `useOrbitDrag` the way `lassoGesture` is kept out of the lasso:
+ * how far the pointer has travelled, which turn is waiting for the next frame
+ * and whether a release was a tap are questions with one answer each, and none
+ * of them needs React to be read or checked.
+ */
+/**
+ * How far a press may travel and still be a tap, in pixels of total travel.
+ *
+ * Generous on purpose: a mouse moves a pixel or two under the click of its own
+ * button, and a finger moves rather more, so a stricter number turns "pick
+ * this sample" into "turn the box by nothing at all" for anybody whose hand is
+ * not steady.
+ */
+export const ORBIT_TAP_SLACK = 5;
+/**
+ * A track with no press behind it.
+ * @returns The track, to be held for the life of the surface.
+ */
+export function createOrbitDragTrack() {
+    return { lastX: 0, lastY: 0, travel: 0, pending: null };
+}
+/**
+ * Start following a press.
+ * @param track - The track, changed in place.
+ * @param clientX - Where the press happened, in the window.
+ * @param clientY - Where it happened vertically.
+ */
+export function pressOrbitDrag(track, clientX, clientY) {
+    track.lastX = clientX;
+    track.lastY = clientY;
+    track.travel = 0;
+}
+/**
+ * Remember where a pointer that turns nothing has moved to.
+ * @param track - The track, changed in place.
+ * @param x - Where the pointer is on the surface.
+ * @param y - Where it is vertically.
+ */
+export function hoverOrbitDrag(track, x, y) {
+    track.pending = { x, y, dx: 0, dy: 0 };
+}
+/**
+ * Follow a move of the claimed pointer.
+ *
+ * The travel is counted whether or not the drag may turn the box, so a press
+ * that wandered is still not a tap when turning is off.
+ * @param track - The track, changed in place.
+ * @param clientX - Where the pointer is now, in the window.
+ * @param clientY - Where it is vertically.
+ * @param enabled - Whether the drag turns the box at all.
+ * @returns Whether a frame has to be booked for the turn now waiting.
+ */
+export function followOrbitDrag(track, clientX, clientY, enabled) {
+    const dx = clientX - track.lastX;
+    const dy = clientY - track.lastY;
+    track.lastX = clientX;
+    track.lastY = clientY;
+    track.travel += Math.abs(dx) + Math.abs(dy);
+    if (!enabled)
+        return false;
+    const waiting = track.pending;
+    track.pending = {
+        x: 0,
+        y: 0,
+        dx: (waiting?.dx ?? 0) + dx,
+        dy: (waiting?.dy ?? 0) + dy,
+    };
+    return true;
+}
+/**
+ * Take what was waiting for the frame, leaving nothing behind.
+ * @param track - The track, changed in place.
+ * @returns The waiting turn or move, or `null` when there was none.
+ */
+export function takePendingTurn(track) {
+    const next = track.pending;
+    track.pending = null;
+    return next;
+}
+/**
+ * Whether the press being released went nowhere worth calling a turn.
+ * @param track - The track.
+ * @returns `true` when the travel is within {@link ORBIT_TAP_SLACK}.
+ */
+export function isOrbitTap(track) {
+    return track.travel <= ORBIT_TAP_SLACK;
+}
+//# sourceMappingURL=orbitDragTrack.js.map

package/lib/scatter3d/ui/orbitDragTrack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orbitDragTrack.js","sourceRoot":"","sources":["../../../src/scatter3d/ui/orbitDragTrack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AA0BjC;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAqB,EACrB,OAAe,EACf,OAAe;IAEf,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC;IACtB,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC;IACtB,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAqB,EACrB,CAAS,EACT,CAAS;IAET,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;AACzC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAqB,EACrB,OAAe,EACf,OAAe,EACf,OAAgB;IAEhB,MAAM,EAAE,GAAG,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC;IACjC,MAAM,EAAE,GAAG,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC;IACjC,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC;IACtB,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC;IACtB,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,KAAK,CAAC,OAAO,GAAG;QACd,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;QACJ,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE;QAC3B,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE;KAC5B,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAqB;IACnD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC;IAC3B,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;IACrB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAqB;IAC9C,OAAO,KAAK,CAAC,MAAM,IAAI,eAAe,CAAC;AACzC,CAAC"}

package/lib/scatter3d/ui/scatterCloudModel.d.ts

@@ -0,0 +1,60 @@
+/**
+ * What a cloud is made of before any of it is drawn: the shell around each
+ * group, and the sentence a screen reader is given instead of the picture.
+ *
+ * It is kept out of the component for the same reason the flat scatter's model
+ * is: a shell is fitted once per change of data, and fitting it inside the
+ * render callback would fit it again on every frame of a turn.
+ */
+import type { EllipseSize } from '../../scatter/core/confidenceEllipse.ts';
+import type { ScatterGroup } from '../../scatter/ui/scatterFigureProps.ts';
+import type { ScatterGroupInk } from '../../scatter/ui/scatterPlotModel.ts';
+import type { Vector3 } from '../core/orbitCamera.ts';
+import type { CloudShell } from './CloudShellLayer.tsx';
+/** What {@link cloudShells} needs to fit one shell per group. */
+export interface CloudShellsInput {
+    /** Every sample, in cube units. */
+    cube: readonly Vector3[];
+    /** Which group each sample belongs to, as an index into `groups`. */
+    groupOf: ArrayLike<number>;
+    /** The groups, in the order they are coloured. */
+    groups: readonly ScatterGroup[];
+    /** The colour and the strength each group is drawn at. */
+    ink: ScatterGroupInk;
+    /** How large the shells are. */
+    size: EllipseSize;
+    /**
+     * How many samples a group needs before it is given a shell.
+     * @default 4
+     */
+    minimumPoints?: number;
+}
+/**
+ * One shell per group that has enough samples to have a shape.
+ *
+ * The shells are fitted in cube units rather than in the data's own, because
+ * the three axes were stretched to one cube and a shell fitted before that
+ * stretch would not sit on the cloud the reader is looking at. It is the same
+ * reasoning the map uses when it fits its outlines in pixels.
+ *
+ * A group the reader has switched off in the legend keeps its shell and loses
+ * its strength, so the shape it was making is still visible behind the groups
+ * that are left — which is the whole point of switching one off.
+ * @param input - See {@link CloudShellsInput}.
+ * @returns The shells, in group order. A group too small for a shape is left out rather than given a shell that describes its handful of samples.
+ */
+export declare function cloudShells(input: CloudShellsInput): CloudShell[];
+/**
+ * What a screen reader is told the figure shows.
+ *
+ * It names all three axes, because a reader who cannot see the box has no
+ * frame to read them off, and the frame is where a sighted reader learns which
+ * axis is which.
+ * @param xLabel - What the axis running left to right is called.
+ * @param yLabel - What the axis running bottom to top is called.
+ * @param zLabel - What the axis running away from the reader is called.
+ * @param count - How many samples there are.
+ * @returns The sentence.
+ */
+export declare function cloudLabel(xLabel: string, yLabel: string, zLabel: string, count: number): string;
+//# sourceMappingURL=scatterCloudModel.d.ts.map

package/lib/scatter3d/ui/scatterCloudModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scatterCloudModel.d.ts","sourceRoot":"","sources":["../../../src/scatter3d/ui/scatterCloudModel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IACzB,qEAAqE;IACrE,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3B,kDAAkD;IAClD,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,0DAA0D;IAC1D,GAAG,EAAE,eAAe,CAAC;IACrB,gCAAgC;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,EAAE,CA0BjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,CAER"}

package/lib/scatter3d/ui/scatterCloudModel.js

@@ -0,0 +1,67 @@
+/**
+ * What a cloud is made of before any of it is drawn: the shell around each
+ * group, and the sentence a screen reader is given instead of the picture.
+ *
+ * It is kept out of the component for the same reason the flat scatter's model
+ * is: a shell is fitted once per change of data, and fitting it inside the
+ * render callback would fit it again on every frame of a turn.
+ */
+import { chartGroupIndex } from "../../chart/core/chartGroups.js";
+import { confidenceEllipsoid } from "../core/confidenceEllipsoid.js";
+/**
+ * One shell per group that has enough samples to have a shape.
+ *
+ * The shells are fitted in cube units rather than in the data's own, because
+ * the three axes were stretched to one cube and a shell fitted before that
+ * stretch would not sit on the cloud the reader is looking at. It is the same
+ * reasoning the map uses when it fits its outlines in pixels.
+ *
+ * A group the reader has switched off in the legend keeps its shell and loses
+ * its strength, so the shape it was making is still visible behind the groups
+ * that are left — which is the whole point of switching one off.
+ * @param input - See {@link CloudShellsInput}.
+ * @returns The shells, in group order. A group too small for a shape is left out rather than given a shell that describes its handful of samples.
+ */
+export function cloudShells(input) {
+    const { cube, groupOf, groups, ink, size, minimumPoints } = input;
+    const held = groups.map(() => []);
+    const count = Math.min(cube.length, groupOf.length);
+    for (let index = 0; index < count; index++) {
+        const group = chartGroupIndex(groupOf, index, groups.length);
+        if (group === -1)
+            continue;
+        held[group].push(cube[index]);
+    }
+    const shells = [];
+    for (const [group, entry] of groups.entries()) {
+        const ellipsoid = confidenceEllipsoid(held[group], {
+            size,
+            minimumPoints,
+        });
+        if (ellipsoid === null)
+            continue;
+        shells.push({
+            id: entry.id,
+            color: ink.colors[group] ?? entry.color,
+            ellipsoid,
+            opacity: ink.opacities[group] ?? 1,
+        });
+    }
+    return shells;
+}
+/**
+ * What a screen reader is told the figure shows.
+ *
+ * It names all three axes, because a reader who cannot see the box has no
+ * frame to read them off, and the frame is where a sighted reader learns which
+ * axis is which.
+ * @param xLabel - What the axis running left to right is called.
+ * @param yLabel - What the axis running bottom to top is called.
+ * @param zLabel - What the axis running away from the reader is called.
+ * @param count - How many samples there are.
+ * @returns The sentence.
+ */
+export function cloudLabel(xLabel, yLabel, zLabel, count) {
+    return `A three-dimensional scatter plot of ${count} samples: ${xLabel} across, ${yLabel} up, and ${zLabel} into the picture.`;
+}
+//# sourceMappingURL=scatterCloudModel.js.map

package/lib/scatter3d/ui/scatterCloudModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scatterCloudModel.js","sourceRoot":"","sources":["../../../src/scatter3d/ui/scatterCloudModel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAIlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAwBrE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IAElE,MAAM,IAAI,GAAgB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,SAAS;QAC1B,IAAI,CAAC,KAAK,CAAe,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAY,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAc,EAAE;YAC9D,IAAI;YACJ,aAAa;SACd,CAAC,CAAC;QACH,IAAI,SAAS,KAAK,IAAI;YAAE,SAAS;QACjC,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK;YACvC,SAAS;YACT,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CACxB,MAAc,EACd,MAAc,EACd,MAAc,EACd,KAAa;IAEb,OAAO,uCAAuC,KAAK,aAAa,MAAM,YAAY,MAAM,YAAY,MAAM,oBAAoB,CAAC;AACjI,CAAC"}

package/lib/scatter3d/ui/scatterCloudProps.d.ts

@@ -0,0 +1,86 @@
+/**
+ * What a caller hands a `ScatterCloud`.
+ *
+ * What the cloud shares with the flat map — groups, labels, selection, hover
+ * and double click — is declared once in `scatterFigureProps.ts`; this adds
+ * the three axes, the shells, and the camera only a box has.
+ */
+import type { EllipseSize } from '../../scatter/core/confidenceEllipse.ts';
+import type { ScatterGroupProps, ScatterInteractionProps } from '../../scatter/ui/scatterFigureProps.ts';
+import type { CloudGesture } from '../core/cloudGesture.ts';
+import type { OrbitCamera } from '../core/orbitCamera.ts';
+/** What a `ScatterCloud` needs. */
+export interface ScatterCloudProps extends ScatterGroupProps, ScatterInteractionProps {
+    /** Where every sample sits along the axis that runs left to right, in data units. */
+    x: ArrayLike<number>;
+    /** Along the axis that runs bottom to top, in the same order. */
+    y: ArrayLike<number>;
+    /** Along the axis that runs away from the reader. */
+    z: ArrayLike<number>;
+    /** Total width, in pixels, from `useContainerSize`. */
+    width: number;
+    /** Total height. */
+    height: number;
+    /** What the axis running left to right is called, written on the frame. */
+    xLabel: string;
+    /** What the axis running bottom to top is called. */
+    yLabel: string;
+    /** What the axis running away from the reader is called. */
+    zLabel: string;
+    /**
+     * How large the group shells are, or `null` for none. A share is read in
+     * three dimensions here, so the same share gives a wider shell than the same
+     * call gives on the map — which is the point of asking for a share rather
+     * than for a distance.
+     * @default null
+     */
+    ellipsoid?: EllipseSize | null;
+    /**
+     * How many samples a group needs before it is given a shell. Below four a
+     * group has no volume to measure, so anything less is read as four.
+     * @default 4
+     */
+    ellipsoidMinimumPoints?: number;
+    /**
+     * How solid one wall of the glass is; `0` draws no shells at all.
+     * @default 0.1
+     */
+    ellipsoidFillOpacity?: number;
+    /**
+     * What a drag does. The cloud never changes it on its own, because the
+     * control belongs in the bar above the figure rather than on top of the
+     * picture, so it is a plain setting rather than a controlled value.
+     * @default 'turn'
+     */
+    gesture?: CloudGesture;
+    /**
+     * Where the reader is standing. Present, the caller owns the camera, which
+     * is how a site puts a viewpoint in a share link.
+     * @default undefined — the cloud keeps its own
+     */
+    camera?: OrbitCamera;
+    /**
+     * Called with the camera every frame of a turn leaves behind.
+     * @default undefined
+     */
+    onCameraChange?: (camera: OrbitCamera) => void;
+    /**
+     * How far in the reader has zoomed; `1` is the resting size. Present, the
+     * caller owns it.
+     * @default undefined — the cloud keeps its own
+     */
+    zoom?: number;
+    /**
+     * Called with the zoom a wheel asks for.
+     * @default undefined
+     */
+    onZoomChange?: (zoom: number) => void;
+    /**
+     * Whether the wheel zooms the box. On, because a cloud that cannot be zoomed
+     * cannot be read where its groups overlap; a figure set in a column of prose
+     * should turn it off so a reader on their way past keeps their scroll.
+     * @default true
+     */
+    wheelZoom?: boolean;
+}
+//# sourceMappingURL=scatterCloudProps.d.ts.map

package/lib/scatter3d/ui/scatterCloudProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scatterCloudProps.d.ts","sourceRoot":"","sources":["../../../src/scatter3d/ui/scatterCloudProps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,mCAAmC;AACnC,MAAM,WAAW,iBACf,SAAQ,iBAAiB,EAAE,uBAAuB;IAClD,qFAAqF;IACrF,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACrB,iEAAiE;IACjE,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACrB,qDAAqD;IACrD,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACrB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC/B;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IAC/C;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}