@g1cloud/entity-modeler-next 5.0.0-beta.27 → 5.0.0-beta.30

package/dist/adapter/healBackfill.d.ts

@@ -1,8 +1,19 @@
 import { ModelId } from '../core/types';
 import { OpShape } from '../command/op';
 import { PDiagram, PDiagramV2 } from './persisted';
+/**
+ * 로드 경로가 파생하는 **속성 스칼라 필드** 목록 — 이 플래너가 raw↔healed diff로 정렬하는 축.
+ *
+ * 전체 필드를 무조건 diff하지 않는 이유: 로드 경로가 의도적으로 바꾸지 않는 필드까지 잡아
+ * 오탐(JSON 왕복의 `null`↔부재 등)을 낼 수 있다. **선언된 목록**이 곧 "무엇이 파생값인가"의
+ * 레지스트리이며, 새 파생 축 추가 = 여기에 이름 한 줄(라우트·플래너 신설 불요).
+ *
+ * - `notNull` : FK는 부모 end 다중성 파생(`deriveFkNotNull`, CC-4). 비-FK 속성은 파생 대상이
+ *   아니지만 파생기가 FK만 건드리므로 diff도 자연히 FK에서만 발생한다.
+ */
+declare const DERIVED_ATTRIBUTE_FIELDS: readonly ["notNull"];
 export interface HealBackfillPlan {
-    /** backfill op 배치 (비면 치유 대상 없음 — 문서 skip). */
+    /** backfill op 배치 (비면 정렬 대상 없음 — 문서 skip). */
     ops: OpShape[];
     /** raw doc의 컨테이너 rev 스냅샷 — `buildAgentBatch(diagramId, revs, ops)` CAS base. */
     revs: Record<ModelId, number>;
@@ -11,10 +22,17 @@ export interface HealBackfillPlan {
         navAdds: number;
         navRefPatches: number;
         identifyingPatches: number;
+        /** 파생 스칼라 필드 정렬 건수(`DERIVED_ATTRIBUTE_FIELDS`) — 필드별 분해. */
+        attributeFieldPatches: number;
+        attributeFieldsByName: Partial<Record<(typeof DERIVED_ATTRIBUTE_FIELDS)[number], number>>;
     };
 }
 /**
- * v2 doc 하나에 대한 heal backfill 계획을 산출한다. v1 doc(마이그레이션이 hydration에서
- * 치유하므로 스윕 비대상)이면 빈 계획을 반환한다.
+ * v2 doc 하나에 대한 파생값 backfill 계획을 산출한다.
+ *
+ * v1 doc은 빈 계획 — 스윕 라우트가 v2 컬렉션 대상이고, v1은 마이그레이션을 거쳐 v2가 된 뒤
+ * 대상이 된다. 마이그레이션 산출은 hydration이 이미 현재 규칙으로 파생하므로(nav 실체화·
+ * identifying·notNull) 새로 마이그레이션된 문서는 정렬된 상태로 태어난다.
  */
 export declare function planHealBackfillOps(doc: PDiagram | PDiagramV2): HealBackfillPlan;
+export {};

package/dist/agent/resolver.d.ts

@@ -43,6 +43,13 @@ export type ResolveError = {
     entity: Handle;
     handle: Handle;
 }
+/** 물리 컬럼을 만들면서 dataType 미지정 — 빈 타입 컬럼은 DDL에서 드롭된다(발명 대신 요구). */
+ | {
+    code: 'datatype-required';
+    opIndex: number;
+    entity: Handle;
+    handle: Handle;
+}
 /** index.add 컬럼 핸들이 엔티티 내 dbAttr와 0개 매칭. */
  | {
     code: 'column-not-found';