@mlightcad/cad-simple-viewer 1.5.10 → 1.6.0

package/lib/command/overlay/AcApHtmlLivePreview.d.ts

@@ -0,0 +1,121 @@
+/**
+ * HTML-only live preview stroke for markup / measure jigs.
+ *
+ * Uses {@link AcTrHtmlCanvasOverlay} on a live layer; never adds AcDb entities.
+ * Updates set {@link AcTrView2d.isHtmlDirty} only (not {@link AcTrView2d.isDirty}),
+ * so jig rubber-bands no longer force a WebGL redraw.
+ */
+import type { AcCmColor } from '@mlightcad/data-model';
+import type { AcTrView2d } from '../../view';
+/** World-space 2D point for live preview strokes. */
+export interface AcApHtmlLivePoint {
+    /** World X. */
+    x: number;
+    /** World Y. */
+    y: number;
+}
+/**
+ * Drawable content for one live-preview frame.
+ */
+export type AcApHtmlLiveDrawFn = (ctx: CanvasRenderingContext2D, view: AcTrView2d) => void;
+/**
+ * Full-viewport HTML canvas used as a jig rubber-band / shape preview.
+ */
+export declare class AcApHtmlLivePreview {
+    /** Host view. */
+    private readonly view;
+    /** Screen-space canvas overlay on the live layer. */
+    private readonly overlay;
+    /** Current frame drawer; `null` clears the canvas. */
+    private drawFn;
+    /** Bound viewChanged listener. */
+    private readonly onViewChanged;
+    /**
+     * @param view - Active 2D view.
+     * @param id - Unique overlay id.
+     * @param layer - HTML transient live layer name.
+     */
+    constructor(view: AcTrView2d, id: string, layer: string);
+    /** Overlay id (for manager remove). */
+    get id(): string;
+    /**
+     * Replace the draw callback and immediately paint.
+     *
+     * Marks {@link AcTrView2d.isHtmlDirty} so CSS2D siblings (badges / dots)
+     * updated in the same jig tick are reprojected. Canvas strokes themselves
+     * are painted synchronously and do not need a WebGL pass.
+     *
+     * @param drawFn - Frame drawer, or `null` to clear.
+     */
+    acapSetDraw(drawFn: AcApHtmlLiveDrawFn | null): void;
+    /** Clear the canvas without disposing the overlay. */
+    acapClear(): void;
+    /**
+     * Remove overlay and viewChanged listener.
+     *
+     * Sets {@link AcTrView2d.isHtmlDirty} so CSS2D can drop related live badges.
+     */
+    acapDispose(): void;
+    /** Paint the current frame onto the overlay canvas. */
+    private acapPaint;
+}
+/**
+ * Stroke a world-space segment in screen space.
+ *
+ * @param ctx - Canvas context in CSS pixels.
+ * @param view - View for world → screen.
+ * @param a - Segment start (world).
+ * @param b - Segment end (world).
+ * @param color - CSS or AcCmColor stroke color.
+ * @param lineWidth - Stroke width in CSS pixels.
+ * @param options - Optional dash pattern and arrow head at `b`.
+ */
+export declare function acapStrokeLiveSegment(ctx: CanvasRenderingContext2D, view: AcTrView2d, a: AcApHtmlLivePoint, b: AcApHtmlLivePoint, color: string | AcCmColor, lineWidth: number, options?: {
+    dashed?: boolean;
+    arrow?: boolean;
+}): void;
+/**
+ * Stroke a world-space closed polyline (screen projection).
+ *
+ * @param ctx - Canvas context in CSS pixels.
+ * @param view - View for world → screen.
+ * @param points - World vertices in order.
+ * @param color - CSS or AcCmColor stroke color.
+ * @param lineWidth - Stroke width in CSS pixels.
+ * @param options - Optional dash / closePath.
+ */
+export declare function acapStrokeLivePolyline(ctx: CanvasRenderingContext2D, view: AcTrView2d, points: AcApHtmlLivePoint[], color: string | AcCmColor, lineWidth: number, options?: {
+    dashed?: boolean;
+    closed?: boolean;
+}): void;
+/**
+ * Stroke a world-space circle as a screen-space arc.
+ *
+ * @param ctx - Canvas context in CSS pixels.
+ * @param view - View for world → screen.
+ * @param center - Circle center (world).
+ * @param radius - Circle radius (world).
+ * @param color - CSS or AcCmColor stroke color.
+ * @param lineWidth - Stroke width in CSS pixels.
+ */
+export declare function acapStrokeLiveCircle(ctx: CanvasRenderingContext2D, view: AcTrView2d, center: AcApHtmlLivePoint, radius: number, color: string | AcCmColor, lineWidth: number): void;
+/**
+ * Draw a highlight rectangle preview (matches committed highlight look).
+ *
+ * @param ctx - Canvas context in CSS pixels.
+ * @param view - View for world → screen.
+ * @param corner1 - One corner (world).
+ * @param corner2 - Opposite corner (world).
+ * @param color - CSS color string.
+ * @param lineWidth - Outline width in CSS pixels.
+ */
+export declare function acapFillLiveHighlight(ctx: CanvasRenderingContext2D, view: AcTrView2d, corner1: AcApHtmlLivePoint, corner2: AcApHtmlLivePoint, color: string, lineWidth: number): void;
+/**
+ * Axis-aligned rectangle corners as a closed polyline (world).
+ *
+ * @param first - One corner.
+ * @param second - Opposite corner.
+ * @returns Four corners in clockwise order from `first`'s x/y mix.
+ */
+export declare function acapLiveRectCorners(first: AcApHtmlLivePoint, second: AcApHtmlLivePoint): AcApHtmlLivePoint[];
+//# sourceMappingURL=AcApHtmlLivePreview.d.ts.map

package/lib/command/overlay/AcApHtmlLivePreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApHtmlLivePreview.d.ts","sourceRoot":"","sources":["../../../src/command/overlay/AcApHtmlLivePreview.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAItD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAO5C,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC,eAAe;IACf,CAAC,EAAE,MAAM,CAAA;IACT,eAAe;IACf,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,UAAU,KACb,IAAI,CAAA;AAET;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,iBAAiB;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,sDAAsD;IACtD,OAAO,CAAC,MAAM,CAAkC;IAChD,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IAEvD;;;;OAIG;gBACS,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAYvD,uCAAuC;IACvC,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;;;;;;;OAQG;IACH,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI;IAMpD,sDAAsD;IACtD,SAAS,IAAI,IAAI;IAIjB;;;;OAIG;IACH,WAAW,IAAI,IAAI;IAMnB,uDAAuD;IACvD,OAAO,CAAC,SAAS;CAKlB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,UAAU,EAChB,CAAC,EAAE,iBAAiB,EACpB,CAAC,EAAE,iBAAiB,EACpB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9C,IAAI,CAeN;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,iBAAiB,EAAE,EAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/C,IAAI,CAeN;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,SAAS,EAAE,MAAM,GAChB,IAAI,CAWN;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,IAAI,CAQN;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,iBAAiB,GACxB,iBAAiB,EAAE,CAOrB"}

package/lib/command/overlay/AcApHtmlLivePreview.js

@@ -0,0 +1,193 @@
+/**
+ * HTML-only live preview stroke for markup / measure jigs.
+ *
+ * Uses {@link AcTrHtmlCanvasOverlay} on a live layer; never adds AcDb entities.
+ * Updates set {@link AcTrView2d.isHtmlDirty} only (not {@link AcTrView2d.isDirty}),
+ * so jig rubber-bands no longer force a WebGL redraw.
+ */
+import { AcTrHtmlCanvasOverlay } from '@mlightcad/three-renderer';
+import { acapCssColor } from '../../util';
+import { acapDrawOverlayArrowHead, acapDrawOverlayHighlight, acapFitOverlayCanvas } from './AcApOverlayDrawUtil';
+/**
+ * Full-viewport HTML canvas used as a jig rubber-band / shape preview.
+ */
+var AcApHtmlLivePreview = /** @class */ (function () {
+    /**
+     * @param view - Active 2D view.
+     * @param id - Unique overlay id.
+     * @param layer - HTML transient live layer name.
+     */
+    function AcApHtmlLivePreview(view, id, layer) {
+        var _this = this;
+        /** Current frame drawer; `null` clears the canvas. */
+        this.drawFn = null;
+        /** Bound viewChanged listener. */
+        this.onViewChanged = function () { return _this.acapPaint(); };
+        this.view = view;
+        this.overlay = new AcTrHtmlCanvasOverlay({
+            id: id,
+            container: view.container,
+            layer: layer,
+            layoutId: view.activeLayoutBtrId
+        });
+        view.htmlTransientManager.add(this.overlay);
+        view.events.viewChanged.addEventListener(this.onViewChanged);
+    }
+    Object.defineProperty(AcApHtmlLivePreview.prototype, "id", {
+        /** Overlay id (for manager remove). */
+        get: function () {
+            return this.overlay.id;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Replace the draw callback and immediately paint.
+     *
+     * Marks {@link AcTrView2d.isHtmlDirty} so CSS2D siblings (badges / dots)
+     * updated in the same jig tick are reprojected. Canvas strokes themselves
+     * are painted synchronously and do not need a WebGL pass.
+     *
+     * @param drawFn - Frame drawer, or `null` to clear.
+     */
+    AcApHtmlLivePreview.prototype.acapSetDraw = function (drawFn) {
+        this.drawFn = drawFn;
+        this.acapPaint();
+        this.view.isHtmlDirty = true;
+    };
+    /** Clear the canvas without disposing the overlay. */
+    AcApHtmlLivePreview.prototype.acapClear = function () {
+        this.acapSetDraw(null);
+    };
+    /**
+     * Remove overlay and viewChanged listener.
+     *
+     * Sets {@link AcTrView2d.isHtmlDirty} so CSS2D can drop related live badges.
+     */
+    AcApHtmlLivePreview.prototype.acapDispose = function () {
+        this.view.events.viewChanged.removeEventListener(this.onViewChanged);
+        this.view.htmlTransientManager.remove(this.overlay.id);
+        this.view.isHtmlDirty = true;
+    };
+    /** Paint the current frame onto the overlay canvas. */
+    AcApHtmlLivePreview.prototype.acapPaint = function () {
+        var _a;
+        var ctx = acapFitOverlayCanvas(this.overlay.canvas, this.view.container);
+        if (!ctx)
+            return;
+        (_a = this.drawFn) === null || _a === void 0 ? void 0 : _a.call(this, ctx, this.view);
+    };
+    return AcApHtmlLivePreview;
+}());
+export { AcApHtmlLivePreview };
+/**
+ * Stroke a world-space segment in screen space.
+ *
+ * @param ctx - Canvas context in CSS pixels.
+ * @param view - View for world → screen.
+ * @param a - Segment start (world).
+ * @param b - Segment end (world).
+ * @param color - CSS or AcCmColor stroke color.
+ * @param lineWidth - Stroke width in CSS pixels.
+ * @param options - Optional dash pattern and arrow head at `b`.
+ */
+export function acapStrokeLiveSegment(ctx, view, a, b, color, lineWidth, options) {
+    var css = typeof color === 'string' ? color : acapCssColor(color);
+    var sa = view.worldToScreen(a);
+    var sb = view.worldToScreen(b);
+    ctx.strokeStyle = css;
+    ctx.lineWidth = lineWidth;
+    if (options === null || options === void 0 ? void 0 : options.dashed)
+        ctx.setLineDash([8, 5]);
+    ctx.beginPath();
+    ctx.moveTo(sa.x, sa.y);
+    ctx.lineTo(sb.x, sb.y);
+    ctx.stroke();
+    if (options === null || options === void 0 ? void 0 : options.dashed)
+        ctx.setLineDash([]);
+    if (options === null || options === void 0 ? void 0 : options.arrow) {
+        acapDrawOverlayArrowHead(ctx, sa, sb, css);
+    }
+}
+/**
+ * Stroke a world-space closed polyline (screen projection).
+ *
+ * @param ctx - Canvas context in CSS pixels.
+ * @param view - View for world → screen.
+ * @param points - World vertices in order.
+ * @param color - CSS or AcCmColor stroke color.
+ * @param lineWidth - Stroke width in CSS pixels.
+ * @param options - Optional dash / closePath.
+ */
+export function acapStrokeLivePolyline(ctx, view, points, color, lineWidth, options) {
+    if (points.length < 2)
+        return;
+    var css = typeof color === 'string' ? color : acapCssColor(color);
+    var screen = points.map(function (p) { return view.worldToScreen(p); });
+    ctx.strokeStyle = css;
+    ctx.lineWidth = lineWidth;
+    if (options === null || options === void 0 ? void 0 : options.dashed)
+        ctx.setLineDash([8, 5]);
+    ctx.beginPath();
+    ctx.moveTo(screen[0].x, screen[0].y);
+    for (var i = 1; i < screen.length; i++) {
+        ctx.lineTo(screen[i].x, screen[i].y);
+    }
+    if (options === null || options === void 0 ? void 0 : options.closed)
+        ctx.closePath();
+    ctx.stroke();
+    if (options === null || options === void 0 ? void 0 : options.dashed)
+        ctx.setLineDash([]);
+}
+/**
+ * Stroke a world-space circle as a screen-space arc.
+ *
+ * @param ctx - Canvas context in CSS pixels.
+ * @param view - View for world → screen.
+ * @param center - Circle center (world).
+ * @param radius - Circle radius (world).
+ * @param color - CSS or AcCmColor stroke color.
+ * @param lineWidth - Stroke width in CSS pixels.
+ */
+export function acapStrokeLiveCircle(ctx, view, center, radius, color, lineWidth) {
+    if (radius <= 0)
+        return;
+    var css = typeof color === 'string' ? color : acapCssColor(color);
+    var sc = view.worldToScreen(center);
+    var rim = view.worldToScreen({ x: center.x + radius, y: center.y });
+    var screenR = Math.hypot(rim.x - sc.x, rim.y - sc.y);
+    ctx.strokeStyle = css;
+    ctx.lineWidth = lineWidth;
+    ctx.beginPath();
+    ctx.arc(sc.x, sc.y, screenR, 0, Math.PI * 2);
+    ctx.stroke();
+}
+/**
+ * Draw a highlight rectangle preview (matches committed highlight look).
+ *
+ * @param ctx - Canvas context in CSS pixels.
+ * @param view - View for world → screen.
+ * @param corner1 - One corner (world).
+ * @param corner2 - Opposite corner (world).
+ * @param color - CSS color string.
+ * @param lineWidth - Outline width in CSS pixels.
+ */
+export function acapFillLiveHighlight(ctx, view, corner1, corner2, color, lineWidth) {
+    acapDrawOverlayHighlight(ctx, view.worldToScreen(corner1), view.worldToScreen(corner2), color, lineWidth);
+}
+/**
+ * Axis-aligned rectangle corners as a closed polyline (world).
+ *
+ * @param first - One corner.
+ * @param second - Opposite corner.
+ * @returns Four corners in clockwise order from `first`'s x/y mix.
+ */
+export function acapLiveRectCorners(first, second) {
+    return [
+        { x: first.x, y: first.y },
+        { x: second.x, y: first.y },
+        { x: second.x, y: second.y },
+        { x: first.x, y: second.y }
+    ];
+}
+//# sourceMappingURL=AcApHtmlLivePreview.js.map

package/lib/command/overlay/AcApHtmlLivePreview.js.map

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

package/lib/command/overlay/AcApOverlayDrawUtil.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Shared canvas helpers for markup / measure overlay drawing.
+ */
+/**
+ * Fit a canvas to its container and return a 2D context cleared for this frame.
+ *
+ * Resizes CSS and buffer dimensions (honoring devicePixelRatio) only when they
+ * change, then clears the viewport in CSS pixel space.
+ *
+ * @param canvas - Target canvas element owned by an overlay.
+ * @param container - View container used for size measurement.
+ * @returns A 2D context ready to draw, or `null` if unavailable.
+ */
+export declare function acapFitOverlayCanvas(canvas: HTMLCanvasElement, container: HTMLElement): CanvasRenderingContext2D | null;
+/**
+ * Draw a filled arrow head at `to`, pointing along `from` → `to`.
+ *
+ * @param ctx - Canvas 2D context (CSS pixel space).
+ * @param from - Tail / direction reference in screen space.
+ * @param to - Arrow tip in screen space.
+ * @param color - CSS fill color.
+ */
+export declare function acapDrawOverlayArrowHead(ctx: CanvasRenderingContext2D, from: {
+    x: number;
+    y: number;
+}, to: {
+    x: number;
+    y: number;
+}, color: string): void;
+/**
+ * Draw a leader segment, optionally with an arrow head at the tip.
+ *
+ * @param ctx - Canvas 2D context (CSS pixel space).
+ * @param tip - Leader tip (arrow end when `withArrow` is true).
+ * @param anchor - Bubble / opposite end of the leader.
+ * @param color - CSS stroke / fill color.
+ * @param withArrow - When `true`, draws an arrow head at `tip`.
+ * @param lineWidth - Stroke width in CSS pixels.
+ */
+export declare function acapDrawOverlayLeader(ctx: CanvasRenderingContext2D, tip: {
+    x: number;
+    y: number;
+}, anchor: {
+    x: number;
+    y: number;
+}, color: string, withArrow?: boolean, lineWidth?: number): void;
+/**
+ * Draw a translucent highlight rectangle with stroke.
+ *
+ * @param ctx - Canvas 2D context (CSS pixel space).
+ * @param a - One corner of the highlight AABB in screen space.
+ * @param b - Opposite corner of the highlight AABB in screen space.
+ * @param color - CSS fill / stroke color.
+ * @param lineWidth - Outline stroke width in CSS pixels.
+ */
+export declare function acapDrawOverlayHighlight(ctx: CanvasRenderingContext2D, a: {
+    x: number;
+    y: number;
+}, b: {
+    x: number;
+    y: number;
+}, color: string, lineWidth?: number): void;
+//# sourceMappingURL=AcApOverlayDrawUtil.d.ts.map

package/lib/command/overlay/AcApOverlayDrawUtil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApOverlayDrawUtil.d.ts","sourceRoot":"","sources":["../../../src/command/overlay/AcApOverlayDrawUtil.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,WAAW,GACrB,wBAAwB,GAAG,IAAI,CAkBjC;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9B,EAAE,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5B,KAAK,EAAE,MAAM,GACZ,IAAI,CAsBN;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7B,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAChC,KAAK,EAAE,MAAM,EACb,SAAS,UAAO,EAChB,SAAS,SAAI,GACZ,IAAI,CAUN;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,wBAAwB,EAC7B,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3B,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3B,KAAK,EAAE,MAAM,EACb,SAAS,SAAM,GACd,IAAI,CAYN"}

package/lib/command/overlay/AcApOverlayDrawUtil.js

@@ -0,0 +1,115 @@
+/**
+ * Shared canvas helpers for markup / measure overlay drawing.
+ */
+/**
+ * Fit a canvas to its container and return a 2D context cleared for this frame.
+ *
+ * Resizes CSS and buffer dimensions (honoring devicePixelRatio) only when they
+ * change, then clears the viewport in CSS pixel space.
+ *
+ * @param canvas - Target canvas element owned by an overlay.
+ * @param container - View container used for size measurement.
+ * @returns A 2D context ready to draw, or `null` if unavailable.
+ */
+export function acapFitOverlayCanvas(canvas, container) {
+    var rect = container.getBoundingClientRect();
+    var dpr = window.devicePixelRatio || 1;
+    var cssWidth = "".concat(rect.width, "px");
+    var cssHeight = "".concat(rect.height, "px");
+    var bufferWidth = Math.max(1, Math.floor(rect.width * dpr));
+    var bufferHeight = Math.max(1, Math.floor(rect.height * dpr));
+    canvas.style.left = '0';
+    canvas.style.top = '0';
+    if (canvas.style.width !== cssWidth)
+        canvas.style.width = cssWidth;
+    if (canvas.style.height !== cssHeight)
+        canvas.style.height = cssHeight;
+    if (canvas.width !== bufferWidth)
+        canvas.width = bufferWidth;
+    if (canvas.height !== bufferHeight)
+        canvas.height = bufferHeight;
+    var ctx = canvas.getContext('2d');
+    if (!ctx)
+        return null;
+    ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
+    ctx.clearRect(0, 0, rect.width, rect.height);
+    return ctx;
+}
+/**
+ * Draw a filled arrow head at `to`, pointing along `from` → `to`.
+ *
+ * @param ctx - Canvas 2D context (CSS pixel space).
+ * @param from - Tail / direction reference in screen space.
+ * @param to - Arrow tip in screen space.
+ * @param color - CSS fill color.
+ */
+export function acapDrawOverlayArrowHead(ctx, from, to, color) {
+    var dx = to.x - from.x;
+    var dy = to.y - from.y;
+    var len = Math.hypot(dx, dy) || 1;
+    var ux = dx / len;
+    var uy = dy / len;
+    var size = 12;
+    var left = {
+        x: to.x - ux * size - uy * size * 0.45,
+        y: to.y - uy * size + ux * size * 0.45
+    };
+    var right = {
+        x: to.x - ux * size + uy * size * 0.45,
+        y: to.y - uy * size - ux * size * 0.45
+    };
+    ctx.fillStyle = color;
+    ctx.beginPath();
+    ctx.moveTo(to.x, to.y);
+    ctx.lineTo(left.x, left.y);
+    ctx.lineTo(right.x, right.y);
+    ctx.closePath();
+    ctx.fill();
+}
+/**
+ * Draw a leader segment, optionally with an arrow head at the tip.
+ *
+ * @param ctx - Canvas 2D context (CSS pixel space).
+ * @param tip - Leader tip (arrow end when `withArrow` is true).
+ * @param anchor - Bubble / opposite end of the leader.
+ * @param color - CSS stroke / fill color.
+ * @param withArrow - When `true`, draws an arrow head at `tip`.
+ * @param lineWidth - Stroke width in CSS pixels.
+ */
+export function acapDrawOverlayLeader(ctx, tip, anchor, color, withArrow, lineWidth) {
+    if (withArrow === void 0) { withArrow = true; }
+    if (lineWidth === void 0) { lineWidth = 2; }
+    ctx.strokeStyle = color;
+    ctx.lineWidth = lineWidth;
+    ctx.beginPath();
+    ctx.moveTo(tip.x, tip.y);
+    ctx.lineTo(anchor.x, anchor.y);
+    ctx.stroke();
+    if (withArrow) {
+        acapDrawOverlayArrowHead(ctx, anchor, tip, color);
+    }
+}
+/**
+ * Draw a translucent highlight rectangle with stroke.
+ *
+ * @param ctx - Canvas 2D context (CSS pixel space).
+ * @param a - One corner of the highlight AABB in screen space.
+ * @param b - Opposite corner of the highlight AABB in screen space.
+ * @param color - CSS fill / stroke color.
+ * @param lineWidth - Outline stroke width in CSS pixels.
+ */
+export function acapDrawOverlayHighlight(ctx, a, b, color, lineWidth) {
+    if (lineWidth === void 0) { lineWidth = 1.5; }
+    var x = Math.min(a.x, b.x);
+    var y = Math.min(a.y, b.y);
+    var w = Math.abs(a.x - b.x);
+    var h = Math.abs(a.y - b.y);
+    ctx.fillStyle = color;
+    ctx.globalAlpha = 0.28;
+    ctx.fillRect(x, y, w, h);
+    ctx.globalAlpha = 1;
+    ctx.strokeStyle = color;
+    ctx.lineWidth = lineWidth;
+    ctx.strokeRect(x, y, w, h);
+}
+//# sourceMappingURL=AcApOverlayDrawUtil.js.map

package/lib/command/overlay/AcApOverlayDrawUtil.js.map

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

package/lib/command/overlay/AcApOverlayEntity.d.ts

@@ -0,0 +1,93 @@
+import type { AcDbObjectId, AcGePoint3d, AcGePoint3dLike, AcGeVector3dLike } from '@mlightcad/data-model';
+import type { AcTrHtmlGroup } from '@mlightcad/three-renderer';
+import type { AcTrView2d } from '../../view';
+/**
+ * Result of building one overlay's visuals (HTML group + optional CAD extras).
+ *
+ * The framework publishes the group and wires selection; the entity owns
+ * {@link dispose} and optional deferred {@link bindGrips}.
+ */
+export interface AcApOverlayWorldDrawResult {
+    /** Selectable HTML group that owns leaf overlays and canvases. */
+    group: AcTrHtmlGroup;
+    /** CAD transient entity ids owned by this overlay (for highlight / visibility). */
+    entityIds: AcDbObjectId[];
+    /** Tear down listeners and non-HTML resources; HTML is disposed with the group. */
+    dispose: () => void;
+    /**
+     * Bind grip pointer handlers after the group is added to the HTML transient
+     * manager (avoids racing manager attach).
+     */
+    bindGrips?: () => void;
+}
+/**
+ * Domain overlay entity protocol (markup / measure), analogous to AcDbEntity
+ * template methods — not an {@link AcTrHtmlElement} subclass.
+ *
+ * Leaves such as Dot / Badge / Callout remain render primitives; concrete
+ * overlay types compose them inside {@link subWorldDraw}.
+ *
+ * Persistable overlays also implement
+ * {@link import('./AcApOverlaySerializable').AcApOverlaySerializable} with a
+ * domain record type; deserialize via domain factories, not this base class.
+ */
+export declare abstract class AcApOverlayEntity {
+    /**
+     * Stable overlay identifier used as the HTML group id and store key.
+     */
+    abstract get id(): string;
+    /**
+     * Framework entry: builds visuals via {@link subWorldDraw}.
+     * Subclasses should override {@link subWorldDraw}, not this method.
+     *
+     * @param view - Active 2D view that hosts HTML / CAD transients.
+     * @returns Built group, entity ids, and cleanup hooks.
+     */
+    worldDraw(view: AcTrView2d): AcApOverlayWorldDrawResult;
+    /**
+     * Emit HTML + CAD + canvas visuals for this overlay.
+     *
+     * @param view - Active 2D view that hosts HTML / CAD transients.
+     * @returns Built group, entity ids, and cleanup hooks.
+     */
+    protected abstract subWorldDraw(view: AcTrView2d): AcApOverlayWorldDrawResult;
+    /**
+     * Grip points in WCS.
+     *
+     * @returns Grip locations; empty array means no move grips.
+     */
+    subGetGripPoints(): AcGePoint3d[];
+    /**
+     * Apply a grip edit. Default is a no-op; subclasses mutate internal geometry.
+     *
+     * @param _indices - Zero-based grip indices to move.
+     * @param _offset - World-space translation applied to each selected grip.
+     * @returns This entity for chaining.
+     */
+    subMoveGripPointsAt(_indices: number[], _offset: AcGeVector3dLike): this;
+    /**
+     * Screen-space stroke / fill hit test (not HTML capsules).
+     *
+     * @param _canvas - Pick location in canvas / CSS pixel space.
+     * @param _worldToScreen - Converts a world XY point to canvas space.
+     * @param _threshold - Hit slop in pixels.
+     * @returns `true` when the canvas pick hits this overlay's drawn geometry.
+     */
+    hitTest(_canvas: {
+        x: number;
+        y: number;
+    }, _worldToScreen: (point: {
+        x: number;
+        y: number;
+    }) => {
+        x: number;
+        y: number;
+    }, _threshold: number): boolean;
+    /**
+     * Primary world point for focus / zoom.
+     *
+     * @returns Anchor point, or `undefined` when the overlay has no focus point.
+     */
+    primaryPoint(): AcGePoint3dLike | undefined;
+}
+//# sourceMappingURL=AcApOverlayEntity.d.ts.map

package/lib/command/overlay/AcApOverlayEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApOverlayEntity.d.ts","sourceRoot":"","sources":["../../../src/command/overlay/AcApOverlayEntity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,gBAAgB,EACjB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,kEAAkE;IAClE,KAAK,EAAE,aAAa,CAAA;IACpB,mFAAmF;IACnF,SAAS,EAAE,YAAY,EAAE,CAAA;IACzB,mFAAmF;IACnF,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AAED;;;;;;;;;;GAUG;AACH,8BAAsB,iBAAiB;IACrC;;OAEG;IACH,QAAQ,KAAK,EAAE,IAAI,MAAM,CAAA;IAEzB;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,0BAA0B;IAIvD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,CAC7B,IAAI,EAAE,UAAU,GACf,0BAA0B;IAE7B;;;;OAIG;IACH,gBAAgB,IAAI,WAAW,EAAE;IAIjC;;;;;;OAMG;IACH,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,gBAAgB,GACxB,IAAI;IAIP;;;;;;;OAOG;IACH,OAAO,CACL,OAAO,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EACjC,cAAc,EAAE,CAAC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAC7E,UAAU,EAAE,MAAM,GACjB,OAAO;IAIV;;;;OAIG;IACH,YAAY,IAAI,eAAe,GAAG,SAAS;CAG5C"}