27 KiB
13.27.0
Bug fixes 🐞
- Fix overwriting all feature ids while setting promoteIds on other layers with an object. (#12322) (h/t yongjun21)
13.26.0
Features ✨
Bug fixes 🐞
- Fix a bug where
idexpression didn't correctly handle a value of 0. (#12000)
13.25.0
Features ✨
- Extend atmospheric
fogwith three new style specification properties:high-color,space-colorandstar-intensityto allow the design of atmosphere around the globe and night skies. (#11590) - Add a new line layer paint property in the style specification:
line-trim-offsetthat can be used to create a custom fade out with improved update performance overline-gradient. (#11570)
🐞 Bug fixes
- Add
sourcefield requirement to terrain exaggeration in the style specification. (#11664)
13.24.0
🐞 Bug fixes
- Fix error on
gl-style-validatescript. (#11538) - Allow the second argument to the
inexpression operator to be an empty string. (#11547) - Fix error on some valid
filterexpressions. (#11475)
13.23.1
✨ Features and improvements
- Improve
coalesceexpressions to return aResolvedImagewhen images are missing. (#11371)
13.23.0
✨ Features and improvements
- Add a
projectionroot property that allows a non-mercator projection to be set as a style's default projection. (#11124) - Add support for using
["pitch"]and["distance-from-camera"]expressions within thefilterof a symbol layer. (#10795)
13.22.0
✨ Features and improvements
- Added
protectedfield to mapbox-api-supported validation. (#10968)
13.21.0
✨ Features and improvements
- Add support for
text-writing-modeproperty when usingsymbol-placement: linetext labels. (#10647)- Note: This change will bring following changes for CJK text block:
-
- For vertical CJK text, all the characters including Latin and Numbers will be vertically placed now. Previously, Latin and Numbers are horizontally placed.
-
- For horizontal CJK text, it may have a slight horizontal shift due to the anchor shift.
-
- Note: This change will bring following changes for CJK text block:
13.20.1
🐞 Bug fixes
- Increase strictness of the style API validation for source types (#10779)
- Remove strictly-increasing requirement for fog range validation (#10772)
13.20.0
✨ Features and improvements
- Add configurable fog as a root style specification (#10564)
- Add support for data-driven expressions in
line-dasharrayandline-capproperties. (#10591) - Add support for data-driven
text-line-height(#10612)
13.19.0
✨ Features and improvements
- Added array support to minimums and maximums, allowing for validation of multi-dimensional style-spec value constraints. (#10272)
13.18.1
🐞 Bug fixes
- Fixed a bug where
map.setStylecouldn't be used to enable terrain. (#10177)
13.18.0
✨ Features and improvements
- Add 3D terrain feature. All layer types and markers can now be extruded using the new
terrainroot level style-spec property or with the functionmap.setTerrain(). (#1489) - Add support for unlocked pitch up to 85° (previously 60°). (#3731)
- Add a new sky layer acting as an infinite background above the horizon line. This layer can be used from the style-spec and has two types:
atmosphericandgradient.
13.17.0
✨ Features and improvements
- Add a
filteroption for GeoJSON sources to filter out features prior to processing (e.g. before clustering). #9864
13.16.0
✨ Features and improvements
-
Added
volatilesource property to control storing the tiles in local storage. (9702) -
Added
clusterMinPointsoption for clustered GeoJSON sources that defines the minimum number of points to form a cluster. (#9748)
13.15.0
✨ Features and improvements
- Add
distanceexpression tostyle-spec. This expression returns the shortest distance between a feature and an input geometry (#9655)
13.14.0
✨ Features and improvements
- Add
index-ofandsliceexpressions to search arrays and strings for the first occurrence of a specified value and return a section of the original array or string (#9450) (h/t lbutler)
13.13.1
✨ Features and improvements
- Expose
expression.isExpressionFilter(..)from the bundle. (#9530)
🐛 Bug fixes
- Fix a broken module import where the
style-specpackage was importing files frommapbox-gl-js, it's parent repo, causing downstream build systems to break. (#9522)
13.13.0
✨ Features and improvements
- Add
withinexpression for testing whether an evaluated feature lies within a given GeoJSON object (#9352). For example:
"icon-opacity": ["case", ["==", ["within", "some-polygon"], true], 1, ["==", ["within", "some-polygon"], false], 0] - Improve scaling of patterns used in
line-patternon all device resolutions and pixel ratios (#9266)
🐛 Bug fixes
- Allow needle argument to
inexpression to be false (#9295) - Fix a bug where
icon-imageexpression that evaluates to an empty string ('') produced a warning (#9380) - Prevent exception resulting from
line-dash-arrayof empty length (#9385)
13.12.0
13.11.0
✨ Features and improvements
- Add
promoteIdoption to use a feature property as ID for feature state (#8987) - Update
symbol-avoid-edgesdocumentation regarding global collision detection (#9157) - Remove reference to
infunction which has been replaced by theinexpression (#9102)
🐛 Bug fixes
- Fix bug where
symbol-sort-keywas not used for collisions that crossed tile boundaries (#9054)
13.10.2
🐛 Bug fixes
- Fix style validation error messages not being displayed (#9073)
13.10.0
✨ Features and improvements
- Add ability to insert images into text labels using an
imageexpression within aformatexpression:"text-field": ["format", "Some text", ["image", "my-image"], "some more text"](#8904) - Add
inexpression. It can check if a value is in an array (["in", value, array]) or a substring is in a string (["in", substring, string]) (#8876) - Add support for stretchable images (aka nine-part or nine-patch images). Stretchable images can be used with
icon-text-fitto draw resized images with unstretched corners and borders. (#8997) - Add an es modules build of for mapbox-gl-style-spec in dist/ (#8247) (h/t ahocevar)
13.9.1
✨ Improvement
- Rename
Imagetype toResolvedImage, to better represent the result of animageexpression evaluation. (#8901)
13.9.0
- Add
imageexpression operator to determine image availability (#8684) - Add a style-spec function to validate that styles are compatible with the Mapbox API (#8663)
13.8.0
- Introduce
text-writing-modesymbol layer property to allow placing point labels vertically. #8399 - Allow
text-colorto be used in formatted expressions to be able to draw different parts of a label in different colors. #8068 - Improve conversion of legacy filters with duplicate values. #8542
13.7.2
🐛 Bug fixes
- Fix SDK support spec section for variable label placement (#8384) (h/t @pozdnyakov)
✨ Features and improvements
- Add SDK support spec section for text-radial-offset (#8401)
- Add
*-sort-keylayout property for circle, fill, line (#8467) - Expose convertFilter API in the style specification (#8493)
13.7.1
🐛 Bug fixes
- Fix format expression options validation (#8339)
- Fix SDK support information for style properties added in v13.7.0: (#8384)
- Add missing SDK support section for
text-radial-offsetproperty - Assign SDK versions for
text-variable-anchorandtext-justify: auto
- Add missing SDK support section for
13.7.0
✨ Features and improvements
- Add
text-radial-offsetstyle property (#7596) - Add
text-variable-anchorstyle property (#7596) - Add
autovalue totext-justifystyle property (#7596)
13.6.0
✨ Features and improvements
- Add
clusterPropertiesoption for aggregated cluster properties (#2412, fixed by #7584) - Add
number-formatexpression (#7626) - Add
symbol-sort-keystyle property (#7678)
13.5.0
Features and improvements
13.4.0
✨ Features and improvements
- Tighten style validation
13.3.0
🐛 Bug fixes
- Expressions
- Fix
letexpression stripping expected type during parsing (#7300, fixed by #7301) - Fix superfluous wrapping of literals in
literalexpression (#7336, fixed by #7337) - Allow calling
to-coloron values that are already of typeColor(#7260) - Fix
to-arrayfor empty arrays ((#7261)) - Fix identity functions for
text-fieldwhen using formatted text (#7351) - Fix coercion of
nullto0into-numberexpression (#7083, fixed by #7274)
- Fix
✨ Features and improvements
- Add
fill-extrusion-vertical-gradientproperty for controlling shading of fill extrusions (#5768, fixed by #6841)
13.2.0
🐛 Bug fixes
- Update the style-spec's old
gl-style-migratescript to include conversion of legacy functions and filters to their expression equivalents (#6927, fixed by #7095)
✨ Features and improvements
- Add
symbol-z-ordersymbol layout property to style spec (#7219) - Implement data-driven styling support for
*-pattern properties(#6289)
13.1.1
🐛 Bug fixes
✨ Features and improvements
- Improve formatting for style output (#7029)
13.1.0
✨ Features and improvements
- Add
raster-resamplingraster paint property (#6411) (h/t andrewharvey) - Add
symbol-placement: line-center(#6821)
13.0.1
⚠️ Breaking changes
- Align implicit type behavior of
matchexpressions with withcase/==(#6684) - Update spec so that documentation can automatically capture which functions and expressions can be used with which properties (#6521)
✨ Features and improvements
- Add
feature-state#6263 - Add support for GeoJSON attribution (#6364) (h/t andrewharvey)
- Upgrade to Flow 0.69 (#6594)
🐛 Bug fixes
- Use named exports for style-spec entrypoint module (#6601
13.0.0
Malformed package published to NPM.
12.0.0
⚠️ Breaking changes
- The
"to-string"expression operator now converts null to an empty string rather than to"null". #6534
✨ Features and improvements
- 🌈 Add line-gradient property #6303
- Add collator expression for controlling case and diacritic sensitivity in string comparisons #6270
- Add
is-supported-scriptexpression for determining if a script is supported. #6260 - Add
collatorexpression for controlling case and diacritic sensitivity in string comparisons #6270 - Add
abs,round,floor, andceilexpression operators #6496 - Add support for Mapzen Terrarium tiles in raster-dem sources #6110
🐛 Bug fixes
- Fix Rollup build 6575
11.1.1
🐛 Bug fixes
- Update SDK support information for
text-font, andheatmap-color, andhillshadelayer properties.
11.1.0
✨ Features and improvements
- Avoid use of
new Functionfor filters by converting old-style filters to expressions #5665.
11.0.0
⚠️ Breaking changes
- Remove constants validating code #5885
"colorSpace": "hcl"now uses shortest-path interpolation for hue #5811
✨ Features and improvements
- Introduce client-side hillshading with
raster-demsource type andhillshadelayer type #5286 - Add Color#toString and expose Color publicly #5866
- Improve typing for
==and!=expressions #5840 - Made
coalesceexpressions more useful #5755 - Enable implicit type assertions for array types #5738
🐛 Bug fixes
- Fix standalone browser build #5736, #5906
- Handle NaN as input to step and interpolate expressions #5757
- Fix style diffing for changes to GeoJSON sources #5745
- Mark layer "type" property as required #5849
10.1.0
- Remove support for validating and migrating v6 styles #5604
- Remove support for validating v7 styles #5604
- Remove spaces after commas in
to-stringrepresentation of colors #5480 - Fix bugs preventing
mapbox-gl-style-specpackage on NPM from being used externally #5502 - Fix flow-typed interface generator #5478
- Export
function#5584 - Export
StylePropertySpecificationtype #5593 - Split the
source_tileentry in the JSON schema intosource_vectorandsource_raster#5604
Validation Changes
- Require that
heatmap-coloruse expressions instead of stop functions #5624 - Remove support for including
{tokens}in expressions fortext-fieldandicon-image#5599 - Disallow interpolation in expressions for
line-dasharray#5519 - Validate that zoom expressions only appear at the top level of an expression #5609
- Validate that
stepandinterpolateexpressions don't have any duplicate stops #5605 - Split
curveexpression intostepandinterpolateexpressions #5542 - Validate expression values for enum-typed properties #5589
- Improve validation to catch uses of deprecated function syntax #5667
10.0.1
- Fix bug preventing @mapbox/mapbox-gl-style-spec package from being usable outside of mapbox-gl-js (#5502)
10.0.0
- Add expression and heatmap layer support. See Mapbox GL JS v0.40.1 changelog entry for details.
9.0.1
- Remove
fast-stable-stringifydependency (#5152)
9.0.0
- Fix validation error on categorical zoom-and-property functions (#4220)
- Relax requirement that styles using "icon-image" must have a "sprite"
- Prevent infinite loop in binarySearchForIndex when duplicate stops are present. (#4503)
- Ensure generated composite function stops are in the correct order (#4509)
- Update SDK support matrices to be current as of GL JS v0.35.1, iOS SDK v3.5.0, Android SDK 5.0.0
- Remove support for implicitly-categorical functions
- BREAKING CHANGE: the API for the
functionmodule has changed. Theinterpolatedandpiecewise-constantexports were replaced with a single unnamed export, a function which accepts an object conforming to the style spec "function" definition, and an object defining a style spec property. It handles color parsing and validation of feature values internally. - Functions now support a "default" property.
parseColorwas promoted from gl-js.
8.11.0
- Merge
feature-filterrepository into this repository #639
8.10.0
v8.0.0 styles are fully compatible with v8.10.0.
Style Specification Changes
- Added
colorSpaceoption to functions - Added
fill-extrusionlayer type - Add top-level
lightproperty - Remove increase maximum
maxzoomto 24 - Deprecate paint classes ⚠️
- Increase strictness of function validation
Reference JSON & API Changes
- Added
derefutility - Added
group_by_layoututility - Merge
mapbox-gl-functionrepository into this repository
8.9.0
v8.0.0 styles are fully compatible with v8.9.0.
- Added identity functions
- Added
autovalue which represents the calculated default value
8.8.1
v8.0.0 styles are fully compatible with v8.8.1.
- Fixed style validation for layers with invalid types
8.8.0
v8.0.0 styles are fully compatible with v8.8.0.
- Clarified documentation around fill-opacity.
- Update function documentation and validation for property functions.
- Add text-pitch-alignment property.
- Add icon-text-fit, icon-text-fit-padding properties.
8.7.0
v8.0.0 styles are fully compatible with v8.7.0.
- Add support for has / !has operators.
8.6.0
v8.0.0 styles are fully compatible with v8.6.0.
- Added support for zoom and feature driven functions.
8.4.2
v8.0.0 styles are fully compatible with v8.4.2.
- Refactored style validator to expose more granular validation methods
8.4.1
v8.0.0 styles are fully compatible with v8.4.1.
- Revert ramp validation checks that broke some styles.
8.4.0
v8.0.0 styles are fully compatible with v8.4.0.
- Added
cluster,clusterRadius,clusterMaxZoomGeoJSON source properties.
8.3.0
v8.0.0 styles are fully compatible with v8.3.0.
- Added
line-offsetstyle property
8.2.1
v8.0.0 styles are fully compatible with v8.2.1.
- Enforce that all layers that use a vector source specify a "source-layer"
8.2.0
v8.0.0 styles are fully compatible with v8.2.0.
- Add inline
exampleproperty. - Enforce that all style properties must have documentation in
docproperty. - Create minified style specs with
docandexampleproperties removed. validatenow validates against minified style spec.formatnow acceptsspaceoption to use withJSON.stringify.- Remove
gl-style-spritify. Mapbox GL sprites are now created automatically by the Mapbox style APIs, or for hand-crafted styles, by spritezero-cli.
8.1.0
v8.0.0 styles are fully compatible with v8.1.0.
- [BREAKING] Simplified layout/paint layer property types to more closely align with v7 types.
- Fixed migration script compatibility with newer versions of Node.js and io.js
- Removed
constantsfrom schema, they were deprecated in v8 - Added style diff utility to generate semantic deltas between two stylesheets
- Added
visibilityproperty tocirclelayer type - Added
pitchproperty to stylesheet
8.0.0
Introduction of Mapbox GL style specification v8. To migrate a v7 style to v8,
use the gl-style-migrate script as described in the README.
- [BREAKING] The value of the
text-fontproperty is now an array of strings, rather than a single comma separated string. - [BREAKING] Renamed
symbol-min-distancetosymbol-spacing. - [BREAKING] Renamed
background-imagetobackground-pattern. - [BREAKING] Renamed
line-imagetoline-pattern. - [BREAKING] Renamed
fill-imagetofill-pattern. - [BREAKING] Renamed the
urlproperty of the video source type tourls. - [BREAKING] Coordinates in video sources are now specified in [lon, lat] order.
- [BREAKING] Removed
text-max-sizeandicon-max-sizeproperties; these are now calculated automatically. - [BREAKING]
text-sizeandicon-sizeare now layout properties instead of paint properties. - [BREAKING] Constants are no longer supported. If you are editing styles by hand and want to use constants, you can use a preprocessing step with a tool like ScreeSS.
- [BREAKING] The format for
mapbox://glyphs URLs has changed; you should now usemapbox://fonts/mapbox/{fontstack}/{range}.pbf. - [BREAKING] Reversed the priority of layers for calculating label placement: labels for layers that appear later in the style now have priority over earlier layers.
- Added a new
imagesource type. - Added a new
circlelayer type. - Default map center location can now be set in the style.
- Added
mapbox://sprite URLsmapbox://sprite/{user | "mapbox"}/{id}
7.5.0
- Added gl-style-composite script, for auto-compositing sources in a style.
7.4.1
- Use JSON.stringify for formatting instead of js-beautify
7.0.0
Introduction of Mapbox GL style specification v7.
- [BREAKING] Improve dashed lines (#234)
- [BREAKING] Remove prerendered layers (#232)
- Explicit visibility property (#212)
- Functions for all properties (#237)
6.0.0 (Style spec v6)
Introduction of Mapbox GL style specification v6.
- [BREAKING] New filter syntax (#178)
- [BREAKING] Line gap property (#131)
- [BREAKING] Remove dashes from min/max-zoom (#175)
- [BREAKING] New layout/paint terminology (#166)
- [BREAKING] Single text positioning property (#197)
- Added requirements (#200)
- Added minimum, maximum, and period values (#198)
0.0.5 (in progress)
- [BREAKING] Switch to suffix for transition properties (
transition-*->*-transition). - Added support for remote, non-Mapbox TileJSON sources.
- [BREAKING] Source
minZoomandmaxZoomrenamed tominzoomand `maxzoom to match TileJSON. - Added support for
mapbox://glyph URLs. - [BREAKING] Renamed
raster-fadetoraster-fade-duration. - Added background-opacity property.
- Added "tokens" property to string values that can autocomplete fields from layers
- Added "units" property to describe value types
0.0.4 (Aug 8 2014)
- Initial public release