@yanqirenshi/model.deployment 0.0.0-stage → 0.1.1

package/dist/schema.d.ts

@@ -0,0 +1,274 @@
+export declare const NODES_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly title: "システム構成図のノード";
+    readonly description: "d3.deployment に渡すノード。children に子のノードを入れ子で持つ。id は子のノードも含めて一意にする。position は親の中での位置で、ドラッグで動かすと書き換わる。link を付けると、ノードの左下にリンクを出す。見た目の項目 (label・padding・border・background・description) は d3.deployment の入力の形のまま書ける。";
+    readonly 'x-id-start': 1;
+    readonly type: "array";
+    readonly items: {
+        readonly $ref: "#/$defs/node";
+    };
+    readonly $defs: {
+        readonly node: {
+            readonly type: "object";
+            readonly properties: {
+                readonly id: {
+                    readonly type: readonly ["integer", "string"];
+                };
+                readonly type: {
+                    readonly enum: readonly import("./types.js").DeploymentNodeType[];
+                };
+                readonly label: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly text: {
+                            readonly type: readonly ["string", "null"];
+                        };
+                    };
+                };
+                readonly description: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly size: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly w: {
+                            readonly type: "number";
+                            readonly minimum: 0;
+                        };
+                        readonly h: {
+                            readonly type: "number";
+                            readonly minimum: 0;
+                        };
+                    };
+                    readonly required: readonly ["w", "h"];
+                };
+                readonly position: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly x: {
+                            readonly type: "number";
+                        };
+                        readonly y: {
+                            readonly type: "number";
+                        };
+                    };
+                    readonly required: readonly ["x", "y"];
+                };
+                readonly link: {
+                    readonly type: readonly ["object", "null"];
+                    readonly properties: {
+                        readonly url: {
+                            readonly type: readonly ["string", "null"];
+                        };
+                    };
+                };
+                readonly children: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/node";
+                    };
+                };
+            };
+            readonly required: readonly ["id"];
+            readonly additionalProperties: true;
+        };
+    };
+};
+export declare const EDGES_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly title: "システム構成図の線";
+    readonly description: "ノードの間の線。from.id / to.id はノード (子を含む) の id。position は接続位置の角度 (0=真下・時計回り。省略すると 90=左)。stroke.marker は両端の矢印の有無 (既定: 終点だけ)。";
+    readonly 'x-id-start': 100;
+    readonly type: "array";
+    readonly items: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: readonly ["integer", "string"];
+            };
+            readonly from: {
+                readonly $ref: "#/$defs/end";
+            };
+            readonly to: {
+                readonly $ref: "#/$defs/end";
+            };
+            readonly stroke: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly color: {
+                        readonly type: "string";
+                    };
+                    readonly width: {
+                        readonly type: "number";
+                    };
+                    readonly marker: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly start: {
+                                readonly type: "boolean";
+                            };
+                            readonly end: {
+                                readonly type: "boolean";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly required: readonly ["id", "from", "to"];
+        readonly additionalProperties: true;
+    };
+    readonly $defs: {
+        readonly end: {
+            readonly type: "object";
+            readonly properties: {
+                readonly id: {
+                    readonly type: readonly ["integer", "string"];
+                };
+                readonly position: {
+                    readonly type: "number";
+                };
+            };
+            readonly required: readonly ["id"];
+        };
+    };
+};
+/** コレクション名 → スキーマ */
+export declare const SCHEMAS: {
+    readonly nodes: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly title: "システム構成図のノード";
+        readonly description: "d3.deployment に渡すノード。children に子のノードを入れ子で持つ。id は子のノードも含めて一意にする。position は親の中での位置で、ドラッグで動かすと書き換わる。link を付けると、ノードの左下にリンクを出す。見た目の項目 (label・padding・border・background・description) は d3.deployment の入力の形のまま書ける。";
+        readonly 'x-id-start': 1;
+        readonly type: "array";
+        readonly items: {
+            readonly $ref: "#/$defs/node";
+        };
+        readonly $defs: {
+            readonly node: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: readonly ["integer", "string"];
+                    };
+                    readonly type: {
+                        readonly enum: readonly import("./types.js").DeploymentNodeType[];
+                    };
+                    readonly label: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly text: {
+                                readonly type: readonly ["string", "null"];
+                            };
+                        };
+                    };
+                    readonly description: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly size: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly w: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                            };
+                            readonly h: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                            };
+                        };
+                        readonly required: readonly ["w", "h"];
+                    };
+                    readonly position: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                            };
+                        };
+                        readonly required: readonly ["x", "y"];
+                    };
+                    readonly link: {
+                        readonly type: readonly ["object", "null"];
+                        readonly properties: {
+                            readonly url: {
+                                readonly type: readonly ["string", "null"];
+                            };
+                        };
+                    };
+                    readonly children: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/node";
+                        };
+                    };
+                };
+                readonly required: readonly ["id"];
+                readonly additionalProperties: true;
+            };
+        };
+    };
+    readonly edges: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly title: "システム構成図の線";
+        readonly description: "ノードの間の線。from.id / to.id はノード (子を含む) の id。position は接続位置の角度 (0=真下・時計回り。省略すると 90=左)。stroke.marker は両端の矢印の有無 (既定: 終点だけ)。";
+        readonly 'x-id-start': 100;
+        readonly type: "array";
+        readonly items: {
+            readonly type: "object";
+            readonly properties: {
+                readonly id: {
+                    readonly type: readonly ["integer", "string"];
+                };
+                readonly from: {
+                    readonly $ref: "#/$defs/end";
+                };
+                readonly to: {
+                    readonly $ref: "#/$defs/end";
+                };
+                readonly stroke: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly color: {
+                            readonly type: "string";
+                        };
+                        readonly width: {
+                            readonly type: "number";
+                        };
+                        readonly marker: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly start: {
+                                    readonly type: "boolean";
+                                };
+                                readonly end: {
+                                    readonly type: "boolean";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            readonly required: readonly ["id", "from", "to"];
+            readonly additionalProperties: true;
+        };
+        readonly $defs: {
+            readonly end: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: readonly ["integer", "string"];
+                    };
+                    readonly position: {
+                        readonly type: "number";
+                    };
+                };
+                readonly required: readonly ["id"];
+            };
+        };
+    };
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCf,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCf,CAAC;AAEX,qBAAqB;AACrB,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGV,CAAC"}

package/dist/schema.js

@@ -0,0 +1,94 @@
+// d3.deployment の入力データの JSON Schema(2020-12)。
+//
+// iHub の server/schemas/deployment/{nodes,edges}.schema.json を移したもの。
+// 検査するのは、図の構造にかかわる項目(id・type・size・position・children・link、線の from / to)だけで、
+// 見た目の項目(label・border・background・padding・description)は d3.deployment の入力の形のまま書けるよう
+// additionalProperties を閉じていない(iHub 版は閉じていた)。
+//
+// x-id-start はスキーマの検証には使わない注釈(コレクションが空のときに最初に振る id)。
+// Ajv で使うときは addKeyword({ keyword: 'x-id-start', schemaType: 'number' }) を足す。
+import { NODE_TYPES } from './defaults.js';
+const ID = { type: ['integer', 'string'] };
+const POINT = {
+    type: 'object',
+    properties: { x: { type: 'number' }, y: { type: 'number' } },
+    required: ['x', 'y'],
+};
+export const NODES_SCHEMA = {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    title: 'システム構成図のノード',
+    description: 'd3.deployment に渡すノード。children に子のノードを入れ子で持つ。id は子のノードも含めて一意にする。position は親の中での位置で、ドラッグで動かすと書き換わる。link を付けると、ノードの左下にリンクを出す。見た目の項目 (label・padding・border・background・description) は d3.deployment の入力の形のまま書ける。',
+    'x-id-start': 1,
+    type: 'array',
+    items: { $ref: '#/$defs/node' },
+    $defs: {
+        node: {
+            type: 'object',
+            properties: {
+                id: ID,
+                type: { enum: [...NODE_TYPES] },
+                label: {
+                    type: 'object',
+                    properties: { text: { type: ['string', 'null'] } },
+                },
+                description: { type: ['string', 'null'] },
+                size: {
+                    type: 'object',
+                    properties: { w: { type: 'number', minimum: 0 }, h: { type: 'number', minimum: 0 } },
+                    required: ['w', 'h'],
+                },
+                position: POINT,
+                link: {
+                    type: ['object', 'null'],
+                    properties: { url: { type: ['string', 'null'] } },
+                },
+                children: { type: 'array', items: { $ref: '#/$defs/node' } },
+            },
+            required: ['id'],
+            additionalProperties: true,
+        },
+    },
+};
+export const EDGES_SCHEMA = {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    title: 'システム構成図の線',
+    description: 'ノードの間の線。from.id / to.id はノード (子を含む) の id。position は接続位置の角度 (0=真下・時計回り。省略すると 90=左)。stroke.marker は両端の矢印の有無 (既定: 終点だけ)。',
+    'x-id-start': 100,
+    type: 'array',
+    items: {
+        type: 'object',
+        properties: {
+            id: ID,
+            from: { $ref: '#/$defs/end' },
+            to: { $ref: '#/$defs/end' },
+            stroke: {
+                type: 'object',
+                properties: {
+                    color: { type: 'string' },
+                    width: { type: 'number' },
+                    marker: {
+                        type: 'object',
+                        properties: { start: { type: 'boolean' }, end: { type: 'boolean' } },
+                    },
+                },
+            },
+        },
+        required: ['id', 'from', 'to'],
+        additionalProperties: true,
+    },
+    $defs: {
+        end: {
+            type: 'object',
+            properties: {
+                id: ID,
+                position: { type: 'number' },
+            },
+            required: ['id'],
+        },
+    },
+};
+/** コレクション名 → スキーマ */
+export const SCHEMAS = {
+    nodes: NODES_SCHEMA,
+    edges: EDGES_SCHEMA,
+};

package/dist/types.d.ts

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

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,6 @@
+// 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)。
+export {};

package/package.json

@@ -1,6 +1,56 @@
 {
-  "name": "@yanqirenshi/model.deployment",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "name": "@yanqirenshi/model.deployment",
+    "version": "0.1.1",
+    "description": "Diagram model for deployment diagrams (d3.deployment) — JSON Schema, consistency rules, drawing defaults, editable fields and patch conversion. Pure data and functions: no React / d3 dependency",
+    "type": "module",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "require": "./dist/cjs/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "src"
+    ],
+    "scripts": {
+        "build": "tsc && tsc -p tsconfig.cjs.json && node scripts/cjs-package.cjs",
+        "typecheck": "tsc --noEmit",
+        "test": "vitest run",
+        "prepare": "npm run build",
+        "prepublishOnly": "npm run build"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Foolsgolds/Assholes.git",
+        "directory": "packages/model.deployment"
+    },
+    "bugs": {
+        "url": "https://github.com/Foolsgolds/Assholes/issues"
+    },
+    "homepage": "https://github.com/Foolsgolds/Assholes/tree/main/packages/model.deployment#readme",
+    "publishConfig": {
+        "access": "public"
+    },
+    "dependencies": {
+        "@yanqirenshi/model.core": "^0.1.0",
+        "@yanqirenshi/types": "^0.1.2"
+    },
+    "devDependencies": {
+        "typescript": "~5.9.3",
+        "vitest": "^2.1.8"
+    },
+    "author": "yanqirenshi@gmail.com",
+    "keywords": [
+        "diagram",
+        "model",
+        "json-schema",
+        "deployment",
+        "d3.deployment"
+    ],
+    "license": "MIT"
+}

package/src/check.ts

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