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

package/ui/layouts/grid-layout/index.d.ts

@@ -0,0 +1,201 @@
+import { LayoutBase } from '../layout-base';
+import { View } from '../../core/view';
+import { Property } from '../../core/properties';
+
+/**
+ * Defines row/column specific properties that apply to GridLayout elements.
+ */
+export class ItemSpec {
+	constructor();
+	constructor(value: number, type: GridUnitType);
+
+	/**
+	 * Gets the actual length of an ItemSpec.
+	 */
+	actualLength: number;
+
+	/**
+	 * Returns unit type of this ItemSpec instance.
+	 */
+	gridUnitType: GridUnitType;
+
+	/**
+	 * Returns true if this ItemSpec instance holds
+	 * an absolute (pixel) value.
+	 */
+	isAbsolute: boolean;
+
+	/**
+	 * Returns true if this GridLength instance is
+	 * automatic (not specified).
+	 */
+	isAuto: boolean;
+
+	/**
+	 * Returns true if this ItemSpec instance holds weighted proportion
+	 * of available space.
+	 */
+	isStar: boolean;
+
+	/**
+	 * Returns value part of this ItemSpec instance.
+	 */
+	value: number;
+}
+
+/**
+ * Defines a rectangular layout area that consists of columns and rows.
+ *
+ * @nsView GridLayout
+ */
+export class GridLayout extends LayoutBase {
+	/**
+	 * A string value representing row heights delimited with commas.
+	 *
+	 * Valid values: an absolute number, auto, or *:
+	 *
+	 * @nsProperty
+	 */
+	rows: string;
+	/**
+	 * A string value representing column widths delimited with commas.
+	 *
+	 * Valid values: an absolute number, auto, or *:
+	 *
+	 * @nsProperty
+	 */
+	columns: string;
+
+	/**
+	 * Gets the value of the Column attached property from a given View.
+	 */
+	static getColumn(view: View): number;
+
+	/**
+	 * Sets the value of the Column attached property to a given View.
+	 */
+	static setColumn(view: View, value: number): void;
+
+	/**
+	 * Gets the value of the ColumnSpan attached property from a given View.
+	 */
+	static getColumnSpan(view: View): number;
+
+	/**
+	 * Sets the value of the ColumnSpan attached property to a given View.
+	 */
+	static setColumnSpan(view: View, value: number): void;
+
+	/**
+	 * Gets the value of the Row attached property from a given View.
+	 */
+	static getRow(view: View): number;
+
+	/**
+	 * Sets the value of the Row attached property to a given View.
+	 */
+	static setRow(view: View, value: number): void;
+
+	/**
+	 * Gets the value of the RowSpan attached property from a given View.
+	 */
+	static getRowSpan(view: View): number;
+
+	/**
+	 * Sets the value of the RowSpan attached property to a given View.
+	 */
+	static setRowSpan(view: View, value: number): void;
+
+	/**
+	 * Adds a column specification to a GridLayout.
+	 */
+	public addColumn(itemSpec: ItemSpec): void;
+
+	/**
+	 * Adds a row specification to a GridLayout.
+	 */
+	public addRow(itemSpec: ItemSpec): void;
+
+	/**
+	 * Adds a child at specific cell in GridLayout. Optional rowSpan and columnSpan attributes
+	 */
+	public addChildAtCell(view: View, row: number, column: number, rowSpan?: number, columnSpan?: number): void;
+
+	/**
+	 * Removes a column specification from a GridLayout.
+	 */
+	public removeColumn(itemSpec: ItemSpec): void;
+
+	/**
+	 * Removes all column specifications from a GridLayout.
+	 */
+	public removeColumns(): void;
+
+	/**
+	 * Removes a row specification from a GridLayout.
+	 */
+	public removeRow(itemSpec: ItemSpec): void;
+
+	/**
+	 * Removes all row specifications from a GridLayout.
+	 */
+	public removeRows(): void;
+
+	/**
+	 * Gets array of column specifications defined on this instance of GridLayout.
+	 */
+	public getColumns(): Array<ItemSpec>;
+
+	/**
+	 * Gets array of row specifications defined on this instance of GridLayout.
+	 */
+	public getRows(): Array<ItemSpec>;
+
+	//@private
+	/**
+	 * @private
+	 */
+	public _onRowAdded(itemSpec: ItemSpec): void;
+	/**
+	 * @private
+	 */
+	public _onColumnAdded(itemSpec: ItemSpec): void;
+	/**
+	 * @private
+	 */
+	public _onRowRemoved(itemSpec: ItemSpec, index: number): void;
+	/**
+	 * @private
+	 */
+	public _onColumnRemoved(itemSpec: ItemSpec, index: number): void;
+	//@endprivate
+}
+
+/**
+ * Represents the observable property backing the column property.
+ */
+export const columnProperty: Property<View, number>;
+
+/**
+ * Represents the observable property backing the columnSpan property.
+ */
+export const columnSpanProperty: Property<View, number>;
+
+/**
+ * Represents the observable property backing the row property.
+ */
+export const rowProperty: Property<View, number>;
+
+/**
+ * Represents the observable property backing the rowSpan property.
+ */
+export const rowSpanProperty: Property<View, number>;
+
+export type GridUnitType = 'pixel' | 'star' | 'auto';
+export namespace GridUnitType {
+	export const PIXEL: 'pixel';
+	export const STAR: 'star';
+	export const AUTO: 'auto';
+	export function isValid(value: any): boolean;
+	export function parse(value: string): GridUnitType;
+}

package/ui/layouts/index.d.ts

@@ -2,8 +2,7 @@ export { AbsoluteLayout } from './absolute-layout';
 export { DockLayout } from './dock-layout';
 export { FlexboxLayout } from './flexbox-layout';
 export { GridLayout, GridUnitType, ItemSpec } from './grid-layout';
-export { RootLayout, getRootLayout } from './root-layout';
-export type { RootLayoutOptions, ShadeCoverOptions } from './root-layout';
+export { RootLayout, getRootLayout, RootLayoutOptions, ShadeCoverOptions } from './root-layout';
 export { StackLayout } from './stack-layout';
 export { WrapLayout } from './wrap-layout';
 export { LayoutBase } from './layout-base';

package/ui/layouts/layout-base.d.ts

@@ -0,0 +1,119 @@
+import { CoreTypes } from '../../core-types';
+import { View, CustomLayoutView } from '../core/view';
+import { Property } from '../core/properties';
+
+/**
+ * Base class for all views that supports children positioning.
+ */
+export class LayoutBase extends CustomLayoutView {
+	/**
+	 * Returns the number of children in this Layout.
+	 */
+	getChildrenCount(): number;
+
+	/**
+	 * Returns the view at the specified position.
+	 * @param index The position at which to get the child from.
+	 */
+	getChildAt(index: number): View;
+
+	/**
+	 * Returns the position of the child view
+	 * @param child The child view that we are looking for.
+	 */
+	getChildIndex(child: View): number;
+
+	/**
+	 * Adds the view to children array.
+	 * @param view The view to be added to the end of the children array.
+	 */
+	addChild(view: View): void;
+
+	/**
+	 * Inserts the view to children array at the specified index.
+	 * @param view The view to be added to the end of the children array.
+	 * @param atIndex The insertion index.
+	 */
+	insertChild(child: View, atIndex: number): void;
+
+	/**
+	 * Removes the specified view from the children array.
+	 * @param view The view to remove from the children array.
+	 */
+	removeChild(view: View): void;
+
+	/**
+	 * Removes all views in this layout.
+	 */
+	removeChildren(): void;
+
+	/**
+	 * INTERNAL. Used by the layout system.
+	 */
+	_registerLayoutChild(child: View): void;
+
+	/**
+	 * INTERNAL. Used by the layout system.
+	 */
+	_unregisterLayoutChild(child: View): void;
+
+	/**
+	 * Calls the callback for each child that should be laid out.
+	 * @param callback The callback
+	 */
+	eachLayoutChild(callback: (child: View, isLast: boolean) => void): void;
+
+	/**
+	 * Gets or sets padding style property.
+	 *
+	 * @nsProperty
+	 */
+	padding: string | CoreTypes.LengthType;
+
+	/**
+	 * Specify the bottom padding of this layout.
+	 *
+	 * @nsProperty
+	 */
+	paddingBottom: CoreTypes.LengthType;
+
+	/**
+	 * Specify the left padding of this layout.
+	 *
+	 * @nsProperty
+	 */
+	paddingLeft: CoreTypes.LengthType;
+
+	/**
+	 * Specify the right padding of this layout.
+	 *
+	 * @nsProperty
+	 */
+	paddingRight: CoreTypes.LengthType;
+
+	/**
+	 * Specify the top padding of this layout.
+	 *
+	 * @nsProperty
+	 */
+	paddingTop: CoreTypes.LengthType;
+
+	/**
+	 * Gets or sets a value indicating whether to clip the content of this layout.
+	 *
+	 * @nsProperty
+	 */
+	clipToBounds: boolean;
+
+	/**
+	 * Gets or sets a value indicating whether touch event should pass through to a parent view of the
+	 * layout container in case an interactive child view did not handle it.
+	 * Default value of this property is false. This does not affect the appearance of the view.
+	 *
+	 * @nsProperty
+	 */
+	isPassThroughParentEnabled: boolean;
+}
+
+export const clipToBoundsProperty: Property<LayoutBase, boolean>;
+export const isPassThroughParentEnabledProperty: Property<LayoutBase, boolean>;

package/ui/layouts/root-layout/index.d.ts

@@ -0,0 +1,48 @@
+import { GridLayout } from '../grid-layout';
+import { View } from '../../core/view';
+
+/**
+ * @nsView RootLayout
+ */
+export class RootLayout extends GridLayout {
+	open(view: View, options: RootLayoutOptions = {}): Promise<void>;
+	close(view: View, exitTo?: TransitionAnimation): Promise<void>;
+	topmost(): View;
+	bringToFront(view: View, animated?: boolean): Promise<void>;
+	closeAll(): Promise<void[]>;
+	getShadeCover(): View;
+	openShadeCover(options: ShadeCoverOptions = {}): Promise<void>;
+	closeShadeCover(shadeCoverOptions: ShadeCoverOptions = {}): Promise<void>;
+}
+
+export function getRootLayout(): RootLayout;
+
+export interface RootLayoutOptions {
+	shadeCover?: ShadeCoverOptions;
+	animation?: {
+		enterFrom?: TransitionAnimation;
+		exitTo?: TransitionAnimation;
+	};
+}
+
+export interface ShadeCoverOptions {
+	opacity?: number;
+	color?: string;
+	tapToClose?: boolean;
+	animation?: {
+		enterFrom?: TransitionAnimation; // only applied if first one to be opened
+		exitTo?: TransitionAnimation; // only applied if last one to be closed
+	};
+	ignoreShadeRestore?: boolean;
+}
+
+export interface TransitionAnimation {
+	translateX?: number;
+	translateY?: number;
+	scaleX?: number;
+	scaleY?: number;
+	rotate?: number; // in degrees
+	opacity?: number;
+	duration?: number; // in milliseconds
+	curve?: any; // CoreTypes.AnimationCurve (string, cubicBezier, etc.)
+}

package/ui/layouts/stack-layout/index.d.ts

@@ -0,0 +1,22 @@
+import { LayoutBase } from '../layout-base';
+import { Property } from '../../core/properties';
+import { CoreTypes } from '../../../core-types';
+
+/**
+ * A Layout that arranges its children horizontally or vertically. The direction can be set by orientation property.
+ *
+ * @nsView StackLayout
+ */
+export class StackLayout extends LayoutBase {
+	/**
+	 * Gets or sets if layout should be horizontal or vertical.
+	 * The default value is vertical.
+	 * @nsProperty
+	 */
+	orientation: CoreTypes.OrientationType;
+}
+
+/**
+ * Represents the observable property backing the orientation property of each StackLayout instance.
+ */
+export const orientationProperty: Property<StackLayout, CoreTypes.OrientationType>;

package/ui/layouts/wrap-layout/index.d.ts

@@ -0,0 +1,51 @@
+import { LayoutBase } from '../layout-base';
+import { Length } from '../../styling/style-properties';
+import { Property } from '../../core/properties';
+import { CoreTypes } from '../../../core-types';
+
+/**
+ * WrapLayout position children in rows or columns depending on orientation property
+ * until space is filled and then wraps them on new row or column.
+ *
+ * @nsView WrapLayout
+ */
+export class WrapLayout extends LayoutBase {
+	/**
+	 * Gets or sets the flow direction. Default value is horizontal.
+	 * If orientation is horizontal items are arranged in rows, else items are arranged in columns.
+	 *
+	 * @nsProperty
+	 */
+	orientation: CoreTypes.OrientationType;
+
+	/**
+	 * Gets or sets the width used to measure and layout each child.
+	 * Default value is Number.NaN which does not restrict children.
+	 *
+	 * @nsProperty
+	 */
+	itemWidth: CoreTypes.LengthType;
+
+	/**
+	 * Gets or sets the height used to measure and layout each child.
+	 * Default value is Number.NaN which does not restrict children.
+	 *
+	 * @nsProperty
+	 */
+	itemHeight: CoreTypes.LengthType;
+}
+
+/**
+ * Represents the observable property backing the orientation property of each WrapLayout instance.
+ */
+export const orientationProperty: Property<WrapLayout, CoreTypes.OrientationType>;
+
+/**
+ * Represents the observable property backing the itemWidth property of each WrapLayout instance.
+ */
+export const itemWidthProperty: Property<WrapLayout, CoreTypes.LengthType>;
+
+/**
+ * Represents the observable property backing the itemHeight property of each WrapLayout instance.
+ */
+export const itemHeightProperty: Property<WrapLayout, CoreTypes.LengthType>;

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

@@ -0,0 +1,43 @@
+import { View } from '../core/view';
+import { Property } from '../core/properties';
+import { ItemsSource } from './list-picker-common';
+
+/**
+ * Represents an list picker.
+ *
+ * @nsView ListPicker
+ */
+export class ListPicker extends View {
+	/**
+	 * @nsEvent {PropertyChangeData} selectedIndexChange
+	 */
+	public static selectedIndexChangeEvent: string;
+
+	/**
+	 * Gets the native [android.widget.NumberPicker](http://developer.android.com/reference/android/widget/NumberPicker.html) that represents the user interface for this component. Valid only when running on Android OS.
+	 */
+	android: any /* android.widget.NumberPicker */;
+
+	/**
+	 * Gets the native iOS [UIPickerView](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 /* UIPickerView */;
+
+	/**
+	 * Gets or sets the selected index.
+	 *
+	 * @nsProperty
+	 */
+	selectedIndex: number;
+
+	/**
+	 * Gets or set the items collection of the ListPicker.
+	 * The items property can be set to an array or an object defining length and getItem(index) method.
+	 *
+	 * @nsProperty
+	 */
+	items: any[] | ItemsSource;
+}
+
+export const selectedIndexProperty: Property<ListPicker, number>;
+export const itemsProperty: Property<ListPicker, any[] | ItemsSource>;