bpmnlint 11.4.2 → 11.4.4

package/README.md

@@ -35,7 +35,7 @@ Validate your diagrams via the commandline:
 
 ## Rules
 
-Our [documentation](https://github.com/bpmn-io/bpmnlint/tree/master/docs/rules#rules) lists all currenty implemented rules, the [`./rules` folder](https://github.com/bpmn-io/bpmnlint/tree/master/rules) contains each rules implementation.
+Our [documentation](https://github.com/bpmn-io/bpmnlint/tree/main/docs/rules#rules) lists all currenty implemented rules, the [`./rules` folder](https://github.com/bpmn-io/bpmnlint/tree/main/rules) contains each rules implementation.
 
 Do you miss a rule that should be included? [Propose a new rule](https://github.com/bpmn-io/bpmnlint/issues/new?assignees=&labels=rules&template=NEW_RULE.md).
 
@@ -61,6 +61,19 @@ Add or customize rules using the `rules` block:
 }
 ```
 
+You may also extend from multiple configurations, including those provided by [custom plug-ins](#writing-a-plug-in):
+
+```json
+{
+  "extends": [
+    "bpmnlint:recommended",
+    "plugin:foo/recommended",
+    "plugin:@bar/bpmnlint-plugin-bar/recommended"
+  ]
+}
+```
+
+This will amend core `recommended` rules with `recommended` rulesets provided by `bpmnlint-plugin-foo` and `@bar/bpmnlint-plugin-bar`, respectively.
 
 ## API
 
@@ -118,6 +131,25 @@ npm init bpmnlint-plugin {PLUGIN_NAME}
 
 Checkout the [bpmnlint-plugin-example](https://github.com/bpmn-io/bpmnlint-plugin-example) for details on how to define, test, and consume custom lint rules. Use the [bpmnlint playground](https://github.com/bpmn-io/bpmnlint-playground) to implement new rules with quick visual feedback.
 
+> [!NOTE]
+> Plug-ins must always follow the naming scheme `bpmnlint-plugin-{NAME_OF_YOUR_PLUGIN}` and may contain a namespace prefix.
+
+When using your custom plug-in, reference its configuration or rules via the shorthand plug-in name, or the full identifier:
+
+```json
+{
+  "extends": [
+    "bpmnlint:recommended",
+    "plugin:foo/recommended",
+    "plugin:@bar/bpmnlint-plugin-bar/recommended"
+  ],
+  "rules": {
+    "foo/special-rule": "off",
+    "@bar/bar/other-rule": "warn"
+  }
+}
+```
+
 
 ## Bundling
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bpmnlint",
   "description": "Validate your BPMN diagrams based on configurable lint rules",
-  "version": "11.4.2",
+  "version": "11.4.4",
   "main": "lib/index.js",
   "keywords": [
     "bpmnlint",
@@ -51,7 +51,7 @@
     "tiny-glob": "^0.2.9"
   },
   "devDependencies": {
-    "@bpmn-io/bpmnlint-generate-docs-images": "^0.4.0",
+    "@bpmn-io/bpmnlint-generate-docs-images": "^1.0.0",
     "@types/mocha": "^10.0.10",
     "chai": "^4.5.0",
     "eslint": "^9.17.0",

package/rules/ad-hoc-sub-process.js

@@ -1,6 +1,5 @@
 const {
-  is,
-  isAny
+  is
 } = require('bpmnlint-utils');
 
 const {
@@ -36,9 +35,9 @@ module.exports = function() {
         reporter.report(flowElement.id, 'An <End Event> is not allowed in <Ad Hoc Sub Process>');
       }
 
-      if (isAny(flowElement, [ 'bpmn:IntermediateCatchEvent', 'bpmn:IntermediateThrowEvent' ])) {
+      if (is(flowElement, 'bpmn:IntermediateCatchEvent')) {
         if (!flowElement.outgoing || flowElement.outgoing.length === 0) {
-          reporter.report(flowElement.id, 'An intermediate event inside <Ad Hoc Sub Process> must have an outgoing sequence flow');
+          reporter.report(flowElement.id, 'An intermediate catch event inside <Ad Hoc Sub Process> must have an outgoing sequence flow');
         }
       }
 
@@ -49,4 +48,4 @@ module.exports = function() {
     check
   });
 
-};
+};

package/rules/no-disconnected.js

@@ -34,6 +34,11 @@ module.exports = function() {
       return;
     }
 
+    // adhoc subprocesses can have disconnected activities
+    if (is(node.$parent, 'bpmn:AdHocSubProcess')) {
+      return;
+    }
+
     const incoming = node.incoming || [];
     const outgoing = node.outgoing || [];
 

package/rules/no-implicit-end.js

@@ -63,6 +63,10 @@ module.exports = function() {
       return false;
     }
 
+    if (is(node.$parent, 'bpmn:AdHocSubProcess')) {
+      return false;
+    }
+
     if (is(node, 'bpmn:EndEvent')) {
       return false;
     }

package/rules/no-implicit-start.js

@@ -29,6 +29,10 @@ module.exports = function() {
       return false;
     }
 
+    if (is(node.$parent, 'bpmn:AdHocSubProcess')) {
+      return false;
+    }
+
     if (is(node, 'bpmn:SubProcess') && node.triggeredByEvent) {
       return false;
     }