@react-x11/components 0.9.0 → 0.11.0

package/dist/flow/gl/index.js

@@ -0,0 +1,283 @@
+// The GL renderer's entry: what `<Flow>` loads, by dynamic import, when it is
+// asked to draw through GL — and only then. A static import anywhere under
+// `<Flow>` would put the shaders and the packer into every bundle that draws
+// a graph; `test/treeshake.test.ts` holds it to that, as it holds `<Map>`.
+//
+// What is here is the surface: a `<glarea>` laid over the pane, drawing the
+// pane's own scene every frame it is asked for one. It owns no graph and no
+// input. The `<flowgraph>` element under it keeps both — the hit test skips a
+// surface and answers with the node behind it, which is the pane — and asks
+// for frames through `setGlRequest`, so every change the 2D renderer would
+// have repainted becomes one GL frame.
+import React, { useEffect, useMemo } from 'react';
+import { FlowGlRenderer, now } from './renderer.js';
+import { LabelAtlas } from './text.js';
+/**
+ * Where the surface sits, from what `onDraw` was handed.
+ *
+ * The scene is in logical window pixels and the surface is a box of its own
+ * in device ones; the node's `abs` is device pixels too, so its origin in
+ * logical ones is `abs / scale`. Taking `scale` from `DrawInfo`, where its
+ * type puts it, made that `abs / undefined`: every vertex `NaN`, a blank
+ * pane — and every counter the renderer keeps, draw calls and instances and
+ * frames a second, exactly what a correct frame reports. So a target that
+ * is not finite throws here, and a surface that cannot place itself fails
+ * back to the 2D renderer through `onError` rather than drawing nothing.
+ */
+export function targetOf(info) {
+    const scale = info.scale;
+    const target = {
+        origin: { x: info.node.abs.x / scale, y: info.node.abs.y / scale },
+        scale,
+        width: info.width,
+        height: info.height,
+    };
+    if (![
+        target.origin.x,
+        target.origin.y,
+        scale,
+        target.width,
+        target.height,
+    ].every(Number.isFinite) ||
+        !(scale > 0)) {
+        throw new Error(`@react-x11/components flow/gl: cannot place the surface ` +
+            `(${JSON.stringify(target)})`);
+    }
+    return target;
+}
+/** Slices of setting — a few milliseconds of fields, and the batch drawn
+ *  and read back that an engine without coverage of its own needs — one
+ *  run may take: a bound, so a screen whose labels outgrow the atlas does
+ *  not set labels for ever. The next frame that wants any starts another. */
+const MAX_SLICES = 64;
+/** The surface's state across renders: the renderer lives as long as the GL
+ *  context it was made for, which is longer than any one props object. */
+class Driver {
+    props;
+    area = null;
+    renderer = null;
+    context = null;
+    /** The key of the world now on the GPU — null when there is none, which
+     *  is what makes the next frame build one. */
+    worldKey = null;
+    /** The same for the lifted layer — the nodes a drag is moving. */
+    liftedKey = null;
+    /** The label atlas, and the face and scale it was made for: either
+     *  changing is every field wrong, so it is made again. */
+    atlas = null;
+    atlasKey = '';
+    /** The timer that brings a frame once a zoom gesture stops — strings it
+     *  uncovered are only set at rest, and a gesture that rebuilt its world
+     *  on the way asks for no frame by itself when it stops. */
+    settle = null;
+    failed = false;
+    /** Labels are being set (`setLabels`); one run at a time. */
+    setting = false;
+    constructor(props) {
+        this.props = props;
+    }
+    /** Stable, so the pane can compare it and not repaint on every render. */
+    request = () => {
+        this.area?.requestFrame?.();
+    };
+    areaRef = (node) => {
+        this.area = node;
+        this.attach();
+    };
+    attach() {
+        this.props.pane.current?.setGlRequest(this.area && !this.failed ? this.request : null);
+    }
+    detach() {
+        this.props.pane.current?.setGlRequest(null);
+        if (this.settle != null)
+            timers.clearTimeout?.(this.settle);
+        this.settle = null;
+        this.atlas?.dispose();
+        this.atlas = null;
+        this.atlasKey = '';
+    }
+    draw = (gl, info) => {
+        if (this.failed)
+            return;
+        try {
+            if (this.context !== gl || !this.renderer) {
+                // A new context is new everything: programs and buffers belong to
+                // the one they were made in.
+                this.renderer = new FlowGlRenderer(gl);
+                this.context = gl;
+                this.worldKey = null;
+                this.liftedKey = null;
+            }
+            const pane = this.props.pane.current;
+            if (!pane)
+                return;
+            const atlas = this.atlasFor(pane);
+            const started = now();
+            const frame = pane.glFrame(this.worldKey, this.liftedKey);
+            if (!frame)
+                return;
+            const sceneMs = now() - started;
+            const target = targetOf(info);
+            if (atlas) {
+                this.admit(atlas, frame.moving ?? false);
+                // the view, in the world's coordinates
+                const zoom = frame.zoom ?? 1;
+                atlas.setView({
+                    x: (target.origin.x - frame.offset.x) / zoom,
+                    y: (target.origin.y - frame.offset.y) / zoom,
+                    width: target.width / target.scale / zoom,
+                    height: target.height / target.scale / zoom,
+                });
+            }
+            const stats = this.renderer.drawFrame(frame, target, atlas ?? undefined);
+            if (frame.world)
+                this.worldKey = frame.key;
+            if (frame.lifted !== undefined)
+                this.liftedKey = frame.liftedKey ?? null;
+            // Labels this frame could not draw yet are set now, between frames.
+            if (atlas?.wanting && !this.setting) {
+                this.setting = true;
+                this.setLabels(atlas).then(() => (this.setting = false), (error) => {
+                    this.setting = false;
+                    this.fail(error);
+                });
+            }
+            this.props.onFrame?.({
+                renderer: 'gl',
+                sceneMs,
+                ...stats,
+                bodies: pane.bodyBudget(),
+            });
+        }
+        catch (error) {
+            this.fail(error);
+        }
+    };
+    /**
+     * Set strings until nothing the world on screen draws is wanted, a frame
+     * after every slice that set any: the world holds a box for every label,
+     * the ones still being set drawn as nothing, and the frame writes in what
+     * landed (`FlowGlRenderer.landLabels`). The labels arrive as they are
+     * set, nearest the middle of the view first, where they used to wait for
+     * the last of them and a world packed again.
+     *
+     * Stops when the zoom starts moving again, or after a bound on slices.
+     */
+    async setLabels(atlas) {
+        for (let slice = 0; slice < MAX_SLICES; slice++) {
+            const set = await atlas.pump();
+            if (this.failed || this.atlas !== atlas)
+                return;
+            if (!set)
+                break;
+            this.request();
+            if (!atlas.wanting)
+                break;
+        }
+    }
+    /** The atlas for this pane's face and scale, made again when either
+     *  changes — and dropped where there is no text engine at all. */
+    atlasFor(pane) {
+        const text = pane.glText?.() ?? null;
+        if (!text)
+            return null;
+        const key = `${text.options.family}|${text.options.scale}`;
+        if (!this.atlas || key !== this.atlasKey) {
+            this.atlas?.dispose();
+            this.atlas = new LabelAtlas(text);
+            this.atlasKey = key;
+            this.worldKey = null;
+            this.liftedKey = null;
+        }
+        return this.atlas;
+    }
+    /**
+     * New strings only while no zoom gesture moves, and a frame asked for once
+     * it has stopped, so the labels it uncovered are set without a nudge. A
+     * gesture is the pane's to say (`FlowGlFrame.moving`): a single step — a
+     * button, `fitView`, `setCenter` — is not one. Taking any change of zoom
+     * for one held every first appearance back by the whole rest timer: the
+     * stress fan's first label came 185 ms after a `setCenter`, and comes at
+     * 54.
+     */
+    admit(atlas, moving) {
+        atlas.admit = !moving;
+        if (moving) {
+            if (this.settle != null)
+                timers.clearTimeout?.(this.settle);
+            this.settle = timers.setTimeout?.(() => {
+                this.settle = null;
+                this.request();
+            }, 120);
+        }
+    }
+    surfaceError = (error) => {
+        this.fail(error);
+    };
+    fail(error) {
+        if (this.failed)
+            return;
+        this.failed = true;
+        this.detach();
+        this.props.onError(error instanceof Error ? error : new Error(String(error)));
+    }
+}
+/**
+ * Over the pane's box, and **transparent to the pointer**.
+ *
+ * Core hit-tests a window's surfaces before its tree (`GlAreaNode.hitSurface`
+ * in react-x11): a point over a `<glarea>` is over *it*, whatever sits behind
+ * in the tree. Everything a graph editor does with the pointer lives on the
+ * pane underneath, so without this a press on a card landed on the surface,
+ * which has no handlers, and a drag did nothing at all — found by driving
+ * a real drag through the Cocoa backend, which moved the node 177 px on the
+ * 2D renderer and 0 on this one. `pointerEvents: 'none'` is core's own way
+ * to say a node is for looking at, and it lets the pointer through to the
+ * pane as it would through any node.
+ *
+ * With node bodies over it the surface is `'box-none'` instead (below): the
+ * bodies take the pointer, and the surface between them still passes it on
+ * to the pane. Making the surface the pane's child, as `<Map>`'s is, would
+ * not have done: the pane's gestures are default actions, and core runs a
+ * default action on the event's target alone, never an ancestor.
+ */
+/** Timers, through `globalThis`: `src/` compiles with `types: []`. */
+const timers = globalThis;
+const FILL = {
+    position: 'absolute',
+    left: 0,
+    top: 0,
+    right: 0,
+    bottom: 0,
+    pointerEvents: 'none',
+};
+/** The same, where the surface holds node bodies: they are its children,
+ *  drawn over it, and take the pointer; the surface between them still does
+ *  not. React Native's `'box-none'`, which react-x11 has from #637 on. */
+const FILL_WITH_BODIES = { ...FILL, pointerEvents: 'box-none' };
+/**
+ * The surface. Mounted by `<Flow>` as the pane's sibling, after it, filling
+ * the same box: a `<glarea>` is stacked over everything 2D in its window, so
+ * it lands on the pane wherever it is in the tree.
+ */
+export function FlowGlSurface(props) {
+    const driver = useMemo(() => new Driver(props), []);
+    driver.props = props;
+    useEffect(() => {
+        driver.attach();
+        return () => driver.detach();
+    }, [driver]);
+    return React.createElement('glarea', {
+        ref: driver.areaRef,
+        // With bodies over it, the surface must pass the pointer through between
+        // them and still let them take it — `'box-none'`, react-x11#637. With
+        // none, `'none'` does the same and needs nothing new of core.
+        style: props.children ? FILL_WITH_BODIES : FILL,
+        clearColor: props.clearColor,
+        frameLoop: 'demand',
+        onDraw: driver.draw,
+        onError: driver.surfaceError,
+        children: props.children,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/flow/gl/index.js.map

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

package/dist/flow/gl/pack.d.ts

@@ -0,0 +1,133 @@
+import type { FlowRect } from '../types.js';
+import type { FlowScene, SceneText } from '../scene.js';
+import type { GlyphQuad } from './text.js';
+/** Turns a string into the quad that draws it — `./text.ts`'s atlas, or
+ *  nothing, in which case the string is counted as a gap. */
+export type TextResolver = (text: SceneText) => GlyphQuad | null;
+/** Floats per line segment: the ends; then half-width, the distance along
+ *  the line at the first end, and the dash; then the dash's offset and
+ *  whether it marches; then the colour. */
+export declare const LINE_STRIDE = 16;
+/** Floats per box: the rect, the corner radius and border width, the fill,
+ *  the border colour. A *label* is a box too — the text's corner and the
+ *  quad's size where the rect is, its margin, a flag and the size of a
+ *  field texel where the corner radius and border are, its ink in the fill
+ *  and its place in the atlas where a border colour would be — so labels
+ *  share the box stream and land in it exactly where the 2D painter draws
+ *  them. */
+export declare const BOX_STRIDE = 16;
+/** Floats per triangle *vertex*: position and colour. */
+export declare const TRI_STRIDE = 6;
+/** One run of one kind of instance, drawn in turn. `scissor` limits it to a
+ *  rect — the minimap's viewport box is allowed to spill past the panel in
+ *  the scene and has to be cut, as the 2D painter's `clipRect` cuts it. */
+export interface DrawRange {
+    kind: 'grid' | 'line' | 'box' | 'tri';
+    first: number;
+    count: number;
+    scissor?: FlowRect;
+}
+/** What {@link packScene} could not put on the GPU, counted rather than
+ *  dropped silently — the renderer reports it, and a caller deciding
+ *  whether GL is good enough for a graph reads it. */
+export interface PackGaps {
+    /** Strings: node labels, descriptions, edge labels, handle labels. The
+     *  label atlas is the next piece of work (`docs/prd-flow-gl.md`). */
+    text: number;
+    /** Nodes whose type draws itself through `paint`, which is a 2D API. */
+    custom: number;
+}
+/**
+ * Which part of a scene to pack.
+ *
+ * The GL renderer keeps the graph — edges, heads, chips, nodes, the line a
+ * connection gesture draws — as a **world** it packs only when it changes,
+ * built at a pinned origin so that a pan moves a uniform and repacks
+ * nothing. What is pinned to the *pane* rather than to the graph is the
+ * **overlay**, packed every frame because it is a handful of boxes: the
+ * background and the grid under the world, the selection rectangle, the
+ * minimap and the controls over it. `'all'` is both, in one pass, in the 2D
+ * painter's order.
+ */
+export type PackLayer = 'all' | 'world' | 'overlay';
+/** A label packed before its field landed: which box it is, the field or
+ *  request it waits for, and the label itself (`LabelAtlas.landing`). */
+export interface WaitingLabel {
+    index: number;
+    key: string;
+    text: SceneText;
+}
+/** A label packed drawn from a field, and the placement of the field it
+ *  was drawn from (`LabelAtlas.slotOf`): a box whose field was dropped or
+ *  moved is found by comparing the two. */
+export interface DrawnLabel extends WaitingLabel {
+    slot: number;
+}
+export interface PackedScene {
+    lines: Float32Array;
+    lineCount: number;
+    boxes: Float32Array;
+    boxCount: number;
+    tris: Float32Array;
+    triCount: number;
+    ranges: DrawRange[];
+    /** For an overlay: the ranges before this index go under the world and
+     *  the rest over it. */
+    split: number;
+    /** For a world: the ranges before this index are the edges, and the rest
+     *  the cards — where a layer of lifted nodes goes in two halves, its
+     *  edges under every card and its cards over them. */
+    nodesAt: number;
+    gaps: PackGaps;
+    /** Labels in `boxes` drawn as nothing until their fields land — the
+     *  renderer writes each in when it does. */
+    waiting: WaitingLabel[];
+    /** Labels in `boxes` drawn from their fields. */
+    drawn: DrawnLabel[];
+}
+/** Packs scenes into streams it owns and reuses. One per renderer. */
+export declare class ScenePacker {
+    private readonly colors;
+    private readonly lineStream;
+    private readonly boxStream;
+    private readonly triStream;
+    private ranges;
+    private gaps;
+    private waiting;
+    private drawn;
+    /** The scissor for whatever is appended until it is changed. */
+    private scissor;
+    private text;
+    /** The next range recorded is a new one, whatever the last was. */
+    private cut;
+    private nodesAt;
+    pack(scene: FlowScene, layer?: PackLayer, text?: TextResolver): PackedScene;
+    /** Extend the last range when it is the same kind under the same scissor,
+     *  or open a new one — which is what keeps a frame to a handful of draws
+     *  however the kinds interleave. */
+    private record;
+    private box;
+    private boxRaw;
+    /**
+     * A handle as a box whose corners meet. The 2D painter strokes a circle's
+     * outline *centred* on its edge — half the pen outside the radius — where
+     * a box's border is inset, so the disc is grown by half the pen to put the
+     * ring where the circle's was.
+     */
+    private handle;
+    /** A string as a box that samples its field in the atlas; counted as a
+     *  gap when the atlas has nothing to draw it from yet — and packed all
+     *  the same when its field is being set, drawn as nothing until it lands
+     *  (`waiting`). */
+    private label;
+    private ink;
+    private rule;
+    /** A polyline as capsule segments, carrying the distance along it so a
+     *  dash runs continuously round every vertex. */
+    private polyline;
+    /** A convex polygon as a triangle fan off its first vertex. Arrowheads
+     *  are the only filled polygons a graph draws, and both kinds are
+     *  convex. */
+    private polygon;
+}
+//# sourceMappingURL=pack.d.ts.map

package/dist/flow/gl/pack.d.ts.map

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