@g1cloud/bpmn-modeler-next 5.0.0-alpha.92 → 5.0.0-alpha.94

package/dist/agent/geometryAudit.d.ts

@@ -175,6 +175,30 @@ export type GeometryFinding =
     edge: string;
     line: string;
 }
+/**
+ * 🔴 **간선 라벨이 흐름 노드 도형 위에 앉았다**(B-119 · 표본 85) — 글자가 도형 테두리·내용과 포개진다.
+ * 재배선한 갈래의 「可」 라벨이 새 노드에 8px 겹쳤는데 **판정 kind 가 없어 배치 findings 0** 이었고 사람이
+ * base 자리로 되돌렸다(*"분기관련 코멘트가 요소와 겹친걸 수정했어"*). `label-over-line` 은 선·경계만 본다.
+ *
+ * 🔴 **관측 전용이다**(모듈 머리 주석) — 사람 판정이 **갈렸다**: 같은 형상(재배선 라벨 × 새 노드 10px)을
+ * 표본 84 에서는 사람이 **그대로 뒀다**. 게이트에 넣으면 모든 보정 단계의 채택 조건이 바뀐다(되돌리기를
+ * 적용한 뒤에도 합성 재고 4,960 중 **327 회차(6.6%)** 의 배치 응답에 새로 실린다 — 넣기 전에 게이트마다 반사실이 선결).
+ *
+ * ⚠ **실형상으로 잰다** — 게이트웨이 bbox 모서리는 비어 있어 bbox 로 재면 게이트웨이 옆에 붙인 사람
+ * 라벨(깊이 1~2)을 줍는다(사람 실무 23종: bbox 13 ↔ 실형상 9). 이벤트 = 원 · 게이트웨이 = 마름모 ·
+ * 그 밖 = 사각. ⚠ **사람도 겹쳐 둔다** — 실무 sequenceFlow 라벨 176 중 깊이 ≥3 이 **6**(3문서 · 최대 27)
+ * 이라 문서 전체 표면에서는 그것이 잡힌다(배치 표면은 전후 diff 로 뺀다).
+ *
+ * ⚠ **sequenceFlow 라벨만 본다** — 메시지 라벨은 사람 기저가 없고(실무 0/5) 도구 계보 저장본에서는 사람이
+ * **21/813 을 남겨 두었다**(깊이 ≥3 · 16문서 — sequenceFlow 는 3/951) — 넣으면 판정할 근거 없이 패널만 는다. 흐름 노드만 본다
+ * (주석·데이터는 흐름 노드가 아니다). `depth` = 침투 깊이 px(사각은 겹친 폭·높이 중 작은 쪽).
+ */
+ | {
+    kind: 'label-over-shape';
+    edge: string;
+    shape: string;
+    depth: number;
+}
 /**
  * 텍스트 주석 상자가 다른 요소의 **외부 라벨**(게이트웨이·이벤트 이름, 간선 라벨) 위에 놓였다 — 두 텍스트가
  * 겹쳐 어느 쪽도 읽을 수 없다(열여덟 번째 표본: `top` 주석이 `처리 결과?` 게이트웨이의 이름 라벨을 덮었고
@@ -636,6 +660,23 @@ export declare function labelRectsOf(scene: GeometryScene): Array<{
     owner: string;
     rect: GeometryLabel;
 }>;
+/**
+ * 간선 라벨이 도형 위에 「앉았다」고 볼 최소 침투 깊이(px, 이상) — B-119. 사람 실무 23종의 실형상 깊이가
+ * **1·1·2** 와 **4·14·14·14·27·27** 로 갈렸다 — 앞 무리는 게이트웨이 옆에 붙인 라벨이 마름모 끝을 스친 것이다.
+ * 표본 85(8px · 사람이 고쳤다)·84(10px · 사람이 뒀다)는 둘 다 뒤 무리다.
+ */
+export declare const LABEL_SHAPE_MIN_DEPTH = 3;
+/**
+ * 라벨 상자가 도형 **실형상**에 들어간 깊이(px) — 0 = 안 닿는다(B-119). 이벤트 = 원 · 게이트웨이 = 마름모 ·
+ * 그 밖 = 사각(겹친 폭·높이 중 작은 쪽). 원·마름모는 라벨 상자에서 중심에 가장 가까운 점이 경계 안쪽으로
+ * 들어간 거리로 근사한다(N20 스크립트 `n20-label-shape.py` 와 같은 기하 — 임계가 그 측정에서 나왔다).
+ */
+export declare function labelShapeDepth(label: GeometryLabel, shape: GeometryShape): number;
+/** 라벨 상자가 앉은 흐름 노드(깊이 ≥ {@link LABEL_SHAPE_MIN_DEPTH})와 그 깊이 — id 순. 판정과 B-119 되돌리기가 같은 술어를 쓴다. */
+export declare function shapesUnderLabel(label: GeometryLabel, scene: GeometryScene): Array<{
+    shape: string;
+    depth: number;
+}>;
 /**
  * 기하 판정 (순수). 결과는 **결정론적 순서**로 정렬해 반환한다 — 전후 diff·골든 비교·회귀
  * 고정이 전부 순서에 의존한다.
@@ -645,7 +686,7 @@ export declare function labelRectsOf(scene: GeometryScene): Array<{
  */
 export interface AuditGeometryOptions {
     /**
-     * **관측 전용 kind** 까지 낸다(현재 = `edge-along-group-boundary`) — 판정 표면(배치 응답 · 문서 전체 ·
+     * **관측 전용 kind** 까지 낸다(현재 = `edge-along-group-boundary` · `label-over-shape`) — 판정 표면(배치 응답 · 문서 전체 ·
      * GUI 패널)만 켠다. resolver 채택 게이트는 켜지 않는다(모듈 머리 주석 — 켜면 게이트 제약이 된다).
      */
     includeObservationOnly?: boolean;

package/dist/agent/resolver/lower.d.ts

@@ -87,6 +87,34 @@ export declare function repairIntroducedAnnotationOverlaps(services: Pick<Resolv
  * 틈 **60px** · 겹침 308·180 ⇒ dx **368**(사람은 +340 으로 틈 32 를 수용했다 — 같은 방향 28px 차).
  */
 export declare function repairIntroducedPoolOverlaps(services: Pick<ResolverServices, 'elementRegistry' | 'modeling'>, beforeKeys: ReadonlySet<string>, sceneBefore: GeometryScene): void;
+/**
+ * 🔴 **B-120 — 문서 전체가 한 우변에 맞춰져 있던 풀들을 배치 뒤에도 한 우변으로 되돌린다.**
+ *
+ * 증언(표본 86) = *"레인 끝부분이 걸린건 위쪽의 세개의 레인이 정렬되있어서야"*. 배치는 두 풀만 늘렸고 **늘리는 경로가 둘인데
+ * 기준이 다르다**(`shiftGroups` = 내용 우단 +150 · `createSpace` = 밀기 폭) — 한 우변이 셋으로 갈렸다.
+ * 🔴 **판별자는 「양」이 아니라 「대상」이다** — 우변이 같은 풀이 몇 개인가가 아니라 **문서 전체가 한 우변이었나**. N20 전이 =
+ * 전체 정렬 무리는 사람이 **3/3 반응** · 부분 무리는 **0/5**. 부분 일치는 도구 문서에서도 우연히 생긴다(저장본 부분 무리 19/69 ↔
+ * 전체 정렬 0/69). ⇒ 발동은 **배치 전 모든 풀(≥2)의 우변이 같을 때만**이다.
+ *
+ * **목표 우변 = max(base 우변, 각 풀의 산출 내용 우단 + 150)** — 사람 값이 있는 회차(표본 85 = 2338)를 **정확히** 낸 규칙은
+ * 이것 하나였다(무리 최댓값 · 풀별 base 여백 보존은 둘 다 2473). base 우변 아래로는 **안 줄인다**.
+ * 🔴 **줄이는 쪽도 확정 7 ③ 안이다**(2026-09-28 사용자 결정) — 줄이는 것은 이 배치가 스스로 늘린 폭뿐이라 배치 전과 대면
+ * 결과는 여전히 「넓어졌거나 같다」(🔁 B-118 짝 폐포가 「관계 보존」 이동을 공간 확보로 받은 선례).
+ *
+ * 대상 = **배치 전에 있던 풀만**(배치가 만든 풀은 무리 밖 — 사용자 결정). 연결은 **다시 그리지 않는다**(`layout: false`) — 풀
+ * 경계에 도킹한 사람 메시지의 경로를 폭 조정이 바꾸면 안 된다. 그 대신 끝점이 새 경계 밖에 남는 형상은 아래 가드가 막는다
+ * (🔴 `edge-endpoint-detached` 는 컨테이너 끝점을 안 잰다 — 판정 게이트로는 못 막는다).
+ *
+ * ⚠ **가드 셋 — 하나라도 걸리면 아무것도 안 바꾼다**(종전 그대로): ① 새 우변 밖에 남는 내용(도형 · 라벨 · 풀 안 간선의
+ * 웨이포인트와 라벨) ② 풀에 도킹한 연결 끝점이 새 우변 밖이거나 옛 우변 **위**(우변 도킹은 어느 쪽으로 옮겨도 떨어진다)
+ * ③ 늘린 띠가 남의 도형·라벨을 덮는다(루트 직속 주석 — 판정이 「남의 안」으로 안 잡는다). 채택 = 게이트용 판정의
+ * **새 키 0개**(🔁 B-92 ⓐ — 총량이 아니라 키 집합).
+ *
+ * 🔴 **`repairIntroducedPoolOverlaps` 뒤 · `repairIntroducedGroupGrowth` 앞이다** — 앞 패스는 배치 전 틈을 되살리며 풀을
+ * 옮기고, 뒤 패스는 풀을 품은 그룹 상자의 여백을 **최종 풀 기하**에 대고 재야 한다(🔁 「앞 단계의 판단이 뒤 단계가 바꾼
+ * 전제 위에 남는다」 — B-51·B-58·B-71·B-88). 라우팅·라벨 보정보다도 앞이라 그쪽은 새 경계를 본다.
+ */
+export declare function restorePoolRightAlignment(services: Pick<ResolverServices, 'elementRegistry' | 'modeling'>, sceneBefore: GeometryScene): void;
 /**
  * **B-83 ⓐ** — 기존 그룹 상자가 **크기 변화**를 따라가지 못하는 것을 고친다.
  *

package/dist/agent/resolver/routeRepair.d.ts

@@ -201,6 +201,19 @@ export declare const LABEL_LINE_GAP = 8;
  * (판정기가 보고한다). 바꿀 것이 없으면 `null`.
  */
 export declare function planLabelLineClearance(edge: GeometryEdge, scene: GeometryScene): GeometryLabel | null;
+/** B-99·B-119 라벨 추종의 배치 시작 기준선 — 절대 좌표와 끝점 id(재배선 판별). */
+export interface EdgeLabelSnapshot {
+    wps: ReadonlyArray<{
+        x: number;
+        y: number;
+    }>;
+    label: {
+        x: number;
+        y: number;
+    };
+    source: string | undefined;
+    target: string | undefined;
+}
 /**
  * ── B-99. **배치가 옮긴 선을 선재 라벨이 따라간다** ──
  *
@@ -234,17 +247,22 @@ export declare function planLabelLineClearance(edge: GeometryEdge, scene: Geomet
  * 판정 기준으로 쓴다(누적).
  *
  * 라벨 하나씩 재고 새 키가 생기면 **그 라벨만** 두고 간다(부분 해소 허용 — 🔁 B-61).
+ *
+ * ── B-119. **재배선된 간선의 선재 라벨이 도형 위에 앉으면 base 자리로 되돌린다** ──
+ *
+ * 🔴 **근인은 bpmn-js 라벨 동작의 두 단계 합성이다**(N22 단계 로그 · 표본 85). ① 삽입 밀기(`createSpace`)가 옛
+ * 끝점을 밀어 선이 27 → 180px 로 **늘면** `LabelBehavior` 가 라벨을 **비례 위치**(51.85%)로 옮긴다(+79)
+ * ② 재배선(`modeling.reconnect`)의 중간 경로는 **두 중심점**(830 → 945)인데 라벨이 그 끝 바깥이라 「끝점에 붙은
+ * 라벨」로 읽혀 layout 뒤 새 끝점으로 끌려간다(−50) ⇒ 새 노드 위 8px. 재배선된 간선은 평행이동이 아니라
+ * 위 추종의 대상이 아니었고, 보정 단계들은 선재 라벨을 제외한다(안전 성질 2) — 그래서 아무도 안 봤다.
+ *
+ * **되돌리는 자리는 base 절대 좌표다** — 사람이 한 것이 정확히 그것이다(1px 차). 🔴 **겹칠 때만** 되돌린다
+ * (사용자 결정 2026-09-28): 겹침 없이 표류만 한 라벨(합성 재고 80건 · 중앙 21px)은 결함 신호가 없어 두고 간다.
+ * ⚠ **base 자리가 막혔으면 손대지 않는다** — 새 노드가 그 자리에 선 형상(합성 238건 · 표본 84 는 사람이 뒀다)은
+ * 이 수단의 몫이 아니다(착지 축 = B-119 잔존). ⚠ **base 자리가 새 선에서 멀면 손대지 않는다** — 옛 경로 위의
+ * 자리라 새 선의 라벨로 안 읽힌다(임계 = B-99 N20 sequenceFlow 중심거리 p95). 채택 조건은 위와 같은 키 집합.
  */
-export declare function followMovedEdgeLabels(services: Pick<ResolverServices, 'elementRegistry' | 'modeling'>, before: ReadonlyMap<string, {
-    wps: ReadonlyArray<{
-        x: number;
-        y: number;
-    }>;
-    label: {
-        x: number;
-        y: number;
-    };
-}>): void;
+export declare function followMovedEdgeLabels(services: Pick<ResolverServices, 'elementRegistry' | 'modeling'>, before: ReadonlyMap<string, EdgeLabelSnapshot>): void;
 /** 이 배치가 **새로 만든** 간선의 라벨을 선·경계선에서 뗀다(맨 마지막 — 라벨 귀속 보정 뒤). 선재 라벨은 불가침. */
 export declare function repairIntroducedLabelLines(services: Pick<ResolverServices, 'elementRegistry' | 'modeling'>, beforeEdgeIds: ReadonlySet<string>): void;
 /**