wip

Author: chapterjason

README.md

@@ -7,8 +7,8 @@
 [![codecov](https://codecov.io/gh/SoureCode/DoctrineExtensionBundle/branch/master/graph/badge.svg?token=GBFBVXQYK4)](https://codecov.io/gh/SoureCode/DoctrineExtensionBundle)
 [![Mutation testing badge](https://img.shields.io/endpoint?style=flat&url=https%3A%2F%2Fbadge-api.stryker-mutator.io%2Fgithub.com%2FSoureCode%2FDoctrineExtensionBundle%2Fmaster)](https://dashboard.stryker-mutator.io/reports/github.com/SoureCode/DoctrineExtensionBundle/master)
 
-[Documentation](./docs/index.md)
-[License](./LICENSE)
+- [Documentation](./docs/index.md)
+- [License](./LICENSE)
 
 ## Installation
 

docs/timestampable.md

@@ -14,11 +14,11 @@ namespace App\Entity;
 
 use Doctrine\ORM\Mapping as ORM;
 use SoureCode\Bundle\DoctrineExtension\Contracts\TimestampableInterface;
-use SoureCode\Bundle\DoctrineExtension\Traits\TimestampableTrait;
+use SoureCode\Bundle\DoctrineExtension\Traits\TimestampAwareTrait;
 
 #[ORM\Entity]
 class User implements TimestampableInterface {
-    use TimestampableTrait;
+    use TimestampAwareTrait;
 
     #[ORM\Id]
     #[ORM\GeneratedValue]

src/Attributes/SetOnCreation.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace SoureCode\Bundle\DoctrineExtension\Attributes;
+
+#[\Attribute(\Attribute::TARGET_PROPERTY)]
+final class SetOnCreation
+{
+    public function __construct(
+        public ?string $type = null,
+    ) {
+    }
+}

src/Attributes/SetOnUpdate.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace SoureCode\Bundle\DoctrineExtension\Attributes;
+
+#[\Attribute(\Attribute::TARGET_PROPERTY)]
+final class SetOnUpdate
+{
+    public function __construct(
+        public ?string $type = null,
+    ) {
+    }
+}

src/Attributes/Translatable.php

@@ -5,16 +5,22 @@
 use SoureCode\Bundle\DoctrineExtension\Contracts\TranslationInterface;
 
 #[\Attribute(\Attribute::TARGET_CLASS)]
-final class Translatable
+final readonly class Translatable
 {
-    public function __construct(
-        /**
-         * @var class-string
-         */
-        public string $translationClass,
-    ) {
+    /**
+     * @var class-string<TranslationInterface>
+     */
+    public string $translationClass;
+
+    /**
+     * @param class-string $translationClass
+     */
+    public function __construct(string $translationClass)
+    {
         if (!is_subclass_of($translationClass, TranslationInterface::class)) {
             throw new \InvalidArgumentException(\sprintf('The class "%s" must implement "%s".', $translationClass, TranslationInterface::class));
         }
+        
+        $this->translationClass = $translationClass;
     }
 }

src/Contracts/BlameableInterface.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace SoureCode\Bundle\DoctrineExtension\Contracts;
+
+interface LocaleAwareInterface
+{
+    public function getLocale(): string;
+
+    public function setLocale(string $locale): self;
+}

src/Contracts/LocaleAwareInterface.php

@@ -2,13 +2,9 @@
 
 namespace SoureCode\Bundle\DoctrineExtension\Contracts;
 
-interface TranslationInterface
+interface TranslationInterface extends LocaleAwareInterface
 {
-    public function getLocale(): string;
+    public function setTranslatable(object $translatable): self;
 
-    public function setLocale(string $locale): self;
-
-    public function getTranslatable(): TranslatableInterface;
-
-    public function setTranslatable(TranslatableInterface $translatable): self;
-}
+    public function getTranslatable(): object;
+}