@mlightcad/cad-simple-viewer 1.0.0 → 1.0.1

package/lib/app/AcApSettingManager.js

@@ -1,5 +1,6 @@
 import { AcCmEventManager } from '@mlightcad/data-model';
 import { defaults } from 'lodash-es';
+/** Default values for all application settings */
 var DEFAULT_VALUES = {
     isDebug: false,
     isShowCommandLine: true,
@@ -8,14 +9,57 @@ var DEFAULT_VALUES = {
     isShowStats: false,
     fontMapping: {}
 };
+/** Local storage key for persisting settings */
 var SETTINGS_LS_KEY = 'settings';
+/**
+ * Singleton settings manager for the CAD application.
+ *
+ * This class manages application-wide settings with:
+ * - Persistent storage using localStorage
+ * - Event notification when settings change
+ * - Type-safe setting access
+ * - Default value fallbacks
+ *
+ * The settings are automatically saved to localStorage and restored on application start.
+ *
+ * @template T - The settings interface type, defaults to AcApSettings
+ *
+ * @example
+ * ```typescript
+ * // Get the singleton instance
+ * const settings = AcApSettingManager.instance;
+ *
+ * // Set a setting value
+ * settings.set('isShowToolbar', false);
+ *
+ * // Get a setting value
+ * const showToolbar = settings.get('isShowToolbar');
+ *
+ * // Toggle a boolean setting
+ * settings.toggle('isDebug');
+ *
+ * // Listen for setting changes
+ * settings.events.modified.addEventListener(args => {
+ *   console.log(`Setting ${args.key} changed to:`, args.value);
+ * });
+ * ```
+ */
 var AcApSettingManager = /** @class */ (function () {
     function AcApSettingManager() {
+        /** Events fired when settings are modified */
         this.events = {
+            /** Fired when any setting is modified */
             modified: new AcCmEventManager()
         };
     }
     Object.defineProperty(AcApSettingManager, "instance", {
+        /**
+         * Gets the singleton instance of the settings manager.
+         *
+         * Creates a new instance if one doesn't exist yet.
+         *
+         * @returns The singleton settings manager instance
+         */
         get: function () {
             if (!this._instance) {
                 this._instance = new AcApSettingManager();
@@ -25,6 +69,21 @@ var AcApSettingManager = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
+    /**
+     * Sets a setting value and persists it to localStorage.
+     *
+     * Fires a modified event after the setting is saved.
+     *
+     * @template K - The setting key type
+     * @param key - The setting key to modify
+     * @param value - The new value for the setting
+     *
+     * @example
+     * ```typescript
+     * settings.set('isShowToolbar', false);
+     * settings.set('fontMapping', { 'Arial': 'Helvetica' });
+     * ```
+     */
     AcApSettingManager.prototype.set = function (key, value) {
         var toggles = this.settings;
         toggles[key] = value;
@@ -34,18 +93,57 @@ var AcApSettingManager = /** @class */ (function () {
             value: value
         });
     };
+    /**
+     * Gets a setting value.
+     *
+     * Returns the stored value or the default value if not set.
+     *
+     * @template K - The setting key type
+     * @param key - The setting key to retrieve
+     * @returns The setting value
+     *
+     * @example
+     * ```typescript
+     * const isDebug = settings.get('isDebug');
+     * const fontMapping = settings.get('fontMapping');
+     * ```
+     */
     AcApSettingManager.prototype.get = function (key) {
         return this.settings[key];
     };
+    /**
+     * Toggles a boolean setting value.
+     *
+     * Only works with boolean settings. The caller should ensure the setting is boolean.
+     *
+     * @template K - The setting key type
+     * @param key - The boolean setting key to toggle
+     *
+     * @example
+     * ```typescript
+     * settings.toggle('isDebug');        // false -> true
+     * settings.toggle('isShowToolbar');  // true -> false
+     * ```
+     */
     AcApSettingManager.prototype.toggle = function (key) {
         var value = this.get(key);
         // @ts-expect-error The caller should guarantee the correct feature name passed to this function
         this.set(key, !value);
     };
     Object.defineProperty(AcApSettingManager.prototype, "isDebug", {
+        /**
+         * Gets whether debug mode is enabled.
+         *
+         * @returns True if debug mode is enabled
+         */
         get: function () {
             return this.get('isDebug');
         },
+        /**
+         * Sets whether debug mode is enabled.
+         *
+         * @param value - True to enable debug mode
+         */
         set: function (value) {
             this.set('isDebug', value);
         },
@@ -53,9 +151,19 @@ var AcApSettingManager = /** @class */ (function () {
         configurable: true
     });
     Object.defineProperty(AcApSettingManager.prototype, "isShowCommandLine", {
+        /**
+         * Gets whether the command line is visible.
+         *
+         * @returns True if command line should be shown
+         */
         get: function () {
             return this.get('isShowCommandLine');
         },
+        /**
+         * Sets whether the command line is visible.
+         *
+         * @param value - True to show the command line
+         */
         set: function (value) {
             this.set('isShowCommandLine', value);
         },
@@ -63,9 +171,19 @@ var AcApSettingManager = /** @class */ (function () {
         configurable: true
     });
     Object.defineProperty(AcApSettingManager.prototype, "isShowCoordinate", {
+        /**
+         * Gets whether coordinate display is visible.
+         *
+         * @returns True if coordinates should be displayed
+         */
         get: function () {
             return this.get('isShowCoordinate');
         },
+        /**
+         * Sets whether coordinate display is visible.
+         *
+         * @param value - True to show coordinates
+         */
         set: function (value) {
             this.set('isShowCoordinate', value);
         },
@@ -73,9 +191,19 @@ var AcApSettingManager = /** @class */ (function () {
         configurable: true
     });
     Object.defineProperty(AcApSettingManager.prototype, "isShowToolbar", {
+        /**
+         * Gets whether the toolbar is visible.
+         *
+         * @returns True if toolbar should be shown
+         */
         get: function () {
             return this.get('isShowToolbar');
         },
+        /**
+         * Sets whether the toolbar is visible.
+         *
+         * @param value - True to show the toolbar
+         */
         set: function (value) {
             this.set('isShowToolbar', value);
         },
@@ -83,9 +211,19 @@ var AcApSettingManager = /** @class */ (function () {
         configurable: true
     });
     Object.defineProperty(AcApSettingManager.prototype, "isShowStats", {
+        /**
+         * Gets whether performance statistics are displayed.
+         *
+         * @returns True if stats should be shown
+         */
         get: function () {
             return this.get('isShowStats');
         },
+        /**
+         * Sets whether performance statistics are displayed.
+         *
+         * @param value - True to show stats
+         */
         set: function (value) {
             this.set('isShowStats', value);
         },
@@ -93,21 +231,44 @@ var AcApSettingManager = /** @class */ (function () {
         configurable: true
     });
     Object.defineProperty(AcApSettingManager.prototype, "fontMapping", {
+        /**
+         * Gets the font mapping configuration.
+         *
+         * @returns The current font mapping
+         */
         get: function () {
             return this.get('fontMapping');
         },
+        /**
+         * Sets the font mapping configuration.
+         *
+         * @param value - The new font mapping
+         */
         set: function (value) {
             this.set('fontMapping', value);
         },
         enumerable: false,
         configurable: true
     });
+    /**
+     * Sets a single font mapping entry.
+     *
+     * @param originalFont - The original font name
+     * @param mappedFont - The replacement font name
+     */
     AcApSettingManager.prototype.setFontMapping = function (originalFont, mappedFont) {
         var mapping = this.get('fontMapping');
         mapping[originalFont] = mappedFont;
         this.set('fontMapping', mapping);
     };
     Object.defineProperty(AcApSettingManager.prototype, "settings", {
+        /**
+         * Gets the current settings object.
+         *
+         * This method combines localStorage values with default values.
+         *
+         * @returns The current settings object
+         */
         get: function () {
             var values = localStorage.getItem(SETTINGS_LS_KEY);
             var results = (values == null ? {} : JSON.parse(values));

package/lib/app/AcApSettingManager.js.map

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

package/lib/command/AcApConvertToSvgCmd.d.ts

@@ -1,6 +1,32 @@
 import { AcApContext } from '../app';
 import { AcEdCommand } from '../command';
+/**
+ * Command for converting the current CAD drawing to SVG format.
+ *
+ * This command creates an SVG converter and initiates the conversion
+ * process to export the current drawing as an SVG file. The command:
+ * - Creates a new SVG converter instance
+ * - Converts all entities in the current document to SVG
+ * - Automatically downloads the SVG file
+ *
+ * This is useful for exporting drawings to a web-friendly vector format
+ * that can be displayed in browsers or used in web applications.
+ *
+ * @example
+ * ```typescript
+ * const convertCmd = new AcApConvertToSvgCmd();
+ * convertCmd.execute(context); // Converts and downloads as SVG
+ * ```
+ */
 export declare class AcApConvertToSvgCmd extends AcEdCommand {
+    /**
+     * Executes the SVG conversion command.
+     *
+     * Creates a converter instance and initiates the conversion process
+     * for the current document.
+     *
+     * @param _context - The application context (unused in this command)
+     */
     execute(_context: AcApContext): void;
 }
 //# sourceMappingURL=AcApConvertToSvgCmd.d.ts.map

package/lib/command/AcApConvertToSvgCmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcApConvertToSvgCmd.d.ts","sourceRoot":"","sources":["../../src/command/AcApConvertToSvgCmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,OAAO,CAAC,QAAQ,EAAE,WAAW;CAI9B"}
+{"version":3,"file":"AcApConvertToSvgCmd.d.ts","sourceRoot":"","sources":["../../src/command/AcApConvertToSvgCmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;IAClD;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,EAAE,WAAW;CAI9B"}

package/lib/command/AcApConvertToSvgCmd.js

@@ -15,11 +15,37 @@ var __extends = (this && this.__extends) || (function () {
 })();
 import { AcEdCommand } from '../command';
 import { AcApSvgConvertor } from './AcApSvgConvertor';
+/**
+ * Command for converting the current CAD drawing to SVG format.
+ *
+ * This command creates an SVG converter and initiates the conversion
+ * process to export the current drawing as an SVG file. The command:
+ * - Creates a new SVG converter instance
+ * - Converts all entities in the current document to SVG
+ * - Automatically downloads the SVG file
+ *
+ * This is useful for exporting drawings to a web-friendly vector format
+ * that can be displayed in browsers or used in web applications.
+ *
+ * @example
+ * ```typescript
+ * const convertCmd = new AcApConvertToSvgCmd();
+ * convertCmd.execute(context); // Converts and downloads as SVG
+ * ```
+ */
 var AcApConvertToSvgCmd = /** @class */ (function (_super) {
     __extends(AcApConvertToSvgCmd, _super);
     function AcApConvertToSvgCmd() {
         return _super !== null && _super.apply(this, arguments) || this;
     }
+    /**
+     * Executes the SVG conversion command.
+     *
+     * Creates a converter instance and initiates the conversion process
+     * for the current document.
+     *
+     * @param _context - The application context (unused in this command)
+     */
     AcApConvertToSvgCmd.prototype.execute = function (_context) {
         var converter = new AcApSvgConvertor();
         converter.convert();

package/lib/command/AcApConvertToSvgCmd.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcApConvertToSvgCmd.js","sourceRoot":"","sources":["../../src/command/AcApConvertToSvgCmd.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD;IAAyC,uCAAW;IAApD;;IAKA,CAAC;IAJC,qCAAO,GAAP,UAAQ,QAAqB;QAC3B,IAAM,SAAS,GAAG,IAAI,gBAAgB,EAAE,CAAA;QACxC,SAAS,CAAC,OAAO,EAAE,CAAA;IACrB,CAAC;IACH,0BAAC;AAAD,CAAC,AALD,CAAyC,WAAW,GAKnD"}
+{"version":3,"file":"AcApConvertToSvgCmd.js","sourceRoot":"","sources":["../../src/command/AcApConvertToSvgCmd.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD;;;;;;;;;;;;;;;;;GAiBG;AACH;IAAyC,uCAAW;IAApD;;IAaA,CAAC;IAZC;;;;;;;OAOG;IACH,qCAAO,GAAP,UAAQ,QAAqB;QAC3B,IAAM,SAAS,GAAG,IAAI,gBAAgB,EAAE,CAAA;QACxC,SAAS,CAAC,OAAO,EAAE,CAAA;IACrB,CAAC;IACH,0BAAC;AAAD,CAAC,AAbD,CAAyC,WAAW,GAanD"}

package/lib/command/AcApOpenCmd.d.ts

@@ -1,6 +1,37 @@
 import { AcApContext } from '../app';
 import { AcEdCommand } from '../command';
+/**
+ * Command to open a CAD file.
+ *
+ * This command triggers the file opening workflow by emitting an 'open-file' event
+ * on the global event bus. The actual file opening logic is handled by other
+ * components listening for this event (typically the UI layer).
+ *
+ * The command follows the standard CAD pattern where the command itself is lightweight
+ * and delegates the actual work to specialized handlers.
+ *
+ * @example
+ * ```typescript
+ * const openCommand = new AcApOpenCmd();
+ * openCommand.globalName = 'OPEN';
+ * openCommand.localName = 'Open File';
+ *
+ * // Trigger the command
+ * openCommand.trigger(docManager.context);
+ *
+ * // The command will emit 'open-file' event for UI components to handle
+ * ```
+ */
 export declare class AcApOpenCmd extends AcEdCommand {
+    /**
+     * Executes the open file command.
+     *
+     * Emits an 'open-file' event on the global event bus to trigger
+     * the file opening workflow. UI components typically listen for
+     * this event to display file selection dialogs.
+     *
+     * @param _context - The current application context (not used in this command)
+     */
     execute(_context: AcApContext): void;
 }
 //# sourceMappingURL=AcApOpenCmd.d.ts.map

package/lib/command/AcApOpenCmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcApOpenCmd.d.ts","sourceRoot":"","sources":["../../src/command/AcApOpenCmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,qBAAa,WAAY,SAAQ,WAAW;IAC1C,OAAO,CAAC,QAAQ,EAAE,WAAW;CAG9B"}
+{"version":3,"file":"AcApOpenCmd.d.ts","sourceRoot":"","sources":["../../src/command/AcApOpenCmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,EAAE,WAAW;CAG9B"}

package/lib/command/AcApOpenCmd.js

@@ -15,11 +15,42 @@ var __extends = (this && this.__extends) || (function () {
 })();
 import { AcEdCommand } from '../command';
 import { eventBus } from '../editor';
+/**
+ * Command to open a CAD file.
+ *
+ * This command triggers the file opening workflow by emitting an 'open-file' event
+ * on the global event bus. The actual file opening logic is handled by other
+ * components listening for this event (typically the UI layer).
+ *
+ * The command follows the standard CAD pattern where the command itself is lightweight
+ * and delegates the actual work to specialized handlers.
+ *
+ * @example
+ * ```typescript
+ * const openCommand = new AcApOpenCmd();
+ * openCommand.globalName = 'OPEN';
+ * openCommand.localName = 'Open File';
+ *
+ * // Trigger the command
+ * openCommand.trigger(docManager.context);
+ *
+ * // The command will emit 'open-file' event for UI components to handle
+ * ```
+ */
 var AcApOpenCmd = /** @class */ (function (_super) {
     __extends(AcApOpenCmd, _super);
     function AcApOpenCmd() {
         return _super !== null && _super.apply(this, arguments) || this;
     }
+    /**
+     * Executes the open file command.
+     *
+     * Emits an 'open-file' event on the global event bus to trigger
+     * the file opening workflow. UI components typically listen for
+     * this event to display file selection dialogs.
+     *
+     * @param _context - The current application context (not used in this command)
+     */
     AcApOpenCmd.prototype.execute = function (_context) {
         eventBus.emit('open-file', {});
     };

package/lib/command/AcApOpenCmd.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcApOpenCmd.js","sourceRoot":"","sources":["../../src/command/AcApOpenCmd.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC;IAAiC,+BAAW;IAA5C;;IAIA,CAAC;IAHC,6BAAO,GAAP,UAAQ,QAAqB;QAC3B,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IAChC,CAAC;IACH,kBAAC;AAAD,CAAC,AAJD,CAAiC,WAAW,GAI3C"}
+{"version":3,"file":"AcApOpenCmd.js","sourceRoot":"","sources":["../../src/command/AcApOpenCmd.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;IAAiC,+BAAW;IAA5C;;IAaA,CAAC;IAZC;;;;;;;;OAQG;IACH,6BAAO,GAAP,UAAQ,QAAqB;QAC3B,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IAChC,CAAC;IACH,kBAAC;AAAD,CAAC,AAbD,CAAiC,WAAW,GAa3C"}

package/lib/command/AcApPanCmd.d.ts

@@ -1,6 +1,31 @@
 import { AcApContext } from '../app';
 import { AcEdCommand } from '../command';
+/**
+ * Command for enabling pan mode in the CAD viewer.
+ *
+ * This command switches the view to pan mode, allowing users to drag
+ * and move the drawing around the canvas. When executed, it:
+ * - Sets the view mode to PAN
+ * - Changes the cursor to a grab cursor for visual feedback
+ *
+ * Pan mode allows users to click and drag to move the viewport,
+ * providing an intuitive way to navigate large drawings.
+ *
+ * @example
+ * ```typescript
+ * const panCmd = new AcApPanCmd();
+ * panCmd.execute(context); // Enables pan mode
+ * ```
+ */
 export declare class AcApPanCmd extends AcEdCommand {
+    /**
+     * Executes the pan command.
+     *
+     * Sets the view to pan mode and updates the cursor appearance
+     * to indicate that panning is active.
+     *
+     * @param context - The application context containing the view
+     */
     execute(context: AcApContext): void;
 }
 //# sourceMappingURL=AcApPanCmd.d.ts.map

package/lib/command/AcApPanCmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcApPanCmd.d.ts","sourceRoot":"","sources":["../../src/command/AcApPanCmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,qBAAa,UAAW,SAAQ,WAAW;IACzC,OAAO,CAAC,OAAO,EAAE,WAAW;CAI7B"}
+{"version":3,"file":"AcApPanCmd.d.ts","sourceRoot":"","sources":["../../src/command/AcApPanCmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW;CAI7B"}

package/lib/command/AcApPanCmd.js

@@ -15,11 +15,36 @@ var __extends = (this && this.__extends) || (function () {
 })();
 import { AcEdCommand } from '../command';
 import { AcEdCorsorType, AcEdViewMode } from '../editor';
+/**
+ * Command for enabling pan mode in the CAD viewer.
+ *
+ * This command switches the view to pan mode, allowing users to drag
+ * and move the drawing around the canvas. When executed, it:
+ * - Sets the view mode to PAN
+ * - Changes the cursor to a grab cursor for visual feedback
+ *
+ * Pan mode allows users to click and drag to move the viewport,
+ * providing an intuitive way to navigate large drawings.
+ *
+ * @example
+ * ```typescript
+ * const panCmd = new AcApPanCmd();
+ * panCmd.execute(context); // Enables pan mode
+ * ```
+ */
 var AcApPanCmd = /** @class */ (function (_super) {
     __extends(AcApPanCmd, _super);
     function AcApPanCmd() {
         return _super !== null && _super.apply(this, arguments) || this;
     }
+    /**
+     * Executes the pan command.
+     *
+     * Sets the view to pan mode and updates the cursor appearance
+     * to indicate that panning is active.
+     *
+     * @param context - The application context containing the view
+     */
     AcApPanCmd.prototype.execute = function (context) {
         context.view.mode = AcEdViewMode.PAN;
         context.view.setCursor(AcEdCorsorType.Grab);

package/lib/command/AcApPanCmd.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcApPanCmd.js","sourceRoot":"","sources":["../../src/command/AcApPanCmd.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAExD;IAAgC,8BAAW;IAA3C;;IAKA,CAAC;IAJC,4BAAO,GAAP,UAAQ,OAAoB;QAC1B,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,GAAG,CAAA;QACpC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;IAC7C,CAAC;IACH,iBAAC;AAAD,CAAC,AALD,CAAgC,WAAW,GAK1C"}
+{"version":3,"file":"AcApPanCmd.js","sourceRoot":"","sources":["../../src/command/AcApPanCmd.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH;IAAgC,8BAAW;IAA3C;;IAaA,CAAC;IAZC;;;;;;;OAOG;IACH,4BAAO,GAAP,UAAQ,OAAoB;QAC1B,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,GAAG,CAAA;QACpC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;IAC7C,CAAC;IACH,iBAAC;AAAD,CAAC,AAbD,CAAgC,WAAW,GAa1C"}

package/lib/command/AcApQNewCmd.d.ts

@@ -1,6 +1,32 @@
 import { AcApContext } from '../app';
 import { AcEdCommand } from '../command';
+/**
+ * Command for creating a new CAD document from a template.
+ *
+ * This command opens a predefined template drawing (acadiso.dxf) from
+ * a CDN to create a new document. The template provides:
+ * - Standard ISO drawing settings
+ * - Predefined layers and styles
+ * - Default drawing setup
+ *
+ * This is equivalent to "Quick New" functionality in traditional CAD applications,
+ * providing users with a ready-to-use drawing environment.
+ *
+ * @example
+ * ```typescript
+ * const qNewCmd = new AcApQNewCmd();
+ * qNewCmd.execute(context); // Creates new document from template
+ * ```
+ */
 export declare class AcApQNewCmd extends AcEdCommand {
+    /**
+     * Executes the quick new command.
+     *
+     * Opens the ISO template from the CDN to create a new document
+     * with standard drawing settings.
+     *
+     * @param _context - The application context (unused in this command)
+     */
     execute(_context: AcApContext): void;
 }
 //# sourceMappingURL=AcApQNewCmd.d.ts.map

package/lib/command/AcApQNewCmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcApQNewCmd.d.ts","sourceRoot":"","sources":["../../src/command/AcApQNewCmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,qBAAa,WAAY,SAAQ,WAAW;IAC1C,OAAO,CAAC,QAAQ,EAAE,WAAW;CAI9B"}
+{"version":3,"file":"AcApQNewCmd.d.ts","sourceRoot":"","sources":["../../src/command/AcApQNewCmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,EAAE,WAAW;CAI9B"}

package/lib/command/AcApQNewCmd.js

@@ -15,11 +15,37 @@ var __extends = (this && this.__extends) || (function () {
 })();
 import { AcApDocManager } from '../app';
 import { AcEdCommand } from '../command';
+/**
+ * Command for creating a new CAD document from a template.
+ *
+ * This command opens a predefined template drawing (acadiso.dxf) from
+ * a CDN to create a new document. The template provides:
+ * - Standard ISO drawing settings
+ * - Predefined layers and styles
+ * - Default drawing setup
+ *
+ * This is equivalent to "Quick New" functionality in traditional CAD applications,
+ * providing users with a ready-to-use drawing environment.
+ *
+ * @example
+ * ```typescript
+ * const qNewCmd = new AcApQNewCmd();
+ * qNewCmd.execute(context); // Creates new document from template
+ * ```
+ */
 var AcApQNewCmd = /** @class */ (function (_super) {
     __extends(AcApQNewCmd, _super);
     function AcApQNewCmd() {
         return _super !== null && _super.apply(this, arguments) || this;
     }
+    /**
+     * Executes the quick new command.
+     *
+     * Opens the ISO template from the CDN to create a new document
+     * with standard drawing settings.
+     *
+     * @param _context - The application context (unused in this command)
+     */
     AcApQNewCmd.prototype.execute = function (_context) {
         var baseUrl = 'https://cdn.jsdelivr.net/gh/mlight-lee/cad-data/templates/';
         AcApDocManager.instance.openUrl(baseUrl + 'acadiso.dxf');

package/lib/command/AcApQNewCmd.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcApQNewCmd.js","sourceRoot":"","sources":["../../src/command/AcApQNewCmd.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC;IAAiC,+BAAW;IAA5C;;IAKA,CAAC;IAJC,6BAAO,GAAP,UAAQ,QAAqB;QAC3B,IAAM,OAAO,GAAG,4DAA4D,CAAA;QAC5E,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,GAAG,aAAa,CAAC,CAAA;IAC1D,CAAC;IACH,kBAAC;AAAD,CAAC,AALD,CAAiC,WAAW,GAK3C"}
+{"version":3,"file":"AcApQNewCmd.js","sourceRoot":"","sources":["../../src/command/AcApQNewCmd.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC;;;;;;;;;;;;;;;;;GAiBG;AACH;IAAiC,+BAAW;IAA5C;;IAaA,CAAC;IAZC;;;;;;;OAOG;IACH,6BAAO,GAAP,UAAQ,QAAqB;QAC3B,IAAM,OAAO,GAAG,4DAA4D,CAAA;QAC5E,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,GAAG,aAAa,CAAC,CAAA;IAC1D,CAAC;IACH,kBAAC;AAAD,CAAC,AAbD,CAAiC,WAAW,GAa3C"}

package/lib/command/AcApSelectCmd.d.ts

@@ -1,6 +1,32 @@
 import { AcApContext } from '../app';
 import { AcEdCommand } from '../command';
+/**
+ * Command for enabling selection mode in the CAD viewer.
+ *
+ * This command switches the view to selection mode, allowing users to
+ * select CAD entities by clicking on them. When executed, it:
+ * - Sets the view mode to SELECTION
+ * - Changes the cursor to a crosshair for precise selection
+ *
+ * In selection mode, users can click on entities to select them,
+ * which will add them to the selection set and typically show
+ * grip points for manipulation.
+ *
+ * @example
+ * ```typescript
+ * const selectCmd = new AcApSelectCmd();
+ * selectCmd.execute(context); // Enables selection mode
+ * ```
+ */
 export declare class AcApSelectCmd extends AcEdCommand {
+    /**
+     * Executes the select command.
+     *
+     * Sets the view to selection mode and updates the cursor appearance
+     * to indicate that entity selection is active.
+     *
+     * @param context - The application context containing the view
+     */
     execute(context: AcApContext): void;
 }
 //# sourceMappingURL=AcApSelectCmd.d.ts.map

package/lib/command/AcApSelectCmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcApSelectCmd.d.ts","sourceRoot":"","sources":["../../src/command/AcApSelectCmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,qBAAa,aAAc,SAAQ,WAAW;IAC5C,OAAO,CAAC,OAAO,EAAE,WAAW;CAI7B"}
+{"version":3,"file":"AcApSelectCmd.d.ts","sourceRoot":"","sources":["../../src/command/AcApSelectCmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW;CAI7B"}