@nitra/cursor 1.3.3 → 1.3.5

package/bin/nitra-cursor.js

@@ -6,7 +6,7 @@
  * Завантажує cursor-правила з npm-пакету nitra-cursor у локальний репозиторій.
  *
  * Використання:
- *   npx @nitra/cursor
+ *   `npx @nitra/cursor`
  *
  * Якщо у корені репозиторію немає nitra-cursor.json, він створюється автоматично
  * з усіма правилами з каталогу mdc пакету (їх можна відредагувати після створення).
@@ -199,14 +199,10 @@ async function removeOrphanManagedRuleFiles(rulesDir, configRules) {
   const names = await readdir(rulesDir)
   const removed = []
   for (const name of names) {
-    if (!name.endsWith('.mdc') || !name.startsWith(RULE_PREFIX)) {
-      continue
+    if (name.endsWith('.mdc') && name.startsWith(RULE_PREFIX) && !expected.has(name)) {
+      await unlink(join(rulesDir, name))
+      removed.push(name)
     }
-    if (expected.has(name)) {
-      continue
-    }
-    await unlink(join(rulesDir, name))
-    removed.push(name)
   }
   return removed.sort((a, b) => a.localeCompare(b))
 }

package/mdc/js-format.mdc

@@ -1,7 +1,7 @@
 ---
 description: Правила форматів JavaScript ecosystem
 alwaysApply: true
-version: '1.2'
+version: '1.3'
 ---
 
 В корені проекту є файл з правилами форматування для oxfmt:

package/mdc/js-lint.mdc

@@ -0,0 +1,102 @@
+---
+description: Перевірка JavaScript коду
+alwaysApply: true
+version: '1.2'
+---
+
+Перевірка виконується за допомогою **oxlint** та **ESLint**.
+
+У файлі `.vscode/extensions.json` мають бути рекомендації розширень:
+
+```json title=".vscode/extensions.json"
+{
+  "recommendations": [
+    "dbaeumer.vscode-eslint",
+    "github.vscode-github-actions",
+    "oxc.oxc-vscode"
+  ]
+}
+```
+
+У кореневому `package.json` додай скрипт і залежність:
+
+```json title="package.json"
+  "scripts": {
+    "lint-js": "oxlint --fix && bunx eslint --fix ."
+  },
+  "devDependencies": {
+    "@nitra/eslint-config": "^3.0.7"
+  }
+```
+
+У `devDependencies` достатньо `@nitra/eslint-config` (залежності ESLint підтягуються разом із ним). **oxlint** і **eslint** у скриптах викликай через `bunx`; окремо не додавай пакети `oxlint` / `eslint`, якщо цього не вимагає ваш монорепо.
+
+Додай workflow `.github/workflows/lint-js.yml`:
+
+```yaml
+name: Lint JS
+
+on:
+  push:
+    branches:
+      - dev
+    paths:
+      - '**/*.js'
+      - '**/*.mjs'
+      - '**/*.cjs'
+      - '**/*.jsx'
+      - '**/*.ts'
+      - '**/*.tsx'
+      - '**/*.vue'
+      - '**/eslint.config.*'
+
+  pull_request:
+    branches:
+      - dev
+
+concurrency:
+  group: ${{ github.ref }}-${{ github.workflow }}
+  cancel-in-progress: true
+
+jobs:
+  eslint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+
+      - name: Cache Bun dependencies
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.bun/install/cache
+            node_modules
+          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-bun-
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Eslint
+        run: |
+          bunx oxlint
+          bunx eslint .
+```
+
+**Без дублювання CI:** якщо в `.github/workflows` уже є `lint.yml` з тими самими кроками `oxlint` або `eslint`,  видали зайвий workflow — лінт JS має виконуватися в одному місці.
+
+У корені проєкту має бути `eslint.config.js` із розподілом директорій за типом коду:
+
+```javascript title="eslint.config.js"
+import { getConfig } from '@nitra/eslint-config'
+
+export default [
+  ...getConfig({
+    node: ['npm']
+  })
+]
+```
+
+У монорепо пакети з Vite (frontend) вкажи в секції `vue`, решту — у секції `node` у виклику `getConfig`.

package/mdc/nginx-default-tpl.mdc

@@ -66,7 +66,7 @@ server {
 }
 ```
 
-Тобто в ньому не потрібно щоб було жодного proxy_pass секціі і інших опцій для проxy.
+Тобто в ньому не потрібно щоб було жодного proxy_pass секціі і інших опцій для proxy.
 
 Якщо в файлі вже були proxy_pass секції, то їх логіку потрібно перенести до HTTPRoute в k8s.
 
@@ -87,10 +87,19 @@ spec:
               type: ReplaceFullPath
               replaceFullPath: /$PUBLIC_PATH/
             statusCode: 301
+    - matches:
+        - path:
+            type: PathPrefix
+            value: /$PUBLIC_PATH/
+      backendRefs:
+        - name: $SERVICE_NAME
+          port: 8080
 ```
 
 де $PUBLIC_PATH підставляється з ini файлу з dev середовища, а якщо для інших середовищ відрізняється то підставляється в kustomization.ya,l відповідні значення з ini середовища.
 
+В $SERVICE_NAME повинно бути вказано ім'я сервісу, яке буде використовуватися в k8s.
+
 В Dockerfile потрібно додати команду для стиснення файлів, які потім використовуватимуться з `gzip_static on`:
 
 ```dockerfile
@@ -111,7 +120,6 @@ RUN NAMES=$(sed -nE '/^\s*[#;]/d; /^\s*$/d; s/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=.*
 
 Якщо у конфігураційних файлах *.ini є змінні які відсутні в default.conf.template, то їх потрібно вилучити.
 
-
 в файлі .vscode/extensions.json є налаштування для NGINX Configuration Language Support:
 
 ```json title=".vscode/extensions.json"

package/mdc/{stylelint.mdc → style-lint.mdc}

@@ -4,7 +4,7 @@ alwaysApply: true
 version: '1.0'
 ---
 
-в файлі .vscode/extensions.json є налаштування для офіційного плагіну:
+В файлі .vscode/extensions.json є налаштування для офіційного плагіну:
 
 ```json title=".vscode/extensions.json"
 {
@@ -32,7 +32,7 @@ version: '1.0'
     "lint-style": "stylelint '**/*.{css,scss,vue}' --fix",
   },
   "devDependencies": {
-    "@nitra/stylelint-config": "^1.3.0"
+    "@nitra/stylelint-config": "^1.4.0"
   },
   "stylelint": {
     "extends": "@nitra/stylelint-config"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "CLI для завантаження cursor-правил Nitra у локальний репозиторій",
   "keywords": [
     "cli",
@@ -31,5 +31,7 @@
   "scripts": {
     "test": "npx coverage-node test/index.js"
   },
-  "dependencies": {}
+  "engines": {
+    "node": ">=24"
+  }
 }