// Lo que una extensión con código le pide al usuario, pintado por Code. // // Avisos (toasts), diálogo modal, selector rápido, cuadro de texto, progreso // y escribir en el portapapeles. Todo texto que viene del recinto entra con // textContent: un enlace se queda en texto y un botón solo devuelve cuál se // pulsó. Hay topes: 3 avisos a la vez y 20 por minuto, un diálogo y un // selector (o cuadro) a la vez; lo que se pasa se contesta «nada» al momento // y se cuenta. Escribir en el portapapeles solo con un gesto reciente del // usuario (navigator.userActivation). // // Todo cuelga de #x2-* / .x2-* (web/css/ext2.css): nada del CSS de VS Code // entra en la página. import { tx } from '../ext/i18n.js'; import './strings.js'; const MAX_TOASTS = 3; const TOASTS_PER_MINUTE = 20; const TOAST_AUTOCLOSE = 9000; const el = (tag, cls, txt) => { const e = document.createElement(tag); if (cls) e.className = cls; if (txt != null) e.textContent = txt; return e; }; const button = (txt, cls = 'x2-btn') => { const b = el('button', cls, txt); b.type = 'button'; return b; }; let nId = 0; const uid = p => `${p}-${++nId}`; export const userActive = () => { try { return !!globalThis.navigator?.userActivation?.isActive; } catch { return false; } }; // Code cierra el panel de ajustes/extensiones con cualquier clic fuera de él // (main.js, en captura sobre document). Un clic DENTRO de estos diálogos y // avisos no es «fuera»: se para aquí, en captura sobre window, que va antes. let guarda = false; function guardaPanel() { if (guarda) return; guarda = true; window.addEventListener('pointerdown', e => { if (e.target instanceof Element && e.target.closest('.x2-backdrop, .x2-pick, #x2-toasts')) e.stopPropagation(); }, true); } export function loadCss() { guardaPanel(); if (document.getElementById('x2-css')) return; const l = document.createElement('link'); l.id = 'x2-css'; l.rel = 'stylesheet'; l.href = new URL('../../css/ext2.css', import.meta.url).href; document.head.appendChild(l); } // Modal genérico: título, cuerpo, una caja opcional en monoespaciado (una // dirección, una orden; con su propio scroll si es larga), lo que vaya tras // ella (`after`) y botones. Escape y fuera = el botón por defecto (el de // cancelar). Abre por arriba: el foco no lo desplaza. Devuelve el `value` del // botón pulsado. const abiertos = new Set(); // cierres de los modales abiertos export function closeModals() { for (const c of [...abiertos]) c(); } export function modal({ id = 'x2-dialog', title, body = [], code = null, after = [], buttons, cancelValue = null, focus = 0, labelledBy = null }) { return new Promise(resolve => { loadCss(); document.getElementById(id)?.remove(); const previo = document.activeElement; const fondo = el('div', 'x2-backdrop'); fondo.id = id; const caja = el('div', 'x2-modal'); caja.setAttribute('role', 'dialog'); caja.setAttribute('aria-modal', 'true'); const h = el('h2', 'x2-modal-title', title); h.id = uid('x2-title'); caja.setAttribute('aria-labelledby', labelledBy || h.id); caja.appendChild(h); const desc = []; for (const p of [].concat(body).filter(x => x != null && x !== '')) { const n = typeof p === 'string' ? el('p', 'x2-modal-text', p) : p; if (!n.id) n.id = uid('x2-desc'); desc.push(n.id); caja.appendChild(n); } if (code != null) { const c = typeof code === 'string' ? el('div', 'x2-code', code) : code; if (!c.id) c.id = uid('x2-desc'); desc.push(c.id); // con teclado también se puede recorrer (y leer) entera c.tabIndex = 0; caja.appendChild(c); } for (const n of [].concat(after).filter(Boolean)) caja.appendChild(n); if (desc.length) caja.setAttribute('aria-describedby', desc.join(' ')); const fila = el('div', 'x2-modal-buttons'); const botones = buttons.map(b => { const x = button(b.label, 'x2-btn' + (b.primary ? ' x2-primary' : '')); if (b.className) x.classList.add(b.className); if (b.disabled) { x.setAttribute('aria-disabled', 'true'); x.title = b.disabled; } x.onclick = async () => { if (x.getAttribute('aria-disabled') === 'true') return; if (typeof b.onClick === 'function') { const keep = await b.onClick(x); if (keep) return; } cerrar(b.value); }; fila.appendChild(x); return x; }); caja.appendChild(fila); fondo.appendChild(caja); let hecho = false; function cerrar(v) { if (hecho) return; hecho = true; abiertos.delete(cancelar); fondo.remove(); document.removeEventListener('keydown', teclas, true); if (previo && previo.isConnected && typeof previo.focus === 'function') previo.focus(); resolve(v); } const cancelar = () => cerrar(cancelValue); abiertos.add(cancelar); // el foco no sale del diálogo (Tab da la vuelta) y Escape cancela function teclas(e) { if (!fondo.isConnected) return; if (e.key === 'Escape') { e.preventDefault(); e.stopPropagation(); cerrar(cancelValue); return; } if (e.key === 'Tab') { const fs = [...caja.querySelectorAll('button, input, textarea, [tabindex="0"]')].filter(x => !x.disabled); if (!fs.length) return; const i = fs.indexOf(document.activeElement); const j = e.shiftKey ? (i <= 0 ? fs.length - 1 : i - 1) : (i === fs.length - 1 ? 0 : i + 1); e.preventDefault(); fs[j].focus(); } } document.addEventListener('keydown', teclas, true); fondo.addEventListener('mousedown', e => { if (e.target === fondo) cerrar(cancelValue); }); document.body.appendChild(fondo); (botones[focus] || botones[0])?.focus({ preventScroll: true }); caja.scrollTop = 0; }); } // Atrapa Tab dentro de `caja` (da la vuelta) y cierra con Escape desde // cualquier sitio de ella, no solo desde su campo de texto. function atrapa(caja, cerrar) { caja.addEventListener('keydown', e => { if (e.key === 'Escape') { e.preventDefault(); e.stopPropagation(); cerrar(); return; } if (e.key !== 'Tab') return; const fs = [...caja.querySelectorAll('button, input, textarea, [tabindex="0"]')].filter(x => !x.disabled && !x.hidden && x.getClientRects().length); if (!fs.length) return; const i = fs.indexOf(document.activeElement); e.preventDefault(); fs[e.shiftKey ? (i <= 0 ? fs.length - 1 : i - 1) : (i === fs.length - 1 ? 0 : i + 1)].focus(); }); } // La tecla que lleva a los avisos (y vuelve de ellos): desde el editor, el // chat o el panel, como F6 en VS Code. Solo se usa mientras hay alguno. export const TOAST_KEY = 'F6'; export class ExtUI { constructor({ nameOf = id => id, log = () => {}, statusbar = () => document.getElementById('statusbar') } = {}) { this.nameOf = nameOf; this.log = log; this.statusbar = statusbar; this.toasts = []; // { el, resolve } this.sent = []; // instantes de los últimos avisos (para el tope por minuto) this.dialogBusy = false; this.pickBusy = null; // { req, close } this.progress = new Map(); // id → texto this.dropped = { notify: 0, dialog: 0, pick: 0, clipboard: 0 }; this.closers = new Set(); this.volver = null; // dónde estaba el foco antes de ir a un aviso this.tecla = null; // el oyente de F6 this.entrada = null; // la entrada de la paleta de Code } origin(source) { const n = source ? this.nameOf(source) : null; return n ? tx('x2From', { name: n }) : tx('x2FromAny'); } // ── llegar a los avisos con el teclado: F6 y la paleta de Code ── focusToast() { const t = this.toasts.at(-1)?.el; if (!t) return false; if (!t.contains(document.activeElement)) this.volver = document.activeElement; t.querySelector('.x2-toast-buttons button')?.focus(); return true; } backFromToast() { const v = this.volver; this.volver = null; if (v && v.isConnected && v !== document.body && v.getClientRects().length && typeof v.focus === 'function') { v.focus(); return; } const ed = globalThis.monaco?.editor?.getEditors?.().find(e => document.getElementById('editor')?.contains(e.getContainerDomNode())); if (ed) ed.focus(); else document.getElementById('prompt')?.focus(); } keyboard(on) { if (on && !this.tecla) { this.tecla = e => { // (con un diálogo abierto, su foco no se suelta: primero se contesta él) if (e.key !== TOAST_KEY || e.altKey || e.ctrlKey || e.metaKey || !this.toasts.length || document.querySelector('.x2-backdrop')) return; e.preventDefault(); e.stopPropagation(); if (document.getElementById('x2-toasts')?.contains(document.activeElement)) this.backFromToast(); else this.focusToast(); }; document.addEventListener('keydown', this.tecla, true); } else if (!on && this.tecla) { document.removeEventListener('keydown', this.tecla, true); this.tecla = null; } // en la paleta de Code (window.elffussClaw.commands), mientras haya avisos const lista = globalThis.window?.elffussClaw?.commands; if (on && !this.entrada && Array.isArray(lista)) { this.entrada = { label: tx('x2FocusToast'), hint: TOAST_KEY, x2: 'ui', run: () => { const p = document.getElementById('palette'); if (p) p.hidden = true; this.focusToast(); } }; lista.push(this.entrada); } else if (!on && this.entrada) { const i = Array.isArray(lista) ? lista.indexOf(this.entrada) : -1; if (i >= 0) lista.splice(i, 1); this.entrada = null; } } // ── avisos ── notify({ sev = 'info', text, actions = [], source }) { const now = Date.now(); this.sent = this.sent.filter(t => now - t < 60000); if (this.toasts.length >= MAX_TOASTS || this.sent.length >= TOASTS_PER_MINUTE) { this.dropped.notify++; this.log('warn', `a notification was not shown (more than ${MAX_TOASTS} on screen or ${TOASTS_PER_MINUTE} a minute): ${String(text).slice(0, 120)}`, source); return Promise.resolve(null); } this.sent.push(now); loadCss(); let box = document.getElementById('x2-toasts'); if (!box) { box = el('div'); box.id = 'x2-toasts'; box.setAttribute('aria-live', 'polite'); document.body.appendChild(box); } return new Promise(resolve => { const t = el('div', 'x2-toast x2-' + (['info', 'warning', 'error'].includes(sev) ? sev : 'info')); t.setAttribute('role', sev === 'error' ? 'alert' : 'status'); t.appendChild(el('div', 'x2-toast-from', this.origin(source))); t.appendChild(el('div', 'x2-toast-text', String(text))); // (para el lector de pantalla: cómo llegar a sus botones desde el editor) if (actions.length) t.appendChild(el('span', 'x2-sr', tx('x2ToastHint', { key: TOAST_KEY }))); const fila = el('div', 'x2-toast-buttons'); let hecho = false, reloj = null, encima = false, antes = null; const entry = { el: t, resolve: null }; // sin botones se va solo, pero no mientras el ratón o el foco estén en él const arma = () => { clearTimeout(reloj); if (!actions.length && !encima && !t.contains(document.activeElement)) reloj = setTimeout(() => fin(null), TOAST_AUTOCLOSE); }; const fin = v => { if (hecho) return; hecho = true; clearTimeout(reloj); const conFoco = t.contains(document.activeElement); t.remove(); this.toasts = this.toasts.filter(x => x !== entry); this.closers.delete(entry.resolve); // el foco vuelve a donde estaba (nunca se queda en ) if (conFoco) { if (antes && antes.isConnected && antes.getClientRects().length) { this.volver = null; antes.focus(); } else this.backFromToast(); } if (!this.toasts.length) this.keyboard(false); resolve(v); }; entry.resolve = () => fin(null); this.closers.add(entry.resolve); actions.forEach((a, i) => { const b = button(a, 'x2-btn' + (i === 0 ? ' x2-primary' : '')); b.onclick = () => fin(i); fila.appendChild(b); }); const x = button('×', 'x2-toast-close'); x.setAttribute('aria-label', tx('x2Dismiss')); x.onclick = () => fin(null); fila.appendChild(x); t.appendChild(fila); t.addEventListener('mouseenter', () => { encima = true; clearTimeout(reloj); }); t.addEventListener('mouseleave', () => { encima = false; arma(); }); t.addEventListener('focusin', e => { clearTimeout(reloj); if (!t.contains(e.relatedTarget)) antes = this.volver || e.relatedTarget || antes; }); t.addEventListener('focusout', e => { if (!t.contains(e.relatedTarget)) setTimeout(arma, 0); }); t.addEventListener('keydown', e => { if (e.key === 'Escape') { e.preventDefault(); e.stopPropagation(); fin(null); } }); box.appendChild(t); this.toasts.push(entry); this.keyboard(true); arma(); }); } // ── diálogo modal (showXMessage con {modal: true}) ── async dialog({ sev = 'info', text, detail, buttons = [], cancel, source }) { if (this.dialogBusy) { this.dropped.dialog++; this.log('warn', 'a second dialog was refused while one is open', source); return null; } this.dialogBusy = true; try { const v = await modal({ title: this.origin(source), body: [el('p', 'x2-modal-text x2-' + sev, String(text)), detail ? el('p', 'x2-modal-detail', String(detail)) : null].filter(Boolean), buttons: [...buttons.map((label, i) => ({ label, value: i, primary: i === 0 })), { label: cancel || tx('x2Cancel'), value: null }], cancelValue: null, focus: buttons.length, // el foco empieza en cancelar }); return v; } finally { this.dialogBusy = false; } } // ── selector rápido (showQuickPick) ── pick({ req, items, options = {}, source }) { if (this.pickBusy) { this.dropped.pick++; this.log('warn', 'a second quick pick was refused while one is open', source); return Promise.resolve(null); } loadCss(); return new Promise(resolve => { const previo = document.activeElement; const many = options.canPickMany === true; const caja = el('div', 'x2-pick'); caja.id = 'x2-pick'; caja.setAttribute('role', 'dialog'); caja.setAttribute('aria-modal', 'true'); const titulo = el('div', 'x2-pick-title', options.title || this.origin(source)); titulo.id = uid('x2-pick-t'); caja.setAttribute('aria-labelledby', titulo.id); const inp = el('input', 'x2-pick-input'); inp.type = 'text'; inp.autocomplete = 'off'; inp.spellcheck = false; inp.placeholder = options.placeHolder || (many ? tx('x2PickMany') : tx('x2PickOne')); inp.setAttribute('role', 'combobox'); inp.setAttribute('aria-expanded', 'true'); inp.setAttribute('aria-autocomplete', 'list'); const lista = el('div', 'x2-pick-list'); lista.id = uid('x2-pick-l'); lista.setAttribute('role', 'listbox'); if (many) lista.setAttribute('aria-multiselectable', 'true'); inp.setAttribute('aria-controls', lista.id); inp.setAttribute('aria-label', options.title || options.placeHolder || tx('x2PickOne')); const pie = el('div', 'x2-pick-foot'); const ok = button(tx('x2Ok'), 'x2-btn x2-primary'); const no = button(tx('x2Cancel')); pie.append(no, ok); if (!many) ok.hidden = true; caja.append(titulo, inp, lista, pie); document.body.appendChild(caja); const marcados = new Set(items.map((it, i) => (it && !it.sep && it.picked ? i : -1)).filter(i => i >= 0)); let visibles = [], sel = 0, hecho = false; const fin = v => { if (hecho) return; hecho = true; caja.remove(); document.removeEventListener('mousedown', fuera, true); this.pickBusy = null; this.closers.delete(cerrarYa); if (previo && previo.isConnected && typeof previo.focus === 'function') previo.focus(); resolve(v); }; const cerrarYa = () => fin(null); this.closers.add(cerrarYa); this.pickBusy = { req, close: cerrarYa }; const fuera = e => { if (!caja.contains(e.target)) fin(null); }; setTimeout(() => document.addEventListener('mousedown', fuera, true), 0); const coincide = (it, q) => !q || [it.label, options.matchOnDescription ? it.description : '', options.matchOnDetail ? it.detail : ''] .some(s => typeof s === 'string' && s.toLowerCase().includes(q)); const pinta = () => { const q = inp.value.trim().toLowerCase(); lista.replaceChildren(); visibles = []; let grupo = null; items.forEach((it, i) => { if (!it) return; if (it.sep !== undefined) { grupo = it.sep; return; } if (!coincide(it, q)) return; if (grupo !== null) { const g = el('div', 'x2-pick-sep', grupo); g.setAttribute('role', 'presentation'); lista.appendChild(g); grupo = null; } const n = visibles.length; const row = el('div', 'x2-pick-item'); row.id = `${lista.id}-${n}`; row.setAttribute('role', 'option'); row.dataset.i = String(i); if (many) { const c = el('span', 'x2-check', marcados.has(i) ? '☑' : '☐'); c.setAttribute('aria-hidden', 'true'); row.appendChild(c); } const t = el('span', 'x2-pick-label', it.label); row.appendChild(t); if (it.description) row.appendChild(el('span', 'x2-pick-desc', it.description)); if (it.detail) row.appendChild(el('div', 'x2-pick-detail', it.detail)); row.onclick = () => { sel = n; if (many) { alterna(i); } else fin(i); }; lista.appendChild(row); visibles.push(i); }); if (!visibles.length) lista.appendChild(el('div', 'x2-pick-empty', tx('x2PickNone'))); sel = Math.min(sel, Math.max(0, visibles.length - 1)); marca(); }; const marca = () => { const filas = [...lista.querySelectorAll('.x2-pick-item')]; filas.forEach((r, n) => { const i = Number(r.dataset.i); r.classList.toggle('sel', n === sel); r.setAttribute('aria-selected', String(many ? marcados.has(i) : n === sel)); if (many) r.setAttribute('aria-checked', String(marcados.has(i))); }); if (filas[sel]) { inp.setAttribute('aria-activedescendant', filas[sel].id); filas[sel].scrollIntoView({ block: 'nearest' }); } else inp.removeAttribute('aria-activedescendant'); }; const alterna = i => { if (marcados.has(i)) marcados.delete(i); else marcados.add(i); const fila = lista.querySelector(`.x2-pick-item[data-i="${i}"] .x2-check`); if (fila) fila.textContent = marcados.has(i) ? '☑' : '☐'; marca(); }; ok.onclick = () => fin([...marcados].sort((a, b) => a - b)); no.onclick = () => fin(null); inp.oninput = () => { sel = 0; pinta(); }; // Tab no sale del selector y Escape lo cierra desde cualquier parte atrapa(caja, () => fin(null)); inp.onkeydown = e => { if (e.key === 'ArrowDown' || e.key === 'ArrowUp') { e.preventDefault(); if (!visibles.length) return; sel = (sel + (e.key === 'ArrowDown' ? 1 : -1) + visibles.length) % visibles.length; marca(); // con varias a elegir, Espacio marca la resaltada aunque haya filtro // (el filtro se escribe sin espacios; lo dice el texto de ayuda) } else if (e.key === ' ' && many) { e.preventDefault(); if (visibles.length) alterna(visibles[sel]); } else if (e.key === 'Enter') { e.preventDefault(); if (many) fin([...marcados].sort((a, b) => a - b)); else if (visibles.length) fin(visibles[sel]); } }; pinta(); inp.focus(); }); } // ── cuadro de texto (showInputBox) ── input({ req, options = {}, source }) { if (this.pickBusy) { this.dropped.pick++; this.log('warn', 'an input box was refused while another one is open', source); return Promise.resolve(null); } loadCss(); return new Promise(resolve => { const previo = document.activeElement; const caja = el('div', 'x2-pick x2-inputbox'); caja.id = 'x2-input'; caja.setAttribute('role', 'dialog'); caja.setAttribute('aria-modal', 'true'); const titulo = el('div', 'x2-pick-title', options.title || this.origin(source)); titulo.id = uid('x2-input-t'); caja.setAttribute('aria-labelledby', titulo.id); const inp = el('input', 'x2-pick-input'); inp.type = options.password ? 'password' : 'text'; inp.autocomplete = 'off'; inp.spellcheck = false; inp.placeholder = options.placeHolder || ''; inp.value = typeof options.value === 'string' ? options.value : ''; const ayuda = el('div', 'x2-input-prompt', options.prompt || tx('x2InputHint')); ayuda.id = uid('x2-input-p'); const error = el('div', 'x2-input-error', options.validation || ''); error.id = uid('x2-input-e'); error.setAttribute('role', 'alert'); error.hidden = !options.validation; inp.setAttribute('aria-describedby', ayuda.id + ' ' + error.id); inp.setAttribute('aria-label', options.title || options.prompt || tx('x2InputHint')); if (options.validation) inp.setAttribute('aria-invalid', 'true'); const pie = el('div', 'x2-pick-foot'); const ok = button(tx('x2Ok'), 'x2-btn x2-primary'); const no = button(tx('x2Cancel')); pie.append(no, ok); caja.append(titulo, inp, ayuda, error, pie); document.body.appendChild(caja); let hecho = false; const fin = v => { if (hecho) return; hecho = true; caja.remove(); document.removeEventListener('mousedown', fuera, true); this.pickBusy = null; this.closers.delete(cerrarYa); if (previo && previo.isConnected && typeof previo.focus === 'function') previo.focus(); resolve(v); }; const cerrarYa = () => fin(null); this.closers.add(cerrarYa); this.pickBusy = { req, close: cerrarYa }; const fuera = e => { if (!caja.contains(e.target)) fin(null); }; setTimeout(() => document.addEventListener('mousedown', fuera, true), 0); ok.onclick = () => fin(inp.value); no.onclick = () => fin(null); atrapa(caja, () => fin(null)); inp.onkeydown = e => { if (e.key === 'Enter') { e.preventDefault(); fin(inp.value); } }; inp.focus(); inp.select(); }); } // la extensión canceló su selector o su cuadro (token) cancel(req) { if (this.pickBusy && this.pickBusy.req === req) this.pickBusy.close(); } // ── progreso, en la barra de estado ── setProgress({ id, text, done }) { if (done) this.progress.delete(id); else this.progress.set(id, text); const bar = this.statusbar(); if (!bar) return; let p = document.getElementById('x2-progress'); if (!this.progress.size) { p?.remove(); return; } if (!p) { loadCss(); p = el('span', 'x2-progress'); p.id = 'x2-progress'; p.setAttribute('role', 'status'); bar.appendChild(p); } else if (p.parentNode !== bar) bar.appendChild(p); const textos = [...this.progress.values()].filter(Boolean); p.textContent = '⟳ ' + (textos[textos.length - 1] || tx('x2Working')) + (this.progress.size > 1 ? ` (+${this.progress.size - 1})` : ''); } // ── portapapeles: solo con un gesto reciente del usuario ── async clipboard(text, source) { if (typeof text !== 'string') return false; if (!userActive()) { this.dropped.clipboard++; this.log('warn', 'a clipboard write without a recent click or key press was dropped', source); return false; } try { await navigator.clipboard.writeText(text.slice(0, 500000)); return true; } catch { this.log('warn', 'the browser refused the clipboard write', source); return false; } } dispose() { for (const c of [...this.closers]) { try { c(); } catch { /* — */ } } this.closers.clear(); for (const t of [...this.toasts]) { try { t.resolve(); } catch { /* — */ } } this.keyboard(false); document.getElementById('x2-toasts')?.remove(); closeModals(); this.progress.clear(); document.getElementById('x2-progress')?.remove(); } }