@cardenelabs/cdl 0.20.1 → 0.21.0

package/CHANGELOG.md

@@ -5,6 +5,28 @@ CDL (Chainome Diagram Language) の主要変更履歴。
 
 ## [Unreleased]
 
+## [0.21.0] - 2026-08-29
+
+### Fixed
+
+- **説明どうしの近接と、線から逃げられない説明を解消した** (#592)
+
+  説明を動かす後処理 (`resolveEdgeLabelOverlapsWithChainAndPropagate`) に 2 つの穴があった。
+
+  1 つ目は **説明どうしの近接を見ていなかった** こと。 重なった時しか動かさない一方、検査は
+  36 の間隔を要求するので 33 しか空かない組が残っていた (見本 7 図が同じ形)。 節や縦列の
+  見出しには近接を見る rule があり、説明どうしだけが抜けていた。
+
+  2 つ目は **線を動かせない時に何もしなかった** こと。 線をどの向きにも動かせない場合は
+  「説明の近接より経路の破損の方が重い」 として諦めていたが、説明は動かしても経路を壊さない。
+  説明の側を逃がす。
+
+  押し出す量に 2 の余裕を足した。 要求ちょうどに置くと px へ投影する丸めで割れる
+  (実測で押し出した先が `gap=32.0px (need 32px)` で error)。
+
+  dragon の見本で `clearance` の error が 7 図から 1 図に減った。 残る 1 図は engine が
+  world unit で、検査が px で測ることによる差 (viewBox 2511 の図で 14 world が 9px になる)。
+
 ## [0.20.1] - 2026-08-29
 
 ### Fixed
@@ -1039,7 +1061,8 @@ Initial OSS release.
 使わない = annotated tag を push しても GitHub Release は作られず、 Release を作っていない版で
 行き止まりになる。
 
-[Unreleased]: https://github.com/cardene777/cdl/compare/v0.20.1...HEAD
+[Unreleased]: https://github.com/cardene777/cdl/compare/v0.21.0...HEAD
+[0.21.0]: https://github.com/cardene777/cdl/compare/v0.20.1...v0.21.0
 [0.20.1]: https://github.com/cardene777/cdl/compare/v0.20.0...v0.20.1
 [0.20.0]: https://github.com/cardene777/cdl/compare/v0.19.0...v0.20.0
 [0.19.0]: https://github.com/cardene777/cdl/compare/v0.18.1...v0.19.0

package/dist/index.cjs

@@ -12093,6 +12093,7 @@ function footerShapeDrawTop(node) {
 
 // src/layout/collisions.ts
 var LANE_LABEL_CLEARANCE_MARGIN = 2;
+var NEAR_MISS_MARGIN = LANE_LABEL_CLEARANCE_MARGIN;
 function collectBBoxes(lanes, nodes, edges) {
   const out = [];
   for (const lane of lanes) {
@@ -12920,8 +12921,8 @@ function resolveEdgeLabelOverlapsWithChainAndPropagate(edges, obstacles, minClea
         };
         const shift = computeOverlapShift(label, inflated);
         if (!shift) continue;
-        const amount = shift.amount - minClearance;
-        if (amount <= 0) continue;
+        const amount = shift.amount - minClearance + NEAR_MISS_MARGIN;
+        if (amount <= NEAR_MISS_MARGIN) continue;
         out.push({
           target: { kind: "label", id: label.id },
           axis: shift.axis,
@@ -12962,6 +12963,36 @@ function resolveEdgeLabelOverlapsWithChainAndPropagate(edges, obstacles, minClea
         out.push({ target: { kind: "label", id: moveBox.id }, ...shift });
       }
     }
+    for (let i = 0; i < labels.length; i++) {
+      for (let j = i + 1; j < labels.length; j++) {
+        const a = labels[i];
+        const b = labels[j];
+        if (computeOverlapShift(a, b)) continue;
+        const orderA = edgeOrder.get(a.id);
+        const orderB = edgeOrder.get(b.id);
+        const moveBox = orderA > orderB ? a : b;
+        const staticBox = orderA > orderB ? b : a;
+        const required = requiredNearClearance(moveBox.kind, staticBox.kind);
+        const inflated = {
+          ...staticBox,
+          x: staticBox.x - required,
+          y: staticBox.y - required,
+          w: staticBox.w + required * 2,
+          h: staticBox.h + required * 2
+        };
+        const shift = computeOverlapShift(moveBox, inflated);
+        if (!shift) continue;
+        const amount = shift.amount - minClearance + NEAR_MISS_MARGIN;
+        if (amount <= NEAR_MISS_MARGIN) continue;
+        out.push({
+          target: { kind: "label", id: moveBox.id },
+          axis: shift.axis,
+          sign: shift.sign,
+          amount,
+          chain: false
+        });
+      }
+    }
     for (const label of labels) {
       const currentShift = getLabelChainShift(label.id);
       if (currentShift.dx === 0 && currentShift.dy === 0) continue;
@@ -13057,12 +13088,46 @@ function resolveEdgeLabelOverlapsWithChainAndPropagate(edges, obstacles, minClea
         if (bestSideIdx < 0) continue;
         const amount = pathLabelClearance - gap + pathLabelClearance;
         const ordered = edgeProbes.map((p, idx) => ({ p, idx })).sort((a, b) => probeDist[a.idx] - probeDist[b.idx]);
+        let \u7DDA\u3092\u52D5\u304B\u305B\u305F = false;
         for (const { p } of ordered) {
           const axis = p.axis;
           if (!pathShiftIsSafe(e.id, axis, p.sign, amount)) continue;
           out.push({ target: { kind: "edge-path", id: e.id }, axis, sign: p.sign, amount });
+          \u7DDA\u3092\u52D5\u304B\u305B\u305F = true;
           break;
         }
+        if (!\u7DDA\u3092\u52D5\u304B\u305B\u305F) {
+          const \u82AF = { x: label.x + label.w / 2, y: label.y + label.h / 2 };
+          let \u8FD1\u3044\u70B9 = null;
+          let \u6700\u77ED = Infinity;
+          for (const seg of segs) {
+            for (const \u70B9 of [
+              { x: seg.x1, y: seg.y1 },
+              { x: seg.x2, y: seg.y2 },
+              { x: (seg.x1 + seg.x2) / 2, y: (seg.y1 + seg.y2) / 2 }
+            ]) {
+              const d = Math.hypot(\u70B9.x - \u82AF.x, \u70B9.y - \u82AF.y);
+              if (d < \u6700\u77ED) {
+                \u6700\u77ED = d;
+                \u8FD1\u3044\u70B9 = \u70B9;
+              }
+            }
+          }
+          if (\u8FD1\u3044\u70B9) {
+            const dx = \u82AF.x - \u8FD1\u3044\u70B9.x;
+            const dy = \u82AF.y - \u8FD1\u3044\u70B9.y;
+            const axis = Math.abs(dx) >= Math.abs(dy) ? "x" : "y";
+            const \u5411\u304D = axis === "x" ? dx : dy;
+            const sign = \u5411\u304D >= 0 ? 1 : -1;
+            out.push({
+              target: { kind: "label", id: label.id },
+              axis,
+              sign,
+              amount: pathLabelClearance - gap + NEAR_MISS_MARGIN,
+              chain: false
+            });
+          }
+        }
       }
     }
     for (const label of labels) {