@g1cloud/entity-modeler-next 5.0.2 → 5.0.5

package/dist/i18n/ko.d.ts

@@ -247,6 +247,9 @@ export declare const ko: {
     readonly 'em.index.conditionPlaceholderWide': "예: WHERE status = 'A' AND deleted = false";
     readonly 'em.index.inheritedColTitle': "슈퍼클래스 상속 컬럼";
     readonly 'em.index.inheritedBadge': "상속";
+    readonly 'em.index.colUnspecified': "{name} (컬럼 {n}개 중 미지정)";
+    readonly 'em.index.multiColumn': "{name} (컬럼 {n}개)";
+    readonly 'em.index.unnamedAttr': "(이름 없음)";
     readonly 'em.index.availColumns': "가용 컬럼 ({n})";
     readonly 'em.index.indexColumns': "인덱스 컬럼 ({n})";
     readonly 'em.index.allColumnsUsed': "모든 컬럼 사용됨";

package/dist/index.d.ts

@@ -16,6 +16,7 @@ export { collectSharedColumns, resolveSharedColumn, sharedColumnScopeEntities, t
 export { JAVA_TYPES, SELECTABLE_JAVA_TYPES, javaTypeLabel, CUSTOM_TYPE_VALUE, GROUP_CODE_ENUM_VALUE, DEFAULT_JAVA_TYPE, type JavaTypeDef, } from './core/javaTypes';
 export { scaffoldEntityJava, isGeneratable, type ScaffoldOptions, type ScaffoldedEntity, } from './core/scaffoldJava';
 export { migrateLegacyMoney } from './core/migrateLegacyMoney';
+export { dedupeModelIds, type DedupeResult } from './core/dedupeModelIds';
 export { multiplicityLabel } from './core/associationNav';
 export { stereotypeLabel } from './core/stereotype';
 export { mergeDiagram, type MergeDiagramSource, type MergeDiagramOptions, type MergeDiagramResult, } from './core/mergeDiagram';

package/dist/view/indexColumnLabel.d.ts

@@ -0,0 +1,60 @@
+import { Attribute, EmbeddableCatalog, Entity, LogicalModel, ModelId } from '../core/types';
+import { InheritedColumn } from '../core/inheritedColumns';
+import { IndexRefResolver } from '../core/indexColumnRef';
+import { Translator } from '../i18n';
+/**
+ * 인덱스 편집 뷰의 **컬럼 표시 라벨** 단일 출처 — 인스펙터(`EntityIndexSection`)와 와이드
+ * (`EntityIndexesWide`)가 같은 규칙으로 라벨을 만든다.
+ *
+ * ── 왜 뽑았나 ─────────────────────────────────────────────────────────────────
+ * 두 뷰가 각자 라벨을 조립하면서 **서로 다른 반쪽**을 갖고 있었다(VE-4 미러 드리프트 축):
+ *  - 와이드 `colLabel`은 **속성 modelId만** 조회해 **레거시 dbAttr 표기 ref가 UUID 원문**으로 보였다.
+ *    실 데이터 인덱스 컬럼은 거의 전량 그 표기이므로(797/860 실측) 정상 컬럼까지 UUID로 렌더됐고,
+ *    그래서 **깨진 행(dangling)과 구분이 안 됐다**.
+ *  - 인스펙터 `fallbackLabel`은 dbAttr까지 찾았지만 `physicalName || ref`라, **FK 파생 컬럼**(물리명을
+ *    비우고 부모 PK 컬럼명을 상속하는 정상 형상)에서 빈 문자열을 만나 결국 UUID로 떨어졌다.
+ *
+ * 결과는 *"인덱스 모달에서 FK를 지목할 방법이 없다"*는 사용자 보고였다 — 지목 대상은 목록에 있는데
+ * (FK는 전파 산출로 속성이 이미 존재한다) **화면의 라벨이 실제 컬럼명을 말해주지 않아** 코드의
+ * `order_area_code`와 연결할 근거가 없었다.
+ *
+ * ── 규칙 ─────────────────────────────────────────────────────────────────────
+ * 물리명은 항상 **실효 값**(`resolveColumnPhysicalName` = 상속 해소 단일 출처)으로 읽는다. 캔버스
+ * (`columnResolution`)·DDL·코드젠이 이미 그 함수를 쓰므로 라벨이 산출물과 같은 이름을 보인다.
+ * 표기 두 종(편집 뷰=속성 modelId / 레거시 로드=dbAttr modelId)은 `IndexRefResolver`가 접는다.
+ *
+ * ★i18n 문자열은 이 모듈이 소유하지 않는다 — 호출자가 `t`를 넘긴다(뷰 계층 규약). 순수 함수이므로
+ * 단위 테스트 대상이다(`view/` ② 순수 헬퍼 분류).
+ */
+export interface IndexLabelContext {
+    entity: Entity;
+    logical: LogicalModel;
+    resolver: IndexRefResolver;
+    /** superClass 파생 투영(상속 감사 컬럼). 미주입이면 상속 ref는 원문으로 남는다. */
+    inherited?: readonly InheritedColumn[];
+    /** EMBED_PREDEF 서브컬럼 상속 해소용(호스트 주입 카탈로그). */
+    embeddableCatalog?: EmbeddableCatalog;
+    /** i18n 번역기 — `em.index.colUnspecified`(컬럼 미지정)·`em.index.unnamedAttr`(이름 없는 속성). */
+    t: Translator;
+}
+/**
+ * **후보 목록** 라벨(가용 컬럼 패널·셀렉트 항목) — `속성명 (실효 물리명)`.
+ * 종전 두 뷰의 차이도 여기서 흡수한다: 와이드는 `name (phys)`를, 인스펙터는 `name`만 냈다.
+ *
+ * ★**다중 컬럼 속성은 컬럼 수만 밝힌다** — 종전엔 첫 슬롯 물리명을 대표로 내세워(`name (name_1)`)
+ * *그 컬럼을 넣는다*는 오해를 만들었다. 실제로 후보는 **속성 단위 ref** 라 인덱스에 들어가면 어느
+ * 컬럼인지 미지정이고(행 라벨이 그렇게 표시한다) 산출물에서 생략된다 ⇒ 두 패널이 같은 말을 하게 한다.
+ * 컬럼 단위로 고를 수 있게 만드는 것은 별 항목(「인덱스 컬럼 단위 어포던스」)이고, 이 표기는 그때까지
+ * 오해를 만들지 않기 위한 최소 정정이다.
+ */
+export declare function candidateColumnLabel(attr: Attribute, ctx: IndexLabelContext): string;
+/**
+ * **인덱스 컬럼 행** 라벨 — ref가 지목한 대상을 사람이 읽을 이름으로. 판정 순서:
+ *  1. 상속 컬럼 ref(`inherited:<Base>:<field>`) → 필드명(+ 상속 표기는 호출자 배지 소관)
+ *  2. 속성이 해소되고 **컬럼이 특정되면** → `속성명 (실효 물리명)`
+ *  3. 속성은 있는데 컬럼이 미특정(다중 컬럼 속성 ref) → `속성명 (컬럼 미지정)`
+ *     ★어느 컬럼인지는 사용자 결정이므로 임의 슬롯을 고르지 않는다(모르는 값 발명 금지).
+ *  4. 아무것도 못 찾음(dangling, `CHK-DSN-5`) → **ref 원문**. 진단 가능성을 남기는 종전 계약이고,
+ *     이제 정상 컬럼은 전부 이름으로 보이므로 원문 UUID가 곧 *"이 행이 깨졌다"*는 신호가 된다.
+ */
+export declare function indexColumnRowLabel(ref: ModelId, ctx: IndexLabelContext): string;

package/package.json

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