@g1cloud/bpmn-modeler-next 5.0.0-alpha.80 → 5.0.0-alpha.81

package/dist/agent/semanticAudit.d.ts

@@ -0,0 +1,36 @@
+import { ModdleElement, ParseWarning } from '../adapter/xml';
+/** 시블링 `IssueSeverity` 와 같은 3단계 — 패널이 필터 토글로 쓰고, 정렬 우선순위이기도 하다. */
+export type IssueSeverity = 'error' | 'warning' | 'info';
+/**
+ * 이슈가 가리키는 대상의 종류. 지금 쓰는 둘만 둔다 — union 확장은 additive 라 규칙이 늘 때
+ * 함께 넓히면 된다(미리 넣으면 어느 규칙도 쓰지 않는 값이 계약에 남는다).
+ */
+export type SemanticTargetKind = 'flowNode' | 'participant';
+export interface SemanticIssue {
+    /**
+     * 규칙 식별자 겸 **메시지 코드**. 소비측이 이 값(+`params`)으로 표시 문자열을 해석한다.
+     * 시블링 `CHK-*` 형식을 따르되 카테고리는 BPMN 고유라 충돌하지 않는다(`FLOW` · `POOL`).
+     */
+    ruleId: string;
+    severity: IssueSeverity;
+    targetKind: SemanticTargetKind;
+    /**
+     * 문제 요소 id 목록. 🔴 **시블링의 단수 `targetRef` 와 의도적으로 다르다** — 이 모듈에는
+     * 문서당 1건으로 **집약하는 규칙**이 있다(`CHK-POOL-1`: 실무 문서에서 문서당 5~18건이
+     * 전부 참이라, 개별로 내면 패널이 한 규칙으로 덮인다). 단일 대상 규칙은 길이 1 이다.
+     */
+    targetRefs: string[];
+    /** 표시 보간 데이터 — 번역 대상이 아닌 값(타입 리터럴·건수)만. */
+    params?: Record<string, string | number>;
+}
+/**
+ * 저장 진실 기준 의미론 판정 — 그 문서에 있는 **전부**(선재 포함). `auditBpmnGeometry` 와 같은
+ * 지위이고, 입력도 같은 moddle `definitions` 라 서버에서 돈다(A-6 과 같은 근거 — DOM 불요).
+ */
+export declare function auditBpmnSemantics(definitions: ModdleElement): SemanticIssue[];
+export interface AuditBpmnSemanticsXmlResult {
+    issues: SemanticIssue[];
+    warnings: ParseWarning[];
+}
+/** XML 문자열 입력 래퍼 (`describeProcessXml`·`auditBpmnGeometryXml` 대칭). */
+export declare function auditBpmnSemanticsXml(xml: string): Promise<AuditBpmnSemanticsXmlResult>;