Improve NearestPoint type for @turf/nearest-point so that it keeps the properties of the points in the FeatureCollection

[EmilJunker]

Please provide the following when creating a PR:

• Confirmation you've read the steps for preparing a pull request.

This PR improves the NearestPoint type and the type definition for the nearestPoint function.

Consider the following example in TypeScript:

const coordinatesList = [[0, 0], [1, 1], [0, 1]];
const pointsList = coordinatesList.map((coordinate, i) => {
    return turf.point(coordinate, {
        name: `point${i}`
    });
});
const pointsCollection = turf.featureCollection(pointsList);
const myNearestPoint = turf.nearestPoint(turf.point([2, 2]), pointsCollection);

With the old behaviour myNearestPoint.properties.name is of type any according to TypeScript.

With the changes in this PR, the type of myNearestPoint.properties.name is correctly inferred as string.

This change should be non-breaking.

[twelch]

Thanks for the PR @EmilJunker! Your addition looks really close. I see a couple of errors if you run pnpm install at the top-level of your local repo.

index.ts(7,28): error TS2304: Cannot find name 'GeoJsonProperties'.

It looks like if you add an import at the top
import { Feature, FeatureCollection, Point, GeoJsonProperties } from "geojson";

and additionally extend P as well as assigning a default value:
function nearestPoint<P extends GeoJsonProperties = GeoJsonProperties>(

Then you should be in business. Could you make these changes and ping back for another check?

Be sure to run both pnpm install and pnpm test at the top level to make sure everything is passing per the guidelines