arui-presets-lint 9.5.1 → 9.6.1

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+## 9.6.1
+
+### Patch Changes
+
+- [#128](https://github.com/core-ds/arui-presets-lint/pull/128) [`bb55225`](https://github.com/core-ds/arui-presets-lint/commit/bb5522545b99f3ecc383f17f77dcfbcbfce91662) Thanks [@dmitrbrvsk](https://github.com/dmitrbrvsk)! - Для правила import-x/no-cycle задан maxDepth вместе с ignoreExternal, чтобы снизить время линта на больших графах импортов. В V9_MIGRATION_GUIDE описан компромисс и как переопределить правило в проекте
+
+- Updated dependencies []:
+    - @alfalab/stylelint-core-vars@2.1.1
+
+## 9.6.0
+
+### Minor Changes
+
+- [#125](https://github.com/core-ds/arui-presets-lint/pull/125) [`292ec32`](https://github.com/core-ds/arui-presets-lint/commit/292ec32d3f412dcb8f174256c73fe86b12951b02) Thanks [@dmitrbrvsk](https://github.com/dmitrbrvsk)! - В пресет stylelint добавлен плагин `stylelint-order` и правила `order/properties-order` и `order/order`.
+  За счёт них выравнивается порядок css свойств и выстраивается единообразный порядок вложенности в блоке.
+
+### Patch Changes
+
+- Updated dependencies []:
+    - @alfalab/stylelint-core-vars@2.1.1
+
 ## 9.5.1
 
 ### Patch Changes

package/V9_MIGRATION_GUIDE.md

@@ -78,6 +78,23 @@ export default defineConfig(eslintConfig, [
 
     Так же все правила в конфиге которые начинаються на `import/` нужно заменить на `import-x/`. Других изменений делать не нужно, новый плагин полностью совместим со старым.
 
+    **Производительность `import-x/no-cycle`.**
+    Правило «дорогое»: оно обходит зависимости, чтобы найти путь обратно к текущему файлу.
+    В пресете это задано в [`eslint/rules/imports.ts`](eslint/rules/imports.ts): по умолчанию включены **`ignoreExternal: true`** и **`maxDepth: 20`** (см. [документацию правила](https://github.com/un-ts/eslint-plugin-import-x/blob/master/docs/rules/no-cycle.md)). Циклы длиннее этого порога ESLint не сообщит.
+    Если необходима проверка без ограничения глубины или другое значение, то переопределите правило в своём `eslint.config.mts`:
+
+    ```typescript
+    {
+        rules: {
+            'import-x/no-cycle': ['error', { ignoreExternal: true, maxDepth: 50 }],
+            // или полная проверка без maxDepth (может сильно увеличить время линта):
+            // 'import-x/no-cycle': ['error', { ignoreExternal: true }],
+            // или отключить правило:
+            // 'import-x/no-cycle': 'off',
+        },
+    },
+    ```
+
 4. Набор правил eslint изменился - но многие правятся с помощью автофикса. Сделаем это!
 
     ```bash

package/eslint/rules/imports.js

@@ -165,7 +165,8 @@ export const importsConfig = {
         'import-x/no-self-import': 'error',
         // Запрещать циклические зависимости между модулями
         // https://github.com/un-ts/eslint-plugin-import-x/blob/master/docs/rules/no-cycle.md
-        'import-x/no-cycle': ['error', { ignoreExternal: true }],
+        // maxDepth ограничивает глубину обхода графа импортов (без лимита правило сильно замедляет линтинг на больших проектах)
+        'import-x/no-cycle': ['error', { ignoreExternal: true, maxDepth: 20 }],
         // Гарантировать отсутствие бесполезных сегментов пути
         // https://github.com/un-ts/eslint-plugin-import-x/blob/master/docs/rules/no-useless-path-segments.md
         'import-x/no-useless-path-segments': ['error', { noUselessIndex: true }],

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "arui-presets-lint",
-    "version": "9.5.1",
+    "version": "9.6.1",
     "description": "Config files for arui-apps",
     "author": "core-ds contributors",
     "license": "MIT",
@@ -35,6 +35,7 @@
         "lefthook": "2.1.6",
         "prettier": "3.8.3",
         "stylelint": "16.26.1",
+        "stylelint-order": "8.1.1",
         "typescript-eslint": "8.59.1"
     },
     "engines": {

package/stylelint/index.d.ts

@@ -51,6 +51,18 @@ declare const _default: {
             except: string[];
             ignore: string[];
         })[];
+        'order/properties-order': string[];
+        'order/order': ((string | {
+            type: string;
+            name: string;
+            selector?: undefined;
+        } | {
+            type: string;
+            selector: string;
+            name?: undefined;
+        })[] | {
+            severity: string;
+        })[];
     };
     plugins: string[];
     overrides: {

package/stylelint/index.js

@@ -125,8 +125,39 @@ export default {
                 ignore: ['after-comment'],
             },
         ],
+        // Задаёт порядок перечисленных свойств относительно друг друга
+        // https://github.com/hudochenkov/stylelint-order/blob/master/rules/properties-order/README.md
+        'order/properties-order': ['position', 'z-index', 'top', 'right', 'bottom', 'left'],
+        // Требует порядок вложенности: декларации > @media > псевдоэлементы > псевдоклассы > &__ > вложенные классы
+        // https://github.com/hudochenkov/stylelint-order/blob/master/rules/order/README.md
+        'order/order': [
+            [
+                'declarations',
+                {
+                    type: 'at-rule',
+                    name: 'media',
+                },
+                {
+                    type: 'rule',
+                    selector: '^&::(before|after)',
+                },
+                {
+                    type: 'rule',
+                    selector: String.raw `^&:\w`,
+                },
+                {
+                    type: 'rule',
+                    selector: '^&_',
+                },
+                {
+                    type: 'rule',
+                    selector: '^.',
+                },
+            ],
+            { severity: 'warning' },
+        ],
     },
-    plugins: ['@alfalab/stylelint-core-vars'],
+    plugins: ['stylelint-order', '@alfalab/stylelint-core-vars'],
     overrides: [
         {
             files: ['*.module.css'],