Type declarations and DocBlocks

[satyago]

Summary

Some of the classes / models do not contain type declarations.
Specifically model scopes and relationships are currently lacking argument and return types.
IMHO adding them would help to avoid breaking compatibility between updates and user land extensions.

Is there any reason the exposed methods (and otherwise) are currently open?
Is this a planned change?

Proposal

Maintain common DocBlocks, argument and return type hints on Laravel models as well as other classes.

Additional Notes

https://github.com/asantibanez/laravel-eloquent-state-machines/blob/master/src/Models/StateHistory.php
https://github.com/asantibanez/laravel-eloquent-state-machines/blob/master/src/Models/PendingTransition.php
[...]

[asantibanez]

Hi @satyago

Thanks for your interest in the package.

The API is stable at the moment. No plans on changing the behavior unless it is a major version bump.

Would you mind doing a PR with the referred doc blocs?

Thanks