@yanqirenshi/model.tm 0.0.0-stage → 0.1.0

package/dist/cjs/index.js

@@ -0,0 +1,55 @@
+"use strict";
+// model.tm — TM(T字形ER。d3.ter)の「図ごとの知識」。描画はしない(react / d3 に依存しない)。
+//
+//   スキーマ:        SCHEMAS / *_SCHEMA(JSON Schema 2020-12。4 コレクション)
+//   整合性ルール:    check(data)(id の重複・参照先の存在・CLASS と mapping の結線の規則)
+//   既定値の補完:    withDefaults(record) / entityWithDefaults / relationshipWithDefaults / kindOf / nameOf
+//                    種別の表示: ENTITY_TYPES / TYPE_BADGES / TYPE_COLORS(d3.ter が読む)
+//   編集できる項目:  fieldsOf(record, collection?) / nameFields / ENTITY_FIELDS / RELATIONSHIP_FIELDS / MASTER_FIELDS
+//   patch への変換:  movePatch(entity, move) / applyPatch(record, values, collection?) / mergePatch(record, patch)
+//
+// view(d3.ter)はこのパッケージの既定値(種別バッジ・配色・角度)を読む。インスペクタ(colonoscope)との間に横の依存は無い。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyPatch = exports.movePatch = exports.mergePatch = exports.getByPath = exports.titleOf = exports.collectionOf = exports.ModelError = exports.fieldsOf = exports.nameFields = exports.MASTER_FIELDS = exports.RELATIONSHIP_FIELDS = exports.ENTITY_FIELDS = exports.findById = exports.check = exports.RELATIONSHIPS_SCHEMA = exports.ENTITIES_SCHEMA = exports.ATTRIBUTES_SCHEMA = exports.IDENTIFIERS_SCHEMA = exports.SCHEMAS = exports.withDefaults = exports.relationshipWithDefaults = exports.entityWithDefaults = exports.endWithDefaults = exports.nameOf = exports.kindOf = exports.isEntity = exports.isRelationship = exports.isEntityType = exports.RELATIONSHIP_DEFAULTS = exports.ENTITY_DEFAULTS = exports.OPTIONALITIES = exports.CARDINALITIES = exports.SUBSET_KINDS = exports.MAPPING_TYPES = exports.TYPE_COLORS = exports.TYPE_BADGES = exports.ENTITY_TYPES = void 0;
+var defaults_js_1 = require("./defaults.js");
+Object.defineProperty(exports, "ENTITY_TYPES", { enumerable: true, get: function () { return defaults_js_1.ENTITY_TYPES; } });
+Object.defineProperty(exports, "TYPE_BADGES", { enumerable: true, get: function () { return defaults_js_1.TYPE_BADGES; } });
+Object.defineProperty(exports, "TYPE_COLORS", { enumerable: true, get: function () { return defaults_js_1.TYPE_COLORS; } });
+Object.defineProperty(exports, "MAPPING_TYPES", { enumerable: true, get: function () { return defaults_js_1.MAPPING_TYPES; } });
+Object.defineProperty(exports, "SUBSET_KINDS", { enumerable: true, get: function () { return defaults_js_1.SUBSET_KINDS; } });
+Object.defineProperty(exports, "CARDINALITIES", { enumerable: true, get: function () { return defaults_js_1.CARDINALITIES; } });
+Object.defineProperty(exports, "OPTIONALITIES", { enumerable: true, get: function () { return defaults_js_1.OPTIONALITIES; } });
+Object.defineProperty(exports, "ENTITY_DEFAULTS", { enumerable: true, get: function () { return defaults_js_1.ENTITY_DEFAULTS; } });
+Object.defineProperty(exports, "RELATIONSHIP_DEFAULTS", { enumerable: true, get: function () { return defaults_js_1.RELATIONSHIP_DEFAULTS; } });
+Object.defineProperty(exports, "isEntityType", { enumerable: true, get: function () { return defaults_js_1.isEntityType; } });
+Object.defineProperty(exports, "isRelationship", { enumerable: true, get: function () { return defaults_js_1.isRelationship; } });
+Object.defineProperty(exports, "isEntity", { enumerable: true, get: function () { return defaults_js_1.isEntity; } });
+Object.defineProperty(exports, "kindOf", { enumerable: true, get: function () { return defaults_js_1.kindOf; } });
+Object.defineProperty(exports, "nameOf", { enumerable: true, get: function () { return defaults_js_1.nameOf; } });
+Object.defineProperty(exports, "endWithDefaults", { enumerable: true, get: function () { return defaults_js_1.endWithDefaults; } });
+Object.defineProperty(exports, "entityWithDefaults", { enumerable: true, get: function () { return defaults_js_1.entityWithDefaults; } });
+Object.defineProperty(exports, "relationshipWithDefaults", { enumerable: true, get: function () { return defaults_js_1.relationshipWithDefaults; } });
+Object.defineProperty(exports, "withDefaults", { enumerable: true, get: function () { return defaults_js_1.withDefaults; } });
+var schema_js_1 = require("./schema.js");
+Object.defineProperty(exports, "SCHEMAS", { enumerable: true, get: function () { return schema_js_1.SCHEMAS; } });
+Object.defineProperty(exports, "IDENTIFIERS_SCHEMA", { enumerable: true, get: function () { return schema_js_1.IDENTIFIERS_SCHEMA; } });
+Object.defineProperty(exports, "ATTRIBUTES_SCHEMA", { enumerable: true, get: function () { return schema_js_1.ATTRIBUTES_SCHEMA; } });
+Object.defineProperty(exports, "ENTITIES_SCHEMA", { enumerable: true, get: function () { return schema_js_1.ENTITIES_SCHEMA; } });
+Object.defineProperty(exports, "RELATIONSHIPS_SCHEMA", { enumerable: true, get: function () { return schema_js_1.RELATIONSHIPS_SCHEMA; } });
+var check_js_1 = require("./check.js");
+Object.defineProperty(exports, "check", { enumerable: true, get: function () { return check_js_1.check; } });
+Object.defineProperty(exports, "findById", { enumerable: true, get: function () { return check_js_1.findById; } });
+var fields_js_1 = require("./fields.js");
+Object.defineProperty(exports, "ENTITY_FIELDS", { enumerable: true, get: function () { return fields_js_1.ENTITY_FIELDS; } });
+Object.defineProperty(exports, "RELATIONSHIP_FIELDS", { enumerable: true, get: function () { return fields_js_1.RELATIONSHIP_FIELDS; } });
+Object.defineProperty(exports, "MASTER_FIELDS", { enumerable: true, get: function () { return fields_js_1.MASTER_FIELDS; } });
+Object.defineProperty(exports, "nameFields", { enumerable: true, get: function () { return fields_js_1.nameFields; } });
+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; } });

package/dist/cjs/package.json

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

package/dist/cjs/patch.js

@@ -0,0 +1,274 @@
+"use strict";
+// UI の操作(ドラッグ・インスペクタの適用)を、保存する patch(JSON Merge Patch)に変換する。
+//
+// 戻り値は { collection, id, patch }。利用側(iHub など)は図の種類を知らずにこれを保存すればよい。
+// 入力の検証に失敗したときは ModelError を投げる(メッセージは利用者にそのまま見せられる日本語)。
+// 使い方の誤り(マスタなのに collection を渡していない)は ModelError ではなく Error。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelError = void 0;
+exports.collectionOf = collectionOf;
+exports.titleOf = titleOf;
+exports.getByPath = getByPath;
+exports.mergePatch = mergePatch;
+exports.movePatch = movePatch;
+exports.applyPatch = applyPatch;
+const defaults_js_1 = require("./defaults.js");
+const fields_js_1 = require("./fields.js");
+/** 入力の検証エラー。message は利用者向け */
+class ModelError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ModelError';
+    }
+}
+exports.ModelError = ModelError;
+/**
+ * レコードを置くコレクション。関係・エンティティは形から決まる。
+ * マスタは identifiers / attributes を形から判別できないので collection が要る。
+ */
+function collectionOf(record, collection) {
+    if ((0, defaults_js_1.isRelationship)(record))
+        return 'relationships';
+    if ((0, defaults_js_1.isEntity)(record))
+        return 'entities';
+    if (!collection)
+        throw new Error('model.tm: マスタ (識別子・属性) のレコードには collection を渡してください。');
+    return collection;
+}
+/** インスペクタの見出し。名前、無ければ id(関係はラベル、無ければ「種類 id」) */
+function titleOf(record) {
+    if ((0, defaults_js_1.isRelationship)(record)) {
+        if (typeof record.label === 'string' && record.label !== '')
+            return record.label;
+        return `${record.type || ''} ${String(record.id)}`.trim();
+    }
+    const name = (0, defaults_js_1.nameOf)(record);
+    return name !== '' ? name : String(record.id);
+}
+/** ドット区切りの path で値を取り出す */
+function getByPath(obj, path) {
+    return path.split('.').reduce((acc, key) => (acc == null ? acc : acc[key]), obj);
+}
+/**
+ * JSON Merge Patch をレコードに重ねたものを返す(入力は書き換えない)。
+ * null の項目は除く。保存したあと、表示を先に更新するときに使う。
+ */
+function mergePatch(record, patch) {
+    const out = { ...record };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === null) {
+            delete out[key];
+        }
+        else if (typeof value === 'object' && !Array.isArray(value)) {
+            const base = out[key];
+            out[key] = mergePatch(base && typeof base === 'object' && !Array.isArray(base) ? base : {}, value);
+        }
+        else {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+/**
+ * ドラッグで動かしたエンティティの位置を保存する patch。
+ * 保存してある position に移動量を足し、整数に丸める(position が無いときは 0, 0 から)。z は触らない。
+ */
+function movePatch(entity, move) {
+    const base = entity.position || { x: 0, y: 0 };
+    return {
+        collection: 'entities',
+        id: entity.id,
+        patch: {
+            position: {
+                x: Math.round(base.x + move.dx),
+                y: Math.round(base.y + move.dy),
+            },
+        },
+    };
+}
+// ---- 入力の読み取り ------------------------------------------------------------
+// 入力した文字列を数にする。数でないときは null。
+function toNumber(value) {
+    const n = Number(value);
+    return value !== '' && Number.isFinite(n) ? n : null;
+}
+// 0 以上の整数(幅・高さ。0 は「内容に合わせる」)
+function toLength(value, label) {
+    const n = toNumber(value);
+    if (n === null || n < 0)
+        throw new ModelError(`${label}は 0 以上の数で入力してください。(0 で内容に合わせる)`);
+    return Math.round(n);
+}
+// 角度(0 以上 360 未満の整数に正規化)
+function toDegree(value, label) {
+    const n = toNumber(value);
+    if (n === null)
+        throw new ModelError(`${label}は、角度 (数) で入力してください。`);
+    return ((Math.round(n) % 360) + 360) % 360;
+}
+// 候補の中の数、または空(null = 項目を除く)
+function toOptionNumberOrNull(value, options, label) {
+    if (value === '')
+        return null;
+    const n = toNumber(value);
+    if (n === null || !options.includes(n))
+        throw new ModelError(`${label}は、${options.join(' / ')} のどれか (または空) で入力してください。`);
+    return n;
+}
+// 候補の中の文字列
+function toOption(value, options, label) {
+    if (!options.includes(value))
+        throw new ModelError(`${label}は、${options.join(' / ')} のどれかで入力してください。`);
+    return value;
+}
+// 空にできる文字列。空なら null(JSON Merge Patch で項目を除く)
+function toOptionalText(value) {
+    return value === '' ? null : value;
+}
+// patch の入れ子に値を置く(patch.from.position = v のように)
+function put(patch, path, value) {
+    const keys = path.split('.');
+    let cur = patch;
+    for (const key of keys.slice(0, -1)) {
+        if (!cur[key] || typeof cur[key] !== 'object')
+            cur[key] = {};
+        cur = cur[key];
+    }
+    cur[keys[keys.length - 1]] = value;
+}
+/**
+ * インスペクタの入力のうち、図に描いている値(withDefaults で埋めた値)から変わった項目だけを返す。
+ * 前後の空白は除く。読み取り専用の項目と、values に無い項目は含めない。
+ */
+function changedValues(record, values, collection) {
+    const effective = (0, defaults_js_1.withDefaults)(record);
+    const out = new Map();
+    for (const field of (0, fields_js_1.fieldsOf)(record, collection)) {
+        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;
+}
+// 名前(name / name.logical / name.physical)。required なら空にできない
+function namePatch(patch, path, value, required) {
+    // name と name.logical は空にできない。name.physical は空にできる(論理名だけのモデル)
+    if (value === '' && required)
+        throw new ModelError('名称を入力してください。');
+    put(patch, path, value);
+}
+// エンティティの入力 → patch(name / type / description / size)
+function entityPatch(entity, values) {
+    const patch = {};
+    for (const [path, value] of changedValues(entity, values)) {
+        switch (path) {
+            case 'name':
+            case 'name.logical':
+                namePatch(patch, path, value, true);
+                break;
+            case 'name.physical':
+                namePatch(patch, path, value, false);
+                break;
+            case 'type':
+                put(patch, path, toOption(value, defaults_js_1.ENTITY_TYPES, '種別'));
+                break;
+            case 'size.w':
+                put(patch, path, toLength(value, '幅'));
+                break;
+            case 'size.h':
+                put(patch, path, toLength(value, '高さ'));
+                break;
+            case 'description':
+                put(patch, path, toOptionalText(value));
+                break;
+        }
+    }
+    return patch;
+}
+const END_LABELS = { from: '接続元', to: '接続先' };
+// 関係の入力 → patch(type / label / from / to / subset / description)
+function relationshipPatch(relationship, values) {
+    const patch = {};
+    for (const [path, value] of changedValues(relationship, values)) {
+        const [head, key] = path.split('.');
+        if ((head === 'from' || head === 'to') && key) {
+            const label = END_LABELS[head];
+            switch (key) {
+                case 'position':
+                    put(patch, path, toDegree(value, `${label}の位置`));
+                    break;
+                case 'cardinality':
+                    put(patch, path, toOptionNumberOrNull(value, defaults_js_1.CARDINALITIES, `${label}のカーディナリティ`));
+                    break;
+                case 'optionality':
+                    put(patch, path, toOptionNumberOrNull(value, defaults_js_1.OPTIONALITIES, `${label}のオプショナリティ`));
+                    break;
+            }
+            continue;
+        }
+        switch (path) {
+            case 'subset.kind':
+                put(patch, path, toOption(value, defaults_js_1.SUBSET_KINDS, 'サブセットの区分'));
+                break;
+            case 'subset.code':
+                // 区分コードを空にするとサブセットの表記を消す(subset ごと除く)
+                if (value === '')
+                    patch.subset = null;
+                else
+                    put(patch, path, value);
+                break;
+            case 'type':
+            case 'label':
+            case 'description':
+                put(patch, path, toOptionalText(value));
+                break;
+        }
+    }
+    // subset を除くときは kind の変更も要らない
+    if (patch.subset === null)
+        return patch;
+    // kind だけを新しく書いて code が無い subset は作らない(d3.ter は code が無ければ描かない)
+    const subset = patch.subset;
+    if (subset && subset.kind !== undefined && subset.code === undefined && !relationship.subset?.code)
+        throw new ModelError('サブセットの区分コードを入力してください。');
+    return patch;
+}
+// マスタの入力 → patch(name / description)
+function masterPatch(master, values, collection) {
+    const patch = {};
+    for (const [path, value] of changedValues(master, values, collection)) {
+        switch (path) {
+            case 'name':
+            case 'name.logical':
+                // 識別子・属性の名前は空にできない(エンティティの行に描く文字が無くなる)
+                namePatch(patch, path, value, true);
+                break;
+            case 'name.physical':
+                namePatch(patch, path, value, false);
+                break;
+            case 'description':
+                put(patch, path, toOptionalText(value));
+                break;
+        }
+    }
+    return patch;
+}
+/**
+ * インスペクタの「適用」の値を、保存する patch に変換する。
+ * 図に描いている値から変えた項目だけを patch に入れる(変えていない既定の値まで書き込まないため)。
+ * 変更が無ければ patch は {}。マスタのときは collection(identifiers / attributes)が要る。
+ */
+function applyPatch(record, values, collection) {
+    const target = collectionOf(record, collection);
+    const patch = (0, defaults_js_1.kindOf)(record) === 'relationship'
+        ? relationshipPatch(record, values)
+        : (0, defaults_js_1.kindOf)(record) === 'entity'
+            ? entityPatch(record, values)
+            : masterPatch(record, values, target);
+    return { collection: target, id: record.id, patch };
+}

package/dist/cjs/schema.js

@@ -0,0 +1,179 @@
+"use strict";
+// TM(d3.ter)の入力データの JSON Schema(2020-12)。コレクションごとに 1 つ。
+//
+// iHub の server/schemas/tm/*.schema.json を移したもの。iHub 版と違い additionalProperties を閉じていない
+// (利用側の項目を落とさないため)。検査するのは、図の構造にかかわる項目(id・type・参照・position・size・
+// 関係の端点・subset・mapping)。name は文字列でも { logical, physical } でもよい。
+//
+// x-id-start はスキーマの検証には使わない注釈(コレクションが空のときに最初に振る id)。
+// Ajv で使うときは addKeyword({ keyword: 'x-id-start', schemaType: 'number' }) を足す。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEMAS = exports.RELATIONSHIPS_SCHEMA = exports.ENTITIES_SCHEMA = exports.ATTRIBUTES_SCHEMA = exports.IDENTIFIERS_SCHEMA = void 0;
+const defaults_js_1 = require("./defaults.js");
+const ID = { type: ['integer', 'string'] };
+const NAME = {
+    description: '文字列、または論理名と物理名の組',
+    oneOf: [
+        { type: 'string' },
+        {
+            type: 'object',
+            properties: {
+                logical: { type: 'string' },
+                physical: { type: 'string' },
+                description: { type: 'string' },
+            },
+            additionalProperties: true,
+        },
+    ],
+};
+// マスタ(identifiers / attributes)の共通形
+function masterSchema(title, description, idStart) {
+    return {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        title,
+        description,
+        'x-id-start': idStart,
+        type: 'array',
+        items: {
+            type: 'object',
+            properties: {
+                id: ID,
+                name: NAME,
+                description: { type: ['string', 'null'] },
+            },
+            required: ['id', 'name'],
+            additionalProperties: true,
+        },
+    };
+}
+exports.IDENTIFIERS_SCHEMA = masterSchema('TM の識別子のマスタ', '識別子 (個体指定子) のマスタ。entities[].identifiers[].identifier から id で参照される。', 10000);
+exports.ATTRIBUTES_SCHEMA = masterSchema('TM の属性のマスタ', '属性のマスタ。entities[].attributes[].attribute から id で参照される。', 20000);
+// エンティティが持つインスタンス(識別子・属性)の共通形。ref はマスタを指す項目名
+function instanceSchema(ref) {
+    return {
+        type: 'array',
+        items: {
+            type: 'object',
+            properties: {
+                id: ID,
+                [ref]: ID,
+                name: NAME,
+                description: { type: ['string', 'null'] },
+            },
+            required: ['id', ref],
+            additionalProperties: true,
+        },
+    };
+}
+exports.ENTITIES_SCHEMA = {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    title: 'TM のエンティティ',
+    description: 'TM (T字形ER) のエンティティ。type は 10 種の種別 (これ以外は d3.ter が描画時に例外にする)。識別子・属性はマスタの id を参照するインスタンスとして持ち、インスタンスの id は全エンティティを通して一意 (関係の details がこれを指す)。name は文字列か論理名・物理名の組。position はドラッグで書き換わる。size の w / h が 0 のときは内容に合わせる。',
+    'x-id-start': 30000,
+    type: 'array',
+    items: {
+        type: 'object',
+        properties: {
+            id: ID,
+            type: { enum: [...defaults_js_1.ENTITY_TYPES] },
+            name: NAME,
+            description: { type: ['string', 'null'] },
+            position: {
+                type: 'object',
+                properties: {
+                    x: { type: 'number' },
+                    y: { type: 'number' },
+                    z: { type: 'number' },
+                },
+                required: ['x', 'y'],
+                additionalProperties: false,
+            },
+            size: {
+                type: 'object',
+                properties: {
+                    w: { type: 'number', minimum: 0 },
+                    h: { type: 'number', minimum: 0 },
+                },
+                required: ['w', 'h'],
+                additionalProperties: false,
+            },
+            identifiers: instanceSchema('identifier'),
+            attributes: instanceSchema('attribute'),
+        },
+        required: ['id', 'type', 'name'],
+        additionalProperties: true,
+    },
+};
+exports.RELATIONSHIPS_SCHEMA = {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    title: 'TM のリレーションシップ',
+    description: 'エンティティの間の結線。from.entity / to.entity はエンティティの id (同じエンティティを指すと自己結線 = 再帰のループ)。端点の cardinality (1 / 3) と optionality (0 / 1) は無ければ記号を描かない。position は接続位置の角度 (0=真下・時計回り)。details は線を取り付けるインスタンス (省略すると先頭の識別子)。subset はサブセット結線の区分コード (same は =、different は ×)。mapping は結線の中点から垂下する対応表・対照表・再帰表 (再帰表は自己結線にだけ)。',
+    'x-id-start': 1,
+    type: 'array',
+    items: {
+        type: 'object',
+        properties: {
+            id: ID,
+            type: { type: ['string', 'null'] },
+            from: { $ref: '#/$defs/end' },
+            to: { $ref: '#/$defs/end' },
+            details: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        from: { $ref: '#/$defs/detail_end' },
+                        to: { $ref: '#/$defs/detail_end' },
+                    },
+                    required: ['from', 'to'],
+                },
+            },
+            subset: {
+                type: ['object', 'null'],
+                properties: {
+                    kind: { enum: [...defaults_js_1.SUBSET_KINDS] },
+                    code: { type: 'string' },
+                },
+                required: ['kind', 'code'],
+            },
+            mapping: {
+                type: ['object', 'null'],
+                properties: { entity: ID },
+                required: ['entity'],
+            },
+            label: { type: ['string', 'null'] },
+            description: { type: ['string', 'null'] },
+        },
+        required: ['id', 'from', 'to'],
+        additionalProperties: true,
+    },
+    $defs: {
+        end: {
+            type: 'object',
+            properties: {
+                entity: ID,
+                cardinality: { enum: [...defaults_js_1.CARDINALITIES], description: '1 か 多 (3)。無ければ記号を描かない' },
+                optionality: { enum: [...defaults_js_1.OPTIONALITIES], description: '0 は任意 (○)、1 は必須 (横棒)。無ければ記号を描かない' },
+                position: { type: 'number', description: '接続位置の角度。0=真下・時計回り (90=左 / 180=真上 / 270=右)' },
+                id: { ...ID, description: '旧来の項目。端点の識別子のインスタンスの id (details に置き換わった)' },
+            },
+            required: ['entity'],
+            additionalProperties: true,
+        },
+        detail_end: {
+            type: 'object',
+            properties: {
+                id: ID,
+                description: { type: ['string', 'null'] },
+            },
+            required: ['id'],
+        },
+    },
+};
+/** コレクション名 → スキーマ */
+exports.SCHEMAS = {
+    identifiers: exports.IDENTIFIERS_SCHEMA,
+    attributes: exports.ATTRIBUTES_SCHEMA,
+    entities: exports.ENTITIES_SCHEMA,
+    relationships: exports.RELATIONSHIPS_SCHEMA,
+};

package/dist/cjs/types.js

@@ -0,0 +1,8 @@
+"use strict";
+// model.tm の公開型。
+//
+// ここで言う「レコード」は、d3.ter の data() に渡す入力そのものの 1 要素。
+//   { identifiers, attributes, entities, relationships }
+// 形は model.er(ER 図)と同じ階層形式で、TM 固有の項目(エンティティの type、関係の subset / mapping / label)が足されている。
+// d3.ter が正規化したあとの datum(_id / _core を持つ Atman)ではない。
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/defaults.d.ts

@@ -0,0 +1,67 @@
+import type { Position, Size } from '@yanqirenshi/types';
+import type { TmCardinality, TmEntityRecord, TmEntityType, TmKind, TmMasterRecord, TmOptionality, TmRecord, TmRelationshipEnd, TmRelationshipRecord } from './types.js';
+/** エンティティの種別(10 種) */
+export declare const ENTITY_TYPES: readonly TmEntityType[];
+/** 種別バッジ(箱のヘッダ右に描く文字。CLASS は意図的に無し = '') */
+export declare const TYPE_BADGES: Record<TmEntityType, string>;
+/** 種別ごとの箱の背景色 */
+export declare const TYPE_COLORS: Record<TmEntityType, string>;
+/** 結線の中点から垂下(mapping)できる種別 */
+export declare const MAPPING_TYPES: readonly TmEntityType[];
+/** サブセット結線の区分コードの種類 */
+export declare const SUBSET_KINDS: readonly ["same", "different"];
+/** カーディナリティ(1 か 多) */
+export declare const CARDINALITIES: readonly TmCardinality[];
+/** オプショナリティ(0 は任意、1 は必須) */
+export declare const OPTIONALITIES: readonly TmOptionality[];
+/** エンティティの既定。size の 0 は「内容に合わせる」 */
+export declare const ENTITY_DEFAULTS: {
+    readonly position: Position;
+    readonly size: Size;
+};
+/** 関係の既定。端点の角度は 0(真下)。cardinality / optionality は既定なし(無ければ記号を描かない) */
+export declare const RELATIONSHIP_DEFAULTS: {
+    readonly end: {
+        readonly position: 0;
+    };
+};
+/** 種別として正しいか */
+export declare function isEntityType(value: unknown): value is TmEntityType;
+/** 関係か(from と to がエンティティを指す) */
+export declare function isRelationship(record: TmRecord | null | undefined): record is TmRelationshipRecord;
+/**
+ * エンティティか。関係でなく、type・インスタンスの配列・位置・大きさのどれかを持つ。
+ * マスタ(id と name だけ)と区別するための判定なので、id と name しか無いエンティティは見分けられない
+ * (entities[] の要素と分かっているときは entityWithDefaults を使う)。
+ */
+export declare function isEntity(record: TmRecord | null | undefined): record is TmEntityRecord;
+/** レコードの種類 */
+export declare function kindOf(record: TmRecord): TmKind;
+/** 表示する名前。文字列ならそのまま、Name なら logical(無ければ physical)。無ければ '' */
+export declare function nameOf(record: TmMasterRecord | TmEntityRecord): string;
+/** 既定を重ねた端点(position が必ずある) */
+export type TmFilledEnd = TmRelationshipEnd & {
+    position: number;
+};
+/** 端点に既定を重ねる(角度が無ければ 0。cardinality / optionality は不正値なら除く) */
+export declare function endWithDefaults(end: TmRelationshipEnd): TmFilledEnd;
+/** 関係に既定を重ねる: from / to の position */
+export declare function relationshipWithDefaults<T extends TmRelationshipRecord>(record: T): T & {
+    from: TmFilledEnd;
+    to: TmFilledEnd;
+};
+/**
+ * エンティティに既定を重ねる: position(無ければ 0, 0)、size(無ければ 0, 0 = 内容に合わせる)。
+ * type は補わない(無ければ無いまま。d3.ter は描けないので check で知らせる)。
+ */
+export declare function entityWithDefaults<T extends TmEntityRecord>(record: T): T & {
+    position: Position;
+    size: Size;
+};
+/**
+ * レコードに、view が既定で使う値を重ねて返す(入力は書き換えない)。インスペクタの初期値に使う。
+ * 形から種類を決める(kindOf)。マスタはそのまま(複製だけ)。
+ * name は文字列か Name かを保つ(どちらで書いたかで編集できる項目が変わる — fieldsOf)。
+ */
+export declare function withDefaults<T extends TmRecord>(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":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EACV,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAC5F,iBAAiB,EAAE,oBAAoB,EACxC,MAAM,YAAY,CAAC;AAEpB,sBAAsB;AACtB,eAAO,MAAM,YAAY,EAAE,SAAS,YAAY,EAG/C,CAAC;AAEF,4CAA4C;AAC5C,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAWpD,CAAC;AAEF,iBAAiB;AACjB,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAWpD,CAAC;AAEF,8BAA8B;AAC9B,eAAO,MAAM,aAAa,EAAE,SAAS,YAAY,EAAmD,CAAC;AAErG,uBAAuB;AACvB,eAAO,MAAM,YAAY,gCAAiC,CAAC;AAE3D,sBAAsB;AACtB,eAAO,MAAM,aAAa,EAAE,SAAS,aAAa,EAAW,CAAC;AAE9D,4BAA4B;AAC5B,eAAO,MAAM,aAAa,EAAE,SAAS,aAAa,EAAW,CAAC;AAE9D,oCAAoC;AACpC,eAAO,MAAM,eAAe;uBACE,QAAQ;mBACZ,IAAI;CACpB,CAAC;AAEX,sEAAsE;AACtE,eAAO,MAAM,qBAAqB;;;;CAExB,CAAC;AAEX,gBAAgB;AAChB,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAElE;AAED,gCAAgC;AAChC,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,IAAI,oBAAoB,CAKlG;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,IAAI,cAAc,CAQtF;AAED,cAAc;AACd,wBAAgB,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAK/C;AAED,8DAA8D;AAC9D,wBAAgB,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,GAAG,MAAM,CAUtE;AAED,+BAA+B;AAC/B,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,GAAG,EAAE,iBAAiB,GAAG,WAAW,CAanE;AAED,sCAAsC;AACtC,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,oBAAoB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,WAAW,CAAA;CAAE,CAM9H;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,cAAc,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAM9G;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAQ7D"}