@cardenelabs/cdl 0.40.6 → 0.40.8

package/CHANGELOG.md

@@ -5,6 +5,89 @@ CDL (Chainome Diagram Language) の主要変更履歴。
 
 ## [Unreleased]
 
+## [0.40.8] - 2026-09-08
+
+### Changed
+
+- **折れ線グラフの目盛りと軸の名前を役割名で拾えるようにした** (#755)
+
+  軸を持つ図は棒と折れ線の 2 つで、折れ線だけ縦軸の目盛りと横軸の名前に役割名が無かった。
+
+  | 字 | 棒グラフ | 折れ線グラフ (直す前) | 折れ線グラフ (直した後) |
+  |---|---|---|---|
+  | 縦軸の目盛りの数字 | `chart-bar-tick` | なし | `chart-line-tick` |
+  | 値札 | `chart-bar-value` | `chart-line-value` | `chart-line-value` |
+  | 横軸の名前 | `chart-bar-label` | なし | `chart-line-label` |
+
+  役割名が無いと字を位置か中身で拾うことになり、**図の見た目を変えていないのに検査が落ちる**。
+  位置で拾う形は余白を動かすと壊れ、中身で拾う形は同じ数が 2 か所に出ると壊れる
+  (実測で 4 件のはずが 5 件になった)。
+
+  描いたものは役割名が増えた以外 1 文字も変わらない。 円グラフと凡例を持つ図は
+  字の役割が別 (名前 / 割合 / 中央の合計) で同じ 3 つ組では表せないため、対象にしていない。
+
+- **折れ線グラフだけ値札が軸の名前より小さかったのを揃えた** (#753)
+
+  軸を持つ図は棒と折れ線の 2 つで、この 2 つだけ大きさの順が逆だった。
+
+  | 図 | 値札 | 軸の名前 |
+  |---|---|---|
+  | 棒グラフ | `12` | `11` |
+  | 折れ線グラフ (直す前) | `11` | `12` |
+  | 折れ線グラフ (直した後) | `12` | `11` |
+
+  棒を直した `#747` より前は棒も `11` / `12` で折れ線と同じだった = 逆転させたのは `#747` で、
+  片方だけ直して残りを置いていった形になっていた。
+
+  **凡例を持つ図 (半円ゲージ / 同心の弧 / 100 個の印 / 内訳の帯) は逆の順のまま**。
+  凡例では名前が行を見分ける鍵で、数値はそれに添える数になる。 軸の図では値札が印の上に
+  載る数そのもので、軸の名前は目盛りの側にある = 役割が違うので順も違ってよい。
+
+  大きさに名前を付け (`値札の級` / `軸の名前の級`)、2 図で揃っていることを検査が実物から
+  読んで確かめる。
+
+- **目盛りの刻みの計算が 2 箇所にあったのを 1 つに寄せた** (#751)
+
+  `1 / 2 / 2.5 / 5` に 10 の累乗を掛けた中から刻みを選ぶ計算が、折れ線と棒の両方にあった。
+  折れ線が先にあり、棒を直した `#747` で同じ計算を書き足していた。
+
+  `packages/cdl/src/kinds/axis-ticks.ts` に 1 つだけ置き、両方がそこから読む。
+  引数は「範囲」 と「目盛りの本数の目安」 で、折れ線は `最大 - 最小`、
+  棒は床が必ず 0 なので `最大` を渡す。
+
+  **天井と床の決め方は寄せない** = 折れ線は床も動かし、棒は床が必ず 0 で規則が違う。
+  目盛りの数字の書き方も図ごとに残す (折れ線は `toLocaleString`、棒は桁で丸めた数)。
+
+  出る目盛りは寄せる前と 1 つも変わらない。 描画にも記法にも影響しない。
+
+## [0.40.7] - 2026-09-08
+
+### Changed
+
+- **棒グラフの縦軸の目盛りを人が読む数にして、棒の太さと色を直した** (#747)
+
+  見本帳の棒グラフを測ると、普通の棒グラフから外れた値が 4 つ出ていた。
+
+  | 見たもの | 直す前 | 直した後 |
+  |---|---|---|
+  | 縦軸の目盛り | `0 / 170 / 340 / 510 / 680` | `0 / 200 / 400 / 600 / 800` |
+  | 棒幅 対 隙間 | 12.7 : 1 | 2.2 : 1 |
+  | 棒の色 | 1 種類 | いちばん大きい棒だけ濃い |
+  | 角丸 | `2` (幅 126.5px に対して) | 棒幅の 6% |
+
+  原因は 2 つに分かれる。 目盛りが半端なのは最大値をそのまま天井にして 4 等分していたため
+  (`680 / 4 = 170`)、棒が太いのは隙間を `10px` の固定値にして残りを全部棒へ配っていたため。
+
+  天井は `1 / 2 / 2.5 / 5` に 10 の累乗を掛けた刻みの倍数へ切り上げる。 **天井を水増しして
+  余白は作らない** = 最大 `100` の図は `0 / 25 / 50 / 75 / 100` が正しい形で、値札が枠に
+  重ならない余白は図の上の余白が持つ。
+
+  色は 1 つのまま濃さだけを変える。 棒グラフは同じ量どうしの比較で、色は量を表さない =
+  4 本に 4 色を配ると読み手が「色に意味がある」 と誤読する余地が残る。
+
+  棒の高さの比は値の比のままで、高さから値を読む使い方は変わらない。
+  記法 (`chartData`) にも読み込みにも影響しない。
+
 ## [0.40.6] - 2026-09-08
 
 ### Fixed
@@ -1904,7 +1987,9 @@ Initial OSS release.
 使わない = annotated tag を push しても GitHub Release は作られず、 Release を作っていない版で
 行き止まりになる。
 
-[Unreleased]: https://github.com/cardene777/cdl/compare/v0.40.6...HEAD
+[Unreleased]: https://github.com/cardene777/cdl/compare/v0.40.8...HEAD
+[0.40.8]: https://github.com/cardene777/cdl/compare/v0.40.7...v0.40.8
+[0.40.7]: https://github.com/cardene777/cdl/compare/v0.40.6...v0.40.7
 [0.40.6]: https://github.com/cardene777/cdl/compare/v0.40.5...v0.40.6
 [0.40.5]: https://github.com/cardene777/cdl/compare/v0.40.4...v0.40.5
 [0.40.4]: https://github.com/cardene777/cdl/compare/v0.40.3...v0.40.4

package/dist/index.cjs

@@ -22422,6 +22422,19 @@ function StateDiffCard({
     }
   );
 }
+
+// src/kinds/axis-ticks.ts
+function \u76EE\u76DB\u308A\u306E\u523B\u307F(\u7BC4\u56F2, \u76EE\u5B89\u306E\u672C\u6570) {
+  if (!(\u7BC4\u56F2 > 0) || false) return 0;
+  const \u7C97\u3044 = \u7BC4\u56F2 / \u76EE\u5B89\u306E\u672C\u6570;
+  const \u6841 = 10 ** Math.floor(Math.log10(\u7C97\u3044));
+  const \u6B63\u898F = \u7C97\u3044 / \u6841;
+  const \u5019\u88DC = \u6B63\u898F <= 1 ? 1 : \u6B63\u898F <= 2 ? 2 : \u6B63\u898F <= 2.5 ? 2.5 : \u6B63\u898F <= 5 ? 5 : 10;
+  return \u5019\u88DC * \u6841;
+}
+var \u76EE\u76DB\u308A\u306E\u76EE\u5B89 = 4;
+var \u5024\u672D\u306E\u7D1A = 12;
+var \u8EF8\u306E\u540D\u524D\u306E\u7D1A = 11;
 var \u6570\u3092\u66F8\u304F = (value) => value.toLocaleString("en-US", { maximumFractionDigits: 12 });
 function \u6298\u308C\u7DDA\u306E\u76EE\u76DB(values) {
   let rawMin = values.length > 0 ? Math.min(...values) : 0;
@@ -22431,11 +22444,7 @@ function \u6298\u308C\u7DDA\u306E\u76EE\u76DB(values) {
     rawMin -= room;
     rawMax += room;
   }
-  const roughStep = (rawMax - rawMin) / 4;
-  const power = 10 ** Math.floor(Math.log10(roughStep));
-  const fraction = roughStep / power;
-  const niceFraction = fraction <= 1 ? 1 : fraction <= 2 ? 2 : fraction <= 2.5 ? 2.5 : fraction <= 5 ? 5 : 10;
-  const step = niceFraction * power;
+  const step = \u76EE\u76DB\u308A\u306E\u523B\u307F(rawMax - rawMin, \u76EE\u76DB\u308A\u306E\u76EE\u5B89);
   const min = Math.floor(rawMin / step) * step;
   const max = Math.ceil(rawMax / step) * step;
   const tickCount = Math.round((max - min) / step);
@@ -22542,6 +22551,7 @@ function ChartLineNode({
       /* @__PURE__ */ jsxRuntime.jsx(
         "text",
         {
+          "data-cdl-role": "chart-line-tick",
           x: PAD_LEFT2 - 8,
           y: t.y + 4,
           fontSize: 11,
@@ -22619,7 +22629,7 @@ function ChartLineNode({
             "data-cdl-role": "chart-line-value",
             x: cx,
             y: labelY,
-            fontSize: 11,
+            fontSize: \u5024\u672D\u306E\u7D1A,
             fontWeight: 600,
             textAnchor: "middle",
             fill: "var(--cdl-text, #1a1f2a)",
@@ -22677,9 +22687,10 @@ function ChartLineNode({
         /* @__PURE__ */ jsxRuntime.jsx(
           "text",
           {
+            "data-cdl-role": "chart-line-label",
             x: cx,
             y: PAD_TOP2 + canvasH + 20,
-            fontSize: 12,
+            fontSize: \u8EF8\u306E\u540D\u524D\u306E\u7D1A,
             textAnchor: "middle",
             fill: "var(--cdl-text-dim, #5a6270)",
             children: d.label
@@ -25897,6 +25908,14 @@ function \u53CE\u3081\u308B\u7D1A2(\u540D\u524D\u305F\u3061, \u5E45, \u4E0A\u965
   while (\u7D1A > \u4E0B\u9650 && Math.max(...\u540D\u524D\u305F\u3061.map((n) => textWidth(n, \u7D1A))) > \u5E45) \u7D1A -= 1;
   return \u7D1A;
 }
+function \u5C0F\u6570\u306E\u6841(n) {
+  const [\u4EEE\u6570, \u6307\u6570] = n.toExponential().split("e");
+  const \u5C0F\u6570\u90E8 = (\u4EEE\u6570 ?? "").split(".")[1]?.length ?? 0;
+  return Math.min(20, Math.max(0, \u5C0F\u6570\u90E8 - Number(\u6307\u6570)));
+}
+var \u5024\u672D\u306E\u7D1A2 = 12;
+var \u8EF8\u306E\u540D\u524D\u306E\u7D1A2 = 11;
+var \u6841\u3067\u4E38\u3081\u308B = (v, \u6841) => Number(v.toFixed(\u6841));
 function ChartBarNode({
   node,
   active,
@@ -25907,24 +25926,33 @@ function ChartBarNode({
   const x0 = node.cx - node.w / 2;
   const y0 = node.cy - node.h / 2;
   const data = resolveChartData(node.chartData ?? [], stateValues);
-  const PAD_TOP2 = 20;
+  const PAD_TOP2 = 34;
   const PAD_RIGHT2 = 24;
   const PAD_BOTTOM2 = 44;
   const PAD_LEFT2 = 60;
   const canvasW = node.w - PAD_LEFT2 - PAD_RIGHT2;
   const canvasH = node.h - PAD_TOP2 - PAD_BOTTOM2;
   const vMax = data.length > 0 ? Math.max(...data.map((d) => d.value)) : 1;
-  const vRange = vMax || 1;
-  const barGap = 10;
+  const \u76EE\u76DB\u308A\u306E\u76EE\u5B892 = 4;
+  const \u5929\u4E95\u306E\u3082\u3068 = vMax > 0 ? vMax : 1;
+  const \u523B\u307F = \u76EE\u76DB\u308A\u306E\u523B\u307F(\u5929\u4E95\u306E\u3082\u3068, \u76EE\u76DB\u308A\u306E\u76EE\u5B892);
+  const \u523B\u307F\u306E\u6841 = \u5C0F\u6570\u306E\u6841(\u523B\u307F);
+  const \u5929\u4E95 = \u6841\u3067\u4E38\u3081\u308B(Math.ceil(\u5929\u4E95\u306E\u3082\u3068 / \u523B\u307F - 1e-9) * \u523B\u307F, \u523B\u307F\u306E\u6841);
+  const \u68D2\u3068\u9699\u9593\u306E\u6BD4 = 2.2;
+  const \u68D2\u306E\u4E0A\u9650 = 96;
   const barCount = data.length || 1;
-  const barW = (canvasW - barGap * (barCount + 1)) / barCount;
-  const yAt = (v) => PAD_TOP2 + canvasH - v / vRange * canvasH;
+  const \u5358\u4F4D = canvasW / (barCount * \u68D2\u3068\u9699\u9593\u306E\u6BD4 + (barCount + 1));
+  const barW = Math.max(0, Math.min(\u5358\u4F4D * \u68D2\u3068\u9699\u9593\u306E\u6BD4, \u68D2\u306E\u4E0A\u9650));
+  const barGap = (canvasW - barW * barCount) / (barCount + 1);
+  const yAt = (v) => PAD_TOP2 + canvasH - v / \u5929\u4E95 * canvasH;
   const xAt = (idx) => PAD_LEFT2 + barGap + idx * (barW + barGap);
-  const gridCount = 4;
-  const gridTicks = Array.from({ length: gridCount + 1 }, (_, i) => {
-    const v = vMax * i / gridCount;
+  const \u76EE\u76DB\u308A\u306E\u672C\u6570 = Math.round(\u5929\u4E95 / \u523B\u307F);
+  const gridTicks = Array.from({ length: \u76EE\u76DB\u308A\u306E\u672C\u6570 + 1 }, (_, i) => {
+    const v = \u6841\u3067\u4E38\u3081\u308B(\u523B\u307F * i, \u523B\u307F\u306E\u6841);
     return { y: yAt(v), value: v };
   });
+  const \u6FC3\u3055 = (v) => vMax > 0 ? v >= vMax ? 1 : 0.45 : 0.9;
+  const \u89D2\u4E38 = Math.min(barW * 0.06, 8);
   const \u4F38\u3073 = \u9032\u307F\u3092\u7573\u3080(drawing, progress);
   const \u6A2A\u8EF8\u306Ey = PAD_TOP2 + canvasH;
   return /* @__PURE__ */ jsxRuntime.jsxs("g", { transform: `translate(${x0} ${y0})`, children: [
@@ -25959,12 +25987,13 @@ function ChartBarNode({
       /* @__PURE__ */ jsxRuntime.jsx(
         "text",
         {
+          "data-cdl-role": "chart-bar-tick",
           x: PAD_LEFT2 - 8,
           y: t.y + 4,
           fontSize: 11,
           textAnchor: "end",
           fill: "var(--cdl-text-dim, #5a6270)",
-          children: Math.round(t.value)
+          children: t.value
         }
       )
     ] }, `grid-${i}`)),
@@ -25982,7 +26011,7 @@ function ChartBarNode({
     data.map((d, idx) => {
       const bx = xAt(idx);
       const by = yAt(d.value);
-      const bh = PAD_TOP2 + canvasH - by;
+      const bh = Math.max(0, PAD_TOP2 + canvasH - by);
       const \u898B\u3048\u3066\u3044\u308B\u982D = \u6A2A\u8EF8\u306Ey - (\u6A2A\u8EF8\u306Ey - by) * \u4F38\u3073;
       const \u68D2 = /* @__PURE__ */ jsxRuntime.jsx(
         "rect",
@@ -25993,9 +26022,9 @@ function ChartBarNode({
           y: by,
           width: barW,
           height: bh,
-          rx: 2,
+          rx: \u89D2\u4E38,
           fill: "var(--cdl-tone-accent, #2d6a8f)",
-          fillOpacity: 0.9
+          fillOpacity: \u6FC3\u3055(d.value)
         }
       );
       return /* @__PURE__ */ jsxRuntime.jsxs("g", { children: [
@@ -26003,9 +26032,11 @@ function ChartBarNode({
         /* @__PURE__ */ jsxRuntime.jsx(
           "text",
           {
+            "data-cdl-role": "chart-bar-value",
             x: bx + barW / 2,
-            y: \u898B\u3048\u3066\u3044\u308B\u982D - 6,
-            fontSize: 11,
+            y: \u898B\u3048\u3066\u3044\u308B\u982D - 8,
+            fontSize: \u5024\u672D\u306E\u7D1A2,
+            fontWeight: 600,
             textAnchor: "middle",
             fill: "var(--cdl-text, #1a1f2a)",
             children: d.value.toLocaleString()
@@ -26014,9 +26045,10 @@ function ChartBarNode({
         /* @__PURE__ */ jsxRuntime.jsx(
           "text",
           {
+            "data-cdl-role": "chart-bar-label",
             x: bx + barW / 2,
             y: PAD_TOP2 + canvasH + 18,
-            fontSize: 12,
+            fontSize: \u8EF8\u306E\u540D\u524D\u306E\u7D1A2,
             textAnchor: "middle",
             fill: "var(--cdl-text-dim, #5a6270)",
             children: d.label