test: verify various typescript configurations

[reduckted]

Summary

This pull request adds an npm script called verify-typescript that will attempt to compile some TypeScript projects with different configurations that use DOMPurify.

Background & Context

See #1035 and #1073. It's easy to make a change to the TypeScript declarations and verify that it works for one or more configurations, but end up breaking another configuration. The goal of this change is to have a set of known TypeScript configurations that work. If we discover that another configuration doesn't work, then we can add the configuration to these tests and then go about fixing the TypeScript declarations to support that configuration, while also verifying that whatever change is made doesn't break any other configurations that we know about.

The TypeScript code in each project is not meant to be comprehensive. It is just enough to confirm that you can import from dompurify and call the functions.

• Importing dompurify verifies that the export is correct, and that the type declarations for trusted-types works alongside dompurify.
• Calling the functions verifies that the value imported from dompurify is a function that creates a new DOMPurify instance, and that it also defines the sanitize function.

There are currently seven scenarios:

1. A standard CommonJS build.
2. A CommonJS build that specifies specific types to include. Notably, trusted-types is not one of them (this was actually what caused Compile of Angular app not possible since update to v3.2.x #1035 (comment)
3. A CommonJS build that specifies a typeRoots to simulate not having @types/trusted-types installed.
4. A standard ESM build.
5. An ESM build that specifies specific types to include (and, like the CommonJS one does not include trusted-types)
6. An ESM build that specifies a typeRoots to simulate not having @types/trusted-types installed.
7. A moduleResolution of nodenext.

All of these projects compile successfully, and I have tried applying the change from #1073 and confirmed that it does result in compilation failures. 🎉

Example output when all succeed:

> npm run verify-typescript

> [email protected] verify-typescript
> node ./typescript/verify.js

Installing node modules...

✔ commonjs   
✔ commonjs-with-no-types   
✔ commonjs-with-specific-types   
✔ esm   
✔ esm-with-no-types   
✔ esm-with-specific-types   
✔ nodenext   

Example output when there are failures (in this case I applied the changes from #1073):

> npm run verify-typescript

> [email protected] verify-typescript
> node ./typescript/verify.js

Installing node modules...

✔ commonjs   
X commonjs-with-no-types   
     C:/Code/GitHub/cure53/DOMPurify/dist/purify.cjs.d.ts (171,28): Cannot find name 'TrustedTypePolicy'.
     C:/Code/GitHub/cure53/DOMPurify/dist/purify.cjs.d.ts (246,9): Cannot find name 'TrustedHTML'.
     C:/Code/GitHub/cure53/DOMPurify/dist/purify.cjs.d.ts (436,34): Property 'trustedTypes' does not exist on type 'Window & typeof globalThis'.
X commonjs-with-specific-types   
     C:/Code/GitHub/cure53/DOMPurify/dist/purify.cjs.d.ts (171,28): Cannot find name 'TrustedTypePolicy'.
     C:/Code/GitHub/cure53/DOMPurify/dist/purify.cjs.d.ts (246,9): Cannot find name 'TrustedHTML'.
     C:/Code/GitHub/cure53/DOMPurify/dist/purify.cjs.d.ts (436,34): Property 'trustedTypes' does not exist on type 'Window & typeof globalThis'.
✔ esm   
X esm-with-no-types   
     C:/Code/GitHub/cure53/DOMPurify/dist/purify.es.d.mts (171,28): Cannot find name 'TrustedTypePolicy'.
     C:/Code/GitHub/cure53/DOMPurify/dist/purify.es.d.mts (246,9): Cannot find name 'TrustedHTML'.
     C:/Code/GitHub/cure53/DOMPurify/dist/purify.es.d.mts (436,34): Property 'trustedTypes' does not exist on type 'Window & typeof globalThis'.
X esm-with-specific-types   
     C:/Code/GitHub/cure53/DOMPurify/dist/purify.es.d.mts (171,28): Cannot find name 'TrustedTypePolicy'.
     C:/Code/GitHub/cure53/DOMPurify/dist/purify.es.d.mts (246,9): Cannot find name 'TrustedHTML'.
     C:/Code/GitHub/cure53/DOMPurify/dist/purify.es.d.mts (436,34): Property 'trustedTypes' does not exist on type 'Window & typeof globalThis'.
✔ nodenext   

Tasks

N/A

Dependencies

N/A

[cure53]

This is amazing, thank you very much again 😄