Compare commits

..

1 commit

Author SHA1 Message Date
Alexander Wang
0b57054f5a
v0.3.13 2024-04-10 20:54:37 -07:00
5 changed files with 24 additions and 58 deletions

View file

@ -7,16 +7,12 @@
TALA is a diagram layout engine designed specifically for software architecture diagrams,
though it works well in other domains too.
TALA is closed-source. This repository is primarily for installation instructions. You can
also use this repository to report issues, ask questions, and request features.
though it works well in other domains too. TALA is closed-source. This repository is
primarily for installation instructions. You can also use this repository to report
issues, ask questions, and request features.
To learn more about TALA, please visit
[https://terrastruct.com/tala](https://terrastruct.com/tala). Note that this is a paid
layout engine, which requires a license for any commercial use. The license is purchasable
in that same link. TALA is free to evaluate, but without a license, will render with a
watermark.
[https://terrastruct.com/tala](https://terrastruct.com/tala).
To compare TALA with other layout engines, please visit
[https://text-to-diagram.com](https://text-to-diagram.com/?a=d2&layout_a=tala&b=d2&layout_b=dagre&example=chess).

Binary file not shown.

View file

@ -0,0 +1,20 @@
#### Features 🚀
#### Improvements 🧹
- Containers expand to fit long child labels
- Edge labels on cluster edges are placed along the edges more symmetrically
- More symmetrical placements are found for shapes connected to multiple other shapes
- More aligned layouts in graphs where multiple shapes in a container are connected to a shape at the parent level
- Connections between two shapes of different container levels take the direction of the least nested shape
- Connections made across grid diagrams and sequence diagrams are now routed with TALA's edge routing
- Improves edge routing to allow more bidirectional edges to overlap when they share a node and have matching arrowheads
- Less memory used when many subgraphs
#### Bugfixes ⛑️
- Fixes overlapping routes for certain trees with mixed arrow directions
- Label for the first step of multiple connected steps with "multiple" set is centered
- Connections to concave shapes like "step" are more precisely connected when multiple or 3d set (previously they jutted into the shape a little)
- Prevents edge case where a connection with a long connection label could overlap shapes
- Fixes an edge case where two connected nodes in different containers were suboptimally aligned

View file

@ -1,31 +0,0 @@
TALA 0.4.0 is a massive improvement in layout positions of a wide range of diagrams.
<img width="814" alt="Screenshot 2024-07-08 at 2 44 49PM" src="https://github.com/terrastruct/TALA/assets/3120367/a4d3ca21-a0bc-4771-9c82-ab2fc736a439" />
#### Improvements 🧹
- Unconnected nodes and subgraphs are packed more tightly together
- Containers of similar sizes with indirect connections are aligned better
- Some diagrams escape local minimas better
- Nodes connected on both sides are more equidistant to both
- Cluster edge labels prioritize not intersecting with other cluster edges
- Node labels reposition to avoid overlapping with icons
- Node icons reposition to avoid overlapping with fixed labels
- Multiple edges between nodes are now ordered (left-right and top-down) by the order they were declared
- Edge routes between grid cells avoid node labels
- Edge routes consider paths that go through "invisible" nodes and edges (e.g. zero opacity)
- When only one of `width` or `height` is specified for a container, nodes will full up better to reduce unused space
- Tree structures are built more symmetrically
- Containers with edges going into its children are pulled closer together to the other edge endpoint
- Clusters of nodes are oriented more reasonably to facilitate better routes
- Clusters routes more often converge on a single point in the middle to form the "fork" aesthetic
- Node labels are positioned in areas of more space
- Edge labels avoid fixed node icon positions
#### Bugfixes ⛑️
- Fixes extra warnings that appeared with an invalid token
- Fixes panic when edges were defined between actors in different sequence diagrams
- Fixes custom label positions and icon positions not working for nodes in tree structures
- Disallow edges with different styles (e.g. stroke colors) from sharing routes
- Some direct straight routes weren't being considered between two non-diagonal nodes

View file

@ -1,19 +0,0 @@
#### Features 🚀
- `tala-seeds` can be specified in the source code through `vars` (see manual for more)
#### Improvements 🧹
- Containers expand to fit large labels
- Edge labels are placed more intelligently to avoid overlaps
- Nodes with multiple edges to another node with long edge labels are positioned more intelligently
- Two nodes with > 2 edges with labels strongly prefer being in horizontal orientation to each other. This increases the chance of their multiple edge labels being readable.
- Hierarchies with multiple parents are more centered
- Up to 20% faster
#### Bugfixes ⛑️
- Fixed rare panic when hierarchies with containers were used
- Various edge cases that affect layout have been fixed
- Fixes rare panic with multiple edges with arrowhead labels on the same table column
- Fixes rare panic using step shapes connected to other shapes