TS: New typings inferior to former @types ones

Steps to reproduce

Tell us about your environment:

• Puppeteer version: 1.12
• Platform / OS version: Irrelevant
• URLs (if applicable):
• Node.js version: Irrelevant

What steps will reproduce the problem?

Please include code that reproduces the issue.

Update puppeteer 2. Check typings. 3. They are worse.

What is the expected result?

Typings should be at least at DT quality.

What happens instead?

• Various types have become Function
  • Callbacks in waitFor/evaluate-ish functions.
• Various types have come Object
  • Often incorrect such as jsonValue or json (should be ‘unknown’ instead)
  • Used instead of more precise dictonary object when used for headers and waitFor options.
• Various specific overloads are missing that make requires less type assertions.
  • See #3877

Both types should not be used as they are extremely broad.

FYI I consider this a breaking change as I cannot easily revert to DT typings without explicitly downgrading puppeteer, it also broke our builds.

[SimonSchick]

Going to be devils advocate: at this point I think it would be easiest to just port puppeteer to TS than invest further work into the types generator for adding overloads and such.

In the end every contributor needs to know TS to write the doctags anyways.

[SimonSchick]

See https://github.com/DefinitelyTyped/DefinitelyTyped/pull/32723, I added a few extra tests, should help you a bit.

Also, it seems your generated generated some interfaces multiple times, see PageMetricsPayload