@bpmnkit/core 1.7.0 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/AGENTS.md +19 -0
  2. package/README.md +2 -0
  3. package/agent-cards/bpmn.md +88 -0
  4. package/agent-cards/dmn.md +105 -0
  5. package/agent-cards/form.md +72 -0
  6. package/dist/bpmn/auto-layout.js +2 -1
  7. package/dist/bpmn/bpmn-builder.d.ts +2 -2
  8. package/dist/bpmn/bpmn-builder.js +27 -6
  9. package/dist/bpmn/camunda7/migrate.d.ts +1 -1
  10. package/dist/bpmn/camunda7/migrate.js +1 -1
  11. package/dist/bpmn/compact.js +3 -0
  12. package/dist/bpmn/full-operations.js +2 -0
  13. package/dist/bpmn/index.d.ts +9 -1
  14. package/dist/bpmn/index.js +18 -23
  15. package/dist/bpmn/optimize/deploy.js +14 -0
  16. package/dist/bpmn/optimize/index.d.ts +2 -0
  17. package/dist/bpmn/optimize/index.js +5 -0
  18. package/dist/bpmn/optimize/types.d.ts +7 -0
  19. package/dist/bpmn/stable-ids.d.ts +15 -0
  20. package/dist/bpmn/stable-ids.js +26 -0
  21. package/dist/bpmn/svg.js +5 -6
  22. package/dist/bpmn/xsd-guards.d.ts +8 -0
  23. package/dist/bpmn/xsd-guards.js +56 -0
  24. package/dist/check-finding.d.ts +19 -0
  25. package/dist/check-finding.js +5 -0
  26. package/dist/dmn/compact.js +14 -5
  27. package/dist/dmn/dmn-builder.js +3 -3
  28. package/dist/dmn/drd-builder.d.ts +53 -0
  29. package/dist/dmn/drd-builder.js +100 -0
  30. package/dist/dmn/index.d.ts +35 -0
  31. package/dist/dmn/index.js +36 -0
  32. package/dist/dmn/lint.d.ts +19 -0
  33. package/dist/dmn/lint.js +414 -0
  34. package/dist/form/form-builder.d.ts +9 -1
  35. package/dist/form/form-builder.js +34 -1
  36. package/dist/form/form-model.d.ts +7 -0
  37. package/dist/form/form-parser.js +22 -0
  38. package/dist/form/form-serializer.js +10 -0
  39. package/dist/form/index.d.ts +11 -2
  40. package/dist/form/index.js +10 -1
  41. package/dist/form/lint.d.ts +19 -0
  42. package/dist/form/lint.js +356 -0
  43. package/dist/index.d.ts +14 -3
  44. package/dist/index.js +10 -2
  45. package/dist/layout/grid/edge-labels.d.ts +7 -1
  46. package/dist/layout/grid/edge-labels.js +62 -1
  47. package/dist/layout/semantic/index.js +78 -8
  48. package/dist/layout/semantic/place.d.ts +19 -4
  49. package/dist/layout/semantic/place.js +232 -34
  50. package/dist/layout/semantic/route.js +47 -14
  51. package/llms.txt +9 -0
  52. package/package.json +5 -1
@@ -38,4 +38,19 @@ export declare function assignStableFlowIds(elements: BpmnFlowElement[], flows:
38
38
  export declare function rootDefinitionId(prefix: string, source: string, existing: ReadonlyArray<{
39
39
  id: string;
40
40
  }>): string;
41
+ /**
42
+ * Id for an event definition that carries none. Zeebe rejects a definition
43
+ * without an `id` at deploy time, so one is derived from the owning event
44
+ * (`Start_TimerEventDefinition`), with a counter when an event holds several
45
+ * of one kind. Ids already present on sibling definitions are never reused.
46
+ */
47
+ export declare function eventDefinitionId(ownerId: string, defs: readonly {
48
+ id?: string;
49
+ type: string;
50
+ }[], index: number): string;
51
+ /** Gives every id-less definition of `defs` a derived id; see `eventDefinitionId`. */
52
+ export declare function assignEventDefinitionIds(ownerId: string, defs: {
53
+ id?: string;
54
+ type: string;
55
+ }[]): void;
41
56
  //# sourceMappingURL=stable-ids.d.ts.map
@@ -197,4 +197,30 @@ export function rootDefinitionId(prefix, source, existing) {
197
197
  const taken = new Set(existing.map((definition) => definition.id));
198
198
  return uniqueId(capLength(`${prefix}_${ncName(slugify(source))}`), taken);
199
199
  }
200
+ /**
201
+ * Id for an event definition that carries none. Zeebe rejects a definition
202
+ * without an `id` at deploy time, so one is derived from the owning event
203
+ * (`Start_TimerEventDefinition`), with a counter when an event holds several
204
+ * of one kind. Ids already present on sibling definitions are never reused.
205
+ */
206
+ export function eventDefinitionId(ownerId, defs, index) {
207
+ const def = defs[index];
208
+ if (def === undefined)
209
+ return `${ncName(ownerId)}_EventDefinition`;
210
+ const kind = def.type.charAt(0).toUpperCase() + def.type.slice(1);
211
+ const base = `${ncName(ownerId)}_${kind}EventDefinition`;
212
+ const taken = new Set(defs.map((d) => d.id).filter((id) => id !== undefined));
213
+ const sameKind = defs.slice(0, index + 1).filter((d) => d.type === def.type).length;
214
+ let candidate = sameKind > 1 ? `${base}_${sameKind}` : base;
215
+ for (let n = sameKind + 1; taken.has(candidate); n++)
216
+ candidate = `${base}_${n}`;
217
+ return candidate;
218
+ }
219
+ /** Gives every id-less definition of `defs` a derived id; see `eventDefinitionId`. */
220
+ export function assignEventDefinitionIds(ownerId, defs) {
221
+ defs.forEach((d, i) => {
222
+ if (d.id === undefined)
223
+ d.id = eventDefinitionId(ownerId, defs, i);
224
+ });
225
+ }
200
226
  //# sourceMappingURL=stable-ids.js.map
package/dist/bpmn/svg.js CHANGED
@@ -121,7 +121,7 @@ export function exportSvg(defs, options) {
121
121
  // Edge label
122
122
  if (flow?.name && edge.label?.bounds) {
123
123
  const { x, y, width, height } = edge.label.bounds;
124
- edgeParts.push(labelSvg(flow.name, x + width / 2, y + height / 2, width - 4, t, false, fontOf(edge.label)));
124
+ edgeParts.push(labelSvg(flow.name, x + width / 2, y + height / 2, width, t, false, fontOf(edge.label)));
125
125
  }
126
126
  }
127
127
  // ── Shapes ────────────────────────────────────────────────────────────────
@@ -193,7 +193,7 @@ export function exportSvg(defs, options) {
193
193
  width: 80,
194
194
  height: 20,
195
195
  };
196
- labelParts.push(labelSvg(el.name, lb.x + lb.width / 2, lb.y + lb.height / 2, lb.width - 4, t, true, font));
196
+ labelParts.push(labelSvg(el.name, lb.x + lb.width / 2, lb.y + lb.height / 2, lb.width, t, true, font));
197
197
  }
198
198
  }
199
199
  // ── Assemble SVG ──────────────────────────────────────────────────────────
@@ -511,10 +511,9 @@ function renderTask(el, width, height, t, options) {
511
511
  out += labelSvg(el.name, width / 2, height / 2, width - 16, t, false, options?.font);
512
512
  }
513
513
  }
514
- if (type === "subProcess" ||
515
- type === "adHocSubProcess" ||
516
- type === "eventSubProcess" ||
517
- type === "transaction") {
514
+ // The "+" marker means "contents elsewhere"; an expanded body shows them.
515
+ const container = type === "subProcess" || type === "eventSubProcess" || type === "transaction";
516
+ if ((container && !options?.expanded) || type === "adHocSubProcess") {
518
517
  out += iconGroup(subProcessMarker(type), width / 2, height - 10, t);
519
518
  }
520
519
  return out;
@@ -0,0 +1,8 @@
1
+ import type { BpmnProcess } from "./bpmn-model.js";
2
+ /** xsd:ID is an NCName: no spaces or colons, and it never starts with a digit. */
3
+ export declare function assertNcName(id: unknown, what: string): void;
4
+ /** @throws {ValidationError} On the first value the XSD would reject at deploy. */
5
+ export declare function assertXsdValues(process: BpmnProcess): void;
6
+ /** Checks `retries` as typed on the builder option, before it is serialised. */
7
+ export declare function assertRetriesOption(value: unknown, id: string): void;
8
+ //# sourceMappingURL=xsd-guards.d.ts.map
@@ -0,0 +1,56 @@
1
+ import { ValidationError } from "../errors.js";
2
+ /**
3
+ * Build-time checks for attributes the BPMN/Zeebe XSD types strictly.
4
+ *
5
+ * A script-supplied value outside the type serialises fine and is only
6
+ * rejected at deploy ("cvc-datatype-valid", "cvc-enumeration-valid") with the
7
+ * attribute name redacted, so these throw at the call site's `build()` with the
8
+ * allowed values instead.
9
+ */
10
+ const NCNAME = /^[A-Za-z_][A-Za-z0-9_.-]*$/;
11
+ // Zeebe accepts a whole number or a FEEL expression ("=retryCount").
12
+ const RETRIES = /^(=.+|\d+)$/;
13
+ const HINT = " See agent-cards/bpmn.md#traps.";
14
+ /** xsd:ID is an NCName: no spaces or colons, and it never starts with a digit. */
15
+ export function assertNcName(id, what) {
16
+ if (typeof id !== "string" || !NCNAME.test(id)) {
17
+ throw new ValidationError(`${what} id ${JSON.stringify(id)} is not a valid XML id (xsd:ID). Allowed: letters, digits, "_", "-", "." — starting with a letter or "_", no spaces or ":". Example: "Task_ApproveOrder".${HINT}`);
18
+ }
19
+ }
20
+ function assertBoolean(value, attr, id) {
21
+ if (value !== undefined && typeof value !== "boolean") {
22
+ throw new ValidationError(`${attr} on "${id}" must be a boolean (true | false), got ${JSON.stringify(value)}.${HINT}`);
23
+ }
24
+ }
25
+ function assertRetries(value, id) {
26
+ if (value === undefined)
27
+ return;
28
+ if (typeof value !== "string" || !RETRIES.test(value)) {
29
+ throw new ValidationError(`retries on "${id}" must be a whole-number string like "3" or a FEEL expression like "=retries", got ${JSON.stringify(value)}.${HINT}`);
30
+ }
31
+ }
32
+ function checkElements(elements) {
33
+ for (const el of elements) {
34
+ assertNcName(el.id, "Element");
35
+ const loose = el;
36
+ assertBoolean(loose.cancelActivity, "cancelActivity", el.id);
37
+ assertBoolean(loose.isInterrupting, "isInterrupting", el.id);
38
+ const loop = loose.loopCharacteristics;
39
+ assertBoolean(loop?.isSequential, "multiInstance.isSequential", el.id);
40
+ if (Array.isArray(loose.flowElements)) {
41
+ checkElements(loose.flowElements);
42
+ }
43
+ }
44
+ }
45
+ /** @throws {ValidationError} On the first value the XSD would reject at deploy. */
46
+ export function assertXsdValues(process) {
47
+ assertNcName(process.id, "Process");
48
+ checkElements(process.flowElements);
49
+ for (const flow of process.sequenceFlows)
50
+ assertNcName(flow.id, "Sequence flow");
51
+ }
52
+ /** Checks `retries` as typed on the builder option, before it is serialised. */
53
+ export function assertRetriesOption(value, id) {
54
+ assertRetries(value, id);
55
+ }
56
+ //# sourceMappingURL=xsd-guards.js.map
@@ -0,0 +1,19 @@
1
+ /** Appends the pointer to a card's trap list, so a fix loop learns where the rule is explained. */
2
+ export declare function withCardHint(findings: CheckFinding[], card: "bpmn" | "dmn" | "form"): CheckFinding[];
3
+ /** How bad a {@link CheckFinding} is. `error` means the resource will not deploy or run as written. */
4
+ export type CheckSeverity = "error" | "warning" | "info";
5
+ /**
6
+ * One problem in a DMN or form resource, shaped for an agent's fix loop:
7
+ * which rule fired, where, what is wrong and what to change.
8
+ */
9
+ export interface CheckFinding {
10
+ /** Stable rule id, e.g. `dmn/unresolved-requirement` or `form/duplicate-key`. */
11
+ rule: string;
12
+ severity: CheckSeverity;
13
+ /** The element (DMN) or component (form) the finding is about, when there is one. */
14
+ elementId?: string;
15
+ message: string;
16
+ /** A concrete change that resolves the finding. */
17
+ fix: string;
18
+ }
19
+ //# sourceMappingURL=check-finding.d.ts.map
@@ -0,0 +1,5 @@
1
+ /** Appends the pointer to a card's trap list, so a fix loop learns where the rule is explained. */
2
+ export function withCardHint(findings, card) {
3
+ return findings.map((f) => ({ ...f, fix: `${f.fix} (agent-cards/${card}.md#traps)` }));
4
+ }
5
+ //# sourceMappingURL=check-finding.js.map
@@ -1,3 +1,4 @@
1
+ import { ValidationError } from "../errors.js";
1
2
  import { generateId } from "../types/id-generator.js";
2
3
  import { layoutDmn } from "./dmn-layout.js";
3
4
  // ── Compactify ────────────────────────────────────────────────────────────────
@@ -50,11 +51,19 @@ export function expandDmn(compact) {
50
51
  const inputData = compact.inputData.map((d) => ({ id: d.id, name: d.name }));
51
52
  const decisions = compact.decisions.map((cd) => {
52
53
  // Build requirement links
53
- const informationRequirements = (cd.requires ?? []).map((srcId) => ({
54
- id: generateId("InformationRequirement"),
55
- requiredDecision: compact.decisions.some((d) => d.id === srcId) ? srcId : undefined,
56
- requiredInput: compact.inputData.some((d) => d.id === srcId) ? srcId : undefined,
57
- }));
54
+ const informationRequirements = (cd.requires ?? []).map((srcId) => {
55
+ const isDecision = compact.decisions.some((d) => d.id === srcId);
56
+ const isInput = compact.inputData.some((d) => d.id === srcId);
57
+ if (!isDecision && !isInput) {
58
+ const valid = [...compact.decisions, ...compact.inputData].map((d) => d.id).join(", ");
59
+ throw new ValidationError(`Decision "${cd.id}" requires unknown id "${srcId}". Valid ids: ${valid || "(none)"}. Use ids, not names. See agent-cards/dmn.md#traps.`);
60
+ }
61
+ return {
62
+ id: generateId("InformationRequirement"),
63
+ requiredDecision: isDecision ? srcId : undefined,
64
+ requiredInput: isInput ? srcId : undefined,
65
+ };
66
+ });
58
67
  // Build decision table
59
68
  let decisionTable;
60
69
  if (cd.inputs.length > 0 || cd.outputs.length > 0 || cd.rules.length > 0) {
@@ -64,10 +64,10 @@ export class DecisionTableBuilder {
64
64
  */
65
65
  rule(options) {
66
66
  if (options.inputs.length !== this.inputColumns.length) {
67
- throw new ValidationError(`Rule has ${options.inputs.length} inputs but table has ${this.inputColumns.length} input columns`);
67
+ throw new ValidationError(`Rule has ${options.inputs.length} inputs but table has ${this.inputColumns.length} input columns. See agent-cards/dmn.md#traps.`);
68
68
  }
69
69
  if (options.outputs.length !== this.outputColumns.length) {
70
- throw new ValidationError(`Rule has ${options.outputs.length} outputs but table has ${this.outputColumns.length} output columns`);
70
+ throw new ValidationError(`Rule has ${options.outputs.length} outputs but table has ${this.outputColumns.length} output columns. See agent-cards/dmn.md#traps.`);
71
71
  }
72
72
  const inputEntries = options.inputs.map((text) => ({
73
73
  id: generateId("UnaryTests"),
@@ -125,7 +125,7 @@ export class DecisionTableBuilder {
125
125
  },
126
126
  modelerAttributes: {
127
127
  executionPlatform: "Camunda Cloud",
128
- executionPlatformVersion: "8.5.0",
128
+ executionPlatformVersion: "8.10.0",
129
129
  },
130
130
  decisions: [decision],
131
131
  inputData: [],
@@ -0,0 +1,53 @@
1
+ import { DecisionTableBuilder } from "./dmn-builder.js";
2
+ import type { DmnDefinitions } from "./dmn-model.js";
3
+ declare const drgIdBrand: unique symbol;
4
+ /** Id of a decision or input data element in a DRD. Get one from a handle or `drgId()`. */
5
+ export type DrgId = string & {
6
+ readonly [drgIdBrand]: true;
7
+ };
8
+ /** Returned by `DrdBuilder.decision()`; pass it to `requires` of a later decision. */
9
+ export interface DecisionHandle {
10
+ readonly kind: "decision";
11
+ readonly id: DrgId;
12
+ readonly name: string;
13
+ }
14
+ /** Returned by `DrdBuilder.inputData()`. */
15
+ export interface InputDataHandle {
16
+ readonly kind: "inputData";
17
+ readonly id: DrgId;
18
+ readonly name: string;
19
+ }
20
+ /** Something a decision can require: a handle or a branded id. */
21
+ export type DrgRef = DecisionHandle | InputDataHandle | DrgId;
22
+ /** Brand a literal id string. Validated against the DRD at `build()`. */
23
+ export declare function drgId(id: string): DrgId;
24
+ export interface DrdDecisionOptions {
25
+ /** Decisions or input data this decision depends on (never labels). */
26
+ requires?: DrgRef[];
27
+ }
28
+ /** Fluent builder for multi-decision DRDs with information requirements. */
29
+ export declare class DrdBuilder {
30
+ private readonly decisions;
31
+ private readonly inputs;
32
+ private readonly drdName;
33
+ constructor(name?: string);
34
+ private assertFreeId;
35
+ /** Add an input data element. */
36
+ inputData(id: string, name?: string): InputDataHandle;
37
+ /**
38
+ * Add a decision. `table` configures its decision table (use `.name()` for the label).
39
+ * Returns a handle to pass in `requires` of decisions added later.
40
+ */
41
+ decision(id: string, table: (t: DecisionTableBuilder) => DecisionTableBuilder, options?: DrdDecisionOptions): DecisionHandle;
42
+ private resolve;
43
+ /**
44
+ * Build the DMN definitions with information requirements and DMNDI layout.
45
+ *
46
+ * @throws {ValidationError} If a `requires` entry is not the id of a decision or input data.
47
+ */
48
+ build(): DmnDefinitions;
49
+ /** Build and export as DMN XML string. */
50
+ toXml(): string;
51
+ }
52
+ export {};
53
+ //# sourceMappingURL=drd-builder.d.ts.map
@@ -0,0 +1,100 @@
1
+ import { ValidationError } from "../errors.js";
2
+ import { generateId } from "../types/id-generator.js";
3
+ import { DecisionTableBuilder } from "./dmn-builder.js";
4
+ import { layoutDmn } from "./dmn-layout.js";
5
+ import { serializeDmn } from "./dmn-serializer.js";
6
+ /** Brand a literal id string. Validated against the DRD at `build()`. */
7
+ export function drgId(id) {
8
+ return id;
9
+ }
10
+ /** Fluent builder for multi-decision DRDs with information requirements. */
11
+ export class DrdBuilder {
12
+ decisions = [];
13
+ inputs = [];
14
+ drdName;
15
+ constructor(name = "DRD") {
16
+ this.drdName = name;
17
+ }
18
+ assertFreeId(id) {
19
+ const taken = [...this.decisions.map((d) => d.decision.id), ...this.inputs.map((i) => i.id)];
20
+ if (taken.includes(id))
21
+ throw new ValidationError(`Duplicate DRD element id "${id}"`);
22
+ }
23
+ /** Add an input data element. */
24
+ inputData(id, name = id) {
25
+ this.assertFreeId(id);
26
+ this.inputs.push({ id, name });
27
+ return { kind: "inputData", id: id, name };
28
+ }
29
+ /**
30
+ * Add a decision. `table` configures its decision table (use `.name()` for the label).
31
+ * Returns a handle to pass in `requires` of decisions added later.
32
+ */
33
+ decision(id, table, options = {}) {
34
+ this.assertFreeId(id);
35
+ const built = table(new DecisionTableBuilder(id)).build().decisions[0];
36
+ if (!built)
37
+ throw new ValidationError(`Decision "${id}" produced no decision`);
38
+ this.decisions.push({ decision: built, requires: options.requires ?? [] });
39
+ return { kind: "decision", id: id, name: built.name ?? id };
40
+ }
41
+ resolve(owner, ref) {
42
+ const id = typeof ref === "string" ? ref : ref.id;
43
+ const decisionIds = this.decisions.map((d) => d.decision.id);
44
+ const known = [...decisionIds, ...this.inputs.map((i) => i.id)];
45
+ if (known.includes(id))
46
+ return id;
47
+ const byName = this.decisions.find((d) => d.decision.name === id)?.decision.id ??
48
+ this.inputs.find((i) => i.name === id)?.id;
49
+ const hint = byName
50
+ ? ` "${id}" is a name/label, not an id. Use the id "${byName}" (pass the handle returned by decision()).`
51
+ : "";
52
+ throw new ValidationError(`Decision "${owner}" requires unknown id "${id}". Valid ids: ${known.join(", ") || "(none)"}.${hint} See agent-cards/dmn.md#traps.`);
53
+ }
54
+ /**
55
+ * Build the DMN definitions with information requirements and DMNDI layout.
56
+ *
57
+ * @throws {ValidationError} If a `requires` entry is not the id of a decision or input data.
58
+ */
59
+ build() {
60
+ const decisions = this.decisions.map(({ decision, requires }) => ({
61
+ ...decision,
62
+ informationRequirements: requires.map((ref) => {
63
+ const target = this.resolve(decision.id, ref);
64
+ const isDecision = this.decisions.some((d) => d.decision.id === target);
65
+ return {
66
+ id: generateId("InformationRequirement"),
67
+ ...(isDecision ? { requiredDecision: target } : { requiredInput: target }),
68
+ };
69
+ }),
70
+ }));
71
+ return layoutDmn({
72
+ id: generateId("Definitions"),
73
+ name: this.drdName,
74
+ namespace: "http://camunda.org/schema/1.0/dmn",
75
+ exporter: "bpmn-sdk",
76
+ exporterVersion: "0.0.1",
77
+ namespaces: {
78
+ "": "https://www.omg.org/spec/DMN/20191111/MODEL/",
79
+ dmndi: "https://www.omg.org/spec/DMN/20191111/DMNDI/",
80
+ dc: "http://www.omg.org/spec/DMN/20180521/DC/",
81
+ modeler: "http://camunda.org/schema/modeler/1.0",
82
+ },
83
+ modelerAttributes: {
84
+ executionPlatform: "Camunda Cloud",
85
+ executionPlatformVersion: "8.10.0",
86
+ },
87
+ decisions,
88
+ inputData: this.inputs,
89
+ knowledgeSources: [],
90
+ businessKnowledgeModels: [],
91
+ textAnnotations: [],
92
+ associations: [],
93
+ });
94
+ }
95
+ /** Build and export as DMN XML string. */
96
+ toXml() {
97
+ return serializeDmn(this.build());
98
+ }
99
+ }
100
+ //# sourceMappingURL=drd-builder.js.map
@@ -1,14 +1,49 @@
1
1
  import { compactifyDmn, expandDmn } from "./compact.js";
2
2
  import { DecisionTableBuilder } from "./dmn-builder.js";
3
3
  import type { DmnDefinitions } from "./dmn-model.js";
4
+ import { DrdBuilder } from "./drd-builder.js";
4
5
  export { layoutDmn, benchmarkDmnLayout } from "./dmn-layout.js";
5
6
  export type { DmnBenchmarkResult, DmnElementPosition } from "./dmn-layout.js";
7
+ export { drgId } from "./drd-builder.js";
8
+ export type { DecisionHandle, DrdBuilder, DrdDecisionOptions, DrgId, DrgRef, InputDataHandle, } from "./drd-builder.js";
6
9
  export { compactifyDmn, expandDmn } from "./compact.js";
7
10
  export type { CompactDmn, CompactDmnDecision, CompactDmnInput, CompactDmnOutput, CompactDmnRule, } from "./compact.js";
8
11
  /** Entry point for DMN decision table operations. */
12
+ /**
13
+ * Top-level DMN namespace: build, parse and export decision tables and DRDs.
14
+ *
15
+ * @example
16
+ * ```typescript
17
+ * const defs = Dmn.createDecisionTable("risk")
18
+ * .input({ label: "Score", expression: "score", typeRef: "number" })
19
+ * .output({ label: "Level", name: "level", typeRef: "string" })
20
+ * .rule({ inputs: ["> 700"], outputs: ['"low"'] })
21
+ * .build()
22
+ * const xml = Dmn.export(defs)
23
+ * ```
24
+ *
25
+ * @see node_modules/@bpmnkit/core/agent-cards/dmn.md — runnable script and traps (~1k tokens)
26
+ */
9
27
  export declare const Dmn: {
10
28
  /** Create a new DMN decision table using the fluent builder API. */
11
29
  readonly createDecisionTable: (decisionId: string) => DecisionTableBuilder;
30
+ /**
31
+ * Create a multi-decision DRD. `decision()` returns a handle; pass it (or a
32
+ * `drgId()`) in `requires` of a later decision. Labels are rejected at build time.
33
+ *
34
+ * @example
35
+ * ```typescript
36
+ * const drd = Dmn.drd("Loan")
37
+ * const risk = drd.decision("risk", (t) => t.input({ expression: "score" }).output({ name: "level" }))
38
+ * drd.decision("offer", (t) => t.input({ expression: "level" }).output({ name: "rate" }), {
39
+ * requires: [risk], // the handle, not a name
40
+ * })
41
+ * const xml = drd.toXml()
42
+ * ```
43
+ *
44
+ * @see node_modules/@bpmnkit/core/agent-cards/dmn.md — the multi-decision DRD script
45
+ */
46
+ readonly drd: (name?: string) => DrdBuilder;
12
47
  /** Parse a DMN XML string into a typed model. */
13
48
  readonly parse: (xml: string) => DmnDefinitions;
14
49
  /** Export a typed DMN model to XML string. */
package/dist/dmn/index.js CHANGED
@@ -3,14 +3,50 @@ import { DecisionTableBuilder } from "./dmn-builder.js";
3
3
  import { layoutDmn } from "./dmn-layout.js";
4
4
  import { parseDmn } from "./dmn-parser.js";
5
5
  import { serializeDmn } from "./dmn-serializer.js";
6
+ import { DrdBuilder } from "./drd-builder.js";
6
7
  export { layoutDmn, benchmarkDmnLayout } from "./dmn-layout.js";
8
+ export { drgId } from "./drd-builder.js";
7
9
  export { compactifyDmn, expandDmn } from "./compact.js";
8
10
  /** Entry point for DMN decision table operations. */
11
+ /**
12
+ * Top-level DMN namespace: build, parse and export decision tables and DRDs.
13
+ *
14
+ * @example
15
+ * ```typescript
16
+ * const defs = Dmn.createDecisionTable("risk")
17
+ * .input({ label: "Score", expression: "score", typeRef: "number" })
18
+ * .output({ label: "Level", name: "level", typeRef: "string" })
19
+ * .rule({ inputs: ["> 700"], outputs: ['"low"'] })
20
+ * .build()
21
+ * const xml = Dmn.export(defs)
22
+ * ```
23
+ *
24
+ * @see node_modules/@bpmnkit/core/agent-cards/dmn.md — runnable script and traps (~1k tokens)
25
+ */
9
26
  export const Dmn = {
10
27
  /** Create a new DMN decision table using the fluent builder API. */
11
28
  createDecisionTable(decisionId) {
12
29
  return new DecisionTableBuilder(decisionId);
13
30
  },
31
+ /**
32
+ * Create a multi-decision DRD. `decision()` returns a handle; pass it (or a
33
+ * `drgId()`) in `requires` of a later decision. Labels are rejected at build time.
34
+ *
35
+ * @example
36
+ * ```typescript
37
+ * const drd = Dmn.drd("Loan")
38
+ * const risk = drd.decision("risk", (t) => t.input({ expression: "score" }).output({ name: "level" }))
39
+ * drd.decision("offer", (t) => t.input({ expression: "level" }).output({ name: "rate" }), {
40
+ * requires: [risk], // the handle, not a name
41
+ * })
42
+ * const xml = drd.toXml()
43
+ * ```
44
+ *
45
+ * @see node_modules/@bpmnkit/core/agent-cards/dmn.md — the multi-decision DRD script
46
+ */
47
+ drd(name) {
48
+ return new DrdBuilder(name);
49
+ },
14
50
  /** Parse a DMN XML string into a typed model. */
15
51
  parse(xml) {
16
52
  return parseDmn(xml);
@@ -0,0 +1,19 @@
1
+ import { type CheckFinding } from "../check-finding.js";
2
+ /**
3
+ * Checks a DMN document for the mistakes Zeebe either rejects at deploy time
4
+ * or reports with an error that hides the cause: malformed XML, duplicate ids,
5
+ * requirement references that resolve to nothing, FEEL that does not parse,
6
+ * invalid hit policies and unknown types.
7
+ *
8
+ * Reads the raw XML rather than the `Dmn` model so a document the model
9
+ * cannot represent is still reported on instead of thrown away.
10
+ *
11
+ * @param xml - The DMN document's text.
12
+ *
13
+ * @example
14
+ * ```typescript
15
+ * for (const f of lintDmn(xml)) console.log(`${f.rule} [${f.elementId}] ${f.message} — ${f.fix}`)
16
+ * ```
17
+ */
18
+ export declare function lintDmn(xml: string): CheckFinding[];
19
+ //# sourceMappingURL=lint.d.ts.map