{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://fa-spec.com/spec/v1/common.schema.json",
  "title": "spec-platform/v1 共通の外枠",
  "description": "FA Spec Tools の 4 つのエディタが読み書きする JSON の共通部分。仕様の正は https://fa-spec.com/json-format 。読み込み側は知らない項目を無視するので、ここに無い項目を足しても構わない（additionalProperties は禁止しない）。",
  "type": "object",
  "required": ["schema", "kind", "v"],
  "properties": {
    "schema": { "const": "spec-platform/v1", "description": "常に \"spec-platform/v1\"。" },
    "kind": { "enum": ["systemdiagram", "addressmap", "timingchart", "flowchart", "machine"], "description": "何のファイルか。残りの読み方がこれで決まる。machine（装置ファイル。4 つの kind の文書を束ねる）は draft。" },
    "v": { "type": "number", "description": "その kind の中での形式の版（JSON の書き方の版。図の改訂は revisions）。構成図 1・メモリマップ 3（v1 / v2 も読む）・タイミングチャート 5・フローチャート 1（2026-09 時点）。読み込み側は自分より古い版を受け付ける。" },
    "title": { "type": "string", "description": "図や表の題名。空でも構わない。" },
    "revisions": { "type": "array", "items": { "$ref": "#/$defs/revision" }, "description": "図の改訂履歴。古い順に並べ、最後の行が今の版。エディタは書き出す図の題名の横と Markdown の見出しに今の版を出す。空なら書かない。承認の状態は持たない。" }
  },
  "$defs": {
    "revision": {
      "type": "object",
      "description": "改訂履歴の 1 行。どの項目も省略できる。",
      "properties": {
        "rev": { "type": "string", "description": "版の記号（A・B・1・2 など）。" },
        "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "改訂した日（YYYY-MM-DD）。" },
        "author": { "type": "string", "description": "担当（改訂した人）。" },
        "note": { "type": "string", "description": "改訂の内容。" }
      }
    },
    "id": {
      "type": "string",
      "description": "同じファイルの中で重複しない文字列。ほかの項目から参照されるので、後から変えない。"
    },
    "role": {
      "enum": ["M", "S", "I", ""],
      "description": "向き。\"M\"（マスター側が出す）/ \"S\"（スレーブ側が出す）/ \"I\"（内部）。空文字は未設定（メモリマップとタイミングチャートは、向きを決めていない変数をこう書き出す）。"
    },
    "point": {
      "type": "object",
      "properties": { "x": { "type": "number" }, "y": { "type": "number" } }
    },
    "block": {
      "type": "object",
      "description": "機器の中の機能のまとまり。メモリマップへ渡したときの変数の入れ物になる。",
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "name": { "type": "string" },
        "comment": { "type": "string" },
        "varIds": { "type": "array", "items": { "type": "string" } }
      }
    },
    "variable": {
      "type": "object",
      "description": "変数 1 つ。メモリマップの variables[]。構成図・タイミングチャートの variables[] も同じ形。",
      "required": ["id", "name"],
      "properties": {
        "id": { "$ref": "#/$defs/id", "description": "この変数の識別子。" },
        "name": { "type": "string", "description": "変数名（例 bStartReq）。" },
        "type": { "type": "string", "description": "BOOL / INT / DINT / WORD / REAL など。IEC 61131-3 の型名。" },
        "role": { "$ref": "#/$defs/role" },
        "address": { "type": "string", "description": "割り付けた先（例 M0 / D100）。空ならエディタ側で自動割付できる。" },
        "addrText": { "type": "string", "description": "表示用のアドレス。ビットを 16 進で書くデバイス（例 D100.F）で、address.bit（10 進）と違うときだけ書く。" },
        "peerAddress": { "type": "string", "description": "相手側の番地（リンクデバイスや相手の機器の番地。例 RX10・DI101・Asm101 +0）。書き方は自由で、エディタは比べない。無ければ書かない。" },
        "bit": { "type": ["number", "null"], "description": "ワードデバイスの中のビット番号。使わないときは null。" },
        "initialValue": { "type": "string", "description": "初期値。" },
        "comment": { "type": "string", "description": "デバイスコメントになる。" },
        "unit": { "type": "string", "description": "工学値の単位（例 MPa・mm/s・%）。無ければ書かない。" },
        "engMin": { "type": "number", "description": "工学値の下限。工学値 = engMin + (生の値 − rawMin) × (engMax − engMin) / (rawMax − rawMin)。逆作動（生の値が増えると工学値が減る）は engMin に大きい方を書く。" },
        "engMax": { "type": "number", "description": "工学値の上限。" },
        "rawMin": { "type": "number", "description": "生の値（PLC のデバイスに入る値）の下限（例 A/D の 0）。" },
        "rawMax": { "type": "number", "description": "生の値の上限（例 A/D の 32000）。" },
        "retain": { "type": "boolean", "description": "停電しても値を残す変数なら true（レシピ番号・生産数など）。メモリマップではブロックの retain も引き継ぐ。" },
        "safety": { "type": "boolean", "description": "安全プログラム側の信号（非常停止・ライトカーテンなど）なら true。型が SAFEBOOL / SAFEBYTE / SAFEWORD / SAFEDWORD / SAFEINT / SAFEDINT / SAFEUINT / SAFEUDINT / SAFESINT / SAFEUSINT / SAFETIME なら書かなくても安全の信号。メモリマップではブロックの safety も引き継ぐ。" },
        "interlock": {
          "type": "array",
          "description": "インターロック（この出力が動いてよい条件）。メモリマップの変数に書く。すべての条件が成り立つときだけ動いてよい、の 1 組で、自動・手動・原点復帰で共通（モードで分けない。分けたくなる所は厳しい側にそろえる）。無ければ書かない。",
          "items": {
            "type": "object",
            "properties": {
              "varId": { "type": "string", "description": "条件の変数（同じメモリマップの variables[].id）。正はこれ。" },
              "name": { "type": "string", "description": "条件の変数の名前（表示用。varId が無いか見つからないときは、この名前で探す）。" },
              "on": { "type": "boolean", "description": "その変数が ON（true）/ OFF（false）であること。省略すると true。" },
              "text": { "type": "string", "description": "変数で書けない条件（例：圧力 0.4 MPa 以上）。varId・name を書かないときに使う（条件 1 つに、varId か name か text のどれかを書く）。" }
            }
          }
        },
        "deviceId": { "type": "string", "description": "どの機器に属するか。" },
        "blockId": { "type": "string", "description": "どのブロックに属するか。" },
        "device": { "type": "string", "description": "機器の名前（表示用。正は deviceId）。" },
        "block": { "type": "string", "description": "ブロックの名前（表示用。正は blockId）。" }
      }
    },
    "scope": {
      "type": "array",
      "description": "対象の区画。メモリマップの機器の id（devices[].id）の配列。省略または空なら全体の図。1 つならその区画の図、2 つ以上なら区画間のインターフェース図。同じ id が重なっていたら 1 つとして扱う。",
      "items": { "type": "string" }
    },
    "partition": {
      "type": "object",
      "description": "区画の名前。scope を名前で見せるためのもの。",
      "required": ["id"],
      "properties": {
        "id": { "type": "string", "description": "メモリマップの機器の id。" },
        "name": { "type": "string" }
      }
    },
    "triggerEnd": {
      "type": "object",
      "required": ["varId", "step"],
      "properties": {
        "varId": { "type": "string", "description": "行（rows[].id）または変数の id。" },
        "step": { "type": "number", "description": "変わり目の Step。" },
        "level": { "enum": ["high", "low"], "description": "変わり目の上下どちらの角に矢印を付けるか（見た目だけ）。省略すると変わったあとのレベル側。" }
      }
    },
    "trigger": {
      "type": "object",
      "description": "因果関係の矢印。どの信号の変化が、どの信号の変化を起こしたか。",
      "required": ["from", "to"],
      "properties": {
        "from": { "$ref": "#/$defs/triggerEnd" },
        "to": { "$ref": "#/$defs/triggerEnd" },
        "time": {
          "type": "object",
          "description": "原因の変化から結果の変化までの時間の条件（ms）。例 { \"max\": 3000, \"note\": \"超えたら異常\" }。同じ信号の変化どうしならパルス幅・保持時間。省略可。",
          "properties": {
            "min": { "type": "number", "minimum": 0, "description": "下限（これ以上）［ms］。" },
            "max": { "type": "number", "minimum": 0, "description": "上限（これ以内）［ms］。フローチャートを作るとき、待ちの時間切れになる。" },
            "note": { "type": "string", "description": "超えたときの扱いなどのメモ。" }
          }
        }
      }
    }
  }
}
