Bumps [qs](https://github.com/ljharb/qs) from 6.16.0 to 6.17.0. <details> <summary>Changelog</summary> <p><em>Sourced from <a href="https://github.com/ljharb/qs/blob/main/CHANGELOG.md">qs's changelog</a>.</em></p> <blockquote> <h2><strong>6.17.0</strong></h2> <ul> <li>[New] <code>stringify</code>: add <code>WHATWG</code> format (<a href="https://redirect.github.com/ljharb/qs/issues/623">#623</a>)</li> <li>[Fix] <code>stringify</code>: do not sort the caller's <code>filter</code> array in place (<a href="https://redirect.github.com/ljharb/qs/issues/637">#637</a>)</li> <li>[Fix] <code>parse</code>: copy an own <code>__proto__</code> key as data (<a href="https://redirect.github.com/ljharb/qs/issues/636">#636</a>)</li> <li>[Fix] <code>parse</code>: decode percent-encoded dots case-insensitively (<a href="https://redirect.github.com/ljharb/qs/issues/635">#635</a>)</li> <li>[Fix] <code>stringify</code>: encode keys when <code>allowEmptyArrays</code> is set (<a href="https://redirect.github.com/ljharb/qs/issues/561">#561</a>)</li> <li>[Fix] <code>parse</code>: preserve comma arrays when interpreting numeric entities (<a href="https://redirect.github.com/ljharb/qs/issues/630">#630</a>)</li> <li>[Fix] <code>parse</code>: allow scalar fields with a zero array limit (<a href="https://redirect.github.com/ljharb/qs/issues/627">#627</a>)</li> <li>[Fix] <code>parse</code>: do not count an existing comma array toward <code>arrayLimit</code> when <code>duplicates</code> discards or replaces it</li> <li>[Fix] <code>utils</code>: <code>encode</code>: encode lone surrogates as U+FFFD instead of consuming the next code unit (<a href="https://redirect.github.com/ljharb/qs/issues/624">#624</a>)</li> <li>[eslint] fix indentation</li> <li>[readme] document the encoder's <code>format</code> argument</li> <li>[meta] add changelog acknowledgement</li> <li>[meta] fix changelog indents</li> <li>[Dev Deps] update <code>eslint</code>, <code>evalmd</code>, <code>npmignore</code></li> <li>[Tests] <code>stringify</code>: pin <code>allowEmptyArrays</code> output for keys that need no encoding</li> <li>[Tests] <code>stringify</code>: pin <code>sort</code> order for nested keys selected by an array <code>filter</code></li> <li>[Tests] <code>parse</code>: cover <code>interpretNumericEntities</code> across value shapes, keys, and the charset sentinel</li> <li>[Tests] <code>parse</code>: cover more input that builds no array at a zero or negative <code>arrayLimit</code></li> <li>[Tests] <code>parse</code>: cover <code>comma</code> with a zero or negative <code>arrayLimit</code>, and combining a full comma array</li> <li>[Tests] <code>parse</code>: pin the behavior of a zero or negative <code>arrayLimit</code></li> <li>[Tests] <code>utils</code>/<code>stringify</code>: pin <code>~</code>, <code>*</code>, and parens encoding in RFC3986 and RFC1738</li> </ul> <h2><strong>6.16.2</strong></h2> <ul> <li>[Fix] <code>stringify</code>: encode keys when <code>allowEmptyArrays</code> is set (<a href="https://redirect.github.com/ljharb/qs/issues/561">#561</a>)</li> <li>[meta] use double quotes for better OS support</li> <li>[Dev Deps] update <code>evalmd</code>, <code>npmignore</code></li> <li>[Tests] <code>stringify</code>: pin <code>allowEmptyArrays</code> output for keys that need no encoding</li> </ul> <h2><strong>6.16.1</strong></h2> <ul> <li>[Fix] <code>parse</code>: do not mutate an object input</li> <li>[Fix] <code>stringify</code>: stop re-encoding structural separator dots when <code>encodeDotInKeys</code> is set (<a href="https://redirect.github.com/ljharb/qs/issues/564">#564</a>)</li> <li>[Fix] <code>stringify</code>: <code>arrayFormat: 'comma'</code>: pass the full encoder arguments with <code>encodeValuesOnly</code></li> <li>[Fix] <code>utils</code>: encode <code>+</code> as <code>%2B</code> in iso-8859-1 mode so values round-trip (<a href="https://redirect.github.com/ljharb/qs/issues/565">#565</a>)</li> <li>[Fix] parse: only convert top-level dots to brackets when allowDots is on (<a href="https://redirect.github.com/ljharb/qs/issues/621">#621</a>)</li> <li>[Fix] <code>stringify</code>: ignore inherited array format names (<a href="https://redirect.github.com/ljharb/qs/issues/622">#622</a>)</li> <li>[Fix] <code>stringify</code>: <code>arrayFormat: 'comma'</code>: do not throw on elements with no callable <code>toString</code></li> <li>[Fix] <code>utils</code>: <code>merge</code>: seed an overflow container's index from its own keys, not just the source</li> <li>[Fix] <code>utils</code>: <code>merge</code>: keep a <code>strictMerge</code> conflict container's index and <code>arrayLimit</code> correct</li> <li>[Fix] <code>parse</code>: only treat <code>[]</code> as array syntax when it ends the key</li> <li>[Perf] <code>decode</code>: skip decoders when there is no percent sign (<a href="https://redirect.github.com/ljharb/qs/issues/583">#583</a>)</li> <li>[Robustness] <code>utils</code>: <code>merge</code>: apply <code>arrayLimit</code> to the two-element array built for colliding values</li> <li>[Robustness] <code>parse</code>: bound the nesting added by repeated <code>strictMerge</code> conflicts (credit <a href="https://github.com/Yeaseen"><code>@Yeaseen</code></a>)</li> <li>[Docs] document that <code>qs</code> and flat parsers disagree about parameter names</li> <li>[Docs] clarify that <code>throwOnLimitExceeded</code> limits each array, not the total number of values</li> <li>[Docs] clarify 6.14.1/6.15.2 parse bracket behavior change (<a href="https://redirect.github.com/ljharb/qs/issues/567">#567</a>, <a href="https://redirect.github.com/ljharb/qs/issues/568">#568</a>)</li> <li>[meta] fix changelog indents</li> <li>[actions] set least-privilege <code>cache-mode</code></li> <li>[Tests] <code>utils</code>: <code>decode</code>: add missing cases</li> <li>[Tests] <code>parse</code>: characterize the <code>]=</code> split when an <code>=</code> precedes any bracket group (<a href="https://redirect.github.com/ljharb/qs/issues/620">#620</a>)</li> </ul> <!-- raw HTML omitted --> </blockquote> <p>... (truncated)</p> </details> <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/ljharb/qs/commit/bebfa1ab2ed4e5d6cd9317d42a65609296ebd2cb"><code>bebfa1a</code></a> v6.17.0</li> <li><a href="https://github.com/ljharb/qs/commit/574a28be4cb190a3f3249b6fd325b16cd146b762"><code>574a28b</code></a> [Dev Deps] update <code>eslint</code></li> <li><a href="https://github.com/ljharb/qs/commit/54f7f3b7b8df3d59a05255be1ef81208fdee1412"><code>54f7f3b</code></a> [Fix] <code>stringify</code>: do not sort the caller's <code>filter</code> array in place</li> <li><a href="https://github.com/ljharb/qs/commit/a2667af367b13fe0e5cc5bc8aad176ea57160f8b"><code>a2667af</code></a> [Fix] <code>parse</code>: copy an own <code>__proto__</code> key as data</li> <li><a href="https://github.com/ljharb/qs/commit/05a875552a31829825c3ebf8899f280011aa06be"><code>05a8755</code></a> [Fix] <code>parse</code>: decode percent-encoded dots case-insensitively</li> <li><a href="https://github.com/ljharb/qs/commit/234d5051f5071efaa025a7ca9e4d34a56a460a1b"><code>234d505</code></a> [Fix] <code>stringify</code>: encode keys when <code>allowEmptyArrays</code> is set</li> <li><a href="https://github.com/ljharb/qs/commit/5d9999948fb2718acfa4436b9d6a8ac181812873"><code>5d99999</code></a> [Tests] <code>stringify</code>: pin <code>allowEmptyArrays</code> output for keys that need no enco...</li> <li><a href="https://github.com/ljharb/qs/commit/feafd1517d5304cf07675c7a5efa5f2b1a905067"><code>feafd15</code></a> [Tests] <code>stringify</code>: pin <code>sort</code> order for nested keys selected by an array `f...</li> <li><a href="https://github.com/ljharb/qs/commit/b43b1cf8d0747d8520746d8cf6998d568431816a"><code>b43b1cf</code></a> [Fix] <code>parse</code>: preserve comma arrays when interpreting numeric entities</li> <li><a href="https://github.com/ljharb/qs/commit/81e7a2251d5a7f4c38e8ea77a31a285ab16d1822"><code>81e7a22</code></a> [Tests] <code>parse</code>: cover <code>interpretNumericEntities</code> across value shapes, keys, ...</li> <li>Additional commits viewable in <a href="https://github.com/ljharb/qs/compare/v6.16.0...v6.17.0">compare view</a></li> </ul> </details> <br /> Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Maputnik
A free and open visual editor for the MapLibre GL styles targeted at developers and map designers.
Usage
- 🔗 Design your maps online at https://www.maplibre.org/maputnik/ (all in local storage)
- 🔗 Use the Maputnik CLI for local style development
- In a Docker, run this command and browse to http://localhost:8888, Ctrl+C to stop the server.
docker run -it --rm -p 8888:8000 ghcr.io/maplibre/maputnik:main
To see the CLI options (for example file watching or style serving) run:
docker run -it --rm -p 8888:8000 ghcr.io/maplibre/maputnik:main --help
You might need to mount a volume (-v) to be able to use these options.
Documentation
The documentation can be found in the Wiki. You are welcome to collaborate!
- 🔗 Study the Maputnik Wiki
- 📹 Design a map from Scratch https://youtu.be/XoDh0gEnBQo
Develop
Maputnik is written in typescript and is using React and MapLibre GL JS.
We ensure building and developing Maputnik works with the current active LTS Node.js version and above.
Check out our Internationalization guide for UI text related changes.
Getting Involved
Join the #maplibre or #maputnik slack channel at OSMUS: get an invite at https://slack.openstreetmap.us/ Read the the below guide in order to get familiar with how we do things around here.
Install the deps, start the dev server and open the web browser on http://localhost:8888/.
# install dependencies
npm install
# start dev server
npm run start
If you want Maputnik to be accessible externally use the --host option:
# start externally accessible dev server
npm run start -- --host 0.0.0.0
The build process will watch for changes to the filesystem, rebuild and autoreload the editor.
npm run build
Lint the JavaScript code.
# run linter
npm run lint
npm run lint-css
npm run sort-styles
Tests
End-to-end tests
For E2E testing we use Playwright. The tests live in the e2e directory and drive the app through the MaputnikDriver page object.
The first time you run the tests, install the browser:
npx playwright install chromium
Playwright automatically starts the dev server (npm run start) for you, so you can just run:
npm run test
Some useful options:
# see the tests run in a headed browser
npm run test -- --headed
# run a single spec / filter by title
npm run test -- e2e/map.spec.ts
npm run test -- -g "zoom level"
# open the interactive UI mode
npx playwright test --ui
Running the E2E tests also produces a code-coverage report in coverage/ (collected via istanbul instrumentation of the dev server).
Unit & component tests
Unit tests and component tests run with Vitest; component tests (*.browser.test.tsx) use Vitest's browser mode with the Playwright provider.
npm run test-unit
Release process
- Review
CHANGELOG.md- Double-check that all changes included in the release are appropriately documented.
- To-be-released changes should be under the "main" header.
- Commit any final changes to the changelog.
- Run Create bump version PR by manual workflow dispatch and set the version number in the input. This will create a PR that changes the changelog and
package.jsonfile to review and merge. - Once merged, an automatic process will kick in and creates a GitHub release and uploads release assets.
Sponsors
Thanks to the supporters of the Kickstarter campaign. This project would not be possible without these commercial and individual sponsors. You can see this file's history for previous sponsors of the original Maputnik repo. Read more about the MapLibre Sponsorship Program at https://maplibre.org/sponsors/.
License
Maputnik is licensed under MIT and is Copyright (c) Lukas Martinelli and Maplibre contributors. As contributor please take extra care of not violating any Mapbox trademarks. Do not get inspired by other map studios and make your own decisions for a good style editor.
