@react-x11/components 0.8.0 → 0.9.0

package/dist/maps/gl/text.js

@@ -0,0 +1,382 @@
+// Labels, the text half: strings set by the platform's own text engine,
+// read back as coverage, and packed into one GL texture.
+//
+// A `<glarea>` is stacked over every 2D thing in its window, so a label on a
+// GL map has to be *in* the GL frame — there is no drawing text over it
+// afterwards. The glyphs come from where every other string in the app
+// comes from: `app.fonts.layout()` shapes it (CoreText on the Cocoa
+// backend, ntk's own shaper on X11, font fallback and all), and the layout
+// draws into an offscreen {@link Surface} whose pixels are read back. That
+// is one readback per *batch* of labels, not per label, and each label is
+// set once and drawn every frame after.
+//
+// A label is rasterized **whole**, not glyph by glyph: placement sets every
+// line label on a straight stretch, so a label is one rigid piece of type —
+// one textured quad, rotated as a unit — and shaping, kerning and scripts
+// stay the text engine's business. What is stored is **coverage**, drawn in
+// white and read from the alpha channel; colour and halo are the shader's
+// (see `./shaders.ts`), so one raster serves every palette and a
+// light-to-dark switch re-rasterizes nothing.
+import { Surface } from 'react-x11/ntk';
+/** The offscreen surface a batch is set on, in device pixels. A readback
+ *  has to stay inside it — X answers a GetImage past a pixmap's edge with
+ *  BadMatch — so a batch is whatever fits. */
+const STAGING_WIDTH = 1024;
+const STAGING_HEIGHT = 512;
+/** Milliseconds of drawing one batch may take. A batch runs between two
+ *  frames, and at 75 Hz the gap between them is a few milliseconds. */
+const DRAW_BUDGET_MS = 1.5;
+/** The text engine over an app's fonts and an offscreen surface. */
+export class SurfaceTextEngine {
+    _app;
+    _fonts;
+    _family;
+    _layouts = new Map();
+    _surface = null;
+    _ctx = null;
+    constructor(app, fonts, family) {
+        this._app = app;
+        this._fonts = fonts;
+        this._family = family;
+    }
+    /** The engine for the app a node belongs to, or null where there is
+     *  nothing to set text with. */
+    static forApp(app, family) {
+        const fonts = app?.fonts;
+        if (!fonts || typeof fonts.layout !== 'function')
+            return null;
+        return new SurfaceTextEngine(app, fonts, family);
+    }
+    _layout(text, size) {
+        const key = `${size}|${text}`;
+        let layout = this._layouts.get(key);
+        if (!layout) {
+            // Bounded like the retained renderer's shaper: cleared wholesale, and
+            // what is on screen is set again once.
+            if (this._layouts.size > 8000)
+                this._layouts.clear();
+            layout = this._fonts.layout(text, {
+                family: this._family,
+                size,
+                weight: 400,
+                style: 'normal',
+                color: '#ffffff',
+            });
+            this._layouts.set(key, layout);
+        }
+        return layout;
+    }
+    measure(text, size) {
+        const layout = this._layout(text, size);
+        return { width: Math.ceil(layout.width), height: Math.ceil(layout.height) };
+    }
+    async rasterize(items, pad) {
+        const places = [];
+        let x = 0;
+        let y = 0;
+        let row = 0;
+        for (const item of items) {
+            const box = this.measure(item.text, item.size);
+            const w = box.width + pad * 2;
+            const h = box.height + pad * 2;
+            if (w > STAGING_WIDTH || h > STAGING_HEIGHT) {
+                places.push(null);
+                continue;
+            }
+            if (x + w > STAGING_WIDTH) {
+                x = 0;
+                y += row;
+                row = 0;
+            }
+            if (y + h > STAGING_HEIGHT) {
+                places.push(undefined);
+                continue;
+            }
+            places.push({ x, y, w, h });
+            x += w;
+            row = Math.max(row, h);
+        }
+        if (!places.some((p) => p)) {
+            return places.map((p) => (p === null ? null : undefined));
+        }
+        if (!this._surface) {
+            this._surface = new Surface(this._app, {
+                width: STAGING_WIDTH,
+                height: STAGING_HEIGHT,
+            });
+            this._ctx = this._surface.getContext('2d');
+        }
+        const surface = this._surface;
+        const ctx = this._ctx;
+        surface.clear();
+        const started = now();
+        // The rows drawn into: what is read back, and no more.
+        let used = 0;
+        items.forEach((item, i) => {
+            const place = places[i];
+            if (!place)
+                return;
+            // Drawing is this thread's time; past the budget the rest wait for
+            // the next batch.
+            if (now() - started > DRAW_BUDGET_MS) {
+                places[i] = undefined;
+                return;
+            }
+            this._layout(item.text, item.size).draw(ctx, place.x + pad, place.y + pad);
+            used = Math.max(used, place.y + place.h);
+        });
+        const image = await ctx.getImageData(0, 0, STAGING_WIDTH, used);
+        return places.map((place) => {
+            if (!place)
+                return place;
+            // Row by row, as the readback has them: a copy, not a pass over the
+            // pixels, and uploaded as it is — the shader reads alpha alone.
+            const rowBytes = place.w * 4;
+            const pixels = new Uint8Array(rowBytes * place.h);
+            for (let r = 0; r < place.h; r++) {
+                const src = ((place.y + r) * image.width + place.x) * 4;
+                pixels.set(image.data.subarray(src, src + rowBytes), r * rowBytes);
+            }
+            return { width: place.w, height: place.h, pixels };
+        });
+    }
+    dispose() {
+        this._ctx?.destroy?.();
+        this._ctx = null;
+        this._surface?.destroy();
+        this._surface = null;
+        this._layouts.clear();
+    }
+}
+const keyOf = (text, size) => `${size}|${text}`;
+/**
+ * The widest halo a raster's margin holds, in pixels. The drawn quad sits
+ * {@link quadInset} inside the margin and a halo samples up to this far
+ * past the quad, so its samples stay a texel inside the raster's own clear
+ * margin and never reach a neighbour's.
+ */
+export const haloReach = (pad) => Math.max(0, Math.floor((pad - 2) / 2));
+export const quadInset = (pad) => pad - haloReach(pad) - 1;
+/** Strings a frame measures however little budget it has left, so a frame
+ *  that starts late still makes progress. One: on X11 a string's first
+ *  measurement can cost milliseconds, and a floor of several put a pan
+ *  frame 27 ms over. */
+const MIN_MEASURES = 1;
+/** Strings per rasterization batch at most — a few rows of the staging
+ *  surface, so the readback and the copies out of it stay small too. */
+const BATCH = 32;
+/** Frames an unused entry survives a compaction for. */
+const KEEP_FRAMES = 120;
+/**
+ * Every label raster, packed into one texture's worth of shelves, with the
+ * uploads the renderer owes it.
+ *
+ * The atlas is CPU-side and outlives any one GL context: it keeps each
+ * entry's raster, so a renderer that is new — the surface was recreated —
+ * uploads it again from here ({@link restart}), and asks nothing of the text
+ * engine. What it holds is bounded by the texture it packs into: 16 MB for
+ * the default 2048², whatever is panned past.
+ *
+ * **Measuring is budgeted, drawing is asynchronous, uploading is metered.**
+ * Placement needs a label's box the frame it is considered, which is a
+ * synchronous shaping call — tens of microseconds on the Cocoa backend, but
+ * milliseconds each the first time on X11, where fonts load and glyphs
+ * rasterize in JS — so a frame measures until its deadline and leaves the
+ * rest for the next. A raster is asked for only once a label has won a
+ * place, and arrives a batch at a time, a readback later; the renderer
+ * takes a few dozen a frame into the texture, and a label fades in once its
+ * raster is there.
+ */
+export class LabelAtlas {
+    size;
+    /** Clear margin rasterized around every string, in pixels — what a halo
+     *  grows into, and what keeps it from sampling a neighbour. */
+    pad;
+    /** A frame's measuring ran out of budget: there is more to place. */
+    starved = false;
+    onChange = null;
+    _engine;
+    _entries = new Map();
+    /** Entries the texture does not have where they are, oldest first. */
+    _uploads = [];
+    _wanted = new Map();
+    _failed = new Set();
+    _measured = new Map();
+    _busy = false;
+    _shelves = [];
+    _top = 0;
+    _frame = 0;
+    _deadline = Infinity;
+    _measures = 0;
+    constructor(engine, options) {
+        this._engine = engine;
+        this.size = options.size ?? 2048;
+        this.pad = options.pad;
+    }
+    /** Strings asked for and not yet rasterized, or a batch in flight. */
+    get pending() {
+        return this._busy || this._wanted.size > 0;
+    }
+    /** Rasters waiting for the texture. */
+    get uploading() {
+        return this._uploads.length > 0;
+    }
+    get entries() {
+        return this._entries.size;
+    }
+    /** A new frame, whose measuring stops at `deadline` (after one). */
+    beginFrame(deadline) {
+        this._frame++;
+        this._deadline = deadline;
+        this._measures = 0;
+        this.starved = false;
+    }
+    /** The box a string sets in, or null when this frame's budget is spent. */
+    measure(text, size) {
+        const key = keyOf(text, size);
+        const hit = this._measured.get(key);
+        if (hit)
+            return hit;
+        const engine = this._engine;
+        if (!engine)
+            return null;
+        if (this._measures >= MIN_MEASURES && now() > this._deadline) {
+            this.starved = true;
+            return null;
+        }
+        this._measures++;
+        const box = engine.measure(text, size);
+        if (this._measured.size > 20000)
+            this._measured.clear();
+        this._measured.set(key, box);
+        return box;
+    }
+    /** The string's raster, once the texture has it; null until then —
+     *  asking is what gets it rasterized. */
+    entry(text, size) {
+        const key = keyOf(text, size);
+        const entry = this._entries.get(key);
+        if (entry) {
+            entry.used = this._frame;
+            return entry.ready ? entry : null;
+        }
+        if (!this._failed.has(key) && !this._wanted.has(key)) {
+            this._wanted.set(key, { text, size });
+        }
+        return null;
+    }
+    /** Start rasterizing what has been asked for, unless a batch is out. */
+    pump() {
+        const engine = this._engine;
+        if (!engine || this._busy || this._wanted.size === 0)
+            return;
+        const batch = [];
+        for (const item of this._wanted.values()) {
+            batch.push(item);
+            if (batch.length >= BATCH)
+                break;
+        }
+        this._busy = true;
+        engine.rasterize(batch, this.pad).then((rasters) => {
+            this._busy = false;
+            rasters.forEach((raster, i) => {
+                if (raster === undefined)
+                    return;
+                const key = keyOf(batch[i].text, batch[i].size);
+                this._wanted.delete(key);
+                if (raster === null || !this._add(key, raster))
+                    this._failed.add(key);
+            });
+            this.onChange?.();
+        }, () => {
+            // A readback that fails once fails every time (no surface, a
+            // backend without one): stop asking, and draw no labels.
+            this._busy = false;
+            this._engine = null;
+            this._wanted.clear();
+            this.onChange?.();
+        });
+    }
+    /** Up to `max` rasters for the texture, oldest first. The renderer marks
+     *  each `ready` once it is uploaded. */
+    takeUploads(max) {
+        return this._uploads.splice(0, max);
+    }
+    /** The texture is new, and has none of it: everything goes up again. */
+    restart() {
+        for (const entry of this._entries.values())
+            entry.ready = false;
+        this._uploads = [...this._entries.values()];
+    }
+    dispose() {
+        this._engine?.dispose();
+        this._engine = null;
+    }
+    _add(key, raster) {
+        let place = this._allocate(raster.width, raster.height);
+        if (!place) {
+            this._compact();
+            place = this._allocate(raster.width, raster.height);
+        }
+        if (!place)
+            return false;
+        const entry = {
+            key,
+            x: place.x,
+            y: place.y,
+            width: raster.width,
+            height: raster.height,
+            pixels: raster.pixels,
+            ready: false,
+            used: this._frame,
+        };
+        this._entries.set(key, entry);
+        this._uploads.push(entry);
+        return true;
+    }
+    /** A shelf packer: rows of one height class (rounded up to 8 pixels),
+     *  filled left to right, a new row below the last when none has room. */
+    _allocate(w, h) {
+        if (w > this.size || h > this.size)
+            return null;
+        const height = Math.ceil(h / 8) * 8;
+        for (const shelf of this._shelves) {
+            if (shelf.height === height && shelf.x + w <= this.size) {
+                const at = { x: shelf.x, y: shelf.y };
+                shelf.x += w;
+                return at;
+            }
+        }
+        if (this._top + height > this.size)
+            return null;
+        const shelf = { y: this._top, height, x: w };
+        this._shelves.push(shelf);
+        this._top += height;
+        return { x: 0, y: shelf.y };
+    }
+    /** Drop what has not been drawn for a while and pack the rest again,
+     *  tallest first. Everything kept has moved, so none of it is drawn
+     *  until the renderer has uploaded it where it now is. */
+    _compact() {
+        const keep = [...this._entries.values()]
+            .filter((e) => e.used >= this._frame - KEEP_FRAMES)
+            .sort((a, b) => b.height - a.height);
+        this._entries.clear();
+        this._shelves = [];
+        this._top = 0;
+        this._uploads = [];
+        for (const entry of keep) {
+            const place = this._allocate(entry.width, entry.height);
+            if (!place)
+                continue;
+            entry.x = place.x;
+            entry.y = place.y;
+            entry.ready = false;
+            this._entries.set(entry.key, entry);
+            this._uploads.push(entry);
+        }
+    }
+}
+const globals = globalThis;
+const now = () => globals.performance?.now() ?? Date.now();
+//# sourceMappingURL=text.js.map

package/dist/maps/gl/text.js.map

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

package/dist/maps/gl/view.d.ts

@@ -0,0 +1,54 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { Style } from 'react-x11/style';
+import type { MapController } from '../controller.js';
+import type { MapProps } from '../types.js';
+/**
+ * Adaptive quality's rungs, cheapest last. Each leaves out more than the
+ * one before it, in the order that costs the picture least:
+ *
+ *  1. **The fill edge pass** — the half-pixel line that antialiases every
+ *     polygon. A fifth of a dense frame, measured, and a staircase edge is
+ *     invisible on a map in motion.
+ *  2. **The style's newest detail layers** — those whose `minZoom` is within
+ *     `detail` levels of the zoom: buildings and service roads first, then
+ *     sites, minor roads. The style already says which layers are details,
+ *     by bringing them in last.
+ *  3. **A coarser tile level** — the parent level's tiles, drawn at this
+ *     zoom: generalized geometry and fewer features, which is what a low-zoom
+ *     frame (all land and water polygons) is made cheaper by.
+ */
+export declare const QUALITY_LADDER: readonly {
+    edges: boolean;
+    detail: number;
+    coarser: number;
+}[];
+/**
+ * The rung a moving frame is drawn at: the lowest predicted to fit the
+ * budget, and a rung up only once that one is predicted well inside it —
+ * so a frame that sits at the budget does not flicker between two rungs.
+ */
+export declare function chooseQuality(current: number, predict: (rung: number) => number, budgetMs: number): number;
+/** What `<Map>` hands the GL renderer. */
+export interface GlMapPaneProps {
+    /** The map's controller: its camera, its gestures and its handle. */
+    controller: MapController;
+    /** Everything `<Map>` was given. */
+    map: MapProps;
+    /** GL failed — the surface, the context, a shader, a frame. Called once;
+     *  what happens next is `<Map>`'s decision. */
+    onFailure: (error: Error) => void;
+    style?: Style;
+    role?: string;
+    'aria-label'?: string;
+    'data-testname'?: string;
+    /** Drawn above the surface, as core draws a `<glarea>`'s children — given
+     *  only where `useSupports('glOverlay')` says this connection does. */
+    children?: ReactNode;
+}
+/**
+ * The GL half of `<Map>`: a pane with a `<glarea>` in it, drawn every frame
+ * from vector tiles. Mounted by `<Map>` when it chooses GL; not exported
+ * from the package on its own.
+ */
+export declare function GlMapPane(props: GlMapPaneProps): ReactElement;
+//# sourceMappingURL=view.d.ts.map

package/dist/maps/gl/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/maps/gl/view.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,KAAK,EAAE,aAAa,EAA4B,MAAM,kBAAkB,CAAC;AAoBhF,OAAO,KAAK,EAAiB,QAAQ,EAAE,MAAM,aAAa,CAAC;AA6B3D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,EAOA,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACjC,QAAQ,EAAE,MAAM,GACf,MAAM,CAMR;AA2ID,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,UAAU,EAAE,aAAa,CAAC;IAC1B,oCAAoC;IACpC,GAAG,EAAE,QAAQ,CAAC;IACd;mDAC+C;IAC/C,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;2EACuE;IACvE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAo4BD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CAsC7D"}