@g1cloud/entity-modeler-next 5.2.42 → 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;