@putout/plugin-esm 3.0.0 → 4.0.0

package/README.md

@@ -18,6 +18,7 @@ npm i putout @putout/plugin-esm -D
 
 ## Rules
 
+- ✅ [add-index-to-import](#add-index-to-import);
 - ✅ [apply-export-from](#apply-export-from);
 - ✅ [declare-imports-first](#declare-imports-first);
 - ✅ [group-imports-by-source](#group-imports-by-source);
@@ -32,6 +33,7 @@ npm i putout @putout/plugin-esm -D
 ```json
 {
     "rules": {
+        "esm/add-index-to-import": "on",
         "esm/apply-export-from": "on",
         "esm/declare-imports-first": "on",
         "esm/group-imports-by-source": "on",
@@ -46,15 +48,41 @@ npm i putout @putout/plugin-esm -D
 }
 ```
 
-## apply-export-from
+## Rules
+
+### add-index-to-import
+
+ESM doesn't add `index.js`, so it can be left after [`@putout/plugin-convert-esm-to-commonjs`](https://github.com/coderaiser/putout/blob/master/packages/plugin-convert-esm-to-commonjs#readme).
+Checkout in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/b7c489710767efee95ecf3dd16e232a2/9f974f0a345ef4d0cb39b011097dff82e6c32b75).
+
+#### ❌ Example of incorrect code
+
+```js
+import insertRust from './insert-rust.js';
+import addAction from './add-action.js';
+
+export const rules = {};
+```
+
+#### ✅ Example of correct code
+
+```js
+import insertRust from './insert-rust/index.js';
+import addAction from './add-action/index.js';
+
+export const rules = {};
+```
+
+
+### apply-export-from
 
 > The `export` declaration is used to export values from a JavaScript module.
 >
 > (c) [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/export)
 
-Check out in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/c9a3983d269745da89c1c7560f3b7fac/3ecb9aa6b910ce3816605bae11c8dd86bdc457e5).
+Check out in 🐊[**Putout Editor**](https://putout.cloudcmd.io/##/gist/c9a3983d269745da89c1c7560f3b7fac/3ecb9aa6b910ce3816605bae11c8dd86bdc457e5).
 
-## ❌ Example of incorrect code
+#### ❌ Example of incorrect code
 
 ```js
 import * as ns_1 from 'x';
@@ -64,24 +92,24 @@ export {
 };
 ```
 
-## ✅ Example of correct code
+#### ✅ Example of correct code
 
 ```js
 export * as ns from 'x';
 ```
 
-## declare-imports-first
+### declare-imports-first
 
 Check out in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/b1c18e5d726afe4ebb69d6b7a7dda82b/8189590815a1b8adb35bb8a846e28228e3c7fadf). For **CommonJS** use [nodejs/declare-after-require](https://github.com/coderaiser/putout/tree/master/packages/plugin-nodejs#declare-after-require).
 
-## ❌ Example of incorrect code
+#### ❌ Example of incorrect code
 
 ```js
 const [arg] = process.argv;
 import esbuild from 'esbuild';
 ```
 
-## ✅ Example of correct code
+#### ✅ Example of correct code
 
 ```js
 import esbuild from 'esbuild';
@@ -89,7 +117,7 @@ import esbuild from 'esbuild';
 const [arg] = process.argv;
 ```
 
-## group-imports-by-source
+### group-imports-by-source
 
 Group order:
 
@@ -100,7 +128,7 @@ Group order:
 
 Checkout in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/3cc782acf95211f9d456d63a99032ee1/0674223d050bba572f5271ffdccf8616cb441af5).
 
-## ❌ Example of incorrect code
+#### ❌ Example of incorrect code
 
 ```js
 import fs from 'node:fs';
@@ -114,7 +142,7 @@ import parse from '#parser';
 const c = 5;
 ```
 
-## ✅ Example of correct code
+#### ✅ Example of correct code
 
 ```js
 import fs from 'node:fs';
@@ -128,9 +156,9 @@ import ss from '../../bb/ss.js';
 const c = 5;
 ```
 
-## merge-duplicate-imports
+### merge-duplicate-imports
 
-### join
+#### join
 
 To disable use:
 
@@ -142,20 +170,20 @@ To disable use:
 }
 ```
 
-#### ❌ Example of incorrect code
+##### ❌ Example of incorrect code
 
 ```js
 import test from 'supertape';
 import {stub} from 'supertape';
 ```
 
-#### ✅ Example of correct code
+##### ✅ Example of correct code
 
 ```js
 import test, {stub} from 'supertape';
 ```
 
-### rename
+#### rename
 
 Checkout in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/6604936dec6b1eed8ce0d143f2962f15/17b310a6e4d85b0b8615a8b91d0e27414e8af291).
 
@@ -169,7 +197,7 @@ To disable use:
 }
 ```
 
-#### ❌ Example of incorrect code
+##### ❌ Example of incorrect code
 
 ```js
 import putout from './putout.js';
@@ -180,7 +208,7 @@ console.log(all);
 console.log(x);
 ```
 
-#### ✅ Example of correct code
+##### ✅ Example of correct code
 
 ```js
 import putout from './putout.js';
@@ -189,39 +217,39 @@ console.log(putout);
 console.log(putout);
 ```
 
-## remove-empty-export
+### remove-empty-export
 
 ```diff
 -export {};
 ```
 
-## remove-empty-import
+### remove-empty-import
 
 ```diff
 -import 'abc';
 ```
 
-## remove-quotes-from-import-assertions
+### remove-quotes-from-import-assertions
 
 Checkout in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/f9f34acddbefba0ded53225ca10fa44e/7b4dba44602b9b2d28fe3a98989474a4b0d8d73d).
 
-### ❌ Example of incorrect code
+#### ❌ Example of incorrect code
 
 ```js
 import json from './mod.json' with { type: 'json' };
 ```
 
-## ✅ Example of correct code
+#### ✅ Example of correct code
 
 ```js
 import json from './mod.json' with { type: 'json' };
 ```
 
-## sort-imports-by-specifiers
+### sort-imports-by-specifiers
 
 Checkout in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/521e2ff199243a7ce1f65db7140c272e/28c0588281286f8a6765b8aa2ecabbfcde2973a7).
 
-### ❌ Example of incorrect code
+#### ❌ Example of incorrect code
 
 ```js
 import {
@@ -233,7 +261,7 @@ import {
 import a1 from 'a1';
 ```
 
-### ✅ Example of correct code
+#### ✅ Example of correct code
 
 ```js
 import a1 from 'a1';
@@ -245,7 +273,7 @@ import {
 } from 'd';
 ```
 
-## convert-assert-to-with
+### convert-assert-to-with
 
 > This feature would ideally use the `with` keyword to denote attributes, but there are existing implementations based on a previous version of the proposal using the `assert` keyword. Due to potential web compatibility risks, the proposal still includes `assert` marked as deprecated. Usage of the old syntax is discouraged, and its removal is being investigated.
 >
@@ -253,7 +281,7 @@ import {
 
 Check out in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/9f85897b998c6458efc19db6a5414b79/57ef7cdd113c7a0087e0f7a6e70522f60baa04f4).
 
-## ❌ Example of incorrect code
+#### ❌ Example of incorrect code
 
 ```js
 import json from './foo.json' assert { type: 'json' };
@@ -265,7 +293,7 @@ import('foo.json', {
 });
 ```
 
-## ✅ Example of correct code
+#### ✅ Example of correct code
 
 ```js
 import json from './foo.json' with { type: 'json' };

package/lib/add-index-to-import/index.js

@@ -0,0 +1,31 @@
+import {extname} from 'node:path';
+import {operator} from 'putout';
+
+const {setLiteralValue} = operator;
+
+export const report = (path) => {
+    const {value} = path.node.source;
+    return `Add 'index.js' to import: '${value}' -> '${value}/index.js'`;
+};
+
+export const fix = (path) => {
+    const {source} = path.node;
+    const {value} = source;
+    
+    setLiteralValue(source, `${value}/index.js`);
+};
+
+export const traverse = ({push}) => ({
+    ImportDeclaration: (path) => {
+        const {value} = path.node.source;
+        const ext = extname(value);
+        
+        if (ext)
+            return;
+        
+        if (!value.startsWith('.'))
+            return;
+        
+        push(path);
+    },
+});

package/lib/index.js

@@ -1,3 +1,4 @@
+import * as addIndexToImport from './add-index-to-import/index.js';
 import * as declareImportsFirst from './declare-imports-first/index.js';
 import * as groupImportsBySource from './group-imports-by-source/index.js';
 import * as removeQuotesFromImportAssertions from './remove-quotes-from-import-assertions/index.js';
@@ -9,13 +10,14 @@ import * as convertAssertToWith from './convert-assert-to-with/index.js';
 import * as applyExportFrom from './apply-export-from/index.js';
 
 export const rules = {
-    ...mergeDuplicateImports.rules,
+    'add-index-to-import': addIndexToImport,
+    'apply-export-from': applyExportFrom,
+    'convert-assert-to-with': convertAssertToWith,
     'declare-imports-first': declareImportsFirst,
     'group-imports-by-source': groupImportsBySource,
+    ...mergeDuplicateImports.rules,
     'remove-quotes-from-import-assertions': removeQuotesFromImportAssertions,
     'remove-empty-import': removeEmptyImport,
     'remove-empty-export': removeEmptyExport,
     'sort-imports-by-specifiers': sortImportsBySpecifiers,
-    'convert-assert-to-with': convertAssertToWith,
-    'apply-export-from': applyExportFrom,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@putout/plugin-esm",
-  "version": "3.0.0",
+  "version": "4.0.0",
   "type": "module",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
   "description": "🐊Putout plugin improves ability to transform ESM code",
@@ -56,7 +56,7 @@
     "supertape": "^11.0.3"
   },
   "peerDependencies": {
-    "putout": ">=39"
+    "putout": ">=40"
   },
   "license": "MIT",
   "engines": {