fix: typescript definition

[yenshih]

This PR contains a:

• bugfix
• new feature
• code refactor
• test update
• typo fix
• metadata update

Motivation / Use-Case

Better TypeScript definition base on control flow analysis for assertions:
microsoft/TypeScript#32695

const loader: Loader = function(source) {
    const options = getOptions(this) || {};

    // typeof options --> OptionObject

    validate<SpecificLoaderOptions>(schema, options);

    // typeof options --> SpecificLoaderOptions
};

Breaking Changes

Additional Info

[codecov]

Codecov Report

Merging #73 into master will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master      #73   +/-   ##
=======================================
  Coverage   98.59%   98.59%           
=======================================
  Files           5        5           
  Lines         568      568           
  Branches      255      255           
=======================================
  Hits          560      560           
  Misses          8        8

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update f38158d...b30f184. Read the comment docs.

[alexander-akait]

/cc @vankop Can you look?

[alexander-akait]

Oh, it is only for typescript@3.7 (not released yet)

[vankop]

this is great approach, but as @evilebottnawi said already it is for future typescript release

[yenshih]

Yes, typescript@3.7 will be released in 2 weeks. We need to prepare for that. I'm using typescript@rc for now.
microsoft/TypeScript#33352

[yenshih]

https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-7.html
ping @evilebottnawi :)

[vankop]

declaration now works with JS files 🤩 PR to core webpack confirmed =)

[alexander-akait]

/cc @yenshih can you put this using JSDoc? Now we generate declarations from JSDoc, anyway thanks for the PR

[yenshih]

It's fine :)
However, asserts is an advanced feature of TypeScript. I have no idea how to use asserts in JSDoc.

[vankop]

It works same way as in ts files

[alexander-akait]

@vankop can you take care?

[vankop]

@evilebottnawi later, maybe on the weekend