@chamuka-labs/engine

Embeddable Chamuka DrawIt engine — a Rust-WASM diagramming core with a minimal host API. Use this package to embed the Chamuka canvas in Storybook, docs sites, a CMS, the VSCode extension webview, or any other host that can run modern ESM + WebAssembly.

Install

npm install @chamuka-labs/engine
# or
pnpm add @chamuka-labs/engine

Quickstart

import { createEngine } from '@chamuka-labs/engine';

const engine = await createEngine();
engine.loadDocument(myChamukaDoc);
const renderer = await engine.renderInto(
  document.getElementById('canvas')!
);
engine.onEvent((e) => console.log(e));

// later…
renderer.resize(1024, 768);
renderer.dispose();

API

• createEngine(options?) — async factory; resolves to an Engine.
• Engine.loadDocument(json) — load a parsed .chamuka document.
• Engine.toJSON() — serialize the current document.
• Engine.renderInto(target, options?) — async; mounts a PixiJS renderer into target and resolves with a Renderer once WebGL is ready.
• Engine.onEvent(listener) — subscribe to engine events. Returns an Unsubscribe function.
• Engine.dispose() — release resources (including every renderer it handed out). Safe to call twice.

Stability

This is a 0.x release — the public surface may change between minor versions. We will freeze the contract at 1.0.

Status

0.2.0 wires the PixiJS renderer; the canvas now actually paints. See docs/embed-sdk.md for the full host guide. Production-ready target remains Q4 per the strategic plan.