@yanqirenshi/model.deployment 0.0.0-stage → 0.1.0

package/dist/cjs/patch.js

@@ -0,0 +1,262 @@
+"use strict";
+// UI の操作(ドラッグ・インスペクタの適用)を、保存する patch(JSON Merge Patch)に変換する。
+//
+// 戻り値は { collection, id, patch }。利用側(iHub など)は図の種類を知らずにこれを保存すればよい。
+// 入力の検証に失敗したときは ModelError を投げる(メッセージは利用者にそのまま見せられる日本語)。
+// model.sitemap の patch.ts を元にしている(ラベルは label.text、種類は NODE / COMPONENT、線に矢印の有無がある)。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelError = void 0;
+exports.collectionOf = collectionOf;
+exports.titleOf = titleOf;
+exports.getByPath = getByPath;
+exports.mergePatch = mergePatch;
+exports.movePatch = movePatch;
+exports.isColor = isColor;
+exports.applyPatch = applyPatch;
+const defaults_js_1 = require("./defaults.js");
+const fields_js_1 = require("./fields.js");
+/** 入力の検証エラー。message は利用者向け */
+class ModelError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ModelError';
+    }
+}
+exports.ModelError = ModelError;
+/** レコードを置くコレクション */
+function collectionOf(record) {
+    return (0, defaults_js_1.isEdge)(record) ? 'edges' : 'nodes';
+}
+/** インスペクタの見出し。ラベルの文字、無ければ「種類 id」(線は「接続元 → 接続先」) */
+function titleOf(record) {
+    if ((0, defaults_js_1.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 で値を取り出す */
+function getByPath(obj, path) {
+    return path.split('.').reduce((acc, key) => (acc == null ? acc : acc[key]), obj);
+}
+/**
+ * JSON Merge Patch をレコードに重ねたものを返す(入力は書き換えない)。
+ * null の項目は除く。保存したあと、表示を先に更新するときに使う。
+ */
+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 は要らない。
+ */
+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() などの関数表記・英字だけの色名、を通す緩い判定にする。
+ */
+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 = (0, defaults_js_1.withDefaults)(record);
+    const out = new Map();
+    for (const field of (0, fields_js_1.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, defaults_js_1.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 = (0, defaults_js_1.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 は {}。
+ */
+function applyPatch(record, values) {
+    return {
+        collection: collectionOf(record),
+        id: record.id,
+        patch: (0, defaults_js_1.isEdge)(record) ? edgePatch(record, values) : nodePatch(record, values),
+    };
+}

package/dist/cjs/schema.js

@@ -0,0 +1,97 @@
+"use strict";
+// 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' }) を足す。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEMAS = exports.EDGES_SCHEMA = exports.NODES_SCHEMA = void 0;
+const defaults_js_1 = require("./defaults.js");
+const ID = { type: ['integer', 'string'] };
+const POINT = {
+    type: 'object',
+    properties: { x: { type: 'number' }, y: { type: 'number' } },
+    required: ['x', 'y'],
+};
+exports.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: [...defaults_js_1.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,
+        },
+    },
+};
+exports.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'],
+        },
+    },
+};
+/** コレクション名 → スキーマ */
+exports.SCHEMAS = {
+    nodes: exports.NODES_SCHEMA,
+    edges: exports.EDGES_SCHEMA,
+};

package/dist/cjs/types.js

@@ -0,0 +1,7 @@
+"use strict";
+// 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)。
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/defaults.d.ts

@@ -0,0 +1,61 @@
+import type { Background, Border, Font, Position } from '@yanqirenshi/types';
+import type { DeploymentEdgeRecord, DeploymentNodeRecord, DeploymentNodeType, DeploymentRecord } from './types.js';
+/** ノードの種類 */
+export declare const NODE_TYPES: readonly DeploymentNodeType[];
+/** ノードの枠線・背景の既定(assh0le の Stroke.template / Background.template) */
+export declare const NODE_STYLE_DEFAULTS: {
+    readonly border: Required<Pick<Border, "color" | "width" | "type">>;
+    readonly background: Required<Pick<Background, "color" | "opacity">>;
+};
+/**
+ * ラベルの既定(assh0le の Label.template)。text が無いとき d3.deployment は '????????' を描く
+ * (withDefaults では '' を入れる — 「書いていない」ことをインスペクタで見せるため)。
+ */
+export declare const LABEL_DEFAULTS: {
+    readonly placeholder: "????????";
+    readonly position: Position;
+    readonly font: Font;
+};
+/** ノードの既定(Padding / Position.template)。size の 0 は「子に合わせる」 */
+export declare const NODE_DEFAULTS: {
+    readonly type: DeploymentNodeType;
+    readonly padding: 0;
+    readonly position: Position;
+};
+/** 線の見た目(色・太さ・両端の矢印の有無) */
+export interface DeploymentEdgeStyle {
+    color: string;
+    width: number;
+    marker: {
+        start: boolean;
+        end: boolean;
+    };
+}
+/** 線の既定(Edge.dataTemplate の stroke、端点の角度は Geometry.getPortLineTo の 90=左) */
+export declare const EDGE_DEFAULTS: {
+    readonly stroke: DeploymentEdgeStyle;
+    readonly position: 90;
+};
+/** 線か(from と to を持つ)。ノードは持たない */
+export declare function isEdge(record: DeploymentRecord | null | undefined): record is DeploymentEdgeRecord;
+/** ノードが描かれる枠線・背景(既定に入力を重ねた、実際に描かれる値) */
+export declare function nodeStyle(node: DeploymentNodeRecord): typeof NODE_STYLE_DEFAULTS;
+/**
+ * 線が描かれる値(Edge.normalize と同じ: stroke の color / width / marker はそれぞれ truthy ならそれ)。
+ * marker は入力があれば丸ごと置き換わる(片方だけ書くと、もう片方は偽)。
+ * d3.deployment のペインタが描くのは終点の矢印(marker.end)だけで、start は描かない。
+ */
+export declare function edgeStyle(edge: DeploymentEdgeRecord): {
+    stroke: DeploymentEdgeStyle;
+};
+/** 端点の角度(無ければ 90。Geometry.getPortLineTo と同じ: 0 は 0、それ以外の falsy は 90) */
+export declare function degreeOf(position: number | undefined | null): number;
+/**
+ * レコードに、d3.deployment が既定で描いている値を重ねて返す(入力は書き換えない)。
+ * インスペクタの初期値に使う。children は重ねない(子は右クリックしたときに自分で通す)。
+ *
+ * 重ねる項目: ノードは type・padding・position・label.text(無ければ '')・border・background、
+ * 線は stroke(矢印を含む)・from.position・to.position。size は view が子に合わせて埋めるので触らない。
+ */
+export declare function withDefaults<T extends DeploymentRecord>(record: T): T;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnH,aAAa;AACb,eAAO,MAAM,UAAU,EAAE,SAAS,kBAAkB,EAA0B,CAAC;AAE/E,oEAAoE;AACpE,eAAO,MAAM,mBAAmB;qBAC+B,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;yBAChE,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;CACtF,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,cAAc;;uBAEG,QAAQ;mBACI,IAAI;CACpC,CAAC;AAEX,6DAA6D;AAC7D,eAAO,MAAM,aAAa;mBACR,kBAAkB;;uBAEN,QAAQ;CAC5B,CAAC;AAEX,2BAA2B;AAC3B,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1C;AAED,4EAA4E;AAC5E,eAAO,MAAM,aAAa;qBAKnB,mBAAmB;;CAEhB,CAAC;AAEX,iCAAiC;AACjC,wBAAgB,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,IAAI,oBAAoB,CAElG;AAgBD,wCAAwC;AACxC,wBAAgB,SAAS,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,mBAAmB,CAKhF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,oBAAoB,GAAG;IAAE,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAUrF;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAKpE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,gBAAgB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAuBrE"}

package/dist/defaults.js

@@ -0,0 +1,111 @@
+// 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 を付けない)ので、モデルも項目にしない。
+/** ノードの種類 */
+export const NODE_TYPES = ['NODE', 'COMPONENT'];
+/** ノードの枠線・背景の既定(assh0le の Stroke.template / Background.template) */
+export const NODE_STYLE_DEFAULTS = {
+    border: { color: '#afafb0', width: 1, type: 'solid' },
+    background: { color: '#fff', opacity: 1.0 },
+};
+/**
+ * ラベルの既定(assh0le の Label.template)。text が無いとき d3.deployment は '????????' を描く
+ * (withDefaults では '' を入れる — 「書いていない」ことをインスペクタで見せるため)。
+ */
+export const LABEL_DEFAULTS = {
+    placeholder: '????????',
+    position: { x: 0, y: 0 },
+    font: { size: 16, color: '#333333' },
+};
+/** ノードの既定(Padding / Position.template)。size の 0 は「子に合わせる」 */
+export const NODE_DEFAULTS = {
+    type: 'NODE',
+    padding: 0,
+    position: { x: 0, y: 0 },
+};
+/** 線の既定(Edge.dataTemplate の stroke、端点の角度は Geometry.getPortLineTo の 90=左) */
+export const EDGE_DEFAULTS = {
+    stroke: {
+        color: '#333',
+        width: 1.5,
+        marker: { start: false, end: true },
+    },
+    position: 90,
+};
+/** 線か(from と to を持つ)。ノードは持たない */
+export function isEdge(record) {
+    return !!(record && record.from && record.to);
+}
+/** 既定に入力の指定(truthy な項目だけ。assh0le の Stroke.build / Background.build と同じ判定)を重ねる */
+function mergeStyle(defaults, given) {
+    const out = { ...defaults };
+    for (const key of Object.keys(given || {})) {
+        const v = given[key];
+        if (v)
+            out[key] = v;
+    }
+    return out;
+}
+/** ノードが描かれる枠線・背景(既定に入力を重ねた、実際に描かれる値) */
+export function nodeStyle(node) {
+    return {
+        border: mergeStyle(NODE_STYLE_DEFAULTS.border, node.border),
+        background: mergeStyle(NODE_STYLE_DEFAULTS.background, node.background),
+    };
+}
+/**
+ * 線が描かれる値(Edge.normalize と同じ: stroke の color / width / marker はそれぞれ truthy ならそれ)。
+ * marker は入力があれば丸ごと置き換わる(片方だけ書くと、もう片方は偽)。
+ * d3.deployment のペインタが描くのは終点の矢印(marker.end)だけで、start は描かない。
+ */
+export function edgeStyle(edge) {
+    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) {
+    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(record) {
+    if (isEdge(record)) {
+        return {
+            ...record,
+            ...edgeStyle(record),
+            from: { ...record.from, position: degreeOf(record.from.position) },
+            to: { ...record.to, position: degreeOf(record.to.position) },
+        };
+    }
+    const node = record;
+    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,
+    };
+}

package/dist/fields.d.ts

@@ -0,0 +1,8 @@
+import type { DeploymentField, DeploymentRecord } from './types.js';
+/** ノードの項目 */
+export declare const NODE_FIELDS: readonly DeploymentField[];
+/** 線の項目。接続位置はノードの中心から見た角度(0=真下・時計回り。90=左 / 180=真上 / 270=右) */
+export declare const EDGE_FIELDS: readonly DeploymentField[];
+/** レコードに応じた項目の一覧(線 / ノード) */
+export declare function fieldsOf(record: DeploymentRecord): DeploymentField[];
+//# sourceMappingURL=fields.d.ts.map

package/dist/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAIpE,aAAa;AACb,eAAO,MAAM,WAAW,EAAE,SAAS,eAAe,EAWjD,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,WAAW,EAAE,SAAS,eAAe,EAUjD,CAAC;AAEF,6BAA6B;AAC7B,wBAAgB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,eAAe,EAAE,CAEpE"}

package/dist/fields.js

@@ -0,0 +1,40 @@
+// 編集できる項目の一覧。インスペクタ(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';
+const BOOLEAN_OPTIONS = ['true', 'false'];
+/** ノードの項目 */
+export const NODE_FIELDS = [
+    { 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 = [
+    { 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) {
+    return isEdge(record) ? [...EDGE_FIELDS] : [...NODE_FIELDS];
+}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+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';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,YAAY,EACV,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,oBAAoB,EACpH,oBAAoB,EAAE,gBAAgB,EAAE,eAAe,EAAE,oBAAoB,EAAE,UAAU,EAAE,gBAAgB,EAC3G,cAAc,EAAE,mBAAmB,EAAE,eAAe,EAAE,gBAAgB,GACvE,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,UAAU,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAC7E,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GACrD,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+// 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 / movePatch / mergePatch / getByPath / isColor は
+// model.unchi / model.sitemap と同じ内容の複製で、共通化は別 issue で判断する(#146 の 7)。
+export { NODE_TYPES, NODE_STYLE_DEFAULTS, LABEL_DEFAULTS, NODE_DEFAULTS, EDGE_DEFAULTS, isEdge, nodeStyle, edgeStyle, degreeOf, withDefaults, } 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';