@fnndsc/orrery 0.1.0

package/dist/draw/censusField.js

@@ -0,0 +1,241 @@
+/**
+ * @file The census: every job of every stage.
+ *
+ * A stage that stands for many jobs is drawn as a shell of them around its
+ * place, each job its own sphere (or, under stars, its own point of light);
+ * each job is joined to a job of its parent stage — by tubes that carry
+ * the feed's pulses while there are few enough of them, by lines past that.
+ * A wave down the graph flares every job of a stage together.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+import { THREAD_OPACITY } from './constants.js';
+import { fibonacciPoint_make } from './geometry.js';
+import { WAVE_STEP_MS } from './timing.js';
+import { tubeMode_of } from './tubeField.js';
+import { CENSUS_TUBE_CAP } from './tubes.js';
+/** Every job of every stage, drawn. */
+export class CensusField {
+    host;
+    mesh = null;
+    base = null;
+    memberIds = [];
+    memberPositions = [];
+    /**
+     * @param host - What the census draws with.
+     */
+    constructor(host) {
+        this.host = host;
+    }
+    /** Whether the census is drawn as instanced spheres (not stars). */
+    drawn() {
+        return this.mesh !== null;
+    }
+    /** The stage behind each job, in draw order. */
+    ids() {
+        return this.memberIds;
+    }
+    /** Where each job stands, in draw order. */
+    positions() {
+        return this.memberPositions;
+    }
+    /**
+     * Draws the census.
+     *
+     * @param nodes - The stages.
+     * @param starring - Draw jobs as points of light, not spheres.
+     * @param palette - The colours.
+     * @returns Where the cloud stands and how far it reaches.
+     */
+    build(nodes, starring, palette) {
+        let total = 0;
+        for (const node of nodes)
+            if (node.ghost !== true)
+                total += Math.max(1, node.count);
+        const geometry = new THREE.IcosahedronGeometry(1, 1);
+        const material = new THREE.MeshStandardMaterial({ color: '#ffffff', roughness: 0.5, metalness: 0.1 });
+        const starred = [];
+        const instanced = new THREE.InstancedMesh(geometry, material, starring ? 1 : total);
+        const color = new THREE.Color();
+        const carrier = new THREE.Object3D();
+        const shells = new Map();
+        const shellRadii = new Map();
+        let index = 0;
+        let cloudRadius = 1;
+        const center = new THREE.Vector3();
+        for (const node of nodes)
+            center.add(node.position);
+        center.divideScalar(Math.max(1, nodes.length));
+        for (const node of nodes) {
+            // An anchor is nobody's job: a census of it would draw a shell of nothing.
+            if (node.ghost === true)
+                continue;
+            const n = Math.max(1, node.count);
+            const shellRadius = n === 1 ? 0 : node.radius * (1.6 + 0.55 * Math.cbrt(n));
+            const memberRadius = n === 1 ? node.radius : Math.max(0.06, Math.min(node.radius * 0.5, (2.2 * shellRadius) / Math.sqrt(n)));
+            const points = [];
+            for (let k = 0; k < n; k++) {
+                const point = n === 1 ? node.position.clone() : fibonacciPoint_make(k, n, shellRadius).add(node.position);
+                points.push(point);
+                color.set(node.color);
+                if (starring) {
+                    starred.push({ id: node.id, position: point, radius: memberRadius, color: color.clone(), dim: node.dim, ember: node.ember });
+                }
+                else {
+                    carrier.position.copy(point);
+                    carrier.scale.setScalar(memberRadius);
+                    carrier.updateMatrix();
+                    instanced.setMatrixAt(index, carrier.matrix);
+                    instanced.setColorAt(index, color);
+                }
+                this.memberIds.push(node.id);
+                this.memberPositions.push(point);
+                index += 1;
+                cloudRadius = Math.max(cloudRadius, center.distanceTo(point) + memberRadius);
+            }
+            shells.set(node.id, points);
+            shellRadii.set(node.id, memberRadius);
+        }
+        if (starring) {
+            const view = this.host.starsView();
+            this.host.stars.draw(starred, view.pixelRatio, view.heightPx, view.fovDeg);
+        }
+        else {
+            if (instanced.instanceColor)
+                instanced.instanceColor.needsUpdate = true;
+            this.host.parent.add(instanced);
+            this.mesh = instanced;
+            this.base = instanced.instanceColor ? Float32Array.from(instanced.instanceColor.array) : null;
+        }
+        const segments = [];
+        for (const node of nodes) {
+            const mine = shells.get(node.id) ?? [];
+            for (const parentId of node.parents) {
+                const theirs = shells.get(parentId);
+                if (!theirs || theirs.length === 0)
+                    continue;
+                for (let k = 0; k < mine.length; k++) {
+                    const a = mine[k];
+                    const b = theirs.length === mine.length ? theirs[k] : theirs[k % theirs.length];
+                    if (a === undefined || b === undefined)
+                        continue;
+                    segments.push(a.x, a.y, a.z, b.x, b.y, b.z);
+                }
+            }
+        }
+        // Drawn as spheres, a census joins its jobs with the tubes a feed wears,
+        // pulses and all — while there are few enough of them to draw.
+        const tubeCount = segments.length / 6;
+        if (!starring && tubeCount > 0 && tubeCount <= CENSUS_TUBE_CAP) {
+            this.tubes_build(nodes, shells, shellRadii, palette);
+        }
+        else if (segments.length > 0) {
+            const edgeGeometry = new THREE.BufferGeometry();
+            edgeGeometry.setAttribute('position', new THREE.Float32BufferAttribute(segments, 3));
+            this.host.parent.add(new THREE.LineSegments(edgeGeometry, starring
+                ? new THREE.LineBasicMaterial({ color: palette.edge, transparent: true, opacity: THREAD_OPACITY, blending: THREE.AdditiveBlending, depthWrite: false })
+                : new THREE.LineBasicMaterial({ color: palette.edge, transparent: true, opacity: 0.35 })));
+        }
+        return { center, radius: cloudRadius };
+    }
+    /**
+     * Flares every job of a stage with the wave, written straight into the
+     * instance colours.
+     *
+     * @param fireAt - When a stage fires, by id; undefined when it does not.
+     * @param elapsed - Time since the wave set off.
+     * @param pulse - The flare's hue.
+     * @param flareMs - How long a flare lasts.
+     * @returns The latest a stage fires, so the caller knows when the wave is done.
+     */
+    flare(fireAt, elapsed, pulse, flareMs) {
+        let peak = 0;
+        if (this.mesh === null || this.base === null || !this.mesh.instanceColor)
+            return peak;
+        const colors = this.mesh.instanceColor.array;
+        const base = this.base;
+        for (let i = 0; i < this.memberIds.length; i++) {
+            const at = fireAt(this.memberIds[i] ?? '');
+            if (at === undefined)
+                continue;
+            peak = Math.max(peak, at);
+            const dt = elapsed - at;
+            const flare = dt >= 0 && dt <= flareMs ? Math.sin((dt / flareMs) * Math.PI) : 0;
+            const o = i * 3;
+            colors[o] = base[o] + (pulse.r - base[o]) * flare;
+            colors[o + 1] = base[o + 1] + (pulse.g - base[o + 1]) * flare;
+            colors[o + 2] = base[o + 2] + (pulse.b - base[o + 2]) * flare;
+        }
+        this.mesh.instanceColor.needsUpdate = true;
+        return peak;
+    }
+    /**
+     * The stage behind the job a ray meets first; the touched job lights up.
+     *
+     * @param raycaster - The ray, aimed by the caller.
+     * @returns The stage, or null.
+     */
+    pick(raycaster) {
+        if (this.mesh === null)
+            return null;
+        const hit = raycaster.intersectObject(this.mesh)[0];
+        if (hit === undefined || hit.instanceId === undefined)
+            return null;
+        this.mesh.setColorAt(hit.instanceId, new THREE.Color('#ffffff'));
+        if (this.mesh.instanceColor)
+            this.mesh.instanceColor.needsUpdate = true;
+        return this.memberIds[hit.instanceId] ?? null;
+    }
+    /** Forgets everything: the scene is being redrawn. */
+    clear() {
+        this.mesh = null;
+        this.base = null;
+        this.memberIds = [];
+        this.memberPositions = [];
+    }
+    /**
+     * Joins the jobs with tubes: each to the job of its parent stage it stands
+     * against, in the stage's hue (red into a failed one); a live stage
+     * streams, a finished run replays with every job of a stage together.
+     */
+    tubes_build(nodes, shells, shellRadii, palette) {
+        const byId = new Map(nodes.map((node) => [node.id, node]));
+        const depth = new Map();
+        const depth_of = (id, seen = new Set()) => {
+            const known = depth.get(id);
+            if (known !== undefined)
+                return known;
+            if (seen.has(id))
+                return 0;
+            seen.add(id);
+            const parents = (byId.get(id)?.parents ?? []).filter((p) => byId.has(p));
+            const d = parents.length === 0 ? 0 : 1 + Math.max(...parents.map((p) => depth_of(p, seen)));
+            depth.set(id, d);
+            return d;
+        };
+        const bright = palette.edge.clone().lerp(new THREE.Color('#ffffff'), 0.45);
+        const specs = [];
+        let deepest = 0;
+        for (const node of nodes) {
+            const mine = shells.get(node.id) ?? [];
+            for (const parentId of node.parents) {
+                const theirs = shells.get(parentId);
+                if (!theirs || theirs.length === 0)
+                    continue;
+                const width = Math.max(0.02, Math.min(shellRadii.get(node.id) ?? 0.1, shellRadii.get(parentId) ?? 0.1) * 0.34);
+                const start = depth_of(parentId) * WAVE_STEP_MS;
+                deepest = Math.max(deepest, depth_of(parentId));
+                for (let k = 0; k < mine.length; k++) {
+                    const to = mine[k];
+                    const from = theirs.length === mine.length ? theirs[k] : theirs[k % theirs.length];
+                    if (from === undefined || to === undefined)
+                        continue;
+                    specs.push({ from, to, width, color: node.state === 'failed' ? palette.error : bright, mode: tubeMode_of(node.state), start });
+                }
+            }
+        }
+        this.host.tubes.census_build(specs, deepest);
+    }
+}
+//# sourceMappingURL=censusField.js.map

package/dist/draw/censusField.js.map

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

package/dist/draw/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file How faint things are drawn: the opacities the drawers share.
+ *
+ * @module
+ */
+/** How faint a dimmed node and its edges are drawn. */
+export declare const DIM_OPACITY: number;
+/** How faint a cluster's halo is drawn. */
+export declare const HALO_OPACITY: number;
+/** Threads (edges) while the scene draws stars: faint, so the light leads. */
+export declare const THREAD_OPACITY: number;
+/** A nebula's opacity at its heart; a dimmed one a third of it. */
+export declare const NEBULA_OPACITY: number;

package/dist/draw/constants.js

@@ -0,0 +1,14 @@
+/**
+ * @file How faint things are drawn: the opacities the drawers share.
+ *
+ * @module
+ */
+/** How faint a dimmed node and its edges are drawn. */
+export const DIM_OPACITY = 0.16;
+/** How faint a cluster's halo is drawn. */
+export const HALO_OPACITY = 0.09;
+/** Threads (edges) while the scene draws stars: faint, so the light leads. */
+export const THREAD_OPACITY = 0.1;
+/** A nebula's opacity at its heart; a dimmed one a third of it. */
+export const NEBULA_OPACITY = 0.2;
+//# sourceMappingURL=constants.js.map

package/dist/draw/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/draw/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,WAAW,GAAW,IAAI,CAAC;AAExC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,YAAY,GAAW,IAAI,CAAC;AAEzC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAW,GAAG,CAAC;AAE1C,mEAAmE;AACnE,MAAM,CAAC,MAAM,cAAc,GAAW,GAAG,CAAC"}

package/dist/draw/geometry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @file The shapes the drawers share: halos, shells of points, spheres.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+/**
+ * A halo's radius by the feeds it gathers: room for a few, more for a crowd,
+ * never so much it swallows the neighbouring cluster.
+ *
+ * @param count - The feeds of the shape.
+ * @returns The radius in scene units.
+ */
+export declare function haloRadius_of(count: number): number;
+/** The k-th of n points on a fibonacci sphere of the given radius. */
+export declare function fibonacciPoint_make(k: number, n: number, radius: number): THREE.Vector3;
+/**
+ * Sphere geometries shared by radius: one per size a scene draws, not one
+ * per node (thousands of identical spheres each built their own, and a
+ * rebuild paid for every one).
+ */
+export declare class SphereGeometries {
+    private readonly byKey;
+    /**
+     * The sphere of a radius, built once.
+     *
+     * @param radius - The radius, kept to a thousandth.
+     * @returns The shared geometry.
+     */
+    of(radius: number): THREE.SphereGeometry;
+    /** Lets every geometry go. */
+    dispose(): void;
+}

package/dist/draw/geometry.js

@@ -0,0 +1,55 @@
+/**
+ * @file The shapes the drawers share: halos, shells of points, spheres.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+/**
+ * A halo's radius by the feeds it gathers: room for a few, more for a crowd,
+ * never so much it swallows the neighbouring cluster.
+ *
+ * @param count - The feeds of the shape.
+ * @returns The radius in scene units.
+ */
+export function haloRadius_of(count) {
+    return 1.6 + 0.45 * Math.sqrt(Math.max(1, count));
+}
+/** The k-th of n points on a fibonacci sphere of the given radius. */
+export function fibonacciPoint_make(k, n, radius) {
+    const golden = Math.PI * (3 - Math.sqrt(5));
+    const y = n === 1 ? 0 : 1 - (2 * k) / (n - 1);
+    const ring = Math.sqrt(Math.max(0, 1 - y * y));
+    const angle = golden * k;
+    return new THREE.Vector3(Math.cos(angle) * ring * radius, y * radius, Math.sin(angle) * ring * radius);
+}
+/**
+ * Sphere geometries shared by radius: one per size a scene draws, not one
+ * per node (thousands of identical spheres each built their own, and a
+ * rebuild paid for every one).
+ */
+export class SphereGeometries {
+    byKey = new Map();
+    /**
+     * The sphere of a radius, built once.
+     *
+     * @param radius - The radius, kept to a thousandth.
+     * @returns The shared geometry.
+     */
+    of(radius) {
+        const key = Math.round(radius * 1000);
+        let geometry = this.byKey.get(key);
+        if (geometry === undefined) {
+            geometry = new THREE.SphereGeometry(key / 1000, 24, 18);
+            geometry.computeBoundingSphere();
+            this.byKey.set(key, geometry);
+        }
+        return geometry;
+    }
+    /** Lets every geometry go. */
+    dispose() {
+        for (const geometry of this.byKey.values())
+            geometry.dispose();
+        this.byKey.clear();
+    }
+}
+//# sourceMappingURL=geometry.js.map

package/dist/draw/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../../src/draw/geometry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,mBAAmB,CAAC,CAAS,EAAE,CAAS,EAAE,MAAc;IACtE,MAAM,MAAM,GAAW,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,CAAC,GAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,IAAI,GAAW,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,KAAK,GAAW,MAAM,GAAG,CAAC,CAAC;IACjC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC;AACzG,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IACV,KAAK,GAAsC,IAAI,GAAG,EAAE,CAAC;IAEtE;;;;;OAKG;IACI,EAAE,CAAC,MAAc;QACtB,MAAM,GAAG,GAAW,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QAC9C,IAAI,QAAQ,GAAqC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,QAAQ,GAAG,IAAI,KAAK,CAAC,cAAc,CAAC,GAAG,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACxD,QAAQ,CAAC,qBAAqB,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,8BAA8B;IACvB,OAAO;QACZ,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC/D,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/draw/handoff.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @file When a molecule turns from stars to spheres and back, and how long the crossfade takes.
+ *
+ * @module
+ */
+/** A feed switches to solid when its largest sphere spans this many CSS pixels… */
+export declare const HANDOFF_SOLID_PX: number;
+/** …and back to stars below this: the gap keeps a feed at the edge from flickering. */
+export declare const HANDOFF_STAR_PX: number;
+/** The crossfade between a feed's stars and its spheres. */
+export declare const HANDOFF_FADE_MS: number;

package/dist/draw/handoff.js

@@ -0,0 +1,12 @@
+/**
+ * @file When a molecule turns from stars to spheres and back, and how long the crossfade takes.
+ *
+ * @module
+ */
+/** A feed switches to solid when its largest sphere spans this many CSS pixels… */
+export const HANDOFF_SOLID_PX = 7;
+/** …and back to stars below this: the gap keeps a feed at the edge from flickering. */
+export const HANDOFF_STAR_PX = 5;
+/** The crossfade between a feed's stars and its spheres. */
+export const HANDOFF_FADE_MS = 300;
+//# sourceMappingURL=handoff.js.map

package/dist/draw/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../../src/draw/handoff.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAW,CAAC,CAAC;AAE1C,uFAAuF;AACvF,MAAM,CAAC,MAAM,eAAe,GAAW,CAAC,CAAC;AAEzC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAW,GAAG,CAAC"}

package/dist/draw/handoffField.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @file The hand-off between stars and spheres.
+ *
+ * From afar a molecule is stars; as the camera closes on it — its nearest
+ * sphere spanning more than a few pixels — it crossfades to lit spheres in
+ * their tubes, its threads rising to edges; drawing back, it fades to stars
+ * again and its spheres are let go. A gap between the two thresholds keeps
+ * a molecule at the edge from flickering.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+import type { SphereField } from './sphereField.js';
+import type { StarField } from './starField.js';
+import type { StarEntry } from './stars.js';
+import type { TubeField } from './tubeField.js';
+/** How a solid sphere is drawn for a node: where, how large, what hue. */
+export interface HandoffLook {
+    position: THREE.Vector3;
+    radius: number;
+    color: THREE.Color;
+}
+/** What the hand-off draws with. */
+export interface HandoffHost {
+    spheres: SphereField;
+    stars: StarField;
+    tubes: TubeField;
+    /** How a node's sphere is drawn, when it turns solid. */
+    look(id: string): HandoffLook | undefined;
+}
+/** Every molecule's place between stars and spheres. */
+export declare class HandoffField {
+    private readonly host;
+    private groups;
+    private lastAt;
+    /**
+     * @param host - What the hand-off draws with.
+     */
+    constructor(host: HandoffHost);
+    /** How many molecules take part. */
+    size(): number;
+    /** How many are solid, or on their way. */
+    solidCount(): number;
+    /**
+     * Gathers drawn stars into molecules. A dimmed star is scenery and never
+     * turns solid.
+     *
+     * @param starred - The stars as drawn.
+     * @param keyOf - The molecule a node belongs to, or null for none.
+     */
+    gather(starred: ReadonlyArray<StarEntry>, keyOf: (id: string) => string | null): void;
+    /**
+     * Notes that a thread belongs to a molecule, so it fades as the
+     * molecule turns solid.
+     *
+     * @param key - The molecule.
+     * @param segment - The thread's segment.
+     */
+    thread_note(key: string, segment: number): void;
+    /**
+     * Steps the hand-off once a frame.
+     *
+     * @param view - The camera's view of the field (camera inverse × the field's world).
+     * @param perUnit - Pixels per unit of size at unit depth.
+     * @param now - This frame's time.
+     */
+    step(view: THREE.Matrix4, perUnit: number, now: number): void;
+    /** Forgets everything: the scene is being redrawn. */
+    clear(): void;
+    /** Draws a molecule's spheres and tubes for its time as solid. */
+    private solid_build;
+    /** Lets a molecule's spheres and tubes go once it is stars again. */
+    private solid_release;
+}

package/dist/draw/handoffField.js

@@ -0,0 +1,151 @@
+/**
+ * @file The hand-off between stars and spheres.
+ *
+ * From afar a molecule is stars; as the camera closes on it — its nearest
+ * sphere spanning more than a few pixels — it crossfades to lit spheres in
+ * their tubes, its threads rising to edges; drawing back, it fades to stars
+ * again and its spheres are let go. A gap between the two thresholds keeps
+ * a molecule at the edge from flickering.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+import { HANDOFF_FADE_MS, HANDOFF_SOLID_PX, HANDOFF_STAR_PX } from './handoff.js';
+/** Every molecule's place between stars and spheres. */
+export class HandoffField {
+    host;
+    groups = new Map();
+    lastAt = 0;
+    /**
+     * @param host - What the hand-off draws with.
+     */
+    constructor(host) {
+        this.host = host;
+    }
+    /** How many molecules take part. */
+    size() {
+        return this.groups.size;
+    }
+    /** How many are solid, or on their way. */
+    solidCount() {
+        let count = 0;
+        for (const group of this.groups.values())
+            if (group.mix > 0)
+                count += 1;
+        return count;
+    }
+    /**
+     * Gathers drawn stars into molecules. A dimmed star is scenery and never
+     * turns solid.
+     *
+     * @param starred - The stars as drawn.
+     * @param keyOf - The molecule a node belongs to, or null for none.
+     */
+    gather(starred, keyOf) {
+        for (const entry of starred) {
+            if (entry.dim)
+                continue;
+            const key = keyOf(entry.id);
+            if (key === null)
+                continue;
+            let group = this.groups.get(key);
+            if (group === undefined) {
+                group = { entries: [], center: new THREE.Vector3(), maxRadius: 0, mix: 0, target: 0, meshes: [], tubes: null, threadSegments: [] };
+                this.groups.set(key, group);
+            }
+            group.entries.push(entry);
+            group.maxRadius = Math.max(group.maxRadius, entry.radius);
+        }
+        for (const group of this.groups.values()) {
+            for (const entry of group.entries)
+                group.center.add(entry.position);
+            group.center.divideScalar(Math.max(1, group.entries.length));
+        }
+    }
+    /**
+     * Notes that a thread belongs to a molecule, so it fades as the
+     * molecule turns solid.
+     *
+     * @param key - The molecule.
+     * @param segment - The thread's segment.
+     */
+    thread_note(key, segment) {
+        this.groups.get(key)?.threadSegments.push(segment);
+    }
+    /**
+     * Steps the hand-off once a frame.
+     *
+     * @param view - The camera's view of the field (camera inverse × the field's world).
+     * @param perUnit - Pixels per unit of size at unit depth.
+     * @param now - This frame's time.
+     */
+    step(view, perUnit, now) {
+        if (this.groups.size === 0)
+            return;
+        const dt = this.lastAt === 0 ? 0 : Math.min(100, now - this.lastAt);
+        this.lastAt = now;
+        const v = view.elements;
+        for (const group of this.groups.values()) {
+            // Its nearest sphere decides: a sprawling molecule with one sphere at
+            // the camera turns solid, rather than leaving that sphere a swelling star.
+            let depth = Infinity;
+            for (const entry of group.entries) {
+                const p = entry.position;
+                const d = -(v[2] * p.x + v[6] * p.y + v[10] * p.z + v[14]);
+                if (d > 0 && d < depth)
+                    depth = d;
+            }
+            const px = depth === Infinity ? 0 : (2 * group.maxRadius * perUnit) / depth;
+            if (group.target === 0 && px > HANDOFF_SOLID_PX)
+                group.target = 1;
+            else if (group.target === 1 && px < HANDOFF_STAR_PX)
+                group.target = 0;
+            if (group.mix === group.target)
+                continue;
+            const step = dt === 0 ? 1 : dt / HANDOFF_FADE_MS;
+            group.mix = group.target > group.mix ? Math.min(1, group.mix + step) : Math.max(0, group.mix - step);
+            if (group.mix > 0 && group.meshes.length === 0)
+                this.solid_build(group);
+            for (const mesh of group.meshes) {
+                if (mesh.material instanceof THREE.MeshStandardMaterial)
+                    mesh.material.opacity = group.mix;
+            }
+            if (group.tubes !== null && group.tubes.material instanceof THREE.ShaderMaterial) {
+                const opacity = group.tubes.material.uniforms['opacity'];
+                if (opacity !== undefined)
+                    opacity.value = group.mix;
+            }
+            this.host.stars.stars_fade(group.entries, 1 - group.mix);
+            this.host.stars.threads_fade(group.threadSegments, 1 - group.mix);
+            if (group.mix === 0)
+                this.solid_release(group);
+        }
+        this.host.stars.flush();
+    }
+    /** Forgets everything: the scene is being redrawn. */
+    clear() {
+        this.groups = new Map();
+    }
+    /** Draws a molecule's spheres and tubes for its time as solid. */
+    solid_build(group) {
+        const members = new Set(group.entries.map((entry) => entry.id));
+        for (const entry of group.entries) {
+            const look = this.host.look(entry.id);
+            if (look === undefined)
+                continue;
+            group.meshes.push(this.host.spheres.sphere_add(entry.id, look.position, look.radius, { color: look.color, fade: group.mix }));
+        }
+        this.host.tubes.build(group, group.entries.map((entry) => entry.id), members);
+    }
+    /** Lets a molecule's spheres and tubes go once it is stars again. */
+    solid_release(group) {
+        for (const mesh of group.meshes)
+            this.host.spheres.remove(mesh);
+        if (group.tubes !== null) {
+            this.host.tubes.release(group.tubes);
+            group.tubes = null;
+        }
+        group.meshes = [];
+    }
+}
+//# sourceMappingURL=handoffField.js.map

package/dist/draw/handoffField.js.map

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