@g1cloud/entity-modeler-next 5.0.0-beta.8 → 5.0.0

package/dist/i18n/ko.d.ts

@@ -47,6 +47,10 @@ export declare const ko: {
     readonly 'em.panel.expandAll': "모두 펼치기";
     readonly 'em.panel.lockedBanner': "편집 잠김 — 이동·수정·삭제 차단";
     readonly 'em.panel.openNamed': "{name} 열기";
+    readonly 'em.notice.readOnly': "조회 모드에서는 편집할 수 없습니다";
+    readonly 'em.notice.entityLocked': "잠긴 엔티티입니다 — 잠금 해제 후 편집하세요";
+    readonly 'em.notice.groupLocked': "잠긴 그룹입니다 — 잠금 해제 후 편집하세요";
+    readonly 'em.notice.assocLocked': "잠긴 엔티티에 연결된 관계입니다 — 잠금 해제 후 편집하세요";
     readonly 'em.validation.title': "검증";
     readonly 'em.validation.noIssues': "검증 이슈가 없습니다.";
     readonly 'em.validation.noVisibleIssues': "표시할 이슈가 없습니다 (필터 적용 중).";
@@ -74,6 +78,7 @@ export declare const ko: {
     readonly 'em.export.copyFailed': "복사에 실패했습니다.";
     readonly 'em.import.title': "가져오기";
     readonly 'em.import.placeholder': "SQL DDL · Mermaid ER · JSON 백업을 붙여넣으세요.";
+    readonly 'em.import.formatGroup': "입력 형식";
     readonly 'em.import.formatAuto': "자동 감지";
     readonly 'em.import.formatMermaid': "Mermaid ER";
     readonly 'em.import.formatDdl': "SQL DDL";
@@ -88,6 +93,11 @@ export declare const ko: {
     readonly 'em.shortcuts.title': "키보드 단축키";
     readonly 'em.shortcuts.groupEdit': "편집";
     readonly 'em.shortcuts.groupMove': "이동 · 정렬";
+    readonly 'em.shortcuts.groupExplorer': "탐색기";
+    readonly 'em.shortcuts.descExplorerSearch': "탐색기 검색으로 포커스";
+    readonly 'em.shortcuts.descExplorerNav': "트리 이동 (←→ 접기·펼치기)";
+    readonly 'em.shortcuts.descExplorerSelect': "항목 선택 + 캔버스 이동";
+    readonly 'em.shortcuts.descExplorerDetail': "엔티티 상세 편집 열기";
     readonly 'em.shortcuts.groupOther': "기타";
     readonly 'em.shortcuts.keyArrows': "방향키";
     readonly 'em.shortcuts.keyRightClick': "우클릭";
@@ -120,6 +130,14 @@ export declare const ko: {
     readonly 'em.common.inherit': "기본(따름)";
     readonly 'em.common.noneParen': "(없음)";
     readonly 'em.swatch.none': "없음";
+    readonly 'em.swatch.red': "빨강";
+    readonly 'em.swatch.amber': "주황";
+    readonly 'em.swatch.green': "초록";
+    readonly 'em.swatch.teal': "청록";
+    readonly 'em.swatch.blue': "파랑";
+    readonly 'em.swatch.indigo': "남색";
+    readonly 'em.swatch.violet': "보라";
+    readonly 'em.swatch.pink': "분홍";
     readonly 'em.inspector.ctxEntityAttrs': "엔티티 · {name} › 속성 · {n}개";
     readonly 'em.inspector.ctxEntityDivider': "엔티티 · {name} › 구분선";
     readonly 'em.inspector.ctxEntityAttr': "엔티티 · {name} › 속성 · {attr}";
@@ -136,6 +154,7 @@ export declare const ko: {
     readonly 'em.assoc.cascadeAllNote': "ALL이 개별 cascade를 모두 포함합니다 (CHK-JPA-5).";
     readonly 'em.assoc.orphanRemovalNote': "반대편이 컬렉션(@ManyToOne/@ManyToMany)이라 orphanRemoval이 무효입니다 (CHK-JPA-14).";
     readonly 'em.assoc.navRequiredNote': "이 방향에 nav 속성이 없어(navigable 꺼짐) cascade·fetch가 적용되지 않습니다.";
+    readonly 'em.assoc.ownerNavFixed': "JPA 소유측 참조(@ManyToOne)는 관계 존재와 동치라 항상 켜집니다 — 참조 없는 FK는 관계 대신 일반 컬럼으로 모델링하세요.";
     readonly 'em.assoc.orderByPlaceholder': "예: name ASC";
     readonly 'em.assoc.jpaDetails': "JPA 상세";
     readonly 'em.embed.legend': "임베드";
@@ -170,6 +189,10 @@ export declare const ko: {
     readonly 'em.attr.nameless': "(이름 없음)";
     readonly 'em.attr.selectHint': "위 목록에서 속성을 선택하면 편집 폼이 표시됩니다.";
     readonly 'em.attr.inverseNavHint': "역방향 연관관계 필드 — 물리 컬럼이 없습니다(대상 엔티티 참조).";
+    readonly 'em.attr.fkDerivedNote': "외래키(FK)에서 파생된 컬럼입니다 — 형상은 부모 PK를 따르며, 변경은 관계선·식별관계에서 하세요.";
+    readonly 'em.attr.scaleTypeHint': "소수부(scale)는 NUMERIC·DECIMAL 타입에만 적용됩니다.";
+    readonly 'em.attr.embedFixedHint': "임베더블 정의에서 고정된 값입니다.";
+    readonly 'em.attr.embedSharedHint': "다른 컬럼과 공유하는 통화 컬럼입니다 — 대상에서 파생(읽기 전용).";
     readonly 'em.attr.namePlaceholder': "이름";
     readonly 'em.attr.typePlaceholder': "타입";
     readonly 'em.attr.customTypePlaceholder': "커스텀 타입명";
@@ -218,7 +241,6 @@ export declare const ko: {
     readonly 'em.attr.empty': "속성 없음 — '추가'로 생성";
     readonly 'em.op.body': "본문";
     readonly 'em.op.bodyDirty': "본문 ●";
-    readonly 'em.op.descPlaceholderKo': "설명(ko)";
     readonly 'em.op.empty': "오퍼레이션 없음 — '추가'로 생성";
     readonly 'em.index.delete': "인덱스 삭제";
     readonly 'em.index.empty': "인덱스 없음 — '추가'로 생성";
@@ -235,6 +257,7 @@ export declare const ko: {
     readonly 'em.index.noColumns': "컬럼 없음 — 좌측에서 추가";
     readonly 'em.index.selectPrompt': "인덱스를 선택하거나 추가하세요.";
     readonly 'em.palette.autoLayout': "자동 배치";
+    readonly 'em.cmd.title': "명령 팔레트";
     readonly 'em.cmd.placeholder': "엔티티로 이동하거나 명령 실행…";
     readonly 'em.cmd.sectionGoto': "이동";
     readonly 'em.cmd.sectionActions': "명령";
@@ -242,8 +265,14 @@ export declare const ko: {
     readonly 'em.cmd.groupTag': "그룹";
     readonly 'em.canvas.emptyTitle': "빈 다이어그램입니다";
     readonly 'em.canvas.emptyHint': "캔버스를 <strong>우클릭</strong>하거나 좌하단 <strong>+</strong> 버튼으로 첫 엔티티를 추가하세요.";
+    readonly 'em.canvas.emptyConnectHint': "엔티티를 두 개 이상 만들면, 엔티티 가장자리에서 <strong>드래그</strong>해 관계를 연결할 수 있어요.";
     readonly 'em.canvas.emptyShortcutHint': "단축키 도움말은 <kbd>?</kbd> 키";
     readonly 'em.canvas.emptyReadonly': "표시할 엔티티가 없습니다";
+    readonly 'em.canvas.exportFailed': "내보내기에 실패했습니다";
+    readonly 'em.conflict.lockedTitle': "편집이 잠겼습니다";
+    readonly 'em.conflict.missingDetail': "변경 사항을 저장하지 못했습니다(서버 또는 네트워크 오류). 최신 내용을 다시 불러오세요.";
+    readonly 'em.conflict.changedDetail': "다른 곳에서 변경되어 편집이 잠겼습니다. 최신 내용을 다시 불러오세요.";
+    readonly 'em.conflict.commandFailedDetail': "편집을 처리하지 못해 화면 내용이 어긋났습니다. 저장된 내용은 그대로이니 최신 내용을 다시 불러오세요.";
     readonly 'em.ctx.addEntity': "엔티티 추가";
     readonly 'em.ctx.addNote': "노트 추가";
     readonly 'em.ctx.addGroup': "그룹 추가";
@@ -278,6 +307,14 @@ export declare const ko: {
     readonly 'em.node.required': "필수 (NOT NULL)";
     readonly 'em.node.logicalMissing': "(논리명)";
     readonly 'em.node.editLock': "편집 잠금";
+    readonly 'em.node.connectHint': "드래그해 다른 엔티티와 관계 연결";
+    readonly 'em.node.embedRepeatedShow': "이 엔티티에서 값이 같아 접힌 컬럼 {count}개 보기";
+    readonly 'em.node.embedRepeatedHide': "값이 같아 반복되는 컬럼 접기";
+    readonly 'em.node.embedAttrHide': "이 임베드 컬럼 접기";
+    readonly 'em.node.embedAttrShow': "접힌 임베드 컬럼 {count}개 보기";
+    readonly 'em.node.embedAllHide': "이 엔티티의 임베드 컬럼 모두 접기";
+    readonly 'em.node.embedAllShow': "접힌 임베드 컬럼 모두 펼치기";
+    readonly 'em.node.embedAllSummary': "임베드 컬럼 {n}개 숨김";
     readonly 'em.node.opsSummaryTitle': "오퍼레이션 {n}개 — 클래스 표시 모드에서 펼쳐 보입니다";
     readonly 'em.node.opsSummary': "오퍼레이션 {n}개";
     readonly 'em.node.addAttr': "+ 속성";
@@ -289,6 +326,7 @@ export declare const ko: {
     readonly 'em.explorer.emptyNote': "(빈 노트)";
     readonly 'em.explorer.diagram': "다이어그램";
     readonly 'em.explorer.searchPlaceholder': "엔티티·속성 검색  ( / )";
+    readonly 'em.explorer.treeAria': "다이어그램 트리";
     readonly 'em.explorer.searchAria': "엔티티·속성 검색";
     readonly 'em.explorer.clearSearchAria': "검색어 지우기";
     readonly 'em.explorer.clearSearchTitle': "지우기 (Esc)";
@@ -319,19 +357,36 @@ export declare const ko: {
     readonly 'em.history.doRestore': "복원";
     readonly 'em.history.cancel': "취소";
     readonly 'em.history.restoreToHere': "이 시점으로 복원";
+    readonly 'em.history.diff.compare': "현재와 비교";
+    readonly 'em.history.diff.current': "현재";
+    readonly 'em.history.diff.exit': "비교 해제";
+    readonly 'em.history.diff.count': "누적 변경 {n}건";
+    readonly 'em.history.diff.empty': "이 구간의 누적 변경이 없습니다.";
+    readonly 'em.history.diff.restorePreview': "되돌아갈 변경 {n}건";
+    readonly 'em.history.diff.restorePreviewNone': "되돌아갈 변경이 없습니다.";
+    readonly 'em.history.loadMore': "이전 기록 더 보기 ({n})";
+    readonly 'em.history.periodLabel': "기간";
+    readonly 'em.history.periodFrom': "시작일";
+    readonly 'em.history.periodTo': "종료일";
+    readonly 'em.history.periodReset': "기간 해제";
     readonly 'em.check.catName': "이름";
     readonly 'em.check.catJpa': "JPA";
     readonly 'em.check.catType': "타입";
     readonly 'em.check.catDsn': "설계";
     readonly 'em.check.name1': "속성 이름이 중복됩니다: \"{name}\"";
     readonly 'em.check.name2': "컬럼 물리명이 중복됩니다: \"{name}\"";
-    readonly 'em.check.name3': "엔티티 이름이 중복됩니다: \"{name}\"";
+    readonly 'em.check.name3Entity': "엔티티 이름이 중복됩니다: \"{name}\" — 같은 이름의 엔티티가 또 있습니다. JPA는 엔티티 이름을 퍼시스턴스 유닛 전역에 등록하므로 패키지(그룹)를 나눠도 해소되지 않습니다";
+    readonly 'em.check.name3Package': "엔티티 이름이 중복됩니다: \"{name}\" — 같은 패키지에 같은 이름이 있습니다. 이름을 바꾸거나 그룹(패키지)을 나누면 해소됩니다";
     readonly 'em.check.name4Entity': "엔티티 이름이 비어 있습니다";
     readonly 'em.check.name4Attr': "속성 이름이 비어 있습니다";
     readonly 'em.check.name5': "물리명이 {max}자를 초과했습니다 ({len}자) — 일부 DB에서 잘릴 수 있습니다";
     readonly 'em.check.name6Column': "컬럼 물리명이 SQL 예약어입니다: \"{name}\"";
     readonly 'em.check.name6Table': "테이블 물리명이 SQL 예약어입니다: \"{name}\"";
     readonly 'em.check.name6Index': "인덱스 이름이 SQL 예약어입니다: \"{name}\"";
+    readonly 'em.check.name7': "관계/임베드 속성({attrType})의 이름이 비어 있습니다 — 이름이 곧 JPA 필드명이라 코드 생성 시 이 관계가 통째로 누락됩니다. 속성명을 채우세요";
+    readonly 'em.check.name8': "속성 \"{name}\"의 컬럼 물리명이 비어 있습니다 — DDL·코드 생성에서 이 컬럼이 통째로 누락됩니다. 물리명을 채우세요";
+    readonly 'em.check.name9': "두 엔티티가 같은 테이블 \"{name}\"에 매핑됩니다 — 컬럼이 한 테이블에 뒤섞입니다. 테이블 물리명을 구분하세요";
+    readonly 'em.check.name10': "인덱스 이름이 중복됩니다: \"{name}\" — 인덱스 이름은 DB 스키마 전역에서 유일해야 합니다";
     readonly 'em.check.jpa1': "JPA 엔티티에 식별자(PK) 속성이 없습니다";
     readonly 'em.check.jpa2': "임베더블 타입은 식별자 속성을 가질 수 없습니다: \"{name}\"";
     readonly 'em.check.jpa4': "식별 관계 사이클입니다 (PK 무한 의존): {path}";
@@ -350,16 +405,23 @@ export declare const ko: {
     readonly 'em.check.jpa16': "자연키(@NaturalId) 속성은 transient(@Transient)일 수 없습니다: \"{name}\"";
     readonly 'em.check.jpa17': "자연키(@NaturalId) 속성은 not null이 권장됩니다(비즈니스 키는 non-null이 원칙): \"{name}\"";
     readonly 'em.check.jpa18': "cascade가 관계 양쪽(부모·자식)에 모두 설정되어 양방향 전파됩니다 — 의도치 않은 연쇄 저장/삭제·전파 사이클 위험. 보통 cascade는 한쪽에만 둡니다";
+    readonly 'em.check.jpa19': "부모에 컬렉션/참조 필드가 있으나 자식({child})에 대응 관계 속성이 없어 JPA 매핑(mappedBy)을 만들 수 없습니다 — 코드젠이 이 관계를 방출하지 못합니다. 자식에 FK 속성을 만들거나 관계를 단방향으로 정리하세요";
+    readonly 'em.check.jpa20': "복합 PK(@IdClass/@EmbeddedId)에는 채번(@GeneratedValue)을 쓸 수 없습니다 — 속성 \"{name}\"에 설정되어 있습니다";
+    readonly 'em.check.jpa21Missing': "임베드 \"{name}\"의 컬럼이 임베더블({embeddable}) 선언보다 적습니다 — 슬롯 {slots} / 선언 {declared}. 뒤에 추가된 컬럼이 반영되지 않아 DDL에서 빠집니다(JPA는 임베더블 선언대로 컬럼을 만듭니다)";
+    readonly 'em.check.jpa21Extra': "임베드 \"{name}\"의 컬럼이 임베더블({embeddable}) 선언보다 많습니다 — 슬롯 {slots} / 선언 {declared}. 임베더블에서 지워진 컬럼이 남아 DDL에 없는 컬럼을 방출합니다";
     readonly 'em.check.type1': "타겟 DB가 지원하지 않는 컬럼 타입입니다: \"{dataType}\"";
     readonly 'em.check.type2': "{dataType} 타입에 length가 지정되지 않았습니다";
     readonly 'em.check.type3': "공유 대상 컬럼의 타입({targetType})이 {metaName} 정의({metaType})와 다릅니다";
     readonly 'em.check.type4': "다중값(Multi-Value) 속성은 GroupCodeEnum + VARCHAR 조합에서만 컨버터가 자동 생성됩니다 — 현재({type} / {dataType})에서는 Set<…> 필드만 생성되어 매핑이 불완전할 수 있습니다";
+    readonly 'em.check.type6': "속성 \"{name}\"의 컬럼에 데이터 타입이 지정되지 않았습니다 — DDL에서 이 컬럼이 생략됩니다";
     readonly 'em.check.dsn1': "both-many(M:N) 관계를 조인 엔티티 없이 직접 연결했습니다 — 연관 엔티티 도입을 검토하세요";
     readonly 'em.check.dsn2': "속성이 하나도 없는 엔티티입니다";
     readonly 'em.check.dsn3': "모델링된 관계가 없습니다 (연관·상속·임베딩 미참여 — 의도적 생략이면 무시)";
     readonly 'em.check.dsn4': "속성이 {count}개로 많습니다 (임계치 {threshold} 초과) — 분해를 검토하세요";
     readonly 'em.check.dsn5Inherited': "인덱스 \"{name}\"가 참조하는 상속 컬럼을 슈퍼클래스 카탈로그에서 찾을 수 없습니다({field}).";
     readonly 'em.check.dsn5Missing': "인덱스 \"{name}\"가 존재하지 않는 컬럼을 참조합니다.";
+    readonly 'em.check.dsn6': "인덱스 \"{name}\"에 컬럼이 없습니다 — 컬럼 없는 인덱스는 DDL·코드 생성에서 산출되지 않습니다";
+    readonly 'em.check.dsn7': "인덱스 \"{name}\"에 같은 컬럼이 두 번 이상 들어 있습니다 — 뒤의 중복 항목은 의미가 없습니다";
     readonly 'em.check.unspecified': "미지정";
 };
 /** 메시지 키 — `ko` 카탈로그의 키 집합(단일 진실 소스). */

package/dist/index.d.ts

@@ -1,19 +1,20 @@
-export * from './core/types';
-export * from './core/resolve';
-export * from './core/routing';
-export * from './core/autolayout';
-export * from './core/text';
-export * from './core/mermaid';
-export * from './core/parseMermaid';
-export * from './core/parseSqlDdl';
-export * from './core/ddl';
-export * from './core/jsonModel';
-export * from './core/svg';
-export * from './core/validation';
-export * from './core/quickFix';
-export * from './core/sharedColumn';
+export type { Association, AssociationEnd, AssociationLayout, Attribute, AttributeType, ClassStereotype, DbColumn, DiagramLayout, DisplayMode, EmbeddableCatalog, EmbeddableCatalogEntry, EmbeddableCatalogField, Entity, EntityIndex, EntityJpaAttrs, EntityLayout, Geo, GroupCodeCatalog, GroupCodeCatalogEntry, GroupCodeValue, GroupLayout, IndexColumn, JpaCascadeType, JpaFetchType, LangCode, LogicalGroup, LogicalModel, ModelId, MultiLangText, Multiplicity, Note, NoteConnection, Operation, OperationVisibility, Point, PredefinedCustomTypeCatalog, PredefinedCustomTypeEntry, Size, Style, SuperClassCatalog, SuperClassColumnDef, SuperClassDef, } from './core/types';
+export { resolveDiagram, type AutoLayoutOptions, type ResolvedAssociation, type ResolvedDiagram, type ResolvedEntity, type ResolvedGroup, type ResolvedNote, type ResolvedNoteConnection, } from './core/resolve';
+export type { Rect, RoutingMode, SegmentMid, Side } from './core/routing';
+export { computeAutoLayout, packEntityBoxes, type AutoLayoutGrid, type EntityBoxSpec, type PackBoxesOptions, type PackedEntityBox, } from './core/autolayout';
+export { displayLabel, entityModelToText } from './core/text';
+export { defaultMermaidDialect, entityModelToMermaid, type MermaidDialect } from './core/mermaid';
+export { mermaidErToImportSource, parseMermaidEr } from './core/parseMermaid';
+export { parseSqlDdl, sqlDdlToImportSource, type ParseSqlDdlResult } from './core/parseSqlDdl';
+export { defaultSqlDialect, entityModelToDdl, type DdlContext, type SqlDialect, } from './core/ddl';
+export { DIAGRAM_JSON_FORMAT, DIAGRAM_JSON_VERSION, InvalidDiagramJsonError, diagramToJson, parseDiagramJson, type DiagramJsonEnvelope, } from './core/jsonModel';
+export { renderDiagramSvg, type Corners, type DiagramGeometry, type SvgBox, type SvgEdge, type SvgHLine, type SvgTextFrag, } from './core/svg';
+export { PHYSICAL_NAME_MAX_LENGTH, validateModel, type IssueSeverity, type IssueTargetKind, type ValidationContext, type ValidationIssue, } from './core/validation';
+export { resolveColumnPhysicalName, resolveEffectiveColumn, type ColumnResolveContext } from './core/columnResolve';
+export { resolveQuickFix, type QuickFixPlan } from './core/quickFix';
+export { collectSharedColumns, resolveSharedColumn, sharedColumnScopeEntities, type ResolvedSharedColumn, } from './core/sharedColumn';
 export { JAVA_TYPES, SELECTABLE_JAVA_TYPES, javaTypeLabel, CUSTOM_TYPE_VALUE, GROUP_CODE_ENUM_VALUE, DEFAULT_JAVA_TYPE, type JavaTypeDef, } from './core/javaTypes';
-export { scaffoldEntityJava, type ScaffoldOptions, type ScaffoldedEntity, } from './core/scaffoldJava';
+export { scaffoldEntityJava, isGeneratable, type ScaffoldOptions, type ScaffoldedEntity, } from './core/scaffoldJava';
 export { migrateLegacyMoney } from './core/migrateLegacyMoney';
 export { multiplicityLabel } from './core/associationNav';
 export { stereotypeLabel } from './core/stereotype';
@@ -22,19 +23,21 @@ export { synthesizeRestoreOps, deepEqual as restoreDeepEqual, type DiagramSnapsh
 export { projectFieldAudit, type FieldAuditRecord, type FieldAuditTarget, type FieldAuditEntry } from './core/projectFieldAudit';
 export { projectEntityAudit, type EntityAuditEntry, type EntityAuditSubject, type EntityAuditSubjectKind } from './core/projectEntityAudit';
 export { projectActionLog, type ActionGroup, type SubjectAction, type ActionSubject, type ActionSubjectKind, type ActionFieldChange } from './core/projectActionLog';
+export { projectSeqDiff, buildDiffMarks, type SeqDiff, type SeqDiffEntry, type DiffMark } from './core/projectSeqDiff';
 export { projectInheritedColumns, makeInheritedColumnRef, isInheritedColumnRef, parseInheritedColumnRef, INHERITED_REF_PREFIX, type InheritedColumn, } from './core/inheritedColumns';
 export { newId } from './core/id';
-export * from './command/types';
+export type { Command, EditorState } from './command/types';
 export { CommandStack, type CommandDirection, type CommandListener } from './command/stack';
 export * as commands from './command/commands';
-export * from './command/op';
+export type { CasUnit, OpCas, OpConflict, OpEmission, OpOrigin, OpResult, OpShape, PersistedOpBatch, } from './command/op';
 export { OpSyncAdapter, RevCache, type OpSyncOptions, type OpSyncTransport } from './command/opSync';
-export * from './agent/symbolicOp';
-export * from './agent/resolver';
-export * from './agent/schema';
-export * from './agent/buildAgentBatch';
-export * from './adapter/diagramAdapter';
-export type * from './adapter/persisted';
+export { SYMBOLIC_OP_KINDS, type AssocHandle, type AssocSpec, type AttrSpec, type EmbeddableColumnOverride, type EntitySpec, type GroupSpec, type Handle, type IndexColumnSpec, type IndexSpec, type OperationSpec, type SymbolicOp, type SymbolicOpKind, } from './agent/symbolicOp';
+export { resolveSymbolicOps, type ResolveError, type ResolveResult, type ResolverOptions, } from './agent/resolver';
+export { APPLY_MODEL_OPS_INPUT_SCHEMA, SYMBOLIC_OP_SCHEMA } from './agent/schema';
+export { buildAgentBatch, type BuildAgentBatchOptions } from './agent/buildAgentBatch';
+export { fromPersisted, toPersisted, toPersistedV2, type DiagramMeta, } from './adapter/diagramAdapter';
+export { planHealBackfillOps, type HealBackfillPlan } from './adapter/healBackfill';
+export type { PAssocEnd, PAssociation, PAttribute, PDbAttr, PDiagram, PDiagramV2, PEntity, PGeo, PGroup, PIndex, PInlineAttribute, PJpaAttrs, PNote, POperation, PStyle, PV2Association, PV2Entity, PV2Group, PV2Layout, PV2Logical, } from './adapter/persisted';
 export { default as EntityNode } from './view/EntityNode.vue';
 export { default as GroupNode } from './view/GroupNode.vue';
 export { default as NoteNode } from './view/NoteNode.vue';

package/dist/view/ColumnLangSelect.vue.d.ts

@@ -0,0 +1,16 @@
+import { LangCode } from '../core/types';
+type __VLS_Props = {
+    modelValue: LangCode;
+    /** 입력 가능 언어셋(호스트 주입 controller.languages). */
+    languages: LangCode[];
+    /** 호스트 콘텐츠 언어(controller.userLanguage) — 초기값이자 추종 대상. */
+    defaultLang: LangCode;
+    /** 그룹 라벨로 쓸 컬럼명 요소의 id. */
+    labelledBy: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: "ko" | "en" | "ja" | "zh") => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: "ko" | "en" | "ja" | "zh") => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/view/DiagramCanvas.vue.d.ts

@@ -1,11 +1,20 @@
+import { DiffMark } from '../core/projectSeqDiff';
 import { EditorController } from '../editor/controller';
+import { ModelId } from '../core/types';
 type __VLS_Props = {
     controller: EditorController;
+    diffMarks?: Map<ModelId, DiffMark> | null;
+    /**
+     * 임베드 반복 서브컬럼 접힘의 sessionStorage 보존 키. 생략 시 미보존(`useResizableWidth`·탐색기와
+     * 같은 opt-in 규약 — 호스트 전역 키 충돌 방지 + read-only 다중 임베드가 서로 덮지 않게).
+     */
+    embedCollapseStorageKey?: string;
 };
 declare function exportSvg(): Promise<void>;
 declare function exportPng(): Promise<void>;
 declare const _default: import('vue').DefineComponent<__VLS_Props, {
     exportSvg: typeof exportSvg;
     exportPng: typeof exportPng;
+    fitView: import('@vue-flow/core').FitView;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/view/DiagramExplorer.vue.d.ts

@@ -1,10 +1,15 @@
 import { EditorController } from '../editor/controller';
 type __VLS_Props = {
     controller: EditorController;
+    /**
+     * 트리 접힘 상태를 sessionStorage 에 보존할 키. **생략 시 보존하지 않는다**
+     * (`useResizableWidth` 규약 동형 — 호스트가 끌 수 있어야 하고, read-only 다중 임베드가
+     * 서로 덮지 않아야 한다. 실제 슬롯은 다이어그램 id 로 한 번 더 갈린다).
+     */
+    storageKey?: string;
 };
-declare function toggleAll(): void;
 declare const _default: import('vue').DefineComponent<__VLS_Props, {
-    toggleAll: typeof toggleAll;
+    toggleAll: () => void;
     allExpanded: import('vue').ComputedRef<boolean>;
     hasExpandable: import('vue').ComputedRef<boolean>;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;

package/dist/view/HistoryPanel.vue.d.ts

@@ -1,3 +1,4 @@
+import { DiffMark } from '../core/projectSeqDiff';
 import { EditorController } from '../editor/controller';
 type __VLS_Props = {
     controller: EditorController;
@@ -5,7 +6,9 @@ type __VLS_Props = {
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     close: () => any;
+    diffChange: (marks: Map<string, DiffMark> | null) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onClose?: (() => any) | undefined;
+    onDiffChange?: ((marks: Map<string, DiffMark> | null) => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/view/MultiLangTextField.vue.d.ts

@@ -12,6 +12,13 @@ type __VLS_Props = {
     placeholder?: string;
     /** textarea 높이(multiline일 때만). */
     height?: string;
+    /**
+     * 제어 모드(opt-in) — 활성 언어를 외부가 소유한다. 와이드 표처럼 한 컬럼에 이 필드가 N개 뜨는 곳에서
+     * 셀마다 탭바를 그리면 행이 두 줄이 되므로(실측 행 높이 36→61px), 선택 UI를 컬럼 헤더로 올리고
+     * 셀은 활성 언어 값만 그린다. 값이 오면 **탭바를 렌더하지 않는다** — 선택 UI 소유자가 둘이면
+     * role·키 계약이 중복된다. 미전달 시 현행(셀 자체 탭바) 동작이라 인스펙터 호출부는 무영향.
+     */
+    activeLang?: LangCode;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:modelValue": (value: Partial<Record<"ko" | "en" | "ja" | "zh", string>>) => any;

package/dist/view/columnResolution.d.ts

@@ -0,0 +1,91 @@
+import { ComputedRef, InjectionKey } from 'vue';
+import { Attribute, DbColumn, EmbeddableCatalog, LogicalModel, ModelId } from '../core/types';
+/**
+ * 캔버스 행 표시에 필요한 **상속·공유 해소를 노드 밖에서 한 번에** 계산한 인덱스 (VE-7 ②).
+ *
+ * ── 왜 노드 밖으로 뺐나 ────────────────────────────────────────────────────────
+ * `EntityNode`가 자기 행을 그리려면 **다른 엔티티를 읽어야 한다**(FK 물리명·타입은 부모 PK에서,
+ * 임베드 슬롯은 임베더블 소스에서, 공유 통화 컬럼은 owner 컬럼에서 상속). 그 읽기가 렌더 이펙트
+ * 안에 있으면 Vue가 `logical.entities`와 **각 엔티티의 `attributes`까지** 노드의 의존으로 추적하므로,
+ * 무관한 엔티티 1개를 추가해도 이 경로를 타는 노드가 전부 무효화된다 — VE-1이 좁혀 둔 스코프가
+ * 되돌아간다. 실측(module-order 미러 시드 188노드): 엔티티 추가 1회에 EntityNode patch **124**,
+ * 해소 두 축을 끄면 **4**(각 축 단독으로도 발동 · 이 경로를 타는 노드 169/188).
+ *
+ * ── 무엇을 dedup 하는가 ───────────────────────────────────────────────────────
+ * 노드별 해소는 각자 자기 속성만 처리하므로 **중복이 아니다**(총 작업량은 같다). 실제 중복은
+ * `indexColumnsByModelId(collectSharedColumns(...))`를 **임베드 속성마다** 다시 만들던 것 하나이고
+ * (그 안의 owner 역참조는 embeddable 노드에서 전 엔티티 스캔이다) → **엔티티별 1회**로 접었다.
+ * 상속·스코프 계산 자체는 core 헬퍼(`collectSharedColumns`·`resolveEffectiveColumn`·
+ * `resolveFkOriginColumn`·`embedCollectionType`)를 **그대로 호출한다** — 시맨틱을 여기 옮겨 적으면 이
+ * 리포가 반복해서 싸운 미러 드리프트(VE-4 축)를 뷰 계층에 새로 만드는 셈이다. ★초안에서 owner 역참조
+ * 맵을 직접 만들어 `sharedColumnScopeEntities`의 규칙을 재구현했다가 **되돌렸다**: 그것이 그 규칙의 네
+ * 번째 사본이 되는데, 참조 안정화가 이미 성능 목표(하한)를 달성했으므로 그 최적화는 드리프트 위험만
+ * 남기고 얻는 게 없었다(실측 차이 없음 — 헤더 하단 수치).
+ *
+ * ── 반복 서브컬럼(redundantSlots) ─────────────────────────────────────────────
+ * 임베드 서브행은 캔버스 렌더 행의 큰 몫인데(실측 BNKR_SALES v2 576엔티티: 속성 6,214 + 서브행 2,683 =
+ * **30.2%**), 그중 상당수가 **엔티티 안에서 같은 값을 반복**한다. 지배적 형상은 Money의 currency 슬롯이다:
+ *   - 미지정(빈 슬롯) 656건 → 카탈로그 기본명 `'currency'`로 해소되어 전부 같은 이름
+ *     (그중 613건은 한 엔티티에 2개 이상이라 `CHK-NAME-2` 컬럼 충돌까지 유발한다 — OrderItem 59/59)
+ *   - 공유 지정(SHARED_REF) 43건 → `Claim.order_local_currency` **하나를 43개가 함께 가리킨다**
+ * 즉 **정상 지정된 경우에도 반복**이고(오히려 더 완전한 반복이다), 그 43행이 주는 정보는 "이 엔티티의
+ * Money는 저 통화 컬럼을 공유한다" 한 줄이다. 반대로 amount 슬롯은 704건 전부 고유 물리명을 가져
+ * 같은 규칙에서 자동으로 빠진다 — 판정 축은 "상속이냐"가 아니라 **"엔티티 안에서 새 정보를 주느냐"**다.
+ *
+ * 판정: 같은 `(attrType, 임베더블 타입, 슬롯 인덱스)` 자리를 묶고, 그 안에서 실효 물리명이 **2회 이상
+ * 나오는 값**을 가진 슬롯만 반복으로 본다(자리가 2개 이상일 때). Money 하드코딩 없이 Tel·Name·Address는
+ * 사용처마다 물리명을 오버라이드하고 있어 자동으로 걸러진다(실측: Tel #0·#1은 상속 0/고유 37).
+ *
+ * ★★판정이 **값 단위**인 이유: 종전엔 그룹이 *전부* 같을 것을 요구했는데, 그러면 한 자리만 달라도 나머지
+ * 반복분까지 통째로 안 접힌다. 실 데이터가 정확히 그 형상이 됐다 — 코드↔모델 sync 로 Money currency 가
+ * SHARED_REF(공유 통화 컬럼)·OWN(고유 컬럼)·빈 슬롯으로 갈리면서 `SalesOrder` 53자리가 **14종**,
+ * `OrderItem` 66자리가 **19종**이 됐고 접힘이 꺼졌다. 그런데 그중 `order_local_currency` 40·48행은
+ * 여전히 서로 같은 말을 반복한다(새 정보 0). ⇒ 축("새 정보를 주느냐")은 자리 단위가 아니라 값 단위로
+ * 성립한다. 초기 표본(`Claim` SHARED_REF 43건이 **전부** 같은 타깃)이 균일해서 이 차이가 안 보였다.
+ *
+ * ★뷰는 이것을 **기본 접힘**으로만 쓴다(행을 지우지 않는다) — 접힌 자리에 숨긴 개수를 표시하고 캐럿으로
+ * 펼치면 전부 보인다. 위 613건처럼 `CHK-NAME-2`가 걸린 슬롯도 여기 포함되지만, 그 신호의 소유자는
+ * 검증 패널이고 이 모듈은 **표시 반복만** 접는다(미완성 상태를 지우지 않는다).
+ *
+ * ── 계약 ─────────────────────────────────────────────────────────────────────
+ * 순수 함수다(모델을 변형하지 않고 표시용 파생값만 만든다). 값 시맨틱은 종전 `EntityNode`의 세 함수
+ * (`effectiveAttr`·`embedCols`·`typeCell`의 collectionType)와 **동일**해야 한다 — 이 모듈은 성능 리팩터이고
+ * 표시 결과를 바꾸지 않는다(`redundantSlots`는 그 뒤에 얹힌 **표시 힌트**이고, 소비는 뷰가 결정한다).
+ * 해소가 불필요한 속성은 **맵에 넣지 않는다**(호출자가 원본을 쓴다) ⇒ 인덱스 미주입(read-only 임베드)이면
+ * 종전 `!editor` 폴백과 같은 원형 표시가 된다.
+ *
+ * 판정은 **엔티티 로컬**이다(다른 엔티티를 읽지 않는다) — 위 「참조 안정화」가 좁혀 둔 무효화 범위를
+ * 넓히지 않기 위해서다.
+ */
+export interface EntityColumnResolution {
+    /** attr modelId → FK 상속 해소된 표시용 속성. 해소가 일어난 속성만 포함. */
+    effectiveAttrs: ReadonlyMap<ModelId, Attribute>;
+    /** attr modelId → 임베드 펼침 컬럼(상속·공유 해소 적용). EMBED 속성만 포함. */
+    embedCols: ReadonlyMap<ModelId, DbColumn[]>;
+    /** attr modelId → 컬렉션 임베드 래핑 타입. 단일 임베드(undefined)는 포함하지 않는다. */
+    collectionTypes: ReadonlyMap<ModelId, 'LIST' | 'SET'>;
+    /**
+     * attr modelId → **반복 서브컬럼** 슬롯 인덱스. 같은 `(임베더블 타입, 슬롯 위치)` 자리들 중 실효 물리명이
+     * 그 엔티티 안에서 **2회 이상 나오는 값**을 가진 슬롯을 담는다 — 아래 「반복 서브컬럼」 참조. 그 자리에서
+     * 고유한 값(1회)은 새 정보이므로 포함하지 않고, 반복이 없는 속성은 맵에 아예 넣지 않는다.
+     */
+    redundantSlots: ReadonlyMap<ModelId, ReadonlySet<number>>;
+}
+/** 엔티티 modelId → 그 엔티티 행들의 해소 결과. */
+export type ColumnResolutionIndex = ReadonlyMap<ModelId, EntityColumnResolution>;
+/**
+ * 캔버스가 provide, `EntityNode`가 inject. 미주입 시 노드는 원형(raw) 표시로 graceful degrade한다
+ * (종전 `!editor` 분기와 동일한 폴백) — 독립 렌더·테스트에서 캔버스 없이 노드를 쓸 수 있게 유지.
+ */
+export declare const COLUMN_RESOLUTION: InjectionKey<ComputedRef<ColumnResolutionIndex>>;
+/**
+ * 참조 안정 인덱서 — 직전 인덱스를 기억해 **내용이 같은 엔티티는 이전 결과 객체를 재사용**한다.
+ * 캔버스가 computed 안에서 호출한다(모델 변경당 1회). 상태를 갖는 이유는 위 「참조 안정화」 참조.
+ */
+export declare function createColumnResolutionIndexer(): (model: LogicalModel, catalog?: EmbeddableCatalog) => ColumnResolutionIndex;
+/**
+ * 모델 전체의 표시 해소 인덱스를 만든다. `catalog`는 EMBED_PREDEF 서브컬럼의 선언값 출처(호스트 주입) —
+ * 미주입이면 그 축만 원형으로 degrade한다(종전 `editor?.embeddableCatalog` 분기 동형).
+ * `prev`를 주면 내용이 같은 엔티티의 결과 **객체 참조를 재사용**한다(무효화 범위 축소 — 위 문단).
+ */
+export declare function buildColumnResolutionIndex(model: LogicalModel, catalog?: EmbeddableCatalog, prev?: ColumnResolutionIndex): ColumnResolutionIndex;

package/dist/view/diffOverlay.d.ts

@@ -0,0 +1,14 @@
+import { InjectionKey, Ref } from 'vue';
+import { ModelId } from '../core/types';
+import { DiffMark } from '../core/projectSeqDiff';
+/**
+ * 이력 diff 비교 모드의 캔버스 오버레이 주입 계약(RELATION_HIGHLIGHT 동형 — 일시적 시각 강조,
+ * 모델 무관). 셸(EntityModeler/DevApp)이 HistoryPanel의 비교 diff 마크를 소유하고 DiagramCanvas가
+ * prop으로 받아 provide, EntityNode가 구독한다(D4-(a) 뷰 소유 — core/controller 무변경).
+ *
+ * null = 비교 모드 아님(오버레이 없음). removed 대상은 캔버스에 노드가 없어 맵에 없다(D3 패널 전용).
+ */
+export interface DiffOverlay {
+    marks: Ref<Map<ModelId, DiffMark> | null | undefined>;
+}
+export declare const DIFF_OVERLAY: InjectionKey<DiffOverlay>;

package/dist/view/embedSlotCollapse.d.ts

@@ -0,0 +1,36 @@
+import { InjectionKey } from 'vue';
+export interface EmbedSlotCollapseApi {
+    /** 이 키가 지금 접혀 있는가. 기본값은 축마다 다르다(헤더 표 참조). */
+    isCollapsed: (key: string) => boolean;
+    /** 접힘 토글 — 조회 모드에서도 허용된다(읽기 편의이지 편집이 아니다). */
+    toggle: (key: string) => void;
+}
+/**
+ * 미주입이면 노드는 **전부 펼친 원형 표시**로 degrade 한다(`COLUMN_RESOLUTION` 폴백과 같은 방향) —
+ * 캔버스 없이 노드를 독립 렌더·테스트할 수 있게 유지한다.
+ */
+export declare const EMBED_SLOT_COLLAPSE: InjectionKey<EmbedSlotCollapseApi>;
+/**
+ * 반복 슬롯 축의 키. 속성 modelId 단독이 아니라 엔티티를 접두로 붙인다 — 레거시 유래 데이터에
+ * **속성 modelId 중복**이 실재하기 때문이다(CC-V 실측: 같은 중복 id 가 v1·v2 양쪽에 존재).
+ */
+export declare const embedSlotKey: (entityId: string, attrId: string) => string;
+/** 엔티티 일괄 축 키의 접두 — 기본값 분기(`defaultCollapsed`)가 이것으로 축을 가른다. */
+export declare const ENTITY_FOLD_PREFIX = "all:";
+/** 속성 통째 축 키의 접두. */
+export declare const ATTR_FOLD_PREFIX = "one:";
+/**
+ * 엔티티 일괄 축의 키. `modelId`는 UUID 라 `:` 를 담지 않으므로 접두 있는 키는 반복 축 키와
+ * 절대 겹치지 않는다(반복 축 키의 접두는 항상 엔티티 UUID 다).
+ */
+export declare const embedAllKey: (entityId: string) => string;
+/**
+ * 속성 통째 축의 키. 반복 축과 **같은 (엔티티, 속성) 쌍을 가리키되 다른 축**이라 접두로만 갈린다 —
+ * 둘은 동시에 상태를 가질 수 있고(통째를 풀면 반복 접힘이 그대로 살아난다) 그것이 의도다.
+ */
+export declare const embedAttrKey: (entityId: string, attrId: string) => string;
+/**
+ * 이 키의 기본 접힘 여부 — 캔버스가 `useTreeCollapse`에 그대로 넘긴다. **키의 순수 함수**여야 하며
+ * (그 헤더 ①·②), 축별 기본값 근거는 이 모듈 헤더의 표에 있다. 접두가 없는 키(=반복 축)만 접힘이다.
+ */
+export declare const embedDefaultCollapsed: (key: string) => boolean;

package/dist/view/nodeInternals.d.ts

@@ -0,0 +1,15 @@
+import { InjectionKey } from 'vue';
+/**
+ * 노드 내부 handle 재측정 요청 수집기 (VE-1 ①) — 캔버스가 provide, EntityNode가 onUpdated마다
+ * 자기 id를 mark(무비용 후보 등록). 캔버스는 rAF 배치 flush에서 후보의 기하 시그니처(노드 높이 +
+ * 행별 y)를 비교해 **실제로 변한 노드만** `updateNodeInternals(ids)`로 재측정한다.
+ *
+ * 왜 시그니처 판정이 필수인가: Vue Flow의 updateNodeInternals는 forceUpdate로 handleBounds를
+ * 무조건 새 객체로 써 그 노드를 다시 재렌더시킨다 — 재렌더를 무조건 mark하면 측정→재렌더→측정
+ * 무한 루프. 시그니처가 무변화면 측정을 생략해 루프가 한 사이클 만에 종료된다. 부수 효과로
+ * 텍스트-only 변경·hover 강조 재렌더도 재측정에서 자연 제외된다.
+ */
+export interface NodeInternalsCollector {
+    mark: (nodeId: string) => void;
+}
+export declare const NODE_INTERNALS: InjectionKey<NodeInternalsCollector>;

package/dist/view/opConflictNotice.d.ts

@@ -1,12 +1,14 @@
 import { OpConflict } from '../command/op';
+import { MessageKey } from '../i18n';
 export interface OpConflictNotice {
-    /** 배너 제목 — 상태 자체(무엇이 일어났는지). */
-    title: string;
-    /** 배너 본문 — 원인 + 복구 방향(다시 불러오기). */
-    detail: string;
+    /** 배너 제목 키 — 상태 자체(무엇이 일어났는지). 뷰가 t()로 렌더. */
+    titleKey: MessageKey;
+    /** 배너 본문 키 — 원인 + 복구 방향(다시 불러오기). 뷰가 t()로 렌더. */
+    detailKey: MessageKey;
 }
 /**
- * 충돌 종류 → 사용자 문구. `missing`은 동시편집이 아니라 전송 실패(혼자 편집 중에도 발생)라 원인을
- * 구분한다(호스트 배선 경로와 동일한 kind 오진 방지). null → null(배너 미노출).
+ * 충돌 종류 → 사용자 문구 **키**(문구는 i18n 카탈로그 소유 — 검증 P3 code+params→뷰 지역화 패턴 동형).
+ * `missing`은 동시편집이 아니라 전송 실패(혼자 편집 중에도 발생)라 원인을 구분한다
+ * (호스트 배선 경로와 동일한 kind 오진 방지). null → null(배너 미노출).
  */
 export declare function opConflictNotice(conflict: OpConflict | null | undefined): OpConflictNotice | null;

package/dist/view/swatches.d.ts

@@ -1,3 +1,4 @@
+import { MessageKey } from '../i18n';
 import { Style } from '../core/types';
 export type SwatchToken = 'red' | 'amber' | 'green' | 'teal' | 'blue' | 'indigo' | 'violet' | 'pink';
 /** 토큰의 컨텍스트별 렌더값 (CSS 변수 참조 — 테마는 [data-theme]로 스왑) */
@@ -31,7 +32,7 @@ export declare function resolveSwatch(token: SwatchToken | null): SwatchRender |
  * @param soft 그룹처럼 반투명 칠이 필요하면 true.
  */
 export declare function swatchMinimapFill(token: SwatchToken | null, soft?: boolean): string | null;
-/** 피커 라벨 */
-export declare function swatchLabel(token: SwatchToken): string;
+/** 피커 라벨 키 — 소비처가 `t(swatchLabelKey(token))`으로 로케일 렌더 */
+export declare function swatchLabelKey(token: SwatchToken): MessageKey;
 /** 피커에 칠할 대표색 (바 색 — 피커도 [data-theme]에 따라 전환) */
 export declare function swatchSwatchColor(token: SwatchToken): string;