@yanqirenshi/model.tm 0.0.0-stage → 0.1.1

package/dist/cjs/index.js

@@ -0,0 +1,56 @@
+"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)との間に横の依存は無い。
+// ModelError / mergePatch / getByPath / movePatch と入力の読み取り部品は model.core(#151)のもの。
+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,174 @@
+"use strict";
+// UI の操作(ドラッグ・インスペクタの適用)を、保存する patch(JSON Merge Patch)に変換する。
+//
+// 戻り値は { collection, id, patch }。利用側(iHub など)は図の種類を知らずにこれを保存すればよい。
+// 入力の検証に失敗したときは ModelError を投げる(メッセージは利用者にそのまま見せられる日本語)。
+// 使い方の誤り(マスタなのに collection を渡していない)は ModelError ではなく Error。
+// 読み取り部品(toLength など)と patch の道具は model.core にある(#151)。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergePatch = exports.getByPath = exports.ModelError = void 0;
+exports.collectionOf = collectionOf;
+exports.titleOf = titleOf;
+exports.movePatch = movePatch;
+exports.applyPatch = applyPatch;
+const model_core_1 = require("@yanqirenshi/model.core");
+const defaults_js_1 = require("./defaults.js");
+const fields_js_1 = require("./fields.js");
+// model.core のものをそのまま公開する(利用側が model.tm だけを読めばよいように)
+var model_core_2 = require("@yanqirenshi/model.core");
+Object.defineProperty(exports, "ModelError", { enumerable: true, get: function () { return model_core_2.ModelError; } });
+Object.defineProperty(exports, "getByPath", { enumerable: true, get: function () { return model_core_2.getByPath; } });
+Object.defineProperty(exports, "mergePatch", { enumerable: true, get: function () { return model_core_2.mergePatch; } });
+/**
+ * レコードを置くコレクション。関係・エンティティは形から決まる。
+ * マスタは 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);
+}
+/**
+ * ドラッグで動かしたエンティティの位置を保存する patch。
+ * 保存してある position に移動量を足し、整数に丸める(position が無いときは 0, 0 から)。z は触らない。
+ */
+function movePatch(entity, move) {
+    return (0, model_core_1.movePatch)(entity, move, 'entities');
+}
+// インスペクタの入力のうち、図に描いている値(withDefaults)から変わった項目だけ
+function changedValues(record, values, collection) {
+    return (0, model_core_1.changedValues)((0, defaults_js_1.withDefaults)(record), values, (0, fields_js_1.fieldsOf)(record, collection));
+}
+// 幅・高さは 0 以上(0 は「内容に合わせる」)
+const LENGTH = { hint: '(0 で内容に合わせる)' };
+// 名前(name / name.logical / name.physical)。required なら空にできない
+function namePatch(patch, path, value, required) {
+    // name と name.logical は空にできない。name.physical は空にできる(論理名だけのモデル)
+    if (value === '' && required)
+        throw new model_core_1.ModelError('名称を入力してください。');
+    (0, model_core_1.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':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.toOption)(value, defaults_js_1.ENTITY_TYPES, '種別'));
+                break;
+            case 'size.w':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.toLength)(value, '幅', LENGTH));
+                break;
+            case 'size.h':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.toLength)(value, '高さ', LENGTH));
+                break;
+            case 'description':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.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':
+                    (0, model_core_1.put)(patch, path, (0, model_core_1.toDegree)(value, `${label}の位置`));
+                    break;
+                case 'cardinality':
+                    (0, model_core_1.put)(patch, path, (0, model_core_1.toOptionNumberOrNull)(value, defaults_js_1.CARDINALITIES, `${label}のカーディナリティ`));
+                    break;
+                case 'optionality':
+                    (0, model_core_1.put)(patch, path, (0, model_core_1.toOptionNumberOrNull)(value, defaults_js_1.OPTIONALITIES, `${label}のオプショナリティ`));
+                    break;
+            }
+            continue;
+        }
+        switch (path) {
+            case 'subset.kind':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.toOption)(value, defaults_js_1.SUBSET_KINDS, 'サブセットの区分'));
+                break;
+            case 'subset.code':
+                // 区分コードを空にするとサブセットの表記を消す(subset ごと除く)
+                if (value === '')
+                    patch.subset = null;
+                else
+                    (0, model_core_1.put)(patch, path, value);
+                break;
+            case 'type':
+            case 'label':
+            case 'description':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.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 model_core_1.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':
+                (0, model_core_1.put)(patch, path, (0, model_core_1.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"}

package/dist/defaults.js

@@ -0,0 +1,133 @@
+// 「書いていない項目」に view(d3.ter)が既定で使う値と、レコードの種類の判別。
+//
+// 値の出どころ: d3.ter の src/js/Entity.js(entityTypeContents = 種別バッジ、entityBackground = 配色)、
+// Port.js(degree() の既定 0)。d3.ter はこのファイルを読む(#144)ので、ここが正。
+// cardinality / optionality に既定は置かない(d3.ter は無ければ記号を描かない)。
+/** エンティティの種別(10 種) */
+export const ENTITY_TYPES = [
+    'RESOURCE', 'RESOURCE-SUBSET', 'EVENT', 'EVENT-SUBSET',
+    'COMPARATIVE', 'CORRESPONDENCE', 'RECURSION', 'MANY-VALUED-OR', 'MANY-VALUED-AND', 'CLASS',
+];
+/** 種別バッジ(箱のヘッダ右に描く文字。CLASS は意図的に無し = '') */
+export const TYPE_BADGES = {
+    'RESOURCE': 'Rsc',
+    'RESOURCE-SUBSET': 'Rsc',
+    'EVENT': 'Evt',
+    'EVENT-SUBSET': 'Evt',
+    'COMPARATIVE': '対照',
+    'CORRESPONDENCE': '対応',
+    'RECURSION': '再帰',
+    'MANY-VALUED-OR': 'MO',
+    'MANY-VALUED-AND': 'MA',
+    'CLASS': '',
+};
+/** 種別ごとの箱の背景色 */
+export const TYPE_COLORS = {
+    'RESOURCE': '#89c3eb',
+    'RESOURCE-SUBSET': '#a0d8ef',
+    'EVENT': '#f09199',
+    'EVENT-SUBSET': '#f6bfbc',
+    'COMPARATIVE': '#c8d5bb',
+    'CORRESPONDENCE': '#f2f2b0',
+    'RECURSION': '#dbd0e6',
+    'MANY-VALUED-OR': '#fddea5',
+    'MANY-VALUED-AND': '#9fd5c9',
+    'CLASS': '#bdc0ba',
+};
+/** 結線の中点から垂下(mapping)できる種別 */
+export const MAPPING_TYPES = ['CORRESPONDENCE', 'COMPARATIVE', 'RECURSION'];
+/** サブセット結線の区分コードの種類 */
+export const SUBSET_KINDS = ['same', 'different'];
+/** カーディナリティ(1 か 多) */
+export const CARDINALITIES = [1, 3];
+/** オプショナリティ(0 は任意、1 は必須) */
+export const OPTIONALITIES = [0, 1];
+/** エンティティの既定。size の 0 は「内容に合わせる」 */
+export const ENTITY_DEFAULTS = {
+    position: { x: 0, y: 0 },
+    size: { w: 0, h: 0 },
+};
+/** 関係の既定。端点の角度は 0(真下)。cardinality / optionality は既定なし(無ければ記号を描かない) */
+export const RELATIONSHIP_DEFAULTS = {
+    end: { position: 0 },
+};
+/** 種別として正しいか */
+export function isEntityType(value) {
+    return typeof value === 'string' && ENTITY_TYPES.includes(value);
+}
+/** 関係か(from と to がエンティティを指す) */
+export function isRelationship(record) {
+    const r = record;
+    return !!(r && r.from && typeof r.from === 'object' && 'entity' in r.from
+        && r.to && typeof r.to === 'object' && 'entity' in r.to);
+}
+/**
+ * エンティティか。関係でなく、type・インスタンスの配列・位置・大きさのどれかを持つ。
+ * マスタ(id と name だけ)と区別するための判定なので、id と name しか無いエンティティは見分けられない
+ * (entities[] の要素と分かっているときは entityWithDefaults を使う)。
+ */
+export function isEntity(record) {
+    if (!record || isRelationship(record))
+        return false;
+    const e = record;
+    return typeof e.type === 'string' || Array.isArray(e.identifiers) || Array.isArray(e.attributes)
+        || e.position !== undefined || e.size !== undefined;
+}
+/** レコードの種類 */
+export function kindOf(record) {
+    if (isRelationship(record))
+        return 'relationship';
+    return isEntity(record) ? 'entity' : 'master';
+}
+/** 表示する名前。文字列ならそのまま、Name なら logical(無ければ physical)。無ければ '' */
+export function nameOf(record) {
+    const name = record.name;
+    if (typeof name === 'string')
+        return name;
+    if (name && typeof name === 'object')
+        return name.logical || name.physical || '';
+    return '';
+}
+/** 端点に既定を重ねる(角度が無ければ 0。cardinality / optionality は不正値なら除く) */
+export function endWithDefaults(end) {
+    const out = {
+        ...end,
+        position: typeof end.position === 'number' && Number.isFinite(end.position) ? end.position : RELATIONSHIP_DEFAULTS.end.position,
+    };
+    if (!CARDINALITIES.includes(end.cardinality))
+        delete out.cardinality;
+    if (!OPTIONALITIES.includes(end.optionality))
+        delete out.optionality;
+    return out;
+}
+/** 関係に既定を重ねる: from / to の position */
+export function relationshipWithDefaults(record) {
+    return {
+        ...record,
+        from: endWithDefaults(record.from),
+        to: endWithDefaults(record.to),
+    };
+}
+/**
+ * エンティティに既定を重ねる: position(無ければ 0, 0)、size(無ければ 0, 0 = 内容に合わせる)。
+ * type は補わない(無ければ無いまま。d3.ter は描けないので check で知らせる)。
+ */
+export function entityWithDefaults(record) {
+    return {
+        ...record,
+        position: { ...ENTITY_DEFAULTS.position, ...(record.position || {}) },
+        size: { ...ENTITY_DEFAULTS.size, ...(record.size || {}) },
+    };
+}
+/**
+ * レコードに、view が既定で使う値を重ねて返す(入力は書き換えない)。インスペクタの初期値に使う。
+ * 形から種類を決める(kindOf)。マスタはそのまま(複製だけ)。
+ * name は文字列か Name かを保つ(どちらで書いたかで編集できる項目が変わる — fieldsOf)。
+ */
+export function withDefaults(record) {
+    if (isRelationship(record))
+        return relationshipWithDefaults(record);
+    if (isEntity(record))
+        return entityWithDefaults(record);
+    return { ...record };
+}

package/dist/fields.d.ts

@@ -0,0 +1,19 @@
+import type { TmCollection, TmField, TmRecord } from './types.js';
+/** 名前の項目。name が Name(オブジェクト)なら論理名・物理名の 2 項目、それ以外は名称 1 項目 */
+export declare function nameFields(record: TmRecord): TmField[];
+/** エンティティの項目(名前のあと) */
+export declare const ENTITY_FIELDS: readonly TmField[];
+/**
+ * 関係の項目。接続位置はエンティティの中心から見た角度(0=真下・時計回り。90=左 / 180=真上 / 270=右)。
+ * カーディナリティ・オプショナリティは空にできる(記号を描かない)。
+ */
+export declare const RELATIONSHIP_FIELDS: readonly TmField[];
+/** マスタ(識別子・属性)の項目(名前のあと) */
+export declare const MASTER_FIELDS: readonly TmField[];
+/**
+ * レコードに応じた項目の一覧。
+ * マスタは identifiers / attributes のどちらかをレコードの形から判別できないので、利用側が collection を渡す
+ * (項目は同じなので、渡さなくても一覧は変わらない。applyPatch では必須)。
+ */
+export declare function fieldsOf(record: TmRecord, _collection?: TmCollection): TmField[];
+//# sourceMappingURL=fields.d.ts.map