unused-i18n v0.1.29

Unused i18n

Simplifies managing and cleaning up unused translation keys in localization files

Features

• Analyzes source files to identify used and unused translation keys.
• Supports multiple scoped translation functions.
• Can display or remove unused translation keys.
• Configurable through a JSON, CJS, or JS config file.

Installation

You can install unused-i18n via npm:

npm install -g unused-i18n

or

npm install -D unused-i18n

Configuration

Create a unused-i18n.config.json or unused-i18n.config.js file in the root of your project. Here's an example configuration:

module.exports = {
  paths: [
    {
      srcPath: ['src/pages/products'],
      localPath: 'src/pages/products/locales',
    },
  ],
  localesExtensions: 'ts',
  localesNames: 'en',
  scopedNames: ['scopedT', 'scopedTOne'],
  ignorePaths: ['src/pages/products/ignoreThisFolder'],
  excludeKey: ['someKey'],
}

Usage

Using with Config File

To use unused-i18n with your config file, simply run:

npx unused-i18n display

Using with Command Line Options

You can also specify the source and local paths directly in the command line:

Display Unused Translations

npx unused-i18n display --srcPath="src/folders/bla" --localPath="src/folders/bla/locales"

Remove Unused Translations

npx unused-i18n remove --srcPath="src/folders/bla" --localPath="src/folders/bla/locales"

API

processTranslations(paths, action) Processes translations based on the specified paths and action.

• paths: Array of objects containing srcPath and localPath.
• action: Action to perform, either 'display' or 'remove'.

Development

Building the Project

To build the project, run:

npm run build

Running Tests

To run the tests, use:

npm run test

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request if you have any improvements or suggestions.

Acknowledgements

• Vite - Next Generation Frontend Tooling.
• TypeScript - Typed JavaScript used in this project.
• Vitest - Testing framework used in this project.
• Commander - Node.js command-line interfaces.