@zwishing/emap 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.1] - 2026-05-21
+
+### Changed
+
+- `boxSelect` now behaves like an active selection tool by default: plain
+  left-drag starts a rectangular selection and replaces the previous selection,
+  while `Shift`+drag adds to the existing selection and `Shift`+`Alt`+drag
+  toggles matching features.
+- `transform` edit mode keeps map panning available outside already-selected
+  features; dragging selected features still starts a transform session.
+- When pan or translate-transform mode is active and the pointer hovers an
+  already-selected feature, the canvas cursor now switches to `move`; active
+  map dragging still uses `grabbing`.
+
 ## [0.3.0] - 2026-05-21
 
 ### Added

package/FEATURES.md

@@ -134,7 +134,7 @@ these directly without using bundled UI controls.
 | `map.dragPan` | Pointer drag map panning |
 | `map.scrollZoom` | Wheel zoom |
 | `map.clickSelect` | Click selection |
-| `map.boxSelect` | Shift-drag rectangular selection |
+| `map.boxSelect` | Active-tool rectangular selection |
 | `map.lassoSelect` | Free-form lasso selection |
 | `map.vertexEdit` | Topology-aware vertex editing |
 | `map.drawFeature` | Point, polyline, and polygon drawing |

package/README.md

@@ -189,7 +189,6 @@ them directly from your own UI instead of adding `BoxSelectControl`,
 ```ts
 map.boxSelect.setOptions({
   layers: ['district-fill'],
-  dragActivator: 'shift',
   dragThreshold: 4,
 });
 map.boxSelect.enable();
@@ -229,7 +228,7 @@ Available named handlers:
 | `map.dragPan` | Pointer drag map panning |
 | `map.scrollZoom` | Wheel zoom |
 | `map.clickSelect` | Click selection |
-| `map.boxSelect` | Shift-drag rectangular selection |
+| `map.boxSelect` | Active-tool rectangular selection |
 | `map.lassoSelect` | Free-form lasso selection |
 | `map.vertexEdit` | Topology-aware vertex editing |
 | `map.drawFeature` | Point, polyline, and polygon drawing |
@@ -282,11 +281,12 @@ const clearButton = document.querySelector<HTMLButtonElement>('[data-tool="clear
 
 map.boxSelect.setOptions({
   layers: ['district-fill'],
-  dragActivator: 'shift',
   dragThreshold: 4,
-  mode: 'replace',
 });
 
+// Plain drag replaces the current selection. Shift+drag adds to it;
+// Shift+Alt+drag toggles matching features.
+
 function activateBoxSelect() {
   map.lassoSelect.disable();
   map.vertexEdit.disable();

package/dist/core/handlers/box-select.d.ts

@@ -15,7 +15,7 @@ export interface BoxSelectStyle {
 export interface BoxSelectHandlerOptions extends SelectHandlerOptions {
     /** Min drag diagonal (px) before a release counts as a box. Default 4. */
     dragThreshold?: number;
-    /** Combo that must be held at pointerdown to start. Default 'shift'. */
+    /** Combo that must be held at pointerdown to start. Default 'none'. */
     dragActivator?: ModifierCombo;
     style?: BoxSelectStyle;
 }
@@ -25,8 +25,7 @@ export interface BoxSelectHandlerOptions extends SelectHandlerOptions {
  * `_canvasContainer`, and on release past `dragThreshold` runs
  * `queryFeatures(bbox)` → `select(mode)`. Mode is resolved by stripping the
  * activator then matching `modifiers` — reproducing the legacy
- * `BoxSelectControl` behavior exactly. Mutually exclusive with `lassoSelect`
- * (enforced in HandlerManager — a later task).
+ * active-tool selection behavior. Mutually exclusive with `lassoSelect`.
  */
 export declare class BoxSelectHandler extends EventDispatcher implements Handler<BoxSelectHandlerOptions> {
     private _map;

package/dist/core/handlers/drag-pan.d.ts

@@ -4,6 +4,10 @@ export interface DragPanOptions {
     /** Reserve shift+drag for higher-level handlers (P2b selection). Default true. */
     skipShiftDrag: boolean;
 }
+type Point = {
+    x: number;
+    y: number;
+};
 /**
  * Named `dragPan` handler. Phase 2a: pan logic lives in `handlePointer`,
  * driven by HandlerManager's single pointer-listener arbiter — the handler
@@ -16,8 +20,10 @@ export declare class DragPanHandler extends EventDispatcher implements Handler<D
     private _enabled;
     private _dragging;
     private _last;
+    private _hoverPoint;
     private _onGestureStart?;
-    constructor(opts?: Partial<DragPanOptions>, onGestureStart?: () => void);
+    private _isHoveringSelected?;
+    constructor(opts?: Partial<DragPanOptions>, onGestureStart?: () => void, isHoveringSelected?: (point: Point) => boolean);
     enable(): void;
     disable(): void;
     isEnabled(): boolean;
@@ -26,3 +32,4 @@ export declare class DragPanHandler extends EventDispatcher implements Handler<D
     getCursor(): string | null;
     handlePointer(ev: NormalizedPointerEvent): HandlerResult;
 }
+export {};

package/dist/core/handlers/transform-feature.d.ts

@@ -24,6 +24,11 @@ export declare class TransformFeatureHandler implements Handler<TransformFeature
     private _translate;
     private _affine;
     private _lastMap;
+    private _hoveringSelected;
+    /** Injected by HandlerManager.register (cursor recompute on mode flips). */
+    _manager?: {
+        refreshCursor(): void;
+    };
     private _prevAngle;
     private _prevDist;
     private _onKeyDownBound;
@@ -35,6 +40,7 @@ export declare class TransformFeatureHandler implements Handler<TransformFeature
     isEnabled(): boolean;
     setOptions(o: Partial<TransformFeatureOptions>): void;
     getOptions(): Readonly<TransformFeatureOptions>;
+    getCursor(): string | null;
     private _cancelSession;
     private _onKeyDown;
     handlePointer(ev: NormalizedPointerEvent): HandlerResult;