proj4 2.20.7 → 2.20.9

package/PUBLISHING.md

@@ -5,7 +5,7 @@ Publishing
 
 1. Make sure you have the latest from the main branch:
 
-       git pull origin master
+       git pull origin main
 
 2. Update `changelog.md` with the changes since the last release, then commit:
 
@@ -31,4 +31,4 @@ Publishing
        npm version x.y.(z+1)-alpha --no-git-tag-version
        git add package.json package-lock.json
        git commit -m 'update version to x.y.(z+1)-alpha'
-       git push origin master
+       git push origin main

package/README.md

@@ -14,7 +14,11 @@ npm install proj4
 
 or download `dist.zip` from the [latest release](https://github.com/proj4js/proj4js/releases) and grab `proj4.js` from it.
 
-If you do not want to download anything, Proj4js is also hosted on [cdnjs](https://www.cdnjs.com/libraries/proj4js) for direct use in your browser applications.
+If you do not want to download anything, Proj4js is also available via [jsDelivr](https://www.jsdelivr.com/package/npm/proj4) for direct use in your browser applications:
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/proj4/dist/proj4.js"></script>
+```
 
 ## Using
 

package/changelog.md

@@ -1,5 +1,9 @@
 ## Change log
 
+- 2.20.9: Add Eckert VI (eck6) projection; add geotiff@3 support (geotiff is now an optional peer dependency); fix unknown datum handling to match PROJ behavior; fix gamma without alpha in omerc; fix ob_tran lam offset and +over handling; fix enforceAxis for z and arbitrary axis orders
+
+- 2.20.8: Add back TypeScript type definitions to the npm package (accidentally removed in 2.20.7)
+
 - 2.20.7: GitHub releases now contain a separate dist.zip file, so users don't have to find the dist folder in the downloaded source code any more; removed bower.json and component.json; trusted OIDC publishing for the npm package; added security policy; vitest instead of mocha for the tests; removed grunt; renamed main branch to main
 
 - 2.20.0: Include WGS84 UTM zones 1-60 North/South and WGS84 UPS North/South; add support for `+over`; add general oblique transformation; make projjson work with `proj4.defs(code, projjson)`

package/dist/lib/Point.d.ts

@@ -0,0 +1,24 @@
+export default Point;
+/**
+ * @deprecated v3.0.0 - use proj4.toPoint instead
+ * @param {number | import('./core').TemplateCoordinates | string} x
+ * @param {number} [y]
+ * @param {number} [z]
+ */
+declare function Point(x: number | import("./core").TemplateCoordinates | string, y?: number, z?: number): Point;
+declare class Point {
+    /**
+     * @deprecated v3.0.0 - use proj4.toPoint instead
+     * @param {number | import('./core').TemplateCoordinates | string} x
+     * @param {number} [y]
+     * @param {number} [z]
+     */
+    constructor(x: number | import("./core").TemplateCoordinates | string, y?: number, z?: number);
+    x: string | number;
+    y: number;
+    z: number;
+    toMGRS(accuracy: any): any;
+}
+declare namespace Point {
+    function fromMGRS(mgrsStr: any): Point;
+}

package/dist/lib/Proj.d.ts

@@ -0,0 +1,77 @@
+export default Projection;
+export type DatumDefinition = {
+    /**
+     * - The type of datum.
+     */
+    datum_type: number;
+    /**
+     * - Semi-major axis of the ellipsoid.
+     */
+    a: number;
+    /**
+     * - Semi-minor axis of the ellipsoid.
+     */
+    b: number;
+    /**
+     * - Eccentricity squared of the ellipsoid.
+     */
+    es: number;
+    /**
+     * - Second eccentricity squared of the ellipsoid.
+     */
+    ep2: number;
+};
+/**
+ * @typedef {Object} DatumDefinition
+ * @property {number} datum_type - The type of datum.
+ * @property {number} a - Semi-major axis of the ellipsoid.
+ * @property {number} b - Semi-minor axis of the ellipsoid.
+ * @property {number} es - Eccentricity squared of the ellipsoid.
+ * @property {number} ep2 - Second eccentricity squared of the ellipsoid.
+ */
+/**
+ * @param {string | import('./core').PROJJSONDefinition | import('./defs').ProjectionDefinition} srsCode
+ * @param {(errorMessage?: string, instance?: Projection) => void} [callback]
+ */
+declare function Projection(srsCode: string | import("./core").PROJJSONDefinition | import("./defs").ProjectionDefinition, callback?: (errorMessage?: string, instance?: Projection) => void): Projection;
+declare class Projection {
+    /**
+     * @typedef {Object} DatumDefinition
+     * @property {number} datum_type - The type of datum.
+     * @property {number} a - Semi-major axis of the ellipsoid.
+     * @property {number} b - Semi-minor axis of the ellipsoid.
+     * @property {number} es - Eccentricity squared of the ellipsoid.
+     * @property {number} ep2 - Second eccentricity squared of the ellipsoid.
+     */
+    /**
+     * @param {string | import('./core').PROJJSONDefinition | import('./defs').ProjectionDefinition} srsCode
+     * @param {(errorMessage?: string, instance?: Projection) => void} [callback]
+     */
+    constructor(srsCode: string | import("./core").PROJJSONDefinition | import("./defs").ProjectionDefinition, callback?: (errorMessage?: string, instance?: Projection) => void);
+    /** @type {<T extends import('./core').TemplateCoordinates>(coordinates: T, enforceAxis?: boolean) => T} */
+    forward: <T extends import("./core").TemplateCoordinates>(coordinates: T, enforceAxis?: boolean) => T;
+    /** @type {<T extends import('./core').TemplateCoordinates>(coordinates: T, enforceAxis?: boolean) => T} */
+    inverse: <T extends import("./core").TemplateCoordinates>(coordinates: T, enforceAxis?: boolean) => T;
+    /** @type {function(): void} */
+    init: () => void;
+    /** @type {string} */
+    name: string;
+    /** @type {string} */
+    axis: string;
+    /** @type {Array<string>} */
+    names: Array<string>;
+    /** @type {string} */
+    title: string;
+    a: any;
+    b: any;
+    rf: any;
+    sphere: any;
+    es: number;
+    e: number;
+    ep2: number;
+    datum: DatumDefinition;
+}
+declare namespace Projection {
+    export { projections };
+}
+import projections from './projections';

package/dist/lib/adjust_axis.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Convert a point in a given CRS axis order to ENU (east/north/up) order
+ * @param {import('./defs').ProjectionDefinition} crs
+ * @param {import('./core').InterfaceCoordinates} point
+ * @returns {import('./core').InterfaceCoordinates | null}
+ */
+export function adjustAxisToEnu(crs: import("./defs").ProjectionDefinition, point: import("./core").InterfaceCoordinates): import("./core").InterfaceCoordinates | null;
+/**
+ * Convert a point in ENU (east/north/up) order to the given CRS axis order.
+ * @param {import('./defs').ProjectionDefinition} crs
+ * @param {import('./core').InterfaceCoordinates} point
+ * @returns {import('./core').InterfaceCoordinates | null}
+ */
+export function adjustAxisFromEnu(crs: import("./defs").ProjectionDefinition, point: import("./core").InterfaceCoordinates): import("./core").InterfaceCoordinates | null;

package/dist/lib/checkSanity.d.ts

@@ -0,0 +1 @@
+export default function _default(point: any): void;

package/dist/lib/common/acosh.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): number;

package/dist/lib/common/adjust_lat.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): any;

package/dist/lib/common/adjust_lon.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any, skipAdjust: any): any;

package/dist/lib/common/adjust_zone.d.ts

@@ -0,0 +1 @@
+export default function _default(zone: any, lon: any): any;

package/dist/lib/common/asinh.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): number;

package/dist/lib/common/asinhy.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): number;

package/dist/lib/common/asinz.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): number;

package/dist/lib/common/atanh.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): number;

package/dist/lib/common/authlat.d.ts

@@ -0,0 +1 @@
+export default function authlat(beta: any, APA: any): any;

package/dist/lib/common/authset.d.ts

@@ -0,0 +1 @@
+export default function authset(es: any): number[];

package/dist/lib/common/clens.d.ts

@@ -0,0 +1 @@
+export default function _default(pp: any, arg_r: any): number;

package/dist/lib/common/clens_cmplx.d.ts

@@ -0,0 +1 @@
+export default function _default(pp: any, arg_r: any, arg_i: any): number[];

package/dist/lib/common/cosh.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): number;

package/dist/lib/common/e0fn.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): number;

package/dist/lib/common/e1fn.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): number;

package/dist/lib/common/e2fn.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): number;

package/dist/lib/common/e3fn.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): number;

package/dist/lib/common/fL.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any, L: any): number;

package/dist/lib/common/gN.d.ts

@@ -0,0 +1 @@
+export default function _default(a: any, e: any, sinphi: any): number;

package/dist/lib/common/gatg.d.ts

@@ -0,0 +1 @@
+export default function _default(pp: any, B: any): any;

package/dist/lib/common/hypot.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any, y: any): number;

package/dist/lib/common/imlfn.d.ts

@@ -0,0 +1 @@
+export default function _default(ml: any, e0: any, e1: any, e2: any, e3: any): number;

package/dist/lib/common/invlatiso.d.ts

@@ -0,0 +1 @@
+export default function _default(eccent: any, ts: any): number;

package/dist/lib/common/iqsfnz.d.ts

@@ -0,0 +1 @@
+export default function _default(eccent: any, q: any): number;

package/dist/lib/common/latiso.d.ts

@@ -0,0 +1 @@
+export default function _default(eccent: any, phi: any, sinphi: any): number;

package/dist/lib/common/log1py.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): any;

package/dist/lib/common/mlfn.d.ts

@@ -0,0 +1 @@
+export default function _default(e0: any, e1: any, e2: any, e3: any, phi: any): number;

package/dist/lib/common/msfnz.d.ts

@@ -0,0 +1 @@
+export default function _default(eccent: any, sinphi: any, cosphi: any): number;

package/dist/lib/common/phi2z.d.ts

@@ -0,0 +1 @@
+export default function _default(eccent: any, ts: any): number;

package/dist/lib/common/pj_enfn.d.ts

@@ -0,0 +1 @@
+export default function _default(es: any): number[];

package/dist/lib/common/pj_inv_mlfn.d.ts

@@ -0,0 +1 @@
+export default function _default(arg: any, es: any, en: any): any;

package/dist/lib/common/pj_mlfn.d.ts

@@ -0,0 +1 @@
+export default function _default(phi: any, sphi: any, cphi: any, en: any): number;

package/dist/lib/common/qsfnz.d.ts

@@ -0,0 +1 @@
+export default function _default(eccent: any, sinphi: any): number;

package/dist/lib/common/sign.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): 1 | -1;

package/dist/lib/common/sinh.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): number;

package/dist/lib/common/srat.d.ts

@@ -0,0 +1 @@
+export default function _default(esinp: any, exp: any): number;

package/dist/lib/common/tanh.d.ts

@@ -0,0 +1 @@
+export default function _default(x: any): number;

package/dist/lib/common/toPoint.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @param {Array<number>} array
+ * @returns {import("../core").InterfaceCoordinates}
+ */
+export default function _default(array: Array<number>): import("../core").InterfaceCoordinates;

package/dist/lib/common/tsfnz.d.ts

@@ -0,0 +1 @@
+export default function _default(eccent: any, phi: any, sinphi: any): number;

package/dist/lib/common/vincenty.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Calculates the inverse geodesic problem using Vincenty's formulae.
+ * Computes the forward azimuth and ellipsoidal distance between two points
+ * specified by latitude and longitude on the surface of an ellipsoid.
+ *
+ * @param {number} lat1 Latitude of the first point in radians.
+ * @param {number} lon1 Longitude of the first point in radians.
+ * @param {number} lat2 Latitude of the second point in radians.
+ * @param {number} lon2 Longitude of the second point in radians.
+ * @param {number} a Semi-major axis of the ellipsoid (meters).
+ * @param {number} f Flattening of the ellipsoid.
+ * @returns {{ azi1: number, s12: number }} An object containing:
+ *   - azi1: Forward azimuth from the first point to the second point (radians).
+ *   - s12: Ellipsoidal distance between the two points (meters).
+ */
+export function vincentyInverse(lat1: number, lon1: number, lat2: number, lon2: number, a: number, f: number): {
+    azi1: number;
+    s12: number;
+};
+/**
+ * Solves the direct geodetic problem using Vincenty's formulae.
+ * Given a starting point, initial azimuth, and distance, computes the destination point on the ellipsoid.
+ *
+ * @param {number} lat1 Latitude of the starting point in radians.
+ * @param {number} lon1 Longitude of the starting point in radians.
+ * @param {number} azi1 Initial azimuth (forward azimuth) in radians.
+ * @param {number} s12 Distance to travel from the starting point in meters.
+ * @param {number} a Semi-major axis of the ellipsoid in meters.
+ * @param {number} f Flattening of the ellipsoid.
+ * @returns {{lat2: number, lon2: number}} The latitude and longitude (in radians) of the destination point.
+ */
+export function vincentyDirect(lat1: number, lon1: number, azi1: number, s12: number, a: number, f: number): {
+    lat2: number;
+    lon2: number;
+};