@rnmapbox/maps 10.2.8 → 10.2.10-rc.2

package/lib/typescript/src/components/CameraGestureObserver.d.ts

@@ -0,0 +1,27 @@
+import type { ViewProps } from 'react-native';
+import { 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.
+ */
+declare const _default: import("react").MemoExoticComponent<(props: Props) => import("react/jsx-runtime").JSX.Element>;
+export default _default;
+//# sourceMappingURL=CameraGestureObserver.d.ts.map

package/lib/typescript/src/components/CameraGestureObserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CameraGestureObserver.d.ts","sourceRoot":"","sources":["../../../../src/components/CameraGestureObserver.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAkD,EAChD,gBAAgB,EACjB,MAAM,oDAAoD,CAAC;AAE5D,KAAK,KAAK,GAAG,SAAS,GAAG;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,gBAAgB,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE,CAAC;AAEF;;;;GAIG;oEACyB,KAAK;AAAjC,wBAOG"}

package/lib/typescript/src/specs/RNMBXCameraGestureObserverNativeComponent.d.ts

@@ -0,0 +1,20 @@
+import type { ViewProps } from 'react-native';
+import { DirectEventHandler, Double } from 'react-native/Libraries/Types/CodegenTypes';
+import type { UnsafeMixed } from './codegenUtils';
+export type OnMapSteadyEvent = {
+    reason: 'steady' | 'timeout';
+    idleDurationMs?: Double;
+    lastGestureType?: string | null | undefined;
+    timestamp: Double;
+};
+export interface NativeProps extends ViewProps {
+    quietPeriodMs?: UnsafeMixed<number>;
+    maxIntervalMs?: UnsafeMixed<number>;
+    hasOnMapSteady: UnsafeMixed<boolean>;
+    onMapSteady?: DirectEventHandler<OnMapSteadyEvent>;
+}
+declare const _default: (props: Omit<NativeProps, "ref"> & {
+    ref?: React.Ref<import("react-native").HostInstance>;
+}) => React.ReactNode;
+export default _default;
+//# sourceMappingURL=RNMBXCameraGestureObserverNativeComponent.d.ts.map

package/lib/typescript/src/specs/RNMBXCameraGestureObserverNativeComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RNMBXCameraGestureObserverNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/specs/RNMBXCameraGestureObserverNativeComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAG,MAAM,2CAA2C,CAAC;AAExF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAE7B,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAE5C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAEpC,cAAc,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;CACpD;;;;AAED,wBAEE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rnmapbox/maps",
-  "version": "10.2.8",
+  "version": "10.2.10-rc.2",
   "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",
@@ -200,6 +201,9 @@
         "RNMBXCallout": {
           "className": "RNMBXCalloutComponentView"
         },
+        "RNMBXCameraGestureObserver": {
+          "className": "RNMBXCameraGestureObserverComponentView"
+        },
         "RNMBXCamera": {
           "className": "RNMBXCameraComponentView"
         },
@@ -295,6 +299,7 @@
         "RNMBXAtmosphere": "RNMBXAtmosphereComponentView",
         "RNMBXBackgroundLayer": "RNMBXBackgroundLayerComponentView",
         "RNMBXCallout": "RNMBXCalloutComponentView",
+        "RNMBXCameraGestureObserver": "RNMBXCameraGestureObserverComponentView",
         "RNMBXCamera": "RNMBXCameraComponentView",
         "RNMBXCircleLayer": "RNMBXCircleLayerComponentView",
         "RNMBXCustomLocationProvider": "RNMBXCustomLocationProviderComponentView",

package/src/Mapbox.native.ts

@@ -43,6 +43,8 @@ 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,

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/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',
+);