@trackunit/react-map-adapter-shared 0.0.138 → 0.0.140

package/index.cjs.js

@@ -816,6 +816,18 @@ const MAX_ZOOM = 22;
  * Amount to pan the map when using arrow keys (in pixels)
  */
 const KEYBOARD_PAN_AMOUNT = 100;
+/**
+ * Minimum zoom level at which adapters render the traffic overlay.
+ *
+ * Google draws motorway traffic even at country/continent zoom (TrafficLayer
+ * has no zoom option), which reads as noise on a map full of markers and
+ * geofences. Below this zoom, adapters detach/hide traffic while the
+ * `showTraffic` preference stays untouched. Shared so every adapter applies
+ * the same threshold (Mapbox can pass it as a native layer `minzoom`).
+ *
+ * Not user-configurable by design; the value is a product/design decision.
+ */
+const TRAFFIC_MIN_ZOOM = 7;
 /**
  * Amount to zoom when using +/- keys
  */
@@ -1820,12 +1832,17 @@ const mapAppearanceSchema = zod.z.object({
     theme: mapThemeSchema,
     mapType: mapTypeSchema,
     showRoads: zod.z.boolean(),
+    // Optional so appearance literals written before traffic existed (including
+    // external adapters built against an older contract) keep compiling and
+    // validating; absent means false.
+    showTraffic: zod.z.boolean().optional(),
 });
 /** Default appearance before any user preference is applied */
 const DEFAULT_MAP_APPEARANCE = {
     theme: "light",
     mapType: "roadmap",
     showRoads: false,
+    showTraffic: false,
 };
 const INITIAL_CAMERA_STATE = {
     center: [0, 0],
@@ -2678,6 +2695,7 @@ exports.MAP_CURSORS = MAP_CURSORS;
 exports.MAX_ZOOM = MAX_ZOOM;
 exports.MIN_ZOOM = MIN_ZOOM;
 exports.SAFE_AREA_DEFAULT_BUFFER_PX = SAFE_AREA_DEFAULT_BUFFER_PX;
+exports.TRAFFIC_MIN_ZOOM = TRAFFIC_MIN_ZOOM;
 exports.WORLD_BBOX = WORLD_BBOX;
 exports.allocSafeAreaDebugId = allocSafeAreaDebugId;
 exports.anchorFromBottomCenter = anchorFromBottomCenter;

package/index.esm.js

@@ -814,6 +814,18 @@ const MAX_ZOOM = 22;
  * Amount to pan the map when using arrow keys (in pixels)
  */
 const KEYBOARD_PAN_AMOUNT = 100;
+/**
+ * Minimum zoom level at which adapters render the traffic overlay.
+ *
+ * Google draws motorway traffic even at country/continent zoom (TrafficLayer
+ * has no zoom option), which reads as noise on a map full of markers and
+ * geofences. Below this zoom, adapters detach/hide traffic while the
+ * `showTraffic` preference stays untouched. Shared so every adapter applies
+ * the same threshold (Mapbox can pass it as a native layer `minzoom`).
+ *
+ * Not user-configurable by design; the value is a product/design decision.
+ */
+const TRAFFIC_MIN_ZOOM = 7;
 /**
  * Amount to zoom when using +/- keys
  */
@@ -1818,12 +1830,17 @@ const mapAppearanceSchema = z.object({
     theme: mapThemeSchema,
     mapType: mapTypeSchema,
     showRoads: z.boolean(),
+    // Optional so appearance literals written before traffic existed (including
+    // external adapters built against an older contract) keep compiling and
+    // validating; absent means false.
+    showTraffic: z.boolean().optional(),
 });
 /** Default appearance before any user preference is applied */
 const DEFAULT_MAP_APPEARANCE = {
     theme: "light",
     mapType: "roadmap",
     showRoads: false,
+    showTraffic: false,
 };
 const INITIAL_CAMERA_STATE = {
     center: [0, 0],
@@ -2657,4 +2674,4 @@ const resolveStrokeColors = (style, shapeType, theme) => {
     };
 };
 
-export { ANCHOR_SELECTOR, CIRCLE_SYMBOL_DEFAULT_DIAMETER_PX, CIRCLE_SYMBOL_DEFAULT_OPACITY, DEFAULT_CENTER, DEFAULT_MAP_APPEARANCE, DEFAULT_ZOOM, GEODESIC_MAX_SEGMENT_KM, HIT_SURFACE_SELECTOR, INITIAL_CAMERA_STATE, INITIAL_INTERACTION_STATE, INITIAL_MAP_STATE, INITIAL_MAP_STATUS, KEYBOARD_PAN_AMOUNT, KEYBOARD_ZOOM_AMOUNT, LAYER_FADE_DURATION_MS, MAP_CURSORS, MAX_ZOOM, MIN_ZOOM, SAFE_AREA_DEFAULT_BUFFER_PX, WORLD_BBOX, allocSafeAreaDebugId, anchorFromBottomCenter, angularDistance, attachSafeAreaHoverListeners, bboxEquals, bufferRectCorners, buildAdaptiveDomEntries, buildAdaptiveDomRenderFn, buildAdaptiveSymbolStyleFn, cameraStateEquals, canPatchAdaptiveMarker, canPatchAdaptiveViewport, canPatchMarkerInPlace, clearSafeArea, collectFeatureIdSet, computeInitialState, computeMarkerDomPortalZIndex, convexHull, createClusterPinElement, createDefaultClusterElement, createSymbolDotElement, defineAdapter, densifyGeodesicFeatures, disableSafeAreaDebug, discriminateRenderResult, enableSafeAreaDebug, estimateZoomFromBounds, extractLineCoordinates, extractPointCoordinates, extractPolygonPaths, extractSourceData, fadeInElement, filterRectsByCursorDirection, geometryTypeToShapeType, getAdaptiveDomFeatureIds, getAnchorRect, getEffectiveRestrictBounds, getHitSurfaceRect, googleMapCspDirectives, hasSameFeatureIds, intermediatePoint, isCanvasMarkerMode, isEventOfType, isSafeAreaDebugEnabled, mapAppearanceSchema, mapStateEquals, mapThemeSchema, mapTypeSchema, mapboxMapCspDirectives, mercatorCenterFromBounds, mergeAntimeridianFeatures, patchPortalDescriptors, pointInPolygon, removeGoneIndexedMarkers, renderSafeArea, resolveCircleSymbolDefaults, resolveHoveredStyle, resolveSelectedStyle, resolveStrokeColors, resolveSymbolDescriptor, safePolygon, toDeg, toRad, unwrapLongitudeNear, validateInitialViewport, watchSafeAreaLeave };
+export { ANCHOR_SELECTOR, CIRCLE_SYMBOL_DEFAULT_DIAMETER_PX, CIRCLE_SYMBOL_DEFAULT_OPACITY, DEFAULT_CENTER, DEFAULT_MAP_APPEARANCE, DEFAULT_ZOOM, GEODESIC_MAX_SEGMENT_KM, HIT_SURFACE_SELECTOR, INITIAL_CAMERA_STATE, INITIAL_INTERACTION_STATE, INITIAL_MAP_STATE, INITIAL_MAP_STATUS, KEYBOARD_PAN_AMOUNT, KEYBOARD_ZOOM_AMOUNT, LAYER_FADE_DURATION_MS, MAP_CURSORS, MAX_ZOOM, MIN_ZOOM, SAFE_AREA_DEFAULT_BUFFER_PX, TRAFFIC_MIN_ZOOM, WORLD_BBOX, allocSafeAreaDebugId, anchorFromBottomCenter, angularDistance, attachSafeAreaHoverListeners, bboxEquals, bufferRectCorners, buildAdaptiveDomEntries, buildAdaptiveDomRenderFn, buildAdaptiveSymbolStyleFn, cameraStateEquals, canPatchAdaptiveMarker, canPatchAdaptiveViewport, canPatchMarkerInPlace, clearSafeArea, collectFeatureIdSet, computeInitialState, computeMarkerDomPortalZIndex, convexHull, createClusterPinElement, createDefaultClusterElement, createSymbolDotElement, defineAdapter, densifyGeodesicFeatures, disableSafeAreaDebug, discriminateRenderResult, enableSafeAreaDebug, estimateZoomFromBounds, extractLineCoordinates, extractPointCoordinates, extractPolygonPaths, extractSourceData, fadeInElement, filterRectsByCursorDirection, geometryTypeToShapeType, getAdaptiveDomFeatureIds, getAnchorRect, getEffectiveRestrictBounds, getHitSurfaceRect, googleMapCspDirectives, hasSameFeatureIds, intermediatePoint, isCanvasMarkerMode, isEventOfType, isSafeAreaDebugEnabled, mapAppearanceSchema, mapStateEquals, mapThemeSchema, mapTypeSchema, mapboxMapCspDirectives, mercatorCenterFromBounds, mergeAntimeridianFeatures, patchPortalDescriptors, pointInPolygon, removeGoneIndexedMarkers, renderSafeArea, resolveCircleSymbolDefaults, resolveHoveredStyle, resolveSelectedStyle, resolveStrokeColors, resolveSymbolDescriptor, safePolygon, toDeg, toRad, unwrapLongitudeNear, validateInitialViewport, watchSafeAreaLeave };

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@trackunit/react-map-adapter-shared",
-  "version": "0.0.138",
+  "version": "0.0.140",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
     "node": ">=24.x"
   },
   "dependencies": {
-    "@trackunit/react-map-color-utils": "0.0.113",
-    "@trackunit/geo-json-utils": "1.15.53",
-    "@trackunit/ui-design-tokens": "1.15.41",
+    "@trackunit/react-map-color-utils": "0.0.115",
+    "@trackunit/geo-json-utils": "1.15.55",
+    "@trackunit/ui-design-tokens": "1.15.42",
     "es-toolkit": "^1.39.10",
     "zod": "^3.25.76"
   },

package/src/adapterContract.d.ts

@@ -85,6 +85,16 @@ export type AdapterInstance<TConfig extends Record<string, unknown> = Record<str
      * Set whether road labels are shown over satellite/hybrid imagery
      */
     setShowRoads: (showRoads: boolean) => Promise<void>;
+    /**
+     * Set whether live traffic conditions are shown on the map.
+     *
+     * Optional capability: adapters that cannot render traffic leave this
+     * undefined (mirroring `layers: LayerPort | null`), and UI hides the
+     * traffic toggle. `showTraffic` records the preference; the adapter may
+     * still suppress rendering where the provider cannot draw traffic (plain
+     * satellite) or below TRAFFIC_MIN_ZOOM.
+     */
+    setShowTraffic?: (showTraffic: boolean) => Promise<void>;
     /**
      * Subscribe to map events
      */

package/src/constants.d.ts

@@ -29,6 +29,18 @@ export declare const MAX_ZOOM = 22;
  * Amount to pan the map when using arrow keys (in pixels)
  */
 export declare const KEYBOARD_PAN_AMOUNT = 100;
+/**
+ * Minimum zoom level at which adapters render the traffic overlay.
+ *
+ * Google draws motorway traffic even at country/continent zoom (TrafficLayer
+ * has no zoom option), which reads as noise on a map full of markers and
+ * geofences. Below this zoom, adapters detach/hide traffic while the
+ * `showTraffic` preference stays untouched. Shared so every adapter applies
+ * the same threshold (Mapbox can pass it as a native layer `minzoom`).
+ *
+ * Not user-configurable by design; the value is a product/design decision.
+ */
+export declare const TRAFFIC_MIN_ZOOM = 7;
 /**
  * Amount to zoom when using +/- keys
  */

package/src/primitiveMapTypes.d.ts

@@ -19,19 +19,28 @@ export declare const mapAppearanceSchema: z.ZodObject<{
     theme: z.ZodEnum<["light", "dark"]>;
     mapType: z.ZodEnum<["roadmap", "satellite", "hybrid"]>;
     showRoads: z.ZodBoolean;
+    showTraffic: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     theme: "light" | "dark";
     mapType: "roadmap" | "satellite" | "hybrid";
     showRoads: boolean;
+    showTraffic?: boolean | undefined;
 }, {
     theme: "light" | "dark";
     mapType: "roadmap" | "satellite" | "hybrid";
     showRoads: boolean;
+    showTraffic?: boolean | undefined;
 }>;
 /**
- * Map appearance - grouped visual properties (theme, base layer, road overlay).
+ * Map appearance - grouped visual properties (theme, base layer, road and traffic overlays).
  * Nested inside MapState as `state.appearance` so it can be watched and
  * passed around as a single stable reference.
+ *
+ * `showTraffic` is the user's *preference*, not the rendered state: adapters
+ * without traffic support ignore it, and supporting adapters may suppress
+ * rendering (e.g. on plain satellite, or below TRAFFIC_MIN_ZOOM) while the
+ * preference stays true. It is optional (absent = false) so pre-traffic
+ * appearance literals keep compiling.
  */
 export type MapAppearance = Readonly<z.infer<typeof mapAppearanceSchema>>;
 /** Default appearance before any user preference is applied */