@trackunit/react-map-adapter-shared 0.0.157 → 0.0.158

package/migrations/entry.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/react-map-adapter-shared",
-  "version": "0.0.157",
+  "version": "0.0.158",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {

package/src/LayerPort.d.ts

@@ -99,11 +99,29 @@ export type HeatmapRenderStyle = Readonly<{
 }>;
 /** `[red, green, blue, alpha]` — channels 0–255, alpha 0–1 (CSS semantics). */
 export type HeatmapRgbaColor = readonly [number, number, number, number];
+/**
+ * Heatmap renderer failure, reported per heatmap layer. Never fails the basemap.
+ *
+ * - `"renderer-load-failed"`: a renderer dependency could not load or initialize.
+ * - `"renderer-update-failed"`: an active renderer could not apply the latest snapshot.
+ */
+export type HeatmapRenderError = Readonly<{
+    layerId: string;
+    code: "renderer-load-failed" | "renderer-update-failed";
+    cause: unknown;
+}>;
 /** Snapshot payload for `layerType: "heatmap"` — adapter picks renderer (ADR-0029). */
 export type HeatmapSourceConfig = Readonly<{
     id: string;
     features: GeoJsonFeatureCollection;
     style: HeatmapRenderStyle;
+    /**
+     * Called once per failure: a failed config is not retried or reported again until it changes (or the style
+     * reloads); renderer load failures retry on every snapshot but report once until the renderer loads.
+     * Adapters don't retry between snapshots, so on an idle map a failed renderer stays down until the next snapshot.
+     * Stable across renders when provided by `useHeatmap`.
+     */
+    onError?: (error: HeatmapRenderError) => void;
 }>;
 /**
  * A typed layer description — the declarative unit passed to `setSnapshot`.