@cardenelabs/dragon 0.30.0 → 0.32.0

package/src/v05/parser.ts

@@ -41,13 +41,102 @@
  * 出力は v0.4 と同じ DslDocument。 既存 compile.ts で CdlDiagram に変換できる。
  */
 
-import type { NodeKind, Tone, EdgeStyle, EdgeHead, EdgeHeadFill, ClassRelationType, SequenceMessageKind } from "@cardenelabs/cdl";
-import { TONES, NODE_KINDS, EDGE_HEADS, EDGE_HEAD_FILLS, EDGE_STYLES, EDGE_REVEALS, RELATION_FOCUSES, CLASS_RELATION_LOOK, SEQUENCE_MESSAGE_LOOK, parseFormula } from "@cardenelabs/cdl";
+import type {
+  CdlLegendItem,
+  LegendMark,
+  NodeKind,
+  Tone,
+  EdgeStyle,
+  EdgeHead,
+  EdgeHeadFill,
+  ClassRelationType,
+  SequenceMessageKind,
+} from "@cardenelabs/cdl";
+import {
+  TONES,
+  LEGEND_MARKS,
+  NODE_KINDS,
+  EDGE_HEADS,
+  EDGE_HEAD_FILLS,
+  EDGE_STYLES,
+  EDGE_REVEALS,
+  RELATION_FOCUSES,
+  CLASS_RELATION_LOOK,
+  SEQUENCE_MESSAGE_LOOK,
+  parseFormula,
+} from "@cardenelabs/cdl";
 import type { EdgeReveal, RelationFocus } from "@cardenelabs/cdl";
-import { TONE_ALIAS, NODE_KIND_ALIAS, DIRECTIONS, resolveDirection, PALETTES, resolvePalette } from "../keywords";
-import type { DslPalette } from "../keywords";
+import {
+  TONE_ALIAS,
+  NODE_KIND_ALIAS,
+  DIRECTIONS,
+  resolveDirection,
+  ORDERS,
+  resolveOrder,
+  SHAPES,
+  DIAGRAM_SHAPES,
+  resolveDiagramShape,
+  shapesForDiagramType,
+  THEMES,
+  THEME_ALIAS,
+  resolveTheme,
+  LEGEND_MARK_ALIAS,
+  resolveLegendMark,
+} from "../keywords";
+import { 区画 } from "../compile/word-state";
+// 行頭の印の古い語の読み替え (#2782)。 印を作る側と同じ file が表を持つ = 縦に並べた形と
+// 中括弧の形と JSON の 3 経路が同じ表を通る
+import { 行頭の語へ読み替える } from "../compile/row-marks";
+import { PHASE_BODY_KEYS } from "../keywords";
+import type { DslTheme } from "../keywords";
 import type { DslDirection } from "../keywords";
+import type { DslOrder } from "../keywords";
+import type { DslDiagramShape, DslShape } from "../keywords";
 import { parseRelativePos, findRelativeProblems, type RelativeProblem } from "../relative-pos";
+
+/** #2854 で記法に足した図表欄の閉じた語。JSON / schema と共有する。 */
+export const CHART_LINE_DASH_VALUES = ["solid", "dotted"] as const;
+export const CHART_LINE_MARKER_VALUES = ["dot", "hollow", "none"] as const;
+export const CHART_PIE_TABLE_COLUMN_VALUES = ["share-value", "value"] as const;
+export const CHART_PIE_RING_WIDTH_VALUES = ["thick", "thin"] as const;
+export const CHART_STACKED_LEGEND_POSITION_VALUES = ["top", "bottom"] as const;
+export const CHART_WAFFLE_LEGEND_POSITION_VALUES = ["left", "right"] as const;
+export const FUNNEL_FORM_VALUES = ["trapezoid", "proportional-bars"] as const;
+export const FUNNEL_RATE_VALUES = ["drop", "conversion", "none"] as const;
+export const QUADRANT_POINT_LABEL_SIDE_VALUES = ["auto", "right"] as const;
+export const TREE_NODE_FORM_VALUES = ["accent", "frame"] as const;
+export const TREE_EDGE_TONE_VALUES = ["accent", "depth"] as const;
+export const TREE_EDGE_HEAD_VALUES = ["none", "triangle"] as const;
+export const MIND_FORM_VALUES = ["filled", "outline"] as const;
+export const JOURNEY_FORM_VALUES = ["bands", "rules"] as const;
+export const JOURNEY_LINE_FORM_VALUES = ["curve", "straight"] as const;
+export const JOURNEY_OPPORTUNITY_POSITION_VALUES = ["below-chart", "below-point"] as const;
+export const JOURNEY_LABEL_KEYS = ["delighted", "happy", "neutral", "frustrated", "angry"] as const;
+export const CORNER_FORM_VALUES = ["theme-variants"] as const;
+export const CHART_BAR_SHAPE_VALUES = ["split", "top-rounded"] as const;
+export const QUADRANT_LABEL_POSITION_VALUES = ["outside-corners"] as const;
+export const LABEL_COLLISION_VALUES = ["auto", "author"] as const;
+export const GANTT_TASK_LABEL_ALIGN_VALUES = ["start", "end"] as const;
+const TREE_SIZE_KEYS = [
+  "nodeWidths",
+  "nodeHeight",
+  "titleFontSize",
+  "subtitleFontSize",
+  "siblingGap",
+  "levelGap",
+] as const;
+const MIND_SIZE_KEYS = [
+  "contentOffset",
+  "root",
+  "branch",
+  "leaf",
+  "rootBranchGap",
+  "branchLeafGap",
+  "branchRowGap",
+  "branchRowOffset",
+  "leafRowGap",
+  "leafRowOffset",
+] as const;
 import {
   checkValueExpression,
   isTriggerBody,
@@ -57,7 +146,9 @@ import {
 } from "../value-syntax";
 import type {
   DslAxes,
+  DslRegions,
   DslDocument,
+  DslStageHeader,
   DslActor,
   DslNodeKind,
   DslDynShape,
@@ -97,6 +188,110 @@ export const EDGE_HEAD_VALUES: readonly string[] = EDGE_HEADS;
 /** 端の印の塗り方 (#1466)。 描画側の一覧から導く = 描画側が増やせば書ける */
 export const EDGE_HEAD_FILL_VALUES: readonly string[] = EDGE_HEAD_FILLS;
 
+/** cdl 0.130.0 の共通部品箱へ描ける線画。 */
+export const CDL_ICON_VALUES = ["person", "box", "database", "lightning", "cloud", "terminal"] as const satisfies readonly NonNullable<DslActor["icon"]>[];
+
+/** cdl 0.130.0 の表・部品箱と順序図が受ける閉じた値。 */
+export const KIND_FORM_VALUES = ["icon"] as const;
+export const TITLE_ALIGN_VALUES = ["center"] as const;
+export const ROW_MARK_FORM_VALUES = ["tone"] as const;
+export const ROW_MARK_TONE_VALUES = ["primary", "muted"] as const;
+export const ROW_DIVIDER_FORM_VALUES = ["full"] as const;
+export const SEQUENCE_SELF_LOOP_FORM_VALUES = ["orthogonal"] as const;
+export const SEQUENCE_ACTOR_FORM_VALUES = ["box"] as const;
+export const SEQUENCE_LABEL_FORM_VALUES = ["kind"] as const;
+export const SEQUENCE_RETURN_HEAD_VALUES = ["solid"] as const;
+export const SEQUENCE_KIND_LABEL_KEYS = ["call", "return", "fire"] as const;
+export const SEQUENCE_SELF_LOOP_KEYS = ["form", "width", "drop"] as const;
+export const ROW_WELL_KEYS = ["top", "right", "bottom", "left", "radius"] as const;
+export const ROW_LAYOUT_KEYS = ["titleBaseline", "rowTop", "rowPitch"] as const;
+export const LEGEND_LINE_STYLE_VALUES = ["solid", "dotted"] as const;
+export const LEGEND_NOTE_ALIGN_VALUES = ["start", "end"] as const;
+
+/** 表の行の受け皿を閉じた object として読み、寸法を 0 以上に限る。 */
+function 行の受け皿として読む(
+  raw: string | undefined,
+  line: number,
+  errors: DslError[],
+): DslActor["rowWell"] {
+  const value = JSONの欄を読む(raw ?? null, "rowWell", line, errors);
+  const unknown = 図表の知らない項目を知らせる(
+    value,
+    ROW_WELL_KEYS,
+    "rowWell",
+    line,
+    errors,
+  );
+  if (unknown || value === undefined) return undefined;
+  if (!objectか(value)) {
+    errors.push({ line, message: "rowWell の値の形が読めません" });
+    return undefined;
+  }
+  for (const key of ROW_WELL_KEYS) {
+    const item = value[key];
+    if (item !== undefined && (typeof item !== "number" || !Number.isFinite(item) || item < 0)) {
+      errors.push({ line, message: `rowWell.${key} が読めません`, hint: "0 以上の数で書く" });
+      return undefined;
+    }
+  }
+  return value;
+}
+
+/** 表の題と行の baseline を閉じた object として読む。 */
+function 行の配置として読む(
+  raw: string | undefined,
+  line: number,
+  errors: DslError[],
+): DslActor["rowLayout"] {
+  const value = JSONの欄を読む(raw ?? null, "rowLayout", line, errors);
+  const unknown = 図表の知らない項目を知らせる(value, ROW_LAYOUT_KEYS, "rowLayout", line, errors);
+  if (unknown || value === undefined) return undefined;
+  if (!objectか(value)) {
+    errors.push({ line, message: "rowLayout の値の形が読めません" });
+    return undefined;
+  }
+  for (const key of ROW_LAYOUT_KEYS) {
+    const item = value[key];
+    const valid = typeof item === "number" && Number.isFinite(item) &&
+      (key === "rowPitch" ? item > 0 : item >= 0);
+    if (item !== undefined && !valid) {
+      errors.push({ line, message: `rowLayout.${key} が読めません`, hint: key === "rowPitch" ? "正の数で書く" : "0 以上の数で書く" });
+      return undefined;
+    }
+  }
+  return value;
+}
+
+/** 固定線の途中の点を読み、始点から終点までの各区間を直角に限る。 */
+function 線の途中の点として読む(
+  raw: string | undefined,
+  ends: readonly [number | undefined, number | undefined, number | undefined, number | undefined],
+  line: number,
+  errors: DslError[],
+): DslStep["waypoints"] {
+  if (raw === undefined) return undefined;
+  const value = JSONの欄を読む(raw ?? null, "waypoints", line, errors);
+  if (value === undefined) return undefined;
+  if (Array.isArray(value)) {
+    const unknown = value.some((point, index) =>
+      図表の知らない項目を知らせる(point, ["x", "y"], `waypoints[${index}]`, line, errors));
+    if (unknown) return undefined;
+  }
+  if (!Array.isArray(value) || value.some((point) => !objectか(point) || typeof point.x !== "number" || !Number.isFinite(point.x) || typeof point.y !== "number" || !Number.isFinite(point.y))) {
+    errors.push({ line, message: "waypoints の値の形が読めません", hint: '`[{"x":232,"y":293.45}]` の形で書く' });
+    return undefined;
+  }
+  const [x1, y1, x2, y2] = ends;
+  if ([x1, y1, x2, y2].every((item) => item !== undefined)) {
+    const points = [{ x: x1!, y: y1! }, ...value, { x: x2!, y: y2! }];
+    if (points.some((point, index) => index > 0 && point.x !== points[index - 1]!.x && point.y !== points[index - 1]!.y)) {
+      errors.push({ line, message: "waypoints の各区間は縦か横にする" });
+      return undefined;
+    }
+  }
+  return value;
+}
+
 /**
  * 辺の役目として書ける語 (#1559)。
  *
@@ -114,7 +309,7 @@ export const EDGE_ROLE_VALUES = ["main"] as const;
 export const SHAPE_ORIENT_VALUES = ["up", "down", "left", "right"] as const;
 
 /**
- * クラス図の関係の種類 (#1466)。 描画側の表 (`CLASS_RELATION_LOOK`) の key から導く。
+ * record に書ける UML の関係の種類 (#1466 / #2783)。描画側の表 (`CLASS_RELATION_LOOK`) の key から導く。
  *
  * 手で並べると、描画側が種類を足した時にここだけ取り残されて書けないままになる。
  */
@@ -145,6 +340,8 @@ export const TOP_LEVEL_KEYS = [
   "eyebrow",
   // 2 軸で仕分ける図の軸の名前 (#1251)
   "axes",
+  // 2 軸で仕分ける図の区画の名前 (#2667)
+  "regions",
   // 値を見せる部品 (#1374)
   "readouts",
   // 読む人が動かすつまみ (#1389)
@@ -173,24 +370,110 @@ export const TOP_LEVEL_KEYS = [
    */
   "direction",
   /*
-   * 図の配色 (#1553)。
+   * 箱を並べる順 (#2655)。 並べ替えの鍵しか持たない図種を畳んだ先で、書かなければ
+   * 書いた順のまま。 最上位の語は英語にする決まりに従う (向きの語と同じ)
+   */
+  "order",
+  /*
+   * 数を描く図の形 (#2657)。 形しか違わない図種 9 つを畳んだ先で、`type: chart` だけが読む。
+   * 最上位の語は英語にする決まりに従う (向きの語と同じ)
+   */
+  "shape",
+  // 円グラフの見せ方 (#2837)
+  "form",
+  // ガントチャートの目盛り (#2837)
+  "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",
+  /*
+   * 図の意匠 (#1553 / #2790)。
    *
    * cdl は色を持たないので、名前だけを図に載せる。 消費側 (`cdl-theme.css`) が名前を見て
    * 7 つの口 (台 / 行の面 / 縞 / 枠 / 字 / 型名 / 線) に色を当てる。
    *
-   * ER 図とクラス図は書かなくても `kinari` (生成りに茶) になる。 どちらも箱の作りが同じ
-   * (行頭の印 + 左に名前 + 右に型) で、名前と型が離れて並ぶため、行を横に追う目印
-   * (行の縞) が要る。 縞の色は配色からしか来ないので、既定が無いと縞が箱の面と同じ色に
-   * 落ちて 1 本も出ない。 書き手が `palette:` を書いた時はそちらが勝つ。
+   * 意匠は dragon で読み、cdl へは `palette` として渡す。
    */
-  "palette",
+  "theme",
+  "legend",
+  "legendOffset",
+  "legendFontSize",
+  "edgeEndGap",
+  "stageHeader",
 ] as const;
 
+/**
+ * 最上位の語の別名 (#2790)。
+ *
+ * 一覧は正の語だけを持つ。 README と変更履歴の検査が一覧を読むため、別名を混ぜると
+ * 公開する正の語が 2 つに見える。
+ */
+export const TOP_LEVEL_KEY_ALIASES: ReadonlyMap<string, (typeof TOP_LEVEL_KEYS)[number]> = new Map([
+  ["palette", "theme"],
+  ["凡例", "legend"],
+  ["見せ方", "form"],
+  ["目盛り", "ticks"],
+]);
+
 /**
  * `lanes:` / `groups:` の 1 行を読む形 (#1241)。
  *
  * **id は英数字と下線に限らない**。 組み立て側は登場人物の名前から縦列 id を作るため、
- * hyphen と日本語が入る (実測 = `type: state` で `lane-idle` / `lane-待機`、
+ * hyphen と日本語が入る (実測 = `type: record` で `lane-idle` / `lane-待機`、
  * `type: swimlane` で `lane-sign-up`)。 英数字と下線だけを受けていた間、
  * **自動で作られた縦列の幅や見出しを書き直す手段が無かった**。
  *
@@ -308,22 +591,12 @@ function isTopLevelKey(key: string): key is (typeof TOP_LEVEL_KEYS)[number] {
 export const PRESET_TYPES: ReadonlySet<PresetType> = new Set([
   "sequence",
   "flow",
+  "flowchart",
   "swimlane",
-  "er",
-  "state",
+  "record",
   "topology",
-  "solidity",
   "gantt",
-  "class",
-  "pie",
-  "bar",
-  "line",
-  "gauge",
-  "radial",
-  "stat",
-  "waffle",
-  "stacked",
-  "slope",
+  "chart",
   "funnel",
   "tree",
   "journey",
@@ -332,6 +605,41 @@ export const PRESET_TYPES: ReadonlySet<PresetType> = new Set([
   "mind",
 ]);
 
+/**
+ * 図種の別名 (#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 };
+
+export const TYPE_ALIASES: ReadonlyMap<string, 読み替え先> = new Map<string, 読み替え先>([
+  ["solidity", { type: "sequence", order: "種類" }],
+  ...SHAPES.map((s): [string, 読み替え先] => [s, { type: "chart", shape: s }]),
+]);
+
+/** `shape:` の綴り違いへ、図種ごとに書ける語を案内する (#2797)。 */
+function shapeの案内(type: PresetType | null): string {
+  const その図種 = type === null ? [] : shapesForDiagramType(type);
+  if (その図種.length > 0) return `使える語 = ${その図種.join(" / ")}`;
+  return `shape を書ける図種と語 = ${Object.entries(DIAGRAM_SHAPES)
+    .map(([図種, 語]) => `type: ${図種} (${語.join(" / ")})`)
+    .join(" / ")}`;
+}
+
 const NODE_KIND_DEFAULT: NodeKind = "actor";
 
 /**
@@ -353,6 +661,10 @@ export const DSL_ONLY_KINDS = [
   "proxy",
   "library",
   "interface",
+  // 繰り返しの箱 (#2523)。 描画側は分かれ道の図の形としてだけ持ち、種類としては持たないため
+  // ここに置く。 分かれ道の図では形に読み替わり (`compile/flowchart.ts`)、それ以外の図種では
+  // `記法だけの種類の読み替え` が札に落とす
+  "loop",
 ] as const;
 
 /** 記法だけが持つ種類。 描画側の `NodeKind` には含まれない */
@@ -459,6 +771,20 @@ type Line = {
   no: number;
 };
 
+/**
+ * 読めなかった最上位の項目名を、行から取り出す (#2341)。
+ *
+ * **行ではなく名前だけを引用する**。 行をまるごと引用すると、値に引用符がある時に
+ * `"題: "t""` のように入れ子になって、どこまでが名前か読めない (実測)。
+ *
+ * 箱 / 矢印 / 縦列の読めない項目名はどれも名前だけを引用しており、最上位だけが
+ * 揃っていなかった。 `:` を持たない行はそのまま返す = その時は行全体が名前の位置にある。
+ */
+function 最上位の項目名(trimmed: string): string {
+  const idx = trimmed.indexOf(":");
+  return (idx < 0 ? trimmed : trimmed.slice(0, idx)).trim();
+}
+
 export function parseTextDslV05(src: string): V05ParseResult {
   const errors: DslError[] = [];
   const lines = tokenize(src);
@@ -471,9 +797,79 @@ export function parseTextDslV05(src: string): V05ParseResult {
   let relations: RelationFocus | null = null;
   let direction: DslDirection | null = null;
   let directionLine = 0;
-  let palette: DslPalette | null = null;
+  let order: DslOrder | null = null;
+  let orderLine = 0;
+  // `shape:` は `type:` より前にも書ける。 図種が決まるまで語と行だけを控える (#2797)。
+  let shapeWritten: { value: string; line: number } | null = null;
+  let formWritten: { value: string; line: number } | null = null;
+  let ticks: string[] | undefined;
+  let ticksLine = 0;
+  let ganttToday: DslDocument["ganttToday"];
+  let ganttTickLabels: string[] | undefined;
+  let ganttBarEnd: DslDocument["ganttBarEnd"];
+  let ganttBarThickness: DslDocument["ganttBarThickness"];
+  let chartSeriesSkipMuted: DslDocument["chartSeriesSkipMuted"];
+  let chartLineSeries: DslDocument["chartLineSeries"];
+  let chartPieCenterLabel: DslDocument["chartPieCenterLabel"];
+  let chartPieTableColumns: DslDocument["chartPieTableColumns"];
+  let chartPieRingWidth: DslDocument["chartPieRingWidth"];
+  let chartSlopePeriods: DslDocument["chartSlopePeriods"];
+  let chartSlopeEmphasisIds: DslDocument["chartSlopeEmphasisIds"];
+  let chartSlopeUnit: DslDocument["chartSlopeUnit"];
+  let chartStackedPeriods: DslDocument["chartStackedPeriods"];
+  let chartStackedRateId: DslDocument["chartStackedRateId"];
+  let chartStackedLegendPosition: DslDocument["chartStackedLegendPosition"];
+  let chartGaugeValue: DslDocument["chartGaugeValue"];
+  let chartWaffleLegendPosition: DslDocument["chartWaffleLegendPosition"];
+  let funnelForm: DslDocument["funnelForm"];
+  let funnelRate: DslDocument["funnelRate"];
+  let quadrantPointLabelSide: DslDocument["quadrantPointLabelSide"];
+  let treeNodeForm: DslDocument["treeNodeForm"];
+  let treeSize: DslDocument["treeSize"];
+  let treeEdgeTone: DslDocument["treeEdgeTone"];
+  let treeEdgeHead: DslDocument["treeEdgeHead"];
+  let mindForm: DslDocument["mindForm"];
+  let mindSize: DslDocument["mindSize"];
+  let journeyForm: DslDocument["journeyForm"];
+  let journeyLineForm: DslDocument["journeyLineForm"];
+  let journeyLabels: DslDocument["journeyLabels"];
+  let journeySize: DslDocument["journeySize"];
+  let sequenceActorForm: DslDocument["sequenceActorForm"];
+  let sequenceLabelForm: DslDocument["sequenceLabelForm"];
+  let sequenceReturnHead: DslDocument["sequenceReturnHead"];
+  let sequenceKindLabels: DslDocument["sequenceKindLabels"];
+  let sequenceRowGap: DslDocument["sequenceRowGap"];
+  let sequenceGutter: DslDocument["sequenceGutter"];
+  let sequenceBandWidth: DslDocument["sequenceBandWidth"];
+  let sequenceSelfLoop: DslDocument["sequenceSelfLoop"];
+  let figureCard: DslDocument["figureCard"];
+  let figureSize: DslDocument["figureSize"];
+  let terminalDecoration: DslDocument["terminalDecoration"];
+  let cornerForm: DslDocument["cornerForm"];
+  let figureKindLabel: DslDocument["figureKindLabel"];
+  let figureInset: DslDocument["figureInset"];
+  let chartBarSize: DslDocument["chartBarSize"];
+  let chartBarShape: DslDocument["chartBarShape"];
+  let chartLineSize: DslDocument["chartLineSize"];
+  let chartPieSize: DslDocument["chartPieSize"];
+  let chartWaffleSize: DslDocument["chartWaffleSize"];
+  let chartSlopeLabelTemplate: DslDocument["chartSlopeLabelTemplate"];
+  let chartSlopeSize: DslDocument["chartSlopeSize"];
+  let chartStackedLayout: DslDocument["chartStackedLayout"];
+  let chartGaugeSize: DslDocument["chartGaugeSize"];
+  let ganttSize: DslDocument["ganttSize"];
+  let quadrantLabelPosition: DslDocument["quadrantLabelPosition"];
+  let quadrantSize: DslDocument["quadrantSize"];
+  let stageLayout: DslDocument["stageLayout"];
+  let aliasShape: DslShape | null = null;
+  let aliasShapeLine = 0;
+  let theme: DslTheme | null = null;
+  let themeLine = 0;
+  let palette: DslTheme | null = null;
+  let paletteLine = 0;
   let axes: DslAxes | undefined = undefined;
   let axesLine = 0;
+  let regions: DslRegions | undefined = undefined;
   let actors: DslActor[] = [];
   const flow: DslStep[] = [];
   let animate: DslAnimate | undefined = undefined;
@@ -489,6 +885,11 @@ export function parseTextDslV05(src: string): V05ParseResult {
   let scrollsList: DslScrollTrigger[] | undefined = undefined;
   let scrollLines = new Map<string, number>();
   let groupsMap: Record<string, DslGroup> | undefined = undefined;
+  const legend: CdlLegendItem[] = [];
+  let legendOffset: DslDocument["legendOffset"];
+  let legendFontSize: number | undefined;
+  let edgeEndGap: DslDocument["edgeEndGap"];
+  let stageHeader: DslDocument["stageHeader"];
 
   let i = 0;
   while (i < lines.length) {
@@ -497,12 +898,18 @@ export function parseTextDslV05(src: string): V05ParseResult {
       i += 1;
       continue;
     }
-    const head = matchTopHeader(line.trimmed);
+    const 書いた頭 = matchTopHeader(line.trimmed);
+    const head = 書いた頭
+      ? {
+          ...書いた頭,
+          key: TOP_LEVEL_KEY_ALIASES.get(書いた頭.key) ?? 書いた頭.key,
+        }
+      : null;
     if (!head || !isTopLevelKey(head.key)) {
       errors.push({
         line: line.no,
-        message: `unknown top-level key: "${line.trimmed}"`,
-        hint: `expected one of: ${TOP_LEVEL_KEYS.join(", ")}`,
+        message: `最上位の項目名が読めません: "${最上位の項目名(line.trimmed)}"`,
+        hint: `使える項目 = ${TOP_LEVEL_KEYS.join(", ")}`,
       });
       i += 1;
       continue;
@@ -510,7 +917,11 @@ export function parseTextDslV05(src: string): V05ParseResult {
     if (head.key === "title") {
       title = head.value ?? null;
       if (!title) {
-        errors.push({ line: line.no, message: "title is required", hint: 'use `title: "..."`' });
+        errors.push({
+          line: line.no,
+          message: "title が書かれていません",
+          hint: "`title: \"...\"` の形で書く",
+        });
       }
       i += 1;
       continue;
@@ -542,7 +953,7 @@ export function parseTextDslV05(src: string): V05ParseResult {
       /*
        * 箱に触れると関係する線だけを光らせるか (#1757)。
        *
-       * クラス図と ER 図は順番を持たない図で、段を追う見せ方は読み手の問い
+       * UML や表の関係を描く record は順番を持たない図で、段を追う見せ方は読み手の問い
        * (この箱はどこと繋がっているか) に答えない。 `hover` と書くと、箱に触れた時に
        * その箱 ・ 繋がる線 ・ 相手の箱だけが光る (`cdl#806`)。
        */
@@ -587,29 +998,134 @@ export function parseTextDslV05(src: string): V05ParseResult {
       i += 1;
       continue;
     }
-    if (head.key === "palette") {
+    if (head.key === "order") {
+      /*
+       * 箱を並べる順 (#2655)。
+       *
+       * 書かなければ書いた順。 `種類` と書くと箱の種類で並べ替えてから置く。
+       * 向きと同じく **書いた行を覚える** = 効かない図種に書いた時の知らせが場所を指せる。
+       */
+      const v = (head.value ?? "").trim();
+      if (v.length > 0) {
+        const 解けた = resolveOrder(v);
+        if (解けた !== null) {
+          order = 解けた;
+          orderLine = line.no;
+        } else {
+          errors.push({
+            line: line.no,
+            message: `order が読めません (書いた値: ${v})`,
+            hint: `使える語 = ${ORDERS.join(" / ")} / kind`,
+          });
+        }
+      }
+      i += 1;
+      continue;
+    }
+    if (head.key === "theme") {
       /*
-       * 図の配色 (#1553)。
+       * 図の意匠 (#1553 / #2790)。
        *
        * 読めない語はその場で知らせる。 黙って既定に落とすと、書き手には「書いたのに効かない」
        * としか見えず、書き間違いか未対応かを分けられない。
        */
       const v = (head.value ?? "").trim();
+      const 書いた語 = 書いた頭?.key ?? head.key;
       if (v.length > 0) {
-        const 解けた = resolvePalette(v);
+        const 解けた = resolveTheme(v);
         if (解けた !== null) {
-          palette = 解けた;
+          if (書いた語 === "theme") {
+            theme = 解けた;
+            themeLine = line.no;
+          } else {
+            palette = 解けた;
+            paletteLine = line.no;
+          }
         } else {
           errors.push({
             line: line.no,
-            message: `palette が読めません (書いた値: ${v})`,
-            hint: `使える語 = ${PALETTES.join(" / ")} / 生成り / 青磁`,
+            message: `${書いた語} が読めません (書いた値: ${v}。 使える名前 = ${THEMES.join(" / ")})`,
+            hint: `使える語 = ${Object.keys(THEME_ALIAS).join(" / ")}`,
           });
         }
       }
       i += 1;
       continue;
     }
+    if (head.key === "legend") {
+      const inline = head.value?.trim();
+      if (inline) {
+        errors.push({
+          line: line.no,
+          message: "legend は 1 行にまとめて書けない",
+          hint: '`legend:` の次の行から `{ mark: diamond, text: "分かれ道" }` の形で並べる',
+        });
+        i += 1;
+        continue;
+      }
+      const { items, next } = collectIndentedList(lines, i + 1, line.indent);
+      for (const item of items) {
+        const parsed = parseLegendItem(item, errors);
+        if (parsed !== null) legend.push(parsed);
+      }
+      i = next;
+      continue;
+    }
+    if (head.key === "legendFontSize") {
+      const value = Number((head.value ?? "").trim());
+      if (Number.isFinite(value) && value > 0) legendFontSize = value;
+      else {
+        errors.push({
+          line: line.no,
+          message: `legendFontSize が読めません: "${head.value ?? ""}"`,
+          hint: "0 より大きい数を書く",
+        });
+      }
+      i += 1;
+      continue;
+    }
+    if (head.key === "edgeEndGap") {
+      const written = (head.value ?? "").trim();
+      const value = Number(written);
+      if (written !== "" && Number.isFinite(value) && value >= 0) edgeEndGap = value;
+      else {
+        errors.push({
+          line: line.no,
+          message: `edgeEndGap が読めません: "${head.value ?? ""}"`,
+          hint: "0 以上の数を書く",
+        });
+      }
+      i += 1;
+      continue;
+    }
+    if (head.key === "stageHeader") {
+      const written = (head.value ?? "").trim();
+      const isInlineMapping = written.startsWith("{") && written.endsWith("}");
+      const inner = isInlineMapping ? written.slice(1, -1) : "";
+      const opts = parseInlineMapping(inner);
+      const keys = ["leftPad", "topPad", "numberSize", "gap", "nameSize", "bottomPad"] as const;
+      if (isInlineMapping) {
+        中括弧の知らない項目名を知らせる(inner, keys, "段の見出しの ", line.no, errors);
+      }
+      const values = Object.fromEntries(
+        keys.map((key) => [key, opts[key] === undefined ? undefined : Number(opts[key])]),
+      ) as Record<(typeof keys)[number], number | undefined>;
+      const required = ["topPad", "numberSize", "gap", "nameSize", "bottomPad"] as const;
+      if (
+        required.some((key) => !Number.isFinite(values[key])) ||
+        (values.leftPad !== undefined && !Number.isFinite(values.leftPad))
+      ) {
+        errors.push({
+          line: line.no,
+          message: "段の見出しの寸法が読めません",
+          hint: "{ leftPad: 26, topPad: 20, numberSize: 16, gap: 10, nameSize: 29, bottomPad: 12 } の形で書く",
+        });
+      } else {
+        stageHeader = values as DslStageHeader;
+      }
+      i += 1;
+      continue;
+    }
     if (head.key === "eyebrow") {
       // 空で書いた形 (`eyebrow:`) は「書かなかった」 と同じにする。 空文字を残すと
       // 描画側が中身のない帯を出す
@@ -619,13 +1135,392 @@ export function parseTextDslV05(src: string): V05ParseResult {
       i += 1;
       continue;
     }
+    if (head.key === "shape") {
+      /*
+       * 数を描く図の形 (#2657)。
+       *
+       * 並べ替えの語と同じ形にする。 **書いた行を覚える** = 効かない図種に書いた時の
+       * 知らせが場所を指せる。
+       */
+      const v = (head.value ?? "").trim();
+      if (v.length > 0) {
+        shapeWritten = { value: v, line: line.no };
+      }
+      i += 1;
+      continue;
+    }
+    if (head.key === "form") {
+      const v = stripQuotes((head.value ?? "").trim());
+      if (v.length > 0) formWritten = { value: v, line: line.no };
+      i += 1;
+      continue;
+    }
+    if (head.key === "ticks") {
+      const raw = (head.value ?? "").trim();
+      if (!raw.startsWith("[") || !raw.endsWith("]")) {
+        errors.push({
+          line: line.no,
+          message: `ticks の書き方が読めません: "${raw}"`,
+          hint: "`ticks: [6月, 7月, 8月]` の形で書く",
+        });
+      } else {
+        const values = splitTopLevelCommas(raw.slice(1, -1))
+          .map((value) => stripQuotes(value.trim()))
+          .filter((value) => value.length > 0);
+        if (values.length === 0) {
+          errors.push({
+            line: line.no,
+            message: "ticks に目盛りがありません",
+            hint: "`ticks: [6月, 7月, 8月]` の形で 1 つ以上書く",
+          });
+        } else {
+          ticks = values;
+          ticksLine = line.no;
+        }
+      }
+      i += 1;
+      continue;
+    }
+    if (head.key === "ganttToday") {
+      const raw = (head.value ?? "").trim();
+      if (raw.startsWith("{") && raw.endsWith("}")) {
+        中括弧の知らない項目名を知らせる(
+          raw.slice(1, -1),
+          ["index", "label"],
+          "ganttToday の ",
+          line.no,
+          errors,
+        );
+      }
+      const inner = raw.startsWith("{") && raw.endsWith("}")
+        ? parseInlineMapping(raw.slice(1, -1))
+        : {};
+      const index = Number(inner.index);
+      const label = inner.label === undefined ? undefined : stripQuotes(inner.label);
+      if (!Number.isFinite(index) || label === undefined) {
+        errors.push({
+          line: line.no,
+          message: `ganttToday の書き方が読めません: "${raw}"`,
+          hint: '`ganttToday: { index: 3.3, label: "今日" }` の形で書く',
+        });
+      } else {
+        ganttToday = { index, label };
+      }
+      i += 1;
+      continue;
+    }
+    if (head.key === "ganttTickLabels") {
+      const raw = (head.value ?? "").trim();
+      const values = raw.startsWith("[") && raw.endsWith("]")
+        ? splitTopLevelCommas(raw.slice(1, -1)).map((value) => stripQuotes(value.trim()))
+        : [];
+      if (values.length === 0 || values.some((value) => value.length === 0)) {
+        errors.push({
+          line: line.no,
+          message: `ganttTickLabels の書き方が読めません: "${raw}"`,
+          hint: "`ganttTickLabels: [6月, 7月, 8月]` の形で 1 つ以上書く",
+        });
+      } else {
+        ganttTickLabels = values;
+      }
+      i += 1;
+      continue;
+    }
+    if (head.key === "ganttBarEnd") {
+      const value = stripQuotes((head.value ?? "").trim());
+      if (value === "position") ganttBarEnd = value;
+      else errors.push({ line: line.no, message: `ganttBarEnd が読めません: "${value}"`, hint: "使える値 = position" });
+      i += 1;
+      continue;
+    }
+    if (head.key === "ganttBarThickness") {
+      const value = stripQuotes((head.value ?? "").trim());
+      if (value === "thin") ganttBarThickness = value;
+      else errors.push({ line: line.no, message: `ganttBarThickness が読めません: "${value}"`, hint: "使える値 = thin" });
+      i += 1;
+      continue;
+    }
+    if (head.key === "chartSeriesSkipMuted") {
+      const value = stripQuotes((head.value ?? "").trim());
+      if (value === "true") chartSeriesSkipMuted = true;
+      else errors.push({ line: line.no, message: `chartSeriesSkipMuted が読めません: "${value}"`, hint: "使える値 = true" });
+      i += 1;
+      continue;
+    }
+    if (head.key === "chartLineSeries") {
+      const value = JSONの欄を読む(head.value, "chartLineSeries", line.no, errors);
+      const unknown = chartLineSeriesの知らない項目を知らせる(value, line.no, errors);
+      if (!unknown && chartLineSeriesの形(value)) chartLineSeries = value;
+      else if (value !== undefined) errors.push({ line: line.no, message: "chartLineSeries の系列または点の形が読めません" });
+      i += 1;
+      continue;
+    }
+    if (head.key === "chartStackedPeriods") {
+      const value = JSONの欄を読む(head.value, "chartStackedPeriods", line.no, errors);
+      const unknown = chartStackedPeriodsの知らない項目を知らせる(value, line.no, errors);
+      if (!unknown && chartStackedPeriodsの形(value)) chartStackedPeriods = value;
+      else if (value !== undefined) errors.push({ line: line.no, message: "chartStackedPeriods の期間または値の形が読めません" });
+      i += 1;
+      continue;
+    }
+    if (head.key === "chartGaugeValue") {
+      const value = JSONの欄を読む(head.value, "chartGaugeValue", line.no, errors);
+      const unknown = chartGaugeValueの知らない項目を知らせる(value, line.no, errors);
+      if (!unknown && chartGaugeValueの形(value)) chartGaugeValue = value;
+      else if (value !== undefined) errors.push({ line: line.no, message: "chartGaugeValue の値の形が読めません" });
+      i += 1;
+      continue;
+    }
+    if (head.key === "chartSlopePeriods" || head.key === "chartSlopeEmphasisIds") {
+      const raw = (head.value ?? "").trim();
+      const values = raw.startsWith("[") && raw.endsWith("]")
+        ? splitTopLevelCommas(raw.slice(1, -1)).map((value) => stripQuotes(value.trim()))
+        : [];
+      if (values.length === 0 || values.some((value) => value.length === 0)) {
+        errors.push({ line: line.no, message: `${head.key} の書き方が読めません`, hint: `${head.key}: ["先月", "今月"] の形で書く` });
+      } else if (head.key === "chartSlopePeriods") {
+        if (values.length === 2) chartSlopePeriods = [values[0]!, values[1]!];
+        else errors.push({ line: line.no, message: "chartSlopePeriods は時点名を 2 つ書く" });
+      } else chartSlopeEmphasisIds = values;
+      i += 1;
+      continue;
+    }
+    if (head.key === "chartPieCenterLabel" || head.key === "chartSlopeUnit" || head.key === "chartStackedRateId") {
+      const value = stripQuotes((head.value ?? "").trim());
+      if (head.key === "chartPieCenterLabel") chartPieCenterLabel = value;
+      else if (head.key === "chartSlopeUnit") chartSlopeUnit = value;
+      else chartStackedRateId = value;
+      i += 1;
+      continue;
+    }
+    if (head.key === "chartPieTableColumns") {
+      const value = stripQuotes((head.value ?? "").trim());
+      if ((CHART_PIE_TABLE_COLUMN_VALUES as readonly string[]).includes(value)) chartPieTableColumns = value as typeof chartPieTableColumns;
+      else errors.push({ line: line.no, message: `chartPieTableColumns が読めません: "${value}"`, hint: `使える値 = ${CHART_PIE_TABLE_COLUMN_VALUES.join(", ")}` });
+      i += 1;
+      continue;
+    }
+    if (head.key === "chartPieRingWidth") {
+      const value = stripQuotes((head.value ?? "").trim());
+      if ((CHART_PIE_RING_WIDTH_VALUES as readonly string[]).includes(value)) chartPieRingWidth = value as typeof chartPieRingWidth;
+      else errors.push({ line: line.no, message: `chartPieRingWidth が読めません: "${value}"`, hint: `使える値 = ${CHART_PIE_RING_WIDTH_VALUES.join(", ")}` });
+      i += 1;
+      continue;
+    }
+    if (head.key === "chartStackedLegendPosition") {
+      const value = stripQuotes((head.value ?? "").trim());
+      if ((CHART_STACKED_LEGEND_POSITION_VALUES as readonly string[]).includes(value)) chartStackedLegendPosition = value as typeof chartStackedLegendPosition;
+      else errors.push({ line: line.no, message: `chartStackedLegendPosition が読めません: "${value}"`, hint: `使える値 = ${CHART_STACKED_LEGEND_POSITION_VALUES.join(", ")}` });
+      i += 1;
+      continue;
+    }
+    if (
+      head.key === "sequenceActorForm" || head.key === "sequenceLabelForm" ||
+      head.key === "sequenceReturnHead"
+    ) {
+      const value = stripQuotes((head.value ?? "").trim());
+      const values = head.key === "sequenceActorForm"
+        ? SEQUENCE_ACTOR_FORM_VALUES
+        : head.key === "sequenceLabelForm" ? SEQUENCE_LABEL_FORM_VALUES : SEQUENCE_RETURN_HEAD_VALUES;
+      if ((values as readonly string[]).includes(value)) {
+        if (head.key === "sequenceActorForm") sequenceActorForm = value as "box";
+        else if (head.key === "sequenceLabelForm") sequenceLabelForm = value as "kind";
+        else sequenceReturnHead = value as "solid";
+      } else errors.push({ line: line.no, message: `${head.key} が読めません: "${value}"`, hint: `使える値 = ${values.join(", ")}` });
+      i += 1;
+      continue;
+    }
+    if (head.key === "sequenceKindLabels") {
+      const value = JSONの欄を読む(head.value, head.key, line.no, errors);
+      const unknown = 図表の知らない項目を知らせる(value, SEQUENCE_KIND_LABEL_KEYS, head.key, line.no, errors);
+      if (!unknown && objectか(value) && Object.values(value).every((label) => typeof label === "string")) {
+        sequenceKindLabels = value;
+      } else if (value !== undefined && !unknown) errors.push({ line: line.no, message: "sequenceKindLabels の値の形が読めません" });
+      i += 1;
+      continue;
+    }
+    if (head.key === "sequenceRowGap" || head.key === "sequenceGutter" || head.key === "sequenceBandWidth") {
+      const value = Number(stripQuotes((head.value ?? "").trim()));
+      if (Number.isFinite(value) && value > 0) {
+        if (head.key === "sequenceRowGap") sequenceRowGap = value;
+        else if (head.key === "sequenceGutter") sequenceGutter = value;
+        else sequenceBandWidth = value;
+      } else errors.push({ line: line.no, message: `${head.key} が読めません: "${head.value ?? ""}"`, hint: "正の数で書く" });
+      i += 1;
+      continue;
+    }
+    if (head.key === "sequenceSelfLoop") {
+      const value = JSONの欄を読む(head.value, head.key, line.no, errors);
+      const unknown = 図表の知らない項目を知らせる(value, SEQUENCE_SELF_LOOP_KEYS, head.key, line.no, errors);
+      if (!unknown && objectか(value)) {
+        const form = value.form;
+        const width = value.width;
+        const drop = value.drop;
+        const validForm =
+          form === undefined ||
+          (SEQUENCE_SELF_LOOP_FORM_VALUES as readonly unknown[]).includes(form);
+        const validWidth = width === undefined || (typeof width === "number" && Number.isFinite(width) && width > 0);
+        const validDrop = drop === undefined || (typeof drop === "number" && Number.isFinite(drop) && drop > 0);
+        if (validForm && validWidth && validDrop) sequenceSelfLoop = value;
+        else errors.push({ line: line.no, message: "sequenceSelfLoop の値の形が読めません", hint: '`{"form":"orthogonal","width":127,"drop":46}` の形で書く' });
+      } else if (value !== undefined && !unknown) errors.push({ line: line.no, message: "sequenceSelfLoop の値の形が読めません" });
+      i += 1;
+      continue;
+    }
+    if (head.key === "chartWaffleLegendPosition") {
+      const value = stripQuotes((head.value ?? "").trim());
+      if ((CHART_WAFFLE_LEGEND_POSITION_VALUES as readonly string[]).includes(value)) chartWaffleLegendPosition = value as typeof chartWaffleLegendPosition;
+      else errors.push({ line: line.no, message: `chartWaffleLegendPosition が読めません: "${value}"`, hint: `使える値 = ${CHART_WAFFLE_LEGEND_POSITION_VALUES.join(", ")}` });
+      i += 1;
+      continue;
+    }
+    if (head.key === "funnelForm") {
+      const value = stripQuotes((head.value ?? "").trim());
+      if ((FUNNEL_FORM_VALUES as readonly string[]).includes(value)) funnelForm = value as typeof funnelForm;
+      else errors.push({ line: line.no, message: `funnelForm が読めません: "${value}"`, hint: `使える値 = ${FUNNEL_FORM_VALUES.join(", ")}` });
+      i += 1;
+      continue;
+    }
+    if (head.key === "funnelRate") {
+      const value = stripQuotes((head.value ?? "").trim());
+      if ((FUNNEL_RATE_VALUES as readonly string[]).includes(value)) funnelRate = value as typeof funnelRate;
+      else errors.push({ line: line.no, message: `funnelRate が読めません: "${value}"`, hint: `使える値 = ${FUNNEL_RATE_VALUES.join(", ")}` });
+      i += 1;
+      continue;
+    }
+    if (head.key === "quadrantPointLabelSide") {
+      const value = stripQuotes((head.value ?? "").trim());
+      if ((QUADRANT_POINT_LABEL_SIDE_VALUES as readonly string[]).includes(value)) quadrantPointLabelSide = value as typeof quadrantPointLabelSide;
+      else errors.push({ line: line.no, message: `quadrantPointLabelSide が読めません: "${value}"`, hint: `使える値 = ${QUADRANT_POINT_LABEL_SIDE_VALUES.join(", ")}` });
+      i += 1;
+      continue;
+    }
+    if (
+      head.key === "treeNodeForm" || head.key === "treeEdgeTone" || head.key === "treeEdgeHead" ||
+      head.key === "mindForm" || head.key === "journeyForm" || head.key === "journeyLineForm"
+    ) {
+      const value = stripQuotes((head.value ?? "").trim());
+      const values = {
+        treeNodeForm: TREE_NODE_FORM_VALUES,
+        treeEdgeTone: TREE_EDGE_TONE_VALUES,
+        treeEdgeHead: TREE_EDGE_HEAD_VALUES,
+        mindForm: MIND_FORM_VALUES,
+        journeyForm: JOURNEY_FORM_VALUES,
+        journeyLineForm: JOURNEY_LINE_FORM_VALUES,
+      }[head.key];
+      if ((values as readonly string[]).includes(value)) {
+        if (head.key === "treeNodeForm") treeNodeForm = value as typeof treeNodeForm;
+        else if (head.key === "treeEdgeTone") treeEdgeTone = value as typeof treeEdgeTone;
+        else if (head.key === "treeEdgeHead") treeEdgeHead = value as typeof treeEdgeHead;
+        else if (head.key === "mindForm") mindForm = value as typeof mindForm;
+        else if (head.key === "journeyForm") journeyForm = value as typeof journeyForm;
+        else journeyLineForm = value as typeof journeyLineForm;
+      } else {
+        errors.push({ line: line.no, message: `${head.key} が読めません: "${value}"`, hint: `使える値 = ${values.join(", ")}` });
+      }
+      i += 1;
+      continue;
+    }
+    if (head.key === "treeSize" || head.key === "mindSize") {
+      const value = JSONの欄を読む(head.value, head.key, line.no, errors);
+      if (value !== undefined) {
+        if (head.key === "treeSize" && 木の寸法を読む(value, line.no, errors)) treeSize = value;
+        if (head.key === "mindSize" && 放射の寸法を読む(value, line.no, errors)) mindSize = value;
+      }
+      i += 1;
+      continue;
+    }
+    if (head.key === "cornerForm" || head.key === "quadrantLabelPosition" || head.key === "chartBarShape") {
+      const value = stripQuotes((head.value ?? "").trim());
+      const values = head.key === "cornerForm"
+        ? CORNER_FORM_VALUES
+        : head.key === "chartBarShape" ? CHART_BAR_SHAPE_VALUES : QUADRANT_LABEL_POSITION_VALUES;
+      if ((values as readonly string[]).includes(value)) {
+        if (head.key === "cornerForm") cornerForm = value as typeof cornerForm;
+        else if (head.key === "chartBarShape") chartBarShape = value as typeof chartBarShape;
+        else quadrantLabelPosition = value as typeof quadrantLabelPosition;
+      } else errors.push({ line: line.no, message: `${head.key} が読めません: "${value}"`, hint: `使える値 = ${values.join(", ")}` });
+      i += 1;
+      continue;
+    }
+    if (head.key === "stageLayout") {
+      const value = JSONの欄を読む(head.value, head.key, line.no, errors);
+      if (value !== undefined && cdl0132の欄を読む(head.key, value, line.no, errors)) {
+        stageLayout = value as NonNullable<typeof stageLayout>;
+      }
+      i += 1;
+      continue;
+    }
+    if ((CDL_0132_OBJECT_FIELDS as readonly string[]).includes(head.key)) {
+      const value = JSONの欄を読む(head.value, head.key, line.no, errors);
+      if (value !== undefined && cdl0132の欄を読む(head.key as Cdl0132ObjectField, value, line.no, errors)) {
+        if (head.key === "terminalDecoration") terminalDecoration = value as NonNullable<typeof terminalDecoration>;
+        else if (head.key === "figureKindLabel") figureKindLabel = value as NonNullable<typeof figureKindLabel>;
+        else if (head.key === "figureInset") figureInset = value as NonNullable<typeof figureInset>;
+        else if (head.key === "journeySize") journeySize = value as NonNullable<typeof journeySize>;
+        else if (head.key === "chartBarSize") chartBarSize = value as NonNullable<typeof chartBarSize>;
+        else if (head.key === "chartLineSize") chartLineSize = value as NonNullable<typeof chartLineSize>;
+        else if (head.key === "chartPieSize") chartPieSize = value as NonNullable<typeof chartPieSize>;
+        else if (head.key === "chartWaffleSize") chartWaffleSize = value as NonNullable<typeof chartWaffleSize>;
+        else if (head.key === "chartSlopeLabelTemplate") chartSlopeLabelTemplate = value as NonNullable<typeof chartSlopeLabelTemplate>;
+        else if (head.key === "chartSlopeSize") chartSlopeSize = value as NonNullable<typeof chartSlopeSize>;
+        else if (head.key === "chartStackedLayout") chartStackedLayout = value as NonNullable<typeof chartStackedLayout>;
+        else if (head.key === "chartGaugeSize") chartGaugeSize = value as NonNullable<typeof chartGaugeSize>;
+        else if (head.key === "ganttSize") ganttSize = value as NonNullable<typeof ganttSize>;
+        else if (head.key === "quadrantSize") quadrantSize = value as NonNullable<typeof quadrantSize>;
+        else if (head.key === "legendOffset") legendOffset = value as NonNullable<typeof legendOffset>;
+        else stageLayout = value as NonNullable<typeof stageLayout>;
+      }
+      i += 1;
+      continue;
+    }
+    if (head.key === "journeyLabels" || head.key === "figureCard" || head.key === "figureSize") {
+      const value = JSONの欄を読む(head.value, head.key, line.no, errors);
+      const keys = head.key === "journeyLabels"
+        ? JOURNEY_LABEL_KEYS
+        : head.key === "figureCard" ? (["label", "note"] as const) : (["width", "height"] as const);
+      const unknown = 図表の知らない項目を知らせる(value, keys, head.key, line.no, errors);
+      if (!unknown && objectか(value)) {
+        if (
+          head.key === "journeyLabels" &&
+          JOURNEY_LABEL_KEYS.every((key) => typeof value[key] === "string" && value[key].trim() !== "")
+        ) journeyLabels = value as typeof journeyLabels;
+        else if (
+          head.key === "figureCard" && typeof value.label === "string" &&
+          (value.note === undefined || typeof value.note === "string")
+        ) figureCard = value as typeof figureCard;
+        else if (
+          head.key === "figureSize" && typeof value.width === "number" && Number.isFinite(value.width) && value.width > 0 &&
+          typeof value.height === "number" && Number.isFinite(value.height) && value.height > 0
+        ) figureSize = value as typeof figureSize;
+        else errors.push({ line: line.no, message: `${head.key} の値の形が読めません` });
+      } else if (value !== undefined && !unknown) {
+        errors.push({ line: line.no, message: `${head.key} は object で書きます` });
+      }
+      i += 1;
+      continue;
+    }
     if (head.key === "type") {
       const v = (head.value ?? "").trim().toLowerCase();
-      if (!PRESET_TYPES.has(v as PresetType)) {
+      // **別名を先に引く** (#2655)。 引けたら図種と並び順の 2 つに開いて、以降は
+      // その語が 1 か所も残らないようにする
+      const 別名 = TYPE_ALIASES.get(v);
+      if (別名 !== undefined) {
+        type = 別名.type;
+        // 書き手が語も書いていればそちらが勝つ = 別名は既定を入れるだけ
+        if (order === null && 別名.order !== undefined) {
+          order = 別名.order;
+          orderLine = line.no;
+        }
+        if (別名.shape !== undefined) {
+          aliasShape = 別名.shape;
+          aliasShapeLine = line.no;
+        }
+      } else if (!PRESET_TYPES.has(v as PresetType)) {
         errors.push({
           line: line.no,
-          message: `unknown type: "${v}"`,
-          hint: `expected: ${Array.from(PRESET_TYPES).join(", ")}`,
+          message: `図種が読めません: "${v}"`,
+          hint: `使える図種 = ${[...PRESET_TYPES, ...TYPE_ALIASES.keys()].join(", ")}`,
         });
       } else {
         type = v as PresetType;
@@ -635,15 +1530,23 @@ export function parseTextDslV05(src: string): V05ParseResult {
     }
     if (head.key === "actors") {
       // 1 行で書いた形と、 続く字下げ行に項目を並べた形の両方を受け付ける
-      const { items, next } = collectActorEntries(lines, i + 1, line.indent);
+      const { items, 届かない, next } = collectActorEntries(lines, i + 1, line.indent);
+      // 1 件の頭にも続きにもならなかった行を知らせる (#2400)。 捨てると箱が黙って消える
+      for (const ln of 届かない) {
+        errors.push({
+          line: ln.no,
+          message: `登場人物の行が読めません: "${ln.trimmed}"`,
+          hint: "`- Client` の形で書く (先頭の `- ` を落とすと 1 件として読めない)",
+        });
+      }
       actors = [];
       for (const entry of items) {
         const base = parseActor(entry[0]!, errors);
         if (base === null) {
           errors.push({
             line: entry[0]!.no,
-            message: `invalid actor entry: "${entry[0]!.trimmed}"`,
-            hint: "use `- Client` or `- Client: storage`",
+            message: `登場人物の行が読めません: "${entry[0]!.trimmed}"`,
+            hint: "`- Client` または `- Client: storage` の形で書く",
           });
           continue;
         }
@@ -664,8 +1567,8 @@ export function parseTextDslV05(src: string): V05ParseResult {
         } else {
           errors.push({
             line: it.no,
-            message: `invalid flow entry: "${it.trimmed}"`,
-            hint: 'use `- A -> B: "label"` or `- A -> B: "label" (success)`',
+            message: `矢印の行が読めません: "${it.trimmed}"`,
+            hint: '`- A -> B: "label"` または `- A -> B: "label" (success)` の形で書く',
           });
         }
       }
@@ -679,7 +1582,7 @@ export function parseTextDslV05(src: string): V05ParseResult {
         const inner = inlineMatch.slice(1, -1).trim();
         animate = ensureAnimate(animate, line.no);
         for (const pair of splitTopLevelCommas(inner)) {
-          const st = parseStateEntry(pair, line.no);
+          const st = parseStateEntry(pair, line.no, errors);
           if (st) animate.states.push(st);
         }
         i += 1;
@@ -688,14 +1591,10 @@ export function parseTextDslV05(src: string): V05ParseResult {
       const { items, next } = collectIndentedList(lines, i + 1, line.indent);
       animate = ensureAnimate(animate, line.no);
       for (const it of items) {
-        const st = parseStateEntry(it.trimmed.replace(/^-\s*/, ""), it.no);
+        // 断り方ごとの文は読み手が持つ (#2401)。 ここで `null` をまとめて叱ると、
+        // 名前の規則を外れただけの行に形の案内が返る
+        const st = parseStateEntry(it.trimmed.replace(/^-\s*/, ""), it.no, errors);
         if (st) animate.states.push(st);
-        else
-          errors.push({
-            line: it.no,
-            message: `invalid state entry: "${it.trimmed}"`,
-            hint: "use `name: initial`",
-          });
       }
       i = next;
       continue;
@@ -705,8 +1604,8 @@ export function parseTextDslV05(src: string): V05ParseResult {
       // 入る (`min({a}, {b})`) ため、 `states` が使う素朴な `,` 分割では式が壊れる。
       //
       // **`{` で始まるかを見てはいけない** (#1169)。 `values: a: "{b} + 1"` は `{` で始まらない
-      // ため判定を通り抜け、 その後 `collectIndentedRaw` が次行以降しか見ないので **値が
-      // 1 件も読まれずに黙って消える**。 書き間違いを黙って捨てないという `collectIndentedRaw`
+      // ため判定を通り抜け、 その後 `collectIndentedList` が次行以降しか見ないので **値が
+      // 1 件も読まれずに黙って消える**。 書き間違いを黙って捨てないという `collectIndentedList`
       // を自前で持った理由と矛盾する。
       //
       // 同じ行に何か書いてあれば形を問わず弾く = 1 行形は全て受けないという規則そのもの。
@@ -720,9 +1619,9 @@ export function parseTextDslV05(src: string): V05ParseResult {
         i += 1;
         continue;
       }
-      // `collectIndentedList` は `:` を含まない行を黙って捨てる。 捨てられると
-      // 書き間違えた行が「書かなかった」 と同じになり、 値が 1 つ消えたことに気付けない
-      const { items, next } = collectIndentedRaw(lines, i + 1, line.indent);
+      // 字下げした行を 1 行も落とさずに集める。 捨てられると書き間違えた行が
+      // 「書かなかった」 と同じになり、 値が 1 つ消えたことに気付けない
+      const { items, next } = collectIndentedList(lines, i + 1, line.indent);
       for (const it of items) {
         const v = parseValueEntry(it.trimmed.replace(/^-\s*/, ""), it.no, errors);
         if (v) values.push(v);
@@ -732,8 +1631,16 @@ export function parseTextDslV05(src: string): V05ParseResult {
     }
     if (head.key === "animation") {
       // animation: は step を list で並べる
-      const { items: stepBlocks, next } = collectAnimationSteps(lines, i + 1, line.indent);
+      const { items: stepBlocks, 届かない, next } = collectAnimationSteps(lines, i + 1, line.indent);
       animate = ensureAnimate(animate, line.no);
+      // どの段にも属さなかった行を知らせる (#2400)。 捨てると段が丸ごと黙って消える
+      for (const ln of 届かない) {
+        errors.push({
+          line: ln.no,
+          message: `段の行が読めません: "${ln.trimmed}"`,
+          hint: '`- step: "名前" 1.2s` の形で書く (先頭の `- ` を落とすと段として読めない)',
+        });
+      }
       for (const block of stepBlocks) {
         const ph = parsePhase(block, errors);
         if (ph) animate.phases.push(ph);
@@ -763,7 +1670,7 @@ export function parseTextDslV05(src: string): V05ParseResult {
       // block: viewport:\n  width: 1400\n  height: 900\n  ...
       // **`collectIndentedList` を使わない** (#1968)。 あちらは `:` を含まない行を黙って捨てるため、
       // 書き間違えた行が「書かなかった」 と同じになる (`axes:` と同じ理由)
-      const { items, next } = collectIndentedRaw(lines, i + 1, line.indent);
+      const { items, next } = collectIndentedList(lines, i + 1, line.indent);
       const opts: Record<string, string> = {};
       // 知らせは **値を書いた行** を指す (#1306)。 `viewport:` の行を指すと、欄が縦に並ぶ形で
       // どの行を直せばよいか分からない
@@ -824,7 +1731,7 @@ export function parseTextDslV05(src: string): V05ParseResult {
       }
       // **`collectIndentedList` を使わない** (Round 1 の指摘)。 あちらは `:` を含まない行を
       // 黙って捨てるため、書き間違えた行が「書かなかった」 と同じになる
-      const { items, next } = collectIndentedRaw(lines, i + 1, line.indent);
+      const { items, next } = collectIndentedList(lines, i + 1, line.indent);
       axesLine = line.no;
       const 組み立て: DslAxes = {};
       for (const it of items) {
@@ -832,8 +1739,8 @@ export function parseTextDslV05(src: string): V05ParseResult {
         if (!m) {
           errors.push({
             line: it.no,
-            message: `invalid axes entry: "${it.trimmed}"`,
-            hint: 'use `x: { left: "...", right: "..." }` or `y: { bottom: "...", top: "..." }`',
+            message: `軸の行が読めません: "${it.trimmed}"`,
+            hint: '`x: { left: "...", right: "..." }` または `y: { bottom: "...", top: "..." }` の形で書く',
           });
           continue;
         }
@@ -845,7 +1752,12 @@ export function parseTextDslV05(src: string): V05ParseResult {
           it.no,
           errors,
         );
-        if (m[1] === "x") 組み立て.x = { left: opts.left, right: opts.right };
+        const direction = opts.direction === "true";
+        if (direction && opts.label !== undefined) {
+          const axis = { label: stripQuotes(opts.label), direction: true } as const;
+          if (m[1] === "x") 組み立て.x = axis;
+          else 組み立て.y = axis;
+        } else if (m[1] === "x") 組み立て.x = { left: opts.left, right: opts.right };
         else 組み立て.y = { bottom: opts.bottom, top: opts.top };
       }
       // 1 本も読めなかった形は「書かなかった」 と同じにする。 空の軸を渡すと、
@@ -854,9 +1766,55 @@ export function parseTextDslV05(src: string): V05ParseResult {
       i = next;
       continue;
     }
+    if (head.key === "regions") {
+      // regions:\n  左上: "すぐやる"\n  右上: "計画してやる"
+      //
+      // 1 行にまとめて書く形は受けない (`axes:` と同じ理由)。 受けないなら黙って捨てず、
+      // その場で伝える = 捨てると名前を書いたつもりの本文が既定のまま描かれる
+      if (head.value !== null && head.value.trim() !== "") {
+        errors.push({
+          line: line.no,
+          message: "regions は 1 行にまとめて書けない",
+          hint: '次の行から字下げして `左上: "すぐやる"` の形で並べる',
+        });
+        i += 1;
+        continue;
+      }
+      const { items, next } = collectIndentedList(lines, i + 1, line.indent);
+      const 組み立て: DslRegions = {};
+      for (const it of items) {
+        const m = it.trimmed.match(/^(.+?)\s*:\s*(.+)$/);
+        if (!m) {
+          errors.push({
+            line: it.no,
+            message: `区画の行が読めません: "${it.trimmed}"`,
+            hint: '`左上: "すぐやる"` の形で書く',
+          });
+          continue;
+        }
+        // 区画を指す語は項目の欄と同じ 4 語。 別の言い方を足すと同じ区画を 2 通りで呼ぶ
+        const key = 区画.get((m[1] ?? "").trim());
+        if (key === undefined) {
+          // 知らせの形は他の欄と揃える (#1968)。 揃えないと、知らない項目名を
+          // 走査する検査がこの欄だけ見つけられない
+          errors.push({
+            line: it.no,
+            message: `regions の項目名が読めません: "${(m[1] ?? "").trim()}"`,
+            hint: `使える項目 = ${[...区画.keys()].join(", ")}`,
+          });
+          continue;
+        }
+        組み立て[key] = stripQuotes((m[2] ?? "").trim());
+      }
+      // 1 つも読めなかった形は「書かなかった」 と同じにする (`axes:` と同じ)
+      regions = Object.keys(組み立て).length > 0 ? 組み立て : undefined;
+      i = next;
+      continue;
+    }
     if (head.key === "bands") {
       /*
-       * 動いている間の帯 (#1466)。 `- DB: 1..2` の形で、段の番号の区間を書く。
+       * 動いている間の帯 (#1466)。 `- DB: 1..2` の形で、言づての番号の区間を書く。
+       * 番号は板に載る言づての行で 0 から数える (#2404 で実測、 段ではない)。
        *
        * 面ごとに 2 行以上書ける = 途中で手が空く面はそこで切れる。 書かない図は
        * 組み立て器が「最初に関わった段から最後まで」 の 1 本にする。
@@ -870,11 +1828,11 @@ export function parseTextDslV05(src: string): V05ParseResult {
           errors.push({
             line: it.no,
             message: `帯の書き方が読めません: "${it.trimmed}"`,
-            hint: "use `- DB: 1..2` (面の名前と、段の番号の区間)",
+            hint: "`- DB: 1..2` の形で書く (面の名前と、言づての番号の区間。 番号は 0 から数える)",
           });
           continue;
         }
-        bands.push({ actor: m[1]!, from: Number(m[2]), to: Number(m[3]) });
+        bands.push({ actor: m[1]!, from: Number(m[2]), to: Number(m[3]), pos: { line: it.no } });
       }
       i = next;
       continue;
@@ -899,6 +1857,7 @@ export function parseTextDslV05(src: string): V05ParseResult {
             id,
             ...表で読む(LANE_VALUE_KINDS, opts, `縦列 ${id} の `, it.no, errors),
             label: opts.label,
+            subtitle: opts.subtitle,
             // 位置のずらし (#1971)
             layoutPos: ずらしにまとめる(
               表で読む(OFFSET_VALUE_KINDS, opts, `縦列 ${id} の `, it.no, errors),
@@ -908,8 +1867,8 @@ export function parseTextDslV05(src: string): V05ParseResult {
         } else {
           errors.push({
             line: it.no,
-            message: `invalid lane entry: "${it.trimmed}"`,
-            hint: 'use `id: { x: 0, width: 320, label: "..." }`',
+            message: `縦列の行が読めません: "${it.trimmed}"`,
+            hint: '`id: { x: 0, width: 320, label: "..." }` の形で書く',
           });
         }
       }
@@ -930,7 +1889,7 @@ export function parseTextDslV05(src: string): V05ParseResult {
       }
       // `collectIndentedList` は `:` の無い行を落とす。 部品を綴り違えた行も知らせるため、
       // 字下げした行を全て読み手へ渡す。
-      const { items, next } = collectIndentedRaw(lines, i + 1, line.indent);
+      const { items, next } = collectIndentedList(lines, i + 1, line.indent);
       readoutsList = [];
       for (const it of items) {
         const m = 名前と中括弧に割る(it.trimmed);
@@ -940,8 +1899,8 @@ export function parseTextDslV05(src: string): V05ParseResult {
         } else {
           errors.push({
             line: it.no,
-            message: `invalid readout entry: "${it.trimmed}"`,
-            hint: "use `id: { kind: percent-ring, source: total, max: 500 }`",
+            message: `読み取り値の行が読めません: "${it.trimmed}"`,
+            hint: "`id: { kind: percent-ring, source: total, max: 500 }` の形で書く",
           });
         }
       }
@@ -962,7 +1921,7 @@ export function parseTextDslV05(src: string): V05ParseResult {
       }
       // `collectIndentedList` は `:` の無い行を落とす。 つまみを綴り違えた行も知らせるため、
       // 字下げした行を全て読み手へ渡す。
-      const { items, next } = collectIndentedRaw(lines, i + 1, line.indent);
+      const { items, next } = collectIndentedList(lines, i + 1, line.indent);
       inputsList = [];
       for (const it of items) {
         const m = 名前と中括弧に割る(it.trimmed);
@@ -972,8 +1931,8 @@ export function parseTextDslV05(src: string): V05ParseResult {
         } else {
           errors.push({
             line: it.no,
-            message: `invalid input entry: "${it.trimmed}"`,
-            hint: "use `id: { kind: slider, min: 0, max: 100, defaultValue: 50 }`",
+            message: `つまみの行が読めません: "${it.trimmed}"`,
+            hint: "`id: { kind: slider, min: 0, max: 100, defaultValue: 50 }` の形で書く",
           });
         }
       }
@@ -995,7 +1954,7 @@ export function parseTextDslV05(src: string): V05ParseResult {
         continue;
       }
       // 字下げした行を全て読み手へ渡す = 綴りを誤った行も知らせるため
-      const { items, next } = collectIndentedRaw(lines, i + 1, line.indent);
+      const { items, next } = collectIndentedList(lines, i + 1, line.indent);
       formulasList = [];
       for (const it of items) {
         const f = 式として読む(it.trimmed.replace(/^-\s*/, ""), it.no, errors);
@@ -1015,7 +1974,7 @@ export function parseTextDslV05(src: string): V05ParseResult {
         i += 1;
         continue;
       }
-      const { items, next } = collectIndentedRaw(lines, i + 1, line.indent);
+      const { items, next } = collectIndentedList(lines, i + 1, line.indent);
       eventsList = [];
       for (const it of items) {
         const e = 出来事として読む(it.trimmed.replace(/^-\s*/, ""), it.no, errors);
@@ -1035,7 +1994,7 @@ export function parseTextDslV05(src: string): V05ParseResult {
         i += 1;
         continue;
       }
-      const { items, next } = collectIndentedRaw(lines, i + 1, line.indent);
+      const { items, next } = collectIndentedList(lines, i + 1, line.indent);
       scrollsList = [];
       scrollLines = new Map();
       for (const it of items) {
@@ -1057,8 +2016,8 @@ export function parseTextDslV05(src: string): V05ParseResult {
         } else {
           errors.push({
             line: it.no,
-            message: `invalid scroll entry: "${it.trimmed}"`,
-            hint: "use `id: { start: 0.9, end: 0.1, scrub: 1 }`",
+            message: `巻き上げの行が読めません: "${it.trimmed}"`,
+            hint: "`id: { start: 0.9, end: 0.1, scrub: 1 }` の形で書く",
           });
         }
       }
@@ -1089,8 +2048,8 @@ export function parseTextDslV05(src: string): V05ParseResult {
         } else {
           errors.push({
             line: it.no,
-            message: `invalid group entry: "${it.trimmed}"`,
-            hint: 'use `id: { label: "...", lanes: [a, b] }`',
+            message: `組の行が読めません: "${it.trimmed}"`,
+            hint: '`id: { label: "...", lanes: [a, b] }` の形で書く',
           });
         }
       }
@@ -1101,12 +2060,21 @@ export function parseTextDslV05(src: string): V05ParseResult {
   }
 
   if (!title)
-    errors.push({ line: 1, message: "title is required", hint: 'add `title: "..."` at top' });
+    errors.push({
+      line: 1,
+      message: "title が書かれていません",
+      hint: "`title: \"...\"` を最上位に書く",
+    });
   if (!type)
     errors.push({
       line: 1,
-      message: "type is required",
-      hint: "add `type: sequence|flow|swimlane|er|state|topology|solidity|gantt|class|pie|c4|mind`",
+      message: "type が書かれていません",
+      /*
+       * **図種の一覧を手で並べない** (#2341)。 並べていた間、ここは実装が受ける図種の
+       * 半分しか挙げず、値を並べる図種 (棒 / 折れ線 / 木 など) がまるごと抜けていた。
+       * すぐ上の `図種が読めません` は元から実装を読んでおり、2 つの一覧が食い違っていた。
+       */
+      hint: `\`type: flow\` の形で最上位に書く (使える図種 = ${Array.from(PRESET_TYPES).join(", ")})`,
     });
 
   // つまみ・式・巻き上げは同じ名前空間で値を作る。 重なると後から作る値が効かない。
@@ -1123,7 +2091,25 @@ export function parseTextDslV05(src: string): V05ParseResult {
     });
   }
 
+  let shape: DslDiagramShape | null = aliasShape;
+  let shapeLine = aliasShapeLine;
+  if (shapeWritten !== null) {
+    const 解けた = resolveDiagramShape(shapeWritten.value);
+    const 図種の語 = type === null ? [] : shapesForDiagramType(type);
+    if (解けた === null || (type === "chart" && !図種の語.includes(解けた))) {
+      errors.push({
+        line: shapeWritten.line,
+        message: `shape が読めません (書いた値: ${shapeWritten.value})`,
+        hint: shapeの案内(type),
+      });
+    } else {
+      shape = 解けた;
+      shapeLine = shapeWritten.line;
+    }
+  }
+
   if (errors.length > 0) return { ok: false, errors };
+  const 選んだ意匠 = theme ?? palette;
 
   return {
     ok: true,
@@ -1134,8 +2120,80 @@ export function parseTextDslV05(src: string): V05ParseResult {
       ...(reveal !== null ? { reveal } : {}),
       ...(relations !== null ? { relations } : {}),
       ...(direction !== null ? { direction, directionPos: { line: directionLine } } : {}),
-      ...(palette !== null ? { palette } : {}),
+      ...(order !== null ? { order, orderPos: { line: orderLine } } : {}),
+      ...(shape !== null ? { shape, shapePos: { line: shapeLine } } : {}),
+      ...(formWritten !== null
+        ? { form: formWritten.value, formPos: { line: formWritten.line } }
+        : {}),
+      ...(ticks !== undefined ? { ticks, ticksPos: { line: ticksLine } } : {}),
+      ...(ganttToday !== undefined ? { ganttToday } : {}),
+      ...(ganttTickLabels !== undefined ? { ganttTickLabels } : {}),
+      ...(ganttBarEnd !== undefined ? { ganttBarEnd } : {}),
+      ...(ganttBarThickness !== undefined ? { ganttBarThickness } : {}),
+      ...(chartSeriesSkipMuted !== undefined ? { chartSeriesSkipMuted } : {}),
+      ...(chartLineSeries !== undefined ? { chartLineSeries } : {}),
+      ...(chartPieCenterLabel !== undefined ? { chartPieCenterLabel } : {}),
+      ...(chartPieTableColumns !== undefined ? { chartPieTableColumns } : {}),
+      ...(chartPieRingWidth !== undefined ? { chartPieRingWidth } : {}),
+      ...(chartSlopePeriods !== undefined ? { chartSlopePeriods } : {}),
+      ...(chartSlopeEmphasisIds !== undefined ? { chartSlopeEmphasisIds } : {}),
+      ...(chartSlopeUnit !== undefined ? { chartSlopeUnit } : {}),
+      ...(chartStackedPeriods !== undefined ? { chartStackedPeriods } : {}),
+      ...(chartStackedRateId !== undefined ? { chartStackedRateId } : {}),
+      ...(chartStackedLegendPosition !== undefined ? { chartStackedLegendPosition } : {}),
+      ...(chartGaugeValue !== undefined ? { chartGaugeValue } : {}),
+      ...(chartWaffleLegendPosition !== undefined ? { chartWaffleLegendPosition } : {}),
+      ...(funnelForm !== undefined ? { funnelForm } : {}),
+      ...(funnelRate !== undefined ? { funnelRate } : {}),
+      ...(quadrantPointLabelSide !== undefined ? { quadrantPointLabelSide } : {}),
+      ...(treeNodeForm !== undefined ? { treeNodeForm } : {}),
+      ...(treeSize !== undefined ? { treeSize } : {}),
+      ...(treeEdgeTone !== undefined ? { treeEdgeTone } : {}),
+      ...(treeEdgeHead !== undefined ? { treeEdgeHead } : {}),
+      ...(mindForm !== undefined ? { mindForm } : {}),
+      ...(mindSize !== undefined ? { mindSize } : {}),
+      ...(journeyForm !== undefined ? { journeyForm } : {}),
+      ...(journeyLineForm !== undefined ? { journeyLineForm } : {}),
+      ...(journeyLabels !== undefined ? { journeyLabels } : {}),
+      ...(journeySize !== undefined ? { journeySize } : {}),
+      ...(sequenceActorForm !== undefined ? { sequenceActorForm } : {}),
+      ...(sequenceLabelForm !== undefined ? { sequenceLabelForm } : {}),
+      ...(sequenceReturnHead !== undefined ? { sequenceReturnHead } : {}),
+      ...(sequenceKindLabels !== undefined ? { sequenceKindLabels } : {}),
+      ...(sequenceRowGap !== undefined ? { sequenceRowGap } : {}),
+      ...(sequenceGutter !== undefined ? { sequenceGutter } : {}),
+      ...(sequenceBandWidth !== undefined ? { sequenceBandWidth } : {}),
+      ...(sequenceSelfLoop !== undefined ? { sequenceSelfLoop } : {}),
+      ...(figureCard !== undefined ? { figureCard } : {}),
+      ...(figureSize !== undefined ? { figureSize } : {}),
+      ...(terminalDecoration !== undefined ? { terminalDecoration } : {}),
+      ...(cornerForm !== undefined ? { cornerForm } : {}),
+      ...(figureKindLabel !== undefined ? { figureKindLabel } : {}),
+      ...(figureInset !== undefined ? { figureInset } : {}),
+      ...(chartBarSize !== undefined ? { chartBarSize } : {}),
+      ...(chartBarShape !== undefined ? { chartBarShape } : {}),
+      ...(chartLineSize !== undefined ? { chartLineSize } : {}),
+      ...(chartPieSize !== undefined ? { chartPieSize } : {}),
+      ...(chartWaffleSize !== undefined ? { chartWaffleSize } : {}),
+      ...(chartSlopeLabelTemplate !== undefined ? { chartSlopeLabelTemplate } : {}),
+      ...(chartSlopeSize !== undefined ? { chartSlopeSize } : {}),
+      ...(chartStackedLayout !== undefined ? { chartStackedLayout } : {}),
+      ...(chartGaugeSize !== undefined ? { chartGaugeSize } : {}),
+      ...(ganttSize !== undefined ? { ganttSize } : {}),
+      ...(quadrantLabelPosition !== undefined ? { quadrantLabelPosition } : {}),
+      ...(quadrantSize !== undefined ? { quadrantSize } : {}),
+      ...(stageLayout !== undefined ? { stageLayout } : {}),
+      ...(選んだ意匠 !== null ? { theme: 選んだ意匠 } : {}),
+      ...(legend.length > 0 ? { legend } : {}),
+      ...(legendOffset !== undefined ? { legendOffset } : {}),
+      ...(legendFontSize !== undefined ? { legendFontSize } : {}),
+      ...(edgeEndGap !== undefined ? { edgeEndGap } : {}),
+      ...(stageHeader !== undefined ? { stageHeader } : {}),
+      ...(theme !== null && palette !== null
+        ? { themeAlsoPalettePos: { themeLine, paletteLine } }
+        : {}),
       ...(axes !== undefined ? { axes, axesPos: { line: axesLine } } : {}),
+      ...(regions !== undefined ? { regions } : {}),
       actors,
       flow,
       animate,
@@ -1170,10 +2228,125 @@ type TopHeader = { key: string; value: string | null };
 
 function matchTopHeader(trimmed: string): TopHeader | null {
   // 形式: `key:` or `key: value`
-  const m = trimmed.match(/^([a-zA-Z][a-zA-Z0-9_]*)\s*:\s*(.*)$/);
+  const m = trimmed.match(/^([^\s:]+)\s*:\s*(.*)$/u);
   if (!m) return null;
   const value = (m[2] ?? "").trim();
-  return { key: (m[1] ?? "").toLowerCase(), value: value.length ? stripQuotes(value) : null };
+  const writtenKey = m[1] ?? "";
+  const lowerKey = writtenKey.toLowerCase();
+  const canonicalKey = TOP_LEVEL_KEYS.find((key) => key.toLowerCase() === lowerKey);
+  return { key: canonicalKey ?? lowerKey, value: value.length ? stripQuotes(value) : null };
+}
+
+const LEGEND_ITEM_KEYS = ["mark", "text", "tone", "lineStyle", "align", "lead", "印", "説明"] as const;
+const LEGEND_LINE_MARKS = ["line-triangle-hollow", "line-diamond-hollow", "line-diamond-solid"] as const;
+
+/** 凡例の 1 行を読み、描画側へ渡せる印と文字へ揃える。 */
+function parseLegendItem(
+  line: Line,
+  errors: DslError[],
+): CdlLegendItem | null {
+  const match = line.trimmed.match(/^\{([\s\S]*)\}$/u);
+  if (!match) {
+    errors.push({
+      line: line.no,
+      message: "凡例の行が読めません",
+      hint: '`{ mark: diamond, text: "分かれ道" }` の形で書く',
+    });
+    return null;
+  }
+
+  const fields = new Map<string, string>();
+  let unreadable = false;
+  for (const field of splitInlineFields(match[1] ?? "")) {
+    const separator = field.indexOf(":");
+    if (separator < 0) {
+      unreadable = true;
+      continue;
+    }
+    const key = field.slice(0, separator).trim();
+    const value = field.slice(separator + 1).trim();
+    if (!LEGEND_ITEM_KEYS.includes(key as (typeof LEGEND_ITEM_KEYS)[number])) {
+      errors.push({
+        line: line.no,
+        message: `凡例の項目名が読めません: "${key}"`,
+        hint: `使える項目 = ${LEGEND_ITEM_KEYS.join(", ")}`,
+      });
+      unreadable = true;
+      continue;
+    }
+    fields.set(key, value);
+  }
+
+  const markRaw = fields.get("mark") ?? fields.get("印");
+  const markValue = markRaw === undefined ? undefined : stripQuotes(markRaw);
+  const mark = markValue === undefined ? undefined : resolveLegendMark(markValue);
+  if (markValue !== undefined && mark === null) {
+    errors.push({
+      line: line.no,
+      message: `凡例の印が読めません: "${markValue}"`,
+      hint: `使える印 = ${[...LEGEND_MARKS, ...Object.keys(LEGEND_MARK_ALIAS)].join(" / ")}`,
+    });
+    unreadable = true;
+  }
+
+  const textRaw = fields.get("text") ?? fields.get("説明") ?? "";
+  const quoted =
+    (textRaw.startsWith('"') && textRaw.endsWith('"')) ||
+    (textRaw.startsWith("'") && textRaw.endsWith("'"));
+  const text = stripQuotes(textRaw).trim();
+  const bracketed =
+    textRaw.startsWith("[") ||
+    textRaw.startsWith("{") ||
+    textRaw.endsWith("]") ||
+    textRaw.endsWith("}");
+  if (text.length === 0 || (!quoted && bracketed)) {
+    errors.push({
+      line: line.no,
+      message: "凡例の説明は文字で書く",
+      hint: '`text: "分かれ道"` または `説明: "分かれ道"` の形で書く',
+    });
+    unreadable = true;
+  }
+
+  const toneRaw = fields.get("tone");
+  const tone = toneRaw === undefined ? undefined : resolveTone(stripQuotes(toneRaw));
+  if (toneRaw !== undefined && tone === undefined) {
+    errors.push({ line: line.no, message: `凡例の tone が読めません: "${stripQuotes(toneRaw)}"`, hint: `使える値 = ${書ける色名().join(", ")}` });
+    unreadable = true;
+  }
+  const lineStyleRaw = fields.get("lineStyle");
+  const lineStyle = lineStyleRaw === undefined ? undefined : stripQuotes(lineStyleRaw);
+  if (lineStyle !== undefined && !(LEGEND_LINE_STYLE_VALUES as readonly string[]).includes(lineStyle)) {
+    errors.push({ line: line.no, message: `凡例の lineStyle が読めません: "${lineStyle}"`, hint: `使える値 = ${LEGEND_LINE_STYLE_VALUES.join(", ")}` });
+    unreadable = true;
+  }
+  const alignRaw = fields.get("align");
+  const align = alignRaw === undefined ? undefined : stripQuotes(alignRaw);
+  if (align !== undefined && !(LEGEND_NOTE_ALIGN_VALUES as readonly string[]).includes(align)) {
+    errors.push({ line: line.no, message: `凡例の align が読めません: "${align}"`, hint: `使える値 = ${LEGEND_NOTE_ALIGN_VALUES.join(", ")}` });
+    unreadable = true;
+  }
+  const lead = fields.get("lead") === undefined ? undefined : stripQuotes(fields.get("lead")!);
+  if (mark === undefined && (tone !== undefined || lineStyle !== undefined)) {
+    errors.push({ line: line.no, message: "印のない凡例に tone / lineStyle は書けません", hint: "注記には text / align / lead を使う" });
+    unreadable = true;
+  }
+  if (mark !== undefined && (align !== undefined || lead !== undefined)) {
+    errors.push({ line: line.no, message: "印を持つ凡例に align / lead は書けません", hint: "align / lead は印のない注記に使う" });
+    unreadable = true;
+  }
+  if (lineStyle !== undefined && (mark === undefined || mark === null || !(LEGEND_LINE_MARKS as readonly LegendMark[]).includes(mark))) {
+    errors.push({ line: line.no, message: "lineStyle は線端を持つ凡例の印にだけ書けます", hint: `使える印 = ${LEGEND_LINE_MARKS.join(", ")}` });
+    unreadable = true;
+  }
+  if (unreadable || mark === null) return null;
+  if (mark === undefined) return { text, ...(align === undefined ? {} : { align: align as "start" | "end" }), ...(lead === undefined ? {} : { lead }) };
+  return {
+    mark,
+    ...(tone === undefined ? {} : { tone }),
+    ...(lineStyle === undefined ? {} : { lineStyle }),
+    text,
+  } as CdlLegendItem;
 }
 
 /**
@@ -1470,6 +2643,7 @@ function 表で読む<T extends Record<string, 値の形>>(
 export const VIEWPORT_VALUE_KINDS = {
   width: "数",
   height: "数",
+  contentOffsetX: "数",
   scale: "数",
   laneWidth: "数",
   gap: "数",
@@ -1508,13 +2682,14 @@ export const LANE_VALUE_KINDS = {
 
 /**
  * 縦列の中括弧に書ける項目 (#1968)。 数と真偽の欄は `LANE_VALUE_KINDS` と `OFFSET_VALUE_KINDS` から
- * 導き、表に載せない文字列の `label` だけを足す。
+ * 導き、表に載せない文字列の `label` と `subtitle` だけを足す。
  */
 export const LANE_INLINE_KEYS: readonly (keyof DslLane | keyof typeof OFFSET_VALUE_KINDS)[] = [
   ...(Object.keys(LANE_VALUE_KINDS) as (keyof typeof LANE_VALUE_KINDS)[]),
   // 位置のずらし (#1971)。 JSON の縦列の `pos` と同じ `layoutPos` に入る
   ...(Object.keys(OFFSET_VALUE_KINDS) as (keyof typeof OFFSET_VALUE_KINDS)[]),
   "label",
+  "subtitle",
 ];
 
 /** 組の中括弧に書ける項目 (#1968)。 `groups:` の読み手が拾う欄と揃える */
@@ -1524,12 +2699,18 @@ export const GROUP_INLINE_KEYS = ["label", "lanes"] as const satisfies readonly
 >[];
 
 /** 軸の名前の中括弧に書ける項目 (#1968)。 横軸は左右、縦軸は下上 */
-export const AXIS_X_KEYS = ["left", "right"] as const satisfies readonly (keyof NonNullable<
-  DslAxes["x"]
->)[];
-export const AXIS_Y_KEYS = ["bottom", "top"] as const satisfies readonly (keyof NonNullable<
-  DslAxes["y"]
->)[];
+export const AXIS_X_KEYS = ["left", "right", "label", "direction"] as const satisfies readonly (
+  | "left"
+  | "right"
+  | "label"
+  | "direction"
+)[];
+export const AXIS_Y_KEYS = ["bottom", "top", "label", "direction"] as const satisfies readonly (
+  | "bottom"
+  | "top"
+  | "label"
+  | "direction"
+)[];
 
 /**
  * 箱の中に描く図形 (`shape:`) と、値を見せる部品 (`readouts:`) の欄 (#1374)。
@@ -1732,7 +2913,11 @@ function 選択肢の並びとして読む(
 ): (string | { value: string; label: string })[] | undefined {
   const 中身 = 値.trim();
   if (!中身.startsWith("[") || !中身.endsWith("]")) {
-    errors.push({ line, message: `${名} の並びが読めません: "${値}"`, hint: '`["green", { value: "red", label: "失敗" }]` の形で書く' });
+    errors.push({
+      line,
+      message: `${名} の並びが読めません: "${値}"`,
+      hint: '`["green", { value: "red", label: "失敗" }]` の形で書く',
+    });
     return undefined;
   }
   const 出: (string | { value: string; label: string })[] = [];
@@ -1745,19 +2930,35 @@ function 選択肢の並びとして読む(
       return;
     }
     if (!要素.endsWith("}")) {
-      errors.push({ line, message: `${名}[${i}] の組が読めません: "${要素}"`, hint: '`{ value: "red", label: "失敗" }` の形で書く' });
+      errors.push({
+        line,
+        message: `${名}[${i}] の組が読めません: "${要素}"`,
+        hint: '`{ value: "red", label: "失敗" }` の形で書く',
+      });
       return;
     }
     const 組 = parseInlineMapping(要素.slice(1, -1));
     for (const k of Object.keys(組)) {
       if ((選択肢の組の項目 as readonly string[]).includes(k)) continue;
-      errors.push({ line, message: `${名}[${i}] の項目名が読めません: "${k}"`, hint: `使える項目 = ${選択肢の組の項目.join(", ")}` });
+      errors.push({
+        line,
+        message: `${名}[${i}] の項目名が読めません: "${k}"`,
+        hint: `使える項目 = ${選択肢の組の項目.join(", ")}`,
+      });
     }
     for (const k of 選択肢の組の項目) {
       if (組[k] === undefined) {
-        errors.push({ line, message: `${名}[${i}].${k} は必ず書きます`, hint: `必須の項目 = ${選択肢の組の項目.join(", ")}` });
+        errors.push({
+          line,
+          message: `${名}[${i}].${k} は必ず書きます`,
+          hint: `必須の項目 = ${選択肢の組の項目.join(", ")}`,
+        });
       } else if (組[k] === "") {
-        errors.push({ line, message: `${名}[${i}].${k} が空です`, hint: k === "label" ? "名前を書かないなら文字列だけを並べる" : "値を 1 文字以上書く" });
+        errors.push({
+          line,
+          message: `${名}[${i}].${k} が空です`,
+          hint: k === "label" ? "名前を書かないなら文字列だけを並べる" : "値を 1 文字以上書く",
+        });
       }
     }
     if (組.value && 組.label) 出.push({ value: 組.value, label: 組.label });
@@ -2059,7 +3260,7 @@ function 部品として読む(
   const 読めた = 表に従って読む(定義, opts, `部品 ${id} の `, line, errors);
   部品の組を検査する(kind, 読めた, line, errors);
   for (const 欄 of 定義.必須) if (読めた[欄] === undefined) return undefined;
-  return { id, kind, ...読めた } as DslReadout;
+  return { id, kind, ...読めた, pos: { line } } as DslReadout;
 }
 
 /**
@@ -2315,7 +3516,12 @@ function 式として読む(行: string, line: number, errors: DslError[]): DslF
     });
     return undefined;
   }
-  return { id: 名前, expression: 式, ...(名札 !== undefined ? { label: 名札 } : {}), pos: { line } };
+  return {
+    id: 名前,
+    expression: 式,
+    ...(名札 !== undefined ? { label: 名札 } : {}),
+    pos: { line },
+  };
 }
 
 /** 組の中の項目名の形。 `parseInlineMapping` が項目名として受ける字と同じ */
@@ -2348,7 +3554,9 @@ function 式の組を読む(
 ): { expression: string; label?: string } | undefined {
   const 使える = ["expression", "label"];
   const 読めた: Record<string, string> = {};
-  for (const 欄 of splitInlineFields(中身).map((s) => s.trim()).filter((s) => s !== "")) {
+  for (const 欄 of splitInlineFields(中身)
+    .map((s) => s.trim())
+    .filter((s) => s !== "")) {
     const m = 欄.match(組の項目名);
     if (!m) {
       errors.push({
@@ -2419,19 +3627,40 @@ export const ACTOR_INLINE_VALUE_KINDS = {
   posY: "数",
   posW: "数",
   posH: "数",
+  titleFontSize: "数",
+  markGap: "数",
+  milestone: "真偽",
+  rowRules: "真偽",
+  rowStripe: "真偽",
 } as const satisfies Record<string, 値の形>;
 
-/** 縦に並べる形で箱に書ける、数と真偽の欄 (#1306)。 `posW` / `posH` は `大きさ:` が受ける */
+/**
+ * 縦に並べる形で箱に書ける、数と真偽の欄 (#1306)。 `posW` / `posH` は `大きさ:` が受ける。
+ *
+ * 始まりと終わりの印 (`initial` / `final`) は #2346 で足した。 中括弧の表にはあったのに
+ * こちらに無く、**段を分けた側には書き方が 1 つも無かった** = 書くと綴りの誤りとして落ちる
+ */
 export const ACTOR_BLOCK_VALUE_KINDS = {
   stack: "数",
   posX: "数",
   posY: "数",
+  initial: "真偽",
+  final: "真偽",
+  titleFontSize: "数",
+  markGap: "数",
+  milestone: "真偽",
+  rowRules: "真偽",
+  rowStripe: "真偽",
 } as const satisfies Record<string, 値の形>;
 
 /** 矢印の中括弧に書ける、数と真偽の欄 (#1306) */
 export const FLOW_INLINE_VALUE_KINDS = {
   labelOffsetX: "数",
   labelOffsetY: "数",
+  posX1: "数",
+  posY1: "数",
+  posX2: "数",
+  posY2: "数",
   overlay: "真偽",
 } as const satisfies Record<string, 値の形>;
 
@@ -2520,10 +3749,10 @@ function parseInlineMapping(inner: string): Record<string, string> {
     // 読める名前を広げても、**知っている名前しか使われない**。 パーツの状態の上書きに
     // 流れるのは `ACTOR_RESERVED_FIELDS` に無い名前だけで、日本語の項目名 (`位置` / `大きさ`
     // 等) はそこに載せてあるため、これまでどおり落ちる
-    const m = p.match(/^\s*([^\s:,{}[\]"']+)\s*:\s*(.+?)\s*$/);
+    const m = p.match(/^\s*(?:"([^"]+)"|'([^']+)'|([^\s:,{}[\]"']+))\s*:\s*(.+?)\s*$/);
     if (m) {
-      const key = m[1]!;
-      out[key] = stripQuotes(m[2]!.trim());
+      const key = m[1] ?? m[2] ?? m[3]!;
+      out[key] = stripQuotes(m[4]!.trim());
     }
   }
   return out;
@@ -2541,7 +3770,7 @@ function writtenScaleFields(inner: string): Map<string, string> {
   for (const field of splitInlineFields(inner)) {
     const idx = field.indexOf(":");
     if (idx < 0) continue;
-    const key = field.slice(0, idx).trim();
+    const key = stripQuotes(field.slice(0, idx).trim());
     if (!SCALE_KEYS.has(key)) continue;
     // 同じ名前を 2 度書いたら後の値を採る
     out.set(key, stripQuotes(field.slice(idx + 1).trim()));
@@ -2613,6 +3842,81 @@ function splitInlineFields(inner: string): string[] {
   return 見た.閉じた ? 見た.parts : 引用符を見て割る(false).parts;
 }
 
+/** 行頭の印を、従来の語または色の段を持つ組として読む。 */
+function 行頭の印の並びとして読む(
+  raw: string,
+  line: number,
+  errors: DslError[],
+): DslActor["marks"] {
+  if (!raw.includes("{")) {
+    return raw
+      .replace(/^\[|\]$/g, "")
+      .split(/,(?![^[]*\])/)
+      .map((x) => 行頭の語へ読み替える(stripQuotes(x.trim())));
+  }
+  const value = JSONの欄を読む(raw, "marks", line, errors);
+  if (!Array.isArray(value)) {
+    errors.push({ line, message: "marks は並びで書きます" });
+    return undefined;
+  }
+  const out: NonNullable<DslActor["marks"]> = [];
+  value.forEach((item, index) => {
+    if (typeof item === "string") {
+      out.push(行頭の語へ読み替える(item));
+      return;
+    }
+    if (!objectか(item)) {
+      errors.push({ line, message: `marks[${index}] の値の形が読めません` });
+      return;
+    }
+    const 受ける項目 = ["mark", "tone"] as const;
+    const unknown = Object.keys(item).filter((key) => !(受ける項目 as readonly string[]).includes(key));
+    if (unknown.length > 0) {
+      for (const key of unknown) errors.push({ line, message: `marks[${index}] の項目名が読めません: "${key}"`, hint: `使える項目 = ${受ける項目.join(", ")}` });
+      return;
+    }
+    if (typeof item.mark !== "string") {
+      errors.push({ line, message: `marks[${index}].mark は文字で書きます` });
+      return;
+    }
+    if (item.tone !== undefined && !(ROW_MARK_TONE_VALUES as readonly unknown[]).includes(item.tone)) {
+      const shown = typeof item.tone === "string" ? item.tone : (JSON.stringify(item.tone) ?? typeof item.tone);
+      errors.push({ line, message: `marks[${index}].tone が読めません: "${shown}"`, hint: `使える値 = ${ROW_MARK_TONE_VALUES.join(", ")}` });
+      return;
+    }
+    out.push({
+      mark: 行頭の語へ読み替える(item.mark),
+      ...(item.tone === undefined ? {} : { tone: item.tone as "primary" | "muted" }),
+    });
+  });
+  return out;
+}
+
+/**
+ * 字下げした行を 1 行も落とさずに集める (#2400)。
+ *
+ * 形が合うかを **ここでは見ない**。 集めた行は呼出側の読み手 (`parseFlowStep` /
+ * `parseStateEntry` / `parseLane` 等) へ渡し、読めない行は読み手が「…の行が読めません」 として
+ * 報告する。
+ *
+ * **形の合わない行をここで捨てない**。 捨てると知らせにも図にも現れず、書いた人には
+ * 「1 行書いたのに増えない」 だけが残る (実測 = `states:` に `progress 0` と書くと
+ * 知らせ 0 件でその状態が消えた)。 判定を読み手 1 か所に寄せると、受ける形を広げた日に
+ * 集める側を直し忘れて黙る形も生まれない。
+ *
+ * **記法が受ける全ての節がここを通る** (#2406)。 以前は先頭の `- ` を外す版と外さない版の
+ * 2 つに分かれていたが、 形の合わない行を捨てない振る舞いが #2400 で揃った時点で違いが
+ * 「`- ` を外すかどうか」 の 1 行だけになり、 外す側へ寄せて 1 つにした。
+ *
+ * **外す側へ寄せると、 受ける形が増える節がある**。 まとめる前に測ると、 11 節のうち 8 節は
+ * 既に `- ` を受けており (5 節はここで外し、 3 節は読み手が自分で外していた)、 受けないのは
+ * `readouts` / `inputs` / `scrolls` の 3 節だけだった。 寄せると この 3 節も受ける =
+ * **既にある図の意味は 1 つも変わらず**、 節によって受ける形が違う不揃いが消える。
+ *
+ * **空行とコメント行はここで飛ばす**。 読み手はどれも「書いた指定」 として読むため、
+ * 渡すとコメントが誤りとして報告される (実測 = コロンを含むコメント `# めも: あ` が
+ * `状態の行が読めません` になっていた)。
+ */
 function collectIndentedList(
   lines: Line[],
   start: number,
@@ -2622,17 +3926,13 @@ function collectIndentedList(
   let i = start;
   while (i < lines.length) {
     const ln = lines[i]!;
-    if (!ln.trimmed) {
+    if (!ln.trimmed || ln.trimmed.startsWith("#")) {
       i += 1;
       continue;
     }
     if (ln.indent <= parentIndent) break;
-    if (ln.trimmed.startsWith("- ")) {
-      items.push({ ...ln, trimmed: ln.trimmed.slice(2).trim() });
-    } else if (ln.trimmed.includes(":")) {
-      // YAML 風 inline (key: value) は state 用 block で許容
-      items.push(ln);
-    }
+    // 先頭の `- ` を外して渡す。 外した形と、 YAML 風の `key: value` を読み手が同じに読む
+    items.push(ln.trimmed.startsWith("- ") ? { ...ln, trimmed: ln.trimmed.slice(2).trim() } : ln);
     i += 1;
   }
   return { items, next: i };
@@ -2741,7 +4041,7 @@ function applyContinuationLines(actor: DslActor, rest: Line[], errors: DslError[
   /** 倍率を名前ごとに最後に書いた行。 別名の優先順と行番号を取り違えないために保持する。 */
   const scaleLines = new Map<string, number>();
   /**
-   * 縦に並べて書かれた体験の道筋の欄 (#1251)。
+   * 縦に並べて書かれたユーザージャーニーの欄 (#1251)。
    *
    * パーツでは状態の上書きとして意味を持つため、どちらに入れるかは block を読み終わってから
    * 決める。 `kind:` の行が後ろに書かれることもあり、読んだ時点ではパーツか分からない。
@@ -2801,6 +4101,111 @@ function applyContinuationLines(actor: DslActor, rest: Line[], errors: DslError[
       case "補足":
         out.subtitle = stripQuotes(raw);
         break;
+      case "kindForm": {
+        const value = stripQuotes(raw);
+        if (value === "icon") out.kindForm = value;
+        else errors.push({ line: ln.no, message: `箱の kindForm が読めません: "${value}"`, hint: `使える値 = ${KIND_FORM_VALUES.join(", ")}` });
+        break;
+      }
+      case "icon": {
+        const value = stripQuotes(raw);
+        if ((CDL_ICON_VALUES as readonly string[]).includes(value)) out.icon = value as NonNullable<DslActor["icon"]>;
+        else errors.push({ line: ln.no, message: `箱の icon が読めません: "${value}"`, hint: `使える値 = ${CDL_ICON_VALUES.join(", ")}` });
+        break;
+      }
+      case "emptyRowsNote":
+        out.emptyRowsNote = stripQuotes(raw);
+        break;
+      case "titleAlign": {
+        const value = stripQuotes(raw);
+        if (value === "center") out.titleAlign = value;
+        else errors.push({ line: ln.no, message: `箱の titleAlign が読めません: "${value}"`, hint: `使える値 = ${TITLE_ALIGN_VALUES.join(", ")}` });
+        break;
+      }
+      case "rowRules": {
+        const read = 表で読む(ACTOR_BLOCK_VALUE_KINDS, { rowRules: raw }, "箱の ", ln.no, errors);
+        out.rowRules = read.rowRules;
+        break;
+      }
+      case "rowStripe": {
+        const read = 表で読む(ACTOR_BLOCK_VALUE_KINDS, { rowStripe: raw }, "箱の ", ln.no, errors);
+        out.rowStripe = read.rowStripe;
+        break;
+      }
+      case "rowLayout":
+        out.rowLayout = 行の配置として読む(raw, ln.no, errors);
+        break;
+      case "rowDividerForm": {
+        const value = stripQuotes(raw);
+        if (value === "full") out.rowDividerForm = value;
+        else errors.push({ line: ln.no, message: `箱の rowDividerForm が読めません: "${value}"`, hint: `使える値 = ${ROW_DIVIDER_FORM_VALUES.join(", ")}` });
+        break;
+      }
+      case "rowWell":
+        out.rowWell = 行の受け皿として読む(raw, ln.no, errors);
+        break;
+      case "rowMarkForm": {
+        const value = stripQuotes(raw);
+        if (value === "tone") out.rowMarkForm = value;
+        else errors.push({ line: ln.no, message: `箱の rowMarkForm が読めません: "${value}"`, hint: `使える値 = ${ROW_MARK_FORM_VALUES.join(", ")}` });
+        break;
+      }
+      case "nestIn":
+        out.nestIn = stripQuotes(raw);
+        break;
+      case "figureCard": {
+        const value = JSONの欄を読む(raw, "figureCard", ln.no, errors);
+        const unknown = 図表の知らない項目を知らせる(value, ["label", "note"] as const, "figureCard", ln.no, errors);
+        if (!unknown && objectか(value) && typeof value.label === "string" && (value.note === undefined || typeof value.note === "string")) out.figureCard = value as NonNullable<DslActor["figureCard"]>;
+        else if (!unknown && value !== undefined) errors.push({ line: ln.no, message: "figureCard の値の形が読めません" });
+        break;
+      }
+      case "stationNamePosition":
+        if (stripQuotes(raw) === "bottom") out.stationNamePosition = "bottom";
+        break;
+      case "subtitlePlacement":
+        if (stripQuotes(raw) === "right") out.subtitlePlacement = "right";
+        break;
+      case "titleFontSize":
+      case "markGap": {
+        const read = 表で読む(ACTOR_BLOCK_VALUE_KINDS, { [key]: raw }, "箱の ", ln.no, errors);
+        if (key === "titleFontSize") out.titleFontSize = read.titleFontSize;
+        else out.markGap = read.markGap;
+        break;
+      }
+      case "milestone": {
+        const read = 表で読む(ACTOR_BLOCK_VALUE_KINDS, { milestone: raw }, "箱の ", ln.no, errors);
+        out.milestone = read.milestone;
+        break;
+      }
+      case "startLabel":
+        out.startLabel = stripQuotes(raw);
+        break;
+      case "emphasis": {
+        const value = stripQuotes(raw);
+        if (value === "primary") out.emphasis = value;
+        else errors.push({ line: ln.no, message: `箱の emphasis が読めません: "${value}"`, hint: "使える値 = primary" });
+        break;
+      }
+      /*
+       * 箱の目次と、始まりと終わりの印 (#2346)。
+       *
+       * 中括弧の形にしか無く、段を分けて書くと綴りの誤りとして落ちていた。
+       * 中括弧と同じく **見本 (parts) でも横取りしない** = この 3 つは
+       * `ACTOR_RESERVED_FIELDS` が状態の上書きから外しているので、どちらの形で書いても
+       * 見本の状態にはならない。
+       */
+      case "eyebrow":
+        out.eyebrow = stripQuotes(raw);
+        break;
+      case "initial":
+      case "final": {
+        // 中括弧と同じ表で読む。 読めない値の知らせも同じ文になる
+        const 読めた = 表で読む(ACTOR_BLOCK_VALUE_KINDS, { [key]: raw }, "箱の ", ln.no, errors);
+        if (key === "initial") out.initial = 読めた.initial;
+        else out.final = 読めた.final;
+        break;
+      }
       case "value":
       case "値":
         out.value = stripQuotes(raw);
@@ -2848,20 +4253,20 @@ function applyContinuationLines(actor: DslActor, rest: Line[], errors: DslError[
           .filter(Boolean);
         break;
       /*
-       * 行頭の印 (#1466)。 `rows` と同じ並びで、空文字はその行に印を付けない。
+       * 行頭の印 (#1466)。 `rows` と同じ並びで書く。
+       *
+       * **語は dragon の 3 つ** (`鍵` / `外` / `条件`)。 印の 3 軸 (下線 / 形 / 塗り) に
+       * 1 対 1 で当たる (`compile/row-marks.ts` が表を持つ)。
        *
-       * **語の意味は図の種類が決める**。 ER は `pk` / `fk` / `opt`、状態遷移は
-       * `entry` / `exit` / `do` / `internal`。 印の 2 軸 (形 × 塗り) は共通だが、その軸が
-       * 何を指すかは種類ごとに違う = 1 つの語彙に畳むと、どの図でも意味が合わない語が残る。
+       * 古い語 (`pk` / `fk` / `opt` / `entry` / `exit` / `do` / `internal`) はここで
+       * 3 語へ読み替える (#2782)。 **読み替えは読み取りの入口 1 か所に閉じる** =
+       * ここを通った後は古い語がどこにも残らないので、組み立て側は 3 語だけを扱う。
        *
        * 空の要素を捨てない (`filter(Boolean)` を掛けない) = 並びが `rows` とずれる。
        */
       case "marks":
       case "印":
-        out.marks = raw
-          .replace(/^\[|\]$/g, "")
-          .split(/,(?![^[]*\])/)
-          .map((x) => stripQuotes(x.trim()));
+        out.marks = 行頭の印の並びとして読む(raw, ln.no, errors);
         break;
       case "位置":
       case "pos": {
@@ -2909,6 +4314,11 @@ function applyContinuationLines(actor: DslActor, rest: Line[], errors: DslError[
       case "posY":
         out.posY = 数として読む(raw, "箱の posY", ln.no, errors);
         break;
+      case "at":
+      case "点の位置":
+        out.at = 四象限の座標として控える(raw);
+        out.atPos = { line: ln.no };
+        break;
       // 位置のずらし (#1971)。 中括弧の形と同じ表で読み、片方だけ書いた時は残りを 0 とする
       case "offsetX":
       case "offsetY": {
@@ -2941,12 +4351,15 @@ function applyContinuationLines(actor: DslActor, rest: Line[], errors: DslError[
       }
       case "touchpoint":
       case "opportunity":
+      case "opportunityPosition":
       case "owner":
       case "end":
+      case "stage":
+      case "段階":
         // **どちらに入れるかは block を読み終わるまで決まらない** (#1251 Round 1 の指摘)。
         // パーツかどうかは `kind:` の行で決まり、それが後ろに書かれることもある。
         // 倍率 (`scaleWritten`) と読めない項目名 (`unknownKeys`) が同じ理由で後回しにしている
-        図種ごとの欄.set(key, stripQuotes(raw));
+        図種ごとの欄.set(key === "段階" ? "stage" : key, stripQuotes(raw));
         break;
       case "lane":
         out.lane = stripQuotes(raw);
@@ -2969,7 +4382,7 @@ function applyContinuationLines(actor: DslActor, rest: Line[], errors: DslError[
     out.scale = s.scale;
     out.scaleKeys = [...new Set([...(actor.scaleKeys ?? []), ...s.keys])];
   }
-  // 体験の道筋の欄は、パーツなら状態の上書き、そうでなければ道筋の欄として入れる
+  // ユーザージャーニーの欄は、パーツなら状態の上書き、そうでなければ道筋の欄として入れる
   for (const [key, v] of 図種ごとの欄) {
     if (out.partId !== undefined) {
       state[key] = coerceStateValue(v);
@@ -2978,8 +4391,20 @@ function applyContinuationLines(actor: DslActor, rest: Line[], errors: DslError[
     }
     if (key === "touchpoint") out.touchpoint = v;
     else if (key === "opportunity") out.opportunity = v;
+    else if (key === "opportunityPosition") {
+      if ((JOURNEY_OPPORTUNITY_POSITION_VALUES as readonly string[]).includes(v)) {
+        out.opportunityPosition = v as DslActor["opportunityPosition"];
+      } else {
+        errors.push({
+          line: actor.pos.line,
+          message: `opportunityPosition が読めません: "${v}"`,
+          hint: `使える値 = ${JOURNEY_OPPORTUNITY_POSITION_VALUES.join(", ")}`,
+        });
+      }
+    }
     else if (key === "owner") out.owner = v;
-    else out.end = v;
+    else if (key === "end") out.end = v;
+    else out.stage = v;
   }
   // 状態も倍率も parts でだけ意味を持つ。 パーツなら知らせずに返す
   if (out.partId !== undefined) {
@@ -3019,7 +4444,7 @@ function applyContinuationLines(actor: DslActor, rest: Line[], errors: DslError[
     errors.push({
       line: u.line,
       message: `項目名が読めません: "${u.key}"`,
-      hint: `使える項目 = ${[...ACTOR_ITEM_KEYS].join(", ")}`,
+      hint: 弾いた項目の案内(u.key),
     });
   }
   return out;
@@ -3035,6 +4460,22 @@ export const ACTOR_ITEM_KEYS: ReadonlySet<string> = new Set([
   "kind",
   "種類",
   "subtitle",
+  "kindForm",
+  "icon",
+  "emptyRowsNote",
+  "titleAlign",
+  "rowRules",
+  "rowStripe",
+  "rowLayout",
+  "rowDividerForm",
+  "rowWell",
+  "rowMarkForm",
+  "nestIn",
+  "figureCard",
+  "stationNamePosition",
+  "subtitlePlacement",
+  "titleFontSize",
+  "markGap",
   "補足",
   "value",
   "値",
@@ -3074,14 +4515,61 @@ export const ACTOR_ITEM_KEYS: ReadonlySet<string> = new Set([
   "scale",
   "lane",
   "stack",
-  // 体験の道筋の欄 (#1251)
+  "stage",
+  "段階",
+  // ユーザージャーニーの欄 (#1251)
   "touchpoint",
   "opportunity",
+  "opportunityPosition",
   // 工程の並びの欄 (#1251)
   "owner",
   "end",
+  "startLabel",
+  "milestone",
+  "emphasis",
+  "at",
+  "点の位置",
+  // 箱の目次と、始まりと終わりの印 (#2346)。 中括弧にしか書き方が無かった 3 件
+  "eyebrow",
+  "initial",
+  "final",
 ]);
 
+/**
+ * 部品の箱にだけ効く項目 (#1026)。
+ *
+ * 普通の箱に書いた時は綴りの誤りとして知らせる。 黙って捨てると
+ * 「書いたのに大きさが変わらない」 が手掛かりなしで起きるため。
+ */
+export const PARTS_ONLY_ITEM_KEYS: ReadonlySet<string> = new Set(["倍率", "scale"]);
+
+/**
+ * 項目名を弾いた時の案内 (#2330)。
+ *
+ * **いま弾いた名前を「使える項目」 として並べない**。 語彙には `倍率` と `scale` が
+ * 入っているので、そのまま並べると読み手は同じ名前を書き直して同じ知らせを受ける
+ * (実測 = 語彙のうち普通の箱で弾かれるのはこの 2 件だけ)。
+ *
+ * 部品にだけ効く項目は **どこでなら書けるか** を出す。 綴りの誤りは語彙を並べる =
+ * そちらは弾いた名前が語彙に無いので食い違わない。
+ */
+function 弾いた項目の案内(key: string): string {
+  if (PARTS_ONLY_ITEM_KEYS.has(key)) {
+    return "`倍率` と `scale` は部品の箱 (`kind` に部品の名前を書いた箱) にだけ効きます";
+  }
+  /*
+   * 1 行の中括弧でだけ読める名前 (#2346)。
+   *
+   * 語彙を並べるだけだと、**同じ名前が別の書き方で効くこと**が伝わらない =
+   * 読み手は綴りを誤ったと受け取り、正しい名前を書いたまま直しようがなくなる。
+   * #2344 で足した逆向きの案内 (中括弧で弾いた名前に段を分けた形を案内する) と対にする。
+   */
+  if (INLINE_ACTOR_KEYS.has(key)) {
+    return `段を分けた形では読めません。 \`- 名前: { ${key}: 値 }\` のように 1 行の中括弧に書くと効きます`;
+  }
+  return `使える項目 = ${[...ACTOR_ITEM_KEYS].filter((k) => k !== key).join(", ")}`;
+}
+
 /**
  * 相対で書かれた位置が解けるかを確かめる。
  *
@@ -3159,14 +4647,16 @@ function collectActorEntries(
   lines: Line[],
   start: number,
   parentIndent: number,
-): { items: Line[][]; next: number } {
+): { items: Line[][]; 届かない: Line[]; next: number } {
   const items: Line[][] = [];
+  /** 1 件の頭にも続きにもならなかった行 (#2400)。 呼出側が知らせにする */
+  const 届かない: Line[] = [];
   let cur: Line[] | null = null;
   let headIndent = -1;
   let i = start;
   while (i < lines.length) {
     const ln = lines[i]!;
-    if (!ln.trimmed) {
+    if (!ln.trimmed || ln.trimmed.startsWith("#")) {
       i += 1;
       continue;
     }
@@ -3178,25 +4668,34 @@ function collectActorEntries(
     } else if (cur && ln.indent > headIndent) {
       // 頭より深い字下げは、 直前の 1 件の続き
       cur.push(ln);
+    } else {
+      // 続きにも頭にもならない行を **捨てない** (#2400)。 呼出側が「読めません」 として知らせる。
+      // 捨てると `- ` を書き落とした 1 行が知らせにも図にも現れない (実測 = 箱が 1 つ消えた)
+      //
+      // **ここで 1 件の頭にはしない**。 `- Web:` と同じ深さに書いた `補足: "..."` が
+      // 登場人物 `補足` になり、書き間違いが別の意味に化ける (#1367 の検査が守っている形)
+      届かない.push(ln);
     }
     i += 1;
   }
   if (cur) items.push(cur);
-  return { items, next: i };
+  return { items, 届かない, next: i };
 }
 
 function collectAnimationSteps(
   lines: Line[],
   start: number,
   parentIndent: number,
-): { items: Line[][]; next: number } {
+): { items: Line[][]; 届かない: Line[]; next: number } {
   // 各 `- step: "..."` 開始を 1 block の頭として識別、 後続の同 indent 以下を block 本文として吸収
   const out: Line[][] = [];
+  /** どの段にも属さなかった行 (#2400)。 呼出側が知らせにする */
+  const 届かない: Line[] = [];
   let i = start;
   let cur: Line[] | null = null;
   while (i < lines.length) {
     const ln = lines[i]!;
-    if (!ln.trimmed) {
+    if (!ln.trimmed || ln.trimmed.startsWith("#")) {
       i += 1;
       continue;
     }
@@ -3210,11 +4709,15 @@ function collectAnimationSteps(
     } else if (cur) {
       // 続く property line (focus / tween / set / badge / description)
       cur.push(ln);
+    } else {
+      // 最初の段が始まる前の行を **捨てない** (#2400)。 呼出側が「読めません」 として知らせる。
+      // 捨てると `- ` を書き落とした段が丸ごと黙って消える
+      届かない.push(ln);
     }
     i += 1;
   }
   if (cur) out.push(cur);
-  return { items: out, next: i };
+  return { items: out, 届かない, next: i };
 }
 
 /**
@@ -3226,6 +4729,18 @@ function collectAnimationSteps(
 export const ACTOR_RESERVED_FIELDS: ReadonlySet<string> = new Set([
   "kind",
   "subtitle",
+  "kindForm",
+  "icon",
+  "emptyRowsNote",
+  "titleAlign",
+  "rowRules",
+  "rowStripe",
+  "rowLayout",
+  "rowDividerForm",
+  "rowWell",
+  "rowMarkForm",
+  "nestIn",
+  "figureCard",
   "eyebrow",
   "value",
   "previous",
@@ -3233,10 +4748,15 @@ export const ACTOR_RESERVED_FIELDS: ReadonlySet<string> = new Set([
   "marks",
   "lane",
   "stack",
+  "stage",
   "initial",
   "final",
+  "startLabel",
+  "milestone",
+  "emphasis",
+  "at",
   "state",
-  // 体験の道筋の欄 (`touchpoint` / `opportunity`) はここに載せない (#1251 Round 1 の指摘)。
+  // ユーザージャーニーの欄 (`touchpoint` / `opportunity`) はここに載せない (#1251 Round 1 の指摘)。
   // 載せるとパーツで同じ名前の状態を書いた時に横取りされる = 既に動いている見本が静かに変わる。
   // パーツでない箱でだけ道筋の欄として読む (`parseActor` / `applyContinuationLines` が分岐する)
   // canvas pivot 新 spec = 絶対座標 4 field (dragon canvas pivot spec §layout-role-conversion)
@@ -3298,12 +4818,33 @@ function coerceStateValue(raw: string): number | string | boolean {
   return stripped;
 }
 
+/** 四象限の座標を `[x, y]` の順で控える。 妥当性は CompileNotice を出せる組み立て側で見る。 */
+function 四象限の座標として控える(raw: string): DslActor["at"] {
+  const value = raw.trim();
+  const inner = value.startsWith("[") && value.endsWith("]") ? value.slice(1, -1) : value;
+  const parts = splitTopLevelCommas(inner).map((part) => stripQuotes(part.trim()));
+  const 読む = (part: string | undefined): number | string | undefined => {
+    if (part === undefined || part === "") return undefined;
+    const n = Number(part);
+    return Number.isFinite(n) ? n : part;
+  };
+  return { x: 読む(parts[0]), y: 読む(parts[1]), raw: value };
+}
+
 /**
  * パーツでない箱に倍率を書いた時に知らせる (#1026)。
  *
  * 倍率はパーツにしか効かない。 黙って捨てると「書いたのに大きさが変わらない」 が手掛かり
  * なしで起きる。 3 つの書き方すべてで同じ知らせを出す (縦に並べた形だけ知らせて他が黙る、
  * という状態を作らない)。
+ *
+ * **案内に語彙を並べない** (#2330)。 語彙には `倍率` と `scale` が入っているので、
+ * 並べると **いま弾いた名前を「使える項目」 として出す** ことになる。 読み手は同じ名前を
+ * 書き直して同じ知らせを受ける (実測 = 案内の 39 項目のうち、弾かれるのはこの 2 件だけ)。
+ *
+ * 弾く理由はここが知っている (`isPart === false`) ので、**どこでなら書けるか** を出す。
+ * 綴りの誤りを知らせる側 (`unknownKeys`) は語彙を並べたままにする = そちらは弾いた名前が
+ * 語彙に無いため食い違わない。
  */
 function reportScaleOnNonPart(
   isPart: boolean,
@@ -3314,54 +4855,40 @@ function reportScaleOnNonPart(
   if (isPart || key === undefined) return;
   errors.push({
     line,
-    message: `項目名が読めません: "${key}"`,
-    hint: `使える項目 = ${[...ACTOR_ITEM_KEYS].join(", ")}`,
-  });
-}
-
-/**
- * 中括弧の形で読める日本語と、その英語名 (#1301)。
- *
- * **英語が中括弧で読める欄だけを載せる**。 `位置` / `大きさ` / `色` は英語側
- * (`pos` / `size` / `color`) も中括弧では読めないため載せない = 英語で出来ないことを
- * 日本語で出来るようにはしない。
- *
- * 載せる前は、同じ意味の語が縦書きでは通り中括弧では「項目名が読めません」 になっていた。
- * 書き方によって日本語だけが落ちる状態を無くす。
- */
-export const INLINE_ACTOR_ALIASES: Record<string, string> = {
-  種類: "kind",
-  補足: "subtitle",
-  値: "value",
-  前の値: "previous",
-  行: "rows",
-  印: "marks",
-};
-
-/** 中括弧に書かれた日本語の項目名を、同じ意味の英語名に寄せる (#1301) */
-function 中括弧の別名を寄せる(opts: Record<string, string>): Record<string, string> {
-  let 触った = false;
-  const out: Record<string, string> = { ...opts };
-  for (const [日, 英] of Object.entries(INLINE_ACTOR_ALIASES)) {
-    if (!(日 in out)) continue;
-    触った = true;
-    // 英語を併記した時は英語を優先する (縦書き形が後勝ちなのと違い、こちらは 1 行に同居する)
-    if (!(英 in out)) out[英] = out[日]!;
-    delete out[日];
-  }
-  return 触った ? out : opts;
+    message: `項目名が読めません: "${key}"`,
+    hint: 弾いた項目の案内(key),
+  });
 }
 
 /**
- * 中括弧の形で読める項目名。
+ * 中括弧の形で読める英語の項目名 (#2344 で `INLINE_ACTOR_KEYS` から分けた)。
  *
  * ここに無い名前は、 パーツでない箱ではどこにも入らずに消える。 `ACTOR_ITEM_KEYS` (縦に
  * 並べた形) とは別に持つ = 中括弧の形は位置や大きさ (`pos` / `size` / `scale`) を未対応にしてあり、
  * 同じ集合にすると「知らせない」 側がずれる。
+ *
+ * **日本語の別名を混ぜない**。 別名は `ACTOR_ITEM_ALIASES` をこの集合で絞って導くため、
+ * 混ぜると導く側と導かれる側が輪になる。 日本語も含む一覧は `INLINE_ACTOR_KEYS` が持つ。
  */
-export const INLINE_ACTOR_KEYS: ReadonlySet<string> = new Set([
+const INLINE_ACTOR_ENGLISH_KEYS: ReadonlySet<string> = new Set([
   "kind",
   "subtitle",
+  "kindForm",
+  "icon",
+  "emptyRowsNote",
+  "titleAlign",
+  "rowRules",
+  "rowStripe",
+  "rowLayout",
+  "rowDividerForm",
+  "rowWell",
+  "rowMarkForm",
+  "nestIn",
+  "figureCard",
+  "stationNamePosition",
+  "subtitlePlacement",
+  "titleFontSize",
+  "markGap",
   "eyebrow",
   "value",
   "previous",
@@ -3369,18 +4896,24 @@ export const INLINE_ACTOR_KEYS: ReadonlySet<string> = new Set([
   "marks",
   "lane",
   "stack",
+  "stage",
   "initial",
   "final",
   "tone",
   // 色の欄 (#1969)。 縦に並べた形と JSON は `color` を受けるのに、中括弧の形だけが知らない
   // 項目名として落としていた。 見本 (parts) では従来どおり状態の上書きとして読む
   "color",
-  // 体験の道筋の欄 (#1251)。 他の図種では組み立て側が知らせる
+  // ユーザージャーニーの欄 (#1251)。 他の図種では組み立て側が知らせる
   "touchpoint",
   "opportunity",
+  "opportunityPosition",
   // 工程の並びの欄 (#1251)
   "owner",
   "end",
+  "startLabel",
+  "milestone",
+  "emphasis",
+  "at",
   "posX",
   "posY",
   "posW",
@@ -3404,7 +4937,72 @@ export const INLINE_ACTOR_KEYS: ReadonlySet<string> = new Set([
   // 同じ名前で 2 度知らせることになる
   "scale",
   "倍率",
-  // 英語が読める欄の日本語別名 (#1301)。 一覧は `INLINE_ACTOR_ALIASES` が持つ
+]);
+
+/**
+ * 箱の項目名の、日本語と英語の対応 (#1301 / #2344)。
+ *
+ * **段を分けた形が読む日本語名をすべて載せる**。 中括弧で読めるかはここでは決めず、
+ * `INLINE_ACTOR_ALIASES` が英語側の可否で絞る。
+ *
+ * 載せる場所を 1 つにしたのは、**中括弧の別名を別に手で並べていた間、英語の欄を
+ * 中括弧に足した日に日本語名だけが取り残された**ため (`title` は #1381、`tone` は #1969、
+ * `shape` は #1374 で足り、日本語名は 3 件とも置き去りになっていた)。
+ *
+ * `倍率` は箱の欄を持たない (部品にだけ効く、#1026)。 ここには載せず、
+ * `PARTS_ONLY_ITEM_KEYS` と `reportScaleOnNonPart` が受け持つ。
+ */
+export const ACTOR_ITEM_ALIASES: Record<string, string> = {
+  種類: "kind",
+  題: "title",
+  補足: "subtitle",
+  色: "tone",
+  行: "rows",
+  印: "marks",
+  大きさ: "size",
+  図形: "shape",
+  値: "value",
+  前の値: "previous",
+  位置: "pos",
+  出す条件: "visibleIf",
+  段階: "stage",
+  点の位置: "at",
+};
+
+/**
+ * 中括弧の形で読める日本語と、その英語名 (#1301 / #2344)。
+ *
+ * **英語が中括弧で読める欄だけに絞る** = 英語で出来ないことを日本語で出来るようにはしない。
+ * `位置` (`pos`) と `大きさ` (`size`) はここで落ちる。
+ *
+ * **絞り込みは実装から導く**。 手で並べていた間、`題` / `色` / `図形` / `出す条件` の 4 件が
+ * 英語側は中括弧で読めるのに日本語だけ落ちていた (実測)。
+ */
+export const INLINE_ACTOR_ALIASES: Record<string, string> = Object.fromEntries(
+  Object.entries(ACTOR_ITEM_ALIASES).filter(([, 英]) => INLINE_ACTOR_ENGLISH_KEYS.has(英)),
+);
+
+/** 中括弧に書かれた日本語の項目名を、同じ意味の英語名に寄せる (#1301) */
+function 中括弧の別名を寄せる(opts: Record<string, string>): Record<string, string> {
+  let 触った = false;
+  const out: Record<string, string> = { ...opts };
+  for (const [日, 英] of Object.entries(INLINE_ACTOR_ALIASES)) {
+    if (!(日 in out)) continue;
+    触った = true;
+    // 英語を併記した時は英語を優先する (縦書き形が後勝ちなのと違い、こちらは 1 行に同居する)
+    if (!(英 in out)) out[英] = out[日]!;
+    delete out[日];
+  }
+  return 触った ? out : opts;
+}
+
+/**
+ * 中括弧の形で読める項目名 (英語と、英語が読める欄の日本語別名)。
+ *
+ * 別名は `INLINE_ACTOR_ALIASES` が `ACTOR_ITEM_ALIASES` から導く (#1301 / #2344)。
+ */
+export const INLINE_ACTOR_KEYS: ReadonlySet<string> = new Set([
+  ...INLINE_ACTOR_ENGLISH_KEYS,
   ...Object.keys(INLINE_ACTOR_ALIASES),
 ]);
 // `state` はパーツでだけ意味を持つ (`extractStateOverride` がパーツの時しか作らない)。
@@ -3447,7 +5045,7 @@ const EDGE_BIND_INLINE_READERS = {
 
 const FLOW_INLINE_READERS = {
   sub: (v: string | undefined) => v,
-  // クラス図の出どころ側の多重度 (#1771)。 `sub` (行き先の端) と対
+  // UML の関係の出どころ側の多重度 (#1771 / #2783)。 `sub` (行き先の端) と対
   tailSub: (v: string | undefined) => v,
   guard: (v: string | undefined) => v,
   cardinality: (v: string | undefined) => v,
@@ -3468,11 +5066,24 @@ const FLOW_INLINE_READERS = {
    */
   labelPlate: (v: string | undefined) =>
     v === undefined ? undefined : v !== "false" && v !== "なし",
+  labelCollision: (v: string | undefined) =>
+    v !== undefined && (LABEL_COLLISION_VALUES as readonly string[]).includes(v)
+      ? (v as "auto" | "author")
+      : undefined,
+  labelSize: (v: string | undefined) => v,
   // 矢印がどの辺から出るか (#1385)。 描画側は 4 方向を取り、書かなければ自動で選ぶ
   side: (v: string | undefined) =>
     v !== undefined && (EDGE_SIDE_VALUES as readonly string[]).includes(v)
       ? (v as "top" | "right" | "bottom" | "left")
       : undefined,
+  fromSide: (v: string | undefined) =>
+    v !== undefined && (EDGE_SIDE_VALUES as readonly string[]).includes(v)
+      ? (v as "top" | "right" | "bottom" | "left")
+      : undefined,
+  toSide: (v: string | undefined) =>
+    v !== undefined && (EDGE_SIDE_VALUES as readonly string[]).includes(v)
+      ? (v as "top" | "right" | "bottom" | "left")
+      : undefined,
   // 矢印の先の形 (#1462)。 書かなければ描画側の既定 (塗った三角) になる
   head: (v: string | undefined) =>
     v !== undefined && EDGE_HEAD_VALUES.includes(v) ? (v as EdgeHead) : undefined,
@@ -3485,7 +5096,7 @@ const FLOW_INLINE_READERS = {
   tailHeadFill: (v: string | undefined) =>
     v !== undefined && EDGE_HEAD_FILL_VALUES.includes(v) ? (v as EdgeHeadFill) : undefined,
   /*
-   * クラス図の関係の種類 (#1466)。 書くと **線と端の形と塗りと付く側** がまとめて決まる
+   * record の UML 関係の種類 (#1466 / #2783)。書くと **線と端の形と塗りと付く側** がまとめて決まる
    * (`CLASS_RELATION_LOOK`)。
    *
    * 4 つを個別に書かせない = 組合せは 6 通りしか無く、1 つでも書き違えると読み手に別の意味で
@@ -3513,10 +5124,15 @@ const FLOW_INLINE_READERS = {
    */
   fromPartNode: (v: string | undefined) => v,
   toPartNode: (v: string | undefined) => v,
+  waypoints: (v: string | undefined) => v,
   // 数と真偽の欄は `FLOW_INLINE_VALUE_KINDS` の表が読む (#1306)。 ここでは名前だけを持つ =
   // 読める欄の一覧 (`FLOW_INLINE_KEYS`) は本表から導くため、載せないと欄ごと消える
   labelOffsetX: null,
   labelOffsetY: null,
+  posX1: null,
+  posY1: null,
+  posX2: null,
+  posY2: null,
   overlay: null,
 } as const;
 
@@ -3553,7 +5169,7 @@ function reportUnknownInlineKeys(
   for (const field of splitInlineFields(inner)) {
     const idx = field.indexOf(":");
     if (idx < 0) continue;
-    const key = field.slice(0, idx).trim();
+    const key = stripQuotes(field.slice(0, idx).trim());
     if (!key) continue;
     if (isPart) {
       if (!PART_INLINE_UNREADABLE_KEYS.has(key)) continue;
@@ -3567,10 +5183,23 @@ function reportUnknownInlineKeys(
       continue;
     }
     if (INLINE_ACTOR_KEYS.has(key)) continue;
+    /*
+     * **段を分けて書けば効く名前には、その行き先を添える** (#2344)。
+     *
+     * `位置` / `大きさ` は段を分けた形では読める (英語の `pos` / `size` も同じ)。
+     * 使える項目の一覧だけを返すと、書いた人はその名前を諦めて別の書き方を探すことになる。
+     * 部品の箱は同じ状況を #1996 で既にこの文言で知らせており、こちらだけが外れていた。
+     *
+     * 判定は段を分けた形が読む一覧 (`ACTOR_ITEM_KEYS`) で行う = 日本語と英語を分けない。
+     * `size` を中括弧に書いた人も、同じ行き先を知りたい。
+     */
+    const 段を分ければ効く = ACTOR_ITEM_KEYS.has(key);
     errors.push({
       line,
       message: `項目名が読めません: "${key}"`,
-      hint: `使える項目 = ${[...INLINE_ACTOR_KEYS].join(", ")}`,
+      hint: 段を分ければ効く
+        ? `1 行の中括弧では読めません。名前の下に段を分けた形で書くと効きます`
+        : `使える項目 = ${[...INLINE_ACTOR_KEYS].join(", ")}`,
     });
   }
 }
@@ -3598,7 +5227,7 @@ function 中括弧の知らない項目名を知らせる(
   for (const field of splitInlineFields(inner)) {
     const idx = field.indexOf(":");
     if (idx < 0) continue;
-    const key = field.slice(0, idx).trim();
+    const key = stripQuotes(field.slice(0, idx).trim());
     if (!key || 使える.includes(key)) continue;
     // 接頭は値の欄名に続ける形 (`縦列 l1 の `) で末尾に空白を持つ。 日本語へ続ける時は空白を落とす
     errors.push({
@@ -3642,6 +5271,40 @@ function parseActor(line: Line, errors: DslError[]): DslActor | null {
     if (!isPart && opts.tone !== undefined && resolveTone(opts.tone) === undefined) {
       report読めない色(opts.tone, line.no, errors, { 線種も受ける: false });
     }
+    if (!isPart && opts.emphasis !== undefined && opts.emphasis !== "primary") {
+      errors.push({
+        line: line.no,
+        message: `箱の emphasis が読めません: "${opts.emphasis}"`,
+        hint: "使える値 = primary",
+      });
+    }
+    if (
+      !isPart && opts.opportunityPosition !== undefined &&
+      !(JOURNEY_OPPORTUNITY_POSITION_VALUES as readonly string[]).includes(opts.opportunityPosition)
+    ) {
+      errors.push({
+        line: line.no,
+        message: `opportunityPosition が読めません: "${opts.opportunityPosition}"`,
+        hint: `使える値 = ${JOURNEY_OPPORTUNITY_POSITION_VALUES.join(", ")}`,
+      });
+    }
+    const 閉じた箱の値 = <T extends string>(
+      key: string,
+      values: readonly T[],
+    ): T | undefined => {
+      const value = opts[key];
+      if (value === undefined || isPart) return undefined;
+      if ((values as readonly string[]).includes(value)) return value as T;
+      errors.push({ line: line.no, message: `箱の ${key} が読めません: "${value}"`, hint: `使える値 = ${values.join(", ")}` });
+      return undefined;
+    };
+    let actorFigureCard: DslActor["figureCard"];
+    if (!isPart && opts.figureCard !== undefined) {
+      const value = JSONの欄を読む(opts.figureCard, "figureCard", line.no, errors);
+      const unknown = 図表の知らない項目を知らせる(value, ["label", "note"] as const, "figureCard", line.no, errors);
+      if (!unknown && objectか(value) && typeof value.label === "string" && (value.note === undefined || typeof value.note === "string")) actorFigureCard = value as NonNullable<DslActor["figureCard"]>;
+      else if (!unknown && value !== undefined) errors.push({ line: line.no, message: "figureCard の値の形が読めません" });
+    }
     // `color` は縦に並べた形と JSON と同じ振り分けを通す (#1969)。 色の名前は箱の色、`#` で
     // 始まる値は色番号になる。
     //
@@ -3662,13 +5325,43 @@ function parseActor(line: Line, errors: DslError[]): DslActor | null {
       // 「書かなかった」 と同じ扱いにする (#1058)
       kindWritten: kindRaw !== "" && !isPart,
       subtitle: opts.subtitle,
+      kindForm: 閉じた箱の値("kindForm", KIND_FORM_VALUES),
+      icon: 閉じた箱の値("icon", CDL_ICON_VALUES),
+      emptyRowsNote: isPart ? undefined : opts.emptyRowsNote,
+      titleAlign: 閉じた箱の値("titleAlign", TITLE_ALIGN_VALUES),
+      rowMarkForm: 閉じた箱の値("rowMarkForm", ROW_MARK_FORM_VALUES),
+      rowDividerForm: 閉じた箱の値("rowDividerForm", ROW_DIVIDER_FORM_VALUES),
+      rowLayout:
+        isPart || opts.rowLayout === undefined
+          ? undefined
+          : 行の配置として読む(opts.rowLayout, line.no, errors),
+      rowWell:
+        isPart || opts.rowWell === undefined
+          ? undefined
+          : 行の受け皿として読む(opts.rowWell, line.no, errors),
+      nestIn: isPart ? undefined : opts.nestIn,
+      figureCard: actorFigureCard,
+      stationNamePosition:
+        opts.stationNamePosition === "bottom" ? opts.stationNamePosition : undefined,
+      subtitlePlacement:
+        opts.subtitlePlacement === "right" ? opts.subtitlePlacement : undefined,
       eyebrow: opts.eyebrow,
       // パーツでは状態の上書きとして意味を持つため、道筋の欄として横取りしない (#1251)
       touchpoint: isPart ? undefined : opts.touchpoint,
       opportunity: isPart ? undefined : opts.opportunity,
+      opportunityPosition:
+        isPart || opts.opportunityPosition === undefined ||
+        !(JOURNEY_OPPORTUNITY_POSITION_VALUES as readonly string[]).includes(opts.opportunityPosition)
+          ? undefined
+          : opts.opportunityPosition as DslActor["opportunityPosition"],
       // 見本では状態の上書きとして意味を持つため横取りしない (#1251)
       owner: isPart ? undefined : opts.owner,
       end: isPart ? undefined : opts.end,
+      startLabel: isPart ? undefined : opts.startLabel,
+      emphasis: isPart || opts.emphasis !== "primary" ? undefined : "primary",
+      at: isPart || opts.at === undefined ? undefined : 四象限の座標として控える(opts.at),
+      atPos: isPart || opts.at === undefined ? undefined : { line: line.no },
+      stage: isPart ? undefined : opts.stage,
       value: opts.value,
       previous: opts.previous,
       rows: opts.rows
@@ -3678,12 +5371,11 @@ function parseActor(line: Line, errors: DslError[]): DslActor | null {
             .map((x) => stripQuotes(x.trim()))
             .filter(Boolean)
         : undefined,
-      // 行頭の印 (#1466)。 `rows` と同じ並びなので **空の要素を捨てない**
+      // 行頭の印 (#1466)。 `rows` と同じ並びなので **空の要素を捨てない**。
+      // 古い語の読み替えは縦に並べた形と同じ関数を通す (#2782) = 片方だけ通すと、
+      // 中括弧で書いた `pk` が印を持たないまま通る
       marks: opts.marks
-        ? opts.marks
-            .replace(/^\[|\]$/g, "")
-            .split(/,(?![^[]*\])/)
-            .map((x) => stripQuotes(x.trim()))
+        ? 行頭の印の並びとして読む(opts.marks, line.no, errors)
         : undefined,
       lane: opts.lane,
       // 箱の中に描く図形 (#1374)。 パーツでは状態の上書きとして意味を持つため横取りしない
@@ -3814,12 +5506,17 @@ function parseFlowStep(line: Line, no: number, errors: DslError[]): DslStep | nu
       if (読み手 === null) continue;
       中括弧[k] = 読み手(opts[k]);
     }
-    if (opts.side !== undefined && 中括弧.side === undefined) {
-      errors.push({
-        line: line.no,
-        message: `矢印の side が読めません: "${opts.side}"`,
-        hint: `使える値 = ${EDGE_SIDE_VALUES.join(", ")}`,
-      });
+    for (const field of ["side", "fromSide", "toSide"] as const) {
+      if (opts[field] !== undefined && 中括弧[field] === undefined) {
+        errors.push({
+          line: line.no,
+          message: `矢印の ${field} が読めません: "${opts[field]}"`,
+          hint: `使える値 = ${EDGE_SIDE_VALUES.join(", ")}`,
+        });
+      }
+    }
+    if (opts.labelCollision !== undefined && 中括弧.labelCollision === undefined) {
+      errors.push({ line: line.no, message: `矢印の labelCollision が読めません: "${opts.labelCollision}"`, hint: `使える値 = ${LABEL_COLLISION_VALUES.join(", ")}` });
     }
     // 読めない語を黙って捨てない (#1462)。 捨てると「書いたのに端の形が変わらない」 が
     // 手掛かりなしで起きる
@@ -3849,6 +5546,8 @@ function parseFlowStep(line: Line, no: number, errors: DslError[]): DslStep | nu
   const guard = 中括弧.guard as string | undefined;
   const cardinality = 中括弧.cardinality as string | undefined;
   const side = 中括弧.side as "top" | "right" | "bottom" | "left" | undefined;
+  const fromSide = 中括弧.fromSide as "top" | "right" | "bottom" | "left" | undefined;
+  const toSide = 中括弧.toSide as "top" | "right" | "bottom" | "left" | undefined;
   const head = 中括弧.head as EdgeHead | undefined;
   const tailHead = 中括弧.tailHead as EdgeHead | undefined;
   const headFill = 中括弧.headFill as EdgeHeadFill | undefined;
@@ -3858,6 +5557,19 @@ function parseFlowStep(line: Line, no: number, errors: DslError[]): DslStep | nu
   // 辺の役目と名前の下地 (cdl#618)
   const role = 中括弧.role as "main" | undefined;
   const labelPlate = 中括弧.labelPlate as boolean | undefined;
+  const labelCollision = 中括弧.labelCollision as DslStep["labelCollision"];
+  let labelSize: DslStep["labelSize"];
+  if (中括弧.labelSize !== undefined) {
+    const value = JSONの欄を読む(中括弧.labelSize as string, "labelSize", line.no, errors);
+    if (objectか(value)) {
+      let invalid = 図表の知らない項目を知らせる(value, ["width", "height", "fontSize"], "labelSize", line.no, errors);
+      for (const key of ["width", "height", "fontSize"] as const) {
+        if (value[key] !== undefined && !正の有限数か(value[key])) invalid = true;
+      }
+      if (!invalid) labelSize = value;
+      else errors.push({ line: line.no, message: "labelSize の値の形が読めません" });
+    } else if (value !== undefined) errors.push({ line: line.no, message: "labelSize は object で書きます" });
+  }
   // 値に追随する 3 欄 (#1396)。 空は捨てずに知らせる = 描画側は空文字を既定値へ落とさず
   // そのまま置換に使うため、書き忘れが「線が消えた」 形で出る
   const widthBind = 追随する大きさとして読む(
@@ -3880,6 +5592,16 @@ function parseFlowStep(line: Line, no: number, errors: DslError[]): DslStep | nu
   );
   const labelOffsetX = 数と真偽?.labelOffsetX;
   const labelOffsetY = 数と真偽?.labelOffsetY;
+  const posX1 = 数と真偽?.posX1;
+  const posY1 = 数と真偽?.posY1;
+  const posX2 = 数と真偽?.posX2;
+  const posY2 = 数と真偽?.posY2;
+  const waypoints = 線の途中の点として読む(
+    中括弧.waypoints as string | undefined,
+    [posX1, posY1, posX2, posY2],
+    line.no,
+    errors,
+  );
   const overlay = 数と真偽?.overlay;
   // 空の名指し (`toPartNode: ""`) は書かなかったことにする = 要素 1 つの部品なら自動で繋ぐ
   const fromPartNode = (中括弧.fromPartNode as string | undefined) || undefined;
@@ -3942,6 +5664,8 @@ function parseFlowStep(line: Line, no: number, errors: DslError[]): DslStep | nu
     guard,
     cardinality,
     side,
+    fromSide,
+    toSide,
     head,
     tailHead,
     headFill,
@@ -3955,6 +5679,13 @@ function parseFlowStep(line: Line, no: number, errors: DslError[]): DslStep | nu
     dashOffsetBind,
     labelOffsetX,
     labelOffsetY,
+    posX1,
+    posY1,
+    posX2,
+    posY2,
+    waypoints,
+    labelCollision,
+    labelSize,
     overlay,
     ...(fromPartNode !== undefined ? { fromPartNode } : {}),
     ...(toPartNode !== undefined ? { toPartNode } : {}),
@@ -3962,12 +5693,35 @@ function parseFlowStep(line: Line, no: number, errors: DslError[]): DslStep | nu
   };
 }
 
-function parseStateEntry(text: string, lineNo: number): DslState | null {
-  // `client_bal: 100` / `status: "idle"`
+/**
+ * `client_bal: 100` / `status: "idle"` を 1 件の状態として読む。
+ *
+ * **2 つの断り方を分けて自分で報告する** (#2401)。 どちらも `null` にまとめると呼出側は
+ * 区別できず、名前の規則を外れただけの行にも形の案内が返る。 書いた本文は案内どおりの形なので
+ * **案内に従って書き直しても同じ案内が返り続ける** (実測 = `すすみ: 0` に
+ * 「`name: initial` の形で書く」 が返った)。
+ *
+ * 名前の判定と案内は `value-syntax.ts` が持つ。 値の節 (`parseValueEntry`) と同じ文を使うことで、
+ * 状態と値 × 記法と JSON の 4 経路で同じ理由が返る。
+ *
+ * 報告をここに置くと、呼出しを足した日に書き忘れても黙らない。 1 行にまとめた形の呼出しは
+ * 実際に分岐を 1 つも持たず、規則外の名前の状態が知らせも無く消えていた。
+ */
+function parseStateEntry(text: string, lineNo: number, errors: DslError[]): DslState | null {
   const m = text.match(/^([^:]+?)\s*:\s*(.+)$/);
-  if (!m) return null;
+  if (!m) {
+    errors.push({
+      line: lineNo,
+      message: `状態の行が読めません: "${text}"`,
+      hint: "`name: initial` の形で書く",
+    });
+    return null;
+  }
   const name = (m[1] ?? "").trim();
-  if (!isValueName(name)) return null;
+  if (!isValueName(name)) {
+    errors.push({ line: lineNo, ...valueNameIssue(name) });
+    return null;
+  }
   const raw = (m[2] ?? "").trim();
   const stripped = stripQuotes(raw);
   const asNum = Number(stripped);
@@ -3976,31 +5730,6 @@ function parseStateEntry(text: string, lineNo: number): DslState | null {
   return { name, initial, pos: { line: lineNo } };
 }
 
-/**
- * 字下げした行を 1 行も落とさずに集める。
- *
- * `collectIndentedList` は形が合わない行を黙って捨てるが、 `values` では捨てずに
- * 読み手 (`parseValueEntry`) へ渡して書き間違いとして報告させる。
- */
-function collectIndentedRaw(
-  lines: Line[],
-  start: number,
-  parentIndent: number,
-): { items: Line[]; next: number } {
-  const items: Line[] = [];
-  let i = start;
-  while (i < lines.length) {
-    const ln = lines[i];
-    if (!ln || !ln.trimmed || ln.trimmed.startsWith("#")) {
-      i += 1;
-      continue;
-    }
-    if (ln.indent <= parentIndent) break;
-    items.push(ln);
-    i += 1;
-  }
-  return { items, next: i };
-}
 
 /**
  * `waiting: "{inflow} - {done}"` を 1 件の値として読む。
@@ -4013,7 +5742,7 @@ function parseValueEntry(text: string, lineNo: number, errors: DslError[]): DslV
   if (!m) {
     errors.push({
       line: lineNo,
-      message: `invalid value entry: "${text}"`,
+      message: `値の行が読めません: "${text}"`,
       hint: '`waiting: "{inflow} - {done}"` の形で書く',
     });
     return null;
@@ -4044,7 +5773,7 @@ function parseValueEntry(text: string, lineNo: number, errors: DslError[]): DslV
   if (expression === "") {
     errors.push({
       line: lineNo,
-      message: `empty expression for "${name}"`,
+      message: `式が空です: "${name}"`,
       hint: '`"{a} + {b}"` のように式を書く',
     });
     return null;
@@ -4057,6 +5786,397 @@ function parseValueEntry(text: string, lineNo: number, errors: DslError[]): DslV
   return { name, expression, pos: { line: lineNo } };
 }
 
+/** JSON と同じ 1 行の配列 / object を、図表の複合欄で読む。 */
+function JSONの欄を読む(
+  source: string | null,
+  name: string,
+  line: number,
+  errors: DslError[],
+): unknown {
+  const raw = (source ?? "").trim();
+  try {
+    return JSON.parse(raw) as unknown;
+  } catch {
+    errors.push({
+      line,
+      message: `${name} の JSON の形が読めません`,
+      hint: `${name}: [...] または ${name}: {...} の形で 1 行に書く`,
+    });
+    return undefined;
+  }
+}
+
+const objectか = (value: unknown): value is Record<string, unknown> =>
+  value !== null && typeof value === "object" && !Array.isArray(value);
+const 図表の数か = (value: unknown): value is number | string =>
+  (typeof value === "number" && Number.isFinite(value)) ||
+  (typeof value === "string" && value.trim().length > 0);
+
+function 図表の知らない項目を知らせる(
+  value: unknown,
+  使える: readonly string[],
+  名: string,
+  line: number,
+  errors: DslError[],
+): boolean {
+  if (!objectか(value)) return false;
+  const 知らない = Object.keys(value).filter((key) => !使える.includes(key));
+  for (const key of 知らない) {
+    errors.push({
+      line,
+      message: `${名} の項目名が読めません: "${key}"`,
+      hint: `使える項目 = ${使える.join(", ")}`,
+    });
+  }
+  return 知らない.length > 0;
+}
+
+const 正の有限数か = (value: unknown): value is number =>
+  typeof value === "number" && Number.isFinite(value) && value > 0;
+const 負でない有限数か = (value: unknown): value is number =>
+  typeof value === "number" && Number.isFinite(value) && value >= 0;
+
+const CDL_0132_OBJECT_FIELDS = [
+  "terminalDecoration", "figureKindLabel", "figureInset", "journeySize", "chartBarSize", "chartLineSize",
+  "chartPieSize", "chartWaffleSize", "chartSlopeLabelTemplate", "chartSlopeSize", "chartStackedLayout",
+  "chartGaugeSize", "ganttSize", "quadrantSize", "legendOffset", "stageLayout",
+] as const;
+type Cdl0132ObjectField = (typeof CDL_0132_OBJECT_FIELDS)[number];
+
+const CDL_0132_KEYS: Record<Cdl0132ObjectField, readonly string[]> = {
+  terminalDecoration: ["windowControls", "cursor", "rowOrdinal"],
+  figureKindLabel: ["text", "x", "y", "fontSize", "fontWeight", "letterSpacing"],
+  figureInset: ["top", "right", "bottom", "left", "radius"],
+  journeySize: ["plotPadding", "pointPadding"],
+  chartBarSize: ["tickFontSize", "valueFontSize", "labelFontSize", "plotPadding", "barWidth", "cornerRadius"],
+  chartLineSize: ["valueLabelOffset", "tickFontSize", "periodFontSize", "pointRadius", "plotPadding", "tickGap", "pointPadding", "periodY"],
+  chartPieSize: ["tableWidth", "tableLabelFontSize", "tableValueFontSize", "tableRowGap", "tablePaddingInline", "outerRadius", "centerX"],
+  chartWaffleSize: ["gridLeft", "cellPitch"],
+  chartSlopeLabelTemplate: ["left", "right"],
+  chartSlopeSize: ["pointRadius", "periodFontSize", "labelFontSize", "leftAxisX", "axisGap", "labelAxisGap", "plotPadding", "pointPadding"],
+  chartStackedLayout: ["legendColumns", "legendColumnGap", "segmentGap", "barThickness", "barWidth", "legendMarkSize", "legendFontSize", "periodFontSize", "rateFontSize", "legendOffsetY"],
+  chartGaugeSize: ["arcThickness", "outerRadius", "plotTop", "valueFontSize"],
+  ganttSize: ["taskLabelFontSize", "taskLabelAlign", "taskLabelX", "tickFontSize", "tickCount", "barThickness", "milestoneFontSize", "milestoneRadius", "dependencyStrokeWidth", "taskColumnWidth", "timelinePaddingRight"],
+  quadrantSize: ["plotOffset", "plotSize", "pointRadius", "pointFontSize", "pointLabelGap", "quadrantFontSize", "axisFontSize"],
+  legendOffset: ["x", "y"],
+  stageLayout: ["columnWidths", "columnGap", "backDetourTopGap", "backDetourSideGap", "backDetourTargetInset"],
+};
+
+function cdl0132の欄を読む(
+  name: Cdl0132ObjectField,
+  value: unknown,
+  line: number,
+  errors: DslError[],
+): value is NonNullable<DslDocument[Cdl0132ObjectField]> {
+  if (!objectか(value)) {
+    errors.push({ line, message: `${name} は object で書きます` });
+    return false;
+  }
+  let invalid = 図表の知らない項目を知らせる(value, CDL_0132_KEYS[name], name, line, errors);
+  const positive = (key: string): void => {
+    if (value[key] !== undefined && !正の有限数か(value[key])) invalid = true;
+  };
+  const nonNegative = (key: string): void => {
+    if (value[key] !== undefined && !負でない有限数か(value[key])) invalid = true;
+  };
+  const nested = (key: string, keys: readonly string[], kind: "positive" | "nonNegative"): void => {
+    const item = value[key];
+    if (item === undefined) return;
+    if (!objectか(item)) { invalid = true; return; }
+    invalid = 図表の知らない項目を知らせる(item, keys, `${name}.${key}`, line, errors) || invalid;
+    for (const nestedKey of keys) {
+      if (item[nestedKey] === undefined) continue;
+      if (kind === "positive" ? !正の有限数か(item[nestedKey]) : !負でない有限数か(item[nestedKey])) invalid = true;
+    }
+  };
+  if (name === "terminalDecoration") {
+    for (const key of CDL_0132_KEYS[name]) if (value[key] !== undefined && typeof value[key] !== "boolean") invalid = true;
+  } else if (name === "figureKindLabel") {
+    if (typeof value.text !== "string" || value.text.trim() === "") invalid = true;
+    for (const key of ["x", "y"]) if (value[key] !== undefined && (typeof value[key] !== "number" || !Number.isFinite(value[key]))) invalid = true;
+    for (const key of ["fontSize", "fontWeight"]) positive(key);
+    nonNegative("letterSpacing");
+  } else if (name === "figureInset") {
+    for (const key of ["top", "right", "bottom", "left", "radius"]) nonNegative(key);
+  } else if (name === "journeySize") {
+    nested("plotPadding", ["left", "right"], "nonNegative");
+    nested("pointPadding", ["left", "right"], "nonNegative");
+  } else if (name === "chartBarSize") {
+    for (const key of ["tickFontSize", "valueFontSize", "labelFontSize", "barWidth"]) positive(key);
+    nested("plotPadding", ["top", "right", "bottom", "left"], "nonNegative");
+    nonNegative("cornerRadius");
+  } else if (name === "chartLineSize") {
+    for (const key of ["tickFontSize", "periodFontSize", "pointRadius"]) positive(key);
+    nested("valueLabelOffset", ["above", "below"], "nonNegative");
+    nested("plotPadding", ["top", "right", "bottom", "left"], "nonNegative");
+    nested("pointPadding", ["left", "right"], "nonNegative");
+    nonNegative("tickGap");
+    nonNegative("periodY");
+  } else if (name === "chartPieSize") {
+    for (const key of ["tableWidth", "tableLabelFontSize", "tableValueFontSize", "outerRadius"]) positive(key);
+    for (const key of ["tableRowGap", "tablePaddingInline"]) nonNegative(key);
+    nonNegative("centerX");
+  } else if (name === "chartWaffleSize") {
+    nonNegative("gridLeft");
+    positive("cellPitch");
+  } else if (name === "chartSlopeLabelTemplate") {
+    for (const key of CDL_0132_KEYS[name]) if (value[key] !== undefined && typeof value[key] !== "string") invalid = true;
+  } else if (name === "chartSlopeSize") {
+    for (const key of ["pointRadius", "periodFontSize", "labelFontSize", "axisGap"]) positive(key);
+    for (const key of ["leftAxisX", "labelAxisGap"]) nonNegative(key);
+    nested("plotPadding", ["top", "bottom"], "nonNegative");
+    nested("pointPadding", ["top", "bottom"], "nonNegative");
+  } else if (name === "chartStackedLayout") {
+    for (const key of ["barThickness", "barWidth", "legendMarkSize", "legendFontSize", "periodFontSize", "rateFontSize"]) positive(key);
+    for (const key of ["legendColumnGap", "segmentGap"]) nonNegative(key);
+    if (value.legendOffsetY !== undefined && (typeof value.legendOffsetY !== "number" || !Number.isFinite(value.legendOffsetY))) invalid = true;
+    if (value.legendColumns !== undefined && (!Number.isInteger(value.legendColumns) || !正の有限数か(value.legendColumns))) invalid = true;
+  } else if (name === "chartGaugeSize") {
+    for (const key of ["arcThickness", "outerRadius", "valueFontSize"]) positive(key);
+    nonNegative("plotTop");
+  } else if (name === "ganttSize") {
+    for (const key of ["taskLabelFontSize", "tickFontSize", "barThickness", "milestoneFontSize", "milestoneRadius", "dependencyStrokeWidth"]) positive(key);
+    nonNegative("taskLabelX");
+    nonNegative("taskColumnWidth");
+    nonNegative("timelinePaddingRight");
+    if (
+      value.taskLabelAlign !== undefined &&
+      !(GANTT_TASK_LABEL_ALIGN_VALUES as readonly unknown[]).includes(value.taskLabelAlign)
+    ) invalid = true;
+    if (value.tickCount !== undefined && (!Number.isInteger(value.tickCount) || typeof value.tickCount !== "number" || value.tickCount < 2)) invalid = true;
+  } else if (name === "quadrantSize") {
+    nested("plotOffset", ["x", "y"], "nonNegative");
+    for (const key of ["plotSize", "pointRadius", "pointFontSize", "quadrantFontSize", "axisFontSize"]) positive(key);
+    nonNegative("pointLabelGap");
+  } else if (name === "legendOffset") {
+    for (const key of ["x", "y"])
+      if (value[key] !== undefined && (typeof value[key] !== "number" || !Number.isFinite(value[key]))) invalid = true;
+  } else if (name === "stageLayout") {
+    nested("columnWidths", Object.keys(objectか(value.columnWidths) ? value.columnWidths : {}), "nonNegative");
+    for (const key of ["columnGap", "backDetourTopGap", "backDetourSideGap", "backDetourTargetInset"]) nonNegative(key);
+  }
+  if (invalid) errors.push({ line, message: `${name} の値の形が読めません` });
+  return !invalid;
+}
+
+function 木の寸法を読む(
+  value: unknown,
+  line: number,
+  errors: DslError[],
+): value is NonNullable<DslDocument["treeSize"]> {
+  if (!objectか(value)) {
+    errors.push({ line, message: "treeSize は object で書きます" });
+    return false;
+  }
+  let invalid = 図表の知らない項目を知らせる(value, TREE_SIZE_KEYS, "treeSize", line, errors);
+  if (
+    value.nodeWidths !== undefined &&
+    (!Array.isArray(value.nodeWidths) ||
+      value.nodeWidths.length === 0 ||
+      value.nodeWidths.some((width) => !正の有限数か(width)))
+  )
+    invalid = true;
+  for (const key of ["nodeHeight", "titleFontSize", "subtitleFontSize"] as const) {
+    if (value[key] !== undefined && !正の有限数か(value[key])) invalid = true;
+  }
+  for (const key of ["siblingGap", "levelGap"] as const) {
+    if (value[key] !== undefined && !負でない有限数か(value[key])) invalid = true;
+  }
+  if (invalid) errors.push({ line, message: "treeSize の値の形が読めません" });
+  return !invalid;
+}
+
+function 放射の寸法を読む(
+  value: unknown,
+  line: number,
+  errors: DslError[],
+): value is NonNullable<DslDocument["mindSize"]> {
+  if (!objectか(value)) {
+    errors.push({ line, message: "mindSize は object で書きます" });
+    return false;
+  }
+  let invalid = 図表の知らない項目を知らせる(value, MIND_SIZE_KEYS, "mindSize", line, errors);
+  const contentOffset = value.contentOffset;
+  if (contentOffset !== undefined) {
+    if (!objectか(contentOffset)) invalid = true;
+    else {
+      invalid =
+        図表の知らない項目を知らせる(
+          contentOffset,
+          ["x", "y"],
+          "mindSize.contentOffset",
+          line,
+          errors,
+        ) || invalid;
+      for (const key of ["x", "y"] as const) {
+        if (typeof contentOffset[key] !== "number" || !Number.isFinite(contentOffset[key])) {
+          invalid = true;
+        }
+      }
+    }
+  }
+  for (const [key, allowed] of [
+    ["root", ["width", "height", "fontSize"]],
+    ["branch", ["width", "height", "fontSize"]],
+    ["leaf", ["fontSize"]],
+  ] as const) {
+    const nested = value[key];
+    if (nested === undefined) continue;
+    if (!objectか(nested)) {
+      invalid = true;
+      continue;
+    }
+    invalid =
+      図表の知らない項目を知らせる(nested, allowed, `mindSize.${key}`, line, errors) || invalid;
+    for (const nestedKey of allowed) {
+      if (nested[nestedKey] !== undefined && !正の有限数か(nested[nestedKey])) invalid = true;
+    }
+  }
+  for (const key of ["rootBranchGap", "branchLeafGap", "branchRowGap", "leafRowGap"] as const) {
+    if (value[key] !== undefined && !負でない有限数か(value[key])) invalid = true;
+  }
+  for (const key of ["branchRowOffset", "leafRowOffset"] as const) {
+    if (
+      value[key] !== undefined &&
+      (typeof value[key] !== "number" || !Number.isFinite(value[key]))
+    )
+      invalid = true;
+  }
+  if (invalid) errors.push({ line, message: "mindSize の値の形が読めません" });
+  return !invalid;
+}
+
+function chartLineSeriesの知らない項目を知らせる(
+  value: unknown,
+  line: number,
+  errors: DslError[],
+): boolean {
+  if (!Array.isArray(value)) return false;
+  let unknown = false;
+  value.forEach((series, index) => {
+    unknown =
+      図表の知らない項目を知らせる(
+        series,
+        ["label", "points", "tone", "dash", "marker", "valueIndexes"],
+        `chartLineSeries[${index}]`,
+        line,
+        errors,
+      ) || unknown;
+    if (!objectか(series) || !Array.isArray(series.points)) return;
+    series.points.forEach((point, pointIndex) => {
+      unknown =
+        図表の知らない項目を知らせる(
+          point,
+          ["label", "value"],
+          `chartLineSeries[${index}].points[${pointIndex}]`,
+          line,
+          errors,
+        ) || unknown;
+    });
+  });
+  return unknown;
+}
+
+function chartStackedPeriodsの知らない項目を知らせる(
+  value: unknown,
+  line: number,
+  errors: DslError[],
+): boolean {
+  if (!Array.isArray(value)) return false;
+  let unknown = false;
+  value.forEach((period, index) => {
+    unknown =
+      図表の知らない項目を知らせる(
+        period,
+        ["label", "values"],
+        `chartStackedPeriods[${index}]`,
+        line,
+        errors,
+      ) || unknown;
+  });
+  return unknown;
+}
+
+function chartGaugeValueの知らない項目を知らせる(
+  value: unknown,
+  line: number,
+  errors: DslError[],
+): boolean {
+  return 図表の知らない項目を知らせる(
+    value,
+    ["max", "current", "target", "previous", "previousLabel"],
+    "chartGaugeValue",
+    line,
+    errors,
+  );
+}
+
+function chartLineSeriesの形(
+  value: unknown,
+): value is NonNullable<DslDocument["chartLineSeries"]> {
+  if (!Array.isArray(value) || value.length === 0) return false;
+  return value.every((series) => {
+    if (!objectか(series) || !Array.isArray(series.points) || series.points.length === 0) return false;
+    if (series.label !== undefined && typeof series.label !== "string") return false;
+    if (
+      series.tone !== undefined &&
+      (typeof series.tone !== "string" || resolveTone(series.tone) === undefined)
+    )
+      return false;
+    if (
+      series.dash !== undefined &&
+      (typeof series.dash !== "string" ||
+        !(CHART_LINE_DASH_VALUES as readonly string[]).includes(series.dash))
+    )
+      return false;
+    if (
+      series.marker !== undefined &&
+      (typeof series.marker !== "string" ||
+        !(CHART_LINE_MARKER_VALUES as readonly string[]).includes(series.marker))
+    ) return false;
+    if (
+      series.valueIndexes !== undefined &&
+      (!Array.isArray(series.valueIndexes) ||
+        series.valueIndexes.some((index) => !Number.isInteger(index) || Number(index) < 0))
+    ) return false;
+    return series.points.every(
+      (point) => objectか(point) && typeof point.label === "string" && 図表の数か(point.value),
+    );
+  });
+}
+
+function chartStackedPeriodsの形(
+  value: unknown,
+): value is NonNullable<DslDocument["chartStackedPeriods"]> {
+  return (
+    Array.isArray(value) &&
+    value.length > 0 &&
+    value.every(
+      (period) =>
+        objectか(period) &&
+        typeof period.label === "string" &&
+        Array.isArray(period.values) &&
+        period.values.every(図表の数か),
+    )
+  );
+}
+
+function chartGaugeValueの形(
+  value: unknown,
+): value is NonNullable<DslDocument["chartGaugeValue"]> {
+  if (!objectか(value)) return false;
+  const finite = (entry: unknown): entry is number =>
+    typeof entry === "number" && Number.isFinite(entry);
+  return (
+    finite(value.max) &&
+    value.max > 0 &&
+    図表の数か(value.current) &&
+    (value.target === undefined || 図表の数か(value.target)) &&
+    (value.previous === undefined || 図表の数か(value.previous)) &&
+    (value.previousLabel === undefined || typeof value.previousLabel === "string")
+  );
+}
+
 function splitTopLevelCommas(s: string): string[] {
   // brace 内を考慮 ... 今回は単純 split (動作する範囲)
   return s
@@ -4080,8 +6200,8 @@ function ensureAnimate(a: DslAnimate | undefined, lineNo: number): DslAnimate {
 export const PHASE_ITEM_WORDS = [
   "focus",
   "badge",
-  "body",
-  "description",
+  // 説明の語は `PHASE_BODY_KEYS` から導く (#2621)。 ここに書き写すと JSON の入口とずれる
+  ...PHASE_BODY_KEYS,
   "tween",
   "set",
   "draw",
@@ -4097,8 +6217,8 @@ function parsePhase(block: Line[], errors: DslError[]): DslPhase | null {
   if (!m) {
     errors.push({
       line: head.no,
-      message: `invalid step header: "${head.trimmed}"`,
-      hint: 'use `- step: "name" 1.5s`',
+      message: `段の見出しが読めません: "${head.trimmed}"`,
+      hint: '`- step: "name" 1.5s` の形で書く',
     });
     return null;
   }
@@ -4108,8 +6228,8 @@ function parsePhase(block: Line[], errors: DslError[]): DslPhase | null {
   if (!headParse) {
     errors.push({
       line: head.no,
-      message: `invalid step value: "${headRest}"`,
-      hint: 'use `"name" 1.5s` (duration in s)',
+      message: `段の値が読めません: "${headRest}"`,
+      hint: '`"name" 1.5s` の形で書く (長さは秒)',
     });
     return null;
   }
@@ -4131,6 +6251,14 @@ function parsePhase(block: Line[], errors: DslError[]): DslPhase | null {
     // 拾った上で、知らない名前は下で誤りとして知らせる
     const propMatch = t.match(/^([^\s:]+)\s*:\s*(.*)$/);
     if (!propMatch) {
+      // **項目名として読めなかった行も捨てない** (#2403)。 すぐ下で「知らない項目名」 は
+      // 知らせているのに、ここだけが黙っていた = コロンを書き落とすと、その行が
+      // 知らせにも図にも現れない (実測 = 段の中に `focus` と書くと誤り 0 件で何も起きない)
+      errors.push({
+        line: ln.no,
+        message: `段の行が項目名として読めません: "${t}"`,
+        hint: `\`項目名: 値\` の形で書く (使える項目 = ${段の項目の英語.join(", ")})`,
+      });
       i += 1;
       continue;
     }
@@ -4174,7 +6302,7 @@ function parsePhase(block: Line[], errors: DslError[]): DslPhase | null {
         errors.push({
           line: ln.no,
           message: `draw に書ける項目は語と割合の 2 つまでです: "${stripQuotes(value).trim()}"`,
-          hint: "use `draw: line 0.4`",
+          hint: "`draw: line 0.4` の形で書く",
         });
       } else {
         phase.draw = 語;
@@ -4197,39 +6325,28 @@ function parsePhase(block: Line[], errors: DslError[]): DslPhase | null {
       i += 1;
       continue;
     }
-    if (key === "description" || key === "body") {
+    if ((PHASE_BODY_KEYS as readonly string[]).includes(key)) {
       phase.body = stripQuotes(value);
       i += 1;
       continue;
     }
     if (key === "tween") {
-      // inline (tween: client_bal 100 -> 90) or block
+      // 1 行にまとめた形 (tween: client_bal 100 -> 90) と縦に並べた形の両方を受ける。
+      // 読めない行の文は読み手が持つ (#2403)
       if (value) {
-        const tw = parseTweenLine(value, ln.no);
+        const tw = parseTweenLine(value, ln.no, errors);
         if (tw) phase.tweens!.push(tw);
-        else
-          errors.push({
-            line: ln.no,
-            message: `invalid tween: "${value}"`,
-            hint: "use `tween: name 100 -> 90`",
-          });
         i += 1;
         continue;
       }
-      // block ... 後続の同 indent + 1 以上の行を取り込む
+      // 縦に並べた形 ... 後続の同 indent + 1 以上の行を取り込む
       const baseIndent = ln.indent;
       let j = i + 1;
       while (j < block.length) {
         const nx = block[j]!;
         if (nx.indent <= baseIndent) break;
-        const tw = parseTweenLine(nx.trimmed, nx.no);
+        const tw = parseTweenLine(nx.trimmed, nx.no, errors);
         if (tw) phase.tweens!.push(tw);
-        else
-          errors.push({
-            line: nx.no,
-            message: `invalid tween entry: "${nx.trimmed}"`,
-            hint: "use `name: 100 -> 90`",
-          });
         j += 1;
       }
       i = j;
@@ -4237,7 +6354,7 @@ function parsePhase(block: Line[], errors: DslError[]): DslPhase | null {
     }
     if (key === "set") {
       if (value) {
-        const st = parseSetLine(value, ln.no);
+        const st = parseSetLine(value, ln.no, errors);
         if (st) phase.sets!.push(st);
         i += 1;
         continue;
@@ -4247,7 +6364,7 @@ function parsePhase(block: Line[], errors: DslError[]): DslPhase | null {
       while (j < block.length) {
         const nx = block[j]!;
         if (nx.indent <= baseIndent) break;
-        const st = parseSetLine(nx.trimmed, nx.no);
+        const st = parseSetLine(nx.trimmed, nx.no, errors);
         if (st) phase.sets!.push(st);
         j += 1;
       }
@@ -4311,23 +6428,47 @@ function 段の項目のヒント(書いた名前: string): string {
  *
  * いまは語と図種が同じ綴りだが、**同じものとして扱わない**。 語は書き手が書く名前で、
  * 図種は `type:` が取る値。 片方だけ別名を足したくなった時に、対応が表に残っている形にする。
+ *
+ * **数を描く図は形まで指す** (#2657)。 9 つの型を `chart` 1 つに畳んだので、型だけを
+ * 指すと `draw: pie` を棒の図に書いても咎められなくなる = 語ごとの相手を型から形へ
+ * 下ろして、畳む前と同じ細かさで判定する。
  */
-export const DRAW_TARGETS: ReadonlyMap<string, PresetType> = new Map<string, PresetType>([
-  ["line", "line"],
-  ["bar", "bar"],
-  ["pie", "pie"],
-  ["journey", "journey"],
-  ["mind", "mind"],
-  ["tree", "tree"],
-  ["gantt", "gantt"],
-  ["funnel", "funnel"],
-  ["slope", "slope"],
-  ["gauge", "gauge"],
-  ["radial", "radial"],
-  ["stacked", "stacked"],
-  ["waffle", "waffle"],
+export const DRAW_TARGETS: ReadonlyMap<string, { type: PresetType; shape?: DslShape }> = new Map<
+  string,
+  { type: PresetType; shape?: DslShape }
+>([
+  ["line", { type: "chart", shape: "line" }],
+  ["bar", { type: "chart", shape: "bar" }],
+  ["pie", { type: "chart", shape: "pie" }],
+  ["journey", { type: "journey" }],
+  ["mind", { type: "mind" }],
+  ["tree", { type: "tree" }],
+  ["gantt", { type: "gantt" }],
+  ["funnel", { type: "funnel" }],
+  ["slope", { type: "chart", shape: "slope" }],
+  ["gauge", { type: "chart", shape: "gauge" }],
+  ["radial", { type: "chart", shape: "radial" }],
+  ["stacked", { type: "chart", shape: "stacked" }],
+  ["waffle", { type: "chart", shape: "waffle" }],
 ]);
 
+/**
+ * 段に書いた描く語が、その図に効くか (#2657)。
+ *
+ * 型が合うだけでは足りない = 数を描く図は 1 つの型に 9 つの形が入るので、形まで見ないと
+ * `draw: pie` を棒の図に書いた形が通る。 形を持たない語は型の一致だけで決まる。
+ */
+export function 描く語がその図を指すか(
+  語: string,
+  type: PresetType,
+  shape: DslShape | undefined,
+): boolean {
+  const 相手 = DRAW_TARGETS.get(語);
+  if (相手 === undefined) return false;
+  if (相手.type !== type) return false;
+  return 相手.shape === undefined || 相手.shape === shape;
+}
+
 /** `draw:` に書ける語。 表から導く (#1314) */
 export const DRAW_WORDS: ReadonlySet<string> = new Set(DRAW_TARGETS.keys());
 
@@ -4453,13 +6594,33 @@ function parseFocusList(s: string): string[] {
   return out;
 }
 
-function parseTweenLine(s: string, lineNo: number): DslTween | null {
-  // `client_bal 100 -> 90` / `client_bal: 100 -> 90`
+/**
+ * `client_bal 100 -> 90` / `client_bal: 100 -> 90` を 1 件の変化として読む。
+ *
+ * **2 つの断り方を分けて自分で報告する** (#2403、 #2401 と同じ形)。 どちらも `null` に
+ * まとめると、名前の規則を外れただけの行にも形の案内が返り、案内に従っても直らない
+ * (実測 = `すすみ 0 -> 1` に「`tween: name 100 -> 90` の形で書く」 が返った)。
+ *
+ * **形の案内には 2 つの書き方を両方載せる**。 呼出側は 1 行にまとめた形と縦に並べた形の
+ * 2 つあり、文を呼出側へ戻すと「呼出しを足した日に書き忘れる」 形が戻る。 文を 1 か所に
+ * 置いたまま、どちらで書いた人にも直し方が伝わるようにする。
+ */
+function parseTweenLine(s: string, lineNo: number, errors: DslError[]): DslTween | null {
   const cleaned = s.replace(/^-\s*/, "").trim();
   const m = cleaned.match(/^([^:\s]+)\s*[:\s]\s*(-?\d+(?:\.\d+)?)\s*->\s*(-?\d+(?:\.\d+)?)$/);
-  if (!m) return null;
+  if (!m) {
+    errors.push({
+      line: lineNo,
+      message: `変化の行が読めません: "${cleaned}"`,
+      hint: "`tween: name 100 -> 90` の形で書く (縦に並べる時は `name: 100 -> 90`)",
+    });
+    return null;
+  }
   const state = m[1] ?? "";
-  if (!isValueName(state)) return null;
+  if (!isValueName(state)) {
+    errors.push({ line: lineNo, ...valueNameIssue(state) });
+    return null;
+  }
   return {
     state,
     from: parseFloat(m[2] ?? "0"),
@@ -4468,13 +6629,32 @@ function parseTweenLine(s: string, lineNo: number): DslTween | null {
   };
 }
 
-function parseSetLine(s: string, lineNo: number): DslSet | null {
-  // `status: "loading"` / `status loading`
+/**
+ * `status: "loading"` / `status loading` を 1 件の書き換えとして読む。
+ *
+ * **2 つの断り方を分けて自分で報告する** (#2403)。 直す前は断り方を分けないどころか、
+ * 呼出側が `null` を握り潰していた = 4 通りの書き損じ (1 行 / 縦 × 名前が規則外 / 区切りが無い)
+ * すべてで知らせが 0 件になり、段に書き換えも入らなかった。
+ *
+ * 隣に並ぶ `tween` は知らせを出しており、**同じ段の中で片方だけが黙っていた**。
+ * 文の置き場所を読み手 1 か所にすると、呼出しを足した日に書き忘れても黙らない。
+ */
+function parseSetLine(s: string, lineNo: number, errors: DslError[]): DslSet | null {
   const cleaned = s.replace(/^-\s*/, "").trim();
   const m = cleaned.match(/^([^:\s]+)\s*[:\s]\s*(.+)$/);
-  if (!m) return null;
+  if (!m) {
+    errors.push({
+      line: lineNo,
+      message: `値の書き換えが読めません: "${cleaned}"`,
+      hint: '`set: name "done"` の形で書く (縦に並べる時は `name: "done"`)',
+    });
+    return null;
+  }
   const state = m[1] ?? "";
-  if (!isValueName(state)) return null;
+  if (!isValueName(state)) {
+    errors.push({ line: lineNo, ...valueNameIssue(state) });
+    return null;
+  }
   const raw = (m[2] ?? "").trim();
   const stripped = stripQuotes(raw);
   const asNum = Number(stripped);