USVString type definition

[hasbel]

TypeScript Version: 3.2.0-dev.201xxxxx

Search Terms:
USVString

Code

function example(uri: USVString) {
    // Do some work
}

Expected behavior:
Until typescript version 3.0.3 USVString used to be an existing type defined in lib.dom.d.ts
in version 3.1, according to the breaking changes page, some vendor-specific types are removed from lib.d.ts, a full list of removed types is included.
USVString is not on that list, yet it's type definition was also removed.

USVString is defined under webIDL, as can be seen here.

Actual behavior:
error TS2304: Cannot find name 'USVString'.

[weswigham]

Our IDL-based generator just interprets USVString as an alias for string, because it effectively is. Do you still need a type USVString = string alias in the lib? The lib itself stopped using it because it was rather pointless.

[hasbel]

Some of our modules as well as some external NPM modules we are using need USVString as a type.

Even though I agree that it is rather pointless from a programming point of view as it just maps to a string, it serves a purpose as it gives developers useful informations about what is permissible.
And since it is also used by external libraries/modules that might not be updated any time soon, we need to manually remove it or declare it in those files as well (which is really not ideal).

furthermore, it is still defined by webIDL and the removal was not documented so figuring why some code suddenly refuses to compile might be a bit of a headache.

[weswigham]

Cc @DanielRosenwasser

[DanielRosenwasser]

Let's discuss in person tomorrow