@react-x11/components 0.1.0 → 0.2.0

package/dist/terminal/vt/renderer.js

@@ -0,0 +1,357 @@
+function zeroStats() {
+    return {
+        fillRequests: 0,
+        glyphRequests: 0,
+        copies: 0,
+        blits: 0,
+        cellsFilled: 0,
+        glyphsDrawn: 0,
+    };
+}
+function css(rgb) {
+    return `#${(rgb & 0xffffff).toString(16).padStart(6, '0')}`;
+}
+/**
+ * The batching half, shared by both renderers.
+ *
+ * Order within a frame is fixed and is the whole of the "two colours per
+ * cell" model: backgrounds first, then glyphs over them, then decorations
+ * (which are foreground-coloured rules) over those.
+ */
+class BatchingRenderer {
+    frame = null;
+    ctx = null;
+    /** Where this renderer's coordinates sit relative to the paint context. */
+    offsetX = 0;
+    offsetY = 0;
+    _fills = new Map();
+    _decorations = new Map();
+    _runs = new Map();
+    stats = zeroStats();
+    totals = zeroStats();
+    /** Every counter goes through here, so a total can never drift from the
+     *  per-frame number it was added to. */
+    count(key, by = 1) {
+        this.stats[key] += by;
+        this.totals[key] += by;
+    }
+    begin(ctx, frame) {
+        this.ctx = ctx;
+        this.frame = frame;
+        this._fills.clear();
+        this._decorations.clear();
+        this._runs.clear();
+        this.stats.fillRequests = 0;
+        this.stats.glyphRequests = 0;
+        this.stats.copies = 0;
+        this.stats.blits = 0;
+        this.stats.cellsFilled = 0;
+        this.stats.glyphsDrawn = 0;
+    }
+    fillCells(row, col, count, rgb) {
+        const frame = this.frame;
+        if (!frame || count <= 0)
+            return;
+        const { cellWidth, cellHeight } = frame.metrics;
+        push(this._fills, rgb, [
+            this.offsetX + col * cellWidth,
+            this.offsetY + row * cellHeight,
+            count * cellWidth,
+            cellHeight,
+        ]);
+        this.count('cellsFilled', count);
+    }
+    drawRun(row, col, run, rgb) {
+        const frame = this.frame;
+        if (!frame)
+            return;
+        const { cellWidth, cellHeight, baseline } = frame.metrics;
+        let list = this._runs.get(rgb);
+        if (!list) {
+            list = [];
+            this._runs.set(rgb, list);
+        }
+        // Grid-computed, per cell: a fractional font advance can never accumulate
+        // into drift, because nothing ever advances a pen across the row.
+        list.push({
+            run,
+            x: this.offsetX + col * cellWidth,
+            y: this.offsetY + row * cellHeight + baseline,
+        });
+        this.count('glyphsDrawn', run.glyphs.length);
+    }
+    decorate(row, col, count, kind, rgb) {
+        const frame = this.frame;
+        if (!frame || count <= 0)
+            return;
+        const { cellWidth, cellHeight, baseline, underline, ruleHeight } = frame.metrics;
+        const x = this.offsetX + col * cellWidth;
+        const y = this.offsetY + row * cellHeight;
+        const w = count * cellWidth;
+        switch (kind) {
+            case 'underline':
+                push(this._decorations, rgb, [x, y + underline, w, ruleHeight]);
+                break;
+            case 'strike':
+                push(this._decorations, rgb, [
+                    x,
+                    y + Math.round(baseline - baseline / 3),
+                    w,
+                    ruleHeight,
+                ]);
+                break;
+            case 'overline':
+                push(this._decorations, rgb, [x, y, w, ruleHeight]);
+                break;
+            case 'bar':
+                push(this._decorations, rgb, [
+                    x,
+                    y,
+                    Math.max(1, ruleHeight * 2),
+                    cellHeight,
+                ]);
+                break;
+            case 'cursorUnderline':
+                push(this._decorations, rgb, [
+                    x,
+                    y + cellHeight - Math.max(2, ruleHeight * 2),
+                    w,
+                    Math.max(2, ruleHeight * 2),
+                ]);
+                break;
+            case 'box': {
+                // The unfocused cursor: an outline, so the cell keeps its own
+                // colours and the character under it stays readable.
+                const t = ruleHeight;
+                push(this._decorations, rgb, [x, y, w, t]);
+                push(this._decorations, rgb, [x, y + cellHeight - t, w, t]);
+                push(this._decorations, rgb, [x, y, t, cellHeight]);
+                push(this._decorations, rgb, [x + w - t, y, t, cellHeight]);
+                break;
+            }
+        }
+    }
+    end() {
+        const ctx = this.target();
+        if (ctx) {
+            this._flushRects(ctx, this._fills);
+            this._flushGlyphs(ctx);
+            this._flushRects(ctx, this._decorations);
+        }
+        this.present();
+        this._fills.clear();
+        this._decorations.clear();
+        this._runs.clear();
+    }
+    _flushRects(ctx, batches) {
+        for (const [rgb, rects] of batches) {
+            if (!rects.length)
+                continue;
+            ctx.fillStyle = css(rgb);
+            if (typeof ctx.fillRects === 'function') {
+                // One `Render.FillRectangles` for the whole colour (ntk#253), where
+                // a `fillRect` loop is one composite per rectangle.
+                ctx.fillRects(rects);
+            }
+            else {
+                for (let i = 0; i < rects.length; i += 4) {
+                    ctx.fillRect(rects[i], rects[i + 1], rects[i + 2], rects[i + 3]);
+                }
+            }
+            this.count('fillRequests');
+        }
+    }
+    _flushGlyphs(ctx) {
+        if (!this._runs.size)
+            return;
+        if (typeof ctx.drawGlyphs !== 'function' ||
+            typeof ctx.createSolidPicture !== 'function') {
+            return;
+        }
+        const op = ctx.Render?.PictOp?.Over ?? 3;
+        for (const [rgb, runs] of this._runs) {
+            if (!runs.length)
+                continue;
+            // Premultiplied 0..1, which is what XRender solids are. Opaque, so the
+            // premultiplication is the identity.
+            const src = ctx.createSolidPicture(((rgb >> 16) & 0xff) / 255, ((rgb >> 8) & 0xff) / 255, (rgb & 0xff) / 255, 1);
+            ctx.drawGlyphs(op, src, runs);
+            this.count('glyphRequests');
+        }
+    }
+}
+function push(batches, key, rect) {
+    const list = batches.get(key);
+    if (list)
+        list.push(rect[0], rect[1], rect[2], rect[3]);
+    else
+        batches.set(key, rect.slice());
+}
+/**
+ * The default: a retained `Surface` the size of the grid.
+ *
+ * Why a surface of our own rather than `Window#scrollRegion` on the window's
+ * backing store: the window's backing store is where react-x11 paints every
+ * *other* node too, so scrolling it would make our correctness depend on
+ * nothing overlapping the band mid-frame and on core's damage bookkeeping not
+ * repainting our rect after we moved it. The surface decouples us from both
+ * for the price of one composite per frame.
+ */
+export class RetainedRenderer extends BatchingRenderer {
+    kind = 'retained';
+    _app;
+    _Surface;
+    _surface = null;
+    _surfaceCtx = null;
+    _cols = 0;
+    _metrics = null;
+    constructor(app, Surface) {
+        super();
+        this._app = app;
+        this._Surface = Surface;
+    }
+    ensure(cols, rows, metrics) {
+        const width = Math.max(1, cols * metrics.cellWidth);
+        const height = Math.max(1, rows * metrics.cellHeight);
+        const fits = this._surface !== null &&
+            this._surface.width >= width &&
+            this._surface.height >= height &&
+            this._metrics?.cellWidth === metrics.cellWidth &&
+            this._metrics?.cellHeight === metrics.cellHeight;
+        this._cols = cols;
+        this._metrics = metrics;
+        if (fits)
+            return true;
+        this._release();
+        // Grown with headroom, the way ntk grows a window's backing store: a
+        // drag-resize is a stream of sizes, and reallocating on each one throws
+        // the whole screen away every frame of the drag.
+        const alloc = (n) => Math.ceil((n * 5) / 4);
+        try {
+            this._surface = new this._Surface(this._app, {
+                width: alloc(width),
+                height: alloc(height),
+                format: 'argb32',
+            });
+            // One context for the surface's whole life: a context is much heavier
+            // than it looks (a GC and a Picture), and `Surface#render` would build
+            // and destroy one per frame.
+            this._surfaceCtx = this._surface.getContext('2d');
+        }
+        catch {
+            this._surface = null;
+            this._surfaceCtx = null;
+        }
+        return false;
+    }
+    target() {
+        return this._surfaceCtx;
+    }
+    copyRows(srcRow, dstRow, count) {
+        const surface = this._surface;
+        const metrics = this._metrics;
+        if (!surface || !metrics || count <= 0 || srcRow === dstRow)
+            return false;
+        const h = metrics.cellHeight;
+        const ok = surface.copyWithin({
+            x: 0,
+            y: srcRow * h,
+            width: this._cols * metrics.cellWidth,
+            height: count * h,
+        }, 0, (dstRow - srcRow) * h);
+        if (ok)
+            this.count('copies');
+        return ok;
+    }
+    present() {
+        const ctx = this.ctx;
+        const frame = this.frame;
+        const surface = this._surface;
+        if (!ctx || !frame || !surface || typeof ctx.drawImage !== 'function') {
+            return;
+        }
+        const width = frame.cols * frame.metrics.cellWidth;
+        const height = frame.rows * frame.metrics.cellHeight;
+        if (width <= 0 || height <= 0)
+            return;
+        // The whole grid, one composite. It is the whole grid rather than the
+        // frame's dirty bands because `Node.paint` has just filled this node's
+        // background across everything the damage clip covers, and the damage we
+        // claimed is the grid rect — the diff decides what is *rendered*, which
+        // is where the cost is, and the blit is one request either way.
+        ctx.drawImage(surface, 0, 0, width, height, frame.originX, frame.originY, width, height);
+        this.count('blits');
+    }
+    _release() {
+        this._surfaceCtx?.destroy?.();
+        this._surface?.destroy();
+        this._surfaceCtx = null;
+        this._surface = null;
+    }
+    destroy() {
+        this._release();
+    }
+    /** Whether the surface actually exists — the probe the factory reads. */
+    get usable() {
+        return this._surface !== null;
+    }
+}
+/**
+ * No buffer: draw the frame straight into the paint context.
+ *
+ * `copyRows` refuses, so the caller repaints what moved. That is not a
+ * degradation to apologise for — `Node.paint` fills this node's background
+ * before we draw, so there are no old pixels to shift in the first place.
+ */
+export class DirectRenderer extends BatchingRenderer {
+    kind = 'direct';
+    ensure() {
+        // Nothing is retained between frames, so every frame is a fresh one and
+        // the caller has to treat its mirror as empty.
+        return false;
+    }
+    begin(ctx, frame) {
+        super.begin(ctx, frame);
+        this.offsetX = frame.originX;
+        this.offsetY = frame.originY;
+    }
+    target() {
+        return this.ctx;
+    }
+    copyRows() {
+        return false;
+    }
+    present() {
+        // already in the window
+    }
+    destroy() {
+        // nothing owned
+    }
+}
+/**
+ * Pick a renderer for this context, or `null` when there is nothing to draw
+ * with — the mock backend's context has no pixel API at all, and a component
+ * that throws there cannot be tested headlessly (AGENTS.md).
+ */
+const PROBE_METRICS = {
+    cellWidth: 1,
+    cellHeight: 1,
+    baseline: 1,
+    underline: 1,
+    ruleHeight: 1,
+};
+export function createRenderer(app, ctx, Surface) {
+    if (typeof ctx.fillRect !== 'function')
+        return null;
+    if (Surface && typeof ctx.drawImage === 'function') {
+        const retained = new RetainedRenderer(app, Surface);
+        // Probing by construction rather than by feature-sniffing the server:
+        // whether a pixmap can be made on this connection is the actual question.
+        retained.ensure(1, 1, PROBE_METRICS);
+        if (retained.usable)
+            return retained;
+        retained.destroy();
+    }
+    return new DirectRenderer();
+}
+//# sourceMappingURL=renderer.js.map

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

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

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

@@ -0,0 +1,6 @@
+export type TimerId = unknown;
+export declare function startInterval(fn: () => void, ms: number): TimerId;
+export declare function stopInterval(id: TimerId): void;
+/** Off the current stack — how paint tells React that the grid resized. */
+export declare function microtask(fn: () => void): void;
+//# sourceMappingURL=timers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../../src/terminal/vt/timers.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC;AAE9B,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAE9C;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAG9C"}

package/dist/terminal/vt/timers.js

@@ -0,0 +1,16 @@
+const g = globalThis;
+export function startInterval(fn, ms) {
+    return g.setInterval?.(fn, ms) ?? null;
+}
+export function stopInterval(id) {
+    if (id != null)
+        g.clearInterval?.(id);
+}
+/** Off the current stack — how paint tells React that the grid resized. */
+export function microtask(fn) {
+    if (g.queueMicrotask)
+        g.queueMicrotask(fn);
+    else
+        void Promise.resolve().then(fn);
+}
+//# sourceMappingURL=timers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../../src/terminal/vt/timers.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,GAAG,UAA0B,CAAC;AAIrC,MAAM,UAAU,aAAa,CAAC,EAAc,EAAE,EAAU;IACtD,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAW;IACtC,IAAI,EAAE,IAAI,IAAI;QAAE,CAAC,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,SAAS,CAAC,EAAc;IACtC,IAAI,CAAC,CAAC,cAAc;QAAE,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;;QACtC,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACvC,CAAC"}

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

@@ -0,0 +1,142 @@
+/** What every xterm listener registration hands back. */
+export interface XtermDisposable {
+    dispose(): void;
+}
+/** xterm's event shape: call it with a listener, get a disposable. */
+export type XtermEvent<T> = (listener: (arg: T) => void) => XtermDisposable;
+/**
+ * One cell of the buffer.
+ *
+ * The `is*` predicates return numbers rather than booleans (the attribute
+ * bits, unshifted) — `isUnderline()` in particular carries the *style*
+ * variant, which is why it is read as a number here too.
+ */
+export interface XtermCell {
+    getWidth(): number;
+    getChars(): string;
+    getCode(): number;
+    getFgColor(): number;
+    getBgColor(): number;
+    getFgColorMode(): number;
+    getBgColorMode(): number;
+    isFgRGB(): boolean;
+    isBgRGB(): boolean;
+    isFgPalette(): boolean;
+    isBgPalette(): boolean;
+    isFgDefault(): boolean;
+    isBgDefault(): boolean;
+    isBold(): number;
+    isDim(): number;
+    isItalic(): number;
+    isUnderline(): number;
+    isBlink(): number;
+    isInverse(): number;
+    isInvisible(): number;
+    isStrikethrough(): number;
+    isOverline(): number;
+}
+export interface XtermLine {
+    readonly isWrapped: boolean;
+    readonly length: number;
+    /**
+     * `cell` is the reuse slot the diff loop depends on: one work cell for the
+     * whole viewport instead of an object per cell per frame. The API documents
+     * the reuse, so this is the intended shape rather than a trick.
+     */
+    getCell(x: number, cell?: XtermCell): XtermCell | undefined;
+    translateToString(trimRight?: boolean, startColumn?: number, endColumn?: number): string;
+}
+export interface XtermBuffer {
+    readonly type: 'normal' | 'alternate';
+    readonly cursorX: number;
+    readonly cursorY: number;
+    /** Buffer-absolute index of the line at the top of the viewport. */
+    readonly viewportY: number;
+    /** Buffer-absolute index of the top of the bottom page. */
+    readonly baseY: number;
+    readonly length: number;
+    getLine(y: number): XtermLine | undefined;
+    getNullCell(): XtermCell;
+}
+export interface XtermBuffers {
+    readonly active: XtermBuffer;
+    readonly normal: XtermBuffer;
+    readonly alternate: XtermBuffer;
+    readonly onBufferChange: XtermEvent<XtermBuffer>;
+}
+/** The modes the encoders branch on. All public in `IModes`. */
+export interface XtermModes {
+    readonly applicationCursorKeysMode: boolean;
+    readonly applicationKeypadMode: boolean;
+    readonly bracketedPasteMode: boolean;
+    readonly insertMode: boolean;
+    readonly mouseTrackingMode: 'none' | 'x10' | 'vt200' | 'drag' | 'any';
+    readonly originMode: boolean;
+    readonly reverseWraparoundMode: boolean;
+    readonly sendFocusMode: boolean;
+    readonly wraparoundMode: boolean;
+}
+export interface XtermFunctionIdentifier {
+    prefix?: string;
+    intermediates?: string;
+    final: string;
+}
+export interface XtermParser {
+    registerCsiHandler(id: XtermFunctionIdentifier, callback: (params: (number | number[])[]) => boolean): XtermDisposable;
+    registerOscHandler(ident: number, callback: (data: string) => boolean): XtermDisposable;
+}
+/** The options we set. A subset — xterm has many more, none of them ours. */
+export interface XtermOptions {
+    cols?: number;
+    rows?: number;
+    scrollback?: number;
+    cursorStyle?: 'block' | 'underline' | 'bar';
+    cursorBlink?: boolean;
+    drawBoldTextInBrightColors?: boolean;
+    allowProposedApi?: boolean;
+    convertEol?: boolean;
+    windowsPty?: unknown;
+}
+/**
+ * The emulator itself: bytes in, screen state out, and the events that say
+ * something changed.
+ *
+ * `onData` is the *reply* channel — DA, DSR, focus reports, mouse reports the
+ * core encodes itself — and it has to reach the pty, or an application that
+ * asks the terminal a question waits forever.
+ */
+export interface XtermTerminal {
+    readonly cols: number;
+    readonly rows: number;
+    readonly buffer: XtermBuffers;
+    readonly parser: XtermParser;
+    readonly modes: XtermModes;
+    options: XtermOptions;
+    readonly onBell: XtermEvent<void>;
+    readonly onBinary: XtermEvent<string>;
+    readonly onCursorMove: XtermEvent<void>;
+    readonly onData: XtermEvent<string>;
+    readonly onLineFeed: XtermEvent<void>;
+    readonly onResize: XtermEvent<{
+        cols: number;
+        rows: number;
+    }>;
+    readonly onScroll: XtermEvent<number>;
+    readonly onTitleChange: XtermEvent<string>;
+    readonly onWriteParsed: XtermEvent<void>;
+    write(data: string | Uint8Array, callback?: () => void): void;
+    input(data: string, wasUserInput?: boolean): void;
+    resize(cols: number, rows: number): void;
+    scrollLines(amount: number): void;
+    scrollToBottom(): void;
+    scrollToTop(): void;
+    clear(): void;
+    reset(): void;
+    dispose(): void;
+}
+/** The module's shape: one constructor. */
+export interface XtermModule {
+    Terminal: new (options?: XtermOptions) => XtermTerminal;
+}
+export declare function loadXterm(): Promise<XtermModule | null>;
+//# sourceMappingURL=xterm.d.ts.map

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

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

package/dist/terminal/vt/xterm.js

@@ -0,0 +1,32 @@
+// `@xterm/headless`, as an interface.
+//
+// The emulator core is an **optional dependency**: it installs by default
+// (nothing else would bring it, and the terminal is a flagship), but an app
+// that ran `npm install --no-optional` must still type-check against this
+// package. `import type { Terminal } from '@xterm/headless'` would put the
+// package in the type graph and break exactly that app, so the slice we use
+// is written out structurally here — the rule `../../desktop-calendar/ical.ts`
+// established for `ical.js`, for the same reason.
+//
+// Everything below is public API in the 6.0.0 typings. Nothing here reaches
+// into `term._core`: xterm.js internals churn between majors, and a renderer
+// that depends on them is a renderer that breaks on an upgrade nobody made.
+/**
+ * Load `@xterm/headless`, or answer `null` if it is not installed.
+ *
+ * A dynamic `import()` that is allowed to fail, exactly like
+ * `../../desktop-calendar/ical.ts`: "the optional dependency is missing" is an
+ * ordinary state of a healthy machine, and the component reports it as
+ * `status: 'unavailable'` plus the `fallback`, never as a throw.
+ */
+let cached = null;
+export function loadXterm() {
+    cached ??= import('@xterm/headless')
+        .then((mod) => {
+        const m = mod;
+        return typeof m.Terminal === 'function' ? m : null;
+    })
+        .catch(() => null);
+    return cached;
+}
+//# sourceMappingURL=xterm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"xterm.js","sourceRoot":"","sources":["../../../src/terminal/vt/xterm.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,0EAA0E;AAC1E,4EAA4E;AAC5E,0EAA0E;AAC1E,2EAA2E;AAC3E,4EAA4E;AAC5E,+EAA+E;AAC/E,kDAAkD;AAClD,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,4EAA4E;AAmK5E;;;;;;;GAOG;AACH,IAAI,MAAM,GAAuC,IAAI,CAAC;AACtD,MAAM,UAAU,SAAS;IACvB,MAAM,KAAK,MAAM,CAAC,iBAAiB,CAAC;SACjC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QACZ,MAAM,CAAC,GAAG,GAAsC,CAAC;QACjD,OAAO,OAAO,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAE,CAAiB,CAAC,CAAC,CAAC,IAAI,CAAC;IACtE,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/terminal-output/hx.d.ts

@@ -0,0 +1,24 @@
+import type { Key, ReactElement, ReactNode } from 'react';
+import type { ReactX11Elements, Theme } from 'react-x11';
+/** The host elements, by name. */
+export type Host = ReactX11Elements;
+/**
+ * What every element takes on top of its own props.
+ *
+ * `theme` is honoured by **every** node — `Node.theme` merges `props.theme`
+ * over the inherited palette, whatever the kind — but react-x11's element
+ * declarations only put it on `<window>`. A widget re-declares the theme it
+ * read from context onto its own root so that `$token` values still resolve
+ * inside a `<popup>`, which is a separate window and does not inherit the
+ * trigger's node tree. So the prop is real; only the declaration is narrow.
+ */
+interface CommonProps {
+    key?: Key;
+    /** `Theme` is listed alongside the record because it is an interface, and
+     *  an interface has no implicit index signature — so the palette `useTheme`
+     *  hands back is not assignable to the record react-x11 declares. */
+    theme?: Theme | Record<string, string | number>;
+}
+export declare function hx<K extends keyof Host>(type: K, props?: (Omit<Host[K], 'theme'> & CommonProps) | null, ...children: ReactNode[]): ReactElement;
+export {};
+//# sourceMappingURL=hx.d.ts.map

package/dist/terminal-output/hx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx.d.ts","sourceRoot":"","sources":["../../src/terminal-output/hx.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEzD,kCAAkC;AAClC,MAAM,MAAM,IAAI,GAAG,gBAAgB,CAAC;AAEpC;;;;;;;;;GASG;AACH,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV;;yEAEqE;IACrE,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACjD;AAED,wBAAgB,EAAE,CAAC,CAAC,SAAS,MAAM,IAAI,EACrC,IAAI,EAAE,CAAC,EAIP,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,GAAG,IAAI,EACrD,GAAG,QAAQ,EAAE,SAAS,EAAE,GACvB,YAAY,CAKd"}

package/dist/terminal-output/hx.js

@@ -0,0 +1,25 @@
+// `React.createElement`, typed against react-x11's host elements.
+//
+// The library writes `h(...)` rather than JSX — a convention inherited from
+// core, and worth keeping so moving code between the two repos stays a
+// rename. But `React.createElement`'s own overloads are `@types/react`'s, and
+// they describe the DOM: a `<box onKeyDown>` handler is checked against
+// React's `KeyboardEvent`, not react-x11's, and the whole props object is
+// measured against `DOMAttributes`. Everything interesting fails.
+//
+// So the element name is looked up in react-x11's own element table instead.
+// `hx('box', …)` gets `<box>`'s real props — `ev.keysym` on a key handler,
+// `onDraw` on a `<canvas>` — and `hx('div', …)` is an error, which is the
+// same guarantee the JSX namespace gives `examples/` and `test/types/`.
+import React from 'react';
+export function hx(type, 
+// `theme` is dropped from the element's own props before the merge:
+// `<window>` and `<popup>` already declare it, narrower, and intersecting
+// the two would demand a value satisfying both.
+props, ...children) {
+    // The cast is the whole point of the wrapper: `createElement`'s string
+    // overload insists on DOM props, and the signature above has already
+    // checked these against the element that will actually receive them.
+    return React.createElement(type, props, ...children);
+}
+//# sourceMappingURL=hx.js.map

package/dist/terminal-output/hx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx.js","sourceRoot":"","sources":["../../src/terminal-output/hx.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,4EAA4E;AAC5E,uEAAuE;AACvE,8EAA8E;AAC9E,wEAAwE;AACxE,0EAA0E;AAC1E,kEAAkE;AAClE,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,0EAA0E;AAC1E,wEAAwE;AACxE,OAAO,KAAK,MAAM,OAAO,CAAC;AAyB1B,MAAM,UAAU,EAAE,CAChB,IAAO;AACP,oEAAoE;AACpE,0EAA0E;AAC1E,gDAAgD;AAChD,KAAqD,EACrD,GAAG,QAAqB;IAExB,uEAAuE;IACvE,qEAAqE;IACrE,qEAAqE;IACrE,OAAO,KAAK,CAAC,aAAa,CAAC,IAAc,EAAE,KAAc,EAAE,GAAG,QAAQ,CAAC,CAAC;AAC1E,CAAC"}