build(deps-dev): bump zircote/swagger-php from 6.7.2 to 6.8.1

[dependabot]

Bumps zircote/swagger-php from 6.7.2 to 6.8.1.

Release notes

Sourced from zircote/swagger-php's releases.

6.8.1

Corrects the schema examples handling introduced in 6.8.0.

Upgrading from 6.7.x

6.8.0 changed generated output and the release notes did not say so. @OA\Examples nested under an @OA\Schema or @OA\Property used to emit a keyed map, which no validator accepts. It now emits the list of values JSON Schema calls for:

 YoYo:
   examples:
-    yo:
-      summary: 'the yo'
-      value: YoYo
+    - YoYo

summary, description and externalValue have nowhere to go in a list and are dropped, and an example carrying no value contributes nothing. For Example Objects use a media type, parameter or header — their examples is a map and keeps every field.

Fixed

• @OA\Examples under a schema no longer reports a missing example key-field or a missing summary; neither reaches the output (#2177)
• summary is no longer required on @OA\Examples anywhere — the Example Object has no required fields in the specification
• A schema's examples now accepts plain values, in attributes and docblocks alike, and keeps the order you write when mixed with @OA\Examples:

  #[OA\Property(type: 'integer', examples: [80, 443])]

• The Items attribute's constructor docblock is repaired, so the reference page shows its declared parameter types instead of falling back to the native ones

New diagnostics

Cases that used to pass in silence now warn: an @OA\Examples under a schema with no value, value and externalValue set together, and any other annotation passed as an example.

The cookbook has a new section on schema examples and how they differ from a media type's.

What's Changed

• fix(Attributes): repair the Items constructor docblock by @​DerManoMann in zircote/swagger-php#2179

  Stacked on #2178 and squash-merged, so it carries that change too — most of this release is in that commit.

Full Changelog: zircote/swagger-php@6.8.0...6.8.1

6.8.0

What's Changed

• fix(Annotations): compile a schema's examples as a list in classic too by @​DerManoMann in zircote/swagger-php#2176

Full Changelog: zircote/swagger-php@6.7.2...6.8.0

Commits

• 08c8a2d fix(Attributes): repair the Items constructor docblock (#2179)
• 9477163 fix(Annotations): compile a schema's examples as a list in classic too (#2176)
• See full diff in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: c1bc2c57-2a42-4e52-8d2e-78d24d41d691

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}