@mlightcad/data-model 1.1.2 → 1.1.4

package/lib/entity/AcDbTable.d.ts

@@ -1,36 +1,68 @@
 import { AcGeBox3d } from '@mlightcad/geometry-engine';
 import { AcGiEntity, AcGiMTextAttachmentPoint, AcGiRenderer } from '@mlightcad/graphic-interface';
 import { AcDbBlockReference } from './AcDbBlockReference';
+/**
+ * Interface defining the properties of a table cell within an AcDbTable entity.
+ *
+ * Table cells can contain various types of content including text, blocks, and other
+ * entities. Each cell has properties that control its appearance, content, and behavior.
+ */
 export interface AcDbTableCell {
+    /** The text content displayed in the cell */
     text: string;
+    /** The attachment point for text positioning within the cell */
     attachmentPoint: AcGiMTextAttachmentPoint;
+    /** Optional text style name for the cell content */
     textStyle?: string;
+    /** Optional rotation angle for the cell content in radians */
     rotation?: number;
+    /** The type of cell (text, block, etc.) */
     cellType: number;
+    /** Optional flag value for cell behavior */
     flagValue?: number;
+    /** Optional value indicating merged cell information */
     mergedValue?: number;
+    /** Optional auto-fit behavior setting */
     autoFit?: number;
+    /** Optional border width for merged cells */
     borderWidth?: number;
+    /** Optional border height for merged cells */
     borderHeight?: number;
+    /** Optional override flag for cell properties */
     overrideFlag?: number;
+    /** Optional virtual edge flag for cell borders */
     virtualEdgeFlag?: number;
+    /** Optional field object ID for text type cells */
     fieldObjetId?: string;
+    /** Optional block table record ID for block type cells */
     blockTableRecordId?: string;
+    /** Optional scale factor for block type cells */
     blockScale?: number;
+    /** Optional number of block attributes */
     blockAttrNum?: number;
+    /** Optional array of attribute definition IDs */
     attrDefineId?: string[];
+    /** Optional attribute text content */
     attrText?: string;
+    /** The height of text in the cell */
     textHeight: number;
+    /** Extended cell flags from AutoCAD 2007 and later */
     extendedCellFlags?: number;
 }
 /**
- * The class represents the table entity in AutoCAD. A table is generally thought of as an n x m rectangular
- * array of cells whose contents consist of annotation objects, primarily text. Tables often contain a title
- * row, a header row, and multiple data rows.
+ * Represents a table entity in AutoCAD.
+ *
+ * A table is generally thought of as an n x m rectangular array of cells whose contents
+ * consist of annotation objects, primarily text. Tables often contain a title row, a
+ * header row, and multiple data rows.
  *
- * After creating a new table object using the constructor, applications usually need to set the table style,
- * number of rows and columns, column width, row height, insert position, width direction, and normal vector.
- * Applications can also enter text or block contents into each cell using methods of this class.
+ * After creating a new table object using the constructor, applications usually need to
+ * set the table style, number of rows and columns, column width, row height, insert
+ * position, width direction, and normal vector. Applications can also enter text or
+ * block contents into each cell using methods of this class.
+ *
+ * Tables are commonly used for bills of materials, schedules, data sheets, and other
+ * tabular information in technical drawings and documentation.
  */
 export declare class AcDbTable extends AcDbBlockReference {
     private _attachmentPoint;
@@ -39,103 +71,188 @@ export declare class AcDbTable extends AcDbBlockReference {
     private _rowHeight;
     private _columnWidth;
     private _cells;
+    /**
+     * Creates a new table entity.
+     *
+     * @param name - The name of the table block reference
+     * @param numRows - The number of rows in the table
+     * @param numColumns - The number of columns in the table
+     */
     constructor(name: string, numRows: number, numColumns: number);
     /**
-     * Cell alignment value of this table.
+     * Gets or sets the cell alignment value for this table.
+     *
+     * This property controls how text is positioned within table cells by default.
+     * Individual cells can override this setting with their own attachment point.
+     *
+     * @returns The default attachment point for table cells
      */
     get attachmentPoint(): AcGiMTextAttachmentPoint;
     set attachmentPoint(value: AcGiMTextAttachmentPoint);
     /**
-     * The number of rows in the table.
+     * Gets or sets the number of rows in the table.
+     *
+     * Changing this value will resize the table and may affect existing cell data.
+     *
+     * @returns The current number of rows in the table
      */
     get numRows(): number;
     set numRows(value: number);
     /**
-     * The number of columns in the table.
+     * Gets or sets the number of columns in the table.
+     *
+     * Changing this value will resize the table and may affect existing cell data.
+     *
+     * @returns The current number of columns in the table
      */
     get numColumns(): number;
     set numColumns(value: number);
     /**
-     * Get the number of contents in the specified cell.
-     * @param row Input row index. It should be more than or equal to 0 and less than the number of rows.
-     * @param col Input column index. It should be more than or equal to 0 and less than the number of columns.
-     * @returns Return the number of contents in the specified cell.
+     * Gets the number of contents in the specified cell.
+     *
+     * @param row - Row index. Must be greater than or equal to 0 and less than the number of rows
+     * @param col - Column index. Must be greater than or equal to 0 and less than the number of columns
+     * @returns The number of contents in the specified cell
      */
     numContents(row: number, col: number): number;
     /**
-     * Get the row height of the specified row in the table.
-     * @param index Input zero-based row index
-     * @returns Return the row height of the specified row in the table.
+     * Gets the row height of the specified row in the table.
+     *
+     * @param index - Zero-based row index
+     * @returns The row height of the specified row in the table
      */
     rowHeight(index: number): number;
     /**
-     * Set the row height for the specified row index in the table.
-     * @param index Input zero-based row index
-     * @param height Input height to be used for the specified row
+     * Sets the row height for the specified row index in the table.
+     *
+     * @param index - Zero-based row index
+     * @param height - Height to be used for the specified row
      */
     setRowHeight(index: number, height: number): void;
     /**
-     * Set a uniform row height for all the rows in the table.
-     * @param height Input height to be used for all the rows in the table
+     * Sets a uniform row height for all the rows in the table.
+     *
+     * @param height - Height to be used for all the rows in the table
      */
     setUniformRowHeight(height: number): void;
     /**
-     * Get the column width at the specified column index in the table.
+     * Gets the column width at the specified column index in the table.
+     *
+     * @param index - Zero-based column index
+     * @returns The width of the specified column
      */
     columnWidth(index: number): number;
     /**
-     * Set a uniform column width for all the columns in the table.
-     * @param width Input uniform width to be used for all the columns in the table
+     * Sets a uniform column width for all the columns in the table.
+     *
+     * @param width - Uniform width to be used for all the columns in the table
      */
     setUniformColumnWidth(width: number): void;
     /**
-     * Set the column width at the specified column index in the table.
-     * @param index Input zero-based column index
-     * @param width Input width to be used for the specified column
+     * Sets the column width at the specified column index in the table.
+     *
+     * @param index - Zero-based column index
+     * @param width - Width to be used for the specified column
      */
     setColumnWidth(index: number, width: number): void;
     /**
-     * Get the cell by index.
-     * @param index Input cell index
-     * @returns Return the specified cell by index
+     * Gets the cell at the specified index.
+     *
+     * @param index - Cell index (calculated as row * numColumns + column)
+     * @returns The specified cell by index, or undefined if index is out of range
      */
     cell(index: number): AcDbTableCell | undefined;
     /**
-     * Set the cell by index.
-     * @param index Input cell index
+     * Sets the cell at the specified index.
+     *
+     * @param index - Cell index (calculated as row * numColumns + column)
+     * @param cell - The cell data to set
      */
     setCell(index: number, cell: AcDbTableCell): void;
     /**
-     * Get text string in the specified cell.
-     * @param row Input integer specifying the zero-based row index for the cell
-     * @param col Input integer specifying the zero-based column index for the cell
-     * @param content Input content index. It should be more than or equal to 0 and less than the number of contents.
+     * Gets the text string in the specified cell.
+     *
+     * @param row - Integer specifying the zero-based row index for the cell
+     * @param col - Integer specifying the zero-based column index for the cell
+     * @param content - Content index. Should be greater than or equal to 0 and less than the number of contents
+     * @returns The text string in the specified cell
      */
     textString(row: number, col: number, content?: number): string;
     /**
-     * Set the text for the first content at the specified content index.
-     * @param row Input integer specifying the zero-based row index for the cell
-     * @param col Input integer specifying the zero-based column index for the cell
-     * @param text Input text string
+     * Sets the text for the first content at the specified content index.
+     *
+     * @param row - Integer specifying the zero-based row index for the cell
+     * @param col - Integer specifying the zero-based column index for the cell
+     * @param text - Text string to set
      */
     setTextString(row: number, col: number, text: string): void;
     /**
-     * Return true if the content of the specified cell is empty
-     * @param row Input integer specifying the zero-based row index for the cell
-     * @param col Input integer specifying the zero-based column index for the cell
-     * @returns Return true if the content of the specified cell is empty. Otherwise, return false.
+     * Checks if the content of the specified cell is empty.
+     *
+     * @param row - Integer specifying the zero-based row index for the cell
+     * @param col - Integer specifying the zero-based column index for the cell
+     * @returns True if the content of the specified cell is empty, false otherwise
      */
     isEmpty(row: number, col: number): boolean;
     /**
+     * Gets the geometric extents (bounding box) of this table entity.
+     *
+     * The geometric extents define the minimum bounding box that completely contains
+     * the table entity, including all its cells, borders, and content.
+     *
+     * @returns A 3D bounding box containing the table entity
      * @inheritdoc
      */
     get geometricExtents(): AcGeBox3d;
     /**
+     * Renders the table entity using the specified graphics renderer.
+     *
+     * This method draws the table structure including borders, cell content, and text.
+     * It handles the rendering of individual cells, merged cells, and applies the
+     * appropriate transformations and styling.
+     *
+     * @param renderer - The graphics renderer used to draw the table
+     * @returns The rendered graphics entity representing the table
      * @inheritdoc
      */
     draw(renderer: AcGiRenderer): AcGiEntity;
+    /**
+     * Marks cells as visited to handle merged cell rendering.
+     *
+     * This method prevents duplicate rendering of merged cells by marking all
+     * constituent cells as visited.
+     *
+     * @param visited - Array tracking which cells have been processed
+     * @param currentIndex - Index of the current cell being processed
+     * @param columnCount - Total number of columns in the table
+     * @param columnSpan - Number of columns this cell spans
+     * @param rowSpan - Number of rows this cell spans
+     * @private
+     */
     private fillVisited;
+    /**
+     * Gets the text style for a specific cell.
+     *
+     * This method retrieves the appropriate text style for the cell, falling back
+     * to the standard style if no specific style is specified.
+     *
+     * @param cell - The cell for which to get the text style
+     * @returns The text style configuration for the cell
+     * @private
+     */
     private getTextStyle;
+    /**
+     * Calculates the text offset within a table cell based on attachment point.
+     *
+     * This method determines the appropriate positioning offset for text within
+     * a cell based on the specified attachment point and cell dimensions.
+     *
+     * @param textAlign - The text alignment/attachment point value
+     * @param width - The width of the cell
+     * @param height - The height of the cell
+     * @returns A vector representing the text offset from the cell corner
+     * @private
+     */
     private getTableTextOffset;
 }
 //# sourceMappingURL=AcDbTable.d.ts.map

package/lib/entity/AcDbTable.d.ts.map

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

package/lib/entity/AcDbTable.js

@@ -29,16 +29,29 @@ import { AcGiMTextAttachmentPoint } from '@mlightcad/graphic-interface';
 import { AcDbBlockReference } from './AcDbBlockReference';
 var tempVector = /*@__PURE__*/ new AcGeVector3d();
 /**
- * The class represents the table entity in AutoCAD. A table is generally thought of as an n x m rectangular
- * array of cells whose contents consist of annotation objects, primarily text. Tables often contain a title
- * row, a header row, and multiple data rows.
+ * Represents a table entity in AutoCAD.
  *
- * After creating a new table object using the constructor, applications usually need to set the table style,
- * number of rows and columns, column width, row height, insert position, width direction, and normal vector.
- * Applications can also enter text or block contents into each cell using methods of this class.
+ * A table is generally thought of as an n x m rectangular array of cells whose contents
+ * consist of annotation objects, primarily text. Tables often contain a title row, a
+ * header row, and multiple data rows.
+ *
+ * After creating a new table object using the constructor, applications usually need to
+ * set the table style, number of rows and columns, column width, row height, insert
+ * position, width direction, and normal vector. Applications can also enter text or
+ * block contents into each cell using methods of this class.
+ *
+ * Tables are commonly used for bills of materials, schedules, data sheets, and other
+ * tabular information in technical drawings and documentation.
  */
 var AcDbTable = /** @class */ (function (_super) {
     __extends(AcDbTable, _super);
+    /**
+     * Creates a new table entity.
+     *
+     * @param name - The name of the table block reference
+     * @param numRows - The number of rows in the table
+     * @param numColumns - The number of columns in the table
+     */
     function AcDbTable(name, numRows, numColumns) {
         var _this = _super.call(this, name) || this;
         _this._attachmentPoint = AcGiMTextAttachmentPoint.TopLeft;
@@ -51,7 +64,12 @@ var AcDbTable = /** @class */ (function (_super) {
     }
     Object.defineProperty(AcDbTable.prototype, "attachmentPoint", {
         /**
-         * Cell alignment value of this table.
+         * Gets or sets the cell alignment value for this table.
+         *
+         * This property controls how text is positioned within table cells by default.
+         * Individual cells can override this setting with their own attachment point.
+         *
+         * @returns The default attachment point for table cells
          */
         get: function () {
             return this._attachmentPoint;
@@ -64,7 +82,11 @@ var AcDbTable = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbTable.prototype, "numRows", {
         /**
-         * The number of rows in the table.
+         * Gets or sets the number of rows in the table.
+         *
+         * Changing this value will resize the table and may affect existing cell data.
+         *
+         * @returns The current number of rows in the table
          */
         get: function () {
             return this._numRows;
@@ -77,7 +99,11 @@ var AcDbTable = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbTable.prototype, "numColumns", {
         /**
-         * The number of columns in the table.
+         * Gets or sets the number of columns in the table.
+         *
+         * Changing this value will resize the table and may affect existing cell data.
+         *
+         * @returns The current number of columns in the table
          */
         get: function () {
             return this._numColumns;
@@ -89,10 +115,11 @@ var AcDbTable = /** @class */ (function (_super) {
         configurable: true
     });
     /**
-     * Get the number of contents in the specified cell.
-     * @param row Input row index. It should be more than or equal to 0 and less than the number of rows.
-     * @param col Input column index. It should be more than or equal to 0 and less than the number of columns.
-     * @returns Return the number of contents in the specified cell.
+     * Gets the number of contents in the specified cell.
+     *
+     * @param row - Row index. Must be greater than or equal to 0 and less than the number of rows
+     * @param col - Column index. Must be greater than or equal to 0 and less than the number of columns
+     * @returns The number of contents in the specified cell
      */
     // @ts-expect-error not use '_' prefix so that typedoc can the correct parameter to generate doc
     AcDbTable.prototype.numContents = function (row, col) {
@@ -100,53 +127,62 @@ var AcDbTable = /** @class */ (function (_super) {
         return 1;
     };
     /**
-     * Get the row height of the specified row in the table.
-     * @param index Input zero-based row index
-     * @returns Return the row height of the specified row in the table.
+     * Gets the row height of the specified row in the table.
+     *
+     * @param index - Zero-based row index
+     * @returns The row height of the specified row in the table
      */
     AcDbTable.prototype.rowHeight = function (index) {
         return this._rowHeight[index];
     };
     /**
-     * Set the row height for the specified row index in the table.
-     * @param index Input zero-based row index
-     * @param height Input height to be used for the specified row
+     * Sets the row height for the specified row index in the table.
+     *
+     * @param index - Zero-based row index
+     * @param height - Height to be used for the specified row
      */
     AcDbTable.prototype.setRowHeight = function (index, height) {
         this._rowHeight[index] = height;
     };
     /**
-     * Set a uniform row height for all the rows in the table.
-     * @param height Input height to be used for all the rows in the table
+     * Sets a uniform row height for all the rows in the table.
+     *
+     * @param height - Height to be used for all the rows in the table
      */
     AcDbTable.prototype.setUniformRowHeight = function (height) {
         this._rowHeight.fill(height);
     };
     /**
-     * Get the column width at the specified column index in the table.
+     * Gets the column width at the specified column index in the table.
+     *
+     * @param index - Zero-based column index
+     * @returns The width of the specified column
      */
     AcDbTable.prototype.columnWidth = function (index) {
         return this._columnWidth[index];
     };
     /**
-     * Set a uniform column width for all the columns in the table.
-     * @param width Input uniform width to be used for all the columns in the table
+     * Sets a uniform column width for all the columns in the table.
+     *
+     * @param width - Uniform width to be used for all the columns in the table
      */
     AcDbTable.prototype.setUniformColumnWidth = function (width) {
         this._columnWidth.fill(width);
     };
     /**
-     * Set the column width at the specified column index in the table.
-     * @param index Input zero-based column index
-     * @param width Input width to be used for the specified column
+     * Sets the column width at the specified column index in the table.
+     *
+     * @param index - Zero-based column index
+     * @param width - Width to be used for the specified column
      */
     AcDbTable.prototype.setColumnWidth = function (index, width) {
         this._columnWidth[index] = width;
     };
     /**
-     * Get the cell by index.
-     * @param index Input cell index
-     * @returns Return the specified cell by index
+     * Gets the cell at the specified index.
+     *
+     * @param index - Cell index (calculated as row * numColumns + column)
+     * @returns The specified cell by index, or undefined if index is out of range
      */
     AcDbTable.prototype.cell = function (index) {
         if (index < 0 || index >= this._cells.length)
@@ -154,42 +190,54 @@ var AcDbTable = /** @class */ (function (_super) {
         return this._cells[index];
     };
     /**
-     * Set the cell by index.
-     * @param index Input cell index
+     * Sets the cell at the specified index.
+     *
+     * @param index - Cell index (calculated as row * numColumns + column)
+     * @param cell - The cell data to set
      */
     AcDbTable.prototype.setCell = function (index, cell) {
         this._cells[index] = cell;
     };
     /**
-     * Get text string in the specified cell.
-     * @param row Input integer specifying the zero-based row index for the cell
-     * @param col Input integer specifying the zero-based column index for the cell
-     * @param content Input content index. It should be more than or equal to 0 and less than the number of contents.
+     * Gets the text string in the specified cell.
+     *
+     * @param row - Integer specifying the zero-based row index for the cell
+     * @param col - Integer specifying the zero-based column index for the cell
+     * @param content - Content index. Should be greater than or equal to 0 and less than the number of contents
+     * @returns The text string in the specified cell
      */
     // @ts-expect-error not use '_' prefix so that typedoc can the correct parameter to generate doc
     AcDbTable.prototype.textString = function (row, col, content) {
         return this._cells[row * col].text;
     };
     /**
-     * Set the text for the first content at the specified content index.
-     * @param row Input integer specifying the zero-based row index for the cell
-     * @param col Input integer specifying the zero-based column index for the cell
-     * @param text Input text string
+     * Sets the text for the first content at the specified content index.
+     *
+     * @param row - Integer specifying the zero-based row index for the cell
+     * @param col - Integer specifying the zero-based column index for the cell
+     * @param text - Text string to set
      */
     AcDbTable.prototype.setTextString = function (row, col, text) {
         this._cells[row * col].text = text;
     };
     /**
-     * Return true if the content of the specified cell is empty
-     * @param row Input integer specifying the zero-based row index for the cell
-     * @param col Input integer specifying the zero-based column index for the cell
-     * @returns Return true if the content of the specified cell is empty. Otherwise, return false.
+     * Checks if the content of the specified cell is empty.
+     *
+     * @param row - Integer specifying the zero-based row index for the cell
+     * @param col - Integer specifying the zero-based column index for the cell
+     * @returns True if the content of the specified cell is empty, false otherwise
      */
     AcDbTable.prototype.isEmpty = function (row, col) {
         return !this._cells[row * col].text;
     };
     Object.defineProperty(AcDbTable.prototype, "geometricExtents", {
         /**
+         * Gets the geometric extents (bounding box) of this table entity.
+         *
+         * The geometric extents define the minimum bounding box that completely contains
+         * the table entity, including all its cells, borders, and content.
+         *
+         * @returns A 3D bounding box containing the table entity
          * @inheritdoc
          */
         get: function () {
@@ -200,6 +248,14 @@ var AcDbTable = /** @class */ (function (_super) {
         configurable: true
     });
     /**
+     * Renders the table entity using the specified graphics renderer.
+     *
+     * This method draws the table structure including borders, cell content, and text.
+     * It handles the rendering of individual cells, merged cells, and applies the
+     * appropriate transformations and styling.
+     *
+     * @param renderer - The graphics renderer used to draw the table
+     * @returns The rendered graphics entity representing the table
      * @inheritdoc
      */
     AcDbTable.prototype.draw = function (renderer) {
@@ -287,6 +343,19 @@ var AcDbTable = /** @class */ (function (_super) {
         group.applyMatrix(_tmpMatrix);
         return group;
     };
+    /**
+     * Marks cells as visited to handle merged cell rendering.
+     *
+     * This method prevents duplicate rendering of merged cells by marking all
+     * constituent cells as visited.
+     *
+     * @param visited - Array tracking which cells have been processed
+     * @param currentIndex - Index of the current cell being processed
+     * @param columnCount - Total number of columns in the table
+     * @param columnSpan - Number of columns this cell spans
+     * @param rowSpan - Number of rows this cell spans
+     * @private
+     */
     AcDbTable.prototype.fillVisited = function (visited, currentIndex, columnCount, columnSpan, rowSpan) {
         if (rowSpan == 1 && columnSpan == 1) {
             visited[currentIndex] = true;
@@ -299,6 +368,16 @@ var AcDbTable = /** @class */ (function (_super) {
             }
         }
     };
+    /**
+     * Gets the text style for a specific cell.
+     *
+     * This method retrieves the appropriate text style for the cell, falling back
+     * to the standard style if no specific style is specified.
+     *
+     * @param cell - The cell for which to get the text style
+     * @returns The text style configuration for the cell
+     * @private
+     */
     AcDbTable.prototype.getTextStyle = function (cell) {
         var textStyleTable = this.database.tables.textStyleTable;
         var style;
@@ -311,6 +390,18 @@ var AcDbTable = /** @class */ (function (_super) {
         }
         return style.textStyle;
     };
+    /**
+     * Calculates the text offset within a table cell based on attachment point.
+     *
+     * This method determines the appropriate positioning offset for text within
+     * a cell based on the specified attachment point and cell dimensions.
+     *
+     * @param textAlign - The text alignment/attachment point value
+     * @param width - The width of the cell
+     * @param height - The height of the cell
+     * @returns A vector representing the text offset from the cell corner
+     * @private
+     */
     AcDbTable.prototype.getTableTextOffset = function (textAlign, width, height) {
         var offset = new AcGeVector3d();
         switch (textAlign) {