@mlightcad/cad-simple-viewer 1.5.10 → 1.6.0

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

@@ -0,0 +1,257 @@
+import { acapColorToCssAlpha, acapCssColor } from '../../../util';
+/**
+ * Sizes and clears a measure overlay canvas to match the view viewport.
+ *
+ * Aligns the canvas with the view's drawing surface (including device pixel
+ * ratio), clears previous content, and returns a 2D context scaled so that
+ * subsequent drawing uses CSS pixels.
+ *
+ * @param canvas - Overlay canvas element to prepare
+ * @param view - View whose canvas bounds and transforms define the overlay
+ * @returns Context and DPR when preparation succeeds; `null` if 2D context is unavailable
+ */
+function prepareMeasureCanvas(canvas, view) {
+    var rect = view.canvas.getBoundingClientRect();
+    var dpr = window.devicePixelRatio || 1;
+    var w = Math.round(rect.width);
+    var h = Math.round(rect.height);
+    var origin = view.canvasToContainer({ x: 0, y: 0 });
+    canvas.style.left = "".concat(origin.x, "px");
+    canvas.style.top = "".concat(origin.y, "px");
+    canvas.style.width = "".concat(w, "px");
+    canvas.style.height = "".concat(h, "px");
+    if (canvas.width !== w * dpr || canvas.height !== h * dpr) {
+        canvas.width = w * dpr;
+        canvas.height = h * dpr;
+    }
+    var ctx = canvas.getContext('2d');
+    if (!ctx)
+        return null;
+    ctx.clearRect(0, 0, canvas.width, canvas.height);
+    ctx.save();
+    ctx.scale(dpr, dpr);
+    return { ctx: ctx, dpr: dpr };
+}
+/**
+ * Normalizes an angle in radians to the half-open interval `[0, 2π)`.
+ *
+ * @param a - Angle in radians (any real value)
+ * @returns Equivalent angle in `[0, 2π)`
+ */
+var normaliseAngle = function (a) {
+    return ((a % (2 * Math.PI)) + 2 * Math.PI) % (2 * Math.PI);
+};
+/**
+ * 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 function drawMeasureSegmentOnCanvas(canvas, view, p1, p2, color, lineWidth) {
+    if (lineWidth === void 0) { lineWidth = 2; }
+    var prepared = prepareMeasureCanvas(canvas, view);
+    if (!prepared)
+        return;
+    var ctx = prepared.ctx;
+    var a = view.worldToScreen(p1);
+    var b = view.worldToScreen(p2);
+    ctx.beginPath();
+    ctx.moveTo(a.x, a.y);
+    ctx.lineTo(b.x, b.y);
+    ctx.strokeStyle = acapCssColor(color);
+    ctx.lineWidth = lineWidth;
+    ctx.stroke();
+    ctx.restore();
+}
+/**
+ * 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 function drawMeasureAngleArcOnCanvas(canvas, view, vertex, arm1, arm2, color, lineWidth) {
+    if (lineWidth === void 0) { lineWidth = 2; }
+    var prepared = prepareMeasureCanvas(canvas, view);
+    if (!prepared)
+        return;
+    var ctx = prepared.ctx;
+    var sv = view.worldToScreen(vertex);
+    var sa1 = view.worldToScreen(arm1);
+    var sa2 = view.worldToScreen(arm2);
+    ctx.strokeStyle = acapCssColor(color);
+    ctx.lineWidth = lineWidth;
+    ctx.beginPath();
+    ctx.moveTo(sv.x, sv.y);
+    ctx.lineTo(sa1.x, sa1.y);
+    ctx.moveTo(sv.x, sv.y);
+    ctx.lineTo(sa2.x, sa2.y);
+    ctx.stroke();
+    var len1 = Math.hypot(sa1.x - sv.x, sa1.y - sv.y);
+    var len2 = Math.hypot(sa2.x - sv.x, sa2.y - sv.y);
+    var arcR = Math.max(Math.min(len1, len2) * 0.3, 15);
+    var startAngle = Math.atan2(sa1.y - sv.y, sa1.x - sv.x);
+    var endAngle = Math.atan2(sa2.y - sv.y, sa2.x - sv.x);
+    var antiClockwise = normaliseAngle(endAngle - startAngle) > Math.PI;
+    ctx.beginPath();
+    ctx.arc(sv.x, sv.y, arcR, startAngle, endAngle, antiClockwise);
+    ctx.stroke();
+    ctx.restore();
+}
+/**
+ * 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 function drawMeasureAreaOnCanvas(canvas, view, points, color, lineWidth) {
+    if (lineWidth === void 0) { lineWidth = 2.5; }
+    var prepared = prepareMeasureCanvas(canvas, view);
+    if (!prepared || points.length < 3) {
+        prepared === null || prepared === void 0 ? void 0 : prepared.ctx.restore();
+        return;
+    }
+    var ctx = prepared.ctx;
+    var spts = points.map(function (p) { return view.worldToScreen(p); });
+    ctx.beginPath();
+    ctx.moveTo(spts[0].x, spts[0].y);
+    for (var i = 1; i < spts.length; i++)
+        ctx.lineTo(spts[i].x, spts[i].y);
+    ctx.closePath();
+    ctx.fillStyle = acapColorToCssAlpha(color, 0.2);
+    ctx.fill();
+    ctx.strokeStyle = acapCssColor(color);
+    ctx.lineWidth = lineWidth;
+    ctx.stroke();
+    ctx.restore();
+}
+/**
+ * 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 function drawMeasureArcOnCanvas(canvas, view, g, p1, p2, color, lineWidth) {
+    if (lineWidth === void 0) { lineWidth = 4; }
+    var prepared = prepareMeasureCanvas(canvas, view);
+    if (!prepared)
+        return;
+    var ctx = prepared.ctx;
+    var sc = view.worldToScreen({ x: g.cx, y: g.cy });
+    var ss = view.worldToScreen(p1);
+    var se = view.worldToScreen(p2);
+    var screenR = Math.hypot(ss.x - sc.x, ss.y - sc.y);
+    var sa = Math.atan2(ss.y - sc.y, ss.x - sc.x);
+    var ea = Math.atan2(se.y - sc.y, se.x - sc.x);
+    var cwSpan = normaliseAngle(ea - sa);
+    var antiClockwise = cwSpan > Math.PI;
+    ctx.beginPath();
+    ctx.arc(sc.x, sc.y, screenR, sa, ea, antiClockwise);
+    ctx.strokeStyle = acapCssColor(color);
+    ctx.lineWidth = lineWidth;
+    ctx.stroke();
+    ctx.restore();
+}
+/**
+ * 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 function measureShortArcLength(p1, p2, g) {
+    var a1 = Math.atan2(p1.y - g.cy, p1.x - g.cx);
+    var a2 = Math.atan2(p2.y - g.cy, p2.x - g.cx);
+    var span = normaliseAngle(a2 - a1);
+    return Math.min(span, 2 * Math.PI - span) * g.r;
+}
+/**
+ * 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 function measureShortArcMid(p1, p2, g) {
+    var a1 = Math.atan2(p1.y - g.cy, p1.x - g.cx);
+    var a2 = Math.atan2(p2.y - g.cy, p2.x - g.cx);
+    var ccwSpan = normaliseAngle(a2 - a1);
+    var mid = ccwSpan <= Math.PI ? a1 + ccwSpan / 2 : a1 - (2 * Math.PI - ccwSpan) / 2;
+    return { x: g.cx + g.r * Math.cos(mid), y: g.cy + g.r * Math.sin(mid), z: 0 };
+}
+/**
+ * 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 function measureShoelaceArea(pts) {
+    var area = 0;
+    var n = pts.length;
+    for (var i = 0; i < n; i++) {
+        var j = (i + 1) % n;
+        area += pts[i].x * pts[j].y;
+        area -= pts[j].x * pts[i].y;
+    }
+    return Math.abs(area) / 2;
+}
+/**
+ * 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 function measureCentroid(pts) {
+    var x = pts.reduce(function (s, p) { return s + p.x; }, 0) / pts.length;
+    var y = pts.reduce(function (s, p) { return s + p.y; }, 0) / pts.length;
+    return { x: x, y: y };
+}
+/**
+ * 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 function measureAngleDeg(vertex, arm1, arm2) {
+    var dx1 = arm1.x - vertex.x;
+    var dy1 = arm1.y - vertex.y;
+    var dx2 = arm2.x - vertex.x;
+    var dy2 = arm2.y - vertex.y;
+    var dot = dx1 * dx2 + dy1 * dy2;
+    var cross = dx1 * dy2 - dy1 * dx2;
+    var rad = Math.atan2(Math.abs(cross), dot);
+    return (rad * 180) / Math.PI;
+}
+//# sourceMappingURL=AcApMeasureDrawUtil.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcApMeasureDrawUtil.js","sourceRoot":"","sources":["../../../../src/command/measure/entity/AcApMeasureDrawUtil.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAYjE;;;;;;;;;;GAUG;AACH,SAAS,oBAAoB,CAC3B,MAAyB,EACzB,IAAkB;IAElB,IAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAA;IAChD,IAAM,GAAG,GAAG,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAA;IACxC,IAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAChC,IAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAEjC,IAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACrD,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,UAAG,MAAM,CAAC,CAAC,OAAI,CAAA;IACnC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,UAAG,MAAM,CAAC,CAAC,OAAI,CAAA;IAClC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,UAAG,CAAC,OAAI,CAAA;IAC7B,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,UAAG,CAAC,OAAI,CAAA;IAE9B,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC;QAC1D,MAAM,CAAC,KAAK,GAAG,CAAC,GAAG,GAAG,CAAA;QACtB,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,GAAG,CAAA;IACzB,CAAC;IAED,IAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IACrB,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IAChD,GAAG,CAAC,IAAI,EAAE,CAAA;IACV,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IACnB,OAAO,EAAE,GAAG,KAAA,EAAE,GAAG,KAAA,EAAE,CAAA;AACrB,CAAC;AAED;;;;;GAKG;AACH,IAAM,cAAc,GAAG,UAAC,CAAS;IAC/B,OAAA,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;AAAnD,CAAmD,CAAA;AAErD;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAyB,EACzB,IAAkB,EAClB,EAAU,EACV,EAAU,EACV,KAAgB,EAChB,SAAa;IAAb,0BAAA,EAAA,aAAa;IAEb,IAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACnD,IAAI,CAAC,QAAQ;QAAE,OAAM;IACb,IAAA,GAAG,GAAK,QAAQ,IAAb,CAAa;IACxB,IAAM,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;IAChC,IAAM,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;IAChC,GAAG,CAAC,SAAS,EAAE,CAAA;IACf,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACpB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACpB,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IACrC,GAAG,CAAC,SAAS,GAAG,SAAS,CAAA;IACzB,GAAG,CAAC,MAAM,EAAE,CAAA;IACZ,GAAG,CAAC,OAAO,EAAE,CAAA;AACf,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAyB,EACzB,IAAkB,EAClB,MAAc,EACd,IAAY,EACZ,IAAY,EACZ,KAAgB,EAChB,SAAa;IAAb,0BAAA,EAAA,aAAa;IAEb,IAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACnD,IAAI,CAAC,QAAQ;QAAE,OAAM;IACb,IAAA,GAAG,GAAK,QAAQ,IAAb,CAAa;IAExB,IAAM,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IACrC,IAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;IACpC,IAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;IAEpC,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IACrC,GAAG,CAAC,SAAS,GAAG,SAAS,CAAA;IACzB,GAAG,CAAC,SAAS,EAAE,CAAA;IACf,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IACtB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;IACxB,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IACtB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;IACxB,GAAG,CAAC,MAAM,EAAE,CAAA;IAEZ,IAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;IACnD,IAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;IACnD,IAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAA;IAErD,IAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;IACzD,IAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;IACvD,IAAM,aAAa,GAAG,cAAc,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,EAAE,CAAA;IAErE,GAAG,CAAC,SAAS,EAAE,CAAA;IACf,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAA;IAC9D,GAAG,CAAC,MAAM,EAAE,CAAA;IACZ,GAAG,CAAC,OAAO,EAAE,CAAA;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAyB,EACzB,IAAkB,EAClB,MAAgB,EAChB,KAAgB,EAChB,SAAe;IAAf,0BAAA,EAAA,eAAe;IAEf,IAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACnD,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,GAAG,CAAC,OAAO,EAAE,CAAA;QACvB,OAAM;IACR,CAAC;IACO,IAAA,GAAG,GAAK,QAAQ,IAAb,CAAa;IACxB,IAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,UAAA,CAAC,IAAI,OAAA,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAArB,CAAqB,CAAC,CAAA;IAEnD,GAAG,CAAC,SAAS,EAAE,CAAA;IACf,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACtE,GAAG,CAAC,SAAS,EAAE,CAAA;IACf,GAAG,CAAC,SAAS,GAAG,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IAC/C,GAAG,CAAC,IAAI,EAAE,CAAA;IACV,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IACrC,GAAG,CAAC,SAAS,GAAG,SAAS,CAAA;IACzB,GAAG,CAAC,MAAM,EAAE,CAAA;IACZ,GAAG,CAAC,OAAO,EAAE,CAAA;AACf,CAAC;AAcD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAyB,EACzB,IAAkB,EAClB,CAAwB,EACxB,EAAU,EACV,EAAU,EACV,KAAgB,EAChB,SAAa;IAAb,0BAAA,EAAA,aAAa;IAEb,IAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACnD,IAAI,CAAC,QAAQ;QAAE,OAAM;IACb,IAAA,GAAG,GAAK,QAAQ,IAAb,CAAa;IAExB,IAAM,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACnD,IAAM,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;IACjC,IAAM,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;IACjC,IAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;IAEpD,IAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;IAC/C,IAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;IAC/C,IAAM,MAAM,GAAG,cAAc,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;IACtC,IAAM,aAAa,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,CAAA;IAEtC,GAAG,CAAC,SAAS,EAAE,CAAA;IACf,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,aAAa,CAAC,CAAA;IACnD,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IACrC,GAAG,CAAC,SAAS,GAAG,SAAS,CAAA;IACzB,GAAG,CAAC,MAAM,EAAE,CAAA;IACZ,GAAG,CAAC,OAAO,EAAE,CAAA;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,EAAU,EACV,EAAU,EACV,CAAwB;IAExB,IAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAA;IAC/C,IAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAA;IAC/C,IAAM,IAAI,GAAG,cAAc,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;IACpC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,EAAU,EACV,EAAU,EACV,CAAwB;IAExB,IAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAA;IAC/C,IAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAA;IAC/C,IAAM,OAAO,GAAG,cAAc,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;IACvC,IAAM,GAAG,GACP,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAC1E,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;AAC/E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAa;IAC/C,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,IAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAA;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;QACrB,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3B,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAa;IAC3C,IAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,GAAG,CAAC,CAAC,CAAC,EAAP,CAAO,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAA;IACvD,IAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,CAAC,GAAG,CAAC,CAAC,CAAC,EAAP,CAAO,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAA;IACvD,OAAO,EAAE,CAAC,GAAA,EAAE,CAAC,GAAA,EAAE,CAAA;AACjB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,IAAY,EACZ,IAAY;IAEZ,IAAM,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAA;IAC7B,IAAM,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAA;IAC7B,IAAM,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAA;IAC7B,IAAM,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAA;IAC7B,IAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IACjC,IAAM,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IACnC,IAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAA;IAC5C,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAA;AAC9B,CAAC"}

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

@@ -0,0 +1,148 @@
+import type { AcDbDatabase, AcGePoint3dLike } from '@mlightcad/data-model';
+import { AcTrHtmlGroup } from '@mlightcad/three-renderer';
+import type { AcApMeasurementStyle } from '../../../util';
+import type { AcTrView2d } from '../../../view';
+import { AcApOverlayEntity, type AcApOverlaySerializable, type AcApOverlayWorldDrawResult } from '../../overlay';
+import { type AcApMeasurementGroupExtras } from '../AcApMeasurementStore';
+import type { AcApMeasurementRecord } from '../AcApMeasurementTypes';
+/**
+ * Options shared by measurement entity constructors.
+ *
+ * Concrete measure entities pass these into {@link AcApMeasureEntity} so id,
+ * layout, and visual style are consistent across distance, angle, area, arc,
+ * and point measurements.
+ */
+export interface AcApMeasureEntityOptions {
+    /** Optional stable id; when omitted, subclasses generate a typed timestamp id. */
+    id?: string;
+    /** Layout BTR id to bind the HTML group to, or omit for the active layout. */
+    layoutId?: string;
+    /** Visual style (color, line weight, font size) for CAD and HTML overlays. */
+    style: AcApMeasurementStyle;
+}
+/**
+ * Result of drawing a measurement: HTML group plus store extras for commit.
+ *
+ * Extends the overlay world-draw result with {@link extras} consumed by
+ * {@link commitMeasurementGroup} when persisting the measurement.
+ *
+ * Put CAD / listener teardown on {@link AcApOverlayWorldDrawResult.dispose};
+ * {@link AcApMeasureEntity.commit} wires that into `extras.dispose` so the
+ * store always runs it. Do not duplicate cleanup in `extras.dispose`.
+ */
+export interface AcApMeasureWorldDrawResult extends AcApOverlayWorldDrawResult {
+    /** Store payload (style, value, snapshot, redraw) for commit. */
+    extras: AcApMeasurementGroupExtras;
+}
+/**
+ * Base class for measurement overlays (distance / angle / area / arc / point).
+ *
+ * Not an HTML leaf — composes {@link AcTrHtmlGroup} and canvas / badge / dot
+ * children. Subclasses implement {@link toRecord} and
+ * {@link subWorldDrawWithDb}; callers should use {@link commit} rather than
+ * the generic overlay `worldDraw` path because unit labels need the database.
+ *
+ * Implements {@link AcApOverlaySerializable} via {@link toRecord}. Rehydrate
+ * with {@link import('./AcApMeasureEntityFactory').createMeasureEntityFromRecord}.
+ */
+export declare abstract class AcApMeasureEntity extends AcApOverlayEntity implements AcApOverlaySerializable<AcApMeasurementRecord> {
+    /** Visual style applied to HTML badges/dots and canvas strokes. */
+    protected readonly style: AcApMeasurementStyle;
+    /** Stable measurement id used for HTML group, store, and sidecar records. */
+    protected readonly entityId: string;
+    /** Optional layout override from construction options. */
+    protected readonly layoutIdOption: string | undefined;
+    /**
+     * Creates a measure entity with the given id, layout, and style.
+     *
+     * @param id - Stable measurement identifier
+     * @param layoutId - Layout BTR id, or `undefined` to resolve from the view
+     * @param style - Measurement visual style
+     */
+    constructor(id: string, layoutId: string | undefined, style: AcApMeasurementStyle);
+    /**
+     * Stable identifier for this measurement entity.
+     *
+     * @returns The entity id used in the HTML group and store
+     */
+    get id(): string;
+    /**
+     * Builds a serializable snapshot of this measurement.
+     *
+     * Geometry is taken from construction-time fields; `layoutId` may override
+     * the layout stored on the record.
+     *
+     * @param layoutId - Optional layout BTR id written onto the record
+     * @returns Sidecar-ready measurement record
+     */
+    abstract toRecord(layoutId?: string): AcApMeasurementRecord;
+    /**
+     * Hit-tests this measurement's geometry against a canvas point.
+     *
+     * Delegates to {@link hitTestMeasurementGeometry} using
+     * {@link toRecord}'s geometry.
+     *
+     * @param canvas - Pointer position in canvas/screen coordinates
+     * @param worldToScreen - Converts world XY to screen for distance checks
+     * @param threshold - Hit tolerance in screen pixels
+     * @returns `true` if the point is within threshold of the geometry
+     */
+    hitTest(canvas: {
+        x: number;
+        y: number;
+    }, worldToScreen: (point: {
+        x: number;
+        y: number;
+    }) => {
+        x: number;
+        y: number;
+    }, threshold: number): boolean;
+    /**
+     * Builds visuals and commits them to the measurement store / HTML manager.
+     *
+     * Calls {@link subWorldDrawWithDb}, then {@link commitMeasurementGroup}
+     * with the resulting group and extras. Uses {@link AcApOverlayWorldDrawResult.dispose}
+     * as the store's dispose hook so entity cleanup cannot be dropped.
+     *
+     * @param view - Active 2D view hosting HTML overlays and CAD transients
+     * @param db - Drawing database used for unit/format labels
+     */
+    commit(view: AcTrView2d, db: AcDbDatabase): void;
+    /**
+     * Overlay `worldDraw` hook — not supported for measurements.
+     *
+     * Prefer {@link commit}; measure draw needs the database for unit labels.
+     *
+     * @param view - Active 2D view (unused)
+     * @returns Never returns; always throws
+     * @throws Error directing callers to use {@link commit}
+     */
+    protected subWorldDraw(view: AcTrView2d): AcApOverlayWorldDrawResult;
+    /**
+     * Builds the HTML group, CAD transients, and store extras for this measure.
+     *
+     * @param view - Active 2D view
+     * @param db - Drawing database for formatting measured values
+     * @returns World-draw result including commit extras
+     */
+    protected abstract subWorldDrawWithDb(view: AcTrView2d, db: AcDbDatabase): AcApMeasureWorldDrawResult;
+    /**
+     * Creates an empty selectable HTML group on the measurement layer.
+     *
+     * @param view - View used to resolve the active layout when needed
+     * @returns New {@link AcTrHtmlGroup} for this entity id
+     */
+    protected createGroup(view: AcTrView2d): AcTrHtmlGroup;
+    /**
+     * Resolves the layout id for HTML overlays.
+     *
+     * Uses {@link layoutIdOption} when set; otherwise the view's active layout
+     * BTR id.
+     *
+     * @param view - View providing the active layout fallback
+     * @returns Layout BTR id, or `undefined` if neither is available
+     */
+    protected resolveLayoutId(view: AcTrView2d): string | undefined;
+}
+export type { AcGePoint3dLike };
+//# sourceMappingURL=AcApMeasureEntity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcApMeasureEntity.d.ts","sourceRoot":"","sources":["../../../../src/command/measure/entity/AcApMeasureEntity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EAChB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAEzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EACL,iBAAiB,EACjB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAChC,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,KAAK,0BAA0B,EAGhC,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAEpE;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,kFAAkF;IAClF,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8EAA8E;IAC9E,KAAK,EAAE,oBAAoB,CAAA;CAC5B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,0BAA2B,SAAQ,0BAA0B;IAC5E,iEAAiE;IACjE,MAAM,EAAE,0BAA0B,CAAA;CACnC;AAED;;;;;;;;;;GAUG;AACH,8BAAsB,iBACpB,SAAQ,iBACR,YAAW,uBAAuB,CAAC,qBAAqB,CAAC;IAEzD,mEAAmE;IACnE,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;IAC9C,6EAA6E;IAC7E,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACnC,0DAA0D;IAC1D,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAErD;;;;;;OAMG;gBAED,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,oBAAoB;IAQ7B;;;;OAIG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,qBAAqB;IAE3D;;;;;;;;;;OAUG;IACM,OAAO,CACd,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAChC,aAAa,EAAE,CAAC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK;QAClD,CAAC,EAAE,MAAM,CAAA;QACT,CAAC,EAAE,MAAM,CAAA;KACV,EACD,SAAS,EAAE,MAAM,GAChB,OAAO;IASV;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,YAAY,GAAG,IAAI;IAQhD;;;;;;;;OAQG;IACH,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,0BAA0B;IAOpE;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CACnC,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,YAAY,GACf,0BAA0B;IAE7B;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa;IAStD;;;;;;;;OAQG;IACH,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS;CAGhE;AAED,YAAY,EAAE,eAAe,EAAE,CAAA"}

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

@@ -0,0 +1,141 @@
+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 __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { AcTrHtmlGroup } from '@mlightcad/three-renderer';
+import { AcApOverlayEntity } from '../../overlay';
+import { hitTestMeasurementGeometry } from '../AcApMeasurementGeometry';
+import { commitMeasurementGroup, MEASUREMENT_LAYER } from '../AcApMeasurementStore';
+/**
+ * Base class for measurement overlays (distance / angle / area / arc / point).
+ *
+ * Not an HTML leaf — composes {@link AcTrHtmlGroup} and canvas / badge / dot
+ * children. Subclasses implement {@link toRecord} and
+ * {@link subWorldDrawWithDb}; callers should use {@link commit} rather than
+ * the generic overlay `worldDraw` path because unit labels need the database.
+ *
+ * Implements {@link AcApOverlaySerializable} via {@link toRecord}. Rehydrate
+ * with {@link import('./AcApMeasureEntityFactory').createMeasureEntityFromRecord}.
+ */
+var AcApMeasureEntity = /** @class */ (function (_super) {
+    __extends(AcApMeasureEntity, _super);
+    /**
+     * Creates a measure entity with the given id, layout, and style.
+     *
+     * @param id - Stable measurement identifier
+     * @param layoutId - Layout BTR id, or `undefined` to resolve from the view
+     * @param style - Measurement visual style
+     */
+    function AcApMeasureEntity(id, layoutId, style) {
+        var _this = _super.call(this) || this;
+        _this.entityId = id;
+        _this.layoutIdOption = layoutId;
+        _this.style = style;
+        return _this;
+    }
+    Object.defineProperty(AcApMeasureEntity.prototype, "id", {
+        /**
+         * Stable identifier for this measurement entity.
+         *
+         * @returns The entity id used in the HTML group and store
+         */
+        get: function () {
+            return this.entityId;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Hit-tests this measurement's geometry against a canvas point.
+     *
+     * Delegates to {@link hitTestMeasurementGeometry} using
+     * {@link toRecord}'s geometry.
+     *
+     * @param canvas - Pointer position in canvas/screen coordinates
+     * @param worldToScreen - Converts world XY to screen for distance checks
+     * @param threshold - Hit tolerance in screen pixels
+     * @returns `true` if the point is within threshold of the geometry
+     */
+    AcApMeasureEntity.prototype.hitTest = function (canvas, worldToScreen, threshold) {
+        return hitTestMeasurementGeometry(this.toRecord().geometry, canvas, worldToScreen, threshold);
+    };
+    /**
+     * Builds visuals and commits them to the measurement store / HTML manager.
+     *
+     * Calls {@link subWorldDrawWithDb}, then {@link commitMeasurementGroup}
+     * with the resulting group and extras. Uses {@link AcApOverlayWorldDrawResult.dispose}
+     * as the store's dispose hook so entity cleanup cannot be dropped.
+     *
+     * @param view - Active 2D view hosting HTML overlays and CAD transients
+     * @param db - Drawing database used for unit/format labels
+     */
+    AcApMeasureEntity.prototype.commit = function (view, db) {
+        var drawn = this.subWorldDrawWithDb(view, db);
+        commitMeasurementGroup(view, drawn.group, __assign(__assign({}, drawn.extras), { dispose: drawn.dispose }));
+    };
+    /**
+     * Overlay `worldDraw` hook — not supported for measurements.
+     *
+     * Prefer {@link commit}; measure draw needs the database for unit labels.
+     *
+     * @param view - Active 2D view (unused)
+     * @returns Never returns; always throws
+     * @throws Error directing callers to use {@link commit}
+     */
+    AcApMeasureEntity.prototype.subWorldDraw = function (view) {
+        void view;
+        throw new Error('Use AcApMeasureEntity.commit(view, db) instead of worldDraw');
+    };
+    /**
+     * Creates an empty selectable HTML group on the measurement layer.
+     *
+     * @param view - View used to resolve the active layout when needed
+     * @returns New {@link AcTrHtmlGroup} for this entity id
+     */
+    AcApMeasureEntity.prototype.createGroup = function (view) {
+        return new AcTrHtmlGroup({
+            id: this.entityId,
+            layer: MEASUREMENT_LAYER,
+            layoutId: this.resolveLayoutId(view),
+            selectable: true
+        });
+    };
+    /**
+     * Resolves the layout id for HTML overlays.
+     *
+     * Uses {@link layoutIdOption} when set; otherwise the view's active layout
+     * BTR id.
+     *
+     * @param view - View providing the active layout fallback
+     * @returns Layout BTR id, or `undefined` if neither is available
+     */
+    AcApMeasureEntity.prototype.resolveLayoutId = function (view) {
+        var _a;
+        return (_a = this.layoutIdOption) !== null && _a !== void 0 ? _a : view.activeLayoutBtrId;
+    };
+    return AcApMeasureEntity;
+}(AcApOverlayEntity));
+export { AcApMeasureEntity };
+//# sourceMappingURL=AcApMeasureEntity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcApMeasureEntity.js","sourceRoot":"","sources":["../../../../src/command/measure/entity/AcApMeasureEntity.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAIzD,OAAO,EACL,iBAAiB,EAGlB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAA;AACvE,OAAO,EAEL,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,yBAAyB,CAAA;AAkChC;;;;;;;;;;GAUG;AACH;IACU,qCAAiB;IAUzB;;;;;;OAMG;IACH,2BACE,EAAU,EACV,QAA4B,EAC5B,KAA2B;QAE3B,YAAA,MAAK,WAAE,SAAA;QACP,KAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;QAClB,KAAI,CAAC,cAAc,GAAG,QAAQ,CAAA;QAC9B,KAAI,CAAC,KAAK,GAAG,KAAK,CAAA;;IACpB,CAAC;IAOD,sBAAI,iCAAE;QALN;;;;WAIG;aACH;YACE,OAAO,IAAI,CAAC,QAAQ,CAAA;QACtB,CAAC;;;OAAA;IAaD;;;;;;;;;;OAUG;IACM,mCAAO,GAAhB,UACE,MAAgC,EAChC,aAGC,EACD,SAAiB;QAEjB,OAAO,0BAA0B,CAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,EACxB,MAAM,EACN,aAAa,EACb,SAAS,CACV,CAAA;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,kCAAM,GAAN,UAAO,IAAgB,EAAE,EAAgB;QACvC,IAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QAC/C,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,wBACnC,KAAK,CAAC,MAAM,KACf,OAAO,EAAE,KAAK,CAAC,OAAO,IACtB,CAAA;IACJ,CAAC;IAED;;;;;;;;OAQG;IACO,wCAAY,GAAtB,UAAuB,IAAgB;QACrC,KAAK,IAAI,CAAA;QACT,MAAM,IAAI,KAAK,CACb,6DAA6D,CAC9D,CAAA;IACH,CAAC;IAcD;;;;;OAKG;IACO,uCAAW,GAArB,UAAsB,IAAgB;QACpC,OAAO,IAAI,aAAa,CAAC;YACvB,EAAE,EAAE,IAAI,CAAC,QAAQ;YACjB,KAAK,EAAE,iBAAiB;YACxB,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;YACpC,UAAU,EAAE,IAAI;SACjB,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;;OAQG;IACO,2CAAe,GAAzB,UAA0B,IAAgB;;QACxC,OAAO,MAAA,IAAI,CAAC,cAAc,mCAAI,IAAI,CAAC,iBAAiB,CAAA;IACtD,CAAC;IACH,wBAAC;AAAD,CAAC,AArJD,CACU,iBAAiB,GAoJ1B"}

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

@@ -0,0 +1,15 @@
+import type { AcApMeasurementRecord } from '../AcApMeasurementTypes';
+import type { AcApMeasureEntity } from './AcApMeasureEntity';
+/**
+ * Creates a concrete measure entity from a sidecar / store record (deserialize).
+ *
+ * Pair with {@link AcApMeasureEntity.toRecord} for the serialize half of the
+ * overlay persistence protocol. Deserializes the record's style and dispatches
+ * on `geometry.type` to the matching entity constructor (`distance`, `angle`,
+ * `area`, `arc`, or `point`).
+ *
+ * @param record - Persisted measurement record to rehydrate
+ * @returns Measure entity ready for {@link AcApMeasureEntity.commit}
+ */
+export declare function createMeasureEntityFromRecord(record: AcApMeasurementRecord): AcApMeasureEntity;
+//# sourceMappingURL=AcApMeasureEntityFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcApMeasureEntityFactory.d.ts","sourceRoot":"","sources":["../../../../src/command/measure/entity/AcApMeasureEntityFactory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAKpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAG5D;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,qBAAqB,GAC5B,iBAAiB,CAoCnB"}

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

@@ -0,0 +1,35 @@
+import { deserializeMeasurementStyle } from '../AcApMeasurementSidecar';
+import { AcApMeasureAngleEntity } from './AcApMeasureAngleEntity';
+import { AcApMeasureArcEntity } from './AcApMeasureArcEntity';
+import { AcApMeasureAreaEntity } from './AcApMeasureAreaEntity';
+import { AcApMeasureDistanceEntity } from './AcApMeasureDistanceEntity';
+import { AcApMeasurePointEntity } from './AcApMeasurePointEntity';
+/**
+ * Creates a concrete measure entity from a sidecar / store record (deserialize).
+ *
+ * Pair with {@link AcApMeasureEntity.toRecord} for the serialize half of the
+ * overlay persistence protocol. Deserializes the record's style and dispatches
+ * on `geometry.type` to the matching entity constructor (`distance`, `angle`,
+ * `area`, `arc`, or `point`).
+ *
+ * @param record - Persisted measurement record to rehydrate
+ * @returns Measure entity ready for {@link AcApMeasureEntity.commit}
+ */
+export function createMeasureEntityFromRecord(record) {
+    var style = deserializeMeasurementStyle(record.style);
+    var options = { id: record.id, layoutId: record.layoutId, style: style };
+    var geom = record.geometry;
+    switch (geom.type) {
+        case 'distance':
+            return new AcApMeasureDistanceEntity({ x: geom.start.x, y: geom.start.y, z: 0 }, { x: geom.end.x, y: geom.end.y, z: 0 }, options);
+        case 'angle':
+            return new AcApMeasureAngleEntity({ x: geom.vertex.x, y: geom.vertex.y, z: 0 }, { x: geom.arm1.x, y: geom.arm1.y, z: 0 }, { x: geom.arm2.x, y: geom.arm2.y, z: 0 }, options);
+        case 'area':
+            return new AcApMeasureAreaEntity(geom.points.map(function (p) { return ({ x: p.x, y: p.y, z: 0 }); }), options);
+        case 'arc':
+            return new AcApMeasureArcEntity({ cx: geom.center.x, cy: geom.center.y, r: geom.radius }, geom.start, geom.end, options);
+        case 'point':
+            return new AcApMeasurePointEntity({ x: geom.position.x, y: geom.position.y, z: 0 }, options);
+    }
+}
+//# sourceMappingURL=AcApMeasureEntityFactory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcApMeasureEntityFactory.js","sourceRoot":"","sources":["../../../../src/command/measure/entity/AcApMeasureEntityFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAA;AAEvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAEvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AAEjE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,6BAA6B,CAC3C,MAA6B;IAE7B,IAAM,KAAK,GAAG,2BAA2B,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACvD,IAAM,OAAO,GAAG,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,OAAA,EAAE,CAAA;IACnE,IAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAA;IAC5B,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,UAAU;YACb,OAAO,IAAI,yBAAyB,CAClC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAC1C,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EACtC,OAAO,CACR,CAAA;QACH,KAAK,OAAO;YACV,OAAO,IAAI,sBAAsB,CAC/B,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAC5C,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EACxC,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EACxC,OAAO,CACR,CAAA;QACH,KAAK,MAAM;YACT,OAAO,IAAI,qBAAqB,CAC9B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAA1B,CAA0B,CAAC,EAChD,OAAO,CACR,CAAA;QACH,KAAK,KAAK;YACR,OAAO,IAAI,oBAAoB,CAC7B,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,EACxD,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,GAAG,EACR,OAAO,CACR,CAAA;QACH,KAAK,OAAO;YACV,OAAO,IAAI,sBAAsB,CAC/B,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAChD,OAAO,CACR,CAAA;IACL,CAAC;AACH,CAAC"}