edododraw 0.1.0

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2026 vivmagarwal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+The bundled hand-drawn fonts (Virgil, Excalifont) in public/fonts/ and embedded
+in the build are licensed under the SIL Open Font License, Version 1.1.
+Copyright (c) 2024 Excalidraw. See https://scripts.sil.org/OFL.

package/README.md

@@ -0,0 +1,71 @@
+<h1 align="center">✎ EDodoDraw</h1>
+<p align="center"><i>Diagrams as code — with the Excalidraw hand-drawn soul.</i></p>
+
+EDodoDraw turns a small, LLM-friendly text language into beautiful hand-drawn diagrams, then lets you **choreograph** them (magic-move camera, step-by-step presentations) and **annotate** them (highlights, arrows, callouts) — in code *or* live, with everything round-trippable back to code.
+
+```edd
+scene {
+  layout dag { direction: down }
+  ellipse    hello "Hello 👋"                 { fill: yellow }
+  rect       idea  "Diagrams as CODE"         { fill: blue }
+  round-rect vibe  "…with the Excalidraw vibe" { fill: green }
+  hello --> idea --> vibe
+  vibe  ~> hello "loop"        // ~>  == an animated flowing arrow
+}
+```
+
+## Why it exists
+
+Excalidraw is a joy to draw *by hand*. EDodoDraw is a joy to drive *by code* — while keeping the same pleasant look. It is built from the ground up (no Excalidraw runtime baggage), reusing only the good primitives: rough.js for strokes, dagre for layout, the Virgil/Excalifont hand-drawn font, and `@excalidraw/mermaid-to-excalidraw` for import.
+
+## Features
+
+- **100% code → diagram.** The primary goal. A robust DSL (`lexer → parser → compiler`) with great error messages.
+- **First-class Mermaid.** Paste `mermaid """ … """`; ids are preserved so you can choreograph and annotate imported diagrams.
+- **Magic-move camera.** `camera focus [db, cache] zoom 1.7` — smooth, interruptible, spring-eased. Pan/zoom by mouse too.
+- **Timeline presentations.** A `timeline` of `beat`s turns a static diagram into a guided walkthrough.
+- **Annotations, scripted + live.** Highlight / underline / box / circle / point-at / callout / spotlight. Draw them with the toolbar, then **commit to code**.
+- **More animated arrows** than Excalidraw: flow, dash-march, draw-on, comet, gradient-flow, electric, pulse.
+- **15+ hand-drawn shapes** + a **plugin registry** to add your own without touching the core.
+- **Export** to self-contained SVG (font embedded), PNG, or JSON.
+
+## Use it in your app
+
+```bash
+npm i edododraw
+```
+
+```js
+import { EdodoDraw } from "edododraw";
+
+const edd = new EdodoDraw(document.getElementById("diagram"));
+await edd.render(`
+  scene {
+    a([Start]) --> b[Do work] --> c{OK?}
+    c -->|yes| d(Done)
+  }
+`);
+```
+
+A React wrapper lives at `edododraw/react` (`<EdodoDrawView source={code} />`), and a
+pure, DOM-free compiler (`compileEdd(source) → { scene, diagnostics }`) is exported for
+Node/SSR. See the **[Embed guide](docs/INTEGRATION_GUIDE.md)** for the full API.
+
+## Run this repo (playground + docs site)
+
+```bash
+git clone https://github.com/vivmagarwal/edododraw.git
+cd edododraw && npm install
+npm run dev     # http://localhost:5273
+npm test        # 200+ unit tests
+```
+
+Open the app, pick an example (Welcome · Flowchart · Architecture · Animated Arrows · Mermaid), and edit the code on the left — the diagram updates live.
+
+## Docs
+
+Start with **[docs/DSL_LANGUAGE_GUIDE.md](docs/DSL_LANGUAGE_GUIDE.md)**. Architecture and feature guides are in [`docs/`](docs/); AI-agent guidance is in [CLAUDE.md](CLAUDE.md).
+
+## License
+
+The bundled fonts (Virgil, Excalifont) are under the SIL Open Font License. See `public/fonts/`.