@guitarvydas re https://open.substack.com/pub/programmingsimplicity/p/on-programming-using-non-gutenberg, you might like this attempt of mine at introducing a graphical overview to a program: https://akkartik.name/2025-03-02-chessboard The drawback: I'm not trying to turn the diagrams into executable code. They're just documentation, but at a level that's not onerous to keep updated, then falling back on raw/eldritch textual code for the heavy lifting.

What's inside your text+diagram file? What does it look like?

The way I'm imagining it it's just a little markup language of drawing commands. https://git.sr.ht/~akkartik/luaML.love but with some support for a "link target" that the view switches to when you click on a rectangular area. Basically making image maps in html is quite tedious. This is image maps but well-integrated with a vector- rather than pixel-drawing system.