Merge branch release/v2.7.0

Author: roadiz-ci

composer.json

@@ -22,18 +22,18 @@
         "doctrine/orm": "~2.20.0",
         "api-platform/doctrine-orm": "^4.1.18",
         "api-platform/metadata": "^4.1.18",
-        "roadiz/nodetype-contracts": "^3.0.0",
-        "symfony/string": "7.3.*",
+        "roadiz/nodetype-contracts": "^3.1.1",
+        "symfony/string": "7.4.*",
         "symfony/translation-contracts": "^3.0",
-        "symfony/http-foundation": "7.3.*",
-        "symfony/serializer": "7.3.*",
-        "symfony/uid": "7.3.*",
-        "symfony/validator": "7.3.*"
+        "symfony/http-foundation": "7.4.*",
+        "symfony/serializer": "7.4.*",
+        "symfony/uid": "7.4.*",
+        "symfony/validator": "7.4.*"
     },
     "require-dev": {
         "doctrine/doctrine-bundle": "^2.8.1",
         "php-coveralls/php-coveralls": "^2.4",
-        "phpstan/phpstan": "^1.5.3",
+        "phpstan/phpstan": "^2.1.36",
         "phpstan/phpdoc-parser": "<2",
         "phpunit/phpunit": "^9.6"
     },
@@ -55,8 +55,8 @@
     },
     "extra": {
         "branch-alias": {
-            "dev-master": "2.6.x-dev",
-            "dev-develop": "2.7.x-dev"
+            "dev-master": "2.7.x-dev",
+            "dev-develop": "2.8.x-dev"
         }
     }
 }

src/Core/AbstractEntities/AbstractDateTimed.php

@@ -11,13 +11,11 @@
  *
  * @deprecated since 2.6, use composition with DateTimedTrait instead.
  */
-#[
-    ORM\MappedSuperclass,
+#[ORM\MappedSuperclass,
     ORM\HasLifecycleCallbacks,
     ORM\Table,
     ORM\Index(columns: ['created_at']),
-    ORM\Index(columns: ['updated_at']),
-]
+    ORM\Index(columns: ['updated_at']),]
 abstract class AbstractDateTimed extends AbstractEntity implements DateTimedInterface
 {
     use DateTimedTrait;

src/Core/AbstractEntities/AbstractEntity.php

@@ -11,10 +11,8 @@
  *
  * @deprecated since 2.6, use composition with PersistableInterface and SequentialIdTrait or UuidTrait instead.
  */
-#[
-    ORM\MappedSuperclass,
-    ORM\Table
-]
+#[ORM\MappedSuperclass,
+    ORM\Table]
 abstract class AbstractEntity implements PersistableInterface
 {
     use SequentialIdTrait;

src/Core/AbstractEntities/AbstractHuman.php

@@ -16,11 +16,9 @@
  *
  * This class can be extended for *Users*, *Subscribers*, etc.
  */
-#[
-    ORM\MappedSuperclass,
+#[ORM\MappedSuperclass,
     ORM\Table,
-    ORM\HasLifecycleCallbacks
-]
+    ORM\HasLifecycleCallbacks]
 abstract class AbstractHuman implements DateTimedInterface, PersistableInterface
 {
     use SequentialIdTrait;
@@ -40,32 +38,24 @@ abstract class AbstractHuman implements DateTimedInterface, PersistableInterface
     /**
      * Public name (pseudonyme) that can be displayed to a public audience.
      */
-    #[
-        ORM\Column(name: 'publicName', type: 'string', length: 250, nullable: true),
+    #[ORM\Column(name: 'publicName', type: 'string', length: 250, nullable: true),
         Serializer\Groups(['user_public', 'human']),
-        Assert\Length(max: 250)
-    ]
+        Assert\Length(max: 250)]
     protected ?string $publicName = null;
 
-    #[
-        ORM\Column(name: 'firstName', type: 'string', length: 250, nullable: true),
+    #[ORM\Column(name: 'firstName', type: 'string', length: 250, nullable: true),
         Serializer\Groups(['user_personal', 'human']),
-        Assert\Length(max: 250)
-    ]
+        Assert\Length(max: 250)]
     protected ?string $firstName = null;
 
-    #[
-        ORM\Column(name: 'lastName', type: 'string', length: 250, nullable: true),
+    #[ORM\Column(name: 'lastName', type: 'string', length: 250, nullable: true),
         Serializer\Groups(['user_personal', 'human']),
-        Assert\Length(max: 250)
-    ]
+        Assert\Length(max: 250)]
     protected ?string $lastName = null;
 
-    #[
-        ORM\Column(type: 'string', length: 250, nullable: true),
+    #[ORM\Column(type: 'string', length: 250, nullable: true),
         Serializer\Groups(['user_personal', 'human']),
-        Assert\Length(max: 250)
-    ]
+        Assert\Length(max: 250)]
     protected ?string $company = null;
 
     public function getEmail(): ?string

src/Core/AbstractEntities/AbstractPositioned.php

@@ -12,19 +12,15 @@
  *
  * @deprecated since 2.6, use composition with PositionedTrait and PositionedInterface instead.
  */
-#[
-    ORM\MappedSuperclass,
+#[ORM\MappedSuperclass,
     ORM\HasLifecycleCallbacks,
     ORM\Table,
-    ORM\Index(columns: ['position'])
-]
+    ORM\Index(columns: ['position'])]
 abstract class AbstractPositioned extends AbstractEntity implements PositionedInterface
 {
     use PositionedTrait;
 
-    #[
-        ORM\Column(type: 'float'),
-        Serializer\Groups(['position']),
-    ]
+    #[ORM\Column(type: 'float'),
+        Serializer\Groups(['position']),]
     protected float $position = 0.0;
 }

src/Core/AbstractEntities/DateTimedInterface.php

@@ -11,12 +11,12 @@ public function getCreatedAt(): ?\DateTime;
     /**
      * @return $this
      */
-    public function setCreatedAt(?\DateTime $createdAt): self;
+    public function setCreatedAt(?\DateTime $createdAt): static;
 
     public function getUpdatedAt(): ?\DateTime;
 
     /**
      * @return $this
      */
-    public function setUpdatedAt(?\DateTime $updatedAt): self;
+    public function setUpdatedAt(?\DateTime $updatedAt): static;
 }

src/Core/AbstractEntities/DateTimedTrait.php

@@ -9,16 +9,12 @@
 
 trait DateTimedTrait
 {
-    #[
-        ORM\Column(name: 'created_at', type: 'datetime', nullable: true),
-        Serializer\Groups(['timestamps']),
-    ]
+    #[ORM\Column(name: 'created_at', type: 'datetime', nullable: true),
+        Serializer\Groups(['timestamps']),]
     protected ?\DateTime $createdAt = null;
 
-    #[
-        ORM\Column(name: 'updated_at', type: 'datetime', nullable: true),
-        Serializer\Groups(['timestamps']),
-    ]
+    #[ORM\Column(name: 'updated_at', type: 'datetime', nullable: true),
+        Serializer\Groups(['timestamps']),]
     protected ?\DateTime $updatedAt = null;
 
     public function getCreatedAt(): ?\DateTime
@@ -29,7 +25,7 @@ public function getCreatedAt(): ?\DateTime
     /**
      * @return $this
      */
-    public function setCreatedAt(?\DateTime $createdAt): self
+    public function setCreatedAt(?\DateTime $createdAt): static
     {
         $this->createdAt = $createdAt;
 
@@ -44,7 +40,7 @@ public function getUpdatedAt(): ?\DateTime
     /**
      * @return $this
      */
-    public function setUpdatedAt(?\DateTime $updatedAt): self
+    public function setUpdatedAt(?\DateTime $updatedAt): static
     {
         $this->updatedAt = $updatedAt;
 
@@ -75,7 +71,7 @@ public function prePersist(): void
      *
      * @return $this
      */
-    public function resetDates(): self
+    public function resetDates(): static
     {
         $this->setCreatedAt(new \DateTime('now'));
         $this->setUpdatedAt(new \DateTime('now'));

src/Core/AbstractEntities/LeafInterface.php

@@ -6,19 +6,25 @@
 
 use Doctrine\Common\Collections\Collection;
 
+/**
+ * @template TSelf of LeafInterface
+ */
 interface LeafInterface extends PositionedInterface
 {
+    /**
+     * @return Collection<int, TSelf>
+     */
     public function getChildren(): Collection;
 
     /**
-     * @param static $child
+     * @param TSelf $child
      *
      * @return $this
      */
     public function addChild(LeafInterface $child): static;
 
     /**
-     * @param static $child
+     * @param TSelf $child
      *
      * @return $this
      */
@@ -27,16 +33,18 @@ public function removeChild(LeafInterface $child): static;
     /**
      * Do not add static return type because of Doctrine Proxy.
      *
-     * @return static|null
+     * @return TSelf|null
      */
     public function getParent(): ?LeafInterface;
 
     /**
-     * @return static[]
+     * @return TSelf[]
      */
     public function getParents(): array;
 
     /**
+     * @param TSelf|null $parent
+     *
      * @return $this
      */
     public function setParent(?LeafInterface $parent = null): static;

src/Core/AbstractEntities/LeafTrait.php

@@ -61,12 +61,8 @@ public function removeChild(LeafInterface $child): static
     /*
      * Do not add static return type because of Doctrine Proxy.
      */
-    /**
-     * @return static|null
-     */
     public function getParent(): ?LeafInterface
     {
-        /* @phpstan-ignore-next-line */
         return $this->parent;
     }
 

src/Core/AbstractEntities/PositionedInterface.php

@@ -14,6 +14,8 @@ public function getPosition(): float;
      * Set position as a float to enable increment and decrement by O.5
      * to insert an entity between two others.
      *
+     * Do not add static return type because of Doctrine Proxy.
+     *
      * @return $this
      */
     public function setPosition(float $newPosition): PositionedInterface;