@g1cloud/bpmn-modeler-next 5.0.0-alpha.9 → 5.0.0-alpha.91

package/dist/agent/describeProcess.d.ts

@@ -1,5 +1,5 @@
 import { ModdleElement, ParseWarning } from '../adapter/xml';
-import { BwlBand, BwlPlacement, BwlPoolOrder } from '../core/hints';
+import { BwlAfterColumn, BwlBand, BwlPlacement, BwlPoolOrder } from '../core/hints';
 import { IrDefinition } from '../core/ir';
 /** 파생 뷰가 표현하지 못한 요소 — 침묵 폐기 금지(에이전트가 미표현 존재를 알아야 안전). */
 export interface IrOmission {
@@ -7,8 +7,14 @@ export interface IrOmission {
     /** bpmn $type 원형 (예: `bpmn:BoundaryEvent`) */
     type: string;
     reason: 
-    /** MVP 타입 집합 밖 (boundaryEvent·subProcess·dataObject 등 — 승격 시 자동 해소) */
+    /** IR 타입 집합 밖 (intermediate 이벤트·dataObject 등 — 승격 시 자동 해소) */
     'type-outside-mvp'
+    /**
+     * 승격된 컨테이너(subProcess) **내부**라 표현하지 않음 (B-87 ⓐ = 불투명 승격).
+     * 컨테이너 자신은 노드로 보이지만 내부는 열지 않았다 — 침묵하면 에이전트가 빈 컨테이너로
+     * 오인해 파괴적 편집을 한다. 내부를 IR 에 내려면 부모 채널·컨테이너 내부 좌표계가 필요하다.
+     */
+     | 'inside-container'
     /** 끝점이 미표현 요소라 연결 자체를 표현할 수 없음 */
      | 'endpoint-outside-mvp'
     /** 협업 문서인데 어느 participant 도 참조하지 않는 프로세스 (풀 귀속 불명) */
@@ -21,8 +27,13 @@ export interface IrOmission {
 export interface BwlHintView {
     /** participant id → 풀 세로 순서 */
     poolOrders: Record<string, BwlPoolOrder>;
-    /** 플로우 노드 id → 프로세스 내부 가로 밴드 */
+    /** 플로우 노드 id → 프로세스 내부 가로 밴드(행) */
     bands: Record<string, BwlBand>;
+    /**
+     * 플로우 노드 id → 열 지목 힌트(그 노드보다 뒤 열). `bands` 와 대칭 채널이다.
+     * ⚠ **존재 필터**(A-6) — 참조 대상이 문서에 없으면 내지 않는다(힌트 = 파생 정보 · 불변식 2).
+     */
+    afterColumns: Record<string, BwlAfterColumn>;
     /** 주석 id → 앵커 기준 방위 (앵커 부재분은 필터됨) */
     placements: Record<string, BwlPlacement>;
 }

package/dist/agent/elementDiff.d.ts

@@ -0,0 +1,53 @@
+import { ModdleElement, ParseWarning } from '../adapter/xml';
+type El = ModdleElement;
+/**
+ * 이 쓰기가 만진 요소 id 집합 — 호스트 `BpmnChangedElements` 와 같은 형태.
+ *
+ * `modified` 는 **의미론 변화와 기하 변화의 합집합**이다. 둘을 가르지 않는 이유 = 소비처 둘이
+ * 모두 합집합을 쓴다(충돌 판정 = 「만졌는가」 · 패널 범위 = 「이번 것인가」). 가를 필요가 생기면
+ * 그때 `modifiedGeometry` 를 additive 로 더한다 — 지금 나누면 어느 소비처도 안 쓰는 축이 계약에 남는다.
+ */
+export interface BpmnChangedElements {
+    added: string[];
+    removed: string[];
+    modified: string[];
+}
+export interface DiffBpmnElementsOptions {
+    /**
+     * 「움직였다」로 볼 최소 좌표 변화(px). 기본 **0.5** = 직렬화 잡음만 거른다.
+     *
+     * ⚠ **의도적으로 작다** — 이 판정기의 1차 소비처가 충돌 판정이라 *사람이 일부러 옮긴 것*을
+     * 놓치는 쪽이 비싸다. 범위 축(B-109)의 N20 은 5px 로 쟀는데 두 값 사이에서 결과가 갈리지
+     * 않았다(그 회차들의 이동은 전부 수십~수백 px).
+     */
+    moveTolerance?: number;
+    /**
+     * 라벨 **위치**의 허용 오차(px). 기본 **8**.
+     *
+     * 🔴 **라벨 박스는 사람 손과 폰트 근사가 함께 움직인다** — 실측(2026-09-26 · 82쌍 · 본체가 안
+     * 움직인 라벨 **280**): 라벨만 달라진 것이 **2건**이고 위치 Δ 3·5px · 크기 Δ 6·9px 였다. 우리
+     * 헤드리스 하강이 폰트 폭을 **근사**하므로(`headless/dom`) 재직렬화만으로 그만큼 표류한다.
+     * ⇒ 표류폭 위에 임계를 둔다. ⚠ **크기는 아예 안 본다** — bpmn-js 에 라벨 리사이즈가 없어
+     * 사람이 만들 수 없는 변화이고, 텍스트·폰트가 정하는 파생값이다.
+     */
+    labelTolerance?: number;
+}
+/**
+ * 두 문서가 만진 요소를 가른다. **순수 함수** — 좌표·의미 어느 쪽 변화든 `modified` 에 든다.
+ *
+ * ⚠ **id 가 진실이다** — bpmn-js 가 요소를 재생성하는 조작(morph)은 id 를 바꾸므로 `removed` +
+ * `added` 한 쌍으로 잡힌다. 그것이 정직한 판정이다(같은 요소라고 우기면 충돌 판정이 거짓 음성이 된다).
+ */
+export declare function diffBpmnElements(oldDefinitions: El, newDefinitions: El, options?: DiffBpmnElementsOptions): BpmnChangedElements;
+export interface DiffBpmnElementsXmlResult extends BpmnChangedElements {
+    warnings: ParseWarning[];
+}
+/** XML 진입점 — 호스트(서버)가 두 버전 본문을 그대로 넘기는 경로. C-3 이 적은 그 시그니처다. */
+export declare function diffBpmnElementsXml(oldXml: string, newXml: string, options?: DiffBpmnElementsOptions): Promise<DiffBpmnElementsXmlResult>;
+/**
+ * 「이번에 만들거나 만진 것」 — 패널 범위 축(B-109 ⓑ)이 쓰는 형태.
+ *
+ * ⚠ `removed` 는 넣지 않는다 — 사라진 요소는 패널이 가리킬 대상이 없다(판정도 안 난다).
+ */
+export declare function touchedElements(changed: BpmnChangedElements): Set<string>;
+export {};