@capawesome/capacitor-localization 0.0.1

package/CapawesomeCapacitorLocalization.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapawesomeCapacitorLocalization'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license']
+  s.homepage = package['repository']['url']
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.source_files = 'ios/Plugin/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '15.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+end

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robin Genz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Package.swift

@@ -0,0 +1,28 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "CapawesomeCapacitorLocalization",
+    platforms: [.iOS(.v15)],
+    products: [
+        .library(
+            name: "CapawesomeCapacitorLocalization",
+            targets: ["LocalizationPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0")
+    ],
+    targets: [
+        .target(
+            name: "LocalizationPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Plugin"),
+        .testTarget(
+            name: "LocalizationPluginTests",
+            dependencies: ["LocalizationPlugin"],
+            path: "ios/PluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,193 @@
+# @capawesome/capacitor-localization
+
+Capacitor plugin to read the user's localization preferences, such as preferred locales, time zone, and regional formatting settings.
+
+<div class="capawesome-z29o10a">
+  <a href="https://cloud.capawesome.io/" target="_blank">
+    <img alt="Deliver Live Updates to your Capacitor app with Capawesome Cloud" src="https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1" />
+  </a>
+</div>
+
+## Features
+
+- 🌍 **Preferred locales**: Read the user's preferred locales, ordered by preference.
+- 💱 **Regional formatting**: Read currency, decimal, and grouping separators per locale.
+- ↔️ **Text direction**: Detect whether a locale is written left-to-right or right-to-left.
+- 📏 **Measurement system**: Detect the metric, US, or UK measurement system.
+- 🕐 **Settings**: Read the time zone, clock format, and first day of the week.
+- 🖥️ **Cross-platform**: Full support for Android, iOS, and Web.
+- 📦 **CocoaPods & SPM**: Supports CocoaPods and Swift Package Manager for iOS.
+- 🔁 **Up-to-date**: Always supports the latest Capacitor version.
+
+Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!
+
+## Newsletter
+
+Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).
+
+## Compatibility
+
+| Plugin Version | Capacitor Version | Status         |
+| -------------- | ----------------- | -------------- |
+| 0.x.x          | >=8.x.x           | Active support |
+
+## Installation
+
+You can use our **AI-Assisted Setup** to install the plugin.
+Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills --skill capacitor-plugins
+```
+
+Then use the following prompt:
+
+```
+ Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-localization` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
+
+```bash
+npm install @capawesome/capacitor-localization
+npx cap sync
+```
+
+No additional permissions or configuration are required on any platform.
+
+## Configuration
+
+No configuration required for this plugin.
+
+## Usage
+
+```typescript
+import { Localization } from '@capawesome/capacitor-localization';
+
+const getLocales = async () => {
+  const { locales } = await Localization.getLocales();
+  return locales;
+};
+
+const getSettings = async () => {
+  const settings = await Localization.getSettings();
+  return settings;
+};
+```
+
+## API
+
+<docgen-index>
+
+* [`getLocales()`](#getlocales)
+* [`getSettings()`](#getsettings)
+* [Interfaces](#interfaces)
+* [Type Aliases](#type-aliases)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+### getLocales()
+
+```typescript
+getLocales() => Promise<GetLocalesResult>
+```
+
+Get the user's preferred locales, ordered by preference.
+
+The first entry is the most preferred locale.
+
+**Returns:** <code>Promise&lt;<a href="#getlocalesresult">GetLocalesResult</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### getSettings()
+
+```typescript
+getSettings() => Promise<GetSettingsResult>
+```
+
+Get the user's regional formatting settings.
+
+**Returns:** <code>Promise&lt;<a href="#getsettingsresult">GetSettingsResult</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### Interfaces
+
+
+#### GetLocalesResult
+
+| Prop          | Type                  | Description                                                                                        | Since |
+| ------------- | --------------------- | -------------------------------------------------------------------------------------------------- | ----- |
+| **`locales`** | <code>Locale[]</code> | The user's preferred locales, ordered by preference. The first entry is the most preferred locale. | 0.1.0 |
+
+
+#### Locale
+
+| Prop                    | Type                                                                    | Description                                                                                                                                 | Since |
+| ----------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
+| **`currencyCode`**      | <code>string \| null</code>                                             | The ISO 4217 currency code of the locale. Returns `null` if the currency cannot be determined.                                              | 0.1.0 |
+| **`currencySymbol`**    | <code>string \| null</code>                                             | The currency symbol of the locale. Returns `null` if the currency symbol cannot be determined.                                              | 0.1.0 |
+| **`decimalSeparator`**  | <code>string \| null</code>                                             | The character used to separate the integer part from the fractional part of a number. Returns `null` if the separator cannot be determined. | 0.1.0 |
+| **`groupingSeparator`** | <code>string \| null</code>                                             | The character used to group digits of the integer part of a number. Returns `null` if the separator cannot be determined.                   | 0.1.0 |
+| **`languageCode`**      | <code>string</code>                                                     | The ISO 639 language code of the locale.                                                                                                    | 0.1.0 |
+| **`languageTag`**       | <code>string</code>                                                     | The BCP 47 language tag of the locale.                                                                                                      | 0.1.0 |
+| **`measurementSystem`** | <code><a href="#measurementsystem">MeasurementSystem</a> \| null</code> | The measurement system used by the locale. Returns `null` if the measurement system cannot be determined.                                   | 0.1.0 |
+| **`regionCode`**        | <code>string \| null</code>                                             | The ISO 3166 region code of the locale. Returns `null` if the region cannot be determined.                                                  | 0.1.0 |
+| **`textDirection`**     | <code><a href="#textdirection">TextDirection</a></code>                 | The writing direction of the locale's language.                                                                                             | 0.1.0 |
+
+
+#### GetSettingsResult
+
+| Prop                  | Type                 | Description                                                                                                                           | Since |
+| --------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ----- |
+| **`firstDayOfWeek`**  | <code>number</code>  | The first day of the week as configured by the user. The value follows the ISO 8601 convention where `1` is Monday and `7` is Sunday. | 0.1.0 |
+| **`timeZone`**        | <code>string</code>  | The identifier of the user's current time zone.                                                                                       | 0.1.0 |
+| **`uses24HourClock`** | <code>boolean</code> | Whether the user prefers a 24-hour clock over a 12-hour clock.                                                                        | 0.1.0 |
+
+
+### Type Aliases
+
+
+#### MeasurementSystem
+
+The measurement system used by a locale.
+
+- `metric`: The metric system (e.g. meters, kilograms).
+- `us`: The United States customary system (e.g. feet, pounds).
+- `uk`: The United Kingdom imperial system.
+
+<code>'metric' | 'us' | 'uk'</code>
+
+
+#### TextDirection
+
+The writing direction of a language.
+
+- `ltr`: Left-to-right (e.g. English, German).
+- `rtl`: Right-to-left (e.g. Arabic, Hebrew).
+
+<code>'ltr' | 'rtl'</code>
+
+</docgen-api>
+
+## Platform Support
+
+The plugin returns `null` for any field that a platform cannot determine. On the **Web** platform, `currencyCode`, `currencySymbol`, and `measurementSystem` are always `null`, because the browser does not expose this information.
+
+## Changelog
+
+See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/localization/CHANGELOG.md).
+
+## License
+
+See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/localization/LICENSE).

package/android/build.gradle

@@ -0,0 +1,58 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.13.0'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace = "io.capawesome.capacitorjs.plugins.localization"
+    compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 36
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 24
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 36
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError = false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/io/capawesome/capacitorjs/plugins/localization/Localization.java

@@ -0,0 +1,108 @@
+package io.capawesome.capacitorjs.plugins.localization;
+
+import android.content.Context;
+import android.os.LocaleList;
+import android.text.TextUtils;
+import android.text.format.DateFormat;
+import android.view.View;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import io.capawesome.capacitorjs.plugins.localization.classes.results.GetLocalesResult;
+import io.capawesome.capacitorjs.plugins.localization.classes.results.GetSettingsResult;
+import io.capawesome.capacitorjs.plugins.localization.classes.results.LocaleResult;
+import io.capawesome.capacitorjs.plugins.localization.interfaces.NonEmptyResultCallback;
+import java.text.DecimalFormatSymbols;
+import java.util.ArrayList;
+import java.util.Calendar;
+import java.util.Currency;
+import java.util.List;
+import java.util.Locale;
+import java.util.TimeZone;
+
+public class Localization {
+
+    @NonNull
+    private final Context context;
+
+    public Localization(@NonNull Context context) {
+        this.context = context;
+    }
+
+    public void getLocales(@NonNull NonEmptyResultCallback<GetLocalesResult> callback) {
+        LocaleList localeList = LocaleList.getDefault();
+        List<LocaleResult> locales = new ArrayList<>();
+        for (int i = 0; i < localeList.size(); i++) {
+            locales.add(createLocaleResult(localeList.get(i)));
+        }
+        callback.success(new GetLocalesResult(locales));
+    }
+
+    public void getSettings(@NonNull NonEmptyResultCallback<GetSettingsResult> callback) {
+        String timeZone = TimeZone.getDefault().getID();
+        boolean uses24HourClock = DateFormat.is24HourFormat(context);
+        int firstDayOfWeek = convertToIsoDayOfWeek(Calendar.getInstance().getFirstDayOfWeek());
+        callback.success(new GetSettingsResult(timeZone, uses24HourClock, firstDayOfWeek));
+    }
+
+    private int convertToIsoDayOfWeek(int calendarDayOfWeek) {
+        return ((calendarDayOfWeek + 5) % 7) + 1;
+    }
+
+    @NonNull
+    private LocaleResult createLocaleResult(@NonNull Locale locale) {
+        String languageTag = locale.toLanguageTag();
+        String languageCode = locale.getLanguage();
+        String regionCode = locale.getCountry().isEmpty() ? null : locale.getCountry();
+        Currency currency = resolveCurrency(locale);
+        String currencyCode = currency == null ? null : currency.getCurrencyCode();
+        String currencySymbol = currency == null ? null : currency.getSymbol(locale);
+        DecimalFormatSymbols symbols = DecimalFormatSymbols.getInstance(locale);
+        String decimalSeparator = String.valueOf(symbols.getDecimalSeparator());
+        String groupingSeparator = String.valueOf(symbols.getGroupingSeparator());
+        String textDirection = resolveTextDirection(locale);
+        String measurementSystem = resolveMeasurementSystem(regionCode);
+        return new LocaleResult(
+            languageTag,
+            languageCode,
+            regionCode,
+            currencyCode,
+            currencySymbol,
+            decimalSeparator,
+            groupingSeparator,
+            textDirection,
+            measurementSystem
+        );
+    }
+
+    @Nullable
+    private Currency resolveCurrency(@NonNull Locale locale) {
+        try {
+            return Currency.getInstance(locale);
+        } catch (IllegalArgumentException exception) {
+            return null;
+        }
+    }
+
+    @Nullable
+    private String resolveMeasurementSystem(@Nullable String regionCode) {
+        if (regionCode == null) {
+            return null;
+        }
+        switch (regionCode.toUpperCase(Locale.ROOT)) {
+            case "US":
+            case "LR":
+            case "MM":
+                return "us";
+            case "GB":
+                return "uk";
+            default:
+                return "metric";
+        }
+    }
+
+    @NonNull
+    private String resolveTextDirection(@NonNull Locale locale) {
+        int layoutDirection = TextUtils.getLayoutDirectionFromLocale(locale);
+        return layoutDirection == View.LAYOUT_DIRECTION_RTL ? "rtl" : "ltr";
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/localization/LocalizationPlugin.java

@@ -0,0 +1,85 @@
+package io.capawesome.capacitorjs.plugins.localization;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.getcapacitor.Logger;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+import io.capawesome.capacitorjs.plugins.localization.classes.results.GetLocalesResult;
+import io.capawesome.capacitorjs.plugins.localization.classes.results.GetSettingsResult;
+import io.capawesome.capacitorjs.plugins.localization.interfaces.NonEmptyResultCallback;
+import io.capawesome.capacitorjs.plugins.localization.interfaces.Result;
+
+@CapacitorPlugin(name = "Localization")
+public class LocalizationPlugin extends Plugin {
+
+    public static final String TAG = "Localization";
+
+    private static final String ERROR_UNKNOWN_ERROR = "An unknown error occurred.";
+
+    private Localization implementation;
+
+    @Override
+    public void load() {
+        implementation = new Localization(getContext());
+    }
+
+    @PluginMethod
+    public void getLocales(PluginCall call) {
+        try {
+            NonEmptyResultCallback<GetLocalesResult> callback = new NonEmptyResultCallback<>() {
+                @Override
+                public void success(@NonNull GetLocalesResult result) {
+                    resolveCall(call, result);
+                }
+
+                @Override
+                public void error(@NonNull Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+            implementation.getLocales(callback);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
+    @PluginMethod
+    public void getSettings(PluginCall call) {
+        try {
+            NonEmptyResultCallback<GetSettingsResult> callback = new NonEmptyResultCallback<>() {
+                @Override
+                public void success(@NonNull GetSettingsResult result) {
+                    resolveCall(call, result);
+                }
+
+                @Override
+                public void error(@NonNull Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+            implementation.getSettings(callback);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
+    private void rejectCall(@NonNull PluginCall call, @NonNull Exception exception) {
+        String message = exception.getMessage();
+        if (message == null) {
+            message = ERROR_UNKNOWN_ERROR;
+        }
+        Logger.error(TAG, message, exception);
+        call.reject(message);
+    }
+
+    private void resolveCall(@NonNull PluginCall call, @Nullable Result result) {
+        if (result == null) {
+            call.resolve();
+        } else {
+            call.resolve(result.toJSObject());
+        }
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/localization/classes/results/GetLocalesResult.java

@@ -0,0 +1,29 @@
+package io.capawesome.capacitorjs.plugins.localization.classes.results;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.JSArray;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.localization.interfaces.Result;
+import java.util.List;
+
+public class GetLocalesResult implements Result {
+
+    @NonNull
+    private final List<LocaleResult> locales;
+
+    public GetLocalesResult(@NonNull List<LocaleResult> locales) {
+        this.locales = locales;
+    }
+
+    @Override
+    @NonNull
+    public JSObject toJSObject() {
+        JSArray localesArray = new JSArray();
+        for (LocaleResult locale : locales) {
+            localesArray.put(locale.toJSObject());
+        }
+        JSObject result = new JSObject();
+        result.put("locales", localesArray);
+        return result;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/localization/classes/results/GetSettingsResult.java

@@ -0,0 +1,31 @@
+package io.capawesome.capacitorjs.plugins.localization.classes.results;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.localization.interfaces.Result;
+
+public class GetSettingsResult implements Result {
+
+    private final int firstDayOfWeek;
+
+    @NonNull
+    private final String timeZone;
+
+    private final boolean uses24HourClock;
+
+    public GetSettingsResult(@NonNull String timeZone, boolean uses24HourClock, int firstDayOfWeek) {
+        this.timeZone = timeZone;
+        this.uses24HourClock = uses24HourClock;
+        this.firstDayOfWeek = firstDayOfWeek;
+    }
+
+    @Override
+    @NonNull
+    public JSObject toJSObject() {
+        JSObject result = new JSObject();
+        result.put("firstDayOfWeek", firstDayOfWeek);
+        result.put("timeZone", timeZone);
+        result.put("uses24HourClock", uses24HourClock);
+        return result;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/localization/classes/results/LocaleResult.java

@@ -0,0 +1,75 @@
+package io.capawesome.capacitorjs.plugins.localization.classes.results;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.localization.interfaces.Result;
+import org.json.JSONObject;
+
+public class LocaleResult implements Result {
+
+    @Nullable
+    private final String currencyCode;
+
+    @Nullable
+    private final String currencySymbol;
+
+    @Nullable
+    private final String decimalSeparator;
+
+    @Nullable
+    private final String groupingSeparator;
+
+    @NonNull
+    private final String languageCode;
+
+    @NonNull
+    private final String languageTag;
+
+    @Nullable
+    private final String measurementSystem;
+
+    @Nullable
+    private final String regionCode;
+
+    @NonNull
+    private final String textDirection;
+
+    public LocaleResult(
+        @NonNull String languageTag,
+        @NonNull String languageCode,
+        @Nullable String regionCode,
+        @Nullable String currencyCode,
+        @Nullable String currencySymbol,
+        @Nullable String decimalSeparator,
+        @Nullable String groupingSeparator,
+        @NonNull String textDirection,
+        @Nullable String measurementSystem
+    ) {
+        this.languageTag = languageTag;
+        this.languageCode = languageCode;
+        this.regionCode = regionCode;
+        this.currencyCode = currencyCode;
+        this.currencySymbol = currencySymbol;
+        this.decimalSeparator = decimalSeparator;
+        this.groupingSeparator = groupingSeparator;
+        this.textDirection = textDirection;
+        this.measurementSystem = measurementSystem;
+    }
+
+    @Override
+    @NonNull
+    public JSObject toJSObject() {
+        JSObject result = new JSObject();
+        result.put("currencyCode", currencyCode == null ? JSONObject.NULL : currencyCode);
+        result.put("currencySymbol", currencySymbol == null ? JSONObject.NULL : currencySymbol);
+        result.put("decimalSeparator", decimalSeparator == null ? JSONObject.NULL : decimalSeparator);
+        result.put("groupingSeparator", groupingSeparator == null ? JSONObject.NULL : groupingSeparator);
+        result.put("languageCode", languageCode);
+        result.put("languageTag", languageTag);
+        result.put("measurementSystem", measurementSystem == null ? JSONObject.NULL : measurementSystem);
+        result.put("regionCode", regionCode == null ? JSONObject.NULL : regionCode);
+        result.put("textDirection", textDirection);
+        return result;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/localization/interfaces/Callback.java

@@ -0,0 +1,5 @@
+package io.capawesome.capacitorjs.plugins.localization.interfaces;
+
+public interface Callback {
+    void error(Exception exception);
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/localization/interfaces/NonEmptyResultCallback.java

@@ -0,0 +1,7 @@
+package io.capawesome.capacitorjs.plugins.localization.interfaces;
+
+import androidx.annotation.NonNull;
+
+public interface NonEmptyResultCallback<T extends Result> extends Callback {
+    void success(@NonNull T result);
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/localization/interfaces/Result.java

@@ -0,0 +1,7 @@
+package io.capawesome.capacitorjs.plugins.localization.interfaces;
+
+import com.getcapacitor.JSObject;
+
+public interface Result {
+    JSObject toJSObject();
+}