@d3plus/core 3.0.14 → 3.0.16

package/umd/d3plus-core.js

@@ -1,7 +1,7 @@
 /*
-  @d3plus/core v3.0.14
+  @d3plus/core v3.0.16
   Data visualization made easy. A javascript library that extends the popular D3.js to enable fast and beautiful visualizations.
-  Copyright (c) 2025 D3plus - https://d3plus.org
+  Copyright (c) 2026 D3plus - https://d3plus.org
   @license MIT
 */
 
@@ -587,7 +587,7 @@
               }
           }
       }
-      return 0; // Return -1 if no element is found with the class
+      return -1; // Return -1 if no element is found with the class
   }
   class Shape extends BaseClass {
       /**
@@ -784,8 +784,6 @@
           this._group.selectAll(`g.d3plus-${this._name}-shape, g.d3plus-${this._name}-image, g.d3plus-${this._name}-text, g.d3plus-${this._name}-hover`).selectAll(".d3plus-Shape, .d3plus-Image, .d3plus-textBox").each(function(d, i) {
               if (!d) d = {};
               if (!d.parentNode) d.parentNode = this.parentNode;
-              if (!d.dataIndex) d.dataIndex = i;
-              const dataIndex = d.dataIndex;
               const parent = d.parentNode;
               const d3plusType = d3Selection.select(this).classed("d3plus-textBox") ? "textBox" : d3Selection.select(this).classed("d3plus-Image") ? "Image" : "Shape";
               if (d3plusType === "textBox") d = d.data;
@@ -798,13 +796,15 @@
               const notHovering = !that._hover || typeof that._hover !== "function" || !that._hover(d, i);
               const group = notHovering ? parent : that._hoverGroup.node();
               if (group !== this.parentNode) {
-                  const offset = d3plusType === "textBox" ? findLastIndexWithClass(group.childNodes, [
+                  const afterIndex = d3plusType === "textBox" ? findLastIndexWithClass(group.childNodes, [
                       "d3plus-Image",
                       "d3plus-Shape"
                   ]) : d3plusType === "Image" ? findLastIndexWithClass(group.childNodes, [
                       "d3plus-Shape"
-                  ]) : 0;
-                  group.insertBefore(this, group.childNodes[offset + dataIndex]);
+                  ]) : -1;
+                  if (notHovering) group.appendChild(this);
+                  else if (afterIndex === -1) group.prepend(this);
+                  else group.childNodes[afterIndex].after(this);
               }
               if (this.className.baseVal.includes("d3plus-Shape")) {
                   if (parent === group) d3Selection.select(this).call(that._applyStyle.bind(that));
@@ -8179,7 +8179,7 @@
         @chainable
     */ hover(_) {
           let hoverFunction = this._hover = _;
-          if (this._shapeConfig.hoverOpacity !== 1) {
+          if (this._shapeConfig.hoverOpacity !== 1 && _ !== undefined) {
               if (typeof _ === "function") {
                   let shapeData = d3Array.merge(this._shapes.map((s)=>s.data()));
                   shapeData = shapeData.concat(this._legendClass.data());
@@ -13772,7 +13772,7 @@
               return obj;
           }, {});
           const transform = `translate(${this._margin.left}, ${this._margin.top})`;
-          this._sankey.nodeAlign(this._nodeAlign).nodePadding(this._nodePadding).nodeWidth(this._nodeWidth).nodes(nodes).links(links).size([
+          this._sankey.nodeAlign(this._nodeAlign).nodePadding(this._nodePadding).nodeWidth(this._nodeWidth).nodes(nodes).nodeSort(this._nodeSort).links(links).linkSort(this._linkSort).iterations(this._iterations).size([
               width,
               height
           ])();
@@ -13809,6 +13809,14 @@
           if (this._legend) this._legendClass.hover(_);
           return this;
       }
+      /**
+        @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
+    */ 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:
@@ -13824,6 +13832,14 @@
           }
           return this._links;
       }
+      /**
+        @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
+    */ linkSort(_) {
+          return arguments.length ? (this._linkSort = _, this) : this._linkSort;
+      }
       /**
         @memberof Sankey
         @desc The key inside of each link Object that references the source node.
@@ -13878,6 +13894,14 @@
     */ 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
+    */ 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.
@@ -13903,8 +13927,11 @@
         @private
     */ constructor(){
           super();
+          this._iterations = 6;
           this._nodeId = accessor("id");
+          this._nodeSort = undefined;
           this._links = accessor("links");
+          this._linkSort = undefined;
           this._linksSource = "source";
           this._linksTarget = "target";
           this._noDataMessage = false;