@fnndsc/orrery 0.1.0

package/dist/draw/sphereField.js

@@ -0,0 +1,168 @@
+/**
+ * @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';
+import { DIM_OPACITY, HALO_OPACITY } from './constants.js';
+import { SphereGeometries } from './geometry.js';
+/** The solid spheres, halos and plain edges of one scene. */
+export class SphereField {
+    parent;
+    geometries = new SphereGeometries();
+    byId = new Map();
+    edges = [];
+    /**
+     * @param parent - Where the spheres are drawn.
+     */
+    constructor(parent) {
+        this.parent = parent;
+    }
+    /** Every drawn sphere and halo, by its node's id. */
+    get map() {
+        return this.byId;
+    }
+    /**
+     * 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, position, radius, look) {
+        const geometry = look.flat === true ? new THREE.CircleGeometry(radius, 36) : this.geometries.of(radius);
+        const material = new THREE.MeshStandardMaterial({
+            color: look.color,
+            roughness: 0.35,
+            metalness: 0.15,
+            emissive: look.selected === true ? new THREE.Color('#ffffff') : new THREE.Color('#000000'),
+            emissiveIntensity: look.selected === true ? 0.35 : 0,
+            ...(look.dim === true ? { transparent: true, opacity: DIM_OPACITY } : {}),
+            ...(look.fade !== undefined ? { transparent: true, opacity: look.fade } : {}),
+        });
+        const mesh = new THREE.Mesh(geometry, material);
+        mesh.position.copy(position);
+        mesh.userData['nodeId'] = id;
+        // A dimmed node is scenery: drawn behind the graph in hand, it takes no
+        // pointer, so a hover or a click never lands on the field behind.
+        mesh.userData['dim'] = look.dim === true;
+        this.parent.add(mesh);
+        this.byId.set(id, mesh);
+        return 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, position, radius, color, dim) {
+        const halo = new THREE.Mesh(new THREE.SphereGeometry(radius, 24, 18), new THREE.MeshBasicMaterial({ color, transparent: true, opacity: dim ? HALO_OPACITY * 0.4 : HALO_OPACITY, depthWrite: false }));
+        halo.position.copy(position);
+        halo.renderOrder = 1;
+        halo.userData['nodeId'] = id;
+        halo.userData['halo'] = true;
+        halo.userData['dim'] = dim;
+        this.parent.add(halo);
+        this.byId.set(id, halo);
+    }
+    /**
+     * 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, toId, from, to, color, dashed, dim = false) {
+        const geometry = new THREE.BufferGeometry().setFromPoints([from, to]);
+        let line;
+        if (dashed) {
+            line = new THREE.Line(geometry, new THREE.LineDashedMaterial({
+                color, dashSize: 0.25, gapSize: 0.18, transparent: true, opacity: dim ? DIM_OPACITY : 0.9,
+            }));
+            line.computeLineDistances();
+        }
+        else {
+            line = new THREE.Line(geometry, new THREE.LineBasicMaterial({ color, transparent: true, opacity: dim ? DIM_OPACITY : 0.75 }));
+        }
+        this.parent.add(line);
+        this.edges.push({ line, fromId, toId, dashed });
+    }
+    /** Brings every plain edge to its spheres, where they stand now. */
+    edges_follow() {
+        for (const edge of this.edges) {
+            const from = this.byId.get(edge.fromId);
+            const to = this.byId.get(edge.toId);
+            if (from === undefined || to === undefined)
+                continue;
+            edge.line.geometry.setFromPoints([from.position, to.position]);
+            if (edge.dashed)
+                edge.line.computeLineDistances();
+        }
+    }
+    /**
+     * 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, color) {
+        const mesh = this.byId.get(id);
+        if (mesh === undefined || !(mesh.material instanceof THREE.MeshStandardMaterial))
+            return;
+        mesh.material.color = color;
+        delete mesh.userData['lampBase'];
+    }
+    /**
+     * Lights the node in hand from within and every other not at all.
+     *
+     * @param selectedId - The node in hand, or null.
+     */
+    select(selectedId) {
+        for (const [id, mesh] of this.byId) {
+            if (!(mesh.material instanceof THREE.MeshStandardMaterial))
+                continue;
+            const on = id === selectedId;
+            mesh.material.emissive.set(on ? '#ffffff' : '#000000');
+            mesh.material.emissiveIntensity = on ? 0.35 : 0;
+        }
+    }
+    /**
+     * Lets one sphere go: its molecule is stars again.
+     *
+     * @param mesh - The sphere.
+     */
+    remove(mesh) {
+        this.parent.remove(mesh);
+        if (mesh.material instanceof THREE.Material)
+            mesh.material.dispose();
+        const id = mesh.userData['nodeId'];
+        if (typeof id === 'string' && this.byId.get(id) === mesh)
+            this.byId.delete(id);
+    }
+    /** Forgets everything: the scene is being redrawn (its parent already cleared). */
+    clear() {
+        this.byId = new Map();
+        this.edges = [];
+    }
+    /** Lets the shared geometries go: the scene is done. */
+    dispose() {
+        this.geometries.dispose();
+    }
+}
+//# sourceMappingURL=sphereField.js.map

package/dist/draw/sphereField.js.map

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

package/dist/draw/starField.d.ts

@@ -0,0 +1,127 @@
+/**
+ * @file The stars of a scene: every node a point of light, the threads that
+ * join them, and the nebulae that mark a cluster.
+ *
+ * A scene draws its field as stars from afar; the field holds the two
+ * layers (glow and embers), the thread lines, and the nebulae, keeps each
+ * star's slot, and lets a molecule's stars and threads fade out as the
+ * molecule turns solid and back in as it turns to stars again.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+import { type StarEntry } from './stars.js';
+/** A cluster's nebula: whose it is, where, how far it reaches. */
+export interface Nebula {
+    id: string;
+    position: THREE.Vector3;
+    radius: number;
+}
+/** The stars, threads and nebulae of one scene. */
+export declare class StarField {
+    private readonly parent;
+    private stars;
+    private index;
+    private nebulaList;
+    private materials;
+    private layers;
+    private threads;
+    /** Each nebula's sprite and resting opacity, by its cluster's id. */
+    private nebulaSprites;
+    /** Every star of a node, by id; built when first asked. */
+    private starsById;
+    private starsTouched;
+    private threadsTouched;
+    /**
+     * @param parent - Where the field is drawn.
+     */
+    constructor(parent: THREE.Object3D);
+    /** How many stars are drawn. */
+    count(): number;
+    /** Every star, in the order drawn. */
+    list(): ReadonlyArray<StarEntry>;
+    /** The first star drawn for a node, if any. */
+    entry(id: string): StarEntry | undefined;
+    /** Every node drawn as a star. */
+    ids(): IterableIterator<string>;
+    /** Every nebula. */
+    nebulae(): ReadonlyArray<Nebula>;
+    /**
+     * Draws stars as two layers — the glow, and the embers over it.
+     *
+     * @param entries - The stars.
+     * @param pixelRatio - The display's pixel ratio.
+     * @param heightPx - The canvas's height, in device pixels.
+     * @param fovDeg - The camera's vertical field of view.
+     */
+    draw(entries: StarEntry[], pixelRatio: number, heightPx: number, fovDeg: number): void;
+    /**
+     * Keeps the stars' pixel scale true to the canvas and the camera.
+     *
+     * @param heightPx - The canvas's height, in device pixels.
+     * @param fovDeg - The camera's vertical field of view.
+     */
+    scale_update(heightPx: number, fovDeg: number): void;
+    /**
+     * Draws the faint threads between stars, as one line batch.
+     *
+     * @param positions - Segment ends, six numbers a segment.
+     * @param colors - Their colours, six numbers a segment.
+     * @param ends - The nodes each segment joins, two ids a segment: a thread
+     *   shows in a replay only once both have arrived. Optional.
+     */
+    threads_draw(positions: ReadonlyArray<number>, colors: ReadonlyArray<number>, ends?: ReadonlyArray<string>): void;
+    /**
+     * A cluster's handle while the scene draws stars: a soft glow facing the
+     * camera.
+     *
+     * @param id - The cluster's anchor.
+     * @param position - Where it stands.
+     * @param radius - How far it reaches.
+     * @param color - Its hue.
+     * @param dim - Drawn at a third of its light.
+     */
+    nebula_add(id: string, position: THREE.Vector3, radius: number, color: THREE.Color, dim: boolean): void;
+    /**
+     * Fades stars to a share of their resting light (0 gone, 1 as drawn).
+     *
+     * @param entries - The stars.
+     * @param share - How much of their light they keep.
+     */
+    stars_fade(entries: ReadonlyArray<StarEntry>, share: number): void;
+    /**
+     * Fades thread segments to a share of their resting colour.
+     *
+     * @param segments - The segments, by index.
+     * @param share - How much of their colour they keep.
+     */
+    threads_fade(segments: ReadonlyArray<number>, share: number): void;
+    /** Sends this frame's fades to the screen. */
+    flush(): void;
+    /** Forgets everything: the scene is being redrawn (its parent already cleared). */
+    clear(): void;
+    /**
+     * Shows or hides nodes' stars and nebulae (a replay: 0 not yet arrived,
+     * 1 as drawn). Threads follow with {@link threads_present}.
+     *
+     * @param ids - The nodes.
+     * @param presence - How much of their resting light they keep.
+     */
+    presence_set(ids: Iterable<string>, presence: number): void;
+    /**
+     * Sets how brightly a node's stars flash (an arrival), 0 at rest.
+     *
+     * @param id - The node.
+     * @param strength - 0..1.
+     */
+    flash_set(id: string, strength: number): void;
+    /**
+     * Shows each thread whose two ends are both present, hides the rest.
+     * Threads drawn without their ends are left as they are.
+     *
+     * @param present - Whether a node is present.
+     */
+    threads_present(present: (id: string) => boolean): void;
+    /** Every star drawn for a node. */
+    private stars_of;
+}

package/dist/draw/starField.js

@@ -0,0 +1,267 @@
+/**
+ * @file The stars of a scene: every node a point of light, the threads that
+ * join them, and the nebulae that mark a cluster.
+ *
+ * A scene draws its field as stars from afar; the field holds the two
+ * layers (glow and embers), the thread lines, and the nebulae, keeps each
+ * star's slot, and lets a molecule's stars and threads fade out as the
+ * molecule turns solid and back in as it turns to stars again.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+import { NEBULA_OPACITY, THREAD_OPACITY } from './constants.js';
+import { nebulaTexture_get } from './nebula.js';
+import { starLayer_make, starScale_of } from './stars.js';
+/** The stars, threads and nebulae of one scene. */
+export class StarField {
+    parent;
+    stars = [];
+    index = new Map();
+    nebulaList = [];
+    materials = [];
+    layers = [];
+    threads = null;
+    /** Each nebula's sprite and resting opacity, by its cluster's id. */
+    nebulaSprites = new Map();
+    /** Every star of a node, by id; built when first asked. */
+    starsById = null;
+    starsTouched = false;
+    threadsTouched = false;
+    /**
+     * @param parent - Where the field is drawn.
+     */
+    constructor(parent) {
+        this.parent = parent;
+    }
+    /** How many stars are drawn. */
+    count() {
+        return this.stars.length;
+    }
+    /** Every star, in the order drawn. */
+    list() {
+        return this.stars;
+    }
+    /** The first star drawn for a node, if any. */
+    entry(id) {
+        const at = this.index.get(id);
+        return at === undefined ? undefined : this.stars[at];
+    }
+    /** Every node drawn as a star. */
+    ids() {
+        return this.index.keys();
+    }
+    /** Every nebula. */
+    nebulae() {
+        return this.nebulaList;
+    }
+    /**
+     * Draws stars as two layers — the glow, and the embers over it.
+     *
+     * @param entries - The stars.
+     * @param pixelRatio - The display's pixel ratio.
+     * @param heightPx - The canvas's height, in device pixels.
+     * @param fovDeg - The camera's vertical field of view.
+     */
+    draw(entries, pixelRatio, heightPx, fovDeg) {
+        for (const entry of entries) {
+            if (!this.index.has(entry.id))
+                this.index.set(entry.id, this.stars.length);
+            this.stars.push(entry);
+        }
+        this.starsById = null;
+        // The glow, the embers over it, and rings (stars of another kind) over both.
+        for (const [ember, ring] of [[false, false], [true, false], [false, true]]) {
+            const layer = entries.filter((entry) => (entry.ring === true) === ring && (ring || entry.ember === ember));
+            if (layer.length === 0)
+                continue;
+            const drawn = starLayer_make(layer, ember, this.layers.length, pixelRatio, ring);
+            this.layers.push({ alpha: drawn.alpha, base: drawn.base, flash: drawn.flash });
+            this.parent.add(drawn.points);
+            this.materials.push(drawn.material);
+        }
+        this.scale_update(heightPx, fovDeg);
+    }
+    /**
+     * Keeps the stars' pixel scale true to the canvas and the camera.
+     *
+     * @param heightPx - The canvas's height, in device pixels.
+     * @param fovDeg - The camera's vertical field of view.
+     */
+    scale_update(heightPx, fovDeg) {
+        if (this.materials.length === 0)
+            return;
+        const scale = starScale_of(heightPx, fovDeg);
+        for (const material of this.materials) {
+            const uniform = material.uniforms['scale'];
+            if (uniform !== undefined)
+                uniform.value = scale;
+        }
+    }
+    /**
+     * Draws the faint threads between stars, as one line batch.
+     *
+     * @param positions - Segment ends, six numbers a segment.
+     * @param colors - Their colours, six numbers a segment.
+     * @param ends - The nodes each segment joins, two ids a segment: a thread
+     *   shows in a replay only once both have arrived. Optional.
+     */
+    threads_draw(positions, colors, ends = []) {
+        if (positions.length === 0)
+            return;
+        const geometry = new THREE.BufferGeometry();
+        geometry.setAttribute('position', new THREE.Float32BufferAttribute(positions, 3));
+        const attribute = new THREE.Float32BufferAttribute(colors, 3);
+        geometry.setAttribute('color', attribute);
+        this.threads = { attribute, base: Float32Array.from(colors), ends };
+        this.parent.add(new THREE.LineSegments(geometry, new THREE.LineBasicMaterial({
+            vertexColors: true, transparent: true, opacity: THREAD_OPACITY, blending: THREE.AdditiveBlending, depthWrite: false,
+        })));
+    }
+    /**
+     * A cluster's handle while the scene draws stars: a soft glow facing the
+     * camera.
+     *
+     * @param id - The cluster's anchor.
+     * @param position - Where it stands.
+     * @param radius - How far it reaches.
+     * @param color - Its hue.
+     * @param dim - Drawn at a third of its light.
+     */
+    nebula_add(id, position, radius, color, dim) {
+        const sprite = new THREE.Sprite(new THREE.SpriteMaterial({
+            map: nebulaTexture_get(),
+            color,
+            transparent: true,
+            opacity: dim ? NEBULA_OPACITY / 3 : NEBULA_OPACITY,
+            blending: THREE.AdditiveBlending,
+            depthWrite: false,
+        }));
+        sprite.position.copy(position);
+        sprite.scale.setScalar(radius * 2);
+        sprite.renderOrder = 0;
+        this.parent.add(sprite);
+        this.nebulaList.push({ id, position: position.clone(), radius });
+        this.nebulaSprites.set(id, { material: sprite.material, base: sprite.material.opacity });
+    }
+    /**
+     * Fades stars to a share of their resting light (0 gone, 1 as drawn).
+     *
+     * @param entries - The stars.
+     * @param share - How much of their light they keep.
+     */
+    stars_fade(entries, share) {
+        for (const entry of entries) {
+            const layer = entry.layer === undefined ? undefined : this.layers[entry.layer];
+            if (layer === undefined || entry.slot === undefined)
+                continue;
+            layer.alpha.setX(entry.slot, (layer.base[entry.slot] ?? 1) * share);
+            this.starsTouched = true;
+        }
+    }
+    /**
+     * Fades thread segments to a share of their resting colour.
+     *
+     * @param segments - The segments, by index.
+     * @param share - How much of their colour they keep.
+     */
+    threads_fade(segments, share) {
+        if (this.threads === null || segments.length === 0)
+            return;
+        const colors = this.threads.attribute.array;
+        const base = this.threads.base;
+        for (const segment of segments) {
+            for (let k = segment * 6; k < segment * 6 + 6; k++)
+                colors[k] = (base[k] ?? 0) * share;
+        }
+        this.threadsTouched = true;
+    }
+    /** Sends this frame's fades to the screen. */
+    flush() {
+        if (this.starsTouched)
+            for (const layer of this.layers)
+                layer.alpha.needsUpdate = true;
+        if (this.threadsTouched && this.threads !== null)
+            this.threads.attribute.needsUpdate = true;
+        this.starsTouched = false;
+        this.threadsTouched = false;
+    }
+    /** Forgets everything: the scene is being redrawn (its parent already cleared). */
+    clear() {
+        this.stars = [];
+        this.index = new Map();
+        this.nebulaList = [];
+        this.materials = [];
+        this.layers = [];
+        this.threads = null;
+        this.nebulaSprites = new Map();
+        this.starsById = null;
+        this.starsTouched = false;
+        this.threadsTouched = false;
+    }
+    /**
+     * Shows or hides nodes' stars and nebulae (a replay: 0 not yet arrived,
+     * 1 as drawn). Threads follow with {@link threads_present}.
+     *
+     * @param ids - The nodes.
+     * @param presence - How much of their resting light they keep.
+     */
+    presence_set(ids, presence) {
+        for (const id of ids) {
+            for (const entry of this.stars_of(id)) {
+                const layer = entry.layer === undefined ? undefined : this.layers[entry.layer];
+                if (layer === undefined || entry.slot === undefined)
+                    continue;
+                layer.alpha.setX(entry.slot, (layer.base[entry.slot] ?? 1) * presence);
+                this.starsTouched = true;
+            }
+            const nebula = this.nebulaSprites.get(id);
+            if (nebula !== undefined)
+                nebula.material.opacity = nebula.base * presence;
+        }
+    }
+    /**
+     * Sets how brightly a node's stars flash (an arrival), 0 at rest.
+     *
+     * @param id - The node.
+     * @param strength - 0..1.
+     */
+    flash_set(id, strength) {
+        for (const entry of this.stars_of(id)) {
+            const layer = entry.layer === undefined ? undefined : this.layers[entry.layer];
+            if (layer === undefined || entry.slot === undefined)
+                continue;
+            layer.flash.setX(entry.slot, strength);
+            layer.flash.needsUpdate = true;
+        }
+    }
+    /**
+     * Shows each thread whose two ends are both present, hides the rest.
+     * Threads drawn without their ends are left as they are.
+     *
+     * @param present - Whether a node is present.
+     */
+    threads_present(present) {
+        const threads = this.threads;
+        if (threads === null || threads.ends.length === 0)
+            return;
+        const colors = threads.attribute.array;
+        const segments = threads.ends.length / 2;
+        for (let segment = 0; segment < segments; segment++) {
+            const shown = present(threads.ends[segment * 2] ?? '') && present(threads.ends[segment * 2 + 1] ?? '') ? 1 : 0;
+            for (let k = segment * 6; k < segment * 6 + 6; k++)
+                colors[k] = (threads.base[k] ?? 0) * shown;
+        }
+        this.threadsTouched = true;
+    }
+    /** Every star drawn for a node. */
+    stars_of(id) {
+        if (this.starsById === null) {
+            this.starsById = new Map();
+            for (const entry of this.stars)
+                this.starsById.set(entry.id, [...(this.starsById.get(entry.id) ?? []), entry]);
+        }
+        return this.starsById.get(id) ?? [];
+    }
+}
+//# sourceMappingURL=starField.js.map

package/dist/draw/starField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starField.js","sourceRoot":"","sources":["../../src/draw/starField.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAkC,MAAM,YAAY,CAAC;AAS1F,mDAAmD;AACnD,MAAM,OAAO,SAAS;IACH,MAAM,CAAiB;IAChC,KAAK,GAAgB,EAAE,CAAC;IACxB,KAAK,GAAwB,IAAI,GAAG,EAAE,CAAC;IACvC,UAAU,GAAa,EAAE,CAAC;IAC1B,SAAS,GAA2B,EAAE,CAAC;IACvC,MAAM,GAA8F,EAAE,CAAC;IACvG,OAAO,GAAiG,IAAI,CAAC;IACrH,qEAAqE;IAC7D,aAAa,GAAkE,IAAI,GAAG,EAAE,CAAC;IACjG,2DAA2D;IACnD,SAAS,GAAoC,IAAI,CAAC;IAClD,YAAY,GAAY,KAAK,CAAC;IAC9B,cAAc,GAAY,KAAK,CAAC;IAExC;;OAEG;IACH,YAAY,MAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,gCAAgC;IACzB,KAAK;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,sCAAsC;IAC/B,IAAI;QACT,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,+CAA+C;IACxC,KAAK,CAAC,EAAU;QACrB,MAAM,EAAE,GAAuB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClD,OAAO,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,kCAAkC;IAC3B,GAAG;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,oBAAoB;IACb,OAAO;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACI,IAAI,CAAC,OAAoB,EAAE,UAAkB,EAAE,QAAgB,EAAE,MAAc;QACpF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC3E,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,6EAA6E;QAC7E,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAU,EAAE,CAAC;YACpF,MAAM,KAAK,GAAgB,OAAO,CAAC,MAAM,CAAC,CAAC,KAAgB,EAAW,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC;YAC5I,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACjC,MAAM,KAAK,GAAc,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;YAC5F,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/E,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACI,YAAY,CAAC,QAAgB,EAAE,MAAc;QAClD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACxC,MAAM,KAAK,GAAW,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACrD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QACnD,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACI,YAAY,CAAC,SAAgC,EAAE,MAA6B,EAAE,OAA8B,EAAE;QACnH,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACnC,MAAM,QAAQ,GAAyB,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QAClE,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,KAAK,CAAC,sBAAsB,CAAC,SAAqB,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9F,MAAM,SAAS,GAAiC,IAAI,KAAK,CAAC,sBAAsB,CAAC,MAAkB,EAAE,CAAC,CAAC,CAAC;QACxG,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,KAAK,CAAC,iBAAiB,CAAC;YAC3E,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,CAAC,gBAAgB,EAAE,UAAU,EAAE,KAAK;SACpH,CAAC,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;OASG;IACI,UAAU,CAAC,EAAU,EAAE,QAAuB,EAAE,MAAc,EAAE,KAAkB,EAAE,GAAY;QACrG,MAAM,MAAM,GAAiB,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC;YACrE,GAAG,EAAE,iBAAiB,EAAE;YACxB,KAAK;YACL,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc;YAClD,QAAQ,EAAE,KAAK,CAAC,gBAAgB;YAChC,UAAU,EAAE,KAAK;SAClB,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;OAKG;IACI,UAAU,CAAC,OAAiC,EAAE,KAAa;QAChE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC/E,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;gBAAE,SAAS;YAC9D,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;YACpE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,YAAY,CAAC,QAA+B,EAAE,KAAa;QAChE,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAqB,CAAC;QAC5D,MAAM,IAAI,GAAiB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAC7C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,KAAK,IAAI,CAAC,GAAG,OAAO,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;gBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;QACzF,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,8CAA8C;IACvC,KAAK;QACV,IAAI,IAAI,CAAC,YAAY;YAAE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;gBAAE,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QACvF,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;YAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5F,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED,mFAAmF;IAC5E,KAAK;QACV,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACI,YAAY,CAAC,GAAqB,EAAE,QAAgB;QACzD,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;gBACtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC/E,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;oBAAE,SAAS;gBAC9D,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;gBACvE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YAC3B,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1C,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;QAC7E,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,SAAS,CAAC,EAAU,EAAE,QAAgB;QAC3C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC/E,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;gBAAE,SAAS;YAC9D,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACvC,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QACjC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,eAAe,CAAC,OAAgC;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,KAAqB,CAAC;QACvD,MAAM,QAAQ,GAAW,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACjD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;YACpD,MAAM,KAAK,GAAW,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvH,KAAK,IAAI,CAAC,GAAG,OAAO,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;gBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;QACjG,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,mCAAmC;IAC3B,QAAQ,CAAC,EAAU;QACzB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;YAC3B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACjH,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC;CACF"}

package/dist/draw/stars.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @file Stars: every node a point of light, sized true to the sphere it stands for. Error-free stars glow additively; a star with any errored share is drawn solid over the glow, so failure always shows through.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+/** A star's smallest size on screen, in CSS pixels: no node ever vanishes. */
+export declare const STAR_FLOOR_PX: number;
+/** A star never swells past this many CSS pixels: near the camera a feed is spheres, not a glow. */
+export declare const STAR_CAP_PX: number;
+/** A star's sprite spans this many times its sphere's diameter: core plus glow. */
+export declare const STAR_GLOW: number;
+export declare const STAR_VERTEX: string;
+/** The glow: a bright core falling off to nothing at the sprite's edge. */
+export declare const STAR_FRAGMENT_GLOW: string;
+/**
+ * The ring: a star of another kind — a thin bright circle round a small
+ * core, so a plugin reads apart from the feeds around it.
+ */
+export declare const STAR_FRAGMENT_RING: string;
+/** The ember: an errored star drawn solid over the glow, so red stays red. */
+export declare const STAR_FRAGMENT_EMBER: string;
+/** One star as drawn: whose it is, where, how big, its hue, whether dim, whether errored. */
+export interface StarEntry {
+    id: string;
+    position: THREE.Vector3;
+    radius: number;
+    color: THREE.Color;
+    dim: boolean;
+    ember: boolean;
+    /** Drawn as a ring: a star of another kind. */
+    ring?: boolean;
+    /** Which layer draws it (0 glow, 1 ember) and its slot there, once drawn. */
+    layer?: number;
+    slot?: number;
+}
+/** One drawn layer of stars: its points, its material, and its alphas as drawn and as they rest. */
+export interface StarLayer {
+    points: THREE.Points;
+    material: THREE.ShaderMaterial;
+    alpha: THREE.BufferAttribute;
+    base: Float32Array;
+    /** How brightly each star flashes, 0 at rest. */
+    flash: THREE.BufferAttribute;
+}
+/**
+ * Builds one layer of stars — the glow or the embers — as one draw call.
+ * Each entry learns its slot in the layer.
+ *
+ * @param entries - The layer's stars.
+ * @param ember - Whether this is the ember layer (drawn solid, over the glow).
+ * @param layerIndex - The layer's index, recorded on each entry.
+ * @param pixelRatio - The display's pixel ratio, for the size floor and cap.
+ * @returns The layer, not yet added to anything.
+ */
+export declare function starLayer_make(entries: ReadonlyArray<StarEntry>, ember: boolean, layerIndex: number, pixelRatio: number, ring?: boolean): StarLayer;
+/**
+ * The stars' pixel scale for a canvas and a camera: pixels per unit of size
+ * at unit depth.
+ *
+ * @param heightPx - The canvas's height in device pixels.
+ * @param fovDeg - The camera's vertical field of view, in degrees.
+ * @returns The scale the star shader multiplies by.
+ */
+export declare function starScale_of(heightPx: number, fovDeg: number): number;