docs: Note the new TS option for throwOnInvalid.

[CarsonF]

I am adding support for the invalid return types in the TypeScript definitions.
DefinitelyTyped/DefinitelyTyped#64995
With this I added a way to opt-in to the stricter types when throwOnInvalid is enabled.
I'm documenting this here for users, since we don't really have another documentation place.

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: CarsonF / name: Carson Full (84eb1c6)

[pvogel1967]

This doc is inadequate. Should be clear this should be in a local types/luxon/index.d.ts file and it should import { TSSettings } from 'luxon' to ensure the module declare here is merged with the main types module from DefinitelyTyped.

[CarsonF]

This doc is inadequate. Should be clear this should be in a local types/luxon/index.d.ts file and it should import { TSSettings } from 'luxon' to ensure the module declare here is merged with the main types module from DefinitelyTyped.

No this does not have to be in a locally configured "types" folder. It should be done in the same spot as you enable the runtime setting, as I thought the doc change communicated by being right under that runtime setting. That setting has to be executed early on in your application, and doing so means TS picks it up and includes it (merges the interface correctly).