@g1cloud/entity-modeler-next 5.0.0-alpha.9 → 5.0.0-beta.1

package/dist/editor/controller.d.ts

@@ -6,8 +6,16 @@ import { OpSyncTransport } from '../command/opSync';
 import { FieldAuditRecord } from '../core/projectFieldAudit';
 import { ResolvedDiagram } from '../core/resolve';
 import { RoutingMode } from '../core/routing';
+import { MergeDiagramSource } from '../core/mergeDiagram';
 import { ValidationIssue } from '../core/validation';
-import { AssociationEnd, Attribute, DisplayMode, EmbeddableCatalog, Entity, EntityIndex, Geo, GroupCodeCatalog, LangCode, LogicalGroup, ModelId, Operation, Point, PredefinedCustomTypeCatalog } from '../core/types';
+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;
@@ -24,6 +32,11 @@ export type ClipboardContent = {
     kind: 'entity';
     entity: Entity;
     geo: Geo;
+    layoutExtras?: cmd.EntityLayoutExtras;
+} | {
+    kind: 'entities';
+    source: MergeDiagramSource;
+    selectedIds: ModelId[];
 } | {
     kind: 'attribute';
     attributes: Attribute[];
@@ -66,6 +79,10 @@ export interface EditorController {
      * targetRef 없는 이슈(model 레벨)는 인덱스에서 제외(인라인 매칭 대상 아님).
      */
     issuesByRef: ComputedRef<Map<ModelId, ValidationIssue[]>>;
+    /** 이 이슈에 결정적 quick-fix가 있는지(뷰가 '수정' 버튼 노출 여부 판단). 조회 모드에선 항상 false. */
+    hasQuickFix(issue: ValidationIssue): boolean;
+    /** 이슈의 quick-fix 적용(단일 command·undo 가능). 적용됐으면 true, 불가(없음·조회·잠금)면 false. */
+    applyQuickFix(issue: ValidationIssue): boolean;
     /**
      * CHK-DSN-3(모델링된 관계 없는 엔티티) 활성 토글 — 사용자가 검증 패널에서 켠다(기본 off).
      * 비형식 FK 오탐 가능성이 있어 옵트인. read-only에서도 토글 가능(표시 제어라 editable 무관).
@@ -76,6 +93,14 @@ export interface EditorController {
     dirty: Ref<boolean>;
     /** 모델 변경 신호 — 명령 적용마다 단조 증가. 외부 관찰자(감사 패널 등)가 재조회 트리거로 watch(디바운스 권장). */
     revision: Ref<number>;
+    /**
+     * 사용자에게 표시할 일시적 안내(차단된 동작 등) — 뷰가 구독해 토스트로 표시하고 자체 타이머로 dismiss.
+     * `id`는 같은 `text` 반복 시에도 재표시를 트리거하기 위한 단조 증가 값(동일 값 재대입은 watch 미발화이므로).
+     */
+    notice: Ref<{
+        text: string;
+        id: number;
+    } | null>;
     /**
      * 편집 가능 여부 — false(조회 모드)면 모든 모델 변경(추가·삭제·이동·편집·재정렬·연결·붙여넣기·
      * undo/redo·저장)이 차단된다. 선택·팬/줌·hover 강조·복사·export 같은 읽기성 동작은 유지.
@@ -272,6 +297,15 @@ export interface EditorController {
     predefinedCustomTypeCatalog: Ref<PredefinedCustomTypeCatalog>;
     /** 카탈로그 교체(호스트 props 갱신·dev 토글). reactive하므로 셀렉트가 즉시 반영된다. */
     setPredefinedCustomTypeCatalog(catalog: PredefinedCustomTypeCatalog): void;
+    /**
+     * 슈퍼클래스 카탈로그(호스트 주입) — `superClass`(예: BaseEntity) 상속 컬럼(감사필드)을 인덱스 대상
+     * picker/라벨에 파생 투영(projectInheritedColumns)하는 소스. embeddableCatalog와 동형 — dev는 프리셋,
+     * 완전 통합 시 호스트가 superClassCatalog API 값을 주입한다. 비어 있으면 상속 컬럼이 투영되지 않는다
+     * (인덱스는 로컬 컬럼만 참조 — 기능 게이트).
+     */
+    superClassCatalog: Ref<SuperClassCatalog>;
+    /** 카탈로그 교체(호스트 props 갱신·dev 토글). reactive하므로 인덱스 picker가 즉시 반영된다. */
+    setSuperClassCatalog(catalog: SuperClassCatalog): void;
     /**
      * 입력 가능 언어셋(호스트 주입) — 다국어 텍스트(설명·논리명·그룹명) 편집 UI가 노출할 언어 탭 목록·순서.
      * 비어 있으면 안 되며(입력 불가) 미주입 시 기본 4언어(ko/en/ja/zh). reactive하므로 .value 갱신 시 즉시 반영.
@@ -283,6 +317,16 @@ export interface EditorController {
      * languages[0]로 폴백. 미주입 시 'ko'. 라벨 우선 표시 등 확장 여지의 기준점.
      */
     userLanguage: Ref<LangCode>;
+    /**
+     * 툴 크롬(버튼·라벨·툴팁·검증 메시지) 언어(호스트 주입) — 콘텐츠 축 `userLanguage`와 **별개**.
+     * 미주입 시 'ko'(무회귀). reactive하므로 .value 갱신 시 UI 문자열이 즉시 재렌더.
+     */
+    uiLocale: Ref<UiLocale>;
+    /**
+     * UI 문자열 해석기 — `t('mode.edit')` 형태로 뷰가 소비. uiLocale.value를 읽으므로 템플릿에서
+     * 호출 시 로케일 변경에 반응한다. 파라미터는 `{name}` 형태로 치환.
+     */
+    t: Translator;
     /**
      * dataType 셀렉트 후보 셋(CHK-TYPE-1과 공유하는 단일 출처) — dataType 드롭다운(dbTypeSelectItems)이
      * 이 값을 후보로 쓴다. 검증 ctx.selectableDataTypes와 같은 ref라 어포던스(드롭다운)·검증이 어긋나지
@@ -350,13 +394,15 @@ export interface EditorController {
      */
     addEmbedAssociation(ownerEntityId: ModelId, embeddableEntityId: ModelId): ModelId | undefined;
     /**
-     * 임베드 단일(`@Embedded`)↔컬렉션(`@ElementCollection`) 모드 토글. 컬렉션 판정 권위는 임베더블
-     * end multiplicity(결정 3)이며, 이 intent가 multiplicity 변경 + 표시 속성 평탄화 컬럼 재구성 +
-     * collection 메타 set/clear를 **한 composite**로 묶어 모순 상태(컬렉션인데 평탄화 컬럼 잔존)를
-     * 구조적으로 차단한다. COLLECTION→SINGLE 복귀 시 owner 슬롯 `@AttributeOverride`는 버린다(결정 3,
-     * load-only 철학). assocId가 EMBED association이 아니거나 이미 해당 mode면 no-op.
+     * 임베드 카디널리티 설정 — 임베더블 end multiplicity를 지정 값으로 바꾼다. 컬렉션(`@ElementCollection`)
+     * 여부는 이 multiplicity에서 파생되는 값(권위=multiplicity, 결정 3): `*_MORE`(0..N / 1..N)면 컬렉션,
+     * 그 외(1·0..1)면 단일 `@Embedded`(0..1은 nullable). single↔collection **경계를 넘을 때만** 표시 속성
+     * 평탄화 컬럼 재구성 + collection 메타 set/clear를 **한 composite**로 묶어 모순 상태(컬렉션인데 평탄화
+     * 컬럼 잔존)를 구조적으로 차단한다. 단일 내부 전이(1↔0..1)는 평탄화 불변이라 순수 multiplicity patch다.
+     * 컬렉션→단일 복귀 시 owner 슬롯 `@AttributeOverride`는 버린다(결정 3, load-only 철학).
+     * assocId가 EMBED association이 아니거나 이미 해당 multiplicity면 no-op.
      */
-    setEmbedCollectionMode(assocId: ModelId, mode: 'SINGLE' | 'COLLECTION'): void;
+    setEmbedCardinality(assocId: ModelId, multiplicity: Multiplicity): void;
     removeAssociation(assocId: ModelId): void;
     /**
      * 식별 관계 토글 — 자식 FK의 identifier 플래그를 동기화하고, 식별자 집합 변동이
@@ -390,11 +436,34 @@ export interface EditorController {
     autoLayout(): void;
     /**
      * 복사/붙여넣기 클립보드. 엔티티 선택 → 엔티티 통째(새 modelId·offset),
-     * 속성 선택 → 선택 집합(붙여넣기는 현재 선택 엔티티/부모에 append, 동명 충돌 시 _copy).
+     * 속성 선택 → 선택 집합(붙여넣기는 현재 선택 엔티티/부모에 append, 동명 충돌 시 _copy),
+     * 명시 엔티티 집합(다중 선택·그룹 멤버 확장) → 서브그래프(유도 관계·그룹 포함, mergeDiagram 재사용).
      */
     clipboard: Ref<ClipboardContent | null>;
-    copy(): void;
-    paste(): void;
+    /**
+     * @param entityIds 서브그래프로 복사할 엔티티 id 집합(뷰가 다중 선택·그룹 멤버 확장으로 판단해 전달).
+     *   비어 있거나 미전달이면 현재 선택(단일 엔티티/속성 집합) 복사. 단일 엔티티 복사는 뷰가 무인자로 호출.
+     */
+    copy(entityIds?: ModelId[]): void;
+    /** @returns 붙여넣은 엔티티 modelId 목록(뷰가 캔버스 다중선택 반영에 사용). 속성 붙여넣기·무동작 시 빈 배열. */
+    paste(): ModelId[];
+    /**
+     * 타 다이어그램(비즈모듈)의 선택 서브그래프를 현재 다이어그램에 병합 임포트(G1).
+     * 깊은 복사(새 id) + 경계 강등 + 물리명 충돌 suffix는 순수 `mergeDiagram`이 수행하고,
+     * 여기서는 결과를 기존 다이어그램 우측 빈 영역에 배치해 단일 composite로 실행한다(재전파 없음 — D6).
+     */
+    importEntities(source: MergeDiagramSource, selectedIds: ModelId[], opts?: {
+        includeRelated?: boolean;
+        /** 이름/물리명 충돌 접미사(mergeDiagram 위임, 기본 `_imported`). 클립보드 붙여넣기는 `_copy`. */
+        collisionSuffix?: string;
+        /**
+         * 배치 전략. 기본 `'append-right'`(기존 다이어그램 우측 빈 영역 — G1 import).
+         * `{ offset }` 이면 서브그래프를 그 오프셋만큼 통째 시프트(클립보드 붙여넣기 — 원본 근처).
+         */
+        placement?: 'append-right' | {
+            offset: Point;
+        };
+    }): ModelId[];
 }
 export declare const EDITOR: InjectionKey<EditorController>;
 export declare function emptyState(modelId?: string, diagramId?: string): EditorState;
@@ -402,8 +471,11 @@ export declare function createEditorController(initial?: EditorState, options?:
     embeddableCatalog?: EmbeddableCatalog;
     groupCodeCatalog?: GroupCodeCatalog;
     predefinedCustomTypeCatalog?: PredefinedCustomTypeCatalog;
+    superClassCatalog?: SuperClassCatalog;
     languages?: LangCode[];
     userLanguage?: LangCode;
+    /** 툴 크롬 언어(콘텐츠 축 `userLanguage`와 별개). 미주입 시 'ko'(무회귀). */
+    uiLocale?: UiLocale;
     /** `fromPersisted` 산출 meta(트랙 B 마커 + revSeed). schemaVersion·opWriteEnabled로 opMode·read-only 판정. */
     meta?: DiagramMeta;
     /**
@@ -424,6 +496,12 @@ export declare function createEditorController(initial?: EditorState, options?:
      * 미주입이어도 어댑터가 콘솔에 남긴다(정상 rev/layout 충돌은 이 경로가 아님 — throw만).
      */
     onOpError?: (err: unknown) => void;
+    /**
+     * 사용자 안내 통지(차단된 동작 등) — 주입 시 호스트가 자신의 토스트/알림 시스템으로 표시하고,
+     * lib 내장 토스트는 표시하지 않는다(호스트에서 서버 에러 토스트 등과 UX 일원화). 미주입(dev
+     * 하니스·미배선 호스트)이면 lib이 `notice` ref로 자체 토스트를 표시한다. `onOpError`와 동형 seam.
+     */
+    onNotice?: (message: string) => void;
     /**
      * 검증 컨텍스트 — 카탈로그/정책 의존 규칙을 깨우는 호스트 주입(미주입 시 해당 규칙 skip).
      * selectableDataTypes(CHK-TYPE-1)는 코어 상수(SELECTABLE_DATA_TYPES)라 dev/호스트가 즉시 주입 가능.