@front-cmdt/format 1.0.13 → 1.2.0

package/README.md

@@ -0,0 +1,79 @@
+# @front-cmdt/format
+
+Общий **Prettier config** для проектов. Включает сортировку импортов через `@trivago/prettier-plugin-sort-imports`.
+
+## Требования
+
+- `prettier` (peer dependency): `^3.0.0`
+
+## Установка
+
+```bash
+npm i -D @front-cmdt/format prettier
+# или
+yarn add -D @front-cmdt/format prettier
+# или
+pnpm add -D @front-cmdt/format prettier
+```
+
+### Создайте: `prettier.config.js` в проекте
+
+```js
+import config from "@front-cmdt/format/prettier"
+
+export default config
+```
+
+## Пример скриптов
+
+`package.json`:
+
+```json
+{
+  "scripts": {
+    "format": "prettier . --write",
+    "format:check": "prettier . --check"
+  }
+}
+```
+
+---
+
+# @front-cmdt/format (EN)
+
+Shared **Prettier config** for projects. Includes import sorting via `@trivago/prettier-plugin-sort-imports`.
+
+## Requirements
+
+- `prettier` (peer dependency): `^3.0.0`
+
+## Install
+
+```bash
+npm i -D @front-cmdt/format prettier
+# or
+yarn add -D @front-cmdt/format prettier
+# or
+pnpm add -D @front-cmdt/format prettier
+```
+
+### Create: `prettier.config.js` in your project
+
+```js
+import config from "@front-cmdt/format/prettier"
+
+export default config
+```
+
+## Script examples
+
+`package.json`:
+
+```json
+{
+  "scripts": {
+    "format": "prettier . --write",
+    "format:check": "prettier . --check"
+  }
+}
+```

package/package.json

@@ -1,7 +1,18 @@
 {
   "name": "@front-cmdt/format",
-  "version": "1.0.13",
-  "keywords": [],
+  "version": "1.2.0",
+  "keywords": [
+    "prettier",
+    "trivago",
+    "prettier-plugin-sort-imports",
+    "lint",
+    "linting",
+    "format",
+    "formatting",
+    "code style",
+    "code formatting",
+    "code styling"
+  ],
   "type": "module",
   "publishConfig": {
     "access": "public"

package/src/prettier.config.mjs

@@ -1,32 +1,65 @@
 /** @type {import("prettier").Config} */
 
 export default {
+  // Запятые в конце: "none" - без запятых, "es5" - где допустимо в ES5, "all" - везде
   trailingComma: "none",
+  // Количество пробелов для отступа
   tabWidth: 2,
-  useTabs: true,
+  // Использовать табы вместо пробелов
+  useTabs: false,
+  // Добавлять точку с запятой в конце выражений
   semi: false,
+  // Использовать одинарные кавычки вместо двойных
   singleQuote: true,
+  // Одинарные кавычки в JSX
   jsSingleQuote: true,
+  // Скобки вокруг единственного параметра стрелочной функции: "avoid" - убирать, "always" - всегда
   arrowParens: "avoid",
+  // Максимальная длина строки перед переносом
   printWidth: 120,
+  // Пробелы внутри фигурных скобок объектов: { foo: bar }
+  bracketSpacing: true,
+  // Кавычки вокруг ключей объекта: "as-needed" - только когда необходимо
+  quoteProps: "as-needed",
+  // Закрывающая скобка > на той же строке что и последний атрибут
+  bracketSameLine: false,
+  // Чувствительность к пробелам в HTML: "css" - как в CSS display свойстве
+  htmlWhitespaceSensitivity: "css",
 
+  // --- Настройки плагина сортировки импортов (@trivago/prettier-plugin-sort-imports) ---
+  // Добавлять пустую строку между группами импортов
   importOrderSeparation: true,
+  // Каждый атрибут JSX на отдельной строке
   singleAttributePerLine: true,
+  // Сортировать спецификаторы внутри импорта: import { a, b, c } from 'module'
   importOrderSortSpecifiers: true,
+  // Сортировка без учёта регистра
   importOrderInsensitive: true,
+  // Плагины парсера для корректной обработки синтаксиса
   importOrderParserPlugins: ["classProperties", "decorators-legacy", "typescript"],
+  // Порядок группировки импортов (регулярные выражения)
   importOrder: [
-    "<THIRD_PARTY_MODULES>",
-    "^react$",
+    "<THIRD_PARTY_MODULES>", // Сторонние модули (node_modules)
+    "^react$", // React отдельно
     // "^@/app/(.*)$",
     // "^@/pages/(.*)$",
     // "^@/widgets/(.*)$",
     // "^@/features/(.*)$",
     // "^@/entities/(.*)$",
     // "^@/shared/(.*)$",
-    "^@/(.*)$",
-    "^../(.*)$",
-    "^./(.*)$",
+    "^@/(.*)$", // Алиасы проекта (@/)
+    "^../(.*)$", // Относительные импорты из родительских директорий
+    "^./(.*)$", // Относительные импорты из текущей директории
+  ],
+  // Подключённые плагины Prettier
+  plugins: ["@trivago/prettier-plugin-sort-imports", "prettier-plugin-astro"],
+  // Переопределения для конкретных типов файлов
+  overrides: [
+    {
+      files: "*.astro",
+      options: {
+        parser: "astro", // Использовать Astro парсер для .astro файлов
+      },
+    },
   ],
-  plugins: ["@trivago/prettier-plugin-sort-imports"],
 }

package/.gitlab-ci.yml

@@ -1,41 +0,0 @@
-stages:
-  - publish
-
-publish:npm:
-  stage: publish
-  # NOTE: `image` работает только для Docker/Kubernetes executor.
-  # На Shell executor (как в вашем логе) этот параметр игнорируется.
-  image: node:22
-  rules:
-    # Аналог GitHub Actions: on.push.tags: ["v*"]
-    # Публикацию лучше разрешать только с protected-тегов, чтобы
-    # можно было хранить NPM_TOKEN как Protected variable.
-    - if: '$CI_COMMIT_TAG =~ /^v.*/ && $CI_COMMIT_REF_PROTECTED == "true"'
-      when: on_success
-    # На НЕ-protected тегах job будет виден, но только вручную.
-    # (Так вы увидите job в pipeline, даже если тег ещё не protected.)
-    - if: '$CI_COMMIT_TAG =~ /^v.*/'
-      when: manual
-    - when: never
-  script:
-    - node --version
-    - npm --version
-    # Фейлимся сразу, если токен не прокинулся (самая частая причина ENEEDAUTH)
-    - |
-      if [ -z "${NPM_TOKEN:-}" ]; then
-        echo "ERROR: NPM_TOKEN is not set for this job."
-        echo "Check GitLab CI/CD Variables: Protected/Masked/Environment scope and whether the tag/ref is protected."
-        exit 1
-      fi
-    # Явно создаём ~/.npmrc (npm умеет подставлять env vars вида ${NPM_TOKEN})
-    - |
-      cat > ~/.npmrc <<'EOF'
-      registry=https://registry.npmjs.org/
-      always-auth=true
-      //registry.npmjs.org/:_authToken=${NPM_TOKEN}
-      @front-cmdt:registry=https://registry.npmjs.org/
-      EOF
-    # Быстрая проверка авторизации (без публикации)
-    - npm whoami
-    - npm publish
-