Narrow return type and parameter type for wp_get_[inline_]script_tag

functionMap.php

@@ -135,12 +135,14 @@
     'wp_generate_tag_cloud' => ["(\$args is array{format: 'array'}&array ? array<int, string> : string)"],
     'wp_get_archives' => ['($args is array{echo: false|0}&array ? string|void : void)'],
     'wp_get_comment_status' => ["'approved'|'spam'|'trash'|'unapproved'|false"],
+    'wp_get_inline_script_tag' => ['non-falsy-string', 'attributes' => 'array<string, string|true>'],
     'wp_get_object_terms' => ["(\$object_ids is empty ? array{} : (\$taxonomies is empty ? array{} : ((\$args is array{fields: 'names'|'slugs'}&array ? list<string> : (\$args is array{fields: 'id=>name'|'id=>slug'}&array ? array<int, string> : (\$args is array{fields: 'id=>parent'}&array ? array<int, int> : (\$args is array{fields: 'ids'|'tt_ids'}&array ? list<int> : (\$args is array{fields: 'count'}&array ? numeric-string : array<int, \WP_Term>)))))|\WP_Error)))"],
     'wp_get_post_categories' => ["(\$post_id is 0 ? array{} : ((\$args is array{fields: 'names'|'slugs'}&array ? list<string> : (\$args is array{fields: 'id=>name'|'id=>slug'}&array ? array<int, string> : (\$args is array{fields: 'id=>parent'}&array ? array<int, int> : (\$args is array{fields: 'all'|'all_with_object_id'}&array ? array<int, \WP_Term> : (\$args is array{fields: 'count'}&array ? numeric-string : list<int>)))))|\WP_Error))"],
     'wp_get_post_tags' => ["(\$post_id is 0 ? array{} : ((\$args is array{fields: 'names'|'slugs'}&array ? list<string> : (\$args is array{fields: 'id=>name'|'id=>slug'}&array ? array<int, string> : (\$args is array{fields: 'id=>parent'}&array ? array<int, int> : (\$args is array{fields: 'ids'|'tt_ids'}&array ? list<int> : (\$args is array{fields: 'count'}&array ? numeric-string : array<int, \WP_Term>)))))|\WP_Error))"],
     'wp_get_post_terms' => ["(\$post_id is 0 ? array{} : (\$taxonomy is empty ? array{} : ((\$args is array{fields: 'names'|'slugs'}&array ? list<string> : (\$args is array{fields: 'id=>name'|'id=>slug'}&array ? array<int, string> : (\$args is array{fields: 'id=>parent'}&array ? array<int, int> : (\$args is array{fields: 'ids'|'tt_ids'}&array ? list<int> : (\$args is array{fields: 'count'}&array ? numeric-string : array<int, \WP_Term>)))))|\WP_Error)))"],
     'wp_get_schedule' => [null, 'args' => $cronArgsType],
     'wp_get_scheduled_event' => [null, 'args' => $cronArgsType],
+    'wp_get_script_tag' => ['non-falsy-string', 'attributes' => 'array<string, string|true>'],
     'wp_get_server_protocol' => ["'HTTP/1.0'|'HTTP/1.1'|'HTTP/2'|'HTTP/2.0'|'HTTP/3'"],
     'wp_insert_attachment' => ['($wp_error is false ? int<0, max> : int<1, max>|\WP_Error)'],
     'wp_insert_category' => ['($wp_error is false ? int<0, max> : int<1, max>|\WP_Error)'],

tests/TypeInferenceTest.php

@@ -69,6 +69,7 @@ public function dataFileAsserts(): iterable
         yield from $this->gatherAssertTypes(__DIR__ . '/data/wp_get_post_tags.php');
         yield from $this->gatherAssertTypes(__DIR__ . '/data/wp_get_post_terms.php');
         yield from $this->gatherAssertTypes(__DIR__ . '/data/wp_get_object_terms.php');
+        yield from $this->gatherAssertTypes(__DIR__ . '/data/wp_get_script_tag.php');
         yield from $this->gatherAssertTypes(__DIR__ . '/data/wp_get_server_protocol.php');
         yield from $this->gatherAssertTypes(__DIR__ . '/data/wp_is_numeric_array.php');
         yield from $this->gatherAssertTypes(__DIR__ . '/data/wp_list_bookmarks.php');

tests/data/wp_get_script_tag.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpStubs\WordPress\Core\Tests;
+
+use function wp_get_script_tag;
+use function wp_get_inline_script_tag;
+use function PHPStan\Testing\assertType;
+
+assertType('non-falsy-string', wp_get_script_tag([]));
+assertType('non-falsy-string', wp_get_script_tag(['key' => 'value']));
+assertType('non-falsy-string', wp_get_script_tag(Faker::strArray(Faker::string())));
+
+assertType('non-falsy-string', wp_get_inline_script_tag(Faker::string(), []));
+assertType('non-falsy-string', wp_get_inline_script_tag(Faker::string(), ['key' => 'value']));
+assertType('non-falsy-string', wp_get_inline_script_tag(Faker::string(), Faker::strArray(Faker::string())));

wordpress-stubs.php

@@ -137168,6 +137168,8 @@ function wp_sanitize_script_attributes($attributes)
      *
      * @param array $attributes Key-value pairs representing `<script>` tag attributes.
      * @return string String containing `<script>` opening and closing tags.
+     * @phpstan-param array<string, string|true> $attributes
+     * @phpstan-return non-falsy-string
      */
     function wp_get_script_tag($attributes)
     {
@@ -137196,6 +137198,8 @@ function wp_print_script_tag($attributes)
      * @param string $data       Data for script tag: JavaScript, importmap, speculationrules, etc.
      * @param array  $attributes Optional. Key-value pairs representing `<script>` tag attributes.
      * @return string String containing inline JavaScript code wrapped around `<script>` tag.
+     * @phpstan-param array<string, string|true> $attributes
+     * @phpstan-return non-falsy-string
      */
     function wp_get_inline_script_tag($data, $attributes = array())
     {