Narrow parameter type for register_post_type (#380)

Author: IanDelMar

functionMap.php

@@ -126,6 +126,7 @@
     'previous_posts' => ['($display is true ? void : string)'],
     'rawurlencode_deep' => ['T', '@phpstan-template' => 'T', 'value' => 'T'],
     'register_nav_menus' => [null, 'locations' => 'array<string, string>'],
+    'register_post_type' => [null, 'post_type' => 'lowercase-string&non-empty-string'],
     'render_block_core_categories' => ['non-falsy-string'],
     'rest_authorization_required_code' => ['401|403'],
     'rest_sanitize_boolean' => ["(T is bool ? T : (T is ''|'false'|'FALSE'|'0'|0 ? false : true))", '@phpstan-template T' => 'of bool|string|int', 'value' => 'T'],

tests/ParameterTypeTest.php

@@ -117,6 +117,22 @@ public function testRegisterNavMenus(): void
         );
     }
 
+    public function testRegisterPostType(): void
+    {
+        $this->analyse(
+            __DIR__ . '/data/param/register-post-type.php',
+            [
+                ["Parameter #1 \$post_type of function register_post_type expects lowercase-string&non-empty-string, '' given.", 13],
+                ["Parameter #1 \$post_type of function register_post_type expects lowercase-string&non-empty-string, 'PostType' given.", 14],
+                // Maybes
+                ['Parameter #1 $post_type of function register_post_type expects lowercase-string&non-empty-string, non-empty-string given.', 17],
+                ['Parameter #1 $post_type of function register_post_type expects lowercase-string&non-empty-string, non-falsy-string given.', 18],
+                ['Parameter #1 $post_type of function register_post_type expects lowercase-string&non-empty-string, lowercase-string given.', 19],
+                ['Parameter #1 $post_type of function register_post_type expects lowercase-string&non-empty-string, string given.', 20],
+            ]
+        );
+    }
+
     public function testWpdbGetRow(): void
     {
         $this->analyse(

tests/data/param/register-post-type.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpStubs\WordPress\Core\Tests;
+
+use function register_post_type;
+
+$empty = '';
+$containsUppercases = 'PostType';
+
+// Incorrect $post_type
+register_post_type($empty, Faker::array());
+register_post_type($containsUppercases, Faker::array());
+
+// Maybe incorrect $post_type
+register_post_type(Faker::nonEmptyString(), Faker::array());
+register_post_type(Faker::nonFalsyString(), Faker::array());
+register_post_type(Faker::lowercaseString(), Faker::array());
+register_post_type(Faker::string(), Faker::array());
+
+// Correct $post_type
+register_post_type('post_type', Faker::array());
+register_post_type(Faker::intersection(Faker::lowercaseString(), Faker::nonEmptyString()), Faker::array());

wordpress-stubs.php

@@ -131627,6 +131627,7 @@ function get_post_types($args = array(), $output = 'names', $operator = 'and')
      *   _builtin?: bool,
      *   _edit_link?: string,
      * } $args
+     * @phpstan-param lowercase-string&non-empty-string $post_type
      */
     function register_post_type($post_type, $args = array())
     {