class Utility { static clamp(val, min, max) { return Math.min(Math.max(val, min), max) } static getScale(element) { return getComputedStyle(element).getPropertyValue('--ueb-scale') } } class Pointing { constructor(target, blueprint, options) { /** @type {HTMLElement} */ this.target = target; /** @type {import("../UEBlueprint").EBlueprint}" */ this.blueprint = blueprint; this.movementSpace = this.blueprint?.getGridDOMElement() ?? document.documentElement; } getLocation(mouseEvent) { const scaleCorrection = 1 / Utility.getScale(this.target); const targetOffset = this.movementSpace.getBoundingClientRect(); let location = [ (mouseEvent.clientX - targetOffset.x) * scaleCorrection, (mouseEvent.clientY - targetOffset.y) * scaleCorrection ]; return location } } /** * This class manages the ui gesture of mouse click and drag. Tha actual operations are implemented by the subclasses. */ class MouseClickDrag extends Pointing { constructor(target, blueprint, options) { super(target, blueprint, options); this.clickButton = options?.clickButton ?? 0; this.exitAnyButton = options?.exitAnyButton ?? true; this.moveEverywhere = options?.moveEverywhere ?? false; this.looseTarget = options?.looseTarget ?? false; this.started = false; this.clickedPosition = [0, 0]; const movementListenedElement = this.moveEverywhere ? document.documentElement : this.movementSpace; let self = this; this.mouseDownHandler = function (e) { switch (e.button) { case self.clickButton: // Either doesn't matter or consider the click only when clicking on the parent, not descandants if (self.looseTarget || e.target == e.currentTarget) { e.stopPropagation(); self.started = false; // Attach the listeners movementListenedElement.addEventListener('mousemove', self.mouseStartedMovingHandler); document.addEventListener('mouseup', self.mouseUpHandler); self.clickedPosition = self.getLocation(e); self.clicked(self.clickedPosition); } break default: if (!self.exitAnyButton) { self.mouseUpHandler(e); } break } }; this.mouseStartedMovingHandler = function (e) { e.preventDefault(); e.stopPropagation(); // Delegate from now on to self.mouseMoveHandler movementListenedElement.removeEventListener('mousemove', self.mouseStartedMovingHandler); movementListenedElement.addEventListener('mousemove', self.mouseMoveHandler); // Do actual actions self.startDrag(); self.started = true; }; this.mouseMoveHandler = function (e) { e.preventDefault(); e.stopPropagation(); const location = self.getLocation(e); const movement = [e.movementX, e.movementY]; self.dragTo(location, movement); }; this.mouseUpHandler = function (e) { if (!self.exitAnyButton || e.button == self.clickButton) { // Remove the handlers of "mousemove" and "mouseup" movementListenedElement.removeEventListener('mousemove', self.mouseStartedMovingHandler); movementListenedElement.removeEventListener('mousemove', self.mouseMoveHandler); document.removeEventListener('mouseup', self.mouseUpHandler); self.endDrag(); } }; this.target.addEventListener('mousedown', this.mouseDownHandler); if (this.clickButton == 2) { this.target.addEventListener('contextmenu', this.preventDefault); } } preventDefault(e) { e.preventDefault(); } unlistenDOMElement() { this.target.removeEventListener('mousedown', this.mouseDownHandler); if (this.clickButton == 2) { this.target.removeEventListener('contextmenu', this.preventDefault); } } /* Subclasses will override the following methods */ clicked(location) { } startDrag() { } dragTo(location, movement) { } endDrag() { } } class DragScroll extends MouseClickDrag { dragTo(location, movement) { this.blueprint.scrollDelta([-movement[0], -movement[1]]); } } class Select extends MouseClickDrag { constructor(target, blueprint, options) { super(target, blueprint, options); this.stepSize = options?.stepSize; this.mousePosition = [0, 0]; } startDrag() { this.blueprint.startSelecting(this.clickedPosition); } dragTo(location, movement) { this.blueprint.doSelecting(location); } endDrag() { if (this.started) { this.blueprint.finishSelecting(); } else { this.blueprint.unselectAll(); } } } class MouseWheel extends Pointing { /** * * @param {HTMLElement} target * @param {import("../UEBlueprint").EBlueprint} blueprint * @param {Object} options */ constructor(target, blueprint, options) { super(target, blueprint, options); this.looseTarget = options?.looseTarget ?? true; let self = this; this.mouseWheelHandler = function (e) { e.preventDefault(); const location = self.getLocation(e); self.wheel(Math.sign(e.deltaY), location); }; this.movementSpace.addEventListener('wheel', this.mouseWheelHandler, false); // Prevent movement space from being scrolled this.movementSpace.parentElement?.addEventListener('wheel', e => e.preventDefault()); } /* Subclasses will override the following method */ wheel(variation, location) { } } class Zoom extends MouseWheel { wheel(variation, location) { let zoomLevel = this.blueprint.getZoom(); zoomLevel -= variation; this.blueprint.setZoom(zoomLevel, location); } } class OrderedIndexArray { /** * @param {(arrayElement: number) => number} compareFunction A function that, given acouple of elements of the array telles what order are they on. * @param {(number|array)} value Initial length or array to copy from */ constructor(comparisonValueSupplier = (a) => a, value = null) { this.array = new Uint32Array(value); this.comparisonValueSupplier = comparisonValueSupplier; this.length = 0; this.currentPosition = 0; } /** * * @param {number} index The index of the value to return * @returns The element of the array */ get(index) { if (index >= 0 && index < this.length) { return this.array[index] } return null } /** * Returns the array used by this object. * @returns The array. */ getArray() { return this.array } /** * Get the position that the value supplied should (or does) occupy in the aray. * @param {number} value The value to look for (it doesn't have to be part of the array). * @returns The position index. */ getPosition(value) { let l = 0; let r = this.length; while (l < r) { let m = Math.floor((l + r) / 2); if (this.comparisonValueSupplier(this.array[m]) < value) { l = m + 1; } else { r = m; } } return l } reserve(length) { if (this.array.length < length) { let newArray = new Uint32Array(length); newArray.set(this.array); this.array = newArray; } } /** * Inserts the element in the array. * @param element {number} The value to insert into the array. * @returns {number} The position into occupied by value into the array. */ insert(element, comparisonValue = null) { let position = this.getPosition(this.comparisonValueSupplier(element)); if ( position < this.currentPosition || comparisonValue != null && position == this.currentPosition && this.comparisonValueSupplier(element) < comparisonValue) { ++this.currentPosition; } /* let newArray = new Uint32Array(this.array.length + 1) newArray.set(this.array.subarray(0, position), 0) newArray[position] = element newArray.set(this.array.subarray(position), position + 1) this.array = newArray */ this.shiftRight(position); this.array[position] = element; ++this.length; return position } /** * Removes the element from the array. * @param {number} value The value of the element to be remove. */ remove(element) { let position = this.getPosition(this.comparisonValueSupplier(element)); if (this.array[position] == element) { this.removeAt(position); } } /** * Removes the element into the specified position from the array. * @param {number} position The index of the element to be remove. */ removeAt(position) { if (position < this.currentPosition) { --this.currentPosition; } /* let newArray = new Uint32Array(this.array.length - 1) newArray.set(this.array.subarray(0, position), 0) newArray.set(this.array.subarray(position + 1), position) this.array = newArray */ this.shiftLeft(position); --this.length; return position } getNext() { if (this.currentPosition >= 0 && this.currentPosition < this.length) { return this.get(this.currentPosition) } return null } getNextValue() { if (this.currentPosition >= 0 && this.currentPosition < this.length) { return this.comparisonValueSupplier(this.get(this.currentPosition)) } else { return Number.MAX_SAFE_INTEGER } } getPrev() { if (this.currentPosition > 0) { return this.get(this.currentPosition - 1) } return null } getPrevValue() { if (this.currentPosition > 0) { return this.comparisonValueSupplier(this.get(this.currentPosition - 1)) } else { return Number.MIN_SAFE_INTEGER } } shiftLeft(leftLimit, steps = 1) { this.array.set(this.array.subarray(leftLimit + steps), leftLimit); } shiftRight(leftLimit, steps = 1) { this.array.set(this.array.subarray(leftLimit, -steps), leftLimit + steps); } } class FastSelectionModel { /** * @typedef {{ * primaryInf: number, * primarySup: number, * secondaryInf: number, * secondarySup: number * }} BoundariesInfo * @typedef {{ * primaryBoundary: number, * secondaryBoundary: number, * insertionPosition: number, * rectangle: number * onSecondaryAxis: Boolean * }} Metadata * @typedef {numeric} 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: bool) => void} selectFunc A function that selects or deselects individual rectangles. */ constructor(initialPosition, rectangles, boundariesFunc, selectFunc) { this.initialPosition = initialPosition; this.finalPosition = initialPosition; /** @type Metadata[] */ this.metadata = new Array(rectangles.length); this.primaryOrder = new OrderedIndexArray((element) => this.metadata[element].primaryBoundary); this.secondaryOrder = new OrderedIndexArray((element) => this.metadata[element].secondaryBoundary); this.selectFunc = selectFunc; 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 }; this.metadata[index] = rectangleMetadata; selectFunc(rect, false); // Initially deselected (Eventually) const rectangleBoundaries = boundariesFunc(rect); // Secondary axis first because it may be inserted in this.secondaryOrder during the primary axis check if (this.initialPosition[1] < rectangleBoundaries.secondaryInf) { // Initial position is before the rectangle rectangleMetadata.secondaryBoundary = rectangleBoundaries.secondaryInf; } else if (rectangleBoundaries.secondarySup < this.initialPosition[1]) { // Initial position is after the rectangle rectangleMetadata.secondaryBoundary = rectangleBoundaries.secondarySup; } else { rectangleMetadata.onSecondaryAxis = true; } if (this.initialPosition[0] < rectangleBoundaries.primaryInf) { // Initial position is before the rectangle rectangleMetadata.primaryBoundary = rectangleBoundaries.primaryInf; this.primaryOrder.insert(index); } else if (rectangleBoundaries.primarySup < this.initialPosition[0]) { // Initial position is after the rectangle rectangleMetadata.primaryBoundary = rectangleBoundaries.primarySup; this.primaryOrder.insert(index); } else { // Initial lays inside the rectangle (considering just this axis) // Secondary order depends on primary order, if primary boundaries are not satisfied, the element is not watched for secondary ones if (rectangleBoundaries.secondarySup < this.initialPosition[1] || this.initialPosition[1] < rectangleBoundaries.secondaryInf) { this.secondaryOrder.insert(index); } else { selectFunc(rect, true); } } }); this.primaryOrder.currentPosition = this.primaryOrder.getPosition(this.initialPosition[0]); this.secondaryOrder.currentPosition = this.secondaryOrder.getPosition(this.initialPosition[1]); this.computeBoundaries(this.initialPosition); } computeBoundaries() { this.boundaries = { // Primary axis negative expanding primaryN: { v: this.primaryOrder.getPrevValue(), i: this.primaryOrder.getPrev() }, primaryP: { v: this.primaryOrder.getNextValue(), i: this.primaryOrder.getNext() }, // Secondary axis negative expanding secondaryN: { v: this.secondaryOrder.getPrevValue(), i: this.secondaryOrder.getPrev() }, // Secondary axis positive expanding secondaryP: { v: this.secondaryOrder.getNextValue(), i: this.secondaryOrder.getNext() } }; } selectTo(finalPosition) { const direction = [ Math.sign(finalPosition[0] - this.initialPosition[0]), Math.sign(finalPosition[1] - this.initialPosition[1]) ]; const primaryBoundaryCrossed = (index, added) => { if (this.metadata[index].onSecondaryAxis) { this.selectFunc(this.rectangles[index], added); } else { if (added) { this.secondaryOrder.insert(index, finalPosition[1]); const secondaryBoundary = this.metadata[index].secondaryBoundary; if ( // If inserted before the current position Math.sign(finalPosition[1] - secondaryBoundary) == direction[1] // And after initial position && Math.sign(secondaryBoundary - this.initialPosition[1]) == direction[1] ) { // Secondary axis is already satisfied then this.selectFunc(this.rectangles[index], true); } } else { this.selectFunc(this.rectangles[index], false); this.secondaryOrder.remove(index); } } this.computeBoundaries(finalPosition); this.selectTo(finalPosition); }; if (finalPosition[0] < this.boundaries.primaryN.v) { --this.primaryOrder.currentPosition; primaryBoundaryCrossed( this.boundaries.primaryN.i, this.initialPosition[0] > this.boundaries.primaryN.v && finalPosition[0] < this.initialPosition[0]); } else if (finalPosition[0] > this.boundaries.primaryP.v) { ++this.primaryOrder.currentPosition; primaryBoundaryCrossed( this.boundaries.primaryP.i, this.initialPosition[0] < this.boundaries.primaryP.v && this.initialPosition[0] < finalPosition[0]); } const secondaryBoundaryCrossed = (index, added) => { this.selectFunc(this.rectangles[index], added); this.computeBoundaries(finalPosition); this.selectTo(finalPosition); }; if (finalPosition[1] < this.boundaries.secondaryN.v) { --this.secondaryOrder.currentPosition; secondaryBoundaryCrossed( this.boundaries.secondaryN.i, this.initialPosition[1] > this.boundaries.secondaryN.v && finalPosition[1] < this.initialPosition[1]); } else if (finalPosition[1] > this.boundaries.secondaryP.v) { ++this.secondaryOrder.currentPosition; secondaryBoundaryCrossed( this.boundaries.secondaryP.i, this.initialPosition[1] < this.boundaries.secondaryP.v && this.initialPosition[1] < finalPosition[1]); } this.finalPosition = finalPosition; } } /** * A Graph Entity is an element that can stay directly (as a first child) on the blueprint grid. Those entities are either nodes or links */ class GraphEntity extends HTMLElement { /** * * @param {import("./template/Template").default} template The template to render this node */ constructor(template) { super(); /** @type {import("./UEBlueprint").EBlueprint}" */ this.blueprint = null; this.template = template; } connectedCallback() { this.blueprint = this.closest('u-blueprint'); this.append(...this.template.getElements(this)); } // Subclasses want to rewrite this render() { return '' } } class Template { /** * Computes the html content of the target element. * @param {HTMLElement} element Target element * @returns The computed html */ render(element) { return `` } /** * Returns the html elements rendered by this template. * @param {HTMLElement} element Target element * @returns The rendered elements */ getElements(element) { let aDiv = document.createElement('div'); aDiv.innerHTML = this.render(element); return aDiv.childNodes } } class BlueprintTemplate extends Template { header(element) { return `
` } overlay() { return ` ` } /** * * @param {import("../UEBlueprint").default} element * @returns */ viewport(element) { return ` ` } /** * Computes the html content of the target element. * @param {HTMLElement} element Target element * @returns The computed html */ render(element) { return ` ${this.header(element)} ${this.overlay(element)} ${this.viewport(element)} ` } } /** * @typedef {import("./UEBlueprintObject").default} UEBlueprintObject */ class UEBlueprint extends GraphEntity { insertChildren() { this.querySelector('[data-nodes]').append(...this.nodes); } constructor() { super(new BlueprintTemplate()); /** @type {UEBlueprintObject[]}" */ this.nodes = new Array(); this.expandGridSize = 400; /** @type {HTMLElement} */ this.gridElement = null; /** @type {HTMLElement} */ this.viewportElement = null; /** @type {HTMLElement} */ this.overlayElement = null; /** @type {HTMLElement} */ this.selectorElement = null; /** @type {HTMLElement} */ this.nodesContainerElement = null; this.dragObject = null; this.selectObject = null; /** @type {Array