@cardenelabs/cdl 0.25.0 → 0.27.0

package/dist/index.d.cts

@@ -2308,12 +2308,16 @@ declare const DETOUR_GAP = 94;
  */
 declare function rendersRows(kind: string | undefined): boolean;
 /**
- * `rows` を持つ node に必要な高さ (SSOT)。
+ * 行頭の印を **持たない** node に必要な高さ (SSOT)。
  *
  * 最終行の baseline から 1 行送りぶんとレイアウト余白を確保する。 行を描かない種別は `null`。
  *
- * `layout/nodes.ts` の `autoStorageHeight` と、 下流 (dragon の sequence header 等) が
- * 同じ値を使う。 各所で式を写すと、 描画を変えた時に一部だけ古くなる。
+ * **印を持つ箱はこの式で決まらない**。 そちらは縞の帯の下端を起点にする
+ * (`requiredMarkedRowsHeight`) = 帯を敷く箱では「行が終わる位置」 が帯の下端になるため、
+ * baseline から数えると帯の下に 1 行ぶんに近い余白が残る。
+ *
+ * 使うのは `layout/nodes.ts` の `autoStorageHeight` の印なし経路。 各所で式を写すと、
+ * 描画を変えた時に一部だけ古くなるので、下流も同じ形が要る時はここを引く。
  *
  * これは「そう置くとよい高さ」 で、 「これを下回ると破綻する高さ」 ではない。 後者は
  * `rowBaselineY` + `rowGlyphDepth` で、 軸 16 はそちらを見る。
@@ -3359,6 +3363,17 @@ type ClassDiagramPreset = {
      * 帯ではなく **箱** の幅。 帯は `箱の幅 + 余白 × 2` で宣言する。
      */
     classWidth?: number;
+    /**
+     * 行に 1 行おきの縞を敷くか (既定 = 敷く、 #627)。
+     *
+     * クラス図の箱は ER 図と同じ作り (行頭の印 + 左に名前 + 右に型) をしており、名前と型が
+     * 離れて並ぶので行を横に追う目印が要る。 `er()` と同じ既定にする。
+     */
+    rowStripe?: boolean;
+    /**
+     * 図の配色の名前 (#627)。 描き手は色を持たないので、名前をそのまま markup に出す。
+     */
+    palette?: string;
 };
 type ClassDiagramBuilder = {
     class: (c: UmlClass) => ClassDiagramBuilder;

package/dist/index.d.ts

@@ -2308,12 +2308,16 @@ declare const DETOUR_GAP = 94;
  */
 declare function rendersRows(kind: string | undefined): boolean;
 /**
- * `rows` を持つ node に必要な高さ (SSOT)。
+ * 行頭の印を **持たない** node に必要な高さ (SSOT)。
  *
  * 最終行の baseline から 1 行送りぶんとレイアウト余白を確保する。 行を描かない種別は `null`。
  *
- * `layout/nodes.ts` の `autoStorageHeight` と、 下流 (dragon の sequence header 等) が
- * 同じ値を使う。 各所で式を写すと、 描画を変えた時に一部だけ古くなる。
+ * **印を持つ箱はこの式で決まらない**。 そちらは縞の帯の下端を起点にする
+ * (`requiredMarkedRowsHeight`) = 帯を敷く箱では「行が終わる位置」 が帯の下端になるため、
+ * baseline から数えると帯の下に 1 行ぶんに近い余白が残る。
+ *
+ * 使うのは `layout/nodes.ts` の `autoStorageHeight` の印なし経路。 各所で式を写すと、
+ * 描画を変えた時に一部だけ古くなるので、下流も同じ形が要る時はここを引く。
  *
  * これは「そう置くとよい高さ」 で、 「これを下回ると破綻する高さ」 ではない。 後者は
  * `rowBaselineY` + `rowGlyphDepth` で、 軸 16 はそちらを見る。
@@ -3359,6 +3363,17 @@ type ClassDiagramPreset = {
      * 帯ではなく **箱** の幅。 帯は `箱の幅 + 余白 × 2` で宣言する。
      */
     classWidth?: number;
+    /**
+     * 行に 1 行おきの縞を敷くか (既定 = 敷く、 #627)。
+     *
+     * クラス図の箱は ER 図と同じ作り (行頭の印 + 左に名前 + 右に型) をしており、名前と型が
+     * 離れて並ぶので行を横に追う目印が要る。 `er()` と同じ既定にする。
+     */
+    rowStripe?: boolean;
+    /**
+     * 図の配色の名前 (#627)。 描き手は色を持たないので、名前をそのまま markup に出す。
+     */
+    palette?: string;
 };
 type ClassDiagramBuilder = {
     class: (c: UmlClass) => ClassDiagramBuilder;

package/dist/index.js

@@ -11836,6 +11836,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);
@@ -11843,6 +11844,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;
@@ -19965,7 +19972,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) {
@@ -22764,6 +22774,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 }) {
@@ -22821,7 +22832,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;
@@ -30832,7 +30843,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 = [];
@@ -30880,7 +30892,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);