@mlightcad/cad-simple-viewer 1.0.0 → 1.0.2

package/lib/editor/command/AcEdCommandStack.js

@@ -12,8 +12,23 @@ var __values = (this && this.__values) || function(o) {
 import { AcEdCommandIterator } from './AcEdCommandIterator';
 /**
  * The class to create, define, and register command objects.
+ *
+ * This is a singleton class that manages all command registration and lookup functionality.
+ * Commands are organized into groups, with system commands (ACAD) and user commands (USER)
+ * being the default groups.
+ *
+ * @example
+ * ```typescript
+ * const commandStack = AcEdCommandStack.instance;
+ * commandStack.addCommand('USER', 'MYCOMMAND', 'MYCOMMAND', myCommandInstance);
+ * const command = commandStack.lookupGlobalCmd('MYCOMMAND');
+ * ```
  */
 var AcEdCommandStack = /** @class */ (function () {
+    /**
+     * Private constructor to enforce singleton pattern.
+     * Initializes the command stack with system and default command groups.
+     */
     function AcEdCommandStack() {
         this._commandsByGroup = [];
         this._systemCommandGroup = {
@@ -30,6 +45,12 @@ var AcEdCommandStack = /** @class */ (function () {
         this._commandsByGroup.push(this._defaultCommandGroup);
     }
     Object.defineProperty(AcEdCommandStack, "instance", {
+        /**
+         * Gets the singleton instance of the command stack.
+         * Creates a new instance if one doesn't exist.
+         *
+         * @returns The singleton instance of AcEdCommandStack
+         */
         get: function () {
             if (!AcEdCommandStack._instance) {
                 AcEdCommandStack._instance = new AcEdCommandStack();
@@ -39,6 +60,21 @@ var AcEdCommandStack = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
+    /**
+     * Adds a command to the specified command group.
+     *
+     * @param cmdGroupName - The name of the command group. If empty, uses the default group.
+     * @param cmdGlobalName - The global (untranslated) name of the command. Must be unique within the group.
+     * @param cmdLocalName - The local (translated) name of the command. Defaults to global name if empty.
+     * @param cmd - The command object to add to the stack.
+     *
+     * @throws {Error} When the global name is empty or when a command with the same name already exists
+     *
+     * @example
+     * ```typescript
+     * commandStack.addCommand('USER', 'LINE', 'ligne', new LineCommand());
+     * ```
+     */
     AcEdCommandStack.prototype.addCommand = function (cmdGroupName, cmdGlobalName, cmdLocalName, cmd) {
         if (!cmdGlobalName) {
             throw new Error('[AcEdCommandStack] The global name of the command is required!');
@@ -74,6 +110,7 @@ var AcEdCommandStack = /** @class */ (function () {
     /**
      * Return an iterator that can be used to traverse all of command objects in this command stack
      * (that is, the iterator iterates through all commands in all groups).
+     *
      * @returns Return an iterator that can be used to traverse all of command objects in this command
      * stack.
      */
@@ -86,7 +123,8 @@ var AcEdCommandStack = /** @class */ (function () {
      * matched AcEdCommand object is returned. Otherwise undefined is returned to indicate that the command
      * could not be found. If more than one command of the same name is present in the command stack (that
      * is, in separate command groups), then the first one found is used.
-     * @param cmdName Input the command name to search for
+     *
+     * @param cmdName - Input the command name to search for
      * @returns Return the matched AcEdCommand object if a match is found. Otherwise, return undefined.
      */
     AcEdCommandStack.prototype.lookupGlobalCmd = function (cmdName) {
@@ -115,7 +153,8 @@ var AcEdCommandStack = /** @class */ (function () {
      * AcEdCommand object is returned. Otherwise undefined is returned to indicate that the command could not
      * be found. If more than one command of the same name is present in the command stack (that is, in
      * separate command groups), then the first one found is used.
-     * @param cmdName Input the command name to search for
+     *
+     * @param cmdName - Input the command name to search for
      * @returns Return the matched AcEdCommand object if a match is found. Otherwise, return undefined.
      */
     AcEdCommandStack.prototype.lookupLocalCmd = function (cmdName) {
@@ -142,8 +181,9 @@ var AcEdCommandStack = /** @class */ (function () {
      * Remove the command with the global and untranslated name `cmdGlobalName` from the `cmdGroupName`
      * command group. Return true if successful. Return false if no command with the global and untranslated
      * name `cmdGlobalName` is found in the `cmdGroupName` command group.
-     * @param cmdGroupName Input the name of the command group containing the command to be removed
-     * @param cmdGlobalName Input the command name which is to be removed from cmdGroupName
+     *
+     * @param cmdGroupName - Input the name of the command group containing the command to be removed
+     * @param cmdGlobalName - Input the command name which is to be removed from cmdGroupName
      * @returns Return true if successful. Return false if no command with the global and untranslated
      * name `cmdGlobalName` is found in the `cmdGroupName` command group.
      */
@@ -169,7 +209,8 @@ var AcEdCommandStack = /** @class */ (function () {
     /**
      * Remove the command group with the name `GroupName` from the command stack and delete the command group
      * dictionary object and all the AcEdCommand objects stored within it.
-     * @param groupName Input the name of the command group to be removed from the command stack.
+     *
+     * @param groupName - Input the name of the command group to be removed from the command stack.
      * @returns Return true if successful. Return false if no command group is found with the name `GroupName`.
      */
     AcEdCommandStack.prototype.removeGroup = function (groupName) {
@@ -184,7 +225,9 @@ var AcEdCommandStack = /** @class */ (function () {
         }
         return false;
     };
+    /** The name of the system command group */
     AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME = 'ACAD';
+    /** The name of the default user command group */
     AcEdCommandStack.DEFAUT_COMMAND_GROUP_NAME = 'USER';
     return AcEdCommandStack;
 }());

package/lib/editor/command/AcEdCommandStack.js.map

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

package/lib/editor/global/eventBus.d.ts

@@ -1,34 +1,103 @@
-import { AcDbConversionStage, AcDbConversionStageStatus } from '@mlightcad/data-model';
+import { AcDbProgressdEventArgs } from '@mlightcad/data-model';
 import { type Emitter } from 'mitt';
 /**
- * Message type
+ * Message severity type for user notifications.
+ *
+ * Used to categorize messages shown to users with appropriate visual styling.
  */
 export type AcEdMessageType = 'success' | 'warning' | 'info' | 'error';
+/**
+ * Progress event arguments for database operations.
+ *
+ * This type represents the progress information for database operations
+ * like opening files, excluding the database reference.
+ */
+export type AcEdOpenFileProgressEventArgs = Omit<AcDbProgressdEventArgs, 'database'>;
+/**
+ * Type definition for all events that can be emitted through the global event bus.
+ *
+ * This type maps event names to their corresponding payload types, providing
+ * type safety for event emission and listening throughout the application.
+ *
+ * ## Event Categories
+ * - **File Operations**: `open-file`, `open-file-progress`, `failed-to-open-file`
+ * - **Font Management**: `font-not-loaded`, `failed-to-get-avaiable-fonts`, `font-not-found`
+ * - **User Messages**: `message`
+ */
 export type AcEdEvents = {
+    /** Emitted to request opening a file dialog */
     'open-file': {};
-    'open-file-progress': {
-        percentage: number;
-        stage: AcDbConversionStage;
-        stageStatus: AcDbConversionStageStatus;
-    };
+    /** Emitted during file opening to report progress */
+    'open-file-progress': AcEdOpenFileProgressEventArgs;
+    /** Emitted to display a message to the user */
     message: {
+        /** The message text to display */
         message: string;
+        /** The severity/type of the message */
         type: AcEdMessageType;
     };
+    /** Emitted when a font fails to load */
     'font-not-loaded': {
+        /** Name of the font that failed to load */
         fontName: string;
+        /** URL where the font was attempted to be loaded from */
         url: string;
     };
+    /** Emitted when the available fonts list cannot be retrieved */
     'failed-to-get-avaiable-fonts': {
+        /** URL where the fonts list was attempted to be retrieved from */
         url: string;
     };
+    /** Emitted when a file fails to open */
     'failed-to-open-file': {
+        /** Name/path of the file that failed to open */
         fileName: string;
     };
+    /** Emitted when a required font is not found */
     'font-not-found': {
+        /** Name of the missing font */
         fontName: string;
+        /** Number of entities that require this font */
         count: number;
     };
 };
+/**
+ * Global event bus for application-wide communication.
+ *
+ * This event bus enables decoupled communication between different parts of the
+ * CAD viewer application. Components can emit events to notify about state changes
+ * or request actions, while other components can listen for these events to respond
+ * appropriately.
+ *
+ * The event bus is particularly useful for:
+ * - File operation status updates
+ * - Error and warning notifications
+ * - Font loading status
+ * - Cross-component communication
+ *
+ * @example
+ * ```typescript
+ * import { eventBus } from './eventBus';
+ *
+ * // Listen for file opening events
+ * eventBus.on('open-file', () => {
+ *   console.log('File open requested');
+ * });
+ *
+ * // Emit a progress update
+ * eventBus.emit('open-file-progress', {
+ *   percentage: 50,
+ *   stage: 'CONVERSION'
+ *   subStage: AcDbConversionStage.Parsing,
+ *   stageStatus: AcDbConversionStageStatus.InProgress
+ * });
+ *
+ * // Display a message to the user
+ * eventBus.emit('message', {
+ *   message: 'File opened successfully',
+ *   type: 'success'
+ * });
+ * ```
+ */
 export declare const eventBus: Emitter<AcEdEvents>;
 //# sourceMappingURL=eventBus.d.ts.map

package/lib/editor/global/eventBus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eventBus.d.ts","sourceRoot":"","sources":["../../../src/editor/global/eventBus.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,uBAAuB,CAAA;AAC9B,OAAa,EAAE,KAAK,OAAO,EAAE,MAAM,MAAM,CAAA;AAEzC;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAA;AAEtE,MAAM,MAAM,UAAU,GAAG;IACvB,WAAW,EAAE,EAAE,CAAA;IACf,oBAAoB,EAAE;QACpB,UAAU,EAAE,MAAM,CAAA;QAClB,KAAK,EAAE,mBAAmB,CAAA;QAC1B,WAAW,EAAE,yBAAyB,CAAA;KACvC,CAAA;IACD,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,eAAe,CAAA;KAAE,CAAA;IACnD,iBAAiB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACpD,8BAA8B,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/C,qBAAqB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,gBAAgB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CACtD,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAsB,CAAA"}
+{"version":3,"file":"eventBus.d.ts","sourceRoot":"","sources":["../../../src/editor/global/eventBus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAa,EAAE,KAAK,OAAO,EAAE,MAAM,MAAM,CAAA;AAEzC;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAA;AAEtE;;;;;GAKG;AACH,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAA;AAEpF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,+CAA+C;IAC/C,WAAW,EAAE,EAAE,CAAA;IACf,qDAAqD;IACrD,oBAAoB,EAAE,6BAA6B,CAAA;IACnD,+CAA+C;IAC/C,OAAO,EAAE;QACP,kCAAkC;QAClC,OAAO,EAAE,MAAM,CAAA;QACf,uCAAuC;QACvC,IAAI,EAAE,eAAe,CAAA;KACtB,CAAA;IACD,wCAAwC;IACxC,iBAAiB,EAAE;QACjB,2CAA2C;QAC3C,QAAQ,EAAE,MAAM,CAAA;QAChB,yDAAyD;QACzD,GAAG,EAAE,MAAM,CAAA;KACZ,CAAA;IACD,gEAAgE;IAChE,8BAA8B,EAAE;QAC9B,kEAAkE;QAClE,GAAG,EAAE,MAAM,CAAA;KACZ,CAAA;IACD,wCAAwC;IACxC,qBAAqB,EAAE;QACrB,gDAAgD;QAChD,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,gDAAgD;IAChD,gBAAgB,EAAE;QAChB,+BAA+B;QAC/B,QAAQ,EAAE,MAAM,CAAA;QAChB,gDAAgD;QAChD,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;CACF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAsB,CAAA"}

package/lib/editor/global/eventBus.js

@@ -1,3 +1,41 @@
 import mitt from 'mitt';
+/**
+ * Global event bus for application-wide communication.
+ *
+ * This event bus enables decoupled communication between different parts of the
+ * CAD viewer application. Components can emit events to notify about state changes
+ * or request actions, while other components can listen for these events to respond
+ * appropriately.
+ *
+ * The event bus is particularly useful for:
+ * - File operation status updates
+ * - Error and warning notifications
+ * - Font loading status
+ * - Cross-component communication
+ *
+ * @example
+ * ```typescript
+ * import { eventBus } from './eventBus';
+ *
+ * // Listen for file opening events
+ * eventBus.on('open-file', () => {
+ *   console.log('File open requested');
+ * });
+ *
+ * // Emit a progress update
+ * eventBus.emit('open-file-progress', {
+ *   percentage: 50,
+ *   stage: 'CONVERSION'
+ *   subStage: AcDbConversionStage.Parsing,
+ *   stageStatus: AcDbConversionStageStatus.InProgress
+ * });
+ *
+ * // Display a message to the user
+ * eventBus.emit('message', {
+ *   message: 'File opened successfully',
+ *   type: 'success'
+ * });
+ * ```
+ */
 export var eventBus = mitt();
 //# sourceMappingURL=eventBus.js.map

package/lib/editor/global/eventBus.js.map

@@ -1 +1 @@
-{"version":3,"file":"eventBus.js","sourceRoot":"","sources":["../../../src/editor/global/eventBus.ts"],"names":[],"mappings":"AAIA,OAAO,IAAsB,MAAM,MAAM,CAAA;AAqBzC,MAAM,CAAC,IAAM,QAAQ,GAAwB,IAAI,EAAc,CAAA"}
+{"version":3,"file":"eventBus.js","sourceRoot":"","sources":["../../../src/editor/global/eventBus.ts"],"names":[],"mappings":"AACA,OAAO,IAAsB,MAAM,MAAM,CAAA;AAkEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,IAAM,QAAQ,GAAwB,IAAI,EAAc,CAAA"}

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