@cardenelabs/cdl 0.34.0 → 0.36.0

package/CHANGELOG.md

@@ -5,6 +5,39 @@ CDL (Chainome Diagram Language) の主要変更履歴。
 
 ## [Unreleased]
 
+## [0.36.0] - 2026-09-07
+
+### Added
+
+- **傾き図の右の列に増減を出す見せ方を足した** (#702)
+
+  `chartSlopeForm` に `delta` を書くと、右の列が今の値ではなく増減 (`+40` / `-90`) になる。
+  欄を書かない図は今までどおり今の値を出す。
+
+  傾き図は増減を読ませる図なのに、差はどこにも字になっておらず読み手の暗算だった。
+  3 つ目の数を足すと名札が縦に衝突するか線を引く幅が縮むため、今の値を増減に置き換える形で
+  列を 2 つに保っている。 左の列は前の値のままなので、`前 + 増減 = 今` で今の値は戻せる。
+
+  増減は `chart-slope-delta` で出す。 今の値とは意味が違い、消費側が増減だけに色を当てられる
+  ようにするため。 engine 側では色を分けない = 系列の色を名前に当てているので、増減にも色を
+  当てると 1 つの図に 2 つの色の体系が混ざる。 向きは符号が持つ。
+
+  型の外の値と、前の時点を持たない図は `values` として描く。
+
+## [0.35.0] - 2026-09-07
+
+### Changed
+
+- **傾き図の系列の名前を線と同じ色で描くようにした** (#698)
+
+  名前も値も同じ淡い色だったため、名前と線を突き合わせるには線を目で辿るしかなかった。
+  交差を読ませる図で、交差した先を追う作業が読み手に残っていた。
+
+  色を持たせるのは名前だけで、値は太字の濃い色のまま。 identity は色が、量は字が担う。
+
+  併せて時点の軸の縦線を太さ 1 から 2 にした。 淡い罫では柱に見えず、「前」「今」 の見出し
+  だけが宙に浮いていた。 系列の線 (2.5) より細いままなので、軸が線の 1 本には見えない。
+
 ## [0.34.0] - 2026-09-07
 
 ### Changed
@@ -1663,7 +1696,9 @@ Initial OSS release.
 使わない = annotated tag を push しても GitHub Release は作られず、 Release を作っていない版で
 行き止まりになる。
 
-[Unreleased]: https://github.com/cardene777/cdl/compare/v0.34.0...HEAD
+[Unreleased]: https://github.com/cardene777/cdl/compare/v0.36.0...HEAD
+[0.36.0]: https://github.com/cardene777/cdl/compare/v0.35.0...v0.36.0
+[0.35.0]: https://github.com/cardene777/cdl/compare/v0.34.0...v0.35.0
 [0.34.0]: https://github.com/cardene777/cdl/compare/v0.33.0...v0.34.0
 [0.33.0]: https://github.com/cardene777/cdl/compare/v0.32.0...v0.33.0
 [0.32.0]: https://github.com/cardene777/cdl/compare/v0.31.1...v0.32.0

package/README.md

@@ -295,6 +295,30 @@ phase 切替に連動して `status: idle` → `status: running` のように描
 
 名札の字は値と名前で role が分かれる (`chart-slope-value` / `chart-slope-name`)。
 値だけに字体を当てられるようにするため。
+系列の名前はその線と同じ色で描く。 線を目で辿らずに名前と線の対応が取れる。
+
+### 右の列に何を出すか
+
+`chart-slope` は `chartSlopeForm` で右の列の中身を選ぶ。 欄を書かない図は `values` と同じ。
+
+| 値 | 右の列 | 向くもの |
+|---|---|---|
+| `values` (既定) | 今の値 | 2 時点の水準をそれぞれ読ませたい図 |
+| `delta` | 増減 (`+40` / `-90`) | どれがどれだけ動いたかを読ませたい図 |
+
+```ts
+.node("move", { lane: "l", stack: 0, kind: "chart-slope", chartSlopeForm: "delta", chartData: [...] })
+```
+
+左の列はどちらでも前の値。 `前 + 増減 = 今` なので `delta` でも今の値は足せば戻る。
+3 つ目の数を足さないので、 名札の高さも線を引く幅も変わらない。
+
+`delta` の増減は `chart-slope-delta` で出す。 今の値とは意味が違い、 消費側が増減だけに色を
+当てられるようにするため。 engine 側では色を分けない = 系列の色を名前に当てているので、
+増減にも色を当てると 1 つの図に 2 つの色の体系が混ざる。 向きは符号が持つ。
+
+型の外の値を書いた図は `values` として描く。
+前の時点を持たない図も `values` として描く = 引く相手がいないため。
 
 ## 円グラフの見せ方
 

package/dist/index.cjs

@@ -24338,6 +24338,15 @@ function interpolateColor(template, stateValues, fallback) {
   if (!template) return fallback;
   return interpolate(template, stateValues);
 }
+
+// src/kinds/chart-number.ts
+function \u5B9F\u5024\u8868\u8A18(v) {
+  return Number.isInteger(v) ? v.toLocaleString("en-US") : v.toLocaleString("en-US", { maximumFractionDigits: 1 });
+}
+function \u5272\u5408\u8868\u8A18(frac) {
+  const v = Math.round(frac * 1e3) / 10;
+  return `${Number.isInteger(v) ? v : v.toFixed(1)}%`;
+}
 function ChartPieNode({
   node,
   active,
@@ -24785,13 +24794,6 @@ function \u6247\u5F62\u306E\u5207\u308A\u629C\u304D(cx, cy, r, \u958B\u304D) {
   const d = `M ${cx} ${cy} L ${cx + r * Math.cos(a0)} ${cy + r * Math.sin(a0)} A ${r} ${r} 0 ${large} 1 ${cx + r * Math.cos(a1)} ${cy + r * Math.sin(a1)} Z`;
   return /* @__PURE__ */ jsxRuntime.jsx("path", { d });
 }
-function \u5B9F\u5024\u8868\u8A18(v) {
-  return Number.isInteger(v) ? v.toLocaleString("en-US") : v.toLocaleString("en-US", { maximumFractionDigits: 1 });
-}
-function \u5272\u5408\u8868\u8A18(frac) {
-  const v = Math.round(frac * 1e3) / 10;
-  return `${Number.isInteger(v) ? v : v.toFixed(1)}%`;
-}
 function sliceColor(tone, idx) {
   if (tone) return TONE[tone];
   return chartSeriesColor(idx);
@@ -24832,7 +24834,7 @@ function ChartGaugeNode({
     const path = `M ${\u59161.x} ${\u59161.y} A ${radius} ${radius} 0 0 1 ${\u59162.x} ${\u59162.y} L ${\u51852.x} ${\u51852.y} A ${\u5185\u534A\u5F84} ${\u5185\u534A\u5F84} 0 0 0 ${\u51851.x} ${\u51851.y} Z`;
     return { d, frac, path };
   });
-  const \u5408\u8A08\u306E\u6587\u5B57 = \u5B9F\u5024\u8868\u8A182(Math.round(total));
+  const \u5408\u8A08\u306E\u6587\u5B57 = \u5B9F\u5024\u8868\u8A18(Math.round(total));
   const \u6A2A\u306E\u4E0A\u9650 = \u5185\u534A\u5F84 * 2 * 0.86;
   const \u7D1A\u306E\u5019\u88DC = Math.min(
     // 横 = 実際の字幅から逆算する
@@ -24897,7 +24899,7 @@ function ChartGaugeNode({
     ),
     data.map((d, idx) => {
       const x = PAD_SIDE + \u5185\u8A33\u306E\u5E45 * idx;
-      const \u6570\u5024 = `${\u5B9F\u5024\u8868\u8A182(d.value)}  ${\u5272\u5408\u8868\u8A182(d.value / total)}`;
+      const \u6570\u5024 = `${\u5B9F\u5024\u8868\u8A18(d.value)}  ${\u5272\u5408\u8868\u8A18(d.value / total)}`;
       return /* @__PURE__ */ jsxRuntime.jsxs("g", { "data-cdl-role": "chart-gauge-item", children: [
         /* @__PURE__ */ jsxRuntime.jsx("rect", { x, y: \u5185\u8A33\u306Ey, width: 30, height: 4, rx: 2, fill: arcColor(d.tone, idx) }),
         /* @__PURE__ */ jsxRuntime.jsx(
@@ -24929,13 +24931,6 @@ function \u5207\u308A\u8A70\u3081\u308B(s, \u4E0A\u9650, \u7D1A) {
   }
   return `${out}\u2026`;
 }
-function \u5B9F\u5024\u8868\u8A182(v) {
-  return Number.isInteger(v) ? v.toLocaleString("en-US") : v.toLocaleString("en-US", { maximumFractionDigits: 1 });
-}
-function \u5272\u5408\u8868\u8A182(frac) {
-  const v = Math.round(frac * 1e3) / 10;
-  return `${Number.isInteger(v) ? v : v.toFixed(1)}%`;
-}
 function arcColor(tone, idx) {
   if (tone) return TONE[tone];
   return chartSeriesColor(idx);
@@ -24955,7 +24950,7 @@ function ChartRadialNode({
   const \u6570\u5024\u306E\u7D1A = 13;
   const \u884C\u306E\u9AD8\u3055 = 42;
   const \u4E00\u89A7\u3068\u5F27\u306E\u9593 = 28;
-  const \u6570\u5024\u306E\u6587\u5B57 = data.map((d) => `${\u5B9F\u5024\u8868\u8A183(d.value)}  ${\u5272\u5408\u8868\u8A183(d.value / total)}`);
+  const \u6570\u5024\u306E\u6587\u5B57 = data.map((d) => `${\u5B9F\u5024\u8868\u8A18(d.value)}  ${\u5272\u5408\u8868\u8A18(d.value / total)}`);
   const \u4E00\u89A7\u306E\u5E45 = \u5370\u306E\u5E45 + Math.max(
     0,
     ...data.map(
@@ -25058,13 +25053,6 @@ function \u5F27\u306E\u90532(cx, cy, \u4E2D\u5FC3\u534A\u5F84, \u5E45, \u5272\u5
   const p = (r, a) => `${cx + r * Math.cos(a)} ${cy + r * Math.sin(a)}`;
   return `M ${p(\u5916, a0)} A ${\u5916} ${\u5916} 0 ${large} 1 ${p(\u5916, a1)} L ${p(\u5185, a1)} A ${\u5185} ${\u5185} 0 ${large} 0 ${p(\u5185, a0)} Z`;
 }
-function \u5B9F\u5024\u8868\u8A183(v) {
-  return Number.isInteger(v) ? v.toLocaleString("en-US") : v.toLocaleString("en-US", { maximumFractionDigits: 1 });
-}
-function \u5272\u5408\u8868\u8A183(frac) {
-  const v = Math.round(frac * 1e3) / 10;
-  return `${Number.isInteger(v) ? v : v.toFixed(1)}%`;
-}
 function arcColor2(tone, idx) {
   if (tone) return TONE[tone];
   return chartSeriesColor(idx);
@@ -25098,7 +25086,7 @@ function ChartStatNode({
       const \u67A02 = \u533A\u753B.\u67A0(idx);
       const frac = total > 0 ? d.value / total : 0;
       const \u8272 = \u5370\u306E\u8272(d.tone, idx);
-      const \u6570\u5024 = \u5B9F\u5024\u8868\u8A184(d.value);
+      const \u6570\u5024 = \u5B9F\u5024\u8868\u8A18(d.value);
       const \u6570\u5024\u306E\u7D1A = \u53CE\u3081\u308B\u7D1A(\u6570\u5024, \u67A02.w - \u533A\u753B.\u4F59\u767D * 2, \u533A\u753B.\u6570\u5024\u306E\u7D1A, \u533A\u753B.\u540D\u524D\u306E\u7D1A + 1);
       return /* @__PURE__ */ jsxRuntime.jsxs("g", { "data-cdl-role": "chart-stat-item", transform: `translate(${\u67A02.x} ${\u67A02.y})`, children: [
         idx > 0 && /* @__PURE__ */ jsxRuntime.jsx(
@@ -25173,7 +25161,7 @@ function ChartStatNode({
             fontSize: \u533A\u753B.\u5272\u5408\u306E\u7D1A,
             textAnchor: "middle",
             fill: "var(--cdl-text-dim, #5a6270)",
-            children: \u5272\u5408\u8868\u8A184(frac)
+            children: \u5272\u5408\u8868\u8A18(frac)
           }
         )
       ] }, `stat-${idx}`);
@@ -25220,13 +25208,6 @@ function \u5F27\u306E\u90533(cx, cy, r, \u5272\u5408) {
   const p = (a) => `${cx + r * Math.cos(a)} ${cy + r * Math.sin(a)}`;
   return `M ${p(a0)} A ${r} ${r} 0 ${large} 1 ${p(a1)}`;
 }
-function \u5B9F\u5024\u8868\u8A184(v) {
-  return Number.isInteger(v) ? v.toLocaleString("en-US") : v.toLocaleString("en-US", { maximumFractionDigits: 1 });
-}
-function \u5272\u5408\u8868\u8A184(frac) {
-  const v = Math.round(frac * 1e3) / 10;
-  return `${Number.isInteger(v) ? v : v.toFixed(1)}%`;
-}
 function \u5370\u306E\u8272(tone, idx) {
   if (tone) return TONE[tone];
   return chartSeriesColor(idx);
@@ -25262,7 +25243,7 @@ function ChartWaffleNode({
   const \u884C\u306E\u9AD8\u3055 = 40;
   const \u4E00\u89A7\u3068\u683C\u5B50\u306E\u9593 = 28;
   const \u5370\u306E\u5E452 = 18;
-  const \u6570\u5024\u306E\u6587\u5B57 = data.map((d, i) => `${\u5B9F\u5024\u8868\u8A185(d.value)}  ${\u914D\u5206[i] ?? 0}%`);
+  const \u6570\u5024\u306E\u6587\u5B57 = data.map((d, i) => `${\u5B9F\u5024\u8868\u8A18(d.value)}  ${\u914D\u5206[i] ?? 0}%`);
   const \u4E00\u89A7\u306E\u5E45 = \u5370\u306E\u5E452 + Math.max(
     0,
     ...data.map(
@@ -25346,9 +25327,6 @@ function ChartWaffleNode({
     })
   ] });
 }
-function \u5B9F\u5024\u8868\u8A185(v) {
-  return Number.isInteger(v) ? v.toLocaleString("en-US") : v.toLocaleString("en-US", { maximumFractionDigits: 1 });
-}
 function \u5370\u306E\u82722(tone, idx) {
   if (tone) return TONE[tone];
   return chartSeriesColor(idx);
@@ -25435,7 +25413,7 @@ function ChartStackedBarNode({
                 fontWeight: 700,
                 textAnchor: "middle",
                 fill: "#ffffff",
-                children: \u5272\u5408\u8868\u8A185(s.\u5272\u5408)
+                children: \u5272\u5408\u8868\u8A18(s.\u5272\u5408)
               }
             ),
             w >= SLICE_MIN_W_FOR_VALUE && /* @__PURE__ */ jsxRuntime.jsx(
@@ -25448,7 +25426,7 @@ function ChartStackedBarNode({
                 textAnchor: "middle",
                 fill: "#ffffff",
                 fillOpacity: 0.85,
-                children: \u5B9F\u5024\u8868\u8A186(s.\u5B9F\u5024)
+                children: \u5B9F\u5024\u8868\u8A18(s.\u5B9F\u5024)
               }
             )
           ] }, `slice-${idx}`);
@@ -25493,13 +25471,6 @@ function \u5E2F\u3092\u7D44\u3080(\u540D\u524D, data, \u53D6\u308B) {
     }))
   };
 }
-function \u5B9F\u5024\u8868\u8A186(v) {
-  return Number.isInteger(v) ? v.toLocaleString("en-US") : v.toLocaleString("en-US", { maximumFractionDigits: 1 });
-}
-function \u5272\u5408\u8868\u8A185(frac) {
-  const v = Math.round(frac * 1e3) / 10;
-  return `${Number.isInteger(v) ? v : v.toFixed(1)}%`;
-}
 function \u5370\u306E\u82723(tone, idx) {
   if (tone) return TONE[tone];
   return chartSeriesColor(idx);
@@ -25521,11 +25492,6 @@ function \u4E00\u89A7\u306E\u4E26\u3073(data, \u5DE6, \u53F3\u7AEF, \u7D1A) {
   });
   return out;
 }
-
-// src/kinds/chart-number.ts
-function \u5B9F\u5024\u8868\u8A187(v) {
-  return Number.isInteger(v) ? v.toLocaleString("en-US") : v.toLocaleString("en-US", { maximumFractionDigits: 1 });
-}
 var \u7DDA\u306E\u6700\u5C0F\u5E45 = 120;
 function ChartSlopeNode({
   node,
@@ -25561,8 +25527,15 @@ function ChartSlopeNode({
   const \u4E0A\u7AEF = PAD + (\u524D\u3042\u308A ? \u6642\u70B9\u306E\u7D1A + 12 : 0) + 6;
   const \u4E0B\u7AEF = Math.max(\u4E0A\u7AEF + 10, node.h - PAD - 6);
   const y\u3092\u53D6\u308B = (v) => \u5C3A\u306E\u5E45 > 0 ? \u4E0B\u7AEF - (v - \u6700\u5C0F) / \u5C3A\u306E\u5E45 * (\u4E0B\u7AEF - \u4E0A\u7AEF) : (\u4E0A\u7AEF + \u4E0B\u7AEF) / 2;
-  const \u5DE6\u306E\u5B57 = \u7CFB\u5217\u305F\u3061.map((s) => \u5B9F\u5024\u8868\u8A187(s.\u524D));
-  const \u53F3\u306E\u5B57 = \u7CFB\u5217\u305F\u3061.map((s) => \u5B9F\u5024\u8868\u8A187(s.\u4ECA));
+  const \u5F62 = \u524D\u3042\u308A && node.chartSlopeForm === "delta" ? "delta" : "values";
+  const \u5897\u6E1B\u8868\u8A18 = (\u524D, \u4ECA) => {
+    const \u5DEE = \u4ECA - \u524D;
+    return \u5DEE > 0 ? `+${\u5B9F\u5024\u8868\u8A18(\u5DEE)}` : \u5B9F\u5024\u8868\u8A18(\u5DEE);
+  };
+  const \u5DE6\u306E\u5B57 = \u7CFB\u5217\u305F\u3061.map((s) => \u5B9F\u5024\u8868\u8A18(s.\u524D));
+  const \u53F3\u306E\u5B57 = \u7CFB\u5217\u305F\u3061.map(
+    (s) => \u5F62 === "delta" ? \u5897\u6E1B\u8868\u8A18(s.\u524D, s.\u4ECA) : \u5B9F\u5024\u8868\u8A18(s.\u4ECA)
+  );
   const \u5DE6\u5024\u5E45 = Math.max(0, ...\u5DE6\u306E\u5B57.map((t) => textWidth(t, \u5024\u306E\u7D1A)));
   const \u53F3\u5024\u5E45 = Math.max(0, ...\u53F3\u306E\u5B57.map((t) => textWidth(t, \u5024\u306E\u7D1A)));
   const \u540D\u524D\u306B\u4F7F\u3048\u308B = Math.max(
@@ -25604,7 +25577,7 @@ function ChartSlopeNode({
         x2: x,
         y2: \u4E0B\u7AEF + 6,
         stroke: "var(--cdl-divider, #d4d4d8)",
-        strokeWidth: 1
+        strokeWidth: 2
       },
       `axis-${i}`
     )),
@@ -25698,7 +25671,7 @@ function ChartSlopeNode({
               y: \u5DE6y + 5,
               textAnchor: "end",
               fontSize: \u540D\u524D\u306E\u7D1A,
-              fill: "var(--cdl-text-dim, #5a6270)",
+              fill: s.\u8272,
               children: s.\u540D\u524D
             }
           )
@@ -25710,7 +25683,7 @@ function ChartSlopeNode({
             y: \u53F3y + 5,
             textAnchor: "end",
             fontSize: \u540D\u524D\u306E\u7D1A,
-            fill: "var(--cdl-text-dim, #5a6270)",
+            fill: s.\u8272,
             children: s.\u540D\u524D
           }
         ),
@@ -25718,7 +25691,7 @@ function ChartSlopeNode({
           /* @__PURE__ */ jsxRuntime.jsx(
             "text",
             {
-              "data-cdl-role": "chart-slope-value",
+              "data-cdl-role": \u5F62 === "delta" ? "chart-slope-delta" : "chart-slope-value",
               x: \u53F3\u8EF8x + \u8EF8\u304B\u3089\u5024\u307E\u3067,
               y: \u53F3y + 5,
               fontSize: \u5024\u306E\u7D1A,
@@ -25734,7 +25707,7 @@ function ChartSlopeNode({
               x: \u53F3\u8EF8x + \u8EF8\u304B\u3089\u5024\u307E\u3067 + \u53F3\u5024\u5E45 + \u5024\u304B\u3089\u540D\u524D\u307E\u3067,
               y: \u53F3y + 5,
               fontSize: \u540D\u524D\u306E\u7D1A,
-              fill: "var(--cdl-text-dim, #5a6270)",
+              fill: s.\u8272,
               children: s.\u540D\u524D
             }
           )