@nativescript/core 8.9.0-next-01-17-2025-12834437745 → 8.9.0-next-01-22-2025-12918162303

package/ui/action-bar/index.d.ts

@@ -0,0 +1,304 @@
+import { View } from '../core/view';
+import { ViewBase } from '../core/view-base';
+import { EventData } from '../../data/observable';
+
+/**
+ * Provides an abstraction over the ActionBar (android) and NavigationBar (iOS).
+ *
+ * @nsView ActionBar
+ */
+export class ActionBar extends View {
+	/**
+	 * Gets or sets the action bar title.
+	 *
+	 * @nsProperty
+	 */
+	title: string;
+
+	/**
+	 * Gets or sets the title view. When set - replaces the title with a custom view.
+	 *
+	 * @nsProperty
+	 */
+	titleView: View;
+
+	/**
+	 * Gets or sets the navigation button (a.k.a. the back button).
+	 *
+	 * @nsProperty
+	 */
+	navigationButton: NavigationButton;
+
+	/**
+	 * Removes the shadow/border at the bottom of the ActionBar and removes translucency on iOS.
+	 * Default false.
+	 *
+	 * @nsProperty
+	 */
+	flat: boolean;
+
+	/**
+	 * Gets the collection of action items.
+	 *
+	 * @nsProperty
+	 */
+	actionItems: ActionItems;
+
+	/**
+	 * Gets the android specific options of the action bar.
+	 *
+	 */
+	android: AndroidActionBarSettings;
+
+	/**
+	 * Gets the native iOS [UINavigationBar](https://developer.apple.com/documentation/uikit/uinavigationbar) that represents the user interface for this component. Valid only when running on iOS.
+	 */
+	ios: any /* UITabBarController */;
+
+	/**
+	 * Gets or set the UIImageRenderingMode of the action bar icons in iOS. Defaults to "alwaysOriginal"
+	 * Valid values are:
+	 *  - automatic
+	 *  - alwaysOriginal
+	 *  - alwaysTemplate
+	 *
+	 * @nsProperty
+	 */
+	iosIconRenderingMode: 'automatic' | 'alwaysOriginal' | 'alwaysTemplate';
+
+	public effectiveContentInsetLeft: number;
+	public effectiveContentInsetRight: number;
+
+	/**
+	 * Updates the action bar.
+	 */
+	update();
+
+	//@private
+	/**
+	 * @private
+	 */
+	_isEmpty(): boolean;
+	/**
+	 * @private
+	 */
+	_getActualSize?: { width: number; height: number };
+	//@endprivate
+}
+
+/**
+ * Represents a collection of ActionItems.
+ *
+ */
+export class ActionItems {
+	/**
+	 * Adds an item to the collection.
+	 * @param item - the item to be added
+	 */
+	addItem(item: ActionItem): void;
+
+	/**
+	 * Removes an item to the collection.
+	 * @param item - The item to be removed.
+	 */
+	removeItem(item: ActionItem): void;
+
+	/**
+	 * Gets an array of the current action items in the collection.
+	 */
+	getItems(): Array<ActionItem>;
+
+	/**
+	 * Gets an item at a specified index.
+	 * @param index - The index.
+	 */
+	getItemAt(index: number): ActionItem;
+}
+
+/**
+ * Represents an action item in the action bar.
+ *
+ * @nsView ActionItem
+ */
+export class ActionItem extends ViewBase {
+	/**
+	 * String value used when hooking to layoutChanged event.
+	 *
+	 * @nsEvent {EventData} tap
+	 */
+	public static tapEvent: string;
+
+	/**
+	 * Gets or sets the text of the action item.
+	 *
+	 * @nsProperty
+	 */
+	text: string;
+
+	/**
+	 * Gets or sets the icon of the action item.
+	 *
+	 * @nsProperty
+	 */
+	icon: string;
+
+	/**
+	 * Gets or sets the custom action view of the action item.
+	 *
+	 * @nsProperty
+	 */
+	actionView: View;
+
+	/**
+	 * Gets or sets the visibility of the action item.
+	 *
+	 * @nsProperty
+	 */
+	visibility: string;
+
+	/**
+	 * Gets the action bar that contains the action item.
+	 */
+	actionBar: ActionBar;
+
+	/**
+	 * 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): void;
+
+	/**
+	 * Raised when a tap event occurs.
+	 */
+	on(event: 'tap', callback: (args: EventData) => void): void;
+
+	//@private
+	/**
+	 * @private
+	 */
+	_raiseTap(): void;
+	//@endprivate
+
+	/**
+	 * Gets the iOS specific options of the action item.
+	 */
+	// @ts-ignore
+	ios: IOSActionItemSettings;
+
+	/**
+	 * Gets the Android specific options of the action item.
+	 */
+	// @ts-ignore
+	android: AndroidActionItemSettings;
+}
+
+/**
+ * Represents Android specific options of the action item.
+ */
+export interface AndroidActionItemSettings {
+	/**
+	 * Gets or sets the position of the action item in the action bar.
+	 *  1. actionBar - item is shown in the action bar.
+	 *  2. actionBarIfRoom - item is shown in the action bar if there is room for it. Otherwise it is put in the popup menu.
+	 *  3. popup - item is shown in the popup menu.
+	 * Note: Property not applicable to NavigationButton
+	 */
+	position: 'actionBar' | 'actionBarIfRoom' | 'popup';
+
+	/**
+	 * Gets or sets the name of the system drawable resource to be displayed.
+	 * Use this property instead of ActionItem.icon if you want to diplsay a built-in Android system icon.
+	 * The value should be a string such as 'ic_menu_search' if you want to display the built-in Android Menu Search icon for example.
+	 * For a full list of Android drawable names, please visit http://androiddrawables.com
+	 */
+	systemIcon: string;
+}
+
+/**
+ * Represents iOS specific options of the action item.
+ */
+export interface IOSActionItemSettings {
+	/**
+	 * Gets or sets the position of the action item in the action bar.
+	 *  1. left - items is shown at the left part of the navigation bar. This is the default value.
+	 *  2. right - items is shown at the right part of the navigation bar.
+	 * Note: Property not applicable to NavigationButton
+	 */
+	position: 'left' | 'right';
+
+	/**
+	 * Gets or sets a number representing the iOS system item to be displayed.
+	 * Use this property instead of ActionItem.icon if you want to diplsay a built-in iOS system icon.
+	 * Note: Property not applicable to NavigationButton
+	 * The value should be a number from the UIBarButtonSystemItem enumeration
+	 * (https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIBarButtonItem_Class/#//apple_ref/c/tdef/UIBarButtonSystemItem)
+	 *  0: Done
+	 *  1: Cancel
+	 *  2: Edit
+	 *  3: Save
+	 *  4: Add
+	 *  5: FlexibleSpace
+	 *  6: FixedSpace
+	 *  7: Compose
+	 *  8: Reply
+	 *  9: Action
+	 * 10: Organize
+	 * 11: Bookmarks
+	 * 12: Search
+	 * 13: Refresh
+	 * 14: Stop
+	 * 15: Camera
+	 * 16: Trash
+	 * 17: Play
+	 * 18: Pause
+	 * 19: Rewind
+	 * 20: FastForward
+	 * 21: Undo
+	 * 22: Redo
+	 * 23: PageCurl
+	 */
+	systemIcon: number;
+}
+
+/**
+ * Represents Android specific options of the action bar.
+ */
+export interface AndroidActionBarSettings {
+	/**
+	 * Gets or sets the action bar icon.
+	 */
+	icon: string;
+
+	/**
+	 * Gets or sets the visibility of the action bar icon.
+	 * The icon is visible by default in pre-lollipop (API level < 20) versions of android and is hidden in lollipop (API level >= 20)
+	 * The possible values are:
+	 *  1. auto - the default behavior. This is the default value.
+	 *  2. always - the icon is always shown.
+	 *  3. never - the icon is always hidden.
+	 */
+	iconVisibility: string;
+}
+
+/**
+ * Represents the navigation (a.k.a. "back") button.
+ */
+export class NavigationButton extends ActionItem {
+	//@private
+	/**
+	 * @private
+	 */
+	_navigationItem?: any;
+	//@endprivate
+}
+
+/** @internal */
+export function _setNavBarColor(navBar: any /* UINavigationBar */, color: any /* UIColor */);
+/** @internal */
+export function _setNavBarBackgroundColor(navBar: any /* UINavigationBar */, color: any /* UIColor */);

package/ui/activity-indicator/index.d.ts

@@ -0,0 +1,25 @@
+import { View } from '../core/view';
+
+/**
+ * Represents a UI widget which displays a progress indicator hinting the user for some background operation running.
+ *
+ * @nsView ActivityIndicator
+ */
+export class ActivityIndicator extends View {
+	/**
+	 * Gets the native [android widget](http://developer.android.com/reference/android/widget/ProgressBar.html) that represents the user interface for this component. Valid only when running on Android OS.
+	 */
+	android: any /* android.widget.ProgressBar */;
+
+	/**
+	 * Gets the native iOS [UIActivityIndicatorView](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIActivityIndicatorView_Class/index.html) that represents the user interface for this component. Valid only when running on iOS.
+	 */
+	ios: any /* UIActivityIndicatorView */;
+
+	/**
+	 * Gets or sets a value indicating whether the widget is currently displaying progress.
+	 *
+	 * @nsProperty
+	 */
+	busy: boolean;
+}

package/ui/animation/index.d.ts

@@ -0,0 +1,139 @@
+import { View } from '../core/view';
+import { CoreTypes } from '../../core-types';
+import { Color } from '../../color';
+
+export { KeyframeAnimation, KeyframeAnimationInfo, KeyframeDeclaration, KeyframeInfo } from './keyframe-animation';
+
+/**
+ * Defines animation options for the View.animate method.
+ */
+export interface AnimationDefinition {
+	/**
+	 * The view whose property is to be animated.
+	 */
+	target?: View;
+
+	/**
+	 * Animates the opacity of the view. Value should be a number between 0.0 and 1.0
+	 */
+	opacity?: number;
+
+	/**
+	 * Animates the backgroundColor of the view.
+	 */
+	backgroundColor?: Color;
+
+	/**
+	 * Animates the translate affine transform of the view.
+	 */
+	translate?: Pair;
+
+	/**
+	 * Animates the scale affine transform of the view.
+	 */
+	scale?: Pair;
+
+	/**
+	 * Animates the height of a view.
+	 */
+	height?: CoreTypes.PercentLengthType | string;
+
+	/**
+	 * Animates the width of a view.
+	 */
+	width?: CoreTypes.PercentLengthType | string;
+
+	/**
+	 * Animates the rotate affine transform of the view. Value should be a number specifying the rotation amount in degrees.
+	 */
+	rotate?: number | Point3D;
+
+	/**
+	 * The length of the animation in milliseconds. The default duration is 300 milliseconds.
+	 */
+	duration?: number;
+
+	/**
+	 * The amount of time, in milliseconds, to delay starting the animation.
+	 */
+	delay?: number;
+
+	/**
+	 * Specifies how many times the animation should be played. Default is 1.
+	 * iOS animations support fractional iterations, i.e. 1.5.
+	 * To repeat an animation infinitely, use Number.POSITIVE_INFINITY
+	 */
+	iterations?: number;
+
+	/**
+	 * An optional animation curve. Possible values are contained in the [AnimationCurve enumeration](../modules/_ui_enums_.animationcurve.html).
+	 * Alternatively, you can pass an instance of type UIViewAnimationCurve for iOS or android.animation.TimeInterpolator for Android.
+	 */
+	curve?: any;
+}
+
+/**
+ * Defines a key-value pair for css transformation
+ */
+export type Transformation = {
+	property: TransformationType;
+	value: TransformationValue;
+};
+
+/**
+ * Defines possible css transformations
+ */
+export type TransformationType = 'rotate' | 'rotateX' | 'rotateY' | 'translate' | 'translateX' | 'translateY' | 'scale' | 'scaleX' | 'scaleY';
+
+/**
+ * Defines possible css transformation values
+ */
+export type TransformationValue = Point3D | Pair | number;
+
+/**
+ * Defines a point in 3d space (x, y and z) for rotation in 3d animations.
+ */
+export interface Point3D {
+	x: number;
+	y: number;
+	z: number;
+}
+
+/**
+ * Defines a pair of values (horizontal and vertical) for translate and scale animations.
+ */
+export interface Pair {
+	x: number;
+	y: number;
+}
+
+/**
+ * Defines full information for css transformation
+ */
+export type TransformFunctionsInfo = {
+	translate: Pair;
+	rotate: Point3D;
+	scale: Pair;
+};
+
+export interface Cancelable {
+	cancel(): void;
+}
+
+/**
+ * A Promise that can cancel the animation.
+ */
+export type AnimationPromise = Promise<void> & Cancelable;
+
+/**
+ * Defines a animation set.
+ */
+export class Animation {
+	constructor(animationDefinitions: Array<AnimationDefinition>, playSequentially?: boolean);
+	public play: (resetOnFinish?: boolean) => AnimationPromise;
+	public cancel: () => void;
+	public isPlaying: boolean;
+	public _resolveAnimationCurve(curve: any): any;
+}
+
+export function _resolveAnimationCurve(curve: any): any;

package/ui/animation/keyframe-animation.d.ts

@@ -1,76 +1,127 @@
 import { View } from '../core/view';
-import { Color } from '../../color';
 import { CoreTypes } from '../../core-types';
-export interface Keyframes {
-    name: string;
-    keyframes: Array<UnparsedKeyframe>;
-    tag?: string | number;
-    scopedTag?: string;
-    mediaQueryString?: string;
+import { Color } from '../../color';
+
+export declare const ANIMATION_PROPERTIES;
+
+interface Keyframe {
+	backgroundColor?: Color;
+	scale?: { x: number; y: number };
+	translate?: { x: number; y: number };
+	rotate?: { x: number; y: number; z: number };
+	opacity?: number;
+	width?: CoreTypes.PercentLengthType;
+	height?: CoreTypes.PercentLengthType;
+	valueSource?: 'keyframe' | 'animation';
+	duration?: number;
+	curve?: any;
+	forceLayer?: boolean;
 }
-export declare class UnparsedKeyframe {
-    values: Array<any>;
-    declarations: Array<KeyframeDeclaration>;
+
+export interface Keyframes {
+	name: string;
+	keyframes: Array<UnparsedKeyframe>;
+	tag?: string | number;
+	scopedTag?: string;
+	mediaQueryString?: string;
 }
-export declare class KeyframeDeclaration {
-    property: string;
-    value: any;
+
+export interface UnparsedKeyframe {
+	values: Array<any>;
+	declarations: Array<KeyframeDeclaration>;
 }
-export declare class KeyframeInfo {
-    duration: number;
-    declarations: Array<KeyframeDeclaration>;
-    curve?: any;
+
+export interface KeyframeDeclaration {
+	property: string;
+	value: any;
 }
-export declare class KeyframeAnimationInfo {
-    keyframes: Array<KeyframeInfo>;
-    name?: string;
-    duration?: number;
-    delay?: number;
-    iterations?: number;
-    curve?: any;
-    isForwards?: boolean;
-    isReverse?: boolean;
+
+export interface KeyframeInfo {
+	duration: number;
+	declarations: Array<KeyframeDeclaration>;
+	curve?: any;
 }
-interface Keyframe {
-    backgroundColor?: Color;
-    scale?: {
-        x: number;
-        y: number;
-    };
-    translate?: {
-        x: number;
-        y: number;
-    };
-    rotate?: {
-        x: number;
-        y: number;
-        z: number;
-    };
-    opacity?: number;
-    width?: CoreTypes.PercentLengthType;
-    height?: CoreTypes.PercentLengthType;
-    valueSource?: 'keyframe' | 'animation';
-    duration?: number;
-    curve?: any;
-    forceLayer?: boolean;
+
+/**
+ * Defines animation options for the View.animate method.
+ */
+export class KeyframeAnimationInfo {
+	/**
+	 * Return animation keyframes.
+	 */
+	keyframes: Array<KeyframeInfo>;
+
+	/**
+	 * The animation name.
+	 */
+	name?: string;
+
+	/**
+	 * The length of the animation in milliseconds. The default duration is 300 milliseconds.
+	 */
+	duration?: number;
+
+	/**
+	 * The amount of time, in milliseconds, to delay starting the animation.
+	 */
+	delay?: number;
+
+	/**
+	 * Specifies how many times the animation should be played. Default is 1.
+	 * iOS animations support fractional iterations, i.e. 1.5.
+	 * To repeat an animation infinitely, use Number.POSITIVE_INFINITY
+	 */
+	iterations?: number;
+
+	/**
+	 * An optional animation curve. Possible values are contained in the [AnimationCurve enumeration](../modules/_ui_enums_.animationcurve.html).
+	 * Alternatively, you can pass an instance of type UIViewAnimationCurve for iOS or android.animation.TimeInterpolator for Android.
+	 */
+	curve?: any;
+
+	/**
+	 * Determines whether the animation values will be applied on the animated object after the animation finishes.
+	 */
+	isForwards: boolean;
+
+	/**
+	 * If true the animation will be played backwards.
+	 */
+	isReverse?: boolean;
 }
-export declare class KeyframeAnimation {
-    animations: Array<Keyframe>;
-    delay: number;
-    iterations: number;
-    private _resolve;
-    private _isPlaying;
-    private _isForwards;
-    private _nativeAnimations;
-    private _target;
-    static keyframeAnimationFromInfo(info: KeyframeAnimationInfo): KeyframeAnimation;
-    private static parseKeyframe;
-    get isPlaying(): boolean;
-    cancel(): void;
-    play(view: View): Promise<void>;
-    private animate;
-    _resolveAnimationFinishedPromise(): void;
-    _resetAnimations(): void;
-    private _resetAnimationValues;
+
+export class KeyframeAnimation {
+	animations: Array<Keyframe>;
+
+	/**
+	 * The amount of time, in milliseconds, to delay starting the animation.
+	 */
+	delay: number;
+
+	/**
+	 * Specifies how many times the animation should be played. Default is 1.
+	 * iOS animations support fractional iterations, i.e. 1.5.
+	 * To repeat an animation infinitely, use Number.POSITIVE_INFINITY
+	 */
+	iterations: number;
+
+	/**
+	 * Returns true if the application is currently running.
+	 */
+	isPlaying: boolean;
+
+	/**
+	 * Plays the animation.
+	 */
+	public play: (view: View) => Promise<void>;
+
+	/**
+	 * Cancels a playing animation.
+	 */
+	public cancel: () => void;
+
+	/**
+	 * Creates a keyframe animation from animation definition.
+	 */
+	public static keyframeAnimationFromInfo(info: KeyframeAnimationInfo): KeyframeAnimation;
 }
-export {};

package/ui/builder/binding-builder.d.ts

@@ -1,13 +1,16 @@
-export declare namespace bindingConstants {
-    const sourceProperty = "sourceProperty";
-    const targetProperty = "targetProperty";
-    const expression = "expression";
-    const twoWay = "twoWay";
-    const source = "source";
-    const bindingValueKey = "$value";
-    const parentValueKey = "$parent";
-    const parentsValueKey = "$parents";
-    const newPropertyValueKey = "$newPropertyValue";
+//@private
+export module bindingConstants {
+	export const sourceProperty: string;
+	export const targetProperty: string;
+	export const expression: string;
+	export const twoWay: string;
+	export const source: string;
+	export const bindingValueKey: string;
+	export const parentValueKey: string;
+	export const parentsValueKey: string;
+	export const newPropertyValueKey: string;
 }
-export declare const parentsRegex: RegExp;
-export declare function getBindingOptions(name: string, value: string): any;
+
+export function getBindingOptions(name: string, value: string): any;
+
+export const parentsRegex: RegExp;