feat(stub): Add enums for backed integer, backed string, and unit values in the Stub namespace.

CHANGELOG.md

@@ -4,6 +4,7 @@
 
 - Enh #22: Add `php-forge/coding-standard` to development dependencies for code quality checks (@terabytesoftw)
 - Bug #23: Update Rector command in `composer.json` to remove unnecessary 'src' argument (@terabytesoftw)
+- Enh #24: Add enums for backed integer, backed string, and unit values in the `Stub` namespace (@terabytesoftw)
 
 ## 0.3.1 January 20, 2026
 

src/ReflectionHelper.php

@@ -29,8 +29,6 @@
  */
 final class ReflectionHelper
 {
- private function __construct() {}
-
  /**
  * Retrieves a property value from a specified class context.
  *

src/Stub/BackedInteger.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Support\Stub;
+
+/**
+ * Stub enum for backed integer values.
+ *
+ * Provides deterministic values required by the test suite.
+ *
+ * @copyright Copyright (C) 2026 Terabytesoftw.
+ * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
+ */
+enum BackedInteger: int
+{
+ /**
+ * Type representing a value.
+ */
+ case VALUE = 1;
+}

src/Stub/BackedString.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Support\Stub;
+
+/**
+ * Stub enum for backed string values.
+ *
+ * Provides deterministic values required by the test suite.
+ *
+ * @copyright Copyright (C) 2026 Terabytesoftw.
+ * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
+ */
+enum BackedString: string
+{
+ /**
+ * Type representing a value.
+ */
+ case VALUE = 'value';
+}

src/Stub/Unit.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Support\Stub;
+
+/**
+ * Stub enum for unit values.
+ *
+ * Provides deterministic values required by the test suite.
+ *
+ * @copyright Copyright (C) 2026 Terabytesoftw.
+ * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
+ */
+enum Unit
+{
+ /**
+ * Type representing a value.
+ */
+ case value;
+}

tests/EnumDataProviderTest.php

@@ -5,7 +5,7 @@
 namespace PHPForge\Support\Tests;
 
 use PHPForge\Support\EnumDataProvider;
-use PHPForge\Support\Tests\Stub\TestEnum;
+use PHPForge\Support\Stub\BackedInteger;
 use PHPForge\Support\Tests\Support\Provider\EnumDataProviderProvider;
 use PHPUnit\Framework\Attributes\{DataProviderExternal, Group};
 use PHPUnit\Framework\TestCase;
@@ -76,21 +76,17 @@ public function testCasesGenerateExpectedStructure(
 
  public function testTagCasesGenerateExpectedStructure(): void
  {
- $data = EnumDataProvider::tagCases(TestEnum::class, 'element');
+ $data = EnumDataProvider::tagCases(BackedInteger::class, 'element');
 
  self::assertNotEmpty(
  $data,
  'Should return at least one data set.',
  );
  self::assertSame(
  [
- 'BAR element tag' => [
- TestEnum::BAR,
- 'BAR',
- ],
- 'FOO element tag' => [
- TestEnum::FOO,
- 'FOO',
+ '1 element tag' => [
+ BackedInteger::VALUE,
+ 1 => '1',
  ],
  ],
  $data,

tests/Support/Provider/EnumDataProviderProvider.php

@@ -4,7 +4,8 @@
 
 namespace PHPForge\Support\Tests\Support\Provider;
 
-use PHPForge\Support\Tests\Stub\TestEnum;
+use PHPForge\Support\Stub\{BackedInteger, BackedString, Unit};
+use UnitEnum;
 
 /**
  * Data provider for {@see \PHPForge\Support\Tests\EnumDataProviderTest} test cases.
@@ -17,34 +18,34 @@
 final class EnumDataProviderProvider
 {
  /**
- * @return array<string, array{string, string|\UnitEnum, bool, string, string, string}>
+ * @return array<string, array{string, string|UnitEnum, bool, string, string, string}>
  */
  public static function casesParameters(): array
  {
  return [
- 'as enum instance' => [
-TestEnum::class,
-'data-test',
-false,
- 'enum: FOO',
- ' data-test="FOO"',
- "Should return the 'data-test' attribute value for enum case: FOO.",
+ 'enum backed integer instance' => [
+BackedInteger::class,
+BackedInteger::VALUE,
+true,
+ 'enum: 1',
+ ' 1="1"',
+ "Should return the '1' attribute value for enum case: 1.",
  ],
- 'as html' => [
-TestEnum::class,
+ 'enum backed string instance' => [
+BackedString::class,
  'data-test',
  true,
- 'enum: BAR',
- ' data-test="BAR"',
- "Should return the 'data-test' attribute value for enum case: BAR.",
+ 'enum: value',
+ ' data-test="value"',
+ "Should return the 'data-test' attribute value for enum case: value.",
  ],
- 'attribute as enum instance' => [
-TestEnum::class,
-TestEnum::FOO,
-true,
- 'enum: FOO',
- ' FOO="FOO"',
- "Should return the 'FOO' attribute value for enum case: FOO.",
+ 'enum unit instance' => [
+Unit::class,
+'data-test',
+false,
+ 'enum: value',
+ ' data-test="value"',
+ "Should return the 'data-test' attribute value for enum case: value.",
  ],
  ];
  }