@zwishing/emap 0.2.0 → 0.3.0

package/dist/ui/lasso-select-control.d.ts

@@ -1,16 +1,8 @@
 import type { Control } from './control';
 import type { Emap } from '../map/map';
-/** Visual style for the rubber-band lasso path. */
-export interface LassoSelectStyle {
-    /** Stroke color. Default `'#0078ff'`. */
-    stroke?: string;
-    /** Stroke width in CSS pixels. Default `1.5`. */
-    strokeWidth?: number;
-    /** Fill color of the closed shape preview. Default `'rgba(0, 120, 255, 0.1)'`. */
-    fill?: string;
-    /** SVG `stroke-dasharray` value. Default `'4 3'` (subtly dashed). */
-    strokeDasharray?: string;
-}
+export { pointInPolygon, featureMatchesLasso } from '../core/handlers/select-geometry';
+export type { LassoSelectStyle } from '../core/handlers/lasso-select';
+import type { LassoSelectStyle } from '../core/handlers/lasso-select';
 export interface LassoSelectControlOptions {
     /**
      * Restrict the selection to a subset of layer ids. When omitted, every
@@ -31,66 +23,27 @@ export interface LassoSelectControlOptions {
     includeIntersecting?: boolean;
 }
 /**
- * Shift+drag free-form polygon feature selection. Sibling of
- * `BoxSelectControl` — same activation gesture, same modifier conventions,
- * different shape.
- *
- * The lasso path is recorded in pixel coordinates as the user drags. On
- * release, the closed polygon is used to test each candidate feature's
- * geometry; survivors are passed to `Emap.select`.
- *
- * Modifier-key conventions (layered on top of shift):
- * - shift only → mode `'replace'`
- * - shift + ctrl/meta → mode `'add'`
- * - shift + alt → mode `'toggle'`
+ * Thin shell over the `map.lassoSelect` handler (DX P2c). The handler owns
+ * the shift+drag free-form gesture, the dashed `.emap-lasso-select` SVG
+ * polyline, polygon hit-testing, and selection; this control just forwards
+ * options and proxies enable/disable, returning a 0×0 anchor. Public
+ * class, options, anchor DOM, selection behaviour, and the dashed visual
+ * are unchanged from the pre-P2c control.
  *
- * Coexistence with `BoxSelectControl`: both consume shift+drag. Pick one,
- * or install both and switch between them at runtime via `enable()` /
- * `disable()`.
- *
- * Hit-test semantics: by default, features are selected when their geometry
- * intersects or is contained by the lasso, matching box-select's inclusive
- * feel. Set `includeIntersecting: false` for strict containment.
+ * Modifier conventions (on top of shift): shift→`replace`,
+ * shift+ctrl/meta→`add`, shift+alt→`toggle`. Mutually exclusive with
+ * box-select — `onAdd` propagates the handler's throw if `boxSelect` is
+ * already enabled.
  */
 export declare class LassoSelectControl implements Control {
     private _options;
-    private _dragThreshold;
     private _enabled;
-    private _map;
+    private _handler;
     private _container;
-    private _svg;
-    private _polyline;
-    private _canvasContainer;
-    /** Drag state — pixel-space path. null when not dragging. */
-    private _path;
-    private _onMouseDownBound;
-    private _onMouseMoveBound;
-    private _onMouseUpBound;
     constructor(options?: LassoSelectControlOptions);
     onAdd(map: Emap): HTMLElement;
     onRemove(): void;
-    /** Disable the control — shift+drag becomes a no-op until re-enabled. */
     disable(): void;
     enable(): void;
     isEnabled(): boolean;
-    private _onMouseDown;
-    private _onMouseMove;
-    private _onMouseUp;
-    private _cancelDrag;
-    private _cleanupDrag;
-    private _eventToContainerPx;
 }
-/**
- * Even-odd ray-cast point-in-polygon test. The `polygon` may be open or
- * closed (last point == first point) — we don't require either form,
- * because we wrap via `j = (i - 1 + n) % n` modulo arithmetic. Self-
- * intersecting polygons follow standard even-odd semantics (which usually
- * matches the user's drawn intent).
- */
-export declare function pointInPolygon(point: [number, number], polygon: Array<[number, number]>): boolean;
-export declare function featureMatchesLasso(map: Emap, ref: {
-    source: string;
-    layer: string;
-    id: number;
-    geometryType?: string;
-}, lasso: Array<[number, number]>, includeIntersecting: boolean): boolean;

package/dist/ui/status-control.d.ts

@@ -12,12 +12,12 @@ export declare class StatusControl implements Control {
     private _options;
     private _mousePosEl;
     private _epsgEl;
-    private _onMouseMoveBound;
+    private _onMoveBound;
     private _onUpdateEPSGBound;
     private _rafPending;
     constructor(options?: StatusOptions);
     onAdd(map: Emap): HTMLElement;
-    private _onMouseMove;
+    private _onMove;
     private _updateEPSG;
     onRemove(): void;
 }

package/dist/ui/vertex-edit-control.d.ts

@@ -1,111 +1,16 @@
-import { Control } from './control';
-import { Emap } from '../map/map';
-/** Options for VertexEditControl */
+import type { Control } from './control';
+import type { Emap } from '../map/map';
 export interface VertexEditControlOptions {
-    /**
-     * Fill color for polygon shapes in vertex edit mode.
-     * Any CSS color string. Set to null to disable fill.
-     * @default 'rgba(0,0,0,0.15)'
-     */
-    polygonFillColor?: string | null;
+    /** Polygon hover fill, forwarded to map.vertexEdit. Default unchanged. */
+    polygonFillColor?: string;
 }
-/**
- * VertexEditControl enables interactive vertex editing with topology awareness.
- * When a shared node is dragged, ALL coincident vertices move together.
- *
- * Uses MapshaperAdapter.findNearestVertices to discover topologically-shared
- * vertices, and snapVerticesToPoint to move them all simultaneously.
- *
- * @example
- *   map.addControl(new VertexEditControl(), 'top-left');
- *   // With custom polygon fill:
- *   map.addControl(new VertexEditControl({ polygonFillColor: 'rgba(100,150,255,0.2)' }), 'top-left');
- */
 export declare class VertexEditControl implements Control {
     private _map;
     private _container;
     private _btn;
-    private _active;
-    private _polygonFillColor;
-    private _hoveredFeature;
-    private _hoverVertexCoords;
-    private _hoverVertexIds;
-    private _hoverType;
-    private _hoverInsertionId;
-    private _dragging;
-    /** Shapes of neighboring polygons sharing the hovered arc (for shared-edge highlight) */
-    private _neighborShapes;
-    /** Coordinate of the dragged node before mouse-down, captured for VertexMoveCommand. */
-    private _dragFromCoords;
-    private _onMouseMoveBound;
-    private _onMouseDownBound;
-    private _onMouseUpBound;
-    private _onMoveHandlerBound;
-    private _onContextMenuBound;
+    private _opts;
     constructor(options?: VertexEditControlOptions);
     onAdd(map: Emap): HTMLElement;
     onRemove(): void;
     private _toggle;
-    private _activate;
-    private _deactivate;
-    /** Redraw on map move/zoom (vertices stay fixed to geography) */
-    private _onMapMove;
-    /**
-     * Right-click handler: show a context menu to delete the hovered vertex.
-     * Guard rules (same as mapshaper):
-     *   - Must be hovering a vertex (not an interpolated edge point)
-     *   - Not currently dragging
-     *   - Vertex must NOT be an arc endpoint (deleting an endpoint breaks topology)
-     */
-    private _onContextMenu;
-    /** Delete the currently hovered vertex from the arc collection */
-    private _deleteHoveredVertex;
-    /**
-     * Re-initialize the source's DisplayArcs after an arc-mutating edit so that
-     * the simplified LOD copy reflects the new vertex layout.
-     */
-    private _refreshSourceDisplayArcs;
-    /**
-     * Bump the dataset's `editVersion` after a live in-place arc mutation.
-     * The spatial-index cache in `feature-query` keys on `editVersion`, so
-     * this is what tells the next `queryFeatures` call that bboxes may
-     * have changed and the index must rebuild. Cheap (a number
-     * increment); only the next query pays the actual rebuild cost.
-     *
-     * The matching command's `do()/undo()` also bump, but those run on
-     * undo / redo — not on initial commit, since `pushCommand` skips
-     * `do()` per the memento contract.
-     */
-    private _bumpSourceEditVersion;
-    /**
-     * Show a minimal context menu at (x, y) in viewport coords.
-     * Auto-dismissed when user clicks anywhere else.
-     */
-    private _showContextMenu;
-    private _onMouseMove;
-    /**
-     * Use MapshaperAdapter.findNearestVertices to discover ALL vertex indices
-     * that share the same topological node (identical coordinates across all arcs).
-     */
-    private _findNearestVertices;
-    /**
-     * Find the closest point along any segment edge (not just vertices).
-     * Uses mapshaper's forEachSegmentInShape + findClosestPointOnSeg.
-     * Called as fallback when no existing vertex is within hover threshold.
-     */
-    private _findInterpolatedPoint;
-    /**
-     * Find all shapes (polygons) in the source that share any arc with the hovered vertex/edge.
-     * Handles two cases:
-     *   - Vertex hover: hoverVertexIds → arcIds via findArcIdFromVertexId
-     *   - Edge hover (interpolated): hoverInsertionId - 1 → arcId via findArcIdFromVertexId
-     * Only runs when geometry is polygon. Populates _neighborShapes.
-     */
-    private _findNeighborShapes;
-    /** Update the edit vertex state on the map so render() draws vertex dots (and polygon fill) */
-    private _updateEditState;
-    private _onMouseDown;
-    private _pushVertexInsertCommand;
-    private _handleDrag;
-    private _onMouseUp;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zwishing/emap",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A modern, decoupled rendering engine for mapshaper data",
   "main": "dist/emap.mjs",
   "module": "dist/emap.mjs",
@@ -36,6 +36,7 @@
     "style.css.d.ts",
     "dist/**/*.d.ts",
     "README.md",
+    "FEATURES.md",
     "SECURITY.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -44,8 +45,10 @@
     "node": ">=18"
   },
   "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
     "dev": "rollup -c --environment BUILD:development -w",
     "dev-build": "rollup -c --environment BUILD:development",
+    "prebuild": "npm run clean",
     "build": "rollup -c --environment BUILD:production && tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",
     "test": "vitest",
@@ -79,6 +82,7 @@
     "@rollup/plugin-node-resolve": "^15.0.0",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^11.0.0",
+    "esbuild": "^0.21.5",
     "jsdom": "^29.1.0",
     "rollup": "^4.0.0",
     "rollup-plugin-polyfill-node": "^0.13.0",

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

@@ -1,28 +0,0 @@
-import { EventDispatcher } from './events';
-/**
- * Handles mouse drag-to-pan interaction.
- * Matches the MouseWheel pattern — extends EventDispatcher and emits events.
- *
- * Events:
- *   'pan' — { dx: number, dy: number } — pixel delta to translate
- *   'panstart' — drag started
- *   'panend' — drag ended
- */
-export declare class DragPanHandler extends EventDispatcher {
-    private _element;
-    private _isDragging;
-    private _lastMousePos;
-    private _enabled;
-    private _onMouseDownBound;
-    private _onMouseMoveBound;
-    private _onMouseUpBound;
-    constructor(element: HTMLElement);
-    /** Temporarily disable pan (e.g. during vertex editing) */
-    setEnabled(enabled: boolean): void;
-    isEnabled(): boolean;
-    isDragging(): boolean;
-    destroy(): void;
-    private _onMouseDown;
-    private _onMouseMove;
-    private _onMouseUp;
-}