======================================================================
 mb::JSON Cheat Sheet                                      [TR] Türkçe
======================================================================

[ Veri Türü Eşleştirmesi ]
  JSON       -> Perl
  -----------------------------------------------
  "metin"    -> skaler string
  123        -> skaler sayı
  true       -> mb::JSON::Boolean (değer: 1)
  false      -> mb::JSON::Boolean (değer: 0)
  null       -> undef
  [...]      -> dizi referansı
  {...}      -> hash referansı

[ 1. Yükleme ]
  use mb::JSON;

[ 2. decode: JSON -> Perl ]
  my $data = mb::JSON::decode($json_text);

[ 3. parse: decode() için alias ]
  my $data = mb::JSON::parse($json_text);

[ 4. encode: Perl -> JSON ]
  my $json = mb::JSON::encode($data);

[ 5. stringify: Perl -> JSON  (JavaScript uyumlu alias) ]
  my $json = mb::JSON::stringify($data);
  # stringify() ve encode() aynı çıktıyı üretir

[ 6. Boolean ]
  mb::JSON::true  -> true
  mb::JSON::false -> false

[ 7. null / undef ]
  undef -> null  /  null -> undef

[ 8. Hash anahtarları alfabetik sırayla dizilir ]
  encode({b=>2,a=>1}) -> '{"a":1,"b":2}'

[ 9. UTF-8 olduğu gibi kalır ]
  encode({"name"=>"田中"}) -> '{"name":"田中"}'
  decode: "\uXXXX"           -> UTF-8
  decode: "\uD83D\uDE00"     -> 4-byte UTF-8 (emoji)

[ 10. Örnek ]
  my $h = mb::JSON::decode('{"name":"Alice","ok":true}');
  my $j = mb::JSON::encode({name=>'Alice',ok=>mb::JSON::true});
  my $j = mb::JSON::stringify({name=>'Alice',ok=>mb::JSON::true});
  # -> {"name":"Alice","ok":true}
