@mlightcad/cad-simple-viewer 1.0.0 → 1.0.2

package/lib/editor/input/AcEdBoxSelector.js

@@ -15,20 +15,52 @@ var __extends = (this && this.__extends) || (function () {
 })();
 import { AcCmColor, AcGeBox2d, AcGePoint2d } from '@mlightcad/data-model';
 import { AcEdBaseInput } from './AcEdBaseInput';
+/** Default border color for the selection box */
 var BORDER_COLOR = 0xffffff;
+/** Default border width for the selection box */
 var BORDER_WIDTH = '1px';
 /**
  * Selector used to select entities by a box.
+ *
+ * This class provides interactive box selection functionality for the CAD editor.
+ * Users can click and drag to create a selection rectangle, which is then converted
+ * to world coordinates for entity selection operations.
+ *
+ * The selector handles mouse events to track the selection area and provides visual
+ * feedback through a DOM overlay showing the selection bounds.
+ *
+ * @example
+ * ```typescript
+ * const boxSelector = new AcEdBoxSelector(view);
+ * const selectionBox = await boxSelector.start();
+ * // Use selectionBox to select entities
+ * ```
+ *
  * @internal
  */
 var AcEdBoxSelector = /** @class */ (function (_super) {
     __extends(AcEdBoxSelector, _super);
+    /**
+     * Creates a new box selector instance.
+     *
+     * @param view - The view that will handle this box selection operation
+     */
     function AcEdBoxSelector(view) {
         var _this = _super.call(this, view) || this;
+        /** Whether the mouse button is currently pressed */
         _this.mouseDown = false;
+        /** Whether the mouse has moved since being pressed */
         _this.mouseMove = false;
+        /** X coordinate where mouse was initially pressed (-1 indicates invalid) */
         _this.mouseDownPositionX = -1; // -1 means invalid point
+        /** Y coordinate where mouse was initially pressed (-1 indicates invalid) */
         _this.mouseDownPositionY = -1;
+        /**
+         * Handles mouse down events to start box selection.
+         * Records the initial mouse position for the selection area.
+         *
+         * @param e - The mouse event
+         */
         _this.mousedown = function (e) {
             if (e.button === 0) {
                 _this.mouseDown = true;
@@ -37,6 +69,12 @@ var AcEdBoxSelector = /** @class */ (function (_super) {
                 _this.mouseDownPositionY = point.y;
             }
         };
+        /**
+         * Handles mouse move events to update the selection box.
+         * Creates and updates the visual selection rectangle as the user drags.
+         *
+         * @param e - The mouse event
+         */
         _this.mousemove = function (e) {
             if (!_this.mouseDown) {
                 return;
@@ -53,6 +91,12 @@ var AcEdBoxSelector = /** @class */ (function (_super) {
                 }
             }
         };
+        /**
+         * Handles mouse up events to complete box selection.
+         * Calculates the final selection area and resolves the promise with the result.
+         *
+         * @param e - The mouse event
+         */
         _this.mouseup = function (e) {
             if (_this.mouseDown && _this.mouseMove) {
                 var point = new AcGePoint2d(e.x, e.y);
@@ -71,6 +115,11 @@ var AcEdBoxSelector = /** @class */ (function (_super) {
         _this.color = BORDER_COLOR;
         return _this;
     }
+    /**
+     * Activates the box selector.
+     * Sets up mouse event listeners for tracking selection area.
+     * Overrides the base class to add mouse event handling.
+     */
     AcEdBoxSelector.prototype.activate = function () {
         _super.prototype.activate.call(this);
         this.active = true;
@@ -78,6 +127,11 @@ var AcEdBoxSelector = /** @class */ (function (_super) {
         this.container.addEventListener('pointermove', this.mousemove);
         this.container.addEventListener('pointerup', this.mouseup);
     };
+    /**
+     * Deactivates the box selector.
+     * Removes mouse event listeners and hides the selection box.
+     * Overrides the base class to clean up mouse event handling.
+     */
     AcEdBoxSelector.prototype.deactivate = function () {
         _super.prototype.deactivate.call(this);
         this.container.removeEventListener('pointerdown', this.mousedown);
@@ -85,12 +139,25 @@ var AcEdBoxSelector = /** @class */ (function (_super) {
         this.container.removeEventListener('pointerup', this.mouseup);
         this.setRectDomVisible(false);
     };
+    /**
+     * Rejects the box selection operation.
+     * Cleans up the selection box DOM element.
+     *
+     * @param reason - The reason for rejecting the selection operation
+     */
     AcEdBoxSelector.prototype.reject = function (reason) {
         var _a;
         _super.prototype.reject.call(this, reason);
         (_a = this.boxDom) === null || _a === void 0 ? void 0 : _a.remove();
         this.boxDom = undefined;
     };
+    /**
+     * Draws the selection rectangle on screen.
+     * Creates or updates the DOM element representing the selection box.
+     *
+     * @param leftTop - The top-left corner of the selection rectangle
+     * @param rightBottom - The bottom-right corner of the selection rectangle
+     */
     AcEdBoxSelector.prototype.drawRect = function (leftTop, rightBottom) {
         if (!this.boxDom) {
             var color = new AcCmColor();
@@ -121,11 +188,24 @@ var AcEdBoxSelector = /** @class */ (function (_super) {
         this.boxDom.style.width = "".concat(width, "px");
         this.boxDom.style.height = "".concat(height, "px");
     };
+    /**
+     * Sets the visibility of the selection rectangle DOM element.
+     *
+     * @param visible - Whether the selection rectangle should be visible
+     */
     AcEdBoxSelector.prototype.setRectDomVisible = function (visible) {
         if (this.boxDom) {
             this.boxDom.style.display = visible ? 'inline-block' : 'none';
         }
     };
+    /**
+     * Converts a screen coordinate box to world coordinate system.
+     * Transforms the selection box from screen coordinates to world coordinates
+     * for use in entity selection operations.
+     *
+     * @param box - The selection box in screen coordinates
+     * @returns The selection box in world coordinates
+     */
     AcEdBoxSelector.prototype.toWcs = function (box) {
         var wcsBox = new AcGeBox2d();
         var p1 = new AcGePoint2d(box.min.x, box.min.y);

package/lib/editor/input/AcEdBoxSelector.js.map

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

package/lib/editor/input/AcEdCursorManager.d.ts

@@ -1,36 +1,123 @@
+/**
+ * Enumeration of cursor types available in the CAD editor.
+ *
+ * These cursor types provide visual feedback to users about the current
+ * operation mode or expected input type. Each cursor has a specific
+ * appearance and is used in different contexts.
+ *
+ * @example
+ * ```typescript
+ * // Set crosshair cursor for precise point input
+ * editor.setCursor(AcEdCorsorType.Crosshair);
+ *
+ * // Set grab cursor for pan operations
+ * editor.setCursor(AcEdCorsorType.Grab);
+ *
+ * // Restore default cursor
+ * editor.setCursor(AcEdCorsorType.NoSpecialCursor);
+ * ```
+ */
 export declare enum AcEdCorsorType {
+    /** No special cursor - uses browser default */
     NoSpecialCursor = -1,
+    /** Crosshair cursor for precise point selection */
     Crosshair = 0,
+    /** Rectangle cursor for area selection */
     RectCursor = 1,
+    /** Rubber band cursor for dynamic drawing */
     RubberBand = 2,
+    /** Non-rotated cursor */
     NotRotated = 3,
+    /** Target box cursor for object snapping */
     TargetBox = 4,
+    /** Rotated crosshair cursor */
     RotatedCrosshair = 5,
+    /** Crosshair that doesn't rotate with view */
     CrosshairNoRotate = 6,
+    /** Invisible cursor for hiding cursor */
     Invisible = 7,
+    /** Entity selection cursor */
     EntitySelect = 8,
+    /** Parallelogram cursor for skewed operations */
     Parallelogram = 9,
+    /** Entity select cursor without perspective */
     EntitySelectNoPersp = 10,
+    /** Cursor for pick-first or grips operations */
     PkfirstOrGrips = 11,
+    /** Dashed crosshair cursor */
     CrosshairDashed = 12,
+    /** Grab/hand cursor for panning */
     Grab = 13
 }
 /**
- * The class to create and manage cursor
- * @internal
+ * Manages cursor appearance and behavior for the CAD editor.
+ *
+ * This class creates and applies custom cursors to HTML elements,
+ * providing visual feedback for different CAD operations. It supports
+ * both built-in browser cursors and custom SVG-based cursors.
+ *
+ * The cursor manager maintains a cache of cursor definitions to avoid
+ * recreating them repeatedly, improving performance.
+ *
+ * @internal This class is for internal use by the editor system
+ *
+ * @example
+ * ```typescript
+ * const cursorManager = new AcEdCursorManager();
+ * const canvas = document.getElementById('canvas') as HTMLCanvasElement;
+ *
+ * // Set crosshair cursor
+ * cursorManager.setCursor(AcEdCorsorType.Crosshair, canvas);
+ *
+ * // Set grab cursor for panning
+ * cursorManager.setCursor(AcEdCorsorType.Grab, canvas);
+ * ```
  */
 export declare class AcEdCursorManager {
+    /** Cache of cursor definitions mapped by cursor type */
     private _cursorMap;
+    /**
+     * Creates a new cursor manager instance.
+     *
+     * Initializes the cursor cache and creates default cursor definitions.
+     */
     constructor();
+    /**
+     * Sets the cursor for the specified HTML element.
+     *
+     * Applies the appropriate cursor style based on the cursor type.
+     * For built-in cursor types, uses CSS cursor values. For custom
+     * cursor types, uses cached SVG-based cursor definitions.
+     *
+     * @param cursorType - The type of cursor to set
+     * @param element - The HTML element to apply the cursor to
+     *
+     * @example
+     * ```typescript
+     * const canvas = document.getElementById('canvas') as HTMLCanvasElement;
+     * cursorManager.setCursor(AcEdCorsorType.Crosshair, canvas);
+     * ```
+     */
     setCursor(cursorType: AcEdCorsorType, element: HTMLElement): void;
     /**
-     * Encode SVG string to one cursor defined using url() in CSS
-     * @param svgString Input svg string
-     * @param xOffset Input x offset for cursor hotspot
-     * @param yOffset Input y offset for cursor hotspot
-     * @returns
+     * Encodes an SVG string into a CSS cursor URL.
+     *
+     * This method converts SVG markup into a data URI that can be used
+     * as a CSS cursor value, with specified hotspot coordinates.
+     *
+     * @param svgString - The SVG markup as a string
+     * @param xOffset - X coordinate of the cursor hotspot
+     * @param yOffset - Y coordinate of the cursor hotspot
+     * @returns CSS cursor string in url() format
+     *
+     * @example
+     * ```typescript
+     * const svgCursor = '<svg width="20" height="20">...</svg>';
+     * const cursorUrl = cursorManager.encodeSvgToCursor(svgCursor, 10, 10);
+     * element.style.cursor = cursorUrl;
+     * ```
      */
-    private encodeSvg;
+    encodeSvgToCursor(svgString: string, xOffset: number, yOffset: number): string;
     /**
      * Create one svg icon with one rectangle plus two cross lines
      * @param rectSize Input the width and height of rectangle

package/lib/editor/input/AcEdCursorManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcEdCursorManager.d.ts","sourceRoot":"","sources":["../../../src/editor/input/AcEdCursorManager.ts"],"names":[],"mappings":"AAAA,oBAAY,cAAc;IACxB,eAAe,KAAK;IACpB,SAAS,IAAI;IACb,UAAU,IAAA;IACV,UAAU,IAAA;IACV,UAAU,IAAA;IACV,SAAS,IAAA;IACT,gBAAgB,IAAA;IAChB,iBAAiB,IAAA;IACjB,SAAS,IAAA;IACT,YAAY,IAAA;IACZ,aAAa,IAAA;IACb,mBAAmB,KAAA;IACnB,cAAc,KAAA;IACd,eAAe,KAAA;IACf,IAAI,KAAA;CACL;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAA6B;;IAS/C,SAAS,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW;IAa1D;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAQjB;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;CAkB5B"}
+{"version":3,"file":"AcEdCursorManager.d.ts","sourceRoot":"","sources":["../../../src/editor/input/AcEdCursorManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,oBAAY,cAAc;IACxB,+CAA+C;IAC/C,eAAe,KAAK;IACpB,mDAAmD;IACnD,SAAS,IAAI;IACb,0CAA0C;IAC1C,UAAU,IAAA;IACV,6CAA6C;IAC7C,UAAU,IAAA;IACV,yBAAyB;IACzB,UAAU,IAAA;IACV,4CAA4C;IAC5C,SAAS,IAAA;IACT,+BAA+B;IAC/B,gBAAgB,IAAA;IAChB,8CAA8C;IAC9C,iBAAiB,IAAA;IACjB,yCAAyC;IACzC,SAAS,IAAA;IACT,8BAA8B;IAC9B,YAAY,IAAA;IACZ,iDAAiD;IACjD,aAAa,IAAA;IACb,+CAA+C;IAC/C,mBAAmB,KAAA;IACnB,gDAAgD;IAChD,cAAc,KAAA;IACd,8BAA8B;IAC9B,eAAe,KAAA;IACf,mCAAmC;IACnC,IAAI,KAAA;CACL;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,iBAAiB;IAC5B,wDAAwD;IACxD,OAAO,CAAC,UAAU,CAA6B;IAE/C;;;;OAIG;;IASH;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW;IAa1D;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAIrE;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;CAkB5B"}

package/lib/editor/input/AcEdCursorManager.js

@@ -1,30 +1,105 @@
+/**
+ * Enumeration of cursor types available in the CAD editor.
+ *
+ * These cursor types provide visual feedback to users about the current
+ * operation mode or expected input type. Each cursor has a specific
+ * appearance and is used in different contexts.
+ *
+ * @example
+ * ```typescript
+ * // Set crosshair cursor for precise point input
+ * editor.setCursor(AcEdCorsorType.Crosshair);
+ *
+ * // Set grab cursor for pan operations
+ * editor.setCursor(AcEdCorsorType.Grab);
+ *
+ * // Restore default cursor
+ * editor.setCursor(AcEdCorsorType.NoSpecialCursor);
+ * ```
+ */
 export var AcEdCorsorType;
 (function (AcEdCorsorType) {
+    /** No special cursor - uses browser default */
     AcEdCorsorType[AcEdCorsorType["NoSpecialCursor"] = -1] = "NoSpecialCursor";
+    /** Crosshair cursor for precise point selection */
     AcEdCorsorType[AcEdCorsorType["Crosshair"] = 0] = "Crosshair";
+    /** Rectangle cursor for area selection */
     AcEdCorsorType[AcEdCorsorType["RectCursor"] = 1] = "RectCursor";
+    /** Rubber band cursor for dynamic drawing */
     AcEdCorsorType[AcEdCorsorType["RubberBand"] = 2] = "RubberBand";
+    /** Non-rotated cursor */
     AcEdCorsorType[AcEdCorsorType["NotRotated"] = 3] = "NotRotated";
+    /** Target box cursor for object snapping */
     AcEdCorsorType[AcEdCorsorType["TargetBox"] = 4] = "TargetBox";
+    /** Rotated crosshair cursor */
     AcEdCorsorType[AcEdCorsorType["RotatedCrosshair"] = 5] = "RotatedCrosshair";
+    /** Crosshair that doesn't rotate with view */
     AcEdCorsorType[AcEdCorsorType["CrosshairNoRotate"] = 6] = "CrosshairNoRotate";
+    /** Invisible cursor for hiding cursor */
     AcEdCorsorType[AcEdCorsorType["Invisible"] = 7] = "Invisible";
+    /** Entity selection cursor */
     AcEdCorsorType[AcEdCorsorType["EntitySelect"] = 8] = "EntitySelect";
+    /** Parallelogram cursor for skewed operations */
     AcEdCorsorType[AcEdCorsorType["Parallelogram"] = 9] = "Parallelogram";
+    /** Entity select cursor without perspective */
     AcEdCorsorType[AcEdCorsorType["EntitySelectNoPersp"] = 10] = "EntitySelectNoPersp";
+    /** Cursor for pick-first or grips operations */
     AcEdCorsorType[AcEdCorsorType["PkfirstOrGrips"] = 11] = "PkfirstOrGrips";
+    /** Dashed crosshair cursor */
     AcEdCorsorType[AcEdCorsorType["CrosshairDashed"] = 12] = "CrosshairDashed";
+    /** Grab/hand cursor for panning */
     AcEdCorsorType[AcEdCorsorType["Grab"] = 13] = "Grab";
 })(AcEdCorsorType || (AcEdCorsorType = {}));
 /**
- * The class to create and manage cursor
- * @internal
+ * Manages cursor appearance and behavior for the CAD editor.
+ *
+ * This class creates and applies custom cursors to HTML elements,
+ * providing visual feedback for different CAD operations. It supports
+ * both built-in browser cursors and custom SVG-based cursors.
+ *
+ * The cursor manager maintains a cache of cursor definitions to avoid
+ * recreating them repeatedly, improving performance.
+ *
+ * @internal This class is for internal use by the editor system
+ *
+ * @example
+ * ```typescript
+ * const cursorManager = new AcEdCursorManager();
+ * const canvas = document.getElementById('canvas') as HTMLCanvasElement;
+ *
+ * // Set crosshair cursor
+ * cursorManager.setCursor(AcEdCorsorType.Crosshair, canvas);
+ *
+ * // Set grab cursor for panning
+ * cursorManager.setCursor(AcEdCorsorType.Grab, canvas);
+ * ```
  */
 var AcEdCursorManager = /** @class */ (function () {
+    /**
+     * Creates a new cursor manager instance.
+     *
+     * Initializes the cursor cache and creates default cursor definitions.
+     */
     function AcEdCursorManager() {
         this._cursorMap = new Map();
         this._cursorMap.set(AcEdCorsorType.Crosshair, this.createRectCrossIcon(10, 10));
     }
+    /**
+     * Sets the cursor for the specified HTML element.
+     *
+     * Applies the appropriate cursor style based on the cursor type.
+     * For built-in cursor types, uses CSS cursor values. For custom
+     * cursor types, uses cached SVG-based cursor definitions.
+     *
+     * @param cursorType - The type of cursor to set
+     * @param element - The HTML element to apply the cursor to
+     *
+     * @example
+     * ```typescript
+     * const canvas = document.getElementById('canvas') as HTMLCanvasElement;
+     * cursorManager.setCursor(AcEdCorsorType.Crosshair, canvas);
+     * ```
+     */
     AcEdCursorManager.prototype.setCursor = function (cursorType, element) {
         if (cursorType <= AcEdCorsorType.NoSpecialCursor) {
             element.style.cursor = 'default';
@@ -40,15 +115,24 @@ var AcEdCursorManager = /** @class */ (function () {
         }
     };
     /**
-     * Encode SVG string to one cursor defined using url() in CSS
-     * @param svgString Input svg string
-     * @param xOffset Input x offset for cursor hotspot
-     * @param yOffset Input y offset for cursor hotspot
-     * @returns
+     * Encodes an SVG string into a CSS cursor URL.
+     *
+     * This method converts SVG markup into a data URI that can be used
+     * as a CSS cursor value, with specified hotspot coordinates.
+     *
+     * @param svgString - The SVG markup as a string
+     * @param xOffset - X coordinate of the cursor hotspot
+     * @param yOffset - Y coordinate of the cursor hotspot
+     * @returns CSS cursor string in url() format
+     *
+     * @example
+     * ```typescript
+     * const svgCursor = '<svg width="20" height="20">...</svg>';
+     * const cursorUrl = cursorManager.encodeSvgToCursor(svgCursor, 10, 10);
+     * element.style.cursor = cursorUrl;
+     * ```
      */
-    AcEdCursorManager.prototype.encodeSvg = function (svgString, xOffset, yOffset) {
-        if (xOffset === void 0) { xOffset = 0; }
-        if (yOffset === void 0) { yOffset = 0; }
+    AcEdCursorManager.prototype.encodeSvgToCursor = function (svgString, xOffset, yOffset) {
         return "url('data:image/svg+xml;base64,".concat(btoa(svgString), "') ").concat(xOffset, " ").concat(yOffset, ", auto");
     };
     /**
@@ -63,7 +147,7 @@ var AcEdCursorManager = /** @class */ (function () {
         var halfSize = rectSize / 2;
         var svgSize = rectSize + 2 * lineLength;
         var svg = "\n      <svg xmlns=\"http://www.w3.org/2000/svg\" width=\"".concat(svgSize, "\" height=\"").concat(svgSize, "\" viewBox=\"0 0 ").concat(svgSize, " ").concat(svgSize, "\">\n        <rect x=\"").concat(lineLength, "\" y=\"").concat(lineLength, "\" width=\"").concat(rectSize, "\" height=\"").concat(rectSize, "\" fill=\"none\" stroke=\"").concat(lineColor, "\" />\n        <line x1=\"").concat(halfSize + lineLength, "\" y1=\"0\" x2=\"").concat(halfSize + lineLength, "\" y2=\"").concat(lineLength, "\" stroke=\"").concat(lineColor, "\" />\n        <line x1=\"").concat(rectSize + lineLength, "\" y1=\"").concat(halfSize + lineLength, "\" x2=\"").concat(rectSize + 2 * lineLength, "\" y2=\"").concat(halfSize + lineLength, "\" stroke=\"").concat(lineColor, "\" />\n        <line x1=\"").concat(halfSize + lineLength, "\" y1=\"").concat(rectSize + lineLength, "\" x2=\"").concat(halfSize + lineLength, "\" y2=\"").concat(rectSize + 2 * lineLength, "\" stroke=\"").concat(lineColor, "\" />\n        <line x1=\"0\" y1=\"").concat(halfSize + lineLength, "\" x2=\"").concat(lineLength, "\" y2=\"").concat(halfSize + lineLength, "\" stroke=\"").concat(lineColor, "\" />\n      </svg>\n    ");
-        return this.encodeSvg(svg, halfSize + lineLength, halfSize + lineLength);
+        return this.encodeSvgToCursor(svg, halfSize + lineLength, halfSize + lineLength);
     };
     return AcEdCursorManager;
 }());

package/lib/editor/input/AcEdCursorManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcEdCursorManager.js","sourceRoot":"","sources":["../../../src/editor/input/AcEdCursorManager.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,cAgBX;AAhBD,WAAY,cAAc;IACxB,0EAAoB,CAAA;IACpB,6DAAa,CAAA;IACb,+DAAU,CAAA;IACV,+DAAU,CAAA;IACV,+DAAU,CAAA;IACV,6DAAS,CAAA;IACT,2EAAgB,CAAA;IAChB,6EAAiB,CAAA;IACjB,6DAAS,CAAA;IACT,mEAAY,CAAA;IACZ,qEAAa,CAAA;IACb,kFAAmB,CAAA;IACnB,wEAAc,CAAA;IACd,0EAAe,CAAA;IACf,oDAAI,CAAA;AACN,CAAC,EAhBW,cAAc,KAAd,cAAc,QAgBzB;AAED;;;GAGG;AACH;IAEE;QACE,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAA;QAC3B,IAAI,CAAC,UAAU,CAAC,GAAG,CACjB,cAAc,CAAC,SAAS,EACxB,IAAI,CAAC,mBAAmB,CAAC,EAAE,EAAE,EAAE,CAAC,CACjC,CAAA;IACH,CAAC;IAED,qCAAS,GAAT,UAAU,UAA0B,EAAE,OAAoB;QACxD,IAAI,UAAU,IAAI,cAAc,CAAC,eAAe,EAAE,CAAC;YACjD,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAA;QAClC,CAAC;aAAM,IAAI,UAAU,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAA;QAC/B,CAAC;aAAM,CAAC;YACN,IAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;YAC9C,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAA;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,qCAAS,GAAjB,UACE,SAAiB,EACjB,OAAmB,EACnB,OAAmB;QADnB,wBAAA,EAAA,WAAmB;QACnB,wBAAA,EAAA,WAAmB;QAEnB,OAAO,yCAAkC,IAAI,CAAC,SAAS,CAAC,gBAAM,OAAO,cAAI,OAAO,WAAQ,CAAA;IAC1F,CAAC;IAED;;;;;;OAMG;IACK,+CAAmB,GAA3B,UACE,QAAgB,EAChB,UAAkB,EAClB,SAA2B;QAA3B,0BAAA,EAAA,mBAA2B;QAE3B,IAAM,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAA;QAC7B,IAAM,OAAO,GAAG,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAA;QACzC,IAAM,GAAG,GAAG,oEACuC,OAAO,yBAAa,OAAO,8BAAkB,OAAO,cAAI,OAAO,oCACnG,UAAU,oBAAQ,UAAU,wBAAY,QAAQ,yBAAa,QAAQ,uCAAyB,SAAS,uCACtG,QAAQ,GAAG,UAAU,8BAAgB,QAAQ,GAAG,UAAU,qBAAS,UAAU,yBAAa,SAAS,uCACnG,QAAQ,GAAG,UAAU,qBAAS,QAAQ,GAAG,UAAU,qBAAS,QAAQ,GAAG,CAAC,GAAG,UAAU,qBAAS,QAAQ,GAAG,UAAU,yBAAa,SAAS,uCACzI,QAAQ,GAAG,UAAU,qBAAS,QAAQ,GAAG,UAAU,qBAAS,QAAQ,GAAG,UAAU,qBAAS,QAAQ,GAAG,CAAC,GAAG,UAAU,yBAAa,SAAS,gDAClI,QAAQ,GAAG,UAAU,qBAAS,UAAU,qBAAS,QAAQ,GAAG,UAAU,yBAAa,SAAS,8BAElH,CAAA;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,UAAU,EAAE,QAAQ,GAAG,UAAU,CAAC,CAAA;IAC1E,CAAC;IACH,wBAAC;AAAD,CAAC,AA/DD,IA+DC"}
+{"version":3,"file":"AcEdCursorManager.js","sourceRoot":"","sources":["../../../src/editor/input/AcEdCursorManager.ts"],"names":[],"mappings":"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"}

package/lib/editor/input/AcEdInputPoint.d.ts

@@ -2,13 +2,50 @@ import { AcGePoint2d } from '@mlightcad/data-model';
 import { AcEdBaseView } from '../view/AcEdBaseView';
 import { AcEdBaseInput } from './AcEdBaseInput';
 /**
- * Class used to input one point
+ * Class used to input one point from user interaction.
+ *
+ * This class provides functionality for capturing a single point input from the user
+ * by handling mouse click events. When the user clicks on the canvas, the click
+ * coordinates are converted from screen coordinates to world coordinates and
+ * returned as the result.
+ *
+ * The input operation can be canceled by pressing the Escape key (handled by the base class).
+ *
+ * @example
+ * ```typescript
+ * const pointInput = new AcEdInputPoint(view);
+ * const point = await pointInput.start();
+ * console.log(`User clicked at: ${point.x}, ${point.y}`);
+ * ```
+ *
  * @internal
  */
 export declare class AcEdInputPoint extends AcEdBaseInput<AcGePoint2d> {
+    /**
+     * Creates a new point input instance.
+     *
+     * @param view - The view that will handle this point input operation
+     */
     constructor(view: AcEdBaseView);
+    /**
+     * Activates the point input operation.
+     * Sets up the click event listener to capture user point selection.
+     * Overrides the base class to add click event handling.
+     */
     activate(): void;
+    /**
+     * Deactivates the point input operation.
+     * Removes the click event listener.
+     * Overrides the base class to clean up click event handling.
+     */
     deactivate(): void;
+    /**
+     * Handles mouse click events to capture the selected point.
+     * Converts the click coordinates from screen space to world coordinates
+     * and resolves the input operation with the resulting point.
+     *
+     * @param event - The mouse click event containing the screen coordinates
+     */
     private onClick;
 }
 //# sourceMappingURL=AcEdInputPoint.d.ts.map

package/lib/editor/input/AcEdInputPoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcEdInputPoint.d.ts","sourceRoot":"","sources":["../../../src/editor/input/AcEdInputPoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;;GAGG;AACH,qBAAa,cAAe,SAAQ,aAAa,CAAC,WAAW,CAAC;gBAChD,IAAI,EAAE,YAAY;IAI9B,QAAQ;IAKR,UAAU;IAKV,OAAO,CAAC,OAAO,CAEd;CACF"}
+{"version":3,"file":"AcEdInputPoint.d.ts","sourceRoot":"","sources":["../../../src/editor/input/AcEdInputPoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAe,SAAQ,aAAa,CAAC,WAAW,CAAC;IAC5D;;;;OAIG;gBACS,IAAI,EAAE,YAAY;IAI9B;;;;OAIG;IACH,QAAQ;IAKR;;;;OAIG;IACH,UAAU;IAKV;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,CAEd;CACF"}

package/lib/editor/input/AcEdInputPoint.js

@@ -15,22 +15,59 @@ var __extends = (this && this.__extends) || (function () {
 })();
 import { AcEdBaseInput } from './AcEdBaseInput';
 /**
- * Class used to input one point
+ * Class used to input one point from user interaction.
+ *
+ * This class provides functionality for capturing a single point input from the user
+ * by handling mouse click events. When the user clicks on the canvas, the click
+ * coordinates are converted from screen coordinates to world coordinates and
+ * returned as the result.
+ *
+ * The input operation can be canceled by pressing the Escape key (handled by the base class).
+ *
+ * @example
+ * ```typescript
+ * const pointInput = new AcEdInputPoint(view);
+ * const point = await pointInput.start();
+ * console.log(`User clicked at: ${point.x}, ${point.y}`);
+ * ```
+ *
  * @internal
  */
 var AcEdInputPoint = /** @class */ (function (_super) {
     __extends(AcEdInputPoint, _super);
+    /**
+     * Creates a new point input instance.
+     *
+     * @param view - The view that will handle this point input operation
+     */
     function AcEdInputPoint(view) {
         var _this = _super.call(this, view) || this;
+        /**
+         * Handles mouse click events to capture the selected point.
+         * Converts the click coordinates from screen space to world coordinates
+         * and resolves the input operation with the resulting point.
+         *
+         * @param event - The mouse click event containing the screen coordinates
+         */
         _this.onClick = function (event) {
             _this.resolve(_this.view.cwcs2Wcs({ x: event.clientX, y: event.clientY }));
         };
         return _this;
     }
+    /**
+     * Activates the point input operation.
+     * Sets up the click event listener to capture user point selection.
+     * Overrides the base class to add click event handling.
+     */
     AcEdInputPoint.prototype.activate = function () {
         _super.prototype.activate.call(this);
         this.view.canvas.addEventListener('click', this.onClick);
     };
+    /**
+     * Deactivates the point input operation.
+     * Removes the click event listener.
+     * Overrides the base class to clean up click event handling.
+     */
     AcEdInputPoint.prototype.deactivate = function () {
         _super.prototype.deactivate.call(this);
         this.view.canvas.removeEventListener('click', this.onClick);

package/lib/editor/input/AcEdInputPoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcEdInputPoint.js","sourceRoot":"","sources":["../../../src/editor/input/AcEdInputPoint.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;;GAGG;AACH;IAAoC,kCAA0B;IAC5D,wBAAY,IAAkB;QAC5B,YAAA,MAAK,YAAC,IAAI,CAAC,SAAA;QAaL,aAAO,GAAG,UAAC,KAAiB;YAClC,KAAI,CAAC,OAAO,CAAC,KAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;QAC1E,CAAC,CAAA;;IAdD,CAAC;IAED,iCAAQ,GAAR;QACE,gBAAK,CAAC,QAAQ,WAAE,CAAA;QAChB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;IAC1D,CAAC;IAED,mCAAU,GAAV;QACE,gBAAK,CAAC,UAAU,WAAE,CAAA;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;IAC7D,CAAC;IAKH,qBAAC;AAAD,CAAC,AAlBD,CAAoC,aAAa,GAkBhD"}
+{"version":3,"file":"AcEdInputPoint.js","sourceRoot":"","sources":["../../../src/editor/input/AcEdInputPoint.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH;IAAoC,kCAA0B;IAC5D;;;;OAIG;IACH,wBAAY,IAAkB;QAC5B,YAAA,MAAK,YAAC,IAAI,CAAC,SAAA;QAuBb;;;;;;WAMG;QACK,aAAO,GAAG,UAAC,KAAiB;YAClC,KAAI,CAAC,OAAO,CAAC,KAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;QAC1E,CAAC,CAAA;;IA/BD,CAAC;IAED;;;;OAIG;IACH,iCAAQ,GAAR;QACE,gBAAK,CAAC,QAAQ,WAAE,CAAA;QAChB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;IAC1D,CAAC;IAED;;;;OAIG;IACH,mCAAU,GAAV;QACE,gBAAK,CAAC,UAAU,WAAE,CAAA;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;IAC7D,CAAC;IAYH,qBAAC;AAAD,CAAC,AAxCD,CAAoC,aAAa,GAwChD"}