docviz-builder 0.1.0

package/dist/dsl/util.js

@@ -0,0 +1,261 @@
+/**
+ * Utilidades de validacion del DSL declarativo.
+ *
+ * Los mensajes son la interfaz real del DSL para un agente: deben decir que
+ * campo falla, que se esperaba y como se escribe bien.
+ */
+import { DslValidationError, ERROR_CODES } from '../core/errors.js';
+import { observarAnidado } from './fields.js';
+/**
+ * Aborta la compilacion del bloque.
+ *
+ * El codigo es tan importante como el texto: un agente que reintenta necesita
+ * distinguir "falta un campo" de "el valor no vale" sin leer castellano.
+ */
+export function fail(message, detail, code = ERROR_CODES.DSL) {
+    throw new DslValidationError(message, detail, code);
+}
+export function asRecord(value, field) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        fail(`${field} debe ser un mapa`, `valor recibido: ${preview(value)}`, ERROR_CODES.DSL_FIELD_TYPE);
+    }
+    // Todo mapa anidado se entrega observado: es la unica forma de saber si el
+    // compilador llego a leer sus claves o si el autor escribio en el vacio.
+    return observarAnidado(value, field);
+}
+/**
+ * Texto obligatorio.
+ *
+ * Acepta numeros y booleanos porque YAML los convierte sin avisar: en
+ * `- name: 2025` el valor llega como numero, y rechazarlo obligaria al autor a
+ * entrecomillar cualquier etiqueta que parezca un dato.
+ */
+export function requireString(record, key, field) {
+    const value = record[key];
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    if (typeof value !== 'string' || value.trim() === '') {
+        fail(`falta el campo obligatorio "${key}" en ${field}`, `valor recibido: ${preview(value)}`, ERROR_CODES.DSL_FIELD_MISSING);
+    }
+    return value.trim();
+}
+export function optionalString(record, key) {
+    const value = record[key];
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed === '' ? undefined : trimmed;
+}
+export function optionalNumber(record, key, field) {
+    const value = record[key];
+    if (value === undefined || value === null)
+        return undefined;
+    const n = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(n)) {
+        fail(`${field}.${key} debe ser numerico`, `valor recibido: ${preview(value)}`, ERROR_CODES.DSL_FIELD_TYPE);
+    }
+    return n;
+}
+export function requireNumber(record, key, field) {
+    const n = optionalNumber(record, key, field);
+    if (n === undefined) {
+        fail(`falta el campo numerico obligatorio "${key}" en ${field}`, undefined, ERROR_CODES.DSL_FIELD_MISSING);
+    }
+    return n;
+}
+export function requireArray(value, field) {
+    if (!Array.isArray(value) || value.length === 0) {
+        fail(`${field} debe ser una lista con al menos un elemento`, `valor recibido: ${preview(value)}`, ERROR_CODES.DSL_FIELD_MISSING);
+    }
+    return value;
+}
+export function optionalArray(value, field) {
+    if (value === undefined || value === null)
+        return [];
+    if (!Array.isArray(value)) {
+        fail(`${field} debe ser una lista`, `valor recibido: ${preview(value)}`, ERROR_CODES.DSL_FIELD_TYPE);
+    }
+    return value;
+}
+/**
+ * Acepta `- Texto` o `- name: Texto` de forma indistinta.
+ *
+ * Los numeros se admiten porque YAML los convierte solo: en `quadrants: [1, 2]`
+ * el autor esta escribiendo etiquetas, no cantidades.
+ */
+export function nameOf(item, field, key = 'name') {
+    if (typeof item === 'number' || typeof item === 'boolean')
+        return String(item);
+    if (typeof item === 'string') {
+        const t = item.trim();
+        if (t === '')
+            fail(`${field} contiene un elemento vacio`, undefined, ERROR_CODES.DSL_FIELD_MISSING);
+        return t;
+    }
+    const record = asRecord(item, field);
+    return requireString(record, key, field);
+}
+/**
+ * Normaliza `- Texto` y `- {name: Texto, ...}` a un mapa.
+ *
+ * Es el patron mas repetido del DSL: casi todas las listas admiten la forma
+ * corta. Centralizarlo evita que cada compilador olvide que YAML convierte
+ * `- 2025` en numero y rompa con una etiqueta perfectamente valida.
+ */
+export function asNamedRecord(raw, field, key = 'name') {
+    if (typeof raw === 'string' || typeof raw === 'number' || typeof raw === 'boolean') {
+        return { [key]: String(raw) };
+    }
+    return asRecord(raw, field);
+}
+export function oneOf(value, allowed, field, fallback) {
+    if (value === undefined)
+        return fallback;
+    const normalized = value.trim().toLowerCase();
+    if (!allowed.includes(normalized)) {
+        fail(`${field} no admite el valor "${value}"`, `valores validos: ${allowed.join(', ')}`, ERROR_CODES.DSL_VALUE_NOT_ALLOWED);
+    }
+    return normalized;
+}
+function preview(value) {
+    const text = typeof value === 'string' ? value : JSON.stringify(value);
+    if (text === undefined)
+        return 'undefined';
+    return text.length > 120 ? `${text.slice(0, 117)}...` : text;
+}
+// --------------------------------------------------------------------------
+// Generacion de identificadores y escapado por motor
+// --------------------------------------------------------------------------
+/**
+ * Generador de ids estables y seguros.
+ *
+ * Los motores destino se alimentan siempre de ids sinteticos (`n1`, `n2`, ...)
+ * y del texto original solo como etiqueta entrecomillada. Asi ningun caracter
+ * del documento puede alterar la sintaxis generada.
+ */
+export class IdFactory {
+    prefix;
+    byKey = new Map();
+    counter = 0;
+    constructor(prefix = 'n') {
+        this.prefix = prefix;
+    }
+    id(key) {
+        const existing = this.byKey.get(key);
+        if (existing !== undefined)
+            return existing;
+        this.counter += 1;
+        const id = `${this.prefix}${this.counter}`;
+        this.byKey.set(key, id);
+        return id;
+    }
+    has(key) {
+        return this.byKey.has(key);
+    }
+    get(key) {
+        return this.byKey.get(key);
+    }
+    keys() {
+        return [...this.byKey.keys()];
+    }
+}
+/** Cadena entre comillas dobles para D2. */
+export function d2Label(text) {
+    return JSON.stringify(text);
+}
+/** Cadena entre comillas simples para LikeC4. */
+export function likec4Label(text) {
+    return `'${text.replace(/\\/g, '\\\\').replace(/'/g, "\\'").replace(/\n/g, ' ')}'`;
+}
+/** Etiqueta segura para Mermaid: entre comillas y sin comillas internas. */
+export function mermaidLabel(text) {
+    return `"${text.replace(/"/g, "'").replace(/\n/g, ' ')}"`;
+}
+/** Texto seguro dentro de una etiqueta PlantUML de una sola linea. */
+export function plantUmlText(text) {
+    return text.replace(/\n/g, '\\n');
+}
+/** Cadena entrecomillada para Graphviz DOT. */
+export function dotLabel(text) {
+    return `"${text.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n')}"`;
+}
+const EDGE_RE = /^\s*(.+?)\s*(<--|<-|-->|->|\.\.>|=>)\s*(.+?)\s*(?::\s*(.*))?$/;
+const ARROW_IN_KEY = /(<--|<-|-->|->|\.\.>|=>)/;
+/**
+ * Detecta el mapa de una sola entrada que YAML produce a partir de
+ * `- Origen -> Destino: etiqueta`.
+ */
+export function asArrowShorthand(item) {
+    if (item === null || typeof item !== 'object' || Array.isArray(item))
+        return undefined;
+    const entries = Object.entries(item);
+    if (entries.length !== 1)
+        return undefined;
+    const [key, value] = entries[0];
+    if (!ARROW_IN_KEY.test(key))
+        return undefined;
+    // `from`/`to` explicitos nunca llevan flecha en la clave: no hay ambiguedad.
+    if (value !== null && typeof value === 'object')
+        return undefined;
+    const label = value === null || value === undefined ? undefined : String(value).trim();
+    return label === undefined || label === '' ? { expression: key } : { expression: key, label };
+}
+export function parseEdgeExpression(expression, field) {
+    const match = EDGE_RE.exec(expression);
+    if (match === null) {
+        fail(`no se entiende la relacion "${expression}" en ${field}`, 'formato esperado: "Origen -> Destino: etiqueta"');
+    }
+    const left = match[1].trim();
+    const arrow = match[2];
+    const right = match[3].trim();
+    const label = match[4]?.trim();
+    const reversed = arrow === '<-' || arrow === '<--';
+    const dashed = arrow === '-->' || arrow === '<--' || arrow === '..>';
+    const edge = {
+        from: reversed ? right : left,
+        to: reversed ? left : right,
+        dashed,
+    };
+    if (label !== undefined && label !== '')
+        edge.label = label;
+    return edge;
+}
+/**
+ * Normaliza un item de relacion.
+ *
+ * Admite tres formas:
+ *
+ *     - Usuario -> API: Login      (YAML lo entrega como mapa de una entrada)
+ *     - "Usuario -> API"           (cadena)
+ *     - {from: Usuario, to: API}   (mapa explicito)
+ *
+ * La primera es la que escribe cualquiera de forma natural, pero YAML la
+ * interpreta como `{ "Usuario -> API": "Login" }` por culpa de los dos puntos.
+ * Se reconoce ese caso en lugar de exigir comillas.
+ */
+export function toEdge(item, field) {
+    if (typeof item === 'string')
+        return parseEdgeExpression(item, field);
+    const shorthand = asArrowShorthand(item);
+    if (shorthand !== undefined) {
+        const edge = parseEdgeExpression(shorthand.expression, field);
+        if (shorthand.label !== undefined)
+            edge.label = shorthand.label;
+        return edge;
+    }
+    const record = asRecord(item, field);
+    const edge = {
+        from: requireString(record, 'from', field),
+        to: requireString(record, 'to', field),
+        dashed: record['style'] === 'dashed' || record['dashed'] === true,
+    };
+    const label = optionalString(record, 'label') ?? optionalString(record, 'text');
+    if (label !== undefined)
+        edge.label = label;
+    return edge;
+}
+//# sourceMappingURL=util.js.map

package/dist/dsl/util.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * API publica de DocViz Builder.
+ */
+export type { DiagramRenderer, RenderOptions, RenderResult, DiagramBlock, RenderedAsset, BuildStats, OutputFormat, } from './core/types.js';
+export { MIME_TYPES } from './core/types.js';
+export { DocVizError, BuildFailedError, ConfigError, DslValidationError, PathSecurityError, RenderError, UnknownRendererError, } from './core/errors.js';
+export { RendererRegistry } from './core/registry.js';
+export { AssetCache, DEFAULT_CACHE_DIR } from './core/cache.js';
+export { fullHash, shortHash, fingerprint, stableStringify, HashRegistry, DEFAULT_HASH_LENGTH, MIN_HASH_LENGTH, MAX_HASH_LENGTH, } from './core/hash.js';
+export { slugify, assetFileName, assertInside, assertRelativeDir, relativeAssetPath, ensureAssetsDir, toPosix, } from './core/paths.js';
+export { scanDocument, parseMarkdown, parseMeta } from './markdown/scan.js';
+export { applyReplacements, imageMarkdown, escapeAltText } from './markdown/transform.js';
+export { THEMES, getTheme, themeNames, themeFingerprint } from './themes/index.js';
+export type { Theme, ThemePalette } from './themes/types.js';
+export { buildRegistry } from './renderers/index.js';
+export { finalizeSvg, sanitizeSvg, normalizeSvgDimensions } from './renderers/svg-utils.js';
+export { renderLikeC4View } from './renderers/likec4-svg.js';
+export { compileDsl, compileArchitecture, dslCatalog, dslCatalogDetailed, diagramTypeNames, chartTypeNames, findType, typeNames, TYPE_CATALOG, isDslLanguage, DSL_LANGUAGES, } from './dsl/index.js';
+export type { TypeSpec, DslLang } from './dsl/index.js';
+export { build, check, collectMarkdown } from './build/builder.js';
+export type { BuildOptions, BuildResult, CheckResult } from './build/builder.js';
+export { verify } from './build/verify.js';
+export type { VerifyResult, VerifyIssue } from './build/verify.js';
+export { startPreview } from './build/preview.js';
+export { loadConfig, defaultConfig, mergeConfig, findConfigFile, resolveFromRoot } from './config/load.js';
+export type { DocVizConfig, RenderersConfig, RendererBackend } from './config/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EACL,QAAQ,EACR,SAAS,EACT,WAAW,EACX,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,OAAO,EACP,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,OAAO,GACR,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE1F,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACnF,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC3G,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * API publica de DocViz Builder.
+ */
+export { MIME_TYPES } from './core/types.js';
+export { DocVizError, BuildFailedError, ConfigError, DslValidationError, PathSecurityError, RenderError, UnknownRendererError, } from './core/errors.js';
+export { RendererRegistry } from './core/registry.js';
+export { AssetCache, DEFAULT_CACHE_DIR } from './core/cache.js';
+export { fullHash, shortHash, fingerprint, stableStringify, HashRegistry, DEFAULT_HASH_LENGTH, MIN_HASH_LENGTH, MAX_HASH_LENGTH, } from './core/hash.js';
+export { slugify, assetFileName, assertInside, assertRelativeDir, relativeAssetPath, ensureAssetsDir, toPosix, } from './core/paths.js';
+export { scanDocument, parseMarkdown, parseMeta } from './markdown/scan.js';
+export { applyReplacements, imageMarkdown, escapeAltText } from './markdown/transform.js';
+export { THEMES, getTheme, themeNames, themeFingerprint } from './themes/index.js';
+export { buildRegistry } from './renderers/index.js';
+export { finalizeSvg, sanitizeSvg, normalizeSvgDimensions } from './renderers/svg-utils.js';
+export { renderLikeC4View } from './renderers/likec4-svg.js';
+export { compileDsl, compileArchitecture, dslCatalog, dslCatalogDetailed, diagramTypeNames, chartTypeNames, findType, typeNames, TYPE_CATALOG, isDslLanguage, DSL_LANGUAGES, } from './dsl/index.js';
+export { build, check, collectMarkdown } from './build/builder.js';
+export { verify } from './build/verify.js';
+export { startPreview } from './build/preview.js';
+export { loadConfig, defaultConfig, mergeConfig, findConfigFile, resolveFromRoot } from './config/load.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EACL,QAAQ,EACR,SAAS,EACT,WAAW,EACX,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,OAAO,EACP,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,OAAO,GACR,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE1F,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGnF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/markdown/scan.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Deteccion de bloques declarativos dentro de un documento Markdown.
+ *
+ * El analisis se hace con `unified` + `remark` sobre el AST (mdast), no con
+ * expresiones regulares (seccion 13). Las regex que aparecen aqui operan sobre
+ * el `meta` de una valla ya identificada por el parser, no sobre el documento.
+ */
+import type { Root } from 'mdast';
+import type { DiagramBlock, OutputFormat } from '../core/types.js';
+export interface CompiledBlock {
+    rendererType: string;
+    source: string;
+    title?: string;
+    /** Campos declarados que el compilador no uso. */
+    warnings?: ReadonlyArray<{
+        code: string;
+        field: string;
+        message: string;
+    }>;
+}
+export interface ScanContext {
+    /** Devuelve el tipo canonico de renderer para un lenguaje, o `undefined`. */
+    resolveLanguage(lang: string): string | undefined;
+    /** Compila el DSL de alto nivel. Solo se invoca para lenguajes de DSL. */
+    compileDsl?(lang: string, source: string): CompiledBlock;
+    /** Lenguajes de DSL de alto nivel (`diagram`, `chart`, `architecture`). */
+    dslLanguages: readonly string[];
+}
+/** Bloque que no se pudo compilar, con la linea en la que empieza su valla. */
+export interface ScanIssue {
+    line: number;
+    lang: string;
+    error: unknown;
+}
+/** Aviso localizado: el bloque compila, pero parte de lo escrito no se dibuja. */
+export interface ScanWarning {
+    line: number;
+    lang: string;
+    code: string;
+    field: string;
+    message: string;
+}
+export interface ScanResult {
+    tree: Root;
+    blocks: DiagramBlock[];
+    /**
+     * Errores de compilacion del DSL, uno por bloque.
+     *
+     * El escaneo no aborta al primero: un documento con tres bloques rotos debe
+     * reportar los tres, o corregirlos cuesta tres builds completos.
+     */
+    errors: ScanIssue[];
+    warnings: ScanWarning[];
+}
+export declare function parseMarkdown(text: string): Root;
+/**
+ * Recorre el documento y devuelve los bloques compilables en orden de aparicion.
+ *
+ * Los bloques cuyo lenguaje no esta registrado (`typescript`, `bash`, `json`,
+ * vallas sin lenguaje) se dejan intactos: no aparecen en el resultado.
+ */
+export declare function scanDocument(text: string, context: ScanContext): ScanResult;
+export interface FenceMeta {
+    title?: string;
+    format?: OutputFormat;
+}
+/**
+ * Opciones escritas junto al lenguaje de la valla:
+ *
+ *     ```plantuml title="Flujo de autenticacion" format=svg
+ */
+export declare function parseMeta(meta: string | undefined): FenceMeta;
+//# sourceMappingURL=scan.d.ts.map

package/dist/markdown/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/markdown/scan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAiB,IAAI,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,QAAQ,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAClD,0EAA0E;IAC1E,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;IACzD,2EAA2E;IAC3E,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,+EAA+E;AAC/E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB;;;;;OAKG;IACH,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAOD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,UAAU,CA+E3E;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAa7D"}

package/dist/markdown/scan.js

@@ -0,0 +1,150 @@
+/**
+ * Deteccion de bloques declarativos dentro de un documento Markdown.
+ *
+ * El analisis se hace con `unified` + `remark` sobre el AST (mdast), no con
+ * expresiones regulares (seccion 13). Las regex que aparecen aqui operan sobre
+ * el `meta` de una valla ya identificada por el parser, no sobre el documento.
+ */
+import remarkFrontmatter from 'remark-frontmatter';
+import remarkGfm from 'remark-gfm';
+import remarkParse from 'remark-parse';
+import { unified } from 'unified';
+import { visit } from 'unist-util-visit';
+import { toString as mdastToString } from 'mdast-util-to-string';
+const processor = unified()
+    .use(remarkParse)
+    .use(remarkFrontmatter, ['yaml', 'toml'])
+    .use(remarkGfm);
+export function parseMarkdown(text) {
+    return processor.parse(text);
+}
+/**
+ * Recorre el documento y devuelve los bloques compilables en orden de aparicion.
+ *
+ * Los bloques cuyo lenguaje no esta registrado (`typescript`, `bash`, `json`,
+ * vallas sin lenguaje) se dejan intactos: no aparecen en el resultado.
+ */
+export function scanDocument(text, context) {
+    const tree = parseMarkdown(text);
+    const blocks = [];
+    const errors = [];
+    const warnings = [];
+    // Encabezados con su offset, para deducir el titulo del diagrama siguiente.
+    const headings = [];
+    visit(tree, 'heading', (node) => {
+        const offset = node.position?.start.offset;
+        if (offset === undefined)
+            return;
+        const value = mdastToString(node).trim();
+        if (value !== '')
+            headings.push({ offset, text: value });
+    });
+    visit(tree, 'code', (node) => {
+        const lang = (node.lang ?? '').trim().toLowerCase();
+        if (lang === '')
+            return;
+        const start = node.position?.start.offset;
+        const end = node.position?.end.offset;
+        const line = node.position?.start.line;
+        if (start === undefined || end === undefined || line === undefined)
+            return;
+        const isDsl = context.dslLanguages.includes(lang);
+        const rendererFromLang = context.resolveLanguage(lang);
+        if (!isDsl && rendererFromLang === undefined)
+            return;
+        const meta = parseMeta(node.meta ?? undefined);
+        const rawSource = node.value;
+        let rendererType;
+        let source;
+        let dslTitle;
+        if (isDsl) {
+            if (context.compileDsl === undefined)
+                return;
+            let compiled;
+            try {
+                compiled = context.compileDsl(lang, rawSource);
+            }
+            catch (err) {
+                errors.push({ line, lang, error: err });
+                return;
+            }
+            rendererType = compiled.rendererType;
+            source = compiled.source;
+            dslTitle = compiled.title;
+            for (const w of compiled.warnings ?? []) {
+                warnings.push({ line, lang, code: w.code, field: w.field, message: w.message });
+            }
+        }
+        else {
+            rendererType = rendererFromLang;
+            source = rawSource;
+        }
+        const title = meta.title ??
+            dslTitle ??
+            nearestHeading(headings, start) ??
+            defaultTitle(lang);
+        const block = {
+            lang,
+            rendererType,
+            source,
+            rawSource,
+            title,
+            start,
+            end,
+            line,
+        };
+        if (meta.format !== undefined)
+            block.requestedFormat = meta.format;
+        blocks.push(block);
+    });
+    blocks.sort((a, b) => a.start - b.start);
+    errors.sort((a, b) => a.line - b.line);
+    warnings.sort((a, b) => a.line - b.line);
+    return { tree, blocks, errors, warnings };
+}
+/**
+ * Opciones escritas junto al lenguaje de la valla:
+ *
+ *     ```plantuml title="Flujo de autenticacion" format=svg
+ */
+export function parseMeta(meta) {
+    const out = {};
+    if (meta === undefined || meta.trim() === '')
+        return out;
+    const attrRe = /(\w[\w-]*)\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s]+))/g;
+    let m;
+    while ((m = attrRe.exec(meta)) !== null) {
+        const key = m[1].toLowerCase();
+        const value = m[2] ?? m[3] ?? m[4] ?? '';
+        if (key === 'title' || key === 'alt')
+            out.title = value;
+        else if (key === 'format' && (value === 'svg' || value === 'png'))
+            out.format = value;
+    }
+    return out;
+}
+function nearestHeading(headings, offset) {
+    let best;
+    for (const h of headings) {
+        if (h.offset < offset)
+            best = h.text;
+        else
+            break;
+    }
+    return best;
+}
+function defaultTitle(lang) {
+    const names = {
+        plantuml: 'Diagrama UML',
+        mermaid: 'Diagrama de flujo',
+        d2: 'Diagrama',
+        graphviz: 'Grafo de dependencias',
+        'vega-lite': 'Grafico',
+        likec4: 'Arquitectura',
+        diagram: 'Diagrama',
+        chart: 'Grafico',
+        architecture: 'Arquitectura',
+    };
+    return names[lang] ?? 'Diagrama';
+}
+//# sourceMappingURL=scan.js.map

package/dist/markdown/scan.js.map

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

package/dist/markdown/transform.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Sustitucion de bloques por imagenes Markdown.
+ *
+ * El reemplazo es quirurgico: se usan los desplazamientos que da el AST para
+ * cortar exactamente la valla de codigo y nada mas. Volver a serializar todo el
+ * documento con `remark-stringify` normalizaria comillas, vinetas y saltos, y
+ * el criterio de aceptacion exige mantener intacto el resto del Markdown.
+ */
+import type { DiagramBlock } from '../core/types.js';
+export interface Replacement {
+    block: DiagramBlock;
+    /** Ruta relativa del recurso, ya calculada respecto al documento. */
+    assetPath: string;
+}
+/** Escapa el texto alternativo para que no rompa la sintaxis de imagen. */
+export declare function escapeAltText(text: string): string;
+/**
+ * Escapa la ruta. Las rutas generadas son slugs ASCII, pero un espacio o un
+ * parentesis en un `assetsDir` configurado a mano romperia el enlace.
+ */
+export declare function encodeAssetPath(assetPath: string): string;
+export declare function imageMarkdown(alt: string, assetPath: string): string;
+/**
+ * Aplica los reemplazos de atras hacia adelante para que los desplazamientos
+ * de los bloques anteriores sigan siendo validos.
+ */
+export declare function applyReplacements(source: string, replacements: readonly Replacement[]): string;
+//# sourceMappingURL=transform.d.ts.map

package/dist/markdown/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/markdown/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAQ9F"}

package/dist/markdown/transform.js

@@ -0,0 +1,38 @@
+/**
+ * Sustitucion de bloques por imagenes Markdown.
+ *
+ * El reemplazo es quirurgico: se usan los desplazamientos que da el AST para
+ * cortar exactamente la valla de codigo y nada mas. Volver a serializar todo el
+ * documento con `remark-stringify` normalizaria comillas, vinetas y saltos, y
+ * el criterio de aceptacion exige mantener intacto el resto del Markdown.
+ */
+/** Escapa el texto alternativo para que no rompa la sintaxis de imagen. */
+export function escapeAltText(text) {
+    return text.replace(/\\/g, '\\\\').replace(/\[/g, '\\[').replace(/\]/g, '\\]');
+}
+/**
+ * Escapa la ruta. Las rutas generadas son slugs ASCII, pero un espacio o un
+ * parentesis en un `assetsDir` configurado a mano romperia el enlace.
+ */
+export function encodeAssetPath(assetPath) {
+    if (/[\s()<>]/.test(assetPath))
+        return `<${assetPath.replace(/[<>]/g, '')}>`;
+    return assetPath;
+}
+export function imageMarkdown(alt, assetPath) {
+    return `![${escapeAltText(alt)}](${encodeAssetPath(assetPath)})`;
+}
+/**
+ * Aplica los reemplazos de atras hacia adelante para que los desplazamientos
+ * de los bloques anteriores sigan siendo validos.
+ */
+export function applyReplacements(source, replacements) {
+    const ordered = [...replacements].sort((a, b) => b.block.start - a.block.start);
+    let out = source;
+    for (const { block, assetPath } of ordered) {
+        const image = imageMarkdown(block.title, assetPath);
+        out = out.slice(0, block.start) + image + out.slice(block.end);
+    }
+    return out;
+}
+//# sourceMappingURL=transform.js.map

package/dist/markdown/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/markdown/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,2EAA2E;AAC3E,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACjF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC;IAC7E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,SAAiB;IAC1D,OAAO,KAAK,aAAa,CAAC,GAAG,CAAC,KAAK,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,YAAoC;IACpF,MAAM,OAAO,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChF,IAAI,GAAG,GAAG,MAAM,CAAC;IACjB,KAAK,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,OAAO,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACpD,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}