@cardenelabs/cdl 0.123.0 → 0.125.0

package/CHANGELOG.md

@@ -5,6 +5,58 @@ CDL (Chainome Diagram Language) の主要変更履歴。
 
 ## [Unreleased]
 
+## [0.125.0] - 2026-10-06
+
+### Added
+
+- **metro 路線図に担当の名札・案内線・太い線路・大きな駅・始まりと終わりの印を描けるようにした** (#1018)
+
+  `station` は半径を `--cdl-metro-station-radius`、縁の太さを `--cdl-metro-station-stroke-width`、`routing: "metro"` の線路は太さを `--cdl-metro-line-width` で上書きできる。
+  既定値は順に 16、6、10 で、CSS を読まない SVG でも同じ数値を属性に持つ。
+  始まりと終わりは線の端から推測せず、`kind: "mark-start"` と `kind: "mark-end"` の node で明示する。
+  路線図の始まりは半径 17、終わりは半径 19・縁 3.5・内側の半径 10 で描く。
+  担当の名札と案内線は路線用の lane から描き、名札・案内線・始まり・終わりを `data-cdl-role` で個別に選べる。
+  前の駅へ戻る線は太さ 6 の丸い点と行き先側の矢印で描き、分かれ道の枝は行き先との横位置に応じて上下または左右の角から出す。
+  真上から線路が入る駅の名前は駅の右へ置き、metro 線が出入りする分かれ道だけを半幅 58・半高 44、26 の太字で描く。
+
+- **図の下へ共通の凡例を描ける `legend` option を足した** (#1019)
+
+  印の種類と文字を並べると、10 種類の印を SVG 内の図より下へ横一列に描き、凡例を含む大きさへ `viewBox` を広げる。
+  凡例全体・項目・印・文字を `data-cdl-role` で選べ、印の種類は `data-cdl-legend-mark` で選べる。
+  `legend` を書かない既存の図は、座標・`viewBox`・DOM の出力が変わらない。
+
+- **時間軸に丸い番号、実線の軸、札から伸びる矢印なしの補助線を描けるようにした** (#1017)
+
+  `timeline-number` は番号を丸の中央に描き、`timelineAxis` は lane の中央へ実線を引く。
+  `leaderTo` を持つ札は指定した番号へ点線を伸ばし、既存の `subtitle` を札の右側へ出す。
+  既存の `station`、`lifeline`、箱、段階列の出力は変わらない。
+
+- **同じ上端と高さの段階列に、番号と名前を付けられるようにした** (#1016)
+
+  lane に `stage` の番号と名前を書くと、段階列の面、番号、名前、見出しの区切りを別々の `data-cdl-role` で描く。
+  列の面は lane の幅いっぱいへ広がり、見本と同じ比率の余白を列の間に保つ。
+  段階列の中にある札は、名前を左、既存の `subtitle` を右の補足として出せる。
+  前の段へ戻る `back-detour` は段階の見出しより上を通り、札へ入る。
+  `stage` を書かない既存の縦列と `lane-container` / `lane-label` の出力は変わらない。
+
+### Changed
+
+- **段を切り替えても metro 線を全て DOM に残すようにした** (#1018)
+
+  初出前の区間だけに `data-cdl-pending="true"` を出し、意匠側がまだ通っていない線路を選べる。
+  `routing: "metro"` 以外の線と、路線用の欄を持たない lane の出力は変わらない。
+
+## [0.124.0] - 2026-10-06
+
+### Changed
+
+- **箱の上を回る戻り線が、途中の箱を貫かない道筋を選べるようにした** (#1014)
+
+  上へ回る今までの道筋が両端以外の箱と交わる時だけ、左右の外側の列を通る道筋に替え、交わる箱が少なく短い方を選ぶ。
+  両端は今までどおり上辺から出て、上辺へ入る。
+  1 段前へ戻る線と間に箱が無い戻り線の座標は変わらない。
+  外側を回っても避けられない箱は `edge-node-cross` として検査結果に残る。
+
 ## [0.123.0] - 2026-10-05
 
 ### Added
@@ -4864,7 +4916,9 @@ Initial OSS release.
 使わない = annotated tag を push しても GitHub Release は作られず、 Release を作っていない版で
 行き止まりになる。
 
-[Unreleased]: https://github.com/cardene777/cdl/compare/v0.123.0...HEAD
+[Unreleased]: https://github.com/cardene777/cdl/compare/v0.125.0...HEAD
+[0.125.0]: https://github.com/cardene777/cdl/compare/v0.124.0...v0.125.0
+[0.124.0]: https://github.com/cardene777/cdl/compare/v0.123.0...v0.124.0
 [0.123.0]: https://github.com/cardene777/cdl/compare/v0.122.0...v0.123.0
 [0.122.0]: https://github.com/cardene777/cdl/compare/v0.121.0...v0.122.0
 [0.121.0]: https://github.com/cardene777/cdl/compare/v0.120.0...v0.121.0

package/README.md

@@ -231,6 +231,11 @@ export const custom = diagram("custom", { topic: "Custom" })
 `posX` / `posY` で線路上の点へ置き、既定の大きさは 24×24 になる。
 `tone` を指定すると丸の枠色が変わる。
 
+時間軸の番号には `timeline-number` を使う。
+番号は 52×52 の丸の中央に描き、lane の `timelineAxis: true` で丸の中心を通る実線を引く。
+札の `leaderTo` に番号の node id を書くと、札と丸を矢印なしの点線で結ぶ。
+`leaderTo` を持つ `card` の `subtitle` は、札の右側へ担当の字として描く。
+
 書ける種類の全件は `NODE_KINDS` を値として公開しているので、記法を書く側は手書きせずに引ける
 (上の表は代表例で、全件ではない)。
 
@@ -268,10 +273,15 @@ export const custom = diagram("custom", { topic: "Custom" })
 | 値 | 道筋 | 向く場面 |
 |---|---|---|
 | `default` | 箱を避け、角を丸めた直角の線 | 箱を避けたい図、直角の線に揃えたい図 |
-| `back-detour` | 箱の上を回って戻る線 | 前の箱へ戻る関係 |
+| `back-detour` | 箱の上を回って戻り、途中の箱と交わる時は外側を回る線 | 前の箱へ戻る関係 |
 | `curve` | 両端で水平になる 3 次曲線 | 段や列をまたぐ関係を柔らかくつなぐ図 |
 | `metro` | 横線と傾き ±1 の斜線を円弧で結ぶ線 | 路線図の線路と乗り換え |
 
+`back-detour` は始点と終点の上辺を結び、両端より 100 上を横に渡る。
+途中の箱と交わる時だけ、縦に並ぶ箱を避けた最も近い外側の列を通り、交わる箱が少なく短い方を選ぶ。
+両端は外側へ回る時も上辺から出て、上辺へ入る。
+外側を回っても避けられない箱は `edge-node-cross` として検査結果に残る。
+
 `curve` は、行き先が右なら始点の右辺から終点の左辺へ、左なら始点の左辺から終点の右辺へ結ぶ。
 2 つの箱の横の範囲が重なる時は、両方の右辺を結ぶ。
 2 点の高さが同じなら直線になる。
@@ -492,6 +502,9 @@ cdl は形だけを描き、 色や影は持たない (geometry only、 style
 ```css
 [data-cdl-role="node-body"][data-cdl-mark="station"] { /* 駅 */ }
 [data-cdl-routing="metro"] [data-cdl-role="edge-line"] { /* 路線図の線 */ }
+[data-cdl-role="node-body"][data-cdl-mark="timeline-number"] { /* 時間軸の番号 */ }
+[data-cdl-role="timeline-axis"] { /* 時間軸の実線 */ }
+[data-cdl-role="timeline-leader"] { /* 札から番号への補助線 */ }
 ```
 
 線の札と主役は、次の属性で選べる。