@react-x11/components 0.1.0 → 0.2.1

package/dist/terminal/vt/diff.js

@@ -0,0 +1,358 @@
+// What changed on screen, derived by diffing the emulator's buffer against a
+// mirror of what the surface currently shows.
+//
+// The renderer deliberately never asks "what did that escape sequence touch?".
+// Escape-level damage is fragile — one CSI can move the whole screen, and a
+// palette change or a selection drag touches cells no sequence named — while
+// a signature compare over the viewport is a few thousand integer compares
+// (microseconds for a normal grid) and catches *everything*. It also makes
+// "eventually correct" structural rather than a discipline: skip as many
+// frames as you like, the next diff repairs the screen, because the mirror
+// describes pixels rather than intentions.
+//
+// Pure: structural emulator types in, plain arrays out. No X, no node, no
+// `@xterm/headless` import — so the whole model is asserted against synthetic
+// grids in `test/terminal-vt.test.ts`.
+import { resolveCell } from './colors.js';
+export function createSnapshot(cols, rows) {
+    const n = Math.max(1, cols * rows);
+    return {
+        cols,
+        rows,
+        chars: new Array(n).fill(' '),
+        width: new Uint8Array(n).fill(1),
+        fg: new Int32Array(n),
+        bg: new Int32Array(n),
+        flags: new Uint16Array(n),
+        sig: new Uint32Array(n),
+        rowSig: new Uint32Array(Math.max(1, rows)),
+        absTop: 0,
+        alt: false,
+    };
+}
+/** Whether an absolute line/column is inside the selection. */
+export function inSelection(selection, line, col) {
+    if (!selection)
+        return false;
+    const { startLine, startCol, endLine, endCol } = selection;
+    if (line < startLine || line > endLine)
+        return false;
+    if (line === startLine && col < startCol)
+        return false;
+    if (line === endLine && col >= endCol)
+        return false;
+    return true;
+}
+/** Selection endpoints, ordered — a drag runs in either direction. */
+export function orderSelection(anchorLine, anchorCol, headLine, headCol) {
+    const backwards = headLine < anchorLine || (headLine === anchorLine && headCol < anchorCol);
+    return backwards
+        ? {
+            startLine: headLine,
+            startCol: headCol,
+            endLine: anchorLine,
+            endCol: anchorCol,
+        }
+        : {
+            startLine: anchorLine,
+            startCol: anchorCol,
+            endLine: headLine,
+            endCol: headCol,
+        };
+}
+/** FNV-1a, 32 bits. Fast, well-mixed, and the arithmetic stays in int32. */
+function mixIn(hash, value) {
+    let h = (hash ^ (value & 0xffff)) >>> 0;
+    h = Math.imul(h, 0x01000193) >>> 0;
+    h = (h ^ ((value >>> 16) & 0xffff)) >>> 0;
+    return Math.imul(h, 0x01000193) >>> 0;
+}
+const FNV_OFFSET = 0x811c9dc5;
+/** Distinct numbers rather than the shape names: two of them start with the
+ *  same letter, and a signature that cannot tell a bar from a block is a
+ *  cursor that does not repaint when the style prop changes. */
+const CURSOR_SHAPE_ID = {
+    none: 0,
+    block: 1,
+    underline: 2,
+    bar: 3,
+    hollow: 4,
+};
+const scratch = { fg: 0, bg: 0, flags: 0 };
+const cellState = {
+    selected: false,
+    cursor: 'none',
+    brightBold: true,
+};
+/**
+ * Read the viewport into `out`, resolving every cell to its two paint colours
+ * and its signature.
+ *
+ * The signature is where selection, cursor position, cursor phase and the
+ * palette generation enter the model: they are inputs to the hash, so a
+ * selection drag or a theme flip repaints exactly the cells whose *pixels*
+ * differ, through the same one mechanism as a program writing text. There is
+ * no second damage path anywhere in this component.
+ */
+export function readViewport(term, out, options, work) {
+    const buffer = term.buffer.active;
+    const { cols, rows } = out;
+    const cell = work ?? buffer.getNullCell();
+    const { palette, selection, cursor } = options;
+    cellState.brightBold = options.brightBold;
+    out.absTop = buffer.viewportY;
+    out.alt = buffer.type === 'alternate';
+    for (let row = 0; row < rows; row++) {
+        const line = buffer.getLine(buffer.viewportY + row);
+        const absLine = buffer.viewportY + row;
+        // The row hash mixes only its cells. Nothing extra — an input that is
+        // *not* visible in a cell (a palette counter, a frame number) would make
+        // every row differ every frame, and the scroll detector below reads these
+        // signatures to find the band that survived a shift.
+        let rowHash = FNV_OFFSET;
+        const base = row * cols;
+        for (let col = 0; col < cols; col++) {
+            const index = base + col;
+            const got = line?.getCell(col, cell);
+            let chars = ' ';
+            let width = 1;
+            if (got) {
+                chars = got.getChars() || ' ';
+                width = got.getWidth();
+            }
+            cellState.selected = inSelection(selection, absLine, col);
+            cellState.cursor =
+                cursor.row === row && cursor.col === col ? cursor.shape : 'none';
+            if (got) {
+                resolveCell(got, palette, cellState, scratch);
+            }
+            else {
+                // Past the end of a short line, or a line the buffer has trimmed:
+                // blank in the default colours, which is what the screen shows.
+                scratch.fg = palette.foreground;
+                scratch.bg = palette.background;
+                scratch.flags = 0;
+                if (cellState.selected) {
+                    scratch.bg = palette.selectionBackground;
+                    scratch.fg = palette.selectionForeground;
+                }
+                if (cellState.cursor === 'block') {
+                    scratch.bg = palette.cursor;
+                    scratch.fg = palette.cursorText;
+                }
+            }
+            out.chars[index] = chars;
+            out.width[index] = width;
+            out.fg[index] = scratch.fg;
+            out.bg[index] = scratch.bg;
+            out.flags[index] = scratch.flags;
+            let hash = mixIn(FNV_OFFSET, scratch.fg);
+            hash = mixIn(hash, scratch.bg);
+            hash = mixIn(hash, scratch.flags | (width << 8));
+            for (let i = 0; i < chars.length; i++) {
+                hash = mixIn(hash, chars.charCodeAt(i));
+            }
+            // The cursor shape is not a colour, so it has to enter the signature on
+            // its own — a bar becoming an underline changes pixels and nothing else.
+            if (cellState.cursor !== 'none') {
+                hash = mixIn(hash, CURSOR_SHAPE_ID[cellState.cursor] << 24);
+            }
+            out.sig[index] = hash;
+            rowHash = mixIn(rowHash, hash);
+        }
+        out.rowSig[row] = rowHash;
+    }
+    return out;
+}
+/**
+ * What the surface currently shows, as signatures.
+ *
+ * Only hashes: the mirror never holds text or colours, because the only
+ * question it answers is "does this cell still look like what I drew".
+ */
+export class Mirror {
+    cols = 0;
+    rows = 0;
+    absTop = 0;
+    alt = false;
+    /** No frame has been drawn yet, so nothing on the surface is trustworthy. */
+    _valid = false;
+    _sig = new Uint32Array(0);
+    _rowSig = new Uint32Array(0);
+    _force = new Uint8Array(0);
+    /** Forget everything: a resize, a font change, a renderer swap. */
+    invalidate() {
+        this._valid = false;
+    }
+    resize(cols, rows) {
+        if (cols === this.cols && rows === this.rows)
+            return;
+        this.cols = cols;
+        this.rows = rows;
+        this._sig = new Uint32Array(Math.max(1, cols * rows));
+        this._rowSig = new Uint32Array(Math.max(1, rows));
+        this._force = new Uint8Array(Math.max(1, rows));
+        this._valid = false;
+    }
+    /**
+     * Diff a snapshot against the mirror and adopt it.
+     *
+     * The mirror is updated to describe what the caller is *about* to draw, so
+     * a caller that does not draw the result has to `invalidate()`.
+     */
+    diff(snapshot) {
+        const { cols, rows } = snapshot;
+        if (cols !== this.cols || rows !== this.rows)
+            this.resize(cols, rows);
+        const spans = [];
+        const full = !this._valid || snapshot.alt !== this.alt || cols === 0 || rows === 0;
+        let copy = null;
+        this._force.fill(full ? 1 : 0);
+        if (!full) {
+            const shift = detectShift(this, snapshot);
+            if (shift !== 0) {
+                copy = shiftMirror(this, shift, cols, rows);
+            }
+        }
+        for (let row = 0; row < rows; row++) {
+            const base = row * cols;
+            if (!this._force[row] && this._rowSig[row] === snapshot.rowSig[row]) {
+                continue;
+            }
+            this._rowSig[row] = snapshot.rowSig[row];
+            if (this._force[row]) {
+                // Nothing is known about this row's pixels — a fresh mirror, or the
+                // strip a scroll exposed. One span, no per-cell comparison.
+                for (let col = 0; col < cols; col++) {
+                    this._sig[base + col] = snapshot.sig[base + col];
+                }
+                if (cols > 0)
+                    spans.push({ row, col: 0, count: cols });
+                continue;
+            }
+            // Collect runs of changed cells, bridging gaps of up to two unchanged
+            // cells: three draw calls for `a_b_c` cost more than one for `a_b_c`.
+            let start = -1;
+            let clean = 0;
+            for (let col = 0; col < cols; col++) {
+                const index = base + col;
+                const changed = this._sig[index] !== snapshot.sig[index];
+                if (changed) {
+                    this._sig[index] = snapshot.sig[index];
+                    if (start < 0)
+                        start = col;
+                    clean = 0;
+                }
+                else if (start >= 0) {
+                    clean++;
+                    if (clean > 2) {
+                        spans.push({ row, col: start, count: col - clean - start + 1 });
+                        start = -1;
+                        clean = 0;
+                    }
+                }
+            }
+            if (start >= 0)
+                spans.push({ row, col: start, count: cols - clean - start });
+        }
+        this.absTop = snapshot.absTop;
+        this.alt = snapshot.alt;
+        this._valid = true;
+        return { copy, spans, full };
+    }
+    /** For the shift search and the row shuffle — not part of the contract. */
+    rowSignature(row) {
+        return this._rowSig[row];
+    }
+    /** @internal */
+    _internals() {
+        return { sig: this._sig, rowSig: this._rowSig, force: this._force };
+    }
+}
+/**
+ * How far the screen moved, in rows. Positive means content moved *up* — the
+ * shell scrolled, or the user paged down.
+ *
+ * The buffer's own `viewportY` is the first guess and is exact while the
+ * scrollback is still filling. Once it saturates, lines are trimmed off the
+ * top and `viewportY` stops moving although the screen very much does — so
+ * the fallback is a search over the mirror's row signatures.
+ *
+ * A wrong guess cannot corrupt anything. The mirror is shifted by exactly the
+ * amount the pixels were, so any row that does not then match its snapshot
+ * signature is repainted; a bad guess costs one CopyArea and some redraw, and
+ * that is the whole exposure.
+ */
+function detectShift(mirror, snapshot) {
+    const { rows, cols } = snapshot;
+    if (rows < 2 || cols === 0)
+        return 0;
+    let differing = 0;
+    for (let row = 0; row < rows; row++) {
+        if (mirror.rowSignature(row) !== snapshot.rowSig[row])
+            differing++;
+        if (differing > 2)
+            break;
+    }
+    // Typing, a spinner, a cursor blink: nothing moved, and the search is the
+    // most expensive thing that would happen this frame if we let it run.
+    if (differing <= 2)
+        return 0;
+    const hint = snapshot.absTop - mirror.absTop;
+    if (hint !== 0 &&
+        Math.abs(hint) < rows &&
+        verifyShift(mirror, snapshot, hint)) {
+        return hint;
+    }
+    for (let shift = 1; shift < rows; shift++) {
+        if (mirror.rowSignature(shift) === snapshot.rowSig[0]) {
+            if (verifyShift(mirror, snapshot, shift))
+                return shift;
+        }
+        if (mirror.rowSignature(0) === snapshot.rowSig[shift]) {
+            if (verifyShift(mirror, snapshot, -shift))
+                return -shift;
+        }
+    }
+    return 0;
+}
+/** Does most of the band that would survive this shift actually match? */
+function verifyShift(mirror, snapshot, shift) {
+    const { rows } = snapshot;
+    const survivors = rows - Math.abs(shift);
+    if (survivors < 2)
+        return false;
+    let matched = 0;
+    for (let i = 0; i < survivors; i++) {
+        const from = shift > 0 ? i + shift : i;
+        const to = shift > 0 ? i : i - shift;
+        if (mirror.rowSignature(from) === snapshot.rowSig[to])
+            matched++;
+    }
+    // Three quarters: a partial scroll region (vim inserting a line inside a
+    // window) still moves most of the band, and the rows it does not move are
+    // repainted by the ordinary diff below.
+    return matched >= Math.max(2, Math.ceil(survivors * 0.75));
+}
+/** Move the mirror's rows the way the pixels are about to move. */
+function shiftMirror(mirror, shift, cols, rows) {
+    const { sig, rowSig, force } = mirror._internals();
+    const count = rows - Math.abs(shift);
+    if (shift > 0) {
+        sig.copyWithin(0, shift * cols, rows * cols);
+        rowSig.copyWithin(0, shift, rows);
+        for (let row = count; row < rows; row++)
+            force[row] = 1;
+    }
+    else {
+        const up = -shift;
+        sig.copyWithin(up * cols, 0, count * cols);
+        rowSig.copyWithin(up, 0, count);
+        for (let row = 0; row < up; row++)
+            force[row] = 1;
+    }
+    return shift > 0
+        ? { srcRow: shift, dstRow: 0, count }
+        : { srcRow: 0, dstRow: -shift, count };
+}
+//# sourceMappingURL=diff.js.map

package/dist/terminal/vt/diff.js.map

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

package/dist/terminal/vt/fonts.d.ts

@@ -0,0 +1,92 @@
+/** ntk's `Font`, as this module uses it. */
+export interface NtkFont {
+    metrics(size: number): {
+        ascent: number;
+        descent: number;
+        lineGap: number;
+        lineHeight: number;
+    };
+    advanceOf(glyphId: number, size: number): number;
+    hasGlyph(codepoint: number): boolean;
+    /** ntk#254 — the lookup twin of `hasGlyph`, `null` when uncovered. */
+    glyphIdFor(codepoint: number): number | null;
+    shape(text: string, size: number, opts?: Record<string, unknown>): {
+        glyphs: {
+            id: number;
+            ax: number;
+            dx: number;
+            dy: number;
+        }[];
+    };
+}
+/** ntk's font manager, off `app.fonts`. */
+export interface NtkFonts {
+    match(family: string, opts?: {
+        weight?: number | string;
+        style?: string;
+    }): NtkFont;
+    fallbackFor(codepoint: number, family?: string, opts?: {
+        weight?: number | string;
+        style?: string;
+    }): NtkFont | null;
+}
+/** One glyph run, in the shape `ctx.drawGlyphs` documents. */
+export interface GlyphRun {
+    font: NtkFont;
+    size: number;
+    glyphs: {
+        id: number;
+        ax: number;
+        dx: number;
+        dy: number;
+    }[];
+}
+export declare const VARIANTS: readonly ['regular', 'bold', 'italic', 'boldItalic'];
+export type Variant = (typeof VARIANTS)[number];
+export interface CellMetrics {
+    /** Integers, because the grid, the copy band and the fill rects are. */
+    cellWidth: number;
+    cellHeight: number;
+    /** Baseline offset from the top of the cell. */
+    baseline: number;
+    /** Where a single underline sits, from the top of the cell. */
+    underline: number;
+    /** Thickness of underline/strike/overline rules. */
+    ruleHeight: number;
+}
+/**
+ * The four faces, the cell box, and the glyph cache — everything that depends
+ * on the font and nothing that depends on the frame.
+ *
+ * Rebuilt when the family or the size changes; the node drops its mirror at
+ * the same time, because every cell's pixels moved.
+ */
+export declare class FontSet {
+    readonly family: string;
+    readonly size: number;
+    readonly metrics: CellMetrics;
+    private _fonts;
+    private _faces;
+    /** `variant \0 chars` → the run to stamp, or null for "nothing to draw". */
+    private _glyphs;
+    constructor(fonts: NtkFonts, family: string, size: number);
+    /**
+     * One of the four faces. A family with no bold or no italic resolves to the
+     * regular one — ntk does not synthesise either, and a fake oblique is worse
+     * than an honest upright (overstrike emulation is a later, separate call).
+     */
+    face(variant: Variant): NtkFont | null;
+    /**
+     * The run for one cell's characters, or null when there is nothing to draw.
+     *
+     * Cached per (variant, chars) — a screen of text is a few hundred distinct
+     * entries, and the cache is what keeps a full-screen redraw a matter of
+     * lookups rather than cmap searches.
+     */
+    run(chars: string, variant: Variant): GlyphRun | null;
+    private _build;
+    private _fallback;
+}
+/** `VARIANT_*` bits from `./colors.ts` to one of the four faces. */
+export declare function variantOf(bold: boolean, italic: boolean): Variant;
+//# sourceMappingURL=fonts.d.ts.map

package/dist/terminal/vt/fonts.d.ts.map

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

package/dist/terminal/vt/fonts.js

@@ -0,0 +1,178 @@
+// Cell metrics and glyphs.
+//
+// A terminal bypasses text shaping by construction: the grid decides where
+// every glyph goes, so there are no ligatures, no kerning and no cluster
+// positioning to compute — which is exactly what makes the fast path fast.
+// ntk's public seam for that is `Font.glyphIdFor(cp)` plus the documented
+// `drawGlyphs` run contract (ntk#254): a cmap lookup and a hand-built run,
+// no shaping anywhere.
+//
+// The one case that does need shaping is a cluster — a base letter with
+// combining marks, a text-presentation emoji with a variation selector — and
+// `Font.shape()` handles those one cluster at a time, cached, on a path a
+// normal screen never touches.
+export const VARIANTS = ['regular', 'bold', 'italic', 'boldItalic'];
+/**
+ * The four faces, the cell box, and the glyph cache — everything that depends
+ * on the font and nothing that depends on the frame.
+ *
+ * Rebuilt when the family or the size changes; the node drops its mirror at
+ * the same time, because every cell's pixels moved.
+ */
+export class FontSet {
+    family;
+    size;
+    metrics;
+    _fonts;
+    _faces = new Map();
+    /** `variant \0 chars` → the run to stamp, or null for "nothing to draw". */
+    _glyphs = new Map();
+    constructor(fonts, family, size) {
+        this._fonts = fonts;
+        this.family = family;
+        this.size = size;
+        const regular = this.face('regular');
+        const m = regular?.metrics(size);
+        const ascent = m ? m.ascent : size * 0.8;
+        const descent = m ? m.descent : size * 0.2;
+        const lineHeight = m ? m.lineHeight : size * 1.2;
+        // The advance of a digit is the cell width: in a monospace face every
+        // glyph agrees, and in a face that is not monospace the digit is still
+        // the least surprising answer.
+        let advance = size * 0.6;
+        if (regular) {
+            const gid = regular.glyphIdFor(0x30);
+            if (gid !== null)
+                advance = regular.advanceOf(gid, size) || advance;
+        }
+        const cellWidth = Math.max(1, Math.round(advance));
+        const cellHeight = Math.max(1, Math.ceil(lineHeight));
+        const baseline = Math.min(cellHeight - 1, Math.round(ascent + (cellHeight - ascent - descent) / 2));
+        this.metrics = {
+            cellWidth,
+            cellHeight,
+            baseline,
+            underline: Math.min(cellHeight - 1, baseline + Math.max(1, Math.round(size / 10))),
+            ruleHeight: Math.max(1, Math.round(size / 14)),
+        };
+    }
+    /**
+     * One of the four faces. A family with no bold or no italic resolves to the
+     * regular one — ntk does not synthesise either, and a fake oblique is worse
+     * than an honest upright (overstrike emulation is a later, separate call).
+     */
+    face(variant) {
+        const cached = this._faces.get(variant);
+        if (cached !== undefined)
+            return cached;
+        let font = null;
+        try {
+            font = this._fonts.match(this.family, {
+                weight: variant === 'bold' || variant === 'boldItalic' ? 700 : 400,
+                style: variant === 'italic' || variant === 'boldItalic'
+                    ? 'italic'
+                    : 'normal',
+            });
+        }
+        catch {
+            // no fontconfig, no fonts on the box: the caller draws backgrounds and
+            // no glyphs rather than failing to paint at all
+            font = null;
+        }
+        this._faces.set(variant, font);
+        return font;
+    }
+    /**
+     * The run for one cell's characters, or null when there is nothing to draw.
+     *
+     * Cached per (variant, chars) — a screen of text is a few hundred distinct
+     * entries, and the cache is what keeps a full-screen redraw a matter of
+     * lookups rather than cmap searches.
+     */
+    run(chars, variant) {
+        if (!chars || chars === ' ')
+            return null;
+        const key = `${variant}\u0000${chars}`;
+        const hit = this._glyphs.get(key);
+        if (hit !== undefined)
+            return hit;
+        const run = this._build(chars, variant);
+        this._glyphs.set(key, run);
+        return run;
+    }
+    _build(chars, variant) {
+        const font = this.face(variant);
+        if (!font)
+            return null;
+        const first = chars.codePointAt(0);
+        if (first === undefined)
+            return null;
+        const single = String.fromCodePoint(first).length === chars.length;
+        if (single) {
+            let face = font;
+            let gid = safeGlyphId(face, first);
+            if (gid === null) {
+                // Nothing in the terminal's own face covers it — a box-drawing
+                // character in a font that has none, a CJK glyph, an emoji. The
+                // fallback face is a different glyphset, so it becomes its own run;
+                // it still goes out in the same request as everything else.
+                const fallback = this._fallback(first, variant);
+                if (!fallback)
+                    return null;
+                face = fallback;
+                gid = safeGlyphId(face, first);
+                if (gid === null)
+                    return null;
+            }
+            return {
+                font: face,
+                size: this.size,
+                glyphs: [{ id: gid, ax: this.metrics.cellWidth, dx: 0, dy: 0 }],
+            };
+        }
+        // A cluster: shape it once and keep the result. Rare enough that the
+        // shaping cost never reaches a frame budget, and correct where a
+        // codepoint-at-a-time walk would stack the marks on top of each other.
+        try {
+            const shaped = font.shape(chars, this.size);
+            if (!shaped.glyphs.length)
+                return null;
+            return { font, size: this.size, glyphs: shaped.glyphs };
+        }
+        catch {
+            return null;
+        }
+    }
+    _fallback(codepoint, variant) {
+        try {
+            return this._fonts.fallbackFor(codepoint, this.family, {
+                weight: variant === 'bold' || variant === 'boldItalic' ? 700 : 400,
+                style: variant === 'italic' || variant === 'boldItalic'
+                    ? 'italic'
+                    : 'normal',
+            });
+        }
+        catch {
+            return null;
+        }
+    }
+}
+function safeGlyphId(font, codepoint) {
+    try {
+        return font.glyphIdFor(codepoint);
+    }
+    catch {
+        return null;
+    }
+}
+/** `VARIANT_*` bits from `./colors.ts` to one of the four faces. */
+export function variantOf(bold, italic) {
+    if (bold && italic)
+        return 'boldItalic';
+    if (bold)
+        return 'bold';
+    if (italic)
+        return 'italic';
+    return 'regular';
+}
+//# sourceMappingURL=fonts.js.map

package/dist/terminal/vt/fonts.js.map

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