Support any type for container variables and factory functions

[clue]

This changeset updates the Container to accept a value of any type for container variables and factory function return values. Previously, values were restricted to objects, scalars, array and null, so providing any other value (such as a resource) would throw a TypeError. This removes that remaining restriction. Closures continue to be treated as factory functions rather than plain values.

$container = new FrameworkX\Container([
    'stream' => STDERR,
    Acme\Todo\UserController::class => function ($stream) {
        return new Acme\Todo\UserController($stream);
    }
]);

This includes new test cases covering resource values for container variables and factory functions. This has 100% code coverage and should be safe to apply.

Builds on top of #306, #303, #302, #284, #182 and others

[Copilot]

Pull request overview

This PR relaxes FrameworkX\Container’s value restrictions so container variables and variable factory functions can yield any PHP value type (e.g. resource), while continuing to treat Closure values as factories (and rejecting factories that return a Closure).

Changes:

• Loosens Container’s internal type constraints by removing the “object|scalar|array|null” restriction for variable values and variable factory return values.
• Updates tests to cover successful use of resource values in variable injection scenarios.
• Updates controller best-practices documentation to describe the expanded supported types.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
src/Container.php	Removes the remaining hard-coded type restriction for container variables / variable factory return values and updates phpdoc to mixed.
tests/ContainerTest.php	Drops tests that expected resources to be rejected and adds new tests that verify resource values work in variable injection.
docs/best-practices/controllers.md	Updates docs to state container variables/factory returns can be “any type”.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.