Prepare Changlelog for 1.8.0

[Falke-Design]

Breaking Changes

• Refactor TapHold handler to simulate contextmenu event on mobile Safari (#7026 by @johnd0e)
• Refactor DivOverlay/Popup/Tooltip (#7540 by @johnd0e)
  • Move Popup related options from DivOverlay to Popup (#7778 by @Falke-Design)
  • Change Tooltip class from leaflet-clickable to leaflet-interactive (#7719 by @Falke-Design)
  • Map.closeTooltip now requires a layer as argument (#7533 by @johnd0e)
• Improve error / argument handling for event listeners (#7518 by @johnd0e)
• Refactor DomEvent.Pointer which simulates touchevents on non-touch devices (#7059, #7084, #7415 by @johnd0e)
• Refactor DomEvent.DoubleTap which simulates dblclick event in not supported Browsers (#7027 by @johnd0e)
• Refactor disableClickPropagation (#7439 by @johnd0e)
• Map.hasLayer() and LayerGroup.hasLayer() now requires a layer as argument (#6999 by @johnd0e)
• Class.include keep options (#7756 by @johnd0e)
• Avoid modifying source props object in Class.extend (#6766 by @johnd0e)
• Correct Browser.touch (#7029 by @johnd0e)
• Get rid of android legacy hacks (#7022 by @johnd0e)

API changes

• Make DivOverlay / Tooltip interactive (#7531, #7532 by @johnd0e)
• Add openOn, close, toggle functions to DivOverlay (#6639 by @johnd0e)
• DomEvent.off(el) removes all listeners (#7125 by @johnd0e)
• Allow to prevent round-off errors by passing false to Util.formatNum / toGeoJSON (#7100 by @johnd0e)
• Add autoPanOnFocus to Marker (#8042 by @IvanSanchez)
• Add referrerPolicy to TileLayer (#7945 by @natevw)
• Add playsInline to VideoOverlay (#7928 by @Falke-Design)
• Add getCenter to ImageOverlay (#7848 by @Falke-Design)
• Fire a tileabort event when a TileLayer load is cancelled (#6786 by @dstndstn)
• Add crossOrigin to Icon (#7298 by @syedmuhammadabid)

Improvements

• Avoid excessive _update() call in GridLayer.onAdd (#7570 by @johnd0e)
• Update panInside calculation (#7469 by @daverayment)
• TileLayer allow template keys with spaces in URL (#7216 by @lubojr)
• Tooltips can now bound to ImageOverlays because it can rely on parent layer getBounds() (#7306 by @IvanSanchez)
• Remove gap between Popup tip and content dialog (#7920 by @Malvoz)
• Fire mousemove through Canvas to map if it has no layers (#7809 by @johnd0e)
• Replace div with span in Control.Layers container to fix an HTML validation error (#7914 by @tmiaa)
• Improve memory footprint by removing will-change CSS property on tile images (#7872 by @janjaap)
• Better icon image path detection (#7092 by @johnd0e)
• Makes Browser mutable (#7335 by @bozdoz)
• Add print styles to prevent printers from removing background-images in controls (#7851 by @Malvoz)
• Move attribution code from Layer to Control.Attribution (#7764 by @johnd0e)
• Minifiy marker icon svg (#7600 by @rala72)
• Refactor vmlCreate() so that it does not expose closure to TypeError (#7279 by @darcyparker)
• Control.Layers stop relying on Browser android and touch properties (#7057 by @johnd0e)
• Tooltip remove Browser touch checks (#7535 by @johnd0e)
• Converte Plugins.md to single files (#7805 by @Falke-Design)
• Remove all references of Bower (#7831 by @jonkoops)

Accessibility

• Add accessibility section to plugins guide (#7277 by @Malvoz)
• Auto pan to markers on focus by default for improved keyboard operability (#8042 by @IvanSanchez)
• Update Marker to default to role="button" & alt="marker" for an improved screen reader experience (#7895 by @tmiaa)
• Set role="button" for appropriate semantics on the <a> layers control (#7850 by @Malvoz)
• Generally enable outlines for keyboard users by not stripping outline on focus for keyboard events (#7259 by @jafin)
• Enable outlines on leaflet-container for keyboard users (#7996 by @Malvoz)
• Multiple enhancements to popup's close button (#7794 by @Falke-Design)
• Use relative font-size units for resizable text (#7800 by @Chandu-4444)
• Apply :hover styles to :focus as well (#7274 by @Malvoz)
• Hide the decorative attribution separator from screen readers (#7969 by @Malvoz)
• Make the disabled state of zoom controls available to screen readers (#7280 by @akshataj96)
• Hide the +/- characters in zoom controls from screen readers to prevent erroneous announcements (#7795 by @Falke-Design)

Docs

• Upgrade Code of Conduct to Contributor Covenant v2 and improve its visibility (#7984 by @mourner)
• Lint examples (#7827 by @mourner)
• Update usability in Docs (#7982, #7703, #7950, #7906, #7907, #7696, #7816, #7345, #7815, #7948, #7901 by @Falke-Design, @avioli, @Malvoz, @fulldecent, @saerdnaer, @MxDui)
• Typos / Fixes in Docs, Samples, ... (#7263, #7284, #7339, #7349, #7381, #7371, #7485, #7380, #7578, #7758, #7602, #7857, #7860, #7336, #7819 by @timgates42, @IvanSanchez, @ipovos, @elfalem, @BakuCity, @simon04, @user073, @Dev-Steven, @vanillajonathan, @aquelle-cp, @matkoniecz, @Falke-Design)

Update API Docu:

• Clarify zoomend event (#7460 by @xeruf)
• Add false to prefix of Control.Attribution (#7814 by @Falke-Design)
• LayerGroup inherit from Interactive Layer (#7763 by @johnd0e)
• Improve Map.panInside documentation (#7397 by @daverayment)
• Update Renderer documentation to clarify tolerance option is for Canvas only (#7515 by @Hippl-Eric)
• Add documentation for Event-Listener propagate argument (#7103 by @riffaud)

Bug fixes

• Fix Marker position while zooming (#7967 by @Falke-Design)
• Fix noConflict (#7855 by @Falke-Design)
• Fix opening / closing Tooltip while dragging map (#7862 by @Falke-Design)
• Break the reference to the options of the Class prototype (#7459 by @Falke-Design)
• Make Tooltip option permanent & sticky working together (#7563 by @Falke-Design)
• Check if map container is still connected with Leaflet in Locate event listener (#7813 by @Falke-Design)
• Tooltip.bindTooltip should unbind existent tooltip (#7633 by @Falke-Design)
• Correct if condition, to add zoom limits for Layer (#7609 by @vcoppe)
• GridLayer redraw tiles after changing maxNativeZoom (#6443 by @cherniavskii)
• Fix Popup keepInView if the map needs to panned over a long distance (#7792 by @Falke-Design)
• Tolerate wrong event names in add/removePointerListener (#7808 by @johnd0e)
• Reset width & padding to prevent cascading CSS from breaking tile rendering (#6843 by @Spudley)
• Fix mousedown event calling after dragging Canvas map (#7781 by @johnd0e)
• Decrease console.warn pollution (#7748 by @johnd0e)
• Fix contextmenu event default-preventing when there are >1 target candidates (#7544 by @johnd0e)
• Prevent click on Popup-tip from firing on map. (#7541 by @johnd0e)
• Fix error by calling Path.setStyle before adding the layer to the map (#6941 by @NielsHolt)
• Reset BoxZoom after cancel with ESC (#7597 by @Falke-Design)

Plugins

• Add / Update Plugins (#7986, #7956, #7942, #7888, #7896, #7885, #7875, #7874, #7833, #7834, #7832, #7812, #7786, #7802, #6534, #6547, #7367, #7392, #7412, #7631, #7437, #7408, #6500, #7957, #7484, #7236, #7053, #7050, #7312, #7623, #7534, #7626, #7553, #7423, #7619, #7065, #7663, #7690, #7180, #7714, #7665, #7179, #6641, #7647, #7635, #7473, #7471, #7363, #7323, #7295, #7292, #7291, #7257, #7276, #7470, #7700, #7617)

Workflow

• Add Bundlemon to watch bundle size (#7934, #7983, #7905 by @jonkoops)
• Add npm run serve to serve docs on localhost (#7973 by @Falke-Design)
• Rename master branch to main (#7921 by @jonkoops)
• Upload files to AWS even if the file-size is the same (#7853 by @jonkoops)
• Remove leaflet-include.js from debug samples (#7776 by @Falke-Design)
• Lint adjustments (#7676, #7743, #7757 by @jonkoops, @mourner)
• Simplify release process (#7711, #7854, #7727, #8039 by @mourner)
• Simplify docs update process on release (#7730 by @mourner)
• Update dependencies and add Dependabot config (#7455, #7653, #7677, #7725 by @jonkoops)
• Split main workflow into multiple parallel jobs (#7710 by @jonkoops)
• Run CI on Github actions (#7691, #7654, #7702 by @jonkoops)
• Continue running tests even if one fails (#7723 by @jonkoops)
• Add blocker Critical issue or PR that must be resolved before the next release check to release process (#8019 by @Malvoz)

Tests

• simplify .near and .nearLatLng usage (#7820 by @johnd0e)
• Run tests on Internet Explorer 11 (#7741 by @jonkoops)
• Run tests on FirefoxNoTouch (#7736, #7742 by @johnd0e)
• Drop PhantomJS from test suite (#7660, #7724 by @jonkoops)
• Enforce forbid-only rule in the continuous integration (#7448 by @johnd0e)
• Increase captureTimeout and browserSocketTimeout (#7856 by @Falke-Design)
• Added / update tests (#7790, #7147, #7721, #7461, #7126, #7451, #7450, #7447, #7438 by @Falke-Design, @johnd0e, @phloose)
• Added missing Test-Spec-Files to index.html (#7845 by @Falke-Design)

[Falke-Design]

@mourner @Malvoz @IvanSanchez @jonkoops this are all commits since 1.7.1 I sorted them by category but now they need a deeper check and a better describtion, help is welcome. I suggest to simply edit the main post and add ✔️ to the commit.
Many commits are follow ups from one Feature / Bug or to revert some changes. So we need to check which commits are releated to the same topic and merge them together.

The biggest changes in this release are:

• Refactor [touch/pointer] events
• Refactor DivOverlay/Popup/Tooltip
• Accessibility

Also I would like to add a thank you for @johnd0e to the Release notes. He refactored the touch events and DivOverlay without much help. Maybe I'm wrong but in my eyes kept @johnd0e Leaflet alive until we get a fresh wind in November.

[jonkoops]

Thanks @Falke-Design, much appreciated. I don't think I will have much time in the coming weeks, but I will try to see if I can walk through some of them. Unfortunately with the invasion of Ukraine I think @mourner has other priorities at the moment, so we'll have to get this done with the rest of the team.

[Falke-Design]

Yes I think too, but I still wanted to inform him even though he wont see it.

I already made the first points and it wasn't that much work for me. So if you don't have time, let me do it, is no problem ;)

[Falke-Design]

@jonkoops @Malvoz @IvanSanchez can you please make a quick check over the Changelog. From my side it is ready for the Release.
And can please someone of you prepare a Blog post? I'm sure you already noticed that my english is not always the best 😉
It would be good to inlcude in the blog post following:

• Refactor [touch/pointer] events
• Refactor DivOverlay/Popup/Tooltip
• Accessibility

Please response if you can do the blog post or not.

[Malvoz]

Thanks for doing all this work @Falke-Design! I'm a bit busy atm but a couple of notes:

• Accessibility changes

#7851 probably does not belong to that list, since it's just a small UX improvement for printed maps.

Add fallbacks to font-size (#7800 by @Chandu-4444)

I think the title of this item can be renamed "Use relative font-size units for resizable text".

Edit: Fixed!

[mourner]

Thanks so much for taking on this huge task @Falke-Design! I haven't read this through carefully, but several improvement tips I usually use when writing changelogs:

• Sort everything from most important to least important. For categories, it should roughly be 1) Breaking changes, 2) Features & Improvements, 3) Bugfixes, 4) Everything else. Within each category, also sort from most impactful to least.
• Where possible, reword changes to reflect impact on the user rather than underlying change. E.g. not "Remove will-change", but rather "Improve memory footprint by removing will-change CSS property on tile images".
• Edit for consistency — e.g. same form ( ...), capitalized, etc.
• Omit trivial changes (e.g. typo fixes) where appropriate.

[mourner]

Once the changelog is ready, I think we can simply tag a new version and do a release. Given the huge number of changes, we could first do a v1.8.0-beta.1, ask people to test it out, and then do a final a week later.

[mourner]

@Falke-Design let me know when you think the changelog is ready for publishing.

[mourner]

@IvanSanchez maybe you can have a quick editing run on it when you have a chance. We can create a "draft" release in the GitHub Releases section to quickly edit the changelog for convenience.

[Falke-Design]

I will finish it in the next days. My biggest problem will be reword changes to reflect impact on the user. I will reword them to show the impact on the user but I think someone has to go over it, to make the sentences grammitcal correct 😄

[Malvoz]

I've resolved #8021 (comment), and #8021 (comment):

E.g. not "Remove will-change", but rather "Improve memory footprint by removing will-change CSS property on tile images"

(only that item specifically)

and also turned the generic "Accessibility changes" list item with 10 or so items to individual list items with descriptions.

[Falke-Design]

Very nice! I want to change some small things in the next 2 hours and then we are ready 👍

[Falke-Design]

@mourner ready! 🎉
Should we remove the Plugins section?

[Malvoz]

@Falke-Design I've made many small changes, to reword a few descriptions and to roughly "Sort everything from most important to least important" per #8021 (comment), almost all of my edits are to the Accessibility section.

Also added some of the latest PRs that have been merged.

Should we remove the Plugins section?

I think so. It looks like there are only about 10 "plugin" entries in CHANGELOG.md and they're regarding breaking changes that affect plugins and otherwise compatibility, not regular additions/updates.

[mourner]

Fantastic work everyone! Making an edit pass now, please stand by.

[mourner]

You can find the edited v1.8.0 changelog here — let's follow up with any edits in GitHub Releases section from now on: https://github.com/Leaflet/Leaflet/releases/tag/v1.8.0-beta.0