feat: highlight and animate feature(s) by ID

[RobertOrthofer]

This PR implements animations for programmatic feature selection for both VectorLayer and VectorTileLayer without causing a version jump of the map element.

The internally used panIntoFeature function has been lifted to the level of the interaction, exposing it the same way as the highlightById function as a method of the interaction itself.

The existing highlightById-method now has an optional second parameter, fitOptions, allowing animations to highlighted Features of VectorLayer and RenderFeatures of a VectorTileLayer. Be aware that when programmatically selecting a feature, the source has to be loaded, and, in the case of the VectorTileLayer, the feature has to be available in currently rendered tiles. The fitOptions also include convenient properties like padding or maxZoom.

This is designed as convenience-functionality for the select-Interaction, as an improvement of the existing highlightById method. Arguments could be made for the panIn-flag to be replaced completely by fitOptions, in order to have more control over animations (this is currently static with duration: 750 and no padding), but this would mean a version jump.

#570
#1097

Screenshots/Videos

Checklist before requesting a review

• I have performed a self-review of my code
• I have added a test related to this feature/fix
• For new features: I have created a story showcasing this new feature
• All checks have passed
• The PR title follows conventional commit style and reflects the type of change (major/minor/patch, breaking)
• The PR title describes the change within this element (each merged PR equals one entry in the element's changelog!)

[netlify]

✅ Deploy Preview for eoxelements ready!

Name	Link
🔨 Latest commit	66ed0c8
🔍 Latest deploy log	https://app.netlify.com/sites/eoxelements/deploys/66b0cd11e88246000876be42
😎 Deploy Preview	https://deploy-preview-1176--eoxelements.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[silvester-pari]

Great addition, thanks! Fine for me to add this now, and add an issue that deprecates the panIn property for v2.x

Could we just add a story for this functionality? I'll see if I find time for this today, otherwise any other volunteers welcome 😃

[silvester-pari]

I added a story showcasing this:

Screencast.from.2024-08-05.15.01.52.webm

[santilland]

For me also looks good, not using it right now in any application, so probably good to see if @StefanBrand has feedback?

[RobertOrthofer]

thanks @silvester-pari, this story is indeed a very good showcase of this feature

[RobertOrthofer]

About the panIn-option, maybe we don't need to get rid of it entirely, as it is a good way to pan in to something without using JS (only via the config), but we could use fitOptions instead of a boolean flag