docviz-builder 0.1.0

package/dist/renderers/mermaid.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Renderer Mermaid — Mermaid necesita medir texto en un DOM real, asi que se
+ * ejecuta dentro de un Chromium local en modo headless.
+ *
+ * Nada sale a la red: la pagina es `about:blank`, el bundle de Mermaid se
+ * inyecta desde `node_modules` y la navegacion queda bloqueada.
+ */
+import type { DiagramRenderer, OutputFormat, RenderOptions, RenderResult } from '../core/types.js';
+/**
+ * Lanzador del navegador.
+ *
+ * Se inyecta para poder probar los caminos de error —no hay navegador, no
+ * arranca, la pagina falla— sin depender de que la maquina que ejecuta las
+ * pruebas tenga o no un Chromium, y sin provocar fallos reales del sistema.
+ */
+export type LaunchBrowser = (executablePath: string, opciones?: {
+    noSandbox: boolean;
+}) => Promise<Browser>;
+export interface MermaidOptions {
+    /** Sustituye el lanzador real. Solo se usa en pruebas. */
+    launch?: LaunchBrowser;
+    /** Sustituye la busqueda del ejecutable. Solo se usa en pruebas. */
+    findExecutable?: (explicit?: string) => string | undefined;
+    /** Ruta explicita al ejecutable de Chromium. */
+    browserPath?: string;
+    /** Desactiva el sandbox de Chromium. Ver `shouldDisableSandbox`. */
+    noSandbox?: boolean;
+}
+export type Browser = {
+    newPage(): Promise<Page>;
+    close(): Promise<void>;
+    connected?: boolean;
+};
+export type Page = {
+    setContent(html: string, options?: unknown): Promise<void>;
+    addScriptTag(options: {
+        content: string;
+    }): Promise<unknown>;
+    evaluate<T, A extends unknown[]>(fn: (...args: A) => T | Promise<T>, ...args: A): Promise<T>;
+    setRequestInterception?(v: boolean): Promise<void>;
+    on(event: string, handler: (...args: never[]) => void): void;
+};
+export declare class MermaidRenderer implements DiagramRenderer {
+    readonly type = "mermaid";
+    readonly defaultFormat: OutputFormat;
+    readonly supportedFormats: readonly OutputFormat[];
+    private readonly browserPath?;
+    private readonly noSandbox;
+    private readonly launch;
+    private readonly findExecutable;
+    private browserPromise?;
+    private bundlePromise?;
+    private cachedVersion?;
+    private counter;
+    constructor(options?: MermaidOptions);
+    version(): Promise<string>;
+    /** Bundle UMD autocontenido de Mermaid (define `window.mermaid`). */
+    private bundle;
+    private browser;
+    render(source: string, options: RenderOptions): Promise<RenderResult>;
+    dispose(): Promise<void>;
+}
+export declare function createMermaidRenderer(options?: MermaidOptions): DiagramRenderer;
+//# sourceMappingURL=mermaid.d.ts.map

package/dist/renderers/mermaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../src/renderers/mermaid.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAWnG;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,cAAc,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,KAC9B,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,oEAAoE;IACpE,cAAc,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3D,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AACF,MAAM,MAAM,IAAI,GAAG;IACjB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,YAAY,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7F,sBAAsB,CAAC,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CAC9D,CAAC;AAEF,qBAAa,eAAgB,YAAW,eAAe;IACrD,QAAQ,CAAC,IAAI,aAAQ;IACrB,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAS;IAC7C,QAAQ,CAAC,gBAAgB,0BAAa;IAEtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0D;IACzF,OAAO,CAAC,cAAc,CAAC,CAAmB;IAC1C,OAAO,CAAC,aAAa,CAAC,CAAkB;IACxC,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,OAAO,CAAK;gBAER,OAAO,GAAE,cAAmB;IAOlC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAMhC,qEAAqE;YACvD,MAAM;YAiBN,OAAO;IAef,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA6DrE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B;AAkED,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,eAAe,CAE/E"}

package/dist/renderers/mermaid.js

@@ -0,0 +1,196 @@
+/**
+ * Renderer Mermaid — Mermaid necesita medir texto en un DOM real, asi que se
+ * ejecuta dentro de un Chromium local en modo headless.
+ *
+ * Nada sale a la red: la pagina es `about:blank`, el bundle de Mermaid se
+ * inyecta desde `node_modules` y la navegacion queda bloqueada.
+ */
+import { readFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { RenderError } from '../core/errors.js';
+import { packageVersion } from '../core/package-version.js';
+import { assertFormat, asRenderError, svgResult } from './base.js';
+import { browserNotFoundHelp, chromiumLaunchArgs, findBrowser, shouldDisableSandbox } from './browser.js';
+import { renderMermaidInPage } from './in-page.js';
+const TYPE = 'mermaid';
+const SUPPORTED = ['svg'];
+const require_ = createRequire(import.meta.url);
+export class MermaidRenderer {
+    type = TYPE;
+    defaultFormat = 'svg';
+    supportedFormats = SUPPORTED;
+    browserPath;
+    noSandbox;
+    launch = defaultLaunch;
+    findExecutable = findBrowser;
+    browserPromise;
+    bundlePromise;
+    cachedVersion;
+    counter = 0;
+    constructor(options = {}) {
+        this.browserPath = options.browserPath;
+        this.noSandbox = shouldDisableSandbox(options.noSandbox);
+        if (options.launch !== undefined)
+            this.launch = options.launch;
+        if (options.findExecutable !== undefined)
+            this.findExecutable = options.findExecutable;
+    }
+    async version() {
+        if (this.cachedVersion !== undefined)
+            return this.cachedVersion;
+        this.cachedVersion = `mermaid-${packageVersion('mermaid')}`;
+        return this.cachedVersion;
+    }
+    /** Bundle UMD autocontenido de Mermaid (define `window.mermaid`). */
+    async bundle() {
+        this.bundlePromise ??= (async () => {
+            const entry = require_.resolve('mermaid/package.json');
+            const file = path.join(path.dirname(entry), 'dist', 'mermaid.min.js');
+            try {
+                return await readFile(file, 'utf8');
+            }
+            catch (err) {
+                throw new RenderError(TYPE, 'no se encuentra el bundle de Mermaid', `${file}\n${err instanceof Error ? err.message : String(err)}`);
+            }
+        })();
+        return this.bundlePromise;
+    }
+    async browser() {
+        this.browserPromise ??= (async () => {
+            const executablePath = this.findExecutable(this.browserPath);
+            if (executablePath === undefined) {
+                throw new RenderError(TYPE, 'no se encontro un navegador Chromium', browserNotFoundHelp());
+            }
+            try {
+                return await this.launch(executablePath, { noSandbox: this.noSandbox });
+            }
+            catch (err) {
+                throw asRenderError(TYPE, err, `no se pudo lanzar el navegador en ${executablePath}`);
+            }
+        })();
+        return this.browserPromise;
+    }
+    async render(source, options) {
+        assertFormat(TYPE, options.format, SUPPORTED);
+        if (source.trim() === '')
+            throw new RenderError(TYPE, 'el diagrama Mermaid esta vacio');
+        const browser = await this.browser();
+        const bundle = await this.bundle();
+        const page = await browser.newPage();
+        const id = `docviz-${(this.counter += 1)}`;
+        try {
+            // Bloquea toda peticion de red que Mermaid pudiera intentar (p.ej. fuentes).
+            await page.setRequestInterception?.(true);
+            page.on('request', ((req) => {
+                if (req.url().startsWith('data:') || req.url() === 'about:blank')
+                    req.continue();
+                else
+                    req.abort();
+            }));
+            await page.setContent(`<!doctype html><html><head><meta charset="utf-8"><style>body{margin:0;background:${options.theme.palette.background};font-family:${options.theme.fontFamily}}</style></head><body><div id="host"></div></body></html>`, { waitUntil: 'domcontentloaded' });
+            await page.addScriptTag({ content: bundle });
+            const result = await withPageTimeout(options.timeoutMs, page.evaluate(renderMermaidInPage, {
+                code: source,
+                id,
+                config: {
+                    startOnLoad: false,
+                    // `strict` desactiva HTML arbitrario y manejadores `click` dentro
+                    // del diagrama: el codigo viene de un documento, no de un humano.
+                    securityLevel: 'strict',
+                    theme: options.theme.mermaid.theme,
+                    themeVariables: options.theme.mermaid.themeVariables,
+                    fontFamily: options.theme.fontFamily,
+                    flowchart: { htmlLabels: false, useMaxWidth: false, curve: 'basis' },
+                    sequence: { useMaxWidth: false },
+                    gantt: { useMaxWidth: false },
+                    class: { useMaxWidth: false },
+                    state: { useMaxWidth: false },
+                    er: { useMaxWidth: false },
+                    journey: { useMaxWidth: false },
+                    pie: { useMaxWidth: false },
+                },
+            }));
+            if ('error' in result && result.error !== undefined) {
+                throw new RenderError(TYPE, 'Mermaid no pudo dibujar el diagrama', result.error);
+            }
+            const svg = result.svg;
+            if (svg === undefined || !svg.includes('<svg')) {
+                throw new RenderError(TYPE, 'Mermaid no produjo un SVG valido');
+            }
+            return svgResult(TYPE, stripMermaidIds(svg, id), options);
+        }
+        finally {
+            await page.close().catch(() => undefined);
+        }
+    }
+    async dispose() {
+        const browser = await this.browserPromise?.catch(() => undefined);
+        this.browserPromise = undefined;
+        await browser?.close().catch(() => undefined);
+    }
+}
+/**
+ * Mermaid usa el id de render como prefijo de todas sus clases CSS. Se
+ * reemplaza por uno estable para que dos builds del mismo diagrama produzcan
+ * bytes identicos (requisito de determinismo del hash).
+ */
+function stripMermaidIds(svg, id) {
+    return estabilizarCommits(svg.split(id).join('docviz-diagram'));
+}
+/**
+ * Identificadores de commit deterministas en `git-graph`.
+ *
+ * Mermaid inventa un hash aleatorio de siete caracteres para cada commit que no
+ * lleva `id`, y lo escribe en las clases del SVG. El resultado es que **el mismo
+ * bloque produce bytes distintos en cada render**, lo que rompe la promesa
+ * central del proyecto: el nombre del recurso se deriva de la fuente, asi que el
+ * archivo se llama igual y cambia por dentro. Un `git diff` con ruido en cada
+ * build, y un cache que sirve una imagen distinta de la que se acaba de dibujar.
+ *
+ * Se sustituyen por un contador en orden de aparicion. Sigue habiendo un
+ * identificador distinto por commit —que es para lo que Mermaid los usa— pero
+ * ahora es el mismo en cada ejecucion.
+ */
+function estabilizarCommits(svg) {
+    const aleatorio = /\b(\d+)-([0-9a-f]{7})\b/g;
+    const vistos = new Map();
+    return svg.replace(aleatorio, (completo, indice, hash) => {
+        const clave = `${indice}-${hash}`;
+        const existente = vistos.get(clave);
+        if (existente !== undefined)
+            return existente;
+        const estable = `${indice}-c${vistos.size + 1}`;
+        vistos.set(clave, estable);
+        return estable;
+    });
+}
+async function withPageTimeout(timeoutMs, work) {
+    let timer;
+    try {
+        return await Promise.race([
+            work,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new RenderError(TYPE, `el render supero el limite de ${timeoutMs} ms`)), timeoutMs);
+                timer.unref?.();
+            }),
+        ]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+}
+/** Lanzador real: Chromium sin red, porque el contenido puede ser confidencial. */
+const defaultLaunch = async (executablePath, opciones) => {
+    const puppeteer = await import('puppeteer-core');
+    return (await puppeteer.default.launch({
+        executablePath,
+        headless: true,
+        args: chromiumLaunchArgs(opciones?.noSandbox === true),
+    }));
+};
+export function createMermaidRenderer(options) {
+    return new MermaidRenderer(options);
+}
+//# sourceMappingURL=mermaid.js.map

package/dist/renderers/mermaid.js.map

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

package/dist/renderers/plantuml.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Renderer PlantUML — JVM local con `plantuml.jar` vendorizado.
+ *
+ * No se usa ningun servicio publico: el codigo fuente nunca sale del proceso.
+ * La comunicacion es por `-pipe` (stdin/stdout), asi que PlantUML nunca recibe
+ * una ruta de archivo procedente del documento.
+ */
+import type { DiagramRenderer, OutputFormat, RenderOptions, RenderResult } from '../core/types.js';
+export interface PlantUmlOptions {
+    /** Ruta al jar. Por defecto `vendor/plantuml.jar` del propio paquete. */
+    jarPath?: string;
+    /** Ejecutable de Java. */
+    javaPath?: string;
+    /** Memoria maxima de la JVM. */
+    maxHeap?: string;
+}
+/**
+ * Donde vive el jar cuando nadie dice lo contrario.
+ *
+ * Es el **directorio del paquete**, no el del proyecto que lo usa: instalado
+ * como dependencia, el jar viaja dentro de `node_modules`. Se exporta porque
+ * `docviz doctor` tiene que mirar exactamente aqui; si lo dedujera por su
+ * cuenta diria que falta un jar que el renderer encuentra sin problema.
+ */
+export declare function defaultJarPath(): string;
+/** Ruta efectiva del jar segun configuracion, entorno y valor por defecto. */
+export declare function resolveJarPath(explicit?: string): string;
+export declare class PlantUmlRenderer implements DiagramRenderer {
+    readonly type = "plantuml";
+    readonly defaultFormat: OutputFormat;
+    readonly supportedFormats: readonly OutputFormat[];
+    private readonly jarPath;
+    private readonly javaPath;
+    private readonly maxHeap;
+    private cachedVersion?;
+    constructor(options?: PlantUmlOptions);
+    version(): Promise<string>;
+    render(source: string, options: RenderOptions): Promise<RenderResult>;
+    /**
+     * Inserta el preambulo del tema justo despues de la directiva de apertura.
+     * Si el usuario ya definio un `skinparam`, el suyo gana porque va despues.
+     */
+    private applyTheme;
+    /**
+     * Bloquea las directivas que harian que PlantUML lea disco o red.
+     *
+     * Se evalua linea a linea: una inclusion de la biblioteca estandar del jar es
+     * legitima, y comprobar el documento entero de una vez no permitiria
+     * distinguirla de un `!include /etc/passwd` en la linea siguiente.
+     */
+    private assertNoFileAccess;
+    private assertJarAvailable;
+    private runJava;
+}
+export declare function createPlantUmlRenderer(options?: PlantUmlOptions): DiagramRenderer;
+//# sourceMappingURL=plantuml.d.ts.map

package/dist/renderers/plantuml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plantuml.d.ts","sourceRoot":"","sources":["../../src/renderers/plantuml.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAwBnG,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,qBAAa,gBAAiB,YAAW,eAAe;IACtD,QAAQ,CAAC,IAAI,cAAQ;IACrB,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAS;IAC7C,QAAQ,CAAC,gBAAgB,0BAAa;IAEtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,aAAa,CAAC,CAAS;gBAEnB,OAAO,GAAE,eAAoB;IAMnC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAS1B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAwB3E;;;OAGG;IACH,OAAO,CAAC,UAAU;IAalB;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;YAeZ,kBAAkB;IAYhC,OAAO,CAAC,OAAO;CA0DhB;AAqBD,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,eAAe,CAEjF"}

package/dist/renderers/plantuml.js

@@ -0,0 +1,195 @@
+/**
+ * Renderer PlantUML — JVM local con `plantuml.jar` vendorizado.
+ *
+ * No se usa ningun servicio publico: el codigo fuente nunca sale del proceso.
+ * La comunicacion es por `-pipe` (stdin/stdout), asi que PlantUML nunca recibe
+ * una ruta de archivo procedente del documento.
+ */
+import { spawn } from 'node:child_process';
+import { access, constants } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { RenderError } from '../core/errors.js';
+import { assertFormat, pngResult, svgResult } from './base.js';
+const TYPE = 'plantuml';
+const SUPPORTED = ['svg', 'png'];
+/**
+ * Inclusiones permitidas: solo la biblioteca estandar que viaja dentro del jar.
+ *
+ * `!include <C4/C4_Context>` no toca el sistema de archivos ni la red: PlantUML
+ * resuelve la forma `<...>` contra los recursos empaquetados. Es lo que permite
+ * dibujar C4, y bloquearla obligaria a depender de un servicio externo para algo
+ * que ya esta en la maquina.
+ */
+const STDLIB_INCLUDE = /^\s*!include(?:sub)?\s+<[^>\n]+>\s*$/i;
+/** Directivas de PlantUML que permiten leer o escribir en disco / en la red. */
+const FORBIDDEN_DIRECTIVES = [
+    { re: /^\s*!includeurl\b/im, what: '!includeurl' },
+    { re: /^\s*!include(?:sub)?\b/im, what: '!include' },
+    { re: /^\s*!import\b/im, what: '!import' },
+    { re: /^\s*!theme\s+.*\bfrom\b/im, what: '!theme ... from' },
+];
+/**
+ * Donde vive el jar cuando nadie dice lo contrario.
+ *
+ * Es el **directorio del paquete**, no el del proyecto que lo usa: instalado
+ * como dependencia, el jar viaja dentro de `node_modules`. Se exporta porque
+ * `docviz doctor` tiene que mirar exactamente aqui; si lo dedujera por su
+ * cuenta diria que falta un jar que el renderer encuentra sin problema.
+ */
+export function defaultJarPath() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    // dist/renderers/plantuml.js -> raiz del paquete
+    return path.resolve(here, '..', '..', 'vendor', 'plantuml.jar');
+}
+/** Ruta efectiva del jar segun configuracion, entorno y valor por defecto. */
+export function resolveJarPath(explicit) {
+    return path.resolve(explicit ?? process.env['DOCVIZ_PLANTUML_JAR'] ?? defaultJarPath());
+}
+export class PlantUmlRenderer {
+    type = TYPE;
+    defaultFormat = 'svg';
+    supportedFormats = SUPPORTED;
+    jarPath;
+    javaPath;
+    maxHeap;
+    cachedVersion;
+    constructor(options = {}) {
+        this.jarPath = resolveJarPath(options.jarPath);
+        this.javaPath = options.javaPath ?? process.env['DOCVIZ_JAVA'] ?? 'java';
+        this.maxHeap = options.maxHeap ?? '1024m';
+    }
+    async version() {
+        if (this.cachedVersion !== undefined)
+            return this.cachedVersion;
+        await this.assertJarAvailable();
+        const { stdout } = await this.runJava(['-version'], undefined, 60_000);
+        const match = /PlantUML version ([\w.]+)/i.exec(stdout.toString('utf8'));
+        this.cachedVersion = `plantuml-${match?.[1] ?? 'desconocida'}`;
+        return this.cachedVersion;
+    }
+    async render(source, options) {
+        assertFormat(TYPE, options.format, SUPPORTED);
+        await this.assertJarAvailable();
+        this.assertNoFileAccess(source);
+        const prepared = this.applyTheme(source, options);
+        const args = [options.format === 'png' ? '-tpng' : '-tsvg'];
+        const { stdout, stderr, code } = await this.runJava(['-pipe', '-failfast2', '-charset', 'UTF-8', ...args], Buffer.from(prepared, 'utf8'), options.timeoutMs);
+        if (code !== 0) {
+            throw new RenderError(TYPE, describePlantUmlError(stderr.toString('utf8')), stderr.toString('utf8').trim());
+        }
+        if (stdout.byteLength === 0) {
+            throw new RenderError(TYPE, 'PlantUML no produjo salida', stderr.toString('utf8').trim());
+        }
+        if (options.format === 'png')
+            return pngResult(TYPE, stdout, options);
+        return svgResult(TYPE, stdout.toString('utf8'), options);
+    }
+    /**
+     * Inserta el preambulo del tema justo despues de la directiva de apertura.
+     * Si el usuario ya definio un `skinparam`, el suyo gana porque va despues.
+     */
+    applyTheme(source, options) {
+        const skin = options.theme.plantuml.skinparams.join('\n');
+        const trimmed = source.trim();
+        const openTag = /^@start[a-z]+\b.*$/im.exec(trimmed);
+        if (openTag === null) {
+            // Sin @startuml explicito PlantUML asume uno; lo hacemos explicito para
+            // poder inyectar el tema de forma fiable.
+            return `@startuml\n${skin}\n${trimmed}\n@enduml\n`;
+        }
+        const insertAt = openTag.index + openTag[0].length;
+        return `${trimmed.slice(0, insertAt)}\n${skin}\n${trimmed.slice(insertAt)}\n`;
+    }
+    /**
+     * Bloquea las directivas que harian que PlantUML lea disco o red.
+     *
+     * Se evalua linea a linea: una inclusion de la biblioteca estandar del jar es
+     * legitima, y comprobar el documento entero de una vez no permitiria
+     * distinguirla de un `!include /etc/passwd` en la linea siguiente.
+     */
+    assertNoFileAccess(source) {
+        for (const line of source.split('\n')) {
+            if (STDLIB_INCLUDE.test(line))
+                continue;
+            for (const { re, what } of FORBIDDEN_DIRECTIVES) {
+                if (re.test(line)) {
+                    throw new RenderError(TYPE, `la directiva ${what} esta deshabilitada por seguridad`, 'DocViz solo admite la biblioteca estandar empaquetada, con la forma !include <biblioteca/archivo>');
+                }
+            }
+        }
+    }
+    async assertJarAvailable() {
+        try {
+            await access(this.jarPath, constants.R_OK);
+        }
+        catch {
+            throw new RenderError(TYPE, `no se encuentra plantuml.jar en ${this.jarPath}`, 'ejecuta `npx docviz setup` para descargarlo, o define renderers.plantuml.jar en docviz.config.yaml');
+        }
+    }
+    runJava(jarArgs, stdin, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const child = spawn(this.javaPath, [
+                '-Djava.awt.headless=true',
+                '-Dfile.encoding=UTF-8',
+                `-Xmx${this.maxHeap}`,
+                '-jar',
+                this.jarPath,
+                ...jarArgs,
+            ], { stdio: ['pipe', 'pipe', 'pipe'] });
+            const out = [];
+            const err = [];
+            let settled = false;
+            const timer = setTimeout(() => {
+                if (settled)
+                    return;
+                settled = true;
+                child.kill('SIGKILL');
+                reject(new RenderError(TYPE, `el render supero el limite de ${timeoutMs} ms`));
+            }, timeoutMs);
+            timer.unref?.();
+            child.stdout.on('data', (c) => out.push(c));
+            child.stderr.on('data', (c) => err.push(c));
+            child.on('error', (e) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                reject(new RenderError(TYPE, `no se pudo ejecutar Java (${this.javaPath})`, `${e.message}\ninstala un JRE 8+ o define renderers.plantuml.java en docviz.config.yaml`));
+            });
+            child.on('close', (code) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                resolve({ stdout: Buffer.concat(out), stderr: Buffer.concat(err), code: code ?? -1 });
+            });
+            if (stdin !== undefined)
+                child.stdin.end(stdin);
+            else
+                child.stdin.end();
+        });
+    }
+}
+/**
+ * PlantUML escribe en stderr un bloque `ERROR / <linea> / <mensaje>`.
+ * Se extrae el mensaje util para que el reporte no sea "exit code 200".
+ */
+function describePlantUmlError(stderr) {
+    const lines = stderr
+        .split('\n')
+        .map((l) => l.trim())
+        .filter((l) => l !== '');
+    const errIdx = lines.findIndex((l) => l.toUpperCase() === 'ERROR');
+    if (errIdx >= 0) {
+        const lineNo = lines[errIdx + 1];
+        const message = lines.slice(errIdx + 2).find((l) => l !== '') ?? 'error de sintaxis';
+        const where = /^\d+$/.test(lineNo ?? '') ? ` (linea ${lineNo} del diagrama)` : '';
+        return `${message}${where}`;
+    }
+    return lines[0] ?? 'PlantUML fallo sin describir el motivo';
+}
+export function createPlantUmlRenderer(options) {
+    return new PlantUmlRenderer(options);
+}
+//# sourceMappingURL=plantuml.js.map

package/dist/renderers/plantuml.js.map

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

package/dist/renderers/svg-utils.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Utilidades comunes de post-proceso de SVG.
+ *
+ * Todo SVG que sale de DocViz pasa por aqui para garantizar tres cosas:
+ *   1. dimensiones explicitas (si no, `<img src="...svg">` se rompe o se recorta);
+ *   2. un `<title>` accesible;
+ *   3. sanitizacion: sin scripts ni manejadores de eventos (seccion 12.7).
+ */
+/**
+ * Deja el SVG con solo los elementos y atributos permitidos.
+ *
+ * No intenta reparar un SVG mal formado: recorre las etiquetas respetando las
+ * comillas, y lo que no reconoce lo descarta.
+ */
+export declare function sanitizeSvg(svg: string): string;
+/**
+ * Garantiza `width`, `height` y `viewBox` numericos en el elemento raiz.
+ *
+ * Mermaid emite `width="100%"` sin `height`, lo que en un visor Markdown
+ * produce una imagen de altura cero. Aqui se deriva el tamano real del
+ * `viewBox` y se fija en pixeles.
+ */
+export declare function normalizeSvgDimensions(svg: string): string;
+/**
+ * Renumera los identificadores internos del SVG en orden de aparicion.
+ *
+ * Vega mantiene un contador global de `clipPath` por proceso: el mismo grafico
+ * renderizado dos veces produce `clip1` y luego `clip2`, es decir bytes
+ * distintos para la misma entrada. Eso rompe el determinismo que exige el
+ * modelo de cache, asi que los ids se normalizan aqui para todos los motores.
+ *
+ * Se reescribe tanto el atributo `id` como toda referencia `#id`: Mermaid
+ * incrusta una hoja de estilos cuyos selectores estan acotados por el id del
+ * elemento raiz (`#mi-id .task { ... }`). Renombrar solo el atributo dejaria
+ * esos selectores sin destino y el diagrama saldria sin estilos, con los
+ * rectangulos en negro.
+ */
+export declare function stabilizeSvgIds(svg: string, prefix?: string): string;
+export declare function escapeXml(text: string): string;
+/** Inserta `<title>` como primer hijo del `<svg>` si aun no existe uno. */
+export declare function injectTitle(svg: string, title: string | undefined): string;
+/** Asegura que exista la declaracion de namespace SVG. */
+export declare function ensureNamespace(svg: string): string;
+/** Pipeline completo aplicado a todo SVG antes de escribirlo a disco. */
+export declare function finalizeSvg(svg: string, title?: string): string;
+//# sourceMappingURL=svg-utils.d.ts.map

package/dist/renderers/svg-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-utils.d.ts","sourceRoot":"","sources":["../../src/renderers/svg-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8NH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAwD/C;AAyCD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAsC1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,MAAM,CA2BlE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQ1E;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAa/D"}