@camunda/linting 3.27.1 → 3.28.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.
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2022-present Camunda Services GmbH
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2022-present Camunda Services GmbH
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,75 +1,75 @@
1
- # @camunda/linting
2
-
3
- [![CI](https://github.com/camunda/linting/actions/workflows/CI.yml/badge.svg)](https://github.com/camunda/linting/actions/workflows/CI.yml)
4
-
5
- The BPMN linter used by the Camunda Desktop and Web Modeler. Batteries included. 🔋
6
-
7
- ## Features
8
-
9
- * bundles [bpmnlint](https://github.com/bpmn-io/bpmnlint) and [bpmnlint-plugin-camunda-compat](https://github.com/camunda/bpmnlint-plugin-camunda-compat/)
10
- * configures linter based on `modeler:executionPlatform` and `modeler:executionPlatformVersion`
11
- * creates error messages to be shown in desktop and web modeler
12
- * creates errors to be shown in properties panel
13
- * creates error overlays to be shown on canvas
14
-
15
- ## Usage
16
-
17
- ```javascript
18
- import Modeler from 'bpmn-js/lib/Modeler';
19
-
20
- import { Linter } from '@camunda/linting';
21
-
22
- import lintingModule from '@camunda/linting/modeler';
23
-
24
- import '@camunda/linting/assets/linting.css';
25
-
26
- const modeler = new Modeler({
27
- additionalModules: [
28
- lintingModule
29
- ]
30
- });
31
-
32
- // configure to be used with desktop or web modeler
33
- const linter = new Linter({
34
- modeler: 'web', // `desktop` or `web` modeler, defaults to `desktop`
35
- type: 'cloud' // `cloud` or `platform` diagrams, defaults to `cloud`
36
- });
37
-
38
- // lint by passing definitions
39
- const reports = await linter.lint(definitions);
40
-
41
- // or passing XML
42
- const reports = await linter.lint(xml);
43
-
44
- ...
45
-
46
- // update errors on canvas and in properties panel (requires bpmn-js-properties-panel >= 1.3.0)
47
- modeler.get('linting').setErrors(reports);
48
-
49
- // show error by selecting element and properties panel entry
50
- modeler.get('linting').showError(report);
51
-
52
- // activate and deactivate errors on canvas
53
- modeler.get('linting').activate();
54
- modeler.get('linting').deactivate();
55
- ```
56
-
57
- ## Development
58
-
59
- ```sh
60
- # install
61
- npm i
62
-
63
- # run tests
64
- npm t
65
-
66
- # run tests in watch mode
67
- npm run test:watch
68
-
69
- # run example
70
- npm start
71
- ```
72
-
73
- ## License
74
-
75
- MIT
1
+ # @camunda/linting
2
+
3
+ [![CI](https://github.com/camunda/linting/actions/workflows/CI.yml/badge.svg)](https://github.com/camunda/linting/actions/workflows/CI.yml)
4
+
5
+ The BPMN linter used by the Camunda Desktop and Web Modeler. Batteries included. 🔋
6
+
7
+ ## Features
8
+
9
+ * bundles [bpmnlint](https://github.com/bpmn-io/bpmnlint) and [bpmnlint-plugin-camunda-compat](https://github.com/camunda/bpmnlint-plugin-camunda-compat/)
10
+ * configures linter based on `modeler:executionPlatform` and `modeler:executionPlatformVersion`
11
+ * creates error messages to be shown in desktop and web modeler
12
+ * creates errors to be shown in properties panel
13
+ * creates error overlays to be shown on canvas
14
+
15
+ ## Usage
16
+
17
+ ```javascript
18
+ import Modeler from 'bpmn-js/lib/Modeler';
19
+
20
+ import { Linter } from '@camunda/linting';
21
+
22
+ import lintingModule from '@camunda/linting/modeler';
23
+
24
+ import '@camunda/linting/assets/linting.css';
25
+
26
+ const modeler = new Modeler({
27
+ additionalModules: [
28
+ lintingModule
29
+ ]
30
+ });
31
+
32
+ // configure to be used with desktop or web modeler
33
+ const linter = new Linter({
34
+ modeler: 'web', // `desktop` or `web` modeler, defaults to `desktop`
35
+ type: 'cloud' // `cloud` or `platform` diagrams, defaults to `cloud`
36
+ });
37
+
38
+ // lint by passing definitions
39
+ const reports = await linter.lint(definitions);
40
+
41
+ // or passing XML
42
+ const reports = await linter.lint(xml);
43
+
44
+ ...
45
+
46
+ // update errors on canvas and in properties panel (requires bpmn-js-properties-panel >= 1.3.0)
47
+ modeler.get('linting').setErrors(reports);
48
+
49
+ // show error by selecting element and properties panel entry
50
+ modeler.get('linting').showError(report);
51
+
52
+ // activate and deactivate errors on canvas
53
+ modeler.get('linting').activate();
54
+ modeler.get('linting').deactivate();
55
+ ```
56
+
57
+ ## Development
58
+
59
+ ```sh
60
+ # install
61
+ npm i
62
+
63
+ # run tests
64
+ npm t
65
+
66
+ # run tests in watch mode
67
+ npm run test:watch
68
+
69
+ # run example
70
+ npm start
71
+ ```
72
+
73
+ ## License
74
+
75
+ MIT
@@ -1,38 +1,38 @@
1
- :root {
2
- --cl-color-white: hsl(0, 0%, 100%);
3
-
4
- --cl-color-info: #0f62fe;
5
- --cl-color-warning: #ff832b;
6
- --cl-color-error: #da1e26;
7
- --cl-color-success: #52b415;
8
- }
9
-
10
- .cl-icon, .cl-icon * {
11
- box-sizing: border-box;
12
- }
13
-
14
- .cl-icon {
15
- --icon-color: white;
16
- --icon-bg-color: #333;
17
- background: var(--icon-bg-color);
18
- color: var(--icon-color);
19
- border-radius: 100%;
20
- height: 20px;
21
- width: 20px;
22
- border: solid 4px var(--icon-bg-color);
23
- display: flex;
24
- align-items: center;
25
- justify-content: center;
26
- }
27
-
28
- .cl-icon-error {
29
- --icon-bg-color: var(--cl-color-error);
30
- }
31
-
32
- .cl-icon-warn {
33
- --icon-bg-color: var(--cl-color-warning);
34
- }
35
-
36
- .cl-icon-info {
37
- --icon-bg-color: var(--cl-color-info);
1
+ :root {
2
+ --cl-color-white: hsl(0, 0%, 100%);
3
+
4
+ --cl-color-info: #0f62fe;
5
+ --cl-color-warning: #ff832b;
6
+ --cl-color-error: #da1e26;
7
+ --cl-color-success: #52b415;
8
+ }
9
+
10
+ .cl-icon, .cl-icon * {
11
+ box-sizing: border-box;
12
+ }
13
+
14
+ .cl-icon {
15
+ --icon-color: white;
16
+ --icon-bg-color: #333;
17
+ background: var(--icon-bg-color);
18
+ color: var(--icon-color);
19
+ border-radius: 100%;
20
+ height: 20px;
21
+ width: 20px;
22
+ border: solid 4px var(--icon-bg-color);
23
+ display: flex;
24
+ align-items: center;
25
+ justify-content: center;
26
+ }
27
+
28
+ .cl-icon-error {
29
+ --icon-bg-color: var(--cl-color-error);
30
+ }
31
+
32
+ .cl-icon-warn {
33
+ --icon-bg-color: var(--cl-color-warning);
34
+ }
35
+
36
+ .cl-icon-info {
37
+ --icon-bg-color: var(--cl-color-info);
38
38
  }
package/lib/Resolver.js CHANGED
@@ -1,31 +1,31 @@
1
- export default class NestedResolver {
2
- constructor(resolvers) {
3
- this.resolvers = resolvers.slice().reverse();
4
- }
5
-
6
- resolveRule(pkg, ruleName) {
7
- for (const resolver of this.resolvers) {
8
- try {
9
- return resolver.resolveRule(pkg, ruleName);
10
- } catch (err) {
11
-
12
- // ignore
13
- }
14
- }
15
-
16
- throw new Error(`unknown rule <${ pkg }/${ ruleName }>`);
17
- }
18
-
19
- resolveConfig(pkg, configName) {
20
- for (const resolver of this.resolvers) {
21
- try {
22
- return resolver.resolveConfig(pkg, configName);
23
- } catch (err) {
24
-
25
- // ignore
26
- }
27
- }
28
-
29
- throw new Error(`unknown config <${ pkg }/${ configName }>`);
30
- }
31
- }
1
+ export default class NestedResolver {
2
+ constructor(resolvers) {
3
+ this.resolvers = resolvers.slice().reverse();
4
+ }
5
+
6
+ resolveRule(pkg, ruleName) {
7
+ for (const resolver of this.resolvers) {
8
+ try {
9
+ return resolver.resolveRule(pkg, ruleName);
10
+ } catch (err) {
11
+
12
+ // ignore
13
+ }
14
+ }
15
+
16
+ throw new Error(`unknown rule <${ pkg }/${ ruleName }>`);
17
+ }
18
+
19
+ resolveConfig(pkg, configName) {
20
+ for (const resolver of this.resolvers) {
21
+ try {
22
+ return resolver.resolveConfig(pkg, configName);
23
+ } catch (err) {
24
+
25
+ // ignore
26
+ }
27
+ }
28
+
29
+ throw new Error(`unknown config <${ pkg }/${ configName }>`);
30
+ }
31
+ }
@@ -73,7 +73,8 @@ const rules = {
73
73
  "camunda-compat/user-task-definition": "warn",
74
74
  "camunda-compat/user-task-form": "error",
75
75
  "camunda-compat/version-tag": "error",
76
- "camunda-compat/wait-for-completion": "error"
76
+ "camunda-compat/wait-for-completion": "error",
77
+ "camunda-compat/zeebe-user-task": "error"
77
78
  };
78
79
 
79
80
  const config = {
@@ -267,4 +268,8 @@ cache['bpmnlint-plugin-camunda-compat/version-tag'] = rule_43;
267
268
 
268
269
  import rule_44 from 'bpmnlint-plugin-camunda-compat/rules/camunda-cloud/wait-for-completion';
269
270
 
270
- cache['bpmnlint-plugin-camunda-compat/wait-for-completion'] = rule_44;
271
+ cache['bpmnlint-plugin-camunda-compat/wait-for-completion'] = rule_44;
272
+
273
+ import rule_45 from 'bpmnlint-plugin-camunda-compat/rules/camunda-cloud/zeebe-user-task';
274
+
275
+ cache['bpmnlint-plugin-camunda-compat/zeebe-user-task'] = rule_45;
@@ -1,124 +1,124 @@
1
- import { getBusinessObject, is } from 'bpmn-js/lib/util/ModelUtil';
2
-
3
- import { getErrors } from '../utils/properties-panel';
4
-
5
- export default class Linting {
6
- constructor(canvas, config, elementRegistry, eventBus, lintingAnnotations, selection) {
7
- this._canvas = canvas;
8
- this._elementRegistry = elementRegistry;
9
- this._eventBus = eventBus;
10
- this._lintingAnnotations = lintingAnnotations;
11
- this._selection = selection;
12
-
13
- this._active = config && config.active || false;
14
- this._reports = [];
15
-
16
- eventBus.on('selection.changed', () => this._update());
17
-
18
- eventBus.on('lintingAnnotations.click', ({ report }) => this.showError(report));
19
- }
20
-
21
- showError(report) {
22
- const {
23
- id,
24
- propertiesPanel = {}
25
- } = report;
26
-
27
- const selectableElement = this._getSelectableElement(id);
28
-
29
- if (selectableElement) {
30
- this._canvas.scrollToElement(selectableElement);
31
-
32
- if (selectableElement === this._canvas.getRootElement()) {
33
- this._selection.select();
34
- } else {
35
- this._selection.select(selectableElement);
36
- }
37
- }
38
-
39
- const { entryIds = [] } = propertiesPanel;
40
-
41
- // TODO(philippfromme): remove timeout once properties panel is fixed
42
- setTimeout(() => {
43
- this._eventBus.fire('propertiesPanel.showEntry', {
44
- id: entryIds[ Math.max(0, entryIds.length - 1) ]
45
- });
46
- });
47
- }
48
-
49
- setErrors(reports) {
50
- this._reports = reports;
51
-
52
- this._update();
53
- }
54
-
55
- activate() {
56
- this._active = true;
57
-
58
- this._update();
59
- }
60
-
61
- deactivate() {
62
- this._active = false;
63
-
64
- this._update();
65
- }
66
-
67
- isActive() {
68
- return this._active;
69
- }
70
-
71
- _update() {
72
-
73
- // set annotations
74
- this._lintingAnnotations.setErrors(this.isActive() ? this._reports : []);
75
-
76
- // set properties panel errors
77
- const selectedElement = this._getSelectedElement();
78
-
79
- this._eventBus.fire('propertiesPanel.setErrors', {
80
- errors: getErrors(this._reports, selectedElement)
81
- });
82
- }
83
-
84
- _getSelectableElement(id) {
85
- let element = this._elementRegistry.get(id);
86
-
87
- if (!element) {
88
- element = this._elementRegistry.filter(element => {
89
- return is(element, 'bpmn:Participant') && getBusinessObject(element).get('processRef').get('id') === id;
90
- })[ 0 ];
91
- }
92
-
93
- return element;
94
- }
95
-
96
- _getSelectedElement() {
97
- const selection = this._selection.get();
98
-
99
- if (!selection || !selection.length) {
100
- return this._canvas.getRootElement();
101
- }
102
-
103
- const selectedElement = selection[ 0 ];
104
-
105
- if (isLabel(selectedElement)) {
106
- return selectedElement.labelTarget;
107
- }
108
-
109
- return selectedElement;
110
- }
111
- }
112
-
113
- Linting.$inject = [
114
- 'canvas',
115
- 'config.linting',
116
- 'elementRegistry',
117
- 'eventBus',
118
- 'lintingAnnotations',
119
- 'selection'
120
- ];
121
-
122
- function isLabel(element) {
123
- return !!element.labelTarget;
124
- }
1
+ import { getBusinessObject, is } from 'bpmn-js/lib/util/ModelUtil';
2
+
3
+ import { getErrors } from '../utils/properties-panel';
4
+
5
+ export default class Linting {
6
+ constructor(canvas, config, elementRegistry, eventBus, lintingAnnotations, selection) {
7
+ this._canvas = canvas;
8
+ this._elementRegistry = elementRegistry;
9
+ this._eventBus = eventBus;
10
+ this._lintingAnnotations = lintingAnnotations;
11
+ this._selection = selection;
12
+
13
+ this._active = config && config.active || false;
14
+ this._reports = [];
15
+
16
+ eventBus.on('selection.changed', () => this._update());
17
+
18
+ eventBus.on('lintingAnnotations.click', ({ report }) => this.showError(report));
19
+ }
20
+
21
+ showError(report) {
22
+ const {
23
+ id,
24
+ propertiesPanel = {}
25
+ } = report;
26
+
27
+ const selectableElement = this._getSelectableElement(id);
28
+
29
+ if (selectableElement) {
30
+ this._canvas.scrollToElement(selectableElement);
31
+
32
+ if (selectableElement === this._canvas.getRootElement()) {
33
+ this._selection.select();
34
+ } else {
35
+ this._selection.select(selectableElement);
36
+ }
37
+ }
38
+
39
+ const { entryIds = [] } = propertiesPanel;
40
+
41
+ // TODO(philippfromme): remove timeout once properties panel is fixed
42
+ setTimeout(() => {
43
+ this._eventBus.fire('propertiesPanel.showEntry', {
44
+ id: entryIds[ Math.max(0, entryIds.length - 1) ]
45
+ });
46
+ });
47
+ }
48
+
49
+ setErrors(reports) {
50
+ this._reports = reports;
51
+
52
+ this._update();
53
+ }
54
+
55
+ activate() {
56
+ this._active = true;
57
+
58
+ this._update();
59
+ }
60
+
61
+ deactivate() {
62
+ this._active = false;
63
+
64
+ this._update();
65
+ }
66
+
67
+ isActive() {
68
+ return this._active;
69
+ }
70
+
71
+ _update() {
72
+
73
+ // set annotations
74
+ this._lintingAnnotations.setErrors(this.isActive() ? this._reports : []);
75
+
76
+ // set properties panel errors
77
+ const selectedElement = this._getSelectedElement();
78
+
79
+ this._eventBus.fire('propertiesPanel.setErrors', {
80
+ errors: getErrors(this._reports, selectedElement)
81
+ });
82
+ }
83
+
84
+ _getSelectableElement(id) {
85
+ let element = this._elementRegistry.get(id);
86
+
87
+ if (!element) {
88
+ element = this._elementRegistry.filter(element => {
89
+ return is(element, 'bpmn:Participant') && getBusinessObject(element).get('processRef').get('id') === id;
90
+ })[ 0 ];
91
+ }
92
+
93
+ return element;
94
+ }
95
+
96
+ _getSelectedElement() {
97
+ const selection = this._selection.get();
98
+
99
+ if (!selection || !selection.length) {
100
+ return this._canvas.getRootElement();
101
+ }
102
+
103
+ const selectedElement = selection[ 0 ];
104
+
105
+ if (isLabel(selectedElement)) {
106
+ return selectedElement.labelTarget;
107
+ }
108
+
109
+ return selectedElement;
110
+ }
111
+ }
112
+
113
+ Linting.$inject = [
114
+ 'canvas',
115
+ 'config.linting',
116
+ 'elementRegistry',
117
+ 'eventBus',
118
+ 'lintingAnnotations',
119
+ 'selection'
120
+ ];
121
+
122
+ function isLabel(element) {
123
+ return !!element.labelTarget;
124
+ }