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

package/ui/core/view/view-helper/index.d.ts

@@ -0,0 +1,76 @@
+import { Position, View } from '..';
+
+export class ViewHelper {
+	/**
+	 * Measure a child by taking into account its margins and a given measureSpecs.
+	 * @param parent            This parameter is not used. You can pass null.
+	 * @param child             The view to be measured.
+	 * @param measuredWidth     The measured width that the parent layout specifies for this view.
+	 * @param measuredHeight    The measured height that the parent layout specifies for this view.
+	 */
+	public static measureChild(parent: View, child: View, widthMeasureSpec: number, heightMeasureSpec: number): { measuredWidth: number; measuredHeight: number };
+
+	/**
+	 * Layout a child by taking into account its margins, horizontal and vertical alignments and a given bounds.
+	 * @param parent    This parameter is not used. You can pass null.
+	 * @param left      Left position, relative to parent
+	 * @param top       Top position, relative to parent
+	 * @param right     Right position, relative to parent
+	 * @param bottom    Bottom position, relative to parent
+	 */
+	public static layoutChild(parent: View, child: View, left: number, top: number, right: number, bottom: number): void;
+
+	/**
+	 * Utility to reconcile a desired size and state, with constraints imposed
+	 * by a MeasureSpec.  Will take the desired size, unless a different size
+	 * is imposed by the constraints.  The returned value is a compound integer,
+	 * with the resolved size in the MEASURED_SIZE_MASK bits and
+	 * optionally the bit MEASURED_STATE_TOO_SMALL set if the resulting
+	 * size is smaller than the size the view wants to be.
+	 */
+	public static resolveSizeAndState(size: number, specSize: number, specMode: number, childMeasuredState: number): number;
+
+	public static combineMeasuredStates(curState: number, newState): number;
+}
+
+/**
+ * Various Android view helper methods
+ */
+export namespace AndroidHelper {
+	export function getDrawableColor(drawable: any /* android.graphics.drawable.Drawable */): Color;
+	export function setDrawableColor(color: number, drawable: any /* android.graphics.drawable.Drawable */, blendMode?: any /* androidx.core.graphics.BlendModeCompat */): void;
+	export function clearDrawableColor(drawable: any /* android.graphics.drawable.Drawable */): void;
+	export function getCopyOrDrawable(drawable: any /* android.graphics.drawable.Drawable */, resources?: any /* android.content.res.Resources */): any; /* android.graphics.drawable.Drawable */
+}
+
+/**
+ * Various iOS view helper methods
+ */
+export namespace IOSHelper {
+	/**
+	 * String value used when hooking to traitCollectionColorAppearanceChangedEvent event.
+	 */
+	export const traitCollectionColorAppearanceChangedEvent: string;
+
+	/**
+	 * Returns a view with viewController or undefined if no such found along the view's parent chain.
+	 * @param view The view form which to start the search.
+	 */
+	export function getParentWithViewController(view: View): View;
+	export function updateAutoAdjustScrollInsets(controller: any /* UIViewController */, owner: View): void;
+	export function updateConstraints(controller: any /* UIViewController */, owner: View): void;
+	export function layoutView(controller: any /* UIViewController */, owner: View): void;
+	export function getPositionFromFrame(frame: any /* CGRect */): Position;
+	export function getFrameFromPosition(position: Position, insets?: Position): any; /* CGRect */
+	export function shrinkToSafeArea(view: View, frame: any /* CGRect */): any; /* CGRect */
+	export function expandBeyondSafeArea(view: View, frame: any /* CGRect */): any; /* CGRect */
+	export class UILayoutViewController {
+		public static initWithOwner(owner: WeakRef<View>): UILayoutViewController;
+	}
+	export class UIAdaptivePresentationControllerDelegateImp {
+		public static initWithOwnerAndCallback(owner: WeakRef<View>, whenClosedCallback: Function): UIAdaptivePresentationControllerDelegateImp;
+	}
+	export class UIPopoverPresentationControllerDelegateImp {
+		public static initWithOwnerAndCallback(owner: WeakRef<View>, whenClosedCallback: Function): UIPopoverPresentationControllerDelegateImp;
+	}
+}

package/ui/core/weak-event-listener/index.d.ts

@@ -1,3 +1,19 @@
 import { Observable, EventData } from '../../../data/observable';
-export declare function addWeakEventListener(source: Observable, eventName: string, handler: (eventData: EventData) => void, target: any): void;
-export declare function removeWeakEventListener(source: Observable, eventName: string, handler: (eventData: EventData) => void, target: any): void;
+
+/**
+ * Attaches a WeakEventListener.
+ * @param source Observable class which emits the event.
+ * @param eventName The event name.
+ * @param handler The function which should be called when event occurs.
+ * @param target Subscriber (target) of the event listener. It will be used as a thisArg in the handler function.
+ */
+export function addWeakEventListener(source: Observable, eventName: string, handler: (eventData: EventData) => void, target: any): void;
+
+/**
+ * Removes a WeakEventListener.
+ * @param source Observable class which emits the event.
+ * @param eventName The event name.
+ * @param handler The function which should be called when event occurs.
+ * @param target Subscriber (target) of the event listener. It will be used as a thisArg in the handler function.
+ */
+export function removeWeakEventListener(source: Observable, eventName: string, handler: (eventData: EventData) => void, target: any): void;

package/ui/date-picker/index.d.ts

@@ -0,0 +1,95 @@
+import { View } from '../core/view';
+import { Property } from '../core/properties';
+
+export const yearProperty: Property<DatePicker, number>;
+export const monthProperty: Property<DatePicker, number>;
+export const dayProperty: Property<DatePicker, number>;
+export const dateProperty: Property<DatePicker, Date>;
+export const maxDate: Property<DatePicker, Date>;
+export const minDate: Property<DatePicker, Date>;
+export const iosPreferredDatePickerStyleProperty: Property<DatePicker, number>;
+
+/**
+ * Represents an date picker.
+ *
+ * @nsView DatePicker
+ */
+export class DatePicker extends View {
+	/**
+	 * String value used when hooking to dateChange event.
+	 *
+	 * @nsEvent {PropertyChangeData} dateChange
+	 */
+	public static dateChangeEvent: string;
+
+	/**
+	 * Gets the native [android.widget.DatePicker](http://developer.android.com/reference/android/widget/DatePicker.html) that represents the user interface for this component. Valid only when running on Android OS.
+	 */
+	android: any /* android.widget.DatePicker */;
+
+	/**
+	 * Gets the native iOS [UIDatePicker](http://developer.apple.com/library/prerelease/ios/documentation/UIKit/Reference/UIDatePicker_Class/index.html) that represents the user interface for this component. Valid only when running on iOS.
+	 */
+	ios: any /* UIDatePicker */;
+
+	/**
+	 * Gets or sets the year.
+	 *
+	 * @nsProperty
+	 */
+	year: number;
+
+	/**
+	 * Gets or sets the month. The months start from 1.
+	 *
+	 * @nsProperty
+	 */
+	month: number;
+
+	/**
+	 * Gets or sets the day. The days start from 1.
+	 *
+	 * @nsProperty
+	 */
+	day: number;
+
+	/**
+	 * Gets or sets the entire date.
+	 *
+	 * @nsProperty
+	 */
+	date: Date;
+
+	/**
+	 * Gets or sets the max date.
+	 *
+	 * @nsProperty
+	 */
+	maxDate: Date;
+
+	/**
+	 * Gets or sets the min date.
+	 *
+	 * @nsProperty
+	 */
+	minDate: Date;
+
+	/**
+	 * Gets or set the UIDatePickerStyle of the date picker in iOS 13.4+. Defaults to 0.
+	 * Valid values are numbers:
+	 *  - 0: automatic (system picks the concrete style based on the current platform and date picker mode)
+	 *  - 1: wheels (the date picker displays as a wheel picker)
+	 *  - 2: compact (the date picker displays as a label that when tapped displays a calendar-style editor)
+	 *  - 3: inline  (the date pickers displays as an inline, editable field)
+	 *
+	 * @nsProperty
+	 */
+	iosPreferredDatePickerStyle: number;
+
+	/**
+	 * Gets or sets whether the time should be shown.
+	 *
+	 * @nsProperty
+	 */
+	showTime: boolean;
+}

package/ui/dialogs/index.d.ts

@@ -0,0 +1,311 @@
+export * from './dialogs-common';
+/**
+ * Defines the input type for prompt dialog.
+ */
+export namespace inputType {
+	/**
+	 * Plain text input type.
+	 */
+	export const text: string;
+
+	/**
+	 * Password input type.
+	 */
+	export const password: string;
+
+	/**
+	 * Email input type.
+	 */
+	export const email: string;
+
+	/**
+	 * Number input type.
+	 */
+	export const number: string;
+
+	/**
+	 * Decimal input type.
+	 */
+	export const decimal: string;
+
+	/**
+	 * Phone input type.
+	 */
+	export const phone: string;
+}
+
+/**
+ * Defines the capitalization type for prompt dialog.
+ */
+export namespace capitalizationType {
+	/**
+	 * No automatic capitalization.
+	 */
+	export const none: string;
+
+	/**
+	 * Capitalizes every character.
+	 */
+	export const all: string;
+
+	/**
+	 * Capitalize the first word of each sentence.
+	 */
+	export const sentences: string;
+
+	/**
+	 * Capitalize the first letter of every word.
+	 */
+	export const words: string;
+}
+
+/**
+ * The alert() method displays an alert box with a specified message.
+ * @param message Specifies the text to display in the alert box.
+ */
+export function alert(message: string | number | boolean): Promise<void>;
+
+/**
+ * The alert() method displays an alert box with a specified message.
+ * @param options Specifies the options for the alert box.
+ */
+export function alert(options: AlertOptions): Promise<void>;
+
+/**
+ * The confirm() method displays a dialog box with a specified message.
+ * @param message Specifies the text to display in the confirm box.
+ */
+export function confirm(message: string): Promise<boolean>;
+
+/**
+ * The confirm() method displays a dialog box with a specified message.
+ * @param options Specifies the options for the confirm box.
+ */
+export function confirm(options: ConfirmOptions): Promise<boolean>;
+
+/**
+ * The prompt() method displays a dialog box that prompts the visitor for input.
+ * @param message The text to display in the dialog box.
+ * @param defaultText The default text to display in the input box. Optional.
+ */
+export function prompt(message: string, defaultText?: string): Promise<PromptResult>;
+
+/**
+ * The prompt() method displays a dialog box that prompts the visitor for input.
+ * @param options The options for the dialog box.
+ */
+export function prompt(options: PromptOptions): Promise<PromptResult>;
+
+/**
+ * The login() method displays a login dialog box that prompts the visitor for user name and password.
+ * @param message The text to display in the dialog box.
+ * @param userNameHint The default text to display as a hint in the username input. Optional.
+ * @param passwordHint The default text to display as a hint in the password input. Optional.
+ * @param userName The default text to display in the user name input box. Optional.
+ * @param password The default text to display in the password input box. Optional.
+ */
+export function login(message: string, userNameHint?: string, passwordHint?: string, userName?: string, password?: string): Promise<LoginResult>;
+
+/**
+ * The login() method displays a login dialog box that prompts the visitor for user name and password.
+ * @param message The text to display in the dialog box.
+ * @param userNameHint The default text to display as a hint in the username input. Optional.
+ * @param passwordHint The default text to display as a hint in the password input. Optional.
+ */
+export function login(message: string, userNameHint?: string, passwordHint?: string): Promise<LoginResult>;
+
+/**
+ * The login() method displays a login dialog box that prompts the visitor for user name and password.
+ * @param options The options for the dialog box.
+ */
+export function login(options: LoginOptions): Promise<LoginResult>;
+
+/**
+ * The action() method displays a action box that prompts the visitor to choose some action.
+ * @param message The text to display in the dialog box.
+ * @param cancelButtonText The text to display in the cancel button.
+ * @param actions List of available actions.
+ */
+export function action(message: string, cancelButtonText: string, actions: Array<string>): Promise<string>;
+
+/**
+ * The action() method displays a action box that prompts the visitor to choose some action.
+ * @param options The options for the dialog box.
+ */
+export function action(options: ActionOptions): Promise<string>;
+
+/**
+ * Provides options for the dialog.
+ */
+export interface CancelableOptions {
+	/**
+	 * [Android only] Gets or sets if the dialog can be canceled by taping outside of the dialog.
+	 */
+	cancelable?: boolean;
+
+	/**
+	 * [Android only] Sets the theme of the Dialog. Usable themes can be found: https://developer.android.com/reference/android/R.style
+	 */
+	theme?: number;
+}
+
+/**
+ * Provides options for the dialog.
+ */
+export interface ActionOptions extends CancelableOptions {
+	/**
+	 * Gets or sets the dialog title.
+	 */
+	title?: string;
+
+	/**
+	 * Gets or sets the dialog message.
+	 */
+	message?: string;
+
+	/**
+	 * Gets or sets the Cancel button text.
+	 */
+	cancelButtonText?: string;
+
+	/**
+	 * Gets or sets the list of available actions.
+	 */
+	actions?: Array<string>;
+
+	/**
+	 * [iOS only] Gets or sets the indexes of destructive actions.
+	 */
+	destructiveActionsIndexes?: Array<number>;
+}
+
+/**
+ * Provides options for the dialog.
+ */
+export interface DialogOptions extends CancelableOptions {
+	/**
+	 * Gets or sets the dialog title.
+	 */
+	title?: string;
+
+	/**
+	 * Gets or sets the dialog message.
+	 */
+	message?: string;
+}
+
+/**
+ * Provides options for the alert.
+ */
+export interface AlertOptions extends DialogOptions {
+	/**
+	 * Gets or sets the OK button text.
+	 */
+	okButtonText?: string;
+}
+
+/**
+ * Provides options for the confirm dialog.
+ */
+export interface ConfirmOptions extends AlertOptions {
+	/**
+	 * Gets or sets the Cancel button text.
+	 */
+	cancelButtonText?: string;
+
+	/**
+	 * Gets or sets the neutral button text.
+	 */
+	neutralButtonText?: string;
+}
+
+/**
+ * Provides options for the prompt dialog.
+ */
+export interface PromptOptions extends ConfirmOptions {
+	/**
+	 * Gets or sets the default text to display in the input box.
+	 */
+	defaultText?: string;
+
+	/**
+	 * Gets or sets the prompt input type (plain text, password, or email).
+	 */
+	inputType?: string;
+
+	/**
+	 * Gets or sets the prompt capitalizationType (none, all, sentences, or words).
+	 */
+	capitalizationType?: string;
+}
+
+/**
+ * Provides options for the login dialog.
+ */
+export interface LoginOptions extends ConfirmOptions {
+	/**
+	 * Gets or sets the default text to display as hint in the user name input box.
+	 */
+	userNameHint?: string;
+
+	/**
+	 * Gets or sets the default text to display as hint in the password input box.
+	 */
+	passwordHint?: string;
+
+	/**
+	 * Gets or sets the default text to display in the user name input box.
+	 */
+	userName?: string;
+
+	/**
+	 * Gets or sets the default text to display in the password input box.
+	 */
+	password?: string;
+}
+
+/**
+ * Provides result data from the prompt dialog.
+ */
+export interface PromptResult {
+	/**
+	 * Gets or sets the prompt dialog boolean result.
+	 */
+	result: boolean;
+
+	/**
+	 *  Gets or sets the text entered in the prompt dialog.
+	 */
+	text: string;
+}
+
+/**
+ * Provides result data from the login dialog.
+ */
+export interface LoginResult {
+	/**
+	 * Gets or sets the login dialog boolean result.
+	 */
+	result: boolean;
+
+	/**
+	 *  Gets or sets the user entered in the login dialog.
+	 */
+	userName: string;
+
+	/**
+	 *  Gets or sets the password entered in the login dialog.
+	 */
+	password: string;
+}
+
+/**
+ * Singular rollup for convenience of all dialog methods
+ */
+export declare const Dialogs: {
+	alert: typeof alert;
+	confirm: typeof confirm;
+	prompt: typeof prompt;
+	login: typeof login;
+	action: typeof action;
+};

package/ui/editable-text-base/index.d.ts

@@ -0,0 +1,142 @@
+import { TextBase } from '../text-base';
+import { Color } from '../../color';
+import { FormattedString } from '../text-base/formatted-string';
+import { Style } from '../styling/style';
+import { Property, CssProperty } from '../core/properties';
+import { CoreTypes } from '../../core-types';
+
+/**
+ * Represents the base class for all editable text views.
+ *
+ * @nsView EditableTextBase
+ */
+export class EditableTextBase extends TextBase {
+	/**
+	 * String value used when hooking to the blur event.
+	 *
+	 * @nsEvent blurEvent
+	 */
+	public static blurEvent: string;
+	/**
+	 * String value used when hooking to the focus event.
+	 *
+	 * @nsEvent focusEvent
+	 */
+	public static focusEvent: string;
+	/**
+	 * String value used when hooking to the textChange event.
+	 *
+	 * @nsEvent {PropertyChangeData} textChangeEvent
+	 */
+	public static textChangeEvent: string;
+
+	/**
+	 * Gets or sets the soft keyboard type.
+	 *
+	 * @nsProperty
+	 */
+	keyboardType: CoreTypes.KeyboardInputType;
+
+	/**
+	 * Gets or sets the soft keyboard return key flavor.
+	 *
+	 * @nsProperty
+	 */
+	returnKeyType: CoreTypes.ReturnKeyButtonType;
+
+	/**
+	 * Gets or sets a value indicating when the text property will be updated.
+	 *
+	 * @nsProperty
+	 */
+	updateTextTrigger: CoreTypes.UpdateTextTriggerType;
+
+	/**
+	 * Gets or sets the autocapitalization type.
+	 *
+	 * @nsProperty
+	 */
+	autocapitalizationType: CoreTypes.AutocapitalizationInputType;
+
+	/**
+	 * Gets or sets the autofill type.
+	 *
+	 * @nsProperty
+	 */
+	autofillType: CoreTypes.AutofillType;
+
+	/**
+	 * Gets or sets whether the instance is editable.
+	 *
+	 * @nsProperty
+	 */
+	editable: boolean;
+
+	/**
+	 * Enables or disables autocorrection.
+	 *
+	 * @nsProperty
+	 */
+	autocorrect: boolean;
+
+	/**
+	 * Gets or sets the placeholder text.
+	 *
+	 * @nsProperty
+	 */
+	hint: string;
+
+	/**
+	 * Limits input to a certain number of characters.
+	 *
+	 * @nsProperty
+	 */
+	maxLength: number;
+
+	/**
+	 * Gets or sets the color of the placeholder text
+	 *
+	 * @nsProperty
+	 */
+	placeholderColor: Color;
+
+	/**
+	 * Format input values
+	 * Note: useful for input masking/formatting
+	 */
+	valueFormatter: (value: string) => string;
+
+	/**
+	 * Hides the soft input method, ususally a soft keyboard.
+	 */
+	dismissSoftInput(): void;
+
+	//@private
+	/**
+	 * @private
+	 */
+	public _setInputType(inputType: number): void;
+	//@endprivate
+
+	/**
+	 * Set the selection anchor to start and the selection edge to stop
+	 */
+	public setSelection(start: number, stop?: number);
+}
+
+export const keyboardTypeProperty: Property<EditableTextBase, CoreTypes.KeyboardInputType>;
+export const returnKeyTypeProperty: Property<EditableTextBase, CoreTypes.ReturnKeyButtonType>;
+export const editableProperty: Property<EditableTextBase, boolean>;
+export const updateTextTriggerProperty: Property<EditableTextBase, CoreTypes.UpdateTextTriggerType>;
+export const autocapitalizationTypeProperty: Property<EditableTextBase, CoreTypes.AutocapitalizationInputType>;
+export const autocorrectProperty: Property<EditableTextBase, boolean>;
+export const hintProperty: Property<EditableTextBase, string>;
+export const placeholderColorProperty: CssProperty<Style, Color>;
+export const maxLengthProperty: Property<EditableTextBase, number>;
+
+//@private
+/**
+ * @private
+ */
+export function _updateCharactersInRangeReplacementString(formattedText: FormattedString, rangeLocation: number, rangeLength: number, replacementString: string): void;
+//@endprivate

package/ui/embedding/index.d.ts

@@ -0,0 +1,10 @@
+import type { View } from '../../ui/core/view';
+
+/**
+ * Whether the app is embedded into a host project or standalone project
+ */
+export function isEmbedded(): boolean;
+
+export function setEmbeddedView(view: View | undefined): void;
+
+export function getEmbeddedView(): View;

package/ui/frame/fragment.d.ts

@@ -0,0 +1,5 @@
+export function ensureFragmentClass(): void;
+
+export function setFragmentClass(clazz: any): void;
+
+export let fragmentClass: any;

package/ui/frame/fragment.transitions.d.ts

@@ -0,0 +1,43 @@
+import { NavigationTransition, BackstackEntry } from '.';
+
+/**
+ * @private
+ */
+export function _setAndroidFragmentTransitions(animated: boolean, navigationTransition: NavigationTransition, currentEntry: BackstackEntry, newEntry: BackstackEntry, frameId: number, fragmentTransaction: any, isNestedDefaultTransition?: boolean): void;
+/**
+ * @private
+ */
+export function _getAnimatedEntries(frameId: number): Set<BackstackEntry>;
+/**
+ * @private
+ * Called once fragment is recreated after it was destroyed.
+ * Reapply animations and transitions from entry to fragment if any.
+ */
+export function _updateTransitions(entry: BackstackEntry): void;
+/**
+ * @private
+ * Called once fragment is going to reappear from backstack.
+ * Reverse transitions from entry to fragment if any.
+ */
+export function _reverseTransitions(previousEntry: BackstackEntry, currentEntry: BackstackEntry): boolean;
+/**
+ * @private
+ * Called when entry is removed from backstack (either back navigation or
+ * navigate with clear history). Removes all animations and transitions from entry
+ * and fragment and clears all listeners in order to prevent memory leaks.
+ */
+export function _clearEntry(entry: BackstackEntry): void;
+/**
+ * @private
+ * Called when fragment is destroyed because activity is destroyed.
+ * Removes all animations and transitions but keeps them on the entry
+ * in order to reapply them when new fragment is created for the same entry.
+ */
+export function _clearFragment(entry: BackstackEntry): void;
+
+/**
+ * @private
+ * nativeTransition: androidx.transition.Transition
+ */
+export function addNativeTransitionListener(entry: any, nativeTransition: any): any;
+//@endprivate