@g1cloud/entity-modeler-next 5.0.0-alpha.24 → 5.0.0-alpha.26

package/dist/i18n/en.d.ts

@@ -0,0 +1,3 @@
+import { MessageKey } from './ko';
+/** UI 크롬 메시지 — 영어. 키 누락 시 컴파일 에러(Record<MessageKey>). */
+export declare const en: Record<MessageKey, string>;

package/dist/i18n/index.d.ts

@@ -0,0 +1,17 @@
+import { en } from './en';
+import { ja } from './ja';
+import { ko, MessageKey } from './ko';
+export type { MessageKey };
+/** UI 크롬 언어. 콘텐츠 `LangCode`의 부분집합(zh 미포함). */
+export type UiLocale = 'ko' | 'en' | 'ja';
+/** UI에서 선택 가능한 로케일 목록(순서 = 표시 순서). */
+export declare const UI_LOCALES: readonly UiLocale[];
+export type MessageParams = Record<string, string | number>;
+/** `t()` 시그니처 — controller가 노출하고 뷰가 소비. */
+export type Translator = (key: MessageKey, params?: MessageParams) => string;
+/**
+ * 키 → 로케일 문자열. `{name}` 형태 파라미터를 치환한다.
+ * 폴백: 로케일에 키 없음 → ko → 키 원문(누락 시각화, 렌더 깨짐 방지).
+ */
+export declare function translate(locale: UiLocale, key: MessageKey, params?: MessageParams): string;
+export { ko, en, ja };

package/dist/i18n/ja.d.ts

@@ -0,0 +1,3 @@
+import { MessageKey } from './ko';
+/** UI 크롬 메시지 — 일본어. 키 누락 시 컴파일 에러(Record<MessageKey>). */
+export declare const ja: Record<MessageKey, string>;

package/dist/i18n/ko.d.ts

@@ -0,0 +1,338 @@
+/**
+ * UI 크롬(툴 사용자용) 메시지 카탈로그 — 한국어(단일 진실 소스).
+ *
+ * 콘텐츠 다국어(MultiLangText: 엔티티/속성 논리명·설명)와는 **별개 축**이다.
+ * 이건 툴 자체의 버튼/라벨/툴팁/검증 메시지를 쓰는 사람의 언어로 보여주기 위한 것.
+ *
+ * `ko`가 키 집합의 SoT — `en`/`ja`는 `Record<MessageKey>`로 선언되어 키 누락이 컴파일 에러가 된다.
+ * 새 문자열은 여기에 키를 먼저 추가하고 en/ja를 채운다.
+ *
+ * 키 규약: `em.area.item`(camelCase). `em.` 프리픽스로 lib 소유 키를 네임스페이싱(CSS `em-`·`EmIcon`
+ * 등 코드베이스 전면 컨벤션과 일관 + 번역 관리 시 호스트 키와 그룹 구분). 파라미터는 `{name}` 형태 삽입.
+ */
+export declare const ko: {
+    readonly 'em.mode.view': "조회";
+    readonly 'em.mode.edit': "편집";
+    readonly 'em.mode.frozen': "편집 잠김 (충돌)";
+    readonly 'em.mode.frozenTitle': "동시편집 충돌로 편집이 잠겼습니다. 최신 내용을 다시 불러오는 중입니다.";
+    readonly 'em.mode.readonlyTitle': "이 다이어그램은 조회 전용입니다";
+    readonly 'em.toolbar.undo': "실행 취소";
+    readonly 'em.toolbar.redo': "다시 실행";
+    readonly 'em.toolbar.displayLabel': "표시";
+    readonly 'em.toolbar.routingToggle': "연결선 모드 전환";
+    readonly 'em.toolbar.routingOrthogonal': "직각";
+    readonly 'em.toolbar.routingStraight': "직선";
+    readonly 'em.toolbar.grid': "그리드";
+    readonly 'em.toolbar.gridOn': "그리드 켜기";
+    readonly 'em.toolbar.gridOff': "그리드 끄기";
+    readonly 'em.toolbar.minimap': "미니맵";
+    readonly 'em.toolbar.minimapOn': "미니맵 켜기";
+    readonly 'em.toolbar.minimapOff': "미니맵 끄기";
+    readonly 'em.toolbar.exportText': "내보내기 (텍스트 · Mermaid)";
+    readonly 'em.toolbar.exportSvg': "SVG 내보내기";
+    readonly 'em.toolbar.exportPng': "PNG 내보내기";
+    readonly 'em.toolbar.history': "이력";
+    readonly 'em.toolbar.historyOpen': "변경 이력 열기";
+    readonly 'em.toolbar.historyClose': "변경 이력 닫기";
+    readonly 'em.toolbar.shortcuts': "키보드 단축키 (?)";
+    readonly 'em.displayMode.logical': "논리";
+    readonly 'em.displayMode.physical': "물리";
+    readonly 'em.displayMode.logicalPhysical': "논리·물리";
+    readonly 'em.displayMode.class': "클래스";
+    readonly 'em.panel.resizeWidth': "너비 조절";
+    readonly 'em.panel.collapse': "접기";
+    readonly 'em.panel.expand': "펼치기";
+    readonly 'em.panel.collapseAll': "모두 접기";
+    readonly 'em.panel.expandAll': "모두 펼치기";
+    readonly 'em.panel.lockedBanner': "편집 잠김 — 이동·수정·삭제 차단";
+    readonly 'em.panel.openNamed': "{name} 열기";
+    readonly 'em.validation.title': "검증";
+    readonly 'em.validation.noIssues': "검증 이슈가 없습니다.";
+    readonly 'em.validation.noVisibleIssues': "표시할 이슈가 없습니다 (필터 적용 중).";
+    readonly 'em.validation.checkOrphanEntities': "관계 없는 엔티티 검사";
+    readonly 'em.validation.nameless': "(이름 없음)";
+    readonly 'em.validation.severityError': "오류";
+    readonly 'em.validation.severityWarning': "경고";
+    readonly 'em.validation.severityInfo': "정보";
+    readonly 'em.validation.hideSeverity': "{label} 숨기기";
+    readonly 'em.validation.showSeverity': "{label} 표시";
+    readonly 'em.validation.expandPanel': "검증 패널 펼치기";
+    readonly 'em.common.close': "닫기";
+    readonly 'em.common.save': "저장";
+    readonly 'em.export.title': "내보내기";
+    readonly 'em.export.formatText': "논리 모델 텍스트";
+    readonly 'em.export.formatMermaidEr': "Mermaid (ER)";
+    readonly 'em.export.formatMermaidClass': "Mermaid (클래스)";
+    readonly 'em.export.copy': "복사";
+    readonly 'em.export.download': "다운로드";
+    readonly 'em.export.copied': "클립보드에 복사되었습니다.";
+    readonly 'em.export.copyFailed': "복사에 실패했습니다.";
+    readonly 'em.shortcuts.title': "키보드 단축키";
+    readonly 'em.shortcuts.groupEdit': "편집";
+    readonly 'em.shortcuts.groupMove': "이동 · 정렬";
+    readonly 'em.shortcuts.groupOther': "기타";
+    readonly 'em.shortcuts.keyArrows': "방향키";
+    readonly 'em.shortcuts.keyRightClick': "우클릭";
+    readonly 'em.shortcuts.descUndo': "실행 취소";
+    readonly 'em.shortcuts.descRedo': "다시 실행";
+    readonly 'em.shortcuts.descCopy': "선택 복사";
+    readonly 'em.shortcuts.descPaste': "붙여넣기";
+    readonly 'em.shortcuts.descDelete': "선택 항목 삭제 (Backspace 동일)";
+    readonly 'em.shortcuts.descMove1': "선택 노드 1px 이동";
+    readonly 'em.shortcuts.descMove10': "선택 노드 10px 이동";
+    readonly 'em.shortcuts.descAttrFocus': "속성 선택 시 포커스 이동";
+    readonly 'em.shortcuts.descAttrReorder': "속성 순서 위/아래로";
+    readonly 'em.shortcuts.descContextMenu': "컨텍스트 메뉴 (엔티티·노트 추가 등)";
+    readonly 'em.shortcuts.descInlineConfirm': "인라인 편집 확정";
+    readonly 'em.shortcuts.descCloseEdit': "편집·메뉴 닫기";
+    readonly 'em.shortcuts.descOpenHelp': "이 도움말 열기";
+    readonly 'em.opSource.title': "본문 — {name}()";
+    readonly 'em.opSource.placeholder': "// Java 구현 코드";
+    readonly 'em.entity.name': "이름";
+    readonly 'em.entity.stereotype': "스테레오타입";
+    readonly 'em.entity.package': "패키지";
+    readonly 'em.panel.unlock': "잠금 해제";
+    readonly 'em.entity.fallback': "엔티티";
+    readonly 'em.group.fallback': "그룹";
+    readonly 'em.common.description': "설명";
+    readonly 'em.common.memo': "메모";
+    readonly 'em.common.color': "색상";
+    readonly 'em.common.add': "추가";
+    readonly 'em.common.inherit': "기본(따름)";
+    readonly 'em.common.noneParen': "(없음)";
+    readonly 'em.swatch.none': "없음";
+    readonly 'em.inspector.ctxEntityAttrs': "엔티티 · {name} › 속성 · {n}개";
+    readonly 'em.inspector.ctxEntityDivider': "엔티티 · {name} › 구분선";
+    readonly 'em.inspector.ctxEntityAttr': "엔티티 · {name} › 속성 · {attr}";
+    readonly 'em.inspector.ctxEntity': "엔티티 · {name}";
+    readonly 'em.inspector.ctxAssoc': "관계 · {a} — {b}";
+    readonly 'em.inspector.ctxGroup': "그룹 · {name}";
+    readonly 'em.inspector.ctxNote': "노트";
+    readonly 'em.inspector.ctxNone': "선택된 항목 없음";
+    readonly 'em.assoc.identifying': "identifying (식별 관계)";
+    readonly 'em.assoc.selfNoIdentifying': "셀프 연관은 식별 관계로 둘 수 없습니다 (비식별 FK 강제).";
+    readonly 'em.assoc.embedNoIdentifying': "임베드(@Embedded/@ElementCollection)는 식별 관계로 둘 수 없습니다 (임베더블은 독립 식별자가 없음).";
+    readonly 'em.assoc.multiplicity': "다중성";
+    readonly 'em.assoc.cascadeAllNote': "ALL이 개별 cascade를 모두 포함합니다 (CHK-JPA-5).";
+    readonly 'em.assoc.orphanRemovalNote': "반대편이 컬렉션(@ManyToOne/@ManyToMany)이라 orphanRemoval이 무효입니다 (CHK-JPA-14).";
+    readonly 'em.assoc.orderByPlaceholder': "예: name ASC";
+    readonly 'em.assoc.jpaDetails': "JPA 상세";
+    readonly 'em.embed.legend': "임베드";
+    readonly 'em.embed.cardinality': "카디널리티";
+    readonly 'em.embed.card1': "1 (필수 @Embedded)";
+    readonly 'em.embed.card01': "0..1 (선택 @Embedded)";
+    readonly 'em.embed.card0N': "0..* (컬렉션 @ElementCollection)";
+    readonly 'em.embed.collectionTablePlaceholder': "미지정 시 코드젠 폴백";
+    readonly 'em.embed.orderColumnPlaceholder': "미지정 시 순서 비보존";
+    readonly 'em.embed.ownerFixedNote': "임베더블은 소유자에 평탄화되므로 소유자 쪽 end(다중성·navigable·composition)는 구조적으로 고정이라 표시하지 않습니다.";
+    readonly 'em.group.nameLegend': "그룹명";
+    readonly 'em.group.excludeDDL': "DDL 생성 제외";
+    readonly 'em.group.members': "멤버 엔티티 {n}개";
+    readonly 'em.entity.classLegend': "클래스";
+    readonly 'em.entity.superClass': "부모 클래스";
+    readonly 'em.entity.superClassPlaceholder': "예: BaseEntity";
+    readonly 'em.entity.interfaces': "구현 인터페이스";
+    readonly 'em.entity.interfacesPlaceholder': "콤마로 구분 (예: Serializable, Cloneable)";
+    readonly 'em.entity.abstractClass': "추상 클래스";
+    readonly 'em.entity.tablePhysical': "테이블(물리)";
+    readonly 'em.entity.schema': "스키마";
+    readonly 'em.entity.schemaPlaceholder': "예: sales, master";
+    readonly 'em.entity.tableLogicalLegend': "테이블 논리명";
+    readonly 'em.entity.discColumn': "Discriminator 컬럼명";
+    readonly 'em.entity.discColumnPlaceholder': "예: DTYPE";
+    readonly 'em.entity.discType': "Discriminator 타입";
+    readonly 'em.entity.discLength': "Discriminator 길이";
+    readonly 'em.entity.hasPersonalInfo': "개인정보 포함 (hasPersonalInfo)";
+    readonly 'em.entity.headerColor': "헤더 색상";
+    readonly 'em.attr.section': "속성 ({n})";
+    readonly 'em.attr.addEmbeddable': "임베더블 추가";
+    readonly 'em.attr.nameless': "(이름 없음)";
+    readonly 'em.attr.selectHint': "위 목록에서 속성을 선택하면 편집 폼이 표시됩니다.";
+    readonly 'em.attr.namePlaceholder': "이름";
+    readonly 'em.attr.typePlaceholder': "타입";
+    readonly 'em.attr.customTypePlaceholder': "커스텀 타입명";
+    readonly 'em.attr.logicalPlaceholder': "논리명";
+    readonly 'em.attr.columnPlaceholder': "컬럼";
+    readonly 'em.attr.defaultValue': "기본값";
+    readonly 'em.attr.codeGroup': "코드그룹";
+    readonly 'em.attr.currencyColumn': "통화 컬럼";
+    readonly 'em.attr.pii': "개인정보";
+    readonly 'em.attr.colFallback': "컬럼 {n}";
+    readonly 'em.attr.sharedOwn': "전용 컬럼(OWN)";
+    readonly 'em.attr.sharedRef': "↗ {owner}{physical} ({mode})";
+    readonly 'em.attr.currencyMode': "통화";
+    readonly 'em.attr.sharedMode': "공유";
+    readonly 'em.attr.batchHint': "선택 {n}개 일괄";
+    readonly 'em.attr.fkDeleteHint': "외래키는 연관관계에서 파생됩니다 — 연관관계선을 삭제하세요";
+    readonly 'em.op.section': "오퍼레이션 ({n})";
+    readonly 'em.op.namePlaceholder': "오퍼레이션명";
+    readonly 'em.op.editBodyDirty': "본문 편집 ●";
+    readonly 'em.op.editBody': "본문 편집";
+    readonly 'em.index.section': "인덱스 ({n})";
+    readonly 'em.index.inherited': "{field} (상속)";
+    readonly 'em.index.namePlaceholder': "인덱스명";
+    readonly 'em.index.addColumn': "컬럼";
+    readonly 'em.index.condition': "조건 (partial index)";
+    readonly 'em.index.conditionPlaceholder': "예: WHERE status = 'A'";
+    readonly 'em.groupCode.searchPlaceholder': "코드그룹 검색/선택";
+    readonly 'em.groupCode.noMatch': "일치하는 코드그룹 없음";
+    readonly 'em.detail.tabBasics': "기본";
+    readonly 'em.detail.tabColumns': "속성";
+    readonly 'em.detail.tabIndexes': "인덱스";
+    readonly 'em.detail.tabOperations': "오퍼레이션";
+    readonly 'em.detail.title': "엔티티 — {name}";
+    readonly 'em.attr.addDivider': "구분선";
+    readonly 'em.attr.columnPhysical': "컬럼(물리)";
+    readonly 'em.attr.constraints': "제약";
+    readonly 'em.attr.dividerLabelPlaceholder': "구분선 라벨(선택)";
+    readonly 'em.attr.dividerNote': "── 시각 구획 ──";
+    readonly 'em.attr.detailCollapse': "상세 접기";
+    readonly 'em.attr.detailExpand': "상세 펼치기";
+    readonly 'em.attr.semanticLegend': "의미";
+    readonly 'em.attr.embedChildCols': "임베더블 — 하위 컬럼 {n}개";
+    readonly 'em.attr.overrideCollapse': "오버라이드 접기";
+    readonly 'em.attr.overrideExpand': "오버라이드 펼치기";
+    readonly 'em.attr.overrideLegend': "컬럼 오버라이드";
+    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': "인덱스 없음 — '추가'로 생성";
+    readonly 'em.index.conditionPlaceholderWide': "예: WHERE status = 'A' AND deleted = false";
+    readonly 'em.index.inheritedColTitle': "슈퍼클래스 상속 컬럼";
+    readonly 'em.index.inheritedBadge': "상속";
+    readonly 'em.index.availColumns': "가용 컬럼 ({n})";
+    readonly 'em.index.indexColumns': "인덱스 컬럼 ({n})";
+    readonly 'em.index.allColumnsUsed': "모든 컬럼 사용됨";
+    readonly 'em.index.addArrow': "추가 →";
+    readonly 'em.index.moveUp': "위로";
+    readonly 'em.index.moveDown': "아래로";
+    readonly 'em.index.removeColumn': "제거";
+    readonly 'em.index.noColumns': "컬럼 없음 — 좌측에서 추가";
+    readonly 'em.index.selectPrompt': "인덱스를 선택하거나 추가하세요.";
+    readonly 'em.palette.autoLayout': "자동 배치";
+    readonly 'em.canvas.emptyTitle': "빈 다이어그램입니다";
+    readonly 'em.canvas.emptyHint': "캔버스를 <strong>우클릭</strong>하거나 좌하단 <strong>+</strong> 버튼으로 첫 엔티티를 추가하세요.";
+    readonly 'em.canvas.emptyShortcutHint': "단축키 도움말은 <kbd>?</kbd> 키";
+    readonly 'em.canvas.emptyReadonly': "표시할 엔티티가 없습니다";
+    readonly 'em.ctx.addEntity': "엔티티 추가";
+    readonly 'em.ctx.addNote': "노트 추가";
+    readonly 'em.ctx.addGroup': "그룹 추가";
+    readonly 'em.ctx.paste': "붙여넣기";
+    readonly 'em.ctx.copy': "복사";
+    readonly 'em.ctx.copyN': "복사 ({n})";
+    readonly 'em.ctx.editDetail': "상세 편집…";
+    readonly 'em.ctx.viewDetail': "상세 보기…";
+    readonly 'em.ctx.lock': "잠금";
+    readonly 'em.ctx.ungroup': "그룹 해제";
+    readonly 'em.ctx.deleteNote': "노트 삭제";
+    readonly 'em.ctx.addAttr': "속성 추가";
+    readonly 'em.ctx.colorN': "색상 ({n})";
+    readonly 'em.ctx.pasteAttr': "속성 붙여넣기";
+    readonly 'em.ctx.pasteAttrN': "속성 붙여넣기 ({n})";
+    readonly 'em.ctx.deleteAttr': "속성 삭제";
+    readonly 'em.ctx.deleteAttrN': "속성 삭제 ({n})";
+    readonly 'em.ctx.addOperation': "오퍼레이션 추가";
+    readonly 'em.ctx.deleteOperation': "오퍼레이션 삭제";
+    readonly 'em.ctx.addMethod': "메서드 추가";
+    readonly 'em.ctx.groupInto': "그룹으로 묶기";
+    readonly 'em.ctx.addSelfAssoc': "셀프 연관 추가";
+    readonly 'em.ctx.addEmbeddableNamed': "임베더블 추가: {label}";
+    readonly 'em.ctx.ungroupEntity': "그룹에서 빼기";
+    readonly 'em.ctx.deleteEntity': "엔티티 삭제";
+    readonly 'em.ctx.clearWaypoints': "꺾은선 풀기";
+    readonly 'em.ctx.deleteConnection': "연결 삭제";
+    readonly 'em.ctx.deleteAssociation': "관계 삭제";
+    readonly 'em.node.keyPfk': "PFK (식별 외래키)";
+    readonly 'em.node.keyPk': "PK (기본키)";
+    readonly 'em.node.keyFk': "FK (외래키)";
+    readonly 'em.node.required': "필수 (NOT NULL)";
+    readonly 'em.node.logicalMissing': "(논리명)";
+    readonly 'em.node.editLock': "편집 잠금";
+    readonly 'em.node.opsSummaryTitle': "오퍼레이션 {n}개 — 클래스 표시 모드에서 펼쳐 보입니다";
+    readonly 'em.node.opsSummary': "오퍼레이션 {n}개";
+    readonly 'em.node.addAttr': "+ 속성";
+    readonly 'em.node.addDivider': "+ 구분선";
+    readonly 'em.group.ddlExcludeBadge': "DDL 제외";
+    readonly 'em.explorer.groupFallback': "(그룹)";
+    readonly 'em.explorer.associations': "관계 ({n})";
+    readonly 'em.explorer.notes': "노트 ({n})";
+    readonly 'em.explorer.emptyNote': "(빈 노트)";
+    readonly 'em.explorer.diagram': "다이어그램";
+    readonly 'em.explorer.searchPlaceholder': "엔티티·속성 검색  ( / )";
+    readonly 'em.explorer.searchAria': "엔티티·속성 검색";
+    readonly 'em.explorer.clearSearchAria': "검색어 지우기";
+    readonly 'em.explorer.clearSearchTitle': "지우기 (Esc)";
+    readonly 'em.explorer.noMatches': "일치하는 엔티티·속성이 없습니다";
+    readonly 'em.history.title': "변경 이력";
+    readonly 'em.history.refresh': "새로고침";
+    readonly 'em.history.loading': "이력을 불러오는 중…";
+    readonly 'em.history.loadError': "이력을 불러오지 못했습니다.";
+    readonly 'em.history.emptyLoaded': "표시할 변경 이력이 없습니다.";
+    readonly 'em.history.emptyNotLoaded': "이력을 불러오세요.";
+    readonly 'em.history.filterAll': "전체";
+    readonly 'em.history.kindEdit': "편집";
+    readonly 'em.history.kindRestore': "복원";
+    readonly 'em.history.verbAdd': "추가";
+    readonly 'em.history.verbUpdate': "수정";
+    readonly 'em.history.verbRemove': "삭제";
+    readonly 'em.history.assocFallback': "연관";
+    readonly 'em.history.groupSubject': "그룹 {name}";
+    readonly 'em.history.emptyValue': "(비움)";
+    readonly 'em.history.noChange': "변경 없음";
+    readonly 'em.history.summaryAdd': "{name} 추가";
+    readonly 'em.history.summaryRemove': "{name} 삭제";
+    readonly 'em.history.summaryFields': "{name} {n}개 변경";
+    readonly 'em.history.summaryMore': "{summary} 외 {n}건";
+    readonly 'em.history.restoreFailed': "복원 실패: {reason}";
+    readonly 'em.history.unknown': "알 수 없음";
+    readonly 'em.history.confirmRestore': "이 시점으로 되돌립니다.";
+    readonly 'em.history.doRestore': "복원";
+    readonly 'em.history.cancel': "취소";
+    readonly 'em.history.restoreToHere': "이 시점으로 복원";
+    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.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.jpa1': "JPA 엔티티에 식별자(PK) 속성이 없습니다";
+    readonly 'em.check.jpa2': "임베더블 타입은 식별자 속성을 가질 수 없습니다: \"{name}\"";
+    readonly 'em.check.jpa4': "식별 관계 사이클입니다 (PK 무한 의존): {path}";
+    readonly 'em.check.jpa5': "{which}: cascade ALL이 개별 cascade와 중복됩니다 (ALL이 모두 포함)";
+    readonly 'em.check.jpa6': "{which}: orphanRemoval이 cascade {cascade}와 의미가 겹칩니다";
+    readonly 'em.check.jpa7': "{which}: 컬렉션(to-many) 연관에 EAGER 페치는 성능 위험이 있습니다";
+    readonly 'em.check.jpa8': "JPA 엔티티에 테이블 물리명이 설정되지 않았습니다";
+    readonly 'em.check.jpa9': "{which}: 단일(to-one) 연관에 컬렉션 메타(collectionType/collectionTable/orderColumn)는 무의미합니다 — @ElementCollection은 컬렉션에서만 적용됩니다";
+    readonly 'em.check.jpa10': "{which}: SET 컬렉션은 순서를 보존하지 않아 orderColumn(@OrderColumn)이 무의미합니다";
+    readonly 'em.check.jpa11': "임베드(@Embedded/@ElementCollection)는 식별 관계로 둘 수 없습니다 — 임베더블은 독립 식별자가 없습니다";
+    readonly 'em.check.jpa12': "식별자(@Id) 속성은 transient(@Transient)일 수 없습니다: \"{name}\"";
+    readonly 'em.check.jpa13AutoIncrement': "채번(auto increment)은 식별자(@Id) 속성에만 쓸 수 있습니다 — 비식별 속성 \"{name}\"에 설정되어 있습니다";
+    readonly 'em.check.jpa13Sequence': "채번(시퀀스 \"{seq}\")은 식별자(@Id) 속성에만 쓸 수 있습니다 — 비식별 속성 \"{name}\"에 설정되어 있습니다";
+    readonly 'em.check.jpa14': "{which}: orphanRemoval은 @ManyToOne/@ManyToMany(반대편이 컬렉션) 연관에는 적용할 수 없습니다 — @OneToOne·@OneToMany에서만 유효합니다";
+    readonly 'em.check.jpa15': "식별자(@Id) 속성은 자연키(@NaturalId)일 수 없습니다 — 자연키는 PK와 별개의 비즈니스 키입니다: \"{name}\"";
+    readonly 'em.check.jpa16': "자연키(@NaturalId) 속성은 transient(@Transient)일 수 없습니다: \"{name}\"";
+    readonly 'em.check.jpa17': "자연키(@NaturalId) 속성은 not null이 권장됩니다(비즈니스 키는 non-null이 원칙): \"{name}\"";
+    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.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.unspecified': "미지정";
+};
+/** 메시지 키 — `ko` 카탈로그의 키 집합(단일 진실 소스). */
+export type MessageKey = keyof typeof ko;

package/dist/index.d.ts

@@ -39,4 +39,5 @@ export { default as EditModeToggle } from './view/EditModeToggle.vue';
 export { default as PropertyPanel } from './view/PropertyPanel.vue';
 export { default as EntityModeler } from './view/EntityModeler.vue';
 export { buildDiagramSvg, exportDiagramSvg, exportDiagramPng } from './view/exportImage';
+export { translate, UI_LOCALES, ko as uiMessagesKo, en as uiMessagesEn, ja as uiMessagesJa, type UiLocale, type MessageKey, type Translator, type MessageParams } from './i18n';
 export { createEditorController, emptyState, EDITOR, type EditorController, type HistoryTransport, type RestoreTransport, type RestoreOutcome, } from './editor/controller';

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

@@ -1,7 +1,9 @@
+import { UiLocale } from '../i18n';
 type __VLS_Props = {
     editable: boolean;
     opMode: boolean;
     frozen?: boolean;
+    locale?: UiLocale;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     toggle: () => any;

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

@@ -1,3 +1,4 @@
+import { UiLocale } from '../i18n';
 import { SwatchToken } from './swatches';
 /**
  * 캔버스 우클릭 메뉴 항목 모델 — 호스트(bluesea) BSContextMenu 의존을 끊고 다이어그램 토큰(--em-*)
@@ -19,8 +20,12 @@ export type EmMenuItem = {
     current: SwatchToken | null;
     onPick: (token: SwatchToken | null) => void;
 };
-declare const _default: import('vue').DefineComponent<{}, {
+declare const _default: import('vue').DefineComponent<{
+    locale?: UiLocale;
+}, {
     open: (event: MouseEvent, menuItems: EmMenuItem[]) => Promise<void>;
     close: () => void;
-}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{
+    locale?: UiLocale;
+}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

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

@@ -1,7 +1,9 @@
 import { GroupCodeCatalogEntry } from '../core/types';
+import { UiLocale } from '../i18n';
 type __VLS_Props = {
     modelValue: string | undefined;
     items: GroupCodeCatalogEntry[];
+    locale?: UiLocale;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:modelValue": (args_0: string | undefined) => any;

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

@@ -1,7 +1,9 @@
+import { UiLocale } from '../i18n';
 type __VLS_Props = {
     operationName: string;
     sourceCode: string;
     onSave: (code: string) => void;
+    locale?: UiLocale;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, 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/ShortcutHelpModal.vue.d.ts

@@ -1,2 +1,6 @@
-declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+import { UiLocale } from '../i18n';
+type __VLS_Props = {
+    locale?: UiLocale;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, 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/TextExportModal.vue.d.ts

@@ -1,3 +1,4 @@
+import { UiLocale } from '../i18n';
 /** 내보내기 포맷 하나 — 탭 라벨·표시 내용·다운로드 파일명. */
 export interface ExportFormat {
     key: string;
@@ -8,6 +9,7 @@ export interface ExportFormat {
 type __VLS_Props = {
     formats: ExportFormat[];
     title?: string;
+    locale?: UiLocale;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, 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/validationDisplay.d.ts

@@ -1,7 +1,19 @@
 import { ModelId } from '../core/types';
 import { ValidationIssue } from '../core/validation';
-/** ruleId('CHK-NAME-3') → 분류 라벨('이름'). 형식 불명 입력은 원문 폴백. */
-export declare function issueCategoryLabel(ruleId: string): string;
+import { MessageKey, Translator } from '../i18n';
+/**
+ * ruleId 네임스페이스(CHK-<NS>-n의 NS) → 비개발자용 분류 카테고리 i18n 키. ruleId 원본('CHK-NAME-3')은
+ * 코드라 일반 사용자가 못 알아보므로 패널은 이 라벨만 노출하고 원 ruleId는 title 툴팁으로만 보존한다.
+ * 미등록 네임스페이스는 null(호출부가 NS 토큰 원문으로 폴백 — 신규 규칙 추가 시 무라벨이 아니라 식별 가능).
+ */
+export declare function issueCategoryKey(ruleId: string): MessageKey | null;
+/** ruleId → 분류 라벨(로컬라이즈). 미등록 NS는 NS 토큰 원문, 형식 불명은 ruleId 원문 폴백. */
+export declare function issueCategoryLabel(t: Translator, ruleId: string): string;
+/**
+ * 이슈 → 로컬라이즈된 메시지. 뷰(패널·인라인 배지)의 단일 진입점. CHK-TYPE-4의 빈 type/dataType은
+ * 표시 폴백('(미지정)')으로 치환한다(core는 빈 문자열만 전달 — 폴백 어휘는 표시 계층 소유).
+ */
+export declare function localizeIssue(t: Translator, issue: ValidationIssue): string;
 /**
  * 이슈가 가리키는 소속 엔티티의 modelId — 패널이 엔티티명 칩을 붙일 대상. targetKind가 entity면
  * targetRef가 곧 엔티티이고, attribute/column/index면 contextRef가 소속 엔티티다(엔진이 그 용도로

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@g1cloud/entity-modeler-next",
   "private": false,
-  "version": "5.0.0-alpha.24",
+  "version": "5.0.0-alpha.26",
   "description": "Vue 3 visual entity-modeling / class-diagram editor",
   "type": "module",
   "files": [