maplibre-gl-leaflet-with-canvas-dash-offset 0.1.4

package/.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: [maplibre]
+open_collective: maplibre

package/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: publish
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - v*
+
+jobs:
+  publish:
+    name: Publish
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Use Node.js 18 x64
+        uses: actions/setup-node@v2
+        with:
+          node-version: 18
+          architecture: x64
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Publish
+        run: |
+          npm publish --access=public --non-interactive
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_ORG_TOKEN }}

package/.github/workflows/test.yml

@@ -0,0 +1,27 @@
+name: test
+
+on:
+  workflow_dispatch:
+  push:
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Use Node.js 18 x64
+        uses: actions/setup-node@v2
+        with:
+          node-version: 18
+          architecture: x64
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install
+        run: |
+          npm ci
+
+      - name: Test
+        run: |
+          npm run test

package/.travis.yml

@@ -0,0 +1,6 @@
+language: node_js
+node_js:
+  - "0.8"
+  - "0.10"
+before_install:
+  - npm install -g npm@~1.4.6

package/API.md

@@ -0,0 +1,43 @@
+## `L.maplibreGL(options)`
+
+Create a new MapLibre GL layer in a Leaflet-compatible wrapper.
+
+<span class='leaflet icon'>_Extends_: `L.Class`</span>
+
+`options` is an object of options. All options given are passed to a MapLibre GL `Map` object,
+so consult [the MapLibre GL .Map documentation](https://maplibre.org/maplibre-gl-js/docs/API/classes/Map/)
+for the full range.
+
+| Option | Value | Description |
+| ---- | ---- | ---- |
+| padding | number | [0.15] | Relative padding of the maplibre-gl layer to avoid the background flickering around the edges of the map |
+| interactive | boolean | [false] | Wheter or not to register the mouse and keyboard events on the maplibre-gl layer. Turn this on if you intend to use the maplibre-gl layer events. |
+
+### `layer.addTo(map)`
+
+Same behavior as `.addTo` on any Leaflet layer: this adds the layer to a given
+map or group.
+
+### `layer.getMaplibreMap(): maplibre.Map`
+
+Returns `maplibre-gl.Map` object.
+
+### `layer.getContainer(): HTMLDivElement`
+
+Returns layer's DOM container `div`.
+
+### `layer.getCanvas(): HTMLCanvasElement`
+
+Returns `maplibre-gl.Map` canvas.
+
+### `layer.getSize(): L.Point`
+
+Returns layer size in pixels including padding.
+
+### `layer.getBounds(): L.LatLngBounds`
+
+Returns layer bounds including padding.
+
+### `layer.getPaneName(): string`
+
+Returns the pane name set in options if it is a valid pane, defaults to tilePane.

package/CHANGELOG.md

@@ -0,0 +1,145 @@
+# Change Log
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/)
+and this project adheres to [Semantic Versioning](http://semver.org/).
+
+## Unreleased
+
+### Added
+
+- Add attribution handling to the Leaflet layer based on the `attributionControl` option and the source's `attribution` property
+
+## 0.1.0
+
+### Fixed - 2025-03-24
+
+- Fix [#64](https://github.com/maplibre/maplibre-gl-leaflet/issues/64) to allow this library to work with MapLibre GL JS v5.0.0. ([#66](https://github.com/maplibre/maplibre-gl-leaflet/pull/66))
+
+## 0.0.22 - 2024-07-08
+
+### Fixed
+
+- Fix [#29](https://github.com/maplibre/maplibre-gl-leaflet/issues/58) - added missing guard for empty object
+
+## 0.0.20 - 2023-09-19
+
+### Added
+
+- Add `mapbox-gl-js v3.x.x` to allowed versions in peerDependencies.
+
+### Fixed
+
+- Fix [#29](https://github.com/maplibre/maplibre-gl-leaflet/issues/29) - layer is mis-aligned with map when panning the map off screen ([#31](https://github.com/maplibre/maplibre-gl-leaflet/pulls/31))
+
+## 0.0.19 - 2022-11-30
+
+### Fixed
+
+- round CSS translate values to avoid blurry tiles ([#41](https://github.com/maplibre/maplibre-gl-leaflet/issues/41)).
+
+## 0.0.18 - 2022-11-11
+
+### Fixed
+
+- import MapOptions instead of obsolete MapboxOptions for compatibility with neuer maplibre-gl versions ([#25](https://github.com/maplibre/maplibre-gl-leaflet/issues/25)).
+
+## 0.0.15 - 2021-07-08
+
+### Added
+- types definition
+
+## 0.0.14 - 2020-11-24
+
+### Fixed
+
+- fix gl offset issue in low zoom level
+
+## 0.0.13 - 2020-08-31
+
+### Added
+-  `.getPaneName()` method
+
+### Fixed
+- Allow gl tiles to be added to a custom pane defined in options
+
+## 0.0.12 - 2020-03-27
+
+### Fixed
+
+- `accessToken` is now optional
+
+## 0.0.11 - 2019-11-04
+
+### Fixed
+
+- ensure gl map is added to leaflet TilePane
+
+## 0.0.10 - 2019-09-16
+
+## Added
+
+- `.getContainer()`, `.getSize()`, `getBounds()` and `getCanvas()` methods.
+
+## Fixed
+
+- internal code changes to bring it closer to other overlay layers.
+
+## 0.0.9 - 2019-09-02
+
+## Added
+
+- Added `interactive` option to make `mapbox-gl` map events handling possible.
+- added public accessor to `mapbox-gl` map object
+
+## 0.0.8 - 2019-08-07
+
+## Added
+
+- Added a `padding` option to fix the grey backgrougd flickering around the edges of the map while panning/zooming
+- bumped the libraries in examples
+
+## 0.0.7 - 2019-07-01
+
+### Fixed
+
+- Ensure no blank/gray area is displayed when zooming out.
+
+## 0.0.6 - 2019-05-07
+
+### Fixed
+
+- `.git` directory removed from npm tarball.
+
+## 0.0.5 - 2019-05-01
+
+### Added
+
+- `leaflet` and `mapbox-gl-js` are now declared as peerDependencies.
+
+## 0.0.4 - 2019-02-27
+
+### Added
+
+- UMD wrapper
+- support for `pane` in constructor
+
+### Fixed
+
+- webkitTransitionEnd event crash
+
+## 0.0.3 - 2017-04-18
+
+### Added
+
+- Improved support for older versions of `mapbox-gl-js`
+
+## 0.0.2 - 2017-03-08
+
+### Added
+
+- Introduced support for Leaflet `v1.0.x`
+
+## 0.7. - 2016-10-09
+
+- Compatibility release for Leaflet `v0.7.x`

package/CONTRIBUTING.md

@@ -0,0 +1,8 @@
+## Release instructions
+
+1. bump version number in package.json manually
+1. Create new CHANGELOG.md entry and update links at bottom of file
+1. commit changes to `master`
+1. `gh-release`
+
+This hydrates the release notes from the CHANGELOG.

package/LICENSE

@@ -0,0 +1,15 @@
+Copyright (c) 2021 MapLibre contributors
+
+Copyright (c) 2014, Mapbox
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,99 @@
+## MapLibre GL Leaflet
+
+This is a binding from [MapLibre GL JS](https://maplibre.org) to the familiar
+[Leaflet](http://leafletjs.com/) API. It was originally developed for Mapbox (<https://github.com/mapbox/mapbox-gl-leaflet>) and was migrated to MapLibre after Mapbox changed its license.
+
+## Code example
+
+```javascript
+var map = L.map("map", {
+    maxBounds: [[180, -Infinity], [-180, Infinity]], // restrict bounds to avoid max latitude issues with MapLibre GL
+    maxBoundsViscosity: 1, // make the max bounds "solid" so users cannot pan past them
+    minZoom: 1 // prevent sync issues at zoom 0
+  }).setView([38.912753, -77.032194], 15);
+
+L.marker([38.912753, -77.032194])
+  .bindPopup("Hello <b>Leaflet GL</b>!<br>Whoa, it works!")
+  .addTo(map)
+  .openPopup();
+
+var gl = L.maplibreGL({
+  style: "mapbox://styles/mapbox/bright-v8",
+}).addTo(map);
+```
+
+Note that you can use any vector tile source useable by maplibre-gl. For instance, you can use [OSM2VectorTiles](http://osm2vectortiles.org/) with:
+
+```javascript
+var gl = L.maplibreGL({
+  style:
+    "https://api.maptiler.com/maps/topo/style.json?key=<YOUR_MAPTILER_API_KEY>",
+}).addTo(map);
+```
+
+Once you have created the leaflet layer, the maplibre-gl map object can be accessed using
+
+```javascript
+gl.getMaplibreMap()....
+// add a source to the maplibre-gl layer
+gl.getMaplibreMap().addSource({...})
+```
+
+## Live examples
+
+[Basic example](https://raw.githack.com/maplibre/maplibre-gl-leaflet/main/examples/basic.html)
+
+[Cluster example](https://raw.githack.com/maplibre/maplibre-gl-leaflet/main/examples/cluster.html)
+
+[Map events example](https://raw.githack.com/maplibre/maplibre-gl-leaflet/main/examples/events.html)
+
+Code for these examples is hosted in the [examples folder](https://github.com/maplibre/maplibre-gl-leaflet/tree/main/examples)
+
+## Installation
+
+Add a script tag referencing maplibre-gl-leaflet after adding leaflet and maplibre-gl-js in your website:
+
+```html
+<!-- Leaflet -->
+<link
+  rel="stylesheet"
+  href="https://unpkg.com/leaflet@1.8.0/dist/leaflet.css"
+/>
+<script src="https://unpkg.com/leaflet@1.8.0/dist/leaflet.js"></script>
+
+<!-- Maplibre GL -->
+<link
+  href="https://unpkg.com/maplibre-gl@2.2.1/dist/maplibre-gl.css"
+  rel="stylesheet"
+/>
+<script src="https://unpkg.com/maplibre-gl@2.2.1/dist/maplibre-gl.js"></script>
+
+<script src="https://unpkg.com/@maplibre/maplibre-gl-leaflet@0.0.20/leaflet-maplibre-gl.js"></script>
+```
+
+## Motivation
+
+This project makes it possible to easily add a maplibre-gl-js layer in your Leaflet map. When using maplibre-gl-leaflet, you won't be able to use some of the maplibre-gl-js features.
+Here are the main differences between a "pure" maplibre-gl-js map and a Leaflet map using maplibre-gl-leaflet:
+
+- No rotation / bearing / pitch support
+- Slower performances: When using maplibre-gl-leaflet, maplibre-gl-js is set as not interactive. Leaflet receives the touch/mouse events and updates the maplibre-gl-js map behind the scenes. Because maplibre-gl-js doesn't redraw as fast as Leaflet, the map can seem slower.
+- MapLibre restricts the maximum latitude of the map in a stricter way then Leaflet. In order to maximize compatibility it it is recommended to set a `maxBounds: [[180, -Infinity], [-180, Infinity]]` and `maxBoundsViscosity: 1` on your Leaflet `Map` to prevent users from panning past the minimum and maximum latitude supported by MapLibre.
+- Setting `minZoom: 1` is also recommended to reduce some issues with the map syncing at zoom level 0.
+
+On the bright side, the maplibre-gl-leaflet binding will allow you to use all the leaflet features and plugins.
+
+If you only need the maplibre-gl-js features ([adding a map with a mapbox-style, adding a GeoJSON, etc.](https://maplibre.org/maplibre-gl-js/docs/examples/)), you are probably better off using it directly.
+
+## API Reference
+
+[API Reference](API.md)
+
+## Bug Reports & Feature Requests
+
+Please use the [issue tracker](https://github.com/maplibre/maplibre-gl-leaflet/issues) to report any bugs or file feature requests.
+You can fork this [jsfiddle template](https://jsfiddle.net/fnicollet/9w9er53v/) to reproduce a bug, then share the URL of your fork in the GitHub issue.
+
+## License
+
+ISC © [MapLibre](https://github.com/maplibre) © [Mapbox](https://github.com/mapbox)

package/debug/README.md

@@ -0,0 +1,5 @@
+# Debugging Examples
+
+These files reproduce difficult to test issues and are used for debugging specific issues.
+
+* [`max-latitude-bug-reproduction.html`](./max-latitude-bug-reproduction.html) reproduces [#29](https://github.com/maplibre/maplibre-gl-leaflet/issues/29);