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

package/accessibility/accessibility-service.d.ts

@@ -0,0 +1,10 @@
+import { Observable } from '../data/observable';
+
+export class AccessibilityServiceEnabledObservable extends Observable {
+	public readonly accessibilityServiceEnabled?: boolean;
+}
+
+/**
+ * Get the Android platform's AccessibilityManager.
+ */
+export function getAndroidAccessibilityManager(): /* android.view.accessibility.AccessibilityManager */ any | null;

package/accessibility/font-scale.d.ts

@@ -0,0 +1,9 @@
+export const VALID_FONT_SCALES: number[];
+export function getCurrentFontScale(): number;
+export enum FontScaleCategory {
+	ExtraSmall = 'extra-small',
+	Medium = 'medium',
+	ExtraLarge = 'extra-large',
+}
+export function getFontScaleCategory(): FontScaleCategory;
+export function initAccessibilityFontScale(): void;

package/accessibility/index.d.ts

@@ -0,0 +1,37 @@
+import type { Page } from '../ui/page';
+import type { View } from '../ui/core/view';
+import type { AndroidAccessibilityEvent } from './accessibility-types';
+
+export * from './accessibility-common';
+export * from './accessibility-types';
+export * from './font-scale';
+
+/**
+ * Initialize accessibility for View. This should be called on loaded-event.
+ */
+export function setupAccessibleView(view: View): void;
+
+/**
+ * Update accessibility properties on nativeView
+ */
+export function updateAccessibilityProperties(view: View): void;
+
+/**
+ * Android: helper function for triggering accessibility events
+ */
+export function sendAccessibilityEvent(View: View, eventName: AndroidAccessibilityEvent, text?: string): void;
+
+/**
+ * Android: Update the content description for views
+ */
+export function updateContentDescription(View: View, forceUpdate?: boolean): string | null;
+
+/**
+ * Is Android TalkBack or iOS VoiceOver enabled?
+ */
+export function isAccessibilityServiceEnabled(): boolean;
+
+/**
+ * Find the last view focused on a page.
+ */
+export function getLastFocusedViewOnPage(page: Page): View | null;

package/animation-frame/animation-native.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Gets the time in millisseconds in the same base as frames
+ */
+export function getTimeInFrameBase(): number;

package/animation-frame/index.d.ts

@@ -1,5 +1,19 @@
+/**
+ * Callback called on frame rendered
+ * @argument time Time of the current frame in milliseconds
+ */
 export interface FrameRequestCallback {
-    (time: number): void;
+	(time: number): void;
 }
-export declare function requestAnimationFrame(cb: FrameRequestCallback): number;
-export declare function cancelAnimationFrame(id: number): void;
+
+/**
+ * Requests an animation frame and returns the timer ID
+ * @param cb Callback to be called on frame
+ */
+export function requestAnimationFrame(cb: FrameRequestCallback): number;
+
+/**
+ * Cancels a previously scheduled animation frame request
+ * @param id timer ID to cancel
+ */
+export function cancelAnimationFrame(id: number): void;

package/application/application.d.ts

@@ -0,0 +1,194 @@
+import { ApplicationCommon } from './application-common';
+
+export * from './application-common';
+export * from './application-interfaces';
+
+export const Application: ApplicationCommon;
+
+export class AndroidApplication extends ApplicationCommon {
+	/**
+	 * @deprecated Use `Application.android.activityCreatedEvent` instead.
+	 */
+	static readonly activityCreatedEvent = 'activityCreated';
+	/**
+	 * @deprecated Use `Application.android.activityDestroyedEvent` instead.
+	 */
+	static readonly activityDestroyedEvent = 'activityDestroyed';
+	/**
+	 * @deprecated Use `Application.android.activityStartedEvent` instead.
+	 */
+	static readonly activityStartedEvent = 'activityStarted';
+	/**
+	 * @deprecated Use `Application.android.activityPausedEvent` instead.
+	 */
+	static readonly activityPausedEvent = 'activityPaused';
+	/**
+	 * @deprecated Use `Application.android.activityResumedEvent` instead.
+	 */
+	static readonly activityResumedEvent = 'activityResumed';
+	/**
+	 * @deprecated Use `Application.android.activityStoppedEvent` instead.
+	 */
+	static readonly activityStoppedEvent = 'activityStopped';
+	/**
+	 * @deprecated Use `Application.android.saveActivityStateEvent` instead.
+	 */
+	static readonly saveActivityStateEvent = 'saveActivityState';
+	/**
+	 * @deprecated Use `Application.android.activityResultEvent` instead.
+	 */
+	static readonly activityResultEvent = 'activityResult';
+	/**
+	 * @deprecated Use `Application.android.activityBackPressedEvent` instead.
+	 */
+	static readonly activityBackPressedEvent = 'activityBackPressed';
+	/**
+	 * @deprecated Use `Application.android.activityNewIntentEvent` instead.
+	 */
+	static readonly activityNewIntentEvent = 'activityNewIntent';
+	/**
+	 * @deprecated Use `Application.android.activityRequestPermissionsEvent` instead.
+	 */
+	static readonly activityRequestPermissionsEvent = 'activityRequestPermissions';
+
+	readonly activityCreatedEvent = AndroidApplication.activityCreatedEvent;
+	readonly activityDestroyedEvent = AndroidApplication.activityDestroyedEvent;
+	readonly activityStartedEvent = AndroidApplication.activityStartedEvent;
+	readonly activityPausedEvent = AndroidApplication.activityPausedEvent;
+	readonly activityResumedEvent = AndroidApplication.activityResumedEvent;
+	readonly activityStoppedEvent = AndroidApplication.activityStoppedEvent;
+	readonly saveActivityStateEvent = AndroidApplication.saveActivityStateEvent;
+	readonly activityResultEvent = AndroidApplication.activityResultEvent;
+	readonly activityBackPressedEvent = AndroidApplication.activityBackPressedEvent;
+	readonly activityNewIntentEvent = AndroidApplication.activityNewIntentEvent;
+	readonly activityRequestPermissionsEvent = AndroidApplication.activityRequestPermissionsEvent;
+
+	getNativeApplication(): android.app.Application;
+
+	/**
+	 * @internal
+	 */
+	init(nativeApp: android.app.Application): void;
+
+	/**
+	 * The [android Application](http://developer.android.com/reference/android/app/Application.html) object instance provided to the init of the module.
+	 */
+	get nativeApp(): android.app.Application;
+
+	/**
+	 * @deprecated Use `Utils.android.getPackageName()` instead.
+	 */
+	get packageName(): string;
+
+	/**
+	 * The main (start) Activity for the application.
+	 */
+	get startActivity(): androidx.appcompat.app.AppCompatActivity;
+
+	/**
+	 * The currently active (loaded) [android Activity](http://developer.android.com/reference/android/app/Activity.html).
+	 *
+	 * This property is automatically updated upon Activity events.
+	 */
+	get foregroundActivity(): androidx.appcompat.app.AppCompatActivity;
+
+	/**
+	 * @deprecated Use `Utils.android.getApplicationContext()` instead.
+	 */
+	get context(): android.content.Context;
+
+	/**
+	 * @deprecated Use `Application.inBackground` instead.
+	 */
+	get backgrounded(): boolean;
+
+	/**
+	 * @deprecated Use `Application.suspended` instead.
+	 */
+	get paused(): boolean;
+
+	/**
+	 * Register a BroadcastReceiver to be run in the main activity thread. The receiver will be called with any broadcast Intent that matches filter, in the main application thread.
+	 * For more information, please visit 'http://developer.android.com/reference/android/content/Context.html#registerReceiver%28android.content.BroadcastReceiver,%20android.content.IntentFilter%29'
+	 * @param intentFilter A string containing the intent filter.
+	 * @param onReceiveCallback A callback function that will be called each time the receiver receives a broadcast.
+	 */
+	registerBroadcastReceiver(intentFilter: string, onReceiveCallback: (context: android.content.Context, intent: android.content.Intent) => void): void;
+
+	/**
+	 * Unregister a previously registered BroadcastReceiver.
+	 * For more information, please visit 'http://developer.android.com/reference/android/content/Context.html#unregisterReceiver(android.content.BroadcastReceiver)'
+	 * @param intentFilter A string containing the intent filter with which the receiver was originally registered.
+	 */
+	unregisterBroadcastReceiver(intentFilter: string): void;
+
+	/**
+	 * Get a registered BroadcastReceiver, then you can get the result code of BroadcastReceiver in onReceiveCallback method.
+	 * @param intentFilter A string containing the intent filter.
+	 */
+	getRegisteredBroadcastReceiver(intentFilter: string): android.content.BroadcastReceiver;
+
+	on(event: 'activityCreated', callback: (args: AndroidActivityBundleEventData) => void, thisArg?: any): void;
+	on(event: 'activityDestroyed', callback: (args: AndroidActivityEventData) => void, thisArg?: any): void;
+	on(event: 'activityStarted', callback: (args: AndroidActivityEventData) => void, thisArg?: any): void;
+	on(event: 'activityPaused', callback: (args: AndroidActivityEventData) => void, thisArg?: any): void;
+	on(event: 'activityResumed', callback: (args: AndroidActivityEventData) => void, thisArg?: any): void;
+	on(event: 'activityStopped', callback: (args: AndroidActivityEventData) => void, thisArg?: any): void;
+	on(event: 'saveActivityState', callback: (args: AndroidActivityBundleEventData) => void, thisArg?: any): void;
+	on(event: 'activityResult', callback: (args: AndroidActivityResultEventData) => void, thisArg?: any): void;
+	on(event: 'activityBackPressed', callback: (args: AndroidActivityBackPressedEventData) => void, thisArg?: any): void;
+	on(event: 'activityNewIntent', callback: (args: AndroidActivityNewIntentEventData) => void, thisArg?: any): void;
+	on(event: 'activityRequestPermissions', callback: (args: AndroidActivityRequestPermissionsEventData) => void, thisArg?: any): void;
+}
+
+export class iOSApplication extends ApplicationCommon {
+	/**
+	 * The root view controller for the application.
+	 */
+	get rootController(): UIViewController;
+
+	/**
+	 * The [UIApplication](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIApplication_Class/index.html).
+	 */
+	get nativeApp(): UIApplication;
+
+	/**
+	 * The key window.
+	 */
+	get window(): UIWindow;
+
+	/**
+	 * The [UIApplicationDelegate](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIApplicationDelegate_Protocol/index.html) class.
+	 */
+	get delegate(): UIApplicationDelegate & { prototype: UIApplicationDelegate };
+
+	/**
+	 * Sets a custom [UIApplicationDelegate](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIApplicationDelegate_Protocol/index.html) class.
+	 */
+	set delegate(value: UIApplicationDelegate | unknown);
+
+	/**
+	 * Adds a delegate handler for the specified delegate method name. This method does not replace an existing handler,
+	 * but rather adds the new handler to the existing chain of handlers.
+	 * @param methodName The name of the delegate method to add a handler for.
+	 * @param handler A function that will be called when the specified delegate method is called.
+	 */
+	addDelegateHandler<T extends keyof UIApplicationDelegate>(methodName: T, handler: (typeof UIApplicationDelegate.prototype)[T]): void;
+
+	/**
+	 * Adds an observer to the default notification center for the specified notification.
+	 * For more information, please visit 'https://developer.apple.com/library/mac/documentation/Cocoa/Reference/Foundation/Classes/NSNotificationCenter_Class/#//apple_ref/occ/instm/NSNotificationCenter/addObserver:selector:name:object:'
+	 * @param notificationName A string containing the name of the notification.
+	 * @param onReceiveCallback A callback function that will be called each time the observer receives a notification.
+	 */
+	addNotificationObserver(notificationName: string, onReceiveCallback: (notification: NSNotification) => void): NotificationObserver;
+
+	/**
+	 * Removes the observer for the specified notification from the default notification center.
+	 * For more information, please visit 'https://developer.apple.com/library/mac/documentation/Cocoa/Reference/Foundation/Classes/NSNotificationCenter_Class/#//apple_ref/occ/instm/NSNotificationCenter/addObserver:selector:name:object:'
+	 * @param observer The observer that was returned from the addNotificationObserver method.
+	 * @param notificationName A string containing the name of the notification.
+	 * @param onReceiveCallback A callback function that will be called each time the observer receives a notification.
+	 */
+	removeNotificationObserver(observer: any, notificationName: string);
+}

package/application/index.d.ts

@@ -0,0 +1,2 @@
+export * from './application';
+export * from './application-shims';

package/application-settings/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Checks whether such a key exists.
+ * @param key The key to check for.
+ */
+export function hasKey(key: string): boolean;
+
+/**
+ * Gets a value (if existing) for a key as a Boolean Object. A default value can be provided in case there is no existing value.
+ * @param key The key to check for.
+ * @param defaultValue An optional value to be returned in case there is no existing value.
+ */
+export function getBoolean(key: string, defaultValue?: boolean): boolean;
+
+/**
+ * Gets a value (if existing) for a key as a String Object. A default value can be provided in case there is no existing value.
+ * @param key The key to check for.
+ * @param defaultValue An optional value to be returned in case there is no existing value.
+ */
+export function getString(key: string, defaultValue?: string): string;
+
+/**
+ * Gets a value (if existing) for a key as a Number Object. A default value can be provided in case there is no existing value.
+ * @param key The key to check for.
+ * @param defaultValue An optional value to be returned in case there is no existing value.
+ */
+export function getNumber(key: string, defaultValue?: number): number;
+
+/**
+ * Sets a Boolean Object for a key.
+ * @param key The key.
+ * @param value The value.
+ */
+export function setBoolean(key: string, value: boolean): void;
+
+/**
+ * Sets a String Object for a key.
+ * @param key The key.
+ * @param value The value.
+ */
+export function setString(key: string, value: string): void;
+
+/**
+ * Sets a Number Object for a key.
+ * @param key The key.
+ * @param value The value.
+ */
+export function setNumber(key: string, value: number): void;
+
+/**
+ * Removes a value (if existing) for a key.
+ * @param key The key to check for.
+ */
+export function remove(key: string): void;
+
+/**
+ * Removes all values.
+ */
+export function clear(): void;
+
+/**
+ * Flush all changes to disk synchronously.
+ * @return boolean flag indicating if changes were saved successfully to disk.
+ */
+export function flush(): boolean;
+
+/**
+ * Get all stored keys
+ * @return Array containing all stored keys
+ */
+export function getAllKeys(): Array<string>;

package/cli-hooks/before-checkForChanges.js

@@ -0,0 +1,60 @@
+const semver = require("semver");
+
+const webpackPackageName = "@nativescript/webpack";
+
+module.exports = function ($staticConfig, hookArgs) {
+    const cliVersion = semver.parse($staticConfig.version);
+    const platfrom = hookArgs.prepareData.platform;
+    const projectData = hookArgs.projectData;
+
+    // Required CLI version for building IOS: 6.2.0
+    if (platfrom.toLowerCase() === "ios" &&
+        !satisfiesRequriredVersion(cliVersion, 6, 2)) {
+        throw new Error(`Building @nativescript/core for iOS requires NativeScript CLI with version at least 6.2.0. Please upgrade your NativeScript CLI version (npm i -g nativescript).`);
+    }
+
+    // Required webpack version for angular projects: 1.3.0
+    if (projectData.projectType === "Angular") {
+        const webpackMinVer = getMinWebpackVersion(projectData);
+
+        if (webpackMinVer && !satisfiesRequriredVersion(webpackMinVer, 1, 3)) {
+            throw new Error(`Building @nativescript/core for Angular requires ${webpackPackageName} with version at least 1.3.0. Please upgrade: npm i ${webpackPackageName} --save-dev.`);
+        }
+    }
+};
+
+/**
+ * Checks if semver object satisifies a major/minor requirement. Pre-release versions are OK too!
+ */
+function satisfiesRequriredVersion(actualVersion, requiredMajor, requiredMinor) {
+    // Return true for null version to handle tags (ex. "next", "rc")
+    if (!actualVersion) {
+        return true;
+    }
+
+    if (actualVersion.major < requiredMajor) {
+        return false;
+    }
+
+    if (actualVersion.major === requiredMajor && actualVersion.minor < requiredMinor) {
+        return false;
+    }
+
+    return true;
+}
+
+function getMinWebpackVersion(projectData) {
+    const devDependencies = projectData.devDependencies || {};
+    const dependencies = projectData.dependencies || {};
+    const webpackVer = dependencies[webpackPackageName] || devDependencies[webpackPackageName];
+
+    let webpackMinVer = null;
+
+    if (semver.valid(webpackVer)) {
+        webpackMinVer = semver.parse(webpackVer);
+    } else if (semver.validRange(webpackVer)) {
+        webpackMinVer = semver.minVersion(webpackVer);
+    }
+
+    return webpackMinVer;
+}

package/cli-hooks/postinstall.js

@@ -0,0 +1,2 @@
+const path = require('path');
+require('@nativescript/hook')(path.join(__dirname, "..")).postinstall();

package/cli-hooks/preuninstall.js

@@ -0,0 +1,2 @@
+const path = require('path');
+require('@nativescript/hook')(path.join(__dirname, "..")).preuninstall();

package/color/index.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Represents a color object. Stores all color components (alpha (opacity), red, green, blue) in a [0..255] range.
+ */
+export declare class Color {
+	constructor(knownColor: string);
+	constructor(hex: string);
+	constructor(argb: number);
+	constructor(alpha: number, red: number, green: number, blue: number, type?: 'rgb' | 'hsl' | 'hsv');
+
+	/**
+	 * Gets the Alpha component (in the [0, 255] range) of this color. This is a read-only property.
+	 */
+	public a: number;
+
+	/**
+	 * Gets the Red component (in the [0, 255] range) of this color. This is a read-only property.
+	 */
+	public r: number;
+
+	/**
+	 * Gets the Green component (in the [0, 255] range) of this color. This is a read-only property.
+	 */
+	public g: number;
+
+	/**
+	 * Gets the Blue component (in the [0, 255] range) of this color. This is a read-only property.
+	 */
+	public b: number;
+
+	/**
+	 * Gets the Hexadecimal string representation of this color. This is a read-only property.
+	 */
+	public hex: string;
+
+	/**
+	 * Gets the Argb Number representation of this color where each 8 bits represent a single color component. This is a read-only property.
+	 */
+	public argb: number;
+
+	/**
+	 * Gets the known name of this instance. Defined only if it has been constructed from a known color name - e.g. "red". This is a read-only property.
+	 */
+	public name: string;
+
+	/**
+	 * Gets the android-specific integer value representation. Same as the Argb one. This is a read-only property.
+	 */
+	android: number;
+
+	/**
+	 * Gets the iOS-specific UIColor value representation. This is a read-only property.
+	 */
+	ios: any /* UIColor */;
+
+	/**
+	 * Specifies whether this Color is equal to the Color parameter.
+	 * @param value The Color to test.
+	 */
+	public equals(value: Color): boolean;
+
+	/**
+	 * Compares two Color instances.
+	 * @param value1 A Color to compare.
+	 * @param value2 A Color to compare.
+	 */
+	public static equals(value1: Color, value2: Color): boolean;
+
+	/**
+	 * Validates if a value can be converted to color.
+	 * @param value Input string.
+	 */
+	public static isValid(value: any): boolean;
+
+	/**
+	 * Creates color from iOS-specific UIColor value representation.
+	 */
+	public static fromIosColor(value: any /* UIColor */): Color;
+
+	/**
+	 * return true if brightenss < 128
+	 *
+	 */
+	public isDark(): boolean;
+
+	/**
+	 * return true if brightenss >= 128
+	 *
+	 */
+	public isLight(): boolean;
+
+	/**
+	 * return the [brightness](http://www.w3.org/TR/AERT#color-contrast)
+	 *
+	 */
+	public getBrightness(): number;
+	/**
+	 * return the [luminance](http://www.w3.org/TR/2008/REC-WCAG20-20081211/#relativeluminancedef)
+	 *
+	 */
+	public getLuminance(): number;
+
+	/**
+	 * Return this color (as a new Color instance) with the provided alpha
+	 *
+	 * @param alpha (between 0 and 255)
+	 */
+	public setAlpha(a: number): Color;
+	/**
+	 * return the hsl representation of the color
+	 *
+	 */
+	public toHsl(): { h: number; s: number; l: number; a: number };
+
+	/**
+	 * return the [CSS hsv](https://www.w3schools.com/Css/css_colors_hsl.asp) representation of the color
+	 *
+	 */
+	public toHslString(): string;
+
+	/**
+	 * return the hsv representation of the color
+	 *
+	 */
+	public toHsv(): { h: number; s: number; v: number; a: number };
+
+	/**
+	 * return the [CSS hsv](https://www.w3schools.com/Css/css_colors_rgb.asp) representation of the color
+	 *
+	 */
+	public toHsvString(): string;
+
+	/**
+	 * return the [CSS rgb](https://www.w3schools.com/Css/css_colors_rgb.asp) representation of the color
+	 *
+	 */
+	public toRgbString(): string;
+
+	/**
+	 *  Desaturate the color a given amount, from 0 to 100. Providing 100 will is the same as calling greyscale.
+	 *
+	 * @param amount (between 0 and 100)
+	 */
+	public desaturate(amount: number): Color;
+
+	/**
+	 * Saturate the color a given amount, from 0 to 100.
+	 *
+	 * @param amount (between 0 and 100)
+	 */
+	public saturate(amount: number): Color;
+
+	/**
+	 * Completely desaturates a color into greyscale. Same as calling desaturate(100).
+	 *
+	 * @returns
+	 */
+	public greyscale(): Color;
+
+	/**
+	 * Lighten the color a given amount, from 0 to 100. Providing 100 will always return white.
+	 *
+	 * @param amount (between 0 and 100)
+	 * @returns olor : Color
+	 */
+	public lighten(amount: number): Color;
+
+	/**
+	 * Brighten the color a given amount, from 0 to 100.
+	 *
+	 * @param amount (between 0 and 100)
+	 */
+	public brighten(amount: number): Color;
+
+	/**
+	 * Darken the color a given amount, from 0 to 100. Providing 100 will always return black.
+	 *
+	 * @param amount (between 0 and 100)
+	 */
+	public darken(amount: number): Color;
+
+	/**
+	 * Spin the hue a given amount, from -360 to 360. Calling with 0, 360, or -360 will do nothing (since it sets the hue back to what it was before).
+	 *
+	 * @param amount (between 0 and 100)
+	 */
+	public spin(amount: number): Color;
+
+	/**
+	 * returns the color complement
+	 *
+	 */
+	public complement(): Color;
+
+	/**
+	 * returns the color complement
+	 *
+	 */
+	public static mix(color1: Color, color2: Color, amount: number): Color;
+
+	/**
+	 * returns a new Color from HSL
+	 *
+	 */
+	public static fromHSL(a, h, s, l): Color;
+	public static fromHSV(a, h, s, l): Color;
+}

package/connectivity/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Gets the type of connection.
+ * Returns a value from the connectivity.connectionType enumeration.
+ * To use this method on Android you need to have the android.permission.ACCESS_NETWORK_STATE permission added to the AndroidManifest.xml file.
+ */
+export function getConnectionType(): number;
+
+/**
+ * Defines the different connection types.
+ */
+export enum connectionType {
+	/**
+	 * Denotes no connection.
+	 */
+	none = 0,
+
+	/**
+	 * Denotes a WiFi connection.
+	 */
+	wifi = 1,
+
+	/**
+	 * Denotes a mobile connection, i.e. cellular network or WAN.
+	 */
+	mobile = 2,
+
+	/**
+	 * Denotes an ethernet connection
+	 */
+	ethernet = 3,
+
+	/**
+	 * Denotes a bluetooth connection
+	 */
+	bluetooth = 4,
+
+	/**
+	 * Denotes a vpn connection
+	 */
+	vpn = 5,
+}
+
+/**
+ * Starts monitoring the connection type.
+ * @param connectionTypeChangedCallback A function that will be called when the connection type changes.
+ */
+export function startMonitoring(connectionTypeChangedCallback: (newConnectionType: number) => void): void;
+
+/**
+ * Stops monitoring the connection type.
+ */
+export function stopMonitoring(): void;