@open-xchange/rolldown-plugin-i18next-gettext 1.4.2 → 1.4.3

package/CHANGELOG.md

@@ -1,44 +1,51 @@
 # Changelog
 
-## `1.4.2` – 2026-Sep-20
+## [1.4.3] - 2026-09-23
+
+- fixed: option `srcFiles` is resolved against Vite's resolved `root` option when used as Vite plugin (Vite does not pass its `root` as `cwd` to rolldown); an explicit `build.rolldownOptions.cwd` option takes precedence
+
+## [1.4.2] - 2026-09-20
 
 - fixed: option `srcFiles` is now resolved against rolldown's resolved `cwd` option
 
-## `1.4.1` – 2026-Sep-13
+## 1.4.1 - 2026-09-13
 
 - chore: migrate to gitlab.com
 
-## `1.4.0` – 2026-Aug-07
+## 1.4.0 - 2026-08-07
 
 - removed: deprecated option `potFiles`
 - chore: bump dependencies
 
-## `1.3.0` – 2026-May-14
+## 1.3.0 - 2026-05-14
 
 - changed: require NodeJS v22.18
 
-## `1.2.1` – 2026-Apr-20
+## 1.2.1 - 2026-04-20
 
 - fixed: name of option `potFile` for compatibility with old plugin
 
-## `1.2.0` – 2026-Apr-15
+## 1.2.0 - 2026-04-15
 
 - added: switched back to direct imports of PO files
 - removed: virtual modules for namespaces
 
-## `1.1.0` – 2026-Apr-15
+## 1.1.0 - 2026-04-15
 
 - removed: direct imports of PO files
 - added: allow to group PO files into different namespaces
 
-## `1.0.1` – 2026-Apr-14
+## 1.0.1 - 2026-04-14
 
 - fixed: removed debug output
 
-## `1.0.0` – 2026-Apr-13
+## 1.0.0 - 2026-04-13
 
 - added: hook filters for improved performance
 
-## `0.0.1` – 2026-Apr-10
+## 0.0.1 - 2026-04-10
 
 - initial release
+
+[1.4.3]: https://gitlab.com/openxchange/appsuite/documents/commons/plugins/-/compare/rolldown-plugin-i18next-gettext-1.4.2...rolldown-plugin-i18next-gettext-1.4.3
+[1.4.2]: https://gitlab.com/openxchange/appsuite/documents/commons/plugins/-/compare/rolldown-plugin-i18next-gettext-1.4.1...rolldown-plugin-i18next-gettext-1.4.2

package/README.md

@@ -43,7 +43,7 @@ export default defineConfig(() => {
 | Name | Type | Default | Description |
 | - | - | - | - |
 | `poFiles` | `string\|string[]` | `**/*.po` | Glob pattern(s) for all PO files to be converted when imported in source code. |
-| `srcFiles` | `string\|string[]` | `src/**/*.{js,jsx,ts,tsx}` | Glob pattern(s) for all source files to be scanned for UI strings for the POT file generator. Resolved against rolldown's resolved `cwd` option. |
+| `srcFiles` | `string\|string[]` | `src/**/*.{js,jsx,ts,tsx}` | Glob pattern(s) for all source files to be scanned for UI strings for the POT file generator. Resolved against rolldown's resolved `cwd` option. When used as Vite plugin without an explicit `build.rolldownOptions.cwd` option, resolved against Vite's resolved `root` option instead. |
 | `potFile` | `string` | `[NAMESPACE].pot` | Path to and filename of the generated POT files, relative to the build output directory. Must contain the placeholder `[NAMESPACE]` if the project contains translation strings in different i18next namespaces. |
 | `projectName` | `string` | _required_ | The project name to be inserted into the POT file under the key 'Project-Id-Version'. May contain the placeholder `[NAMESPACE]` |
 

package/dist/index.d.mts

@@ -15,6 +15,8 @@ export interface PluginI18nextGettextOptions {
   /**
    * Glob pattern(s) for all source files to be scanned for UI strings for the
    * POT file generator. Resolved against rolldown's resolved `cwd` option.
+   * When used as Vite plugin without an explicit `build.rolldownOptions.cwd`
+   * option, resolved against Vite's resolved `root` option instead.
    *
    * @default
    *  'src/**\/*.{js,jsx,ts,tsx}'
@@ -35,6 +37,32 @@ export interface PluginI18nextGettextOptions {
    */
   projectName: string;
 }
+/**
+ * The subset of Vite's plugin hooks used by this plugin in addition to the
+ * rolldown hooks (declared locally to avoid a dependency on Vite).
+ */
+export interface VitePluginHooks {
+  /**
+   * Vite hook receiving the resolved Vite configuration. Used to pick up the
+   * root directory of the Vite project, because Vite does not pass its `root`
+   * option as `cwd` option to rolldown.
+   */
+  configResolved?: (config: ViteResolvedConfig) => void;
+}
+/**
+ * The subset of Vite's resolved configuration used by this plugin (declared
+ * locally to avoid a dependency on Vite).
+ */
+export interface ViteResolvedConfig {
+  /** The root directory of the Vite project. */
+  root: string;
+  /** Build options with the options passed to rolldown. */
+  build?: {
+    rolldownOptions?: {
+      cwd?: string;
+    };
+  };
+}
 /**
  * Identifier of this plugin.
  */
@@ -46,8 +74,8 @@ export declare const PROJECT_NAME = "@open-xchange/rolldown-plugin-i18next-gette
  *  Plugin configuration.
  *
  * @returns
- *  The rolldown plugin object.
+ *  The rolldown plugin object (also usable as Vite plugin).
  */
-export default function pluginI18nextGettext(options: PluginI18nextGettextOptions): Plugin;
+export default function pluginI18nextGettext(options: PluginI18nextGettextOptions): Plugin & VitePluginHooks;
 //#endregion
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;iBAWiB;;;;;;;;EASf;;;;;;;;EASA;;;;;;;;;EAUA;;;;;EAMA;;;;;qBAQW;;;;;;;;;;wBAaW,qBAAqB,SAAS,8BAA8B"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;iBAWiB;;;;;;;;EASf;;;;;;;;;;EAWA;;;;;;;;;EAUA;;;;;EAMA;;;;;;iBAOe;;;;;;EAOf,kBAAkB,QAAQ;;;;;;iBAOX;;EAEf;;EAEA;IAAU;MAAoB;;;;;;;qBAQnB;;;;;;;;;;wBAaW,qBAAqB,SAAS,8BAA8B,SAAS"}

package/dist/index.mjs

@@ -12,7 +12,7 @@ const PROJECT_NAME = "@open-xchange/rolldown-plugin-i18next-gettext";
 *  Plugin configuration.
 *
 * @returns
-*  The rolldown plugin object.
+*  The rolldown plugin object (also usable as Vite plugin).
 */
 function pluginI18nextGettext(options) {
 	const srcFiles = options.srcFiles ?? "src/**/*.{js,jsx,ts,tsx}";
@@ -21,8 +21,11 @@ function pluginI18nextGettext(options) {
 	let cwd;
 	return {
 		name: PROJECT_NAME,
+		configResolved(config) {
+			if (!config.build?.rolldownOptions?.cwd) cwd = config.root;
+		},
 		buildStart(inputOptions) {
-			cwd = inputOptions.cwd;
+			cwd ??= inputOptions.cwd;
 		},
 		load: {
 			filter: { id: poFiles },

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["\nimport type { Plugin, GeneralHookFilter } from 'rolldown'\nimport { createJsonModule } from '@open-xchange/rolldown-utils'\n\nimport { parsePoFile, parseSourceFiles } from '@open-xchange/i18next-po-parser'\n\n// types ======================================================================\n\n/**\n * Configuration options for the plugin '@open-xchange/rolldown-plugin-i18next-gettext'.\n */\nexport interface PluginI18nextGettextOptions {\n\n  /**\n   * Glob pattern(s) for all PO files to be converted when imported in source\n   * code.\n   *\n   * @default\n   *  '**\\/*.po'\n   */\n  poFiles?: string | readonly string[]\n\n  /**\n   * Glob pattern(s) for all source files to be scanned for UI strings for the\n   * POT file generator. Resolved against rolldown's resolved `cwd` option.\n   *\n   * @default\n   *  'src/**\\/*.{js,jsx,ts,tsx}'\n   */\n  srcFiles?: string | readonly string[]\n\n  /**\n   * Path to and filename of the generated POT files, relative to the build\n   * output directory. Must contain the placeholder `[NAMESPACE]` if the\n   * project contains translation strings in different i18next namespaces.\n   *\n   * @default\n   *  '[NAMESPACE].pot'\n   */\n  potFile?: string\n\n  /**\n   * The project name to be inserted into the POT files under the key\n   * 'Project-Id-Version'. May contain the placeholder `[NAMESPACE]`.\n   */\n  projectName: string\n}\n\n// constants ==================================================================\n\n/**\n * Identifier of this plugin.\n */\nexport const PROJECT_NAME = '@open-xchange/rolldown-plugin-i18next-gettext'\n\n// plugin =====================================================================\n\n/**\n * Rolldown plugin for using i18next with gettext `.po` files under the hood.\n *\n * @param options\n *  Plugin configuration.\n *\n * @returns\n *  The rolldown plugin object.\n */\nexport default function pluginI18nextGettext(options: PluginI18nextGettextOptions): Plugin {\n\n  // resolve default options\n  const srcFiles = options.srcFiles ?? 'src/**/*.{js,jsx,ts,tsx}'\n  const poFiles = options.poFiles ?? '**/*.po'\n  const potFile = options.potFile ?? '[NAMESPACE].pot'\n\n  // the resolved rolldown \"cwd\" option, captured in \"buildStart\"\n  let cwd: string\n\n  return {\n    name: PROJECT_NAME,\n\n    // fetch resolved \"cwd\" option\n    buildStart(inputOptions) {\n      cwd = inputOptions.cwd\n    },\n\n    // convert PO files to i18next namespace records\n    load: {\n      filter: { id: poFiles as GeneralHookFilter },\n      handler: async id => createJsonModule(await parsePoFile(id)),\n    },\n\n    // parse source files and create POT files per namespace\n    async generateBundle() {\n\n      // parse all source files and extract translations\n      const catalogs = await parseSourceFiles({ cwd, files: srcFiles, project: options.projectName })\n\n      // warn when writing multiple POT files to same file location\n      if ((catalogs.size > 1) && !potFile.includes('[NAMESPACE]')) {\n        this.error('multiple POT files written to same file location (missing placeholder `[NAMESPACE]` in option potFile)')\n      }\n\n      // add all POT files as assets to the bundle\n      for (const [namespace, source] of catalogs) {\n        const fileName = potFile.replaceAll('[NAMESPACE]', namespace)\n        this.emitFile({ type: 'asset', fileName, source })\n      }\n    },\n  }\n}\n"],"mappings":";;;;;;AAqDA,MAAa,eAAe;;;;;;;;;;AAa5B,SAAwB,qBAAqB,SAA8C;CAGzF,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,UAAU,QAAQ,WAAW;CACnC,MAAM,UAAU,QAAQ,WAAW;CAGnC,IAAI;CAEJ,OAAO;EACL,MAAM;EAGN,WAAW,cAAc;GACvB,MAAM,aAAa;EACrB;EAGA,MAAM;GACJ,QAAQ,EAAE,IAAI,QAA6B;GAC3C,SAAS,OAAM,OAAM,iBAAiB,MAAM,YAAY,EAAE,CAAC;EAC7D;EAGA,MAAM,iBAAiB;GAGrB,MAAM,WAAW,MAAM,iBAAiB;IAAE;IAAK,OAAO;IAAU,SAAS,QAAQ;GAAY,CAAC;GAG9F,IAAK,SAAS,OAAO,KAAM,CAAC,QAAQ,SAAS,aAAa,GACxD,KAAK,MAAM,wGAAwG;GAIrH,KAAK,MAAM,CAAC,WAAW,WAAW,UAAU;IAC1C,MAAM,WAAW,QAAQ,WAAW,eAAe,SAAS;IAC5D,KAAK,SAAS;KAAE,MAAM;KAAS;KAAU;IAAO,CAAC;GACnD;EACF;CACF;AACF"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["\nimport type { Plugin, GeneralHookFilter } from 'rolldown'\nimport { createJsonModule } from '@open-xchange/rolldown-utils'\n\nimport { parsePoFile, parseSourceFiles } from '@open-xchange/i18next-po-parser'\n\n// types ======================================================================\n\n/**\n * Configuration options for the plugin '@open-xchange/rolldown-plugin-i18next-gettext'.\n */\nexport interface PluginI18nextGettextOptions {\n\n  /**\n   * Glob pattern(s) for all PO files to be converted when imported in source\n   * code.\n   *\n   * @default\n   *  '**\\/*.po'\n   */\n  poFiles?: string | readonly string[]\n\n  /**\n   * Glob pattern(s) for all source files to be scanned for UI strings for the\n   * POT file generator. Resolved against rolldown's resolved `cwd` option.\n   * When used as Vite plugin without an explicit `build.rolldownOptions.cwd`\n   * option, resolved against Vite's resolved `root` option instead.\n   *\n   * @default\n   *  'src/**\\/*.{js,jsx,ts,tsx}'\n   */\n  srcFiles?: string | readonly string[]\n\n  /**\n   * Path to and filename of the generated POT files, relative to the build\n   * output directory. Must contain the placeholder `[NAMESPACE]` if the\n   * project contains translation strings in different i18next namespaces.\n   *\n   * @default\n   *  '[NAMESPACE].pot'\n   */\n  potFile?: string\n\n  /**\n   * The project name to be inserted into the POT files under the key\n   * 'Project-Id-Version'. May contain the placeholder `[NAMESPACE]`.\n   */\n  projectName: string\n}\n\n/**\n * The subset of Vite's plugin hooks used by this plugin in addition to the\n * rolldown hooks (declared locally to avoid a dependency on Vite).\n */\nexport interface VitePluginHooks {\n\n  /**\n   * Vite hook receiving the resolved Vite configuration. Used to pick up the\n   * root directory of the Vite project, because Vite does not pass its `root`\n   * option as `cwd` option to rolldown.\n   */\n  configResolved?: (config: ViteResolvedConfig) => void\n}\n\n/**\n * The subset of Vite's resolved configuration used by this plugin (declared\n * locally to avoid a dependency on Vite).\n */\nexport interface ViteResolvedConfig {\n  /** The root directory of the Vite project. */\n  root: string\n  /** Build options with the options passed to rolldown. */\n  build?: { rolldownOptions?: { cwd?: string } }\n}\n\n// constants ==================================================================\n\n/**\n * Identifier of this plugin.\n */\nexport const PROJECT_NAME = '@open-xchange/rolldown-plugin-i18next-gettext'\n\n// plugin =====================================================================\n\n/**\n * Rolldown plugin for using i18next with gettext `.po` files under the hood.\n *\n * @param options\n *  Plugin configuration.\n *\n * @returns\n *  The rolldown plugin object (also usable as Vite plugin).\n */\nexport default function pluginI18nextGettext(options: PluginI18nextGettextOptions): Plugin & VitePluginHooks {\n\n  // resolve default options\n  const srcFiles = options.srcFiles ?? 'src/**/*.{js,jsx,ts,tsx}'\n  const poFiles = options.poFiles ?? '**/*.po'\n  const potFile = options.potFile ?? '[NAMESPACE].pot'\n\n  // the root directory to resolve the source files against: Vite's resolved\n  // \"root\" option (captured in \"configResolved\"), or rolldown's resolved \"cwd\"\n  // option (captured in \"buildStart\")\n  let cwd: string | undefined\n\n  return {\n    name: PROJECT_NAME,\n\n    // fetch resolved \"root\" option (Vite only, called before \"buildStart\"); an\n    // explicit rolldown \"cwd\" option takes precedence (received in \"buildStart\")\n    configResolved(config) {\n      if (!config.build?.rolldownOptions?.cwd) cwd = config.root\n    },\n\n    // fetch resolved \"cwd\" option (unless the Vite root is already known)\n    buildStart(inputOptions) {\n      cwd ??= inputOptions.cwd\n    },\n\n    // convert PO files to i18next namespace records\n    load: {\n      filter: { id: poFiles as GeneralHookFilter },\n      handler: async id => createJsonModule(await parsePoFile(id)),\n    },\n\n    // parse source files and create POT files per namespace\n    async generateBundle() {\n\n      // parse all source files and extract translations\n      const catalogs = await parseSourceFiles({ cwd, files: srcFiles, project: options.projectName })\n\n      // warn when writing multiple POT files to same file location\n      if ((catalogs.size > 1) && !potFile.includes('[NAMESPACE]')) {\n        this.error('multiple POT files written to same file location (missing placeholder `[NAMESPACE]` in option potFile)')\n      }\n\n      // add all POT files as assets to the bundle\n      for (const [namespace, source] of catalogs) {\n        const fileName = potFile.replaceAll('[NAMESPACE]', namespace)\n        this.emitFile({ type: 'asset', fileName, source })\n      }\n    },\n  }\n}\n"],"mappings":";;;;;;AAgFA,MAAa,eAAe;;;;;;;;;;AAa5B,SAAwB,qBAAqB,SAAgE;CAG3G,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,UAAU,QAAQ,WAAW;CACnC,MAAM,UAAU,QAAQ,WAAW;CAKnC,IAAI;CAEJ,OAAO;EACL,MAAM;EAIN,eAAe,QAAQ;GACrB,IAAI,CAAC,OAAO,OAAO,iBAAiB,KAAK,MAAM,OAAO;EACxD;EAGA,WAAW,cAAc;GACvB,QAAQ,aAAa;EACvB;EAGA,MAAM;GACJ,QAAQ,EAAE,IAAI,QAA6B;GAC3C,SAAS,OAAM,OAAM,iBAAiB,MAAM,YAAY,EAAE,CAAC;EAC7D;EAGA,MAAM,iBAAiB;GAGrB,MAAM,WAAW,MAAM,iBAAiB;IAAE;IAAK,OAAO;IAAU,SAAS,QAAQ;GAAY,CAAC;GAG9F,IAAK,SAAS,OAAO,KAAM,CAAC,QAAQ,SAAS,aAAa,GACxD,KAAK,MAAM,wGAAwG;GAIrH,KAAK,MAAM,CAAC,WAAW,WAAW,UAAU;IAC1C,MAAM,WAAW,QAAQ,WAAW,eAAe,SAAS;IAC5D,KAAK,SAAS;KAAE,MAAM;KAAS;KAAU;IAAO,CAAC;GACnD;EACF;CACF;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-xchange/rolldown-plugin-i18next-gettext",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "Rolldown integration of i18next using gettext PO files",
   "repository": {
     "type": "git",
@@ -27,11 +27,11 @@
     "CHANGELOG.*"
   ],
   "dependencies": {
-    "@open-xchange/i18next-po-parser": "^1.6.0",
+    "@open-xchange/i18next-po-parser": "^1.6.1",
     "@open-xchange/rolldown-utils": "^1.2.1"
   },
   "devDependencies": {
-    "@open-xchange/bundler-testutils": "^2.0.0",
+    "@open-xchange/bundler-testutils": "^2.0.1",
     "@open-xchange/linter-presets": "^1.30.4",
     "@open-xchange/rolldown-plugin-dynamic-import-vars": "^1.3.1",
     "@open-xchange/tsconfig": "^0.2.3",