@mlightcad/cad-simple-viewer 1.5.10 → 1.6.0

package/lib/command/measure/entity/AcApMeasureAreaEntity.js

@@ -0,0 +1,184 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+import { AcTrHtmlBadge, AcTrHtmlCanvasOverlay, AcTrHtmlDot } from '@mlightcad/three-renderer';
+import { acapMeasurementCanvasLineWidth, formatMeasurementLength } from '../../../util';
+import { serializeMeasurementStyle } from '../AcApMeasurementSidecar';
+import { getMeasurementStyle, MEASUREMENT_LAYER } from '../AcApMeasurementStore';
+import { drawMeasureAreaOnCanvas, measureCentroid, measureShoelaceArea } from './AcApMeasureDrawUtil';
+import { AcApMeasureEntity } from './AcApMeasureEntity';
+/**
+ * Area measurement overlay entity.
+ *
+ * Renders a filled canvas polygon, HTML dots at each vertex, and an area
+ * badge at the vertex centroid. Requires at least three points for a full
+ * draw; fewer points yield an empty group with empty extras.
+ */
+var AcApMeasureAreaEntity = /** @class */ (function (_super) {
+    __extends(AcApMeasureAreaEntity, _super);
+    /**
+     * Creates an area measure entity from a polygon vertex list.
+     *
+     * @param points - Polygon vertices in world coordinates
+     * @param options - Shared id, layout, and style options
+     */
+    function AcApMeasureAreaEntity(points, options) {
+        var _a;
+        var _this = _super.call(this, (_a = options.id) !== null && _a !== void 0 ? _a : "area-".concat(Date.now()), options.layoutId, options.style) || this;
+        _this.points = points;
+        return _this;
+    }
+    /**
+     * Factory that builds an area entity from vertices and style.
+     *
+     * @param points - Polygon vertices in world coordinates
+     * @param style - Measurement visual style
+     * @param options - Optional id and layout overrides
+     * @returns New {@link AcApMeasureAreaEntity}
+     */
+    AcApMeasureAreaEntity.create = function (points, style, options) {
+        return new AcApMeasureAreaEntity(points, {
+            style: style,
+            id: options === null || options === void 0 ? void 0 : options.id,
+            layoutId: options === null || options === void 0 ? void 0 : options.layoutId
+        });
+    };
+    /**
+     * Primary anchor for the measurement (vertex centroid).
+     *
+     * @returns Centroid with `z: 0`, or `undefined` when there are no points
+     */
+    AcApMeasureAreaEntity.prototype.primaryPoint = function () {
+        if (this.points.length === 0)
+            return undefined;
+        var c = measureCentroid(this.points);
+        return { x: c.x, y: c.y, z: 0 };
+    };
+    /**
+     * Serializes this area measurement to a store/sidecar record.
+     *
+     * @param layoutId - Optional layout BTR id written onto the record
+     * @returns Record with `type: 'area'` and polygon point geometry
+     */
+    AcApMeasureAreaEntity.prototype.toRecord = function (layoutId) {
+        return {
+            id: this.entityId,
+            type: 'area',
+            layoutId: layoutId,
+            style: serializeMeasurementStyle(this.style),
+            geometry: {
+                type: 'area',
+                points: this.points.map(function (p) { return ({ x: p.x, y: p.y }); })
+            }
+        };
+    };
+    /**
+     * Draws the filled polygon canvas, vertex dots, area badge, and extras.
+     *
+     * When fewer than three points are present, returns an empty group and
+     * empty extras without registering view listeners.
+     *
+     * @param view - Active 2D view for HTML overlays
+     * @param db - Database used to format the area label
+     * @returns World-draw result including redraw/dispose hooks when valid
+     */
+    AcApMeasureAreaEntity.prototype.subWorldDrawWithDb = function (view, db) {
+        var _a;
+        var _this = this;
+        if (this.points.length < 3) {
+            var group_1 = this.createGroup(view);
+            return {
+                group: group_1,
+                entityIds: [],
+                dispose: function () { return undefined; },
+                extras: {}
+            };
+        }
+        var color = this.style.color;
+        var area = measureShoelaceArea(this.points);
+        var layoutId = this.resolveLayoutId(view);
+        var mid = measureCentroid(this.points);
+        var persistOverlay = new AcTrHtmlCanvasOverlay({
+            id: "area-canvas-".concat(this.entityId),
+            container: view.container,
+            layer: MEASUREMENT_LAYER,
+            layoutId: layoutId
+        });
+        var paintArea = function (paintStyle) {
+            if (paintStyle === void 0) { paintStyle = _this.style; }
+            return drawMeasureAreaOnCanvas(persistOverlay.canvas, view, _this.points, paintStyle.color, acapMeasurementCanvasLineWidth(paintStyle.lineWeight));
+        };
+        paintArea();
+        var redrawPersist = function () { var _a; return paintArea((_a = getMeasurementStyle(_this.entityId)) !== null && _a !== void 0 ? _a : _this.style); };
+        view.events.viewChanged.addEventListener(redrawPersist);
+        var group = (_a = this.createGroup(view))
+            .add.apply(_a, __spreadArray([new AcTrHtmlBadge({
+                id: "".concat(this.entityId, "-badge"),
+                color: color,
+                text: "".concat(formatMeasurementLength(db, area), "\u00B2"),
+                worldPosition: mid,
+                layer: MEASUREMENT_LAYER,
+                fontSize: this.style.fontSize
+            })], __read(this.points.map(function (p, i) {
+            return new AcTrHtmlDot({
+                id: "".concat(_this.entityId, "-dot").concat(i),
+                color: color,
+                worldPosition: p,
+                layer: MEASUREMENT_LAYER
+            });
+        })), false)).addCanvas(persistOverlay);
+        return {
+            group: group,
+            entityIds: [],
+            dispose: function () {
+                view.events.viewChanged.removeEventListener(redrawPersist);
+            },
+            extras: {
+                style: this.style,
+                value: { kind: 'area', value: area },
+                snapshot: this.toRecord(layoutId),
+                redraw: paintArea
+            }
+        };
+    };
+    return AcApMeasureAreaEntity;
+}(AcApMeasureEntity));
+export { AcApMeasureAreaEntity };
+//# sourceMappingURL=AcApMeasureAreaEntity.js.map

package/lib/command/measure/entity/AcApMeasureAreaEntity.js.map

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

package/lib/command/measure/entity/AcApMeasureDistanceEntity.d.ts

@@ -0,0 +1,60 @@
+import { type AcDbDatabase, type AcGePoint3dLike } from '@mlightcad/data-model';
+import { type AcApMeasurementStyle } from '../../../util';
+import type { AcTrView2d } from '../../../view';
+import type { AcApMeasurementRecord } from '../AcApMeasurementTypes';
+import { AcApMeasureEntity, type AcApMeasureEntityOptions, type AcApMeasureWorldDrawResult } from './AcApMeasureEntity';
+/**
+ * Distance measurement overlay entity.
+ *
+ * Renders an HTML canvas segment between two endpoints, HTML dots at each end,
+ * and a length badge at the midpoint. No CAD transient entities.
+ */
+export declare class AcApMeasureDistanceEntity extends AcApMeasureEntity {
+    /** First endpoint of the measured segment in world coordinates. */
+    private readonly p1;
+    /** Second endpoint of the measured segment in world coordinates. */
+    private readonly p2;
+    /**
+     * Creates a distance measure entity between two points.
+     *
+     * @param p1 - First endpoint
+     * @param p2 - Second endpoint
+     * @param options - Shared id, layout, and style options
+     */
+    constructor(p1: AcGePoint3dLike, p2: AcGePoint3dLike, options: AcApMeasureEntityOptions);
+    /**
+     * Factory that builds a distance entity from endpoints and style.
+     *
+     * @param p1 - First endpoint
+     * @param p2 - Second endpoint
+     * @param style - Measurement visual style
+     * @param options - Optional id and layout overrides
+     * @returns New {@link AcApMeasureDistanceEntity}
+     */
+    static create(p1: AcGePoint3dLike, p2: AcGePoint3dLike, style: AcApMeasurementStyle, options?: {
+        id?: string;
+        layoutId?: string;
+    }): AcApMeasureDistanceEntity;
+    /**
+     * Midpoint of the measured segment (badge / primary anchor).
+     *
+     * @returns World point at the average of {@link p1} and {@link p2}, `z: 0`
+     */
+    primaryPoint(): AcGePoint3dLike;
+    /**
+     * Serializes this distance measurement to a store/sidecar record.
+     *
+     * @param layoutId - Optional layout BTR id written onto the record
+     * @returns Record with `type: 'distance'` and start/end geometry
+     */
+    toRecord(layoutId?: string): AcApMeasurementRecord;
+    /**
+     * Draws the distance canvas stroke, endpoint dots, length badge, and extras.
+     *
+     * @param view - Active 2D view for HTML overlays
+     * @param db - Database used to format the length label
+     * @returns World-draw result with dispose for the viewChanged listener
+     */
+    protected subWorldDrawWithDb(view: AcTrView2d, db: AcDbDatabase): AcApMeasureWorldDrawResult;
+}
+//# sourceMappingURL=AcApMeasureDistanceEntity.d.ts.map

package/lib/command/measure/entity/AcApMeasureDistanceEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApMeasureDistanceEntity.d.ts","sourceRoot":"","sources":["../../../../src/command/measure/entity/AcApMeasureDistanceEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAM/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAEpE,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAChC,MAAM,qBAAqB,CAAA;AAe5B;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,iBAAiB;IAC9D,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;IACpC,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;IAEpC;;;;;;OAMG;gBAED,EAAE,EAAE,eAAe,EACnB,EAAE,EAAE,eAAe,EACnB,OAAO,EAAE,wBAAwB;IAWnC;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CACX,EAAE,EAAE,eAAe,EACnB,EAAE,EAAE,eAAe,EACnB,KAAK,EAAE,oBAAoB,EAC3B,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,yBAAyB;IAQ5B;;;;OAIG;IACM,YAAY,IAAI,eAAe;IAQxC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,qBAAqB;IAclD;;;;;;OAMG;IACH,SAAS,CAAC,kBAAkB,CAC1B,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,YAAY,GACf,0BAA0B;CAiE9B"}

package/lib/command/measure/entity/AcApMeasureDistanceEntity.js

@@ -0,0 +1,166 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+import { AcTrHtmlBadge, AcTrHtmlCanvasOverlay, AcTrHtmlDot } from '@mlightcad/three-renderer';
+import { acapMeasurementCanvasLineWidth, formatMeasurementLength } from '../../../util';
+import { serializeMeasurementStyle } from '../AcApMeasurementSidecar';
+import { getMeasurementStyle, MEASUREMENT_LAYER } from '../AcApMeasurementStore';
+import { drawMeasureSegmentOnCanvas } from './AcApMeasureDrawUtil';
+import { AcApMeasureEntity } from './AcApMeasureEntity';
+/**
+ * Euclidean distance between two points in the XY plane (Z ignored).
+ *
+ * @param p1 - First endpoint
+ * @param p2 - Second endpoint
+ * @returns Distance `√((Δx)² + (Δy)²)`
+ */
+function calcDist(p1, p2) {
+    var dx = p2.x - p1.x;
+    var dy = p2.y - p1.y;
+    return Math.sqrt(dx * dx + dy * dy);
+}
+/**
+ * Distance measurement overlay entity.
+ *
+ * Renders an HTML canvas segment between two endpoints, HTML dots at each end,
+ * and a length badge at the midpoint. No CAD transient entities.
+ */
+var AcApMeasureDistanceEntity = /** @class */ (function (_super) {
+    __extends(AcApMeasureDistanceEntity, _super);
+    /**
+     * Creates a distance measure entity between two points.
+     *
+     * @param p1 - First endpoint
+     * @param p2 - Second endpoint
+     * @param options - Shared id, layout, and style options
+     */
+    function AcApMeasureDistanceEntity(p1, p2, options) {
+        var _a;
+        var _this = _super.call(this, (_a = options.id) !== null && _a !== void 0 ? _a : "dist-".concat(Date.now()), options.layoutId, options.style) || this;
+        _this.p1 = p1;
+        _this.p2 = p2;
+        return _this;
+    }
+    /**
+     * Factory that builds a distance entity from endpoints and style.
+     *
+     * @param p1 - First endpoint
+     * @param p2 - Second endpoint
+     * @param style - Measurement visual style
+     * @param options - Optional id and layout overrides
+     * @returns New {@link AcApMeasureDistanceEntity}
+     */
+    AcApMeasureDistanceEntity.create = function (p1, p2, style, options) {
+        return new AcApMeasureDistanceEntity(p1, p2, {
+            style: style,
+            id: options === null || options === void 0 ? void 0 : options.id,
+            layoutId: options === null || options === void 0 ? void 0 : options.layoutId
+        });
+    };
+    /**
+     * Midpoint of the measured segment (badge / primary anchor).
+     *
+     * @returns World point at the average of {@link p1} and {@link p2}, `z: 0`
+     */
+    AcApMeasureDistanceEntity.prototype.primaryPoint = function () {
+        return {
+            x: (this.p1.x + this.p2.x) / 2,
+            y: (this.p1.y + this.p2.y) / 2,
+            z: 0
+        };
+    };
+    /**
+     * Serializes this distance measurement to a store/sidecar record.
+     *
+     * @param layoutId - Optional layout BTR id written onto the record
+     * @returns Record with `type: 'distance'` and start/end geometry
+     */
+    AcApMeasureDistanceEntity.prototype.toRecord = function (layoutId) {
+        return {
+            id: this.entityId,
+            type: 'distance',
+            layoutId: layoutId,
+            style: serializeMeasurementStyle(this.style),
+            geometry: {
+                type: 'distance',
+                start: { x: this.p1.x, y: this.p1.y },
+                end: { x: this.p2.x, y: this.p2.y }
+            }
+        };
+    };
+    /**
+     * Draws the distance canvas stroke, endpoint dots, length badge, and extras.
+     *
+     * @param view - Active 2D view for HTML overlays
+     * @param db - Database used to format the length label
+     * @returns World-draw result with dispose for the viewChanged listener
+     */
+    AcApMeasureDistanceEntity.prototype.subWorldDrawWithDb = function (view, db) {
+        var _this = this;
+        var dist = calcDist(this.p1, this.p2);
+        var color = this.style.color;
+        var layoutId = this.resolveLayoutId(view);
+        var mid = this.primaryPoint();
+        var persistOverlay = new AcTrHtmlCanvasOverlay({
+            id: "dist-canvas-".concat(this.entityId),
+            container: view.container,
+            layer: MEASUREMENT_LAYER,
+            layoutId: layoutId
+        });
+        var paintSegment = function (paintStyle) {
+            if (paintStyle === void 0) { paintStyle = _this.style; }
+            return drawMeasureSegmentOnCanvas(persistOverlay.canvas, view, _this.p1, _this.p2, paintStyle.color, acapMeasurementCanvasLineWidth(paintStyle.lineWeight));
+        };
+        paintSegment();
+        var redrawPersist = function () { var _a; return paintSegment((_a = getMeasurementStyle(_this.entityId)) !== null && _a !== void 0 ? _a : _this.style); };
+        view.events.viewChanged.addEventListener(redrawPersist);
+        var group = this.createGroup(view)
+            .add(new AcTrHtmlDot({
+            id: "".concat(this.entityId, "-dot1"),
+            color: color,
+            worldPosition: this.p1,
+            layer: MEASUREMENT_LAYER
+        }), new AcTrHtmlDot({
+            id: "".concat(this.entityId, "-dot2"),
+            color: color,
+            worldPosition: this.p2,
+            layer: MEASUREMENT_LAYER
+        }), new AcTrHtmlBadge({
+            id: "".concat(this.entityId, "-badge"),
+            color: color,
+            text: formatMeasurementLength(db, dist),
+            worldPosition: mid,
+            layer: MEASUREMENT_LAYER,
+            fontSize: this.style.fontSize
+        }))
+            .addCanvas(persistOverlay);
+        return {
+            group: group,
+            entityIds: [],
+            dispose: function () {
+                view.events.viewChanged.removeEventListener(redrawPersist);
+            },
+            extras: {
+                style: this.style,
+                value: { kind: 'length', value: dist },
+                snapshot: this.toRecord(layoutId),
+                redraw: paintSegment
+            }
+        };
+    };
+    return AcApMeasureDistanceEntity;
+}(AcApMeasureEntity));
+export { AcApMeasureDistanceEntity };
+//# sourceMappingURL=AcApMeasureDistanceEntity.js.map

package/lib/command/measure/entity/AcApMeasureDistanceEntity.js.map

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

package/lib/command/measure/entity/AcApMeasureDrawUtil.d.ts

@@ -0,0 +1,129 @@
+import type { AcCmColor } from '@mlightcad/data-model';
+import type { AcEdBaseView } from '../../../editor';
+/**
+ * Two-dimensional point in world or screen space (XY only).
+ */
+type Point2 = {
+    /** X coordinate. */
+    x: number;
+    /** Y coordinate. */
+    y: number;
+};
+/**
+ * Strokes a single world-space segment onto a measure overlay canvas.
+ *
+ * @param canvas - Overlay canvas to paint
+ * @param view - View for world-to-screen conversion and canvas sizing
+ * @param p1 - Segment start in world coordinates
+ * @param p2 - Segment end in world coordinates
+ * @param color - Stroke color
+ * @param lineWidth - Stroke width in CSS pixels (default `2`)
+ */
+export declare function drawMeasureSegmentOnCanvas(canvas: HTMLCanvasElement, view: AcEdBaseView, p1: Point2, p2: Point2, color: AcCmColor, lineWidth?: number): void;
+/**
+ * Draws angle arm lines plus the measurement arc on a measure overlay canvas.
+ *
+ * Converts `vertex`, `arm1`, and `arm2` to screen space, strokes both arms,
+ * then draws the shorter angular sector with a radius derived from the shorter
+ * arm length (with a minimum).
+ *
+ * @param canvas - Overlay canvas to paint
+ * @param view - View for world-to-screen conversion and canvas sizing
+ * @param vertex - Angle vertex in world coordinates
+ * @param arm1 - First arm endpoint in world coordinates
+ * @param arm2 - Second arm endpoint in world coordinates
+ * @param color - Stroke color
+ * @param lineWidth - Stroke width in CSS pixels (default `2`)
+ */
+export declare function drawMeasureAngleArcOnCanvas(canvas: HTMLCanvasElement, view: AcEdBaseView, vertex: Point2, arm1: Point2, arm2: Point2, color: AcCmColor, lineWidth?: number): void;
+/**
+ * Draws a filled polygon for an area measurement on a measure overlay canvas.
+ *
+ * Requires at least three points. Fills with a translucent tint of `color` and
+ * strokes the closed outline.
+ *
+ * @param canvas - Overlay canvas to paint
+ * @param view - View for world-to-screen conversion and canvas sizing
+ * @param points - Polygon vertices in world coordinates (closed implicitly)
+ * @param color - Fill and stroke color
+ * @param lineWidth - Stroke width in CSS pixels (default `2.5`)
+ */
+export declare function drawMeasureAreaOnCanvas(canvas: HTMLCanvasElement, view: AcEdBaseView, points: Point2[], color: AcCmColor, lineWidth?: number): void;
+/**
+ * Circle geometry in world XY used by arc-length measurements.
+ */
+export interface AcApMeasureCircleGeom {
+    /** Circle center X in world coordinates. */
+    cx: number;
+    /** Circle center Y in world coordinates. */
+    cy: number;
+    /** Circle radius in world units. */
+    r: number;
+}
+/**
+ * Strokes the shorter arc between two points on a circle onto a measure canvas.
+ *
+ * Screen radius is taken from the distance of `p1` to the projected center so
+ * the stroke tracks the circle under the current view transform.
+ *
+ * @param canvas - Overlay canvas to paint
+ * @param view - View for world-to-screen conversion and canvas sizing
+ * @param g - Circle center and radius in world coordinates
+ * @param p1 - Arc start point in world coordinates (on or near the circle)
+ * @param p2 - Arc end point in world coordinates (on or near the circle)
+ * @param color - Stroke color
+ * @param lineWidth - Stroke width in CSS pixels (default `4`)
+ */
+export declare function drawMeasureArcOnCanvas(canvas: HTMLCanvasElement, view: AcEdBaseView, g: AcApMeasureCircleGeom, p1: Point2, p2: Point2, color: AcCmColor, lineWidth?: number): void;
+/**
+ * Computes the shorter arc length between two points on a circle.
+ *
+ * @param p1 - First point in world coordinates
+ * @param p2 - Second point in world coordinates
+ * @param g - Circle center and radius
+ * @returns Arc length along the shorter sector (`min(span, 2π − span) × r`)
+ */
+export declare function measureShortArcLength(p1: Point2, p2: Point2, g: AcApMeasureCircleGeom): number;
+/**
+ * Finds the midpoint of the shorter arc between two points on a circle.
+ *
+ * @param p1 - Arc start in world coordinates
+ * @param p2 - Arc end in world coordinates
+ * @param g - Circle center and radius
+ * @returns Midpoint on the shorter arc with `z: 0`
+ */
+export declare function measureShortArcMid(p1: Point2, p2: Point2, g: AcApMeasureCircleGeom): {
+    x: number;
+    y: number;
+    z: number;
+};
+/**
+ * Computes polygon area using the shoelace formula.
+ *
+ * @param pts - Polygon vertices in world coordinates (assumed closed)
+ * @returns Absolute area (half the absolute shoelace sum)
+ */
+export declare function measureShoelaceArea(pts: Point2[]): number;
+/**
+ * Computes the arithmetic mean of polygon vertices (simple centroid).
+ *
+ * @param pts - Vertices in world coordinates (must be non-empty)
+ * @returns Average `{ x, y }` of the points
+ */
+export declare function measureCentroid(pts: Point2[]): {
+    x: number;
+    y: number;
+};
+/**
+ * Computes the smaller angle at `vertex` between `arm1` and `arm2`, in degrees.
+ *
+ * Uses atan2 of cross/dot products so the result is in `[0, 180]`.
+ *
+ * @param vertex - Angle vertex in world coordinates
+ * @param arm1 - First arm endpoint in world coordinates
+ * @param arm2 - Second arm endpoint in world coordinates
+ * @returns Interior (smaller) angle in degrees
+ */
+export declare function measureAngleDeg(vertex: Point2, arm1: Point2, arm2: Point2): number;
+export {};
+//# sourceMappingURL=AcApMeasureDrawUtil.d.ts.map

package/lib/command/measure/entity/AcApMeasureDrawUtil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApMeasureDrawUtil.d.ts","sourceRoot":"","sources":["../../../../src/command/measure/entity/AcApMeasureDrawUtil.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGnD;;GAEG;AACH,KAAK,MAAM,GAAG;IACZ,oBAAoB;IACpB,CAAC,EAAE,MAAM,CAAA;IACT,oBAAoB;IACpB,CAAC,EAAE,MAAM,CAAA;CACV,CAAA;AAkDD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,YAAY,EAClB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,SAAS,EAChB,SAAS,SAAI,GACZ,IAAI,CAaN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,EAChB,SAAS,SAAI,GACZ,IAAI,CA8BN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,SAAS,EAChB,SAAS,SAAM,GACd,IAAI,CAmBN;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAA;IACV,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAA;IACV,oCAAoC;IACpC,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,YAAY,EAClB,CAAC,EAAE,qBAAqB,EACxB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,SAAS,EAChB,SAAS,SAAI,GACZ,IAAI,CAqBN;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,CAAC,EAAE,qBAAqB,GACvB,MAAM,CAKR;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,CAAC,EAAE,qBAAqB,GACvB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAOrC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,CASzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAIvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CASR"}