@nativescript/core 8.9.0-alpha.2 → 8.9.0-next-01-13-2025-12739393522

package/utils/index.d.ts

@@ -1,177 +0,0 @@
-export { clearInterval, clearTimeout, setInterval, setTimeout } from '../timer';
-export * from './common';
-export * from './constants';
-export * from './debug';
-export * from './layout-helper';
-export * from './macrotask-scheduler';
-export * from './mainthread-helper';
-export * from './native-helper';
-export * from './types';
-
-export const RESOURCE_PREFIX: string;
-export const FILE_PREFIX: string;
-
-//@private
-/**
- * Used by various android event listener implementations.
- * @private
- */
-interface Owned {
-	owner: any;
-}
-//@endprivate
-
-/**
- * An utility function that invokes garbage collection on the JavaScript side.
- */
-export function GC();
-
-/**
- * An utility function that queues a garbage collection, multiple calls in quick succession are debounced by default and only one gc will be executed after 900ms.
- * @param delay Customize the delay
- * @param useThrottle Instead of default debounce strategy, use throttling
- */
-export function queueGC(delay?: number, useThrottle?: boolean);
-
-/**
- * A simple throttle utility
- * @param fn Function to throttle
- * @param delay Customize the delay (default is 300ms)
- */
-export function throttle<T extends Function = any>(fn: T, delay?: number): T;
-
-/**
- * A simple debounce utility
- * @param fn Function to debounce
- * @param delay Customize the delay (default is 300ms)
- */
-export function debounce<T extends Function = any>(fn: T, delay?: number, options?: { leading?: boolean }): T;
-
-/**
- * Releases the reference to the wrapped native object
- * @param object The Java/Objective-C object to release.
- */
-export function releaseNativeObject(object: any /*java.lang.Object | NSObject*/);
-
-/**
- * Queues the passed function to be ran in a macroTask
- * @param task the function to execute as a macroTask
- */
-export function queueMacrotask(task: () => void): void;
-
-/**
- * Checks if the current thread is the main thread. Directly calls the passed function
- * if it is, or dispatches it to the main thread otherwise.
- * @param func The function to execute on the main thread.
- */
-export function executeOnMainThread(func: Function);
-
-/**
- * Runs the passed function on the UI Thread.
- * @param func The function to execute on the UI thread.
- */
-export function executeOnUIThread(func: Function);
-
-/**
- * Returns a function wrapper which executes the supplied function on the main thread.
- * The wrapper behaves like the original function and passes all of its arguments BUT
- * discards its return value.
- * @param func The function to execute on the main thread
- * @returns The wrapper function which schedules execution to the main thread
- */
-export function mainThreadify(func: Function): (...args: any[]) => void;
-
-/**
- * Returns true if the specified URI is a font icon URI like "fontIcon://&#xf1e0".
- * @param uri The URI.
- */
-export function isFontIconURI(uri: string): boolean;
-
-/**
- * Returns true if the specified path points to a resource or local file.
- * @param path The path.
- */
-export function isFileOrResourcePath(path: string): boolean;
-
-/**
- * Get file extension from file path
- * @param path file path
- * @returns file extension
- */
-export function getFileExtension(path: string): string;
-
-/**
- * Returns true if the specified URI is data URI (http://en.wikipedia.org/wiki/Data_URI_scheme).
- * @param uri The URI.
- */
-export function isDataURI(uri: string): boolean;
-
-/**
- * Opens url.
- * @param url The url.
- */
-export function openUrl(url: string): boolean;
-
-/**
- * Opens file.
- * @param filePath The file.
- * @param title Optional title for Android. Default is: 'Open File...'
- */
-export function openFile(filePath: string, title?: string): boolean;
-
-/**
- * Escapes special regex symbols (., *, ^, $ and so on) in string in order to create a valid regex from it.
- * @param source The original value.
- */
-export function escapeRegexSymbols(source: string): string;
-
-/**
- * Converts string value to number or boolean.
- * @param value The original value.
- */
-export function convertString(value: any): any;
-
-/**
- * Gets module name from path.
- * @param path The module path.
- */
-export function getModuleName(path: string): string;
-
-/**
- * Sorts an array by using merge sort algorithm (which ensures stable sort since the built-in Array.sort() does not promise a stable sort).
- * @param arr - array to be sorted
- * @param compareFunc - function that will be used to compare two elements of the array
- */
-export function mergeSort(arr: Array<any>, compareFunc: (a: any, b: any) => number): Array<any>;
-
-/**
- * Checks if array has any duplicate elements.
- * @param arr - The array to be checked.
- */
-export function hasDuplicates(arr: Array<any>): boolean;
-
-/**
- * Removes duplicate elements from array.
- * @param arr - The array.
- */
-export function eliminateDuplicates(arr: Array<any>): Array<any>;
-
-/**
- * Checks whether the application is running on real device and not on simulator/emulator.
- */
-export function isRealDevice(): boolean;
-
-/**
- * Hides the soft input method, usually a soft keyboard.
- */
-export function dismissSoftInput(nativeView?: any): void;
-
-/**
- * Dismiss any keyboard visible on the screen.
- */
-export function dismissKeyboard(): void;
-
-/**
- * Copy value to device clipboard.
- */
-export function copyToClipboard(value: string): void;

package/utils/layout-helper/index.d.ts

@@ -1,82 +0,0 @@
-import { CoreTypes } from '../../core-types';
-
-/**
- * Utility module related to layout.
- */
-export namespace layout {
-	/**
-	 * Bits that provide the actual measured size.
-	 */
-	export const MEASURED_HEIGHT_STATE_SHIFT: number;
-	export const MEASURED_SIZE_MASK: number;
-	export const MEASURED_STATE_MASK: number;
-	export const MEASURED_STATE_TOO_SMALL: number;
-	export const UNSPECIFIED: number;
-	export const EXACTLY: number;
-	export const AT_MOST: number;
-
-	/**
-	 * Gets layout mode from a given specification as string.
-	 * @param mode - The measure specification mode.
-	 */
-	export function getMode(mode: number): string;
-
-	/**
-	 * Gets measure specification mode from a given specification.
-	 * @param spec - The measure specification.
-	 */
-	export function getMeasureSpecMode(spec: number): number;
-
-	/**
-	 * Gets measure specification size from a given specification.
-	 * @param spec - The measure specification.
-	 */
-	export function getMeasureSpecSize(spec: number): number;
-
-	/**
-	 * Creates measure specification size from size and mode.
-	 * @param size - The size component of measure specification.
-	 * @param mode - The mode component of measure specification.
-	 */
-	export function makeMeasureSpec(px: number, mode: number): number;
-
-	/**
-	 * Gets display density for the current device.
-	 */
-	export function getDisplayDensity(): number;
-
-	/**
-	 * Convert device independent pixels to device pixels - dip to px.
-	 * @param value - The pixel to convert.
-	 */
-	export function toDevicePixels(value: CoreTypes.dip): CoreTypes.px;
-
-	/**
-	 * Convert device pixels to device independent pixels - px to dip.
-	 * @param value - The pixel to convert.
-	 */
-	export function toDeviceIndependentPixels(value: CoreTypes.px): CoreTypes.dip;
-
-	/**
-	 * Rounds value used in layout.
-	 * @param px to round.
-	 */
-	export function round(px: CoreTypes.px): CoreTypes.px;
-
-	/**
-	 * Converts device pixels to device independent pixes and measure the nativeView.
-	 * Returns the desired size of the nativeView in device pixels.
-	 * @param nativeView the nativeView to measure (UIView or android.view.View)
-	 * @param width the available width
-	 * @param widthMode width mode - UNSPECIFIED, EXACTLY or AT_MOST
-	 * @param height the available hegiht
-	 * @param heightMode height mode - UNSPECIFIED, EXACTLY or AT_MOST
-	 */
-	export function measureNativeView(nativeView: any /* UIView or android.view.View */, width: number, widthMode: number, height: number, heightMode: number): { width: number; height: number };
-
-	/**
-	 * Prints user friendly version of the measureSpec.
-	 * @param measureSpec the spec to print
-	 */
-	export function measureSpecToString(measureSpec: number): string;
-}

package/utils/mainthread-helper.d.ts

@@ -1,16 +0,0 @@
-/**
- * Dispatches the passed function for execution on the main thread
- * @param func The function to execute on the main thread.
- */
-export function dispatchToMainThread(func: Function);
-
-/**
- * @returns Boolean value indicating whether the current thread is the main thread
- */
-export function isMainThread(): boolean;
-
-/**
- * Dispatches the passed function for execution on the UI thread
- * @param func The function to execute on the UI thread.
- */
-export function dispatchToUIThread(func: Function);

package/utils/native-helper.d.ts

@@ -1,280 +0,0 @@
-/**
- * Data serialization from JS > Native
- * @param wrapPrimitives Optionally wrap primitive types (Some APIs may require this)
- */
-export function dataSerialize(data?: any, wrapPrimitives?: boolean): any;
-/**
- * Data deserialization from Native > JS
- * @param nativeData Native platform data
- */
-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;
-
-// 	/**
-// 	 * 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 });
-// }
-
-import * as AndroidUtils from './android';
-export import android = AndroidUtils;
-
-/**
- * @deprecated use Utils.android instead.
- */
-export import ad = AndroidUtils;
-
-import * as iOSUtils from './ios';
-export import ios = iOSUtils;
-
-/**
- * @deprecated use Utils.ios instead.
- */
-export import iOSNativeHelper = iOSUtils;

package/utils/typescript-utils.d.ts

@@ -1,6 +0,0 @@
-/**
- * Makes the specified properties in a type optional.
- * @example type NotifyData = Optional<EventData, "object">
- * // returns: { eventName: string; object?: Observable }
- */
-export type Optional<T, K extends keyof T> = Omit<T, K> & { [P in K]?: T[P] };