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:

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:

Rendered diagram
  • Entity definitions with attributes

  • Primary/foreign key markers

  • Cardinality notation

  • Relationship labels

Clickable URLs on nodes:

Rendered diagram

Extension: Tooltips (ext:tooltips)

Hover descriptions:

Rendered diagram

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:

Rendered diagram

Extension: Metrics (ext:metrics)

Performance and capacity data:

Rendered diagram

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.

Last updated