@trackunit/react-map 0.2.203 → 0.2.205

package/index.cjs.js

@@ -5887,6 +5887,57 @@ const useFitToContent = (api, handles, options) => {
     return react.useMemo(() => ({ hasFitted, isWaiting, fitNow }), [hasFitted, isWaiting, fitNow]);
 };
 
+/**
+ * Single dev-warning channel for `useHeatmap` (invalid data).
+ */
+const warnHeatmap = (message, ...details) => {
+    // eslint-disable-next-line no-console -- Intentional: the one heatmap warning channel; invalid input is dropped and must stay visible
+    console.warn(`[useHeatmap] ${message}`, ...details);
+};
+
+/**
+ * Converts consumer items into weighted GeoJSON `Point` features.
+ *
+ * Null positions and zero weights are dropped silently. Invalid positions and
+ * negative or non-finite weights are dropped with one grouped warning per pass.
+ */
+const normalizeHeatmapData = ({ data, getPosition, getWeight, }) => {
+    const features = [];
+    const positions = [];
+    let invalidPositionCount = 0;
+    let invalidWeightCount = 0;
+    for (const item of data) {
+        const position = getPosition(item);
+        if (position === null)
+            continue;
+        const parsedPosition = geoJsonUtils.geoJsonPositionSchema.safeParse(position);
+        if (!parsedPosition.success) {
+            invalidPositionCount++;
+            continue;
+        }
+        const weight = getWeight?.(item) ?? 1;
+        if (weight === 0)
+            continue;
+        if (!Number.isFinite(weight) || weight < 0) {
+            invalidWeightCount++;
+            continue;
+        }
+        positions.push(parsedPosition.data);
+        features.push({
+            type: "Feature",
+            geometry: { type: "Point", coordinates: parsedPosition.data },
+            properties: { weight },
+        });
+    }
+    if (invalidPositionCount > 0 || invalidWeightCount > 0) {
+        warnHeatmap(`Filtered ${invalidPositionCount} item(s) with invalid position and ${invalidWeightCount} item(s) with invalid weight. Expected [longitude, latitude] with longitude between -180 and 180, latitude between -90 and 90, and a finite weight >= 0.`);
+    }
+    return {
+        features: { type: "FeatureCollection", features },
+        positions,
+    };
+};
+
 const EMPTY_CONTROLS$2 = {};
 /**
  * Weighted point heatmap layer handle (provider-agnostic).
@@ -5898,31 +5949,15 @@ const EMPTY_CONTROLS$2 = {};
 const useHeatmap = (options) => {
     const { id, name, data, getPosition, getWeight, style, controls, loading, fitParticipation = "all" } = options;
     const layerReady = useLayerReady(loading);
-    const normalized = react.useMemo(() => {
-        const features = [];
-        const positions = [];
-        for (const item of data) {
-            const position = getPosition(item);
-            if (position === null)
-                continue;
-            const parsedPosition = geoJsonUtils.geoJsonPositionSchema.safeParse(position);
-            if (!parsedPosition.success)
-                continue;
-            const weight = getWeight?.(item) ?? 1;
-            if (!Number.isFinite(weight) || weight <= 0)
-                continue;
-            positions.push(parsedPosition.data);
-            features.push({
-                type: "Feature",
-                geometry: { type: "Point", coordinates: parsedPosition.data },
-                properties: { weight },
-            });
-        }
-        return {
-            features: { type: "FeatureCollection", features },
-            positions,
-        };
-    }, [data, getPosition, getWeight]);
+    // Keyed on `data` (adjust-state-during-render + isEqual) so inline accessors
+    // don't re-normalize the whole dataset on every render. Accessor changes
+    // apply on the next `data` change.
+    const [prevData, setPrevData] = react.useState(data);
+    const [normalized, setNormalized] = react.useState(() => normalizeHeatmapData({ data, getPosition, getWeight }));
+    if (data !== prevData && !esToolkit.isEqual(data, prevData)) {
+        setPrevData(data);
+        setNormalized(normalizeHeatmapData({ data, getPosition, getWeight }));
+    }
     const resolvedStyle = react.useMemo(() => ({
         radiusPixels: style?.radiusPixels ?? 30,
         intensity: style?.intensity ?? 1,

package/index.esm.js

@@ -5886,6 +5886,57 @@ const useFitToContent = (api, handles, options) => {
     return useMemo(() => ({ hasFitted, isWaiting, fitNow }), [hasFitted, isWaiting, fitNow]);
 };
 
+/**
+ * Single dev-warning channel for `useHeatmap` (invalid data).
+ */
+const warnHeatmap = (message, ...details) => {
+    // eslint-disable-next-line no-console -- Intentional: the one heatmap warning channel; invalid input is dropped and must stay visible
+    console.warn(`[useHeatmap] ${message}`, ...details);
+};
+
+/**
+ * Converts consumer items into weighted GeoJSON `Point` features.
+ *
+ * Null positions and zero weights are dropped silently. Invalid positions and
+ * negative or non-finite weights are dropped with one grouped warning per pass.
+ */
+const normalizeHeatmapData = ({ data, getPosition, getWeight, }) => {
+    const features = [];
+    const positions = [];
+    let invalidPositionCount = 0;
+    let invalidWeightCount = 0;
+    for (const item of data) {
+        const position = getPosition(item);
+        if (position === null)
+            continue;
+        const parsedPosition = geoJsonPositionSchema.safeParse(position);
+        if (!parsedPosition.success) {
+            invalidPositionCount++;
+            continue;
+        }
+        const weight = getWeight?.(item) ?? 1;
+        if (weight === 0)
+            continue;
+        if (!Number.isFinite(weight) || weight < 0) {
+            invalidWeightCount++;
+            continue;
+        }
+        positions.push(parsedPosition.data);
+        features.push({
+            type: "Feature",
+            geometry: { type: "Point", coordinates: parsedPosition.data },
+            properties: { weight },
+        });
+    }
+    if (invalidPositionCount > 0 || invalidWeightCount > 0) {
+        warnHeatmap(`Filtered ${invalidPositionCount} item(s) with invalid position and ${invalidWeightCount} item(s) with invalid weight. Expected [longitude, latitude] with longitude between -180 and 180, latitude between -90 and 90, and a finite weight >= 0.`);
+    }
+    return {
+        features: { type: "FeatureCollection", features },
+        positions,
+    };
+};
+
 const EMPTY_CONTROLS$2 = {};
 /**
  * Weighted point heatmap layer handle (provider-agnostic).
@@ -5897,31 +5948,15 @@ const EMPTY_CONTROLS$2 = {};
 const useHeatmap = (options) => {
     const { id, name, data, getPosition, getWeight, style, controls, loading, fitParticipation = "all" } = options;
     const layerReady = useLayerReady(loading);
-    const normalized = useMemo(() => {
-        const features = [];
-        const positions = [];
-        for (const item of data) {
-            const position = getPosition(item);
-            if (position === null)
-                continue;
-            const parsedPosition = geoJsonPositionSchema.safeParse(position);
-            if (!parsedPosition.success)
-                continue;
-            const weight = getWeight?.(item) ?? 1;
-            if (!Number.isFinite(weight) || weight <= 0)
-                continue;
-            positions.push(parsedPosition.data);
-            features.push({
-                type: "Feature",
-                geometry: { type: "Point", coordinates: parsedPosition.data },
-                properties: { weight },
-            });
-        }
-        return {
-            features: { type: "FeatureCollection", features },
-            positions,
-        };
-    }, [data, getPosition, getWeight]);
+    // Keyed on `data` (adjust-state-during-render + isEqual) so inline accessors
+    // don't re-normalize the whole dataset on every render. Accessor changes
+    // apply on the next `data` change.
+    const [prevData, setPrevData] = useState(data);
+    const [normalized, setNormalized] = useState(() => normalizeHeatmapData({ data, getPosition, getWeight }));
+    if (data !== prevData && !isEqual(data, prevData)) {
+        setPrevData(data);
+        setNormalized(normalizeHeatmapData({ data, getPosition, getWeight }));
+    }
     const resolvedStyle = useMemo(() => ({
         radiusPixels: style?.radiusPixels ?? 30,
         intensity: style?.intensity ?? 1,

package/package.json

@@ -1,23 +1,23 @@
 {
   "name": "@trackunit/react-map",
-  "version": "0.2.203",
+  "version": "0.2.205",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
     "node": ">=24.x"
   },
   "dependencies": {
-    "@trackunit/react-components": "3.8.0",
-    "@trackunit/css-class-variance-utilities": "2.3.3",
-    "@trackunit/react-form-components": "2.10.6",
-    "@trackunit/react-core-hooks": "1.25.3",
-    "@trackunit/geo-json-utils": "1.18.3",
-    "@trackunit/i18n-library-translation": "2.8.3",
+    "@trackunit/react-components": "3.8.1",
+    "@trackunit/css-class-variance-utilities": "2.3.4",
+    "@trackunit/react-form-components": "2.10.7",
+    "@trackunit/react-core-hooks": "1.25.4",
+    "@trackunit/geo-json-utils": "1.18.4",
+    "@trackunit/i18n-library-translation": "2.8.4",
     "react-minimal-pie-chart": "^8.4.0",
-    "@trackunit/react-map-adapter-shared": "0.0.154",
-    "@trackunit/react-map-color-utils": "0.0.129",
-    "@trackunit/shared-utils": "1.19.3",
-    "@trackunit/ui-design-tokens": "1.18.3",
+    "@trackunit/react-map-adapter-shared": "0.0.155",
+    "@trackunit/react-map-color-utils": "0.0.130",
+    "@trackunit/shared-utils": "1.19.4",
+    "@trackunit/ui-design-tokens": "1.18.4",
     "@floating-ui/react": "^0.26.25",
     "es-toolkit": "^1.52.0",
     "tailwind-merge": "^2.0.0",

package/src/layers/useHeatmap/useHeatmap.d.ts

@@ -1,4 +1,4 @@
-import { type GeoJsonPosition } from "@trackunit/geo-json-utils";
+import type { GeoJsonPosition } from "@trackunit/geo-json-utils";
 import type { CategoryKey, ControlConfig } from "../../controls/types";
 import type { FitParticipation, HeatmapLayerHandle } from "../types";
 export type HeatmapStyle = Readonly<{

package/src/layers/useHeatmap/utils/normalizeHeatmapData.d.ts

@@ -0,0 +1,19 @@
+import { type GeoJsonPosition } from "@trackunit/geo-json-utils";
+import type { GeoJsonFeatureCollection } from "../../types";
+export type NormalizedHeatmapData = Readonly<{
+    features: GeoJsonFeatureCollection;
+    positions: ReadonlyArray<GeoJsonPosition>;
+}>;
+type NormalizeHeatmapDataOptions<TItem> = Readonly<{
+    data: ReadonlyArray<TItem>;
+    getPosition: (item: TItem) => GeoJsonPosition | null;
+    getWeight: ((item: TItem) => number) | undefined;
+}>;
+/**
+ * Converts consumer items into weighted GeoJSON `Point` features.
+ *
+ * Null positions and zero weights are dropped silently. Invalid positions and
+ * negative or non-finite weights are dropped with one grouped warning per pass.
+ */
+export declare const normalizeHeatmapData: <TItem>({ data, getPosition, getWeight, }: NormalizeHeatmapDataOptions<TItem>) => NormalizedHeatmapData;
+export {};

package/src/layers/useHeatmap/utils/warnHeatmap.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Single dev-warning channel for `useHeatmap` (invalid data).
+ */
+export declare const warnHeatmap: (message: string, ...details: ReadonlyArray<unknown>) => void;

package/migrations/entry.js.map

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