Maybe I am missing something, but I'm having difficulty figuring out what a proper diagram definition is supposed to look like.
You could take inspiration from plantuml-editor (https://plantuml-editor.kkeisuke.com/#) and add a template/demo button that allows user to get a predefined diagram so they can experiment with it.