zircote/swagger-php

What's Changed

• fix(Spec): update remaining $ref type-hints to accept OA\Schema\Ref by @DerManoMann in #2119
• chore(CS): follow rector rule changes by @DerManoMann in #2120
• feat(Spec): add shortcut to omit OA\Property when stacking witbh OA\Schema by @DerManoMann in #2121
• refactor(Spec): refactor attribute contains() method by @DerManoMann in #2122
• fix(Spec): visit all ref with eachRef() by @DerManoMann in #2123
• feat(Spec): introduce ComponentIndex for lazy resolution of $ref values and component lookups by @DerManoMann in #2124
• fix(Type): resolve ``\stdClass` type hint as OpenAPI object type by @DerManoMann in #2125

Full Changelog: 6.5.3...6.6.0

What's Changed

• feat(Spec): refactor/assembler level resolution by @DerManoMann in #2104
• Feat/scratch hybrid spec by @DerManoMann in #2108
• Explicitely allow additional CLI args for phpunit (only) by @DerManoMann in #2110
• feat(Spec): limit request body support to Post, 'Put, PatchandDelete` by @DerManoMann in #2109
• refactor(Spec): move getDirectInterfaces into AttributeFactory by @DerManoMann in #2112
• feat(Spec): add more spec scratch fixtures (batch II) by @DerManoMann in #2111
• refactor(Spec): refactor mergeAllOf and dedupAllOfRefs logic into Refs augmenter by @DerManoMann in #2113
• fix(Spec): minor compile improvements and handle of PHP warnings by @DerManoMann in #2115
• chore(CS): Enable php-cs-fixer rule ordered_class_elements by @DerManoMann in #2116
• feat(Spec): add inheritance reference doc by @DerManoMann in #2118
• feat(Spec): introduce OA\Schema\Ref which can be used as schema and on ref: directyl by @DerManoMann in #2117
• feat(Spec): add operation inheritance by @DerManoMann in #2114

Full Changelog: 6.5.2...6.5.3

What's Changed

• feat(Spec): improve AttributeTranslatorInterface by @DerManoMann in #2096
• Cleanup Rector rules and adjust dev dependencies by @DerManoMann in #2097
• feat(Spec): simplify sharing of TokenScanner by @DerManoMann in #2099
• Add roadmap by @DerManoMann in #2101
• chore(Spec): simplify specification population by replacing foreach loops with unpacking operations by @DerManoMann in #2102
• feat(Spec): clarify attribute translator lifecycle and add tests by @DerManoMann in #2100
• Remove redundant description attribute from #[OA\Property] annotation by @DerManoMann in #2103
• chore(Rector): update config by @DerManoMann in #2105
• chore(Spec): refactor OpenApi31Compiler: consolidate repetitive patterns by @DerManoMann in #2106
• feat(Spec): nullable summary / description by @DerManoMann in #2107

Full Changelog: 6.5.1...6.5.2

What's Changed

• feat(Spec): widen the type of the content parameter (MediaType) to accept MediaType|array|null by @DerManoMann in #2088
• feat(Spec): add string-backed enums for fixed OpenAPI spec values by @DerManoMann in #2089
• feat(Spec): add reference to Specefication to build Result by @DerManoMann in #2093
• feat(Spec): widen Builder sources to accept \Reflector instances too (except in CLASSIC mode) by @DerManoMann in #2091
• feat(Spec): add media type shortcuts by @DerManoMann in #2090
• feat(SPEC): add shortcut attribute Items by @DerManoMann in #2094
• Remove spec-attributes.md; content no longer relevant or needed by @DerManoMann in #2095

Full Changelog: 6.5.0...6.5.1

Spec Pipeline

This version introduces the spec pipeline - a new set of attributes that will replace the current (classic) annotations/attributes.
It is using a radically different approach in how the code is organized which makes it a lot easier to maintain.

Right now, the new code is disabled and nothing changes. Key is that in order to try the new code the new OpenApi\Builder needs to be used. Again - using the Builder will, by default, change nothing and the current classic code is used.

The new Builder::setMode() method allows to run the new spec pipeline in two modes:

• HYBRID: Enables spec support where found and also routes all classic annotations/attributes through the new spec pipeline.
  Under the hood the classic Generator is used to load/instantiate classic annotations/attributes. Then a custom bridge translates all of those into new thin OpenApi\Spec attributes and adds them to the spec pipeline.
• SPEC: Only new spec attributes are processed.

HYBRID is a good way to see how compatible things are and also a migration path, as a codebase could be upgrade file by file.

All spec pipeline related commits have been omitted from the change list for clarity and brevity. Going forward these will be marked as feat(Spec): and listed as all other changes.

Testing and Feedback

All current tests pass in HYBRID mode. However, there hasn't been any testing on actual projects yet. Testing the new code in hybrid mode on existing projects and feedback would be greatly appreciated.

What's Changed

• fix: correct TokenScanner::scanFile() @return phpdoc type by @DerManoMann in #2053
• refactor: modernize tools code (strict comparisons, str_* functions, type hints) by @DerManoMann in #2052
• chore: add CLAUDE.md with project tooling and test conventions by @DerManoMann in #2055
• refactor: extract shared TypeResolver core from TypeInfoTypeResolver by @DerManoMann in #2059
• Bump actions/setup-node from 4 to 6 by @dependabot[bot] in #2060
• Remove workflow to semi-automate backporting PRs to the 5.x branch by @DerManoMann in #2062
• feat: add Pipeline grouping and PipeInterface by @DerManoMann in #2056
• fix: replace CustomName/Blink with CustomName-Blink in examples and annotations by @DerManoMann in #2069
• Exclude empty tags array from serialization by @DerManoMann in #2086

Full Changelog: 6.4.0...6.5.0

What's Changed

• feat: add Builder as unified entry point by @DerManoMann in #2044

Full Changelog: 6.3.2...6.4.0

What's Changed

• Use classes from new Utils namespace by @DerManoMann in #2041
• refactor: extract SourceScanner from Generator by @DerManoMann in #2042
• Add CS multiline_comment_opening_closing rule by @DerManoMann in #2043
• Replace Spectral with Redocly for spec validation by @DerManoMann in #2045
• Add CS phpdoc_line_span rule for class/method docblocks by @DerManoMann in #2048
• Remove dev dep composer/package-versions-deprecated by @DerManoMann in #2049
• refactor: rewrite doc generation tools by @DerManoMann in #2050
• Fix CleanUnusedComponents removing schemas referenced via JsonContent by @DerManoMann in #2047

Full Changelog: 6.3.1...6.3.2

What's Changed

• fix: add native array|string type to Serializer::doDeserializeBaseProperty() by @DerManoMann in #2036
• refactor: extract Generator::UNDEFINED to standalone Undefined class by @DerManoMann in #2035
• refactor: remove version branching from type resolvers by @DerManoMann in #2037
• refactor: extract generic docblock parsing to Utils\DocBlockParser by @DerManoMann in #2038
• refactor: move TokenScannerand other utils to OpenApi\Utils namespace by @DerManoMann in #2039
• refactor: extract TypeMapper as pipeline-agnostic type mapping utility by @DerManoMann in #2040

Full Changelog: 6.3.0...6.3.1

What's Changed

• Bump actions/checkout from 6 to 7 by @dependabot[bot] in #2026
• Bump actions/cache from 5 to 6 by @dependabot[bot] in #2029
• fix: drop unmappable types in nested and union schemas by @alleknalle in #2028
• Fix/clean unused components performance by @DerManoMann in #2030
• fix: PHP 8.5 deprecation for null as array offset by @DerManoMann in #2032
• feat: resolve phpdoc array shapes to object schemas by @alleknalle in #2027
• Refactor/analysis merge annotation by @DerManoMann in #2031
• Refresh docs by @DerManoMann in #2033

New Contributors

• @alleknalle made their first contribution in #2028

Full Changelog: 6.2.0...6.3.0

What's Changed

• Make AbstractAnnotation::$_context non-nullable by @krissss in #2008
• fix: prevent PHP "mixed" from being emitted as invalid OpenAPI "type: mixed" by @krissss in #2011
• Add return type to GeneratorAwareInterface::setGenerator() and align related code by @DerManoMann in #2013
• Add domain glossary (CONTEXT.md) by @DerManoMann in #2016
• fix: remove redundant is_array() check in Serializer by @DerManoMann in #2020
• fix: remove consumed annotations from analysis registry by @DerManoMann in #2024

Full Changelog: 6.1.2...6.2.0