43
Generate dts type definition for i18next json configuration file
I have some projects that need to use i18next to handle internationalization, but use typescript to have type definitions, so I used to maintain and use it in the project joplin-utils Yesterday I did a lot of refactoring, and now it has been pulled out and released as a public npm package. If anyone is interested, you can try it.
i18next's typescript type definition generator can generate type definitions from multiple language translation json files, supporting nested objects and parameters.
The type definition generation of the international configuration of cli itself is also done by cli (bootstrapping)
yarn add -D @liuli-util/i18next-dts-gen
i18next-dts-gen gen --input src/i18n # Scan this directory for json files and generate index.d.ts type definitionsDetail
$ i18next-dts-gen -h
Usage: bin [options]
Generate .d.ts type definitions from json
Options:
-i, --input <input...> Directory containing one or more translation files
-w, --watch Whether to use watch mode
-h, --help display help for commandWhy should I write this when there are already many third-party type definition generators, and even the latest version of i18next has an official typescript solution?
In short, they are not perfect.
Let's start with the official i18next solution, which replaces json files with ts files, but does not support parameters and nested objects.
Note: The latest version seems to take advantage of typescript 4.2's recursive types and template string types for type safety, but this doesn't actually work very well. Also only react-i18next is available.
- i18next typescript support
- StackOverflow type definition for i18next /58308279#58308279)
Then i18next-typescript, a third-party library, almost meets my needs, except for one thing: support for object parameters. There is also something like Jack Chicory's i18n-codegen, which is very elegant in code design, but again, does not support ecologies other than react.
Also, as far as I'm concerned, I think it's easier and more reasonable to use generators to generate simple types than to support such features from the type system.
No, only a subset of i18next is supported here.
- [ ] Object parameters are not supported
43