@jobshimo/browser-link 0.0.1

package/dist/commands/menu.js

@@ -0,0 +1,187 @@
+import { stdout } from 'node:process';
+import { claudeInstaller } from '../installers/claude.js';
+import { installFor } from './install.js';
+import { formatDoctor, runDoctor } from './doctor.js';
+import { printExtensionInstructions } from './extension.js';
+import { runWelcome } from './welcome.js';
+import { runAbout } from './about.js';
+import { openUrl } from '../utils/open-url.js';
+const REPO_URL = 'https://github.com/jobshimo/browser-link';
+import { ansi, classifyKey, clearScreen, hideCursor, readKey, renderBox, showCursor, } from './tty.js';
+export const I18N_MENU = {
+    en: {
+        title: 'browser-link — setup',
+        prompt: '↑/↓ to move, Enter to select, q to quit',
+        pressEnter: 'Press Enter to return to the menu…',
+        options: {
+            register: 'Register browser-link in Claude Code',
+            extension: 'Show Chrome extension install steps',
+            doctor: 'Run doctor (diagnose current setup)',
+            welcome: 'Show welcome screen',
+            about: 'About / Help — what is this and how it works',
+            repo: 'Open the GitHub repository (view code, report issues, contribute)',
+            quit: 'Quit',
+        },
+        statusRegistered: 'already registered',
+        statusNotRegistered: 'not registered',
+        statusClientMissing: 'Claude config not found',
+        registerSuccessHint: 'Restart Claude Code so it picks up the new MCP entry.',
+        repoOpened: 'Opening the repository in your browser…',
+        repoFallback: 'Could not open a browser automatically. Visit:',
+    },
+    es: {
+        title: 'browser-link — configuración',
+        prompt: '↑/↓ para moverte, Enter para elegir, q para salir',
+        pressEnter: 'Pulsá Enter para volver al menú…',
+        options: {
+            register: 'Registrar browser-link en Claude Code',
+            extension: 'Ver pasos para instalar la extensión de Chrome',
+            doctor: 'Diagnóstico (estado actual de la instalación)',
+            welcome: 'Mostrar pantalla de bienvenida',
+            about: 'Información / ayuda — qué es esto y cómo funciona',
+            repo: 'Abrir el repositorio en GitHub (ver código, reportar bugs, contribuir)',
+            quit: 'Salir',
+        },
+        statusRegistered: 'ya registrado',
+        statusNotRegistered: 'no registrado',
+        statusClientMissing: 'config de Claude no encontrada',
+        registerSuccessHint: 'Reiniciá Claude Code para que tome el nuevo MCP.',
+        repoOpened: 'Abriendo el repositorio en tu navegador…',
+        repoFallback: 'No se pudo abrir el navegador automáticamente. Visitá:',
+    },
+};
+export function claudeStatus(t) {
+    const d = claudeInstaller.detect();
+    if (!d.installed)
+        return t.statusClientMissing;
+    return d.registered ? t.statusRegistered : t.statusNotRegistered;
+}
+export function renderMenuScreen(t, selectedIndex, options) {
+    const lines = [];
+    lines.push(`${ansi.bold}${ansi.cyan}${t.title}${ansi.reset}`);
+    lines.push('');
+    options.forEach((label, i) => {
+        const isSel = i === selectedIndex;
+        const cursor = isSel ? `${ansi.cyan}❯${ansi.reset}` : ' ';
+        const body = isSel ? `${ansi.bold}${label}${ansi.reset}` : `${ansi.gray}${label}${ansi.reset}`;
+        lines.push(`  ${cursor} ${body}`);
+    });
+    lines.push('');
+    lines.push(`${ansi.dim}${t.prompt}${ansi.reset}`);
+    return renderBox(lines, { borderColor: ansi.gray });
+}
+async function pressEnter(t) {
+    stdout.write('\n' + ansi.dim + t.pressEnter + ansi.reset + ' ');
+    while (true) {
+        const k = classifyKey(await readKey());
+        if (k === 'enter' || k === 'ctrl-c' || k === 'esc' || k === 'q')
+            break;
+    }
+}
+async function runOption(t, index, language) {
+    let lang = language;
+    switch (index) {
+        case 0: {
+            clearScreen();
+            const report = installFor('claude');
+            const mark = report.installedClient
+                ? `${ansi.green}✓${ansi.reset}`
+                : `${ansi.gray}·${ansi.reset}`;
+            console.log(`${mark} ${ansi.bold}${report.displayName}${ansi.reset}: ${report.message}`);
+            if (report.installedClient)
+                console.log(`  ${ansi.cyan}→${ansi.reset} ${t.registerSuccessHint}`);
+            await pressEnter(t);
+            return { keep: true, language: lang };
+        }
+        case 1: {
+            clearScreen();
+            printExtensionInstructions();
+            await pressEnter(t);
+            return { keep: true, language: lang };
+        }
+        case 2: {
+            clearScreen();
+            const r = await runDoctor();
+            console.log(formatDoctor(r));
+            await pressEnter(t);
+            return { keep: true, language: lang };
+        }
+        case 3: {
+            // Show welcome again (forced; hides "Don't show again" because the
+            // user explicitly asked to see it).
+            const result = await runWelcome({ initial: lang, hideDismiss: true });
+            if (result.action === 'quit')
+                return { keep: false, language: lang };
+            lang = result.language;
+            return { keep: true, language: lang };
+        }
+        case 4: {
+            await runAbout(lang);
+            return { keep: true, language: lang };
+        }
+        case 5: {
+            clearScreen();
+            const ok = openUrl(REPO_URL);
+            if (ok) {
+                console.log(`${ansi.cyan}→${ansi.reset} ${t.repoOpened}`);
+                console.log(`  ${ansi.dim}${REPO_URL}${ansi.reset}`);
+            }
+            else {
+                console.log(`${ansi.yellow}!${ansi.reset} ${t.repoFallback}`);
+                console.log(`  ${ansi.cyan}${REPO_URL}${ansi.reset}`);
+            }
+            await pressEnter(t);
+            return { keep: true, language: lang };
+        }
+        case 6:
+            return { keep: false, language: lang };
+        default:
+            return { keep: true, language: lang };
+    }
+}
+export async function runMenu(initialLanguage = 'en') {
+    let language = initialLanguage;
+    let selected = 0;
+    hideCursor();
+    try {
+        while (true) {
+            const t = I18N_MENU[language];
+            const opts = [
+                `${t.options.register}   ${ansi.dim}(${claudeStatus(t)})${ansi.reset}`,
+                t.options.extension,
+                t.options.doctor,
+                t.options.welcome,
+                t.options.about,
+                t.options.repo,
+                t.options.quit,
+            ];
+            clearScreen();
+            stdout.write(renderMenuScreen(t, selected, opts));
+            stdout.write('\n');
+            const key = classifyKey(await readKey());
+            if (key === 'ctrl-c' || key === 'esc' || key === 'q')
+                return;
+            if (key === 'up') {
+                selected = (selected - 1 + opts.length) % opts.length;
+                continue;
+            }
+            if (key === 'down') {
+                selected = (selected + 1) % opts.length;
+                continue;
+            }
+            if (key === 'enter') {
+                showCursor();
+                const result = await runOption(t, selected, language);
+                if (!result.keep)
+                    return;
+                language = result.language;
+                hideCursor();
+            }
+        }
+    }
+    finally {
+        showCursor();
+        stdout.write('\n');
+    }
+}
+//# sourceMappingURL=menu.js.map

package/dist/commands/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../../src/commands/menu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAiB,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,MAAM,QAAQ,GAAG,0CAA0C,CAAC;AAC5D,OAAO,EACL,IAAI,EACJ,WAAW,EACX,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,UAAU,GACX,MAAM,UAAU,CAAC;AAuBlB,MAAM,CAAC,MAAM,SAAS,GAA+B;IACnD,EAAE,EAAE;QACF,KAAK,EAAE,sBAAsB;QAC7B,MAAM,EAAE,yCAAyC;QACjD,UAAU,EAAE,oCAAoC;QAChD,OAAO,EAAE;YACP,QAAQ,EAAE,sCAAsC;YAChD,SAAS,EAAE,qCAAqC;YAChD,MAAM,EAAE,qCAAqC;YAC7C,OAAO,EAAE,qBAAqB;YAC9B,KAAK,EAAE,8CAA8C;YACrD,IAAI,EAAE,mEAAmE;YACzE,IAAI,EAAE,MAAM;SACb;QACD,gBAAgB,EAAE,oBAAoB;QACtC,mBAAmB,EAAE,gBAAgB;QACrC,mBAAmB,EAAE,yBAAyB;QAC9C,mBAAmB,EAAE,uDAAuD;QAC5E,UAAU,EAAE,yCAAyC;QACrD,YAAY,EAAE,gDAAgD;KAC/D;IACD,EAAE,EAAE;QACF,KAAK,EAAE,8BAA8B;QACrC,MAAM,EAAE,mDAAmD;QAC3D,UAAU,EAAE,kCAAkC;QAC9C,OAAO,EAAE;YACP,QAAQ,EAAE,uCAAuC;YACjD,SAAS,EAAE,gDAAgD;YAC3D,MAAM,EAAE,+CAA+C;YACvD,OAAO,EAAE,gCAAgC;YACzC,KAAK,EAAE,mDAAmD;YAC1D,IAAI,EAAE,wEAAwE;YAC9E,IAAI,EAAE,OAAO;SACd;QACD,gBAAgB,EAAE,eAAe;QACjC,mBAAmB,EAAE,eAAe;QACpC,mBAAmB,EAAE,gCAAgC;QACrD,mBAAmB,EAAE,kDAAkD;QACvE,UAAU,EAAE,0CAA0C;QACtD,YAAY,EAAE,wDAAwD;KACvE;CACF,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,CAAW;IACtC,MAAM,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC;IACnC,IAAI,CAAC,CAAC,CAAC,SAAS;QAAE,OAAO,CAAC,CAAC,mBAAmB,CAAC;IAC/C,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAAW,EAAE,aAAqB,EAAE,OAAiB;IACpF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,CAAC,KAAK,aAAa,CAAC;QAClC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC/F,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAClD,OAAO,SAAS,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,CAAW;IACnC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IAChE,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,GAAG;YAAE,MAAM;IACzE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,CAAW,EACX,KAAa,EACb,QAAkB;IAElB,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,CAAC,CAAC,CAAC,CAAC;YACP,WAAW,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACpC,MAAM,IAAI,GAAG,MAAM,CAAC,eAAe;gBACjC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE;gBAC/B,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACzF,IAAI,MAAM,CAAC,eAAe;gBACxB,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;YACvE,MAAM,UAAU,CAAC,CAAC,CAAC,CAAC;YACpB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC;QACD,KAAK,CAAC,CAAC,CAAC,CAAC;YACP,WAAW,EAAE,CAAC;YACd,0BAA0B,EAAE,CAAC;YAC7B,MAAM,UAAU,CAAC,CAAC,CAAC,CAAC;YACpB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC;QACD,KAAK,CAAC,CAAC,CAAC,CAAC;YACP,WAAW,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,UAAU,CAAC,CAAC,CAAC,CAAC;YACpB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC;QACD,KAAK,CAAC,CAAC,CAAC,CAAC;YACP,mEAAmE;YACnE,oCAAoC;YACpC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;YACtE,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM;gBAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACrE,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;YACvB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC;QACD,KAAK,CAAC,CAAC,CAAC,CAAC;YACP,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;YACrB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC;QACD,KAAK,CAAC,CAAC,CAAC,CAAC;YACP,WAAW,EAAE,CAAC;YACd,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC7B,IAAI,EAAE,EAAE,CAAC;gBACP,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,GAAG,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACvD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;gBAC9D,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACxD,CAAC;YACD,MAAM,UAAU,CAAC,CAAC,CAAC,CAAC;YACpB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC;QACD,KAAK,CAAC;YACJ,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACzC;YACE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,kBAA4B,IAAI;IAC5D,IAAI,QAAQ,GAAG,eAAe,CAAC;IAC/B,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,UAAU,EAAE,CAAC;IACb,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC9B,MAAM,IAAI,GAAG;gBACX,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,MAAM,IAAI,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE;gBACtE,CAAC,CAAC,OAAO,CAAC,SAAS;gBACnB,CAAC,CAAC,OAAO,CAAC,MAAM;gBAChB,CAAC,CAAC,OAAO,CAAC,OAAO;gBACjB,CAAC,CAAC,OAAO,CAAC,KAAK;gBACf,CAAC,CAAC,OAAO,CAAC,IAAI;gBACd,CAAC,CAAC,OAAO,CAAC,IAAI;aACf,CAAC;YACF,WAAW,EAAE,CAAC;YACd,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEnB,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;YACzC,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,GAAG;gBAAE,OAAO;YAC7D,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACjB,QAAQ,GAAG,CAAC,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;gBACtD,SAAS;YACX,CAAC;YACD,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,QAAQ,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;gBACxC,SAAS;YACX,CAAC;YACD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;gBACpB,UAAU,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACtD,IAAI,CAAC,MAAM,CAAC,IAAI;oBAAE,OAAO;gBACzB,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;gBAC3B,UAAU,EAAE,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,UAAU,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/commands/tty.d.ts

@@ -0,0 +1,51 @@
+export declare const ansi: {
+    reset: string;
+    bold: string;
+    dim: string;
+    italic: string;
+    underline: string;
+    black: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    gray: string;
+    bgYellow: string;
+    bgRed: string;
+    clearScreen: string;
+    hideCursor: string;
+    showCursor: string;
+};
+export declare const KEY: {
+    CTRL_C: string;
+    ESC: string;
+    ENTER_CR: string;
+    ENTER_LF: string;
+    UP: string;
+    DOWN: string;
+    RIGHT: string;
+    LEFT: string;
+};
+/** Visible width of a string (ignores ANSI escape sequences). Treats every
+ * other code point as 1 column — fine for ASCII + the Latin range we use. */
+export declare function visibleWidth(s: string): number;
+export declare function padRight(s: string, width: number): string;
+/** Wrap a line at the given width, preserving simple ANSI runs. */
+export declare function wrap(text: string, width: number): string[];
+export interface BoxOptions {
+    width?: number;
+    borderColor?: string;
+}
+/** Render an array of lines inside a rounded Unicode box. */
+export declare function renderBox(lines: string[], opts?: BoxOptions): string;
+/** Read a single keypress from stdin without echoing. Returns the raw key
+ * (a control sequence for arrows, '\r' for enter, etc.). */
+export declare function readKey(): Promise<string>;
+/** Classify a raw key into a logical name. */
+export declare function classifyKey(raw: string): string;
+export declare function clearScreen(): void;
+export declare function hideCursor(): void;
+export declare function showCursor(): void;

package/dist/commands/tty.js

@@ -0,0 +1,148 @@
+import { stdin, stdout } from 'node:process';
+/* ANSI helpers — no dependencies. Modern terminals (macOS Terminal, iTerm,
+ * Windows Terminal, PowerShell 7+, every Linux TTY) understand these.
+ * Old cmd.exe may render the box characters poorly but the flow still works. */
+const ESC = '\x1b';
+export const ansi = {
+    reset: `${ESC}[0m`,
+    bold: `${ESC}[1m`,
+    dim: `${ESC}[2m`,
+    italic: `${ESC}[3m`,
+    underline: `${ESC}[4m`,
+    black: `${ESC}[30m`,
+    red: `${ESC}[31m`,
+    green: `${ESC}[32m`,
+    yellow: `${ESC}[33m`,
+    blue: `${ESC}[34m`,
+    magenta: `${ESC}[35m`,
+    cyan: `${ESC}[36m`,
+    white: `${ESC}[37m`,
+    gray: `${ESC}[90m`,
+    bgYellow: `${ESC}[43m`,
+    bgRed: `${ESC}[41m`,
+    clearScreen: `${ESC}[2J${ESC}[H`,
+    hideCursor: `${ESC}[?25l`,
+    showCursor: `${ESC}[?25h`,
+};
+export const KEY = {
+    CTRL_C: '\x03',
+    ESC: '\x1b',
+    ENTER_CR: '\r',
+    ENTER_LF: '\n',
+    UP: '\x1b[A',
+    DOWN: '\x1b[B',
+    RIGHT: '\x1b[C',
+    LEFT: '\x1b[D',
+};
+/** Visible width of a string (ignores ANSI escape sequences). Treats every
+ * other code point as 1 column — fine for ASCII + the Latin range we use. */
+export function visibleWidth(s) {
+    // eslint-disable-next-line no-control-regex
+    return s.replace(/\x1b\[[0-9;?]*[a-zA-Z]/g, '').length;
+}
+export function padRight(s, width) {
+    const diff = width - visibleWidth(s);
+    return diff > 0 ? s + ' '.repeat(diff) : s;
+}
+/** Wrap a line at the given width, preserving simple ANSI runs. */
+export function wrap(text, width) {
+    if (width <= 0)
+        return [text];
+    const lines = [];
+    for (const paragraph of text.split('\n')) {
+        if (visibleWidth(paragraph) <= width) {
+            lines.push(paragraph);
+            continue;
+        }
+        const words = paragraph.split(/\s+/);
+        let cur = '';
+        for (const w of words) {
+            if (cur.length === 0) {
+                cur = w;
+            }
+            else if (visibleWidth(cur) + 1 + visibleWidth(w) > width) {
+                lines.push(cur);
+                cur = w;
+            }
+            else {
+                cur += ' ' + w;
+            }
+        }
+        if (cur.length > 0)
+            lines.push(cur);
+    }
+    return lines;
+}
+const B = {
+    tl: '╭',
+    tr: '╮',
+    bl: '╰',
+    br: '╯',
+    h: '─',
+    v: '│',
+};
+/** Render an array of lines inside a rounded Unicode box. */
+export function renderBox(lines, opts = {}) {
+    const termWidth = stdout.columns ?? 80;
+    // 86 cols comfortably fits the longest pre-formatted line in About
+    // (tool name + padded description). Smaller terminals still get the cap.
+    const width = Math.min(opts.width ?? 86, Math.max(40, termWidth - 2));
+    const inner = width - 2; // 2 columns for the vertical borders
+    const wrapped = lines.flatMap((l) => wrap(l, inner - 2)); // padding 1 each side
+    const color = opts.borderColor ?? '';
+    const reset = color ? ansi.reset : '';
+    const top = `${color}${B.tl}${B.h.repeat(inner)}${B.tr}${reset}`;
+    const bottom = `${color}${B.bl}${B.h.repeat(inner)}${B.br}${reset}`;
+    const body = wrapped.map((l) => `${color}${B.v}${reset} ${padRight(l, inner - 2)} ${color}${B.v}${reset}`);
+    return [top, ...body, bottom].join('\n');
+}
+/** Read a single keypress from stdin without echoing. Returns the raw key
+ * (a control sequence for arrows, '\r' for enter, etc.). */
+export function readKey() {
+    return new Promise((resolve) => {
+        const wasRaw = stdin.isTTY ? stdin.isRaw : false;
+        if (stdin.isTTY)
+            stdin.setRawMode(true);
+        stdin.resume();
+        stdin.setEncoding('utf8');
+        const onData = (data) => {
+            const key = data.toString();
+            stdin.off('data', onData);
+            if (stdin.isTTY)
+                stdin.setRawMode(wasRaw);
+            stdin.pause();
+            resolve(key);
+        };
+        stdin.on('data', onData);
+    });
+}
+/** Classify a raw key into a logical name. */
+export function classifyKey(raw) {
+    if (raw === KEY.CTRL_C)
+        return 'ctrl-c';
+    if (raw === KEY.ESC)
+        return 'esc';
+    if (raw === KEY.ENTER_CR || raw === KEY.ENTER_LF)
+        return 'enter';
+    if (raw === KEY.UP)
+        return 'up';
+    if (raw === KEY.DOWN)
+        return 'down';
+    if (raw === KEY.LEFT)
+        return 'left';
+    if (raw === KEY.RIGHT)
+        return 'right';
+    if (raw.length === 1)
+        return raw.toLowerCase();
+    return raw;
+}
+export function clearScreen() {
+    stdout.write(ansi.clearScreen);
+}
+export function hideCursor() {
+    stdout.write(ansi.hideCursor);
+}
+export function showCursor() {
+    stdout.write(ansi.showCursor);
+}
+//# sourceMappingURL=tty.js.map

package/dist/commands/tty.js.map

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

package/dist/commands/uninstall.d.ts

@@ -0,0 +1,8 @@
+import { type ClientId } from '../installers/index.js';
+export interface UninstallReport {
+    client: ClientId;
+    displayName: string;
+    message: string;
+}
+export declare function uninstallFor(client: ClientId): UninstallReport;
+export declare function uninstallAll(): UninstallReport[];

package/dist/commands/uninstall.js

@@ -0,0 +1,10 @@
+import { INSTALLERS, getInstaller } from '../installers/index.js';
+export function uninstallFor(client) {
+    const inst = getInstaller(client);
+    const message = inst.uninstall();
+    return { client, displayName: inst.displayName, message };
+}
+export function uninstallAll() {
+    return INSTALLERS.map((i) => uninstallFor(i.id));
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/commands/uninstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../src/commands/uninstall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAiB,MAAM,wBAAwB,CAAC;AAQjF,MAAM,UAAU,YAAY,CAAC,MAAgB;IAC3C,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IACjC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/commands/welcome.d.ts

@@ -0,0 +1,33 @@
+export type Language = 'en' | 'es';
+export interface WelcomeResult {
+    action: 'continue' | 'quit';
+    language: Language;
+    persisted: boolean;
+}
+export interface WelcomeOptions {
+    /** Initial language to render. */
+    initial?: Language;
+    /** When true, hide the "Accept and don't show again" option. Used when
+     * the user explicitly asks to see the welcome from the menu. */
+    hideDismiss?: boolean;
+}
+interface I18n {
+    title: string;
+    intro: string[];
+    capabilities: string[];
+    warning: string[];
+    responsibility: string;
+    extensionNote: string;
+    actions: {
+        accept: string;
+        dismiss: string;
+        swap: string;
+        quit: string;
+    };
+    prompt: string;
+    promptNoDismiss: string;
+}
+export declare const I18N_WELCOME: Record<Language, I18n>;
+export declare function buildWelcomeScreen(t: I18n, hideDismiss: boolean): string;
+export declare function runWelcome(opts?: WelcomeOptions): Promise<WelcomeResult>;
+export {};

package/dist/commands/welcome.js

@@ -0,0 +1,177 @@
+import { stdout } from 'node:process';
+import { saveConfig } from '../config.js';
+import { ansi, classifyKey, clearScreen, hideCursor, readKey, renderBox, showCursor, } from './tty.js';
+export const I18N_WELCOME = {
+    en: {
+        title: 'browser-link',
+        intro: [
+            'An MCP server that opens a small WebSocket bridge between Claude Code',
+            'and the Google Chrome tabs you explicitly grant access to through a',
+            'custom companion extension you load locally.',
+        ],
+        capabilities: [
+            'On every tab where you press "Conectar" in the extension popup, the',
+            'agent can:',
+            '  • Navigate that tab to any URL',
+            '  • Read its DOM, console and network traffic',
+            '  • Click and type into its elements',
+            '  • Execute arbitrary JavaScript in the page context',
+            '',
+            'Tabs you do not connect remain invisible to the agent. You can connect',
+            'as many tabs as you want — each one is enabled one by one, by hand.',
+            '',
+            'And the server remembers what it learns about each app across sessions',
+            'in a local SQLite map (selectors, flows, gotchas — never uploaded',
+            'anywhere).',
+        ],
+        warning: [
+            `${ansi.bold}${ansi.yellow}⚠  Read this before you continue${ansi.reset}`,
+            '',
+            'Connecting a tab gives the agent access to whatever is on it — any',
+            'logged-in session, saved card, wallet, banking page, work console or',
+            'admin panel the browser is currently showing on that tab.',
+            '',
+            'Treat the agent like a junior dev given remote control of those tabs:',
+            'it can buy things, submit forms, change configurations, send messages,',
+            'or follow instructions it reads on the page that you did not write.',
+            '',
+            'Only connect tabs where you would be comfortable letting an automated',
+            'process act on your behalf. Disconnect a tab from the extension popup',
+            'when you are done with it.',
+        ],
+        responsibility: 'You are responsible for every action the agent performs on the tabs ' +
+            'you explicitly enable. The extension stays inert on any tab where ' +
+            'you have not pressed "Conectar" yourself.',
+        extensionNote: 'The Chrome extension is custom and ships inside this package. ' +
+            'The setup menu after this screen will tell you where it lives so ' +
+            'you can load it via chrome://extensions → Load unpacked.',
+        actions: {
+            accept: 'I understand, continue',
+            dismiss: "Accept and don't show again",
+            swap: 'Switch to español',
+            quit: 'Quit',
+        },
+        prompt: 'Press [A] to accept, [D] to accept & hide next time, [L] for español, [Q] to quit.',
+        promptNoDismiss: 'Press [A] to continue, [L] for español, [Q] to quit.',
+    },
+    es: {
+        title: 'browser-link',
+        intro: [
+            'Un servidor MCP que abre un puente WebSocket entre Claude Code y las',
+            'pestañas de Google Chrome a las que vos le des acceso explícito a',
+            'través de una extensión que cargás vos manualmente.',
+        ],
+        capabilities: [
+            'En cada pestaña donde pulsás "Conectar" en el popup de la extensión,',
+            'el agente puede:',
+            '  • Navegar esa pestaña a cualquier URL',
+            '  • Leer su DOM, su consola y su tráfico de red',
+            '  • Hacer click y escribir en sus elementos',
+            '  • Ejecutar JavaScript arbitrario en el contexto de la página',
+            '',
+            'Las pestañas que NO conectes siguen invisibles para el agente. Podés',
+            'conectar todas las pestañas que quieras — cada una se habilita una por',
+            'una, a mano.',
+            '',
+            'Además el servidor guarda lo que aprende de cada app entre sesiones en',
+            'un mapa SQLite local (selectores, flujos, gotchas — nunca se sube a',
+            'ningún lado).',
+        ],
+        warning: [
+            `${ansi.bold}${ansi.yellow}⚠  Leelo antes de continuar${ansi.reset}`,
+            '',
+            'Conectar una pestaña le da al agente acceso a todo lo que esté en esa',
+            'pestaña: sesiones iniciadas, tarjetas guardadas, wallets, banca,',
+            'consolas de trabajo, paneles de administración… lo que el navegador',
+            'esté mostrando en ella en ese momento.',
+            '',
+            'Tratá al agente como a un dev junior con control remoto de esas',
+            'pestañas: puede comprar cosas, enviar formularios, cambiar',
+            'configuraciones, mandar mensajes, o seguir instrucciones que lea en',
+            'la página y que vos no escribiste.',
+            '',
+            'Solo conectá pestañas donde estarías cómodo dejando que un proceso',
+            'automatizado actúe en tu nombre. Desconectá la pestaña desde el popup',
+            'cuando termines de usarla.',
+        ],
+        responsibility: 'Sos responsable de cada acción que el agente haga en las pestañas que ' +
+            'habilitás explícitamente. La extensión se mantiene inerte en cualquier ' +
+            'pestaña donde no hayas apretado "Conectar" vos mismo.',
+        extensionNote: 'La extensión de Chrome es custom y viene incluida en este paquete. ' +
+            'El menú que aparece después de esta pantalla te dice exactamente dónde ' +
+            'está para que la cargues vía chrome://extensions → Cargar sin empaquetar.',
+        actions: {
+            accept: 'Entendido, continuar',
+            dismiss: 'Aceptar y no volver a mostrar',
+            swap: 'Cambiar a English',
+            quit: 'Salir',
+        },
+        prompt: 'Pulsá [A] para aceptar, [D] para aceptar y ocultar la próxima vez, [L] para English, [Q] para salir.',
+        promptNoDismiss: 'Pulsá [A] para continuar, [L] para English, [Q] para salir.',
+    },
+};
+export function buildWelcomeScreen(t, hideDismiss) {
+    const lines = [];
+    lines.push(`${ansi.bold}${ansi.cyan}${t.title}${ansi.reset}`);
+    lines.push('');
+    for (const l of t.intro)
+        lines.push(l);
+    lines.push('');
+    for (const l of t.capabilities)
+        lines.push(l);
+    lines.push('');
+    for (const l of t.warning)
+        lines.push(l);
+    lines.push('');
+    lines.push(`${ansi.dim}${t.responsibility}${ansi.reset}`);
+    lines.push('');
+    lines.push(`${ansi.dim}${t.extensionNote}${ansi.reset}`);
+    lines.push('');
+    const acceptLine = `  ${ansi.green}[A]${ansi.reset} ${t.actions.accept}`;
+    const dismissLine = hideDismiss ? '' : `  ${ansi.green}[D]${ansi.reset} ${t.actions.dismiss}`;
+    const langLine = `  ${ansi.cyan}[L]${ansi.reset} ${t.actions.swap}`;
+    const quitLine = `  ${ansi.red}[Q]${ansi.reset} ${t.actions.quit}`;
+    if (hideDismiss) {
+        lines.push(`${acceptLine}     ${langLine}     ${quitLine}`);
+    }
+    else {
+        lines.push(acceptLine);
+        lines.push(dismissLine);
+        lines.push(`${langLine}     ${quitLine}`);
+    }
+    return renderBox(lines, { borderColor: ansi.gray });
+}
+export async function runWelcome(opts = {}) {
+    let lang = opts.initial ?? 'en';
+    const hideDismiss = opts.hideDismiss === true;
+    hideCursor();
+    try {
+        while (true) {
+            const t = I18N_WELCOME[lang];
+            clearScreen();
+            stdout.write(buildWelcomeScreen(t, hideDismiss));
+            stdout.write('\n\n');
+            stdout.write(`${ansi.dim}${hideDismiss ? t.promptNoDismiss : t.prompt}${ansi.reset} `);
+            const key = classifyKey(await readKey());
+            if (key === 'a')
+                return { action: 'continue', language: lang, persisted: false };
+            if (key === 'd' && !hideDismiss) {
+                saveConfig({ skipWelcome: true, language: lang });
+                return { action: 'continue', language: lang, persisted: true };
+            }
+            if (key === 'l') {
+                lang = lang === 'en' ? 'es' : 'en';
+                continue;
+            }
+            if (key === 'q' || key === 'esc' || key === 'ctrl-c') {
+                return { action: 'quit', language: lang, persisted: false };
+            }
+            // ignore other keys
+        }
+    }
+    finally {
+        showCursor();
+        stdout.write('\n');
+    }
+}
+//# sourceMappingURL=welcome.js.map

package/dist/commands/welcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.js","sourceRoot":"","sources":["../../src/commands/welcome.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACL,IAAI,EACJ,WAAW,EACX,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,UAAU,GACX,MAAM,UAAU,CAAC;AA8BlB,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,EAAE,EAAE;QACF,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE;YACL,uEAAuE;YACvE,qEAAqE;YACrE,8CAA8C;SAC/C;QACD,YAAY,EAAE;YACZ,qEAAqE;YACrE,YAAY;YACZ,kCAAkC;YAClC,+CAA+C;YAC/C,sCAAsC;YACtC,sDAAsD;YACtD,EAAE;YACF,wEAAwE;YACxE,qEAAqE;YACrE,EAAE;YACF,wEAAwE;YACxE,mEAAmE;YACnE,YAAY;SACb;QACD,OAAO,EAAE;YACP,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,mCAAmC,IAAI,CAAC,KAAK,EAAE;YACzE,EAAE;YACF,oEAAoE;YACpE,sEAAsE;YACtE,2DAA2D;YAC3D,EAAE;YACF,uEAAuE;YACvE,wEAAwE;YACxE,qEAAqE;YACrE,EAAE;YACF,uEAAuE;YACvE,uEAAuE;YACvE,4BAA4B;SAC7B;QACD,cAAc,EACZ,sEAAsE;YACtE,oEAAoE;YACpE,2CAA2C;QAC7C,aAAa,EACX,gEAAgE;YAChE,mEAAmE;YACnE,0DAA0D;QAC5D,OAAO,EAAE;YACP,MAAM,EAAE,wBAAwB;YAChC,OAAO,EAAE,6BAA6B;YACtC,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,MAAM;SACb;QACD,MAAM,EAAE,oFAAoF;QAC5F,eAAe,EAAE,sDAAsD;KACxE;IACD,EAAE,EAAE;QACF,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE;YACL,sEAAsE;YACtE,mEAAmE;YACnE,qDAAqD;SACtD;QACD,YAAY,EAAE;YACZ,sEAAsE;YACtE,kBAAkB;YAClB,yCAAyC;YACzC,iDAAiD;YACjD,6CAA6C;YAC7C,gEAAgE;YAChE,EAAE;YACF,sEAAsE;YACtE,wEAAwE;YACxE,cAAc;YACd,EAAE;YACF,wEAAwE;YACxE,qEAAqE;YACrE,eAAe;SAChB;QACD,OAAO,EAAE;YACP,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,8BAA8B,IAAI,CAAC,KAAK,EAAE;YACpE,EAAE;YACF,uEAAuE;YACvE,kEAAkE;YAClE,qEAAqE;YACrE,wCAAwC;YACxC,EAAE;YACF,iEAAiE;YACjE,4DAA4D;YAC5D,qEAAqE;YACrE,oCAAoC;YACpC,EAAE;YACF,oEAAoE;YACpE,uEAAuE;YACvE,4BAA4B;SAC7B;QACD,cAAc,EACZ,wEAAwE;YACxE,yEAAyE;YACzE,uDAAuD;QACzD,aAAa,EACX,qEAAqE;YACrE,yEAAyE;YACzE,2EAA2E;QAC7E,OAAO,EAAE;YACP,MAAM,EAAE,sBAAsB;YAC9B,OAAO,EAAE,+BAA+B;YACxC,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,OAAO;SACd;QACD,MAAM,EACJ,sGAAsG;QACxG,eAAe,EAAE,6DAA6D;KAC/E;CACF,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,CAAO,EAAE,WAAoB;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY;QAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,cAAc,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,MAAM,UAAU,GAAG,KAAK,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IACzE,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAC9F,MAAM,QAAQ,GAAG,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACpE,MAAM,QAAQ,GAAG,KAAK,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAEnE,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,QAAQ,QAAQ,QAAQ,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,QAAQ,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,SAAS,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAuB,EAAE;IACxD,IAAI,IAAI,GAAa,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC;IAC9C,UAAU,EAAE,CAAC;IACb,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC7B,WAAW,EAAE,CAAC;YACd,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;YACjD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;YAEvF,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;YAEzC,IAAI,GAAG,KAAK,GAAG;gBAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YACjF,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBAChC,UAAU,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YACjE,CAAC;YACD,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;gBAChB,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;gBACnC,SAAS;YACX,CAAC;YACD,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACrD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YAC9D,CAAC;YACD,oBAAoB;QACtB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,UAAU,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}