@g1cloud/entity-modeler-next 5.2.41 → 5.2.43

package/dist/core/ddl.d.ts

@@ -1,8 +1,25 @@
-import { EmbeddableCatalog, LogicalModel } from './types';
+import { EmbeddableCatalog, LangCode, LogicalModel } from './types';
 export type SqlDialect = 'postgres';
 export interface DdlContext {
     /** EMBED_PREDEF 서브컬럼의 카탈로그 기본 물리명 해석용(validateModel과 동형 주입). */
     embeddableCatalog?: EmbeddableCatalog;
+    /**
+     * `COMMENT ON` 을 낼 **로케일**. 미주입이면 주석을 **아예 내지 않는다**.
+     *
+     * ★★**「옵션이냐 항상이냐」를 따로 두지 않은 이유** — DDL 주석은 본질적으로 **로케일에 묶인 값**이라
+     * *「어느 언어로 낼지 모른다」* 와 *「낼지 말지 모른다」* 가 같은 물음이다. 플래그를 따로 두면 두 축이
+     * 갈려 `commentLocale` 없이 `emitComments:true` 같은 **답 없는 조합**이 생긴다. 미주입=미방출은
+     * 「모르는 값 규약」의 이 축 사본이다(모르면 발명하지 않고 침묵한다).
+     *
+     * ★**호출자가 넘길 것은 «프로젝트 기본 언어»이지 «접속 유저 언어»가 아니다** — 레거시가 그렇게 했고
+     * (`AbstractSrcGen.getDefaultLanguage()` = `systemSetting.language`), DDL 주석은 **DB 에 굳는 값**이라
+     * 접속자에 따라 산출이 달라지면 안 된다. controller 의 `userLanguage`(접속 유저)를 그대로 넘기지 말 것.
+     *
+     * ⚠️**로케일 폴백을 «하지 않는다»**(`pickMultiLangText` 를 쓰지 않는 유일한 논리명 소비처다). 지정 로케일이
+     * 비면 그 `COMMENT` 문을 **통째로 생략**한다 — 레거시 동형(`DatabaseCommentBuilder` 가 `isBlank` 로
+     * 건너뛴다)이고, 폴백하면 「ja 논리명을 모른다」가 「ko 값이다」로 바뀌어 **DB 에 굳는다**.
+     */
+    commentLocale?: LangCode;
 }
 /** 표시 모드 → 기본 DDL 방언. 현재는 PG 단일. */
 export declare function defaultSqlDialect(): SqlDialect;

package/dist/core/opSubject.d.ts

@@ -1,7 +1,14 @@
 import { ModelId } from './types';
 import { OpShape } from '../command/op';
-/** 감사 대상 종류 — 논리 모델의 편집 단위. 레이아웃 축은 대상이 아니다. */
-export type OpSubjectKind = 'entity' | 'attribute' | 'operation' | 'index' | 'association' | 'associationEnd' | 'group';
+/**
+ * 감사 대상 종류 — 논리 모델의 편집 단위 + **노트**.
+ *
+ * ★노트만 예외적으로 `layout` 에 사는데 감사 대상이다(2026-09-10 결정) — 노트는 *설계 의도*를 담는
+ * 편집 산출물이고, 그것이 언제 사라졌는지 못 보면 이미 동작하는 시점 복원에서 **어느 seq 로 돌릴지
+ * 고를 근거가 없다**. 편입 축은 존재·메모·연결 셋뿐이고 기하·스타일은 여전히 범위 밖이다(캔버스에서
+ * 가장 자주 바뀌어 이력을 덮는다).
+ */
+export type OpSubjectKind = 'entity' | 'attribute' | 'operation' | 'index' | 'association' | 'associationEnd' | 'group' | 'note';
 /** 무엇이 바뀐 대상인가. `entityRef`는 자식(속성/연산/인덱스)의 부모(이름 조회·복원 스코프). */
 export interface OpSubject {
     kind: OpSubjectKind;
@@ -44,7 +51,7 @@ export declare const OP_AUDIT_INVENTORY: Record<string, OpAuditHandling>;
 export declare function describeOpSubjects(op: OpShape): OpSubjectTouch[];
 /** 발굴용 top-level 소속 대상. */
 export interface OpContainer {
-    kind: 'entity' | 'association' | 'group';
+    kind: 'entity' | 'association' | 'group' | 'note';
     ref: ModelId;
 }
 /**

package/dist/core/projectFieldAudit.d.ts

@@ -34,6 +34,7 @@ export interface FieldAuditTarget {
     indexRef?: ModelId;
     associationRef?: ModelId;
     groupRef?: ModelId;
+    noteRef?: ModelId;
     end?: 'end1' | 'end2';
     /** 단일 필드로 좁힘(생략 시 전 필드). */
     field?: string;