diff --git a/README.md b/README.md
index 9b896ae..fe84766 100644
--- a/README.md
+++ b/README.md
@@ -1,76 +1,900 @@
-# KaririCode Framework: transformer Component
+# KaririCode Framework: Transformer Component
 
-## Development and Testing
+A powerful and flexible data transformation component for PHP, part of the KaririCode Framework. It uses attribute-based transformation with configurable processors to ensure consistent data transformation and formatting in your applications.
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Usage](#usage)
+  - [Basic Usage](#basic-usage)
+  - [Advanced Usage: Data Formatting](#advanced-usage-data-formatting)
+- [Available Transformers](#available-transformers)
+  - [String Transformers](#string-transformers)
+  - [Data Transformers](#data-transformers)
+  - [Array Transformers](#array-transformers)
+  - [Composite Transformers](#composite-transformers)
+- [Configuration](#configuration)
+- [Integration with Other KaririCode Components](#integration-with-other-kariricode-components)
+- [Development and Testing](#development-and-testing)
+- [Contributing](#contributing)
+- [License](#license)
+- [Support and Community](#support-and-community)
+
+## Features
+
+- Attribute-based transformation for object properties
+- Comprehensive set of built-in transformers for common use cases
+- Easy integration with other KaririCode components
+- Configurable processors for customized transformation logic
+- Extensible architecture allowing custom transformers
+- Robust error handling and reporting
+- Chainable transformation pipelines for complex data transformation
+- Built-in support for multiple transformation scenarios
+- Type-safe transformation with PHP 8.3 features
+- Preservation of original data types
+- Flexible formatting options for various data types
+
+## Installation
+
+You can install the Transformer component via Composer:
+
+```bash
+composer require kariricode/transformer
+```
+
+### Requirements
+
+- PHP 8.3 or higher
+- Composer
+- Extensions: `ext-mbstring`, `ext-json`
+
+## Usage
+
+### Basic Usage
+
+1. Define your data class with transformation attributes:
+
+```php
+use KaririCode\Transformer\Attribute\Transform;
+
+class DataFormatter
+{
+    #[Transform(
+        processors: ['date' => ['inputFormat' => 'd/m/Y', 'outputFormat' => 'Y-m-d']]
+    )]
+    private string $date = '25/12/2024';
+
+    #[Transform(
+        processors: ['number' => ['decimals' => 2, 'decimalPoint' => ',', 'thousandsSeparator' => '.']]
+    )]
+    private float $price = 1234.56;
+
+    #[Transform(
+        processors: ['mask' => ['type' => 'phone']]
+    )]
+    private string $phone = '11999887766';
+
+    // Getters and setters...
+}
+```
+
+2. Set up the transformer and use it:
+
+```php
+use KaririCode\ProcessorPipeline\ProcessorRegistry;
+use KaririCode\Transformer\Transformer;
+use KaririCode\Transformer\Processor\Data\{DateTransformer, NumberTransformer};
+use KaririCode\Transformer\Processor\String\MaskTransformer;
+
+$registry = new ProcessorRegistry();
+$registry->register('transformer', 'date', new DateTransformer());
+$registry->register('transformer', 'number', new NumberTransformer());
+$registry->register('transformer', 'mask', new MaskTransformer());
+
+$transformer = new Transformer($registry);
+
+$formatter = new DataFormatter();
+$result = $transformer->transform($formatter);
+
+if ($result->isValid()) {
+    echo "Date: " . $formatter->getDate() . "\n";          // Output: 2024-12-25
+    echo "Price: " . $formatter->getPrice() . "\n";        // Output: 1.234,56
+    echo "Phone: " . $formatter->getPhone() . "\n";        // Output: (11) 99988-7766
+}
+```
+
+### Advanced Usage: Data Formatting
+
+Here's an example of how to use the KaririCode Transformer in a real-world scenario, demonstrating various transformation capabilities:
+
+```php
+use KaririCode\Transformer\Attribute\Transform;
+
+class ComplexDataTransformer
+{
+    #[Transform(
+        processors: ['case' => ['case' => 'snake']]
+    )]
+    private string $text = 'transformThisTextToSnakeCase';
+
+    #[Transform(
+        processors: ['slug' => []]
+    )]
+    private string $title = 'This is a Title for URL!';
+
+    #[Transform(
+        processors: ['arrayKey' => ['case' => 'camel']]
+    )]
+    private array $data = [
+        'user_name' => 'John Doe',
+        'email_address' => 'john@example.com',
+        'phone_number' => '1234567890'
+    ];
+
+    #[Transform(
+        processors: [
+            'template' => [
+                'template' => 'Hello {{name}}, your order #{{order_id}} is {{status}}',
+                'removeUnmatchedTags' => true,
+                'preserveData' => true
+            ]
+        ]
+    )]
+    private array $templateData = [
+        'name' => 'John',
+        'order_id' => '12345',
+        'status' => 'completed'
+    ];
+
+    // Getters and setters...
+}
+```
+
+## Practical Examples
+
+### 1. String Transformation Examples
+
+```php
+class StringTransformerExample
+{
+    #[Transform(
+        processors: ['case' => ['case' => 'snake']]
+    )]
+    private string $methodName = 'getUserProfileData';
+
+    #[Transform(
+        processors: ['case' => ['case' => 'camel']]
+    )]
+    private string $variableName = 'user_profile_data';
+
+    #[Transform(
+        processors: ['slug' => ['separator' => '-']]
+    )]
+    private string $articleTitle = 'How to Use PHP 8.3 Features!';
+
+    #[Transform(
+        processors: ['mask' => ['type' => 'phone']]
+    )]
+    private string $phoneNumber = '11999887766';
+}
+
+// Output:
+// methodName: get_user_profile_data
+// variableName: userProfileData
+// articleTitle: how-to-use-php-8-3-features
+// phoneNumber: (11) 99988-7766
+```
+
+### 2. Number and Currency Formatting
+
+```php
+class CurrencyTransformerExample
+{
+    #[Transform(
+        processors: ['number' => [
+            'decimals' => 2,
+            'decimalPoint' => ',',
+            'thousandsSeparator' => '.'
+        ]]
+    )]
+    private float $price = 1234567.89;
+
+    #[Transform(
+        processors: ['number' => [
+            'decimals' => 0,
+            'thousandsSeparator' => ','
+        ]]
+    )]
+    private int $quantity = 1000000;
+}
+
+// Output:
+// price: 1.234.567,89
+// quantity: 1,000,000
+```
+
+### 3. Date Transformation for Different Locales
+
+```php
+class DateTransformerExample
+{
+    #[Transform(
+        processors: ['date' => [
+            'inputFormat' => 'd/m/Y',
+            'outputFormat' => 'Y-m-d'
+        ]]
+    )]
+    private string $sqlDate = '25/12/2024';
+
+    #[Transform(
+        processors: ['date' => [
+            'inputFormat' => 'Y-m-d',
+            'outputFormat' => 'F j, Y'
+        ]]
+    )]
+    private string $displayDate = '2024-12-25';
+
+    #[Transform(
+        processors: ['date' => [
+            'inputFormat' => 'Y-m-d H:i:s',
+            'outputFormat' => 'd/m/Y H:i',
+            'inputTimezone' => 'UTC',
+            'outputTimezone' => 'America/Sao_Paulo'
+        ]]
+    )]
+    private string $timestamp = '2024-12-25 15:30:00';
+}
+
+// Output:
+// sqlDate: 2024-12-25
+// displayDate: December 25, 2024
+// timestamp: 25/12/2024 12:30
+```
+
+### 4. Array Transformation for API Response
+
+```php
+class ApiResponseTransformerExample
+{
+    #[Transform(
+        processors: ['arrayKey' => ['case' => 'camel']]
+    )]
+    private array $userData = [
+        'user_id' => 123,
+        'first_name' => 'John',
+        'last_name' => 'Doe',
+        'email_address' => 'john@example.com',
+        'phone_numbers' => [
+            'home_phone' => '1234567890',
+            'work_phone' => '0987654321'
+        ]
+    ];
+
+    #[Transform(
+        processors: ['arrayFlat' => ['separator' => '.']]
+    )]
+    private array $nestedConfig = [
+        'database' => [
+            'mysql' => [
+                'host' => 'localhost',
+                'port' => 3306
+            ]
+        ],
+        'cache' => [
+            'redis' => [
+                'host' => '127.0.0.1',
+                'port' => 6379
+            ]
+        ]
+    ];
+}
+
+// Output:
+// userData:
+// {
+//     "userId": 123,
+//     "firstName": "John",
+//     "lastName": "Doe",
+//     "emailAddress": "john@example.com",
+//     "phoneNumbers": {
+//         "homePhone": "1234567890",
+//         "workPhone": "0987654321"
+//     }
+// }
+//
+// nestedConfig:
+// {
+//     "database.mysql.host": "localhost",
+//     "database.mysql.port": 3306,
+//     "cache.redis.host": "127.0.0.1",
+//     "cache.redis.port": 6379
+// }
+```
+
+### 5. Template Transformation for Notifications
+
+```php
+class NotificationTransformerExample
+{
+    #[Transform(
+        processors: [
+            'template' => [
+                'template' => <<<TEMPLATE
+                Dear {{userName}},
+
+                Your order #{{orderId}} has been {{status}}.
+                {{#if tracking}}
+                Track your package: {{tracking}}
+                {{/if}}
+
+                Total: {{currency}}{{amount}}
+
+                Best regards,
+                {{companyName}}
+                TEMPLATE,
+                'preserveData' => true
+            ]
+        ]
+    )]
+    private array $emailData = [
+        'userName' => 'John Doe',
+        'orderId' => 'ORD-12345',
+        'status' => 'shipped',
+        'tracking' => 'TRACK-XYZ-789',
+        'currency' => '$',
+        'amount' => '299.99',
+        'companyName' => 'KaririCode Store'
+    ];
+}
+
+// Output:
+// Original Data:
+// {
+//     "userName": "John Doe",
+//     "orderId": "ORD-12345",
+//     "status": "shipped",
+//     "tracking": "TRACK-XYZ-789",
+//     "currency": "$",
+//     "amount": "299.99",
+//     "companyName": "KaririCode Store"
+// }
+//
+// Rendered Template:
+// Dear John Doe,
+//
+// Your order #ORD-12345 has been shipped.
+// Track your package: TRACK-XYZ-789
+//
+// Total: $299.99
+//
+// Best regards,
+// KaririCode Store
+```
+
+### 6. Chain Transformation Example
+
+```php
+class ChainTransformerExample
+{
+    #[Transform(
+        processors: [
+            'case' => ['case' => 'lower'],
+            'slug' => ['separator' => '-'],
+            'template' => [
+                'template' => '{{date}}-{{slug}}',
+                'preserveData' => true
+            ]
+        ]
+    )]
+    private array $urlData = [
+        'date' => '2024-01-15',
+        'slug' => 'How to Chain Multiple Transformers'
+    ];
+}
+
+// Output:
+// 2024-01-15-how-to-chain-multiple-transformers
+```
+
+## Available Transformers
+
+### String Transformers
+
+- **CaseTransformer**: Transforms string case (camel, snake, pascal, kebab).
+
+  - **Configuration Options**:
+    - `case`: Target case format (lower, upper, title, sentence, camel, pascal, snake, kebab)
+    - `preserveNumbers`: Whether to preserve numbers in transformation
+
+- **MaskTransformer**: Applies masks to strings (phone, CPF, CNPJ, etc.).
+
+  - **Configuration Options**:
+    - `mask`: Custom mask pattern
+    - `type`: Predefined mask type
+    - `placeholder`: Mask placeholder character
+
+- **SlugTransformer**: Generates URL-friendly slugs.
+
+  - **Configuration Options**:
+    - `separator`: Separator character
+    - `lowercase`: Convert to lowercase
+    - `replacements`: Custom character replacements
+
+- **TemplateTransformer**: Processes templates with variable substitution.
+  - **Configuration Options**:
+    - `template`: Template string
+    - `removeUnmatchedTags`: Remove unmatched placeholders
+    - `preserveData`: Keep original data in result
+
+### Data Transformers
+
+- **DateTransformer**: Converts between date formats.
+
+  - **Configuration Options**:
+    - `inputFormat`: Input date format
+    - `outputFormat`: Output date format
+    - `inputTimezone`: Input timezone
+    - `outputTimezone`: Output timezone
+
+- **NumberTransformer**: Formats numbers with locale-specific settings.
+
+  - **Configuration Options**:
+    - `decimals`: Number of decimal places
+    - `decimalPoint`: Decimal separator
+    - `thousandsSeparator`: Thousands separator
+    - `roundUp`: Round up decimals
+
+- **JsonTransformer**: Handles JSON encoding/decoding.
+  - **Configuration Options**:
+    - `encodeOptions`: JSON encoding options
+    - `preserveType`: Keep original data type
+    - `assoc`: Use associative arrays
+
+### Array Transformers
+
+- **ArrayFlattenTransformer**: Flattens nested arrays.
+
+  - **Configuration Options**:
+    - `depth`: Maximum depth to flatten
+    - `separator`: Key separator for flattened structure
+
+- **ArrayGroupTransformer**: Groups array elements by key.
+
+  - **Configuration Options**:
+    - `groupBy`: Key to group by
+    - `preserveKeys`: Maintain original keys
+
+- **ArrayKeyTransformer**: Transforms array keys.
+
+  - **Configuration Options**:
+    - `case`: Target case for keys
+    - `recursive`: Apply to nested arrays
+
+- **ArrayMapTransformer**: Maps array keys to new structure.
+  - **Configuration Options**:
+    - `mapping`: Key mapping configuration
+    - `removeUnmapped`: Remove unmapped keys
+    - `recursive`: Apply to nested arrays
+
+### Composite Transformers
+
+- **ChainTransformer**: Executes multiple transformers in sequence.
+
+  - **Configuration Options**:
+    - `transformers`: Array of transformers to execute
+    - `stopOnError`: Stop chain on first error
+
+- **ConditionalTransformer**: Applies transformations based on conditions.
+  - **Configuration Options**:
+    - `condition`: Condition callback
+    - `transformer`: Transformer to apply
+    - `defaultValue`: Value when condition fails
+
+## Configuration
+
+Transformers can be configured globally or per-instance. Example of configuring the NumberTransformer:
+
+```php
+use KaririCode\Transformer\Processor\Data\NumberTransformer;
+
+$numberTransformer = new NumberTransformer();
+$numberTransformer->configure([
+    'decimals' => 2,
+    'decimalPoint' => ',',
+    'thousandsSeparator' => '.',
+]);
 
-For development and testing purposes, this package uses Docker and Docker Compose to ensure consistency across different environments. A Makefile is provided for convenience.
+$registry->register('transformer', 'number', $numberTransformer);
+```
 
-### Prerequisites
+## Integration with Other KaririCode Components
 
-- Docker
-- Docker Compose
-- Make (optional, but recommended for easier command execution)
+The Transformer component integrates with:
 
-### Development Setup
+- **KaririCode\Contract**: Provides interfaces for component integration
+- **KaririCode\ProcessorPipeline**: Used for transformation pipelines
+- **KaririCode\PropertyInspector**: Processes transformation attributes
 
-1. Clone the repository:
+## Registry Example
 
-   ```bash
-   git clone https://github.com/KaririCode-Framework/kariricode-transformer.git
-   cd kariricode-transformer
-   ```
+Complete registry setup example:
 
-2. Set up the environment:
+```php
+$registry = new ProcessorRegistry();
 
-   ```bash
-   make setup-env
-   ```
+// Register String Transformers
+$registry->register('transformer', 'case', new CaseTransformer())
+         ->register('transformer', 'mask', new MaskTransformer())
+         ->register('transformer', 'slug', new SlugTransformer())
+         ->register('transformer', 'template', new TemplateTransformer());
 
-3. Start the Docker containers:
+// Register Data Transformers
+$registry->register('transformer', 'date', new DateTransformer())
+         ->register('transformer', 'number', new NumberTransformer())
+         ->register('transformer', 'json', new JsonTransformer());
 
-   ```bash
-   make up
-   ```
+// Register Array Transformers
+$registry->register('transformer', 'arrayFlat', new ArrayFlattenTransformer())
+         ->register('transformer', 'arrayGroup', new ArrayGroupTransformer())
+         ->register('transformer', 'arrayKey', new ArrayKeyTransformer())
+         ->register('transformer', 'arrayMap', new ArrayMapTransformer());
+```
 
-4. Install dependencies:
+## Development and Testing
 
-   ```bash
-   make composer-install
-   ```
+Similar development setup as the Validator component, using Docker and Make commands.
 
 ### Available Make Commands
 
-- `make up`: Start all services in the background
-- `make down`: Stop and remove all containers
-- `make build`: Build Docker images
-- `make shell`: Access the PHP container shell
+- `make up`: Start services
+- `make down`: Stop services
 - `make test`: Run tests
-- `make coverage`: Run test coverage with visual formatting
-- `make cs-fix`: Run PHP CS Fixer to fix code style
-- `make quality`: Run all quality commands (cs-check, test, security-check)
+- `make coverage`: Generate coverage report
+- `make cs-fix`: Fix code style
+- `make quality`: Run quality checks
 
 ## Contributing
 
-We welcome contributions to the KaririCode transformer component! Here's how you can contribute:
+Contributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md).
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file.
+
+## Support and Community
+
+- **Documentation**: [https://kariricode.org/docs/transformer](https://kariricode.org/docs/transformer)
+- **Issues**: [GitHub Issues](https://github.com/KaririCode-Framework/kariricode-transformer/issues)
+- **Forum**: [KaririCode Club Community](https://kariricode.club)
+- **Stack Overflow**: Tag with `kariricode-transformer`
+
+---
+
+Built with ❤️ by the KaririCode team. Transforming data with elegance and precision.# KaririCode Framework: Transformer Component
+
+A powerful and flexible data transformation component for PHP, part of the KaririCode Framework. It uses attribute-based transformation with configurable processors to ensure consistent data transformation and formatting in your applications.
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Usage](#usage)
+  - [Basic Usage](#basic-usage)
+  - [Advanced Usage: Data Formatting](#advanced-usage-data-formatting)
+- [Available Transformers](#available-transformers)
+  - [String Transformers](#string-transformers)
+  - [Data Transformers](#data-transformers)
+  - [Array Transformers](#array-transformers)
+  - [Composite Transformers](#composite-transformers)
+- [Configuration](#configuration)
+- [Integration with Other KaririCode Components](#integration-with-other-kariricode-components)
+- [Development and Testing](#development-and-testing)
+- [Contributing](#contributing)
+- [License](#license)
+- [Support and Community](#support-and-community)
+
+## Features
+
+- Attribute-based transformation for object properties
+- Comprehensive set of built-in transformers for common use cases
+- Easy integration with other KaririCode components
+- Configurable processors for customized transformation logic
+- Extensible architecture allowing custom transformers
+- Robust error handling and reporting
+- Chainable transformation pipelines for complex data transformation
+- Built-in support for multiple transformation scenarios
+- Type-safe transformation with PHP 8.3 features
+- Preservation of original data types
+- Flexible formatting options for various data types
+
+## Installation
+
+You can install the Transformer component via Composer:
+
+```bash
+composer require kariricode/transformer
+```
+
+### Requirements
+
+- PHP 8.3 or higher
+- Composer
+- Extensions: `ext-mbstring`, `ext-json`
+
+## Usage
+
+### Basic Usage
+
+1. Define your data class with transformation attributes:
+
+```php
+use KaririCode\Transformer\Attribute\Transform;
+
+class DataFormatter
+{
+    #[Transform(
+        processors: ['date' => ['inputFormat' => 'd/m/Y', 'outputFormat' => 'Y-m-d']]
+    )]
+    private string $date = '25/12/2024';
+
+    #[Transform(
+        processors: ['number' => ['decimals' => 2, 'decimalPoint' => ',', 'thousandsSeparator' => '.']]
+    )]
+    private float $price = 1234.56;
+
+    #[Transform(
+        processors: ['mask' => ['type' => 'phone']]
+    )]
+    private string $phone = '11999887766';
+
+    // Getters and setters...
+}
+```
+
+2. Set up the transformer and use it:
+
+```php
+use KaririCode\ProcessorPipeline\ProcessorRegistry;
+use KaririCode\Transformer\Transformer;
+use KaririCode\Transformer\Processor\Data\{DateTransformer, NumberTransformer};
+use KaririCode\Transformer\Processor\String\MaskTransformer;
+
+$registry = new ProcessorRegistry();
+$registry->register('transformer', 'date', new DateTransformer());
+$registry->register('transformer', 'number', new NumberTransformer());
+$registry->register('transformer', 'mask', new MaskTransformer());
+
+$transformer = new Transformer($registry);
+
+$formatter = new DataFormatter();
+$result = $transformer->transform($formatter);
+
+if ($result->isValid()) {
+    echo "Date: " . $formatter->getDate() . "\n";          // Output: 2024-12-25
+    echo "Price: " . $formatter->getPrice() . "\n";        // Output: 1.234,56
+    echo "Phone: " . $formatter->getPhone() . "\n";        // Output: (11) 99988-7766
+}
+```
+
+### Advanced Usage: Data Formatting
+
+Here's an example of how to use the KaririCode Transformer in a real-world scenario, demonstrating various transformation capabilities:
+
+```php
+use KaririCode\Transformer\Attribute\Transform;
+
+class ComplexDataTransformer
+{
+    #[Transform(
+        processors: ['case' => ['case' => 'snake']]
+    )]
+    private string $text = 'transformThisTextToSnakeCase';
+
+    #[Transform(
+        processors: ['slug' => []]
+    )]
+    private string $title = 'This is a Title for URL!';
+
+    #[Transform(
+        processors: ['arrayKey' => ['case' => 'camel']]
+    )]
+    private array $data = [
+        'user_name' => 'John Doe',
+        'email_address' => 'john@example.com',
+        'phone_number' => '1234567890'
+    ];
+
+    #[Transform(
+        processors: [
+            'template' => [
+                'template' => 'Hello {{name}}, your order #{{order_id}} is {{status}}',
+                'removeUnmatchedTags' => true,
+                'preserveData' => true
+            ]
+        ]
+    )]
+    private array $templateData = [
+        'name' => 'John',
+        'order_id' => '12345',
+        'status' => 'completed'
+    ];
+
+    // Getters and setters...
+}
+```
+
+## Available Transformers
+
+### String Transformers
+
+- **CaseTransformer**: Transforms string case (camel, snake, pascal, kebab).
 
-1. Fork the repository
-2. Create a new branch for your feature or bug fix
-3. Write tests for your changes
-4. Implement your changes
-5. Run the test suite and ensure all tests pass
-6. Submit a pull request with a clear description of your changes
+  - **Configuration Options**:
+    - `case`: Target case format (lower, upper, title, sentence, camel, pascal, snake, kebab)
+    - `preserveNumbers`: Whether to preserve numbers in transformation
+
+- **MaskTransformer**: Applies masks to strings (phone, CPF, CNPJ, etc.).
+
+  - **Configuration Options**:
+    - `mask`: Custom mask pattern
+    - `type`: Predefined mask type
+    - `placeholder`: Mask placeholder character
+
+- **SlugTransformer**: Generates URL-friendly slugs.
+
+  - **Configuration Options**:
+    - `separator`: Separator character
+    - `lowercase`: Convert to lowercase
+    - `replacements`: Custom character replacements
+
+- **TemplateTransformer**: Processes templates with variable substitution.
+  - **Configuration Options**:
+    - `template`: Template string
+    - `removeUnmatchedTags`: Remove unmatched placeholders
+    - `preserveData`: Keep original data in result
+
+### Data Transformers
+
+- **DateTransformer**: Converts between date formats.
+
+  - **Configuration Options**:
+    - `inputFormat`: Input date format
+    - `outputFormat`: Output date format
+    - `inputTimezone`: Input timezone
+    - `outputTimezone`: Output timezone
+
+- **NumberTransformer**: Formats numbers with locale-specific settings.
+
+  - **Configuration Options**:
+    - `decimals`: Number of decimal places
+    - `decimalPoint`: Decimal separator
+    - `thousandsSeparator`: Thousands separator
+    - `roundUp`: Round up decimals
+
+- **JsonTransformer**: Handles JSON encoding/decoding.
+  - **Configuration Options**:
+    - `encodeOptions`: JSON encoding options
+    - `preserveType`: Keep original data type
+    - `assoc`: Use associative arrays
+
+### Array Transformers
+
+- **ArrayFlattenTransformer**: Flattens nested arrays.
+
+  - **Configuration Options**:
+    - `depth`: Maximum depth to flatten
+    - `separator`: Key separator for flattened structure
+
+- **ArrayGroupTransformer**: Groups array elements by key.
+
+  - **Configuration Options**:
+    - `groupBy`: Key to group by
+    - `preserveKeys`: Maintain original keys
+
+- **ArrayKeyTransformer**: Transforms array keys.
+
+  - **Configuration Options**:
+    - `case`: Target case for keys
+    - `recursive`: Apply to nested arrays
+
+- **ArrayMapTransformer**: Maps array keys to new structure.
+  - **Configuration Options**:
+    - `mapping`: Key mapping configuration
+    - `removeUnmapped`: Remove unmapped keys
+    - `recursive`: Apply to nested arrays
+
+### Composite Transformers
+
+- **ChainTransformer**: Executes multiple transformers in sequence.
+
+  - **Configuration Options**:
+    - `transformers`: Array of transformers to execute
+    - `stopOnError`: Stop chain on first error
+
+- **ConditionalTransformer**: Applies transformations based on conditions.
+  - **Configuration Options**:
+    - `condition`: Condition callback
+    - `transformer`: Transformer to apply
+    - `defaultValue`: Value when condition fails
+
+## Configuration
+
+Transformers can be configured globally or per-instance. Example of configuring the NumberTransformer:
+
+```php
+use KaririCode\Transformer\Processor\Data\NumberTransformer;
+
+$numberTransformer = new NumberTransformer();
+$numberTransformer->configure([
+    'decimals' => 2,
+    'decimalPoint' => ',',
+    'thousandsSeparator' => '.',
+]);
+
+$registry->register('transformer', 'number', $numberTransformer);
+```
+
+## Integration with Other KaririCode Components
+
+The Transformer component integrates with:
+
+- **KaririCode\Contract**: Provides interfaces for component integration
+- **KaririCode\ProcessorPipeline**: Used for transformation pipelines
+- **KaririCode\PropertyInspector**: Processes transformation attributes
+
+## Registry Example
+
+Complete registry setup example:
+
+```php
+$registry = new ProcessorRegistry();
+
+// Register String Transformers
+$registry->register('transformer', 'case', new CaseTransformer())
+         ->register('transformer', 'mask', new MaskTransformer())
+         ->register('transformer', 'slug', new SlugTransformer())
+         ->register('transformer', 'template', new TemplateTransformer());
+
+// Register Data Transformers
+$registry->register('transformer', 'date', new DateTransformer())
+         ->register('transformer', 'number', new NumberTransformer())
+         ->register('transformer', 'json', new JsonTransformer());
+
+// Register Array Transformers
+$registry->register('transformer', 'arrayFlat', new ArrayFlattenTransformer())
+         ->register('transformer', 'arrayGroup', new ArrayGroupTransformer())
+         ->register('transformer', 'arrayKey', new ArrayKeyTransformer())
+         ->register('transformer', 'arrayMap', new ArrayMapTransformer());
+```
+
+## Development and Testing
+
+Similar development setup as the Validator component, using Docker and Make commands.
+
+### Available Make Commands
+
+- `make up`: Start services
+- `make down`: Stop services
+- `make test`: Run tests
+- `make coverage`: Generate coverage report
+- `make cs-fix`: Fix code style
+- `make quality`: Run quality checks
+
+## Contributing
 
-Please read our [Contributing Guide](CONTRIBUTING.md) for more details on our code of conduct and development process.
+Contributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md).
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+MIT License - see [LICENSE](LICENSE) file.
 
 ## Support and Community
 
 - **Documentation**: [https://kariricode.org/docs/transformer](https://kariricode.org/docs/transformer)
-- **Issue Tracker**: [GitHub Issues](https://github.com/KaririCode-Framework/kariricode-transformer/issues)
-- **Community Forum**: [KaririCode Club Community](https://kariricode.club)
-- **Stack Overflow**: Tag your questions with `kariricode-transformer`
+- **Issues**: [GitHub Issues](https://github.com/KaririCode-Framework/kariricode-transformer/issues)
+- **Forum**: [KaririCode Club Community](https://kariricode.club)
+- **Stack Overflow**: Tag with `kariricode-transformer`
 
 ---
 
diff --git a/README.pt-br.md b/README.pt-br.md
index 3c1fa1a..09059a0 100644
--- a/README.pt-br.md
+++ b/README.pt-br.md
@@ -1,77 +1,574 @@
-# Framework KaririCode: transformer Component
+# KaririCode Framework: Transformer Component
 
-## Desenvolvimento e Testes
+Um componente poderoso e flexível para transformação de dados em PHP, parte do KaririCode Framework. Utiliza transformação baseada em atributos com processadores configuráveis para garantir consistência na transformação e formatação de dados em suas aplicações.
 
-Para fins de desenvolvimento e teste, este pacote usa Docker e Docker Compose para garantir consistência em diferentes ambientes. Um Makefile é fornecido para conveniência.
+## Índice
 
-### Pré-requisitos
+- [Funcionalidades](#funcionalidades)
+- [Instalação](#instalação)
+- [Uso](#uso)
+  - [Uso Básico](#uso-básico)
+  - [Uso Avançado: Formatação de Dados](#uso-avançado-formatação-de-dados)
+- [Transformadores Disponíveis](#transformadores-disponíveis)
+  - [Transformadores de String](#transformadores-de-string)
+  - [Transformadores de Dados](#transformadores-de-dados)
+  - [Transformadores de Array](#transformadores-de-array)
+  - [Transformadores Compostos](#transformadores-compostos)
+- [Configuração](#configuração)
+- [Integração com Outros Componentes KaririCode](#integração-com-outros-componentes-kariricode)
+- [Desenvolvimento e Testes](#desenvolvimento-e-testes)
+- [Contribuindo](#contribuindo)
+- [Licença](#licença)
+- [Suporte e Comunidade](#suporte-e-comunidade)
 
-- Docker
-- Docker Compose
-- Make (opcional, mas recomendado para execução mais fácil de comandos)
+## Funcionalidades
 
-### Configuração de Desenvolvimento
+- Transformação baseada em atributos para propriedades de objetos
+- Conjunto abrangente de transformadores integrados para casos comuns
+- Fácil integração com outros componentes KaririCode
+- Processadores configuráveis para lógica de transformação personalizada
+- Arquitetura extensível permitindo transformadores personalizados
+- Tratamento e relatório de erros robusto
+- Pipeline de transformação encadeável para transformações complexas
+- Suporte integrado para múltiplos cenários de transformação
+- Transformação com segurança de tipos com recursos do PHP 8.3
+- Preservação dos tipos de dados originais
+- Opções flexíveis de formatação para diversos tipos de dados
 
-1. Clone o repositório:
+## Instalação
 
-   ```bash
-   git clone https://github.com/KaririCode-Framework/kariricode-transformer.git
-   cd kariricode-transformer
-   ```
+Você pode instalar o componente Transformer via Composer:
 
-2. Configure o ambiente:
+```bash
+composer require kariricode/transformer
+```
 
-   ```bash
-   make setup-env
-   ```
+### Requisitos
 
-3. Inicie os containers Docker:
+- PHP 8.3 ou superior
+- Composer
+- Extensões: `ext-mbstring`, `ext-json`
 
-   ```bash
-   make up
-   ```
+## Uso
 
-4. Instale as dependências:
+### Uso Básico
 
-   ```bash
-   make composer-install
-   ```
+1. Defina sua classe de dados com atributos de transformação:
 
-### Comandos Make Disponíveis
+```php
+use KaririCode\Transformer\Attribute\Transform;
 
-- `make up`: Inicia todos os serviços em segundo plano
-- `make down`: Para e remove todos os containers
-- `make build`: Constrói imagens Docker
-- `make shell`: Acessa o shell do container PHP
-- `make test`: Executa testes
-- `make coverage`: Executa cobertura de testes com formatação visual
-- `make cs-fix`: Executa PHP CS Fixer para corrigir estilo de código
-- `make quality`: Executa todos os comandos de qualidade (cs-check, test, security-check)
+class FormatadorDados
+{
+    #[Transform(
+        processors: ['date' => ['inputFormat' => 'd/m/Y', 'outputFormat' => 'Y-m-d']]
+    )]
+    private string $data = '25/12/2024';
 
-## Contribuindo
+    #[Transform(
+        processors: ['number' => ['decimals' => 2, 'decimalPoint' => ',', 'thousandsSeparator' => '.']]
+    )]
+    private float $preco = 1234.56;
+
+    #[Transform(
+        processors: ['mask' => ['type' => 'phone']]
+    )]
+    private string $telefone = '11999887766';
+
+    // Getters e setters...
+}
+```
+
+2. Configure o transformador e utilize-o:
+
+```php
+use KaririCode\ProcessorPipeline\ProcessorRegistry;
+use KaririCode\Transformer\Transformer;
+use KaririCode\Transformer\Processor\Data\{DateTransformer, NumberTransformer};
+use KaririCode\Transformer\Processor\String\MaskTransformer;
+
+$registry = new ProcessorRegistry();
+$registry->register('transformer', 'date', new DateTransformer());
+$registry->register('transformer', 'number', new NumberTransformer());
+$registry->register('transformer', 'mask', new MaskTransformer());
+
+$transformer = new Transformer($registry);
+
+$formatador = new FormatadorDados();
+$resultado = $transformer->transform($formatador);
+
+if ($resultado->isValid()) {
+    echo "Data: " . $formatador->getData() . "\n";          // Saída: 2024-12-25
+    echo "Preço: " . $formatador->getPreco() . "\n";        // Saída: 1.234,56
+    echo "Telefone: " . $formatador->getTelefone() . "\n";  // Saída: (11) 99988-7766
+}
+```
+
+### Uso Avançado: Formatação de Dados
+
+Aqui está um exemplo de como usar o KaririCode Transformer em um cenário real, demonstrando várias capacidades de transformação:
+
+```php
+use KaririCode\Transformer\Attribute\Transform;
+
+class TransformadorDadosComplexos
+{
+    #[Transform(
+        processors: ['case' => ['case' => 'snake']]
+    )]
+    private string $texto = 'transformarEsseTextoParaSnakeCase';
+
+    #[Transform(
+        processors: ['slug' => []]
+    )]
+    private string $titulo = 'Este é um Título para URL!';
+
+    #[Transform(
+        processors: ['arrayKey' => ['case' => 'camel']]
+    )]
+    private array $dados = [
+        'nome_usuario' => 'João Silva',
+        'endereco_email' => 'joao@exemplo.com',
+        'numero_telefone' => '1234567890'
+    ];
+
+    #[Transform(
+        processors: [
+            'template' => [
+                'template' => 'Olá {{nome}}, seu pedido #{{numero_pedido}} está {{status}}',
+                'removeUnmatchedTags' => true,
+                'preserveData' => true
+            ]
+        ]
+    )]
+    private array $dadosTemplate = [
+        'nome' => 'João',
+        'numero_pedido' => '12345',
+        'status' => 'concluído'
+    ];
+
+    // Getters e setters...
+}
+```
+
+## Exemplos Práticos
+
+### 1. Exemplos de Transformação de Strings
+
+```php
+class ExemploTransformadorString
+{
+    #[Transform(
+        processors: ['case' => ['case' => 'snake']]
+    )]
+    private string $nomeMetodo = 'obterDadosPerfilUsuario';
+
+    #[Transform(
+        processors: ['case' => ['case' => 'camel']]
+    )]
+    private string $nomeVariavel = 'dados_perfil_usuario';
+
+    #[Transform(
+        processors: ['slug' => ['separator' => '-']]
+    )]
+    private string $tituloArtigo = 'Como Usar os Recursos do PHP 8.3!';
+
+    #[Transform(
+        processors: ['mask' => ['type' => 'phone']]
+    )]
+    private string $numeroTelefone = '11999887766';
+}
+
+// Saída:
+// nomeMetodo: obter_dados_perfil_usuario
+// nomeVariavel: dadosPerfilUsuario
+// tituloArtigo: como-usar-os-recursos-do-php-8-3
+// numeroTelefone: (11) 99988-7766
+```
+
+### 2. Formatação de Números e Moeda
+
+```php
+class ExemploTransformadorMoeda
+{
+    #[Transform(
+        processors: ['number' => [
+            'decimals' => 2,
+            'decimalPoint' => ',',
+            'thousandsSeparator' => '.'
+        ]]
+    )]
+    private float $preco = 1234567.89;
+
+    #[Transform(
+        processors: ['number' => [
+            'decimals' => 0,
+            'thousandsSeparator' => '.'
+        ]]
+    )]
+    private int $quantidade = 1000000;
+}
+
+// Saída:
+// preco: 1.234.567,89
+// quantidade: 1.000.000
+```
+
+### 3. Transformação de Data para Diferentes Localizações
+
+```php
+class ExemploTransformadorData
+{
+    #[Transform(
+        processors: ['date' => [
+            'inputFormat' => 'd/m/Y',
+            'outputFormat' => 'Y-m-d'
+        ]]
+    )]
+    private string $dataSQL = '25/12/2024';
+
+    #[Transform(
+        processors: ['date' => [
+            'inputFormat' => 'Y-m-d',
+            'outputFormat' => 'd \d\e F \d\e Y'
+        ]]
+    )]
+    private string $dataExibicao = '2024-12-25';
+
+    #[Transform(
+        processors: ['date' => [
+            'inputFormat' => 'Y-m-d H:i:s',
+            'outputFormat' => 'd/m/Y H:i',
+            'inputTimezone' => 'UTC',
+            'outputTimezone' => 'America/Sao_Paulo'
+        ]]
+    )]
+    private string $timestamp = '2024-12-25 15:30:00';
+}
+
+// Saída:
+// dataSQL: 2024-12-25
+// dataExibicao: 25 de Dezembro de 2024
+// timestamp: 25/12/2024 12:30
+```
+
+### 4. Transformação de Array para Resposta de API
+
+```php
+class ExemploTransformadorRespostaAPI
+{
+    #[Transform(
+        processors: ['arrayKey' => ['case' => 'camel']]
+    )]
+    private array $dadosUsuario = [
+        'id_usuario' => 123,
+        'nome_completo' => 'João Silva',
+        'sobrenome' => 'Santos',
+        'endereco_email' => 'joao@exemplo.com',
+        'telefones' => [
+            'telefone_residencial' => '1234567890',
+            'telefone_comercial' => '0987654321'
+        ]
+    ];
+
+    #[Transform(
+        processors: ['arrayFlat' => ['separator' => '.']]
+    )]
+    private array $configAninhada = [
+        'banco_dados' => [
+            'mysql' => [
+                'host' => 'localhost',
+                'porta' => 3306
+            ]
+        ],
+        'cache' => [
+            'redis' => [
+                'host' => '127.0.0.1',
+                'porta' => 6379
+            ]
+        ]
+    ];
+}
+
+// Saída:
+// dadosUsuario:
+// {
+//     "idUsuario": 123,
+//     "nomeCompleto": "João Silva",
+//     "sobrenome": "Santos",
+//     "enderecoEmail": "joao@exemplo.com",
+//     "telefones": {
+//         "telefoneResidencial": "1234567890",
+//         "telefoneComercial": "0987654321"
+//     }
+// }
+//
+// configAninhada:
+// {
+//     "banco_dados.mysql.host": "localhost",
+//     "banco_dados.mysql.porta": 3306,
+//     "cache.redis.host": "127.0.0.1",
+//     "cache.redis.porta": 6379
+// }
+```
+
+### 5. Transformação de Template para Notificações
+
+```php
+class ExemploTransformadorNotificacao
+{
+    #[Transform(
+        processors: [
+            'template' => [
+                'template' => <<<TEMPLATE
+                Prezado(a) {{nomeUsuario}},
+
+                Seu pedido #{{numeroPedido}} foi {{status}}.
+                {{#if rastreio}}
+                Rastreie sua encomenda: {{rastreio}}
+                {{/if}}
+
+                Total: {{moeda}}{{valor}}
+
+                Atenciosamente,
+                {{nomeEmpresa}}
+                TEMPLATE,
+                'preserveData' => true
+            ]
+        ]
+    )]
+    private array $dadosEmail = [
+        'nomeUsuario' => 'João Silva',
+        'numeroPedido' => 'PED-12345',
+        'status' => 'enviado',
+        'rastreio' => 'RASTR-XYZ-789',
+        'moeda' => 'R$',
+        'valor' => '299,99',
+        'nomeEmpresa' => 'Loja KaririCode'
+    ];
+}
+
+// Saída:
+// Dados Originais:
+// {
+//     "nomeUsuario": "João Silva",
+//     "numeroPedido": "PED-12345",
+//     "status": "enviado",
+//     "rastreio": "RASTR-XYZ-789",
+//     "moeda": "R$",
+//     "valor": "299,99",
+//     "nomeEmpresa": "Loja KaririCode"
+// }
+//
+// Template Renderizado:
+// Prezado(a) João Silva,
+//
+// Seu pedido #PED-12345 foi enviado.
+// Rastreie sua encomenda: RASTR-XYZ-789
+//
+// Total: R$299,99
+//
+// Atenciosamente,
+// Loja KaririCode
+```
+
+### 6. Exemplo de Transformação em Cadeia
+
+```php
+class ExemploTransformadorCadeia
+{
+    #[Transform(
+        processors: [
+            'case' => ['case' => 'lower'],
+            'slug' => ['separator' => '-'],
+            'template' => [
+                'template' => '{{data}}-{{slug}}',
+                'preserveData' => true
+            ]
+        ]
+    )]
+    private array $dadosUrl = [
+        'data' => '2024-01-15',
+        'slug' => 'Como Encadear Múltiplos Transformadores'
+    ];
+}
+
+// Saída:
+// 2024-01-15-como-encadear-multiplos-transformadores
+```
 
-Nós recebemos contribuições para o componente KaririCode transformer! Aqui está como você pode contribuir:
+## Transformadores Disponíveis
 
-1. Faça um fork do repositório
-2. Crie um novo branch para sua feature ou correção de bug
-3. Escreva testes para suas alterações
-4. Implemente suas alterações
-5. Execute a suite de testes e garanta que todos os testes passem
-6. Envie um pull request com uma descrição clara de suas alterações
+### Transformadores de String
+
+- **CaseTransformer**: Transforma o caso de strings (camel, snake, pascal, kebab).
+
+  - **Opções de Configuração**:
+    - `case`: Formato alvo (lower, upper, title, sentence, camel, pascal, snake, kebab)
+    - `preserveNumbers`: Se deve preservar números na transformação
+
+- **MaskTransformer**: Aplica máscaras em strings (telefone, CPF, CNPJ, etc.).
+
+  - **Opções de Configuração**:
+    - `mask`: Padrão personalizado de máscara
+    - `type`: Tipo predefinido de máscara
+    - `placeholder`: Caractere de placeholder da máscara
+
+- **SlugTransformer**: Gera slugs amigáveis para URLs.
+
+  - **Opções de Configuração**:
+    - `separator`: Caractere separador
+    - `lowercase`: Converter para minúsculas
+    - `replacements`: Substituições personalizadas de caracteres
+
+- **TemplateTransformer**: Processa templates com substituição de variáveis.
+  - **Opções de Configuração**:
+    - `template`: String do template
+    - `removeUnmatchedTags`: Remove placeholders não correspondidos
+    - `preserveData`: Mantém os dados originais no resultado
+
+### Transformadores de Dados
+
+- **DateTransformer**: Converte entre formatos de data.
+
+  - **Opções de Configuração**:
+    - `inputFormat`: Formato de entrada da data
+    - `outputFormat`: Formato de saída da data
+    - `inputTimezone`: Fuso horário de entrada
+    - `outputTimezone`: Fuso horário de saída
+
+- **NumberTransformer**: Formata números com configurações locais.
+
+  - **Opções de Configuração**:
+    - `decimals`: Número de casas decimais
+    - `decimalPoint`: Separador decimal
+    - `thousandsSeparator`: Separador de milhares
+    - `roundUp`: Arredonda para cima
+
+- **JsonTransformer**: Manipula codificação/decodificação JSON.
+  - **Opções de Configuração**:
+    - `encodeOptions`: Opções de codificação JSON
+    - `preserveType`: Mantém o tipo de dado original
+    - `assoc`: Usa arrays associativos
+
+### Transformadores de Array
+
+- **ArrayFlattenTransformer**: Achata arrays aninhados.
+
+  - **Opções de Configuração**:
+    - `depth`: Profundidade máxima para achatar
+    - `separator`: Separador de chaves para estrutura achatada
+
+- **ArrayGroupTransformer**: Agrupa elementos do array por chave.
+
+  - **Opções de Configuração**:
+    - `groupBy`: Chave para agrupamento
+    - `preserveKeys`: Mantém as chaves originais
+
+- **ArrayKeyTransformer**: Transforma chaves do array.
+
+  - **Opções de Configuração**:
+    - `case`: Caso alvo para as chaves
+    - `recursive`: Aplica em arrays aninhados
+
+- **ArrayMapTransformer**: Mapeia chaves do array para nova estrutura.
+  - **Opções de Configuração**:
+    - `mapping`: Configuração de mapeamento de chaves
+    - `removeUnmapped`: Remove chaves não mapeadas
+    - `recursive`: Aplica em arrays aninhados
+
+### Transformadores Compostos
+
+- **ChainTransformer**: Executa múltiplos transformadores em sequência.
+
+  - **Opções de Configuração**:
+    - `transformers`: Array de transformadores a executar
+    - `stopOnError`: Para a cadeia no primeiro erro
+
+- **ConditionalTransformer**: Aplica transformações baseadas em condições.
+  - **Opções de Configuração**:
+    - `condition`: Callback de condição
+    - `transformer`: Transformador a aplicar
+    - `defaultValue`: Valor quando a condição falha
+
+## Configuração
+
+Os transformadores podem ser configurados globalmente ou por instância. Exemplo de configuração do NumberTransformer:
+
+```php
+use KaririCode\Transformer\Processor\Data\NumberTransformer;
+
+$transformadorNumero = new NumberTransformer();
+$transformadorNumero->configure([
+    'decimals' => 2,
+    'decimalPoint' => ',',
+    'thousandsSeparator' => '.',
+]);
+
+$registry->register('transformer', 'number', $transformadorNumero);
+```
+
+## Integração com Outros Componentes KaririCode
+
+O componente Transformer se integra com:
+
+- **KaririCode\Contract**: Fornece interfaces para integração de componentes
+- **KaririCode\ProcessorPipeline**: Usado para pipelines de transformação
+- **KaririCode\PropertyInspector**: Processa atributos de transformação
+
+## Exemplo de Registro
+
+Exemplo completo de configuração do registro:
+
+```php
+$registry = new ProcessorRegistry();
+
+// Registrar Transformadores de String
+$registry->register('transformer', 'case', new CaseTransformer())
+         ->register('transformer', 'mask', new MaskTransformer())
+         ->register('transformer', 'slug', new SlugTransformer())
+         ->register('transformer', 'template', new TemplateTransformer());
+
+// Registrar Transformadores de Dados
+$registry->register('transformer', 'date', new DateTransformer())
+         ->register('transformer', 'number', new NumberTransformer())
+         ->register('transformer', 'json', new JsonTransformer());
+
+// Registrar Transformadores de Array
+$registry->register('transformer', 'arrayFlat', new ArrayFlattenTransformer())
+         ->register('transformer', 'arrayGroup', new ArrayGroupTransformer())
+         ->register('transformer', 'arrayKey', new ArrayKeyTransformer())
+         ->register('transformer', 'arrayMap', new ArrayMapTransformer());
+```
+
+## Desenvolvimento e Testes
+
+Configuração de desenvolvimento similar ao componente Validator, usando Docker e comandos Make.
+
+### Comandos Make Disponíveis
+
+- `make up`: Inicia os serviços
+- `make down`: Para os serviços
+- `make test`: Executa os testes
+- `make coverage`: Gera relatório de cobertura
+- `make cs-fix`: Corrige estilo do código
+- `make quality`: Executa verificações de qualidade
+
+## Contribuindo
 
-Por favor, leia nosso [Guia de Contribuição](CONTRIBUTING.md) para mais detalhes sobre nosso código de conduta e processo de desenvolvimento.
+Contribuições são bem-vindas! Por favor, veja nosso [Guia de Contribuição](CONTRIBUTING.md).
 
 ## Licença
 
-Este projeto está licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.
+Licença MIT - veja o arquivo [LICENSE](LICENSE).
 
 ## Suporte e Comunidade
 
 - **Documentação**: [https://kariricode.org/docs/transformer](https://kariricode.org/docs/transformer)
-- **Issue Tracker**: [GitHub Issues](https://github.com/KaririCode-Framework/kariricode-transformer/issues)
-- **Fórum da Comunidade**: [Comunidade KaririCode Club](https://kariricode.club)
-- **Stack Overflow**: Marque suas perguntas com `kariricode-transformer`
+- **Issues**: [GitHub Issues](https://github.com/KaririCode-Framework/kariricode-transformer/issues)
+- **Fórum**: [Comunidade KaririCode Club](https://kariricode.club)
+- **Stack Overflow**: Marque com `kariricode-transformer`
 
 ---
 
-Construído com ❤️ pela equipe KaririCode. Capacitando desenvolvedores para criar aplicações PHP mais seguras e robustas.
+Construído com ❤️ pelo time KaririCode. Capacitando desenvolvedores a criar aplicações PHP mais seguras e robustas.
diff --git a/src/Attribute/Transform.php b/src/Attribute/Transform.php
new file mode 100644
index 0000000..426ebd0
--- /dev/null
+++ b/src/Attribute/Transform.php
@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Attribute;
+
+use KaririCode\Contract\Processor\Attribute\BaseProcessorAttribute;
+
+#[\Attribute(\Attribute::TARGET_PROPERTY)]
+final class Transform extends BaseProcessorAttribute
+{
+}
diff --git a/src/Contract/TransformationResult.php b/src/Contract/TransformationResult.php
new file mode 100644
index 0000000..5a228d7
--- /dev/null
+++ b/src/Contract/TransformationResult.php
@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Contract;
+
+interface TransformationResult
+{
+    public function isValid(): bool;
+
+    public function getErrors(): array;
+
+    public function getTransformedData(): array;
+
+    public function toArray(): array;
+}
diff --git a/src/Exception/TransformerException.php b/src/Exception/TransformerException.php
new file mode 100644
index 0000000..fa0bd42
--- /dev/null
+++ b/src/Exception/TransformerException.php
@@ -0,0 +1,58 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Exception;
+
+use KaririCode\Exception\AbstractException;
+
+final class TransformerException extends AbstractException
+{
+    private const CODE_INVALID_INPUT = 5001;
+    private const CODE_INVALID_FORMAT = 5002;
+    private const CODE_INVALID_TYPE = 5003;
+
+    public static function invalidInput(string $expectedType, string $actualType): self
+    {
+        $message = sprintf(
+            'Invalid input type. Expected %s, got %s.',
+            $expectedType,
+            $actualType
+        );
+
+        return self::createException(
+            self::CODE_INVALID_INPUT,
+            'INVALID_INPUT_TYPE',
+            $message
+        );
+    }
+
+    public static function invalidFormat(string $format, string $value): self
+    {
+        $message = sprintf(
+            'Invalid format. Expected format %s, got %s.',
+            $format,
+            $value
+        );
+
+        return self::createException(
+            self::CODE_INVALID_FORMAT,
+            'INVALID_FORMAT',
+            $message
+        );
+    }
+
+    public static function invalidType(string $expectedType): self
+    {
+        $message = sprintf(
+            'Invalid type. Expected %s.',
+            $expectedType
+        );
+
+        return self::createException(
+            self::CODE_INVALID_TYPE,
+            'INVALID_TYPE',
+            $message
+        );
+    }
+}
diff --git a/src/Processor/AbstractTransformerProcessor.php b/src/Processor/AbstractTransformerProcessor.php
new file mode 100644
index 0000000..bb104c7
--- /dev/null
+++ b/src/Processor/AbstractTransformerProcessor.php
@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Processor;
+
+use KaririCode\Contract\Processor\Processor;
+use KaririCode\Contract\Processor\ValidatableProcessor;
+use KaririCode\Transformer\Exception\TransformerException;
+
+abstract class AbstractTransformerProcessor implements Processor, ValidatableProcessor
+{
+    protected bool $isValid = true;
+    protected string $errorKey = '';
+
+    public function reset(): void
+    {
+        $this->isValid = true;
+        $this->errorKey = '';
+    }
+
+    protected function setInvalid(string $errorKey): void
+    {
+        $this->isValid = false;
+        $this->errorKey = $errorKey;
+    }
+
+    public function isValid(): bool
+    {
+        return $this->isValid;
+    }
+
+    public function getErrorKey(): string
+    {
+        return $this->errorKey;
+    }
+
+    protected function guardAgainstInvalidType(mixed $input, string $type): void
+    {
+        $actualType = get_debug_type($input);
+        if ($actualType !== $type) {
+            throw TransformerException::invalidType($type);
+        }
+    }
+
+    abstract public function process(mixed $input): mixed;
+}
diff --git a/src/Processor/Array/ArrayFlattenTransformer.php b/src/Processor/Array/ArrayFlattenTransformer.php
new file mode 100644
index 0000000..2788555
--- /dev/null
+++ b/src/Processor/Array/ArrayFlattenTransformer.php
@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Processor\Array;
+
+use KaririCode\Contract\Processor\ConfigurableProcessor;
+use KaririCode\Transformer\Processor\AbstractTransformerProcessor;
+use KaririCode\Transformer\Trait\ArrayTransformerTrait;
+
+class ArrayFlattenTransformer extends AbstractTransformerProcessor implements ConfigurableProcessor
+{
+    use ArrayTransformerTrait;
+
+    private int $depth = -1;
+    private string $separator = '.';
+
+    public function configure(array $options): void
+    {
+        $this->depth = $options['depth'] ?? $this->depth;
+        $this->separator = $options['separator'] ?? $this->separator;
+    }
+
+    public function process(mixed $input): array
+    {
+        if (!is_array($input)) {
+            $this->setInvalid('notArray');
+
+            return [];
+        }
+
+        return $this->flattenArray($input, '', $this->depth);
+    }
+
+    private function flattenArray(array $array, string $prefix = '', int $depth = -1): array
+    {
+        $result = [];
+
+        foreach ($array as $key => $value) {
+            $newKey = $prefix ? $prefix . $this->separator . $key : $key;
+
+            if (is_array($value) && ($depth > 0 || -1 === $depth)) {
+                $result = array_merge(
+                    $result,
+                    $this->flattenArray($value, $newKey, $depth > 0 ? $depth - 1 : -1)
+                );
+            } else {
+                $result[$newKey] = $value;
+            }
+        }
+
+        return $result;
+    }
+}
diff --git a/src/Processor/Array/ArrayGroupTransformer.php b/src/Processor/Array/ArrayGroupTransformer.php
new file mode 100644
index 0000000..58f404b
--- /dev/null
+++ b/src/Processor/Array/ArrayGroupTransformer.php
@@ -0,0 +1,62 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Processor\Array;
+
+use KaririCode\Contract\Processor\ConfigurableProcessor;
+use KaririCode\Transformer\Processor\AbstractTransformerProcessor;
+use KaririCode\Transformer\Trait\ArrayTransformerTrait;
+
+class ArrayGroupTransformer extends AbstractTransformerProcessor implements ConfigurableProcessor
+{
+    use ArrayTransformerTrait;
+
+    private string $groupBy = '';
+    private bool $preserveKeys = false;
+
+    public function configure(array $options): void
+    {
+        if (!isset($options['groupBy'])) {
+            throw new \InvalidArgumentException('The groupBy option is required');
+        }
+
+        $this->groupBy = $options['groupBy'];
+        $this->preserveKeys = $options['preserveKeys'] ?? $this->preserveKeys;
+    }
+
+    public function process(mixed $input): array
+    {
+        if (!is_array($input)) {
+            $this->setInvalid('notArray');
+
+            return [];
+        }
+
+        return $this->groupArray($input);
+    }
+
+    private function groupArray(array $array): array
+    {
+        $result = [];
+
+        foreach ($array as $key => $item) {
+            if (!is_array($item)) {
+                continue;
+            }
+
+            $groupValue = $item[$this->groupBy] ?? null;
+            if (null === $groupValue) {
+                continue;
+            }
+
+            if ($this->preserveKeys) {
+                $result[$groupValue][$key] = $item;
+            } else {
+                $result[$groupValue][] = $item;
+            }
+        }
+
+        return $result;
+    }
+}
diff --git a/src/Processor/Array/ArrayKeyTransformer.php b/src/Processor/Array/ArrayKeyTransformer.php
new file mode 100644
index 0000000..7c1b7cf
--- /dev/null
+++ b/src/Processor/Array/ArrayKeyTransformer.php
@@ -0,0 +1,80 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Processor\Array;
+
+use KaririCode\Contract\Processor\ConfigurableProcessor;
+use KaririCode\Transformer\Processor\AbstractTransformerProcessor;
+use KaririCode\Transformer\Trait\ArrayTransformerTrait;
+
+class ArrayKeyTransformer extends AbstractTransformerProcessor implements ConfigurableProcessor
+{
+    use ArrayTransformerTrait;
+
+    private const CASE_SNAKE = 'snake';
+    private const CASE_CAMEL = 'camel';
+    private const CASE_PASCAL = 'pascal';
+    private const CASE_KEBAB = 'kebab';
+
+    private string $case = self::CASE_SNAKE;
+    private bool $recursive = true;
+
+    public function configure(array $options): void
+    {
+        if (isset($options['case']) && in_array($options['case'], $this->getAllowedCases(), true)) {
+            $this->case = $options['case'];
+        }
+
+        $this->recursive = $options['recursive'] ?? $this->recursive;
+    }
+
+    public function process(mixed $input): array
+    {
+        if (!is_array($input)) {
+            $this->setInvalid('notArray');
+
+            return [];
+        }
+
+        return $this->transformArrayKeys($input);
+    }
+
+    private function transformArrayKeys(array $array): array
+    {
+        $result = [];
+
+        foreach ($array as $key => $value) {
+            $transformedKey = $this->transformKey((string) $key);
+
+            if (is_array($value) && $this->recursive) {
+                $result[$transformedKey] = $this->transformArrayKeys($value);
+            } else {
+                $result[$transformedKey] = $value;
+            }
+        }
+
+        return $result;
+    }
+
+    private function transformKey(string $key): string
+    {
+        return match ($this->case) {
+            self::CASE_SNAKE => $this->toSnakeCase($key),
+            self::CASE_CAMEL => $this->toCamelCase($key),
+            self::CASE_PASCAL => $this->toPascalCase($key),
+            self::CASE_KEBAB => $this->toKebabCase($key),
+            default => $key,
+        };
+    }
+
+    private function getAllowedCases(): array
+    {
+        return [
+            self::CASE_SNAKE,
+            self::CASE_CAMEL,
+            self::CASE_PASCAL,
+            self::CASE_KEBAB,
+        ];
+    }
+}
diff --git a/src/Processor/Array/ArrayMapTransformer.php b/src/Processor/Array/ArrayMapTransformer.php
new file mode 100644
index 0000000..fa4625d
--- /dev/null
+++ b/src/Processor/Array/ArrayMapTransformer.php
@@ -0,0 +1,62 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Processor\Array;
+
+use KaririCode\Contract\Processor\ConfigurableProcessor;
+use KaririCode\Transformer\Processor\AbstractTransformerProcessor;
+use KaririCode\Transformer\Trait\ArrayTransformerTrait;
+
+class ArrayMapTransformer extends AbstractTransformerProcessor implements ConfigurableProcessor
+{
+    use ArrayTransformerTrait;
+
+    private array $mapping = [];
+    private bool $removeUnmapped = false;
+    private bool $recursive = true;
+
+    public function configure(array $options): void
+    {
+        if (!isset($options['mapping']) || !is_array($options['mapping'])) {
+            throw new \InvalidArgumentException('The mapping option is required and must be an array');
+        }
+
+        $this->mapping = $options['mapping'];
+        $this->removeUnmapped = $options['removeUnmapped'] ?? $this->removeUnmapped;
+        $this->recursive = $options['recursive'] ?? $this->recursive;
+    }
+
+    public function process(mixed $input): array
+    {
+        if (!is_array($input)) {
+            $this->setInvalid('notArray');
+
+            return [];
+        }
+
+        return $this->mapArray($input);
+    }
+
+    private function mapArray(array $array): array
+    {
+        $result = [];
+
+        foreach ($array as $key => $value) {
+            if (is_array($value) && $this->recursive) {
+                $result[$key] = $this->mapArray($value);
+                continue;
+            }
+
+            $mappedKey = $this->mapping[$key] ?? $key;
+
+            if ($this->removeUnmapped && !isset($this->mapping[$key])) {
+                continue;
+            }
+
+            $result[$mappedKey] = $value;
+        }
+
+        return $result;
+    }
+}
diff --git a/src/Processor/Composite/ChainTransformer.php b/src/Processor/Composite/ChainTransformer.php
new file mode 100644
index 0000000..baa66ad
--- /dev/null
+++ b/src/Processor/Composite/ChainTransformer.php
@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Processor\Composite;
+
+use KaririCode\Contract\Processor\ConfigurableProcessor;
+use KaririCode\Transformer\Processor\AbstractTransformerProcessor;
+
+class ChainTransformer extends AbstractTransformerProcessor implements ConfigurableProcessor
+{
+    /** @var array<AbstractTransformerProcessor> */
+    private array $transformers = [];
+
+    private bool $stopOnError = true;
+
+    public function configure(array $options): void
+    {
+        if (isset($options['transformers']) && is_array($options['transformers'])) {
+            foreach ($options['transformers'] as $transformer) {
+                if ($transformer instanceof AbstractTransformerProcessor) {
+                    $this->transformers[] = $transformer;
+                }
+            }
+        }
+
+        $this->stopOnError = $options['stopOnError'] ?? $this->stopOnError;
+    }
+
+    public function process(mixed $input): mixed
+    {
+        $result = $input;
+
+        foreach ($this->transformers as $transformer) {
+            try {
+                $result = $transformer->process($result);
+
+                if (!$transformer->isValid() && $this->stopOnError) {
+                    $this->setInvalid($transformer->getErrorKey());
+                    break;
+                }
+            } catch (\Exception $e) {
+                if ($this->stopOnError) {
+                    $this->setInvalid('transformationError');
+                    break;
+                }
+            }
+        }
+
+        return $result;
+    }
+}
diff --git a/src/Processor/Composite/ConditionalTransformer.php b/src/Processor/Composite/ConditionalTransformer.php
new file mode 100644
index 0000000..289bac5
--- /dev/null
+++ b/src/Processor/Composite/ConditionalTransformer.php
@@ -0,0 +1,67 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Processor\Composite;
+
+use KaririCode\Contract\Processor\ConfigurableProcessor;
+use KaririCode\Transformer\Processor\AbstractTransformerProcessor;
+
+class ConditionalTransformer extends AbstractTransformerProcessor implements ConfigurableProcessor
+{
+    private ?AbstractTransformerProcessor $transformer = null;
+
+    /** @var callable|null */
+    private mixed $condition = null;
+
+    private mixed $defaultValue = null;
+    private bool $useDefaultOnError = true;
+
+    public function configure(array $options): void
+    {
+        if (!isset($options['transformer']) || !$options['transformer'] instanceof AbstractTransformerProcessor) {
+            throw new \InvalidArgumentException('A valid transformer must be provided');
+        }
+
+        if (!isset($options['condition']) || !is_callable($options['condition'])) {
+            throw new \InvalidArgumentException('A valid condition callback must be provided');
+        }
+
+        $this->transformer = $options['transformer'];
+        $this->condition = $options['condition'];
+        $this->defaultValue = $options['defaultValue'] ?? $this->defaultValue;
+        $this->useDefaultOnError = $options['useDefaultOnError'] ?? $this->useDefaultOnError;
+    }
+
+    public function process(mixed $input): mixed
+    {
+        if (!$this->shouldTransform($input)) {
+            return $this->defaultValue ?? $input;
+        }
+
+        try {
+            $result = $this->transformer->process($input);
+
+            if (!$this->transformer->isValid() && $this->useDefaultOnError) {
+                $this->setInvalid($this->transformer->getErrorKey());
+
+                return $this->defaultValue ?? $input;
+            }
+
+            return $result;
+        } catch (\Exception $e) {
+            $this->setInvalid('transformationError');
+
+            return $this->defaultValue ?? $input;
+        }
+    }
+
+    private function shouldTransform(mixed $input): bool
+    {
+        try {
+            return call_user_func($this->condition, $input);
+        } catch (\Exception $e) {
+            return false;
+        }
+    }
+}
diff --git a/src/Processor/Data/DateTransformer.php b/src/Processor/Data/DateTransformer.php
new file mode 100644
index 0000000..d5145b2
--- /dev/null
+++ b/src/Processor/Data/DateTransformer.php
@@ -0,0 +1,67 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Processor\Data;
+
+use KaririCode\Contract\Processor\ConfigurableProcessor;
+use KaririCode\Transformer\Processor\AbstractTransformerProcessor;
+
+class DateTransformer extends AbstractTransformerProcessor implements ConfigurableProcessor
+{
+    private string $inputFormat = 'Y-m-d';
+    private string $outputFormat = 'Y-m-d';
+    private ?string $inputTimezone = null;
+    private ?string $outputTimezone = null;
+
+    public function configure(array $options): void
+    {
+        $this->inputFormat = $options['inputFormat'] ?? $this->inputFormat;
+        $this->outputFormat = $options['outputFormat'] ?? $this->outputFormat;
+        $this->inputTimezone = $options['inputTimezone'] ?? $this->inputTimezone;
+        $this->outputTimezone = $options['outputTimezone'] ?? $this->outputTimezone;
+    }
+
+    public function process(mixed $input): string
+    {
+        if (!is_string($input)) {
+            $this->setInvalid('notString');
+
+            return '';
+        }
+
+        try {
+            $date = $this->createDateTime($input);
+
+            return $this->formatDate($date);
+        } catch (\Exception $e) {
+            $this->setInvalid('invalidDate');
+
+            return '';
+        }
+    }
+
+    private function createDateTime(string $input): \DateTime
+    {
+        $date = \DateTime::createFromFormat($this->inputFormat, $input);
+
+        if (false === $date) {
+            throw new \RuntimeException('Invalid date format');
+        }
+
+        if ($this->inputTimezone) {
+            $date->setTimezone(new \DateTimeZone($this->inputTimezone));
+        }
+
+        return $date;
+    }
+
+    private function formatDate(\DateTime $date): string
+    {
+        if ($this->outputTimezone) {
+            $date->setTimezone(new \DateTimeZone($this->outputTimezone));
+        }
+
+        return $date->format($this->outputFormat);
+    }
+}
diff --git a/src/Processor/Data/JsonTransformer.php b/src/Processor/Data/JsonTransformer.php
new file mode 100644
index 0000000..11ffb15
--- /dev/null
+++ b/src/Processor/Data/JsonTransformer.php
@@ -0,0 +1,61 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Processor\Data;
+
+use KaririCode\Contract\Processor\ConfigurableProcessor;
+use KaririCode\Transformer\Processor\AbstractTransformerProcessor;
+
+class JsonTransformer extends AbstractTransformerProcessor implements ConfigurableProcessor
+{
+    private bool $assoc = true;
+    private int $depth = 512;
+    private int $encodeOptions = 0;
+    private bool $returnString = false;
+
+    public function configure(array $options): void
+    {
+        $this->assoc = $options['assoc'] ?? $this->assoc;
+        $this->depth = $options['depth'] ?? $this->depth;
+        $this->encodeOptions = $options['encodeOptions'] ?? $this->encodeOptions;
+        $this->returnString = $options['returnString'] ?? $this->returnString;
+    }
+
+    public function process(mixed $input): mixed
+    {
+        if (is_string($input)) {
+            return $this->decode($input);
+        }
+
+        if (is_array($input) && $this->returnString) {
+            return $this->encode($input);
+        }
+
+        return $input;
+    }
+
+    private function decode(string $input): mixed
+    {
+        try {
+            $decoded = json_decode($input, $this->assoc, $this->depth, JSON_THROW_ON_ERROR);
+        } catch (\JsonException $e) {
+            $this->setInvalid('invalidJson');
+
+            return $this->assoc ? [] : new \stdClass();
+        }
+
+        return $decoded;
+    }
+
+    private function encode(mixed $input): string
+    {
+        try {
+            return json_encode($input, $this->encodeOptions | JSON_THROW_ON_ERROR);
+        } catch (\JsonException $e) {
+            $this->setInvalid('unserializable');
+
+            return '';
+        }
+    }
+}
diff --git a/src/Processor/Data/NumberTransformer.php b/src/Processor/Data/NumberTransformer.php
new file mode 100644
index 0000000..6b4344c
--- /dev/null
+++ b/src/Processor/Data/NumberTransformer.php
@@ -0,0 +1,58 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Processor\Data;
+
+use KaririCode\Contract\Processor\ConfigurableProcessor;
+use KaririCode\Transformer\Processor\AbstractTransformerProcessor;
+
+class NumberTransformer extends AbstractTransformerProcessor implements ConfigurableProcessor
+{
+    private int $decimals = 2;
+    private string $decimalPoint = '.';
+    private string $thousandsSeparator = '';
+    private ?float $multiplier = null;
+    private bool $roundUp = false;
+    private bool $formatAsString = false;
+
+    public function configure(array $options): void
+    {
+        $this->decimals = $options['decimals'] ?? $this->decimals;
+        $this->decimalPoint = $options['decimalPoint'] ?? $this->decimalPoint;
+        $this->thousandsSeparator = $options['thousandsSeparator'] ?? $this->thousandsSeparator;
+        $this->multiplier = $options['multiplier'] ?? $this->multiplier;
+        $this->roundUp = $options['roundUp'] ?? $this->roundUp;
+        $this->formatAsString = $options['formatAsString'] ?? $this->formatAsString;
+    }
+
+    public function process(mixed $input): float|string
+    {
+        if (!is_numeric($input)) {
+            $this->setInvalid('notNumeric');
+
+            return $this->formatAsString ? '' : 0.0;
+        }
+
+        $number = (float) $input;
+
+        if (null !== $this->multiplier) {
+            $number *= $this->multiplier;
+        }
+
+        if ($this->roundUp) {
+            $number = ceil($number * (10 ** $this->decimals)) / (10 ** $this->decimals);
+        }
+
+        if ($this->formatAsString) {
+            return number_format(
+                $number,
+                $this->decimals,
+                $this->decimalPoint,
+                $this->thousandsSeparator
+            );
+        }
+
+        return round($number, $this->decimals);
+    }
+}
diff --git a/src/Processor/String/CaseTransformer.php b/src/Processor/String/CaseTransformer.php
new file mode 100644
index 0000000..6a0ece6
--- /dev/null
+++ b/src/Processor/String/CaseTransformer.php
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Processor\String;
+
+use KaririCode\Contract\Processor\ConfigurableProcessor;
+use KaririCode\Transformer\Processor\AbstractTransformerProcessor;
+use KaririCode\Transformer\Trait\StringTransformerTrait;
+
+class CaseTransformer extends AbstractTransformerProcessor implements ConfigurableProcessor
+{
+    use StringTransformerTrait;
+
+    private const CASE_LOWER = 'lower';
+    private const CASE_UPPER = 'upper';
+    private const CASE_TITLE = 'title';
+    private const CASE_SENTENCE = 'sentence';
+    private const CASE_CAMEL = 'camel';
+    private const CASE_PASCAL = 'pascal';
+    private const CASE_SNAKE = 'snake';
+    private const CASE_KEBAB = 'kebab';
+
+    private string $case = self::CASE_LOWER;
+    private bool $preserveNumbers = true;
+
+    public function configure(array $options): void
+    {
+        if (isset($options['case']) && in_array($options['case'], $this->getAllowedCases(), true)) {
+            $this->case = $options['case'];
+        }
+        $this->preserveNumbers = $options['preserveNumbers'] ?? $this->preserveNumbers;
+    }
+
+    public function process(mixed $input): string
+    {
+        if (!is_string($input)) {
+            $this->setInvalid('notString');
+
+            return '';
+        }
+
+        return match ($this->case) {
+            self::CASE_LOWER => $this->toLowerCase($input),
+            self::CASE_UPPER => $this->toUpperCase($input),
+            self::CASE_TITLE => $this->toTitleCase($input),
+            self::CASE_SENTENCE => $this->toSentenceCase($input),
+            self::CASE_CAMEL => $this->toCamelCase($input),
+            self::CASE_PASCAL => $this->toPascalCase($input),
+            self::CASE_SNAKE => $this->toSnakeCase($input),
+            self::CASE_KEBAB => $this->toKebabCase($input),
+            default => $input,
+        };
+    }
+
+    private function getAllowedCases(): array
+    {
+        return [
+            self::CASE_LOWER,
+            self::CASE_UPPER,
+            self::CASE_TITLE,
+            self::CASE_SENTENCE,
+            self::CASE_CAMEL,
+            self::CASE_PASCAL,
+            self::CASE_SNAKE,
+            self::CASE_KEBAB,
+        ];
+    }
+}
diff --git a/src/Processor/String/MaskTransformer.php b/src/Processor/String/MaskTransformer.php
new file mode 100644
index 0000000..2a6d174
--- /dev/null
+++ b/src/Processor/String/MaskTransformer.php
@@ -0,0 +1,72 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Processor\String;
+
+use KaririCode\Contract\Processor\ConfigurableProcessor;
+use KaririCode\Transformer\Processor\AbstractTransformerProcessor;
+use KaririCode\Transformer\Trait\StringTransformerTrait;
+
+class MaskTransformer extends AbstractTransformerProcessor implements ConfigurableProcessor
+{
+    use StringTransformerTrait;
+
+    private string $mask = '';
+    private string $placeholder = '#';
+    private array $customMasks = [
+        'phone' => '(##) #####-####',
+        'cpf' => '###.###.###-##',
+        'cnpj' => '##.###.###/####-##',
+        'cep' => '#####-###',
+    ];
+
+    public function configure(array $options): void
+    {
+        if (isset($options['mask'])) {
+            $this->mask = $options['mask'];
+        } elseif (isset($options['type']) && isset($this->customMasks[$options['type']])) {
+            $this->mask = $this->customMasks[$options['type']];
+        }
+
+        $this->placeholder = $options['placeholder'] ?? $this->placeholder;
+
+        if (isset($options['customMasks']) && is_array($options['customMasks'])) {
+            $this->customMasks = array_merge($this->customMasks, $options['customMasks']);
+        }
+    }
+
+    public function process(mixed $input): string
+    {
+        if (!is_string($input)) {
+            $this->setInvalid('notString');
+
+            return '';
+        }
+
+        if (empty($this->mask)) {
+            $this->setInvalid('noMask');
+
+            return $input;
+        }
+
+        return $this->applyMask($input);
+    }
+
+    private function applyMask(string $input): string
+    {
+        $result = '';
+        $inputPos = 0;
+
+        for ($maskPos = 0; $maskPos < strlen($this->mask) && $inputPos < strlen($input); ++$maskPos) {
+            if ($this->mask[$maskPos] === $this->placeholder) {
+                $result .= $input[$inputPos];
+                ++$inputPos;
+            } else {
+                $result .= $this->mask[$maskPos];
+            }
+        }
+
+        return $result;
+    }
+}
diff --git a/src/Processor/String/SlugTransformer.php b/src/Processor/String/SlugTransformer.php
new file mode 100644
index 0000000..e6e8708
--- /dev/null
+++ b/src/Processor/String/SlugTransformer.php
@@ -0,0 +1,108 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Processor\String;
+
+use KaririCode\Contract\Processor\ConfigurableProcessor;
+use KaririCode\Transformer\Processor\AbstractTransformerProcessor;
+use KaririCode\Transformer\Trait\StringTransformerTrait;
+
+class SlugTransformer extends AbstractTransformerProcessor implements ConfigurableProcessor
+{
+    use StringTransformerTrait;
+
+    private string $separator = '-';
+    private bool $lowercase = true;
+    private array $replacements = [];
+
+    public function configure(array $options): void
+    {
+        $this->separator = $options['separator'] ?? $this->separator;
+        $this->lowercase = $options['lowercase'] ?? $this->lowercase;
+        $this->replacements = array_merge($this->getDefaultReplacements(), $options['replacements'] ?? []);
+    }
+
+    public function process(mixed $input): string
+    {
+        if (!is_string($input)) {
+            $this->setInvalid('notString');
+
+            return '';
+        }
+
+        $slug = $this->createSlug($input);
+
+        if (empty($slug)) {
+            $this->setInvalid('emptySlug');
+
+            return '';
+        }
+
+        return $slug;
+    }
+
+    private function createSlug(string $input): string
+    {
+        // Apply custom replacements first
+        $text = str_replace(
+            array_keys($this->replacements),
+            array_values($this->replacements),
+            $input
+        );
+
+        // Convert accented characters to ASCII
+        $text = $this->convertAccentsToAscii($text);
+
+        // Convert to lowercase if needed
+        if ($this->lowercase) {
+            $text = mb_strtolower($text);
+        }
+
+        // Replace non-alphanumeric characters with separator
+        $text = preg_replace('/[^a-zA-Z0-9\-_]/', $this->separator, $text);
+
+        // Replace multiple separators with a single one
+        $text = preg_replace('/' . preg_quote($this->separator, '/') . '+/', $this->separator, $text);
+
+        return trim($text, $this->separator);
+    }
+
+    private function getDefaultReplacements(): array
+    {
+        return [
+            ' ' => $this->separator,
+            '&' => 'and',
+            '@' => 'at',
+        ];
+    }
+
+    private function convertAccentsToAscii(string $string): string
+    {
+        $chars = [
+            // Latin
+            'À' => 'A', 'Á' => 'A', 'Â' => 'A', 'Ã' => 'A', 'Ä' => 'A', 'Å' => 'A', 'Æ' => 'AE',
+            'Ç' => 'C', 'È' => 'E', 'É' => 'E', 'Ê' => 'E', 'Ë' => 'E', 'Ì' => 'I', 'Í' => 'I',
+            'Î' => 'I', 'Ï' => 'I', 'Ð' => 'D', 'Ñ' => 'N', 'Ò' => 'O', 'Ó' => 'O', 'Ô' => 'O',
+            'Õ' => 'O', 'Ö' => 'O', 'Ő' => 'O', 'Ø' => 'O', 'Ù' => 'U', 'Ú' => 'U', 'Û' => 'U',
+            'Ü' => 'U', 'Ű' => 'U', 'Ý' => 'Y', 'Þ' => 'TH', 'ß' => 'ss', 'à' => 'a', 'á' => 'a',
+            'â' => 'a', 'ã' => 'a', 'ä' => 'a', 'å' => 'a', 'æ' => 'ae', 'ç' => 'c', 'è' => 'e',
+            'é' => 'e', 'ê' => 'e', 'ë' => 'e', 'ì' => 'i', 'í' => 'i', 'î' => 'i', 'ï' => 'i',
+            'ð' => 'd', 'ñ' => 'n', 'ò' => 'o', 'ó' => 'o', 'ô' => 'o', 'õ' => 'o', 'ö' => 'o',
+            'ő' => 'o', 'ø' => 'o', 'ù' => 'u', 'ú' => 'u', 'û' => 'u', 'ü' => 'u', 'ű' => 'u',
+            'ý' => 'y', 'þ' => 'th', 'ÿ' => 'y',
+            // Latin symbols
+            '©' => '(c)',
+            // Greek
+            'Α' => 'A', 'Β' => 'B', 'Γ' => 'G', 'Δ' => 'D', 'Ε' => 'E', 'Ζ' => 'Z', 'Η' => 'H',
+            'Θ' => '8', 'Ι' => 'I', 'Κ' => 'K', 'Λ' => 'L', 'Μ' => 'M', 'Ν' => 'N', 'Ξ' => '3',
+            'Ο' => 'O', 'Π' => 'P', 'Ρ' => 'R', 'Σ' => 'S', 'Τ' => 'T', 'Υ' => 'Y', 'Φ' => 'F',
+            'Χ' => 'X', 'Ψ' => 'PS', 'Ω' => 'W', 'α' => 'a', 'β' => 'b', 'γ' => 'g', 'δ' => 'd',
+            'ε' => 'e', 'ζ' => 'z', 'η' => 'h', 'θ' => '8', 'ι' => 'i', 'κ' => 'k', 'λ' => 'l',
+            'μ' => 'm', 'ν' => 'n', 'ξ' => '3', 'ο' => 'o', 'π' => 'p', 'ρ' => 'r', 'σ' => 's',
+            'τ' => 't', 'υ' => 'y', 'φ' => 'f', 'χ' => 'x', 'ψ' => 'ps', 'ω' => 'w',
+        ];
+
+        return strtr($string, $chars);
+    }
+}
diff --git a/src/Processor/String/TemplateTransformer.php b/src/Processor/String/TemplateTransformer.php
new file mode 100644
index 0000000..5f9bb2d
--- /dev/null
+++ b/src/Processor/String/TemplateTransformer.php
@@ -0,0 +1,76 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Processor\String;
+
+use KaririCode\Contract\Processor\ConfigurableProcessor;
+use KaririCode\Transformer\Processor\AbstractTransformerProcessor;
+use KaririCode\Transformer\Trait\StringTransformerTrait;
+
+class TemplateTransformer extends AbstractTransformerProcessor implements ConfigurableProcessor
+{
+    use StringTransformerTrait;
+
+    private string $template = '';
+    private string $openTag = '{{';
+    private string $closeTag = '}}';
+
+    /** @var callable|null */
+    private mixed $missingValueHandler = null;
+
+    private bool $removeUnmatchedTags = false;
+    private bool $preserveData = true;
+
+    public function configure(array $options): void
+    {
+        $this->template = $options['template'] ?? $this->template;
+        $this->openTag = $options['openTag'] ?? $this->openTag;
+        $this->closeTag = $options['closeTag'] ?? $this->closeTag;
+        $this->missingValueHandler = $options['missingValueHandler'] ?? $this->missingValueHandler;
+        $this->removeUnmatchedTags = $options['removeUnmatchedTags'] ?? $this->removeUnmatchedTags;
+        $this->preserveData = $options['preserveData'] ?? $this->preserveData;
+    }
+
+    public function process(mixed $input): mixed
+    {
+        if (!is_array($input)) {
+            $this->setInvalid('notArray');
+
+            return $input;
+        }
+
+        if (empty($this->template)) {
+            $this->setInvalid('noTemplate');
+
+            return $input;
+        }
+
+        if ($this->preserveData) {
+            $input['_rendered'] = $this->replacePlaceholders($input);
+
+            return $input;
+        }
+
+        return $this->replacePlaceholders($input);
+    }
+
+    private function replacePlaceholders(array $data): string
+    {
+        $pattern = '/' . preg_quote($this->openTag, '/') . '\s*(.+?)\s*' . preg_quote($this->closeTag, '/') . '/';
+
+        return preg_replace_callback($pattern, function ($matches) use ($data) {
+            $key = trim($matches[1]);
+
+            if (isset($data[$key])) {
+                return $data[$key];
+            }
+
+            if (null !== $this->missingValueHandler) {
+                return call_user_func($this->missingValueHandler, $key);
+            }
+
+            return $this->removeUnmatchedTags ? '' : $matches[0];
+        }, $this->template);
+    }
+}
diff --git a/src/Result/TransformationResult.php b/src/Result/TransformationResult.php
new file mode 100644
index 0000000..0bfcf69
--- /dev/null
+++ b/src/Result/TransformationResult.php
@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Result;
+
+use KaririCode\ProcessorPipeline\Result\ProcessingResultCollection;
+use KaririCode\Transformer\Contract\TransformationResult as TransformationResultContract;
+
+final class TransformationResult implements TransformationResultContract
+{
+    public function __construct(
+        private readonly ProcessingResultCollection $results
+    ) {
+    }
+
+    public function isValid(): bool
+    {
+        return !$this->results->hasErrors();
+    }
+
+    public function getErrors(): array
+    {
+        return $this->results->getErrors();
+    }
+
+    public function getTransformedData(): array
+    {
+        return $this->results->getProcessedData();
+    }
+
+    public function toArray(): array
+    {
+        return $this->results->toArray();
+    }
+}
diff --git a/src/Trait/ArrayTransformerTrait.php b/src/Trait/ArrayTransformerTrait.php
new file mode 100644
index 0000000..69cb6df
--- /dev/null
+++ b/src/Trait/ArrayTransformerTrait.php
@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Trait;
+
+trait ArrayTransformerTrait
+{
+    protected function toCamelCase(string $input): string
+    {
+        $input = str_replace(['-', '_'], ' ', $input);
+        $input = ucwords($input);
+        $input = str_replace(' ', '', $input);
+
+        return lcfirst($input);
+    }
+
+    protected function toPascalCase(string $input): string
+    {
+        return ucfirst($this->toCamelCase($input));
+    }
+
+    protected function toSnakeCase(string $input): string
+    {
+        $pattern = '/([a-z0-9])([A-Z])/';
+        $input = preg_replace($pattern, '$1_$2', $input);
+        $input = str_replace(['-', ' '], '_', $input);
+
+        return strtolower($input);
+    }
+
+    protected function toKebabCase(string $input): string
+    {
+        return str_replace('_', '-', $this->toSnakeCase($input));
+    }
+}
diff --git a/src/Trait/StringTransformerTrait.php b/src/Trait/StringTransformerTrait.php
new file mode 100644
index 0000000..b4c9cd2
--- /dev/null
+++ b/src/Trait/StringTransformerTrait.php
@@ -0,0 +1,58 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer\Trait;
+
+trait StringTransformerTrait
+{
+    protected function toLowerCase(string $input): string
+    {
+        return mb_strtolower($input);
+    }
+
+    protected function toUpperCase(string $input): string
+    {
+        return mb_strtoupper($input);
+    }
+
+    protected function toTitleCase(string $input): string
+    {
+        return mb_convert_case($input, MB_CASE_TITLE);
+    }
+
+    protected function toSentenceCase(string $input): string
+    {
+        $input = $this->toLowerCase($input);
+
+        return ucfirst($input);
+    }
+
+    protected function toCamelCase(string $input): string
+    {
+        $input = str_replace(['-', '_'], ' ', $input);
+        $input = ucwords($input);
+        $input = str_replace(' ', '', $input);
+
+        return lcfirst($input);
+    }
+
+    protected function toPascalCase(string $input): string
+    {
+        return ucfirst($this->toCamelCase($input));
+    }
+
+    protected function toSnakeCase(string $input): string
+    {
+        $pattern = '/([a-z0-9])([A-Z])/';
+        $input = preg_replace($pattern, '$1_$2', $input);
+        $input = str_replace(['-', ' '], '_', $input);
+
+        return strtolower($input);
+    }
+
+    protected function toKebabCase(string $input): string
+    {
+        return str_replace('_', '-', $this->toSnakeCase($input));
+    }
+}
diff --git a/src/Transformer.php b/src/Transformer.php
new file mode 100644
index 0000000..6ca2929
--- /dev/null
+++ b/src/Transformer.php
@@ -0,0 +1,96 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KaririCode\Transformer;
+
+use KaririCode\Contract\Processor\ProcessorRegistry;
+use KaririCode\Contract\Transformer\Transformer as TransformerContract;
+use KaririCode\ProcessorPipeline\Handler\ProcessorAttributeHandler;
+use KaririCode\ProcessorPipeline\ProcessorBuilder;
+use KaririCode\PropertyInspector\AttributeAnalyzer;
+use KaririCode\PropertyInspector\Utility\PropertyInspector;
+use KaririCode\Transformer\Attribute\Transform;
+use KaririCode\Transformer\Result\TransformationResult;
+
+final class Transformer implements TransformerContract
+{
+    private const IDENTIFIER = 'transformer';
+
+    private readonly ProcessorBuilder $builder;
+
+    public function __construct(
+        private readonly ProcessorRegistry $registry
+    ) {
+        $this->builder = new ProcessorBuilder($this->registry);
+    }
+
+    public function transform(mixed $object): TransformationResult
+    {
+        $attributeHandler = new ProcessorAttributeHandler(
+            self::IDENTIFIER,
+            $this->builder
+        );
+
+        $propertyInspector = new PropertyInspector(
+            new AttributeAnalyzer(Transform::class)
+        );
+
+        /** @var ProcessorAttributeHandler */
+        $handler = $propertyInspector->inspect($object, $attributeHandler);
+        $handler->applyChanges($object);
+
+        return new TransformationResult(
+            $handler->getProcessingResults()
+        );
+    }
+}
+
+namespace KaririCode\Transformer\Processor\Composite;
+
+use KaririCode\Contract\Processor\ConfigurableProcessor;
+use KaririCode\Transformer\Processor\AbstractTransformerProcessor;
+
+class ChainTransformer extends AbstractTransformerProcessor implements ConfigurableProcessor
+{
+    /** @var array<AbstractTransformerProcessor> */
+    private array $transformers = [];
+
+    private bool $stopOnError = true;
+
+    public function configure(array $options): void
+    {
+        if (isset($options['transformers']) && is_array($options['transformers'])) {
+            foreach ($options['transformers'] as $transformer) {
+                if ($transformer instanceof AbstractTransformerProcessor) {
+                    $this->transformers[] = $transformer;
+                }
+            }
+        }
+
+        $this->stopOnError = $options['stopOnError'] ?? $this->stopOnError;
+    }
+
+    public function process(mixed $input): mixed
+    {
+        $result = $input;
+
+        foreach ($this->transformers as $transformer) {
+            try {
+                $result = $transformer->process($result);
+
+                if (!$transformer->isValid() && $this->stopOnError) {
+                    $this->setInvalid($transformer->getErrorKey());
+                    break;
+                }
+            } catch (\Exception $e) {
+                if ($this->stopOnError) {
+                    $this->setInvalid('transformationError');
+                    break;
+                }
+            }
+        }
+
+        return $result;
+    }
+}
diff --git a/tests/application.php b/tests/application.php
index a075e1e..c6ceafe 100644
--- a/tests/application.php
+++ b/tests/application.php
@@ -3,3 +3,260 @@
 declare(strict_types=1);
 
 require_once __DIR__ . '/../vendor/autoload.php';
+
+use KaririCode\ProcessorPipeline\ProcessorRegistry;
+use KaririCode\Transformer\Attribute\Transform;
+use KaririCode\Transformer\Processor\Array\ArrayFlattenTransformer;
+use KaririCode\Transformer\Processor\Array\ArrayGroupTransformer;
+use KaririCode\Transformer\Processor\Array\ArrayKeyTransformer;
+use KaririCode\Transformer\Processor\Array\ArrayMapTransformer;
+use KaririCode\Transformer\Processor\Data\DateTransformer;
+use KaririCode\Transformer\Processor\Data\JsonTransformer;
+use KaririCode\Transformer\Processor\Data\NumberTransformer;
+use KaririCode\Transformer\Processor\String\CaseTransformer;
+use KaririCode\Transformer\Processor\String\MaskTransformer;
+use KaririCode\Transformer\Processor\String\SlugTransformer;
+use KaririCode\Transformer\Processor\String\TemplateTransformer;
+use KaririCode\Transformer\Transformer;
+
+// 1. Define the entity class with transformation rules
+class DataTransformer
+{
+    #[Transform(
+        processors: ['date' => ['inputFormat' => 'd/m/Y', 'outputFormat' => 'Y-m-d']]
+    )]
+    private string $date = '25/12/2024';
+
+    #[Transform(
+        processors: ['number' => ['decimals' => 2, 'decimalPoint' => ',', 'thousandsSeparator' => '.']]
+    )]
+    private float $price = 1234.56;
+
+    #[Transform(
+        processors: ['mask' => ['type' => 'phone']]
+    )]
+    private string $phone = '11999887766';
+
+    #[Transform(
+        processors: ['case' => ['case' => 'snake']]
+    )]
+    private string $text = 'transformThisTextToSnakeCase';
+
+    #[Transform(
+        processors: ['slug' => []]
+    )]
+    private string $title = 'This is a Title for URL!';
+
+    #[Transform(
+        processors: ['arrayKey' => ['case' => 'camel']]
+    )]
+    private array $data = [
+        'user_name' => 'Carlos Silva',
+        'email_address' => 'carlos@example.com',
+        'phone_number' => '1234567890',
+    ];
+
+    #[Transform(
+        processors: ['json' => ['encodeOptions' => JSON_PRETTY_PRINT]]
+    )]
+    private array $jsonData = [
+        'id' => 1,
+        'name' => 'Product',
+        'price' => 99.99,
+    ];
+
+    #[Transform(
+        processors: [
+            'template' => [
+                'template' => 'Hello {{name}}, your order #{{order_id}} is {{status}}',
+                'removeUnmatchedTags' => true,
+            ],
+        ]
+    )]
+    private array $templateData = [
+        'name' => 'Carlos',
+        'order_id' => '12345',
+        'status' => 'completed',
+    ];
+
+    // Getters and setters
+    public function getDate(): string
+    {
+        return $this->date;
+    }
+
+    public function getPrice(): float
+    {
+        return $this->price;
+    }
+
+    public function getPhone(): string
+    {
+        return $this->phone;
+    }
+
+    public function getText(): string
+    {
+        return $this->text;
+    }
+
+    public function getTitle(): string
+    {
+        return $this->title;
+    }
+
+    public function getData(): array
+    {
+        return $this->data;
+    }
+
+    public function getJsonData(): array
+    {
+        return $this->jsonData;
+    }
+
+    public function getTemplateData(): array
+    {
+        return $this->templateData;
+    }
+}
+
+// 2. Set up the transformer registry
+function setupTransformerRegistry(): ProcessorRegistry
+{
+    $registry = new ProcessorRegistry();
+
+    // Register all transformers
+    $registry->register('transformer', 'date', new DateTransformer())
+        ->register('transformer', 'number', new NumberTransformer())
+        ->register('transformer', 'mask', new MaskTransformer())
+        ->register('transformer', 'case', new CaseTransformer())
+        ->register('transformer', 'slug', new SlugTransformer())
+        ->register('transformer', 'arrayKey', new ArrayKeyTransformer())
+        ->register('transformer', 'arrayFlat', new ArrayFlattenTransformer())
+        ->register('transformer', 'arrayGroup', new ArrayGroupTransformer())
+        ->register('transformer', 'arrayMap', new ArrayMapTransformer())
+        ->register('transformer', 'json', new JsonTransformer())
+        ->register('transformer', 'template', new TemplateTransformer());
+
+    return $registry;
+}
+
+// 3. Helper function to display transformation results
+function displayTransformationResults(object $data, array $errors): void
+{
+    echo "\nTransformed Data:\n";
+    echo "================\n";
+
+    // Standard date formatting
+    echo 'Date: ' . $data->getDate() . "\n";
+
+    // Number formatting with localized separators
+    echo 'Price: ' . number_format($data->getPrice(), 2, ',', '.') . "\n";
+
+    // Phone is already formatted by the transformer
+    echo 'Phone: ' . $data->getPhone() . "\n";
+
+    // Text transformed to snake_case
+    echo 'Text: ' . $data->getText() . "\n";
+
+    // Slug is already formatted
+    echo 'Title (Slug): ' . $data->getTitle() . "\n";
+
+    // Array with keys in camelCase
+    echo 'Array Data: ' . print_r($data->getData(), true);
+
+    // JSON Data formatted for better readability
+    echo 'JSON Data: ' . json_encode($data->getJsonData(), JSON_PRETTY_PRINT) . "\n";
+
+    // Template Data with rendered result
+    $templateData = $data->getTemplateData();
+    echo "Template Data:\n";
+
+    // Show original template data
+    echo 'Original Data: ' . print_r(array_diff_key($templateData, ['_rendered' => '']), true);
+
+    // Display rendered result
+    if (isset($templateData['_rendered'])) {
+        echo 'Rendered Result: ' . $templateData['_rendered'] . "\n";
+    }
+
+    if (!empty($errors)) {
+        echo "\n\033[31mTransformation Errors:\033[0m\n";
+        foreach ($errors as $property => $propertyErrors) {
+            foreach ($propertyErrors as $error) {
+                echo "\033[31m- {$property}: {$error['message']}\033[0m\n";
+            }
+        }
+    } else {
+        echo "\n\033[32mAll transformations completed successfully!\033[0m\n";
+    }
+}
+
+// 4. Test cases for additional transformers
+function runAdditionalTests(Transformer $transformer): void
+{
+    echo "\n\033[1mTesting Array Transformers\033[0m\n";
+    echo "=======================\n";
+
+    // Test ArrayFlattenTransformer
+    $nestedArray = [
+        'user' => [
+            'profile' => [
+                'name' => 'Carlos',
+                'contacts' => [
+                    'email' => 'carlos@example.com',
+                ],
+            ],
+        ],
+    ];
+
+    $flattenTransformer = new ArrayFlattenTransformer();
+    $flattenTransformer->configure(['depth' => -1]);
+    $flattened = $flattenTransformer->process($nestedArray);
+    echo "Flattened Array:\n";
+    print_r($flattened);
+
+    // Test ArrayGroupTransformer
+    $users = [
+        ['name' => 'Carlos', 'role' => 'admin'],
+        ['name' => 'Ana', 'role' => 'user'],
+        ['name' => 'Bia', 'role' => 'admin'],
+    ];
+
+    $groupTransformer = new ArrayGroupTransformer();
+    $groupTransformer->configure(['groupBy' => 'role']);
+    $grouped = $groupTransformer->process($users);
+    echo "\nGrouped Array:\n";
+    print_r($grouped);
+}
+
+// 5. Main application execution
+function main(): void
+{
+    try {
+        echo "\033[1mKaririCode Transformer Demo\033[0m\n";
+        echo "================================\n";
+
+        // Setup
+        $registry = setupTransformerRegistry();
+        $transformer = new Transformer($registry);
+
+        // Create and transform data
+        $data = new DataTransformer();
+        $result = $transformer->transform($data);
+
+        // Display results
+        displayTransformationResults($data, $result->getErrors());
+
+        // Run additional tests
+        runAdditionalTests($transformer);
+    } catch (Exception $e) {
+        echo "\033[31mError: {$e->getMessage()}\033[0m\n";
+        echo "\033[33mStack trace:\033[0m\n";
+        echo $e->getTraceAsString() . "\n";
+    }
+}
+
+// Run the application
+main();