@react-x11/components 0.1.0 → 0.2.1

package/dist/tray-host/manager.js

@@ -0,0 +1,462 @@
+// The manager selection, and everything that arrives because of it.
+//
+// A tray host is three things on the wire: it owns `_NET_SYSTEM_TRAY_S<n>`,
+// it publishes two properties saying how it wants to be drawn into, and it
+// answers `_NET_SYSTEM_TRAY_OPCODE` messages addressed to the window that
+// owns that selection. None of it is React-shaped, so none of it is in the
+// component — `./index.ts` owns the icon list as state and this owns the
+// protocol that changes it.
+//
+// ### Why this listens on `X.on('event')` rather than `onClientMessage`
+//
+// Core has an element-scoped ClientMessage seam now, and it is the right
+// thing for an application — but it is a **`<window>`** prop, and the window
+// the tray opcodes are addressed to is not an element. It cannot be: the
+// selection has to be held on something that outlives the render, so this
+// creates its own window with `X.CreateWindow` rather than rendering one. A
+// `<TrayHost>` that unmounted while its panel stayed up would otherwise take
+// the selection with it and leave the desktop with no tray.
+//
+// That is exactly the case core's own `src/clientmessage.js` carves out:
+// filtering `X.on('event')` "is the right shape *there*, because a settings
+// daemon's window is nobody's element". A tray's manager window is the same
+// kind of window.
+//
+// The timestamp is the other half, and that one core does answer:
+// `serverTime()` is a current server timestamp for an operation no user
+// action caused, and its own documentation names a tray taking its manager
+// selection as the case. ICCCM 2.1 forbids `CurrentTime` here.
+import { serverTime } from 'react-x11';
+import { BalloonAssembler, MANAGER_ATOM, MESSAGE_DATA_ATOM, OPCODE_ATOM, ORIENTATION_ATOM, SYSTEM_TRAY_BEGIN_MESSAGE, SYSTEM_TRAY_CANCEL_MESSAGE, SYSTEM_TRAY_REQUEST_DOCK, VISUAL_ATOM, argbVisualOf, orientationValue, selectionNameFor, } from './protocol.js';
+// Core event codes and masks, written out for the same reason
+// `src/xsettings.js` writes them out: they are protocol constants, and
+// naming them here is cheaper than reaching into node-x11 for a number that
+// has not changed since 1987.
+const SELECTION_CLEAR = 29;
+const CLIENT_MESSAGE = 33;
+const STRUCTURE_NOTIFY_MASK = 131072; // x11.eventMask.StructureNotify
+const INPUT_ONLY = 2;
+/** Predefined atoms — no InternAtom round trip for these. */
+const XA_CARDINAL = 6;
+const XA_VISUALID = 32;
+/**
+ * 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 class TrayManager {
+    #app;
+    #screen;
+    #X;
+    #root;
+    #selectionAtom = 0;
+    #opcodeAtom = 0;
+    #orientationAtom = 0;
+    #visualAtom = 0;
+    #messageDataAtom = 0;
+    #managerAtom = 0;
+    /** The window that owns the selection, and the address the opcodes are
+     *  sent to. Created here rather than rendered, because a selection held on
+     *  a node that can unmount is a tray that silently stops being one. */
+    #window = 0;
+    /** The timestamp the selection was taken with; ICCCM 2.3 wants it back
+     *  when the selection is given up. */
+    #ownedAt = 0;
+    #icons = [];
+    #balloons = new BalloonAssembler();
+    #status = 'starting';
+    #conflict = null;
+    #orientation = 'horizontal';
+    #visual = 0;
+    /**
+     * The current run, or `null` between `stop()` and the next `start()`.
+     *
+     * A token rather than a pair of booleans for the reason `ForeignNode._start`
+     * uses one: taking the selection is a chain of round trips, and a run that
+     * was stopped part-way through must not have its stale continuation report
+     * success or leave a window behind. It is also what makes the manager
+     * genuinely restartable — React remounts an effect on the same instance in
+     * development, and a one-shot manager would come back dead.
+     */
+    #run = null;
+    #listener = null;
+    /** Assign, do not construct with: the component replaces these every
+     *  render so an inline handler is not a reason to restart anything. */
+    handlers = {};
+    constructor(app, screen = 0) {
+        this.#app = app;
+        this.#screen = screen;
+        this.#X = app?.X ?? null;
+        this.#root = app?.display?.screen?.[screen]?.root ?? 0;
+    }
+    get status() {
+        return this.#status;
+    }
+    get conflict() {
+        return this.#conflict;
+    }
+    /** The manager selection window, once there is one. */
+    get windowId() {
+        return this.#window || 0;
+    }
+    get icons() {
+        return this.#icons;
+    }
+    /**
+     * 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.
+     */
+    async start(options) {
+        if (this.#run)
+            return;
+        const run = {};
+        this.#run = run;
+        /** Still the run that started this line? */
+        const live = () => this.#run === run;
+        this.#orientation = options.orientation;
+        this.#setStatus('starting', null);
+        const X = this.#X;
+        // No raw protocol on this connection — a headless mock. Not an error to
+        // report: there is simply no display to be the tray of.
+        if (!X || typeof X.SetSelectionOwner !== 'function' || !this.#root) {
+            this.#setStatus('unavailable', null);
+            return;
+        }
+        try {
+            await this.#internAtoms(X);
+            if (!live())
+                return;
+            const existing = await this.#selectionOwner(X);
+            if (!live())
+                return;
+            if (existing) {
+                // A second panel on one display is a configuration mistake, not an
+                // exception. It says so and embeds nothing.
+                this.#setStatus('conflict', { owner: existing, screen: this.#screen });
+                return;
+            }
+            this.#window = X.AllocID();
+            // InputOnly, never mapped, 1x1 off-screen: this window exists to be an
+            // address and to hold two properties, which InputOnly windows do. It
+            // selects nothing — a ClientMessage reaches the client that created the
+            // window whatever its event mask is, which is how the opcodes arrive.
+            X.CreateWindow(this.#window, this.#root, -1, -1, 1, 1, 0, 0, INPUT_ONLY, 0, {
+                eventMask: 0,
+            });
+            this.#visual = await this.#resolveVisual(X, options.hostWindowId);
+            // Stopped mid-flight: the window above is ours and nothing else will
+            // drop it, because `stop()` ran before there was one to drop.
+            if (!live()) {
+                this.#destroyWindow();
+                return;
+            }
+            this.#writeOrientation();
+            this.#writeVisual();
+            // ICCCM 2.1: never `CurrentTime`. Nothing the user did caused this, so
+            // it is a fresh server timestamp rather than `lastInputTime()`.
+            const time = await serverTime(this.#app);
+            if (!live()) {
+                this.#destroyWindow();
+                return;
+            }
+            X.SetSelectionOwner(this.#window, this.#selectionAtom, time);
+            this.#ownedAt = time;
+            // Ask rather than assume. Two panels starting together both saw an
+            // unowned selection above, and only one of them has it now.
+            const owner = await this.#selectionOwner(X);
+            if (!live()) {
+                X.SetSelectionOwner(0, this.#selectionAtom, time);
+                this.#destroyWindow();
+                return;
+            }
+            if (owner !== this.#window) {
+                this.#setStatus('conflict', { owner, screen: this.#screen });
+                this.#destroyWindow();
+                return;
+            }
+            this.#listen(X);
+            this.#broadcastManager(X, time);
+            this.#setStatus('owned', null);
+        }
+        catch (err) {
+            this.#fail(err);
+        }
+    }
+    /**
+     * 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() {
+        if (!this.#run)
+            return;
+        this.#run = null;
+        const X = this.#X;
+        this.#unlisten();
+        this.#balloons.clear();
+        this.#replaceIcons([]);
+        if (X && this.#window) {
+            try {
+                // ICCCM 2.3: relinquish with the timestamp it was acquired at.
+                X.SetSelectionOwner(0, this.#selectionAtom, this.#ownedAt);
+            }
+            catch {
+                // the connection is going away, which releases it anyway
+            }
+        }
+        this.#destroyWindow();
+        this.#setStatus('released', null);
+    }
+    /** Republish `_NET_SYSTEM_TRAY_ORIENTATION`. Cheap and idempotent. */
+    setOrientation(orientation) {
+        if (orientation === this.#orientation)
+            return;
+        this.#orientation = orientation;
+        this.#writeOrientation();
+    }
+    /**
+     * 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) {
+        const icon = this.#icons.find((entry) => entry.id === id);
+        if (!icon)
+            return;
+        // A new array, never a splice: the component holds this as state, and
+        // React compares identities — mutating in place removes the icon from
+        // the list and leaves it on screen.
+        this.#icons = this.#icons.filter((entry) => entry !== icon);
+        this.#balloons.forget(id);
+        this.#emitIcons();
+        this.#safely(() => this.handlers.onUndock?.(icon));
+    }
+    // --- the wire ------------------------------------------------------
+    #listen(X) {
+        const listener = (ev) => {
+            if (!this.#run)
+                return;
+            try {
+                this.#onEvent(ev);
+            }
+            catch (err) {
+                this.#fail(err);
+            }
+        };
+        this.#listener = listener;
+        X.on('event', listener);
+    }
+    #unlisten() {
+        const listener = this.#listener;
+        this.#listener = null;
+        if (listener)
+            this.#X?.removeListener?.('event', listener);
+    }
+    #onEvent(ev) {
+        if (ev.type === SELECTION_CLEAR) {
+            // Another tray took over. Letting the icons go is the whole job here:
+            // a panel that keeps drawing dead icons after losing the selection is
+            // the failure users report as "my tray is empty".
+            if (ev.selection !== this.#selectionAtom)
+                return;
+            if (this.#window && ev.owner !== this.#window)
+                return;
+            this.#unlisten();
+            this.#balloons.clear();
+            this.#replaceIcons([]);
+            this.#destroyWindow();
+            this.#setStatus('released', null);
+            return;
+        }
+        if (ev.type !== CLIENT_MESSAGE)
+            return;
+        if (ev.message_type === this.#opcodeAtom) {
+            // A dock request names the manager window; a balloon message names the
+            // icon it is about, and both are *sent to* the manager window. So the
+            // event's window field is only ever one of those two.
+            const from = ev.wid ?? 0;
+            if (from !== this.#window && !this.#hasIcon(from))
+                return;
+            this.#onOpcode(from, ev.data ?? []);
+            return;
+        }
+        if (ev.message_type === this.#messageDataAtom && ev.format === 8) {
+            const from = ev.wid ?? 0;
+            if (!this.#hasIcon(from))
+                return;
+            const message = this.#balloons.data(from, ev.data ?? []);
+            if (message)
+                this.#safely(() => this.handlers.onMessage?.(message));
+        }
+    }
+    #onOpcode(from, data) {
+        const opcode = data[1];
+        if (opcode === SYSTEM_TRAY_REQUEST_DOCK) {
+            this.#dock(data[2] ?? 0);
+            return;
+        }
+        if (opcode === SYSTEM_TRAY_BEGIN_MESSAGE) {
+            if (!this.#hasIcon(from))
+                return;
+            const message = this.#balloons.begin(from, {
+                timeout: data[2] ?? 0,
+                length: data[3] ?? 0,
+                id: data[4] ?? 0,
+            });
+            if (message)
+                this.#safely(() => this.handlers.onMessage?.(message));
+            return;
+        }
+        if (opcode === SYSTEM_TRAY_CANCEL_MESSAGE) {
+            if (!this.#hasIcon(from))
+                return;
+            const id = data[2] ?? 0;
+            if (this.#balloons.cancel(from, id)) {
+                this.#safely(() => this.handlers.onCancelMessage?.({ windowId: from, id }));
+            }
+        }
+    }
+    #dock(id) {
+        if (!id || this.#status !== 'owned' || this.#hasIcon(id))
+            return;
+        const icon = { id };
+        this.#icons = [...this.#icons, icon];
+        this.#emitIcons();
+        this.#safely(() => this.handlers.onDock?.(icon));
+    }
+    #hasIcon(id) {
+        return this.#icons.some((icon) => icon.id === id);
+    }
+    #replaceIcons(next) {
+        if (this.#icons.length === 0 && next.length === 0)
+            return;
+        const gone = this.#icons;
+        this.#icons = next;
+        this.#emitIcons();
+        for (const icon of gone) {
+            if (!next.includes(icon))
+                this.#safely(() => this.handlers.onUndock?.(icon));
+        }
+    }
+    #emitIcons() {
+        const icons = this.#icons;
+        this.#safely(() => this.handlers.onIcons?.(icons));
+    }
+    /**
+     * ICCCM 2.8's `MANAGER` broadcast: clients that were waiting for a tray
+     * start docking on this, which is the only reason an application launched
+     * before the panel ever gets an icon.
+     */
+    #broadcastManager(X, time) {
+        X.SendEvent(this.#root, 0, STRUCTURE_NOTIFY_MASK, {
+            name: 'ClientMessage',
+            format: 32,
+            wid: this.#root,
+            message_type: this.#managerAtom,
+            data: [time, this.#selectionAtom, this.#window, 0, 0],
+        });
+    }
+    #writeOrientation() {
+        const X = this.#X;
+        if (!X || !this.#window)
+            return;
+        X.ChangeProperty(0, this.#window, this.#orientationAtom, XA_CARDINAL, 32, [
+            orientationValue(this.#orientation),
+        ]);
+    }
+    #writeVisual() {
+        const X = this.#X;
+        // Absent rather than zero when there is nothing honest to say: a client
+        // reads "is the property there" and a 0 visual id is not a visual.
+        if (!X || !this.#window || !this.#visual)
+            return;
+        X.ChangeProperty(0, this.#window, this.#visualAtom, XA_VISUALID, 32, [
+            this.#visual,
+        ]);
+    }
+    async #resolveVisual(X, hostWindowId) {
+        if (!hostWindowId)
+            return 0;
+        try {
+            const attrs = await new Promise((resolve, reject) => X.GetWindowAttributes(hostWindowId, (err, value) => err ? reject(err) : resolve(value)));
+            const screen = this.#app.display?.screen?.[this.#screen];
+            return argbVisualOf(screen, attrs?.visual ?? 0);
+        }
+        catch {
+            // The window went away, or the server would not say. No property, and
+            // the icons fall back to guessing a background — which always worked.
+            return 0;
+        }
+    }
+    #selectionOwner(X) {
+        return new Promise((resolve, reject) => X.GetSelectionOwner(this.#selectionAtom, (err, owner) => err ? reject(err) : resolve(owner >>> 0)));
+    }
+    async #internAtoms(X) {
+        const intern = (name) => new Promise((resolve, reject) => X.InternAtom(false, name, (err, atom) => err ? reject(err) : resolve(atom)));
+        const [selection, opcode, orientation, visual, messageData, manager] = await Promise.all([
+            intern(selectionNameFor(this.#screen)),
+            intern(OPCODE_ATOM),
+            intern(ORIENTATION_ATOM),
+            intern(VISUAL_ATOM),
+            intern(MESSAGE_DATA_ATOM),
+            intern(MANAGER_ATOM),
+        ]);
+        this.#selectionAtom = selection ?? 0;
+        this.#opcodeAtom = opcode ?? 0;
+        this.#orientationAtom = orientation ?? 0;
+        this.#visualAtom = visual ?? 0;
+        this.#messageDataAtom = messageData ?? 0;
+        this.#managerAtom = manager ?? 0;
+    }
+    #destroyWindow() {
+        const id = this.#window;
+        this.#window = 0;
+        if (!id)
+            return;
+        try {
+            this.#X?.DestroyWindow(id);
+        }
+        catch {
+            // the connection is closing; the server drops it with us
+        }
+    }
+    #setStatus(status, conflict) {
+        if (this.#status === status && this.#conflict === conflict)
+            return;
+        this.#status = status;
+        this.#conflict = conflict;
+        this.#safely(() => this.handlers.onStatus?.(status, conflict));
+    }
+    #fail(err) {
+        const wrapped = err instanceof Error ? err : new Error(String(err));
+        this.#safely(() => this.handlers.onError?.(wrapped));
+    }
+    /** One handler throwing must not take the X event loop with it — the same
+     *  rule `xsettings.js` applies to its subscribers. */
+    #safely(fn) {
+        try {
+            fn();
+        }
+        catch {
+            /* a listener's problem, not the tray's */
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

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

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

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

@@ -0,0 +1,22 @@
+import type { TrayMessage } from './protocol.js';
+/**
+ * A lazily-acquired claim on the session bus, and the `Notify` call over it.
+ *
+ * Lazy on purpose: a panel that never receives a balloon message never dials
+ * the bus, and `sessionBus()` is shared, so the claim costs a reference
+ * rather than a connection.
+ */
+export declare class BalloonNotifier {
+    #private;
+    /**
+     * Show `message`. Resolves false when there was nothing to show it with.
+     *
+     * The balloon's timeout passes straight through: both protocols measure it
+     * in milliseconds and both read 0 as "until the user dismisses it".
+     */
+    send(message: TrayMessage, appName?: string): Promise<boolean>;
+    /** Drop the claim. Never closes the connection — that is the app's call,
+     *  and every other consumer is on the same socket. */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=notify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/tray-host/notify.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAoBjD;;;;;;GAMG;AACH,qBAAa,eAAe;;IAqB1B;;;;;OAKG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,SAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAqB1E;IAED;0DACsD;IAChD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAK7B;CACF"}

package/dist/tray-host/notify.js

@@ -0,0 +1,74 @@
+// Balloon messages, forwarded to the desktop's notification service.
+//
+// `SYSTEM_TRAY_BEGIN_MESSAGE` is the pre-notification-daemon way an icon says
+// something, and older applications still emit it. A host that ignores it
+// leaves them silently unable to speak — so the default is to hand the text
+// to whatever the desktop already uses for notifications, and `onMessage` is
+// the seam for a panel that would rather draw its own bubble.
+//
+// **Nothing here opens a bus.** `sessionBus()` hands over react-x11's shared
+// connection, so the tray, the app's exported service and its menu are one
+// name on the bus rather than three. No bus, or no notification service, is
+// an ordinary state of a healthy machine: the message is dropped, and the
+// error says so for a caller that wants to know.
+import { sessionBus } from 'react-x11';
+const SERVICE = 'org.freedesktop.Notifications';
+const PATH = '/org/freedesktop/Notifications';
+/**
+ * A lazily-acquired claim on the session bus, and the `Notify` call over it.
+ *
+ * Lazy on purpose: a panel that never receives a balloon message never dials
+ * the bus, and `sessionBus()` is shared, so the claim costs a reference
+ * rather than a connection.
+ */
+export class BalloonNotifier {
+    #ref = null;
+    #acquiring = null;
+    #disposed = false;
+    async #bus() {
+        if (this.#ref)
+            return this.#ref;
+        // Not cached as a failure: `sessionBus()` never caches one either, so a
+        // bus that appears later is found.
+        this.#acquiring ??= sessionBus().finally(() => {
+            this.#acquiring = null;
+        });
+        const ref = await this.#acquiring;
+        if (this.#disposed) {
+            void ref?.release();
+            return null;
+        }
+        this.#ref = ref;
+        return ref;
+    }
+    /**
+     * Show `message`. Resolves false when there was nothing to show it with.
+     *
+     * The balloon's timeout passes straight through: both protocols measure it
+     * in milliseconds and both read 0 as "until the user dismisses it".
+     */
+    async send(message, appName = 'System Tray') {
+        const ref = await this.#bus();
+        if (!ref || this.#disposed)
+            return false;
+        const iface = (await ref.bus
+            .getService(SERVICE)
+            .getInterface(PATH, SERVICE));
+        // A balloon is one string. The first line reads as a title everywhere a
+        // notification is drawn, so it is used as one rather than padding the
+        // summary with the application's name.
+        const [summary = '', ...rest] = message.text.split('\n');
+        await iface.Notify(appName, 0, '', summary, rest.join('\n'), [], [], message.timeout);
+        return true;
+    }
+    /** Drop the claim. Never closes the connection — that is the app's call,
+     *  and every other consumer is on the same socket. */
+    async dispose() {
+        this.#disposed = true;
+        const ref = this.#ref;
+        this.#ref = null;
+        if (ref)
+            await ref.release();
+    }
+}
+//# sourceMappingURL=notify.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../../src/tray-host/notify.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,8EAA8E;AAC9E,0EAA0E;AAC1E,4EAA4E;AAC5E,6EAA6E;AAC7E,8DAA8D;AAC9D,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,4EAA4E;AAC5E,0EAA0E;AAC1E,iDAAiD;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAKvC,MAAM,OAAO,GAAG,+BAA+B,CAAC;AAChD,MAAM,IAAI,GAAG,gCAAgC,CAAC;AAiB9C;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IAC1B,IAAI,GAAkB,IAAI,CAAC;IAC3B,UAAU,GAAkC,IAAI,CAAC;IACjD,SAAS,GAAG,KAAK,CAAC;IAElB,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC;QAChC,wEAAwE;QACxE,mCAAmC;QACnC,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YAC5C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,KAAK,GAAG,EAAE,OAAO,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,OAAoB,EAAE,OAAO,GAAG,aAAa;QACtD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QACzC,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG;aACzB,UAAU,CAAC,OAAO,CAAC;aACnB,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAuB,CAAC;QACtD,wEAAwE;QACxE,sEAAsE;QACtE,uCAAuC;QACvC,MAAM,CAAC,OAAO,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,KAAK,CAAC,MAAM,CAChB,OAAO,EACP,CAAC,EACD,EAAE,EACF,OAAO,EACP,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EACf,EAAE,EACF,EAAE,EACF,OAAO,CAAC,OAAO,CAChB,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;0DACsD;IACtD,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,GAAG;YAAE,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;CACF"}