@indianic/dialout 1.1.2 → 1.2.0

package/dist/terminal-detect.js

@@ -0,0 +1,147 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.currentTerminalToken = currentTerminalToken;
+exports.detectTerminals = detectTerminals;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const has_command_1 = require("./has-command");
+const terminal_markers_1 = require("./terminal-markers");
+// token = TERM_PROGRAM value unless noted; runtime marker fallbacks handled in
+// currentTerminalToken(). Order here is the checklist's base order.
+const KNOWN_TERMINALS = [
+    { name: 'Hyper', token: 'Hyper', appBundles: ['Hyper.app'], linuxBins: ['hyper'] },
+    { name: 'iTerm', token: 'iTerm.app', appBundles: ['iTerm.app'], linuxBins: [] },
+    { name: 'Apple Terminal', token: 'Apple_Terminal', appBundles: ['Terminal.app'], linuxBins: [] },
+    { name: 'VS Code', token: 'vscode', appBundles: ['Visual Studio Code.app', 'Code.app'], linuxBins: ['code'] },
+    { name: 'Ghostty', token: 'ghostty', appBundles: ['Ghostty.app'], linuxBins: ['ghostty'] },
+    { name: 'WezTerm', token: 'WezTerm', appBundles: ['WezTerm.app'], linuxBins: ['wezterm'] },
+    { name: 'Kitty', token: 'kitty', appBundles: ['kitty.app'], linuxBins: ['kitty'] },
+    { name: 'Alacritty', token: 'alacritty', appBundles: ['Alacritty.app'], linuxBins: ['alacritty'] },
+    { name: 'GNOME Terminal', token: 'gnome-terminal', appBundles: [], linuxBins: ['gnome-terminal'] },
+    { name: 'Konsole', token: 'konsole', appBundles: [], linuxBins: ['konsole'] },
+    // Newly-detectable via the /proc process-tree fallback (terminal-markers.ts)
+    // — appended after Konsole so the existing macOS checklist order is untouched.
+    { name: 'Tilix', token: 'tilix', appBundles: [], linuxBins: ['tilix'] },
+    { name: 'Terminator', token: 'terminator', appBundles: [], linuxBins: ['terminator'] },
+    { name: 'XFCE Terminal', token: 'xfce4-terminal', appBundles: [], linuxBins: ['xfce4-terminal'] },
+    { name: 'Foot', token: 'foot', appBundles: [], linuxBins: ['foot'] },
+    { name: 'urxvt', token: 'urxvt', appBundles: [], linuxBins: ['urxvt'] },
+    { name: 'xterm', token: 'xterm', appBundles: [], linuxBins: ['xterm'] },
+];
+const APP_DIRS = [
+    '/Applications',
+    path.join(os.homedir(), 'Applications'),
+    '/System/Applications',
+    '/System/Applications/Utilities',
+];
+function defaultAppExists(bundle) {
+    for (const dir of APP_DIRS) {
+        try {
+            if (fs.existsSync(path.join(dir, bundle)))
+                return true;
+        }
+        catch {
+            /* FS error → treat as not present, keep checking */
+        }
+    }
+    return false;
+}
+/**
+ * Canonical token for the terminal setup is running in, or "" if unknown.
+ * Delegates to the shared terminal-markers.ts table so this can never drift
+ * from the generated shell gate (cowork.ts): tokenFromEnv() first (handles
+ * the TMUX guard, TERM_PROGRAM, and ENV_MARKERS), then — only on linux, where
+ * /proc exists — tokenFromProcTree() walks up from the ppid for the emulators
+ * that set no distinguishing env var at all (xfce4-terminal, foot, urxvt,
+ * xterm, st, ...). macOS never reaches the /proc fallback: behavior there is
+ * unchanged.
+ *
+ * The generic GENERIC_ENV_TOKEN ("vte") result is PROVISIONAL: every VTE-based
+ * terminal exports VTE_VERSION, so treating it as final shadowed every
+ * PROC_NAMES entry that is also VTE-based (xfce4-terminal today; guake,
+ * mate-terminal tomorrow) and made their checklist rows unreachable. So the
+ * walk still runs for it and a specific token wins, with "vte" restored when
+ * the walk finds nothing. The emitted shell walk guard does exactly the same
+ * (renderProcWalk in cowork.ts) — that is the invariant.
+ */
+function currentTerminalToken(env = process.env, deps = {}) {
+    const token = (0, terminal_markers_1.tokenFromEnv)(env);
+    if (token !== '' && token !== terminal_markers_1.GENERIC_ENV_TOKEN)
+        return token;
+    const platform = deps.platform ?? process.platform;
+    // Non-linux has no /proc: keep whatever env gave us (including "vte").
+    if (platform !== 'linux')
+        return token;
+    const ppid = deps.ppid ?? process.ppid;
+    return (0, terminal_markers_1.tokenFromProcTree)(ppid, deps.procDeps) || token;
+}
+function detectTerminals(deps = {}) {
+    const env = deps.env ?? process.env;
+    const platform = deps.platform ?? process.platform;
+    const appExists = deps.appExists ?? defaultAppExists;
+    const hasCommand = deps.hasCommand ?? has_command_1.hasCommand;
+    const currentToken = currentTerminalToken(env, {
+        platform,
+        ppid: deps.ppid,
+        procDeps: deps.procDeps,
+    });
+    const rows = KNOWN_TERMINALS.map((e) => {
+        const installed = platform === 'darwin'
+            ? e.appBundles.some(appExists)
+            : e.linuxBins.some(hasCommand);
+        return {
+            name: e.name,
+            token: e.token,
+            appBundles: e.appBundles,
+            installed,
+            current: currentToken !== '' && e.token === currentToken,
+        };
+    });
+    // Always-include rule: current terminal isn't in the known table → append it
+    // so the user can always pick "this terminal."
+    if (currentToken !== '' && !rows.some((r) => r.token === currentToken)) {
+        rows.push({
+            name: currentToken,
+            token: currentToken,
+            appBundles: [],
+            installed: true,
+            current: true,
+        });
+    }
+    return rows;
+}
+//# sourceMappingURL=terminal-detect.js.map

package/dist/terminal-detect.js.map

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

package/dist/terminal-markers.d.ts

@@ -0,0 +1,52 @@
+export interface EnvMarker {
+    /** Env var whose non-empty presence identifies the terminal. */
+    envVar: string;
+    /** Canonical token, must satisfy /^[A-Za-z0-9._-]+$/. */
+    token: string;
+}
+/**
+ * The generic VTE catch-all token (ENV_MARKERS' last entry).
+ *
+ * PROVISIONAL, not final. Every VTE-based terminal exports VTE_VERSION, so a
+ * bare `vte` result only means "some VTE terminal" — it does NOT mean env
+ * resolution identified the emulator. Terminals like xfce4-terminal set no
+ * specific env marker but ARE in PROC_NAMES, so a `vte` result must not stop
+ * resolution: the /proc walk still runs and a specific token from it wins,
+ * with `vte` restored when the walk finds nothing. Both sides implement this —
+ * currentTerminalToken() in terminal-detect.ts and the walk guard emitted by
+ * renderProcWalk() in cowork.ts — so they resolve identically (Constraint 5).
+ *
+ * Without it, the "XFCE Terminal" checklist row could never be `current` and
+ * selecting it was a silent no-op: the exact bug this branch exists to fix.
+ */
+export declare const GENERIC_ENV_TOKEN = "vte";
+export declare const ENV_MARKERS: EnvMarker[];
+/** Resolve a token from env: TERM_PROGRAM first, then ENV_MARKERS in order. */
+export declare function tokenFromEnv(env: NodeJS.ProcessEnv): string;
+/** Linux emulator process names (from /proc/<pid>/comm) → canonical token. */
+export declare const PROC_NAMES: Record<string, string>;
+export interface ProcDeps {
+    /** Returns the trimmed contents of /proc/<pid>/comm. */
+    readComm?: (pid: number) => string;
+    /** Returns the ppid parsed from /proc/<pid>/stat. */
+    readPPid?: (pid: number) => number;
+}
+/**
+ * Parses the ppid out of raw /proc/<pid>/stat contents. Must parse from the
+ * LAST ")" forward: the process name (2nd field, in parens) can itself
+ * contain spaces and parentheses, so a naive whitespace split would grab the
+ * wrong field. After the last ")" the remaining fields are: state, ppid, ...
+ */
+export declare function ppidFromStat(stat: string): number;
+/**
+ * Walks up the process tree from startPid, at most 10 levels, looking for a
+ * comm that matches PROC_NAMES. Returns the first matching token, or '' if
+ * nothing matched, the bound was hit, or any read failed.
+ *
+ * This runs on every interactive shell start (via the generated rc block's
+ * shell-equivalent walk), so the 10-level bound is a hard requirement, and a
+ * read failure (e.g. no /proc on macOS) must end the walk silently rather
+ * than throw.
+ */
+export declare function tokenFromProcTree(startPid: number, deps?: ProcDeps): string;
+//# sourceMappingURL=terminal-markers.d.ts.map

package/dist/terminal-markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-markers.d.ts","sourceRoot":"","sources":["../src/terminal-markers.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,SAAS;IACxB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAOvC,eAAO,MAAM,WAAW,EAAE,SAAS,EAUlC,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAQ3D;AASD,8EAA8E;AAC9E,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgB7C,CAAC;AAEF,MAAM,WAAW,QAAQ;IACvB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAUD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,QAAa,GAAG,MAAM,CAkC/E"}

package/dist/terminal-markers.js

@@ -0,0 +1,174 @@
+"use strict";
+// Single source of truth for "which env var proves which terminal". Both the
+// generated shell gate (cowork.ts) and Node-side detection (terminal-detect.ts)
+// are rewired onto this table so they can no longer drift apart.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROC_NAMES = exports.ENV_MARKERS = exports.GENERIC_ENV_TOKEN = void 0;
+exports.tokenFromEnv = tokenFromEnv;
+exports.ppidFromStat = ppidFromStat;
+exports.tokenFromProcTree = tokenFromProcTree;
+const fs = __importStar(require("fs"));
+/**
+ * The generic VTE catch-all token (ENV_MARKERS' last entry).
+ *
+ * PROVISIONAL, not final. Every VTE-based terminal exports VTE_VERSION, so a
+ * bare `vte` result only means "some VTE terminal" — it does NOT mean env
+ * resolution identified the emulator. Terminals like xfce4-terminal set no
+ * specific env marker but ARE in PROC_NAMES, so a `vte` result must not stop
+ * resolution: the /proc walk still runs and a specific token from it wins,
+ * with `vte` restored when the walk finds nothing. Both sides implement this —
+ * currentTerminalToken() in terminal-detect.ts and the walk guard emitted by
+ * renderProcWalk() in cowork.ts — so they resolve identically (Constraint 5).
+ *
+ * Without it, the "XFCE Terminal" checklist row could never be `current` and
+ * selecting it was a silent no-op: the exact bug this branch exists to fix.
+ */
+exports.GENERIC_ENV_TOKEN = 'vte';
+// Order matters: more specific markers first, VTE_VERSION last as the generic
+// catch-all — every VTE-based terminal (gnome-terminal, tilix, terminator,
+// xfce4-terminal, guake) sets it, so it's only reached when nothing more
+// specific matched. See GENERIC_ENV_TOKEN: matching it is provisional, and the
+// /proc walk still gets a chance to name the emulator exactly.
+exports.ENV_MARKERS = [
+    { envVar: 'KITTY_WINDOW_ID', token: 'kitty' },
+    { envVar: 'ALACRITTY_WINDOW_ID', token: 'alacritty' },
+    { envVar: 'WEZTERM_PANE', token: 'WezTerm' },
+    { envVar: 'KONSOLE_VERSION', token: 'konsole' },
+    { envVar: 'TILIX_ID', token: 'tilix' },
+    { envVar: 'TERMINATOR_UUID', token: 'terminator' },
+    { envVar: 'GNOME_TERMINAL_SCREEN', token: 'gnome-terminal' },
+    { envVar: 'GNOME_TERMINAL_SERVICE', token: 'gnome-terminal' },
+    { envVar: 'VTE_VERSION', token: exports.GENERIC_ENV_TOKEN },
+];
+/** Resolve a token from env: TERM_PROGRAM first, then ENV_MARKERS in order. */
+function tokenFromEnv(env) {
+    // Inside tmux the real outer app is unknowable → report unknown.
+    if (env.TMUX || env.TERM_PROGRAM === 'tmux')
+        return '';
+    if (env.TERM_PROGRAM)
+        return env.TERM_PROGRAM;
+    for (const { envVar, token } of exports.ENV_MARKERS) {
+        if (env[envVar])
+            return token;
+    }
+    return '';
+}
+// --- /proc process-tree fallback ---
+//
+// Some Linux terminals (xfce4-terminal, foot, urxvt, xterm, st, ...) set no
+// distinguishing env var at all, so tokenFromEnv() returns '' for them. These
+// can still be identified by walking up the process tree (via /proc) and
+// matching the emulator's process name.
+/** Linux emulator process names (from /proc/<pid>/comm) → canonical token. */
+exports.PROC_NAMES = {
+    'xfce4-terminal': 'xfce4-terminal',
+    foot: 'foot',
+    urxvt: 'urxvt',
+    'rxvt-unicode': 'urxvt',
+    xterm: 'xterm',
+    st: 'st',
+    konsole: 'konsole',
+    // The kernel truncates /proc/<pid>/comm to 15 chars, so
+    // "gnome-terminal-server" is stored (and looked up) as "gnome-terminal-".
+    'gnome-terminal-': 'gnome-terminal',
+    tilix: 'tilix',
+    terminator: 'terminator',
+    alacritty: 'alacritty',
+    kitty: 'kitty',
+    'wezterm-gui': 'WezTerm',
+};
+/**
+ * Parses the ppid out of raw /proc/<pid>/stat contents. Must parse from the
+ * LAST ")" forward: the process name (2nd field, in parens) can itself
+ * contain spaces and parentheses, so a naive whitespace split would grab the
+ * wrong field. After the last ")" the remaining fields are: state, ppid, ...
+ */
+function ppidFromStat(stat) {
+    const rest = stat.slice(stat.lastIndexOf(')') + 1).trim().split(/\s+/);
+    return parseInt(rest[1], 10);
+}
+function defaultReadComm(pid) {
+    return fs.readFileSync(`/proc/${pid}/comm`, 'utf8').trim();
+}
+function defaultReadPPid(pid) {
+    return ppidFromStat(fs.readFileSync(`/proc/${pid}/stat`, 'utf8'));
+}
+/**
+ * Walks up the process tree from startPid, at most 10 levels, looking for a
+ * comm that matches PROC_NAMES. Returns the first matching token, or '' if
+ * nothing matched, the bound was hit, or any read failed.
+ *
+ * This runs on every interactive shell start (via the generated rc block's
+ * shell-equivalent walk), so the 10-level bound is a hard requirement, and a
+ * read failure (e.g. no /proc on macOS) must end the walk silently rather
+ * than throw.
+ */
+function tokenFromProcTree(startPid, deps = {}) {
+    const readComm = deps.readComm ?? defaultReadComm;
+    const readPPid = deps.readPPid ?? defaultReadPPid;
+    let pid = startPid;
+    for (let level = 0; level < 10; level++) {
+        if (pid <= 1)
+            return '';
+        let comm;
+        try {
+            comm = readComm(pid);
+        }
+        catch {
+            return '';
+        }
+        // Guard against prototype-chain collisions: a comm of e.g. "constructor"
+        // or "toString" is a valid (if adversarial) 15-char-or-shorter process
+        // name, and PROC_NAMES is a plain object literal, so an unguarded
+        // PROC_NAMES[comm] lookup would resolve to an inherited Object.prototype
+        // member (a function, always truthy) instead of undefined.
+        if (Object.prototype.hasOwnProperty.call(exports.PROC_NAMES, comm)) {
+            return exports.PROC_NAMES[comm];
+        }
+        let ppid;
+        try {
+            ppid = readPPid(pid);
+        }
+        catch {
+            return '';
+        }
+        if (!Number.isFinite(ppid))
+            return '';
+        pid = ppid;
+    }
+    return '';
+}
+//# sourceMappingURL=terminal-markers.js.map

package/dist/terminal-markers.js.map

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

package/dist/tmux-manager.d.ts

@@ -0,0 +1,35 @@
+export interface TmuxSessionInfo {
+    name: string;
+    createdAt: number;
+    attached: number;
+    lastActivity: number;
+    width: number;
+    height: number;
+    termProgram: string;
+    origin: 'native' | 'browser';
+    folder: string;
+    folderPath: string;
+    createdLocal: string;
+    gitBranch: string;
+}
+export declare const SEP = "\u001F";
+export declare function tmuxLocaleEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function tmuxAvailable(now?: () => number): Promise<boolean>;
+/** Test seam: forget the cached probe result. */
+export declare function resetTmuxAvailableCache(): void;
+export declare function parseSessionLine(line: string): Omit<TmuxSessionInfo, 'termProgram' | 'origin'> | null;
+export declare function getSessionOption(name: string, option: string): Promise<string>;
+export declare function listSessions(): Promise<TmuxSessionInfo[]>;
+export declare function tmuxSessionName(id: string): string;
+export interface KillDeps {
+    run?: (args: string[]) => Promise<string>;
+}
+export interface KillResult {
+    ok: boolean;
+    error?: string;
+}
+export declare function killTmuxSession(name: string, deps?: KillDeps): Promise<KillResult>;
+export declare function countClients(name: string): Promise<number>;
+export declare function tailLines(text: string, lines: number): string;
+export declare function capturePane(name: string, lines: number): Promise<string>;
+//# sourceMappingURL=tmux-manager.d.ts.map

package/dist/tmux-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux-manager.d.ts","sourceRoot":"","sources":["../src/tmux-manager.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,eAAO,MAAM,GAAG,WAAS,CAAC;AAoC1B,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAIvE;AA0BD,wBAAsB,aAAa,CAAC,GAAG,GAAE,MAAM,MAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BlF;AAED,iDAAiD;AACjD,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AAKD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,QAAQ,CAAC,GAAG,IAAI,CAcxD;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOpF;AAaD,wBAAsB,YAAY,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAkE/D;AAMD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,QAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAU5F;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOhE;AAGD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI7D;AAID,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS9E"}