CHANGELOG.md
February 11, 2026 ยท View on GitHub
Version 5
5.27.1 (2026-02-11)
Bug Fixes
- updated repository information for npm provenance statement (c0594de)
5.27.0 (2026-02-11)
Features
- add support for bun lockfile (f86912c)
Documentation
- add tribute to Ivan Hofer, creator of typesafe-i18n (0225d07)
5.26.1 (2023-08-14)
Fix:
- recompute
LLobject after callingsetLocalein adapter-react #721
5.26.0 (2023-08-01)
Feat:
- improved plural rules support for polnish #672
5.25.1 (2023-07-20)
Fix:
- replace
lodash.mergewithjust-extend"
5.25.0 (2023-07-18)
Feat:
- add support for
TypeScript>5.1
5.24.4 (2023-07-10)
Fix:
- avoid recomputing react context #684
5.24.3 (2023-03-26)
Fix:
- correctly inject
typesafe-i18nscript inpackage.jsonif block contains brackets #631
5.24.2 (2023-03-02)
Fix:
extendDictionaryfunctionality to not mutate original object #618
5.24.1 (2023-02-13)
Fix:
- make exporter work on
windowsagain #600 - indentation of generated namespace function
5.24.0 (2023-02-05)
Feature:
- add
denoadapter
5.23.2 (2023-02-05)
Fix:
utilspackage
5.23.1 (2023-02-05)
Fix:
- add missing
package.exports
5.23.0 (2023-02-04)
Feature:
- add
extendDictionaryfunctionality
5.22.0 (2023-02-04)
Feature:
- use
satisfiesoperator where possible
5.21.0 (2023-01-30)
Feature:
- run
runAfterGeneratorhook when using theimporter#579
5.20.0 (2023-01-18)
Feature:
- expose
experimentalParseMessageandexperimentalSerializeMessagefunctionality from'typesafe-i18n/parser'
5.19.1 (2023-01-17)
Fix:
- actually publish
configfolder
5.19.0 (2023-01-17)
Feature:
- expose
getConfigandgetLocaleInformationfunctionality from'typesafe-i18n/config'
5.18.0 (2022-12-22)
Feature:
- allow to have strings with a comma inside switch-case statements #548
5.17.2 (2022-12-18)
Bugfix:
- react
JSDocoutput
5.17.1 (2022-11-28)
Fix:
- type-import for vue adapter
5.17.0 (2022-11-25)
Feature:
- better esm support
Fix:
5.16.3 (2022-11-08)
Fix:
- types for TypeScript moduleResolution 'Node16'
5.16.2 (2022-11-02)
Fix:
- generator esm imports
5.16.1 (2022-11-01)
Fix:
- generating types for namespaces when
outputFormatis set toJavaScript#491
5.16.0 (2022-11-01)
Feature:
- make generator faster by improving the speed of the TypeScript compilation process
5.15.0 (2022-10-19)
Feature:
- use type predicates for
isLocaleandisNamespaceutility functions #475 Fix: - add ReturnTypes to generated functions to prevent TypeScript performance issues
5.14.0 (2022-09-29)
Feature:
- mask original text in
Translationsentries to not show up in search result while keeping the same hover behavior #453
5.13.1 (2022-09-26)
Fix:
- make accept-language-header detector case insensitive #451
5.13.0 (2022-09-14)
Feature:
- add
isLocaleandisNamespaceutility functions
5.12.0 (2022-08-17)
Feature:
- don't require optional params in translations
5.11.0 (2022-07-28)
Feature:
- make generator faster by improving the speed of the TypeScript compilation process
5.10.1 (2022-07-28)
Fix:
- link correct types for React adapter
5.10.0 (2022-07-25)
Feature:
- break out translation imports into it's own functions #384
5.9.1 (2022-07-25)
Fix:
- exported type definitions
5.9.0 (2022-07-24)
5.8.1 (2022-07-24)
- internal package modifications
5.8.0 (2022-07-23)
Feature:
- auto-setup
vueadapter forNuxt.jsapplications
5.7.0 (2022-07-16)
Feature:
- allow to set multiple
adapters#375
5.6.0 (2022-07-05)
Feature:
- detect locale from request's
hostname
5.5.2 (2022-06-05)
5.5.1 (2022-06-01)
Fix:
- bundle 'svelte/store' together with cjs output
5.5.0 (2022-05-29)
- replace
watchlistwithchokidar#314
5.4.3 (2022-05-15)
Fix:
- update
childrentypes for Solid adapter
5.4.2 (2022-04-29)
Bugfix:
- buffer overflow on windows when using namespaces
- also trigger generator initially when starting watcher
5.4.1 (2022-04-28)
Fix:
- documentation
5.4.0 (2022-04-18)
- replace
chokidarwithwatchlist
5.3.6 (2022-04-12)
Fix:
- update state with
batchinside solid adapter
5.3.5 (2022-04-10)
Fix:
- avoid recomputing SolidJS children #267
5.3.4 (2022-04-09)
Fix:
- make generated types compatible with 'strictNullChecks: false'
- use
React.ReactNodeinstead ofReact.ReactElement
5.3.3 (2022-04-08)
Fix:
- add
childrento the type definitions of the react component #263
5.3.2 (2022-04-05)
5.3.1 (2022-04-05)
Fix:
- improve loading locale and namespace in parallel
5.3.0 (2022-04-04)
Feature:
- allow loading locale and namespace in parallel
Fix:
- remove unnecessary comma on JSDoc type definitions
5.2.3 (2022-04-01)
Bugfix:
- generation of hints when text contains comment-end-marker
5.2.2 (2022-03-28)
Fix:
- add reactivity to solid adapter
5.2.1 (2022-03-27)
Fix:
- for generating wrong destructuring code for react adapter
5.2.0 (2022-03-27)
Feature:
- add
solidadapter #193
5.1.2 (2022-03-26)
Fix:
- merge definitions correctly if argument and switch-case get used in the same sentence
5.1.1 (2022-03-26)
Bugfix:
- don't show TypeScript related Error message when using
JSDocsyntax
5.1.0 (2022-03-26)
Fix:
- load all locales before initialization of node adapter
Breaking: (will be auto-fixed by running the generator again)
- rename the adapter exports
5.0.1 (2022-03-23)
Fix:
- hint in setup prompts should mention
.mjsinstead of.js
5.0.0 (2022-03-23)
Please visit the release post for more information.
Feature:
- add
typesafeI18nStringandtypesafeI18nObjectfunctionality #88
BREAKING:
- remove functionality to run the generator via a
rollupplugin - remove functionality to run the generator via a
webpackplugin
Version 4
4.5.0 (2022-03-21)
Feature:
- expose the list of available
namespacesini18n-util.ts
4.4.2 (2022-03-12)
Bugfix:
- fix
importergenerating.mjsimports
4.4.1 (2022-03-11)
Bugfix:
- fix
exporter
4.4.0 (2022-03-11)
Bugfix:
- fix generation of types when using the
importerfeature
4.3.6 (2022-03-11)
Fix:
- show error message if
BaseTranslationgets not imported from the generatedi18n-typesfile
4.3.5 (2022-03-04)
Fix:
- allow to load only namespaces #189
4.3.4 (2022-03-02)
Fix:
- possible timeout fix for
runAfterGeneratorhook #185
4.3.3 (2022-03-02)
Fix:
- mock
Requesttype fromexpressfor detectors
4.3.2 (2022-03-01)
4.3.1 (2022-03-01)
Fix:
- refactor
RequiredParamsto not use// @ts-ignorecomments
4.3.0 (2022-02-26)
Feature:
- use generic
RequiredParamstype instead of creating it for each params-permutation
4.2.2 (2022-02-23)
Fix:
- add missing await on writes of new files
4.2.1 (2022-02-23)
Fix:
- remove double slash ('//') from generator logs
4.2.0 (2022-02-22)
Feature:
- provide a
runAfterGeneratorhook #185
4.1.5 (2022-02-17)
4.1.4 (2022-02-17)
Fix:
- remove sourcemaps from generated bundle #179
4.1.3 (2022-02-16)
Bugfix:
- fix
importercreating incorrect translations
4.1.2 (2022-02-15)
Bugfix:
- generate valid types for uncommon identifiers #177
4.1.1 (2022-02-11)
Bugfix:
- translation breaks with key called name
name#170
4.1.0 (2022-02-11)
Feature:
- add
namespacessupport forimporterandexporter
4.0.0 (2022-02-07)
Please visit the release post for more information.
Feature:
- add 'namespaces' functionality #113
BREAKING:
- if you have a
index-file in a subfolder of your translation files, it will be treated as anamespace
Version 3
3.1.3 (2022-02-07)
Bugfix:
- fix react adapter
3.1.2 (2022-02-04)
3.1.1 (2022-02-01)
Fix:
- missing index.d.ts in importer #167
3.1.0 (2022-02-01)
Feature:
- allow iterating over arrays defined in the dictionary
- render an empty string, if key is not valid
3.0.0 (2022-01-29)
Please visit the release post for more information.
BREAKING:
- locales have to be loaded in a separate step
- remove
loadLocalesAsyncoption from generator - formatters have to be initialized synchronously
closes:
Version 2
2.60.2 (2022-01-28)
Fix:
- revert changes made to fallbackProxy #157
2.60.1 (2022-01-22)
Feature:
- add functionality to loop over arrays #152
2.59.0 (2022-01-18)
Feature:
- add support for JSON files #151
2.58.0 (2022-01-09)
Feature: add better support for monorepos #149
2.57.7 (2022-01-09)
- add troubleshoot section for jest issues #140
2.57.6 (2022-01-09)
- add troubleshoot section for installing issues #142
2.57.5 (2022-01-02)
- show sponsorship message after running the setup-process
2.57.4 (2021-12-28)
2.57.3 (2021-12-28)
2.57.2 (2021-12-28)
Fix:
- rename Vue.js exports
2.57.1 (2021-12-27)
Bugfix:
- fix CLI script
2.57.0 (2021-12-27)
Feature:
- add
vueadapter (for vue@3) #121
2.56.0 (2021-12-14)
Feature:
- support
pnpmas package manager when running the setup-cli #138
2.55.1 (2021-12-06)
Fix:
- fix type definition of TranslationFunction for Typescript > 4.5.x [#136][https://github.com/ivanhofer/typesafe-i18n/issues/136)
2.55.0 (2021-12-05)
Feature:
- add switch-case support #135
2.54.3 (2021-11-27)
Bugfix:
- fix Proxy-access #133
2.54.2 (2021-11-26)
Bugfix:
- fix Proxy-access for CJS projects #131
2.54.0 (2021-11-25)
- decrease bundle size by a few bytes by removing Angular proxy wrapping on general Proxy instances
2.53.2 (2021-11-24)
Fix:
BaseTranslationtype for TypeScript version < 4.4.x #127
2.53.0 (2021-11-24)
Feature:
- expose
parserfunction
2.52.2 (2021-11-20)
Fix:
- add
$schemato json schema definition
2.52.1 (2021-11-19)
Fix:
- detect if project uses
npmoryarnon CLI setup process
2.52.0 (2021-11-18)
Feature:
- add validation of config #112
2.51.1 (2021-11-17)
Feature:
- add support for arrays #123
2.50.1 (2021-11-12)
Bugfix:
- fix CLI setup
2.50.0 (2021-11-12)
- upgrade to node 16
Fix:
- default export of generated Locale template file for SvelteKit
2.49.4 (2021-11-07)
Fix:
- don't run the generator on CLI setup; show info instead
2.49.3 (2021-11-06)
Bugfix:
- add
typescriptas peer dependency
2.49.2 (2021-11-06)
Bugfix:
- include
chokidarinto bundle
2.49.1 (2021-11-06)
Fix:
- SvelteKit workaround for
esmModulesetup detection
2.49.0 (2021-11-06)
Feature:
- setup CLI
2.48.0 (2021-11-01)
Feature:
- create typesafe-i18n
CLI
2.47.0 (2021-10-31)
Feature:
- add option to prevent type updates when importing translations
2.46.8 (2021-10-29)
Bugfix:
- wrap translation with correct characters #114
2.46.7 (2021-10-25)
Fix:
- expose type
LocaleMappinginsideimporterandexporter
2.46.6 (2021-10-25)
Bugfix:
- fix
typescriptimport insideimporterandexporter
2.46.5 (2021-10-24)
Fix:
- change everything to relative imports so types are resolved correctly
2.46.4 (2021-10-19)
Bugfix:
- fix import path for windows/other and esm/cjs matrix
2.46.3 (2021-10-19)
Bugfix:
- wrap imported keys with string #110
2.46.2 (2021-10-19)
Fix:
- show warning when trying to import empty locale
- expose
importerandexporterasesmandcjsmodule
2.46.1 (2021-10-19)
Bugfix:
- fix import path on windows #108
2.46.0 (2021-10-18)
Feature:
- add
exporterfeature [#106](https://github.com/ivanhofer/typesafe-i18n/issues/106
2.45.0 (2021-10-16)
Feature:
- reduce size of
i18n(L) by removing unnecessary Error message
2.44.3 (2021-10-15)
Fix:
- detect changes to base translation when using outputFormat: 'JavaScript' #105
2.44.2 (2021-10-14)
Bugfix:
- generate types for
importer
2.44.1 (2021-10-14)
Fix:
- fix variable declaration of
JavaScriptlocale template to be able to display type errors
2.44.0 (2021-10-14)
Feature:
- export generator as
esmmodule to make it compatible withSvelteKitinJavaScriptmode
2.43.1 (2021-10-14)
Fix:
- actually include
importerinnpmpackage
2.43.0 (2021-10-12)
Feature:
- add
importerfeature [#69](https://github.com/ivanhofer/typesafe-i18n/issues/69
2.42.0 (2021-10-02)
Breaking:
- get rid of
localesas generator-config
2.41.0 (2021-10-02)
Feature:
- add support for optional parameters [#86](https://github.com/ivanhofer/typesafe-i18n/issues/86
2.40.2 (2021-09-26)
- show link to
config-README on first start of thegenerator
2.40.1 (2021-09-22)
2.40.0 (2021-09-22)
Feature:
- add angular adapter
- add full
esmsupport for adapters
2.39.1 (2021-09-15)
Bugfix:
- fix import folders when using
esmsupport
2.39.0 (2021-09-15)
Feature:
- add full
esmsupport #80
2.38.0 (2021-09-14)
Feature:
- throw an Error when generator detects wrong input syntax when running with
--no-watchoption
2.37.4 (2021-08-26)
Bugfix:
- correctly detect changes in files imported by
[baseLocale]/index.ts#76
2.37.3 (2021-08-25)
Bugfix:
- allow to generate base files if base locale is not present yet
2.37.2 (2021-08-25)
Fix:
- import path of types for
timeformatter
2.37.1 (2021-08-25)
Fix:
- generate unique argument types for
Formatterstype #75
2.37.0 (2021-08-24)
Feature:
- allow to import files to the base locale file from outside of the base locale folder location
2.36.1 (2021-08-21)
Fix:
- mark
chokidaras dev dependency #73
2.36.0 (2021-07-27)
Fix:
- fix all 'esm' and 'cjs' imports to include file ending
2.35.3 (2021-07-26)
Fix:
- export files from 'cjs' folder as
.cjsfiles
2.35.2 (2021-07-26)
Fix:
- export files from 'esm' folder as
.mjsfiles
2.35.1 (2021-07-19)
Bugfix:
- remove
browserproperty frompackage.jsonto support older Angular versions
2.35.0 (2021-07-19)
Feature:
- add option to generate type-safe JavaScript code trough JSDoc annotations
Readme:
- add polyfill info
2.34.0 (2021-07-15)
Feature:
- add support for Angular's Proxy implementation
2.33.0 (2021-07-09)
Feature:
- add
LocalizedStringto known types
2.32.3 (2021-07-07)
2.32.2 (2021-07-07)
2.32.1 (2021-07-07)
Bugfix:
- fix
esmoutput forreactadapter
2.32.0 (2021-07-01)
Fix:
- make formatters tree-shakeable
- make detectors tree-shakeable
2.31.0 (2021-06-30)
Feature:
- output formatters as
cjsandesmmodule
2.30.1 (2021-06-28)
Fix:
- show translations on first render for sync react adapter
2.30.0 (2021-06-25)
Feature:
- output svelte adapter as
cjsandesmmodule
Fix:
- fix
cjsandesmimport mappings
2.29.0 (2021-06-25)
Feature:
- output react adapter as
cjsandesmmodule
2.28.0 (2021-06-25)
Feature:
- add
--no-watchoption to generator node process
2.27.0 (2021-06-18)
Feature:
- make
TranslationFunctionsreturn aLocalizedString - add
banneroption to make it possible to disable linting not just for ESLint
2.26.3 (2021-06-07)
Fix:
- fix react adapter #49
2.26.2 (2021-06-07)
Fix:
- fix wrong types for react and svelte adapters
2.26.1 (2021-06-07)
Fix:
- temporary fix for wrong tsc compilation for react and svelte adapters
- correctly set formatter path for react adapter
2.26.0 (2021-06-07)
Feature:
- add support for nested translation keys
- show colorized error-output in console
Fix:
- don't generate types when validation failed
Breaking:
- translation keys can't contain the '.' character
Other:
- don't generate type
TranslationKeysanymore
2.25.0 (2021-05-27)
- rename
watchertogenerator
2.24.1 (2021-05-25)
Fix:
- inlude
detectorsfiles in npm package
2.24.0 (2021-05-25)
Feature:
- add locale-detection feature
2.23.2 (2021-05-19)
Fix:
- use correct file extension when generating react context
2.23.1 (2021-05-19)
Fix:
- fix path for generating schema file
2.23.0 (2021-05-19)
- better type-definitions for formatter functions
2.22.0 (2021-05-16)
Feature:
- add generateOnlyTypes option
- add identity formatter
- add ignore formatter
Readme:
- create FAQ section
Fix:
- wrap types of Formatters in a
stringto be able to use any kind of formatter name
2.21.1 (2021-05-15)
Fix:
- mark
chokidaras peer dependency
2.21.0 (2021-05-15)
Fix:
- explicitly type parameter
localeininitFormattersfunction
2.20.1 (2021-05-13)
Fix:
- use path with implicit version for
"$schema"in./typesafe-i18n.jsonbecause redirects are not valid for json schemas
2.20.0 (2021-05-13)
Feature:
- add json-schema for
./typesafe-i18n.jsonconfig file
Examples:
- update dependencies
2.19.1 (2021-05-11)
- update dependencies
Bugfix:
- better types for
TranslationFunctions
2.19.0 (2021-05-07)
Fix:
- remove
.toString()functionality #27
2.18.0 (2021-04-30)
Feature:
- add support for plural rule
{{zero|one|other}}
Fix:
- detect
0and'0'always as'zero'instead of'other'
2.17.4 (2021-04-27)
Examples:
- update to latest
typesafe-i18nversion
2.17.3 (2021-04-27)
Fix:
- mark node script as node executable
2.17.2 (2021-04-26)
Examples:
- update to latest
typesafe-i18nversion
2.17.1 (2021-04-26)
Fix:
- run watcher via
bin-field inpackage.json#30
2.17.0 (2021-04-26)
Feature:
- add unix support for watcher #29
2.16.1 (2021-04-23)
- add CHANGELOG file
Fix:
- add deprecation message for
.toString()functionality #27
2.16.0 (2021-04-17)
Features:
- add webpack plugin to run watcher in development mode
Bugfix:
- log watcher-options on startup
2.15.5 (2021-04-13)
Readme:
- better describe watcher node-process as fallback for users without supported bundlers
2.15.4 (2021-04-09)
Examples:
- update to latest
typesafe-i18nversion
2.15.3 (2021-04-09)
Fix:
- remove a unecessary semicolumn from generated output
2.15.2 (2021-04-09)
- update dependencies
2.15.1 (2021-04-02)
- upload generated browser bundles as GitHub Action artifact
2.15.0 (2021-04-02)
Feature:
- allow to include only selected locales into generated bundle using the rollup-plugin
Fix:
- use
baseLocalevariable as fallback instead of plain string representation insidei18n-util.ts
Readme:
- better describe
localesoption from production bundles
2.14.2 (2021-03-26)
Bugfix:
- correctly type
initI18nStringinsidei18n-util.ts
2.14.1 (2021-03-24)
Readme:
- describe
toStringfunctionality usingi18nObject(LL)
2.14.0 (2021-03-24)
Feature;
- add
toStringfunctionality toi18nObject(LL)
2.13.2 (2021-03-23)
Readme:
- update size information
2.13.1 (2021-03-23)
Readme:
- fix intendation
2.13.0 (2021-03-23)
Feature:
- refactor
typesafe-i18nreact-component
Security:
- update dependencies
2.12.2 (2021-03-19)
Examples:
- fix intendation and syntax-highlighting in react README
2.12.1 (2021-03-19)
Readme:
- better describe
rollup-plugin-typesafe-i18n
Examples:
- describe how to use with JavaScript in react README
2.12.0 (2021-03-17)
Feature:
- rewrite react adapter using a component instead of hook
2.11.1 (2021-03-17)
Fix:
- use wattcher or optimizer rollup plugin depending on rollup environment
2.11.0 (2021-03-17)
Feature:
- add react JavaScript adapter
2.10.3 (2021-03-17)
Fix:
- generate async
i18nStringwrapper insidei18n-utils.ts
2.10.2 (2021-03-16)
Examples:
- fix intendation in react README
2.10.1 (2021-03-16)
Examples:
- add react example
2.10.0 (2021-03-16)
Feature:
- add react TypeScript adapter
2.9.2 (2021-03-14)
Readme:
- improve screenshots by cropping VS Code frame
2.9.1 (2021-03-14)
Readme:
- highlight possible improvements
2.9.0 (2021-03-14)
Feature:
- remove argument-types inside translations for production-bundle #13
Examples:
- fix labels in svelte example
2.8.3 (2021-03-14)
Examples:
- update to latest
typesafe-i18nversion
2.8.2 (2021-03-14)
Fix:
- import svelte adapter from correct file
2.8.1 (2021-03-14)
Fix:
- export svelte JavaScript adapter
2.8.0 (2021-03-14)
Feature:
- generate async formatters initializer
Fix:
- rename exported functions
2.7.1 (2021-03-10)
Readme:
- decrease gif file size
2.7.0 (2021-03-08)
Fix:
- reduce bundle size by inlining functions from
typesafe-utils
2.6.11 (2021-03-06)
Readme:
- fix formatter example
2.6.10 (2021-03-05)
Readme:
- add status badges
2.6.9 (2021-03-03)
Readme:
- highlight advantages
- add table of contents
- add performance section
2.6.8 (2021-03-03)
Readme:
- improvements
2.6.7 (2021-03-01)
Readme:
- improvements
2.6.6 (2021-03-01)
Readme:
- increase font size of images
2.6.5 (2021-03-01)
Fix:
- export svelte store from adapters subpath
2.6.4 (2021-02-28)
Readme:
- increase font size of images
2.6.3 (2021-02-28)
Readme:
- add gif demonstrating typesafety
2.6.2 (2021-02-28)
Readme:
- link images to correct raw file
2.6.1 (2021-02-28)
Readme:
- add images demonstrating typesafety
2.6.0 (2021-02-28)
Feature:
- allow first part to be plural part when using keyed arguments
2.5.0 (2021-02-28)
Feature:
- allow translations with only plural part
2.4.1 (2021-02-24)
Readme:
- specify minimum Node.js version
2.4.0 (2021-02-24)
Examples:
- add browser example
- describe how to use with JavaScript in svelte README
2.3.0 (2021-02-23)
Feature:
- export svelte JavaScript store
Readme:
- improvements
2.2.5 (2021-02-23)
Fix:
- add export maps for svelte adapter
Examples:
- add Node.js readme
2.2.4 (2021-02-22)
Examples:
- add Node.js example
2.2.3 (2021-02-22)
Feature:
- export base locale in
i18n-utils.ts
Fix:
- improve Node.js adapter
2.2.2 (2021-02-22)
Examples:
- update svelte-Example
2.2.1 (2021-02-22)
Examples:
- move svelte documentation to svelte example
2.2.0 (2021-02-22)
Feature:
- use base locale as fallback if wrong locale was passed during initialization
2.1.0 (2021-02-19)
Feature:
- add Node.js adapter
- add possibility to define different adapters
- allow to rename adapter file name
2.0.5 (2021-02-19)
Examples:
- add readme for svelte example
2.0.4 (2021-02-17)
Examples:
- add svelte example
2.0.3 (2021-02-17)
Bugfix:
- dont throw Error when
setLocaleis called beforeinitin svelte-adapter
2.0.2 (2021-02-16)
Bugfix:
- correctly set current selected locale in svelte store
- add possibility to output svelte as synchronous store
2.0.1 (2021-02-16)
Bugfix:
- fix synchronous output of
i18n-utils.ts
2.0.0 (2021-02-16)
- initial release of project under
typesafe-i18nname