Pest BDDBehavior-Driven Development for PestPHP

use TestFlowLabs\PestTestAttributes\Given;

class UserFactory extends Factory
{
    #[Given('a user exists')]
    #[Given('bir kullanıcı mevcut')]              // Multi-language
    public function definition(): array { /* ... */ }

    #[Given('a premium user {name} exists')]
    #[Given('premium kullanıcı {name} mevcut')]   // Multi-language
    public function premium(string $name): static
    {
        return $this->state(['name' => $name, 'tier' => 'premium']);
    }

    #[Given('the user has a verified email')]     // State chaining
    public function verified(): static
    {
        return $this->state(['email_verified_at' => now()]);
    }
}

use TestFlowLabs\PestTestAttributes\Given;

class ProductFactory extends Factory
{
    #[Given('a product {name} priced at ${price} exists')]
    public function withNameAndPrice(string $name, float $price): static
    {
        return $this->state(['name' => $name, 'price' => $price]);
    }
}

use TestFlowLabs\PestTestAttributes\When;

class OrderActions
{
    #[When('the user places an order')]
    public function placeOrder(User $user, Product $product): Order
    {
        // $user and $product auto-injected from Given steps
        return Order::create([
            'user_id' => $user->id,
            'product_id' => $product->id,
        ]);
    }

    #[When('applies discount code {code}')]
    public function applyDiscount(Order $order, string $code): void
    {
        $order->applyDiscount($code);
    }

    #[When('the user orders {qty} items')]
    public function orderQuantity(Order $order, int $qty): void
    {
        $order->update(['quantity' => $qty]);
    }
}

use TestFlowLabs\PestTestAttributes\Then;

class OrderAssertions
{
    #[Then('the order total should be ${expected}')]
    public function assertTotal(Order $order, float $expected): void
    {
        expect($order->total)->toBe($expected);
    }

    #[Then('the user should receive a confirmation email')]
    public function assertConfirmationEmail(User $user): void
    {
        Mail::assertSent(OrderConfirmation::class, fn ($mail) =>
            $mail->hasTo($user->email)
        );
    }
}