docviz-builder 0.1.0

package/dist/build/diff.js

@@ -0,0 +1,156 @@
+/**
+ * Comparacion de dos arboles de documentos.
+ *
+ * Responde a una pregunta que el build no responde: **que diagramas cambiaron**
+ * entre dos versiones de la documentacion. En una revision de codigo, el
+ * diff de un `.md` muestra que se toco un bloque YAML, pero no si el dibujo
+ * resultante es distinto; y el nombre del recurso generado cambia tambien
+ * cuando solo cambio el tema o la version del motor.
+ *
+ * Por eso la identidad que se compara aqui no es la del recurso, sino la del
+ * contenido efectivo: `motor + fuente compilada`. Un cambio de tema no aparece
+ * como cambio de diagrama, y reordenar el YAML sin alterar el resultado
+ * tampoco.
+ */
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fingerprint } from '../core/hash.js';
+import { toPosix } from '../core/paths.js';
+import { compileDsl, DSL_LANGUAGES } from '../dsl/index.js';
+import { scanDocument } from '../markdown/scan.js';
+import { buildRegistry } from '../renderers/index.js';
+import { collectMarkdown } from './builder.js';
+/**
+ * Compara los diagramas de `baseDir` con los de `headDir`.
+ *
+ * No renderiza: compila el DSL y se queda con la fuente que recibiria el motor.
+ * Un lado invalido no aborta la comparacion —la version antigua puede estar
+ * rota y aun asi interesa saber que cambio— pero sus bloques se reportan.
+ */
+export async function diff(config, baseDir, headDir) {
+    const registry = buildRegistry(config);
+    try {
+        const base = await inventory(baseDir, registry, 'base');
+        const head = await inventory(headDir, registry, 'head');
+        const entries = [];
+        const summary = { added: 0, removed: 0, changed: 0, unchanged: 0 };
+        for (const [key, headEntry] of head.entries) {
+            const baseEntry = base.entries.get(key);
+            if (baseEntry === undefined) {
+                entries.push({ status: 'added', ...describe(headEntry), headHash: headEntry.hash });
+                summary.added += 1;
+                continue;
+            }
+            if (baseEntry.hash === headEntry.hash && baseEntry.engine === headEntry.engine) {
+                entries.push({
+                    status: 'unchanged',
+                    ...describe(headEntry),
+                    baseHash: baseEntry.hash,
+                    headHash: headEntry.hash,
+                });
+                summary.unchanged += 1;
+                continue;
+            }
+            entries.push({
+                status: 'changed',
+                ...describe(headEntry),
+                ...(baseEntry.engine !== headEntry.engine ? { previousEngine: baseEntry.engine } : {}),
+                baseHash: baseEntry.hash,
+                headHash: headEntry.hash,
+            });
+            summary.changed += 1;
+        }
+        for (const [key, baseEntry] of base.entries) {
+            if (head.entries.has(key))
+                continue;
+            entries.push({ status: 'removed', ...describe(baseEntry), baseHash: baseEntry.hash });
+            summary.removed += 1;
+        }
+        entries.sort((a, b) => (a.file === b.file ? a.line - b.line : a.file < b.file ? -1 : 1));
+        return {
+            base: toPosix(baseDir),
+            head: toPosix(headDir),
+            entries,
+            issues: [...base.issues, ...head.issues],
+            summary,
+        };
+    }
+    finally {
+        await registry.disposeAll().catch(() => undefined);
+    }
+}
+/** `true` si algo cambio entre las dos versiones. */
+export function hasChanges(result) {
+    return result.summary.added + result.summary.removed + result.summary.changed > 0;
+}
+function describe(entry) {
+    return { file: entry.file, title: entry.title, line: entry.line, lang: entry.lang, engine: entry.engine };
+}
+/**
+ * Recorre un directorio y devuelve sus diagramas indexados.
+ *
+ * La clave es `archivo::titulo::repeticion`. Usar el titulo y no la linea es
+ * deliberado: insertar un parrafo desplaza todos los bloques del documento, y
+ * un diff que marca doce diagramas como nuevos por eso no sirve de nada.
+ */
+async function inventory(dir, registry, side) {
+    const entries = new Map();
+    const issues = [];
+    const files = await collectMarkdown(dir);
+    for (const file of files) {
+        const relative = toPosix(path.relative(dir, file));
+        const text = await readFile(file, 'utf8');
+        const scanned = scanDocument(text, {
+            resolveLanguage: (lang) => registry.resolve(lang),
+            compileDsl: (lang, source) => compileDsl(lang, source, (engine) => registry.has(engine)),
+            dslLanguages: DSL_LANGUAGES,
+        });
+        for (const issue of scanned.errors) {
+            issues.push({
+                side,
+                file: relative,
+                line: issue.line,
+                message: issue.error instanceof Error ? issue.error.message : String(issue.error),
+            });
+        }
+        const seen = new Map();
+        for (const block of scanned.blocks) {
+            const base = `${relative}::${block.title}`;
+            const occurrence = (seen.get(base) ?? 0) + 1;
+            seen.set(base, occurrence);
+            entries.set(`${base}::${occurrence}`, {
+                file: relative,
+                title: block.title,
+                line: block.line,
+                lang: block.lang,
+                engine: block.rendererType,
+                hash: fingerprint({ engine: block.rendererType, source: block.source }),
+            });
+        }
+    }
+    return { entries, issues };
+}
+/** Reporte legible, en el orden en que aparecen los documentos. */
+export function formatDiff(result, options = {}) {
+    const marks = { added: '+', removed: '-', changed: '~', unchanged: ' ' };
+    const shown = result.entries.filter((e) => options.all === true || e.status !== 'unchanged');
+    const lines = ['', `base: ${result.base}`, `head: ${result.head}`, ''];
+    if (shown.length === 0) {
+        lines.push('  sin cambios en los diagramas');
+    }
+    else {
+        const width = Math.max(...shown.map((e) => `${e.file}:${e.line}`.length));
+        for (const entry of shown) {
+            const motor = entry.previousEngine === undefined ? entry.engine : `${entry.previousEngine} -> ${entry.engine}`;
+            lines.push(`  ${marks[entry.status]} ${`${entry.file}:${entry.line}`.padEnd(width)}  "${entry.title}"  (${entry.lang}, ${motor})`);
+        }
+    }
+    const { added, removed, changed, unchanged } = result.summary;
+    lines.push('', `resumen: ${added} nuevo(s), ${removed} eliminado(s), ${changed} modificado(s), ${unchanged} igual(es)`);
+    for (const issue of result.issues) {
+        lines.push(`AVISO [${issue.side}] ${issue.file}:${issue.line} no se pudo interpretar: ${issue.message}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=diff.js.map

package/dist/build/diff.js.map

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

package/dist/build/doctor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Diagnostico del entorno.
+ *
+ * Con el sistema de respaldos, "esta instalado" dejo de ser una respuesta de si
+ * o no: sin Java hay tipos que se dibujan igual con otro motor, otros que se
+ * degradan y otros que no se pueden dibujar. Este comando dice exactamente cual
+ * es cual, en lugar de dejar que se descubra cuando falla un build.
+ */
+import type { DocVizConfig } from '../config/types.js';
+export type Estado = 'ok' | 'ausente' | 'no-usado';
+export interface Requisito {
+    nombre: string;
+    estado: Estado;
+    detalle: string;
+    /** Que hacer si falta. */
+    remedio?: string;
+}
+export interface DiagnosticoTipo {
+    tipo: string;
+    motorPreferido: string;
+    /** Motor que se usaria ahora mismo, o `undefined` si ninguno esta disponible. */
+    motorEfectivo?: string;
+}
+export interface Diagnostico {
+    requisitos: Requisito[];
+    motoresDisponibles: string[];
+    motoresAusentes: string[];
+    /** Tipos que se dibujarian con su motor preferido. */
+    intactos: DiagnosticoTipo[];
+    /** Tipos que caerian a un respaldo: se dibujan, con otro aspecto. */
+    degradados: DiagnosticoTipo[];
+    /** Tipos que hoy no se pueden dibujar. */
+    imposibles: DiagnosticoTipo[];
+    ok: boolean;
+}
+export declare function diagnosticar(config: DocVizConfig): Promise<Diagnostico>;
+/** Informe legible del diagnostico. */
+export declare function formatearDiagnostico(d: Diagnostico): string;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/build/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,qEAAqE;IACrE,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,0CAA0C;IAC1C,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,EAAE,EAAE,OAAO,CAAC;CACb;AAqBD,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA6G7E;AAQD,uCAAuC;AACvC,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CA6C3D"}

package/dist/build/doctor.js

@@ -0,0 +1,190 @@
+/**
+ * Diagnostico del entorno.
+ *
+ * Con el sistema de respaldos, "esta instalado" dejo de ser una respuesta de si
+ * o no: sin Java hay tipos que se dibujan igual con otro motor, otros que se
+ * degradan y otros que no se pueden dibujar. Este comando dice exactamente cual
+ * es cual, en lugar de dejar que se descubra cuando falla un build.
+ */
+import { access, constants } from 'node:fs/promises';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { TYPE_CATALOG } from '../dsl/index.js';
+import { compilerEngines } from '../dsl/compile.js';
+import { buildRegistry } from '../renderers/index.js';
+import { findBrowser } from '../renderers/browser.js';
+import { resolveJarPath } from '../renderers/plantuml.js';
+import { resolveFromRoot } from '../config/load.js';
+const run = promisify(execFile);
+async function existe(ruta) {
+    try {
+        await access(ruta, constants.R_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function versionDeJava(ejecutable) {
+    try {
+        // Java escribe su version en stderr, no en stdout.
+        const { stderr } = await run(ejecutable, ['-version'], { timeout: 20_000 });
+        return stderr.split('\n')[0]?.trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function diagnosticar(config) {
+    const requisitos = [];
+    const r = config.renderers;
+    requisitos.push({
+        nombre: 'Node.js',
+        estado: 'ok',
+        detalle: process.version,
+    });
+    // --- Java y PlantUML ---
+    const java = r.plantuml.java ?? process.env['DOCVIZ_JAVA'] ?? 'java';
+    const versionJava = r.plantuml.enabled ? await versionDeJava(java) : undefined;
+    if (!r.plantuml.enabled) {
+        requisitos.push({ nombre: 'Java', estado: 'no-usado', detalle: 'PlantUML esta deshabilitado' });
+    }
+    else if (versionJava !== undefined) {
+        requisitos.push({ nombre: 'Java', estado: 'ok', detalle: versionJava });
+    }
+    else {
+        requisitos.push({
+            nombre: 'Java',
+            estado: 'ausente',
+            detalle: `no se pudo ejecutar "${java}"`,
+            remedio: 'instala un JRE 8 o superior, o define renderers.plantuml.java',
+        });
+    }
+    // La ruta tiene que ser la misma que usara el renderer. Resolverla aqui
+    // contra la raiz del proyecto daba un falso negativo en todo proyecto que
+    // instale DocViz: el jar viaja dentro del paquete, no del proyecto.
+    const jar = r.plantuml.jar !== undefined ? resolveFromRoot(config, r.plantuml.jar) : resolveJarPath();
+    if (!r.plantuml.enabled) {
+        requisitos.push({ nombre: 'plantuml.jar', estado: 'no-usado', detalle: 'PlantUML esta deshabilitado' });
+    }
+    else if (await existe(jar)) {
+        requisitos.push({ nombre: 'plantuml.jar', estado: 'ok', detalle: jar });
+    }
+    else {
+        requisitos.push({
+            nombre: 'plantuml.jar',
+            estado: 'ausente',
+            detalle: `no esta en ${jar}`,
+            remedio: 'ejecuta `npx docviz setup`, o define renderers.plantuml.jar',
+        });
+    }
+    // --- Navegador ---
+    const necesitaNavegador = r.mermaid.enabled || r.bpmn.enabled;
+    const navegador = findBrowser(r.mermaid.browserPath ?? r.bpmn.browserPath);
+    if (!necesitaNavegador) {
+        requisitos.push({
+            nombre: 'Chromium',
+            estado: 'no-usado',
+            detalle: 'Mermaid y BPMN estan deshabilitados',
+        });
+    }
+    else if (navegador !== undefined) {
+        requisitos.push({ nombre: 'Chromium', estado: 'ok', detalle: navegador });
+    }
+    else {
+        requisitos.push({
+            nombre: 'Chromium',
+            estado: 'ausente',
+            detalle: 'no se encontro ningun navegador',
+            remedio: 'instala Google Chrome, exporta DOCVIZ_BROWSER_PATH o ejecuta `npx playwright install chromium`',
+        });
+    }
+    // --- Que motores quedan realmente utilizables ---
+    const registry = buildRegistry(config);
+    const registrados = new Set(registry.types());
+    await registry.disposeAll().catch(() => undefined);
+    const utilizable = (motor) => {
+        if (!registrados.has(motor))
+            return false;
+        if (motor === 'plantuml' || motor === 'plantuml-c4') {
+            return versionJava !== undefined && requisitos.some((q) => q.nombre === 'plantuml.jar' && q.estado === 'ok');
+        }
+        if (motor === 'mermaid' || motor === 'bpmn')
+            return navegador !== undefined;
+        return true;
+    };
+    const motoresDisponibles = [...registrados].filter(utilizable).sort();
+    const motoresAusentes = [...registrados].filter((m) => !utilizable(m)).sort();
+    const intactos = [];
+    const degradados = [];
+    const imposibles = [];
+    for (const spec of TYPE_CATALOG) {
+        // Solo cuentan los respaldos que ademas tienen compilador propio.
+        const conCompilador = compilerEngines(spec.type);
+        const candidatos = [spec.engine, ...(spec.fallbacks ?? [])].filter((m) => spec.lang === 'chart' || conCompilador.includes(m));
+        const efectivo = candidatos.find(utilizable);
+        const entrada = { tipo: spec.type, motorPreferido: spec.engine };
+        if (efectivo !== undefined)
+            entrada.motorEfectivo = efectivo;
+        if (efectivo === undefined)
+            imposibles.push(entrada);
+        else if (efectivo === spec.engine)
+            intactos.push(entrada);
+        else
+            degradados.push(entrada);
+    }
+    return {
+        requisitos,
+        motoresDisponibles,
+        motoresAusentes,
+        intactos,
+        degradados,
+        imposibles,
+        ok: imposibles.length === 0,
+    };
+}
+const SIMBOLO = {
+    ok: 'ok  ',
+    ausente: 'FALTA',
+    'no-usado': '-   ',
+};
+/** Informe legible del diagnostico. */
+export function formatearDiagnostico(d) {
+    const lineas = ['', 'Entorno', ''];
+    const ancho = Math.max(...d.requisitos.map((q) => q.nombre.length));
+    for (const q of d.requisitos) {
+        lineas.push(`  ${SIMBOLO[q.estado]}  ${q.nombre.padEnd(ancho)}  ${q.detalle}`);
+        if (q.remedio !== undefined)
+            lineas.push(`         ${' '.repeat(ancho)}  -> ${q.remedio}`);
+    }
+    lineas.push('', 'Motores', '');
+    lineas.push(`  disponibles: ${d.motoresDisponibles.join(', ') || 'ninguno'}`);
+    if (d.motoresAusentes.length > 0)
+        lineas.push(`  no usables:  ${d.motoresAusentes.join(', ')}`);
+    lineas.push('', 'Tipos', '');
+    lineas.push(`  ${String(d.intactos.length).padStart(3)}  se dibujan con su motor preferido`);
+    if (d.degradados.length > 0) {
+        lineas.push(`  ${String(d.degradados.length).padStart(3)}  usaran su respaldo:`);
+        for (const t of d.degradados) {
+            lineas.push(`         ${t.tipo} (${t.motorPreferido} -> ${t.motorEfectivo})`);
+        }
+    }
+    if (d.imposibles.length > 0) {
+        lineas.push(`  ${String(d.imposibles.length).padStart(3)}  no se pueden dibujar:`);
+        // Se agrupan por motor: la accion que los arregla es la misma para todos.
+        const porMotor = new Map();
+        for (const t of d.imposibles) {
+            const lista = porMotor.get(t.motorPreferido) ?? [];
+            lista.push(t.tipo);
+            porMotor.set(t.motorPreferido, lista);
+        }
+        for (const [motor, tipos] of porMotor) {
+            lineas.push(`         ${motor}: ${tipos.join(', ')}`);
+        }
+    }
+    lineas.push('', d.ok
+        ? 'Todo el catalogo se puede dibujar.'
+        : 'Falta algo del entorno: los tipos de arriba fallarian al compilar.', '');
+    return lineas.join('\n');
+}
+//# sourceMappingURL=doctor.js.map

package/dist/build/doctor.js.map

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

package/dist/build/init.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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.
+ */
+export interface InitOptions {
+    /** Raiz del proyecto donde se escribe. */
+    cwd: string;
+    /** Tema inicial. */
+    theme: string;
+    /** Sobrescribe los archivos que ya existan. */
+    force: boolean;
+}
+export interface InitResult {
+    creados: string[];
+    omitidos: string[];
+    /** Scripts que habria que anadir a package.json, si falta alguno. */
+    scriptsPendientes: Array<[string, string]>;
+}
+/** Scripts que forman el flujo de trabajo documentado. */
+export declare const SCRIPTS: ReadonlyArray<readonly [string, string]>;
+export declare function init(options: InitOptions): Promise<InitResult>;
+/** Informe legible de lo que hizo `init`. */
+export declare function formatearInit(result: InitResult, theme: string): string;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/build/init.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,qEAAqE;IACrE,iBAAiB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5C;AAED,0DAA0D;AAC1D,eAAO,MAAM,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAM5D,CAAC;AA4LF,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAgDpE;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAgCvE"}