docviz-builder 0.1.0

package/dist/renderers/index.js

@@ -0,0 +1,94 @@
+/**
+ * Construccion del registro de renderers a partir de la configuracion.
+ *
+ * Es el unico lugar del proyecto donde se decide que motor atiende cada
+ * lenguaje. Anadir un renderer nuevo se reduce a registrar una entrada mas.
+ */
+import path from 'node:path';
+import { RendererRegistry } from '../core/registry.js';
+import { createD2Renderer } from './d2.js';
+import { createGraphvizRenderer } from './graphviz.js';
+import { createKrokiRenderer, krokiSupports } from './kroki.js';
+import { createLikeC4Renderer } from './likec4.js';
+import { createMermaidRenderer } from './mermaid.js';
+import { createPlantUmlRenderer } from './plantuml.js';
+import { createVegaLiteRenderer } from './vega-lite.js';
+import { createSvgbobRenderer } from './svgbob.js';
+import { createBpmnRenderer } from './bpmn.js';
+export { RendererRegistry } from '../core/registry.js';
+/** Alias de lenguaje aceptados en la valla de codigo Markdown. */
+const ALIASES = {
+    plantuml: ['puml', 'uml'],
+    mermaid: ['mmd'],
+    d2: [],
+    graphviz: ['dot'],
+    'vega-lite': ['vegalite', 'vl'],
+    likec4: ['c4'],
+    svgbob: ['ascii-art'],
+    bpmn: [],
+};
+export function buildRegistry(config) {
+    const registry = new RendererRegistry();
+    const r = config.renderers;
+    const resolve = (engine) => engine.backend ?? r.backend;
+    const withKroki = (type, local, engine) => {
+        if (resolve(engine) === 'kroki' && krokiSupports(type)) {
+            return createKrokiRenderer(type, r.kroki);
+        }
+        return local();
+    };
+    if (r.plantuml.enabled) {
+        registry.register('plantuml', withKroki('plantuml', () => createPlantUmlRenderer({
+            jarPath: r.plantuml.jar !== undefined ? path.resolve(config.rootDir, r.plantuml.jar) : undefined,
+            javaPath: r.plantuml.java,
+            maxHeap: r.plantuml.maxHeap,
+        }), r.plantuml), ALIASES['plantuml']);
+    }
+    if (r.mermaid.enabled) {
+        registry.register('mermaid', withKroki('mermaid', () => createMermaidRenderer({
+            browserPath: r.mermaid.browserPath,
+            ...(r.noSandbox !== undefined ? { noSandbox: r.noSandbox } : {}),
+        }), r.mermaid), ALIASES['mermaid']);
+    }
+    if (r.d2.enabled) {
+        registry.register('d2', withKroki('d2', () => createD2Renderer({ layout: r.d2.layout }), r.d2), ALIASES['d2']);
+    }
+    if (r.graphviz.enabled) {
+        registry.register('graphviz', withKroki('graphviz', () => createGraphvizRenderer({ engine: r.graphviz.engine }), r.graphviz), ALIASES['graphviz']);
+    }
+    if (r.vegaLite.enabled) {
+        registry.register('vega-lite', withKroki('vega-lite', () => createVegaLiteRenderer(), r.vegaLite), ALIASES['vega-lite']);
+    }
+    // LikeC4 es un renderer especializado; Kroki no lo cubre.
+    if (r.likec4.enabled) {
+        registry.register('likec4', createLikeC4Renderer(), ALIASES['likec4']);
+    }
+    // C4 dibujado con PlantUML: respaldo de LikeC4, sin dependencias adicionales.
+    if (r.plantuml.enabled) {
+        registry.register('plantuml-c4', createPlantUmlRenderer({
+            jarPath: r.plantuml.jar !== undefined ? path.resolve(config.rootDir, r.plantuml.jar) : undefined,
+            javaPath: r.plantuml.java,
+            maxHeap: r.plantuml.maxHeap,
+        }));
+    }
+    if (r.svgbob.enabled) {
+        registry.register('svgbob', createSvgbobRenderer(), ALIASES['svgbob']);
+    }
+    if (r.bpmn.enabled) {
+        registry.register('bpmn', createBpmnRenderer({
+            browserPath: r.bpmn.browserPath,
+            ...(r.noSandbox !== undefined ? { noSandbox: r.noSandbox } : {}),
+        }), ALIASES['bpmn']);
+    }
+    return registry;
+}
+export { createD2Renderer } from './d2.js';
+export { createGraphvizRenderer } from './graphviz.js';
+export { createKrokiRenderer, assertSafeKrokiUrl } from './kroki.js';
+export { createLikeC4Renderer } from './likec4.js';
+export { createMermaidRenderer } from './mermaid.js';
+export { createPlantUmlRenderer } from './plantuml.js';
+export { createVegaLiteRenderer } from './vega-lite.js';
+export { createSvgbobRenderer } from './svgbob.js';
+export { createBpmnRenderer } from './bpmn.js';
+//# sourceMappingURL=index.js.map

package/dist/renderers/index.js.map

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

package/dist/renderers/kroki.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Backend Kroki (opcional).
+ *
+ * Alternativa a los motores locales para quien ya opere un Kroki self-hosted.
+ * No es el modo por defecto y, salvo autorizacion explicita, rechaza cualquier
+ * host que no sea local: la documentacion tratada puede ser confidencial y
+ * enviarla a un servicio publico esta prohibido (seccion 12, puntos 1 y 2).
+ */
+import { type DiagramRenderer, type OutputFormat, type RenderOptions, type RenderResult } from '../core/types.js';
+export interface KrokiOptions {
+    url: string;
+    /** Permite apuntar a un host no local (Kroki corporativo en la intranet). */
+    allowRemoteHost?: boolean;
+    /** Autoriza explicitamente el servicio publico kroki.io. Desaconsejado. */
+    allowPublicService?: boolean;
+    headers?: Readonly<Record<string, string>>;
+}
+/**
+ * Verifica que la URL apunte a una instancia propia.
+ * Lanza `ConfigError` en el arranque, no en mitad del build.
+ */
+export declare function assertSafeKrokiUrl(rawUrl: string, options: KrokiOptions): URL;
+export declare class KrokiRenderer implements DiagramRenderer {
+    readonly type: string;
+    readonly defaultFormat: OutputFormat;
+    readonly supportedFormats: readonly OutputFormat[];
+    private readonly url;
+    private readonly krokiPath;
+    private readonly headers;
+    private cachedVersion?;
+    constructor(type: string, options: KrokiOptions);
+    version(): Promise<string>;
+    render(source: string, options: RenderOptions): Promise<RenderResult>;
+    private applyTheme;
+}
+export declare function createKrokiRenderer(type: string, options: KrokiOptions): DiagramRenderer;
+export declare function krokiSupports(type: string): boolean;
+//# sourceMappingURL=kroki.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kroki.d.ts","sourceRoot":"","sources":["../../src/renderers/kroki.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAgB1B,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,GAAG,CAwB7E;AAED,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAC;IAEnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,aAAa,CAAC,CAAS;gBAEnB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY;IAgBzC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAc1B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAyC3E,OAAO,CAAC,UAAU;CA6BnB;AAMD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,eAAe,CAExF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/renderers/kroki.js

@@ -0,0 +1,151 @@
+/**
+ * Backend Kroki (opcional).
+ *
+ * Alternativa a los motores locales para quien ya opere un Kroki self-hosted.
+ * No es el modo por defecto y, salvo autorizacion explicita, rechaza cualquier
+ * host que no sea local: la documentacion tratada puede ser confidencial y
+ * enviarla a un servicio publico esta prohibido (seccion 12, puntos 1 y 2).
+ */
+import { ConfigError, RenderError } from '../core/errors.js';
+import { MIME_TYPES, } from '../core/types.js';
+import { assertFormat, enforceSize, svgResult } from './base.js';
+import { applyTheme as applyGraphvizTheme } from './graphviz.js';
+/** Correspondencia entre el tipo de DocViz y la ruta de la API de Kroki. */
+const KROKI_PATHS = {
+    plantuml: 'plantuml',
+    mermaid: 'mermaid',
+    d2: 'd2',
+    graphviz: 'graphviz',
+    'vega-lite': 'vegalite',
+};
+const PUBLIC_HOSTS = new Set(['kroki.io', 'www.kroki.io']);
+const LOCAL_HOSTS = new Set(['localhost', '127.0.0.1', '::1', '0.0.0.0', 'kroki']);
+/**
+ * Verifica que la URL apunte a una instancia propia.
+ * Lanza `ConfigError` en el arranque, no en mitad del build.
+ */
+export function assertSafeKrokiUrl(rawUrl, options) {
+    let url;
+    try {
+        url = new URL(rawUrl);
+    }
+    catch {
+        throw new ConfigError(`renderers.kroki.url no es una URL valida: ${rawUrl}`);
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        throw new ConfigError(`renderers.kroki.url debe usar http o https, no ${url.protocol}`);
+    }
+    if (PUBLIC_HOSTS.has(url.hostname) && options.allowPublicService !== true) {
+        throw new ConfigError('el servicio publico kroki.io esta bloqueado por defecto', 'la documentacion puede ser confidencial; despliega Kroki self-hosted o activa renderers.kroki.allowPublicService de forma explicita');
+    }
+    const isLocal = LOCAL_HOSTS.has(url.hostname) || url.hostname.endsWith('.local');
+    if (!isLocal && options.allowRemoteHost !== true && options.allowPublicService !== true) {
+        throw new ConfigError(`renderers.kroki.url apunta a un host remoto (${url.hostname})`, 'activa renderers.kroki.allowRemoteHost si ese host es tu instancia self-hosted');
+    }
+    return url;
+}
+export class KrokiRenderer {
+    type;
+    defaultFormat;
+    supportedFormats;
+    url;
+    krokiPath;
+    headers;
+    cachedVersion;
+    constructor(type, options) {
+        const krokiPath = KROKI_PATHS[type];
+        if (krokiPath === undefined) {
+            throw new ConfigError(`Kroki no puede renderizar el tipo "${type}"`, `tipos soportados via Kroki: ${Object.keys(KROKI_PATHS).join(', ')}`);
+        }
+        this.type = type;
+        this.krokiPath = krokiPath;
+        this.url = assertSafeKrokiUrl(options.url, options);
+        this.headers = options.headers ?? {};
+        this.defaultFormat = 'svg';
+        this.supportedFormats = type === 'plantuml' ? ['svg', 'png'] : ['svg'];
+    }
+    async version() {
+        if (this.cachedVersion !== undefined)
+            return this.cachedVersion;
+        // Kroki expone su version en /health; si no responde, se usa el host como
+        // discriminante para que el hash siga siendo estable y reproducible.
+        try {
+            const res = await fetch(new URL('/health', this.url), { signal: AbortSignal.timeout(5_000) });
+            const body = (await res.json());
+            this.cachedVersion = `kroki-${body.version ?? 'desconocida'}-${this.type}`;
+        }
+        catch {
+            this.cachedVersion = `kroki-${this.url.host}-${this.type}`;
+        }
+        return this.cachedVersion;
+    }
+    async render(source, options) {
+        assertFormat(this.type, options.format, this.supportedFormats);
+        // El tema se aplica antes de salir del proceso: Kroki recibe el diagrama ya
+        // tematizado, igual que lo recibiria el motor local.
+        const payload = this.applyTheme(source, options);
+        const endpoint = new URL(`${trimSlash(this.url.pathname)}/${this.krokiPath}/${options.format}`, this.url);
+        let res;
+        try {
+            res = await fetch(endpoint, {
+                method: 'POST',
+                headers: { 'content-type': 'text/plain; charset=utf-8', ...this.headers },
+                body: payload,
+                signal: AbortSignal.timeout(options.timeoutMs),
+            });
+        }
+        catch (err) {
+            throw new RenderError(this.type, `no se pudo contactar con Kroki en ${endpoint.href}`, err instanceof Error ? err.message : String(err));
+        }
+        if (!res.ok) {
+            const detail = await res.text().catch(() => '');
+            throw new RenderError(this.type, `Kroki respondio ${res.status} ${res.statusText}`, detail.slice(0, 2_000));
+        }
+        const buffer = Buffer.from(await res.arrayBuffer());
+        if (options.format === 'png') {
+            enforceSize(this.type, buffer, options.maxOutputBytes);
+            return { format: 'png', content: buffer, mimeType: MIME_TYPES.png };
+        }
+        return svgResult(this.type, buffer.toString('utf8'), options);
+    }
+    applyTheme(source, options) {
+        const { theme } = options;
+        switch (this.type) {
+            case 'plantuml': {
+                const trimmed = source.trim();
+                const skin = theme.plantuml.skinparams.join('\n');
+                const open = /^@start[a-z]+\b.*$/im.exec(trimmed);
+                if (open === null)
+                    return `@startuml\n${skin}\n${trimmed}\n@enduml`;
+                const at = open.index + open[0].length;
+                return `${trimmed.slice(0, at)}\n${skin}\n${trimmed.slice(at)}`;
+            }
+            case 'graphviz':
+                return applyGraphvizTheme(source, theme);
+            case 'vega-lite': {
+                const spec = JSON.parse(source);
+                return JSON.stringify({
+                    width: theme.vegaLite.width,
+                    height: theme.vegaLite.height,
+                    ...spec,
+                    config: { ...theme.vegaLite.config, ...(spec['config'] ?? {}) },
+                });
+            }
+            case 'mermaid':
+            case 'd2':
+            default:
+                // Kroki no admite configuracion de tema por peticion para estos motores.
+                return source;
+        }
+    }
+}
+function trimSlash(p) {
+    return p.replace(/\/+$/, '');
+}
+export function createKrokiRenderer(type, options) {
+    return new KrokiRenderer(type, options);
+}
+export function krokiSupports(type) {
+    return type in KROKI_PATHS;
+}
+//# sourceMappingURL=kroki.js.map

package/dist/renderers/kroki.js.map

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

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

@@ -0,0 +1,82 @@
+/**
+ * Emisor SVG propio para vistas LikeC4.
+ *
+ * LikeC4 calcula el layout (posiciones, tamanos y curvas Bezier de cada
+ * relacion) mediante Graphviz; lo que no ofrece es un dibujado a SVG sin
+ * navegador. Este modulo toma la vista ya distribuida y la dibuja, de forma que
+ * el renderer LikeC4 sea tan offline como los demas y respete el tema del
+ * proyecto.
+ */
+import type { Theme } from '../themes/types.js';
+export interface LikeC4Point {
+    0: number;
+    1: number;
+}
+export interface LikeC4Node {
+    id: string;
+    parent: string | null;
+    level: number;
+    children: string[];
+    title: string;
+    description?: string | {
+        txt?: string;
+    } | null;
+    technology?: string | null;
+    shape?: string;
+    color?: string;
+    kind?: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    style?: {
+        opacity?: number;
+        size?: string;
+        border?: string;
+    };
+}
+export interface LikeC4Edge {
+    id: string;
+    source: string;
+    target: string;
+    label?: string | null;
+    points: Array<[number, number]>;
+    labelBBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    color?: string;
+    line?: 'solid' | 'dashed' | 'dotted' | string;
+    head?: string;
+    tail?: string;
+}
+export interface LikeC4View {
+    id: string;
+    title?: string | null;
+    description?: unknown;
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    nodes: LikeC4Node[];
+    edges: LikeC4Edge[];
+}
+export declare function renderLikeC4View(view: LikeC4View, theme: Theme): string;
+/** Ajuste de linea por palabras con truncado con elipsis al llegar al maximo. */
+export declare function wrap(text: string, maxWidth: number, size: number, maxLines: number): string[];
+/**
+ * Elige texto claro u oscuro segun la luminancia del relleno (WCAG).
+ *
+ * Devuelve neutros absolutos, no tokens de la paleta: el criterio es el
+ * contraste contra ese relleno concreto, y el relleno ya cambia entre el modo
+ * claro y el oscuro. Usar `primaryText` seria un error de significado —ese token
+ * es "texto sobre el color primario", que en la paleta oscura es oscuro.
+ */
+export declare function contrastText(fill: string, palette: Theme['palette']): string;
+/** Compone `fg` sobre `bg` con la opacidad dada y devuelve un color opaco. */
+export declare function blend(fg: string, bg: string, alpha: number): string;
+//# sourceMappingURL=likec4-svg.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"likec4-svg.d.ts","sourceRoot":"","sources":["../../src/renderers/likec4-svg.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhD,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAuDD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CA+BvE;AAiVD,iFAAiF;AACjF,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAwB7F;AAiBD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,CAS5E;AAED,8EAA8E;AAC9E,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMnE"}