@7n/rules 1.7.0 → 1.7.1

package/rules/style/admin_table/admin_table.mdc

@@ -0,0 +1,88 @@
+## Адмінські таблиці — n-admin-table
+
+Для таблиць, що мають займати всю висоту сторінки (або блоку), додавай клас `n-admin-table` і атрибути `hide-no-data`, `dense`, `flat`. Таблиця автоматично розтягнеться на весь доступний простір. У блоках меншої висоти — задай їм явний `height`.
+
+```vue
+<!-- ТАБЛИЦЯ -->
+<q-table class="n-admin-table" hide-no-data flat dense />
+```
+
+Якщо клас `.n-admin-table` не визначено в `app.scss` — додай:
+
+```scss
+// ADMIN TABLE
+.n-admin-table {
+  height: calc(100vh - 106px);
+
+  thead {
+    position: sticky;
+    z-index: 3;
+    top: 0;
+
+    tr th {
+      background-color: $grey-3;
+      height: 36px !important;
+    }
+  }
+
+  // tbody td {
+  //   font-size: 14px;
+  // }
+
+  tbody tr:last-child td {
+    border-bottom: 1px solid rgb(0 0 0 / 12%) !important;
+  }
+
+  th:first-child,
+  td:first-child,
+  th:last-child,
+  td:last-child {
+    width: 1px;
+    white-space: nowrap;
+  }
+
+  .q-table__bottom {
+    background-color: $grey-3;
+  }
+
+  .q-table__progress th {
+    height: 1px !important;
+  }
+
+  .text-wrap {
+    max-width: 250px;
+    white-space: normal;
+  }
+
+  // sticky columns
+  td.sticky-left {
+    position: sticky;
+    left: 0;
+    z-index: 2;
+    background-color: white;
+    box-shadow: 2px 0 5px #0002;
+  }
+
+  td.sticky-right {
+    position: sticky;
+    right: 0;
+    z-index: 2;
+    background-color: white;
+    box-shadow: -2px 0 5px #0002;
+  }
+
+  th.sticky-left {
+    position: sticky;
+    left: 0;
+    z-index: 3;
+    box-shadow: 2px 0 5px #0002;
+  }
+
+  th.sticky-right {
+    position: sticky;
+    right: 0;
+    z-index: 3;
+    box-shadow: -2px 0 5px #0002;
+  }
+}
+```

package/rules/style/admin_table/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/admin_table/docs/index.md

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

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

@@ -0,0 +1,14 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/style/admin_table/main.mjs
+docgen:
+  crc: 9e484318
+---
+
+## Огляд
+
+Детектор concern-а `admin_table` (read-only, whole-repo): якщо десь у `.vue`-файлі
+використано клас `n-admin-table`, він має бути визначений хоч в одному `.scss`/`.css`/`.vue`
+файлі проєкту, інакше — порушення `missing-admin-table-style`. Потребує whole-repo
+сканування (usage і definition можуть бути в різних файлах), тому не залежить від `ctx.files`.

package/rules/style/admin_table/main.mjs

@@ -0,0 +1,46 @@
+/** @see ./docs/main.md */
+import { readFile } from 'node:fs/promises'
+
+import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+
+const RELEVANT_RE = /\.(?:vue|scss|css)$/u
+const USAGE_RE = /\bn-admin-table\b/u
+const DEFINITION_RE = /\.n-admin-table\b/u
+
+/**
+ * Detector style/admin_table (read-only, whole-repo): якщо десь у `.vue` використано
+ * клас `n-admin-table`, він має бути визначений хоч в одному `.scss`/`.css`/`.vue`
+ * (guide: `admin_table.mdc`). Для усунення false positives — крос-файлова перевірка,
+ * тож потребує 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)
+  })
+
+  let used = false
+  let defined = false
+  for (const file of files) {
+    const content = await readFile(file, 'utf8')
+    if (!used && file.endsWith('.vue') && USAGE_RE.test(content)) used = true
+    if (!defined && DEFINITION_RE.test(content)) defined = true
+    if (used && defined) break
+  }
+
+  if (used && !defined) {
+    fail(
+      'Клас `.n-admin-table` використовується у `.vue`, але не визначений у жодному `.scss`/`.css` (guide: style/admin_table.mdc) — додай фікс до app.scss',
+      'missing-admin-table-style'
+    )
+  }
+  return reporter.result()
+}

package/rules/style/colors/colors.mdc

@@ -0,0 +1,21 @@
+## Кольори: quasar-variables.scss і app.scss
+
+Основні кольори визначай виключно через стандартні Quasar-змінні: `$primary`, `$secondary`, `$accent`, `$positive`, `$negative`, `$warning`.
+
+Якщо потрібен додатковий колір — визнач його в `quasar-variables.scss`, і **обов'язково** додай до `app.scss` відповідні `.text-*` / `.bg-*` класи:
+
+```scss
+/* quasar-variables.scss */
+$white-a1: color.adjust(white, $alpha: -0.85);
+```
+
+```scss
+/* app.scss */
+.text-white-a1 {
+  color: $white-a1 !important;
+}
+
+.bg-white-a1 {
+  background-color: $white-a1 !important;
+}
+```

package/rules/style/colors/concern.json

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

package/rules/style/gap/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/gap/docs/index.md

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

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

@@ -0,0 +1,15 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/style/gap/main.mjs
+docgen:
+  crc: dcba23e0
+---
+
+## Огляд
+
+Детектор concern-а `gap` (read-only, whole-repo): кожен суфікс утиліти
+`.n-gap-{xs,sm,md,lg}`, використаний у `.vue`-файлі, має бути визначений хоч в одному
+`.scss`/`.css`/`.vue` файлі проєкту — інакше порушення `missing-gap-style` для цього
+суфіксу. Суфікси відстежуються незалежно один від одного, тож часткове покриття все одно
+виявляє відсутній. Whole-repo сканування, не залежить від `ctx.files`.

package/rules/style/gap/gap.mdc

@@ -0,0 +1,22 @@
+## Gap між flex/grid-елементами — .n-gap-*
+
+Для відступів між плаваючими елементами (flex, grid) використовуй класи `.n-gap-*` замість `q-gutter-*`. Якщо класів немає в `app.scss` — додай:
+
+```scss
+// GAP
+.n-gap-xs {
+  gap: 4px;
+}
+
+.n-gap-sm {
+  gap: 8px;
+}
+
+.n-gap-md {
+  gap: 16px;
+}
+
+.n-gap-lg {
+  gap: 24px;
+}
+```

package/rules/style/gap/main.mjs

@@ -0,0 +1,51 @@
+/** @see ./docs/main.md */
+import { readFile } from 'node:fs/promises'
+
+import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+
+const RELEVANT_RE = /\.(?:vue|scss|css)$/u
+const USAGE_RE = /\bn-gap-(xs|sm|md|lg)\b/gu
+const DEFINITION_RE = /\.n-gap-(xs|sm|md|lg)\b/gu
+
+/**
+ * Detector style/gap (read-only, whole-repo): кожен суфікс `.n-gap-{xs,sm,md,lg}`,
+ * використаний у `.vue`, має бути визначений хоч в одному `.scss`/`.css`/`.vue`
+ * (guide: `gap.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)
+  })
+
+  /** @type {Set<string>} */
+  const used = new Set()
+  /** @type {Set<string>} */
+  const defined = new Set()
+  for (const file of files) {
+    const content = await readFile(file, 'utf8')
+    if (file.endsWith('.vue')) {
+      for (const m of content.matchAll(USAGE_RE)) used.add(m[1])
+    }
+    for (const m of content.matchAll(DEFINITION_RE)) defined.add(m[1])
+  }
+
+  for (const suffix of used) {
+    if (!defined.has(suffix)) {
+      fail(
+        `Клас \`.n-gap-${suffix}\` використовується у \`.vue\`, але не визначений у жодному \`.scss\`/\`.css\` (guide: style/gap.mdc) — додай клас до app.scss`,
+        'missing-gap-style'
+      )
+    }
+  }
+  return reporter.result()
+}

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: npm/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: npm/rules/style/quasar_fixes/main.mjs
+docgen:
+  crc: 3eecca4c
+---
+
+## Огляд
+
+Детектор 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 '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+import { walkDir } from '../../../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/tauri/tool_surface/concern.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "lint": {
+    "scope": "full",
+    "glob": [
+      "**/src/**/*.js",
+      "**/src/**/*.ts",
+      "**/src/**/*.jsx",
+      "**/src/**/*.tsx",
+      "**/src/**/*.vue",
+      "**/src-tauri/Cargo.toml",
+      "**/src-tauri/src/lib.rs",
+      "**/src-tauri/capabilities/*.json"
+    ]
+  }
+}

package/rules/tauri/tool_surface/docs/index.md

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

package/rules/tauri/tool_surface/docs/main.md

@@ -0,0 +1,24 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/tauri/tool_surface/main.mjs
+docgen:
+  crc: 87b28b8d
+---
+
+## Огляд
+
+Детектор concern-а `tool_surface`: для кожного Tauri-workspace знаходить Tauri-плагіни,
+яких торкається JS/TS/Vue-код (через `@tauri-apps/plugin-*` import або прямий
+`invoke('plugin:<slug>|...')`), і для кожного такого плагіна перевіряє три незалежні умови —
+(1) crate-залежність присутня в `src-tauri/Cargo.toml`, (2) rust-ідентифікатор
+(`tauri_plugin_<slug>`) згаданий у `src-tauri/src/lib.rs` (зареєстрований у builder-і),
+(3) permission для нього є в `src-tauri/capabilities/*.json`. Відсутність будь-якої з трьох —
+тихий рантайм-фейл без помилки компіляції, тому кожна дає окрему violation
+(`tool-surface-plugin-dep-missing` / `-not-registered` / `-capability-missing`).
+
+## Публічний API
+
+`PLUGIN_DEP_MISSING`, `PLUGIN_NOT_REGISTERED`, `PLUGIN_CAPABILITY_MISSING` — константи
+причин violation. `lint(ctx)` — точка входу concern-у: обходить усі Tauri app workspaces
+(`findTauriAppWorkspaces`) і перевіряє кожен.

package/rules/tauri/tool_surface/main.mjs

@@ -0,0 +1,145 @@
+/** @see ./docs/main.md */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+import { globby } from 'globby'
+
+import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+import { findTauriAppWorkspaces, groupCargoDepsBySection } from '../updater/main.mjs'
+
+/** JS торкається плагіна, але crate відсутній у `src-tauri/Cargo.toml`. */
+export const PLUGIN_DEP_MISSING = 'tool-surface-plugin-dep-missing'
+/** JS торкається плагіна, але його rust-ідентифікатор ніде не згадується в `lib.rs`. */
+export const PLUGIN_NOT_REGISTERED = 'tool-surface-plugin-not-registered'
+/** JS торкається плагіна, але жодна `capabilities/*.json` не дає йому permission. */
+export const PLUGIN_CAPABILITY_MISSING = 'tool-surface-plugin-capability-missing'
+
+const JS_PLUGIN_IMPORT_RE = /@tauri-apps\/plugin-([a-z0-9-]+)/gu
+const INVOKE_PLUGIN_RE = /invoke\(\s*['"]plugin:([a-z0-9-]+)\|/gu
+
+/**
+ * Збирає slugs Tauri-плагінів, яких торкається JS/TS/Vue-код через wrapper-пакет
+ * `@tauri-apps/plugin-*` (`import ... from '@tauri-apps/plugin-dialog'`) або прямий
+ * `invoke('plugin:<slug>|<command>')`. Це "тули" в термінах n-tool-surface — call
+ * surface, яким користується UI/оркестратор/LLM.
+ * @param {string} srcDir абсолютний шлях до `<ws>/src`
+ * @returns {Promise<Set<string>>} множина slugs (`dialog`, `http`, …)
+ */
+async function collectPluginUsages(srcDir) {
+  const slugs = new Set()
+  if (!existsSync(srcDir)) return slugs
+
+  const files = await globby(['**/*.js', '**/*.ts', '**/*.jsx', '**/*.tsx', '**/*.vue'], {
+    cwd: srcDir,
+    onlyFiles: true,
+    gitignore: false
+  })
+  for (const file of files) {
+    const content = await readFile(join(srcDir, file), 'utf8')
+    for (const m of content.matchAll(JS_PLUGIN_IMPORT_RE)) slugs.add(m[1])
+    for (const m of content.matchAll(INVOKE_PLUGIN_RE)) slugs.add(m[1])
+  }
+  return slugs
+}
+
+/**
+ * Збирає всі permission-ідентифікатори з `capabilities/*.json` workspace-каталогу.
+ * @param {string} capDir абсолютний шлях до каталогу capabilities
+ * @returns {Promise<Set<string>>} множина permission-ідентифікаторів
+ */
+async function collectCapabilityPermissionIds(capDir) {
+  const ids = new Set()
+  if (!existsSync(capDir)) return ids
+
+  const files = await globby('*.json', { cwd: capDir, onlyFiles: true, gitignore: false })
+  for (const file of files) {
+    let cap
+    try {
+      cap = JSON.parse(await readFile(join(capDir, file), 'utf8'))
+    } catch {
+      continue
+    }
+    const perms = Array.isArray(cap.permissions) ? cap.permissions : []
+    for (const p of perms) {
+      const id = typeof p === 'string' ? p : p?.identifier
+      if (id) ids.add(id)
+    }
+  }
+  return ids
+}
+
+/**
+ * Перевіряє один workspace: кожен Tauri-плагін, якого JS торкається через
+ * wrapper-пакет `@tauri-apps/plugin-*` чи прямий `invoke('plugin:...')`, має бути
+ * (1) залежністю в Cargo.toml, (2) згаданий у lib.rs (реєстрація builder-а), (3) мати
+ * permission у capabilities/*.json — інакше виклик тихо падає в рантаймі, без
+ * компіляційної помилки (tauri.mdc tool_surface).
+ * @param {string} ws відносний шлях workspace
+ * @param {string} cwd корінь репо
+ * @param {ReturnType<typeof createViolationReporter>} reporter репортер концерну
+ * @returns {Promise<void>} завершується після перевірки
+ */
+async function checkWorkspace(ws, cwd, reporter) {
+  const base = ws === '.' ? cwd : join(cwd, ws)
+  const srcDir = join(base, 'src')
+  const usedSlugs = await collectPluginUsages(srcDir)
+  if (usedSlugs.size === 0) return
+
+  const srcTauriDir = join(base, 'src-tauri')
+  const cargoPath = join(srcTauriDir, 'Cargo.toml')
+  const libRsPath = join(srcTauriDir, 'src', 'lib.rs')
+  const capDir = join(srcTauriDir, 'capabilities')
+
+  const bySection = existsSync(cargoPath) ? groupCargoDepsBySection(await readFile(cargoPath, 'utf8')) : new Map()
+  const libRsContent = existsSync(libRsPath) ? await readFile(libRsPath, 'utf8') : ''
+  const capIds = await collectCapabilityPermissionIds(capDir)
+
+  const cargoRel = cargoPath.slice(cwd.length + 1)
+  const libRsRel = libRsPath.slice(cwd.length + 1)
+  const capRel = capDir.slice(cwd.length + 1)
+
+  const depKeysList = bySection.values().toArray()
+
+  for (const slug of [...usedSlugs].toSorted()) {
+    const cargoDep = `tauri-plugin-${slug}`
+    const rustIdent = `tauri_plugin_${slug.replaceAll('-', '_')}`
+
+    if (depKeysList.every(keys => !keys.includes(cargoDep))) {
+      reporter.fail(
+        `${cargoRel}: JS звертається до плагіна "${slug}" (@tauri-apps/plugin-${slug} чи invoke('plugin:${slug}|...')), але "${cargoDep}" відсутній у Cargo.toml (tauri.mdc tool_surface)`,
+        { reason: PLUGIN_DEP_MISSING, file: cargoRel, data: { slug } }
+      )
+    }
+
+    if (!libRsContent.includes(rustIdent)) {
+      reporter.fail(
+        `${libRsRel}: плагін "${slug}" ніде не згадується — invoke('plugin:${slug}|...') з UI тихо впаде, бо builder.plugin(${rustIdent}::…) не зареєстрований (tauri.mdc tool_surface)`,
+        { reason: PLUGIN_NOT_REGISTERED, file: libRsRel, data: { slug } }
+      )
+    }
+
+    if (capIds.values().every(id => id !== slug && !id.startsWith(`${slug}:`))) {
+      reporter.fail(
+        `${capRel}/*.json: бракує permission "${slug}:*" для плагіна, якого торкається JS — invoke тихо падає permission-denied, видно лише в console.error (tauri.mdc tool_surface)`,
+        { reason: PLUGIN_CAPABILITY_MISSING, file: capRel, data: { slug } }
+      )
+    }
+  }
+}
+
+/**
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат перевірки
+ */
+export async function lint(ctx) {
+  const cwd = ctx.cwd
+  const reporter = createViolationReporter(ctx)
+
+  const apps = await findTauriAppWorkspaces(cwd)
+  for (const ws of apps) {
+    await checkWorkspace(ws, cwd, reporter)
+  }
+
+  return reporter.result()
+}