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

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/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;
 /**