eslint-plugin-putout 25.0.3 → 25.1.0

package/README.md

@@ -17,7 +17,32 @@ npm i putout eslint eslint-plugin-putout -D
 
 ## Usage
 
-Update `eslint.config.js` with:
+### Plugin
+
+To use `putout` as ESLint plugin you can use in `eslint.config.js`
+
+```js
+import putout from 'eslint-plugin-putout';
+
+export default [
+    rules: {
+        'putout/putout': 'error',
+    },
+    plugins: {
+        putout,
+    },
+];
+```
+
+### Preset
+
+Also you can import one of predefined preset:
+
+- ✅ **recommended** - all rules enabled;
+- ✅ **safe** - dangerous rules disabled;
+- ✅ **safeAlign** - dangerous rules disabled + add whitespaces on empty lines;
+
+Here is how it can look like:
 
 ```js
 import {recommended} from 'eslint-plugin-putout';
@@ -25,6 +50,22 @@ import {recommended} from 'eslint-plugin-putout';
 export default recommended;
 ```
 
+Or with [`defineConfig`](https://eslint.org/blog/2025/03/flat-config-extends-define-config-global-ignores/):
+
+```js
+import {defineConfig} from 'eslint/config';
+import putout from 'eslint-plugin-putout';
+
+export default defineConfig({
+    plugins: {
+        putout,
+    },
+    extends: [
+        "putout/recommended",
+    ]
+});
+```
+
 Then configure the rules you want to use under the rules section.
 
 ```json

package/lib/index.mjs

@@ -5,7 +5,7 @@ import json from './json.mjs';
 import html from './html.mjs';
 import ts from './ts.mjs';
 import jsxConfig, {jsx} from './jsx.mjs';
-import putout from './plugin.js';
+import * as putout from './plugin.mjs';
 
 const n = nPlugin.configs['flat/mixed-esm-and-cjs'];
 
@@ -139,8 +139,4 @@ export const configs = {
     esm,
 };
 
-const {rules} = putout;
-
-export {
-    rules,
-};
+export default putout;

package/lib/json.mjs

@@ -1,5 +1,5 @@
 import stylisticJs from '@stylistic/eslint-plugin-js';
-import putout from './plugin.js';
+import * as putout from './plugin.mjs';
 
 export default [{
     name: 'putout: json',

package/lib/{plugin.js → plugin.mjs}

@@ -1,6 +1,7 @@
-'use strict';
+import {createRequire} from 'node:module';
+import {createPlugin} from '@putout/eslint/create-plugin';
 
-const {createPlugin} = require('@putout/eslint/create-plugin');
+const require = createRequire(import.meta.url);
 
 const getRule = (a) => ({
     [a]: require(`./${a}`),
@@ -10,7 +11,7 @@ const getWrapRule = (a) => ({
     [a]: createPlugin(require(`./${a}`)),
 });
 
-module.exports.rules = {
+export const rules = {
     ...getWrapRule('array-element-newline'),
     ...getWrapRule('single-property-destructuring'),
     ...getWrapRule('multiple-properties-destructuring'),

package/lib/ts.mjs

@@ -4,7 +4,7 @@ import tseslint from 'typescript-eslint';
 import tsPlugin from '@typescript-eslint/eslint-plugin';
 import stylisticTs from '@stylistic/eslint-plugin-ts';
 import {jsx} from './jsx.mjs';
-import plugin from './plugin.js';
+import * as plugin from './plugin.mjs';
 
 const {assign} = Object;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-putout",
-  "version": "25.0.3",
+  "version": "25.1.0",
   "type": "commonjs",
   "description": "ESLint plugin for 🐊Putout",
   "release": false,