The framework-free parser boundary and the current validation suite.
Build, test, and extend
Quality gate
npm test
npm run build
# or both:
npm run check
Node's built-in test runner covers clean and noisy logs, missing and malformed tables, irregular indentation, category precedence, and name fallbacks. esbuild bundles the renderer for Electron.
Where to make changes
| File | Responsibility |
|---|---|
| src/topologyParser.js | Transcript normalization, table location, row parsing, and hierarchy construction. |
| src/typeInference.js | Ordered category names, substrings, and colors. |
| src/blockDiagramRenderer.js | Layout, rendering, pan/zoom, search, expansion, and selection. |
| src/renderer.js | Page state, file-open workflow, controls, errors, and inspector. |
| main.cjs / preload.cjs | Electron window and narrow file-open bridge. |
Protect proprietary logs
Add synthetic, minimized fixtures for parser bugs. Do not attach a proprietary simulator transcript to a public issue; reduce it to the smallest topology table that reproduces the behavior.