terra-draw 0.0.1-alpha.43 → 0.0.1-alpha.45

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [0.0.1-alpha.45](https://github.com/JamesLMilner/terra-draw/compare/v0.0.1-alpha.44...v0.0.1-alpha.45) (2023-08-08)
+
+
+### Features
+
+* add basic tests for arcgis maps sdk adapter ([7fe12a3](https://github.com/JamesLMilner/terra-draw/commit/7fe12a3eb583b39bca409671f2c55e144cb17be9))
+* add Esri ArcGIS Maps SDK adapter ([0fece22](https://github.com/JamesLMilner/terra-draw/commit/0fece229c6ccd3fb573b634f6c5314c3192da76d))
+* add tests for render method ([14a3733](https://github.com/JamesLMilner/terra-draw/commit/14a3733c373a222bea569735eff4eb2f4c793587))
+* adjust styling to equal other map adapters ([2d07973](https://github.com/JamesLMilner/terra-draw/commit/2d07973fa24d96943064c444d18beb227615dd87))
+* allow cursors to be configured for built in modes ([57a5db2](https://github.com/JamesLMilner/terra-draw/commit/57a5db299b6424f7375a852c231fde0d6e0a4131))
+
+
+### Bug Fixes
+
+* better registration of selections by ignoring microdrags even when not drawing ([cd7a8ea](https://github.com/JamesLMilner/terra-draw/commit/cd7a8eaac209ba95784a961d823f7693038dd2ff))
+* pass modes as array rather than object ([80885cc](https://github.com/JamesLMilner/terra-draw/commit/80885cc62a15ec9ef32cf739771628cb2fe6edb2))
+
+
+### Chore
+
+* add ArcGIS JavaScript SDK to the README ([1801e50](https://github.com/JamesLMilner/terra-draw/commit/1801e5003a2d3b079c641d323d1ac70ccca58b36))
+* split out common patterns guide to its own file ([ef721cf](https://github.com/JamesLMilner/terra-draw/commit/ef721cf0385d9d3754a5a951fc930c1792405401))
+* update docs ([f1d1832](https://github.com/JamesLMilner/terra-draw/commit/f1d1832a5a95003a422d7e129c56e4c295a25e44))
+
+### [0.0.1-alpha.44](https://github.com/JamesLMilner/terra-draw/compare/v0.0.1-alpha.43...v0.0.1-alpha.44) (2023-07-25)
+
+
+### Bug Fixes
+
+* ensure that coordinate precision is limited when dragging a feature ([b7da22a](https://github.com/JamesLMilner/terra-draw/commit/b7da22a7ab4db2f5daec4db916997a02dc2c0193))
+
+
+### Chore
+
+* naive handling of antimeridian crossing for dragging coordinates ([8cdb7ab](https://github.com/JamesLMilner/terra-draw/commit/8cdb7ab5dc124d8240dee6378c5d3f194d2716bc))
+
 ### [0.0.1-alpha.43](https://github.com/JamesLMilner/terra-draw/compare/v0.0.1-alpha.42...v0.0.1-alpha.43) (2023-07-24)
 
 

package/README.md

@@ -18,10 +18,11 @@ Terra Draw uses the concept of 'adapters' to allow it to work with a host of dif
 - [Mapbox GL JS](https://www.mapbox.com/mapbox-gljs) v2
 - [MapLibre](https://maplibre.org/projects/maplibre-gl-js/) v2/v3
 - [Google Maps JS API](https://developers.google.com/maps/documentation/javascript/overview) v3
+- [ArcGIS JavaScript SDK](https://developers.arcgis.com/javascript/latest/) v4 (MapView)
 
 ### Getting Started
 
-Please see the [the getting started guide](./guides/GETTING_STARTED.md)
+Please see the [the getting started guide](./guides/GETTING_STARTED.md) - this provides a host of information on how get up and running with Terra Draw. You may also find some useful pointers for things you may be finding yourself wanting to do in the [common patterns guide](./guides/COMMON_PATTERNS.md).
 
 ### Development
 

package/dist/adapters/common/base.adapter.d.ts

@@ -6,9 +6,11 @@ type BaseMouseListener = (event: MouseEvent) => void;
 export declare abstract class TerraDrawBaseAdapter {
     constructor(config: {
         coordinatePrecision?: number;
+        minPixelDragDistanceDrawing?: number;
         minPixelDragDistance?: number;
     });
     protected _minPixelDragDistance: number;
+    protected _minPixelDragDistanceDrawing: number;
     protected _lastDrawEvent: TerraDrawMouseEvent | undefined;
     protected _coordinatePrecision: number;
     protected _heldKeys: Set<string>;

package/dist/common.d.ts

@@ -28,7 +28,11 @@ export interface TerraDrawKeyboardEvent {
     heldKeys: string[];
     preventDefault: () => void;
 }
-export type SetCursor = (cursor: "unset" | "grab" | "grabbing" | "crosshair" | "pointer" | "wait") => void;
+export type Required<T> = {
+    [P in keyof T]-?: T[P];
+};
+export type Cursor = Parameters<SetCursor>[0];
+export type SetCursor = (cursor: "unset" | "grab" | "grabbing" | "crosshair" | "pointer" | "wait" | "move") => void;
 export type Project = (lng: number, lat: number) => {
     x: number;
     y: number;

package/dist/modes/circle/circle.mode.d.ts

@@ -1,25 +1,30 @@
-import { TerraDrawMouseEvent, TerraDrawAdapterStyling, TerraDrawKeyboardEvent, HexColorStyling, NumericStyling } from "../../common";
+import { TerraDrawMouseEvent, TerraDrawAdapterStyling, TerraDrawKeyboardEvent, HexColorStyling, NumericStyling, Cursor } from "../../common";
 import { GeoJSONStoreFeatures } from "../../store/store";
 import { TerraDrawBaseDrawMode } from "../base.mode";
 type TerraDrawCircleModeKeyEvents = {
     cancel: KeyboardEvent["key"] | null;
     finish: KeyboardEvent["key"] | null;
 };
-type FreehandPolygonStyling = {
+type CirclePolygonStyling = {
     fillColor: HexColorStyling;
     outlineColor: HexColorStyling;
     outlineWidth: NumericStyling;
     fillOpacity: NumericStyling;
 };
-export declare class TerraDrawCircleMode extends TerraDrawBaseDrawMode<FreehandPolygonStyling> {
+interface Cursors {
+    start?: Cursor;
+}
+export declare class TerraDrawCircleMode extends TerraDrawBaseDrawMode<CirclePolygonStyling> {
     mode: string;
     private center;
     private clickCount;
     private currentCircleId;
     private keyEvents;
+    private cursors;
     constructor(options?: {
-        styles?: Partial<FreehandPolygonStyling>;
+        styles?: Partial<CirclePolygonStyling>;
         keyEvents?: TerraDrawCircleModeKeyEvents | null;
+        cursors?: Cursors;
     });
     private close;
     /** @internal */

package/dist/modes/freehand/freehand.mode.d.ts

@@ -1,4 +1,4 @@
-import { TerraDrawMouseEvent, TerraDrawAdapterStyling, TerraDrawKeyboardEvent, HexColorStyling, NumericStyling } from "../../common";
+import { TerraDrawMouseEvent, TerraDrawAdapterStyling, TerraDrawKeyboardEvent, HexColorStyling, NumericStyling, Cursor } from "../../common";
 import { TerraDrawBaseDrawMode } from "../base.mode";
 import { GeoJSONStoreFeatures } from "../../store/store";
 type TerraDrawFreehandModeKeyEvents = {
@@ -15,6 +15,10 @@ type FreehandPolygonStyling = {
     closingPointOutlineColor: HexColorStyling;
     closingPointOutlineWidth: NumericStyling;
 };
+interface Cursors {
+    start?: Cursor;
+    close?: Cursor;
+}
 export declare class TerraDrawFreehandMode extends TerraDrawBaseDrawMode<FreehandPolygonStyling> {
     mode: string;
     private startingClick;
@@ -22,10 +26,12 @@ export declare class TerraDrawFreehandMode extends TerraDrawBaseDrawMode<Freehan
     private closingPointId;
     private minDistance;
     private keyEvents;
+    private cursors;
     constructor(options?: {
         styles?: Partial<FreehandPolygonStyling>;
         minDistance?: number;
         keyEvents?: TerraDrawFreehandModeKeyEvents | null;
+        cursors?: Cursors;
     });
     private close;
     /** @internal */

package/dist/modes/greatcircle/great-circle.mode.d.ts

@@ -1,4 +1,4 @@
-import { TerraDrawMouseEvent, TerraDrawAdapterStyling, TerraDrawKeyboardEvent, HexColorStyling, NumericStyling } from "../../common";
+import { TerraDrawMouseEvent, TerraDrawAdapterStyling, TerraDrawKeyboardEvent, HexColorStyling, NumericStyling, Cursor } from "../../common";
 import { TerraDrawBaseDrawMode } from "../base.mode";
 import { BehaviorConfig } from "../base.behavior";
 import { GeoJSONStoreFeatures } from "../../store/store";
@@ -14,6 +14,10 @@ type GreateCircleStyling = {
     closingPointOutlineColor: HexColorStyling;
     closingPointOutlineWidth: NumericStyling;
 };
+interface Cursors {
+    start?: Cursor;
+    close?: Cursor;
+}
 export declare class TerraDrawGreatCircleMode extends TerraDrawBaseDrawMode<GreateCircleStyling> {
     mode: string;
     private currentCoordinate;
@@ -21,12 +25,14 @@ export declare class TerraDrawGreatCircleMode extends TerraDrawBaseDrawMode<Grea
     private closingPointId;
     private keyEvents;
     private snappingEnabled;
+    private cursors;
     private snapping;
     constructor(options?: {
         snapping?: boolean;
         pointerDistance?: number;
         styles?: Partial<GreateCircleStyling>;
         keyEvents?: TerraDrawGreateCircleModeKeyEvents | null;
+        cursors?: Cursors;
     });
     private close;
     /** @internal */

package/dist/modes/linestring/linestring.mode.d.ts

@@ -1,4 +1,4 @@
-import { TerraDrawMouseEvent, TerraDrawAdapterStyling, TerraDrawKeyboardEvent, HexColorStyling, NumericStyling } from "../../common";
+import { TerraDrawMouseEvent, TerraDrawAdapterStyling, TerraDrawKeyboardEvent, HexColorStyling, NumericStyling, Cursor } from "../../common";
 import { TerraDrawBaseDrawMode } from "../base.mode";
 import { BehaviorConfig } from "../base.behavior";
 import { GeoJSONStoreFeatures } from "../../store/store";
@@ -14,6 +14,10 @@ type LineStringStyling = {
     closingPointOutlineColor: HexColorStyling;
     closingPointOutlineWidth: NumericStyling;
 };
+interface Cursors {
+    start?: Cursor;
+    close?: Cursor;
+}
 export declare class TerraDrawLineStringMode extends TerraDrawBaseDrawMode<LineStringStyling> {
     mode: string;
     private currentCoordinate;
@@ -22,6 +26,7 @@ export declare class TerraDrawLineStringMode extends TerraDrawBaseDrawMode<LineS
     private allowSelfIntersections;
     private keyEvents;
     private snappingEnabled;
+    private cursors;
     private mouseMove;
     private snapping;
     constructor(options?: {
@@ -30,6 +35,7 @@ export declare class TerraDrawLineStringMode extends TerraDrawBaseDrawMode<LineS
         pointerDistance?: number;
         styles?: Partial<LineStringStyling>;
         keyEvents?: TerraDrawLineStringModeKeyEvents | null;
+        cursors?: Cursors;
     });
     private close;
     /** @internal */

package/dist/modes/point/point.mode.d.ts

@@ -1,4 +1,4 @@
-import { TerraDrawMouseEvent, TerraDrawAdapterStyling, NumericStyling, HexColorStyling } from "../../common";
+import { TerraDrawMouseEvent, TerraDrawAdapterStyling, NumericStyling, HexColorStyling, Cursor } from "../../common";
 import { GeoJSONStoreFeatures } from "../../store/store";
 import { TerraDrawBaseDrawMode } from "../base.mode";
 type PointModeStyling = {
@@ -7,10 +7,15 @@ type PointModeStyling = {
     pointOutlineColor: HexColorStyling;
     pointOutlineWidth: NumericStyling;
 };
+interface Cursors {
+    create?: Cursor;
+}
 export declare class TerraDrawPointMode extends TerraDrawBaseDrawMode<PointModeStyling> {
     mode: string;
+    private cursors;
     constructor(options?: {
         styles?: Partial<PointModeStyling>;
+        cursors?: Cursors;
     });
     /** @internal */
     start(): void;

package/dist/modes/polygon/polygon.mode.d.ts

@@ -1,4 +1,4 @@
-import { TerraDrawMouseEvent, TerraDrawAdapterStyling, TerraDrawKeyboardEvent, HexColorStyling, NumericStyling } from "../../common";
+import { TerraDrawMouseEvent, TerraDrawAdapterStyling, TerraDrawKeyboardEvent, HexColorStyling, NumericStyling, Cursor } from "../../common";
 import { TerraDrawBaseDrawMode } from "../base.mode";
 import { BehaviorConfig } from "../base.behavior";
 import { GeoJSONStoreFeatures } from "../../store/store";
@@ -16,6 +16,10 @@ type PolygonStyling = {
     closingPointOutlineWidth: NumericStyling;
     closingPointOutlineColor: HexColorStyling;
 };
+interface Cursors {
+    start?: Cursor;
+    close?: Cursor;
+}
 export declare class TerraDrawPolygonMode extends TerraDrawBaseDrawMode<PolygonStyling> {
     mode: string;
     private currentCoordinate;
@@ -26,6 +30,7 @@ export declare class TerraDrawPolygonMode extends TerraDrawBaseDrawMode<PolygonS
     private snapping;
     private pixelDistance;
     private closingPoints;
+    private cursors;
     private mouseMove;
     constructor(options?: {
         allowSelfIntersections?: boolean;
@@ -33,6 +38,7 @@ export declare class TerraDrawPolygonMode extends TerraDrawBaseDrawMode<PolygonS
         pointerDistance?: number;
         styles?: Partial<PolygonStyling>;
         keyEvents?: TerraDrawPolygonModeKeyEvents | null;
+        cursors?: Cursors;
     });
     private close;
     /** @internal */

package/dist/modes/rectangle/rectangle.mode.d.ts

@@ -1,4 +1,4 @@
-import { TerraDrawMouseEvent, TerraDrawAdapterStyling, TerraDrawKeyboardEvent, HexColorStyling, NumericStyling } from "../../common";
+import { TerraDrawMouseEvent, TerraDrawAdapterStyling, TerraDrawKeyboardEvent, HexColorStyling, NumericStyling, Cursor } from "../../common";
 import { GeoJSONStoreFeatures } from "../../store/store";
 import { TerraDrawBaseDrawMode } from "../base.mode";
 type TerraDrawRectangleModeKeyEvents = {
@@ -11,15 +11,20 @@ type RectanglePolygonStyling = {
     outlineWidth: NumericStyling;
     fillOpacity: NumericStyling;
 };
+interface Cursors {
+    start?: Cursor;
+}
 export declare class TerraDrawRectangleMode extends TerraDrawBaseDrawMode<RectanglePolygonStyling> {
     mode: string;
     private center;
     private clickCount;
     private currentRectangleId;
     private keyEvents;
+    private cursors;
     constructor(options?: {
         styles?: Partial<RectanglePolygonStyling>;
         keyEvents?: TerraDrawRectangleModeKeyEvents | null;
+        cursors?: Cursors;
     });
     private updateRectangle;
     private close;

package/dist/modes/render/render.mode.d.ts

@@ -19,6 +19,7 @@ export declare class TerraDrawRenderMode extends TerraDrawBaseDrawMode<RenderMod
     type: ModeTypes;
     mode: string;
     constructor(options: {
+        modeName: string;
         styles: Partial<RenderModeStyling>;
     });
     /** @internal */

package/dist/modes/select/select.mode.d.ts

@@ -1,4 +1,4 @@
-import { TerraDrawMouseEvent, TerraDrawKeyboardEvent, TerraDrawAdapterStyling, HexColorStyling, NumericStyling } from "../../common";
+import { TerraDrawMouseEvent, TerraDrawKeyboardEvent, TerraDrawAdapterStyling, HexColorStyling, NumericStyling, Cursor } from "../../common";
 import { ModeTypes, TerraDrawBaseDrawMode } from "../base.mode";
 import { BehaviorConfig } from "../base.behavior";
 import { GeoJSONStoreFeatures } from "../../store/store";
@@ -40,6 +40,12 @@ type SelectionStyling = {
     midPointWidth: NumericStyling;
     midPointOutlineWidth: NumericStyling;
 };
+interface Cursors {
+    pointerOver?: Cursor;
+    dragStart?: Cursor;
+    dragEnd?: Cursor;
+    insertMidpoint?: Cursor;
+}
 export declare class TerraDrawSelectMode extends TerraDrawBaseDrawMode<SelectionStyling> {
     type: ModeTypes;
     mode: string;
@@ -57,6 +63,7 @@ export declare class TerraDrawSelectMode extends TerraDrawBaseDrawMode<Selection
     private dragCoordinate;
     private rotateFeature;
     private scaleFeature;
+    private cursors;
     constructor(options?: {
         styles?: Partial<SelectionStyling>;
         pointerDistance?: number;
@@ -65,6 +72,7 @@ export declare class TerraDrawSelectMode extends TerraDrawBaseDrawMode<Selection
         };
         keyEvents?: TerraDrawSelectModeKeyEvents | null;
         dragEventThrottle?: number;
+        cursors?: Cursors;
     });
     registerBehaviors(config: BehaviorConfig): void;
     private deselect;