README

Compact · Token-Efficient · Human-Readable Data Format for AI Prompts & LLM Contexts

???? Table of Contents

1. Overview
2. Key Features
3. Benchmark & Analytics
4. Installation
5. Configuration
6. Usage
7. Quick Benchmark Route
8. Analytics & Visualization
9. CLI Commands
10. Integration Use Cases
11. Compatibility
12. Compression Visualization
13. SEO & AI Integration Keywords
14. License

✨ Overview

TOON for Laravel — also known as Token-Optimized Object Notation — is a Laravel-native AI data optimization library that transforms large JSON or PHP arrays into a compact, readable, and token-efficient format.

It’s crafted for developers working with ChatGPT, Gemini, Claude, Mistral, or OpenAI APIs, helping you:
✅ Save tokens and reduce API costs
✅ Simplify complex prompt structures
✅ Improve AI response quality and context understanding
✅ Maintain human readability and reversibility

???? “Compress your prompts, not your ideas.”

???? Key Features

???? Complex & Nested Array Support (v1.1.8+)

TOON now supports deeply nested and mixed data structures, including:

• Multi-level associative arrays
• Indexed collections inside objects
• Complex real-world structures like users, profiles, orders, metadata, and logs

This enhancement ensures that no structural information is lost, while still benefiting from TOON’s compact, token-efficient format.

Example: Nested Data Conversion

$data = [
    'user' => [
        'id' => 101,
        'active' => true,
        'roles' => ['admin', 'editor'],
        'profile' => [
            'age' => 32,
            'location' => [
                'city' => 'Delhi',
                'country' => 'India',
            ],
        ],
    ],
    'orders' => [
        [
            'order_id' => 'ORD-1001',
            'amount' => 1998,
            'status' => 'paid',
        ],
    ],
];

echo Toon::convert($data);

This structure remains human-readable, reversible, and compact, even with deep nesting.

???? Real-World Benchmark

???? Visual Comparison

JSON (7.7 KB)
██████████████████████████████████████████████████████████████████████████

TOON (2.5 KB)
█████████████████

???? TOON reduces token load by 60–75%, improving AI efficiency, cost, and response quality.

⚙️ Installation

composer require sbsaga/toon

Laravel automatically discovers the Service Provider and Facade.

⚙️ Configuration

php artisan vendor:publish --provider="Sbsaga\Toon\ToonServiceProvider" --tag=config

Creates a configuration file at config/toon.php:

return [
    'enabled' => true,
    'escape_style' => 'backslash',
    'min_rows_to_tabular' => 2,
    'max_preview_items' => 200,
];

???? Usage

➤ Convert JSON → TOON

use Sbsaga\Toon\Facades\Toon;

$data = [
    'user' => 'Sagar',
    'message' => 'Hello, how are you?',
    'tasks' => [
        ['id' => 1, 'done' => false],
        ['id' => 2, 'done' => true],
    ],
];

$converted = Toon::convert($data);
echo $converted;

Output:

user: Sagar
message: Hello\, how are you?
tasks:
  items[2]{done,id}:
    false,1
    true,2

➤ Convert TOON → JSON

$toon = <<<TOON
user: Sagar
tasks:
  items[2]{id,done}:
    1,false
    2,true
TOON;

$json = Toon::decode($toon);
print_r($json);

➤ Estimate Tokens

$stats = Toon::estimateTokens($converted);
print_r($stats);

Output:

{
  "words": 20,
  "chars": 182,
  "tokens_estimate": 19
}

???? Quick Benchmark Route

use Illuminate\Support\Facades\Route;
use Sbsaga\Toon\Facades\Toon;

Route::get('/toon-benchmark', function () {
    $json = json_decode(file_get_contents(storage_path('app/users.json')), true);
    $jsonEncoded = json_encode($json, JSON_PRETTY_PRINT);
    $toonEncoded = Toon::convert($json);

    return response()->json([
        'json_size_bytes' => strlen($jsonEncoded),
        'toon_size_bytes' => strlen($toonEncoded),
        'saving_percent' => round(100 - (strlen($toonEncoded) / strlen($jsonEncoded) * 100), 2),
        'json_content' => $jsonEncoded,
        'toon_content' => $toonEncoded,
    ]);
});

???? Analytics & Visualization

???? Visual Graph (Efficiency Comparison)

| JSON: ██████████████████████████████████████████████████████████ 100%
| TOON: ████████████ 33%

???? Artisan Commands

php artisan toon:convert storage/test.json
php artisan toon:convert storage/test.toon --decode --pretty
php artisan toon:convert storage/test.json --output=storage/result.toon

???? Integration Use Cases

???? Compatibility

???? Example Compression Visualization

JSON (7.7 KB)
██████████████████████████████████████████████████████████████████████████

TOON (2.5 KB)
█████████████████

???? ~67% size reduction while retaining complete data accuracy.

???? SEO & AI Integration Keywords

Keywords:
laravel ai, ai for laravel, chatgpt laravel, laravel chatgpt, gemini laravel, laravel gemini, laravel anthropic, laravel mistral, laravel openai, openai laravel, laravel llm, llm laravel, ai laravel package, prompt compression, token optimizer, laravel json formatter, compact notation, laravel data compressor, token saver, laravel ai integration, sbsaga toon, laravel-toon, toon php, laravel ai toolkit, openai cost optimizer, laravel ai efficiency, chatgpt laravel toolkit, ai-ready laravel package.

???? Contribution

Contributions are highly encouraged!

• Fork the repository
• Create a new feature branch
• Commit & push improvements
• Submit a Pull Request ????

???? License

Licensed under the MIT License — free for both commercial and personal use.

???? “Compress your prompts, not your ideas.” — TOON helps you talk to AI efficiently.