@yanqirenshi/model.core 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,67 @@
-# Temporary Holding Version
+# @yanqirenshi/model.core
 
-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.
+図ごとのモデル(`@yanqirenshi/model.*`)が共通で使う部品です。
+react / d3 に依存しない、純粋な関数だけを持ちます。
+
+| 持つもの | 入口 |
+|---|---|
+| 入力の検証エラー(利用者向けのメッセージ) | `ModelError` |
+| JSON Merge Patch(RFC 7386)の道具 | `mergePatch(record, patch)` / `getByPath(obj, path)` / `put(patch, path, value)` |
+| ドラッグの移動量を position の patch にする | `movePatch(record, move, collection)` |
+| インスペクタの入力のうち、描いている値から変わった項目だけ | `changedValues(effective, values, fields)` |
+| インスペクタの入力(文字列)の読み取り | `isColor` / `toColor` / `toWidth` / `toLength` / `toDegree` / `toOption` / `toOptionNumber` / `toOptionNumberOrNull` / `toBoolean` / `toOptionalText` / `toNumber` |
+| ノードと線の図(graph 系)に共通の整合性ルール | `checkGraph(data, prefix)` / `flattenNodes` / `checkUnique` / `findById` |
+
+## 位置づけ
+
+```
+利用側(iHub / デモ) ──▶ model.unchi / model.er / model.tm / model.sitemap / model.deployment ──▶ model.core
+```
+
+**利用側がこのパッケージを直接 import する必要はありません。**
+各 model.* が `ModelError` / `mergePatch` / `getByPath` / `isColor` を再 export し、`check` / `movePatch` には自分の型を付けて公開しています。
+図ごとの知識(JSON Schema・`withDefaults`・`fieldsOf`・図ごとの `check`・`applyPatch`)は各 model.* にあり、ここには置きません。
+
+[Foolsgolds/Assholes#151](https://github.com/Foolsgolds/Assholes/issues/151) で、5 つの model.* に複製されていた部分を切り出したものです。
+
+## 各 model.* から使うとき
+
+```ts
+import {
+  ModelError, changedValues, movePatch, put, toColor, toLength, toWidth,
+} from '@yanqirenshi/model.core';
+
+// 読み取り部品は、図ごとの規則の違いを引数で受ける
+toWidth(value, '枠線の太さ');                       // 0 より大きい数(0 は view が既定に倒すとき)
+toWidth(value, '枠線の太さ', { allowZero: true }); // 0 以上(0 = 線なし)
+toLength(value, '幅', { min: 1 });                 // 「幅は 1 以上の数で入力してください。」
+toLength(value, '幅', { hint: '(0 で子に合わせる)' });
+
+// ドラッグの終わり → patch(collection は図ごとに固定して公開する)
+export function movePatchForMyDiagram(node, move) { return movePatch(node, move, 'nodes'); }
+
+// 適用 → 変わった項目だけを読み取って patch にする
+for (const [path, value] of changedValues(withDefaults(record), values, fieldsOf(record))) {
+  switch (path) {
+    case 'border.color': put(patch, path, toColor(value, '枠線の色')); break;
+    // ...
+  }
+}
+```
+
+読み取り部品が投げる `ModelError` の文言は、各 model.* のテストが見ているものと同じです(`tests/read.test.ts`)。
+
+## 配布形式
+
+ESM(`dist/`)に加えて CommonJS 版(`dist/cjs/`)も出します。
+各 model.* の CommonJS 版(Babel 系の view を jest で試験するためのもの)がこれを `require` するためで、すべての model.* が CommonJS 版を出さなくなったら外せます。
+
+## コマンド
+
+```bash
+npm run build     -w @yanqirenshi/model.core   # tsc で dist/(ESM + d.ts)と dist/cjs/(CommonJS)へビルド
+npm run typecheck -w @yanqirenshi/model.core
+npm test          -w @yanqirenshi/model.core   # vitest
+```
+
+各 model.* のビルド・テスト・Babel 系 view の jest は、このパッケージの `dist/` を先に作っておく必要があります(`npm install` の `prepare` で作られます)。

package/dist/cjs/error.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelError = void 0;
+/**
+ * 入力の検証エラー。message は利用者にそのまま見せられる日本語。
+ * 各 model.* はこれを再 export するので、どの model.* の ModelError も同じクラス(instanceof で判別できる)。
+ * 使い方の誤り(マスタなのに collection を渡していない、など)はこれではなく Error にする。
+ */
+class ModelError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ModelError';
+    }
+}
+exports.ModelError = ModelError;

package/dist/cjs/graph.js

@@ -0,0 +1,55 @@
+"use strict";
+// コレクションをまたぐ整合性の検査と、レコードの検索。
+//
+// checkGraph は、ノードと線の図(graph 系: unchi / sitemap / deployment)に共通の検査で、
+// iHub の server/validation/rules.mjs の checkGraph と同じ検査・同じ文言。
+// checkUnique / findById は階層形式(er / tm)の check からも使う。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flattenNodes = flattenNodes;
+exports.checkUnique = checkUnique;
+exports.checkGraph = checkGraph;
+exports.findById = findById;
+/** 入れ子のノード(children)を平らにする(親 → 子 の順) */
+function flattenNodes(nodes) {
+    return nodes.flatMap(node => [node, ...flattenNodes((node.children || []))]);
+}
+/** list の中で id が重複していれば errors に足す。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/' → 'overview/nodes: ...')
+ */
+function checkGraph(data, prefix = '') {
+    const errors = [];
+    const node_ids = checkUnique(errors, `${prefix}nodes`, flattenNodes(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;
+}
+/** レコードを id で探す(無ければ null)。children があれば子も探す */
+function findById(list, id) {
+    for (const d of list || []) {
+        if (d.id === id)
+            return d;
+        const children = d.children;
+        const hit = children ? findById(children, id) : null;
+        if (hit)
+            return hit;
+    }
+    return null;
+}

package/dist/cjs/index.js

@@ -0,0 +1,39 @@
+"use strict";
+// model.core — 図ごとのモデル(@yanqirenshi/model.*)が共通で使う部品。描画はしない(react / d3 に依存しない)。
+//
+//   エラー:              ModelError(利用者向けのメッセージを持つ検証エラー)
+//   patch の道具:        getByPath / mergePatch(JSON Merge Patch)/ put / movePatch(record, move, collection) / changedValues
+//   入力の読み取り:      isColor / toNumber / toColor / toWidth / toLength / toDegree / toOption / toOptionNumber /
+//                        toOptionNumberOrNull / toBoolean / toOptionalText
+//   graph 系の検査:      checkGraph(data, prefix) / flattenNodes / checkUnique / findById
+//
+// 図ごとの知識(スキーマ・withDefaults・fieldsOf・図ごとの check・applyPatch)は各 model.* にある。
+// 利用側(iHub やデモ)は各 model.* を読めばよく、このパッケージを直接 import する必要は無い
+// (各 model.* が ModelError / mergePatch / getByPath などを再 export する)。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findById = exports.checkGraph = exports.checkUnique = exports.flattenNodes = exports.toOptionalText = exports.toBoolean = exports.toOptionNumberOrNull = exports.toOptionNumber = exports.toOption = exports.toDegree = exports.toLength = exports.toWidth = exports.toColor = exports.isColor = exports.toNumber = exports.changedValues = exports.movePatch = exports.put = exports.mergePatch = exports.getByPath = exports.ModelError = void 0;
+var error_js_1 = require("./error.js");
+Object.defineProperty(exports, "ModelError", { enumerable: true, get: function () { return error_js_1.ModelError; } });
+var patch_js_1 = require("./patch.js");
+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, "put", { enumerable: true, get: function () { return patch_js_1.put; } });
+Object.defineProperty(exports, "movePatch", { enumerable: true, get: function () { return patch_js_1.movePatch; } });
+Object.defineProperty(exports, "changedValues", { enumerable: true, get: function () { return patch_js_1.changedValues; } });
+var read_js_1 = require("./read.js");
+Object.defineProperty(exports, "toNumber", { enumerable: true, get: function () { return read_js_1.toNumber; } });
+Object.defineProperty(exports, "isColor", { enumerable: true, get: function () { return read_js_1.isColor; } });
+Object.defineProperty(exports, "toColor", { enumerable: true, get: function () { return read_js_1.toColor; } });
+Object.defineProperty(exports, "toWidth", { enumerable: true, get: function () { return read_js_1.toWidth; } });
+Object.defineProperty(exports, "toLength", { enumerable: true, get: function () { return read_js_1.toLength; } });
+Object.defineProperty(exports, "toDegree", { enumerable: true, get: function () { return read_js_1.toDegree; } });
+Object.defineProperty(exports, "toOption", { enumerable: true, get: function () { return read_js_1.toOption; } });
+Object.defineProperty(exports, "toOptionNumber", { enumerable: true, get: function () { return read_js_1.toOptionNumber; } });
+Object.defineProperty(exports, "toOptionNumberOrNull", { enumerable: true, get: function () { return read_js_1.toOptionNumberOrNull; } });
+Object.defineProperty(exports, "toBoolean", { enumerable: true, get: function () { return read_js_1.toBoolean; } });
+Object.defineProperty(exports, "toOptionalText", { enumerable: true, get: function () { return read_js_1.toOptionalText; } });
+var graph_js_1 = require("./graph.js");
+Object.defineProperty(exports, "flattenNodes", { enumerable: true, get: function () { return graph_js_1.flattenNodes; } });
+Object.defineProperty(exports, "checkUnique", { enumerable: true, get: function () { return graph_js_1.checkUnique; } });
+Object.defineProperty(exports, "checkGraph", { enumerable: true, get: function () { return graph_js_1.checkGraph; } });
+Object.defineProperty(exports, "findById", { enumerable: true, get: function () { return graph_js_1.findById; } });

package/dist/cjs/package.json

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

package/dist/cjs/patch.js

@@ -0,0 +1,81 @@
+"use strict";
+// patch(JSON Merge Patch)を扱う道具。各 model.* の applyPatch / movePatch はこれを組み合わせて作る。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getByPath = getByPath;
+exports.mergePatch = mergePatch;
+exports.put = put;
+exports.movePatch = movePatch;
+exports.changedValues = changedValues;
+/** ドット区切りの 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 の入れ子に値を置く(put(patch, 'border.color', v) で 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;
+}
+/**
+ * ドラッグで動かしたレコードの位置を保存する patch。
+ * 保存してある position に移動量を足し、整数に丸める(position が無いときは 0, 0 から)。x / y 以外(z など)は触らない。
+ * 入れ子のノードの position は親の中での位置なので、親を動かしても子の patch は要らない。
+ *
+ * @param collection 保存先(graph 系は 'nodes'、階層形式は 'entities')
+ */
+function movePatch(record, move, collection) {
+    const base = record.position || { x: 0, y: 0 };
+    return {
+        collection,
+        id: record.id,
+        patch: {
+            position: {
+                x: Math.round(base.x + move.dx),
+                y: Math.round(base.y + move.dy),
+            },
+        },
+    };
+}
+/**
+ * インスペクタの入力のうち、図に描いている値(effective = withDefaults で埋めたレコード)から変わった項目だけを返す。
+ * 前後の空白は除く。読み取り専用の項目と、values に無い項目は含めない。
+ */
+function changedValues(effective, values, fields) {
+    const out = new Map();
+    for (const field of fields) {
+        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;
+}

package/dist/cjs/read.js

@@ -0,0 +1,108 @@
+"use strict";
+// インスペクタの入力(文字列)を、保存する値に読み取る部品。
+// 読めないときは ModelError を投げる(メッセージは利用者にそのまま見せられる日本語。label は項目の名前)。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toNumber = toNumber;
+exports.isColor = isColor;
+exports.toColor = toColor;
+exports.toWidth = toWidth;
+exports.toLength = toLength;
+exports.toDegree = toDegree;
+exports.toOption = toOption;
+exports.toOptionNumber = toOptionNumber;
+exports.toOptionNumberOrNull = toOptionNumberOrNull;
+exports.toBoolean = toBoolean;
+exports.toOptionalText = toOptionalText;
+const error_js_1 = require("./error.js");
+/** 入力した文字列を数にする。数でない(空を含む)ときは null */
+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);
+}
+/** 色(isColor) */
+function toColor(value, label) {
+    if (!isColor(value))
+        throw new error_js_1.ModelError(`${label}は、色 (#ff0000 や red など) で入力してください。`);
+    return value;
+}
+/**
+ * 線の太さ。既定は 0 より大きい数(view が 0 を「書いていない」と見て既定に倒すとき)。
+ * allowZero で 0 以上(0 = 線なし)にできる。整数には丸めない。
+ */
+function toWidth(value, label, options = {}) {
+    const n = toNumber(value);
+    if (options.allowZero) {
+        if (n === null || n < 0)
+            throw new error_js_1.ModelError(`${label}は、0 以上の数で入力してください。`);
+    }
+    else if (n === null || n <= 0) {
+        throw new error_js_1.ModelError(`${label}は、0 より大きい数で入力してください。`);
+    }
+    return n;
+}
+/**
+ * 幅・高さ(min 以上の整数に丸める)。
+ * min は既定 0。0 に意味があるとき(「子に合わせる」など)は hint に書くとメッセージの末尾に付く。
+ */
+function toLength(value, label, options = {}) {
+    const min = options.min ?? 0;
+    const n = toNumber(value);
+    if (n === null || n < min)
+        throw new error_js_1.ModelError(`${label}は ${min} 以上の数で入力してください。${options.hint ?? ''}`);
+    return Math.round(n);
+}
+/** 角度(0 以上 360 未満の整数に正規化) */
+function toDegree(value, label) {
+    const n = toNumber(value);
+    if (n === null)
+        throw new error_js_1.ModelError(`${label}は、角度 (数) で入力してください。`);
+    return ((Math.round(n) % 360) + 360) % 360;
+}
+/** 候補の中の文字列 */
+function toOption(value, options, label) {
+    if (!options.includes(value))
+        throw new error_js_1.ModelError(`${label}は、${options.join(' / ')} のどれかで入力してください。`);
+    return value;
+}
+/** 候補の中の数(カーディナリティ・オプショナリティなど) */
+function toOptionNumber(value, options, label) {
+    const n = toNumber(value);
+    if (n === null || !options.includes(n))
+        throw new error_js_1.ModelError(`${label}は、${options.join(' / ')} のどれかで入力してください。`);
+    return n;
+}
+/** 候補の中の数、または空(null = 項目を除く) */
+function toOptionNumberOrNull(value, options, label) {
+    if (value === '')
+        return null;
+    const n = toNumber(value);
+    if (n === null || !options.includes(n))
+        throw new error_js_1.ModelError(`${label}は、${options.join(' / ')} のどれか (または空) で入力してください。`);
+    return n;
+}
+/** true / false */
+function toBoolean(value, label) {
+    if (value !== 'true' && value !== 'false')
+        throw new error_js_1.ModelError(`${label}は、true / false のどちらかで入力してください。`);
+    return value === 'true';
+}
+/** 空にできる文字列。空なら null(JSON Merge Patch で項目を除く) */
+function toOptionalText(value) {
+    return value === '' ? null : value;
+}

package/dist/cjs/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// model.core の公開型。各 model.*(unchi / er / tm / sitemap / deployment)はこれをエイリアスで公開する
+// (UnchiMove = ModelMove のように。公開 API 名は各 model.* のまま)。
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/error.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 入力の検証エラー。message は利用者にそのまま見せられる日本語。
+ * 各 model.* はこれを再 export するので、どの model.* の ModelError も同じクラス(instanceof で判別できる)。
+ * 使い方の誤り(マスタなのに collection を渡していない、など)はこれではなく Error にする。
+ */
+export declare class ModelError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B"}

package/dist/error.js

@@ -0,0 +1,11 @@
+/**
+ * 入力の検証エラー。message は利用者にそのまま見せられる日本語。
+ * 各 model.* はこれを再 export するので、どの model.* の ModelError も同じクラス(instanceof で判別できる)。
+ * 使い方の誤り(マスタなのに collection を渡していない、など)はこれではなく Error にする。
+ */
+export class ModelError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ModelError';
+    }
+}

package/dist/graph.d.ts

@@ -0,0 +1,21 @@
+import type { Graph, GraphNode, ModelId } from './types.js';
+/** 入れ子のノード(children)を平らにする(親 → 子 の順) */
+export declare function flattenNodes<N extends GraphNode>(nodes: readonly N[]): N[];
+/** list の中で id が重複していれば errors に足す。id の集合を返す */
+export declare function checkUnique(errors: string[], label: string, list: readonly {
+    id: ModelId;
+}[]): Set<ModelId>;
+/**
+ * ノードと線の図を検査する。戻り値はエラーのメッセージの配列(空なら問題なし)。
+ *   - nodes(子を含む)の id が重複していない
+ *   - edges の id が重複していない
+ *   - edges の from.id / to.id がノードに存在する
+ *
+ * @param prefix メッセージのコレクション名の前に付ける文字列(例: 'overview/' → 'overview/nodes: ...')
+ */
+export declare function checkGraph(data: Graph, prefix?: string): string[];
+/** レコードを id で探す(無ければ null)。children があれば子も探す */
+export declare function findById<T extends {
+    id: ModelId;
+}>(list: readonly T[] | null | undefined, id: ModelId): T | null;
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5D,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAE1E;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS;IAAE,EAAE,EAAE,OAAO,CAAA;CAAE,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,CAW3G;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,SAAK,GAAG,MAAM,EAAE,CAa7D;AAED,gDAAgD;AAChD,wBAAgB,QAAQ,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,OAAO,CAAA;CAAE,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,CAAC,GAAG,IAAI,CAahH"}

package/dist/graph.js

@@ -0,0 +1,49 @@
+// コレクションをまたぐ整合性の検査と、レコードの検索。
+//
+// checkGraph は、ノードと線の図(graph 系: unchi / sitemap / deployment)に共通の検査で、
+// iHub の server/validation/rules.mjs の checkGraph と同じ検査・同じ文言。
+// checkUnique / findById は階層形式(er / tm)の check からも使う。
+/** 入れ子のノード(children)を平らにする(親 → 子 の順) */
+export function flattenNodes(nodes) {
+    return nodes.flatMap(node => [node, ...flattenNodes((node.children || []))]);
+}
+/** list の中で id が重複していれば errors に足す。id の集合を返す */
+export 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/' → 'overview/nodes: ...')
+ */
+export function checkGraph(data, prefix = '') {
+    const errors = [];
+    const node_ids = checkUnique(errors, `${prefix}nodes`, flattenNodes(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;
+}
+/** レコードを id で探す(無ければ null)。children があれば子も探す */
+export function findById(list, id) {
+    for (const d of list || []) {
+        if (d.id === id)
+            return d;
+        const children = d.children;
+        const hit = children ? findById(children, id) : null;
+        if (hit)
+            return hit;
+    }
+    return null;
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { ModelId, MergePatch, ModelChange, ModelMove, ModelFieldType, ModelField, ModelValues, Positioned, GraphNode, GraphEdge, Graph, } from './types.js';
+export { ModelError } from './error.js';
+export { getByPath, mergePatch, put, movePatch, changedValues } from './patch.js';
+export { toNumber, isColor, toColor, toWidth, toLength, toDegree, toOption, toOptionNumber, toOptionNumberOrNull, toBoolean, toOptionalText, } from './read.js';
+export { flattenNodes, checkUnique, checkGraph, findById } from './graph.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,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAChG,SAAS,EAAE,SAAS,EAAE,KAAK,GAC5B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EACL,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,oBAAoB,EAAE,SAAS,EAClH,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+// model.core — 図ごとのモデル(@yanqirenshi/model.*)が共通で使う部品。描画はしない(react / d3 に依存しない)。
+//
+//   エラー:              ModelError(利用者向けのメッセージを持つ検証エラー)
+//   patch の道具:        getByPath / mergePatch(JSON Merge Patch)/ put / movePatch(record, move, collection) / changedValues
+//   入力の読み取り:      isColor / toNumber / toColor / toWidth / toLength / toDegree / toOption / toOptionNumber /
+//                        toOptionNumberOrNull / toBoolean / toOptionalText
+//   graph 系の検査:      checkGraph(data, prefix) / flattenNodes / checkUnique / findById
+//
+// 図ごとの知識(スキーマ・withDefaults・fieldsOf・図ごとの check・applyPatch)は各 model.* にある。
+// 利用側(iHub やデモ)は各 model.* を読めばよく、このパッケージを直接 import する必要は無い
+// (各 model.* が ModelError / mergePatch / getByPath などを再 export する)。
+export { ModelError } from './error.js';
+export { getByPath, mergePatch, put, movePatch, changedValues } from './patch.js';
+export { toNumber, isColor, toColor, toWidth, toLength, toDegree, toOption, toOptionNumber, toOptionNumberOrNull, toBoolean, toOptionalText, } from './read.js';
+export { flattenNodes, checkUnique, checkGraph, findById } from './graph.js';

package/dist/patch.d.ts

@@ -0,0 +1,24 @@
+import type { MergePatch, ModelChange, ModelField, ModelMove, ModelValues, Positioned } from './types.js';
+/** ドット区切りの 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 の入れ子に値を置く(put(patch, 'border.color', v) で patch.border.color = v) */
+export declare function put(patch: MergePatch, path: string, value: unknown): void;
+/**
+ * ドラッグで動かしたレコードの位置を保存する patch。
+ * 保存してある position に移動量を足し、整数に丸める(position が無いときは 0, 0 から)。x / y 以外(z など)は触らない。
+ * 入れ子のノードの position は親の中での位置なので、親を動かしても子の patch は要らない。
+ *
+ * @param collection 保存先(graph 系は 'nodes'、階層形式は 'entities')
+ */
+export declare function movePatch<C extends string>(record: Positioned, move: ModelMove, collection: C): ModelChange<C>;
+/**
+ * インスペクタの入力のうち、図に描いている値(effective = withDefaults で埋めたレコード)から変わった項目だけを返す。
+ * 前後の空白は除く。読み取り専用の項目と、values に無い項目は含めない。
+ */
+export declare function changedValues(effective: object, values: ModelValues, fields: readonly ModelField[]): Map<string, string>;
+//# 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":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1G,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,8EAA8E;AAC9E,wBAAgB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAYzE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAa9G;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBxH"}

package/dist/patch.js

@@ -0,0 +1,74 @@
+// patch(JSON Merge Patch)を扱う道具。各 model.* の applyPatch / movePatch はこれを組み合わせて作る。
+/** ドット区切りの path で値を取り出す */
+export function getByPath(obj, path) {
+    return path.split('.').reduce((acc, key) => (acc == null ? acc : acc[key]), obj);
+}
+/**
+ * JSON Merge Patch をレコードに重ねたものを返す(入力は書き換えない)。
+ * null の項目は除く。保存したあと、表示を先に更新するときに使う。
+ */
+export function mergePatch(record, patch) {
+    const out = { ...record };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === null) {
+            delete out[key];
+        }
+        else if (typeof value === 'object' && !Array.isArray(value)) {
+            const base = out[key];
+            out[key] = mergePatch(base && typeof base === 'object' && !Array.isArray(base) ? base : {}, value);
+        }
+        else {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+/** patch の入れ子に値を置く(put(patch, 'border.color', v) で patch.border.color = v) */
+export 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;
+}
+/**
+ * ドラッグで動かしたレコードの位置を保存する patch。
+ * 保存してある position に移動量を足し、整数に丸める(position が無いときは 0, 0 から)。x / y 以外(z など)は触らない。
+ * 入れ子のノードの position は親の中での位置なので、親を動かしても子の patch は要らない。
+ *
+ * @param collection 保存先(graph 系は 'nodes'、階層形式は 'entities')
+ */
+export function movePatch(record, move, collection) {
+    const base = record.position || { x: 0, y: 0 };
+    return {
+        collection,
+        id: record.id,
+        patch: {
+            position: {
+                x: Math.round(base.x + move.dx),
+                y: Math.round(base.y + move.dy),
+            },
+        },
+    };
+}
+/**
+ * インスペクタの入力のうち、図に描いている値(effective = withDefaults で埋めたレコード)から変わった項目だけを返す。
+ * 前後の空白は除く。読み取り専用の項目と、values に無い項目は含めない。
+ */
+export function changedValues(effective, values, fields) {
+    const out = new Map();
+    for (const field of fields) {
+        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;
+}