@akylas/nativescript-app-utils 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## 1.0.0 (2024-10-03)
+
+**Note:** Version bump only for package @akylas/nativescript-app-utils

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Burke Holland
+
+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/README.md

@@ -0,0 +1,21 @@
+# NativeScript Application Utils
+
+A NativeScript plugin with utils for app dev
+
+## Usage
+
+````
+npm install @akylas/nativescript-app-utils --save
+````
+
+
+## Development workflow
+
+If you would like to contribute to this plugin in order to enabled the repositories code for development follow this steps:
+
+- Fork the repository locally
+- Open the repository in your favorite terminal
+- Navigate to the src code that contains the plugin's code `cd /src`
+- Execute the npm script `nmp run build.wrappers` or `npm run build.wrappers.watch`
+- When running the Vanila NativeScript demo app execute: `npm run demo.android` or `npm run demo.ios`
+- When running the Angular NativeScript demo app execute: `npm run demo.angular.android` or `npm run demo.angular.ios`

package/index-common.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index-common.js.map

package/index.android.d.ts

@@ -0,0 +1,14 @@
+export declare namespace AppUtilsAndroid {
+    function listenForWindowInsets(onWindowInsetsChange: (result: [number, number, number, number, number]) => void): void;
+    function prepareWindow(window: android.view.Window): void;
+    function getDimensionFromInt(context: android.content.Context, intToGet: number): number;
+    function getColorFromInt(context: android.content.Context, intToGet: number): number;
+    function getColorFromName(context: android.content.Context, name: string): number;
+    function restartApp(): any;
+    function prepareActivity(activity: androidx.appcompat.app.AppCompatActivity): any;
+    function applyDayNight(activity: androidx.appcompat.app.AppCompatActivity, applyDynamicColors: boolean): any;
+    function applyDynamicColors(activity: androidx.appcompat.app.AppCompatActivity): any;
+}
+export declare function setWorkerContextValue(key: any, value: any): void;
+export declare function getWorkerContextValue(key: any): any;
+export declare function getISO3Language(lang: any): string;

package/index.android.js

@@ -0,0 +1,59 @@
+import { Application, Utils } from '@nativescript/core';
+const NWorkerContext = com.nativescript.apputils.WorkersContext.Companion;
+export var AppUtilsAndroid;
+(function (AppUtilsAndroid) {
+    const NUtils = com.nativescript.apputils.Utils;
+    const UtilsCompanion = NUtils.Companion;
+    function listenForWindowInsets(onWindowInsetsChange) {
+        const rootView = Application.getRootView();
+        if (rootView) {
+            UtilsCompanion.listenForWindowInsetsChange(rootView.nativeViewProtected, new NUtils.WindowInsetsCallback({
+                onWindowInsetsChange
+            }));
+        }
+    }
+    AppUtilsAndroid.listenForWindowInsets = listenForWindowInsets;
+    function prepareWindow(window) {
+        UtilsCompanion.prepareWindow(window);
+    }
+    AppUtilsAndroid.prepareWindow = prepareWindow;
+    function getDimensionFromInt(context, intToGet) {
+        return UtilsCompanion.getDimensionFromInt(context, intToGet);
+    }
+    AppUtilsAndroid.getDimensionFromInt = getDimensionFromInt;
+    function getColorFromInt(context, intToGet) {
+        return UtilsCompanion.getColorFromInt(context, intToGet);
+    }
+    AppUtilsAndroid.getColorFromInt = getColorFromInt;
+    function getColorFromName(context, name) {
+        return UtilsCompanion.getColorFromName(context, name);
+    }
+    AppUtilsAndroid.getColorFromName = getColorFromName;
+    function restartApp() {
+        return UtilsCompanion.restartApp(Utils.android.getApplicationContext(), Application.android.startActivity);
+    }
+    AppUtilsAndroid.restartApp = restartApp;
+    function prepareActivity(activity) {
+        return UtilsCompanion.prepareActivity(activity);
+    }
+    AppUtilsAndroid.prepareActivity = prepareActivity;
+    function applyDayNight(activity, applyDynamicColors) {
+        return UtilsCompanion.applyDayNight(activity, applyDynamicColors);
+    }
+    AppUtilsAndroid.applyDayNight = applyDayNight;
+    function applyDynamicColors(activity) {
+        return UtilsCompanion.applyDynamicColors(activity);
+    }
+    AppUtilsAndroid.applyDynamicColors = applyDynamicColors;
+})(AppUtilsAndroid || (AppUtilsAndroid = {}));
+export function setWorkerContextValue(key, value) {
+    NWorkerContext.setValue(key, value);
+}
+export function getWorkerContextValue(key) {
+    return NWorkerContext.getValue(key);
+}
+export function getISO3Language(lang) {
+    const locale = java.util.Locale.forLanguageTag(lang);
+    return locale.getISO3Language();
+}
+//# sourceMappingURL=index.android.js.map

package/index.d.ts

@@ -0,0 +1 @@
+export * from './index.android';

package/index.ios.d.ts

@@ -0,0 +1,14 @@
+export declare namespace AppUtilsAndroid {
+    function listenForWindowInsets(onWindowInsetsChange: (result: [number, number, number, number, number]) => void): void;
+    function prepareWindow(window: any): void;
+    function getDimensionFromInt(context: any, intToGet: number): void;
+    function getColorFromInt(context: any, intToGet: number): void;
+    function getColorFromName(context: any, intToGet: number): void;
+    function restartApp(): void;
+    function prepareActivity(activity: any): void;
+    function applyDayNight(activity: any, applyDynamicColors: boolean): void;
+    function applyDynamicColors(activity: any): void;
+}
+export declare function setWorkerContextValue(key: any, value: any): void;
+export declare function getWorkerContextValue(key: any): any;
+export declare function getISO3Language(lang: any): any;

package/index.ios.js

@@ -0,0 +1,31 @@
+export var AppUtilsAndroid;
+(function (AppUtilsAndroid) {
+    function listenForWindowInsets(onWindowInsetsChange) { }
+    AppUtilsAndroid.listenForWindowInsets = listenForWindowInsets;
+    function prepareWindow(window) { }
+    AppUtilsAndroid.prepareWindow = prepareWindow;
+    function getDimensionFromInt(context, intToGet) { }
+    AppUtilsAndroid.getDimensionFromInt = getDimensionFromInt;
+    function getColorFromInt(context, intToGet) { }
+    AppUtilsAndroid.getColorFromInt = getColorFromInt;
+    function getColorFromName(context, intToGet) { }
+    AppUtilsAndroid.getColorFromName = getColorFromName;
+    function restartApp() { }
+    AppUtilsAndroid.restartApp = restartApp;
+    function prepareActivity(activity) { }
+    AppUtilsAndroid.prepareActivity = prepareActivity;
+    function applyDayNight(activity, applyDynamicColors) { }
+    AppUtilsAndroid.applyDayNight = applyDayNight;
+    function applyDynamicColors(activity) { }
+    AppUtilsAndroid.applyDynamicColors = applyDynamicColors;
+})(AppUtilsAndroid || (AppUtilsAndroid = {}));
+export function setWorkerContextValue(key, value) {
+    NWorkerContext.setValue(key, value);
+}
+export function getWorkerContextValue(key) {
+    return NWorkerContext.getValue(key);
+}
+export function getISO3Language(lang) {
+    return NSLocale.alloc().initWithLocaleIdentifier(lang).ISO639_2LanguageCode();
+}
+//# sourceMappingURL=index.ios.js.map

package/package.json

@@ -0,0 +1,67 @@
+{
+    "name": "@akylas/nativescript-app-utils",
+    "version": "1.0.0",
+    "description": "Provides API for changing the styles of SystemUI (StatusBar, NavigationBar...) on iOS.",
+    "main": "index",
+    "sideEffects": false,
+    "typings": "index.d.ts",
+    "scripts": {
+        "tsc": "cpy ../../src/app-utils/index.d.ts ./ && tsc -d",
+        "build": "npm run tsc",
+        "build.watch": "npm run tsc -- -w",
+        "build.win": "npm run tsc-win",
+        "build.all": "npm run build",
+        "build.angular": "ng-packagr -p ../../src/app-utils/angular/ng-package.json -c ../../src/app-utils/angular/tsconfig.json && rm angular/.npmignore",
+        "clean": "rimraf ./*.d.ts ./*.js ./*.js.map"
+    },
+    "nativescript": {
+        "platforms": {
+            "android": "5.0.0",
+            "ios": "5.0.0"
+        }
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/akylas/nativescript-app-utils"
+    },
+    "keywords": [
+        "nativescript",
+        "native",
+        "typescript",
+        "iOS",
+        "statusbar",
+        "status bar",
+        "Vue"
+    ],
+    "contributors": [
+        {
+            "name": "Burke Holland",
+            "email": "burkeholland@gmail.com",
+            "url": "https://github.com/burkeholland"
+        },
+        {
+            "name": "Brad Martin",
+            "email": "bradwaynemartin@gmail.com",
+            "url": "https://github.com/bradmartin"
+        },
+        {
+            "name": "Vladimir Amiorkov",
+            "email": "v.amiorkov@gmail.com",
+            "url": "https://github.com/VladimirAmiorkov"
+        },
+        {
+            "name": "Martin Guillon",
+            "email": "martin.guillon@akylas.fr",
+            "url": "https://github.com/farfromrefug"
+        }
+    ],
+    "license": "MIT",
+    "author": "Burke Holland <burkeholland@gmail.com>",
+    "bugs": {
+        "url": "https://github.com/akylas/nativescript-app-utils/issues"
+    },
+    "gitHead": "209db3a7039c188b6cf65b97ab6384f70b6f9515"
+}

package/platforms/android/include.gradle

@@ -0,0 +1,12 @@
+dependencies {
+    def androidXSplashscreenVersion =  project.hasProperty("androidXSplashscreenVersion") ? project.androidXSplashscreenVersion : "1.1.0-alpha02"
+    def androidxVersion =  project.hasProperty("androidxVersion") ? project.androidxVersion : "1.2.0"
+    def androidXAppCompat =  project.hasProperty("androidXAppCompat") ? project.androidXAppCompat : "1.1.0"
+	def androidXMaterial =  project.hasProperty("androidXMaterial") ? project.androidXMaterial : "1.8.0"
+    
+	implementation "com.google.android.material:material:$androidXMaterial"
+	implementation "androidx.appcompat:appcompat:$androidXAppCompat"
+    implementation "androidx.core:core-splashscreen:$androidXSplashscreenVersion"
+	implementation "androidx.core:core:$androidxVersion"
+
+}

package/platforms/android/java/com/nativescript/apputils/Utils.kt

@@ -0,0 +1,111 @@
+package com.nativescript.apputils
+
+import android.os.Build
+import android.graphics.Rect
+import android.util.TypedValue
+import android.content.Context
+import android.content.Intent
+import android.content.res.Resources
+import android.view.Window
+import android.view.View
+import androidx.core.view.ViewCompat
+import android.view.WindowInsets
+import androidx.core.view.WindowInsetsCompat
+import androidx.appcompat.app.AppCompatActivity
+import androidx.core.os.ConfigurationCompat
+import androidx.core.splashscreen.SplashScreen.Companion.installSplashScreen
+import androidx.core.view.WindowCompat
+import com.google.android.material.color.DynamicColors
+import java.util.Locale
+import android.util.Log
+
+class Utils {
+    interface WindowInsetsCallback {
+        fun onWindowInsetsChange(result: IntArray)
+    }
+    companion object {
+        fun getColorFromName(context: Context, name: String?): Int {
+            val resID = context.resources.getIdentifier(name, "attr", context.packageName)
+            val array = context.theme.obtainStyledAttributes(intArrayOf(resID))
+            return array.getColor(0, 0xFF00FF)
+        }
+
+        fun getColorFromInt(context: Context, resId: Int): Int {
+            val array = context.theme.obtainStyledAttributes(intArrayOf(resId))
+            return array.getColor(0, 0xFF00FF)
+        }
+
+        fun getDimensionFromInt(context: Context, resId: Int): Float {
+            val array = context.theme.obtainStyledAttributes(intArrayOf(resId))
+            return array.getDimension(0, 0f)
+        }
+
+        fun applyDayNight(activity: AppCompatActivity, applyDynamicColors: Boolean) {
+
+            // we need to applyDayNight to update theme thus colors as we dont restart activity (configChanges:uiMode)
+            // but then dynamic colors are lost so let s call DynamicColors.applyIfAvailable
+            activity.getDelegate().applyDayNight()
+            if (applyDynamicColors) {
+                DynamicColors.applyIfAvailable(activity)
+            }
+        }
+
+        fun applyDynamicColors(activity: AppCompatActivity?) {
+            DynamicColors.applyIfAvailable(activity!!)
+        }
+
+        fun restartApp(ctx: Context, activity: AppCompatActivity?) {
+            val pm = ctx.packageManager
+            val intent = pm.getLaunchIntentForPackage(ctx.packageName)
+            val mainIntent = Intent.makeRestartActivityTask(intent!!.component)
+            ctx.startActivity(mainIntent)
+            Runtime.getRuntime().exit(0)
+        }
+
+        val systemLocale: Locale?
+            get() = ConfigurationCompat.getLocales(Resources.getSystem().configuration)[0]
+
+        fun prepareActivity(activity: AppCompatActivity) {
+            DynamicColors.applyToActivityIfAvailable(activity)
+            activity.installSplashScreen()
+            prepareWindow(activity.window)
+        }
+
+        fun prepareWindow(window: Window?) {
+            WindowCompat.setDecorFitsSystemWindows(window!!, false)
+        }
+        fun getRootWindowInsets(view: View): IntArray {
+            val windowInsets = ViewCompat.getRootWindowInsets(view) ?: return intArrayOf(0, 0,0, 0, 0)
+            val inset = windowInsets.getInsets(WindowInsetsCompat.Type.systemBars())
+            val imeVisible = windowInsets.isVisible(WindowInsetsCompat.Type.ime())
+            val imeHeight = if (imeVisible)  windowInsets.getInsets(WindowInsetsCompat.Type.ime()).bottom else 0
+            return intArrayOf(inset.top, inset.bottom, inset.left, inset.right, imeHeight)
+        }
+
+        fun listenForWindowInsetsChange(rootView: View, callback: WindowInsetsCallback) {
+            rootView.setOnApplyWindowInsetsListener{ view, insets -> 
+                val inset = getRootWindowInsets(view)
+                callback.onWindowInsetsChange(inset)
+                return@setOnApplyWindowInsetsListener insets
+            }
+            if (Build.VERSION.SDK_INT  < Build.VERSION_CODES.R) {
+                var alreadyOpen = false
+                val defaultKeyboardHeightDP = 100
+                val estimatedKeyboardDP = defaultKeyboardHeightDP + if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) 48 else 0
+                val rect = Rect()
+                rootView.viewTreeObserver.addOnGlobalLayoutListener {
+                    val estimatedKeyboardHeight = TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, estimatedKeyboardDP.toFloat(), rootView.resources.displayMetrics).toInt()
+                    rootView.getWindowVisibleDisplayFrame(rect)
+                    val heightDiff = rootView.rootView.height - (rect.bottom - rect.top)
+                    val isShown = heightDiff >= estimatedKeyboardHeight
+
+                    if (isShown !== alreadyOpen) {
+                        alreadyOpen = isShown
+                        rootView.requestApplyInsets()
+                    }
+                }
+
+            }
+        }
+    }
+}

package/platforms/android/java/com/nativescript/apputils/WorkersContext.kt

@@ -0,0 +1,20 @@
+package com.nativescript.apputils
+
+import java.util.concurrent.ConcurrentHashMap
+
+class WorkersContext {
+    companion object {
+        private val container: MutableMap<String, Any> = ConcurrentHashMap()
+        fun getValue(key: String): Any? {
+            return container[key]
+        }
+
+        fun setValue(key: String, value: Any?) {
+            if (value != null) {
+                container[key] = value
+            } else {
+                container.remove(key)
+            }
+        }
+    }
+}

package/platforms/android/native-api-usage.json

@@ -0,0 +1,9 @@
+{
+    "uses": [
+        "com.nativescript.apputils:WorkersContext",
+        "com.nativescript.apputils:WorkersContext.Companion",
+        "com.nativescript.apputils:Utils",
+        "com.nativescript.apputils:Utils.WindowInsetsCallback",
+        "com.nativescript.apputils:Utils.Companion"
+    ]
+}