Update SemVer constraint documentation to reflect latest changes

- Remove requirePrefix, allowPreRelease, and allowBuildMetadata options
- Add strict option (default: true) as the only configuration option
- Update examples to show behavior with strict mode enabled/disabled

Author: OskarStark

reference/constraints/SemVer.rst

@@ -80,151 +80,21 @@ Basic Usage
 Options
 -------
 
-``requirePrefix``
-~~~~~~~~~~~~~~~~~
-
-**type**: ``boolean`` **default**: ``false``
-
-When set to ``true``, the version string must start with a "v" prefix 
-(e.g., "v1.2.3" instead of "1.2.3").
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        // src/Entity/Package.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Package
-        {
-            #[Assert\SemVer(requirePrefix: true)]
-            protected string $version;
-        }
-
-    .. code-block:: yaml
-
-        # config/validator/validation.yaml
-        App\Entity\Package:
-            properties:
-                version:
-                    - SemVer:
-                        requirePrefix: true
-
-    .. code-block:: xml
-
-        <!-- config/validator/validation.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
-
-            <class name="App\Entity\Package">
-                <property name="version">
-                    <constraint name="SemVer">
-                        <option name="requirePrefix">true</option>
-                    </constraint>
-                </property>
-            </class>
-        </constraint-mapping>
-
-    .. code-block:: php
-
-        // src/Entity/Package.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-        use Symfony\Component\Validator\Mapping\ClassMetadata;
-
-        class Package
-        {
-            // ...
-
-            public static function loadValidatorMetadata(ClassMetadata $metadata): void
-            {
-                $metadata->addPropertyConstraint('version', new Assert\SemVer([
-                    'requirePrefix' => true,
-                ]));
-            }
-        }
-
-``allowPreRelease``
-~~~~~~~~~~~~~~~~~~~
+``strict``
+~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
-Whether to allow pre-release versions (e.g., "1.2.3-beta", "2.0.0-rc.1").
-When set to ``false``, only stable versions are considered valid.
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        // src/Entity/Package.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Package
-        {
-            #[Assert\SemVer(allowPreRelease: false)]
-            protected string $version;
-        }
-
-    .. code-block:: yaml
-
-        # config/validator/validation.yaml
-        App\Entity\Package:
-            properties:
-                version:
-                    - SemVer:
-                        allowPreRelease: false
-
-    .. code-block:: xml
-
-        <!-- config/validator/validation.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
-
-            <class name="App\Entity\Package">
-                <property name="version">
-                    <constraint name="SemVer">
-                        <option name="allowPreRelease">false</option>
-                    </constraint>
-                </property>
-            </class>
-        </constraint-mapping>
-
-    .. code-block:: php
+When set to ``true``, the version must strictly follow the official 
+`Semantic Versioning`_ specification. This means:
 
-        // src/Entity/Package.php
-        namespace App\Entity;
+- No "v" prefix is allowed (use "1.2.3", not "v1.2.3")
+- A full version is required (major.minor.patch)
 
-        use Symfony\Component\Validator\Constraints as Assert;
-        use Symfony\Component\Validator\Mapping\ClassMetadata;
+When set to ``false``, common version variations are allowed:
 
-        class Package
-        {
-            // ...
-
-            public static function loadValidatorMetadata(ClassMetadata $metadata): void
-            {
-                $metadata->addPropertyConstraint('version', new Assert\SemVer([
-                    'allowPreRelease' => false,
-                ]));
-            }
-        }
-
-``allowBuildMetadata``
-~~~~~~~~~~~~~~~~~~~~~~
-
-**type**: ``boolean`` **default**: ``true``
-
-Whether to allow build metadata in the version string (e.g., "1.2.3+20130313144700").
-When set to ``false``, build metadata is not allowed.
+- The "v" prefix is accepted (e.g., "v1.2.3")
+- Partial versions are valid (e.g., "1", "1.2")
 
 .. configuration-block::
 
@@ -237,7 +107,7 @@ When set to ``false``, build metadata is not allowed.
 
         class Package
         {
-            #[Assert\SemVer(allowBuildMetadata: false)]
+            #[Assert\SemVer(strict: false)]
             protected string $version;
         }
 
@@ -248,7 +118,7 @@ When set to ``false``, build metadata is not allowed.
             properties:
                 version:
                     - SemVer:
-                        allowBuildMetadata: false
+                        strict: false
 
     .. code-block:: xml
 
@@ -261,7 +131,7 @@ When set to ``false``, build metadata is not allowed.
             <class name="App\Entity\Package">
                 <property name="version">
                     <constraint name="SemVer">
-                        <option name="allowBuildMetadata">false</option>
+                        <option name="strict">false</option>
                     </constraint>
                 </property>
             </class>
@@ -282,7 +152,7 @@ When set to ``false``, build metadata is not allowed.
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('version', new Assert\SemVer([
-                    'allowBuildMetadata' => false,
+                    'strict' => false,
                 ]));
             }
         }
@@ -294,15 +164,19 @@ When set to ``false``, build metadata is not allowed.
 Valid Version Examples
 ----------------------
 
-The following are examples of valid semantic versions:
+When using ``strict: true`` (default), the following are valid:
 
-- ``1`` (partial version)
-- ``1.2`` (partial version)
 - ``1.2.3`` (full version)
-- ``v1.2.3`` (with prefix)
 - ``1.2.3-alpha`` (pre-release)
 - ``1.2.3-beta.1`` (pre-release with numeric identifier)
 - ``1.2.3+20130313144700`` (with build metadata)
 - ``1.2.3-beta+exp.sha.5114f85`` (pre-release and build metadata)
 
+When using ``strict: false``, additional formats are accepted:
+
+- ``1`` (partial version)
+- ``1.2`` (partial version)
+- ``v1.2.3`` (with "v" prefix)
+- ``v1.2.3-alpha`` (prefix with pre-release)
+
 .. _`Semantic Versioning`: https://semver.org/