@amcharts/amcharts5 5.17.0 → 5.17.2

package/.internal/charts/map/MapSankeySeries.d.ts

@@ -265,10 +265,28 @@ export declare class MapSankeySeries extends MapPolygonSeries {
     private _geoNodeRange;
     private _geoSourceOffsets;
     private _geoTargetOffsets;
+    /**
+     * Disposer for the polygonSeries `datavalidated` listener. Re-attached
+     * whenever the `polygonSeries` setting changes.
+     */
+    private _polygonSeriesDP?;
     /**
      * @ignore
      */
     protected _afterNew(): void;
+    /**
+     * (Re)subscribes to the current `polygonSeries` `datavalidated` event so
+     * that any data items added before the polygon series finished loading
+     * its geoJSON get their endpoints resolved automatically.
+     */
+    private _setupPolygonSeriesListener;
+    /**
+     * Walks all data items and resolves any whose source/target endpoints
+     * weren't resolved during the initial `processDataItem` call (because
+     * the polygon series wasn't ready yet). Marks values dirty so the
+     * geometries get regenerated.
+     */
+    private _resolvePendingDataItems;
     static className: string;
     static classNames: Array<string>;
     _settings: IMapSankeySeriesSettings;
@@ -364,6 +382,17 @@ export declare class MapSankeySeries extends MapPolygonSeries {
      * @param dataItem  Data item to process
      */
     protected processDataItem(dataItem: DataItem<this["_dataItemSettings"]>): void;
+    /**
+     * Resolves the source/target endpoints for a single data item:
+     * looks up centroids on the polygon series (if `sourceId`/`targetId` is set),
+     * then creates or attaches the appropriate sankey nodes.
+     *
+     * Returns `true` if anything was newly resolved, so callers can decide
+     * whether to mark geometries dirty.
+     *
+     * Safe to call repeatedly: skips endpoints that are already resolved.
+     */
+    private _resolveEndpoints;
     /**
      * @ignore
      */

package/.internal/charts/map/MapSankeySeries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MapSankeySeries.d.ts","sourceRoot":"","sources":["../../../../../src/.internal/charts/map/MapSankeySeries.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MapSankeySeries.d.ts","sourceRoot":"","sources":["../../../../../src/.internal/charts/map/MapSankeySeries.ts"],"names":[],"mappings":"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"}

package/.internal/charts/map/MapSankeySeries.js

@@ -71,7 +71,58 @@ export class MapSankeySeries extends MapPolygonSeries {
         this._setRawDefault("valueField", "value");
         this._setRawDefault("waypointsField", "waypoints");
         this.nodes.flow = this;
+        // Watch for polygonSeries changes — re-attach the datavalidated
+        // listener so users don't have to wait for the polygon series to
+        // be ready before calling sankey.data.setAll().
+        this.on("polygonSeries", () => {
+            this._setupPolygonSeriesListener();
+        });
         super._afterNew();
+        // Initial setup in case polygonSeries was passed in constructor settings.
+        this._setupPolygonSeriesListener();
+    }
+    /**
+     * (Re)subscribes to the current `polygonSeries` `datavalidated` event so
+     * that any data items added before the polygon series finished loading
+     * its geoJSON get their endpoints resolved automatically.
+     */
+    _setupPolygonSeriesListener() {
+        if (this._polygonSeriesDP) {
+            this._polygonSeriesDP.dispose();
+            this._polygonSeriesDP = undefined;
+        }
+        const polygonSeries = this.get("polygonSeries");
+        if (polygonSeries) {
+            this._polygonSeriesDP = polygonSeries.events.on("datavalidated", () => {
+                this._resolvePendingDataItems();
+            });
+            // If the polygon series already has data items (e.g. it was
+            // validated before our data was set), resolve immediately.
+            if (polygonSeries.dataItems.length > 0) {
+                this._resolvePendingDataItems();
+            }
+        }
+    }
+    /**
+     * Walks all data items and resolves any whose source/target endpoints
+     * weren't resolved during the initial `processDataItem` call (because
+     * the polygon series wasn't ready yet). Marks values dirty so the
+     * geometries get regenerated.
+     */
+    _resolvePendingDataItems() {
+        let anyResolved = false;
+        $array.each(this.dataItems, (dataItem) => {
+            if (this._resolveEndpoints(dataItem)) {
+                anyResolved = true;
+            }
+        });
+        if (anyResolved) {
+            // Trigger geometry regeneration on next validation cycle.
+            // Mirrors Component.markDirtyValues without the parent's
+            // MapPolygon geometry sync (handled later in _generateGeometries).
+            this._valuesDirty = true;
+            this.markDirty();
+        }
     }
     /**
      * @ignore
@@ -285,6 +336,10 @@ export class MapSankeySeries extends MapPolygonSeries {
      */
     _dispose() {
         super._dispose();
+        if (this._polygonSeriesDP) {
+            this._polygonSeriesDP.dispose();
+            this._polygonSeriesDP = undefined;
+        }
         this._bezierSegments.clear();
         this._segmentCumulativeLengths.clear();
         this._geoSourceCoords.clear();
@@ -311,67 +366,86 @@ export class MapSankeySeries extends MapPolygonSeries {
             dataItem.set("geometry", { type: "Polygon", coordinates: [] });
         }
         super.processDataItem(dataItem);
+        this._resolveEndpoints(dataItem);
+    }
+    /**
+     * Resolves the source/target endpoints for a single data item:
+     * looks up centroids on the polygon series (if `sourceId`/`targetId` is set),
+     * then creates or attaches the appropriate sankey nodes.
+     *
+     * Returns `true` if anything was newly resolved, so callers can decide
+     * whether to mark geometries dirty.
+     *
+     * Safe to call repeatedly: skips endpoints that are already resolved.
+     */
+    _resolveEndpoints(dataItem) {
         const polygonSeries = this.get("polygonSeries");
-        // Resolve source coordinates
-        let sourceLon = dataItem.get("sourceLongitude");
-        let sourceLat = dataItem.get("sourceLatitude");
-        const sourceId = dataItem.get("sourceId");
-        if (sourceId && polygonSeries) {
-            const polygonDI = polygonSeries.getDataItemById(sourceId);
-            if (polygonDI) {
-                const geometry = polygonDI.get("geometry");
-                if (geometry) {
-                    const centroid = getGeoCentroid(geometry);
-                    sourceLon = centroid.longitude;
-                    sourceLat = centroid.latitude;
+        let resolved = false;
+        // -- Source --
+        if (!dataItem.get("sourceNode")) {
+            let sourceLon = dataItem.get("sourceLongitude");
+            let sourceLat = dataItem.get("sourceLatitude");
+            const sourceId = dataItem.get("sourceId");
+            if (sourceId && polygonSeries) {
+                const polygonDI = polygonSeries.getDataItemById(sourceId);
+                if (polygonDI) {
+                    const geometry = polygonDI.get("geometry");
+                    if (geometry) {
+                        const centroid = getGeoCentroid(geometry);
+                        sourceLon = centroid.longitude;
+                        sourceLat = centroid.latitude;
+                    }
                 }
             }
-        }
-        // Resolve target coordinates
-        let targetLon = dataItem.get("targetLongitude");
-        let targetLat = dataItem.get("targetLatitude");
-        const targetId = dataItem.get("targetId");
-        if (targetId && polygonSeries) {
-            const polygonDI = polygonSeries.getDataItemById(targetId);
-            if (polygonDI) {
-                const geometry = polygonDI.get("geometry");
-                if (geometry) {
-                    const centroid = getGeoCentroid(geometry);
-                    targetLon = centroid.longitude;
-                    targetLat = centroid.latitude;
+            if (sourceLon != null && sourceLat != null) {
+                const sourceKey = sourceId !== null && sourceId !== void 0 ? sourceId : (Number(sourceLon) + "," + Number(sourceLat));
+                let sourceNode = this.nodes.getDataItemById(sourceKey);
+                if (!sourceNode) {
+                    const ctx = dataItem.dataContext;
+                    const name = (ctx && ctx.source) || sourceKey;
+                    this.nodes.data.push({ id: sourceKey, name, longitude: Number(sourceLon), latitude: Number(sourceLat) });
+                    sourceNode = this.nodes.dataItems[this.nodes.dataItems.length - 1];
+                }
+                if (sourceNode) {
+                    dataItem.setRaw("sourceNode", sourceNode);
+                    this.nodes.addOutgoingLink(sourceNode, dataItem);
+                    resolved = true;
                 }
             }
         }
-        // Create/find source node
-        if (sourceLon != null && sourceLat != null) {
-            const sourceKey = sourceId !== null && sourceId !== void 0 ? sourceId : (Number(sourceLon) + "," + Number(sourceLat));
-            let sourceNode = this.nodes.getDataItemById(sourceKey);
-            if (!sourceNode) {
-                const ctx = dataItem.dataContext;
-                const name = (ctx && ctx.source) || sourceKey;
-                this.nodes.data.push({ id: sourceKey, name, longitude: Number(sourceLon), latitude: Number(sourceLat) });
-                sourceNode = this.nodes.dataItems[this.nodes.dataItems.length - 1];
-            }
-            if (sourceNode) {
-                dataItem.setRaw("sourceNode", sourceNode);
-                this.nodes.addOutgoingLink(sourceNode, dataItem);
-            }
-        }
-        // Create/find target node
-        if (targetLon != null && targetLat != null) {
-            const targetKey = targetId !== null && targetId !== void 0 ? targetId : (Number(targetLon) + "," + Number(targetLat));
-            let targetNode = this.nodes.getDataItemById(targetKey);
-            if (!targetNode) {
-                const ctx = dataItem.dataContext;
-                const name = (ctx && ctx.target) || targetKey;
-                this.nodes.data.push({ id: targetKey, name, longitude: Number(targetLon), latitude: Number(targetLat) });
-                targetNode = this.nodes.dataItems[this.nodes.dataItems.length - 1];
+        // -- Target --
+        if (!dataItem.get("targetNode")) {
+            let targetLon = dataItem.get("targetLongitude");
+            let targetLat = dataItem.get("targetLatitude");
+            const targetId = dataItem.get("targetId");
+            if (targetId && polygonSeries) {
+                const polygonDI = polygonSeries.getDataItemById(targetId);
+                if (polygonDI) {
+                    const geometry = polygonDI.get("geometry");
+                    if (geometry) {
+                        const centroid = getGeoCentroid(geometry);
+                        targetLon = centroid.longitude;
+                        targetLat = centroid.latitude;
+                    }
+                }
             }
-            if (targetNode) {
-                dataItem.setRaw("targetNode", targetNode);
-                this.nodes.addIncomingLink(targetNode, dataItem);
+            if (targetLon != null && targetLat != null) {
+                const targetKey = targetId !== null && targetId !== void 0 ? targetId : (Number(targetLon) + "," + Number(targetLat));
+                let targetNode = this.nodes.getDataItemById(targetKey);
+                if (!targetNode) {
+                    const ctx = dataItem.dataContext;
+                    const name = (ctx && ctx.target) || targetKey;
+                    this.nodes.data.push({ id: targetKey, name, longitude: Number(targetLon), latitude: Number(targetLat) });
+                    targetNode = this.nodes.dataItems[this.nodes.dataItems.length - 1];
+                }
+                if (targetNode) {
+                    dataItem.setRaw("targetNode", targetNode);
+                    this.nodes.addIncomingLink(targetNode, dataItem);
+                    resolved = true;
+                }
             }
         }
+        return resolved;
     }
     /**
      * @ignore