Merge branch 'develop' into add/post-url-filter

Author: acicovic

CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.19.2](https://github.com/Parsely/wp-parsely/compare/3.19.1...3.19.2) - 2025-05-29
+
+### Fixed
+
+- add_parsely_preview_wrapper(): Allow mixed type values ([#3389](https://github.com/Parsely/wp-parsely/pull/3389))
+
+### Dependency Updates
+
+- The list of all dependency updates for this release is available [here](https://github.com/Parsely/wp-parsely/pulls?q=is%3Apr+is%3Amerged+milestone%3A3.19.2+label%3ADeps).
+
 ## [3.19.1](https://github.com/Parsely/wp-parsely/compare/3.19.0...3.19.1) - 2025-05-21
 
 ### Fixed

README.md

@@ -1,6 +1,6 @@
 # Parse.ly
 
-Stable tag: 3.19.1  
+Stable tag: 3.19.2  
 Requires at least: 6.0  
 Tested up to: 6.8  
 Requires PHP: 7.2  

package-lock.json

@@ -1,6 +1,6 @@
 {
 	"name": "wp-parsely",
-	"version": "3.19.1",
+	"version": "3.19.2",
 	"private": true,
 	"description": "The Parse.ly plugin facilitates real-time and historical analytics to your content through a platform designed and built for digital publishing.",
 	"author": "parsely, hbbtstar, jblz, mikeyarce, GaryJ, parsely_mike, acicovic, mehmoodak, vaurdan",
@@ -77,7 +77,7 @@
 		"@wordpress/url": "^4.24.0",
 		"@wordpress/wordcount": "^4.24.0",
 		"concurrently": "^9.1.2",
-		"eslint-plugin-jest": "^28.11.1",
+		"eslint-plugin-jest": "^28.12.0",
 		"husky": "^9.1.7",
 		"lodash.debounce": "^4.0.8",
 		"prettier": "^3.5.3",

package.json

@@ -13,7 +13,7 @@ parameters:
     - vendor/php-stubs/wordpress-stubs/wordpress-stubs.php
     - vendor/php-stubs/wordpress-tests-stubs/wordpress-tests-stubs.php
   type_coverage:
-      return_type: 87.7
+      return_type: 87.6
       param_type: 79.1
       property_type: 0 # We can't use property types until PHP 7.4 becomes the plugin's minimum version.
       print_suggestions: false

phpstan.neon

@@ -118,10 +118,17 @@ public function handle_preview_template(): void {
 	 *
 	 * @since 3.19.0
 	 *
-	 * @param string $content The post content.
-	 * @return string The modified content with wrapper div if needed.
+	 * @param mixed $content The post content.
+	 * @return mixed The modified content with wrapper div if needed, or the
+	 *               unmodified content value in case of a non-string.
 	 */
-	public function add_parsely_preview_wrapper( string $content ): string {
+	public function add_parsely_preview_wrapper( $content ) {
+		if ( ! is_string( $content ) ) {
+			// $content should always be a string, but is filterable by `the_content`.
+			// If we get a non-string value, return it as is to avoid fatal errors.
+			return $content;
+		}
+
 		if ( ! isset( $_GET['parsely_preview'] ) || 'true' !== $_GET['parsely_preview'] ) {
 			return $content;
 		}

src/UI/class-dashboard-page.php

@@ -31,7 +31,7 @@ import { SinglePostRow } from './components/single-post-row';
  *
  * @since 3.19.0
  *
- * @param {Object}   props                The component props.
+ * @param {Object}   props                The component's props.
  * @param {boolean}  props.isLoading      Whether the posts are loading.
  * @param {number}   props.currentPage    The current page.
  * @param {Function} props.setCurrentPage The function to set the current page.
@@ -113,7 +113,7 @@ type PostsTableType = {
  *
  * @since 3.19.0
  *
- * @param {PostsTableType} props The component props.
+ * @param {PostsTableType} props The component's props.
  */
 export const PostsTable = ( {
 	query = {},

src/content-helper/dashboard-page/components/posts-table/component.tsx

@@ -26,7 +26,7 @@ type PostDetailsProps = {
  *
  * @since 3.19.0
  *
- * @param {PostDetailsProps} props The component props.
+ * @param {PostDetailsProps} props The component's props.
  */
 export const PostDetails = ( { post }: PostDetailsProps ): React.JSX.Element => {
 	const prettyDate = post.date ? getSmartShortDate( new Date( post.date ) ) : '';

src/content-helper/dashboard-page/components/posts-table/components/post-details.tsx

@@ -22,7 +22,7 @@ export type DashboardHeadingProps = {
  *
  * @since 3.19.0
  *
- * @param {DashboardHeadingProps} props The component props.
+ * @param {DashboardHeadingProps} props The component's props.
  */
 export const DashboardHeading = ( { children, ...props }: DashboardHeadingProps ) => {
 	return (

src/content-helper/dashboard-page/components/typography-components.tsx

@@ -3,9 +3,9 @@
  */
 // eslint-disable-next-line import/named
 import { BlockInstance } from '@wordpress/blocks';
-import { useEffect, useRef } from '@wordpress/element';
-import { useSelect } from '@wordpress/data';
 import { debounce } from '@wordpress/compose';
+import { useSelect } from '@wordpress/data';
+import { useEffect, useRef } from '@wordpress/element';
 
 /**
  * Internal dependencies
@@ -123,7 +123,7 @@ type LinkMonitorProps = {
  *
  * @since 3.16.0
  *
- * @param {LinkMonitorProps} props The component props.
+ * @param {LinkMonitorProps} props The component's props.
  */
 export const LinkMonitor = ( {
 	isDetectingEnabled,