@react-x11/components 0.1.0 → 0.2.0

package/dist/tray-host/index.js

@@ -0,0 +1,191 @@
+// <TrayHost> — the system tray, on `<foreign>`.
+//
+// The third XEmbed consumer in this package and the one pointed the other
+// way: `<Terminal>` and `<MediaPlayer>` spawn a program *into* a container,
+// while a tray is handed windows by applications that were already running.
+// Everything hard about taking one — the reparent, the save set,
+// `_XEMBED_INFO`, the focus messages, the synthetic ICCCM ConfigureNotify,
+// and handing the client back **without destroying it** on unmount — is
+// core's `<foreign>` and is done (react-x11#277).
+//
+// What is left, and what is here:
+//
+//  - **`./manager.ts`** — the `_NET_SYSTEM_TRAY_S<screen>` selection, the
+//    `MANAGER` broadcast, the two advertised properties, opcode routing and
+//    `SelectionClear`.
+//  - **`./protocol.ts`** — the spec as data: atoms, opcodes, the balloon
+//    reassembler, and whether a visual may honestly be advertised.
+//  - **this file** — the icon list as React state, one `<foreign>` per icon.
+//
+// Registers no element: `<foreign>` and `<box>` are both built in. Like
+// `<Terminal>`, this module has **no side effect at import time at all**.
+//
+// ### What is deliberately not here
+//
+// **StatusNotifierItem.** Modern applications publish a tray icon over D-Bus
+// rather than XEmbed, and a complete panel supports both — but SNI shares
+// nothing with this except intent, and it pairs with core's `dbusmenu.js`
+// rather than with `<foreign>`. It is a sibling component, not a mode of
+// this one.
+//
+// **The plug side.** Being embedded *as* a tray icon is a root option that
+// changes how a connection's first window is created, which is renderer
+// internals by definition. Same protocol, opposite side of the seam, and
+// core's.
+import React, { useEffect, useMemo, useRef, useState } from 'react';
+import { useApp, useWindowId } from 'react-x11';
+import { hx } from './hx.js';
+import { TrayManager } from './manager.js';
+import { BalloonNotifier } from './notify.js';
+export { BalloonAssembler, MANAGER_ATOM, MESSAGE_DATA_ATOM, OPCODE_ATOM, ORIENTATION_ATOM, ORIENTATION_HORIZONTAL, ORIENTATION_VERTICAL, SYSTEM_TRAY_BEGIN_MESSAGE, SYSTEM_TRAY_CANCEL_MESSAGE, SYSTEM_TRAY_REQUEST_DOCK, VISUAL_ATOM, argbVisualOf, decodeUtf8, orientationValue, selectionNameFor, } from './protocol.js';
+export { TrayManager } from './manager.js';
+export { BalloonNotifier } from './notify.js';
+const h = React.createElement;
+const NO_ICONS = [];
+/**
+ * The system tray: applications dock their icons into it, and it lays them
+ * out like any other row of elements.
+ *
+ * ```jsx
+ * <TrayHost
+ *   orientation="horizontal"
+ *   iconSize={22}
+ *   onDock={(icon) => log(`docked ${icon.id}`)}
+ *   onUndock={(icon) => log(`gone ${icon.id}`)}
+ * />
+ * ```
+ *
+ * **One per display.** Mounting takes `_NET_SYSTEM_TRAY_S<screen>` and
+ * announces it to the root, which is what makes applications that were
+ * waiting start docking; unmounting gives the selection back and hands every
+ * client back to the root untouched.
+ *
+ * **An icon that never maps is normal.** Clients set `XEMBED_MAPPED` when
+ * they are ready, and some take a while about it. The square is laid out
+ * either way, because a tray that only reserved space for icons it could see
+ * would reflow every time one woke up.
+ *
+ * **Icons are not tab stops.** A tray icon is a click target, and Tab
+ * walking through eleven of them — several of which are invisible — is the
+ * worst version of this, so every `<foreign>` here is `focusable={false}`.
+ */
+export function TrayHost(props) {
+    const { orientation = 'horizontal', iconSize = 22, spacing = 2, screen = 0, } = props;
+    const app = useApp();
+    const [icons, setIcons] = useState(NO_ICONS);
+    // Only the status is state. The conflict itself is read off the manager by
+    // the handle: nothing renders it, and mirroring it would be a second copy
+    // of a fact that already has an owner.
+    const [status, setStatus] = useState('starting');
+    const boxRef = useRef(null);
+    const hostWindowId = useWindowId(boxRef);
+    // Read at the moment they fire, so an inline `onDock` is not a reason to
+    // give the selection up and take it again.
+    const latest = useRef(props);
+    latest.current = props;
+    const manager = useMemo(() => new TrayManager(app, screen), [app, screen]);
+    useEffect(() => {
+        const notifier = new BalloonNotifier();
+        manager.handlers = {
+            onIcons: setIcons,
+            onDock: (icon) => latest.current.onDock?.(icon),
+            onUndock: (icon) => latest.current.onUndock?.(icon),
+            onStatus: (next, info) => {
+                setStatus(next);
+                latest.current.onStatusChange?.(next);
+                if (next === 'conflict' && info)
+                    latest.current.onConflict?.(info);
+            },
+            onMessage: (message) => {
+                const own = latest.current.onMessage;
+                // The seam wins: a panel drawing its own bubble should not also
+                // raise a notification for the same text.
+                if (own) {
+                    own(message);
+                    return;
+                }
+                if (latest.current.notify === false)
+                    return;
+                void notifier
+                    .send(message, latest.current.appName)
+                    .catch((err) => latest.current.onError?.(err instanceof Error ? err : new Error(String(err))));
+            },
+            onCancelMessage: (info) => latest.current.onCancelMessage?.(info),
+            onError: (err) => latest.current.onError?.(err),
+        };
+        // The orientation is read here rather than being a dependency: changing
+        // it republishes one property (below) and must not cost the selection.
+        void manager.start({
+            orientation: latest.current.orientation ?? 'horizontal',
+            hostWindowId: hostWindowId(),
+        });
+        return () => {
+            manager.stop();
+            void notifier.dispose();
+        };
+    }, [manager, hostWindowId]);
+    useEffect(() => {
+        manager.setOrientation(orientation);
+    }, [manager, orientation]);
+    React.useImperativeHandle(props.ref, () => ({
+        get status() {
+            return manager.status;
+        },
+        get conflict() {
+            return manager.conflict;
+        },
+        get icons() {
+            return manager.icons;
+        },
+        get windowId() {
+            return manager.windowId || null;
+        },
+    }), [manager]);
+    const sort = props.sort;
+    const ordered = useMemo(() => (sort ? [...icons].sort(sort) : icons), [icons, sort]);
+    const styles = [
+        {
+            flexDirection: orientation === 'vertical' ? 'column' : 'row',
+            alignItems: 'center',
+            gap: spacing,
+        },
+    ];
+    if (props.style) {
+        for (const extra of Array.isArray(props.style)
+            ? props.style
+            : [props.style]) {
+            styles.push(extra);
+        }
+    }
+    // Somebody else is the tray, and this host has embedded nothing. Rendering
+    // an empty row would look like a tray with no icons in it, which is the
+    // one thing it must not be mistaken for.
+    if (status === 'conflict' && props.fallback !== undefined) {
+        return h(React.Fragment, null, props.fallback);
+    }
+    const children = ordered.map((icon) => {
+        const foreign = {
+            // Keyed **and** addressed by the same id, so a reorder is a move: the
+            // node keeps its socket and the client is never handed between two.
+            key: icon.id,
+            windowId: icon.id,
+            focusable: false,
+            'aria-label': 'Tray icon',
+            onClientGone: () => manager.undock(icon.id),
+            style: { width: iconSize, height: iconSize, flexShrink: 0 },
+        };
+        return hx('foreign', {
+            ...foreign,
+            'data-testname': `tray-icon-${icon.id}`,
+        });
+    });
+    const container = { ref: boxRef, 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 so the rest of the object is still checked against `<box>`.
+    return hx('box', {
+        ...container,
+        'data-testname': props['data-testname'],
+    }, ...children);
+}
+//# sourceMappingURL=index.js.map

package/dist/tray-host/index.js.map

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

package/dist/tray-host/manager.d.ts

@@ -0,0 +1,137 @@
+import type { TrayIcon, TrayMessage, TrayOrientation } from './protocol.js';
+/**
+ * Where a tray host is in its life.
+ *
+ * `'conflict'` and `'unavailable'` are both ordinary states of a healthy
+ * machine rather than failures — a second panel on one display is a
+ * configuration mistake, and a connection with no raw protocol access (a
+ * headless mock) simply has no tray to be. Same call `<Terminal>` makes
+ * about a machine with no emulator installed.
+ */
+export type TrayStatus = 'starting' | 'owned' | 'conflict' | 'released' | 'unavailable';
+/** Somebody else is the tray. */
+export interface TrayConflict {
+    /** The X window that owns `_NET_SYSTEM_TRAY_S<screen>`. */
+    owner: number;
+    screen: number;
+}
+/** What the component wires up. Every one is optional; the manager runs
+ *  whether or not anybody is listening. */
+export interface TrayManagerHandlers {
+    /** The whole list, whenever it changes — what the component renders. */
+    onIcons?(icons: readonly TrayIcon[]): void;
+    onDock?(icon: TrayIcon): void;
+    onUndock?(icon: TrayIcon): void;
+    onStatus?(status: TrayStatus, conflict: TrayConflict | null): void;
+    onMessage?(message: TrayMessage): void;
+    onCancelMessage?(info: {
+        windowId: number;
+        id: number;
+    }): void;
+    onError?(err: Error): void;
+}
+/** The slice of the X connection this needs. `useApp()` is declared
+ *  `unknown` in core — it is the escape hatch, so the shape is written out
+ *  rather than imported. */
+interface XEvent {
+    type: number;
+    wid?: number;
+    atom?: number;
+    time?: number;
+    owner?: number;
+    selection?: number;
+    format?: number;
+    message_type?: number;
+    data?: number[];
+}
+interface XConnection {
+    AllocID(): number;
+    InternAtom(onlyIfExists: boolean, name: string, cb: (err: Error | null, atom: number) => void): void;
+    CreateWindow(id: number, parent: number, x: number, y: number, width: number, height: number, borderWidth: number, depth: number, klass: number, visual: number, values: Record<string, unknown>): void;
+    DestroyWindow(id: number): void;
+    ChangeProperty(mode: number, wid: number, name: number, type: number, format: number, data: readonly number[]): void;
+    GetSelectionOwner(atom: number, cb: (err: Error | null, owner: number) => void): void;
+    SetSelectionOwner(owner: number, atom: number, time: number): void;
+    GetWindowAttributes(wid: number, cb: (err: Error | null, attrs: {
+        visual: number;
+    }) => void): void;
+    SendEvent(destination: number, propagate: number, eventMask: number, event: Record<string, unknown>): void;
+    on(name: 'event', fn: (ev: XEvent) => void): void;
+    removeListener?(name: 'event', fn: (ev: XEvent) => void): void;
+}
+/** What ntk's app exposes that a tray needs. */
+export interface TrayApp {
+    X?: XConnection;
+    display?: {
+        screen?: {
+            root: number;
+            depths?: Record<number, Record<string, {
+                class?: number;
+            }>>;
+        }[];
+    };
+}
+export interface TrayManagerStartOptions {
+    orientation: TrayOrientation;
+    /**
+     * The top-level window the icons will be embedded into, so the visual it
+     * actually has can be advertised — or not. `null` skips the question and
+     * publishes no `_NET_SYSTEM_TRAY_VISUAL`.
+     */
+    hostWindowId: number | null;
+}
+/**
+ * The tray host's half of the system tray protocol.
+ *
+ * ```ts
+ * const manager = new TrayManager(app, 0);
+ * manager.handlers = { onIcons: setIcons };
+ * await manager.start({ orientation: 'horizontal', hostWindowId: id });
+ * // …
+ * manager.stop();
+ * ```
+ *
+ * Public because a panel that draws its own tray — one that does not want
+ * `<TrayHost>`'s layout — should not have to reimplement selection
+ * ownership, and because it is what the tests drive. Same reason
+ * `ProcessHost` is exported from `../embed/`.
+ */
+export declare class TrayManager {
+    #private;
+    /** Assign, do not construct with: the component replaces these every
+     *  render so an inline handler is not a reason to restart anything. */
+    handlers: TrayManagerHandlers;
+    constructor(app: TrayApp, screen?: number);
+    get status(): TrayStatus;
+    get conflict(): TrayConflict | null;
+    /** The manager selection window, once there is one. */
+    get windowId(): number;
+    get icons(): readonly TrayIcon[];
+    /**
+     * Take the selection, if nobody else has it.
+     *
+     * The order is the spec's: publish the properties, *then* take the
+     * selection, *then* broadcast `MANAGER`. A client that starts docking on
+     * the broadcast reads the properties immediately afterwards, so they have
+     * to be there before the announcement rather than after it.
+     */
+    start(options: TrayManagerStartOptions): Promise<void>;
+    /**
+     * Give the selection back and drop the manager window.
+     *
+     * The icons are *not* reparented here: each one is a `<foreign>`, and
+     * handing a client back untouched on unmount is that element's promise.
+     * All this does is stop being the tray.
+     */
+    stop(): void;
+    /** Republish `_NET_SYSTEM_TRAY_ORIENTATION`. Cheap and idempotent. */
+    setOrientation(orientation: TrayOrientation): void;
+    /**
+     * The icon's client went away — `<foreign onClientGone>`, which is the
+     * ordinary case here rather than an error: tray icons come and go with the
+     * applications that own them.
+     */
+    undock(id: number): void;
+}
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/tray-host/manager.d.ts.map

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