eslint-plugin-perfectionist 3.6.0 → 3.8.0

package/dist/index.d.ts

@@ -108,10 +108,14 @@ declare const _default: {
   }
   rules: {
     'sort-variable-declarations': RuleModule<
-      'unexpectedVariableDeclarationsOrder',
+      | 'unexpectedVariableDeclarationsDependencyOrder'
+      | 'unexpectedVariableDeclarationsOrder',
       [
         Partial<{
           type: 'alphabetical' | 'line-length' | 'natural'
+          partitionByComment: string[] | boolean | string
+          matcher: 'minimatch' | 'regex'
+          partitionByNewLine: boolean
           order: 'desc' | 'asc'
           ignoreCase: boolean
         }>,
@@ -125,6 +129,8 @@ declare const _default: {
       [
         Partial<{
           type: 'alphabetical' | 'line-length' | 'natural'
+          partitionByComment: string[] | boolean | string
+          matcher: 'minimatch' | 'regex'
           groups: (
             | (
                 | 'object'
@@ -157,6 +163,7 @@ declare const _default: {
                 | 'union'
               )
           )[]
+          partitionByNewLine: boolean
           order: 'desc' | 'asc'
           ignoreCase: boolean
         }>,
@@ -174,6 +181,7 @@ declare const _default: {
           }
           type: 'alphabetical' | 'line-length' | 'natural'
           groups: (string | string[])[]
+          matcher: 'minimatch' | 'regex'
           order: 'desc' | 'asc'
           ignoreCase: boolean
         }>,
@@ -190,6 +198,7 @@ declare const _default: {
           }
           type: 'alphabetical' | 'line-length' | 'natural'
           groups: (string | string[])[]
+          matcher: 'minimatch' | 'regex'
           order: 'desc' | 'asc'
           ignoreCase: boolean
         }>,
@@ -206,6 +215,7 @@ declare const _default: {
           }
           type: 'alphabetical' | 'line-length' | 'natural'
           groups: (string | string[])[]
+          matcher: 'minimatch' | 'regex'
           order: 'desc' | 'asc'
           ignoreCase: boolean
         }>,
@@ -225,6 +235,9 @@ declare const _default: {
         Partial<{
           groupKind: 'values-first' | 'types-first' | 'mixed'
           type: 'alphabetical' | 'line-length' | 'natural'
+          partitionByComment: string[] | boolean | string
+          matcher: 'minimatch' | 'regex'
+          partitionByNewLine: boolean
           order: 'desc' | 'asc'
           ignoreAlias: boolean
           ignoreCase: boolean
@@ -239,6 +252,9 @@ declare const _default: {
         Partial<{
           groupKind: 'values-first' | 'types-first' | 'mixed'
           type: 'alphabetical' | 'line-length' | 'natural'
+          partitionByComment: string[] | boolean | string
+          matcher: 'minimatch' | 'regex'
+          partitionByNewLine: boolean
           order: 'desc' | 'asc'
           ignoreCase: boolean
         }>,
@@ -255,7 +271,9 @@ declare const _default: {
             [x: string]: string | string[]
           }
           type: 'alphabetical' | 'line-length' | 'natural'
+          partitionByComment: string[] | boolean | string
           groups: (string | string[])[]
+          matcher: 'minimatch' | 'regex'
           partitionByNewLine: boolean
           order: 'desc' | 'asc'
           ignoreCase: boolean
@@ -269,6 +287,8 @@ declare const _default: {
       [
         Partial<{
           type: 'alphabetical' | 'line-length' | 'natural'
+          partitionByComment: string[] | boolean | string
+          matcher: 'minimatch' | 'regex'
           groups: (
             | (
                 | 'object'
@@ -301,6 +321,7 @@ declare const _default: {
                 | 'union'
               )
           )[]
+          partitionByNewLine: boolean
           order: 'desc' | 'asc'
           ignoreCase: boolean
         }>,
@@ -330,7 +351,9 @@ declare const _default: {
             [key: string]: string[] | string
           }
           type: 'alphabetical' | 'line-length' | 'natural'
+          partitionByComment: string[] | boolean | string
           groups: (string | string[])[]
+          matcher: 'minimatch' | 'regex'
           partitionByNewLine: boolean
           ignorePattern: string[]
           order: 'desc' | 'asc'
@@ -349,6 +372,7 @@ declare const _default: {
           }
           type: 'alphabetical' | 'line-length' | 'natural'
           groups: (string | string[])[]
+          matcher: 'minimatch' | 'regex'
           ignorePattern: string[]
           order: 'desc' | 'asc'
           ignoreCase: boolean
@@ -358,7 +382,9 @@ declare const _default: {
       RuleListener
     >
     'sort-classes': RuleModule<
-      'unexpectedClassesGroupOrder' | 'unexpectedClassesOrder',
+      | 'unexpectedClassesDependencyOrder'
+      | 'unexpectedClassesGroupOrder'
+      | 'unexpectedClassesOrder',
       SortClassesOptions,
       unknown,
       RuleListener
@@ -385,6 +411,7 @@ declare const _default: {
           type: 'alphabetical' | 'line-length' | 'natural'
           newlinesBetween: 'ignore' | 'always' | 'never'
           groups: (string | string[])[]
+          matcher: 'minimatch' | 'regex'
           environment: 'node' | 'bun'
           internalPattern: string[]
           sortSideEffects: boolean
@@ -400,7 +427,11 @@ declare const _default: {
       'unexpectedExportsOrder',
       [
         Partial<{
+          groupKind: 'values-first' | 'types-first' | 'mixed'
           type: 'alphabetical' | 'line-length' | 'natural'
+          partitionByComment: string[] | boolean | string
+          matcher: 'minimatch' | 'regex'
+          partitionByNewLine: boolean
           order: 'desc' | 'asc'
           ignoreCase: boolean
         }>,
@@ -409,7 +440,9 @@ declare const _default: {
       RuleListener
     >
     'sort-objects': RuleModule<
-      'unexpectedObjectsGroupOrder' | 'unexpectedObjectsOrder',
+      | 'unexpectedObjectsDependencyOrder'
+      | 'unexpectedObjectsGroupOrder'
+      | 'unexpectedObjectsOrder',
       [
         Partial<{
           customGroups: {
@@ -417,6 +450,7 @@ declare const _default: {
           }
           type: 'alphabetical' | 'line-length' | 'natural'
           partitionByComment: string[] | boolean | string
+          matcher: 'minimatch' | 'regex'
           groups: (string[] | string)[]
           partitionByNewLine: boolean
           styledComponents: boolean
@@ -430,7 +464,7 @@ declare const _default: {
       RuleListener
     >
     'sort-enums': RuleModule<
-      'unexpectedEnumsOrder',
+      'unexpectedEnumsDependencyOrder' | 'unexpectedEnumsOrder',
       Options_2,
       unknown,
       RuleListener
@@ -446,6 +480,9 @@ declare const _default: {
       [
         Partial<{
           type: 'alphabetical' | 'line-length' | 'natural'
+          partitionByComment: string[] | boolean | string
+          matcher: 'minimatch' | 'regex'
+          partitionByNewLine: boolean
           order: 'desc' | 'asc'
           ignoreCase: boolean
         }>,
@@ -511,6 +548,9 @@ declare type Options = [
   Partial<{
     groupKind: 'literals-first' | 'spreads-first' | 'mixed'
     type: 'alphabetical' | 'line-length' | 'natural'
+    partitionByComment: string[] | boolean | string
+    matcher: 'minimatch' | 'regex'
+    partitionByNewLine: boolean
     order: 'desc' | 'asc'
     ignoreCase: boolean
   }>,
@@ -520,6 +560,8 @@ declare type Options_2 = [
   Partial<{
     type: 'alphabetical' | 'line-length' | 'natural'
     partitionByComment: string[] | boolean | string
+    matcher: 'minimatch' | 'regex'
+    partitionByNewLine: boolean
     forceNumericSort: boolean
     order: 'desc' | 'asc'
     sortByValue: boolean
@@ -585,6 +627,7 @@ declare type SortClassesOptions = [
       | CustomGroup[]
     type: 'alphabetical' | 'line-length' | 'natural'
     partitionByComment: string[] | boolean | string
+    matcher: 'minimatch' | 'regex'
     groups: (Group[] | Group)[]
     order: 'desc' | 'asc'
     ignoreCase: boolean

package/dist/rules/sort-array-includes.js

@@ -3,7 +3,10 @@ Object.defineProperties(exports, {
   __esModule: { value: true },
   [Symbol.toStringTag]: { value: 'Module' },
 })
+const isPartitionComment = require('../utils/is-partition-comment.js')
+const getCommentsBefore = require('../utils/get-comments-before.js')
 const createEslintRule = require('../utils/create-eslint-rule.js')
+const getLinesBetween = require('../utils/get-lines-between.js')
 const getGroupNumber = require('../utils/get-group-number.js')
 const getSourceCode = require('../utils/get-source-code.js')
 const toSingleLine = require('../utils/to-single-line.js')
@@ -29,6 +32,11 @@ let jsonSchema = {
       type: 'string',
       enum: ['asc', 'desc'],
     },
+    matcher: {
+      description: 'Specifies the string matcher.',
+      type: 'string',
+      enum: ['minimatch', 'regex'],
+    },
     ignoreCase: {
       description: 'Controls whether sorting should be case-sensitive or not.',
       type: 'boolean',
@@ -38,6 +46,29 @@ let jsonSchema = {
       enum: ['mixed', 'literals-first', 'spreads-first'],
       type: 'string',
     },
+    partitionByComment: {
+      description:
+        'Allows you to use comments to separate the array members into logical groups.',
+      anyOf: [
+        {
+          type: 'array',
+          items: {
+            type: 'string',
+          },
+        },
+        {
+          type: 'boolean',
+        },
+        {
+          type: 'string',
+        },
+      ],
+    },
+    partitionByNewLine: {
+      description:
+        'Allows to use spaces to separate the nodes into logical groups.',
+      type: 'boolean',
+    },
   },
   additionalProperties: false,
 }
@@ -60,7 +91,10 @@ const sortArrayIncludes = createEslintRule.createEslintRule({
       type: 'alphabetical',
       order: 'asc',
       ignoreCase: true,
+      matcher: 'minimatch',
       groupKind: 'literals-first',
+      partitionByComment: false,
+      partitionByNewLine: false,
     },
   ],
   create: context => ({
@@ -87,70 +121,100 @@ let sortArray = (context, messageId, elements) => {
       groupKind: 'literals-first',
       type: 'alphabetical',
       ignoreCase: true,
+      matcher: 'minimatch',
       order: 'asc',
+      partitionByComment: false,
+      partitionByNewLine: false,
     })
     let sourceCode = getSourceCode.getSourceCode(context)
-    let nodes = elements
-      .reduce(
-        (accumulator, element) => {
-          if (element !== null) {
-            let group = 'unknown'
-            if (typeof options.groupKind === 'string') {
-              group = element.type === 'SpreadElement' ? 'spread' : 'literal'
-            }
-            accumulator.at(0).push({
-              name:
-                element.type === 'Literal'
-                  ? `${element.value}`
-                  : sourceCode.text.slice(...element.range),
-              size: rangeToDiff.rangeToDiff(element.range),
-              type: element.type,
-              node: element,
-              group,
-            })
+    let partitionComment = options.partitionByComment
+    let formattedMembers = elements.reduce(
+      (accumulator, element) => {
+        var _a
+        if (element !== null) {
+          let group = 'unknown'
+          if (typeof options.groupKind === 'string') {
+            group = element.type === 'SpreadElement' ? 'spread' : 'literal'
           }
-          return accumulator
-        },
-        [[], []],
-      )
-      .flat()
-    pairwise.pairwise(nodes, (left, right) => {
-      let groupKindOrder = ['unknown']
-      if (typeof options.groupKind === 'string') {
-        groupKindOrder =
-          options.groupKind === 'literals-first'
-            ? ['literal', 'spread']
-            : ['spread', 'literal']
-      }
-      let leftNum = getGroupNumber.getGroupNumber(groupKindOrder, left)
-      let rightNum = getGroupNumber.getGroupNumber(groupKindOrder, right)
-      if (
-        (options.groupKind !== 'mixed' && leftNum > rightNum) ||
-        ((options.groupKind === 'mixed' || leftNum === rightNum) &&
-          isPositive.isPositive(compare.compare(left, right, options)))
-      ) {
-        context.report({
-          messageId,
-          data: {
-            left: toSingleLine.toSingleLine(left.name),
-            right: toSingleLine.toSingleLine(right.name),
-          },
-          node: right.node,
-          fix: fixer => {
-            let sortedNodes =
-              options.groupKind !== 'mixed'
-                ? groupKindOrder
-                    .map(group => nodes.filter(n => n.group === group))
-                    .map(groupedNodes =>
-                      sortNodes.sortNodes(groupedNodes, options),
-                    )
-                    .flat()
-                : sortNodes.sortNodes(nodes, options)
-            return makeFixes.makeFixes(fixer, nodes, sortedNodes, sourceCode)
-          },
-        })
-      }
-    })
+          let lastSortingNode =
+            (_a = accumulator.at(-1)) == null ? void 0 : _a.at(-1)
+          let sortingNode = {
+            name:
+              element.type === 'Literal'
+                ? `${element.value}`
+                : sourceCode.text.slice(...element.range),
+            size: rangeToDiff.rangeToDiff(element.range),
+            node: element,
+            group,
+          }
+          if (
+            (partitionComment &&
+              isPartitionComment.hasPartitionComment(
+                partitionComment,
+                getCommentsBefore.getCommentsBefore(element, sourceCode),
+                options.matcher,
+              )) ||
+            (options.partitionByNewLine &&
+              lastSortingNode &&
+              getLinesBetween.getLinesBetween(
+                sourceCode,
+                lastSortingNode,
+                sortingNode,
+              ))
+          ) {
+            accumulator.push([])
+          }
+          accumulator.at(-1).push(sortingNode)
+        }
+        return accumulator
+      },
+      [[]],
+    )
+    for (let nodes of formattedMembers) {
+      pairwise.pairwise(nodes, (left, right) => {
+        let groupKindOrder = ['unknown']
+        if (typeof options.groupKind === 'string') {
+          groupKindOrder =
+            options.groupKind === 'literals-first'
+              ? ['literal', 'spread']
+              : ['spread', 'literal']
+        }
+        let leftNum = getGroupNumber.getGroupNumber(groupKindOrder, left)
+        let rightNum = getGroupNumber.getGroupNumber(groupKindOrder, right)
+        if (
+          (options.groupKind !== 'mixed' && leftNum > rightNum) ||
+          ((options.groupKind === 'mixed' || leftNum === rightNum) &&
+            isPositive.isPositive(compare.compare(left, right, options)))
+        ) {
+          context.report({
+            messageId,
+            data: {
+              left: toSingleLine.toSingleLine(left.name),
+              right: toSingleLine.toSingleLine(right.name),
+            },
+            node: right.node,
+            fix: fixer => {
+              let sortedNodes =
+                options.groupKind !== 'mixed'
+                  ? groupKindOrder
+                      .map(group => nodes.filter(n => n.group === group))
+                      .map(groupedNodes =>
+                        sortNodes.sortNodes(groupedNodes, options),
+                      )
+                      .flat()
+                  : sortNodes.sortNodes(nodes, options)
+              return makeFixes.makeFixes(
+                fixer,
+                nodes,
+                sortedNodes,
+                sourceCode,
+                options,
+              )
+            },
+          })
+        }
+      })
+    }
   }
 }
 exports.default = sortArrayIncludes

package/dist/rules/sort-array-includes.mjs

@@ -1,4 +1,7 @@
+import { hasPartitionComment } from '../utils/is-partition-comment.mjs'
+import { getCommentsBefore } from '../utils/get-comments-before.mjs'
 import { createEslintRule } from '../utils/create-eslint-rule.mjs'
+import { getLinesBetween } from '../utils/get-lines-between.mjs'
 import { getGroupNumber } from '../utils/get-group-number.mjs'
 import { getSourceCode } from '../utils/get-source-code.mjs'
 import { toSingleLine } from '../utils/to-single-line.mjs'
@@ -24,6 +27,11 @@ let jsonSchema = {
       type: 'string',
       enum: ['asc', 'desc'],
     },
+    matcher: {
+      description: 'Specifies the string matcher.',
+      type: 'string',
+      enum: ['minimatch', 'regex'],
+    },
     ignoreCase: {
       description: 'Controls whether sorting should be case-sensitive or not.',
       type: 'boolean',
@@ -33,6 +41,29 @@ let jsonSchema = {
       enum: ['mixed', 'literals-first', 'spreads-first'],
       type: 'string',
     },
+    partitionByComment: {
+      description:
+        'Allows you to use comments to separate the array members into logical groups.',
+      anyOf: [
+        {
+          type: 'array',
+          items: {
+            type: 'string',
+          },
+        },
+        {
+          type: 'boolean',
+        },
+        {
+          type: 'string',
+        },
+      ],
+    },
+    partitionByNewLine: {
+      description:
+        'Allows to use spaces to separate the nodes into logical groups.',
+      type: 'boolean',
+    },
   },
   additionalProperties: false,
 }
@@ -55,7 +86,10 @@ const sortArrayIncludes = createEslintRule({
       type: 'alphabetical',
       order: 'asc',
       ignoreCase: true,
+      matcher: 'minimatch',
       groupKind: 'literals-first',
+      partitionByComment: false,
+      partitionByNewLine: false,
     },
   ],
   create: context => ({
@@ -82,68 +116,88 @@ let sortArray = (context, messageId, elements) => {
       groupKind: 'literals-first',
       type: 'alphabetical',
       ignoreCase: true,
+      matcher: 'minimatch',
       order: 'asc',
+      partitionByComment: false,
+      partitionByNewLine: false,
     })
     let sourceCode = getSourceCode(context)
-    let nodes = elements
-      .reduce(
-        (accumulator, element) => {
-          if (element !== null) {
-            let group = 'unknown'
-            if (typeof options.groupKind === 'string') {
-              group = element.type === 'SpreadElement' ? 'spread' : 'literal'
-            }
-            accumulator.at(0).push({
-              name:
-                element.type === 'Literal'
-                  ? `${element.value}`
-                  : sourceCode.text.slice(...element.range),
-              size: rangeToDiff(element.range),
-              type: element.type,
-              node: element,
-              group,
-            })
+    let partitionComment = options.partitionByComment
+    let formattedMembers = elements.reduce(
+      (accumulator, element) => {
+        var _a
+        if (element !== null) {
+          let group = 'unknown'
+          if (typeof options.groupKind === 'string') {
+            group = element.type === 'SpreadElement' ? 'spread' : 'literal'
           }
-          return accumulator
-        },
-        [[], []],
-      )
-      .flat()
-    pairwise(nodes, (left, right) => {
-      let groupKindOrder = ['unknown']
-      if (typeof options.groupKind === 'string') {
-        groupKindOrder =
-          options.groupKind === 'literals-first'
-            ? ['literal', 'spread']
-            : ['spread', 'literal']
-      }
-      let leftNum = getGroupNumber(groupKindOrder, left)
-      let rightNum = getGroupNumber(groupKindOrder, right)
-      if (
-        (options.groupKind !== 'mixed' && leftNum > rightNum) ||
-        ((options.groupKind === 'mixed' || leftNum === rightNum) &&
-          isPositive(compare(left, right, options)))
-      ) {
-        context.report({
-          messageId,
-          data: {
-            left: toSingleLine(left.name),
-            right: toSingleLine(right.name),
-          },
-          node: right.node,
-          fix: fixer => {
-            let sortedNodes =
-              options.groupKind !== 'mixed'
-                ? groupKindOrder
-                    .map(group => nodes.filter(n => n.group === group))
-                    .map(groupedNodes => sortNodes(groupedNodes, options))
-                    .flat()
-                : sortNodes(nodes, options)
-            return makeFixes(fixer, nodes, sortedNodes, sourceCode)
-          },
-        })
-      }
-    })
+          let lastSortingNode =
+            (_a = accumulator.at(-1)) == null ? void 0 : _a.at(-1)
+          let sortingNode = {
+            name:
+              element.type === 'Literal'
+                ? `${element.value}`
+                : sourceCode.text.slice(...element.range),
+            size: rangeToDiff(element.range),
+            node: element,
+            group,
+          }
+          if (
+            (partitionComment &&
+              hasPartitionComment(
+                partitionComment,
+                getCommentsBefore(element, sourceCode),
+                options.matcher,
+              )) ||
+            (options.partitionByNewLine &&
+              lastSortingNode &&
+              getLinesBetween(sourceCode, lastSortingNode, sortingNode))
+          ) {
+            accumulator.push([])
+          }
+          accumulator.at(-1).push(sortingNode)
+        }
+        return accumulator
+      },
+      [[]],
+    )
+    for (let nodes of formattedMembers) {
+      pairwise(nodes, (left, right) => {
+        let groupKindOrder = ['unknown']
+        if (typeof options.groupKind === 'string') {
+          groupKindOrder =
+            options.groupKind === 'literals-first'
+              ? ['literal', 'spread']
+              : ['spread', 'literal']
+        }
+        let leftNum = getGroupNumber(groupKindOrder, left)
+        let rightNum = getGroupNumber(groupKindOrder, right)
+        if (
+          (options.groupKind !== 'mixed' && leftNum > rightNum) ||
+          ((options.groupKind === 'mixed' || leftNum === rightNum) &&
+            isPositive(compare(left, right, options)))
+        ) {
+          context.report({
+            messageId,
+            data: {
+              left: toSingleLine(left.name),
+              right: toSingleLine(right.name),
+            },
+            node: right.node,
+            fix: fixer => {
+              let sortedNodes =
+                options.groupKind !== 'mixed'
+                  ? groupKindOrder
+                      .map(group => nodes.filter(n => n.group === group))
+                      .map(groupedNodes => sortNodes(groupedNodes, options))
+                      .flat()
+                  : sortNodes(nodes, options)
+              return makeFixes(fixer, nodes, sortedNodes, sourceCode, options)
+            },
+          })
+        }
+      })
+    }
   }
 }
 export { sortArrayIncludes as default, jsonSchema, sortArray }