Selection better JsDoc types documentation

js/Blueprint.js

@@ -11,12 +11,7 @@ import Utility from "./Utility"
  * @typedef {import("./entity/PinReferenceEntity").default} PinReferenceEntity
  * @typedef {import("./template/node/CommentNodeTemplate").default} CommentNodeTemplate
  * @typedef {import("lit").PropertyValues} PropertyValues
- * @typedef {{
- *     primaryInf: Number,
- *     primarySup: Number,
- *     secondaryInf: Number,
- *     secondarySup: Number,
- * }} BoundariesInfo
+ * @typedef {typeof Blueprint} BlueprintConstructor
  */
 
 /** @extends {IElement<Object, BlueprintTemplate>} */
@@ -71,6 +66,20 @@ export default class Blueprint extends IElement {
             attribute: false,
         },
     }
+    /** @param {NodeElement} node */
+    static nodeBoundariesSupplier = node => {
+        return {
+            primaryInf: node.leftBoundary(true),
+            primarySup: node.rightBoundary(true),
+            // Counter intuitive here: the y (secondary axis is positive towards the bottom, therefore upper bound "sup" is bottom)
+            secondaryInf: node.topBoundary(true),
+            secondarySup: node.bottomBoundary(true),
+        }
+    }
+    /** @type {(node: NodeElement, selected: Boolean) => void}} */
+    static nodeSelectToggleFunction = (node, selected) => {
+        node.setSelected(selected)
+    }
 
     #avoidScrolling = false
     /** @type {Map<String, Number>} */
@@ -82,20 +91,6 @@ export default class Blueprint extends IElement {
     /** @type {Number[]} */
     mousePosition = [0, 0]
     waitingExpandUpdate = false
-    /** @param {NodeElement} node */
-    nodeBoundariesSupplier = node => {
-        return /** @type {BoundariesInfo} */ {
-            primaryInf: node.leftBoundary(true),
-            primarySup: node.rightBoundary(true),
-            // Counter intuitive here: the y (secondary axis is positive towards the bottom, therefore upper bound "sup" is bottom)
-            secondaryInf: node.topBoundary(true),
-            secondarySup: node.bottomBoundary(true),
-        }
-    }
-    /** @type {(node: NodeElement, selected: Boolean) => void}} */
-    nodeSelectToggleFunction = (node, selected) => {
-        node.setSelected(selected)
-    }
 
     constructor() {
         super()
@@ -349,11 +344,11 @@ export default class Blueprint extends IElement {
     }
 
     selectAll() {
-        this.getNodes().forEach(node => this.nodeSelectToggleFunction(node, true))
+        this.getNodes().forEach(node => Blueprint.nodeSelectToggleFunction(node, true))
     }
 
     unselectAll() {
-        this.getNodes().forEach(node => this.nodeSelectToggleFunction(node, false))
+        this.getNodes().forEach(node => Blueprint.nodeSelectToggleFunction(node, false))
     }
 
     /** @param  {...IElement} graphElements */

js/element/SelectorElement.js

@@ -2,6 +2,8 @@ import FastSelectionModel from "../selection/FastSelectionModel"
 import IFromToPositionedElement from "./IFromToPositionedElement"
 import SelectorTemplate from "../template/SelectorTemplate"
 
+/** @typedef {import("../Blueprint").BlueprintConstructor} BlueprintConstructor */
+
 /** @extends {IFromToPositionedElement<Object, SelectorTemplate>} */
 export default class SelectorElement extends IFromToPositionedElement {
 
@@ -23,13 +25,14 @@ export default class SelectorElement extends IFromToPositionedElement {
 
     /** @param {Number[]} initialPosition */
     beginSelect(initialPosition) {
+        const blueprintConstructor = /** @type {BlueprintConstructor} */(this.blueprint.constructor)
         this.blueprint.selecting = true
         this.setBothLocations(initialPosition)
         this.selectionModel = new FastSelectionModel(
             initialPosition,
             this.blueprint.getNodes(),
-            this.blueprint.nodeBoundariesSupplier,
-            this.blueprint.nodeSelectToggleFunction
+            blueprintConstructor.nodeBoundariesSupplier,
+            blueprintConstructor.nodeSelectToggleFunction
         )
     }
 

js/selection/FastSelectionModel.js

@@ -1,7 +1,9 @@
 import OrderedIndexArray from "./OrderedIndexArray"
 
 /**
- * @typedef {import("../Blueprint").BoundariesInfo} BoundariesInfo
+ * @typedef {import("../element/NodeElement").default} NodeElement
+ * @typedef {typeof import("../Blueprint").default.nodeBoundariesSupplier} BoundariesFunction
+ * @typedef {typeof import("../Blueprint").default.nodeSelectToggleFunction} SelectionFunction
  * @typedef {{
  *     primaryBoundary: Number,
  *     secondaryBoundary: Number,
@@ -9,15 +11,14 @@ import OrderedIndexArray from "./OrderedIndexArray"
  *     rectangle: Number
  *     onSecondaryAxis: Boolean
  * }} Metadata
- * @typedef {any} Rectangle
  */
 export default class FastSelectionModel {
 
     /**
      * @param {Number[]} initialPosition
-     * @param {Rectangle[]} rectangles
-     * @param {(rect: Rectangle) => BoundariesInfo} boundariesFunc
-     * @param {(rect: Rectangle, selected: Boolean) => void} selectFunc
+     * @param {NodeElement[]} rectangles
+     * @param {BoundariesFunction} boundariesFunc
+     * @param {SelectionFunction} selectFunc
      */
     constructor(initialPosition, rectangles, boundariesFunc, selectFunc) {
         this.initialPosition = initialPosition
@@ -30,13 +31,14 @@ export default class FastSelectionModel {
         this.rectangles = rectangles
         this.primaryOrder.reserve(this.rectangles.length)
         this.secondaryOrder.reserve(this.rectangles.length)
+
         rectangles.forEach((rect, index) => {
             /** @type {Metadata} */
             let rectangleMetadata = {
                 primaryBoundary: this.initialPosition[0],
                 secondaryBoundary: this.initialPosition[1],
-                rectangle: index, // used to move both expandings inside the this.metadata array
-                onSecondaryAxis: false
+                rectangle: index,
+                onSecondaryAxis: false,
             }
             this.metadata[index] = rectangleMetadata
             selectFunc(rect, false) // Initially deselected (Eventually)

js/selection/SimpleSelectionModel.js

@@ -1,17 +1,23 @@
+/**
+ * @typedef {import("../element/NodeElement").default} NodeElement
+ * @typedef {typeof import("../Blueprint").default.nodeBoundariesSupplier} BoundariesFunction
+ * @typedef {typeof import("../Blueprint").default.nodeSelectToggleFunction} SelectionFunction
+ * @typedef {{
+*     primaryBoundary: Number,
+*     secondaryBoundary: Number,
+*     insertionPosition?: Number,
+*     rectangle: Number
+*     onSecondaryAxis: Boolean
+* }} Metadata
+*/
+
 export default class SimpleSelectionModel {
 
     /**
-     * @typedef {{
-     *      primaryInf: number,
-     *      primarySup: number,
-     *      secondaryInf: number,
-     *      secondarySup: number
-     * }} BoundariesInfo
-     * @typedef {Number} Rectangle
-     * @param {number[]} initialPosition Coordinates of the starting point of selection [primaryAxisValue, secondaryAxisValue].
-     * @param {Rectangle[]} rectangles Rectangles that can be selected by this object.
-     * @param {(rect: Rectangle) => BoundariesInfo} boundariesFunc A function that, given a rectangle, it provides the boundaries of such rectangle.
-     * @param {(rect: Rectangle, selected: Boolean) => void} selectToggleFunction A function that selects or deselects individual rectangles.
+     * @param {Number[]} initialPosition
+     * @param {NodeElement[]} rectangles
+     * @param {BoundariesFunction} boundariesFunc
+     * @param {SelectionFunction} selectToggleFunction
      */
     constructor(initialPosition, rectangles, boundariesFunc, selectToggleFunction) {
         this.initialPosition = initialPosition