@g1cloud/entity-modeler-next 5.0.9 → 5.0.11

package/dist/core/javaTypes.d.ts

@@ -22,6 +22,29 @@ export declare function javaTypeLabel(value: string): string;
  * 호출자가 타입을 비워 "모른다"를 보존한다. 위 `JAVA_TYPE_BY_DATA_TYPE` 주석의 결정 근거 참조.
  */
 export declare function javaTypeFromDataType(dataType: string | undefined): string | undefined;
+/**
+ * 자바 타입 ↔ 물리 DB 타입 호환 판정. `CHK-TYPE-7`의 판정 산식(단일 출처).
+ *
+ * 반환값 3-상태: `true` 호환 · `false` 부정합 · **`undefined` 판정 불가**(호출자는 skip한다). undefined는
+ * ①어느 한쪽이 빈값 ②자바 타입이 `DATA_TYPES_BY_JAVA_TYPE` 밖(임베더블·주입 customtype·CustomType)
+ * ③물리 타입이 `ALL_DATA_TYPES` 밖(미지 값 — 그 축은 `CHK-TYPE-1`이 타깃 다이얼렉트 기준으로 지목한다.
+ * 여기서 함께 신고하면 한 컬럼에 두 경고가 겹치고 사용자가 할 일이 갈린다).
+ *
+ * ★★**정수형 × `NUMERIC`/`DECIMAL`은 정밀도 무관 호환**이다(2026-08-24 운영 DB 실측으로 확정).
+ * 이 자리에 한때 *"무정밀도면 부정합"* 조건이 있었고 **실측이 그것을 무너뜨렸다** — 근거 이력을 남긴다:
+ *  · 1차 근거는 실물 **Java 필드 타입**이었다(`private int`이므로 컬럼도 정수여야 한다).
+ *  · 그런데 리포의 **Flyway 프로덕션 마이그레이션**(`src/main/resources/db/migration/V*.sql` · 컬럼 9,254)
+ *    을 대조하니 운영 DB 가 실제로 `NUMERIC`이었다 — 정밀도있음 395 중 **293이 DDL 에 있고 280이 정밀도
+ *    값까지 일치**(291 numeric : 2 integral), 무정밀도 축도 **85건이 DDL 에서 무정밀도 `NUMERIC`** 이다
+ *    (`series.depth NUMERIC NOT NULL` · `sort_order NUMERIC DEFAULT 999`). `ALTER COLUMN … TYPE` 전량에
+ *    **numeric → integer 전환이 0건**이라 이 판정은 stale 하지 않다.
+ *  · ⇒ `int` 필드 × `numeric` 컬럼은 **이 프로젝트의 운영 형상**이다. `Boolean × VARCHAR`(Y/N 컨버터
+ *    766건)와 **같은 구조**이고, 도구가 결함이라 부르면 오탐이 된다.
+ * ★판정 근거는 *Java 타입이 무엇을 읽는가*가 아니라 **컬럼이 실제로 무엇인가**다 — 이 프로젝트의 스키마는
+ * Hibernate 가 아니라 마이그레이션이 만들고(`dbTypes.ts` 주석), Hibernate 는 정수 필드의 `precision`을
+ * 무시하므로 어노테이션은 *의도*일 뿐이다.
+ */
+export declare function isJavaDataTypeCompatible(javaType: string | undefined, dataType: string | undefined): boolean | undefined;
 /**
  * ① 스칼라 자바 타입 셀렉트 후보(단일 출처). JAVA_TYPES에서 비후보(⑤·레거시 표시용)를 빼고
  * ④ CustomType은 "사용자정의" 안내 라벨로 노출. ②embeddable·③customtype은 애초에 JAVA_TYPES에 없음.

package/dist/core/scaffoldJava.d.ts

@@ -1,5 +1,39 @@
 import { Entity, LogicalModel, ModelId, SuperClassCatalog, EmbeddableCatalog } from './types';
 import { JavaTypeDef } from './javaTypes';
+/**
+ * `AttributeConverter` FQN 기본값 — **레거시 생성기 상수 미러**(`bluework-im` `EntityJavaFile.java:77~78`
+ * Y/N 2종 · Money `@Convert`). 프로젝트 소유 FQN 을 emitter 상수로 두는 것은 이 파일의 확립된 관례다
+ * (위 `FQN` 표의 `net.g1project.*` 8개 · `PREDEF_CUSTOM_TYPE_FQN` 동형 — 카탈로그는 FQN 을 갖지 않는다).
+ *
+ * ★**여기가 단일 출처다** — 종전 Money FQN 은 `resolveJavaType` 안에 박혀 있어서, 컨버터 축이 하나 늘 때마다
+ * 방출 지점이 흩어질 구조였다(Y/N 축이 세 번째 자리가 될 자리). 축이 늘면 이 표에만 추가한다.
+ * 갈아 끼울 필요가 생기면 `ScaffoldOptions.converterCatalog` 로 축별 override 한다.
+ */
+declare const CONVERTER_FQN: {
+    /** Y/N 문자 플래그 — `dataType=VARCHAR` × `PrimitiveBoolean`. */
+    readonly booleanYnPrimitive: "net.g1project.ecp.common.jpa.converter.PrimitiveBooleanToYNStringConverter";
+    /** Y/N 문자 플래그 — `dataType=VARCHAR` × `Boolean`(박싱). */
+    readonly booleanYnBoxed: "net.g1project.ecp.common.jpa.converter.BooleanToYNStringConverter";
+    /** 레거시 ③ 단일 컬럼 Money(`CustomMoneyType`). forward Money ②(2컬럼)는 `@CompositeType` 경로로 별개. */
+    readonly money: "net.g1project.bluecomm.money.MoneyAttributeConverter";
+};
+/** 컨버터 축 — `CONVERTER_FQN` 키. */
+export type ConverterAxis = keyof typeof CONVERTER_FQN;
+/**
+ * 컨버터 FQN override 카탈로그(`ScaffoldOptions.converterCatalog`). 축마다 3-상태다 —
+ * **미주입**=lib 내장 기본값 / **문자열**=그 FQN / **`null`**=명시 비활성(방출 생략 + `fillIn`).
+ *
+ * ★**방출 조건은 주입 대상이 아니다** — 어느 형상에 컨버터를 붙이는지는 레거시 산식으로 고정하고
+ * (예: Y/N 은 `VARCHAR` × boolean) **FQN 만** 프로젝트가 갈아 끼운다. 조건까지 열면 주입 규약이 곧
+ * 두 번째 코드젠이 된다.
+ *
+ * ★**다중값(단일 컬럼 Set) 컨버터 축은 여기 없다** — 그 컨버터는 도메인 타입별로 다르므로 프로젝트 단위
+ * FQN 하나로 대표할 수 없다(기본값을 두면 발명 = 「모르는 값 규약」 위반) ⇒ 현행 `fillIn` 손채움을 유지한다.
+ * 즉 이 표에 들어오는 것은 **종류가 정해진 축**뿐이다.
+ */
+export type ConverterCatalog = {
+    readonly [K in ConverterAxis]?: string | null;
+};
 export interface ScaffoldOptions {
     /**
      * **산출 불가 대상 자동 제외**(기본 `true`) — 엔티티명 미지정 / `@Id` 없는 JPA 엔티티는 파일을 만들지
@@ -16,6 +50,11 @@ export interface ScaffoldOptions {
     javaTypeCatalog?: readonly JavaTypeDef[];
     /** 임베더블 타입 해소용(EMBED_PREDEF 필드 타입·클래스명). 미주입 시 모델 type 폴백 + fillIn. */
     embeddableCatalog?: EmbeddableCatalog;
+    /**
+     * `AttributeConverter` FQN override. 미주입 시 lib 내장 `CONVERTER_FQN` 폴백(레거시 생성기 상수 미러) —
+     * `javaTypeCatalog` 와 같은 관용구다. 축별 3-상태·조건 비주입 근거는 {@link ConverterCatalog}.
+     */
+    converterCatalog?: ConverterCatalog;
     /**
      * `extends <superClass>` + 상속 컬럼 인덱스 해소용. 핸드오프 O3 — `SuperClassDef.packageName`이
      * "코드젠 forward 슬롯"으로 예약돼 있고 이 emitter가 그 첫 소비처다. 미주입 시 상속 컬럼/extends 미방출.
@@ -89,3 +128,4 @@ export interface ScaffoldedEntity {
  */
 export declare function isGeneratable(entity: Entity): boolean;
 export declare function scaffoldEntityJava(logical: LogicalModel, targetIds: readonly ModelId[], opts?: ScaffoldOptions): ScaffoldedEntity[];
+export {};