feat: add sort option

BREAKING CHANGE: will not order keys by default anymore

README.md

@@ -100,6 +100,11 @@ Type: `function`
 
 Modify files details before the manifest is created. [more details](#hooks-options)
 
+### `options.sort`
+
+Type: `function`
+
+Sort files before they are passed to `generate`. [more details](#hooks-options)
 
 ### `options.generate`
 
@@ -113,7 +118,7 @@ Create the manifest. It can return anything as long as it's serialisable by `JSO
 
 ## Hooks Options
 
-`filter`, `map` take as an input an Object with the following properties:
+`filter`, `map`, `sort` takes as an input an Object with the following properties:
 
 ### `path`
 

lib/plugin.js

@@ -136,18 +136,9 @@ ManifestPlugin.prototype.apply = function(compiler) {
       files = files.map(this.opts.map);
     }
 
-    files = files.sort(function (fileA, fileB) {
-      var a = fileA.name;
-      var b = fileB.name;
-
-      if (a < b) {
-          return -1;
-      } else if (a > b) {
-          return 1;
-      } else {
-          return 0;
-      }
-    });
+    if (this.opts.sort) {
+      files = files.sort(this.opts.sort);
+    }
 
     var manifest;
     if (this.opts.generate) {

spec/plugin.spec.js

@@ -568,6 +568,36 @@ describe('ManifestPlugin', function() {
     });
   });
 
+  describe('sort', function() {
+    it('should allow ordering of output', function(done) {
+      webpackCompile({
+        context: __dirname,
+        entry: {
+          one: './fixtures/file.js',
+          two: './fixtures/file-two.js'
+        },
+        output: {
+          filename: '[name].js'
+        }
+      }, {
+        manifestOptions: {
+          seed: [],
+          sort: function(a, b) {
+            // make sure one is the latest
+            return a.name === 'one.js' ? 1 : -1;
+          },
+          generate: function (seed, files) {
+            return files.map(file => file.name);
+          }
+        }
+      }, function(manifest, stats) {
+        expect(manifest).toEqual(['two.js', 'one.js']);
+
+        done();
+      });
+    });
+  });
+
   describe('generate', function() {
     it('should generate custom manifest', function(done) {
       webpackCompile({