Add no-named-default rule

CHANGELOG.md

@@ -4,6 +4,7 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 This change log adheres to standards from [Keep a CHANGELOG](http://keepachangelog.com).
 
 ## [Unreleased]
+- Add [`no-named-default`] rule: style-guide rule to report use of unnecessarily named default imports
 
 
 ## [2.0.0]! - 2016-09-30

README.md

@@ -73,8 +73,9 @@ This plugin intends to support linting of ES2015+ (ES6+) import/export syntax, a
 * Enforce a convention in module import order ([`order`])
 * Enforce a newline after import statements ([`newline-after-import`])
 * Prefer a default export if module exports a single name ([`prefer-default-export`])
-* Limit the maximum number of dependencies a module can have. ([`max-dependencies`])
-* Forbid unassigned imports. ([`no-unassigned-import`])
+* Limit the maximum number of dependencies a module can have ([`max-dependencies`])
+* Forbid unassigned imports ([`no-unassigned-import`])
+* Forbid named default exports ([`no-named-default`])
 
 [`first`]: ./docs/rules/first.md
 [`no-duplicates`]: ./docs/rules/no-duplicates.md
@@ -85,6 +86,7 @@ This plugin intends to support linting of ES2015+ (ES6+) import/export syntax, a
 [`prefer-default-export`]: ./docs/rules/prefer-default-export.md
 [`max-dependencies`]: ./docs/rules/max-dependencies.md
 [`no-unassigned-import`]: ./docs/rules/no-unassigned-import.md
+[`no-named-default`]: ./docs/rules/no-named-default.md
 
 ## Installation
 

docs/rules/no-named-default.md

@@ -0,0 +1,30 @@
+# no-named-default
+
+Reports use of a default export as a locally named import.
+
+Rationale: the syntax exists to import default exports expressively, let's use it
+
+- *misleading*: consistent syntax usage is less likely to confuse new developers
+- *a mistake*: meant to import a named export and unintentionally specified `default`
+
+## Rule Details
+
+Given:
+```js
+// foo.js
+export default 'foo';
+export const bar = 'baz';
+```
+
+...these would be valid:
+```js
+import foo from './foo.js';
+import foo { bar } from './foo.js';
+```
+
+...and these would be reported:
+```js
+// message: Using exported name 'bar' as identifier for default export.
+import { default as foo } from './foo.js';
+import { default as foo, bar } from './foo.js';
+```

src/index.js

@@ -10,6 +10,7 @@ export const rules = {
   'no-restricted-paths': require('./rules/no-restricted-paths'),
   'no-internal-modules': require('./rules/no-internal-modules'),
 
+  'no-named-default': require('./rules/no-named-default'),
   'no-named-as-default': require('./rules/no-named-as-default'),
   'no-named-as-default-member': require('./rules/no-named-as-default-member'),
 

src/rules/no-named-default.js

@@ -0,0 +1,32 @@
+module.exports = {
+  meta: {
+    docs: {},
+  },
+
+  create: function (context) {
+    function checkSpecifiers(type, node) {
+      if (node.source == null) return
+
+      const hasImportSpecifier = node.specifiers.some(function (im) {
+        return im.type === type
+      })
+
+      if (!hasImportSpecifier) {
+        return
+      }
+
+      node.specifiers.forEach(function (im) {
+        if (im.type !== type) return
+
+        if (im.imported.name === 'default') {
+          context.report(im.local,
+            'Using name \'' + im.local.name +
+            '\' as identifier for default export.')
+        }
+      })
+    }
+    return {
+      'ImportDeclaration': checkSpecifiers.bind(null, 'ImportSpecifier'),
+    }
+  },
+}

tests/src/rules/no-named-default.js

@@ -0,0 +1,31 @@
+import { test, SYNTAX_CASES } from '../utils'
+import { RuleTester } from 'eslint'
+
+const ruleTester = new RuleTester()
+    , rule = require('rules/no-named-default')
+
+ruleTester.run('no-named-default', rule, {
+  valid: [
+    test({code: 'import bar from "./bar";'}),
+    test({code: 'import bar, { foo } from "./bar";'}),
+
+    // es7
+    test({ code: 'import bar from "./bar";', parser: 'babel-eslint' }),
+    test({ code: 'import bar, { foo } from "./bar";', parser: 'babel-eslint' }),
+
+    ...SYNTAX_CASES,
+  ],
+
+  invalid: [
+    test({
+      code: 'import { default as bar } from "./bar";',
+      errors: [ {
+        message: 'Using name \'bar\' as identifier for default export.'
+      , type: 'Identifier' } ] }),
+    test({
+      code: 'import { foo, default as bar } from "./bar";',
+      errors: [ {
+        message: 'Using name \'bar\' as identifier for default export.'
+      , type: 'Identifier' } ] }),
+  ],
+})