react-cheminfo 0.10.0 → 0.11.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,36 @@
+/**
+ * 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. That is the whole of
+ * the modelling the tessellated version did, minus the seams between the faces
+ * it needed to do it.
+ *
+ * The walls are composited rather than added, so two of them at a tenth are
+ * not a fifth but a nineteenth-something — the same arithmetic the browser was
+ * doing when they were stacked polygons.
+ * @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;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAOlE"}

package/lib/scatter3d/ui/cloudShellStyles.js

@@ -0,0 +1,62 @@
+/**
+ * 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, which is the wireframe this fill replaced.
+ */
+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. That is the whole of
+ * the modelling the tessellated version did, minus the seams between the faces
+ * it needed to do it.
+ *
+ * The walls are composited rather than added, so two of them at a tenth are
+ * not a fifth but a nineteenth-something — the same arithmetic the browser was
+ * doing when they were stacked polygons.
+ * @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;
+    return GLASS_OFFSETS.map((offset) => ({
+        offset,
+        opacity: round(1 - clear ** wallsAt(offset)),
+    }));
+}
+/**
+ * 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;;;;;;;;;;;;;;;;GAgBG;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,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACpC,MAAM;QACN,OAAO,EAAE,KAAK,CAAC,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;KAC7C,CAAC,CAAC,CAAC;AACN,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":"AAAA;;;;;;;;GAQG;AAEH,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB;;;CAAgC,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD"}

package/lib/scatter3d/ui/cloudZoom.js

@@ -0,0 +1,22 @@
+/**
+ * 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) {
+    if (!Number.isFinite(zoom))
+        return 1;
+    return Math.min(CLOUD_ZOOM_RANGE.max, Math.max(CLOUD_ZOOM_RANGE.min, zoom));
+}
+//# 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;;;;;;;;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,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AAC9E,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * 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 { CloudPointLayerProps } from './CloudPointLayer.tsx';
+export { CloudPointLayer } from './CloudPointLayer.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 { CloudGesture, 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,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,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,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,21 @@
+/**
+ * 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 { CloudPointLayer } from "./CloudPointLayer.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;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/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 has to be cut before there is anything to project, and cutting
+ * it inside the render callback would cut it again on every turn.
+ */
+import type { EllipseSize } from '../../scatter/core/confidenceEllipse.ts';
+import type { ScatterGroupInk } from '../../scatter/ui/scatterPlotModel.ts';
+import type { ScatterGroup } from '../../scatter/ui/scatterPlotProps.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;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE,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,66 @@
+/**
+ * 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 has to be cut before there is anything to project, and cutting
+ * it inside the render callback would cut it again on every turn.
+ */
+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 = groupOf[index];
+        if (group === undefined || group < 0 || group >= groups.length)
+            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;AAKH,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,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,MAAM,CAAC,MAAM;YAAE,SAAS;QACxE,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,185 @@
+/**
+ * What a caller hands a `ScatterCloud`.
+ *
+ * The types live beside the component rather than inside it because the
+ * component's own file would otherwise be mostly prose, exactly as the flat
+ * scatter's are.
+ */
+import type { ReactNode } from 'react';
+import type { EllipseSize } from '../../scatter/core/confidenceEllipse.ts';
+import type { ScatterSelectionMode } from '../../scatter/core/scatterSelection.ts';
+import type { ScatterGroup, ScatterPointOpen } from '../../scatter/ui/scatterPlotProps.ts';
+import type { SelectionChange } from '../../scatter/ui/useScatterSelection.ts';
+import type { CloudGesture } from '../core/cloudGesture.ts';
+import type { OrbitCamera } from '../core/orbitCamera.ts';
+export type { CloudGesture } from '../core/cloudGesture.ts';
+/** What a `ScatterCloud` needs. */
+export interface ScatterCloudProps {
+    /** 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;
+    /**
+     * Which group each sample belongs to, as an index into `groups`. A sample
+     * with `-1`, or an index outside the range, is drawn in the muted ink and
+     * left out of every shell.
+     * @default undefined — every sample is one crowd
+     */
+    groupOf?: ArrayLike<number>;
+    /**
+     * The groups, in the order they are coloured and listed.
+     * @default undefined
+     */
+    groups?: readonly ScatterGroup[];
+    /**
+     * Which groups are drawn faint, by id — what a legend entry switches.
+     * @default undefined — every group is drawn in full
+     */
+    mutedGroups?: ReadonlySet<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 the glass is; `0` draws no shells at all.
+     * @default SHELL_FILL_OPACITY
+     */
+    ellipsoidFillOpacity?: number;
+    /**
+     * Whether each group's name is written once, over the middle of its own
+     * shell. It needs `groups`, since it is their names it writes.
+     * @default false
+     */
+    showGroupLabels?: boolean;
+    /**
+     * What each sample is called, written beside its own dot. A sample whose
+     * entry is `undefined` is left unnamed.
+     * @default undefined — no sample is named
+     */
+    pointLabels?: ReadonlyArray<string | undefined>;
+    /**
+     * Radius of a dot at the middle of the box, in pixels. One at the front is
+     * drawn larger and one at the back smaller, about this.
+     * @default 3.5
+     */
+    pointRadius?: number;
+    /**
+     * The index from which samples are drawn as outlines rather than filled,
+     * which is how one the model was fitted on is told from one placed into it
+     * afterwards.
+     * @default undefined — every sample is filled
+     */
+    outlinedFrom?: 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;
+    /**
+     * The selected rows. Present, the caller owns the selection.
+     * @default undefined — the cloud keeps its own
+     */
+    selected?: readonly number[];
+    /**
+     * The rows selected before the reader touches anything.
+     * @default undefined
+     */
+    defaultSelected?: readonly number[];
+    /**
+     * Called when a lasso is released or a dot is tapped — never while a lasso
+     * is being drawn, and never while the box is being turned.
+     * @default undefined
+     */
+    onSelectionChange?: (change: SelectionChange) => void;
+    /**
+     * What a gesture with no modifier held does to the selection. Shift always
+     * adds and Alt always removes, exactly as on the map.
+     * @default 'replace'
+     */
+    selectMode?: ScatterSelectionMode;
+    /**
+     * Called with the row under the pointer, or `-1`.
+     * @default undefined
+     */
+    onHoverChange?: (index: number) => void;
+    /**
+     * Called when the reader double-clicks a sample, exactly as on the flat map:
+     * the gesture for "tell me more about this one", or "let me change it".
+     *
+     * It fires whichever gesture a drag is set to, because a double click is not
+     * a drag — a reader turning the box must not have to switch to Select to
+     * open a sample. The sample is selected first, since a double click is also
+     * two clicks; the map says why, and the two behave alike on purpose.
+     * @default undefined
+     */
+    onPointDoubleClick?: (point: ScatterPointOpen) => void;
+    /**
+     * What floats over the figure — a bar, a key, a caption, a card.
+     * @default undefined
+     */
+    overlay?: ReactNode;
+    /**
+     * What a screen reader is told the figure shows.
+     * @default a sentence built from the three axis names and the sample count
+     */
+    label?: string;
+    /**
+     * Value of the `data-testid` attribute of the wrapper.
+     * @default undefined
+     */
+    testId?: string;
+}
+//# 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":"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"}

package/lib/scatter3d/ui/scatterCloudProps.js

@@ -0,0 +1,9 @@
+/**
+ * What a caller hands a `ScatterCloud`.
+ *
+ * The types live beside the component rather than inside it because the
+ * component's own file would otherwise be mostly prose, exactly as the flat
+ * scatter's are.
+ */
+export {};
+//# sourceMappingURL=scatterCloudProps.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scatterCloudProps.js","sourceRoot":"","sources":["../../../src/scatter3d/ui/scatterCloudProps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

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

@@ -0,0 +1,60 @@
+import type { ScatterSelectionMode } from '../../scatter/core/scatterSelection.ts';
+import type { ScatterSurfaceProps } from '../../scatter/ui/lassoGesture.ts';
+import type { OrbitCamera } from '../core/orbitCamera.ts';
+/** What {@link useOrbitDrag} needs. */
+export interface OrbitDragOptions {
+    /**
+     * Whether a drag turns the box at all. Off, the surface still reports a tap,
+     * so the reader can pick a sample while the drag belongs to something else.
+     * @default true
+     */
+    enabled?: boolean;
+    /** Called with the camera each frame of a drag leaves behind. */
+    onOrbit: (turn: (camera: OrbitCamera) => OrbitCamera) => void;
+    /**
+     * Called when a press and release happened in one place — a click, however
+     * the reader's hand shook.
+     * @default undefined
+     */
+    onTap?: (x: number, y: number, mode: ScatterSelectionMode) => void;
+    /**
+     * Called with the pointer's position on every frame it moves without
+     * turning, which is what raises the card under it.
+     * @default undefined
+     */
+    onMove?: (x: number, y: number) => void;
+    /**
+     * Called when the pointer leaves the surface without a drag in progress.
+     * @default undefined
+     */
+    onLeave?: () => void;
+    /**
+     * What a tap with no modifier held does to the selection.
+     * @default 'replace'
+     */
+    mode?: ScatterSelectionMode;
+}
+/** A drag that turns the box, and the taps it lets through. */
+export interface OrbitDrag {
+    /** Whether the box is being turned right now. */
+    turning: boolean;
+    /** Spread onto the transparent rectangle over the figure. */
+    surface: ScatterSurfaceProps;
+}
+/**
+ * Turning the box with the pointer.
+ *
+ * It is the lasso's twin and is built the same way — the pointer is captured
+ * on the way down so a drag that wanders off the figure keeps turning it, all
+ * three ways a capture can end lead to one function, and moves are coalesced
+ * to one a frame because a pointer emits many per frame and each one that
+ * reaches the caller repaints every dot and every face.
+ *
+ * A press that goes nowhere is a tap rather than a turn of no degrees, because
+ * nobody presses a mouse button without moving it a pixel or two and a reader
+ * who meant to pick a sample must not have to hold their hand still to do it.
+ * @param options - See {@link OrbitDragOptions}.
+ * @returns The drag. See {@link OrbitDrag}.
+ */
+export declare function useOrbitDrag(options: OrbitDragOptions): OrbitDrag;
+//# sourceMappingURL=useOrbitDrag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useOrbitDrag.d.ts","sourceRoot":"","sources":["../../../src/scatter3d/ui/useOrbitDrag.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAQ5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,WAAW,KAAK,IAAI,CAAC;IAC9D;;;;OAIG;IACH,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACnE;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC7B;AAED,+DAA+D;AAC/D,MAAM,WAAW,SAAS;IACxB,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA6HjE"}