@mlightcad/data-model 1.1.1 → 1.1.3

package/lib/entity/dimension/AcDbAlignedDimension.js

@@ -27,21 +27,65 @@ var __assign = (this && this.__assign) || function () {
 import { AcGeBox3d, AcGeLine3d, AcGePoint3d, AcGeVector3d } from '@mlightcad/geometry-engine';
 import { AcDbDimension } from './AcDbDimension';
 /**
- * This class represents the dimension type that dimensions the distance between two points located anywhere
- * in space. The dimension's normal vector must be perpendicular to the line between the two points. The two
- * selected points are also used as the definition points for the start of the two dimension extension lines.
+ * Represents an aligned dimension entity in AutoCAD.
+ *
+ * An aligned dimension measures the distance between two points located anywhere in space.
+ * The dimension's normal vector must be perpendicular to the line between the two points.
+ * The two selected points are also used as the definition points for the start of the
+ * two dimension extension lines.
+ *
+ * Aligned dimensions are commonly used to measure distances that are not parallel to
+ * the X or Y axes, providing accurate measurements regardless of the orientation.
+ *
+ * @example
+ * ```typescript
+ * // Create an aligned dimension
+ * const alignedDim = new AcDbAlignedDimension(
+ *   new AcGePoint3d(0, 0, 0),    // First extension line point
+ *   new AcGePoint3d(10, 5, 0),   // Second extension line point
+ *   new AcGePoint3d(5, 2.5, 0),  // Dimension line point
+ *   "10.0",                      // Dimension text
+ *   "Standard"                   // Dimension style
+ * );
+ *
+ * // Access dimension properties
+ * console.log(`Dimension line point: ${alignedDim.dimLinePoint}`);
+ * console.log(`Extension line 1 point: ${alignedDim.xLine1Point}`);
+ * console.log(`Extension line 2 point: ${alignedDim.xLine2Point}`);
+ * ```
  */
 var AcDbAlignedDimension = /** @class */ (function (_super) {
     __extends(AcDbAlignedDimension, _super);
     /**
-     * This constructor uses the parameters passed in to initialize the dimension. In addition, the extension
-     * line obliquing angle is set to 0.0.
-     * - If dimStyle is left as null, then the current default dimStyle within the AutoCAD editor is used.
-     * @param xLine1Point Input start point (in WCS coordinates) of first extension line
-     * @param xLine2Point Input start point (in WCS coordinates) of second extension line
-     * @param dimLinePoint Input point (in WCS coordinates) on dimension line itself
-     * @param dimText Input text string to use as the dimension annotation
-     * @param dimStyle Input string name of dimension style table record to use
+     * Creates a new aligned dimension entity.
+     *
+     * This constructor initializes an aligned dimension using the specified points.
+     * The extension line obliquing angle is set to 0.0 by default.
+     *
+     * @param xLine1Point - Start point (in WCS coordinates) of first extension line
+     * @param xLine2Point - Start point (in WCS coordinates) of second extension line
+     * @param dimLinePoint - Point (in WCS coordinates) on dimension line itself
+     * @param dimText - Text string to use as the dimension annotation (optional)
+     * @param dimStyle - String name of dimension style table record to use (optional)
+     *
+     * @example
+     * ```typescript
+     * // Create an aligned dimension with default text and style
+     * const alignedDim = new AcDbAlignedDimension(
+     *   new AcGePoint3d(0, 0, 0),
+     *   new AcGePoint3d(10, 5, 0),
+     *   new AcGePoint3d(5, 2.5, 0)
+     * );
+     *
+     * // Create an aligned dimension with custom text and style
+     * const alignedDim2 = new AcDbAlignedDimension(
+     *   new AcGePoint3d(0, 0, 0),
+     *   new AcGePoint3d(15, 10, 0),
+     *   new AcGePoint3d(7.5, 5, 0),
+     *   "15.0",
+     *   "Architectural"
+     * );
+     * ```
      */
     function AcDbAlignedDimension(xLine1Point, xLine2Point, dimLinePoint, dimText, dimStyle) {
         if (dimText === void 0) { dimText = null; }
@@ -59,12 +103,32 @@ var AcDbAlignedDimension = /** @class */ (function (_super) {
     }
     Object.defineProperty(AcDbAlignedDimension.prototype, "dimLinePoint", {
         /**
-         * The definition point (in WCS coordinates) that specifies where the dimension line will be. This point
-         * will be somewhere on the dimension line.
+         * Gets the definition point that specifies where the dimension line will be.
+         *
+         * This point will be somewhere on the dimension line and determines the position
+         * of the dimension text and arrows.
+         *
+         * @returns The dimension line point in WCS coordinates
+         *
+         * @example
+         * ```typescript
+         * const dimLinePoint = alignedDim.dimLinePoint;
+         * console.log(`Dimension line point: ${dimLinePoint.x}, ${dimLinePoint.y}, ${dimLinePoint.z}`);
+         * ```
          */
         get: function () {
             return this._dimLinePoint;
         },
+        /**
+         * Sets the definition point that specifies where the dimension line will be.
+         *
+         * @param value - The new dimension line point
+         *
+         * @example
+         * ```typescript
+         * alignedDim.dimLinePoint = new AcGePoint3d(5, 2.5, 0);
+         * ```
+         */
         set: function (value) {
             this._dimLinePoint.copy(value);
         },
@@ -73,11 +137,29 @@ var AcDbAlignedDimension = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbAlignedDimension.prototype, "xLine1Point", {
         /**
-         * The start point for the first extension line of the dimension.
+         * Gets the start point for the first extension line of the dimension.
+         *
+         * @returns The first extension line point in WCS coordinates
+         *
+         * @example
+         * ```typescript
+         * const xLine1Point = alignedDim.xLine1Point;
+         * console.log(`Extension line 1 point: ${xLine1Point.x}, ${xLine1Point.y}, ${xLine1Point.z}`);
+         * ```
          */
         get: function () {
             return this._xLine1Point;
         },
+        /**
+         * Sets the start point for the first extension line of the dimension.
+         *
+         * @param value - The new first extension line point
+         *
+         * @example
+         * ```typescript
+         * alignedDim.xLine1Point = new AcGePoint3d(0, 0, 0);
+         * ```
+         */
         set: function (value) {
             this._xLine1Point.copy(value);
         },
@@ -86,11 +168,29 @@ var AcDbAlignedDimension = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbAlignedDimension.prototype, "xLine2Point", {
         /**
-         * The start point for the second extension line of the dimension.
+         * Gets the start point for the second extension line of the dimension.
+         *
+         * @returns The second extension line point in WCS coordinates
+         *
+         * @example
+         * ```typescript
+         * const xLine2Point = alignedDim.xLine2Point;
+         * console.log(`Extension line 2 point: ${xLine2Point.x}, ${xLine2Point.y}, ${xLine2Point.z}`);
+         * ```
          */
         get: function () {
             return this._xLine2Point;
         },
+        /**
+         * Sets the start point for the second extension line of the dimension.
+         *
+         * @param value - The new second extension line point
+         *
+         * @example
+         * ```typescript
+         * alignedDim.xLine2Point = new AcGePoint3d(10, 5, 0);
+         * ```
+         */
         set: function (value) {
             this._xLine2Point.copy(value);
         },
@@ -99,11 +199,29 @@ var AcDbAlignedDimension = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbAlignedDimension.prototype, "rotation", {
         /**
-         * The dimension's rotation angle in radians.
+         * Gets the dimension's rotation angle.
+         *
+         * @returns The rotation angle in radians
+         *
+         * @example
+         * ```typescript
+         * const rotation = alignedDim.rotation;
+         * console.log(`Rotation: ${rotation} radians (${rotation * 180 / Math.PI} degrees)`);
+         * ```
          */
         get: function () {
             return this._rotation;
         },
+        /**
+         * Sets the dimension's rotation angle.
+         *
+         * @param value - The new rotation angle in radians
+         *
+         * @example
+         * ```typescript
+         * alignedDim.rotation = Math.PI / 4; // 45 degrees
+         * ```
+         */
         set: function (value) {
             this._rotation = value;
         },
@@ -112,11 +230,29 @@ var AcDbAlignedDimension = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbAlignedDimension.prototype, "oblique", {
         /**
-         * The extension line obliquing angle (in radians) for the dimension.
+         * Gets the extension line obliquing angle.
+         *
+         * @returns The obliquing angle in radians
+         *
+         * @example
+         * ```typescript
+         * const oblique = alignedDim.oblique;
+         * console.log(`Oblique angle: ${oblique} radians`);
+         * ```
          */
         get: function () {
             return this._oblique;
         },
+        /**
+         * Sets the extension line obliquing angle.
+         *
+         * @param value - The new obliquing angle in radians
+         *
+         * @example
+         * ```typescript
+         * alignedDim.oblique = Math.PI / 6; // 30 degrees
+         * ```
+         */
         set: function (value) {
             this._oblique = value;
         },

package/lib/entity/dimension/AcDbAlignedDimension.js.map

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

package/lib/entity/dimension/AcDbArcDimension.d.ts

@@ -1,7 +1,15 @@
 import { AcGeBox3d, AcGePoint3d, AcGePoint3dLike } from '@mlightcad/geometry-engine';
 import { AcDbDimension } from './AcDbDimension';
 /**
- * This class represents an arc length dimension.
+ * Represents an arc length dimension entity in AutoCAD.
+ *
+ * This dimension type measures the length of an arc by defining the arc's center point,
+ * two points that define the arc's extent, and a point on the arc itself. Arc length
+ * dimensions are commonly used in mechanical drawings, architectural plans, and other
+ * technical documentation where precise arc measurements are required.
+ *
+ * The dimension displays the actual arc length value and typically includes extension
+ * lines, dimension lines, and arrows positioned to clearly indicate the arc being measured.
  */
 export declare class AcDbArcDimension extends AcDbDimension {
     private _arcPoint;
@@ -9,36 +17,74 @@ export declare class AcDbArcDimension extends AcDbDimension {
     private _xLine1Point;
     private _xLine2Point;
     /**
-     * Create one instance of this class.
-     * @param centerPoint Input the center of the arc being dimensioned
-     * @param xLine1Point Input the first extension line end point
-     * @param xLine2Point Input the second extension line end point
-     * @param arcPoint Input point on arc being dimensioned
-     * @param dimText Input dimension text to use instead of calculated value
-     * @param dimStyle Input string name of dimension style table record to use
+     * Creates a new arc length dimension.
+     *
+     * @param centerPoint - The center point of the arc being measured. This defines
+     *                      the center of the circle that contains the arc
+     * @param xLine1Point - The first extension line end point. This defines one end
+     *                      of the arc being measured
+     * @param xLine2Point - The second extension line end point. This defines the other
+     *                      end of the arc being measured
+     * @param arcPoint - A point on the arc that helps define the specific arc segment
+     *                   being measured. This point is typically between the two extension
+     *                   line points
+     * @param dimText - Optional custom dimension text to display instead of the calculated
+     *                  arc length value. If null, the calculated length will be displayed
+     * @param dimStyle - Optional name of the dimension style table record to use for
+     *                   formatting. If null, the current default style will be used
      */
     constructor(centerPoint: AcGePoint3dLike, xLine1Point: AcGePoint3dLike, xLine2Point: AcGePoint3dLike, arcPoint: AcGePoint3dLike, dimText?: string | null, dimStyle?: string | null);
     /**
-     * A point on the arc length dimension's dimension arc.
+     * Gets or sets a point on the arc that helps define the arc segment being measured.
+     *
+     * This point is typically positioned between the two extension line points and helps
+     * determine which arc segment should be measured when multiple arcs could be defined
+     * by the same center and end points.
+     *
+     * @returns The arc point that defines the arc segment
      */
     get arcPoint(): AcGePoint3d;
     set arcPoint(value: AcGePoint3d);
     /**
-     * The center point of the arc dimensioned by the arc length dimension.
+     * Gets or sets the center point of the arc being measured.
+     *
+     * The center point defines the center of the circle that contains the arc. This point
+     * is used to calculate the arc length and position the dimension elements correctly.
+     *
+     * @returns The center point of the arc
      */
     get centerPoint(): AcGePoint3d;
     set centerPoint(value: AcGePoint3d);
     /**
-     * The start point for the first extension line of the dimension.
+     * Gets or sets the first extension line end point.
+     *
+     * This point defines one end of the arc being measured. The extension line extends
+     * from this point to the arc, helping to clearly identify the starting point of
+     * the arc length measurement.
+     *
+     * @returns The first extension line end point
      */
     get xLine1Point(): AcGePoint3d;
     set xLine1Point(value: AcGePoint3d);
     /**
-     * The start point for the second extension line of the dimension.
+     * Gets or sets the second extension line end point.
+     *
+     * This point defines the other end of the arc being measured. The extension line
+     * extends from this point to the arc, helping to clearly identify the ending point
+     * of the arc length measurement.
+     *
+     * @returns The second extension line end point
      */
     get xLine2Point(): AcGePoint3d;
     set xLine2Point(value: AcGePoint3d);
     /**
+     * Gets the geometric extents (bounding box) of this dimension entity.
+     *
+     * The geometric extents define the minimum bounding box that completely contains
+     * the dimension entity, including all its components like extension lines,
+     * dimension lines, arrows, and text.
+     *
+     * @returns A 3D bounding box containing the dimension entity
      * @inheritdoc
      */
     get geometricExtents(): AcGeBox3d;

package/lib/entity/dimension/AcDbArcDimension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcDbArcDimension.d.ts","sourceRoot":"","sources":["../../../src/entity/dimension/AcDbArcDimension.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,eAAe,EAChB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,YAAY,CAAa;IAEjC;;;;;;;;OAQG;gBAED,WAAW,EAAE,eAAe,EAC5B,WAAW,EAAE,eAAe,EAC5B,WAAW,EAAE,eAAe,EAC5B,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,MAAM,GAAG,IAAW,EAC7B,QAAQ,GAAE,MAAM,GAAG,IAAW;IAahC;;OAEG;IACH,IAAI,QAAQ,IAGQ,WAAW,CAD9B;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,WAAW,EAE9B;IAED;;OAEG;IACH,IAAI,WAAW,IAGQ,WAAW,CADjC;IACD,IAAI,WAAW,CAAC,KAAK,EAAE,WAAW,EAEjC;IAED;;OAEG;IACH,IAAI,WAAW,IAGQ,WAAW,CADjC;IACD,IAAI,WAAW,CAAC,KAAK,EAAE,WAAW,EAEjC;IAED;;OAEG;IACH,IAAI,WAAW,IAGQ,WAAW,CADjC;IACD,IAAI,WAAW,CAAC,KAAK,EAAE,WAAW,EAEjC;IAED;;OAEG;IACH,IAAI,gBAAgB,cAGnB;CACF"}
+{"version":3,"file":"AcDbArcDimension.d.ts","sourceRoot":"","sources":["../../../src/entity/dimension/AcDbArcDimension.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,eAAe,EAChB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;;;;;;;;;GAUG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,YAAY,CAAa;IAEjC;;;;;;;;;;;;;;;;OAgBG;gBAED,WAAW,EAAE,eAAe,EAC5B,WAAW,EAAE,eAAe,EAC5B,WAAW,EAAE,eAAe,EAC5B,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,MAAM,GAAG,IAAW,EAC7B,QAAQ,GAAE,MAAM,GAAG,IAAW;IAahC;;;;;;;;OAQG;IACH,IAAI,QAAQ,IAGQ,WAAW,CAD9B;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,WAAW,EAE9B;IAED;;;;;;;OAOG;IACH,IAAI,WAAW,IAGQ,WAAW,CADjC;IACD,IAAI,WAAW,CAAC,KAAK,EAAE,WAAW,EAEjC;IAED;;;;;;;;OAQG;IACH,IAAI,WAAW,IAGQ,WAAW,CADjC;IACD,IAAI,WAAW,CAAC,KAAK,EAAE,WAAW,EAEjC;IAED;;;;;;;;OAQG;IACH,IAAI,WAAW,IAGQ,WAAW,CADjC;IACD,IAAI,WAAW,CAAC,KAAK,EAAE,WAAW,EAEjC;IAED;;;;;;;;;OASG;IACH,IAAI,gBAAgB,cAGnB;CACF"}

package/lib/entity/dimension/AcDbArcDimension.js

@@ -16,18 +16,34 @@ var __extends = (this && this.__extends) || (function () {
 import { AcGeBox3d, AcGePoint3d } from '@mlightcad/geometry-engine';
 import { AcDbDimension } from './AcDbDimension';
 /**
- * This class represents an arc length dimension.
+ * Represents an arc length dimension entity in AutoCAD.
+ *
+ * This dimension type measures the length of an arc by defining the arc's center point,
+ * two points that define the arc's extent, and a point on the arc itself. Arc length
+ * dimensions are commonly used in mechanical drawings, architectural plans, and other
+ * technical documentation where precise arc measurements are required.
+ *
+ * The dimension displays the actual arc length value and typically includes extension
+ * lines, dimension lines, and arrows positioned to clearly indicate the arc being measured.
  */
 var AcDbArcDimension = /** @class */ (function (_super) {
     __extends(AcDbArcDimension, _super);
     /**
-     * Create one instance of this class.
-     * @param centerPoint Input the center of the arc being dimensioned
-     * @param xLine1Point Input the first extension line end point
-     * @param xLine2Point Input the second extension line end point
-     * @param arcPoint Input point on arc being dimensioned
-     * @param dimText Input dimension text to use instead of calculated value
-     * @param dimStyle Input string name of dimension style table record to use
+     * Creates a new arc length dimension.
+     *
+     * @param centerPoint - The center point of the arc being measured. This defines
+     *                      the center of the circle that contains the arc
+     * @param xLine1Point - The first extension line end point. This defines one end
+     *                      of the arc being measured
+     * @param xLine2Point - The second extension line end point. This defines the other
+     *                      end of the arc being measured
+     * @param arcPoint - A point on the arc that helps define the specific arc segment
+     *                   being measured. This point is typically between the two extension
+     *                   line points
+     * @param dimText - Optional custom dimension text to display instead of the calculated
+     *                  arc length value. If null, the calculated length will be displayed
+     * @param dimStyle - Optional name of the dimension style table record to use for
+     *                   formatting. If null, the current default style will be used
      */
     function AcDbArcDimension(centerPoint, xLine1Point, xLine2Point, arcPoint, dimText, dimStyle) {
         if (dimText === void 0) { dimText = null; }
@@ -44,7 +60,13 @@ var AcDbArcDimension = /** @class */ (function (_super) {
     }
     Object.defineProperty(AcDbArcDimension.prototype, "arcPoint", {
         /**
-         * A point on the arc length dimension's dimension arc.
+         * Gets or sets a point on the arc that helps define the arc segment being measured.
+         *
+         * This point is typically positioned between the two extension line points and helps
+         * determine which arc segment should be measured when multiple arcs could be defined
+         * by the same center and end points.
+         *
+         * @returns The arc point that defines the arc segment
          */
         get: function () {
             return this._arcPoint;
@@ -57,7 +79,12 @@ var AcDbArcDimension = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbArcDimension.prototype, "centerPoint", {
         /**
-         * The center point of the arc dimensioned by the arc length dimension.
+         * Gets or sets the center point of the arc being measured.
+         *
+         * The center point defines the center of the circle that contains the arc. This point
+         * is used to calculate the arc length and position the dimension elements correctly.
+         *
+         * @returns The center point of the arc
          */
         get: function () {
             return this._centerPoint;
@@ -70,7 +97,13 @@ var AcDbArcDimension = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbArcDimension.prototype, "xLine1Point", {
         /**
-         * The start point for the first extension line of the dimension.
+         * Gets or sets the first extension line end point.
+         *
+         * This point defines one end of the arc being measured. The extension line extends
+         * from this point to the arc, helping to clearly identify the starting point of
+         * the arc length measurement.
+         *
+         * @returns The first extension line end point
          */
         get: function () {
             return this._xLine1Point;
@@ -83,7 +116,13 @@ var AcDbArcDimension = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbArcDimension.prototype, "xLine2Point", {
         /**
-         * The start point for the second extension line of the dimension.
+         * Gets or sets the second extension line end point.
+         *
+         * This point defines the other end of the arc being measured. The extension line
+         * extends from this point to the arc, helping to clearly identify the ending point
+         * of the arc length measurement.
+         *
+         * @returns The second extension line end point
          */
         get: function () {
             return this._xLine2Point;
@@ -96,6 +135,13 @@ var AcDbArcDimension = /** @class */ (function (_super) {
     });
     Object.defineProperty(AcDbArcDimension.prototype, "geometricExtents", {
         /**
+         * Gets the geometric extents (bounding box) of this dimension entity.
+         *
+         * The geometric extents define the minimum bounding box that completely contains
+         * the dimension entity, including all its components like extension lines,
+         * dimension lines, arrows, and text.
+         *
+         * @returns A 3D bounding box containing the dimension entity
          * @inheritdoc
          */
         get: function () {

package/lib/entity/dimension/AcDbArcDimension.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcDbArcDimension.js","sourceRoot":"","sources":["../../../src/entity/dimension/AcDbArcDimension.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,OAAO,EACL,SAAS,EACT,WAAW,EAEZ,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;GAEG;AACH;IAAsC,oCAAa;IAMjD;;;;;;;;OAQG;IACH,0BACE,WAA4B,EAC5B,WAA4B,EAC5B,WAA4B,EAC5B,QAAyB,EACzB,OAA6B,EAC7B,QAA8B;QAD9B,wBAAA,EAAA,cAA6B;QAC7B,yBAAA,EAAA,eAA8B;QAE9B,YAAA,MAAK,WAAE,SAAA;QACP,KAAI,CAAC,SAAS,GAAG,IAAI,WAAW,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACjD,KAAI,CAAC,YAAY,GAAG,IAAI,WAAW,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACvD,KAAI,CAAC,YAAY,GAAG,IAAI,WAAW,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACvD,KAAI,CAAC,YAAY,GAAG,IAAI,WAAW,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAEvD,KAAI,CAAC,aAAa,GAAG,OAAO,CAAA;QAC5B,6FAA6F;QAC7F,KAAI,CAAC,kBAAkB,GAAG,QAAQ,CAAA;;IACpC,CAAC;IAKD,sBAAI,sCAAQ;QAHZ;;WAEG;aACH;YACE,OAAO,IAAI,CAAC,SAAS,CAAA;QACvB,CAAC;aACD,UAAa,KAAkB;YAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC5B,CAAC;;;OAHA;IAQD,sBAAI,yCAAW;QAHf;;WAEG;aACH;YACE,OAAO,IAAI,CAAC,YAAY,CAAA;QAC1B,CAAC;aACD,UAAgB,KAAkB;YAChC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/B,CAAC;;;OAHA;IAQD,sBAAI,yCAAW;QAHf;;WAEG;aACH;YACE,OAAO,IAAI,CAAC,YAAY,CAAA;QAC1B,CAAC;aACD,UAAgB,KAAkB;YAChC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/B,CAAC;;;OAHA;IAQD,sBAAI,yCAAW;QAHf;;WAEG;aACH;YACE,OAAO,IAAI,CAAC,YAAY,CAAA;QAC1B,CAAC;aACD,UAAgB,KAAkB;YAChC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/B,CAAC;;;OAHA;IAQD,sBAAI,8CAAgB;QAHpB;;WAEG;aACH;YACE,kBAAkB;YAClB,OAAO,IAAI,SAAS,EAAE,CAAA;QACxB,CAAC;;;OAAA;IACH,uBAAC;AAAD,CAAC,AAjFD,CAAsC,aAAa,GAiFlD"}
+{"version":3,"file":"AcDbArcDimension.js","sourceRoot":"","sources":["../../../src/entity/dimension/AcDbArcDimension.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,OAAO,EACL,SAAS,EACT,WAAW,EAEZ,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;;;;;;;;;GAUG;AACH;IAAsC,oCAAa;IAMjD;;;;;;;;;;;;;;;;OAgBG;IACH,0BACE,WAA4B,EAC5B,WAA4B,EAC5B,WAA4B,EAC5B,QAAyB,EACzB,OAA6B,EAC7B,QAA8B;QAD9B,wBAAA,EAAA,cAA6B;QAC7B,yBAAA,EAAA,eAA8B;QAE9B,YAAA,MAAK,WAAE,SAAA;QACP,KAAI,CAAC,SAAS,GAAG,IAAI,WAAW,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACjD,KAAI,CAAC,YAAY,GAAG,IAAI,WAAW,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACvD,KAAI,CAAC,YAAY,GAAG,IAAI,WAAW,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACvD,KAAI,CAAC,YAAY,GAAG,IAAI,WAAW,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAEvD,KAAI,CAAC,aAAa,GAAG,OAAO,CAAA;QAC5B,6FAA6F;QAC7F,KAAI,CAAC,kBAAkB,GAAG,QAAQ,CAAA;;IACpC,CAAC;IAWD,sBAAI,sCAAQ;QATZ;;;;;;;;WAQG;aACH;YACE,OAAO,IAAI,CAAC,SAAS,CAAA;QACvB,CAAC;aACD,UAAa,KAAkB;YAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC5B,CAAC;;;OAHA;IAaD,sBAAI,yCAAW;QARf;;;;;;;WAOG;aACH;YACE,OAAO,IAAI,CAAC,YAAY,CAAA;QAC1B,CAAC;aACD,UAAgB,KAAkB;YAChC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/B,CAAC;;;OAHA;IAcD,sBAAI,yCAAW;QATf;;;;;;;;WAQG;aACH;YACE,OAAO,IAAI,CAAC,YAAY,CAAA;QAC1B,CAAC;aACD,UAAgB,KAAkB;YAChC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/B,CAAC;;;OAHA;IAcD,sBAAI,yCAAW;QATf;;;;;;;;WAQG;aACH;YACE,OAAO,IAAI,CAAC,YAAY,CAAA;QAC1B,CAAC;aACD,UAAgB,KAAkB;YAChC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/B,CAAC;;;OAHA;IAeD,sBAAI,8CAAgB;QAVpB;;;;;;;;;WASG;aACH;YACE,kBAAkB;YAClB,OAAO,IAAI,SAAS,EAAE,CAAA;QACxB,CAAC;;;OAAA;IACH,uBAAC;AAAD,CAAC,AAvHD,CAAsC,aAAa,GAuHlD"}