feat: add localization() method to Device

Return device locale, language, region, timezone, currency, and
preferred language via the Device.GetLocale bridge function as an
immutable Localization data object.

Author: benjam-es

src/Data/Localization.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Native\Mobile\Data;
+
+class Localization
+{
+    public function __construct(
+        public readonly string $locale,
+        public readonly string $languageCode,
+        public readonly string $regionCode,
+        public readonly string $timezone,
+        public readonly string $currencyCode,
+        public readonly string $preferredLanguage,
+    ) {}
+}

src/Device.php

@@ -2,6 +2,8 @@
 
 namespace Native\Mobile;
 
+use Native\Mobile\Data\Localization;
+
 class Device
 {
     public function getId(): ?string
@@ -46,6 +48,28 @@ public function getBatteryInfo(): ?string
         return null;
     }
 
+    public function localization(): ?Localization
+    {
+        if (function_exists('nativephp_call')) {
+            $result = nativephp_call('Device.GetLocale', '{}');
+            if ($result) {
+                $decoded = json_decode($result, true);
+                $info = json_decode($decoded['info'] ?? '{}', true);
+
+                return new Localization(
+                    locale: $info['locale'] ?? '',
+                    languageCode: $info['languageCode'] ?? '',
+                    regionCode: $info['regionCode'] ?? '',
+                    timezone: $info['timezone'] ?? '',
+                    currencyCode: $info['currencyCode'] ?? '',
+                    preferredLanguage: $info['preferredLanguage'] ?? '',
+                );
+            }
+        }
+
+        return null;
+    }
+
     /**
      * Vibrate the device with a short haptic feedback.
      *

src/Facades/Device.php

@@ -8,6 +8,7 @@
  * @method static string|null getId()
  * @method static string|null getInfo()
  * @method static string|null getBatteryInfo()
+ * @method static \Native\Mobile\Data\Localization|null localization()
  * @method static bool vibrate()
  * @method static array toggleFlashlight()
  */