npm / natural
natural
What changed in natural 3 to 8, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-13.
5 breaking1 behavior and defaults1 tooling3 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initnatural 86 changes
Breaking changes 2
Restricts silent S to ISL and YSL.
SoundEx initial characters are now treated literally.
Behavior and default changes 1
Storage plugins are lazy-loaded to avoid side effects on import.
Fixes and other changes 3
Fixes JaroWinklerDistance for single-character strings that differ in case.
TfIdf no longer looks up terms on document prototypes and caches terms.
Fixes the wrong transposition calculation in unrestricted damerau-levenshtein.
natural 61 changes
Tooling 1
TypeScript types were added to enable use of the library in TypeScript projects.
natural 41 changes
Breaking changes 1
Importing the Japanese stemmer now returns a newly created object.
natural 32 changes
Breaking changes 2
Some methods in the natural API were renamed to camel case, so developers may need to update calls to those methods.
Methods attached to native types have been removed, including attach from stemmers and tokenizers.