@versatiles/png-renderer 2.4.2 → 2.6.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;
   /**
@@ -2199,6 +2282,15 @@ type RasterLayerSpecification = {
      */
     "raster-opacity"?: PropertyValueSpecification<number>;
     "raster-opacity-transition"?: TransitionSpecification;
+    /**
+     * Controls how the layer is composited with the content already rendered beneath it. Unlike [`raster-opacity`](#raster-opacity), which only fades the layer, this property determines how its colors interact with the existing map contents.
+     *
+     * @default
+     * ```json
+     * "normal"
+     * ```
+     */
+    "raster-layer-blend"?: "normal" | "multiply" | "color" | "luminosity" | "plus-lighter" | "screen" | "overlay";
     /**
      * Rotates hues around the color wheel.
      */
@@ -2291,7 +2383,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 +2405,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 +2414,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 +2442,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 +2452,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 +2525,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 +2557,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 +2654,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 +2675,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 +2765,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;
@@ -3092,6 +3176,32 @@ interface FetchRequestInit {
  */
 type FetchFunction = (url: string, init?: FetchRequestInit) => Promise<FetchResponse>;
 
+/**
+ * An image that the style uses besides those of its sprite, as MapLibre GL JS takes it with
+ * `map.addImage(id, { width, height, data }, { pixelRatio, sdf })`.
+ */
+interface StyleImage {
+    /** The name that the style uses, e.g. in `icon-image` or `fill-pattern`. No sprite id is put before it. */
+    id: string;
+    /** Width in pixels. */
+    width: number;
+    /** Height in pixels. */
+    height: number;
+    /** The pixels as RGBA, row by row, not premultiplied: `width * height * 4` bytes. */
+    data: Uint8Array | Uint8ClampedArray;
+    /**
+     * Image pixels per pixel of the map, e.g. `2` for an image drawn at half its size.
+     * @defaultValue `1`
+     */
+    pixelRatio?: number;
+    /**
+     * Whether the image is a signed distance field, as a sprite image can be: only its alpha
+     * channel counts, and `icon-color` and the icon halo color it.
+     * @defaultValue `false`
+     */
+    sdf?: boolean;
+}
+
 /** Options for {@link SVGMapRenderer}: what stays the same for every view of the map. */
 interface SVGMapRendererOptions {
     /**
@@ -3178,6 +3288,19 @@ interface SVGMapRendererOptions {
      * @defaultValue the defaults of the style's `state`
      */
     globalState?: GlobalState;
+    /**
+     * Images that the style uses besides those of its sprite, like `map.addImage(id, image,
+     * { pixelRatio, sdf })` in MapLibre GL JS: for `icon-image`, `fill-pattern`, `line-pattern`
+     * and `background-pattern`, by their `id`, which no sprite id is put before. An SDF image is
+     * colored by `icon-color` and its halo, like one of the sprite.
+     *
+     * As in MapLibre GL JS, where `addImage` fails for an id that exists, an image of the sprite
+     * with the same id is drawn instead, reported through
+     * {@link SVGMapRendererOptions.onWarning}. In an SVG, each image is a data URI of a PNG file
+     * without compression.
+     * @defaultValue none
+     */
+    images?: readonly StyleImage[];
 }
 /** The view to render: size, centre and zoom. */
 interface ViewOptions {
@@ -3525,4 +3648,4 @@ declare class PNGMapRenderer extends SVGMapRenderer {
 }
 
 export { PNGMapRenderer, SVGMapRenderer, renderToCanvas, renderToPNG, renderToSVG };
-export type { FetchFunction, FetchRequestInit, FetchResponse, GlobalState, PNGMapRendererOptions, PNGViewOptions, RenderToPNGOptions, RenderToSVGOptions, SVGMapRendererOptions, ViewOptions };
+export type { FetchFunction, FetchRequestInit, FetchResponse, GlobalState, PNGMapRendererOptions, PNGViewOptions, RenderToPNGOptions, RenderToSVGOptions, SVGMapRendererOptions, StyleImage, ViewOptions };