docviz-builder 0.1.0

package/dist/core/errors.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Errores de DocViz.
+ *
+ * Regla de la especificacion (seccion 11): un fallo de render nunca puede
+ * producir silenciosamente un documento incorrecto. Todo error lleva la
+ * informacion necesaria para localizarlo: archivo, linea, renderer y motivo.
+ *
+ * Ademas del texto, todo error lleva un **codigo estable**. El destinatario
+ * habitual del reporte es un agente reintentando: un codigo permite decidir la
+ * correccion sin analizar el mensaje, que esta escrito para humanos y puede
+ * cambiar de redaccion sin previo aviso.
+ */
+/**
+ * Codigos de regla.
+ *
+ * Son parte del contrato publico: renombrar uno rompe a quien lo consuma, asi
+ * que se anaden codigos nuevos en lugar de reutilizar los existentes.
+ *
+ *   DV0xx  entorno, configuracion y motores
+ *   DV1xx  DSL declarativo (lo que escribe el autor del documento)
+ */
+export declare const ERROR_CODES: {
+    /** Error sin clasificar. */
+    readonly GENERIC: "DV000";
+    /** El lenguaje de la valla no tiene renderer registrado. */
+    readonly UNKNOWN_RENDERER: "DV001";
+    /** El motor devolvio un error de sintaxis o fallo al dibujar. */
+    readonly RENDER_FAILED: "DV002";
+    /** Una ruta intento salirse del directorio de salida. */
+    readonly PATH_SECURITY: "DV003";
+    /** Configuracion invalida. */
+    readonly CONFIG: "DV004";
+    /** El renderer existe pero no esta habilitado en esta maquina. */
+    readonly RENDERER_UNAVAILABLE: "DV005";
+    /** El renderer no puede producir el formato pedido. */
+    readonly FORMAT_UNSUPPORTED: "DV006";
+    /** Colision de hash truncado. */
+    readonly HASH_COLLISION: "DV007";
+    /** DSL invalido sin clasificar. */
+    readonly DSL: "DV100";
+    /** Falta un campo obligatorio. */
+    readonly DSL_FIELD_MISSING: "DV101";
+    /** El campo existe pero su valor no tiene la forma esperada. */
+    readonly DSL_FIELD_TYPE: "DV102";
+    /** El valor no pertenece al conjunto admitido. */
+    readonly DSL_VALUE_NOT_ALLOWED: "DV103";
+    /** Campo que el tipo no usa: casi siempre una errata. */
+    readonly DSL_FIELD_UNKNOWN: "DV104";
+    /** El bloque no es YAML valido. */
+    readonly DSL_YAML: "DV105";
+    /** El `type` no existe o no pertenece a esta valla. */
+    readonly DSL_TYPE: "DV106";
+};
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+export interface DocVizErrorLocation {
+    /** Ruta relativa al cwd del archivo Markdown fuente. */
+    file?: string;
+    /** Linea 1-based dentro del archivo fuente. */
+    line?: number;
+    /** Tipo de renderer implicado. */
+    renderer?: string;
+}
+export declare class DocVizError extends Error {
+    readonly location: DocVizErrorLocation;
+    readonly detail?: string;
+    /** Codigo estable de la regla incumplida. */
+    readonly code: ErrorCode;
+    constructor(message: string, location?: DocVizErrorLocation, detail?: string, code?: ErrorCode);
+    /** Vuelve a etiquetar un error con la posicion del bloque que lo produjo. */
+    withLocation(location: DocVizErrorLocation): DocVizError;
+    /**
+     * Devuelve una copia con detalle adicional al final.
+     *
+     * Se usa para adjuntar diagnosticos que solo se conocen despues de fallar,
+     * como las erratas detectadas en los campos del bloque.
+     */
+    withExtraDetail(extra: string): DocVizError;
+    /**
+     * Copia conservando la subclase.
+     *
+     * Reconstruir con `new DocVizError(...)` convertiria un `DslValidationError`
+     * en un error generico a mitad del camino, y quien lo reciba dejaria de poder
+     * distinguir de que capa vino.
+     */
+    private copyWith;
+    /** Formato de reporte exigido por la seccion 11 de la especificacion. */
+    format(): string;
+}
+/** El lenguaje de la valla no tiene renderer registrado. */
+export declare class UnknownRendererError extends DocVizError {
+    constructor(type: string, known: readonly string[]);
+}
+/** El motor devolvio un error de sintaxis o fallo al dibujar. */
+export declare class RenderError extends DocVizError {
+    constructor(renderer: string, message: string, detail?: string, code?: ErrorCode);
+}
+/** Una ruta intento salirse del directorio de salida configurado. */
+export declare class PathSecurityError extends DocVizError {
+    constructor(message: string, detail?: string);
+}
+/** El DSL declarativo no cumple su esquema. */
+export declare class DslValidationError extends DocVizError {
+    constructor(message: string, detail?: string, code?: ErrorCode);
+}
+/** Error de configuracion (docviz.config.yaml o flags de CLI). */
+export declare class ConfigError extends DocVizError {
+    constructor(message: string, detail?: string);
+}
+/** Agrupa todos los fallos de un build para reportarlos juntos. */
+export declare class BuildFailedError extends Error {
+    readonly errors: readonly DocVizError[];
+    constructor(errors: readonly DocVizError[]);
+    format(): string;
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;IACtB,4BAA4B;;IAE5B,4DAA4D;;IAE5D,iEAAiE;;IAEjE,yDAAyD;;IAEzD,8BAA8B;;IAE9B,kEAAkE;;IAElE,uDAAuD;;IAEvD,iCAAiC;;IAGjC,mCAAmC;;IAEnC,kCAAkC;;IAElC,gEAAgE;;IAEhE,kDAAkD;;IAElD,yDAAyD;;IAEzD,mCAAmC;;IAEnC,uDAAuD;;CAE/C,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBAGvB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,mBAAwB,EAClC,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,GAAE,SAA+B;IASvC,6EAA6E;IAC7E,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,WAAW;IAIxD;;;;;OAKG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAK3C;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;IAWhB,yEAAyE;IACzE,MAAM,IAAI,MAAM;CAajB;AAED,4DAA4D;AAC5D,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE;CASnD;AAED,iEAAiE;AACjE,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,SAAqC;CAI5G;AAED,qEAAqE;AACrE,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAI7C;AAED,+CAA+C;AAC/C,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,SAA2B;CAIhF;AAED,kEAAkE;AAClE,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAI7C;AAED,mEAAmE;AACnE,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;gBAE5B,MAAM,EAAE,SAAS,WAAW,EAAE;IAM1C,MAAM,IAAI,MAAM;CAGjB"}

package/dist/core/errors.js

@@ -0,0 +1,164 @@
+/**
+ * Errores de DocViz.
+ *
+ * Regla de la especificacion (seccion 11): un fallo de render nunca puede
+ * producir silenciosamente un documento incorrecto. Todo error lleva la
+ * informacion necesaria para localizarlo: archivo, linea, renderer y motivo.
+ *
+ * Ademas del texto, todo error lleva un **codigo estable**. El destinatario
+ * habitual del reporte es un agente reintentando: un codigo permite decidir la
+ * correccion sin analizar el mensaje, que esta escrito para humanos y puede
+ * cambiar de redaccion sin previo aviso.
+ */
+/**
+ * Codigos de regla.
+ *
+ * Son parte del contrato publico: renombrar uno rompe a quien lo consuma, asi
+ * que se anaden codigos nuevos en lugar de reutilizar los existentes.
+ *
+ *   DV0xx  entorno, configuracion y motores
+ *   DV1xx  DSL declarativo (lo que escribe el autor del documento)
+ */
+export const ERROR_CODES = {
+    /** Error sin clasificar. */
+    GENERIC: 'DV000',
+    /** El lenguaje de la valla no tiene renderer registrado. */
+    UNKNOWN_RENDERER: 'DV001',
+    /** El motor devolvio un error de sintaxis o fallo al dibujar. */
+    RENDER_FAILED: 'DV002',
+    /** Una ruta intento salirse del directorio de salida. */
+    PATH_SECURITY: 'DV003',
+    /** Configuracion invalida. */
+    CONFIG: 'DV004',
+    /** El renderer existe pero no esta habilitado en esta maquina. */
+    RENDERER_UNAVAILABLE: 'DV005',
+    /** El renderer no puede producir el formato pedido. */
+    FORMAT_UNSUPPORTED: 'DV006',
+    /** Colision de hash truncado. */
+    HASH_COLLISION: 'DV007',
+    /** DSL invalido sin clasificar. */
+    DSL: 'DV100',
+    /** Falta un campo obligatorio. */
+    DSL_FIELD_MISSING: 'DV101',
+    /** El campo existe pero su valor no tiene la forma esperada. */
+    DSL_FIELD_TYPE: 'DV102',
+    /** El valor no pertenece al conjunto admitido. */
+    DSL_VALUE_NOT_ALLOWED: 'DV103',
+    /** Campo que el tipo no usa: casi siempre una errata. */
+    DSL_FIELD_UNKNOWN: 'DV104',
+    /** El bloque no es YAML valido. */
+    DSL_YAML: 'DV105',
+    /** El `type` no existe o no pertenece a esta valla. */
+    DSL_TYPE: 'DV106',
+};
+export class DocVizError extends Error {
+    location;
+    detail;
+    /** Codigo estable de la regla incumplida. */
+    code;
+    constructor(message, location = {}, detail, code = ERROR_CODES.GENERIC) {
+        super(message);
+        this.name = 'DocVizError';
+        this.location = location;
+        this.detail = detail;
+        this.code = code;
+    }
+    /** Vuelve a etiquetar un error con la posicion del bloque que lo produjo. */
+    withLocation(location) {
+        return this.copyWith({ location: { ...this.location, ...location } });
+    }
+    /**
+     * Devuelve una copia con detalle adicional al final.
+     *
+     * Se usa para adjuntar diagnosticos que solo se conocen despues de fallar,
+     * como las erratas detectadas en los campos del bloque.
+     */
+    withExtraDetail(extra) {
+        if (extra.trim() === '')
+            return this;
+        return this.copyWith({ detail: this.detail === undefined ? extra : `${this.detail}\n${extra}` });
+    }
+    /**
+     * Copia conservando la subclase.
+     *
+     * Reconstruir con `new DocVizError(...)` convertiria un `DslValidationError`
+     * en un error generico a mitad del camino, y quien lo reciba dejaria de poder
+     * distinguir de que capa vino.
+     */
+    copyWith(changes) {
+        const clone = Object.create(Object.getPrototypeOf(this));
+        clone['name'] = this.name;
+        clone['message'] = this.message;
+        clone['stack'] = this.stack;
+        clone['code'] = this.code;
+        clone['location'] = changes.location ?? this.location;
+        clone['detail'] = changes.detail ?? this.detail;
+        return clone;
+    }
+    /** Formato de reporte exigido por la seccion 11 de la especificacion. */
+    format() {
+        const lines = ['ERROR'];
+        lines.push(`codigo: ${this.code}`);
+        if (this.location.file)
+            lines.push(`archivo: ${this.location.file}`);
+        if (this.location.line !== undefined)
+            lines.push(`linea: ${this.location.line}`);
+        if (this.location.renderer)
+            lines.push(`renderer: ${this.location.renderer}`);
+        lines.push(`motivo: ${this.message}`);
+        if (this.detail) {
+            lines.push('detalle:');
+            for (const l of this.detail.trimEnd().split('\n'))
+                lines.push(`  ${l}`);
+        }
+        return lines.join('\n');
+    }
+}
+/** El lenguaje de la valla no tiene renderer registrado. */
+export class UnknownRendererError extends DocVizError {
+    constructor(type, known) {
+        super(`no existe un renderer registrado para "${type}"`, { renderer: type }, `renderers disponibles: ${known.join(', ')}`, ERROR_CODES.UNKNOWN_RENDERER);
+        this.name = 'UnknownRendererError';
+    }
+}
+/** El motor devolvio un error de sintaxis o fallo al dibujar. */
+export class RenderError extends DocVizError {
+    constructor(renderer, message, detail, code = ERROR_CODES.RENDER_FAILED) {
+        super(message, { renderer }, detail, code);
+        this.name = 'RenderError';
+    }
+}
+/** Una ruta intento salirse del directorio de salida configurado. */
+export class PathSecurityError extends DocVizError {
+    constructor(message, detail) {
+        super(message, {}, detail, ERROR_CODES.PATH_SECURITY);
+        this.name = 'PathSecurityError';
+    }
+}
+/** El DSL declarativo no cumple su esquema. */
+export class DslValidationError extends DocVizError {
+    constructor(message, detail, code = ERROR_CODES.DSL) {
+        super(message, {}, detail, code);
+        this.name = 'DslValidationError';
+    }
+}
+/** Error de configuracion (docviz.config.yaml o flags de CLI). */
+export class ConfigError extends DocVizError {
+    constructor(message, detail) {
+        super(message, {}, detail, ERROR_CODES.CONFIG);
+        this.name = 'ConfigError';
+    }
+}
+/** Agrupa todos los fallos de un build para reportarlos juntos. */
+export class BuildFailedError extends Error {
+    errors;
+    constructor(errors) {
+        super(`el build fallo con ${errors.length} error(es)`);
+        this.name = 'BuildFailedError';
+        this.errors = errors;
+    }
+    format() {
+        return this.errors.map((e) => e.format()).join('\n\n');
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,4BAA4B;IAC5B,OAAO,EAAE,OAAO;IAChB,4DAA4D;IAC5D,gBAAgB,EAAE,OAAO;IACzB,iEAAiE;IACjE,aAAa,EAAE,OAAO;IACtB,yDAAyD;IACzD,aAAa,EAAE,OAAO;IACtB,8BAA8B;IAC9B,MAAM,EAAE,OAAO;IACf,kEAAkE;IAClE,oBAAoB,EAAE,OAAO;IAC7B,uDAAuD;IACvD,kBAAkB,EAAE,OAAO;IAC3B,iCAAiC;IACjC,cAAc,EAAE,OAAO;IAEvB,mCAAmC;IACnC,GAAG,EAAE,OAAO;IACZ,kCAAkC;IAClC,iBAAiB,EAAE,OAAO;IAC1B,gEAAgE;IAChE,cAAc,EAAE,OAAO;IACvB,kDAAkD;IAClD,qBAAqB,EAAE,OAAO;IAC9B,yDAAyD;IACzD,iBAAiB,EAAE,OAAO;IAC1B,mCAAmC;IACnC,QAAQ,EAAE,OAAO;IACjB,uDAAuD;IACvD,QAAQ,EAAE,OAAO;CACT,CAAC;AAaX,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,QAAQ,CAAsB;IAC9B,MAAM,CAAU;IACzB,6CAA6C;IACpC,IAAI,CAAY;IAEzB,YACE,OAAe,EACf,WAAgC,EAAE,EAClC,MAAe,EACf,OAAkB,WAAW,CAAC,OAAO;QAErC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,6EAA6E;IAC7E,YAAY,CAAC,QAA6B;QACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,KAAa;QAC3B,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,EAAE,CAAC,CAAC;IACnG,CAAC;IAED;;;;;;OAMG;IACK,QAAQ,CAAC,OAA4D;QAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAW,CAA4B,CAAC;QAC9F,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1B,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QAChC,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1B,KAAK,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC;QACtD,KAAK,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;QAChD,OAAO,KAA+B,CAAC;IACzC,CAAC;IAED,yEAAyE;IACzE,MAAM;QACJ,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACrE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACjF,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACvB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,4DAA4D;AAC5D,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,YAAY,IAAY,EAAE,KAAwB;QAChD,KAAK,CACH,0CAA0C,IAAI,GAAG,EACjD,EAAE,QAAQ,EAAE,IAAI,EAAE,EAClB,0BAA0B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC5C,WAAW,CAAC,gBAAgB,CAC7B,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C,YAAY,QAAgB,EAAE,OAAe,EAAE,MAAe,EAAE,OAAkB,WAAW,CAAC,aAAa;QACzG,KAAK,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAChD,YAAY,OAAe,EAAE,MAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,+CAA+C;AAC/C,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACjD,YAAY,OAAe,EAAE,MAAe,EAAE,OAAkB,WAAW,CAAC,GAAG;QAC7E,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,kEAAkE;AAClE,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C,YAAY,OAAe,EAAE,MAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,MAAM,CAAyB;IAExC,YAAY,MAA8B;QACxC,KAAK,CAAC,sBAAsB,MAAM,CAAC,MAAM,YAAY,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/core/hash.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Hashing determinista de recursos (seccion 10 de la especificacion).
+ *
+ *   SHA256(rendererType + source + theme + rendererVersion + format)
+ *
+ * `format` no aparece en el enunciado original pero es obligatorio: el mismo
+ * diagrama emitido como SVG y como PNG son recursos distintos y compartir hash
+ * los haria colisionar. El conjunto es un superconjunto del exigido, asi que
+ * todas las invalidaciones pedidas se siguen cumpliendo.
+ */
+import type { OutputFormat } from './types.js';
+/** Longitud minima y maxima admitidas para el hash truncado. */
+export declare const MIN_HASH_LENGTH = 8;
+export declare const MAX_HASH_LENGTH = 16;
+export declare const DEFAULT_HASH_LENGTH = 12;
+export interface HashInput {
+    rendererType: string;
+    source: string;
+    themeName: string;
+    /** Huella del contenido del tema: cambiar el tema invalida el recurso. */
+    themeFingerprint: string;
+    rendererVersion: string;
+    format: OutputFormat;
+}
+/** Digest completo en hexadecimal (64 caracteres). */
+export declare function fullHash(input: HashInput): string;
+/**
+ * Digest truncado usado en el nombre de archivo.
+ *
+ * La estrategia frente a colisiones no es la longitud sino la deteccion: el
+ * builder registra cada hash truncado junto a su digest completo y aborta el
+ * build si dos fuentes distintas producen el mismo prefijo (ver `HashRegistry`).
+ */
+export declare function shortHash(input: HashInput, length?: number): string;
+/** Huella de contenido de cualquier objeto serializable (usada por los temas). */
+export declare function fingerprint(value: unknown): string;
+/** JSON con claves ordenadas, para que el orden de propiedades no altere el hash. */
+export declare function stableStringify(value: unknown): string;
+/**
+ * Detector de colisiones de hash truncado.
+ *
+ * Es lo que permite truncar a 8-16 caracteres sin riesgo: si dos entradas
+ * distintas comparten prefijo, el build falla en lugar de sobrescribir un
+ * recurso ajeno.
+ */
+export declare class HashRegistry {
+    private readonly seen;
+    /** Devuelve true si el prefijo ya estaba registrado con el mismo digest. */
+    claim(short: string, full: string): {
+        ok: true;
+        duplicate: boolean;
+    } | {
+        ok: false;
+    };
+    clear(): void;
+}
+//# sourceMappingURL=hash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/core/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,gEAAgE;AAChE,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;CACtB;AAkBD,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,GAAE,MAA4B,GAAG,MAAM,CAOxF;AAED,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElD;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOtD;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAElD,4EAA4E;IAC5E,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAA;KAAE;IAUpF,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/hash.js.map

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

package/dist/core/package-version.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Lectura de la version de un paquete instalado.
+ *
+ * No se puede importar `<paquete>/package.json` directamente: varios paquetes
+ * (d2, graphviz-wasm, vega) no lo exponen en su mapa `exports`. Se resuelve el
+ * modulo y se sube por el arbol hasta encontrar su `package.json`.
+ */
+export declare function packageVersion(name: string, fallback?: string): string;
+//# sourceMappingURL=package-version.d.ts.map

package/dist/core/package-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.d.ts","sourceRoot":"","sources":["../../src/core/package-version.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAgB,GAAG,MAAM,CA4B7E"}

package/dist/core/package-version.js

@@ -0,0 +1,44 @@
+/**
+ * Lectura de la version de un paquete instalado.
+ *
+ * No se puede importar `<paquete>/package.json` directamente: varios paquetes
+ * (d2, graphviz-wasm, vega) no lo exponen en su mapa `exports`. Se resuelve el
+ * modulo y se sube por el arbol hasta encontrar su `package.json`.
+ */
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+const require_ = createRequire(import.meta.url);
+const cache = new Map();
+export function packageVersion(name, fallback = 'desconocida') {
+    const cached = cache.get(name);
+    if (cached !== undefined)
+        return cached;
+    let version = fallback;
+    try {
+        let dir = path.dirname(require_.resolve(name));
+        for (let depth = 0; depth < 12; depth += 1) {
+            const candidate = path.join(dir, 'package.json');
+            try {
+                const pkg = JSON.parse(readFileSync(candidate, 'utf8'));
+                if (pkg.name === name && typeof pkg.version === 'string') {
+                    version = pkg.version;
+                    break;
+                }
+            }
+            catch {
+                // seguir subiendo
+            }
+            const parent = path.dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    catch {
+        // paquete no resoluble: se devuelve el valor por defecto
+    }
+    cache.set(name, version);
+    return version;
+}
+//# sourceMappingURL=package-version.js.map

package/dist/core/package-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.js","sourceRoot":"","sources":["../../src/core/package-version.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;AAExC,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,QAAQ,GAAG,aAAa;IACnE,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAExC,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,IAAI,CAAC;QACH,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YACjD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAwC,CAAC;gBAC/F,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACzD,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;oBACtB,MAAM;gBACR,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB;YACpB,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,MAAM,KAAK,GAAG;gBAAE,MAAM;YAC1B,GAAG,GAAG,MAAM,CAAC;QACf,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/paths.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Resolucion de rutas de recursos y contencion del directorio de salida
+ * (seccion 12, puntos 8 y 9 de la especificacion).
+ *
+ * Todo lo que se escriba debe quedar dentro del directorio configurado. Ninguna
+ * cadena procedente de un documento Markdown se usa como ruta sin pasar por
+ * `assertInside`.
+ */
+import type { OutputFormat } from './types.js';
+/**
+ * Convierte un titulo en un nombre de archivo seguro: minusculas ASCII,
+ * separadas por guiones, sin puntos ni separadores de ruta.
+ */
+export declare function slugify(title: string, fallback?: string): string;
+/** Nombre de archivo del recurso: `<slug>-<hash>.<ext>`. */
+export declare function assetFileName(title: string, hash: string, format: OutputFormat): string;
+/**
+ * Verifica que `candidate` quede estrictamente dentro de `root`.
+ *
+ * Rechaza `..`, rutas absolutas inyectadas, bytes nulos y enlaces que apunten
+ * fuera del arbol. Devuelve la ruta absoluta normalizada.
+ */
+export declare function assertInside(root: string, candidate: string): string;
+/**
+ * Valida un fragmento de ruta relativa proveniente de configuracion
+ * (por ejemplo `output.assetsDir`).
+ */
+export declare function assertRelativeDir(value: string, field: string): string;
+/** Convierte una ruta del sistema a separadores POSIX (Markdown siempre usa `/`). */
+export declare function toPosix(p: string): string;
+/**
+ * Ruta legible de un archivo en un mensaje de error.
+ *
+ * Relativa a la raiz del proyecto mientras el archivo este dentro; si esta
+ * fuera —compilar un directorio de otro sitio es legitimo— se muestra completa,
+ * porque `../../../../../private/tmp/...` no ayuda a nadie a encontrarlo.
+ */
+export declare function displayPath(rootDir: string, file: string): string;
+/**
+ * Ruta relativa desde el documento compilado hasta el recurso, siempre con
+ * prefijo `./` o `../` para que sea inequivocamente relativa.
+ */
+export declare function relativeAssetPath(fromDocumentDir: string, assetAbsolutePath: string): string;
+/** Crea el directorio de recursos, comprobando antes que quede dentro de la salida. */
+export declare function ensureAssetsDir(outputDir: string, assetsDir: string): Promise<string>;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAa,GAAG,MAAM,CAUpE;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAEvF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAepE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAYtE;AAED,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAI5F;AAED,uFAAuF;AACvF,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3F"}

package/dist/core/paths.js

@@ -0,0 +1,105 @@
+/**
+ * Resolucion de rutas de recursos y contencion del directorio de salida
+ * (seccion 12, puntos 8 y 9 de la especificacion).
+ *
+ * Todo lo que se escriba debe quedar dentro del directorio configurado. Ninguna
+ * cadena procedente de un documento Markdown se usa como ruta sin pasar por
+ * `assertInside`.
+ */
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { PathSecurityError } from './errors.js';
+const DIACRITICS = /[̀-ͯ]/g;
+const NON_SLUG = /[^a-z0-9]+/g;
+/**
+ * Convierte un titulo en un nombre de archivo seguro: minusculas ASCII,
+ * separadas por guiones, sin puntos ni separadores de ruta.
+ */
+export function slugify(title, fallback = 'diagrama') {
+    const slug = title
+        .normalize('NFD')
+        .replace(DIACRITICS, '')
+        .toLowerCase()
+        .replace(NON_SLUG, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 60)
+        .replace(/-+$/g, '');
+    return slug.length > 0 ? slug : fallback;
+}
+/** Nombre de archivo del recurso: `<slug>-<hash>.<ext>`. */
+export function assetFileName(title, hash, format) {
+    return `${slugify(title)}-${hash}.${format}`;
+}
+/**
+ * Verifica que `candidate` quede estrictamente dentro de `root`.
+ *
+ * Rechaza `..`, rutas absolutas inyectadas, bytes nulos y enlaces que apunten
+ * fuera del arbol. Devuelve la ruta absoluta normalizada.
+ */
+export function assertInside(root, candidate) {
+    if (candidate.includes('\0')) {
+        throw new PathSecurityError('la ruta contiene un byte nulo', candidate.replace(/\0/g, '\\0'));
+    }
+    const absRoot = path.resolve(root);
+    const absCandidate = path.resolve(absRoot, candidate);
+    const rel = path.relative(absRoot, absCandidate);
+    if (rel === '')
+        return absCandidate;
+    if (rel.startsWith('..') || path.isAbsolute(rel)) {
+        throw new PathSecurityError('la ruta se sale del directorio de salida configurado', `raiz: ${absRoot}\nruta: ${absCandidate}`);
+    }
+    return absCandidate;
+}
+/**
+ * Valida un fragmento de ruta relativa proveniente de configuracion
+ * (por ejemplo `output.assetsDir`).
+ */
+export function assertRelativeDir(value, field) {
+    if (value.trim() === '') {
+        throw new PathSecurityError(`${field} no puede estar vacio`);
+    }
+    if (path.isAbsolute(value) || /^[a-zA-Z]:[\\/]/.test(value)) {
+        throw new PathSecurityError(`${field} no admite rutas absolutas`, value);
+    }
+    const normalized = path.normalize(value).replace(/\\/g, '/').replace(/^\.\//, '');
+    if (normalized === '..' || normalized.startsWith('../')) {
+        throw new PathSecurityError(`${field} no puede apuntar fuera del directorio de salida`, value);
+    }
+    return normalized.replace(/\/+$/, '');
+}
+/** Convierte una ruta del sistema a separadores POSIX (Markdown siempre usa `/`). */
+export function toPosix(p) {
+    return p.split(path.sep).join('/');
+}
+/**
+ * Ruta legible de un archivo en un mensaje de error.
+ *
+ * Relativa a la raiz del proyecto mientras el archivo este dentro; si esta
+ * fuera —compilar un directorio de otro sitio es legitimo— se muestra completa,
+ * porque `../../../../../private/tmp/...` no ayuda a nadie a encontrarlo.
+ */
+export function displayPath(rootDir, file) {
+    const relative = path.relative(rootDir, file);
+    if (relative === '' || relative.startsWith('..') || path.isAbsolute(relative)) {
+        return toPosix(path.resolve(file));
+    }
+    return toPosix(relative);
+}
+/**
+ * Ruta relativa desde el documento compilado hasta el recurso, siempre con
+ * prefijo `./` o `../` para que sea inequivocamente relativa.
+ */
+export function relativeAssetPath(fromDocumentDir, assetAbsolutePath) {
+    const rel = toPosix(path.relative(fromDocumentDir, assetAbsolutePath));
+    if (rel.startsWith('.'))
+        return rel;
+    return `./${rel}`;
+}
+/** Crea el directorio de recursos, comprobando antes que quede dentro de la salida. */
+export async function ensureAssetsDir(outputDir, assetsDir) {
+    const safe = assertRelativeDir(assetsDir, 'output.assetsDir');
+    const abs = assertInside(outputDir, safe);
+    await mkdir(abs, { recursive: true });
+    return abs;
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,UAAU,GAAG,QAAQ,CAAC;AAC5B,MAAM,QAAQ,GAAG,aAAa,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,QAAQ,GAAG,UAAU;IAC1D,MAAM,IAAI,GAAG,KAAK;SACf,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,WAAW,EAAE;SACb,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC3C,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,IAAY,EAAE,MAAoB;IAC7E,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,SAAiB;IAC1D,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,iBAAiB,CAAC,+BAA+B,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACjD,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,YAAY,CAAC;IACpC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,iBAAiB,CACzB,sDAAsD,EACtD,SAAS,OAAO,WAAW,YAAY,EAAE,CAC1C,CAAC;IACJ,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,KAAa;IAC5D,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,iBAAiB,CAAC,GAAG,KAAK,uBAAuB,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,iBAAiB,CAAC,GAAG,KAAK,4BAA4B,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAClF,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,iBAAiB,CAAC,GAAG,KAAK,kDAAkD,EAAE,KAAK,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAY;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9E,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,eAAuB,EAAE,iBAAyB;IAClF,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACvE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,OAAO,KAAK,GAAG,EAAE,CAAC;AACpB,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB,EAAE,SAAiB;IACxE,MAAM,IAAI,GAAG,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC1C,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Registro de renderers.
+ *
+ * El parser Markdown consulta este registro para saber que lenguajes son
+ * "compilables"; nunca importa un renderer concreto.
+ */
+import type { DiagramRenderer } from './types.js';
+export declare class RendererRegistry {
+    private readonly renderers;
+    /** Alias de lenguaje -> tipo canonico (`dot` -> `graphviz`, etc.). */
+    private readonly aliases;
+    register(type: string, renderer: DiagramRenderer, aliases?: readonly string[]): this;
+    unregister(type: string): boolean;
+    /** Resuelve alias y devuelve el tipo canonico, o `undefined` si no existe. */
+    resolve(type: string): string | undefined;
+    has(type: string): boolean;
+    /** Devuelve el renderer o lanza `UnknownRendererError`. */
+    get(type: string): DiagramRenderer;
+    types(): string[];
+    /** Todos los lenguajes reconocidos en una valla de codigo, alias incluidos. */
+    languages(): string[];
+    disposeAll(): Promise<void>;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,GAAE,SAAS,MAAM,EAAO,GAAG,IAAI;IAOxF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQjC,8EAA8E;IAC9E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQzC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,2DAA2D;IAC3D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAMlC,KAAK,IAAI,MAAM,EAAE;IAIjB,+EAA+E;IAC/E,SAAS,IAAI,MAAM,EAAE;IAIf,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAalC"}