@g1cloud/entity-modeler-next 5.2.53 → 5.2.55

package/dist/adapter/persisted.d.ts

@@ -38,7 +38,7 @@ export interface PDbAttr {
     multiValue?: boolean;
     /** 레거시 AttributeDatabaseAttribute.multiValueSeparator(기본 "|"). 라운드트립 보존 전용. */
     multiValueSeparator?: string;
-    /** 레거시 AttributeDatabaseAttribute.sequenceName. 라운드트립 보존 전용. */
+    /** 레거시 AttributeDatabaseAttribute.sequenceName → 논리 `DbColumn.sequenceName`(오버라이드·애플리케이션 채번 두 용법 · 그쪽 주석). */
     sequenceName?: string;
     /** FK 컬럼이 참조하는 부모 PK 컬럼 modelId. 식별자 전파(derivedFrom) 재구성의 명시 링크. */
     targetModelId?: string;

package/dist/agent/symbolicOp.d.ts

@@ -102,6 +102,11 @@ export interface AttrSpec {
     length?: number;
     /** dbAttr 소수 자릿수(DECIMAL/NUMERIC scale). length 동반이 일반적. 0/미설정은 미지정. */
     scale?: number;
+    /**
+     * dbAttr 채번 시퀀스명(`DbColumn.sequenceName`). autoIncrement 없는 비PK 컬럼이면 «애플리케이션 채번»이고 여러
+     * 속성이 같은 이름을 공유해도 정상(공유 채번기). 컬럼 생성 트리거 필드(dataType 동반 필수).
+     */
+    sequenceName?: string;
     /**
      * 코드성 속성의 group code 바인딩(레거시 AttributeModel.groupCode). `type:'GroupCodeEnum'`이면 필수.
      * 모델→모델 복사·코드 동기화에서 GroupCodeEnum 속성을 온전히 재현하는 핵심 필드(없으면 깨진 파생 타입).

package/dist/core/sequenceName.d.ts

@@ -0,0 +1,26 @@
+import { DbColumn } from './types';
+export type SequenceClaim = 
+/** 관례형 파생 — 사람이 고르지 않은 이름. 충돌 판정의 **지목 대상**(고치는 비용이 1편집 = 이름 명시). */
+{
+    kind: 'derived';
+    name: string;
+}
+/** 명시 — `sequenceName`. `autoIncrement` 는 ①오버라이드 / ②애플리케이션 채번을 가른다. */
+ | {
+    kind: 'explicit';
+    name: string;
+    autoIncrement: boolean;
+};
+/** 관례형 시퀀스명 = `<table>_<column>_seq`(PG serial 관례). 절단하지 않는다(헤더 ①~④). */
+export declare function defaultSequenceName(table: string, column: string): string;
+/** 컬럼 `DEFAULT nextval` 이 성립하는가 — `autoIncrement` × 수치형. 비수치형 자동증가는 타입이 맞지 않는다. */
+export declare function isDbDefaultSequence(col: Pick<DbColumn, 'autoIncrement' | 'dataType'>): boolean;
+/**
+ * 이 컬럼이 차지하는 시퀀스명과 그 출처. 아무 시퀀스도 쓰지 않으면 `null`.
+ *
+ * - `sequenceName` 이 비공백이면 **explicit** — 타입·`autoIncrement` 와 무관하게 그 이름을 차지한다
+ *   (애플리케이션 채번은 문자열 컬럼이 지배 형상이므로 수치형 게이트를 두면 그 용법이 통째로 사라진다).
+ * - 아니면 `autoIncrement` × 수치형일 때만 **derived**. 비수치형 자동증가는 `DEFAULT nextval` 을 낼 수 없어
+ *   시퀀스를 차지하지 않는다(DDL 이 주석으로 신호하는 자리).
+ */
+export declare function sequenceClaim(col: Pick<DbColumn, 'autoIncrement' | 'sequenceName' | 'dataType'>, table: string, column: string): SequenceClaim | null;

package/dist/core/types.d.ts

@@ -226,7 +226,14 @@ export interface DbColumn {
     multiValue?: boolean;
     /** 다중값 직렬화 구분자(레거시 기본 "|"). multiValue=false여도 원형 보존 위해 verbatim 유지. */
     multiValueSeparator?: string;
-    /** 시퀀스명(레거시 AttributeDatabaseAttribute.sequenceName). 라운드트립 보존 전용. */
+    /**
+     * 이 컬럼이 번호를 받는 시퀀스의 이름(레거시 AttributeDatabaseAttribute.sequenceName). 두 용법을 한 필드가 담는다:
+     *  ① `autoIncrement` 동반 — 관례형 `<table>_<column>_seq` 를 **오버라이드**(DDL `CREATE SEQUENCE` + `DEFAULT nextval`).
+     *  ② `autoIncrement` 없음 — **애플리케이션 채번**. DB 는 시퀀스만 제공하고 값은 채번기가 접두어를 입혀 만든다
+     *     (문자열 컬럼이 지배 형상). 여러 컬럼이 **같은 이름을 공유**하는 것이 정상(공유 채번기).
+     * 산식·충돌 판정(CHK-NAME-12)·소비처 형상은 `sequenceName.ts` 헤더가 소유한다. ⚠️종전 주석 「라운드트립 보존
+     * 전용」은 2026-09 DDL 배선 이후 거짓이었다(2026-09-16 정정).
+     */
     sequenceName?: string;
 }
 export interface Attribute {