docviz-builder 0.1.0

package/dist/core/registry.js

@@ -0,0 +1,72 @@
+/**
+ * Registro de renderers.
+ *
+ * El parser Markdown consulta este registro para saber que lenguajes son
+ * "compilables"; nunca importa un renderer concreto.
+ */
+import { UnknownRendererError } from './errors.js';
+export class RendererRegistry {
+    renderers = new Map();
+    /** Alias de lenguaje -> tipo canonico (`dot` -> `graphviz`, etc.). */
+    aliases = new Map();
+    register(type, renderer, aliases = []) {
+        const key = normalize(type);
+        this.renderers.set(key, renderer);
+        for (const alias of aliases)
+            this.aliases.set(normalize(alias), key);
+        return this;
+    }
+    unregister(type) {
+        const key = normalize(type);
+        for (const [alias, target] of this.aliases) {
+            if (target === key)
+                this.aliases.delete(alias);
+        }
+        return this.renderers.delete(key);
+    }
+    /** Resuelve alias y devuelve el tipo canonico, o `undefined` si no existe. */
+    resolve(type) {
+        const key = normalize(type);
+        if (this.renderers.has(key))
+            return key;
+        const aliased = this.aliases.get(key);
+        if (aliased !== undefined && this.renderers.has(aliased))
+            return aliased;
+        return undefined;
+    }
+    has(type) {
+        return this.resolve(type) !== undefined;
+    }
+    /** Devuelve el renderer o lanza `UnknownRendererError`. */
+    get(type) {
+        const canonical = this.resolve(type);
+        if (canonical === undefined)
+            throw new UnknownRendererError(type, this.types());
+        return this.renderers.get(canonical);
+    }
+    types() {
+        return [...this.renderers.keys()].sort();
+    }
+    /** Todos los lenguajes reconocidos en una valla de codigo, alias incluidos. */
+    languages() {
+        return [...new Set([...this.renderers.keys(), ...this.aliases.keys()])].sort();
+    }
+    async disposeAll() {
+        const errors = [];
+        for (const renderer of this.renderers.values()) {
+            try {
+                await renderer.dispose?.();
+            }
+            catch (err) {
+                errors.push(err);
+            }
+        }
+        if (errors.length > 0) {
+            throw new AggregateError(errors, 'fallo la liberacion de algun renderer');
+        }
+    }
+}
+function normalize(type) {
+    return type.trim().toLowerCase();
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Contratos publicos de DocViz Builder.
+ *
+ * El parser Markdown solo conoce estas interfaces; ningun detalle de PlantUML,
+ * Mermaid, D2, Vega-Lite, Graphviz o LikeC4 se filtra hacia arriba.
+ */
+import type { Theme } from '../themes/types.js';
+export type OutputFormat = 'svg' | 'png';
+export declare const MIME_TYPES: Record<OutputFormat, string>;
+/** Opciones que el builder entrega a cada renderer en cada invocacion. */
+export interface RenderOptions {
+    /** Formato pedido. El renderer debe fallar si no lo soporta. */
+    format: OutputFormat;
+    /** Tema resuelto del proyecto. */
+    theme: Theme;
+    /** Titulo del diagrama, util para `<title>` accesible dentro del SVG. */
+    title?: string;
+    /** Milisegundos maximos de render. Superarlo es un error, no un warning. */
+    timeoutMs: number;
+    /** Tamano maximo aceptado del recurso generado, en bytes. */
+    maxOutputBytes: number;
+}
+export interface RenderResult {
+    format: OutputFormat;
+    content: Buffer;
+    mimeType: string;
+}
+/**
+ * Un renderer traduce un lenguaje declarativo a una imagen.
+ *
+ * `version()` participa en el hash del recurso: si el motor cambia de version,
+ * los recursos cacheados se invalidan solos.
+ */
+export interface DiagramRenderer {
+    readonly type: string;
+    readonly defaultFormat: OutputFormat;
+    readonly supportedFormats: readonly OutputFormat[];
+    /** Identificador estable de la version del motor subyacente. */
+    version(): Promise<string>;
+    render(source: string, options: RenderOptions): Promise<RenderResult>;
+    /** Libera recursos persistentes (navegador, wasm, JVM). */
+    dispose?(): Promise<void>;
+}
+/** Un bloque declarativo detectado dentro de un documento Markdown. */
+export interface DiagramBlock {
+    /** Lenguaje de la valla: `plantuml`, `mermaid`, `diagram`, `chart`, ... */
+    lang: string;
+    /** Tipo de renderer final tras resolver el DSL de alto nivel. */
+    rendererType: string;
+    /** Codigo fuente que recibira el renderer. */
+    source: string;
+    /** Codigo fuente tal cual aparece en el documento (DSL sin compilar). */
+    rawSource: string;
+    /** Titulo usado como alt text y como base del nombre de archivo. */
+    title: string;
+    /** Formato pedido explicitamente en la valla, si lo hubo. */
+    requestedFormat?: OutputFormat;
+    /** Posicion en el documento fuente, para reemplazo quirurgico y errores. */
+    start: number;
+    end: number;
+    line: number;
+}
+export interface RenderedAsset {
+    /** Ruta relativa al directorio de salida, con separadores POSIX. */
+    relativePath: string;
+    absolutePath: string;
+    hash: string;
+    format: OutputFormat;
+    bytes: number;
+    fromCache: boolean;
+}
+export interface BuildStats {
+    documents: number;
+    blocks: number;
+    generated: number;
+    cacheHits: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,CAAC;AAEzC,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAGnD,CAAC;AAEF,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,MAAM,EAAE,YAAY,CAAC;IACrB,kCAAkC;IAClC,KAAK,EAAE,KAAK,CAAC;IACb,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAC;IACnD,gEAAgE;IAChE,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtE,2DAA2D;IAC3D,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/core/types.js

@@ -0,0 +1,11 @@
+/**
+ * Contratos publicos de DocViz Builder.
+ *
+ * El parser Markdown solo conoce estas interfaces; ningun detalle de PlantUML,
+ * Mermaid, D2, Vega-Lite, Graphviz o LikeC4 se filtra hacia arriba.
+ */
+export const MIME_TYPES = {
+    svg: 'image/svg+xml',
+    png: 'image/png',
+};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,CAAC,MAAM,UAAU,GAAiC;IACtD,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,WAAW;CACjB,CAAC"}

package/dist/dsl/architecture.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Bloque `architecture`: modelo C4 declarativo -> DSL LikeC4 -> SVG.
+ *
+ * El agente describe elementos y relaciones; DocViz escribe el LikeC4, incluida
+ * la especificacion de tipos y la vista.
+ */
+export interface CompiledArchitecture {
+    rendererType: 'likec4';
+    source: string;
+}
+export declare const ARCHITECTURE_TYPES: readonly ["c4-context", "c4-container", "c4-component", "c4-deployment", "context", "container", "component"];
+export declare function compileArchitecture(doc: Record<string, unknown>): CompiledArchitecture;
+/** Genera la fuente LikeC4 del modelo declarado. */
+export declare function architectureLikeC4(doc: Record<string, unknown>): string;
+//# sourceMappingURL=architecture.d.ts.map

package/dist/dsl/architecture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture.d.ts","sourceRoot":"","sources":["../../src/dsl/architecture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,QAAQ,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,kBAAkB,+GAQrB,CAAC;AAmDX,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,oBAAoB,CAEtF;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAuIvE"}

package/dist/dsl/architecture.js

@@ -0,0 +1,242 @@
+/**
+ * Bloque `architecture`: modelo C4 declarativo -> DSL LikeC4 -> SVG.
+ *
+ * El agente describe elementos y relaciones; DocViz escribe el LikeC4, incluida
+ * la especificacion de tipos y la vista.
+ */
+import { fail } from './util.js';
+import { asArrowShorthand, asRecord, likec4Label, optionalArray, optionalString, requireArray, requireString, toEdge, } from './util.js';
+export const ARCHITECTURE_TYPES = [
+    'c4-context',
+    'c4-container',
+    'c4-component',
+    'c4-deployment',
+    'context',
+    'container',
+    'component',
+];
+/** Clases de elemento admitidas y su forma LikeC4. */
+const ELEMENT_KINDS = {
+    person: { shape: 'person' },
+    actor: { shape: 'person' },
+    system: { shape: 'rectangle' },
+    'external-system': { shape: 'rectangle' },
+    container: { shape: 'rectangle' },
+    component: { shape: 'component' },
+    database: { shape: 'cylinder' },
+    queue: { shape: 'queue' },
+    storage: { shape: 'storage' },
+    browser: { shape: 'browser' },
+    mobile: { shape: 'mobile' },
+    service: { shape: 'rectangle' },
+};
+/** Alias del usuario -> clase canonica. */
+const KIND_ALIASES = {
+    usuario: 'person',
+    persona: 'person',
+    actor: 'actor',
+    sistema: 'system',
+    externo: 'external-system',
+    'sistema-externo': 'external-system',
+    contenedor: 'container',
+    componente: 'component',
+    'base-de-datos': 'database',
+    bd: 'database',
+    db: 'database',
+    cola: 'queue',
+    almacenamiento: 'storage',
+    navegador: 'browser',
+    movil: 'mobile',
+    servicio: 'service',
+};
+const COLORS = ['primary', 'secondary', 'muted', 'blue', 'green', 'amber', 'red', 'gray', 'indigo', 'sky', 'slate'];
+export function compileArchitecture(doc) {
+    return { rendererType: 'likec4', source: architectureLikeC4(doc) };
+}
+/** Genera la fuente LikeC4 del modelo declarado. */
+export function architectureLikeC4(doc) {
+    const type = (optionalString(doc, 'type') ?? 'c4-context').toLowerCase();
+    if (!ARCHITECTURE_TYPES.includes(type)) {
+        fail(`el tipo de arquitectura "${type}" no existe`, `tipos disponibles: ${ARCHITECTURE_TYPES.join(', ')}`);
+    }
+    const rawElements = requireArray(doc['elements'] ?? doc['nodes'], 'architecture.elements');
+    const rawRelations = optionalArray(doc['relations'] ?? doc['relationships'], 'architecture.relations');
+    const title = optionalString(doc, 'title');
+    const elements = new Map();
+    const order = [];
+    for (const raw of rawElements) {
+        const record = asRecord(raw, 'architecture.elements');
+        const name = requireString(record, 'name', 'architecture.elements');
+        const id = sanitizeId(optionalString(record, 'id') ?? name, elements);
+        const kind = normalizeKind(optionalString(record, 'kind') ?? 'system');
+        const element = { id, kind, name, children: [] };
+        const description = optionalString(record, 'description');
+        if (description !== undefined)
+            element.description = description;
+        const technology = optionalString(record, 'technology') ?? optionalString(record, 'tech');
+        if (technology !== undefined)
+            element.technology = technology;
+        const color = optionalString(record, 'color');
+        if (color !== undefined) {
+            if (!COLORS.includes(color.toLowerCase())) {
+                fail(`el color "${color}" no existe`, `colores validos: ${COLORS.join(', ')}`);
+            }
+            element.color = color.toLowerCase();
+        }
+        const parent = optionalString(record, 'parent');
+        if (parent !== undefined)
+            element.parent = parent;
+        elements.set(id, element);
+        order.push(id);
+    }
+    // Resolucion de jerarquia: `parent` puede referirse al id o al nombre.
+    const byName = new Map();
+    for (const element of elements.values())
+        byName.set(element.name, element);
+    const roots = [];
+    for (const id of order) {
+        const element = elements.get(id);
+        if (element.parent === undefined) {
+            roots.push(element);
+            continue;
+        }
+        const parent = elements.get(element.parent) ?? byName.get(element.parent);
+        if (parent === undefined) {
+            fail(`el elemento padre "${element.parent}" de "${element.name}" no existe`, `elementos declarados: ${[...elements.values()].map((e) => e.name).join(', ')}`);
+        }
+        if (parent === element)
+            fail(`el elemento "${element.name}" no puede ser su propio padre`);
+        parent.children.push(element);
+    }
+    assertNoCycles(roots, elements.size);
+    // Especificacion: solo las clases realmente usadas.
+    const usedKinds = [...new Set([...elements.values()].map((e) => e.kind))].sort();
+    const lines = ['specification {'];
+    for (const kind of usedKinds) {
+        const shape = ELEMENT_KINDS[kind].shape;
+        // `size sm` evita cajas de 320x180 con una sola palabra dentro: un
+        // contexto C4 de tres elementos cabe asi en una pantalla.
+        lines.push(`  element ${kind} {`, '    style {', `      shape ${shape}`, '      size sm', '    }', '  }');
+    }
+    lines.push('}', '', 'model {');
+    const fqnOf = new Map();
+    const containersWithChildren = [];
+    const emit = (element, indent, prefix) => {
+        const fqn = prefix === '' ? element.id : `${prefix}.${element.id}`;
+        fqnOf.set(element.id, fqn);
+        fqnOf.set(element.name, fqn);
+        if (element.children.length > 0)
+            containersWithChildren.push(fqn);
+        lines.push(`${indent}${element.id} = ${element.kind} ${likec4Label(element.name)} {`);
+        if (element.description !== undefined)
+            lines.push(`${indent}  description ${likec4Label(element.description)}`);
+        if (element.technology !== undefined)
+            lines.push(`${indent}  technology ${likec4Label(element.technology)}`);
+        if (element.color !== undefined) {
+            lines.push(`${indent}  style {`, `${indent}    color ${element.color}`, `${indent}  }`);
+        }
+        // Los hijos se emiten dentro del cuerpo del padre: asi LikeC4 los dibuja
+        // como elementos contenidos y no como cajas sueltas.
+        for (const child of element.children)
+            emit(child, `${indent}  `, fqn);
+        lines.push(`${indent}}`);
+    };
+    for (const root of roots)
+        emit(root, '  ', '');
+    lines.push('');
+    for (const raw of rawRelations) {
+        // `- Usuario -> Core: Utiliza` llega como cadena o, si YAML vio los dos
+        // puntos, como mapa de una entrada. Ambas se normalizan igual que la forma
+        // explicita `{from, to, label}`.
+        const relation = toRelationRecord(raw);
+        const from = resolveRef(fqnOf, requireString(relation, 'from', 'architecture.relations'), 'from');
+        const to = resolveRef(fqnOf, requireString(relation, 'to', 'architecture.relations'), 'to');
+        const label = optionalString(relation, 'label') ?? optionalString(relation, 'text');
+        const technology = optionalString(relation, 'technology') ?? optionalString(relation, 'tech');
+        if (technology !== undefined) {
+            lines.push(`  ${from} -> ${to} ${likec4Label(label ?? '')} {`);
+            lines.push(`    technology ${likec4Label(technology)}`);
+            lines.push('  }');
+        }
+        else {
+            lines.push(`  ${from} -> ${to}${label !== undefined ? ` ${likec4Label(label)}` : ''}`);
+        }
+    }
+    lines.push('}', '', 'views {', '  view index {');
+    if (title !== undefined)
+        lines.push(`    title ${likec4Label(title)}`);
+    const direction = optionalString(doc, 'direction');
+    if (direction !== undefined) {
+        const valid = ['TopBottom', 'BottomTop', 'LeftRight', 'RightLeft'];
+        const normalized = valid.find((v) => v.toLowerCase() === direction.replace(/[-_]/g, '').toLowerCase());
+        if (normalized === undefined) {
+            fail(`la direccion "${direction}" no existe`, `direcciones validas: ${valid.join(', ')}`);
+        }
+        lines.push(`    autoLayout ${normalized}`);
+    }
+    lines.push('    include *');
+    // `include *` de LikeC4 solo trae el primer nivel: sin esto, un modelo con
+    // contenedores anidados se dibujaria como una unica caja vacia.
+    for (const fqn of containersWithChildren)
+        lines.push(`    include ${fqn}.**`);
+    lines.push('  }', '}');
+    return lines.join('\n');
+}
+/** Normaliza cualquiera de las formas admitidas de relacion a `{from,to,label}`. */
+function toRelationRecord(raw) {
+    if (typeof raw === 'string' || asArrowShorthand(raw) !== undefined) {
+        const edge = toEdge(raw, 'architecture.relations');
+        const record = { from: edge.from, to: edge.to };
+        if (edge.label !== undefined)
+            record['label'] = edge.label;
+        return record;
+    }
+    return asRecord(raw, 'architecture.relations');
+}
+function resolveRef(fqnOf, ref, field) {
+    const fqn = fqnOf.get(ref);
+    if (fqn === undefined) {
+        fail(`"${ref}" no corresponde a ningun elemento declarado (${field})`, `referencias validas: ${[...new Set(fqnOf.keys())].join(', ')}`);
+    }
+    return fqn;
+}
+function normalizeKind(kind) {
+    const normalized = kind.trim().toLowerCase().replace(/\s+/g, '-');
+    const canonical = KIND_ALIASES[normalized] ?? normalized;
+    if (ELEMENT_KINDS[canonical] === undefined) {
+        fail(`la clase de elemento "${kind}" no existe`, `clases validas: ${Object.keys(ELEMENT_KINDS).join(', ')}`);
+    }
+    return canonical;
+}
+/** Identificadores LikeC4: letra inicial, despues letras, digitos y `_`. */
+function sanitizeId(raw, existing) {
+    let id = raw
+        .normalize('NFD')
+        .replace(/[̀-ͯ]/g, '')
+        .replace(/[^A-Za-z0-9_]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+    if (id === '' || /^[0-9]/.test(id))
+        id = `e_${id}`;
+    if (!existing.has(id))
+        return id;
+    let n = 2;
+    while (existing.has(`${id}_${n}`))
+        n += 1;
+    return `${id}_${n}`;
+}
+function assertNoCycles(roots, total) {
+    let visited = 0;
+    const walk = (element, depth) => {
+        if (depth > 32)
+            fail('la jerarquia de elementos es demasiado profunda o tiene un ciclo');
+        visited += 1;
+        for (const child of element.children)
+            walk(child, depth + 1);
+    };
+    for (const root of roots)
+        walk(root, 0);
+    if (visited !== total) {
+        fail('hay elementos con una relacion de padre ciclica', 'revisa los campos "parent"');
+    }
+}
+//# sourceMappingURL=architecture.js.map

package/dist/dsl/architecture.js.map

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

package/dist/dsl/catalog.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Catalogo de tipos del DSL.
+ *
+ * Es la fuente unica de verdad: que motor atiende cada intencion, con que
+ * alternativa si ese motor no esta disponible, para que sirve y cuando NO
+ * conviene usarlo.
+ *
+ * Los tres ultimos campos no son documentacion decorativa. El consumidor
+ * habitual del catalogo es un modelo de lenguaje decidiendo como explicar algo:
+ * "cuando no usarlo" evita la mitad de los errores, y un esqueleto minimo evita
+ * la otra mitad.
+ */
+export type DslLang = 'diagram' | 'chart' | 'architecture';
+export interface TypeSpec {
+    /** Nombre canonico del tipo. */
+    readonly type: string;
+    /** Valla en la que se declara. */
+    readonly lang: DslLang;
+    /** Motor preferido. */
+    readonly engine: string;
+    /**
+     * Motores alternativos, en orden de preferencia.
+     *
+     * Permiten compilar en una maquina sin navegador o sin Java: el tipo se
+     * resuelve con el siguiente motor disponible en lugar de abortar el build.
+     * Un tipo sin alternativas depende de su motor.
+     */
+    readonly fallbacks?: readonly string[];
+    /** Sinonimos aceptados en `type`. */
+    readonly aliases?: readonly string[];
+    /** Que muestra el diagrama, en una linea. */
+    readonly purpose: string;
+    /** Situacion en la que es la eleccion correcta. */
+    readonly whenToUse: string;
+    /** Situacion en la que conviene otro tipo, u ninguno. */
+    readonly whenNotToUse: string;
+    /**
+     * La misma ficha en ingles.
+     *
+     * No es cortesia: la puntuacion de `docviz suggest` mide la peticion contra
+     * la prosa del catalogo, y con la prosa solo en español una peticion en
+     * ingles se quedaba sin esa señal. Medido sobre el banco de casos, el hueco
+     * entre idiomas era de siete puntos.
+     */
+    readonly en?: {
+        readonly purpose: string;
+        readonly whenToUse: string;
+        readonly whenNotToUse: string;
+    };
+    /** Esqueleto minimo que compila tal cual. */
+    readonly example: string;
+    /** Palabras clave para la busqueda de `docviz_suggest`. */
+    readonly keywords: readonly string[];
+}
+export declare const TYPE_CATALOG: readonly TypeSpec[];
+/** Busca un tipo por su nombre canonico o por cualquiera de sus alias. */
+export declare function findType(name: string): TypeSpec | undefined;
+export declare function typesFor(lang: DslLang): TypeSpec[];
+export declare function typeNames(lang: DslLang): string[];
+/** Todos los nombres aceptados, alias incluidos. */
+export declare function allTypeNames(): string[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/dsl/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/dsl/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,uBAAuB;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,qCAAqC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE;QACZ,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAkiCD,eAAO,MAAM,YAAY,EAAE,SAAS,QAAQ,EAG1C,CAAC;AAQH,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAE3D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,EAAE,CAElD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAIjD;AAED,oDAAoD;AACpD,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC"}

package/dist/dsl/catalog.en.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Ficha de cada tipo en ingles.
+ *
+ * Vive aparte del catalogo para que la traduccion se pueda revisar de un
+ * vistazo, y para que anadir un idioma no obligue a tocar las 57 definiciones.
+ *
+ * No es documentacion decorativa: `docviz suggest` puntua la peticion contra
+ * esta prosa igual que contra la española, asi que una peticion en ingles deja
+ * de depender solo de las palabras clave. Una prueba comprueba que no falte
+ * ningun tipo.
+ */
+export interface TypeSpecEn {
+    readonly purpose: string;
+    readonly whenToUse: string;
+    readonly whenNotToUse: string;
+}
+export declare const CATALOG_EN: Readonly<Record<string, TypeSpecEn>>;
+//# sourceMappingURL=catalog.en.d.ts.map

package/dist/dsl/catalog.en.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.en.d.ts","sourceRoot":"","sources":["../../src/dsl/catalog.en.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CA8R3D,CAAC"}