@7n/rules-lang-js 0.5.0 → 0.6.0

package/rules/style/package_json/package_json.rego

@@ -0,0 +1,31 @@
+# Порт перевірок `package.json` (style.mdc).
+#
+# Канон надходить через --data: { "template": { "contains": ..., "snippet": ... } }
+# Структура --data сформована з template/package.json.{contains,snippet}.json.
+# FS-альтернативи (`.stylelintrc.*` файли) + `.stylelintignore` — у JS.
+#
+# Логіка, що ЛИШАЄТЬСЯ у rego (inverse — не виноситься у template):
+#  - `@nitra/stylelint-config` має бути у devDependencies (presence-check).
+package style.package_json
+
+import rego.v1
+
+# ── deny: 2-level snippet walker (для stylelint.extends, якщо поле є) ────
+
+deny contains msg if {
+	some section, expected_inner in data.template.snippet
+	cfg := object.get(input, section, null)
+	is_object(cfg)
+	some leaf_key, expected_value in expected_inner
+	actual := object.get(cfg, leaf_key, null)
+	actual != expected_value
+	msg := sprintf("package.json: %s.%s має бути %q (style.mdc)", [section, leaf_key, expected_value])
+}
+
+# ── deny: @nitra/stylelint-config у devDependencies (inverse) ────────────
+
+deny contains msg if {
+	dev := object.get(input, "devDependencies", {})
+	not "@nitra/stylelint-config" in object.keys(dev)
+	msg := "@nitra/stylelint-config відсутній — bun add -d @nitra/stylelint-config (style.mdc)"
+}

package/rules/style/package_json/template/package.json.snippet.json

@@ -0,0 +1,5 @@
+{
+  "stylelint": {
+    "extends": "@nitra/stylelint-config"
+  }
+}

package/rules/style/quasar/concern.json

@@ -0,0 +1,3 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json"
+}

package/rules/style/quasar/quasar.mdc

@@ -0,0 +1,7 @@
+## Quasar як стильова основа
+
+У Vue-проектах використовуй **Quasar** як базову стильову систему:
+
+- **Класи компонентів:** `q-pa-*`, `q-ma-*`, `q-mt-*`, `q-mb-*`, `row`, `col`, `col-*`, `items-center`, `justify-between`, `text-*`, `bg-*`, `shadow-*` тощо — стандартні утиліти Quasar.
+- **Кольори:** використовуй Quasar CSS-змінні через класи (`text-primary`, `bg-accent`, `text-negative` тощо) або через SCSS-змінні (`$primary`, `$accent`) у `.scss`-файлах.
+- **Не пиши власні утиліти**, якщо є відповідний Quasar-клас.

package/rules/style/quasar_fixes/concern.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "lint": {
+    "scope": "full",
+    "glob": ["**/*.vue", "**/*.scss", "**/*.css"]
+  }
+}

package/rules/style/quasar_fixes/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/style/quasar_fixes
+resource: plugins/lang-js/rules/style/quasar_fixes/
+---
+
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [main.mjs](main.md) | JS Module |

package/rules/style/quasar_fixes/docs/main.md

@@ -0,0 +1,16 @@
+---
+type: JS Module
+title: main.mjs
+resource: plugins/lang-js/rules/style/quasar_fixes/main.mjs
+docgen:
+  crc: 0f9c4631
+---
+
+## Огляд
+
+Детектор concern-а `quasar_fixes` (read-only, whole-repo): якщо `.vue`-файл використовує
+`<q-scroll-area>` або `<q-tooltip>`, десь у `.scss`/`.css`/`.vue` проєкту має бути
+відповідний CSS-фікс (`.q-scrollarea` / `.q-tooltip`) — інакше порушення
+`missing-quasar-fix`. iOS-zoom-фікс (тригер на `input`/`textarea`/`select`) навмисно не
+перевіряється — надто загальний тригер, false-positive на майже будь-якій формі. Whole-repo
+сканування, не залежить від `ctx.files`.

package/rules/style/quasar_fixes/main.mjs

@@ -0,0 +1,57 @@
+/** @see ./docs/main.md */
+import { readFile } from 'node:fs/promises'
+
+import { createViolationReporter } from '@7n/rules/scripts/lib/lint-surface/violation-reporter.mjs'
+import { walkDir } from '@7n/rules/scripts/utils/walkDir.mjs'
+
+const RELEVANT_RE = /\.(?:vue|scss|css)$/u
+
+/**
+ * Пари (usage у `.vue` → очікуваний CSS-фікс) з guide `quasar_fixes.mdc`. Навмисно НЕ
+ * включено iOS-zoom-фікс (тригер `input`/`textarea`/`select` — занадто загальний,
+ * false-positive на майже будь-якій формі; консервативно залишено лише narrative).
+ */
+const FIXES = [
+  { usage: /<q-scroll-area\b/u, definition: /\.q-scrollarea\b/u, name: 'q-scroll-area', selector: '.q-scrollarea' },
+  { usage: /<q-tooltip\b/u, definition: /\.q-tooltip\b/u, name: 'q-tooltip', selector: '.q-tooltip' }
+]
+
+/**
+ * Detector style/quasar_fixes (read-only, whole-repo): якщо `.vue` використовує
+ * `<q-scroll-area>` або `<q-tooltip>`, у `.scss`/`.css`/`.vue` має бути відповідний
+ * CSS-фікс (guide: `quasar_fixes.mdc`). Крос-файлова перевірка usage↔definition —
+ * потребує whole-repo сканування незалежно від `ctx.files`.
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd)
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
+ */
+export async function lint(ctx) {
+  const reporter = createViolationReporter(ctx)
+  const { fail } = reporter
+  const cwd = ctx.cwd
+
+  /** @type {string[]} */
+  const files = []
+  await walkDir(cwd, f => {
+    if (RELEVANT_RE.test(f)) files.push(f)
+  })
+
+  const used = new Set()
+  const defined = new Set()
+  for (const file of files) {
+    const content = await readFile(file, 'utf8')
+    for (const fix of FIXES) {
+      if (file.endsWith('.vue') && !used.has(fix.name) && fix.usage.test(content)) used.add(fix.name)
+      if (!defined.has(fix.name) && fix.definition.test(content)) defined.add(fix.name)
+    }
+  }
+
+  for (const fix of FIXES) {
+    if (used.has(fix.name) && !defined.has(fix.name)) {
+      fail(
+        `Компонент \`${fix.name}\` використовується у \`.vue\`, але фікс \`${fix.selector}\` відсутній у \`.scss\`/\`.css\` (guide: style/quasar_fixes.mdc) — додай фікс до app.scss`,
+        'missing-quasar-fix'
+      )
+    }
+  }
+  return reporter.result()
+}

package/rules/style/quasar_fixes/quasar_fixes.mdc

@@ -0,0 +1,32 @@
+## Фікси компонентів Quasar
+
+При використанні компонента `q-scroll-area` або `q-tooltip` додай до `app.scss` відповідні фікси. Аналогічно — фікс масштабування на iOS.
+
+```scss
+// FIX стилі для прокручуваної області по висоті екрана
+.q-scrollarea {
+  display: flex;
+  flex-direction: column;
+  height: auto;
+  min-height: 0;
+  max-height: 100%;
+
+  .scroll {
+    flex: 10000 1 0%;
+  }
+}
+
+// FIX tooltip
+.q-tooltip {
+  font-size: 1em;
+}
+
+// FIX не зумувати на iOS
+@media (width <= 600px) {
+  input,
+  textarea,
+  select {
+    font-size: 16px;
+  }
+}
+```

package/rules/style/tooling/concern.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "config",
+  "lint": {
+    "scope": "full",
+    "glob": [
+      "package.json",
+      ".stylelintrc.{json,js,cjs,mjs}",
+      "stylelint.config.{js,cjs,mjs}",
+      ".stylelintignore",
+      ".github/workflows/lint-style.yml"
+    ]
+  }
+}

package/rules/style/tooling/docs/fix-tooling.md

@@ -0,0 +1,29 @@
+---
+type: JS Module
+title: fix-tooling.mjs
+resource: plugins/lang-js/rules/style/tooling/fix-tooling.mjs
+docgen:
+  crc: a25e47d2
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Виконую завдання як технічний письменник.
+
+Файл забезпечує детерміновані виправлення файлової системи для автоматичного налаштування інструменту Stylelint. Публічна функція `patterns` виконує перехоплення помилок (fail-safe), не генеруючи винятків. Код спирається на конфігурацію `package.json` і гарантує, що директорія `dist/` виключена з перевірки Stylelint через створення або доповнення `.stylelintignore`, а також додає необхідну конфігурацію Stylelint до `package.json`.
+
+## Поведінка
+
+Поведінка:
+
+1. Перевіряється наявність файлу `.stylelintignore`. Якщо він відсутній, створюється з вмістом `dist/`.
+2. Якщо файл `.stylelintignore` існує, перевіряється, чи містить він рядок `dist/`. Якщо ні, до файлу додається рядок `dist/`.
+3. Перевіряється, чи міститься конфігурація `stylelint` у файлі `package.json`. Якщо конфігурація відсутня, вона додається до `package.json` з посиланням на `@nitra/stylelint-config`.
+
+## Гарантії поведінки
+
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).

package/rules/style/tooling/docs/index.md

@@ -0,0 +1,12 @@
+---
+type: Directory Index
+title: npm/rules/style/tooling
+resource: plugins/lang-js/rules/style/tooling/
+---
+
+# npm/rules/style/tooling
+
+| Файл                              | Тип       |
+| --------------------------------- | --------- |
+| [fix-tooling.mjs](fix-tooling.md) | JS Module |
+| [main.mjs](main.md)               | JS Module |

package/rules/style/tooling/docs/main.md

@@ -0,0 +1,34 @@
+---
+type: JS Module
+title: main.mjs
+resource: plugins/lang-js/rules/style/tooling/main.mjs
+docgen:
+  crc: c96a4b01
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 90
+  issues: anchor-miss:extensions.json,anchor-miss:settings.json,judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Please provide the code file you want me to document. I will then generate the "Огляд" section based on the provided "Поведінка" and the file's content, adhering to all specified rules.
+
+## Поведінка
+
+Поведінка:
+
+1. main: Перевіряє наявність конфігурації stylelint. Конфігурація може бути визначена у пакеті `package.json` або у зовнішніх файлах конфігурації, зокрема `.stylelintrc.json`, `.stylelintrc.js`, `.stylelintrc.cjs`, `.stylelintrc.mjs`, `stylelint.config.js`, `stylelint.config.cjs`, `stylelint.config.mjs`. Якщо жоден із цих варіантів відсутній, видається помилка, і пропонується додати конфігурацію до `package.json` з посиланням на `@nitra/stylelint-config` (згадка (js.mdc)).
+2. main: Перевіряє існування файлу `.stylelintignore`. Якщо він не існує, видається помилка, і пропонується створити його з вмістом `dist/`.
+3. main: Якщо `.stylelintignore` існує, він перевіряє, чи містить він рядок `dist/`. Якщо цього рядка немає, видається помилка з проханням додати його (згадка (style.mdc)).
+4. main: Перевіряє існування файлу `.github/workflows/lint-style.yml`. Якщо він відсутній, видається помилка з проханням його створити.
+5. Робота ігнорує шляхи в каталозі `.github` та `.git` під час перевірки.
+
+## Публічний API
+
+main — забезпечує дотримання стандартів стилізації проєкту відповідно до правил style.mdc
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/style/tooling/fix-tooling.mjs

@@ -0,0 +1,58 @@
+/**
+ * T0-autofix паттерни для `style/tooling` — детерміновані FS-виправлення:
+ * створення або доповнення `.stylelintignore` та додавання `stylelint` до `package.json`.
+ *
+ * Unified lint surface: structured violations (test(violations)/apply(violations,ctx)).
+ * Тип порушення визначається за `v.message`, не за агрегованим output-рядком.
+ */
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+const STYLELINTIGNORE_MISSING_RE = /\.stylelintignore не існує/u
+const STYLELINTIGNORE_NO_DIST_RE = /\.stylelintignore не містить рядка dist\//u
+const NO_STYLELINT_CONFIG_RE = /Немає конфігу stylelint/u
+
+/** @type {import('../../../scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'style-stylelintignore-create',
+    test: violations => violations.some(v => STYLELINTIGNORE_MISSING_RE.test(v.message)),
+    apply: (_violations, ctx) => {
+      const target = join(ctx.cwd, '.stylelintignore')
+      ctx.recordWrite?.(target)
+      writeFileSync(target, 'dist/\n', 'utf8')
+      return { touchedFiles: [target], message: 'створено .stylelintignore' }
+    }
+  },
+
+  {
+    id: 'style-stylelintignore-dist-add',
+    test: violations => violations.some(v => STYLELINTIGNORE_NO_DIST_RE.test(v.message)),
+    apply: (_violations, ctx) => {
+      const target = join(ctx.cwd, '.stylelintignore')
+      ctx.recordWrite?.(target)
+      appendFileSync(target, '\ndist/\n', 'utf8')
+      return { touchedFiles: [target], message: 'додано dist/ до .stylelintignore' }
+    }
+  },
+
+  {
+    id: 'style-pkg-stylelint-add',
+    test: violations => violations.some(v => NO_STYLELINT_CONFIG_RE.test(v.message)),
+    apply: (_violations, ctx) => {
+      const pkgPath = join(ctx.cwd, 'package.json')
+      if (!existsSync(pkgPath)) return { touchedFiles: [] }
+      let pkg
+      try {
+        pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
+      } catch {
+        return { touchedFiles: [] }
+      }
+      if (pkg.stylelint) return { touchedFiles: [] }
+      ctx.recordWrite?.(pkgPath)
+      pkg.stylelint = { extends: '@nitra/stylelint-config' }
+      writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8')
+      return { touchedFiles: [pkgPath], message: 'додано stylelint до package.json' }
+    }
+  }
+]

package/rules/style/tooling/main.mjs

@@ -0,0 +1,73 @@
+/** @see ./docs/tooling.md */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+import { createViolationReporter } from '@7n/rules/scripts/lib/lint-surface/violation-reporter.mjs'
+
+// Зовнішні файли конфігу stylelint, які підхоплює cosmiconfig. Канон нових
+// JS-конфігів — `.mjs`/`.cjs` (js.mdc), legacy `.js` лишається валідним.
+const STYLELINT_CONFIG_FILES = [
+  '.stylelintrc.json',
+  '.stylelintrc.js',
+  '.stylelintrc.cjs',
+  '.stylelintrc.mjs',
+  'stylelint.config.js',
+  'stylelint.config.cjs',
+  'stylelint.config.mjs'
+]
+
+/**
+ * Альтернатива полю `stylelint` у `package.json` — зовнішній файл конфігу. Якщо
+ * поля немає і файлу немає, фейлимося; якщо є хоч щось — пропускаємо. Поле
+ * `stylelint.extends == "@nitra/stylelint-config"` сам формат — у Rego.
+ * @param {ReturnType<typeof createViolationReporter>} reporter репортер
+ * @param {string} cwd корінь репозиторію
+ */
+async function checkStylelintConfigPresence(reporter, cwd) {
+  const { pass, fail } = reporter
+  const pkgPath = join(cwd, 'package.json')
+  if (!existsSync(pkgPath)) return
+  const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
+  const hasField = pkg.stylelint && typeof pkg.stylelint === 'object'
+  const hasExternalCfg = STYLELINT_CONFIG_FILES.some(name => existsSync(join(cwd, name)))
+  if (hasField || hasExternalCfg) {
+    pass('Конфіг stylelint є — у package.json або окремим файлом')
+  } else {
+    fail('Немає конфігу stylelint — додай "stylelint": { "extends": "@nitra/stylelint-config" } до package.json')
+  }
+}
+
+// `.vscode/extensions.json` (`stylelint.vscode-stylelint`) і `.vscode/settings.json`
+// (`css.validate`/`scss.validate`/`less.validate: false`) — у rego-пакетах
+// `style_lint.vscode_extensions` і `style_lint.vscode_settings`, прогоняє
+// `npx @7n/rules fix`. JS-копії видалено, щоб не було двох джерел істини.
+
+/**
+ * Перевіряє відповідність проєкту правилам style.mdc
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd тощо)
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
+ */
+export async function lint(ctx) {
+  const cwd = ctx.cwd
+  const reporter = createViolationReporter(ctx)
+  const { pass, fail } = reporter
+
+  await checkStylelintConfigPresence(reporter, cwd)
+
+  const ignorePath = join(cwd, '.stylelintignore')
+  if (existsSync(ignorePath)) {
+    const ignoreContent = await readFile(ignorePath, 'utf8')
+    if (ignoreContent.split('\n').some(line => line.trim() === 'dist/')) {
+      pass('.stylelintignore існує і містить dist/')
+    } else {
+      fail('.stylelintignore не містить рядка dist/ — додай його (style.mdc)')
+    }
+  } else {
+    fail('.stylelintignore не існує — створи з вмістом: dist/')
+  }
+
+  // Existence/структуру lint-style.yml вимагає провайдер-плагін @7n/rules-ci-github
+  // (mixin style/lint_style_yml) — ядро провайдер-агностичне.
+  return reporter.result()
+}

package/rules/style/tooling/tooling.mdc

@@ -0,0 +1,85 @@
+## Генерація та редагування стилів (Cursor і інші агенти)
+
+- **Джерело правил:** перед тим як писати або суттєво змінювати **`.css`**, **`.scss`** або стилі в **`.vue`**, переглянь у корені проєкту (і в релевантних пакетах монорепо, якщо є) поле **`stylelint`** у **`package.json`** (зокрема `extends`), наявні **`.stylelintrc.*`**, **`stylelint.config.*`** та **`.stylelintignore`**. Не покладайся на «типові» правила stylelint з пам'яті — дотримуйся **проєктного** **`@nitra/stylelint-config`** і будь-яких локальних доповнень у репозиторії.
+- **Форматування** узгоджуй з **`n-text.mdc`** (oxfmt / `.oxfmtrc.json` для css, scss тощо), щоб форматер і stylelint не суперечили один одному.
+- **Запуск stylelint:** лише через **`n-rules lint style`** (локально — з auto-fix; у CI — `--no-fix`, нуль мутацій). Під капотом — `npx stylelint`; **не** використовуй **`bunx stylelint`**. Після змін запускай **`n-rules lint style`** і виправляй усе, що лишилось після auto-fix; за потреби — повний прогін `n-rules lint --full`.
+- **Не розширюй винятки:** не додавай зайві **`stylelint-disable`** без потреби; краще підлаштувати стилі під правила проєкту.
+
+## Канон налаштувань
+
+### `package.json`
+
+- `stylelint.extends`: [package.json.snippet.json](./policy/package_json/template/package.json.snippet.json)
+
+Окремого `lint-style` скрипта немає — запуск через **`n-rules lint style`** (CI — `--no-fix`).
+
+```json title="package.json"
+  "devDependencies": {
+    "@nitra/stylelint-config": "^1.4.0"
+  },
+  "stylelint": {
+    "extends": "@nitra/stylelint-config"
+  },
+```
+
+У корені проєкту має бути **`.stylelintignore`**:
+
+```text title=".stylelintignore"
+dist/
+```
+
+### `.vscode/extensions.json`
+
+- Канон `recommendations`: [extensions.json.snippet.json](./policy/vscode_extensions/template/extensions.json.snippet.json)
+
+### `.vscode/settings.json`
+
+- Вимкнення вбудованої CSS-валідації VS Code: [settings.json.snippet.json](./policy/vscode_settings/template/settings.json.snippet.json)
+
+### CI: `.github/workflows/lint-style.yml`
+
+- Канон: [lint-style.yml.snippet.yml](./policy/lint_style_yml/template/lint-style.yml.snippet.yml)
+
+Додай **`.github/workflows/lint-style.yml`** (лише **`.yml`**, **`ga.mdc`**): після **`checkout`** — локальний composite **`setup-bun-deps`**, далі `n-rules lint style --no-fix` у кроці **`run`**. **Не** дублюй окремі кроки **`setup-node`** / **`oven-sh/setup-bun`** / кеш / **`npm install`**.
+
+```yaml title=".github/workflows/lint-style.yml"
+name: StyleLint
+
+on:
+  push:
+    branches:
+      - dev
+      - main
+    paths:
+      - '**/*.css'
+      - '**/*.scss'
+      - '**/*.vue'
+
+  pull_request:
+    branches:
+      - dev
+      - main
+    paths:
+      - '**/*.css'
+      - '**/*.scss'
+      - '**/*.vue'
+
+concurrency:
+  group: ${{ github.ref }}-${{ github.workflow }}
+  cancel-in-progress: true
+
+jobs:
+  stylelint:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - uses: ./.github/actions/setup-bun-deps
+
+      - name: StyleLint
+        run: npx stylelint '**/*.{css,scss,vue}'
+```

package/rules/style/vscode_extensions/concern.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "config",
+  "policy": {
+    "files": {
+      "single": ".vscode/extensions.json"
+    }
+  }
+}

package/rules/style/vscode_extensions/docs/fix-vscode_extensions.md

@@ -0,0 +1,24 @@
+---
+type: JS Module
+title: fix-vscode_extensions.mjs
+resource: plugins/lang-js/rules/style/vscode_extensions/fix-vscode_extensions.mjs
+docgen:
+  crc: b6cffd44
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл ініціює процес інтеграції визначених шаблонів у розширення VS Code шляхом запуску зовнішнього скрипта. Цей скрипт забезпечує впровадження архітектурних патернів у ці розширення.
+
+## Поведінка
+
+1. Ініціює процес застосування визначених шаблонів до розширень VS Code.
+2. Використовує зовнішній скрипт для додавання необхідних патернів до розширень.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/style/vscode_extensions/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/style/vscode_extensions
+resource: plugins/lang-js/rules/style/vscode_extensions/
+---
+
+# npm/rules/style/vscode_extensions
+
+| Файл                                                  | Тип       |
+| ----------------------------------------------------- | --------- |
+| [fix-vscode_extensions.mjs](fix-vscode_extensions.md) | JS Module |

package/rules/style/vscode_extensions/fix-vscode_extensions.mjs

@@ -0,0 +1 @@
+export { patterns } from '@7n/rules/scripts/lib/fix/vscode-ext-add.mjs'

package/rules/style/vscode_extensions/template/extensions.json.snippet.json

@@ -0,0 +1 @@
+{ "recommendations": ["stylelint.vscode-stylelint"] }

package/rules/style/vscode_extensions/vscode_extensions.mdc

@@ -0,0 +1,13 @@
+## .vscode/extensions.json: розширення для stylelint
+
+Rego-пакет: `style_lint.vscode_extensions`
+
+Цільовий файл: `.vscode/extensions.json`
+
+Перевіряє, що масив `recommendations` містить усі записи з канонічного template (subset-check). Додаткові розширення поза списком — дозволені.
+
+Канонічний template: [extensions.json.snippet.json](./template/extensions.json.snippet.json)
+
+**✓ Правильно** — `recommendations` містить `"stylelint.vscode-stylelint"` (може бути і більше елементів).
+
+**✗ Неправильно** — `recommendations` відсутній або не містить `"stylelint.vscode-stylelint"`.

package/rules/style/vscode_extensions/vscode_extensions.rego

@@ -0,0 +1,13 @@
+# Перевірка `.vscode/extensions.json` для style (style.mdc).
+#
+# Канон надходить через --data: { "template": { "snippet": ... } }
+# Структура --data сформована з template/extensions.json.snippet.json.
+package style.vscode_extensions
+
+import rego.v1
+
+deny contains msg if {
+	some rec in data.template.snippet.recommendations
+	not rec in {r | some r in object.get(input, "recommendations", [])}
+	msg := sprintf(".vscode/extensions.json: recommendations має містити %q (style.mdc)", [rec])
+}

package/rules/style/vscode_settings/concern.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "config",
+  "policy": {
+    "files": {
+      "single": ".vscode/settings.json"
+    }
+  }
+}

package/rules/style/vscode_settings/docs/fix-vscode_settings.md

@@ -0,0 +1,26 @@
+---
+type: JS Module
+title: fix-vscode_settings.mjs
+resource: plugins/lang-js/rules/style/vscode_settings/fix-vscode_settings.mjs
+docgen:
+  crc: 83090b09
+  model: openai-codex/gpt-5.4-mini
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`patterns` описує узгоджені шаблони для `settings.json` і визначає, які значення в ньому мають відповідати очікуваному формату. Це потрібно, щоб конфіг лишався передбачуваним і однаково трактувався в різних місцях, де його використовують.
+
+## Поведінка
+
+1. `patterns` описує набір правил для приведення `.vscode/settings.json` до узгодженого стану з шаблонним стилем проєкту.
+2. На основі цього набору система знаходить конфігурацію `settings.json` і підтягує її в механізм виправлення, щоб зберігати єдиний формат налаштувань у робочому середовищі.
+3. Результат роботи `patterns` використовується як джерело стандарту для перевірки та вирівнювання вмісту `settings.json` без ручного втручання.
+4. Модуль не змінює файлову систему чи бази даних; він лише надає опис поведінки для подальшого застосування.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/style/vscode_settings/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/style/vscode_settings
+resource: plugins/lang-js/rules/style/vscode_settings/
+---
+
+| Файл                                              | Тип       |
+| ------------------------------------------------- | --------- |
+| [fix-vscode_settings.mjs](fix-vscode_settings.md) | JS Module |

package/rules/style/vscode_settings/fix-vscode_settings.mjs

@@ -0,0 +1,5 @@
+import { createTemplateFixPattern } from '@7n/rules/scripts/lib/fix/template-deep-merge.mjs'
+
+export const patterns = [
+  createTemplateFixPattern({ id: 'style-vscode_settings-template', targetPath: '.vscode/settings.json' })
+]

package/rules/style/vscode_settings/template/settings.json.snippet.json

@@ -0,0 +1,5 @@
+{
+  "css.validate": false,
+  "less.validate": false,
+  "scss.validate": false
+}