Update since n.e.x.t

Author: westonruter

plugins/auto-sizes/includes/auto-sizes.php

@@ -3,7 +3,7 @@
  * Functionality to implement auto-sizes for lazy loaded images.
  *
  * @package auto-sizes
- * @since n.e.x.t
+ * @since 1.4.0
  */
 
 /**

plugins/auto-sizes/includes/improve-calculate-sizes.php

@@ -3,13 +3,13 @@
  * Functionality to improve the calculation of image `sizes` attributes.
  *
  * @package auto-sizes
- * @since n.e.x.t
+ * @since 1.4.0
  */
 
 /**
  * Primes attachment into the cache with a single database query.
  *
- * @since n.e.x.t
+ * @since 1.4.0
  *
  * @param string|mixed $content The HTML content.
  * @return string The HTML content.
@@ -130,7 +130,7 @@ function auto_sizes_filter_image_tag( $content, array $parsed_block, WP_Block $b
 /**
  * Modifies the sizes attribute of an image based on layout context.
  *
- * @since n.e.x.t
+ * @since 1.4.0
  *
  * @param int                    $id            The image attachment post ID.
  * @param string|array{int, int} $size          Image size name or array of width and height.
@@ -228,7 +228,7 @@ function auto_sizes_calculate_better_sizes( int $id, $size, string $align, int $
 /**
  * Retrieves the layout width for an alignment defined in theme.json.
  *
- * @since n.e.x.t
+ * @since 1.4.0
  *
  * @param string $alignment The alignment value.
  * @return string The alignment width based.
@@ -248,7 +248,7 @@ function auto_sizes_get_layout_width( string $alignment ): string {
 /**
  * Filters the context keys that a block type uses.
  *
- * @since n.e.x.t
+ * @since 1.4.0
  *
  * @param string[]      $uses_context Array of registered uses context for a block type.
  * @param WP_Block_Type $block_type   The full block type object.
@@ -271,7 +271,7 @@ function auto_sizes_filter_uses_context( array $uses_context, WP_Block_Type $blo
 /**
  * Modifies the block context during rendering to blocks.
  *
- * @since n.e.x.t
+ * @since 1.4.0
  *
  * @param array<string, mixed> $context Current block context.
  * @param array<string, mixed> $block   The block being rendered.

plugins/dominant-color-images/hooks.php

@@ -194,7 +194,7 @@ function dominant_color_render_generator(): void {
  * to apply background color based on the dominant color for attachment previews
  * in the WordPress admin interface.
  *
- * @since n.e.x.t
+ * @since 1.2.0
  */
 function dominant_color_admin_inline_style(): void {
 	$handle = 'dominant-color-admin-styles';
@@ -213,7 +213,7 @@ function dominant_color_admin_inline_style(): void {
  * the attachment template. It adds attributes for dominant color and transparency
  * to the template, allowing these properties to be displayed in the media library.
  *
- * @since n.e.x.t
+ * @since 1.2.0
  * @see wp_print_media_templates()
  */
 function dominant_color_admin_script(): void {
@@ -249,7 +249,7 @@ function dominant_color_admin_script(): void {
  * the dominant color and transparency of the image. It modifies the response array to include
  * these additional properties, which can be used in the media library interface.
  *
- * @since n.e.x.t
+ * @since 1.2.0
  *
  * @param array<mixed>|mixed $response   The current response array for the attachment.
  * @param WP_Post            $attachment The attachment post object.

plugins/embed-optimizer/class-embed-optimizer-tag-visitor.php

@@ -81,7 +81,7 @@ private function is_embed_wrapper( OD_HTML_Tag_Processor $processor ): bool {
 	 * Otherwise, if the embed is not in any initial viewport, it will add lazy-loading logic.
 	 *
 	 * @since 0.2.0
-	 * @since n.e.x.t Adds preconnect links for each viewport group and skips if the element is not in the viewport for that group.
+	 * @since 0.4.0 Adds preconnect links for each viewport group and skips if the element is not in the viewport for that group.
 	 *
 	 * @param OD_Tag_Visitor_Context $context Tag visitor context.
 	 * @return bool Whether the tag should be tracked in URL Metrics.

plugins/embed-optimizer/hooks.php

@@ -428,7 +428,7 @@ function embed_optimizer_render_generator(): void {
 /**
  * Gets the path to a script or stylesheet.
  *
- * @since n.e.x.t
+ * @since 0.4.0
  *
  * @param string      $src_path Source path, relative to plugin root.
  * @param string|null $min_path Minified path. If not supplied, then '.min' is injected before the file extension in the source path.

plugins/image-prioritizer/class-image-prioritizer-background-image-styled-tag-visitor.php

@@ -29,23 +29,23 @@ final class Image_Prioritizer_Background_Image_Styled_Tag_Visitor extends Image_
 	/**
 	 * Class name used to indicate a background image which is lazy-loaded.
 	 *
-	 * @since n.e.x.t
+	 * @since 0.3.0
 	 * @var string
 	 */
 	const LAZY_BG_IMAGE_CLASS_NAME = 'od-lazy-bg-image';
 
 	/**
 	 * Whether the lazy-loading script and stylesheet have been added.
 	 *
-	 * @since n.e.x.t
+	 * @since 0.3.0
 	 * @var bool
 	 */
 	private $added_lazy_assets = false;
 
 	/**
 	 * Tuples of URL Metric group and the common LCP element external background image.
 	 *
-	 * @since n.e.x.t
+	 * @since 0.3.0
 	 * @var array<array{OD_URL_Metric_Group, LcpElementExternalBackgroundImage}>
 	 */
 	private $group_common_lcp_element_external_background_images;
@@ -99,7 +99,7 @@ public function __invoke( OD_Tag_Visitor_Context $context ): bool {
 	/**
 	 * Gets the common LCP element external background image for a URL Metric group.
 	 *
-	 * @since n.e.x.t
+	 * @since 0.3.0
 	 *
 	 * @param OD_URL_Metric_Group $group Group.
 	 * @return LcpElementExternalBackgroundImage|null
@@ -135,7 +135,7 @@ private function get_common_lcp_element_external_background_image( OD_URL_Metric
 	/**
 	 * Maybe preloads external background image.
 	 *
-	 * @since n.e.x.t
+	 * @since 0.3.0
 	 *
 	 * @param OD_Tag_Visitor_Context $context Context.
 	 */
@@ -182,7 +182,7 @@ private function maybe_preload_external_lcp_background_image( OD_Tag_Visitor_Con
 	/**
 	 * Adds an image preload link for the group.
 	 *
-	 * @since n.e.x.t
+	 * @since 0.3.0
 	 *
 	 * @param OD_Link_Collection  $link_collection Link collection.
 	 * @param OD_URL_Metric_Group $group           URL Metric group.
@@ -205,7 +205,7 @@ private function add_image_preload_link( OD_Link_Collection $link_collection, OD
 	/**
 	 * Optimizes an element with a background image based on whether it is displayed in any initial viewport.
 	 *
-	 * @since n.e.x.t
+	 * @since 0.3.0
 	 *
 	 * @param OD_Tag_Visitor_Context $context Tag visitor context, with the cursor currently at block with a background image.
 	 */

plugins/image-prioritizer/class-image-prioritizer-img-tag-visitor.php

@@ -25,7 +25,7 @@ final class Image_Prioritizer_Img_Tag_Visitor extends Image_Prioritizer_Tag_Visi
 	 * Visits a tag.
 	 *
 	 * @since 0.1.0
-	 * @since n.e.x.t Separate the processing of IMG and PICTURE elements.
+	 * @since 0.3.0 Separate the processing of IMG and PICTURE elements.
 	 *
 	 * @param OD_Tag_Visitor_Context $context Tag visitor context.
 	 * @return bool Whether the tag should be tracked in URL Metrics.
@@ -46,7 +46,7 @@ public function __invoke( OD_Tag_Visitor_Context $context ): bool {
 	/**
 	 * Process an IMG element.
 	 *
-	 * @since n.e.x.t
+	 * @since 0.3.0
 	 *
 	 * @param OD_HTML_Tag_Processor  $processor HTML tag processor.
 	 * @param OD_Tag_Visitor_Context $context   Tag visitor context.
@@ -183,7 +183,7 @@ private function process_img( OD_HTML_Tag_Processor $processor, OD_Tag_Visitor_C
 	/**
 	 * Process a PICTURE element.
 	 *
-	 * @since n.e.x.t
+	 * @since 0.3.0
 	 *
 	 * @param OD_HTML_Tag_Processor  $processor HTML tag processor.
 	 * @param OD_Tag_Visitor_Context $context   Tag visitor context.
@@ -283,7 +283,7 @@ private function process_picture( OD_HTML_Tag_Processor $processor, OD_Tag_Visit
 	 * Returns null if the src attribute is not a string (i.e. src was used as a boolean attribute was used), if it
 	 * it has an empty string value after trimming, or if it is a data: URL.
 	 *
-	 * @since n.e.x.t
+	 * @since 0.3.0
 	 *
 	 * @param OD_HTML_Tag_Processor $processor      Processor.
 	 * @param 'src'|'srcset'        $attribute_name Attribute name.
@@ -304,7 +304,7 @@ private function get_valid_src( OD_HTML_Tag_Processor $processor, string $attrib
 	/**
 	 * Adds a LINK with the supplied attributes for each viewport group when the provided XPath is the LCP element.
 	 *
-	 * @since n.e.x.t
+	 * @since 0.3.0
 	 *
 	 * @param OD_Tag_Visitor_Context          $context    Tag visitor context.
 	 * @param string                          $xpath      XPath of the element.
@@ -351,7 +351,7 @@ static function ( $attribute_value ) {
 	/**
 	 * Gets the parent tag name.
 	 *
-	 * @since n.e.x.t
+	 * @since 0.3.0
 	 *
 	 * @param OD_Tag_Visitor_Context $context Tag visitor context.
 	 * @return string|null The parent tag name or null if not found.

plugins/image-prioritizer/detect.js

@@ -34,7 +34,7 @@ const externalBackgroundImages = [];
 /**
  * Logs a message.
  *
- * @since n.e.x.t
+ * @since 0.3.0
  *
  * @param {...*} message
  */
@@ -46,7 +46,7 @@ function log( ...message ) {
 /**
  * Logs a warning.
  *
- * @since n.e.x.t
+ * @since 0.3.0
  *
  * @param {...*} message
  */
@@ -58,7 +58,7 @@ function warn( ...message ) {
 /**
  * Initializes extension.
  *
- * @since n.e.x.t
+ * @since 0.3.0
  *
  * @type {InitializeCallback}
  * @param {InitializeArgs} args Args.
@@ -80,7 +80,7 @@ export async function initialize( { isDebug, onLCP } ) {
 /**
  * Gets the performance resource entry for a given URL.
  *
- * @since n.e.x.t
+ * @since 0.3.0
  *
  * @param {string} url - Resource URL.
  * @return {PerformanceResourceTiming|null} Resource entry or null.
@@ -101,7 +101,7 @@ function getPerformanceResourceByURL( url ) {
 /**
  * Handles a new LCP metric being reported.
  *
- * @since n.e.x.t
+ * @since 0.3.0
  *
  * @param {LCPMetric} metric  - LCP Metric.
  * @param {boolean}   isDebug - Whether in debug mode.
@@ -203,7 +203,7 @@ function handleLCPMetric( metric, isDebug ) {
 /**
  * Finalizes extension.
  *
- * @since n.e.x.t
+ * @since 0.3.0
  *
  * @type {FinalizeCallback}
  * @param {FinalizeArgs} args Args.

plugins/image-prioritizer/helper.php

@@ -83,7 +83,7 @@ function image_prioritizer_register_tag_visitors( OD_Tag_Visitor_Registry $regis
 /**
  * Filters the list of Optimization Detective extension module URLs to include the extension for Image Prioritizer.
  *
- * @since n.e.x.t
+ * @since 0.3.0
  * @access private
  *
  * @param string[]|mixed $extension_module_urls Extension module URLs.
@@ -100,7 +100,7 @@ function image_prioritizer_filter_extension_module_urls( $extension_module_urls
 /**
  * Filters additional properties for the element item schema for Optimization Detective.
  *
- * @since n.e.x.t
+ * @since 0.3.0
  * @access private
  *
  * @param array<string, array{type: string}> $additional_properties Additional properties.
@@ -145,7 +145,7 @@ function image_prioritizer_add_element_item_schema_properties( array $additional
 /**
  * Validates URL for a background image.
  *
- * @since n.e.x.t
+ * @since 0.3.0
  * @access private
  *
  * @param string $url Background image URL.
@@ -271,7 +271,7 @@ static function ( $host ) {
  * potentially no URL Metrics would ever be collected if, for example, the background image URL is pointing to a
  * disallowed origin. Then none of the other optimizations would be able to be applied.
  *
- * @since n.e.x.t
+ * @since 0.3.0
  * @access private
  *
  * @phpstan-param WP_REST_Request<array<string, mixed>> $request
@@ -322,7 +322,7 @@ function image_prioritizer_filter_rest_request_before_callbacks( $response, arra
 /**
  * Gets the path to a script or stylesheet.
  *
- * @since n.e.x.t
+ * @since 0.3.0
  * @access private
  *
  * @param string      $src_path Source path, relative to plugin root.
@@ -384,7 +384,7 @@ function image_prioritizer_get_video_lazy_load_script(): string {
  *
  * Load the background image when it approaches the viewport using an IntersectionObserver.
  *
- * @since n.e.x.t
+ * @since 0.3.0
  * @access private
  *
  * @return string Lazy load script.
@@ -397,7 +397,7 @@ function image_prioritizer_get_lazy_load_bg_image_script(): string {
 /**
  * Gets the stylesheet to lazy-load background images.
  *
- * @since n.e.x.t
+ * @since 0.3.0
  * @access private
  *
  * @return string Lazy load stylesheet.

plugins/optimization-detective/class-od-html-tag-processor.php

@@ -497,7 +497,7 @@ public function release_bookmark( $name ): bool {
 	 * A breadcrumb consists of a tag name and its sibling index.
 	 *
 	 * @since 0.4.0
-	 * @since n.e.x.t Renamed from get_breadcrumbs() to get_indexed_breadcrumbs().
+	 * @since 0.9.0 Renamed from get_breadcrumbs() to get_indexed_breadcrumbs().
 	 *
 	 * @return Generator<array{string, int}> Breadcrumb.
 	 */
@@ -513,7 +513,7 @@ private function get_indexed_breadcrumbs(): Generator {
 	 * Breadcrumbs start at the outermost parent and descend toward the matched element.
 	 * They always include the entire path from the root HTML node to the matched element.
 	 *
-	 * @since n.e.x.t
+	 * @since 0.9.0
 	 * @see WP_HTML_Processor::get_breadcrumbs()
 	 *
 	 * @return string[] Array of tag names representing path to matched node.