@cardenelabs/dragon 0.27.0 → 0.30.0

package/src/schemas/diagram.json

@@ -106,7 +106,7 @@
               },
               "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",
@@ -215,7 +215,7 @@
               },
               "end": {
                 "type": "string",
-                "description": "gantt の工程が終わる時期。"
+                "description": "gantt の工程が終わる時期。 始まりより前の時期は始まりと同じに倒し、知らせを出す。"
               },
               "touchpoint": {
                 "type": "string",
@@ -241,32 +241,14 @@
                 "type": "number",
                 "description": "箱の高さ。"
               },
-              "nodes": {
-                "type": "object",
-                "description": "箱の中の要素ごとの位置と大きさ。 key は header / footer / s0 等の要素名。",
-                "additionalProperties": {
-                  "type": "object",
-                  "additionalProperties": false,
-                  "properties": {
-                    "posX": {
-                      "type": "number"
-                    },
-                    "posY": {
-                      "type": "number"
-                    },
-                    "posW": {
-                      "type": "number"
-                    },
-                    "posH": {
-                      "type": "number"
-                    }
-                  }
-                }
-              },
               "scale": {
                 "type": "number",
                 "description": "parts の描画倍率。 kind に parts identifier を指定した時だけ使える。"
               },
+              "phase": {
+                "type": "boolean",
+                "description": "parts が持つ段を使うか。 既定は書いた段と番号ごとに並べて再生する。 false を書くと parts の段の中身を空にし、値は animation に書いた段だけが動かす。 kind に parts identifier を指定した時だけ使える。"
+              },
               "pos": {
                 "type": "object",
                 "additionalProperties": false,
@@ -284,6 +266,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\" / 空文字が偽、それ以外は真。"
@@ -523,6 +535,10 @@
             "type": "string",
             "description": "ラベル下の補足"
           },
+          "tailSub": {
+            "type": "string",
+            "description": "クラス図の出どころ側の多重度 (例 \"1\")。 sub が行き先の端の多重度。 クラス図でだけ効く"
+          },
           "tone": {
             "type": "string",
             "enum": [
@@ -556,7 +572,7 @@
           },
           "cardinality": {
             "type": "string",
-            "description": "ER の多重度 (1..N 等、 kind: er 用)"
+            "description": "ER の多重度 (type: er 用)。 1:1 / 1:N / N:1 / N:M / 0..1 / 1..* のどれかを書くと、 両端の形がその語から決まり (tailHead / head を書けばそちらが勝つ)、 語は説明文の下の行に出る。 説明文に書いた同じ語は説明文から外す。 6 語以外を書くと説明文に (語) と添えるだけで、 端の形は決まらない (tailHead と head を両方書かなければ、 描かない端を知らせる)。 type: er 以外の図種では描かず、 そのことを知らせる"
           },
           "side": {
             "type": "string",
@@ -581,7 +597,7 @@
               "many",
               "zero-many"
             ],
-            "description": "着き先側の端の形。 端の形で関係の種類を示す = triangle (継ぐ) / diamond (持つ) / open (使う) / crow (多) / one / zero-one / many / zero-many (個数)。 書かなければ塗った三角になる。"
+            "description": "着き先側の端の形。 端の形で関係の種類を示す = triangle (継承・実装) / diamond (集約・コンポジション) / open (関連・依存) / crow (多) / one / zero-one / many / zero-many (個数)。 書かなければ塗った三角になる。"
           },
           "tailHead": {
             "type": "string",
@@ -658,6 +674,18 @@
             "type": "boolean",
             "description": "true で説明文を矢印の線の上に重ねる (分岐図の条件ラベル用)"
           },
+          "fromPartNode": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "\\S",
+            "description": "from が部品の時、矢印を繋ぐ部品の中の要素の id。 要素を 1 つだけ持つ部品は書かなくてもその要素に繋ぐ。 要素を 2 つ以上持つ部品は書かないと矢印を外して知らせる"
+          },
+          "toPartNode": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "\\S",
+            "description": "to が部品の時、矢印を繋ぐ部品の中の要素の id。 要素を 1 つだけ持つ部品は書かなくてもその要素に繋ぐ。 要素を 2 つ以上持つ部品は書かないと矢印を外して知らせる"
+          },
           "pos": {
             "type": "object",
             "additionalProperties": false,
@@ -780,9 +808,13 @@
               "tree",
               "gantt",
               "funnel",
-              "slope"
+              "slope",
+              "gauge",
+              "radial",
+              "stacked",
+              "waffle"
             ],
-            "description": "この phase で起点から描くもの。 語は図種と揃える。 line / journey = 線が左端から右へ伸びる / bar = 棒が横軸から上へ伸びる / pie = 扇が 12 時から時計回りに開く / mind = 枝が中心から外へ伸びる / tree = 枝が根から下へ伸びる / gantt = 帯が各始端から右へ伸びる / funnel = 段が上端から順に積まれる / slope = 線が左の軸から右の軸へ伸びる"
+            "description": "この phase で起点から描くもの。 語は図種と揃える。 line / journey = 線が左端から右へ伸びる / bar = 棒が横軸から上へ伸びる / pie = 扇が 12 時から時計回りに開く / mind = 枝が中心から外へ伸びる / tree = 枝が根から下へ伸びる / gantt = 帯が各始端から右へ伸びる / funnel = 段が上端から順に積まれる / slope = 線が左の軸から右の軸へ伸びる / gauge = 弧が 9 時から上を通って 3 時へ伸びる / radial = 各輪が 12 時から時計回りに開く / stacked = 帯が左端から右へ伸びる / waffle = 印が左上から読む向きに 1 個ずつ埋まる"
           },
           "drawRatio": {
             "type": "number",
@@ -2017,10 +2049,43 @@
           "min": {
             "type": "number"
           },
+          "offLabel": {
+            "type": "string",
+            "minLength": 1,
+            "description": "切り替え (toggle) が切の時に、箱の字の差し込みへ描く名前。 省略すると false を描く。"
+          },
+          "onLabel": {
+            "type": "string",
+            "minLength": 1,
+            "description": "切り替え (toggle) が入の時に、箱の字の差し込みへ描く名前。 省略すると true を描く。"
+          },
           "options": {
             "type": "array",
+            "description": "選択肢。 文字列は値と名前を兼ね、{ value, label } の組は value を値にして label を操作部の選択肢と箱の字の差し込みに描く。 2 つを混ぜて書ける。",
             "items": {
-              "type": "string"
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "value",
+                    "label"
+                  ],
+                  "properties": {
+                    "value": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "label": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  }
+                }
+              ]
             }
           },
           "placeholder": {
@@ -2194,11 +2259,34 @@
     },
     "formulas": {
       "type": "object",
-      "description": "つまみの値から決まる値。 名前を鍵、式を値に書く。 `values` とは経路が別で、式は名前を中括弧で囲わない (例 \"input * 2\")。",
+      "description": "つまみの値から決まる値。 名前を鍵、式を値に書く。 `values` とは経路が別で、式は名前を中括弧で囲わない (例 \"input * 2\")。 操作部に出す名札を付ける時は { \"expression\": \"input * 2\", \"label\": \"2 倍\" } の組で書く。",
       "additionalProperties": {
-        "type": "string",
-        "minLength": 1,
-        "pattern": "\\S"
+        "oneOf": [
+          {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "\\S"
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["expression"],
+            "properties": {
+              "expression": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "\\S",
+                "description": "式 (例 \"input * 2\")"
+              },
+              "label": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "\\S",
+                "description": "操作部に式の名前として出す名札。 書かなければ名前をそのまま出す"
+              }
+            }
+          }
+        ]
       },
       "propertyNames": {
         "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
@@ -2228,6 +2316,14 @@
       ],
       "description": "矢印をいつ出すか。 phase (既定) = 段が名指しする矢印はその段が来るまで描かない。 all = 段に関わらず最初から全部描く。"
     },
+    "relations": {
+      "type": "string",
+      "enum": [
+        "off",
+        "hover"
+      ],
+      "description": "箱に触れると関係する線だけを光らせるか。 off (既定) = 何もしない。 hover = 箱に触れた時にその箱と繋がる線と相手の箱だけが光り、他が沈む。 順番を持たないクラス図と ER 図で使う。"
+    },
     "bands": {
       "type": "array",
       "description": "順序図で面が動いている間の帯。 書かなければ面ごとに「最初に関わった段から最後まで」 の 1 本になる。",
@@ -2259,7 +2355,7 @@
     },
     "events": {
       "type": "array",
-      "description": "押下などの出来事で動く仕掛け。 相手は名前で指す (box / lane / arrow / diagram のどれか 1 つ)。",
+      "description": "押下などの出来事で動く仕掛け。 相手は名前で指し、指し方の項目をちょうど 1 つだけ書く。",
       "items": {
         "type": "object",
         "required": [

package/src/types.ts

@@ -3,7 +3,7 @@
  * docs/cdl/text-dsl-spec.md の文法を AST に変換した中間表現
  */
 
-import type { CdlDiagram, NodeKind, Tone, EdgeStyle, EdgeHead, EdgeHeadFill, EdgeReveal, ClassRelationType, SequenceMessageKind } from "@cardenelabs/cdl";
+import type { CdlDiagram, NodeKind, Tone, EdgeStyle, EdgeHead, EdgeHeadFill, EdgeReveal, RelationFocus, ClassRelationType, SequenceMessageKind } from "@cardenelabs/cdl";
 import type { DslOnlyKind } from "./v05/parser";
 import type { DslDirection, DslPalette } from "./keywords";
 
@@ -91,13 +91,13 @@ export type Position = {
 };
 
 /**
- * canvas pivot (CAR-1693 Phase 1) の DSL 表面 `pos: {x, y}` を保持する型。
- * auto layout の compute value からの offset (dx, dy) を表す。 element の `layoutPos:` が
- * undefined なら auto layout の値をそのまま採用 (catalog 100+ backward compat)、 set 済なら
- * Phase 2 の applyPosOffset pass が offset として適用する。
+ * 自動で決まった位置からのずらし (dx, dy) (#1971)。
  *
- * naming = DSL 表面 syntax は user 提案 wording (`pos:`) を維持、 内部 AST は既存 `pos: Position`
- * (source line/column) との collision 回避のため `layoutPos:` に rename する 2 層設計。
+ * JSON は `pos: { x, y }`、記法は `offsetX` / `offsetY` で書く。 内部では、行番号を持つ
+ * `pos: Position` と名前が重ならないよう `layoutPos` に入れる。
+ *
+ * 書かなければ自動の配置のまま。 書くと組み立ての出口 (`applyLayoutOffsets`) が 1 度配置してから
+ * 配置後の位置に足して置き直す。 箱と縦列は位置が動き、矢印は名前のずらしに足す。
  */
 export type LayoutPos = {
   x: number;
@@ -168,6 +168,16 @@ export type DslDocument = {
    * 段に関わらず最初から全部描く。 描き手の `CdlDiagram.edgeReveal` にそのまま渡る。
    */
   reveal?: EdgeReveal;
+  /**
+   * 箱に触れると関係する線だけを光らせるか (`relations:`、 #1757)。
+   *
+   * 既定 (`off`) は何もしない。 `hover` と書くと、箱に触れた時に その箱 ・ 繋がる線 ・
+   * 相手の箱だけが光り、他が沈む。 描き手の `CdlDiagram.relationFocus` にそのまま渡る。
+   *
+   * クラス図と ER 図は **順番を持たない** 図で、段を追う見せ方は「どの順で読ませるか」 しか
+   * 運ばない。 触れた箱の関係を光らせれば、読み手の問いにその場で答えられる。
+   */
+  relations?: RelationFocus;
   /**
    * 図の並ぶ向き (`direction:`、 #1494)。
    *
@@ -371,6 +381,14 @@ export type DslActor = {
    * 解析の時点ではパーツの定義を知らないため、 名前を決めずに持っておく。
    */
   colorHex?: string;
+  /**
+   * 部品に `color:` で書いた色の名前 (`成功` 等) (#1973)。
+   *
+   * 部品の色の状態は色番号しか受けず、色の名前は箱の色 (`tone`) にしか効かない。 部品には
+   * 箱の色を渡さないため、書いても絵が変わらない。 黙って捨てると手掛かりが残らないので、
+   * 書いた名前を残して組み立て側が知らせる。
+   */
+  partColorName?: Tone;
   /**
    * parts state override (partId set 時のみ有効)。 kind + 既存 reserved fields を除いた
    * inline option の残り (`v: 50` / `count: 100` 等) を state 名 → initial 値 map として保持。
@@ -410,35 +428,14 @@ export type DslActor = {
    */
   posRel?: RelativePos;
   /**
-   * canvas pivot UX 修正 (B1 individual node isolation)。 actor 1 件が生成する複数 sub-node
-   * (sequence の header / spacer / footer / s{N} 等) の中で「特定 sub-node だけを固定 / resize」
-   * するための nested override map。 key = sub-node id 相当の short key (`header` / `footer` /
-   * `spacer` / `s0` 等)、 value = posX/Y/W/H の 4 field。 compile 側は対応 CDL node に単独反映、
-   * 同 actor の他 sub-node は影響を受けない (lane 全体 posX とは独立経路)。
-   */
-  nodes?: Record<string, DslActorNodeOverride>;
-  /**
-   * canvas pivot (CAR-1693 Phase 1) DSL 表面 `pos: {x, y}` 由来の layout offset。 未指定は auto
-   * layout の compute value そのまま (backward compat)、 set 済なら Phase 2 の applyPosOffset で
-   * (auto x + layoutPos.x, auto y + layoutPos.y) に shift される。 既存 posX/posY (絶対座標) は
-   * 別 mechanism で、 layoutPos は auto layout からの nudge (dx, dy)。
+   * 箱の位置のずらし (#1971)。 配置後の箱の中心を (x, y) だけ動かす。 `posX` / `posY` (座標) とは
+   * 別の欄で、座標も書いた時は座標で置いた位置からずらす。 見本 (parts) は見本 1 つ分をまとめて動かす。
+   * 同じ縦列の箱に近づくと、描画側が間隔を保つようそちらを押し下げる。
    */
   layoutPos?: LayoutPos;
   pos: Position;
 };
 
-/**
- * canvas pivot UX 修正 (B1) = actor 内 sub-node 単位で「絶対座標 / サイズ」 を固定するための
- * override 値。 全 field optional、 posX / posY が両方 set 済なら CDL 側で該当 sub-node の
- * auto layout を skip、 明示座標をそのまま採用する。 posW / posH は width / height の上書き。
- */
-export type DslActorNodeOverride = {
-  posX?: number;
-  posY?: number;
-  posW?: number;
-  posH?: number;
-};
-
 /** 流れ (1 行 = 1 step) (v0.5+ ... inline option 拡張) */
 export type DslStep = {
   no: number;
@@ -465,8 +462,8 @@ export type DslStep = {
   /**
    * 矢印の先の形 (#1462)。 書かなければ従来どおり塗った三角。
    *
-   * 4 図の設計は **端の形で関係の種類を示す** = 三角 (継ぐ) / 菱 (持つ) /
-   * 開いた矢 (使う) / 鳥の足 (多)。 書けないと 4 種とも同じ三角になり、
+   * 4 図の設計は **端の形で関係の種類を示す** = 三角 (継承・実装) / 菱 (集約・コンポジション) /
+   * 開いた矢 (関連・依存) / 鳥の足 (多)。 書けないと 4 種とも同じ三角になり、
    * 線の種類 (実線 / 点線) だけで 6 種の関係を区別することになる。
    *
    * 受ける語は描画側の `EDGE_HEADS` から導く = 描画側が増やせば書けるようになる。
@@ -474,10 +471,16 @@ export type DslStep = {
   head?: EdgeHead;
   /** 出どころ側の端の形 (#1466)。 ER は端ごとに違う個数を示すので両端に要る */
   tailHead?: EdgeHead;
-  /** 端の印の塗り (#1466)。 白抜きの菱が「持つ」、塗った菱が「抱える」 */
+  /** 端の印の塗り (#1466)。 白抜きの菱が集約、塗った菱がコンポジション */
   headFill?: EdgeHeadFill;
   /** 出どころ側の印の塗り (#1466) */
   tailHeadFill?: EdgeHeadFill;
+  /**
+   * クラス図の出どころ側の多重度 (#1771)。 `sub` (行き先の端の多重度) と対。
+   *
+   * クラス図でだけ効く (関係の語 `relation` と同じ)。 engine が出どころの端の近くに添える。
+   */
+  tailSub?: string;
   /**
    * クラス図の関係の種類 (#1466)。 書くと線と端の形と塗りと付く側がまとめて決まる。
    *
@@ -500,10 +503,19 @@ export type DslStep = {
   /** true で説明文を矢印の線の上に重ねる。 分岐図の条件ラベル用。 */
   overlay?: boolean;
   /**
-   * canvas pivot (CAR-1693 Phase 1) DSL 表面 `pos: {x, y}` 由来の layout offset。 step の edge
-   * label 位置を auto layout compute から (dx, dy) shift する。 未指定は auto、 set 済は Phase 2 で適用。
+   * 矢印の位置のずらし (#1971)。 矢印の通り道は両端の箱で決まるので、名前のずらし
+   * (`labelOffsetX` / `labelOffsetY`) に足して名前だけを動かす。
    */
   layoutPos?: LayoutPos;
+  /**
+   * 部品 (parts) の端で、矢印を繋ぐ部品の中の要素の id (#1979)。 出どころ側が `fromPartNode`、
+   * 行き先側が `toPartNode`。
+   *
+   * 要素を 1 つだけ持つ部品は書かなくてもその要素に繋ぐ。 要素を 2 つ以上持つ部品は外枠を持たず
+   * 同格の要素が並ぶため、1 つを自動で選ぶと「その要素だけ」 を指す矢印に見える。 書き手が名指しする。
+   */
+  fromPartNode?: string;
+  toPartNode?: string;
   pos: Position;
 };
 
@@ -516,18 +528,25 @@ export type DslLane = {
   contain?: boolean;
   lifeline?: boolean;
   /**
-   * canvas pivot (CAR-1693 Phase 1) DSL 表面 `pos: {x, y}` 由来の layout offset。 lane の x 座標を
-   * auto layout compute から (dx, dy) shift する。 未指定は auto、 set 済は Phase 2 で適用。
+   * 縦列の位置のずらし (#1971)。 配置後の縦列の左上を (x, y) だけ動かし、中の箱も一緒に動く。
+   * 1 本でもずらすと全ての縦列を配置後の位置と大きさで固定し、動いた箱を元の位置に留めるので、
+   * 他の縦列とその箱は動かない。
    */
   layoutPos?: LayoutPos;
   pos: Position;
 };
 
-/** group 宣言 (v0.5+ top-level groups section、 topology preset 専用) */
+/**
+ * 組の宣言 (v0.5+ top-level groups section)。
+ *
+ * `lanes` に並べた縦列とその中の箱を、 縦列の位置が決まった後に 1 つの枠 (`group-{id}`) で囲む (#1972)。
+ * 図に無い縦列は除いて囲み、 1 本も無ければ枠を描かない。 間に束ねない縦列を挟むと、 その縦列ごと囲む。
+ * どちらも知らせで伝える。
+ */
 export type DslGroup = {
   id: string;
   label?: string;
-  lanes: string[]; // 内包する lane id
+  lanes: string[]; // 囲む縦列の id
   pos: Position;
 };
 
@@ -618,10 +637,10 @@ export type DslValue = {
     }
 );
 
-/** ステップ (phase) */
 /** 動いている間の帯 (#1466)。 順序図で、面がいつ動いているかを段の番号で持つ */
 export type DslBand = { actor: string; from: number; to: number };
 
+/** ステップ (phase) */
 export type DslPhase = {
   name: string;
   durationMs: number;

package/src/v05/input-table.generated.ts

@@ -25,7 +25,7 @@ export const つまみの表: Record<string, 図形の定義> = {
   dropdown: {
     必須: ["options", "defaultValue"],
     欄: {
-      options: "文字列の並び",
+      options: "選択肢の並び",
       defaultValue: "文字列",
       label: "文字列",
     },
@@ -33,7 +33,7 @@ export const つまみの表: Record<string, 図形の定義> = {
   "multi-select": {
     必須: ["options", "defaultValues"],
     欄: {
-      options: "文字列の並び",
+      options: "選択肢の並び",
       defaultValues: "文字列の並び",
       label: "文字列",
     },
@@ -50,7 +50,7 @@ export const つまみの表: Record<string, 図形の定義> = {
   radio: {
     必須: ["options", "defaultValue"],
     欄: {
-      options: "文字列の並び",
+      options: "選択肢の並び",
       defaultValue: "文字列",
       label: "文字列",
     },
@@ -89,7 +89,7 @@ export const つまみの表: Record<string, 図形の定義> = {
   tabs: {
     必須: ["options", "defaultValue"],
     欄: {
-      options: "文字列の並び",
+      options: "選択肢の並び",
       defaultValue: "文字列",
       label: "文字列",
     },
@@ -119,6 +119,8 @@ export const つまみの表: Record<string, 図形の定義> = {
     欄: {
       defaultValue: "真偽",
       label: "文字列",
+      onLabel: "文字列",
+      offLabel: "文字列",
     },
   },
   xypad: {

package/src/v05/parser-types.ts

@@ -13,9 +13,20 @@
  *
  * `数の並び` は #1389 で足した。 描画側のつまみに `readonly number[]` の欄が 1 つあり
  * (`timeline` の再生速度の候補)、`文字列の並び` として読むと数が文字列のまま図に載る。
+ *
+ * `選択肢の並び` は #1920 で足した。 選択肢を持つ入力欄の `options` で、要素は文字列か
+ * `{ value, label }` の組 (描画側の `CdlInputOption`)。 `文字列の並び` として読むと組を `,` で割る。
  */
 export type 欄の形 =
-  "数" | "文字列" | "数か文字列" | "文字列の並び" | "数の並び" | "向き" | "組の並び" | "真偽";
+  | "数"
+  | "文字列"
+  | "数か文字列"
+  | "文字列の並び"
+  | "数の並び"
+  | "向き"
+  | "組の並び"
+  | "真偽"
+  | "選択肢の並び";
 
 /** 1 つの種類が受ける、必須の欄と全欄の形 */
 export type 図形の定義 = { 必須: readonly string[]; 欄: Record<string, 欄の形> };