@yanqirenshi/model.deployment 0.0.0-stage → 0.1.0

package/dist/patch.d.ts

@@ -0,0 +1,35 @@
+import type { MergePatch, DeploymentChange, DeploymentCollection, DeploymentMove, DeploymentNodeRecord, DeploymentRecord, DeploymentValues } from './types.js';
+/** 入力の検証エラー。message は利用者向け */
+export declare class ModelError extends Error {
+    constructor(message: string);
+}
+/** レコードを置くコレクション */
+export declare function collectionOf(record: DeploymentRecord): DeploymentCollection;
+/** インスペクタの見出し。ラベルの文字、無ければ「種類 id」(線は「接続元 → 接続先」) */
+export declare function titleOf(record: DeploymentRecord): string;
+/** ドット区切りの path で値を取り出す */
+export declare function getByPath(obj: unknown, path: string): unknown;
+/**
+ * JSON Merge Patch をレコードに重ねたものを返す(入力は書き換えない)。
+ * null の項目は除く。保存したあと、表示を先に更新するときに使う。
+ */
+export declare function mergePatch<T extends object>(record: T, patch: MergePatch): T;
+/**
+ * ドラッグで動かしたノードの位置を保存する patch。
+ * 保存してある position に移動量を足し、整数に丸める(position が無いときは 0, 0 から)。
+ * 子のノード(COMPONENT を含む)の position は親の中での位置なので、親を動かしても子の patch は要らない。
+ */
+export declare function movePatch(node: DeploymentNodeRecord, move: DeploymentMove): DeploymentChange;
+/**
+ * 色として読める文字列か。
+ * ブラウザでは CSS.supports('color', v) で判定する。Node など CSS の無い環境では、
+ * #rgb / #rrggbb / #rrggbbaa・rgb() などの関数表記・英字だけの色名、を通す緩い判定にする。
+ */
+export declare function isColor(value: string): boolean;
+/**
+ * インスペクタの「適用」の値を、保存する patch に変換する。
+ * 図に描いている値から変えた項目だけを patch に入れる(変えていない既定の値まで書き込まないため)。
+ * 変更が無ければ patch は {}。
+ */
+export declare function applyPatch(record: DeploymentRecord, values: DeploymentValues): DeploymentChange;
+//# sourceMappingURL=patch.d.ts.map

package/dist/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../src/patch.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAAwB,cAAc,EAAE,oBAAoB,EAC9G,gBAAgB,EAAE,gBAAgB,EACnC,MAAM,YAAY,CAAC;AAEpB,8BAA8B;AAC9B,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAED,oBAAoB;AACpB,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,oBAAoB,CAE3E;AAED,mDAAmD;AACnD,wBAAgB,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAUxD;AAED,2BAA2B;AAC3B,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAK7D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,GAAG,CAAC,CAmB5E;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,cAAc,GAAG,gBAAgB,CAa5F;AAUD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAY9C;AA4LD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAM/F"}

package/dist/patch.js

@@ -0,0 +1,251 @@
+// UI の操作(ドラッグ・インスペクタの適用)を、保存する patch(JSON Merge Patch)に変換する。
+//
+// 戻り値は { collection, id, patch }。利用側(iHub など)は図の種類を知らずにこれを保存すればよい。
+// 入力の検証に失敗したときは ModelError を投げる(メッセージは利用者にそのまま見せられる日本語)。
+// model.sitemap の patch.ts を元にしている(ラベルは label.text、種類は NODE / COMPONENT、線に矢印の有無がある)。
+import { NODE_TYPES, isEdge, withDefaults } from './defaults.js';
+import { fieldsOf } from './fields.js';
+/** 入力の検証エラー。message は利用者向け */
+export class ModelError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ModelError';
+    }
+}
+/** レコードを置くコレクション */
+export function collectionOf(record) {
+    return isEdge(record) ? 'edges' : 'nodes';
+}
+/** インスペクタの見出し。ラベルの文字、無ければ「種類 id」(線は「接続元 → 接続先」) */
+export function titleOf(record) {
+    if (isEdge(record))
+        return `${String(record.from.id)} → ${String(record.to.id)}`;
+    const text = record.label && typeof record.label === 'object' ? record.label.text : null;
+    if (typeof text === 'string' && text !== '')
+        return text;
+    return `${record.type || ''} ${String(record.id)}`.trim();
+}
+/** ドット区切りの path で値を取り出す */
+export function getByPath(obj, path) {
+    return path.split('.').reduce((acc, key) => (acc == null ? acc : acc[key]), obj);
+}
+/**
+ * JSON Merge Patch をレコードに重ねたものを返す(入力は書き換えない)。
+ * null の項目は除く。保存したあと、表示を先に更新するときに使う。
+ */
+export function mergePatch(record, patch) {
+    const out = { ...record };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === null) {
+            delete out[key];
+        }
+        else if (typeof value === 'object' && !Array.isArray(value)) {
+            const base = out[key];
+            out[key] = mergePatch(base && typeof base === 'object' && !Array.isArray(base) ? base : {}, value);
+        }
+        else {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+/**
+ * ドラッグで動かしたノードの位置を保存する patch。
+ * 保存してある position に移動量を足し、整数に丸める(position が無いときは 0, 0 から)。
+ * 子のノード(COMPONENT を含む)の position は親の中での位置なので、親を動かしても子の patch は要らない。
+ */
+export function movePatch(node, move) {
+    const base = node.position || { x: 0, y: 0 };
+    return {
+        collection: 'nodes',
+        id: node.id,
+        patch: {
+            position: {
+                x: Math.round(base.x + move.dx),
+                y: Math.round(base.y + move.dy),
+            },
+        },
+    };
+}
+// ---- 入力の読み取り ------------------------------------------------------------
+function toNumber(value) {
+    const n = Number(value);
+    return value !== '' && Number.isFinite(n) ? n : null;
+}
+/**
+ * 色として読める文字列か。
+ * ブラウザでは CSS.supports('color', v) で判定する。Node など CSS の無い環境では、
+ * #rgb / #rrggbb / #rrggbbaa・rgb() などの関数表記・英字だけの色名、を通す緩い判定にする。
+ */
+export function isColor(value) {
+    if (value === '')
+        return false;
+    const css = globalThis.CSS;
+    if (css && typeof css.supports === 'function')
+        return css.supports('color', value);
+    return /^#([0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/i.test(value)
+        || /^(rgb|rgba|hsl|hsla|hwb|lab|lch|oklab|oklch|color)\(.+\)$/i.test(value)
+        || /^[a-z]+$/i.test(value);
+}
+function toColor(value, label) {
+    if (!isColor(value))
+        throw new ModelError(`${label}は、色 (#ff0000 や red など) で入力してください。`);
+    return value;
+}
+// 0 より大きい数(枠線・線の太さ。d3.deployment は 0 を「書いていない」と見て既定に倒すので、0 は入れられない)
+function toWidth(value, label) {
+    const n = toNumber(value);
+    if (n === null || n <= 0)
+        throw new ModelError(`${label}は、0 より大きい数で入力してください。`);
+    return n;
+}
+// 0 以上の整数(幅・高さ。0 は「子に合わせる」)
+function toLength(value, label) {
+    const n = toNumber(value);
+    if (n === null || n < 0)
+        throw new ModelError(`${label}は 0 以上の数で入力してください。(0 で子に合わせる)`);
+    return Math.round(n);
+}
+// 角度(0 以上 360 未満の整数に正規化)
+function toDegree(value, label) {
+    const n = toNumber(value);
+    if (n === null)
+        throw new ModelError(`${label}は、角度 (数) で入力してください。`);
+    return ((Math.round(n) % 360) + 360) % 360;
+}
+function toOption(value, options, label) {
+    if (!options.includes(value))
+        throw new ModelError(`${label}は、${options.join(' / ')} のどれかで入力してください。`);
+    return value;
+}
+// true / false
+function toBoolean(value, label) {
+    if (value !== 'true' && value !== 'false')
+        throw new ModelError(`${label}は、true / false のどちらかで入力してください。`);
+    return value === 'true';
+}
+// 空にできる文字列。空なら null(JSON Merge Patch で項目を除く)
+function toOptionalText(value) {
+    return value === '' ? null : value;
+}
+// patch の入れ子に値を置く(patch.border.color = v のように)
+function put(patch, path, value) {
+    const keys = path.split('.');
+    let cur = patch;
+    for (const key of keys.slice(0, -1)) {
+        if (!cur[key] || typeof cur[key] !== 'object')
+            cur[key] = {};
+        cur = cur[key];
+    }
+    cur[keys[keys.length - 1]] = value;
+}
+/**
+ * インスペクタの入力のうち、図に描いている値(withDefaults で埋めた値)から変わった項目だけを返す。
+ * 前後の空白は除く。読み取り専用の項目と、values に無い項目は含めない。
+ */
+function changedValues(record, values) {
+    const effective = withDefaults(record);
+    const out = new Map();
+    for (const field of fieldsOf(record)) {
+        if (field.type === 'readonly')
+            continue;
+        const value = values[field.path];
+        if (value === undefined)
+            continue;
+        const current = getByPath(effective, field.path);
+        if (value.trim() !== String(current ?? ''))
+            out.set(field.path, value.trim());
+    }
+    return out;
+}
+// ノードの入力 → patch(label.text / type / description / link.url / size / background / border)
+function nodePatch(node, values) {
+    const patch = {};
+    for (const [path, value] of changedValues(node, values)) {
+        switch (path) {
+            case 'label.text':
+                // 名称は空にできない(d3.deployment は名称の無いノードに '????????' を描く)
+                if (value === '')
+                    throw new ModelError('名称を入力してください。');
+                put(patch, path, value);
+                break;
+            case 'type':
+                put(patch, path, toOption(value, NODE_TYPES, '種類'));
+                break;
+            case 'description':
+                put(patch, path, toOptionalText(value));
+                break;
+            case 'link.url':
+                // URL を空にするとリンクごと除く(d3.deployment は url の無い link を描かない)
+                if (value === '')
+                    patch.link = null;
+                else
+                    put(patch, path, value);
+                break;
+            case 'size.w':
+                put(patch, path, toLength(value, '幅'));
+                break;
+            case 'size.h':
+                put(patch, path, toLength(value, '高さ'));
+                break;
+            case 'background.color':
+                put(patch, path, toColor(value, '背景色'));
+                break;
+            case 'border.color':
+                put(patch, path, toColor(value, '枠線の色'));
+                break;
+            case 'border.width':
+                put(patch, path, toWidth(value, '枠線の太さ'));
+                break;
+        }
+    }
+    return patch;
+}
+const END_LABELS = { from: '接続元', to: '接続先' };
+// 線の入力 → patch(from / to の角度・stroke・矢印)
+function edgePatch(edge, values) {
+    const patch = {};
+    for (const [path, value] of changedValues(edge, values)) {
+        switch (path) {
+            case 'from.position':
+            case 'to.position':
+                put(patch, path, toDegree(value, `${END_LABELS[path.split('.')[0]]}の位置`));
+                break;
+            case 'stroke.color':
+                put(patch, path, toColor(value, '線の色'));
+                break;
+            case 'stroke.width':
+                put(patch, path, toWidth(value, '線の太さ'));
+                break;
+            case 'stroke.marker.start':
+                put(patch, path, toBoolean(value, '始点の矢印'));
+                break;
+            case 'stroke.marker.end':
+                put(patch, path, toBoolean(value, '終点の矢印'));
+                break;
+        }
+    }
+    // 矢印を片方だけ書くと d3.deployment の Edge.normalize は marker を丸ごと入力で置き換える(無い側は undefined =
+    // start は偽、end は truthy 判定で偽)ので、片方を変えたときはもう片方も描いている値で埋める
+    const marker = patch.stroke?.marker;
+    if (marker) {
+        const effective = withDefaults(edge).stroke.marker;
+        if (marker.start === undefined)
+            marker.start = effective.start;
+        if (marker.end === undefined)
+            marker.end = effective.end;
+    }
+    return patch;
+}
+/**
+ * インスペクタの「適用」の値を、保存する patch に変換する。
+ * 図に描いている値から変えた項目だけを patch に入れる(変えていない既定の値まで書き込まないため)。
+ * 変更が無ければ patch は {}。
+ */
+export function applyPatch(record, values) {
+    return {
+        collection: collectionOf(record),
+        id: record.id,
+        patch: isEdge(record) ? edgePatch(record, values) : nodePatch(record, values),
+    };
+}

package/dist/schema.d.ts

@@ -0,0 +1,274 @@
+export declare const NODES_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly title: "システム構成図のノード";
+    readonly description: "d3.deployment に渡すノード。children に子のノードを入れ子で持つ。id は子のノードも含めて一意にする。position は親の中での位置で、ドラッグで動かすと書き換わる。link を付けると、ノードの左下にリンクを出す。見た目の項目 (label・padding・border・background・description) は d3.deployment の入力の形のまま書ける。";
+    readonly 'x-id-start': 1;
+    readonly type: "array";
+    readonly items: {
+        readonly $ref: "#/$defs/node";
+    };
+    readonly $defs: {
+        readonly node: {
+            readonly type: "object";
+            readonly properties: {
+                readonly id: {
+                    readonly type: readonly ["integer", "string"];
+                };
+                readonly type: {
+                    readonly enum: readonly import("./types.js").DeploymentNodeType[];
+                };
+                readonly label: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly text: {
+                            readonly type: readonly ["string", "null"];
+                        };
+                    };
+                };
+                readonly description: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly size: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly w: {
+                            readonly type: "number";
+                            readonly minimum: 0;
+                        };
+                        readonly h: {
+                            readonly type: "number";
+                            readonly minimum: 0;
+                        };
+                    };
+                    readonly required: readonly ["w", "h"];
+                };
+                readonly position: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly x: {
+                            readonly type: "number";
+                        };
+                        readonly y: {
+                            readonly type: "number";
+                        };
+                    };
+                    readonly required: readonly ["x", "y"];
+                };
+                readonly link: {
+                    readonly type: readonly ["object", "null"];
+                    readonly properties: {
+                        readonly url: {
+                            readonly type: readonly ["string", "null"];
+                        };
+                    };
+                };
+                readonly children: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/node";
+                    };
+                };
+            };
+            readonly required: readonly ["id"];
+            readonly additionalProperties: true;
+        };
+    };
+};
+export declare const EDGES_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly title: "システム構成図の線";
+    readonly description: "ノードの間の線。from.id / to.id はノード (子を含む) の id。position は接続位置の角度 (0=真下・時計回り。省略すると 90=左)。stroke.marker は両端の矢印の有無 (既定: 終点だけ)。";
+    readonly 'x-id-start': 100;
+    readonly type: "array";
+    readonly items: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: readonly ["integer", "string"];
+            };
+            readonly from: {
+                readonly $ref: "#/$defs/end";
+            };
+            readonly to: {
+                readonly $ref: "#/$defs/end";
+            };
+            readonly stroke: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly color: {
+                        readonly type: "string";
+                    };
+                    readonly width: {
+                        readonly type: "number";
+                    };
+                    readonly marker: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly start: {
+                                readonly type: "boolean";
+                            };
+                            readonly end: {
+                                readonly type: "boolean";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly required: readonly ["id", "from", "to"];
+        readonly additionalProperties: true;
+    };
+    readonly $defs: {
+        readonly end: {
+            readonly type: "object";
+            readonly properties: {
+                readonly id: {
+                    readonly type: readonly ["integer", "string"];
+                };
+                readonly position: {
+                    readonly type: "number";
+                };
+            };
+            readonly required: readonly ["id"];
+        };
+    };
+};
+/** コレクション名 → スキーマ */
+export declare const SCHEMAS: {
+    readonly nodes: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly title: "システム構成図のノード";
+        readonly description: "d3.deployment に渡すノード。children に子のノードを入れ子で持つ。id は子のノードも含めて一意にする。position は親の中での位置で、ドラッグで動かすと書き換わる。link を付けると、ノードの左下にリンクを出す。見た目の項目 (label・padding・border・background・description) は d3.deployment の入力の形のまま書ける。";
+        readonly 'x-id-start': 1;
+        readonly type: "array";
+        readonly items: {
+            readonly $ref: "#/$defs/node";
+        };
+        readonly $defs: {
+            readonly node: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: readonly ["integer", "string"];
+                    };
+                    readonly type: {
+                        readonly enum: readonly import("./types.js").DeploymentNodeType[];
+                    };
+                    readonly label: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly text: {
+                                readonly type: readonly ["string", "null"];
+                            };
+                        };
+                    };
+                    readonly description: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly size: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly w: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                            };
+                            readonly h: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                            };
+                        };
+                        readonly required: readonly ["w", "h"];
+                    };
+                    readonly position: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                            };
+                        };
+                        readonly required: readonly ["x", "y"];
+                    };
+                    readonly link: {
+                        readonly type: readonly ["object", "null"];
+                        readonly properties: {
+                            readonly url: {
+                                readonly type: readonly ["string", "null"];
+                            };
+                        };
+                    };
+                    readonly children: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/node";
+                        };
+                    };
+                };
+                readonly required: readonly ["id"];
+                readonly additionalProperties: true;
+            };
+        };
+    };
+    readonly edges: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly title: "システム構成図の線";
+        readonly description: "ノードの間の線。from.id / to.id はノード (子を含む) の id。position は接続位置の角度 (0=真下・時計回り。省略すると 90=左)。stroke.marker は両端の矢印の有無 (既定: 終点だけ)。";
+        readonly 'x-id-start': 100;
+        readonly type: "array";
+        readonly items: {
+            readonly type: "object";
+            readonly properties: {
+                readonly id: {
+                    readonly type: readonly ["integer", "string"];
+                };
+                readonly from: {
+                    readonly $ref: "#/$defs/end";
+                };
+                readonly to: {
+                    readonly $ref: "#/$defs/end";
+                };
+                readonly stroke: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly color: {
+                            readonly type: "string";
+                        };
+                        readonly width: {
+                            readonly type: "number";
+                        };
+                        readonly marker: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly start: {
+                                    readonly type: "boolean";
+                                };
+                                readonly end: {
+                                    readonly type: "boolean";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            readonly required: readonly ["id", "from", "to"];
+            readonly additionalProperties: true;
+        };
+        readonly $defs: {
+            readonly end: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: readonly ["integer", "string"];
+                    };
+                    readonly position: {
+                        readonly type: "number";
+                    };
+                };
+                readonly required: readonly ["id"];
+            };
+        };
+    };
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCf,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCf,CAAC;AAEX,qBAAqB;AACrB,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGV,CAAC"}

package/dist/schema.js

@@ -0,0 +1,94 @@
+// d3.deployment の入力データの JSON Schema(2020-12)。
+//
+// iHub の server/schemas/deployment/{nodes,edges}.schema.json を移したもの。
+// 検査するのは、図の構造にかかわる項目(id・type・size・position・children・link、線の from / to)だけで、
+// 見た目の項目(label・border・background・padding・description)は d3.deployment の入力の形のまま書けるよう
+// additionalProperties を閉じていない(iHub 版は閉じていた)。
+//
+// x-id-start はスキーマの検証には使わない注釈(コレクションが空のときに最初に振る id)。
+// Ajv で使うときは addKeyword({ keyword: 'x-id-start', schemaType: 'number' }) を足す。
+import { NODE_TYPES } from './defaults.js';
+const ID = { type: ['integer', 'string'] };
+const POINT = {
+    type: 'object',
+    properties: { x: { type: 'number' }, y: { type: 'number' } },
+    required: ['x', 'y'],
+};
+export const NODES_SCHEMA = {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    title: 'システム構成図のノード',
+    description: 'd3.deployment に渡すノード。children に子のノードを入れ子で持つ。id は子のノードも含めて一意にする。position は親の中での位置で、ドラッグで動かすと書き換わる。link を付けると、ノードの左下にリンクを出す。見た目の項目 (label・padding・border・background・description) は d3.deployment の入力の形のまま書ける。',
+    'x-id-start': 1,
+    type: 'array',
+    items: { $ref: '#/$defs/node' },
+    $defs: {
+        node: {
+            type: 'object',
+            properties: {
+                id: ID,
+                type: { enum: [...NODE_TYPES] },
+                label: {
+                    type: 'object',
+                    properties: { text: { type: ['string', 'null'] } },
+                },
+                description: { type: ['string', 'null'] },
+                size: {
+                    type: 'object',
+                    properties: { w: { type: 'number', minimum: 0 }, h: { type: 'number', minimum: 0 } },
+                    required: ['w', 'h'],
+                },
+                position: POINT,
+                link: {
+                    type: ['object', 'null'],
+                    properties: { url: { type: ['string', 'null'] } },
+                },
+                children: { type: 'array', items: { $ref: '#/$defs/node' } },
+            },
+            required: ['id'],
+            additionalProperties: true,
+        },
+    },
+};
+export const EDGES_SCHEMA = {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    title: 'システム構成図の線',
+    description: 'ノードの間の線。from.id / to.id はノード (子を含む) の id。position は接続位置の角度 (0=真下・時計回り。省略すると 90=左)。stroke.marker は両端の矢印の有無 (既定: 終点だけ)。',
+    'x-id-start': 100,
+    type: 'array',
+    items: {
+        type: 'object',
+        properties: {
+            id: ID,
+            from: { $ref: '#/$defs/end' },
+            to: { $ref: '#/$defs/end' },
+            stroke: {
+                type: 'object',
+                properties: {
+                    color: { type: 'string' },
+                    width: { type: 'number' },
+                    marker: {
+                        type: 'object',
+                        properties: { start: { type: 'boolean' }, end: { type: 'boolean' } },
+                    },
+                },
+            },
+        },
+        required: ['id', 'from', 'to'],
+        additionalProperties: true,
+    },
+    $defs: {
+        end: {
+            type: 'object',
+            properties: {
+                id: ID,
+                position: { type: 'number' },
+            },
+            required: ['id'],
+        },
+    },
+};
+/** コレクション名 → スキーマ */
+export const SCHEMAS = {
+    nodes: NODES_SCHEMA,
+    edges: EDGES_SCHEMA,
+};