Ambastha-Diagrams

A high-performance, modular diagram rendering ecosystem designed for headless SVG generation and serverless integration. The project is structured as a multi-package architecture, decoupling the core rendering logic from the diagram registry and user-facing editor.

Overview

Ambastha-Diagrams provides a lightweight, zero-dependency alternative for generating structural diagrams. By utilizing native SVG and standard ECMAScript Modules (ESM), it offers high-speed rendering with minimal memory overhead, suitable for both client-side and server-side environments.

Dual-Categorization Logic

Unlike traditional tools that treat all diagrams as manual drawing tasks, this engine categorizes visualization into two distinct workflows:

1. Deterministic (Data-Driven): For diagrams where the layout is a result of mathematical constraints (e.g., CPM, PERT, Sequence). The user provides the raw data and dependencies; the engine automatically calculates the Critical Path, time-scales, and optimal routing.
2. Declarative (Structure-Driven): For diagrams where the user defines the visual relationship and hierarchy (e.g., Use Case, Flowcharts). The engine ensures structural integrity and consistent styling without "fussy" syntax or manual coordinate management.

Technical Specifications

• Package Size: ~642 KB
• Disk Footprint: ~1.20 MB
• Architecture: Modular (Core / Registry / Editor)
• License: Apache License 2.0
• Environment: Web-friendly (VS Code Web, Browser, Node.js)

Core Features

• Lightweight Rendering: Optimized SVG output without external dependencies like D3.js.
• Modular Registry: Pluggable architecture allowing for specific diagram types to be added or removed as needed.
• Web-First Integration: Fully compatible with VS Code Web extensions and browser-based editors.
• Deterministic Layouts: Precise coordinate calculation for complex routing, including native support for self-loops and multi-dependency nodes.
• Agent-Friendly Syntax: A streamlined DSL designed to minimize LLM hallucinations (e.g., inconsistent colons or delimiters).

Project Structure

• core/: The foundational rendering and AST parsing logic.
• registry/: A collection of diagram-specific implementations (CPM, PERT, Use Case) and templates.
• editor/: A lightweight, web-based interface for live diagram preview and editing.

Installation & Usage

Refer to the specific package documentation for implementation details. The engine can be integrated via ESM imports or served through standard CDNs for direct browser execution.

License

This project is licensed under the . See the LICENSE and NOTICE files for more information.