docviz-builder 0.1.0

package/dist/renderers/base.js

@@ -0,0 +1,59 @@
+/**
+ * Piezas compartidas por todos los renderers: limite de tiempo, limite de
+ * tamano y construccion del `RenderResult` (seccion 12, puntos 3 y 4).
+ */
+import { RenderError } from '../core/errors.js';
+import { MIME_TYPES } from '../core/types.js';
+import { applyColorScheme } from './color-scheme.js';
+import { finalizeSvg } from './svg-utils.js';
+/** Ejecuta una promesa con limite de tiempo; superarlo es un `RenderError`. */
+export async function withTimeout(renderer, timeoutMs, work) {
+    const controller = new AbortController();
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            controller.abort();
+            reject(new RenderError(renderer, `el render supero el limite de ${timeoutMs} ms`));
+        }, timeoutMs);
+        timer.unref?.();
+    });
+    try {
+        return await Promise.race([work(controller.signal), timeout]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+}
+/** Rechaza recursos que superen el tamano maximo configurado. */
+export function enforceSize(renderer, content, maxBytes) {
+    if (content.byteLength > maxBytes) {
+        throw new RenderError(renderer, `el recurso generado ocupa ${content.byteLength} bytes y supera el maximo de ${maxBytes}`, 'reduce el numero de nodos del diagrama o sube renderers.maxOutputBytes en docviz.config.yaml');
+    }
+}
+/** Comprueba que el formato pedido este soportado por el renderer. */
+export function assertFormat(renderer, format, supported) {
+    if (!supported.includes(format)) {
+        throw new RenderError(renderer, `el formato "${format}" no esta soportado por el renderer ${renderer}`, `formatos soportados: ${supported.join(', ')}`);
+    }
+}
+/** Normaliza, sanea y empaqueta un SVG como `RenderResult`. */
+export function svgResult(renderer, svg, options) {
+    // El esquema dual se aplica al final, sobre los colores que el tema ya inyecto.
+    const finalized = applyColorScheme(finalizeSvg(svg, options.title), options.theme);
+    const content = Buffer.from(finalized, 'utf8');
+    enforceSize(renderer, content, options.maxOutputBytes);
+    return { format: 'svg', content, mimeType: MIME_TYPES.svg };
+}
+export function pngResult(renderer, png, options) {
+    enforceSize(renderer, png, options.maxOutputBytes);
+    return { format: 'png', content: png, mimeType: MIME_TYPES.png };
+}
+/** Convierte un error desconocido en `RenderError` sin perder el detalle. */
+export function asRenderError(renderer, err, fallback) {
+    if (err instanceof RenderError)
+        return err;
+    const message = err instanceof Error ? err.message : String(err);
+    return new RenderError(renderer, fallback, message);
+}
+//# sourceMappingURL=base.js.map

package/dist/renderers/base.js.map

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

package/dist/renderers/bpmn.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Renderer BPMN (bpmn-js dentro de un Chromium local).
+ *
+ * bpmn-js es la implementacion de referencia de la notacion, pero es una
+ * biblioteca de navegador: necesita un DOM para medir y dibujar. Se ejecuta con
+ * el mismo Chromium que usa Mermaid, sin acceso a la red.
+ */
+import type { DiagramRenderer, OutputFormat, RenderOptions, RenderResult } from '../core/types.js';
+import type { Theme } from '../themes/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 BpmnOptions {
+    /** 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;
+    browserPath?: string;
+    /** Desactiva el sandbox de Chromium. Ver `shouldDisableSandbox`. */
+    noSandbox?: boolean;
+}
+export type Browser = {
+    newPage(): Promise<Page>;
+    close(): Promise<void>;
+};
+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;
+    close(): Promise<void>;
+};
+export declare class BpmnRenderer implements DiagramRenderer {
+    readonly type = "bpmn";
+    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?;
+    constructor(options?: BpmnOptions);
+    version(): Promise<string>;
+    private bundle;
+    private browser;
+    render(source: string, options: RenderOptions): Promise<RenderResult>;
+    dispose(): Promise<void>;
+}
+/**
+ * bpmn-js dibuja en negro sobre transparente. Se anaden el fondo del tema y una
+ * hoja de estilos que colorea trazos y textos sin alterar la notacion: en BPMN
+ * la forma tiene significado normativo, el color no.
+ */
+export declare function applyTheme(svg: string, theme: Theme): string;
+export declare function createBpmnRenderer(options?: BpmnOptions): DiagramRenderer;
+//# sourceMappingURL=bpmn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bpmn.d.ts","sourceRoot":"","sources":["../../src/renderers/bpmn.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAKnG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAOhD;;;;;;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,WAAW;IAC1B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,oEAAoE;IACpE,cAAc,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,OAAO,GAAG;IAAE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAC3E,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;IAC7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,qBAAa,YAAa,YAAW,eAAe;IAClD,QAAQ,CAAC,IAAI,UAAQ;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;gBAEnB,OAAO,GAAE,WAAgB;IAO/B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;YAKlB,MAAM;YAiBN,OAAO;IAef,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA2CrE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAgB5D;AA8BD,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,eAAe,CAEzE"}

package/dist/renderers/bpmn.js

@@ -0,0 +1,158 @@
+/**
+ * Renderer BPMN (bpmn-js dentro de un Chromium local).
+ *
+ * bpmn-js es la implementacion de referencia de la notacion, pero es una
+ * biblioteca de navegador: necesita un DOM para medir y dibujar. Se ejecuta con
+ * el mismo Chromium que usa Mermaid, sin acceso a la red.
+ */
+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 { renderBpmnInPage } from './in-page.js';
+const TYPE = 'bpmn';
+const SUPPORTED = ['svg'];
+const require_ = createRequire(import.meta.url);
+export class BpmnRenderer {
+    type = TYPE;
+    defaultFormat = 'svg';
+    supportedFormats = SUPPORTED;
+    browserPath;
+    noSandbox;
+    launch = defaultLaunch;
+    findExecutable = findBrowser;
+    browserPromise;
+    bundlePromise;
+    cachedVersion;
+    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() {
+        this.cachedVersion ??= `bpmn-js-${packageVersion('bpmn-js')}`;
+        return this.cachedVersion;
+    }
+    async bundle() {
+        this.bundlePromise ??= (async () => {
+            const pkg = require_.resolve('bpmn-js/package.json');
+            const file = path.join(path.dirname(pkg), 'dist', 'bpmn-viewer.production.min.js');
+            try {
+                return await readFile(file, 'utf8');
+            }
+            catch (err) {
+                throw new RenderError(TYPE, 'no se encuentra el visor de bpmn-js', `${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.includes('<bpmn:definitions') && !source.includes('<definitions')) {
+            throw new RenderError(TYPE, 'el contenido no es un proceso BPMN 2.0', 'usa el bloque `diagram` con `type: bpmn`; DocViz genera el XML y su trazado');
+        }
+        const browser = await this.browser();
+        const bundle = await this.bundle();
+        const page = await browser.newPage();
+        try {
+            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"></head><body style="margin:0">` +
+                `<div id="lienzo" style="width:2000px;height:1400px"></div></body></html>`, { waitUntil: 'domcontentloaded' });
+            await page.addScriptTag({ content: bundle });
+            const result = await withTimeout(options.timeoutMs, page.evaluate(renderBpmnInPage, source));
+            if ('error' in result && result.error !== undefined) {
+                throw new RenderError(TYPE, 'bpmn-js no pudo dibujar el proceso', result.error);
+            }
+            const svg = result.svg;
+            if (svg === undefined || !svg.includes('<svg')) {
+                throw new RenderError(TYPE, 'bpmn-js no produjo un SVG valido');
+            }
+            return svgResult(TYPE, applyTheme(svg, options.theme), options);
+        }
+        finally {
+            await page.close().catch(() => undefined);
+        }
+    }
+    async dispose() {
+        const browser = await this.browserPromise?.catch(() => undefined);
+        this.browserPromise = undefined;
+        await browser?.close().catch(() => undefined);
+    }
+}
+/**
+ * bpmn-js dibuja en negro sobre transparente. Se anaden el fondo del tema y una
+ * hoja de estilos que colorea trazos y textos sin alterar la notacion: en BPMN
+ * la forma tiene significado normativo, el color no.
+ */
+export function applyTheme(svg, theme) {
+    const style = `<style>` +
+        `.djs-visual > :is(rect,circle,path,polygon,polyline){stroke:${theme.palette.text};}` +
+        `.djs-visual > :is(rect,circle){fill:${theme.palette.surface};}` +
+        `.djs-visual > text, .djs-label{fill:${theme.palette.text};font-family:${theme.fontFamily};}` +
+        `.djs-visual > path{fill:none;}` +
+        `marker path, marker polyline{fill:${theme.palette.text};stroke:${theme.palette.text};}` +
+        `</style>`;
+    const open = /<svg\b[^>]*>/i.exec(svg);
+    if (open === null)
+        return svg;
+    const at = open.index + open[0].length;
+    // El fondo se pinta como primer elemento para que la imagen no sea transparente.
+    const background = `<rect x="-100000" y="-100000" width="200000" height="200000" fill="${theme.palette.background}"/>`;
+    return `${svg.slice(0, at)}${style}${background}${svg.slice(at)}`;
+}
+async function withTimeout(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. */
+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 createBpmnRenderer(options) {
+    return new BpmnRenderer(options);
+}
+//# sourceMappingURL=bpmn.js.map

package/dist/renderers/bpmn.js.map

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

package/dist/renderers/browser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Localizacion de un navegador Chromium ya instalado en la maquina.
+ *
+ * DocViz no descarga navegadores: usa el Chrome/Chromium del sistema o el que
+ * ya tengan cacheado Playwright o Puppeteer. Es la unica dependencia pesada del
+ * renderer Mermaid y conviene que sea explicita y diagnosticable.
+ */
+/** Orden de busqueda, de mas explicito a mas implicito. */
+export declare function browserCandidates(explicit?: string): string[];
+export declare function findBrowser(explicit?: string): string | undefined;
+export declare function browserNotFoundHelp(): string;
+/**
+ * Argumentos con los que se lanza Chromium.
+ *
+ * `--no-sandbox` **no** esta en la lista por defecto. El contenido que se
+ * dibuja aqui puede venir del documento de otra persona —un pull request, por
+ * ejemplo— y renderizarlo en un navegador sin sandbox convierte cualquier fallo
+ * del motor de render en ejecucion con los permisos del usuario. Se activa a
+ * proposito, no por descuido.
+ */
+export declare function chromiumLaunchArgs(noSandbox: boolean): string[];
+/**
+ * Si hay que desactivar el sandbox.
+ *
+ * Como root, Chromium **se niega a arrancar** con el sandbox activo, asi que en
+ * ese caso se desactiva solo: es eso o no dibujar nada, y es la situacion
+ * habitual dentro de un contenedor. En cualquier otro caso hay que pedirlo.
+ */
+export declare function shouldDisableSandbox(explicit?: boolean): boolean;
+//# sourceMappingURL=browser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/renderers/browser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsFH,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAa7D;AAED,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjE;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAS5C;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,EAAE,CAa/D;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAIhE"}

package/dist/renderers/browser.js

@@ -0,0 +1,143 @@
+/**
+ * Localizacion de un navegador Chromium ya instalado en la maquina.
+ *
+ * DocViz no descarga navegadores: usa el Chrome/Chromium del sistema o el que
+ * ya tengan cacheado Playwright o Puppeteer. Es la unica dependencia pesada del
+ * renderer Mermaid y conviene que sea explicita y diagnosticable.
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+const MAC_APPS = [
+    '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+    '/Applications/Google Chrome 2.app/Contents/MacOS/Google Chrome',
+    '/Applications/Chromium.app/Contents/MacOS/Chromium',
+    '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+    '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser',
+];
+const LINUX_BINS = [
+    '/usr/bin/google-chrome',
+    '/usr/bin/google-chrome-stable',
+    '/usr/bin/chromium',
+    '/usr/bin/chromium-browser',
+    '/usr/bin/microsoft-edge',
+    '/snap/bin/chromium',
+];
+const WINDOWS_BINS = [
+    'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+    'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
+    'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe',
+];
+/** Navegadores descargados por Playwright (`~/Library/Caches/ms-playwright`, etc.). */
+function playwrightCandidates() {
+    const roots = [
+        process.env['PLAYWRIGHT_BROWSERS_PATH'],
+        os.platform() === 'darwin'
+            ? path.join(os.homedir(), 'Library', 'Caches', 'ms-playwright')
+            : os.platform() === 'win32'
+                ? path.join(os.homedir(), 'AppData', 'Local', 'ms-playwright')
+                : path.join(os.homedir(), '.cache', 'ms-playwright'),
+    ].filter((r) => typeof r === 'string' && r !== '' && existsSync(r));
+    const found = [];
+    for (const root of roots) {
+        let entries;
+        try {
+            entries = readdirSync(root);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries.filter((e) => e.startsWith('chromium')).sort().reverse()) {
+            const base = path.join(root, entry);
+            found.push(path.join(base, 'chrome-mac-arm64', 'Chromium.app', 'Contents', 'MacOS', 'Chromium'), path.join(base, 'chrome-mac', 'Chromium.app', 'Contents', 'MacOS', 'Chromium'), path.join(base, 'chrome-linux', 'chrome'), path.join(base, 'chrome-win', 'chrome.exe'), path.join(base, 'chrome-headless-shell-mac-arm64', 'chrome-headless-shell'), path.join(base, 'chrome-headless-shell-linux', 'chrome-headless-shell'));
+        }
+    }
+    return found;
+}
+/** Navegadores descargados por Puppeteer (`~/.cache/puppeteer`). */
+function puppeteerCandidates() {
+    const root = process.env['PUPPETEER_CACHE_DIR'] ?? path.join(os.homedir(), '.cache', 'puppeteer');
+    if (!existsSync(root))
+        return [];
+    const found = [];
+    for (const channel of ['chrome', 'chrome-headless-shell', 'chromium']) {
+        const dir = path.join(root, channel);
+        if (!existsSync(dir))
+            continue;
+        for (const version of readdirSync(dir).sort().reverse()) {
+            const base = path.join(dir, version);
+            found.push(path.join(base, 'chrome-mac-arm64', 'Google Chrome for Testing.app', 'Contents', 'MacOS', 'Google Chrome for Testing'), path.join(base, 'chrome-mac-x64', 'Google Chrome for Testing.app', 'Contents', 'MacOS', 'Google Chrome for Testing'), path.join(base, 'chrome-linux64', 'chrome'), path.join(base, 'chrome-win64', 'chrome.exe'), path.join(base, 'chrome-headless-shell-mac-arm64', 'chrome-headless-shell'), path.join(base, 'chrome-headless-shell-linux64', 'chrome-headless-shell'));
+        }
+    }
+    return found;
+}
+/** Orden de busqueda, de mas explicito a mas implicito. */
+export function browserCandidates(explicit) {
+    const list = [
+        explicit,
+        process.env['DOCVIZ_BROWSER_PATH'],
+        process.env['PUPPETEER_EXECUTABLE_PATH'],
+        process.env['CHROME_PATH'],
+    ];
+    const platform = os.platform();
+    if (platform === 'darwin')
+        list.push(...MAC_APPS);
+    else if (platform === 'win32')
+        list.push(...WINDOWS_BINS);
+    else
+        list.push(...LINUX_BINS);
+    list.push(...playwrightCandidates(), ...puppeteerCandidates());
+    return list.filter((p) => typeof p === 'string' && p !== '');
+}
+export function findBrowser(explicit) {
+    return browserCandidates(explicit).find((p) => existsSync(p));
+}
+export function browserNotFoundHelp() {
+    return [
+        'DocViz usa un Chromium ya instalado; no descarga navegadores.',
+        'Opciones:',
+        '  - instala Google Chrome, o',
+        '  - exporta DOCVIZ_BROWSER_PATH=/ruta/al/chrome, o',
+        '  - define renderers.mermaid.browserPath en docviz.config.yaml, o',
+        '  - ejecuta `npx playwright install chromium`.',
+    ].join('\n');
+}
+/**
+ * Argumentos con los que se lanza Chromium.
+ *
+ * `--no-sandbox` **no** esta en la lista por defecto. El contenido que se
+ * dibuja aqui puede venir del documento de otra persona —un pull request, por
+ * ejemplo— y renderizarlo en un navegador sin sandbox convierte cualquier fallo
+ * del motor de render en ejecucion con los permisos del usuario. Se activa a
+ * proposito, no por descuido.
+ */
+export function chromiumLaunchArgs(noSandbox) {
+    const args = [
+        '--disable-dev-shm-usage',
+        '--disable-gpu',
+        '--hide-scrollbars',
+        '--mute-audio',
+        '--disable-background-networking',
+        '--disable-sync',
+        '--no-first-run',
+        '--no-default-browser-check',
+    ];
+    if (noSandbox)
+        args.unshift('--no-sandbox');
+    return args;
+}
+/**
+ * Si hay que desactivar el sandbox.
+ *
+ * Como root, Chromium **se niega a arrancar** con el sandbox activo, asi que en
+ * ese caso se desactiva solo: es eso o no dibujar nada, y es la situacion
+ * habitual dentro de un contenedor. En cualquier otro caso hay que pedirlo.
+ */
+export function shouldDisableSandbox(explicit) {
+    if (explicit !== undefined)
+        return explicit;
+    if (process.env['DOCVIZ_NO_SANDBOX'] === '1')
+        return true;
+    return process.getuid?.() === 0;
+}
+//# sourceMappingURL=browser.js.map

package/dist/renderers/browser.js.map

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

package/dist/renderers/color-scheme.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Esquema de color dual: la misma imagen legible en un visor claro y en uno
+ * oscuro.
+ *
+ * Un SVG referenciado desde `<img>` se renderiza como su propio documento, y el
+ * navegador le aplica la preferencia de color del usuario. Eso permite declarar
+ * los colores como variables CSS y redefinirlas bajo
+ * `@media (prefers-color-scheme: dark)`.
+ *
+ * La sustitucion es textual sobre los hexadecimales que el propio DocViz inyecto
+ * al aplicar el tema, y funciona tanto en atributos de presentacion
+ * (`fill="var(--dv1,#12508F)"`) como en estilos en linea y hojas de estilo
+ * incrustadas: los tres son declaraciones CSS y admiten `var()`.
+ */
+import type { Theme } from '../themes/types.js';
+/** Correspondencia entre un color del tema claro y su equivalente oscuro. */
+export interface ColorPair {
+    light: string;
+    dark: string;
+}
+/**
+ * Empareja cada color de la paleta clara con su equivalente oscuro.
+ *
+ * Un mismo hexadecimal puede cumplir varios roles —en el tema corporativo, el
+ * fondo y el texto sobre el color primario son ambos blanco— y eso es correcto
+ * siempre que todos los roles lleven al mismo color oscuro. Si no coincidieran,
+ * la sustitucion seria ambigua y el tema esta mal definido, asi que se rechaza
+ * en el arranque en lugar de producir una imagen ilegible.
+ */
+export declare function colorPairs(theme: Theme): ColorPair[];
+/**
+ * Reescribe los colores del tema como variables CSS y anade el bloque que las
+ * redefine en modo oscuro.
+ *
+ * Devuelve el SVG sin tocar si el tema no declara contraparte oscura, o si
+ * ninguno de sus colores aparece en la imagen (por ejemplo un diagrama de D2,
+ * que trae su propio tema y su propio bloque de modo oscuro).
+ */
+export declare function applyColorScheme(svg: string, theme: Theme): string;
+//# sourceMappingURL=color-scheme.d.ts.map

package/dist/renderers/color-scheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-scheme.d.ts","sourceRoot":"","sources":["../../src/renderers/color-scheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,oBAAoB,CAAC;AAE9D,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE,CAyBpD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAmClE"}