@mlightcad/data-model 1.1.1 → 1.1.3

package/lib/entity/AcDbViewport.js

@@ -16,8 +16,41 @@ var __extends = (this && this.__extends) || (function () {
 import { AcGeBox3d, AcGePoint3d } from '@mlightcad/geometry-engine';
 import { AcGiViewport } from '@mlightcad/graphic-interface';
 import { AcDbEntity } from './AcDbEntity';
+/**
+ * Represents a viewport entity in AutoCAD drawings.
+ *
+ * A viewport is a rectangular window that displays a portion of the drawing model space
+ * within paper space layouts. Viewports allow users to create multiple views of the same
+ * drawing at different scales and orientations on a single sheet.
+ *
+ * Key characteristics:
+ * - Viewports exist primarily in paper space layouts
+ * - Each viewport has a unique ID number (except the default system viewport with ID 1)
+ * - Viewports can be active or inactive
+ * - The viewport entity itself is drawn as a rectangular border in paper space
+ *
+ * @example
+ * ```typescript
+ * const viewport = new AcDbViewport();
+ * viewport.centerPoint = new AcGePoint3d(0, 0, 0);
+ * viewport.width = 10;
+ * viewport.height = 8;
+ * viewport.number = 2;
+ * ```
+ */
 var AcDbViewport = /** @class */ (function (_super) {
     __extends(AcDbViewport, _super);
+    /**
+     * Creates a new AcDbViewport instance.
+     *
+     * Initializes all properties with default values:
+     * - centerPoint: origin (0,0,0)
+     * - height: 0
+     * - width: 0
+     * - viewCenter: origin (0,0,0)
+     * - viewHeight: 0
+     * - number: -1 (indicating inactive viewport)
+     */
     function AcDbViewport() {
         var _this = _super.call(this) || this;
         _this._centerPoint = new AcGePoint3d();
@@ -30,10 +63,19 @@ var AcDbViewport = /** @class */ (function (_super) {
     }
     Object.defineProperty(AcDbViewport.prototype, "number", {
         /**
-         * The viewport ID number. This is the number that is reported by the AutoCAD CVPORT system variable
+         * Gets or sets the viewport ID number.
+         *
+         * This is the number that is reported by the AutoCAD CVPORT system variable
          * when the viewport is the current viewport in the AutoCAD editor. If the viewport is inactive, -1
          * is returned.
-         * This value is not saved with the drawing, and changes each time the drawing is opened.
+         *
+         * Important notes:
+         * - This value is not saved with the drawing, and changes each time the drawing is opened
+         * - Viewport ID 1 is reserved for the system-defined default viewport in paper space
+         * - Active viewports have IDs greater than 1
+         * - Inactive viewports return -1
+         *
+         * @returns The viewport ID number
          */
         get: function () {
             return this._number;
@@ -46,7 +88,12 @@ var AcDbViewport = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbViewport.prototype, "centerPoint", {
         /**
-         * The center point of the viewport entity in WCS coordinates (within Paper Space).
+         * Gets or sets the center point of the viewport entity in WCS coordinates (within Paper Space).
+         *
+         * This point represents the geometric center of the viewport's rectangular boundary
+         * in paper space coordinates, not the center of the model space view within the viewport.
+         *
+         * @returns The center point of the viewport entity
          */
         get: function () {
             return this._centerPoint;
@@ -59,7 +106,13 @@ var AcDbViewport = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbViewport.prototype, "height", {
         /**
-         * The height of the viewport entity's window in drawing units.
+         * Gets or sets the height of the viewport entity's window in drawing units.
+         *
+         * This represents the height of the viewport's rectangular boundary in paper space,
+         * measured in the current drawing units. It defines the vertical extent of the
+         * viewport border, not the height of the model space view within it.
+         *
+         * @returns The height of the viewport entity in drawing units
          */
         get: function () {
             return this._height;
@@ -72,8 +125,16 @@ var AcDbViewport = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbViewport.prototype, "width", {
         /**
-         * The width of the viewport entity's window in drawing units. This is the width in Paper Space
-         * of the viewport itself, not the width of the Model Space view within the viewport.
+         * Gets or sets the width of the viewport entity's window in drawing units.
+         *
+         * This represents the width of the viewport's rectangular boundary in paper space,
+         * measured in the current drawing units. It defines the horizontal extent of the
+         * viewport border, not the width of the model space view within the viewport.
+         *
+         * Note: This is the width in Paper Space of the viewport itself, not the width
+         * of the Model Space view within the viewport.
+         *
+         * @returns The width of the viewport entity in drawing units
          */
         get: function () {
             return this._width;
@@ -86,7 +147,13 @@ var AcDbViewport = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbViewport.prototype, "viewCenter", {
         /**
-         * The view center (in display coordinate system coordinates) of the view in the viewport.
+         * Gets or sets the view center in display coordinate system coordinates.
+         *
+         * This point represents the center of the model space view that is displayed
+         * within the viewport. It is specified in the display coordinate system and
+         * determines what portion of the model space drawing is visible in the viewport.
+         *
+         * @returns The center point of the model space view within the viewport
          */
         get: function () {
             return this._viewCenter;
@@ -99,8 +166,16 @@ var AcDbViewport = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbViewport.prototype, "viewHeight", {
         /**
-         * The height (in display coordinate system coordinates) of the Model Space view within the viewport.
-         * Zooming the view out within the viewport increases this value and zooming in decreases this value.
+         * Gets or sets the height of the Model Space view within the viewport.
+         *
+         * This value represents the height of the model space view that is displayed
+         * within the viewport, specified in display coordinate system coordinates.
+         *
+         * Zoom behavior:
+         * - Zooming the view out within the viewport increases this value
+         * - Zooming the view in within the viewport decreases this value
+         *
+         * @returns The height of the model space view in display coordinates
          */
         get: function () {
             return this._viewHeight;
@@ -113,6 +188,12 @@ var AcDbViewport = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbViewport.prototype, "geometricExtents", {
         /**
+         * Gets the geometric extents of the viewport entity.
+         *
+         * This method returns a bounding box that encompasses the entire viewport entity
+         * in world coordinate system (WCS) coordinates.
+         *
+         * @returns A bounding box containing the viewport entity
          * @inheritdoc
          */
         get: function () {
@@ -123,6 +204,18 @@ var AcDbViewport = /** @class */ (function (_super) {
         configurable: true
     });
     /**
+     * Renders the viewport entity using the specified renderer.
+     *
+     * The viewport is drawn as a rectangular border when the following conditions are met:
+     * - The viewport entity is not in model space (i.e., it's in paper space)
+     * - The viewport ID number is greater than 1 (not the default system viewport)
+     *
+     * In paper space layouts, there is always a system-defined "default" viewport that exists as
+     * the bottom-most item. This viewport doesn't show any entities and is mainly for internal
+     * AutoCAD purposes. The viewport ID number of this system-defined "default" viewport is 1.
+     *
+     * @param renderer - The renderer to use for drawing the viewport
+     * @returns A render group containing the viewport border lines, or undefined if not drawn
      * @inheritdoc
      */
     AcDbViewport.prototype.draw = function (renderer) {
@@ -141,6 +234,14 @@ var AcDbViewport = /** @class */ (function (_super) {
         }
         return undefined;
     };
+    /**
+     * Converts this AcDbViewport to an AcGiViewport for rendering purposes.
+     *
+     * This method creates a graphic interface viewport object that contains all the
+     * necessary properties for rendering the viewport in the graphics system.
+     *
+     * @returns An AcGiViewport instance with all viewport properties copied
+     */
     AcDbViewport.prototype.toGiViewport = function () {
         var viewport = new AcGiViewport();
         viewport.id = this.objectId;
@@ -153,6 +254,18 @@ var AcDbViewport = /** @class */ (function (_super) {
         viewport.viewCenter = this.viewCenter;
         return viewport;
     };
+    /**
+     * Creates the rectangular border lines for the viewport.
+     *
+     * This private method generates four line entities that form a rectangle representing
+     * the viewport's boundary. The rectangle is centered on the viewport's center point
+     * and has dimensions specified by the viewport's width and height.
+     *
+     * @param viewport - The graphic interface viewport containing rendering properties
+     * @param renderer - The renderer to use for creating the line entities
+     * @returns An array of line entities forming the viewport border
+     * @private
+     */
     AcDbViewport.prototype.createViewportRect = function (viewport, renderer) {
         var lines = [];
         lines.push(renderer.lines([

package/lib/entity/AcDbViewport.js.map

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

package/lib/entity/AcDbWipeout.d.ts

@@ -1,8 +1,36 @@
 import { AcGiRenderer } from '@mlightcad/graphic-interface';
 import { AcDbRasterImage } from './AcDbRasterImage';
+/**
+ * Entity that creates a blank area in the drawing.
+ *
+ * The AcDbWipeout entity creates a blank area that covers other entities
+ * in the drawing. It's commonly used to hide parts of the drawing or
+ * create clean areas for annotations. The wipeout area is defined by
+ * a boundary path and is rendered as a solid black fill.
+ *
+ * @example
+ * ```typescript
+ * const wipeout = new AcDbWipeout();
+ * // Set up boundary path and other properties
+ * wipeout.draw(renderer);
+ * ```
+ */
 export declare class AcDbWipeout extends AcDbRasterImage {
     /**
-     * @inheritdoc
+     * Draws the wipeout entity.
+     *
+     * This method creates a solid black area based on the boundary path
+     * of the wipeout entity. The area covers all entities behind it,
+     * effectively "wiping out" that portion of the drawing.
+     *
+     * @param renderer - The renderer to use for drawing
+     * @returns The rendered entity or undefined if rendering fails
+     *
+     * @example
+     * ```typescript
+     * const wipeout = new AcDbWipeout();
+     * const renderedEntity = wipeout.draw(renderer);
+     * ```
      */
     draw(renderer: AcGiRenderer): import("@mlightcad/graphic-interface").AcGiEntity;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"AcDbWipeout.d.ts","sourceRoot":"","sources":["../../src/entity/AcDbWipeout.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD,qBAAa,WAAY,SAAQ,eAAe;IAC9C;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,YAAY;CAW5B"}
+{"version":3,"file":"AcDbWipeout.d.ts","sourceRoot":"","sources":["../../src/entity/AcDbWipeout.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAY,SAAQ,eAAe;IAC9C;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,QAAQ,EAAE,YAAY;CAW5B"}

package/lib/entity/AcDbWipeout.js

@@ -15,13 +15,41 @@ var __extends = (this && this.__extends) || (function () {
 })();
 import { AcGeArea2d, AcGePolyline2d } from '@mlightcad/geometry-engine';
 import { AcDbRasterImage } from './AcDbRasterImage';
+/**
+ * Entity that creates a blank area in the drawing.
+ *
+ * The AcDbWipeout entity creates a blank area that covers other entities
+ * in the drawing. It's commonly used to hide parts of the drawing or
+ * create clean areas for annotations. The wipeout area is defined by
+ * a boundary path and is rendered as a solid black fill.
+ *
+ * @example
+ * ```typescript
+ * const wipeout = new AcDbWipeout();
+ * // Set up boundary path and other properties
+ * wipeout.draw(renderer);
+ * ```
+ */
 var AcDbWipeout = /** @class */ (function (_super) {
     __extends(AcDbWipeout, _super);
     function AcDbWipeout() {
         return _super !== null && _super.apply(this, arguments) || this;
     }
     /**
-     * @inheritdoc
+     * Draws the wipeout entity.
+     *
+     * This method creates a solid black area based on the boundary path
+     * of the wipeout entity. The area covers all entities behind it,
+     * effectively "wiping out" that portion of the drawing.
+     *
+     * @param renderer - The renderer to use for drawing
+     * @returns The rendered entity or undefined if rendering fails
+     *
+     * @example
+     * ```typescript
+     * const wipeout = new AcDbWipeout();
+     * const renderedEntity = wipeout.draw(renderer);
+     * ```
      */
     AcDbWipeout.prototype.draw = function (renderer) {
         var points = this.boundaryPath();

package/lib/entity/AcDbWipeout.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcDbWipeout.js","sourceRoot":"","sources":["../../src/entity/AcDbWipeout.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAGvE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD;IAAiC,+BAAe;IAAhD;;IAeA,CAAC;IAdC;;OAEG;IACH,0BAAI,GAAJ,UAAK,QAAsB;QACzB,IAAM,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;QAClC,IAAM,IAAI,GAAG,IAAI,UAAU,EAAE,CAAA;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC,CAAA;QACpC,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE;YACzB,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,IAAI;YACf,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,EAAE;SACjB,CAAC,CAAA;IACJ,CAAC;IACH,kBAAC;AAAD,CAAC,AAfD,CAAiC,eAAe,GAe/C"}
+{"version":3,"file":"AcDbWipeout.js","sourceRoot":"","sources":["../../src/entity/AcDbWipeout.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAGvE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD;;;;;;;;;;;;;;GAcG;AACH;IAAiC,+BAAe;IAAhD;;IA4BA,CAAC;IA3BC;;;;;;;;;;;;;;;OAeG;IACH,0BAAI,GAAJ,UAAK,QAAsB;QACzB,IAAM,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;QAClC,IAAM,IAAI,GAAG,IAAI,UAAU,EAAE,CAAA;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC,CAAA;QACpC,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE;YACzB,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,IAAI;YACf,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,EAAE;SACjB,CAAC,CAAA;IACJ,CAAC;IACH,kBAAC;AAAD,CAAC,AA5BD,CAAiC,eAAe,GA4B/C"}

package/lib/entity/AcDbXline.d.ts

@@ -2,40 +2,147 @@ import { AcGeBox3d, AcGePoint3d } from '@mlightcad/geometry-engine';
 import { AcGiRenderer } from '@mlightcad/graphic-interface';
 import { AcDbCurve } from './AcDbCurve';
 /**
- * The class represents the XLINE entity type within AutoCAD. An xline entity is a line that extends to
- * infinity in both directions.
+ * Represents an xline entity in AutoCAD.
+ *
+ * An xline is a 3D geometric object that extends infinitely in both directions from a base point.
+ * Xlines are commonly used for construction lines, reference lines, and temporary geometry.
+ * Unlike lines, xlines have no end points and extend to infinity in both directions.
+ *
+ * @example
+ * ```typescript
+ * // Create an xline from origin in the positive X direction
+ * const xline = new AcDbXline();
+ * xline.basePoint = new AcGePoint3d(0, 0, 0);
+ * xline.unitDir = new AcGeVector3d(1, 0, 0);
+ *
+ * // Access xline properties
+ * console.log(`Base point: ${xline.basePoint}`);
+ * console.log(`Unit direction: ${xline.unitDir}`);
+ * ```
  */
 export declare class AcDbXline extends AcDbCurve {
+    /** The base point of the xline */
     private _basePoint;
+    /** The unit direction vector of the xline */
     private _unitDir;
     /**
-     * Create one empty polyline
+     * Creates a new xline entity.
+     *
+     * This constructor initializes an xline with default values.
+     * The base point is at the origin and the unit direction is undefined.
+     *
+     * @example
+     * ```typescript
+     * const xline = new AcDbXline();
+     * xline.basePoint = new AcGePoint3d(5, 10, 0);
+     * xline.unitDir = new AcGeVector3d(0, 1, 0); // Positive Y direction
+     * ```
      */
     constructor();
     /**
-     * The base point of the xline.
+     * Gets the base point of this xline.
+     *
+     * The base point is the center point from which the xline extends infinitely
+     * in both directions.
+     *
+     * @returns The base point as a 3D point
+     *
+     * @example
+     * ```typescript
+     * const basePoint = xline.basePoint;
+     * console.log(`Xline base point: ${basePoint.x}, ${basePoint.y}, ${basePoint.z}`);
+     * ```
      */
     get basePoint(): AcGePoint3d;
+    /**
+     * Sets the base point of this xline.
+     *
+     * @param value - The new base point
+     *
+     * @example
+     * ```typescript
+     * xline.basePoint = new AcGePoint3d(10, 20, 0);
+     * ```
+     */
     set basePoint(value: AcGePoint3d);
     /**
-     * The second point of the xline.
+     * Gets the unit direction vector of this xline.
+     *
+     * The unit direction vector defines the direction in which the xline extends
+     * infinitely in both directions from the base point.
+     *
+     * @returns The unit direction vector
+     *
+     * @example
+     * ```typescript
+     * const unitDir = xline.unitDir;
+     * console.log(`Xline direction: ${unitDir.x}, ${unitDir.y}, ${unitDir.z}`);
+     * ```
      */
     get unitDir(): AcGePoint3d;
+    /**
+     * Sets the unit direction vector of this xline.
+     *
+     * @param value - The new unit direction vector
+     *
+     * @example
+     * ```typescript
+     * xline.unitDir = new AcGeVector3d(0, 0, 1); // Positive Z direction
+     * ```
+     */
     set unitDir(value: AcGePoint3d);
     /**
-     * @inheritdoc
+     * Gets whether this xline is closed.
+     *
+     * Xlines are always open entities, so this always returns false.
+     *
+     * @returns Always false for xlines
      */
     get closed(): boolean;
     /**
-     * @inheritdoc
+     * Gets the geometric extents (bounding box) of this xline.
+     *
+     * Since xlines extend infinitely in both directions, this method returns a
+     * bounding box that encompasses a finite portion of the xline for practical purposes.
+     *
+     * @returns The bounding box that encompasses a portion of the xline
+     *
+     * @example
+     * ```typescript
+     * const extents = xline.geometricExtents;
+     * console.log(`Xline bounds: ${extents.minPoint} to ${extents.maxPoint}`);
+     * ```
      */
     get geometricExtents(): AcGeBox3d;
     /**
-     * @inheritdoc
+     * Gets the grip points for this xline.
+     *
+     * Grip points are control points that can be used to modify the xline.
+     * For an xline, the grip point is the base point.
+     *
+     * @returns Array of grip points (base point)
+     *
+     * @example
+     * ```typescript
+     * const gripPoints = xline.subGetGripPoints();
+     * // gripPoints contains: [basePoint]
+     * ```
      */
     subGetGripPoints(): AcGePoint3d[];
     /**
-     * @inheritdoc
+     * Draws this xline using the specified renderer.
+     *
+     * This method renders the xline as a line segment extending from the base point
+     * in both directions along the unit vector. For practical purposes, the xline is
+     * drawn with a finite length.
+     *
+     * @param renderer - The renderer to use for drawing
+     * @returns The rendered xline entity, or undefined if drawing failed
+     *
+     * @example
+     * ```typescript
+     * const renderedXline = xline.draw(renderer);
+     * ```
      */
     draw(renderer: AcGiRenderer): import("@mlightcad/graphic-interface").AcGiEntity;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"AcDbXline.d.ts","sourceRoot":"","sources":["../../src/entity/AcDbXline.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EAEZ,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC;;;GAGG;AACH,qBAAa,SAAU,SAAQ,SAAS;IACtC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAc;IAE9B;;OAEG;;IAOH;;OAEG;IACH,IAAI,SAAS,IAGQ,WAAW,CAD/B;IACD,IAAI,SAAS,CAAC,KAAK,EAAE,WAAW,EAE/B;IAED;;OAEG;IACH,IAAI,OAAO,IAGQ,WAAW,CAD7B;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,WAAW,EAE7B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,SAAS,CAShC;IAED;;OAEG;IACH,gBAAgB;IAMhB;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,YAAY;CAU5B"}
+{"version":3,"file":"AcDbXline.d.ts","sourceRoot":"","sources":["../../src/entity/AcDbXline.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EAEZ,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAU,SAAQ,SAAS;IACtC,kCAAkC;IAClC,OAAO,CAAC,UAAU,CAAa;IAC/B,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAc;IAE9B;;;;;;;;;;;;OAYG;;IAOH;;;;;;;;;;;;;OAaG;IACH,IAAI,SAAS,IAcQ,WAAW,CAZ/B;IAED;;;;;;;;;OASG;IACH,IAAI,SAAS,CAAC,KAAK,EAAE,WAAW,EAE/B;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,OAAO,IAcQ,WAAW,CAZ7B;IAED;;;;;;;;;OASG;IACH,IAAI,OAAO,CAAC,KAAK,EAAE,WAAW,EAE7B;IAED;;;;;;OAMG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,gBAAgB,IAAI,SAAS,CAShC;IAED;;;;;;;;;;;;;OAaG;IACH,gBAAgB;IAMhB;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,QAAQ,EAAE,YAAY;CAU5B"}

package/lib/entity/AcDbXline.js

@@ -16,13 +16,38 @@ var __extends = (this && this.__extends) || (function () {
 import { AcGeBox3d, AcGePoint3d, AcGeVector3d } from '@mlightcad/geometry-engine';
 import { AcDbCurve } from './AcDbCurve';
 /**
- * The class represents the XLINE entity type within AutoCAD. An xline entity is a line that extends to
- * infinity in both directions.
+ * Represents an xline entity in AutoCAD.
+ *
+ * An xline is a 3D geometric object that extends infinitely in both directions from a base point.
+ * Xlines are commonly used for construction lines, reference lines, and temporary geometry.
+ * Unlike lines, xlines have no end points and extend to infinity in both directions.
+ *
+ * @example
+ * ```typescript
+ * // Create an xline from origin in the positive X direction
+ * const xline = new AcDbXline();
+ * xline.basePoint = new AcGePoint3d(0, 0, 0);
+ * xline.unitDir = new AcGeVector3d(1, 0, 0);
+ *
+ * // Access xline properties
+ * console.log(`Base point: ${xline.basePoint}`);
+ * console.log(`Unit direction: ${xline.unitDir}`);
+ * ```
  */
 var AcDbXline = /** @class */ (function (_super) {
     __extends(AcDbXline, _super);
     /**
-     * Create one empty polyline
+     * Creates a new xline entity.
+     *
+     * This constructor initializes an xline with default values.
+     * The base point is at the origin and the unit direction is undefined.
+     *
+     * @example
+     * ```typescript
+     * const xline = new AcDbXline();
+     * xline.basePoint = new AcGePoint3d(5, 10, 0);
+     * xline.unitDir = new AcGeVector3d(0, 1, 0); // Positive Y direction
+     * ```
      */
     function AcDbXline() {
         var _this = _super.call(this) || this;
@@ -32,11 +57,32 @@ var AcDbXline = /** @class */ (function (_super) {
     }
     Object.defineProperty(AcDbXline.prototype, "basePoint", {
         /**
-         * The base point of the xline.
+         * Gets the base point of this xline.
+         *
+         * The base point is the center point from which the xline extends infinitely
+         * in both directions.
+         *
+         * @returns The base point as a 3D point
+         *
+         * @example
+         * ```typescript
+         * const basePoint = xline.basePoint;
+         * console.log(`Xline base point: ${basePoint.x}, ${basePoint.y}, ${basePoint.z}`);
+         * ```
          */
         get: function () {
             return this._basePoint;
         },
+        /**
+         * Sets the base point of this xline.
+         *
+         * @param value - The new base point
+         *
+         * @example
+         * ```typescript
+         * xline.basePoint = new AcGePoint3d(10, 20, 0);
+         * ```
+         */
         set: function (value) {
             this._basePoint.copy(value);
         },
@@ -45,11 +91,32 @@ var AcDbXline = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbXline.prototype, "unitDir", {
         /**
-         * The second point of the xline.
+         * Gets the unit direction vector of this xline.
+         *
+         * The unit direction vector defines the direction in which the xline extends
+         * infinitely in both directions from the base point.
+         *
+         * @returns The unit direction vector
+         *
+         * @example
+         * ```typescript
+         * const unitDir = xline.unitDir;
+         * console.log(`Xline direction: ${unitDir.x}, ${unitDir.y}, ${unitDir.z}`);
+         * ```
          */
         get: function () {
             return this._unitDir;
         },
+        /**
+         * Sets the unit direction vector of this xline.
+         *
+         * @param value - The new unit direction vector
+         *
+         * @example
+         * ```typescript
+         * xline.unitDir = new AcGeVector3d(0, 0, 1); // Positive Z direction
+         * ```
+         */
         set: function (value) {
             this._unitDir.copy(value);
         },
@@ -58,7 +125,11 @@ var AcDbXline = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbXline.prototype, "closed", {
         /**
-         * @inheritdoc
+         * Gets whether this xline is closed.
+         *
+         * Xlines are always open entities, so this always returns false.
+         *
+         * @returns Always false for xlines
          */
         get: function () {
             return false;
@@ -68,7 +139,18 @@ var AcDbXline = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbXline.prototype, "geometricExtents", {
         /**
-         * @inheritdoc
+         * Gets the geometric extents (bounding box) of this xline.
+         *
+         * Since xlines extend infinitely in both directions, this method returns a
+         * bounding box that encompasses a finite portion of the xline for practical purposes.
+         *
+         * @returns The bounding box that encompasses a portion of the xline
+         *
+         * @example
+         * ```typescript
+         * const extents = xline.geometricExtents;
+         * console.log(`Xline bounds: ${extents.minPoint} to ${extents.maxPoint}`);
+         * ```
          */
         get: function () {
             var extents = new AcGeBox3d();
@@ -80,7 +162,18 @@ var AcDbXline = /** @class */ (function (_super) {
         configurable: true
     });
     /**
-     * @inheritdoc
+     * Gets the grip points for this xline.
+     *
+     * Grip points are control points that can be used to modify the xline.
+     * For an xline, the grip point is the base point.
+     *
+     * @returns Array of grip points (base point)
+     *
+     * @example
+     * ```typescript
+     * const gripPoints = xline.subGetGripPoints();
+     * // gripPoints contains: [basePoint]
+     * ```
      */
     AcDbXline.prototype.subGetGripPoints = function () {
         var gripPoints = new Array();
@@ -88,7 +181,19 @@ var AcDbXline = /** @class */ (function (_super) {
         return gripPoints;
     };
     /**
-     * @inheritdoc
+     * Draws this xline using the specified renderer.
+     *
+     * This method renders the xline as a line segment extending from the base point
+     * in both directions along the unit vector. For practical purposes, the xline is
+     * drawn with a finite length.
+     *
+     * @param renderer - The renderer to use for drawing
+     * @returns The rendered xline entity, or undefined if drawing failed
+     *
+     * @example
+     * ```typescript
+     * const renderedXline = xline.draw(renderer);
+     * ```
      */
     AcDbXline.prototype.draw = function (renderer) {
         var points = [];