ru-a11y-toolkit-core

Единое ядро ru-a11y-toolkit: каталог правил axe-core, кастомных правил ESLint, runtime-проверок overlay, русскоязычных описаний, рекомендаций и ссылок на ГОСТ Р 52872-2019, Постановление №102 и WCAG.

Пакеты cli, react-overlay и eslint-preset используют этот пакет как общий источник метаданных правил.

Что входит

| Категория | Количество | Доля | Что сделано | | --- | ---: | ---: | --- | | Все реализованные проверки toolkit | 184 | 100% | Общий объем проверок во всех движках toolkit | | Кастомные проверки ru-a11y | 54 | 29% | Полноценные собственные проверки, добавленные поверх базового набора | | Кастомные правила для ESLint | 10 | 5% | Новые правила lint-уровня с собственной логикой и русскими сообщениями | | Кастомные runtime-проверки для Overlay | 44 | 24% | Новые проверки, которые overlay запускает сам и помечает как ru-a11y | | Адаптированные некастомные проверки | 26 | 14% от всех / 20% от некастомных | Проверки на базе jsx-a11y, где формулировки и рекомендации заметно переписаны под ГОСТ/№102 | | Базовые локализованные проверки | 104 | 57% от всех / 80% от некастомных | Проверки на базе axe-core, для которых добавлены русские названия, описания, фиксы и нормативные ссылки |

Модель подсчета

В ru-a11y-toolkit сейчас реализовано 184 проверки, из них 54 являются собственными кастомными проверками:

• 10 кастомных правил в eslint-preset
• 44 кастомные runtime-проверки в react-overlay

Из оставшихся 130 некастомных проверок:

• 104 опираются на готовые проверки axe-core и в основном локализованы: для них добавлены русские названия, описания, рекомендации по исправлению и ссылки на ГОСТ Р 52872-2019 и Постановление №102
• 26 построены на базе eslint-plugin-jsx-a11y, но адаптированы сильнее: сообщения переписаны под российские нормативы, формулировки сделаны прикладнее для разработки и QA, а в нужных местах добавлен явный нормативный контекст по ГОСТ/№102

При этом core по-прежнему хранит 115 канонических rule id. Это не конфликт, потому что один и тот же канонический id может быть реализован в нескольких движках одновременно: в ESLint, в overlay runtime и в CLI-отчётах.

Для отчетности лучше использовать две метрики:

• 115 — уникальные rule id и нормативные метаданные в ядре
• 184 — фактически реализованные проверки в toolkit

Экспорт RU_A11Y_TOOLKIT_STATS добавлен именно для этой модели учета.

Нормативная логика

Каталог группирует требования по практическим блокам: нетекстовый контент, медиа, таблицы, формы, язык, заголовки, landmarks, фокус, ARIA, масштабирование и устаревшие элементы. Если WCAG/axe и ГОСТ/№102 описывают близкую проблему разными словами, правило сохраняет единый технический id, но в README пакетов фиксируется отдельная нормативная формулировка. Это нужно для отчётов, где важно показать не только факт нарушения, но и причину с точки зрения российских требований.