@mlightcad/cad-simple-viewer 1.4.7 → 1.4.8

package/lib/app/AcApAnnotation.d.ts

@@ -0,0 +1,46 @@
+import { AcCmColor, AcDbDatabase, AcDbObject, AcDbObjectId } from '@mlightcad/data-model';
+export declare class AcApAnnotation {
+    /**
+     * Default annotation color is red
+     */
+    static DEFAULT_ANNOTATION_COLOR: AcCmColor;
+    private _database;
+    constructor(db: AcDbDatabase);
+    /**
+     * Finds or creates a annotation layer identified by MLightCAD-specific XData.
+     *
+     * This method enforces the concept of a *singleton annotation layer* in a drawing.
+     * It first scans all existing layers and looks for one whose XData contains
+     * a description value of `"mlightcad"` under the registered application name
+     * `"mlightcad"`.
+     *
+     * Behavior:
+     * - If such a layer already exists, its name is returned and **no new layer
+     *   is created**.
+     * - If no matching layer is found, a new layer is created with:
+     *   - A unique name using the prefix `"$revision_"` followed by a numeric index
+     *     (e.g. `$revision_1`, `$revision_2`, …)
+     *   - Yellow color (ACI = 2)
+     *   - Layer turned on and plottable
+     *   - XData attached to mark it as an MLightCAD annotation layer
+     *
+     * XData layout:
+     * - RegApp name: `"mlightcad"`
+     * - Description (ASCII string): `"mlightcad"`
+     *
+     * The attached XData allows the annotation layer to be reliably identified even
+     * if the layer is renamed by the user.
+     *
+     * @returns The name of the existing or newly created annotation layer.
+     */
+    getAnnotationLayer(): string;
+    filterAnnotationEntities(ids: AcDbObjectId[]): string[];
+    /**
+     * Returns true if the specified object contains annotation xdata, which means
+     * it is only object created by annotation related commands.
+     * @param object - Object to check whether it contains annotation xdata.
+     * @returns Returns true if the specified object contains annotation xdata.
+     */
+    hasAnnotationXData(object: AcDbObject): boolean;
+}
+//# sourceMappingURL=AcApAnnotation.d.ts.map

package/lib/app/AcApAnnotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApAnnotation.d.ts","sourceRoot":"","sources":["../../src/app/AcApAnnotation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAET,YAAY,EAGZ,UAAU,EACV,YAAY,EAEb,MAAM,uBAAuB,CAAA;AAE9B,qBAAa,cAAc;IACzB;;OAEG;IACH,MAAM,CAAC,wBAAwB,YAA0C;IACzE,OAAO,CAAC,SAAS,CAAc;gBAEnB,EAAE,EAAE,YAAY;IAI5B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACI,kBAAkB,IAAI,MAAM;IAyCnC,wBAAwB,CAAC,GAAG,EAAE,YAAY,EAAE;IAQ5C;;;;;OAKG;IACI,kBAAkB,CAAC,MAAM,EAAE,UAAU;CAgB7C"}

package/lib/app/AcApAnnotation.js

@@ -0,0 +1,134 @@
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+import { AcCmColor, AcCmColorMethod, AcDbDatabase, AcDbLayerTableRecord, AcDbResultBuffer } from '@mlightcad/data-model';
+var AcApAnnotation = /** @class */ (function () {
+    function AcApAnnotation(db) {
+        this._database = db;
+    }
+    /**
+     * Finds or creates a annotation layer identified by MLightCAD-specific XData.
+     *
+     * This method enforces the concept of a *singleton annotation layer* in a drawing.
+     * It first scans all existing layers and looks for one whose XData contains
+     * a description value of `"mlightcad"` under the registered application name
+     * `"mlightcad"`.
+     *
+     * Behavior:
+     * - If such a layer already exists, its name is returned and **no new layer
+     *   is created**.
+     * - If no matching layer is found, a new layer is created with:
+     *   - A unique name using the prefix `"$revision_"` followed by a numeric index
+     *     (e.g. `$revision_1`, `$revision_2`, …)
+     *   - Yellow color (ACI = 2)
+     *   - Layer turned on and plottable
+     *   - XData attached to mark it as an MLightCAD annotation layer
+     *
+     * XData layout:
+     * - RegApp name: `"mlightcad"`
+     * - Description (ASCII string): `"mlightcad"`
+     *
+     * The attached XData allows the annotation layer to be reliably identified even
+     * if the layer is renamed by the user.
+     *
+     * @returns The name of the existing or newly created annotation layer.
+     */
+    AcApAnnotation.prototype.getAnnotationLayer = function () {
+        var e_1, _a;
+        var prefix = '$revision_';
+        var appId = AcDbDatabase.MLIGHTCAD_APPID;
+        var layerTable = this._database.tables.layerTable;
+        try {
+            // 1. Try to find an existing annotation layer by XData
+            for (var _b = __values(layerTable.newIterator()), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var layer = _c.value;
+                if (this.hasAnnotationXData(layer))
+                    return layer.name;
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        // 2. Generate a unique layer name
+        var index = 1;
+        var layerName = "".concat(prefix).concat(index);
+        while (layerTable.has(layerName)) {
+            index++;
+            layerName = "".concat(prefix).concat(index);
+        }
+        // 3. Create the layer
+        var record = new AcDbLayerTableRecord({
+            name: layerName,
+            isOff: false,
+            // Use red color as default color
+            color: new AcCmColor(AcCmColorMethod.ByACI, 1),
+            isPlottable: true
+        });
+        // 4. Attach XData
+        var xdata = new AcDbResultBuffer([
+            { code: 1001 /* AcDbDxfCode.ExtendedDataRegAppName */, value: appId },
+            { code: 1000 /* AcDbDxfCode.ExtendedDataAsciiString */, value: appId }
+        ]);
+        record.setXData(xdata);
+        layerTable.add(record);
+        return layerName;
+    };
+    AcApAnnotation.prototype.filterAnnotationEntities = function (ids) {
+        var _this = this;
+        var layerName = this.getAnnotationLayer();
+        return ids.filter(function (id) {
+            var entity = _this._database.tables.blockTable.getEntityById(id);
+            return entity && entity.layer == layerName;
+        });
+    };
+    /**
+     * Returns true if the specified object contains annotation xdata, which means
+     * it is only object created by annotation related commands.
+     * @param object - Object to check whether it contains annotation xdata.
+     * @returns Returns true if the specified object contains annotation xdata.
+     */
+    AcApAnnotation.prototype.hasAnnotationXData = function (object) {
+        var e_2, _a;
+        var appId = AcDbDatabase.MLIGHTCAD_APPID;
+        var xdata = object.getXData(appId);
+        if (!xdata)
+            return false;
+        try {
+            // Look for Description string == 'mlightcad'
+            for (var xdata_1 = __values(xdata), xdata_1_1 = xdata_1.next(); !xdata_1_1.done; xdata_1_1 = xdata_1.next()) {
+                var tv = xdata_1_1.value;
+                if (tv.code === 1000 /* AcDbDxfCode.ExtendedDataAsciiString */ &&
+                    tv.value === appId) {
+                    return true;
+                }
+            }
+        }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (xdata_1_1 && !xdata_1_1.done && (_a = xdata_1.return)) _a.call(xdata_1);
+            }
+            finally { if (e_2) throw e_2.error; }
+        }
+        return false;
+    };
+    /**
+     * Default annotation color is red
+     */
+    AcApAnnotation.DEFAULT_ANNOTATION_COLOR = new AcCmColor(AcCmColorMethod.ByACI, 1);
+    return AcApAnnotation;
+}());
+export { AcApAnnotation };
+//# sourceMappingURL=AcApAnnotation.js.map

package/lib/app/AcApAnnotation.js.map

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

package/lib/app/AcApDocManager.d.ts

@@ -1,8 +1,10 @@
-import { AcCmEventManager, AcDbOpenDatabaseOptions } from '@mlightcad/data-model';
+import { AcCmEventManager } from '@mlightcad/data-model';
 import { AcEdCommandStack } from '../command';
+import { AcApPluginManager } from '../plugin/AcApPluginManager';
 import { AcTrView2d } from '../view';
 import { AcApContext } from './AcApContext';
 import { AcApDocument } from './AcApDocument';
+import { AcApOpenDatabaseOptions } from './AcDbOpenDatabaseOptions';
 /**
  * Event arguments for document-related events.
  */
@@ -80,6 +82,55 @@ export interface AcApDocManagerOptions {
      * URLs for Web Worker JavaScript bundles used by the CAD viewer.
      */
     webworkerFileUrls?: AcApWebworkerFiles;
+    /**
+     * Configuration for automatic plugin loading.
+     *
+     * Plugins can be loaded automatically during initialization from:
+     * - A configuration array of plugin instances or factory functions
+     * - A folder path with a list of plugin files to load
+     *
+     * @example
+     * ```typescript
+     * // Load plugins from configuration
+     * AcApDocManager.createInstance({
+     *   plugins: {
+     *     fromConfig: [
+     *       new MyPlugin1(),
+     *       () => new MyPlugin2()
+     *     ]
+     *   }
+     * });
+     *
+     * // Load plugins from folder
+     * AcApDocManager.createInstance({
+     *   plugins: {
+     *     fromFolder: {
+     *       folderPath: './plugins',
+     *       pluginList: ['Plugin1.js', 'Plugin2.js'],
+     *       continueOnError: true
+     *     }
+     *   }
+     * });
+     * ```
+     */
+    plugins?: {
+        /**
+         * Load plugins from a configuration array.
+         * Each item can be a plugin instance or a factory function that returns a plugin.
+         */
+        fromConfig?: Array<import('../plugin/AcApPlugin').AcApPlugin | (() => import('../plugin/AcApPlugin').AcApPlugin)>;
+        /**
+         * Load plugins from a folder using dynamic imports.
+         */
+        fromFolder?: {
+            /** Path to the folder containing plugin files */
+            folderPath: string;
+            /** List of plugin file names to load */
+            pluginList: string[];
+            /** Continue loading other plugins if one fails (default: false) */
+            continueOnError?: boolean;
+        };
+    };
 }
 /**
  * Document manager that handles CAD document lifecycle and provides the main entry point for the CAD viewer.
@@ -104,6 +155,8 @@ export declare class AcApDocManager {
     private _progress;
     /** Command manager */
     private _commandManager;
+    /** Plugin manager */
+    private _pluginManager;
     /** Singleton instance */
     private static _instance?;
     /** Events fired during document lifecycle */
@@ -142,9 +195,9 @@ export declare class AcApDocManager {
      */
     static get instance(): AcApDocManager;
     /**
-     * Destroy the view
+     * Destroy the view and unload all plugins
      */
-    destroy(): void;
+    destroy(): Promise<void>;
     /**
      * Gets the current application context.
      *
@@ -186,6 +239,12 @@ export declare class AcApDocManager {
      * @returns The command manager
      */
     get commandManager(): AcEdCommandStack;
+    /**
+     * Gets plugin manager to load and unload plugins
+     *
+     * @returns The plugin manager
+     */
+    get pluginManager(): AcApPluginManager;
     /**
      * Base URL to load fonts
      */
@@ -258,7 +317,7 @@ export declare class AcApDocManager {
      * }
      * ```
      */
-    openUrl(url: string, options?: AcDbOpenDatabaseOptions): Promise<boolean>;
+    openUrl(url: string, options?: AcApOpenDatabaseOptions): Promise<boolean>;
     /**
      * Opens a CAD document from file content.
      *
@@ -277,12 +336,53 @@ export declare class AcApDocManager {
      * const success = await docManager.openDocument('drawing.dwg', fileContent, options);
      * ```
      */
-    openDocument(fileName: string, content: ArrayBuffer, options: AcDbOpenDatabaseOptions): Promise<boolean>;
+    openDocument(fileName: string, content: ArrayBuffer, options: AcApOpenDatabaseOptions): Promise<boolean>;
     /**
      * Redraws the current view. Currently it is used once you modified font mapping
      * for missed fonts so that the drawing can apply new fonts.
      */
     regen(): void;
+    /**
+     * Search through all of the local and translated names in all of the command groups in the command stack
+     * starting at the top of the stack trying to find a match with cmdName. If a match is found, the 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.
+     *
+     * The command which is compatible with the open mode of the current document is only returned
+     *
+     * @param cmdName - Input the command name to search for
+     * @returns Return the matched AcEdCommand object if a match is found and compatible with the open mode of
+     * the current document. Otherwise, return undefined.
+     */
+    lookupLocalCmd(cmdName: string): import("../command").AcEdCommand<{}> | undefined;
+    /**
+     * Search through all of the global and untranslated names in all of the command groups in the command
+     * stack starting at the top of the stack trying to find a match with cmdName. If a match is found, the
+     * 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.
+     *
+     * The command is only returned if it is compatible with that open mode of the current document.
+     * Higher value modes are compatible with lower value modes.
+     *
+     * @param cmdName - Input the command name to search for
+     * @returns Return the matched AcEdCommand object if a match is found and compatible with the open mode
+     * of the current document. Otherwise, return undefined.
+     */
+    lookupGlobalCmd(cmdName: string): import("../command").AcEdCommand<{}> | undefined;
+    /**
+     * Fuzzy search for commands by prefix using the command iterator.
+     *
+     * This method iterates through all commands in all command groups and returns those
+     * whose global or local names start with the provided prefix. The search is case-insensitive.
+     * Only commands which are compatible with that open mode of the current document are returned.
+     * Higher value modes are compatible with lower value modes.
+     *
+     * @param prefix - The prefix string to search for. Case-insensitive.
+     * @returns An array of objects containing matched commands and their corresponding group names.
+     */
+    searchCommandsByPrefix(prefix: string): import("../editor/command/AcEdCommandIterator").AcEdCommandIteratorItem[];
     /**
      * Registers all default commands available in the CAD viewer.
      *
@@ -303,9 +403,11 @@ export declare class AcApDocManager {
      * Executes a command by its string name.
      *
      * This method looks up a registered command by name and executes it with the current context.
-     * If the command is not found, no action is taken.
+     * It checks if the command's required mode is compatible with the document's current mode.
+     * If the command is not found or not compatible, an error is thrown.
      *
      * @param cmdStr - The command string to execute (e.g., 'pan', 'zoom', 'select')
+     * @throws {Error} If the command is not found or if the command's mode is not compatible with the document's mode
      *
      * @example
      * ```typescript
@@ -383,5 +485,15 @@ export declare class AcApDocManager {
      * initialization are handled inside the respective registration routines.
      */
     private registerWorkers;
+    /**
+     * Loads plugins automatically based on the provided configuration.
+     *
+     * This method is called during initialization if plugins are configured.
+     * It supports loading from both configuration arrays and folder paths.
+     *
+     * @param pluginsConfig - Plugin loading configuration
+     * @private
+     */
+    private loadPlugins;
 }
 //# sourceMappingURL=AcApDocManager.d.ts.map

package/lib/app/AcApDocManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcApDocManager.d.ts","sourceRoot":"","sources":["../../src/app/AcApDocManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAKhB,uBAAuB,EAIxB,MAAM,uBAAuB,CAAA;AAI9B,OAAO,EAeL,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAM7C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,GAAG,EAAE,YAAY,CAAA;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;IAExB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;IAExB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAE3B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B;;OAEG;IACH,iBAAiB,CAAC,EAAE,kBAAkB,CAAA;CACvC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IACzB,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAa;IAC7B,8CAA8C;IAC9C,OAAO,CAAC,WAAW,CAAgB;IACnC,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAQ;IACxB,yBAAyB;IACzB,OAAO,CAAC,SAAS,CAAc;IAC/B,sBAAsB;IACtB,OAAO,CAAC,eAAe,CAAkB;IACzC,yBAAyB;IACzB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAgB;IAEzC,6CAA6C;IAC7C,SAAgB,MAAM;QACpB,2CAA2C;;QAE3C,2CAA2C;;MAE5C;IAED;;;;;;;;OAQG;IACH,OAAO;IAoEP;;;;;;;;OAQG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,GAAE,qBAA0B;IAOzD;;;;;;OAMG;IACH,MAAM,KAAK,QAAQ,mBAKlB;IAED;;OAEG;IACH,OAAO;IAIP;;;;;;OAMG;IACH,IAAI,OAAO,gBAEV;IAED;;;;OAIG;IACH,IAAI,WAAW,iBAEd;IAED;;;;;;;OAOG;IACH,IAAI,iBAAiB,iBAEpB;IAED;;;;OAIG;IACH,IAAI,OAAO,IACoB,UAAU,CACxC;IAED;;;;OAIG;IACH,IAAI,MAAM,iCAET;IAED;;;;OAIG;IACH,IAAI,cAAc,qBAEjB;IAED;;OAEG;IACH,IAAI,OAAO,WAEV;IAED;;;;;;OAMG;IACH,IAAI,aAAa,mDAEhB;IAED;;;;;;;;;;OAUG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE;IAI/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE;IAQvC;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB;IAS5D;;;;;;;;;;;;;;;;;OAiBG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,uBAAuB;IAclC;;;OAGG;IACH,KAAK;IAKL;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,gBAAgB;IA6FxB;;;;;;;;;;;;;OAaG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM;IAKlC;;;;;OAKG;IACH,eAAe;IAMf;;;;;;;OAOG;IACH,SAAS,CAAC,oBAAoB;IAI9B;;;;;;;;;OASG;IACH,SAAS,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO;IAgBhD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,UAAU;IASlB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAmBtB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,kBAAkB;IAsC1B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,eAAe;CAQxB"}
+{"version":3,"file":"AcApDocManager.d.ts","sourceRoot":"","sources":["../../src/app/AcApDocManager.ts"],"names":[],"mappings":"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"}

package/lib/app/AcApDocManager.js

@@ -37,9 +37,10 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 import { AcCmEventManager, AcDbDatabaseConverterManager, AcDbDxfConverter, AcDbFileType, acdbHostApplicationServices, AcDbSysVarManager, AcGeBox2d } from '@mlightcad/data-model';
 import { AcDbLibreDwgConverter } from '@mlightcad/libredwg-converter';
 import { AcTrMTextRenderer } from '@mlightcad/three-renderer';
-import { AcApCircleCmd, AcApConvertToSvgCmd, AcApDimLinearCmd, AcApEraseCmd, AcApLineCmd, AcApLogCmd, AcApOpenCmd, AcApPanCmd, AcApQNewCmd, AcApRegenCmd, AcApSelectCmd, AcApSysVarCmd, AcApZoomCmd, AcApZoomToBoxCmd, AcEdCommandStack } from '../command';
-import { eventBus } from '../editor';
+import { AcApCircleCmd, AcApConvertToSvgCmd, AcApDimLinearCmd, AcApEraseCmd, AcApLineCmd, AcApLogCmd, AcApOpenCmd, AcApPanCmd, AcApQNewCmd, AcApRectCmd, AcApRegenCmd, AcApRevCircleCmd, AcApRevCloudCmd, AcApRevRectCmd, AcApRevVisibilityCmd, AcApSelectCmd, AcApSketchCmd, AcApSwitchBgCmd, AcApSysVarCmd, AcApZoomCmd, AcApZoomToBoxCmd, AcEdCommandStack } from '../command';
+import { AcEdOpenMode, eventBus } from '../editor';
 import { AcApI18n } from '../i18n';
+import { AcApPluginManager } from '../plugin/AcApPluginManager';
 import { AcTrView2d } from '../view';
 import { AcApContext } from './AcApContext';
 import { AcApDocument } from './AcApDocument';
@@ -136,12 +137,17 @@ var AcApDocManager = /** @class */ (function () {
         acdbHostApplicationServices().workingDatabase = doc.database;
         this._commandManager = new AcEdCommandStack();
         this.registerCommands();
+        this._pluginManager = new AcApPluginManager(this._context, this._commandManager);
         this._progress = new AcApProgress();
         this._progress.hide();
         if (!options.notLoadDefaultFonts) {
             this.loadDefaultFonts();
         }
         this.registerWorkers(options.webworkerFileUrls);
+        // Load plugins asynchronously (don't await to avoid blocking initialization)
+        this.loadPlugins(options.plugins).catch(function (error) {
+            console.error('[AcApDocManager] Error loading plugins:', error);
+        });
     }
     /**
      * Creates the singleton instance with an optional canvas element.
@@ -177,10 +183,20 @@ var AcApDocManager = /** @class */ (function () {
         configurable: true
     });
     /**
-     * Destroy the view
+     * Destroy the view and unload all plugins
      */
     AcApDocManager.prototype.destroy = function () {
-        AcApDocManager._instance = undefined;
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this._pluginManager.unloadAllPlugins()];
+                    case 1:
+                        _a.sent();
+                        AcApDocManager._instance = undefined;
+                        return [2 /*return*/];
+                }
+            });
+        });
     };
     Object.defineProperty(AcApDocManager.prototype, "context", {
         /**
@@ -259,6 +275,18 @@ var AcApDocManager = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(AcApDocManager.prototype, "pluginManager", {
+        /**
+         * Gets plugin manager to load and unload plugins
+         *
+         * @returns The plugin manager
+         */
+        get: function () {
+            return this._pluginManager;
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(AcApDocManager.prototype, "baseUrl", {
         /**
          * Base URL to load fonts
@@ -432,6 +460,53 @@ var AcApDocManager = /** @class */ (function () {
         this.curView.clear();
         this.context.doc.database.regen();
     };
+    /**
+     * Search through all of the local and translated names in all of the command groups in the command stack
+     * starting at the top of the stack trying to find a match with cmdName. If a match is found, the 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.
+     *
+     * The command which is compatible with the open mode of the current document is only returned
+     *
+     * @param cmdName - Input the command name to search for
+     * @returns Return the matched AcEdCommand object if a match is found and compatible with the open mode of
+     * the current document. Otherwise, return undefined.
+     */
+    AcApDocManager.prototype.lookupLocalCmd = function (cmdName) {
+        return this._commandManager.lookupLocalCmd(cmdName, this.curDocument.openMode);
+    };
+    /**
+     * Search through all of the global and untranslated names in all of the command groups in the command
+     * stack starting at the top of the stack trying to find a match with cmdName. If a match is found, the
+     * 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.
+     *
+     * The command is only returned if it is compatible with that open mode of the current document.
+     * Higher value modes are compatible with lower value modes.
+     *
+     * @param cmdName - Input the command name to search for
+     * @returns Return the matched AcEdCommand object if a match is found and compatible with the open mode
+     * of the current document. Otherwise, return undefined.
+     */
+    AcApDocManager.prototype.lookupGlobalCmd = function (cmdName) {
+        return this._commandManager.lookupGlobalCmd(cmdName, this.curDocument.openMode);
+    };
+    /**
+     * Fuzzy search for commands by prefix using the command iterator.
+     *
+     * This method iterates through all commands in all command groups and returns those
+     * whose global or local names start with the provided prefix. The search is case-insensitive.
+     * Only commands which are compatible with that open mode of the current document are returned.
+     * Higher value modes are compatible with lower value modes.
+     *
+     * @param prefix - The prefix string to search for. Case-insensitive.
+     * @returns An array of objects containing matched commands and their corresponding group names.
+     */
+    AcApDocManager.prototype.searchCommandsByPrefix = function (prefix) {
+        return this._commandManager.searchCommandsByPrefix(prefix, this.curDocument.openMode);
+    };
     /**
      * Registers all default commands available in the CAD viewer.
      *
@@ -458,8 +533,15 @@ var AcApDocManager = /** @class */ (function () {
         register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'open', 'open', new AcApOpenCmd());
         register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'pan', 'pan', new AcApPanCmd());
         register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'qnew', 'qnew', new AcApQNewCmd());
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'rectangle', 'rectangle', new AcApRectCmd());
         register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'regen', 'regen', new AcApRegenCmd());
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'revcircle', 'revcircle', new AcApRevCircleCmd());
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'revcloud', 'revcloud', new AcApRevCloudCmd());
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'revrect', 'revrect', new AcApRevRectCmd());
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'revvis', 'revvis', new AcApRevVisibilityCmd());
         register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'select', 'select', new AcApSelectCmd());
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'sketch', 'sketch', new AcApSketchCmd());
+        register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'switchbg', 'switchbg', new AcApSwitchBgCmd());
         register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'zoom', 'zoom', new AcApZoomCmd());
         register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'zoomw', 'zoomw', new AcApZoomToBoxCmd());
         // Register system variables as commands
@@ -472,9 +554,11 @@ var AcApDocManager = /** @class */ (function () {
      * Executes a command by its string name.
      *
      * This method looks up a registered command by name and executes it with the current context.
-     * If the command is not found, no action is taken.
+     * It checks if the command's required mode is compatible with the document's current mode.
+     * If the command is not found or not compatible, an error is thrown.
      *
      * @param cmdStr - The command string to execute (e.g., 'pan', 'zoom', 'select')
+     * @throws {Error} If the command is not found or if the command's mode is not compatible with the document's mode
      *
      * @example
      * ```typescript
@@ -483,8 +567,16 @@ var AcApDocManager = /** @class */ (function () {
      * ```
      */
     AcApDocManager.prototype.sendStringToExecute = function (cmdStr) {
+        var documentMode = this.context.doc.openMode;
         var cmd = this._commandManager.lookupGlobalCmd(cmdStr);
-        cmd === null || cmd === void 0 ? void 0 : cmd.execute(this.context);
+        if (!cmd) {
+            throw new Error("Command '".concat(cmdStr, "' not found"));
+        }
+        // Check mode compatibility: document mode must be >= command mode
+        if (documentMode < cmd.mode) {
+            throw new Error("Command '".concat(cmdStr, "' requires mode '").concat(AcEdOpenMode[cmd.mode], "' but document is in mode '").concat(AcEdOpenMode[documentMode], "'!"));
+        }
+        cmd.trigger(this.context);
     };
     /**
      * Configures layout information for the current view.
@@ -634,6 +726,70 @@ var AcApDocManager = /** @class */ (function () {
             ? webworkerFileUrls.mtextRender
             : './assets/mtext-renderer-worker.js');
     };
+    /**
+     * Loads plugins automatically based on the provided configuration.
+     *
+     * This method is called during initialization if plugins are configured.
+     * It supports loading from both configuration arrays and folder paths.
+     *
+     * @param pluginsConfig - Plugin loading configuration
+     * @private
+     */
+    AcApDocManager.prototype.loadPlugins = function (pluginsConfig) {
+        return __awaiter(this, void 0, void 0, function () {
+            var result, error_1, result, error_2;
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        if (!pluginsConfig) {
+                            return [2 /*return*/];
+                        }
+                        if (!(pluginsConfig.fromConfig && pluginsConfig.fromConfig.length > 0)) return [3 /*break*/, 4];
+                        _b.label = 1;
+                    case 1:
+                        _b.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, this._pluginManager.loadPluginsFromConfig(pluginsConfig.fromConfig, { continueOnError: true })];
+                    case 2:
+                        result = _b.sent();
+                        if (result.loaded.length > 0) {
+                            console.log("[AcApDocManager] Loaded ".concat(result.loaded.length, " plugin(s) from config:"), result.loaded);
+                        }
+                        if (result.failed.length > 0) {
+                            console.warn("[AcApDocManager] Failed to load ".concat(result.failed.length, " plugin(s):"), result.failed.map(function (f) { return "".concat(f.name, ": ").concat(f.error.message); }));
+                        }
+                        return [3 /*break*/, 4];
+                    case 3:
+                        error_1 = _b.sent();
+                        console.error('[AcApDocManager] Error loading plugins from config:', error_1);
+                        return [3 /*break*/, 4];
+                    case 4:
+                        if (!pluginsConfig.fromFolder) return [3 /*break*/, 8];
+                        _b.label = 5;
+                    case 5:
+                        _b.trys.push([5, 7, , 8]);
+                        return [4 /*yield*/, this._pluginManager.loadPluginsFromFolder(pluginsConfig.fromFolder.folderPath, {
+                                pluginList: pluginsConfig.fromFolder.pluginList,
+                                continueOnError: (_a = pluginsConfig.fromFolder.continueOnError) !== null && _a !== void 0 ? _a : true
+                            })];
+                    case 6:
+                        result = _b.sent();
+                        if (result.loaded.length > 0) {
+                            console.log("[AcApDocManager] Loaded ".concat(result.loaded.length, " plugin(s) from folder:"), result.loaded);
+                        }
+                        if (result.failed.length > 0) {
+                            console.warn("[AcApDocManager] Failed to load ".concat(result.failed.length, " plugin(s) from folder:"), result.failed.map(function (f) { return "".concat(f.name, ": ").concat(f.error.message); }));
+                        }
+                        return [3 /*break*/, 8];
+                    case 7:
+                        error_2 = _b.sent();
+                        console.error('[AcApDocManager] Error loading plugins from folder:', error_2);
+                        return [3 /*break*/, 8];
+                    case 8: return [2 /*return*/];
+                }
+            });
+        });
+    };
     return AcApDocManager;
 }());
 export { AcApDocManager };