1	<?php
2
3	declare(strict_types=1);
4
5	/**
6	* This file is part of php-fast-forward/container.
7	*
8	* This source file is subject to the license bundled
9	* with this source code in the file LICENSE.
10	*
11	* @copyright Copyright (c) 2025-2026 Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
12	* @license   https://opensource.org/licenses/MIT MIT License
13	*
14	* @see       https://github.com/php-fast-forward/container
15	* @see       https://github.com/php-fast-forward
16	* @see       https://datatracker.ietf.org/doc/html/rfc2119
17	*/
18
19	namespace FastForward\Container;
20
21	use Psr\Container\ContainerInterface as PsrContainerInterface;
22
23	/**
24	* Extends the PSR-11 ContainerInterface to provide a consistent, domain-specific container interface
25	* for the FastForward ecosystem.
26	*
27	* This interface SHALL serve as the preferred type hint within FastForward components, while maintaining
28	* full compatibility with PSR-11 standards.
29	*
30	* Implementations of this interface MUST adhere to the behavior defined by PSR-11, specifically:
31	*
32	* - `get(string $id)` MUST return an entry if available, or throw a `NotFoundExceptionInterface`.
33	* - `has(string $id)` MUST return true if the entry can be resolved, false otherwise.
34	*
35	* This abstraction MAY be extended in the future to incorporate additional container-related functionality
36	* specific to the FastForward framework, without violating PSR-11 compatibility.
37	*/
38	interface ContainerInterface extends PsrContainerInterface {}