Mirror package @woocommerce/email-editor-config from WooCommerce

Upstream-Ref: woocommerce/woocommerce@50ae0ef

Author: allilevine

changelog.md

@@ -2,6 +2,10 @@
 
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.8.1](https://github.com/woocommerce/email-editor/releases/tag/2.8.1) - 2026-02-20 
+
+-   Patch - Fix unbounded static cache memory leaks in vendor-prefixed CSS inlining dependencies (emogrifier and symfony/css-selector) for long-running processes. [#63365]
+
 ## [2.8.0](https://github.com/woocommerce/email-editor/releases/tag/2.8.0) - 2026-02-17 
 
 -   Minor - Fix spacing issues in email editor product collection rendering. [#63177]

composer.json

@@ -5,7 +5,7 @@
 	"license": "GPL-2.0-or-later",
 	"prefer-stable": true,
 	"minimum-stability": "dev",
-	"version": "2.8.0",
+	"version": "2.8.1",
 	"autoload": {
 		"classmap": [
 			"src/",

vendor-prefixed/packages/Pelago/Emogrifier/CssInliner.php

@@ -389,6 +389,7 @@ private function clearAllCaches(): void
             self::CACHE_KEY_SELECTOR => [],
             self::CACHE_KEY_COMBINED_STYLES => [],
         ];
+        DeclarationBlockParser::clearCache();
     }
 
     /**

vendor-prefixed/packages/Pelago/Emogrifier/Utilities/DeclarationBlockParser.php

@@ -19,6 +19,17 @@ final class DeclarationBlockParser
      */
     private static $cache = [];
 
+    /**
+     * Clears the static declaration block cache.
+     *
+     * This should be called between processing separate HTML documents to prevent
+     * unbounded memory growth in long-running processes.
+     */
+    public static function clearCache(): void
+    {
+        self::$cache = [];
+    }
+
     /**
      * CSS custom properties (variables) have case-sensitive names, so their case must be preserved.
      * Standard CSS properties have case-insensitive names, which are converted to lowercase.

vendor-prefixed/packages/Symfony/Component/CssSelector/CssSelectorConverter.php

@@ -29,6 +29,13 @@ class CssSelectorConverter
     private $translator;
     private $cache;
 
+    /**
+     * Maximum number of cached items per prefix before LRU eviction kicks in.
+     *
+     * @var int
+     */
+    public static $maxCachedItems = 200;
+
     private static $xmlCache = [];
     private static $htmlCache = [];
 
@@ -64,6 +71,21 @@ public function __construct(bool $html = true)
      */
     public function toXPath(string $cssExpr, string $prefix = 'descendant-or-self::')
     {
-        return $this->cache[$prefix][$cssExpr] ?? $this->cache[$prefix][$cssExpr] = $this->translator->cssToXPath($cssExpr, $prefix);
+        if (isset($this->cache[$prefix][$cssExpr])) {
+            // Promote to most-recently-used position.
+            $value = $this->cache[$prefix][$cssExpr];
+            unset($this->cache[$prefix][$cssExpr]);
+
+            return $this->cache[$prefix][$cssExpr] = $value;
+        }
+
+        $value = $this->translator->cssToXPath($cssExpr, $prefix);
+
+        if (\count($this->cache[$prefix] ?? []) >= self::$maxCachedItems) {
+            // Evict least-recently-used entry.
+            unset($this->cache[$prefix][\array_key_first($this->cache[$prefix])]);
+        }
+
+        return $this->cache[$prefix][$cssExpr] = $value;
     }
 }