@g1cloud/bpmn-modeler-next 5.0.0-alpha.36 → 5.0.0-alpha.38

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

@@ -6,7 +6,10 @@ import { default as ElementRegistry } from 'diagram-js/lib/core/ElementRegistry'
 import { default as Canvas } from 'diagram-js/lib/core/Canvas';
 import { default as AutoPlace } from 'diagram-js/lib/features/auto-place/AutoPlace';
 import { default as BpmnReplace } from 'bpmn-js/lib/features/replace/BpmnReplace';
+import { Shape } from 'bpmn-js/lib/model/Types';
 import { SymbolicOp } from '../symbolicOp';
+import { BwlSide } from '../../core/hints';
+import { GeometryFinding } from '../geometryAudit';
 /** resolver 가 대면하는 bpmn-js 서비스 표면 — 하강은 이 묶음만 사용한다. */
 export interface ResolverServices {
     modeling: Modeling;
@@ -18,5 +21,45 @@ export interface ResolverServices {
     bpmnReplace: BpmnReplace;
 }
 export declare function resolverServicesOf(modeler: BpmnModelerLike): ResolverServices;
+/**
+ * ── B-40. 주석 자리 산출 — **add·update·기존 주석 보정 공유** ──
+ *
+ * 선언 방위 → 실제 좌표(풀 안 클램프 B-20 ⓑ · 앵커 회피 · 형제·간선 B-21 · 외부 라벨 B-24 ⓑ 회피 ·
+ * 대안 방위 좌 우선 B-26 ⓐ). 힌트가 없으면 휴리스틱 자리를 같은 규칙으로 클램프·비낀다.
+ *
+ * 종전에는 이 전부가 `annotation.add` 루프 안에 인라인이었고 `annotation.update` 는 **원시 계산**만 했다.
+ * 표본 34 실측: 에이전트가 `annotation-over-label` 을 playbook §6 대로 `annotation.update` 로 고치려 하자
+ * 주석이 풀 위로 65px 나갔고(`shape-outside-container` 신규), **배치 1 과 완전히 같은 placement 를 다시
+ * 보내도 되돌아가지 않았다**(add 810 = 클램프 / update 775 = 원시값). 같은 입력이 경로에 따라 다른 좌표를
+ * 내는 것 자체가 결함이고, 규약대로 행동한 에이전트가 문서를 나쁘게 만들었다.
+ * B-33 → B-34 ⓐ 가 그룹 경계 보정에서 닫은 것과 같은 클래스다.
+ *
+ * `selfId` = 이미 존재하는 주석(update)의 자기 도형·자기 연관을 장애물에서 뺀다 — 안 빼면 늘 "막힘"이다.
+ */
+export declare function annotationSpot(elementRegistry: ElementRegistry, anchor: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, dims: {
+    width: number;
+    height: number;
+}, box: Shape, opts: {
+    placement?: {
+        side: BwlSide;
+        offset?: number | null;
+    } | null;
+    from?: {
+        x: number;
+        y: number;
+    };
+    selfId?: string;
+}): {
+    x: number;
+    y: number;
+};
 /** 검증 통과가 전제 — 참조 해소 실패는 여기서 프로그래밍 오류로 throw 되고 applyBpmnOps 가 롤백한다. */
 export declare function lowerOps(ops: readonly SymbolicOp[], services: ResolverServices): void;
+/** 주석 도형이 소유자로 등장할 수 있는 finding 의 소유 도형 id. */
+export declare function annotationOwnersOf(finding: GeometryFinding): readonly string[];
+export declare function repairIntroducedAnnotationOverlaps(services: Pick<ResolverServices, 'elementRegistry' | 'modeling'>, beforeKeys: ReadonlySet<string>, beforeShapeIds: ReadonlySet<string>): void;