import { AcGeBox3d, AcGeLine3d, AcGeMatrix3d, AcGePoint2dLike, AcGePoint3d, AcGePoint3dLike, AcGeVector3d, AcGeVector3dLike } from '@mlightcad/geometry-engine';
import { AcGiArrowStyle, AcGiArrowType, AcGiRenderer } from '@mlightcad/graphic-interface';
import { AcDbObjectId } from '../../base';
import { AcDbDxfFiler } from '../../base';
import { AcDbDimStyleTableRecord } from '../../database';
import { AcDbOsnapMode } from '../../misc';
import { AcDbEntity } from '../AcDbEntity';
import { AcDbEntityProperties, AcDbEntityPropertyGroup, AcDbEntityPropertyType, AcDbEntityRuntimeProperty } from '../AcDbEntityProperties';
/**
 * Defines the line spacing style for dimension text.
 */
export declare enum AcDbLineSpacingStyle {
    /** At least the specified spacing */
    AtLeast = 1,
    /** Exactly the specified spacing */
    Exactly = 2
}
/**
 * Abstract base class for all dimension entity types in AutoCAD.
 *
 * This class provides the fundamental functionality for all dimension entities,
 * including dimension text, style management, arrow handling, and measurement
 * calculations. The appearance of dimensions is controlled by dimension variable
 * settings and dimension styles.
 *
 * @example
 * ```typescript
 * class MyDimension extends AcDbDimension {
 *   // Implementation for specific dimension type
 *   draw(renderer: AcGiRenderer) {
 *     // Custom drawing logic
 *   }
 * }
 * ```
 */
export declare abstract class AcDbDimension extends AcDbEntity {
    /** The entity type name */
    static typeName: string;
    get dxfTypeName(): string;
    /** The block table record ID containing the dimension entities */
    private _dimBlockId;
    /** The relative position point of the block referenced by the dimension (in WCS coordinates). */
    private _dimBlockPosition;
    /** The dimension style name used by this dimension */
    private _dimensionStyleName;
    /** The user-supplied dimension annotation text */
    private _dimensionText;
    /** The measured value of the dimension */
    private _measurement?;
    /** The line spacing factor for dimension text */
    private _textLineSpacingFactor;
    /** The line spacing style for dimension text */
    private _textLineSpacingStyle;
    /** The position of the dimension text */
    private _textPosition;
    /** The rotation angle of the dimension text */
    private _textRotation;
    /** The cached dimension style record */
    private _dimStyle?;
    /** The normal vector of the plane containing the block reference */
    private _normal;
    /**
     * Creates a new dimension entity.
     *
     * This constructor initializes a dimension with default values.
     * Subclasses should override this constructor to set up dimension-specific properties.
     *
     * @example
     * ```typescript
     * const dimension = new MyDimension();
     * dimension.dimensionText = "10.0";
     * dimension.textPosition = new AcGePoint3d(5, 5, 0);
     * ```
     */
    constructor();
    /**
     * Gets the block table record ID containing the entities that this dimension displays.
     *
     * @returns The block table record ID, or null if not set
     *
     * @example
     * ```typescript
     * const blockId = dimension.dimBlockId;
     * console.log(`Dimension block ID: ${blockId}`);
     * ```
     */
    get dimBlockId(): string | null;
    /**
     * Sets the block table record ID for this dimension.
     *
     * @param value - The block table record ID, or null to clear
     *
     * @example
     * ```typescript
     * dimension.dimBlockId = "MyDimensionBlock";
     * ```
     */
    set dimBlockId(value: string | null);
    /**
     * Gets the relative position point of the block referenced by the dimension (in WCS coordinates).
     * The block position is the insertion point of the block referenced by the dimension, relative to
     * the primary definition point (DXF group code 10) of the dimension itself.
     *
     * The block position (in WCS) is added to the dimension primary definition point (also in WCS) to
     * get the actual insertion point for the anonymous block that is referenced by the dimension. So,
     * for example, changing a dimension's block position from (0,0,0) to (0,0,1) (in WCS) will cause
     * the dimension to display as though it has been moved 1 unit along the WCS Z axis.
     *
     * For a dimension newly created via any dimension command, the block position will be (0,0,0).
     * For copies of existing dimensions, or if a dimension is moved, the block position will be the
     * offset vector (in WCS) from where the original dimension was located. For example, moving a
     * dimension 1 unit down the WCS Y axis will cause AutoCAD to update the block position value from
     * (0,0,0) to (0,-1,0) (in WCS coordinates).
     *
     * The position point is used for DXF group code 12.
     *
     * @returns The relative position point of the block referenced by the dimension.
     *
     */
    get dimBlockPosition(): AcGePoint3d;
    /**
     * Sets the relative position point of the block referenced by the dimension (in WCS coordinates).
     * The block position is the insertion point of the block referenced by the dimension, relative to
     * the primary definition point (DXF group code 10) of the dimension itself.
     *
     * The block position (in WCS) is added to the dimension primary definition point (also in WCS) to
     * get the actual insertion point for the anonymous block that is referenced by the dimension. So,
     * for example, changing a dimension's block position from (0,0,0) to (0,0,1) (in WCS) will cause
     * the dimension to display as though it has been moved 1 unit along the WCS Z axis.
     *
     * For a dimension newly created via any dimension command, the block position will be (0,0,0).
     * For copies of existing dimensions, or if a dimension is moved, the block position will be the
     * offset vector (in WCS) from where the original dimension was located. For example, moving a
     * dimension 1 unit down the WCS Y axis will cause AutoCAD to update the block position value from
     * (0,0,0) to (0,-1,0) (in WCS coordinates).
     *
     * The position point is used for DXF group code 12.
     *
     * @param value - The relative position point of the block referenced by the dimension.
  
     */
    set dimBlockPosition(value: AcGePoint3dLike);
    /**
     * Gets the dimension style name used by this dimension.
     *
     * @returns The dimension style name, or null if not set
     *
     * @example
     * ```typescript
     * const styleName = dimension.dimensionStyleName;
     * console.log(`Dimension style: ${styleName}`);
     * ```
     */
    get dimensionStyleName(): string | null;
    /**
     * Sets the dimension style name for this dimension.
     *
     * @param value - The dimension style name, or null to use default
     *
     * @example
     * ```typescript
     * dimension.dimensionStyleName = "Standard";
     * ```
     */
    set dimensionStyleName(value: string | null);
    /**
     * Gets the dimension style used by this dimension.
     *
     * This method returns the dimension style record associated with this dimension.
     * If no style is specified, it returns the default dimension style.
     *
     * @returns The dimension style record
     *
     * @example
     * ```typescript
     * const style = dimension.dimensionStyle;
     * console.log(`Style name: ${style.name}`);
     * ```
     */
    get dimensionStyle(): AcDbDimStyleTableRecord;
    /**
     * Gets the user-supplied dimension annotation text string.
     *
     * This string can contain multiline text formatting characters. The text can be:
     * - Empty string ('') for default text only
     * - Text with angle brackets for mixed default and user text (e.g., 'This is the default text <>')
     * - Period ('.') for no text
     * - User-defined text only
     *
     * @returns The dimension text string
     *
     * @example
     * ```typescript
     * const text = dimension.dimensionText;
     * console.log(`Dimension text: ${text}`);
     * ```
     */
    get dimensionText(): string | null;
    set dimensionText(value: string | null);
    /**
     * The current measurement value for this dimension
     */
    get measurement(): number | undefined;
    set measurement(value: number | undefined);
    /**
     * The line spacing factor (a value between 0.25 and 4.00).
     */
    get textLineSpacingFactor(): number;
    set textLineSpacingFactor(value: number);
    /**
     * The line spacing style for the dimension.
     */
    get textLineSpacingStyle(): AcDbLineSpacingStyle;
    set textLineSpacingStyle(value: AcDbLineSpacingStyle);
    /**
     * The dimension's text position point. This is the middle center point of the text (which is itself an
     * MText object with middle-center justification).
     */
    get textPosition(): AcGePoint3d;
    set textPosition(value: AcGePoint3d);
    /**
     * The rotation angle (in radians) of the dimension's annotation text. This is the angle from the
     * dimension's horizontal axis to the horizontal axis used by the text. The angle is in the dimension's
     * OCS X-Y plane with positive angles going counterclockwise when looking down the OCS Z axis towards
     * the OCS origin. The value obtained from: (2 * pi) + the dimension's text rotation angle--the
     * dimension's horizontal rotation angle
     */
    get textRotation(): number;
    set textRotation(value: number);
    /**
     * Gets the normal vector of the plane containing the dimension.
     *
     * @returns The normal vector
     */
    get normal(): AcGeVector3d;
    /**
     * Sets the normal vector of the plane containing the dimension.
     *
     * @param value - The new normal vector
     */
    set normal(value: AcGeVector3dLike);
    get properties(): AcDbEntityProperties;
    protected getBaseProperties(): AcDbEntityProperties;
    /**
     * Transforms this dimension by the specified matrix.
     */
    transformBy(matrix: AcGeMatrix3d): this;
    /**
     * Resolves osnap points through the anonymous dimension block.
     *
     * Dimensions are rendered from `dimBlockId` contents, so osnap queries need
     * to delegate to the block entities and map points between block-local space
     * and WCS.
     */
    subGetOsnapPoints(osnapMode: AcDbOsnapMode, pickPoint: AcGePoint3dLike, lastPoint: AcGePoint3dLike, snapPoints: AcGePoint3dLike[], gsMark?: AcDbObjectId): void;
    /**
     * @inheritdoc
     */
    subWorldDraw(renderer: AcGiRenderer): import("@mlightcad/graphic-interface").AcGiEntity | undefined;
    /**
     * Computes transformed geometric extents from the anonymous dimension block.
     */
    protected getDimBlockGeometricExtents(): AcGeBox3d;
    /**
     * Looks up the anonymous block referenced by `dimBlockId`.
     */
    protected getDimBlockTableRecord(): import("../../database").AcDbBlockTableRecord | undefined;
    protected getDimensionProperties(): AcDbEntityPropertyGroup;
    protected createProperty<T>(name: string, type: AcDbEntityPropertyType, get: () => T, set?: (value: T) => void, options?: {
        label: string;
        value: unknown;
    }[]): AcDbEntityRuntimeProperty<T>;
    protected createPoint3dProperties(prefix: string, getPoint: () => AcGePoint3d): AcDbEntityRuntimeProperty<number>[];
    protected getMeasurementPropertyValue(): number | undefined;
    /**
     * Builds the complete dimension-block transform (OCS transform + extrusion).
     */
    protected getFullDimBlockTransform(): AcGeMatrix3d;
    protected get arrowScaleFactor(): number;
    /**
     * Arrow style of the first arrow
     */
    protected get firstArrowStyle(): AcGiArrowStyle;
    /**
     * Arrow style of the second arrow
     */
    protected get secondArrowStyle(): AcGiArrowStyle;
    /**
     * The flag to determinate how to attach arrow to endpoint of the line.
     * - true: append arrow to endpoint of the line
     * - false: overlap arrow with endpoint of the line
     */
    protected get isAppendArrow(): boolean;
    /**
     * The BTR id associated with the first arrow type
     */
    protected get firstArrowTypeBtrId(): string;
    /**
     * The first arrow type
     */
    protected get firstArrowType(): AcGiArrowType;
    /**
     * The BTR id associated with the second arrow type
     */
    protected get secondArrowTypeBtrId(): string;
    /**
     * The second arrow type
     */
    protected get secondArrowType(): AcGiArrowType;
    /**
     * The maximum number of arrow lines of this dimension
     */
    protected get arrowLineCount(): number;
    /**
     * Find the point `p3` on a line along the line direction at a distance `length` from `p2`.
     *
     * @param p1 - The start point of the line.
     * @param p2 - The end point of the line.
     * @param length - The distance from `p2` to `p3`.
     * @returns Return the point `p3`.
     */
    protected findPointOnLine1(p1: AcGePoint3d, p2: AcGePoint3d, length: number): AcGePoint3d;
    /**
     * Find the point `p2` on a line starting from `p1` at a specified angle
     * and at a distance `length` from `p1`.
     *
     * @param p1 - The start point of the line.
     * @param angle - The angle of the line in radians relative to the x-axis.
     * @param length - The distance from `p1` to `p2`.
     * @returns Return the point `p2`.
     */
    protected findPointOnLine2(p1: AcGePoint2dLike, angle: number, length: number): AcGePoint2dLike;
    /**
     * Adjust start point and end point of extension line according current dimension style
     * @param extensionLine Input extension line to adjust its start point and end point
     */
    protected adjustExtensionLine(extensionLine: AcGeLine3d): void;
    /**
     * Get dimension style name by dimension block id
     * @param id Input dimension block id
     * @returns Return dimension style name by dimension block id
     */
    private getArrowName;
    /**
     * Computes the block-local transformation matrix for the anonymous block
     * referenced by this dimension entity.
     *
     * In AutoCAD, each dimension references an **anonymous block** that contains
     * the graphical representation of the dimension (dimension line, extension
     * lines, arrows, and text). That block is defined in the **dimension’s Object
     * Coordinate System (OCS)**.
     *
     * This method computes the transformation that positions the anonymous
     * dimension block **within the dimension’s OCS**, excluding any extrusion
     * (normal) transformation.
     *
     * Conceptually, AutoCAD applies the following steps when displaying a
     * dimension block:
     *
     * 1. Translate block geometry by the negative block base point
     * 2. Translate by the dimension block position (DXF group code 12)
     * 3. Finally, transform from OCS to WCS using the dimension normal (DXF 210)
     *
     * This method implements **steps 1 and 2 only**.
     *
     * The OCS → WCS transformation derived from {@link normal} is **intentionally
     * excluded** and must be applied **after rendering** (see
     * {@link AcDbRenderingCache.draw}). This matches AutoCAD / RealDWG behavior and
     * ensures:
     *
     * - Dimension text rotation remains defined in OCS
     * - Arrow orientation and extension line directions remain correct
     * - Anonymous dimension blocks can be safely cached and reused
     *
     * ### Matrix composition (right-multiply convention)
     *
     * ```
     * dimBlockTransform =
     *   T(dimBlockPosition)
     * · T(-blockBasePoint)
     * ```
     *
     * ### Notes
     *
     * - The returned matrix operates entirely in dimension OCS
     * - No scaling or rotation is applied here
     * - {@link normal} is applied later as a final orientation step
     * - This mirrors the internal behavior of `AcDbDimension` in ObjectARX
     *
     * @returns A transformation matrix that positions the anonymous dimension
     *          block in OCS space, excluding extrusion.
     */
    private computeDimBlockTransform;
    /**
     * Subclasses can override this to transform their own definition points.
     */
    protected subTransformBy(_matrix: AcGeMatrix3d): void;
    /**
     * Writes DXF fields for this object.
     *
     * @param filer - DXF output writer.
     * @returns The instance (for chaining).
     */
    dxfOutFields(filer: AcDbDxfFiler): this;
}
//# sourceMappingURL=AcDbDimension.d.ts.map