core(cmd) : Improve cmd class PHPDoc

[kwizer15]

Documentation PHPDoc de la classe cmd

Description

Cette PR standardise la documentation PHPDoc de la classe cmd (cmd.class.php).
Aucun changement fonctionnel n'est effectué.

Note : Les types documentés sont basés sur l'analyse statique du code. Il est possible que certains types soient incomplets ou imprécis, notamment pour les valeurs de retour complexes ou les tableaux associatifs. N'hésitez pas à signaler toute erreur ou imprécision dans les types documentés pour améliorer la qualité de la documentation. Les retours d'expérience sur l'utilisation réelle des méthodes sont particulièrement appréciés pour affiner la documentation.

Merci de créer de commenter directement cette PR si vous constatez des erreurs ou avez des suggestions d'amélioration.

Points clés

• Documentation complète des classes et méthodes avec types stricts
• Documentation précise des types de retour
• Spécification des dépendances entre les composants via @see
• Respect des standards de documentation Jeedom

Suggested changelog entry

• Added standardized PHPDoc documentation for cmd class

Related issues/external references

https://github.com/jeedom/documentations/blob/89cf4578ad04b59abebe40217b6cfdf0dacc195e/fr_FR/dev/php/phpdoc.md
https://community.jeedom.com/t/aide-phpdoc-du-core/63287

Types of changes

• Bug fix
• New feature
• Breaking change
• Documentation improvement

PR checklist

• I have checked there is no other PR open for the same change
• I have read the contribution guidelines for this project
• I grant the project the right to include and distribute the code under the GNU
• I have added tests to cover my changes
• I have verified that the code complies with the projects coding standards
• [Required for new sniffs] I have added MD documentation for the sniff

[Mips2648]

return type is incorrecte for most of the function, e.g.: return static[]

[Hotfirenet]

@kwizer15 Il faut mettre a jour il y a eu des modification depuis

[kwizer15]

Ca marche je ferais un rebase

[kwizer15]

C'est bon. Y a juste une petite modif de code : j'ai retiré le isset($level) car il existe forcément dans le cas où on se trouve. Ca provoquait une erreur phpstan.
De plus j'ai rajouté des void|null car on utilise le résultat dans d'autres parties du code. Et ca impliquait des changements plus tendus autrement.
Ces changements sont dans un commit séparé.