docviz-builder 0.1.0

package/dist/themes/types.js

@@ -0,0 +1,9 @@
+/**
+ * Modelo de tema (seccion 14 de la especificacion).
+ *
+ * Un tema describe la misma identidad visual expresada en el dialecto de cada
+ * motor, para que un PlantUML, un D2 y un Vega-Lite del mismo documento se vean
+ * como piezas de la misma familia.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/themes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/themes/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/eval/casos.json

@@ -0,0 +1,513 @@
+[
+  {
+    "id": "login",
+    "necesidad": "Explicar como se autentica un usuario: el navegador llama a la API, la API consulta la base de datos y devuelve un token.",
+    "tipo": "sequence",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "pago-async",
+    "necesidad": "Mostrar el orden de las llamadas entre el frontend, la pasarela de pago y el webhook que confirma el cobro.",
+    "tipo": "sequence",
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "estados-pedido",
+    "necesidad": "Los estados por los que pasa un pedido y como se mueve entre ellos: creado, pagado, enviado, entregado, cancelado.",
+    "tipo": "state",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "estados-ticket",
+    "necesidad": "El ciclo de vida de un ticket de soporte con sus transiciones y reintentos.",
+    "tipo": "state",
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "aprobacion",
+    "necesidad": "El proceso de aprobacion de una solicitud de vacaciones, con la decision del jefe y las dos ramas posibles.",
+    "tipo": "activity",
+    "acepta": [
+      "activity",
+      "flow"
+    ],
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "alta-cliente",
+    "necesidad": "El recorrido de extremo a extremo del alta de un cliente, paso a paso y sin decisiones complicadas.",
+    "tipo": "flow",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "modelo-datos",
+    "necesidad": "Las entidades de la base de datos, sus campos y la cardinalidad entre cliente, pedido y linea de pedido.",
+    "tipo": "erd",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "clases",
+    "necesidad": "La estructura de clases del dominio y como heredan unas de otras.",
+    "tipo": "class",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "actores",
+    "necesidad": "Que puede hacer cada actor con el sistema: el cliente, el operador y el administrador.",
+    "tipo": "use-case",
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "componentes",
+    "necesidad": "Los modulos de software del backend, agrupados por responsabilidad, y como se conectan entre si.",
+    "tipo": "component",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "infra",
+    "necesidad": "Sobre que infraestructura se ejecuta cada pieza: servidores, contenedores y base de datos.",
+    "tipo": "deployment",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "pantalla",
+    "necesidad": "Un boceto de la pantalla de registro con sus campos y botones.",
+    "tipo": "wireframe",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "estructura-json",
+    "necesidad": "La estructura de un JSON de respuesta dibujada como arbol.",
+    "tipo": "json",
+    "nombraTipo": true,
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "wbs",
+    "necesidad": "La descomposicion jerarquica del trabajo del proyecto en paquetes y tareas.",
+    "tipo": "wbs",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "cronograma",
+    "necesidad": "Las tareas del proyecto situadas en el calendario, con sus fechas de inicio y fin.",
+    "tipo": "gantt",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "hitos",
+    "necesidad": "Los hitos de la empresa en orden cronologico, de 2020 a 2026.",
+    "tipo": "timeline",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "fases",
+    "necesidad": "Las fases futuras del producto y que contiene cada una.",
+    "tipo": "roadmap",
+    "acepta": [
+      "roadmap",
+      "timeline"
+    ],
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "experiencia",
+    "necesidad": "El recorrido de un paciente por el proceso de cita, con su nivel de satisfaccion en cada paso.",
+    "tipo": "journey",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "ramas-git",
+    "necesidad": "La historia de ramas, commits y fusiones del repositorio.",
+    "tipo": "git-graph",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "tablero",
+    "necesidad": "Las tarjetas del equipo repartidas por columna de estado.",
+    "tipo": "kanban",
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "priorizacion",
+    "necesidad": "Situar las iniciativas segun esfuerzo e impacto en dos ejes continuos.",
+    "tipo": "quadrant",
+    "acepta": [
+      "quadrant",
+      "matrix-2x2"
+    ],
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "reparto",
+    "necesidad": "Como se reparte el presupuesto al pasar de las areas a los proyectos concretos.",
+    "tipo": "sankey",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "perfil",
+    "necesidad": "El perfil de un equipo en cinco dimensiones a la vez para compararlo con el objetivo.",
+    "tipo": "radar",
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "objetivo",
+    "necesidad": "Descomponer el objetivo anual en lineas de accion y sus iniciativas.",
+    "tipo": "strategy-tree",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "causas",
+    "necesidad": "Descomponer el problema de la rotacion de personal en sus causas raiz.",
+    "tipo": "issue-tree",
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "capacidades",
+    "necesidad": "Las capacidades de negocio agrupadas por dominio.",
+    "tipo": "capability-map",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "cadena",
+    "necesidad": "Las etapas encadenadas que generan valor, de la compra a la entrega.",
+    "tipo": "value-chain",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "antes-despues",
+    "necesidad": "Comparar como era el proceso antes y como queda despues del cambio.",
+    "tipo": "before-after",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "dependencias",
+    "necesidad": "Que microservicio depende de cual, para ver que se rompe si cae uno.",
+    "tipo": "dependency-map",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "bpmn",
+    "necesidad": "El proceso de negocio de facturacion en notacion BPMN estandar, con sus carriles.",
+    "tipo": "bpmn",
+    "nombraTipo": true,
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "ventas-region",
+    "necesidad": "Comparar las ventas de este trimestre entre las cinco regiones.",
+    "tipo": "bar",
+    "acepta": [
+      "bar",
+      "horizontal-bar"
+    ],
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "etiquetas-largas",
+    "necesidad": "Comparar el gasto por departamento, y los nombres de los departamentos son largos.",
+    "tipo": "horizontal-bar",
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "composicion",
+    "necesidad": "Como se compone la facturacion total de cada mes por linea de producto.",
+    "tipo": "stacked-bar",
+    "acepta": [
+      "stacked-bar",
+      "stacked-area"
+    ],
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "tendencia",
+    "necesidad": "La evolucion del numero de usuarios activos mes a mes durante el ultimo ano.",
+    "tipo": "line",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "correlacion",
+    "necesidad": "Si existe relacion entre el tamano del equipo y el tiempo de entrega, punto a punto.",
+    "tipo": "scatter",
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "distribucion",
+    "necesidad": "Como se distribuyen los tiempos de respuesta en tramos, para ver donde se concentran.",
+    "tipo": "histogram",
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "dispersion",
+    "necesidad": "Comparar la mediana y la dispersion del tiempo de resolucion entre cuatro equipos.",
+    "tipo": "box-plot",
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "objetivo-kpi",
+    "necesidad": "Un indicador con su valor actual frente al objetivo y los rangos de referencia.",
+    "tipo": "bullet",
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "embudo",
+    "necesidad": "Cuanta gente sobrevive a cada paso del proceso de registro, de la visita a la compra.",
+    "tipo": "funnel",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "porcentajes",
+    "necesidad": "El reparto porcentual del presupuesto entre cuatro partidas.",
+    "tipo": "pie",
+    "acepta": [
+      "pie",
+      "donut"
+    ],
+    "idioma": "es",
+    "particion": "reservado"
+  },
+  {
+    "id": "puente",
+    "necesidad": "Como se pasa del resultado del ano pasado al de este, sumando y restando cada efecto.",
+    "tipo": "waterfall",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "calor",
+    "necesidad": "La intensidad de uso por dia de la semana y hora del dia.",
+    "tipo": "heatmap",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "contexto",
+    "necesidad": "Quien usa el sistema y con que sistemas externos habla, a vista de pajaro.",
+    "tipo": "c4-context",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "contenedores",
+    "necesidad": "Las piezas desplegables del sistema —web, API, base de datos— y como se comunican.",
+    "tipo": "c4-container",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "componentes-c4",
+    "necesidad": "Las piezas internas de la API y sus responsabilidades, dentro del modelo C4.",
+    "tipo": "c4-component",
+    "idioma": "es",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "en-login",
+    "idioma": "en",
+    "necesidad": "Explain how a user signs in: the browser calls the API, the API checks the database and returns a token.",
+    "tipo": "sequence",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "en-order-states",
+    "idioma": "en",
+    "necesidad": "What an order goes through and how it moves from created to paid, shipped and delivered.",
+    "tipo": "state",
+    "particion": "reservado"
+  },
+  {
+    "id": "en-approval",
+    "idioma": "en",
+    "necesidad": "The approval process for a time-off request, with the manager decision and the two possible branches.",
+    "tipo": "activity",
+    "acepta": [
+      "activity",
+      "flow"
+    ],
+    "particion": "reservado"
+  },
+  {
+    "id": "en-data-model",
+    "idioma": "en",
+    "necesidad": "The database entities, their fields and the cardinality between customer, order and order line.",
+    "tipo": "erd",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "en-infra",
+    "idioma": "en",
+    "necesidad": "Which infrastructure each piece runs on: servers, containers and the database.",
+    "tipo": "deployment",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "en-deps",
+    "idioma": "en",
+    "necesidad": "Which microservice depends on which, so we can see what breaks when one goes down.",
+    "tipo": "dependency-map",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "en-schedule",
+    "idioma": "en",
+    "necesidad": "The project tasks placed on the calendar, with their start and end dates.",
+    "tipo": "gantt",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "en-milestones",
+    "idioma": "en",
+    "necesidad": "The company milestones in chronological order, from 2020 to 2026.",
+    "tipo": "timeline",
+    "particion": "reservado"
+  },
+  {
+    "id": "en-board",
+    "idioma": "en",
+    "necesidad": "The team cards split across status columns.",
+    "tipo": "kanban",
+    "particion": "reservado"
+  },
+  {
+    "id": "en-priorities",
+    "idioma": "en",
+    "necesidad": "Place the initiatives by effort and impact on two continuous axes.",
+    "tipo": "quadrant",
+    "acepta": [
+      "quadrant",
+      "matrix-2x2"
+    ],
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "en-root-cause",
+    "idioma": "en",
+    "necesidad": "Break the staff turnover problem down into its root causes.",
+    "tipo": "issue-tree",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "en-objective",
+    "idioma": "en",
+    "necesidad": "Break the annual objective down into action lines and their initiatives.",
+    "tipo": "strategy-tree",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "en-sales",
+    "idioma": "en",
+    "necesidad": "Compare this quarter sales across the five regions.",
+    "tipo": "bar",
+    "acepta": [
+      "bar",
+      "horizontal-bar"
+    ],
+    "particion": "reservado"
+  },
+  {
+    "id": "en-long-labels",
+    "idioma": "en",
+    "necesidad": "Compare spend per department, and the department names are long.",
+    "tipo": "horizontal-bar",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "en-trend",
+    "idioma": "en",
+    "necesidad": "How the number of active users evolved month by month over the last year.",
+    "tipo": "line",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "en-distribution",
+    "idioma": "en",
+    "necesidad": "How response times spread across buckets, to see where they concentrate.",
+    "tipo": "histogram",
+    "particion": "reservado"
+  },
+  {
+    "id": "en-funnel",
+    "idioma": "en",
+    "necesidad": "How many people survive each step of the signup process, from visit to purchase.",
+    "tipo": "funnel",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "en-composition",
+    "idioma": "en",
+    "necesidad": "How each month total revenue breaks down by product line.",
+    "tipo": "stacked-bar",
+    "acepta": [
+      "stacked-bar",
+      "stacked-area"
+    ],
+    "particion": "reservado"
+  },
+  {
+    "id": "en-correlation",
+    "idioma": "en",
+    "necesidad": "Whether there is a relationship between team size and delivery time, point by point.",
+    "tipo": "scatter",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "en-waterfall",
+    "idioma": "en",
+    "necesidad": "How we get from last year result to this one, adding and subtracting each effect.",
+    "tipo": "waterfall",
+    "particion": "entrenamiento"
+  },
+  {
+    "id": "en-context",
+    "idioma": "en",
+    "necesidad": "Who uses the system and which external systems it talks to, from a bird eye view.",
+    "tipo": "c4-context",
+    "particion": "reservado"
+  },
+  {
+    "id": "en-containers",
+    "idioma": "en",
+    "necesidad": "The deployable pieces of the system —web, API, database— and how they communicate.",
+    "tipo": "c4-container",
+    "particion": "entrenamiento"
+  }
+]

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "docviz-builder",
+  "version": "0.1.0",
+  "description": "Compila bloques declarativos de diagramas dentro de Markdown a imagenes SVG/PNG, produciendo Markdown estandar y portable.",
+  "keywords": [
+    "diagrams",
+    "diagrams-as-code",
+    "markdown",
+    "documentation",
+    "plantuml",
+    "mermaid",
+    "d2",
+    "graphviz",
+    "vega-lite",
+    "likec4",
+    "c4",
+    "uml",
+    "svg",
+    "mcp",
+    "ai-agents",
+    "llm",
+    "architecture"
+  ],
+  "homepage": "https://github.com/TilsonF/docviz-builder#readme",
+  "bugs": {
+    "url": "https://github.com/TilsonF/docviz-builder/issues"
+  },
+  "author": "Tilson Fernandez",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.11"
+  },
+  "bin": {
+    "docviz": "./bin/docviz.mjs"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "bin",
+    "dist",
+    "scripts",
+    "eval",
+    "skills",
+    "vendor/.gitkeep",
+    "README.md",
+    "AGENTS.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "setup": "node scripts/fetch-plantuml.mjs",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "docviz": "node --experimental-strip-types bin/docviz.mjs",
+    "docs:check": "npm run docs:sync:check && node bin/docviz.mjs check docs-src",
+    "docs:build": "node bin/docviz.mjs build docs-src --output docs",
+    "docs:verify": "node bin/docviz.mjs verify docs",
+    "docs:test": "npm run docs:verify && vitest run tests/integration",
+    "docs:preview": "node bin/docviz.mjs preview docs",
+    "showcase": "node bin/docviz.mjs build examples --output artifacts/showcase --clean",
+    "test": "vitest run",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration",
+    "eval": "node scripts/eval.mjs",
+    "eval:modelo": "node scripts/eval.mjs --modelo",
+    "mcp": "node bin/docviz-mcp.mjs",
+    "catalog": "node scripts/generate-catalog-doc.mjs",
+    "docs:sync": "node scripts/sync-docs.mjs && node scripts/generate-catalog-doc.mjs",
+    "docs:sync:check": "node scripts/sync-docs.mjs --check",
+    "check:github": "node scripts/check-github.mjs docs",
+    "test:coverage": "vitest run --coverage",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@hpcc-js/wasm-graphviz": "^1.28.0",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@terrastruct/d2": "^0.1.33",
+    "bpmn-js": "^18.24.0",
+    "commander": "^14.0.2",
+    "likec4": "^1.59.2",
+    "mdast-util-to-string": "^4.0.0",
+    "mermaid": "^11.16.1",
+    "puppeteer-core": "^25.5.0",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-parse": "^11.0.0",
+    "svgbob-wasm": "^1.0.0",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.0.0",
+    "vega": "^6.3.1",
+    "vega-lite": "^6.4.3",
+    "yaml": "^2.8.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.125.0",
+    "@fission-ai/openspec": "^1.8.0",
+    "@types/node": "^24.0.0",
+    "@vitest/coverage-v8": "^5.0.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.9.0",
+    "vitest": "^5.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TilsonF/docviz-builder.git"
+  }
+}