Implement BooleanValue and related classes with comprehensive tests

composer.json

@@ -29,6 +29,13 @@
         "phpunit/php-code-coverage": "^11.0",
         "phpunit/phpunit": "^11.3",
         "wiz-develop/php-monad": "^2.2",
-        "phpstan/phpstan": "^2.1"
+        "phpstan/phpstan": "^2.1",
+        "phpstan/extension-installer": "^1.4",
+        "phpstan/phpstan-strict-rules": "^2.0"
+    },
+    "config": {
+        "allow-plugins": {
+            "phpstan/extension-installer": true
+        }
     }
 }

examples/Boolean/TestBooleanValue.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace WizDevelop\PhpValueObject\Examples\Boolean;
+
+use WizDevelop\PhpValueObject\Boolean\BooleanValue;
+use WizDevelop\PhpValueObject\ValueObjectMeta;
+
+/**
+ * BooleanValue抽象クラスのテスト用実装
+ * 単にBooleanValueを継承するだけのシンプルなクラス
+ */
+#[ValueObjectMeta(displayName: '真偽値')]
+final readonly class TestBooleanValue extends BooleanValue
+{
+    // 追加実装なし - 基本クラスから継承
+}

examples/Number/Decimal/TestDecimalValue.php

@@ -4,7 +4,7 @@
 
 namespace WizDevelop\PhpValueObject\Examples\Number\Decimal;
 
-use BCMath\Number;
+use BcMath\Number;
 use Override;
 use WizDevelop\PhpValueObject\Number\DecimalValue;
 use WizDevelop\PhpValueObject\ValueObjectMeta;

examples/Number/Decimal/TestNegativeDecimalValue.php

@@ -4,7 +4,7 @@
 
 namespace WizDevelop\PhpValueObject\Examples\Number\Decimal;
 
-use BCMath\Number;
+use BcMath\Number;
 use Override;
 use WizDevelop\PhpValueObject\Number\NegativeDecimalValue;
 use WizDevelop\PhpValueObject\ValueObjectMeta;

examples/Number/Decimal/TestPositiveDecimalValue.php

@@ -4,7 +4,7 @@
 
 namespace WizDevelop\PhpValueObject\Examples\Number\Decimal;
 
-use BCMath\Number;
+use BcMath\Number;
 use Override;
 use WizDevelop\PhpValueObject\Number\PositiveDecimalValue;
 use WizDevelop\PhpValueObject\ValueObjectMeta;

phpstan.neon.dist

@@ -4,5 +4,10 @@ parameters:
     level: max
     paths:
         - src
+        - tests
     typeAliases:
-        NumberValueBase: '\WizDevelop\PhpValueObject\Number\Decimal\DecimalValueBase|\WizDevelop\PhpValueObject\Number\Integer\IntegerValueBase'
+        NumberValueBase: '\WizDevelop\PhpValueObject\Number\Decimal\DecimalValueBase|\WizDevelop\PhpValueObject\Number\Integer\IntegerValueBase'
+    ignoreErrors:
+        -
+            # NOTE: PHP-CS-Fixer のルールと競合するため
+            identifier: staticMethod.dynamicCall

src/Boolean/Base/BooleanValueBase.php

@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace WizDevelop\PhpValueObject\Boolean\Base;
+
+use Override;
+use WizDevelop\PhpMonad\Result;
+use WizDevelop\PhpValueObject\Boolean\BooleanValueError;
+use WizDevelop\PhpValueObject\IValueObject;
+
+/**
+ * 真偽値の値オブジェクトの基底クラス
+ */
+abstract readonly class BooleanValueBase implements IValueObject, IBooleanValueFactory
+{
+    protected function __construct(public bool $value)
+    {
+        assert(static::isValid($value)->isOk());
+    }
+
+    #[Override]
+    final public function equals(IValueObject $other): bool
+    {
+        return (string)$this === (string)$other;
+    }
+
+    #[Override]
+    final public function __toString(): string
+    {
+        return $this->value ? 'true' : 'false';
+    }
+
+    #[Override]
+    final public function jsonSerialize(): bool
+    {
+        return $this->value;
+    }
+
+    /**
+     * 有効な値かどうか
+     * NOTE: 実装クラスでのオーバーライド用メソッド
+     * @return Result<bool,BooleanValueError>
+     */
+    protected static function isValid(bool $value): Result
+    {
+        return Result\ok(true);
+    }
+
+    /**
+     * 真の値かどうか
+     */
+    final public function yes(): bool
+    {
+        return $this->value === true;
+    }
+
+    /**
+     * 偽の値かどうか
+     */
+    final public function no(): bool
+    {
+        return $this->value === false;
+    }
+
+    /**
+     * 否定値を取得
+     */
+    final public function not(): static
+    {
+        return static::from(!$this->value);
+    }
+
+    /**
+     * 論理積
+     */
+    final public function and(self $other): static
+    {
+        return static::from($this->value && $other->value);
+    }
+
+    /**
+     * 論理和
+     */
+    final public function or(self $other): static
+    {
+        return static::from($this->value || $other->value);
+    }
+
+    /**
+     * 排他的論理和
+     */
+    final public function xor(self $other): static
+    {
+        return static::from($this->value xor $other->value);
+    }
+}

src/Boolean/Base/BooleanValueFactory.php

@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace WizDevelop\PhpValueObject\Boolean\Base;
+
+use Override;
+use WizDevelop\PhpMonad\Option;
+use WizDevelop\PhpMonad\Result;
+
+/**
+ * Default implementation of IBooleanValueFactory
+ * @see WizDevelop\PhpValueObject\Boolean\BooleanValue
+ * @see WizDevelop\PhpValueObject\Boolean\Base\IBooleanValueFactory
+ */
+trait BooleanValueFactory
+{
+    #[Override]
+    final public static function from(bool $value): static
+    {
+        return new static($value);
+    }
+
+    #[Override]
+    final public static function fromNullable(?bool $value): Option
+    {
+        if ($value === null) {
+            return Option\none();
+        }
+
+        return Option\some(static::from($value));
+    }
+
+    #[Override]
+    final public static function tryFromNullable(?bool $value): Result
+    {
+        if ($value === null) {
+            // @phpstan-ignore-next-line
+            return Result\ok(Option\none());
+        }
+
+        // @phpstan-ignore-next-line
+        return static::tryFrom($value)->map(static fn ($result) => Option\some($result));
+    }
+
+    #[Override]
+    final public static function true(): static
+    {
+        return static::from(true);
+    }
+
+    #[Override]
+    final public static function false(): static
+    {
+        return static::from(false);
+    }
+}