@nativescript/core 9.0.0-next-09-09-2025-17590373424 → 9.0.0-next-09-19-2025-17844486041

package/utils/native-helper.d.ts

@@ -9,272 +9,220 @@ export function dataSerialize(data?: any, wrapPrimitives?: boolean): any;
  */
 export function dataDeserialize(nativeData?: any): any;
 
-// /**
-//  * Module with android specific utilities.
-//  */
-// declare namespace AndroidUtils {
-// 	/**
-// 	 * Gets the native Android application instance.
-// 	 */
-// 	export function getApplication(): any; /* android.app.Application */
-
-// 	/**
-// 	 * Get the current native Android activity.
-// 	 */
-// 	export function getCurrentActivity(): any; /* android.app.Activity */
-// 	/**
-// 	 * Gets the native Android application resources.
-// 	 */
-// 	export function getResources(): any; /* android.content.res.Resources */
-
-// 	/**
-// 	 * Gets the Android application context.
-// 	 */
-// 	export function getApplicationContext(): any; /* android.content.Context */
-
-// 	/**
-// 	 * Gets the native Android input method manager.
-// 	 */
-// 	export function getInputMethodManager(): any; /* android.view.inputmethod.InputMethodManager */
-
-// 	/**
-// 	 * Hides the soft input method, usually a soft keyboard.
-// 	 */
-// 	export function dismissSoftInput(nativeView?: any /* android.view.View */): void;
-
-// 	/**
-// 	 * Shows the soft input method, usually a soft keyboard.
-// 	 */
-// 	export function showSoftInput(nativeView: any /* android.view.View */): void;
-
-// 	/**
-// 	 * Utility module dealing with some android collections.
-// 	 */
-// 	namespace collections {
-// 		/**
-// 		 * Converts string array into a String [hash set](http://developer.android.com/reference/java/util/HashSet.html).
-// 		 * @param str - An array of strings to convert.
-// 		 */
-// 		export function stringArrayToStringSet(str: string[]): any;
-
-// 		/**
-// 		 * Converts string hash set into array of strings.
-// 		 * @param stringSet - A string hash set to convert.
-// 		 */
-// 		export function stringSetToStringArray(stringSet: any): string[];
-// 	}
-
-// 	/**
-// 	 * Utility module related to android resources.
-// 	 */
-// 	export namespace resources {
-// 		/**
-// 		 * Gets the drawable id from a given name.
-// 		 * @param name - Name of the resource.
-// 		 */
-// 		export function getDrawableId(name);
-
-// 		/**
-// 		 * Gets the string id from a given name.
-// 		 * @param name - Name of the resource.
-// 		 */
-// 		export function getStringId(name);
-
-// 		/**
-// 		 * Gets the id from a given name.
-// 		 * @param name - Name of the resource.
-// 		 */
-// 		export function getId(name: string): number;
-
-// 		/**
-// 		 * Gets the id from a given name with optional type.
-// 		 * This sets an explicit package name.
-// 		 * https://developer.android.com/reference/android/content/res/Resources#getIdentifier(java.lang.String,%20java.lang.String,%20java.lang.String)
-// 		 * @param name - Name of the resource.
-// 		 * @param type - (Optional) type
-// 		 */
-// 		export function getResource(name: string, type?: string): number;
-
-// 		/**
-// 		 * [Obsolete - please use getPaletteColor] Gets a color from current theme.
-// 		 * @param name - Name of the color
-// 		 */
-// 		export function getPalleteColor();
-
-// 		/**
-// 		 * Gets a color from the current theme.
-// 		 * @param name - Name of the color resource.
-// 		 */
-// 		export function getPaletteColor(name: string, context: any /* android.content.Context */): number;
-// 	}
-
-// 	/**
-// 	 * Checks whether the application is running on real device and not on emulator.
-// 	 */
-// 	export function isRealDevice(): boolean;
-// }
-
-// /**
-//  * Module with ios specific utilities.
-//  */
-// declare namespace iOSUtils {
-// 	// Common properties between UILabel, UITextView and UITextField
-// 	export interface TextUIView {
-// 		font: any;
-// 		textAlignment: number;
-// 		textColor: any;
-// 		text: string;
-// 		attributedText: any;
-// 		lineBreakMode: number;
-// 		numberOfLines: number;
-// 	}
-
-// 	/**
-// 	 * Utility module dealing with some iOS collections.
-// 	 */
-// 	export namespace collections {
-// 		/**
-// 		 * Converts JavaScript array to [NSArray](https://developer.apple.com/library/ios/documentation/Cocoa/Reference/Foundation/Classes/NSArray_Class/).
-// 		 * @param str - JavaScript string array to convert.
-// 		 */
-// 		export function jsArrayToNSArray<T>(str: T[]): NSArray<T>;
-
-// 		/**
-// 		 * Converts NSArray to JavaScript array.
-// 		 * @param a - NSArray to convert.
-// 		 */
-// 		export function nsArrayToJSArray<T>(a: NSArray<T>): T[];
-// 	}
-
-// 	/**
-// 	 * Get the root UIViewController of the app
-// 	 */
-// 	export function getRootViewController(): any; /* UIViewController */
-
-// 	/**
-// 	 * Get the UIWindow of the app
-// 	 */
-// 	export function getWindow(): any; /* UIWindow */
-
-// 	/**
-// 	 * Set the window background color of base view of the app.
-// 	 * Often this is shown when opening a modal as the view underneath scales down revealing the window color.
-// 	 * @param value color (hex, rgb, rgba, etc.)
-// 	 */
-// 	export function setWindowBackgroundColor(value: string): void;
-
-// 	/**
-// 	 * Data serialize and deserialize helpers
-// 	 */
-// 	export function dataSerialize(data?: any): any;
-// 	export function dataDeserialize(nativeData?: any): any;
-
-// 	/**
-// 	 * @deprecated use application.orientation instead
-// 	 *
-// 	 * Gets an information about if current mode is Landscape.
-// 	 */
-// 	export function isLandscape(): boolean;
-
-// 	/**
-// 	 * Gets the iOS device major version (for 8.1 will return 8).
-// 	 */
-// 	export const MajorVersion: number;
-
-// 	/**
-// 	 * Opens file with associated application.
-// 	 * @param filePath The file path.
-// 	 */
-// 	export function openFile(filePath: string): boolean;
-
-// 	/**
-// 	 * Joins an array of file paths.
-// 	 * @param paths An array of paths.
-// 	 * Returns the joined path.
-// 	 */
-// 	export function joinPaths(...paths: string[]): string;
-
-// 	/**
-// 	 * Gets the root folder for the current application. This Folder is private for the application and not accessible from Users/External apps.
-// 	 * iOS - this folder is read-only and contains the app and all its resources.
-// 	 */
-// 	export function getCurrentAppPath(): string;
-
-// 	/**
-// 	 * Gets the currently visible(topmost) UIViewController.
-// 	 * @param rootViewController The root UIViewController instance to start searching from (normally window.rootViewController).
-// 	 * Returns the visible UIViewController.
-// 	 */
-// 	export function getVisibleViewController(rootViewController: any /* UIViewController*/): any; /* UIViewController*/
-
-// 	/**
-// 	 *
-// 	 * @param transform Applies a rotation transform over X,Y and Z axis
-// 	 * @param x Rotation over X axis in degrees
-// 	 * @param y Rotation over Y axis in degrees
-// 	 * @param z Rotation over Z axis in degrees
-// 	 */
-// 	export function applyRotateTransform(transform: any /* CATransform3D*/, x: number, y: number, z: number): any; /* CATransform3D*/
-
-// 	/**
-// 	 * Create a UIDocumentInteractionControllerDelegate implementation for use with UIDocumentInteractionController
-// 	 */
-// 	export function createUIDocumentInteractionControllerDelegate(): any;
-
-// 	/**
-// 	 * Checks whether the application is running on real device and not on simulator.
-// 	 */
-// 	export function isRealDevice(): boolean;
-
-// 	/**
-// 	 * Debug utility to insert CGRect values into logging output.
-// 	 * Note: when printing a CGRect directly it will print blank so this helps show the values.
-// 	 * @param rect CGRect
-// 	 */
-// 	export function printCGRect(rect: CGRect): void;
-
-// 	/**
-// 	 * Take a snapshot of a View on screen.
-// 	 * @param view view to snapshot
-// 	 * @param scale screen scale
-// 	 */
-// 	export function snapshotView(view: UIView, scale: number): UIImage;
-
-// 	/**
-// 	 * Copy layer properties from one view to another.
-// 	 * @param view a view to copy layer properties to
-// 	 * @param toView a view to copy later properties from
-// 	 * @param (optional) custom properties to copy between both views
-// 	 */
-// 	export function copyLayerProperties(view: UIView, toView: UIView, customProperties?: { view?: Array<string> /* Array<keyof UIView> */; layer?: Array<string> /* Array<keyof CALayer> */ }): void;
+/**
+ * Checks whether the application is running on real device and not on emulator.
+ */
+export function isRealDevice(): boolean;
 
-// 	/**
-// 	 * Animate views with a configurable spring effect
-// 	 * @param options various animation settings for the spring
-// 	 * - tension: number
-// 	 * - friction: number
-// 	 * - mass: number
-// 	 * - delay: number
-// 	 * - velocity: number
-// 	 * - animateOptions: UIViewAnimationOptions
-// 	 * - animations: () => void, Callback containing the property changes you want animated
-// 	 * - completion: (finished: boolean) => void, Callback when animation is finished
-// 	 */
-// 	export function animateWithSpring(options?: { tension?: number; friction?: number; mass?: number; delay?: number; velocity?: number; animateOptions?: UIViewAnimationOptions; animations?: () => void; completion?: (finished?: boolean) => void });
-// }
+type NativeWindow = android.view.Window | UIWindow;
+/**
+ * Get the UIWindow or android.view.Window of the app
+ */
+export function getWindow<T extends NativeWindow>(): T;
 
-import * as AndroidUtils from './android';
-export import android = AndroidUtils;
+/**
+ * Utilities related to Android.
+ */
+export const android: {
+	/**
+	 * Utilities related to Android resources.
+	 */
+	resources: {
+		/**
+		 * Gets the drawable id from a given name.
+		 * @param name - Name of the resource.
+		 */
+		getDrawableId: (name) => number;
+		/**
+		 * Gets the string id from a given name.
+		 * @param name - Name of the resource.
+		 */
+		getStringId: (name) => number;
+		/**
+		 * Gets the id from a given name.
+		 * @param name - Name of the resource.
+		 */
+		getId: (name: string) => number;
+		/**
+		 * Gets the id from a given name with optional type.
+		 * This sets an explicit package name.
+		 * https://developer.android.com/reference/android/content/res/Resources#getIdentifier(java.lang.String,%20java.lang.String,%20java.lang.String)
+		 * @param name - Name of the resource.
+		 * @param type - (Optional) type
+		 */
+		getResource: (name: string, type?: string) => number;
+		/**
+		 * Gets a color from the current theme.
+		 * @param name - Name of the color resource.
+		 * @param context - Context to resolve the color.
+		 */
+		getPaletteColor: (name: string, context: android.content.Context) => number;
+	};
+	/**
+	 * Utilities related to Android collections.
+	 */
+	collections: {
+		/**
+		 * Converts string array into a String [hash set](http://developer.android.com/reference/java/util/HashSet.html).
+		 * @param str - An array of strings to convert.
+		 */
+		stringArrayToStringSet(str: string[]): java.util.HashSet<string>;
+		/**
+		 * Converts string hash set into array of strings.
+		 * @param stringSet - A string hash set to convert.
+		 */
+		stringSetToStringArray(stringSet: any): string[];
+	};
+	/**
+	 * @deprecated Use `Utils.getWindow<android.view.Window>()` instead.
+	 * @returns application window.
+	 */
+	getWindow: () => android.view.Window;
+	/**
+	 * Gets the native Android application instance.
+	 */
+	getApplication: () => android.app.Application;
+	/**
+	 * Get the current native Android activity.
+	 */
+	getCurrentActivity: () => androidx.appcompat.app.AppCompatActivity | android.app.Activity | null;
+	/**
+	 * Gets the Android application context.
+	 */
+	getApplicationContext: () => android.content.Context;
+	/**
+	 * Gets the native Android application resources.
+	 */
+	getResources: () => android.content.res.Resources;
+	getPackageName: () => string;
+	/**
+	 * Gets the native Android input method manager.
+	 */
+	getInputMethodManager: () => android.view.inputmethod.InputMethodManager;
+	/**
+	 * Shows the soft input method, usually a soft keyboard.
+	 */
+	showSoftInput: (nativeView: android.view.View) => void;
+	/**
+	 * Hides the soft input method, usually a soft keyboard.
+	 */
+	dismissSoftInput: (nativeView?: android.view.View) => void;
+};
 
 /**
  * @deprecated use Utils.android instead.
  */
-export import ad = AndroidUtils;
+export const ad = android;
 
-import * as iOSUtils from './ios';
-export import ios = iOSUtils;
+/**
+ * Utilities related to iOS.
+ */
+export const ios: {
+	/**
+	 * Utilities related to iOS collections.
+	 */
+	collections: {
+		/**
+		 * Converts JavaScript array to [NSArray](https://developer.apple.com/library/ios/documentation/Cocoa/Reference/Foundation/Classes/NSArray_Class/).
+		 * @param str - JavaScript string array to convert.
+		 */
+		jsArrayToNSArray<T>(str: T[]): NSArray<T>;
+		/**
+		 * Converts NSArray to JavaScript array.
+		 * @param a - NSArray to convert.
+		 */
+		nsArrayToJSArray<T>(a: NSArray<T>): Array<T>;
+	};
+	/**
+	 * Create a UIDocumentInteractionControllerDelegate implementation for use with UIDocumentInteractionController
+	 */
+	createUIDocumentInteractionControllerDelegate: () => NSObject;
+	/**
+	 * @deprecated Use `Utils.getWindow<UIWindow>()` instead.
+	 * @returns application window.
+	 */
+	getWindow: () => UIWindow;
+	/**
+	 * Gets the root folder for the current application. This Folder is private for the application and not accessible from Users/External apps.
+	 * iOS - this folder is read-only and contains the app and all its resources.
+	 */
+	getCurrentAppPath: () => string;
+	/**
+	 * Get the root UIViewController of the app
+	 */
+	getRootViewController: () => UIViewController;
+	/**
+	 * Gets the currently visible(topmost) UIViewController.
+	 * @param rootViewController The root UIViewController instance to start searching from (normally window.rootViewController).
+	 * Returns the visible UIViewController.
+	 */
+	getVisibleViewController: (rootViewController: UIViewController) => UIViewController;
+	getMainScreen: () => UIScreen;
+	/**
+	 * Set the window background color of base view of the app.
+	 * Often this is the view shown behind opening a modal, eg: a modal scales down revealing the window color.
+	 * @param value color (hex, rgb, rgba, etc.)
+	 */
+	setWindowBackgroundColor: (value: string) => void;
+	/**
+	 * @deprecated use Application.orientation instead
+	 *
+	 * Gets an information about if current mode is Landscape.
+	 */
+	isLandscape: () => boolean;
+	/**
+	 * Take a snapshot of a View on screen.
+	 * @param view view to snapshot
+	 * @param scale screen scale
+	 */
+	snapshotView: (view: UIView, scale: number) => UIImage;
+	/**
+	 * Applies a rotation transform over X,Y and Z axis
+	 * @param transform Applies a rotation transform over X,Y and Z axis
+	 * @param x Rotation over X axis in degrees
+	 * @param y Rotation over Y axis in degrees
+	 * @param z Rotation over Z axis in degrees
+	 */
+	applyRotateTransform: (transform: CATransform3D, x: number, y: number, z: number) => CATransform3D;
+	/**
+	 * Debug utility to insert CGRect values into logging output.
+	 * Note: when printing a CGRect directly it will print blank so this helps show the values.
+	 * @param rect CGRect
+	 */
+	printCGRect: (rect: CGRect) => void;
+	/**
+	 * Copy layer properties from one view to another.
+	 * @param view a view to copy layer properties to
+	 * @param toView a view to copy later properties from
+	 * @param (optional) custom properties to copy between both views
+	 */
+	copyLayerProperties: (view: UIView, toView: UIView, customProperties?: { view?: Array<keyof UIView>; layer?: Array<keyof CALayer> }) => void;
+	/**
+	 * Animate views with a configurable spring effect
+	 * @param options various animation settings for the spring
+	 * - tension: number
+	 * - friction: number
+	 * - mass: number
+	 * - delay: number
+	 * - velocity: number
+	 * - animateOptions: UIViewAnimationOptions
+	 * - animations: () => void, Callback containing the property changes you want animated
+	 * - completion: (finished: boolean) => void, Callback when animation is finished
+	 */
+	animateWithSpring: (options?: { tension?: number; friction?: number; mass?: number; delay?: number; velocity?: number; animateOptions?: UIViewAnimationOptions; animations?: () => void; completion?: (finished?: boolean) => void }) => void;
+	/**
+	 * Joins an array of file paths.
+	 * @param paths An array of paths.
+	 * Returns the joined path.
+	 */
+	joinPaths: (...paths: string[]) => string;
+	/**
+	 * @deprecated use Utils.SDK_VERSION instead which is a float of the {major}.{minor} verison
+	 */
+	MajorVersion: number;
+};
 
 /**
  * @deprecated use Utils.ios instead.
  */
-export import iOSNativeHelper = iOSUtils;
+export const iOSNativeHelper = ios;

package/utils/native-helper.ios.d.ts

@@ -1,10 +1,79 @@
-import * as iOSUtils from './ios';
 export declare function dataDeserialize(nativeData?: any): any;
 export declare function dataSerialize(data: any, wrapPrimitives?: boolean): any;
+declare function getCurrentAppPath(): string;
+declare function joinPaths(...paths: string[]): string;
+export declare function getter<T>(_this: any, property: T | {
+    (): T;
+}): T;
+declare namespace collections {
+    function jsArrayToNSArray<T>(str: T[]): NSArray<T>;
+    function nsArrayToJSArray<T>(a: NSArray<T>): Array<T>;
+}
+declare function getRootViewController(): UIViewController;
+export declare function getWindow(): UIWindow;
+declare function getMainScreen(): UIScreen;
+declare function setWindowBackgroundColor(value: string): void;
+declare function isLandscape(): boolean;
+export declare function openFile(filePath: string): boolean;
+declare function getVisibleViewController(rootViewController: UIViewController): UIViewController;
+declare function applyRotateTransform(transform: CATransform3D, x: number, y: number, z: number): CATransform3D;
+declare function createUIDocumentInteractionControllerDelegate(): NSObject;
+export declare function isRealDevice(): boolean;
+declare function printCGRect(rect: CGRect): string;
+declare function snapshotView(view: UIView, scale: number): UIImage;
+declare function copyLayerProperties(view: UIView, toView: UIView, customProperties?: {
+    view?: Array<keyof UIView>;
+    layer?: Array<keyof CALayer>;
+}): void;
+declare function animateWithSpring(options?: {
+    tension?: number;
+    friction?: number;
+    mass?: number;
+    delay?: number;
+    velocity?: number;
+    animateOptions?: UIViewAnimationOptions;
+    animations?: () => void;
+    completion?: (finished?: boolean) => void;
+}): void;
 export declare const ad: {};
 export declare const android: {};
-export import ios = iOSUtils;
+export declare const ios: {
+    collections: typeof collections;
+    createUIDocumentInteractionControllerDelegate: typeof createUIDocumentInteractionControllerDelegate;
+    getCurrentAppPath: typeof getCurrentAppPath;
+    getRootViewController: typeof getRootViewController;
+    getVisibleViewController: typeof getVisibleViewController;
+    getWindow: typeof getWindow;
+    getMainScreen: typeof getMainScreen;
+    setWindowBackgroundColor: typeof setWindowBackgroundColor;
+    isLandscape: typeof isLandscape;
+    applyRotateTransform: typeof applyRotateTransform;
+    snapshotView: typeof snapshotView;
+    joinPaths: typeof joinPaths;
+    printCGRect: typeof printCGRect;
+    copyLayerProperties: typeof copyLayerProperties;
+    animateWithSpring: typeof animateWithSpring;
+    MajorVersion: number;
+};
 /**
  * @deprecated Use `Utils.ios` instead.
  */
-export import iOSNativeHelper = iOSUtils;
+export declare const iOSNativeHelper: {
+    collections: typeof collections;
+    createUIDocumentInteractionControllerDelegate: typeof createUIDocumentInteractionControllerDelegate;
+    getCurrentAppPath: typeof getCurrentAppPath;
+    getRootViewController: typeof getRootViewController;
+    getVisibleViewController: typeof getVisibleViewController;
+    getWindow: typeof getWindow;
+    getMainScreen: typeof getMainScreen;
+    setWindowBackgroundColor: typeof setWindowBackgroundColor;
+    isLandscape: typeof isLandscape;
+    applyRotateTransform: typeof applyRotateTransform;
+    snapshotView: typeof snapshotView;
+    joinPaths: typeof joinPaths;
+    printCGRect: typeof printCGRect;
+    copyLayerProperties: typeof copyLayerProperties;
+    animateWithSpring: typeof animateWithSpring;
+    MajorVersion: number;
+};
+export {};