@mlightcad/cad-simple-viewer 1.6.3 → 1.7.1

package/lib/editor/input/ui/AcEdSnapLoupe.d.ts

@@ -0,0 +1,60 @@
+import { AcGeBox2d } from '@mlightcad/data-model';
+import { AcEdBaseView } from '../../view';
+import { AcEdMarkerType } from '../marker/AcEdMarker';
+export { ACED_SNAP_LOUPE_GAP_BELOW_PROMPT_PX, ACED_SNAP_LOUPE_INSET_PX, ACED_SNAP_LOUPE_SIZE_PX, ACED_SNAP_LOUPE_ZOOM, acedLoupeLocalFromCanvasDelta, acedResolveLoupePlacement } from './AcEdSnapLoupeMath';
+/**
+ * DOM chrome for the mobile snap loupe: border and OSNAP glyph.
+ *
+ * CAD geometry is drawn by the view's overlay viewport; this widget only
+ * drives that viewport and paints HUD on top.
+ */
+export declare class AcEdSnapLoupe {
+    /** Whether the loupe stylesheet has been injected into `document.head`. */
+    private static stylesInjected;
+    /** View whose overlay viewport shows the magnified CAD content. */
+    private readonly view;
+    /** Root HUD element (border), positioned over the overlay. */
+    private readonly root;
+    /** OSNAP glyph drawn inside the loupe when a snap is active. */
+    private readonly marker;
+    /**
+     * Creates the loupe HUD and attaches it to the view container.
+     *
+     * @param view - View that owns the overlay viewport and coordinate helpers.
+     */
+    constructor(view: AcEdBaseView);
+    /**
+     * Shows the loupe at the canvas-local sample and updates the overlay viewport.
+     *
+     * @param canvasX - Sample X in canvas CSS pixels.
+     * @param canvasY - Sample Y in canvas CSS pixels.
+     * @param snapCanvas - Snapped point in canvas CSS pixels, if any.
+     * @param snapType - OSNAP marker shape when snapped.
+     */
+    show(canvasX: number, canvasY: number, snapCanvas?: {
+        x: number;
+        y: number;
+    }, snapType?: AcEdMarkerType): void;
+    /**
+     * Hides the HUD and the overlay viewport.
+     */
+    hide(): void;
+    /**
+     * Hides the loupe and removes its DOM from the view container.
+     */
+    dispose(): void;
+    /**
+     * Injects loupe HUD styles into `document.head` once per page.
+     */
+    private static injectCss;
+}
+/**
+ * World box around a canvas sample that fills the loupe at {@link ACED_SNAP_LOUPE_ZOOM}.
+ *
+ * @param view - View used to convert canvas samples to world coordinates.
+ * @param canvasX - Sample X in canvas CSS pixels (loupe center).
+ * @param canvasY - Sample Y in canvas CSS pixels (loupe center).
+ * @returns Axis-aligned world box mapped onto the square loupe.
+ */
+export declare function acedLoupeViewBoxFromCanvasSample(view: AcEdBaseView, canvasX: number, canvasY: number): AcGeBox2d;
+//# sourceMappingURL=AcEdSnapLoupe.d.ts.map

package/lib/editor/input/ui/AcEdSnapLoupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdSnapLoupe.d.ts","sourceRoot":"","sources":["../../../../src/editor/input/ui/AcEdSnapLoupe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,MAAM,uBAAuB,CAAA;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAc,cAAc,EAAE,MAAM,sBAAsB,CAAA;AASjE,OAAO,EACL,mCAAmC,EACnC,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,6BAA6B,EAC7B,yBAAyB,EAC1B,MAAM,qBAAqB,CAAA;AAE5B;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,2EAA2E;IAC3E,OAAO,CAAC,MAAM,CAAC,cAAc,CAAQ;IAErC,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IAEnC;;;;OAIG;gBACS,IAAI,EAAE,YAAY;IAoB9B;;;;;;;OAOG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EACrC,QAAQ,CAAC,EAAE,cAAc;IAwB3B;;OAEG;IACH,IAAI;IAMJ;;OAEG;IACH,OAAO;IAMP;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;CAqBzB;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,SAAS,CAQX"}

package/lib/editor/input/ui/AcEdSnapLoupe.js

@@ -0,0 +1,109 @@
+import { AcGeBox2d, AcGePoint2d } from '@mlightcad/data-model';
+import { AcEdMarker } from '../marker/AcEdMarker';
+import { acedInteractionStrategy } from './AcEdInteractionStrategy';
+import { ACED_SNAP_LOUPE_SIZE_PX, ACED_SNAP_LOUPE_ZOOM, acedLoupeLocalFromCanvasDelta, acedResolveLoupePlacement } from './AcEdSnapLoupeMath';
+export { ACED_SNAP_LOUPE_GAP_BELOW_PROMPT_PX, ACED_SNAP_LOUPE_INSET_PX, ACED_SNAP_LOUPE_SIZE_PX, ACED_SNAP_LOUPE_ZOOM, acedLoupeLocalFromCanvasDelta, acedResolveLoupePlacement } from './AcEdSnapLoupeMath';
+/**
+ * DOM chrome for the mobile snap loupe: border and OSNAP glyph.
+ *
+ * CAD geometry is drawn by the view's overlay viewport; this widget only
+ * drives that viewport and paints HUD on top.
+ */
+var AcEdSnapLoupe = /** @class */ (function () {
+    /**
+     * Creates the loupe HUD and attaches it to the view container.
+     *
+     * @param view - View that owns the overlay viewport and coordinate helpers.
+     */
+    function AcEdSnapLoupe(view) {
+        this.view = view;
+        AcEdSnapLoupe.injectCss();
+        this.root = document.createElement('div');
+        this.root.className = 'ml-snap-loupe';
+        this.root.setAttribute('aria-hidden', 'true');
+        var hostPosition = getComputedStyle(view.container).position;
+        if (hostPosition === 'static') {
+            view.container.style.position = 'relative';
+        }
+        view.container.appendChild(this.root);
+        this.marker = new AcEdMarker('rect', 12, 'var(--ml-ui-canvas-line, green)', this.root);
+        this.hide();
+    }
+    /**
+     * Shows the loupe at the canvas-local sample and updates the overlay viewport.
+     *
+     * @param canvasX - Sample X in canvas CSS pixels.
+     * @param canvasY - Sample Y in canvas CSS pixels.
+     * @param snapCanvas - Snapped point in canvas CSS pixels, if any.
+     * @param snapType - OSNAP marker shape when snapped.
+     */
+    AcEdSnapLoupe.prototype.show = function (canvasX, canvasY, snapCanvas, snapType) {
+        var placement = acedResolveLoupePlacement(this.view.container, {
+            usesSessionChrome: acedInteractionStrategy().point.usesSessionChrome
+        });
+        var inset = placement.x, top = placement.y, size = placement.size;
+        var viewBox = acedLoupeViewBoxFromCanvasSample(this.view, canvasX, canvasY);
+        this.view.setSnapLoupe({ x: inset, y: top, size: size, viewBox: viewBox });
+        var host = this.view.canvasToContainer({ x: inset, y: top });
+        this.root.style.left = "".concat(host.x, "px");
+        this.root.style.top = "".concat(host.y, "px");
+        this.root.style.display = 'block';
+        if (snapCanvas && snapType) {
+            this.marker.type = snapType;
+            this.marker.setPosition(acedLoupeLocalFromCanvasDelta(snapCanvas.x - canvasX, snapCanvas.y - canvasY));
+        }
+        else {
+            this.marker.setPosition({ x: -1000, y: -1000 });
+        }
+    };
+    /**
+     * Hides the HUD and the overlay viewport.
+     */
+    AcEdSnapLoupe.prototype.hide = function () {
+        this.root.style.display = 'none';
+        this.view.setSnapLoupe(null);
+        this.marker.setPosition({ x: -1000, y: -1000 });
+    };
+    /**
+     * Hides the loupe and removes its DOM from the view container.
+     */
+    AcEdSnapLoupe.prototype.dispose = function () {
+        this.hide();
+        this.marker.destroy();
+        this.root.remove();
+    };
+    /**
+     * Injects loupe HUD styles into `document.head` once per page.
+     */
+    AcEdSnapLoupe.injectCss = function () {
+        if (AcEdSnapLoupe.stylesInjected)
+            return;
+        AcEdSnapLoupe.stylesInjected = true;
+        var style = document.createElement('style');
+        style.id = 'ml-snap-loupe-style';
+        style.textContent = "\n      .ml-snap-loupe {\n        position: absolute;\n        width: ".concat(ACED_SNAP_LOUPE_SIZE_PX, "px;\n        height: ").concat(ACED_SNAP_LOUPE_SIZE_PX, "px;\n        box-sizing: border-box;\n        border: 2px solid var(--ml-ui-canvas-line, #0f0);\n        border-radius: 2px;\n        pointer-events: none;\n        z-index: 20;\n        overflow: hidden;\n        box-shadow: 0 2px 8px rgba(0, 0, 0, 0.45);\n      }\n    ");
+        document.head.appendChild(style);
+    };
+    /** Whether the loupe stylesheet has been injected into `document.head`. */
+    AcEdSnapLoupe.stylesInjected = false;
+    return AcEdSnapLoupe;
+}());
+export { AcEdSnapLoupe };
+/**
+ * World box around a canvas sample that fills the loupe at {@link ACED_SNAP_LOUPE_ZOOM}.
+ *
+ * @param view - View used to convert canvas samples to world coordinates.
+ * @param canvasX - Sample X in canvas CSS pixels (loupe center).
+ * @param canvasY - Sample Y in canvas CSS pixels (loupe center).
+ * @returns Axis-aligned world box mapped onto the square loupe.
+ */
+export function acedLoupeViewBoxFromCanvasSample(view, canvasX, canvasY) {
+    var half = ACED_SNAP_LOUPE_SIZE_PX / ACED_SNAP_LOUPE_ZOOM / 2;
+    var p1 = view.screenToWorld({ x: canvasX - half, y: canvasY - half });
+    var p2 = view.screenToWorld({ x: canvasX + half, y: canvasY + half });
+    var box = new AcGeBox2d();
+    box.expandByPoint(new AcGePoint2d(p1.x, p1.y));
+    box.expandByPoint(new AcGePoint2d(p2.x, p2.y));
+    return box;
+}
+//# sourceMappingURL=AcEdSnapLoupe.js.map

package/lib/editor/input/ui/AcEdSnapLoupe.js.map

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

package/lib/editor/input/ui/AcEdSnapLoupeMath.d.ts

@@ -0,0 +1,47 @@
+/** Square loupe size in CSS pixels. */
+export declare const ACED_SNAP_LOUPE_SIZE_PX = 128;
+/** Magnification relative to the main view. */
+export declare const ACED_SNAP_LOUPE_ZOOM = 3;
+/** Offset of the loupe from the canvas top-left. */
+export declare const ACED_SNAP_LOUPE_INSET_PX = 8;
+/**
+ * @deprecated Prompt is no longer a top bar; kept for re-export stability.
+ */
+export declare const ACED_SNAP_LOUPE_GAP_BELOW_PROMPT_PX = 8;
+/**
+ * Resolves the loupe top-left in host-local CSS pixels.
+ *
+ * Session prompts live in the bottom panel, so the loupe stays at the top
+ * inset whether or not session chrome is active.
+ *
+ * @param _host - View / canvas container (unused; kept for call-site stability).
+ * @param _options - Layout hints (unused; kept for call-site stability).
+ * @returns Loupe `x` / `y` / `size` in host-local CSS pixels.
+ */
+export declare function acedResolveLoupePlacement(_host: HTMLElement, _options: {
+    usesSessionChrome: boolean;
+    promptSelector?: string;
+}): {
+    x: number;
+    y: number;
+    size: number;
+};
+/**
+ * Maps a canvas-space delta (snap − finger) into loupe-local pixels.
+ *
+ * The loupe center corresponds to the finger sample; the snap glyph is
+ * offset from that center by `delta * zoom`.
+ *
+ * @param dx - Canvas-space X from finger to snap (CSS pixels).
+ * @param dy - Canvas-space Y from finger to snap (CSS pixels).
+ * @param size - Loupe width/height in CSS pixels; defaults to
+ *   {@link ACED_SNAP_LOUPE_SIZE_PX}.
+ * @param zoom - Magnification relative to the main view; defaults to
+ *   {@link ACED_SNAP_LOUPE_ZOOM}.
+ * @returns Loupe-local coordinates with origin at the loupe top-left.
+ */
+export declare function acedLoupeLocalFromCanvasDelta(dx: number, dy: number, size?: number, zoom?: number): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=AcEdSnapLoupeMath.d.ts.map

package/lib/editor/input/ui/AcEdSnapLoupeMath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdSnapLoupeMath.d.ts","sourceRoot":"","sources":["../../../../src/editor/input/ui/AcEdSnapLoupeMath.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAC1C,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB,IAAI,CAAA;AACrC,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,IAAI,CAAA;AACzC;;GAEG;AACH,eAAO,MAAM,mCAAmC,IAAI,CAAA;AAEpD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE;IACR,iBAAiB,EAAE,OAAO,CAAA;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,GACA;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAMxC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,6BAA6B,CAC3C,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,MAAgC,EACtC,IAAI,GAAE,MAA6B,GAClC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK1B"}

package/lib/editor/input/ui/AcEdSnapLoupeMath.js

@@ -0,0 +1,50 @@
+/** Square loupe size in CSS pixels. */
+export var ACED_SNAP_LOUPE_SIZE_PX = 128;
+/** Magnification relative to the main view. */
+export var ACED_SNAP_LOUPE_ZOOM = 3;
+/** Offset of the loupe from the canvas top-left. */
+export var ACED_SNAP_LOUPE_INSET_PX = 8;
+/**
+ * @deprecated Prompt is no longer a top bar; kept for re-export stability.
+ */
+export var ACED_SNAP_LOUPE_GAP_BELOW_PROMPT_PX = 8;
+/**
+ * Resolves the loupe top-left in host-local CSS pixels.
+ *
+ * Session prompts live in the bottom panel, so the loupe stays at the top
+ * inset whether or not session chrome is active.
+ *
+ * @param _host - View / canvas container (unused; kept for call-site stability).
+ * @param _options - Layout hints (unused; kept for call-site stability).
+ * @returns Loupe `x` / `y` / `size` in host-local CSS pixels.
+ */
+export function acedResolveLoupePlacement(_host, _options) {
+    return {
+        x: ACED_SNAP_LOUPE_INSET_PX,
+        y: ACED_SNAP_LOUPE_INSET_PX,
+        size: ACED_SNAP_LOUPE_SIZE_PX
+    };
+}
+/**
+ * Maps a canvas-space delta (snap − finger) into loupe-local pixels.
+ *
+ * The loupe center corresponds to the finger sample; the snap glyph is
+ * offset from that center by `delta * zoom`.
+ *
+ * @param dx - Canvas-space X from finger to snap (CSS pixels).
+ * @param dy - Canvas-space Y from finger to snap (CSS pixels).
+ * @param size - Loupe width/height in CSS pixels; defaults to
+ *   {@link ACED_SNAP_LOUPE_SIZE_PX}.
+ * @param zoom - Magnification relative to the main view; defaults to
+ *   {@link ACED_SNAP_LOUPE_ZOOM}.
+ * @returns Loupe-local coordinates with origin at the loupe top-left.
+ */
+export function acedLoupeLocalFromCanvasDelta(dx, dy, size, zoom) {
+    if (size === void 0) { size = ACED_SNAP_LOUPE_SIZE_PX; }
+    if (zoom === void 0) { zoom = ACED_SNAP_LOUPE_ZOOM; }
+    return {
+        x: size / 2 + dx * zoom,
+        y: size / 2 + dy * zoom
+    };
+}
+//# sourceMappingURL=AcEdSnapLoupeMath.js.map

package/lib/editor/input/ui/AcEdSnapLoupeMath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdSnapLoupeMath.js","sourceRoot":"","sources":["../../../../src/editor/input/ui/AcEdSnapLoupeMath.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,MAAM,CAAC,IAAM,uBAAuB,GAAG,GAAG,CAAA;AAC1C,+CAA+C;AAC/C,MAAM,CAAC,IAAM,oBAAoB,GAAG,CAAC,CAAA;AACrC,oDAAoD;AACpD,MAAM,CAAC,IAAM,wBAAwB,GAAG,CAAC,CAAA;AACzC;;GAEG;AACH,MAAM,CAAC,IAAM,mCAAmC,GAAG,CAAC,CAAA;AAEpD;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAkB,EAClB,QAGC;IAED,OAAO;QACL,CAAC,EAAE,wBAAwB;QAC3B,CAAC,EAAE,wBAAwB;QAC3B,IAAI,EAAE,uBAAuB;KAC9B,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,6BAA6B,CAC3C,EAAU,EACV,EAAU,EACV,IAAsC,EACtC,IAAmC;IADnC,qBAAA,EAAA,8BAAsC;IACtC,qBAAA,EAAA,2BAAmC;IAEnC,OAAO;QACL,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI;QACvB,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI;KACxB,CAAA;AACH,CAAC"}

package/lib/editor/input/ui/AcEdTouchPickStrategy.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Touch precise-pick strategies: finger loupe vs simulated mouse crosshair.
+ *
+ * Layout ({@link acedInteractionStrategy}) and pointer type remain separate
+ * axes. This strategy chooses how a long-press touch sample is mapped and
+ * which HUD chrome is shown during precise capture. The magnifier loupe is
+ * shown in both modes after a long press; simulated mouse only changes the
+ * sample offset and whether a crosshair is drawn.
+ */
+/**
+ * Vertical offset (CSS px) from the finger contact to the simulated-mouse
+ * crosshair center. Keeps the sample above the fingertip so geometry stays
+ * visible while dragging.
+ */
+export declare const ACED_SIMULATED_MOUSE_OFFSET_Y_PX = 52;
+/**
+ * HUD operations a touch-pick strategy may drive during precise capture.
+ * Implemented by the active point prompt (for example {@link AcEdFloatingInput}).
+ */
+export interface AcEdTouchPickHudHost {
+    /** Magnifier loupe centered on the pick sample. */
+    refreshSnapLoupe(clientX: number, clientY: number, snap?: {
+        x: number;
+        y: number;
+        type: number;
+    } | null): void;
+    /** Hides the magnifier loupe. */
+    hideSnapLoupe(): void;
+    /** Crosshair cursor at the pick sample (above the finger). */
+    refreshSimulatedCursor(clientX: number, clientY: number): void;
+    /** Hides the simulated-mouse crosshair. */
+    hideSimulatedCursor(): void;
+}
+/**
+ * Maps a finger sample to a pick sample and owns precise-capture chrome.
+ *
+ * Callers resolve the active strategy via {@link acedTouchPickStrategy}
+ * instead of branching on {@link AcApSettings.useSimulatedMouseOnTouch}.
+ */
+export interface AcEdTouchPickStrategy {
+    /**
+     * Maps finger client coordinates to the WCS / OSNAP sample used for the
+     * pick. Loupe mode is identity; simulated mouse offsets upward.
+     */
+    mapFingerToSample(clientX: number, clientY: number): {
+        x: number;
+        y: number;
+    };
+    /** Shows or repositions this strategy's precise-capture HUD. */
+    showPreciseHud(host: AcEdTouchPickHudHost, sampleX: number, sampleY: number, snap?: {
+        x: number;
+        y: number;
+        type: number;
+    } | null): void;
+    /** Hides this strategy's precise-capture HUD. */
+    hidePreciseHud(host: AcEdTouchPickHudHost): void;
+}
+/**
+ * Classic mobile pick: sample at the finger; magnifier loupe tracks the tip.
+ */
+export declare class AcEdLoupeTouchPickStrategy implements AcEdTouchPickStrategy {
+    mapFingerToSample(clientX: number, clientY: number): {
+        x: number;
+        y: number;
+    };
+    showPreciseHud(host: AcEdTouchPickHudHost, sampleX: number, sampleY: number, snap?: {
+        x: number;
+        y: number;
+        type: number;
+    } | null): void;
+    hidePreciseHud(host: AcEdTouchPickHudHost): void;
+}
+/**
+ * Simulated mouse: sample and crosshair sit above the finger so the tip
+ * does not block the geometry being snapped to. The magnifier loupe still
+ * tracks the (offset) sample — it does not conflict with the crosshair.
+ */
+export declare class AcEdSimulatedMouseTouchPickStrategy implements AcEdTouchPickStrategy {
+    mapFingerToSample(clientX: number, clientY: number): {
+        x: number;
+        y: number;
+    };
+    showPreciseHud(host: AcEdTouchPickHudHost, sampleX: number, sampleY: number, snap?: {
+        x: number;
+        y: number;
+        type: number;
+    } | null): void;
+    hidePreciseHud(host: AcEdTouchPickHudHost): void;
+}
+/**
+ * Active touch precise-pick strategy from {@link AcApSettings}.
+ *
+ * Re-evaluated each call so toggling the setting mid-command applies on the
+ * next gesture (and the next move while a finger is still down).
+ */
+export declare function acedTouchPickStrategy(): AcEdTouchPickStrategy;
+//# sourceMappingURL=AcEdTouchPickStrategy.d.ts.map

package/lib/editor/input/ui/AcEdTouchPickStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdTouchPickStrategy.d.ts","sourceRoot":"","sources":["../../../../src/editor/input/ui/AcEdTouchPickStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,KAAK,CAAA;AAElD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GACnD,IAAI,CAAA;IACP,iCAAiC;IACjC,aAAa,IAAI,IAAI,CAAA;IACrB,8DAA8D;IAC9D,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9D,2CAA2C;IAC3C,mBAAmB,IAAI,IAAI,CAAA;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3B,gEAAgE;IAChE,cAAc,CACZ,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GACnD,IAAI,CAAA;IACP,iDAAiD;IACjD,cAAc,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAAA;CACjD;AAED;;GAEG;AACH,qBAAa,0BAA2B,YAAW,qBAAqB;IACtE,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAI3B,cAAc,CACZ,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GACnD,IAAI;IAKP,cAAc,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;CAGjD;AAED;;;;GAIG;AACH,qBAAa,mCACX,YAAW,qBAAqB;IAEhC,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAO3B,cAAc,CACZ,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GACnD,IAAI;IAKP,cAAc,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;CAIjD;AAKD;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,qBAAqB,CAI7D"}

package/lib/editor/input/ui/AcEdTouchPickStrategy.js

@@ -0,0 +1,74 @@
+/**
+ * Touch precise-pick strategies: finger loupe vs simulated mouse crosshair.
+ *
+ * Layout ({@link acedInteractionStrategy}) and pointer type remain separate
+ * axes. This strategy chooses how a long-press touch sample is mapped and
+ * which HUD chrome is shown during precise capture. The magnifier loupe is
+ * shown in both modes after a long press; simulated mouse only changes the
+ * sample offset and whether a crosshair is drawn.
+ */
+import { AcApSettingManager } from '../../../app/AcApSettingManager';
+/**
+ * Vertical offset (CSS px) from the finger contact to the simulated-mouse
+ * crosshair center. Keeps the sample above the fingertip so geometry stays
+ * visible while dragging.
+ */
+export var ACED_SIMULATED_MOUSE_OFFSET_Y_PX = 52;
+/**
+ * Classic mobile pick: sample at the finger; magnifier loupe tracks the tip.
+ */
+var AcEdLoupeTouchPickStrategy = /** @class */ (function () {
+    function AcEdLoupeTouchPickStrategy() {
+    }
+    AcEdLoupeTouchPickStrategy.prototype.mapFingerToSample = function (clientX, clientY) {
+        return { x: clientX, y: clientY };
+    };
+    AcEdLoupeTouchPickStrategy.prototype.showPreciseHud = function (host, sampleX, sampleY, snap) {
+        host.hideSimulatedCursor();
+        host.refreshSnapLoupe(sampleX, sampleY, snap);
+    };
+    AcEdLoupeTouchPickStrategy.prototype.hidePreciseHud = function (host) {
+        host.hideSnapLoupe();
+    };
+    return AcEdLoupeTouchPickStrategy;
+}());
+export { AcEdLoupeTouchPickStrategy };
+/**
+ * Simulated mouse: sample and crosshair sit above the finger so the tip
+ * does not block the geometry being snapped to. The magnifier loupe still
+ * tracks the (offset) sample — it does not conflict with the crosshair.
+ */
+var AcEdSimulatedMouseTouchPickStrategy = /** @class */ (function () {
+    function AcEdSimulatedMouseTouchPickStrategy() {
+    }
+    AcEdSimulatedMouseTouchPickStrategy.prototype.mapFingerToSample = function (clientX, clientY) {
+        return {
+            x: clientX,
+            y: Math.max(0, clientY - ACED_SIMULATED_MOUSE_OFFSET_Y_PX)
+        };
+    };
+    AcEdSimulatedMouseTouchPickStrategy.prototype.showPreciseHud = function (host, sampleX, sampleY, snap) {
+        host.refreshSimulatedCursor(sampleX, sampleY);
+        host.refreshSnapLoupe(sampleX, sampleY, snap);
+    };
+    AcEdSimulatedMouseTouchPickStrategy.prototype.hidePreciseHud = function (host) {
+        host.hideSimulatedCursor();
+        host.hideSnapLoupe();
+    };
+    return AcEdSimulatedMouseTouchPickStrategy;
+}());
+export { AcEdSimulatedMouseTouchPickStrategy };
+var loupeStrategy = new AcEdLoupeTouchPickStrategy();
+var simulatedMouseStrategy = new AcEdSimulatedMouseTouchPickStrategy();
+/**
+ * Active touch precise-pick strategy from {@link AcApSettings}.
+ *
+ * Re-evaluated each call so toggling the setting mid-command applies on the
+ * next gesture (and the next move while a finger is still down).
+ */
+export function acedTouchPickStrategy() {
+    return AcApSettingManager.instance.get('useSimulatedMouseOnTouch')
+        ? simulatedMouseStrategy
+        : loupeStrategy;
+}
+//# sourceMappingURL=AcEdTouchPickStrategy.js.map

package/lib/editor/input/ui/AcEdTouchPickStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdTouchPickStrategy.js","sourceRoot":"","sources":["../../../../src/editor/input/ui/AcEdTouchPickStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAEpE;;;;GAIG;AACH,MAAM,CAAC,IAAM,gCAAgC,GAAG,EAAE,CAAA;AA+ClD;;GAEG;AACH;IAAA;IAqBA,CAAC;IApBC,sDAAiB,GAAjB,UACE,OAAe,EACf,OAAe;QAEf,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAA;IACnC,CAAC;IAED,mDAAc,GAAd,UACE,IAA0B,EAC1B,OAAe,EACf,OAAe,EACf,IAAoD;QAEpD,IAAI,CAAC,mBAAmB,EAAE,CAAA;QAC1B,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IAC/C,CAAC;IAED,mDAAc,GAAd,UAAe,IAA0B;QACvC,IAAI,CAAC,aAAa,EAAE,CAAA;IACtB,CAAC;IACH,iCAAC;AAAD,CAAC,AArBD,IAqBC;;AAED;;;;GAIG;AACH;IAAA;IA2BA,CAAC;IAxBC,+DAAiB,GAAjB,UACE,OAAe,EACf,OAAe;QAEf,OAAO;YACL,CAAC,EAAE,OAAO;YACV,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,gCAAgC,CAAC;SAC3D,CAAA;IACH,CAAC;IAED,4DAAc,GAAd,UACE,IAA0B,EAC1B,OAAe,EACf,OAAe,EACf,IAAoD;QAEpD,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC7C,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IAC/C,CAAC;IAED,4DAAc,GAAd,UAAe,IAA0B;QACvC,IAAI,CAAC,mBAAmB,EAAE,CAAA;QAC1B,IAAI,CAAC,aAAa,EAAE,CAAA;IACtB,CAAC;IACH,0CAAC;AAAD,CAAC,AA3BD,IA2BC;;AAED,IAAM,aAAa,GAAG,IAAI,0BAA0B,EAAE,CAAA;AACtD,IAAM,sBAAsB,GAAG,IAAI,mCAAmC,EAAE,CAAA;AAExE;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,0BAA0B,CAAC;QAChE,CAAC,CAAC,sBAAsB;QACxB,CAAC,CAAC,aAAa,CAAA;AACnB,CAAC"}