@zwishing/emap 0.3.1 → 0.3.3

package/CHANGELOG.md

@@ -7,6 +7,52 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.3] - 2026-05-24
+
+### Performance
+
+- Slow pan/wheel navigation now reuses the previous rendered canvas frame via
+  CSS transform while a full redraw is deferred until interaction end. The
+  scheduler avoids synchronous canvas readback, preventing the zoom jank seen
+  with `getImageData()`-based frame timing.
+- Canvas stroke batching now flushes paths every 100 arcs/paths instead of 25,
+  matching mapshaper's lower-overhead draw cadence for large topology renders.
+- Viewport arc filtering skips per-arc checks near full extent and raises the
+  minimum visible path threshold to 0.35px, reducing redraw work without
+  changing zoomed-in detail.
+- `DrawFeatureHandler._findSnapTarget` now filters candidate vertices and arc
+  segments by a world-space bbox derived from the cursor's pixel `snapThreshold`,
+  skipping `project()`/`hypot()` on points that cannot win. Removes the per-frame
+  O(N) cost over the entire `xx/yy` arrays on large topologies, making snapping
+  responsive on datasets with hundreds of thousands of vertices.
+
+## [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
@@ -336,7 +382,10 @@ Initial public release.
 - Distributed control stylesheet as `dist/emap.css` (importable via
   `@zwishing/emap/style.css`).
 
-[Unreleased]: https://github.com/zwishing/emap/compare/v0.3.0...HEAD
+[Unreleased]: https://github.com/zwishing/emap/compare/v0.3.3...HEAD
+[0.3.3]: https://github.com/zwishing/emap/compare/v0.3.2...v0.3.3
+[0.3.2]: https://github.com/zwishing/emap/compare/v0.3.1...v0.3.2
+[0.3.1]: https://github.com/zwishing/emap/compare/v0.3.0...v0.3.1
 [0.3.0]: https://github.com/zwishing/emap/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/zwishing/emap/compare/v0.1.3...v0.2.0
 [0.1.3]: https://github.com/zwishing/emap/compare/v0.1.2...v0.1.3

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;
 }