docs(mockery): add integration guide for Mockery mocking library

Author: roxblnfk

.vitepress/config.mts

@@ -113,6 +113,7 @@ gtag('config', 'G-VYGDN3X0PR');`],
               text: 'Integrations',
               items: [
                 { text: 'Infection', link: '/docs/bridge/infection.md' },
+                { text: 'Mockery', link: '/docs/bridge/mockery.md' },
               ],
             },
             {
@@ -189,6 +190,7 @@ gtag('config', 'G-VYGDN3X0PR');`],
               text: 'Интеграции',
               items: [
                 { text: 'Infection', link: '/ru/docs/bridge/infection.md' },
+                { text: 'Mockery', link: '/ru/docs/bridge/mockery.md' },
               ],
             },
             {

docs/bridge/mockery.md

@@ -0,0 +1,95 @@
+---
+outline: [2, 3]
+llms: true
+llms_description: "Integration with Mockery mocking library: installation, setup at application and suite levels, automatic mock expectation verification after each test, status mapping (Passed, Risky, Failed)."
+---
+
+# Mockery
+
+[Mockery](https://github.com/mockery/mockery) is a popular PHP mocking library with an expressive API (`Mockery::mock()`, `expects()`, `spy()`). The `testo/bridge-mockery` package integrates it with Testo.
+
+<plugin-info name="Mockery" class="\Testo\Bridge\Mockery\MockeryPlugin" />
+
+## Installation
+
+```bash
+composer require --dev mockery/mockery testo/bridge-mockery
+```
+
+## Setup
+
+Register the <class>\Testo\Bridge\Mockery\MockeryPlugin</class> in the `plugins` section — either at the application level (for all suites) or for a specific Test Suite (for a particular set of tests).
+
+::: code-group
+```php [Application level]
+use Testo\Application\Config\ApplicationConfig;
+use Testo\Bridge\Mockery\MockeryPlugin;
+
+return new ApplicationConfig(
+    src: ['src'],
+    suites: [ /** Suites **/ ],
+    plugins: [
+        new MockeryPlugin(),
+    ],
+);
+```
+
+```php [Suite level]
+use Testo\Application\Config\SuiteConfig;
+use Testo\Bridge\Mockery\MockeryPlugin;
+
+new SuiteConfig(
+    name: 'Unit',
+    location: ['tests/Unit'],
+    plugins: [
+        new MockeryPlugin(),
+    ],
+);
+```
+:::
+
+## Mock Expectation Verification
+
+The bridge automatically verifies mock expectations after each test and maps the result to Testo statuses — manual teardown is not required. The rule is straightforward: **if you declare an expectation and fulfill it, the test passes; if you don't, it fails.**
+
+- **A fulfilled expectation** counts as an assertion. So a test whose only check is a mock stays <enum>\Testo\Core\Value\Status::Passed</enum> rather than <enum>\Testo\Core\Value\Status::Risky</enum> (Testo marks a passing test with no assertions as risky — a safeguard against forgotten assertions, see <plugin>Assert</plugin>).
+- **An unfulfilled expectation** fails the test (**Failed**) and shows up in the assertion history as a failure.
+
+::: code-group
+```php [Passed]
+#[Test]
+public function notifies(): void
+{
+    $mailer = Mockery::mock(Mailer::class);
+    $mailer->expects('send')->once();       // expectation — and an assertion at that
+
+    (new Notifier($mailer))->notify('hi');  // send() is called once, fulfilling the expectation
+}
+```
+
+```php [Risky]
+#[Test]
+public function notifies(): void
+{
+    $mailer = Mockery::spy(Mailer::class);
+
+    (new Notifier($mailer))->notify('hi');
+    // no expectations, no assertions — nothing to check → Risky
+}
+```
+
+```php [Failed]
+#[Test]
+public function notifies(): void
+{
+    $mailer = Mockery::mock(Mailer::class);
+    $mailer->expects('send')->once();       // expect exactly one send() call
+
+    // …but notify() was never called → expectation unfulfilled → Failed
+}
+```
+:::
+
+::: info
+The plugin only works with regular tests (for example, those marked with the <attr>\Testo\Test</attr> attribute). In inline tests, benchmarks, and other test types, mocks are not verified or cleaned up automatically — you'll need to handle that yourself, directly through Mockery.
+:::

ru/docs/bridge/mockery.md

@@ -0,0 +1,93 @@
+---
+outline: [2, 3]
+---
+
+# Mockery
+
+[Mockery](https://github.com/mockery/mockery) — популярная библиотека мокирования для PHP с выразительным API (`Mockery::mock()`, `expects()`, `spy()`). Пакет `testo/bridge-mockery` интегрирует её с Testo.
+
+<plugin-info name="Mockery" class="\Testo\Bridge\Mockery\MockeryPlugin" />
+
+## Установка
+
+```bash
+composer require --dev mockery/mockery testo/bridge-mockery
+```
+
+## Подключение
+
+Зарегистрируйте <class>\Testo\Bridge\Mockery\MockeryPlugin</class> в секции `plugins` — на уровне приложения (для всех сьютов) или отдельного Test Suite (для конкретного набора тестов).
+
+::: code-group
+```php [Уровень приложения]
+use Testo\Application\Config\ApplicationConfig;
+use Testo\Bridge\Mockery\MockeryPlugin;
+
+return new ApplicationConfig(
+    src: ['src'],
+    suites: [ /** Suites **/ ],
+    plugins: [
+        new MockeryPlugin(),
+    ],
+);
+```
+
+```php [Уровень Test Suite]
+use Testo\Application\Config\SuiteConfig;
+use Testo\Bridge\Mockery\MockeryPlugin;
+
+new SuiteConfig(
+    name: 'Unit',
+    location: ['tests/Unit'],
+    plugins: [
+        new MockeryPlugin(),
+    ],
+);
+```
+:::
+
+## Поведение проверок моков
+
+Адаптер автоматически проверяет ожидания моков после каждого теста и связывает результат со статусами Testo — ручной teardown не нужен. Правило простое: **задекларировали ожидание и выполнили — хорошо, не выполнили — ошибка.**
+
+- **Выполненное ожидание** засчитывается как проверка. Поэтому тест, где единственная проверка — мок, остаётся <enum>\Testo\Core\Value\Status::Passed</enum>, а не <enum>\Testo\Core\Value\Status::Risky</enum> (этим статусом Testo помечает успешный тест без единой проверки — защита от забытого ассерта, см. <plugin>Assert</plugin>).
+- **Невыполненное ожидание** проваливает тест (**Failed**) и попадает в историю проверок как неуспешное.
+
+::: code-group
+```php [Passed]
+#[Test]
+public function notifies(): void
+{
+    $mailer = Mockery::mock(Mailer::class);
+    $mailer->expects('send')->once();       // ожидание — и есть проверка
+
+    (new Notifier($mailer))->notify('hi');  // send() вызывается один раз, выполняя ожидание
+}
+```
+
+```php [Risky]
+#[Test]
+public function notifies(): void
+{
+    $mailer = Mockery::spy(Mailer::class);
+
+    (new Notifier($mailer))->notify('hi');
+    // ни ожидания, ни ассерта — проверять нечего → Risky
+}
+```
+
+```php [Failed]
+#[Test]
+public function notifies(): void
+{
+    $mailer = Mockery::mock(Mailer::class);
+    $mailer->expects('send')->once();       // ждём ровно один вызов send()
+
+    // …но notify() так и не вызвали → ожидание не выполнено → Failed
+}
+```
+:::
+
+::: info
+Плагин настроен только на обычные тесты (например, помеченные атрибутом <attr>\Testo\Test</attr>). Во встроенных тестах, бенчмарках и других моки автоматически не проверяются и не очищаются — этим придётся управлять самостоятельно средствами Mockery.
+:::