phpstan.neon

parameters:
    level: 5

    # The hand-written PHP, which is all this repository actually authors.
    paths:
        - configs
        - tests

    # The stubs are SCANNED, not analysed.
    #
    # They used to sit in `paths`, which asks PHPStan to check the bodies of declarations that are
    # empty by definition -- "should return string but return statement is missing" for every one,
    # plus unknown-class errors for whatever WordPress internals upstream touches. None of it is a
    # defect in this package, and PHPStan 2.x classifies several of those as non-ignorable, so
    # neither an ignoreErrors pattern nor a baseline can hold them.
    #
    # Scanning makes the symbols known without asserting anything about their bodies, which is the
    # only claim a generated stub can honour. What the stubs are checked FOR -- that they parse, and
    # that they declare something -- is tests/StubsTest.php.
    scanFiles:
        - wpforms-constants-stubs.stub
        - wpforms-stubs.stub
    bootstrapFiles:
        - configs/bootstrap.php