eslint-plugin-perfectionist 3.7.0 → 3.9.0

package/dist/index.d.ts

@@ -12,6 +12,7 @@ declare type AccessorPropertySelector = 'accessor-property'
 
 declare type AdvancedSingleCustomGroup<T extends Selector> = {
   decoratorNamePattern?: string
+  elementValuePattern?: string
   elementNamePattern?: string
 } & BaseSingleCustomGroup<T>
 
@@ -114,6 +115,8 @@ declare const _default: {
         Partial<{
           type: 'alphabetical' | 'line-length' | 'natural'
           partitionByComment: string[] | boolean | string
+          specialCharacters: 'remove' | 'trim' | 'keep'
+          matcher: 'minimatch' | 'regex'
           partitionByNewLine: boolean
           order: 'desc' | 'asc'
           ignoreCase: boolean
@@ -129,6 +132,8 @@ declare const _default: {
         Partial<{
           type: 'alphabetical' | 'line-length' | 'natural'
           partitionByComment: string[] | boolean | string
+          specialCharacters: 'remove' | 'trim' | 'keep'
+          matcher: 'minimatch' | 'regex'
           groups: (
             | (
                 | 'object'
@@ -178,7 +183,9 @@ declare const _default: {
             [x: string]: string | string[]
           }
           type: 'alphabetical' | 'line-length' | 'natural'
+          specialCharacters: 'remove' | 'trim' | 'keep'
           groups: (string | string[])[]
+          matcher: 'minimatch' | 'regex'
           order: 'desc' | 'asc'
           ignoreCase: boolean
         }>,
@@ -194,7 +201,9 @@ declare const _default: {
             [x: string]: string | string[]
           }
           type: 'alphabetical' | 'line-length' | 'natural'
+          specialCharacters: 'remove' | 'trim' | 'keep'
           groups: (string | string[])[]
+          matcher: 'minimatch' | 'regex'
           order: 'desc' | 'asc'
           ignoreCase: boolean
         }>,
@@ -210,7 +219,9 @@ declare const _default: {
             [x: string]: string | string[]
           }
           type: 'alphabetical' | 'line-length' | 'natural'
+          specialCharacters: 'remove' | 'trim' | 'keep'
           groups: (string | string[])[]
+          matcher: 'minimatch' | 'regex'
           order: 'desc' | 'asc'
           ignoreCase: boolean
         }>,
@@ -231,6 +242,8 @@ declare const _default: {
           groupKind: 'values-first' | 'types-first' | 'mixed'
           type: 'alphabetical' | 'line-length' | 'natural'
           partitionByComment: string[] | boolean | string
+          specialCharacters: 'remove' | 'trim' | 'keep'
+          matcher: 'minimatch' | 'regex'
           partitionByNewLine: boolean
           order: 'desc' | 'asc'
           ignoreAlias: boolean
@@ -247,6 +260,8 @@ declare const _default: {
           groupKind: 'values-first' | 'types-first' | 'mixed'
           type: 'alphabetical' | 'line-length' | 'natural'
           partitionByComment: string[] | boolean | string
+          specialCharacters: 'remove' | 'trim' | 'keep'
+          matcher: 'minimatch' | 'regex'
           partitionByNewLine: boolean
           order: 'desc' | 'asc'
           ignoreCase: boolean
@@ -265,7 +280,9 @@ declare const _default: {
           }
           type: 'alphabetical' | 'line-length' | 'natural'
           partitionByComment: string[] | boolean | string
+          specialCharacters: 'remove' | 'trim' | 'keep'
           groups: (string | string[])[]
+          matcher: 'minimatch' | 'regex'
           partitionByNewLine: boolean
           order: 'desc' | 'asc'
           ignoreCase: boolean
@@ -280,6 +297,8 @@ declare const _default: {
         Partial<{
           type: 'alphabetical' | 'line-length' | 'natural'
           partitionByComment: string[] | boolean | string
+          specialCharacters: 'remove' | 'trim' | 'keep'
+          matcher: 'minimatch' | 'regex'
           groups: (
             | (
                 | 'object'
@@ -325,6 +344,7 @@ declare const _default: {
       [
         Partial<{
           type: 'alphabetical' | 'line-length' | 'natural'
+          specialCharacters: 'remove' | 'trim' | 'keep'
           order: 'desc' | 'asc'
           ignoreCase: boolean
         }>,
@@ -343,7 +363,9 @@ declare const _default: {
           }
           type: 'alphabetical' | 'line-length' | 'natural'
           partitionByComment: string[] | boolean | string
+          specialCharacters: 'remove' | 'trim' | 'keep'
           groups: (string | string[])[]
+          matcher: 'minimatch' | 'regex'
           partitionByNewLine: boolean
           ignorePattern: string[]
           order: 'desc' | 'asc'
@@ -361,7 +383,9 @@ declare const _default: {
             [x: string]: string | string[]
           }
           type: 'alphabetical' | 'line-length' | 'natural'
+          specialCharacters: 'remove' | 'trim' | 'keep'
           groups: (string | string[])[]
+          matcher: 'minimatch' | 'regex'
           ignorePattern: string[]
           order: 'desc' | 'asc'
           ignoreCase: boolean
@@ -379,35 +403,8 @@ declare const _default: {
       RuleListener
     >
     'sort-imports': RuleModule<
-      | 'missedSpacingBetweenImports'
-      | 'unexpectedImportsGroupOrder'
-      | 'extraSpacingBetweenImports'
-      | 'unexpectedImportsOrder',
-      [
-        Partial<{
-          customGroups: {
-            value?:
-              | {
-                  [x: string]: string | string[]
-                }
-              | undefined
-            type?:
-              | {
-                  [x: string]: string | string[]
-                }
-              | undefined
-          }
-          type: 'alphabetical' | 'line-length' | 'natural'
-          newlinesBetween: 'ignore' | 'always' | 'never'
-          groups: (string | string[])[]
-          environment: 'node' | 'bun'
-          internalPattern: string[]
-          sortSideEffects: boolean
-          maxLineLength?: number
-          order: 'desc' | 'asc'
-          ignoreCase: boolean
-        }>,
-      ],
+      MESSAGE_ID,
+      Options_2<string[]>,
       unknown,
       RuleListener
     >
@@ -418,6 +415,8 @@ declare const _default: {
           groupKind: 'values-first' | 'types-first' | 'mixed'
           type: 'alphabetical' | 'line-length' | 'natural'
           partitionByComment: string[] | boolean | string
+          specialCharacters: 'remove' | 'trim' | 'keep'
+          matcher: 'minimatch' | 'regex'
           partitionByNewLine: boolean
           order: 'desc' | 'asc'
           ignoreCase: boolean
@@ -437,6 +436,8 @@ declare const _default: {
           }
           type: 'alphabetical' | 'line-length' | 'natural'
           partitionByComment: string[] | boolean | string
+          specialCharacters: 'remove' | 'trim' | 'keep'
+          matcher: 'minimatch' | 'regex'
           groups: (string[] | string)[]
           partitionByNewLine: boolean
           styledComponents: boolean
@@ -451,7 +452,7 @@ declare const _default: {
     >
     'sort-enums': RuleModule<
       'unexpectedEnumsDependencyOrder' | 'unexpectedEnumsOrder',
-      Options_2,
+      Options_3,
       unknown,
       RuleListener
     >
@@ -467,6 +468,8 @@ declare const _default: {
         Partial<{
           type: 'alphabetical' | 'line-length' | 'natural'
           partitionByComment: string[] | boolean | string
+          specialCharacters: 'remove' | 'trim' | 'keep'
+          matcher: 'minimatch' | 'regex'
           partitionByNewLine: boolean
           order: 'desc' | 'asc'
           ignoreCase: boolean
@@ -512,11 +515,38 @@ declare type Group =
   | 'unknown'
   | string
 
+declare type Group_2<T extends string[]> =
+  | 'side-effect-style'
+  | 'external-type'
+  | 'internal-type'
+  | 'builtin-type'
+  | 'sibling-type'
+  | 'parent-type'
+  | 'side-effect'
+  | 'index-type'
+  | 'internal'
+  | 'external'
+  | T[number]
+  | 'sibling'
+  | 'unknown'
+  | 'builtin'
+  | 'parent'
+  | 'object'
+  | 'index'
+  | 'style'
+  | 'type'
+
 declare type IndexSignatureGroup =
   `${StaticModifierPrefix}${ReadonlyModifierPrefix}${IndexSignatureSelector}`
 
 declare type IndexSignatureSelector = 'index-signature'
 
+declare type MESSAGE_ID =
+  | 'missedSpacingBetweenImports'
+  | 'unexpectedImportsGroupOrder'
+  | 'extraSpacingBetweenImports'
+  | 'unexpectedImportsOrder'
+
 declare type MethodGroup =
   `${PublicOrProtectedOrPrivateModifierPrefix}${StaticOrAbstractModifierPrefix}${OverrideModifierPrefix}${DecoratedModifierPrefix}${OptionalModifierPrefix}${MethodSelector}`
 
@@ -534,16 +564,44 @@ declare type Options = [
     groupKind: 'literals-first' | 'spreads-first' | 'mixed'
     type: 'alphabetical' | 'line-length' | 'natural'
     partitionByComment: string[] | boolean | string
+    specialCharacters: 'remove' | 'trim' | 'keep'
+    matcher: 'minimatch' | 'regex'
     partitionByNewLine: boolean
     order: 'desc' | 'asc'
     ignoreCase: boolean
   }>,
 ]
 
-declare type Options_2 = [
+declare type Options_2<T extends string[]> = [
+  Partial<{
+    customGroups: {
+      value?: {
+        [key in T[number]]: string[] | string
+      }
+      type?: {
+        [key in T[number]]: string[] | string
+      }
+    }
+    type: 'alphabetical' | 'line-length' | 'natural'
+    newlinesBetween: 'ignore' | 'always' | 'never'
+    specialCharacters: 'remove' | 'trim' | 'keep'
+    groups: (Group_2<T>[] | Group_2<T>)[]
+    matcher: 'minimatch' | 'regex'
+    environment: 'node' | 'bun'
+    internalPattern: string[]
+    sortSideEffects: boolean
+    maxLineLength?: number
+    order: 'desc' | 'asc'
+    ignoreCase: boolean
+  }>,
+]
+
+declare type Options_3 = [
   Partial<{
     type: 'alphabetical' | 'line-length' | 'natural'
     partitionByComment: string[] | boolean | string
+    specialCharacters: 'remove' | 'trim' | 'keep'
+    matcher: 'minimatch' | 'regex'
     partitionByNewLine: boolean
     forceNumericSort: boolean
     order: 'desc' | 'asc'
@@ -610,6 +668,8 @@ declare type SortClassesOptions = [
       | CustomGroup[]
     type: 'alphabetical' | 'line-length' | 'natural'
     partitionByComment: string[] | boolean | string
+    specialCharacters: 'remove' | 'trim' | 'keep'
+    matcher: 'minimatch' | 'regex'
     groups: (Group[] | Group)[]
     order: 'desc' | 'asc'
     ignoreCase: boolean

package/dist/index.js

@@ -47,10 +47,13 @@ let plugin = {
 }
 let getRules = options =>
   Object.fromEntries(
-    Object.keys(plugin.rules).map(rule => [
-      `${name}/${rule}`,
-      ['error', options],
-    ]),
+    Object.entries(plugin.rules).reduce(
+      (accumulator, [ruleName, ruleValue]) =>
+        ruleValue.meta.deprecated
+          ? accumulator
+          : [...accumulator, [`${name}/${ruleName}`, ['error', options]]],
+      [],
+    ),
   )
 let createConfig = options => ({
   plugins: {

package/dist/index.mjs

@@ -46,10 +46,13 @@ let plugin = {
 }
 let getRules = options =>
   Object.fromEntries(
-    Object.keys(plugin.rules).map(rule => [
-      `${name}/${rule}`,
-      ['error', options],
-    ]),
+    Object.entries(plugin.rules).reduce(
+      (accumulator, [ruleName, ruleValue]) =>
+        ruleValue.meta.deprecated
+          ? accumulator
+          : [...accumulator, [`${name}/${ruleName}`, ['error', options]]],
+      [],
+    ),
   )
 let createConfig = options => ({
   plugins: {

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

@@ -32,10 +32,21 @@ 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',
     },
+    specialCharacters: {
+      description:
+        'Controls how special characters should be handled before sorting.',
+      type: 'string',
+      enum: ['remove', 'trim', 'keep'],
+    },
     groupKind: {
       description: 'Specifies top-level groups.',
       enum: ['mixed', 'literals-first', 'spreads-first'],
@@ -86,6 +97,8 @@ const sortArrayIncludes = createEslintRule.createEslintRule({
       type: 'alphabetical',
       order: 'asc',
       ignoreCase: true,
+      specialCharacters: 'keep',
+      matcher: 'minimatch',
       groupKind: 'literals-first',
       partitionByComment: false,
       partitionByNewLine: false,
@@ -115,6 +128,8 @@ let sortArray = (context, messageId, elements) => {
       groupKind: 'literals-first',
       type: 'alphabetical',
       ignoreCase: true,
+      specialCharacters: 'keep',
+      matcher: 'minimatch',
       order: 'asc',
       partitionByComment: false,
       partitionByNewLine: false,
@@ -145,6 +160,7 @@ let sortArray = (context, messageId, elements) => {
               isPartitionComment.hasPartitionComment(
                 partitionComment,
                 getCommentsBefore.getCommentsBefore(element, sourceCode),
+                options.matcher,
               )) ||
             (options.partitionByNewLine &&
               lastSortingNode &&
@@ -200,9 +216,7 @@ let sortArray = (context, messageId, elements) => {
                 nodes,
                 sortedNodes,
                 sourceCode,
-                {
-                  partitionComment,
-                },
+                options,
               )
             },
           })

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

@@ -27,10 +27,21 @@ 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',
     },
+    specialCharacters: {
+      description:
+        'Controls how special characters should be handled before sorting.',
+      type: 'string',
+      enum: ['remove', 'trim', 'keep'],
+    },
     groupKind: {
       description: 'Specifies top-level groups.',
       enum: ['mixed', 'literals-first', 'spreads-first'],
@@ -81,6 +92,8 @@ const sortArrayIncludes = createEslintRule({
       type: 'alphabetical',
       order: 'asc',
       ignoreCase: true,
+      specialCharacters: 'keep',
+      matcher: 'minimatch',
       groupKind: 'literals-first',
       partitionByComment: false,
       partitionByNewLine: false,
@@ -110,6 +123,8 @@ let sortArray = (context, messageId, elements) => {
       groupKind: 'literals-first',
       type: 'alphabetical',
       ignoreCase: true,
+      specialCharacters: 'keep',
+      matcher: 'minimatch',
       order: 'asc',
       partitionByComment: false,
       partitionByNewLine: false,
@@ -140,6 +155,7 @@ let sortArray = (context, messageId, elements) => {
               hasPartitionComment(
                 partitionComment,
                 getCommentsBefore(element, sourceCode),
+                options.matcher,
               )) ||
             (options.partitionByNewLine &&
               lastSortingNode &&
@@ -184,9 +200,7 @@ let sortArray = (context, messageId, elements) => {
                       .map(groupedNodes => sortNodes(groupedNodes, options))
                       .flat()
                   : sortNodes(nodes, options)
-              return makeFixes(fixer, nodes, sortedNodes, sourceCode, {
-                partitionComment,
-              })
+              return makeFixes(fixer, nodes, sortedNodes, sourceCode, options)
             },
           })
         }

package/dist/rules/sort-astro-attributes.js

@@ -19,6 +19,8 @@ const sortAstroAttributes = createEslintRule.createEslintRule({
       description: 'Enforce sorted Astro attributes.',
     },
     fixable: 'code',
+    deprecated: true,
+    replacedBy: ['astro/sort-attributes'],
     schema: [
       {
         type: 'object',
@@ -34,11 +36,22 @@ const sortAstroAttributes = createEslintRule.createEslintRule({
             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',
           },
+          specialCharacters: {
+            description:
+              'Controls how special characters should be handled before sorting.',
+            type: 'string',
+            enum: ['remove', 'trim', 'keep'],
+          },
           groups: {
             description: 'Specifies the order of the groups.',
             type: 'array',
@@ -89,6 +102,8 @@ const sortAstroAttributes = createEslintRule.createEslintRule({
       type: 'alphabetical',
       order: 'asc',
       ignoreCase: true,
+      specialCharacters: 'keep',
+      matcher: 'minimatch',
       groups: [],
       customGroups: {},
     },
@@ -106,6 +121,8 @@ const sortAstroAttributes = createEslintRule.createEslintRule({
           let options = complete.complete(context.options.at(0), settings, {
             type: 'alphabetical',
             ignoreCase: true,
+            specialCharacters: 'keep',
+            matcher: 'minimatch',
             customGroups: {},
             order: 'asc',
             groups: [],
@@ -127,7 +144,7 @@ const sortAstroAttributes = createEslintRule.createEslintRule({
                   ? attribute.name.name
                   : sourceCode.text.slice(...attribute.name.range)
               let { getGroup, defineGroup, setCustomGroups } =
-                useGroups.useGroups(options.groups)
+                useGroups.useGroups(options)
               setCustomGroups(options.customGroups, name)
               if (attribute.type === 'AstroShorthandAttribute') {
                 defineGroup('astro-shorthand')

package/dist/rules/sort-astro-attributes.mjs

@@ -18,6 +18,8 @@ const sortAstroAttributes = createEslintRule({
       description: 'Enforce sorted Astro attributes.',
     },
     fixable: 'code',
+    deprecated: true,
+    replacedBy: ['astro/sort-attributes'],
     schema: [
       {
         type: 'object',
@@ -33,11 +35,22 @@ const sortAstroAttributes = createEslintRule({
             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',
           },
+          specialCharacters: {
+            description:
+              'Controls how special characters should be handled before sorting.',
+            type: 'string',
+            enum: ['remove', 'trim', 'keep'],
+          },
           groups: {
             description: 'Specifies the order of the groups.',
             type: 'array',
@@ -88,6 +101,8 @@ const sortAstroAttributes = createEslintRule({
       type: 'alphabetical',
       order: 'asc',
       ignoreCase: true,
+      specialCharacters: 'keep',
+      matcher: 'minimatch',
       groups: [],
       customGroups: {},
     },
@@ -105,6 +120,8 @@ const sortAstroAttributes = createEslintRule({
           let options = complete(context.options.at(0), settings, {
             type: 'alphabetical',
             ignoreCase: true,
+            specialCharacters: 'keep',
+            matcher: 'minimatch',
             customGroups: {},
             order: 'asc',
             groups: [],
@@ -125,9 +142,8 @@ const sortAstroAttributes = createEslintRule({
                 typeof attribute.name.name === 'string'
                   ? attribute.name.name
                   : sourceCode.text.slice(...attribute.name.range)
-              let { getGroup, defineGroup, setCustomGroups } = useGroups(
-                options.groups,
-              )
+              let { getGroup, defineGroup, setCustomGroups } =
+                useGroups(options)
               setCustomGroups(options.customGroups, name)
               if (attribute.type === 'AstroShorthandAttribute') {
                 defineGroup('astro-shorthand')

package/dist/rules/sort-classes-utils.js

@@ -1,6 +1,8 @@
 'use strict'
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
-const minimatch = require('minimatch')
+const validateGroupsConfiguration$1 = require('../utils/validate-groups-configuration.js')
+const sortClasses_types = require('./sort-classes.types.js')
+const matches = require('../utils/matches.js')
 const cachedGroupsByModifiersAndSelectors = /* @__PURE__ */ new Map()
 const generateOfficialGroups = (modifiers, selectors) => {
   let modifiersAndSelectorsKey = modifiers.join('&') + '/' + selectors.join('&')
@@ -119,26 +121,35 @@ const customGroupMatches = props => {
     'elementNamePattern' in props.customGroup &&
     props.customGroup.elementNamePattern
   ) {
-    let matchesElementNamePattern = minimatch.minimatch(
+    let matchesElementNamePattern = matches.matches(
       props.elementName,
       props.customGroup.elementNamePattern,
-      {
-        nocomment: true,
-      },
+      props.matcher,
     )
     if (!matchesElementNamePattern) {
       return false
     }
   }
+  if (
+    'elementValuePattern' in props.customGroup &&
+    props.customGroup.elementValuePattern
+  ) {
+    let matchesElementValuePattern = matches.matches(
+      props.elementValue ?? '',
+      props.customGroup.elementValuePattern,
+      props.matcher,
+    )
+    if (!matchesElementValuePattern) {
+      return false
+    }
+  }
   if (
     'decoratorNamePattern' in props.customGroup &&
     props.customGroup.decoratorNamePattern
   ) {
     let decoratorPattern = props.customGroup.decoratorNamePattern
     let matchesDecoratorNamePattern = props.decorators.some(decorator =>
-      minimatch.minimatch(decorator, decoratorPattern, {
-        nocomment: true,
-      }),
+      matches.matches(decorator, decoratorPattern, props.matcher),
     )
     if (!matchesDecoratorNamePattern) {
       return false
@@ -161,10 +172,53 @@ const getCompareOptions = (options, groupNumber) => {
       customGroup && 'order' in customGroup && customGroup.order
         ? customGroup.order
         : options.order,
+    specialCharacters: options.specialCharacters,
     ignoreCase: options.ignoreCase,
   }
 }
+let validateGroupsConfiguration = (groups, customGroups) => {
+  let availableCustomGroupNames = Array.isArray(customGroups)
+    ? customGroups.map(customGroup => customGroup.groupName)
+    : Object.keys(customGroups)
+  let invalidGroups = groups
+    .flat()
+    .filter(
+      group =>
+        !isPredefinedGroup(group) && !availableCustomGroupNames.includes(group),
+    )
+  if (invalidGroups.length) {
+    throw new Error('Invalid group(s): ' + invalidGroups.join(', '))
+  }
+  validateGroupsConfiguration$1.validateNoDuplicatedGroups(groups)
+}
+const isPredefinedGroup = input => {
+  if (input === 'unknown') {
+    return true
+  }
+  let singleWordSelector = input.split('-').at(-1)
+  if (!singleWordSelector) {
+    return false
+  }
+  let twoWordsSelector = input.split('-').slice(-2).join('-')
+  let isTwoWordSelectorValid =
+    sortClasses_types.allSelectors.includes(twoWordsSelector)
+  if (
+    !sortClasses_types.allSelectors.includes(singleWordSelector) &&
+    !isTwoWordSelectorValid
+  ) {
+    return false
+  }
+  let modifiers = input.split('-').slice(0, isTwoWordSelectorValid ? -2 : -1)
+  return (
+    new Set(modifiers).size === modifiers.length &&
+    modifiers.every(modifier =>
+      sortClasses_types.allModifiers.includes(modifier),
+    )
+  )
+}
 exports.customGroupMatches = customGroupMatches
 exports.generateOfficialGroups = generateOfficialGroups
+exports.getCombinations = getCombinations
 exports.getCompareOptions = getCompareOptions
 exports.getOverloadSignatureGroups = getOverloadSignatureGroups
+exports.validateGroupsConfiguration = validateGroupsConfiguration