@yanqirenshi/model.unchi 0.0.0-stage → 0.1.0

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,126 @@
-# Temporary Holding Version
+# @yanqirenshi/model.unchi
 
-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.
+d3.unchi(ポンチ絵)の**図ごとの知識**を、描画(view)から独立させたパッケージです。
+react / d3 に依存しない、純粋なデータと関数だけを持ちます。
+
+| 持つもの | 入口 |
+|---|---|
+| 入力データのスキーマ(JSON Schema 2020-12) | `SCHEMAS.nodes` / `SCHEMAS.edges` |
+| コレクションをまたぐ整合性ルール(id の重複・参照先の存在) | `check(data)` |
+| d3.unchi が既定で描いている値の補完 | `withDefaults(record)` / `nodeStyle` / `edgeStyle` / `kindOf` |
+| 編集できる項目の一覧(インスペクタ用) | `fieldsOf(record)` |
+| UI の操作を保存する patch に変える変換 | `movePatch(node, move)` / `applyPatch(record, values)` |
+
+利用側(iHub など)は、モデルが返す `{ collection, id, patch }` を保存するだけで、図の種類を知らずに書けます。
+
+## 位置づけ
+
+```
+利用側 ──▶ d3.unchi (view)            ──▶ (いまは独立。将来 model.unchi を読む)
+     ──▶ colonoscope (ModelInspector)
+     ──▶ model.unchi
+     ──▶ 自前の永続化
+```
+
+model.unchi・view・colonoscope の間に横の依存はありません。組み合わせるのは利用側だけです。
+これは [Foolsgolds/Assholes#138](https://github.com/Foolsgolds/Assholes/issues/138) の「最初の一歩」で、
+d3.unchi はまだ model.unchi を読んでいません。既定値は当面二重に書いてあり、
+`tests/defaults.test.ts` が d3.unchi のソースと突き合わせてずれを検出します。
+
+## 使い方
+
+「レコード」は d3.unchi の `data()` に渡す入力そのもの(`nodes` / `edges` の 1 要素)です。
+d3.unchi はコールバックの `core` に入力のオブジェクトをそのまま渡すので、`core` がレコードです。
+
+```js
+import { Rectum } from '@yanqirenshi/d3.unchi';
+import { ModelInspector } from '@yanqirenshi/colonoscope';
+import {
+  check, fieldsOf, titleOf, withDefaults, movePatch, applyPatch, mergePatch, ModelError,
+} from '@yanqirenshi/model.unchi';
+
+// 読み込んだデータの検査(スキーマで検証したあとに)
+const errors = check({ nodes, edges });          // [] なら問題なし
+
+const rectum = new Rectum({
+  callbacks: {
+    node: {
+      // ドラッグの終わり → 位置の patch
+      dragend: (core, node, move) => save(movePatch(core, move)),
+      //  → { collection: 'nodes', id: 11, patch: { position: { x: 120, y: 40 } } }
+      contextmenu: (core) => setTarget(core),
+    },
+    edge: { contextmenu: (core) => setTarget(core) },
+  },
+});
+
+// インスペクタ。項目はモデルが決め、利用側は hide / override で調整する
+<ModelInspector
+  target={target && withDefaults(target)}     // 既定値を重ねたレコード(書いていない色も初期値に出る)
+  fields={fieldsOf}
+  title={titleOf}
+  hide={['type']}
+  onApply={(values) => {
+    try {
+      const change = applyPatch(target, values);   // 変えた項目だけが patch に入る
+      save(change);
+      setTarget(mergePatch(target, change.patch)); // 表示を先に更新
+    } catch (e) {
+      if (e instanceof ModelError) alert(e.message);   // 利用者向けの日本語
+    }
+  }}
+/>
+```
+
+### `applyPatch` の検証
+
+| 項目 | 規則 |
+|---|---|
+| 幅・高さ | 1 以上。整数に丸める |
+| 色(背景・枠線・線) | ブラウザでは `CSS.supports('color', v)`。CSS の無い環境(Node)では `#hex` / `rgb()` などの関数表記 / 英字の色名を通す緩い判定 |
+| 枠線の種類 | `solid` / `dashed` / `dotted` |
+| 枠線・線の太さ | 0 より大きい数 |
+| 接続位置(角度) | 数。0 以上 360 未満の整数に正規化 |
+| マーカー | `none` / `arrow` / `triangle` / `triangle-open` / `circle` / `circle-open` / `diamond` / `diamond-open` |
+| ノードの名称 | 空にできない(d3.unchi は名称の無いノードに代わりの文字を描く) |
+| 線のラベル | 空にすると消す(`{ label: { text: null } }` — JSON Merge Patch) |
+
+図に描いている値(`withDefaults` の結果)から**変えた項目だけ**を patch に入れます。
+既定の値まで書き込まないためです。変更が無ければ `patch` は `{}` です。
+
+### 編集できる項目(`fieldsOf`)
+
+colonoscope の `{ path, label, type }` と同じ形で、取りうる値の一覧 `options` を足しています。
+`path` はレコードの**実際の項目**を指します(`_style.*` のような写し先は作りません)。
+
+- ノード: 名称(`label.text`)・種類・ID・幅・高さ・背景色・枠線の種類 / 色 / 太さ
+- 線: ID・接続元 / 接続先のノードと位置(角度)・始点 / 終点のマーカー・線の色 / 太さ・ラベル
+- 文字だけのノード(`type: 'TEXT'`): 枠・背景・名称の項目を除く(本文の編集は当面スコープ外)
+
+### スキーマ
+
+```js
+import Ajv2020 from 'ajv/dist/2020.js';
+import { SCHEMAS } from '@yanqirenshi/model.unchi';
+
+const ajv = new Ajv2020({ allErrors: true, allowUnionTypes: true });
+ajv.addKeyword({ keyword: 'x-id-start', schemaType: 'number' });   // 採番の注釈。検証には使わない
+const validate = ajv.compile(SCHEMAS.nodes);
+```
+
+スキーマが検査するのは図の構造にかかわる項目(id・type・_class・size・position・children、線の from / to・マーカー)だけで、
+見た目の項目は d3.unchi の入力の形のまま書けるよう `additionalProperties` を閉じていません。
+
+## スコープ外(いまは持たない)
+
+- `TEXT` ノードの本文(`text` / `bullet`)、`ICON` / `CYLINDER` / `IMAGE` 固有の項目(`icon` / `cap` / `url`)の編集
+- `padding` / `label.align` などレイアウト系の編集
+- ファイル・HTTP などの永続化(利用側の実装)
+
+## コマンド
+
+```bash
+npm run build     -w @yanqirenshi/model.unchi   # tsc で dist/ へビルド(d.ts 含む)
+npm run typecheck -w @yanqirenshi/model.unchi
+npm test          -w @yanqirenshi/model.unchi   # vitest(d3.unchi の既定値との突き合わせを含む)
+```

package/dist/check.d.ts

@@ -0,0 +1,13 @@
+import type { UnchiGraph, UnchiNodeRecord } from './types.js';
+/** 入れ子のノード(children)を平らにする(親 → 子 の順) */
+export declare function flatten(nodes: UnchiNodeRecord[]): UnchiNodeRecord[];
+/**
+ * 図全体を検査する。
+ *   - nodes(子を含む)の id が重複していない
+ *   - edges の id が重複していない
+ *   - edges の from.id / to.id がノードに存在する
+ *
+ * @param prefix メッセージのコレクション名の前に付ける文字列(例: 'overview/')
+ */
+export declare function check(data: UnchiGraph, prefix?: string): string[];
+//# 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":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D,wCAAwC;AACxC,wBAAgB,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAEnE;AAgBD;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,SAAK,GAAG,MAAM,EAAE,CAa7D"}

package/dist/check.js

@@ -0,0 +1,37 @@
+// コレクションをまたぐ整合性の検査(id の重複・参照先の存在)。
+// スキーマ(schema.ts)に合っているデータを渡す。戻り値はエラーのメッセージの配列(空なら問題なし)。
+//
+// iHub の server/validation/rules.mjs の checkGraph を移したもの。
+// メッセージの先頭はコレクション名で、prefix を渡すと 'overview/nodes: ...' のように付けられる。
+/** 入れ子のノード(children)を平らにする(親 → 子 の順) */
+export function flatten(nodes) {
+    return nodes.flatMap(node => [node, ...flatten(node.children || [])]);
+}
+// list の中で id が重複していればエラーにする。id の集合を返す。
+function checkUnique(errors, label, list) {
+    const values = new Set();
+    for (const d of list) {
+        if (values.has(d.id))
+            errors.push(`${label}: id が重複しています。(id=${String(d.id)})`);
+        values.add(d.id);
+    }
+    return values;
+}
+/**
+ * 図全体を検査する。
+ *   - nodes(子を含む)の id が重複していない
+ *   - edges の id が重複していない
+ *   - edges の from.id / to.id がノードに存在する
+ *
+ * @param prefix メッセージのコレクション名の前に付ける文字列(例: 'overview/')
+ */
+export function check(data, prefix = '') {
+    const errors = [];
+    const node_ids = checkUnique(errors, `${prefix}nodes`, flatten(data.nodes || []));
+    checkUnique(errors, `${prefix}edges`, data.edges || []);
+    for (const edge of data.edges || [])
+        for (const end of ['from', 'to'])
+            if (!edge[end] || !node_ids.has(edge[end].id))
+                errors.push(`${prefix}edges: ${end}.id のノードが見つかりません。(id=${String(edge.id)}, ${end}.id=${String(edge[end]?.id)})`);
+    return errors;
+}

package/dist/defaults.d.ts

@@ -0,0 +1,77 @@
+import type { Background, Border, Font, Stroke } from '@yanqirenshi/types';
+import type { UnchiEdgeRecord, UnchiNodeClass, UnchiNodeRecord, UnchiRecord } from './types.js';
+/** ノードの区分 */
+export declare const NODE_CLASSES: readonly ["BRANCH", "REAF"];
+/** 枠線の種類(d3.unchi が描けるもの) */
+export declare const BORDER_TYPES: readonly ["solid", "dashed", "dotted"];
+/** 線の両端のマーカー */
+export declare const MARKER_TYPES: readonly ["none", "arrow", "triangle", "triangle-open", "circle", "circle-open", "diamond", "diamond-open"];
+/**
+ * ノードの「描き方の種類」。d3.unchi がどのデータクラスで正規化するかに対応する。
+ *   BRANCH / REAF … 通常の枝・葉(type: NODE / COMPONENT、_class か children で決まる)
+ *   BRANCH_ICON … type: ICON(アイコン付きの枝)
+ *   BRANCH_CYLINDER … type: CYLINDER(円筒の枝)
+ *   REAF_IMAGE … type: IMAGE(画像の葉)
+ *   REAF_CHEVRON … type: CHEVRON(矢羽の葉)
+ *   REAF_TEXT … type: TEXT(文字だけの葉。枠・背景を描かない)
+ */
+export type UnchiNodeKind = 'BRANCH' | 'BRANCH_ICON' | 'BRANCH_CYLINDER' | 'REAF' | 'REAF_IMAGE' | 'REAF_CHEVRON' | 'REAF_TEXT';
+export interface UnchiNodeStyle {
+    border: Required<Border>;
+    background: Required<Background>;
+}
+/** 種類ごとの枠線・背景の既定(d3.unchi の各データクラスの styleDefaults()) */
+export declare const NODE_STYLE_DEFAULTS: Record<UnchiNodeKind, UnchiNodeStyle>;
+/** 通常ノードのラベルの既定(Node.dataTemplate の label) */
+export declare const NODE_LABEL_DEFAULTS: {
+    readonly position: {
+        readonly x: 20;
+        readonly y: 20;
+    };
+    readonly font: Font;
+    readonly align: "left";
+    readonly valign: "top";
+};
+/** 線の既定(Edge.dataTemplate / labelFontDefaults) */
+export declare const EDGE_DEFAULTS: {
+    readonly stroke: Required<Pick<Stroke, "color" | "width">>;
+    readonly from_marker: "none";
+    readonly to_marker: "arrow";
+    readonly label_font: Required<Font>;
+};
+/** 線か(from と to を持つ)。ノードは持たない */
+export declare function isEdge(record: UnchiRecord | null | undefined): record is UnchiEdgeRecord;
+/**
+ * ノードの区分。入力が BRANCH / REAF ならそのまま、
+ * それ以外(省略・不正値)は children があれば BRANCH、無ければ REAF。
+ * (d3.unchi の Node.classOf と同じ)
+ */
+export declare function classOf(node: UnchiNodeRecord): UnchiNodeClass;
+/**
+ * ノードの描き方の種類。d3.unchi の Rectum.nodeModel(core) と同じ順で決める。
+ *   ICON / CYLINDER は、明示的に _class: 'REAF' でなければ枝
+ *   それ以外は区分が BRANCH なら枝、IMAGE / CHEVRON / TEXT はそれぞれの葉、残りは通常の葉
+ */
+export declare function kindOf(node: UnchiNodeRecord): UnchiNodeKind;
+/** ノードが描かれる枠線・背景(既定に入力を重ねた、実際に描かれる値) */
+export declare function nodeStyle(node: UnchiNodeRecord): UnchiNodeStyle;
+/**
+ * 線が描かれる値。
+ * stroke は d3.unchi の Edge.normalize と同じく truthy 判定(空文字・0 は既定に倒れる)。
+ * マーカーは MARKER_TYPES に無ければ既定。
+ */
+export declare function edgeStyle(edge: UnchiEdgeRecord): {
+    stroke: Required<Pick<Stroke, 'color' | 'width'>>;
+    from_marker: string;
+    to_marker: string;
+};
+/**
+ * レコードに、d3.unchi が既定で描いている値を重ねて返す(入力は書き換えない)。
+ * インスペクタの初期値に使う。children は重ねない(子は右クリックしたときに自分で通す)。
+ *
+ * 重ねる項目: ノードは label.text(無ければ '')・border・background、
+ * 線は stroke・from_marker・to_marker・label.text(無ければ '')。
+ * size / position / 角度は view が計算で埋めるもの(Hierarchy.fitting 等)なので、ここでは触らない。
+ */
+export declare function withDefaults<T extends UnchiRecord>(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":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhG,aAAa;AACb,eAAO,MAAM,YAAY,6BAA8B,CAAC;AAExD,6BAA6B;AAC7B,eAAO,MAAM,YAAY,wCAAyC,CAAC;AAEnE,gBAAgB;AAChB,eAAO,MAAM,YAAY,6GAEf,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GACrB,QAAQ,GAAG,aAAa,GAAG,iBAAiB,GAC5C,MAAM,GAAG,YAAY,GAAG,cAAc,GAAG,WAAW,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzB,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;CAClC;AAED,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,aAAa,EAAE,cAAc,CA8BrE,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB;;;;;mBAEU,IAAI;;;CAGpC,CAAC;AAEX,kDAAkD;AAClD,eAAO,MAAM,aAAa;qBACiB,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC;;;yBAGlB,QAAQ,CAAC,IAAI,CAAC;CACtE,CAAC;AAEX,iCAAiC;AACjC,wBAAgB,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,IAAI,eAAe,CAExF;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,CAO7D;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,CAuB3D;AAgBD,wCAAwC;AACxC,wBAAgB,SAAS,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,CAO/D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,eAAe,GAAG;IAChD,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAYA;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAsBhE"}

package/dist/defaults.js

@@ -0,0 +1,159 @@
+// d3.unchi が「書いていない項目」に既定で描く値。
+//
+// 値の出どころは d3.unchi の src/js/datamodels/*.js の styleDefaults() / dataTemplate() と、
+// Rectum.nodeModel(core) の振り分け規則。**d3.unchi 側はまだこのファイルを読んでいない**ので
+// 当面は二重に書いてあり、tests/defaults.test.ts が d3.unchi のソースと突き合わせて
+// ずれを検出する(d3.unchi が model.unchi を読むようになったら、この二重は解消する — #138 の 3)。
+/** ノードの区分 */
+export const NODE_CLASSES = ['BRANCH', 'REAF'];
+/** 枠線の種類(d3.unchi が描けるもの) */
+export const BORDER_TYPES = ['solid', 'dashed', 'dotted'];
+/** 線の両端のマーカー */
+export const MARKER_TYPES = [
+    'none', 'arrow', 'triangle', 'triangle-open', 'circle', 'circle-open', 'diamond', 'diamond-open',
+];
+/** 種類ごとの枠線・背景の既定(d3.unchi の各データクラスの styleDefaults()) */
+export const NODE_STYLE_DEFAULTS = {
+    BRANCH: {
+        border: { color: '#7a8ca3', width: 1.5, type: 'dashed', r: 10 },
+        background: { color: '#f3f6fb', opacity: 1.0 },
+    },
+    BRANCH_ICON: {
+        border: { color: '#545b64', width: 1.5, type: 'solid', r: 0 },
+        background: { color: '#ffffff', opacity: 1.0 },
+    },
+    BRANCH_CYLINDER: {
+        border: { color: '#666666', width: 2, type: 'solid', r: 0 },
+        background: { color: '#ffffff', opacity: 1.0 },
+    },
+    REAF: {
+        border: { color: '#5b7bb5', width: 1.5, type: 'solid', r: 4 },
+        background: { color: '#ffffff', opacity: 1.0 },
+    },
+    // ReafImage は styleDefaults を上書きしないので Reaf と同じ
+    REAF_IMAGE: {
+        border: { color: '#5b7bb5', width: 1.5, type: 'solid', r: 4 },
+        background: { color: '#ffffff', opacity: 1.0 },
+    },
+    REAF_CHEVRON: {
+        border: { color: '#5b7bb5', width: 1.5, type: 'solid', r: 0 },
+        background: { color: '#ffffff', opacity: 1.0 },
+    },
+    REAF_TEXT: {
+        border: { color: 'none', width: 0, type: 'solid', r: 0 },
+        background: { color: 'none', opacity: 0 },
+    },
+};
+/** 通常ノードのラベルの既定(Node.dataTemplate の label) */
+export const NODE_LABEL_DEFAULTS = {
+    position: { x: 20, y: 20 },
+    font: { size: 16, color: '#333333' },
+    align: 'left',
+    valign: 'top',
+};
+/** 線の既定(Edge.dataTemplate / labelFontDefaults) */
+export const EDGE_DEFAULTS = {
+    stroke: { color: '#333', width: 1.5 },
+    from_marker: 'none',
+    to_marker: 'arrow',
+    label_font: { size: 12, color: '#333333', weight: 'normal' },
+};
+/** 線か(from と to を持つ)。ノードは持たない */
+export function isEdge(record) {
+    return !!(record && record.from && record.to);
+}
+/**
+ * ノードの区分。入力が BRANCH / REAF ならそのまま、
+ * それ以外(省略・不正値)は children があれば BRANCH、無ければ REAF。
+ * (d3.unchi の Node.classOf と同じ)
+ */
+export function classOf(node) {
+    const v = node._class;
+    if (typeof v === 'string' && NODE_CLASSES.includes(v))
+        return v;
+    return node.children && node.children.length > 0 ? 'BRANCH' : 'REAF';
+}
+/**
+ * ノードの描き方の種類。d3.unchi の Rectum.nodeModel(core) と同じ順で決める。
+ *   ICON / CYLINDER は、明示的に _class: 'REAF' でなければ枝
+ *   それ以外は区分が BRANCH なら枝、IMAGE / CHEVRON / TEXT はそれぞれの葉、残りは通常の葉
+ */
+export function kindOf(node) {
+    const type = node.type;
+    const explicit = NODE_CLASSES.includes(node._class) ? node._class : null;
+    if (type === 'ICON' && explicit !== 'REAF')
+        return 'BRANCH_ICON';
+    if (type === 'CYLINDER' && explicit !== 'REAF')
+        return 'BRANCH_CYLINDER';
+    if (classOf(node) === 'BRANCH')
+        return 'BRANCH';
+    if (type === 'IMAGE')
+        return 'REAF_IMAGE';
+    if (type === 'CHEVRON')
+        return 'REAF_CHEVRON';
+    if (type === 'TEXT')
+        return 'REAF_TEXT';
+    return 'REAF';
+}
+/** 既定に入力の指定(undefined / null でない項目だけ)を重ねる(d3.unchi の datamodels/style.js の mergeStyle) */
+function mergeStyle(defaults, given) {
+    const out = { ...defaults };
+    for (const key of Object.keys(given || {})) {
+        const v = given[key];
+        if (v !== undefined && v !== null)
+            out[key] = v;
+    }
+    return out;
+}
+/** ノードが描かれる枠線・背景(既定に入力を重ねた、実際に描かれる値) */
+export function nodeStyle(node) {
+    const defaults = NODE_STYLE_DEFAULTS[kindOf(node)];
+    return {
+        border: mergeStyle(defaults.border, node.border),
+        background: mergeStyle(defaults.background, node.background),
+    };
+}
+/**
+ * 線が描かれる値。
+ * stroke は d3.unchi の Edge.normalize と同じく truthy 判定(空文字・0 は既定に倒れる)。
+ * マーカーは MARKER_TYPES に無ければ既定。
+ */
+export function edgeStyle(edge) {
+    const marker = (v, fallback) => MARKER_TYPES.includes(v) ? v : fallback;
+    return {
+        stroke: {
+            color: edge.stroke?.color || EDGE_DEFAULTS.stroke.color,
+            width: edge.stroke?.width || EDGE_DEFAULTS.stroke.width,
+        },
+        from_marker: marker(edge.from_marker, EDGE_DEFAULTS.from_marker),
+        to_marker: marker(edge.to_marker, EDGE_DEFAULTS.to_marker),
+    };
+}
+/**
+ * レコードに、d3.unchi が既定で描いている値を重ねて返す(入力は書き換えない)。
+ * インスペクタの初期値に使う。children は重ねない(子は右クリックしたときに自分で通す)。
+ *
+ * 重ねる項目: ノードは label.text(無ければ '')・border・background、
+ * 線は stroke・from_marker・to_marker・label.text(無ければ '')。
+ * size / position / 角度は view が計算で埋めるもの(Hierarchy.fitting 等)なので、ここでは触らない。
+ */
+export function withDefaults(record) {
+    if (isEdge(record)) {
+        const style = edgeStyle(record);
+        const label = record.label && typeof record.label === 'object' ? record.label : {};
+        return {
+            ...record,
+            ...style,
+            label: { ...label, text: typeof label.text === 'string' ? label.text : '' },
+        };
+    }
+    const node = record;
+    const style = nodeStyle(node);
+    const label = node.label && typeof node.label === 'object' ? node.label : {};
+    return {
+        ...node,
+        label: { ...label, text: typeof label.text === 'string' ? label.text : '' },
+        border: style.border,
+        background: style.background,
+    };
+}

package/dist/fields.d.ts

@@ -0,0 +1,8 @@
+import type { UnchiField, UnchiRecord } from './types.js';
+/** ノードの項目 */
+export declare const NODE_FIELDS: readonly UnchiField[];
+/** 線の項目。接続位置はノードの中心から見た角度(0=真下・時計回り。90=左 / 180=真上 / 270=右) */
+export declare const EDGE_FIELDS: readonly UnchiField[];
+/** レコードに応じた項目の一覧(線 / ノード / 文字だけのノード) */
+export declare function fieldsOf(record: UnchiRecord): UnchiField[];
+//# 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":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D,aAAa;AACb,eAAO,MAAM,WAAW,EAAE,SAAS,UAAU,EAU5C,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,WAAW,EAAE,SAAS,UAAU,EAW5C,CAAC;AAMF,wCAAwC;AACxC,wBAAgB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,EAAE,CAQ1D"}

package/dist/fields.js

@@ -0,0 +1,42 @@
+// 編集できる項目の一覧。インスペクタ(colonoscope の ModelInspector)に渡す。
+//
+// path はレコードの実際の項目を指す。既定値は withDefaults() で重ねてから渡すので、
+// 書いていない項目(枠線の色など)も、図に描かれている値が初期値として出る。
+// type: 'readonly' は表示だけ。options は取りうる値の一覧(検証にも使う)。
+import { BORDER_TYPES, MARKER_TYPES, isEdge } from './defaults.js';
+/** ノードの項目 */
+export const NODE_FIELDS = [
+    { path: 'label.text', label: '名称', type: 'text' },
+    { path: 'type', label: '種類', type: 'readonly' },
+    { path: 'id', label: 'ID', type: 'readonly' },
+    { path: 'size.w', label: '幅', type: 'number' },
+    { path: 'size.h', label: '高さ', type: 'number' },
+    { path: 'background.color', label: '背景色', type: 'text' },
+    { path: 'border.type', label: '枠線の種類', type: 'text', options: BORDER_TYPES },
+    { 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: 'from_marker', label: '始点のマーカー', type: 'text', options: MARKER_TYPES },
+    { path: 'to_marker', label: '終点のマーカー', type: 'text', options: MARKER_TYPES },
+    { path: 'stroke.color', label: '線の色', type: 'text' },
+    { path: 'stroke.width', label: '線の太さ', type: 'number' },
+    { path: 'label.text', label: 'ラベル', type: 'text' },
+];
+// 文字だけのノード(type: TEXT)は枠・背景を描かず、本文も label ではなく text にある。
+// 本文の編集(配列・bullet)は当面スコープ外(#139)なので、該当する項目を外すだけにする。
+const TEXT_NODE_HIDDEN = new Set(['label.text', 'background.color', 'border.type', 'border.color', 'border.width']);
+/** レコードに応じた項目の一覧(線 / ノード / 文字だけのノード) */
+export function fieldsOf(record) {
+    if (isEdge(record))
+        return [...EDGE_FIELDS];
+    if (record.type === 'TEXT')
+        return NODE_FIELDS.filter(f => !TEXT_NODE_HIDDEN.has(f.path));
+    return [...NODE_FIELDS];
+}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export type { UnchiId, UnchiNodeClass, UnchiNodeLabel, UnchiNodeRecord, UnchiEdgeEnd, UnchiEdgeRecord, UnchiRecord, UnchiGraph, UnchiCollection, MergePatch, UnchiChange, UnchiMove, UnchiFieldType, UnchiField, UnchiValues, } from './types.js';
+export type { UnchiNodeKind, UnchiNodeStyle } from './defaults.js';
+export { NODE_CLASSES, BORDER_TYPES, MARKER_TYPES, NODE_STYLE_DEFAULTS, NODE_LABEL_DEFAULTS, EDGE_DEFAULTS, isEdge, classOf, kindOf, nodeStyle, edgeStyle, withDefaults, } from './defaults.js';
+export { NODES_SCHEMA, EDGES_SCHEMA, SCHEMAS } from './schema.js';
+export { check, flatten } 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":"AAUA,YAAY,EACV,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EACpG,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,GACzG,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EACL,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,aAAa,EACjG,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,GAC5D,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,GACzF,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+// model.unchi — d3.unchi(ポンチ絵)の「図ごとの知識」。描画はしない(react / d3 に依存しない)。
+//
+//   スキーマ:        SCHEMAS / NODES_SCHEMA / EDGES_SCHEMA(JSON Schema 2020-12)
+//   整合性ルール:    check(data)(id の重複・参照先の存在)
+//   既定値の補完:    withDefaults(record) / nodeStyle / edgeStyle / kindOf / classOf
+//   編集できる項目:  fieldsOf(record) / NODE_FIELDS / EDGE_FIELDS
+//   patch への変換:  movePatch(node, move) / applyPatch(record, values) / mergePatch(record, patch)
+//
+// view(d3.unchi)・インスペクタ(colonoscope)との間に横の依存は無い。組み合わせるのは利用側。
+export { NODE_CLASSES, BORDER_TYPES, MARKER_TYPES, NODE_STYLE_DEFAULTS, NODE_LABEL_DEFAULTS, EDGE_DEFAULTS, isEdge, classOf, kindOf, nodeStyle, edgeStyle, withDefaults, } from './defaults.js';
+export { NODES_SCHEMA, EDGES_SCHEMA, SCHEMAS } from './schema.js';
+export { check, flatten } 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/dist/patch.d.ts

@@ -0,0 +1,36 @@
+import type { MergePatch, UnchiChange, UnchiCollection, UnchiMove, UnchiNodeRecord, UnchiRecord, UnchiValues } from './types.js';
+/** 入力の検証エラー。message は利用者向け */
+export declare class ModelError extends Error {
+    constructor(message: string);
+}
+/** レコードを置くコレクション */
+export declare function collectionOf(record: UnchiRecord): UnchiCollection;
+/** インスペクタの見出し。ラベルの文字、無ければ「種類 id」 */
+export declare function titleOf(record: UnchiRecord): 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 から)。
+ * 子のノードの position は親の中での位置なので、親を動かしても子の patch は要らない。
+ */
+export declare function movePatch(node: UnchiNodeRecord, move: UnchiMove): UnchiChange;
+/**
+ * 色として読める文字列か。
+ * ブラウザでは CSS.supports('color', v) で判定する。Node など CSS の無い環境では、
+ * #rgb / #rrggbb / #rrggbbaa・rgb() などの関数表記・英字だけの色名、を通す緩い判定にする
+ * (色名の一覧は持たない。環境で判定が変わる点は README に書く)。
+ */
+export declare function isColor(value: string): boolean;
+/**
+ * インスペクタの「適用」の値を、保存する patch に変換する。
+ * 図に描いている値から変えた項目だけを patch に入れる(変えていない既定の値まで書き込まないため)。
+ * 変更が無ければ patch は {}。
+ */
+export declare function applyPatch(record: UnchiRecord, values: UnchiValues): UnchiChange;
+//# 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":"AAUA,OAAO,KAAK,EACV,UAAU,EAAE,WAAW,EAAE,eAAe,EAAmB,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAChH,MAAM,YAAY,CAAC;AAEpB,8BAA8B;AAC9B,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAED,oBAAoB;AACpB,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,CAEjE;AAED,oCAAoC;AACpC,wBAAgB,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAQnD;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,eAAe,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,CAa7E;AAWD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAY9C;AAiKD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,WAAW,CAMhF"}