@cardenelabs/cdl 0.124.0 → 0.125.0

package/CHANGELOG.md

@@ -5,6 +5,47 @@ 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
@@ -4875,7 +4916,8 @@ Initial OSS release.
 使わない = annotated tag を push しても GitHub Release は作られず、 Release を作っていない版で
 行き止まりになる。
 
-[Unreleased]: https://github.com/cardene777/cdl/compare/v0.124.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

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` を値として公開しているので、記法を書く側は手書きせずに引ける
 (上の表は代表例で、全件ではない)。
 
@@ -497,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"] { /* 札から番号への補助線 */ }
 ```
 
 線の札と主役は、次の属性で選べる。