Volodymyr Pavlyshyn22 downloadsDesign and simulate vertep statecharts: SCXML and YAML chart files, chart code blocks and embeds.
A visual designer and simulator for vertep statecharts: draw a chart, edit it, validate it and drive it with events, without writing code.
The name is the vertepnyk (вертепник), the puppeteer who builds the vertep box and runs the show. Vertep charts are the stage whose slots the puppets move along; vertepnyk is where you cut the slots and try the play.
Website: volland.github.io/vertep/vertepnyk.html · Article: Two hands on one chart: co-designing with Claude Code
*.scxml) and vertep YAML (*.vt.yaml) charts: atomic, compound, parallel, final and history states, transitions, the datamodel and executable content.Version 0.1.0 is a preview.
code --install-extension pavlyshyn.vertepnyk-vscode). For Cursor, VSCodium and other VS Code builds it is on Open VSX. Open a chart with Open With… > Vertepnyk Designer.main.js, manifest.json and styles.css from the 0.1.0 release into <vault>/.obsidian/plugins/vertepnyk/ (or unpack vertepnyk-obsidian-0.1.0.zip into .obsidian/plugins/), then enable it under Community plugins. The plugin is self-contained: those three files are all it needs.Vertepnyk-0.1.0-universal.dmg from the release (not notarized yet: open it the first time with right-click > Open). Windows and Linux: build from source.pnpm install
pnpm build
pnpm dev # web shell
pnpm --filter vertepnyk-vscode run package # VS Code extension (.vsix)
pnpm --filter vertepnyk-electron run dist # desktop app for this OS
Until @vertep/web and @vertep/dm-ecma are on npm, pnpm-workspace.yaml links them from a sibling vertep checkout (../vertep, 0.1.4 or later); build them first with npm run build in its bindings/js.
M1 to M5 are implemented: all 71 requirements are implemented and verified. Known limitations:
Vertep 0.1.3 on crates.io does not yet treat the vl: layout namespace as formatting, so its vt hash changes when layout changes; the engine bundled here already ignores layout, and the next vertep release will too.
Automatic layout is written into the file when it first opens, so a fresh chart shows as modified, and in VS Code that undo takes two presses.
.vt.yaml cannot be bound by extension in Obsidian or Electron. The Obsidian plugin is checked in real Obsidian 1.14 with pnpm --filter vertepnyk-obsidian run test:real.
Specs: openspec/changes/designer-core and openspec/changes/editor-hosts
Design intent as a typed graph: tg.md/ (tg check, tg cypher)
Roadmap: tg.md/roadmap.md
Stack: TypeScript, SolidJS, SVG, elkjs, pnpm workspaces, Vite, Vitest, Playwright, @vertep/web.
Licensed under either of Apache License, Version 2.0 or MIT license at your option (see LICENSE).