Changelog

All notable changes to TDL.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

---

[Unreleased]

Added

• Documentation restructure for GitBooks

• Expanded cookbook with cloud provider examples

• Comprehensive reference section

Changed

• Improved error messages with line numbers

Fixed

• Edge styling override precedence

---

[0.1.0] - 2024-XX-XX

Added

Core Language

• Diagram type declarations: @arch, @seq, @flow

• Draft types: @state, @er

• Node definitions with 12 shapes

• Edge operators: ->, -->, .., <->, <-->

• Edge labels and styling

• Groups (block and compact syntax)

• Nested groups

• Named styles with [styles] section

• Animated flows with [flow:name] section

• Tag definitions with [tags] section

Extensions

• ext:icons - 200+ cloud provider and generic icons

  • AWS namespace (aws-*)

  • Azure namespace (azure-*)

  • GCP namespace (gcp-*)

  • Generic icons

• ext:code - Code block attachments

Tooling

• VS Code extension with syntax highlighting

• Live preview panel

• Export to PNG and SVG

• Web editor at architoon.xyz

• MCP server for AI integration

Documentation

• Language specification v0.1

• Getting started guide

• Syntax reference

• Extension authoring guide

Architecture Decisions

• Hand-rolled parser for best error messages

• Dagre layout engine for auto-positioning

• SVG rendering for web compatibility

• Indentation-based syntax (no brackets)

• Token-efficient design for AI generation

---

Version History

Version	Date	Highlights
0.1.0	TBD	Initial pre-release

---

Migration Guides

Migrating from Mermaid

TDL syntax differences:

# TDL
@arch
[nodes]
  a:API Gateway
  b:User Service
  c:Order Service

[edges]
  a->b
  a->c

Rendered diagram

• No quotes needed for simple labels

• Separate [nodes] and [edges] sections

• Different edge syntax (-> not -->)

• Indentation-based structure

Migrating from PlantUML

# PlantUML
@startuml
component "API Gateway" as api
database "PostgreSQL" as db
api --> db : queries
@enduml

# TDL
@arch
[nodes]
  api:API Gateway
  db:PostgreSQL|cyl

[edges]
  api->db:queries

Rendered diagram

• No @startuml/@enduml wrapper

• Shape specified with |cyl not database

• Simpler edge syntax

---

Deprecations

None yet.

---

Breaking Changes Policy

During the 0.x series, breaking changes may occur between minor versions. We will:

1. Document all breaking changes in this changelog

2. Provide migration guides where needed

3. Give advance notice in release notes

After 1.0, we will follow semver strictly:

• Major versions: breaking changes

• Minor versions: new features, backwards compatible

• Patch versions: bug fixes only