utf8.encode fails to validate input

[ChALkeR]

Doc: https://www.stablelib.com/functions/_stablelib_utf8.encode.html

Encodes the given string into UTF-8 byte array. Throws if the source string has invalid UTF-16 encoding.

Contrary to the documentation, it doesn't work

> require('@stablelib/utf8').encode('\ud800') // ok
Uncaught Error: utf8: invalid string
> require('@stablelib/utf8').encode('\udfff') // fail
Uint8Array(3) [ 237, 191, 191 ]
> '\udfff'.isWellFormed()
false

[dchest]

Thanks! I don't think the documentation is correct: it was meant to say that it's possible that it throws, but it doesn't handle all invalid cases. Although I think it should.