@cardenelabs/dragon 0.28.0 → 0.32.0

package/dist/index.d.cts

@@ -1,6 +1,124 @@
-import { NodeKind, Tone, CdlDiagram, EdgeStyle, EdgeHead, EdgeHeadFill, ClassRelationType, SequenceMessageKind, EdgeReveal, RelationFocus, LaidDiagram } from '@cardenelabs/cdl';
+import { LegendMark, NodeKind, Tone, CdlNode, BarCornerRadii, CdlDiagram, CdlLegendItem, RowWell, EdgeStyle, EdgeHead, EdgeHeadFill, ClassRelationType, SequenceMessageKind, EdgeReveal, RelationFocus, LaidDiagram } from '@cardenelabs/cdl';
 export { CdlDiagram } from '@cardenelabs/cdl';
 
+/**
+ * Text DSL i18n キーワード一覧
+ * 日本語 / 英語両対応 (大文字小文字無視)
+ */
+
+/**
+ * 図の並ぶ向き (`direction:`、 #1494)。
+ *
+ * 縦列 (`lane`) は横、段 (`stack`) は縦に置かれるので、向きは「1 つの縦列に積む」 か
+ * 「1 人ずつ縦列を作る」 かの選択になる。 どちらも組み立て側に既にある経路で、
+ * 記法から名指しできる言葉が無かった。
+ */
+declare const DIRECTIONS: readonly ["縦", "横"];
+type DslDirection = (typeof DIRECTIONS)[number];
+/**
+ * 向きの別名。 色 (`色` / `color` / `tone`) と同じく日本語と英語の両方で書ける。
+ *
+ * 正規の語を鍵にも入れておく = 引く側が別名かどうかを気にせず 1 度で解決できる。
+ */
+declare const DIRECTION_ALIAS: Record<string, DslDirection>;
+/**
+ * 箱を並べる順 (`order:`、 #2655)。
+ *
+ * 書かなければ **書いた順** のまま。 `種類` と書くと箱の種類で並べ替えてから置く。
+ *
+ * これは図の型として持っていた差を語に出したもの。 並べ替えの鍵しか持たない型
+ * (`solidity`) が在り、`compile.ts` は「順序図 または その型」 という条件を 6 か所で
+ * 書いていた。 **型が 1 つ増えるたびに条件を 2 つ並べる形**になるので、差が並べ替えだけなら
+ * 型ではなく語で表す。
+ */
+declare const ORDERS: readonly ["種類"];
+type DslOrder = (typeof ORDERS)[number];
+/**
+ * 並び順の別名。 向きと同じく日本語と英語の両方で書ける。
+ *
+ * 正規の語を鍵にも入れておく = 引く側が別名かどうかを気にせず 1 度で解決できる。
+ */
+declare const ORDER_ALIAS: Record<string, DslOrder>;
+/**
+ * 数を描く図の形 (`shape:`、 #2657)。
+ *
+ * 数の書き方 (`- 名前: "45"` の 1 行 1 値) は 9 つとも同じで、違うのは描かれる形だけ。
+ * 差が形だけなので型ではなく語で表す (並べ替えの語 #2655 と同じ判断)。
+ *
+ * **日本語の別名は持たない**。 いま `type:` に書く語が英語なので、語を移した先で
+ * 書き手が覚える綴りが増えない形にする。
+ */
+declare const SHAPES: readonly ["pie", "bar", "line", "gauge", "radial", "stat", "waffle", "stacked", "slope"];
+type DslShape = (typeof SHAPES)[number];
+/** 泳法図の形 (`shape:`、 #2797)。 後続の形も chart と混ぜずここへ足す。 */
+declare const SWIMLANE_SHAPES: readonly ["stages", "metro", "timeline"];
+type DslSwimlaneShape = (typeof SWIMLANE_SHAPES)[number];
+/** 最上位の `shape:` が取り得る語。 図種ごとの集合は `DIAGRAM_SHAPES` が決める。 */
+type DslDiagramShape = DslShape | DslSwimlaneShape;
+/**
+ * `shape:` を選べる図種と、その図種で書ける語 (#2797)。
+ *
+ * 解析・組み立て・schema の照合はこの表から導く。 集合を別々の場所で対応付けると、形を
+ * 足した時に一方だけが古くなり、同じ語が入口によって通ったり落ちたりする。
+ */
+declare const DIAGRAM_SHAPES: {
+    readonly chart: readonly ["pie", "bar", "line", "gauge", "radial", "stat", "waffle", "stacked", "slope"];
+    readonly swimlane: readonly ["stages", "metro", "timeline"];
+};
+/** 全図種の `shape:` の語。 図種を決める前の読み取りと schema の照合に使う。 */
+declare const ALL_DIAGRAM_SHAPES: readonly DslDiagramShape[];
+/**
+ * 図の意匠 (`theme:`、 #1553 / #2790 / #2791 / #2792 / #2793 / #2794 / #2795 / #2796)。
+ *
+ * cdl は色を持たない (形だけを描く)。 名前を `data-cdl-palette` として markup に出すので、
+ * dragon の `cdl-theme.css` がその名前を見て 9 つの口
+ * (台 / 行の面 / 縞 / 枠 / 字 / 型名 / 線 / 所有 / 向きだけ) に色を当てる。
+ *
+ * **名前を自由文字列にしない**。 書き間違えると既定の色みのまま出るので、書き手には
+ * 「効かない」 としか見えない。 語を絞れば読めない語をその場で知らせられる。
+ */
+declare const THEMES: readonly ["kinari", "celadon", "blueprint", "letterpress", "catalog", "terminal", "sketch", "neon", "relief"];
+type DslTheme = (typeof THEMES)[number];
+/**
+ * 意匠の別名 (#2790 / #2791 / #2792 / #2793 / #2794 / #2795 / #2796)。 向きと同じく日本語と英語の両方で書ける。
+ *
+ * `kinari` = 生成りに茶、 `celadon` = 青磁に墨、 `blueprint` = 図面、 `letterpress` = 活版、
+ * `catalog` = 図録、 `terminal` = 端末、 `sketch` = 手描き、 `neon` = 電飾、 `relief` = 浮彫。
+ *
+ * record は用途を一つに決められないため既定の意匠を持たない。UML クラス図に生成り色が要る時も
+ * 書き手が `theme:` を明記する。
+ */
+declare const THEME_ALIAS: Record<string, DslTheme>;
+/** 書いた意匠を正規の語に直す。 読めない語は `null`。 */
+declare function resolveTheme(s: string): DslTheme | null;
+/** 凡例の印の日本語名を描画側の名前へ直す表。 */
+declare const LEGEND_MARK_ALIAS: Readonly<Record<string, LegendMark>>;
+/** 凡例の印を描画側の名前へ直す。 読めない語は `null`。 */
+declare function resolveLegendMark(s: string): LegendMark | null;
+/**
+ * 意匠から字の測り方を引く (#2818 / #2918)。
+ *
+ * 意匠を替えても骨組みを変えず、端末の等幅字も箱へ収めるため、比例・等幅の広い方で測る。
+ * 公開済みの関数なので窓口を残し、どの意匠でも組み立てと同じ値を返す。
+ */
+declare function 意匠の字の測り方(_theme: DslTheme): "widest";
+/** 意匠と節から、見本に合わせた円の区画間の弧の長さを引く (#2871)。 */
+declare function 意匠の円の区画の間(theme: DslTheme, node: Pick<CdlNode, "kind">): number | undefined;
+/** `barCornerRadii` が効く棒を描く節か。 */
+declare function 棒を描く節か(node: Pick<CdlNode, "kind" | "funnelForm">): boolean;
+/**
+ * 意匠と節から、見本に合わせた棒の 4 隅の丸みを引く (#2863)。
+ *
+ * 手描きの見本は楕円の角 (`10px 14px 6px 12px / 14px 8px 12px 6px`) だが、cdl は
+ * 円の角だけを持つため、各隅の横と縦の平均を丸めて 12 / 11 / 9 / 9 とする。
+ * 生成りと青磁には見本が無いため値を返さず、記法で組み立てた形を保つ。
+ */
+declare function 意匠の棒の角(theme: DslTheme, node: Pick<CdlNode, "kind" | "funnelForm">): BarCornerRadii | undefined;
+/** NodeKind 別名 (日本語 → English) */
+declare const NODE_KIND_ALIAS: Record<string, NodeKind>;
+/** Tone 別名 */
+declare const TONE_ALIAS: Record<string, Tone>;
+
 /**
  * Text DSL v0.5 parser
  *
@@ -58,9 +176,34 @@ type V05ParseResult = {
  * 書くと、項目を足した時に案内か一覧のどちらかが取り残される (実際に `states` / `values` が
  * 一覧に 1 件も無い状態で放置されていた)。
  */
-declare const TOP_LEVEL_KEYS: readonly ["title", "type", "actors", "flow", "states", "values", "animation", "viewport", "lanes", "groups", "eyebrow", "axes", "readouts", "inputs", "formulas", "events", "scrolls", "bands", "reveal", "relations", "direction", "palette"];
+declare const TOP_LEVEL_KEYS: readonly ["title", "type", "actors", "flow", "states", "values", "animation", "viewport", "lanes", "groups", "eyebrow", "axes", "regions", "readouts", "inputs", "formulas", "events", "scrolls", "bands", "reveal", "relations", "direction", "order", "shape", "form", "ticks", "ganttToday", "ganttTickLabels", "ganttBarEnd", "ganttBarThickness", "chartSeriesSkipMuted", "chartLineSeries", "chartPieCenterLabel", "chartPieTableColumns", "chartPieRingWidth", "chartSlopePeriods", "chartSlopeEmphasisIds", "chartSlopeUnit", "chartStackedPeriods", "chartStackedRateId", "chartStackedLegendPosition", "chartGaugeValue", "chartWaffleLegendPosition", "funnelForm", "funnelRate", "quadrantPointLabelSide", "treeNodeForm", "treeSize", "treeEdgeTone", "treeEdgeHead", "mindForm", "mindSize", "journeyForm", "journeyLineForm", "journeyLabels", "journeySize", "sequenceActorForm", "sequenceLabelForm", "sequenceReturnHead", "sequenceKindLabels", "sequenceRowGap", "sequenceGutter", "sequenceBandWidth", "sequenceSelfLoop", "figureCard", "figureSize", "terminalDecoration", "cornerForm", "figureKindLabel", "figureInset", "chartBarSize", "chartBarShape", "chartLineSize", "chartPieSize", "chartWaffleSize", "chartSlopeLabelTemplate", "chartSlopeSize", "chartStackedLayout", "chartGaugeSize", "ganttSize", "quadrantLabelPosition", "quadrantSize", "stageLayout", "theme", "legend", "legendOffset", "legendFontSize", "edgeEndGap", "stageHeader"];
 /** 受け付ける図種。 記法一覧はここを見る。 */
 declare const PRESET_TYPES: ReadonlySet<PresetType>;
+/**
+ * 図種の別名 (#2655 / #2657)。
+ *
+ * **差が語 1 つしかない図種を、畳んだ先の型とその語に読み替える**。
+ *
+ * | 古い綴り | 読み替え先 | 差 |
+ * |---|---|---|
+ * | `solidity` | `sequence` + `order: 種類` | 箱を種類で並べ替えるだけで、独自の組み立てを持たない |
+ * | 数を描く 9 つ | `chart` + `shape: <綴り>` | 同じ組み立て関数に渡す文字列 2 つしか違わない |
+ *
+ * 型として持つと、同じ扱いをする条件と表が型の数だけ増える。 `solidity` は
+ * 「順序図 または その型」 という条件を 12 か所に増やし、数を描く 9 つは 4 つの表に
+ * 同じ値の行を 9 行ずつ並べていた (足す人が 1 か所書き忘れると黙って外れる)。
+ *
+ * **読み替えは読み取りの入口 1 か所に閉じる**。 ここを通った後は古い綴りが
+ * どこにも残らないので、組み立て側は畳んだ先の型として 1 通りに扱える。
+ *
+ * 古い名前で書いた記法はそのまま動く = 別名を消すのは別の回にする。
+ */
+type 読み替え先 = {
+    type: PresetType;
+    order?: DslOrder;
+    shape?: DslShape;
+};
+declare const TYPE_ALIASES: ReadonlyMap<string, 読み替え先>;
 /**
  * 記法だけが持つ種類。 描画側には無いが、 図種ごとの組み立てで意味を持つ。
  *
@@ -71,18 +214,16 @@ declare const PRESET_TYPES: ReadonlySet<PresetType>;
  * 図の組み立てが落ちる = 描画側は知らない種類の大きさを引けない (#1420 で実測、
  * `Cannot read properties of undefined (reading 'h')`)。
  */
-declare const DSL_ONLY_KINDS: readonly ["entity", "state", "contract", "eoa", "multisig", "proxy", "library", "interface"];
+declare const DSL_ONLY_KINDS: readonly ["entity", "state", "contract", "eoa", "multisig", "proxy", "library", "interface", "loop"];
 /** 記法だけが持つ種類。 描画側の `NodeKind` には含まれない */
 type DslOnlyKind = (typeof DSL_ONLY_KINDS)[number];
 /**
- * 受け付ける箱の種類。 描画できる種類 (cdl の `NODE_KINDS`) に、 記法だけが持つ種類を足す。
+ * 記法が受理する種類の全体。 これに載っていない種類は見本 (パーツ) の候補になる。
  *
- * 以前は手書きの 31 種だった。 描画できる 90 種のうち 78 種が記法から書けず、 部品名として
- * 扱われて「そんな部品は無い」 と警告が出るだけだった。 描画側を出所に加えることで
+ * 描画できる種類 (cdl の `NODE_KINDS`) に、 記法だけが持つ種類と基盤の別名を足す。
+ * 手書きの一覧だった頃は、 描画側に種類が増えても記法から書けず、 部品名として扱われて
+ * 「そんな部品は無い」 と警告が出るだけだった。 描画側を出所に加えることで
  * 「描画できるものは書ける」 が成立する。
- */
-/**
- * 記法が受理する種類の全体。 これに載っていない種類は見本 (パーツ) の候補になる。
  *
  * 画面側が「本文が見本を使っているか」 を判定するのに使う (#1022)。 手書きの一覧を
  * 別に持つと、種類が増えた時にそちらだけ取り残されて余分な読み込みが起きる。
@@ -136,48 +277,18 @@ declare const PHASE_ITEM_WORDS: readonly ["focus", "badge", "body", "description
  *
  * いまは語と図種が同じ綴りだが、**同じものとして扱わない**。 語は書き手が書く名前で、
  * 図種は `type:` が取る値。 片方だけ別名を足したくなった時に、対応が表に残っている形にする。
+ *
+ * **数を描く図は形まで指す** (#2657)。 9 つの型を `chart` 1 つに畳んだので、型だけを
+ * 指すと `draw: pie` を棒の図に書いても咎められなくなる = 語ごとの相手を型から形へ
+ * 下ろして、畳む前と同じ細かさで判定する。
  */
-declare const DRAW_TARGETS: ReadonlyMap<string, PresetType>;
+declare const DRAW_TARGETS: ReadonlyMap<string, {
+    type: PresetType;
+    shape?: DslShape;
+}>;
 /** `draw:` に書ける語。 表から導く (#1314) */
 declare const DRAW_WORDS: ReadonlySet<string>;
 
-/**
- * Text DSL i18n キーワード一覧
- * 日本語 / 英語両対応 (大文字小文字無視)
- */
-
-/**
- * 図の並ぶ向き (`direction:`、 #1494)。
- *
- * 縦列 (`lane`) は横、段 (`stack`) は縦に置かれるので、向きは「1 つの縦列に積む」 か
- * 「1 人ずつ縦列を作る」 かの選択になる。 どちらも組み立て側に既にある経路で、
- * 記法から名指しできる言葉が無かった。
- */
-declare const DIRECTIONS: readonly ["縦", "横"];
-type DslDirection = (typeof DIRECTIONS)[number];
-/**
- * 向きの別名。 色 (`色` / `color` / `tone`) と同じく日本語と英語の両方で書ける。
- *
- * 正規の語を鍵にも入れておく = 引く側が別名かどうかを気にせず 1 度で解決できる。
- */
-declare const DIRECTION_ALIAS: Record<string, DslDirection>;
-/**
- * 図の配色 (`palette:`、 #1553)。
- *
- * cdl は色を持たない (形だけを描く)。 名前を `data-cdl-palette` として markup に出すので、
- * dragon の `cdl-theme.css` がその名前を見て 7 つの口 (台 / 行の面 / 縞 / 枠 / 字 / 型名 / 線)
- * に色を当てる。
- *
- * **名前を自由文字列にしない**。 書き間違えると既定の色みのまま出るので、書き手には
- * 「効かない」 としか見えない。 語を絞れば読めない語をその場で知らせられる。
- */
-declare const PALETTES: readonly ["kinari", "celadon"];
-type DslPalette = (typeof PALETTES)[number];
-/** NodeKind 別名 (日本語 → English) */
-declare const NODE_KIND_ALIAS: Record<string, NodeKind>;
-/** Tone 別名 */
-declare const TONE_ALIAS: Record<string, Tone>;
-
 /**
  * 位置を他の要素からの相対で書くための解決。
  *
@@ -191,8 +302,19 @@ declare const TONE_ALIAS: Record<string, Tone>;
  * 2 つあるため、 解決の規則は本 file に 1 つだけ置いて両方から呼ぶ。 片方だけ直すと画面が
  * 直らない事故を、 規則を共有することで構造的に防ぐ。
  */
-/** 基準からどちら側に置くか。 */
-type RelativeDirection = "right" | "left" | "above" | "below";
+/**
+ * 基準からどちら側に置くか。
+ *
+ * 語の一覧は下の `RELATIVE_DIRECTIONS` が持つ。 型を並べ直さず、一覧から導く。
+ */
+type RelativeDirection = (typeof RELATIVE_DIRECTIONS)[number];
+/**
+ * 向きとして受ける語の一覧。
+ *
+ * 読み取りの入口が 2 つある (本文の `位置: Web の右 200` と JSON の `posRel.dir`) ため、
+ * 一覧を 1 箇所に置いて両方から引く。 2 度書くと、向きを足した時に片方だけが取り残される。
+ */
+declare const RELATIVE_DIRECTIONS: readonly ["right", "left", "above", "below"];
 /** 相対で書かれた位置の指定。 */
 type RelativePos = {
     /** 基準にする相手の名前。 `actors:` に書かれた名前をそのまま持つ。 */
@@ -277,8 +399,16 @@ type DslNodeKind = NodeKind | DslOnlyKind;
  * 写して持つと欄が増えた時にずれる。 指した先が変われば型検査が教える。
  */
 type DslDynShape = NonNullable<CdlDiagram["nodes"][number]["shape"]>;
-/** 値を見せる部品 (#1374)。 図形と同じ理由で描画側の型をそのまま使う */
-type DslReadout = NonNullable<CdlDiagram["readouts"]>[number];
+/**
+ * 値を見せる部品 (#1374)。 図形と同じ理由で描画側の型をそのまま使う。
+ *
+ * `pos` は書いた行 (#2405)。 読む元の名前を突き合わせた知らせが、直す行を指すのに使う。
+ * **図へ載せる時に外す** (`compile.ts` の読み取り値を載せる所) = 残すと、行を足しただけで
+ * 組み上がる図が変わる。 JSON から読んだ文書は行を持たないため `undefined` になる。
+ */
+type DslReadout = NonNullable<CdlDiagram["readouts"]>[number] & {
+    pos?: Position;
+};
 /** 読む人が動かすつまみ (#1389)。 部品と同じ理由で描画側の型をそのまま使う */
 type DslInput = NonNullable<CdlDiagram["inputs"]>[number];
 /** つまみの値から決まる値 (#1391)。 描画側の型に、知らせ用の記述位置だけを足す。 */
@@ -315,7 +445,27 @@ type DslEventBinding = {
     handlerId: string;
     pos: Position;
 };
-type PresetType = "sequence" | "flow" | "swimlane" | "er" | "state" | "topology" | "solidity" | "gantt" | "class" | "pie" | "bar" | "line" | "gauge" | "radial" | "stat" | "waffle" | "stacked" | "slope" | "funnel" | "tree" | "journey" | "quadrant" | "c4" | "mind";
+type PresetType = "sequence" | "flow" | "flowchart" | "swimlane"
+/**
+ * 箱が行を持ち、箱どうしが関係を持つ図 (#2782)。
+ *
+ * 畳む前は `er` / `state` / `class` の 3 つに分かれていたが、描画側へ渡す形は同じだった。
+ * 箱はいずれも `storage`、行頭の印はいずれも 形 (四角 / 山形) × 塗り (塗る / 中空) の
+ * 2 軸で、違うのはその軸を何と呼ぶかだけだった (`pk` / `fk` / `opt` と
+ * `entry` / `exit` / `do` / `internal`)。
+ *
+ * dragon の語は 3 つ (`鍵` / `外` / `条件`) で、印の 3 軸と 1 対 1 に対応する。
+ * 古い語は読み取りの入口でこの 3 語へ読み替える (`compile/row-marks.ts` の `行頭の語の別名`)。
+ */
+ | "record" | "topology" | "gantt"
+/**
+ * 数を描く図 (#2657)。 形は `shape:` が決める。
+ *
+ * 畳む前は形ごとに 9 つの型 (`pie` / `bar` / …) を持っていたが、書き方も組み立ても
+ * 同じで、渡す文字列 2 つしか違わなかった。 古い綴りは読み替えの入口で この型と
+ * 形の語の組に読み替える。
+ */
+ | "chart" | "funnel" | "tree" | "journey" | "quadrant" | "c4" | "mind";
 type Position = {
     line: number;
     column?: number;
@@ -343,6 +493,159 @@ type LayoutMode = "auto" | "manual";
 type DslDocument = {
     title: string;
     type: PresetType;
+    /** 円グラフの見せ方。 読めない語も組み立ての知らせにするため、入口では文字列で保持する。 */
+    form?: string;
+    /** `form` を書いた行。 */
+    formPos?: Position;
+    /** ガントチャートの目盛り。 書かなければ工程の始まりから作る従来の規則を使う。 */
+    ticks?: string[];
+    /** `ticks` を書いた行。 */
+    ticksPos?: Position;
+    /** ガントチャートの今日の線の位置と札。 */
+    ganttToday?: {
+        index: number;
+        label: string;
+    };
+    /** 工程の端とは独立して描く目盛り名。 */
+    ganttTickLabels?: string[];
+    /** 帯の終わりを位置として扱う。 */
+    ganttBarEnd?: "position";
+    /** 行の字に対して見本の比で細くする。 */
+    ganttBarThickness?: "thin";
+    /** 図表の系列色で `muted` の項目を数えない。 */
+    chartSeriesSkipMuted?: NonNullable<CdlDiagram["nodes"][number]["chartSeriesSkipMuted"]>;
+    /** 折れ線の複数系列。 */
+    chartLineSeries?: NonNullable<CdlDiagram["nodes"][number]["chartLineSeries"]>;
+    /** 円の中心で合計の下に置く字。 */
+    chartPieCenterLabel?: NonNullable<CdlDiagram["nodes"][number]["chartPieCenterLabel"]>;
+    /** 円の表に置く列。 */
+    chartPieTableColumns?: NonNullable<CdlDiagram["nodes"][number]["chartPieTableColumns"]>;
+    /** 円の輪の太さ。 */
+    chartPieRingWidth?: NonNullable<CdlDiagram["nodes"][number]["chartPieRingWidth"]>;
+    /** 傾き図の左右の時点名。 */
+    chartSlopePeriods?: NonNullable<CdlDiagram["nodes"][number]["chartSlopePeriods"]>;
+    /** 傾き図で主役にする項目の id。 */
+    chartSlopeEmphasisIds?: NonNullable<CdlDiagram["nodes"][number]["chartSlopeEmphasisIds"]>;
+    /** 傾き図の値に付ける単位。 */
+    chartSlopeUnit?: NonNullable<CdlDiagram["nodes"][number]["chartSlopeUnit"]>;
+    /** 内訳の帯の期間。 */
+    chartStackedPeriods?: NonNullable<CdlDiagram["nodes"][number]["chartStackedPeriods"]>;
+    /** 内訳の帯の右に率を描く項目の id。 */
+    chartStackedRateId?: NonNullable<CdlDiagram["nodes"][number]["chartStackedRateId"]>;
+    /** 内訳の帯の凡例の位置。 */
+    chartStackedLegendPosition?: NonNullable<CdlDiagram["nodes"][number]["chartStackedLegendPosition"]>;
+    /** 半円を固定の尺で読む値。 */
+    chartGaugeValue?: NonNullable<CdlDiagram["nodes"][number]["chartGaugeValue"]>;
+    /** 升目の一覧を置く側。 */
+    chartWaffleLegendPosition?: NonNullable<CdlDiagram["nodes"][number]["chartWaffleLegendPosition"]>;
+    /** 漏斗の形。 */
+    funnelForm?: NonNullable<CdlDiagram["nodes"][number]["funnelForm"]>;
+    /** 漏斗に描く率。 */
+    funnelRate?: NonNullable<CdlDiagram["nodes"][number]["funnelRate"]>;
+    /** 座標で置いた四象限の点の名前を置く側。 */
+    quadrantPointLabelSide?: NonNullable<CdlDiagram["nodes"][number]["quadrantPointLabelSide"]>;
+    /** 木の箱を根まで同じ枠で描くか。 */
+    treeNodeForm?: NonNullable<CdlDiagram["nodes"][number]["treeNodeForm"]>;
+    /** 木の札・字・枝間の寸法。 */
+    treeSize?: NonNullable<CdlDiagram["nodes"][number]["treeSize"]>;
+    /** 木の枝色を 1 色にするか、段ごとに分けるか。 */
+    treeEdgeTone?: NonNullable<CdlDiagram["nodes"][number]["treeEdgeTone"]>;
+    /** 木の枝先の印。 */
+    treeEdgeHead?: NonNullable<CdlDiagram["nodes"][number]["treeEdgeHead"]>;
+    /** 放射の中心・枝・葉を、面か輪郭のどちらで描くか。 */
+    mindForm?: NonNullable<CdlDiagram["nodes"][number]["mindForm"]>;
+    /** 放射の札・字・枝間の寸法。 */
+    mindSize?: NonNullable<CdlDiagram["nodes"][number]["mindSize"]>;
+    /** ジャーニーの段を帯か罫で描くか。 */
+    journeyForm?: NonNullable<CdlDiagram["nodes"][number]["journeyForm"]>;
+    /** ジャーニーの点を曲線か直線で結ぶか。 */
+    journeyLineForm?: NonNullable<CdlDiagram["nodes"][number]["journeyLineForm"]>;
+    /** ジャーニーの 5 段に描く名前。 */
+    journeyLabels?: NonNullable<CdlDiagram["nodes"][number]["journeyLabels"]>;
+    /** ジャーニーの描画面と点列の左右余白。 */
+    journeySize?: NonNullable<CdlDiagram["nodes"][number]["journeySize"]>;
+    /** 図表の見出し帯と足。 */
+    figureCard?: NonNullable<CdlDiagram["nodes"][number]["figureCard"]>;
+    /** 端末意匠用の窓操作・字送り・行番号。 */
+    terminalDecoration?: NonNullable<CdlDiagram["nodes"][number]["terminalDecoration"]>;
+    /** 矩形札の一様角と手描き角を意匠で選ぶ。 */
+    cornerForm?: NonNullable<CdlDiagram["nodes"][number]["cornerForm"]>;
+    /** 階層図とマインドマップの種類札。 */
+    figureKindLabel?: NonNullable<CdlDiagram["nodes"][number]["figureKindLabel"]>;
+    /** 図表札の見出しと足の間に置く飾りの凹み面。 */
+    figureInset?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+        radius?: number;
+    };
+    /** 棒グラフの見本寸法。 */
+    chartBarSize?: NonNullable<CdlDiagram["nodes"][number]["chartBarSize"]>;
+    /** 棒グラフの棒を分割するか、上だけ丸めて一体にするか。 */
+    chartBarShape?: NonNullable<CdlDiagram["nodes"][number]["chartBarShape"]>;
+    /** 折れ線グラフの見本寸法。 */
+    chartLineSize?: NonNullable<CdlDiagram["nodes"][number]["chartLineSize"]>;
+    /** 円グラフの見本寸法。 */
+    chartPieSize?: NonNullable<CdlDiagram["nodes"][number]["chartPieSize"]>;
+    /** 升目図の左端と升目の送り。 */
+    chartWaffleSize?: NonNullable<CdlDiagram["nodes"][number]["chartWaffleSize"]>;
+    /** 傾き図の左右の札の書式。 */
+    chartSlopeLabelTemplate?: NonNullable<CdlDiagram["nodes"][number]["chartSlopeLabelTemplate"]>;
+    /** 傾き図の見本寸法。 */
+    chartSlopeSize?: NonNullable<CdlDiagram["nodes"][number]["chartSlopeSize"]>;
+    /** 内訳の帯の見本配置。 */
+    chartStackedLayout?: NonNullable<CdlDiagram["nodes"][number]["chartStackedLayout"]>;
+    /** 半円図の見本寸法。 */
+    chartGaugeSize?: NonNullable<CdlDiagram["nodes"][number]["chartGaugeSize"]>;
+    /** ガント図の見本寸法。 */
+    ganttSize?: NonNullable<CdlDiagram["nodes"][number]["ganttSize"]>;
+    /** 四象限の区画名を置く位置。 */
+    quadrantLabelPosition?: NonNullable<CdlDiagram["nodes"][number]["quadrantLabelPosition"]>;
+    /** 四象限の見本寸法。 */
+    quadrantSize?: NonNullable<CdlDiagram["nodes"][number]["quadrantSize"]>;
+    /**
+     * 図全体を 1 箱にする図種の札の大きさ。
+     *
+     * `viewport` は図全体の画布なので分ける。`width` / `height` は既存の viewport と lane の
+     * 綴りに揃え、描画側だけが使う短い `w` / `h` を記法へ漏らさない。
+     */
+    figureSize?: {
+        width: number;
+        height: number;
+    };
+    /** 図の下へ指定順に置く凡例。 */
+    legend?: CdlLegendItem[];
+    /** 図全体の凡例の位置を既定位置からずらす。 */
+    legendOffset?: NonNullable<CdlDiagram["legendOffset"]>;
+    /** 線の両端と発着する箱の縁との隙間。 */
+    edgeEndGap?: NonNullable<CdlDiagram["edgeEndGap"]>;
+    /** 順序図の参加者を枠で囲む。 */
+    sequenceActorForm?: "box";
+    /** 順序図の段へ種類印と種類名を添える。 */
+    sequenceLabelForm?: "kind";
+    /** 順序図の返す言づてにも塗った三角の矢じりを使う。 */
+    sequenceReturnHead?: "solid";
+    /** 順序図の言づての段の間。 */
+    sequenceRowGap?: number;
+    /** 順序図の左の札の列幅。 */
+    sequenceGutter?: number;
+    /** 順序図の動いている間の帯幅。 */
+    sequenceBandWidth?: number;
+    /** 順序図の自分へ戻る線の形と寸法。 */
+    sequenceSelfLoop?: {
+        form?: "orthogonal";
+        width?: number;
+        drop?: number;
+    };
+    /** 順序図の種類名の表示語。 */
+    sequenceKindLabels?: Partial<Record<"call" | "return" | "fire", string>>;
+    /** 図の凡例の字の大きさ。 */
+    legendFontSize?: number;
+    /** 段の箱で全意匠に共通して使う見出しの寸法。 */
+    stageHeader?: DslStageHeader;
+    /** 段の列幅・列間と戻る線の迂回寸法。 */
+    stageLayout?: NonNullable<CdlDiagram["stageLayout"]>;
     /**
      * 図全体を 1 箱にする図種 (`pie` / `bar` / `line` / `funnel` / `tree` / `journey` /
      * `quadrant` / `mind` / `gantt`) で、 その箱の上に出す小見出し (#1247)。
@@ -369,6 +672,14 @@ type DslDocument = {
     axes?: DslAxes;
     /** `axes` を書いた行 (#1251)。 知らせの行番号に使う */
     axesPos?: Position;
+    /**
+     * 2 軸で仕分ける図の区画の名前 (#2667)。
+     *
+     * `axes` が軸の両端の名前を持つのに対し、こちらは区画の中に出す名前を持つ。
+     * 軸の掛け合わせ (`効果が大きい × 手間が小さい`) から一段離れた言い方
+     * (`すぐやる`) を書くための欄。
+     */
+    regions?: DslRegions;
     actors: DslActor[];
     flow: DslStep[];
     animate?: DslAnimate;
@@ -402,14 +713,14 @@ type DslDocument = {
      * 既定 (`off`) は何もしない。 `hover` と書くと、箱に触れた時に その箱 ・ 繋がる線 ・
      * 相手の箱だけが光り、他が沈む。 描き手の `CdlDiagram.relationFocus` にそのまま渡る。
      *
-     * クラス図と ER 図は **順番を持たない** 図で、段を追う見せ方は「どの順で読ませるか」 しか
+     * UML の関係や表の関係を描く record は **順番を持たない** 図で、段を追う見せ方は「どの順で読ませるか」 しか
      * 運ばない。 触れた箱の関係を光らせれば、読み手の問いにその場で答えられる。
      */
     relations?: RelationFocus;
     /**
      * 図の並ぶ向き (`direction:`、 #1494)。
      *
-     * `縦` は 1 つの縦列に積み、`横` は 1 人ずつ縦列を作る。 効くのは流れ図と泳法図だけで、
+     * `縦` は 1 つの縦列に積み、`横` は 1 人ずつ縦列を作る。 効くのはフローと泳法図だけで、
      * 他の図種は並び方そのものが読み方を担うため書いても効かない (知らせを出す)。
      *
      * 全ての箱が縦列を書いた形では、書いた縦列が勝つ (同じく知らせを出す)。
@@ -420,15 +731,39 @@ type DslDocument = {
         line: number;
     };
     /**
-     * 図の配色 (`palette:`、 #1553)。
+     * 箱を並べる順 (`order:`、 #2655)。
+     *
+     * 書かなければ書いた順のまま。 `種類` と書くと箱の種類で並べ替えてから置く。
+     * 効くのは順序図だけで、他の図種は並び方そのものが読み方を担うため書いても効かない
+     * (知らせを出す)。
+     *
+     * 並べ替えの鍵しか持たない図種 (`solidity`) を畳んだ先。 読み取りの入口で
+     * 順序図 + この語 に読み替えるので、古い名前で書いた記法はそのまま動く。
+     */
+    order?: DslOrder;
+    /** `order:` を書いた行。 効かない時の知らせで、書いた場所を指すために持つ */
+    orderPos?: {
+        line: number;
+    };
+    /** 図種ごとに選ぶ形 (#2657 / #2797)。 書ける語は `DIAGRAM_SHAPES` が決める */
+    shape?: DslDiagramShape;
+    /** `shape:` を書いた行。 効かない時の知らせで、書いた場所を指すために持つ */
+    shapePos?: {
+        line: number;
+    };
+    /**
+     * 図の意匠 (`theme:`、 #1553 / #2790)。
      *
      * 名前だけを持つ。 実際の色は消費側 (`cdl-theme.css`) が決めるので、ここには値を書かない。
-     * ER 図とクラス図は書かなくても `kinari` (生成りに茶) になる。 どちらも箱の作りが同じ
-     * (行頭の印 + 左に名前 + 右に型) で、名前と型が離れて並ぶため、行を横に追う目印
-     * (行の縞) が要る。 縞の色は配色からしか来ないので、既定が無いと縞が箱の面と同じ色に
-     * 落ちて 1 本も出ない。 書き手が `palette:` を書いた時はそちらが勝つ。
+     * `palette:` も同じ意匠を書く別名として読む。record の用途は一つに決められないため、
+     * UML クラス図の生成り色が要る時も本文で明記する。
      */
-    palette?: DslPalette;
+    theme?: DslTheme;
+    /** `theme:` と別名の `palette:` を両方書いた時の行 (#2790)。 */
+    themeAlsoPalettePos?: {
+        themeLine: number;
+        paletteLine: number;
+    };
     groups?: Record<string, DslGroup>;
     /**
      * 値を見せる部品 (`readouts:`、 #1374)。 割合の輪や数え上げを図の脇に出す。
@@ -477,11 +812,32 @@ type DslAxes = {
     x?: {
         left?: string;
         right?: string;
-    };
+        label?: never;
+        direction?: never;
+    } | DslAxisDirection;
     y?: {
         bottom?: string;
         top?: string;
-    };
+        label?: never;
+        direction?: never;
+    } | DslAxisDirection;
+};
+/** 端の名前ではなく、向き付きの軸名を 1 つだけ描く形。 */
+type DslAxisDirection = {
+    label: string;
+    direction: true;
+};
+/**
+ * 2 軸で仕分ける図の区画の名前 (#2667)。
+ *
+ * 欄の名前は描画側の区画の綴りに揃える。 記法では `左上` のような語で書き、
+ * 解析の時にここへ直す = 区画を指す語を 2 通り持たないため。
+ */
+type DslRegions = {
+    topLeft?: string;
+    topRight?: string;
+    bottomLeft?: string;
+    bottomRight?: string;
 };
 /** 登場人物 (v0.5+ ... inline option 拡張) */
 type DslActor = {
@@ -498,6 +854,38 @@ type DslActor = {
     kindWritten?: boolean;
     /** v0.5+ inline option */
     subtitle?: string;
+    /** kind の意味を保ったまま共通の部品箱で描く。 */
+    kindForm?: "icon";
+    /** 共通の部品箱へ描く線画。 */
+    icon?: "person" | "box" | "database" | "lightning" | "cloud" | "terminal";
+    /** 行を持たない表の箱で行の代わりに描く注記。 */
+    emptyRowsNote?: string;
+    /** 表の箱の名前と小見出しを中央へ揃える。 */
+    titleAlign?: "center";
+    /** 表の箱の行の間に罫線を引く。 */
+    rowRules?: boolean;
+    /** 表の箱の行へ交互の縞を敷く。 */
+    rowStripe?: boolean;
+    /** 表の箱の題と行の baseline。 */
+    rowLayout?: NonNullable<CdlDiagram["nodes"][number]["rowLayout"]>;
+    /** 表の箱の見出し下の線を左右端まで引く。 */
+    rowDividerForm?: "full";
+    /** 表の箱の行のまとまりを収める透明な面。 */
+    rowWell?: RowWell;
+    /** 表の箱の行頭の印を色の段で分ける。 */
+    rowMarkForm?: "tone";
+    /** 表の箱を内側へ抱える親の表の箱の名前。 */
+    nestIn?: string;
+    /** 表または共通の部品箱の足。 */
+    figureCard?: NonNullable<CdlDiagram["nodes"][number]["figureCard"]>;
+    /** 路線図の駅名を駅の上下どちらへ置くか。 */
+    stationNamePosition?: "bottom";
+    /** 時間軸の担当を札のどちらへ置くか。 */
+    subtitlePlacement?: "right";
+    /** 流れ図の function の札の題の大きさ。 */
+    titleFontSize?: number;
+    /** 流れ図の始まり・終わりの印と次の箱との間。 */
+    markGap?: number;
     eyebrow?: string;
     value?: string;
     /**
@@ -518,7 +906,10 @@ type DslActor = {
      * `entry` / `exit` / `do` / `internal`。 印の 2 軸 (形 × 塗り) は共通だが、その軸が
      * 何を指すかは種類ごとに違う。
      */
-    marks?: string[];
+    marks?: Array<string | {
+        mark: string;
+        tone?: "primary" | "muted";
+    }>;
     /**
      * 箱の中に描く図形 (`shape:`、 #1374)。 水位や角度を状態で動かせる。
      *
@@ -577,20 +968,45 @@ type DslActor = {
      * 他の図種では相手が無いため、書かれていたら組み立て側が知らせる。
      */
     end?: string;
+    /** 工程の始まりに出す札。節目の位置名とは独立して書ける。 */
+    startLabel?: string;
+    /** 帯を菱形の節目として描く。 */
+    milestone?: boolean;
+    /** 工程の帯を主役として描く。 */
+    emphasis?: "primary";
+    /**
+     * 四象限の点を置く座標。 左下が (0, 0)、右上が (1, 1)。
+     * 数のほか `{名前}` を受け、描画側の BoundNumber へそのまま渡す。
+     */
+    at?: {
+        x?: number | string;
+        y?: number | string;
+        raw: string;
+    };
+    /** `at` を書いた行。 */
+    atPos?: Position;
     /**
-     * 体験の道筋 (`type: journey`) で、その段階が起きる場所 (#1251)。
+     * ユーザージャーニー (`type: journey`) で、その段階が起きる場所 (#1251)。
      *
      * 「どこで起きたか」 を段の下に出す。 他の図種では相手が無いため、書かれていたら
      * 組み立て側が知らせる。
      */
     touchpoint?: string;
     /**
-     * 体験の道筋 (`type: journey`) で、その段階の改善の余地 (#1251)。
+     * ユーザージャーニー (`type: journey`) で、その段階の改善の余地 (#1251)。
      *
      * 気持ちが落ちる段に「何を直せるか」 を添える。 他の図種では相手が無いため、
      * 書かれていたら組み立て側が知らせる。
      */
     opportunity?: string;
+    /** ジャーニーの改善注記を置く場所。 */
+    opportunityPosition?: NonNullable<NonNullable<CdlDiagram["nodes"][number]["journeyData"]>[number]["opportunityPosition"]>;
+    /**
+     * 段階ごとの箱 (`type: swimlane` + `shape: stages`) で、この箱を入れる段階 (#2797)。
+     *
+     * 書かなければ担当 (`lane`)、担当も無ければ箱の名前を段階として使う。
+     */
+    stage?: string;
     lane?: string;
     stack?: number;
     initial?: boolean;
@@ -692,6 +1108,9 @@ type DslStep = {
     dashOffsetBind?: string;
     /** 矢印がどの辺から出るか (#1385)。 書かなければ描画側が自動で選ぶ */
     side?: "top" | "right" | "bottom" | "left";
+    /** 矢印の出どころと行き先で、個別に使う辺。 */
+    fromSide?: "top" | "right" | "bottom" | "left";
+    toSide?: "top" | "right" | "bottom" | "left";
     /**
      * 矢印の先の形 (#1462)。 書かなければ従来どおり塗った三角。
      *
@@ -709,13 +1128,14 @@ type DslStep = {
     /** 出どころ側の印の塗り (#1466) */
     tailHeadFill?: EdgeHeadFill;
     /**
-     * クラス図の出どころ側の多重度 (#1771)。 `sub` (行き先の端の多重度) と対。
+     * UML の関係を持つ record の出どころ側の多重度 (#1771 / #2783)。
+     * `sub` (行き先の端の多重度) と対。
      *
-     * クラス図でだけ効く (関係の語 `relation` と同じ)。 engine が出どころの端の近くに添える。
+     * `relation` を書いた edge で効き、engine が出どころの端の近くに添える。
      */
     tailSub?: string;
     /**
-     * クラス図の関係の種類 (#1466)。 書くと線と端の形と塗りと付く側がまとめて決まる。
+     * UML の関係の種類 (#1466 / #2783)。record に書くと線と端の形と塗りと付く側がまとめて決まる。
      *
      * 4 つを個別に書かせないのは、組合せが 6 通りしか無く、1 つでも書き違えると読み手に
      * 別の意味で伝わるため (菱を逆に置くと持ち主が入れ替わる)。
@@ -733,6 +1153,17 @@ type DslStep = {
     labelPlate?: boolean;
     labelOffsetX?: number;
     labelOffsetY?: number;
+    /** cdl の固定直線経路。4 欄が全て揃った時だけ描画側が採用する。 */
+    posX1?: number;
+    posY1?: number;
+    posX2?: number;
+    posY2?: number;
+    /** 固定した両端の間を通る直角の折れ線の点。 */
+    waypoints?: NonNullable<CdlDiagram["edges"][number]["waypoints"]>;
+    /** 線の名札を自動回避するか、作者の位置に固定するか。 */
+    labelCollision?: NonNullable<CdlDiagram["edges"][number]["labelCollision"]>;
+    /** 線の名札の幅・高さ・字の大きさ。 */
+    labelSize?: NonNullable<CdlDiagram["edges"][number]["labelSize"]>;
     /** true で説明文を矢印の線の上に重ねる。 分岐図の条件ラベル用。 */
     overlay?: boolean;
     /**
@@ -757,6 +1188,8 @@ type DslLane = {
     x?: number;
     width?: number;
     label?: string;
+    /** 路線図の担当の名札で、名前の下へ出す補足。 */
+    subtitle?: string;
     contain?: boolean;
     lifeline?: boolean;
     /**
@@ -767,6 +1200,15 @@ type DslLane = {
     layoutPos?: LayoutPos;
     pos: Position;
 };
+/** 段の箱の列見出しの寸法。 */
+type DslStageHeader = {
+    leftPad?: number;
+    topPad: number;
+    numberSize: number;
+    gap: number;
+    nameSize: number;
+    bottomPad: number;
+};
 /**
  * 組の宣言 (v0.5+ top-level groups section)。
  *
@@ -784,6 +1226,8 @@ type DslGroup = {
 type DslViewport = {
     width?: number;
     height?: number;
+    /** 描画内容だけを画布の中で横へずらす。 */
+    contentOffsetX?: number;
     /**
      * 図全体の倍率 (default 1)。 箱 / 文字 / 線 / 間隔のすべてが等比で拡大縮小される。
      *
@@ -860,13 +1304,22 @@ type DslValue = {
     /** 動く長さ (ms) */
     durationMs: number;
 });
-/** ステップ (phase) */
-/** 動いている間の帯 (#1466)。 順序図で、面がいつ動いているかを段の番号で持つ */
+/**
+ * 動いている間の帯 (#1466)。 順序図で、面がいつ動いているかを言づての番号で持つ。
+ *
+ * `from` / `to` が指すのは **板に載る言づての行** で、0 から数える (#2404 で実測)。
+ * 段 (`animation` の `step`) ではない = 数も起点も違う。
+ *
+ * `pos` は書いた行 (#2404)。 名前と番号を突き合わせた知らせが、直す行を指すのに使う。
+ * JSON から読んだ文書は行を持たないため `undefined` になる (矢印の飾りの知らせと同じ扱い)。
+ */
 type DslBand = {
     actor: string;
     from: number;
     to: number;
+    pos?: Position;
 };
+/** ステップ (phase) */
 type DslPhase = {
     name: string;
     durationMs: number;
@@ -949,44 +1402,16 @@ type ParseResult = {
 declare function parseTextDsl(src: string): ParseResult;
 
 /**
- * AST (DslDocument) → 既存 preset API 経由 → LaidDiagram
+ * 組み立てが出す知らせの形 (#2030 で `compile.ts` から移した)。
  *
- * v0.3 ... アニメーション ブロック full compile 対応 (sequence preset のみ、 他 preset は v0.4 で順次)
- *   - state / tween / set / highlight / badge / body を実 phase に注入
- *   - アニメーション ありなら builder 直接経路 ... preset の標準 phase を置換
- *   - アニメーション なしは v0.2 と同じく preset 経由
+ * 図種ごとの file が受け取り口の型として使い、`compile.ts` が再輸出して外へ出す。
  *
- * v0.2 ... 6 preset 全対応 (sequence / flow / swimlane / er / state / topology)
+ * **葉に置く** = 型そのものは消えるが、TypeScript の取り込みの輪は残る。 輪があると
+ * 読む順で解決が変わるため、型でも輪を作らない。
  */
-
-interface CompileToCdlOpts {
-    /**
-     * CAR-1657 = parts identifier lookup catalog、 caller (CdlEditor / test) が inject。
-     * DslActor.partId が set された actor を検出したら partsCatalog[partId] から CdlDiagram を
-     * lookup + mergePartIntoDiagram で target に統合。 未渡し時は parts kind actor を skip + warn。
-     */
-    partsCatalog?: Record<string, CdlDiagram>;
-    /**
-     * 組み立ての途中で分かった「書いたのに効かなかったこと」 の受け取り口。
-     *
-     * 図は出せるので誤りにはしないが、 黙って捨てると書いた人が理由を追えない。 editor は
-     * これを受けて画面に出す。 判定は組み立て側だけが持ち、 画面側は表示に徹する。
-     */
-    onNotice?: (notice: CompileNotice) => void;
-    /**
-     * edge が DSL のどの行から来たかの受け取り口 (#998)。
-     *
-     * preset によっては書いた step と生成される edge が一致しない (`type: flow` は actor を鎖状に
-     * 繋ぐため `a -> c` と書いても `a -> b` になる)。 edge を起点に本文の行を直す機能は、 この
-     * 対応が無いと別の行を書き換える。
-     *
-     * **対応が取れない edge については呼ばれない**。 「対応が無い」 と「行 0」 を区別するため。
-     */
-    onEdgeSource?: (edgeId: string, line: number) => void;
-}
 /** 図は出せるが書いた通りにならなかった、 という知らせ。 */
 type CompileNotice = {
-    kind: "relative-position-ignored" | "focus-target-missing" | "state-override-rejected" | "external-paint-dropped" | "part-not-drawn" | "direction-not-honored" | "scale-reserved" | "part-color-ignored" | "part-state-missing" | "part-edge-dropped" | "part-node-ignored" | "part-lane-ignored" | "chart-value-unreadable" | "chart-edge-dropped" | "value-shadows-state" | "value-unresolved" | "value-duplicate" | "flow-actor-missing" | "value-trigger-unresolved" | "lane-not-honored" | "lane-declared-empty" | "eyebrow-not-honored" | "flow-endpoint-not-honored" | "draw-not-honored" | "draw-target-mismatch" | "formula-unresolved" | "event-target-missing" | "actor-kind-not-honored" | "message-option-not-honored" | "position-offset-ignored" | "group-lane-missing" | "group-lanes-apart";
+    kind: "relative-position-ignored" | "focus-target-missing" | "state-override-rejected" | "external-paint-dropped" | "part-not-drawn" | "direction-not-honored" | "direction-same-as-default" | "order-not-honored" | "shape-not-honored" | "stage-from-lane" | "track-from-name" | "theme-palette-both" | "scale-reserved" | "part-color-ignored" | "part-state-missing" | "part-edge-dropped" | "part-not-found" | "part-node-ignored" | "part-lane-ignored" | "chart-value-unreadable" | "chart-edge-dropped" | "value-shadows-state" | "state-shadowed-by-input" | "value-unresolved" | "value-duplicate" | "flow-actor-missing" | "band-not-honored" | "band-actor-missing" | "band-row-out-of-range" | "value-trigger-unresolved" | "lane-not-honored" | "lane-option-not-honored" | "lane-declared-empty" | "eyebrow-not-honored" | "flow-endpoint-not-honored" | "draw-not-honored" | "draw-target-mismatch" | "formula-unresolved" | "readout-source-missing" | "event-target-missing" | "event-target-not-honored" | "focus-target-not-honored" | "actor-kind-not-honored" | "actor-option-not-honored" | "message-option-not-honored" | "position-offset-ignored" | "position-axis-missing" | "group-lane-missing" | "group-lanes-apart" | "cardinality-not-honored" | "edge-option-not-honored" | "gantt-end-before-start";
     /** 対象の名前。 光らせる相手なら書かれた指定そのまま */
     actor: string;
     /** 書かれていた行 */
@@ -994,25 +1419,7 @@ type CompileNotice = {
     message: string;
     hint?: string;
 };
-declare function compileToCdl(doc: DslDocument, opts?: CompileToCdlOpts): CdlDiagram;
-/**
- * 登場人物ごとの、 図の上での中心と大きさを測る。
- *
- * 対応付けは箱に表示される名前で行う。 id を使わない理由は `applyNodeTones` と同じで、
- * slug の作り方が dragon と cdl で違うため記号を含む名前で一致しない。
- *
- * 1 人が複数の箱に分かれる図種 (順序図の上端 / 下端) では、 全部を囲む矩形を返す。
- * 箱として現れない登場人物は縦列の矩形で代用する。
- */
-declare function measureActorBoxes(diagram: CdlDiagram, 
-/**
- * 配置まで済ませた図。 渡すとここでは測り直さない (#1006)。
- *
- * 呼出側が既に組み立てているなら、 ここで `layout` を呼ぶと同じ図の配置を 2 度計算する。
- * 図の規模に比例して重く、 辺 500 本で約 300ms (実測)。
- * 渡す時は `diagram` と対にする = 別の図の配置を渡すと、 測る位置がずれる。
- */
-laidHint?: LaidDiagram): Map<string, AnchorBox>;
+
 /**
  * この図を取り込んでよいか (#1015)。
  *
@@ -1118,9 +1525,10 @@ declare function partRenderSize(part: CdlDiagram): {
  * `readouts` を図の中では扱わないため、図として重ねても何も出ない。 位置決めのための
  * 1x1 の箱が 1 つあるだけになる。
  *
- * catalog 80 件を測ると、この 2 群は `readouts` の有無で完全に分かれた。
- * `readouts` を持つ 17 件は箱と図枠の面積比が全件 0.0000 (箱は 1x1)、
- * 持たない 63 件は最小でも 0.1877。 境目に入る件は無い。
+ * catalog を測ると、この 2 群は `readouts` の有無で完全に分かれる。
+ * `readouts` を持つ 17 件は箱と図枠の面積比が全件 0.00007 (箱は 1x1 で図枠は 120x120)、
+ * 持たない群は最小でも 0.37662。 境目に入る件は無い
+ * (#2681 で図枠が中身に寄るようになり、どちらの群も値が上がったが隔たりは残った)。
  *
  * 判定は面積の閾値ではなく **`readouts` を持ち、かつ箱が図枠に対して極小** の 2 条件で行う。
  * 閾値だけで見ると、小さい箱を意図して置いた見本を巻き込む。 `readouts` だけで見ると、
@@ -1148,6 +1556,13 @@ declare function partBoxInFrame(part: CdlDiagram): {
     left: number;
     top: number;
 };
+/**
+ * 測るためだけの配置が受け取った知らせの数 (#2312)。
+ *
+ * 読み込み時の知らせを 0 行で固定する検査が、母数として読む。 0 件なら「知らせが無い」 では
+ * なく「測るための配置を 1 度も通っていない」 = 検査が空振りしている。
+ */
+declare function 測るために受け取った知らせの数(): number;
 /**
  * パーツ 1 個の箱の外接矩形。
  *
@@ -1210,30 +1625,114 @@ declare function partsGridCenters(baseBottom: number | undefined, items: Readonl
 declare function 部品に上書きを当てる(part: CdlDiagram, actor: Pick<DslActor, "stateOverride" | "colorHex">): CdlDiagram;
 
 /**
- * 記法の検査 (図を書く人向けの修正システム)。
- *
- * cdl / dragon の記法で書いた図 (`CdlDiagram`) を決まった規則で検査し、直し方を修正案
- * (`suggestion`) として返す純粋関数。 言語モデルは使わない。
+ * 登場人物ごとの、 図の上での中心と大きさを測る。
  *
- * 検知システム (`check:cdl` / `check:dragon` / `check:kind`) は開発者向けで実装の不具合を
- * 見つける。 こちらは図を書く人向けで、読む人へ伝わらない書き方 (図の説明に入り込んだ実装の
- * 書き方、無い部品を指す参照、値や項目が空の図表など) を見つける。
+ * 対応付けは箱に表示される名前で行う。 id を使わない理由は `applyNodeTones` と同じで、
+ * slug の作り方が dragon と cdl で違うため記号を含む名前で一致しない。
  *
- * 使い方:
- *   import { lintDiagram, autoFix } from "@cardenelabs/dragon";
- *   const report = lintDiagram(diagram);
- *   // report.issues = LintIssue[]
- *   // report.autoFixableCount = 自動修正で実際に解消できる指摘の数
- *   const patched = autoFix(diagram); // 自動修正を当てた新しい図 (元の図は変えない)
+ * 1 人が複数の箱に分かれる図種 (順序図の上端 / 下端) では、 全部を囲む矩形を返す。
+ * 箱として現れない登場人物は縦列の矩形で代用する。
+ */
+declare function measureActorBoxes(diagram: CdlDiagram, 
+/**
+ * 配置まで済ませた図。 渡すとここでは測り直さない (#1006)。
  *
- * 道具:
- *   node packages/dragon/scripts/dragon-lint.mjs apps/playground-spa/src/topics/catalog/presets.cdl.ts
+ * 呼出側が既に組み立てているなら、 ここで `layout` を呼ぶと同じ図の配置を 2 度計算する。
+ * 図の規模に比例して重く、 辺 500 本で約 300ms (実測)。
+ * 渡す時は `diagram` と対にする = 別の図の配置を渡すと、 測る位置がずれる。
  */
+laidHint?: LaidDiagram): Map<string, AnchorBox>;
 
-type LintSeverity = "warn" | "info";
-type LintIssue = {
-    /** rule 識別子 */
-    rule: string;
+/**
+ * AST (DslDocument) → 既存 preset API 経由 → LaidDiagram
+ *
+ * v0.3 ... アニメーション ブロック full compile 対応 (sequence preset のみ、 他 preset は v0.4 で順次)
+ *   - state / tween / set / highlight / badge / body を実 phase に注入
+ *   - アニメーション ありなら builder 直接経路 ... preset の標準 phase を置換
+ *   - アニメーション なしは v0.2 と同じく preset 経由
+ *
+ * v0.2 ... 6 preset 全対応 (sequence / flow / swimlane / er / state / topology)
+ */
+
+interface CompileToCdlOpts {
+    /**
+     * CAR-1657 = parts identifier lookup catalog、 caller (CdlEditor / test) が inject。
+     * DslActor.partId が set された actor を検出したら partsCatalog[partId] から CdlDiagram を
+     * lookup + mergePartIntoDiagram で target に統合。 未渡し時は parts kind actor を skip + warn。
+     */
+    partsCatalog?: Record<string, CdlDiagram>;
+    /**
+     * 組み立ての途中で分かった「書いたのに効かなかったこと」 の受け取り口。
+     *
+     * 図は出せるので誤りにはしないが、 黙って捨てると書いた人が理由を追えない。 editor は
+     * これを受けて画面に出す。 判定は組み立て側だけが持ち、 画面側は表示に徹する。
+     */
+    onNotice?: (notice: CompileNotice) => void;
+    /**
+     * edge が DSL のどの行から来たかの受け取り口 (#998)。
+     *
+     * preset によっては書いた step と生成される edge が一致しない (`type: flow` は actor を鎖状に
+     * 繋ぐため `a -> c` と書いても `a -> b` になる)。 edge を起点に本文の行を直す機能は、 この
+     * 対応が無いと別の行を書き換える。
+     *
+     * **対応が取れない edge については呼ばれない**。 「対応が無い」 と「行 0」 を区別するため。
+     */
+    onEdgeSource?: (edgeId: string, line: number) => void;
+}
+declare function compileToCdl(doc: DslDocument, opts?: CompileToCdlOpts): CdlDiagram;
+
+/**
+ * 行頭の印を dragon の語で決める (#2782)。
+ *
+ * 描画側が持つ印は 3 軸しかない。 形 (四角 / 山形) と 塗り (塗る / 中空) と
+ * 名前の下線で、この 3 軸に 1 対 1 で当たる語を dragon 自身が持つ。
+ *
+ * | 語 | 軸 | 意味 |
+ * |---|---|---|
+ * | `鍵` | 名前に下線を引く | その行で箱を見分ける |
+ * | `外` | 行頭を山形にする | その行は箱の外とつながる |
+ * | `条件` | 行頭を中空にする | その行は条件が揃った時だけ効く |
+ *
+ * 畳む前は 図種ごとに語を持っていた (表の図は `pk` / `fk` / `opt`、移り変わりの図は
+ * `entry` / `exit` / `do` / `internal`)。 2 つの語彙は同じ 2 軸の格子を別の名前で
+ * 呼んでいただけで、格子の 4 隅は 1 対 1 に重なる。
+ *
+ * |  | 塗る | 中空 |
+ * |---|---|---|
+ * | 四角 | 語なし / `do` | `条件` / `opt` / `internal` |
+ * | 山形 | `外` / `fk` / `entry` | `外 条件` / `fk opt` / `exit` |
+ *
+ * 古い語から dragon の語への読み替えは本 file の `行頭の語へ読み替える` が持ち、
+ * 読み取りの入口 (記法 / JSON の 2 経路) が通す。 印にする時点で古い語は 1 つも残っていない。
+ */
+declare const 行頭の語: readonly ["鍵", "外", "条件"];
+type 行頭の語 = (typeof 行頭の語)[number];
+
+/**
+ * 記法の検査 (図を書く人向けの修正システム)。
+ *
+ * cdl / dragon の記法で書いた図 (`CdlDiagram`) を決まった規則で検査し、直し方を修正案
+ * (`suggestion`) として返す純粋関数。 言語モデルは使わない。
+ *
+ * 検知システム (`check:cdl` / `check:dragon` / `check:kind`) は開発者向けで実装の不具合を
+ * 見つける。 こちらは図を書く人向けで、読む人へ伝わらない書き方 (図の説明に入り込んだ実装の
+ * 書き方、無い部品を指す参照、値や項目が空の図表など) を見つける。
+ *
+ * 使い方:
+ *   import { lintDiagram, autoFix } from "@cardenelabs/dragon";
+ *   const report = lintDiagram(diagram);
+ *   // report.issues = LintIssue[]
+ *   // report.autoFixableCount = 自動修正で実際に解消できる指摘の数
+ *   const patched = autoFix(diagram); // 自動修正を当てた新しい図 (元の図は変えない)
+ *
+ * 道具:
+ *   node packages/dragon/scripts/dragon-lint.mjs apps/playground-spa/src/topics/catalog/presets.cdl.ts
+ */
+
+type LintSeverity = "warn" | "info";
+type LintIssue = {
+    /** rule 識別子 */
+    rule: string;
     severity: LintSeverity;
     /** 該当対象 (node id / edge id / diagram id) */
     target: string;
@@ -1302,12 +1801,12 @@ declare function rectsOverlap(a: DiagramBoundingBox, b: DiagramBoundingBox): boo
  * 書き方は 2 通り。 箱の名前 1 つか、 矢印 (`A -> B`) で 2 者を指す形。
  *
  * 読み方をここに 1 つだけ置く。 id の形は図種で違う (順序図は縦列の上端 / 下端 / 手順箱、
- * 流れ図は箱 1 個) ため id への解決は図種ごとに残すが、 「どちらの書き方か」 の判断を
+ * フローは箱 1 個) ため id への解決は図種ごとに残すが、 「どちらの書き方か」 の判断を
  * 図種ごとに持つと、 同じ記述が図種によって別の意味になる。
  *
  * 以前は図種ごとに判定していて、 順序図と汎用の 2 経路が `-` 1 文字を矢印と見なしていた。
  * その結果 `api-gateway` のような名前が「api から gateway への矢印」 と読まれ、 順序図では
- * 光らず、 流れ図では名前に部分一致した別の矢印が光っていた (実測)。
+ * 光らず、 フローでは名前に部分一致した別の矢印が光っていた (実測)。
  */
 /** 光らせる相手の指定。 */
 type FocusEntry = {
@@ -1536,6 +2035,33 @@ declare function describeOversize(size: InputSize): string | null;
  */
 declare function describeOversizeSource(src: string): string | null;
 
+/**
+ * JSON / YAML の本文で「どこに書いたか」 を指す鍵と、そこから行番号を引く表 (#2117)。
+ *
+ * JSON を読む経路は行番号を持たないため、組み立ての知らせは全て 0 行になり、画面は
+ * 「どの行の話か」 を出せなかった。 本文の行が分かる入口 (編集画面の YAML 欄) は、本文を
+ * 読む時に場所ごとの行を集めてこの表で渡す。 表を渡さない呼出 (LLM が作った JSON を直に
+ * 渡す経路) は今までどおり 0 行になる。
+ *
+ * 鍵の形は RFC 6901 (JSON Pointer) と同じにする (`/actors/1` / `/values/sales`)。
+ * 名前をそのまま `.` で繋ぐ形にすると、`values` に `a.b` という名前を書いた場所と、
+ * `values.a` の中の `b` という欄が同じ鍵になる。 `/` と `~` を書き換える規則があるため、
+ * この形では重ならない。
+ *
+ * 表を作る側 (`apps/playground-spa/src/lib/yaml-lines.ts`) と引く側 (`json-parser.ts`) は
+ * 同じ関数を呼ぶ。 別々に持つと、片方だけ直した時に **全ての行が引けなくなる** =
+ * 引けない状態は知らせが 0 行に戻るだけで、図も誤りも変わらないため気付けない。
+ */
+/** 本文の場所 (JSON Pointer) から、元の本文の行番号 (1 始まり) を引く表。 */
+type 書いた行の表 = ReadonlyMap<string, number>;
+/**
+ * 場所を指す鍵を作る。 引数は上から順に、欄の名前と並びの番号。
+ *
+ * 文書そのものは引数なしで空文字になる。 1 つずつ足す時は、親の鍵に
+ * `書いた場所の鍵(次の区切り)` を繋げる (同じ結果になる)。
+ */
+declare function 書いた場所の鍵(...道: readonly (string | number)[]): string;
+
 /**
  * LLM 向け JSON DSL parser。
  *
@@ -1544,7 +2070,7 @@ declare function describeOversizeSource(src: string): string | null;
  * で確実に生成できるよう、 flat な object array を優先した shape になっている。
  *
  * 使い方 (LLM):
- *   1. `packages/dragon/schemas/diagram.json` の JSON Schema を LLM の tool schema に注入
+ *   1. `packages/dragon/src/schemas/diagram.json` の JSON Schema を LLM の tool schema に注入
  *   2. LLM が JSON を返す
  *   3. `jsonToDiagram(json)` で CdlDiagram に変換
  *   4. validation error は throw、 retry loop で LLM に修正させる
@@ -1556,18 +2082,95 @@ declare function describeOversizeSource(src: string): string | null;
  *   YAML `animation: [step: "..."]` ⇔ JSON `{animation: [{step: "...", duration: 1.4, focus: [...]}]}`
  */
 
+/** 古い綴りで書いた図種 (#2655 / #2657)。 受ける値は `TYPE_ALIASES` が SSOT */
+type 図種の別名 = "solidity" | DslShape;
 /**
  * LLM 向け JSON DSL の入力 shape。 YAML DSL と 1:1 対応、 top-level は flat な object。
  */
 interface DragonJson {
     /** 図の title (必須) */
     title: string;
-    /** preset type (必須): sequence / flow / swimlane / er / state / topology / solidity / gantt / class / pie / c4 / mind */
-    type: PresetType;
+    /**
+     * preset type (必須)。 受け付ける値は `PRESET_TYPES` と `TYPE_ALIASES` が SSOT。
+     *
+     * 別名 (#2655 / #2657) は読み取りで図種と語の 2 つに開く = `solidity` と書いた JSON は
+     * 順序図 + 種類で並べ替え、`pie` と書いた JSON は 数を描く図 + 円の形 として読まれる。
+     */
+    type: PresetType | 図種の別名;
+    /** 円グラフの見せ方。 */
+    form?: string;
+    /** `form` の和名。両方あれば `form` を採る。 */
+    見せ方?: string;
+    /** ガントチャートの目盛り。 */
+    ticks?: string[];
+    /** `ticks` の和名。両方あれば `ticks` を採る。 */
+    目盛り?: string[];
+    /** ガントチャートの今日の線の位置と札。 */
+    ganttToday?: {
+        index: number;
+        label: string;
+    };
+    /** 工程の端とは独立した目盛り名。 */
+    ganttTickLabels?: string[];
+    ganttBarEnd?: "position";
+    ganttBarThickness?: "thin";
+    chartSeriesSkipMuted?: DslDocument["chartSeriesSkipMuted"];
+    chartLineSeries?: DslDocument["chartLineSeries"];
+    chartPieCenterLabel?: DslDocument["chartPieCenterLabel"];
+    chartPieTableColumns?: DslDocument["chartPieTableColumns"];
+    chartPieRingWidth?: DslDocument["chartPieRingWidth"];
+    chartSlopePeriods?: DslDocument["chartSlopePeriods"];
+    chartSlopeEmphasisIds?: DslDocument["chartSlopeEmphasisIds"];
+    chartSlopeUnit?: DslDocument["chartSlopeUnit"];
+    chartStackedPeriods?: DslDocument["chartStackedPeriods"];
+    chartStackedRateId?: DslDocument["chartStackedRateId"];
+    chartStackedLegendPosition?: DslDocument["chartStackedLegendPosition"];
+    chartGaugeValue?: DslDocument["chartGaugeValue"];
+    chartWaffleLegendPosition?: DslDocument["chartWaffleLegendPosition"];
+    funnelForm?: DslDocument["funnelForm"];
+    funnelRate?: DslDocument["funnelRate"];
+    quadrantPointLabelSide?: DslDocument["quadrantPointLabelSide"];
+    treeNodeForm?: DslDocument["treeNodeForm"];
+    treeSize?: DslDocument["treeSize"];
+    treeEdgeTone?: DslDocument["treeEdgeTone"];
+    treeEdgeHead?: DslDocument["treeEdgeHead"];
+    mindForm?: DslDocument["mindForm"];
+    mindSize?: DslDocument["mindSize"];
+    edgeEndGap?: DslDocument["edgeEndGap"];
+    journeyForm?: DslDocument["journeyForm"];
+    journeyLineForm?: DslDocument["journeyLineForm"];
+    journeyLabels?: DslDocument["journeyLabels"];
+    journeySize?: DslDocument["journeySize"];
+    sequenceActorForm?: DslDocument["sequenceActorForm"];
+    sequenceLabelForm?: DslDocument["sequenceLabelForm"];
+    sequenceReturnHead?: DslDocument["sequenceReturnHead"];
+    sequenceKindLabels?: DslDocument["sequenceKindLabels"];
+    sequenceRowGap?: DslDocument["sequenceRowGap"];
+    sequenceGutter?: DslDocument["sequenceGutter"];
+    sequenceBandWidth?: DslDocument["sequenceBandWidth"];
+    sequenceSelfLoop?: DslDocument["sequenceSelfLoop"];
+    figureCard?: DslDocument["figureCard"];
+    figureSize?: DslDocument["figureSize"];
+    terminalDecoration?: DslDocument["terminalDecoration"];
+    cornerForm?: DslDocument["cornerForm"];
+    figureKindLabel?: DslDocument["figureKindLabel"];
+    figureInset?: DslDocument["figureInset"];
+    chartBarSize?: DslDocument["chartBarSize"];
+    chartBarShape?: DslDocument["chartBarShape"];
+    chartLineSize?: DslDocument["chartLineSize"];
+    chartPieSize?: DslDocument["chartPieSize"];
+    chartWaffleSize?: DslDocument["chartWaffleSize"];
+    chartSlopeLabelTemplate?: DslDocument["chartSlopeLabelTemplate"];
+    chartSlopeSize?: DslDocument["chartSlopeSize"];
+    chartStackedLayout?: DslDocument["chartStackedLayout"];
+    chartGaugeSize?: DslDocument["chartGaugeSize"];
+    ganttSize?: DslDocument["ganttSize"];
+    quadrantLabelPosition?: DslDocument["quadrantLabelPosition"];
+    quadrantSize?: DslDocument["quadrantSize"];
     /**
      * 図表の箱の上に出す小見出し (optional)。 記法の最上位 `eyebrow:` と同じ (#1247)。
      *
-     * 効くのは図全体を 1 箱にする図種 (`pie` / `bar` / `line` / `funnel` / `tree` / `journey` /
+     * 効くのは図全体を 1 箱にする図種 (`chart` / `funnel` / `tree` / `journey` /
      * `quadrant` / `mind` / `gantt`) だけ。 箱ごとに分かれる図種では相手が決まらないため、
      * 組み立て側が知らせを出す。 そちらは `actors[].eyebrow` に書く。
      */
@@ -1581,6 +2184,19 @@ interface DragonJson {
      * 他の図種には軸が無いため、書かれていたら組み立て側が知らせる。
      */
     axes?: JsonAxes;
+    /**
+     * 2 軸で仕分ける図の区画の名前 (#2667)。 記法の `regions:` と同じ。
+     *
+     * 鍵は項目の欄と同じ 4 語 (`左上` / `右上` / `左下` / `右下`)。 別の言い方を足すと
+     * 同じ区画を 2 通りで呼ぶことになる。
+     */
+    regions?: JsonRegions;
+    /** 図の凡例の字の大きさ。 */
+    legendFontSize?: number;
+    legendOffset?: DslDocument["legendOffset"];
+    /** 段の箱で全意匠に共通して使う見出しの寸法。 */
+    stageHeader?: DslStageHeader;
+    stageLayout?: DslDocument["stageLayout"];
     /** 登場人物 (必須): 文字列 or { name, kind, ... } object */
     actors: (string | JsonActor)[];
     /** flow step 配列 (必須): { from, to, label, ... } */
@@ -1663,6 +2279,8 @@ interface DragonJson {
         x?: number;
         width?: number;
         label?: string;
+        /** 路線図の担当の名札で、名前の下へ出す補足。 */
+        subtitle?: string;
         contain?: boolean;
         lifeline?: boolean;
         /**
@@ -1688,16 +2306,33 @@ interface DragonJson {
     relations?: RelationFocus;
     /** 図の並ぶ向き (#1494)。 記法の最上位 `direction:` と同じ。 JSON は英語の語で書く */
     direction?: "vertical" | "horizontal";
-    /**
-     * 図の配色 (#1553)。 記法の最上位 `palette:` と同じ。
-     *
-     * 名前だけを図に載せる = cdl は色を持たず、値は `cdl-theme.css` が決める。
-     * ER 図とクラス図は書かなくても `kinari` (生成りに茶) になる。 どちらも箱の作りが同じ
-     * (行頭の印 + 左に名前 + 右に型) で、名前と型が離れて並ぶため、行を横に追う目印
-     * (行の縞) が要る。 縞の色は配色からしか来ないので、既定が無いと縞が箱の面と同じ色に
-     * 落ちて 1 本も出ない。 書き手が `palette:` を書いた時はそちらが勝つ。
-     */
-    palette?: DslPalette;
+    /** 箱を並べ替える軸 (#2655)。 記法の最上位 `order:` と同じ。 JSON は英語の語で書く */
+    order?: "kind";
+    /** 図種ごとに選ぶ形 (#2657 / #2797)。 記法の最上位 `shape:` と同じ */
+    shape?: DslDiagramShape;
+    /** 図の意匠 (#1553 / #2790)。 記法の最上位 `theme:` と同じ。 */
+    theme?: string;
+    /** `theme` の別名。 両方書いた時は `theme` を使う。 */
+    palette?: string;
+    /** 図の下へ置く凡例。 印は記法と同じ英語名または和名で書く。 */
+    legend?: CdlLegendItem[];
+}
+/**
+ * 位置を他の要素からの相対で書く指定の、JSON 側の形 (#2039)。
+ *
+ * 記法の `位置: Web の右 200` を 3 つの欄に開いたもの。 内側の値は `RelativePos` と同じで、
+ * 向きの語も同じ 4 つ (`right` / `left` / `above` / `below`) を使う。
+ *
+ * **向きの語を並べ直さない**。 `RelativeDirection` をそのまま使うことで、本文側に向きを
+ * 足した時に JSON 側が黙って取り残される形を作らない。
+ */
+interface JsonRelativePos {
+    /** 基準にする相手の名前。 `actors:` に書かれた名前をそのまま書く */
+    anchor: string;
+    /** 基準からどちら側に置くか */
+    dir: RelativeDirection;
+    /** 相手との間隔。 書かなければ `RELATIVE_GAP_DEFAULT` */
+    gap?: number;
 }
 interface JsonActor {
     name: string;
@@ -1727,14 +2362,31 @@ interface JsonActor {
     renderOffsetX?: number | string;
     renderOffsetY?: number | string;
     /**
-     * CAR-1657 unified syntax = 既存 NodeKind (28 個) に加えて parts identifier (arc-gauge 等) を
-     * accept する。 未知 kind 値は parts 候補として partId に格納、 compile 側 partsCatalog で解決。
+     * CAR-1657 unified syntax = 既存 NodeKind (一覧は `v05/parser.ts` の `NODE_KIND_VALID`) に
+     * 加えて parts identifier (arc-gauge 等) を accept する。
+     * 未知 kind 値は parts 候補として partId に格納、 compile 側 partsCatalog で解決。
      * LLM structured output の typing 制約を緩めるため union に string 追加。
      * `string & {}` = NodeKind の候補を IDE 補完で提示しつつ任意 string も許容する idiom。
      * 素の `NodeKind | string` は no-redundant-type-constituents に抵触し補完も潰れる (#865)。
      */
     kind?: NodeKind | (string & {});
     subtitle?: string;
+    kindForm?: "icon";
+    icon?: DslActor["icon"];
+    emptyRowsNote?: string;
+    titleAlign?: "center";
+    rowRules?: boolean;
+    rowStripe?: boolean;
+    rowLayout?: DslActor["rowLayout"];
+    rowDividerForm?: DslActor["rowDividerForm"];
+    rowWell?: DslActor["rowWell"];
+    rowMarkForm?: "tone";
+    nestIn?: string;
+    figureCard?: DslActor["figureCard"];
+    stationNamePosition?: "bottom";
+    subtitlePlacement?: "right";
+    titleFontSize?: number;
+    markGap?: number;
     eyebrow?: string;
     value?: string;
     /**
@@ -1745,6 +2397,8 @@ interface JsonActor {
      */
     previous?: string;
     rows?: string[];
+    /** 段階ごとの箱で、この箱を入れる段階。 記法の `stage` / `段階` と同じ (#2797)。 */
+    stage?: string;
     lane?: string;
     stack?: number;
     initial?: boolean;
@@ -1754,6 +2408,17 @@ interface JsonActor {
      * と同じで、読み方は `DslActor.layoutPos` が持つ。
      */
     pos?: LayoutPos;
+    /**
+     * 位置を他の要素からの相対で書く指定 (#2039)。 記法の `位置: Web の右 200` と同じ。
+     *
+     * 記法は 1 本の文字列に「誰の」「どちら側に」「どれだけ離して」 を詰めるが、JSON では
+     * 3 つの欄に分ける。 文字列を組み立てて渡す形にすると、書く側が記法の並び順と区切りを
+     * 覚える必要が出る = JSON を書くのは主に LLM で、読み取りの規則は欄の名前で示す方が短い。
+     *
+     * 組み立ての段階で基準の実座標から `posX` / `posY` に直すため、解決した後は座標を直接
+     * 書いた時と同じ経路を通る。 `pos` (配置後のずらし幅) とは別の欄。
+     */
+    posRel?: JsonRelativePos;
     /**
      * CAR-1657 parts state override (kind = parts identifier 時のみ有効)。
      * LLM JSON DSL では nested 明示 = `{ "state": { "v": 50 } }` が natural、 human 側の
@@ -1789,14 +2454,22 @@ interface JsonActor {
      * (記法側と同じ扱い)。
      */
     end?: string;
+    startLabel?: string;
+    milestone?: boolean;
+    emphasis?: "primary";
+    /** 四象限の座標 `[x, y]`。 */
+    at?: [number | string, number | string];
+    /** `at` の和名。両方あれば `at` を採る。 */
+    点の位置?: [number | string, number | string];
     /**
-     * 体験の道筋 (`type: journey`) で、その段階が起きる場所 (#1294)。 記法の `touchpoint:` と同じ。
+     * ユーザージャーニー (`type: journey`) で、その段階が起きる場所 (#1294)。 記法の `touchpoint:` と同じ。
      */
     touchpoint?: string;
     /**
-     * 体験の道筋 (`type: journey`) で、その段階の改善の余地 (#1294)。 記法の `opportunity:` と同じ。
+     * ユーザージャーニー (`type: journey`) で、その段階の改善の余地 (#1294)。 記法の `opportunity:` と同じ。
      */
     opportunity?: string;
+    opportunityPosition?: DslActor["opportunityPosition"];
     /**
      * 箱を置く絶対座標と大きさ (#1294)。 記法の `posX:` / `posY:` / `posW:` / `posH:` と同じ。
      *
@@ -1813,20 +2486,51 @@ interface JsonActor {
      * 読めない項目名として知らせる)。
      */
     scale?: number;
+    /**
+     * 見本が持つ段を使うか (#2125)。 記法の `{ kind: wave-gauge, phase: false }` と同じ。
+     *
+     * 既定 (書かない) は見本の段を書いた段と番号ごとに並べて再生する。 `false` を書くと
+     * 見本の段の中身 (点灯と値の変化) を空にし、値は書いた段だけが動かす。
+     *
+     * 見本 (parts) にしか効かない。 中身は状態の上書き (`state`) に `phase` として入る =
+     * `"state": { "phase": false }` と同じ所へ届く。 記法が中括弧の中に 1 つの名前として
+     * 書ける以上、JSON でも同じ名前で書けるようにする (入口で書き方が分かれない)。
+     */
+    phase?: boolean;
     /** 行頭の印 (#1466)。 行と対で読む。 語の意味は図の種類が決める */
-    marks?: string[];
+    marks?: Array<string | {
+        mark: string;
+        tone?: "primary" | "muted";
+    }>;
 }
 /** 2 軸で仕分ける図の軸の名前 (#1294)。 記法の `axes:` と同じ形 */
 interface JsonAxes {
     x?: {
         left?: string;
         right?: string;
+        label?: never;
+        direction?: never;
+    } | {
+        label: string;
+        direction: true;
     };
     y?: {
         bottom?: string;
         top?: string;
+        label?: never;
+        direction?: never;
+    } | {
+        label: string;
+        direction: true;
     };
 }
+/** 2 軸で仕分ける図の区画の名前 (#2667)。 記法の `regions:` と同じ形 */
+interface JsonRegions {
+    左上?: string;
+    右上?: string;
+    左下?: string;
+    右下?: string;
+}
 interface JsonStep {
     from: string;
     to: string;
@@ -1834,6 +2538,8 @@ interface JsonStep {
     sub?: string;
     /** 矢印がどの辺から出るか (#1385)。 記法の `side:` と同じ */
     side?: "top" | "right" | "bottom" | "left";
+    fromSide?: "top" | "right" | "bottom" | "left";
+    toSide?: "top" | "right" | "bottom" | "left";
     /**
      * 矢印の先の形 (#1462)。 記法の `{ head: triangle }` と同じ。
      *
@@ -1845,7 +2551,7 @@ interface JsonStep {
     tailHead?: EdgeHead;
     headFill?: EdgeHeadFill;
     tailHeadFill?: EdgeHeadFill;
-    /** クラス図の出どころ側の多重度 (#1771)。 記法の `{ tailSub: "1" }` と同じ */
+    /** UML 関係の出どころ側の多重度 (#1771 / #2783)。記法の `{ tailSub: "1" }` と同じ */
     tailSub?: string;
     /**
      * 辺の役目 (cdl#618)。 記法の `{ role: main }` と同じ。
@@ -1855,7 +2561,7 @@ interface JsonStep {
     role?: "main";
     /** 名前の下地を敷くか (cdl#618)。 記法の `{ labelPlate: false }` と同じ。 既定は敷く */
     labelPlate?: boolean;
-    /** クラス図の関係の語 (#1466)。 書くと端の形 / 塗り / 線種がまとめて決まる */
+    /** record の UML 関係の語 (#1466 / #2783)。書くと端の形 / 塗り / 線種がまとめて決まる */
     relation?: ClassRelationType;
     /** 順序図の言づての種類 (#1466)。 `call` / `return` / `fire` */
     kind?: SequenceMessageKind;
@@ -1877,6 +2583,13 @@ interface JsonStep {
     dashOffsetBind?: string;
     labelOffsetX?: number;
     labelOffsetY?: number;
+    posX1?: number;
+    posY1?: number;
+    posX2?: number;
+    posY2?: number;
+    waypoints?: DslStep["waypoints"];
+    labelCollision?: DslStep["labelCollision"];
+    labelSize?: DslStep["labelSize"];
     /** true で説明文を矢印の線の上に重ねる。 分岐図の条件ラベル用。 */
     overlay?: boolean;
     /**
@@ -1899,6 +2612,13 @@ interface JsonPhase {
     focus?: string[];
     /** body 説明文 */
     body?: string;
+    /**
+     * 説明文の別名 (#2621)。 記法が `description:` を受けるので JSON でも受ける。
+     *
+     * **正の語は `body`**。 両方書いた段は `body` を採る = 正の語を優先すると決めておくと、
+     * 読み手が「どちらが効くのか」 を実装を読まずに判断できる。
+     */
+    description?: string;
     /** badge label */
     badge?: string;
     /**
@@ -1960,6 +2680,13 @@ interface JsonDslError {
 declare function jsonToDiagram(json: unknown, opts?: {
     partsCatalog?: Record<string, CdlDiagram>;
     onNotice?: CompileToCdlOpts["onNotice"];
+    /**
+     * 本文の場所から書いた行を引く表 (#2117)。 渡すと知らせが書いた行を指す。
+     *
+     * JSON そのものは書いた場所を持たないため、本文の行が分かる入口 (編集画面の YAML 欄) が
+     * 集めて渡す。 渡さない呼出は今までどおり全ての知らせが 0 行になる。
+     */
+    行の表?: 書いた行の表;
 }): CdlDiagram;
 /**
  * JSON DSL を validate だけ実施 (compile しない)。 error 詳細を配列で取得したい場合に使う。
@@ -1988,7 +2715,7 @@ declare function validateDragonJson(json: unknown): {
  *   });
  *   const diagram = jsonToDiagram(res.content[0].input);
  *
- * schema JSON は `packages/dragon/schemas/diagram.json` が SSOT、 本 file は import して再 export するだけ。
+ * schema JSON は `packages/dragon/src/schemas/diagram.json` が SSOT、 本 file は import して再 export するだけ。
  */
 /**
  * Dragon DSL JSON Schema (Draft 7)。 Anthropic / OpenAI の tool schema にそのまま注入可能。
@@ -1999,6 +2726,12 @@ declare const diagramJsonSchema: {
     title: string;
     description: string;
     type: string;
+    $defs: {
+        positiveNumber: {
+            type: string;
+            exclusiveMinimum: number;
+        };
+    };
     required: string[];
     additionalProperties: boolean;
     properties: {
@@ -2012,68 +2745,1178 @@ declare const diagramJsonSchema: {
             enum: string[];
             description: string;
         };
-        eyebrow: {
+        form: {
             type: string;
+            enum: string[];
             description: string;
         };
-        axes: {
+        見せ方: {
             type: string;
-            additionalProperties: boolean;
+            enum: string[];
+            description: string;
+        };
+        ticks: {
+            type: string;
+            minItems: number;
+            items: {
+                type: string;
+                minLength: number;
+            };
+            description: string;
+        };
+        目盛り: {
+            type: string;
+            minItems: number;
+            items: {
+                type: string;
+                minLength: number;
+            };
             description: string;
+        };
+        ganttToday: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
             properties: {
-                x: {
+                index: {
                     type: string;
-                    additionalProperties: boolean;
-                    properties: {
-                        left: {
+                };
+                label: {
+                    type: string;
+                };
+            };
+            description: string;
+        };
+        ganttTickLabels: {
+            type: string;
+            minItems: number;
+            items: {
+                type: string;
+            };
+            description: string;
+        };
+        ganttBarEnd: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        ganttBarThickness: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        chartSeriesSkipMuted: {
+            type: string;
+        };
+        chartLineSeries: {
+            type: string;
+            minItems: number;
+            items: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    label: {
+                        type: string;
+                    };
+                    tone: {
+                        type: string;
+                    };
+                    dash: {
+                        type: string;
+                        enum: string[];
+                    };
+                    marker: {
+                        type: string;
+                        enum: string[];
+                    };
+                    valueIndexes: {
+                        type: string;
+                        items: {
                             type: string;
+                            minimum: number;
                         };
-                        right: {
+                    };
+                    points: {
+                        type: string;
+                        minItems: number;
+                        items: {
                             type: string;
+                            additionalProperties: boolean;
+                            required: string[];
+                            properties: {
+                                label: {
+                                    type: string;
+                                };
+                                value: {
+                                    type: string[];
+                                };
+                            };
                         };
                     };
                 };
-                y: {
-                    type: string;
-                    additionalProperties: boolean;
-                    properties: {
-                        bottom: {
+            };
+        };
+        chartPieCenterLabel: {
+            type: string;
+        };
+        chartPieTableColumns: {
+            type: string;
+            enum: string[];
+        };
+        chartPieRingWidth: {
+            type: string;
+            enum: string[];
+        };
+        chartSlopePeriods: {
+            type: string;
+            minItems: number;
+            maxItems: number;
+            items: {
+                type: string;
+                minLength: number;
+            };
+        };
+        chartSlopeEmphasisIds: {
+            type: string;
+            minItems: number;
+            items: {
+                type: string;
+                minLength: number;
+            };
+        };
+        chartSlopeUnit: {
+            type: string;
+        };
+        chartStackedPeriods: {
+            type: string;
+            minItems: number;
+            items: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    label: {
+                        type: string;
+                    };
+                    values: {
+                        type: string;
+                        items: {
+                            type: string[];
+                        };
+                    };
+                };
+            };
+        };
+        chartStackedRateId: {
+            type: string;
+        };
+        chartStackedLegendPosition: {
+            type: string;
+            enum: string[];
+        };
+        chartGaugeValue: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                max: {
+                    type: string;
+                    exclusiveMinimum: number;
+                };
+                current: {
+                    anyOf: ({
+                        type: string;
+                        pattern?: undefined;
+                    } | {
+                        type: string;
+                        pattern: string;
+                    })[];
+                };
+                target: {
+                    anyOf: ({
+                        type: string;
+                        pattern?: undefined;
+                    } | {
+                        type: string;
+                        pattern: string;
+                    })[];
+                };
+                previous: {
+                    anyOf: ({
+                        type: string;
+                        pattern?: undefined;
+                    } | {
+                        type: string;
+                        pattern: string;
+                    })[];
+                };
+                previousLabel: {
+                    type: string;
+                };
+            };
+        };
+        chartWaffleLegendPosition: {
+            type: string;
+            enum: string[];
+        };
+        funnelForm: {
+            type: string;
+            enum: string[];
+        };
+        funnelRate: {
+            type: string;
+            enum: string[];
+        };
+        quadrantPointLabelSide: {
+            type: string;
+            enum: string[];
+        };
+        treeNodeForm: {
+            type: string;
+            enum: string[];
+        };
+        treeSize: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                nodeWidths: {
+                    type: string;
+                    minItems: number;
+                    items: {
+                        type: string;
+                        exclusiveMinimum: number;
+                    };
+                };
+                nodeHeight: {
+                    type: string;
+                    exclusiveMinimum: number;
+                };
+                titleFontSize: {
+                    type: string;
+                    exclusiveMinimum: number;
+                };
+                subtitleFontSize: {
+                    type: string;
+                    exclusiveMinimum: number;
+                };
+                siblingGap: {
+                    type: string;
+                    minimum: number;
+                };
+                levelGap: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
+        treeEdgeTone: {
+            type: string;
+            enum: string[];
+        };
+        treeEdgeHead: {
+            type: string;
+            enum: string[];
+        };
+        mindForm: {
+            type: string;
+            enum: string[];
+        };
+        mindSize: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                contentOffset: {
+                    type: string;
+                    additionalProperties: boolean;
+                    required: string[];
+                    properties: {
+                        x: {
+                            type: string;
+                        };
+                        y: {
+                            type: string;
+                        };
+                    };
+                };
+                root: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        width: {
+                            type: string;
+                            exclusiveMinimum: number;
+                        };
+                        height: {
+                            type: string;
+                            exclusiveMinimum: number;
+                        };
+                        fontSize: {
+                            type: string;
+                            exclusiveMinimum: number;
+                        };
+                    };
+                };
+                branch: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        width: {
+                            type: string;
+                            exclusiveMinimum: number;
+                        };
+                        height: {
+                            type: string;
+                            exclusiveMinimum: number;
+                        };
+                        fontSize: {
+                            type: string;
+                            exclusiveMinimum: number;
+                        };
+                    };
+                };
+                leaf: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        fontSize: {
+                            type: string;
+                            exclusiveMinimum: number;
+                        };
+                    };
+                };
+                rootBranchGap: {
+                    type: string;
+                    minimum: number;
+                };
+                branchLeafGap: {
+                    type: string;
+                    minimum: number;
+                };
+                branchRowGap: {
+                    type: string;
+                    minimum: number;
+                };
+                branchRowOffset: {
+                    type: string;
+                };
+                leafRowGap: {
+                    type: string;
+                    minimum: number;
+                };
+                leafRowOffset: {
+                    type: string;
+                };
+            };
+        };
+        journeyForm: {
+            type: string;
+            enum: string[];
+        };
+        journeyLineForm: {
+            type: string;
+            enum: string[];
+        };
+        journeyLabels: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                delighted: {
+                    type: string;
+                    minLength: number;
+                };
+                happy: {
+                    type: string;
+                    minLength: number;
+                };
+                neutral: {
+                    type: string;
+                    minLength: number;
+                };
+                frustrated: {
+                    type: string;
+                    minLength: number;
+                };
+                angry: {
+                    type: string;
+                    minLength: number;
+                };
+            };
+        };
+        sequenceActorForm: {
+            type: string;
+            enum: string[];
+        };
+        sequenceLabelForm: {
+            type: string;
+            enum: string[];
+        };
+        sequenceReturnHead: {
+            type: string;
+            enum: string[];
+        };
+        sequenceRowGap: {
+            type: string;
+            exclusiveMinimum: number;
+        };
+        sequenceGutter: {
+            type: string;
+            exclusiveMinimum: number;
+        };
+        sequenceBandWidth: {
+            type: string;
+            exclusiveMinimum: number;
+        };
+        sequenceSelfLoop: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                form: {
+                    type: string;
+                    enum: string[];
+                };
+                width: {
+                    type: string;
+                    exclusiveMinimum: number;
+                };
+                drop: {
+                    type: string;
+                    exclusiveMinimum: number;
+                };
+            };
+        };
+        sequenceKindLabels: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                call: {
+                    type: string;
+                };
+                return: {
+                    type: string;
+                };
+                fire: {
+                    type: string;
+                };
+            };
+        };
+        figureCard: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                label: {
+                    type: string;
+                };
+                note: {
+                    type: string;
+                };
+            };
+        };
+        figureSize: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                width: {
+                    type: string;
+                    exclusiveMinimum: number;
+                };
+                height: {
+                    type: string;
+                    exclusiveMinimum: number;
+                };
+            };
+        };
+        terminalDecoration: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                windowControls: {
+                    type: string;
+                };
+                cursor: {
+                    type: string;
+                };
+                rowOrdinal: {
+                    type: string;
+                };
+            };
+        };
+        cornerForm: {
+            type: string;
+            enum: string[];
+        };
+        chartBarShape: {
+            type: string;
+            enum: string[];
+        };
+        figureKindLabel: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                text: {
+                    type: string;
+                    minLength: number;
+                };
+                x: {
+                    type: string;
+                };
+                y: {
+                    type: string;
+                };
+                fontSize: {
+                    type: string;
+                    exclusiveMinimum: number;
+                };
+                fontWeight: {
+                    type: string;
+                    exclusiveMinimum: number;
+                };
+                letterSpacing: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
+        figureInset: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                top: {
+                    type: string;
+                    minimum: number;
+                };
+                right: {
+                    type: string;
+                    minimum: number;
+                };
+                bottom: {
+                    type: string;
+                    minimum: number;
+                };
+                left: {
+                    type: string;
+                    minimum: number;
+                };
+                radius: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
+        journeySize: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                plotPadding: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        left: {
+                            type: string;
+                            minimum: number;
+                        };
+                        right: {
+                            type: string;
+                            minimum: number;
+                        };
+                    };
+                };
+                pointPadding: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        left: {
+                            type: string;
+                            minimum: number;
+                        };
+                        right: {
+                            type: string;
+                            minimum: number;
+                        };
+                    };
+                };
+            };
+        };
+        chartBarSize: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                tickFontSize: {
+                    $ref: string;
+                };
+                valueFontSize: {
+                    $ref: string;
+                };
+                labelFontSize: {
+                    $ref: string;
+                };
+                plotPadding: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        top: {
+                            type: string;
+                            minimum: number;
+                        };
+                        right: {
+                            type: string;
+                            minimum: number;
+                        };
+                        bottom: {
+                            type: string;
+                            minimum: number;
+                        };
+                        left: {
+                            type: string;
+                            minimum: number;
+                        };
+                    };
+                };
+                barWidth: {
+                    $ref: string;
+                };
+                cornerRadius: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
+        chartLineSize: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                valueLabelOffset: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        above: {
+                            type: string;
+                            minimum: number;
+                        };
+                        below: {
+                            type: string;
+                            minimum: number;
+                        };
+                    };
+                };
+                tickFontSize: {
+                    $ref: string;
+                };
+                periodFontSize: {
+                    $ref: string;
+                };
+                pointRadius: {
+                    $ref: string;
+                };
+                plotPadding: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        top: {
+                            type: string;
+                            minimum: number;
+                        };
+                        right: {
+                            type: string;
+                            minimum: number;
+                        };
+                        bottom: {
+                            type: string;
+                            minimum: number;
+                        };
+                        left: {
+                            type: string;
+                            minimum: number;
+                        };
+                    };
+                };
+                tickGap: {
+                    type: string;
+                    minimum: number;
+                };
+                pointPadding: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        left: {
+                            type: string;
+                            minimum: number;
+                        };
+                        right: {
+                            type: string;
+                            minimum: number;
+                        };
+                    };
+                };
+                periodY: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
+        chartPieSize: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                tableWidth: {
+                    $ref: string;
+                };
+                tableLabelFontSize: {
+                    $ref: string;
+                };
+                tableValueFontSize: {
+                    $ref: string;
+                };
+                tableRowGap: {
+                    type: string;
+                    minimum: number;
+                };
+                tablePaddingInline: {
+                    type: string;
+                    minimum: number;
+                };
+                outerRadius: {
+                    $ref: string;
+                };
+                centerX: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
+        chartWaffleSize: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                gridLeft: {
+                    type: string;
+                    minimum: number;
+                };
+                cellPitch: {
+                    $ref: string;
+                };
+            };
+        };
+        chartSlopeLabelTemplate: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                left: {
+                    type: string;
+                };
+                right: {
+                    type: string;
+                };
+            };
+        };
+        chartSlopeSize: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                pointRadius: {
+                    $ref: string;
+                };
+                periodFontSize: {
+                    $ref: string;
+                };
+                labelFontSize: {
+                    $ref: string;
+                };
+                leftAxisX: {
+                    type: string;
+                    minimum: number;
+                };
+                axisGap: {
+                    $ref: string;
+                };
+                labelAxisGap: {
+                    type: string;
+                    minimum: number;
+                };
+                plotPadding: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        top: {
+                            type: string;
+                            minimum: number;
+                        };
+                        bottom: {
+                            type: string;
+                            minimum: number;
+                        };
+                    };
+                };
+                pointPadding: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        top: {
+                            type: string;
+                            minimum: number;
+                        };
+                        bottom: {
+                            type: string;
+                            minimum: number;
+                        };
+                    };
+                };
+            };
+        };
+        chartStackedLayout: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                legendColumns: {
+                    type: string;
+                    minimum: number;
+                };
+                legendColumnGap: {
+                    type: string;
+                    minimum: number;
+                };
+                segmentGap: {
+                    type: string;
+                    minimum: number;
+                };
+                barThickness: {
+                    $ref: string;
+                };
+                barWidth: {
+                    $ref: string;
+                };
+                legendMarkSize: {
+                    $ref: string;
+                };
+                legendFontSize: {
+                    $ref: string;
+                };
+                periodFontSize: {
+                    $ref: string;
+                };
+                rateFontSize: {
+                    $ref: string;
+                };
+                legendOffsetY: {
+                    type: string;
+                };
+            };
+        };
+        chartGaugeSize: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                arcThickness: {
+                    $ref: string;
+                };
+                outerRadius: {
+                    $ref: string;
+                };
+                plotTop: {
+                    type: string;
+                    minimum: number;
+                };
+                valueFontSize: {
+                    $ref: string;
+                };
+            };
+        };
+        ganttSize: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                taskLabelFontSize: {
+                    $ref: string;
+                };
+                taskLabelAlign: {
+                    type: string;
+                    enum: string[];
+                };
+                taskLabelX: {
+                    type: string;
+                    minimum: number;
+                };
+                tickFontSize: {
+                    $ref: string;
+                };
+                tickCount: {
+                    type: string;
+                    minimum: number;
+                };
+                barThickness: {
+                    $ref: string;
+                };
+                milestoneFontSize: {
+                    $ref: string;
+                };
+                milestoneRadius: {
+                    $ref: string;
+                };
+                dependencyStrokeWidth: {
+                    $ref: string;
+                };
+                taskColumnWidth: {
+                    type: string;
+                    minimum: number;
+                };
+                timelinePaddingRight: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
+        quadrantLabelPosition: {
+            type: string;
+            enum: string[];
+        };
+        quadrantSize: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                plotOffset: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        x: {
+                            type: string;
+                            minimum: number;
+                        };
+                        y: {
+                            type: string;
+                            minimum: number;
+                        };
+                    };
+                };
+                plotSize: {
+                    $ref: string;
+                };
+                pointRadius: {
+                    $ref: string;
+                };
+                pointFontSize: {
+                    $ref: string;
+                };
+                pointLabelGap: {
+                    type: string;
+                    minimum: number;
+                };
+                quadrantFontSize: {
+                    $ref: string;
+                };
+                axisFontSize: {
+                    $ref: string;
+                };
+            };
+        };
+        eyebrow: {
+            type: string;
+            description: string;
+        };
+        axes: {
+            type: string;
+            additionalProperties: boolean;
+            description: string;
+            properties: {
+                x: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        left: {
+                            type: string;
+                        };
+                        right: {
+                            type: string;
+                        };
+                        label: {
+                            type: string;
+                        };
+                        direction: {
+                            type: string;
+                            enum: boolean[];
+                        };
+                    };
+                };
+                y: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        bottom: {
+                            type: string;
+                        };
+                        top: {
+                            type: string;
+                        };
+                        label: {
+                            type: string;
+                        };
+                        direction: {
+                            type: string;
+                            enum: boolean[];
+                        };
+                    };
+                };
+            };
+        };
+        regions: {
+            type: string;
+            additionalProperties: boolean;
+            description: string;
+            properties: {
+                左上: {
+                    type: string;
+                };
+                右上: {
+                    type: string;
+                };
+                左下: {
+                    type: string;
+                };
+                右下: {
+                    type: string;
+                };
+            };
+        };
+        actors: {
+            type: string;
+            minItems: number;
+            description: string;
+            items: {
+                oneOf: ({
+                    type: string;
+                    description: string;
+                    required?: undefined;
+                    additionalProperties?: undefined;
+                    properties?: undefined;
+                } | {
+                    type: string;
+                    required: string[];
+                    additionalProperties: boolean;
+                    properties: {
+                        name: {
+                            type: string;
+                            minLength: number;
+                            description: string;
+                        };
+                        kind: {
+                            type: string;
+                            description: string;
+                        };
+                        subtitle: {
+                            type: string;
+                            description: string;
+                        };
+                        kindForm: {
+                            type: string;
+                            enum: string[];
+                        };
+                        icon: {
+                            type: string;
+                            enum: string[];
+                        };
+                        emptyRowsNote: {
+                            type: string;
+                        };
+                        titleAlign: {
+                            type: string;
+                            enum: string[];
+                        };
+                        rowRules: {
+                            type: string;
+                        };
+                        rowStripe: {
+                            type: string;
+                        };
+                        rowLayout: {
+                            type: string;
+                            additionalProperties: boolean;
+                            properties: {
+                                titleBaseline: {
+                                    type: string;
+                                    minimum: number;
+                                };
+                                rowTop: {
+                                    type: string;
+                                    minimum: number;
+                                };
+                                rowPitch: {
+                                    type: string;
+                                    exclusiveMinimum: number;
+                                };
+                            };
+                        };
+                        rowDividerForm: {
+                            type: string;
+                            enum: string[];
+                        };
+                        rowWell: {
+                            type: string;
+                            additionalProperties: boolean;
+                            properties: {
+                                top: {
+                                    type: string;
+                                    minimum: number;
+                                };
+                                right: {
+                                    type: string;
+                                    minimum: number;
+                                };
+                                bottom: {
+                                    type: string;
+                                    minimum: number;
+                                };
+                                left: {
+                                    type: string;
+                                    minimum: number;
+                                };
+                                radius: {
+                                    type: string;
+                                    minimum: number;
+                                };
+                            };
+                        };
+                        rowMarkForm: {
+                            type: string;
+                            enum: string[];
+                        };
+                        nestIn: {
+                            type: string;
+                            minLength: number;
+                        };
+                        figureCard: {
                             type: string;
+                            additionalProperties: boolean;
+                            required: string[];
+                            properties: {
+                                label: {
+                                    type: string;
+                                };
+                                note: {
+                                    type: string;
+                                };
+                            };
                         };
-                        top: {
+                        stationNamePosition: {
                             type: string;
+                            enum: string[];
+                            description: string;
                         };
-                    };
-                };
-            };
-        };
-        actors: {
-            type: string;
-            minItems: number;
-            description: string;
-            items: {
-                oneOf: ({
-                    type: string;
-                    description: string;
-                    required?: undefined;
-                    additionalProperties?: undefined;
-                    properties?: undefined;
-                } | {
-                    type: string;
-                    required: string[];
-                    additionalProperties: boolean;
-                    properties: {
-                        name: {
+                        subtitlePlacement: {
                             type: string;
-                            minLength: number;
+                            enum: string[];
                             description: string;
                         };
-                        kind: {
+                        titleFontSize: {
                             type: string;
+                            exclusiveMinimum: number;
                             description: string;
                         };
-                        subtitle: {
+                        markGap: {
                             type: string;
+                            exclusiveMinimum: number;
                             description: string;
                         };
                         eyebrow: {
@@ -2098,10 +3941,34 @@ declare const diagramJsonSchema: {
                         marks: {
                             type: string;
                             items: {
-                                type: string;
+                                oneOf: ({
+                                    type: string;
+                                    additionalProperties?: undefined;
+                                    required?: undefined;
+                                    properties?: undefined;
+                                } | {
+                                    type: string;
+                                    additionalProperties: boolean;
+                                    required: string[];
+                                    properties: {
+                                        mark: {
+                                            type: string;
+                                        };
+                                        tone: {
+                                            type: string;
+                                            enum: string[];
+                                        };
+                                    };
+                                })[];
                             };
                             description: string;
                         };
+                        stage: {
+                            type: string;
+                            minLength: number;
+                            pattern: string;
+                            description: string;
+                        };
                         lane: {
                             type: string;
                             description: string;
@@ -2150,6 +4017,37 @@ declare const diagramJsonSchema: {
                             type: string;
                             description: string;
                         };
+                        startLabel: {
+                            type: string;
+                            description: string;
+                        };
+                        milestone: {
+                            type: string;
+                            description: string;
+                        };
+                        emphasis: {
+                            type: string;
+                            enum: string[];
+                            description: string;
+                        };
+                        at: {
+                            type: string;
+                            minItems: number;
+                            maxItems: number;
+                            items: {
+                                type: string[];
+                            };
+                            description: string;
+                        };
+                        点の位置: {
+                            type: string;
+                            minItems: number;
+                            maxItems: number;
+                            items: {
+                                type: string[];
+                            };
+                            description: string;
+                        };
                         touchpoint: {
                             type: string;
                             description: string;
@@ -2158,6 +4056,11 @@ declare const diagramJsonSchema: {
                             type: string;
                             description: string;
                         };
+                        opportunityPosition: {
+                            type: string;
+                            enum: string[];
+                            description: string;
+                        };
                         posX: {
                             type: string;
                             description: string;
@@ -2178,6 +4081,10 @@ declare const diagramJsonSchema: {
                             type: string;
                             description: string;
                         };
+                        phase: {
+                            type: string;
+                            description: string;
+                        };
                         pos: {
                             type: string;
                             additionalProperties: boolean;
@@ -2192,6 +4099,28 @@ declare const diagramJsonSchema: {
                                 };
                             };
                         };
+                        posRel: {
+                            type: string;
+                            additionalProperties: boolean;
+                            description: string;
+                            required: string[];
+                            properties: {
+                                anchor: {
+                                    type: string;
+                                    minLength: number;
+                                    description: string;
+                                };
+                                dir: {
+                                    type: string;
+                                    enum: string[];
+                                    description: string;
+                                };
+                                gap: {
+                                    type: string;
+                                    description: string;
+                                };
+                            };
+                        };
                         visibleIf: {
                             type: string;
                             description: string;
@@ -2368,6 +4297,16 @@ declare const diagramJsonSchema: {
                         enum: string[];
                         description: string;
                     };
+                    fromSide: {
+                        type: string;
+                        enum: string[];
+                        description: string;
+                    };
+                    toSide: {
+                        type: string;
+                        enum: string[];
+                        description: string;
+                    };
                     head: {
                         type: string;
                         enum: string[];
@@ -2415,6 +4354,57 @@ declare const diagramJsonSchema: {
                         type: string;
                         description: string;
                     };
+                    posX1: {
+                        type: string;
+                        description: string;
+                    };
+                    posY1: {
+                        type: string;
+                        description: string;
+                    };
+                    posX2: {
+                        type: string;
+                        description: string;
+                    };
+                    posY2: {
+                        type: string;
+                        description: string;
+                    };
+                    waypoints: {
+                        type: string;
+                        items: {
+                            type: string;
+                            additionalProperties: boolean;
+                            required: string[];
+                            properties: {
+                                x: {
+                                    type: string;
+                                };
+                                y: {
+                                    type: string;
+                                };
+                            };
+                        };
+                    };
+                    labelCollision: {
+                        type: string;
+                        enum: string[];
+                    };
+                    labelSize: {
+                        type: string;
+                        additionalProperties: boolean;
+                        properties: {
+                            width: {
+                                $ref: string;
+                            };
+                            height: {
+                                $ref: string;
+                            };
+                            fontSize: {
+                                $ref: string;
+                            };
+                        };
+                    };
                     overlay: {
                         type: string;
                         description: string;
@@ -2526,6 +4516,10 @@ declare const diagramJsonSchema: {
                         type: string;
                         description: string;
                     };
+                    description: {
+                        type: string;
+                        description: string;
+                    };
                     badge: {
                         type: string;
                         description: string;
@@ -2582,6 +4576,9 @@ declare const diagramJsonSchema: {
                     type: string;
                     minimum: number;
                 };
+                contentOffsetX: {
+                    type: string;
+                };
                 laneWidth: {
                     type: string;
                     minimum: number;
@@ -2625,6 +4622,9 @@ declare const diagramJsonSchema: {
                     label: {
                         type: string;
                     };
+                    subtitle: {
+                        type: string;
+                    };
                     contain: {
                         type: string;
                     };
@@ -3243,11 +5243,163 @@ declare const diagramJsonSchema: {
             enum: string[];
             description: string;
         };
+        shape: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        order: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        theme: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
         palette: {
             type: string;
             enum: string[];
             description: string;
         };
+        legend: {
+            type: string;
+            description: string;
+            items: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    mark: {
+                        type: string;
+                        enum: string[];
+                    };
+                    text: {
+                        type: string;
+                        minLength: number;
+                    };
+                    tone: {
+                        type: string;
+                    };
+                    lineStyle: {
+                        type: string;
+                        enum: string[];
+                    };
+                    align: {
+                        type: string;
+                        enum: string[];
+                    };
+                    lead: {
+                        type: string;
+                    };
+                };
+                oneOf: ({
+                    required: string[];
+                    not: {
+                        anyOf: {
+                            required: string[];
+                        }[];
+                        required?: undefined;
+                    };
+                    allOf?: undefined;
+                } | {
+                    not: {
+                        required: string[];
+                        anyOf?: undefined;
+                    };
+                    allOf: {
+                        not: {
+                            required: string[];
+                        };
+                    }[];
+                    required?: undefined;
+                })[];
+            };
+        };
+        legendFontSize: {
+            type: string;
+            exclusiveMinimum: number;
+            description: string;
+        };
+        edgeEndGap: {
+            type: string;
+            minimum: number;
+            description: string;
+        };
+        legendOffset: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                x: {
+                    type: string;
+                };
+                y: {
+                    type: string;
+                };
+            };
+        };
+        stageHeader: {
+            type: string;
+            description: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                leftPad: {
+                    type: string;
+                    minimum: number;
+                };
+                topPad: {
+                    type: string;
+                    minimum: number;
+                };
+                numberSize: {
+                    type: string;
+                    exclusiveMinimum: number;
+                };
+                gap: {
+                    type: string;
+                    minimum: number;
+                };
+                nameSize: {
+                    type: string;
+                    exclusiveMinimum: number;
+                };
+                bottomPad: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
+        stageLayout: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                columnWidths: {
+                    type: string;
+                    additionalProperties: {
+                        type: string;
+                        minimum: number;
+                    };
+                };
+                columnGap: {
+                    type: string;
+                    minimum: number;
+                };
+                backDetourTopGap: {
+                    type: string;
+                    minimum: number;
+                };
+                backDetourSideGap: {
+                    type: string;
+                    minimum: number;
+                };
+                backDetourTargetInset: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
         reveal: {
             type: string;
             enum: string[];
@@ -3407,4 +5559,4 @@ interface CompileOpts {
  */
 declare function textDslToDiagram(src: string, opts?: CompileOpts): CdlDiagram;
 
-export { type AnchorBox, type CompileNotice, type CompileOpts, DIAGRAM_BOUNDARY_PADDING, DIRECTION_ALIAS, DRAW_TARGETS, DRAW_WORDS, type DiagramBoundingBox, type DragonJson, type DslActor, type DslAnimate, type DslDocument, type DslError, type DslGroup, type DslLane, type DslPhase, type DslSet, type DslState, type DslStep, type DslTween, type DslValue, type DslViewport, type FocusEntry, type InputSize, JSONを分解する, type JsonActor, type JsonAxes, type JsonDslError, type JsonPhase, type JsonStep, type LayoutMode, type LayoutPos, type LintIssue, type LintReport, type LintSeverity, MAX_INPUT_BYTES, MAX_INPUT_ELEMENTS, MAX_PART_SCALE, NODE_KIND_ALIAS, NODE_KIND_VALID, PHASE_ITEM_WORDS, PRESET_TYPES, type PresetType, RELATIVE_GAP_DEFAULT, type RelativeDirection, type RelativePos, TONE_ALIAS, TOP_LEVEL_KEYS, autoFix, compileToCdl, computeDiagramBoundingBox, countBytes, countDiagramElements, countDocElements, describeOversize, describeOversizeSource, diagramJsonSchema, isColorValue, jsonToDiagram, lintDiagram, measureActorBoxes, normalizePartScale, orderByDependency, parseFocusEntry, parseRelativePos, parseTextDsl, parseTextDslV05, partBoxInFrame, partDrawsInDiagram, partIsMeasurable, partRenderSize, partScaleFactor, partTargetScale, partTargetSize, partVisualSize, partsBaseBottom, partsGridCenters, pointsOutside, rectsOverlap, resolveRelativePos, stripExternalPaint, stripQuotes, textDslToDiagram, validateDragonJson, writeActorPosition, type トークン, type トークンの種類, 区間に広げる, 記法を分解する, 部品に上書きを当てる };
+export { ALL_DIAGRAM_SHAPES, type AnchorBox, type CompileNotice, type CompileOpts, DIAGRAM_BOUNDARY_PADDING, DIAGRAM_SHAPES, DIRECTION_ALIAS, DRAW_TARGETS, DRAW_WORDS, type DiagramBoundingBox, type DragonJson, type DslActor, type DslAnimate, type DslDiagramShape, type DslDocument, type DslError, type DslGroup, type DslLane, type DslPhase, type DslSet, type DslShape, type DslState, type DslStep, type DslSwimlaneShape, type DslTheme, type DslTween, type DslValue, type DslViewport, type FocusEntry, type InputSize, JSONを分解する, type JsonActor, type JsonAxes, type JsonDslError, type JsonPhase, type JsonStep, LEGEND_MARK_ALIAS, type LayoutMode, type LayoutPos, type LintIssue, type LintReport, type LintSeverity, MAX_INPUT_BYTES, MAX_INPUT_ELEMENTS, MAX_PART_SCALE, NODE_KIND_ALIAS, NODE_KIND_VALID, ORDERS, ORDER_ALIAS, PHASE_ITEM_WORDS, PRESET_TYPES, type PresetType, RELATIVE_GAP_DEFAULT, type RelativeDirection, type RelativePos, SHAPES, SWIMLANE_SHAPES, THEMES, THEME_ALIAS, TONE_ALIAS, TOP_LEVEL_KEYS, TYPE_ALIASES, autoFix, compileToCdl, computeDiagramBoundingBox, countBytes, countDiagramElements, countDocElements, describeOversize, describeOversizeSource, diagramJsonSchema, isColorValue, jsonToDiagram, lintDiagram, measureActorBoxes, normalizePartScale, orderByDependency, parseFocusEntry, parseRelativePos, parseTextDsl, parseTextDslV05, partBoxInFrame, partDrawsInDiagram, partIsMeasurable, partRenderSize, partScaleFactor, partTargetScale, partTargetSize, partVisualSize, partsBaseBottom, partsGridCenters, pointsOutside, rectsOverlap, resolveLegendMark, resolveRelativePos, resolveTheme, stripExternalPaint, stripQuotes, textDslToDiagram, validateDragonJson, writeActorPosition, type トークン, type トークンの種類, 区間に広げる, 意匠の円の区画の間, 意匠の字の測り方, 意匠の棒の角, 書いた場所の鍵, type 書いた行の表, 棒を描く節か, 測るために受け取った知らせの数, 行頭の語, 記法を分解する, 部品に上書きを当てる };