@bonesofspring/ai-rules 0.2.14 → 0.2.15

package/presets/cursor/next/rules/no-props-spread.mdc

@@ -1,41 +1,41 @@
 ---
-description: Избегать спред-а пропов при передаче в компоненты
+description: Avoid prop spread when passing props to components
 globs: app/src/**/*.tsx
 alwaysApply: false
 ---
 
-# Не использовать спред пропов при передаче в компоненты
+# Do not use prop spread when passing props to components
 
-При вызове **пользовательских** React-компонентов (имя с заглавной буквы: `IconBox`, `TextField`, ваши `FooBar`) **передавать пропы явно**, а не через spread (`{...props}`, `{...obj}`).
+When calling **custom** React components (PascalCase names: `IconBox`, `TextField`, your `FooBar`), **pass props explicitly**, not via spread (`{...props}`, `{...obj}`).
 
-**Агентам и при ревью:** не «упрощать» JSX через объект с последующим spread — это нарушение. Если ветвление по пропам длинное, используйте два явных JSX-блока (`condition ? <A … /> : <B … />`) или отдельные маленькие компоненты, а не `{...mergedProps}`.
+**For agents and review:** do not “simplify” JSX by building an object and spreading it — that violates this rule. If prop branching is long, use two explicit JSX blocks (`condition ? <A … /> : <B … />`) or separate small components, not `{...mergedProps}`.
 
-## Почему
+## Why
 
-- Явная передача делает зависимости компонента очевидными при чтении кода.
-- Упрощает рефакторинг и поиск использований.
-- Снижает риск случайно пробросить лишние или устаревшие пропы.
+- Explicit props make component dependencies obvious when reading code.
+- Easier refactoring and usage search.
+- Reduces the risk of accidentally passing extra or stale props.
 
-## Проверка в репозитории
+## Repo enforcement
 
-- Для файлов `app/src/ui/**/*.tsx` включено ESLint-правило `react/jsx-props-no-spreading` (`app/eslint.config.mjs`): несоблюдение увидит линтер и CI.
-- Легитимное исключение в конкретном месте — **однострочный** `eslint-disable-next-line react/jsx-props-no-spreading` с кратким комментарием «почему»; для редких обёрток допустим disable на файл (как в `PromocodeInput`).
+- For `app/src/ui/**/*.tsx`, ESLint rule `react/jsx-props-no-spreading` is enabled (`app/eslint.config.mjs`): linter and CI will catch violations.
+- A legitimate local exception — a **single-line** `eslint-disable-next-line react/jsx-props-no-spreading` with a brief “why” comment; for rare wrappers, a file-level disable is acceptable (as in `PromocodeInput`).
 
-## Примеры
+## Examples
 
 ```tsx
-// ❌ Плохо
+// ❌ Bad
 const commonProps = { a, b, c }
 return <Child {...commonProps} />
 
-// ❌ Плохо
+// ❌ Bad
 return <Child {...props} />
 
-// ❌ Плохо (spread из соседнего модуля стилей тоже не оправдание)
+// ❌ Bad (spread from a neighboring styles module is not an excuse)
 const iconProps = cond ? { name, size: 'm' } : { name, size: 'm', ...styles.IconBoxAccent }
 return <IconBox {...iconProps} />
 
-// ✅ Хорошо
+// ✅ Good
 return (
   <Child
     a={a}
@@ -44,7 +44,7 @@ return (
   />
 )
 
-// ✅ Хорошо — явные пропсы по веткам
+// ✅ Good — explicit props per branch
 return cond ? (
   <IconBox name={name} size="m" variant="warning" />
 ) : (
@@ -56,7 +56,7 @@ return cond ? (
 )
 ```
 
-## Исключения
+## Exceptions
 
-- Передача пропов в **нативный** DOM-элемент (`<div {...rest} />`) допустима, если `rest` содержит только валидные HTML-атрибуты.
-- Делегирование пропов в обёртку (wrapper) допустимо, если это явно документировано и обосновано; при необходимости пометьте файл или строку через ESLint-disable, как выше.
+- Passing props to a **native** DOM element (`<div {...rest} />`) is allowed if `rest` contains only valid HTML attributes.
+- Delegating props in a wrapper is allowed if explicitly documented and justified; mark the file or line via ESLint-disable as above when needed.

package/presets/cursor/next/rules/no-type-assertion-as-import-export.mdc

@@ -1,5 +1,5 @@
 ---
-description: Избегать приведения типов через as на границах модулей (импорт/экспорт)
+description: Avoid type assertions via as at module boundaries (import/export)
 globs:
   - app/src/api/**/*
   - app/src/store/**/*
@@ -7,54 +7,54 @@ globs:
 alwaysApply: false
 ---
 
-# Не использовать `as` для приведения типов при экспорте и импорте (кроме необходимых случаев)
+# Do not use `as` for type assertions on export and import (except necessary cases)
 
-## О чём речь
+## Scope
 
-Речь о **type assertion** в TypeScript: выражение вида `значение as Тип`.
+This covers **type assertion** in TypeScript: an expression like `value as Type`.
 
-**Не относится к правилу** (это не assertion, а синтаксис модулей):
+**Out of scope** (module syntax, not assertion):
 
-- переименование при экспорте: `export { foo as bar }`, `export { default as Baz } from '...'`;
-- переименование при импорте: `import { foo as bar } from '...'`;
-- `import type { Foo as Bar }` — алиас типа в импорте типов.
+- rename on export: `export { foo as bar }`, `export { default as Baz } from '...'`;
+- rename on import: `import { foo as bar } from '...'`;
+- `import type { Foo as Bar }` — type alias in a type-only import.
 
-## Требование
+## Requirement
 
-- На **публичной границе модуля** (то, что **экспортируется** из файла / barrel, и то, что сразу **присваивается импортированным символам** с принудительным приведением) **не использовать** `as Тип` для «подгонки» типов, если можно обойтись нормальной типизацией.
+- On the **public module boundary** (what is **exported** from a file / barrel, and what is immediately **assigned to imported symbols** with forced casting) **do not use** `as Type` to “fit” types when normal typing suffices.
 
-## Предпочитать вместо `as`
+## Prefer instead of `as`
 
-- явную аннотацию: `const x: T = ...` / `function f(): T`;
-- **дженерики** у функций и классов;
-- **`satisfies`** (когда нужно проверить совместимость без сужения до `any`);
-- сужение **`unknown`** после проверки (type guards, `zod` и т.п.);
-- правку **исходных типов/DTO/мапперов**, а не assertion на выходе.
+- explicit annotation: `const x: T = ...` / `function f(): T`;
+- **generics** on functions and classes;
+- **`satisfies`** (when you need compatibility check without narrowing to `any`);
+- narrowing **`unknown`** after checks (type guards, `zod`, etc.);
+- fixing **source types/DTO/mappers**, not assertion at the output.
 
-## Когда `as` допустим
+## When `as` is allowed
 
-- взаимодействие с **не типизированными** или некорректно типизированными внешними модулями, где нет разумной альтернативы;
-- узкие места после **валидации** данных, если типовый гард всё ещё не выразить без шума (предпочтительно всё же guard/`satisfies`);
-- **`as const`** — когда нужны литеральные типы и широкий вывод ломает контракт (это отдельный механизм; применять по делу, не как замену типизации API).
-- блок **`catch (error)`** после вызова HTTP через общий клиент: по возможности сужать через **`instanceof`** на **класс ошибки транспорта** из `@/types` (какой именно — по существующей реализации) и работать с уже суженным типом; голый **`as` к тому же типу** — только если `instanceof` недоступен (иной источник выброса) и осознанно.
+- interaction with **untyped** or incorrectly typed external modules where there is no reasonable alternative;
+- narrow spots after **validation** when a type guard is still too noisy (prefer guard/`satisfies`);
+- **`as const`** — when literal types are needed and wide inference breaks the contract (separate mechanism; use as needed, not as a substitute for API typing).
+- **`catch (error)`** block after HTTP via the shared client: prefer narrowing via **`instanceof`** on the **transport error class** from `@/types` (which one — per existing implementation) and work with the narrowed type; bare **`as`** to the same type — only if `instanceof` is unavailable (different throw source) and intentional.
 
-## Примеры
+## Examples
 
 ```typescript
-// ❌ Плохо: assertion на экспортируемом API
+// ❌ Bad: assertion on exported API
 export const config = loadRaw() as AppConfig
 
-// ✅ Лучше: аннотация + проверка или маппер
+// ✅ Better: annotation + check or mapper
 export const config: AppConfig = mapToAppConfig(loadRaw())
 
-// ❌ Плохо: сразу после импорта «ломаем» тип
+// ❌ Bad: immediately after import “breaks” the type
 import { getData } from './api'
 export const data = getData() as MyDto[]
 
-// ✅ Лучше: типизировать getData / обернуть типобезопасной функцией
+// ✅ Better: type getData / wrap in a type-safe function
 ```
 
-## Требование к агенту
+## Agent requirement
 
-При ревью и генерации кода **не добавлять** новые `as Тип` на экспортируемые сущности и на цепочку import → export без явной необходимости; по возможности исправлять контракт типов в источнике.
-- В слайсах и сервисах при обработке ошибок API сначала рассматривать **`instanceof`** на класс ошибки транспорта из `@/types` по образцу существующего кода (`http-client.mdc`, `store-rtk.mdc`).
+When reviewing and generating code **do not add** new `as Type` on exported entities and on import → export chains without explicit need; fix the type contract at the source when possible.
+- In slices and services when handling API errors, consider **`instanceof`** on the transport error class from `@/types` first, following existing code (`http-client.mdc`, `store-rtk.mdc`).

package/presets/cursor/next/rules/package-manager.mdc

@@ -1,16 +1,16 @@
 ---
-description: Перед командами в терминале определять менеджер пакетов репозитория и использовать только его
+description: Before terminal commands, detect the repository package manager and use only that one
 alwaysApply: true
 ---
 
-# Менеджер пакетов (терминал)
+# Package manager (terminal)
 
-Перед **`npm install` / `yarn` / `pnpm` / `bun`** и **`… run …`** определи менеджер репозитория и **используй только его**.
+Before **`npm install` / `yarn` / `pnpm` / `bun`** and **`… run …`**, detect the repository package manager and **use only that one**.
 
-## Как определить
+## How to detect
 
-1. **`packageManager`** в `package.json` (корень или `app/package.json`).
-2. **Lockfile** рядом: `yarn.lock` → yarn; `pnpm-lock.yaml` → pnpm; `package-lock.json` → npm; `bun.lock(b)` → bun.
-3. Если неоднозначно — где `node_modules` и какой lockfile в CI.
+1. **`packageManager`** in `package.json` (root or `app/package.json`).
+2. **Lockfile** nearby: `yarn.lock` → yarn; `pnpm-lock.yaml` → pnpm; `package-lock.json` → npm; `bun.lock(b)` → bun.
+3. If ambiguous — where `node_modules` lives and which lockfile CI uses.
 
-Рабочий каталог для scripts — **`app/`**. Примеры: `yarn lint`, `pnpm run test`. Не угадывай — проверь файлы.
+Working directory for scripts — **`app/`**. Examples: `yarn lint`, `pnpm run test`. Do not guess — check the files.

package/presets/cursor/next/rules/post-change-lint.mdc

@@ -1,40 +1,40 @@
 ---
-description: Прогон ESLint и Stylelint после изменений кода. Requestable — подгружать после правок app/**; агенты обязаны запускать после code edits.
+description: Run ESLint and Stylelint after code changes. Requestable — load after app/** edits; agents must run after code edits.
 alwaysApply: false
 ---
 
-# Линтеры после изменений кода
+# Linters after code changes
 
-**Requestable, но обязателен при изменениях кода:** правило не always-on (экономия контекста); после правок исходников агент **должен** следовать этому чеклисту.
+**Requestable, but must run on code changes:** the rule is not always-on (saves context); after editing source files the agent **must** follow this checklist.
 
-## Когда применять
+## When to apply
 
-После **любого** изменения исходников в `app/**` (TS/TSX/JS/MJS, CSS, styled/Linaria в `.ts`/`.tsx`).
+After **any** change to source files in `app/**` (TS/TSX/JS/MJS, CSS, styled/Linaria in `.ts`/`.tsx`).
 
-Исключения: правки документации вне `app/`, конфигов CI, `.cursor/rules/**`, если исполняемый код приложения не менялся.
+Exceptions: documentation edits outside `app/`, CI configs, `.cursor/rules/**`, if application executable code did not change.
 
-**Pipeline exception:** если задача идёт через agent team и следующий шаг — `build-verifier`, developer может ограничиться lint/type-check **изменённых файлов**; полный прогон — обязанность `build-verifier`. В single-agent режиме (без pipeline) — всегда полный прогон.
+**Pipeline exception:** if the task runs through the agent team and the next step is `build-verifier`, the developer may limit lint/type-check to **changed files**; full run is **`build-verifier`’s** responsibility. In single-agent mode (no pipeline) — always a full run.
 
-## Обязательные команды
+## Required commands
 
-Рабочий каталог — **`app/`**. Менеджер пакетов — **`package-manager.mdc`**.
+Working directory — **`app/`**. Package manager — **`package-manager.mdc`**.
 
-1. **`lint:js`** — полный ESLint по проекту.
-2. **`lint:css`** — полный Stylelint (`**/*.{css,ts}`).
+1. **`lint:js`** — full ESLint across the project.
+2. **`lint:css`** — full Stylelint (`**/*.{css,ts}`).
 
-Точечный lint на один файл **не заменяет** полный прогон перед завершением задачи (кроме pipeline exception выше).
+Targeted lint on one file **does not replace** a full run before completing the task (except the pipeline exception above).
 
-## Алгоритм
+## Procedure
 
-1. Завершить правки кода.
-2. Запустить **`lint:js`** и **`lint:css`** из `app/`.
-3. Проанализировать весь вывод; исправить errors/warnings в изменённых файлах; для Stylelint — **`lint:css --fix`** если автоисправимо.
-4. Повторить до exit code 0 или зафиксировать блокер в ответе пользователю.
-5. **`type-check`** при изменениях TypeScript. CI-уровень: **`lint`** (= `lint:js` + `lint:css` + `type-check`).
+1. Finish code edits.
+2. Run **`lint:js`** and **`lint:css`** from `app/`.
+3. Analyze full output; fix errors/warnings in changed files; for Stylelint — **`lint:css --fix`** if auto-fixable.
+4. Repeat until exit code 0 or record a blocker in the user response.
+5. **`type-check`** when TypeScript changed. CI level: **`lint`** (= `lint:js` + `lint:css` + `type-check`).
 
-## Что исправлять
+## What to fix
 
-- **Errors** — обязательно.
-- **Warnings** — обязательно в файлах задачи; вне скоупа — упомянуть, если мешают нулевому exit code.
+- **Errors** — must fix.
+- **Warnings** — must fix in task files; out of scope — mention if they block a zero exit code.
 
-Конфиги: `app/eslint.config.mjs`, `app/.stylelintrc` (порядок CSS — `css-property-order-stylelint.mdc`).
+Configs: `app/eslint.config.mjs`, `app/.stylelintrc` (CSS order — `css-property-order-stylelint.mdc`).

package/presets/cursor/next/rules/preset-layering.mdc

@@ -9,29 +9,28 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-layering.md -->
 
-
 # Preset layering
 
-Правила для **авторов пресетов** (`packages/ai-rules/presets/**`). Не always-on в consumer apps.
+Rules for **preset authors** (`packages/ai-rules/presets/**`). Not always-on in consumer apps.
 
-## Слои
+## Layers
 
-| Слой | Где | Что класть |
-|------|-----|------------|
-| **Core** | `presets/_shared/core/**` | Stack-agnostic prose + checklists; без frontmatter; без путей `app/**`, `Features/**`, Playwright, xcodebuild |
-| **Stack** | `presets/{cursor\|claude}/<stack>/` | Domain/tooling, always-on trio стека, stack examples в **Stack notes** |
+| Layer | Where | What to put |
+|-------|-------|-------------|
+| **Core** | `presets/_shared/core/**` | Stack-agnostic prose + checklists; no frontmatter; no paths `app/**`, `Features/**`, Playwright, xcodebuild |
+| **Stack** | `presets/{cursor\|claude}/<stack>/` | Domain/tooling, stack always-on trio, stack examples in **Stack notes** |
 | **Platform** | Cursor `.mdc` / Claude `.md` | Frontmatter (`alwaysApply`/`globs` vs `paths:`), platform-only (`BUGBOT.md`, `CLAUDE.md`) |
 
-## Куда класть новое правило
+## Where to put a new rule
 
-1. Общие принципы для всех стеков → **core** + адаптеры с `<!-- shared-core: … -->`.
-2. Только один из installable стеков (`next` / `nuxt` / `svelte` / `ios-swift` / `go` / `java` / `mcp-ts` / `php-hexagonal` / `php-laravel`) → **stack-specific** (не в `_shared`).
-3. Только Cursor или только Claude packaging → platform artifact / frontmatter, не дублировать семантику.
+1. Shared principles for all stacks → **core** + adapters with `<!-- shared-core: … -->`.
+2. Only one of the installable stacks (`next` / `nuxt` / `svelte` / `ios-swift` / `go` / `java` / `mcp-ts` / `php-hexagonal` / `php-laravel`) → **stack-specific** (not in `_shared`).
+3. Only Cursor or only Claude packaging → platform artifact / frontmatter; do not duplicate semantics.
 
 ## SoT
 
 - Packages path — SoT; root `.cursor/` — dogfood sync.
 - Per stack: **Cursor** `presets/cursor/<stack>/` → Claude twin same PR.
-- `_shared` **не** `--preset` и не копируется CLI `init`.
+- `_shared` is **not** a `--preset` and is not copied by CLI `init`.
 
-См. также: `preset-twin-sync`, `preset-token-budget`, `preset-pr-checklist`, `preset-no-cross-stack-leakage`.
+See also: `preset-twin-sync`, `preset-token-budget`, `preset-pr-checklist`, `preset-no-cross-stack-leakage`.

package/presets/cursor/next/rules/preset-no-cross-stack-leakage.mdc

@@ -9,10 +9,9 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-no-cross-stack-leakage.md -->
 
-
 # Preset no cross-stack leakage
 
-Запрет протекания stack-specific имён, путей и handoff stems между пресетами.
+Ban leakage of stack-specific names, paths, and handoff stems across presets.
 
 ## Principles
 

package/presets/cursor/next/rules/preset-pr-checklist.mdc

@@ -9,19 +9,18 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-pr-checklist.md -->
 
-
 # Preset PR checklist
 
-Чеклист для PR, затрагивающих `packages/ai-rules/presets/**` (и dogfood `.cursor/` sync).
+Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.cursor/` sync).
 
 ## Before merge
 
-- [ ] **SoT:** правки в `packages/…` (не только root `.cursor/`)
-- [ ] **Core:** если менялся `_shared/core/**` — обновлены все `<!-- shared-core: … -->` consumers (или documented intentional fork)
-- [ ] **Twin:** Cursor change → Claude twin **same PR** (**FAIL** if missing on next, nuxt, svelte, ios-swift, go, java, mcp-ts, php-hexagonal, and php-laravel — см. `preset-twin-sync`)
-- [ ] **Mapping:** `claude/<stack>/rules/README.md` mapping table актуален
+- [ ] **SoT:** edits in `packages/…` (not only root `.cursor/`)
+- [ ] **Core:** if `_shared/core/**` changed — all `<!-- shared-core: … -->` consumers updated (or documented intentional fork)
+- [ ] **Twin:** Cursor change → Claude twin **same PR** (**FAIL** if missing on next, nuxt, svelte, ios-swift, go, java, mcp-ts, php-hexagonal, and php-laravel — see `preset-twin-sync`)
+- [ ] **Mapping:** `claude/<stack>/rules/README.md` mapping table is current
 - [ ] **Token budget:** alwaysApply / session-start ≤ 3; meta rules not always-on
-- [ ] **Leakage:** нет чужих stack agent stems / handoff strings (`preset-no-cross-stack-leakage`)
+- [ ] **Leakage:** no foreign stack agent stems / handoff strings (`preset-no-cross-stack-leakage`)
 - [ ] **Twin depth:** domain ≥15 lines; thin aliases documented
 - [ ] **README:** stack `rules/README.md` core→stack mapping / catalog updated if stems added
 - [ ] **CHANGELOG / package README:** note when public preset paths or install surface change

package/presets/cursor/next/rules/preset-token-budget.mdc

@@ -9,21 +9,20 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-token-budget.md -->
 
-
 # Preset token budget
 
-Инварианты загрузки правил в **установленном** пресете (consumer app).
+Invariants for rule loading in an **installed** preset (consumer app).
 
 ## Hard caps
 
 | Platform | Always-on | Cap |
 |----------|-----------|-----|
 | Cursor | `alwaysApply: true` | **≤ 3** |
-| Claude | rules **without** `paths:` | **ровно 3** |
+| Claude | rules **without** `paths:` | **exactly 3** |
 
 **Claude Option A (README exclusion):** when counting Claude rules without `paths:` / session-start, **exclude `**/README.md`** (topic indexes are not session-start rules). The intended session-start trio remains **exactly 3**; body budget sums **only those 3** rules.
 
-Session-start body budget (где задокументировано): ≤140 строк суммарно (stretch ≤120).
+Session-start body budget (where documented): ≤140 lines total (stretch ≤120).
 
 ## Meta / author rules
 

package/presets/cursor/next/rules/preset-twin-sync.mdc

@@ -9,7 +9,6 @@ alwaysApply: false
 
 <!-- shared-core: meta/preset-twin-sync.md -->
 
-
 # Preset twin sync
 
 Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.

package/presets/cursor/next/rules/public-imports.mdc

@@ -1,5 +1,5 @@
 ---
-description: Импорт доменных типов и API только через публичные barrel @/types и @/api
+description: Import domain types and API only through public barrels @/types and @/api
 globs:
   - app/src/ui/**/*
   - app/src/store/**/*
@@ -10,16 +10,16 @@ alwaysApply: false
 impact: HIGH
 ---
 
-# Публичные импорты (`@/types`, `@/api`)
+# Public imports (`@/types`, `@/api`)
 
-**Коллизии:** импорт типов — раздел `@/types` ниже; API вне `app/src/api/**` — раздел `@/api` ниже (дублирует ESLint `no-restricted-imports` в `app/eslint.config.mjs`).
+**Collisions:** type imports — `@/types` section below; API outside `app/src/api/**` — `@/api` section below (mirrors ESLint `no-restricted-imports` in `app/eslint.config.mjs`).
 
 ## `@/types`
 
-- **Публичный API типов** — barrel `app/src/types/index.ts`; импортировать типы только как `@/types` (или `@/types/index`).
-- **Запрещено** обходить barrel: `@/types/<что‑угодно>`, кроме enum.
-- **Enum** — только `@/types/enums` / `@/types/enums.ts`.
-- Внутри `app/src/types/**` — относительные импорты между файлами слоя.
+- **Public types API** — barrel `app/src/types/index.ts`; import types only as `@/types` (or `@/types/index`).
+- **Forbidden** to bypass the barrel: `@/types/<anything>`, except enums.
+- **Enums** — only `@/types/enums` / `@/types/enums.ts`.
+- Inside `app/src/types/**` — relative imports between layer files.
 
 ```typescript
 // ✅
@@ -30,23 +30,23 @@ import { SomeEnum } from '@/types/enums'
 import type { TUserProfile } from '@/types/User.types'
 ```
 
-Новые публичные типы — реэкспорт в `app/src/types/index.ts` по **`layer-barrel-exports.mdc`**.
+New public types — re-export in `app/src/types/index.ts` per **`layer-barrel-exports.mdc`**.
 
 ## `@/api`
 
-- **Публичный API** — barrel `app/src/api/index.ts`. Вне `app/src/api/**` — только `import … from '@/api'` (или `@/api/index`).
-- **Запрещено** снаружи слоя: `@/api/<что‑угодно>`, кроме `@/api/index`.
-- Внутри `app/src/api/**` — относительные импорты и `@/api/services/**`, `@/api/clients/**`.
+- **Public API** — barrel `app/src/api/index.ts`. Outside `app/src/api/**` — only `import … from '@/api'` (or `@/api/index`).
+- **Forbidden** from outside the layer: `@/api/<anything>`, except `@/api/index`.
+- Inside `app/src/api/**` — relative imports and `@/api/services/**`, `@/api/clients/**`.
 
 ```typescript
-// ✅ в store, UI, lib вне app/src/api
+// ✅ in store, UI, lib outside app/src/api
 import { MedcardApiService } from '@/api'
 
-// ❌ снаружи app/src/api
+// ❌ outside app/src/api
 import { MedcardApiService } from '@/api/services/MedcardApiService/MedcardApiService'
 ```
 
-Новые публичные символы API — реэкспорт в `app/src/api/index.ts` по **`layer-barrel-exports.mdc`**.
+New public API symbols — re-export in `app/src/api/index.ts` per **`layer-barrel-exports.mdc`**.
 ## Incorrect
 
 ```ts

package/presets/cursor/next/rules/react-a11y-coding.mdc

@@ -1,37 +1,37 @@
 ---
-description: Accessibility при написании React UI — семантика, формы, focus, keyboard
+description: Accessibility when writing React UI — semantics, forms, focus, keyboard
 globs: app/src/ui/**/*.tsx,app/src/ui/**/*.ts
 alwaysApply: false
 ---
 
-# A11y при разработке UI
+# A11y when developing UI
 
-Reviewer (`accessibility-reviewer`) проверяет diff; эти правила — **при написании** кода.
+The reviewer (`accessibility-reviewer`) checks the diff; these rules apply **while writing** code.
 
-## Семантика и ARIA
+## Semantics and ARIA
 
-- Предпочитать **нативные элементы** (`button`, `a`, `label`, `input`) вместо `div` с `onClick`.
-- **`role` / `aria-*`** — только когда нативного аналога нет; не дублировать то, что даёт семантика.
-- Заголовки — иераархия `h1`–`h6` без пропусков уровней ради стилей.
+- Prefer **native elements** (`button`, `a`, `label`, `input`) over `div` with `onClick`.
+- **`role` / `aria-*`** — only when there is no native equivalent; do not duplicate what semantics already provide.
+- Headings — `h1`–`h6` hierarchy without skipping levels for styling.
 
-## Формы
+## Forms
 
-- Каждый input связан с **`label`** (`htmlFor` / `id` или обёртка).
-- Сообщения об ошибках — **`aria-describedby`**, `aria-invalid` при validation errors.
-- Кнопки submit vs button — явный `type`.
+- Every input is associated with a **`label`** (`htmlFor` / `id` or wrapper).
+- Error messages — **`aria-describedby`**, `aria-invalid` on validation errors.
+- Submit vs button — explicit `type`.
 
-## Клавиатура и focus
+## Keyboard and focus
 
-- Все интерактивные элементы **достижимы с Tab** и активируются Enter/Space где ожидается.
-- **Modals/drawers** — focus trap, возврат focus на trigger при закрытии, Esc закрывает (если по UX).
-- Не удалять видимый **focus outline** без замены на доступный custom focus style.
+- All interactive elements are **reachable via Tab** and activatable with Enter/Space where expected.
+- **Modals/drawers** — focus trap, return focus to trigger on close, Esc closes (if UX allows).
+- Do not remove visible **focus outline** without an accessible custom focus style.
 
-## Контент
+## Content
 
-- Изображения — **`alt`** (пустой `alt` только для декора).
-- Иконки-кнопки — **`aria-label`** или visually hidden text.
-- Динамические обновления — `aria-live` для критичных status/error (умеренно).
+- Images — **`alt`** (empty `alt` only for decorative images).
+- Icon buttons — **`aria-label`** or visually hidden text.
+- Dynamic updates — `aria-live` for critical status/error (use sparingly).
 
-## Проверка
+## Verification
 
-- При сомнении — devtools a11y tree или `accessibility-reviewer` в pipeline для UI-heavy фич.
+- When unsure — devtools a11y tree or `accessibility-reviewer` in the pipeline for UI-heavy features.