proj4 2.15.0 → 2.16.1

package/.nyc_output/f4b0e40f-04ca-4b6d-bfeb-51d617db9841.json

@@ -0,0 +1 @@
+{}

package/.nyc_output/processinfo/6b047fc9-1bf2-4565-9e8a-9c0defc09dd7.json

@@ -0,0 +1 @@
+{"parent":null,"pid":90528,"argv":["/Users/ahocevar/.nvm/versions/node/v22.13.0/bin/node","/Users/ahocevar/.nvm/versions/node/v22.13.0/bin/npm","run","test:ci"],"execArgv":[],"cwd":"/Users/ahocevar/projects/proj4js","time":1739305208087,"ppid":90520,"coverageFilename":"/Users/ahocevar/projects/proj4js/.nyc_output/6b047fc9-1bf2-4565-9e8a-9c0defc09dd7.json","externalId":"","uuid":"6b047fc9-1bf2-4565-9e8a-9c0defc09dd7","files":[]}

package/.nyc_output/processinfo/e2c5d0cc-9478-4f26-ad2f-de246d4c35de.json

@@ -0,0 +1 @@
+{"parent":"f4b0e40f-04ca-4b6d-bfeb-51d617db9841","pid":90576,"argv":["/Users/ahocevar/.nvm/versions/node/v22.13.0/bin/node","/Users/ahocevar/projects/proj4js/node_modules/.bin/mocha","test/test-ci.mjs"],"execArgv":[],"cwd":"/Users/ahocevar/projects/proj4js","time":1739305208556,"ppid":90549,"coverageFilename":"/Users/ahocevar/projects/proj4js/.nyc_output/e2c5d0cc-9478-4f26-ad2f-de246d4c35de.json","externalId":"","uuid":"e2c5d0cc-9478-4f26-ad2f-de246d4c35de","files":["/Users/ahocevar/projects/proj4js/dist/proj4-src.js"]}

package/.nyc_output/processinfo/f4b0e40f-04ca-4b6d-bfeb-51d617db9841.json

@@ -0,0 +1 @@
+{"parent":"6b047fc9-1bf2-4565-9e8a-9c0defc09dd7","pid":90549,"argv":["/Users/ahocevar/.nvm/versions/node/v22.13.0/bin/node","/Users/ahocevar/.nvm/versions/node/v22.13.0/lib/node_modules/npm/bin/npm-cli.js","exec","--yes","--","mocha","test/test-ci.mjs"],"execArgv":[],"cwd":"/Users/ahocevar/projects/proj4js","time":1739305208222,"ppid":90528,"coverageFilename":"/Users/ahocevar/projects/proj4js/.nyc_output/f4b0e40f-04ca-4b6d-bfeb-51d617db9841.json","externalId":"","uuid":"f4b0e40f-04ca-4b6d-bfeb-51d617db9841","files":[]}

package/.nyc_output/processinfo/index.json

@@ -0,0 +1 @@
+{"processes":{"6b047fc9-1bf2-4565-9e8a-9c0defc09dd7":{"parent":null,"children":["f4b0e40f-04ca-4b6d-bfeb-51d617db9841"]},"e2c5d0cc-9478-4f26-ad2f-de246d4c35de":{"parent":"f4b0e40f-04ca-4b6d-bfeb-51d617db9841","children":[]},"f4b0e40f-04ca-4b6d-bfeb-51d617db9841":{"parent":"6b047fc9-1bf2-4565-9e8a-9c0defc09dd7","children":["e2c5d0cc-9478-4f26-ad2f-de246d4c35de"]}},"files":{"/Users/ahocevar/projects/proj4js/dist/proj4-src.js":["e2c5d0cc-9478-4f26-ad2f-de246d4c35de"]},"externalIds":{}}

package/Gruntfile.js

@@ -1,8 +1,3 @@
-var json = require('rollup-plugin-json');
-var nodeResolve = require('rollup-plugin-node-resolve');
-var replace = require('rollup-plugin-replace');
-var pkg = require('./package.json');
-
 var projs = [
   'tmerc',
   'etmerc',
@@ -38,91 +33,32 @@ var projs = [
 ];
 module.exports = function (grunt) {
   grunt.initConfig({
-    pkg: grunt.file.readJSON('package.json'),
-    connect: {
-      server: {
-        options: {
-          port: process.env.PORT || 8080,
-          base: '.'
-        }
-      }
-    },
-    mocha_phantomjs: {
-      all: {
-        options: {
-          reporter: "dot",
-          urls: [ //my ide requries process.env.IP and PORT
-            "http://" + (process.env.IP || "127.0.0.1") + ":" + (process.env.PORT || "8080") + "/test/amd.html",
-            "http://" + (process.env.IP || "127.0.0.1") + ":" + (process.env.PORT || "8080") + "/test/opt.html"
-          ]
-        }
-      }
-    },
-    jshint: {
-      options: {
-        jshintrc: "./.jshintrc"
-      },
-      all: ['./lib/*.js', './lib/*/*.js']
-    },
-    rollup: {
-      options: {
-        format: "umd",
-        moduleName: "proj4",
-        plugins: [
-          replace({
-            __VERSION__: pkg.version
-          }),
-          json(),
-          nodeResolve()
-        ]
-      },
-      files: {
-        dest: './dist/proj4-src.js',
-        src: './lib/index.js',
-      },
-    },
-    uglify: {
-      options: {
-        report: 'gzip',
-        mangle:{
-          reserved: ['proj4','Projection','Point']
-        },
-      },
-      all: {
-        src: 'dist/proj4-src.js',
-        dest: 'dist/proj4.js'
-      }
-    }
+    pkg: grunt.file.readJSON('package.json')
   });
-  grunt.loadNpmTasks('grunt-rollup');
-  grunt.loadNpmTasks('grunt-contrib-uglify');
-  grunt.loadNpmTasks('grunt-contrib-jshint');
-  grunt.loadNpmTasks('grunt-contrib-connect');
-  grunt.loadNpmTasks('grunt-mocha-phantomjs');
-  grunt.registerTask('custom',function(){
-    grunt.task.run('rollup', 'uglify');
+
+  grunt.registerTask('custom', function () {
     var projections = this.args;
-    if(projections[0]==='default'){
-      grunt.file.write('./projs.js','export default function(){}');
+    if (projections[0] === 'default') {
+      grunt.file.write('./projs.js', 'export default function(){}');
       return;
     }
-    if(projections[0]==='all'){
+    if (projections[0] === 'all') {
       projections = projs;
     }
-    grunt.file.write('./projs.js',[
-      projections.map(function(proj) {
-        return "import " + proj + " from './lib/projections/" + proj + "';";
-      }).join("\n"),
-      "export default function(proj4){",
-      projections.map(function(proj) {
-        return "  proj4.Proj.projections.add(" + proj + ");"
-      }).join("\n"),
-      "}"
-    ].join("\n"));
+    grunt.file.write('./projs.js', [
+      projections.map(function (proj) {
+        return 'import ' + proj + ' from \'./lib/projections/' + proj + '\';';
+      }).join('\n'),
+      'export default function (proj4) {',
+      projections.map(function (proj) {
+        return '  proj4.Proj.projections.add(' + proj + ');';
+      }).join('\n'),
+      '}', ''
+    ].join('\n'));
   });
-  grunt.registerTask('build',function(){
-    var args = this.args.length?this.args[0].split(','):['default'];
-    grunt.task.run('jshint', 'custom:'+args.join(':'));
+  grunt.registerTask('build', function () {
+    var args = this.args.length ? this.args[0].split(',') : ['default'];
+    grunt.task.run('custom:' + args.join(':'));
   });
-  grunt.registerTask('default', ['build:all', 'connect','mocha_phantomjs']);
+  grunt.registerTask('default', ['build:all']);
 };

package/README.md

@@ -26,9 +26,7 @@ The basic signature is:
 proj4([fromProjection, ]toProjection[, coordinates])
 ```
 
-Projections can be proj or wkt strings.
-
-Wkt strings must be in form of [version 1](https://docs.ogc.org/is/18-010r7/18-010r7.html#196) (earlier than 2015). Have a look at the [wkt-parser](https://github.com/proj4js/wkt-parser) for more info, or use proj strings instead.
+Projections can be proj or wkt strings, or PROJJSON objects.
 
 Coordinates may be an object of the form `{x:x,y:y}` or an array of the form `[x,y]`.
 
@@ -140,9 +138,15 @@ proj4('+proj=longlat +ellps=WGS84 +datum=WGS84 +units=degrees +axis=neu', firstP
 //the floating points to answer your question
 ```
 
+## Datum Transformations
+
+Proj4js has built-in Helmert transformations for many datums to transform to and from WGS84, which is used as pivot for datum transformations. If a datum is not available or not accurate enough for the desired region, custom Helmert transformations or grid based datum adjustments are supported.
+
+WKT1 definitions can contain a `TOWGS84` parameter. For proj strings, `towgs84` or `nadgrids` can be specified. When using WKT2 or PROJJSON definitions, if a `BOUNDCRS` with an `ABRIDGEDTRANDFORMATION` to WGS84 is provided, Helmert transformation parameters (like `+towgs84=` in proj strings) or the name of the parameter file (like `+nadgrids=` in proj strings) will be extracted from it.
+
 ## Grid Based Datum Adjustments
 
-To use `+nadgrids=` in a proj definition, first read your NTv2 `.gsb` file (e.g. from https://github.com/OSGeo/proj-datumgrid) into an ArrayBuffer, then pass it to `proj4.nadgrid`. E.g:
+To use `+nadgrids=` in a proj definition or a WKT2/PROJJSON `ABRIDGEDTRANSFORM` with an `NTv2` method, first read your NTv2 `.gsb` file (e.g. from https://github.com/OSGeo/proj-datumgrid) into an ArrayBuffer, then pass it to `proj4.nadgrid`. E.g:
 
 ```javascript
 const buffer = fs.readFileSync('ntv2.gsb').buffer
@@ -151,6 +155,15 @@ proj4.nadgrid('key', buffer);
 
 then use the given key in your definition, e.g. `+nadgrids=@key,null`. See [Grid Based Datum Adjustments](https://proj.org/usage/transformation.html?highlight=nadgrids#grid-based-datum-adjustments).
 
+Optionally, if your `.gsb` file does not contain latitude and longitude error columns, you can provide an `options` object argument to the `proj4.nadgrid` call, setting the `includeErrorFields` property to `false`, e.g:
+
+```javascript
+const buffer = fs.readFileSync('ntv2.gsb').buffer
+proj4.nadgrid('key', buffer, {includeErrorFields:false});
+```
+
+If the options argument is omitted, `includeErrorFields` is assumed to be true.
+
 ## TypeScript
 
 TypeScript implementation was added to the [DefinitelyTyped repository](https://github.com/DefinitelyTyped/DefinitelyTyped).
@@ -168,7 +181,7 @@ To do the complete build and browser tests run
 node_modules/.bin/grunt
 ```
 
-To run node tests run
+To run node and browser tests run
 
 ```bash
 npm test
@@ -177,7 +190,8 @@ npm test
 To run node tests with coverage run
 
 ```bash
-npm test --coverage
+npm run build
+npm run test:coverage
 ```
 
 To create a build with only default projections (latlon and Mercator) run

package/bower.json

@@ -1,6 +1,6 @@
 {
   "name": "proj4",
-  "version": "2.15.0",
+  "version": "2.16.1",
   "description": "Proj4js is a JavaScript library to transform point coordinates from one coordinate system to another, including datum transformations.",
   "homepage": "https://github.com/proj4js/proj4js",
   "main": "dist/proj4.js",

package/component.json

@@ -1,6 +1,6 @@
 {
   "name": "proj4",
-  "version": "2.15.0",
+  "version": "2.16.1",
   "description": "Proj4js is a JavaScript library to transform point coordinates from one coordinate system to another, including datum transformations.",
   "repo": "proj4js/proj4js",
   "keywords": [