@mlightcad/cad-simple-viewer 1.0.0 → 1.0.1

package/lib/view/AcTrLayout.d.ts

@@ -3,111 +3,210 @@ import { AcTrEntity, AcTrObject } from '@mlightcad/three-renderer';
 import * as THREE from 'three';
 import { AcEdSpatialQueryResultItem } from '../editor';
 import { AcTrLayer, AcTrLayerStats } from './AcTrLayer';
+/**
+ * Interface representing statistics for a layout.
+ * Provides detailed information about the layout's content including
+ * layer statistics and memory usage breakdown.
+ */
 export interface AcTrLayoutStats {
+    /** Statistics for each layer in the layout */
     layers: AcTrLayerStats[];
+    /** Summary statistics for the entire layout */
     summary: {
+        /** Total number of entities across all layers */
         entityCount: number;
+        /** Memory usage breakdown by object type */
         totalSize: {
+            /** Memory used by line geometries (bytes) */
             line: number;
+            /** Memory used by mesh geometries (bytes) */
             mesh: number;
+            /** Memory used by point geometries (bytes) */
             point: number;
+            /** Total geometry memory usage (bytes) */
             geometry: number;
+            /** Memory used by entity mappings (bytes) */
             mapping: number;
         };
     };
 }
 /**
- * This class represents objects contained in one AuotCAD layout (model space or paper space).
+ * This class represents objects contained in one AutoCAD layout (model space or paper space).
+ *
+ * A layout manages the organization and rendering of CAD entities within a specific coordinate space.
+ * It provides functionality for:
+ * - Managing entities organized by layers
+ * - Spatial indexing for efficient entity queries
+ * - Bounding box management for view operations
+ * - Entity selection and highlighting
+ * - Memory usage tracking and statistics
+ *
+ * Layouts use a spatial index (R-tree) for fast entity lookup operations and maintain
+ * a hierarchical structure where entities are grouped by layers for efficient rendering
+ * and visibility management.
+ *
+ * @example
+ * ```typescript
+ * const layout = new AcTrLayout();
+ * layout.addEntity(entity);
+ * const entities = layout.search(boundingBox);
+ * layout.select(['entity1', 'entity2']);
+ * ```
  */
 export declare class AcTrLayout {
+    /** The group that contains all entities in this layout */
     private _group;
+    /** Spatial index tree for efficient entity queries */
     private _indexTree;
+    /** Bounding box containing all entities in this layout */
     private _box;
+    /** Map of layers indexed by layer name */
     private _layers;
+    /** Optional object for displaying snap points */
     private _snapPointsObject?;
+    /**
+     * Creates a new layout instance.
+     * Initializes the layout with empty collections and a spatial index.
+     */
     constructor();
     /**
      * The internal THREE.js object to use by scene. This is internally used only. Try to avoid using it.
      * @internal
      */
     get internalObject(): THREE.Group<THREE.Object3DEventMap>;
+    /**
+     * Gets the map of layers in this layout.
+     *
+     * @returns Map of layer names to layer objects
+     */
     get layers(): Map<string, AcTrLayer>;
+    /**
+     * Gets the bounding box that contains all entities in this layout.
+     *
+     * @returns The layout's bounding box
+     */
     get box(): THREE.Box3;
     /**
-     * The visibility of this layout
+     * The visibility of this layout.
+     * When set to false, the entire layout and all its contents are hidden.
      */
     get visible(): boolean;
     set visible(value: boolean);
     /**
-     * The number of entities stored in this layer
+     * The number of entities stored in this layout.
+     * Calculates the total by summing entities across all layers.
      */
     get entityCount(): number;
     /**
-     * The statistics of this layout
+     * The statistics of this layout.
+     * Provides detailed information about memory usage and entity counts.
      */
     get stats(): AcTrLayoutStats;
+    /**
+     * Clears all entities from the layout.
+     * Removes all layers, resets the bounding box, and clears the spatial index.
+     *
+     * @returns This layout instance for method chaining
+     */
     clear(): this;
     /**
-     * Re-render points with latest point style settings
-     * @param displayMode Input display mode of points
+     * Re-render points with latest point style settings.
+     * Updates the visual representation of all point entities across all layers.
+     *
+     * @param displayMode - Input display mode of points
      */
     rerenderPoints(displayMode: number): void;
     /**
      * Return true if the object with the specified object id is intersected with the ray by using raycast.
-     * @param objectId  Input object id of object to check for intersection with the ray.
-     * @param raycaster Input raycaster to check intersection
+     *
+     * @param objectId - Input object id of object to check for intersection with the ray.
+     * @param raycaster - Input raycaster to check intersection
+     * @returns True if the object intersects with the ray, false otherwise
      */
     isIntersectWith(objectId: string, raycaster: THREE.Raycaster): boolean | undefined;
     /**
      * Add one AutoCAD entity into this layout. If layer group referenced by the entity doesn't exist, create one
      * layer group and add this entity this group.
-     * @param entity Input AutoCAD entity to be added into this layout.
-     * @param extendBbox Input the flag whether to extend the bounding box of the scene by union the bounding box
-     * of the specified entity.
+     *
+     * @param entity - Input AutoCAD entity to be added into this layout.
+     * @param extendBbox - Input the flag whether to extend the bounding box of the scene by union the bounding box
+     * of the specified entity. Defaults to true.
+     * @returns This layout instance for method chaining
+     *
+     * @throws {Error} When entity is missing required objectId or layerName
      */
     addEntity(entity: AcTrEntity, extendBbox?: boolean): this;
     /**
      * Remove the specified entity from this layout.
-     * @param objectId Input the object id of the entity to remove
+     *
+     * @param objectId - Input the object id of the entity to remove
      * @returns Return true if remove the specified entity successfully. Otherwise, return false.
      */
     remove(objectId: AcDbObjectId): boolean;
     /**
      * Update the specified entity in this layout.
-     * @param objectId Input the entity to update
+     *
+     * @param entity - Input the entity to update
      * @returns Return true if update the specified entity successfully. Otherwise, return false.
      */
     update(entity: AcTrEntity): boolean;
     /**
-     * Hover the specified entities
+     * Hover the specified entities.
+     * Applies hover highlighting to the entities with the given IDs.
+     *
+     * @param ids - Array of entity object IDs to hover
      */
     hover(ids: AcDbObjectId[]): void;
     /**
-     * Unhover the specified entities
+     * Unhover the specified entities.
+     * Removes hover highlighting from the entities with the given IDs.
+     *
+     * @param ids - Array of entity object IDs to unhover
      */
     unhover(ids: AcDbObjectId[]): void;
     /**
-     * Select the specified entities
+     * Select the specified entities.
+     * Applies selection highlighting to the entities with the given IDs.
+     *
+     * @param ids - Array of entity object IDs to select
      */
     select(ids: AcDbObjectId[]): void;
     /**
-     * Unselect the specified entities
+     * Unselect the specified entities.
+     * Removes selection highlighting from the entities with the given IDs.
+     *
+     * @param ids - Array of entity object IDs to unselect
      */
     unselect(ids: AcDbObjectId[]): void;
+    /**
+     * Sets the snap points object for this layout.
+     * Replaces any existing snap points object with the new one.
+     *
+     * @param object - The snap points object to display
+     */
     setSnapObject(object: AcTrObject): void;
     /**
      * Search entities intersected or contained in the specified bounding box.
-     * @param box Input the query bounding box
-     * @returns Return query results
+     * Uses the spatial index for efficient querying of entities within the given bounds.
+     *
+     * @param box - Input the query bounding box (2D or 3D)
+     * @returns Return query results containing entity IDs and their bounds
      */
     search(box: AcGeBox2d | AcGeBox3d): AcEdSpatialQueryResultItem[];
+    /**
+     * Finds the layer containing the entity with the specified object ID.
+     *
+     * @param objectId - The object ID to search for
+     * @returns The layer containing the entity, or undefined if not found
+     */
     private getLayerByObjectId;
     /**
      * Get layer group by name. If the layer doesn't exist, create one layer group into this layout.
-     * @param name Input layer name
-     * @param createIfNotExist Input one flag to indicate whether to create layer group if it doesn't exist in
-     * this layout.
-     * @returns Return matched layer
+     *
+     * @param name - Input layer name
+     * @param createIfNotExist - Input one flag to indicate whether to create layer group if it doesn't exist in
+     * this layout. Defaults to true.
+     * @returns Return matched layer, or undefined if not found and createIfNotExist is false
      */
     private getLayer;
 }

package/lib/view/AcTrLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcTrLayout.d.ts","sourceRoot":"","sources":["../../src/view/AcTrLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAC1E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAElE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEvD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE;YACT,IAAI,EAAE,MAAM,CAAA;YACZ,IAAI,EAAE,MAAM,CAAA;YACZ,KAAK,EAAE,MAAM,CAAA;YACb,QAAQ,EAAE,MAAM,CAAA;YAChB,OAAO,EAAE,MAAM,CAAA;SAChB,CAAA;KACF,CAAA;CACF;AAED;;GAEG;AACH,qBAAa,UAAU;IAErB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,iBAAiB,CAAC,CAAY;;IAStC;;;OAGG;IACH,IAAI,cAAc,wCAEjB;IAED,IAAI,MAAM,2BAET;IAED,IAAI,GAAG,eAEN;IAED;;OAEG;IACH,IAAI,OAAO,IAGQ,OAAO,CADzB;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAEzB;IAED;;OAEG;IACH,IAAI,WAAW,WAId;IAED;;OAEG;IACH,IAAI,KAAK,IA+BF,eAAe,CACrB;IAED,KAAK;IAUL;;;OAGG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM;IAMlC;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS;IAK5D;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,GAAE,OAAc;IA2BxD;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,YAAY;IAO7B;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,UAAU;IAOzB;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE;IASzB;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE;IAS3B;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE;IAS1B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE;IAS5B,aAAa,CAAC,MAAM,EAAE,UAAU;IAQhC;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS;IAUjC,OAAO,CAAC,kBAAkB;IAO1B;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;CASjB"}
+{"version":3,"file":"AcTrLayout.d.ts","sourceRoot":"","sources":["../../src/view/AcTrLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAC1E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAElE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEvD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,+CAA+C;IAC/C,OAAO,EAAE;QACP,iDAAiD;QACjD,WAAW,EAAE,MAAM,CAAA;QACnB,4CAA4C;QAC5C,SAAS,EAAE;YACT,6CAA6C;YAC7C,IAAI,EAAE,MAAM,CAAA;YACZ,6CAA6C;YAC7C,IAAI,EAAE,MAAM,CAAA;YACZ,8CAA8C;YAC9C,KAAK,EAAE,MAAM,CAAA;YACb,0CAA0C;YAC1C,QAAQ,EAAE,MAAM,CAAA;YAChB,6CAA6C;YAC7C,OAAO,EAAE,MAAM,CAAA;SAChB,CAAA;KACF,CAAA;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,UAAU;IACrB,0DAA0D;IAC1D,OAAO,CAAC,MAAM,CAAa;IAC3B,sDAAsD;IACtD,OAAO,CAAC,UAAU,CAAmC;IACrD,0DAA0D;IAC1D,OAAO,CAAC,IAAI,CAAY;IACxB,0CAA0C;IAC1C,OAAO,CAAC,OAAO,CAAwB;IACvC,iDAAiD;IACjD,OAAO,CAAC,iBAAiB,CAAC,CAAY;IAEtC;;;OAGG;;IAQH;;;OAGG;IACH,IAAI,cAAc,wCAEjB;IAED;;;;OAIG;IACH,IAAI,MAAM,2BAET;IAED;;;;OAIG;IACH,IAAI,GAAG,eAEN;IAED;;;OAGG;IACH,IAAI,OAAO,IAGQ,OAAO,CADzB;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAEzB;IAED;;;OAGG;IACH,IAAI,WAAW,WAId;IAED;;;OAGG;IACH,IAAI,KAAK,IA+BF,eAAe,CACrB;IAED;;;;;OAKG;IACH,KAAK;IAUL;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM;IAMlC;;;;;;OAMG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS;IAK5D;;;;;;;;;;OAUG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,GAAE,OAAc;IA2BxD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,YAAY;IAO7B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,UAAU;IAOzB;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE;IASzB;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE;IAS3B;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE;IAS1B;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE;IAS5B;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,UAAU;IAQhC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS;IAUjC;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;CASjB"}

package/lib/view/AcTrLayout.js

@@ -29,9 +29,33 @@ import RBush from 'rbush';
 import * as THREE from 'three';
 import { AcTrLayer } from './AcTrLayer';
 /**
- * This class represents objects contained in one AuotCAD layout (model space or paper space).
+ * This class represents objects contained in one AutoCAD layout (model space or paper space).
+ *
+ * A layout manages the organization and rendering of CAD entities within a specific coordinate space.
+ * It provides functionality for:
+ * - Managing entities organized by layers
+ * - Spatial indexing for efficient entity queries
+ * - Bounding box management for view operations
+ * - Entity selection and highlighting
+ * - Memory usage tracking and statistics
+ *
+ * Layouts use a spatial index (R-tree) for fast entity lookup operations and maintain
+ * a hierarchical structure where entities are grouped by layers for efficient rendering
+ * and visibility management.
+ *
+ * @example
+ * ```typescript
+ * const layout = new AcTrLayout();
+ * layout.addEntity(entity);
+ * const entities = layout.search(boundingBox);
+ * layout.select(['entity1', 'entity2']);
+ * ```
  */
 var AcTrLayout = /** @class */ (function () {
+    /**
+     * Creates a new layout instance.
+     * Initializes the layout with empty collections and a spatial index.
+     */
     function AcTrLayout() {
         this._group = new THREE.Group();
         this._indexTree = new RBush();
@@ -50,6 +74,11 @@ var AcTrLayout = /** @class */ (function () {
         configurable: true
     });
     Object.defineProperty(AcTrLayout.prototype, "layers", {
+        /**
+         * Gets the map of layers in this layout.
+         *
+         * @returns Map of layer names to layer objects
+         */
         get: function () {
             return this._layers;
         },
@@ -57,6 +86,11 @@ var AcTrLayout = /** @class */ (function () {
         configurable: true
     });
     Object.defineProperty(AcTrLayout.prototype, "box", {
+        /**
+         * Gets the bounding box that contains all entities in this layout.
+         *
+         * @returns The layout's bounding box
+         */
         get: function () {
             return this._box;
         },
@@ -65,7 +99,8 @@ var AcTrLayout = /** @class */ (function () {
     });
     Object.defineProperty(AcTrLayout.prototype, "visible", {
         /**
-         * The visibility of this layout
+         * The visibility of this layout.
+         * When set to false, the entire layout and all its contents are hidden.
          */
         get: function () {
             return this._group.visible;
@@ -78,7 +113,8 @@ var AcTrLayout = /** @class */ (function () {
     });
     Object.defineProperty(AcTrLayout.prototype, "entityCount", {
         /**
-         * The number of entities stored in this layer
+         * The number of entities stored in this layout.
+         * Calculates the total by summing entities across all layers.
          */
         get: function () {
             var count = 0;
@@ -90,7 +126,8 @@ var AcTrLayout = /** @class */ (function () {
     });
     Object.defineProperty(AcTrLayout.prototype, "stats", {
         /**
-         * The statistics of this layout
+         * The statistics of this layout.
+         * Provides detailed information about memory usage and entity counts.
          */
         get: function () {
             var layers = [];
@@ -128,6 +165,12 @@ var AcTrLayout = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
+    /**
+     * Clears all entities from the layout.
+     * Removes all layers, resets the bounding box, and clears the spatial index.
+     *
+     * @returns This layout instance for method chaining
+     */
     AcTrLayout.prototype.clear = function () {
         var _this = this;
         this._layers.forEach(function (layer) {
@@ -139,8 +182,10 @@ var AcTrLayout = /** @class */ (function () {
         return this;
     };
     /**
-     * Re-render points with latest point style settings
-     * @param displayMode Input display mode of points
+     * Re-render points with latest point style settings.
+     * Updates the visual representation of all point entities across all layers.
+     *
+     * @param displayMode - Input display mode of points
      */
     AcTrLayout.prototype.rerenderPoints = function (displayMode) {
         this._layers.forEach(function (layer) {
@@ -149,8 +194,10 @@ var AcTrLayout = /** @class */ (function () {
     };
     /**
      * Return true if the object with the specified object id is intersected with the ray by using raycast.
-     * @param objectId  Input object id of object to check for intersection with the ray.
-     * @param raycaster Input raycaster to check intersection
+     *
+     * @param objectId - Input object id of object to check for intersection with the ray.
+     * @param raycaster - Input raycaster to check intersection
+     * @returns True if the object intersects with the ray, false otherwise
      */
     AcTrLayout.prototype.isIntersectWith = function (objectId, raycaster) {
         var layer = this.getLayerByObjectId(objectId);
@@ -159,9 +206,13 @@ var AcTrLayout = /** @class */ (function () {
     /**
      * Add one AutoCAD entity into this layout. If layer group referenced by the entity doesn't exist, create one
      * layer group and add this entity this group.
-     * @param entity Input AutoCAD entity to be added into this layout.
-     * @param extendBbox Input the flag whether to extend the bounding box of the scene by union the bounding box
-     * of the specified entity.
+     *
+     * @param entity - Input AutoCAD entity to be added into this layout.
+     * @param extendBbox - Input the flag whether to extend the bounding box of the scene by union the bounding box
+     * of the specified entity. Defaults to true.
+     * @returns This layout instance for method chaining
+     *
+     * @throws {Error} When entity is missing required objectId or layerName
      */
     AcTrLayout.prototype.addEntity = function (entity, extendBbox) {
         if (extendBbox === void 0) { extendBbox = true; }
@@ -190,7 +241,8 @@ var AcTrLayout = /** @class */ (function () {
     };
     /**
      * Remove the specified entity from this layout.
-     * @param objectId Input the object id of the entity to remove
+     *
+     * @param objectId - Input the object id of the entity to remove
      * @returns Return true if remove the specified entity successfully. Otherwise, return false.
      */
     AcTrLayout.prototype.remove = function (objectId) {
@@ -213,7 +265,8 @@ var AcTrLayout = /** @class */ (function () {
     };
     /**
      * Update the specified entity in this layout.
-     * @param objectId Input the entity to update
+     *
+     * @param entity - Input the entity to update
      * @returns Return true if update the specified entity successfully. Otherwise, return false.
      */
     AcTrLayout.prototype.update = function (entity) {
@@ -235,7 +288,10 @@ var AcTrLayout = /** @class */ (function () {
         return false;
     };
     /**
-     * Hover the specified entities
+     * Hover the specified entities.
+     * Applies hover highlighting to the entities with the given IDs.
+     *
+     * @param ids - Array of entity object IDs to hover
      */
     AcTrLayout.prototype.hover = function (ids) {
         var _this = this;
@@ -247,7 +303,10 @@ var AcTrLayout = /** @class */ (function () {
         });
     };
     /**
-     * Unhover the specified entities
+     * Unhover the specified entities.
+     * Removes hover highlighting from the entities with the given IDs.
+     *
+     * @param ids - Array of entity object IDs to unhover
      */
     AcTrLayout.prototype.unhover = function (ids) {
         var _this = this;
@@ -259,7 +318,10 @@ var AcTrLayout = /** @class */ (function () {
         });
     };
     /**
-     * Select the specified entities
+     * Select the specified entities.
+     * Applies selection highlighting to the entities with the given IDs.
+     *
+     * @param ids - Array of entity object IDs to select
      */
     AcTrLayout.prototype.select = function (ids) {
         var _this = this;
@@ -271,7 +333,10 @@ var AcTrLayout = /** @class */ (function () {
         });
     };
     /**
-     * Unselect the specified entities
+     * Unselect the specified entities.
+     * Removes selection highlighting from the entities with the given IDs.
+     *
+     * @param ids - Array of entity object IDs to unselect
      */
     AcTrLayout.prototype.unselect = function (ids) {
         var _this = this;
@@ -282,6 +347,12 @@ var AcTrLayout = /** @class */ (function () {
             }
         });
     };
+    /**
+     * Sets the snap points object for this layout.
+     * Replaces any existing snap points object with the new one.
+     *
+     * @param object - The snap points object to display
+     */
     AcTrLayout.prototype.setSnapObject = function (object) {
         if (this._snapPointsObject) {
             this._group.remove(this._snapPointsObject);
@@ -291,8 +362,10 @@ var AcTrLayout = /** @class */ (function () {
     };
     /**
      * Search entities intersected or contained in the specified bounding box.
-     * @param box Input the query bounding box
-     * @returns Return query results
+     * Uses the spatial index for efficient querying of entities within the given bounds.
+     *
+     * @param box - Input the query bounding box (2D or 3D)
+     * @returns Return query results containing entity IDs and their bounds
      */
     AcTrLayout.prototype.search = function (box) {
         var results = this._indexTree.search({
@@ -303,6 +376,12 @@ var AcTrLayout = /** @class */ (function () {
         });
         return results;
     };
+    /**
+     * Finds the layer containing the entity with the specified object ID.
+     *
+     * @param objectId - The object ID to search for
+     * @returns The layer containing the entity, or undefined if not found
+     */
     AcTrLayout.prototype.getLayerByObjectId = function (objectId) {
         var e_3, _a;
         try {
@@ -323,10 +402,11 @@ var AcTrLayout = /** @class */ (function () {
     };
     /**
      * Get layer group by name. If the layer doesn't exist, create one layer group into this layout.
-     * @param name Input layer name
-     * @param createIfNotExist Input one flag to indicate whether to create layer group if it doesn't exist in
-     * this layout.
-     * @returns Return matched layer
+     *
+     * @param name - Input layer name
+     * @param createIfNotExist - Input one flag to indicate whether to create layer group if it doesn't exist in
+     * this layout. Defaults to true.
+     * @returns Return matched layer, or undefined if not found and createIfNotExist is false
      */
     AcTrLayout.prototype.getLayer = function (name, createIfNotExist) {
         if (createIfNotExist === void 0) { createIfNotExist = true; }

package/lib/view/AcTrLayout.js.map

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

package/lib/view/AcTrLayoutView.d.ts

@@ -1,56 +1,114 @@
 import { AcTrBaseView, AcTrRenderer, AcTrViewportView } from '@mlightcad/three-renderer';
 import { AcEdViewMode } from '../editor/view/AcEdBaseView';
 import { AcTrScene } from './AcTrScene';
+/**
+ * Interface for database entity event arguments.
+ * Provides context information for entity-related events.
+ */
 export interface AcDbEntityEventArgs {
+    /** The layout view associated with the event */
     view: AcTrLayoutView;
 }
 /**
  * Each layout has its own camera and camera control. This class represents view associated with one layout.
+ *
+ * A layout view manages the visual representation and interaction for a specific AutoCAD layout.
+ * It provides:
+ * - Camera and view controls specific to the layout
+ * - Viewport management for paper space layouts
+ * - View mode switching (selection, pan, etc.)
+ * - Axes gizmo for orientation feedback
+ * - Rendering coordination with viewports
+ *
+ * The layout view coordinates between the layout's data (entities, layers) and the visual
+ * presentation, handling camera positioning, user interaction modes, and multi-viewport
+ * rendering for paper space layouts.
+ *
+ * @example
+ * ```typescript
+ * const layoutView = new AcTrLayoutView(renderer, layoutId, 800, 600);
+ * layoutView.mode = AcEdViewMode.PAN;
+ * layoutView.render(scene);
+ * ```
  */
 export declare class AcTrLayoutView extends AcTrBaseView {
+    /** The block table record ID associated with this layout */
     private _layoutBtrId;
+    /** The axes gizmo for showing coordinate system orientation */
     private _axesGizmo;
+    /** The current view mode (selection, pan, etc.) */
     private _mode;
+    /** Map of viewport views indexed by viewport ID */
     private _viewportViews;
     /**
-     * Construct one instance of this class
-     * @param layoutBtrId Input the id of the block table record associated the layout
-     * @param renderer Input renderer
-     * @param width Input width of this view
-     * @param height Input height of this view
+     * Construct one instance of this class.
+     *
+     * @param renderer - Input renderer for this view
+     * @param layoutBtrId - Input the id of the block table record associated the layout
+     * @param width - Input width of this view in pixels
+     * @param height - Input height of this view in pixels
      */
     constructor(renderer: AcTrRenderer, layoutBtrId: string, width: number, height: number);
+    /**
+     * Gets the block table record ID associated with this layout.
+     *
+     * @returns The layout's block table record ID
+     */
     get layoutBtrId(): string;
     /**
-     * The view mode of the current layout view
+     * The view mode of the current layout view.
+     * Controls how mouse interactions are interpreted (selection vs pan mode).
      */
     get mode(): AcEdViewMode;
     set mode(value: AcEdViewMode);
     /**
-     * The number of viewports in this layout view
+     * The number of viewports in this layout view.
+     * Paper space layouts can contain multiple viewports showing different views of model space.
      */
     get viewportCount(): number;
     /**
-     * Add one viewport view instance to this layout view
-     * @param viewportView Input one viewport instance
+     * Add one viewport view instance to this layout view.
+     * Viewports are used in paper space layouts to show different views of the model.
+     *
+     * @param viewportView - Input one viewport instance to add
      */
     addViewport(viewportView: AcTrViewportView): void;
     /**
-     * Remove the specified viewport view by its id from this layout view
-     * @param id Input the id of one viewport instance
+     * Remove the specified viewport view by its id from this layout view.
+     *
+     * @param id - Input the id of one viewport instance to remove
      */
     removeViewport(id: string): void;
     /**
-     * Resize this layout view
-     * @param width Input new width of the layout view
-     * @param height Input new height of the layout view
+     * Resize this layout view.
+     * Updates the view dimensions and notifies all viewports of the size change.
+     *
+     * @param width - Input new width of the layout view in pixels
+     * @param height - Input new height of the layout view in pixels
      */
     resize(width: number, height: number): void;
+    /**
+     * Renders the scene in this layout view.
+     * Performs the main rendering pass and then renders any viewports if present.
+     * Updates the axes gizmo to reflect the current camera orientation.
+     *
+     * @param scene - The scene containing the layout data to render
+     */
     render(scene: AcTrScene): void;
+    /**
+     * Creates and configures the axes gizmo for this view.
+     * The gizmo shows the current coordinate system orientation and is positioned
+     * at the bottom-left of the view without a Z-axis (2D view).
+     *
+     * @returns The configured axes gizmo instance
+     */
     private createAxesGizmo;
     /**
-     * Draw viewports
-     * @param scene Input the scene to draw
+     * Draw viewports into the current rendering context.
+     * Handles the complex rendering process for paper space layouts that contain
+     * multiple viewports, each with their own view of model space.
+     *
+     * @param scene - Input the scene object to draw in each viewport
      */
     private drawViewports;
 }