@chonkylang/runtime

Chonky is a machine-first web language for AI-driven development. @chonkylang/runtime is the browser (and test) runtime: requirement definitions, lightweight verification, render-metadata collection, and the dev-only wrapper that instruments React components so tools (and LLMs) can inspect UI structure without screenshots.

Project home: github.com/adisonshadow/chonky

Capabilities

• defineRequirement: Typed, structured requirement objects in source. At compile time the transpiler strips the call and emits manifest JSON; at runtime this remains an identity function so the same module runs in the browser.
• verify: Development-only assertion helper tied to requirement IDs. Failures are logged and recorded on window.__CHONKY_LOGS__ for tooling; production builds no-op and tree-shake away.
• ChonkyRenderer: Singleton that maintains window.__CHONKY_RENDER_META__—a structured graph of components, instances, props snapshots, render events, and timing—so agents can query the live UI like data.
• _ChonkyWrapper: Injected in development by the Babel plugin to wrap components, track mount/update/unmount, and feed the renderer. Removed from production bundles.
• @chonkylang/runtime/test: Vitest-oriented test entry for generated or hand-written tests around Chonky behavior.

Peer dependency

• React ^18 || ^19 (for wrapper and renderer integration).

Installation

npm install @chonkylang/runtime --save-dev

For full Chonky behavior, pair this with @chonkylang/transpiler (or @chonkylang/vite-plugin / @chonkylang/webpack-plugin) so manifests and wrappers are emitted at build time.

Chonky ecosystem (all packages)

| Package | README | | --- | --- | | @chonkylang/core | README | | @chonkylang/runtime (this package) | README | | @chonkylang/transpiler | README | | @chonkylang/cli | README | | @chonkylang/vite-plugin | README | | @chonkylang/webpack-plugin | README | | @chonkylang/ui | README | | @chonkylang/devtools | README |

License

MIT — see the repository.