WP_Theme get_post_templates incorrect @return docblock line?

[salvatore.formisano]

As per title, the get_post_templates method of the WP_Theme class seems to have an incorrect @return docblock value. The @return type is set to string, but the method returns an array of the templates, and even the @return description literally says Array of page templates, keyed by filename and post type.

You can see this on line 1190 of class-wp-theme.php.

I noticed this because a plugin I am building calls this method and the IDE gave me a squiggly line when I worked with the method's output assuming it's an array.

[SergeyBiryukov]

Hi there, welcome to WordPress Trac! Thanks for the report.

Good catch, this appears to be a typo in [46661], which intended to switch the array to a more specific string[], but accidentally used string instead.

[mayankmajeji]

Typo error corrected in class-wp-theme.php

[SergeyBiryukov]

In 47631:

Docs: Correct @return type for WP_Theme::get_post_templates().

The method returns an array of strings, not a single string.

Props mayankmajeji, salvatore.formisano.
Fixes #50020.