@mlightcad/cad-simple-viewer 1.0.0 → 1.0.1

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

@@ -2,23 +2,87 @@ import { AcEdBaseView } from '../view/AcEdBaseView';
 /**
  * The base class for all of classes to get user inputs such as string, angle, number, point, selection,
  * and so on.
+ *
+ * This abstract class provides a common framework for handling user input operations in the CAD editor.
+ * It manages the input lifecycle including activation, deactivation, and promise-based resolution.
+ * Subclasses must implement specific input behaviors while this base class handles common functionality
+ * like keyboard event handling and promise management.
+ *
+ * @template TResult - The type of result that this input operation will return
+ *
+ * @example
+ * ```typescript
+ * class MyInput extends AcEdBaseInput<string> {
+ *   // Implement specific input behavior
+ * }
+ * const input = new MyInput(view);
+ * const result = await input.start();
+ * ```
+ *
  * @internal
  */
 export declare abstract class AcEdBaseInput<TResult> {
+    /** The view associated with this input operation */
     protected view: AcEdBaseView;
+    /** Whether this input is currently active */
     protected active: boolean;
+    /** Flag to prevent multiple resolutions of the same promise */
     protected isResolvedOrRejected: boolean;
+    /** Promise resolve function for completing the input operation */
     private _resolve?;
+    /** Promise reject function for canceling the input operation */
     private _reject?;
+    /**
+     * Creates a new base input instance.
+     *
+     * @param view - The view that will handle this input operation
+     */
     constructor(view: AcEdBaseView);
+    /**
+     * Gets whether this input is currently active.
+     *
+     * @returns True if the input is active, false otherwise
+     */
     get isActive(): boolean;
+    /**
+     * Activates this input operation.
+     * Sets up event listeners and marks the input as active.
+     * Subclasses should call super.activate() when overriding.
+     */
     activate(): void;
+    /**
+     * Deactivates this input operation.
+     * Removes event listeners and marks the input as inactive.
+     * Subclasses should call super.deactivate() when overriding.
+     */
     deactivate(): void;
+    /**
+     * Resolves the input operation with the specified result.
+     * Automatically deactivates the input and prevents multiple resolutions.
+     *
+     * @param result - The result to resolve the promise with
+     */
     resolve(result: TResult): void;
+    /**
+     * Rejects the input operation with the specified reason.
+     * Automatically deactivates the input and prevents multiple rejections.
+     *
+     * @param reason - The reason for rejecting the input operation
+     */
     reject(reason: string): void;
+    /**
+     * Handles keyboard events for the input operation.
+     * By default, cancels the operation when Escape is pressed.
+     *
+     * @param e - The keyboard event
+     */
     private onKeyDown;
     /**
-     * Start inputting
+     * Starts the input operation and returns a promise that resolves with the result.
+     * This method activates the input and returns a promise that will be resolved
+     * when the user completes the input operation.
+     *
+     * @returns A promise that resolves with the input result
      */
     start(): Promise<TResult>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"AcEdBaseInput.d.ts","sourceRoot":"","sources":["../../../src/editor/input/AcEdBaseInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD;;;;GAIG;AACH,8BAAsB,aAAa,CAAC,OAAO;IACzC,SAAS,CAAC,IAAI,EAAE,YAAY,CAAA;IAC5B,SAAS,CAAC,MAAM,UAAQ;IACxB,SAAS,CAAC,oBAAoB,UAAQ;IAEtC,OAAO,CAAC,QAAQ,CAAC,CAA0B;IAC3C,OAAO,CAAC,OAAO,CAAC,CAA0B;gBAE9B,IAAI,EAAE,YAAY;IAI9B,IAAI,QAAQ,YAEX;IAED,QAAQ;IAQR,UAAU;IAKV,OAAO,CAAC,MAAM,EAAE,OAAO;IAQvB,MAAM,CAAC,MAAM,EAAE,MAAM;IAQrB,OAAO,CAAC,SAAS,CAIhB;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;CAQhC"}
+{"version":3,"file":"AcEdBaseInput.d.ts","sourceRoot":"","sources":["../../../src/editor/input/AcEdBaseInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,8BAAsB,aAAa,CAAC,OAAO;IACzC,oDAAoD;IACpD,SAAS,CAAC,IAAI,EAAE,YAAY,CAAA;IAC5B,6CAA6C;IAC7C,SAAS,CAAC,MAAM,UAAQ;IACxB,+DAA+D;IAC/D,SAAS,CAAC,oBAAoB,UAAQ;IAEtC,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAC,CAA0B;IAC3C,gEAAgE;IAChE,OAAO,CAAC,OAAO,CAAC,CAA0B;IAE1C;;;;OAIG;gBACS,IAAI,EAAE,YAAY;IAI9B;;;;OAIG;IACH,IAAI,QAAQ,YAEX;IAED;;;;OAIG;IACH,QAAQ;IAQR;;;;OAIG;IACH,UAAU;IAKV;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO;IAQvB;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM;IAQrB;;;;;OAKG;IACH,OAAO,CAAC,SAAS,CAIhB;IAED;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;CAQhC"}

package/lib/editor/input/AcEdBaseInput.js

@@ -37,13 +37,43 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 /**
  * The base class for all of classes to get user inputs such as string, angle, number, point, selection,
  * and so on.
+ *
+ * This abstract class provides a common framework for handling user input operations in the CAD editor.
+ * It manages the input lifecycle including activation, deactivation, and promise-based resolution.
+ * Subclasses must implement specific input behaviors while this base class handles common functionality
+ * like keyboard event handling and promise management.
+ *
+ * @template TResult - The type of result that this input operation will return
+ *
+ * @example
+ * ```typescript
+ * class MyInput extends AcEdBaseInput<string> {
+ *   // Implement specific input behavior
+ * }
+ * const input = new MyInput(view);
+ * const result = await input.start();
+ * ```
+ *
  * @internal
  */
 var AcEdBaseInput = /** @class */ (function () {
+    /**
+     * Creates a new base input instance.
+     *
+     * @param view - The view that will handle this input operation
+     */
     function AcEdBaseInput(view) {
         var _this = this;
+        /** Whether this input is currently active */
         this.active = false;
+        /** Flag to prevent multiple resolutions of the same promise */
         this.isResolvedOrRejected = false;
+        /**
+         * Handles keyboard events for the input operation.
+         * By default, cancels the operation when Escape is pressed.
+         *
+         * @param e - The keyboard event
+         */
         this.onKeyDown = function (e) {
             if (e.code === 'Escape') {
                 _this.reject('Canceled by user!');
@@ -52,12 +82,22 @@ var AcEdBaseInput = /** @class */ (function () {
         this.view = view;
     }
     Object.defineProperty(AcEdBaseInput.prototype, "isActive", {
+        /**
+         * Gets whether this input is currently active.
+         *
+         * @returns True if the input is active, false otherwise
+         */
         get: function () {
             return this.active;
         },
         enumerable: false,
         configurable: true
     });
+    /**
+     * Activates this input operation.
+     * Sets up event listeners and marks the input as active.
+     * Subclasses should call super.activate() when overriding.
+     */
     AcEdBaseInput.prototype.activate = function () {
         if (this.isActive) {
             console.warn('Something wrong here!');
@@ -65,10 +105,21 @@ var AcEdBaseInput = /** @class */ (function () {
         this.active = true;
         this.view.canvas.addEventListener('keydown', this.onKeyDown);
     };
+    /**
+     * Deactivates this input operation.
+     * Removes event listeners and marks the input as inactive.
+     * Subclasses should call super.deactivate() when overriding.
+     */
     AcEdBaseInput.prototype.deactivate = function () {
         this.active = false;
         this.view.canvas.removeEventListener('keydown', this.onKeyDown);
     };
+    /**
+     * Resolves the input operation with the specified result.
+     * Automatically deactivates the input and prevents multiple resolutions.
+     *
+     * @param result - The result to resolve the promise with
+     */
     AcEdBaseInput.prototype.resolve = function (result) {
         this.deactivate();
         if (this._resolve && !this.isResolvedOrRejected) {
@@ -76,6 +127,12 @@ var AcEdBaseInput = /** @class */ (function () {
             this.isResolvedOrRejected = true;
         }
     };
+    /**
+     * Rejects the input operation with the specified reason.
+     * Automatically deactivates the input and prevents multiple rejections.
+     *
+     * @param reason - The reason for rejecting the input operation
+     */
     AcEdBaseInput.prototype.reject = function (reason) {
         this.deactivate();
         if (this._reject && !this.isResolvedOrRejected) {
@@ -84,7 +141,11 @@ var AcEdBaseInput = /** @class */ (function () {
         }
     };
     /**
-     * Start inputting
+     * Starts the input operation and returns a promise that resolves with the result.
+     * This method activates the input and returns a promise that will be resolved
+     * when the user completes the input operation.
+     *
+     * @returns A promise that resolves with the input result
      */
     AcEdBaseInput.prototype.start = function () {
         return __awaiter(this, void 0, void 0, function () {

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

@@ -1 +1 @@
-{"version":3,"file":"AcEdBaseInput.js","sourceRoot":"","sources":["../../../src/editor/input/AcEdBaseInput.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;;;;GAIG;AACH;IAQE,uBAAY,IAAkB;QAA9B,iBAEC;QARS,WAAM,GAAG,KAAK,CAAA;QACd,yBAAoB,GAAG,KAAK,CAAA;QA0C9B,cAAS,GAAG,UAAC,CAAgB;YACnC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxB,KAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAA;YAClC,CAAC;QACH,CAAC,CAAA;QAxCC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAED,sBAAI,mCAAQ;aAAZ;YACE,OAAO,IAAI,CAAC,MAAM,CAAA;QACpB,CAAC;;;OAAA;IAED,gCAAQ,GAAR;QACE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;QACvC,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IAC9D,CAAC;IAED,kCAAU,GAAV;QACE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IACjE,CAAC;IAED,+BAAO,GAAP,UAAQ,MAAe;QACrB,IAAI,CAAC,UAAU,EAAE,CAAA;QACjB,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAChD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YACrB,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAA;QAClC,CAAC;IACH,CAAC;IAED,8BAAM,GAAN,UAAO,MAAc;QACnB,IAAI,CAAC,UAAU,EAAE,CAAA;QACjB,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YACpB,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAA;QAClC,CAAC;IACH,CAAC;IAQD;;OAEG;IACG,6BAAK,GAAX;;;;gBACE,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAA;gBACjC,sBAAO,IAAI,OAAO,CAAU,UAAC,OAAO,EAAE,MAAM;wBAC1C,KAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;wBACvB,KAAI,CAAC,OAAO,GAAG,MAAM,CAAA;wBACrB,KAAI,CAAC,QAAQ,EAAE,CAAA;oBACjB,CAAC,CAAC,EAAA;;;KACH;IACH,oBAAC;AAAD,CAAC,AA9DD,IA8DC"}
+{"version":3,"file":"AcEdBaseInput.js","sourceRoot":"","sources":["../../../src/editor/input/AcEdBaseInput.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;IAaE;;;;OAIG;IACH,uBAAY,IAAkB;QAA9B,iBAEC;QAjBD,6CAA6C;QACnC,WAAM,GAAG,KAAK,CAAA;QACxB,+DAA+D;QACrD,yBAAoB,GAAG,KAAK,CAAA;QA4EtC;;;;;WAKG;QACK,cAAS,GAAG,UAAC,CAAgB;YACnC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxB,KAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAA;YAClC,CAAC;QACH,CAAC,CAAA;QAzEC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAOD,sBAAI,mCAAQ;QALZ;;;;WAIG;aACH;YACE,OAAO,IAAI,CAAC,MAAM,CAAA;QACpB,CAAC;;;OAAA;IAED;;;;OAIG;IACH,gCAAQ,GAAR;QACE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;QACvC,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IAC9D,CAAC;IAED;;;;OAIG;IACH,kCAAU,GAAV;QACE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IACjE,CAAC;IAED;;;;;OAKG;IACH,+BAAO,GAAP,UAAQ,MAAe;QACrB,IAAI,CAAC,UAAU,EAAE,CAAA;QACjB,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAChD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YACrB,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAA;QAClC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,8BAAM,GAAN,UAAO,MAAc;QACnB,IAAI,CAAC,UAAU,EAAE,CAAA;QACjB,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YACpB,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAA;QAClC,CAAC;IACH,CAAC;IAcD;;;;;;OAMG;IACG,6BAAK,GAAX;;;;gBACE,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAA;gBACjC,sBAAO,IAAI,OAAO,CAAU,UAAC,OAAO,EAAE,MAAM;wBAC1C,KAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;wBACvB,KAAI,CAAC,OAAO,GAAG,MAAM,CAAA;wBACrB,KAAI,CAAC,QAAQ,EAAE,CAAA;oBACjB,CAAC,CAAC,EAAA;;;KACH;IACH,oBAAC;AAAD,CAAC,AA7GD,IA6GC"}

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

@@ -3,25 +3,106 @@ import { AcEdBaseView } from '../view';
 import { AcEdBaseInput } from './AcEdBaseInput';
 /**
  * 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
  */
 export declare class AcEdBoxSelector extends AcEdBaseInput<AcGeBox2d> {
+    /** Whether the mouse button is currently pressed */
     private mouseDown;
+    /** Whether the mouse has moved since being pressed */
     private mouseMove;
+    /** X coordinate where mouse was initially pressed (-1 indicates invalid) */
     private mouseDownPositionX;
+    /** Y coordinate where mouse was initially pressed (-1 indicates invalid) */
     private mouseDownPositionY;
+    /** DOM element used to draw the selection box */
     private boxDom?;
+    /** Selection box border color */
     color: number;
+    /** The container element for the selection box */
     private container;
+    /**
+     * Creates a new box selector instance.
+     *
+     * @param view - The view that will handle this box selection operation
+     */
     constructor(view: AcEdBaseView);
+    /**
+     * Activates the box selector.
+     * Sets up mouse event listeners for tracking selection area.
+     * Overrides the base class to add mouse event handling.
+     */
     activate(): void;
+    /**
+     * Deactivates the box selector.
+     * Removes mouse event listeners and hides the selection box.
+     * Overrides the base class to clean up mouse event handling.
+     */
     deactivate(): void;
+    /**
+     * Rejects the box selection operation.
+     * Cleans up the selection box DOM element.
+     *
+     * @param reason - The reason for rejecting the selection operation
+     */
     reject(reason: string): void;
+    /**
+     * Handles mouse down events to start box selection.
+     * Records the initial mouse position for the selection area.
+     *
+     * @param e - The mouse event
+     */
     private mousedown;
+    /**
+     * 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
+     */
     private mousemove;
+    /**
+     * 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
+     */
     private mouseup;
+    /**
+     * 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
+     */
     private drawRect;
+    /**
+     * Sets the visibility of the selection rectangle DOM element.
+     *
+     * @param visible - Whether the selection rectangle should be visible
+     */
     private setRectDomVisible;
+    /**
+     * 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
+     */
     private toWcs;
 }
 //# sourceMappingURL=AcEdBoxSelector.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AcEdBoxSelector.d.ts","sourceRoot":"","sources":["../../../src/editor/input/AcEdBoxSelector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,SAAS,EAAe,MAAM,uBAAuB,CAAA;AAEzE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAK/C;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,aAAa,CAAC,SAAS,CAAC;IAC3D,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,kBAAkB,CAAK;IAG/B,OAAO,CAAC,MAAM,CAAC,CAAgB;IAExB,KAAK,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,SAAS,CAAa;gBAElB,IAAI,EAAE,YAAY;IAM9B,QAAQ;IAQR,UAAU;IAQV,MAAM,CAAC,MAAM,EAAE,MAAM;IAMrB,OAAO,CAAC,SAAS,CAOhB;IAED,OAAO,CAAC,SAAS,CAuBhB;IAED,OAAO,CAAC,OAAO,CAmBd;IAED,OAAO,CAAC,QAAQ;IAiChB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,KAAK;CAQd"}
+{"version":3,"file":"AcEdBoxSelector.d.ts","sourceRoot":"","sources":["../../../src/editor/input/AcEdBoxSelector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,SAAS,EAAe,MAAM,uBAAuB,CAAA;AAEzE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAO/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAgB,SAAQ,aAAa,CAAC,SAAS,CAAC;IAC3D,oDAAoD;IACpD,OAAO,CAAC,SAAS,CAAQ;IACzB,sDAAsD;IACtD,OAAO,CAAC,SAAS,CAAQ;IACzB,4EAA4E;IAC5E,OAAO,CAAC,kBAAkB,CAAK;IAC/B,4EAA4E;IAC5E,OAAO,CAAC,kBAAkB,CAAK;IAE/B,iDAAiD;IACjD,OAAO,CAAC,MAAM,CAAC,CAAgB;IAC/B,iCAAiC;IAC1B,KAAK,EAAE,MAAM,CAAA;IACpB,kDAAkD;IAClD,OAAO,CAAC,SAAS,CAAa;IAE9B;;;;OAIG;gBACS,IAAI,EAAE,YAAY;IAM9B;;;;OAIG;IACH,QAAQ;IAQR;;;;OAIG;IACH,UAAU;IAQV;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM;IAMrB;;;;;OAKG;IACH,OAAO,CAAC,SAAS,CAOhB;IAED;;;;;OAKG;IACH,OAAO,CAAC,SAAS,CAuBhB;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAAO,CAmBd;IAED;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;IAiChB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK;CAQd"}

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"}