@zwishing/emap 0.2.0 → 0.3.0

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

@@ -0,0 +1,98 @@
+import type { Handler, HandlerResult, NormalizedPointerEvent } from '../handler';
+import { Emap } from '../../map/map';
+export interface VertexEditOptions {
+    /** Polygon hover fill. Default 'rgba(0,0,0,0.15)'. */
+    polygonFillColor?: string;
+}
+export declare class VertexEditHandler implements Handler<VertexEditOptions> {
+    readonly name = "vertexEdit";
+    private readonly _map;
+    private _enabled;
+    /** Injected by HandlerManager.register (cursor recompute on mode flips). */
+    _manager?: {
+        refreshCursor(): void;
+    };
+    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 _onMapMoveBound;
+    constructor(map: Emap, opts?: VertexEditOptions);
+    isEnabled(): boolean;
+    enable(): void;
+    getCursor(): string | null;
+    disable(): void;
+    setOptions(o: Partial<VertexEditOptions>): void;
+    getOptions(): Readonly<VertexEditOptions>;
+    handlePointer(ev: NormalizedPointerEvent): HandlerResult;
+    /** 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. Static appearance lives
+     * in `src/ui/controls.css` as `.emap-ctx-menu` / `.emap-ctx-menu-item`
+     * (themable via `--emap-*` tokens on `:root`); only the dynamic
+     * `left`/`top` coords are set inline here.
+     */
+    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 _finishDrag;
+}

package/dist/core/pointer-event-dispatcher.d.ts

@@ -0,0 +1,40 @@
+import type { NormalizedPointerEvent } from './handler';
+export interface PointerMoveEvent {
+    /** Element-local pixel coords (= the normalized event's `point`). */
+    point: {
+        x: number;
+        y: number;
+    };
+    /** `host.unproject(point.x, point.y)` — source-data coordinates. */
+    mapCoord: [number, number];
+    /** The DOM event that produced this (typed `Event`; a PointerEvent at runtime). */
+    originalEvent: Event;
+}
+type Cb = (e: PointerMoveEvent) => void;
+/** Minimal surface the dispatcher needs from Emap (keeps it unit-testable). */
+export interface PointerEventMapHost {
+    unproject(x: number, y: number): [number, number];
+}
+/**
+ * Delegated pointer-move event registry. Fed normalized pointer events by
+ * `HandlerManager`'s sink (non-gesture move) via `Emap._syncPointerSink`.
+ * Move-only by design (P8 §17.3) — `click` is covered by P3
+ * `feature:click`; `down`/`up`/`wheel`/`dblclick`/`contextmenu` have no
+ * consumer. No hit-test, no filter (it is not feature-scoped).
+ */
+export declare class PointerEventDispatcher {
+    private _host;
+    private _reg;
+    /** Maps user cb → its once-wrapper so `off(type, userCb)` resolves the wrap. */
+    private _onceWrap;
+    private _onChange?;
+    constructor(_host: PointerEventMapHost);
+    /** Install a callback invoked whenever the registry changes (drives sink install/teardown). */
+    setOnChange(fn: () => void): void;
+    hasListeners(): boolean;
+    on(type: string, cb: Cb): void;
+    once(type: string, cb: Cb): void;
+    off(type: string, cb: Cb): void;
+    dispatch(ev: NormalizedPointerEvent): void;
+}
+export {};

package/dist/core/tween.d.ts

@@ -5,6 +5,7 @@ export declare class Timer extends EventDispatcher {
     private _tickTime;
     private _startTime;
     private _duration;
+    private _frame;
     constructor();
     start(ms?: number): void;
     stop(): void;

package/dist/emap.css

@@ -1,3 +1,22 @@
+/* emap design tokens — defaults are the verbatim legacy literals so default
+ * rendering is byte-identical. Override on :root (or any ancestor selector)
+ * to theme. Introduced in DX P4 for the context menu; future phases may
+ * migrate existing controls to consume these tokens. */
+:root {
+  /* Accent (current usage: box-select stroke, lasso stroke, button-active bg). */
+  --emap-accent: #0078ff;
+  --emap-accent-soft: rgba(0, 120, 255, 0.1);
+  /* Surface — panels, menus, dropdowns. */
+  --emap-surface-bg: #fff;
+  --emap-surface-border: #ccc;
+  --emap-surface-shadow: 0 2px 8px rgba(0, 0, 0, 0.18);
+  /* Generic radius + hover/danger + font. */
+  --emap-radius: 4px;
+  --emap-hover-bg: #f5f5f5;
+  --emap-danger: #d32;
+  --emap-font: 13px/1.5 system-ui, sans-serif;
+}
+
 /* Navigation Controls */
 .emap-ctrl-group {
   background-color: #fff;
@@ -114,10 +133,6 @@
   color: #fff;
 }
 
-.emap-edit-active {
-  cursor: crosshair;
-}
-
 /* Draw Feature Controls */
 .emap-ctrl-draw {
   font-size: 14px;
@@ -128,10 +143,6 @@
   color: #fff;
 }
 
-.emap-draw-active {
-  cursor: crosshair;
-}
-
 /* Box Select rubber-band rectangle. Defaults are inlined by BoxSelectControl
    for option override; this rule lets users restyle via CSS too. */
 .emap-box-select {
@@ -155,3 +166,26 @@
 .emap-lasso-select {
   z-index: 5;
 }
+
+/* Right-click context menu — opened on right-click over a selected vertex
+ * by VertexEditHandler. Dynamic position/left/top are set inline; every
+ * other property is tokenised here. */
+.emap-ctx-menu {
+  position: fixed;
+  z-index: 9999;
+  min-width: 120px;
+  background: var(--emap-surface-bg);
+  border: 1px solid var(--emap-surface-border);
+  border-radius: var(--emap-radius);
+  box-shadow: var(--emap-surface-shadow);
+  padding: 4px 0;
+  font: var(--emap-font);
+}
+.emap-ctx-menu-item {
+  padding: 6px 16px;
+  cursor: pointer;
+  color: var(--emap-danger);
+}
+.emap-ctx-menu-item:hover {
+  background: var(--emap-hover-bg);
+}