fix: use compact in compare method to showcase token savings benefits

iamgerwin · iamgerwin · commit c4b0fa021af8 · 2026-01-25T13:06:55.000+08:00
- Changed compare method to use compact() instead of encode()
- Removed off on off off off off off off off off on off on off off off off off on off off off on on off off off off on off off off off off off off off off off off off on off off off off off off off on off on on off off off on off off on off off on off off on off on off off on off on off off off off on off off off on off off on off off off off off off off off on off on off off on off off off off off off off off off off off off on off off off on off on off on on off off off off on on on off on on off on off on on off off off off on on off off on off off off off off on off off on off off on off off off off off off on off off off off on on off on off off off off off on off on off off off off off off off off off off on on off on off off off parameter since compare should always showcase best-case savings
- Ensures TOON's token efficiency is properly demonstrated
diff --git a/src/Toon.php b/src/Toon.php
@@ -27,7 +27,7 @@ class Toon
     public static function encode($value, $options = null): string
     {
         if ($options === null) {
-            $options = new EncodeOptions();
+            $options = new EncodeOptions;
         }
 
         return ToonSerializer::serialize($value, $options);
@@ -45,7 +45,7 @@ public static function encode($value, $options = null): string
     public static function decode(string $toon, $options = null)
     {
         if ($options === null) {
-            $options = new DecodeOptions();
+            $options = new DecodeOptions;
         }
 
         return ToonDeserializer::deserialize($toon, $options);
@@ -54,8 +54,7 @@ public static function decode(string $toon, $options = null)
     /**
      * Encode to compact TOON format (minimal whitespace).
      *
-     * @param mixed $value
-     * @return string
+     * @param  mixed  $value
      */
     public static function compact($value): string
     {
@@ -65,8 +64,7 @@ public static function compact($value): string
     /**
      * Encode to readable TOON format (more whitespace for readability).
      *
-     * @param mixed $value
-     * @return string
+     * @param  mixed  $value
      */
     public static function readable($value): string
     {
@@ -76,8 +74,7 @@ public static function readable($value): string
     /**
      * Encode to tabular TOON format (optimized for uniform arrays).
      *
-     * @param mixed $value
-     * @return string
+     * @param  mixed  $value
      */
     public static function tabular($value): string
     {
@@ -98,13 +95,14 @@ public static function estimateTokens(string $toon): int
     /**
      * Compare TOON vs JSON token usage.
      *
-     * @param mixed $value
-     * @param EncodeOptions|null $options
+     * Uses compact format to showcase TOON's token savings benefits.
+     *
+     * @param  mixed  $value
      * @return array<string, mixed> Array with keys: toon, json, toon_tokens, json_tokens, savings_percent
      */
-    public static function compare($value, $options = null): array
+    public static function compare($value): array
     {
-        $toon = self::encode($value, $options);
+        $toon = self::compact($value);
         $json = json_encode($value, JSON_THROW_ON_ERROR);
 
         $toonTokens = self::estimateTokens($toon);

Original file line number	Diff line number	Diff line change
`@@ -27,7 +27,7 @@ class Toon`
`27`	`27`	`public static function encode($value, $options = null): string`
`28`	`28`	`{`
`29`	`29`	`if ($options === null) {`
`30`		`- $options = new EncodeOptions();`
	`30`	`+ $options = new EncodeOptions;`
`31`	`31`	`}`
`32`	`32`
`33`	`33`	`return ToonSerializer::serialize($value, $options);`
`@@ -45,7 +45,7 @@ public static function encode($value, $options = null): string`
`45`	`45`	`public static function decode(string $toon, $options = null)`
`46`	`46`	`{`
`47`	`47`	`if ($options === null) {`
`48`		`- $options = new DecodeOptions();`
	`48`	`+ $options = new DecodeOptions;`
`49`	`49`	`}`
`50`	`50`
`51`	`51`	`return ToonDeserializer::deserialize($toon, $options);`
`@@ -54,8 +54,7 @@ public static function decode(string $toon, $options = null)`
`54`	`54`	`/**`
`55`	`55`	`* Encode to compact TOON format (minimal whitespace).`
`56`	`56`	`*`
`57`		`- * @param mixed $value`
`58`		`- * @return string`
	`57`	`+ * @param mixed $value`
`59`	`58`	`*/`
`60`	`59`	`public static function compact($value): string`
`61`	`60`	`{`
`@@ -65,8 +64,7 @@ public static function compact($value): string`
`65`	`64`	`/**`
`66`	`65`	`* Encode to readable TOON format (more whitespace for readability).`
`67`	`66`	`*`
`68`		`- * @param mixed $value`
`69`		`- * @return string`
	`67`	`+ * @param mixed $value`
`70`	`68`	`*/`
`71`	`69`	`public static function readable($value): string`
`72`	`70`	`{`
`@@ -76,8 +74,7 @@ public static function readable($value): string`
`76`	`74`	`/**`
`77`	`75`	`* Encode to tabular TOON format (optimized for uniform arrays).`
`78`	`76`	`*`
`79`		`- * @param mixed $value`
`80`		`- * @return string`
	`77`	`+ * @param mixed $value`
`81`	`78`	`*/`
`82`	`79`	`public static function tabular($value): string`
`83`	`80`	`{`
`@@ -98,13 +95,14 @@ public static function estimateTokens(string $toon): int`
`98`	`95`	`/**`
`99`	`96`	`* Compare TOON vs JSON token usage.`
`100`	`97`	`*`
`101`		`- * @param mixed $value`
`102`		`- * @param EncodeOptions\|null $options`
	`98`	`+ * Uses compact format to showcase TOON's token savings benefits.`
	`99`	`+ *`
	`100`	`+ * @param mixed $value`
`103`	`101`	`* @return array<string, mixed> Array with keys: toon, json, toon_tokens, json_tokens, savings_percent`
`104`	`102`	`*/`
`105`		`- public static function compare($value, $options = null): array`
	`103`	`+ public static function compare($value): array`
`106`	`104`	`{`
`107`		`- $toon = self::encode($value, $options);`
	`105`	`+ $toon = self::compact($value);`
`108`	`106`	`$json = json_encode($value, JSON_THROW_ON_ERROR);`
`109`	`107`
`110`	`108`	`$toonTokens = self::estimateTokens($toon);`