### Install Project Dependencies

Source: https://github.com/calebdw/fakerstan/blob/master/CONTRIBUTING.md

Run this command after cloning your fork to install all necessary project dependencies.

```bash
composer update
```

--------------------------------

### Install FakerStan with Composer

Source: https://github.com/calebdw/fakerstan/blob/master/README.md

Install the FakerStan package as a development dependency using Composer.

```bash
composer require calebdw/fakerstan --dev
```

--------------------------------

### PSR Container Bootstrap for Faker

Source: https://context7.com/calebdw/fakerstan/llms.txt

Example bootstrap file for a PSR-11 container, demonstrating how to bind a Faker instance.

```php
<?php
// /path/to/bootstrap/container.php — variable-style container bootstrap
use Psr\Container\ContainerInterface;

$container = new MyPsrContainer();
$container->bind('faker', fn() => \Faker\Factory::create('en_US'));
// FakerStan reads $container via setsVariable: "container"
```

--------------------------------

### Implement Custom FakerProviderFactory and FakerProvider

Source: https://github.com/calebdw/fakerstan/blob/master/README.md

Example implementation of a custom factory class and the FakerProvider interface for integrating FakerStan with custom Faker generator instances.

```php
<?php

use Faker\Generator;
use CalebDW\FakerStan\FakerProvider;

class CustomFakerProviderFactory
{
    public static function create(): FakerProvider
    {
        return new CustomFakerProvider();
    }
}

class CustomFakerProvider implements FakerProvider
{
    public function getFaker(): Generator
    {
        // or from a DI container
        $faker = new Generator();
        $faker->addProvider(new CustomProvider($faker));
        return $faker;
    }
}


```

--------------------------------

### Configure FakerStan with Custom Factory

Source: https://github.com/calebdw/fakerstan/blob/master/README.md

Example of configuring FakerStan to use a custom factory class for creating the FakerProvider implementation in phpstan.neon(.dist).

```neon
parameters:
  fakerstan:
    fakerProviderFactory: App\CustomFakerProviderFactory
services:
  - class: App\CustomFakerProviderFactory
```

--------------------------------

### Define and Use Custom Faker Providers

Source: https://github.com/calebdw/fakerstan/blob/master/README.md

Example of defining a custom Faker provider with a simple method and a generic method, and then adding it to the Faker generator. This demonstrates how FakerStan infers return types.

```php
<?php
use Faker\Generator;
use Faker\Provider\Base;

class CustomProvider extends Base
{
    public function customMethod(): string
    {
        return 'custom';
    }

    /**
     * @template T
     * @param T $object
     * @return class-string<T>
     */
    public function classFromObject(object $object): string
    {
        return $object::class;
    }
}

$faker = new Generator();
$faker->addProvider(new CustomProvider($faker));

$faker->customMethod(); // string
$faker->classFromObject(new User); // class-string<User>
```

--------------------------------

### Implement Custom FakerProvider Interface

Source: https://context7.com/calebdw/fakerstan/llms.txt

Implement the FakerProvider interface to teach FakerStan about your project's Faker instance and custom providers. This example shows a custom ProductProvider and an AppFakerProvider implementation.

```php
<?php

use CalebDW\Fakerstan\FakerProvider;
use Faker\Generator;
use Faker\Provider\Base;

// A custom Faker provider
class ProductProvider extends Base
{
    /** @return non-empty-string */
    public function productSku(): string
    {
        return strtoupper($this->bothify('??-####'));
    }

    /**
     * @template T of object
     * @param  class-string<T>  $class
     * @return T
     */
    public function make(string $class): object
    {
        return new $class();
    }
}

// Custom FakerProvider implementation
class AppFakerProvider implements FakerProvider
{
    public function getFaker(): Generator
    {
        $faker = new Generator();
        $faker->addProvider(new \Faker\Provider\en_US\Person($faker));
        $faker->addProvider(new ProductProvider($faker));
        return $faker;
    }
}
```

--------------------------------

### Configure FakerStan with PSR-11 Container

Source: https://github.com/calebdw/fakerstan/blob/master/README.md

Example of configuring FakerStan to use a PSR-11 compliant DI container by specifying the factory and container path in phpstan.neon(.dist).

```neon
parameters:
  fakerstan:
    fakerProviderFactory: CalebDW\Fakerstan\PsrContainerFakerProviderFactory
    psrProvider:
      phpContainerPath: /path/to/container.php
      ...
```

--------------------------------

### Include FakerStan Extension in PHPStan Configuration

Source: https://github.com/calebdw/fakerstan/blob/master/README.md

Manually include the FakerStan extension in your phpstan.neon(.dist) configuration file if the extension installer is not used.

```neon
includes:
    - ./vendor/calebdw/fakerstan/extension.neon
```

--------------------------------

### Run All Project Tests

Source: https://github.com/calebdw/fakerstan/blob/master/CONTRIBUTING.md

Execute this command to run all automated tests for the project.

```bash
composer test
```

--------------------------------

### Run PHPUnit Tests

Source: https://github.com/calebdw/fakerstan/blob/master/CONTRIBUTING.md

Execute this command to run the PHPUnit tests specifically.

```bash
composer test:phpunit
```

--------------------------------

### Perform Static Analysis

Source: https://github.com/calebdw/fakerstan/blob/master/CONTRIBUTING.md

Use this command to run static analysis checks on the project code.

```bash
composer test:phpstan
```

--------------------------------

### FakerStan Extension Configuration Reference

Source: https://context7.com/calebdw/fakerstan/llms.txt

Default configuration parameters for FakerStan as defined in the bundled extension.neon file. These can be overridden in your project's phpstan.neon.dist.

```neon
# extension.neon (bundled defaults — override in your phpstan.neon.dist)
parameters:
  fakerstan:
    fakerProviderFactory: CalebDW\Fakerstan\FakerProviderFactory  # default factory
    psrProvider:
      phpContainerPath: null          # required when using PsrContainerFakerProviderFactory
      setsVariable: null              # null = container file returns container
      containerFakerId: Faker\Generator  # PSR-11 container ID for the Faker instance

# To override in your project:
# phpstan.neon.dist
includes:
    - ./vendor/calebdw/fakerstan/extension.neon

parameters:
  level: max
  paths:
    - src
  fakerstan:
    fakerProviderFactory: App\MyFakerProviderFactory
```

--------------------------------

### Configure FakerStan with Symfony Container Path

Source: https://github.com/calebdw/fakerstan/blob/master/README.md

Specific configuration for Symfony projects, setting the phpContainerPath for the PsrContainerFakerProviderFactory.

```neon
parameters:
  fakerstan:
    fakerProviderFactory: CalebDW\Fakerstan\PsrContainerFakerProviderFactory
    psrProvider:
      phpContainerPath: /opt/project/var/cache/dev/App_KernelDevDebugContainer.php
```

--------------------------------

### Create Custom FakerProviderFactory

Source: https://context7.com/calebdw/fakerstan/llms.txt

Implement the AppFakerProviderFactory class to return your custom FakerProvider implementation. This factory is used when a custom factory is configured in phpstan.neon.dist.

```php
<?php

use CalebDW\Fakerstan\FakerProvider;

class AppFakerProviderFactory
{
    public static function create(): FakerProvider
    {
        return new AppFakerProvider(); // returns your FakerProvider implementation
    }
}
```

--------------------------------

### Configure PSR-11 Container Integration

Source: https://context7.com/calebdw/fakerstan/llms.txt

Configure FakerStan to resolve the Faker\Generator from a PSR-11 compatible DI container. Specify the path to the container's bootstrap file and optionally the container's service ID.

```neon
# phpstan.neon.dist — Symfony example (container returns itself via variable)
parameters:
  fakerstan:
    fakerProviderFactory: CalebDW\Fakerstan\PsrContainerFakerProviderFactory
    psrProvider:
      phpContainerPath: /opt/project/var/cache/dev/App_KernelDevDebugContainer.php
      setsVariable: null          # null = file returns container directly
      containerFakerId: Faker\Generator   # default: Faker\Generator class name
```

--------------------------------

### Configure Custom FakerProviderFactory in phpstan.neon.dist

Source: https://context7.com/calebdw/fakerstan/llms.txt

For non-Laravel projects, configure a custom factory in your phpstan.neon.dist file to specify how FakerStan should obtain the Faker instance.

```neon
# phpstan.neon.dist
parameters:
  fakerstan:
    fakerProviderFactory: App\AppFakerProviderFactory

services:
  - class: App\AppFakerProviderFactory
```

--------------------------------

### PHPStan Configuration for FakerStan

Source: https://context7.com/calebdw/fakerstan/llms.txt

Configure FakerStan in your phpstan.neon.dist file to specify the Faker provider factory and PSR-11 container settings.

```neon
parameters:
  fakerstan:
    fakerProviderFactory: CalebDW\Fakerstan\PsrContainerFakerProviderFactory
    psrProvider:
      phpContainerPath: /path/to/bootstrap/container.php
      setsVariable: container     # name of the variable holding the container
      containerFakerId: faker     # ID used to retrieve Faker from the container
```

--------------------------------

### Custom Provider with Generics and Type Inference

Source: https://context7.com/calebdw/fakerstan/llms.txt

Define custom Faker providers with PHPDoc generic annotations. FakerStan resolves these generics, propagating type information through proxy calls like optional(), unique(), and valid().

```php
<?php

use Faker\Generator;
use Faker\Provider\Base;

class TypedProvider extends Base
{
    /**
     * @template T
     * @param  T  $value
     * @return T
     */
    public function passthrough(mixed $value): mixed
    {
        return $value;
    }

    /** @return non-empty-string */
    public function sku(): string
    {
        return strtoupper($this->bothify('??-####'));
    }
}

// PHPStan type assertions (verified by FakerStan's test suite):
/** @param array{bar: string} $data */
function analyse(Generator $faker, array $data): void
{
    $faker->passthrough($data);          // inferred: array{bar: string}
    $faker->unique()->passthrough($data); // inferred: array{bar: string}
    $faker->optional()->passthrough($data); // inferred: array{bar: string}
    $faker->valid()->passthrough($data); // inferred: array{bar: string}

    $faker->sku();          // inferred: string
    $faker->unique()->sku(); // inferred: string

    // Non-public methods are NOT surfaced — PHPStan reports *ERROR*
    // $faker->protectedMethod(); // *ERROR*
}
```

--------------------------------

### Non-Base Providers Registration

Source: https://context7.com/calebdw/fakerstan/llms.txt

Register providers that do not extend Faker\Provider\Base. FakerStan detects public methods on such providers if they are registered on the generator.

```php
<?php

use Faker\Generator;

// Provider that does NOT extend Base
class SizeProvider
{
    public static function size(): string
    {
        $sizes = ['XS', 'S', 'M', 'L', 'XL', 'XXL'];
        return $sizes[array_rand($sizes)];
    }
}

// Register it manually
$faker = new Generator();
$faker->addProvider(new SizeProvider());

// PHPStan (with FakerStan) correctly infers:
$faker->size(); // string  ✓ — no "Call to an undefined method" error
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.