excalidraw-gen 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nixon Kurian
+
+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.

package/README.md

@@ -0,0 +1,320 @@
+# excalidraw-gen
+
+A CLI tool that generates [Excalidraw](https://excalidraw.com)-compatible `.excalidraw` JSON files from structured JSON **or YAML** input specs.
+
+Define your diagram with nodes, edges, types, colors, sizes, and arrow styles — get a fully-formed Excalidraw diagram you can open immediately in the browser or desktop app.
+
+---
+
+## Features
+
+- **JSON and YAML input** — both formats supported natively
+- **Per-node style overrides** — color, size, shape, opacity, fill pattern, border style
+- **Per-edge style overrides** — stroke color, dash style, thickness, opacity
+- **DAG layout** — BFS layered layout with Kahn's algorithm (handles cyclic graphs without hanging)
+- **Dynamic node sizing** — node height auto-expands for multi-line or long labels
+- **Grid layout** — simple √n-column grid for non-hierarchical diagrams
+- **Two templates** — `flowchart` and `architecture` with distinct node styles
+- **Three themes** — `default`, `pastel`, `dark`
+- **Step-routed elbow arrows** — clearly exit the correct edge of the source node
+- **Accurate arrow labels** — labels placed at the geometric midpoint of the elbow path
+- **Pre-flight validation** — catches Excalidraw JSON issues before writing the file
+
+---
+
+## Installation
+
+```bash
+git clone https://github.com/your-username/excalidraw-gen.git
+cd excalidraw-gen
+npm install
+npm run build
+```
+
+To use globally:
+
+```bash
+npm link
+```
+
+---
+
+## Usage
+
+```bash
+excalidraw-gen generate <input> [options]
+```
+
+| Option | Default | Description |
+|---|---|---|
+| `--template` | `flowchart` | `flowchart` or `architecture` |
+| `--theme` | `default` | `default`, `pastel`, or `dark` |
+| `--layout` | `dag` | `dag` or `grid` |
+| `--out` | stdout | Output file path (`.excalidraw`) |
+| `--max-nodes <n>` | `200` | Reject diagrams with more nodes than this |
+
+### Examples
+
+```bash
+# JSON flowchart
+excalidraw-gen generate examples/simple-flowchart.json \
+  --template flowchart --out out/flow.excalidraw
+
+# YAML input
+excalidraw-gen generate examples/pipeline.yaml --out out/pipeline.excalidraw
+
+# Architecture diagram with dark theme
+excalidraw-gen generate examples/architecture.json \
+  --template architecture --theme dark --out out/arch.excalidraw
+
+# Styled flowchart with per-node/edge colors
+excalidraw-gen generate examples/styled-flowchart.json --out out/styled.excalidraw
+
+# Print to stdout (pipe-friendly)
+excalidraw-gen generate examples/simple-flowchart.json
+```
+
+Open the `.excalidraw` file at [excalidraw.com](https://excalidraw.com) via **Open** → select file.
+
+---
+
+## Input Format
+
+Input can be **JSON** or **YAML**. Both support the same fields.
+
+### JSON
+
+```json
+{
+  "type": "flowchart",
+  "title": "My Diagram",
+  "nodes": [
+    {
+      "id": "start",
+      "label": "Start",
+      "type": "start",
+      "style": {
+        "backgroundColor": "#a5d8ff",
+        "strokeColor": "#1971c2",
+        "shape": "ellipse",
+        "width": 160,
+        "height": 60
+      }
+    },
+    { "id": "process", "label": "Do Something", "type": "process" },
+    {
+      "id": "decide",
+      "label": "OK?",
+      "type": "decision",
+      "style": { "strokeStyle": "dashed", "strokeWidth": 3 }
+    },
+    { "id": "end", "label": "End", "type": "end" }
+  ],
+  "edges": [
+    { "from": "start", "to": "process" },
+    { "from": "process", "to": "decide", "label": "Check" },
+    {
+      "from": "decide",
+      "to": "end",
+      "label": "Yes",
+      "style": { "strokeColor": "#2f9e44", "strokeWidth": 2 }
+    }
+  ]
+}
+```
+
+### YAML
+
+```yaml
+type: flowchart
+title: My Diagram
+
+nodes:
+  - id: start
+    label: Start
+    type: start
+    style:
+      backgroundColor: "#a5d8ff"
+      strokeColor: "#1971c2"
+      shape: ellipse
+
+  - id: process
+    label: Do Something
+    type: process
+
+edges:
+  - from: start
+    to: process
+    label: Go
+    style:
+      strokeColor: "#7048e8"
+      strokeStyle: dashed
+```
+
+---
+
+## Style Overrides
+
+### Per-node `style` fields
+
+| Field | Type | Description |
+|---|---|---|
+| `backgroundColor` | `string` | Fill color (hex, e.g. `"#ff6b6b"` or `"transparent"`) |
+| `strokeColor` | `string` | Border color |
+| `strokeWidth` | `number` | Border thickness in px |
+| `strokeStyle` | `"solid"` \| `"dashed"` \| `"dotted"` | Border style |
+| `fillStyle` | `"solid"` \| `"hachure"` \| `"cross-hatch"` \| `"zigzag"` | Fill pattern |
+| `shape` | `"rectangle"` \| `"ellipse"` | Override the template shape |
+| `width` | `number` | Node width in px |
+| `height` | `number` | Node height in px (auto-computed if omitted) |
+| `opacity` | `number` | Opacity 0–100 |
+
+### Per-edge `style` fields
+
+| Field | Type | Description |
+|---|---|---|
+| `strokeColor` | `string` | Arrow color |
+| `strokeStyle` | `"solid"` \| `"dashed"` \| `"dotted"` | Line style |
+| `strokeWidth` | `number` | Thickness in px |
+| `opacity` | `number` | Opacity 0–100 |
+
+---
+
+## Node Types
+
+### Flowchart template
+
+| Type | Default style |
+|---|---|
+| `start` / `end` | Ellipse |
+| `process` | Rectangle (purple) |
+| `decision` | Dashed orange rectangle |
+| `io` | Rectangle (teal) |
+| `subprocess` | Rectangle (green) |
+
+### Architecture template
+
+| Type | Default style |
+|---|---|
+| `service` / `api` | Rectangle (purple) |
+| `db` / `database` | Rectangle (green) |
+| `queue` | Rectangle (yellow) |
+| `cache` | Rectangle (orange) |
+| `gateway` / `orchestrator` | Bold rectangle (red) |
+| `frontend` | Rectangle (blue) |
+| `user` / `actor` | Ellipse |
+| `external` | Rectangle (light red) |
+| `ml` / `ai` | Rectangle (purple haze) |
+| `monitor` | Rectangle (green) |
+
+> **Note:** No `diamond` shape exists in Excalidraw raw JSON. Decision nodes use a dashed orange rectangle as the canonical alternative.
+
+---
+
+## Development
+
+### Scripts
+
+```bash
+npm run build        # Compile TypeScript → dist/
+npm run dev          # Run directly via ts-node (no build needed)
+npm test             # Run all tests (vitest)
+npm run test:watch   # Watch mode
+npm run lint         # Type-check without emitting
+```
+
+### Project structure
+
+```
+src/
+  cli.ts              # Commander CLI entrypoint
+  types/              # Shared TypeScript types (NodeStyle, EdgeStyle, etc.)
+  parser/             # JSON + YAML input → Diagram object
+  validator/          # Input validation (errors + warnings)
+  normalizer/         # Defaults, ID cleanup, duplicate-edge detection
+  layout/
+    dag.ts            # Kahn's topological sort + BFS DAG layout
+    grid.ts           # Grid layout
+    arrow-router.ts   # Elbow arrow anchor + step point calculation
+  renderer/
+    elements.ts       # Shape / text / arrow element factories (with style merging)
+    index.ts          # Full render orchestration
+    seed.ts           # Deterministic ID hashing (FNV-1a)
+  templates/
+    index.ts          # flowchart + architecture template definitions
+    themes.ts         # default / pastel / dark color overlays
+  exporter/           # Assemble ExcalidrawFile, pre-flight check, write
+  validator/
+    preflight.ts      # Post-render element sanity checks
+examples/
+  simple-flowchart.json    # 5-node login flow
+  styled-flowchart.json    # Payment flow with per-node/edge style overrides
+  architecture.json        # 8-node 3-tier web app
+  pipeline.yaml            # CI/CD pipeline (YAML format)
+```
+
+---
+
+## Contributing
+
+### 1. Fork and clone
+
+```bash
+git clone https://github.com/your-username/excalidraw-gen.git
+cd excalidraw-gen
+npm install
+```
+
+### 2. Create a branch
+
+```bash
+git checkout -b feat/your-feature-name
+```
+
+Use a descriptive prefix: `feat/`, `fix/`, `docs/`, `test/`, `refactor/`.
+
+### 3. Make your changes
+
+- Keep changes focused — one concern per PR
+- Match the existing code style (TypeScript strict mode, no `any`)
+- Do not add comments or docstrings to code you didn't change
+
+### 4. Run tests and build
+
+```bash
+npm run build && npm test
+```
+
+Both must pass with zero errors before submitting.
+
+### 5. Submit a pull request
+
+Open a PR against `main` with a clear description of what changes and why.
+
+### Adding a new template
+
+1. Add a `TemplateDefinition` in `src/templates/index.ts` using `registerTemplate()`
+2. Add theme overrides in `src/templates/themes.ts` if needed
+3. Add an example JSON or YAML file under `examples/`
+4. Add tests in `tests/renderer.test.ts`
+
+### Adding a new layout engine
+
+1. Implement `(diagram: Diagram) => LayoutNode[]` in `src/layout/`
+2. Register it in `src/layout/index.ts` using `registerLayoutEngine()`
+3. Add tests in `tests/layout.test.ts`
+
+### Known Excalidraw raw JSON constraints
+
+- No `type: "diamond"` — use dashed rectangles for decision nodes
+- Labels require **two elements**: the shape with `boundElements` + a separate `text` with `containerId`
+- Arrows must have `roughness: 0`, `roundness: null`, `elbowed: true`
+- Arrow `x, y` is the **edge point** of the source shape, not the center
+- `points[0]` is always `[0, 0]`; all other points are relative offsets
+
+---
+
+## License
+
+[MIT](LICENSE)
+

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const commander_1 = require("commander");
+const index_js_1 = require("./parser/index.js");
+const index_js_2 = require("./validator/index.js");
+const index_js_3 = require("./normalizer/index.js");
+const index_js_4 = require("./templates/index.js");
+const themes_js_1 = require("./templates/themes.js");
+const index_js_5 = require("./layout/index.js");
+const index_js_6 = require("./renderer/index.js");
+const index_js_7 = require("./exporter/index.js");
+const preflight_js_1 = require("./validator/preflight.js");
+const program = new commander_1.Command();
+program
+    .name("excalidraw-gen")
+    .description("Generate Excalidraw-compatible JSON diagrams from structured input specs")
+    .version("0.1.0");
+program
+    .command("generate <input>")
+    .description("Generate an Excalidraw diagram from a JSON spec file")
+    .option("--template <name>", "Diagram template: flowchart | architecture", "flowchart")
+    .option("--theme <name>", "Color theme: default | pastel | dark", "default")
+    .option("--layout <type>", "Layout algorithm: dag | grid", "dag")
+    .option("--out <filepath>", "Output file path (default: stdout)")
+    .option("--no-deterministic", "Disable deterministic mode (enabled by default)")
+    .option("--max-nodes <n>", "Maximum nodes allowed", (v) => parseInt(v, 10), 200)
+    .action((inputPath, opts) => {
+    const options = {
+        template: opts.template,
+        theme: opts.theme,
+        layout: opts.layout,
+        out: opts.out,
+        deterministic: opts.deterministic,
+        maxNodes: opts.maxNodes,
+    };
+    try {
+        // ── 1. Read input ──────────────────────────────────────────────────
+        let inputContent;
+        try {
+            inputContent = (0, fs_1.readFileSync)(inputPath, "utf-8");
+        }
+        catch {
+            process.stderr.write(`Error: Cannot read file "${inputPath}"\n`);
+            process.exit(1);
+        }
+        // ── 2. Parse ───────────────────────────────────────────────────────
+        let diagram;
+        try {
+            diagram = (0, index_js_1.parse)(inputContent);
+        }
+        catch (err) {
+            if (err instanceof index_js_1.ParseError) {
+                process.stderr.write(`Parse error: ${err.message}\n`);
+                process.exit(1);
+            }
+            throw err;
+        }
+        // ── 3. Validate (input) ────────────────────────────────────────────
+        const { errors, warnings } = (0, index_js_2.validate)(diagram, { maxNodes: options.maxNodes });
+        for (const warn of warnings) {
+            process.stderr.write(`Warning: ${warn}\n`);
+        }
+        if (errors.length > 0) {
+            for (const err of errors) {
+                process.stderr.write(`Error: ${err}\n`);
+            }
+            process.exit(1);
+        }
+        // ── 4. Normalize ───────────────────────────────────────────────────
+        const { diagram: normalDiagram, warnings: normWarnings } = (0, index_js_3.normalize)(diagram);
+        for (const warn of normWarnings) {
+            process.stderr.write(`Warning: ${warn}\n`);
+        }
+        // ── 5. Layout ──────────────────────────────────────────────────────
+        const layoutNodes = (0, index_js_5.runLayout)(normalDiagram, options.layout);
+        // ── 6. Template + Theme ────────────────────────────────────────────
+        const baseTemplate = (0, index_js_4.getTemplate)(options.template);
+        const template = (0, themes_js_1.applyThemeToTemplate)(baseTemplate, options.theme);
+        // ── 7. Render ──────────────────────────────────────────────────────
+        const elements = (0, index_js_6.render)(normalDiagram, layoutNodes, template);
+        // ── 8. Export ──────────────────────────────────────────────────────
+        if (options.out) {
+            (0, index_js_7.exportToFile)(elements, options.theme, options.out);
+            process.stderr.write(`✓ Diagram written to ${options.out}\n`);
+        }
+        else {
+            (0, index_js_7.exportToStdout)(elements, options.theme);
+        }
+    }
+    catch (err) {
+        if (err instanceof preflight_js_1.PreflightError) {
+            process.stderr.write(`${err.message}\n`);
+            process.exit(1);
+        }
+        if (err instanceof Error) {
+            process.stderr.write(`Unexpected error: ${err.message}\n`);
+        }
+        else {
+            process.stderr.write(`Unexpected error: ${String(err)}\n`);
+        }
+        process.exit(1);
+    }
+});
+program.parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/exporter/index.d.ts

@@ -0,0 +1,4 @@
+import type { ExcalidrawElement, ExcalidrawFile, Theme } from "../types/index.js";
+export declare function buildExcalidrawFile(elements: ExcalidrawElement[], theme: Theme): ExcalidrawFile;
+export declare function exportToFile(elements: ExcalidrawElement[], theme: Theme, outputPath: string): void;
+export declare function exportToStdout(elements: ExcalidrawElement[], theme: Theme): void;

package/dist/exporter/index.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildExcalidrawFile = buildExcalidrawFile;
+exports.exportToFile = exportToFile;
+exports.exportToStdout = exportToStdout;
+const fs_1 = require("fs");
+const preflight_js_1 = require("../validator/preflight.js");
+const themes_js_1 = require("../templates/themes.js");
+function buildExcalidrawFile(elements, theme) {
+    return {
+        type: "excalidraw",
+        version: 2,
+        source: "excalidraw-gen",
+        elements,
+        appState: {
+            gridSize: 20,
+            viewBackgroundColor: (0, themes_js_1.getViewBackground)(theme),
+        },
+        files: {},
+    };
+}
+function exportToFile(elements, theme, outputPath) {
+    (0, preflight_js_1.preflightValidate)(elements);
+    const file = buildExcalidrawFile(elements, theme);
+    const json = JSON.stringify(file, null, 2);
+    (0, fs_1.writeFileSync)(outputPath, json, "utf-8");
+}
+function exportToStdout(elements, theme) {
+    (0, preflight_js_1.preflightValidate)(elements);
+    const file = buildExcalidrawFile(elements, theme);
+    process.stdout.write(JSON.stringify(file, null, 2) + "\n");
+}
+//# sourceMappingURL=index.js.map

package/dist/exporter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/exporter/index.ts"],"names":[],"mappings":";;AAKA,kDAeC;AAED,oCASC;AAED,wCAOC;AAxCD,2BAAmC;AAEnC,4DAA8D;AAC9D,sDAA2D;AAE3D,SAAgB,mBAAmB,CACjC,QAA6B,EAC7B,KAAY;IAEZ,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,gBAAgB;QACxB,QAAQ;QACR,QAAQ,EAAE;YACR,QAAQ,EAAE,EAAE;YACZ,mBAAmB,EAAE,IAAA,6BAAiB,EAAC,KAAK,CAAC;SAC9C;QACD,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED,SAAgB,YAAY,CAC1B,QAA6B,EAC7B,KAAY,EACZ,UAAkB;IAElB,IAAA,gCAAiB,EAAC,QAAQ,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3C,IAAA,kBAAa,EAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,SAAgB,cAAc,CAC5B,QAA6B,EAC7B,KAAY;IAEZ,IAAA,gCAAiB,EAAC,QAAQ,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC7D,CAAC"}

package/dist/layout/arrow-router.d.ts

@@ -0,0 +1,14 @@
+import type { LayoutNode, ArrowRoute } from "../types/index.js";
+/**
+ * Minimum y-difference to consider nodes as being on different rows.
+ * Matches SPACING_Y * 0.4 from the layout engine (150 * 0.4 = 60).
+ * Exported so the renderer can use the same threshold for stagger grouping.
+ */
+export declare const VERTICAL_THRESHOLD = 60;
+/**
+ * Route an elbow arrow from source → target nodes.
+ *
+ * @param sourceEdgeIndex  0-based index of this arrow among all arrows sharing the same source edge
+ * @param totalFromSource  total count of arrows leaving from the same edge of source
+ */
+export declare function routeArrow(source: LayoutNode, target: LayoutNode, sourceEdgeIndex?: number, totalFromSource?: number): ArrowRoute;