@automattic/i18n-check-webpack-plugin 1.1.21 → 1.1.22

package/CHANGELOG.md

@@ -5,6 +5,10 @@ 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).
 
+## [1.1.22] - 2025-06-18
+### Added
+- Add a link to the "Known problematic code patterns" documentation in relevant error messages. [#43974]
+
 ## [1.1.21] - 2025-06-03
 ### Changed
 - Update package dependencies. [#43734]
@@ -261,6 +265,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - Initial release.
 
+[1.1.22]: https://github.com/Automattic/i18n-check-webpack-plugin/compare/v1.1.21...v1.1.22
 [1.1.21]: https://github.com/Automattic/i18n-check-webpack-plugin/compare/v1.1.20...v1.1.21
 [1.1.20]: https://github.com/Automattic/i18n-check-webpack-plugin/compare/v1.1.19...v1.1.20
 [1.1.19]: https://github.com/Automattic/i18n-check-webpack-plugin/compare/v1.1.18...v1.1.19

package/README.md

@@ -132,6 +132,7 @@ example = flag ? __( 'Flag is set', 'domain' ) : _x( 'Flag is not set', '', 'dom
 ```js
 example = flag ? _x( 'Flag is set', 'Something', 'domain' ) : _x( 'Flag is not set', 'Something different', 'domain' );
 ```
+Note that, as far as `wp i18n` is concerned, `__( 'Something', 'domain' )` and `_x( 'Something', '', 'domain' )` are the same message.
 
 ### Pruned branches and common strings
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@automattic/i18n-check-webpack-plugin",
-	"version": "1.1.21",
+	"version": "1.1.22",
 	"description": "A Webpack plugin to check that WordPress i18n hasn't been mangled by Webpack optimizations.",
 	"homepage": "https://github.com/Automattic/jetpack/tree/HEAD/projects/js-packages/i18n-check-webpack-plugin/#readme",
 	"bugs": {
@@ -31,7 +31,7 @@
 	"devDependencies": {
 		"@automattic/jetpack-webpack-config": "workspace:*",
 		"@babel/core": "7.27.4",
-		"jest": "29.7.0",
+		"jest": "30.0.0",
 		"webpack": "5.94.0",
 		"webpack-cli": "6.0.1"
 	},

package/src/I18nCheckPlugin.js

@@ -280,7 +280,8 @@ class I18nCheckPlugin {
 					compilation[ this.#reportkey ].push(
 						new Error(
 							// prettier-ignore
-							`${ filename }: Translator comments have gone missing for ${ str }\n - ` + missingComments.join( '\n - ' )
+							`${ filename }: Translator comments have gone missing for ${ str }\n - ` + missingComments.join( '\n - ' ) +
+							'\nSee https://github.com/Automattic/i18n-check-webpack-plugin?tab=readme-ov-file#known-problematic-code-patterns for common causes and fixes.'
 						)
 					);
 				}
@@ -329,7 +330,8 @@ class I18nCheckPlugin {
 				compilation[ this.#reportkey ].push(
 					new Error(
 						`${ filename }: Optimization seems to have broken the following translation strings:\n - ` +
-							Array.from( foundEntries.values(), this.#strentry ).sort().join( '\n - ' )
+							Array.from( foundEntries.values(), this.#strentry ).sort().join( '\n - ' ) +
+							'\nSee https://github.com/Automattic/i18n-check-webpack-plugin?tab=readme-ov-file#known-problematic-code-patterns for common causes and fixes.'
 					)
 				);
 			}