@dwelle/excalidraw 0.5.0-da1c822 → 0.5.0-e56eec7

package/dist/excalidraw/element/binding.js

@@ -1,6 +1,12 @@
+import * as GA from "../ga";
+import * as GAPoint from "../gapoints";
+import * as GADirection from "../gadirections";
+import * as GALine from "../galines";
+import * as GATransform from "../gatransforms";
+import { getElementAbsoluteCoords } from "./bounds";
+import { isPointOnShape } from "../../utils/collision";
 import { getElementAtPosition } from "../scene";
-import { isBindableElement, isBindingElement, isLinearElement, } from "./typeChecks";
-import { bindingBorderTest, distanceToBindableElement, maxBindingGap, determineFocusDistance, intersectElementWithLine, determineFocusPoint, } from "./collision";
+import { isArrowElement, isBindableElement, isBindingElement, isBoundToContainer, isLinearElement, isTextElement, } from "./typeChecks";
 import { mutateElement } from "./mutateElement";
 import Scene from "../scene/Scene";
 import { LinearElementEditor } from "./linearElementEditor";
@@ -61,27 +67,27 @@ unboundFromElementIds, elementsMap) => {
         }
     }
 };
-export const bindOrUnbindSelectedElements = (selectedElements, elements, elementsMap) => {
+export const bindOrUnbindSelectedElements = (selectedElements, app) => {
     selectedElements.forEach((selectedElement) => {
         if (isBindingElement(selectedElement)) {
-            bindOrUnbindLinearElement(selectedElement, getElligibleElementForBindingElement(selectedElement, "start", elements, elementsMap), getElligibleElementForBindingElement(selectedElement, "end", elements, elementsMap), elementsMap);
+            bindOrUnbindLinearElement(selectedElement, getElligibleElementForBindingElement(selectedElement, "start", app), getElligibleElementForBindingElement(selectedElement, "end", app), app.scene.getNonDeletedElementsMap());
         }
         else if (isBindableElement(selectedElement)) {
-            maybeBindBindableElement(selectedElement, elementsMap);
+            maybeBindBindableElement(selectedElement, app.scene.getNonDeletedElementsMap(), app);
         }
     });
 };
-const maybeBindBindableElement = (bindableElement, elementsMap) => {
-    getElligibleElementsForBindableElementAndWhere(bindableElement, elementsMap).forEach(([linearElement, where]) => bindOrUnbindLinearElement(linearElement, where === "end" ? "keep" : bindableElement, where === "start" ? "keep" : bindableElement, elementsMap));
+const maybeBindBindableElement = (bindableElement, elementsMap, app) => {
+    getElligibleElementsForBindableElementAndWhere(bindableElement, app).forEach(([linearElement, where]) => bindOrUnbindLinearElement(linearElement, where === "end" ? "keep" : bindableElement, where === "start" ? "keep" : bindableElement, elementsMap));
 };
-export const maybeBindLinearElement = (linearElement, appState, scene, pointerCoords, elementsMap) => {
+export const maybeBindLinearElement = (linearElement, appState, pointerCoords, app) => {
     if (appState.startBoundElement != null) {
-        bindLinearElement(linearElement, appState.startBoundElement, "start", elementsMap);
+        bindLinearElement(linearElement, appState.startBoundElement, "start", app.scene.getNonDeletedElementsMap());
     }
-    const hoveredElement = getHoveredElementForBinding(pointerCoords, scene.getNonDeletedElements(), elementsMap);
+    const hoveredElement = getHoveredElementForBinding(pointerCoords, app);
     if (hoveredElement != null &&
         !isLinearElementSimpleAndAlreadyBoundOnOppositeEdge(linearElement, hoveredElement, "end")) {
-        bindLinearElement(linearElement, hoveredElement, "end", elementsMap);
+        bindLinearElement(linearElement, hoveredElement, "end", app.scene.getNonDeletedElementsMap());
     }
 };
 export const bindLinearElement = (linearElement, hoveredElement, startOrEnd, elementsMap) => {
@@ -112,7 +118,12 @@ export const isLinearElementSimpleAndAlreadyBound = (linearElement, alreadyBound
 export const unbindLinearElements = (elements, elementsMap) => {
     elements.forEach((element) => {
         if (isBindingElement(element)) {
-            bindOrUnbindLinearElement(element, null, null, elementsMap);
+            if (element.startBinding !== null && element.endBinding !== null) {
+                bindOrUnbindLinearElement(element, null, null, elementsMap);
+            }
+            else {
+                bindOrUnbindLinearElement(element, element.startBinding ? "keep" : null, element.endBinding ? "keep" : null, elementsMap);
+            }
         }
     });
 };
@@ -125,9 +136,9 @@ const unbindLinearElement = (linearElement, startOrEnd) => {
     mutateElement(linearElement, { [field]: null });
     return binding.elementId;
 };
-export const getHoveredElementForBinding = (pointerCoords, elements, elementsMap) => {
-    const hoveredElement = getElementAtPosition(elements, (element) => isBindableElement(element, false) &&
-        bindingBorderTest(element, pointerCoords, elementsMap));
+export const getHoveredElementForBinding = (pointerCoords, app) => {
+    const hoveredElement = getElementAtPosition(app.scene.getNonDeletedElements(), (element) => isBindableElement(element, false) &&
+        bindingBorderTest(element, pointerCoords, app));
     return hoveredElement;
 };
 const calculateFocusAndGap = (linearElement, hoveredElement, startOrEnd, elementsMap) => {
@@ -147,34 +158,38 @@ const calculateFocusAndGap = (linearElement, hoveredElement, startOrEnd, element
 // done before the `changedElement` is updated, and the `newSize` is passed
 // in explicitly.
 export const updateBoundElements = (changedElement, elementsMap, options) => {
-    const boundLinearElements = (changedElement.boundElements ?? []).filter((el) => el.type === "arrow");
-    if (boundLinearElements.length === 0) {
-        return;
-    }
     const { newSize, simultaneouslyUpdated } = options ?? {};
     const simultaneouslyUpdatedElementIds = getSimultaneouslyUpdatedElementIds(simultaneouslyUpdated);
-    const scene = Scene.getScene(changedElement);
-    getNonDeletedElements(scene, boundLinearElements.map((el) => el.id)).forEach((element) => {
-        if (!isLinearElement(element)) {
+    if (!isBindableElement(changedElement)) {
+        return;
+    }
+    boundElementsVisitor(elementsMap, changedElement, (element) => {
+        if (!isLinearElement(element) || element.isDeleted) {
             return;
         }
-        const bindableElement = changedElement;
         // In case the boundElements are stale
-        if (!doesNeedUpdate(element, bindableElement)) {
+        if (!doesNeedUpdate(element, changedElement)) {
             return;
         }
-        const startBinding = maybeCalculateNewGapWhenScaling(bindableElement, element.startBinding, newSize);
-        const endBinding = maybeCalculateNewGapWhenScaling(bindableElement, element.endBinding, newSize);
+        const bindings = {
+            startBinding: maybeCalculateNewGapWhenScaling(changedElement, element.startBinding, newSize),
+            endBinding: maybeCalculateNewGapWhenScaling(changedElement, element.endBinding, newSize),
+        };
         // `linearElement` is being moved/scaled already, just update the binding
         if (simultaneouslyUpdatedElementIds.has(element.id)) {
-            mutateElement(element, { startBinding, endBinding });
+            mutateElement(element, bindings);
             return;
         }
-        updateBoundPoint(element, "start", startBinding, changedElement, elementsMap);
-        updateBoundPoint(element, "end", endBinding, changedElement, elementsMap);
-        const boundText = getBoundTextElement(element, scene.getNonDeletedElementsMap());
-        if (boundText) {
-            handleBindTextResize(element, scene.getNonDeletedElementsMap(), false);
+        bindableElementsVisitor(elementsMap, element, (bindableElement, bindingProp) => {
+            if (bindableElement &&
+                isBindableElement(bindableElement) &&
+                (bindingProp === "startBinding" || bindingProp === "endBinding")) {
+                updateBoundPoint(element, bindingProp, bindings[bindingProp], bindableElement, elementsMap);
+            }
+        });
+        const boundText = getBoundTextElement(element, elementsMap);
+        if (boundText && !boundText.isDeleted) {
+            handleBindTextResize(element, elementsMap, false);
         }
     });
 };
@@ -185,22 +200,18 @@ const doesNeedUpdate = (boundElement, changedElement) => {
 const getSimultaneouslyUpdatedElementIds = (simultaneouslyUpdated) => {
     return new Set((simultaneouslyUpdated || []).map((element) => element.id));
 };
-const updateBoundPoint = (linearElement, startOrEnd, binding, changedElement, elementsMap) => {
+const updateBoundPoint = (linearElement, startOrEnd, binding, bindableElement, elementsMap) => {
     if (binding == null ||
         // We only need to update the other end if this is a 2 point line element
-        (binding.elementId !== changedElement.id && linearElement.points.length > 2)) {
-        return;
-    }
-    const bindingElement = Scene.getScene(linearElement).getElement(binding.elementId);
-    if (bindingElement == null) {
-        // We're not cleaning up after deleted elements atm., so handle this case
+        (binding.elementId !== bindableElement.id &&
+            linearElement.points.length > 2)) {
         return;
     }
-    const direction = startOrEnd === "start" ? -1 : 1;
+    const direction = startOrEnd === "startBinding" ? -1 : 1;
     const edgePointIndex = direction === -1 ? 0 : linearElement.points.length - 1;
     const adjacentPointIndex = edgePointIndex - direction;
     const adjacentPoint = LinearElementEditor.getPointAtIndexGlobalCoordinates(linearElement, adjacentPointIndex, elementsMap);
-    const focusPointAbsolute = determineFocusPoint(bindingElement, binding.focus, adjacentPoint, elementsMap);
+    const focusPointAbsolute = determineFocusPoint(bindableElement, binding.focus, adjacentPoint, elementsMap);
     let newEdgePoint;
     // The linear element was not originally pointing inside the bound shape,
     // we can point directly at the focus point
@@ -208,7 +219,7 @@ const updateBoundPoint = (linearElement, startOrEnd, binding, changedElement, el
         newEdgePoint = focusPointAbsolute;
     }
     else {
-        const intersections = intersectElementWithLine(bindingElement, adjacentPoint, focusPointAbsolute, binding.gap, elementsMap);
+        const intersections = intersectElementWithLine(bindableElement, adjacentPoint, focusPointAbsolute, binding.gap, elementsMap);
         if (intersections.length === 0) {
             // This should never happen, since focusPoint should always be
             // inside the element, but just in case, bail out
@@ -224,7 +235,7 @@ const updateBoundPoint = (linearElement, startOrEnd, binding, changedElement, el
             index: edgePointIndex,
             point: LinearElementEditor.pointFromAbsoluteCoords(linearElement, newEdgePoint, elementsMap),
         },
-    ], { [startOrEnd === "start" ? "startBinding" : "endBinding"]: binding });
+    ], { [startOrEnd]: binding });
 };
 const maybeCalculateNewGapWhenScaling = (changedElement, currentBinding, newSize) => {
     if (currentBinding == null || newSize == null) {
@@ -237,28 +248,28 @@ const maybeCalculateNewGapWhenScaling = (changedElement, currentBinding, newSize
     return { elementId, gap: newGap, focus };
 };
 // TODO: this is a bottleneck, optimise
-export const getEligibleElementsForBinding = (selectedElements, elements, elementsMap) => {
+export const getEligibleElementsForBinding = (selectedElements, app) => {
     const includedElementIds = new Set(selectedElements.map(({ id }) => id));
     return selectedElements.flatMap((selectedElement) => isBindingElement(selectedElement, false)
-        ? getElligibleElementsForBindingElement(selectedElement, elements, elementsMap).filter((element) => !includedElementIds.has(element.id))
+        ? getElligibleElementsForBindingElement(selectedElement, app).filter((element) => !includedElementIds.has(element.id))
         : isBindableElement(selectedElement, false)
-            ? getElligibleElementsForBindableElementAndWhere(selectedElement, elementsMap).filter((binding) => !includedElementIds.has(binding[0].id))
+            ? getElligibleElementsForBindableElementAndWhere(selectedElement, app).filter((binding) => !includedElementIds.has(binding[0].id))
             : []);
 };
-const getElligibleElementsForBindingElement = (linearElement, elements, elementsMap) => {
+const getElligibleElementsForBindingElement = (linearElement, app) => {
     return [
-        getElligibleElementForBindingElement(linearElement, "start", elements, elementsMap),
-        getElligibleElementForBindingElement(linearElement, "end", elements, elementsMap),
+        getElligibleElementForBindingElement(linearElement, "start", app),
+        getElligibleElementForBindingElement(linearElement, "end", app),
     ].filter((element) => element != null);
 };
-const getElligibleElementForBindingElement = (linearElement, startOrEnd, elements, elementsMap) => {
-    return getHoveredElementForBinding(getLinearElementEdgeCoors(linearElement, startOrEnd, elementsMap), elements, elementsMap);
+const getElligibleElementForBindingElement = (linearElement, startOrEnd, app) => {
+    return getHoveredElementForBinding(getLinearElementEdgeCoors(linearElement, startOrEnd, app.scene.getNonDeletedElementsMap()), app);
 };
 const getLinearElementEdgeCoors = (linearElement, startOrEnd, elementsMap) => {
     const index = startOrEnd === "start" ? 0 : -1;
     return tupleToCoors(LinearElementEditor.getPointAtIndexGlobalCoordinates(linearElement, index, elementsMap));
 };
-const getElligibleElementsForBindableElementAndWhere = (bindableElement, elementsMap) => {
+const getElligibleElementsForBindableElementAndWhere = (bindableElement, app) => {
     const scene = Scene.getScene(bindableElement);
     return scene
         .getNonDeletedElements()
@@ -266,8 +277,8 @@ const getElligibleElementsForBindableElementAndWhere = (bindableElement, element
         if (!isBindingElement(element, false)) {
             return null;
         }
-        const canBindStart = isLinearElementEligibleForNewBindingByBindable(element, "start", bindableElement, elementsMap);
-        const canBindEnd = isLinearElementEligibleForNewBindingByBindable(element, "end", bindableElement, elementsMap);
+        const canBindStart = isLinearElementEligibleForNewBindingByBindable(element, "start", bindableElement, scene.getNonDeletedElementsMap(), app);
+        const canBindEnd = isLinearElementEligibleForNewBindingByBindable(element, "end", bindableElement, scene.getNonDeletedElementsMap(), app);
         if (!canBindStart && !canBindEnd) {
             return null;
         }
@@ -279,11 +290,11 @@ const getElligibleElementsForBindableElementAndWhere = (bindableElement, element
     })
         .filter((maybeElement) => maybeElement != null);
 };
-const isLinearElementEligibleForNewBindingByBindable = (linearElement, startOrEnd, bindableElement, elementsMap) => {
+const isLinearElementEligibleForNewBindingByBindable = (linearElement, startOrEnd, bindableElement, elementsMap, app) => {
     const existingBinding = linearElement[startOrEnd === "start" ? "startBinding" : "endBinding"];
     return (existingBinding == null &&
         !isLinearElementSimpleAndAlreadyBoundOnOppositeEdge(linearElement, bindableElement, startOrEnd) &&
-        bindingBorderTest(bindableElement, getLinearElementEdgeCoors(linearElement, startOrEnd, elementsMap), elementsMap));
+        bindingBorderTest(bindableElement, getLinearElementEdgeCoors(linearElement, startOrEnd, elementsMap), app));
 };
 // We need to:
 // 1: Update elements not selected to point to duplicated elements
@@ -364,51 +375,578 @@ const newBindingAfterDuplication = (binding, oldIdToDuplicatedId) => {
     };
 };
 export const fixBindingsAfterDeletion = (sceneElements, deletedElements) => {
-    const deletedElementIds = new Set(deletedElements.map((element) => element.id));
-    // non-deleted which bindings need to be updated
-    const affectedElements = new Set();
-    deletedElements.forEach((deletedElement) => {
-        if (isBindableElement(deletedElement)) {
-            deletedElement.boundElements?.forEach((element) => {
-                if (!deletedElementIds.has(element.id)) {
-                    affectedElements.add(element.id);
-                }
-            });
-        }
-        else if (isBindingElement(deletedElement)) {
-            if (deletedElement.startBinding) {
-                affectedElements.add(deletedElement.startBinding.elementId);
-            }
-            if (deletedElement.endBinding) {
-                affectedElements.add(deletedElement.endBinding.elementId);
-            }
-        }
+    const elements = arrayToMap(sceneElements);
+    for (const element of deletedElements) {
+        BoundElement.unbindAffected(elements, element, mutateElement);
+        BindableElement.unbindAffected(elements, element, mutateElement);
+    }
+};
+const newBoundElements = (boundElements, idsToRemove, elementsToAdd = []) => {
+    if (!boundElements) {
+        return null;
+    }
+    const nextBoundElements = boundElements.filter((boundElement) => !idsToRemove.has(boundElement.id));
+    nextBoundElements.push(...elementsToAdd.map((x) => ({ id: x.id, type: x.type })));
+    return nextBoundElements;
+};
+export const bindingBorderTest = (element, { x, y }, app) => {
+    const threshold = maxBindingGap(element, element.width, element.height);
+    const shape = app.getElementShape(element);
+    return isPointOnShape([x, y], shape, threshold);
+};
+export const maxBindingGap = (element, elementWidth, elementHeight) => {
+    // Aligns diamonds with rectangles
+    const shapeRatio = element.type === "diamond" ? 1 / Math.sqrt(2) : 1;
+    const smallerDimension = shapeRatio * Math.min(elementWidth, elementHeight);
+    // We make the bindable boundary bigger for bigger elements
+    return Math.max(16, Math.min(0.25 * smallerDimension, 32));
+};
+export const distanceToBindableElement = (element, point, elementsMap) => {
+    switch (element.type) {
+        case "rectangle":
+        case "image":
+        case "text":
+        case "iframe":
+        case "embeddable":
+        case "frame":
+        case "magicframe":
+            return distanceToRectangle(element, point, elementsMap);
+        case "diamond":
+            return distanceToDiamond(element, point, elementsMap);
+        case "ellipse":
+            return distanceToEllipse(element, point, elementsMap);
+    }
+};
+const distanceToRectangle = (element, point, elementsMap) => {
+    const [, pointRel, hwidth, hheight] = pointRelativeToElement(element, point, elementsMap);
+    return Math.max(GAPoint.distanceToLine(pointRel, GALine.equation(0, 1, -hheight)), GAPoint.distanceToLine(pointRel, GALine.equation(1, 0, -hwidth)));
+};
+const distanceToDiamond = (element, point, elementsMap) => {
+    const [, pointRel, hwidth, hheight] = pointRelativeToElement(element, point, elementsMap);
+    const side = GALine.equation(hheight, hwidth, -hheight * hwidth);
+    return GAPoint.distanceToLine(pointRel, side);
+};
+export const distanceToEllipse = (element, point, elementsMap) => {
+    const [pointRel, tangent] = ellipseParamsForTest(element, point, elementsMap);
+    return -GALine.sign(tangent) * GAPoint.distanceToLine(pointRel, tangent);
+};
+const ellipseParamsForTest = (element, point, elementsMap) => {
+    const [, pointRel, hwidth, hheight] = pointRelativeToElement(element, point, elementsMap);
+    const [px, py] = GAPoint.toTuple(pointRel);
+    // We're working in positive quadrant, so start with `t = 45deg`, `tx=cos(t)`
+    let tx = 0.707;
+    let ty = 0.707;
+    const a = hwidth;
+    const b = hheight;
+    // This is a numerical method to find the params tx, ty at which
+    // the ellipse has the closest point to the given point
+    [0, 1, 2, 3].forEach((_) => {
+        const xx = a * tx;
+        const yy = b * ty;
+        const ex = ((a * a - b * b) * tx ** 3) / a;
+        const ey = ((b * b - a * a) * ty ** 3) / b;
+        const rx = xx - ex;
+        const ry = yy - ey;
+        const qx = px - ex;
+        const qy = py - ey;
+        const r = Math.hypot(ry, rx);
+        const q = Math.hypot(qy, qx);
+        tx = Math.min(1, Math.max(0, ((qx * r) / q + ex) / a));
+        ty = Math.min(1, Math.max(0, ((qy * r) / q + ey) / b));
+        const t = Math.hypot(ty, tx);
+        tx /= t;
+        ty /= t;
     });
-    sceneElements
-        .filter(({ id }) => affectedElements.has(id))
-        .forEach((element) => {
-        if (isBindableElement(element)) {
-            mutateElement(element, {
-                boundElements: newBoundElementsAfterDeletion(element.boundElements, deletedElementIds),
-            });
-        }
-        else if (isBindingElement(element)) {
-            mutateElement(element, {
-                startBinding: newBindingAfterDeletion(element.startBinding, deletedElementIds),
-                endBinding: newBindingAfterDeletion(element.endBinding, deletedElementIds),
-            });
+    const closestPoint = GA.point(a * tx, b * ty);
+    const tangent = GALine.orthogonalThrough(pointRel, closestPoint);
+    return [pointRel, tangent];
+};
+// Returns:
+//   1. the point relative to the elements (x, y) position
+//   2. the point relative to the element's center with positive (x, y)
+//   3. half element width
+//   4. half element height
+//
+// Note that for linear elements the (x, y) position is not at the
+// top right corner of their boundary.
+//
+// Rectangles, diamonds and ellipses are symmetrical over axes,
+// and other elements have a rectangular boundary,
+// so we only need to perform hit tests for the positive quadrant.
+const pointRelativeToElement = (element, pointTuple, elementsMap) => {
+    const point = GAPoint.from(pointTuple);
+    const [x1, y1, x2, y2] = getElementAbsoluteCoords(element, elementsMap);
+    const center = coordsCenter(x1, y1, x2, y2);
+    // GA has angle orientation opposite to `rotate`
+    const rotate = GATransform.rotation(center, element.angle);
+    const pointRotated = GATransform.apply(rotate, point);
+    const pointRelToCenter = GA.sub(pointRotated, GADirection.from(center));
+    const pointRelToCenterAbs = GAPoint.abs(pointRelToCenter);
+    const elementPos = GA.offset(element.x, element.y);
+    const pointRelToPos = GA.sub(pointRotated, elementPos);
+    const halfWidth = (x2 - x1) / 2;
+    const halfHeight = (y2 - y1) / 2;
+    return [pointRelToPos, pointRelToCenterAbs, halfWidth, halfHeight];
+};
+const relativizationToElementCenter = (element, elementsMap) => {
+    const [x1, y1, x2, y2] = getElementAbsoluteCoords(element, elementsMap);
+    const center = coordsCenter(x1, y1, x2, y2);
+    // GA has angle orientation opposite to `rotate`
+    const rotate = GATransform.rotation(center, element.angle);
+    const translate = GA.reverse(GATransform.translation(GADirection.from(center)));
+    return GATransform.compose(rotate, translate);
+};
+const coordsCenter = (x1, y1, x2, y2) => {
+    return GA.point((x1 + x2) / 2, (y1 + y2) / 2);
+};
+// The focus distance is the oriented ratio between the size of
+// the `element` and the "focus image" of the element on which
+// all focus points lie, so it's a number between -1 and 1.
+// The line going through `a` and `b` is a tangent to the "focus image"
+// of the element.
+export const determineFocusDistance = (element, 
+// Point on the line, in absolute coordinates
+a, 
+// Another point on the line, in absolute coordinates (closer to element)
+b, elementsMap) => {
+    const relateToCenter = relativizationToElementCenter(element, elementsMap);
+    const aRel = GATransform.apply(relateToCenter, GAPoint.from(a));
+    const bRel = GATransform.apply(relateToCenter, GAPoint.from(b));
+    const line = GALine.through(aRel, bRel);
+    const q = element.height / element.width;
+    const hwidth = element.width / 2;
+    const hheight = element.height / 2;
+    const n = line[2];
+    const m = line[3];
+    const c = line[1];
+    const mabs = Math.abs(m);
+    const nabs = Math.abs(n);
+    let ret;
+    switch (element.type) {
+        case "rectangle":
+        case "image":
+        case "text":
+        case "iframe":
+        case "embeddable":
+        case "frame":
+        case "magicframe":
+            ret = c / (hwidth * (nabs + q * mabs));
+            break;
+        case "diamond":
+            ret = mabs < nabs ? c / (nabs * hwidth) : c / (mabs * hheight);
+            break;
+        case "ellipse":
+            ret = c / (hwidth * Math.sqrt(n ** 2 + q ** 2 * m ** 2));
+            break;
+    }
+    return ret || 0;
+};
+export const determineFocusPoint = (element, 
+// The oriented, relative distance from the center of `element` of the
+// returned focusPoint
+focus, adjecentPoint, elementsMap) => {
+    if (focus === 0) {
+        const [x1, y1, x2, y2] = getElementAbsoluteCoords(element, elementsMap);
+        const center = coordsCenter(x1, y1, x2, y2);
+        return GAPoint.toTuple(center);
+    }
+    const relateToCenter = relativizationToElementCenter(element, elementsMap);
+    const adjecentPointRel = GATransform.apply(relateToCenter, GAPoint.from(adjecentPoint));
+    const reverseRelateToCenter = GA.reverse(relateToCenter);
+    let point;
+    switch (element.type) {
+        case "rectangle":
+        case "image":
+        case "text":
+        case "diamond":
+        case "iframe":
+        case "embeddable":
+        case "frame":
+        case "magicframe":
+            point = findFocusPointForRectangulars(element, focus, adjecentPointRel);
+            break;
+        case "ellipse":
+            point = findFocusPointForEllipse(element, focus, adjecentPointRel);
+            break;
+    }
+    return GAPoint.toTuple(GATransform.apply(reverseRelateToCenter, point));
+};
+// Returns 2 or 0 intersection points between line going through `a` and `b`
+// and the `element`, in ascending order of distance from `a`.
+export const intersectElementWithLine = (element, 
+// Point on the line, in absolute coordinates
+a, 
+// Another point on the line, in absolute coordinates
+b, 
+// If given, the element is inflated by this value
+gap = 0, elementsMap) => {
+    const relateToCenter = relativizationToElementCenter(element, elementsMap);
+    const aRel = GATransform.apply(relateToCenter, GAPoint.from(a));
+    const bRel = GATransform.apply(relateToCenter, GAPoint.from(b));
+    const line = GALine.through(aRel, bRel);
+    const reverseRelateToCenter = GA.reverse(relateToCenter);
+    const intersections = getSortedElementLineIntersections(element, line, aRel, gap);
+    return intersections.map((point) => GAPoint.toTuple(GATransform.apply(reverseRelateToCenter, point)));
+};
+const getSortedElementLineIntersections = (element, 
+// Relative to element center
+line, 
+// Relative to element center
+nearPoint, gap = 0) => {
+    let intersections;
+    switch (element.type) {
+        case "rectangle":
+        case "image":
+        case "text":
+        case "diamond":
+        case "iframe":
+        case "embeddable":
+        case "frame":
+        case "magicframe":
+            const corners = getCorners(element);
+            intersections = corners
+                .flatMap((point, i) => {
+                const edge = [point, corners[(i + 1) % 4]];
+                return intersectSegment(line, offsetSegment(edge, gap));
+            })
+                .concat(corners.flatMap((point) => getCircleIntersections(point, gap, line)));
+            break;
+        case "ellipse":
+            intersections = getEllipseIntersections(element, gap, line);
+            break;
+    }
+    if (intersections.length < 2) {
+        // Ignore the "edge" case of only intersecting with a single corner
+        return [];
+    }
+    const sortedIntersections = intersections.sort((i1, i2) => GAPoint.distance(i1, nearPoint) - GAPoint.distance(i2, nearPoint));
+    return [
+        sortedIntersections[0],
+        sortedIntersections[sortedIntersections.length - 1],
+    ];
+};
+const getCorners = (element, scale = 1) => {
+    const hx = (scale * element.width) / 2;
+    const hy = (scale * element.height) / 2;
+    switch (element.type) {
+        case "rectangle":
+        case "image":
+        case "text":
+        case "iframe":
+        case "embeddable":
+        case "frame":
+        case "magicframe":
+            return [
+                GA.point(hx, hy),
+                GA.point(hx, -hy),
+                GA.point(-hx, -hy),
+                GA.point(-hx, hy),
+            ];
+        case "diamond":
+            return [
+                GA.point(0, hy),
+                GA.point(hx, 0),
+                GA.point(0, -hy),
+                GA.point(-hx, 0),
+            ];
+    }
+};
+// Returns intersection of `line` with `segment`, with `segment` moved by
+// `gap` in its polar direction.
+// If intersection coincides with second segment point returns empty array.
+const intersectSegment = (line, segment) => {
+    const [a, b] = segment;
+    const aDist = GAPoint.distanceToLine(a, line);
+    const bDist = GAPoint.distanceToLine(b, line);
+    if (aDist * bDist >= 0) {
+        // The intersection is outside segment `(a, b)`
+        return [];
+    }
+    return [GAPoint.intersect(line, GALine.through(a, b))];
+};
+const offsetSegment = (segment, distance) => {
+    const [a, b] = segment;
+    const offset = GATransform.translationOrthogonal(GADirection.fromTo(a, b), distance);
+    return [GATransform.apply(offset, a), GATransform.apply(offset, b)];
+};
+const getEllipseIntersections = (element, gap, line) => {
+    const a = element.width / 2 + gap;
+    const b = element.height / 2 + gap;
+    const m = line[2];
+    const n = line[3];
+    const c = line[1];
+    const squares = a * a * m * m + b * b * n * n;
+    const discr = squares - c * c;
+    if (squares === 0 || discr <= 0) {
+        return [];
+    }
+    const discrRoot = Math.sqrt(discr);
+    const xn = -a * a * m * c;
+    const yn = -b * b * n * c;
+    return [
+        GA.point((xn + a * b * n * discrRoot) / squares, (yn - a * b * m * discrRoot) / squares),
+        GA.point((xn - a * b * n * discrRoot) / squares, (yn + a * b * m * discrRoot) / squares),
+    ];
+};
+export const getCircleIntersections = (center, radius, line) => {
+    if (radius === 0) {
+        return GAPoint.distanceToLine(line, center) === 0 ? [center] : [];
+    }
+    const m = line[2];
+    const n = line[3];
+    const c = line[1];
+    const [a, b] = GAPoint.toTuple(center);
+    const r = radius;
+    const squares = m * m + n * n;
+    const discr = r * r * squares - (m * a + n * b + c) ** 2;
+    if (squares === 0 || discr <= 0) {
+        return [];
+    }
+    const discrRoot = Math.sqrt(discr);
+    const xn = a * n * n - b * m * n - m * c;
+    const yn = b * m * m - a * m * n - n * c;
+    return [
+        GA.point((xn + n * discrRoot) / squares, (yn - m * discrRoot) / squares),
+        GA.point((xn - n * discrRoot) / squares, (yn + m * discrRoot) / squares),
+    ];
+};
+// The focus point is the tangent point of the "focus image" of the
+// `element`, where the tangent goes through `point`.
+export const findFocusPointForEllipse = (ellipse, 
+// Between -1 and 1 (not 0) the relative size of the "focus image" of
+// the element on which the focus point lies
+relativeDistance, 
+// The point for which we're trying to find the focus point, relative
+// to the ellipse center.
+point) => {
+    const relativeDistanceAbs = Math.abs(relativeDistance);
+    const a = (ellipse.width * relativeDistanceAbs) / 2;
+    const b = (ellipse.height * relativeDistanceAbs) / 2;
+    const orientation = Math.sign(relativeDistance);
+    const [px, pyo] = GAPoint.toTuple(point);
+    // The calculation below can't handle py = 0
+    const py = pyo === 0 ? 0.0001 : pyo;
+    const squares = px ** 2 * b ** 2 + py ** 2 * a ** 2;
+    // Tangent mx + ny + 1 = 0
+    const m = (-px * b ** 2 +
+        orientation * py * Math.sqrt(Math.max(0, squares - a ** 2 * b ** 2))) /
+        squares;
+    let n = (-m * px - 1) / py;
+    if (n === 0) {
+        // if zero {-0, 0}, fall back to a same-sign value in the similar range
+        n = (Object.is(n, -0) ? -1 : 1) * 0.01;
+    }
+    const x = -(a ** 2 * m) / (n ** 2 * b ** 2 + m ** 2 * a ** 2);
+    return GA.point(x, (-m * x - 1) / n);
+};
+export const findFocusPointForRectangulars = (element, 
+// Between -1 and 1 for how far away should the focus point be relative
+// to the size of the element. Sign determines orientation.
+relativeDistance, 
+// The point for which we're trying to find the focus point, relative
+// to the element center.
+point) => {
+    const relativeDistanceAbs = Math.abs(relativeDistance);
+    const orientation = Math.sign(relativeDistance);
+    const corners = getCorners(element, relativeDistanceAbs);
+    let maxDistance = 0;
+    let tangentPoint = null;
+    corners.forEach((corner) => {
+        const distance = orientation * GALine.through(point, corner)[1];
+        if (distance > maxDistance) {
+            maxDistance = distance;
+            tangentPoint = corner;
         }
     });
+    return tangentPoint;
 };
-const newBindingAfterDeletion = (binding, deletedElementIds) => {
-    if (binding == null || deletedElementIds.has(binding.elementId)) {
-        return null;
+export const bindingProperties = new Set([
+    "boundElements",
+    "frameId",
+    "containerId",
+    "startBinding",
+    "endBinding",
+]);
+/**
+ * Tries to visit each bound element (does not have to be found).
+ */
+const boundElementsVisitor = (elements, element, visit) => {
+    if (isBindableElement(element)) {
+        // create new instance so that possible mutations won't play a role in visiting order
+        const boundElements = element.boundElements?.slice() ?? [];
+        // last added text should be the one we keep (~previous are duplicates)
+        boundElements.forEach(({ id }) => {
+            visit(elements.get(id), "boundElements", id);
+        });
     }
-    return binding;
 };
-const newBoundElementsAfterDeletion = (boundElements, deletedElementIds) => {
-    if (!boundElements) {
-        return null;
+/**
+ * Tries to visit each bindable element (does not have to be found).
+ */
+const bindableElementsVisitor = (elements, element, visit) => {
+    if (element.frameId) {
+        const id = element.frameId;
+        visit(elements.get(id), "frameId", id);
+    }
+    if (isBoundToContainer(element)) {
+        const id = element.containerId;
+        visit(elements.get(id), "containerId", id);
+    }
+    if (isArrowElement(element)) {
+        if (element.startBinding) {
+            const id = element.startBinding.elementId;
+            visit(elements.get(id), "startBinding", id);
+        }
+        if (element.endBinding) {
+            const id = element.endBinding.elementId;
+            visit(elements.get(id), "endBinding", id);
+        }
     }
-    return boundElements.filter((ele) => !deletedElementIds.has(ele.id));
 };
+/**
+ * Bound element containing bindings to `frameId`, `containerId`, `startBinding` or `endBinding`.
+ */
+export class BoundElement {
+    /**
+     * Unbind the affected non deleted bindable elements (removing element from `boundElements`).
+     * - iterates non deleted bindable elements (`containerId` | `startBinding.elementId` | `endBinding.elementId`) of the current element
+     * - prepares updates to unbind each bindable element's `boundElements` from the current element
+     */
+    static unbindAffected(elements, boundElement, updateElementWith) {
+        if (!boundElement) {
+            return;
+        }
+        bindableElementsVisitor(elements, boundElement, (bindableElement) => {
+            // bindable element is deleted, this is fine
+            if (!bindableElement || bindableElement.isDeleted) {
+                return;
+            }
+            boundElementsVisitor(elements, bindableElement, (_, __, boundElementId) => {
+                if (boundElementId === boundElement.id) {
+                    updateElementWith(bindableElement, {
+                        boundElements: newBoundElements(bindableElement.boundElements, new Set([boundElementId])),
+                    });
+                }
+            });
+        });
+    }
+    /**
+     * Rebind the next affected non deleted bindable elements (adding element to `boundElements`).
+     * - iterates non deleted bindable elements (`containerId` | `startBinding.elementId` | `endBinding.elementId`) of the current element
+     * - prepares updates to rebind each bindable element's `boundElements` to the current element
+     *
+     * NOTE: rebind expects that affected elements were previously unbound with `BoundElement.unbindAffected`
+     */
+    static rebindAffected = (elements, boundElement, updateElementWith) => {
+        // don't try to rebind element that is deleted
+        if (!boundElement || boundElement.isDeleted) {
+            return;
+        }
+        bindableElementsVisitor(elements, boundElement, (bindableElement, bindingProp) => {
+            // unbind from bindable elements, as bindings from non deleted elements into deleted elements are incorrect
+            if (!bindableElement || bindableElement.isDeleted) {
+                updateElementWith(boundElement, { [bindingProp]: null });
+                return;
+            }
+            // frame bindings are unidirectional, there is nothing to rebind
+            if (bindingProp === "frameId") {
+                return;
+            }
+            if (bindableElement.boundElements?.find((x) => x.id === boundElement.id)) {
+                return;
+            }
+            if (isArrowElement(boundElement)) {
+                // rebind if not found!
+                updateElementWith(bindableElement, {
+                    boundElements: newBoundElements(bindableElement.boundElements, new Set(), new Array(boundElement)),
+                });
+            }
+            if (isTextElement(boundElement)) {
+                if (!bindableElement.boundElements?.find((x) => x.type === "text")) {
+                    // rebind only if there is no other text bound already
+                    updateElementWith(bindableElement, {
+                        boundElements: newBoundElements(bindableElement.boundElements, new Set(), new Array(boundElement)),
+                    });
+                }
+                else {
+                    // unbind otherwise
+                    updateElementWith(boundElement, { [bindingProp]: null });
+                }
+            }
+        });
+    };
+}
+/**
+ * Bindable element containing bindings to `boundElements`.
+ */
+export class BindableElement {
+    /**
+     * Unbind the affected non deleted bound elements (resetting `containerId`, `startBinding`, `endBinding` to `null`).
+     * - iterates through non deleted `boundElements` of the current element
+     * - prepares updates to unbind each bound element from the current element
+     */
+    static unbindAffected(elements, bindableElement, updateElementWith) {
+        if (!bindableElement) {
+            return;
+        }
+        boundElementsVisitor(elements, bindableElement, (boundElement) => {
+            // bound element is deleted, this is fine
+            if (!boundElement || boundElement.isDeleted) {
+                return;
+            }
+            bindableElementsVisitor(elements, boundElement, (_, bindingProp, bindableElementId) => {
+                // making sure there is an element to be unbound
+                if (bindableElementId === bindableElement.id) {
+                    updateElementWith(boundElement, { [bindingProp]: null });
+                }
+            });
+        });
+    }
+    /**
+     * Rebind the affected non deleted bound elements (for now setting only `containerId`, as we cannot rebind arrows atm).
+     * - iterates through non deleted `boundElements` of the current element
+     * - prepares updates to rebind each bound element to the current element or unbind it from `boundElements` in case of conflicts
+     *
+     * NOTE: rebind expects that affected elements were previously unbound with `BindaleElement.unbindAffected`
+     */
+    static rebindAffected = (elements, bindableElement, updateElementWith) => {
+        // don't try to rebind element that is deleted (i.e. updated as deleted)
+        if (!bindableElement || bindableElement.isDeleted) {
+            return;
+        }
+        boundElementsVisitor(elements, bindableElement, (boundElement, _, boundElementId) => {
+            // unbind from bindable elements, as bindings from non deleted elements into deleted elements are incorrect
+            if (!boundElement || boundElement.isDeleted) {
+                updateElementWith(bindableElement, {
+                    boundElements: newBoundElements(bindableElement.boundElements, new Set([boundElementId])),
+                });
+                return;
+            }
+            if (isTextElement(boundElement)) {
+                const boundElements = bindableElement.boundElements?.slice() ?? [];
+                // check if this is the last element in the array, if not, there is an previously bound text which should be unbound
+                if (boundElements.reverse().find((x) => x.type === "text")?.id ===
+                    boundElement.id) {
+                    if (boundElement.containerId !== bindableElement.id) {
+                        // rebind if not bound already!
+                        updateElementWith(boundElement, {
+                            containerId: bindableElement.id,
+                        });
+                    }
+                }
+                else {
+                    if (boundElement.containerId !== null) {
+                        // unbind if not unbound already
+                        updateElementWith(boundElement, {
+                            containerId: null,
+                        });
+                    }
+                    // unbind from boundElements as the element got bound to some other element in the meantime
+                    updateElementWith(bindableElement, {
+                        boundElements: newBoundElements(bindableElement.boundElements, new Set([boundElement.id])),
+                    });
+                }
+            }
+        });
+    };
+}