@cardenelabs/dragon 0.30.0 → 0.32.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cardenelabs/dragon",
-  "version": "0.30.0",
+  "version": "0.32.0",
   "description": "Dragon — Mermaid 感覚で animated SVG を生成する Text DSL。 cdl engine を内部利用。",
   "license": "MIT",
   "author": "cardene777",
@@ -46,18 +46,8 @@
     "node": ">=18"
   },
   "sideEffects": false,
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "typecheck:test": "tsc --noEmit -p tsconfig.test.json",
-    "test": "cd ../.. && vitest run packages/dragon",
-    "test:watch": "cd ../.. && vitest packages/dragon",
-    "lint": "tsc --noEmit",
-    "prepublishOnly": "pnpm run typecheck && pnpm run test && pnpm run build"
-  },
   "dependencies": {
-    "@cardenelabs/cdl": "^0.66.0"
+    "@cardenelabs/cdl": "^0.139.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -76,5 +66,14 @@
     "react": "^19.1.0",
     "tsup": "^8.5.1",
     "typescript": "^5.8.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "typecheck:test": "tsc --noEmit -p tsconfig.test.json",
+    "test": "cd ../.. && vitest run packages/dragon",
+    "test:watch": "cd ../.. && vitest packages/dragon",
+    "lint": "tsc --noEmit"
   }
-}
+}

package/src/compile/actor-ids.ts

@@ -79,7 +79,7 @@ function cdl側のslug(s: string): string {
  * |---|---|
  * | `sequence` / `solidity` | 枠 `actor-0` (cdl の `sequence()`) |
  * | `swimlane` | 枠 `lane-0` (cdl の `swimlane()`) |
- * | 残る 6 図種 | 箱 `n` (dragon 側の逃げ先。 cdl の逃げ道を通らない) |
+ * | 残る 5 図種 | 箱 `n` (dragon 側の逃げ先。 cdl の逃げ道を通らない) |
  *
  * 空配列は「cdl の逃げ道を通らない」 を表す。 1 箱で描く図種はここに来ない (作り替え自体を
  * しない) が、 図種を足した時に決め忘れないよう全種を並べる。
@@ -89,25 +89,16 @@ function cdl側のslug(s: string): string {
  */
 const 空の形の逃げ先: Record<PresetType, string[]> = {
   sequence: ["actor-"],
-  solidity: ["actor-"],
   swimlane: ["lane-"],
+  // 分かれ道の図も縦列を持ち、 描画側は縦列の名前から箱を作る (`swimlane` と同じ逃げ先)
+  flowchart: ["lane-"],
   flow: [],
-  er: [],
-  state: [],
+  record: [],
   topology: [],
-  class: [],
   c4: [],
   // 図全体を 1 箱で描く群 (作り替えないのでここは使わない)
   gantt: [],
-  pie: [],
-  bar: [],
-  line: [],
-  gauge: [],
-  radial: [],
-  stat: [],
-  waffle: [],
-  stacked: [],
-  slope: [],
+  chart: [],
   funnel: [],
   tree: [],
   journey: [],
@@ -241,7 +232,7 @@ export function disambiguateActorIds(
           : { ...event, target: { ...target, from, to } };
       }
       // sequence 系の縦列は登場人物から作るため、同じ名前の読み替えが必要。
-      if (target.kind === "lane" && (doc.type === "sequence" || doc.type === "solidity")) {
+      if (target.kind === "lane" && doc.type === "sequence") {
         const name = 直す(target.name);
         return name === target.name ? event : { ...event, target: { ...target, name } };
       }

package/src/compile/actor-option-notice.ts

@@ -0,0 +1,379 @@
+/**
+ * 箱に書いた指定が効かない時の、伝える欄の割り出しと呼び名 (#2368 で 1 箇所にまとめた)。
+ *
+ * 同じ判定を図種の族ごとの経路が使う (経路の数は下の表ではなく実装が SSOT)。
+ *
+ * | 経路 | 図種 | 起点 |
+ * |---|---|---|
+ * | 板の面 | `sequence` / `solidity` | #2358 |
+ * | 木の図 | `tree` | #2360 |
+ * | 値の図とじょうご | `pie` ほか 9 図種 + `funnel` | #2368 |
+ * | ガントチャートと体験の地図と四象限 | `gantt` / `journey` / `quadrant` | #2370 |
+ * | 骨組みの図 | `flow` / `flowchart` / `swimlane` / `topology` / `c4` / `record` | #2376 / #2382 / #2782 |
+ *
+ * 矢印の側は `edge-option-notice.ts` が同じ形を持つ (#2366)。
+ */
+import type { DslActor } from "../types";
+import type { DslDiagramShape } from "../keywords";
+
+/**
+ * 効かない箱の欄の呼び名 (#2358)。 **並べた順に知らせへ出す**。
+ *
+ * 呼び名を持たない欄は名前をそのまま出すので、ここに足し忘れても知らせは消えない。
+ * 複数の欄が 1 つの呼び名を持つ形 (位置が 4 欄) は、1 度だけ出す。
+ *
+ * **図種をまたいで 1 つの表にする** (#2360)。 同じ欄を図種ごとに別の文言で呼ぶと、
+ * 図種を変えた読み手が同じ指定だと気付けない。 どの欄を伝えるかは図種ごとの除外が決める。
+ *
+ * **箱に無い欄名を書けないようにする** (#2384)。 表と除外は箱の欄と文字で突き合わせるので、
+ * 綴りが箱と違う行は静かに何とも一致しない。 実測 = 記法の `色:` に引きずられて書いた
+ * `color` が、箱に生まれない欄名のまま残っていた (箱に入るのは `colorHex` か `tone`)。
+ */
+export const 効かない箱の欄の呼び名 = [
+  ["kind", "種類"],
+  // 呼び名 (#2390)。 板 / 木 / 骨組みの図は箱に描くので、伝えるのは値として読む図だけ
+  ["subtitle", "呼び名"],
+  ["posW", "大きさ"],
+  ["posH", "大きさ"],
+  ["posX", "位置"],
+  ["posY", "位置"],
+  ["posRel", "位置"],
+  // 位置のずらし (#1971)。 板は面ごとの箱を持たないので動かす相手が無い
+  ["layoutPos", "位置"],
+  ["rows", "行"],
+  ["tone", "色"],
+  ["colorHex", "色"],
+  ["eyebrow", "小見出し"],
+  ["value", "値"],
+  ["shape", "図形"],
+  ["previous", "前の値"],
+  ["marks", "印"],
+  ["stack", "段"],
+  ["initial", "始まりの印"],
+  ["final", "終わりの印"],
+  ["visibleIf", "出す条件"],
+  ["opacity", "透け具合"],
+  ["wBind", "値への追随"],
+  ["hBind", "値への追随"],
+  ["renderOffsetX", "値への追随"],
+  ["renderOffsetY", "値への追随"],
+  ["owner", "担当"],
+  ["stage", "段階"],
+  ["end", "終わる時期"],
+  ["startLabel", "始まりの札"],
+  ["milestone", "節目"],
+  ["emphasis", "主役"],
+  ["at", "点の位置"],
+  ["atPos", "点の位置"],
+  ["touchpoint", "接点"],
+  ["opportunity", "伸びしろ"],
+  ["opportunityPosition", "伸びしろの位置"],
+] as const satisfies readonly (readonly [keyof DslActor, string])[];
+
+/**
+ * 体験と工程の欄 (#2380)。 **どの族の除外にも入る**。
+ *
+ * 担当 (`owner`) と終わる時期 (`end`) はガントチャートが、接点 (`touchpoint`) と伸びしろ
+ * (`opportunity`) と伸びしろの位置 (`opportunityPosition`) は体験の地図が描く。 描けない図種で書いた時は
+ * `reportChartFieldsNotHonored` が図種ごとの行き先を添えて伝える。
+ *
+ * 箱の知らせが同じ欄を重ねて伝えると、1 つの欄が 2 つの名前で呼ばれる (「担当」 と `owner`)
+ * うえ、案内が食い違う = 箱の知らせは「箱を持つ図種へ」 と言うが、担当は箱を持つ図種でも
+ * 効かない。
+ *
+ * **1 か所に置いて各族が読む**。 欄を族ごとに書き並べると、新しい欄を足した日に
+ * 直し忘れた族だけが 2 件並べるようになる (実測 = 板の族だけが 4 欄を持たず、
+ * `sequence` / `solidity` の 8 通りで知らせが 2 件並んでいた)。
+ */
+export const 体験と工程の欄: ReadonlySet<string> = new Set([
+  "owner",
+  "end",
+  "startLabel",
+  "milestone",
+  "emphasis",
+  "touchpoint",
+  "opportunity",
+  "opportunityPosition",
+]);
+
+/**
+ * 板の面で、効かないと伝えない箱の欄 (#2358)。
+ *
+ * **除外側を書く**。 効かない欄を並べる形にすると、箱に欄を足した日にその欄だけが
+ * 一覧から漏れ、書いた人には「書いたのに何も起きない」 としか見えない。
+ *
+ * | 区分 | 欄 |
+ * |---|---|
+ * | 板が描く | 名前 / 題 / 呼び名 と、書いた場所と種類を書いたかの印 |
+ * | 別の知らせが受け持つ | 縦列 (`reportLaneNotHonored`) / 体験と工程の 4 欄 (#2380) |
+ *
+ * 種類 (`kind`) は図種で分かれるので、判定の側で足す。
+ */
+export const 板が伝えない箱の欄: ReadonlySet<string> = new Set([
+  "name",
+  "title",
+  "subtitle",
+  "pos",
+  "kindWritten",
+  "lane",
+  ...体験と工程の欄,
+]);
+
+/**
+ * 木の図で、効かないと伝えない箱の欄 (#2360)。
+ *
+ * | 区分 | 欄 |
+ * |---|---|
+ * | 木の図が描く | 名前 / 題 / 呼び名 / 値 と、書いた場所と種類を書いたかの印 |
+ * | 別の知らせが受け持つ | 縦列 / 位置のずらし / 体験と工程の 4 欄 |
+ *
+ * 別の知らせは順に `lane-not-honored` / `position-offset-ignored` / `chart-value-unreadable`。
+ * 除かないと同じ箱に 2 件並ぶ。 体験と工程の 4 欄は `体験と工程の欄` から読む (#2380)。
+ */
+export const 木の図が伝えない箱の欄: ReadonlySet<string> = new Set([
+  "name",
+  "title",
+  "subtitle",
+  "value",
+  "pos",
+  "kindWritten",
+  "lane",
+  "layoutPos",
+  ...体験と工程の欄,
+]);
+
+/**
+ * 箱を名前と値の組として読む図で、どの図種でも効かないと伝えない箱の欄 (#2368 / #2370)。
+ *
+ * | 区分 | 欄 |
+ * |---|---|
+ * | どの図種も読む | 名前 / 題 / 値 と、書いた場所と種類を書いたかの印 |
+ * | 別の知らせが受け持つ | 縦列 / 位置のずらし / 体験と工程の 4 欄 |
+ *
+ * 呼び名 (`subtitle`) は除かない (#2390)。 値を書いていない箱で **値として読まれる**
+ * (`a.value ?? a.subtitle`) ので除いていたが、**値を書いた箱では読む先が無い**。
+ * 除いた結果、値と呼び名を両方書いた箱では誰も伝えず、13 図種で黙って消えていた。
+ * 値を書いていない箱で鳴らさない判定は呼び元が持つ = 箱 1 つごとに決まる条件なので、
+ * 図種ごとの除外では表せない (#2384 の色番号と同じ形)。
+ *
+ * 位置 (`posX` / `posY`) は除かない = この図種では両方書いても効かないため、
+ * 片方だけの知らせ (#2362) ではなくこちらが伝える。
+ *
+ * 記法の `offsetX` / `offsetY` は `layoutPos` に入る (`position-offset-ignored` が受け持つ)。
+ * 欄の名前で判定するので、記法の項目名ではなく入った先の欄を書く。
+ *
+ * 体験と工程の欄 (`体験と工程の欄`) は、読む図種と別の知らせが受け持つ図種に分かれる。
+ * どちらも伝えないので 1 つにまとめて除く。
+ */
+const 値として読む図に共通の除外: ReadonlySet<string> = new Set([
+  "name",
+  "title",
+  "value",
+  "pos",
+  "kindWritten",
+  "lane",
+  "layoutPos",
+  ...体験と工程の欄,
+]);
+
+/**
+ * 箱を名前と値の組として読む図種と、共通に加えて読む欄 (#2368 / #2370)。
+ *
+ * **表で持つ**。 図種ごとに除外の集合を丸ごと書くと、共通部分が図種の数だけ写され、
+ * 1 つ直した日に他が古いまま残る (実測 = 値の図とじょうごで 2 つに分かれていた)。
+ *
+ * | 図種 | 共通に加えて読む欄 |
+ * |---|---|
+ * | 数を描く図 (`chart`) | 色味 (`tone`) / 前の値 (`previous`) |
+ * | じょうご | 色味 (`tone`) |
+ * | 体験の地図 / 四象限 | 無し (名前と値だけを読む) |
+ * | ガントチャート | 色味 (`tone`)。 担当と終わる時期は共通の除外に入っている |
+ */
+export const 値として読む図種: ReadonlyMap<string, readonly string[]> = new Map([
+  ["chart", ["tone", "previous"]],
+  ["funnel", ["tone"]],
+  ["gantt", ["tone"]],
+  ["journey", []],
+  ["quadrant", ["at", "atPos"]],
+]);
+
+/**
+ * 件ごとの主役 (`emphasis`) を実際に描く値の図。
+ *
+ * `chart` という node の種類だけでは円・折れ線なども混ざるため、`chart/stacked` まで
+ * 形を含めて区別する。じょうごは形を持たず、段の `emphasis` を読む。
+ */
+const 主役を読む値の図: ReadonlySet<string> = new Set(["chart/stacked", "funnel"]);
+
+/** 件ごとの `emphasis` がその図で描かれるか */
+export function 値として読む図が主役を読む(図種: string, 形?: DslDiagramShape): boolean {
+  return 主役を読む値の図.has(形 === undefined ? 図種 : `${図種}/${形}`);
+}
+
+/**
+ * その図種で、効かないと伝えない箱の欄を返す (#2370)。
+ *
+ * @param 図種 `値として読む図種` に載っている図種
+ * @returns 共通の除外に、その図種が読む欄を足した集合
+ */
+export function 値として読む図が伝えない箱の欄(図種: string): ReadonlySet<string> {
+  const 読む欄 = 値として読む図種.get(図種) ?? [];
+  if (読む欄.length === 0) return 値として読む図に共通の除外;
+  return new Set([...値として読む図に共通の除外, ...読む欄]);
+}
+
+/**
+ * 箱を並べて線で繋ぐ図 (骨組みの図) で、どの図種でも効かないと伝えない箱の欄 (#2376)。
+ *
+ * | 区分 | 欄 |
+ * |---|---|
+ * | 骨組みの図が描く | 名前 / 題 / 呼び名 / 小見出し / 値 / 行 / 色味 / 図形 / 種類 / 段 / 透け具合 / 出す条件 |
+ * | 位置と大きさ | `posX` / `posY` / `posW` / `posH` / `posRel` / `layoutPos` |
+ * | 値への追随 | `wBind` / `hBind` / `renderOffsetX` / `renderOffsetY` |
+ * | 別の知らせが受け持つ | 縦列 / 体験と工程の 4 欄 |
+ *
+ * 色番号 (`colorHex`) は除かない (#2384)。 部品を置いた箱でだけ効く欄なので
+ * 「部品の側が伝えるから重ねない」 として除いていたが、**呼び元が部品を置いた箱を
+ * 判定の入口で飛ばす** (`a.partId !== undefined`) ため重なりようがなかった。
+ * 除いた結果、部品でない箱では誰も伝えず、7 図種で黙って消えていた。
+ *
+ * 記法の `色:` は 16 進数なら `colorHex` に、色の名前なら `tone` に入る。
+ * 名前で書いた形は箱の色として効くので、伝えるのは 16 進数で書いた形だけになる。
+ *
+ * 印 (`marks`) は除かない (#2377)。 行頭の記号に読み替えるのは ER 図と状態遷移図だけ
+ * (`行頭の印にする`) で、骨組みの残りの図種では行と組にしても効かない。
+ * 効く図種で鳴らさない判定は呼び元が持つ = 図種の一覧をここに写すと、印を読む図種を
+ * 足した日に古くなる。
+ *
+ * 残るのは始まりの印 / 終わりの印 / 印 / 前の値の 4 つ。
+ * 実測 = フロー 447 枚 ・ 泳路の図 35 枚 ・ 配置の図 8 枚の見本すべてで、この 4 件が
+ * 図も変えず知らせも出さなかった。
+ *
+ * **図種ごとの違いは `骨組みの図種` が持つ** (#2382)。 状態遷移図は始まりの印と終わりの印を
+ * 読むので、その 2 欄だけ除外に足す。
+ */
+const 骨組みの図に共通の除外: ReadonlySet<string> = new Set([
+  "name",
+  "title",
+  "subtitle",
+  "pos",
+  "kindWritten",
+  "value",
+  "eyebrow",
+  "tone",
+  "rows",
+  // cdl 0.129.0-0.136.0 の表箱・部品箱の欄。 applyV05Extensions が node へ渡し、
+  // 描き手が箱の種類に応じて題・罫線・印・入れ子・線画・足として読む (#2854)。
+  "kindForm",
+  "icon",
+  "emptyRowsNote",
+  "titleAlign",
+  "rowRules",
+  "rowStripe",
+  "rowLayout",
+  "rowDividerForm",
+  "rowWell",
+  "rowMarkForm",
+  "nestIn",
+  "figureCard",
+  "shape",
+  "kind",
+  "stack",
+  "opacity",
+  "visibleIf",
+  "posX",
+  "posY",
+  "posW",
+  "posH",
+  "posRel",
+  "layoutPos",
+  "wBind",
+  "hBind",
+  "renderOffsetX",
+  "renderOffsetY",
+  "lane",
+  ...体験と工程の欄,
+]);
+
+/**
+ * 図種ごとの、共通の除外との違い (#2382)。
+ *
+ * **両方向に持つ**。 共通の除外は「どの骨組みの図も読む欄」 を集めたものなので、
+ * 図種ごとの違いは 2 通り出る。 外す側だけだと、1 つの図種だけが読む欄を持つ図種を
+ * 族に入れられない (実測 = 状態遷移図が始まりの印を読むため、族の外に置かれていた)。
+ */
+export type 骨組みの図の違い = {
+  /** その図種だけが読まない欄。 共通の除外から外して、伝える側へ回す */
+  readonly 読まない?: readonly string[];
+  /** その図種だけが読む欄。 共通の除外に足して、伝えない側へ回す */
+  readonly 読む?: readonly string[];
+};
+
+/**
+ * 箱を並べて線で繋ぐ図種と、共通の除外との違い (#2376 / #2382)。
+ *
+ * | 図種 | 違い | 理由 |
+ * |---|---|---|
+ * | フロー / 泳路の図 / 配置の図 | 無し | `compile/generic.ts` が共通の経路で箱を作る |
+ * | 分かれ道の図 (`flowchart`) | 無し | 種類は専用の形または箱の見た目として読む |
+ * | 構成の図 (`c4`) | 段 (`stack`) を読まない | `compile/c4.ts` が `a.stack` を読まない |
+ * | 行を持つ図 (`record`) | 始まりの印と終わりの印を読む | `compile/generic.ts` の札がこの図種でだけ出る |
+ */
+export const 骨組みの図種: ReadonlyMap<string, 骨組みの図の違い> = new Map([
+  ["flow", {}],
+  ["flowchart", {}],
+  ["swimlane", {}],
+  ["topology", {}],
+  ["c4", { 読まない: ["stack"] }],
+  ["record", { 読む: ["initial", "final"] }],
+]);
+
+/**
+ * その図種で、効かないと伝えない箱の欄を返す (#2376 / #2382)。
+ *
+ * @param 図種 `骨組みの図種` に載っている図種
+ * @returns 共通の除外から読まない欄を抜き、読む欄を足した集合
+ */
+export function 骨組みの図が伝えない箱の欄(図種: string): ReadonlySet<string> {
+  const 違い = 骨組みの図種.get(図種) ?? {};
+  const 読まない欄 = 違い.読まない ?? [];
+  const 読む欄 = 違い.読む ?? [];
+  if (読まない欄.length === 0 && 読む欄.length === 0) return 骨組みの図に共通の除外;
+  const 残り = new Set(骨組みの図に共通の除外);
+  for (const 欄 of 読まない欄) 残り.delete(欄);
+  for (const 欄 of 読む欄) 残り.add(欄);
+  return 残り;
+}
+
+/**
+ * 箱に書いた欄のうち、効かないものの呼び名を並べる (#2368)。
+ *
+ * **伝える欄を並べず、読む欄を除いた残り全部を返す**。 効かない欄を並べる形にすると、
+ * 箱に欄を足した日にその欄だけが一覧から漏れ、書いた人には「書いたのに何も起きない」
+ * としか見えない。 除外側を書けば、足し忘れは「余計に知らせる」 側へ倒れる。
+ *
+ * @param 箱 記法から読んだ箱 1 つ
+ * @param 伝えない欄 その図種が読む欄と、別の知らせが受け持つ欄
+ * @param 判定で外す欄 図種の中でさらに外す欄 (種類が図種で分かれる形、#2358)
+ * @returns 知らせに出す呼び名。 空なら伝えるものが無い
+ */
+export function 効かない箱の欄を並べる(
+  箱: object,
+  伝えない欄: ReadonlySet<string>,
+  判定で外す欄: readonly string[] = [],
+): string[] {
+  const 残り = new Set(
+    Object.entries(箱 as Record<string, unknown>)
+      .filter(([欄, 値]) => 値 !== undefined && !伝えない欄.has(欄))
+      .map(([欄]) => 欄),
+  );
+  for (const 欄 of 判定で外す欄) 残り.delete(欄);
+  const 効かない: string[] = [];
+  for (const [欄, 呼び名] of 効かない箱の欄の呼び名) {
+    if (!残り.delete(欄)) continue;
+    if (!効かない.includes(呼び名)) 効かない.push(呼び名);
+  }
+  // 呼び名を持たない欄は名前をそのまま出す = 読みにくい名前でも、黙って落とすよりは伝わる
+  効かない.push(...[...残り].sort());
+  return 効かない;
+}

package/src/compile/actors.ts

@@ -59,16 +59,45 @@ export function canonicalizeFlowActors(doc: DslDocument): DslDocument {
  *
  * 1 つも書いていなければ従来どおり位置で決める = 書かない記法の図は変わらない。
  * 片方だけ書いた形も、書いた側だけが切り替わる。
+ *
+ * ## 打ち消し (`initial: false`) は書いた箱にだけ効く (#2418)
+ *
+ * 書いたかどうかを `true` だけで数えていた間、`false` しか書かれていない図は
+ * 「1 つも書いていない」 扱いになって位置で決める既定へ落ちていた。 その既定は
+ * 「1 番目の箱が始まり」 なので、**打ち消しを書いた当の箱に札が出ていた** (知らせも 0 件)。
+ *
+ * 位置で決める既定から、打ち消しを書いた箱だけを外す。
+ *
+ * **「どれか 1 つでも書いたら既定を捨てる」 形にはしない** = 途中の箱に書いた
+ * `initial: false` が 1 番目の箱の札まで消す。 書き手は途中の箱のことしか言っていない。
  */
-export function 始まりと終わりの決め方(doc: DslDocument): {
+export function 始まりと終わりの決め方(
+  doc: DslDocument,
+  /**
+   * 並びで決める既定を使うか (#2349)。
+   *
+   * **格子に置く形では並びが始まりと終わりを意味しない**。 縦列と段を書いた図は
+   * 書いた順に左から並ぶわけではないので、「最初に書いた箱」 を初期とみなす既定は
+   * 図の見た目と合わない (実測 = 印の箱を持つ見本で、既に形が始点を示している箱へ
+   * 「初期」 の字が重ねて出た)。 書いた値はどの並べ方でも効く。
+   */
+  opts: { 並びで決める?: boolean } = {},
+): {
   始まり: (a: DslActor, idx: number) => boolean;
   終わり: (a: DslActor, idx: number) => boolean;
 } {
+  const 並びで決める = opts.並びで決める ?? true;
   const 書いた始まり = doc.actors.some((a) => a.initial === true);
   const 書いた終わり = doc.actors.some((a) => a.final === true);
   return {
-    始まり: (a, idx) => (書いた始まり ? a.initial === true : idx === 0),
+    始まり: (a, idx) =>
+      書いた始まり ? a.initial === true : 並びで決める && idx === 0 && a.initial !== false,
     終わり: (a, idx) =>
-      書いた終わり ? a.final === true : idx === doc.actors.length - 1 && doc.actors.length > 1,
+      書いた終わり
+        ? a.final === true
+        : 並びで決める &&
+          idx === doc.actors.length - 1 &&
+          doc.actors.length > 1 &&
+          a.final !== false,
   };
 }

package/src/compile/c4.ts

@@ -67,9 +67,6 @@ export function compileC4(doc: DslDocument): CdlDiagram {
       label: s.label,
       ...(s.sub ? { sub: s.sub } : {}),
       ...(s.side ? { side: s.side } : {}),
-
-      ...(s.tone ? { tone: s.tone } : {}),
-      ...(s.style ? { style: s.style } : {}),
     });
   }
 

package/src/compile/chain.ts

@@ -19,13 +19,52 @@ import { lookupPartRaw } from "./parts-lookup";
  */
 export function 鎖でつなぐ形か(doc: DslDocument): boolean {
   if (doc.type !== "flow") return false;
-  if (doc.animate && doc.animate.phases.length > 0) return false;
-  if (doc.direction !== undefined) return false;
-  return !書いた縦列に置く("flow", doc);
+  return !鎖にしない書き方.some((x) => x.あてはまる(doc));
 }
 
 /**
- * 静止した流れ図の鎖に並べる登場人物 (#1987)。
+ * 鎖をやめて、書いた端どおりに繋ぐ書き方 (#2374)。
+ *
+ * **判定と案内を組にして持つ**。 以前は判定が 3 つの条件を見るのに、知らせの案内は
+ * 手で並べた 2 つだった (実測 = 動きを書く経路が案内に無く、読み手はその道を知れなかった)。
+ *
+ * 表から判定を導き、案内も同じ表から作る。 条件を足した日に案内が自動で追随する。
+ *
+ * どれも図の見た目を変えるので、**優先順位は付けない**。 向きを書けば並びが変わり、
+ * 縦列を書けば列ができ、動きを書けば段が付く。 どれを選ぶかは書き手が決める。
+ */
+export const 鎖にしない書き方: readonly {
+  /** 検査と読み手のための短い呼び名 */
+  名: string;
+  /** その書き方をしているか */
+  あてはまる: (doc: DslDocument) => boolean;
+  /** 知らせの案内に出す文 */
+  案内: string;
+}[] = [
+  {
+    名: "動き",
+    あてはまる: (doc) => doc.animate !== undefined && doc.animate.phases.length > 0,
+    案内: "動き (animation:) を書く",
+  },
+  {
+    名: "向き",
+    あてはまる: (doc) => doc.direction !== undefined,
+    案内: "向き (direction: 縦) を書く",
+  },
+  {
+    名: "縦列",
+    あてはまる: (doc) => 書いた縦列に置く("flow", doc),
+    案内: "箱に縦列 (lane:) を書く",
+  },
+];
+
+/** 知らせの案内に出す、鎖をやめる書き方の並び (#2374) */
+export function 鎖にしない書き方の案内(): string {
+  return 鎖にしない書き方.map((x) => x.案内).join(" / ");
+}
+
+/**
+ * 静止したフローの鎖に並べる登場人物 (#1987)。
  *
  * **どの行にも書かれていない部品は鎖に並べない**。 並べると、部品の前後の並び順の矢印は書き手が
  * 部品へ引いたものではないため部品へ繋がずに外され (#1979)、部品を途中に置いた図から矢印が全て

package/src/compile/chart-fields.ts

@@ -78,12 +78,27 @@ export function 参照する名前(value: number | string | null): string | null
  */
 export const 図表の大きさ = {
   funnel: { w: 560, h: 480 },
-  tree: { w: 720, h: 480 },
+  // 木は幅を持たない (cdl#970)。 必要な幅は葉の数で変わるので、描画側の `木の札の幅` が出す。
+  // 値を残すと、描画側が割付を変えた時にここだけが古い幅を持つ
+  tree: { h: 480 },
   mind: { w: 720, h: 480 },
   journey: { w: 720, h: 480 },
   quadrant: { w: 640, h: 480 },
 } as const;
 
+/**
+ * 記法に札の寸法があればそれを使い、無ければ図種ごとの既定をそのまま返す (#2854 C13)。
+ * `図表の大きさ` 自体は変更しない。欄を書かない既存の図が byte-level で同じ寸法を保つため。
+ */
+export function 図表の大きさを読む(
+  doc: DslDocument,
+  fallback: { w: number; h: number },
+): { w: number; h: number } {
+  return doc.figureSize === undefined
+    ? fallback
+    : { w: doc.figureSize.width, h: doc.figureSize.height };
+}
+
 /**
  * 図表の欄が `{名前}` で読む値を、**1 か所で** 確かめる (#1200)。
  *