feature symfony#54788 [TypeInfo] mark classes as experimental (soyuka)

This PR was merged into the 7.1 branch.

Discussion
----------

[TypeInfo] mark classes as experimental

| Q             | A
| ------------- | ---
| Branch?       | 7.1
| Bug fix?      | no
| New feature?  | no
| Deprecations? | no
| License       | MIT

This is following a discussion on slack with authors of the component, I feel that the TypeInfo component should have an experimental phase as we need to prove the component's functionality on software that is built on top of type information extraction. Here's a non-exhaustive list of software using the PropertyInfo Type class (thanks to `@mtarld`):

- api-platform/core
- nelmio/api-doc-bundle
- typo3/cms-extbase
- typo3/cms
- sonata-project/page-bundle
- jolicode/automapper
- symfony/ux-live-component

These softwares should try their best in testing the new TypeInfo component and report back misfunctionalities and/or DX improvements before we can consider this non-experimental. See also symfony#54789

Commits
-------

28b6495 [TypeInfo] mark classes as experimental

Author: fabpot

src/Symfony/Component/TypeInfo/CHANGELOG.md

@@ -4,4 +4,4 @@ CHANGELOG
 7.1
 ---
 
- * Add the component
+ * Add the component as experimental

src/Symfony/Component/TypeInfo/Exception/ExceptionInterface.php

@@ -14,6 +14,8 @@
 /**
  * @author Mathias Arlaud <[email protected]>
  * @author Baptiste Leduc <[email protected]>
+ *
+ * @experimental
  */
 interface ExceptionInterface extends \Throwable
 {

src/Symfony/Component/TypeInfo/Exception/InvalidArgumentException.php

@@ -14,6 +14,8 @@
 /**
  * @author Mathias Arlaud <[email protected]>
  * @author Baptiste Leduc <[email protected]>
+ *
+ * @experimental
  */
 class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface
 {

src/Symfony/Component/TypeInfo/Exception/LogicException.php

@@ -14,6 +14,8 @@
 /**
  * @author Mathias Arlaud <[email protected]>
  * @author Baptiste Leduc <[email protected]>
+ *
+ * @experimental
  */
 class LogicException extends \LogicException implements ExceptionInterface
 {

src/Symfony/Component/TypeInfo/Exception/RuntimeException.php

@@ -14,6 +14,8 @@
 /**
  * @author Mathias Arlaud <[email protected]>
  * @author Baptiste Leduc <[email protected]>
+ *
+ * @experimental
  */
 class RuntimeException extends \RuntimeException implements ExceptionInterface
 {

src/Symfony/Component/TypeInfo/Exception/UnsupportedException.php

@@ -14,6 +14,8 @@
 /**
  * @author Mathias Arlaud <[email protected]>
  * @author Baptiste Leduc <[email protected]>
+ *
+ * @experimental
  */
 class UnsupportedException extends \LogicException implements ExceptionInterface
 {

src/Symfony/Component/TypeInfo/README.md

@@ -3,6 +3,11 @@ TypeInfo Component
 
 The TypeInfo component extracts PHP types information.
 
+**This Component is experimental**.
+[Experimental features](https://symfony.com/doc/current/contributing/code/experimental.html)
+are not covered by Symfony's
+[Backward Compatibility Promise](https://symfony.com/doc/current/contributing/code/bc.html).
+
 Getting Started
 ---------------
 

src/Symfony/Component/TypeInfo/Type.php

@@ -17,6 +17,8 @@
 /**
  * @author Mathias Arlaud <[email protected]>
  * @author Baptiste Leduc <[email protected]>
+ *
+ * @experimental
  */
 abstract class Type implements \Stringable
 {

src/Symfony/Component/TypeInfo/Type/BackedEnumType.php

@@ -21,6 +21,8 @@
  * @template U of BuiltinType<TypeIdentifier::INT>|BuiltinType<TypeIdentifier::STRING>
  *
  * @extends EnumType<T>
+ *
+ * @experimental
  */
 final class BackedEnumType extends EnumType
 {

src/Symfony/Component/TypeInfo/Type/BuiltinType.php

@@ -20,6 +20,8 @@
  * @author Baptiste Leduc <[email protected]>
  *
  * @template T of TypeIdentifier
+ *
+ * @experimental
  */
 final class BuiltinType extends Type
 {