rsbuild-plugin-i18next-extractor 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rspack Contrib
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,160 @@
+# rsbuild-plugin-i18next-extractor
+
+<p>
+  <a href="https://npmjs.com/package/rsbuild-plugin-i18next-extractor">
+   <img src="https://img.shields.io/npm/v/rsbuild-plugin-i18next-extractor?style=flat-square&colorA=564341&colorB=EDED91" alt="npm version" />
+  </a>
+  <img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square&colorA=564341&colorB=EDED91" alt="license" />
+  <a href="https://npmcharts.com/compare/rsbuild-plugin-i18next-extractor?minimal=true"><img src="https://img.shields.io/npm/dm/rsbuild-plugin-i18next-extractor.svg?style=flat-square&colorA=564341&colorB=EDED91" alt="downloads" /></a>
+</p>
+
+A Rsbuild plugin for extracting i18n translations using [i18next-cli](https://github.com/i18next/i18next-cli). 
+
+## Why
+
+`i18next-cli` can extract i18n translations from your source code through [`extract.input`](https://github.com/i18next/i18next-cli?tab=readme-ov-file#1-initialize-configuration). However some i18n translations will be bundled together with your code even if they are not used.
+
+This plugin uses the Rspack module graph to override the `extract.input` configuration with imported modules, generating i18n translations based on usage.
+
+## Installation
+
+```bash
+npm add rsbuild-plugin-i18next-extractor --save-dev
+```
+
+## Usage
+
+### Install
+
+```ts
+// rsbuild.config.ts
+import { pluginI18nextExtractor } from 'rsbuild-plugin-i18next-extractor';
+import { defineConfig } from '@rsbuild/core';
+
+export default defineConfig({
+  plugins: [
+    pluginI18nextExtractor({
+      localesDir: './locales',
+    }),
+  ],
+});
+```
+
+### Directory Structure
+
+Your project should have a locales directory with JSON files:
+
+```
+locales/
+  en.json
+  zh.json
+  ja.json
+```
+
+**NOTE:** `rsbuild-plugin-i18next-extractor` only supports `*.json` files.
+
+
+### Using i18n in your code
+
+```js
+// ./src/i18n.js
+import i18next from 'i18next';
+import en from '../locales/en.json';
+import zh from '../locales/zh.json';
+
+const i18n = i18next.createInstance()
+
+i18n.init({
+  lng: 'en',
+  resources: {
+    en: {
+      translation: en,
+    },
+    zh: {
+      translation: zh,
+    }
+  }
+})
+
+export { i18n }
+```
+
+use `i18n.t('key')` to translate
+
+```js
+// src/index.js
+import { i18n } from './i18n';
+
+console.log(i18n.t('hello'));
+```
+
+## Options
+
+### `localesDir`
+
+- **Type:** `string`
+- **Required:** Yes
+
+The directory containing your locale JSON files.
+
+Supports both relative and absolute paths:
+- Relative path: Resolved relative to the project root directory (e.g., `'./locales'`, `'src/locales'`)
+- Absolute path: Used as-is (e.g., `'/absolute/path/to/locales'`)
+
+```ts
+pluginI18nextExtractor({
+  localesDir: './locales',
+});
+```
+
+### `i18nextToolkitConfig`
+
+- **Type:** `I18nextToolkitConfig`
+- **Required:** No
+
+The configuration for i18next-cli toolkit. This allows you to customize how translation keys are extracted from your code.
+
+See [i18next-cli configuration](https://github.com/i18next/i18next-cli) for available options.
+
+```ts
+pluginI18nextExtractor({
+  localesDir: './locales',
+  i18nextToolkitConfig: {
+    extract: {
+      // Custom extraction configuration
+    },
+  },
+});
+```
+
+### `onKeyNotFound`
+
+- **Type:** `(key: string, locale: string, localeFilePath: string, entryName: string) => void`
+- **Required:** No
+
+Custom callback function invoked when a translation key is not found in the locale file.
+
+By default, a warning is logged to the console with the missing key and file information.
+
+**Parameters:**
+- `key` - The translation key that was not found
+- `locale` - The locale identifier (e.g., `'en'`, `'zh-CN'`)
+- `localeFilePath` - The path to the locale file
+- `entryName` - The name of the current entry being processed
+
+```ts
+pluginI18nextExtractor({
+  localesDir: './locales',
+  onKeyNotFound: (key, locale, localeFilePath, entryName) => {
+    console.error(`Missing key: ${key} in ${locale}`);
+  },
+});
+```
+
+## Credits
+
+[rsbuild-plugin-tailwindcss](https://github.com/rspack-contrib/rsbuild-plugin-tailwindcss) - Inspiration for this plugin
+
+## License
+
+[MIT](./LICENSE)

package/dist/I18nextExtractorWebpackPlugin.d.ts

@@ -0,0 +1,14 @@
+import type { Rspack } from '@rsbuild/core';
+import type { PluginI18nextExtractorOptions } from './options.js';
+interface I18nextExtractorWebpackPluginOptions extends PluginI18nextExtractorOptions {
+    logger: {
+        warn: (message: string) => void;
+    };
+}
+export declare class I18nextExtractorWebpackPlugin {
+    private options;
+    constructor(options: I18nextExtractorWebpackPluginOptions);
+    apply(compiler: Rspack.Compiler): void;
+}
+export {};
+//# sourceMappingURL=I18nextExtractorWebpackPlugin.d.ts.map

package/dist/I18nextExtractorWebpackPlugin.js

@@ -0,0 +1,114 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { getLocalesFromDirectory, getLocaleVariableName, resolveLocaleFilePath, } from './utils.js';
+export class I18nextExtractorWebpackPlugin {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    apply(compiler) {
+        const { Compilation, sources } = compiler.webpack;
+        compiler.hooks.compilation.tap(this.constructor.name, (compilation) => {
+            const locales = getLocalesFromDirectory(compiler.context, this.options.localesDir);
+            if (locales.length === 0) {
+                throw new Error(`[rsbuild-plugin-i18next-extractor] There is no "*.json" in ${this.options.localesDir}. Please check your "localesDir" option.`);
+            }
+            compilation.hooks.processAssets.tapPromise({
+                name: this.constructor.name,
+                stage: Compilation.PROCESS_ASSETS_STAGE_DERIVED,
+            }, async () => {
+                // Process each entrypoint
+                await Promise.all([...compilation.entrypoints.entries()].map(async ([entryName, entrypoint]) => {
+                    // get entry chunk but not split chunk
+                    const jsFiles = entrypoint.chunks
+                        .filter((chunk) => chunk.hasRuntime())
+                        .flatMap((chunk) => Array.from(chunk.files))
+                        .filter((file) => /\.(c|m)?js$/.test(file))
+                        .map((file) => compilation.getAsset(file))
+                        .filter((file) => !!file);
+                    const asyncJsFiles = compilation.chunkGroups
+                        .filter((cg) => !cg.isInitial())
+                        .filter((cg) => cg.getParents().some((p) => p.name === entryName))
+                        .flatMap((cg) => cg.getFiles())
+                        .filter((file) => /\.(c|m)?js$/.test(file))
+                        .map((file) => compilation.getAsset(file))
+                        .filter((file) => !!file);
+                    // Collect all the modules belong to current entry
+                    const entryModules = new Set();
+                    for (const chunk of entrypoint.chunks) {
+                        const modules = compilation.chunkGraph.getChunkModulesIterable(chunk);
+                        for (const m of modules) {
+                            collectModules(m, entryModules);
+                        }
+                    }
+                    // Only extract keys in js(x)/ts(x) files
+                    const files = Array.from(entryModules).filter((f) => /\.[jt]sx?$/.test(f));
+                    // Load origin translations
+                    const originTranslations = {};
+                    for (const locale of locales) {
+                        const localePath = resolveLocaleFilePath(this.options.localesDir, locale, compiler.context);
+                        try {
+                            const content = await fs.readFile(localePath, 'utf-8');
+                            originTranslations[locale] = JSON.parse(content);
+                        }
+                        catch {
+                            throw new Error(`[rsbuild-plugin-i18next-extractor] Failed to read locale file "${localePath}"`);
+                        }
+                    }
+                    const { extractTranslationKeys } = await import('./i18nextCLIExtractor.js');
+                    const extractedTranslationKeys = await extractTranslationKeys(files, locales, this.options.i18nextToolkitConfig);
+                    // Generate i18n resource definitions for each locale
+                    const i18nTranslationDefinitions = [];
+                    for (const locale of locales) {
+                        const localeFilePath = resolveLocaleFilePath(this.options.localesDir, locale, compiler.context);
+                        const extractedTranslations = pickTranslationsByKeys(originTranslations[locale], extractedTranslationKeys[locale], (key) => {
+                            // Use custom callback if provided, otherwise use default warning
+                            if (this.options.onKeyNotFound) {
+                                this.options.onKeyNotFound(key, locale, localeFilePath, entryName);
+                            }
+                            else {
+                                this.options.logger.warn(`[rsbuild-plugin-i18next-extractor] The key "${key}" is not found in "${path.relative(compiler.context, localeFilePath)}". Current entry is "${entryName}".`);
+                            }
+                        });
+                        i18nTranslationDefinitions.push(`const ${getLocaleVariableName(locale)} = ${JSON.stringify(extractedTranslations)};`);
+                    }
+                    // Replace the placeholder with actual extracted translations
+                    for (const jsFile of [...jsFiles, ...asyncJsFiles]) {
+                        const assetName = jsFile.name;
+                        compilation.updateAsset(assetName, (oldSource) => new sources.ConcatSource(i18nTranslationDefinitions.join('\n'), '\n', oldSource));
+                    }
+                }));
+            });
+        });
+    }
+}
+function collectModules(m, entryModules) {
+    if (m.modules) {
+        for (const innerModule of m.modules) {
+            collectModules(innerModule, entryModules);
+        }
+    }
+    else if (m.resource) {
+        const resource = m.resource.split('?')[0];
+        if (resource) {
+            entryModules.add(resource);
+        }
+    }
+}
+/**
+ * Combine the origin translations and the extracted translation keys.
+ */
+function pickTranslationsByKeys(originTranslations, extractedKeys, onKeyNotFoundCallback) {
+    const result = {};
+    for (const key of extractedKeys) {
+        if (originTranslations[key]) {
+            result[key] = originTranslations[key];
+        }
+        else {
+            onKeyNotFoundCallback(key);
+            result[key] = '';
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=I18nextExtractorWebpackPlugin.js.map

package/dist/i18nextCLIExtractor.d.ts

@@ -0,0 +1,3 @@
+import type { I18nextToolkitConfig } from './options.js';
+export declare function extractTranslationKeys(files: string[], locales: string[], i18nextToolkitConfig?: I18nextToolkitConfig): Promise<Record<string, string[]>>;
+//# sourceMappingURL=i18nextCLIExtractor.d.ts.map

package/dist/i18nextCLIExtractor.js

@@ -0,0 +1,37 @@
+/**
+ * @packageDocumentation
+ *
+ * An extractor based i18next-cli is used with `rsbuild-plugin-i18next-extractor`.
+ */
+import { extract } from 'i18next-cli';
+export async function extractTranslationKeys(files, locales, i18nextToolkitConfig) {
+    const extractResult = await extract({
+        ...i18nextToolkitConfig,
+        locales,
+        extract: {
+            input: files,
+            output: 'node_modules/.rsbuild-plugin-i18next-extractor/locales/{{language}}/{{namespace}}.json',
+            ...i18nextToolkitConfig?.extract,
+        },
+    });
+    // Group keys by locale
+    const translationsKeysByLocale = {};
+    for (const result of extractResult) {
+        // Extract locale from path (support both Unix and Windows paths)
+        // Example paths:
+        // Unix: '/path/to/node_modules/.rsbuild-plugin-i18next-extractor/locales/zh-CN/translation.json'
+        // Windows: 'C:\\path\\to\\node_modules\\.rsbuild-plugin-i18next-extractor\\locales\\zh-CN\\translation.json'
+        const pathMatch = result.path?.match(/[/\\]locales[/\\]([^/\\]+)[/\\]/);
+        const locale = pathMatch?.[1];
+        if (locale && result.newTranslations) {
+            const keys = Object.keys(result.newTranslations);
+            if (!translationsKeysByLocale[locale]) {
+                translationsKeysByLocale[locale] = [];
+            }
+            // Add keys for this locale (avoiding duplicates)
+            translationsKeysByLocale[locale] = Array.from(new Set([...translationsKeysByLocale[locale], ...keys]));
+        }
+    }
+    return translationsKeysByLocale;
+}
+//# sourceMappingURL=i18nextCLIExtractor.js.map

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { PluginI18nextExtractorOptions } from './options.js';
+export * from './pluginI18nextExtractor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './pluginI18nextExtractor.js';
+//# sourceMappingURL=index.js.map

package/dist/loader.d.ts

@@ -0,0 +1,23 @@
+import type { Rspack } from '@rsbuild/core';
+interface LoaderOptions {
+    localesDir: string;
+}
+/**
+ * This loader will replace the export of i18n translations JSON file
+ * with a variable placeholder.
+ *
+ * @example
+ * ```js
+ * // Before:
+ * module.exports = { "hello": "World" }
+ *
+ * // After:
+ * module.exports = __I18N_<LOCALE>_EXTRACTED_TRANSLATIONS__
+ * ```
+ *
+ * The `__I18N_<LOCALE>_EXTRACTED_TRANSLATIONS__` will be replaced in Webpack/Rspack ProcessAssets hook
+ * with the actual extracted translations for that locale.
+ */
+export default function loader(this: Rspack.LoaderContext<LoaderOptions>, source: string): void;
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.js

@@ -0,0 +1,35 @@
+import * as path from 'node:path';
+import { getLocaleVariableName } from './utils.js';
+/**
+ * This loader will replace the export of i18n translations JSON file
+ * with a variable placeholder.
+ *
+ * @example
+ * ```js
+ * // Before:
+ * module.exports = { "hello": "World" }
+ *
+ * // After:
+ * module.exports = __I18N_<LOCALE>_EXTRACTED_TRANSLATIONS__
+ * ```
+ *
+ * The `__I18N_<LOCALE>_EXTRACTED_TRANSLATIONS__` will be replaced in Webpack/Rspack ProcessAssets hook
+ * with the actual extracted translations for that locale.
+ */
+export default function loader(source) {
+    const { localesDir } = this.getOptions();
+    const absoluteLocalesDir = path.isAbsolute(localesDir)
+        ? localesDir.replaceAll(path.sep, '/')
+        : path.posix.join(this.rootContext, localesDir);
+    const match = new RegExp(`${absoluteLocalesDir}/(.*)\\.json`).exec(this.resourcePath.replaceAll(path.sep, '/'));
+    if (!match || match.length < 2) {
+        this.callback(null, `module.exports = ${source}`);
+        return;
+    }
+    const locale = match[1];
+    const replacement = getLocaleVariableName(locale);
+    // For JSON files, we need to export the placeholder
+    // Since JSON is treated as a module, we use module.exports
+    this.callback(null, `module.exports = ${replacement}`);
+}
+//# sourceMappingURL=loader.js.map

package/dist/options.d.ts

@@ -0,0 +1,51 @@
+import type { I18nextToolkitConfig as RawI18nextToolkitConfig } from 'i18next-cli';
+type ExtractConfigWithOptionalFields = Omit<RawI18nextToolkitConfig['extract'], 'input' | 'output'> & {
+    input?: RawI18nextToolkitConfig['extract']['input'];
+    output?: RawI18nextToolkitConfig['extract']['output'];
+};
+export type I18nextToolkitConfig = Omit<RawI18nextToolkitConfig, 'extract' | 'locales'> & {
+    extract?: ExtractConfigWithOptionalFields;
+    locales?: string[];
+};
+export interface PluginI18nextExtractorOptions {
+    /**
+     * The directory which contains the raw locale translations.
+     *
+     * Supports both relative and absolute paths:
+     * - Relative path: Resolved relative to the project root directory (e.g., './locales', 'src/locales')
+     * - Absolute path: Used as-is (e.g., '/absolute/path/to/locales')
+     *
+     * @example
+     * // Relative path
+     * { localesDir: './locales' }
+     *
+     * @example
+     * // Absolute path
+     * { localesDir: '/Users/username/project/locales' }
+     */
+    localesDir: string;
+    /**
+     * The configuration of i18next-cli toolkit.
+     */
+    i18nextToolkitConfig?: I18nextToolkitConfig;
+    /**
+     * Custom callback function invoked when a translation key is not found in the locale file.
+     *
+     * By default, a warning is logged to the console with the missing key and file information.
+     *
+     * @param key - The translation key that was not found
+     * @param locale - The locale identifier (e.g., 'en', 'zh-CN')
+     * @param localeFilePath - The path to the locale file
+     * @param entryName - The name of the current entry being processed
+     *
+     * @example
+     * {
+     *   onKeyNotFound: (key, locale, localeFilePath, entryName) => {
+     *     console.error(`Missing key: ${key} in ${locale}`);
+     *   }
+     * }
+     */
+    onKeyNotFound?: (key: string, locale: string, localeFilePath: string, entryName: string) => void;
+}
+export {};
+//# sourceMappingURL=options.d.ts.map

package/dist/options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options.js.map

package/dist/pluginI18nextExtractor.d.ts

@@ -0,0 +1,28 @@
+import type { RsbuildPlugin } from '@rsbuild/core';
+import type { PluginI18nextExtractorOptions } from './options.js';
+/**
+ * A Rsbuild plugin for extracting i18n translations using i18next-cli.
+ *
+ * This plugin automatically scans your source code for i18n translation keys
+ * and extracts only used keys from your locale files. This helps reduce
+ * bundle size by only including translations that are actually used in your code.
+ *
+ * @example
+ * ```ts
+ * // rsbuild.config.ts
+ * import { defineConfig } from '@rsbuild/core'
+ * import { pluginI18nextExtractor } from 'rsbuild-plugin-i18next-extractor';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     pluginI18nextExtractor({
+ *       localesDir: './locales'
+ *     })
+ *   ],
+ * })
+ * ```
+ *
+ * @public
+ */
+export declare function pluginI18nextExtractor(pluginOptions: PluginI18nextExtractorOptions): RsbuildPlugin;
+//# sourceMappingURL=pluginI18nextExtractor.d.ts.map

package/dist/pluginI18nextExtractor.js

@@ -0,0 +1,71 @@
+import { createRequire } from 'node:module';
+import { logger } from '@rsbuild/core';
+import { I18nextExtractorWebpackPlugin } from './I18nextExtractorWebpackPlugin.js';
+import { resolveLocalesDir } from './utils.js';
+const require = createRequire(import.meta.url);
+/**
+ * A Rsbuild plugin for extracting i18n translations using i18next-cli.
+ *
+ * This plugin automatically scans your source code for i18n translation keys
+ * and extracts only used keys from your locale files. This helps reduce
+ * bundle size by only including translations that are actually used in your code.
+ *
+ * @example
+ * ```ts
+ * // rsbuild.config.ts
+ * import { defineConfig } from '@rsbuild/core'
+ * import { pluginI18nextExtractor } from 'rsbuild-plugin-i18next-extractor';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     pluginI18nextExtractor({
+ *       localesDir: './locales'
+ *     })
+ *   ],
+ * })
+ * ```
+ *
+ * @public
+ */
+export function pluginI18nextExtractor(pluginOptions) {
+    return {
+        name: 'rsbuild:i18next-extractor',
+        setup(api) {
+            validateOptions(pluginOptions);
+            const { localesDir, i18nextToolkitConfig, onKeyNotFound } = pluginOptions;
+            api.modifyBundlerChain((chain) => {
+                // Add a rule to replace locale JSON imports with a placeholder
+                chain.module
+                    .rule('i18next-extractor:i18n-translations-replacement')
+                    .test(/\.json$/)
+                    .type('javascript/auto')
+                    .include.add(resolveLocalesDir(api.context.rootPath, localesDir))
+                    .end()
+                    .use('i18n-translations-replacement')
+                    .loader(require.resolve('./loader.js'))
+                    .options({ localesDir })
+                    .end()
+                    .end()
+                    .end()
+                    .plugin(I18nextExtractorWebpackPlugin.name)
+                    .use(I18nextExtractorWebpackPlugin, [
+                    {
+                        localesDir,
+                        i18nextToolkitConfig,
+                        onKeyNotFound,
+                        logger,
+                    },
+                ])
+                    .end();
+            });
+        },
+    };
+}
+function validateOptions(pluginOptions) {
+    if (!pluginOptions ||
+        !pluginOptions.localesDir ||
+        pluginOptions.localesDir.trim() === '') {
+        throw new Error('[rsbuild-plugin-i18next-extractor] The "localesDir" option is required.');
+    }
+}
+//# sourceMappingURL=pluginI18nextExtractor.js.map

package/dist/utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Generate a variable name for storing extracted translations of a given locale.
+ *
+ * @example
+ * getLocaleVariableName('zh-CN') // Returns: '__I18N_ZH_CN_EXTRACTED_TRANSLATIONS__'
+ */
+export declare function getLocaleVariableName(locale: string): string;
+/**
+ * Get list of locales from the locales directory.
+ *
+ * Locales are determined by JSON files in the directory.
+ */
+export declare function getLocalesFromDirectory(rootDir: string, localesDir: string): string[];
+/**
+ * Resolve the absolute path to the locales directory.
+ *
+ * If the locales directory is already absolute, returns it as-is.
+ * Otherwise, resolves it relative to the root directory.
+ */
+export declare function resolveLocalesDir(rootDir: string, localesDir: string): string;
+/**
+ * Resolve the absolute path to a specific locale's JSON file.
+ *
+ * @param localesDir - The locales directory (absolute or relative)
+ * @param locale - The locale identifier (e.g., 'zh-CN', 'en')
+ * @param rootDir - The root directory for resolving relative paths
+ * @returns The absolute path to the locale JSON file
+ */
+export declare function resolveLocaleFilePath(localesDir: string, locale: string, rootDir: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.js

@@ -0,0 +1,49 @@
+import { readdirSync } from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Generate a variable name for storing extracted translations of a given locale.
+ *
+ * @example
+ * getLocaleVariableName('zh-CN') // Returns: '__I18N_ZH_CN_EXTRACTED_TRANSLATIONS__'
+ */
+export function getLocaleVariableName(locale) {
+    return `__I18N_${locale.toUpperCase().replaceAll('-', '_')}_EXTRACTED_TRANSLATIONS__`;
+}
+/**
+ * Get list of locales from the locales directory.
+ *
+ * Locales are determined by JSON files in the directory.
+ */
+export function getLocalesFromDirectory(rootDir, localesDir) {
+    const files = readdirSync(resolveLocalesDir(rootDir, localesDir), {
+        withFileTypes: true,
+    });
+    return files
+        .filter((file) => !file.isDirectory() && file.name.endsWith('.json'))
+        .map(({ name: filename }) => filename.replace('.json', ''));
+}
+/**
+ * Resolve the absolute path to the locales directory.
+ *
+ * If the locales directory is already absolute, returns it as-is.
+ * Otherwise, resolves it relative to the root directory.
+ */
+export function resolveLocalesDir(rootDir, localesDir) {
+    return path.isAbsolute(localesDir)
+        ? localesDir
+        : path.resolve(rootDir, localesDir);
+}
+/**
+ * Resolve the absolute path to a specific locale's JSON file.
+ *
+ * @param localesDir - The locales directory (absolute or relative)
+ * @param locale - The locale identifier (e.g., 'zh-CN', 'en')
+ * @param rootDir - The root directory for resolving relative paths
+ * @returns The absolute path to the locale JSON file
+ */
+export function resolveLocaleFilePath(localesDir, locale, rootDir) {
+    return path.join(path.isAbsolute(localesDir)
+        ? localesDir
+        : path.resolve(rootDir, localesDir), `${locale}.json`);
+}
+//# sourceMappingURL=utils.js.map

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "rsbuild-plugin-i18next-extractor",
+  "version": "0.1.0",
+  "description": "A Rsbuild plugin for extracting i18n translations using i18next-cli",
+  "keywords": [
+    "rsbuild",
+    "rspack",
+    "i18n",
+    "i18next",
+    "i18next-cli",
+    "extractor"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Hengchang Lu",
+    "email": "luhengchan228@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rspack-contrib/rsbuild-plugin-i18next-extractor.git"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check .",
+    "lint:write": "biome check . --write"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "npm run lint:write"
+  },
+  "dependencies": {
+    "i18next-cli": "1.33.5",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.9",
+    "@playwright/test": "^1.50.0",
+    "@rsbuild/core": "^1.6.15",
+    "@types/node": "^22.10.2",
+    "i18next": "25.7.3",
+    "simple-git-hooks": "^2.13.1",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.16"
+  },
+  "peerDependencies": {
+    "@rsbuild/core": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "packageManager": "pnpm@10.15.0"
+}