Roadmap

Planned features and improvements for TDL.

Current Status

Version: 0.1 (Pre-release)

Stable Features

Feature	Status	Notes
Architecture diagrams (@arch)	Stable	Full support
Sequence diagrams (@seq)	Stable	Full support
Flowcharts (@flow)	Stable	Full support
12 node shapes	Stable	rect, cyl, cloud, etc.
5 edge operators	Stable	->, -->, .., <->, <-->
Groups	Stable	Block and compact syntax
Named styles	Stable	[styles] section
Animated flows	Stable	[flow:name] sections
ext:icons	Stable	200+ icons
ext:code	Stable	Code attachments

Draft/Planned Features

Feature	Status	Target
State diagrams (@state)	Draft	v0.2
ER diagrams (@er)	Draft	v0.2
ext:links	Draft	v0.2
ext:tooltips	Draft	v0.2
Expandable groups	Beta	v0.2
Tag overlays	Beta	v0.2

---

Version 0.2

Focus: Complete diagram type coverage

State Machine Diagrams (@state)

Full support for state machine diagrams:

@state
[states]
  idle:Idle|initial
  loading:Loading
  ready:Ready
  error:Error
  closed:Closed|final

[transitions]
  idle->loading:start
  loading->ready:success
  loading->error:failure
  ready->loading:refresh
  error->idle:retry
  ready->closed:close

Rendered diagram

• Initial and final state markers

• Transition labels

• Guard conditions

• Entry/exit actions

• Composite states

Entity-Relationship Diagrams (@er)

Full support for database modeling:

@er
[entities]
  User
    id: UUID PK
    email: VARCHAR(255) UNIQUE
    name: VARCHAR(100)

  Order
    id: UUID PK
    user_id: UUID FK
    total: DECIMAL

[relationships]
  User ||--o{ Order: places

Rendered diagram

• Entity definitions with attributes

• Primary/foreign key markers

• Cardinality notation

• Relationship labels

Extension: Links (ext:links)

Clickable URLs on nodes:

@arch
#!ext links

[nodes]
  api:API Gateway|url:https://docs.example.com/api
  dashboard:Dashboard|url:/internal/dashboard

Rendered diagram

Extension: Tooltips (ext:tooltips)

Hover descriptions:

@arch
#!ext tooltips

[nodes]
  api:API Gateway|tooltip:"Handles all incoming requests\nRate limited to 1000 req/s"

Rendered diagram

Version 0.3

Focus: Enhanced interactivity and collaboration

Planned Features

Feature	Description
Diagram embedding	Embed TDL diagrams in other TDL documents
Variables	Reusable values: $primary: #3B82F6
Conditionals	Show/hide based on conditions
Comments on nodes	Collaborative annotations
Version diffing	Visual diff between versions

Extension: Status (ext:status)

Component lifecycle status:

@arch
#!ext status

[nodes]
  legacy:Legacy API|status:deprecated
  new_api:New API|status:beta
  stable:Core Service|status:stable

Rendered diagram

Extension: Metrics (ext:metrics)

Performance and capacity data:

@arch
#!ext metrics

[nodes]
  api:API|latency:45ms|throughput:10k/s
  db:Database|cyl|storage:500GB|cpu:45%

Rendered diagram

Version 1.0

Focus: Production readiness

Planned Features

Feature	Description
Stable API	Guaranteed backwards compatibility
Full test coverage	Comprehensive test suite
Performance optimization	Large diagram support
Accessibility	Screen reader support
Localization	Multi-language labels

Breaking Changes

Before 1.0, we may make breaking changes to:

• Syntax adjustments for consistency

• Extension API refinements

• Error code standardization

---

Future Ideas

These are ideas under consideration, not committed:

Idea	Description
Live data integration	Real-time metrics from monitoring systems
Diagram templates	Reusable architecture patterns
Collaboration	Real-time multi-user editing
Version control integration	Git-aware diagram history
AI assistance	Smart suggestions while editing
Export formats	PDF, PNG sequences, animated GIF
Import from	Convert Mermaid/PlantUML to TDL

---

How to Contribute

We welcome contributions! See the Contributing Guide for:

• Reporting bugs

• Requesting features

• Submitting pull requests

• Writing documentation

Feature Requests

Open an issue on GitHub with:

1. Use case description

2. Proposed syntax (if applicable)

3. Examples

Priority Input

Star and comment on GitHub issues to help us prioritize.

---

Changelog

See the Changelog for release history.