Complete rewrite (TypeScript)

.commitlintrc.json

@@ -0,0 +1,23 @@
+{
+  "extends": ["@commitlint/config-conventional"],
+  "rules": {
+    "type-enum": [
+			2,
+			"always",
+			[
+				"build",
+				"chore",
+				"ci",
+				"docs",
+				"feat",
+				"fix",
+				"perf",
+				"refactor",
+				"revert",
+				"style",
+				"test",
+        "website"
+			]
+		]
+  }
+}

.editorconfig

@@ -0,0 +1,11 @@
+root = true
+
+[*]
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.{ts,json}]
+indent_style = space
+indent_size = 2

.eslintrc

@@ -0,0 +1,42 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "extends": [
+    "airbnb-base",
+    "plugin:@typescript-eslint/recommended",
+    "prettier",
+    "prettier/@typescript-eslint"
+  ],
+  "env": {
+    "browser": true
+  },
+  "plugins": ["prettier"],
+  "ignorePatterns": ["/types/**/*.ts", "/website/vendor/**/*"],
+  "rules": {
+    "prettier/prettier": ["error"],
+    "@typescript-eslint/no-unused-vars": ["error", { "ignoreRestSiblings": true }],
+    "import/extensions": [
+      "error",
+      "ignorePackages",
+      {
+        "js": "never",
+        "mjs": "never",
+        "jsx": "never",
+        "ts": "never",
+        "tsx": "never"
+      }
+    ]
+  },
+  "overrides": [
+    {
+      "files": ["spec/**/*.ts"],
+      "rules": {
+        "import/no-unresolved": "off"
+      }
+    }
+  ],
+  "settings": {
+    "import/resolver": {
+      "typescript": {}
+    }
+  }
+}

.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: Continuous Integration
+
+on:
+  - pull_request
+  - push
+
+jobs:
+  ci:
+    name: Continuous integration
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Setup Node
+        uses: actions/setup-node@v2-beta
+        with:
+          node-version: "14"
+      - name: Install dependencies
+        run: npm install
+      - name: Check build
+        run: npm run build
+      - name: Check commit messages
+        uses: wagoid/commitlint-github-action@v2
+        with:
+          configFile: .commitlintrc.json
+      - name: Check coding standards
+        run: npm run lint
+      - name: Run tests
+        run: npm test

.github/workflows/coverage.yml

@@ -0,0 +1,26 @@
+name: Coverage
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  coverage:
+    name: Measure coverage and upload it
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Setup Node
+        uses: actions/setup-node@v2-beta
+        with:
+          node-version: "14"
+      - name: Install dependencies
+        run: npm install
+      - name: Run tests with coverage
+        run: npm run coverage-lcov
+      - name: Upload coverage
+        uses: codecov/codecov-action@v1
+        with:
+          directory: ./coverage

.github/workflows/deploy-website.yml

@@ -0,0 +1,32 @@
+name: Deploy website
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  couscous:
+    name: Deploy website with Couscous
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: "7.4"
+          tools: composer
+      - name: Setup Node
+        uses: actions/setup-node@v2-beta
+        with:
+          node-version: "14"
+      - name: Setup Couscous
+        run: composer global require couscous/couscous:dev-master
+      - name: Couscous
+        run: couscous generate
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./.couscous/generated

.github/workflows/release.yml

@@ -0,0 +1,48 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    name: Create and publish a release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Setup Node (npm registry)
+        uses: actions/setup-node@v2-beta
+        with:
+          node-version: "14"
+          registry-url: https://registry.npmjs.org
+      - name: Install dependencies
+        run: npm install
+      - name: Run tests
+        run: npm test
+      - name: Create a GitHub release
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: ${{ github.ref }}
+          release_name: Release ${{ github.ref }}
+      - name: Publish to npm
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      - name: Setup Node (GitHub registry)
+        uses: actions/setup-node@v2-beta
+        with:
+          node-version: "14"
+          registry-url: https://npm.pkg.github.com
+      - name: Change package name
+        uses: datamonsters/replace-action@v2
+        with:
+          files: package.json
+          replacements: '"geocoder-js"="@geocoder-php/geocoder-js"'
+      - name: Publish to GitHub
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,5 +1,10 @@
-.idea
-lib
 node_modules
-.grunt
-.DS_Store
+/.couscous
+/.nyc_output
+/coverage
+/dist
+/types
+/website/vendor
+/website/webfonts
+/website/package-lock.json
+/website/yarn.lock

.nycrc.json

@@ -0,0 +1,4 @@
+{
+  "cache": false,
+  "exclude": ["spec/**", "**/index.ts", "**/AdminLevel.ts", "**/*Geocoded.ts", "**/*GeocodeQuery.ts", "**/*ReverseQuery.ts", "**/ResponseError.ts", "src/provider/mapquest/MapQuestLocation.ts"]
+}

CHANGELOG.md

@@ -0,0 +1,78 @@
+# Changelog
+
+## 0.8.0
+
+* [Bing] Better Bing provider
+* [Mapbox] Add `fuzzyMatch` geocode parameter
+* [OpenCage] Add `precision` to `OpenCageGeocoded`
+* [OpenCage] Replace `minConfidence` with `minPrecision` for geocode and geodecode
+
+## 0.7.0
+
+* [Yandex] Better Yandex provider
+* [Nominatim] Remove `viewBox` parameter in `GeocodeQuery` to use `bounds` instead
+* [GeoJsonDumper] Use `bbox` member for `bounds`
+* The `bounds` parameter in `GeocodeQuery` is now an object with `latitudeSW`, `longitudeSW`, `latitudeNE`, `longitudeNE` keys
+* The `latitude` and `longitude` parameters in `GeocodeQuery` are replaced by a `coordinates` parameter (an object with `latitude` and `longitude` keys)
+* `Geocoded` returns an object with `latitudeSW`, `longitudeSW`, `latitudeNE`, `longitudeNE` keys for the `bounds`
+* The `latitude` and `longitude` parameters in `Geocoded` are replaced by a `coordinates` parameter (an object with `latitude` and `longitude` keys)
+
+## 0.6.0
+
+* [MapQuest] Better MapQuest provider
+
+## 0.5.0
+
+* Add special chain provider
+* Add GeoPlugin provider
+* Add `errorCallback` parameter to `geocode` and `geodecode`
+* Add `body` parameter to `executeRequest`
+* [MapQuest] Fix geocode request (bad encoded query)
+
+## 0.4.0
+
+* [Google] Better Google Maps provider
+* [Nominatim] Better handling of geodecode errors
+* [ExternalLoader] Add `getOptions` method to interface
+* [ExternalLoader] Rename `JSONPCallback` in params to `jsonpCallback`
+* Rename `GoogleAPIProvider` to `GoogleMapsProvider`
+* Add Node examples
+
+## 0.3.0
+
+* Add OpenCage Provider
+* Add time zone to `Geocoded`
+* [Mapbox] Add `countryCodes`, `proximity` and `reverseMode` to geo(de)code parameters
+* [Mapbox] Add `resultType` to `Geocoded`
+* [Mapbox] Add admin levels to `Geocoded`
+* Rename `ExternalURILoader` to `ExternalLoader`
+
+## 0.2.4
+
+* [Nominatim] Fix error when no result is received
+
+## 0.2.3
+
+* Fix TypeScript types for the library to be usable in a TS project
+
+## 0.2.2
+
+* Use relative paths for build files
+
+## 0.2.1
+
+* Missing types folder when publishing
+
+## 0.2.0
+
+* Better Nominatim support
+* Better GeoJSON support
+
+## 0.1.0
+
+* Library rewritten in TypeScript
+* Library can be used as a module as well
+* Add Mapbox provider
+* Formatted address, bounds and country support
+* Better handling of provider options (JSONP, SSL)
+* The methods `geocode` and `geodecode` can take an object or a `Query`

CONTRIBUTING.md

@@ -0,0 +1,6 @@
+Pull requests will **not** be accepted without:
+
+1) All unit/functional tests working.
+2) Any potentially affected example files still functional.
+3) Any additional functionality covered by unit/functional tests.
+4) Code should be linted without errors (`npm run lint`).