@g1cloud/entity-modeler-next 5.0.0-alpha.21 → 5.0.0-alpha.22

package/dist/core/scaffoldJava.d.ts

@@ -0,0 +1,42 @@
+import { LogicalModel, ModelId, SuperClassCatalog, EmbeddableCatalog } from './types';
+import { JavaTypeDef } from './javaTypes';
+export interface ScaffoldOptions {
+    /** 저장값→소스 타입 역해소 카탈로그. 미주입 시 lib 내장 `JAVA_TYPES` 폴백(호스트 javaTypeCatalog 미러). */
+    javaTypeCatalog?: readonly JavaTypeDef[];
+    /** 임베더블 타입 해소용(EMBED_PREDEF 필드 타입·클래스명). 미주입 시 모델 type 폴백 + fillIn. */
+    embeddableCatalog?: EmbeddableCatalog;
+    /**
+     * `extends <superClass>` + 상속 컬럼 인덱스 해소용. 핸드오프 O3 — `SuperClassDef.packageName`이
+     * "코드젠 forward 슬롯"으로 예약돼 있고 이 emitter가 그 첫 소비처다. 미주입 시 상속 컬럼/extends 미방출.
+     */
+    superClassCatalog?: SuperClassCatalog;
+    /**
+     * Lombok 방출 모드(기본 `true` — 모델러 사용 프로젝트가 사실상 전부 Lombok). true면 **필드 단위**
+     * `@Getter`(스칼라·단일 임베드·owner 관계, 대형 엔티티 SalesOrch류 관례) + 클래스 `@NoArgsConstructor
+     * (access = AccessLevel.PROTECTED)`를 방출하고 수동 getter·protected 생성자를 생략한다. **컬렉션 관계**
+     * getter는 @Getter가 raw 컬렉션을 반환해 애그리거트 보호가 깨지므로 예외 — 수동 `Collections.unmodifiable…`
+     * 유지(@Getter 미부착). **@Version**은 JPA 관리 내부 필드라 getter 제외(실측 37/38 무 getter).
+     * `{Entity}PK`는 필드 @Getter만, equals/hashCode·생성자는 수동. `false` = 수동 전량(생성기/코퍼스 패리티,
+     * 바이트 골든 앵커 모드 — @Version getter 포함).
+     */
+    lombok?: boolean;
+}
+export interface ScaffoldedEntity {
+    modelId: ModelId;
+    /** `{ClassName}.java` */
+    fileName: string;
+    /** 컴파일 가능 최소 골격 자바 소스(`// TODO [손채움]` 포함). */
+    source: string;
+    /** 사람이 채울 지점 목록(라벨) — reconcile 보고용. */
+    fillIns: string[];
+    /** 신규 엔티티 경로에서만 write(기존엔 재추가 금지, §4.4) — reconcile 판단. */
+    repository?: {
+        fileName: string;
+        source: string;
+    };
+}
+/**
+ * 대상 엔티티들을 JPA 자바 소스로 렌더한다. `logical`은 참조 폐포(FK 대상 등) 해소를 위해 전체를 받고,
+ * `targetIds`가 실제 산출(파일 생성) 스코프다. 스코프 밖 엔티티는 읽기(폐포)에만 쓰이고 산출되지 않는다.
+ */
+export declare function scaffoldEntityJava(logical: LogicalModel, targetIds: readonly ModelId[], opts?: ScaffoldOptions): ScaffoldedEntity[];