refactor: migrate from pofile to pofile-ts

- Replace pofile dependency with pofile-ts ^2.2.0
- Use exported types (Item, Headers) instead of manual definitions
- Use fs.writeFile + po.toString() instead of removed po.save()
- Add pofile-ts to Jest transformIgnorePatterns for ESM support
- Add .lingui/ to .gitignore (test cache artifacts)

pofile-ts is a modernized fork with TypeScript support and zero
dependencies (pure parsing/serialization, no filesystem access).

Author: swernerx

.gitignore

@@ -22,3 +22,4 @@ junit.xml
 !.yarn/releases
 !.yarn/sdks
 !.yarn/versions
+.lingui/

jest.config.js

@@ -9,7 +9,7 @@ const tsConfigPathMapping = pathsToModuleNameMapper(
 )
 
 const testMatch = ["**/?(*.)test.(js|ts|tsx)", "**/test/index.(js|ts|tsx)"]
-const transformIgnorePatterns = ["node_modules/(?!@messageformat)"]
+const transformIgnorePatterns = ["node_modules/(?!@messageformat|pofile-ts)"]
 /**
  * @type {import('jest').Config}
  */

packages/cli/package.json

@@ -80,7 +80,7 @@
     "normalize-path": "^3.0.0",
     "ora": "^5.1.0",
     "picocolors": "^1.1.1",
-    "pofile": "^1.1.4",
+    "pofile-ts": "^2.2.0",
     "pseudolocale": "^2.0.0",
     "source-map": "^0.7.6",
     "threads": "^1.7.0"

packages/cli/src/services/translationIO.ts

@@ -1,14 +1,12 @@
 import fs from "fs"
 import { dirname } from "path"
-import PO from "pofile"
+import PO, { Item as POItem, type Headers as POHeaders } from "pofile-ts"
 import https from "https"
 import { globSync } from "glob"
 import { format as formatDate } from "date-fns"
 import { LinguiConfigNormalized } from "@lingui/conf"
 import { CliExtractOptions } from "../lingui-extract"
 
-type POItem = InstanceType<typeof PO.Item>
-
 type TranslationIoSegment = {
   type: string
   source: string
@@ -26,7 +24,7 @@ type TranslationIoProject = {
 const EXPLICIT_ID_FLAG = "js-lingui-explicit-id"
 const EXPLICIT_ID_AND_CONTEXT_FLAG = "js-lingui-explicit-id-and-context"
 
-const getCreateHeaders = (language: string) => ({
+const getCreateHeaders = (language: string): Partial<POHeaders> => ({
   "POT-Creation-Date": formatDate(new Date(), "yyyy-MM-dd HH:mmxxxx"),
   "MIME-Version": "1.0",
   "Content-Type": "text/plain; charset=utf-8",
@@ -354,15 +352,15 @@ function saveSegmentsToTargetPos(
     })
 
     // Check that localePath directory exists and save PO file
-    fs.promises.mkdir(dirname(localePath), { recursive: true }).then(() => {
-      po.save(localePath, (err) => {
-        if (err) {
-          console.error("Error while saving target PO files:")
-          console.error(err)
-          process.exit(1)
-        }
+    /* istanbul ignore next -- @preserve Integration with external Translation.io service */
+    fs.promises
+      .mkdir(dirname(localePath), { recursive: true })
+      .then(() => fs.promises.writeFile(localePath, po.toString()))
+      .catch((err) => {
+        console.error("Error while saving target PO files:")
+        console.error(err)
+        process.exit(1)
       })
-    })
   })
 }
 

packages/format-po-gettext/package.json

@@ -50,7 +50,7 @@
     "cldr-core": "^45.0.0",
     "node-gettext": "^3.0.0",
     "plurals-cldr": "^2.0.1",
-    "pofile": "^1.1.4"
+    "pofile-ts": "^2.2.0"
   },
   "devDependencies": {
     "@lingui/jest-mocks": "workspace:^",

packages/format-po-gettext/src/po-gettext.ts

@@ -1,6 +1,6 @@
 import { parse as parseIcu, Select, SelectCase } from "@messageformat/parser"
 import pluralsCldr from "plurals-cldr"
-import PO from "pofile"
+import PO, { Item as POItem } from "pofile-ts"
 import gettextPlurals from "node-gettext/lib/plurals"
 
 import type { CatalogFormatter, CatalogType, MessageType } from "@lingui/conf"
@@ -9,8 +9,6 @@ import { formatter as poFormatter } from "@lingui/format-po"
 import type { PoFormatterOptions } from "@lingui/format-po"
 import { getCldrPluralSamples } from "./plural-samples"
 
-type POItem = InstanceType<typeof PO.Item>
-
 export type PoGettextFormatterOptions = PoFormatterOptions & {
   disableSelectWarning?: boolean
   customICUPrefix?: string

packages/format-po/package.json

@@ -46,7 +46,7 @@
     "@lingui/conf": "5.6.1",
     "@lingui/message-utils": "5.6.1",
     "date-fns": "^3.6.0",
-    "pofile": "^1.1.4"
+    "pofile-ts": "^2.2.0"
   },
   "devDependencies": {
     "@lingui/jest-mocks": "workspace:^",

packages/format-po/src/po.ts

@@ -1,12 +1,10 @@
 import { format as formatDate } from "date-fns"
-import PO from "pofile"
+import PO, { Item as POItem, type Headers as POHeaders } from "pofile-ts"
 
 import { CatalogFormatter, CatalogType, MessageType } from "@lingui/conf"
 import { generateMessageId } from "@lingui/message-utils/generateMessageId"
 import { normalizePlaceholderValue } from "./utils"
 
-type POItem = InstanceType<typeof PO.Item>
-
 const splitOrigin = (origin: string) => {
   const [file, line] = origin.split(":")
   return [file, line ? Number(line) : null] as [file: string, line: number]
@@ -110,7 +108,7 @@ function isGeneratedId(id: string, message: MessageType): boolean {
 function getCreateHeaders(
   language: string,
   customHeaderAttributes: PoFormatterOptions["customHeaderAttributes"]
-): PO["headers"] {
+): Partial<POHeaders> {
   return {
     "POT-Creation-Date": formatDate(new Date(), "yyyy-MM-dd HH:mmxxxx"),
     "MIME-Version": "1.0",

yarn.lock

@@ -3029,7 +3029,7 @@ __metadata:
     normalize-path: ^3.0.0
     ora: ^5.1.0
     picocolors: ^1.1.1
-    pofile: ^1.1.4
+    pofile-ts: ^2.2.0
     pseudolocale: ^2.0.0
     source-map: ^0.7.6
     threads: ^1.7.0
@@ -3135,7 +3135,7 @@ __metadata:
     mockdate: ^3.0.5
     node-gettext: ^3.0.0
     plurals-cldr: ^2.0.1
-    pofile: ^1.1.4
+    pofile-ts: ^2.2.0
     unbuild: 2.0.0
   languageName: unknown
   linkType: soft
@@ -3149,7 +3149,7 @@ __metadata:
     "@lingui/message-utils": 5.6.1
     date-fns: ^3.6.0
     mockdate: ^3.0.5
-    pofile: ^1.1.4
+    pofile-ts: ^2.2.0
     unbuild: 2.0.0
   languageName: unknown
   linkType: soft
@@ -13769,10 +13769,10 @@ __metadata:
   languageName: node
   linkType: hard
 
-"pofile@npm:^1.1.4":
-  version: 1.1.4
-  resolution: "pofile@npm:1.1.4"
-  checksum: 7ef428d2793fcbcf021e4250d36043374ffbd7c8e15268977fae2361536abb894e97ee58525b2c1eeda5688a2b14b274657a271e08816059b12d8c02ac99fde0
+"pofile-ts@npm:^2.2.0":
+  version: 2.2.0
+  resolution: "pofile-ts@npm:2.2.0"
+  checksum: f0d4b6c8b22e2e8ea4be98e8d20794cd0f40969e26dc35b2b0d0668a0a593d467b14145e10b9ebe9abc8b6c969d2b19ab390f26b8e57d79ea23195fa5aa5b958
   languageName: node
   linkType: hard