@g1cloud/entity-modeler-next 5.0.0-beta.17 → 5.0.0-beta.18

package/dist/editor/controller.d.ts

@@ -11,11 +11,6 @@ import { ValidationIssue } from '../core/validation';
 import { UiLocale, Translator } from '../i18n';
 import { AssociationEnd, Attribute, DisplayMode, EmbeddableCatalog, Entity, EntityIndex, Geo, GroupCodeCatalog, LangCode, LogicalGroup, ModelId, Multiplicity, Operation, Point, PredefinedCustomTypeCatalog, SuperClassCatalog } from '../core/types';
 import * as cmd from '../command/commands';
-/**
- * 관계 파생 FK 직접 삭제 시도 시의 안내 — 뷰 tooltip(어포던스)과 차단 시 토스트(피드백)가 공유한다.
- * FK는 관계가 소유·관리하므로 컬럼을 직접 지우는 대신 연관관계선을 삭제해야 한다(Option B).
- */
-export declare const FK_MANAGED_DELETE_MESSAGE = "\uC678\uB798\uD0A4\uB294 \uC5F0\uAD00\uAD00\uACC4\uC5D0\uC11C \uD30C\uC0DD\uB429\uB2C8\uB2E4. \uC0AD\uC81C\uD558\uB824\uBA74 \uC5F0\uAD00\uAD00\uACC4\uC120\uC744 \uC120\uD0DD\uD574 \uC0AD\uC81C\uD558\uC138\uC694.";
 /** 엔티티 내부 속성을 가리키는 주소 원자 — 선택·컨텍스트·재정렬·연결 등 속성 단위 기능의 공통 참조점. */
 export type AttrRef = {
     entityId: ModelId;
@@ -219,7 +214,12 @@ export interface EditorController {
     undo(): void;
     redo(): void;
     markSaved(): void;
-    addEntity(name?: string, location?: Point): ModelId;
+    /**
+     * add류 intent 공통 반환 계약: 성공 시 생성된 ModelId, 실패(조회 모드·충돌 프리즈·잠금·가드 차단) 시
+     * null. 거짓 성공 id를 돌려주면 뷰가 존재하지 않는 대상을 select(빈 폼)하므로, 소비처는 null 가드 후
+     * 후속 동작(자동 선택 등)을 수행해야 한다.
+     */
+    addEntity(name?: string, location?: Point): ModelId | null;
     renameEntity(id: ModelId, name: string): void;
     updateEntity(id: ModelId, patch: Partial<Entity>): void;
     moveEntity(id: ModelId, location: Point): void;
@@ -237,6 +237,11 @@ export interface EditorController {
     setEntityLocked(id: ModelId, locked: boolean): void;
     /** 엔티티 잠금 여부 조회 (레이아웃) */
     isEntityLocked(id: ModelId): boolean;
+    /**
+     * 연관 잠금 여부 조회 — 양 끝 엔티티 중 한쪽이라도 잠겼으면 true(내부 게이트 isAssocLockedFn와
+     * 동일 의미론 단일 출처). 뷰가 관계 편집 어포던스(삭제 메뉴·인스펙터 폼)를 억제할 때 사용.
+     */
+    isAssociationLocked(assocId: ModelId): boolean;
     /** 활성 다이어그램 전체 엔티티 접기/펼치기 — 사전 상태 캡처 단일 커맨드(1 undo 스텝) */
     collapseAll(): void;
     expandAll(): void;
@@ -259,10 +264,10 @@ export interface EditorController {
     setGroupLocked(groupId: ModelId, locked: boolean): void;
     /** 그룹 잠금 여부 조회 (레이아웃) */
     isGroupLocked(groupId: ModelId): boolean;
-    /** 선택 엔티티들로 새 그룹 생성 (멤버 bbox에 박스 배치) */
+    /** 선택 엔티티들로 새 그룹 생성 (멤버 bbox에 박스 배치) — 빈 입력·조회 모드 시 null */
     createGroup(entityIds: ModelId[], name?: string): ModelId | null;
     /** 빈 그룹 박스 생성 (이후 드래그로 엔티티 편입) */
-    addEmptyGroup(location: Point, name?: string): ModelId;
+    addEmptyGroup(location: Point, name?: string): ModelId | null;
     removeGroup(groupId: ModelId): void;
     /** 엔티티 이동 + 컨테인먼트에 따른 그룹 편입/해제를 한 명령으로 */
     dropEntity(entityId: ModelId, location: Point, targetGroupId: ModelId | null): void;
@@ -338,16 +343,16 @@ export interface EditorController {
      * dbAttr 슬롯은 레거시 `initAttributeDatabaseAttribute` 동형으로 **빈 골격**(physicalName/dataType
      * 미설정)만 시드하고, 표시·저장 시 카탈로그 메타모델로 폴백한다(`SVG:976` 대응). 참조가 아니므로
      * association은 만들지 않는다(entity.attributes 직접 보유 — 레거시 NORMAL 부류). 카탈로그에 없거나
-     * 대상 엔티티가 없으면 no-op(undefined).
+     * 대상 엔티티가 없으면 no-op(null).
      */
-    addPredefinedEmbed(entityId: ModelId, embeddableType: string): ModelId | undefined;
-    addAttribute(entityId: ModelId, partial?: Partial<Attribute>): ModelId;
+    addPredefinedEmbed(entityId: ModelId, embeddableType: string): ModelId | null;
+    addAttribute(entityId: ModelId, partial?: Partial<Attribute>): ModelId | null;
     /**
      * 시각 구획 행(DIVIDER) 추가 — 거대 엔티티에서 속성 묶음을 끊는 구분선. DB 컬럼·타입·식별자 없이
      * 말미에 추가되며(이후 grip 드래그로 위치 조정), `name`은 선택적 섹션 라벨. divider 기본값을 단일
      * 출처로 보장하려고 addAttribute에 위임한다.
      */
-    addDivider(entityId: ModelId): ModelId;
+    addDivider(entityId: ModelId): ModelId | null;
     updateAttribute(entityId: ModelId, attributeId: ModelId, patch: Partial<Attribute>): void;
     /**
      * ⑤ 파생 타입 결합 — 속성 groupCode를 설정/해제하며 type을 동반 조정한다(레거시 정합).
@@ -378,21 +383,21 @@ export interface EditorController {
     updateIndex(entityId: ModelId, indexId: ModelId, patch: Partial<EntityIndex>): void;
     removeIndex(entityId: ModelId, indexId: ModelId): void;
     /** 메서드(operation) 추가 — 신규는 visibility=PACKAGE, order=말미. 생성된 modelId 반환. */
-    addOperation(entityId: ModelId, partial?: Partial<Operation>): ModelId;
+    addOperation(entityId: ModelId, partial?: Partial<Operation>): ModelId | null;
     updateOperation(entityId: ModelId, operationId: ModelId, patch: Partial<Operation>): void;
     removeOperation(entityId: ModelId, operationId: ModelId): void;
     /** 메서드 행 재정렬 — toIndex = 대상 제거 후 배열 기준 삽입 위치(단일 명령, undo 원자). */
     reorderOperations(entityId: ModelId, operationIds: ModelId[], toIndex: number): void;
     /** 메서드 강조 색 토큰 지정 (null이면 해제). */
     setOperationSwatch(entityId: ModelId, operationId: ModelId, token: string | null): void;
-    addAssociation(sourceEntityId: ModelId, targetEntityId: ModelId, sourceColumnRef?: ModelId, targetColumnRef?: ModelId): ModelId;
+    addAssociation(sourceEntityId: ModelId, targetEntityId: ModelId, sourceColumnRef?: ModelId, targetColumnRef?: ModelId): ModelId | null;
     /**
      * 임베드 생성 — 소유자에 EMBED_OWN 표시 속성을 물질화(임베더블 source 컬럼 복사 + `embedded` 마커)하고
      * EMBED association(owner EXACTLY_ONE / embeddable EXACTLY_ONE+composition)을 한 composite로 추가한다.
      * 가드(결정 2 단일): 대상이 JPA_EMBEDDABLE이 아니거나 소유자가 이미 그 임베더블을 임베드했으면 no-op.
-     * 반환은 생성된 association id, 가드 차단 시 undefined.
+     * 반환은 생성된 association id, 가드 차단 시 null.
      */
-    addEmbedAssociation(ownerEntityId: ModelId, embeddableEntityId: ModelId): ModelId | undefined;
+    addEmbedAssociation(ownerEntityId: ModelId, embeddableEntityId: ModelId): ModelId | null;
     /**
      * 임베드 카디널리티 설정 — 임베더블 end multiplicity를 지정 값으로 바꾼다. 컬렉션(`@ElementCollection`)
      * 여부는 이 multiplicity에서 파생되는 값(권위=multiplicity, 결정 3): `*_MORE`(0..N / 1..N)면 컬렉션,
@@ -415,7 +420,7 @@ export interface EditorController {
     addWaypoint(assocId: ModelId, index: number, point: Point): void;
     removeWaypoint(assocId: ModelId, index: number): void;
     clearWaypoints(assocId: ModelId): void;
-    addNote(memo?: string, location?: Point): ModelId;
+    addNote(memo?: string, location?: Point): ModelId | null;
     removeNote(noteId: ModelId): void;
     moveNote(noteId: ModelId, location: Point): void;
     resizeNote(noteId: ModelId, size: {