chore(deps-dev): Bump squizlabs/php_codesniffer from 3.9.2 to 3.10.1 (#…

…17)

Bumps
[squizlabs/php_codesniffer](https://github.com/PHPCSStandards/PHP_CodeSniffer)
from 3.9.2 to 3.10.1.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/releases">squizlabs/php_codesniffer's
releases</a>.</em></p>
<blockquote>
<h2>3.10.1 - 2024-05-22</h2>
<h3>Added</h3>
<ul>
<li>Documentation for the following sniffs:
<ul>
<li>Generic.Commenting.DocComment</li>
<li>Thanks to <a href="https://github.com/rodrigoprimo">Rodrigo
Primo</a> for the patch.</li>
</ul>
</li>
</ul>
<h3>Changed</h3>
<ul>
<li>The following have received efficiency improvements:
<ul>
<li>Type handling in the PHP Tokenizer</li>
<li>Thanks to <a href="https://github.com/jrfnl">Juliette Reinders
Folmer</a> for the patch.</li>
</ul>
</li>
<li>Various housekeeping, including improvements to the tests and
documentation.
<ul>
<li>Thanks to <a href="https://github.com/jrfnl">Juliette Reinders
Folmer</a> for their contributions.</li>
</ul>
</li>
</ul>
<h3>Fixed</h3>
<ul>
<li>Fixed bug <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/110">#110</a>,
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/437">#437</a>,
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/475">#475</a>:
<code>File::findStartOfStatement()</code>: the start of
statement/expression determination for tokens in parentheses/short array
brackets/others scopes, nested within match expressions, was incorrect
in most cases.
The trickle down effect of the bug fixes made to the
<code>File::findStartOfStatement()</code> method, is that the
Generic.WhiteSpace.ScopeIndent and the PEAR.WhiteSpace.ScopeIndent
sniffs should now be able to correctly determine and fix the indent for
match expressions containing nested expressions.
These fixes also fix an issue with the
<code>Squiz.Arrays.ArrayDeclaration</code> sniff and possibly other,
unreported bugs.
<ul>
<li>Thanks to <a href="https://github.com/jrfnl">Juliette Reinders
Folmer</a> for the patch</li>
</ul>
</li>
<li>Fixed bug <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/504">#504</a>:
The tokenizer could inadvertently mistake the last parameter in a
function call using named arguments for a DNF type.
<ul>
<li>Thanks to <a href="https://github.com/jrfnl">Juliette Reinders
Folmer</a> for the patch</li>
</ul>
</li>
<li>Fixed bug <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/508">#508</a>:
Tokenizer/PHP: extra hardening against handling parse errors in the type
handling layer.
<ul>
<li>Thanks to <a href="https://github.com/jrfnl">Juliette Reinders
Folmer</a> for the patch</li>
</ul>
</li>
</ul>
<hr />
<h3>Statistics</h3>
<p><strong>Closed</strong>: 5 issues
<strong>Merged</strong>: 7 pull requests</p>
<p>If you like to stay informed about releases and more, follow <a
href="https://phpc.social/@phpcs"><code>@​phpcs on Mastodon</code></a>
or <a href="https://twitter.com/PHP_CodeSniffer"><code>@​PHP_CodeSniffer
on X</code></a>.</p>
<p><strong>Full Changelog</strong>: <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/compare/3.10.0...3.10.1">https://github.com/PHPCSStandards/PHP_CodeSniffer/compare/3.10.0...3.10.1</a></p>
<h2>3.10.0 - 2024-05-20</h2>
<h3>Added</h3>
<ul>
<li>Tokenizer support for PHP 8.2 Disjunctive Normal Form (DNF) types.
<a
href="https://github.com/squizlabs/PHP_CodeSniffer/issues/3731">#3731</a>,
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/387">#387</a>,
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/461">#461</a>
<ul>
<li>Includes new <code>T_TYPE_OPEN_PARENTHESIS</code> and
<code>T_TYPE_CLOSE_PARENTHESIS</code> tokens to represent the
parentheses in DNF types.</li>
<li>These new tokens, like other parentheses, will have the
<code>parenthesis_opener</code> and <code>parenthesis_closer</code>
token array indexes set and the tokens between them will have the
<code>nested_parenthesis</code> index.</li>
<li>The <code>File::getMethodProperties()</code>,
<code>File::getMethodParameters()</code> and
<code>File::getMemberProperties()</code> methods now all support DNF
types. <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/471">#471</a>,
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/472">#472</a>,
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/473">#473</a></li>
<li>Additionally, the following sniff has been updated to support DNF
types:
<ul>
<li>Generic.PHP.LowerCaseType <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/478">#478</a></li>
</ul>
</li>
<li>Thanks to <a href="https://github.com/jrfnl">Juliette Reinders
Folmer</a> for the patches.</li>
</ul>
</li>
<li>Documentation for the following sniffs:
<ul>
<li>Squiz.WhiteSpace.FunctionClosingBraceSpace</li>
<li>Thanks to <a href="https://github.com/przemekhernik">Przemek
Hernik</a> for the patch.</li>
</ul>
</li>
</ul>
<h3>Changed</h3>
<ul>
<li>The help screens have received a face-lift for improved usability
and readability. <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/447">#447</a>
<ul>
<li>Thanks to <a href="https://github.com/jrfnl">Juliette Reinders
Folmer</a> for the patch and thanks to <a
href="https://github.com/costdev">Colin Stewart</a>, <a
href="https://github.com/GaryJones">Gary Jones</a> and <a
href="https://github.com/mbomb007"><code>@​mbomb007</code></a> for
reviewing.</li>
</ul>
</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/blob/master/CHANGELOG.md">squizlabs/php_codesniffer's
changelog</a>.</em></p>
<blockquote>
<h2>[3.10.1] - 2024-05-22</h2>
<h3>Added</h3>
<ul>
<li>Documentation for the following sniffs:
<ul>
<li>Generic.Commenting.DocComment</li>
<li>Thanks to [Rodrigo Primo][<a
href="https://github.com/rodrigoprimo"><code>@​rodrigoprimo</code></a>]
for the patch.</li>
</ul>
</li>
</ul>
<h3>Changed</h3>
<ul>
<li>The following have received efficiency improvements:
<ul>
<li>Type handling in the PHP Tokenizer</li>
<li>Thanks to [Juliette Reinders Folmer][<a
href="https://github.com/jrfnl"><code>@​jrfnl</code></a>] for the
patch.</li>
</ul>
</li>
<li>Various housekeeping, including improvements to the tests and
documentation.
<ul>
<li>Thanks to [Juliette Reinders Folmer][<a
href="https://github.com/jrfnl"><code>@​jrfnl</code></a>] for their
contributions.</li>
</ul>
</li>
</ul>
<h3>Fixed</h3>
<ul>
<li>Fixed bug <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/110">#110</a>,
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/437">#437</a>,
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/475">#475</a>:
<code>File::findStartOfStatement()</code>: the start of
statement/expression determination for tokens in parentheses/short array
brackets/others scopes, nested within match expressions, was incorrect
in most cases.
The trickle down effect of the bug fixes made to the
<code>File::findStartOfStatement()</code> method, is that the
Generic.WhiteSpace.ScopeIndent and the PEAR.WhiteSpace.ScopeIndent
sniffs should now be able to correctly determine and fix the indent for
match expressions containing nested expressions.
These fixes also fix an issue with the
<code>Squiz.Arrays.ArrayDeclaration</code> sniff and possibly other,
unreported bugs.
<ul>
<li>Thanks to [Juliette Reinders Folmer][<a
href="https://github.com/jrfnl"><code>@​jrfnl</code></a>] for the
patch</li>
</ul>
</li>
<li>Fixed bug <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/504">#504</a>:
The tokenizer could inadvertently mistake the last parameter in a
function call using named arguments for a DNF type.
<ul>
<li>Thanks to [Juliette Reinders Folmer][<a
href="https://github.com/jrfnl"><code>@​jrfnl</code></a>] for the
patch</li>
</ul>
</li>
<li>Fixed bug <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/508">#508</a>:
Tokenizer/PHP: extra hardening against handling parse errors in the type
handling layer.
<ul>
<li>Thanks to [Juliette Reinders Folmer][<a
href="https://github.com/jrfnl"><code>@​jrfnl</code></a>] for the
patch</li>
</ul>
</li>
</ul>
<p><a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/110">#110</a>:
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/110">PHPCSStandards/PHP_CodeSniffer#110</a>
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/437">#437</a>:
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/437">PHPCSStandards/PHP_CodeSniffer#437</a>
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/475">#475</a>:
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/475">PHPCSStandards/PHP_CodeSniffer#475</a>
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/504">#504</a>:
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/504">PHPCSStandards/PHP_CodeSniffer#504</a>
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/508">#508</a>:
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/pull/508">PHPCSStandards/PHP_CodeSniffer#508</a></p>
<h2>[3.10.0] - 2024-05-20</h2>
<h3>Added</h3>
<ul>
<li>Tokenizer support for PHP 8.2 Disjunctive Normal Form (DNF) types.
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/3731">#3731</a>[sq-3731],
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/387">#387</a>,
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/461">#461</a>
<ul>
<li>Includes new <code>T_TYPE_OPEN_PARENTHESIS</code> and
<code>T_TYPE_CLOSE_PARENTHESIS</code> tokens to represent the
parentheses in DNF types.</li>
<li>These new tokens, like other parentheses, will have the
<code>parenthesis_opener</code> and <code>parenthesis_closer</code>
token array indexes set and the tokens between them will have the
<code>nested_parenthesis</code> index.</li>
<li>The <code>File::getMethodProperties()</code>,
<code>File::getMethodParameters()</code> and
<code>File::getMemberProperties()</code> methods now all support DNF
types. <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/471">#471</a>,
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/472">#472</a>,
<a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/473">#473</a></li>
<li>Additionally, the following sniff has been updated to support DNF
types:
<ul>
<li>Generic.PHP.LowerCaseType <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/478">#478</a></li>
</ul>
</li>
<li>Thanks to [Juliette Reinders Folmer][<a
href="https://github.com/jrfnl"><code>@​jrfnl</code></a>] for the
patches.</li>
</ul>
</li>
<li>Documentation for the following sniffs:
<ul>
<li>Squiz.WhiteSpace.FunctionClosingBraceSpace</li>
<li>Thanks to [Przemek Hernik][<a
href="https://github.com/przemekhernik"><code>@​przemekhernik</code></a>]
for the patch.</li>
</ul>
</li>
</ul>
<h3>Changed</h3>
<ul>
<li>The help screens have received a face-lift for improved usability
and readability. <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/447">#447</a>
<ul>
<li>Thanks to [Juliette Reinders Folmer][<a
href="https://github.com/jrfnl"><code>@​jrfnl</code></a>] for the patch
and thanks to [Colin Stewart][<a
href="https://github.com/costdev"><code>@​costdev</code></a>], [Gary
Jones][<a
href="https://github.com/GaryJones"><code>@​GaryJones</code></a>] and
[<a href="https://github.com/mbomb007"><code>@​mbomb007</code></a>] for
reviewing.</li>
</ul>
</li>
<li>The Squiz.Commenting.ClosingDeclarationComment sniff will now also
examine and flag closing comments for traits. <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/442">#442</a>
<ul>
<li>Thanks to [Rodrigo Primo][<a
href="https://github.com/rodrigoprimo"><code>@​rodrigoprimo</code></a>]
for the patch.</li>
</ul>
</li>
<li>The following sniff(s) have efficiency improvements:</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/commit/8f90f7a53ce271935282967f53d0894f8f1ff877"><code>8f90f7a</code></a>
Merge pull request <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/510">#510</a>
from PHPCSStandards/feature/changelog-3.10.1</li>
<li><a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/commit/c9525a8ff970dca523a50f5ed41d98bfeb00122c"><code>c9525a8</code></a>
Changelog for the 3.10.1 release</li>
<li><a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/commit/3361ff206b08f27dd4a982bc4f43ace3c44fb177"><code>3361ff2</code></a>
Merge pull request <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/509">#509</a>
from PHPCSStandards/feature/file-findstartendofstatem...</li>
<li><a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/commit/fb351b35ee88f1c1c38eca37510d8eed0642ddd0"><code>fb351b3</code></a>
Merge pull request <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/508">#508</a>
from PHPCSStandards/feature/tokenizer-php-harden-the-...</li>
<li><a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/commit/a82f02e42fb5aad10bc6cdecbef00b9e07da5569"><code>a82f02e</code></a>
File::find[Start|End]OfStatement(): add QA tests</li>
<li><a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/commit/83373f9671b4ef777dcdc3f94845c108544ccc29"><code>83373f9</code></a>
File::findStartOfStatement(): fix some unintentional parse errors in the
test...</li>
<li><a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/commit/83afad8af3fb44309c41b2d30211a24c639ed62c"><code>83afad8</code></a>
Tokenizer/PHP: minor doc fix in type handling layer</li>
<li><a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/commit/87c393639ec69f2076dbb5edc7bacdc95a956f94"><code>87c3936</code></a>
Tokenizer/PHP: efficiency fix</li>
<li><a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/commit/07477a787434e39b8e4f5cac87ca66cdbec90407"><code>07477a7</code></a>
Tokenizer/PHP: don't retokenize tokens in a broken type DNF
declaration</li>
<li><a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/commit/cac90382a16016b546442e9bbcfedf91a3cc28a5"><code>cac9038</code></a>
Tokenizer/PHP: efficiency improvement for DNF type handling</li>
<li>Additional commits viewable in <a
href="https://github.com/PHPCSStandards/PHP_CodeSniffer/compare/3.9.2...3.10.1">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=squizlabs/php_codesniffer&package-manager=composer&previous-version=3.9.2&new-version=3.10.1)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

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-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

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 merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after
your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge
and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating
it. You can achieve the same result by closing it manually
- `@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)


</details>