@trackunit/react-map-adapter-shared 0.0.142-alpha-7fd06f36b49.0 → 0.0.144

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@trackunit/react-map-adapter-shared",
-  "version": "0.0.142-alpha-7fd06f36b49.0",
+  "version": "0.0.144",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
     "node": ">=24.x"
   },
   "dependencies": {
-    "@trackunit/react-map-color-utils": "0.0.117-alpha-7fd06f36b49.0",
-    "@trackunit/geo-json-utils": "1.16.1-alpha-7fd06f36b49.0",
-    "@trackunit/ui-design-tokens": "1.16.1-alpha-7fd06f36b49.0",
+    "@trackunit/react-map-color-utils": "0.0.119",
+    "@trackunit/geo-json-utils": "1.16.3",
+    "@trackunit/ui-design-tokens": "1.16.3",
     "es-toolkit": "^1.39.10",
     "zod": "^3.25.76"
   },

package/src/LayerPort.d.ts

@@ -1,7 +1,7 @@
 import type { GeoJsonBbox } from "@trackunit/geo-json-utils";
 import type { Entity } from "./interactionTypes";
-import type { ShapeStyleDefaults } from "./shapeStyleDefaults";
 import type { AdaptiveMarkerResolution, ClusterConfig, ClusterRenderConfig, ClusterRenderState, DomRenderState, GeoJsonFeatureCollection, GeoJsonGeometry, RenderConfig, RouteStyle, ShapeInteractiveMode, ShapeStyle } from "./layerApiTypes";
+import type { ShapeStyleDefaults } from "./shapeStyleDefaults";
 type ReactNode = import("react").ReactNode;
 /**
  * Full interactive marker with clustering and adapter-managed entity events.
@@ -83,6 +83,24 @@ export type ImageOverlayConfig = Readonly<{
     imageBounds: GeoJsonBbox;
     opacity: number;
 }>;
+/**
+ * Configuration for a heatmap source.
+ * The adapter uses this to configure the heatmap layer used by the map.
+ *
+ * Different map adapters may use different heatmap engines
+ * (provider-specific or open source), but we are not building our own renderer for heatmaps.
+ */
+export type HeatmapRenderStyle = Readonly<{
+    radiusPixels: number;
+    intensity: number;
+    opacity: number;
+}>;
+/** Snapshot payload for `layerType: "heatmap"` — adapter picks renderer (ADR-0029). */
+export type HeatmapSourceConfig = Readonly<{
+    id: string;
+    features: GeoJsonFeatureCollection;
+    style: HeatmapRenderStyle;
+}>;
 /**
  * A typed layer description — the declarative unit passed to `setSnapshot`.
  *
@@ -100,7 +118,9 @@ export type MapLayer = ({
     readonly layerType: "route";
 } & RouteSourceConfig) | ({
     readonly layerType: "image-overlay";
-} & ImageOverlayConfig);
+} & ImageOverlayConfig) | ({
+    readonly layerType: "heatmap";
+} & HeatmapSourceConfig);
 /**
  * Shape interaction state — which shape feature is currently selected/hovered.
  * Both fields are null when nothing is selected/hovered.

package/src/types.d.ts

@@ -1,6 +1,6 @@
 import type { GeoJsonBbox } from "@trackunit/geo-json-utils";
 import type { AdapterRendererProps } from "./adapterContract";
-import type { InitialViewport, MapTheme } from "./primitiveMapTypes";
+import type { InitialViewport, MapTheme, MapType } from "./primitiveMapTypes";
 type CSSProperties = import("react").CSSProperties;
 type ReactNode = import("react").ReactNode;
 /**
@@ -32,6 +32,26 @@ export type BaseAdapterConfig = Readonly<{
     region?: string;
     /** Map theme - light or dark */
     theme?: MapTheme;
+    /**
+     * Initial map type (base layer). Like `theme`, this seeds the adapter's
+     * appearance at construction so the first map is created with the right base
+     * layer (e.g. from a persisted user preference) instead of being corrected
+     * after mount. Defaults to the adapter's default appearance (roadmap).
+     */
+    mapType?: MapType;
+    /**
+     * Initial roads-overlay preference for satellite/hybrid map types.
+     * Seeds the adapter's appearance at construction; defaults to off.
+     */
+    showRoads?: boolean;
+    /**
+     * Initial traffic preference. Seeds the adapter's appearance at construction
+     * so a provider that needs a specific map mode for traffic (e.g. Google's
+     * raster rendering type, see ADR 0028) can create the first map correctly
+     * instead of recreating it once the persisted preference arrives. Adapters
+     * without traffic support ignore it. Defaults to off.
+     */
+    showTraffic?: boolean;
     /** Initial viewport: either center+zoom or bounds */
     initialViewport?: InitialViewport;
     /**

package/migrations/entry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../../../libs/react/map-adapter-shared/migrations/entry.ts"],"names":[],"mappings":"","sourcesContent":["export {};\n"]}