[FEAT] Let remove all overlays of several BPMN elements at once

[tbouffard]

Is your feature request related to a problem? Please describe.
Currently, in version 0.32.0, we can remove all overlays of one single element.

When an application needs to remove overlays of several BPMN elements, it must loop over a list of ids.
So, the application integrating bpmn-visualization must keep track of this ids where it previously added overlays.
As in #2576, this is particularly overwhelming when the application needs to clean the whole overlays to restore the default rendering, or propose a complete different visualization. For instance, to switch from a monitoring view to a conformance view.

We already see the loop cleanup in several repositories of the Process Analytics project:

• examples repository
  • https://github.com/process-analytics/bpmn-visualization-examples/blob/c6272d729b1fe6e29a4d3290039c743b6d4b32cb/demo/monitoring-all-process-instances/js/monitoring-use-case.js#L33-L38
  • https://github.com/process-analytics/bpmn-visualization-examples/blob/c6272d729b1fe6e29a4d3290039c743b6d4b32cb/examples/overlays/add-remove/index.js#L43-L55
  • https://github.com/process-analytics/bpmn-visualization-examples/blob/c6272d729b1fe6e29a4d3290039c743b6d4b32cb/examples/overlays/add-stylized/index.js#L1-L8
• demos
  • https://github.com/process-analytics/icpm-demo-2022/blob/8c4e3b0fbe8af979f9a8938c024e55ae7306355a/src/conformance.js#L209-L233
  • https://github.com/process-analytics/bpmn-visualization-pm4py/blob/74a248d432c21bb4a1e6a8caeed77d0af5b07f74/frontend/src/conformance.js#L41-L42
  • https://github.com/process-analytics/bonita-day-demo-2023/blob/d445fbe951d75a6a547d42e73da6ac926657b7ec/src/case-monitoring.ts#L79-L81
• even in the bpmn-visualization demo

  • bpmn-visualization-js/dev/public/static/js/elements-identification.js

    Line 58 in 94cef15

    lastIdentifiedBpmnIds.forEach(id => removeAllOverlays(id));

  • bpmn-visualization-js/dev/public/static/js/elements-identification.js

    Line 79 in 94cef15

    lastIdentifiedBpmnIds.forEach(id => removeAllOverlays(id));

Describe the solution you'd like
Update the existing API to remove all overlays on a single element, several elements or all elements (full cleanup).

Switch from

removeAllOverlays(bpmnElementId: string): void 

to

removeAllOverlays(bpmnElementIds?: string | string[]): void 

Calling the method without argument will remove all overlays on all elements.
This signature matches the removeAllCssClasses signature (see #2576).

Additional context

Passing an empty array or an empty string should have no effect. See #2900