Merge branch 'main' into chore/deprecate-intl-wrappers

Author: yslpn

CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.7.0](https://github.com/lingui/js-lingui/compare/v5.6.1...v5.7.0) (2025-12-12)
+
+### Bug Fixes
+
+* **cli:** allow using PO formatter function with Translation.IO ([#2375](https://github.com/lingui/js-lingui/issues/2375)) ([f8b90e2](https://github.com/lingui/js-lingui/commit/f8b90e2ff05657b2af17568cb8c8279eb9484719))
+* Gettext formatter merges duplicate plural entries ([#2347](https://github.com/lingui/js-lingui/issues/2347)) ([d72b23f](https://github.com/lingui/js-lingui/commit/d72b23f38f3dcffb5809964aaeb07cfcfaa8ec48))
+
+### Features
+
+* **cli:** add --output-prefix option to customize compiled file headers ([#2377](https://github.com/lingui/js-lingui/issues/2377)) ([ef77310](https://github.com/lingui/js-lingui/commit/ef77310e1ec664f8c059bc16179c169c818f1801))
+
 ## [5.6.1](https://github.com/lingui/js-lingui/compare/v5.6.0...v5.6.1) (2025-11-28)
 
 ### Bug Fixes

lerna.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.6.1",
+  "version": "5.7.0",
   "packages": ["packages/*"],
   "npmClient": "yarn",
   "command": {

packages/babel-plugin-extract-messages/CHANGELOG.md

@@ -3,6 +3,10 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.7.0](https://github.com/lingui/js-lingui/compare/v5.6.1...v5.7.0) (2025-12-12)
+
+**Note:** Version bump only for package @lingui/babel-plugin-extract-messages
+
 ## [5.6.1](https://github.com/lingui/js-lingui/compare/v5.6.0...v5.6.1) (2025-11-28)
 
 **Note:** Version bump only for package @lingui/babel-plugin-extract-messages

packages/babel-plugin-extract-messages/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingui/babel-plugin-extract-messages",
-  "version": "5.6.1",
+  "version": "5.7.0",
   "description": "Babel plugin for collecting messages from source code for internationalization",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",

packages/babel-plugin-lingui-macro/CHANGELOG.md

@@ -3,6 +3,10 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.7.0](https://github.com/lingui/js-lingui/compare/v5.6.1...v5.7.0) (2025-12-12)
+
+**Note:** Version bump only for package @lingui/babel-plugin-lingui-macro
+
 ## [5.6.1](https://github.com/lingui/js-lingui/compare/v5.6.0...v5.6.1) (2025-11-28)
 
 ### Bug Fixes

packages/babel-plugin-lingui-macro/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingui/babel-plugin-lingui-macro",
-  "version": "5.6.1",
+  "version": "5.7.0",
   "description": "Babel plugin for transforming Lingui Macros",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -86,9 +86,9 @@
     "@babel/core": "^7.20.12",
     "@babel/runtime": "^7.20.13",
     "@babel/types": "^7.20.7",
-    "@lingui/conf": "5.6.1",
-    "@lingui/core": "5.6.1",
-    "@lingui/message-utils": "5.6.1"
+    "@lingui/conf": "5.7.0",
+    "@lingui/core": "5.7.0",
+    "@lingui/message-utils": "5.7.0"
   },
   "peerDependencies": {
     "babel-plugin-macros": "2 || 3"

packages/cli/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.7.0](https://github.com/lingui/js-lingui/compare/v5.6.1...v5.7.0) (2025-12-12)
+
+### Bug Fixes
+
+* **cli:** allow using PO formatter function with Translation.IO ([#2375](https://github.com/lingui/js-lingui/issues/2375)) ([f8b90e2](https://github.com/lingui/js-lingui/commit/f8b90e2ff05657b2af17568cb8c8279eb9484719))
+
+### Features
+
+* **cli:** add --output-prefix option to customize compiled file headers ([#2377](https://github.com/lingui/js-lingui/issues/2377)) ([ef77310](https://github.com/lingui/js-lingui/commit/ef77310e1ec664f8c059bc16179c169c818f1801))
+
 ## [5.6.1](https://github.com/lingui/js-lingui/compare/v5.6.0...v5.6.1) (2025-11-28)
 
 **Note:** Version bump only for package @lingui/cli

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingui/cli",
-  "version": "5.6.1",
+  "version": "5.7.0",
   "description": "CLI for working wit message catalogs",
   "keywords": [
     "cli",
@@ -62,12 +62,12 @@
     "@babel/parser": "^7.22.0",
     "@babel/runtime": "^7.21.0",
     "@babel/types": "^7.21.2",
-    "@lingui/babel-plugin-extract-messages": "5.6.1",
-    "@lingui/babel-plugin-lingui-macro": "5.6.1",
-    "@lingui/conf": "5.6.1",
-    "@lingui/core": "5.6.1",
-    "@lingui/format-po": "5.6.1",
-    "@lingui/message-utils": "5.6.1",
+    "@lingui/babel-plugin-extract-messages": "5.7.0",
+    "@lingui/babel-plugin-lingui-macro": "5.7.0",
+    "@lingui/conf": "5.7.0",
+    "@lingui/core": "5.7.0",
+    "@lingui/format-po": "5.7.0",
+    "@lingui/message-utils": "5.7.0",
     "chokidar": "3.5.1",
     "cli-table": "^0.3.11",
     "commander": "^10.0.0",
@@ -82,7 +82,7 @@
     "picocolors": "^1.1.1",
     "pofile": "^1.1.4",
     "pseudolocale": "^2.0.0",
-    "source-map": "^0.8.0-beta.0",
+    "source-map": "^0.7.6",
     "threads": "^1.7.0"
   },
   "devDependencies": {

packages/cli/src/api/compile.test.ts

@@ -288,6 +288,45 @@ describe("createCompiledCatalog", () => {
     })
   })
 
+  describe("options.outputPrefix", () => {
+    const getCompiledCatalog = (outputPrefix?: string) =>
+      createCompiledCatalog(
+        "en",
+        {
+          Hello: "Hello",
+        },
+        {
+          outputPrefix,
+        }
+      ).source
+
+    it("should use default eslint-disable directive when not specified", () => {
+      const result = getCompiledCatalog()
+      expect(result).toContain("/*eslint-disable*/")
+    })
+
+    it("should use oxlint-disable directive", () => {
+      const result = getCompiledCatalog("/*oxlint-disable*/")
+      expect(result).toContain("/*oxlint-disable*/")
+    })
+
+    it("should use custom prefix when specified", () => {
+      const result = getCompiledCatalog("/*biome-ignore lint: auto-generated*/")
+      expect(result).toContain("/*biome-ignore lint: auto-generated*/")
+      expect(result).not.toContain("eslint-disable")
+    })
+
+    it("should handle empty string prefix (no header)", () => {
+      const result = getCompiledCatalog("")
+      expect(
+        result.startsWith("export") ||
+          result.startsWith("module") ||
+          result.startsWith("window") ||
+          result.startsWith("global")
+      ).toBeTruthy()
+    })
+  })
+
   it("should return list of compile errors", () => {
     const res = createCompiledCatalog(
       "ru",

packages/cli/src/api/compile.ts

@@ -17,6 +17,7 @@ export type CreateCompileCatalogOptions = {
   namespace?: CompiledCatalogNamespace
   pseudoLocale?: string
   compilerBabelOptions?: GeneratorOptions
+  outputPrefix?: string
 }
 
 export type MessageCompilationError = {
@@ -44,6 +45,7 @@ export function createCompiledCatalog(
     namespace = "cjs",
     pseudoLocale,
     compilerBabelOptions = {},
+    outputPrefix = "/*eslint-disable*/",
   } = options
   const shouldPseudolocalize = locale === pseudoLocale
 
@@ -91,7 +93,7 @@ export function createCompiledCatalog(
     ...compilerBabelOptions,
   }).code
 
-  return { source: "/*eslint-disable*/" + code, errors }
+  return { source: `${outputPrefix}` + code, errors }
 }
 
 function buildExportStatement(