@fnndsc/orrery 0.1.0

package/dist/controls/gestures.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @file Pointer gestures: a mouse, a pen and fingers, read as intents.
+ *
+ * The canvas hears raw pointer events; the rig and the scene want intents.
+ * This sits between and keeps every piece of pointer state in one place:
+ *
+ * - a press on empty space begins a VIEW DRAG — an orbit, or a pan with
+ *   shift or the right or middle button (always a pan in a flat view);
+ * - a press the scene takes as a GRAB (a node under the pointer) is handed
+ *   back to it, move by move, until the release;
+ * - two FINGERS steer the camera together — spreading closes in, pinching
+ *   draws back, the pair moving together pans — and the finger left when
+ *   one lifts neither orbits nor taps;
+ * - a click SELECTS, a double click ACTIVATES; a finger has no double click
+ *   it can count on, so two taps close in time and place are one;
+ * - the click that ends a drag, a pull or a gesture is its release, never a
+ *   select;
+ * - the wheel dollies.
+ *
+ * What lies under the pointer, what a grab moves, and what a tip says are
+ * the scene's; this knows only pointers.
+ *
+ * @module
+ */
+import type { CameraRig } from './cameraRig.js';
+/** Screen travel past which a press becomes a drag. */
+export declare const DRAG_THRESHOLD_PX: number;
+/** Two taps this close in time are a double tap. */
+export declare const DOUBLE_TAP_MS: number;
+/** Two taps this close in place are a double tap. */
+export declare const DOUBLE_TAP_PX: number;
+/**
+ * What the gestures hand back to the scene that owns the canvas.
+ *
+ * @property grab_begin - A press landed where no gesture holds the camera:
+ *   return true when it took hold of something, and its moves come here.
+ * @property grab_move - The pointer moved while holding.
+ * @property grab_end - The hold let go: return whether it had moved, so its
+ *   click is swallowed.
+ * @property hover - The pointer moved over the field with nothing held.
+ * @property leave - The pointer left the field.
+ * @property tap - A click or a tap: `select`, or `activate` on a double.
+ * @property tip_hide - A press or a gesture began; whatever names the thing
+ *   under the pointer is out of date.
+ * @property gesture_end - The last finger of a two-finger gesture lifted:
+ *   the camera stands where the fingers left it. Optional — a scene that
+ *   reads nothing into a finished pinch leaves it out.
+ */
+export interface GestureTarget {
+    grab_begin(event: PointerEvent): boolean;
+    grab_move(event: PointerEvent): void;
+    grab_end(): boolean;
+    hover(event: PointerEvent): void;
+    leave(event: PointerEvent): void;
+    tap(event: MouseEvent, kind: 'select' | 'activate'): void;
+    tip_hide(): void;
+    gesture_end?(): void;
+}
+/**
+ * How the view is steered, read at the moment it is.
+ *
+ * @property flat - The view is flat: a drag pans, never orbits.
+ * @property untethered - The camera is parked off the focus (a place, not
+ *   a thing): the dolly runs down the eye ray, and a pinch does not pan.
+ */
+export interface GestureMode {
+    flat(): boolean;
+    untethered(): boolean;
+}
+/**
+ * The pointer's intents on one canvas.
+ */
+export declare class PointerGestures {
+    private readonly element;
+    private readonly rig;
+    private readonly target;
+    private readonly mode;
+    private readonly clock;
+    private readonly touches;
+    private pinch;
+    private gestureHeld;
+    private lastTap;
+    private kind;
+    private tapActivatedAt;
+    private suppressClick;
+    private viewDrag;
+    private grabbing;
+    private over;
+    private readonly detachers;
+    /**
+     * @param element - The canvas; its touch action is taken from the page.
+     * @param rig - The camera the view gestures steer.
+     * @param target - The scene's side of each gesture.
+     * @param mode - How the view is steered right now.
+     * @param clock - Wall-clock milliseconds; `Date.now` unless a test drives time.
+     */
+    constructor(element: HTMLElement, rig: CameraRig, target: GestureTarget, mode: GestureMode, clock?: () => number);
+    /** @returns Whether the pointer is over the field: the idle spin waits while it is. */
+    pointerOver(): boolean;
+    /** @returns What the last press was made with: `mouse`, `pen` or `touch`. */
+    pressKind(): string;
+    /** @returns How many fingers are down. */
+    fingersDown(): number;
+    /** Stops listening. */
+    detach(): void;
+    private listen;
+    private click_handle;
+    private down_handle;
+    private up_handle;
+    private move_handle;
+    private hover;
+    /**
+     * A press touches the space: the idle spin pauses exactly where it is —
+     * never a snap — and what follows depends on what was under the pointer.
+     */
+    private press;
+    /** Lets go of whatever a press began: a view drag, or the scene's grab. */
+    private release;
+    /** Steers the view from an empty-space drag: orbit, or pan. */
+    private view_move;
+    /** The two fingers down: their spread and their middle. */
+    private fingers_read;
+    /**
+     * A second finger lands: whatever the first began — a pull, an orbit —
+     * lets go, and the two steer the camera together until they lift.
+     */
+    private gesture_begin;
+    /**
+     * Two fingers move: spreading closes in and pinching draws back, as the
+     * wheel does, and the pair moving together pans.
+     */
+    private gesture_move;
+}

package/dist/controls/gestures.js

@@ -0,0 +1,282 @@
+/** Screen travel past which a press becomes a drag. */
+export const DRAG_THRESHOLD_PX = 4;
+/** Two taps this close in time are a double tap. */
+export const DOUBLE_TAP_MS = 350;
+/** Two taps this close in place are a double tap. */
+export const DOUBLE_TAP_PX = 30;
+/** A browser's own dblclick this soon after a double tap is the same act. */
+const TAP_DBLCLICK_ECHO_MS = 600;
+/** How long the lift that ends a gesture keeps swallowing its click. */
+const GESTURE_LIFT_MS = 400;
+/**
+ * The pointer's intents on one canvas.
+ */
+export class PointerGestures {
+    element;
+    rig;
+    target;
+    mode;
+    clock;
+    touches = new Map();
+    pinch = null;
+    gestureHeld = false;
+    lastTap = null;
+    kind = 'mouse';
+    tapActivatedAt = 0;
+    suppressClick = false;
+    viewDrag = null;
+    grabbing = false;
+    over = false;
+    detachers = [];
+    /**
+     * @param element - The canvas; its touch action is taken from the page.
+     * @param rig - The camera the view gestures steer.
+     * @param target - The scene's side of each gesture.
+     * @param mode - How the view is steered right now.
+     * @param clock - Wall-clock milliseconds; `Date.now` unless a test drives time.
+     */
+    constructor(element, rig, target, mode, clock = Date.now) {
+        this.element = element;
+        this.rig = rig;
+        this.target = target;
+        this.mode = mode;
+        this.clock = clock;
+        // Fingers belong to the scene, not the page: without this the browser
+        // takes a pinch for a page zoom and a drag for a scroll.
+        element.style.touchAction = 'none';
+        this.listen('click', (event) => this.click_handle(event));
+        this.listen('dblclick', (event) => {
+            if (this.clock() - this.tapActivatedAt < TAP_DBLCLICK_ECHO_MS)
+                return;
+            this.target.tap(event, 'activate');
+        });
+        this.listen('pointerdown', (event) => this.down_handle(event));
+        this.listen('pointerup', (event) => this.up_handle(event));
+        this.listen('pointercancel', (event) => this.up_handle(event));
+        this.listen('pointermove', (event) => this.move_handle(event));
+        this.listen('pointerleave', (event) => {
+            this.over = false;
+            this.target.leave(event);
+        });
+        // The wheel dollies: closer to read a dense graph, back for the whole.
+        this.listen('wheel', (event) => {
+            event.preventDefault();
+            this.rig.dolly(event.deltaY, this.mode.untethered());
+        }, { passive: false });
+        // Right-drag pans; the browser's menu would eat the gesture.
+        this.listen('contextmenu', (event) => event.preventDefault());
+    }
+    /** @returns Whether the pointer is over the field: the idle spin waits while it is. */
+    pointerOver() {
+        return this.over;
+    }
+    /** @returns What the last press was made with: `mouse`, `pen` or `touch`. */
+    pressKind() {
+        return this.kind;
+    }
+    /** @returns How many fingers are down. */
+    fingersDown() {
+        return this.touches.size;
+    }
+    /** Stops listening. */
+    detach() {
+        for (const off of this.detachers.splice(0))
+            off();
+    }
+    listen(name, handler, options) {
+        this.element.addEventListener(name, handler, options);
+        this.detachers.push(() => this.element.removeEventListener(name, handler, options));
+    }
+    click_handle(event) {
+        // The click that ends a pull, a view drag or a gesture is its release.
+        if (this.suppressClick) {
+            this.suppressClick = false;
+            return;
+        }
+        if (this.kind === 'touch') {
+            const now = this.clock();
+            const last = this.lastTap;
+            if (last !== null && now - last.at <= DOUBLE_TAP_MS && Math.hypot(event.clientX - last.x, event.clientY - last.y) <= DOUBLE_TAP_PX) {
+                this.lastTap = null;
+                this.tapActivatedAt = now;
+                this.target.tap(event, 'activate');
+                return;
+            }
+            this.lastTap = { at: now, x: event.clientX, y: event.clientY };
+        }
+        this.target.tap(event, 'select');
+    }
+    down_handle(event) {
+        this.kind = event.pointerType;
+        if (event.pointerType === 'touch') {
+            // The first finger of a new touch starts clean: a lift the browser
+            // never reported (a cancelled gesture, a system swipe) must not leave
+            // a phantom finger that turns every later tap into a third.
+            if (event.isPrimary) {
+                this.touches.clear();
+                this.pinch = null;
+                this.gestureHeld = false;
+            }
+            this.touches.set(event.pointerId, { x: event.clientX, y: event.clientY });
+            if (this.touches.size === 2) {
+                this.gesture_begin();
+                return;
+            }
+            if (this.touches.size > 2 || this.gestureHeld)
+                return;
+            this.press(event);
+            // No hover under a finger: the press names what it landed on — after
+            // the press, which clears the tip a cursor leaves behind.
+            this.hover(event);
+            return;
+        }
+        this.press(event);
+    }
+    up_handle(event) {
+        if (event.pointerType === 'touch') {
+            this.touches.delete(event.pointerId);
+            if (this.touches.size < 2)
+                this.pinch = null;
+            if (this.touches.size === 0 && this.gestureHeld) {
+                this.gestureHeld = false;
+                // The lift that ends a gesture is not a tap.
+                this.suppressClick = true;
+                setTimeout(() => { this.suppressClick = false; }, GESTURE_LIFT_MS);
+                this.release();
+                this.target.gesture_end?.();
+                return;
+            }
+        }
+        this.release();
+    }
+    move_handle(event) {
+        if (event.pointerType === 'touch' && this.touches.has(event.pointerId)) {
+            this.touches.set(event.pointerId, { x: event.clientX, y: event.clientY });
+            if (this.pinch !== null) {
+                this.gesture_move();
+                return;
+            }
+            if (this.gestureHeld)
+                return;
+        }
+        if (this.grabbing) {
+            this.target.grab_move(event);
+        }
+        else if (this.viewDrag !== null) {
+            this.view_move(event);
+        }
+        else {
+            this.hover(event);
+        }
+    }
+    hover(event) {
+        // The space holds still while the pointer is over it: a target that
+        // turns under the cursor is a click on a neighbour.
+        this.over = true;
+        this.target.hover(event);
+    }
+    /**
+     * A press touches the space: the idle spin pauses exactly where it is —
+     * never a snap — and what follows depends on what was under the pointer.
+     */
+    press(event) {
+        if (this.rig.holding_get() || this.rig.flying())
+            return;
+        this.rig.spin_pause();
+        if (this.target.grab_begin(event)) {
+            this.grabbing = true;
+        }
+        else {
+            this.viewDrag = {
+                lastX: event.clientX,
+                lastY: event.clientY,
+                startX: event.clientX,
+                startY: event.clientY,
+                pan: event.shiftKey || event.button === 2 || event.button === 1,
+                moved: false,
+            };
+        }
+        try {
+            this.element.setPointerCapture(event.pointerId);
+        }
+        catch {
+            // A capture refusal (synthetic events, a vanished pointer) only costs
+            // drag continuity outside the canvas.
+        }
+        this.target.tip_hide();
+    }
+    /** Lets go of whatever a press began: a view drag, or the scene's grab. */
+    release() {
+        if (this.viewDrag !== null) {
+            if (this.viewDrag.moved)
+                this.suppressClick = true;
+            this.viewDrag = null;
+            this.rig.spin_pause();
+        }
+        if (!this.grabbing)
+            return;
+        this.grabbing = false;
+        this.rig.spin_pause();
+        if (this.target.grab_end())
+            this.suppressClick = true;
+    }
+    /** Steers the view from an empty-space drag: orbit, or pan. */
+    view_move(event) {
+        const drag = this.viewDrag;
+        if (drag === null)
+            return;
+        this.rig.spin_pause();
+        const dx = event.clientX - drag.lastX;
+        const dy = event.clientY - drag.lastY;
+        drag.lastX = event.clientX;
+        drag.lastY = event.clientY;
+        if (!drag.moved && Math.abs(event.clientX - drag.startX) + Math.abs(event.clientY - drag.startY) > DRAG_THRESHOLD_PX) {
+            drag.moved = true;
+            this.rig.touch_note();
+        }
+        if (!drag.moved)
+            return;
+        if (drag.pan || this.mode.flat()) {
+            this.rig.pan(dx, dy);
+        }
+        else {
+            this.rig.orbit(dx, dy);
+        }
+    }
+    /** The two fingers down: their spread and their middle. */
+    fingers_read() {
+        const [a, b] = [...this.touches.values()];
+        if (a === undefined || b === undefined)
+            return null;
+        return { spread: Math.hypot(a.x - b.x, a.y - b.y), midX: (a.x + b.x) / 2, midY: (a.y + b.y) / 2 };
+    }
+    /**
+     * A second finger lands: whatever the first began — a pull, an orbit —
+     * lets go, and the two steer the camera together until they lift.
+     */
+    gesture_begin() {
+        this.release();
+        this.gestureHeld = true;
+        this.pinch = this.fingers_read();
+        this.rig.spin_pause();
+        this.target.tip_hide();
+    }
+    /**
+     * Two fingers move: spreading closes in and pinching draws back, as the
+     * wheel does, and the pair moving together pans.
+     */
+    gesture_move() {
+        const now = this.fingers_read();
+        if (now === null || this.pinch === null)
+            return;
+        if (now.spread > 0 && this.pinch.spread > 0) {
+            // The spread's ratio is the zoom, in the wheel's own units, so a
+            // pinch and a wheel travel the same.
+            this.rig.dolly(Math.log(this.pinch.spread / now.spread) / 0.001, this.mode.untethered());
+        }
+        if (this.mode.flat() || !this.mode.untethered())
+            this.rig.pan(now.midX - this.pinch.midX, now.midY - this.pinch.midY);
+        this.pinch = now;
+    }
+}
+//# sourceMappingURL=gestures.js.map

package/dist/controls/gestures.js.map

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

package/dist/controls/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @file The controls layer's public face: what steers the view.
+ *
+ * @module
+ */
+export * from './cameraRig.js';
+export * from './gestures.js';
+export * from './picker.js';
+export * from './replay.js';

package/dist/controls/index.js

@@ -0,0 +1,10 @@
+/**
+ * @file The controls layer's public face: what steers the view.
+ *
+ * @module
+ */
+export * from './cameraRig.js';
+export * from './gestures.js';
+export * from './picker.js';
+export * from './replay.js';
+//# sourceMappingURL=index.js.map

package/dist/controls/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/controls/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/controls/picker.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @file Picking: what lies under a pointer, however it is drawn.
+ *
+ * The drawers keep what they draw; the picker asks the scene for it as
+ * plain sources — meshes, stars and nebulae as points with a reach, a
+ * census that picks by ray — and answers with an id. In order: a solid
+ * sphere wins (an entered feed stands as spheres among stars), then a
+ * census member, then the nearest star within its drawn size, then a
+ * nebula the pointer is inside. A dimmed thing is scenery and takes no
+ * pointer; a halo wrapping a cluster is taken only when nothing solid lies
+ * along the ray.
+ *
+ * @module
+ */
+import * as THREE from 'three';
+/** A fingertip is wider than a cursor: the least a star reaches for one. */
+export declare const TOUCH_REACH_PX: number;
+/** The least a star reaches for a cursor. */
+export declare const CURSOR_REACH_PX: number;
+/** A star as picking needs it: in the world group's own space. */
+export interface PickStar {
+    id: string;
+    position: THREE.Vector3;
+    radius: number;
+    dim: boolean;
+}
+/** A nebula as picking needs it: in the world group's own space. */
+export interface PickNebula {
+    id: string;
+    position: THREE.Vector3;
+    radius: number;
+}
+/**
+ * What can be picked, asked for at the moment of the pick.
+ *
+ * @property meshes - Solid spheres; each names its node in `userData.nodeId`
+ *   and may be marked `dim` or `halo`.
+ * @property stars - Points of light.
+ * @property nebulae - Glows a pointer can be inside.
+ * @property census - A census that picks by ray, or null when none stands.
+ */
+export interface PickSources {
+    meshes(): Iterable<THREE.Object3D>;
+    stars(): Iterable<PickStar>;
+    nebulae(): Iterable<PickNebula>;
+    census(): {
+        pick(raycaster: THREE.Raycaster): string | null;
+    } | null;
+}
+/** A pointer's place on the page. */
+export interface PointerAt {
+    clientX: number;
+    clientY: number;
+}
+/**
+ * Finds what lies under a pointer.
+ */
+export declare class Picker {
+    private readonly camera;
+    private readonly world;
+    private readonly element;
+    private readonly sources;
+    private readonly starGlow;
+    private readonly raycaster;
+    /**
+     * @param camera - The eye.
+     * @param world - The group every drawer hangs from.
+     * @param element - The canvas, for where a pointer falls on it.
+     * @param sources - What can be picked.
+     * @param starGlow - How far a star's glow reaches, in radii: its drawn size.
+     */
+    constructor(camera: THREE.PerspectiveCamera, world: THREE.Object3D, element: {
+        getBoundingClientRect(): DOMRect;
+    }, sources: PickSources, starGlow: number);
+    /**
+     * Aims the ray from the eye through the pointer, the world current.
+     *
+     * @param at - The pointer.
+     * @returns The aimed raycaster (shared: read it before the next aim).
+     */
+    ray_aim(at: PointerAt): THREE.Raycaster;
+    /**
+     * The solid sphere under the pointer. A halo wraps its cluster, so its
+     * surface is hit before the spheres inside it: a solid hit anywhere along
+     * the ray wins, the halo only when nothing solid is.
+     *
+     * @param at - The pointer.
+     * @returns The mesh, or null.
+     */
+    mesh_under(at: PointerAt): THREE.Mesh | null;
+    /**
+     * The node behind the solid sphere under the pointer.
+     *
+     * @param at - The pointer.
+     * @returns Its id, or null.
+     */
+    meshNode_under(at: PointerAt): string | null;
+    /**
+     * The node under the pointer, however it is drawn: a solid sphere, a
+     * census member, or a star (or nebula) when nothing solid is.
+     *
+     * @param at - The pointer.
+     * @param touch - Whether a finger is asking: a star reaches farther for one.
+     * @returns Its id, or null.
+     */
+    node_under(at: PointerAt, touch: boolean): string | null;
+    /**
+     * The star — or, over no star, the nebula — under the pointer, picked in
+     * screen space: a star is hit within its drawn size (never less than a
+     * few pixels, more for a finger), the nearest centre for its size wins.
+     *
+     * @param at - The pointer.
+     * @param touch - Whether a finger is asking.
+     * @returns Its id, or null.
+     */
+    star_under(at: PointerAt, touch: boolean): string | null;
+}