@fnndsc/orrery 0.1.0

package/dist/draw/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file The drawing layer's public face: the pieces a scene draws with.
+ *
+ * @module
+ */
+export * from './constants.js';
+export * from './timing.js';
+export * from './handoff.js';
+export * from './lamps.js';
+export * from './palette.js';
+export * from './geometry.js';
+export * from './stars.js';
+export * from './starField.js';
+export * from './sphereField.js';
+export * from './nebula.js';
+export * from './tubes.js';
+export * from './tubeField.js';
+export * from './handoffField.js';
+export * from './censusField.js';
+export * from './labelField.js';

package/dist/draw/index.js

@@ -0,0 +1,21 @@
+/**
+ * @file The drawing layer's public face: the pieces a scene draws with.
+ *
+ * @module
+ */
+export * from './constants.js';
+export * from './timing.js';
+export * from './handoff.js';
+export * from './lamps.js';
+export * from './palette.js';
+export * from './geometry.js';
+export * from './stars.js';
+export * from './starField.js';
+export * from './sphereField.js';
+export * from './nebula.js';
+export * from './tubes.js';
+export * from './tubeField.js';
+export * from './handoffField.js';
+export * from './censusField.js';
+export * from './labelField.js';
+//# sourceMappingURL=index.js.map

package/dist/draw/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/draw/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dist/draw/labelField.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @file Captions: words a surface pins to a node, drawn in the space.
+ *
+ * A hub the operator should read without hovering — "DICOM · 38", "SAG
+ * MPRAGE · 12" — carries a caption: its text drawn once on a canvas, shown
+ * as a sprite above the node, always facing the camera, one size on screen
+ * however far away. A dimmed node's caption dims with it. Where captions
+ * meet on screen the bigger node's is read and the smaller's gives way: its
+ * words are a hover away, and words drawn over words are read as neither.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+/**
+ * A caption's height on screen, as a share of the view's height: the same
+ * at any distance, so a hub is read from afar and not shouted at up close.
+ * Sized in the space instead, a caption three units tall was under three
+ * pixels across a space of several hundred.
+ */
+export declare const CAPTION_SCREEN_HEIGHT: number;
+/** The captions of one scene. */
+export declare class LabelField {
+    private readonly parent;
+    private captions;
+    /** Whether captions are shown at all: the operator may want the picture bare. */
+    private shown;
+    /**
+     * @param parent - Where the captions are drawn.
+     */
+    constructor(parent: THREE.Object3D);
+    /** @returns How many captions are drawn. */
+    count(): number;
+    /**
+     * Pins a caption above a node.
+     *
+     * @param id - The node.
+     * @param text - The words.
+     * @param position - Where the node stands.
+     * @param radius - How far it reaches: the caption stands just above it.
+     * @param color - The words' colour.
+     * @param dim - Drawn faint, with its node.
+     * @param rank - Which caption wins where two meet on screen: the greater.
+     */
+    caption_add(id: string, text: string, position: THREE.Vector3, radius: number, color: THREE.Color, dim: boolean, rank?: number): void;
+    /**
+     * Shows each caption that meets no greater one on screen, and hides the
+     * rest. Cheap enough for every frame: captions are few.
+     *
+     * @param camera - The camera the space is seen through.
+     * @returns How many captions are shown.
+     */
+    declutter(camera: THREE.PerspectiveCamera): number;
+    /**
+     * Shows or hides every caption; each keeps its place and words.
+     *
+     * @param on - Shown.
+     */
+    shown_set(on: boolean): void;
+    /** @returns Whether captions are shown. */
+    shown_get(): boolean;
+    /** Forgets every caption: the scene is being redrawn (its parent already cleared). */
+    clear(): void;
+}

package/dist/draw/labelField.js

@@ -0,0 +1,149 @@
+/**
+ * @file Captions: words a surface pins to a node, drawn in the space.
+ *
+ * A hub the operator should read without hovering — "DICOM · 38", "SAG
+ * MPRAGE · 12" — carries a caption: its text drawn once on a canvas, shown
+ * as a sprite above the node, always facing the camera, one size on screen
+ * however far away. A dimmed node's caption dims with it. Where captions
+ * meet on screen the bigger node's is read and the smaller's gives way: its
+ * words are a hover away, and words drawn over words are read as neither.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+/**
+ * A caption's height on screen, as a share of the view's height: the same
+ * at any distance, so a hub is read from afar and not shouted at up close.
+ * Sized in the space instead, a caption three units tall was under three
+ * pixels across a space of several hundred.
+ */
+export const CAPTION_SCREEN_HEIGHT = 0.028;
+/** The opacity of a caption on a dimmed node. */
+const CAPTION_DIM = 0.25;
+/**
+ * The plate behind a caption's words: dark, mostly opaque, so the words
+ * read over the brightest cloud. Bare words were lost on a phone over a
+ * nebula of four hundred feeds.
+ */
+const CAPTION_PLATE = 'rgba(0, 0, 0, 0.7)';
+/** Pixels of text height on the canvas a caption is drawn on. */
+const CANVAS_TEXT_PX = 48;
+/** The captions of one scene. */
+export class LabelField {
+    parent;
+    captions = new Map();
+    /** Whether captions are shown at all: the operator may want the picture bare. */
+    shown = true;
+    /**
+     * @param parent - Where the captions are drawn.
+     */
+    constructor(parent) {
+        this.parent = parent;
+    }
+    /** @returns How many captions are drawn. */
+    count() {
+        return this.captions.size;
+    }
+    /**
+     * Pins a caption above a node.
+     *
+     * @param id - The node.
+     * @param text - The words.
+     * @param position - Where the node stands.
+     * @param radius - How far it reaches: the caption stands just above it.
+     * @param color - The words' colour.
+     * @param dim - Drawn faint, with its node.
+     * @param rank - Which caption wins where two meet on screen: the greater.
+     */
+    caption_add(id, text, position, radius, color, dim, rank = 0) {
+        const canvas = document.createElement('canvas');
+        const context = canvas.getContext('2d');
+        const font = `600 ${CANVAS_TEXT_PX}px sans-serif`;
+        let width = text.length * CANVAS_TEXT_PX * 0.6;
+        if (context !== null) {
+            context.font = font;
+            width = Math.ceil(context.measureText(text).width);
+        }
+        canvas.width = Math.max(1, width + CANVAS_TEXT_PX);
+        canvas.height = Math.round(CANVAS_TEXT_PX * 1.5);
+        if (context !== null) {
+            // A resized canvas forgets its font.
+            context.font = font;
+            context.textBaseline = 'middle';
+            const radius = canvas.height / 4;
+            context.fillStyle = CAPTION_PLATE;
+            context.beginPath();
+            context.roundRect(0, 0, canvas.width, canvas.height, radius);
+            context.fill();
+            context.fillStyle = `#${color.getHexString()}`;
+            context.fillText(text, CANVAS_TEXT_PX / 2, canvas.height / 2);
+        }
+        const texture = new THREE.CanvasTexture(canvas);
+        const material = new THREE.SpriteMaterial({ map: texture, transparent: true, depthWrite: false, depthTest: false, sizeAttenuation: false, opacity: dim ? CAPTION_DIM : 0.9 });
+        const sprite = new THREE.Sprite(material);
+        sprite.scale.set(CAPTION_SCREEN_HEIGHT * (canvas.width / canvas.height), CAPTION_SCREEN_HEIGHT, 1);
+        // Anchored at its lower edge, just above the node's reach.
+        sprite.center.set(0.5, 0);
+        sprite.position.set(position.x, position.y + radius, position.z);
+        // Over the stars and the nebulae: words are read, not glowed through.
+        sprite.renderOrder = 4;
+        // Drawn while captions are off, it stays hidden until they are on.
+        sprite.visible = this.shown;
+        this.parent.add(sprite);
+        this.captions.get(id)?.texture.dispose();
+        this.captions.set(id, { sprite, texture, rank });
+    }
+    /**
+     * Shows each caption that meets no greater one on screen, and hides the
+     * rest. Cheap enough for every frame: captions are few.
+     *
+     * @param camera - The camera the space is seen through.
+     * @returns How many captions are shown.
+     */
+    declutter(camera) {
+        if (!this.shown)
+            return 0;
+        const ordered = [...this.captions.values()].sort((a, b) => b.rank - a.rank);
+        const kept = [];
+        const at = new THREE.Vector3();
+        // A sprite not sized by distance spans its scale times the projection's.
+        const across = camera.projectionMatrix.elements[0] ?? 1;
+        const up = camera.projectionMatrix.elements[5] ?? 1;
+        for (const caption of ordered) {
+            caption.sprite.getWorldPosition(at).project(camera);
+            if (at.z > 1) {
+                caption.sprite.visible = false;
+                continue;
+            }
+            const halfWidth = (caption.sprite.scale.x * across) / 2;
+            const box = { left: at.x - halfWidth, right: at.x + halfWidth, bottom: at.y, top: at.y + caption.sprite.scale.y * up };
+            const meets = kept.some((other) => box.left < other.right && other.left < box.right && box.bottom < other.top && other.bottom < box.top);
+            caption.sprite.visible = !meets;
+            if (!meets)
+                kept.push(box);
+        }
+        return kept.length;
+    }
+    /**
+     * Shows or hides every caption; each keeps its place and words.
+     *
+     * @param on - Shown.
+     */
+    shown_set(on) {
+        this.shown = on;
+        if (!on)
+            for (const caption of this.captions.values())
+                caption.sprite.visible = false;
+    }
+    /** @returns Whether captions are shown. */
+    shown_get() {
+        return this.shown;
+    }
+    /** Forgets every caption: the scene is being redrawn (its parent already cleared). */
+    clear() {
+        for (const caption of this.captions.values())
+            caption.texture.dispose();
+        this.captions = new Map();
+    }
+}
+//# sourceMappingURL=labelField.js.map

package/dist/draw/labelField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labelField.js","sourceRoot":"","sources":["../../src/draw/labelField.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAW,KAAK,CAAC;AACnD,iDAAiD;AACjD,MAAM,WAAW,GAAW,IAAI,CAAC;AACjC;;;;GAIG;AACH,MAAM,aAAa,GAAW,oBAAoB,CAAC;AACnD,iEAAiE;AACjE,MAAM,cAAc,GAAW,EAAE,CAAC;AAkBlC,iCAAiC;AACjC,MAAM,OAAO,UAAU;IAQQ;IAPrB,QAAQ,GAAyB,IAAI,GAAG,EAAE,CAAC;IACnD,iFAAiF;IACzE,KAAK,GAAY,IAAI,CAAC;IAE9B;;OAEG;IACH,YAA6B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;IAEvD,4CAA4C;IACrC,KAAK;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;OAUG;IACI,WAAW,CAAC,EAAU,EAAE,IAAY,EAAE,QAAuB,EAAE,MAAc,EAAE,KAAkB,EAAE,GAAY,EAAE,OAAe,CAAC;QACtI,MAAM,MAAM,GAAsB,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACnE,MAAM,OAAO,GAAoC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACzE,MAAM,IAAI,GAAW,OAAO,cAAc,eAAe,CAAC;QAC1D,IAAI,KAAK,GAAW,IAAI,CAAC,MAAM,GAAG,cAAc,GAAG,GAAG,CAAC;QACvD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YACpB,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,cAAc,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC;QACjD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,qCAAqC;YACrC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YACpB,OAAO,CAAC,YAAY,GAAG,QAAQ,CAAC;YAChC,MAAM,MAAM,GAAW,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YACzC,OAAO,CAAC,SAAS,GAAG,aAAa,CAAC;YAClC,OAAO,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,SAAS,GAAG,IAAI,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;YAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,OAAO,GAAwB,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACrE,MAAM,QAAQ,GAAyB,IAAI,KAAK,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACpM,MAAM,MAAM,GAAiB,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC;QACnG,2DAA2D;QAC3D,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1B,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QACjE,sEAAsE;QACtE,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;QACvB,mEAAmE;QACnE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;OAMG;IACI,SAAS,CAAC,MAA+B;QAC9C,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC;QAC1B,MAAM,OAAO,GAAc,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAU,EAAE,CAAU,EAAU,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QACjH,MAAM,IAAI,GAAgB,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAkB,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC9C,yEAAyE;QACzE,MAAM,MAAM,GAAW,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChE,MAAM,EAAE,GAAW,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5D,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;YAC9B,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBACb,OAAO,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;gBAC/B,SAAS;YACX,CAAC;YACD,MAAM,SAAS,GAAW,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,MAAM,GAAG,GAAc,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;YAClI,MAAM,KAAK,GAAY,IAAI,CAAC,IAAI,CAAC,CAAC,KAAgB,EAAW,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACtK,OAAO,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC;YAChC,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACI,SAAS,CAAC,EAAW;QAC1B,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE;YAAE,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;gBAAE,OAAO,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;IACxF,CAAC;IAED,2CAA2C;IACpC,SAAS;QACd,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,sFAAsF;IAC/E,KAAK;QACV,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;YAAE,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACxE,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/draw/lamps.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file The lamps a replayed or running stage wears: how dark it rests, how its glow blooms, how the lot dims before the run replays.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+/** A replayed stage before its pulse lands: this share of its colour. */
+export declare const LAMP_DIM: number;
+/** How long a stage's glow blooms out and settles as its pulse lands. */
+export declare const LAMP_BLOOM_MS: number;
+/** How far the bloom reaches, in the stage's radii. */
+export declare const LAMP_BLOOM_REACH: number;
+/** How long the lit stages take to dim before the run replays. */
+export declare const LAMP_FADE_MS: number;
+/** What a lit stage brightens toward. */
+export declare const LAMP_WHITE: THREE.Color;

package/dist/draw/lamps.js

@@ -0,0 +1,17 @@
+/**
+ * @file The lamps a replayed or running stage wears: how dark it rests, how its glow blooms, how the lot dims before the run replays.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+/** A replayed stage before its pulse lands: this share of its colour. */
+export const LAMP_DIM = 0.18;
+/** How long a stage's glow blooms out and settles as its pulse lands. */
+export const LAMP_BLOOM_MS = 1000;
+/** How far the bloom reaches, in the stage's radii. */
+export const LAMP_BLOOM_REACH = 9;
+/** How long the lit stages take to dim before the run replays. */
+export const LAMP_FADE_MS = 500;
+/** What a lit stage brightens toward. */
+export const LAMP_WHITE = new THREE.Color('#ffffff');
+//# sourceMappingURL=lamps.js.map

package/dist/draw/lamps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lamps.js","sourceRoot":"","sources":["../../src/draw/lamps.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,yEAAyE;AACzE,MAAM,CAAC,MAAM,QAAQ,GAAW,IAAI,CAAC;AAErC,yEAAyE;AACzE,MAAM,CAAC,MAAM,aAAa,GAAW,IAAI,CAAC;AAE1C,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAW,CAAC,CAAC;AAE1C,kEAAkE;AAClE,MAAM,CAAC,MAAM,YAAY,GAAW,GAAG,CAAC;AAExC,yCAAyC;AACzC,MAAM,CAAC,MAAM,UAAU,GAAgB,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC"}

package/dist/draw/nebula.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file Nebulae: the soft glow a cluster wears while the scene draws stars.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+/** Draws (once) the nebula's radial glow. */
+export declare function nebulaTexture_get(): THREE.Texture;

package/dist/draw/nebula.js

@@ -0,0 +1,28 @@
+/**
+ * @file Nebulae: the soft glow a cluster wears while the scene draws stars.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+/** A soft radial glow, shared by every nebula. */
+let nebulaTexture = null;
+/** Draws (once) the nebula's radial glow. */
+export function nebulaTexture_get() {
+    if (nebulaTexture !== null)
+        return nebulaTexture;
+    const canvas = document.createElement('canvas');
+    canvas.width = 128;
+    canvas.height = 128;
+    const context = canvas.getContext('2d');
+    if (context !== null) {
+        const gradient = context.createRadialGradient(64, 64, 0, 64, 64, 64);
+        gradient.addColorStop(0, 'rgba(255,255,255,1)');
+        gradient.addColorStop(0.35, 'rgba(255,255,255,0.45)');
+        gradient.addColorStop(1, 'rgba(255,255,255,0)');
+        context.fillStyle = gradient;
+        context.fillRect(0, 0, 128, 128);
+    }
+    nebulaTexture = new THREE.CanvasTexture(canvas);
+    return nebulaTexture;
+}
+//# sourceMappingURL=nebula.js.map

package/dist/draw/nebula.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nebula.js","sourceRoot":"","sources":["../../src/draw/nebula.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,kDAAkD;AAClD,IAAI,aAAa,GAAyB,IAAI,CAAC;AAE/C,6CAA6C;AAC7C,MAAM,UAAU,iBAAiB;IAC/B,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,aAAa,CAAC;IACjD,MAAM,MAAM,GAAsB,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACnE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;IACnB,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC;IACpB,MAAM,OAAO,GAAoC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACzE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAmB,OAAO,CAAC,oBAAoB,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACrF,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;QAChD,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC;QACtD,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;QAChD,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC7B,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;IACD,aAAa,GAAG,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/draw/palette.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @file The colours a drawer is handed. orrery never reads a stylesheet:
+ * a surface reads its theme and passes the colours in.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+import type { Paint } from '../types/encoding.js';
+/**
+ * The colours of a drawing.
+ *
+ * @property running - A stage at work.
+ * @property done - A stage finished well.
+ * @property error - A stage that failed; always visible.
+ * @property template - A stage not yet run.
+ * @property unknown - A state no other colour names.
+ * @property edge - An edge between stages.
+ * @property join - An edge that joins two branches.
+ * @property root - A graph's origin.
+ * @property pulse - The wave's flare.
+ */
+export interface Palette {
+    running: THREE.Color;
+    done: THREE.Color;
+    error: THREE.Color;
+    template: THREE.Color;
+    unknown: THREE.Color;
+    edge: THREE.Color;
+    join: THREE.Color;
+    root: THREE.Color;
+    pulse: THREE.Color;
+}
+/**
+ * The colour a paint names, in a palette.
+ *
+ * @param paint - The paint.
+ * @param palette - The colours of the drawing.
+ * @returns The colour — shared for a token or a hue, fresh for a blend;
+ *   never mutate it.
+ */
+export declare function paint_resolve(paint: Paint, palette: Palette): THREE.Color;

package/dist/draw/palette.js

@@ -0,0 +1,32 @@
+/**
+ * @file The colours a drawer is handed. orrery never reads a stylesheet:
+ * a surface reads its theme and passes the colours in.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+/** Hues parsed once per distinct value: a space of thousands shares a few. */
+const hueCache = new Map();
+/**
+ * The colour a paint names, in a palette.
+ *
+ * @param paint - The paint.
+ * @param palette - The colours of the drawing.
+ * @returns The colour — shared for a token or a hue, fresh for a blend;
+ *   never mutate it.
+ */
+export function paint_resolve(paint, palette) {
+    if ('token' in paint)
+        return palette[paint.token];
+    if ('hue' in paint) {
+        let color = hueCache.get(paint.hue);
+        if (color === undefined) {
+            color = new THREE.Color(paint.hue);
+            hueCache.set(paint.hue, color);
+        }
+        return color;
+    }
+    const [from, to] = paint.blend;
+    return palette[from].clone().lerp(palette[to], Math.max(0, Math.min(1, paint.share)));
+}
+//# sourceMappingURL=palette.js.map

package/dist/draw/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.js","sourceRoot":"","sources":["../../src/draw/palette.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA4B/B,8EAA8E;AAC9E,MAAM,QAAQ,GAA6B,IAAI,GAAG,EAAE,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,OAAgB;IAC1D,IAAI,OAAO,IAAI,KAAK;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;QACnB,IAAI,KAAK,GAA4B,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACnC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;IAC/B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxF,CAAC"}

package/dist/draw/sphereField.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @file The solid spheres of a scene, the halos that mark a cluster, and
+ * the plain lines between spheres that do not wear tubes.
+ *
+ * A sphere is lit, coloured as it is handed; a dimmed one is faint scenery
+ * and takes no pointer; a selected one glows; flat, it is a disc facing the
+ * camera. Every sphere is found by its node's id.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+/**
+ * How a sphere looks.
+ *
+ * @property color - Its hue.
+ * @property dim - Faint scenery that takes no pointer.
+ * @property selected - Lit from within: the node in hand.
+ * @property flat - A disc, not a sphere (a 2D projection).
+ * @property fade - Drawn at this opacity (a molecule fading in).
+ */
+export interface SphereLook {
+    color: THREE.Color;
+    dim?: boolean;
+    selected?: boolean;
+    flat?: boolean;
+    fade?: number;
+}
+/** The solid spheres, halos and plain edges of one scene. */
+export declare class SphereField {
+    private readonly parent;
+    private readonly geometries;
+    private byId;
+    private edges;
+    /**
+     * @param parent - Where the spheres are drawn.
+     */
+    constructor(parent: THREE.Object3D);
+    /** Every drawn sphere and halo, by its node's id. */
+    get map(): Map<string, THREE.Mesh>;
+    /**
+     * Draws one sphere.
+     *
+     * @param id - Its node.
+     * @param position - Where it stands.
+     * @param radius - Its radius.
+     * @param look - How it looks.
+     * @returns The mesh.
+     */
+    sphere_add(id: string, position: THREE.Vector3, radius: number, look: SphereLook): THREE.Mesh;
+    /**
+     * Draws a cluster's halo: translucent, unlit, written last so the spheres
+     * inside it show through; picked only when nothing solid is.
+     *
+     * @param id - The cluster's anchor.
+     * @param position - Where it stands.
+     * @param radius - How far it reaches.
+     * @param color - Its hue.
+     * @param dim - Faint scenery that takes no pointer.
+     */
+    halo_add(id: string, position: THREE.Vector3, radius: number, color: THREE.Color, dim: boolean): void;
+    /**
+     * Draws a plain line between two spheres; a join is dashed.
+     *
+     * @param fromId - The parent.
+     * @param toId - The child.
+     * @param from - Where the parent stands.
+     * @param to - Where the child stands.
+     * @param color - Its hue.
+     * @param dashed - A join across branches.
+     * @param dim - Faint scenery.
+     */
+    edge_add(fromId: string, toId: string, from: THREE.Vector3, to: THREE.Vector3, color: THREE.Color, dashed: boolean, dim?: boolean): void;
+    /** Brings every plain edge to its spheres, where they stand now. */
+    edges_follow(): void;
+    /**
+     * Gives a sphere a new hue (its state changed); a lamp re-reads it.
+     *
+     * @param id - The node.
+     * @param color - Its hue now.
+     */
+    recolor(id: string, color: THREE.Color): void;
+    /**
+     * Lights the node in hand from within and every other not at all.
+     *
+     * @param selectedId - The node in hand, or null.
+     */
+    select(selectedId: string | null): void;
+    /**
+     * Lets one sphere go: its molecule is stars again.
+     *
+     * @param mesh - The sphere.
+     */
+    remove(mesh: THREE.Mesh): void;
+    /** Forgets everything: the scene is being redrawn (its parent already cleared). */
+    clear(): void;
+    /** Lets the shared geometries go: the scene is done. */
+    dispose(): void;
+}