elffuss-code / js /ext /snippets.js
KikoCis's picture
Sync with code.elffuss.com (fc5b0ba): LFM3 on our own engine, installable app, VS Code extensions, new look; README refreshed
4bd8362 verified
Raw History Blame Contribute Delete
3.61 kB
// Snippets de VS Code → sugerencias de Monaco que se insertan como snippet
// (mismo formato: $1, ${2:valor}, ${3|a,b|}, $TM_FILENAME…).
// Fichero de snippets (JSON con comentarios ya parseado) → lista plana. Admite
// un nivel de anidado (grupos), prefijos en lista y cuerpos en lista de líneas.
export function normalizeSnippets(json) {
const out = [];
const uno = (nombre, s) => {
if (!s || typeof s !== 'object' || s.body == null) return false;
const prefijos = (Array.isArray(s.prefix) ? s.prefix : [s.prefix]).filter(p => typeof p === 'string' && p.trim());
const body = Array.isArray(s.body) ? s.body.map(String).join('\n') : String(s.body);
const description = Array.isArray(s.description) ? s.description.join('\n') : (typeof s.description === 'string' ? s.description : '');
for (const prefix of prefijos) out.push({ name: String(nombre), prefix: prefix.trim(), body, description });
return true;
};
if (!json || typeof json !== 'object') return out;
for (const [nombre, s] of Object.entries(json)) {
if (uno(nombre, s)) continue;
if (s && typeof s === 'object') for (const [n2, s2] of Object.entries(s)) uno(n2, s2);
}
return out.slice(0, 5000);
}
const esPalabra = ch => /[\w$]/.test(ch || '');
// Columna donde empieza lo que el usuario ya escribió del prefijo. Si lo
// escrito es el principio literal del prefijo («#reg» de «#region»), se
// reemplaza eso; si no, la palabra bajo el cursor, que Monaco filtra en difuso.
export function replaceStart(lineaAntes, prefix, wordStart) {
const lo = lineaAntes.toLowerCase(), pre = prefix.toLowerCase();
for (let p = Math.max(0, lo.length - pre.length); p < lo.length; p++) {
if (!pre.startsWith(lo.slice(p))) continue;
if (p > 0 && esPalabra(lo[p - 1]) && esPalabra(lo[p])) continue; // a media palabra, no
return p + 1;
}
return wordStart;
}
// Cabecera de la sugerencia: «descripción (Extensión)». `detail` y un
// `documentation` string son texto para Monaco, no Markdown.
export const cabecera = (s, ext = '') => (s.description || s.name) + (ext ? ` (${ext})` : '');
// Un proveedor por lenguaje. `cargar()` devuelve (una vez, en diferido) la
// lista de snippets de todas las extensiones activas para ese lenguaje.
export function registerSnippets(monaco, language, cargar, origen = () => '') {
let lista = null;
const K = monaco.languages.CompletionItemKind.Snippet;
const R = monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet;
return monaco.languages.registerCompletionItemProvider(language, {
async provideCompletionItems(model, position) {
lista ??= await cargar().catch(() => []);
if (!lista.length) return { suggestions: [] };
const antes = model.getLineContent(position.lineNumber).slice(0, position.column - 1);
const palabra = model.getWordUntilPosition(position);
const suggestions = lista.map(s => ({
label: s.prefix,
kind: K,
// como VS Code: arriba la descripción y de qué extensión viene, y en el
// detalle el cuerpo. Todo texto plano, NUNCA Markdown: Monaco pintaría
// las imágenes y enlaces que escriba la extensión y el navegador las
// pediría a cualquier servidor (IP, hora y origen de quien mira).
detail: cabecera(s, origen(s)),
documentation: s.body,
insertText: s.body,
insertTextRules: R,
range: new monaco.Range(position.lineNumber, replaceStart(antes, s.prefix, palabra.startColumn), position.lineNumber, position.column),
}));
return { suggestions };
},
});
}