@cardenelabs/cdl 0.104.0 → 0.106.0

package/CHANGELOG.md

@@ -5,6 +5,71 @@ CDL (Chainome Diagram Language) の主要変更履歴。
 
 ## [Unreleased]
 
+## [0.106.0] - 2026-09-30
+
+### Fixed
+
+- **箱の題の幅を、字ごとの実幅で見積もるようにした** (#949)
+
+  軸 3 (`text-readability`) は字数に 1 字の幅を掛けて見積もっていた。
+  英数字は全角の半分ほどしか取らないため、英数字の題を持つ箱で過大に見積もる。
+
+  | 題 | 種別 | 字数の近似 | 字ごとの実幅 |
+  |---|---|---|---|
+  | `order_items` | `storage` (34) | 426px | 約 250px |
+
+  engine は字ごとの実幅を出す `measureTextWidth` を既に持ち、辺の名札の外枠で使っている。
+  軸 3 だけが字数の近似を使っていたので、同じものに揃えた。
+
+  0.105.0 (#946) で 1 字の幅を種別ごとの実寸にした結果、大きく描く種別
+  (`storage` 34 / `actor` 32 / `card` 24 / `function` 24) で英数字の題が新しく挙がっていた。
+  引く側 (見本帳) で 11 枚を実測している。 本版でその 11 枚が挙がらなくなる。
+
+  判定の向きは変えていない。 全角の題が箱に収まらない場合は従来どおり挙がる。
+
+## [0.105.0] - 2026-09-30
+
+### Fixed
+
+- **箱の題の幅を、その種別が描く大きさから見積もるようにした** (#946)
+
+  軸 3 (`text-readability`) は「字数 × 1 字の幅 + 余白」 が箱の幅を超えるかで、題が切れる
+  可能性を見る。 1 字の幅を 22 の定数で持っていたが、`NODE_KINDS` を全件描いて題の字の
+  大きさを読むと **22 で描く種別は 1 つも無かった**。
+
+  | 大きさ | 種別の数 |
+  |---|---|
+  | 18 | 34 |
+  | 20 | 21 |
+  | 15 | 21 |
+  | 16 | 6 |
+  | 13 | 5 |
+  | 24 | 3 |
+  | 34 / 32 / 17 | 各 1 |
+
+  見積りが実物の 1.2 倍から 1.7 倍になり、収まっている題まで挙がっていた。
+  0.99.0 (#933) でどの種別も箱の題を読むようになってから差が表に出て、引く側 (見本帳) では
+  35 枚が新しく挙がっていた。 いずれも実際には収まっている。
+
+  種別ごとの大きさを `titleFontSize` に持ち、見積りをそこから出すようにした。
+
+  **内側の余白 (52) は、題を箱の中に描く種別にだけ足す**。
+  形だけを描く `dyn-*` 5 種は名前を箱の上に描き、図表 15 種も題を箱の上に描く。
+  箱の内側の余白に縛られないので、足すと収まっている題が挙がる。
+  どの種別が外に描くかは `drawsTitleOutsideBox` が持つ。
+
+  **一覧は実物と突き合わせる**。
+  `test/title-width-estimate.test.tsx` が `NODE_KINDS` を全件描き、表の値が実測を下回らず
+  実測 + 1 未満であることと、題の役割名 (`node-label` / `shape-name` / `figure-title`) が
+  述語と揃っていることを見る。 種別が増えた時に黙ってずれない。
+
+  表が持つのは **箱が十分に大きい時の大きさ** になる。 `shape-*` の多くは箱の高さに比例して
+  字を縮めるため、狭い箱では実物のほうが小さい。 見積りが実物を下回らない側に倒れるので、
+  切れる題を見逃す向きには外れない。
+
+  軸 `responsive-viewport` が使う基準の 22 は動かしていない。
+  図の中の文字全体を見る目安で、題の幅を見る本軸とは別の判定になる。
+
 ## [0.104.0] - 2026-09-30
 
 ### Fixed
@@ -4220,7 +4285,9 @@ Initial OSS release.
 使わない = annotated tag を push しても GitHub Release は作られず、 Release を作っていない版で
 行き止まりになる。
 
-[Unreleased]: https://github.com/cardene777/cdl/compare/v0.104.0...HEAD
+[Unreleased]: https://github.com/cardene777/cdl/compare/v0.106.0...HEAD
+[0.106.0]: https://github.com/cardene777/cdl/compare/v0.105.0...v0.106.0
+[0.105.0]: https://github.com/cardene777/cdl/compare/v0.104.0...v0.105.0
 [0.104.0]: https://github.com/cardene777/cdl/compare/v0.103.0...v0.104.0
 [0.103.0]: https://github.com/cardene777/cdl/compare/v0.102.0...v0.103.0
 [0.102.0]: https://github.com/cardene777/cdl/compare/v0.101.0...v0.102.0

package/dist/index.cjs

@@ -12377,6 +12377,71 @@ var KINDS_FITTING_OWN_TITLE = /* @__PURE__ */ new Set([
 function fitsOwnTitleWidth(kind) {
   return KINDS_FITTING_OWN_TITLE.has(kind ?? "");
 }
+var KINDS_DRAWING_TITLE_OUTSIDE = /* @__PURE__ */ new Set([
+  "dyn-rect",
+  "dyn-circle",
+  "dyn-arc",
+  "dyn-wave",
+  "dyn-polygon",
+  ...KINDS_DRAWING_OWN_PAYLOAD
+]);
+function drawsTitleOutsideBox(kind) {
+  return KINDS_DRAWING_TITLE_OUTSIDE.has(kind ?? "");
+}
+var TITLE_FONT_SIZE_DEFAULT = 18;
+var TITLE_FONT_SIZE = new Map([
+  ...["dyn-rect", "dyn-circle", "dyn-arc", "dyn-wave", "dyn-polygon"].map(
+    (k) => [k, 13]
+  ),
+  ...[
+    "shape-code-block",
+    "shape-cylinder",
+    "shape-diamond",
+    "shape-iot-sensor",
+    "shape-robot-arm",
+    "shape-stack",
+    "shape-terminal"
+  ].map((k) => [k, 15]),
+  ...[
+    "shape-cloud",
+    "shape-file",
+    "shape-folder",
+    "shape-hexagon",
+    "shape-message-bubble",
+    "shape-window"
+  ].map((k) => [k, 16]),
+  ["shape-kanban-card", 17],
+  ...[
+    "admin",
+    "api",
+    "backend",
+    "cache",
+    "cdn",
+    "cloud",
+    "database",
+    "decision",
+    "developer",
+    "external-user",
+    "frontend",
+    "merkle-tree",
+    "message-bus",
+    "microservice",
+    "oracle",
+    "person",
+    "queue",
+    "service",
+    "signer",
+    "user-group",
+    "webhook"
+  ].map((k) => [k, 20]),
+  ...["card", "event", "function"].map((k) => [k, 24]),
+  ["actor", 32],
+  ["storage", 34]
+]);
+function titleFontSize(kind) {
+  return TITLE_FONT_SIZE.get(kind ?? "") ?? TITLE_FONT_SIZE_DEFAULT;
+}
+var TITLE_BOX_PADDING = 52;
 var KINDS_DRAWN_BY_GENERIC = [
   "person",
   "user-group",
@@ -17160,12 +17225,12 @@ function runAxes(laid, diag, violations, counts, push, profile, skippedAxes, \u5
     if (!isRenderedNode(n)) continue;
     const titleTrimmed = n.title?.trim() ?? "";
     if (!titleTrimmed) continue;
-    const titleLen = titleTrimmed.length;
-    const expectedW = titleLen * 22 + 52;
+    const expectedW = measureTextWidth(titleTrimmed, { fontSize: titleFontSize(n.kind) }) + (drawsTitleOutsideBox(n.kind) ? 0 : TITLE_BOX_PADDING);
     if (expectedW > n.w + 8) {
       push(
         "text-readability",
-        `node "${n.id}" title "${n.title}" \u304C node \u5E45 ${n.w}px \u3092\u8D85\u904E\u3059\u308B\u53EF\u80FD\u6027 (\u671F\u5F85 ${expectedW}px)`,
+        // 字ごとの実幅は小数になるので、読む人に出す時だけ丸める (判定は丸めない)
+        `node "${n.id}" title "${n.title}" \u304C node \u5E45 ${n.w}px \u3092\u8D85\u904E\u3059\u308B\u53EF\u80FD\u6027 (\u671F\u5F85 ${Math.round(expectedW)}px)`,
         "warn"
       );
     }