@cardenelabs/cdl 0.17.1 → 0.18.1

package/CHANGELOG.md

@@ -5,6 +5,52 @@ CDL (Chainome Diagram Language) の主要変更履歴。
 
 ## [Unreleased]
 
+## [0.18.1] - 2026-08-29
+
+### Fixed
+
+- **矢印を伸ばすのは初めて出る段だけにした** (#584)
+
+  伸ばすかを「その矢印が光っているか」 で引いていたため、段をまたいで光り続ける図で
+  **既に見えている線が段の変わるたびに引き直されて** いた (実測 = 表の図で 3 本とも毎段伸び直す)。
+
+  「増えた」 のは 1 度だけなので、動くのも 1 度にする。 段の並びから矢印ごとの初出を求め、
+  その段でだけ起点から伸ばす。
+
+  **隠さない図 (`edgeReveal: "all"`) でも初出は数える**。 `all` は「最初から見せる」 だけの
+  指定で、伸びる動きまで毎段繰り返してよいという意味ではない。
+
+  段が矢印を 1 度も名指ししない図では伸ばさない = 初出が無く、いつ伸ばすか決められない。
+
+  検査が実際の描画から読めるよう、`data-cdl-drawing` を矢印に出す。
+
+## [0.18.0] - 2026-08-29
+
+### Added
+
+- **段が来るまで矢印を描かないようにした** (#582)
+
+  段を進めるごとに関係が 1 本ずつ増える図で、**全ての矢印が 1 段目から見えていた**。
+  段が矢印を光らせるとその線だけ引き直されるが、既に見えているので「増えた」 とは読めず、
+  無関係な線がちらついたようにしか見えない (user 実機確認)。
+
+  判定は **段が矢印を名指ししているか** で行う。 段のどこかで `activate` に載る矢印は、
+  その段が来るまで描かない。 1 度出たら以降は出したままにする = 消える向きの動きは、
+  読み手が「戻った」 と読む。
+
+  **段が矢印を 1 度も名指ししない図では隠さない**。 そういう図では矢印が骨格そのもので、
+  隠すと図が読めなくなる = 既定を変えても既存の図は動かない。
+
+  著者が切り替えられるよう `CdlDiagram.edgeReveal` を足した。
+
+  | 値 | 何が起きるか |
+  |---|---|
+  | `phase` (既定) | 段が名指しする矢印は、その段が来るまで描かない |
+  | `all` | 段に関わらず最初から全部描く |
+
+  書ける値の一覧 (`EDGE_REVEALS`) と既定 (`EDGE_REVEAL_DEFAULT`) を公開する。
+  利用側が手で並べると、値を足した時に書けないまま取り残される。
+
 ## [0.17.1] - 2026-08-29
 
 ### Changed
@@ -918,7 +964,9 @@ Initial OSS release.
 使わない = annotated tag を push しても GitHub Release は作られず、 Release を作っていない版で
 行き止まりになる。
 
-[Unreleased]: https://github.com/cardene777/cdl/compare/v0.17.1...HEAD
+[Unreleased]: https://github.com/cardene777/cdl/compare/v0.18.1...HEAD
+[0.18.1]: https://github.com/cardene777/cdl/compare/v0.18.0...v0.18.1
+[0.18.0]: https://github.com/cardene777/cdl/compare/v0.17.1...v0.18.0
 [0.17.1]: https://github.com/cardene777/cdl/compare/v0.17.0...v0.17.1
 [0.17.0]: https://github.com/cardene777/cdl/compare/v0.16.0...v0.17.0
 [0.16.0]: https://github.com/cardene777/cdl/compare/v0.15.0...v0.16.0

package/dist/index.cjs

@@ -15373,6 +15373,8 @@ function layout(diag) {
     states: diag.states,
     phases: diag.phases,
     ...diag.derived ? { derived: diag.derived } : {},
+    // 矢印をいつ出すか (#582)。 描き手が読む欄なので、そのまま持ち越す
+    ...diag.edgeReveal ? { edgeReveal: diag.edgeReveal } : {},
     bboxes,
     collisions,
     nearCollisions,
@@ -15531,6 +15533,8 @@ var EDGE_HEADS = [
 ];
 var EDGE_HEAD_FILL_DEFAULT = "solid";
 var EDGE_HEAD_FILLS = ["solid", "hollow"];
+var EDGE_REVEALS = ["phase", "all"];
+var EDGE_REVEAL_DEFAULT = "phase";
 
 // src/anim/core/easing.ts
 function cubicBezier(x1, y1, x2, y2) {
@@ -21270,6 +21274,7 @@ function labelTextOpacity(line) {
 function CdlEdgeView({
   edge,
   active,
+  drawing,
   progress,
   stateValues
 }) {
@@ -21294,6 +21299,7 @@ function CdlEdgeView({
       "data-cdl-from": edge.from,
       "data-cdl-to": edge.to,
       "data-cdl-active": active ? "true" : "false",
+      "data-cdl-drawing": drawing ? "true" : "false",
       "data-cdl-path-d": edge.d,
       "data-cdl-label-x": edge.labelX,
       "data-cdl-label-y": edge.labelY,
@@ -21325,6 +21331,7 @@ function CdlEdgeView({
           {
             edge,
             active,
+            drawing,
             progress,
             color,
             marker,
@@ -21352,6 +21359,7 @@ function CdlEdgeView({
 function SolidEdgePath({
   edge,
   active,
+  drawing,
   progress,
   color,
   marker,
@@ -21359,7 +21367,7 @@ function SolidEdgePath({
   dashed,
   stateValues
 }) {
-  const visibleD = active ? pathSubpath(edge.d, progress) : edge.d;
+  const visibleD = drawing ? pathSubpath(edge.d, progress) : edge.d;
   const defaultWidth = active ? 5 : 2.5;
   const boundWidth = edge.widthBind && stateValues ? resolveNumericAttr(edge.widthBind, stateValues, defaultWidth) : defaultWidth;
   const boundStroke = edge.strokeBind && stateValues ? interpolate(edge.strokeBind, stateValues) : color;
@@ -28803,6 +28811,36 @@ function CdlStage({
   svgRef
 }) {
   const activeSet = new Set(currentPhase?.activate ?? []);
+  const \u77E2\u5370\u306E\u51FA\u756A = react.useMemo(() => {
+    const \u521D\u51FA = /* @__PURE__ */ new Map();
+    laid.phases.forEach((p, i) => {
+      for (const id of p.activate ?? []) if (!\u521D\u51FA.has(id)) \u521D\u51FA.set(id, i);
+    });
+    const \u4ECA = currentPhase === void 0 ? -1 : laid.phases.findIndex((p) => p.id === currentPhase.id);
+    const \u96A0\u3059 = (laid.edgeReveal ?? EDGE_REVEAL_DEFAULT) !== "all";
+    return {
+      \u51FA\u308B\u304B: (edgeId) => {
+        if (!\u96A0\u3059) return true;
+        const first = \u521D\u51FA.get(edgeId);
+        if (first === void 0) return true;
+        return \u4ECA < 0 || \u4ECA >= first;
+      },
+      /*
+       * この段で初めて出るか (#584)。
+       *
+       * 起点から伸ばすのはこの段だけ。 光っているかで引くと、段をまたいで光り続ける図で
+       * 既に見えている線が毎段引き直される (実測 = 表の図で 3 本とも段が変わるたびに伸び直した)。
+       *
+       * **隠さない図でも初出は数える**。 `all` は「最初から見せる」 だけの指定で、
+       * 伸びる動きまで毎段繰り返してよいという意味ではない。
+       */
+      \u4F38\u3070\u3059\u304B: (edgeId) => {
+        const first = \u521D\u51FA.get(edgeId);
+        if (first === void 0) return false;
+        return \u4ECA === first;
+      }
+    };
+  }, [laid.phases, currentPhase, laid.edgeReveal]);
   const drawSet = new Set(currentPhase?.draw ?? []);
   const \u63CF\u304F\u9032\u307F = \u63CF\u304F\u9032\u307F\u306B\u76F4\u3059(progress, currentPhase?.drawRatio);
   const { lifelineStarts, uniformFooterTop } = react.useMemo(() => {
@@ -28962,7 +29000,17 @@ function CdlStage({
             },
             lane.id
           )),
-          laid.edges.map((edge) => /* @__PURE__ */ jsxRuntime.jsx(CdlEdgeView, { edge, active: activeSet.has(edge.id), progress, stateValues }, edge.id)),
+          laid.edges.filter((edge) => \u77E2\u5370\u306E\u51FA\u756A.\u51FA\u308B\u304B(edge.id)).map((edge) => /* @__PURE__ */ jsxRuntime.jsx(
+            CdlEdgeView,
+            {
+              edge,
+              active: activeSet.has(edge.id),
+              drawing: \u77E2\u5370\u306E\u51FA\u756A.\u4F38\u3070\u3059\u304B(edge.id),
+              progress,
+              stateValues
+            },
+            edge.id
+          )),
           laid.nodes.map((node) => {
             const \u63CF\u304F = drawSet.has(node.id);
             const view = /* @__PURE__ */ jsxRuntime.jsx(
@@ -28978,8 +29026,8 @@ function CdlStage({
             );
             return /* @__PURE__ */ jsxRuntime.jsx("g", { children: view }, node.id);
           }),
-          laid.edges.filter((edge) => Boolean(edge.dThrough)).map((edge) => /* @__PURE__ */ jsxRuntime.jsx(CdlEdgeGlowView, { edge, active: activeSet.has(edge.id) }, `glow-${edge.id}`)),
-          laid.edges.map((edge) => /* @__PURE__ */ jsxRuntime.jsx(
+          laid.edges.filter((edge) => Boolean(edge.dThrough) && \u77E2\u5370\u306E\u51FA\u756A.\u51FA\u308B\u304B(edge.id)).map((edge) => /* @__PURE__ */ jsxRuntime.jsx(CdlEdgeGlowView, { edge, active: activeSet.has(edge.id) }, `glow-${edge.id}`)),
+          laid.edges.filter((edge) => \u77E2\u5370\u306E\u51FA\u756A.\u51FA\u308B\u304B(edge.id)).map((edge) => /* @__PURE__ */ jsxRuntime.jsx(
             CdlEdgeLabelView,
             {
               edge,
@@ -30565,6 +30613,8 @@ exports.EDGE_HEAD_DEFAULT = EDGE_HEAD_DEFAULT;
 exports.EDGE_HEAD_FILLS = EDGE_HEAD_FILLS;
 exports.EDGE_HEAD_FILL_DEFAULT = EDGE_HEAD_FILL_DEFAULT;
 exports.EDGE_LABEL_TEXT = EDGE_LABEL_TEXT;
+exports.EDGE_REVEALS = EDGE_REVEALS;
+exports.EDGE_REVEAL_DEFAULT = EDGE_REVEAL_DEFAULT;
 exports.EDGE_STUB_OUT = EDGE_STUB_OUT;
 exports.EDGE_STYLES = EDGE_STYLES;
 exports.ER_CARDINALITY_HEAD = ER_CARDINALITY_HEAD;