@cardenelabs/cdl 0.105.0 → 0.107.0

package/CHANGELOG.md

@@ -5,6 +5,70 @@ CDL (Chainome Diagram Language) の主要変更履歴。
 
 ## [Unreleased]
 
+## [0.107.0] - 2026-09-30
+
+### Fixed
+
+- **収まっている題を「はみ出す」 と判定するのをやめた** (#951)
+
+  軸 3 (`text-readability`) の見積りが、実際に描く形と 2 点で違っていた。
+
+  第一に、字の幅の表が **組み方のための上振れ値** だった。 箱の大きさと線の置き場を決める
+  側は狭く見積もると字が枠から出るため、表は広い側へ寄せてある。 同じ値で「はみ出すか」 を
+  判定すると、収まっている題まで挙がる。
+
+  見本帳の題 407 か所を `getComputedTextLength()` で測ると、上振れは字種で分かれた。
+
+  | 字種 | 件数 | 見積り / 実描画 |
+  |---|---|---|
+  | 和文だけ | 247 | 1.080 倍 (例外なし) |
+  | 欧文だけ | 119 | 1.16 から 1.82 倍 (中央 1.27 倍) |
+  | 混在 | 41 | 1.09 から 1.35 倍 |
+
+  第二に、**描く側は箱に収まるまで字を小さくする**。 `actor` / `card` / `event` / `function` /
+  `storage` は読める下限 11px まで 1 ずつ落とし、絵の中に字を置く 34 種は下限なく縮める。
+  軸 3 は種別ごとの最大値で見積もっていたので、縮めて収めた題まで挙がっていた。
+
+  2 点を直した。
+
+  | 直した所 | 内容 |
+  |---|---|
+  | `measureTextWidth` | `bound: "drawn"` を足し、字種ごとに上振れを割り戻す。 既定 (`layout`) は変えない |
+  | 軸 3 | 縮める種別は「読める下限を割るか」、縮めない種別は「箱の幅を超えるか」 を見る |
+
+  **組み方の見積りは 1 つも変えていない**。 箱の大きさと線の置き場は従来どおりで、
+  焼き付けた見た目も動かない。
+
+  検知力は下げていない。 縮める種別では、下限 11px まで落としても収まらない題を挙げる
+  (`storage` の箱 400px に全角 40 字を書くと挙がる)。 絵の中に字を置く 34 種では、
+  下限を割る大きさまで縮む題を挙げる = 直す前は「はみ出す」 という当たらない理由で
+  挙げていたものを、実際に起きること (読めない大きさになる) に付け替えた。
+
+  引く側は cardene777/dragon#2701 で 9 枚が受け入れ一覧に載っていた。 本版でその 9 枚が
+  挙がらなくなる。
+
+## [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
@@ -4263,7 +4327,9 @@ Initial OSS release.
 使わない = annotated tag を push しても GitHub Release は作られず、 Release を作っていない版で
 行き止まりになる。
 
-[Unreleased]: https://github.com/cardene777/cdl/compare/v0.105.0...HEAD
+[Unreleased]: https://github.com/cardene777/cdl/compare/v0.107.0...HEAD
+[0.107.0]: https://github.com/cardene777/cdl/compare/v0.106.0...v0.107.0
+[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

package/dist/index.cjs

@@ -12241,6 +12241,11 @@ function isHalfwidthKana(code) {
 }
 var EMOJI_ADVANCE_EM = 1.05;
 var MONO_EMOJI_ADVANCE_EM = 1.16;
+var DRAWN_CJK_RATIO = 1.08;
+var DRAWN_ASCII_RATIO = 1.16;
+function isAscii(code) {
+  return code < 128;
+}
 var WIDE_SYMBOL_ADVANCE_EM = 0.95;
 function isEmoji(code) {
   return code >= 126976 && code <= 129791 || // 絵文字の主要面
@@ -12279,29 +12284,31 @@ function measureTextWidth(text, opts = {}) {
   const fontSize = opts.fontSize ?? 22;
   const letterSpacing = opts.letterSpacing ?? 0;
   const fontFamily = opts.fontFamily ?? "sans";
+  const bound = opts.bound ?? "layout";
   let advanceEmSum = 0;
   let charCount = 0;
   const \u6587\u5B57\u5217 = CLUSTER_JOINER_RE.test(text) ? segmentGraphemes(text) : [...text];
   for (const ch of \u6587\u5B57\u5217) {
     charCount++;
     const code = ch.codePointAt(0) ?? 0;
+    const \u5272\u308A\u623B\u3057 = bound === "drawn" && !isEmojiGrapheme(ch, code) ? isAscii(code) ? DRAWN_ASCII_RATIO : isCJK(code) ? DRAWN_CJK_RATIO : 1 : 1;
     if (isEmojiGrapheme(ch, code)) {
       advanceEmSum += fontFamily === "mono" ? MONO_EMOJI_ADVANCE_EM : EMOJI_ADVANCE_EM;
       continue;
     }
     if (fontFamily === "mono") {
-      advanceEmSum += isCJK(code) ? 1.08 : JETBRAINS_MONO_ADVANCE_EM;
+      advanceEmSum += (isCJK(code) ? 1.08 : JETBRAINS_MONO_ADVANCE_EM) / \u5272\u308A\u623B\u3057;
       continue;
     }
     if (isCJK(code)) {
-      advanceEmSum += 1.08;
+      advanceEmSum += 1.08 / \u5272\u308A\u623B\u3057;
       continue;
     }
     const table = ch.length === 1 ? INTER_BOLD_ADVANCE_EM[ch] : void 0;
-    advanceEmSum += table !== void 0 ? table : defaultAdvanceEm(ch, code);
+    advanceEmSum += (table !== void 0 ? table : defaultAdvanceEm(ch, code)) / \u5272\u308A\u623B\u3057;
   }
   const w = advanceEmSum * fontSize + letterSpacing * charCount;
-  return Math.max(w, fontSize * 1.2);
+  return bound === "drawn" ? w : Math.max(w, fontSize * 1.2);
 }
 function \u53CE\u3081\u308B\u500D\u7387(text, opts, \u5E45) {
   if (!(\u5E45 > 0) || !(opts.fontSize > 0)) return 1;
@@ -12442,6 +12449,51 @@ function titleFontSize(kind) {
   return TITLE_FONT_SIZE.get(kind ?? "") ?? TITLE_FONT_SIZE_DEFAULT;
 }
 var TITLE_BOX_PADDING = 52;
+var KINDS_SCALING_TITLE_WHEN_LOW = /* @__PURE__ */ new Set(["actor", "event", "function", "storage"]);
+var KINDS_SCALING_TITLE_ALWAYS = /* @__PURE__ */ new Set([
+  "card",
+  "shape-file",
+  "shape-folder",
+  "shape-cloud",
+  "shape-cylinder",
+  "shape-hexagon",
+  "shape-diamond",
+  "shape-stack",
+  "shape-person",
+  "shape-server-rack",
+  "shape-network-node",
+  "shape-mobile-device",
+  "shape-satellite",
+  "shape-smart-contract",
+  "shape-rpc-node",
+  "shape-wallet",
+  "shape-nft",
+  "shape-token",
+  "shape-blockchain",
+  "shape-bitcoin-chain",
+  "shape-ethereum-chain",
+  "shape-blockchain-node",
+  "shape-bank",
+  "shape-trust-bank",
+  "shape-payment-provider",
+  "shape-credit-card",
+  "shape-brokerage",
+  "shape-exchange",
+  "shape-atm",
+  "shape-website",
+  "shape-storefront",
+  "shape-warehouse",
+  "shape-online-shop",
+  "shape-cdn-edge",
+  "shape-api-gateway"
+]);
+var COMPACT_TITLE_MAX_H = 100;
+function titleScalesToFit(kind, h) {
+  const k = kind ?? "";
+  if (KINDS_SCALING_TITLE_ALWAYS.has(k)) return true;
+  return KINDS_SCALING_TITLE_WHEN_LOW.has(k) && h < COMPACT_TITLE_MAX_H;
+}
+var MIN_TITLE_FONT_SIZE = 11;
 var KINDS_DRAWN_BY_GENERIC = [
   "person",
   "user-group",
@@ -17225,12 +17277,23 @@ 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 * titleFontSize(n.kind) + (drawsTitleOutsideBox(n.kind) ? 0 : TITLE_BOX_PADDING);
-    if (expectedW > n.w + 8) {
+    const \u4F59\u767D = drawsTitleOutsideBox(n.kind) ? 0 : TITLE_BOX_PADDING;
+    const \u4F7F\u3048\u308B\u5E452 = n.w - \u4F59\u767D;
+    const \u5B9F\u5E45 = measureTextWidth(titleTrimmed, { fontSize: titleFontSize(n.kind), bound: "drawn" });
+    if (titleScalesToFit(n.kind, n.h)) {
+      const \u7E2E\u3081\u305F\u5927\u304D\u3055 = \u5B9F\u5E45 > 0 ? titleFontSize(n.kind) * Math.min(1, \u4F7F\u3048\u308B\u5E452 / \u5B9F\u5E45) : titleFontSize(n.kind);
+      if (\u7E2E\u3081\u305F\u5927\u304D\u3055 < MIN_TITLE_FONT_SIZE) {
+        push(
+          "text-readability",
+          `node "${n.id}" title "${n.title}" \u304C node \u5E45 ${n.w}px \u306B\u53CE\u307E\u3089\u305A\u3001\u8AAD\u3081\u308B\u4E0B\u9650 ${MIN_TITLE_FONT_SIZE}px \u3092\u5272\u308B (\u7E2E\u3081\u3066 ${\u7E2E\u3081\u305F\u5927\u304D\u3055.toFixed(1)}px)`,
+          "warn"
+        );
+      }
+    } else if (\u5B9F\u5E45 > \u4F7F\u3048\u308B\u5E452 + 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(\u5B9F\u5E45 + \u4F59\u767D)}px)`,
         "warn"
       );
     }