# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [7.0.1] - 2026-10-15

### Bug Fixes

- turn the light with the map by default ([1eae91a](https://github.com/versatiles-org/versatiles-style/commit/1eae91a06bd94734d43a9183be6bc42a8b3f2720))

### Code Refactoring

- **light:** replace rotateWithMap with fixedToScreen, turning with the map by default ([76b90c4](https://github.com/versatiles-org/versatiles-style/commit/76b90c49d0f4ceb0ae4461a5a5543b4ceb2a44b5))

### Documentation

- **changelog:** tidy the 7.0.0 entry ([513f058](https://github.com/versatiles-org/versatiles-style/commit/513f058cf8c59ab82cb29dc0f1c18eca21489196))

### Tests

- **e2e:** warm up the native renderer before the timed colour tests ([398aedb](https://github.com/versatiles-org/versatiles-style/commit/398aedbdede2cf5ffd516695319f50d4b62973d4))

## [7.0.0] - 2026-10-15

### Breaking Changes

See [Migration from v6](API_DESIGN.md#migration-from-v6).

- turn light on by default ([f3d8c96](https://github.com/versatiles-org/versatiles-style/commit/f3d8c9641152922bc6a0e830d677040bb5f99465))
- remove hillshade.anchor in favour of light.rotateWithMap ([ea19322](https://github.com/versatiles-org/versatiles-style/commit/ea19322d63822c3a52be8810f75a8898f57affd2))
- remove the sun option in favour of light ([d23c75e](https://github.com/versatiles-org/versatiles-style/commit/d23c75ecaf4b00e00da22bcc884a79dad9f2ab3a))
- require MapLibre GL JS 5.5 ([2d17a28](https://github.com/versatiles-org/versatiles-style/commit/2d17a288a385278d357f195ce1b75878bd136d0e))

### Features

- **light:** add the light option: one light for hillshade, 3D buildings and the globe's atmosphere ([5afd6ed](https://github.com/versatiles-org/versatiles-style/commit/5afd6ed94d8a0b86c268e1c53fcda39f6aaae9a3))
- **hillshade:** use the combined method with light, so its altitude takes effect ([57670d1](https://github.com/versatiles-org/versatiles-style/commit/57670d10f35b4a1ef18723b31adf651206f17d55))
- **light:** write style.light only where buildings or the atmosphere read it ([10a5263](https://github.com/versatiles-org/versatiles-style/commit/10a526354d3956166312c34c4573e475d5c70177))

### Bug Fixes

- **light:** compensate MapLibre's atmosphere sun position on globe projections ([a3c5cef](https://github.com/versatiles-org/versatiles-style/commit/a3c5cef20e1ffbbebc0e8a0555fd530fa29baff3))
- **options:** reject out-of-range light, hillshade, terrain and sky values ([0e76ed8](https://github.com/versatiles-org/versatiles-style/commit/0e76ed81d75600918ee4e55d4d14ede331bc1e0b))
- **light:** keep a map-rotating light fixed to the screen below building zoom on a globe ([b33f5f6](https://github.com/versatiles-org/versatiles-style/commit/b33f5f6febaed0ccc113ffb64619c712943af5d5))

### Documentation

- document the light option and the single-light model ([c1faa37](https://github.com/versatiles-org/versatiles-style/commit/c1faa378579c9c9cfe2ed745c9c3d3e9a349187f))
- say that terrain is shaded only by hillshade ([a274adb](https://github.com/versatiles-org/versatiles-style/commit/a274adb699ed19ebfffb8b086042c5ae714f5278))
- update bundle size, treemap and dependency graph ([652befd](https://github.com/versatiles-org/versatiles-style/commit/652befd50942d8a8d041ac90b341b370b606fd49))
- add migration notes from v6 to v7 ([1f41752](https://github.com/versatiles-org/versatiles-style/commit/1f4175230006e462daed2b1819be845896aad935))

### Chores

- **deps:** update dependencies to latest versions ([4d4a980](https://github.com/versatiles-org/versatiles-style/commit/4d4a980fd74bdecd0e105bb7313db8298140fd7f))

## [6.4.1] - 2026-10-13

### Bug Fixes

- update color values for siteConstruction and siteSports in classic theme ([ffba505](https://github.com/versatiles-org/versatiles-style/commit/ffba5059de915c9cef60a34644fc69d141e4e68f))

### Documentation

- update bundle-treemap.svg ([603b8f3](https://github.com/versatiles-org/versatiles-style/commit/603b8f3e985f2b21f99b24f04d13b7ef3a41d72b))

### Chores

- **deps:** update dependencies to latest versions ([cb81411](https://github.com/versatiles-org/versatiles-style/commit/cb81411b6836b6f3f48f040b1d7041839727c8e5))

## [6.4.0] - 2026-10-09

### Features

- add --no-publish to release-npm, for packages that a CI workflow publishes ([ff5c566](https://github.com/versatiles-org/versatiles-style/commit/ff5c566e363c9d340767c2abdc0546bf0a894ea1))
- **dev:** add an icon editor to adjust and preview icon positions ([8100f6a](https://github.com/versatiles-org/versatiles-style/commit/8100f6a48a583faeacb45375829cf16baac4b13b))

### Bug Fixes

- omit default hillshade-method so hillshade works on MapLibre 5.0–5.4, close #141 ([611bb93](https://github.com/versatiles-org/versatiles-style/commit/611bb93153662b125c1b7aaf1d7ac4a38197195f))
- pin the MapLibre 5.0.0 style spec again and keep it out of dependency upgrades ([68c38bd](https://github.com/versatiles-org/versatiles-style/commit/68c38bdd1ba4f6a6e53576b38fcd92e36740e719))
- adjust viewBox attribute for multiple SVG icons to ensure proper rendering ([56a2b34](https://github.com/versatiles-org/versatiles-style/commit/56a2b3438f32ccc05b169ec206ed0ecce0cafd9d))

### Tests

- validate built styles against the MapLibre 5.0.0 style spec, see #141 ([4c13979](https://github.com/versatiles-org/versatiles-style/commit/4c139797cf3b2385215fd233e305b775cf7c077b))

### CI/CD

- publish to npm from the release workflow instead of locally ([5bf90b4](https://github.com/versatiles-org/versatiles-style/commit/5bf90b4bf2fec85f9b95b0db6fe914c374cca2e3))

### Chores

- update dependencies to latest versions ([9d2da78](https://github.com/versatiles-org/versatiles-style/commit/9d2da78784fdc62da8057b2c47fd2157a28dcb21))

## [6.3.1] - 2026-10-07

### Bug Fixes

- skip non-http(s) sources such as pmtiles:// in inlineSources, close #139 ([02de860](https://github.com/versatiles-org/versatiles-style/commit/02de860eef70de218c2718cd9363a707d10abe66))

## [6.3.0] - 2026-10-06

### Features

- split labels.places.cities into capitals, statecapitals, cities and towns, close #138 ([cf325b1](https://github.com/versatiles-org/versatiles-style/commit/cf325b1070b12d523d8cba52ba5e911eb14a6f61))

## [6.2.0] - 2026-10-06

### Features

- add lookalike themes 'positrino', 'positrino-dark', and 'fnord' ([60a70a4](https://github.com/versatiles-org/versatiles-style/commit/60a70a4fbf3c07cba515fe8d53b12636559b21d1))
- add new themes and update related tests ([a928b0a](https://github.com/versatiles-org/versatiles-style/commit/a928b0acad3801ed773244ab498fbcf1ab478fde))
- add classic theme to styling options ([d8e9ffd](https://github.com/versatiles-org/versatiles-style/commit/d8e9ffd2d9ade408ad8ad00da00d584c98b222ec))
- update theme palettes and colors ([dcf8d41](https://github.com/versatiles-org/versatiles-style/commit/dcf8d413ce5b05b653becb9e47768b01d078bc9f))
- draw state borders dash-dot and make dashed lines use butt caps ([41a3751](https://github.com/versatiles-org/versatiles-style/commit/41a37519d992ef189a5ca1832bcdf0a86b72bff2))
- accept line styles on border and path layer groups, add boundaries.disputed ([27e2778](https://github.com/versatiles-org/versatiles-style/commit/27e27781259da86b639edeee99c2feb00384b76c))
- keep dashed borders and paths at their solid weight in the satellite overlay ([22e29e7](https://github.com/versatiles-org/versatiles-style/commit/22e29e76b9569d837b496864ccebd7b8a4c59706))
- let lookalike themes carry line presets for borders and paths ([68ba520](https://github.com/versatiles-org/versatiles-style/commit/68ba520d35f525da82591744e6b89cf16a67a22b))
- read dashed borders and paths from foreign styles in guessOptions ([1e0de72](https://github.com/versatiles-org/versatiles-style/commit/1e0de7271aa90ed97c202e436ae32c120228673c))
- recognise Mapbox Streets tiles in guessSchema (#136) ([aecd5e5](https://github.com/versatiles-org/versatiles-style/commit/aecd5e5a0121d0ae630082f940b5e135c028e667))
- read styles on Mapbox Streets tiles in guessOptions (#136) ([aa6a19e](https://github.com/versatiles-org/versatiles-style/commit/aa6a19eb3999dd2b2ca5011129a453e5d1faec48))
- rebuild the crate theme from the Mapbox Streets v12 style definition (#136) ([ec6d780](https://github.com/versatiles-org/versatiles-style/commit/ec6d780d11346aa52e47ab3ddaa178b4b4ba132c))
- add width to line styles and an optional halo to borders ([f2b41c9](https://github.com/versatiles-org/versatiles-style/commit/f2b41c91de7031809538794ca0d16f89034eefff))
- let theme line presets set width and halo; give ping Bing's border styles ([491c736](https://github.com/versatiles-org/versatiles-style/commit/491c736e7bc2d25fc8c28b5f367e60879f6893de))
- read line widths from foreign styles in guessOptions; set width presets for lookalike themes ([760c4c3](https://github.com/versatiles-org/versatiles-style/commit/760c4c3aa758a4e794dfb364ae7fdf0e4ac601df))
- update map rendering parameters for improved imagery and add landcover feature ([80a057c](https://github.com/versatiles-org/versatiles-style/commit/80a057cb2f953842b75a9d8843391cbeece2bc5c))
- export isDarkPalette from the npm package ([c1c872a](https://github.com/versatiles-org/versatiles-style/commit/c1c872a83cbfcb0198d6cf23407860f4d8f06f8a))
- enhance documentation script to include screenshots and formatting ([6a568d9](https://github.com/versatiles-org/versatiles-style/commit/6a568d922fff36c417fa941067c564fc807f0ada))

### Bug Fixes

- update underground color fading logic to target land instead of background ([77dc5b0](https://github.com/versatiles-org/versatiles-style/commit/77dc5b0624ed15d027e3dff027dbba64484cb97c))
- filter palettes to exclude lookalike themes in getStyleVariants function ([1b5cf4f](https://github.com/versatiles-org/versatiles-style/commit/1b5cf4f863b41accd25f998de2c59caeee3e8d27))
- update lookalike theme colors and adjust ping table styling ([1dc448f](https://github.com/versatiles-org/versatiles-style/commit/1dc448f4a128fa27e8aecce3a5053b87fbc3735d))
- update color values for lookalike themes and adjust ping table colors ([9680c82](https://github.com/versatiles-org/versatiles-style/commit/9680c8253131c0f8d5e40dffdfb127579846b32b))
- match ping's building, motorway, farmland and border dashes to the rendered Bing style ([4b22835](https://github.com/versatiles-org/versatiles-style/commit/4b22835ce534095167dc059e584f5418bd6d571c))

### Code Refactoring

- road styling and update snapshots ([a478b86](https://github.com/versatiles-org/versatiles-style/commit/a478b86d7afd38a272b04371d2b761f5fb390f15))
- drop the halo option from line styles; borders always keep their casing ([70ecb6b](https://github.com/versatiles-org/versatiles-style/commit/70ecb6b9295dfbe428366b78056fad50b82f4584))
- rename lookalike themes crate, mosaic and ping to macbob, mactaylor and bingo ([138a47d](https://github.com/versatiles-org/versatiles-style/commit/138a47d865d5d99937e136ddc2375454dcd44f21))
- split the theme config, probes and derive modules ([4c00d54](https://github.com/versatiles-org/versatiles-style/commit/4c00d54c8e0c5a297de6b59b61e4fdd45f4dfa63))

### Documentation

- describe line styles, theme line presets and dash reading; update bundle size and graphs ([e94fd93](https://github.com/versatiles-org/versatiles-style/commit/e94fd935ff26261f1c405fefdb5ca3643eb8c4b2))
- describe reading Mapbox styles and the mapbox schema; update bundle size and graphs (#136) ([8102824](https://github.com/versatiles-org/versatiles-style/commit/8102824d45a63976f77c09e196de47ff488eabb7))
- describe the width option of line styles; update bundle size and graphs ([ec658f4](https://github.com/versatiles-org/versatiles-style/commit/ec658f48be6a7656adbbee558a15ca8f05060b4f))
- improve table formatting for light and dark theme styles in README ([231f869](https://github.com/versatiles-org/versatiles-style/commit/231f869444cf4e0babf37a8a8ca54564032cdc14))

### Tests

- cover Arabic and CJK in fontCovers now that merged glyph faces publish all codeblocks, close #132 ([334e3ef](https://github.com/versatiles-org/versatiles-style/commit/334e3ef2d303f0165884ed529f57c9db2fee60db))

### Chores

- update dependencies for maplibre-gl, typescript-eslint, and vite ([5f31325](https://github.com/versatiles-org/versatiles-style/commit/5f313258376aa02052862821dbb7701e4d8b542e))
- update source-map-js to version 1.2.2 ([d28b891](https://github.com/versatiles-org/versatiles-style/commit/d28b89100264f745bb3aa4c4ca1a4b8172273a02))

### Other Changes

- feat; Add 'googol' theme to styles and update related tests and configurations ([1db713a](https://github.com/versatiles-org/versatiles-style/commit/1db713a0268b490593578306f2e75db433099903))
- Update color palette to include secondary road colors and adjust related tests ([dd8c047](https://github.com/versatiles-org/versatiles-style/commit/dd8c047ba68a4c4c88bde3cc2ad3846237ad3373))
- Add pedestrian street styling and adjust road widths ([03945a0](https://github.com/versatiles-org/versatiles-style/commit/03945a0c09080fc1d6c0b76e6ae280e0da3d535d))

## [6.1.1] - 2026-10-03

### Code Refactoring

- **tile-cache:** update asset origin handling and adjust test cases ([2cbf2b1](https://github.com/versatiles-org/versatiles-style/commit/2cbf2b1f3e70c0965a4275207d41910fe13b12a1))
- **tile-cache:** update readAsset to drop query parameters and encode path segments ([70a8d56](https://github.com/versatiles-org/versatiles-style/commit/70a8d5653c36089f23b04b94ac12bcbcc6fc8fd8))

### Chores

- **package:** update @versatiles/release-tool to version 2.19.1 ([9dc0120](https://github.com/versatiles-org/versatiles-style/commit/9dc012080d0da8035b404df992e536f9ad090b10))

## [6.1.0] - 2026-10-03

### Features

- **satellite-overlay:** improve line opacity handling and drop unnecessary layers for improved visibility ([41ca99d](https://github.com/versatiles-org/versatiles-style/commit/41ca99d2c3f87f38ad6c37329bf732f46550a500))
- add osmOverlay.layerOpacity option for improved line rendering ([17fcca1](https://github.com/versatiles-org/versatiles-style/commit/17fcca1c834a827f6801c78a88aa31fc2adf3103))
- enhance line-layer opacity handling with zoom curves ([7fe08bf](https://github.com/versatiles-org/versatiles-style/commit/7fe08bf8088bd2dba9a9a627c53097e62ad880fd))
- add layer opacity toggle for overlay in controls ([025c79b](https://github.com/versatiles-org/versatiles-style/commit/025c79b41d2386d2aa42b64db89991e58cac7695))
- add overlay comparison tool for satellite layer opacity ([ba9b1ce](https://github.com/versatiles-org/versatiles-style/commit/ba9b1ce3f663651e6f3ed521d035f103d21aaa13))
- **satellite-overlay:** draw borders in their casing colour at 0.4 ([ba0086d](https://github.com/versatiles-org/versatiles-style/commit/ba0086d6f836707473c0846d4973794645b7c50c))
- add barrel configuration for dependency graph ([38921a7](https://github.com/versatiles-org/versatiles-style/commit/38921a70174e1b97058bac38355b47799fd475ef))

### Bug Fixes

- **dependabot:** add ignore rule for typescript dependency updates ([33c5e1d](https://github.com/versatiles-org/versatiles-style/commit/33c5e1d769a258a03cda03b1d3315291b595c320))

### Code Refactoring

- improve documentation and logic for deep import handling ([664c56c](https://github.com/versatiles-org/versatiles-style/commit/664c56c96206fac7cd2cd8fd7fdd53a4c64c0c1d))
- consolidate color options imports and update module exports ([8363ed1](https://github.com/versatiles-org/versatiles-style/commit/8363ed1babcd6574b62d005ea3cbbcd5ec5303e3))
- add font directory ([4bdb533](https://github.com/versatiles-org/versatiles-style/commit/4bdb533e9d480dfc66ea0e3e4e0a7dff2aa80f84))
- update avoidableDeepImports to accept a root parameter and clean up exemptions ([9915f62](https://github.com/versatiles-org/versatiles-style/commit/9915f6228674e1d86bb4b9a1566bff24b1a41d1e))
- use kebab-case for all file names and enforce it ([41564e5](https://github.com/versatiles-org/versatiles-style/commit/41564e5ab3534caec831c882d005852fc7573de7))
- **shortbread:** merge rail and light rail layers ([163c5ca](https://github.com/versatiles-org/versatiles-style/commit/163c5caf506289875639adfae581ef90bfc46a18))
- **dsl:** merge single-kind filters into one `in` test ([5c5e4df](https://github.com/versatiles-org/versatiles-style/commit/5c5e4dfc65248f3827fb31668960c31969e219f3))
- **shortbread:** generate merged site layers directly ([1ab2044](https://github.com/versatiles-org/versatiles-style/commit/1ab204448917c3c942967f2b85edad5d47c9bd00))
- **shortbread:** generate aerialway and path-bridge layers directly ([073e907](https://github.com/versatiles-org/versatiles-style/commit/073e907db25cfa0537146df40a9db08bf452e7d0))
- **cartography:** draw one casing under country and disputed borders ([243dce6](https://github.com/versatiles-org/versatiles-style/commit/243dce6c8706ab16ebf2dea24680a805e78dec03))
- **shortbread:** generate merged rail layers directly ([9d5c1c7](https://github.com/versatiles-org/versatiles-style/commit/9d5c1c75561cae4b692908502fbd17d94a363736))
- **shortbread:** generate merged street layers directly ([1e1ee1f](https://github.com/versatiles-org/versatiles-style/commit/1e1ee1f577cb16c8280f9fcde083366c96fe9a9f))
- **dsl:** remove the post-processing layer merge ([71e4945](https://github.com/versatiles-org/versatiles-style/commit/71e49450e50cf60bbe98282f2eda1f3a8563fe2c))

### Documentation

- regenerate dependency graph ([daff684](https://github.com/versatiles-org/versatiles-style/commit/daff684090f2db1695599a44af0ca75250a1c3f4))

### Chores

- **deps:** update dependencies to latest versions ([651986b](https://github.com/versatiles-org/versatiles-style/commit/651986b9b84c0d89e60e0e272b5bfa4a8e2ffe75))
- **package:** update brace-expansion and serialize-javascript versions ([448eeb9](https://github.com/versatiles-org/versatiles-style/commit/448eeb94cf33918a8f7127eb2a05d87770606af9))

## [6.0.3] - 2026-09-28

### Bug Fixes

- **recolor:** integrate recolorColor function for consistent color transformations in satellite layers ([aca4628](https://github.com/versatiles-org/versatiles-style/commit/aca4628b1257b96e5f3245cc9e929e0f6af506d5))

### Documentation

- update readme and charts ([4400640](https://github.com/versatiles-org/versatiles-style/commit/44006404040cc460e03489d6fdc7d22373d70403))

### Tests

- add recolor coverage tests for style color reach ([9a69910](https://github.com/versatiles-org/versatiles-style/commit/9a69910a4f5d436e9e4c06bef5ca276910a785ad))

## [6.0.2] - 2026-09-27

### Features

- implement clampToRange function for channel clamping and update related tests ([4a82fee](https://github.com/versatiles-org/versatiles-style/commit/4a82feec56cefb8f9b1b85b5b18f4f05dca7a268))

### Bug Fixes

- update dependencies to latest versions for improved stability and performance ([162eb12](https://github.com/versatiles-org/versatiles-style/commit/162eb1293f53bbe25a144edc0a5009312b572e34))
- update @versatiles/release-tool to version 2.16.0 ([ea513ab](https://github.com/versatiles-org/versatiles-style/commit/ea513abae4258ed6750fe39960adab1b68536e11))
- update brightness method to clarify functionality and improve implementation ([87a5b37](https://github.com/versatiles-org/versatiles-style/commit/87a5b37e0a57268ed048aac553e5fe62091349c3))

### Code Refactoring

- update doc-bundle script to use vrt directly and remove bundle-treemap.ts ([2bebcd3](https://github.com/versatiles-org/versatiles-style/commit/2bebcd33f2bb86415d9c3f24c65aec82e4792442))

### Documentation

- update readme ([ef3a474](https://github.com/versatiles-org/versatiles-style/commit/ef3a47412bea4059a8612656cabb034e5e50285c))

### Tests

- fix tilejson files with additional metadata and vector layers ([50ed854](https://github.com/versatiles-org/versatiles-style/commit/50ed854b0ba9f97477643b7656c6afdef04657bb))

### Chores

- update dependencies in package.json ([74651fa](https://github.com/versatiles-org/versatiles-style/commit/74651faa09f947b4c192cbdcd3dcfbfd92362c15))

## [6.0.1] - 2026-09-20

### Bug Fixes

- update README and screenshot generation to include dark theme previews and streamline palette handling ([3e2768d](https://github.com/versatiles-org/versatiles-style/commit/3e2768df6f4f4274fc934d9ca6bb642904f7239a))
- add disappear property to place labels for better zoom handling and opacity control ([585ac6d](https://github.com/versatiles-org/versatiles-style/commit/585ac6d47015a2ce5f1332258f662aa166ecc2db))
- update street label order and add 'track' to feature labels for improved rendering ([a4a9aea](https://github.com/versatiles-org/versatiles-style/commit/a4a9aea2f9e30db417b1956553817eee645ae7ec))
- remove width-less bicycle overlays from style snapshots and update related tests for clarity ([30fcb33](https://github.com/versatiles-org/versatiles-style/commit/30fcb330db629528f8e591cffbdf1a2ea93a700e))
- ensure style metadata is copied per build to prevent shared mutations and add deep freeze utility for shared objects ([d265128](https://github.com/versatiles-org/versatiles-style/commit/d2651286c9e8fb9550e99106265b9179dcc61b4a))
- add color validation to options to ensure proper parsing and reporting of unparseable colors ([c495cfc](https://github.com/versatiles-org/versatiles-style/commit/c495cfc7273dbc0b73346b48896e10b5a4ac142b))
- add finite number checks for recolor and sky options to prevent invalid StyleJSON ([257dc25](https://github.com/versatiles-org/versatiles-style/commit/257dc25c4ea69bbaab93dd180bb6fe25a402f6e7))
- improve error messaging for non-finite numbers and type mismatches in option validation ([3d0cbe1](https://github.com/versatiles-org/versatiles-style/commit/3d0cbe1988c229ef72e47164f9c4f5c3cd5adb1f))
- ensure saturation options are honored correctly with random luminosity and add related tests ([1dbf6c5](https://github.com/versatiles-org/versatiles-style/commit/1dbf6c5cdf9412302a5b1d5e2cbc01bbe1f631be))
- resolve language conflict reporting and improve label evaluation for below-layer symbols ([94cb2b7](https://github.com/versatiles-org/versatiles-style/commit/94cb2b74f9e7c294ab5bfa12da37495ca9c9956c))
- correct function naming in error messages for protomaps options validation ([9413a11](https://github.com/versatiles-org/versatiles-style/commit/9413a11bdfb26943016528471bc8adc91fd78da5))
- replace shell command with script for packing browser bundle and add validation for entries ([73307a3](https://github.com/versatiles-org/versatiles-style/commit/73307a3d448ab64532a600289ff00a98e6de5f5a))
- refactor style packaging to use writeTarball and improve validation error handling ([9277d83](https://github.com/versatiles-org/versatiles-style/commit/9277d834c970980fab1b31fffad247889e10c04e))
- add tag verification step to ensure release consistency with package.json version ([d0fb0f7](https://github.com/versatiles-org/versatiles-style/commit/d0fb0f7445476f21e7e2d804b191df4d6988bcf1))
- update prepack script to use build-node and remove optipng installation from CI ([b5c8751](https://github.com/versatiles-org/versatiles-style/commit/b5c8751493b87a23541ddd3c248961a0a450a302))

## [6.0.0] - 2026-09-18

### ⚠ BREAKING CHANGES
- Rewrote the public API around five functions: `osm()`, `satellite()`, `guessStyle()`,
  `guessSchema()` and `inspectorStyle()`.
  `osm()` and `satellite()` are **synchronous** and perform no I/O — a `*.json` source URL becomes a
  source `url` that MapLibre resolves at map load. `guessStyle()` is asynchronous, because it has to
  read the TileJSON before it can decide what to build.
- The package now declares an `exports` map, where v5 had none. The four public entry points are
  `@versatiles/style` and the subpaths `/omt`, `/protomaps` and `/migrate`; deep imports into
  `@versatiles/style/dist/…`, which v5 happened to allow, no longer resolve.
- Added `inlineSources(style)` to resolve a style's source references into a self-contained style,
  and `fetchTileJSON(url)` for when a TileJSON is needed at build time.
- `urls` keys now accept a pre-fetched `TileJSONSpecification` object as well as a URL string.
- Removed the v5 `StyleBuilder` class hierarchy and the palette builder functions
  `colorful`, `eclipse`, `graybeard`, `neutrino`, `shadow`, the deprecated `styles` object, and the
  related `StyleBuilderOptions` / `StyleBuilderColors` / `StyleBuilderColorKey` / `StyleBuilderFonts` /
  `StyleBuilderFunction` / `SatelliteStyleOptions` / `Language` types. (`GuessStyleOptions` remains.)
  Use `osm({ theme })` with the palettes `colorful | natural | muted | gray | toner`, each also available
  as a dark theme (`colorful-dark`, …), instead. See the migration table in `API_DESIGN.md`.
- Removed the old `guess_style` module. `guessStyle()` accepts a TileJSON **URL**, which it downloads,
  or a `TileJSONSpecification` object, which it uses without network access, and returns a Promise.
  Its options use the same `urls` shape as `osm()`: v5's `baseUrl`, `glyphs` and `sprite` are
  `urls.base`, `urls.glyphsPattern` and `urls.sprite`; `fetch` is a top-level option, as for
  `inlineSources()` and `fetchTileJSON()`. It never throws:
  an invalid argument, an unknown option key, a failed download or a malformed document all yield a
  blank — but valid — style.
- `isTileJSONSpecification` / `isRasterTileJSONSpecification` now return a boolean instead of
  throwing, so they behave like the type guards their signatures always claimed. The throwing
  behaviour, with its descriptive validation messages, moved to the new
  `assertTileJSONSpecification` / `assertRasterTileJSONSpecification`.
- `osm()` and `satellite()` no longer accept `urls.fetch`. They do no I/O, so it was never used; passing
  it is now an unknown-option error. A custom `fetch` belongs to the functions that download:
  `inlineSources()`, `fetchTileJSON()` and `guessStyle()`.
- **Unknown option keys now throw** instead of being silently ignored. `osm()`, `satellite()`, their
  `resolveOptions`/`minimizeOptions`/`toCode`, `inlineSources()` and `fetchTileJSON()` reject any
  key they do not know, with an error naming the unknown keys and, for a v5 name, its v6
  replacement (`osm: unknown option "textScale" — in v6 this is "text.scale"`).
  `guessStyle()` returns its blank style instead, keeping its never-throws contract.
- The `colors` keys were renamed to group-prefixed names (`wood` → `natureWood`, `streetbg` →
  `roadStreetBg`, `poi` → `labelPoi`, …): 34 of the 41 v5 keys changed. See the table under
  "Migration from v5" in `API_DESIGN.md`. A v5 key that is not renamed is rejected with an error naming its v6 name.
- `colorOptionsKeys` is no longer exported; use `osm.colorKeys` or `satellite.colorKeys`, which
  expose the same array.
- **Pedestrian squares are now labelled.** `label-street-pedestrian-zone` reads Shortbread's
  `streets_polygons_labels` at z14, so named squares and plazas are no longer anonymous grey
  polygons. `runway`, `taxiway` and `service` kinds in that layer stay unlabelled — it carries no
  `ref`, so runways would seldom label, and service polygons are not drawn.
- **Water is now labelled.** `label-water-area` (lakes, seas, reservoirs, from z4),
  `label-water-river` (rivers and canals, z12) and `label-water-stream` (streams and ditches, z14)
  read Shortbread's `water_polygons_labels` and `water_lines_labels`, which no VersaTiles style has
  ever rendered — v5 did not either, so the map had no water names at all. Adds a `labelWater`
  colour and a `layers.labels.water` group, split into `lakes` and `rivers`.
- **Styles now default to the `globe` projection** and accept a `projection` option
  (`'globe' | 'mercator' | 'vertical-perspective'`). Web Mercator's area distortion is worst at the
  low zooms where the whole world is visible; MapLibre returns to Mercator as you zoom in. This
  raises the required MapLibre GL JS version to **5.0+**, now declared as an **optional peer
  dependency** (`maplibre-gl: >=5.0.0`) — optional because the package has no runtime dependency
  on MapLibre and works for anyone generating style JSON server-side. Older versions and the
  native/server renderers ignore the property and draw Mercator, i.e. the previous behaviour;
  pass `projection: 'mercator'` to keep it explicitly.
- **Published satellite styles reshaped.** `assets/styles/satellite/style.json` is now **bare
  imagery**; the vector overlay moved to `satellite/overlay.json`. `satellite/nooverlay.json` is
  retired — use `satellite/style.json`, which is the same thing. The same applies to `terrain/*`.
  `satellite/en` and `satellite/de` are unchanged and still carry the overlay.
  Note this is deliberately the opposite of the library default: `satellite()` includes the overlay,
  because a bare style is the more useful published artifact but the less useful API default.
- **Sprite sheet renamed `basics` → `base`**, and `/assets/sprites/basics/sprites` is no longer
  published. Most ids only need the new prefix, but 22 were renamed or split — see the mapping table
  in `SPRITES.md`.
- **The `markers` sheet is now split into `extras` and `icons`, and its ids moved — a prefix swap is not
  enough.** v5's `icon` group became the `icons` sheet, whose ids drop the group prefix
  (`markers:icon-bicycle` → `icons:bicycle`); `extras` keeps five groups: `badge`, `pattern`, `pin`,
  `shape`, `symbol`. Every geometric shape left `symbol` for `shape`, so `markers:symbol-star` is now
  `extras:shape-star`, not `extras:symbol-star`. Names were also audited against the naming
  convention, because several described where an icon was _used_ rather than what it _draws_:
  `icon-karaoke` → `icons:microphone`, `icon-aquarium` → `icons:fish`, `icon-animal_shelter` →
  `icons:cat`, `icon-park`/`icon-park1` → `icons:tree`/`icons:conifer`, `icon-water` →
  `icons:droplet`, `icon-roadblock` → `icons:no_entry`, `icon-home` → `icons:house`. `icon-heart` moved to
  `extras:shape-heart` and `icon-entrance` to `extras:symbol-entrance`, `symbol-marker` became `pin-teardrop`, `icon-information` was
  dropped (`base` already draws one), and `symbol-arrow1`/`arrow2` shifted to `arrow2`/`arrow3` —
  so a v5 map using `markers:symbol-arrow2` wants `extras:symbol-arrow3` and a prefix swap would
  silently give it the wrong drawing. The full table is in `SPRITES.md`.
- **The public icons grew from 38 to 234** — 96 in `extras`, 138 in `icons` — and both sheets are a
  supported, add-only public API. They are separate sheets so a map that only places pins does not
  download every pictogram. Alongside the existing shapes and arrows they now carry map pins (including numbered ones), numbered badges,
  tileable `fill-pattern` tiles, and pictograms for transport, weather and hazards, energy, nature,
  civic and commerce, culture and interface. All CC0.
- **The sprite JSON now carries picker metadata.** Each entry in **every** sheet gains a `title` and
  optional `aliases` for search, and entries that point somewhere other than their own middle gain a
  `center` as a fraction of the icon's box — a map pin's tip (`[0.5, 1]`) and every arrowhead. MapLibre ignores fields
  it does not know, so this is additive, and no second request is needed to build an icon picker.
  Many `base` aliases are the v5 name the icon used to carry, so a style editor searching
  `pharmacy` still finds `base:icon-pill`.
- **Two `base` icons renamed** (`base` is internal and may change with any release, but for
  completeness): `base:marking-arrow` → `base:marking-oneway`, which is what it actually marks, and
  `base:pattern-warning` → `base:pattern-hatched`, which is what it actually draws — it is diagonal
  hatching, and the old name described the danger-area fill it was used for.
- The v5 style names (`eclipse`, `graybeard`, `neutrino`, `shadow`, `empty`) are **still published**
  as aliases of their closest v6 equivalent, so existing `assets/styles/<name>/…` URLs keep working.
  They are deprecated and will be dropped in 7.0. The v6 themes behind them were retuned, so these
  styles look different from their v5 originals.
- `defaults` and `resolveOptions()` on `osm` and `satellite` no longer fill in `sky.skyColor` and
  `sky.horizonColor`. The style still derives them from the palette when it is built, so a resolved
  object can be passed back to `osm()`/`satellite()` without pinning the sky to the old colours.
- An unknown palette name now throws `osm.theme: unknown palette "…"`, listing the valid palettes, instead
  of `TypeError: Cannot read properties of undefined (reading 'light')`. The v5 style names are not
  accepted as themes; the error names the v6 theme to use (`"eclipse" is a v5 style name — in v6 use
  "colorful-dark"`).
- Removed `getStyleVariants()` and the `StyleVariant` type from the public API. They enumerated the
  styles *this project* publishes to its CDN, which is release tooling rather than library API, and
  they now live in `scripts/lib/variants.ts`. Nothing outside this repository used them.
- Rewrote `Color` as a single immutable class over six colour spaces — sRGB, HSL, HWB, HSV, OKLab and
  OKLCh — replacing the `RGB`/`HSL`/`HSV` class hierarchy. Those three were type-only exports, so no
  runtime value disappeared; see "Migration from v5: colours" in `API_DESIGN.md` for the mapping.
- Colour parsing is strict. Input that v5 silently misread now throws a `ColorParseError` naming the
  problem: `rgb(100%,0%,0%)` was read as `rgb(100,0,0)`, `rgba(255,0,0,50%)` came out opaque,
  `rgb(-5,0,0)` became `rgb(5,0,0)`, and a trailing `;` was accepted. Percentages, signs, decimals,
  angle units and `/` alpha now mean what CSS says they mean.
- Named colours are not supported: write the hex. Nor are `calc()`, `color-mix()`, relative colour
  syntax, `color()`, `light-dark()`, `currentColor` or `none` components — each rejected by name.
- `tint()` toward a colour with no hue now leaves the colour unchanged. v5 read white, black and grey
  as hue 0°, so tinting toward any of them turned every colour red.
- `blend()` interpolates alpha instead of keeping the base's, and `lighten()`/`darken()` clamp their
  ratio to 0–1, as `blend()` and `tint()` already did.
- `randomColor()` without a seed now returns a different colour each call (v5 seeded with 0 and so
  always returned the same one), and a numeric or `'weak'` `saturation` is honoured rather than ignored.

### Added
- `toCode(options, { target })` writes the snippet for where it will run. The default `'npm'` is the ES
  module as before; `'browser'` writes the `<script>` form for a plain HTML page loading the CDN bundle —
  no import, and the `await` inside an async IIFE, since a classic script is not a module. Only `osm()`
  and `satellite()` have a `'browser'` form; `omt()` and `protomaps()` are not in the CDN bundle and say so.
- `styleMetadata(builder, options)` and `readStyleOptions(style)` record the options a style was built
  from in its `metadata`, and read them back — an exact round-trip for a style editor, where
  `@versatiles/style/migrate` can only reconstruct. Opt-in: the builders do not write it themselves,
  because baking options into the style would break the `osm(minimizeOptions(x)) === osm(x)` guarantee
  (minimising drops representations that resolve differently but render identically) and would add a copy
  of every option to every style, for the benefit of the few callers that read it back. `urls` is never
  recorded — it may hold a whole pre-fetched TileJSON, and it pins a style to the host that built it.
- `hwb()`, `hsv()`, `oklab()` and `oklch()` as input syntax, and `Color.to(space)` with typed per-space
  accessors (`color.oklch.l`), `Color.mix()` with the four CSS hue-interpolation methods, `deltaEOK()`,
  `contrastRatio()`, `luminance()`, `inGamut()`, `toGamut()` (CSS Color 4 gamut mapping) and
  `with({ … })` for channel edits.
- `toCSS(space?)` writes a colour in any supported space; `asString()` continues to write the sRGB
  legacy syntax that MapLibre reads.

### Fixed
- The sky is now recoloured with the rest of the style. `recolor` walked layer paint only, so an
  inverted-brightness map darkened the ground and kept a bright blue sky above it. The 3D light is
  deliberately left alone: its colour is an illuminant, and inverting white gives black, which is not
  dark lighting but no light at all.
- `sky.{skyColor,horizonColor,fogColor}`, `hillshade.{shadowColor,highlightColor,accentColor}` and
  `sun.color` are validated instead of being copied into the style unexamined. An unreadable colour
  there used to reach MapLibre and render as nothing in the native renderer.
- The four `marking-*` layers no longer emit `hsl()` while every other colour is `rgb()` — an accident
  of which class a transform happened to return. Same colours, one notation.
- `NativeMap` (screenshot tooling) now reports the engine's `ParseStyle` warnings. A colour the native
  parser cannot read renders as a fully transparent layer and used to pass CI silently.

### Features
- **Two more tile schemas, each on its own subpath.** `omt()` from `@versatiles/style/omt` draws
  [OpenMapTiles](https://openmaptiles.org/) tiles and `protomaps()` from `@versatiles/style/protomaps`
  draws the [Protomaps Basemap](https://docs.protomaps.com/basemaps/layers) — the same cartography
  `osm()` gives Shortbread, from the same option vocabulary (`theme`, `colors`, `recolor`, `layers`,
  `text`, `icon`, `sun`, `sky`, `projection`) and with the same statics. Only the tile source option
  differs: `urls.omt` defaults to OpenFreeMap, and `urls.protomaps` is **required**, because Protomaps
  publishes a PMTiles archive rather than a hosted endpoint. An option a schema cannot express throws
  rather than silently doing nothing — `omt({ features: { landcover: true } })` is an error naming the
  key. They are subpaths rather than root exports so that a page drawing only Shortbread does not
  download them: the import graph decides what the CDN bundle contains, not a build flag.
- `inspectorStyle(tileJSON)` returns a colour-coded style that draws every source-layer of a vector
  tileset — a translucent fill, a line and a `name` label each, nothing filtered — for looking at
  unfamiliar tiles, or at what a tileset carries rather than how it should look. It is the style
  `guessStyle()` already fell back to for vector tiles whose schema it cannot build; exporting it
  means it can also be asked for deliberately, including for a tileset `guessStyle` recognises and
  would otherwise build real cartography for. Synchronous and I/O-free, and unlike `guessStyle` it
  throws on bad input rather than returning a blank style.
- `guessSchema(tileJSON)` names a vector tileset's schema — `'shortbread' | 'openmaptiles' |
  'protomaps'` — synchronously and without I/O, reading only `vector_layers`. It scores every schema,
  so `candidates` shows why. It knows all three without importing any of them, which is what keeps it
  in the root entry.
- `guessStyle()` takes a `schemas` option: pass `omt` or `protomaps` (or a schema of your own) and a
  tileset detected as that schema gets its real style instead of the inspector style. The list is
  additive — Shortbread still wins for Shortbread tiles. Injection rather than a registry, so a caller
  pays only for the schemas they import.
- `guessOptions(style)` from `@versatiles/style/migrate` reads a MapLibre style built for
  OpenMapTiles, Protomaps or Shortbread tiles and returns the `osm()` or `satellite()` options whose
  style looks most like it, with a report of what it read and what it could not carry over — for
  moving an existing map onto VersaTiles. `deriveOptions()` is its synchronous, I/O-free core. Its own
  subpath because it carries the style spec's expression engine and a calibration of the builders.
- `guessOptions()` reports in structures a style editor can act on, rather than prose.
  `report.diagnostics` is a list of records, each with a stable machine-readable `code`, a `severity`
  (`error` blocks, `warning` is a real loss, `info` fires on every import), the `optionPath` it
  concerns and a payload typed per code — so a consumer can group, count, suppress and translate them,
  and mark the very control a person would use to fix the thing. Conflicts carry what they discarded:
  `color.conflict` lists the colours several layers drew for one feature, grouped by colour with the
  layers behind each, and `color.collapsed` lists features the source tells apart that the target
  draws as one (Shortbread's POI layer is coarser than OpenMapTiles' by design). `worst()`,
  `byCode()`, `byOption()` and `is()` read the list; `sortDiagnostics()` fixes its order.
- `guessOptions()` also returns `report.provenance`: where each option came from — `observed`,
  `pooled` (borrowed from a comparable topic), `inherited` (the chosen palette's value) or `default` —
  with a `confidence` where one was genuinely measured. This records what the options cannot:
  `minimizeOptions` deletes a derived value equal to the default, so a setting read from the style and
  one never derived are both an absent key, and provenance tells them apart. It covers the options
  under `PROVENANCE_COVERS` (`theme`, `colors`, `text`, `icon`); `isCovered(path)` distinguishes "not
  annotated yet" from "nothing spoke for it", which a missing entry alone cannot.
- Every palette has a dark theme of its own: `colorful-dark`, `natural-dark`, `muted-dark`, `gray-dark`
  and `toner-dark`. Pick one with `isDarkMode()` to follow the system setting. They are published
  like the light themes (`assets/styles/colorful-dark/style.json`, `…/en.json`, `…-terrain/…`).
- `osm.supportsLandcover(tileJSON)` reports whether a tileset carries the low-zoom landcover
  extension that `features.landcover` needs.
- `osm.minimizeOptions(options)` / `satellite.minimizeOptions(options)` return the smallest options
  object that builds the same style — for storing a style in a URL or config file.
- `satellite.layerGroups` maps each group of `osmOverlay.layers` to the layers it controls in the
  overlay: `osm.layerGroups` without land, water, sites, airport and buildings, which the overlay does not
  draw, and without tunnels. `satellite.minimizeOptions()` drops those groups from `osmOverlay.layers`.
- `osm.toCode(options)` / `satellite.toCode(options)` return a runnable snippet for those options,
  wrapped in `inlineSources`, that always sets `urls.base`.
- `text` sets label typography globally, per group or per topic — `boundaries`, `places`, `streets`,
  `water`, `pois` and `addresses`, each with sub-topics. Every node takes the same properties: `font`,
  `scale`, `spacing`, `maxWidth`, `lineHeight`, `letterSpacing`, `transform`, `haloWidth` and `haloBlur`,
  and each topic takes each one from the nearest node that sets it. `text.language`, `text.languageStrict`
  and `text.pitchAlignment` apply to every label. `osm.textGroups` lists the layers each topic sets.
  `guessOptions()` carries over the fonts of a migrated style per topic when the glyph server's font list
  has them (`Open Sans Bold` → `open_sans_bold`), and their weight otherwise. Hamlet names are a topic of
  their own, `places.hamlets`, and so is their visibility, `layers.labels.places.hamlets`:
  `layers.labels.places.villages: false` no longer hides them.
- For a font picker: `fetchFontFaces()` lists the faces a glyph server publishes, with titles.
  `fontCovers()` tells whether a face has the glyphs for a label language, `'user'` included; beyond the
  script's letters it checks the extra letters of 27 languages, such as Polish, Vietnamese and Serbian.
  `fontScripts()` lists the scripts of `FONT_SCRIPTS` a face covers, `languageScript()` gives the script of
  a language, and `textScripts()` the scripts that occur in a text. `labelLanguage()` gives the language
  labels are drawn in, with `'user'` read as the browser's language.
- `icon` sets the size (`icon.scale`) and spacing (`icon.spacing`) of icons, apart from their labels.
- `text.pitchAlignment: 'viewport'` stands street, river and motorway names up in a tilted map
  instead of laying them on the ground. `guessOptions()` carries it over from a style that does the same.
- `text.spacing` and `icon.spacing` thin point labels and icons too — places, POIs and house numbers — by
  widening their collision padding (14 px per step above 1), as well as labels and markings along lines.


## [5.13.1] - 2026-08-15

### Features

- implement fade-in functionality for land and water layers with associated tests ([4889e4a](https://github.com/versatiles-org/versatiles-style/commit/4889e4a1b85d02094b5b9b2104b8ff2d269aee3b))

### Bug Fixes

- update funding information to reflect new organization details ([1c04b12](https://github.com/versatiles-org/versatiles-style/commit/1c04b1276bfc854554db3df5403c350fb72074c0))

### Build System

- **deps:** bump the npm group with 11 updates ([2a02579](https://github.com/versatiles-org/versatiles-style/commit/2a02579c5db351a2235de50f8222ebb064832448))
- **deps:** bump the action group with 2 updates ([4d6c888](https://github.com/versatiles-org/versatiles-style/commit/4d6c8882d73475fbb556ec250f3f6788c3a08203))
- **deps:** bump actions/setup-node from 6 to 7 in the action group ([4343ea5](https://github.com/versatiles-org/versatiles-style/commit/4343ea52647b72271ae036daff36d0e584e3aa10))

### Chores

- update dependencies and devDependencies in package.json ([4c031db](https://github.com/versatiles-org/versatiles-style/commit/4c031dbe83a06e8c4f2b26deaa0ca2ae26ff5b47))

### Styles

- format map function syntax in getShortbreadLayers ([61364c6](https://github.com/versatiles-org/versatiles-style/commit/61364c6dd2cf0087ea126f75c1368132b8c9a45a))

## [5.13.0] - 2026-06-22

### Features

- add experimental options for landcover rendering in style rules, fixes #114 and fixes #115 ([b0c8eaa](https://github.com/versatiles-org/versatiles-style/commit/b0c8eaa149be75d8f7e1a81f9ca1b1fec3258d86))
- enhance style rendering with 3D building support and experimental options, fixes #116 ([affb796](https://github.com/versatiles-org/versatiles-style/commit/affb7962c85dbffe42c1b3442830b49d5f05fc15))
- add support for 3D building heights and synchronize light settings with hillshade ([e574ef2](https://github.com/versatiles-org/versatiles-style/commit/e574ef29b76966d17f02d05bc10c7c2099870254))
- reorganize and enhance label definitions for place and boundary layers ([7080674](https://github.com/versatiles-org/versatiles-style/commit/7080674bb5cf6896c6993b70d28e31f809500a75))
- adjust building opacity for 3D rendering in style rules ([8edfcb1](https://github.com/versatiles-org/versatiles-style/commit/8edfcb13d0fc21c6fd8bdf3ce4ee7fd23b9fa201))
- add languageStrict option for enhanced language handling in style rules, fixes #117 ([4ebe7d4](https://github.com/versatiles-org/versatiles-style/commit/4ebe7d4e0abe3cff3f92fa6f95a295c4a7231ab9))
- increase maxzoom for satellite style to enhance detail in imagery ([f5d6b9d](https://github.com/versatiles-org/versatiles-style/commit/f5d6b9dd44bcea19f60f8a3ab1afbbb078e98a05))

### Build System

- **deps-dev:** bump the npm group with 10 updates ([2478712](https://github.com/versatiles-org/versatiles-style/commit/247871246ab0dc899296684de47a7d6b78ebcea9))

### Chores

- update dependencies in package.json ([03590b0](https://github.com/versatiles-org/versatiles-style/commit/03590b07d99fdc0b5decab8d64698da132253c50))

## [5.12.1] - 2026-05-22

### Features

- add TileJSON files for various vector and raster layers ([67311b3](https://github.com/versatiles-org/versatiles-style/commit/67311b389706a18c3e43508b69a4619e16521ea6))
- update center property to accept three numbers in TileJSON specification ([6a6ba6f](https://github.com/versatiles-org/versatiles-style/commit/6a6ba6fa2590643c702baf7cc6f7c7939bf463fb))
- add tests for real-world TileJSONs and validate generated MapLibre styles ([14670ab](https://github.com/versatiles-org/versatiles-style/commit/14670ab7bd3520c430db6f4197db7d176337e0db))
- enhance guessStyle function with improved TileJSON sanitization and validation ([2d0bc63](https://github.com/versatiles-org/versatiles-style/commit/2d0bc63be0f4288aefe9fdd5c464bab6a09332cd))
- add tests for handling partially invalid TileJSONs and validate vector layer filtering ([35e73c2](https://github.com/versatiles-org/versatiles-style/commit/35e73c253a7967b6dcd1447254e37411133a90a6))

### Bug Fixes

- update diagram structure in README for clarity and organization ([275733a](https://github.com/versatiles-org/versatiles-style/commit/275733a51a43e7dd7e9fec1838afeb3ecde69d52))

### Chores

- update dependencies to latest versions ([e6f8f15](https://github.com/versatiles-org/versatiles-style/commit/e6f8f15fe3375ba5a0898d65f27d636d03a58f2c))

## [5.12.0] - 2026-05-15

### Features

- render highway=busway and highway=bus_guideway as service streets ([1d2d15b](https://github.com/versatiles-org/versatiles-style/commit/1d2d15be8574ae68cbcbc0e03165c4977fa642fd))
- add textScale option to multiply symbol text sizes ([e91c2af](https://github.com/versatiles-org/versatiles-style/commit/e91c2afaa91fc6346477a0e810b735c276ab85d9))
- add iconScale option to scale icon sizes in symbol layers ([58cc1ff](https://github.com/versatiles-org/versatiles-style/commit/58cc1ff5d8c968364926a9a873a9cdac70b7b020))

### Bug Fixes

- fall back across name/name_en/name_<lang> for label text-field ([d734120](https://github.com/versatiles-org/versatiles-style/commit/d734120ce3e5c03efaf2b2dc57c7d5b1549e67d5))
- sort place labels by population for collision priority ([b53ea37](https://github.com/versatiles-org/versatiles-style/commit/b53ea37ff20de5895f47b2815486953b0c4e891f))
- reorder check script for improved execution flow ([eacc8eb](https://github.com/versatiles-org/versatiles-style/commit/eacc8eb7a3f11d5f398d32d31925023afb6446e2))
- render trunk roads one zoom earlier to match tile data availability ([ec736a5](https://github.com/versatiles-org/versatiles-style/commit/ec736a59894ccbbd909128aa3259836a5dd16959))
- derive housenumber colors via blend so they survive theme inversion ([fcc1815](https://github.com/versatiles-org/versatiles-style/commit/fcc18151579b8b6f501115e3343fafa695c4bf95))
- emit glyphs and sprite from satellite style with overlay disabled ([9d69de3](https://github.com/versatiles-org/versatiles-style/commit/9d69de3f73d92659c472fb0733756b833038dfdb))
- normalize attribution strings so MapLibre dedupes cosmetic duplicates ([e6d1f12](https://github.com/versatiles-org/versatiles-style/commit/e6d1f12e08940f2a6f306e346a019f9719d05b6f))

### Code Refactoring

- replace lighten/darken with blend(x, fg|bg) in colorful ([b515c9e](https://github.com/versatiles-org/versatiles-style/commit/b515c9ef67d88180a6830971621af41e09aa16aa))
- enhance documentation for color manipulation methods in Color, HSL, HSV, and RGB classes ([061f6a5](https://github.com/versatiles-org/versatiles-style/commit/061f6a54fce6ea46fe2982cd3348368842070068))

### Documentation

- add recommended icon sources to README, close #96 ([147328c](https://github.com/versatiles-org/versatiles-style/commit/147328cdcd4b3785fa1c84efb3df16a44de2738e))

### Chores

- update dependencies to latest versions ([d9ee972](https://github.com/versatiles-org/versatiles-style/commit/d9ee9722e12201a4693f88ec8282e580391787fc))

## [5.11.0] - 2026-05-08

### Features

- add elevation support with terrain and hillshade options ([6ef75eb](https://github.com/versatiles-org/versatiles-style/commit/6ef75eb8d9a09f3db5042773227e3883d3794fa3))

### Bug Fixes

- update default hillshade exaggeration ([90e454f](https://github.com/versatiles-org/versatiles-style/commit/90e454f3731619207cfd8d1d62edec4bf74e4d39))

### Code Refactoring

- update TypeScript configuration and improve layer definitions ([3ef41c3](https://github.com/versatiles-org/versatiles-style/commit/3ef41c3cf27a78cef7c56efa9f494445dec5dc96))

### Build System

- **deps:** bump actions/upload-pages-artifact in the action group ([5dbfabd](https://github.com/versatiles-org/versatiles-style/commit/5dbfabd6c5bd6264d60aff2ae72072977de10e8a))

### Chores

- update dependencies in package.json ([443fddd](https://github.com/versatiles-org/versatiles-style/commit/443fddd274c997d30b74937466ceb0a1a4f1511c))

### Other Changes

- +label-street-track ([78421f4](https://github.com/versatiles-org/versatiles-style/commit/78421f4e48943b7adc23ca24dcfcce7a01c3760a))
- fix test after adding missing label for tracks ([2c2573e](https://github.com/versatiles-org/versatiles-style/commit/2c2573e4b5b4961ad3c6e65683569cdf99129249))

## [5.10.2] - 2026-04-05

### Bug Fixes

- add index signature to StyleBuilderOptions and SatelliteStyleOptions interfaces

## [5.10.1] - 2026-04-04

### Bug Fixes

- remove center property from satellite source configuration

### Build System

- **deps:** bump the action group with 2 updates

### Chores

- update dependencies and devDependencies in package.json
- update dependencies in package.json

## [5.10.0] - 2026-03-12

### Features

- add support for terrain and hillshade layers in satellite style
- add initial HTML structure, main TypeScript logic, and Vite configuration for development
- add local sprites plugin to serve asset sprites from the release directory
- implement style variants management and update style selection in UI
- add terrain style variants for satellite rendering
- add tile_schema and encoding properties to TileJSONSpecificationRaster interface
- enhance elevation source handling in buildSatelliteStyle function
- add maplibre-gl dependency to package.json and package-lock.json
- add navigation control to the map on initialization
- enhance TileJSON specification with encoding and tile size properties

### Bug Fixes

- update script type and await style initialization in getStylePage function
- update style restoration to use query parameters instead of hash
- update check script to include typecheck command
- update type declarations to use 'any' for compatibility and add tsconfig for dev environment
- add exclusion for TypeScript files in tsconfig
- remove debug log for style loading in loadStyle function
- replace 'any' type with specific type for maplibregl and map variable
- remove exaggerated hillshade option and set default interpolation for hillshade-exaggeration
- change terrain variable from let to const for better immutability
- update hillshade-exaggeration to use interpolation for better zoom handling
- update format script to include log level for prettier
- improve hillshade layer configuration with customizable properties

### Code Refactoring

- remove unused server and MIME type handling code

### Chores

- update dependencies in package.json
- update dependencies to latest versions
- update @types/node to version 25.5.0

### Styles

- standardize HTML structure and formatting in index.html

## [5.9.5] - 2026-03-01

### Bug Fixes

- update test scripts and add end-to-end tests for style object validation
- update CI workflows to run all tests and add end-to-end testing step
- remove unnecessary initialization of saturation variable in HSL conversion
- update import statement for brace expansion and adjust usage in decorate function
- update brace-expansion and other dependencies in package.json
- remove unused inquirer types from dependencies in package.json
- add tslib as a dependency in package.json and package-lock.json

### Build System

- **deps:** bump the npm group with 11 updates

### Chores

- update dependencies and devDependencies in package.json

## [5.9.4] - 2026-02-15

### Bug Fixes

- update badge labels in README for consistency
- reorder build step in release workflow for improved execution
- add verification step for sprites.tar.gz size in release workflow
- remove redundant browser test for style object
- prevent tests from modifying the release directory by mocking fs methods
- update satellite style bounds and center coordinates for accuracy
- simplify mock implementations in sprite generation tests

### Chores

- update dependencies in package.json

## [5.9.3] - 2026-02-10

### Bug Fixes

- use await for satellite style rendering in screenshots script
- update rasterTilejson URLs to use baseUrl resolution

## [5.9.2] - 2026-02-10

### Bug Fixes

- update satellite style functions to use async/await, fetch TileJSON as a source and improve test cases

## [5.9.1] - 2026-02-09

### Bug Fixes

- remove src directory from files in package.json
- add CHANGELOG.md to .prettierignore
- add TypeScript configuration for documentation generation
- streamline testing steps in release workflow
- update bounds for raster source in buildSatelliteStyle function

## [5.9.0] - 2026-02-06

### Features

- add initial Vitest configuration for testing coverage
- add satellite style with customizable options and tests
- add satellite style option to StyleName and update config
- add satellite style to README and update screenshot rendering
- update satellite style

### Bug Fixes

- add .claude to .gitignore
- update node version range in devEngines to support up to 25.0.0
- improve error messages for unsupported types in deepClone and isBasicType functions
- enhance error messages
- improve error handling for unknown layer types in StyleBuilder
- add .vscode to .gitignore
- remove unreachable code in deepMerge
- update node version range in devEngines
- update @maplibre/maplibre-gl-style-spec and @types/node to latest versions
- correct comparison operators for gamma and contrast in recolor function
- improve error message for invalid vector layers
- replace ts-expect-error with type assertions for layer properties
- enforce strict equality checks in multiple files
- improve error handling in isVectorLayers function
- update satellite style tile URLs and rename option

### Performance Improvements

- pre-parse tint/blend colors in CachedRecolor constructor

### Code Refactoring

- remove build step from pre-push hook
- rename validation function for active recolor options
- remove unused toRGB() and toHSL() methods
- simplify StyleBuilderColorKey definition using const assertion
- streamline style name handling and update index page links

### Tests

- add color transformation methods tests for gamma, contrast, tint, blend, and setHue
- add edge cases for tint and blend methods in RGB class
- improve color transformation tests
- add additional tests for randomColor luminosity and saturation options
- add comprehensive tests for deepMerge functionality

### Build System

- **deps-dev:** bump the npm group with 12 updates
- **deps-dev:** bump tar from 7.5.3 to 7.5.6
- **deps-dev:** bump the npm group with 10 updates
- **deps:** update @types/node, @versatiles/release-tool, and esbuild to latest versions

### Chores

- update package.json dependencies
- update dependencies to latest versions