@d3plus/core 3.0.16 → 3.1.0

package/es/src/charts/Sankey.js

@@ -1,3 +1,11 @@
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
 function _assert_this_initialized(self) {
     if (self === void 0) {
         throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
@@ -62,6 +70,33 @@ function _inherits(subClass, superClass) {
     });
     if (superClass) _set_prototype_of(subClass, superClass);
 }
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
 function _possible_constructor_return(self, call) {
     if (call && (_type_of(call) === "object" || typeof call === "function")) {
         return call;
@@ -75,6 +110,9 @@ function _set_prototype_of(o, p) {
     };
     return _set_prototype_of(o, p);
 }
+function _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
 function _super_prop_base(object, property) {
     while(!Object.prototype.hasOwnProperty.call(object, property)){
         object = _get_prototype_of(object);
@@ -86,6 +124,14 @@ function _type_of(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
 function _is_native_reflect_construct() {
     try {
         var result = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function() {}));
@@ -94,7 +140,7 @@ function _is_native_reflect_construct() {
         return !!result;
     })();
 }
-import { nest } from "d3-collection";
+import { groups } from "d3-array";
 import { sankey, sankeyCenter, sankeyJustify, sankeyLeft, sankeyLinkHorizontal, sankeyRight } from "d3-sankey";
 var sankeyAligns = {
     center: sankeyCenter,
@@ -173,7 +219,7 @@ var Sankey = /*#__PURE__*/ function(Viz) {
                 label: false,
                 stroke: "#DBDBDB",
                 strokeOpacity: 0.5,
-                strokeWidth: function(d) {
+                strokeWidth: function strokeWidth(d) {
                     return Math.max(1, Math.abs(d.source.y1 - d.source.y0) * (d.value / d.source.value) - 2);
                 }
             },
@@ -187,7 +233,7 @@ var Sankey = /*#__PURE__*/ function(Viz) {
             /**
       Extends the draw behavior of the abstract Viz class.
       @private
-  */ key: "_draw",
+*/ key: "_draw",
             value: function _draw(callback) {
                 var _this = this;
                 _get(_get_prototype_of(Sankey.prototype), "_draw", this).call(this, callback);
@@ -251,10 +297,11 @@ var Sankey = /*#__PURE__*/ function(Viz) {
                         transform: transform
                     }
                 }).node()).render());
-                nest().key(function(d) {
+                groups(nodes, function(d) {
                     return d.shape;
-                }).entries(nodes).forEach(function(d) {
-                    _this._shapes.push(new shapes[d.key]().data(d.values).height(function(d) {
+                }).forEach(function(param) {
+                    var _param = _sliced_to_array(param, 2), key = _param[0], values = _param[1];
+                    _this._shapes.push(new shapes[key]().data(values).height(function(d) {
                         return d.y1 - d.y0;
                     }).width(function(d) {
                         return d.x1 - d.x0;
@@ -270,18 +317,15 @@ var Sankey = /*#__PURE__*/ function(Viz) {
                         update: {
                             transform: transform
                         }
-                    }).node()).config(configPrep.bind(_this)(_this._shapeConfig, "shape", d.key)).render());
+                    }).node()).config(configPrep.bind(_this)(_this._shapeConfig, "shape", key)).render());
                 });
                 return this;
             }
         },
         {
             /**
-      @memberof Sankey
-      @desc If *value* is specified, sets the hover method to the specified function and returns the current class instance.
-      @param {Function} [*value*]
-      @chainable
-   */ key: "hover",
+      The hover callback function for highlighting shapes on mouseover.
+*/ key: "hover",
             value: function hover(_) {
                 this._hover = _;
                 this._shapes.forEach(function(s) {
@@ -293,25 +337,20 @@ var Sankey = /*#__PURE__*/ function(Viz) {
         },
         {
             /**
-      @memberof Sankey
-      @desc A pass-through for the d3-sankey [iterations](https://github.com/d3/d3-sankey?tab=readme-ov-file#sankey_iterations) function.
-      @param {Number} [*value* = 6]
-      @chainable
-  */ key: "iterations",
+      A pass-through for the d3-sankey [iterations](https://github.com/d3/d3-sankey?tab=readme-ov-file#sankey_iterations) function.
+*/ key: "iterations",
             value: function iterations(_) {
                 return arguments.length ? (this._iterations = _, this) : this._iterations;
             }
         },
         {
             /**
-      @memberof Sankey
-      @desc A predefined *Array* of edges that connect each object passed to the [node](#Sankey.node) method. The `source` and `target` keys in each link need to map to the nodes in one of one way:
+      A predefined *Array* of edges that connect each object passed to the [node](#Sankey.node) method. The `source` and `target` keys in each link need to map to the nodes in one of one way:
 1. A *String* value matching the `id` of the node.
 
 The value passed should be an *Array* of data. An optional formatting function can be passed as a second argument to this method. This custom function will be passed the data that has been loaded, as long as there are no errors. This function should return the final links *Array*.
-      @param {Array} *links* = []
-      @chainable
-  */ key: "links",
+    @param f Array of link objects or a URL to load links from.
+*/ key: "links",
             value: function links(_, f) {
                 if (arguments.length) {
                     addToQueue.bind(this)(_, f, "links");
@@ -322,68 +361,51 @@ The value passed should be an *Array* of data. An optional formatting function c
         },
         {
             /**
-      @memberof Sankey
-      @desc A pass-through for the d3-sankey [linkSort](https://github.com/d3/d3-sankey?tab=readme-ov-file#sankey_linkSort) function.
-      @param {Function|undefined} [*value* = undefined]
-      @chainable
-  */ key: "linkSort",
+      A pass-through for the d3-sankey [linkSort](https://github.com/d3/d3-sankey?tab=readme-ov-file#sankey_linkSort) function.
+*/ key: "linkSort",
             value: function linkSort(_) {
                 return arguments.length ? (this._linkSort = _, this) : this._linkSort;
             }
         },
         {
             /**
-      @memberof Sankey
-      @desc The key inside of each link Object that references the source node.
-      @param {String} [*value* = "source"]
-      @chainable
-  */ key: "linksSource",
+      The key inside of each link Object that references the source node.
+*/ key: "linksSource",
             value: function linksSource(_) {
                 return arguments.length ? (this._linksSource = _, this) : this._linksSource;
             }
         },
         {
             /**
-      @memberof Sankey
-      @desc The key inside of each link Object that references the target node.
-      @param {String} [*value* = "target"]
-      @chainable
-  */ key: "linksTarget",
+      The key inside of each link Object that references the target node.
+*/ key: "linksTarget",
             value: function linksTarget(_) {
                 return arguments.length ? (this._linksTarget = _, this) : this._linksTarget;
             }
         },
         {
             /**
-      @memberof Sankey
-      @desc Sets the nodeAlign property of the sankey layout, which can either be "left", "right", "center", or "justify".
-      @param {Function|String} [*value* = "justify"]
-      @chainable
-  */ key: "nodeAlign",
+      The nodeAlign property of the sankey layout, which can be "left", "right", "center", or "justify".
+*/ key: "nodeAlign",
             value: function nodeAlign(_) {
                 return arguments.length ? (this._nodeAlign = typeof _ === "function" ? _ : sankeyAligns[_], this) : this._nodeAlign;
             }
         },
         {
             /**
-      @memberof Sankey
-      @desc If *value* is specified, sets the node id accessor(s) to the specified array of values and returns the current class instance. If *value* is not specified, returns the current node group accessor.
-      @param {String} [*value* = "id"]
-      @chainable
-  */ key: "nodeId",
+      The node id accessor(s).
+*/ key: "nodeId",
             value: function nodeId(_) {
                 return arguments.length ? (this._nodeId = typeof _ === "function" ? _ : accessor(_), this) : this._nodeId;
             }
         },
         {
             /**
-      @memberof Sankey
-      @desc The list of nodes to be used for drawing the network. The value passed must be an *Array* of data.
+      The list of nodes to be used for drawing the network. The value passed must be an *Array* of data.
 
 Additionally, a custom formatting function can be passed as a second argument to this method. This custom function will be passed the data that has been loaded, as long as there are no errors. This function should return the final node *Array*.
-      @param {Array} *nodes* = []
-      @chainable
-  */ key: "nodes",
+    @param f Array of node objects or a URL to load nodes from.
+*/ key: "nodes",
             value: function nodes(_, f) {
                 if (arguments.length) {
                     addToQueue.bind(this)(_, f, "nodes");
@@ -394,47 +416,37 @@ Additionally, a custom formatting function can be passed as a second argument to
         },
         {
             /**
-      @memberof Sankey
-      @desc If *value* is specified, sets the padding of the node and returns the current class instance. If *value* is not specified, returns the current nodePadding. By default, the nodePadding size is 8.
-      @param {Number} [*value* = 8]
-      @chainable
-  */ key: "nodePadding",
+      Padding of the node. By default, the nodePadding size is 8.
+*/ key: "nodePadding",
             value: function nodePadding(_) {
                 return arguments.length ? (this._nodePadding = _, this) : this._nodePadding;
             }
         },
         {
             /**
-      @memberof Sankey
-      @desc A pass-through for the d3-sankey [nodeSort](https://github.com/d3/d3-sankey?tab=readme-ov-file#sankey_nodeSort) function.
-      @param {Function|undefined} [*value* = undefined]
-      @chainable
-  */ key: "nodeSort",
+      A pass-through for the d3-sankey [nodeSort](https://github.com/d3/d3-sankey?tab=readme-ov-file#sankey_nodeSort) function.
+*/ key: "nodeSort",
             value: function nodeSort(_) {
                 return arguments.length ? (this._nodeSort = _, this) : this._nodeSort;
             }
         },
         {
             /**
-      @memberof Sankey
-      @desc If *value* is specified, sets the width of the node and returns the current class instance. If *value* is not specified, returns the current nodeWidth. By default, the nodeWidth size is 30.
-      @param {Number} [*value* = 30]
-      @chainable
-  */ key: "nodeWidth",
+      Width of the node. By default, the nodeWidth size is 30.
+*/ key: "nodeWidth",
             value: function nodeWidth(_) {
                 return arguments.length ? (this._nodeWidth = _, this) : this._nodeWidth;
             }
         },
         {
             /**
-      @memberof Sankey
-      @desc If *value* is specified, sets the width of the links and returns the current class instance. If *value* is not specified, returns the current value accessor.
-      @param {Function|Number} *value*
-      @example
+      Width of the links.
+
+@example
 function value(d) {
   return d.value;
 }
-  */ key: "value",
+*/ key: "value",
             value: function value(_) {
                 return arguments.length ? (this._value = typeof _ === "function" ? _ : accessor(_), this) : this._value;
             }
@@ -443,7 +455,5 @@ function value(d) {
     return Sankey;
 }(Viz);
 /**
-    @class Sankey
-    @extends Viz
-    @desc Creates a sankey visualization based on a defined set of nodes and links. [Click here](http://d3plus.org/examples/d3plus-network/sankey-diagram/) for help getting started using the Sankey class.
+    Creates a sankey visualization based on a defined set of nodes and links. [Click here](http://d3plus.org/examples/d3plus-network/sankey-diagram/) for help getting started using the Sankey class.
 */ export { Sankey as default };

package/es/src/charts/StackedArea.js

@@ -71,9 +71,7 @@ var StackedArea = /*#__PURE__*/ function(AreaPlot) {
     return StackedArea;
 }(AreaPlot);
 /**
-    @class StackedArea
-    @extends Area
-    @desc Creates a stacked area plot based on an array of data.
+    Creates a stacked area plot based on an array of data.
     @example <caption>the equivalent of calling:</caption>
 new d3plus.AreaPlot()
   .stacked(true)

package/es/src/charts/Tree.js

@@ -110,8 +110,8 @@ function _is_native_reflect_construct() {
 import { extent, min, max } from "d3-array";
 import { hierarchy, tree } from "d3-hierarchy";
 import { scaleLinear } from "d3-scale";
-import { colorDefaults } from "@d3plus/color";
-import { assign, elem } from "@d3plus/dom";
+import { colorContrast, colorDefaults } from "@d3plus/color";
+import { assign, backgroundColor, elem } from "@d3plus/dom";
 import { merge, nest } from "@d3plus/data";
 import { configPrep, constant } from "../utils/index.js";
 import * as shapes from "../shapes/index.js";
@@ -134,11 +134,14 @@ var Tree = /*#__PURE__*/ function(Viz) {
         _this._previousShapes = [];
         _this._shape = constant("Circle");
         _this._shapeConfig = assign(_this._shapeConfig, {
-            ariaLabel: function(d, i) {
+            ariaLabel: function ariaLabel(d, i) {
                 return _this._treeData ? "".concat(_this._treeData[i].depth, ". ").concat(_this._drawLabel(d, i), ".") : "";
             },
             labelConfig: {
-                fontColor: colorDefaults.dark
+                fontColor: function fontColor() {
+                    var bg = _this._select ? backgroundColor(_this._select.node()) : "rgb(255, 255, 255)";
+                    return colorContrast(bg);
+                }
             },
             Path: {
                 fill: "none",
@@ -150,7 +153,7 @@ var Tree = /*#__PURE__*/ function(Viz) {
             height: constant(12)
         });
         _this._tooltipConfig = assign(_this._tooltipConfig, {
-            title: function(d, i, x) {
+            title: function title(d, i, x) {
                 return _this._drawLabel(d, i, x.depth - 1);
             }
         });
@@ -162,7 +165,7 @@ var Tree = /*#__PURE__*/ function(Viz) {
             /**
       Extends the draw behavior of the abstract Viz class.
       @private
-  */ key: "_draw",
+*/ key: "_draw",
             value: function _draw(callback) {
                 var _this = this;
                 _get(_get_prototype_of(Tree.prototype), "_draw", this).call(this, callback);
@@ -183,7 +186,7 @@ var Tree = /*#__PURE__*/ function(Viz) {
                 /**
         Merges the values of a given nest branch.
         @private
-    */ function flattenBranchData(branch) {
+*/ function flattenBranchData(branch) {
                     return merge(branch.values.map(function(l) {
                         return l.key && l.values ? flattenBranchData(l) : l;
                     }), that._aggs);
@@ -212,7 +215,8 @@ var Tree = /*#__PURE__*/ function(Viz) {
                     return d.depth;
                 }).map(function(d) {
                     return d.values.reduce(function(num, v, i) {
-                        var next = i < d.values.length - 1 ? d.values[i + 1].x : width + _this._margin[left], prev = i ? d.values[i - 1].x : _this._margin[left];
+                        var vals = d.values;
+                        var next = i < vals.length - 1 ? vals[i + 1].x : width + _this._margin[left], prev = i ? vals[i - 1].x : _this._margin[left];
                         return min([
                             num,
                             next - v.x,
@@ -245,34 +249,34 @@ var Tree = /*#__PURE__*/ function(Viz) {
                 }).map(function(d) {
                     return assign({}, d);
                 })).select(elem("g.d3plus-Tree-Links", elemObject).node()).config(configPrep.bind(this)(this._shapeConfig, "shape", "Path")).config({
-                    d: function(d) {
+                    d: function d(d) {
                         var r = _this._shapeConfig.r;
                         if (typeof r === "function") r = r(d.data, d.i);
                         var px = d.parent.x - d.x + (isVertical ? 0 : r), py = d.parent.y - d.y + (isVertical ? r : 0), x = isVertical ? 0 : -r, y = isVertical ? -r : 0;
                         return isVertical ? "M".concat(x, ",").concat(y, "C").concat(x, ",").concat((y + py) / 2, " ").concat(px, ",").concat((y + py) / 2, " ").concat(px, ",").concat(py) : "M".concat(x, ",").concat(y, "C").concat((x + px) / 2, ",").concat(y, " ").concat((x + px) / 2, ",").concat(py, " ").concat(px, ",").concat(py);
                     },
-                    id: function(d, i) {
+                    id: function id(d, i) {
                         return _this._ids(d, i)[d.depth - 1];
                     }
                 }).render());
                 var shapeConfig = {
-                    id: function(d, i) {
+                    id: function id(d, i) {
                         return _this._ids(d, i)[d.depth - 1];
                     },
-                    label: function(d, i) {
+                    label: function label(d, i) {
                         if (_this._label) return _this._label(d.data, i);
                         var ids = _this._ids(d, i).slice(0, d.depth);
                         return ids[ids.length - 1];
                     },
                     labelConfig: {
-                        textAnchor: function(d, i, x) {
+                        textAnchor: function textAnchor(d, i, x) {
                             return isVertical ? "middle" : x.children && x.depth !== _this._drawDepth + 1 ? "end" : "start";
                         },
-                        verticalAlign: function(d, i, x) {
+                        verticalAlign: function verticalAlign(d, i, x) {
                             return isVertical ? x.depth === 1 ? "bottom" : "top" : "middle";
                         }
                     },
-                    hitArea: function(d, i, s) {
+                    hitArea: function hitArea(d, i, s) {
                         var h = _this._labelHeight, offset = s.r ? s.r : isVertical ? s.height / 2 : s.width / 2, w = _this._labelWidths[d.depth - 1];
                         return {
                             width: isVertical ? w : offset * 2 + w,
@@ -281,7 +285,7 @@ var Tree = /*#__PURE__*/ function(Viz) {
                             y: isHorizontal ? -h / 2 : d.children && d.depth !== _this._groupBy.length ? -(offset + _this._labelHeight) : -offset
                         };
                     },
-                    labelBounds: function(d, i, s) {
+                    labelBounds: function labelBounds(d, i, s) {
                         var h = _this._labelHeight, height = isVertical ? "height" : "width", offset = s.r ? s.r : isVertical ? s.height / 2 : s.width / 2, w = _this._labelWidths[d.depth - 1], width = isVertical ? "width" : "height", x = isVertical ? "x" : "y", y = isVertical ? "y" : "x";
                         var _obj;
                         return _obj = {}, _define_property(_obj, width, w), _define_property(_obj, height, h), _define_property(_obj, x, -w / 2), _define_property(_obj, y, d.children && d.depth !== _this._groupBy.length ? -(offset + h) : offset), _obj;
@@ -311,27 +315,24 @@ var Tree = /*#__PURE__*/ function(Viz) {
         },
         {
             /**
-      @memberof Tree
-      @desc Changes the orientation of the entire Tree, either "vertical" (top to bottom) or "horizontal" (left to right).
-      @param {'vertical'|'horizontal'} [*value* = "vertical"] Accepts either "vertical" or "horizontal".
-  */ key: "orient",
+      Changes the orientation of the entire Tree, either "vertical" (top to bottom) or "horizontal" (left to right).
+*/ key: "orient",
             value: function orient(_) {
                 return arguments.length ? (this._orient = _, this) : this._orient;
             }
         },
         {
             /**
-      @memberof Tree
-      @desc If *value* is specified, sets the separation accessor to the specified function. If *value* is not specified, returns the current separation accessor.
+      The separation function between neighboring nodes.
 
 From the [d3-hierarchy documentation](https://github.com/d3/d3-hierarchy#tree_separation):
 > The separation accessor is used to separate neighboring nodes. The separation function is passed two nodes a and b, and must return the desired separation. The nodes are typically siblings, though the nodes may be more distantly related if the layout decides to place such nodes adjacent.
-      @param {Function} [*value*]
-      @example
+
+@example
 function separation(a, b) {
   return a.parent === b.parent ? 1 : 2;
 }
-  */ key: "separation",
+*/ key: "separation",
             value: function separation(_) {
                 return arguments.length ? (this._separation = _, this) : this._separation;
             }
@@ -340,7 +341,5 @@ function separation(a, b) {
     return Tree;
 }(Viz);
 /**
-    @class Tree
-    @extends Viz
-    @desc Uses d3's [tree layout](https://github.com/d3/d3-hierarchy#tree) to create a tidy tree chart based on an array of data.
+    Uses d3's [tree layout](https://github.com/d3/d3-hierarchy#tree) to create a tidy tree chart based on an array of data.
 */ export { Tree as default };