add fixer for first

docs/rules/first.md

@@ -50,6 +50,12 @@ mode](http://www.ecma-international.org/ecma-262/6.0/#sec-strict-mode-code) so i
 
 Given that, see [#255] for the reasoning.
 
+### With Fixer
+
+This rule contains a fixer to reorder in-body import to top, the following criteria applied:
+1. Never re-order relative to each other, even if `absolute-first` is set.
+2. If an import creates an identifier, and that identifier is referenced at module level *before* the import itself, that won't be re-ordered.
+
 ## When Not To Use It
 
 If you don't mind imports being sprinkled throughout, you may not want to

src/rules/first.js

@@ -5,6 +5,7 @@ module.exports = {
     docs: {
       url: docsUrl('first'),
     },
+    fixable: 'code',
   },
 
   create: function (context) {
@@ -18,10 +19,17 @@ module.exports = {
       'Program': function (n) {
         const body = n.body
             , absoluteFirst = context.options[0] === 'absolute-first'
+            , message = 'Import in body of module; reorder to top.'
+            , sourceCode = context.getSourceCode()
+            , originSourceCode = sourceCode.getText()
         let nonImportCount = 0
           , anyExpressions = false
           , anyRelative = false
-        body.forEach(function (node){
+          , lastLegalImp = null
+          , errorInfos = []
+          , shouldSort = true
+          , lastSortNodesIndex = 0
+        body.forEach(function (node, index){
           if (!anyExpressions && isPossibleDirective(node)) {
             return
           }
@@ -40,15 +48,80 @@ module.exports = {
               }
             }
             if (nonImportCount > 0) {
-              context.report({
+              for (let variable of context.getDeclaredVariables(node)) {
+                if (!shouldSort) break
+                const references = variable.references
+                if (references.length) {
+                  for (let reference of references) {
+                    if (reference.identifier.range[0] < node.range[1]) {
+                      shouldSort = false
+                      break
+                    }
+                  }
+                }
+              }
+              shouldSort && (lastSortNodesIndex = errorInfos.length)
+              errorInfos.push({
                 node,
-                message: 'Import in body of module; reorder to top.',
+                range: [body[index - 1].range[1], node.range[1]],
               })
+            } else {
+              lastLegalImp = node
             }
           } else {
             nonImportCount++
           }
         })
+        if (!errorInfos.length) return
+        errorInfos.forEach(function (errorInfo, index) {
+          const node = errorInfo.node
+              , infos = {
+                node,
+                message,
+              }
+          if (index < lastSortNodesIndex) {
+            infos.fix = function (fixer) {
+              return fixer.insertTextAfter(node, '')
+            }
+          } else if (index === lastSortNodesIndex) {
+            const sortNodes = errorInfos.slice(0, lastSortNodesIndex + 1)
+            infos.fix = function (fixer) {
+              const removeFixers = sortNodes.map(function (_errorInfo) {
+                    return fixer.removeRange(_errorInfo.range)
+                  })
+                  , range = [0, removeFixers[removeFixers.length - 1].range[1]]
+              let insertSourceCode = sortNodes.map(function (_errorInfo) {
+                    const nodeSourceCode = String.prototype.slice.apply(
+                      originSourceCode, _errorInfo.range
+                    )
+                    if (/\S/.test(nodeSourceCode[0])) {
+                      return '\n' + nodeSourceCode
+                    }
+                    return nodeSourceCode
+                  }).join('')
+                , insertFixer = null
+                , replaceSourceCode = ''
+              if (!lastLegalImp && !(/\s$/.test(insertSourceCode))) {
+                if (/^(\s+)/.test(insertSourceCode)) {
+                  insertSourceCode = insertSourceCode.trim() + RegExp.$1
+                } else {
+                  insertSourceCode = insertSourceCode + '\n'
+                }
+              }
+              insertFixer = lastLegalImp ? 
+                            fixer.insertTextAfter(lastLegalImp, insertSourceCode) :
+                            fixer.insertTextBefore(body[0], insertSourceCode)
+              const fixers = [insertFixer].concat(removeFixers)
+              fixers.forEach(function (computedFixer, i) {
+                replaceSourceCode += (originSourceCode.slice(
+                  fixers[i - 1] ? fixers[i - 1].range[1] : 0, computedFixer.range[0]
+                ) + computedFixer.text)
+              })
+              return fixer.replaceTextRange(range, replaceSourceCode)
+            }
+          }
+          context.report(infos)
+        })
       },
     }
   },

tests/src/rules/first.js

@@ -18,14 +18,21 @@ ruleTester.run('first', rule, {
   invalid: [
     test({ code: "import { x } from './foo';\
                   export { x };\
-                  import { y } from './foo';"
+                  import { y } from './bar';"
          , errors: 1
+         , output: "import { x } from './foo';\
+                  import { y } from './bar';\
+                  export { x };"
          })
   , test({ code: "import { x } from './foo';\
                   export { x };\
                   import { y } from './bar';\
                   import { z } from './baz';"
          , errors: 2
+         , output: "import { x } from './foo';\
+                  import { y } from './bar';\
+                  import { z } from './baz';\
+                  export { x };"
          })
   , test({ code: "import { x } from './foo'; import { y } from 'bar'"
          , options: ['absolute-first']
@@ -35,7 +42,22 @@ ruleTester.run('first', rule, {
                   'use directive';\
                   import { y } from 'bar';"
          , errors: 1
+         , output: "import { x } from 'foo';\
+                  import { y } from 'bar';\
+                  'use directive';"
          })
+  , test({ code: "var a = 1;\
+                  import { y } from './bar';\
+                  if (true) { x() };\
+                  import { x } from './foo';\
+                  import { z } from './baz';"
+         , errors: 3
+         , output: "import { y } from './bar';\
+                  var a = 1;\
+                  if (true) { x() };\
+                  import { x } from './foo';\
+                  import { z } from './baz';"
+  })
   ,
   ]
 })