@cardenelabs/cdl 0.26.0 → 0.28.0

package/CHANGELOG.md

@@ -5,6 +5,102 @@ CDL (Chainome Diagram Language) の主要変更履歴。
 
 ## [Unreleased]
 
+## [0.28.0] - 2026-09-04
+
+### Changed
+
+- **クラス図の関係の色みを種類から決めるようにした** (#641)
+
+  6 種の関係が全て同じ色 (`info`) で引かれていた。 見分けを担うのは 線 (実線 / 破線) と
+  印の形 (三角 / 菱 / 開いた矢) と 印が付く側 の 3 軸だけで、6 種を 1 枚に並べると
+  印の形まで見ないとどれがどれか判らない。
+
+  種類から色みを決める対応表 (`CLASS_RELATION_TONE`) を足し、6 種を 3 群に寄せた。
+
+  | 群 | 種類 | 色み | 群の中の見分け |
+  |---|---|---|---|
+  | 縦の関係 | `extends` / `implements` | `accent` | 線 (実線 / 破線) |
+  | 所有 | `aggregates` / `composes` | `teal` | 印の塗り (白抜き / 塗る) |
+  | 向きだけ | `associates` / `uses` | `success` | 線 (実線 / 破線) |
+
+  **群の中は色を分けない**。 群の中の 2 種は既に線か印の塗りで分かれているので、
+  色まで足すと同じことを 2 回言うことになる。 色が担うのは群の見分けだけ。
+
+  優先順位は 関係に書いた色み > 図に書いた `defaultTone` > 種類から決まる既定 の 3 段。
+  `defaultTone` を書いた図は「全部同じ色みにする」 と宣言しているので、そちらが勝つ =
+  既存の図の見た目は変わらない。
+
+  **色の値は持たない**。 名前だけを図に載せ、実際の色は消費側が `data-cdl-tone` を見て当てる。
+
+### Fixed
+
+- **比較 link が 404 になっていた 6 版に tag を打った** (#639)
+
+  変更履歴は 31 版ぶんの比較 link を持つが、tag があるのは 25 版だった。
+  `0.17.0` / `0.17.1` / `0.18.0` / `0.18.1` / `0.24.0` / `0.25.0` の 6 本が飛び先を持たず、
+  押すと 404 になる。 この file は npm の配布物に入るので、`node_modules` から読んだ
+  利用者にも 404 が届いていた。
+
+  6 本とも、その版の値を持つ commit に打った。
+  最上位の tag は `v0.27.0` のままなので、版の範囲を導く検査の判定は変わらない。
+
+  **`0.27.0` の記述に書いた tag の数も直した**。 「`v0.9.0` までしか tag が無い」 と
+  書いていたが、実測では `v0.23.0` まであった。 `git tag --list` の並びを版順と読み違えた
+  もので、`--sort=-v:refname` で確かめると最上位は `v0.23.0` になる。
+  tag を打つ判断そのものは変わらない = `v0.23.0` を起点にしても 4 版ぶんが範囲に入る。
+
+### Added
+
+- **版に入る commit が変更履歴から辿れることを検査する** (#637)
+
+  `0.27.0` を切る時に doc だけの PR (#633) の entry を書き忘れたが、既存の検査は 1 つも
+  落ちなかった。 `release-packaging.test.ts` は公開物に変更履歴が入るかと比較 link の形しか
+  見ないため、commit の記載漏れは素通りする。
+
+  前の版から HEAD までの各 commit について、その commit が持つ番号のどれかが変更履歴に
+  載っているか「利用者から見えない」 と宣言されていることを見る検査を足した。
+  消費側 (dragon) の同名の検査を移したもので、あちらでは tag の打ち忘れと宣言の残骸を
+  実際に捕まえている。
+
+  **併せて `v0.26.0` と `v0.27.0` の tag を打った**。 検査は版の範囲を tag から導くので、
+  無いと起点が `v0.23.0` まで下がり、`0.24.0` から `0.27.0` の 4 版ぶんが範囲に入って使えない。
+  間の版の tag は打っていない = 範囲の判定に効くのはいちばん新しい tag だけ。
+
+## [0.27.0] - 2026-09-04
+
+### Changed
+
+- **高さの式の説明を印の有無で分けた** (#633)
+
+  公開している `requiredRowsHeight` の説明が「`rows` を持つ node に必要な高さ」 と述べていたが、
+  印を持つ箱は #631 から別の式で決まる。 読んだ人が印を持つ箱を 24 高く組まないよう、
+  適用先を印を持たない箱に限定し、印を持つ箱がどこを起点にするかを 1 文で書いた。
+
+  併せて、実在しない消費側の名指し (`dragon の sequence header 等`) を落とした。
+  消費側を全件走査すると呼出は 0 件で、この記述は #631 より前から食い違っていた。
+
+  doc comment のみで、関数の中身と公開面は変えていない。
+
+### Fixed
+
+- **行の縞が終わる位置から箱の下余白を取るようにした** (#631)
+
+  行頭の印 (`rowMarks`) を持つ箱は、最後の行の中線から 76 下を下端にしていた。
+  縞の帯は中線から 28 下で終わるため、差の 48 が行送り 56 に近い空の行 1 つに見えていた。
+  縞が最後の行に乗る時は余白が面の色の帯に読め、乗らない時は最後の行が倍の高さに
+  見えるため、どちらも行がそこで終わることを読めなかった。
+
+  箱の下端を、最後の行に対応する縞の帯の下端から 24 下に置く。
+  24 は箱の角の丸み 16 より大きく、これを下回ると縞の四角い角が丸みからはみ出して
+  四隅に色が出る。
+  余白は別の定数から足さず **帯から導く** ため、行送りを変えた時も字と帯だけが動いて
+  余白が取り残されない。
+
+  印を持たない箱の高さは変わらない。
+  `rowMarks` を持つ箱すべてに効き、組み立て器では `er()` / `stateMachine()` /
+  `classDiagram()` の 3 つが印を付ける。
+  対象の箱は高さが 24 縮む。
+
 ## [0.26.0] - 2026-09-03
 
 ### Added
@@ -1315,7 +1411,9 @@ Initial OSS release.
 使わない = annotated tag を push しても GitHub Release は作られず、 Release を作っていない版で
 行き止まりになる。
 
-[Unreleased]: https://github.com/cardene777/cdl/compare/v0.26.0...HEAD
+[Unreleased]: https://github.com/cardene777/cdl/compare/v0.28.0...HEAD
+[0.28.0]: https://github.com/cardene777/cdl/compare/v0.27.0...v0.28.0
+[0.27.0]: https://github.com/cardene777/cdl/compare/v0.26.0...v0.27.0
 [0.26.0]: https://github.com/cardene777/cdl/compare/v0.25.0...v0.26.0
 [0.25.0]: https://github.com/cardene777/cdl/compare/v0.24.0...v0.25.0
 [0.24.0]: https://github.com/cardene777/cdl/compare/v0.23.0...v0.24.0

package/dist/index.cjs

@@ -11838,6 +11838,7 @@ function rowGlyphDepth(kind) {
   return Math.ceil(font * ROW_GLYPH_DEPTH_RATIO);
 }
 var ROW_LAYOUT_BOTTOM_PAD = 20;
+var ROW_STRIPE_BOTTOM_PAD = 24;
 function requiredRowsHeight(kind, rowCount) {
   if (rowCount <= 0) return null;
   const lastBaseline = rowBaselineY(kind, rowCount - 1);
@@ -11845,6 +11846,12 @@ function requiredRowsHeight(kind, rowCount) {
   const pitch = kind === "storage" ? ROW_PITCH_STORAGE : ROW_PITCH_GENERIC;
   return lastBaseline + pitch + ROW_LAYOUT_BOTTOM_PAD;
 }
+function requiredMarkedRowsHeight(kind, rowCount) {
+  if (rowCount <= 0) return null;
+  const lastBand = rowStripeBand(kind, rowCount - 1, 0);
+  if (lastBand === null) return null;
+  return lastBand.y + lastBand.h + ROW_STRIPE_BOTTOM_PAD;
+}
 function isRenderedNode(n) {
   if (n.visibleIf === void 0 || n.visibleIf === "") return true;
   if (n.visibleIf.includes("{")) return true;
@@ -19967,7 +19974,10 @@ function autoStorageHeight(n, defaultH) {
   const \u7E70\u308A\u4E0A\u3052 = n.eyebrow ? 0 : \u76EE\u5370\u306A\u3057\u306E\u7E70\u308A\u4E0A\u3052("storage");
   if (!n.rows || n.rows.length === 0) return 115 + \u547C\u3073\u540D\u306E\u5206 - \u7E70\u308A\u4E0A\u3052;
   const \u5FC5\u8981 = requiredRowsHeight("storage", n.rows.length) ?? defaultH;
-  if (\u5370\u3042\u308A) return \u5FC5\u8981 + \u547C\u3073\u540D\u306E\u5206;
+  if (\u5370\u3042\u308A) {
+    const \u5E2F\u304B\u3089\u5FC5\u8981 = requiredMarkedRowsHeight("storage", n.rows.length) ?? defaultH;
+    return \u5E2F\u304B\u3089\u5FC5\u8981 + \u547C\u3073\u540D\u306E\u5206;
+  }
   return Math.max(defaultH, \u5FC5\u8981);
 }
 function autoRowsWidth(n, defaultW) {
@@ -30822,6 +30832,14 @@ var CLASS_RELATION_LOOK = {
   associates: { head: "open", fill: "solid", tailHead: "none", tailFill: "solid", style: "solid" },
   uses: { head: "open", fill: "solid", tailHead: "none", tailFill: "solid", style: "dashed" }
 };
+var CLASS_RELATION_TONE = {
+  extends: "accent",
+  implements: "accent",
+  aggregates: "teal",
+  composes: "teal",
+  associates: "success",
+  uses: "success"
+};
 Object.fromEntries(
   Object.entries(CLASS_RELATION_LOOK).map(([k, v]) => [k, v.head])
 );
@@ -30834,7 +30852,7 @@ function stripAccess(row) {
 }
 function classDiagram(preset) {
   const classW = resolveStorageBoxW(preset.classWidth, "classDiagram", "classWidth");
-  const tone = preset.defaultTone ?? "info";
+  const \u56F3\u306E\u65E2\u5B9A = preset.defaultTone;
   const \u7E1E\u3092\u6577\u304F = preset.rowStripe ?? true;
   const b = diagram(preset.id, { topic: preset.topic, palette: preset.palette });
   const classes = [];
@@ -30898,7 +30916,7 @@ function classDiagram(preset) {
           id: edgeId,
           label: r.label ?? r.type,
           ...r.cardinality ? { sub: r.cardinality } : {},
-          tone: r.tone ?? tone,
+          tone: r.tone ?? \u56F3\u306E\u65E2\u5B9A ?? CLASS_RELATION_TONE[r.type],
           // 関係の種類から線と端の形を決める (cdl#574 / #578)。 書いた値が勝つ
           style: r.style ?? \u898B\u305F\u76EE.style,
           head: r.head ?? \u898B\u305F\u76EE.head,