@element-editor/adapter-leaflet 0.0.0-stage → 0.2.0

package/dist/store/StoreContext.d.cts

@@ -0,0 +1 @@
+export { GeoStoreProvider, StoreContext, useDataStore, useUIStore, useGeoStore } from '@element-editor/ui';

package/dist/store/StoreContext.d.ts

@@ -0,0 +1 @@
+export { GeoStoreProvider, StoreContext, useDataStore, useUIStore, useGeoStore } from '@element-editor/ui';

package/dist/utils/boxSelect.d.cts

@@ -0,0 +1,4 @@
+/** True when bbox [w, s, e, n] lies fully inside the lng/lat box (edges inclusive). */
+export declare function bboxInside([w, s, e, n]: readonly number[], lngMin: number, latMin: number, lngMax: number, latMax: number): boolean;
+/** Order-insensitive equality of two id lists (assumes neither has duplicates). */
+export declare function sameIdSet(a: readonly string[], b: readonly string[]): boolean;

package/dist/utils/boxSelect.d.ts

@@ -0,0 +1,4 @@
+/** True when bbox [w, s, e, n] lies fully inside the lng/lat box (edges inclusive). */
+export declare function bboxInside([w, s, e, n]: readonly number[], lngMin: number, latMin: number, lngMax: number, latMax: number): boolean;
+/** Order-insensitive equality of two id lists (assumes neither has duplicates). */
+export declare function sameIdSet(a: readonly string[], b: readonly string[]): boolean;

package/dist/utils/dragUtils.d.cts

@@ -0,0 +1,12 @@
+import { PathOptions } from 'leaflet';
+export declare const GHOST_LINE_OPTIONS: PathOptions;
+export declare const GHOST_FILL_OPTIONS: PathOptions;
+/**
+ * Computes display and ghost coordinates for drag / duplicate-drag.
+ * - Normal drag: display = translated, ghost = null (feature moves)
+ * - Duplicate drag: display = original, ghost = translated (ghost follows cursor)
+ */
+export declare function computeDragDisplay<T>(coords: T, effectiveDelta: [number, number] | null, isDupDrag: boolean, geometryMode: 'visual' | 'spatial'): {
+    display: T;
+    ghost: T | null;
+};

package/dist/utils/dragUtils.d.ts

@@ -0,0 +1,12 @@
+import { PathOptions } from 'leaflet';
+export declare const GHOST_LINE_OPTIONS: PathOptions;
+export declare const GHOST_FILL_OPTIONS: PathOptions;
+/**
+ * Computes display and ghost coordinates for drag / duplicate-drag.
+ * - Normal drag: display = translated, ghost = null (feature moves)
+ * - Duplicate drag: display = original, ghost = translated (ghost follows cursor)
+ */
+export declare function computeDragDisplay<T>(coords: T, effectiveDelta: [number, number] | null, isDupDrag: boolean, geometryMode: 'visual' | 'spatial'): {
+    display: T;
+    ghost: T | null;
+};

package/dist/utils/featureTooltip.d.cts

@@ -0,0 +1,19 @@
+import { default as L } from 'leaflet';
+import { GeoJSONFeature } from '@element-editor/core';
+type UIStoreLike = {
+    getState: () => {
+        showFeatureNameOnHover: boolean;
+        vertexEditActive: boolean;
+    };
+};
+export declare function bindFeatureTooltip(layer: L.Layer, feature: GeoJSONFeature, uiStore: UIStoreLike, _latlng?: L.LatLng, originalEvent?: MouseEvent): void;
+/** `layer`: the cursor left that feature (its mouseout), which also ends a fresh
+ *  feature's quiet hover. `null`: just hide (mode switch, features removed, ...). */
+export declare function unbindFeatureTooltip(layer: L.Layer | null): void;
+/**
+ * Call with `true` when a ctrl/cmd/alt feature drag begins, `false` when it
+ * ends. While active, `bindFeatureTooltip` is a no-op and any currently
+ * visible tooltip is hidden immediately.
+ */
+export declare function setFeatureDragActive(active: boolean): void;
+export {};

package/dist/utils/featureTooltip.d.ts

@@ -0,0 +1,19 @@
+import { default as L } from 'leaflet';
+import { GeoJSONFeature } from '@element-editor/core';
+type UIStoreLike = {
+    getState: () => {
+        showFeatureNameOnHover: boolean;
+        vertexEditActive: boolean;
+    };
+};
+export declare function bindFeatureTooltip(layer: L.Layer, feature: GeoJSONFeature, uiStore: UIStoreLike, _latlng?: L.LatLng, originalEvent?: MouseEvent): void;
+/** `layer`: the cursor left that feature (its mouseout), which also ends a fresh
+ *  feature's quiet hover. `null`: just hide (mode switch, features removed, ...). */
+export declare function unbindFeatureTooltip(layer: L.Layer | null): void;
+/**
+ * Call with `true` when a ctrl/cmd/alt feature drag begins, `false` when it
+ * ends. While active, `bindFeatureTooltip` is a no-op and any currently
+ * visible tooltip is hidden immediately.
+ */
+export declare function setFeatureDragActive(active: boolean): void;
+export {};

package/dist/utils/freehandCommitFlag.d.cts

@@ -0,0 +1,2 @@
+export declare function markFreehandCommit(): void;
+export declare function isFreehandCommitConsumed(): boolean;

package/dist/utils/freehandCommitFlag.d.ts

@@ -0,0 +1,2 @@
+export declare function markFreehandCommit(): void;
+export declare function isFreehandCommitConsumed(): boolean;

package/dist/utils/freshFeature.d.cts

@@ -0,0 +1,17 @@
+import { Map as LeafletMap } from 'leaflet';
+import { GeoJSONFeature } from '@element-editor/core';
+export declare const freshFeatureId: () => string | null;
+export declare function setFreshFeature(id: string | null): void;
+/** Remember just-added features that sit under the cursor (container point `p`). */
+export declare function markAddedUnderCursor(map: LeafletMap, added: GeoJSONFeature[], p: {
+    x: number;
+    y: number;
+}): void;
+/** Drop pending features the cursor has moved away from (cheap: a handful of bboxes). */
+export declare function prunePending(map: LeafletMap, p: {
+    x: number;
+    y: number;
+}): void;
+/** Hovering `id`: true when it's the fresh feature (its first hover may make it so). */
+export declare function claimFresh(id: string): boolean;
+export declare function useIsFreshFeature(id: string): boolean;

package/dist/utils/freshFeature.d.ts

@@ -0,0 +1,17 @@
+import { Map as LeafletMap } from 'leaflet';
+import { GeoJSONFeature } from '@element-editor/core';
+export declare const freshFeatureId: () => string | null;
+export declare function setFreshFeature(id: string | null): void;
+/** Remember just-added features that sit under the cursor (container point `p`). */
+export declare function markAddedUnderCursor(map: LeafletMap, added: GeoJSONFeature[], p: {
+    x: number;
+    y: number;
+}): void;
+/** Drop pending features the cursor has moved away from (cheap: a handful of bboxes). */
+export declare function prunePending(map: LeafletMap, p: {
+    x: number;
+    y: number;
+}): void;
+/** Hovering `id`: true when it's the fresh feature (its first hover may make it so). */
+export declare function claimFresh(id: string): boolean;
+export declare function useIsFreshFeature(id: string): boolean;

package/dist/utils/geojson.d.cts

@@ -0,0 +1,3 @@
+import { Position } from 'geojson';
+export declare function toLeaflet(coord: Position | [number, number]): [number, number];
+export declare function toGeoJSON(coord: Position | [number, number]): [number, number];

package/dist/utils/geojson.d.ts

@@ -0,0 +1,3 @@
+import { Position } from 'geojson';
+export declare function toLeaflet(coord: Position | [number, number]): [number, number];
+export declare function toGeoJSON(coord: Position | [number, number]): [number, number];

package/dist/utils/measureClickFlag.d.cts

@@ -0,0 +1,2 @@
+export declare function markMeasureClick(): void;
+export declare function isMeasureClickConsumed(): boolean;

package/dist/utils/measureClickFlag.d.ts

@@ -0,0 +1,2 @@
+export declare function markMeasureClick(): void;
+export declare function isMeasureClickConsumed(): boolean;

package/dist/utils/modifierDragFlag.d.cts

@@ -0,0 +1,2 @@
+export declare function markModifierDragEnd(): void;
+export declare function isModifierDragConsumed(): boolean;

package/dist/utils/modifierDragFlag.d.ts

@@ -0,0 +1,2 @@
+export declare function markModifierDragEnd(): void;
+export declare function isModifierDragConsumed(): boolean;

package/dist/utils/pinPath.d.cts

@@ -0,0 +1,2 @@
+/** Pin outline with a see-through hole near the top; render with fill-rule="evenodd". */
+export declare const PIN_PATH: string;

package/dist/utils/pinPath.d.ts

@@ -0,0 +1,2 @@
+/** Pin outline with a see-through hole near the top; render with fill-rule="evenodd". */
+export declare const PIN_PATH: string;

package/dist/utils/rafThrottle.d.cts

@@ -0,0 +1,11 @@
+/**
+ * Coalesces high-frequency calls (mousemove, marker drag) into one call per
+ * animation frame, always with the latest arguments. `flush()` runs a pending
+ * call synchronously (call it before committing on mouseup so the commit sees
+ * the final cursor position); `cancel()` drops it.
+ */
+export declare function rafThrottle<A extends unknown[]>(fn: (...args: A) => void): {
+    schedule(...args: A): void;
+    flush(): void;
+    cancel(): void;
+};

package/dist/utils/rafThrottle.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Coalesces high-frequency calls (mousemove, marker drag) into one call per
+ * animation frame, always with the latest arguments. `flush()` runs a pending
+ * call synchronously (call it before committing on mouseup so the commit sees
+ * the final cursor position); `cancel()` drops it.
+ */
+export declare function rafThrottle<A extends unknown[]>(fn: (...args: A) => void): {
+    schedule(...args: A): void;
+    flush(): void;
+    cancel(): void;
+};

package/dist/utils/snapping.d.cts

@@ -0,0 +1,25 @@
+import { Map as LeafletMap } from 'leaflet';
+import { GeoJSONFeature } from '@element-editor/core';
+export interface SnapResult {
+    latlng: [number, number];
+    isVertex: boolean;
+}
+/**
+ * Finds the closest snap point (vertex or edge) among all provided features.
+ * Priority is given to vertices over edges if both are within the threshold.
+ *
+ * @param lng target longitude
+ * @param lat target latitude
+ * @param map Leaflet map instance (for pixel conversions)
+ * @param features All features to snap against
+ * @param threshold Pixel distance threshold for snapping
+ * @param excludeFeatureIds Feature IDs to ignore (e.g. the one being dragged)
+ */
+export declare function findSnapPoint(lng: number, lat: number, map: LeafletMap, features: GeoJSONFeature[], threshold?: number, excludeFeatureIds?: Set<string>): SnapResult | null;
+/**
+ * Snaps a cursor coordinate to a 15-degree increment relative to the last point.
+ * Uses screen pixels for visual accuracy in vector editors.
+ */
+export declare function snapToAngle(map: LeafletMap, lastCoord: [number, number], // [lng, lat]
+cursorCoord: [number, number], // [lng, lat]
+incrementDeg?: number): [number, number];

package/dist/utils/snapping.d.ts

@@ -0,0 +1,25 @@
+import { Map as LeafletMap } from 'leaflet';
+import { GeoJSONFeature } from '@element-editor/core';
+export interface SnapResult {
+    latlng: [number, number];
+    isVertex: boolean;
+}
+/**
+ * Finds the closest snap point (vertex or edge) among all provided features.
+ * Priority is given to vertices over edges if both are within the threshold.
+ *
+ * @param lng target longitude
+ * @param lat target latitude
+ * @param map Leaflet map instance (for pixel conversions)
+ * @param features All features to snap against
+ * @param threshold Pixel distance threshold for snapping
+ * @param excludeFeatureIds Feature IDs to ignore (e.g. the one being dragged)
+ */
+export declare function findSnapPoint(lng: number, lat: number, map: LeafletMap, features: GeoJSONFeature[], threshold?: number, excludeFeatureIds?: Set<string>): SnapResult | null;
+/**
+ * Snaps a cursor coordinate to a 15-degree increment relative to the last point.
+ * Uses screen pixels for visual accuracy in vector editors.
+ */
+export declare function snapToAngle(map: LeafletMap, lastCoord: [number, number], // [lng, lat]
+cursorCoord: [number, number], // [lng, lat]
+incrementDeg?: number): [number, number];

package/package.json

@@ -1,6 +1,101 @@
 {
   "name": "@element-editor/adapter-leaflet",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Add drawing, vertex editing, snapping and GeoJSON data editing to an existing Leaflet / react-leaflet map.",
+  "keywords": [
+    "element-editor",
+    "leaflet",
+    "react-leaflet",
+    "react",
+    "geojson",
+    "map-editor",
+    "drawing",
+    "vertex-editing",
+    "snapping",
+    "gis"
+  ],
+  "homepage": "https://elementeditor.dev",
+  "bugs": {
+    "url": "https://github.com/spatibase/element/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/spatibase/element.git",
+    "directory": "packages/adapter-leaflet"
+  },
+  "license": "MIT",
+  "author": "Michal Acler",
+  "private": false,
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.es.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.es.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./style.css": "./dist/adapter-leaflet.css"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "AGENTS.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@phosphor-icons/react": "^2.1.7",
+    "@turf/area": "^7.3.4",
+    "@turf/bbox": "^7.3.4",
+    "@turf/boolean-intersects": "^7.3.4",
+    "@turf/distance": "^7.3.4",
+    "@turf/helpers": "^7.3.4",
+    "@turf/length": "^7.3.4",
+    "@turf/transform-rotate": "^7.3.4",
+    "sonner": "^2.0.7",
+    "@element-editor/core": "0.2.0",
+    "@element-editor/ui": "0.2.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.2.2",
+    "@types/geojson": "^7946.0.16",
+    "@types/leaflet": "^1.9.21",
+    "@types/react": "^19.0.2",
+    "@types/react-dom": "^19.0.2",
+    "@vitejs/plugin-react": "^4.7.0",
+    "tailwindcss": "^4.2.2",
+    "typescript": "~5.7.2",
+    "vite": "^6.4.2",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.1.0"
+  },
+  "peerDependencies": {
+    "leaflet": "^1.9.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "react-leaflet": "^5.0.0"
+  },
+  "scripts": {
+    "build": "vite build && node ../../scripts/fix-dts.mjs",
+    "dev": "tsc -b --watch",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
 }