@sagmans/dsh-tui 0.6.0 → 0.8.0

package/lib/surface/terminal-lifecycle.js

@@ -0,0 +1,222 @@
+import { ProcessTerminal } from '@earendil-works/pi-tui';
+import { createHerdrReporter } from "../herdr/reporter.js";
+import { PROFILE_NAME, resumeHint } from "../identity.js";
+import { clipboardSequence } from "../terminal/clipboard.js";
+import { ExternalEditor } from "../terminal/external-editor.js";
+import { createRestoreRegistry } from "../terminal/restore.js";
+import { installSignalRestore } from "../terminal/signals.js";
+import { CLEAR_TITLE, windowTitle } from "../terminal/title.js";
+import { WarningSafeTui } from "../terminal/warning-screen.js";
+import { cleanCopied } from "../ui/copy.js";
+/**
+ * The terminal's lifetime: the screen this surface owns, the way out of it, and
+ * the child that borrows it.
+ *
+ * Ownership is the whole subject: the alternate screen, the hooks that put the
+ * shell back, and the exit are one mechanism, and a second writer would not
+ * know that the reader's own editor holds the tty. The composer keeps the
+ * widgets; this owner keeps every byte written to the terminal.
+ */
+export function createTerminalLifecycle(ctx, ports) {
+    const restore = createRestoreRegistry();
+    const terminal = new ProcessTerminal();
+    const tui = new WarningSafeTui(terminal, { copySelection });
+    // A frame that cannot be drawn leaves the last good screen up, so the failure
+    // has to reach the transcript: otherwise the surface looks frozen and nothing
+    // on screen can say why.
+    tui.onFrameError = error => ports.reportFrameError(error);
+    /** Whether a child process owns the terminal, which is when nothing here may write to it. */
+    let handedOver = false;
+    /** Whether the host has unloaded this surface, after which nothing may start it again. */
+    let disposed = false;
+    /** An exit asked for while a child owned the terminal, run once the screen is ours again. */
+    let deferredExit;
+    /** Whether the exit has begun, which is when nothing may start another. */
+    let exited = false;
+    /**
+     * Write to the tty, but only while this surface owns it.
+     *
+     * An editor the reader opened draws its own screen on the same terminal, so a
+     * title or a bell from here would land on top of it and, for a bell, sound as
+     * if the editor had failed. The title is written again when the screen comes
+     * back; a bell that fell in the gap is dropped rather than rung late.
+     */
+    const writeTerminal = (text) => {
+        if (!handedOver)
+            terminal.write(text);
+    };
+    /**
+     * Put a copied selection on the clipboard as the words it selected.
+     *
+     * A terminal copies the screen, so a drag across a message takes the box the
+     * message was drawn in along with it. The rows the last frame drew are the
+     * account of that frame, so the copy is read back through them: the shape the
+     * surface added comes off, and nothing the reader wrote does.
+     */
+    function copySelection(text) {
+        if (handedOver)
+            return Promise.resolve(false);
+        terminal.write(clipboardSequence(cleanCopied(text, ports.copyRows())));
+        return Promise.resolve(true);
+    }
+    const disposers = [];
+    // A containing Herdr is told what this pane is doing; away from one the
+    // reporter is inert, so the surface never depends on being multiplexed.
+    const herdr = createHerdrReporter();
+    // Kept out of the disposal list on purpose: the row is handed back before
+    // this stops guarding it, so a host that leaves during the release still
+    // releases synchronously.
+    const unregisterExit = herdr.registerExitRelease();
+    restore.add(() => tui.stop());
+    ctx.effect(() => () => {
+        // A surface the host unloads owns no screen and keeps no listeners, so a
+        // child still running in another process must not be handed a start().
+        disposed = true;
+        // The pane stops being an agent before the process that claimed it unwinds:
+        // a release that ran after the reports were unregistered would race them,
+        // and one that never ran would leave a row that reads as a live agent. The
+        // reports already on the wire are settled first, because Herdr ignores a
+        // release for a pane nothing has claimed yet — the report that followed it
+        // would otherwise claim the row back. The promise is returned so a host that
+        // waits for teardown waits for the row too, and the exit listener outlives
+        // the wait, so one that does not still hands the row back synchronously.
+        const released = herdr.release().catch(() => undefined);
+        restore.restore();
+        for (const dispose of disposers.reverse())
+            dispose();
+        return released.finally(unregisterExit);
+    });
+    const requestExit = (code, reason) => {
+        if (exited)
+            return;
+        // A child owns the terminal: restoring it here would leave the reader a
+        // shell behind an editor that is still running, and would put its tty back
+        // into cooked mode under it. The exit waits for the screen to come back.
+        if (handedOver) {
+            deferredExit = { code, reason };
+            return;
+        }
+        exited = true;
+        ports.stopClock();
+        // The screen goes back at once, so leaving feels like leaving; the row goes
+        // back behind it. Reports already on the wire are settled first, because
+        // Herdr ignores the release of a pane nothing has claimed yet — the report
+        // that followed it would otherwise claim the row back during shutdown.
+        terminal.write(CLEAR_TITLE);
+        restore.restore();
+        void herdr
+            .release()
+            // Nobody is left to report a release that failed on the way out, and a
+            // row that could not be cleared is not a reason to keep the process.
+            .catch(() => undefined)
+            .finally(() => {
+            // Everything below is written after the release: a failure nobody can
+            // read is not a failure that was reported.
+            if (reason !== undefined)
+                terminal.write(`\ndsh-tui: ${reason}\n`);
+            // The hint is computed here rather than read from the context because
+            // only the surface knows which session it is leaving: a fork or a
+            // switch moves it. A run that opened nothing has nothing to offer back:
+            // the identity it was launched with names no log, so pointing at it
+            // would send the reader to a conversation that does not exist.
+            if (ports.sessionOpened())
+                terminal.write(`\n${resumeHint(String(ports.activeSession()), PROFILE_NAME)}\n`);
+            ports.exit(code);
+        });
+    };
+    /**
+     * Take the signals a supervisor sends into the same shutdown a quit key runs.
+     *
+     * A signal ends the process from outside the surface, and the default action
+     * would leave the reader on a screen no shell prompt is drawn in. Returned
+     * rather than pushed here: the composer owns the one ordered teardown list, so
+     * this registration keeps the position that list already gave it.
+     */
+    const signalShutdown = () => installSignalRestore({ shutdown: code => requestExit(code, 'interrupted') });
+    /**
+     * The reader's own editor, opened over the draft the bar holds.
+     *
+     * The screen is handed over rather than drawn beside: an editor needs the
+     * terminal, so this is the one moment the surface is not the process painting
+     * on it. Every failure is reported as a notice and leaves the bar as it was,
+     * because the caller is a key press with nowhere to put an error.
+     */
+    const externalEditor = new ExternalEditor({
+        suspend: () => {
+            handedOver = true;
+            try {
+                // The frame is left in place rather than repainted into the normal
+                // buffer: the editor is about to paint over that same screen.
+                tui.stop({ preserveScreen: true });
+            }
+            catch (error) {
+                // A stop that failed leaves the screen ours; leaving the flag up would
+                // suppress every later title and defer every exit for good.
+                handedOver = false;
+                throw error;
+            }
+        },
+        resume: () => {
+            // Whatever the host unloaded is not coming back: starting it again would
+            // paint on a terminal this process is done with, into listeners that are gone.
+            if (disposed)
+                return;
+            try {
+                tui.start();
+            }
+            finally {
+                handedOver = false;
+            }
+            // Entering the alternate screen clears it, and any render asked for while
+            // the child owned the terminal was dropped after setting the very flag that
+            // makes the next ordinary request a no-op: without a forced one the reader
+            // would get a blank screen with a working keyboard under it.
+            tui.requestRender(true);
+            // The title is state this surface owns and the handoff swallowed any change
+            // to it, so a turn that ended while the editor was open would leave
+            // "working" up until the next turn.
+            writeTerminal(windowTitle(process.cwd(), ports.turnRunning() ? 'working' : 'ready'));
+        },
+        notice: message => ports.notice(message),
+    });
+    /**
+     * Hand the draft to the reader's editor and take back whatever it saved.
+     *
+     * An exit that was asked for during the handoff runs here rather than in the
+     * key that asked: the child owned the screen then, and the screen is this
+     * surface's again only once the editor has returned.
+     *
+     * A gate can open while the child owns the screen, and the bar then holds
+     * somebody's answer: the edited draft waits behind it instead of being written
+     * into a question the reader never answered.
+     */
+    const editDraft = () => {
+        void externalEditor.edit(ports.draftText()).then(text => {
+            if (text !== undefined) {
+                if (ports.draftBorrowed())
+                    ports.holdDraft(text);
+                else
+                    ports.writeDraft(text);
+                tui.requestRender();
+            }
+            const pendingExit = deferredExit;
+            deferredExit = undefined;
+            if (pendingExit !== undefined)
+                requestExit(pendingExit.code, pendingExit.reason);
+        });
+    };
+    return {
+        terminal,
+        tui,
+        herdr,
+        disposers,
+        writeTerminal,
+        handedOver: () => handedOver,
+        disposed: () => disposed,
+        exited: () => exited,
+        requestExit,
+        editDraft,
+        signalShutdown,
+    };
+}
+//# sourceMappingURL=terminal-lifecycle.js.map

package/lib/surface/terminal-lifecycle.js.map

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

package/lib/terminal-text/scan.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The escape grammar the surface recognises, and the visible spelling of the
+ * controls it must not execute.
+ *
+ * Kept apart from the renderer because recognition is the trust boundary: what
+ * this module accepts is what every drawing path is handed, and its rules
+ * follow the terminal's grammar rather than a row's layout.
+ */
+export declare const ESC = "\u001B";
+/** The bytes a text fragment cannot be drawn with: they are either sequences to read or marks to spell. */
+export declare const NEEDS_READING: RegExp;
+export declare const RESET = 0;
+export type Token = {
+    readonly kind: 'text';
+} | {
+    readonly kind: 'lineFeed';
+} | {
+    readonly kind: 'tab';
+} | {
+    readonly kind: 'carriageReturn';
+} | {
+    readonly kind: 'backspace';
+} | {
+    readonly kind: 'sgr';
+    readonly params: readonly number[];
+} | {
+    readonly kind: 'consumed';
+} | {
+    readonly kind: 'control';
+} | {
+    readonly kind: 'incomplete';
+};
+/** One recognised piece of the input, with the source text it was read from. */
+export interface Piece {
+    readonly token: Token;
+    readonly raw: string;
+}
+/** Every character of a sequence that is a control, spelled; the rest of it is printable. */
+export declare function spellControls(raw: string): string;
+/** The parameters of an SGR sequence, or nothing when it uses a form this module does not model. */
+export declare function parseSgrParams(body: string): readonly number[] | undefined;
+/** Split a text fragment into the pieces a policy draws or spells. */
+export declare function scan(raw: string): Piece[];
+//# sourceMappingURL=scan.d.ts.map

package/lib/terminal-text/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/terminal-text/scan.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,GAAG,WAAW,CAAA;AAgC3B,2GAA2G;AAC3G,eAAO,MAAM,aAAa,QAAoH,CAAA;AAoC9I,eAAO,MAAM,KAAK,IAAI,CAAA;AAEtB,MAAM,MAAM,KAAK,GACb;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GACnC;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAC5D;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAA;AAEnC,gFAAgF;AAChF,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAkBD,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOjD;AAuDD,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAQ1E;AAED,sEAAsE;AACtE,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE,CA8CzC"}

package/lib/terminal-text/scan.js

@@ -0,0 +1,195 @@
+/**
+ * The escape grammar the surface recognises, and the visible spelling of the
+ * controls it must not execute.
+ *
+ * Kept apart from the renderer because recognition is the trust boundary: what
+ * this module accepts is what every drawing path is handed, and its rules
+ * follow the terminal's grammar rather than a row's layout.
+ */
+export const ESC = '\u001b';
+const REPLACEMENT = '\uFFFD';
+const C0_PREFIX = '\\x';
+const UNICODE_PREFIX = '\\u';
+const HEX2 = 2;
+const HEX4 = 4;
+const LAST_C0 = 0x1f;
+const TAB = 0x09;
+const LINE_FEED = 0x0a;
+const CARRIAGE_RETURN = 0x0d;
+const BACKSPACE = 0x08;
+const DELETE = 0x7f;
+const FIRST_C1 = 0x80;
+const LAST_C1 = 0x9f;
+const FIRST_SURROGATE = 0xd800;
+const LAST_SURROGATE = 0xdfff;
+/** The bytes a text fragment cannot be drawn with: they are either sequences to read or marks to spell. */
+export const NEEDS_READING = /[\u0000-\u0009\u000B-\u001F\u007F-\u009F\u061C\u200E\u200F\u2028\u2029\u202A-\u202E\u2066-\u2069\uD800-\uDFFF]/u;
+/** Directional overrides and isolates, which reorder a row without drawing anything. */
+const BIDI_CONTROLS = new Set([0x202a, 0x202b, 0x202c, 0x202d, 0x202e, 0x2066, 0x2067, 0x2068, 0x2069]);
+const LINE_SEPARATOR = 0x2028;
+const PARAGRAPH_SEPARATOR = 0x2029;
+const ARABIC_LETTER_MARK = 0x061c;
+const LEFT_TO_RIGHT_MARK = 0x200e;
+const RIGHT_TO_LEFT_MARK = 0x200f;
+/** The SGR final byte, and the parameter bytes a sequence may carry before it. */
+const SGR_FINAL = 'm';
+const CSI_PARAMETER_LAST = 0x3f;
+const CSI_INTERMEDIATE_FIRST = 0x20;
+const CSI_INTERMEDIATE_LAST = 0x2f;
+const CSI_FINAL_FIRST = 0x40;
+const CSI_FINAL_LAST = 0x7e;
+const ESCAPE_FINAL_FIRST = 0x30;
+const OSC_INTRODUCER = ']';
+const STRING_INTRODUCERS = new Set(['P', 'X', '^', '_']);
+const STRING_END = '\u0007';
+export const RESET = 0;
+function escapeCode(prefix, code, digits) {
+    return prefix + code.toString(16).toUpperCase().padStart(digits, '0');
+}
+/** Whether a code point is a mark this module spells instead of drawing. */
+function isSpelledControl(code) {
+    if (code <= LAST_C0 || code === DELETE)
+        return true;
+    if (code >= FIRST_C1 && code <= LAST_C1)
+        return true;
+    return BIDI_CONTROLS.has(code) || code === LINE_SEPARATOR || code === PARAGRAPH_SEPARATOR || code === ARABIC_LETTER_MARK || code === LEFT_TO_RIGHT_MARK || code === RIGHT_TO_LEFT_MARK;
+}
+function spelled(code) {
+    if (code <= 0xff)
+        return escapeCode(C0_PREFIX, code, HEX2);
+    return escapeCode(UNICODE_PREFIX, code, HEX4);
+}
+/** Every character of a sequence that is a control, spelled; the rest of it is printable. */
+export function spellControls(raw) {
+    let out = '';
+    for (const character of raw) {
+        const code = character.codePointAt(0) ?? 0;
+        out += isSpelledControl(code) ? spelled(code) : character;
+    }
+    return out;
+}
+function isCsiFinal(code) {
+    return code >= CSI_FINAL_FIRST && code <= CSI_FINAL_LAST;
+}
+/**
+ * Read one escape sequence at `at`.
+ *
+ * A string sequence (OSC, DCS, and their siblings) runs to BEL or ST; when its
+ * terminator never arrives the sequence is reported incomplete rather than
+ * swallowed to the end of the row, because the renderer and the editor want
+ * different answers for a truncated sequence and only the scanner knows where
+ * it stopped.
+ */
+function readEscape(raw, at) {
+    const introducer = raw[at + 1];
+    if (introducer === undefined)
+        return undefined;
+    if (introducer === '[') {
+        let end = at + 2;
+        while (end < raw.length) {
+            const code = raw.charCodeAt(end);
+            if (isCsiFinal(code)) {
+                const source = raw.slice(at, end + 1);
+                if (raw[end] === SGR_FINAL) {
+                    const params = parseSgrParams(source.slice(2, -1));
+                    if (params !== undefined)
+                        return { token: { kind: 'sgr', params }, raw: source };
+                }
+                return { token: { kind: 'consumed' }, raw: source };
+            }
+            if (code > CSI_PARAMETER_LAST && (code < CSI_INTERMEDIATE_FIRST || code > CSI_INTERMEDIATE_LAST)) {
+                // A byte outside the CSI grammar ends the sequence as malformed; the
+                // sequence is consumed so its bytes cannot be drawn as text.
+                return { token: { kind: 'consumed' }, raw: raw.slice(at, end) };
+            }
+            end += 1;
+        }
+        return { token: { kind: 'incomplete' }, raw: raw.slice(at) };
+    }
+    if (introducer === OSC_INTRODUCER || STRING_INTRODUCERS.has(introducer)) {
+        let end = at + 2;
+        while (end < raw.length) {
+            if (raw[end] === STRING_END)
+                return { token: { kind: 'consumed' }, raw: raw.slice(at, end + 1) };
+            if (raw[end] === ESC && raw[end + 1] === '\\')
+                return { token: { kind: 'consumed' }, raw: raw.slice(at, end + 2) };
+            end += 1;
+        }
+        return { token: { kind: 'incomplete' }, raw: raw.slice(at) };
+    }
+    const code = raw.charCodeAt(at + 1);
+    if (code >= ESCAPE_FINAL_FIRST && code <= CSI_FINAL_LAST) {
+        return { token: { kind: 'consumed' }, raw: raw.slice(at, at + 2) };
+    }
+    return undefined;
+}
+/** The parameters of an SGR sequence, or nothing when it uses a form this module does not model. */
+export function parseSgrParams(body) {
+    if (body === '')
+        return [RESET];
+    const params = [];
+    for (const part of body.split(';')) {
+        if (!/^[0-9]*$/.test(part))
+            return undefined;
+        params.push(part === '' ? RESET : Number(part));
+    }
+    return params;
+}
+/** Split a text fragment into the pieces a policy draws or spells. */
+export function scan(raw) {
+    const pieces = [];
+    let text = '';
+    const flush = () => {
+        if (text === '')
+            return;
+        pieces.push({ token: { kind: 'text' }, raw: text });
+        text = '';
+    };
+    let at = 0;
+    while (at < raw.length) {
+        const code = raw.codePointAt(at) ?? 0;
+        const character = String.fromCodePoint(code);
+        if (code === LINE_FEED) {
+            flush();
+            pieces.push({ token: { kind: 'lineFeed' }, raw: character });
+        }
+        else if (code === TAB) {
+            flush();
+            pieces.push({ token: { kind: 'tab' }, raw: character });
+        }
+        else if (code === CARRIAGE_RETURN) {
+            flush();
+            pieces.push({ token: { kind: 'carriageReturn' }, raw: character });
+        }
+        else if (code === BACKSPACE) {
+            flush();
+            pieces.push({ token: { kind: 'backspace' }, raw: character });
+        }
+        else if (code === 0x1b) {
+            flush();
+            const sequence = readEscape(raw, at);
+            if (sequence === undefined) {
+                pieces.push({ token: { kind: 'control' }, raw: character });
+            }
+            else {
+                pieces.push(sequence);
+                at += sequence.raw.length;
+                continue;
+            }
+        }
+        else if (code >= FIRST_SURROGATE && code <= LAST_SURROGATE) {
+            text += REPLACEMENT;
+        }
+        else if (isSpelledControl(code)) {
+            flush();
+            pieces.push({ token: { kind: 'control' }, raw: character });
+        }
+        else {
+            text += character;
+        }
+        at += character.length;
+    }
+    flush();
+    return pieces;
+}
+//# sourceMappingURL=scan.js.map

package/lib/terminal-text/scan.js.map

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

package/lib/terminal-text/sgr.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The style state a renderer models: which attributes are on, which colour each
+ * names, and the sequences that move one state to the next.
+ *
+ * Apart from the grammar that reads those sequences and the renderer that emits
+ * rows, because which attributes and colours a terminal may set is a policy
+ * this surface owns, not a property of either.
+ */
+import { type ColourMode } from '../theme-capability.ts';
+export declare const CSI = "\u001B[";
+export interface TextStyle {
+    readonly fg?: string | undefined;
+    readonly bg?: string | undefined;
+    /** Attribute bits, so two styles compare by value without walking a set. */
+    readonly attributes: number;
+}
+export declare const GROUND: TextStyle;
+export interface Encoder {
+    /** The codes that move from one style to the next. */
+    between(previous: TextStyle, next: TextStyle): string;
+}
+/**
+ * Build the encoder for one colour budget.
+ *
+ * The element's own colour is the ground state rather than a reset, because a
+ * tool that ends a coloured run must not clear the colour the card drew it in;
+ * a full reset is never emitted, so nothing outside the run is disturbed.
+ */
+export declare function encoder(color: ColourMode, base: string): Encoder;
+/** Apply an SGR sequence to the state a cell is written with. */
+export declare function applySgr(style: TextStyle, params: readonly number[], color: ColourMode): TextStyle;
+//# sourceMappingURL=sgr.d.ts.map

package/lib/terminal-text/sgr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sgr.d.ts","sourceRoot":"","sources":["../../src/terminal-text/sgr.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAkC,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAGxF,eAAO,MAAM,GAAG,YAAY,CAAA;AA8E5B,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,eAAO,MAAM,MAAM,EAAE,SAA6B,CAAA;AAalD,MAAM,WAAW,OAAO;IACtB,sDAAsD;IACtD,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAAA;CACtD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAwBhE;AAsBD,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,GAAG,SAAS,CA+ClG"}