@cardenelabs/dragon 0.34.0 → 0.35.1

package/src/compile/actors.ts

@@ -1,103 +0,0 @@
-import type { DslActor, DslDocument } from "../types";
-import { slugify } from "./slug";
-/**
- * 登場人物の参照表と、並びの整え (#2030 で `compile.ts` から移した)。
- */
-
-/**
- * 矢印の指す先を `actors` に書いた **正規の名前** へ解決する表 (#1209)。
- *
- * 名前そのものに加えて **一意な slug も受ける**。 動きを書いた図の組み立ては `slugify` に
- * 落として引くため、 `API Gateway` を `api-gateway` と書いた形が届く。 2 つ以上の名前が
- * 同じ slug になる時は受けない = どちらを指したか決められない。
- *
- * **返すのは正規の名前で、 slug ではない**。 slug を返すと、 動きを書いていない図の組み立て
- * (名前の完全一致で引く) と食い違う = 知らせは出ないのに label が消える / 題が slug に化ける /
- * 依存が切れる、 という形になる (Round 1 で実測)。 中央で名前へ揃えれば全経路が同じ相手を指す。
- */
-export function actorRefTable(doc: DslDocument): Map<string, string> {
-  const 表 = new Map<string, string>();
-  const slug数 = new Map<string, number>();
-  for (const a of doc.actors) {
-    const sl = slugify(a.name);
-    slug数.set(sl, (slug数.get(sl) ?? 0) + 1);
-  }
-  for (const a of doc.actors) {
-    表.set(a.name, a.name);
-    const sl = slugify(a.name);
-    if ((slug数.get(sl) ?? 0) === 1) 表.set(sl, a.name);
-  }
-  return 表;
-}
-
-/**
- * 矢印の指す先を正規の名前へ揃えた `flow` を返す (#1209)。
- *
- * 解決できない矢印はそのまま残す = 図種ごとに扱いが違う (木は独自の知らせを出し、 値で描く図は
- * 落とす)。 中央で消すとその扱いが効かなくなる。 残した分は `reportMissingFlowActors` が
- * 知らせ、 動きを書いた図の組み立てが落とす。
- */
-export function canonicalizeFlowActors(doc: DslDocument): DslDocument {
-  const 表 = actorRefTable(doc);
-  let 変えた = false;
-  const flow = doc.flow.map((s) => {
-    const from = 表.get(s.from) ?? s.from;
-    const to = 表.get(s.to) ?? s.to;
-    if (from === s.from && to === s.to) return s;
-    変えた = true;
-    return { ...s, from, to };
-  });
-  return 変えた ? { ...doc, flow } : doc;
-}
-
-/**
- * 状態遷移図で、どの箱を始まり / 終わりとみなすか (#1275)。
- *
- * **書いた値が勝つ**。 `initial:` / `final:` は記法で書けるのに 1 度も読まれておらず、
- * 位置だけで決まっていた (実測 = 中央の箱に `final: true` を書いても、最後に書いた箱が
- * 「最終」 になった)。
- *
- * 1 つも書いていなければ従来どおり位置で決める = 書かない記法の図は変わらない。
- * 片方だけ書いた形も、書いた側だけが切り替わる。
- *
- * ## 打ち消し (`initial: false`) は書いた箱にだけ効く (#2418)
- *
- * 書いたかどうかを `true` だけで数えていた間、`false` しか書かれていない図は
- * 「1 つも書いていない」 扱いになって位置で決める既定へ落ちていた。 その既定は
- * 「1 番目の箱が始まり」 なので、**打ち消しを書いた当の箱に札が出ていた** (知らせも 0 件)。
- *
- * 位置で決める既定から、打ち消しを書いた箱だけを外す。
- *
- * **「どれか 1 つでも書いたら既定を捨てる」 形にはしない** = 途中の箱に書いた
- * `initial: false` が 1 番目の箱の札まで消す。 書き手は途中の箱のことしか言っていない。
- */
-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.initial !== false,
-    終わり: (a, idx) =>
-      書いた終わり
-        ? a.final === true
-        : 並びで決める &&
-          idx === doc.actors.length - 1 &&
-          doc.actors.length > 1 &&
-          a.final !== false,
-  };
-}

package/src/compile/c4.ts

@@ -1,74 +0,0 @@
-import { diagram } from "@cardenelabs/cdl";
-import type { CdlDiagram } from "@cardenelabs/cdl";
-import type { DslDocument } from "../types";
-import { 描ける種別 } from "./kinds";
-import { 段を読み取る } from "./rows";
-import { slugify } from "./slug";
-/**
- * C4 preset (C4 model 階層 system context 専用 layout)
- *
- * 設計 ... actor.subtitle の先頭に "L1" / "L2" / "L3" を置き、 階層 lane を生成。
- * - L1 = 全体の見取り図 (C4 model の System Context)
- * - L2 = 動かす単位 (同 Container = 単体で動かす application や保管庫)
- * - L3 = 部品 (同 Component)
- *
- * 実装 ... **中身のある段だけ** lane を作り、 使う段を左から順に詰めて横並び (contain: true で
- * 囲む) 配置する。 3 lane を常に作ると中身のない枠が画面に残り、 描かれ損ねたように見える (#1078)。
- * 同 lane 内の actor は内部 stack で縦並びになる (横並びは layout 制約上不可、
- * 段の区別が視覚的に最重要)。 subtitle marker 未指定なら L1 fallback。
- *
- * flow ... actor 間の関係を edge で表現。
- */
-export function compileC4(doc: DslDocument): CdlDiagram {
-  const b = diagram(slugify(doc.title), { topic: doc.title, type: "infrastructure" });
-  const LANE_W = 400;
-  const LANE_GAP = 80;
-  // 段の名前は **枠に描く字** で、記法に打ち込む識別子ではない (#1886)。 打ち込む字は目印
-  // (`L1` / `L2` / `L3`) の側で、そちらは綴りを変えない
-  const 段の名前: Record<number, string> = { 1: "全体の見取り図", 2: "動かす単位", 3: "部品" };
-
-  // 段は **先頭一致** で読み、 読んだ目印は説明から落とす (`段を読み取る` の説明を参照)
-  const 割当 = doc.actors.map((a, idx) => {
-    const { 段, 説明 } = 段を読み取る(a.subtitle);
-    return { 段, 説明, id: slugify(a.name) || `n${idx}`, actor: a };
-  });
-
-  // **中身のある段だけ枠を作る**。 3 段を必ず作ると、 書いていない段が空の点線枠として残り、
-  // 見た人には「何かが描かれ損ねた」 ようにしか見えない
-  const 使う段 = [1, 2, 3].filter((lv) => 割当.some((x) => x.段 === lv));
-  使う段.forEach((lv, i) => {
-    b.lane(`c4-l${lv}`, {
-      // 空の段を飛ばした分だけ左に詰める。 飛ばした位置に隙間を残すと、 やはり
-      // 「何かが抜けている」 ように見える
-      x: i * (LANE_W + LANE_GAP),
-      width: LANE_W,
-      label: 段の名前[lv]!,
-      contain: true,
-    });
-  });
-
-  const stackPerLane: Record<string, number> = { "c4-l1": 0, "c4-l2": 0, "c4-l3": 0 };
-  for (const x of 割当) {
-    const lid = `c4-l${x.段}`;
-    const stack = stackPerLane[lid]!;
-    stackPerLane[lid] = stack + 1;
-    b.node(x.id, {
-      lane: lid,
-      stack,
-      kind: 描ける種別(x.actor.kind),
-      title: x.actor.name,
-    });
-  }
-
-  for (const s of doc.flow) {
-    const fromId = slugify(s.from);
-    const toId = slugify(s.to);
-    b.edge(fromId, toId, {
-      label: s.label,
-      ...(s.sub ? { sub: s.sub } : {}),
-      ...(s.side ? { side: s.side } : {}),
-    });
-  }
-
-  return b.build();
-}

package/src/compile/chain.ts

@@ -1,93 +0,0 @@
-import type { CdlDiagram } from "@cardenelabs/cdl";
-import type { DslActor, DslDocument } from "../types";
-import { 書いた縦列に置く } from "./lanes";
-import { lookupPartRaw } from "./parts-lookup";
-/**
- * 箱を鎖のように 1 本につなぐ形か (#2030 で `compile.ts` から移した)。
- *
- * 図種ごとの file と、`compile.ts` に残る部品の取り込みの両方が呼ぶ。
- */
-
-/**
- * 静止した `type: flow` かどうか。 この形だけ矢印を鎖状に作る (`compileFlow`)。
- *
- * 段を持つ形・縦列を書いた形・向きを書いた形は generic 経路へ回るため鎖にならない。
- *
- * **`compileFlow` の分岐もこの判定を使う**。 判定を 2 か所に書くと、組み立てだけが別経路へ回り、
- * 行の対応と端の知らせが鎖のまま残る。 向きを書いた形 (#1494) は組み立てにだけ足され、`A -> C` に
- * 書いた `head` が `C -> B` に載り、書いた端のとおりの矢印に「端は使われません」 が出ていた (#1986)。
- */
-export function 鎖でつなぐ形か(doc: DslDocument): boolean {
-  if (doc.type !== "flow") return false;
-  return !鎖にしない書き方.some((x) => x.あてはまる(doc));
-}
-
-/**
- * 鎖をやめて、書いた端どおりに繋ぐ書き方 (#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)、部品を途中に置いた図から矢印が全て
- * 消えていた (実測 = `受付 / 印 / 出荷` で矢印 0 本、知らせ 0 件)。 編集画面は部品を本文から抜いてから
- * 鎖を作るので `受付 -> 出荷` を描き、カタログと絵が食い違っていた。 部品は図の下の格子に置くため、
- * 鎖から外しても流れの列に空きは生まれない。
- *
- * - 部品の一覧に無い部品は仮の箱のまま描かれるので残す (一覧を渡さない組み立ても同じ)
- * - 大きすぎて取り込まない部品は一覧にあるので外す (図に入らない場所へ鎖を通さない)
- * - 行の端に書かれた部品は残し、#1979 の繋ぎ方に従う
- *
- * 鎖を作る `compileFlow`、行との対応 (`鎖のどの行から来たか`)、端の知らせ
- * (`reportFlowEndpointNotHonored`) の 3 つがこの並びを使う。 1 つでも `doc.actors` を見ると、
- * N 本目の矢印と行の対応がずれる。
- */
-export function 鎖に並べる登場人物(
-  doc: DslDocument,
-  partsCatalog: Record<string, CdlDiagram> | undefined,
-): DslActor[] {
-  if (!partsCatalog) return doc.actors;
-  const 行に書かれた = new Set(doc.flow.flatMap((s) => [s.from, s.to]));
-  // 部品でない箱は `partId` を持たず一覧を引けないので、一覧に無い部品と同じく残る
-  return doc.actors.filter(
-    (a) => 行に書かれた.has(a.name) || lookupPartRaw(partsCatalog, a.partId) === undefined,
-  );
-}

package/src/compile/chart-fields.ts

@@ -1,193 +0,0 @@
-import type { DslDocument } from "../types";
-/**
- * 図表の欄を読む小道具 (#2030 で `compile.ts` から移した)。
- *
- * 値の図 (`pie` / `bar` / `line` ほか 6 種) ・ 漏斗 ・ 道のり ・ 四象限 の 4 系統が使う。
- * 数と語の読み方を 1 箇所に置くのは、図種ごとに別の読み方をすると同じ本文が図種で
- * 別の値に化けるため。
- *
- * **葉に置く** = ここが `compile.ts` を取り込まないので、どちらから呼んでも輪にならない。
- */
-
-/**
- * 割合の書き方から数値を読む。 読めなければ `null`。
- *
- * 受けるのは `"45%"` / `"45"` / `"45.5%"` と、 前後の空白。 `"四割"` や `"0.45"` のような
- * 別の言い方は読まない = **黙って 0 にすると、 その分だけ欠けた円が「正しい図」 として出る**。
- * 読めなかったことは呼出側が警告に出す。
- */
-export function parseShareValue(raw: string | undefined): number | null {
-  if (raw === undefined) return null;
-  const m = raw.trim().match(/^(-?\d+(?:\.\d+)?)\s*%?$/);
-  if (m === null) return null;
-  const v = Number(m[1]);
-  return Number.isFinite(v) ? v : null;
-}
-
-/**
- * 状態を読む欄かどうか (`{名前}`)。
- *
- * **`{名前}` そのものだけを受ける**。 `{v} 件` のような混ざった形は、描画側が数として
- * 読めず既定値に落ちて印が付くだけになる (`render/payload-binding.ts` は解いた文字列を
- * そのまま数にする)。 書けたのに効かない形を作らない。
- *
- * `%` を付けた形も受けない。 同じ理由で `"45%"` は数に直せるが `"{v}%"` は直せない。
- *
- * 名前に使えるのは英数字と `_` で、読む側 (cdl の `interpolate`) と同じ範囲に合わせる。
- * 決まった accessor (`.sum` 等) は付けてよい。
- */
-export function parseBoundValue(raw: string | undefined): string | null {
-  if (raw === undefined) return null;
-  const t = raw.trim();
-  return /^\{\w+(?:\.(?:length|sum|max|min|avg)|\[\d+\])?\}$/.test(t) ? t : null;
-}
-
-/**
- * 図表の数の欄を読む。 数そのものか、状態を読む `{名前}` を返す。
- *
- * 数として解けない `{名前}` は、そのまま図表の中身に渡して描画側が段ごとに解く。
- * 受け取る側の型 (`BoundNumber`) は元から 2 通りを想定している = 入口だけが塞がっていた。
- */
-export function parseChartValue(raw: string | undefined): number | string | null {
-  const n = parseShareValue(raw);
-  if (n !== null) return n;
-  return parseBoundValue(raw);
-}
-
-/** 状態を読む欄が指している名前 (`{v.sum}` なら `v`)。 欄でなければ null */
-export function 参照する名前(value: number | string | null): string | null {
-  if (typeof value !== "string") return null;
-  const m = value.match(/^\{(\w+)/);
-  return m ? m[1]! : null;
-}
-
-/**
- * 図表の箱の大きさ (#1260)。
- *
- * **組立て API と同じ値を使う**。 別の値にすると、同じ内容を書いても描いた図の大きさが変わる
- * (実測 = 記法の `funnel` は 640x368、組立て API は 560x480 で、描いた図の viewBox が
- * 785x488 対 712x600 になっていた)。
- *
- * 組立て API 側は中身の件数で変えない (実測 = 2 / 4 / 8 件のどれでも同じ値)。 そのため
- * こちらも定数で持つ。 `gantt` だけは件数で高さを変える = 8 件目から最後の帯が枠の外に
- * 出るため (`compileGantt` の実測)、組立て API の固定 360 より正しい。
- *
- * **格子 (16) の倍数にする**。 描画側 (`cdl` の `chart()` preset) は高さを 16 の倍数へ切り上げる。
- * 揃えないと下端が格子から外れ、 正しい記法でも位置の警告が出る (review 指摘、 360 のまま
- * 5 型が該当していた)。
- */
-export const 図表の大きさ = {
-  funnel: { w: 560, 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)。
- *
- * 図表には数の欄 (割合 / 段の人数) と語の欄 (気持ち / 区画) があり、どちらも `{名前}` で
- * 状態を読める。 確かめることは欄の種類で違うが、**土台は同じ** = 同じ名前を 2 回書いた時に
- * 後ろが効くこと、段で状態に入る値 (切り替え / 補間) も見ること、の 2 つ。
- *
- * #1198 と #1201 では欄ごとに検査を書き足しており、同じ土台を 3 度書いていた。 3 度とも
- * review で同じ形の穴を指摘されている (最初の宣言で判定する / 段で入る値を見落とす)。
- * 土台を 1 つにして、欄ごとの違いだけを外から渡す。
- *
- * ## 確かめること
- *
- * | 欄 | 通す値 | 段で入る値 |
- * |---|---|---|
- * | 数 | 数として読める (空文字は弾く、`Number("")` が 0 を返すため) | 切り替え先が数 |
- * | 語 | 語表にある語 | 切り替え先が語表にあり、補間されない (補間の行き先は数) |
- *
- * 自動で決まる値 (`values:`) は式の評価結果で必ず数になるため、数の欄からは参照できて
- * 語の欄からは参照できない。 式そのものの不備 (語を読む / 名前が無い) は
- * `value-unresolved` の警告が別に出る (実測で確認済)。
- *
- * ## 責務境界 (#1198 / #1200)
- *
- * **見るのは組み立ての時点で決まっている範囲だけ**。 記法の値は実行時に決まるため、ここで
- * 全部を判定しようとすると式の評価を組み立て側で再現することになる。 実際に #1199 の review で
- * 4 round 続けて同じ形の指摘が出て収束せず、境界を決めて切り分けた (穴を 1 つ塞ぐと別の形が
- * 出る = 塞ぎ方ではなく責務の置き場所の問題だった)。
- *
- * | 見る | 見ない | 見ない理由 |
- * |---|---|---|
- * | 名前が宣言されているか | 段の行き先が負になる形 | 描画側が問題なく描く (負の大きさも `NaN` も出ないことを実測) |
- * | 宣言の時点で読める値か | 式が実行時に返す値 | 式の不備は `value-unresolved` の警告が別に出る (実測で確認) |
- * | 段で状態に入る値 | | |
- *
- * 見ない範囲は描画側が受け持つ = 解けない値は既定値で描いて `data-cdl-unresolved` を付ける。
- */
-export function 図表の欄から参照できる名前(
-  doc: DslDocument,
-  欄: {
-    読めるか: (v: number | string) => boolean;
-    補間で壊れるか: boolean;
-    自動の値を許すか: boolean;
-  },
-): Set<string> {
-  // 同じ名前を 2 回宣言した時は後ろが効く。 描画側が後の宣言を有効値として扱うため、
-  // 前の宣言で判定すると「読めると判定したのに読めない値が入る」 状態になる (実測)
-  const 実効 = new Map<string, number | string>();
-  for (const s of doc.animate?.states ?? []) 実効.set(s.name, s.initial);
-
-  const 壊れる = new Set<string>();
-  for (const p of doc.animate?.phases ?? []) {
-    for (const st of p.sets ?? []) if (!欄.読めるか(st.value)) 壊れる.add(st.state);
-    if (欄.補間で壊れるか) for (const tw of p.tweens ?? []) 壊れる.add(tw.state);
-  }
-
-  const out = new Set<string>();
-  for (const [名前, 値] of 実効) {
-    if (!欄.読めるか(値)) continue;
-    if (壊れる.has(名前)) continue;
-    out.add(名前);
-  }
-  if (欄.自動の値を許すか) for (const v of doc.values ?? []) out.add(v.name);
-  return out;
-}
-
-/** 数の欄が読める値か。 空文字と空白だけは弾く (`Number("")` は 0 を返す) */
-export function 数として読めるか(v: number | string): boolean {
-  if (typeof v === "number") return Number.isFinite(v);
-  const t = v.trim();
-  if (t === "") return false;
-  return Number.isFinite(Number(t));
-}
-
-export function 数の欄から参照できる名前(doc: DslDocument): Set<string> {
-  return 図表の欄から参照できる名前(doc, {
-    読めるか: 数として読めるか,
-    // 補間の行き先は数なので、数の欄では壊れない
-    補間で壊れるか: false,
-    自動の値を許すか: true,
-  });
-}
-
-export function 語の欄から参照できる名前(doc: DslDocument, 語表: Map<string, string>): Set<string> {
-  return 図表の欄から参照できる名前(doc, {
-    読めるか: (v) => 語表.has(String(v).trim()),
-    // 補間の行き先は数。 語の欄が読む状態を補間すると、その段で語が数に変わる
-    補間で壊れるか: true,
-    // 式の評価結果は数になるため、語の欄からは読めない
-    自動の値を許すか: false,
-  });
-}

package/src/compile/deep-rewrite.ts

@@ -1,30 +0,0 @@
-/**
- * 入れ子の中の文字だけを書き換える (#2034 で `compile.ts` から移した)。
- *
- * **葉に置く** = 入口 (`compileToCdl`) と部品の取り込み (`mergePartIntoDiagram`) の両方が呼ぶ。
- */
-
-/**
- * 形 (`shape`) と数値の表示 (`readout`) の入れ子にある文字の葉を、全て書き換え関数に通す。
- * 文字でない葉 (数 / 真偽 / null) はそのまま残す。
- * 同じ object を 2 度辿らないよう `WeakSet` で覚える = 今の形は木なので輪にはならないが、
- * 輪ができた時に戻らなくなるのを防ぐため。
- */
-export function deepRewriteStrings(
-  value: unknown,
-  rewrite: (s: string | undefined) => string | undefined,
-  seen: WeakSet<object> = new WeakSet(),
-): unknown {
-  if (typeof value === "string") return rewrite(value) ?? value;
-  if (value === null || typeof value !== "object") return value;
-  if (seen.has(value)) return value;
-  seen.add(value);
-  if (Array.isArray(value)) {
-    return value.map((v) => deepRewriteStrings(v, rewrite, seen));
-  }
-  const out: Record<string, unknown> = {};
-  for (const [k, v] of Object.entries(value as Record<string, unknown>)) {
-    out[k] = deepRewriteStrings(v, rewrite, seen);
-  }
-  return out;
-}

package/src/compile/derived-source.ts

@@ -1,18 +0,0 @@
-/**
- * 値の宣言がどの行から来たかを控える (#2034 で `compile.ts` から移した)。
- *
- * **葉に置く** = 入口 (`compileToCdl`) と部品の取り込み (`mergePartIntoDiagram`) の両方が呼ぶ。
- * 見本を重ねる間だけ別表で宣言元を持ち回るため、どちらの側も同じ表へ書き足す。
- */
-
-/** `derived` の同名宣言を、engine が読む順のまま行番号の列として残す。 */
-export function recordDerivedSourceLine(
-  sourceLines: Map<string, number[]> | undefined,
-  id: string,
-  line: number,
-): void {
-  if (!sourceLines) return;
-  const lines = sourceLines.get(id) ?? [];
-  lines.push(line);
-  sourceLines.set(id, lines);
-}

package/src/compile/direction.ts

@@ -1,102 +0,0 @@
-import type { DslDocument, PresetType } from "../types";
-/**
- * 図を並べる向きを決める小道具 (#2030 で `compile.ts` から移した)。
- *
- * 向きを書ける図種と、その既定、書いた向きの読み取り、後ろへ戻る矢印の判定。
- *
- * **葉に置く** = 図種ごとの組み立て器と、`compile.ts` に残る「書いたのに効かない」 の知らせの
- * 両方が呼ぶ。 どちらかの側に置くと、もう片方から逆向きの取り込みが生まれる。
- */
-
-/** 段の有無で経路が分かれる図種。 組み立ての入口が渡す種類と同じ綴り */
-export type GenericKind = "flow" | "swimlane" | "record" | "topology";
-
-/**
- * 向きを選べる図種 (#1494、 #2524 で `flowchart` を足した)。
- *
- * **並び方そのものが読み方を担う図種は外す**。 行を持つ図は「1 縦列 1 箱」、クラス図は
- * 設計が格子に置く形、順序図は 1 枚の板で、どれも向きを入れ替えると図の意味が変わる。
- *
- * `topology` も外す = 入れ物 (`contain`) を持つ図で、縦列の中に箱を囲む作りが向きと結びついている。
- *
- * 分かれ道の図は #2513 で足した時に外していた。 描く側の入口が向きを受けなかったためで、
- * 図の意味が向きと結びついているからではない。 入口が受けるようになったので足す
- * ([cardene777/cdl#880](https://github.com/cardene777/cdl/issues/880))。
- */
-export const 向きを選べる図種: ReadonlySet<PresetType> = new Set<PresetType>([
-  "flow",
-  "swimlane",
-  "flowchart",
-]);
-
-/**
- * 縦列を書いた図でも向きが勝つ図種 (#2524)。
- *
- * 他の図種は、全ての箱が縦列を書いた時に **縦列のほうが勝つ**。 書いた縦列に箱を置く形が
- * 向きより具体的な指定だからで、その時は書いた向きが捨てられたと知らせる。
- *
- * 分かれ道の図だけは逆にする。 この図種は **縦列が役割** で、書く人はほぼ必ず全ての箱に
- * 役割を書く。 縦列が勝つ形にすると向きの行が 1 度も効かず、選べるようにした意味が消える。
- */
-export const 縦列より向きが勝つ図種: ReadonlySet<PresetType> = new Set<PresetType>(["flowchart"]);
-
-/**
- * その図種の既定の向き (#2424 で `flow` を横にした)。
- *
- * **フローは横に並べる**。 縦に積むと描く広さが幅より高くなり、一覧の台は幅に合わせて
- * 伸ばすので縦に長い図になる (実測 = 見本の頁の「フロー」 が 576×920 で、器 1150×630px に
- * 収まらなかった)。 横に並べると 1 人 1 縦列になり、幅の側へ伸びる。
- *
- * `topology` だけ縦のまま = 入れ物 (`contain`) を持つ図で、縦列の中に箱を囲む作りが
- * 向きと結びついている。
- *
- * **動きを書かないフローはここを読まない**。 その形は箱を鎖のように繋ぐ別の組み立てを通る
- * (`鎖でつなぐ形か`)。 既定を変えても鎖の並びは 1 件も動かない。
- */
-export function 既定の向き(kind: PresetType): "縦" | "横" {
-  return kind === "topology" ? "縦" : "横";
-}
-
-/**
- * 実際に使う向き (#1494)。
- *
- * 書いていない図と、効かない図種に書いた図は既定のまま = **書かない図の並びは 1 つも動かない**。
- */
-export function 並べる向き(kind: PresetType, doc: DslDocument): "縦" | "横" {
-  if (doc.direction === undefined) return 既定の向き(kind);
-  if (!向きを選べる図種.has(kind)) return 既定の向き(kind);
-  return doc.direction;
-}
-
-/**
- * 後ろへ戻る矢印か (#1260 / #2782)。
- *
- * 前の箱へ戻る矢印は **箱の上を回して** 描く (`routing: "back-detour"`)。 組立て API 側が
- * そうしており、記法側で付けないと **描いた図の高さが変わる**
- * (実測 = viewBox が 404 対 486 で、戻る矢印が箱の右横を回っていた)。
- *
- * 判定は並び順。 指す先が指す元より前にあれば戻る矢印
- * (実測 = `stateMachine()` は c -> a と c -> b の 2 本だけに付け、a -> b と b -> c には付けない)。
- *
- * **縦列を書いた図には付けない** (#2782)。 回すのは「書いた順に並ぶから、戻る線が箱を
- * 貫く」 ための手当てで、縦列と段を書いた図は書いた人が置き場所を決めている。
- * 畳む前の表の図は縦列を書く形が多く、そこへ回し始めると **線が往復して戻る弧になり**
- * 関係の無い箱を貫いた (実測 = `利用者 -> 会員証` が同じ点へ 2 度戻る形になり、
- * 配置の知らせに `overlap node ∩ edge-path` が出た)。
- *
- * **行を持つ図だけに付ける**。 他の図種の組立て API は付けない。
- */
-export function 後ろへ戻る矢印か(
-  kind: GenericKind,
-  fromId: string,
-  toId: string,
-  箱の並び: ReadonlyMap<string, number>,
-  縦列を書いた: boolean,
-): boolean {
-  if (kind !== "record") return false;
-  if (縦列を書いた) return false;
-  const 元 = 箱の並び.get(fromId);
-  const 先 = 箱の並び.get(toId);
-  if (元 === undefined || 先 === undefined) return false;
-  return 先 < 元;
-}