chore: resolve merge conflicts, keep local changes

Author: gravity-zero

CHANGELOG.md

@@ -5,6 +5,37 @@ 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.1.0] - 2026-01-15
+### Added
+- **Reusable Rules** - Register field-agnostic validation patterns with `DataVerify::registerRules()`
+- **Validation Schemas** - Define complete validation structures with `DataVerify::registerSchema()`
+- Rules support 3 syntaxes: `->rule('ruleName')`, `->rule->ruleName`, `->rule->ruleName()`
+- Schemas support 3 syntaxes: `->schema('schemaName')`, `->schema->schemaName`, `->schema->schemaName()`
+- Schemas support conditional logic and rule composition
+- **Load from directory** - `DataVerify::loadRulesFrom()` and `DataVerify::loadSchemasFrom()` for file-based organization
+- **Auto-discovery from directory** - Load custom validation strategies automatically via `LazyValidationRegistry`
+- Example files for rules and schemas in `/examples` including batch registration and performance patterns
+
+### Changed
+- **Deferred Conditional Evaluation** - Conditional validations now evaluate during `verify()` instead of at definition time for more intuitive rule composition
+
+### Refactored
+- LazyValidationRegistry now auto-discovers validation directories without hardcoded configuration
+- Removed legacy `conditionalValidations` system in favor of unified `allValidations` structure
+- Enhanced OpenAPI documentation with Rules & Schemas sections
+
+### Performance
+- Rules registration: 1.4μs P99 (20 rules: 20.6μs)
+- Schema registration: 4.6μs P99 (10 schemas: 45.9μs)
+- Rules application: 5.9μs P99 (comparable to inline)
+- Schema application: 7.7μs P99 (37% faster than manual!)
+- All validations remain <20μs P99
+
+### Tests
+- Add 2 Unit Test Class for Rules & Schema
+- 616 tests, 1192 assertions, 0 failures
+- Mutation score: 84% 
+
 ## [1.0.5] - 2026-01-06
 ### Tests
 - Restructured test suite into Unit/Integration/Regression hierarchy

Makefile

@@ -10,7 +10,9 @@ mutation:
 	@vendor/bin/infection --threads=4
 
 benchmark:
+	sudo mv /etc/php/8.5/cli/conf.d/20-pcov.ini /etc/php/8.5/cli/conf.d/20-pcov.ini.bak
 	@vendor/bin/phpbench run --report=default --warmup=2 --output=csv > benchmarks/bench_results.csv
+	sudo mv /etc/php/8.5/cli/conf.d/20-pcov.ini.bak /etc/php/8.5/cli/conf.d/20-pcov.ini
 
 p99:
 	@cd benchmarks && php analyze_bench.php

README.md

@@ -55,7 +55,36 @@ $dv->field('vat_number')
     ->then->required->regex('/^FR\d{11}$/');
 ```
 
-**Custom strategies**
+**Reusable Rules & Schemas**
+```php
+// Register reusable validation rules
+DataVerify::registerRules('strongPassword')
+    ->minLength(12)
+    ->containsUpper
+    ->containsLower
+    ->containsSpecialCharacter;
+
+// Apply to any field
+$dv->field('password')->rule('strongPassword');
+
+// Register complete validation schemas
+DataVerify::registerSchema('userApi')
+    ->field('user')->required->object
+        ->subfield('email')->email
+            ->when('user.id', '!=', null)->then->required
+        ->subfield('password')->rule('strongPassword')
+            ->when('user.id', '!=', null)->then->required;
+
+// Apply entire schema
+$dv = new DataVerify($data); 
+$dv->schema('userApi');
+
+if(!$dv->verify()){
+    // Get Your Errors
+}
+```
+
+**Custom validation strategies**
 ```php
 class SiretStrategy extends ValidationStrategy {
     public function getName(): string { return 'siret'; }
@@ -217,38 +246,44 @@ $dv->addTranslations([
 
 - ✅ **Zero dependencies** - Pure PHP 8.1+, no vendor bloat
 - ✅ **Fluent API** - Readable, chainable validations
-- ✅ **Extensible** - Custom strategies with auto-documentation
-- ✅ **Fast** - ~9μs simple validation, ~4.9MB memory ([benchmarks](docs/BENCHMARK.md))
+- ✅ **Reusable patterns** - Rules & Schemas for DRY validation with auto-documentation
+- ✅ **Extensible** - Custom validation strategies with auto-documentation
+- ✅ **Fast** - ~9.7μs simple validation, ~2MB memory ([benchmarks](docs/BENCHMARK.md))
 - ✅ **i18n ready** - Built-in translation support (EN, FR)
 - ✅ **Framework agnostic** - Works with WordPress, Laravel, Symfony, vanilla PHP
-- ✅ **Production tested** - 500+ tests, 83% mutation score
+- ✅ **Worker-mode ready** - Tested with FrankenPHP, stable memory over 3M+ requests
+- ✅ **Production tested** - 600+ tests, 84% mutation score
 
 ## Documentation
 
 **Guides:**
+- [Rules & Schemas](docs/RULES_AND_SCHEMAS.md) - Reusable validation patterns
 - [Conditional Validation](docs/CONDITIONAL_VALIDATION.md) - `when/and/or/then` syntax
 - [Custom Strategies](docs/CUSTOM_STRATEGIES.md) - Extend with your own rules
 - [Internationalization](docs/INTERNATIONALIZATION.md) - Multi-language error messages
 - [Error Handling](docs/ERROR_HANDLING.md) - Working with validation errors
 - [Validation Rules](docs/VALIDATIONS.md) - All 30+ built-in rules
+- [Benchmarks](docs/BENCHMARK.md) - Performance metrics
 
 **Examples:**
 - [API Request Validation](examples/api-request.php)
 - [Basic Usage](examples/basic.php)
 - [Conditional Validation](examples/conditional-validation.php)
 - [Custom Validation Rules](examples/custom-validation.php)
+- [Reusable Rules](examples/rules.php)
+- [Validation Schemas](examples/schema.php)
 - [Translation (PHP)](examples/translation-basic.php)
 - [Translation (YAML)](examples/translation-yaml.php)
 
 ## Performance
 
 DataVerify is designed for production with predictable sub-millisecond performance:
 ```
-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)
+Simple validation:       ~9.7μs   (99% < 10μs)
+Complex nested:          ~19.1μs  (99% < 20μs)
+Batch mode (100 fields): ~572.9μs
+Fail-fast (100 fields):  ~256.1μs (2.2x faster)
+Memory usage:            ~2MB     (stable)
 ```
 
 **See:** [Full benchmarks](docs/BENCHMARK.md)
@@ -377,4 +412,4 @@ MIT License - see [LICENSE](LICENCE) file for details.
 
 ---
 
-**Made with ❤️ by [Romain Feregotto](https://github.com/gravity-zero)**
+**Made with ❤️ by [Romain Feregotto](https://github.com/gravity-zero)**

docs/BENCHMARK.md

@@ -1,42 +1,80 @@
 ## Performance
 
-DataVerify is designed for production use with predictable, sub-millisecond performance.
+**[← Back to Main Documentation](../README.md)**
+
+**Navigation:** [Validations](VALIDATIONS.md) | [Conditional Validation](CONDITIONAL_VALIDATION.md) | [Rules & Schemas](RULES_AND_SCHEMAS.md) | [Custom Strategies](CUSTOM_STRATEGIES.md) | [Error Handling](ERROR_HANDLING.md) | [Internationalization](INTERNATIONALIZATION.md) | [Benchmarks](BENCHMARK.md)
 
 ### Run Benchmarks
 ```bash
 make benchmark          # Standard benchmarks
-make benchmark-stats    # With P50/P95/P99 percentiles
+make p99                # With P50/P95/P99 percentiles
 ```
 
 ### Results (PHP 8.5.1 + OPcache)
 
 **Core Operations** (P99):
-- Simple validation: **8.7μs** (99% < 9μs)
-- Complex nested: **16.4μs** (99% < 17μs)
-- Custom strategy: **11.2μs** (99% < 12μs)
+- Simple validation: **9.7μs**
+- Complex nested: **19.1μs**
+- Custom strategy: **14.2μs**
 
 **Batch Processing:**
-- Batch mode (100 fields): **~0.53ms**
-- Fail-fast mode (100 fields): **~0.23ms** → **2.3x faster**
+- Batch mode (100 fields): **572.9μs**
+- Fail-fast mode (100 fields): **256.1μs** → 2x faster
 
 **Conditional Validations** (P99):
-- Triggered: **8.5μs**
-- Not triggered: **5.7μs** ← Faster (validation skipped)
-- Failed + errors: **13μs** ← Most expensive (error rendering)
-- Complex AND/OR: **~6.1μs**
+- Triggered: **10.2μs**
+- Not triggered: **8.3μs** ← Faster (validation skipped)
+- Failed + errors: **16.2μs** ← Most expensive (error rendering)
+- Complex AND/OR: **7.8μs**
+- Deferred evaluation: **11.9μs**
+
+**Custom Validation Strategies** (P99):
+- Custom strategy execution: **14.2μs**
+- Load from directory (bootstrap): **29.4μs**
+
+**Rules & Schemas** (P99):
+- Rule registration: **1.4μs**
+- Rule application: **5.9μs**
+- Schema registration: **4.6μs**
+- Schema application: **7.7μs**
+- Schema vs manual: **7.7μs vs 12.3μs**
+- Schema with rules: **10.0μs**
+- Schema with conditionals: **9.4μs**
+
+**Batch Loading:**
+- Load 20 rules: **20.6μs**
+- Load 10 schemas: **45.9μs**
+
+**Translation:**
+- With translation: **17.3μs**
+- Without translation: **16.7μs**
+
+**Memory:** ~2MB
 
-**Translation Overhead:**
-- With translation: **14.6μs**
-- Without translation: **14.3μs**
-- **Overhead: ~2-3%** (negligible)
+### FrankenPHP Worker Mode
 
-**Memory:** ~4.9MB (stable, no leaks)
+Tested for long-running process stability:
+
+| Metric | Result |
+|--------|--------|
+| Requests | 3M+ |
+| Memory | 2MB stable (Δ0 after warmup) |
+| Throughput | ~3400 req/s (4 workers) |
+| Errors | 0 |
+
+✅ **Production-ready** for worker mode - no memory leaks detected.
 
 **Key Insights:**
-- ✅ **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
+- ✅ 99% of validations complete in <20μs
+- ✅ Fail-fast mode is 2.2x faster than batch mode
+- ✅ Schemas are 37% faster than manual validation (7.7μs vs 12.3μs)
+- ✅ Translation overhead is minimal (~3.6%)
+- ✅ Batch loading is efficient: 1μs per rule, 4.6μs per schema
+
+*Benchmarks: [PHPBench 1.4.3](https://github.com/phpbench/phpbench) • PHP 8.5.1 • OPcache enabled*
+
+---
+
+**Navigation:** [Validations](VALIDATIONS.md) | [Conditional Validation](CONDITIONAL_VALIDATION.md) | [Rules & Schemas](RULES_AND_SCHEMAS.md) | [Custom Strategies](CUSTOM_STRATEGIES.md) | [Error Handling](ERROR_HANDLING.md) | [Internationalization](INTERNATIONALIZATION.md) | [Benchmarks](BENCHMARK.md)
 
-*Benchmarks: [PHPBench 1.4.3](https://github.com/phpbench/phpbench) • PHP 8.5.1 • OPcache enabled*
+**[← Back to Main Documentation](../README.md)**

docs/CONDITIONAL_VALIDATION.md

@@ -1,5 +1,11 @@
 # Conditional Validation
 
+**[← Back to Main Documentation](../README.md)**
+
+**Navigation:** [Validations](VALIDATIONS.md) | **Conditional Validation** | [Rules & Schemas](RULES_AND_SCHEMAS.md) | [Custom Strategies](CUSTOM_STRATEGIES.md) | [Error Handling](ERROR_HANDLING.md) | [Internationalization](INTERNATIONALIZATION.md) | [Benchmarks](BENCHMARK.md)
+
+---
+
 DataVerify supports conditional validation where validation rules are only applied when specific conditions are met. Combine conditions using `and()` and `or()` operators.
 
 ## Table of Contents
@@ -475,6 +481,12 @@ $dv->field('vat_number')
 ## See Also
 
 - **[Validation Rules](VALIDATIONS.md)** - All available validation rules
+- **[Rules & Schemas](RULES_AND_SCHEMAS.md)** - Reusable validation patterns with conditionals
 - **[Error Handling](ERROR_HANDLING.md)** - Handle conditional validation errors
 - **[Custom Strategies](CUSTOM_STRATEGIES.md)** - Custom conditional logic
-- **[Internationalization](INTERNATIONALIZATION.md)** - Translate error messages
+
+---
+
+**Navigation:** [Validations](VALIDATIONS.md) | **Conditional Validation** | [Rules & Schemas](RULES_AND_SCHEMAS.md) | [Custom Strategies](CUSTOM_STRATEGIES.md) | [Error Handling](ERROR_HANDLING.md) | [Internationalization](INTERNATIONALIZATION.md) | [Benchmarks](BENCHMARK.md)
+
+**[← Back to Main Documentation](../README.md)**

docs/CUSTOM_STRATEGIES.md

@@ -1,5 +1,11 @@
 # Custom Validation Strategies
 
+**[← Back to Main Documentation](../README.md)**
+
+**Navigation:** [Validations](VALIDATIONS.md) | [Conditional Validation](CONDITIONAL_VALIDATION.md) | [Rules & Schemas](RULES_AND_SCHEMAS.md) | **Custom Strategies**(CUSTOM_STRATEGIES.md) | [Error Handling](ERROR_HANDLING.md) | [Internationalization](INTERNATIONALIZATION.md) | [Benchmarks](BENCHMARK.md)
+
+---
+
 Extend DataVerify with your own validation logic through custom strategies.
 
 ## Table of Contents
@@ -17,6 +23,11 @@ Extend DataVerify with your own validation logic through custom strategies.
 
 ## Quick Start
 ```php
+
+use Gravity\DataVerify;
+use Gravity\Interfaces\ValidationStrategyInterface;
+
+
 // 1. Create strategy
 // The #[ValidationRule] attribute enables auto-documentation generation and IDE stub creation (See IDE Autocompletion)
 #[ValidationRule(
@@ -441,4 +452,10 @@ $dv->registerStrategy(ValidationStrategyInterface $strategy): self
 - **[Validation Rules](VALIDATIONS.md)** - All built-in validation rules
 - **[Internationalization](INTERNATIONALIZATION.md)** - Add translations for custom strategies
 - **[Error Handling](ERROR_HANDLING.md)** - Custom error messages for strategies
-- **[Conditional Validation](CONDITIONAL_VALIDATION.md)** - Use strategies with conditions
+- **[Conditional Validation](CONDITIONAL_VALIDATION.md)** - Use strategies with conditions
+
+---
+
+**Navigation:** [Validations](VALIDATIONS.md) | [Conditional Validation](CONDITIONAL_VALIDATION.md) | [Rules & Schemas](RULES_AND_SCHEMAS.md) | [Custom Strategies](CUSTOM_STRATEGIES.md) | [Error Handling](ERROR_HANDLING.md) | [Internationalization](INTERNATIONALIZATION.md) | [Benchmarks](BENCHMARK.md)
+
+**[← Back to Main Documentation](../README.md)**

docs/ERROR_HANDLING.md

@@ -1,5 +1,11 @@
 # Error Handling
 
+**[← Back to Main Documentation](../README.md)**
+
+**Navigation:** [Validations](VALIDATIONS.md) | [Conditional Validation](CONDITIONAL_VALIDATION.md) | [Rules & Schemas](RULES_AND_SCHEMAS.md) | [Custom Strategies](CUSTOM_STRATEGIES.md) | **Error Handling**(ERROR_HANDLING.md) | [Internationalization](INTERNATIONALIZATION.md) | [Benchmarks](BENCHMARK.md)
+
+---
+
 DataVerify provides flexible error retrieval with detailed information about validation failures.
 
 ## Table of Contents
@@ -394,3 +400,10 @@ if (!$dv->verify()) {
 - **[Internationalization](INTERNATIONALIZATION.md)** - Multi-language error messages
 - **[Validation Rules](VALIDATIONS.md)** - All available validation rules
 - **[Custom Strategies](CUSTOM_STRATEGIES.md)** - Error messages for custom validations
+
+
+---
+
+**Navigation:** [Validations](VALIDATIONS.md) | [Conditional Validation](CONDITIONAL_VALIDATION.md) | [Rules & Schemas](RULES_AND_SCHEMAS.md) | [Custom Strategies](CUSTOM_STRATEGIES.md) | [Error Handling](ERROR_HANDLING.md) | [Internationalization](INTERNATIONALIZATION.md) | [Benchmarks](BENCHMARK.md)
+
+**[← Back to Main Documentation](../README.md)**

docs/INTERNATIONALIZATION.md

@@ -1,5 +1,11 @@
 # Internationalization (i18n)
 
+**[← Back to Main Documentation](../README.md)**
+
+**Navigation:** [Validations](VALIDATIONS.md) | [Conditional Validation](CONDITIONAL_VALIDATION.md) | [Rules & Schemas](RULES_AND_SCHEMAS.md) | [Custom Strategies](CUSTOM_STRATEGIES.md) | [Error Handling](ERROR_HANDLING.md) | **Internationalization**(INTERNATIONALIZATION.md) | [Benchmarks](BENCHMARK.md)
+
+---
+
 DataVerify includes a built-in translation system for validation error messages. Built-in languages (English, French) are automatically loaded - just set the locale.
 
 ## Table of Contents
@@ -403,3 +409,10 @@ class MyStrategy extends ValidationStrategy
 - **[Custom Strategies](CUSTOM_STRATEGIES.md)** - Parameter mapping for custom validations
 - **[Error Handling](ERROR_HANDLING.md)** - Working with translated errors
 - **[Validation Rules](VALIDATIONS.md)** - All validation rules
+
+
+---
+
+**Navigation:** [Validations](VALIDATIONS.md) | [Conditional Validation](CONDITIONAL_VALIDATION.md) | [Rules & Schemas](RULES_AND_SCHEMAS.md) | [Custom Strategies](CUSTOM_STRATEGIES.md) | [Error Handling](ERROR_HANDLING.md) | [Internationalization](INTERNATIONALIZATION.md) | [Benchmarks](BENCHMARK.md)
+
+**[← Back to Main Documentation](../README.md)**