fix: add missing support for oneOf directive in schema printer

[jasonbahl]

Fix: Add Missing Test and Support for @oneOf Directive in Schema Printer

Summary

This PR addresses missing test coverage and implementation gaps for the @oneOf directive in the schema printer. While PR #1715 implemented the core @oneOf directive support, it was missing tests to ensure the directive is properly printed when schemas are serialized, and the underlying build cycle was not preserving the directive.

This fix ensures full compatibility with the GraphQL.js reference implementation for schema printing and rebuilding.

Missing Test Coverage

• Added testInputTypeWithOneOfDirective() in SchemaPrinterTest.php to verify @oneOf directive printing for input types with isOneOf: true
• Added testCorrectlyExtendInputObjectTypeWithOneOfDirective() in BuildSchemaTest.php to cover @oneOf directive parsing from input object extensions
• Matches GraphQL.js test pattern from printSchema-test.ts

Schema Printer Fix

• Modified printInputObject() in SchemaPrinter.php to check $type->isOneOf() and append @oneOf directive when true
• Preserves existing formatting and integrates seamlessly with current printer logic

Build Schema Fix

• Enhanced makeInputObjectDef() in ASTDefinitionBuilder.php to:
  • Parse @oneOf directive from input object definition nodes using Values::getDirectiveValues()
  • Parse @oneOf directive from extension nodes (previously uncovered code path)
  • Set isOneOf property correctly when building InputObjectType instances
• Added proper exception handling with @throws annotations for PHPStan compliance

Root Cause

The issue occurred because:

1. SchemaPrinter::printInputObject() was not checking the isOneOf property
2. ASTDefinitionBuilder::makeInputObjectDef() was not parsing the @oneOf directive from AST nodes
3. This broke the build cycle: InputObjectType → print → build → print was not preserving the directive

Test Coverage

• Schema printing verification: Ensures @oneOf directive appears in printed schema
• Build cycle verification: Confirms directive is preserved through SchemaPrinter::doPrint() → BuildSchema::build() → SchemaPrinter::doPrint() cycle
• Extension scenario coverage: Verifies @oneOf directive parsing from both main definitions and extension nodes
• Backward compatibility: All existing tests continue to pass

Breaking Changes

None. This is a bug fix that adds missing functionality without changing existing behavior.

Validation Results

• ✅ All schema printer tests passing (49/49)
• ✅ All build schema tests passing (66/66)
• ✅ All utils tests passing (402/402)
• ✅ PHPStan analysis clean (0 errors)
• ✅ Complete build cycle preservation verified
• ✅ Extension directive parsing verified

Example Scenarios

Main Definition:

input SearchInput @oneOf {
  byId: ID
  byName: String
}

Extension Definition:

input SearchInput {
  byId: ID
}

extend input SearchInput @oneOf {
  byName: String
}

Both scenarios now properly preserve the @oneOf directive through the complete build cycle.

[spawnia]

Thank you, released with https://github.com/webonyx/graphql-php/releases/tag/v15.21.1.