@rnmapbox/maps 10.2.7 → 10.2.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rnmapbox/maps",
-  "version": "10.2.7",
+  "version": "10.2.9",
   "description": "Community-supported, open-source React Native library for building maps using Mapbox native maps SDK for iOS and Android",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.native.d.ts",
@@ -11,7 +11,8 @@
       "default": "./lib/module/index.js"
     },
     "./package.json": "./package.json",
-    "./app.plugin.js": "./app.plugin.js"
+    "./app.plugin.js": "./app.plugin.js",
+    "./setup-jest": "./setup-jest.js"
   },
   "files": [
     "src",
@@ -72,6 +73,10 @@
     "url": "https://github.com/rnmapbox/maps/issues"
   },
   "homepage": "https://github.com/rnmapbox/maps#readme",
+  "mapbox": {
+    "ios": "~> 11.16.2",
+    "android": "11.16.2"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -196,6 +201,9 @@
         "RNMBXCallout": {
           "className": "RNMBXCalloutComponentView"
         },
+        "RNMBXCameraGestureObserver": {
+          "className": "RNMBXCameraGestureObserverComponentView"
+        },
         "RNMBXCamera": {
           "className": "RNMBXCameraComponentView"
         },
@@ -250,12 +258,18 @@
         "RNMBXPointAnnotation": {
           "className": "RNMBXPointAnnotationComponentView"
         },
+        "RNMBXRasterArraySource": {
+          "className": "RNMBXRasterArraySourceComponentView"
+        },
         "RNMBXRasterDemSource": {
           "className": "RNMBXRasterDemSourceComponentView"
         },
         "RNMBXRasterLayer": {
           "className": "RNMBXRasterLayerComponentView"
         },
+        "RNMBXRasterParticleLayer": {
+          "className": "RNMBXRasterParticleLayerComponentView"
+        },
         "RNMBXRasterSource": {
           "className": "RNMBXRasterSourceComponentView"
         },
@@ -285,6 +299,7 @@
         "RNMBXAtmosphere": "RNMBXAtmosphereComponentView",
         "RNMBXBackgroundLayer": "RNMBXBackgroundLayerComponentView",
         "RNMBXCallout": "RNMBXCalloutComponentView",
+        "RNMBXCameraGestureObserver": "RNMBXCameraGestureObserverComponentView",
         "RNMBXCamera": "RNMBXCameraComponentView",
         "RNMBXCircleLayer": "RNMBXCircleLayerComponentView",
         "RNMBXCustomLocationProvider": "RNMBXCustomLocationProviderComponentView",
@@ -303,8 +318,10 @@
         "RNMBXModels": "RNMBXModelsComponentView",
         "RNMBXNativeUserLocation": "RNMBXNativeUserLocationComponentView",
         "RNMBXPointAnnotation": "RNMBXPointAnnotationComponentView",
+        "RNMBXRasterArraySource": "RNMBXRasterArraySourceComponentView",
         "RNMBXRasterDemSource": "RNMBXRasterDemSourceComponentView",
         "RNMBXRasterLayer": "RNMBXRasterLayerComponentView",
+        "RNMBXRasterParticleLayer": "RNMBXRasterParticleLayerComponentView",
         "RNMBXRasterSource": "RNMBXRasterSourceComponentView",
         "RNMBXShapeSource": "RNMBXShapeSourceComponentView",
         "RNMBXSkyLayer": "RNMBXSkyLayerComponentView",

package/plugin/build/withMapbox.js

@@ -148,7 +148,7 @@ const withAndroidPropertiesDownloadToken = (config, { RNMapboxMapsDownloadToken
     }
     return config;
 };
-const withAndroidPropertiesImpl2 = (config, { RNMapboxMapsImpl, RNMapboxMapsVersion, RNMapboxMapsUseV11 } = {}) => {
+const withAndroidPropertiesImpl2 = (config, { RNMapboxMapsImpl, RNMapboxMapsVersion, RNMapboxMapsUseV11, } = {}) => {
     const keyValues = {
         expoRNMapboxMapsImpl: RNMapboxMapsImpl,
         expoRNMapboxMapsVersion: RNMapboxMapsVersion,

package/plugin/src/withMapbox.ts

@@ -247,7 +247,11 @@ const withAndroidPropertiesDownloadToken: ConfigPlugin<MapboxPlugProps> = (
 
 const withAndroidPropertiesImpl2: ConfigPlugin<MapboxPlugProps> = (
   config,
-  { RNMapboxMapsImpl, RNMapboxMapsVersion, RNMapboxMapsUseV11 }: MapboxPlugProps = {},
+  {
+    RNMapboxMapsImpl,
+    RNMapboxMapsVersion,
+    RNMapboxMapsUseV11,
+  }: MapboxPlugProps = {},
 ) => {
   const keyValues = {
     expoRNMapboxMapsImpl: RNMapboxMapsImpl,
@@ -391,7 +395,10 @@ export const addMapboxMavenRepo = (src: string): string =>
     comment: '//',
   }).contents;
 
-const withAndroidAppGradle: ConfigPlugin<MapboxPlugProps> = (config, _props: MapboxPlugProps = {}) =>
+const withAndroidAppGradle: ConfigPlugin<MapboxPlugProps> = (
+  config,
+  _props: MapboxPlugProps = {},
+) =>
   withAppBuildGradle(config, ({ modResults, ...exportedConfig }) => {
     if (modResults.language !== 'groovy') {
       WarningAggregator.addWarningAndroid(
@@ -407,7 +414,10 @@ const withAndroidAppGradle: ConfigPlugin<MapboxPlugProps> = (config, _props: Map
     return { modResults, ...exportedConfig };
   });
 
-const withAndroidProjectGradle: ConfigPlugin<MapboxPlugProps> = (config, _props: MapboxPlugProps = {}) =>
+const withAndroidProjectGradle: ConfigPlugin<MapboxPlugProps> = (
+  config,
+  _props: MapboxPlugProps = {},
+) =>
   withProjectBuildGradle(config, ({ modResults, ...exportedConfig }) => {
     if (modResults.language !== 'groovy') {
       WarningAggregator.addWarningAndroid(

package/rnmapbox-maps.podspec

@@ -20,7 +20,7 @@ require 'json'
 package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
 
 ## Warning: these lines are scanned by autogenerate.js
-rnMapboxMapsDefaultMapboxVersion = '~> 11.15.2'
+rnMapboxMapsDefaultMapboxVersion = package['mapbox']['ios']
 
 rnMapboxMapsDefaultImpl = 'mapbox'
 

package/src/Mapbox.native.ts

@@ -23,6 +23,7 @@ export { default as LocationPuck } from './components/LocationPuck';
 export { default as VectorSource } from './components/VectorSource';
 export { ShapeSource } from './components/ShapeSource';
 export { default as RasterSource } from './components/RasterSource';
+export { default as RasterArraySource } from './components/RasterArraySource';
 export { default as RasterDemSource } from './components/RasterDemSource';
 export { default as ImageSource } from './components/ImageSource';
 export { Viewport } from './components/Viewport';
@@ -38,9 +39,12 @@ export { default as SkyLayer } from './components/SkyLayer';
 export { default as ModelLayer } from './components/ModelLayer';
 export { SymbolLayer } from './components/SymbolLayer';
 export { default as RasterLayer } from './components/RasterLayer';
+export { default as RasterParticleLayer } from './components/RasterParticleLayer';
 export { default as BackgroundLayer } from './components/BackgroundLayer';
 export { default as CustomLocationProvider } from './components/CustomLocationProvider';
 export { Terrain } from './components/Terrain';
+export { default as CameraGestureObserver } from './components/CameraGestureObserver';
+export { OnMapSteadyEvent } from './specs/RNMBXCameraGestureObserverNativeComponent';
 export {
   default as locationManager,
   type Location,
@@ -76,6 +80,7 @@ export type {
   HeatmapLayerStyleProps as HeatmapLayerStyle,
   FillExtrusionLayerStyleProps as FillExtrusionLayerStyle,
   RasterLayerStyleProps as RasterLayerStyle,
+  RasterParticleLayerStyleProps as RasterParticleLayerStyle,
   HillshadeLayerStyleProps as HillshadeLayerStyle,
   BackgroundLayerStyleProps as BackgroundLayerStyle,
   SkyLayerStyleProps as SkyLayerStyle,

package/src/RNMBXModule.ts

@@ -27,10 +27,7 @@ interface RNMBXModule {
     Mapbox: string;
   };
   removeCustomHeader(headerName: string): void;
-  addCustomHeader(
-    headerName: string,
-    headerValue: string
-  ): void;
+  addCustomHeader(headerName: string, headerValue: string): void;
   addCustomHeaderWithOptions(
     headerName: string,
     headerValue: string,

package/src/components/CameraGestureObserver.tsx

@@ -0,0 +1,37 @@
+import { memo } from 'react';
+import type { ViewProps } from 'react-native';
+import RNMBXCameraGestureObserverNativeComponent, {
+  OnMapSteadyEvent,
+} from '../specs/RNMBXCameraGestureObserverNativeComponent';
+
+type Props = ViewProps & {
+  /**
+   * Time in milliseconds to wait after last camera change before emitting 'steady' event.
+   * Default is 200ms.
+   */
+  quietPeriodMs?: number;
+
+  /**
+   * Maximum time in milliseconds before emitting 'timeout' event during continuous activity.
+   */
+  maxIntervalMs?: number;
+
+  /**
+   * Callback when the map reaches a steady state (no active gestures or animations).
+   */
+  onMapSteady?: (event: { nativeEvent: OnMapSteadyEvent }) => void;
+};
+
+/**
+ * CameraGestureObserver
+ *
+ * Unified native observer optimized for onMapSteady.
+ */
+export default memo((props: Props) => {
+  return (
+    <RNMBXCameraGestureObserverNativeComponent
+      {...props}
+      hasOnMapSteady={props.onMapSteady ? true : false}
+    />
+  );
+});

package/src/components/PointAnnotation.tsx

@@ -206,7 +206,7 @@ class PointAnnotation extends NativeBridgeComponent(
     this._runNativeMethod('refresh', this._nativeRef, []);
   }
 
-  _setNativeRef(nativeRef: NativePointAnnotationRef | null) {
+  _setNativeRef(nativeRef: NativePointAnnotationRef) {
     this._nativeRef = nativeRef;
     super._runPendingNativeMethods(nativeRef);
   }
@@ -214,7 +214,7 @@ class PointAnnotation extends NativeBridgeComponent(
   render() {
     const props = {
       ...this.props,
-      ref: (nativeRef: NativePointAnnotationRef | null) =>
+      ref: (nativeRef: NativePointAnnotationRef) =>
         this._setNativeRef(nativeRef),
       id: this.props.id,
       title: this.props.title,

package/src/components/RasterArraySource.tsx

@@ -0,0 +1,134 @@
+import React from 'react';
+import { NativeModules } from 'react-native';
+
+import { cloneReactChildrenWithProps } from '../utils';
+import { BaseProps } from '../types/BaseProps';
+import RNMBXRasterArraySourceNativeComponent from '../specs/RNMBXRasterArraySourceNativeComponent';
+
+import AbstractSource from './AbstractSource';
+
+const Mapbox = NativeModules.RNMBXModule;
+
+const isTileTemplateUrl = (url?: string): url is string =>
+  !!url &&
+  (url.includes('{z}') || url.includes('{bbox-') || url.includes('{quadkey}'));
+
+type Props = BaseProps & {
+  /**
+   * A string that uniquely identifies the source.
+   */
+  id: string;
+
+  /**
+   * The id refers to an existing source in the style. Does not create a new source.
+   */
+  existing?: boolean;
+
+  /**
+   * A URL to a TileJSON configuration file describing the source's contents and other metadata.
+   */
+  url?: string;
+
+  /**
+   * An array of tile URL templates. If multiple endpoints are specified, clients may use any combination of endpoints.
+   * Example: https://example.com/raster-tiles/{z}/{x}/{y}.png
+   */
+  tileUrlTemplates?: string[];
+
+  /**
+   * An unsigned integer that specifies the minimum zoom level at which to display tiles from the source.
+   * The value should be between 0 and 22, inclusive, and less than
+   * maxZoomLevel, if specified. The default value for this option is 0.
+   */
+  minZoomLevel?: number;
+
+  /**
+   * An unsigned integer that specifies the maximum zoom level at which to display tiles from the source.
+   * The value should be between 0 and 22, inclusive, and less than
+   * minZoomLevel, if specified. The default value for this option is 22.
+   */
+  maxZoomLevel?: number;
+
+  /**
+   * Size of the map tiles.
+   * Defaults to 512.
+   *
+   * @platform android
+   * Note: This property is not supported on iOS due to SDK limitations.
+   * On iOS, tileSize will be derived from the TileJSON when using url, or use the default value.
+   * If you need custom tile size on iOS, include it in your TileJSON response.
+   */
+  tileSize?: number;
+
+  children?: React.ReactElement | React.ReactElement[];
+
+  /**
+   * An array containing the longitude and latitude of the southwest and northeast corners of
+   * the source's bounding box in the following order: `[sw.lng, sw.lat, ne.lng, ne.lat]`.
+   * When this property is included in a source, no tiles outside of the given bounds are requested by Mapbox GL.
+   *
+   * @platform android
+   * Note: This property is not supported on iOS due to SDK limitations.
+   * On iOS, bounds will be derived from the TileJSON when using url.
+   * If you need custom bounds on iOS, include them in your TileJSON response.
+   */
+  sourceBounds?: number[];
+};
+
+type NativeProps = Props;
+
+/**
+ * RasterArraySource is a map content source that supplies raster array image tiles to be shown on the map.
+ * This is typically used for particle animations like wind or precipitation patterns.
+ * The location of and metadata about the tiles are defined either by an option dictionary
+ * or by an external file that conforms to the TileJSON specification.
+ *
+ * @experimental This component requires Mapbox Maps SDK v11.4.0 or later
+ */
+class RasterArraySource extends AbstractSource<Props, NativeProps> {
+  static defaultProps: Props = {
+    id: Mapbox.StyleSource.DefaultSourceID,
+  };
+
+  constructor(props: Props) {
+    super(props);
+    if (isTileTemplateUrl(props.url)) {
+      console.warn(
+        `RasterArraySource 'url' property contains a Tile URL Template, but is intended for a StyleJSON URL. Please migrate your RasterArraySource to use: \`tileUrlTemplates=["${props.url}"]\` instead.`,
+      );
+    }
+  }
+
+  render() {
+    let { url } = this.props;
+    let { tileUrlTemplates } = this.props;
+
+    // Swapping url for tileUrlTemplates to provide backward compatibility
+    // when RasterArraySource supported only tile url as url prop
+    if (isTileTemplateUrl(url)) {
+      tileUrlTemplates = [url];
+      url = undefined;
+    }
+
+    const props = {
+      ...this.props,
+      id: this.props.id,
+      existing: this.props.existing,
+      url,
+      tileUrlTemplates,
+      minZoomLevel: this.props.minZoomLevel,
+      maxZoomLevel: this.props.maxZoomLevel,
+      tileSize: this.props.tileSize,
+    };
+    return (
+      // @ts-expect-error just codegen stuff
+      <RNMBXRasterArraySourceNativeComponent ref={this.setNativeRef} {...props}>
+        {cloneReactChildrenWithProps(this.props.children, {
+          sourceID: this.props.id,
+        })}
+      </RNMBXRasterArraySourceNativeComponent>
+    );
+  }
+}
+
+export default RasterArraySource;

package/src/components/RasterParticleLayer.tsx

@@ -0,0 +1,117 @@
+import React from 'react';
+import { NativeModules } from 'react-native';
+
+import type {
+  FilterExpression,
+  RasterParticleLayerStyleProps,
+} from '../utils/MapboxStyles';
+import { StyleValue } from '../utils/StyleValue';
+import RNMBXRasterParticleLayerNativeComponent from '../specs/RNMBXRasterParticleLayerNativeComponent';
+
+import AbstractLayer from './AbstractLayer';
+
+const Mapbox = NativeModules.RNMBXModule;
+
+// @{codepart-replace-start(LayerPropsCommon.codepart-tsx)}
+type Slot = 'bottom' | 'middle' | 'top';
+
+type LayerPropsCommon = {
+  /**
+   * A string that uniquely identifies the source in the style to which it is added.
+   */
+  id: string;
+
+  /**
+   * The id refers to an existing layer in the style. Does not create a new layer.
+   */
+  existing?: boolean;
+
+  /**
+   * The source from which to obtain the data to style.
+   * If the source has not yet been added to the current style, the behavior is undefined.
+   * Inferred from parent source only if the layer is a direct child to it.
+   */
+  sourceID?: string;
+
+  /**
+   * Identifier of the layer within the source identified by the sourceID property from which the receiver obtains the data to style.
+   */
+  sourceLayerID?: string;
+
+  /**
+   * Inserts a layer above aboveLayerID.
+   */
+  aboveLayerID?: string;
+
+  /**
+   * Inserts a layer below belowLayerID
+   */
+  belowLayerID?: string;
+
+  /**
+   * Inserts a layer at a specified index
+   */
+  layerIndex?: number;
+
+  /**
+   *  Filter only the features in the source layer that satisfy a condition that you define
+   */
+  filter?: FilterExpression;
+
+  /**
+   * The minimum zoom level at which the layer gets parsed and appears.
+   */
+  minZoomLevel?: number;
+
+  /**
+   * The maximum zoom level at which the layer gets parsed and appears.
+   */
+  maxZoomLevel?: number;
+
+  /**
+   * The slot this layer is assigned to. If specified, and a slot with that name exists, it will be placed at that position in the layer order.
+   *
+   * v11 only
+   */
+  slot?: Slot;
+};
+// @{codepart-replace-end}
+
+export type Props = LayerPropsCommon & {
+  /**
+   * Customizable style attributes
+   */
+  style: RasterParticleLayerStyleProps;
+} & React.ComponentProps<typeof AbstractLayer>;
+
+type NativeTypeProps = Omit<Props, 'style'> & {
+  reactStyle?: { [key: string]: StyleValue };
+};
+
+/**
+ * RasterParticleLayer renders a particle animation driven by velocity data from a raster array source.
+ * This is typically used to visualize wind patterns, ocean currents, or other directional flow data.
+ *
+ * @experimental This component requires Mapbox Maps SDK v11.4.0 or later
+ */
+class RasterParticleLayer extends AbstractLayer<Props, NativeTypeProps> {
+  static defaultProps = {
+    sourceID: Mapbox.StyleSource.DefaultSourceID,
+  };
+
+  render() {
+    const props = {
+      ...this.baseProps,
+      sourceLayerID: this.props.sourceLayerID,
+    };
+    return (
+      // @ts-expect-error just codegen stuff
+      <RNMBXRasterParticleLayerNativeComponent
+        ref={this.setNativeLayer}
+        {...props}
+      />
+    );
+  }
+}
+
+export default RasterParticleLayer;

package/src/modules/offline/offlineManagerLegacy.ts

@@ -159,6 +159,20 @@ class OfflineManagerLegacy {
     return this._offlinePacks[name];
   }
 
+  /**
+   * Sets the maximum number of Mapbox-hosted tiles that may be downloaded and stored on the current device.
+   * The Mapbox Terms of Service prohibit changing or bypassing this limit without permission from Mapbox.
+   *
+   * @example
+   * Mapbox.offlineManagerLegacy.setTileCountLimit(1000);
+   *
+   * @param {Number} limit Map tile limit count.
+   * @return {void}
+   */
+  setTileCountLimit(limit: number): void {
+    MapboxOfflineManager.setTileCountLimit(limit);
+  }
+
   async _initialize(forceInit?: boolean): Promise<boolean> {
     if (this._hasInitialized && !forceInit) {
       return true;

package/src/specs/RNMBXCameraGestureObserverNativeComponent.ts

@@ -0,0 +1,28 @@
+import type { ViewProps } from 'react-native';
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+// @ts-ignore - CI environment type resolution issue for CodegenTypes
+import { DirectEventHandler, Double, } from 'react-native/Libraries/Types/CodegenTypes';
+
+import type { UnsafeMixed } from './codegenUtils';
+
+export type OnMapSteadyEvent = {
+  reason: 'steady' | 'timeout';
+  // ms since last camera change when reason === 'steady'
+  idleDurationMs?: Double;
+  // e.g., 'pan' | 'pinch' | 'rotate' | 'pitch'
+  lastGestureType?: string | null | undefined;
+  // Unix epoch in milliseconds
+  timestamp: Double;
+};
+
+export interface NativeProps extends ViewProps {
+  quietPeriodMs?: UnsafeMixed<number>;
+  maxIntervalMs?: UnsafeMixed<number>;
+
+  hasOnMapSteady: UnsafeMixed<boolean>;
+  onMapSteady?: DirectEventHandler<OnMapSteadyEvent>;
+}
+
+export default codegenNativeComponent<NativeProps>(
+  'RNMBXCameraGestureObserver',
+);

package/src/specs/RNMBXRasterArraySourceNativeComponent.ts

@@ -0,0 +1,22 @@
+import type { HostComponent, ViewProps } from 'react-native';
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+// @ts-ignore - CI environment type resolution issue for CodegenTypes
+import { Double } from 'react-native/Libraries/Types/CodegenTypes';
+
+import { UnsafeMixed } from './codegenUtils';
+
+export interface NativeProps extends ViewProps {
+  id: UnsafeMixed<string>;
+  existing: UnsafeMixed<boolean>;
+  url: UnsafeMixed<string>;
+  tileUrlTemplates: UnsafeMixed<Array<string>>;
+  minZoomLevel: UnsafeMixed<Double>;
+  maxZoomLevel: UnsafeMixed<Double>;
+  tileSize: UnsafeMixed<Double>;
+  sourceBounds: UnsafeMixed<Array<number>>;
+}
+
+// @ts-ignore-error - Codegen requires single cast but TypeScript prefers double cast
+export default codegenNativeComponent<NativeProps>(
+  'RNMBXRasterArraySource',
+) as HostComponent<NativeProps>;

package/src/specs/RNMBXRasterParticleLayerNativeComponent.ts

@@ -0,0 +1,39 @@
+import type { HostComponent, ViewProps } from 'react-native';
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+// @ts-ignore - CI environment type resolution issue for CodegenTypes
+import { Double, Int32 } from 'react-native/Libraries/Types/CodegenTypes';
+
+import type { FilterExpression } from '../utils/MapboxStyles';
+
+import type { UnsafeMixed } from './codegenUtils';
+
+// @{codepart-replace-start(CommonLayerNativeComponentsProps.codepart-ts)}
+// see https://github.com/rnmapbox/maps/wiki/FabricOptionalProp
+type OptionalProp<T> = UnsafeMixed<T>;
+type Slot = 'bottom' | 'middle' | 'top';
+
+type CommonProps = {
+  sourceID?: OptionalProp<string>;
+  existing?: OptionalProp<boolean>;
+  filter?: UnsafeMixed<FilterExpression>;
+
+  aboveLayerID?: OptionalProp<string>;
+  belowLayerID?: OptionalProp<string>;
+  layerIndex?: OptionalProp<Int32>;
+
+  maxZoomLevel?: OptionalProp<Double>;
+  minZoomLevel?: OptionalProp<Double>;
+  sourceLayerID?: OptionalProp<string>;
+  slot?: OptionalProp<Slot>;
+};
+// @{codepart-replace-end}
+
+export interface NativeProps extends ViewProps, CommonProps {
+  id?: OptionalProp<string>;
+  reactStyle: UnsafeMixed<any>;
+}
+
+// @ts-ignore-error - Codegen requires single cast but TypeScript prefers double cast
+export default codegenNativeComponent<NativeProps>(
+  'RNMBXRasterParticleLayer',
+) as HostComponent<NativeProps>;

package/src/utils/MapboxStyles.ts

@@ -125,7 +125,8 @@ type ExpressionParameters =
   | 'line-progress'
   | 'heatmap-density'
   | 'measure-light'
-  | 'raster-value';
+  | 'raster-value'
+  | 'raster-particle-speed';
 
 type ResolvedImageType = ImageSourcePropType | string;
 
@@ -1913,6 +1914,50 @@ export interface RasterLayerStyleProps {
    */
   rasterElevationTransition?: Transition;
 }
+export interface RasterParticleLayerStyleProps {
+  /**
+   * Whether this layer is displayed.
+   */
+  visibility?: Value<Enum<VisibilityEnum, VisibilityEnumValues>>;
+  /**
+   * Displayed band of raster array source layer
+   */
+  rasterParticleArrayBand?: string;
+  /**
+   * Defines the amount of particles per tile.
+   */
+  rasterParticleCount?: number;
+  /**
+   * Defines a color map by which to colorize a raster particle layer, parameterized by the `["rasterParticleSpeed"]` expression and evaluated at 256 uniformly spaced steps over the range specified by `rasterParticleMaxSpeed`.
+   */
+  rasterParticleColor?: Value<string, ['raster-particle-speed']>;
+  /**
+   * Defines the maximum speed for particles. Velocities with magnitudes equal to or exceeding this value are clamped to the max value.
+   */
+  rasterParticleMaxSpeed?: number;
+  /**
+   * Defines a coefficient for the speed of particles’ motion.
+   */
+  rasterParticleSpeedFactor?: Value<number, ['zoom']>;
+
+  /**
+   * The transition affecting any changes to this layer’s rasterParticleSpeedFactor property.
+   */
+  rasterParticleSpeedFactorTransition?: Transition;
+  /**
+   * Defines defines the opacity coefficient applied to the faded particles in each frame. In practice, this property controls the length of the particle tail.
+   */
+  rasterParticleFadeOpacityFactor?: Value<number, ['zoom']>;
+
+  /**
+   * The transition affecting any changes to this layer’s rasterParticleFadeOpacityFactor property.
+   */
+  rasterParticleFadeOpacityFactorTransition?: Transition;
+  /**
+   * Defines a coefficient for a time period at which particles will restart at a random position, to avoid degeneration (empty areas without particles).
+   */
+  rasterParticleResetRateFactor?: number;
+}
 export interface HillshadeLayerStyleProps {
   /**
    * Whether this layer is displayed.
@@ -2307,6 +2352,7 @@ export type AllLayerStyleProps =
   | HeatmapLayerStyleProps
   | FillExtrusionLayerStyleProps
   | RasterLayerStyleProps
+  | RasterParticleLayerStyleProps
   | HillshadeLayerStyleProps
   | ModelLayerStyleProps
   | BackgroundLayerStyleProps