@7n/rules-lang-js 0.3.1 → 0.4.0

package/rules/vue/lib/vue-forbidden-imports.mjs

@@ -0,0 +1,240 @@
+/**
+ * Визначає явні імпорти з модуля `vue`, які суперечать vue.mdc (має працювати unplugin-auto-import),
+ * а також заборонені імпорти Node-нативних модулів у `.vue` SFC (`node:*` префікс або bare ім’я
+ * вбудованого модуля Node — `fs`, `path`, `timers/promises` тощо). Vue SFC виконується у браузері,
+ * де Node API недоступне, тож такі імпорти ламають збірку/рантайм.
+ *
+ * Аналіз import виконується через **oxc-parser** (`parseSync`, поле `module.staticImports`) — ESTree-сумісний
+ * розбір без евристик по рядках. Дозволені лише side-effect `import 'vue'`, повністю type-only імпорти
+ * та `import { type A, type B } from 'vue'` (перевірка `entries[].isType`).
+ *
+ * Для `.vue` з шаблону витягуються лише теги `<script>` / `<script setup>` (регулярний вираз); далі той самий Oxc-парсинг
+ * вмісту скрипта з віртуальним ім’ям `*.ts` для режиму TypeScript.
+ */
+import { builtinModules } from 'node:module'
+
+import { parseSync } from 'oxc-parser'
+
+import { contentForVueImportScan, extractVueScriptBlocks } from '@7n/rules/scripts/lib/js-source-signals.mjs'
+
+// Витяг script-блоків SFC живе в ядрі (потрібен auto-rules для fact-збору); ре-експорт зберігає API lib-а
+export { contentForVueImportScan, extractVueScriptBlocks } from '@7n/rules/scripts/lib/js-source-signals.mjs'
+
+const NODE_BUILTIN_MODULES = new Set(builtinModules)
+
+const VUE_EXT_RE = /\.vue$/u
+const SOURCE_FILE_RE = /\.(vue|[cm]?[jt]sx?)$/
+
+/**
+ * Мова для Oxc за шляхом файлу (розширення).
+ * @param {string} filePath віртуальний або реальний шлях до файлу
+ * @returns {'js' | 'jsx' | 'ts' | 'tsx'} значення опції `lang` для `parseSync`
+ */
+function langFromPath(filePath) {
+  const lower = filePath.toLowerCase()
+  if (lower.endsWith('.tsx')) {
+    return 'tsx'
+  }
+  if (lower.endsWith('.ts') || lower.endsWith('.mts') || lower.endsWith('.cts')) {
+    return 'ts'
+  }
+  if (lower.endsWith('.jsx')) {
+    return 'jsx'
+  }
+  return 'js'
+}
+
+/**
+ * Номер рядка (1-based) за зміщенням у буфері.
+ * @param {string} content повний текст файлу
+ * @param {number} offset байтове зміщення початку import
+ * @returns {number} номер рядка від 1
+ */
+function offsetToLine(content, offset) {
+  let line = 1
+  const n = Math.min(offset, content.length)
+  for (let i = 0; i < n; i++) {
+    if (content.codePointAt(i) === 10) {
+      line++
+    }
+  }
+  return line
+}
+
+/**
+ * Стискає пробіли для повідомлення про порушення.
+ * @param {string} s фрагмент коду
+ * @returns {string} скорочений однорядковий рядок
+ */
+function normalizeSnippet(s) {
+  return s.replaceAll(/\s+/g, ' ').trim().slice(0, 160)
+}
+
+/**
+ * Чи цей static import з `vue` дозволено правилом (усі записи type-only або порожній side-effect).
+ * @param {{ moduleRequest: { value: string }, entries: { isType: boolean }[] }} imp запис з `module.staticImports`
+ * @returns {boolean} `true`, якщо імпорт дозволено (type-only або `import 'vue'`)
+ */
+function isAllowedVueStaticImport(imp) {
+  if (imp.entries.length === 0) {
+    return true
+  }
+  return imp.entries.every(e => e.isType)
+}
+
+/**
+ * Віртуальний шлях для парсера: вміст з `<script>` у `.vue` розбираємо як TypeScript.
+ * @param {string} relativePath шлях до файлу в пакеті
+ * @returns {string} той самий шлях або з `.vue` заміненим на `.ts`
+ */
+function virtualPathForParse(relativePath) {
+  if (relativePath.endsWith('.vue')) {
+    return relativePath.replace(VUE_EXT_RE, '.ts')
+  }
+  return relativePath
+}
+
+/**
+ * Знаходить заборонені static import з `vue` у вже підготовленому тексті (без `<template>`).
+ * Використовує **oxc-parser**; при синтаксичних помилках повертає порожній масив (спочатку виправ синтаксис).
+ * @param {string} content вихідний код
+ * @param {string} [virtualPath] шлях для вибору `lang` (наприклад `app/src/foo.ts` або віртуальний після `.vue` → `.ts`)
+ * @returns {{ line: number, snippet: string }[]} список порушень з номером рядка початку import
+ */
+export function findForbiddenVueImportsInText(content, virtualPath = 'scan.ts') {
+  const pathForLang = virtualPath || 'scan.ts'
+  const lang = langFromPath(pathForLang)
+  let result
+  try {
+    result = parseSync(pathForLang, content, { lang, sourceType: 'module' })
+  } catch {
+    return []
+  }
+  if (result.errors?.length) {
+    return []
+  }
+  /** @type {{ line: number, snippet: string }[]} */
+  const out = []
+  for (const imp of result.module.staticImports) {
+    if (imp.moduleRequest.value === 'vue' && !isAllowedVueStaticImport(imp)) {
+      out.push({
+        line: offsetToLine(content, imp.start),
+        snippet: normalizeSnippet(content.slice(imp.start, imp.end))
+      })
+    }
+  }
+  return out
+}
+
+/**
+ * Чи слід пропустити файл під час обходу пакета (генерація, типи).
+ * @param {string} relativePosix шлях з posix-слешами
+ * @returns {boolean} `true`, якщо файл не сканувати (`.d.ts`, згенеровані імена)
+ */
+export function shouldSkipFileForVueImportScan(relativePosix) {
+  const base = relativePosix.split('/').pop() || ''
+  if (base === 'auto-imports.d.ts' || base === 'components.d.ts') {
+    return true
+  }
+  return Boolean(relativePosix.endsWith('.d.ts'))
+}
+
+/**
+ * Чи сканувати цей файл за розширенням.
+ * @param {string} relativePath відносний шлях до файлу
+ * @returns {boolean} `true`, якщо розширення підходить для пошуку import
+ */
+export function isVueImportScanSourceFile(relativePath) {
+  return SOURCE_FILE_RE.test(relativePath)
+}
+
+/**
+ * Знаходить порушення в одному файлі (з урахуванням .vue script extraction).
+ * @param {string} content сирий вміст файлу
+ * @param {string} relativePath шлях відносно кореня пакета або репо
+ * @returns {{ line: number, snippet: string }[]} список порушень для цього файлу
+ */
+export function findForbiddenVueImportsInSourceFile(content, relativePath) {
+  const scan = contentForVueImportScan(content, relativePath)
+  const virtualPath = virtualPathForParse(relativePath)
+  return findForbiddenVueImportsInText(scan, virtualPath)
+}
+
+/**
+ * Чи є рядок-специфікатор імпортом вбудованого Node-модуля.
+ * Покриває обидві форми: `node:fs`, `node:timers/promises` (явний префікс) і bare-ім’я
+ * вбудованого модуля (`fs`, `path`, `crypto` тощо), включно з підшляхами (`fs/promises`).
+ * @param {string} spec значення `moduleRequest.value` (специфікатор імпорту)
+ * @returns {boolean} `true`, якщо це Node-нативний модуль
+ */
+export function isNodeBuiltinSpecifier(spec) {
+  if (typeof spec !== 'string' || spec.length === 0) {
+    return false
+  }
+  if (spec.startsWith('node:')) {
+    return true
+  }
+  if (NODE_BUILTIN_MODULES.has(spec)) {
+    return true
+  }
+  const slashIdx = spec.indexOf('/')
+  if (slashIdx > 0) {
+    const head = spec.slice(0, slashIdx)
+    if (NODE_BUILTIN_MODULES.has(head)) {
+      return true
+    }
+  }
+  return false
+}
+
+/**
+ * Знаходить заборонені імпорти Node-нативних модулів у вмісті (без `<template>`).
+ * Vue SFC виконується у браузері, тож будь-який Node API там недоступний — навіть type-only
+ * імпорти збивають з пантелику (краще тримати такий код у server-side утілітах).
+ * @param {string} content вихідний код (для `.vue` — вже витягнуті `<script>` блоки)
+ * @param {string} [virtualPath] шлях для вибору `lang` (наприклад віртуальний `*.ts` після `.vue`)
+ * @returns {{ line: number, snippet: string, specifier: string }[]} список порушень з номером рядка
+ */
+export function findForbiddenNodeImportsInText(content, virtualPath = 'scan.ts') {
+  const pathForLang = virtualPath || 'scan.ts'
+  const lang = langFromPath(pathForLang)
+  let result
+  try {
+    result = parseSync(pathForLang, content, { lang, sourceType: 'module' })
+  } catch {
+    return []
+  }
+  if (result.errors?.length) {
+    return []
+  }
+  /** @type {{ line: number, snippet: string, specifier: string }[]} */
+  const out = []
+  for (const imp of result.module.staticImports) {
+    const spec = imp.moduleRequest.value
+    if (isNodeBuiltinSpecifier(spec)) {
+      out.push({
+        line: offsetToLine(content, imp.start),
+        snippet: normalizeSnippet(content.slice(imp.start, imp.end)),
+        specifier: spec
+      })
+    }
+  }
+  return out
+}
+
+/**
+ * Знаходить заборонені імпорти Node-нативних модулів у `.vue` SFC.
+ * Сканує лише `<script>` блоки (template ігноруємо). Для не-`.vue` файлів повертає `[]` —
+ * композаблі/утіліти на Node-side можуть бути в `.ts`/`.js`, а правило стосується SFC.
+ * @param {string} content сирий вміст файлу
+ * @param {string} relativePath шлях відносно кореня пакета або репо
+ * @returns {{ line: number, snippet: string, specifier: string }[]} список порушень
+ */
+export function findForbiddenNodeImportsInVueFile(content, relativePath) {
+  if (!relativePath.endsWith('.vue')) {
+    return []
+  }
+  const scan = extractVueScriptBlocks(content)
+  const virtualPath = virtualPathForParse(relativePath)
+  return findForbiddenNodeImportsInText(scan, virtualPath)
+}

package/rules/vue/main.json

@@ -0,0 +1 @@
+{ "auto": { "glob": "**/*.vue" } }

package/rules/vue/main.mdc

@@ -0,0 +1,18 @@
+---
+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

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

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

@@ -0,0 +1,171 @@
+## 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

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

package/rules/vue/package_json/package_json.mdc

@@ -0,0 +1,30 @@
+## Залежності 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

@@ -0,0 +1,140 @@
+# Порт перевірки версій з `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

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

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

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

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

@@ -0,0 +1,35 @@
+---
+type: JS Module
+title: main.mjs
+resource: plugins/lang-js/rules/vue/packages/main.mjs
+docgen:
+  crc: f5550b8c
+  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`.