@nitra/cursor 1.8.169 → 1.8.171

package/CHANGELOG.md

@@ -4,11 +4,24 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.8.171] - 2026-05-04
+
+### Removed
+
+- `abie.mdc` (v1.17) / `check-abie.mjs`: прибрано перевірку `.github/actionlint.yaml` (мітки `self-hosted-runner` `ua` / `dev` / `ru`). Видалено константи `ABIE_REQUIRED_ACTIONLINT_LABELS`, шаблон файлу та функції `parseActionlintSelfHostedLabels`, `abieMissingActionlintLabels`, `ensureAbieActionlintConfig`; знято відповідні юніт- та інтеграційні тести. Файл `.github/actionlint.yaml` більше не створюється і не валідовується правилом abie.
+
+## [1.8.170] - 2026-05-03
+
+### Changed
+
+- `image.mdc` (v1.4) / `check-image.mjs`: правило перейшло на split-cache `@nitra/minify-image` ≥ **3.2.0**. Замість єдиного `.minify-image-cache.tsv` (який раніше мав бути або в `.gitignore`, або у `files`) тепер: (а) `.n-minify-image.tsv` у корені — committed source of truth з SHA-1/originalSize/size; правило вимагає, щоб він НЕ був у `.gitignore`; (б) `node_modules/.cache/@nitra/minify-image/mtime.tsv` — локальний fast-path, авто-gitignored через `node_modules/`, окремої перевірки не потребує. Додано міграційний fail: якщо `.minify-image-cache.tsv` лежить у корені або згадується в `.gitignore` — підказка з командою `git rm --cached` + `rm -f`. README + image.mdc-секція `## Split-cache` пояснюють, чому коміт hash-кешу осмислений (переживає `git clone`/`checkout`, на відміну від mtime).
+
 ## [1.8.169] - 2026-05-03
 
 ### Added
 
-- `image.mdc` (v1.2) / `check-image.mjs`: нове правило `image` для оптимізації зображень через [`@nitra/minify-image`](https://www.npmjs.com/package/@nitra/minify-image). Перевіряє лише локальну конфігурацію (CI-workflow не вимагається — sharp/svgo тягнуть бінарні залежності, цінність на ubuntu-runner-ах нижча за час прогону): скрипт `lint-image` у `package.json` з обовʼязковим викликом `npx @nitra/minify-image --src=. --write --avif` (авто-оптимізація на місці + AVIF-двійники для PNG/JPEG/GIF), `bun run lint-image` в агрегованому `lint`, заборона `@nitra/minify-image` у `dependencies`/`devDependencies` (CLI лише через `npx`, симетрично до `markdownlint-cli2` у `text.mdc`) і рядок `.minify-image-cache.tsv` у `.gitignore` (або, рідше, у `files` пакета). AVIF-двійники (`<name>.<ext>.avif`) зберігаються в git як готові артефакти для віддачі браузеру.
+- `image.mdc` (v1.3) / `check-image.mjs`: нове правило `image` для оптимізації зображень через [`@nitra/minify-image`](https://www.npmjs.com/package/@nitra/minify-image). Перевіряє лише локальну конфігурацію (CI-workflow не вимагається — sharp/svgo тягнуть бінарні залежності, цінність на ubuntu-runner-ах нижча за час прогону): скрипт `lint-image` у `package.json` з обовʼязковим викликом `npx @nitra/minify-image --src=. --write --avif` (авто-оптимізація на місці + AVIF-двійники для PNG/JPEG/GIF), `bun run lint-image` в агрегованому `lint`, заборона `@nitra/minify-image` у `dependencies`/`devDependencies` (CLI лише через `npx`, симетрично до `markdownlint-cli2` у `text.mdc`) і рядок `.minify-image-cache.tsv` у `.gitignore` (або, рідше, у `files` пакета). AVIF-двійники (`<name>.<ext>.avif`) зберігаються в git як готові артефакти для віддачі браузеру.
+- `image.mdc` (v1.3) / `check-image.mjs`: у `.vue` файлах кожного workspace-пакета raster-посилання мають вести на AVIF-двійник (`...png.avif`) у двох формах: (а) `import x from '...png|jpg|jpeg|gif'` (далі `:src="x"`); (б) прямі статичні атрибути `<img src="...png" />` у `<template>` (Vite перетворює їх на asset-імпорти при збірці). Реактивне `:src="..."` не сканується (JS-вираз — резолвиться через імпорт, який ловиться у формі (а)); `data-src=`, `obj.src=` у `<script>`, SVG-імпорти теж пропускаємо. Опт-аут на рівні воркспейс-пакета: `"@nitra/minify-image": { "disable-avif": true }` у `package.json` цього пакета. Дедуплікація обходу: при walk-у кореня `.` піддерева інших workspace-роди пропускаються (інакше `App.vue` у `demo/` доповідався б двічі).
 - `auto-rules.mjs` / `auto-rules.md`: введено граф залежностей між правилами (`AUTO_RULE_DEPENDENCIES`, синтаксис у `auto-rules.md` — `rule - [other]`). Правило `image` описане як `image - [vue]` — варто автододати лише разом з `vue`, без дублювання вихідної умови «`.vue`-файли». Транзитивне розгортання дозволяє ланцюги (`a → b → c`) і поважає `disable-rules` (якщо vue вимкнено — image теж не додається).
 - `vue.mdc` (v1.4) / `check-vue.mjs`: посилено перевірку `vite.config` — окрім згадки `AutoImport` тепер вимагається, щоб у виклику `AutoImport({ imports: [...] })` був присутній рядковий елемент `'vue'`. Без цього `unplugin-auto-import` не надасть `ref` / `createApp` / тощо, і прибирати явні value-імпорти з `'vue'` стає небезпечно (зламає код). Якщо `'vue'` у `imports` відсутній — value-імпорти більше не оголошуються забороненими, а fail зʼявляється на конфізі vite. Балансована екстракція аргументів `AutoImport(...)` через `extractAutoImportCallArgs` працює для багаторядкових об'єктів.
 

package/mdc/abie.mdc

@@ -1,10 +1,10 @@
 ---
 description: Правила для проєктів AbInBev Efes
 alwaysApply: true
-version: '1.16'
+version: '1.17'
 ---
 
-Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** / **ru** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**, для спільних сервісів **`auth-run-hl`** / **`file-link-hl`** — **`namespace: dev`** у base та patch **`…/backendRefs/…/namespace`** у **ua** / **ru**), у overlay **ru** — кожен **Service** (у т. ч. **headless** / **`-hl`**) → **`spec.type: NodePort`** через **JSON6902** у **`kustomization.yaml`**, видалення **HealthCheckPolicy** у **ru**), гілки **dev**, **ua**, **ru** у **clean-merged-branch**, **`.github/actionlint.yaml`** із мітками **`self-hosted-runner`** **ua** / **dev** / **ru** (створюється автоматично за відсутності), а також заборона тримати артефакти **Firebase Hosting** у **підкаталогах першого рівня** (безпосередні діти кореня репозиторію; у самому корені ці імена не вимагаються до видалення).
+Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** / **ru** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**, для спільних сервісів **`auth-run-hl`** / **`file-link-hl`** — **`namespace: dev`** у base та patch **`…/backendRefs/…/namespace`** у **ua** / **ru**), у overlay **ru** — кожен **Service** (у т. ч. **headless** / **`-hl`**) → **`spec.type: NodePort`** через **JSON6902** у **`kustomization.yaml`**, видалення **HealthCheckPolicy** у **ru**), гілки **dev**, **ua**, **ru** у **clean-merged-branch**, а також заборона тримати артефакти **Firebase Hosting** у **підкаталогах першого рівня** (безпосередні діти кореня репозиторію; у самому корені ці імена не вимагаються до видалення).
 
 **`npx @nitra/cursor check abie`** виконується лише якщо в **`.n-cursor.json`** у **`rules`** є **`abie`** — інакше вихід **0** без зауважень.
 
@@ -336,18 +336,6 @@ spec:
 
 У **кожному** підкаталозі, що лежить **безпосередньо** в корені репозиторію, не тримати конфіг і кеш **Firebase Hosting**: у таких каталогах не повинно бути **`.firebaserc`**, **`firebase.json`** та каталогу **`.firebase/`** (у **самому** корені репозиторію ці імена перевіркою abie **не** розглядаються; `node_modules` / `.git` зі скану вилучаються).
 
-## actionlint: self-hosted-runner labels
-
-У **`.github/actionlint.yaml`** має бути блок **`self-hosted-runner.labels`** з присутніми мітками **`ua`**, **`dev`**, **`ru`**. Якщо файлу немає — **`npx @nitra/cursor check abie`** створює його з канонічним вмістом. Інші мітки, інший порядок та формат лапок дозволені — перевіряється лише наявність трьох обов'язкових міток (деталі — **`check-abie.mjs`**).
-
-```yaml title=".github/actionlint.yaml"
-self-hosted-runner:
-  labels:
-    - 'ua'
-    - 'dev'
-    - 'ru'
-```
-
 ## Git branches
 
 У **`.github/workflows/clean-merged-branch.yml`** у кроці **`phpdocker-io/github-actions-delete-abandoned-branches`** значення **`with.ignore_branches`** має містити **dev**, **ua** та **ru** (разом з іншими гілками, якщо потрібно):

package/mdc/image.mdc

@@ -1,10 +1,10 @@
 ---
 description: Оптимізація зображень через @nitra/minify-image у локальному lint
 alwaysApply: true
-version: '1.2'
+version: '1.4'
 ---
 
-CLI [`@nitra/minify-image`](https://www.npmjs.com/package/@nitra/minify-image) запускається через `npx` (як `markdownlint-cli2` у text.mdc) і **не** додається в `dependencies` / `devDependencies`. Канонічний `lint-image` — авто-оптимізація з прапорцями `--write --avif`: стискає raster/SVG на місці й створює AVIF-двійники (`<name>.<ext>.avif`) поряд з кожним PNG/JPEG/GIF. Кеш-файл `.minify-image-cache.tsv` робить повторні прогони дешевими.
+CLI [`@nitra/minify-image`](https://www.npmjs.com/package/@nitra/minify-image) (≥ **3.2.0**) запускається через `npx` (як `markdownlint-cli2` у text.mdc) і **не** додається в `dependencies` / `devDependencies`. Канонічний `lint-image` — авто-оптимізація з прапорцями `--write --avif`: стискає raster/SVG на місці й створює AVIF-двійники (`<name>.<ext>.avif`) поряд з кожним PNG/JPEG/GIF. Split-cache робить повторні прогони дешевими — і локально, і після `git clone`.
 
 Перевірка лише локальна — у CI `lint-image` не запускаємо (sharp/svgo тягнуть бінарні залежності, цінність на ubuntu-runner-ах нижча за час прогону). Окремий workflow `lint-image.yml` створювати не треба.
 
@@ -21,22 +21,79 @@ CLI [`@nitra/minify-image`](https://www.npmjs.com/package/@nitra/minify-image)
 
 Якщо в `package.json` уже є агрегований `lint`, додай у його ланцюжок `bun run lint-image` (як `bun run lint-text`, `bun run lint-js`, `bun run lint-ga`). Так розробник, що локально гонить `bun run lint`, перед фіксацією одразу бачить, чи зросли зображення, і отримує свіжі AVIF-двійники.
 
-## `.gitignore`
+## Split-cache
 
-`--write` створює `.minify-image-cache.tsv` у корені сканованого каталогу — TSV з рядком на кожне зображення (`<rel-path>\t<mtime>\t<originalSize>\t<size>`). Файл **переписується** на кожному запуску, тому консервативний дефолт для бібліотек / застосунків — ігнорувати:
+Починаючи з `@nitra/minify-image` **3.2.0** кеш розбитий на два файли з різною семантикою:
 
-```text title=".gitignore"
-.minify-image-cache.tsv
-```
+### `.n-minify-image.tsv` — source of truth у git
+
+У корені сканованого каталогу. Формат: `<rel-path>\t<sha1-hex>\t<originalSize>\t<size>`.
+
+Slow-path і джерело даних для `Project lifetime savings`. **Має бути в git** — після `git clone` чи `git checkout` (mtime скидається на час checkout-у) CLI читає файл, рахує SHA-1 і порівнює зі збереженим у TSV хешем; на match локальний mtime-кеш зігрівається без reprocess. Рядки відсортовані алфавітно, hash і size змінюються лише при реальній зміні контенту — diff чистий.
+
+### `node_modules/.cache/@nitra/minify-image/mtime.tsv` — локальний fast-path
+
+Формат: `<rel-path>\t<mtime>\t<size>`. При збігу `(size, mtime)` CLI пропускає файл без читання — константа per-file.
+
+Лежить під `node_modules/`, тож **авто-gitignored** за конвенцією JS-tooling-у (так кешуються ESLint, Babel, webpack, Turbo). Окремий рядок у `.gitignore` не потрібен. `rm -rf node_modules` зносить — наступний запуск відновлює його через slow-path проти `.n-minify-image.tsv`, без reprocess.
+
+### Міграція з versions < 3.2
 
-Якщо проєкт усе ж зберігає кеш у git — це теж дозволено правилом, але тоді він має бути в `files` у `package.json` (для опублікованих npm-пакетів) або просто відсутній у `.gitignore`. Замовчування — рядок у `.gitignore`.
+Старий єдиний `.minify-image-cache.tsv` (4 колонки `path\tmtime\toriginalSize\tsize`, зазвичай у `.gitignore`) автоматично читається при першому запуску для seed-у `originalSize` у `.n-minify-image.tsv` (lifetime savings не скидається). Після цього старий файл видаляють вручну:
+
+```bash
+git rm --cached .minify-image-cache.tsv 2>/dev/null || true
+rm -f .minify-image-cache.tsv
+# прибери відповідний рядок з .gitignore, якщо був
+```
 
 AVIF-двійники (`<name>.<ext>.avif`) **зберігаємо в git** — це готові артефакти для віддачі браузеру (без них ефект від `--avif` втрачається на чистому checkout-і).
 
+## AVIF-імпорти у `.vue`
+
+Раз `--avif` гарантує `<name>.<ext>.avif` поряд з кожним PNG/JPEG/GIF, у `.vue` файлах потрібно посилатись саме на AVIF-двійник, а не на оригінал:
+
+```vue title="App.vue (правильно)"
+<script setup>
+import welcomeImage from './assets/welcome.png.avif'
+</script>
+
+<template>
+  <img :src="welcomeImage" alt="Welcome" />
+</template>
+```
+
+```vue title="App.vue (неправильно — втрачає AVIF)"
+<script setup>
+import welcomeImage from './assets/welcome.png'
+</script>
+```
+
+Перевірка `check image` сканує `.vue` файли в кожному workspace-пакеті (root + workspaces) і вимагає AVIF-двійник для двох форм:
+
+1. **Імпорт-пов'язані** — `import x from '...png|jpg|jpeg|gif'` (далі `:src="x"` у шаблоні).
+2. **Прямі статичні** — `<img src="...png" />` у `<template>` (Vite перетворює такий шлях на asset-імпорт на етапі збірки, тож вимога та сама).
+
+Реактивне `:src="..."` (з JS-виразом — змінною, тернарником, викликом тощо) **не сканується** — значення обчислюється у рантаймі й шлях туди потрапляє через імпорт або інший резолвинг, який ловить імпорт-перевірка вище. SVG не торкаємо (vector → AVIF безглуздо). Атрибути `data-src=`, `obj.src=` у `<script>` тощо також пропускаються.
+
+### Опт-аут для конкретного пакета
+
+У workspace-пакеті, де AVIF-імпорти небажані (наприклад, мобільний бандл, де AVIF-підтримка не гарантована), додай у `package.json` цього пакета:
+
+```json title="apps/mobile/package.json"
+{
+  "@nitra/minify-image": {
+    "disable-avif": true
+  }
+}
+```
+
+Тоді перевірка пропускає `.vue` файли цього пакета. У root-`package.json` опт-аут діє лише для файлів кореня (вкладені workspaces перевіряються незалежно — вмикай прапор у кожному пакеті, де треба).
+
 ## Заборонені залежності
 
 `@nitra/minify-image` не повинен зʼявлятися ні в `dependencies`, ні в `devDependencies` кореневого `package.json` — CLI запускається лише через `npx` (так само, як `markdownlint-cli2` у text.mdc). Якщо потрібен явний пін — закладай діапазон версій npm у самому виклику (`npx @nitra/minify-image@^3 --src=. --write --avif`).
 
 ## Перевірка
 
-`npx @nitra/cursor check image` (охоплює `lint-image` у `package.json` з обовʼязковими `--src=.`, `--write`, `--avif`, агрегований `lint` і `.minify-image-cache.tsv` у `.gitignore`).
+`npx @nitra/cursor check image` (охоплює `lint-image` з обовʼязковими `--src=.`, `--write`, `--avif`, агрегований `lint`, `.n-minify-image.tsv` НЕ в `.gitignore` (має бути в git), відсутність застарілого `.minify-image-cache.tsv` у корені, AVIF-імпорти у `.vue` файлах кожного workspace-пакета).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.8.169",
+  "version": "1.8.171",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -49,6 +49,6 @@
     "node": ">=25"
   },
   "devDependencies": {
-    "@nitra/cursor": "^1.8.169"
+    "@nitra/cursor": "^1.8.170"
   }
 }

package/scripts/check-abie.mjs

@@ -39,7 +39,7 @@
  * у файлі **`k8s/ru/kustomization.yaml`** того ж пакета (overlay середовища **ru**) — inline **JSON6902** на **`kind: Service`** з тим самим **`target.name`**: **`path: /spec/type`**, **`value: NodePort`**; якщо в base було **`spec.clusterIP: None`** — **`op: remove`** для **`/spec/clusterIP`**; якщо в base **явно** задано **`spec.clusterIPs`** — також **`remove`** для **`/spec/clusterIPs`** (інакше **API** може залишити **`None`** для **NodePort**; без ключа **`clusterIPs`** у base **`remove`** на **`/spec/clusterIPs`** ламає **`kubectl kustomize`**).
  */
 import { existsSync } from 'node:fs'
-import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises'
+import { readdir, readFile } from 'node:fs/promises'
 import { dirname, join, relative } from 'node:path'
 
 import { parseAllDocuments } from 'yaml'
@@ -118,20 +118,6 @@ const HTTPROUTE_BACKENDREF_PORT_8081_VALUE_FIRST_RE =
 /** Гілки, які мають бути в **`ignore_branches`** за abie.mdc. */
 export const ABIE_REQUIRED_IGNORE_BRANCHES = ['dev', 'ua', 'ru']
 
-/** Канонічний шлях до конфігу actionlint у репо (abie.mdc). */
-const ABIE_ACTIONLINT_PATH = '.github/actionlint.yaml'
-
-/** Канонічний вміст **`.github/actionlint.yaml`**, який ми створюємо за відсутності файлу (abie.mdc). */
-const ABIE_ACTIONLINT_TEMPLATE = `self-hosted-runner:
-  labels:
-    - 'ua'
-    - 'dev'
-    - 'ru'
-`
-
-/** Мітки **`self-hosted-runner.labels`**, які мають бути присутні в **`.github/actionlint.yaml`** (abie.mdc). */
-export const ABIE_REQUIRED_ACTIONLINT_LABELS = Object.freeze(['ua', 'dev', 'ru'])
-
 /**
  * Чи відносний шлях вказує на **`ru/kustomization.yaml`** (сегмент **`ru`** перед ім'ям файлу) — специфіка abie overlay.
  * @param {string} rel шлях від кореня репозиторію
@@ -1730,83 +1716,6 @@ async function ensureNoFirebaseHostingArtifacts(root, passFn, failFn) {
   passFn('Підкаталоги кореня (1-й рівень, без .git/node_modules): артефактів Firebase Hosting не знайдено (abie.mdc)')
 }
 
-/**
- * Витягує мітки **`self-hosted-runner.labels`** з тексту `.github/actionlint.yaml`.
- * @param {string} raw повний вміст файлу (YAML)
- * @returns {string[] | null} масив рядків-міток або null, якщо ключа/масиву не знайдено
- */
-export function parseActionlintSelfHostedLabels(raw) {
-  let docs
-  try {
-    docs = parseAllDocuments(raw)
-  } catch {
-    return null
-  }
-  for (const doc of docs) {
-    if (doc.errors.length > 0) continue
-    const root = doc.toJSON()
-    if (root === null || typeof root !== 'object' || Array.isArray(root)) continue
-    const block = /** @type {Record<string, unknown>} */ (root)['self-hosted-runner']
-    if (block === null || typeof block !== 'object' || Array.isArray(block)) continue
-    const labels = /** @type {Record<string, unknown>} */ (block).labels
-    if (!Array.isArray(labels)) continue
-    return labels.filter(l => typeof l === 'string')
-  }
-  return null
-}
-
-/**
- * Які з **`ABIE_REQUIRED_ACTIONLINT_LABELS`** відсутні в наданому списку міток (abie.mdc).
- * @param {string[]} labels мітки **`self-hosted-runner.labels`**
- * @returns {string[]} відсутні мітки (порожньо — все ок)
- */
-export function abieMissingActionlintLabels(labels) {
-  const present = new Set(labels.map(l => l.trim()))
-  return ABIE_REQUIRED_ACTIONLINT_LABELS.filter(r => !present.has(r))
-}
-
-/**
- * Гарантує наявність **`.github/actionlint.yaml`** із потрібними мітками **`self-hosted-runner`** (abie.mdc):
- * створює файл із канонічним вмістом, якщо його немає; якщо є — звіряє мітки.
- * @param {string} root корінь репозиторію
- * @param {(msg: string) => void} pass callback при успішній перевірці
- * @param {(msg: string) => void} fail callback при помилці
- */
-async function ensureAbieActionlintConfig(root, pass, fail) {
-  const abs = join(root, ABIE_ACTIONLINT_PATH)
-  if (!existsSync(abs)) {
-    try {
-      await mkdir(dirname(abs), { recursive: true })
-      await writeFile(abs, ABIE_ACTIONLINT_TEMPLATE, 'utf8')
-    } catch (error) {
-      const msg = error instanceof Error ? error.message : String(error)
-      fail(`${ABIE_ACTIONLINT_PATH}: не вдалося створити (${msg}) — abie.mdc`)
-      return
-    }
-    pass(`${ABIE_ACTIONLINT_PATH}: створено з self-hosted-runner.labels [ua, dev, ru] (abie.mdc)`)
-    return
-  }
-  let raw
-  try {
-    raw = await readFile(abs, 'utf8')
-  } catch (error) {
-    const msg = error instanceof Error ? error.message : String(error)
-    fail(`${ABIE_ACTIONLINT_PATH}: не вдалося прочитати (${msg}) — abie.mdc`)
-    return
-  }
-  const labels = parseActionlintSelfHostedLabels(raw)
-  if (labels === null) {
-    fail(`${ABIE_ACTIONLINT_PATH}: не знайдено self-hosted-runner.labels — додай мітки ua, dev, ru (abie.mdc)`)
-    return
-  }
-  const missing = abieMissingActionlintLabels(labels)
-  if (missing.length > 0) {
-    fail(`${ABIE_ACTIONLINT_PATH}: у self-hosted-runner.labels бракує ${missing.join(', ')} (abie.mdc)`)
-    return
-  }
-  pass(`${ABIE_ACTIONLINT_PATH}: self-hosted-runner.labels містить ua, dev, ru (abie.mdc)`)
-}
-
 /**
  * Перевіряє clean-merged-branch.yml на ignore_branches.
  * @param {string} root корінь репозиторію
@@ -2178,7 +2087,6 @@ export async function check() {
   pass('Правило abie увімкнено — виконуємо перевірки')
   await ensureNoFirebaseHostingArtifacts(root, pass, fail)
   await checkCleanMergedBranch(root, pass, fail)
-  await ensureAbieActionlintConfig(root, pass, fail)
 
   const yamlFiles = await findK8sYamlFiles(root)
   const deploymentDirs = await collectDeploymentDirs(root, yamlFiles, fail)

package/scripts/check-image.mjs

@@ -1,6 +1,6 @@
 /**
  * Перевіряє відповідність репозиторію правилу image.mdc для оптимізації зображень
- * через `@nitra/minify-image` (локально — у CI лінт зображень не запускається).
+ * через `@nitra/minify-image` ≥ 3.2.0 (локально — у CI лінт зображень не запускається).
  *
  * Очікування:
  * - у кореневому `package.json` є скрипт `lint-image`, який викликає `npx @nitra/minify-image`
@@ -9,19 +9,53 @@
  *   (симетрично до `lint-text`, `lint-js`, `lint-ga`);
  * - `@nitra/minify-image` не оголошений у `dependencies`/`devDependencies` —
  *   CLI запускається лише через `npx` (як `markdownlint-cli2` у `text.mdc`);
- * - `.minify-image-cache.tsv` ігнорується через `.gitignore`,
- *   або (рідше) явно перерахований у `files` пакета npm.
+ * - `.n-minify-image.tsv` (committed source of truth з sha1/originalSize/size) НЕ
+ *   в `.gitignore` — він має бути в git. Локальний mtime-кеш у
+ *   `node_modules/.cache/@nitra/minify-image/mtime.tsv` авто-gitignored через `node_modules/`,
+ *   окремої перевірки не вимагає;
+ * - застарілий `.minify-image-cache.tsv` (з версій < 3.2) видалений з кореня — інакше
+ *   проєкт лишається у напівпереміщеному стані;
+ * - у `.vue` файлах raster-імпорти (`.png` / `.jpg` / `.jpeg` / `.gif`) посилаються на
+ *   AVIF-двійники (`...png.avif` тощо), оскільки `--avif` гарантує їх наявність поряд із
+ *   оригіналами. Можна вимкнути на рівні воркспейс-пакета через `"@nitra/minify-image": {
+ *   "disable-avif": true }` у його `package.json`.
  */
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
+import { join, relative } from 'node:path'
 
 import { createCheckReporter } from './utils/check-reporter.mjs'
+import { walkDir } from './utils/walkDir.mjs'
+import { getMonorepoPackageRootDirs } from './utils/workspaces.mjs'
 
 /** Імʼя CLI-пакета: рядок у `lint-image` і заборонений у залежностях. */
 const MINIFY_PACKAGE_NAME = '@nitra/minify-image'
 
-/** Імʼя кеш-файлу, який CLI створює у режимі `--write`. */
-const CACHE_FILENAME = '.minify-image-cache.tsv'
+/** Імʼя committed-кешу (sha1 + originalSize + size) у `@nitra/minify-image` ≥ 3.2.0. */
+const HASH_CACHE_FILENAME = '.n-minify-image.tsv'
+
+/** Імʼя застарілого 4-колонкового кешу (`@nitra/minify-image` < 3.2). Має бути видалений після міграції. */
+const LEGACY_CACHE_FILENAME = '.minify-image-cache.tsv'
+
+/** Поле в `package.json` для конфігу @nitra/minify-image (наприклад, `disable-avif`). */
+const PKG_CONFIG_FIELD = '@nitra/minify-image'
+
+/**
+ * Регексп для імпортів raster-зображень у `.vue` файлах.
+ * Захоплює `import name from '...ext'` (як default, так і type-only форми не потрібні —
+ * type-imports asset-ів не існує). Захоплюється повний шлях у групі 1.
+ */
+const VUE_RASTER_IMPORT_RE = /import\s+\w[\w$]*\s+from\s+['"]([^'"\n]+\.(?:png|jpe?g|gif))['"]/giu
+
+/**
+ * Регексп для прямих посилань на raster-зображення у HTML-атрибуті `src="..."` шаблона `.vue`
+ * (наприклад `<img src="./hero.png" />`). Vite перетворює такі шляхи на asset-імпорти на етапі
+ * збірки, тож для них теж діє вимога вживати AVIF-двійник.
+ *
+ * Лукбехайнд `(?<![:\-_.])` виключає реактивне `:src="..."` (там JS-вираз — змінна або виклик,
+ * перевіряється через імпорт), `data-src="..."` і `obj.src=...` у `<script>`.
+ */
+const VUE_RASTER_STATIC_SRC_RE = /(?<![:\-_.])\bsrc\s*=\s*['"]([^'"\s]+\.(?:png|jpe?g|gif))['"]/giu
 
 /**
  * Перевіряє скрипт `lint-image` у `package.json`.
@@ -100,68 +134,187 @@ function checkMinifyImageNotInDeps(pkg, pass, fail) {
 }
 
 /**
- * Перевіряє `.minify-image-cache.tsv`: має бути або у `.gitignore`,
- * або явно у `files`-листі пакета (рідкісний кейс для open-source npm-пакетів).
- * @param {{ files?: unknown }} pkg розібраний package.json (для перевірки `files`)
+ * Зчитує всі змістовні рядки `.gitignore` (без коментарів і порожніх). Якщо файла нема — `null`.
+ * @returns {Promise<string[] | null>} список trim-нутих рядків або `null`
+ */
+async function readGitignoreLines() {
+  if (!existsSync('.gitignore')) return null
+  const raw = await readFile('.gitignore', 'utf8')
+  return raw
+    .split('\n')
+    .map(l => l.trim())
+    .filter(l => l.length > 0 && !l.startsWith('#'))
+}
+
+/**
+ * Перевіряє, що `.n-minify-image.tsv` НЕ в `.gitignore` — він має бути в git
+ * (split-cache 3.2.0: source of truth для slow-path і lifetime savings).
+ *
+ * Сам факт існування файла НЕ вимагається — на свіжому проєкті без обробки
+ * зображень його ще нема, це нормально.
  * @param {(msg: string) => void} pass callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
  * @returns {Promise<void>}
  */
-async function checkCacheIgnoredOrPublished(pkg, pass, fail) {
-  if (existsSync('.gitignore')) {
-    const raw = await readFile('.gitignore', 'utf8')
-    const lines = raw
-      .split('\n')
-      .map(l => l.trim())
-      .filter(l => l.length > 0 && !l.startsWith('#'))
-    if (lines.includes(CACHE_FILENAME)) {
-      pass(`.gitignore містить ${CACHE_FILENAME}`)
-      return
-    }
+async function checkHashCacheNotIgnored(pass, fail) {
+  const lines = await readGitignoreLines()
+  if (lines && lines.includes(HASH_CACHE_FILENAME)) {
+    fail(
+      `.gitignore: прибери рядок \`${HASH_CACHE_FILENAME}\` — це закомічений source of truth split-cache 3.2.0 (image.mdc)`
+    )
+  } else {
+    pass(`${HASH_CACHE_FILENAME} не в .gitignore (має бути в git)`)
   }
-  if (Array.isArray(pkg.files) && pkg.files.some(f => typeof f === 'string' && f.includes(CACHE_FILENAME))) {
-    pass(`package.json: ${CACHE_FILENAME} перерахований у \`files\` (комітований кеш)`)
+}
+
+/**
+ * Перевіряє, що застарілий `.minify-image-cache.tsv` (з версій < 3.2) видалений
+ * з кореня. Якщо лежить — користувач не завершив міграцію на split-cache, що
+ * залишає файл як орфана у git-історії.
+ * @param {(msg: string) => void} pass callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ * @returns {Promise<void>}
+ */
+async function checkLegacyCacheRemoved(pass, fail) {
+  if (existsSync(LEGACY_CACHE_FILENAME)) {
+    fail(
+      `${LEGACY_CACHE_FILENAME} застарілий (split-cache 3.2.0) — видали: ` +
+        `\`git rm --cached ${LEGACY_CACHE_FILENAME} 2>/dev/null || true && rm -f ${LEGACY_CACHE_FILENAME}\` ` +
+        '(також прибери відповідний рядок з .gitignore, якщо є)'
+    )
     return
   }
-  fail(
-    `.gitignore: додай рядок \`${CACHE_FILENAME}\` (або явно перерахуй у \`files\` package.json) — image.mdc`
-  )
+  const lines = await readGitignoreLines()
+  if (lines && lines.includes(LEGACY_CACHE_FILENAME)) {
+    fail(
+      `.gitignore: прибери застарілий рядок \`${LEGACY_CACHE_FILENAME}\` — split-cache 3.2.0 його не використовує`
+    )
+    return
+  }
+  pass(`${LEGACY_CACHE_FILENAME} відсутній (міграція на split-cache завершена)`)
+}
+
+/**
+ * Чи у `package.json` пакета вимкнено avif-перевірку Vue-імпортів.
+ * Очікувана форма: `"@nitra/minify-image": { "disable-avif": true }`.
+ * @param {Record<string, unknown>} pkg розібраний package.json пакета
+ * @returns {boolean} true, якщо опт-аут активовано
+ */
+function packageHasAvifDisabled(pkg) {
+  const cfg = pkg[PKG_CONFIG_FIELD]
+  return Boolean(cfg && typeof cfg === 'object' && /** @type {Record<string, unknown>} */ (cfg)['disable-avif'] === true)
+}
+
+/**
+ * Сканує `.vue` файли одного workspace-пакета на raster-імпорти, що ще не використовують `.avif`.
+ *
+ * Файли, що належать іншим workspace-пакетам, ігноруються — кожен пакет перевіряється рівно
+ * один раз (інакше при обході кореня `.` ми б повторно зайшли в `demo/` і подвоїли звіти).
+ * @param {string} packageRoot відносний шлях до кореня пакета (наприклад `'.'` або `'demo'`)
+ * @param {string[]} otherRootsAbs абсолютні шляхи інших workspace-коренів — їх піддерева пропускаємо
+ * @param {(msg: string) => void} pass callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ * @returns {Promise<void>}
+ */
+async function checkVueAvifImportsInPackage(packageRoot, otherRootsAbs, pass, fail) {
+  const absRoot = join(process.cwd(), packageRoot)
+  const label = packageRoot === '.' ? 'корінь' : packageRoot
+  /** @type {string[]} */
+  const vueFiles = []
+  await walkDir(absRoot, absPath => {
+    if (!absPath.endsWith('.vue')) return
+    if (otherRootsAbs.some(other => absPath.startsWith(`${other}/`))) return
+    vueFiles.push(absPath)
+  })
+  if (vueFiles.length === 0) return
+
+  let violations = 0
+  for (const absPath of vueFiles) {
+    const rel = relative(process.cwd(), absPath).split('\\').join('/')
+    const content = await readFile(absPath, 'utf8')
+    for (const match of content.matchAll(VUE_RASTER_IMPORT_RE)) {
+      violations++
+      const importPath = match[1]
+      fail(
+        `[${label}] ${rel}: import з '${importPath}' має посилатись на AVIF-двійник '${importPath}.avif' ` +
+          `(lint-image --avif створює його поряд). Вимкнути локально: "@nitra/minify-image": { "disable-avif": true } у package.json пакета`
+      )
+    }
+    for (const match of content.matchAll(VUE_RASTER_STATIC_SRC_RE)) {
+      violations++
+      const srcPath = match[1]
+      fail(
+        `[${label}] ${rel}: пряме \`src="${srcPath}"\` у шаблоні має використовувати AVIF-двійник \`src="${srcPath}.avif"\` ` +
+          `(або винеси у import + \`:src="..."\`). Вимкнути локально: "@nitra/minify-image": { "disable-avif": true } у package.json пакета`
+      )
+    }
+  }
+  if (violations === 0) {
+    pass(`[${label}] усі raster-посилання у .vue вже на .avif (або відсутні)`)
+  }
+}
+
+/**
+ * Сканує всі workspace-пакети: для кожного перевіряє opt-out і за потреби викликає
+ * перевірку Vue-imports. Перевірка пропускається, якщо в репозиторії немає workspaces
+ * або немає `.vue`-файлів — тоді `image` правило не для цього проєкту.
+ * @param {(msg: string) => void} pass callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ * @returns {Promise<void>}
+ */
+async function checkVueAvifImports(pass, fail) {
+  const roots = await getMonorepoPackageRootDirs()
+  const absRootsByRel = new Map(roots.map(r => [r, join(process.cwd(), r)]))
+  for (const root of roots) {
+    const pkgPath = join(root, 'package.json')
+    if (!existsSync(pkgPath)) continue
+    const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
+    if (packageHasAvifDisabled(pkg)) {
+      pass(`[${root === '.' ? 'корінь' : root}] avif-import enforcement вимкнено через "@nitra/minify-image.disable-avif"`)
+      continue
+    }
+    const otherRootsAbs = roots.filter(r => r !== root && r !== '.').map(r => absRootsByRel.get(r) ?? '')
+    await checkVueAvifImportsInPackage(root, otherRootsAbs, pass, fail)
+  }
 }
 
 /**
  * Перевіряє кореневий `package.json`: скрипти, заборонені залежності, агрегований `lint`.
  * @param {(msg: string) => void} pass callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
- * @returns {Promise<{ pkg: Record<string, unknown> } | null>} розібраний package.json або `null` якщо немає
+ * @returns {Promise<boolean>} `true`, якщо `package.json` знайдено й оброблено; `false` — нема
  */
 async function checkPackageJsonImage(pass, fail) {
   if (!existsSync('package.json')) {
     fail('package.json не знайдено в корені — додай (image.mdc)')
-    return null
+    return false
   }
   const pkg = JSON.parse(await readFile('package.json', 'utf8'))
   const scripts = /** @type {Record<string, unknown>} */ (pkg.scripts || {})
   checkLintImageScript(typeof scripts['lint-image'] === 'string' ? scripts['lint-image'] : undefined, pass, fail)
   checkLintAggregateIncludesImage(typeof scripts.lint === 'string' ? scripts.lint : undefined, pass, fail)
   checkMinifyImageNotInDeps(pkg, pass, fail)
-  return { pkg }
+  return true
 }
 
 /**
- * Перевіряє відповідність проєкту правилам `image.mdc`:
- * `lint-image` через `npx @nitra/minify-image --src=.`, агрегований `lint`,
- * `.minify-image-cache.tsv` у `.gitignore`. CI-workflow для image не вимагається —
- * лінт зображень виконується лише локально.
+ * Перевіряє відповідність проєкту правилам `image.mdc` (split-cache 3.2.0):
+ * `lint-image` через `npx @nitra/minify-image --src=. --write --avif`, агрегований `lint`,
+ * `.n-minify-image.tsv` НЕ в `.gitignore` (committed source of truth), застарілий
+ * `.minify-image-cache.tsv` видалений, AVIF-імпорти у `.vue` файлах. CI-workflow
+ * для image не вимагається — лінт зображень виконується лише локально.
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */
 export async function check() {
   const reporter = createCheckReporter()
   const { pass, fail } = reporter
 
-  const pkgResult = await checkPackageJsonImage(pass, fail)
-  if (pkgResult) {
-    await checkCacheIgnoredOrPublished(pkgResult.pkg, pass, fail)
+  const pkgFound = await checkPackageJsonImage(pass, fail)
+  if (pkgFound) {
+    await checkHashCacheNotIgnored(pass, fail)
+    await checkLegacyCacheRemoved(pass, fail)
   }
+  await checkVueAvifImports(pass, fail)
 
   return reporter.getExitCode()
 }