@cardenelabs/cdl 0.25.0 → 0.27.0

package/CHANGELOG.md

@@ -5,6 +5,68 @@ 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
+
+- **クラス図の箱にも行の縞と配色を通した** (#627)
+
+  クラス図の箱は ER 図と同じ作り (行頭の印 + 左に名前 + 右に型) をしている。
+  名前と型が離れて並ぶので、行を横に追う目印が要るのは ER 図と同じだった。
+
+  `classDiagram` に `rowStripe` と `palette` を足し、既定を `er` と揃えた。
+  どちらも書けば上書きでき、`rowStripe: false` で縞を外せる。
+
+### Changed
+
+- **行が 1 つの箱には縞を敷かなくなった** (#627)
+
+  縞の役目は「隣り合う行を見分ける」 こと。
+  1 行しか無い箱には見分ける相手が居ないので、敷くとその 1 行が「主役」 に見える。
+
+  実際にクラス図へ当てて確かめると、1 行の箱 (`Auditable` / `Sku`) で縞が強調に読めた。
+  2 行以上の箱では意図どおり行の区切りとして読めた。
+
+  閾値ではなく **役目から導いた規則** なので、図種を増やしても同じ判断ができる。
+  判定は描き手 (`storage.tsx`) が持つ = 組み立て器ごとに書くと、次の図種で取り残される。
+
+  ER 図にも同じ規則が効く (1 行の表で縞が消える)。
+
 ## [0.25.0] - 2026-09-03
 
 ### Added
@@ -1288,7 +1350,10 @@ Initial OSS release.
 使わない = annotated tag を push しても GitHub Release は作られず、 Release を作っていない版で
 行き止まりになる。
 
-[Unreleased]: https://github.com/cardene777/cdl/compare/v0.24.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
 [0.23.0]: https://github.com/cardene777/cdl/compare/v0.22.0...v0.23.0
 [0.22.0]: https://github.com/cardene777/cdl/compare/v0.21.2...v0.22.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) {
@@ -22766,6 +22776,7 @@ var ROW_GLYPH_CX = ROW_PAD_X_PX + ROW_GLYPH_HALF + 1;
 var ROW_GLYPH_LEAD = 40;
 var ROW_TYPE_FONT = 22;
 var SUBTITLE_BASELINE = 118;
+var STRIPE_MIN_ROWS = 2;
 var SUBTITLE_FONT = 20;
 var UNDERLINE_DROP = 7;
 function RowGlyph({ mark, x, y, color }) {
@@ -22823,7 +22834,7 @@ function StorageNode({
         strokeWidth: active ? 3 : 1.25
       }
     ),
-    node.rowStripe && rows.map((_, idx) => {
+    node.rowStripe && rows.length >= STRIPE_MIN_ROWS && rows.map((_, idx) => {
       if (idx % 2 !== 0) return null;
       const \u5E2F = rowStripeBand("storage", idx, \u884C\u306E\u4E0B\u3052);
       if (!\u5E2F) return null;
@@ -30834,7 +30845,8 @@ function stripAccess(row) {
 function classDiagram(preset) {
   const classW = resolveStorageBoxW(preset.classWidth, "classDiagram", "classWidth");
   const tone = preset.defaultTone ?? "info";
-  const b = diagram(preset.id, { topic: preset.topic });
+  const \u7E1E\u3092\u6577\u304F = preset.rowStripe ?? true;
+  const b = diagram(preset.id, { topic: preset.topic, palette: preset.palette });
   const classes = [];
   const phaseActivate = [];
   const \u7BB1 = [];
@@ -30882,7 +30894,9 @@ function classDiagram(preset) {
           // 種類の札は **書いた時だけ** 出す (#578)。 「クラス」 と書いた札は箱がクラスで
           // あることしか言わず、図の中の全ての箱に同じ字が並ぶ
           ...m.c.stereotype ? { eyebrow: m.c.stereotype } : {},
-          ...m.rows.length > 0 ? { rows: m.rows, rowMarks: m.rowMarks } : {}
+          ...m.rows.length > 0 ? { rows: m.rows, rowMarks: m.rowMarks } : {},
+          // 縞は行を持つ箱にだけ敷く (#627)。 行が無い箱に書いても描き手が読まない
+          ...m.rows.length > 0 && \u7E1E\u3092\u6577\u304F ? { rowStripe: true } : {}
         });
         classes.push(m.c.id);
         phaseActivate.push(m.c.id);