@versatiles/png-renderer 2.4.1 → 2.5.0

package/dist/index.d.ts

@@ -2,8 +2,6 @@
 import { Canvas } from '@napi-rs/canvas';
 export { Canvas } from '@napi-rs/canvas';
 
-//#endregion
-//#region src/types.g.d.ts
 type ColorSpecification = string;
 type ProjectionDefinitionT = [string, string, number];
 type ProjectionDefinitionSpecification = string | ProjectionDefinitionT | PropertyValueSpecification<ProjectionDefinitionT>;
@@ -209,7 +207,7 @@ type StyleSpecification = {
    */
   "roll"?: number;
   /**
-   * An object used to define default values when using the [`global-state`](https://maplibre.org/maplibre-style-spec/expressions/#global-state) expression.
+   * An object used to define default values when using the [`global-state`](expressions/#global-state) expression.
    *
    * @default
    * ```json
@@ -292,7 +290,7 @@ type StyleSpecification = {
   /**
    * Sources state which data the map should display. Specify the type of source with the `type` property. Adding a source isn't enough to make data appear on the map because sources don't contain styling details like color or width. Layers refer to a source and give it a visual representation. This makes it possible to style the same source in different ways, like differentiating between types of roads in a highways layer.
    *
-   * Tiled sources (vector and raster) must specify their details according to the [TileJSON specification](https://github.com/mapbox/tilejson-spec).
+   * Tiled sources (vector and raster) must specify their details according to [TileJSON](tilejson.md).
    *
    * @example
    * ```json
@@ -338,7 +336,7 @@ type StyleSpecification = {
   /**
    * A URL template for loading signed-distance-field glyph sets in PBF format.
    *
-   * If this property is set, any text in the `text-field` layout property is displayed in the font stack named by the `text-font` layout property based on glyphs located at the URL specified by this property. Otherwise, font faces will be determined by the `text-font` property based on the local environment.
+   * If this property is set, any text in the [`text-field`](layers/#text-field) layout property is displayed in the font stack named by the [`text-font`](layers/#text-font) layout property based on glyphs located at the URL specified by this property. Otherwise, font faces will be determined by the `text-font` property based on the local environment.
    *
    * The URL must include:
    *
@@ -581,7 +579,19 @@ type VectorSourceSpecification = {
    */
   "url"?: string;
   /**
-   * An array of one or more tile source URLs, as in the TileJSON spec.
+   * An array of one or more tile source URLs, as in the TileJSON spec. These tokens in a URL are replaced for each tile:
+   *
+   *  - `{z}`, `{x}` and `{y}` - The tile's zoom level, column and row. With `scheme` set to `tms`, the row counts from the bottom.
+   *
+   *  - `{quadkey}` - The tile's quadkey, as Bing Maps addresses tiles.
+   *
+   *  - `{bbox-epsg-3857}` - The tile's bounding box in EPSG:3857 meters, as `minX,minY,maxX,maxY`, for WMS requests.
+   *
+   *  - `{bbox}` - Experimental. The tile's bounding box as `minX,minY,maxX,maxY` in the units of the map's coordinate system. With the `mercator`, `globe` and `vertical-perspective` projections this is the same as `{bbox-epsg-3857}`.
+   *
+   *  - `{prefix}` - Two hexadecimal digits from the tile's column and row, to spread requests over host names.
+   *
+   *  - `{ratio}` - `@2x` where the device pixel ratio is above 1, empty otherwise.
    */
   "tiles"?: Array<string>;
   /**
@@ -602,6 +612,15 @@ type VectorSourceSpecification = {
    * ```
    */
   "scheme"?: "xyz" | "tms";
+  /**
+   * Experimental. What an empty tile response (HTTP 204, or no tile data from an archive such as PMTiles) means in this tileset.
+   *
+   * @default
+   * ```json
+   * "blank"
+   * ```
+   */
+  "emptyResponse"?: "blank" | "missing";
   /**
    * Minimum zoom level for which tiles are available, as in the TileJSON spec.
    */
@@ -647,7 +666,19 @@ type RasterSourceSpecification = {
    */
   "url"?: string;
   /**
-   * An array of one or more tile source URLs, as in the TileJSON spec.
+   * An array of one or more tile source URLs, as in the TileJSON spec. These tokens in a URL are replaced for each tile:
+   *
+   *  - `{z}`, `{x}` and `{y}` - The tile's zoom level, column and row. With `scheme` set to `tms`, the row counts from the bottom.
+   *
+   *  - `{quadkey}` - The tile's quadkey, as Bing Maps addresses tiles.
+   *
+   *  - `{bbox-epsg-3857}` - The tile's bounding box in EPSG:3857 meters, as `minX,minY,maxX,maxY`, for WMS requests.
+   *
+   *  - `{bbox}` - Experimental. The tile's bounding box as `minX,minY,maxX,maxY` in the units of the map's coordinate system. With the `mercator`, `globe` and `vertical-perspective` projections this is the same as `{bbox-epsg-3857}`.
+   *
+   *  - `{prefix}` - Two hexadecimal digits from the tile's column and row, to spread requests over host names.
+   *
+   *  - `{ratio}` - `@2x` where the device pixel ratio is above 1, empty otherwise.
    */
   "tiles"?: Array<string>;
   /**
@@ -673,7 +704,7 @@ type RasterSourceSpecification = {
    */
   "maxzoom"?: number;
   /**
-   * The minimum visual size to display tiles for this layer. Only configurable for raster layers.
+   * The minimum visual size to display tiles for this source.
    *
    * @default
    * ```json
@@ -690,6 +721,15 @@ type RasterSourceSpecification = {
    * ```
    */
   "scheme"?: "xyz" | "tms";
+  /**
+   * Experimental. What an empty tile response (HTTP 204, or no tile data from an archive such as PMTiles) means in this tileset.
+   *
+   * @default
+   * ```json
+   * "blank"
+   * ```
+   */
+  "emptyResponse"?: "blank" | "missing";
   /**
    * Contains an attribution to be displayed when the map is shown to a user.
    */
@@ -709,7 +749,19 @@ type RasterDEMSourceSpecification = {
    */
   "url"?: string;
   /**
-   * An array of one or more tile source URLs, as in the TileJSON spec.
+   * An array of one or more tile source URLs, as in the TileJSON spec. These tokens in a URL are replaced for each tile:
+   *
+   *  - `{z}`, `{x}` and `{y}` - The tile's zoom level, column and row.
+   *
+   *  - `{quadkey}` - The tile's quadkey, as Bing Maps addresses tiles.
+   *
+   *  - `{bbox-epsg-3857}` - The tile's bounding box in EPSG:3857 meters, as `minX,minY,maxX,maxY`, for WMS requests.
+   *
+   *  - `{bbox}` - Experimental. The tile's bounding box as `minX,minY,maxX,maxY` in the units of the map's coordinate system. With the `mercator`, `globe` and `vertical-perspective` projections this is the same as `{bbox-epsg-3857}`.
+   *
+   *  - `{prefix}` - Two hexadecimal digits from the tile's column and row, to spread requests over host names.
+   *
+   *  - `{ratio}` - `@2x` where the device pixel ratio is above 1, empty otherwise.
    */
   "tiles"?: Array<string>;
   /**
@@ -735,7 +787,7 @@ type RasterDEMSourceSpecification = {
    */
   "maxzoom"?: number;
   /**
-   * The minimum visual size to display tiles for this layer. Only configurable for raster layers.
+   * The minimum visual size to display tiles for this source.
    *
    * @default
    * ```json
@@ -743,6 +795,15 @@ type RasterDEMSourceSpecification = {
    * ```
    */
   "tileSize"?: number;
+  /**
+   * Experimental. What an empty tile response (HTTP 204, or no tile data from an archive such as PMTiles) means in this tileset.
+   *
+   * @default
+   * ```json
+   * "blank"
+   * ```
+   */
+  "emptyResponse"?: "blank" | "missing";
   /**
    * Contains an attribution to be displayed when the map is shown to a user.
    */
@@ -876,7 +937,7 @@ type GeoJSONSourceSpecification = {
    */
   "clusterProperties"?: unknown;
   /**
-   * Whether to calculate line distance metrics. This is required for line layers that specify `line-gradient` values.
+   * Whether to calculate line distance metrics. This is required for line layers that specify [`line-gradient`](layers/#line-gradient) values.
    */
   "lineMetrics"?: boolean;
   /**
@@ -949,7 +1010,7 @@ type FillLayerSpecification = {
    */
   "maxzoom"?: number;
   /**
-   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The `feature-state` expression is not supported in filter expressions.
+   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The [`feature-state`](expressions/#feature-state) expression is not supported in filter expressions.
    */
   "filter"?: FilterSpecification;
   /**
@@ -984,7 +1045,7 @@ type FillLayerSpecification = {
      */
     "fill-antialias"?: PropertyValueSpecification<boolean>;
     /**
-     * The opacity of the entire fill layer. In contrast to the `fill-color`, this value will also affect the 1px stroke around the fill, if the stroke is used.
+     * The opacity of the entire fill layer. In contrast to the [`fill-color`](layers/#fill-color), this value will also affect the 1px stroke around the fill, if the stroke is used.
      *
      * @default
      * ```json
@@ -994,7 +1055,7 @@ type FillLayerSpecification = {
     "fill-opacity"?: DataDrivenPropertyValueSpecification<number>;
     "fill-opacity-transition"?: TransitionSpecification;
     /**
-     * Opacity applied to the layer as a whole. Unlike `fill-opacity` and alpha values in `fill-color`, which are applied per feature and accumulate where fills overlap, `fill-layer-opacity` is applied once so overlapping fills appear as a single surface at the given opacity. When both `fill-opacity` and `fill-layer-opacity` are set, the per-feature, overlap accumulation is preserved, then `fill-layer-opacity` composites the result. This property affects only the layer it is set on and cannot be used to composite multiple layers together or control how this layer blends with layers above or below it.
+     * Opacity applied to the layer as a whole. Unlike [`fill-opacity`](layers/#fill-opacity) and alpha values in [`fill-color`](layers/#fill-color), which are applied per feature and accumulate where fills overlap, `fill-layer-opacity` is applied once so overlapping fills appear as a single surface at the given opacity. When both `fill-opacity` and `fill-layer-opacity` are set, the per-feature, overlap accumulation is preserved, then `fill-layer-opacity` composites the result. This property affects only the layer it is set on and cannot be used to composite multiple layers together or control how this layer blends with layers above or below it.
      *
      * ![fill-opacity vs. fill-layer-opacity](assets/fill-layer-opacity.svg)
      *
@@ -1005,6 +1066,17 @@ type FillLayerSpecification = {
      */
     "fill-layer-opacity"?: PropertyValueSpecification<number>;
     "fill-layer-opacity-transition"?: TransitionSpecification;
+    /**
+     * Controls how the layer is composited with the content already rendered beneath it. Unlike per-feature opacity properties such as `fill-opacity`, this property affects the final composited layer output and determines how it interacts with the existing map contents.
+     *
+     * ![fill-layer-blend examples](assets/fill-layer-blend.svg)
+     *
+     * @default
+     * ```json
+     * "normal"
+     * ```
+     */
+    "fill-layer-blend"?: "normal" | "multiply" | "color" | "luminosity" | "plus-lighter" | "screen" | "overlay";
     /**
      * The color of the filled part of this layer. This color can be specified as `rgba` with an alpha component and the color's opacity will not affect the opacity of the 1px stroke, if it is used. When used with an SDF fill pattern, this serves as the foreground color of the pattern.
      *
@@ -1016,7 +1088,7 @@ type FillLayerSpecification = {
     "fill-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>;
     "fill-color-transition"?: TransitionSpecification;
     /**
-     * The outline color of the fill. Matches the value of `fill-color` if unspecified.
+     * The outline color of the fill. Matches the value of [`fill-color`](layers/#fill-color) if unspecified.
      */
     "fill-outline-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>;
     "fill-outline-color-transition"?: TransitionSpecification;
@@ -1031,7 +1103,7 @@ type FillLayerSpecification = {
     "fill-translate"?: PropertyValueSpecification<[number, number]>;
     "fill-translate-transition"?: TransitionSpecification;
     /**
-     * Controls the frame of reference for `fill-translate`.
+     * Controls the frame of reference for [`fill-translate`](layers/#fill-translate).
      *
      * @default
      * ```json
@@ -1078,7 +1150,7 @@ type LineLayerSpecification = {
    */
   "maxzoom"?: number;
   /**
-   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The `feature-state` expression is not supported in filter expressions.
+   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The [`feature-state`](expressions/#feature-state) expression is not supported in filter expressions.
    */
   "filter"?: FilterSpecification;
   /**
@@ -1150,7 +1222,7 @@ type LineLayerSpecification = {
     "line-opacity"?: DataDrivenPropertyValueSpecification<number>;
     "line-opacity-transition"?: TransitionSpecification;
     /**
-     * Opacity applied to the layer as a whole. Unlike `line-opacity` and alpha values in `line-color`, which are applied per feature and accumulate where lines overlap, `line-layer-opacity` is applied once so overlapping lines appear as a single surface at the given opacity. When both `line-opacity` and `line-layer-opacity` are set, the per-feature, overlap accumulation is preserved, then layer-opacity composites the result. This property affects only the layer it is set on and cannot be used to composite multiple layers together or control how this layer blends with layers above or below it.
+     * Opacity applied to the layer as a whole. Unlike [`line-opacity`](layers/#line-opacity) and alpha values in [`line-color`](layers/#line-color), which are applied per feature and accumulate where lines overlap, `line-layer-opacity` is applied once so overlapping lines appear as a single surface at the given opacity. When both `line-opacity` and `line-layer-opacity` are set, the per-feature, overlap accumulation is preserved, then layer-opacity composites the result. This property affects only the layer it is set on and cannot be used to composite multiple layers together or control how this layer blends with layers above or below it.
      *
      * ![line-opacity vs. line-layer-opacity](assets/line-layer-opacity.svg)
      *
@@ -1161,6 +1233,17 @@ type LineLayerSpecification = {
      */
     "line-layer-opacity"?: PropertyValueSpecification<number>;
     "line-layer-opacity-transition"?: TransitionSpecification;
+    /**
+     * Controls how the layer is composited with the content already rendered beneath it. Unlike per-feature opacity properties such as [`line-opacity`](#line-opacity), this property affects the final composited layer output and determines how it interacts with the existing map contents.
+     *
+     * ![line-layer-blend examples](assets/line-layer-blend.svg)
+     *
+     * @default
+     * ```json
+     * "normal"
+     * ```
+     */
+    "line-layer-blend"?: "normal" | "multiply" | "color" | "luminosity" | "plus-lighter" | "screen" | "overlay";
     /**
      * The color with which the line will be drawn.
      *
@@ -1182,7 +1265,7 @@ type LineLayerSpecification = {
     "line-translate"?: PropertyValueSpecification<[number, number]>;
     "line-translate-transition"?: TransitionSpecification;
     /**
-     * Controls the frame of reference for `line-translate`.
+     * Controls the frame of reference for [`line-translate`](layers/#line-translate).
      *
      * @default
      * ```json
@@ -1263,7 +1346,7 @@ type SymbolLayerSpecification = {
    */
   "maxzoom"?: number;
   /**
-   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The `feature-state` expression is not supported in filter expressions.
+   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The [`feature-state`](expressions/#feature-state) expression is not supported in filter expressions.
    */
   "filter"?: FilterSpecification;
   /**
@@ -1293,11 +1376,11 @@ type SymbolLayerSpecification = {
      */
     "symbol-avoid-edges"?: PropertyValueSpecification<boolean>;
     /**
-     * Sorts features in ascending order based on this value. Features with lower sort keys are drawn and placed first.  When `icon-allow-overlap` or `text-allow-overlap` is `false`, features with a lower sort key will have priority during placement. When `icon-allow-overlap` or `text-allow-overlap` is set to `true`, features with a higher sort key will overlap over features with a lower sort key.
+     * Sorts features in ascending order based on this value. Features with lower sort keys are drawn and placed first.  When [`icon-allow-overlap`](layers/#icon-allow-overlap) or [`text-allow-overlap`](layers/#text-allow-overlap) is `false`, features with a lower sort key will have priority during placement. When `icon-allow-overlap` or `text-allow-overlap` is set to `true`, features with a higher sort key will overlap over features with a lower sort key.
      */
     "symbol-sort-key"?: DataDrivenPropertyValueSpecification<number>;
     /**
-     * Determines whether overlapping symbols in the same layer are rendered in the order that they appear in the data source or by their y-position relative to the viewport. To control the order and prioritization of symbols otherwise, use `symbol-sort-key`.
+     * Determines whether overlapping symbols in the same layer are rendered in the order that they appear in the data source or by their y-position relative to the viewport. To control the order and prioritization of symbols otherwise, use [`symbol-sort-key`](layers/#symbol-sort-key).
      *
      * @default
      * ```json
@@ -1310,7 +1393,7 @@ type SymbolLayerSpecification = {
      */
     "icon-allow-overlap"?: PropertyValueSpecification<boolean>;
     /**
-     * Allows for control over whether to show an icon when it overlaps other symbols on the map. If `icon-overlap` is not set, `icon-allow-overlap` is used instead.
+     * Allows for control over whether to show an icon when it overlaps other symbols on the map. If `icon-overlap` is not set, [`icon-allow-overlap`](layers/#icon-allow-overlap) is used instead.
      */
     "icon-overlap"?: PropertyValueSpecification<"never" | "always" | "cooperative">;
     /**
@@ -1322,7 +1405,7 @@ type SymbolLayerSpecification = {
      */
     "icon-optional"?: PropertyValueSpecification<boolean>;
     /**
-     * In combination with `symbol-placement`, determines the rotation behavior of icons.
+     * In combination with [`symbol-placement`](layers/#symbol-placement), determines the rotation behavior of icons.
      *
      * @default
      * ```json
@@ -1349,7 +1432,7 @@ type SymbolLayerSpecification = {
      */
     "icon-text-fit"?: PropertyValueSpecification<"none" | "width" | "height" | "both">;
     /**
-     * Size of the additional area added to dimensions determined by `icon-text-fit`, in clockwise order: top, right, bottom, left.
+     * Size of the additional area added to dimensions determined by [`icon-text-fit`](layers/#icon-text-fit), in clockwise order: top, right, bottom, left.
      *
      * @default
      * ```json
@@ -1379,7 +1462,7 @@ type SymbolLayerSpecification = {
      */
     "icon-keep-upright"?: PropertyValueSpecification<boolean>;
     /**
-     * Offset distance of icon from its anchor. Positive values indicate right and down, while negative values indicate left and up. Each component is multiplied by the value of `icon-size` to obtain the final offset in pixels. When combined with `icon-rotate` the offset will be as if the rotated direction was up.
+     * Offset distance of icon from its anchor. Positive values indicate right and down, while negative values indicate left and up. Each component is multiplied by the value of [`icon-size`](layers/#icon-size) to obtain the final offset in pixels. When combined with [`icon-rotate`](layers/#icon-rotate) the offset will be as if the rotated direction was up.
      *
      * @default
      * ```json
@@ -1415,7 +1498,7 @@ type SymbolLayerSpecification = {
      */
     "text-pitch-alignment"?: PropertyValueSpecification<"map" | "viewport" | "auto">;
     /**
-     * In combination with `symbol-placement`, determines the rotation behavior of the individual glyphs forming the text.
+     * In combination with [`symbol-placement`](layers/#symbol-placement), determines the rotation behavior of the individual glyphs forming the text.
      *
      * @default
      * ```json
@@ -1477,11 +1560,11 @@ type SymbolLayerSpecification = {
      */
     "text-justify"?: DataDrivenPropertyValueSpecification<"auto" | "left" | "center" | "right">;
     /**
-     * Radial offset of text, in the direction of the symbol's anchor. Useful in combination with `text-variable-anchor`, which defaults to using the two-dimensional `text-offset` if present.
+     * Radial offset of text, in the direction of the symbol's anchor. Useful in combination with [`text-variable-anchor`](layers/#text-variable-anchor), which defaults to using the two-dimensional [`text-offset`](layers/#text-offset) if present.
      */
     "text-radial-offset"?: DataDrivenPropertyValueSpecification<number>;
     /**
-     * To increase the chance of placing high-priority labels on the map, you can provide an array of `text-anchor` locations: the renderer will attempt to place the label at each location, in order, before moving onto the next label. Use `text-justify: auto` to choose justification based on anchor position. To apply an offset, use the `text-radial-offset` or the two-dimensional `text-offset`.
+     * To increase the chance of placing high-priority labels on the map, you can provide an array of [`text-anchor`](layers/#text-anchor) locations: the renderer will attempt to place the label at each location, in order, before moving onto the next label. Use `text-justify: auto` to choose justification based on anchor position. To apply an offset, use the [`text-radial-offset`](layers/#text-radial-offset) or the two-dimensional [`text-offset`](layers/#text-offset).
      *
      * @example
      * ```json
@@ -1490,11 +1573,11 @@ type SymbolLayerSpecification = {
      */
     "text-variable-anchor"?: PropertyValueSpecification<Array<"center" | "left" | "right" | "top" | "bottom" | "top-left" | "top-right" | "bottom-left" | "bottom-right">>;
     /**
-     * To increase the chance of placing high-priority labels on the map, you can provide an array of `text-anchor` locations, each paired with an offset value. The renderer will attempt to place the label at each location, in order, before moving on to the next location+offset. Use `text-justify: auto` to choose justification based on anchor position.
+     * To increase the chance of placing high-priority labels on the map, you can provide an array of [`text-anchor`](layers/#text-anchor) locations, each paired with an offset value. The renderer will attempt to place the label at each location, in order, before moving on to the next location+offset. Use `text-justify: auto` to choose justification based on anchor position.
      *
      *  The length of the array must be even, and must alternate between enum and point entries. i.e., each anchor location must be accompanied by a point, and that point defines the offset when the corresponding anchor location is used. Positive offset values indicate right and down, while negative values indicate left and up. Anchor locations may repeat, allowing the renderer to try multiple offsets to try and place a label using the same anchor.
      *
-     *  When present, this property takes precedence over `text-anchor`, `text-variable-anchor`, `text-offset`, and `text-radial-offset`.
+     *  When present, this property takes precedence over `text-anchor`, [`text-variable-anchor`](layers/#text-variable-anchor), [`text-offset`](layers/#text-offset), and [`text-radial-offset`](layers/#text-radial-offset).
      *
      *  ```json
      *
@@ -1579,7 +1662,7 @@ type SymbolLayerSpecification = {
      */
     "text-allow-overlap"?: PropertyValueSpecification<boolean>;
     /**
-     * Allows for control over whether to show symbol text when it overlaps other symbols on the map. If `text-overlap` is not set, `text-allow-overlap` is used instead
+     * Allows for control over whether to show symbol text when it overlaps other symbols on the map. If `text-overlap` is not set, [`text-allow-overlap`](layers/#text-allow-overlap) is used instead
      */
     "text-overlap"?: PropertyValueSpecification<"never" | "always" | "cooperative">;
     /**
@@ -1591,11 +1674,11 @@ type SymbolLayerSpecification = {
      */
     "text-optional"?: PropertyValueSpecification<boolean>;
     /**
-     * The height above the anchor, in meters, at which the symbol is placed. Use `symbol-height-anchor` to control what this height is measured from.
+     * The height above the anchor, in meters, at which the symbol is placed. Use [`symbol-height-anchor`](layers/#symbol-height-anchor) to control what this height is measured from.
      */
     "symbol-height-offset"?: DataDrivenPropertyValueSpecification<number>;
     /**
-     * Defines what `symbol-height-offset` is measured from.
+     * Defines what [`symbol-height-offset`](layers/#symbol-height-offset) is measured from.
      *
      * @default
      * ```json
@@ -1670,7 +1753,7 @@ type SymbolLayerSpecification = {
     "icon-translate"?: PropertyValueSpecification<[number, number]>;
     "icon-translate-transition"?: TransitionSpecification;
     /**
-     * Controls the frame of reference for `icon-translate`.
+     * Controls the frame of reference for [`icon-translate`](layers/#icon-translate).
      *
      * @default
      * ```json
@@ -1729,7 +1812,7 @@ type SymbolLayerSpecification = {
     "text-translate"?: PropertyValueSpecification<[number, number]>;
     "text-translate-transition"?: TransitionSpecification;
     /**
-     * Controls the frame of reference for `text-translate`.
+     * Controls the frame of reference for [`text-translate`](layers/#text-translate).
      *
      * @default
      * ```json
@@ -1771,7 +1854,7 @@ type CircleLayerSpecification = {
    */
   "maxzoom"?: number;
   /**
-   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The `feature-state` expression is not supported in filter expressions.
+   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The [`feature-state`](expressions/#feature-state) expression is not supported in filter expressions.
    */
   "filter"?: FilterSpecification;
   /**
@@ -1842,7 +1925,7 @@ type CircleLayerSpecification = {
     "circle-translate"?: PropertyValueSpecification<[number, number]>;
     "circle-translate-transition"?: TransitionSpecification;
     /**
-     * Controls the frame of reference for `circle-translate`.
+     * Controls the frame of reference for [`circle-translate`](layers/#circle-translate).
      *
      * @default
      * ```json
@@ -1869,7 +1952,7 @@ type CircleLayerSpecification = {
      */
     "circle-pitch-alignment"?: PropertyValueSpecification<"map" | "viewport">;
     /**
-     * The width of the circle's stroke. Strokes are placed outside of the `circle-radius`.
+     * The width of the circle's stroke. Strokes are placed outside of the [`circle-radius`](layers/#circle-radius).
      */
     "circle-stroke-width"?: DataDrivenPropertyValueSpecification<number>;
     "circle-stroke-width-transition"?: TransitionSpecification;
@@ -1927,7 +2010,7 @@ type HeatmapLayerSpecification = {
    */
   "maxzoom"?: number;
   /**
-   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The `feature-state` expression is not supported in filter expressions.
+   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The [`feature-state`](expressions/#feature-state) expression is not supported in filter expressions.
    */
   "filter"?: FilterSpecification;
   /**
@@ -1968,7 +2051,7 @@ type HeatmapLayerSpecification = {
      */
     "heatmap-weight"?: DataDrivenPropertyValueSpecification<number>;
     /**
-     * Similar to `heatmap-weight` but controls the intensity of the heatmap globally. Primarily used for adjusting the heatmap based on zoom level.
+     * Similar to [`heatmap-weight`](layers/#heatmap-weight) but controls the intensity of the heatmap globally. Primarily used for adjusting the heatmap based on zoom level.
      *
      * @default
      * ```json
@@ -2046,7 +2129,7 @@ type FillExtrusionLayerSpecification = {
    */
   "maxzoom"?: number;
   /**
-   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The `feature-state` expression is not supported in filter expressions.
+   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The [`feature-state`](expressions/#feature-state) expression is not supported in filter expressions.
    */
   "filter"?: FilterSpecification;
   /**
@@ -2082,7 +2165,7 @@ type FillExtrusionLayerSpecification = {
     "fill-extrusion-opacity"?: PropertyValueSpecification<number>;
     "fill-extrusion-opacity-transition"?: TransitionSpecification;
     /**
-     * The base color of the extruded fill. The extrusion's surfaces will be shaded differently based on this color in combination with the root `light` settings. If this color is specified as `rgba` with an alpha component, the alpha component will be ignored; use `fill-extrusion-opacity` to set layer opacity.
+     * The base color of the extruded fill. The extrusion's surfaces will be shaded differently based on this color in combination with the root `light` settings. If this color is specified as `rgba` with an alpha component, the alpha component will be ignored; use [`fill-extrusion-opacity`](layers/#fill-extrusion-opacity) to set layer opacity.
      *
      * @default
      * ```json
@@ -2102,7 +2185,7 @@ type FillExtrusionLayerSpecification = {
     "fill-extrusion-translate"?: PropertyValueSpecification<[number, number]>;
     "fill-extrusion-translate-transition"?: TransitionSpecification;
     /**
-     * Controls the frame of reference for `fill-extrusion-translate`.
+     * Controls the frame of reference for [`fill-extrusion-translate`](layers/#fill-extrusion-translate).
      *
      * @default
      * ```json
@@ -2121,7 +2204,7 @@ type FillExtrusionLayerSpecification = {
     "fill-extrusion-height"?: DataDrivenPropertyValueSpecification<number>;
     "fill-extrusion-height-transition"?: TransitionSpecification;
     /**
-     * The height with which to extrude the base of this layer. Must be less than or equal to `fill-extrusion-height`. Negative values extrude below ground level, e.g. underground floors.
+     * The height with which to extrude the base of this layer. Must be less than or equal to [`fill-extrusion-height`](layers/#fill-extrusion-height). Negative values extrude below ground level, e.g. underground floors.
      */
     "fill-extrusion-base"?: DataDrivenPropertyValueSpecification<number>;
     "fill-extrusion-base-transition"?: TransitionSpecification;
@@ -2168,7 +2251,7 @@ type RasterLayerSpecification = {
    */
   "maxzoom"?: number;
   /**
-   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The `feature-state` expression is not supported in filter expressions.
+   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The [`feature-state`](expressions/#feature-state) expression is not supported in filter expressions.
    */
   "filter"?: FilterSpecification;
   /**
@@ -2291,7 +2374,7 @@ type HillshadeLayerSpecification = {
    */
   "maxzoom"?: number;
   /**
-   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The `feature-state` expression is not supported in filter expressions.
+   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The [`feature-state`](expressions/#feature-state) expression is not supported in filter expressions.
    */
   "filter"?: FilterSpecification;
   /**
@@ -2313,7 +2396,7 @@ type HillshadeLayerSpecification = {
    */
   "paint"?: {
     /**
-     * The direction of the light source(s) used to generate the hillshading with 0 as the top of the viewport if `hillshade-illumination-anchor` is set to `viewport` and due north if `hillshade-illumination-anchor` is set to `map`. Only when `hillshade-method` is set to `multidirectional` can you specify multiple light sources.
+     * The direction of the light source(s) used to generate the hillshading with 0 as the top of the viewport if [`hillshade-illumination-anchor`](layers/#hillshade-illumination-anchor) is set to `viewport` and due north if `hillshade-illumination-anchor` is set to `map`. Only when [`hillshade-method`](layers/#hillshade-method) is set to `multidirectional` can you specify multiple light sources.
      *
      * @default
      * ```json
@@ -2322,7 +2405,7 @@ type HillshadeLayerSpecification = {
      */
     "hillshade-illumination-direction"?: PropertyValueSpecification<NumberArraySpecification>;
     /**
-     * The altitude of the light source(s) used to generate the hillshading with 0 as sunset and 90 as noon. Only when `hillshade-method` is set to `multidirectional` can you specify multiple light sources.
+     * The altitude of the light source(s) used to generate the hillshading with 0 as sunset and 90 as noon. Only when [`hillshade-method`](layers/#hillshade-method) is set to `multidirectional` can you specify multiple light sources.
      *
      * @default
      * ```json
@@ -2350,7 +2433,7 @@ type HillshadeLayerSpecification = {
     "hillshade-exaggeration"?: PropertyValueSpecification<number>;
     "hillshade-exaggeration-transition"?: TransitionSpecification;
     /**
-     * The shading color of areas that face away from the light source(s). Only when `hillshade-method` is set to `multidirectional` can you specify multiple light sources.
+     * The shading color of areas that face away from the light source(s). Only when [`hillshade-method`](layers/#hillshade-method) is set to `multidirectional` can you specify multiple light sources.
      *
      * @default
      * ```json
@@ -2360,7 +2443,7 @@ type HillshadeLayerSpecification = {
     "hillshade-shadow-color"?: PropertyValueSpecification<ColorArraySpecification>;
     "hillshade-shadow-color-transition"?: TransitionSpecification;
     /**
-     * The shading color of areas that faces towards the light source(s). Only when `hillshade-method` is set to `multidirectional` can you specify multiple light sources.
+     * The shading color of areas that faces towards the light source(s). Only when [`hillshade-method`](layers/#hillshade-method) is set to `multidirectional` can you specify multiple light sources.
      *
      * @default
      * ```json
@@ -2433,7 +2516,7 @@ type ColorReliefLayerSpecification = {
    */
   "maxzoom"?: number;
   /**
-   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The `feature-state` expression is not supported in filter expressions.
+   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The [`feature-state`](expressions/#feature-state) expression is not supported in filter expressions.
    */
   "filter"?: FilterSpecification;
   /**
@@ -2465,7 +2548,7 @@ type ColorReliefLayerSpecification = {
     "color-relief-opacity"?: PropertyValueSpecification<number>;
     "color-relief-opacity-transition"?: TransitionSpecification;
     /**
-     * Defines the color of each pixel based on its elevation. Should be an expression that uses `["elevation"]` as input.
+     * Defines the color of each pixel based on its elevation. Should be an expression that uses the [`elevation`](expressions/#elevation) expression as input.
      *
      * @example
      * ```json
@@ -2562,8 +2645,6 @@ type BackgroundLayerSpecification = {
   };
 };
 type LayerSpecification = FillLayerSpecification | LineLayerSpecification | SymbolLayerSpecification | CircleLayerSpecification | HeatmapLayerSpecification | FillExtrusionLayerSpecification | RasterLayerSpecification | HillshadeLayerSpecification | ColorReliefLayerSpecification | BackgroundLayerSpecification;
-//#endregion
-//#region src/expression/types/color_spaces.d.ts
 /**
  * @param r Red component 0..1
  * @param g Green component 0..1
@@ -2585,8 +2666,6 @@ type HCLColor = [h: number, c: number, l: number, alpha: number];
  * @param alpha Alpha component 0..1
  */
 type LABColor = [l: number, a: number, b: number, alpha: number];
-//#endregion
-//#region src/expression/types/color.d.ts
 type InterpolationColorSpace = 'rgb' | 'hcl' | 'lab';
 /**
  * Color representation used by WebGL.
@@ -2677,14 +2756,10 @@ declare class Color {
   toString(): string;
   static interpolate(from: Color, to: Color, t: number, spaceKey?: InterpolationColorSpace): Color;
 }
-//#endregion
-//#region src/point2d.d.ts
 interface Point2D$1 {
   x: number;
   y: number;
 }
-//#endregion
-//#region src/expression/index.d.ts
 type Feature$1 = {
   readonly type: 0 | 1 | 2 | 3 | 'Unknown' | 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon';
   readonly id?: any;

package/dist/index.js

@@ -7470,7 +7470,7 @@ function pixelAlignedBox(project) {
     return [minX, minY, maxX, maxY];
 }
 
-//#region src/reference/v8.json
+// src/reference/v8.json
 var v8_default = {
 	$version: 8,
 	$root: {
@@ -7565,6 +7565,14 @@ var v8_default = {
 			},
 			"default": "xyz"
 		},
+		"emptyResponse": {
+			"type": "enum",
+			"values": {
+				"blank": {},
+				"missing": {}
+			},
+			"default": "blank"
+		},
 		"minzoom": {
 			"type": "number",
 			"default": 0
@@ -7632,6 +7640,14 @@ var v8_default = {
 			},
 			"default": "xyz"
 		},
+		"emptyResponse": {
+			"type": "enum",
+			"values": {
+				"blank": {},
+				"missing": {}
+			},
+			"default": "blank"
+		},
 		"attribution": { "type": "string" },
 		"volatile": {
 			"type": "boolean",
@@ -7674,6 +7690,14 @@ var v8_default = {
 			"default": 512,
 			"units": "pixels"
 		},
+		"emptyResponse": {
+			"type": "enum",
+			"values": {
+				"blank": {},
+				"missing": {}
+			},
+			"default": "blank"
+		},
 		"attribution": { "type": "string" },
 		"encoding": {
 			"type": "enum",
@@ -8953,6 +8977,21 @@ var v8_default = {
 			},
 			"property-type": "data-constant"
 		},
+		"fill-layer-blend": {
+			"type": "enum",
+			"values": {
+				"normal": {},
+				"multiply": {},
+				"color": {},
+				"luminosity": {},
+				"plus-lighter": {},
+				"screen": {},
+				"overlay": {}
+			},
+			"default": "normal",
+			"property-type": "constant",
+			"transition": false
+		},
 		"fill-color": {
 			"type": "color",
 			"default": "#000000",
@@ -9041,7 +9080,8 @@ var v8_default = {
 				"parameters": [
 					"zoom",
 					"feature",
-					"feature-state"
+					"feature-state",
+					"elevation"
 				]
 			},
 			"property-type": "data-driven"
@@ -9153,6 +9193,21 @@ var v8_default = {
 			},
 			"property-type": "data-constant"
 		},
+		"line-layer-blend": {
+			"type": "enum",
+			"values": {
+				"normal": {},
+				"multiply": {},
+				"color": {},
+				"luminosity": {},
+				"plus-lighter": {},
+				"screen": {},
+				"overlay": {}
+			},
+			"default": "normal",
+			"property-type": "constant",
+			"transition": false
+		},
 		"line-color": {
 			"type": "color",
 			"default": "#000000",
@@ -10135,10 +10190,10 @@ var v8_default = {
 	}
 };
 
-//#region src/reference/latest.ts
+// src/reference/latest.ts
 const latest = v8_default;
 
-//#region src/expression/types.ts
+// src/expression/types.ts
 const NullType = { kind: "null" };
 const NumberType = { kind: "number" };
 const StringType = { kind: "string" };
@@ -10234,7 +10289,7 @@ function verifyType(provided, sample) {
 	return provided.kind === sample.kind;
 }
 
-//#region src/expression/types/color_spaces.ts
+// src/expression/types/color_spaces.ts
 const Xn = .96422;
 const Yn = 1;
 const Zn = .82521;
@@ -10329,7 +10384,7 @@ function hslToRgb([h, s, l, alpha]) {
 	];
 }
 
-//#region src/util/get_own.ts
+// src/util/get_own.ts
 const hasOwnProperty = Object.hasOwn || function hasOwnProperty(object, key) {
 	return Object.prototype.hasOwnProperty.call(object, key);
 };
@@ -10337,7 +10392,7 @@ function getOwn(object, key) {
 	return hasOwnProperty(object, key) ? object[key] : void 0;
 }
 
-//#region src/expression/types/parse_css_color.ts
+// src/expression/types/parse_css_color.ts
 /**
 * CSS color parser compliant with CSS Color 4 Specification.
 * Supports: named colors, `transparent` keyword, all rgb hex notations,
@@ -11215,7 +11270,7 @@ const namedColors = {
 	]
 };
 
-//#region src/util/interpolate-primitives.ts
+// src/util/interpolate-primitives.ts
 function interpolateNumber(from, to, t) {
 	return from + t * (to - from);
 }
@@ -11225,7 +11280,7 @@ function interpolateArray(from, to, t) {
 	});
 }
 
-//#region src/expression/types/color.ts
+// src/expression/types/color.ts
 /**
 * Checks whether the specified color space is one of the supported interpolation color spaces.
 *
@@ -11409,7 +11464,7 @@ var Color$1 = class Color {
 	}
 };
 
-//#region src/expression/types/formatted.ts
+// src/expression/types/formatted.ts
 const VERTICAL_ALIGN_OPTIONS = [
 	"bottom",
 	"center",
@@ -11446,7 +11501,7 @@ var Formatted = class Formatted {
 	}
 };
 
-//#region src/expression/types/padding.ts
+// src/expression/types/padding.ts
 /**
 * A set of four numbers representing padding around a box. Create instances from
 * bare arrays or numeric values using the static method `Padding.parse`.
@@ -11506,7 +11561,7 @@ var Padding = class Padding {
 	}
 };
 
-//#region src/expression/types/number_array.ts
+// src/expression/types/number_array.ts
 /**
 * An array of numbers. Create instances from
 * bare arrays or numeric values using the static method `NumberArray.parse`.
@@ -11536,7 +11591,7 @@ var NumberArray = class NumberArray {
 	}
 };
 
-//#region src/expression/types/color_array.ts
+// src/expression/types/color_array.ts
 /**
 * An array of colors. Create instances from
 * bare arrays or strings using the static method `ColorArray.parse`.
@@ -11579,7 +11634,7 @@ var ColorArray = class ColorArray {
 	}
 };
 
-//#region src/expression/runtime_error.ts
+// src/expression/runtime_error.ts
 var RuntimeError = class extends Error {
 	constructor(message, path) {
 		super(message);
@@ -11591,7 +11646,7 @@ var RuntimeError = class extends Error {
 	}
 };
 
-//#region src/expression/types/variable_anchor_offset_collection.ts
+// src/expression/types/variable_anchor_offset_collection.ts
 /** Set of valid anchor positions, as a set for validation */
 const anchors = /* @__PURE__ */ new Set([
 	"center",
@@ -11643,7 +11698,7 @@ var VariableAnchorOffsetCollection = class VariableAnchorOffsetCollection {
 	}
 };
 
-//#region src/expression/types/resolved_image.ts
+// src/expression/types/resolved_image.ts
 var ResolvedImage = class ResolvedImage {
 	constructor(options) {
 		this.name = options.name;
@@ -11661,7 +11716,7 @@ var ResolvedImage = class ResolvedImage {
 	}
 };
 
-//#region src/expression/types/projection_definition.ts
+// src/expression/types/projection_definition.ts
 var ProjectionDefinition = class ProjectionDefinition {
 	constructor(from, to, transition) {
 		this.from = from;
@@ -11687,7 +11742,7 @@ var ProjectionDefinition = class ProjectionDefinition {
 	}
 };
 
-//#region src/expression/types/collator.ts
+// src/expression/types/collator.ts
 var Collator = class {
 	constructor(caseSensitive, diacriticSensitive, locale) {
 		if (caseSensitive) this.sensitivity = diacriticSensitive ? "variant" : "case";
@@ -11706,7 +11761,7 @@ var Collator = class {
 	}
 };
 
-//#region src/expression/values.ts
+// src/expression/values.ts
 function validateRGBA(r, g, b, a) {
 	if (!(typeof r === "number" && r >= 0 && r <= 255 && typeof g === "number" && g >= 0 && g <= 255 && typeof b === "number" && b >= 0 && b <= 255)) return `Invalid rgba value [${(typeof a === "number" ? [
 		r,
@@ -11773,7 +11828,7 @@ function valueToString(value) {
 	else return JSON.stringify(value);
 }
 
-//#region src/expression/definitions/literal.ts
+// src/expression/definitions/literal.ts
 var Literal = class Literal {
 	constructor(type, value) {
 		this.type = type;
@@ -11797,7 +11852,7 @@ var Literal = class Literal {
 	}
 };
 
-//#region src/expression/evaluation_context.ts
+// src/expression/evaluation_context.ts
 const geometryTypes = [
 	"Unknown",
 	"Point",
@@ -11839,7 +11894,7 @@ var EvaluationContext = class {
 	}
 };
 
-//#region src/expression/stops.ts
+// src/expression/stops.ts
 /**
 * Returns the index of the last stop <= input, or 0 if it doesn't exist.
 * @private
@@ -11863,7 +11918,7 @@ function findStopLessThanOrEqualTo(stops, input, key) {
 	return 0;
 }
 
-//#region src/expression/definitions/step.ts
+// src/expression/definitions/step.ts
 var Step = class Step {
 	constructor(type, input, stops, key) {
 		this.type = type;
@@ -11917,7 +11972,7 @@ var Step = class Step {
 	}
 };
 
-//#region node_modules/@mapbox/unitbezier/index.js
+// node_modules/@mapbox/unitbezier/index.js
 function unitBezier(p1x, p1y, p2x, p2y) {
 	const cx = 3 * p1x;
 	const bx = 3 * (p2x - p1x) - cx;
@@ -11950,7 +12005,7 @@ function unitBezier(p1x, p1y, p2x, p2y) {
 	};
 }
 
-//#region src/expression/definitions/interpolate.ts
+// src/expression/definitions/interpolate.ts
 var Interpolate = class Interpolate {
 	constructor(type, operator, interpolation, input, stops, key) {
 		this.type = type;
@@ -12112,7 +12167,7 @@ const interpolateFactory = {
 	array: interpolateArray
 };
 
-//#region src/expression/definitions/format.ts
+// src/expression/definitions/format.ts
 var FormatExpression = class FormatExpression {
 	constructor(sections) {
 		this.type = FormattedType;
@@ -12193,7 +12248,7 @@ var FormatExpression = class FormatExpression {
 	}
 };
 
-//#region src/util/classify_rings.ts
+// src/util/classify_rings.ts
 /**
 * Classifies an array of rings into polygons with outer rings and holes
 * @param rings - the rings to classify
@@ -12236,7 +12291,7 @@ function calculateSignedArea(ring) {
 	return sum;
 }
 
-//#region src/expression/definitions/assertion.ts
+// src/expression/definitions/assertion.ts
 const types$1 = {
 	string: StringType,
 	number: NumberType,
@@ -12297,7 +12352,7 @@ var Assertion = class Assertion {
 	}
 };
 
-//#region src/expression/definitions/coercion.ts
+// src/expression/definitions/coercion.ts
 const types = {
 	"to-boolean": BooleanType,
 	"to-color": ColorType,
@@ -12417,7 +12472,7 @@ var Coercion = class Coercion {
 	}
 };
 
-//#region src/expression/definitions/let.ts
+// src/expression/definitions/let.ts
 var Let = class Let {
 	constructor(bindings, result) {
 		this.type = result.type;
@@ -12451,7 +12506,7 @@ var Let = class Let {
 	}
 };
 
-//#region src/expression/definitions/var.ts
+// src/expression/definitions/var.ts
 var Var = class Var {
 	constructor(name, boundExpression) {
 		this.type = boundExpression.type;
@@ -12473,7 +12528,7 @@ var Var = class Var {
 	}
 };
 
-//#region src/expression/definitions/at.ts
+// src/expression/definitions/at.ts
 var At = class At {
 	constructor(type, index, input, key) {
 		this.type = type;
@@ -12506,7 +12561,7 @@ var At = class At {
 	}
 };
 
-//#region src/expression/definitions/in.ts
+// src/expression/definitions/in.ts
 var In = class In {
 	constructor(needle, haystack, key) {
 		this.needle = needle;
@@ -12550,7 +12605,7 @@ var In = class In {
 	}
 };
 
-//#region src/expression/definitions/index_of.ts
+// src/expression/definitions/index_of.ts
 var IndexOf = class IndexOf {
 	constructor(needle, haystack, key, fromIndex) {
 		this.needle = needle;
@@ -12605,7 +12660,7 @@ var IndexOf = class IndexOf {
 	}
 };
 
-//#region src/expression/definitions/match.ts
+// src/expression/definitions/match.ts
 var Match = class Match {
 	constructor(inputType, outputType, input, cases, outputs, otherwise) {
 		this.inputType = inputType;
@@ -12664,7 +12719,7 @@ var Match = class Match {
 	}
 };
 
-//#region src/expression/definitions/case.ts
+// src/expression/definitions/case.ts
 var Case = class Case {
 	constructor(type, branches, otherwise) {
 		this.type = type;
@@ -12706,7 +12761,7 @@ var Case = class Case {
 	}
 };
 
-//#region src/expression/definitions/slice.ts
+// src/expression/definitions/slice.ts
 var Slice = class Slice {
 	constructor(type, input, beginIndex, key, endIndex) {
 		this.type = type;
@@ -12750,7 +12805,7 @@ var Slice = class Slice {
 	}
 };
 
-//#region src/expression/definitions/coalesce.ts
+// src/expression/definitions/coalesce.ts
 var Coalesce = class Coalesce {
 	constructor(type, args) {
 		this.type = type;
@@ -12795,7 +12850,7 @@ var Coalesce = class Coalesce {
 	}
 };
 
-//#region src/expression/definitions/comparison.ts
+// src/expression/definitions/comparison.ts
 function isComparableType(op, type) {
 	if (op === "==" || op === "!=") return type.kind === "boolean" || type.kind === "string" || type.kind === "number" || type.kind === "null" || type.kind === "value";
 	else return type.kind === "string" || type.kind === "number" || type.kind === "value";
@@ -12918,7 +12973,7 @@ const GreaterThan = makeComparison(">", gt, gtCollate);
 const LessThanOrEqual = makeComparison("<=", lteq, lteqCollate);
 const GreaterThanOrEqual = makeComparison(">=", gteq, gteqCollate);
 
-//#region src/expression/definitions/collator.ts
+// src/expression/definitions/collator.ts
 var CollatorExpression = class CollatorExpression {
 	constructor(caseSensitive, diacriticSensitive, locale) {
 		this.type = CollatorType;
@@ -12954,7 +13009,7 @@ var CollatorExpression = class CollatorExpression {
 	}
 };
 
-//#region src/expression/definitions/number_format.ts
+// src/expression/definitions/number_format.ts
 var NumberFormat = class NumberFormat {
 	constructor(number, locale, currency, unit, minFractionDigits, maxFractionDigits) {
 		this.type = StringType;
@@ -13021,7 +13076,7 @@ var NumberFormat = class NumberFormat {
 	}
 };
 
-//#region src/expression/definitions/image.ts
+// src/expression/definitions/image.ts
 var ImageExpression = class ImageExpression {
 	constructor(input) {
 		this.type = ResolvedImageType;
@@ -13047,7 +13102,7 @@ var ImageExpression = class ImageExpression {
 	}
 };
 
-//#region src/expression/definitions/length.ts
+// src/expression/definitions/length.ts
 var Length = class Length {
 	constructor(input, key) {
 		this.input = input;
@@ -13075,7 +13130,7 @@ var Length = class Length {
 	}
 };
 
-//#region src/util/geometry_util.ts
+// src/util/geometry_util.ts
 const EXTENT = 8192;
 function getTileCoordinates(p, canonical) {
 	const x = mercatorXfromLng(p[0]);
@@ -13171,7 +13226,7 @@ function twoSided(p1, p2, q1, q2) {
 	return false;
 }
 
-//#region src/expression/definitions/within.ts
+// src/expression/definitions/within.ts
 function getTilePolygon(coordinates, bbox, canonical) {
 	const polygon = [];
 	for (let i = 0; i < coordinates.length; i++) {
@@ -13333,7 +13388,7 @@ var Within = class Within {
 	}
 };
 
-//#region node_modules/tinyqueue/index.js
+// node_modules/tinyqueue/index.js
 var TinyQueue = class {
 	constructor(data = [], compare = (a, b) => a < b ? -1 : a > b ? 1 : 0) {
 		this.data = data;
@@ -13386,7 +13441,7 @@ var TinyQueue = class {
 	}
 };
 
-//#region src/util/cheap_ruler.ts
+// src/util/cheap_ruler.ts
 const RE = 6378.137;
 const E2 = .0066943799901413165;
 const RAD = Math.PI / 180;
@@ -13469,7 +13524,7 @@ var CheapRuler = class {
 	}
 };
 
-//#region src/expression/definitions/distance.ts
+// src/expression/definitions/distance.ts
 const MinPointsSize = 100;
 const MinLinePointsSize = 50;
 function compareDistPair(a, b) {
@@ -13837,7 +13892,7 @@ var Distance = class Distance {
 	}
 };
 
-//#region src/expression/definitions/semiliteral.ts
+// src/expression/definitions/semiliteral.ts
 var Semiliteral = class Semiliteral {
 	constructor(arr) {
 		let elementType = null;
@@ -13878,7 +13933,7 @@ var Semiliteral = class Semiliteral {
 	}
 };
 
-//#region src/expression/definitions/global_state.ts
+// src/expression/definitions/global_state.ts
 var GlobalState = class GlobalState {
 	constructor(key) {
 		this.key = key;
@@ -13902,7 +13957,7 @@ var GlobalState = class GlobalState {
 	}
 };
 
-//#region src/expression/definitions/index.ts
+// src/expression/definitions/index.ts
 const expressions = {
 	"==": Equals,
 	"!=": NotEquals,
@@ -13944,7 +13999,7 @@ const expressions = {
 	"global-state": GlobalState
 };
 
-//#region src/expression/parsing_error.ts
+// src/expression/parsing_error.ts
 var ExpressionParsingError = class extends Error {
 	constructor(key, message) {
 		super(message);
@@ -13953,7 +14008,7 @@ var ExpressionParsingError = class extends Error {
 	}
 };
 
-//#region src/expression/scope.ts
+// src/expression/scope.ts
 /**
 * Tracks `let` bindings during expression parsing.
 * @private
@@ -13978,7 +14033,7 @@ var Scope = class Scope {
 	}
 };
 
-//#region src/expression/parsing_context.ts
+// src/expression/parsing_context.ts
 /**
 * State associated parsing at a given point in an expression tree.
 * @private
@@ -14100,7 +14155,7 @@ var ParsingContext = class ParsingContext {
 	}
 };
 
-//#region src/expression/compound_expression.ts
+// src/expression/compound_expression.ts
 var CompoundExpression = class CompoundExpression {
 	constructor(name, type, evaluate, args, key) {
 		this.name = name;
@@ -14675,7 +14730,7 @@ function isGlobalPropertyConstant(e, properties) {
 	return result;
 }
 
-//#region src/util/properties.ts
+// src/util/properties.ts
 function supportsPropertyExpression(spec) {
 	return spec["property-type"] === "data-driven" || spec["property-type"] === "cross-faded-data-driven";
 }
@@ -14686,13 +14741,13 @@ function supportsInterpolation(spec) {
 	return !!spec.expression && spec.expression.interpolated;
 }
 
-//#region src/util/extend.ts
+// src/util/extend.ts
 function extendBy(output, ...inputs) {
 	for (const input of inputs) for (const k in input) output[k] = input[k];
 	return output;
 }
 
-//#region src/util/get_type.ts
+// src/util/get_type.ts
 function getType(val) {
 	if (val instanceof Number) return "number";
 	else if (val instanceof String) return "string";
@@ -14702,7 +14757,7 @@ function getType(val) {
 	else return typeof val;
 }
 
-//#region src/function/index.ts
+// src/function/index.ts
 function isFunction(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value) && typeOf(value) === ObjectType;
 }
@@ -14911,7 +14966,7 @@ function interpolationFactor(input, base, lowerValue, upperValue) {
 	else return (Math.pow(base, progress) - 1) / (Math.pow(base, difference) - 1);
 }
 
-//#region src/util/result.ts
+// src/util/result.ts
 function success(value) {
 	return {
 		result: "success",
@@ -14925,7 +14980,7 @@ function error(value) {
 	};
 }
 
-//#region src/expression/index.ts
+// src/expression/index.ts
 var StyleExpression = class {
 	constructor(expression, rootKey, propertySpec, globalState) {
 		this.expression = expression;
@@ -15140,21 +15195,26 @@ function normalizePropertyExpression(value, rootKey, specification, globalState)
 		};
 	}
 }
-function findZoomCurve(expression) {
+function findZoomCurve(expression, seen = /* @__PURE__ */ new Map()) {
+	if (seen.has(expression)) return seen.get(expression);
 	let result = null;
-	if (expression instanceof Let) result = findZoomCurve(expression.result);
+	if (expression instanceof Let) result = findZoomCurve(expression.result, seen);
 	else if (expression instanceof Coalesce) for (const arg of expression.args) {
-		result = findZoomCurve(arg);
+		result = findZoomCurve(arg, seen);
 		if (result) break;
 	}
 	else if ((expression instanceof Step || expression instanceof Interpolate) && expression.input instanceof CompoundExpression && expression.input.name === "zoom") result = expression;
-	if (result instanceof ExpressionParsingError) return result;
+	if (result instanceof ExpressionParsingError) {
+		seen.set(expression, result);
+		return result;
+	}
 	expression.eachChild((child) => {
-		const childResult = findZoomCurve(child);
+		const childResult = findZoomCurve(child, seen);
 		if (childResult instanceof ExpressionParsingError) result = childResult;
 		else if (!result && childResult) result = new ExpressionParsingError("", "\"zoom\" expression may only be used as input to a top-level \"step\" or \"interpolate\" expression.");
 		else if (result && childResult && result !== childResult) result = new ExpressionParsingError("", "Only one zoom-based \"step\" or \"interpolate\" subexpression may be used in an expression.");
 	});
+	seen.set(expression, result);
 	return result;
 }
 function findGlobalStateRefs(expression, results = /* @__PURE__ */ new Set()) {
@@ -15207,7 +15267,7 @@ function addGlobalState(globals, globalState) {
 	};
 }
 
-//#region src/feature_filter/index.ts
+// src/feature_filter/index.ts
 function classifyChildren(children) {
 	let sawLegacy = false;
 	for (const child of children) {
@@ -15420,7 +15480,7 @@ function convertNegation(filter) {
 	return ["!", filter];
 }
 
-//#region src/expression/visibility.ts
+// src/expression/visibility.ts
 const visibilitySpec = {
 	type: "enum",
 	"property-type": "data-constant",
@@ -21634,7 +21694,11 @@ class CanvasPatterns {
             image
                 .getContext('2d')
                 .drawImage(sheet, sprite.x, sprite.y, sprite.width, sprite.height, 0, 0, sprite.width, sprite.height);
-            fill = this.#ctx.createPattern(image, 'repeat');
+            // Only an unloaded `Image` gives `null`; a canvas never does.
+            const created = this.#ctx.createPattern(image, 'repeat');
+            if (!created)
+                throw new Error(`could not create a canvas pattern of "${pattern.name}"`);
+            fill = created;
             this.#patterns.set(key, fill);
         }
         const scale = (pattern.scale ?? 1) / sprite.pixelRatio;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@versatiles/png-renderer",
-  "version": "2.4.1",
+  "version": "2.5.0",
   "description": "Renders MapLibre styles as PNG (and SVG) in Node.js.",
   "keywords": [
     "png",
@@ -41,7 +41,7 @@
     "node": ">= 22"
   },
   "dependencies": {
-    "@napi-rs/canvas": "^1.0.11",
+    "@napi-rs/canvas": "^1.1.0",
     "@types/geojson": "^7946.0.16"
   }
 }