Update docs

Signed-off-by: Felipe Sayão Lobato Abreu <github@mentordosnerds.com>

Author: coisa

docs/examples/frameworks-laravel.rst

@@ -0,0 +1,24 @@
+Integrating with Laravel
+=======================
+
+You can use FastForward Container to register custom services or providers in a Laravel application, or to compose external providers with Laravel's container.
+
+.. code-block:: php
+
+   use FastForward\Container\ServiceProvider\ArrayServiceProvider;
+   use Illuminate\Container\Container as LaravelContainer;
+
+   $laravel = new LaravelContainer();
+   $provider = new ArrayServiceProvider([
+       'external_service' => fn() => new ExternalService(),
+   ]);
+
+   // Register FastForward provider services into Laravel
+   foreach ($provider->getFactories() as $id => $factory) {
+       $laravel->bind($id, fn() => $factory($laravel));
+   }
+
+   // Or directly bind a factory that returns a service from FastForward provider
+   $laravel->bind('external_service', new InvokableFactory(ExternalService::class));
+
+   $service = $laravel->make('external_service');

docs/examples/frameworks-slim.rst

@@ -0,0 +1,22 @@
+Integrating with Slim Framework
+==============================
+
+You can use FastForward Container as the dependency injection container for Slim Framework.
+
+.. code-block:: php
+
+   use FastForward\Container\container;
+   use FastForward\Container\ServiceProvider\ArrayServiceProvider;
+   use Slim\App;
+
+   $provider = new ArrayServiceProvider([
+       'logger' => fn() => new Logger('api'),
+   ]);
+   $container = container($provider);
+
+   $app = App::createFromContainer($container);
+   $app->get('/ping', function ($request, $response) {
+       $logger = $this->get('logger');
+       $logger->info('Ping route called');
+       return $response->withJson(['pong' => true]);
+   });

docs/examples/index.rst

@@ -1,11 +1,16 @@
 Examples
 ========
 
+This section contains practical usage examples for FastForward Container, covering basic service registration, providers, factories, testing, feature toggles, middleware, and integration with popular frameworks. Each example demonstrates a real-world scenario to help you get started quickly or solve common problems.
+
 .. toctree::
    :maxdepth: 1
 
    basic
    providers
    providers-testing
    providers-feature-toggle
+   middleware
+   frameworks-laravel
+   frameworks-slim
    factories

docs/examples/middleware.rst

@@ -0,0 +1,27 @@
+Using Middlewares
+=================
+
+You can register middleware services and compose them using providers.
+
+.. code-block:: php
+
+   use FastForward\Container\ServiceProvider\ArrayServiceProvider;
+   use FastForward\Container\container;
+
+   class AuthMiddleware {
+       public function __invoke($request, $handler) { /* ... */ }
+   }
+   class LoggingMiddleware {
+       public function __invoke($request, $handler) { /* ... */ }
+   }
+
+   $provider = new ArrayServiceProvider([
+       'middlewares' => fn() => [
+           new AuthMiddleware(),
+           new LoggingMiddleware(),
+       ],
+   ]);
+
+   $container = container($provider);
+   $middlewares = $container->get('middlewares');
+   // Use $middlewares in your framework or custom pipeline