From b24a63f780e462ea67b315ed0c2fe35e063c3e04 Mon Sep 17 00:00:00 2001
From: Brent Wilson <brent@clariio.com>
Date: Tue, 26 Aug 2025 14:56:50 -0700
Subject: [PATCH 1/3] Docs: add documentation for WordPress.PHP.TypeCasts

---
 WordPress/Docs/PHP/TypeCastsStandard.xml | 56 ++++++++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 WordPress/Docs/PHP/TypeCastsStandard.xml

diff --git a/WordPress/Docs/PHP/TypeCastsStandard.xml b/WordPress/Docs/PHP/TypeCastsStandard.xml
new file mode 100644
index 0000000000..4ae707a604
--- /dev/null
+++ b/WordPress/Docs/PHP/TypeCastsStandard.xml
@@ -0,0 +1,56 @@
+<?xml version="1.0"?>
+<documentation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:noNamespaceSchemaLocation="https://phpcsstandards.github.io/PHPCSDevTools/phpcsdocs.xsd"
+    title="Type Casts"
+>
+    <standard>
+    <![CDATA[
+      Enforce normalized and safe type casts.
+
+      • Use (float) instead of legacy float casts.
+      • Do not use the (unset) cast. Use unset().
+      • Avoid the (binary) cast (discouraged).
+    ]]>
+    </standard>
+
+    <code_comparison>
+        <code title="Valid: Using normalized float casts.">
+        <![CDATA[
+$price = <em>(float)</em> $value;
+$size  = <em>(float)</em> $value;
+        ]]>
+        </code>
+        <code title="Invalid: Using legacy float casts.">
+        <![CDATA[
+$price = <em>(double)</em> $value;
+$size  = <em>(real)</em>   $value;
+        ]]>
+        </code>
+    </code_comparison>
+
+    <code_comparison>
+        <code title="Valid: Use unset().">
+        <![CDATA[
+unset( $value );
+        ]]>
+        </code>
+        <code title="Invalid: Using the (unset) cast.">
+        <![CDATA[
+result = <em>(unset)</em> $value;
+        ]]>
+        </code>
+    </code_comparison>
+
+    <code_comparison>
+        <code title="Valid: Prefer a clear alternative.">
+        <![CDATA[
+bytes = (string) $value;
+        ]]>
+        </code>
+        <code title="Invalid: Using the (binary) cast.">
+        <![CDATA[
+bytes = <em>(binary)</em> $value;
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>

From 31462c75adcad905d9628e4b48cb2f69ee7985f5 Mon Sep 17 00:00:00 2001
From: Rodrigo Primo <rodrigosprimo@gmail.com>
Date: Thu, 4 Jun 2026 12:07:20 +0000
Subject: [PATCH 2/3] Improve documentation for `WordPress.PHP.TypeCasts`

---
 WordPress/Docs/PHP/TypeCastsStandard.xml | 42 +++++++++++++-----------
 1 file changed, 23 insertions(+), 19 deletions(-)

diff --git a/WordPress/Docs/PHP/TypeCastsStandard.xml b/WordPress/Docs/PHP/TypeCastsStandard.xml
index 4ae707a604..84d8954fbb 100644
--- a/WordPress/Docs/PHP/TypeCastsStandard.xml
+++ b/WordPress/Docs/PHP/TypeCastsStandard.xml
@@ -2,54 +2,58 @@
 <documentation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:noNamespaceSchemaLocation="https://phpcsstandards.github.io/PHPCSDevTools/phpcsdocs.xsd"
     title="Type Casts"
->
+    >
     <standard>
     <![CDATA[
-      Enforce normalized and safe type casts.
-
-      • Use (float) instead of legacy float casts.
-      • Do not use the (unset) cast. Use unset().
-      • Avoid the (binary) cast (discouraged).
+    The (float) cast must be used instead of the (double) and (real) casts. The (real) cast was deprecated in PHP 7.4 and removed in PHP 8.0. The (double) cast was deprecated in PHP 8.5.
     ]]>
     </standard>
-
     <code_comparison>
-        <code title="Valid: Using normalized float casts.">
+        <code title="Valid: Using the normalized (float) cast.">
         <![CDATA[
 $price = <em>(float)</em> $value;
-$size  = <em>(float)</em> $value;
         ]]>
         </code>
         <code title="Invalid: Using legacy float casts.">
         <![CDATA[
 $price = <em>(double)</em> $value;
-$size  = <em>(real)</em>   $value;
+$size  = <em>(real)</em> $value;
         ]]>
         </code>
     </code_comparison>
-
+    <standard>
+    <![CDATA[
+    The (unset) cast must not be used. It was deprecated in PHP 7.2 and removed in PHP 8.0. Use unset() to unset a variable instead.
+    ]]>
+    </standard>
     <code_comparison>
-        <code title="Valid: Use unset().">
+        <code title="Valid: Using the unset() language construct.">
         <![CDATA[
-unset( $value );
+<em>unset</em>( $value );
         ]]>
         </code>
         <code title="Invalid: Using the (unset) cast.">
         <![CDATA[
-result = <em>(unset)</em> $value;
+$result = <em>(unset)</em> $value;
         ]]>
         </code>
     </code_comparison>
-
+    <standard>
+    <![CDATA[
+    Using the (binary) cast or the b prefix is discouraged. The (binary) cast was deprecated in PHP 8.5. Use the (string) cast or a regular string literal instead.
+    ]]>
+    </standard>
     <code_comparison>
-        <code title="Valid: Prefer a clear alternative.">
+        <code title="Valid: Using (string) and a string literal.">
         <![CDATA[
-bytes = (string) $value;
+$bytes = <em>(string)</em> $value;
+$text  = <em>'hello'</em>;
         ]]>
         </code>
-        <code title="Invalid: Using the (binary) cast.">
+        <code title="Invalid: Using (binary) and the b prefix.">
         <![CDATA[
-bytes = <em>(binary)</em> $value;
+$bytes = <em>(binary)</em> $value;
+$text  = <em>b</em>'hello';
         ]]>
         </code>
     </code_comparison>

From 5e8b4832372e61bcb7537dd672c60e599011fed3 Mon Sep 17 00:00:00 2001
From: Rodrigo Primo <rodrigosprimo@gmail.com>
Date: Tue, 23 Jun 2026 17:12:23 -0300
Subject: [PATCH 3/3] Apply suggestion from PR review

---
 WordPress/Docs/PHP/TypeCastsStandard.xml | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/WordPress/Docs/PHP/TypeCastsStandard.xml b/WordPress/Docs/PHP/TypeCastsStandard.xml
index 84d8954fbb..255fbacf4b 100644
--- a/WordPress/Docs/PHP/TypeCastsStandard.xml
+++ b/WordPress/Docs/PHP/TypeCastsStandard.xml
@@ -5,11 +5,11 @@
     >
     <standard>
     <![CDATA[
-    The (float) cast must be used instead of the (double) and (real) casts. The (real) cast was deprecated in PHP 7.4 and removed in PHP 8.0. The (double) cast was deprecated in PHP 8.5.
+    The float cast must be used instead of the double and real casts. The real cast was deprecated in PHP 7.4 and removed in PHP 8.0. The double cast was deprecated in PHP 8.5.
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: Using the normalized (float) cast.">
+        <code title="Valid: Using the normalized float cast.">
         <![CDATA[
 $price = <em>(float)</em> $value;
         ]]>
@@ -23,7 +23,7 @@ $size  = <em>(real)</em> $value;
     </code_comparison>
     <standard>
     <![CDATA[
-    The (unset) cast must not be used. It was deprecated in PHP 7.2 and removed in PHP 8.0. Use unset() to unset a variable instead.
+    The unset cast must not be used. It was deprecated in PHP 7.2 and removed in PHP 8.0. Use unset() to unset a variable instead.
     ]]>
     </standard>
     <code_comparison>
@@ -32,7 +32,7 @@ $size  = <em>(real)</em> $value;
 <em>unset</em>( $value );
         ]]>
         </code>
-        <code title="Invalid: Using the (unset) cast.">
+        <code title="Invalid: Using the unset cast.">
         <![CDATA[
 $result = <em>(unset)</em> $value;
         ]]>
@@ -40,17 +40,17 @@ $result = <em>(unset)</em> $value;
     </code_comparison>
     <standard>
     <![CDATA[
-    Using the (binary) cast or the b prefix is discouraged. The (binary) cast was deprecated in PHP 8.5. Use the (string) cast or a regular string literal instead.
+    Using the binary cast or the b prefix is discouraged. The binary cast was deprecated in PHP 8.5. Use the string cast or a regular string literal instead.
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: Using (string) and a string literal.">
+        <code title="Valid: Using the string cast and a string literal.">
         <![CDATA[
 $bytes = <em>(string)</em> $value;
 $text  = <em>'hello'</em>;
         ]]>
         </code>
-        <code title="Invalid: Using (binary) and the b prefix.">
+        <code title="Invalid: Using the binary cast and the b prefix.">
         <![CDATA[
 $bytes = <em>(binary)</em> $value;
 $text  = <em>b</em>'hello';