@react-x11/components 0.1.0 → 0.2.1

package/dist/terminal/backends.js.map

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

package/dist/terminal/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/hx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx.d.ts","sourceRoot":"","sources":["../../src/terminal/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/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/hx.js.map

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

package/dist/terminal/index.d.ts

@@ -0,0 +1,160 @@
+import type { ReactElement, ReactNode, Ref } from 'react';
+import type { Style } from 'react-x11/style';
+import type { EmbedStatus, ExitInfo, ProcessHost } from '../embed/index.js';
+import type { TerminalBackendName, TerminalColors } from './backends.js';
+import type { PtyHost } from './vt/pty.js';
+export { TERMINAL_BACKENDS, alacritty, backendsFor, urxvt, xterm, } from './backends.js';
+export type { TerminalBackend, TerminalBackendName, TerminalColors, TerminalLaunch, } from './backends.js';
+/** What a `ref` on `<Terminal>` gets. */
+export interface TerminalHandle {
+    /** Stop the emulator and start a new one. The scrollback is the old
+     *  process's and does not survive; nothing else was ours to keep. */
+    restart(): void;
+    /** Signal the emulator process. `SIGTERM` by default; `false` when there
+     *  is no process to signal. */
+    signal(signal?: string): boolean;
+    /** The emulator's pid, or `null`. */
+    readonly pid: number | null;
+    /** The `<foreign>` container's X window id — what the emulator was given.
+     *  `null` on the vt backend, which has no child X window. */
+    readonly windowId: number | null;
+    /** Which backend was chosen, once one has been. */
+    readonly backend: string | null;
+    readonly status: EmbedStatus;
+    /**
+     * Type into the terminal. **vt backend only** — `false` everywhere else,
+     * for the reason at the top of this file, so an app can feature-test with
+     * the call itself.
+     */
+    write(data: string): boolean;
+    /** Re-derive the grid from the current layout now, rather than at the next
+     *  paint. vt only. */
+    resizeToFit(): void;
+    /** Columns and rows the emulator currently has. vt only. */
+    readonly cols: number | null;
+    readonly rows: number | null;
+    /** The selected text, or null. vt only. */
+    selection(): string | null;
+    clearSelection(): void;
+    scrollToBottom(): void;
+    /** Move the viewport by `n` lines — negative is back into the scrollback. */
+    scrollLines(n: number): void;
+    /** The visible screen as text: "copy all", and what a test asserts on. */
+    serialize(): string | null;
+}
+export interface TerminalProps {
+    /**
+     * argv to run, `['bash', '-lc', 'npm test']`. Omit it for the user's login
+     * shell, which is what every emulator here does with no `-e`.
+     *
+     * **Changing this restarts the terminal**, because an emulator cannot be
+     * handed a new command. Pass a stable array (or a stable `useMemo`) unless a
+     * restart is what you mean — the component keys on the *contents*, not the
+     * identity, so an inline literal is fine as long as its contents are.
+     */
+    command?: readonly string[];
+    cwd?: string;
+    /** Added to the ambient environment, not a replacement for it. */
+    env?: Record<string, string | undefined>;
+    /**
+     * Which terminal. Default `'auto'`: the first of xterm, urxvt, alacritty
+     * that is installed, and `'vt'` — this package's own emulator, which needs
+     * nothing installed — when none of them is.
+     */
+    backend?: TerminalBackendName;
+    fontFamily?: string;
+    fontSize?: number;
+    /** Lines of scrollback the emulator keeps. */
+    scrollback?: number;
+    /** The emulator's window title before the program sets one of its own.
+     *  XEmbed backends only — the vt backend has no window of its own to name,
+     *  and reports the program's own title through `onTitleChange`. */
+    title?: string;
+    /**
+     * Colours for the emulator. Default: the react-x11 theme's `background` and
+     * `text`, with the accent as the cursor, so the pane matches the app around
+     * it. Pass `{}` to leave the emulator on its own defaults, or override any
+     * subset.
+     *
+     * `palette` (ANSI 0–15) reaches xterm and alacritty; urxvt takes its from
+     * the X resource database, which is the user's and not ours to write.
+     */
+    colors?: TerminalColors;
+    /** The program exited — including because `restart()` or unmount killed
+     *  it. */
+    onExit?: (info: ExitInfo) => void;
+    /** The emulator's `_NET_WM_NAME` changed: what the shell says is running. */
+    onTitleChange?: (title: string) => void;
+    /** Spawn failures, and the `BackendUnavailableError` for a machine with no
+     *  emulator installed. Without a handler neither is reported anywhere —
+     *  `status` and `fallback` are the visible half. */
+    onError?: (err: Error) => void;
+    /** Rendered instead of the surface when no backend is installed. */
+    fallback?: ReactNode;
+    /** False holds off spawning — a pane in a tab that is not open yet. */
+    enabled?: boolean;
+    /** Sent on unmount and restart. Default `SIGTERM`. */
+    stopSignal?: string;
+    /**
+     * Where the process runs. Defaults to this machine, through node. The seam
+     * is public because "run it in a container / over ssh / under a sandbox" is
+     * a real thing to want and should not need a fork — and because it is what
+     * the tests drive.
+     */
+    processes?: ProcessHost;
+    /** A terminal is a control the user tabs to. False for a decorative one. */
+    focusable?: boolean;
+    style?: Style | Style[];
+    ref?: Ref<TerminalHandle>;
+    'data-testname'?: string;
+    /** Default `'block'`. */
+    cursorStyle?: 'block' | 'underline' | 'bar';
+    /** Default true. */
+    cursorBlink?: boolean;
+    /** The program rang the bell. */
+    onBell?: () => void;
+    /** What the bell looks like. Default `'none'`; `'visual'` flashes the pane. */
+    bell?: 'none' | 'visual';
+    /** Honour OSC 52 clipboard *writes* — how `tmux` and `vim` copy out of an
+     *  ssh session. Default true. Reads are never answered, at any setting. */
+    allowClipboardWrite?: boolean;
+    /** The user finished selecting; the text is also on PRIMARY. */
+    onSelectionChange?: (text: string) => void;
+    /**
+     * Where the pty comes from. The `processes` seam's counterpart, public for
+     * the same reason — "run the shell in a container / over ssh / under a
+     * sandbox" is a real thing to want — and what the tests drive.
+     */
+    pty?: PtyHost;
+}
+/**
+ * A terminal emulator, laid out like any other element.
+ *
+ * ```jsx
+ * <Terminal
+ *   command={['bash', '-lc', 'npm test']}
+ *   cwd={projectDir}
+ *   style={{ flexGrow: 1 }}
+ *   onExit={({ code }) => setDone(code === 0)}
+ *   onTitleChange={setTabLabel}
+ *   fallback={<text>Install xterm to use the console.</text>}
+ * />
+ * ```
+ *
+ * **On an XEmbed backend the emulator's window stacks above everything drawn
+ * in this one**, the same rule `<glarea>` has, so nothing 2D can overlap it:
+ * an overlay belongs in a sibling `<popup>`. The vt backend has no child
+ * window and composites like any other node, so a `<popup>` over it works.
+ *
+ * **Keys reach the app first.** While the terminal holds focus, react-x11
+ * dispatches each key through the React tree and forwards whatever nothing
+ * called `preventDefault()` on — so an application chord still wins. The one
+ * exception is X's own rule that the pointer position picks the recipient:
+ * while the pointer is *over* an embedded emulator, keys go straight to it.
+ *
+ * **The vt backend is the floor.** With `backend="auto"` (the default), a
+ * machine with no emulator installed gets this package's own — so `fallback`
+ * renders only when the pty module or `@xterm/headless` is missing too.
+ */
+export declare function Terminal(props: TerminalProps): ReactElement;
+//# sourceMappingURL=index.d.ts.map

package/dist/terminal/index.d.ts.map

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

package/dist/terminal/index.js

@@ -0,0 +1,344 @@
+// <Terminal> — a real terminal emulator, embedded as an element.
+//
+// The first of the two XEmbed wrappers (the other is `../media-player/`), and
+// the reason `<foreign>` exists in core at all: a react-x11 app can now *host*
+// another X client instead of only drawing its own pixels.
+//
+// What this component is, mechanically: a `<foreign>` with no `windowId`, so
+// it adopts whatever is put inside it; `xterm -into $WID` spawned with the id
+// core hands over in `onReady`; and a per-backend adapter table
+// (`./backends.ts`) that turns one set of props into three different command
+// lines. Layout, focus, the ICCCM configure and handing the client back on
+// unmount are all core's — see react-x11's `foreignnodes.js`.
+//
+// Registers no element *itself*: `<foreign>` is a built-in, and the vt
+// backend's `<vtterm>` is registered by `./vt/index.ts`, which is reached
+// only through a dynamic `import()`. So this module still has **no side
+// effect at import time at all**, and an app on an XEmbed backend never loads
+// the emulator core.
+//
+// ### The second backend
+//
+// `backend="vt"` is the same component over a pty and `@xterm/headless`,
+// rendered as a native element rather than as somebody else's X window. It is
+// what makes `write()` real — the pty is ours — and what works on a machine
+// with no emulator installed, which is why `'auto'` ends there rather than at
+// the `fallback`.
+//
+// **`write()` still returns `false` on the XEmbed backends**, and that is not
+// an oversight: the pty belongs to xterm, so "type this" would have to be
+// synthetic X key events, which xterm ignores unless `allowSendEvents` is on
+// (a documented security setting, off by default and not ours to change in a
+// user's terminal) and which alacritty's event loop filters out entirely.
+// Returning `false` rather than throwing lets an app feature-test with the
+// call itself.
+import React, { useCallback, useEffect, useMemo, useRef, useState, } from 'react';
+import { useTheme } from 'react-x11';
+import { BackendUnavailableError, resolveBackend, useEmbeddedClient, } from '../embed/index.js';
+import { backendsFor } from './backends.js';
+import { useForeignTitle } from './title.js';
+import { hx } from './hx.js';
+export { TERMINAL_BACKENDS, alacritty, backendsFor, urxvt, xterm, } from './backends.js';
+const h = React.createElement;
+/** The props only the vt backend reads, for the development warning below. */
+const VT_ONLY = [
+    'cursorStyle',
+    'cursorBlink',
+    'onBell',
+    'bell',
+    'allowClipboardWrite',
+    'onSelectionChange',
+    'pty',
+];
+/**
+ * Say so, once, when a vt-only prop was passed to an embedded emulator.
+ *
+ * `process` and `console` come off `globalThis` because the build compiles
+ * `src/` with `types: []` — a Node global that wanders in has to fail the
+ * build rather than become an implicit `@types/node` dependency.
+ */
+function warnVtOnly(props) {
+    const g = globalThis;
+    if (g.process?.env?.NODE_ENV === 'production')
+        return;
+    const named = VT_ONLY.filter((name) => props[name] !== undefined);
+    if (named.length === 0)
+        return;
+    g.console?.warn(`@react-x11/components: <Terminal ${named.join(', ')}> ` +
+        `${named.length === 1 ? 'is' : 'are'} only honoured by ` +
+        'backend="vt" — an embedded emulator owns its own cursor, bell and ' +
+        'clipboard.');
+}
+/**
+ * A terminal emulator, laid out like any other element.
+ *
+ * ```jsx
+ * <Terminal
+ *   command={['bash', '-lc', 'npm test']}
+ *   cwd={projectDir}
+ *   style={{ flexGrow: 1 }}
+ *   onExit={({ code }) => setDone(code === 0)}
+ *   onTitleChange={setTabLabel}
+ *   fallback={<text>Install xterm to use the console.</text>}
+ * />
+ * ```
+ *
+ * **On an XEmbed backend the emulator's window stacks above everything drawn
+ * in this one**, the same rule `<glarea>` has, so nothing 2D can overlap it:
+ * an overlay belongs in a sibling `<popup>`. The vt backend has no child
+ * window and composites like any other node, so a `<popup>` over it works.
+ *
+ * **Keys reach the app first.** While the terminal holds focus, react-x11
+ * dispatches each key through the React tree and forwards whatever nothing
+ * called `preventDefault()` on — so an application chord still wins. The one
+ * exception is X's own rule that the pointer position picks the recipient:
+ * while the pointer is *over* an embedded emulator, keys go straight to it.
+ *
+ * **The vt backend is the floor.** With `backend="auto"` (the default), a
+ * machine with no emulator installed gets this package's own — so `fallback`
+ * renders only when the pty module or `@xterm/headless` is missing too.
+ */
+export function Terminal(props) {
+    const { backend = 'auto', enabled = true, focusable, processes, stopSignal, } = props;
+    const theme = useTheme();
+    // Everything that goes into the command line, as one string.
+    //
+    // This is the restart key, and it is a string rather than a dependency list
+    // for the reason `useDesktopCalendarEvents` keys on `from.getTime()`:
+    // `command={['bash']}` and `colors={{}}` are new identities on every paint,
+    // and an effect keyed on them would kill and respawn a terminal per frame.
+    const colors = useMemo(() => {
+        if (props.colors)
+            return props.colors;
+        return {
+            background: String(theme.background ?? '#101014'),
+            foreground: String(theme.text ?? '#e6e6e6'),
+            cursor: String(theme.accent ?? theme.text ?? '#e6e6e6'),
+        };
+        // The theme object is stable per palette in react-x11, so this recomputes
+        // when the desktop switches light/dark and not otherwise.
+    }, [props.colors, theme]);
+    const launch = useMemo(() => ({
+        command: props.command,
+        title: props.title,
+        fontFamily: props.fontFamily,
+        fontSize: props.fontSize,
+        scrollback: props.scrollback,
+        colors,
+    }), [
+        props.command,
+        props.title,
+        props.fontFamily,
+        props.fontSize,
+        props.scrollback,
+        colors,
+    ]);
+    const key = useMemo(() => JSON.stringify([
+        backend,
+        launch.command ?? null,
+        props.cwd ?? null,
+        props.env ?? null,
+        launch.title ?? null,
+        launch.fontFamily ?? null,
+        launch.fontSize ?? null,
+        launch.scrollback ?? null,
+        colors,
+    ]), [backend, launch, props.cwd, props.env, colors]);
+    // Read through a ref so the factory's identity — the restart signal — is
+    // the key and nothing else. Without this an `env={{ TERM: 'xterm-256color' }}`
+    // literal would restart the terminal on every render.
+    const latest = React.useRef({ launch, cwd: props.cwd, env: props.env });
+    latest.current = { launch, cwd: props.cwd, env: props.env };
+    const plan = useMemo(() => async ({ windowId, host }) => {
+        const candidates = backendsFor(backend);
+        if (candidates.length === 0) {
+            throw new BackendUnavailableError('terminal', [backend]);
+        }
+        const chosen = await resolveBackend(host, 'terminal', candidates);
+        const current = latest.current;
+        return {
+            command: chosen.path,
+            args: chosen.backend.args({ ...current.launch, windowId }),
+            cwd: current.cwd,
+            env: current.env,
+            backend: chosen.backend.name,
+        };
+    }, 
+    // `key` is the whole dependency: it is the serialization of everything
+    // `latest.current` is read for.
+    [backend, key]);
+    // --- which half of the component is running ------------------------------
+    //
+    // `'vt'` asks for it outright; `'auto'` arrives here only after the PATH
+    // probe found no emulator, which is what makes vt the floor rather than a
+    // parallel option. Both halves' hooks run unconditionally — the one that is
+    // not in use is simply disabled — because that is what hooks require and
+    // because a `<Terminal>` that flips backends must not remount the other one.
+    const [vtFallback, setVtFallback] = useState(false);
+    const vt = backend === 'vt' || (backend === 'auto' && vtFallback);
+    useEffect(() => {
+        if (backend !== 'auto')
+            setVtFallback(false);
+    }, [backend]);
+    const client = useEmbeddedClient({
+        plan,
+        host: processes,
+        enabled: enabled && !vt,
+        stopSignal,
+        onExit: props.onExit,
+        onError: props.onError,
+    });
+    useEffect(() => {
+        if (backend === 'auto' && client.status === 'unavailable') {
+            setVtFallback(true);
+        }
+    }, [backend, client.status]);
+    // Not `vt`, because `'auto'` may still land there: what is worth a warning
+    // is a backend that was *named* and cannot honour the prop.
+    useEffect(() => {
+        if (backend !== 'auto' && backend !== 'vt')
+            warnVtOnly(props);
+        // Once per backend change, not once per render — the props object is a
+        // new identity every time and this is a diagnostic, not a subscription.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [backend]);
+    const title = useForeignTitle(props.onTitleChange);
+    // The vt module is loaded on demand and never at import time: this is the
+    // whole tree-shaking bargain — `@xterm/headless` and the renderer are a
+    // separate chunk that an XEmbed app never fetches.
+    const [vtModule, setVtModule] = useState(null);
+    const [vtStatus, setVtStatus] = useState('idle');
+    const onErrorRef = useRef(props.onError);
+    onErrorRef.current = props.onError;
+    useEffect(() => {
+        if (!vt || vtModule)
+            return undefined;
+        let live = true;
+        void import('./vt/index.js')
+            .then((mod) => {
+            if (live)
+                setVtModule(mod);
+        })
+            .catch((err) => {
+            if (!live)
+                return;
+            setVtStatus('unavailable');
+            onErrorRef.current?.(err instanceof Error ? err : new Error(String(err)));
+        });
+        return () => {
+            live = false;
+        };
+    }, [vt, vtModule]);
+    const vtHandle = useRef(null);
+    const onVtStatus = useCallback((next) => setVtStatus(next), []);
+    React.useImperativeHandle(props.ref, () => ({
+        restart: () => (vt ? vtHandle.current?.restart() : client.restart()),
+        signal: (signal) => vt
+            ? (vtHandle.current?.signal(signal) ?? false)
+            : client.signal(signal),
+        write: (data) => vtHandle.current?.write(data) ?? false,
+        resizeToFit: () => vtHandle.current?.resizeToFit(),
+        selection: () => vtHandle.current?.selection() ?? null,
+        clearSelection: () => vtHandle.current?.clearSelection(),
+        scrollToBottom: () => vtHandle.current?.scrollToBottom(),
+        scrollLines: (n) => vtHandle.current?.scrollLines(n),
+        serialize: () => vtHandle.current?.serialize() ?? null,
+        get pid() {
+            return vt ? (vtHandle.current?.pid ?? null) : client.pid;
+        },
+        get windowId() {
+            // The vt backend draws into this window; there is no child to name.
+            return vt ? null : client.windowId;
+        },
+        get backend() {
+            return vt ? 'vt' : client.backend;
+        },
+        get status() {
+            return vt ? vtStatus : client.status;
+        },
+        get cols() {
+            return vtHandle.current?.cols ?? null;
+        },
+        get rows() {
+            return vtHandle.current?.rows ?? null;
+        },
+    }), [client, vt, vtStatus]);
+    const style = {
+        flexGrow: 1,
+        // What the container shows before the emulator's window covers it, and
+        // between an exit and a restart. `<foreign>` reads it off the ordinary
+        // `backgroundColor` rather than a prop of its own.
+        backgroundColor: colors.background ?? String(theme.background ?? '#101014'),
+    };
+    const styles = [style];
+    if (props.style) {
+        for (const extra of Array.isArray(props.style)
+            ? props.style
+            : [props.style]) {
+            styles.push(extra);
+        }
+    }
+    if (vt) {
+        // Nothing installed *at all* — no emulator, and no pty module or no
+        // `@xterm/headless` either — is still an ordinary state of a healthy
+        // machine, and still a status plus a fallback rather than a throw.
+        if (vtStatus === 'unavailable' && props.fallback !== undefined) {
+            return h(React.Fragment, null, props.fallback);
+        }
+        if (!vtModule) {
+            // The dynamic import is in flight. An empty box in the terminal's own
+            // background holds the layout, so the pane does not jump when it lands.
+            return hx('box', { style: styles });
+        }
+        const vtProps = {
+            command: props.command,
+            cwd: props.cwd,
+            env: props.env,
+            colors,
+            fontFamily: props.fontFamily,
+            fontSize: props.fontSize,
+            scrollback: props.scrollback,
+            cursorStyle: props.cursorStyle,
+            cursorBlink: props.cursorBlink,
+            bell: props.bell,
+            onBell: props.onBell,
+            allowClipboardWrite: props.allowClipboardWrite,
+            onSelectionChange: props.onSelectionChange,
+            pty: props.pty,
+            enabled,
+            stopSignal,
+            focusable: focusable ?? true,
+            onExit: props.onExit,
+            onTitleChange: props.onTitleChange,
+            onError: props.onError,
+            onStatus: onVtStatus,
+            style: styles,
+            ref: vtHandle,
+            'data-testname': props['data-testname'],
+        };
+        return h(vtModule.VtTerminal, vtProps);
+    }
+    // No backend installed is an ordinary state of a perfectly healthy machine,
+    // not an error to report — the same call `useDesktopCalendarEvents` makes
+    // about a desktop with no Evolution Data Server.
+    if (client.status === 'unavailable' && props.fallback !== undefined) {
+        return h(React.Fragment, null, props.fallback);
+    }
+    const foreign = {
+        onReady: client.handleReady,
+        onEmbedded: title.onEmbedded,
+        onClientGone: title.onClientGone,
+        focusable: focusable ?? true,
+        'aria-label': 'Terminal',
+        style: styles,
+    };
+    // `data-testname` is a runtime convention — react-x11's queries read it off
+    // `props` — and its element declarations do not carry it. Attached past the
+    // type here so the rest of the object above is still checked against
+    // `<foreign>`, which is the whole reason `hx` exists.
+    return hx('foreign', {
+        ...foreign,
+        'data-testname': props['data-testname'],
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/terminal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/terminal/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,2DAA2D;AAC3D,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,gEAAgE;AAChE,6EAA6E;AAC7E,2EAA2E;AAC3E,8DAA8D;AAC9D,EAAE;AACF,uEAAuE;AACvE,0EAA0E;AAC1E,wEAAwE;AACxE,8EAA8E;AAC9E,qBAAqB;AACrB,EAAE;AACF,yBAAyB;AACzB,EAAE;AACF,yEAAyE;AACzE,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,kBAAkB;AAClB,EAAE;AACF,8EAA8E;AAC9E,0EAA0E;AAC1E,6EAA6E;AAC7E,6EAA6E;AAC7E,0EAA0E;AAC1E,2EAA2E;AAC3E,eAAe;AACf,OAAO,KAAK,EAAE,EACZ,WAAW,EACX,SAAS,EACT,OAAO,EACP,MAAM,EACN,QAAQ,GACT,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIrC,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAI7B,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,KAAK,EACL,KAAK,GACN,MAAM,eAAe,CAAC;AAQvB,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;AAqJ9B,8EAA8E;AAC9E,MAAM,OAAO,GAAG;IACd,aAAa;IACb,aAAa;IACb,QAAQ;IACR,MAAM;IACN,qBAAqB;IACrB,mBAAmB;IACnB,KAAK;CACG,CAAC;AAEX;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,KAAoB;IACtC,MAAM,CAAC,GAAG,UAGT,CAAC;IACF,IAAI,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,YAAY;QAAE,OAAO;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;IAClE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC/B,CAAC,CAAC,OAAO,EAAE,IAAI,CACb,oCAAoC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACtD,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,oBAAoB;QACxD,oEAAoE;QACpE,YAAY,CACf,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,MAAM,EACJ,OAAO,GAAG,MAAM,EAChB,OAAO,GAAG,IAAI,EACd,SAAS,EACT,SAAS,EACT,UAAU,GACX,GAAG,KAAK,CAAC;IACV,MAAM,KAAK,GAAG,QAAQ,EAAwC,CAAC;IAE/D,6DAA6D;IAC7D,EAAE;IACF,4EAA4E;IAC5E,sEAAsE;IACtE,4EAA4E;IAC5E,2EAA2E;IAC3E,MAAM,MAAM,GAAG,OAAO,CAAiB,GAAG,EAAE;QAC1C,IAAI,KAAK,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC,MAAM,CAAC;QACtC,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,SAAS,CAAC;YACjD,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC;YAC3C,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC;SACxD,CAAC;QACF,0EAA0E;QAC1E,0DAA0D;IAC5D,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAE1B,MAAM,MAAM,GAAG,OAAO,CACpB,GAAG,EAAE,CAAC,CAAC;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM;KACP,CAAC,EACF;QACE,KAAK,CAAC,OAAO;QACb,KAAK,CAAC,KAAK;QACX,KAAK,CAAC,UAAU;QAChB,KAAK,CAAC,QAAQ;QACd,KAAK,CAAC,UAAU;QAChB,MAAM;KACP,CACF,CAAC;IAEF,MAAM,GAAG,GAAG,OAAO,CACjB,GAAG,EAAE,CACH,IAAI,CAAC,SAAS,CAAC;QACb,OAAO;QACP,MAAM,CAAC,OAAO,IAAI,IAAI;QACtB,KAAK,CAAC,GAAG,IAAI,IAAI;QACjB,KAAK,CAAC,GAAG,IAAI,IAAI;QACjB,MAAM,CAAC,KAAK,IAAI,IAAI;QACpB,MAAM,CAAC,UAAU,IAAI,IAAI;QACzB,MAAM,CAAC,QAAQ,IAAI,IAAI;QACvB,MAAM,CAAC,UAAU,IAAI,IAAI;QACzB,MAAM;KACP,CAAC,EACJ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAChD,CAAC;IAEF,yEAAyE;IACzE,+EAA+E;IAC/E,sDAAsD;IACtD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IACxE,MAAM,CAAC,OAAO,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IAE5D,MAAM,IAAI,GAAG,OAAO,CAClB,GAAG,EAAE,CACH,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAe,EAAuB,EAAE;QAC7D,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,uBAAuB,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,IAAI;YACpB,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;YAC1D,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;SAC7B,CAAC;IACJ,CAAC;IACH,uEAAuE;IACvE,gCAAgC;IAChC,CAAC,OAAO,EAAE,GAAG,CAAC,CACf,CAAC;IAEF,4EAA4E;IAC5E,EAAE;IACF,yEAAyE;IACzE,0EAA0E;IAC1E,4EAA4E;IAC5E,yEAAyE;IACzE,6EAA6E;IAC7E,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,EAAE,GAAG,OAAO,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,UAAU,CAAC,CAAC;IAClE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,KAAK,MAAM;YAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,MAAM,GAAG,iBAAiB,CAAC;QAC/B,IAAI;QACJ,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO,IAAI,CAAC,EAAE;QACvB,UAAU;QACV,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,KAAK,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YAC1D,aAAa,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAE7B,2EAA2E;IAC3E,4DAA4D;IAC5D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,IAAI;YAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QAC9D,uEAAuE;QACvE,wEAAwE;QACxE,uDAAuD;IACzD,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAEnD,0EAA0E;IAC1E,wEAAwE;IACxE,mDAAmD;IACnD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAkB,IAAI,CAAC,CAAC;IAChE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAc,MAAM,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAEnC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,EAAE,IAAI,QAAQ;YAAE,OAAO,SAAS,CAAC;QACtC,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,KAAK,MAAM,CAAC,eAAe,CAAC;aACzB,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YACZ,IAAI,IAAI;gBAAE,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,IAAI,CAAC,IAAI;gBAAE,OAAO;YAClB,WAAW,CAAC,aAAa,CAAC,CAAC;YAC3B,UAAU,CAAC,OAAO,EAAE,CAClB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CACpD,CAAC;QACJ,CAAC,CAAC,CAAC;QACL,OAAO,GAAG,EAAE;YACV,IAAI,GAAG,KAAK,CAAC;QACf,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEnB,MAAM,QAAQ,GAAG,MAAM,CAAkB,IAAI,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,IAAiB,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAE7E,KAAK,CAAC,mBAAmB,CACvB,KAAK,CAAC,GAAG,EACT,GAAG,EAAE,CAAC,CAAC;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpE,MAAM,EAAE,CAAC,MAAe,EAAE,EAAE,CAC1B,EAAE;YACA,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;YAC7C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3B,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK;QAC/D,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE;QAClD,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI;QACtD,cAAc,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE;QACxD,cAAc,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE;QACxD,WAAW,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;QAC5D,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI;QACtD,IAAI,GAAG;YACL,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC3D,CAAC;QACD,IAAI,QAAQ;YACV,oEAAoE;YACpE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACrC,CAAC;QACD,IAAI,OAAO;YACT,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACpC,CAAC;QACD,IAAI,MAAM;YACR,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;QACvC,CAAC;QACD,IAAI,IAAI;YACN,OAAO,QAAQ,CAAC,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC;QACxC,CAAC;QACD,IAAI,IAAI;YACN,OAAO,QAAQ,CAAC,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC;QACxC,CAAC;KACF,CAAC,EACF,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,CAAC,CACvB,CAAC;IAEF,MAAM,KAAK,GAAU;QACnB,QAAQ,EAAE,CAAC;QACX,uEAAuE;QACvE,uEAAuE;QACvE,mDAAmD;QACnD,eAAe,EAAE,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,SAAS,CAAC;KAC5E,CAAC;IACF,MAAM,MAAM,GAAY,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;YAC5C,CAAC,CAAC,KAAK,CAAC,KAAK;YACb,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,IAAI,EAAE,EAAE,CAAC;QACP,oEAAoE;QACpE,qEAAqE;QACrE,mEAAmE;QACnE,IAAI,QAAQ,KAAK,aAAa,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC/D,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,sEAAsE;YACtE,wEAAwE;YACxE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,OAAO,GAAoB;YAC/B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,MAAM;YACN,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;YAC9C,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;YAC1C,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,OAAO;YACP,UAAU;YACV,SAAS,EAAE,SAAS,IAAI,IAAI;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,UAAU;YACpB,KAAK,EAAE,MAAM;YACb,GAAG,EAAE,QAAQ;YACb,eAAe,EAAE,KAAK,CAAC,eAAe,CAAC;SACxC,CAAC;QACF,OAAO,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,4EAA4E;IAC5E,0EAA0E;IAC1E,iDAAiD;IACjD,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACpE,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,OAAO,GAAwB;QACnC,OAAO,EAAE,MAAM,CAAC,WAAW;QAC3B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,SAAS,EAAE,SAAS,IAAI,IAAI;QAC5B,YAAY,EAAE,UAAU;QACxB,KAAK,EAAE,MAAM;KACd,CAAC;IAEF,4EAA4E;IAC5E,4EAA4E;IAC5E,qEAAqE;IACrE,sDAAsD;IACtD,OAAO,EAAE,CAAC,SAAS,EAAE;QACnB,GAAG,OAAO;QACV,eAAe,EAAE,KAAK,CAAC,eAAe,CAAC;KACjB,CAAC,CAAC;AAC5B,CAAC"}

package/dist/terminal/title.d.ts

@@ -0,0 +1,24 @@
+export interface ForeignTitleHandlers {
+    onEmbedded: (info: {
+        id: number;
+    }) => void;
+    onClientGone: () => void;
+}
+/**
+ * Watch the embedded client's title.
+ *
+ * Returns the two `<foreign>` handlers to spread, which is why this is a hook
+ * and not an effect the component writes itself: the client id exists only
+ * between `onEmbedded` and `onClientGone`, and both of those are props the
+ * component also wants to forward to its own caller.
+ *
+ * ```js
+ * const title = useForeignTitle(props.onTitleChange);
+ * <foreign onEmbedded={title.onEmbedded} onClientGone={title.onClientGone} />
+ * ```
+ *
+ * With no `onTitleChange` nothing is read at all — no atoms interned, no round
+ * trip — because most terminals in most apps are not labelled.
+ */
+export declare function useForeignTitle(onTitleChange?: (title: string) => void): ForeignTitleHandlers;
+//# sourceMappingURL=title.d.ts.map

package/dist/terminal/title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.d.ts","sourceRoot":"","sources":["../../src/terminal/title.ts"],"names":[],"mappings":"AAwEA,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC3C,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GACtC,oBAAoB,CA4EtB"}