@mlightcad/cad-simple-viewer 1.0.0 → 1.0.2

package/lib/app/AcApDocManager.js

@@ -42,10 +42,34 @@ import { AcApContext } from './AcApContext';
 import { AcApDocCreator } from './AcApDocCreator';
 import { AcApDocument } from './AcApDocument';
 import { AcApFontLoader } from './AcApFontLoader';
+/**
+ * Document manager that handles CAD document lifecycle and provides the main entry point for the CAD viewer.
+ *
+ * This singleton class manages:
+ * - Document creation and opening (from URLs or file content)
+ * - View and context management
+ * - Command registration and execution
+ * - Font loading for text rendering
+ * - Event handling for document lifecycle
+ *
+ * The manager follows a singleton pattern to ensure only one instance manages the application state.
+ */
 var AcApDocManager = /** @class */ (function () {
+    /**
+     * Private constructor for singleton pattern.
+     *
+     * Creates an empty document with a 2D view and sets up the application context.
+     * Registers default commands and creates an example document.
+     *
+     * @param canvas - Optional HTML canvas element for rendering. If not provided, a new canvas will be created
+     * @private
+     */
     function AcApDocManager(canvas) {
+        /** Events fired during document lifecycle */
         this.events = {
+            /** Fired when a new document is created */
             documentCreated: new AcCmEventManager(),
+            /** Fired when a document becomes active */
             documentActivated: new AcCmEventManager()
         };
         // Create one empty drawing
@@ -54,6 +78,7 @@ var AcApDocManager = /** @class */ (function () {
             eventBus.emit('open-file-progress', {
                 percentage: args.percentage,
                 stage: args.stage,
+                subStage: args.subStage,
                 stageStatus: args.stageStatus
             });
         });
@@ -68,8 +93,22 @@ var AcApDocManager = /** @class */ (function () {
         this._fontLoader = new AcApFontLoader(view.renderer);
         acdbHostApplicationServices().workingDatabase = doc.database;
         this.registerCommands();
-        this.createExampleDoc();
     }
+    /**
+     * Creates the singleton instance with an optional canvas element.
+     *
+     * This method should be called before accessing the `instance` property
+     * if you want to provide a specific canvas element.
+     *
+     * @param canvas - Optional HTML canvas element for rendering
+     * @returns The singleton instance
+     *
+     * @example
+     * ```typescript
+     * const canvas = document.getElementById('my-canvas') as HTMLCanvasElement;
+     * const docManager = AcApDocManager.createInstance(canvas);
+     * ```
+     */
     AcApDocManager.createInstance = function (canvas) {
         if (AcApDocManager._instance == null) {
             AcApDocManager._instance = new AcApDocManager(canvas);
@@ -77,6 +116,13 @@ var AcApDocManager = /** @class */ (function () {
         return this._instance;
     };
     Object.defineProperty(AcApDocManager, "instance", {
+        /**
+         * Gets the singleton instance of the document manager.
+         *
+         * Creates a new instance if one doesn't exist yet.
+         *
+         * @returns The singleton document manager instance
+         */
         get: function () {
             if (!AcApDocManager._instance) {
                 AcApDocManager._instance = new AcApDocManager();
@@ -88,7 +134,11 @@ var AcApDocManager = /** @class */ (function () {
     });
     Object.defineProperty(AcApDocManager.prototype, "context", {
         /**
-         * Current context
+         * Gets the current application context.
+         *
+         * The context binds the current document with its associated view.
+         *
+         * @returns The current application context
          */
         get: function () {
             return this._context;
@@ -98,7 +148,9 @@ var AcApDocManager = /** @class */ (function () {
     });
     Object.defineProperty(AcApDocManager.prototype, "curDocument", {
         /**
-         * Current open drawing
+         * Gets the currently open CAD document.
+         *
+         * @returns The current document instance
          */
         get: function () {
             return this._context.doc;
@@ -108,7 +160,12 @@ var AcApDocManager = /** @class */ (function () {
     });
     Object.defineProperty(AcApDocManager.prototype, "mdiActiveDocument", {
         /**
-         * For now, it is same as property `curDocument`.
+         * Gets the currently active document.
+         *
+         * For now, this is the same as `curDocument` since only one document
+         * can be active at a time.
+         *
+         * @returns The current active document
          */
         get: function () {
             return this._context.doc;
@@ -118,7 +175,9 @@ var AcApDocManager = /** @class */ (function () {
     });
     Object.defineProperty(AcApDocManager.prototype, "curView", {
         /**
-         * Current view used to show current drawing
+         * Gets the current 2D view used to display the drawing.
+         *
+         * @returns The current 2D view instance
          */
         get: function () {
             return this._context.view;
@@ -127,6 +186,11 @@ var AcApDocManager = /** @class */ (function () {
         configurable: true
     });
     Object.defineProperty(AcApDocManager.prototype, "editor", {
+        /**
+         * Gets the editor instance for handling user input.
+         *
+         * @returns The current editor instance
+         */
         get: function () {
             return this._context.view.editor;
         },
@@ -135,8 +199,11 @@ var AcApDocManager = /** @class */ (function () {
     });
     Object.defineProperty(AcApDocManager.prototype, "avaiableFonts", {
         /**
-         * Avaiable fonts to load. It means those fonts are avaiable to load. However, it
-         * doesn't mean those fonts are already loaded and avaiable to use.
+         * Gets the list of available fonts that can be loaded.
+         *
+         * Note: These fonts are available for loading but may not be loaded yet.
+         *
+         * @returns Array of available font names
          */
         get: function () {
             return this._fontLoader.avaiableFonts;
@@ -145,8 +212,15 @@ var AcApDocManager = /** @class */ (function () {
         configurable: true
     });
     /**
-     * Load the specified fonts
-     * @param fonts Input one list of font names
+     * Loads the specified fonts for text rendering.
+     *
+     * @param fonts - Array of font names to load
+     * @returns Promise that resolves when fonts are loaded
+     *
+     * @example
+     * ```typescript
+     * await docManager.loadFonts(['Arial', 'Times New Roman']);
+     * ```
      */
     AcApDocManager.prototype.loadFonts = function (fonts) {
         return __awaiter(this, void 0, void 0, function () {
@@ -161,23 +235,60 @@ var AcApDocManager = /** @class */ (function () {
         });
     };
     /**
-     * Load default fonts
+     * Loads default fonts for CAD text rendering.
+     *
+     * This method loads either the specified fonts or falls back to default Chinese fonts
+     * (specifically 'simkai') if no fonts are provided. The loaded fonts are used for
+     * rendering CAD text entities like MText and Text in the viewer.
+     *
+     * It is better to load default fonts when viewer is initialized so that the viewer can
+     * render text correctly if fonts used in the document are not available.
+     *
+     * @param fonts - Optional array of font names to load. If not provided or null,
+     *               defaults to ['simkai'] for Chinese text support
+     * @returns Promise that resolves when all specified fonts are loaded
+     *
+     * @example
+     * ```typescript
+     * // Load default fonts (simkai)
+     * await docManager.loadDefaultFonts();
+     *
+     * // Load specific fonts
+     * await docManager.loadDefaultFonts(['Arial', 'SimSun']);
+     *
+     * // Load no fonts (empty array)
+     * await docManager.loadDefaultFonts([]);
+     * ```
+     *
+     * @see {@link AcApFontLoader.load} - The underlying font loading implementation
+     * @see {@link createExampleDoc} - Method that uses this for example document creation
      */
-    AcApDocManager.prototype.loadDefaultFonts = function () {
+    AcApDocManager.prototype.loadDefaultFonts = function (fonts) {
         return __awaiter(this, void 0, void 0, function () {
-            var fontFiles;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        fontFiles = ['simkai'];
-                        return [4 /*yield*/, this._fontLoader.load(fontFiles)];
+                        if (!(fonts == null)) return [3 /*break*/, 2];
+                        return [4 /*yield*/, this._fontLoader.load(['simkai'])];
                     case 1:
                         _a.sent();
-                        return [2 /*return*/];
+                        return [3 /*break*/, 4];
+                    case 2: return [4 /*yield*/, this._fontLoader.load(fonts)];
+                    case 3:
+                        _a.sent();
+                        _a.label = 4;
+                    case 4: return [2 /*return*/];
                 }
             });
         });
     };
+    /**
+     * Creates an example CAD document with sample content.
+     *
+     * This method asynchronously loads default fonts, creates example drawing content,
+     * sets up layout information, and zooms the view to fit the content.
+     * The creation is performed after a short delay to ensure proper initialization.
+     */
     AcApDocManager.prototype.createExampleDoc = function () {
         var _this = this;
         setTimeout(function () { return __awaiter(_this, void 0, void 0, function () {
@@ -194,6 +305,24 @@ var AcApDocManager = /** @class */ (function () {
             });
         }); });
     };
+    /**
+     * Opens a CAD document from a URL.
+     *
+     * This method loads a document from the specified URL and replaces the current document.
+     * It handles the complete document lifecycle including before/after open events.
+     *
+     * @param url - The URL of the CAD file to open
+     * @param options - Optional database opening options. If not provided, default options with font loader will be used
+     * @returns Promise that resolves to true if the document was successfully opened, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const success = await docManager.openUrl('https://example.com/drawing.dwg');
+     * if (success) {
+     *   console.log('Document opened successfully');
+     * }
+     * ```
+     */
     AcApDocManager.prototype.openUrl = function (url, options) {
         return __awaiter(this, void 0, void 0, function () {
             var isSuccess;
@@ -206,11 +335,29 @@ var AcApDocManager = /** @class */ (function () {
                     case 1:
                         isSuccess = _a.sent();
                         this.onAfterOpenDocument(isSuccess);
-                        return [2 /*return*/];
+                        return [2 /*return*/, isSuccess];
                 }
             });
         });
     };
+    /**
+     * Opens a CAD document from file content.
+     *
+     * This method loads a document from the provided file content (string or binary data)
+     * and replaces the current document. It handles the complete document lifecycle
+     * including before/after open events.
+     *
+     * @param fileName - The name of the file being opened (used for format detection)
+     * @param content - The file content as string or ArrayBuffer
+     * @param options - Database opening options including font loader settings
+     * @returns Promise that resolves to true if the document was successfully opened, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const fileContent = await file.arrayBuffer();
+     * const success = await docManager.openDocument('drawing.dwg', fileContent, options);
+     * ```
+     */
     AcApDocManager.prototype.openDocument = function (fileName, content, options) {
         return __awaiter(this, void 0, void 0, function () {
             var isSuccess;
@@ -223,11 +370,25 @@ var AcApDocManager = /** @class */ (function () {
                     case 1:
                         isSuccess = _a.sent();
                         this.onAfterOpenDocument(isSuccess);
-                        return [2 /*return*/];
+                        return [2 /*return*/, isSuccess];
                 }
             });
         });
     };
+    /**
+     * Registers all default commands available in the CAD viewer.
+     *
+     * This method sets up the command system by registering built-in commands including:
+     * - pan: Pan/move the view
+     * - select: Select entities
+     * - zoom: Zoom in/out
+     * - zoomw: Zoom to window/box
+     * - csvg: Convert to SVG
+     * - qnew: Quick new document
+     * - open: Open document
+     *
+     * All commands are registered under the system command group.
+     */
     AcApDocManager.prototype.registerCommands = function () {
         var register = AcEdCommandStack.instance;
         register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'pan', 'pan', new AcApPanCmd());
@@ -238,14 +399,46 @@ var AcApDocManager = /** @class */ (function () {
         register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'qnew', 'qnew', new AcApQNewCmd());
         register.addCommand(AcEdCommandStack.SYSTEMT_COMMAND_GROUP_NAME, 'open', 'open', new AcApOpenCmd());
     };
+    /**
+     * 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.
+     *
+     * @param cmdStr - The command string to execute (e.g., 'pan', 'zoom', 'select')
+     *
+     * @example
+     * ```typescript
+     * docManager.sendStringToExecute('zoom');
+     * docManager.sendStringToExecute('pan');
+     * ```
+     */
     AcApDocManager.prototype.sendStringToExecute = function (cmdStr) {
         var register = AcEdCommandStack.instance;
         var cmd = register.lookupGlobalCmd(cmdStr);
         cmd === null || cmd === void 0 ? void 0 : cmd.execute(this.context);
     };
+    /**
+     * Performs cleanup operations before opening a new document.
+     *
+     * This protected method is called automatically before any document opening operation.
+     * It clears the current view to prepare for the new document content.
+     *
+     * @protected
+     */
     AcApDocManager.prototype.onBeforeOpenDocument = function () {
         this.curView.clear();
     };
+    /**
+     * Performs setup operations after a document opening attempt.
+     *
+     * This protected method is called automatically after any document opening operation.
+     * If the document was successfully opened, it dispatches the documentActivated event,
+     * sets up layout information, and zooms the view to fit the content.
+     *
+     * @param isSuccess - Whether the document was successfully opened
+     * @protected
+     */
     AcApDocManager.prototype.onAfterOpenDocument = function (isSuccess) {
         if (isSuccess) {
             this.events.documentActivated.dispatch({
@@ -255,6 +448,17 @@ var AcApDocManager = /** @class */ (function () {
             this.curView.zoomToFit();
         }
     };
+    /**
+     * Sets up or validates database opening options.
+     *
+     * This private method ensures that the options object has a font loader configured.
+     * If no options are provided, creates new options with the font loader.
+     * If options are provided but missing a font loader, adds the font loader.
+     *
+     * @param options - Optional database opening options to validate/modify
+     * @returns The validated options object with font loader configured
+     * @private
+     */
     AcApDocManager.prototype.setOptions = function (options) {
         if (options == null) {
             options = { fontLoader: this._fontLoader };
@@ -264,6 +468,14 @@ var AcApDocManager = /** @class */ (function () {
         }
         return options;
     };
+    /**
+     * Configures layout information for the current view.
+     *
+     * This private method sets up the active layout block table record ID and
+     * model space block table record ID based on the current document's space configuration.
+     *
+     * @private
+     */
     AcApDocManager.prototype.setLayoutInfo = function () {
         var currentView = this.curView;
         currentView.activeLayoutBtrId = this.curDocument.database.currentSpaceId;

package/lib/app/AcApDocManager.js.map

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

package/lib/app/AcApDocument.d.ts

@@ -1,27 +1,101 @@
 import { AcDbDatabase, AcDbOpenDatabaseOptions } from '@mlightcad/data-model';
+/**
+ * Represents a CAD document that manages a drawing database and associated metadata.
+ *
+ * This class handles:
+ * - Opening CAD files from URIs or file content (DWG/DXF formats)
+ * - Managing document properties (title, read-only state)
+ * - Providing access to the underlying database
+ * - Handling file loading errors through event emission
+ */
 export declare class AcApDocument {
+    /** The URI of the opened document, if opened from a URI */
     private _uri?;
+    /** The underlying CAD database containing all drawing data */
     private _database;
+    /** The file name of the document */
     private _fileName;
+    /** The display title of the document */
     private _docTitle;
+    /** Whether the document is opened in read-only mode */
     private _isReadOnly;
+    /**
+     * Creates a new document instance with an empty database.
+     *
+     * The document is initialized with an "Untitled" title and read-only mode enabled.
+     */
     constructor();
+    /**
+     * Opens a CAD document from a URI.
+     *
+     * @param uri - The URI of the CAD file to open
+     * @param options - Options for opening the database, including read-only mode
+     * @returns Promise resolving to true if successful, false if failed
+     *
+     * @example
+     * ```typescript
+     * const success = await document.openUri('https://example.com/drawing.dwg', {
+     *   readOnly: true
+     * });
+     * ```
+     */
     openUri(uri: string, options: AcDbOpenDatabaseOptions): Promise<boolean>;
+    /**
+     * Opens a CAD document from file content.
+     *
+     * @param fileName - The name of the file (used to determine file type from extension)
+     * @param content - The file content as string or ArrayBuffer
+     * @param options - Options for opening the database, including read-only mode
+     * @returns Promise resolving to true if successful, false if failed
+     *
+     * @example
+     * ```typescript
+     * const fileContent = await fetch('drawing.dwg').then(r => r.arrayBuffer());
+     * const success = await document.openDocument('drawing.dwg', fileContent, {
+     *   readOnly: false
+     * });
+     * ```
+     */
     openDocument(fileName: string, content: string | ArrayBuffer, options: AcDbOpenDatabaseOptions): Promise<boolean>;
+    /**
+     * Gets the URI of the document if opened from a URI.
+     *
+     * @returns The document URI, or undefined if not opened from URI
+     */
     get uri(): string | undefined;
     /**
-     * The database object being used by this document instance.
+     * Gets the database object containing all drawing data.
+     *
+     * @returns The underlying CAD database instance
      */
     get database(): AcDbDatabase;
     /**
-     * The window title of the document
+     * Gets the display title of the document.
+     *
+     * @returns The document title displayed in the window/tab
      */
     get docTitle(): string;
+    /**
+     * Sets the display title of the document.
+     *
+     * Also updates the browser tab title if running in a browser environment.
+     *
+     * @param value - The new document title
+     */
     set docTitle(value: string);
     /**
-     * Return true if the document is read only; otherwise, returns false.
+     * Gets whether the document is opened in read-only mode.
+     *
+     * @returns True if the document is read-only, false if editable
      */
     get isReadOnly(): boolean;
+    /**
+     * Extracts the file name from a URI.
+     *
+     * @param uri - The URI to extract the file name from
+     * @returns The extracted file name, or empty string if extraction fails
+     * @private
+     */
     private getFileNameFromUri;
 }
 //# sourceMappingURL=AcApDocument.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AcApDocument.d.ts","sourceRoot":"","sources":["../../src/app/AcApDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,uBAAuB,EACxB,MAAM,uBAAuB,CAAA;AAI9B,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAC,CAAQ;IACrB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,WAAW,CAAgB;;IAO7B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB;IAerD,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,WAAW,EAC7B,OAAO,EAAE,uBAAuB;IAoBlC,IAAI,GAAG,uBAEN;IAED;;OAEG;IACH,IAAI,QAAQ,iBAEX;IAED;;OAEG;IACH,IAAI,QAAQ,IAGQ,MAAM,CADzB;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAMzB;IAED;;OAEG;IACH,IAAI,UAAU,YAEb;IAED,OAAO,CAAC,kBAAkB;CAa3B"}
+{"version":3,"file":"AcApDocument.d.ts","sourceRoot":"","sources":["../../src/app/AcApDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,uBAAuB,EACxB,MAAM,uBAAuB,CAAA;AAI9B;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,2DAA2D;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAQ;IACrB,8DAA8D;IAC9D,OAAO,CAAC,SAAS,CAAc;IAC/B,oCAAoC;IACpC,OAAO,CAAC,SAAS,CAAa;IAC9B,wCAAwC;IACxC,OAAO,CAAC,SAAS,CAAa;IAC9B,uDAAuD;IACvD,OAAO,CAAC,WAAW,CAAgB;IAEnC;;;;OAIG;;IAMH;;;;;;;;;;;;;OAaG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB;IAe3D;;;;;;;;;;;;;;;OAeG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,WAAW,EAC7B,OAAO,EAAE,uBAAuB;IAoBlC;;;;OAIG;IACH,IAAI,GAAG,uBAEN;IAED;;;;OAIG;IACH,IAAI,QAAQ,iBAEX;IAED;;;;OAIG;IACH,IAAI,QAAQ,IAWQ,MAAM,CATzB;IAED;;;;;;OAMG;IACH,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAMzB;IAED;;;;OAIG;IACH,IAAI,UAAU,YAEb;IAED;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;CAa3B"}

package/lib/app/AcApDocument.js

@@ -36,14 +36,45 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 };
 import { AcDbDatabase, AcDbFileType } from '@mlightcad/data-model';
 import { eventBus } from '../editor';
+/**
+ * Represents a CAD document that manages a drawing database and associated metadata.
+ *
+ * This class handles:
+ * - Opening CAD files from URIs or file content (DWG/DXF formats)
+ * - Managing document properties (title, read-only state)
+ * - Providing access to the underlying database
+ * - Handling file loading errors through event emission
+ */
 var AcApDocument = /** @class */ (function () {
+    /**
+     * Creates a new document instance with an empty database.
+     *
+     * The document is initialized with an "Untitled" title and read-only mode enabled.
+     */
     function AcApDocument() {
+        /** The file name of the document */
         this._fileName = '';
+        /** The display title of the document */
         this._docTitle = '';
+        /** Whether the document is opened in read-only mode */
         this._isReadOnly = true;
         this._database = new AcDbDatabase();
         this.docTitle = 'Untitled';
     }
+    /**
+     * Opens a CAD document from a URI.
+     *
+     * @param uri - The URI of the CAD file to open
+     * @param options - Options for opening the database, including read-only mode
+     * @returns Promise resolving to true if successful, false if failed
+     *
+     * @example
+     * ```typescript
+     * const success = await document.openUri('https://example.com/drawing.dwg', {
+     *   readOnly: true
+     * });
+     * ```
+     */
     AcApDocument.prototype.openUri = function (uri, options) {
         return __awaiter(this, void 0, void 0, function () {
             var isSuccess, _1;
@@ -72,6 +103,22 @@ var AcApDocument = /** @class */ (function () {
             });
         });
     };
+    /**
+     * Opens a CAD document from file content.
+     *
+     * @param fileName - The name of the file (used to determine file type from extension)
+     * @param content - The file content as string or ArrayBuffer
+     * @param options - Options for opening the database, including read-only mode
+     * @returns Promise resolving to true if successful, false if failed
+     *
+     * @example
+     * ```typescript
+     * const fileContent = await fetch('drawing.dwg').then(r => r.arrayBuffer());
+     * const success = await document.openDocument('drawing.dwg', fileContent, {
+     *   readOnly: false
+     * });
+     * ```
+     */
     AcApDocument.prototype.openDocument = function (fileName, content, options) {
         return __awaiter(this, void 0, void 0, function () {
             var isSuccess, fileExtension, e_1;
@@ -102,6 +149,11 @@ var AcApDocument = /** @class */ (function () {
         });
     };
     Object.defineProperty(AcApDocument.prototype, "uri", {
+        /**
+         * Gets the URI of the document if opened from a URI.
+         *
+         * @returns The document URI, or undefined if not opened from URI
+         */
         get: function () {
             return this._uri;
         },
@@ -110,7 +162,9 @@ var AcApDocument = /** @class */ (function () {
     });
     Object.defineProperty(AcApDocument.prototype, "database", {
         /**
-         * The database object being used by this document instance.
+         * Gets the database object containing all drawing data.
+         *
+         * @returns The underlying CAD database instance
          */
         get: function () {
             return this._database;
@@ -120,11 +174,20 @@ var AcApDocument = /** @class */ (function () {
     });
     Object.defineProperty(AcApDocument.prototype, "docTitle", {
         /**
-         * The window title of the document
+         * Gets the display title of the document.
+         *
+         * @returns The document title displayed in the window/tab
          */
         get: function () {
             return this._docTitle;
         },
+        /**
+         * Sets the display title of the document.
+         *
+         * Also updates the browser tab title if running in a browser environment.
+         *
+         * @param value - The new document title
+         */
         set: function (value) {
             this._docTitle = value;
             // Update browser title when document title changes
@@ -137,7 +200,9 @@ var AcApDocument = /** @class */ (function () {
     });
     Object.defineProperty(AcApDocument.prototype, "isReadOnly", {
         /**
-         * Return true if the document is read only; otherwise, returns false.
+         * Gets whether the document is opened in read-only mode.
+         *
+         * @returns True if the document is read-only, false if editable
          */
         get: function () {
             return this._isReadOnly;
@@ -145,6 +210,13 @@ var AcApDocument = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
+    /**
+     * Extracts the file name from a URI.
+     *
+     * @param uri - The URI to extract the file name from
+     * @returns The extracted file name, or empty string if extraction fails
+     * @private
+     */
     AcApDocument.prototype.getFileNameFromUri = function (uri) {
         try {
             // Create a new URL object