terra-draw 0.0.1-alpha.4 → 0.0.1-alpha.41

package/package.json

@@ -1,88 +1,156 @@
 {
-    "name": "terra-draw",
-    "version": "0.0.1-alpha.4",
-    "description": "Frictionless map drawing across mapping provider",
-    "scripts": {
-        "build": "microbundle",
-        "watch": "microbundle --watch --format modern",
-        "test": "jest --config jest.config.ts",
-        "test:coverage": "jest --config jest.config.ts --coverage",
-        "test:nocheck": "NO_CHECK=true jest --config jest.config.ts",
-        "test:nocheck:coverage": "NO_CHECK=true jest --config jest.config.ts --coverage",
-        "lint": "eslint --ext .ts src/",
-        "lint:quiet": "eslint --ext .ts --quiet src/",
-        "lint:fix": "eslint --fix --ext .ts src/",
-        "lint:fix:quiet": "eslint --fix --quiet --ext .ts src/",
-        "prepare": "husky install"
-    },
-    "type": "module",
-    "source": "src/terra-draw.ts",
-    "exports": {
-        "require": "./dist/terra-draw.cjs",
-        "default": "./dist/terra-draw.modern.js",
-        "types": "./dist/terra-draw.d.ts"
-    },
-    "types": "./dist/terra-draw.d.ts",
-    "main": "./dist/terra-draw.cjs",
-    "module": "./dist/terra-draw.module.js",
-    "unpkg": "./dist/terra-draw.umd.js",
-    "author": "James Milner",
-    "license": "MIT",
-    "repository": "JamesLMilner/terra-draw",
-    "devDependencies": {
-        "@commitlint/cli": "^17.1.2",
-        "@commitlint/config-conventional": "^17.1.0",
-        "@googlemaps/js-api-loader": "^1.14.3",
-        "@swc/jest": "^0.2.22",
-        "@types/geojson": "^7946.0.8",
-        "@types/google.maps": "^3.49.2",
-        "@types/jest": "^28.1.5",
-        "@types/leaflet": "^1.7.11",
-        "@types/mapbox-gl": "^2.7.3",
-        "@types/rbush": "^3.0.0",
-        "@typescript-eslint/eslint-plugin": "^5.38.1",
-        "@typescript-eslint/parser": "^5.38.1",
-        "eslint": "^8.24.0",
-        "eslint-config-prettier": "^8.5.0",
-        "eslint-plugin-prettier": "^4.2.1",
-        "husky": "^7.0.0",
-        "jest": "^28.1.2",
-        "leaflet": "^1.8.0",
-        "mapbox-gl": "^2.9.1",
-        "microbundle": "^0.15.0",
-        "serve": "^13.0.4",
-        "ts-jest": "^28.0.5",
-        "ts-loader": "^9.3.1",
-        "typescript": "^4.7.4"
-    },
-    "commitlint": {
-        "extends": [
-            "@commitlint/config-conventional"
-        ]
-    },
-    "eslintConfig": {
-        "parser": "@typescript-eslint/parser",
-        "plugins": [
-            "@typescript-eslint"
-        ],
-        "rules": {
-            "indent": [
-                "error",
-                4
-            ],
-            "semi": [
-                "error",
-                "always"
-            ],
-            "@typescript-eslint/no-empty-function": "warn"
-        },
-        "extends": [
-            "plugin:@typescript-eslint/recommended",
-            "prettier"
-        ]
-    },
-    "prettier": {
-        "printWidth": 80,
-        "semi": true
-    }
-}
+	"name": "terra-draw",
+	"version": "0.0.1-alpha.41",
+	"description": "Frictionless map drawing across mapping provider",
+	"scripts": {
+		"docs": "typedoc",
+		"docs:serve": "serve ./docs",
+		"release": "standard-version",
+		"release:alpha:next": "ts-node --esm ./scripts/next-alpha-version.ts",
+		"build": "microbundle",
+		"watch": "microbundle --watch --format modern",
+		"test": "jest --config jest.config.ts",
+		"test:coverage": "jest --config jest.config.ts --coverage",
+		"test:nocheck": "NO_CHECK=true jest --config jest.config.ts",
+		"test:nocheck:coverage": "NO_CHECK=true jest --config jest.config.ts --coverage",
+		"lint": "eslint --ext .ts src/",
+		"lint:quiet": "eslint --ext .ts --quiet src/",
+		"lint:fix": "eslint --fix --ext .ts src/",
+		"lint:fix:quiet": "eslint --fix --quiet --ext .ts src/",
+		"format": "prettier --ignore-path .gitignore --write \"**/*.+(js|ts|json)\"",
+		"format:quiet": "prettier --ignore-path .gitignore --write \"**/*.+(js|ts|json)\" --loglevel=silent",
+		"prepare": "husky install"
+	},
+	"type": "module",
+	"source": "src/terra-draw.ts",
+	"exports": {
+		"types": "./dist/terra-draw.d.ts",
+		"require": "./dist/terra-draw.cjs",
+		"default": "./dist/terra-draw.modern.js"
+	},
+	"types": "./dist/terra-draw.d.ts",
+	"main": "./dist/terra-draw.cjs",
+	"module": "./dist/terra-draw.module.js",
+	"unpkg": "./dist/terra-draw.umd.js",
+	"author": "James Milner",
+	"license": "MIT",
+	"repository": "JamesLMilner/terra-draw",
+	"keywords": [
+		"map",
+		"drawing",
+		"draw",
+		"map drawing",
+		"geometry",
+		"leaflet",
+		"leafletjs",
+		"mapbox",
+		"mapboxgl",
+		"google maps",
+		"openlayers",
+		"maplibre"
+	],
+	"devDependencies": {
+		"@commitlint/cli": "^17.1.2",
+		"@commitlint/config-conventional": "^17.1.0",
+		"@googlemaps/js-api-loader": "^1.14.3",
+		"@swc/jest": "^0.2.24",
+		"@types/geojson": "^7946.0.8",
+		"@types/google.maps": "^3.49.2",
+		"@types/jest": "^28.1.5",
+		"@types/leaflet": "^1.7.11",
+		"@types/mapbox-gl": "^2.7.3",
+		"@types/rbush": "^3.0.0",
+		"@typescript-eslint/eslint-plugin": "^5.57.0",
+		"@typescript-eslint/parser": "^5.57.0",
+		"eslint": "^8.24.0",
+		"eslint-config-prettier": "^8.5.0",
+		"eslint-plugin-prettier": "^4.2.1",
+		"husky": "^7.0.0",
+		"jest": "^29.3.1",
+		"leaflet": "^1.8.0",
+		"mapbox-gl": "^2.13.0",
+		"maplibre-gl": "3.2.0",
+		"microbundle": "^0.15.0",
+		"ol": "^7.1.0",
+		"serve": "^14.1.2",
+		"standard-version": "^9.5.0",
+		"ts-jest": "^29.1.0",
+		"ts-loader": "^9.4.2",
+		"typedoc": "^0.23.28",
+		"typescript": "^5.0.3"
+	},
+	"commitlint": {
+		"extends": [
+			"@commitlint/config-conventional"
+		]
+	},
+	"eslintConfig": {
+		"parser": "@typescript-eslint/parser",
+		"plugins": [
+			"@typescript-eslint"
+		],
+		"rules": {
+			"@typescript-eslint/no-empty-function": "warn"
+		},
+		"extends": [
+			"plugin:@typescript-eslint/recommended",
+			"prettier"
+		]
+	},
+	"prettier": {
+		"printWidth": 80,
+		"semi": true,
+		"useTabs": true
+	},
+	"standard-version": {
+		"types": [
+			{
+				"type": "feat",
+				"section": "Features"
+			},
+			{
+				"type": "fix",
+				"section": "Bug Fixes"
+			},
+			{
+				"type": "docs",
+				"section": "Documentation"
+			},
+			{
+				"type": "style",
+				"section": "Styling"
+			},
+			{
+				"type": "refactor",
+				"section": "Refactors"
+			},
+			{
+				"type": "perf",
+				"section": "Performance"
+			},
+			{
+				"type": "test",
+				"section": "Tests"
+			},
+			{
+				"type": "build",
+				"section": "Build System"
+			},
+			{
+				"type": "ci",
+				"section": "CI"
+			},
+			{
+				"type": "chore",
+				"section": "Chore"
+			},
+			{
+				"type": "revert",
+				"section": "Reverts"
+			}
+		]
+	},
+	"dependencies": {
+		"ts-node": "^10.9.1"
+	}
+}

package/scripts/next-alpha-version.ts

@@ -0,0 +1,21 @@
+import { readFileSync } from "fs";
+
+const packageJson = JSON.parse(readFileSync("./package.json", "utf-8"));
+
+if (packageJson.version.includes("alpha")) {
+	const currentVersion = packageJson.version.split(".").pop();
+
+	if (
+		currentVersion === undefined ||
+		currentVersion === null ||
+		isNaN(currentVersion)
+	) {
+		throw new Error("Could not get current version number");
+	}
+
+	const nextVersion = parseInt(currentVersion) + 1;
+
+	console.log(nextVersion);
+} else {
+	throw new Error("This script is for alpha releases only");
+}

package/tsconfig.json

@@ -1,14 +1,22 @@
 {
-  "compilerOptions": {
-    "outDir": "./dist/",
-    "strict": true,
-    "noImplicitAny": true,
-    "module": "es6",
-    "target": "es6",
-    "jsx": "react",
-    "sourceMap": true,
-    "allowJs": true,
-    "moduleResolution": "node",
-    "allowSyntheticDefaultImports": true
-  }
+	"compilerOptions": {
+		"outDir": "./dist/",
+		"strict": true,
+		"module": "es6",
+		"target": "es6",
+		"jsx": "react",
+		"sourceMap": true,
+		"allowJs": true,
+		"moduleResolution": "node",
+		"allowSyntheticDefaultImports": true
+	},
+	"typedocOptions": {
+		"entryPoints": ["src/terra-draw.ts"],
+		"exclude": ["src/geometry/**/*.ts", "src/test/**/*.ts", "src/util/**/*.ts"],
+		"out": "docs",
+		"skipErrorChecking": true
+		// "compilerOptions": {
+		//     "skipLibCheck": true
+		// }
+	}
 }

package/DEVELOPMENT.md

@@ -1,77 +0,0 @@
-# Development
-
-This file acts as a way to document how to develop the Terra Draw project locally. 
-
-### Prerequisites
-
-A few things you will need to have installed in order to develop on this project:
-
-* git
-* Node LTS - currently v16
-* npm 8 
-
-### Folder Structure
-
-
-* `.github` - used for all GitHub related configuration such as the GitHub Actions work flows
-* `.husky` - used to storing the precommit hooks that are used on the project
-* `src` - source files for the project
-* `dist` - the bundled distributed files of the project
-* `docs` - the demo app that is published to GitHub pages
-* `development` - the local development app that is used for developing locally (see below)
-* `common` - code that is used across `development` and `docs` folder`
-
-### Technologies Used
-
-Terra Draw 
-
-* [TypeScript](https://www.typescriptlang.org/) - provides strong compile time typing for JavaScript
-* Jest - used for testing (see more information below)
-* microbundle - used for the production bundle
-* Webpack - used for bundling locally in development (`development` and `docs` folders)
-* esno - for running tests quickly without type checking
-
-### Precommit Hooks
-
-It is probably useful to be aware of the precommit hooks you will face when trying to run a git commit on the project. There are two currently in use, namely:
-
-* Uses pre-commit hook to run lint rules (eslint/prettier) on code before commit
-* Uses pre-commit hook to ensure [conventional commit messages](https://www.conventionalcommits.org/en/v1.0.0/) are used 
-
-### Testing
-
-Terra Draw uses [jest](https://jestjs.io/) as it's testing framework. You can distinguish a test by it's `.spec.ts` prefix on the file name.  
-
-To run the tests as they would run in CI:
-
-```
-npm run test
-```
-
-You can also check the coverage by running:
-
-
-```
-npm run test:coverage
-```
-
-For local development you may benefit from the `nocheck` option which allows you to avoid running TypeScript type checking when running the tests. This option also only checks files which are explicitly tested (i.e. have a spec file.)
-
-```
-npm run test:nocheck
-npm run test:nocheck:coverage
-```
-
-### Developing Locally
-
-A folder called `development` has been set up locally to allow you to test developing Terra Draw locally more easily. It allows you to run the different adapters and test different map providers in parallel, ensuring. You will need to update the .env file in the `development` folder in order to use the related adapters working. An example `.env` file in the `development` folder:
-
-
-```
-GOOGLE_API_KEY=YOUR_KEY_HERE
-MAPBOX_ACCESS_TOKEN=YOUR_KEY_HERE
-```
-
-### GitHub Pages Example
-
-We also provide a GitHub Pages example that can developed on in the `docs` folder. This automatically deploys from the `main` branch.

package/dist/bundle.js

@@ -1,6 +0,0 @@
-/******/ (() => { // webpackBootstrap
-/******/ 	"use strict";
-/******/ 	
-/******/ 	
-/******/ })()
-;

package/dist/bundle.js.LICENSE.txt

@@ -1,4 +0,0 @@
-/* @preserve
- * Leaflet 1.8.0, a JS library for interactive maps. https://leafletjs.com
- * (c) 2010-2022 Vladimir Agafonkin, (c) 2010-2011 CloudMade
- */

package/dist/geometry/create-circle.d.ts

@@ -1,6 +0,0 @@
-import { Feature, Polygon } from "geojson";
-export declare function circle(options: {
-    center: [number, number];
-    radiusKilometers: number;
-    steps?: number;
-}): Feature<Polygon>;

package/dist/geometry/get-pixel-distance-to-line.d.ts

@@ -1,10 +0,0 @@
-export declare const getPixelDistanceToLine: (point: {
-    x: number;
-    y: number;
-}, linePointOne: {
-    x: number;
-    y: number;
-}, linePointTwo: {
-    x: number;
-    y: number;
-}) => number;

package/dist/geometry/get-pixel-distance.d.ts

@@ -1,7 +0,0 @@
-export declare const getPixelDistance: (pointOne: {
-    x: number;
-    y: number;
-}, pointTwo: {
-    x: number;
-    y: number;
-}) => number;

package/dist/geometry/haversine-distance.d.ts

@@ -1 +0,0 @@
-export declare function haversineDistanceKilometers(pointOne: [lng: number, lat: number], pointTwo: [lng: number, lat: number]): number;

package/dist/geometry/point-in-polygon.d.ts

@@ -1 +0,0 @@
-export declare function pointInPolygon(point: [number, number], rings: [number, number][][]): boolean;

package/dist/geometry/self-intersects.d.ts

@@ -1,2 +0,0 @@
-import { Feature, LineString, Polygon } from "geojson";
-export declare function selfIntersects(feature: Feature<Polygon> | Feature<LineString>): boolean;

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

@@ -1,18 +0,0 @@
-import { TerraDrawMouseEvent, TerraDrawMode, TerraDrawModeRegisterConfig, TerraDrawAdapterStyling, TerraDrawKeyboardEvent } from "../common";
-export declare class TerraDrawCircleMode implements TerraDrawMode {
-    mode: string;
-    private store;
-    private project;
-    private center;
-    private clickCount;
-    private currentCircleId;
-    constructor(options?: {
-        styling?: Partial<TerraDrawAdapterStyling>;
-    });
-    styling: TerraDrawAdapterStyling;
-    register(config: TerraDrawModeRegisterConfig): void;
-    onClick(event: TerraDrawMouseEvent): void;
-    onMouseMove(event: TerraDrawMouseEvent): void;
-    onKeyPress(event: TerraDrawKeyboardEvent): void;
-    cleanUp(): void;
-}

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

@@ -1,20 +0,0 @@
-import { TerraDrawMouseEvent, TerraDrawMode, TerraDrawModeRegisterConfig, TerraDrawAdapterStyling, TerraDrawKeyboardEvent } from "../common";
-export declare class TerraDrawFreehandMode implements TerraDrawMode {
-    mode: string;
-    private store;
-    private project;
-    private startingClick;
-    private currentId;
-    private skip;
-    private everyNthMouseEvent;
-    constructor(options?: {
-        styling?: Partial<TerraDrawAdapterStyling>;
-        everyNthMouseEvent?: number;
-    });
-    styling: TerraDrawAdapterStyling;
-    register(config: TerraDrawModeRegisterConfig): void;
-    onMouseMove(event: TerraDrawMouseEvent): void;
-    onClick(event: TerraDrawMouseEvent): void;
-    onKeyPress(event: TerraDrawKeyboardEvent): void;
-    cleanUp(): void;
-}

package/dist/modes/line-string.mode.d.ts

@@ -1,21 +0,0 @@
-import { TerraDrawMouseEvent, TerraDrawMode, TerraDrawModeRegisterConfig, TerraDrawAdapterStyling, TerraDrawKeyboardEvent } from "../common";
-export declare class TerraDrawLineStringMode implements TerraDrawMode {
-    mode: string;
-    private store;
-    private project;
-    private pointerDistance;
-    private currentCoordinate;
-    private currentId;
-    private allowSelfIntersections;
-    constructor(options?: {
-        allowSelfIntersections?: boolean;
-        styling?: Partial<TerraDrawAdapterStyling>;
-        pointerDistance?: number;
-    });
-    styling: TerraDrawAdapterStyling;
-    register(config: TerraDrawModeRegisterConfig): void;
-    onMouseMove(event: TerraDrawMouseEvent): void;
-    onClick(event: TerraDrawMouseEvent): void;
-    onKeyPress(event: TerraDrawKeyboardEvent): void;
-    cleanUp(): void;
-}

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

@@ -1,14 +0,0 @@
-import { TerraDrawMouseEvent, TerraDrawMode, TerraDrawModeRegisterConfig, TerraDrawAdapterStyling } from "../common";
-export declare class TerraDrawPointMode implements TerraDrawMode {
-    mode: string;
-    private store;
-    constructor(options?: {
-        styling?: Partial<TerraDrawAdapterStyling>;
-    });
-    styling: TerraDrawAdapterStyling;
-    register(config: TerraDrawModeRegisterConfig): void;
-    onClick(event: TerraDrawMouseEvent): void;
-    onMouseMove(): void;
-    onKeyPress(): void;
-    cleanUp(): void;
-}

package/dist/modes/polygon/behaviors/start-end-point.behavior.d.ts

@@ -1,11 +0,0 @@
-import { Position } from "geojson";
-import { BehaviorConfig, TerraDrawModeBehavior } from "../../base.behavior";
-export declare class StartEndPointBehavior extends TerraDrawModeBehavior {
-    constructor(config: BehaviorConfig);
-    private _startEndPoints;
-    get ids(): string[];
-    set ids(_: string[]);
-    create(selectedCoords: Position[], mode: string): void;
-    delete(): void;
-    update(updatedCoordinates: Position[]): void;
-}

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

@@ -1,21 +0,0 @@
-import { TerraDrawMouseEvent, TerraDrawMode, TerraDrawModeRegisterConfig, TerraDrawAdapterStyling, TerraDrawKeyboardEvent } from "../common";
-export declare class TerraDrawPolygonMode implements TerraDrawMode {
-    mode: string;
-    private store;
-    private project;
-    private currentCoordinate;
-    private currentId;
-    private allowSelfIntersections;
-    private pointerDistance;
-    constructor(options?: {
-        allowSelfIntersections?: boolean;
-        styling?: Partial<TerraDrawAdapterStyling>;
-        pointerDistance?: number;
-    });
-    styling: TerraDrawAdapterStyling;
-    register(config: TerraDrawModeRegisterConfig): void;
-    onMouseMove(event: TerraDrawMouseEvent): void;
-    onClick(event: TerraDrawMouseEvent): void;
-    onKeyPress(event: TerraDrawKeyboardEvent): void;
-    cleanUp(): void;
-}

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

@@ -1,21 +0,0 @@
-import { TerraDrawMouseEvent, TerraDrawMode, TerraDrawModeRegisterConfig, TerraDrawKeyboardEvent, TerraDrawAdapterStyling } from "../common";
-export declare class TerraDrawSelectMode implements TerraDrawMode {
-    mode: string;
-    private store;
-    private project;
-    private selected;
-    private pointerDistance;
-    private selectionPoints;
-    constructor(options?: {
-        styling?: Partial<TerraDrawAdapterStyling>;
-        pointerDistance?: number;
-    });
-    styling: TerraDrawAdapterStyling;
-    onClick(event: TerraDrawMouseEvent): void;
-    onKeyPress(event: TerraDrawKeyboardEvent): void;
-    cleanUp(): void;
-    onMouseMove(): void;
-    register(config: TerraDrawModeRegisterConfig): void;
-    onDeselect(deselectedId: string): void;
-    onSelect(selectedId: string): void;
-}

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

@@ -1,10 +0,0 @@
-import { TerraDrawAdapterStyling, TerraDrawMode } from "../common";
-export declare class TerraDrawStaticMode implements TerraDrawMode {
-    mode: string;
-    styling: TerraDrawAdapterStyling;
-    register(): void;
-    onKeyPress(): void;
-    onClick(): void;
-    onMouseMove(): void;
-    cleanUp(): void;
-}