refactor(core): migrate runtime classes to Validator namespace

This commit refactors the project structure by moving all runtime classes from the `Lemmon` namespace to the `Lemmon\Validator` namespace.

The following changes are included:
- All classes in `src/Lemmon` have been moved to `src/Lemmon/Validator`.
- The namespace in all affected classes has been updated to `Lemmon\Validator`.
- All documentation and examples have been updated to reflect the new namespace.
- All tests have been updated to use the new namespace.
- The `AGENTS.md` and `CHANGELOG.md` files have been updated to document the change.

This change improves the project structure and aligns with the architecture described in `AGENTS.md`.

Author: lemmon

AGENTS.md

@@ -4,6 +4,8 @@ A comprehensive, fluent validation library for PHP inspired by Valibot and Zod.
 
 ## Architecture
 
+- **Root Namespace** - Runtime classes live under `Lemmon\Validator`; tests use `Lemmon\Tests`
+
 ### Core Factory Pattern
 - **`Validator`** - Static factory creating type-specific validators (`isString()`, `isInt()`, `isFloat()`, `isArray()`, `isAssociative()`, `isObject()`, `isBool()`)
 - **`FieldValidator`** - Abstract base class with unified validation interface and shared functionality

CHANGELOG.md

@@ -3,6 +3,8 @@
 All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
+### Changed
+- Migrated all runtime classes to the `Lemmon\Validator` namespace and aligned documentation/examples with the new structure.
 
 ## [0.7.0] - 2025-10-19
 

README.md

@@ -49,8 +49,10 @@ Rather than reimplementing every possible transformation or validation rule, Lem
 
 ## Quick Start
 
+All runtime classes live under the `Lemmon\Validator` namespace.
+
 ```php
-use Lemmon\Validator;
+use Lemmon\Validator\Validator;
 
 // Simple validation with form-safe coercion
 $email = Validator::isString()

docs/examples/form-validation.md

@@ -36,8 +36,8 @@ This guide demonstrates how to use the Lemmon Validator for common form validati
 
 ```php
 <?php
-use Lemmon\Validator;
-use Lemmon\ValidationException;
+use Lemmon\Validator\Validator;
+use Lemmon\Validator\ValidationException;
 
 class ContactFormValidator
 {
@@ -272,11 +272,11 @@ if (!$result['valid']) {
 
 ```php
 <?php
-use Lemmon\Validator;
+use Lemmon\Validator\Validator;
 
 class UserRegistrationValidator
 {
-    public function createValidator(): \Lemmon\AssociativeValidator
+    public function createValidator(): \Lemmon\Validator\AssociativeValidator
     {
         return Validator::isAssociative([
             // Personal Information
@@ -366,7 +366,7 @@ class UserRegistrationValidator
         ]);
     }
 
-    private function createPasswordValidator(): \Lemmon\StringValidator
+    private function createPasswordValidator(): \Lemmon\Validator\StringValidator
     {
         return Validator::isString()
             ->required('Password is required')
@@ -483,11 +483,11 @@ class RegistrationController
 
 ```php
 <?php
-use Lemmon\Validator;
+use Lemmon\Validator\Validator;
 
 class ProductFormValidator
 {
-    public function createValidator(): \Lemmon\AssociativeValidator
+    public function createValidator(): \Lemmon\Validator\AssociativeValidator
     {
         return Validator::isAssociative([
             // Basic Information
@@ -668,7 +668,7 @@ class ProductFormValidator
 
 ```php
 <?php
-use Lemmon\Validator;
+use Lemmon\Validator\Validator;
 
 class MultiStepRegistrationValidator
 {

docs/getting-started/basic-usage.md

@@ -7,7 +7,7 @@ This guide covers the fundamental concepts and usage patterns of the Lemmon Vali
 All validation starts with the `Validator` factory class, which provides static methods to create specific validator instances:
 
 ```php
-use Lemmon\Validator;
+use Lemmon\Validator\Validator;
 
 // Create validators for different types
 $stringValidator = Validator::isString();

docs/getting-started/core-concepts.md

@@ -21,7 +21,7 @@ Validation Rules (email(), min(), etc.)
 The `Validator` class is a factory that creates specific validator instances:
 
 ```php
-use Lemmon\Validator;
+use Lemmon\Validator\Validator;
 
 // Factory methods create specific validators
 $string = Validator::isString();    // → StringValidator

docs/getting-started/installation.md

@@ -21,7 +21,7 @@ The package follows PSR-4 autoloading standards. If you're using Composer's auto
 <?php
 require_once 'vendor/autoload.php';
 
-use Lemmon\Validator;
+use Lemmon\Validator\Validator;
 
 // Ready to use!
 $validator = Validator::isString();
@@ -35,7 +35,7 @@ Verify your installation by running a simple validation:
 <?php
 require_once 'vendor/autoload.php';
 
-use Lemmon\Validator;
+use Lemmon\Validator\Validator;
 
 try {
     $result = Validator::isString()->email()->validate('test@example.com');

docs/guides/array-validation.md

@@ -15,7 +15,7 @@ This guide covers array validation using the `ArrayValidator` class, which handl
 ### Simple Array Validation
 
 ```php
-use Lemmon\Validator;
+use Lemmon\Validator\Validator;
 
 // Validate indexed arrays
 $validator = Validator::isArray();
@@ -293,7 +293,7 @@ $result = $nestedArray->validate([
 ### Basic Error Handling
 
 ```php
-use Lemmon\ValidationException;
+use Lemmon\Validator\ValidationException;
 
 $validator = Validator::isArray();
 

docs/guides/custom-validation.md

@@ -7,7 +7,7 @@ The Lemmon Validator allows you to add custom validation logic using the `satisf
 ### Simple Custom Rule
 
 ```php
-use Lemmon\Validator;
+use Lemmon\Validator\Validator;
 
 $validator = Validator::isString()->satisfies(
     function ($value) {

docs/guides/error-handling.md

@@ -11,8 +11,8 @@ The library provides two validation approaches with different error handling str
 Throws a `ValidationException` when validation fails:
 
 ```php
-use Lemmon\Validator;
-use Lemmon\ValidationException;
+use Lemmon\Validator\Validator;
+use Lemmon\Validator\ValidationException;
 
 $validator = Validator::isString()->email();