@7n/rules 1.27.0 → 1.28.0

package/rules/vue/main.mdc

@@ -1,18 +0,0 @@
----
-description: Vue
-version: '2.3'
-globs: "**/*.vue"
-alwaysApply: false
----
-
-# Vue 3 Composition API — правила для .cursorrules
-
-Правило охоплює стандарти написання Vue 3 SFC з Composition API, конфігурацію Vite-проєкту, UI-бібліотеки, заборонені патерни та вимоги до тестування.
-
-## Швидкий gate через conftest
-
-Rego-перевірки (запускаються через `npx @7n/rules fix vue`):
-
-## Перевірка
-
-`npx @7n/rules fix vue` — перевіряє залежності, `vite.config`, наявність **`src/vite-env.d.ts`** з `/// <reference types="vite/client" />` та **`jsconfig.json`** у корені Vue-пакета; обходить джерела Vue-пакета (`.vue`, `.ts`, `.js` тощо) на заборонені value-імпорти з модуля `vue` (дозволені лише type-only та side-effect `import 'vue'`) і додатково сканує `.vue` SFC на імпорти Node-нативних модулів (`node:*` префікс або bare-ім'я вбудованого модуля Node — `fs`, `path`, `timers/promises` тощо). Імпорти аналізуються через **oxc-parser** (`module.staticImports`); для `.vue` вміст `<script>` витягується з SFC, далі той самий парсер (логіка в `npm/rules/vue/lib/vue-forbidden-imports.mjs`).

package/rules/vue/nheader-layout/concern.json

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

package/rules/vue/nheader-layout/nheader-layout.mdc

@@ -1,171 +0,0 @@
-## NHeader — телепорт-слоти на сторінках
-
-У проектах з `NHeader` використовуй `<teleport>` для вбудовування контенту сторінки в шапку:
-
-| Слот | Призначення |
-| --- | --- |
-| `#header-subtitle` | Заголовок сторінки (якщо потрібно перевизначити subtitle) |
-| `#header-center` | Важливі повідомлення та елементи управління |
-| `#header-filters` | Фільтри, кнопки та інші елементи управління сторінки |
-
-Оскільки `NHeader` за замовчуванням темний, додавай до полів і селектів у телепортах: `dark`, `standout="bg-white text-primary"`, `:options-dark="false"`.
-
-Завжди обгортай `<teleport>` в `v-if="mounted"` (де `mounted` — `$ref(false)`, що встановлюється в `onMounted`), щоб уникнути помилки відсутності target-елемента при SSR / першому рендері.
-
-```vue
-<template>
-  <q-page>
-    <!-- ФІЛЬТРИ В ШАПЦІ -->
-    <teleport v-if="mounted" to="#header-filters">
-      <div class="col row items-center n-gap-sm q-pa-sm">
-        <q-input
-          v-model="pageStore.filterName"
-          :label="t`Поиск по названию`"
-          debounce="200"
-          standout="bg-white text-primary"
-          clearable
-          dense
-          dark
-          class="col"
-          style="min-width: 120px">
-          <template #prepend>
-            <q-icon name="search" />
-          </template>
-        </q-input>
-
-        <n-select-multi
-          v-model="pageStore.filterRequestTypes"
-          :options="requestTypeOptions"
-          :label="t`Тип запроса`"
-          dark
-          standout="bg-white text-primary"
-          :options-dark="false"
-          style="min-width: 180px; max-width: 400px"
-          dense
-          emit-value
-          map-options
-          clearable
-          searchable
-          :stack-label="false" />
-
-        <q-btn
-          @click="addItem"
-          icon="add"
-          :label="t`Добавить`"
-          color="primary"
-          no-caps
-          padding="8px 12px"
-          unelevated />
-      </div>
-    </teleport>
-
-    <!-- ОСНОВНИЙ КОНТЕНТ -->
-    ...
-  </q-page>
-</template>
-<script setup>
-const mounted = $ref(false)
-onMounted(() => { mounted = true })
-</script>
-```
-
-## Layout з NHeader
-
-Для нових layout-ів використовуй `NHeader` з вбудованими `NLang` і `NMenu`.
-
-```vue
-<template>
-  <q-layout view="hHh Lpr lFf">
-    <n-header
-      v-model="leftSideOpened"
-      :logo="baseUrl + 'logo.png'"
-      :logo-url="homeUrl"
-      title="My App"
-      :subtitle="subtitle"
-      :username="userName"
-      toolbar-dark>
-      <template #top-toolbar>
-        <div class="platform-ios-only q-py-lg" />
-      </template>
-      <div>default slot content</div>
-    </n-header>
-
-    <!-- ЛЕВАЯ КОЛОНКА -->
-    <q-drawer v-model="leftSideOpened" :breakpoint="700" :width="300" overlay class="col column shadow-5 bg-grey-1">
-      <div class="platform-ios-only q-py-lg" />
-      <div v-if="!$q.screen.gt.xs" class="q-pa-sm row items-center">
-        <q-icon name="account_circle" color="primary" size="32px" class="q-mr-sm" />
-        <div class="text-subtitle1">{{ user.name }}</div>
-      </div>
-      <n-menu v-model="activeMenu" :menu="menu" />
-      <q-space />
-      <n-menu :menu="homeMenu" />
-      <div class="platform-ios-only q-py-md" />
-    </q-drawer>
-
-    <q-page-container>
-      <router-view />
-    </q-page-container>
-  </q-layout>
-</template>
-<script setup>
-import { lang, tf as tfm } from '@nitra/tfm'
-const t = tfm.bind({ tr: getTr() })
-
-const baseUrl = import.meta.env.BASE_URL
-const homeUrl = String.raw`https:\\` + import.meta.env.VITE_DOMAIN
-
-// Ліва колонка
-const leftSideOpened = $ref(false)
-const activeMenu = $ref(null)
-
-// Заголовок у шапці з поточного пункту меню
-const subtitle = computed(() => (activeMenu ? getTr()[activeMenu.labelKey]?.[lang.value] || activeMenu?.labelKey : ''))
-
-// Меню
-const menu = computed(() =>
-  [
-    {
-      icon: 'sym_o_store',
-      label: t`Клиенты`,
-      labelKey: t`Клиенты`,
-      routeName: 'customer'
-    },
-    {
-      icon: 'sym_o_route',
-      label: t`Маршруты и визиты`,
-      items: [
-        {
-          icon: 'sym_o_route',
-          label: t`Маршруты`,
-          labelKey: t`Маршруты`,
-          routeName: 'route'
-        },
-        {
-          icon: 'sym_o_event_upcoming',
-          label: t`Переносы маршрутов`,
-          labelKey: t`Переносы маршрутов`,
-          routeName: 'route_postpone'
-        }
-      ]
-    }
-  ].filter(item => {
-    if (item.items?.length) {
-      item.items = item.items.filter(i => can[i.permissionRoute || i.routeName])
-      return item.items.length > 0
-    }
-    return can[item.routeName]
-  })
-)
-
-/**
- * LOCALIZATION
- * @returns {object} translations
- */
-function getTr() {
-  return {
-    Клиенты: { en: 'Customers', ro: 'Clienți', tr: 'Müşteriler' }
-  }
-}
-</script>
-```

package/rules/vue/package_json/concern.json

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

package/rules/vue/package_json/package_json.mdc

@@ -1,30 +0,0 @@
-## Залежності Vue+Vite пакета — канонічний набір і заборони
-
-Rego-пакет: `vue.package_json`
-
-Цільові файли: `**/package.json`
-
-Перевірка активна лише якщо у `dependencies` присутній `vue`.
-
-**Обов'язкові залежності:**
-
-- `devDependencies.vite` — мажорна версія ≥ 8
-- `devDependencies.@vitejs/plugin-vue`
-- `vue-macros` (dependencies або devDependencies)
-- `unplugin-auto-import` (dependencies або devDependencies)
-- `vite-plugin-vue-layouts-next` (dependencies або devDependencies)
-
-**Заборонені залежності (у будь-якій групі):**
-
-- `esbuild` — замінено на rolldown
-- `vitest` — замінено на Bun Test Runner (`bun test`)
-- `jsdom` — замінено на happy-dom
-
-Приклади:
-
-```
-✓ "devDependencies": { "vite": "^8.0.0", "@vitejs/plugin-vue": "^6.0.0", "vue-macros": "^3.0.0", "unplugin-auto-import": "^20.0.0", "vite-plugin-vue-layouts-next": "^1.0.0" }
-✗ "devDependencies": { "vite": "^7.0.0", "esbuild": "^0.25.0", "vitest": "^3.0.0", "jsdom": "^25.0.0" }
-```
-
-Пакети без `vue` у `dependencies` — ігноруються повністю.

package/rules/vue/package_json/package_json.rego

@@ -1,140 +0,0 @@
-# Порт перевірки версій з `package.json` для Vue+Vite пакетів з
-# `npm/scripts/rules/vue/fix.mjs` (vue.mdc).
-#
-# Запуск (локально, у Vue+Vite-пакеті):
-#   conftest test path/to/package.json -p npm/policy/vue \
-#     --namespace vue.package_json
-#
-# Перевіряє: якщо в `dependencies` є `vue`, то потрібні канонічні Vue/Vite
-# залежності, `devDependencies.vite` має бути мажорної версії ≥ 8, а `esbuild`
-# (міграція на rolldown), `vitest` (заміна на Bun Test Runner) і `jsdom`
-# (заміна на happy-dom) у dependencies/devDependencies заборонені.
-#
-# AST-сканування коду (заборона явних value-імпортів `from 'vue'`, заборона
-# Node-нативних модулів у `.vue` SFC, перевірка `vite.config` на
-# `process.env.npm_lifecycle_event`, vue-macros, auto-import тощо), а також
-# FS-перевірки (`src/vite-env.d.ts`, `jsconfig.json` у корені пакета) — у JS.
-#
-# Структура каталогу збігається зі шляхом пакету (regal: directory-package-mismatch).
-# Конвенція проєкту — `import rego.v1` + multi-value `deny contains msg if { … }`
-# (.cursor/rules/conftest.mdc). Лінт — `bun run lint-rego` (regal).
-package vue.package_json
-
-import rego.v1
-
-deny contains msg if {
-	uses_vue
-	not vite_in_dev_dependencies
-	msg := "Vue-пакет: відсутня залежність `vite` у devDependencies (vue.mdc)"
-}
-
-deny contains msg if {
-	uses_vue
-	vite_in_dev_dependencies
-	not vite_major_at_least_8
-	vite_range := input.devDependencies.vite
-	msg := sprintf("Vue-пакет: vite має бути >= 8 (зараз %q) (vue.mdc)", [vite_range])
-}
-
-deny contains msg if {
-	uses_vue
-	vite_in_dev_dependencies
-	vite_major_at_least_8
-	not vite_at_least_8_1
-	vite_range := input.devDependencies.vite
-	msg := sprintf("Vue-пакет: vite має бути >= 8.1 (зараз %q) (vue.mdc)", [vite_range])
-}
-
-deny contains msg if {
-	uses_vue
-	not "@vitejs/plugin-vue" in dev_dependency_names
-	msg := "Vue-пакет: @vitejs/plugin-vue відсутній у devDependencies (vue.mdc)"
-}
-
-deny contains msg if {
-	uses_vue
-	not "vue-macros" in all_dependency_names
-	msg := "Vue-пакет: vue-macros відсутній (vue.mdc)"
-}
-
-deny contains msg if {
-	uses_vue
-	not "unplugin-auto-import" in all_dependency_names
-	msg := "Vue-пакет: unplugin-auto-import відсутній (vue.mdc)"
-}
-
-deny contains msg if {
-	uses_vue
-	not "vite-plugin-vue-layouts-next" in all_dependency_names
-	msg := "Vue-пакет: vite-plugin-vue-layouts-next відсутній (vue.mdc)"
-}
-
-deny contains msg if {
-	uses_vue
-	"esbuild" in all_dependency_names
-	msg := "Vue-пакет: esbuild заборонено — заміни на rolldown і прибери залежність (vue.mdc)"
-}
-
-deny contains msg if {
-	uses_vue
-	"vitest" in all_dependency_names
-	msg := "Vue-пакет: vitest заборонено — використовуй Bun Test Runner (`bun test`) і прибери залежність (vue.mdc)"
-}
-
-deny contains msg if {
-	uses_vue
-	"jsdom" in all_dependency_names
-	msg := "Vue-пакет: jsdom заборонено — використовуй happy-dom і прибери залежність (vue.mdc)"
-}
-
-# ── helpers ────────────────────────────────────────────────────────────────
-
-uses_vue if {
-	"vue" in object.keys(object.get(input, "dependencies", {}))
-}
-
-dependency_names := {n | some n in object.keys(object.get(input, "dependencies", {}))}
-
-dev_dependency_names := {n | some n in object.keys(object.get(input, "devDependencies", {}))}
-
-all_dependency_names contains n if {
-	some n in dependency_names
-}
-
-all_dependency_names contains n if {
-	some n in dev_dependency_names
-}
-
-vite_in_dev_dependencies if {
-	"vite" in object.keys(object.get(input, "devDependencies", {}))
-}
-
-vite_major_at_least_8 if {
-	range := input.devDependencies.vite
-
-	# Перша мажорна цифра з рядка: `^8`, `>=8.0.0`, `8.x` → 8.
-	match := regex.find_n(`\d+`, range, 1)
-	count(match) > 0
-	to_number(match[0]) >= 8
-}
-
-vite_at_least_8_1 if {
-	range := input.devDependencies.vite
-
-	# Витягуємо першу пару цифр (мажор.мінор) із semver-рядка.
-	# Якщо мажор > 8 — завжди true; якщо мажор = 8 — мінор має бути >= 1.
-	parts := regex.find_n(`\d+`, range, 2)
-	count(parts) >= 1
-	major := to_number(parts[0])
-	major > 8
-}
-
-vite_at_least_8_1 if {
-	range := input.devDependencies.vite
-
-	parts := regex.find_n(`\d+`, range, 2)
-	count(parts) >= 2
-	major := to_number(parts[0])
-	major == 8
-	to_number(parts[1]) >= 1
-}

package/rules/vue/packages/concern.json

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

package/rules/vue/packages/docs/index.md

@@ -1,11 +0,0 @@
----
-type: Directory Index
-title: npm/rules/vue/packages
-resource: npm/rules/vue/packages/
----
-
-# npm/rules/vue/packages
-
-| Файл                | Тип       |
-| ------------------- | --------- |
-| [main.mjs](main.md) | JS Module |

package/rules/vue/packages/docs/main.md

@@ -1,35 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/vue/packages/main.mjs
-docgen:
-  crc: 65e272f3
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.98
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Модуль визначає, чи є поточний пакет бібліотекою компонентів Vue, та проводить валідацію проєкту на відповідність стандартам, визначеним у `vue.mdc`, враховуючи конфігураційні файли `package-lock.json`, `jsconfig.json`, `package.json`, `extensions.json`.
-
-isVueComponentLibraryPkg визначає, чи є пакет бібліотекою компонентів Vue, аналізуючи його залежності.
-main перевіряє відповідність проєкту правилам vue.mdc для пакетів з Vue, включаючи перевірки конфігурації Vite, імпортів, `esbuild` та рекомендації IDE. Логіка роботи не викликає винятків назовні (fail-safe), ігноруючи каталоги `.git` та `node_modules`. (vue.mdc)
-
-## Поведінка
-
-Поведінка
-isVueComponentLibraryPkg визначає, чи є пакет бібліотекою компонентів Vue, аналізуючи його залежності.
-main перевіряє відповідність проєкту правилам vue.mdc для пакетів з Vue, включаючи перевірки конфігурації Vite, імпортів, `esbuild` та рекомендації IDE. При цьому ігноруються каталоги `.git` та `node_modules`, а також файли локів `package-lock.json`, `bun.lock` тощо.
-
-## Публічний API
-
-isVueComponentLibraryPkg — визначає, чи повинен проект розглядатися як бібліотека компонентів Vue, що впливає на правила імпорту в IDE.
-main — гарантує, що всі компоненти у робочому просторі коректно декларують залежність від Vue відповідно до стандартів.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- Свідомо пропускає шляхи: `.git`, `node_modules`.