@cardenelabs/cdl 0.26.0 → 0.27.0

package/CHANGELOG.md

@@ -5,6 +5,41 @@ CDL (Chainome Diagram Language) の主要変更履歴。
 
 ## [Unreleased]
 
+## [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 +1350,8 @@ 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.27.0...HEAD
+[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) {