@amcharts/amcharts5 5.16.1 → 5.17.0

package/.internal/charts/map/MapSankeyNodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapSankeyNodes.js","sourceRoot":"","sources":["../../../../../src/.internal/charts/map/MapSankeyNodes.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DataItem } from \"../../core/render/Component\";\nimport type { Color } from \"../../core/util/Color\";\nimport type { ColorSet } from \"../../core/util/ColorSet\";\nimport type { MapSankeySeries, IMapSankeySeriesDataItem } from \"./MapSankeySeries\";\n\nimport { Series, ISeriesSettings, ISeriesDataItem, ISeriesPrivate, ISeriesEvents } from \"../../core/render/Series\";\nimport { MapPolygon } from \"./MapPolygon\";\nimport { Template } from \"../../core/util/Template\";\nimport { ListTemplate } from \"../../core/util/List\";\n\nexport interface IMapSankeyNodesDataItem extends ISeriesDataItem {\n\n\t/**\n\t * Node name.\n\t */\n\tname: string;\n\n\t/**\n\t * Node color.\n\t */\n\tfill: Color;\n\n\t/**\n\t * Sum of values of all incoming links.\n\t */\n\tsumIncoming: number;\n\n\t/**\n\t * Sum of values of all outgoing links.\n\t */\n\tsumOutgoing: number;\n\n\t/**\n\t * Sum of values of all links: incoming and outgoing.\n\t */\n\tsum: number;\n\n\t/**\n\t * A list of incoming link data items.\n\t */\n\tincomingLinks: Array<DataItem<IMapSankeySeriesDataItem>>;\n\n\t/**\n\t * A list of outgoing link data items.\n\t */\n\toutgoingLinks: Array<DataItem<IMapSankeySeriesDataItem>>;\n\n\t/**\n\t * Node longitude.\n\t */\n\tlongitude: number;\n\n\t/**\n\t * Node latitude.\n\t */\n\tlatitude: number;\n\n\t/**\n\t * Related [[MapPolygon]] object (circle or bar shape).\n\t */\n\tmapPolygon: MapPolygon;\n}\n\nexport interface IMapSankeyNodesSettings extends ISeriesSettings {\n\n\t/**\n\t * A field in data that holds name for the node.\n\t * @default \"name\"\n\t */\n\tnameField?: string;\n\n\t/**\n\t * A field in data that holds color used for node fill.\n\t * @default \"fill\"\n\t */\n\tfillField?: string;\n\n\t/**\n\t * A field in data that holds the node longitude.\n\t * @default \"longitude\"\n\t */\n\tlongitudeField?: string;\n\n\t/**\n\t * A field in data that holds the node latitude.\n\t * @default \"latitude\"\n\t */\n\tlatitudeField?: string;\n\n\t/**\n\t * A [[ColorSet]] that series will use to apply to its nodes.\n\t */\n\tcolors?: ColorSet;\n}\n\nexport interface IMapSankeyNodesPrivate extends ISeriesPrivate {\n}\n\nexport interface IMapSankeyNodesEvents extends ISeriesEvents {\n}\n\n/**\n * Holds instances of nodes for a [[MapSankeySeries]].\n *\n * @see {@link https://www.amcharts.com/docs/v5/charts/map-chart/map-sankey-series/} for more info\n * @since 5.17.0\n * @important\n */\nexport class MapSankeyNodes extends Series {\n\n\tpublic static className: string = \"MapSankeyNodes\";\n\tpublic static classNames: Array<string> = Series.classNames.concat([MapSankeyNodes.className]);\n\n\tdeclare public _settings: IMapSankeyNodesSettings;\n\tdeclare public _privateSettings: IMapSankeyNodesPrivate;\n\tdeclare public _dataItemSettings: IMapSankeyNodesDataItem;\n\tdeclare public _events: IMapSankeyNodesEvents;\n\n\t/**\n\t * Related [[MapSankeySeries]].\n\t */\n\tpublic flow: MapSankeySeries | undefined;\n\n\t/**\n\t * Flag indicating user has explicitly set node data.\n\t * Prevents auto-clearing of nodes when link data changes.\n\t * @ignore\n\t */\n\tpublic _userDataSet = false;\n\n\t/**\n\t * A [[ListTemplate]] of all node polygons.\n\t *\n\t * `mapPolygons.template` can be used to configure node appearance.\n\t *\n\t * @default new ListTemplate<MapPolygon>\n\t */\n\tpublic readonly mapPolygons: ListTemplate<MapPolygon> = this.addDisposer(new ListTemplate(\n\t\tTemplate.new({}),\n\t\t() => MapPolygon._new(this._root, {}, [this.mapPolygons.template])\n\t));\n\n\t/**\n\t * @ignore\n\t */\n\tpublic _applyThemes(force: boolean = false): boolean {\n\t\tconst colors = this.get(\"colors\");\n\t\tif (colors) {\n\t\t\tcolors.reset();\n\t\t}\n\t\treturn super._applyThemes(force);\n\t}\n\n\t/**\n\t * @ignore\n\t */\n\tprotected _afterNew() {\n\t\tthis.fields.push(\"name\", \"fill\", \"longitude\", \"latitude\");\n\n\t\tthis._setRawDefault(\"idField\", \"id\");\n\t\tthis._setRawDefault(\"nameField\", \"name\");\n\t\tthis._setRawDefault(\"fillField\", \"fill\");\n\t\tthis._setRawDefault(\"longitudeField\", \"longitude\");\n\t\tthis._setRawDefault(\"latitudeField\", \"latitude\");\n\n\t\tsuper._afterNew();\n\t}\n\n\t/**\n\t * @ignore\n\t */\n\tprotected _onDataClear() {\n\t\tconst colors = this.get(\"colors\");\n\t\tif (colors) {\n\t\t\tcolors.reset();\n\t\t}\n\t\tthis._userDataSet = true;\n\t}\n\n\t/**\n\t * Processes a newly added node data item, assigning a fill color\n\t * and creating its map polygon.\n\t *\n\t * @param dataItem  Data item to process\n\t */\n\tprotected processDataItem(dataItem: DataItem<this[\"_dataItemSettings\"]>) {\n\t\tsuper.processDataItem(dataItem);\n\n\t\t// Auto-assign fill from ColorSet if not provided\n\t\tif (dataItem.get(\"fill\") == null) {\n\t\t\tconst colors = this.get(\"colors\");\n\t\t\tif (colors) {\n\t\t\t\tdataItem.setRaw(\"fill\", colors.next());\n\t\t\t}\n\t\t}\n\n\t\t// Create MapPolygon visual\n\t\tconst mapPolygon = this.makeMapPolygon(dataItem);\n\t\tdataItem.setRaw(\"mapPolygon\", mapPolygon);\n\t}\n\n\t/**\n\t * @ignore\n\t */\n\tpublic _updateNodeColor(dataItem: DataItem<this[\"_dataItemSettings\"]>) {\n\t\tconst mapPolygon = dataItem.get(\"mapPolygon\");\n\t\tif (mapPolygon) {\n\t\t\tmapPolygon.set(\"fill\", dataItem.get(\"fill\"));\n\t\t}\n\t}\n\n\t/**\n\t * Creates a MapPolygon visual for a node data item.\n\t * @ignore\n\t */\n\tpublic makeMapPolygon(dataItem: DataItem<this[\"_dataItemSettings\"]>): MapPolygon {\n\t\tconst mapPolygon = this.mapPolygons.make();\n\t\tthis.mapPolygons.push(mapPolygon);\n\t\tmapPolygon._setDataItem(dataItem);\n\n\t\t// Set series to parent MapSankeySeries for projection access\n\t\tif (this.flow) {\n\t\t\tmapPolygon.series = this.flow;\n\t\t\tthis.flow.children.push(mapPolygon);\n\t\t}\n\n\t\t// Apply fill from data item and listen for changes\n\t\tconst fill = dataItem.get(\"fill\");\n\t\tif (fill) {\n\t\t\tmapPolygon._setSoft(\"fill\", fill);\n\t\t}\n\n\t\tdataItem.on(\"fill\", () => {\n\t\t\tthis._updateNodeColor(dataItem);\n\t\t});\n\n\t\treturn mapPolygon;\n\t}\n\n\t/**\n\t * Add an incoming link to a node data item.\n\t * @ignore\n\t */\n\tpublic addIncomingLink(dataItem: DataItem<this[\"_dataItemSettings\"]>, link: DataItem<IMapSankeySeriesDataItem>) {\n\t\tlet incoming = dataItem.get(\"incomingLinks\");\n\t\tif (!incoming) {\n\t\t\tincoming = [];\n\t\t\tdataItem.setRaw(\"incomingLinks\", incoming);\n\t\t}\n\t\tincoming.push(link);\n\t}\n\n\t/**\n\t * Add an outgoing link to a node data item.\n\t * @ignore\n\t */\n\tpublic addOutgoingLink(dataItem: DataItem<this[\"_dataItemSettings\"]>, link: DataItem<IMapSankeySeriesDataItem>) {\n\t\tlet outgoing = dataItem.get(\"outgoingLinks\");\n\t\tif (!outgoing) {\n\t\t\toutgoing = [];\n\t\t\tdataItem.setRaw(\"outgoingLinks\", outgoing);\n\t\t}\n\t\toutgoing.push(link);\n\t}\n\n\t/**\n\t * @ignore\n\t */\n\tpublic disposeDataItem(dataItem: DataItem<this[\"_dataItemSettings\"]>) {\n\t\tsuper.disposeDataItem(dataItem);\n\t\tconst mapPolygon = dataItem.get(\"mapPolygon\");\n\t\tif (mapPolygon) {\n\t\t\tthis.mapPolygons.removeValue(mapPolygon);\n\t\t\tmapPolygon.dispose();\n\t\t}\n\t}\n}\n"]}

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

@@ -0,0 +1,383 @@
+import type { DataItem } from "../../core/render/Component";
+import type { Bullet } from "../../core/render/Bullet";
+import type { IOrientationPoint } from "../../core/util/IPoint";
+import type { IGeoPoint } from "../../core/util/IGeoPoint";
+import { MapPolygonSeries, IMapPolygonSeriesSettings, IMapPolygonSeriesDataItem, IMapPolygonSeriesPrivate } from "./MapPolygonSeries";
+import { MapSankeyNodes, IMapSankeyNodesDataItem } from "./MapSankeyNodes";
+/**
+ * Parameters for a single cubic bezier segment in geographic coordinates.
+ * @ignore
+ */
+export interface IBezierSegment {
+    p0Lon: number;
+    p0Lat: number;
+    p1Lon: number;
+    p1Lat: number;
+    cp0Lon: number;
+    cp0Lat: number;
+    cp1Lon: number;
+    cp1Lat: number;
+}
+export interface IMapSankeySeriesPrivate extends IMapPolygonSeriesPrivate {
+}
+export interface IMapSankeySeriesDataItem extends IMapPolygonSeriesDataItem {
+    /**
+     * Source polygon ID (matches id in polygonSeries).
+     */
+    sourceId?: string;
+    /**
+     * Target polygon ID (matches id in polygonSeries).
+     */
+    targetId?: string;
+    /**
+     * Source longitude (if not using sourceId).
+     */
+    sourceLongitude?: number;
+    /**
+     * Source latitude (if not using sourceId).
+     */
+    sourceLatitude?: number;
+    /**
+     * Target longitude (if not using targetId).
+     */
+    targetLongitude?: number;
+    /**
+     * Target latitude (if not using targetId).
+     */
+    targetLatitude?: number;
+    /**
+     * Numeric value controlling band thickness.
+     */
+    value?: number;
+    /**
+     * Waypoints for routing the band through intermediate geographic points.
+     */
+    waypoints?: Array<IGeoPoint>;
+    /**
+     * Per-link control point distance. Overrides series-level `controlPointDistance`.
+     */
+    controlPointDistance?: number;
+    /**
+     * Per-link control point distance at the source end.
+     * Overrides series-level `controlPointDistanceSource`.
+     */
+    controlPointDistanceSource?: number;
+    /**
+     * Per-link control point distance at the target end.
+     * Overrides series-level `controlPointDistanceTarget`.
+     */
+    controlPointDistanceTarget?: number;
+    /**
+     * Reference to the source node data item.
+     * @readonly
+     */
+    sourceNode?: DataItem<IMapSankeyNodesDataItem>;
+    /**
+     * Reference to the target node data item.
+     * @readonly
+     */
+    targetNode?: DataItem<IMapSankeyNodesDataItem>;
+}
+export interface IMapSankeySeriesSettings extends IMapPolygonSeriesSettings {
+    /**
+     * A [[MapPolygonSeries]] to use for resolving `sourceId`/`targetId` to geographic centroids.
+     */
+    polygonSeries?: MapPolygonSeries;
+    /**
+     * Control point distance for bezier curves (0-0.5). Higher values =
+     * longer straight sections before the S-curve transition.
+     *
+     * Used as fallback when `controlPointDistanceSource` or
+     * `controlPointDistanceTarget` are not set.
+     *
+     * @default 0.5
+     */
+    controlPointDistance?: number;
+    /**
+     * Control point distance at the source (departure) end.
+     * Higher values = longer straight section leaving the source node.
+     *
+     * Falls back to `controlPointDistance` if not set.
+     */
+    controlPointDistanceSource?: number;
+    /**
+     * Control point distance at the target (arrival) end.
+     * Higher values = longer straight section approaching the target node.
+     *
+     * Falls back to `controlPointDistance` if not set.
+     */
+    controlPointDistanceTarget?: number;
+    /**
+     * Orientation of the S-curve links.
+     *
+     * `"horizontal"` — links depart and arrive horizontally (east/west).
+     * Bands stack vertically at each endpoint.
+     * `"vertical"` — links depart and arrive vertically (north/south).
+     * Bands stack horizontally at each endpoint.
+     *
+     * @default "horizontal"
+     */
+    orientation?: "horizontal" | "vertical";
+    /**
+     * Maximum band width in geographic degrees.
+     * @default 5
+     */
+    maxWidth?: number;
+    /**
+     * Number of sample points per bezier segment. Higher = smoother curves.
+     * @default 50
+     */
+    resolution?: number;
+    /**
+     * Extra padding added to endpoint nodes in geographic degrees.
+     * For circles, added to the radius. For bars, added to the half-height.
+     * Helps avoid subpixel gaps between bands and the node shape.
+     * @default 0.3
+     */
+    nodePadding?: number;
+    /**
+     * When `true`, bands at each endpoint are sorted by the latitude of
+     * their target/source so that bands heading north are stacked above
+     * bands heading south. This prevents bands from overlapping.
+     * @default true
+     */
+    autoSort?: boolean;
+    /**
+     * Controls how links handle the antimeridian (±180° longitude).
+     *
+     * `"short"` — links always take the shorter path, crossing the
+     * antimeridian if needed (e.g. China → US goes east across the Pacific).
+     * `"long"` — links never cross the antimeridian, always going the
+     * long way around.
+     *
+     * Only applies to links without waypoints; waypoints define the
+     * route explicitly.
+     *
+     * @default "short"
+     */
+    antimeridian?: "short" | "long";
+    /**
+     * Shape of the endpoint node. Styled via `nodes.mapPolygons.template`.
+     *
+     * `"circle"` — a circle covering all flows at the endpoint.
+     * `"bar"` — a rectangular bar like in a traditional Sankey diagram.
+     * Bar orientation is perpendicular to the flow direction.
+     *
+     * @default "circle"
+     */
+    nodeType?: "circle" | "bar";
+    /**
+     * Width of the bar at endpoint nodes in geographic degrees.
+     * Only used when `nodeType` is `"bar"`.
+     * @default 1
+     */
+    nodeWidth?: number;
+    /**
+     * Controls how link bands are colored.
+     *
+     * `"solid"` — all links use the template fill (default).
+     * `"source"` — each link inherits the source node's fill.
+     * `"target"` — each link inherits the target node's fill.
+     *
+     * @default "solid"
+     */
+    linkColorMode?: "solid" | "source" | "target";
+    /**
+     * A field in data that holds the source polygon ID.
+     * @default "sourceId"
+     */
+    sourceIdField?: string;
+    /**
+     * A field in data that holds the target polygon ID.
+     * @default "targetId"
+     */
+    targetIdField?: string;
+    /**
+     * A field in data that holds the source longitude.
+     * @default "sourceLongitude"
+     */
+    sourceLongitudeField?: string;
+    /**
+     * A field in data that holds the source latitude.
+     * @default "sourceLatitude"
+     */
+    sourceLatitudeField?: string;
+    /**
+     * A field in data that holds the target longitude.
+     * @default "targetLongitude"
+     */
+    targetLongitudeField?: string;
+    /**
+     * A field in data that holds the target latitude.
+     * @default "targetLatitude"
+     */
+    targetLatitudeField?: string;
+    /**
+     * A field in data that holds the waypoints array.
+     * @default "waypoints"
+     */
+    waypointsField?: string;
+}
+/**
+ * Creates a map series for displaying Sankey-style flow bands on a map.
+ *
+ * Generates actual GeoJSON polygon geometries for each flow, so they
+ * properly follow the map projection during panning, zooming, and rotation.
+ *
+ * @see {@link https://www.amcharts.com/docs/v5/charts/map-chart/map-sankey-series/} for more info
+ * @since 5.17.0
+ * @important
+ */
+export declare class MapSankeySeries extends MapPolygonSeries {
+    /**
+     * Don't consume polygon features from geodata - our data comes from user's data array.
+     */
+    protected _types: Array<GeoJSON.GeoJsonGeometryTypes>;
+    /**
+     * A sub-series that manages node data items and visuals.
+     *
+     * Nodes are auto-created from link data. You can also set
+     * `nodes.data.setAll([...])` with custom names and fills.
+     *
+     * `nodes.mapPolygons.template` configures node appearance.
+     */
+    readonly nodes: MapSankeyNodes;
+    /**
+     * Stored bezier segment params per data item for bullet positioning.
+     * Each link can have multiple segments (when waypoints are used).
+     * @ignore
+     */
+    _bezierSegments: Map<DataItem<IMapSankeySeriesDataItem>, Array<IBezierSegment>>;
+    /**
+     * Cumulative arc-length array per data item for uniform-speed bullet positioning.
+     * Entry i = cumulative length from segment 0 through segment i.
+     * Last entry = total path length.
+     * @ignore
+     */
+    _segmentCumulativeLengths: Map<DataItem<IMapSankeySeriesDataItem>, number[]>;
+    private _geoSourceCoords;
+    private _geoTargetCoords;
+    private _geoWidths;
+    private _geoSourceGroups;
+    private _geoTargetGroups;
+    private _geoNodeSourceTotal;
+    private _geoNodeTargetTotal;
+    private _geoNodeRange;
+    private _geoSourceOffsets;
+    private _geoTargetOffsets;
+    /**
+     * @ignore
+     */
+    protected _afterNew(): void;
+    static className: string;
+    static classNames: Array<string>;
+    _settings: IMapSankeySeriesSettings;
+    _privateSettings: IMapSankeySeriesPrivate;
+    _dataItemSettings: IMapSankeySeriesDataItem;
+    /**
+     * @ignore
+     */
+    markDirtyProjection(): void;
+    /**
+     * Evaluate a single bezier segment at parameter t.
+     *
+     * Same formula as $math.getPointOnCubicCurve but operates on flat
+     * IBezierSegment fields (lon/lat) to avoid IPoint object allocation.
+     */
+    protected _evalBezier(bp: IBezierSegment, t: number): IGeoPoint;
+    /**
+     * Approximates the arc length of a single bezier segment by sampling
+     * points along the curve and summing Haversine distances.
+     *
+     * @param bp       Bezier segment parameters
+     * @param samples  Number of sample intervals (default 20)
+     * @return         Approximate arc length in radians
+     */
+    protected _segmentArcLength(bp: IBezierSegment, samples?: number): number;
+    /**
+     * Computes cumulative arc lengths for a set of bezier segments and
+     * stores them in `_segmentCumulativeLengths` for arc-length parameterization.
+     *
+     * @param dataItem  Link data item (used as cache key)
+     * @param segments  Array of bezier segment parameters
+     */
+    protected _computeCumulativeLengths(dataItem: DataItem<IMapSankeySeriesDataItem>, segments: Array<IBezierSegment>): void;
+    /**
+     * Resolves a normalized location (0–1) to a segment index and local t
+     * using arc-length parameterization. Delegates to `$math.resolveLocationOnPath`
+     * when cumulative lengths are available; falls back to equal distribution.
+     *
+     * @param dataItem  Link data item (for cumulative length lookup)
+     * @param location  Relative position along the full path (0–1)
+     * @param segments  Array of bezier segment parameters (used for fallback)
+     * @return          Segment index and local t (0–1)
+     */
+    protected _resolveLocation(dataItem: DataItem<IMapSankeySeriesDataItem>, location: number, segments: Array<IBezierSegment>): {
+        segIdx: number;
+        t: number;
+    };
+    /**
+     * Returns a screen-space point at a relative position (0-1) along
+     * the center-line bezier for the given data item.
+     *
+     * Used internally for bullet positioning, but can also be called
+     * directly to get coordinates along a flow path.
+     *
+     * @param   dataItem  Target data item
+     * @param   location  Relative position (0 = source, 1 = target)
+     * @return            Screen coordinates and angle
+     */
+    getPoint(dataItem: DataItem<IMapSankeySeriesDataItem>, location: number): IOrientationPoint;
+    /**
+     * Returns a geo point at a relative position (0-1) along the center-line bezier.
+     */
+    getGeoPoint(dataItem: DataItem<IMapSankeySeriesDataItem>, location: number): IGeoPoint | undefined;
+    /**
+     * Returns the approximate arc length of the path for a data item.
+     * Useful for scaling animation duration proportionally to distance.
+     */
+    getPathLength(dataItem: DataItem<IMapSankeySeriesDataItem>): number;
+    /**
+     * Combined getPoint + getGeoPoint in a single pass (avoids double
+     * _resolveLocation + _evalBezier per bullet per frame).
+     * @ignore
+     */
+    private _getPointWithGeo;
+    /**
+     * Positions a bullet along its parent link's bezier path.
+     *
+     * @param bullet  Bullet to position
+     */
+    _positionBullet(bullet: Bullet): void;
+    /**
+     * @ignore
+     */
+    disposeDataItem(dataItem: DataItem<this["_dataItemSettings"]>): void;
+    /**
+     * @ignore
+     */
+    protected _dispose(): void;
+    /**
+     * Processes a newly added data item, creating placeholder geometry and
+     * registering it with source/target nodes.
+     *
+     * @param dataItem  Data item to process
+     */
+    protected processDataItem(dataItem: DataItem<this["_dataItemSettings"]>): void;
+    /**
+     * @ignore
+     */
+    protected _onDataClear(): void;
+    /**
+     * @ignore
+     */
+    _prepareChildren(): void;
+    /**
+     * Rebuilds all link band geometries from current data.
+     *
+     * Computes bezier control points, stacking offsets, band polygons,
+     * and cumulative arc lengths for each link.
+     */
+    protected _generateGeometries(): void;
+}
+//# sourceMappingURL=MapSankeySeries.d.ts.map

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

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