dsh-model-everything 0.5.0 → 0.5.1

package/README.en-US.md

@@ -91,6 +91,18 @@ because a layered diagram whose members float outside their package is not showi
 boundary folds it into one box and clicking again unfolds it; folding is a transform on the model, not a mode of
 the painter, so the edges re-aim at the box.
 
+**An edge goes around a component, never through one.** A clear edge is a straight line; as soon as a box sits
+between the two ends, the edge is routed on a **sparse grid** - one candidate line just outside each side of every
+box, then A* over that small graph with a bend penalty. It is the same construction Graphviz (a visibility graph),
+ELK and yFiles (an orthogonal router) and mxGraph use: no pixel grid, O(boxes) candidate lines, and the cost of a
+bend counted so a route does not zig-zag to save a few points. When the search cannot finish, the straight line
+stays: losing an edge is worse than a detour.
+
+**Text is measured before a box is placed.** A `<br>` or `<br/>` in a label is a hard break and a long label wraps;
+a box is sized from the lines it actually draws, and a row is as tall as its tallest box. An edge label walks along
+its own edge and steps aside when the line is occupied - the same idea as Graphviz making a label a dummy node the
+layout must leave room for. **Text first, geometry second**, so overflow is not a matter of luck.
+
 **A line it cannot draw is refused with its line number.** Sequence diagrams, class diagrams, Gantt charts, the
 `click`/`classDef` directives and PlantUML's `actor`/`note` are all refused by line. A sequence diagram that
 quietly lost its lifelines looks complete, and that is worse than no drawing.

package/README.md

@@ -74,6 +74,10 @@ DeepSeek Harness 原生插件。把设计与代码里**关于行为的断言**
 
 **父子分组是一等公民。** Mermaid 的 `subgraph` 与 PlantUML 的 `package` 都读成边界，边界可以嵌套，布局按「组内竖排、父组包住子组」来算——因为一个成员飘在包外面的分层图，并没有在表达包含关系。点一个边界就把它折成一个盒子，再点展开；折叠是模型变换，不是绘制模式，所以连线会跟着改指到盒子上。
 
+**连线绕开组件，穿过组件的不画。** 直连没有障碍时就是一条直线；一旦有盒子挡在中间，改走**稀疏网格**——候选坐标取每个盒子四边外一点点，构成一张很小的图，再用 A\* 找最短路，并对**拐弯计费**。这是 Graphviz（visibility graph）、ELK / yFiles（orthogonal router）、mxGraph 共用的做法：不做像素网格，用盒子边界构造 O(盒子数) 的候选线，成本才是可接受的。搜索失败时保留直线，丢一条边比绕远路更糟。
+
+**排版先量文字，再定盒子。** 标签里的 `<br>` / `<br/>` 是硬换行，过长的标签自动折行；盒子尺寸由它实际要画的那几行决定，行高取该行最高的盒子。边标签会沿自己的边找位置，找不到就退到边的一侧——和 Graphviz 把一个标签当虚拟节点、为它留位是同一个思路：**文字先量，几何后算**。盒子按文字定宽，所以溢出不靠运气。
+
 **画不了的行会说清楚。** 序列表、类图、甘特图、`click`/`classDef` 这类指令，以及 PlantUML 的 `actor`/`note`，一律按行号拒绝。悄悄丢掉生命线的时序图看起来是完整的，这比不画更糟。
 
 **深浅色跟着页面走。** 背景亮度决定用深色板还是浅色板，四套配色可选（`default`、`github`、`high-contrast`、`print`）；底色画在 SVG 里，所以外层换皮肤也改不了图的对比度。右栏还有一个白板标签页：贴源码就出图，不依赖任何工具结果。