@mlightcad/cad-simple-viewer 1.6.3 → 1.7.0

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

@@ -0,0 +1,329 @@
+/**
+ * Long-press / short-tap state machine for touch point picking.
+ *
+ * Timing constants live in {@link ./AcEdTouchPointTiming} so the offline HTML
+ * viewer can share the same values without importing this session module.
+ */
+import { ACED_TOUCH_POINT_LONG_PRESS_MS, ACED_TOUCH_POINT_MOVE_CANCEL_PX } from './AcEdTouchPointTiming';
+export { ACED_TOUCH_POINT_LONG_PRESS_MS, ACED_TOUCH_POINT_MOVE_CANCEL_PX } from './AcEdTouchPointTiming';
+var followingClickSink = null;
+var followingClickSinkTimer = null;
+/**
+ * Ignore compatibility mouse events this long after a touch pick ends.
+ *
+ * Chrome fires a `pointerType: 'mouse'` `pointerdown` then `click` after
+ * touch `pointerup`. Those coordinates are near the finger, so a two-point
+ * command (measure distance) would commit both points from one long-press.
+ */
+export var ACED_TOUCH_MOUSE_GUARD_MS = 1000;
+var ignoreCompatMouseUntil = 0;
+/**
+ * Whether a mouse/pen event is a leftover from a touch gesture.
+ *
+ * Browsers synthesize `pointerType: 'mouse'` (and `click`) after touch.
+ * Those events often have `clientX/clientY` of `0`, which maps to the
+ * canvas origin — the top-left of the view.
+ */
+export function acedIsTouchDerivedMouseEvent(event) {
+    if ('pointerType' in event && event.pointerType === 'touch')
+        return true;
+    var caps = event.sourceCapabilities;
+    return (caps === null || caps === void 0 ? void 0 : caps.firesTouchEvents) === true;
+}
+/**
+ * Whether client coordinates are the document origin.
+ *
+ * Compatibility mouse events after a toolbar tap are often dispatched at
+ * `(0, 0)`, which would commit a point at the canvas top-left.
+ *
+ * @param event - Event with client coordinates.
+ * @returns True when both client axes are zero.
+ */
+export function acedIsGhostClientOrigin(event) {
+    return event.clientX === 0 && event.clientY === 0;
+}
+/**
+ * Stops the next `click` in the capture phase and ignores compatibility
+ * mouse events for {@link ACED_TOUCH_MOUSE_GUARD_MS}.
+ *
+ * Touch picking commits on `pointerup`. The browser then synthesizes a
+ * mouse `pointerdown` + `click` near the finger. A new point prompt would
+ * treat that as a real mouse pick unless this guard stays armed across
+ * prompt instances.
+ */
+export function acedSinkFollowingClick() {
+    acedArmTouchMouseGuard();
+    if (followingClickSink)
+        return;
+    var sink = function (event) {
+        event.preventDefault();
+        event.stopImmediatePropagation();
+        acedClearFollowingClickSink();
+    };
+    followingClickSink = sink;
+    window.addEventListener('click', sink, true);
+    // If `preventDefault` on touch pointerdown already suppressed the leftover
+    // click, do not leave the sink armed forever — that would eat the next
+    // real mouse click on a hybrid (touch + mouse) device.
+    followingClickSinkTimer = setTimeout(function () {
+        acedClearFollowingClickSink();
+    }, ACED_TOUCH_MOUSE_GUARD_MS);
+}
+/**
+ * Removes {@link acedSinkFollowingClick} if it is armed.
+ */
+export function acedClearFollowingClickSink() {
+    if (followingClickSinkTimer != null) {
+        clearTimeout(followingClickSinkTimer);
+        followingClickSinkTimer = null;
+    }
+    if (!followingClickSink)
+        return;
+    window.removeEventListener('click', followingClickSink, true);
+    followingClickSink = null;
+}
+/**
+ * Arms the compatibility-mouse ignore window after a touch pick.
+ *
+ * @param now - Current time in milliseconds; defaults to `performance.now()`.
+ */
+export function acedArmTouchMouseGuard(now) {
+    if (now === void 0) { now = performance.now(); }
+    ignoreCompatMouseUntil = Math.max(ignoreCompatMouseUntil, now + ACED_TOUCH_MOUSE_GUARD_MS);
+}
+/**
+ * Whether mouse `pointerdown` / `click` should be ignored as leftover from
+ * a touch pick (including on a newly created prompt).
+ *
+ * @param now - Current time in milliseconds; defaults to `performance.now()`.
+ * @returns True while a following-click sink is armed or the guard window
+ *   has not expired.
+ */
+export function acedShouldIgnoreCompatMouse(now) {
+    if (now === void 0) { now = performance.now(); }
+    return followingClickSink != null || now < ignoreCompatMouseUntil;
+}
+/**
+ * Whether a `contextmenu` event is leftover from a touch long-press.
+ *
+ * Phones synthesize `contextmenu` ~500ms after finger-down — the same
+ * gesture that opens the snap loupe. Point prompts treat right-click as
+ * Enter; that leftover must not cancel the command.
+ *
+ * After `pointercancel`, some browsers omit `firesTouchEvents` and report
+ * `button === 2`. The compat-mouse guard covers that case.
+ *
+ * @param event - Context-menu mouse event.
+ * @returns True when the event should not be treated as right-click Enter.
+ */
+export function acedIsTouchLongPressContextMenu(event) {
+    if (acedIsTouchDerivedMouseEvent(event))
+        return true;
+    return acedShouldIgnoreCompatMouse();
+}
+/**
+ * Clears the click sink and mouse guard. Used by tests.
+ */
+export function acedResetTouchMouseGuard() {
+    acedClearFollowingClickSink();
+    ignoreCompatMouseUntil = 0;
+}
+/**
+ * Long-press / short-tap state machine for touch point picking.
+ *
+ * - Short tap (`pending` → end): commit at the last sample.
+ * - Hold until {@link ACED_TOUCH_POINT_LONG_PRESS_MS}: enter `loupe`.
+ * - Move beyond {@link ACED_TOUCH_POINT_MOVE_CANCEL_PX} before the timer
+ *   (when `cancelOnMove` is true): enter `panning` and do not commit.
+ */
+var AcEdTouchPointSession = /** @class */ (function () {
+    function AcEdTouchPointSession() {
+        /** Current gesture phase. */
+        this._phase = 'idle';
+        /** Pointer id of the active finger, or `-1` when idle. */
+        this._pointerId = -1;
+        /** Client X of the finger-down sample. */
+        this._startX = 0;
+        /** Client Y of the finger-down sample. */
+        this._startY = 0;
+        /** Latest sample X in the same space as {@link start}. */
+        this._x = 0;
+        /** Latest sample Y in the same space as {@link start}. */
+        this._y = 0;
+        /** Pending long-press timer, or `null` when none is scheduled. */
+        this._timer = null;
+        /** Callback invoked once when the session enters the `loupe` phase. */
+        this._onLongPress = null;
+    }
+    Object.defineProperty(AcEdTouchPointSession.prototype, "phase", {
+        /**
+         * Current gesture phase.
+         *
+         * @returns One of {@link AcEdTouchPointPhase}.
+         */
+        get: function () {
+            return this._phase;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcEdTouchPointSession.prototype, "pointerId", {
+        /**
+         * Active pointer id, or `-1` when idle.
+         *
+         * @returns The pointer id passed to {@link start}, or `-1`.
+         */
+        get: function () {
+            return this._pointerId;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcEdTouchPointSession.prototype, "x", {
+        /**
+         * Latest sample X in the same space as {@link start}.
+         *
+         * @returns Client (or canvas-host) X of the last sample.
+         */
+        get: function () {
+            return this._x;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcEdTouchPointSession.prototype, "y", {
+        /**
+         * Latest sample Y in the same space as {@link start}.
+         *
+         * @returns Client (or canvas-host) Y of the last sample.
+         */
+        get: function () {
+            return this._y;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Begins a touch pick. Invokes `onLongPress` after the long-press delay
+     * unless the session is cancelled or converted to a pan.
+     *
+     * @param pointerId - Pointer id of the finger that started the gesture.
+     * @param x - Sample X in client (or canvas-host) CSS pixels.
+     * @param y - Sample Y in client (or canvas-host) CSS pixels.
+     * @param onLongPress - Called once when the session enters the `loupe` phase.
+     * @param longPressMs - Delay before the loupe appears; defaults to
+     *   {@link ACED_TOUCH_POINT_LONG_PRESS_MS}.
+     */
+    AcEdTouchPointSession.prototype.start = function (pointerId, x, y, onLongPress, longPressMs) {
+        var _this = this;
+        if (longPressMs === void 0) { longPressMs = ACED_TOUCH_POINT_LONG_PRESS_MS; }
+        this.reset();
+        this._phase = 'pending';
+        this._pointerId = pointerId;
+        this._startX = x;
+        this._startY = y;
+        this._x = x;
+        this._y = y;
+        this._onLongPress = onLongPress;
+        this._timer = setTimeout(function () {
+            var _a;
+            _this._timer = null;
+            if (_this._phase !== 'pending')
+                return;
+            _this._phase = 'loupe';
+            (_a = _this._onLongPress) === null || _a === void 0 ? void 0 : _a.call(_this);
+        }, longPressMs);
+    };
+    /**
+     * Updates the sample position.
+     *
+     * @param x - New sample X in the same space as {@link start}.
+     * @param y - New sample Y in the same space as {@link start}.
+     * @param cancelOnMove - When true, movement past the cancel threshold
+     *   before the loupe appears aborts the pick (live viewer pan).
+     * @param cancelPx - Movement threshold in CSS pixels; defaults to
+     *   {@link ACED_TOUCH_POINT_MOVE_CANCEL_PX}.
+     * @returns `'panning'` when the pick was aborted, otherwise `'continue'`.
+     */
+    AcEdTouchPointSession.prototype.move = function (x, y, cancelOnMove, cancelPx) {
+        if (cancelPx === void 0) { cancelPx = ACED_TOUCH_POINT_MOVE_CANCEL_PX; }
+        if (this._phase === 'idle' || this._phase === 'panning')
+            return 'continue';
+        this._x = x;
+        this._y = y;
+        if (this._phase !== 'pending' || !cancelOnMove)
+            return 'continue';
+        var dx = x - this._startX;
+        var dy = y - this._startY;
+        if (dx * dx + dy * dy < cancelPx * cancelPx)
+            return 'continue';
+        this.clearTimer();
+        this._phase = 'panning';
+        this._onLongPress = null;
+        return 'panning';
+    };
+    /**
+     * Ends the gesture.
+     *
+     * @returns `'commit'` for a short tap or loupe release, `'ignore'` otherwise.
+     */
+    AcEdTouchPointSession.prototype.end = function () {
+        var phase = this._phase;
+        this.reset();
+        if (phase === 'pending' || phase === 'loupe')
+            return 'commit';
+        return 'ignore';
+    };
+    /**
+     * Aborts without committing (for example on `pointercancel`).
+     */
+    AcEdTouchPointSession.prototype.cancel = function () {
+        this.reset();
+    };
+    Object.defineProperty(AcEdTouchPointSession.prototype, "isPicking", {
+        /**
+         * Whether a pick is in progress (including while the loupe is visible).
+         *
+         * @returns True in the `pending` or `loupe` phase.
+         */
+        get: function () {
+            return this._phase === 'pending' || this._phase === 'loupe';
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcEdTouchPointSession.prototype, "isLoupe", {
+        /**
+         * Whether the long-press magnifier is currently shown.
+         *
+         * @returns True in the `loupe` phase.
+         */
+        get: function () {
+            return this._phase === 'loupe';
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Clears the pending long-press timer, if any.
+     */
+    AcEdTouchPointSession.prototype.clearTimer = function () {
+        if (this._timer != null) {
+            clearTimeout(this._timer);
+            this._timer = null;
+        }
+    };
+    /**
+     * Returns the session to {@link AcEdTouchPointPhase | idle} and drops the
+     * long-press callback.
+     */
+    AcEdTouchPointSession.prototype.reset = function () {
+        this.clearTimer();
+        this._phase = 'idle';
+        this._pointerId = -1;
+        this._onLongPress = null;
+    };
+    return AcEdTouchPointSession;
+}());
+export { AcEdTouchPointSession };
+//# sourceMappingURL=AcEdTouchPointSession.js.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * Shared timing for touch precise point capture.
+ *
+ * Kept in a tiny module so {@link @mlightcad/cad-html-plugin} can share the
+ * same values via the main package export (tree-shaken into the offline HTML
+ * IIFE) without depending on {@link ./AcEdTouchPointSession}.
+ */
+/**
+ * Long-press delay before precise capture activates (simulated mouse or
+ * snap loupe), in milliseconds.
+ */
+export declare const ACED_TOUCH_POINT_LONG_PRESS_MS = 1000;
+/**
+ * Pointer movement in CSS pixels that cancels a pending long-press so the
+ * gesture can be treated as a pan instead of a pick.
+ */
+export declare const ACED_TOUCH_POINT_MOVE_CANCEL_PX = 10;
+//# sourceMappingURL=AcEdTouchPointTiming.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdTouchPointTiming.d.ts","sourceRoot":"","sources":["../../../../src/editor/input/ui/AcEdTouchPointTiming.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,eAAO,MAAM,8BAA8B,OAAO,CAAA;AAElD;;;GAGG;AACH,eAAO,MAAM,+BAA+B,KAAK,CAAA"}

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

@@ -0,0 +1,18 @@
+/**
+ * Shared timing for touch precise point capture.
+ *
+ * Kept in a tiny module so {@link @mlightcad/cad-html-plugin} can share the
+ * same values via the main package export (tree-shaken into the offline HTML
+ * IIFE) without depending on {@link ./AcEdTouchPointSession}.
+ */
+/**
+ * Long-press delay before precise capture activates (simulated mouse or
+ * snap loupe), in milliseconds.
+ */
+export var ACED_TOUCH_POINT_LONG_PRESS_MS = 1000;
+/**
+ * Pointer movement in CSS pixels that cancels a pending long-press so the
+ * gesture can be treated as a pan instead of a pick.
+ */
+export var ACED_TOUCH_POINT_MOVE_CANCEL_PX = 10;
+//# sourceMappingURL=AcEdTouchPointTiming.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdTouchPointTiming.js","sourceRoot":"","sources":["../../../../src/editor/input/ui/AcEdTouchPointTiming.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,CAAC,IAAM,8BAA8B,GAAG,IAAI,CAAA;AAElD;;;GAGG;AACH,MAAM,CAAC,IAAM,+BAA+B,GAAG,EAAE,CAAA"}

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

@@ -1,6 +1,19 @@
 export * from './AcEdCommandLine';
+export * from './AcEdDesktopSessionAccessoryChrome';
+export * from './AcEdEntityPickCancelChrome';
 export * from './AcEdInputManager';
+export * from './AcEdInteractionStrategy';
 export * from './AcEdMessageType';
+export * from './AcEdMobileBoxGesture';
+export * from './AcEdMobileCommandChrome';
+export * from './AcEdMobileSessionMetrics';
 export * from './AcEdMTextEditor';
+export * from './AcEdSessionAccessoryController';
+export * from './AcEdMobileSnapLoupe';
+export * from './AcEdSimulatedMouseCursor';
+export * from './AcEdSnapLoupe';
+export * from './AcEdTouchPickStrategy';
+export * from './AcEdTouchPointTiming';
+export * from './AcEdTouchPointSession';
 export type { MTextToolbarColorPickerContext, MTextToolbarColorPickerFactory, MTextToolbarColorPickerInstance } from '@mlightcad/mtext-input-box';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/editor/input/ui/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,YAAY,EACV,8BAA8B,EAC9B,8BAA8B,EAC9B,+BAA+B,EAChC,MAAM,4BAA4B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/editor/input/ui/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,qCAAqC,CAAA;AACnD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oBAAoB,CAAA;AAClC,cAAc,2BAA2B,CAAA;AACzC,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,yBAAyB,CAAA;AACvC,YAAY,EACV,8BAA8B,EAC9B,8BAA8B,EAC9B,+BAA+B,EAChC,MAAM,4BAA4B,CAAA"}

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

@@ -1,5 +1,18 @@
 export * from './AcEdCommandLine';
+export * from './AcEdDesktopSessionAccessoryChrome';
+export * from './AcEdEntityPickCancelChrome';
 export * from './AcEdInputManager';
+export * from './AcEdInteractionStrategy';
 export * from './AcEdMessageType';
+export * from './AcEdMobileBoxGesture';
+export * from './AcEdMobileCommandChrome';
+export * from './AcEdMobileSessionMetrics';
 export * from './AcEdMTextEditor';
+export * from './AcEdSessionAccessoryController';
+export * from './AcEdMobileSnapLoupe';
+export * from './AcEdSimulatedMouseCursor';
+export * from './AcEdSnapLoupe';
+export * from './AcEdTouchPickStrategy';
+export * from './AcEdTouchPointTiming';
+export * from './AcEdTouchPointSession';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/editor/input/ui/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/editor/input/ui/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,qCAAqC,CAAA;AACnD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oBAAoB,CAAA;AAClC,cAAc,2BAA2B,CAAA;AACzC,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,yBAAyB,CAAA"}

package/lib/editor/view/AcEdBaseView.d.ts

@@ -1,10 +1,14 @@
 import { AcCmEventManager, AcDbEntity, AcDbLayerTableRecord, AcDbLayerTableRecordAttrs, AcDbLayout, AcDbObjectId, AcGeBox2d, AcGeBox3d, AcGeMatrix3d, AcGePoint2d, AcGePoint2dLike } from '@mlightcad/data-model';
 import type { AcTrSpatialSearchOptions } from '../../spatialIndex/AcTrSpatialIndex';
+import type { AcEdSessionAccessory, AcEdSessionAccessoryHostInfo } from '../command/AcEdSessionAccessory';
+import { AcEdSessionProviderRegistry } from '../command/AcEdSessionProviderRegistry';
 import { AcEdCorsorType, AcEdSelectionSet } from '../input';
 import { AcEditor } from '../input/AcEditor';
-import { AcEdOsnapResolver } from '../input/AcEdOsnapResolver';
+import { type AcEdOsnapPoint, AcEdOsnapResolver } from '../input/AcEdOsnapResolver';
 import { AcEdSelectionAction } from './AcEdSelectionAction';
 import { AcEdSpatialQueryResultItemEx } from './AcEdSpatialQueryResult';
+import { AcEdViewMode } from './AcEdViewMode';
+export { AcEdViewMode } from './AcEdViewMode';
 /**
  * Interface to define arguments of mouse event events.
  */
@@ -48,6 +52,20 @@ export interface AcEdViewHoverEventArgs {
      */
     id: AcDbObjectId;
 }
+/**
+ * Screen-fixed snap-loupe overlay: CSS rectangle on the canvas plus the
+ * world box shown inside it.
+ */
+export interface AcEdSnapLoupeViewState {
+    /** Canvas-local left of the loupe (CSS pixels). */
+    x: number;
+    /** Canvas-local top of the loupe (CSS pixels). */
+    y: number;
+    /** Width and height of the square loupe (CSS pixels). */
+    size: number;
+    /** World-space box mapped onto the loupe. */
+    viewBox: AcGeBox2d;
+}
 /**
  * Interface to define arguments of render frame events.
  */
@@ -61,42 +79,6 @@ export interface AcEdViewRenderFrameEventArgs {
      */
     camera: unknown;
 }
-/**
- * Enumeration of view interaction modes.
- *
- * The view mode determines how the view responds to user mouse interactions:
- * - In SELECTION mode, clicks select entities
- * - In PAN mode, clicks and drags pan the view
- *
- * @example
- * ```typescript
- * // Set to selection mode for entity picking
- * view.mode = AcEdViewMode.SELECTION;
- *
- * // Set to pan mode for view navigation
- * view.mode = AcEdViewMode.PAN;
- * ```
- */
-export declare enum AcEdViewMode {
-    /**
-     * Selection mode - mouse clicks select entities.
-     *
-     * In this mode:
-     * - Single clicks select individual entities
-     * - Drag operations can create selection boxes
-     * - Selected entities are highlighted with grip points
-     */
-    SELECTION = 0,
-    /**
-     * Pan mode - mouse interactions pan the view.
-     *
-     * In this mode:
-     * - Click and drag operations move the view
-     * - The cursor typically changes to indicate pan mode
-     * - Entity selection is disabled
-     */
-    PAN = 1
-}
 /**
  * Selection box interaction mode.
  */
@@ -186,6 +168,12 @@ export declare abstract class AcEdBaseView {
      * the canvas bounding-rect origin (`viewportToCanvas`).
      */
     private _curMousePos;
+    /**
+     * True after at least one mouse or pointer sample has updated
+     * {@link curMousePos}. Touch devices never fire `mousemove` until a finger
+     * is down, so the default `(0, 0)` must not be treated as a real cursor.
+     */
+    private _hasCursorPos;
     /** Set of currently selected entities */
     private _selectionSet;
     /**
@@ -212,10 +200,19 @@ export declare abstract class AcEdBaseView {
     private _hoverController;
     /** Resolves object snap points using this view's pick and coordinate APIs. */
     private _osnapResolver;
+    /** OSNAP markers shown while dragging overlay measurement / markup grips. */
+    private _overlayGripOsnapMarkers;
+    /** Last object snap acquired during {@link resolveOverlayGripPoint}, if any. */
+    private _lastOverlayGripOsnap;
     /** The HTML canvas element for rendering */
     protected _canvas: HTMLCanvasElement;
     /** The HTML element to contain this view */
     protected _container: HTMLElement;
+    /**
+     * Long-lived session UI providers for this view (draw-style, etc.).
+     * Feature installs register here; mountable accessories are minted on demand.
+     */
+    readonly sessionProviders: AcEdSessionProviderRegistry;
     /** Events fired by the view for various interactions */
     readonly events: {
         /** Fired when mouse moves over the view */
@@ -251,6 +248,20 @@ export declare abstract class AcEdBaseView {
      * @returns The editor instance
      */
     get editor(): AcEditor;
+    /**
+     * Active mount target for session accessories (desktop slot or mobile panel).
+     */
+    get sessionAccessoryHost(): AcEdSessionAccessoryHostInfo;
+    /**
+     * Selection-driven session accessory shown when no command accessory is mounted.
+     */
+    get selectionSessionAccessory(): AcEdSessionAccessory | null;
+    /**
+     * Updates the selection-driven session accessory forwarded to the input manager.
+     *
+     * @param value - Accessory to show on selection, or `null` to clear.
+     */
+    set selectionSessionAccessory(value: AcEdSessionAccessory | null);
     /**
      * Gets the size of the selection box used for entity picking.
      *
@@ -673,6 +684,21 @@ export declare abstract class AcEdBaseView {
      * when browser-viewport coordinates are required by DOM APIs.
      */
     get curMousePos(): AcGePoint2d;
+    /**
+     * Whether {@link curMousePos} has been set by a real pointer sample.
+     *
+     * @returns False until the first mouse or pointer event on the canvas.
+     */
+    get hasCursorPos(): boolean;
+    /**
+     * Marks {@link curMousePos} as stale so the next point prompt does not
+     * treat a leftover touch sample as a live cursor.
+     *
+     * Touch picking commits on `pointerup`. The finger position must not seed
+     * the following prompt's jig (that would draw a short segment next to the
+     * pick). The next real pointer sample sets this flag again.
+     */
+    clearCursorPos(): void;
     /**
      * The selection set in current view.
      */
@@ -688,14 +714,81 @@ export declare abstract class AcEdBaseView {
      * Object snap resolver scoped to this view.
      */
     get osnapResolver(): AcEdOsnapResolver;
+    /**
+     * Enables or disables camera pan/zoom (OrbitControls) for this view.
+     * Default is a no-op; {@link AcTrView2d} toggles the active layout controls.
+     *
+     * @param _enabled - When false, the user cannot pan or zoom this view.
+     */
+    setNavigationEnabled(_enabled: boolean): void;
+    /**
+     * Shows or hides the screen-fixed snap loupe overlay viewport.
+     * Pass `null` to hide. Default is a no-op.
+     *
+     * @param _state - Loupe screen rectangle and world box, or `null` to hide.
+     */
+    setSnapLoupe(_state: AcEdSnapLoupeViewState | null): void;
+    /**
+     * Resolves a world XY cursor through object snap and updates overlay grip
+     * snap markers. Used by HTML overlay endpoint drags (measure / markup).
+     *
+     * @param cursor - Raw world XY under the pointer.
+     * @param lastPoint - Grip origin passed to the osnap resolver as lastPoint.
+     * @returns Snapped world XY, or `cursor` when nothing is in aperture.
+     */
+    resolveOverlayGripPoint(cursor: {
+        x: number;
+        y: number;
+    }, lastPoint?: {
+        x: number;
+        y: number;
+    }): {
+        x: number;
+        y: number;
+    };
+    /**
+     * Last object snap from {@link resolveOverlayGripPoint}, or `null` when the
+     * cursor is not within aperture of any snap.
+     */
+    get lastOverlayGripOsnap(): AcEdOsnapPoint | null;
+    /**
+     * Shows or repositions the shared mobile snap loupe around a client sample.
+     * Used by overlay grip drag and point pick on phone/pad.
+     *
+     * @param clientX - Sample X in viewport/client CSS pixels.
+     * @param clientY - Sample Y in viewport/client CSS pixels.
+     * @param snap - Active object snap in world space, if any.
+     */
+    refreshMobileSnapLoupe(clientX: number, clientY: number, snap?: {
+        x: number;
+        y: number;
+        type: number;
+    } | null): void;
+    /**
+     * Hides the shared mobile snap loupe for this view.
+     */
+    hideMobileSnapLoupe(): void;
+    /**
+     * Hides overlay grip snap markers and clears acquired centers.
+     */
+    clearOverlayGripOsnap(): void;
+    /**
+     * Updates {@link width} / {@link height} from the size callback or canvas
+     * client size without notifying listeners. Subclasses that must sync
+     * projection (camera frustum, renderer buffer) before notifying should call
+     * this first, then dispatch {@link events.viewResize} themselves.
+     */
+    protected refreshViewSize(): void;
     protected onWindowResize(): void;
     /**
      * Clears the current hover state and cancels all hover-related timers.
      */
     protected clearHover(): void;
     /**
-     * Mouse move event handler.
-     * @param event Input mouse event argument
+     * Pointer sample handler. Updates canvas-local and world cursor from mouse
+     * or touch coordinates.
+     *
+     * @param event - Mouse or pointer event with client coordinates.
      */
     private onMouseMove;
 }