terra-draw 0.0.1-alpha.63 → 0.0.1-alpha.65

package/.devcontainer/devcontainer.json

@@ -2,12 +2,18 @@
 	"name": "terra-draw",
 	"dockerFile": "Dockerfile",
 	"build": {
-		"args": { "NODE_MAJOR_VERSION": "18" }
+		"args": {
+			"NODE_MAJOR_VERSION": "20"
+		}
 	},
 	"postCreateCommand": [".devcontainer/post-create.sh"],
 	"portsAttributes": {
-		"3000": { "label": "Docs" },
-		"9000": { "label": "Development" }
+		"3000": {
+			"label": "Docs"
+		},
+		"9000": {
+			"label": "Development"
+		}
 	},
 	"customizations": {
 		"vscode": {

package/README.md

@@ -16,7 +16,7 @@ Terra Draw uses the concept of 'adapters' to allow it to work with a host of dif
 - [Leaflet](https://leafletjs.com/) v1
 - [OpenLayers](https://openlayers.org/) v7
 - [Mapbox GL JS](https://www.mapbox.com/mapbox-gljs) v2
-- [MapLibre](https://maplibre.org/projects/maplibre-gl-js/) v2/v3
+- [MapLibre](https://maplibre.org/maplibre-gl-js/docs/) 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)
 
@@ -26,8 +26,8 @@ Please see the [the getting started guide](./guides/1.GETTING_STARTED.md) - this
 
 ### Development & Contributing
 
-* For development, please see the [the development documentation](./guides/6.DEVELOPMENT.md)
-* For guidance on contributing, please see the [the contributing documentation](./guides/CONTRIBUTING.md)
+* For development, please see the [the development documentation](./guides/7.DEVELOPMENT.md)
+* For guidance on contributing, please see the [the contributing documentation](./guides/7.DEVELOPMENT.md#contributing)
 
 
 ### Project Website

package/dist/geometry/measure/area.d.ts

@@ -0,0 +1,2 @@
+import { Polygon } from "geojson";
+export declare function polygonAreaSquareMeters(polygon: Polygon): number;

package/dist/geometry/web-mercator-center.d.ts

@@ -0,0 +1,5 @@
+import { Feature, LineString, Polygon } from "geojson";
+export declare function webMercatorCenter(feature: Feature<Polygon | LineString>): {
+    x: number;
+    y: number;
+};

package/dist/modes/select/behaviors/drag-coordinate-resize.behavior.d.ts

@@ -3,7 +3,7 @@ import { BehaviorConfig, TerraDrawModeBehavior } from "../../base.behavior";
 import { PixelDistanceBehavior } from "../../pixel-distance.behavior";
 import { MidPointBehavior } from "./midpoint.behavior";
 import { SelectionPointBehavior } from "./selection-point.behavior";
-import { FeatureId } from "../../../store/store";
+import { FeatureId, GeoJSONStoreFeatures } from "../../../store/store";
 export type ResizeOptions = "center-web-mercator" | "opposite-web-mercator" | "center-fixed-web-mercator" | "opposite-fixed-web-mercator";
 export declare class DragCoordinateResizeBehavior extends TerraDrawModeBehavior {
     readonly config: BehaviorConfig;
@@ -58,5 +58,5 @@ export declare class DragCoordinateResizeBehavior extends TerraDrawModeBehavior
      * @param resizeOption - the resize option, either "center-web-mercator" or "opposite-web-mercator"
      * @returns - true is resize was successful, false otherwise
      */
-    drag(event: TerraDrawMouseEvent, resizeOption: ResizeOptions): boolean;
+    drag(event: TerraDrawMouseEvent, resizeOption: ResizeOptions, validateFeature?: (feature: GeoJSONStoreFeatures) => boolean): boolean;
 }

package/dist/modes/select/behaviors/drag-coordinate.behavior.d.ts

@@ -3,7 +3,7 @@ import { BehaviorConfig, TerraDrawModeBehavior } from "../../base.behavior";
 import { PixelDistanceBehavior } from "../../pixel-distance.behavior";
 import { MidPointBehavior } from "./midpoint.behavior";
 import { SelectionPointBehavior } from "./selection-point.behavior";
-import { FeatureId } from "../../../store/store";
+import { FeatureId, GeoJSONStoreFeatures } from "../../../store/store";
 export declare class DragCoordinateBehavior extends TerraDrawModeBehavior {
     readonly config: BehaviorConfig;
     private readonly pixelDistance;
@@ -13,7 +13,7 @@ export declare class DragCoordinateBehavior extends TerraDrawModeBehavior {
     private draggedCoordinate;
     private getClosestCoordinate;
     getDraggableIndex(event: TerraDrawMouseEvent, selectedId: FeatureId): number;
-    drag(event: TerraDrawMouseEvent, allowSelfIntersection: boolean): boolean;
+    drag(event: TerraDrawMouseEvent, allowSelfIntersection: boolean, validateFeature?: (feature: GeoJSONStoreFeatures) => boolean): boolean;
     isDragging(): boolean;
     startDragging(id: FeatureId, index: number): void;
     stopDragging(): void;

package/dist/modes/select/behaviors/drag-feature.behavior.d.ts

@@ -3,7 +3,7 @@ import { BehaviorConfig, TerraDrawModeBehavior } from "../../base.behavior";
 import { FeatureAtPointerEventBehavior } from "./feature-at-pointer-event.behavior";
 import { SelectionPointBehavior } from "./selection-point.behavior";
 import { MidPointBehavior } from "./midpoint.behavior";
-import { FeatureId } from "../../../store/store";
+import { FeatureId, GeoJSONStoreFeatures } from "../../../store/store";
 export declare class DragFeatureBehavior extends TerraDrawModeBehavior {
     readonly config: BehaviorConfig;
     private readonly featuresAtMouseEvent;
@@ -16,5 +16,5 @@ export declare class DragFeatureBehavior extends TerraDrawModeBehavior {
     stopDragging(): void;
     isDragging(): boolean;
     canDrag(event: TerraDrawMouseEvent, selectedId: FeatureId): boolean;
-    drag(event: TerraDrawMouseEvent): false | undefined;
+    drag(event: TerraDrawMouseEvent, validateFeature?: (feature: GeoJSONStoreFeatures) => boolean): false | undefined;
 }

package/dist/modes/select/behaviors/rotate-feature.behavior.d.ts

@@ -2,7 +2,7 @@ import { TerraDrawMouseEvent } from "../../../common";
 import { BehaviorConfig, TerraDrawModeBehavior } from "../../base.behavior";
 import { SelectionPointBehavior } from "./selection-point.behavior";
 import { MidPointBehavior } from "./midpoint.behavior";
-import { FeatureId } from "../../../store/store";
+import { FeatureId, GeoJSONStoreFeatures } from "../../../store/store";
 export declare class RotateFeatureBehavior extends TerraDrawModeBehavior {
     readonly config: BehaviorConfig;
     private readonly selectionPoints;
@@ -10,5 +10,5 @@ export declare class RotateFeatureBehavior extends TerraDrawModeBehavior {
     constructor(config: BehaviorConfig, selectionPoints: SelectionPointBehavior, midPoints: MidPointBehavior);
     private lastBearing;
     reset(): void;
-    rotate(event: TerraDrawMouseEvent, selectedId: FeatureId): void;
+    rotate(event: TerraDrawMouseEvent, selectedId: FeatureId, validateFeature?: (feature: GeoJSONStoreFeatures) => boolean): false | undefined;
 }

package/dist/modes/select/behaviors/scale-feature.behavior.d.ts

@@ -2,7 +2,7 @@ import { TerraDrawMouseEvent } from "../../../common";
 import { BehaviorConfig, TerraDrawModeBehavior } from "../../base.behavior";
 import { SelectionPointBehavior } from "./selection-point.behavior";
 import { MidPointBehavior } from "./midpoint.behavior";
-import { FeatureId } from "../../../store/store";
+import { FeatureId, GeoJSONStoreFeatures } from "../../../store/store";
 export declare class ScaleFeatureBehavior extends TerraDrawModeBehavior {
     readonly config: BehaviorConfig;
     private readonly selectionPoints;
@@ -10,5 +10,5 @@ export declare class ScaleFeatureBehavior extends TerraDrawModeBehavior {
     constructor(config: BehaviorConfig, selectionPoints: SelectionPointBehavior, midPoints: MidPointBehavior);
     private lastDistance;
     reset(): void;
-    scale(event: TerraDrawMouseEvent, selectedId: FeatureId): void;
+    scale(event: TerraDrawMouseEvent, selectedId: FeatureId, validateFeature?: (feature: GeoJSONStoreFeatures) => boolean): false | undefined;
 }

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

@@ -11,6 +11,7 @@ type TerraDrawSelectModeKeyEvents = {
 };
 type ModeFlags = {
     feature?: {
+        validation?: (geometry: GeoJSONStoreFeatures) => boolean;
         draggable?: boolean;
         rotateable?: boolean;
         scaleable?: boolean;
@@ -78,6 +79,7 @@ export declare class TerraDrawSelectMode extends TerraDrawBaseSelectMode<Selecti
     private scaleFeature;
     private dragCoordinateResizeFeature;
     private cursors;
+    private validations;
     constructor(options?: TerraDrawSelectModeOptions<SelectionStyling>);
     selectFeature(featureId: FeatureId): void;
     setSelecting(): void;

package/dist/store/store.d.ts

@@ -20,7 +20,7 @@ export type GeoJSONStoreConfig<Id extends FeatureId> = {
     tracked?: boolean;
 };
 export declare const defaultIdStrategy: {
-    getId: <FeatureId_1>() => FeatureId_1;
+    getId: <FeatureId>() => FeatureId;
     isValidId: (id: FeatureId) => boolean;
 };
 export declare class GeoJSONStore<Id extends FeatureId = FeatureId> {