@rnmapbox/maps 10.2.6 → 10.2.8

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/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

package/src/utils/styleMap.ts

@@ -265,6 +265,16 @@ const styleMap = {
   rasterElevation: StyleTypes.Constant,
   rasterElevationTransition: StyleTypes.Transition,
 
+  rasterParticleArrayBand: StyleTypes.Constant,
+  rasterParticleCount: StyleTypes.Constant,
+  rasterParticleColor: StyleTypes.Color,
+  rasterParticleMaxSpeed: StyleTypes.Constant,
+  rasterParticleSpeedFactor: StyleTypes.Constant,
+  rasterParticleSpeedFactorTransition: StyleTypes.Transition,
+  rasterParticleFadeOpacityFactor: StyleTypes.Constant,
+  rasterParticleFadeOpacityFactorTransition: StyleTypes.Transition,
+  rasterParticleResetRateFactor: StyleTypes.Constant,
+
   hillshadeIlluminationDirection: StyleTypes.Constant,
   hillshadeIlluminationAnchor: StyleTypes.Enum,
   hillshadeExaggeration: StyleTypes.Constant,