@yanqirenshi/model.deployment 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018-2026 Satoshi Iwasaki (yanqirenshi@gmail.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,131 @@
-# Temporary Holding Version
+# @yanqirenshi/model.deployment
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+システム構成図(デプロイメント図。view = `d3.deployment`)の**図ごとの知識**を、描画から独立させたパッケージです。
+react / d3 に依存しない、純粋なデータと関数だけを持ちます。
+d3.deployment は、このパッケージの既定値(枠線・背景・線の stroke と矢印・端点の角度)を読みます。
+
+| 持つもの | 入口 |
+|---|---|
+| 入力データのスキーマ(JSON Schema 2020-12) | `SCHEMAS.nodes` / `SCHEMAS.edges` |
+| コレクションをまたぐ整合性ルール(id の重複・参照先の存在) | `check(data)` |
+| d3.deployment が既定で描いている値 | `withDefaults(record)` / `nodeStyle` / `edgeStyle`、`NODE_STYLE_DEFAULTS` など |
+| 編集できる項目の一覧(インスペクタ用) | `fieldsOf(record)` |
+| UI の操作を保存する patch に変える変換 | `movePatch(node, move)` / `applyPatch(record, values)` |
+
+利用側(iHub など)は、モデルが返す `{ collection, id, patch }` を保存するだけで、図の種類を知らずに書けます。
+
+## 位置づけ
+
+```
+利用側 ──▶ d3.deployment (view) ──▶ model.deployment   (既定値を読む)
+     ──▶ colonoscope (ModelInspector)
+     ──▶ model.deployment
+     ──▶ 自前の永続化
+```
+
+model.deployment・colonoscope の間に横の依存はありません。組み合わせるのは利用側だけです。
+これは [Foolsgolds/Assholes#138](https://github.com/Foolsgolds/Assholes/issues/138) の派生([#146](https://github.com/Foolsgolds/Assholes/issues/146))で、
+ノードと線の図(graph 系: [model.unchi](../model.unchi) / [model.sitemap](../model.sitemap) / model.deployment)の 3 つ目です。
+`check` / `movePatch` / `mergePatch` と入力の読み取り部品は共通部品 [model.core](../model.core) のものに
+model.deployment の型を付けて公開しています([#151](https://github.com/Foolsgolds/Assholes/issues/151))。
+
+## レコードの形
+
+d3.deployment の `data()` に渡す入力そのもの(`nodes` / `edges` の 1 要素)です。
+
+```js
+{
+  nodes: [{ id, type: 'NODE' | 'COMPONENT', label: { text, position, font }, description,
+            size: { w, h }, position: { x, y }, padding, border, background, link: { url },
+            children: [ /* 同じ形 */ ] }],
+  edges: [{ id, from: { id, position }, to: { id, position },
+            stroke: { color, width, marker: { start, end } } }],
+}
+```
+
+model.unchi(ポンチ絵)との違い: ノードの種類は NODE / COMPONENT の 2 つ、`description` はツールチップ、線の矢印は `stroke.marker.end`(真偽値。描かれるのは終点だけ)です。
+
+## 使い方
+
+```js
+import D3Deployment, { Rectum } from '@yanqirenshi/d3.deployment';
+import { ModelInspector } from '@yanqirenshi/colonoscope';
+import {
+  check, fieldsOf, titleOf, withDefaults, movePatch, applyPatch, mergePatch, findById, ModelError,
+} from '@yanqirenshi/model.deployment';
+
+const errors = check({ nodes, edges });          // [] なら問題なし
+
+const rectum = new Rectum({
+  callbacks: {
+    node: {
+      // ドラッグの終わり → 位置の patch(core は入力のレコード)
+      dragend: (core, node, move) => save(movePatch(core, move)),
+      //  → { collection: 'nodes', id: 1, patch: { position: { x: 120, y: 40 } } }
+      contextmenu: (core) => setTarget({ collection: 'nodes', id: core.id }),
+    },
+    edge: { contextmenu: (core) => setTarget({ collection: 'edges', id: core.id }) },
+  },
+});
+
+const record = findById(data[target.collection], target.id);   // ノードは子も探す
+<ModelInspector
+  target={record && withDefaults(record)}
+  fields={fieldsOf}
+  title={titleOf}
+  onApply={(values) => {
+    try {
+      save(applyPatch(record, values));              // 変えた項目だけが patch に入る
+    } catch (e) {
+      if (e instanceof ModelError) alert(e.message);  // 利用者向けの日本語
+    }
+  }}
+/>
+```
+
+### `applyPatch` の検証
+
+| 項目 | 規則 |
+|---|---|
+| 名称(`label.text`) | 空にできない(d3.deployment は名称の無いノードに `????????` を描く) |
+| 種類(`type`) | `NODE` / `COMPONENT` |
+| 説明 | 空にすると項目を除く |
+| URL(`link.url`) | 空にすると `link` ごと除く |
+| 幅・高さ | 0 以上。整数に丸める(0 で子に合わせる) |
+| 色(背景・枠線・線) | ブラウザでは `CSS.supports('color', v)`。CSS の無い環境では `#hex` / 関数表記 / 英字の色名を通す緩い判定 |
+| 枠線・線の太さ | 0 より大きい数(d3.deployment は 0 を「書いていない」と見て既定に倒す) |
+| 接続位置(角度) | 数。0 以上 360 未満の整数に正規化 |
+| 終点の矢印 | `true` / `false`。d3.deployment は `marker` を丸ごと置き換えるので、patch には始点側も描いている値で埋めて入れる |
+
+図に描いている値(`withDefaults` の結果)から**変えた項目だけ**を patch に入れます。
+
+### 編集できる項目(`fieldsOf`)
+
+- ノード: 名称・種類・ID・説明・URL・幅・高さ・背景色・枠線の色 / 太さ
+- 線: ID・接続元 / 接続先のノードと位置(角度)・線の色 / 太さ・終点の矢印
+
+`border.type` と始点の矢印(`marker.start`)は d3.deployment が描かないので項目にしません。
+
+### 既定値の出どころ
+
+d3.deployment は共通基盤 assh0le のデータクラス(`Stroke` / `Background` / `Label` / `Padding` / `Position`)で入力を正規化していました。
+枠線・背景の既定はここに移し(`nodeStyle`)、assh0le のテンプレートと同じ値であることをテストで突き合わせています。
+ラベルの位置・フォント・余白・位置の正規化は assh0le のまま(値はこのパッケージの定数と同じ)。
+
+## スコープ外(いまは持たない)
+
+- `label.position` / `label.font` / `padding` の編集、ノード・線の追加削除
+- ファイル・HTTP などの永続化(利用側の実装)
+
+## 配布形式
+
+ESM(`dist/`)に加えて CommonJS 版(`dist/cjs/`)も出します。
+Babel 系の `d3.deployment` を jest(CommonJS)でテストするためで、d3.deployment の jest が ESM を読めるようになったら外せます。
+
+## コマンド
+
+```bash
+npm run build     -w @yanqirenshi/model.deployment   # tsc で dist/(ESM + d.ts)と dist/cjs/(CommonJS)へビルド
+npm run typecheck -w @yanqirenshi/model.deployment
+npm test          -w @yanqirenshi/model.deployment   # vitest(assh0le のテンプレートとの突き合わせを含む)
+```

package/dist/check.d.ts

@@ -0,0 +1,15 @@
+import type { DeploymentGraph, DeploymentId, DeploymentNodeRecord, DeploymentRecord } from './types.js';
+/** 入れ子のノード(children)を平らにする(親 → 子 の順) */
+export declare function flatten(nodes: DeploymentNodeRecord[]): DeploymentNodeRecord[];
+/**
+ * 図全体を検査する。
+ *   - nodes(子を含む)の id が重複していない
+ *   - edges の id が重複していない
+ *   - edges の from.id / to.id がノードに存在する
+ *
+ * @param prefix メッセージのコレクション名の前に付ける文字列(例: 'deployment/')
+ */
+export declare function check(data: DeploymentGraph, prefix?: string): string[];
+/** ノード(子を含む)か線を id で探す(無ければ null) */
+export declare function findById<T extends DeploymentRecord>(list: readonly T[] | undefined, id: DeploymentId): T | null;
+//# sourceMappingURL=check.d.ts.map

package/dist/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAExG,wCAAwC;AACxC,wBAAgB,OAAO,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,oBAAoB,EAAE,CAE7E;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,SAAK,GAAG,MAAM,EAAE,CAElE;AAED,qCAAqC;AACrC,wBAAgB,QAAQ,CAAC,CAAC,SAAS,gBAAgB,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,SAAS,EAAE,EAAE,EAAE,YAAY,GAAG,CAAC,GAAG,IAAI,CAE/G"}

package/dist/check.js

@@ -0,0 +1,27 @@
+// コレクションをまたぐ整合性の検査(id の重複・参照先の存在)。
+// スキーマ(schema.ts)に合っているデータを渡す。戻り値はエラーのメッセージの配列(空なら問題なし)。
+//
+// iHub の server/validation/rules.mjs の checkGraph('deployment', data) と同じ検査・同じ文言。
+// 検査そのものは graph 系(unchi / sitemap / deployment)で共通なので model.core の checkGraph にあり、
+// ここでは model.deployment の型を付けて公開する(#151)。
+// メッセージの先頭はコレクション名で、prefix を渡すと 'deployment/nodes: ...' のように付けられる。
+import { checkGraph, flattenNodes, findById as findInList } from '@yanqirenshi/model.core';
+/** 入れ子のノード(children)を平らにする(親 → 子 の順) */
+export function flatten(nodes) {
+    return flattenNodes(nodes);
+}
+/**
+ * 図全体を検査する。
+ *   - nodes(子を含む)の id が重複していない
+ *   - edges の id が重複していない
+ *   - edges の from.id / to.id がノードに存在する
+ *
+ * @param prefix メッセージのコレクション名の前に付ける文字列(例: 'deployment/')
+ */
+export function check(data, prefix = '') {
+    return checkGraph(data, prefix);
+}
+/** ノード(子を含む)か線を id で探す(無ければ null) */
+export function findById(list, id) {
+    return findInList(list, id);
+}

package/dist/cjs/check.js

@@ -0,0 +1,32 @@
+"use strict";
+// コレクションをまたぐ整合性の検査(id の重複・参照先の存在)。
+// スキーマ(schema.ts)に合っているデータを渡す。戻り値はエラーのメッセージの配列(空なら問題なし)。
+//
+// iHub の server/validation/rules.mjs の checkGraph('deployment', data) と同じ検査・同じ文言。
+// 検査そのものは graph 系(unchi / sitemap / deployment)で共通なので model.core の checkGraph にあり、
+// ここでは model.deployment の型を付けて公開する(#151)。
+// メッセージの先頭はコレクション名で、prefix を渡すと 'deployment/nodes: ...' のように付けられる。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flatten = flatten;
+exports.check = check;
+exports.findById = findById;
+const model_core_1 = require("@yanqirenshi/model.core");
+/** 入れ子のノード(children)を平らにする(親 → 子 の順) */
+function flatten(nodes) {
+    return (0, model_core_1.flattenNodes)(nodes);
+}
+/**
+ * 図全体を検査する。
+ *   - nodes(子を含む)の id が重複していない
+ *   - edges の id が重複していない
+ *   - edges の from.id / to.id がノードに存在する
+ *
+ * @param prefix メッセージのコレクション名の前に付ける文字列(例: 'deployment/')
+ */
+function check(data, prefix = '') {
+    return (0, model_core_1.checkGraph)(data, prefix);
+}
+/** ノード(子を含む)か線を id で探す(無ければ null) */
+function findById(list, id) {
+    return (0, model_core_1.findById)(list, id);
+}

package/dist/cjs/defaults.js

@@ -0,0 +1,119 @@
+"use strict";
+// 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 を付けない)ので、モデルも項目にしない。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EDGE_DEFAULTS = exports.NODE_DEFAULTS = exports.LABEL_DEFAULTS = exports.NODE_STYLE_DEFAULTS = exports.NODE_TYPES = void 0;
+exports.isEdge = isEdge;
+exports.nodeStyle = nodeStyle;
+exports.edgeStyle = edgeStyle;
+exports.degreeOf = degreeOf;
+exports.withDefaults = withDefaults;
+/** ノードの種類 */
+exports.NODE_TYPES = ['NODE', 'COMPONENT'];
+/** ノードの枠線・背景の既定(assh0le の Stroke.template / Background.template) */
+exports.NODE_STYLE_DEFAULTS = {
+    border: { color: '#afafb0', width: 1, type: 'solid' },
+    background: { color: '#fff', opacity: 1.0 },
+};
+/**
+ * ラベルの既定(assh0le の Label.template)。text が無いとき d3.deployment は '????????' を描く
+ * (withDefaults では '' を入れる — 「書いていない」ことをインスペクタで見せるため)。
+ */
+exports.LABEL_DEFAULTS = {
+    placeholder: '????????',
+    position: { x: 0, y: 0 },
+    font: { size: 16, color: '#333333' },
+};
+/** ノードの既定(Padding / Position.template)。size の 0 は「子に合わせる」 */
+exports.NODE_DEFAULTS = {
+    type: 'NODE',
+    padding: 0,
+    position: { x: 0, y: 0 },
+};
+/** 線の既定(Edge.dataTemplate の stroke、端点の角度は Geometry.getPortLineTo の 90=左) */
+exports.EDGE_DEFAULTS = {
+    stroke: {
+        color: '#333',
+        width: 1.5,
+        marker: { start: false, end: true },
+    },
+    position: 90,
+};
+/** 線か(from と to を持つ)。ノードは持たない */
+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;
+}
+/** ノードが描かれる枠線・背景(既定に入力を重ねた、実際に描かれる値) */
+function nodeStyle(node) {
+    return {
+        border: mergeStyle(exports.NODE_STYLE_DEFAULTS.border, node.border),
+        background: mergeStyle(exports.NODE_STYLE_DEFAULTS.background, node.background),
+    };
+}
+/**
+ * 線が描かれる値(Edge.normalize と同じ: stroke の color / width / marker はそれぞれ truthy ならそれ)。
+ * marker は入力があれば丸ごと置き換わる(片方だけ書くと、もう片方は偽)。
+ * d3.deployment のペインタが描くのは終点の矢印(marker.end)だけで、start は描かない。
+ */
+function edgeStyle(edge) {
+    return {
+        stroke: {
+            color: edge.stroke?.color || exports.EDGE_DEFAULTS.stroke.color,
+            width: edge.stroke?.width || exports.EDGE_DEFAULTS.stroke.width,
+            marker: edge.stroke?.marker
+                ? { start: !!edge.stroke.marker.start, end: !!edge.stroke.marker.end }
+                : { ...exports.EDGE_DEFAULTS.stroke.marker },
+        },
+    };
+}
+/** 端点の角度(無ければ 90。Geometry.getPortLineTo と同じ: 0 は 0、それ以外の falsy は 90) */
+function degreeOf(position) {
+    if (position === 0)
+        return 0;
+    return position ? position : exports.EDGE_DEFAULTS.position;
+}
+/**
+ * レコードに、d3.deployment が既定で描いている値を重ねて返す(入力は書き換えない)。
+ * インスペクタの初期値に使う。children は重ねない(子は右クリックしたときに自分で通す)。
+ *
+ * 重ねる項目: ノードは type・padding・position・label.text(無ければ '')・border・background、
+ * 線は stroke(矢印を含む)・from.position・to.position。size は view が子に合わせて埋めるので触らない。
+ */
+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 || exports.NODE_DEFAULTS.type,
+        label: { ...label, text: typeof label.text === 'string' ? label.text : '' },
+        padding: node.padding || node.padding === 0 ? node.padding : exports.NODE_DEFAULTS.padding,
+        position: { ...exports.NODE_DEFAULTS.position, ...(node.position || {}) },
+        border: style.border,
+        background: style.background,
+    };
+}

package/dist/cjs/fields.js

@@ -0,0 +1,44 @@
+"use strict";
+// 編集できる項目の一覧。インスペクタ(colonoscope の ModelInspector)に渡す。
+//
+// path はレコードの実際の項目を指す。既定値は withDefaults() で重ねてから渡すので、
+// 書いていない項目(枠線の色など)も、図に描かれている値が初期値として出る。
+// type: 'readonly' は表示だけ。options は取りうる値の一覧(検証にも使う)。
+//
+// iHub の SystemConfigurationDiagram.js の fields(label.text / type / id)から始め、
+// d3.deployment が描く説明(ツールチップ)・リンク・幅・高さ・背景色・枠線の色 / 太さ、線の矢印を足した。
+// border.type は d3.deployment が描かないので出さない。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EDGE_FIELDS = exports.NODE_FIELDS = void 0;
+exports.fieldsOf = fieldsOf;
+const defaults_js_1 = require("./defaults.js");
+const BOOLEAN_OPTIONS = ['true', 'false'];
+/** ノードの項目 */
+exports.NODE_FIELDS = [
+    { path: 'label.text', label: '名称', type: 'text' },
+    { path: 'type', label: '種類', type: 'text', options: defaults_js_1.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=右) */
+exports.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 },
+];
+/** レコードに応じた項目の一覧(線 / ノード) */
+function fieldsOf(record) {
+    return (0, defaults_js_1.isEdge)(record) ? [...exports.EDGE_FIELDS] : [...exports.NODE_FIELDS];
+}

package/dist/cjs/index.js

@@ -0,0 +1,46 @@
+"use strict";
+// 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 の型を付けて公開している。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isColor = exports.applyPatch = exports.movePatch = exports.mergePatch = exports.getByPath = exports.titleOf = exports.collectionOf = exports.ModelError = exports.fieldsOf = exports.EDGE_FIELDS = exports.NODE_FIELDS = exports.findById = exports.flatten = exports.check = exports.SCHEMAS = exports.EDGES_SCHEMA = exports.NODES_SCHEMA = exports.withDefaults = exports.degreeOf = exports.edgeStyle = exports.nodeStyle = exports.isEdge = exports.EDGE_DEFAULTS = exports.NODE_DEFAULTS = exports.LABEL_DEFAULTS = exports.NODE_STYLE_DEFAULTS = exports.NODE_TYPES = void 0;
+var defaults_js_1 = require("./defaults.js");
+Object.defineProperty(exports, "NODE_TYPES", { enumerable: true, get: function () { return defaults_js_1.NODE_TYPES; } });
+Object.defineProperty(exports, "NODE_STYLE_DEFAULTS", { enumerable: true, get: function () { return defaults_js_1.NODE_STYLE_DEFAULTS; } });
+Object.defineProperty(exports, "LABEL_DEFAULTS", { enumerable: true, get: function () { return defaults_js_1.LABEL_DEFAULTS; } });
+Object.defineProperty(exports, "NODE_DEFAULTS", { enumerable: true, get: function () { return defaults_js_1.NODE_DEFAULTS; } });
+Object.defineProperty(exports, "EDGE_DEFAULTS", { enumerable: true, get: function () { return defaults_js_1.EDGE_DEFAULTS; } });
+Object.defineProperty(exports, "isEdge", { enumerable: true, get: function () { return defaults_js_1.isEdge; } });
+Object.defineProperty(exports, "nodeStyle", { enumerable: true, get: function () { return defaults_js_1.nodeStyle; } });
+Object.defineProperty(exports, "edgeStyle", { enumerable: true, get: function () { return defaults_js_1.edgeStyle; } });
+Object.defineProperty(exports, "degreeOf", { enumerable: true, get: function () { return defaults_js_1.degreeOf; } });
+Object.defineProperty(exports, "withDefaults", { enumerable: true, get: function () { return defaults_js_1.withDefaults; } });
+var schema_js_1 = require("./schema.js");
+Object.defineProperty(exports, "NODES_SCHEMA", { enumerable: true, get: function () { return schema_js_1.NODES_SCHEMA; } });
+Object.defineProperty(exports, "EDGES_SCHEMA", { enumerable: true, get: function () { return schema_js_1.EDGES_SCHEMA; } });
+Object.defineProperty(exports, "SCHEMAS", { enumerable: true, get: function () { return schema_js_1.SCHEMAS; } });
+var check_js_1 = require("./check.js");
+Object.defineProperty(exports, "check", { enumerable: true, get: function () { return check_js_1.check; } });
+Object.defineProperty(exports, "flatten", { enumerable: true, get: function () { return check_js_1.flatten; } });
+Object.defineProperty(exports, "findById", { enumerable: true, get: function () { return check_js_1.findById; } });
+var fields_js_1 = require("./fields.js");
+Object.defineProperty(exports, "NODE_FIELDS", { enumerable: true, get: function () { return fields_js_1.NODE_FIELDS; } });
+Object.defineProperty(exports, "EDGE_FIELDS", { enumerable: true, get: function () { return fields_js_1.EDGE_FIELDS; } });
+Object.defineProperty(exports, "fieldsOf", { enumerable: true, get: function () { return fields_js_1.fieldsOf; } });
+var patch_js_1 = require("./patch.js");
+Object.defineProperty(exports, "ModelError", { enumerable: true, get: function () { return patch_js_1.ModelError; } });
+Object.defineProperty(exports, "collectionOf", { enumerable: true, get: function () { return patch_js_1.collectionOf; } });
+Object.defineProperty(exports, "titleOf", { enumerable: true, get: function () { return patch_js_1.titleOf; } });
+Object.defineProperty(exports, "getByPath", { enumerable: true, get: function () { return patch_js_1.getByPath; } });
+Object.defineProperty(exports, "mergePatch", { enumerable: true, get: function () { return patch_js_1.mergePatch; } });
+Object.defineProperty(exports, "movePatch", { enumerable: true, get: function () { return patch_js_1.movePatch; } });
+Object.defineProperty(exports, "applyPatch", { enumerable: true, get: function () { return patch_js_1.applyPatch; } });
+Object.defineProperty(exports, "isColor", { enumerable: true, get: function () { return patch_js_1.isColor; } });

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+    "type": "commonjs"
+}

package/dist/cjs/patch.js

@@ -0,0 +1,141 @@
+"use strict";
+// UI の操作(ドラッグ・インスペクタの適用)を、保存する patch(JSON Merge Patch)に変換する。
+//
+// 戻り値は { collection, id, patch }。利用側(iHub など)は図の種類を知らずにこれを保存すればよい。
+// 入力の検証に失敗したときは ModelError を投げる(メッセージは利用者にそのまま見せられる日本語)。
+// model.sitemap の patch.ts を元にしている(ラベルは label.text、種類は NODE / COMPONENT、線に矢印の有無がある)。
+// 読み取り部品(toColor など)と patch の道具は model.core にある(#151)。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isColor = exports.mergePatch = exports.getByPath = exports.ModelError = void 0;
+exports.collectionOf = collectionOf;
+exports.titleOf = titleOf;
+exports.movePatch = movePatch;
+exports.applyPatch = applyPatch;
+const model_core_1 = require("@yanqirenshi/model.core");
+const defaults_js_1 = require("./defaults.js");
+const fields_js_1 = require("./fields.js");
+// model.core のものをそのまま公開する(利用側が model.deployment だけを読めばよいように)
+var model_core_2 = require("@yanqirenshi/model.core");
+Object.defineProperty(exports, "ModelError", { enumerable: true, get: function () { return model_core_2.ModelError; } });
+Object.defineProperty(exports, "getByPath", { enumerable: true, get: function () { return model_core_2.getByPath; } });
+Object.defineProperty(exports, "mergePatch", { enumerable: true, get: function () { return model_core_2.mergePatch; } });
+Object.defineProperty(exports, "isColor", { enumerable: true, get: function () { return model_core_2.isColor; } });
+/** レコードを置くコレクション */
+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();
+}
+/**
+ * ドラッグで動かしたノードの位置を保存する patch。
+ * 保存してある position に移動量を足し、整数に丸める(position が無いときは 0, 0 から)。
+ * 子のノード(COMPONENT を含む)の position は親の中での位置なので、親を動かしても子の patch は要らない。
+ */
+function movePatch(node, move) {
+    return (0, model_core_1.movePatch)(node, move, 'nodes');
+}
+// インスペクタの入力のうち、図に描いている値(withDefaults)から変わった項目だけ
+function changedValues(record, values) {
+    return (0, model_core_1.changedValues)((0, defaults_js_1.withDefaults)(record), values, (0, fields_js_1.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, values) {
+    const patch = {};
+    for (const [path, value] of changedValues(node, values)) {
+        switch (path) {
+            case 'label.text':
+                // 名称は空にできない(d3.deployment は名称の無いノードに '????????' を描く)
+                if (value === '')
+                    throw new model_core_1.ModelError('名称を入力してください。');
+                (0, model_core_1.put)(patch, path, value);
+                break;
+            case 'type':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.toOption)(value, defaults_js_1.NODE_TYPES, '種類'));
+                break;
+            case 'description':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.toOptionalText)(value));
+                break;
+            case 'link.url':
+                // URL を空にするとリンクごと除く(d3.deployment は url の無い link を描かない)
+                if (value === '')
+                    patch.link = null;
+                else
+                    (0, model_core_1.put)(patch, path, value);
+                break;
+            case 'size.w':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.toLength)(value, '幅', LENGTH));
+                break;
+            case 'size.h':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.toLength)(value, '高さ', LENGTH));
+                break;
+            case 'background.color':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.toColor)(value, '背景色'));
+                break;
+            case 'border.color':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.toColor)(value, '枠線の色'));
+                break;
+            case 'border.width':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.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':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.toDegree)(value, `${END_LABELS[path.split('.')[0]]}の位置`));
+                break;
+            case 'stroke.color':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.toColor)(value, '線の色'));
+                break;
+            case 'stroke.width':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.toWidth)(value, '線の太さ'));
+                break;
+            case 'stroke.marker.start':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.toBoolean)(value, '始点の矢印'));
+                break;
+            case 'stroke.marker.end':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.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),
+    };
+}