@g1cloud/entity-modeler-next 5.0.2 → 5.0.4

package/dist/core/dedupeModelIds.d.ts

@@ -0,0 +1,12 @@
+import { DiagramLayout, LogicalModel } from './types';
+export interface DedupeResult {
+    logical: LogicalModel;
+    layout: DiagramLayout;
+    /** 재발급 건수 — 호출자 로깅·검증용(0이면 no-op이었다). */
+    reissued: number;
+}
+/**
+ * 논리 모델의 modelId 유일성을 회복하고, 소유자를 특정할 수 있는 참조를 새 id로 잇는다.
+ * 레이아웃은 관계 앵커(`source/targetColumnRef`)만 영향을 받는다.
+ */
+export declare function dedupeModelIds(logical: LogicalModel, layout: DiagramLayout): DedupeResult;

package/dist/core/fkDerived.d.ts

@@ -33,5 +33,14 @@ export declare function isFkDerivedColumn(attr: Attribute): boolean;
  * 표시에 쓴다(레거시 getForeignDatabaseAttributePlaceholder 동형). 1순위 derivedFrom.sourceAttributeRef
  * (전파가 심은 권위), 2순위 관계 역참조로 부모 식별자 컬럼(derivedFrom 부재하는 레거시 v1 로드 FK 폴백).
  * 못 찾으면 undefined.
+ *
+ * ★1순위 조회는 **관계가 지목한 부모 안을 먼저** 본다. 속성 modelId는 문서 안에서 유일해야 하지만
+ * 레거시 유래로 **엔티티 간 중복**인 문서가 실재하고(복제 후 이름만 바꾸고 id를 재발급하지 않은 지문),
+ * 그 경우 전역 순회의 first-match는 **배열에서 앞선 엔티티**를 집어 남의 컬럼을 원본으로 삼는다.
+ * 실측(2026-08-21 BNKR_SALES `module-marketing`): `FreeGiftPromo`(배열 35)와 `ProductGiftPromo`(65)가
+ * 속성·dbAttr 13쌍의 modelId를 공유해, 관계상 부모가 `ProductGiftPromo`인 자식 3건이 원본 컬럼을
+ * `product_gift_promo_sn` 대신 `promo_sn`으로 해석했다(DDL·코드젠·캔버스 전부에 전파).
+ * 부모 안에 없으면 종전대로 전역 순회로 폴백하므로, 관계가 stale한 경우의 방어(1순위를 derivedFrom에
+ * 둔 본래 이유)는 그대로다. id가 유일한 문서에서는 두 경로가 같은 속성을 찾아 **결과가 동일하다**.
  */
 export declare function resolveFkOriginColumn(attr: Attribute, childEntity: Entity | null | undefined, entities: readonly Entity[], associations: readonly Association[], i?: number): DbColumn | undefined;