Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
feat: unless the user supplies their own
object
typepreferredTypes
, preferobject
for plain objects and otherwise preferObject<>
; fixes #800I'm not yet convinced we're ready for #834 , but in anticipation of a likely future change, I think we should go ahead and enforce the best compatibility with TypeScript now even for plain jsdoc users.
Now admittedly, TypeScript has an issue to change things to support equivalent behavior for either form when within JSDoc, but regardless, it seems that it is better for us to enforce operating in a manner closer to how TypeScript is to behave (that
Object
is discouraged in plain form andobject
is the more basic type allowing forObject.create(null)) and how it makes sense to behave (if one JSDoc type is allowed then
Object` seems more like a generic-friendly form).