@maydon_tech/react-native-nitro-maps 0.1.4 → 0.2.0

package/lib/module/components/NitroPolyline.js

@@ -0,0 +1,115 @@
+"use strict";
+
+// src/components/NitroPolyline.tsx
+import { memo, useCallback, useEffect, useRef } from 'react';
+import { useNitroPolyline } from "../hooks/useNitroPolyline.js";
+import { parseColor, areColorsEqual, Colors } from "../utils/colors.js";
+import { validateCoordinates } from "../utils/validation.js";
+
+/**
+ * Props for the NitroPolyline component
+ */
+
+// ID generator — monotonic counter, unique within a JS runtime session
+let polylineIdCounter = 0;
+const generatePolylineId = () => `polyline_${++polylineIdCounter}`;
+
+// Default stroke color (black)
+const defaultStrokeColor = Colors.black;
+
+// ============ Custom Memo Comparison ============
+const arePropsEqual = (prev, next) => {
+  // Compare primitives
+  if (prev.id !== next.id || prev.strokeWidth !== next.strokeWidth || prev.geodesic !== next.geodesic || prev.dashed !== next.dashed || prev.zIndex !== next.zIndex || prev.tappable !== next.tappable || prev.accessibilityLabel !== next.accessibilityLabel) {
+    return false;
+  }
+
+  // Compare strokeColor
+  if (!areColorsEqual(prev.strokeColor, next.strokeColor)) {
+    return false;
+  }
+
+  // Compare coordinates array (deep)
+  const prevCoords = prev.coordinates;
+  const nextCoords = next.coordinates;
+  if (prevCoords.length !== nextCoords.length) return false;
+  for (let i = 0; i < prevCoords.length; i++) {
+    if (prevCoords[i].latitude !== nextCoords[i].latitude || prevCoords[i].longitude !== nextCoords[i].longitude) {
+      return false;
+    }
+  }
+  return true;
+};
+
+/**
+ * NitroPolyline - Draw a line connecting multiple geographic points on the map
+ *
+ * @example Basic route line
+ * ```tsx
+ * <NitroPolyline
+ *   coordinates={[
+ *     { latitude: 41.29, longitude: 69.24 },
+ *     { latitude: 41.31, longitude: 69.28 },
+ *   ]}
+ *   strokeColor="#4285F4"
+ *   strokeWidth={4}
+ * />
+ * ```
+ *
+ * @example Geodesic dashed line
+ * ```tsx
+ * <NitroPolyline
+ *   coordinates={routeCoordinates}
+ *   strokeColor="#FF0000"
+ *   strokeWidth={2}
+ *   geodesic={true}
+ *   dashed={true}
+ * />
+ * ```
+ */
+export const NitroPolyline = /*#__PURE__*/memo(function NitroPolyline({
+  id,
+  coordinates,
+  strokeColor,
+  strokeWidth = 1,
+  geodesic = false,
+  dashed = false,
+  zIndex = 0,
+  tappable = false,
+  accessibilityLabel
+}) {
+  useEffect(() => {
+    if (__DEV__) {
+      if (coordinates.length < 2) {
+        console.warn('NitroPolyline: at least 2 coordinates are required to render a visible line. ' + `Received ${coordinates.length}.`);
+      }
+      validateCoordinates(coordinates, 'NitroPolyline');
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  // Generate stable ID
+  const polylineId = useRef(id || generatePolylineId()).current;
+
+  // Build polyline data
+  const buildPolylineData = useCallback(() => ({
+    id: polylineId,
+    coordinates,
+    strokeColor: parseColor(strokeColor) ?? defaultStrokeColor,
+    strokeWidth,
+    geodesic,
+    dashed,
+    zIndex,
+    tappable,
+    accessibilityLabel
+  }), [polylineId, coordinates, strokeColor, strokeWidth, geodesic, dashed, zIndex, tappable, accessibilityLabel]);
+
+  // Use polyline lifecycle hook
+  useNitroPolyline(buildPolylineData);
+
+  // Render nothing — polyline is rendered natively
+  return null;
+}, arePropsEqual);
+export { arePropsEqual as arePolylinePropsEqual };
+export default NitroPolyline;
+//# sourceMappingURL=NitroPolyline.js.map

package/lib/module/components/NitroPolyline.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["memo","useCallback","useEffect","useRef","useNitroPolyline","parseColor","areColorsEqual","Colors","validateCoordinates","polylineIdCounter","generatePolylineId","defaultStrokeColor","black","arePropsEqual","prev","next","id","strokeWidth","geodesic","dashed","zIndex","tappable","accessibilityLabel","strokeColor","prevCoords","coordinates","nextCoords","length","i","latitude","longitude","NitroPolyline","__DEV__","console","warn","polylineId","current","buildPolylineData","arePolylinePropsEqual"],"sourceRoot":"../../../src","sources":["components/NitroPolyline.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/components/PriceMarker.js

@@ -1,9 +1,9 @@
 "use strict";
 
 // src/components/PriceMarker.tsx
-import { memo, useCallback, useMemo } from 'react';
-import { useNitroMarker } from "../hooks/useNitroMarker.js";
-import { parseColor } from "../utils/colors.js";
+import { memo, useCallback } from 'react';
+import { useNitroMarker, useMarkerHandlers } from "../hooks/useNitroMarker.js";
+import { parseColor, areColorsEqual } from "../utils/colors.js";
 
 /**
  * Props for the PriceMarker component
@@ -12,7 +12,7 @@ import { parseColor } from "../utils/colors.js";
 // ============ Custom Memo Comparison ============
 const arePropsEqual = (prevProps, nextProps) => {
   // Compare primitive props
-  if (prevProps.id !== nextProps.id || prevProps.price !== nextProps.price || prevProps.currency !== nextProps.currency || prevProps.selected !== nextProps.selected || prevProps.title !== nextProps.title || prevProps.description !== nextProps.description || prevProps.draggable !== nextProps.draggable || prevProps.opacity !== nextProps.opacity || prevProps.rotation !== nextProps.rotation || prevProps.zIndex !== nextProps.zIndex || prevProps.clusteringEnabled !== nextProps.clusteringEnabled || prevProps.animation !== nextProps.animation || prevProps.fontSize !== nextProps.fontSize || prevProps.cornerRadius !== nextProps.cornerRadius || prevProps.paddingHorizontal !== nextProps.paddingHorizontal || prevProps.paddingVertical !== nextProps.paddingVertical || prevProps.shadowOpacity !== nextProps.shadowOpacity) {
+  if (prevProps.id !== nextProps.id || prevProps.price !== nextProps.price || prevProps.currency !== nextProps.currency || prevProps.selected !== nextProps.selected || prevProps.title !== nextProps.title || prevProps.description !== nextProps.description || prevProps.draggable !== nextProps.draggable || prevProps.opacity !== nextProps.opacity || prevProps.rotation !== nextProps.rotation || prevProps.zIndex !== nextProps.zIndex || prevProps.clusteringEnabled !== nextProps.clusteringEnabled || prevProps.animation !== nextProps.animation || prevProps.animationDuration !== nextProps.animationDuration || prevProps.animateOnReappear !== nextProps.animateOnReappear || prevProps.fontSize !== nextProps.fontSize || prevProps.paddingHorizontal !== nextProps.paddingHorizontal || prevProps.paddingVertical !== nextProps.paddingVertical || prevProps.shadowOpacity !== nextProps.shadowOpacity || prevProps.accessibilityLabel !== nextProps.accessibilityLabel) {
     return false;
   }
 
@@ -25,21 +25,7 @@ const arePropsEqual = (prevProps, nextProps) => {
   if (prevProps.anchor?.x !== nextProps.anchor?.x || prevProps.anchor?.y !== nextProps.anchor?.y) {
     return false;
   }
-
-  // Compare colors (handles both hex strings and MarkerColor objects)
-  const compareColors = (a, b) => {
-    if (!a && !b) return true;
-    if (!a || !b) return false;
-    // If both are strings, compare directly
-    if (typeof a === 'string' && typeof b === 'string') return a === b;
-    // If types differ, not equal
-    if (typeof a !== typeof b) return false;
-    // Both are MarkerColor objects
-    const aColor = a;
-    const bColor = b;
-    return aColor.r === bColor.r && aColor.g === bColor.g && aColor.b === bColor.b && aColor.a === bColor.a;
-  };
-  if (!compareColors(prevProps.backgroundColor, nextProps.backgroundColor) || !compareColors(prevProps.textColor, nextProps.textColor) || !compareColors(prevProps.selectedBackgroundColor, nextProps.selectedBackgroundColor) || !compareColors(prevProps.selectedTextColor, nextProps.selectedTextColor)) {
+  if (!areColorsEqual(prevProps.backgroundColor, nextProps.backgroundColor) || !areColorsEqual(prevProps.textColor, nextProps.textColor) || !areColorsEqual(prevProps.selectedBackgroundColor, nextProps.selectedBackgroundColor) || !areColorsEqual(prevProps.selectedTextColor, nextProps.selectedTextColor)) {
     return false;
   }
   return true;
@@ -79,7 +65,7 @@ export const PriceMarker = /*#__PURE__*/memo(function PriceMarker({
   backgroundColor,
   textColor,
   fontSize = 14,
-  // cornerRadius prop kept for backwards compatibility but not used
+  // cornerRadius was removed — not forwarded to native
   selectedBackgroundColor,
   selectedTextColor,
   paddingHorizontal,
@@ -98,6 +84,9 @@ export const PriceMarker = /*#__PURE__*/memo(function PriceMarker({
   },
   clusteringEnabled = true,
   animation = 'none',
+  animationDuration = 0.3,
+  animateOnReappear = true,
+  accessibilityLabel,
   // Events
   onPress,
   onDragStart,
@@ -126,13 +115,8 @@ export const PriceMarker = /*#__PURE__*/memo(function PriceMarker({
     };
   }, [price, currency, selected, backgroundColor, textColor, fontSize, selectedBackgroundColor, selectedTextColor, paddingHorizontal, paddingVertical, shadowOpacity]);
 
-  // Memoize handlers
-  const handlers = useMemo(() => ({
-    onPress,
-    onDragStart,
-    onDrag,
-    onDragEnd
-  }), [onPress, onDragStart, onDrag, onDragEnd]);
+  // Memoize handlers via shared hook
+  const handlers = useMarkerHandlers(onPress, onDragStart, onDrag, onDragEnd);
 
   // Build full marker data
   const buildMarkerData = useCallback(markerId => ({
@@ -147,8 +131,11 @@ export const PriceMarker = /*#__PURE__*/memo(function PriceMarker({
     anchor,
     clusteringEnabled,
     config: buildMarkerConfig(),
-    animation
-  }), [coordinate, title, description, draggable, opacity, rotation, zIndex, anchor, clusteringEnabled, buildMarkerConfig, animation]);
+    accessibilityLabel,
+    animation,
+    animationDuration,
+    animateOnReappear
+  }), [coordinate, title, description, draggable, opacity, rotation, zIndex, anchor, clusteringEnabled, buildMarkerConfig, accessibilityLabel, animation, animationDuration, animateOnReappear]);
 
   // Use shared marker hook
   useNitroMarker({

package/lib/module/components/PriceMarker.js.map

@@ -1 +1 @@
-{"version":3,"names":["memo","useCallback","useMemo","useNitroMarker","parseColor","arePropsEqual","prevProps","nextProps","id","price","currency","selected","title","description","draggable","opacity","rotation","zIndex","clusteringEnabled","animation","fontSize","cornerRadius","paddingHorizontal","paddingVertical","shadowOpacity","coordinate","latitude","longitude","anchor","x","y","compareColors","a","b","aColor","bColor","r","g","backgroundColor","textColor","selectedBackgroundColor","selectedTextColor","PriceMarker","onPress","onDragStart","onDrag","onDragEnd","buildMarkerConfig","style","priceMarker","handlers","buildMarkerData","markerId","config","idPrefix","providedId"],"sourceRoot":"../../../src","sources":["components/PriceMarker.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["memo","useCallback","useNitroMarker","useMarkerHandlers","parseColor","areColorsEqual","arePropsEqual","prevProps","nextProps","id","price","currency","selected","title","description","draggable","opacity","rotation","zIndex","clusteringEnabled","animation","animationDuration","animateOnReappear","fontSize","paddingHorizontal","paddingVertical","shadowOpacity","accessibilityLabel","coordinate","latitude","longitude","anchor","x","y","backgroundColor","textColor","selectedBackgroundColor","selectedTextColor","PriceMarker","onPress","onDragStart","onDrag","onDragEnd","buildMarkerConfig","style","priceMarker","handlers","buildMarkerData","markerId","config","idPrefix","providedId"],"sourceRoot":"../../../src","sources":["components/PriceMarker.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/context/NitroMapContext.js.map

@@ -1 +1 @@
-{"version":3,"names":["createContext","NitroMapContext","displayName"],"sourceRoot":"../../../src","sources":["context/NitroMapContext.tsx"],"mappings":";;AAAA;AACA,SAASA,aAAa,QAAQ,OAAO;;AAIrC;;AAQA;;AAeA;AACA,OAAO,MAAMC,eAAe,gBAAGD,aAAa,CAA8B,IAAI,CAAC;;AAE/E;AACAC,eAAe,CAACC,WAAW,GAAG,iBAAiB","ignoreList":[]}
+{"version":3,"names":["createContext","NitroMapContext","displayName"],"sourceRoot":"../../../src","sources":["context/NitroMapContext.tsx"],"mappings":";;AAAA;AACA,SAASA,aAAa,QAAQ,OAAO;;AAIrC;;AAQA;;AAmBA;AACA,OAAO,MAAMC,eAAe,gBAAGD,aAAa,CAA8B,IAAI,CAAC;;AAE/E;AACAC,eAAe,CAACC,WAAW,GAAG,iBAAiB","ignoreList":[]}

package/lib/module/hooks/useNitroCircle.js

@@ -0,0 +1,18 @@
+"use strict";
+
+// src/hooks/useNitroCircle.ts
+import { useCallback } from 'react';
+import { useNitroOverlay } from "./useNitroOverlay.js";
+/**
+ * Hook for circle lifecycle management.
+ * Adds circle on mount, updates on prop changes, removes on unmount.
+ */
+export function useNitroCircle(buildCircleData) {
+  const getMethods = useCallback(mapRef => ({
+    add: data => mapRef.addCircle(data),
+    update: data => mapRef.updateCircle(data),
+    remove: id => mapRef.removeCircle(id)
+  }), []);
+  useNitroOverlay(buildCircleData, getMethods);
+}
+//# sourceMappingURL=useNitroCircle.js.map

package/lib/module/hooks/useNitroCircle.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useNitroOverlay","useNitroCircle","buildCircleData","getMethods","mapRef","add","data","addCircle","update","updateCircle","remove","id","removeCircle"],"sourceRoot":"../../../src","sources":["hooks/useNitroCircle.ts"],"mappings":";;AAAA;AACA,SAASA,WAAW,QAAQ,OAAO;AACnC,SAASC,eAAe,QAAQ,sBAAmB;AAGnD;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAACC,eAAiC,EAAQ;EACtE,MAAMC,UAAU,GAAGJ,WAAW,CAC3BK,MAIA,KAAM;IACLC,GAAG,EAAGC,IAAgB,IAAKF,MAAM,CAACG,SAAS,CAACD,IAAI,CAAC;IACjDE,MAAM,EAAGF,IAAgB,IAAKF,MAAM,CAACK,YAAY,CAACH,IAAI,CAAC;IACvDI,MAAM,EAAGC,EAAU,IAAKP,MAAM,CAACQ,YAAY,CAACD,EAAE;EAChD,CAAC,CAAC,EACF,EACF,CAAC;EAEDX,eAAe,CAACE,eAAe,EAAEC,UAAU,CAAC;AAC9C","ignoreList":[]}

package/lib/module/hooks/useNitroMarker.js

@@ -1,8 +1,9 @@
 "use strict";
 
 // src/hooks/useNitroMarker.ts
-import { useContext, useEffect, useRef, useCallback } from 'react';
+import { useContext, useEffect, useRef, useMemo } from 'react';
 import { NitroMapContext } from "../context/NitroMapContext.js";
+import { validateCoordinate } from "../utils/validation.js";
 
 /**
  * Base marker data structure for internal use
@@ -12,9 +13,10 @@ import { NitroMapContext } from "../context/NitroMapContext.js";
  * Props shared by all marker components
  */
 
-// ID generator
+// Module-level monotonic counter for generating unique marker IDs.
+// Monotonically increasing — guaranteed unique within a JS runtime session.
 let markerIdCounter = 0;
-const generateMarkerId = prefix => `${prefix}_${++markerIdCounter}_${Date.now()}`;
+const generateMarkerId = prefix => `${prefix}_${++markerIdCounter}`;
 
 /**
  * Hook options for useNitroMarker
@@ -42,7 +44,9 @@ export function useNitroMarker({
   // ============ Register Event Handlers ============
   useEffect(() => {
     if (!mapContext) {
-      console.warn(`${idPrefix} must be used inside NitroMap`);
+      if (__DEV__) {
+        console.warn(`${idPrefix} must be used inside NitroMap`);
+      }
       return;
     }
 
@@ -53,7 +57,8 @@ export function useNitroMarker({
     return () => {
       mapContext.unregisterMarkerHandler(markerId);
     };
-    // We intentionally depend on individual handler properties instead of the handlers object
+    // Handlers are spread into individual deps so the effect re-runs
+    // only when a specific handler changes, not when the object ref changes.
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [markerId, mapContext, handlers.onPress, handlers.onDragStart, handlers.onDrag, handlers.onDragEnd, idPrefix]);
 
@@ -65,15 +70,25 @@ export function useNitroMarker({
       return;
     }
 
+    // Track marker ID for duplicate detection
+    mapContext?.trackMarkerId(markerId);
+
+    // Validate coordinate in dev mode
+    const markerData = buildMarkerData(markerId);
+    validateCoordinate(markerData.coordinate, `marker "${markerId}"`);
+
     // Add marker on mount
-    mapRef.addMarker(buildMarkerData(markerId));
+    mapRef.addMarker(markerData);
     isAddedRef.current = true;
 
     // Remove marker only on unmount
     return () => {
+      mapContext?.untrackMarkerId(markerId);
       mapRef?.removeMarker(markerId);
       isAddedRef.current = false;
     };
+    // buildMarkerData is intentionally excluded — we only want mount/unmount behavior.
+    // Updates are handled by the third useEffect below.
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [mapRef, markerId]); // mapRef is now properly tracked
 
@@ -85,7 +100,9 @@ export function useNitroMarker({
     }
 
     // Update marker with new data
-    mapContext.mapRef.updateMarker(buildMarkerData(markerId));
+    const updatedData = buildMarkerData(markerId);
+    validateCoordinate(updatedData.coordinate, `marker "${markerId}"`);
+    mapContext.mapRef.updateMarker(updatedData);
   }, [mapContext, buildMarkerData, markerId]);
   return markerId;
 }
@@ -94,11 +111,11 @@ export function useNitroMarker({
  * Create stable handlers object that won't cause unnecessary re-renders
  */
 export function useMarkerHandlers(onPress, onDragStart, onDrag, onDragEnd) {
-  return useCallback(() => ({
+  return useMemo(() => ({
     onPress,
     onDragStart,
     onDrag,
     onDragEnd
-  }), [onPress, onDragStart, onDrag, onDragEnd])();
+  }), [onPress, onDragStart, onDrag, onDragEnd]);
 }
 //# sourceMappingURL=useNitroMarker.js.map

package/lib/module/hooks/useNitroMarker.js.map

@@ -1 +1 @@
-{"version":3,"names":["useContext","useEffect","useRef","useCallback","NitroMapContext","markerIdCounter","generateMarkerId","prefix","Date","now","useNitroMarker","idPrefix","providedId","handlers","buildMarkerData","markerId","current","mapContext","isAddedRef","console","warn","registerMarkerHandler","unregisterMarkerHandler","onPress","onDragStart","onDrag","onDragEnd","mapRef","addMarker","removeMarker","updateMarker","useMarkerHandlers"],"sourceRoot":"../../../src","sources":["hooks/useNitroMarker.ts"],"mappings":";;AAAA;AACA,SAASA,UAAU,EAAEC,SAAS,EAAEC,MAAM,EAAEC,WAAW,QAAQ,OAAO;AAClE,SACEC,eAAe,QAEV,+BAA4B;;AAInC;AACA;AACA;;AAgBA;AACA;AACA;;AAgDA;AACA,IAAIC,eAAe,GAAG,CAAC;AACvB,MAAMC,gBAAgB,GAAIC,MAAc,IACtC,GAAGA,MAAM,IAAI,EAAEF,eAAe,IAAIG,IAAI,CAACC,GAAG,CAAC,CAAC,EAAE;;AAEhD;AACA;AACA;;AAeA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAC;EAC7BC,QAAQ;EACRC,UAAU;EACVC,QAAQ;EACRC;AACqB,CAAC,EAAU;EAChC;EACA,MAAMC,QAAQ,GAAGb,MAAM,CAACU,UAAU,IAAIN,gBAAgB,CAACK,QAAQ,CAAC,CAAC,CAACK,OAAO;;EAEzE;EACA,MAAMC,UAAU,GAAGjB,UAAU,CAACI,eAAe,CAAC;;EAE9C;EACA,MAAMc,UAAU,GAAGhB,MAAM,CAAC,KAAK,CAAC;;EAEhC;EACAD,SAAS,CAAC,MAAM;IACd,IAAI,CAACgB,UAAU,EAAE;MACfE,OAAO,CAACC,IAAI,CAAC,GAAGT,QAAQ,+BAA+B,CAAC;MACxD;IACF;;IAEA;IACAM,UAAU,CAACI,qBAAqB,CAACN,QAAQ,EAAEF,QAAQ,CAAC;;IAEpD;IACA,OAAO,MAAM;MACXI,UAAU,CAACK,uBAAuB,CAACP,QAAQ,CAAC;IAC9C,CAAC;IACD;IACA;EACF,CAAC,EAAE,CACDA,QAAQ,EACRE,UAAU,EACVJ,QAAQ,CAACU,OAAO,EAChBV,QAAQ,CAACW,WAAW,EACpBX,QAAQ,CAACY,MAAM,EACfZ,QAAQ,CAACa,SAAS,EAClBf,QAAQ,CACT,CAAC;;EAEF;EACA;EACA,MAAMgB,MAAM,GAAGV,UAAU,EAAEU,MAAM;EAEjC1B,SAAS,CAAC,MAAM;IACd,IAAI,CAAC0B,MAAM,EAAE;MACX;IACF;;IAEA;IACAA,MAAM,CAACC,SAAS,CAACd,eAAe,CAACC,QAAQ,CAAC,CAAC;IAC3CG,UAAU,CAACF,OAAO,GAAG,IAAI;;IAEzB;IACA,OAAO,MAAM;MACXW,MAAM,EAAEE,YAAY,CAACd,QAAQ,CAAC;MAC9BG,UAAU,CAACF,OAAO,GAAG,KAAK;IAC5B,CAAC;IACD;EACF,CAAC,EAAE,CAACW,MAAM,EAAEZ,QAAQ,CAAC,CAAC,CAAC,CAAC;;EAExB;EACAd,SAAS,CAAC,MAAM;IACd;IACA,IAAI,CAACiB,UAAU,CAACF,OAAO,IAAI,CAACC,UAAU,EAAEU,MAAM,EAAE;MAC9C;IACF;;IAEA;IACAV,UAAU,CAACU,MAAM,CAACG,YAAY,CAAChB,eAAe,CAACC,QAAQ,CAAC,CAAC;EAC3D,CAAC,EAAE,CAACE,UAAU,EAAEH,eAAe,EAAEC,QAAQ,CAAC,CAAC;EAE3C,OAAOA,QAAQ;AACjB;;AAEA;AACA;AACA;AACA,OAAO,SAASgB,iBAAiBA,CAC/BR,OAAoB,EACpBC,WAA8C,EAC9CC,MAAyC,EACzCC,SAA4C,EAC5B;EAChB,OAAOvB,WAAW,CAChB,OAAO;IACLoB,OAAO;IACPC,WAAW;IACXC,MAAM;IACNC;EACF,CAAC,CAAC,EACF,CAACH,OAAO,EAAEC,WAAW,EAAEC,MAAM,EAAEC,SAAS,CAC1C,CAAC,CAAC,CAAC;AACL","ignoreList":[]}
+{"version":3,"names":["useContext","useEffect","useRef","useMemo","NitroMapContext","validateCoordinate","markerIdCounter","generateMarkerId","prefix","useNitroMarker","idPrefix","providedId","handlers","buildMarkerData","markerId","current","mapContext","isAddedRef","__DEV__","console","warn","registerMarkerHandler","unregisterMarkerHandler","onPress","onDragStart","onDrag","onDragEnd","mapRef","trackMarkerId","markerData","coordinate","addMarker","untrackMarkerId","removeMarker","updatedData","updateMarker","useMarkerHandlers"],"sourceRoot":"../../../src","sources":["hooks/useNitroMarker.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/hooks/useNitroOverlay.js

@@ -0,0 +1,59 @@
+"use strict";
+
+// src/hooks/useNitroOverlay.ts
+import { useContext, useEffect, useRef } from 'react';
+import { NitroMapContext } from "../context/NitroMapContext.js";
+
+/**
+ * Overlay method names used by the generic hook.
+ * Maps each overlay type to its add/update/remove native methods.
+ */
+
+/**
+ * Generic hook for overlay lifecycle management (polyline, polygon, circle).
+ * Adds overlay on mount, updates on prop changes, removes on unmount.
+ *
+ * Eliminates copy-paste between useNitroPolyline/useNitroPolygon/useNitroCircle.
+ *
+ * @param buildData - Memoized function that builds the overlay data object.
+ * @param getMethods - Function that extracts add/update/remove methods from the map ref.
+ */
+export function useNitroOverlay(buildData, getMethods) {
+  const mapContext = useContext(NitroMapContext);
+  const isAddedRef = useRef(false);
+  const idRef = useRef(null);
+  const isInitialMount = useRef(true);
+  const mapRef = mapContext?.mapRef;
+
+  // Add on mount, remove on unmount.
+  // buildData is intentionally excluded from deps — we only want mount/unmount behavior.
+  // Updates are handled by the second useEffect below.
+  useEffect(() => {
+    if (!mapRef) return;
+    const data = buildData();
+    const methods = getMethods(mapRef);
+    idRef.current = data.id;
+    methods.add(data);
+    isAddedRef.current = true;
+    return () => {
+      if (idRef.current) {
+        methods.remove(idRef.current);
+      }
+      isAddedRef.current = false;
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [mapRef]);
+
+  // Update when props change (buildData reference changes on prop changes via useCallback).
+  // Skip the initial mount — the first useEffect already added the overlay.
+  useEffect(() => {
+    if (isInitialMount.current) {
+      isInitialMount.current = false;
+      return;
+    }
+    if (!isAddedRef.current || !mapContext?.mapRef) return;
+    const methods = getMethods(mapContext.mapRef);
+    methods.update(buildData());
+  }, [mapContext, buildData, getMethods]);
+}
+//# sourceMappingURL=useNitroOverlay.js.map

package/lib/module/hooks/useNitroOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useContext","useEffect","useRef","NitroMapContext","useNitroOverlay","buildData","getMethods","mapContext","isAddedRef","idRef","isInitialMount","mapRef","data","methods","current","id","add","remove","update"],"sourceRoot":"../../../src","sources":["hooks/useNitroOverlay.ts"],"mappings":";;AAAA;AACA,SAASA,UAAU,EAAEC,SAAS,EAAEC,MAAM,QAAQ,OAAO;AACrD,SAASC,eAAe,QAAQ,+BAA4B;;AAG5D;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAC7BC,SAAkB,EAClBC,UAA0D,EACpD;EACN,MAAMC,UAAU,GAAGP,UAAU,CAACG,eAAe,CAAC;EAC9C,MAAMK,UAAU,GAAGN,MAAM,CAAC,KAAK,CAAC;EAChC,MAAMO,KAAK,GAAGP,MAAM,CAAgB,IAAI,CAAC;EACzC,MAAMQ,cAAc,GAAGR,MAAM,CAAC,IAAI,CAAC;EAEnC,MAAMS,MAAM,GAAGJ,UAAU,EAAEI,MAAM;;EAEjC;EACA;EACA;EACAV,SAAS,CAAC,MAAM;IACd,IAAI,CAACU,MAAM,EAAE;IAEb,MAAMC,IAAI,GAAGP,SAAS,CAAC,CAAC;IACxB,MAAMQ,OAAO,GAAGP,UAAU,CAACK,MAAM,CAAC;IAClCF,KAAK,CAACK,OAAO,GAAGF,IAAI,CAACG,EAAE;IACvBF,OAAO,CAACG,GAAG,CAACJ,IAAI,CAAC;IACjBJ,UAAU,CAACM,OAAO,GAAG,IAAI;IAEzB,OAAO,MAAM;MACX,IAAIL,KAAK,CAACK,OAAO,EAAE;QACjBD,OAAO,CAACI,MAAM,CAACR,KAAK,CAACK,OAAO,CAAC;MAC/B;MACAN,UAAU,CAACM,OAAO,GAAG,KAAK;IAC5B,CAAC;IACD;EACF,CAAC,EAAE,CAACH,MAAM,CAAC,CAAC;;EAEZ;EACA;EACAV,SAAS,CAAC,MAAM;IACd,IAAIS,cAAc,CAACI,OAAO,EAAE;MAC1BJ,cAAc,CAACI,OAAO,GAAG,KAAK;MAC9B;IACF;IACA,IAAI,CAACN,UAAU,CAACM,OAAO,IAAI,CAACP,UAAU,EAAEI,MAAM,EAAE;IAChD,MAAME,OAAO,GAAGP,UAAU,CAACC,UAAU,CAACI,MAAM,CAAC;IAC7CE,OAAO,CAACK,MAAM,CAACb,SAAS,CAAC,CAAC,CAAC;EAC7B,CAAC,EAAE,CAACE,UAAU,EAAEF,SAAS,EAAEC,UAAU,CAAC,CAAC;AACzC","ignoreList":[]}

package/lib/module/hooks/useNitroPolygon.js

@@ -0,0 +1,18 @@
+"use strict";
+
+// src/hooks/useNitroPolygon.ts
+import { useCallback } from 'react';
+import { useNitroOverlay } from "./useNitroOverlay.js";
+/**
+ * Hook for polygon lifecycle management.
+ * Adds polygon on mount, updates on prop changes, removes on unmount.
+ */
+export function useNitroPolygon(buildPolygonData) {
+  const getMethods = useCallback(mapRef => ({
+    add: data => mapRef.addPolygon(data),
+    update: data => mapRef.updatePolygon(data),
+    remove: id => mapRef.removePolygon(id)
+  }), []);
+  useNitroOverlay(buildPolygonData, getMethods);
+}
+//# sourceMappingURL=useNitroPolygon.js.map

package/lib/module/hooks/useNitroPolygon.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useNitroOverlay","useNitroPolygon","buildPolygonData","getMethods","mapRef","add","data","addPolygon","update","updatePolygon","remove","id","removePolygon"],"sourceRoot":"../../../src","sources":["hooks/useNitroPolygon.ts"],"mappings":";;AAAA;AACA,SAASA,WAAW,QAAQ,OAAO;AACnC,SAASC,eAAe,QAAQ,sBAAmB;AAGnD;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAACC,gBAAmC,EAAQ;EACzE,MAAMC,UAAU,GAAGJ,WAAW,CAC3BK,MAIA,KAAM;IACLC,GAAG,EAAGC,IAAiB,IAAKF,MAAM,CAACG,UAAU,CAACD,IAAI,CAAC;IACnDE,MAAM,EAAGF,IAAiB,IAAKF,MAAM,CAACK,aAAa,CAACH,IAAI,CAAC;IACzDI,MAAM,EAAGC,EAAU,IAAKP,MAAM,CAACQ,aAAa,CAACD,EAAE;EACjD,CAAC,CAAC,EACF,EACF,CAAC;EAEDX,eAAe,CAACE,gBAAgB,EAAEC,UAAU,CAAC;AAC/C","ignoreList":[]}

package/lib/module/hooks/useNitroPolyline.js

@@ -0,0 +1,18 @@
+"use strict";
+
+// src/hooks/useNitroPolyline.ts
+import { useCallback } from 'react';
+import { useNitroOverlay } from "./useNitroOverlay.js";
+/**
+ * Hook for polyline lifecycle management.
+ * Adds polyline on mount, updates on prop changes, removes on unmount.
+ */
+export function useNitroPolyline(buildPolylineData) {
+  const getMethods = useCallback(mapRef => ({
+    add: data => mapRef.addPolyline(data),
+    update: data => mapRef.updatePolyline(data),
+    remove: id => mapRef.removePolyline(id)
+  }), []);
+  useNitroOverlay(buildPolylineData, getMethods);
+}
+//# sourceMappingURL=useNitroPolyline.js.map

package/lib/module/hooks/useNitroPolyline.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useNitroOverlay","useNitroPolyline","buildPolylineData","getMethods","mapRef","add","data","addPolyline","update","updatePolyline","remove","id","removePolyline"],"sourceRoot":"../../../src","sources":["hooks/useNitroPolyline.ts"],"mappings":";;AAAA;AACA,SAASA,WAAW,QAAQ,OAAO;AACnC,SAASC,eAAe,QAAQ,sBAAmB;AAGnD;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACC,iBAAqC,EAAQ;EAC5E,MAAMC,UAAU,GAAGJ,WAAW,CAC3BK,MAIA,KAAM;IACLC,GAAG,EAAGC,IAAkB,IAAKF,MAAM,CAACG,WAAW,CAACD,IAAI,CAAC;IACrDE,MAAM,EAAGF,IAAkB,IAAKF,MAAM,CAACK,cAAc,CAACH,IAAI,CAAC;IAC3DI,MAAM,EAAGC,EAAU,IAAKP,MAAM,CAACQ,cAAc,CAACD,EAAE;EAClD,CAAC,CAAC,EACF,EACF,CAAC;EAEDX,eAAe,CAACE,iBAAiB,EAAEC,UAAU,CAAC;AAChD","ignoreList":[]}

package/lib/module/index.js

@@ -8,9 +8,14 @@ export { NitroMap, default } from "./components/NitroMap.js";
 // New specialized marker components
 export { PriceMarker } from "./components/PriceMarker.js";
 export { ImageMarker } from "./components/ImageMarker.js";
+export { Marker } from "./components/Marker.js";
+export { NitroPolyline } from "./components/NitroPolyline.js";
+export { NitroPolygon } from "./components/NitroPolygon.js";
+export { NitroCircle } from "./components/NitroCircle.js";
 
 // ============ Types ============
 
+export { NitroMapContext } from "./context/NitroMapContext.js";
 export { NitroMapInitialize, IsNitroMapInitialized, getDefaultProvider } from "./modules/index.js";
 
 // Marker component props

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NitroMap","default","PriceMarker","ImageMarker","NitroMapInitialize","IsNitroMapInitialized","getDefaultProvider","rgb","hex","Colors"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA;;AAEA;AACA,SAASA,QAAQ,EAAEC,OAAO,QAAQ,0BAAuB;;AAEzD;AACA,SAASC,WAAW,QAAQ,6BAA0B;AACtD,SAASC,WAAW,QAAQ,6BAA0B;;AAEtD;;AAqCA,SACEC,kBAAkB,EAClBC,qBAAqB,EACrBC,kBAAkB,QAEb,oBAAW;;AAElB;;AAKA;AACA;AACA,SAASC,GAAG,EAAEC,GAAG,EAAEC,MAAM,QAAQ,mBAAgB","ignoreList":[]}
+{"version":3,"names":["NitroMap","default","PriceMarker","ImageMarker","Marker","NitroPolyline","NitroPolygon","NitroCircle","NitroMapContext","NitroMapInitialize","IsNitroMapInitialized","getDefaultProvider","rgb","hex","Colors"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA;;AAEA;AACA,SAASA,QAAQ,EAAEC,OAAO,QAAQ,0BAAuB;;AAEzD;AACA,SAASC,WAAW,QAAQ,6BAA0B;AACtD,SAASC,WAAW,QAAQ,6BAA0B;AACtD,SAASC,MAAM,QAAQ,wBAAqB;AAC5C,SAASC,aAAa,QAAQ,+BAA4B;AAC1D,SAASC,YAAY,QAAQ,8BAA2B;AACxD,SAASC,WAAW,QAAQ,6BAA0B;;AAEtD;;AAGA,SAASC,eAAe,QAAQ,8BAA2B;AA+C3D,SACEC,kBAAkB,EAClBC,qBAAqB,EACrBC,kBAAkB,QAEb,oBAAW;;AAElB;;AASA;AACA;AACA,SAASC,GAAG,EAAEC,GAAG,EAAEC,MAAM,QAAQ,mBAAgB","ignoreList":[]}

package/lib/module/types/overlay.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=overlay.js.map

package/lib/module/types/overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/overlay.ts"],"mappings":"","ignoreList":[]}

package/lib/module/types/theme.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=theme.js.map

package/lib/module/types/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/theme.ts"],"mappings":"","ignoreList":[]}

package/lib/module/utils/colors.js

@@ -43,18 +43,6 @@ export const parseColor = (color, defaultAlpha = 255) => {
   return undefined;
 };
 
-/**
- * Parse a ColorValue with a fallback default color
- * @param color - Color value (hex string or MarkerColor)
- * @param fallback - Fallback MarkerColor if parsing fails
- * @returns MarkerColor object
- * @internal
- */
-export const parseColorWithFallback = (color, fallback) => {
-  const parsed = parseColor(color);
-  return parsed ?? fallback;
-};
-
 /**
  * Create a MarkerColor from RGB values
  * @param r - Red component (0-255)
@@ -88,7 +76,18 @@ export const rgb = (r, g, b, a = 255) => ({
  * ```
  */
 export const hex = (hexStr, alpha = 255) => {
-  // Try 6-char hex first (#RRGGBB or RRGGBB)
+  // Try 8-char hex first (#RRGGBBAA or RRGGBBAA)
+  const result8 = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hexStr);
+  if (result8) {
+    return {
+      r: parseInt(result8[1], 16),
+      g: parseInt(result8[2], 16),
+      b: parseInt(result8[3], 16),
+      a: parseInt(result8[4], 16)
+    };
+  }
+
+  // Try 6-char hex (#RRGGBB or RRGGBB)
   const result6 = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hexStr);
   if (result6) {
     return {
@@ -99,6 +98,17 @@ export const hex = (hexStr, alpha = 255) => {
     };
   }
 
+  // Try 4-char hex (#RGBA or RGBA)
+  const result4 = /^#?([a-f\d])([a-f\d])([a-f\d])([a-f\d])$/i.exec(hexStr);
+  if (result4) {
+    return {
+      r: parseInt(result4[1] + result4[1], 16),
+      g: parseInt(result4[2] + result4[2], 16),
+      b: parseInt(result4[3] + result4[3], 16),
+      a: parseInt(result4[4] + result4[4], 16)
+    };
+  }
+
   // Try 3-char hex (#RGB or RGB)
   const result3 = /^#?([a-f\d])([a-f\d])([a-f\d])$/i.exec(hexStr);
   if (result3) {
@@ -111,6 +121,9 @@ export const hex = (hexStr, alpha = 255) => {
   }
 
   // Fallback to black
+  if (__DEV__) {
+    console.warn(`hex(): invalid hex color string "${hexStr}". Falling back to black.`);
+  }
   return {
     r: 0,
     g: 0,
@@ -144,4 +157,19 @@ export const Colors = {
   /** Light gray (240, 240, 240) */
   lightGray: rgb(240, 240, 240)
 };
+
+/**
+ * Compare two ColorValue values for equality.
+ * Handles both hex strings and MarkerColor objects.
+ * @internal Used by component memo comparators to avoid duplication.
+ */
+export const areColorsEqual = (a, b) => {
+  if (a === b) return true;
+  if (!a || !b) return false;
+  if (typeof a !== typeof b) return false;
+  if (typeof a === 'string' && typeof b === 'string') return a === b;
+  const ca = a;
+  const cb = b;
+  return ca.r === cb.r && ca.g === cb.g && ca.b === cb.b && ca.a === cb.a;
+};
 //# sourceMappingURL=colors.js.map