@cardenelabs/dragon 0.28.0 → 0.32.0

package/src/schemas/diagram.json

@@ -4,6 +4,9 @@
   "title": "Dragon DSL Diagram",
   "description": "LLM 向け Dragon DSL の JSON Schema。 Anthropic Claude tool use / OpenAI GPT structured output の schema field に注入して使う。 生成された JSON は jsonToDiagram() に渡して CdlDiagram に変換する。",
   "type": "object",
+  "$defs": {
+    "positiveNumber": { "type": "number", "exclusiveMinimum": 0 }
+  },
   "required": [
     "title",
     "type",
@@ -22,13 +25,13 @@
       "enum": [
         "sequence",
         "flow",
+        "flowchart",
         "swimlane",
-        "er",
-        "state",
+        "record",
         "topology",
         "solidity",
         "gantt",
-        "class",
+        "chart",
         "pie",
         "bar",
         "line",
@@ -45,11 +48,289 @@
         "c4",
         "mind"
       ],
-      "description": "図の種類。 型ごとに actors の書き方が違う。 [関係を描く] sequence (時系列の呼び出し) / flow (処理の流れ) / swimlane (責務ごとの流れ) / er (DB の schema) / state (状態の遷移) / topology (network) / solidity (contract) / class (UML の class) / c4 (architecture) / mind (発想の枝分かれ) は actors に名前を並べ flow に矢印を書く。 [値を描く] pie (割合) / bar (棒の高さ) / line (線の高さ、 書いた順に並ぶ) / gauge (合計を半円で示す) / radial (弧の長さで比べる) / stat (値 1 つを大きく示す) / waffle (割合を 100 個の印で示す) / stacked (内訳を帯で示す) / slope (2 時点を直線でつなぎ増減と順位の入れ替わりを示す) は actors に `- 名前: \"45\"` の形で数を書く。 stat と stacked と slope は `- 名前: { value: \"320\", previous: \"280\" }` の形で前の時点の値も書ける。 funnel (段ごとに減る数) も同じ形。 [語を描く] journey (体験の起伏) は `- 登録: \"不満\"` の形で 最高 / 満足 / 普通 / 不満 / 怒り のどれかを書く。 quadrant (2 軸の仕分け) は `- 重複削除: \"左上\"` の形で 左上 / 右上 / 左下 / 右下 のどれかを書く。 [時期を描く] gantt (工程の並び) は `- 設計: \"1月\"` の形で始まりの時期を書き、 flow の矢印で前後関係を書く。 [親子を描く] tree (親子の入れ子) は actors に名前を並べ flow の矢印で親子を書く (矢印の先が子)"
+      "description": "図の種類。 型ごとに actors の書き方が違う。 [関係を描く] sequence (時系列の呼び出し) / flow (処理の流れ) / flowchart (分かれ道と判断を含む手順) / swimlane (責務ごとの流れ) / record (箱が行を持ち関係を持つ図。 表のつながり、移り変わり、UML クラス関係にも使う) / topology (network) / c4 (architecture) / mind (発想の枝分かれ) は actors に名前を並べ flow に矢印を書く。 [値を描く] chart (数の並び) は actors に `- 名前: \"45\"` の形で数を書き、 shape で形を選ぶ (pie = 割合 / bar = 棒の高さ / line = 線の高さで書いた順に並ぶ / gauge = 合計を半円で示す / radial = 弧の長さで比べる / stat = 値 1 つを大きく示す / waffle = 割合を 100 個の印で示す / stacked = 内訳を帯で示す / slope = 2 時点を直線でつなぎ増減と順位の入れ替わりを示す)。 shape が stat と stacked と slope の時は `- 名前: { value: \"320\", previous: \"280\" }` の形で前の時点の値も書ける。 funnel (段ごとに減る数) も同じ形。 [語を描く] journey (体験の起伏) は `- 登録: \"不満\"` の形で 最高 / 満足 / 普通 / 不満 / 怒り のどれかを書く。 quadrant (2 軸の仕分け) は `- 重複削除: \"左上\"` の形で 左上 / 右上 / 左下 / 右下 のどれかを書く。 [時期を描く] gantt (工程の並び) は `- 設計: \"1月\"` の形で始まりの時期を書き、 flow の矢印で前後関係を書く。 [親子を描く] tree (親子の入れ子) は actors に名前を並べ flow の矢印で親子を書く (矢印の先が子)。 [古い綴り] solidity は sequence と order: kind の組、 pie / bar / line / gauge / radial / stat / waffle / stacked / slope は chart と同じ綴りの shape の組と同じ扱いになる"
     },
+    "form": {
+      "type": "string",
+      "enum": ["ring", "arcs", "table", "輪", "積層の弧", "銘板"],
+      "description": "shape: pie の見せ方。輪 / 積層の弧 / 銘板。"
+    },
+    "見せ方": {
+      "type": "string",
+      "enum": ["ring", "arcs", "table", "輪", "積層の弧", "銘板"],
+      "description": "form の和名。両方あれば form を採る。"
+    },
+    "ticks": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 },
+      "description": "gantt の目盛りを左から順に明示する。"
+    },
+    "目盛り": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 },
+      "description": "ticks の和名。両方あれば ticks を採る。"
+    },
+    "ganttToday": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["index", "label"],
+      "properties": {
+        "index": { "type": "number" },
+        "label": { "type": "string" }
+      },
+      "description": "gantt の今日の線の位置と札。"
+    },
+    "ganttTickLabels": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" },
+      "description": "gantt の目盛りに順番に出す名前。"
+    },
+    "ganttBarEnd": {
+      "type": "string",
+      "enum": ["position"],
+      "description": "gantt の帯を end の位置で止める。"
+    },
+    "ganttBarThickness": {
+      "type": "string",
+      "enum": ["thin"],
+      "description": "gantt の帯を見本の比で細くする。"
+    },
+    "chartSeriesSkipMuted": { "type": "boolean" },
+    "chartLineSeries": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["points"],
+        "properties": {
+          "label": { "type": "string" },
+          "tone": { "type": "string" },
+          "dash": { "type": "string", "enum": ["solid", "dotted"] },
+          "marker": { "type": "string", "enum": ["dot", "hollow", "none"] },
+          "valueIndexes": { "type": "array", "items": { "type": "integer", "minimum": 0 } },
+          "points": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["label", "value"],
+              "properties": {
+                "label": { "type": "string" },
+                "value": { "type": ["number", "string"] }
+              }
+            }
+          }
+        }
+      }
+    },
+    "chartPieCenterLabel": { "type": "string" },
+    "chartPieTableColumns": { "type": "string", "enum": ["share-value", "value"] },
+    "chartPieRingWidth": { "type": "string", "enum": ["thick", "thin"] },
+    "chartSlopePeriods": {
+      "type": "array",
+      "minItems": 2,
+      "maxItems": 2,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "chartSlopeEmphasisIds": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "chartSlopeUnit": { "type": "string" },
+    "chartStackedPeriods": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["label", "values"],
+        "properties": {
+          "label": { "type": "string" },
+          "values": { "type": "array", "items": { "type": ["number", "string"] } }
+        }
+      }
+    },
+    "chartStackedRateId": { "type": "string" },
+    "chartStackedLegendPosition": { "type": "string", "enum": ["top", "bottom"] },
+    "chartGaugeValue": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["max", "current"],
+      "properties": {
+        "max": { "type": "number", "exclusiveMinimum": 0 },
+        "current": {
+          "anyOf": [
+            { "type": "number" },
+            { "type": "string", "pattern": "\\S" }
+          ]
+        },
+        "target": {
+          "anyOf": [
+            { "type": "number" },
+            { "type": "string", "pattern": "\\S" }
+          ]
+        },
+        "previous": {
+          "anyOf": [
+            { "type": "number" },
+            { "type": "string", "pattern": "\\S" }
+          ]
+        },
+        "previousLabel": { "type": "string" }
+      }
+    },
+    "chartWaffleLegendPosition": { "type": "string", "enum": ["left", "right"] },
+    "funnelForm": { "type": "string", "enum": ["trapezoid", "proportional-bars"] },
+    "funnelRate": { "type": "string", "enum": ["drop", "conversion", "none"] },
+    "quadrantPointLabelSide": { "type": "string", "enum": ["auto", "right"] },
+    "treeNodeForm": { "type": "string", "enum": ["accent", "frame"] },
+    "treeSize": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "nodeWidths": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "number", "exclusiveMinimum": 0 }
+        },
+        "nodeHeight": { "type": "number", "exclusiveMinimum": 0 },
+        "titleFontSize": { "type": "number", "exclusiveMinimum": 0 },
+        "subtitleFontSize": { "type": "number", "exclusiveMinimum": 0 },
+        "siblingGap": { "type": "number", "minimum": 0 },
+        "levelGap": { "type": "number", "minimum": 0 }
+      }
+    },
+    "treeEdgeTone": { "type": "string", "enum": ["accent", "depth"] },
+    "treeEdgeHead": { "type": "string", "enum": ["none", "triangle"] },
+    "mindForm": { "type": "string", "enum": ["filled", "outline"] },
+    "mindSize": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "contentOffset": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["x", "y"],
+          "properties": {
+            "x": { "type": "number" },
+            "y": { "type": "number" }
+          }
+        },
+        "root": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "width": { "type": "number", "exclusiveMinimum": 0 },
+            "height": { "type": "number", "exclusiveMinimum": 0 },
+            "fontSize": { "type": "number", "exclusiveMinimum": 0 }
+          }
+        },
+        "branch": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "width": { "type": "number", "exclusiveMinimum": 0 },
+            "height": { "type": "number", "exclusiveMinimum": 0 },
+            "fontSize": { "type": "number", "exclusiveMinimum": 0 }
+          }
+        },
+        "leaf": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "fontSize": { "type": "number", "exclusiveMinimum": 0 }
+          }
+        },
+        "rootBranchGap": { "type": "number", "minimum": 0 },
+        "branchLeafGap": { "type": "number", "minimum": 0 },
+        "branchRowGap": { "type": "number", "minimum": 0 },
+        "branchRowOffset": { "type": "number" },
+        "leafRowGap": { "type": "number", "minimum": 0 },
+        "leafRowOffset": { "type": "number" }
+      }
+    },
+    "journeyForm": { "type": "string", "enum": ["bands", "rules"] },
+    "journeyLineForm": { "type": "string", "enum": ["curve", "straight"] },
+    "journeyLabels": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["delighted", "happy", "neutral", "frustrated", "angry"],
+      "properties": {
+        "delighted": { "type": "string", "minLength": 1 },
+        "happy": { "type": "string", "minLength": 1 },
+        "neutral": { "type": "string", "minLength": 1 },
+        "frustrated": { "type": "string", "minLength": 1 },
+        "angry": { "type": "string", "minLength": 1 }
+      }
+    },
+    "sequenceActorForm": { "type": "string", "enum": ["box"] },
+    "sequenceLabelForm": { "type": "string", "enum": ["kind"] },
+    "sequenceReturnHead": { "type": "string", "enum": ["solid"] },
+    "sequenceRowGap": { "type": "number", "exclusiveMinimum": 0 },
+    "sequenceGutter": { "type": "number", "exclusiveMinimum": 0 },
+    "sequenceBandWidth": { "type": "number", "exclusiveMinimum": 0 },
+    "sequenceSelfLoop": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "form": { "type": "string", "enum": ["orthogonal"] },
+        "width": { "type": "number", "exclusiveMinimum": 0 },
+        "drop": { "type": "number", "exclusiveMinimum": 0 }
+      }
+    },
+    "sequenceKindLabels": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "call": { "type": "string" },
+        "return": { "type": "string" },
+        "fire": { "type": "string" }
+      }
+    },
+    "figureCard": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["label"],
+      "properties": {
+        "label": { "type": "string" },
+        "note": { "type": "string" }
+      }
+    },
+    "figureSize": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["width", "height"],
+      "properties": {
+        "width": { "type": "number", "exclusiveMinimum": 0 },
+        "height": { "type": "number", "exclusiveMinimum": 0 }
+      }
+    },
+    "terminalDecoration": { "type": "object", "additionalProperties": false, "properties": { "windowControls": { "type": "boolean" }, "cursor": { "type": "boolean" }, "rowOrdinal": { "type": "boolean" } } },
+    "cornerForm": { "type": "string", "enum": ["theme-variants"] },
+    "chartBarShape": { "type": "string", "enum": ["split", "top-rounded"] },
+    "figureKindLabel": { "type": "object", "additionalProperties": false, "required": ["text"], "properties": { "text": { "type": "string", "minLength": 1 }, "x": { "type": "number" }, "y": { "type": "number" }, "fontSize": { "type": "number", "exclusiveMinimum": 0 }, "fontWeight": { "type": "number", "exclusiveMinimum": 0 }, "letterSpacing": { "type": "number", "minimum": 0 } } },
+    "figureInset": { "type": "object", "additionalProperties": false, "properties": { "top": { "type": "number", "minimum": 0 }, "right": { "type": "number", "minimum": 0 }, "bottom": { "type": "number", "minimum": 0 }, "left": { "type": "number", "minimum": 0 }, "radius": { "type": "number", "minimum": 0 } } },
+    "journeySize": { "type": "object", "additionalProperties": false, "properties": { "plotPadding": { "type": "object", "additionalProperties": false, "properties": { "left": { "type": "number", "minimum": 0 }, "right": { "type": "number", "minimum": 0 } } }, "pointPadding": { "type": "object", "additionalProperties": false, "properties": { "left": { "type": "number", "minimum": 0 }, "right": { "type": "number", "minimum": 0 } } } } },
+    "chartBarSize": { "type": "object", "additionalProperties": false, "properties": { "tickFontSize": { "$ref": "#/$defs/positiveNumber" }, "valueFontSize": { "$ref": "#/$defs/positiveNumber" }, "labelFontSize": { "$ref": "#/$defs/positiveNumber" }, "plotPadding": { "type": "object", "additionalProperties": false, "properties": { "top": { "type": "number", "minimum": 0 }, "right": { "type": "number", "minimum": 0 }, "bottom": { "type": "number", "minimum": 0 }, "left": { "type": "number", "minimum": 0 } } }, "barWidth": { "$ref": "#/$defs/positiveNumber" }, "cornerRadius": { "type": "number", "minimum": 0 } } },
+    "chartLineSize": { "type": "object", "additionalProperties": false, "properties": { "valueLabelOffset": { "type": "object", "additionalProperties": false, "properties": { "above": { "type": "number", "minimum": 0 }, "below": { "type": "number", "minimum": 0 } } }, "tickFontSize": { "$ref": "#/$defs/positiveNumber" }, "periodFontSize": { "$ref": "#/$defs/positiveNumber" }, "pointRadius": { "$ref": "#/$defs/positiveNumber" }, "plotPadding": { "type": "object", "additionalProperties": false, "properties": { "top": { "type": "number", "minimum": 0 }, "right": { "type": "number", "minimum": 0 }, "bottom": { "type": "number", "minimum": 0 }, "left": { "type": "number", "minimum": 0 } } }, "tickGap": { "type": "number", "minimum": 0 }, "pointPadding": { "type": "object", "additionalProperties": false, "properties": { "left": { "type": "number", "minimum": 0 }, "right": { "type": "number", "minimum": 0 } } }, "periodY": { "type": "number", "minimum": 0 } } },
+    "chartPieSize": { "type": "object", "additionalProperties": false, "properties": { "tableWidth": { "$ref": "#/$defs/positiveNumber" }, "tableLabelFontSize": { "$ref": "#/$defs/positiveNumber" }, "tableValueFontSize": { "$ref": "#/$defs/positiveNumber" }, "tableRowGap": { "type": "number", "minimum": 0 }, "tablePaddingInline": { "type": "number", "minimum": 0 }, "outerRadius": { "$ref": "#/$defs/positiveNumber" }, "centerX": { "type": "number", "minimum": 0 } } },
+    "chartWaffleSize": { "type": "object", "additionalProperties": false, "properties": { "gridLeft": { "type": "number", "minimum": 0 }, "cellPitch": { "$ref": "#/$defs/positiveNumber" } } },
+    "chartSlopeLabelTemplate": { "type": "object", "additionalProperties": false, "properties": { "left": { "type": "string" }, "right": { "type": "string" } } },
+    "chartSlopeSize": { "type": "object", "additionalProperties": false, "properties": { "pointRadius": { "$ref": "#/$defs/positiveNumber" }, "periodFontSize": { "$ref": "#/$defs/positiveNumber" }, "labelFontSize": { "$ref": "#/$defs/positiveNumber" }, "leftAxisX": { "type": "number", "minimum": 0 }, "axisGap": { "$ref": "#/$defs/positiveNumber" }, "labelAxisGap": { "type": "number", "minimum": 0 }, "plotPadding": { "type": "object", "additionalProperties": false, "properties": { "top": { "type": "number", "minimum": 0 }, "bottom": { "type": "number", "minimum": 0 } } }, "pointPadding": { "type": "object", "additionalProperties": false, "properties": { "top": { "type": "number", "minimum": 0 }, "bottom": { "type": "number", "minimum": 0 } } } } },
+    "chartStackedLayout": { "type": "object", "additionalProperties": false, "properties": { "legendColumns": { "type": "integer", "minimum": 1 }, "legendColumnGap": { "type": "number", "minimum": 0 }, "segmentGap": { "type": "number", "minimum": 0 }, "barThickness": { "$ref": "#/$defs/positiveNumber" }, "barWidth": { "$ref": "#/$defs/positiveNumber" }, "legendMarkSize": { "$ref": "#/$defs/positiveNumber" }, "legendFontSize": { "$ref": "#/$defs/positiveNumber" }, "periodFontSize": { "$ref": "#/$defs/positiveNumber" }, "rateFontSize": { "$ref": "#/$defs/positiveNumber" }, "legendOffsetY": { "type": "number" } } },
+    "chartGaugeSize": { "type": "object", "additionalProperties": false, "properties": { "arcThickness": { "$ref": "#/$defs/positiveNumber" }, "outerRadius": { "$ref": "#/$defs/positiveNumber" }, "plotTop": { "type": "number", "minimum": 0 }, "valueFontSize": { "$ref": "#/$defs/positiveNumber" } } },
+    "ganttSize": { "type": "object", "additionalProperties": false, "properties": { "taskLabelFontSize": { "$ref": "#/$defs/positiveNumber" }, "taskLabelAlign": { "type": "string", "enum": ["start", "end"] }, "taskLabelX": { "type": "number", "minimum": 0 }, "tickFontSize": { "$ref": "#/$defs/positiveNumber" }, "tickCount": { "type": "integer", "minimum": 2 }, "barThickness": { "$ref": "#/$defs/positiveNumber" }, "milestoneFontSize": { "$ref": "#/$defs/positiveNumber" }, "milestoneRadius": { "$ref": "#/$defs/positiveNumber" }, "dependencyStrokeWidth": { "$ref": "#/$defs/positiveNumber" }, "taskColumnWidth": { "type": "number", "minimum": 0 }, "timelinePaddingRight": { "type": "number", "minimum": 0 } } },
+    "quadrantLabelPosition": { "type": "string", "enum": ["outside-corners"] },
+    "quadrantSize": { "type": "object", "additionalProperties": false, "properties": { "plotOffset": { "type": "object", "additionalProperties": false, "properties": { "x": { "type": "number", "minimum": 0 }, "y": { "type": "number", "minimum": 0 } } }, "plotSize": { "$ref": "#/$defs/positiveNumber" }, "pointRadius": { "$ref": "#/$defs/positiveNumber" }, "pointFontSize": { "$ref": "#/$defs/positiveNumber" }, "pointLabelGap": { "type": "number", "minimum": 0 }, "quadrantFontSize": { "$ref": "#/$defs/positiveNumber" }, "axisFontSize": { "$ref": "#/$defs/positiveNumber" } } },
     "eyebrow": {
       "type": "string",
-      "description": "図表の箱の上に出す小見出し (省略可)。 効くのは図全体を 1 箱にする型 (pie / bar / line / gauge / radial / stat / waffle / stacked / slope / funnel / tree / journey / quadrant / mind / gantt) だけ。 箱ごとに分かれる型では相手が決まらないため、 actors[].eyebrow に書く"
+      "description": "図表の箱の上に出す小見出し (省略可)。 効くのは図全体を 1 箱にする型 (chart / funnel / tree / journey / quadrant / mind / gantt) だけ。 箱ごとに分かれる型では相手が決まらないため、 actors[].eyebrow に書く"
     },
     "axes": {
       "type": "object",
@@ -65,7 +346,9 @@
             },
             "right": {
               "type": "string"
-            }
+            },
+            "label": { "type": "string" },
+            "direction": { "type": "boolean", "enum": [true] }
           }
         },
         "y": {
@@ -77,11 +360,32 @@
             },
             "top": {
               "type": "string"
-            }
+            },
+            "label": { "type": "string" },
+            "direction": { "type": "boolean", "enum": [true] }
           }
         }
       }
     },
+    "regions": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "quadrant の区画に出す名前。 記法の regions と同じ。 鍵は項目の欄と同じ 4 語。",
+      "properties": {
+        "左上": {
+          "type": "string"
+        },
+        "右上": {
+          "type": "string"
+        },
+        "左下": {
+          "type": "string"
+        },
+        "右下": {
+          "type": "string"
+        }
+      }
+    },
     "actors": {
       "type": "array",
       "minItems": 1,
@@ -106,12 +410,70 @@
               },
               "kind": {
                 "type": "string",
-                "description": "node kind。 shape-* を指定して 49 shape 中から選ぶ。 例: 'shape-wallet' / 'shape-smart-contract' / 'shape-cloud' / 'shape-file' / 'actor' (default) / 'function' / 'storage' / 'event' 等"
+                "description": "node kind。 shape-* を指定して 49 shape 中から選ぶ。 例: 'shape-wallet' / 'shape-smart-contract' / 'shape-cloud' / 'shape-file' / 'actor' (default) / 'function' / 'storage' / 'event' 等。 種別に無い名前は部品の名前として部品の一覧 (partsCatalog) から引き、一覧にも無ければ種別を書かなかった箱になる。 部品を持つ一覧を渡した時は知らせを出し、綴りの近い名前を案内する。"
               },
               "subtitle": {
                 "type": "string",
                 "description": "node 下部の補足テキスト"
               },
+              "kindForm": { "type": "string", "enum": ["icon"] },
+              "icon": { "type": "string", "enum": ["person", "box", "database", "lightning", "cloud", "terminal"] },
+              "emptyRowsNote": { "type": "string" },
+              "titleAlign": { "type": "string", "enum": ["center"] },
+              "rowRules": { "type": "boolean" },
+              "rowStripe": { "type": "boolean" },
+              "rowLayout": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "titleBaseline": { "type": "number", "minimum": 0 },
+                  "rowTop": { "type": "number", "minimum": 0 },
+                  "rowPitch": { "type": "number", "exclusiveMinimum": 0 }
+                }
+              },
+              "rowDividerForm": { "type": "string", "enum": ["full"] },
+              "rowWell": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "top": { "type": "number", "minimum": 0 },
+                  "right": { "type": "number", "minimum": 0 },
+                  "bottom": { "type": "number", "minimum": 0 },
+                  "left": { "type": "number", "minimum": 0 },
+                  "radius": { "type": "number", "minimum": 0 }
+                }
+              },
+              "rowMarkForm": { "type": "string", "enum": ["tone"] },
+              "nestIn": { "type": "string", "minLength": 1 },
+              "figureCard": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["label"],
+                "properties": {
+                  "label": { "type": "string" },
+                  "note": { "type": "string" }
+                }
+              },
+              "stationNamePosition": {
+                "type": "string",
+                "enum": ["bottom"],
+                "description": "路線図の駅名を駅の下へ置く"
+              },
+              "subtitlePlacement": {
+                "type": "string",
+                "enum": ["right"],
+                "description": "時間軸の担当を札の右へ置く"
+              },
+              "titleFontSize": {
+                "type": "number",
+                "exclusiveMinimum": 0,
+                "description": "流れ図の function の札の題の大きさ"
+              },
+              "markGap": {
+                "type": "number",
+                "exclusiveMinimum": 0,
+                "description": "流れ図の始まり・終わりの印と次の箱との間"
+              },
               "eyebrow": {
                 "type": "string",
                 "description": "node 上部の分類ラベル (accent 色)"
@@ -134,9 +496,26 @@
               "marks": {
                 "type": "array",
                 "items": {
-                  "type": "string"
+                  "oneOf": [
+                    { "type": "string" },
+                    {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "required": ["mark"],
+                      "properties": {
+                        "mark": { "type": "string" },
+                        "tone": { "type": "string", "enum": ["primary", "muted"] }
+                      }
+                    }
+                  ]
                 },
-                "description": "行頭の印。 rows と同じ数だけ並べる。 語の意味は図の種類が決める = er は pk / fk / opt、class は + / - と () の有無、state は entry / do / exit / internal"
+                "description": "行頭の印。 rows と同じ数だけ並べる。 語は 鍵 (名前に下線 = その行で箱を見分ける) / 外 (行頭を山形 = 箱の外とつながる) / 条件 (行頭を中空 = 条件が揃った時だけ効く) の 3 つで、1 行に 2 つ以上書ける。 古い綴り pk / fk / opt / entry / exit / do / internal は読み取りの入口でこの 3 語に読み替わる"
+              },
+              "stage": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "\\S",
+                "description": "shape: stages の泳法図で、この箱を入れる段階。 記法では stage または 段階 と書く"
               },
               "lane": {
                 "type": "string",
@@ -149,11 +528,11 @@
               },
               "initial": {
                 "type": "boolean",
-                "description": "state 開始点 (kind: state 用)"
+                "description": "始まりの箱か (札の形の箱に 初期 の字が出る)"
               },
               "final": {
                 "type": "boolean",
-                "description": "state 終了点 (kind: state 用)"
+                "description": "終わりの箱か (札の形の箱に 最終 の字が出る)"
               },
               "state": {
                 "type": "object",
@@ -176,6 +555,7 @@
                   "error",
                   "warning",
                   "info",
+                  "muted",
                   "成功",
                   "失敗",
                   "警告",
@@ -196,6 +576,7 @@
                       "error",
                       "warning",
                       "info",
+                      "muted",
                       "成功",
                       "失敗",
                       "警告",
@@ -215,7 +596,34 @@
               },
               "end": {
                 "type": "string",
-                "description": "gantt の工程が終わる時期。"
+                "description": "gantt の工程が終わる時期。 始まりより前の時期は始まりと同じに倒し、知らせを出す。"
+              },
+              "startLabel": {
+                "type": "string",
+                "description": "gantt の工程の始まりに出す札。"
+              },
+              "milestone": {
+                "type": "boolean",
+                "description": "true なら gantt の帯を節目の菱形にする。"
+              },
+              "emphasis": {
+                "type": "string",
+                "enum": ["primary"],
+                "description": "gantt の帯を主役として描く。"
+              },
+              "at": {
+                "type": "array",
+                "minItems": 2,
+                "maxItems": 2,
+                "items": { "type": ["number", "string"] },
+                "description": "quadrant の座標 [x, y]。左下が 0,0、右上が 1,1。"
+              },
+              "点の位置": {
+                "type": "array",
+                "minItems": 2,
+                "maxItems": 2,
+                "items": { "type": ["number", "string"] },
+                "description": "at の和名。両方あれば at を採る。"
               },
               "touchpoint": {
                 "type": "string",
@@ -225,6 +633,11 @@
                 "type": "string",
                 "description": "journey の段階の改善の余地。"
               },
+              "opportunityPosition": {
+                "type": "string",
+                "enum": ["below-chart", "below-point"],
+                "description": "journey の改善の余地を図の下か、その段階の点の下へ置く。"
+              },
               "posX": {
                 "type": "number",
                 "description": "箱の絶対 x 座標。"
@@ -245,6 +658,10 @@
                 "type": "number",
                 "description": "parts の描画倍率。 kind に parts identifier を指定した時だけ使える。"
               },
+              "phase": {
+                "type": "boolean",
+                "description": "parts が持つ段を使うか。 既定は書いた段と番号ごとに並べて再生する。 false を書くと parts の段の中身を空にし、値は animation に書いた段だけが動かす。 kind に parts identifier を指定した時だけ使える。"
+              },
               "pos": {
                 "type": "object",
                 "additionalProperties": false,
@@ -262,6 +679,36 @@
                   }
                 }
               },
+              "posRel": {
+                "type": "object",
+                "additionalProperties": false,
+                "description": "位置を他の要素からの相対で書く指定。 座標を知らなくても「誰の」「どちら側に」「どれだけ離して」 で置ける。 解決した後は posX / posY を書いた時と同じ経路を通る。",
+                "required": [
+                  "anchor",
+                  "dir"
+                ],
+                "properties": {
+                  "anchor": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "基準にする相手の名前。 actors に書かれた名前をそのまま書く。"
+                  },
+                  "dir": {
+                    "type": "string",
+                    "enum": [
+                      "right",
+                      "left",
+                      "above",
+                      "below"
+                    ],
+                    "description": "基準からどちら側に置くか。"
+                  },
+                  "gap": {
+                    "type": "number",
+                    "description": "相手の縁との間隔。 書かなければ 160 で置く。"
+                  }
+                }
+              },
               "visibleIf": {
                 "type": "string",
                 "description": "その箱を出すかどうかの条件。 状態を差し込める文字列で、\"0\" / \"false\" / 空文字が偽、それ以外は真。"
@@ -503,7 +950,7 @@
           },
           "tailSub": {
             "type": "string",
-            "description": "クラス図の出どころ側の多重度 (例 \"1\")。 sub が行き先の端の多重度。 クラス図でだけ効く"
+            "description": "relation を書いた record の出どころ側の多重度 (例 \"1\")。 sub が行き先の端の多重度"
           },
           "tone": {
             "type": "string",
@@ -514,6 +961,7 @@
               "error",
               "warning",
               "info",
+              "muted",
               "成功",
               "失敗",
               "警告",
@@ -534,11 +982,11 @@
           },
           "guard": {
             "type": "string",
-            "description": "state 遷移の条件 (kind: state 用)"
+            "description": "移り変わりの条件 (名前の下の行に出る)"
           },
           "cardinality": {
             "type": "string",
-            "description": "ER の多重度 (1..N 等、 kind: er 用)"
+            "description": "ER の多重度 (type: record 用)。 1:1 / 1:N / N:1 / N:M / 0..1 / 1..* のどれかを書くと、 両端の形がその語から決まり (tailHead / head を書けばそちらが勝つ)、 語は説明文の下の行に出る。 説明文に書いた同じ語は説明文から外す。 6 語以外を書くと説明文に (語) と添えるだけで、 端の形は決まらない (tailHead と head を両方書かなければ、 描かない端を知らせる)。 type: record 以外の図種では描かず、 そのことを知らせる"
           },
           "side": {
             "type": "string",
@@ -550,10 +998,21 @@
             ],
             "description": "矢印がどの辺から出るか。 書かなければ描画側が自動で選ぶ。"
           },
+          "fromSide": {
+            "type": "string",
+            "enum": ["top", "right", "bottom", "left"],
+            "description": "矢印が出どころのどの辺から出るか"
+          },
+          "toSide": {
+            "type": "string",
+            "enum": ["top", "right", "bottom", "left"],
+            "description": "矢印が行き先のどの辺へ入るか"
+          },
           "head": {
             "type": "string",
             "enum": [
               "none",
+              "dot",
               "triangle",
               "diamond",
               "open",
@@ -569,6 +1028,7 @@
             "type": "string",
             "enum": [
               "none",
+              "dot",
               "triangle",
               "diamond",
               "open",
@@ -606,7 +1066,7 @@
               "associates",
               "uses"
             ],
-            "description": "クラス図の関係の語。 書くと端の形 / 塗り / 線種がまとめて決まる。"
+            "description": "record に書く UML 関係の語。 書くと端の形 / 塗り / 線種がまとめて決まる。"
           },
           "role": {
             "type": "string",
@@ -636,6 +1096,47 @@
             "type": "number",
             "description": "ラベル位置 y 調整"
           },
+          "posX1": {
+            "type": "number",
+            "description": "線の出どころ側を固定する world x 座標"
+          },
+          "posY1": {
+            "type": "number",
+            "description": "線の出どころ側を固定する world y 座標"
+          },
+          "posX2": {
+            "type": "number",
+            "description": "線の行き先側を固定する world x 座標"
+          },
+          "posY2": {
+            "type": "number",
+            "description": "線の行き先側を固定する world y 座標"
+          },
+          "waypoints": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["x", "y"],
+              "properties": {
+                "x": { "type": "number" },
+                "y": { "type": "number" }
+              }
+            }
+          },
+          "labelCollision": {
+            "type": "string",
+            "enum": ["auto", "author"]
+          },
+          "labelSize": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "width": { "$ref": "#/$defs/positiveNumber" },
+              "height": { "$ref": "#/$defs/positiveNumber" },
+              "fontSize": { "$ref": "#/$defs/positiveNumber" }
+            }
+          },
           "overlay": {
             "type": "boolean",
             "description": "true で説明文を矢印の線の上に重ねる (分岐図の条件ラベル用)"
@@ -759,6 +1260,10 @@
             "type": "string",
             "description": "phase 説明文"
           },
+          "description": {
+            "type": "string",
+            "description": "phase 説明文の別名 (記法の description: と同じ)。 正の語は body で、 両方書いた段は body が効く"
+          },
           "badge": {
             "type": "string",
             "description": "phase 中に表示する badge label"
@@ -780,7 +1285,7 @@
               "stacked",
               "waffle"
             ],
-            "description": "この phase で起点から描くもの。 語は図種と揃える。 line / journey = 線が左端から右へ伸びる / bar = 棒が横軸から上へ伸びる / pie = 扇が 12 時から時計回りに開く / mind = 枝が中心から外へ伸びる / tree = 枝が根から下へ伸びる / gantt = 帯が各始端から右へ伸びる / funnel = 段が上端から順に積まれる / slope = 線が左の軸から右の軸へ伸びる / gauge = 弧が 9 時から上を通って 3 時へ伸びる / radial = 各輪が 12 時から時計回りに開く / stacked = 帯が左端から右へ伸びる / waffle = 印が左上から読む向きに 1 個ずつ埋まる"
+            "description": "この phase で起点から描くもの。 語は図種と揃える (数を描く図では shape と揃える)。 line / journey = 線が左端から右へ伸びる / bar = 棒が横軸から上へ伸びる / pie = 扇が 12 時から時計回りに開く / mind = 枝が中心から外へ伸びる / tree = 枝が根から下へ伸びる / gantt = 帯が各始端から右へ伸びる / funnel = 段が上端から順に積まれる / slope = 線が左の軸から右の軸へ伸びる / gauge = 弧が 9 時から上を通って 3 時へ伸びる / radial = 各輪が 12 時から時計回りに開く / stacked = 帯が左端から右へ伸びる / waffle = 印が左上から読む向きに 1 個ずつ埋まる"
           },
           "drawRatio": {
             "type": "number",
@@ -832,6 +1337,9 @@
           "type": "number",
           "minimum": 100
         },
+        "contentOffsetX": {
+          "type": "number"
+        },
         "laneWidth": {
           "type": "number",
           "minimum": 100
@@ -875,6 +1383,9 @@
           "label": {
             "type": "string"
           },
+          "subtitle": {
+            "type": "string"
+          },
           "contain": {
             "type": "boolean"
           },
@@ -2236,7 +2747,9 @@
           {
             "type": "object",
             "additionalProperties": false,
-            "required": ["expression"],
+            "required": [
+              "expression"
+            ],
             "properties": {
               "expression": {
                 "type": "string",
@@ -2266,13 +2779,157 @@
       ],
       "description": "図の並ぶ向き。 vertical = 1 つの縦列に積む。 horizontal = 1 人ずつ縦列を作る。 効くのは flow と swimlane だけ。"
     },
+    "shape": {
+      "type": "string",
+      "enum": [
+        "pie",
+        "bar",
+        "line",
+        "gauge",
+        "radial",
+        "stat",
+        "waffle",
+        "stacked",
+        "slope",
+        "stages",
+        "metro",
+        "timeline"
+      ],
+      "description": "図種ごとの形。 chart では pie / bar / line / gauge / radial / stat / waffle / stacked / slope、swimlane では stages / metro / timeline が効く。 chart で書かなければ bar (棒の高さ)。"
+    },
+    "order": {
+      "type": "string",
+      "enum": [
+        "kind"
+      ],
+      "description": "箱を並べ替える軸。 kind = actors の kind の順 (人 → 契約 → 保管 → 出来事) に並べ替える。 効くのは sequence だけ。 書かなければ書いた順のまま。"
+    },
+    "theme": {
+      "type": "string",
+      "enum": [
+        "kinari",
+        "celadon",
+        "blueprint",
+        "letterpress",
+        "catalog",
+        "terminal",
+        "sketch",
+        "neon",
+        "relief"
+      ],
+      "description": "図の意匠 (`kinari` = 生成りに茶、`celadon` = 青磁に墨、`blueprint` = 図面、`letterpress` = 活版、`catalog` = 図録、`terminal` = 端末、`sketch` = 手描き、`neon` = 電飾、`relief` = 浮彫)。 名前だけが図に載り、色の値は使う側が決める。"
+    },
     "palette": {
       "type": "string",
       "enum": [
         "kinari",
-        "celadon"
+        "celadon",
+        "blueprint",
+        "letterpress",
+        "catalog",
+        "terminal",
+        "sketch",
+        "neon",
+        "relief"
       ],
-      "description": "図の配色 (`kinari` = 生成りに茶、`celadon` = 青磁に墨) で、ER 図とクラス図は書かなくても `kinari` になり、書いた `palette` が優先され、名前だけが図に載って色の値は消費側が決める。"
+      "description": "`theme` の別名。 `relief` (浮彫) を含む同じ意匠名を受ける。 両方書くと `theme` が勝ち、知らせが 1 件出る。"
+    },
+    "legend": {
+      "type": "array",
+      "description": "記法の legend と同じ、図の下へ置く凡例。",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["text"],
+        "properties": {
+          "mark": {
+            "type": "string",
+            "enum": [
+              "diamond",
+              "filled-circle",
+              "double-circle",
+              "dotted-line",
+              "solid-line",
+              "curved-line",
+              "rounded-label",
+              "numbered-circle",
+              "station",
+              "arrow",
+              "line-triangle-hollow",
+              "line-diamond-hollow",
+              "line-diamond-solid",
+              "rounded-box"
+            ]
+          },
+          "text": {
+            "type": "string",
+            "minLength": 1
+          },
+          "tone": { "type": "string" },
+          "lineStyle": { "type": "string", "enum": ["solid", "dotted"] },
+          "align": { "type": "string", "enum": ["start", "end"] },
+          "lead": { "type": "string" }
+        },
+        "oneOf": [
+          {
+            "required": ["mark"],
+            "not": { "anyOf": [{ "required": ["align"] }, { "required": ["lead"] }] }
+          },
+          {
+            "not": { "required": ["mark"] },
+            "allOf": [
+              { "not": { "required": ["tone"] } },
+              { "not": { "required": ["lineStyle"] } }
+            ]
+          }
+        ]
+      }
+    },
+    "legendFontSize": {
+      "type": "number",
+      "exclusiveMinimum": 0,
+      "description": "凡例の字の大きさ"
+    },
+    "edgeEndGap": {
+      "type": "number",
+      "minimum": 0,
+      "description": "線の両端と発着する箱の縁との隙間"
+    },
+    "legendOffset": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "x": { "type": "number" },
+        "y": { "type": "number" }
+      }
+    },
+    "stageHeader": {
+      "type": "object",
+      "description": "段の箱で全意匠に共通して使う見出し寸法",
+      "additionalProperties": false,
+      "required": ["topPad", "numberSize", "gap", "nameSize", "bottomPad"],
+      "properties": {
+        "leftPad": { "type": "number", "minimum": 0 },
+        "topPad": { "type": "number", "minimum": 0 },
+        "numberSize": { "type": "number", "exclusiveMinimum": 0 },
+        "gap": { "type": "number", "minimum": 0 },
+        "nameSize": { "type": "number", "exclusiveMinimum": 0 },
+        "bottomPad": { "type": "number", "minimum": 0 }
+      }
+    },
+    "stageLayout": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "columnWidths": {
+          "type": "object",
+          "additionalProperties": { "type": "number", "minimum": 0 }
+        },
+        "columnGap": { "type": "number", "minimum": 0 },
+        "backDetourTopGap": { "type": "number", "minimum": 0 },
+        "backDetourSideGap": { "type": "number", "minimum": 0 },
+        "backDetourTargetInset": { "type": "number", "minimum": 0 }
+      }
     },
     "reveal": {
       "type": "string",
@@ -2288,7 +2945,7 @@
         "off",
         "hover"
       ],
-      "description": "箱に触れると関係する線だけを光らせるか。 off (既定) = 何もしない。 hover = 箱に触れた時にその箱と繋がる線と相手の箱だけが光り、他が沈む。 順番を持たないクラス図と ER 図で使う。"
+      "description": "箱に触れると関係する線だけを光らせるか。 off (既定) = 何もしない。 hover = 箱に触れた時にその箱と繋がる線と相手の箱だけが光り、他が沈む。 順番を持たない record の関係図で使う。"
     },
     "bands": {
       "type": "array",
@@ -2321,7 +2978,7 @@
     },
     "events": {
       "type": "array",
-      "description": "押下などの出来事で動く仕掛け。 相手は名前で指す (box / lane / arrow / diagram のどれか 1 つ)。",
+      "description": "押下などの出来事で動く仕掛け。 相手は名前で指し、指し方の項目をちょうど 1 つだけ書く。",
       "items": {
         "type": "object",
         "required": [