@dsh-cc/pi-tui 0.5.0

package/lib/terminal.d.ts.map

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

package/lib/terminal.js

@@ -0,0 +1,447 @@
+import * as fs from "node:fs";
+import { createRequire } from "node:module";
+import * as path from "node:path";
+import { setKittyProtocolActive } from "./keys.js";
+import { isNativeModifierPressed } from "./native-modifiers.js";
+import { getNativeModuleCandidates } from "./native-module-path.js";
+import { StdinBuffer } from "./stdin-buffer.js";
+const cjsRequire = createRequire(import.meta.url);
+const TERMINAL_PROGRESS_KEEPALIVE_MS = 1000;
+const TERMINAL_PROGRESS_ACTIVE_SEQUENCE = "\x1b]9;4;3\x07";
+const TERMINAL_PROGRESS_CLEAR_SEQUENCE = "\x1b]9;4;0\x07";
+const NATIVE_SHIFT_ENTER_SEQUENCE = "\x1b[13;2u";
+const DESIRED_KITTY_KEYBOARD_PROTOCOL_FLAGS = 7;
+const KEYBOARD_PROTOCOL_RESPONSE_FRAGMENT_TIMEOUT_MS = 150;
+const KITTY_KEYBOARD_PROTOCOL_QUERY = `\x1b[>${DESIRED_KITTY_KEYBOARD_PROTOCOL_FLAGS}u\x1b[?u\x1b[c`;
+export function parseKeyboardProtocolNegotiationSequence(sequence) {
+    const kittyFlags = sequence.match(/^\x1b\[\?(\d+)u$/);
+    if (kittyFlags) {
+        return { type: "kitty-flags", flags: Number.parseInt(kittyFlags[1], 10) };
+    }
+    if (/^\x1b\[\?[\d;]*c$/.test(sequence)) {
+        return { type: "device-attributes" };
+    }
+    return undefined;
+}
+function isKeyboardProtocolNegotiationSequencePrefix(sequence) {
+    return sequence === "\x1b[" || /^\x1b\[\?[\d;]*$/.test(sequence);
+}
+export function isAppleTerminalSession() {
+    return process.platform === "darwin" && process.env.TERM_PROGRAM === "Apple_Terminal";
+}
+export function normalizeNativeShiftEnterInput(data, shouldDetectNativeShiftEnter, isShiftPressed) {
+    if (shouldDetectNativeShiftEnter && data === "\r" && isShiftPressed)
+        return NATIVE_SHIFT_ENTER_SEQUENCE;
+    return data;
+}
+export function normalizeAppleTerminalInput(data, isAppleTerminal, isShiftPressed) {
+    return normalizeNativeShiftEnterInput(data, isAppleTerminal, isShiftPressed);
+}
+const DEFAULT_ESCAPE_TIMEOUT_MS = 10;
+const DEFAULT_SSH_ESCAPE_TIMEOUT_MS = 100;
+/**
+ * Resolve how long to wait for the rest of an escape sequence before
+ * dispatching a lone ESC as the Escape key. Legacy Alt+key input is ESC plus
+ * another byte, so high-latency transports need a longer reassembly window.
+ */
+export function resolveEscapeTimeoutMs(env = process.env) {
+    const configured = Number(env.PI_TUI_ESC_TIMEOUT);
+    if (Number.isFinite(configured) && configured > 0) {
+        return configured;
+    }
+    if (env.SSH_CONNECTION || env.SSH_TTY) {
+        return DEFAULT_SSH_ESCAPE_TIMEOUT_MS;
+    }
+    return DEFAULT_ESCAPE_TIMEOUT_MS;
+}
+/**
+ * Real terminal using process.stdin/stdout
+ */
+export class ProcessTerminal {
+    wasRaw = false;
+    inputHandler;
+    resizeHandler;
+    _kittyProtocolActive = false;
+    _modifyOtherKeysActive = false;
+    keyboardProtocolPushed = false;
+    keyboardProtocolNegotiationBuffer = "";
+    keyboardProtocolBufferFlushTimer;
+    stdinBuffer;
+    stdinDataHandler;
+    progressInterval;
+    writeLogPath = (() => {
+        const env = process.env.PI_TUI_WRITE_LOG || "";
+        if (!env)
+            return "";
+        try {
+            if (fs.statSync(env).isDirectory()) {
+                const now = new Date();
+                const ts = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}_${String(now.getHours()).padStart(2, "0")}-${String(now.getMinutes()).padStart(2, "0")}-${String(now.getSeconds()).padStart(2, "0")}`;
+                return path.join(env, `tui-${ts}-${process.pid}.log`);
+            }
+        }
+        catch {
+            // Not an existing directory - use as-is (file path)
+        }
+        return env;
+    })();
+    get kittyProtocolActive() {
+        return this._kittyProtocolActive;
+    }
+    get modifyOtherKeysActive() {
+        return this._modifyOtherKeysActive;
+    }
+    start(onInput, onResize) {
+        this.inputHandler = onInput;
+        this.resizeHandler = onResize;
+        // Save previous state and enable raw mode
+        this.wasRaw = process.stdin.isRaw || false;
+        if (process.stdin.setRawMode) {
+            process.stdin.setRawMode(true);
+        }
+        process.stdin.setEncoding("utf8");
+        process.stdin.resume();
+        // Enable bracketed paste mode - terminal will wrap pastes in \x1b[200~ ... \x1b[201~
+        process.stdout.write("\x1b[?2004h");
+        // Set up resize handler immediately
+        process.stdout.on("resize", this.resizeHandler);
+        // Refresh terminal dimensions - they may be stale after suspend/resume
+        // (SIGWINCH is lost while process is stopped). Unix only.
+        if (process.platform !== "win32") {
+            process.kill(process.pid, "SIGWINCH");
+        }
+        // On Windows, enable ENABLE_VIRTUAL_TERMINAL_INPUT so the console sends
+        // VT escape sequences (e.g. \x1b[Z for Shift+Tab) instead of raw console
+        // events that lose modifier information. Must run AFTER setRawMode(true)
+        // since that resets console mode flags.
+        this.enableWindowsVTInput();
+        // Query Kitty keyboard protocol and fall back to modifyOtherKeys when DA confirms no Kitty response.
+        // See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/
+        this.queryAndEnableKittyProtocol();
+    }
+    /**
+     * Set up StdinBuffer to split batched input into individual sequences.
+     * This ensures components receive single events, making matchesKey/isKeyRelease work correctly.
+     *
+     * Also watches for Kitty protocol response and enables it when detected.
+     * This is done here (after stdinBuffer parsing) rather than on raw stdin
+     * to handle the case where the response arrives split across multiple events.
+     */
+    setupStdinBuffer() {
+        this.stdinBuffer = new StdinBuffer({ escapeTimeout: resolveEscapeTimeoutMs() });
+        // Forward individual sequences to the input handler
+        this.stdinBuffer.on("data", (sequence) => {
+            const negotiationSequence = this.readKeyboardProtocolNegotiationSequence(sequence);
+            if (negotiationSequence === "pending") {
+                this.scheduleKeyboardProtocolNegotiationBufferFlush();
+                return; // Wait briefly for the rest of a split Kitty response.
+            }
+            if (this.handleKeyboardProtocolNegotiationSequence(negotiationSequence)) {
+                return;
+            }
+            this.forwardInputSequence(sequence);
+        });
+        // Re-wrap paste content with bracketed paste markers for existing editor handling
+        this.stdinBuffer.on("paste", (content) => {
+            if (this.inputHandler) {
+                this.inputHandler(`\x1b[200~${content}\x1b[201~`);
+            }
+        });
+        // Handler that pipes stdin data through the buffer
+        this.stdinDataHandler = (data) => {
+            this.stdinBuffer.process(data);
+        };
+    }
+    /**
+     * Query terminal for Kitty keyboard protocol support and enable it if available.
+     *
+     * Kitty's progressive enhancement detection requires requesting the desired
+     * flags before querying them. The trailing DA query is a sentinel supported by
+     * terminals that do not know Kitty keyboard protocol; receiving DA before a
+     * Kitty response enables modifyOtherKeys fallback without a startup timeout.
+     *
+     * The requested flags are:
+     * - 1 = disambiguate escape codes
+     * - 2 = report event types (press/repeat/release)
+     * - 4 = report alternate keys (shifted key, base layout key)
+     */
+    queryAndEnableKittyProtocol() {
+        this.setupStdinBuffer();
+        process.stdin.on("data", this.stdinDataHandler);
+        this.keyboardProtocolPushed = true;
+        this.clearKeyboardProtocolNegotiationBuffer();
+        process.stdout.write(KITTY_KEYBOARD_PROTOCOL_QUERY);
+    }
+    handleKeyboardProtocolNegotiationSequence(negotiationSequence) {
+        if (!negotiationSequence)
+            return false;
+        this.clearKeyboardProtocolNegotiationBuffer();
+        if (negotiationSequence.type === "kitty-flags") {
+            if (negotiationSequence.flags !== 0) {
+                this.disableModifyOtherKeys();
+                if (!this._kittyProtocolActive) {
+                    this._kittyProtocolActive = true;
+                    setKittyProtocolActive(true);
+                }
+            }
+            else {
+                this.enableModifyOtherKeys();
+            }
+            return true;
+        }
+        if (!this._kittyProtocolActive) {
+            this.enableModifyOtherKeys();
+        }
+        return true;
+    }
+    readKeyboardProtocolNegotiationSequence(sequence) {
+        if (this.keyboardProtocolNegotiationBuffer) {
+            const bufferedSequence = this.keyboardProtocolNegotiationBuffer + sequence;
+            const negotiationSequence = parseKeyboardProtocolNegotiationSequence(bufferedSequence);
+            if (negotiationSequence) {
+                this.clearKeyboardProtocolNegotiationBuffer();
+                return negotiationSequence;
+            }
+            if (isKeyboardProtocolNegotiationSequencePrefix(bufferedSequence)) {
+                this.setKeyboardProtocolNegotiationBuffer(bufferedSequence);
+                return "pending";
+            }
+            this.flushKeyboardProtocolNegotiationBufferAsInput();
+        }
+        const negotiationSequence = parseKeyboardProtocolNegotiationSequence(sequence);
+        if (negotiationSequence)
+            return negotiationSequence;
+        if (isKeyboardProtocolNegotiationSequencePrefix(sequence)) {
+            this.setKeyboardProtocolNegotiationBuffer(sequence);
+            return "pending";
+        }
+        return undefined;
+    }
+    setKeyboardProtocolNegotiationBuffer(sequence) {
+        this.clearKeyboardProtocolNegotiationBufferFlushTimer();
+        this.keyboardProtocolNegotiationBuffer = sequence;
+    }
+    clearKeyboardProtocolNegotiationBuffer() {
+        this.clearKeyboardProtocolNegotiationBufferFlushTimer();
+        this.keyboardProtocolNegotiationBuffer = "";
+    }
+    flushKeyboardProtocolNegotiationBufferAsInput() {
+        if (!this.keyboardProtocolNegotiationBuffer)
+            return;
+        const sequence = this.keyboardProtocolNegotiationBuffer;
+        this.clearKeyboardProtocolNegotiationBuffer();
+        this.forwardInputSequence(sequence);
+    }
+    scheduleKeyboardProtocolNegotiationBufferFlush() {
+        if (!this.keyboardProtocolNegotiationBuffer || this.keyboardProtocolBufferFlushTimer)
+            return;
+        this.keyboardProtocolBufferFlushTimer = setTimeout(() => {
+            this.keyboardProtocolBufferFlushTimer = undefined;
+            this.flushKeyboardProtocolNegotiationBufferAsInput();
+        }, KEYBOARD_PROTOCOL_RESPONSE_FRAGMENT_TIMEOUT_MS);
+    }
+    clearKeyboardProtocolNegotiationBufferFlushTimer() {
+        if (!this.keyboardProtocolBufferFlushTimer)
+            return;
+        clearTimeout(this.keyboardProtocolBufferFlushTimer);
+        this.keyboardProtocolBufferFlushTimer = undefined;
+    }
+    forwardInputSequence(sequence) {
+        if (!this.inputHandler)
+            return;
+        const shouldDetectNativeShiftEnter = sequence === "\r" && (isAppleTerminalSession() || process.platform === "win32");
+        const input = normalizeNativeShiftEnterInput(sequence, shouldDetectNativeShiftEnter, shouldDetectNativeShiftEnter && isNativeModifierPressed("shift"));
+        this.inputHandler(input);
+    }
+    enableModifyOtherKeys() {
+        if (this._kittyProtocolActive || this._modifyOtherKeysActive)
+            return;
+        process.stdout.write("\x1b[>4;2m");
+        this._modifyOtherKeysActive = true;
+    }
+    disableModifyOtherKeys() {
+        if (!this._modifyOtherKeysActive)
+            return;
+        process.stdout.write("\x1b[>4;0m");
+        this._modifyOtherKeysActive = false;
+    }
+    /**
+     * On Windows, add ENABLE_VIRTUAL_TERMINAL_INPUT (0x0200) to the stdin
+     * console handle so the terminal sends VT sequences for modified keys
+     * (e.g. \x1b[Z for Shift+Tab). Without this, libuv's ReadConsoleInputW
+     * discards modifier state and Shift+Tab arrives as plain \t.
+     */
+    enableWindowsVTInput() {
+        if (process.platform !== "win32")
+            return;
+        try {
+            const arch = process.arch;
+            if (arch !== "x64" && arch !== "arm64")
+                return;
+            // Dynamic require so non-Windows and bundled/browser paths never load the
+            // native helper. Installed packages resolve it from pi-tui; standalone
+            // binaries resolve the copy next to the executable.
+            const nativePath = path.join("native", "win32", "prebuilds", `win32-${arch}`, "win32-console-mode.node");
+            for (const modulePath of getNativeModuleCandidates(nativePath)) {
+                try {
+                    const helper = cjsRequire(modulePath);
+                    helper.enableVirtualTerminalInput?.();
+                    return;
+                }
+                catch {
+                    // Try the next possible packaging location.
+                }
+            }
+        }
+        catch {
+            // Native helper not available — Shift+Tab won't be distinguishable from Tab.
+        }
+    }
+    async drainInput(maxMs = 1000, idleMs = 50) {
+        const shouldDisableKittyProtocol = this.keyboardProtocolPushed || this._kittyProtocolActive;
+        this.clearKeyboardProtocolNegotiationBuffer();
+        if (shouldDisableKittyProtocol) {
+            // Disable Kitty keyboard protocol first so any late key releases
+            // do not generate new Kitty escape sequences.
+            process.stdout.write("\x1b[<u");
+            this.keyboardProtocolPushed = false;
+            this._kittyProtocolActive = false;
+            setKittyProtocolActive(false);
+        }
+        this.disableModifyOtherKeys();
+        const previousHandler = this.inputHandler;
+        this.inputHandler = undefined;
+        let lastDataTime = Date.now();
+        const onData = () => {
+            lastDataTime = Date.now();
+        };
+        process.stdin.on("data", onData);
+        const endTime = Date.now() + maxMs;
+        try {
+            while (true) {
+                const now = Date.now();
+                const timeLeft = endTime - now;
+                if (timeLeft <= 0)
+                    break;
+                if (now - lastDataTime >= idleMs)
+                    break;
+                await new Promise((resolve) => setTimeout(resolve, Math.min(idleMs, timeLeft)));
+            }
+        }
+        finally {
+            process.stdin.removeListener("data", onData);
+            this.inputHandler = previousHandler;
+        }
+    }
+    stop() {
+        if (this.clearProgressInterval()) {
+            process.stdout.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);
+        }
+        // Disable bracketed paste mode
+        process.stdout.write("\x1b[?2004l");
+        const shouldDisableKittyProtocol = this.keyboardProtocolPushed || this._kittyProtocolActive;
+        this.clearKeyboardProtocolNegotiationBuffer();
+        // Disable Kitty keyboard protocol if not already done by drainInput()
+        if (shouldDisableKittyProtocol) {
+            process.stdout.write("\x1b[<u");
+            this.keyboardProtocolPushed = false;
+            this._kittyProtocolActive = false;
+            setKittyProtocolActive(false);
+        }
+        this.disableModifyOtherKeys();
+        // Clean up StdinBuffer
+        if (this.stdinBuffer) {
+            this.stdinBuffer.destroy();
+            this.stdinBuffer = undefined;
+        }
+        // Remove event handlers
+        if (this.stdinDataHandler) {
+            process.stdin.removeListener("data", this.stdinDataHandler);
+            this.stdinDataHandler = undefined;
+        }
+        this.inputHandler = undefined;
+        if (this.resizeHandler) {
+            process.stdout.removeListener("resize", this.resizeHandler);
+            this.resizeHandler = undefined;
+        }
+        // Pause stdin to prevent any buffered input (e.g., Ctrl+D) from being
+        // re-interpreted after raw mode is disabled. This fixes a race condition
+        // where Ctrl+D could close the parent shell over SSH.
+        process.stdin.pause();
+        // Restore raw mode state
+        if (process.stdin.setRawMode) {
+            process.stdin.setRawMode(this.wasRaw);
+        }
+    }
+    write(data) {
+        process.stdout.write(data);
+        if (this.writeLogPath) {
+            try {
+                fs.appendFileSync(this.writeLogPath, data, { encoding: "utf8" });
+            }
+            catch {
+                // Ignore logging errors
+            }
+        }
+    }
+    get columns() {
+        return process.stdout.columns || Number(process.env.COLUMNS) || 80;
+    }
+    get rows() {
+        return process.stdout.rows || Number(process.env.LINES) || 24;
+    }
+    moveBy(lines) {
+        if (lines > 0) {
+            // Move down
+            process.stdout.write(`\x1b[${lines}B`);
+        }
+        else if (lines < 0) {
+            // Move up
+            process.stdout.write(`\x1b[${-lines}A`);
+        }
+        // lines === 0: no movement
+    }
+    hideCursor() {
+        process.stdout.write("\x1b[?25l");
+    }
+    showCursor() {
+        process.stdout.write("\x1b[?25h");
+    }
+    clearLine() {
+        process.stdout.write("\x1b[K");
+    }
+    clearFromCursor() {
+        process.stdout.write("\x1b[J");
+    }
+    clearScreen() {
+        process.stdout.write("\x1b[2J\x1b[H"); // Clear screen and move to home (1,1)
+    }
+    setTitle(title) {
+        // OSC 0;title BEL - set terminal window title
+        process.stdout.write(`\x1b]0;${title}\x07`);
+    }
+    setProgress(active) {
+        if (active) {
+            // OSC 9;4;3 - indeterminate progress
+            process.stdout.write(TERMINAL_PROGRESS_ACTIVE_SEQUENCE);
+            if (!this.progressInterval) {
+                this.progressInterval = setInterval(() => {
+                    process.stdout.write(TERMINAL_PROGRESS_ACTIVE_SEQUENCE);
+                }, TERMINAL_PROGRESS_KEEPALIVE_MS);
+            }
+        }
+        else {
+            this.clearProgressInterval();
+            // OSC 9;4;0 - clear progress
+            process.stdout.write(TERMINAL_PROGRESS_CLEAR_SEQUENCE);
+        }
+    }
+    clearProgressInterval() {
+        if (!this.progressInterval)
+            return false;
+        clearInterval(this.progressInterval);
+        this.progressInterval = undefined;
+        return true;
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/lib/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAElD,MAAM,8BAA8B,GAAG,IAAI,CAAC;AAC5C,MAAM,iCAAiC,GAAG,gBAAgB,CAAC;AAC3D,MAAM,gCAAgC,GAAG,gBAAgB,CAAC;AAC1D,MAAM,2BAA2B,GAAG,YAAY,CAAC;AACjD,MAAM,qCAAqC,GAAG,CAAC,CAAC;AAChD,MAAM,8CAA8C,GAAG,GAAG,CAAC;AAC3D,MAAM,6BAA6B,GAAG,SAAS,qCAAqC,gBAAgB,CAAC;AAMrG,MAAM,UAAU,wCAAwC,CACvD,QAAgB;IAEhB,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtD,IAAI,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IAC5E,CAAC;IACD,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,2CAA2C,CAAC,QAAgB;IACpE,OAAO,QAAQ,KAAK,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,sBAAsB;IACrC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,gBAAgB,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC7C,IAAY,EACZ,4BAAqC,EACrC,cAAuB;IAEvB,IAAI,4BAA4B,IAAI,IAAI,KAAK,IAAI,IAAI,cAAc;QAAE,OAAO,2BAA2B,CAAC;IACxG,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,IAAY,EAAE,eAAwB,EAAE,cAAuB;IAC1G,OAAO,8BAA8B,CAAC,IAAI,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;AAC9E,CAAC;AAiDD,MAAM,yBAAyB,GAAG,EAAE,CAAC;AACrC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC1E,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAClD,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnD,OAAO,UAAU,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QACvC,OAAO,6BAA6B,CAAC;IACtC,CAAC;IACD,OAAO,yBAAyB,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,eAAe;IACnB,MAAM,GAAG,KAAK,CAAC;IACf,YAAY,CAA0B;IACtC,aAAa,CAAc;IAC3B,oBAAoB,GAAG,KAAK,CAAC;IAC7B,sBAAsB,GAAG,KAAK,CAAC;IAC/B,sBAAsB,GAAG,KAAK,CAAC;IAC/B,iCAAiC,GAAG,EAAE,CAAC;IACvC,gCAAgC,CAAiC;IACjE,WAAW,CAAe;IAC1B,gBAAgB,CAA0B;IAC1C,gBAAgB,CAAkC;IAClD,YAAY,GAAG,CAAC,GAAG,EAAE;QAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC;YACJ,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACpC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;gBAChQ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;YACvD,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,oDAAoD;QACrD,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC,CAAC,EAAE,CAAC;IAEL,IAAI,mBAAmB;QACtB,OAAO,IAAI,CAAC,oBAAoB,CAAC;IAClC,CAAC;IAED,IAAI,qBAAqB;QACxB,OAAO,IAAI,CAAC,sBAAsB,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,OAA+B,EAAE,QAAoB;QAC1D,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAE9B,0CAA0C;QAC1C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC;QAC3C,IAAI,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAEvB,qFAAqF;QACrF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAEpC,oCAAoC;QACpC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAEhD,uEAAuE;QACvE,0DAA0D;QAC1D,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACvC,CAAC;QAED,wEAAwE;QACxE,yEAAyE;QACzE,yEAAyE;QACzE,wCAAwC;QACxC,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAE5B,qGAAqG;QACrG,0DAA0D;QAC1D,IAAI,CAAC,2BAA2B,EAAE,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACK,gBAAgB;QACvB,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,EAAE,aAAa,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;QAEhF,oDAAoD;QACpD,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;YACxC,MAAM,mBAAmB,GAAG,IAAI,CAAC,uCAAuC,CAAC,QAAQ,CAAC,CAAC;YACnF,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;gBACvC,IAAI,CAAC,8CAA8C,EAAE,CAAC;gBACtD,OAAO,CAAC,uDAAuD;YAChE,CAAC;YACD,IAAI,IAAI,CAAC,yCAAyC,CAAC,mBAAmB,CAAC,EAAE,CAAC;gBACzE,OAAO;YACR,CAAC;YAED,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,kFAAkF;QAClF,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;YACxC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACvB,IAAI,CAAC,YAAY,CAAC,YAAY,OAAO,WAAW,CAAC,CAAC;YACnD,CAAC;QACF,CAAC,CAAC,CAAC;QAEH,mDAAmD;QACnD,IAAI,CAAC,gBAAgB,GAAG,CAAC,IAAY,EAAE,EAAE;YACxC,IAAI,CAAC,WAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACK,2BAA2B;QAClC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAiB,CAAC,CAAC;QACjD,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;QACnC,IAAI,CAAC,sCAAsC,EAAE,CAAC;QAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACrD,CAAC;IAEO,yCAAyC,CAChD,mBAAoE;QAEpE,IAAI,CAAC,mBAAmB;YAAE,OAAO,KAAK,CAAC;QACvC,IAAI,CAAC,sCAAsC,EAAE,CAAC;QAC9C,IAAI,mBAAmB,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAChD,IAAI,mBAAmB,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;gBACrC,IAAI,CAAC,sBAAsB,EAAE,CAAC;gBAC9B,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;oBAChC,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;oBACjC,sBAAsB,CAAC,IAAI,CAAC,CAAC;gBAC9B,CAAC;YACF,CAAC;iBAAM,CAAC;gBACP,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC9B,CAAC;YACD,OAAO,IAAI,CAAC;QACb,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAChC,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAEO,uCAAuC,CAC9C,QAAgB;QAEhB,IAAI,IAAI,CAAC,iCAAiC,EAAE,CAAC;YAC5C,MAAM,gBAAgB,GAAG,IAAI,CAAC,iCAAiC,GAAG,QAAQ,CAAC;YAC3E,MAAM,mBAAmB,GAAG,wCAAwC,CAAC,gBAAgB,CAAC,CAAC;YACvF,IAAI,mBAAmB,EAAE,CAAC;gBACzB,IAAI,CAAC,sCAAsC,EAAE,CAAC;gBAC9C,OAAO,mBAAmB,CAAC;YAC5B,CAAC;YACD,IAAI,2CAA2C,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACnE,IAAI,CAAC,oCAAoC,CAAC,gBAAgB,CAAC,CAAC;gBAC5D,OAAO,SAAS,CAAC;YAClB,CAAC;YACD,IAAI,CAAC,6CAA6C,EAAE,CAAC;QACtD,CAAC;QAED,MAAM,mBAAmB,GAAG,wCAAwC,CAAC,QAAQ,CAAC,CAAC;QAC/E,IAAI,mBAAmB;YAAE,OAAO,mBAAmB,CAAC;QACpD,IAAI,2CAA2C,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,oCAAoC,CAAC,QAAQ,CAAC,CAAC;YACpD,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,OAAO,SAAS,CAAC;IAClB,CAAC;IAEO,oCAAoC,CAAC,QAAgB;QAC5D,IAAI,CAAC,gDAAgD,EAAE,CAAC;QACxD,IAAI,CAAC,iCAAiC,GAAG,QAAQ,CAAC;IACnD,CAAC;IAEO,sCAAsC;QAC7C,IAAI,CAAC,gDAAgD,EAAE,CAAC;QACxD,IAAI,CAAC,iCAAiC,GAAG,EAAE,CAAC;IAC7C,CAAC;IAEO,6CAA6C;QACpD,IAAI,CAAC,IAAI,CAAC,iCAAiC;YAAE,OAAO;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,iCAAiC,CAAC;QACxD,IAAI,CAAC,sCAAsC,EAAE,CAAC;QAC9C,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAEO,8CAA8C;QACrD,IAAI,CAAC,IAAI,CAAC,iCAAiC,IAAI,IAAI,CAAC,gCAAgC;YAAE,OAAO;QAC7F,IAAI,CAAC,gCAAgC,GAAG,UAAU,CAAC,GAAG,EAAE;YACvD,IAAI,CAAC,gCAAgC,GAAG,SAAS,CAAC;YAClD,IAAI,CAAC,6CAA6C,EAAE,CAAC;QACtD,CAAC,EAAE,8CAA8C,CAAC,CAAC;IACpD,CAAC;IAEO,gDAAgD;QACvD,IAAI,CAAC,IAAI,CAAC,gCAAgC;YAAE,OAAO;QACnD,YAAY,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QACpD,IAAI,CAAC,gCAAgC,GAAG,SAAS,CAAC;IACnD,CAAC;IAEO,oBAAoB,CAAC,QAAgB;QAC5C,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO;QAC/B,MAAM,4BAA4B,GACjC,QAAQ,KAAK,IAAI,IAAI,CAAC,sBAAsB,EAAE,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;QACjF,MAAM,KAAK,GAAG,8BAA8B,CAC3C,QAAQ,EACR,4BAA4B,EAC5B,4BAA4B,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAChE,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAEO,qBAAqB;QAC5B,IAAI,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,sBAAsB;YAAE,OAAO;QACrE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACnC,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;IACpC,CAAC;IAEO,sBAAsB;QAC7B,IAAI,CAAC,IAAI,CAAC,sBAAsB;YAAE,OAAO;QACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACnC,IAAI,CAAC,sBAAsB,GAAG,KAAK,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACK,oBAAoB;QAC3B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;YAAE,OAAO;QACzC,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YAC1B,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,OAAO;gBAAE,OAAO;YAE/C,0EAA0E;YAC1E,uEAAuE;YACvE,oDAAoD;YACpD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,IAAI,EAAE,EAAE,yBAAyB,CAAC,CAAC;YACzG,KAAK,MAAM,UAAU,IAAI,yBAAyB,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChE,IAAI,CAAC;oBACJ,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAmD,CAAC;oBACxF,MAAM,CAAC,0BAA0B,EAAE,EAAE,CAAC;oBACtC,OAAO;gBACR,CAAC;gBAAC,MAAM,CAAC;oBACR,4CAA4C;gBAC7C,CAAC;YACF,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,6EAA6E;QAC9E,CAAC;IACF,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,EAAE,MAAM,GAAG,EAAE;QACzC,MAAM,0BAA0B,GAAG,IAAI,CAAC,sBAAsB,IAAI,IAAI,CAAC,oBAAoB,CAAC;QAC5F,IAAI,CAAC,sCAAsC,EAAE,CAAC;QAC9C,IAAI,0BAA0B,EAAE,CAAC;YAChC,iEAAiE;YACjE,8CAA8C;YAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAChC,IAAI,CAAC,sBAAsB,GAAG,KAAK,CAAC;YACpC,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAC;YAClC,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAE9B,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC;QAC1C,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAE9B,IAAI,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,GAAG,EAAE;YACnB,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,CAAC,CAAC;QAEF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAEnC,IAAI,CAAC;YACJ,OAAO,IAAI,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACvB,MAAM,QAAQ,GAAG,OAAO,GAAG,GAAG,CAAC;gBAC/B,IAAI,QAAQ,IAAI,CAAC;oBAAE,MAAM;gBACzB,IAAI,GAAG,GAAG,YAAY,IAAI,MAAM;oBAAE,MAAM;gBACxC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;YACjF,CAAC;QACF,CAAC;gBAAS,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7C,IAAI,CAAC,YAAY,GAAG,eAAe,CAAC;QACrC,CAAC;IACF,CAAC;IAED,IAAI;QACH,IAAI,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;YAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACxD,CAAC;QAED,+BAA+B;QAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAEpC,MAAM,0BAA0B,GAAG,IAAI,CAAC,sBAAsB,IAAI,IAAI,CAAC,oBAAoB,CAAC;QAC5F,IAAI,CAAC,sCAAsC,EAAE,CAAC;QAE9C,sEAAsE;QACtE,IAAI,0BAA0B,EAAE,CAAC;YAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAChC,IAAI,CAAC,sBAAsB,GAAG,KAAK,CAAC;YACpC,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAC;YAClC,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAE9B,uBAAuB;QACvB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC9B,CAAC;QAED,wBAAwB;QACxB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC5D,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAC9B,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAC5D,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;QAChC,CAAC;QAED,sEAAsE;QACtE,yEAAyE;QACzE,sDAAsD;QACtD,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAEtB,yBAAyB;QACzB,IAAI,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;IACF,CAAC;IAED,KAAK,CAAC,IAAY;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC;gBACJ,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAClE,CAAC;YAAC,MAAM,CAAC;gBACR,wBAAwB;YACzB,CAAC;QACF,CAAC;IACF,CAAC;IAED,IAAI,OAAO;QACV,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACpE,CAAC;IAED,IAAI,IAAI;QACP,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,CAAC,KAAa;QACnB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACf,YAAY;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACtB,UAAU;YACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC;QACzC,CAAC;QACD,2BAA2B;IAC5B,CAAC;IAED,UAAU;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;IAED,UAAU;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;IAED,SAAS;QACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,eAAe;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,WAAW;QACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,sCAAsC;IAC9E,CAAC;IAED,QAAQ,CAAC,KAAa;QACrB,8CAA8C;QAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,WAAW,CAAC,MAAe;QAC1B,IAAI,MAAM,EAAE,CAAC;YACZ,qCAAqC;YACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACxD,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC5B,IAAI,CAAC,gBAAgB,GAAG,WAAW,CAAC,GAAG,EAAE;oBACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;gBACzD,CAAC,EAAE,8BAA8B,CAAC,CAAC;YACpC,CAAC;QACF,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC7B,6BAA6B;YAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACxD,CAAC;IACF,CAAC;IAEO,qBAAqB;QAC5B,IAAI,CAAC,IAAI,CAAC,gBAAgB;YAAE,OAAO,KAAK,CAAC;QACzC,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACrC,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/lib/tui-alt-screen.d.ts

@@ -0,0 +1,118 @@
+import type { Terminal } from "./terminal.ts";
+import { type Component, TuiBase, type TuiStopOptions, VIEWPORT_TUI, type ViewportTUI } from "./tui.ts";
+export interface TuiAltScreenOptions {
+    /** Number of logical lines moved for each mouse-wheel event. */
+    wheelScrollLines?: number;
+    /** Capture mouse events for viewport scrolling and application-owned text selection. */
+    mouse?: boolean;
+    /** Style a non-current transcript search match. */
+    searchMatchStyle?: (text: string) => string;
+    /** Style the current transcript search match. */
+    searchCurrentMatchStyle?: (text: string) => string;
+    /** Open an OSC 8 hyperlink activated with a primary-button click. */
+    openUrl?: (url: string) => void;
+    /** Handle an unmodified secondary-button press for clipboard paste. Currently enabled on Windows only. */
+    onRightClickPaste?: () => void;
+    /**
+     * Copy selected text to the system clipboard. Return `true` on success; the caller flashes
+     * an error otherwise. When omitted, the selection is copied via an OSC 52 write.
+     */
+    copySelection?: (text: string) => Promise<boolean>;
+}
+/** Alternate-screen TUI with a scrollable, application-owned viewport. */
+export declare class TuiAltScreen extends TuiBase implements ViewportTUI {
+    readonly mode: "fullscreen";
+    readonly [VIEWPORT_TUI]: true;
+    private previousScreen;
+    private lastDocument;
+    private previousScreenWidth;
+    private previousScreenHeight;
+    private layoutRoot;
+    private currentLayout;
+    private readonly implicitDocument;
+    private readonly implicitScrollView;
+    private readonly flashes;
+    private altScreenActive;
+    private imageProtocol;
+    private savedCapabilities?;
+    private readonly uploadedKittyImages;
+    private selectionAnchor?;
+    private selectionFocus?;
+    private selectionGranularity;
+    private selectionInitialRange?;
+    private lastClick?;
+    private selectionDragPointer?;
+    private selectionAutoScrollDirection;
+    private selectionAutoScrollTimer?;
+    private selectionPressActive;
+    private scrollbarDrag?;
+    private scrollbarHover?;
+    private activeSearch?;
+    private pressedUrl?;
+    private selectionDragged;
+    private readonly wheelScrollLines;
+    private readonly mouseEnabled;
+    private readonly searchMatchStyle;
+    private readonly searchCurrentMatchStyle;
+    private readonly openUrl?;
+    private readonly onRightClickPaste?;
+    private readonly copySelection?;
+    constructor(terminal: Terminal, showHardwareCursor?: boolean, logDirectory?: string, options?: TuiAltScreenOptions);
+    get viewportTop(): number;
+    get isFollowingOutput(): boolean;
+    setLayoutRoot(component: Component | undefined): void;
+    render(width: number): string[];
+    protected getMountedRoots(): readonly Component[];
+    private getPrimaryScrollView;
+    protected beforeTerminalStart(): void;
+    protected beforeTerminalStop(_options: TuiStopOptions): void;
+    protected afterTerminalStop(options: TuiStopOptions): void;
+    private deleteKittyImages;
+    private prepareKittyScreen;
+    protected resetRenderState(): void;
+    scrollBy(lines: number): void;
+    scrollToTop(): void;
+    scrollToBottom(): void;
+    private scrollToPrompt;
+    private openSearch;
+    private closeSearch;
+    private updateSearchQuery;
+    private navigateSearch;
+    private refreshSearch;
+    /** Show a transient message in the alternate-screen flash stack. */
+    flash(message: string, durationMs?: number): void;
+    private shouldDeferViewportInputToOverlay;
+    private handleViewportInput;
+    private parseWheelEvent;
+    private routeWheel;
+    private parseSgrMouseEvent;
+    private handleRightClickPaste;
+    private getScrollbarTargetAt;
+    private setScrollbarHover;
+    private updateScrollbarHover;
+    private stopScrollbarHover;
+    private handleScrollbarMouseEvent;
+    private stopScrollbarDrag;
+    private getScrollSelectionPoint;
+    private getSelectionPoint;
+    private getSelectionSourceLine;
+    private getWordSelection;
+    private getLineSelection;
+    private updateSelectionFocus;
+    private getClickCount;
+    private updateSelectionAutoScroll;
+    private autoScrollSelection;
+    private stopSelectionAutoScroll;
+    private handleSelectionMouseEvent;
+    private getSelectionBounds;
+    private getSelectionColumns;
+    private copySelectionToClipboard;
+    private applySearchTextHighlight;
+    private applySearchHighlights;
+    private applySelectionHighlight;
+    private applySelection;
+    private isMouseSequence;
+    private compositeFlashes;
+    protected doRender(): void;
+}
+//# sourceMappingURL=tui-alt-screen.d.ts.map

package/lib/tui-alt-screen.d.ts.map

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