@nativescript/core 8.9.0-next-01-14-2025-12761272657 → 8.9.0-next-01-18-2025-12839190246

package/ui/transition/flip-transition.d.ts

@@ -0,0 +1,5 @@
+import { Transition } from '.';
+
+export class FlipTransition extends Transition {
+	constructor(direction: string, duration: number, curve: any);
+}

package/ui/transition/index.d.ts

@@ -0,0 +1,59 @@
+import type { View } from '../core/view';
+import type { BackstackEntry } from '../frame';
+export type SharedTransitionTagPropertiesToMatch = {
+	/**
+	 * View related properties
+	 */
+	view?: Array<string>;
+	/**
+	 * For iOS, can be specific if CALayer related properties
+	 */
+	layer?: Array<string>;
+};
+export type SharedElementSettings = { view: View; startFrame: any; endFrame?: any; startOpacity?: number; endOpacity?: number; scale?: { x?: number; y?: number }; zIndex?: number; startTransform?: any; snapshot?: any; propertiesToMatch?: SharedTransitionTagPropertiesToMatch };
+export type TransitionNavigationType = 'page' | 'modal';
+export interface TransitionInteractiveState {
+	started?: false;
+	added?: boolean;
+	transitionContext?: any;
+	propertyAnimator?: any;
+}
+
+export declare class Transition {
+	id: number;
+	/**
+	 * (Optional) Provide a unique name to identify this transition
+	 */
+	name?: string;
+	transitionController?: any;
+	interactiveController?: any;
+	presented?: any;
+	presenting?: any;
+	sharedElements?: {
+		presented?: Array<SharedElementSettings>;
+		presenting?: Array<SharedElementSettings>;
+		// independent sharedTransitionTags which are part of the shared transition but only on one page
+		independent?: Array<SharedElementSettings & { isPresented?: boolean }>;
+	};
+	static AndroidTransitionType?: { enter?: string; exit?: string; popEnter?: string; popExit?: string };
+	constructor(duration?: number, nativeCurve?: any /* UIViewAnimationCurve | string | CubicBezierAnimationCurve | android.view.animation.Interpolator | android.view.animation.LinearInterpolator */);
+	getDuration(): number;
+	setDuration(value: number): void;
+	getCurve(): any;
+	animateIOSTransition(transitionContext: any /*UIViewControllerContextTransitioning */, fromViewCtrl: any /* UIViewController */, toViewCtrl: any /* UIViewController */, operation: any /* UINavigationControllerOperation */): void;
+	createAndroidAnimator(transitionType: string): any;
+
+	setupInteractiveGesture?(startCallback: () => void, view: View): void;
+
+	iosDismissedController?(dismissed: any /* UIViewController */): any /* UIViewControllerAnimatedTransitioning */;
+
+	iosPresentedController?(presented: any /* UIViewController */, presenting: any /* UIViewController */, source: any /* UIViewController */): any /* UIViewControllerAnimatedTransitioning */;
+
+	iosInteractionDismiss?(animator: any /* UIViewControllerAnimatedTransitioning */): any /* UIViewControllerInteractiveTransitioning */;
+
+	iosInteractionPresented?(animator: any /* UIViewControllerAnimatedTransitioning */): any /* UIViewControllerInteractiveTransitioning */;
+
+	iosNavigatedController?(navigationController: any /* UINavigationController */, operation: number, fromVC: any /* UIViewController */, toVC: any /* UIViewController */): any /* UIViewControllerAnimatedTransitioning */;
+
+	androidFragmentTransactionCallback?(fragmentTransaction: any /* androidx.fragment.app.FragmentTransaction */, currentEntry: BackstackEntry, newEntry: BackstackEntry): void;
+}

package/ui/transition/modal-transition.d.ts

@@ -0,0 +1,2 @@
+import { Transition } from '.';
+export declare class ModalTransition extends Transition {}

package/ui/transition/page-transition.d.ts

@@ -0,0 +1,4 @@
+import { Transition } from '.';
+export declare class PageTransition extends Transition {
+	constructor(duration?: number, nativeCurve?: any /* UIViewAnimationCurve | string | CubicBezierAnimationCurve | android.view.animation.Interpolator | android.view.animation.LinearInterpolator */, pageLoadedTimeout?: number);
+}

package/ui/transition/shared-transition-helper.d.ts

@@ -0,0 +1,14 @@
+import type { TransitionInteractiveState, TransitionNavigationType } from '.';
+import type { SharedTransitionState } from './shared-transition';
+
+/**
+ * Platform helper to aid in creating your own custom Shared Element Transition classes.
+ * (iOS Only)
+ */
+export declare class SharedTransitionHelper {
+	static animate(state: SharedTransitionState, transitionContext: any /* iOS: UIViewControllerContextTransitioning */, type: TransitionNavigationType): void;
+	static interactiveStart(state: SharedTransitionState, interactiveState: TransitionInteractiveState, type: TransitionNavigationType): void;
+	static interactiveUpdate(state: SharedTransitionState, interactiveState: TransitionInteractiveState, type: TransitionNavigationType, percent: number): void;
+	static interactiveCancel(state: SharedTransitionState, interactiveState: TransitionInteractiveState, type: TransitionNavigationType): void;
+	static interactiveFinish(state: SharedTransitionState, interactiveState: TransitionInteractiveState, type: TransitionNavigationType): void;
+}

package/ui/transition/slide-transition.d.ts

@@ -0,0 +1,5 @@
+import { Transition } from '.';
+
+export class SlideTransition extends Transition {
+	constructor(direction: string, duration?: number, nativeCurve?: any);
+}

package/ui/utils.d.ts

@@ -0,0 +1,44 @@
+export interface NativeScriptAndroidView extends android.view.View {
+	_cachedDrawable: android.graphics.drawable.Drawable;
+}
+
+export interface NativeScriptUIView extends UIView {
+	hasNonUniformBorder: boolean;
+	hasNonUniformBorderColor: boolean;
+	borderLayer: CAShapeLayer;
+
+	maskType: ios.LayerMaskType;
+	originalMask: CALayer;
+
+	gradientLayer: CAGradientLayer;
+	outerShadowContainerLayer: CALayer;
+}
+
+export namespace ios {
+	export type LayerMaskType = 'BORDER' | 'CLIP_PATH';
+	export namespace LayerMask {
+		export const BORDER = 'BORDER';
+		export const CLIP_PATH = 'CLIP_PATH';
+	}
+
+	/**
+	 * Gets actual height of a [UIView](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIView_Class/) widget in device pixels.
+	 * @param uiView - An instance of UIView.
+	 */
+	export function getActualHeight(uiView: any /* UIView */): number;
+
+	/**
+	 * Gets the height of the status bar in device pixels.
+	 * @param viewController when specified it is used to check preferStatusBarHidden property.
+	 */
+	export function getStatusBarHeight(viewController?: any): number;
+
+	/**
+	 * Draw gradient using CAGradientLayer and insert into UIView sublayer
+	 * @param nativeView NativeScriptUIView
+	 * @param gradientLayer CAGradientLayer
+	 * @param gradient Parsed LinearGradient
+	 * @param gradientLayerOpacity Initial layer opacity (in case you'd like to use with animation sequence)
+	 */
+	export function drawGradient(uiView: any /* UIView */, gradientLayer: CAGradientLayer, gradient: LinearGradient, gradientLayerOpacity?: number): void;
+}

package/ui/web-view/index.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Contains the WebView class, which represents a standard browser widget.
+ */
+
+import { View } from '../core/view';
+import { Property } from '../core/properties';
+import { EventData } from '../../data/observable';
+
+/**
+ * Represents the observable property backing the Url property of each WebView instance.
+ */
+export const urlProperty: Property<WebView, string>;
+
+/**
+ * Represents navigation type
+ */
+export type WebViewNavigationType = 'linkClicked' | 'formSubmitted' | 'backForward' | 'reload' | 'formResubmitted' | 'other' | undefined;
+
+/**
+ * Represents a standard WebView widget.
+ *
+ * @nsView
+ */
+export class WebView extends View {
+	/**
+	 * String value used when hooking to loadStarted event.
+	 *
+	 * @nsEvent {LoadEventData} loadStarted
+	 */
+	public static loadStartedEvent: string;
+
+	/**
+	 * String value used when hooking to loadFinished event.
+	 *
+	 * @nsEvent {LoadEventData} loadFinished
+	 */
+	public static loadFinishedEvent: string;
+
+	/**
+	 * Gets the native [android widget](http://developer.android.com/reference/android/webkit/WebView.html) that represents the user interface for this component. Valid only when running on Android OS.
+	 */
+	android: any /* android.webkit.WebView */;
+
+	/**
+	 * Gets the native [WKWebView](https://developer.apple.com/documentation/webkit/wkwebview/) that represents the user interface for this component. Valid only when running on iOS.
+	 */
+	ios: any /* WKWebView */;
+
+	/**
+	 * Gets or sets the url, local file path or HTML string.
+	 *
+	 * @nsProperty
+	 */
+	src: string;
+
+	/**
+	 * Gets a value indicating whether the WebView can navigate back.
+	 */
+	canGoBack: boolean;
+
+	/**
+	 * Gets a value indicating whether the WebView can navigate forward.
+	 */
+	canGoForward: boolean;
+
+	/**
+	 *  Disable scrolling in the WebView
+	 *
+	 * @nsProperty
+	 */
+	disableZoom: boolean;
+
+	/**
+	 * Enables inline media playback on iOS.
+	 * By default, webview forces iPhone into fullscreen media playback.
+	 *
+	 * @nsProperty
+	 */
+	iosAllowInlineMediaPlayback: boolean;
+
+	/**
+	 * Stops loading the current content (if any).
+	 */
+	stopLoading(): void;
+
+	/**
+	 * Navigates back.
+	 */
+	goBack();
+
+	/**
+	 * Navigates forward.
+	 */
+	goForward();
+
+	/**
+	 * Reloads the current url.
+	 */
+	reload();
+
+	/**
+	 * Adds a listener for the specified event name.
+	 *
+	 * @param eventName The name of the event.
+	 * @param callback The event listener to add. Will be called when an event of
+	 * the given name is raised.
+	 * @param thisArg An optional parameter which, when set, will be bound as the
+	 * `this` context when the callback is called. Falsy values will be not be
+	 * bound.
+	 */
+	on(eventName: string, callback: (data: EventData) => void, thisArg?: any): void;
+
+	/**
+	 * Raised when a loadFinished event occurs.
+	 */
+	on(event: 'loadFinished', callback: (args: LoadEventData) => void, thisArg?: any): void;
+
+	/**
+	 * Raised when a loadStarted event occurs.
+	 */
+	on(event: 'loadStarted', callback: (args: LoadEventData) => void, thisArg?: any): void;
+}
+
+/**
+ * Event data containing information for the loading events of a WebView.
+ */
+export interface LoadEventData extends EventData {
+	/**
+	 * Gets the url of the web-view.
+	 */
+	url: string;
+
+	/**
+	 * Gets the navigation type of the web-view.
+	 */
+	navigationType: NavigationType;
+
+	/**
+	 * Gets the error (if any).
+	 */
+	error: string;
+}

package/utils/constants.d.ts

@@ -0,0 +1 @@
+export const SDK_VERSION: number;

package/utils/debug.d.ts

@@ -1,20 +1,64 @@
-export declare const debug = true;
-export declare class Source {
-    private _uri;
-    private _line;
-    private _column;
-    private static _source;
-    constructor(uri: string, line: number, column: number);
-    get uri(): string;
-    get line(): number;
-    get column(): number;
-    toString(): string;
-    static get(object: any): Source;
-    static set(object: any, src: Source): void;
+/**
+ * A runtime option indicating whether the build has debugging enabled.
+ */
+export let debug: boolean;
+
+/**
+ * A class encapsulating information for source code origin.
+ */
+export class Source {
+	/**
+	 * Creates a new Source instance by given uri, line and column.
+	 */
+	constructor(uri: string, line: number, column: number);
+
+	/**
+	 * Gets the URI of the source document;
+	 */
+	uri: string;
+
+	/**
+	 * Gets the line in the source document.
+	 */
+	line: number;
+
+	/**
+	 * Gets the position in the source document.
+	 */
+	column: number;
+
+	/**
+	 * Get the source of an object.
+	 */
+	public static get(object: any): Source;
+
+	/**
+	 * Set the source of an object.
+	 */
+	public static set(object: any, src: Source);
 }
-export declare class ScopeError extends Error {
-    constructor(inner: Error, message?: string);
+
+/**
+ * An Error class that provides additional context to an error.
+ */
+export class ScopeError extends Error {
+	/**
+	 * Creates a new ScopeError providing addtional context to the child error.
+	 * @param child The child error to extend.
+	 * @param message Additional message to prepend to the child error.
+	 */
+	constructor(child: Error, message?: string);
 }
-export declare class SourceError extends ScopeError {
-    constructor(child: Error, source: Source, message?: string);
+
+/**
+ * Represents a scope error providing addiot
+ */
+export class SourceError extends ScopeError {
+	/**
+	 * Creates a new SourceError by child error, source and optional message.
+	 * @param child The child error to extend.
+	 * @param source The source where the error occured.
+	 * @param message Additonal message to prepend along the source location and the child error's message.
+	 */
+	constructor(child: Error, source: Source, message?: string);
 }

package/utils/index.d.ts

@@ -0,0 +1,183 @@
+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 url asynchronously.
+ * @param url The url.
+ */
+export function openUrlAsync(url: string): Promise<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

@@ -0,0 +1,82 @@
+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/lazy.d.ts

@@ -1 +1,6 @@
+/**
+ * A function that evaluates the action only once.
+ * @param action The action to be evaluated to get the result.
+ * Returns the evaluated result.
+ */
 export default function lazy<T>(action: () => T): () => T;

package/utils/macrotask-scheduler.d.ts

@@ -1 +1,5 @@
-export declare function queueMacrotask(task: () => void): void;
+/**
+ * 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;

package/utils/mainthread-helper.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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);