@cardenelabs/cdl 0.14.0 → 0.16.0

package/src/visual-validate.ts

@@ -77,7 +77,7 @@
  * test が無いと、 次に種別を足した時に同じ状態へ戻る。
  * ───────────────────────────────────────────────────────────
  */
-import type { CdlDiagram, LaidDiagram, LaidNode, NodeKind } from "./types";
+import { EDGE_HEADS, type CdlDiagram, type LaidDiagram, type LaidNode, type NodeKind } from "./types";
 import { CLEARANCE_LANE_LABEL, DIST_LABEL_PATH_MAX } from "./layout/clearance-constants";
 import { layout } from "./layout";
 import {
@@ -134,7 +134,9 @@ import {
   computeLabelBBoxWorld,
   hasRenderedLabel,
   isRenderedNode,
+  genericTitleBaselineY,
   rendersRows,
+  TITLE_ROW_MIN_GAP,
   rendersTitleText,
   fitsOwnTitleWidth,
   rowBaselineY,
@@ -238,6 +240,11 @@ export const GRID_ALIGNED_KINDS: ReadonlySet<NodeKind> = new Set([
   "chart-pie",
   "chart-line",
   "chart-bar",
+  "chart-gauge",
+  "chart-radial",
+  "chart-stat",
+  "chart-waffle",
+  "chart-stacked-bar",
   "funnel-stages",
   "quadrant-matrix",
 ]);
@@ -374,6 +381,7 @@ export type VisualAxis =
   | "column-gap-uniform"
   // Axis 68 (#387) = 行を描かない種別に rows が書かれている (書いた内容が画面に出ない)。
   | "rows-not-rendered"
+  | "title-row-overlap"
   // #393 = 検査に渡された図の形自体が壊れている (検査できなかったことを結果として出す)。
   | "malformed-input"
   // #393 = 検査が例外で中断したが、 原因が入力の破綻か検査側の欠陥か **決められない**。
@@ -498,6 +506,7 @@ function emptyCounts(): Record<VisualAxis, number> {
     "row-gap-uniform": 0,
     "column-gap-uniform": 0,
     "rows-not-rendered": 0,
+    "title-row-overlap": 0,
     "malformed-input": 0,
     "validation-interrupted": 0,
   };
@@ -2736,6 +2745,36 @@ function runAxes(
     );
   }
 
+  // ───────────────────────────────────────────────────────────
+  // Axis 69: title-row-overlap (題の字と 1 行目の字が重なる)
+  //
+  // 判定 = 題の baseline から下へ伸びる字形と、 1 行目の baseline から上へ伸びる字形が
+  // 触れるか。 位置は `spec.ts` の 2 関数 (`genericTitleBaselineY` / `rowBaselineY`) から
+  // 取るので、 描画側を変えれば本軸も一緒に動く。
+  //
+  // 題と行の縦位置は形ごとに別々の式で決まっていた時期があり、 円柱と中央寄せの 3 種で
+  // 字が重なっていた (#558)。 軸 4 (`row-format`) と軸 16 (`row-vertical-spacing`) は
+  // 行どうしと枠との関係しか見ないため、 題との関係は誰も見ていなかった。
+  //
+  // `storage` は専用の表組みで題と列の間に区切り線を引いており、 位置の出所が別なので対象外。
+  // ───────────────────────────────────────────────────────────
+  for (const n of diag.nodes) {
+    if (!n.rows || n.rows.length === 0) continue;
+    if (!rendersRows(n.kind)) continue;
+    if (n.kind === "storage") continue;
+    // 高さを取れない node は測らない。 0 に潰すと中央寄せの題が上端に来て誤って重なる判定になる
+    if (typeof n.h !== "number") continue;
+    const 題 = genericTitleBaselineY(n.kind, n.h, true);
+    const 行 = rowBaselineY(n.kind, 0);
+    if (行 === null) continue;
+    const 間 = 行 - 題;
+    if (間 >= TITLE_ROW_MIN_GAP) continue;
+    push(
+      "title-row-overlap",
+      `node "${n.id}" (kind=${n.kind ?? "未指定"}) の題 baseline y=${題.toFixed(0)} と 1 行目 baseline y=${行.toFixed(0)} の間が ${間.toFixed(0)} world で、 見込む字形の高さ ${TITLE_ROW_MIN_GAP.toFixed(0)} に届かない (字が重なる)`,
+    );
+  }
+
   // ───────────────────────────────────────────────────────────
   // Axis 17: group-boundary-clearance (topology group の boundary padding + 外部 clearance)
   //
@@ -3307,6 +3346,14 @@ function runAxes(
         `edge "${e.id}" tone "${e.tone}" が TONE_COLORS 定義に存在しない、 marker "cdl-arrow-${e.tone}" dead ref`,
       );
     }
+    // 端の形も同じ理由で dead ref になる (#560)。 marker は EDGE_HEADS の分しか定義しないので、
+    // 定義外の値が来ると "cdl-arrow-<tone>-<未定義>" を引いて矢頭が消える。
+    if (e.head !== undefined && !EDGE_HEADS.includes(e.head)) {
+      push(
+        "marker-gradient-def-integrity",
+        `edge "${e.id}" head "${e.head}" が EDGE_HEADS 定義に存在しない、 marker "cdl-arrow-${e.tone}-${e.head}" dead ref`,
+      );
+    }
   }
 
   // ───────────────────────────────────────────────────────────