@7n/rules 1.7.0 → 1.7.2

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/release/release.mdc

@@ -81,8 +81,10 @@ jobs:
       contents: write
       id-token: write # OIDC для Infisical
     steps:
-      # ... checkout, rust-toolchain, потім (rust.mdc вимагає кеш, zizmor фейлить
+      # ... checkout, потім (rust.mdc вимагає кеш, zizmor фейлить
       # cache-poisoning у тег-тригереному release — прийнятий ризик приглушуємо inline):
+      - uses: dtolnay/rust-toolchain@stable
+        with: { targets: aarch64-apple-darwin }
       - uses: Swatinem/rust-cache@v2 # zizmor: ignore[cache-poisoning]
       - name: Sync app version from tag
         run: |
@@ -93,11 +95,12 @@ jobs:
       - uses: Infisical/secrets-action@v1
         with: { secret-path: '/updater' }
       - uses: tauri-apps/tauri-action@v0
-        with: { projectPath: app }
+        with: { projectPath: app, args: '--target aarch64-apple-darwin' }
 ```
 
 - **«Sync app version from tag» має йти перед кроком `tauri-apps/tauri-action`** — тег `vX.Y.Z` є єдиним джерелом версії для build-артефактів; `tauri.conf.json#version` у робочому дереві не редагується вручну (він там лишається тим, що востаннє поставив `n-rules release`, і синхронізується цим кроком лише в CI, не в git).
 - Секрети підпису — з Infisical: Apple-сертифікати (`secret-path: /apple`) і `TAURI_SIGNING_PRIVATE_KEY` (`secret-path: /updater`) — обидва потрібні `tauri-apps/tauri-action`, щоб зібрати підписаний DMG з updater-артефактами.
+- **macOS-таргет — завжди `aarch64-apple-darwin`, ніколи `universal-apple-darwin`.** Без умовного галуження за кількістю `[[bin]]` у крейті: lipo-merge крок `tauri-action` зливає між арками лише головний GUI-бінарник, а будь-який додатковий `[[bin]]`-таргет лишається поза `universal-apple-darwin`-директорією — бандлер падає на `Failed to copy binary from ".../universal-apple-darwin/release/<bin>": ... does not exist`. Синхронно звузити `with.targets` кроку `dtolnay/rust-toolchain@…` до `aarch64-apple-darwin` (без `x86_64-apple-darwin`).
 
 ### `tauri.conf.json` — updater-артефакти й endpoint
 

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`) і перевіряє кожен.