chore: reorganize tests, improve tooling and documentation

Tests:
- Restructure tests/ into Unit/Integration/Regression hierarchy
- Consolidate 7 duplicate tests across 4 test files
- 502 tests, 924 assertions, 0 failures

Tooling:
- Configure PHPStan level max, resolve initial PHPDoc issues
- Update benchmark results (PHP 8.5.1 + OPcache)

Documentation:
- Update README with new performance metrics
- Generate comprehensive PHPDoc annotations

Author: gravity-zero

CHANGELOG.md

@@ -5,8 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.0.4] - 2026-01-05
+## [1.0.5] - 2026-01-06
+### Tests
+- Restructured test suite into Unit/Integration/Regression hierarchy
+- Consolidated 7 duplicate tests across 4 test files
+- 502 tests, 924 assertions, 0 failures
+
+### Tooling
+- Configured PHPStan level max, resolved initial PHPDoc issues
+- Updated benchmark results (PHP 8.5.1 + OPcache)
 
+### Documentation
+- Updated README with new performance metrics
+- Generated comprehensive PHPDoc annotations
+
+## [1.0.4] - 2026-01-05
 ### Performance
 - **Static Translator Cache** - Eliminates repeated file I/O across validation instances
 - TranslationManager now uses process-wide cached translator instance

Makefile

@@ -1,16 +1,16 @@
 .PHONY: test stan mutation benchmark p99 docs docs-serve
 
 test:
-	bash tests.sh --full
+	@vendor/bin/phpunit --colors --display-warnings --testdox
 
 stan:
-	@vendor/bin/phpstan analyse src tests
+	@vendor/bin/phpstan analyse -l max src
 
 mutation:
 	@vendor/bin/infection --threads=4
 
 benchmark:
-	@vendor/bin/phpbench run --report=default --iterations=10 --revs=1000 --warmup=2 --output=csv > benchmarks/bench_results.csv
+	@vendor/bin/phpbench run --report=default --warmup=2 --output=csv > benchmarks/bench_results.csv
 
 p99:
 	@cd benchmarks && php analyze_bench.php

README.md

@@ -221,7 +221,7 @@ $dv->addTranslations([
 - ✅ **Fast** - ~9μs simple validation, ~4.9MB memory ([benchmarks](docs/BENCHMARK.md))
 - ✅ **i18n ready** - Built-in translation support (EN, FR)
 - ✅ **Framework agnostic** - Works with WordPress, Laravel, Symfony, vanilla PHP
-- ✅ **Production tested** - 482 tests, 75% mutation score
+- ✅ **Production tested** - 500+ tests, 83% mutation score
 
 ## Documentation
 
@@ -244,10 +244,10 @@ $dv->addTranslations([
 
 DataVerify is designed for production with predictable sub-millisecond performance:
 ```
-Simple validation:       ~8.8μs   (99% < 9μs)
-Complex nested:          ~17.1μs  (99% < 18μs)
-Batch mode (100 fields):  1.15ms
-Fail-fast (100 fields):   0.23ms  (2.3x faster)
+Simple validation:       ~8.7μs   (99% < 9μs)
+Complex nested:          ~16.4μs  (99% < 18μs)
+Batch mode (100 fields): ~0.53ms
+Fail-fast (100 fields):  ~0.23ms  (2.3x faster)
 Memory usage:            ~4.9MB   (stable)
 ```
 

benchmarks/bench_results.csv

@@ -11,31 +11,31 @@ make benchmark-stats    # With P50/P95/P99 percentiles
 ### Results (PHP 8.5.1 + OPcache)
 
 **Core Operations** (P99):
-- Simple validation: **8.8μs** (99% < 9μs)
-- Complex nested: **17.1μs** (99% < 18μs)
-- Custom strategy: **11.4μs** (99% < 12μs)
+- Simple validation: **8.7μs** (99% < 9μs)
+- Complex nested: **16.4μs** (99% < 17μs)
+- Custom strategy: **11.2μs** (99% < 12μs)
 
 **Batch Processing:**
-- Batch mode (100 fields): **1.15ms**
-- Fail-fast mode (100 fields): **0.23ms** → **5x faster**
+- Batch mode (100 fields): **~0.53ms**
+- Fail-fast mode (100 fields): **~0.23ms** → **2.3x faster**
 
 **Conditional Validations** (P99):
-- Triggered: **8.9μs**
+- Triggered: **8.5μs**
 - Not triggered: **5.7μs** ← Faster (validation skipped)
-- Failed + errors: **14.5μs** ← Most expensive (error rendering)
+- Failed + errors: **13μs** ← Most expensive (error rendering)
 - Complex AND/OR: **~6.1μs**
 
 **Translation Overhead:**
 - With translation: **14.6μs**
 - Without translation: **14.3μs**
-- **Overhead: ~2%** (negligible)
+- **Overhead: ~2-3%** (negligible)
 
 **Memory:** ~4.9MB (stable, no leaks)
 
 **Key Insights:**
-- ✅ **99% of validations complete in <18μs** (sub-millisecond)
-- ✅ **Very stable** - P99 within 5% of mean (low variance)
-- ✅ **Fail-fast mode 5x faster** when you need speed
+- ✅ **99% of validations complete in <17μs** (sub-millisecond)
+- ✅ **Very low variance** - P99 tightly clustered around the mean
+- ✅ **Fail-fast mode 2.3x faster** when you need speed
 - ✅ **Conditional skip is fast** - unused validations add minimal overhead
 - ✅ **Static translator cache** eliminates file I/O overhead
 

docs/BENCHMARK.md

@@ -225,7 +225,11 @@ $verifier->field("test")->maxLength(20)
 </details>
 
 <details>
-<summary><code>disposableEmail</code> - Validates that an email is not from a disposable domain</summary>
+<summary><code>disposableEmail</code> - Validates that an email is not from a disposable domain, can be overri...</summary>
+
+**Description:**
+
+Validates that an email is not from a disposable domain, can be overriden ["@yourDisposableDomain", ...]
 
 **Parameters:**
 
@@ -237,7 +241,11 @@ $verifier->field("test")->maxLength(20)
 **Usage:**
 
 ```php
-$verifier->field("test")->disposableEmail([])
+$verifier->field("email")->disposableEmail
+```
+
+```php
+$verifier->field("email")->disposableEmail(["@yourDisposableDomain", ...])
 ```
 
 </details>

docs/VALIDATIONS.md

@@ -126,7 +126,7 @@
             "disposableEmail": {
                 "type": "object",
                 "title": "DisposableEmail",
-                "description": "Validates that an email is not from a disposable domain\n\n**Usage:**\n```php\n$verifier->field(\"test\")->disposableEmail([])\n```\n\n**Parameters:**\n- `disposables`: []",
+                "description": "Validates that an email is not from a disposable domain, can be overriden [\"@yourDisposableDomain\", ...]\n\n**Usage:**\n```php\n$verifier->field(\"email\")->disposableEmail\n```\n```php\n$verifier->field(\"email\")->disposableEmail([\"@yourDisposableDomain\", ...])\n```\n\n**Parameters:**\n- `disposables`: []",
                 "x-category": "String",
                 "properties": {
                     "disposables": {

docs/openapi.json

@@ -122,7 +122,7 @@
         "disposableEmail": {
             "type": "object",
             "title": "DisposableEmail",
-            "description": "Validates that an email is not from a disposable domain\n\n**Usage:**\n```php\n$verifier->field(\"test\")->disposableEmail([])\n```\n\n**Parameters:**\n- `disposables`: []",
+            "description": "Validates that an email is not from a disposable domain, can be overriden [\"@yourDisposableDomain\", ...]\n\n**Usage:**\n```php\n$verifier->field(\"email\")->disposableEmail\n```\n```php\n$verifier->field(\"email\")->disposableEmail([\"@yourDisposableDomain\", ...])\n```\n\n**Parameters:**\n- `disposables`: []",
             "x-category": "String",
             "properties": {
                 "disposables": {

docs/schema.json

@@ -126,10 +126,11 @@
     },
     "disposableEmail": {
         "name": "disposableEmail",
-        "description": "Validates that an email is not from a disposable domain",
+        "description": "Validates that an email is not from a disposable domain, can be overriden [\"@yourDisposableDomain\", ...]",
         "category": "String",
         "examples": [
-            "$verifier->field(\"test\")->disposableEmail([])"
+            "$verifier->field(\"email\")->disposableEmail",
+            "$verifier->field(\"email\")->disposableEmail([\"@yourDisposableDomain\", ...])"
         ],
         "parameters": [
             {

docs/validations.json

@@ -0,0 +1,22 @@
+{
+  "source": {
+    "directories": ["src"],
+    "excludes": ["Documentation"]
+  },
+  "logs": {
+    "text": "infection.log"
+  },
+  "mutators": {
+    "@default": true,
+    "ProtectedVisibility": {
+      "ignore": ["*"]
+    },
+    "PublicVisibility": {
+      "ignore": ["*"]
+    }
+  },
+  "phpUnit": {
+    "customPath": "vendor/bin/phpunit",
+    "configDir": "."
+  }
+}