plotboilerplate 1.28.0 → 1.29.0

package/src/_esm/src/ts/Line.js

@@ -1,196 +0,0 @@
-/**
- * @author   Ikaros Kappler
- * @date     2016-03-12
- * @modified 2018-12-05 Refactored the code from the morley-triangle script.
- * @modified 2019-03-20 Added JSDoc tags.
- * @modified 2019-04-28 Fixed a bug in the Line.sub( Vertex ) function (was not working).
- * @modified 2019-09-02 Added the Line.add( Vertex ) function.
- * @modified 2019-09-02 Added the Line.denominator( Line ) function.
- * @modified 2019-09-02 Added the Line.colinear( Line ) function.
- * @modified 2019-09-02 Fixed an error in the Line.intersection( Line ) function (class Point was renamed to Vertex).
- * @modified 2019-12-15 Added the Line.moveTo(Vertex) function.
- * @modified 2020-03-16 The Line.angle(Line) parameter is now optional. The baseline (x-axis) will be used if not defined.
- * @modified 2020-03-23 Ported to Typescript from JS.
- * @modified 2020-12-04 The `intersection` function returns undefined if both lines are parallel.
- * @modified 2022-02-02 Added the `destroy` method.
- * @modified 2022-10-09 Changed the actual return value of the `intersection` function to null (was undefined before).
- * @modified 2022-10-17 Adding these methods from the `PathSegment` interface: getStartPoint, getEndPoint, revert.
- * @modified 2023-09-25 Changed param type of `intersection()` from Line to VertTuple.
- * @modified 2025-04-15 Class `Line` now implements interface `Intersectable`.
- * @modified 2025-04-16 Class `Line` now implements interface `IBounded`.
- * @version  2.4.0
- *
- * @file Line
- * @public
- **/
-import { Bounds } from "./Bounds";
-import { Vector } from "./Vector";
-import { VertTuple } from "./VertTuple";
-import { Vertex } from "./Vertex";
-/**
- * @classdesc A line consists of two vertices a and b.<br>
- * <br>
- * This is some refactored code from my 'Morley Triangle' test<br>
- *   https://github.com/IkarosKappler/morleys-trisector-theorem
- *
- * @requires Vertex
- */
-export class Line extends VertTuple {
-    /**
-     * Creates an instance of Line.
-     *
-     * @constructor
-     * @name Line
-     * @param {Vertex} a The line's first point.
-     * @param {Vertex} b The line's second point.
-     **/
-    constructor(a, b) {
-        super(a, b, (a, b) => new Line(a, b));
-        /**
-         * Required to generate proper CSS classes and other class related IDs.
-         **/
-        this.className = "Line";
-    }
-    /**
-     * Get the intersection if this line and the specified line.
-     *
-     * @method intersection
-     * @param {Line} line The second line.
-     * @return {Vertex|undefined} The intersection (may lie outside the end-points) or `undefined` if both lines are parallel.
-     * @instance
-     * @memberof Line
-     **/
-    // !!! DO NOT MOVE TO VertTuple
-    intersection(line) {
-        const denominator = this.denominator(line);
-        if (denominator == 0) {
-            return null;
-        }
-        let a = this.a.y - line.a.y;
-        let b = this.a.x - line.a.x;
-        const numerator1 = (line.b.x - line.a.x) * a - (line.b.y - line.a.y) * b;
-        const numerator2 = (this.b.x - this.a.x) * a - (this.b.y - this.a.y) * b;
-        a = numerator1 / denominator; // NaN if parallel lines
-        b = numerator2 / denominator;
-        // Catch NaN?
-        const x = this.a.x + a * (this.b.x - this.a.x);
-        const y = this.a.y + a * (this.b.y - this.a.y);
-        if (isNaN(a) || isNaN(x) || isNaN(y)) {
-            return null;
-        }
-        // if we cast these lines infinitely in both directions, they intersect here:
-        return new Vertex(x, y);
-    }
-    //--- BEGIN --- Implement interface `IBounded`
-    /**
-     * Get the bounding box (bounds) of this Line.
-     *
-     * @method getBounds
-     * @instance
-     * @memberof Line
-     * @return {Bounds} The rectangular bounds of this Line.
-     **/
-    getBounds() {
-        return Bounds.computeFromVertices([this.a, this.b]);
-    }
-    //--- END --- Implement interface `IBounded`
-    //--- Implement PathSegment ---
-    /**
-     * Get the start point of this path segment.
-     *
-     * @method getStartPoint
-     * @memberof PathSegment
-     * @return {Vertex} The start point of this path segment.
-     */
-    getStartPoint() {
-        return this.a;
-    }
-    /**
-     * Get the end point of this path segment.
-     *
-     * @method getEndPoint
-     * @memberof PathSegment
-     * @return {Vertex} The end point of this path segment.
-     */
-    getEndPoint() {
-        return this.b;
-    }
-    /**
-     * Get the tangent's end point at the start point of this segment.
-     *
-     * @method getStartTangent
-     * @memberof PathSegment
-     * @return {Vertex} The end point of the starting point's tangent.
-     */
-    getStartTangent() {
-        return this.b;
-    }
-    /**
-     * Get the tangent's end point at the end point of this segment.
-     *
-     * @method getEndTangent
-     * @memberof PathSegment
-     * @return {Vertex} The end point of the ending point's tangent.
-     */
-    getEndTangent() {
-        return this.a;
-    }
-    /**
-     * Inverse this path segment (in-place) and return this same instance (useful for chaining).
-     *
-     * @method reverse
-     * @memberof PathSegment
-     * @return {PathSegment} This path segment instance (for chaining).
-     */
-    reverse() {
-        var tmp = this.a;
-        this.a = this.b;
-        this.b = tmp;
-        return this;
-    }
-    //--- END Implement PathSegment ---
-    //--- BEGIN --- Implement interface `Intersectable`
-    /**
-     * Get all line intersections with this polygon.
-     *
-     * This method returns all intersections (as vertices) with this shape. The returned array of vertices is in no specific order.
-     *
-     * See demo `47-closest-vector-projection-on-polygon` for how it works.
-     *
-     * @param {VertTuple} line - The line to find intersections with.
-     * @param {boolean} inVectorBoundsOnly - If set to true only intersecion points on the passed vector are returned (located strictly between start and end vertex).
-     * @returns {Array<Vertex>} - An array of all intersections within the polygon bounds.
-     */
-    lineIntersections(line, inVectorBoundsOnly = false) {
-        // Find the intersections of all lines inside the edge bounds
-        const intersection = this.intersection(line);
-        if (!intersection) {
-            return []; // Both lines parallel
-        }
-        if (this.hasPoint(intersection, true) && (!inVectorBoundsOnly || line.hasPoint(intersection, inVectorBoundsOnly))) {
-            return [intersection];
-        }
-        else {
-            return [];
-        }
-    }
-    /**
-     * Get all line intersections of this polygon and their tangents along the shape.
-     *
-     * This method returns all intersection tangents (as vectors) with this shape. The returned array of vectors is in no specific order.
-     *
-     * @param line
-     * @param inVectorBoundsOnly
-     * @returns
-     */
-    lineIntersectionTangents(line, inVectorBoundsOnly = false) {
-        // Find the intersection tangents of all lines inside the edge bounds
-        const intersections = this.lineIntersections(line, inVectorBoundsOnly);
-        if (intersections.length === 0) {
-            return [];
-        }
-        const intrsctn = intersections[0];
-        return [new Vector(this.a.clone(), this.b.clone()).moveTo(intrsctn)];
-    }
-}
-//# sourceMappingURL=Line.js.map

package/src/_esm/src/ts/Line.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Line.js","sourceRoot":"","sources":["../../../ts/Line.ts"],"names":[],"mappings":"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"}

package/src/_esm/src/ts/MouseHandler.d.ts

@@ -1,283 +0,0 @@
-/**
- * @author   Ikaros Kappler
- * @date     2018-03-19
- * @modified 2018-04-28 Added the param 'wasDragged'.
- * @modified 2018-08-16 Added the param 'dragAmount'.
- * @modified 2018-08-27 Added the param 'element'.
- * @modified 2018-11-11 Changed the scope from a simple global var to a member of window/_context.
- * @modified 2018-11-19 Renamed the 'mousedown' function to 'down' and the 'mouseup' function to 'up'.
- * @modified 2018-11-28 Added the 'wheel' listener.
- * @modified 2018-12-09 Cleaned up some code.
- * @modified 2019-02-10 Cleaned up some more code.
- * @modified 2020-03-25 Ported this class from vanilla-JS to Typescript.
- * @modified 2020-04-08 Fixed the click event (internally fired a 'mouseup' event) (1.0.10)
- * @modified 2020-04-08 Added the optional 'name' property. (1.0.11)
- * @modified 2020-04-08 The new version always installs internal listenrs to track drag events even
- *                      if there is no external drag listener installed (1.1.0).
- * @modified 2020-10-04 Added extended JSDoc comments.
- * @modified 2020-11-25 Added the `isTouchEvent` param.
- * @modified 2021-01-10 The mouse handler is now also working with SVGElements.
- * @modified 2022-08-16 Fixed a bug in the mouse button detection.
- * @version  1.2.1
- *
- * @file MouseHandler
- * @public
- **/
-export interface XMouseParams {
-    button: number;
-    element: HTMLElement | SVGElement;
-    isTouchEvent: boolean;
-    name: string;
-    pos: {
-        x: number;
-        y: number;
-    };
-    leftButton: boolean;
-    middleButton: boolean;
-    rightButton: boolean;
-    mouseDownPos: {
-        x: number;
-        y: number;
-    };
-    draggedFrom: {
-        x: number;
-        y: number;
-    };
-    wasDragged: boolean;
-    dragAmount: {
-        x: number;
-        y: number;
-    };
-}
-export declare class XMouseEvent extends MouseEvent {
-    params: XMouseParams;
-}
-export declare class XWheelEvent extends WheelEvent {
-    params: XMouseParams;
-}
-export type XMouseCallback = (e: XMouseEvent) => void;
-export type XWheelCallback = (e: XWheelEvent) => void;
-/**
- * @classdesc A simple mouse handler for demos.
- * Use to avoid load massive libraries like jQuery.
- *
- * @requires XYCoords
- */
-export declare class MouseHandler {
-    private name;
-    private element;
-    private mouseDownPos;
-    private mouseDragPos;
-    private mouseButton;
-    private listeners;
-    private installed;
-    private handlers;
-    /**
-     * The constructor.
-     *
-     * Pass the DOM element you want to receive mouse events from.
-     *
-     * Usage
-     * =====
-     * @example
-     *   // Javascript
-     *   new MouseHandler( document.getElementById('mycanvas') )
-     *	    .drag( function(e) {
-     *		console.log( 'Mouse dragged: ' + JSON.stringify(e) );
-     *		if( e.params.leftMouse ) ;
-     *		else if( e.params.rightMouse ) ;
-     *	    } )
-     *	    .move( function(e) {
-     *		console.log( 'Mouse moved: ' + JSON.stringify(e.params) );
-     *	    } )
-     *          .up( function(e) {
-     *              console.log( 'Mouse up. Was dragged?', e.params.wasDragged );
-     *          } )
-     *          .down( function(e) {
-     *              console.log( 'Mouse down.' );
-     *          } )
-     *          .click( function(e) {
-     *              console.log( 'Click.' );
-     *          } )
-     *          .wheel( function(e) {
-     *              console.log( 'Wheel. delta='+e.deltaY );
-     *          } )
-     *
-     * @example
-     *   // Typescript
-     *   new MouseHandler( document.getElementById('mycanvas') )
-     *	    .drag( (e:XMouseEvent) => {
-     *		console.log( 'Mouse dragged: ' + JSON.stringify(e) );
-     *		if( e.params.leftMouse ) ;
-     *		else if( e.params.rightMouse ) ;
-     *	    } )
-     *	    .move( (e:XMouseEvent) => {
-     *		console.log( 'Mouse moved: ' + JSON.stringify(e.params) );
-     *	    } )
-     *          .up( (e:XMouseEvent) => {
-     *              console.log( 'Mouse up. Was dragged?', e.params.wasDragged );
-     *          } )
-     *          .down( (e:XMouseEvent) => {
-     *              console.log( 'Mouse down.' );
-     *          } )
-     *          .click( (e:XMouseEvent) => {
-     *              console.log( 'Click.' );
-     *          } )
-     *          .wheel( (e:XWheelEvent) => {
-     *              console.log( 'Wheel. delta='+e.deltaY );
-     *          } )
-     *
-     * @constructor
-     * @instance
-     * @memberof MouseHandler
-     * @param {HTMLElement} element
-     **/
-    constructor(element: HTMLElement | SVGElement, name?: string);
-    /**
-     * Get relative position from the given MouseEvent.
-     *
-     * @name relPos
-     * @memberof MouseHandler
-     * @instance
-     * @private
-     * @param {MouseEvent} e - The mouse event to get the relative position for.
-     * @return {XYCoords} The relative mouse coordinates.
-     */
-    private relPos;
-    /**
-     * Build the extended event params.
-     *
-     * @name mkParams
-     * @memberof MouseHandler
-     * @instance
-     * @private
-     * @param {MouseEvent} event - The mouse event to get the relative position for.
-     * @param {string} eventName - The name of the firing event.
-     * @return {XMouseEvent}
-     */
-    private mkParams;
-    /**
-     * Install a new listener.
-     * Please note that this mouse handler can only handle one listener per event type.
-     *
-     * @name listenFor
-     * @memberof MouseHandler
-     * @instance
-     * @private
-     * @param {string} eventName - The name of the firing event to listen for.
-     * @return {void}
-     */
-    private listenFor;
-    /**
-     * Un-install a new listener.
-     *
-     * @name listenFor
-     * @memberof MouseHandler
-     * @instance
-     * @private
-     * @param {string} eventName - The name of the firing event to unlisten for.
-     * @return {void}
-     */
-    private unlistenFor;
-    /**
-     * Installer function to listen for a specific event: mouse-drag.
-     * Pass your callbacks here.
-     *
-     * Note: this support chaining.
-     *
-     * @name drag
-     * @memberof MouseHandler
-     * @instance
-     * @param {XMouseCallback} callback - The drag-callback to listen for.
-     * @return {MouseHandler} this
-     */
-    drag(callback: XMouseCallback): MouseHandler;
-    /**
-     * Installer function to listen for a specific event: mouse-move.
-     * Pass your callbacks here.
-     *
-     * Note: this support chaining.
-     *
-     * @name move
-     * @memberof MouseHandler
-     * @instance
-     * @param {XMouseCallback} callback - The move-callback to listen for.
-     * @return {MouseHandler} this
-     */
-    move(callback: (e: XMouseEvent) => void): MouseHandler;
-    /**
-     * Installer function to listen for a specific event: mouse-up.
-     * Pass your callbacks here.
-     *
-     * Note: this support chaining.
-     *
-     * @name up
-     * @memberof MouseHandler
-     * @instance
-     * @param {XMouseCallback} callback - The up-callback to listen for.
-     * @return {MouseHandler} this
-     */
-    up(callback: (e: XMouseEvent) => void): MouseHandler;
-    /**
-     * Installer function to listen for a specific event: mouse-down.
-     * Pass your callbacks here.
-     *
-     * Note: this support chaining.
-     *
-     * @name down
-     * @memberof MouseHandler
-     * @instance
-     * @param {XMouseCallback} callback - The down-callback to listen for.
-     * @return {MouseHandler} this
-     */
-    down(callback: (e: XMouseEvent) => void): MouseHandler;
-    /**
-     * Installer function to listen for a specific event: mouse-click.
-     * Pass your callbacks here.
-     *
-     * Note: this support chaining.
-     *
-     * @name click
-     * @memberof MouseHandler
-     * @instance
-     * @param {XMouseCallback} callback - The click-callback to listen for.
-     * @return {MouseHandler} this
-     */
-    click(callback: (e: XMouseEvent) => void): MouseHandler;
-    /**
-     * Installer function to listen for a specific event: mouse-wheel.
-     * Pass your callbacks here.
-     *
-     * Note: this support chaining.
-     *
-     * @name wheel
-     * @memberof MouseHandler
-     * @instance
-     * @param {XWheelCallback} callback - The wheel-callback to listen for.
-     * @return {MouseHandler} this
-     */
-    wheel(callback: (e: XWheelEvent) => void): MouseHandler;
-    /**
-     * An internal function to throw events.
-     *
-     * @name throwAlreadyInstalled
-     * @memberof MouseHandler
-     * @instance
-     * @private
-     * @param {string} name - The name of the event.
-     * @return {void}
-     */
-    private throwAlreadyInstalled;
-    /**
-     * Call this when your work is done.
-     *
-     * The function will un-install all event listeners.
-     *
-     * @name destroy
-     * @memberof MouseHandler
-     * @instance
-     * @private
-     * @return {void}
-     */
-    destroy(): void;
-}