docviz-builder 0.1.0

package/dist/build/init.js

@@ -0,0 +1,274 @@
+/**
+ * Preparacion de un proyecto para usar DocViz.
+ *
+ * Adoptarlo a mano son cuatro archivos y cinco scripts, y el que se olvida
+ * siempre es `AGENTS.md`, justo el que hace que un agente escriba bien los
+ * bloques. Este comando deja el proyecto listo y no sobrescribe nada que ya
+ * exista: informa y sigue.
+ */
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+/** Scripts que forman el flujo de trabajo documentado. */
+export const SCRIPTS = [
+    ['docs:check', 'docviz check docs-src'],
+    ['docs:build', 'docviz build docs-src --output docs'],
+    ['docs:verify', 'docviz verify docs'],
+    ['docs:preview', 'docviz preview docs'],
+    ['docs:doctor', 'docviz doctor'],
+];
+function configYaml(theme) {
+    return `# Configuracion de DocViz Builder.
+#
+# Todos los valores son opcionales: sin este archivo el build ya funciona en
+# modo local, sin conexion y con el tema "default".
+
+source: docs-src
+
+output:
+  dir: docs
+  assetsDir: assets/generated
+
+theme:
+  name: ${theme}
+
+cache:
+  enabled: true
+  dir: .docviz-cache
+
+renderers:
+  # "local" no envia nada a la red. "kroki" requiere una instancia propia.
+  backend: local
+  timeoutMs: 60000
+
+  # Mermaid y BPMN dibujan dentro de un Chromium local y el sandbox esta activo.
+  # Se desactiva solo como root, donde Chromium no arranca de otra forma.
+  # noSandbox: false
+
+  # Ejecuta \`docviz doctor\` para ver que motores puede usar esta maquina y que
+  # tipos quedarian afectados si falta alguno.
+`;
+}
+function agentsMd() {
+    return `# Instrucciones para agentes — Documentación visual
+
+Este proyecto usa **DocViz Builder** para generar diagramas dentro de Markdown.
+
+## Regla principal
+
+Modifica exclusivamente los documentos de \`docs-src/\`.
+
+No edites nunca a mano \`docs/\` ni \`docs/assets/generated/\`: son directorios
+generados y cualquier cambio se pierde en la siguiente compilación.
+
+## Describe la intención, no la tecnología
+
+DocViz elige el motor. Tú declaras qué quieres explicar con una de estas vallas:
+
+| Valla | Cuándo |
+|---|---|
+| \`diagram\` | Interacción, flujo, estados, dependencias, análisis estratégico |
+| \`chart\` | Comparación cuantitativa, tendencia, distribución |
+| \`architecture\` | Modelo C4 |
+
+Para saber qué tipo usar:
+
+\`\`\`bash
+npx docviz suggest "el proceso de aprobación de una solicitud"
+npx docviz types              # catálogo completo con propósito y ejemplo
+npx docviz types sequence     # ficha de un tipo concreto
+\`\`\`
+
+Si tu cliente tiene el servidor MCP de DocViz configurado, usa \`docviz_suggest\`
+y \`docviz_types\` en lugar de los comandos.
+
+## Ejemplo
+
+\`\`\`\`md
+\`\`\`diagram
+type: sequence
+title: Autenticación de usuario
+
+participants:
+  - Usuario
+  - API
+
+flow:
+  - Usuario -> API: Login
+  - API --> Usuario: Token
+\`\`\`
+\`\`\`\`
+
+\`->\` es un mensaje; \`-->\` una respuesta.
+
+## Flujo obligatorio
+
+Después de crear o modificar documentación:
+
+\`\`\`bash
+npm run docs:check     # valida los bloques sin dibujar
+npm run docs:build     # docs-src/ -> docs/
+npm run docs:verify    # comprueba que no haya imágenes rotas
+npm run docs:preview   # revisión visual
+\`\`\`
+
+No reportes la tarea como terminada mientras existan errores de renderizado o
+imágenes rotas.
+
+Cada error trae un **código** además de archivo y línea: \`DV101\` falta un campo
+obligatorio, \`DV104\` escribiste un campo que ese tipo no usa, \`DV105\` el bloque
+no es YAML válido, \`DV106\` el tipo no existe o va en otra valla. Un documento
+con varios bloques rotos los reporta todos a la vez: arréglalos en una pasada.
+
+Un \`AVISO ... [DV104]\` no rompe el build, pero significa que un campo que
+escribiste no llegó al dibujo. O sobra, o está mal escrito; en ningún caso se
+ignora.
+
+Antes de dar por bueno un cambio grande, comprueba qué diagramas tocaste:
+
+\`\`\`bash
+npx docviz diff <docs-src de la versión anterior> docs-src
+\`\`\`
+
+## Reglas
+
+- No generes SVG o PNG a mano cuando DocViz pueda generarlos.
+- No modifiques hashes ni nombres de imagen.
+- No introduzcas rutas absolutas.
+- No sustituyas diagramas declarativos por capturas de pantalla.
+- No fijes colores a mano: el tema trae su equivalente en modo oscuro, y un
+  color escrito a mano pierde esa propiedad.
+
+## Cuándo NO dibujar
+
+Antes de crear una visualización, comprueba que aporta algo. Para información
+sencilla, una tabla Markdown o un párrafo comunican mejor. Un diagrama con veinte
+cajas no explica nada: divídelo en varios con objetivos distintos.
+`;
+}
+function documentoDeEjemplo() {
+    return `---
+title: Arquitectura
+---
+
+# Arquitectura
+
+Sustituye este documento por el tuyo. Sirve para comprobar que la compilación
+funciona de extremo a extremo.
+
+## Flujo de autenticación
+
+\`\`\`diagram
+type: sequence
+title: Flujo de autenticación
+
+participants:
+  - Usuario
+  - Frontend
+  - API
+
+flow:
+  - Usuario -> Frontend: Login
+  - Frontend -> API: POST /login
+  - API --> Frontend: Token
+\`\`\`
+
+## Contexto del sistema
+
+\`\`\`architecture
+type: c4-context
+title: Contexto
+
+elements:
+  - id: usuario
+    kind: person
+    name: Usuario
+  - id: sistema
+    kind: system
+    name: Sistema
+    description: Sustituye esto por tu sistema
+
+relations:
+  - from: usuario
+    to: sistema
+    label: Utiliza
+\`\`\`
+`;
+}
+const GITIGNORE = `
+# DocViz: cache de recursos generados, se reconstruye solo.
+.docviz-cache/
+`;
+export async function init(options) {
+    const { cwd, theme, force } = options;
+    const result = { creados: [], omitidos: [], scriptsPendientes: [] };
+    const escribir = async (relativo, contenido) => {
+        const destino = path.join(cwd, relativo);
+        if (existsSync(destino) && !force) {
+            result.omitidos.push(relativo);
+            return;
+        }
+        await mkdir(path.dirname(destino), { recursive: true });
+        await writeFile(destino, contenido, 'utf8');
+        result.creados.push(relativo);
+    };
+    await escribir('docviz.config.yaml', configYaml(theme));
+    await escribir('AGENTS.md', agentsMd());
+    await escribir(path.join('docs-src', 'arquitectura.md'), documentoDeEjemplo());
+    // El `.gitignore` se completa en lugar de sustituirse: casi siempre ya existe
+    // y tiene contenido que no es nuestro.
+    const gitignore = path.join(cwd, '.gitignore');
+    if (existsSync(gitignore)) {
+        const actual = await readFile(gitignore, 'utf8');
+        if (!actual.includes('.docviz-cache')) {
+            await writeFile(gitignore, `${actual.replace(/\s*$/, '')}\n${GITIGNORE}`, 'utf8');
+            result.creados.push('.gitignore (ampliado)');
+        }
+        else {
+            result.omitidos.push('.gitignore');
+        }
+    }
+    else {
+        await escribir('.gitignore', GITIGNORE.trimStart());
+    }
+    // Los scripts no se escriben solos: modificar el package.json de otro
+    // proyecto es intrusivo. Se informa de cuales faltan.
+    const packageJson = path.join(cwd, 'package.json');
+    if (existsSync(packageJson)) {
+        const contenido = JSON.parse(await readFile(packageJson, 'utf8'));
+        const scripts = contenido.scripts ?? {};
+        for (const [nombre, comando] of SCRIPTS) {
+            if (scripts[nombre] === undefined)
+                result.scriptsPendientes.push([nombre, comando]);
+        }
+    }
+    else {
+        result.scriptsPendientes.push(...SCRIPTS.map((s) => [s[0], s[1]]));
+    }
+    return result;
+}
+/** Informe legible de lo que hizo `init`. */
+export function formatearInit(result, theme) {
+    const lineas = [''];
+    if (result.creados.length > 0) {
+        lineas.push('Creados:');
+        for (const archivo of result.creados)
+            lineas.push(`  + ${archivo}`);
+        lineas.push('');
+    }
+    if (result.omitidos.length > 0) {
+        lineas.push('Ya existian, no se tocaron:');
+        for (const archivo of result.omitidos)
+            lineas.push(`  = ${archivo}`);
+        lineas.push('  (usa --force para sobrescribirlos)', '');
+    }
+    if (result.scriptsPendientes.length > 0) {
+        lineas.push('Anade estos scripts a tu package.json:', '');
+        lineas.push('  "scripts": {');
+        lineas.push(result.scriptsPendientes.map(([nombre, comando]) => `    "${nombre}": "${comando}"`).join(',\n'));
+        lineas.push('  }', '');
+    }
+    lineas.push(`Tema: ${theme}`, '', 'Siguientes pasos:', '  npx docviz doctor    comprueba que motores puede usar esta maquina', '  npx docviz build docs-src --output docs', '  npx docviz preview docs', '');
+    return lineas.join('\n');
+}
+//# sourceMappingURL=init.js.map

package/dist/build/init.js.map

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

package/dist/build/preview.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Servidor estatico de previsualizacion.
+ *
+ * Sirve el Markdown ya compilado con un visor minimo para la revision visual
+ * exigida por la seccion 22. Escucha solo en la interfaz local.
+ */
+export interface PreviewServer {
+    url: string;
+    port: number;
+    close(): Promise<void>;
+}
+export declare function startPreview(rootDir: string, port?: number): Promise<PreviewServer>;
+//# sourceMappingURL=preview.d.ts.map

package/dist/build/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/build/preview.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAuBvF"}

package/dist/build/preview.js

@@ -0,0 +1,277 @@
+/**
+ * Servidor estatico de previsualizacion.
+ *
+ * Sirve el Markdown ya compilado con un visor minimo para la revision visual
+ * exigida por la seccion 22. Escucha solo en la interfaz local.
+ */
+import { createReadStream } from 'node:fs';
+import { readFile, readdir, realpath, stat } from 'node:fs/promises';
+import http from 'node:http';
+import path from 'node:path';
+import { collectMarkdown } from './builder.js';
+import { toPosix } from '../core/paths.js';
+const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.md': 'text/markdown; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.css': 'text/css; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+};
+export async function startPreview(rootDir, port = 4321) {
+    const root = path.resolve(rootDir);
+    const server = http.createServer((req, res) => {
+        void handle(root, req, res).catch(() => {
+            res.writeHead(500, { 'content-type': 'text/plain; charset=utf-8' });
+            res.end('error interno del servidor de previsualizacion');
+        });
+    });
+    const actualPort = await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(port, '127.0.0.1', () => {
+            const address = server.address();
+            resolve(typeof address === 'object' && address !== null ? address.port : port);
+        });
+    });
+    return {
+        url: `http://127.0.0.1:${actualPort}/`,
+        port: actualPort,
+        close: () => new Promise((resolve) => server.close(() => resolve())),
+    };
+}
+/** `true` si la ruta no esta contenida en la raiz. */
+function fuera(root, target) {
+    const rel = path.relative(root, target);
+    return rel.startsWith('..') || path.isAbsolute(rel);
+}
+async function handle(root, req, res) {
+    const url = new URL(req.url ?? '/', 'http://127.0.0.1');
+    const decoded = decodeURIComponent(url.pathname);
+    if (decoded === '/') {
+        const html = await indexPage(root);
+        res.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
+        res.end(html);
+        return;
+    }
+    // Contencion: nada fuera de `root` puede servirse.
+    const target = path.resolve(root, `.${decoded}`);
+    if (fuera(root, target)) {
+        res.writeHead(403, { 'content-type': 'text/plain; charset=utf-8' });
+        res.end('acceso denegado');
+        return;
+    }
+    // Y otra vez sobre la ruta real: comparar cadenas no sigue los enlaces
+    // simbolicos, asi que un enlace dentro de la salida apuntando a /etc pasaria
+    // la comprobacion de arriba y se serviria igual.
+    let real;
+    try {
+        real = await realpath(target);
+    }
+    catch {
+        res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' });
+        res.end('no encontrado');
+        return;
+    }
+    if (fuera(await realpath(root), real)) {
+        res.writeHead(403, { 'content-type': 'text/plain; charset=utf-8' });
+        res.end('acceso denegado');
+        return;
+    }
+    let info;
+    try {
+        info = await stat(target);
+    }
+    catch {
+        res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' });
+        res.end('no encontrado');
+        return;
+    }
+    if (info.isDirectory()) {
+        res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' });
+        res.end('no encontrado');
+        return;
+    }
+    const ext = path.extname(target).toLowerCase();
+    if (ext === '.md' && url.searchParams.get('raw') !== '1') {
+        const text = await readFile(target, 'utf8');
+        res.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
+        res.end(documentPage(path.relative(root, target), text));
+        return;
+    }
+    res.writeHead(200, {
+        'content-type': MIME[ext] ?? 'application/octet-stream',
+        'content-length': info.size,
+    });
+    createReadStream(target).pipe(res);
+}
+async function indexPage(root) {
+    const files = await collectMarkdown(root);
+    const items = files
+        .map((f) => toPosix(path.relative(root, f)))
+        .map((f) => `<li><a href="/${f}">${escapeHtml(f)}</a></li>`)
+        .join('\n');
+    const assets = await countAssets(root);
+    return page('DocViz — previsualizacion', `<h1>Documentos compilados</h1>
+     <p class="meta">${files.length} documento(s) &middot; ${assets} recurso(s) generado(s) &middot; raiz <code>${escapeHtml(root)}</code></p>
+     <ul class="docs">${items}</ul>`);
+}
+async function countAssets(root) {
+    const dir = path.join(root, 'assets', 'generated');
+    try {
+        return (await readdir(dir)).length;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Render minimo de Markdown suficiente para revisar imagenes, titulos y
+ * tablas. No pretende ser un visor completo: su unico objetivo es que la
+ * validacion visual se pueda hacer sin instalar nada mas.
+ */
+function documentPage(relative, markdown) {
+    const body = renderMarkdown(markdown);
+    return page(relative, `<p class="meta"><a href="/">&larr; indice</a> &middot; <code>${escapeHtml(relative)}</code> &middot; <a href="?raw=1">ver fuente</a></p>
+     <article>${body}</article>`);
+}
+function renderMarkdown(markdown) {
+    const lines = markdown.split('\n');
+    const out = [];
+    let inCode = false;
+    let inTable = false;
+    let listType;
+    const closeList = () => {
+        if (listType !== undefined) {
+            out.push(`</${listType}>`);
+            listType = undefined;
+        }
+    };
+    const closeTable = () => {
+        if (inTable) {
+            out.push('</tbody></table>');
+            inTable = false;
+        }
+    };
+    for (const line of lines) {
+        if (/^```/.test(line)) {
+            closeList();
+            closeTable();
+            out.push(inCode ? '</code></pre>' : '<pre><code>');
+            inCode = !inCode;
+            continue;
+        }
+        if (inCode) {
+            out.push(escapeHtml(line));
+            continue;
+        }
+        const heading = /^(#{1,6})\s+(.*)$/.exec(line);
+        if (heading !== null) {
+            closeList();
+            closeTable();
+            const level = heading[1].length;
+            out.push(`<h${level}>${inline(heading[2])}</h${level}>`);
+            continue;
+        }
+        if (/^\s*\|.*\|\s*$/.test(line)) {
+            const cells = line.trim().slice(1, -1).split('|').map((c) => c.trim());
+            if (/^[\s|:-]+$/.test(line))
+                continue;
+            if (!inTable) {
+                closeList();
+                out.push('<table><thead><tr>');
+                out.push(cells.map((c) => `<th>${inline(c)}</th>`).join(''));
+                out.push('</tr></thead><tbody>');
+                inTable = true;
+            }
+            else {
+                out.push(`<tr>${cells.map((c) => `<td>${inline(c)}</td>`).join('')}</tr>`);
+            }
+            continue;
+        }
+        closeTable();
+        const bullet = /^\s*[-*+]\s+(.*)$/.exec(line);
+        const numbered = /^\s*\d+[.)]\s+(.*)$/.exec(line);
+        if (bullet !== null || numbered !== null) {
+            const wanted = bullet !== null ? 'ul' : 'ol';
+            if (listType !== wanted) {
+                closeList();
+                out.push(`<${wanted}>`);
+                listType = wanted;
+            }
+            out.push(`<li>${inline((bullet ?? numbered)[1])}</li>`);
+            continue;
+        }
+        closeList();
+        if (line.trim() === '')
+            continue;
+        if (/^---+$/.test(line.trim())) {
+            out.push('<hr>');
+            continue;
+        }
+        out.push(`<p>${inline(line)}</p>`);
+    }
+    closeList();
+    closeTable();
+    if (inCode)
+        out.push('</code></pre>');
+    return out.join('\n');
+}
+function inline(text) {
+    let out = escapeHtml(text);
+    out = out.replace(/!\[([^\]]*)\]\(([^)\s]+)\)/g, (_m, alt, src) => {
+        const clean = src.replace(/^&lt;|&gt;$/g, '');
+        return `<figure><img src="${clean}" alt="${alt}" loading="lazy"><figcaption>${alt}</figcaption></figure>`;
+    });
+    out = out.replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, '<a href="$2">$1</a>');
+    out = out.replace(/`([^`]+)`/g, '<code>$1</code>');
+    out = out.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>');
+    return out;
+}
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function page(title, body) {
+    return `<!doctype html>
+<html lang="es">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${escapeHtml(title)}</title>
+<style>
+  :root { color-scheme: light dark; }
+  body { margin: 0 auto; max-width: 60rem; padding: 2rem 1.5rem 6rem;
+         font: 16px/1.65 system-ui, -apple-system, 'Segoe UI', sans-serif; }
+  h1, h2, h3, h4 { line-height: 1.25; margin: 2rem 0 .75rem; }
+  h1 { font-size: 1.9rem; } h2 { font-size: 1.45rem; } h3 { font-size: 1.2rem; }
+  .meta { color: #6b7280; font-size: .9rem; }
+  figure { margin: 1.5rem 0; }
+  img { max-width: 100%; height: auto; display: block; }
+  figcaption { color: #6b7280; font-size: .85rem; margin-top: .4rem; }
+  pre { background: #f6f8fa; padding: .9rem 1rem; overflow-x: auto; border-radius: 6px; }
+  code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: .9em; }
+  table { border-collapse: collapse; margin: 1.2rem 0; width: 100%; }
+  th, td { border: 1px solid #d0d7de; padding: .45rem .7rem; text-align: left; }
+  th { background: #f6f8fa; }
+  ul.docs { padding-left: 1.1rem; }
+  a { color: #0969da; }
+  @media (prefers-color-scheme: dark) {
+    body { background: #0d1117; color: #e6edf3; }
+    pre, th { background: #161b22; }
+    th, td { border-color: #30363d; }
+    a { color: #58a6ff; }
+    .meta, figcaption { color: #9ba7b4; }
+  }
+</style>
+</head>
+<body>${body}</body>
+</html>`;
+}
+//# sourceMappingURL=preview.js.map

package/dist/build/preview.js.map

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

package/dist/build/skill.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Instalacion del contrato de DocViz como skill de agente.
+ *
+ * `docviz init` deja un `AGENTS.md` en el proyecto, y eso basta para los
+ * agentes que lo leen solos. Pero un agente solo abre `AGENTS.md` si ya esta
+ * trabajando en ese repositorio: no hay forma de que sepa que DocViz existe
+ * antes de eso. Un skill instalado —en el proyecto o en el perfil del usuario—
+ * lo pone en su radar desde el primer mensaje.
+ */
+export interface SkillOptions {
+    /** Raiz del proyecto, para la instalacion local. */
+    cwd: string;
+    /** Instala en el perfil del usuario en lugar de en el proyecto. */
+    global?: boolean;
+    /** Directorio de skills de otro agente, si no es el de Claude Code. */
+    dir?: string;
+    /** Sobrescribe una instalacion anterior. */
+    force?: boolean;
+}
+export interface SkillResult {
+    destino: string;
+    escrito: boolean;
+    /** Por que no se escribio, si no se escribio. */
+    motivo?: string;
+}
+/** Fuente del skill dentro del propio paquete. */
+export declare function skillSourcePath(): string;
+/**
+ * Directorio donde el agente busca sus skills.
+ *
+ * Se admite `dir` explicito porque cada agente elige el suyo y esa lista
+ * cambia mas rapido que este paquete: fijarla aqui garantizaria quedarse
+ * desactualizado.
+ */
+export declare function skillTargetDir(options: SkillOptions): string;
+export declare function installSkill(options: SkillOptions): Promise<SkillResult>;
+/** Informe legible de la instalacion. */
+export declare function formatearSkill(result: SkillResult): string;
+/** Contenido del skill, para comprobar que sigue siendo valido. */
+export declare function readSkill(): Promise<string>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/build/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/build/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kDAAkD;AAClD,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAI5D;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAmB9E;AAED,yCAAyC;AACzC,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAa1D;AAED,mEAAmE;AACnE,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAEjD"}