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

package/dist/agent/geometryAudit.d.ts

@@ -23,12 +23,21 @@ export interface GeometryShape {
      */
     parent?: string;
 }
+/** 간선 외부 라벨의 bounds — 라벨은 판정 대상 도형이 아니지만 **어느 간선의 것으로 읽히는가**는 판정한다(B-15). */
+export interface GeometryLabel {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
 export interface GeometryEdge {
     id: string;
     type: string;
     waypoints: GeometryPoint[];
     /** 이 간선이 자기 끝점으로 삼는 도형 id 들 — 그 도형과의 교차는 도킹이라 관통이 아니다. */
     endpoints: readonly string[];
+    /** 이름이 있는 간선의 외부 라벨 bounds(있을 때만). `label-on-shared-segment` 의 입력. */
+    label?: GeometryLabel;
 }
 /** 판정기가 대면하는 최소 입력 — 좌표만 담는다(의미론 없음). */
 export interface GeometryScene {
@@ -77,9 +86,35 @@ export type GeometryFinding =
     edges: [string, string];
     axis: 'h' | 'v';
     length: number;
+}
+/**
+ * 간선의 **라벨이 다른 간선과 공유하는 구간 위**에 놓여 어느 간선의 라벨인지 읽을 수 없다(확정 6
+ * 다섯 번째 표본에서 사용자가 지목: "겹치는 선상에 있는 분기 문구가 어느 선에 해당하는지 애매").
+ * 전형 = 게이트웨이 팬아웃의 3점 경로(세로 → 가로)는 첫 세로 구간을 갈래끼리 공선 공유하는데,
+ * bpmn-js 기본 라벨 위치(중간 구간 중점 = 3점이면 첫 구간)가 정확히 그 공유 구간이라 '승인'·
+ * '보완 요청' 이 한 선 위에 나란히 선다. 같은 방향 공선 중첩은 선으로서는 문제가 아니지만
+ * (`edge-overlap-opposite` 가 제외한 이유) **라벨 귀속** 축에서는 문제다. `other` = 그 구간을
+ * 함께 쓰는 간선(여럿이면 id 최소).
+ */
+ | {
+    kind: 'label-on-shared-segment';
+    edge: string;
+    other: string;
+    axis: 'h' | 'v';
 };
 /** 발견을 전후 비교(배치가 새로 만든 것 가려내기)할 수 있게 하는 안정 키. */
 export declare function geometryFindingKey(finding: GeometryFinding): string;
+export interface AxisSegment {
+    axis: 'h' | 'v';
+    /** 고정 좌표(h 면 y, v 면 x). */
+    at: number;
+    lo: number;
+    hi: number;
+    /** 진행 방향 부호(+ = 오른쪽/아래). */
+    dir: 1 | -1;
+}
+/** 간선의 축 정렬 구간들(웨이포인트 순서). 사선 구간은 뺀다. */
+export declare function axisSegmentsOf(edge: GeometryEdge): AxisSegment[];
 /**
  * 두 간선의 **반대 방향** 공선 중첩 — 가장 긴 겹침의 (축, 길이). 없으면 `null`.
  * 같은 방향 겹침(합류·팬아웃)은 세지 않는다.
@@ -90,6 +125,26 @@ export declare function oppositeOverlapOf(a: GeometryEdge, b: GeometryEdge): {
 } | null;
 /** 한 간선(후보 경로)이 다른 간선들과 만드는 반대 방향 중첩 수. */
 export declare function oppositeOverlapCount(edge: GeometryEdge, others: readonly GeometryEdge[]): number;
+/** bpmn-js `LabelUtil.FLOW_LABEL_INDENT` — 라벨 중심이 선에서 떨어지는 거리(가로 구간은 위, 세로 구간은 오른쪽). */
+export declare const FLOW_LABEL_INDENT = 15;
+/**
+ * 갈림점 바로 옆에 붙은 라벨도 모호하다(다섯 번째 표본: 갈림 16px 아래의 '보완 요청' 을 사용자가 더
+ * 내렸다) — 공유 구간을 양쪽으로 이만큼 넓혀 본다. 배치(`planLabelPlacement`)도 같은 폭을 뺀다.
+ */
+export declare const LABEL_FORK_MARGIN = 20;
+/**
+ * `seg` 가 다른 간선의 구간과 공선 공유하는 부분들(≥ `OVERLAP_MIN_LENGTH`, 방향 무관) — 갈림 여백을
+ * 더해 돌려준다. 판정과 배치가 **같은 목록**을 써야 "옮겼는데 여전히 잡힌다"가 나지 않는다.
+ */
+export declare function sharedSpansOf(seg: AxisSegment, otherSegments: readonly AxisSegment[]): Array<[number, number]>;
+/**
+ * 이 간선의 라벨이 다른 간선과 **공선 공유하는 구간**(방향 무관, ≥ `OVERLAP_MIN_LENGTH`, 갈림 여백 포함)
+ * 위에 놓여 있으면 그 상대(id 최소)와 축을 돌려준다. 라벨이 없거나 고유 구간에 있으면 `null`.
+ */
+export declare function sharedSegmentUnderLabel(edge: GeometryEdge, others: readonly GeometryEdge[]): {
+    other: string;
+    axis: 'h' | 'v';
+} | null;
 /**
  * 이 간선이 관통하는 도형들(자기 끝점 제외). 판정과 **우회 보정**(routeRepair)이 같은
  * 술어를 써야 "고쳤다는데 판정은 그대로"가 나지 않는다.

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

@@ -8,7 +8,7 @@ export type { DocumentIndex, ElementCategory } from './documentIndex';
 export { buildRegistryIndex } from './documentIndex';
 export { validateOps } from './validate';
 export { lowerOps, resolverServicesOf, type ResolverServices } from './lower';
-export { planCrossPoolRoute, planEdgeRepair, planMiddleSegmentShifts, planOppositeOverlapRepair, planSegmentDetours, repairIntroducedCrossings, repairIntroducedOppositeOverlaps, rerouteIntroducedCrossPoolEdges, } from './routeRepair';
+export { planCrossPoolRoute, planEdgeRepair, planLabelPlacement, planMiddleSegmentShifts, planOppositeOverlapRepair, planSegmentDetours, repairIntroducedCrossings, repairIntroducedOppositeOverlaps, repairIntroducedSharedSegmentLabels, rerouteIntroducedCrossPoolEdges, } from './routeRepair';
 export interface ApplyBpmnOpsResult {
     ok: boolean;
     issues: ResolveIssue[];

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

@@ -1,4 +1,4 @@
-import { GeometryEdge, GeometryPoint, GeometryScene, GeometryShape } from '../geometryAudit';
+import { GeometryEdge, GeometryLabel, GeometryPoint, GeometryScene, GeometryShape } from '../geometryAudit';
 import { ResolverServices } from './lower';
 /**
  * 축 정렬 구간이 장애물을 **완전히 가로지를 때** 그것을 우회하는 4점을 만든다(순수).
@@ -61,3 +61,16 @@ export declare function planOppositeOverlapRepair(edge: GeometryEdge, scene: Geo
  * 손댄다(안전 성질 2) — 둘 다 새 것이면 되돌아가는 간선(A 후보가 있는 쪽)부터.
  */
 export declare function repairIntroducedOppositeOverlaps(services: Pick<ResolverServices, 'elementRegistry' | 'modeling'>, beforeKeys: ReadonlySet<string>, beforeEdgeIds: ReadonlySet<string>): void;
+/**
+ * 라벨의 새 bounds(순수). 라벨이 공유 구간 위에 없으면 `null`(옮길 이유가 없다). 고유 구간을 못
+ * 찾거나 옮긴 자리가 도형과 겹치면 `null`(손대지 않고 보고에 맡긴다).
+ *
+ * 구간마다 다른 간선과 공선 공유하는 부분(≥ 20px)을 빼고 남은 **첫 자유 부분** 중 라벨이 들어가는
+ * 곳을 고른다 — 부분 공유 구간(갈림점 아래로 이어지는 세로 구간)도 그 아래쪽이 자유 부분이다.
+ */
+export declare function planLabelPlacement(edge: GeometryEdge, scene: GeometryScene): GeometryLabel | null;
+/**
+ * 이 배치가 **새로 만든** 간선의 라벨 귀속 문제를 고친다(하강 직후, undo 에피소드 안, 경로 보정들 뒤).
+ * 선재 간선의 라벨은 사람이 놓았을 수 있어 손대지 않는다(안전 성질 2).
+ */
+export declare function repairIntroducedSharedSegmentLabels(services: Pick<ResolverServices, 'elementRegistry' | 'modeling'>, beforeKeys: ReadonlySet<string>, beforeEdgeIds: ReadonlySet<string>): void;