@yanqirenshi/model.deployment 0.0.0-stage → 0.1.1

package/src/defaults.ts

@@ -0,0 +1,138 @@
+// d3.deployment が「書いていない項目」に既定で描く値。
+//
+// 値の出どころは、d3.deployment の datamodels/Node.js が使う共通基盤 assh0le のデータクラス
+// (Stroke.template = 枠線、Background.template = 背景、Label.template = ラベル、Padding / Position.template)と、
+// datamodels/Edge.js の dataTemplate(stroke と矢印)、Geometry.getPortLineTo(角度の既定 90)。
+// d3.deployment はこのファイルを読む(#146)ので、ここが正。
+//
+// d3.deployment は border.type を正規化するが描画には使わない(dasharray を付けない)ので、モデルも項目にしない。
+
+import type { Background, Border, Font, Position } from '@yanqirenshi/types';
+import type { DeploymentEdgeRecord, DeploymentNodeRecord, DeploymentNodeType, DeploymentRecord } from './types.js';
+
+/** ノードの種類 */
+export const NODE_TYPES: readonly DeploymentNodeType[] = ['NODE', 'COMPONENT'];
+
+/** ノードの枠線・背景の既定(assh0le の Stroke.template / Background.template) */
+export const NODE_STYLE_DEFAULTS = {
+  border:     { color: '#afafb0', width: 1, type: 'solid' } as Required<Pick<Border, 'color' | 'width' | 'type'>>,
+  background: { color: '#fff', opacity: 1.0 } as Required<Pick<Background, 'color' | 'opacity'>>,
+} as const;
+
+/**
+ * ラベルの既定(assh0le の Label.template)。text が無いとき d3.deployment は '????????' を描く
+ * (withDefaults では '' を入れる — 「書いていない」ことをインスペクタで見せるため)。
+ */
+export const LABEL_DEFAULTS = {
+  placeholder: '????????',
+  position: { x: 0, y: 0 } as Position,
+  font: { size: 16, color: '#333333' } as Font,
+} as const;
+
+/** ノードの既定(Padding / Position.template)。size の 0 は「子に合わせる」 */
+export const NODE_DEFAULTS = {
+  type: 'NODE' as DeploymentNodeType,
+  padding: 0,
+  position: { x: 0, y: 0 } as Position,
+} as const;
+
+/** 線の見た目(色・太さ・両端の矢印の有無) */
+export interface DeploymentEdgeStyle {
+  color: string;
+  width: number;
+  marker: { start: boolean; end: boolean };
+}
+
+/** 線の既定(Edge.dataTemplate の stroke、端点の角度は Geometry.getPortLineTo の 90=左) */
+export const EDGE_DEFAULTS = {
+  stroke: {
+    color: '#333',
+    width: 1.5,
+    marker: { start: false, end: true },
+  } as DeploymentEdgeStyle,
+  position: 90,
+} as const;
+
+/** 線か(from と to を持つ)。ノードは持たない */
+export function isEdge(record: DeploymentRecord | null | undefined): record is DeploymentEdgeRecord {
+  return !!(record && (record as DeploymentEdgeRecord).from && (record as DeploymentEdgeRecord).to);
+}
+
+/** 既定に入力の指定(truthy な項目だけ。assh0le の Stroke.build / Background.build と同じ判定)を重ねる */
+function mergeStyle<T extends object>(defaults: T, given: Partial<T> | null | undefined): T {
+  const out: T = { ...defaults };
+
+  for (const key of Object.keys(given || {}) as (keyof T)[]) {
+    const v = (given as T)[key];
+
+    if (v)
+      out[key] = v;
+  }
+
+  return out;
+}
+
+/** ノードが描かれる枠線・背景(既定に入力を重ねた、実際に描かれる値) */
+export function nodeStyle(node: DeploymentNodeRecord): typeof NODE_STYLE_DEFAULTS {
+  return {
+    border:     mergeStyle(NODE_STYLE_DEFAULTS.border,     node.border as Partial<typeof NODE_STYLE_DEFAULTS.border>),
+    background: mergeStyle(NODE_STYLE_DEFAULTS.background, node.background as Partial<typeof NODE_STYLE_DEFAULTS.background>),
+  };
+}
+
+/**
+ * 線が描かれる値(Edge.normalize と同じ: stroke の color / width / marker はそれぞれ truthy ならそれ)。
+ * marker は入力があれば丸ごと置き換わる(片方だけ書くと、もう片方は偽)。
+ * d3.deployment のペインタが描くのは終点の矢印(marker.end)だけで、start は描かない。
+ */
+export function edgeStyle(edge: DeploymentEdgeRecord): { stroke: DeploymentEdgeStyle } {
+  return {
+    stroke: {
+      color: edge.stroke?.color || EDGE_DEFAULTS.stroke.color,
+      width: edge.stroke?.width || EDGE_DEFAULTS.stroke.width,
+      marker: edge.stroke?.marker
+        ? { start: !!edge.stroke.marker.start, end: !!edge.stroke.marker.end }
+        : { ...EDGE_DEFAULTS.stroke.marker },
+    },
+  };
+}
+
+/** 端点の角度(無ければ 90。Geometry.getPortLineTo と同じ: 0 は 0、それ以外の falsy は 90) */
+export function degreeOf(position: number | undefined | null): number {
+  if (position === 0)
+    return 0;
+
+  return position ? position : EDGE_DEFAULTS.position;
+}
+
+/**
+ * レコードに、d3.deployment が既定で描いている値を重ねて返す(入力は書き換えない)。
+ * インスペクタの初期値に使う。children は重ねない(子は右クリックしたときに自分で通す)。
+ *
+ * 重ねる項目: ノードは type・padding・position・label.text(無ければ '')・border・background、
+ * 線は stroke(矢印を含む)・from.position・to.position。size は view が子に合わせて埋めるので触らない。
+ */
+export function withDefaults<T extends DeploymentRecord>(record: T): T {
+  if (isEdge(record)) {
+    return {
+      ...record,
+      ...edgeStyle(record),
+      from: { ...record.from, position: degreeOf(record.from.position) },
+      to: { ...record.to, position: degreeOf(record.to.position) },
+    } as T;
+  }
+
+  const node = record as DeploymentNodeRecord;
+  const style = nodeStyle(node);
+  const label = node.label && typeof node.label === 'object' ? node.label : {};
+
+  return {
+    ...node,
+    type: node.type || NODE_DEFAULTS.type,
+    label: { ...label, text: typeof label.text === 'string' ? label.text : '' },
+    padding: node.padding || node.padding === 0 ? node.padding : NODE_DEFAULTS.padding,
+    position: { ...NODE_DEFAULTS.position, ...(node.position || {}) },
+    border: style.border,
+    background: style.background,
+  } as T;
+}

package/src/fields.ts

@@ -0,0 +1,46 @@
+// 編集できる項目の一覧。インスペクタ(colonoscope の ModelInspector)に渡す。
+//
+// path はレコードの実際の項目を指す。既定値は withDefaults() で重ねてから渡すので、
+// 書いていない項目(枠線の色など)も、図に描かれている値が初期値として出る。
+// type: 'readonly' は表示だけ。options は取りうる値の一覧(検証にも使う)。
+//
+// iHub の SystemConfigurationDiagram.js の fields(label.text / type / id)から始め、
+// d3.deployment が描く説明(ツールチップ)・リンク・幅・高さ・背景色・枠線の色 / 太さ、線の矢印を足した。
+// border.type は d3.deployment が描かないので出さない。
+
+import { NODE_TYPES, isEdge } from './defaults.js';
+import type { DeploymentField, DeploymentRecord } from './types.js';
+
+const BOOLEAN_OPTIONS = ['true', 'false'];
+
+/** ノードの項目 */
+export const NODE_FIELDS: readonly DeploymentField[] = [
+  { path: 'label.text',       label: '名称',       type: 'text' },
+  { path: 'type',             label: '種類',       type: 'text', options: NODE_TYPES },
+  { path: 'id',               label: 'ID',         type: 'readonly' },
+  { path: 'description',      label: '説明',       type: 'textarea' },
+  { path: 'link.url',         label: 'URL',        type: 'text' },
+  { path: 'size.w',           label: '幅',         type: 'number' },
+  { path: 'size.h',           label: '高さ',       type: 'number' },
+  { path: 'background.color', label: '背景色',     type: 'text' },
+  { path: 'border.color',     label: '枠線の色',   type: 'text' },
+  { path: 'border.width',     label: '枠線の太さ', type: 'number' },
+];
+
+/** 線の項目。接続位置はノードの中心から見た角度(0=真下・時計回り。90=左 / 180=真上 / 270=右) */
+export const EDGE_FIELDS: readonly DeploymentField[] = [
+  { path: 'id',                  label: 'ID',                 type: 'readonly' },
+  { path: 'from.id',             label: '接続元のノード',     type: 'readonly' },
+  { path: 'from.position',       label: '接続元の位置 (角度)', type: 'number' },
+  { path: 'to.id',               label: '接続先のノード',     type: 'readonly' },
+  { path: 'to.position',         label: '接続先の位置 (角度)', type: 'number' },
+  { path: 'stroke.color',        label: '線の色',             type: 'text' },
+  { path: 'stroke.width',        label: '線の太さ',           type: 'number' },
+  // 始点の矢印(marker.start)は d3.deployment のペインタが描かないので項目にしない
+  { path: 'stroke.marker.end',   label: '終点の矢印',         type: 'text', options: BOOLEAN_OPTIONS },
+];
+
+/** レコードに応じた項目の一覧(線 / ノード) */
+export function fieldsOf(record: DeploymentRecord): DeploymentField[] {
+  return isEdge(record) ? [...EDGE_FIELDS] : [...NODE_FIELDS];
+}

package/src/index.ts

@@ -0,0 +1,28 @@
+// model.deployment — システム構成図(デプロイメント図。d3.deployment)の「図ごとの知識」。描画はしない(react / d3 に依存しない)。
+//
+//   スキーマ:        SCHEMAS / NODES_SCHEMA / EDGES_SCHEMA(JSON Schema 2020-12)
+//   整合性ルール:    check(data)(id の重複・参照先の存在)/ flatten / findById
+//   既定値の補完:    withDefaults(record) / nodeStyle / edgeStyle / degreeOf
+//                    NODE_TYPES / NODE_STYLE_DEFAULTS / LABEL_DEFAULTS / NODE_DEFAULTS / EDGE_DEFAULTS(d3.deployment が読む)
+//   編集できる項目:  fieldsOf(record) / NODE_FIELDS / EDGE_FIELDS
+//   patch への変換:  movePatch(node, move) / applyPatch(record, values) / mergePatch(record, patch)
+//
+// graph 系(unchi / sitemap / deployment)の 3 つ目。check / flatten / findById / movePatch / mergePatch / getByPath / isColor と
+// 入力の読み取り部品は model.core(#151)のもので、ここでは model.deployment の型を付けて公開している。
+
+export type {
+  DeploymentId, DeploymentNodeType, DeploymentNodeLabel, DeploymentNodeRecord, DeploymentEdgeEnd, DeploymentEdgeStroke,
+  DeploymentEdgeRecord, DeploymentRecord, DeploymentGraph, DeploymentCollection, MergePatch, DeploymentChange,
+  DeploymentMove, DeploymentFieldType, DeploymentField, DeploymentValues,
+} from './types.js';
+
+export {
+  NODE_TYPES, NODE_STYLE_DEFAULTS, LABEL_DEFAULTS, NODE_DEFAULTS, EDGE_DEFAULTS,
+  isEdge, nodeStyle, edgeStyle, degreeOf, withDefaults,
+} from './defaults.js';
+
+export type { DeploymentEdgeStyle } from './defaults.js';
+export { NODES_SCHEMA, EDGES_SCHEMA, SCHEMAS } from './schema.js';
+export { check, flatten, findById } from './check.js';
+export { NODE_FIELDS, EDGE_FIELDS, fieldsOf } from './fields.js';
+export { ModelError, collectionOf, titleOf, getByPath, mergePatch, movePatch, applyPatch, isColor } from './patch.js';

package/src/patch.ts

@@ -0,0 +1,158 @@
+// UI の操作(ドラッグ・インスペクタの適用)を、保存する patch(JSON Merge Patch)に変換する。
+//
+// 戻り値は { collection, id, patch }。利用側(iHub など)は図の種類を知らずにこれを保存すればよい。
+// 入力の検証に失敗したときは ModelError を投げる(メッセージは利用者にそのまま見せられる日本語)。
+// model.sitemap の patch.ts を元にしている(ラベルは label.text、種類は NODE / COMPONENT、線に矢印の有無がある)。
+// 読み取り部品(toColor など)と patch の道具は model.core にある(#151)。
+
+import {
+  ModelError, changedValues as changedValuesOf, movePatch as movePatchTo, put,
+  toBoolean, toColor, toDegree, toLength, toOption, toOptionalText, toWidth,
+} from '@yanqirenshi/model.core';
+
+import { NODE_TYPES, isEdge, withDefaults } from './defaults.js';
+import { fieldsOf } from './fields.js';
+import type {
+  MergePatch, DeploymentChange, DeploymentCollection, DeploymentEdgeRecord, DeploymentMove, DeploymentNodeRecord,
+  DeploymentRecord, DeploymentValues,
+} from './types.js';
+
+// model.core のものをそのまま公開する(利用側が model.deployment だけを読めばよいように)
+export { ModelError, getByPath, mergePatch, isColor } from '@yanqirenshi/model.core';
+
+/** レコードを置くコレクション */
+export function collectionOf(record: DeploymentRecord): DeploymentCollection {
+  return isEdge(record) ? 'edges' : 'nodes';
+}
+
+/** インスペクタの見出し。ラベルの文字、無ければ「種類 id」(線は「接続元 → 接続先」) */
+export function titleOf(record: DeploymentRecord): string {
+  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();
+}
+
+/**
+ * ドラッグで動かしたノードの位置を保存する patch。
+ * 保存してある position に移動量を足し、整数に丸める(position が無いときは 0, 0 から)。
+ * 子のノード(COMPONENT を含む)の position は親の中での位置なので、親を動かしても子の patch は要らない。
+ */
+export function movePatch(node: DeploymentNodeRecord, move: DeploymentMove): DeploymentChange {
+  return movePatchTo(node, move, 'nodes');
+}
+
+// インスペクタの入力のうち、図に描いている値(withDefaults)から変わった項目だけ
+function changedValues(record: DeploymentRecord, values: DeploymentValues): Map<string, string> {
+  return changedValuesOf(withDefaults(record), values, fieldsOf(record));
+}
+
+// 幅・高さは 0 以上(0 は「子に合わせる」)。
+// 枠線・線の太さは 0 より大きい数(d3.deployment は 0 を「書いていない」と見て既定に倒すので、0 は入れられない)
+const LENGTH = { hint: '(0 で子に合わせる)' };
+
+// ノードの入力 → patch(label.text / type / description / link.url / size / background / border)
+function nodePatch(node: DeploymentNodeRecord, values: DeploymentValues): MergePatch {
+  const patch: MergePatch = {};
+
+  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, '幅', LENGTH));
+        break;
+      case 'size.h':
+        put(patch, path, toLength(value, '高さ', LENGTH));
+        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: Record<string, string> = { from: '接続元', to: '接続先' };
+
+// 線の入力 → patch(from / to の角度・stroke・矢印)
+function edgePatch(edge: DeploymentEdgeRecord, values: DeploymentValues): MergePatch {
+  const patch: MergePatch = {};
+
+  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 as MergePatch | undefined)?.marker as MergePatch | undefined;
+
+  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: DeploymentRecord, values: DeploymentValues): DeploymentChange {
+  return {
+    collection: collectionOf(record),
+    id: record.id,
+    patch: isEdge(record) ? edgePatch(record, values) : nodePatch(record as DeploymentNodeRecord, values),
+  };
+}

package/src/schema.ts

@@ -0,0 +1,100 @@
+// 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'] } as const;
+
+const POINT = {
+  type: 'object',
+  properties: { x: { type: 'number' }, y: { type: 'number' } },
+  required: ['x', 'y'],
+} as const;
+
+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,
+    },
+  },
+} as const;
+
+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'],
+    },
+  },
+} as const;
+
+/** コレクション名 → スキーマ */
+export const SCHEMAS = {
+  nodes: NODES_SCHEMA,
+  edges: EDGES_SCHEMA,
+} as const;

package/src/types.ts

@@ -0,0 +1,94 @@
+// model.deployment の公開型。
+//
+// ここで言う「レコード」は、d3.deployment の data() に渡す入力そのもの({ nodes, edges })の 1 要素。
+// iHub では data/deployment/{nodes,edges}.json の 1 要素。d3.deployment が正規化したあとの datum(_id / _core / _position を持つもの)ではない。
+// ノードと線の図なので model.unchi / model.sitemap と形が近い。ラベルは label.text(unchi と同じ。sitemap は label.contents)。
+
+import type { MergePatch, ModelField, ModelFieldType, ModelMove, ModelValues } from '@yanqirenshi/model.core';
+import type { Background, Border, Font, Position, Size, Stroke } from '@yanqirenshi/types';
+
+/** レコードの id(nodes / edges とも。ノードは子も含めて一意) */
+export type DeploymentId = number | string;
+
+/** ノードの種類。NODE(通常のノード)か COMPONENT */
+export type DeploymentNodeType = 'NODE' | 'COMPONENT';
+
+/** ノードのラベル */
+export interface DeploymentNodeLabel {
+  text?: string | null;
+  position?: Position;
+  font?: Font;
+}
+
+/** ノードのレコード(入れ子可)。ライブラリが解釈しない項目も持てる(index signature) */
+export interface DeploymentNodeRecord {
+  id: DeploymentId;
+  type?: DeploymentNodeType | string;
+  label?: DeploymentNodeLabel | null;
+  /** ホバーのツールチップ(SVG title) */
+  description?: string | null;
+  size?: Size;
+  position?: Position;
+  padding?: number;
+  border?: Border;
+  background?: Background;
+  /** ノードの左下に出すリンク */
+  link?: { url?: string | null; [key: string]: unknown } | null;
+  children?: DeploymentNodeRecord[];
+  [key: string]: unknown;
+}
+
+/** 線の端点。position はノードの中心から見た角度(0=真下・時計回り。90=左 / 180=真上 / 270=右) */
+export interface DeploymentEdgeEnd {
+  id: DeploymentId;
+  position?: number;
+}
+
+/** 線の見た目。marker は両端の矢印の有無 */
+export interface DeploymentEdgeStroke extends Stroke {
+  marker?: { start?: boolean; end?: boolean };
+}
+
+/** 線のレコード */
+export interface DeploymentEdgeRecord {
+  id: DeploymentId;
+  from: DeploymentEdgeEnd;
+  to: DeploymentEdgeEnd;
+  stroke?: DeploymentEdgeStroke;
+  [key: string]: unknown;
+}
+
+export type DeploymentRecord = DeploymentNodeRecord | DeploymentEdgeRecord;
+
+/** 図全体(d3.deployment の data() に渡すもの) */
+export interface DeploymentGraph {
+  nodes?: DeploymentNodeRecord[];
+  edges?: DeploymentEdgeRecord[];
+}
+
+/** レコードを置くコレクション */
+export type DeploymentCollection = 'nodes' | 'edges';
+
+/** JSON Merge Patch(RFC 7386)。null は「その項目を除く」。model.core の MergePatch と同じ(iHub の PATCH /{collection}/{id} が受け取る形) */
+export type { MergePatch };
+
+/** 保存する変更。利用側は図の種類を知らずにこれを保存すればよい */
+export interface DeploymentChange {
+  collection: DeploymentCollection;
+  id: DeploymentId;
+  patch: MergePatch;
+}
+
+/** ドラッグの移動量(世界座標。d3.deployment の callbacks.node.dragend が渡す move と同じ) */
+export type DeploymentMove = ModelMove;
+
+/**
+ * 編集できる項目。colonoscope の ColonoscopeField(path / label / type)と同じ形で、
+ * 取りうる値の一覧 options だけ足している(型は構造的に互換。colonoscope には依存しない)。
+ */
+export type DeploymentFieldType = ModelFieldType;
+
+export type DeploymentField = ModelField;
+
+/** インスペクタの「適用」が渡す値(path → 入力した文字列) */
+export type DeploymentValues = ModelValues;