Narrow return type of get_post_ancestors (#379)

Author: IanDelMar

functionMap.php

@@ -86,6 +86,7 @@
     'get_password_reset_key' => [null, '@phpstan-impure' => ''],
     'get_permalink' => ['($post is \WP_Post ? string : string|false)'],
     'get_post' => ["(\$post is \WP_Post ? array<array-key, mixed>|\WP_Post : array<array-key, mixed>|\WP_Post|null) & (\$output is 'ARRAY_A' ? array<string, mixed>|null : (\$output is 'ARRAY_N' ? array<int, mixed>|null : \WP_Post|null))", 'output' => "'OBJECT'|'ARRAY_A'|'ARRAY_N'" ],
+    'get_post_ancestors' => ['list<int>'],
     'get_post_permalink' => ['($post is \WP_Post ? string : string|false)'],
     'get_post_stati' => ["(\$output is 'names' ? array<string, string> : array<string, \stdClass>)"],
     'get_post_types' => ["(\$output is 'names' ? array<string, string> : array<string, \WP_Post_Type>)"],

tests/data/return/get-post-ancestors.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpStubs\WordPress\Core\Tests;
+
+use function get_post_ancestors;
+use function PHPStan\Testing\assertType;
+
+assertType('list<int>', get_post_ancestors(123));
+assertType('list<int>', get_post_ancestors(Faker::int()));
+assertType('list<int>', get_post_ancestors(Faker::wpPost()));

wordpress-stubs.php

@@ -131144,6 +131144,7 @@ function get_post($post = \null, $output = \OBJECT, $filter = 'raw')
      *
      * @param int|WP_Post $post Post ID or post object.
      * @return int[] Array of ancestor IDs or empty array if there are none.
+     * @phpstan-return list<int>
      */
     function get_post_ancestors($post)
     {