@zwishing/emap 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -7,6 +7,47 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.2] - 2026-05-23
+
+### Added
+
+- `EditToolbar` now accepts explicit `controls`, allowing examples and apps to
+  compose toolbar buttons directly from existing UI controls.
+- Added `draw-snap-clear.html` to demonstrate that draw snapping markers clear
+  as soon as the cursor leaves the configured threshold.
+
+### Changed
+
+- Renamed the batch snapping example from `snap.html` to `snap-layer.html` to
+  make its `snapLayer` purpose explicit.
+- Upgraded the direct `mproj` dependency to `^0.1.2` while keeping the browser
+  bundle self-contained.
+
+### Fixed
+
+- Draw snapping now clears stale snap overlays when the cursor moves outside the
+  snap threshold before the first vertex is placed.
+- Vertex editing can snap dragged nodes to other features' vertices or edges,
+  controlled by `snapThreshold`, `snapToVertex`, and `snapToEdge`.
+- `DrawFeatureControl` reapplies its own handler options when switching between
+  draw buttons in a shared toolbar.
+- `projectLayer` normalizes common EPSG aliases (`EPSG:3857`, `EPSG:900913`,
+  `EPSG:102100`, `EPSG:4326`) to mapshaper's browser-safe CRS names.
+
+## [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;

package/dist/core/handlers/vertex-edit.d.ts

@@ -3,6 +3,12 @@ import { Emap } from '../../map/map';
 export interface VertexEditOptions {
     /** Polygon hover fill. Default 'rgba(0,0,0,0.15)'. */
     polygonFillColor?: string;
+    /** Pixel threshold for snapping a dragged vertex to another feature. Default 10. */
+    snapThreshold?: number;
+    /** Snap dragged vertices to other features' existing vertices. Default true. */
+    snapToVertex?: boolean;
+    /** Snap dragged vertices to other features' edges. Default true. */
+    snapToEdge?: boolean;
 }
 export declare class VertexEditHandler implements Handler<VertexEditOptions> {
     readonly name = "vertexEdit";
@@ -23,6 +29,9 @@ export declare class VertexEditHandler implements Handler<VertexEditOptions> {
     private _neighborShapes;
     /** Coordinate of the dragged node before mouse-down, captured for VertexMoveCommand. */
     private _dragFromCoords;
+    private _snapThreshold;
+    private _snapToVertex;
+    private _snapToEdge;
     private _onMapMoveBound;
     constructor(map: Emap, opts?: VertexEditOptions);
     isEnabled(): boolean;
@@ -94,5 +103,7 @@ export declare class VertexEditHandler implements Handler<VertexEditOptions> {
     private _onMouseDown;
     private _pushVertexInsertCommand;
     private _handleDrag;
+    private _resolveDragCoords;
+    private _findDragSnapTarget;
     private _finishDrag;
 }