@nativescript/angular 21.0.1-alpha.9 → 21.2.0-alpha.0

package/types/nativescript-angular.d.ts

@@ -1,14 +1,14 @@
 import * as _nativescript_core from '@nativescript/core';
 import { View, ContentView, LayoutBase, IDevice, Page, Device, GridLayout, Color, Frame, ActionItem, NavigationButton, ListView, ObservableArray, Template, CoreTypes, ItemEventData, TabView, NavigatedData, ViewBase, RootLayout, ShowModalOptions, NavigationTransition, Folder, File, Switch, DatePicker, TimePicker, Slider, KeyframeAnimation } from '@nativescript/core';
 import * as i0 from '@angular/core';
-import { InjectionToken, EmbeddedViewRef, ComponentRef, NgModuleRef, ApplicationRef, Provider, EnvironmentProviders, PlatformRef, ɵNgModuleFactory as _NgModuleFactory, Type, CompilerOptions, NgZone, Injector, NgModuleFactory, StaticProvider, Sanitizer, ApplicationConfig as ApplicationConfig$1, ViewContainerRef, ComponentFactoryResolver, TemplateRef, ElementRef, OnInit, OnDestroy, Renderer2, EventEmitter, ChangeDetectorRef, ComponentFactory, AfterViewInit, OnChanges, SimpleChanges, DoCheck, AfterContentInit, IterableDiffer, IterableDiffers, ErrorHandler, RendererStyleFlags2, RendererType2, RendererFactory2, QueryList, EnvironmentInjector, ModuleWithProviders, NgZoneOptions } from '@angular/core';
+import { InjectionToken, EmbeddedViewRef, ComponentRef, NgModuleRef, ApplicationRef, Provider, EnvironmentProviders, PlatformRef, ɵNgModuleFactory as _NgModuleFactory, Type, CompilerOptions, NgZone, Injector, NgModuleFactory, StaticProvider, Sanitizer, ApplicationConfig as ApplicationConfig$1, ViewContainerRef, ComponentFactoryResolver, TemplateRef, ElementRef, OnInit, OnDestroy, Renderer2, EventEmitter, ChangeDetectorRef, ComponentFactory, AfterViewInit, OnChanges, SimpleChanges, DoCheck, AfterContentInit, IterableDiffer, IterableDiffers, ErrorHandler, RendererStyleFlags2, RendererType2, RendererFactory2, EnvironmentInjector, QueryList, ModuleWithProviders, NgZoneOptions } from '@angular/core';
 import * as _nativescript_angular from '@nativescript/angular';
 import * as rxjs from 'rxjs';
 import { Observable, ReplaySubject, Subject, BehaviorSubject } from 'rxjs';
 import * as i1 from '@angular/common';
 import { LocationStrategy, XhrFactory } from '@angular/common';
 import * as i1$2 from '@angular/router';
-import { Params, UrlSegmentGroup, ActivatedRouteSnapshot, RouteReuseStrategy, DetachedRouteHandle, Router, NavigationExtras, UrlTree, NavigationBehaviorOptions, ActivatedRoute, RouterOutletContract, Data, Routes, ExtraOptions, RouterFeatures } from '@angular/router';
+import { Params, UrlSegmentGroup, ActivatedRouteSnapshot, RouteReuseStrategy, DetachedRouteHandle, RouterOutletContract, ActivatedRoute, Data, QueryParamsHandling, UrlTree, IsActiveMatchOptions, Router, NavigationExtras, NavigationBehaviorOptions, Routes, ExtraOptions, RouterFeatures } from '@angular/router';
 import * as i1$1 from '@angular/forms';
 import { ControlValueAccessor } from '@angular/forms';
 import { AnimationDriver, ɵAnimationEngine as _AnimationEngine, ɵAnimationStyleNormalizer as _AnimationStyleNormalizer, ɵWebAnimationsStyleNormalizer as _WebAnimationsStyleNormalizer } from '@angular/animations/browser';
@@ -307,7 +307,11 @@ declare class NativeScriptDocument {
 }
 declare const COMMON_PROVIDERS: StaticProvider[];
 declare const platformNativeScript: (extraProviders?: StaticProvider[]) => PlatformRef;
+interface BootstrapContext {
+    platformRef?: PlatformRef;
+}
 declare function bootstrapApplication(rootComponent: Type<any>, options?: ApplicationConfig$1): Promise<i0.ApplicationRef>;
+declare function createApplication(options?: ApplicationConfig$1, context?: BootstrapContext): Promise<i0.ApplicationRef>;
 interface HmrOptions {
     /**
      * A factory function that returns either Module type or NgModuleFactory type.
@@ -1077,6 +1081,11 @@ declare class NativeDialogConfig<D = any> {
      * content will be rendered.
      */
     viewContainerRef?: ViewContainerRef;
+    /**
+     * Injector used for the instantiation of the component to be attached. If provided,
+     * takes precedence over the injector indirectly provided by `ViewContainerRef`.
+     */
+    injector?: Injector;
     /** Where to render the actual dialog in. By default it renders using the native view of the ViewContainerRef */
     renderIn?: 'root' | 'viewContainerRef' | View;
     /** ID for the dialog. If omitted, a unique one will be generated. */
@@ -1093,7 +1102,9 @@ declare class NativeDialogConfig<D = any> {
      * the `HashLocationStrategy`).
      */
     closeOnNavigation?: boolean;
-    /** Alternate `ComponentFactoryResolver` to use when resolving the associated component. */
+    /** Alternate `ComponentFactoryResolver` to use when resolving the associated component.
+     * @deprecated
+     */
     componentFactoryResolver?: ComponentFactoryResolver;
     nativeOptions?: NativeShowModalOptions;
     /**
@@ -2390,96 +2401,295 @@ declare class NSRouteReuseStrategy implements RouteReuseStrategy, OnDestroy {
     static ɵprov: i0.ɵɵInjectableDeclaration<NSRouteReuseStrategy>;
 }
 
-type ExtendedNavigationExtras = NavigationExtras & NavigationOptions;
-type ExtendedNavigationBehaviorOptions = NavigationBehaviorOptions & NavigationOptions;
-interface BackNavigationOptions {
-    outlets?: Array<string>;
-    relativeTo?: ActivatedRoute | null;
+declare class PageRoute {
+    activatedRoute: BehaviorSubject<ActivatedRoute>;
+    constructor(startRoute: ActivatedRoute);
 }
-declare class RouterExtensions {
-    router: Router;
-    locationStrategy: NSLocationStrategy;
-    frameService: FrameService;
-    constructor(router: Router, locationStrategy: NSLocationStrategy, frameService: FrameService);
-    navigate(commands: any[], extras?: ExtendedNavigationExtras): Promise<boolean>;
-    navigateByUrl(url: string | UrlTree, options?: ExtendedNavigationBehaviorOptions): Promise<boolean>;
-    back(backNavigationOptions?: BackNavigationOptions): void;
-    canGoBack(backNavigationOptions?: BackNavigationOptions): boolean;
-    backToPreviousPage(): void;
-    canGoBackToPreviousPage(): boolean;
-    private backOutlets;
-    private findOutletsToBack;
-    private findOutletsRecursive;
-    private findOutletByRoute;
-    static ɵfac: i0.ɵɵFactoryDeclaration<RouterExtensions, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<RouterExtensions>;
+declare class PageRouterOutlet implements OnDestroy, RouterOutletContract {
+    private parentContexts;
+    private location;
+    private locationStrategy;
+    private resolver;
+    private changeDetector;
+    private pageFactory;
+    private routeReuseStrategy;
+    private ngZone;
+    private router;
+    private environmentInjector;
+    private inputBinder;
+    private activated;
+    private _activatedRoute;
+    private detachedLoaderFactory;
+    private outlet;
+    private name;
+    private isEmptyOutlet;
+    private viewUtil;
+    private frame;
+    private postNavFunction;
+    attachEvents: EventEmitter<unknown>;
+    detachEvents: EventEmitter<unknown>;
+    activateEvents: EventEmitter<any>;
+    deactivateEvents: EventEmitter<any>;
+    get isActivated(): boolean;
+    get activatedComponentRef(): ComponentRef<any> | null;
+    get component(): unknown;
+    get activatedRoute(): ActivatedRoute;
+    get activatedRouteData(): Data;
+    constructor();
+    setActionBarVisibility(actionBarVisibility: string): void;
+    ngOnDestroy(): void;
+    deactivate(): void;
+    /**
+     * Called when the `RouteReuseStrategy` instructs to detach the subtree
+     */
+    detach(): ComponentRef<any>;
+    /**
+     * Called when the `RouteReuseStrategy` instructs to re-attach a previously detached subtree
+     */
+    attach(ref: ComponentRef<any>, activatedRoute: ActivatedRoute): void;
+    private isFinalPageRouterOutlet;
+    /**
+     * Called by the Router to instantiate a new component during the commit phase of a navigation.
+     * This method in turn is responsible for calling the `routerOnActivate` hook of its child.
+     */
+    activateWith(activatedRoute: ActivatedRoute, resolver: ComponentFactoryResolver | EnvironmentInjector | null): void;
+    private activateOnGoForward;
+    private loadComponentInPage;
+    private markActivatedRoute;
+    private getComponentType;
+    private getOutlet;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PageRouterOutlet, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PageRouterOutlet, "page-router-outlet", never, {}, { "activateEvents": "activate"; "deactivateEvents": "deactivate"; }, never, never, true, never>;
+}
+
+interface ComponentInputBindingOptions {
+    queryParams?: boolean;
+    unmatchedInputBehavior?: 'alwaysUndefined' | 'undefinedIfStale';
 }
 
-type QueryParamsHandling = 'merge' | 'preserve' | '';
 /**
  * The nsRouterLink directive lets you link to specific parts of your app.
  *
  * Consider the following route configuration:
  * ```
- * [{ path: "/user", component: UserCmp }]
+ * [{ path: 'user/:name', component: UserCmp }]
  * ```
  *
  * When linking to this `User` route, you can write:
  *
  * ```
- * <a [nsRouterLink]="["/user"]">link to user component</a>
+ * <Label [nsRouterLink]="['/user/bob']" text="link to user component"></Label>
  * ```
  *
- * NSRouterLink expects the value to be an array of path segments, followed by the params
- * for that level of routing. For instance `["/team", {teamId: 1}, "user", {userId: 2}]`
- * means that we want to generate a link to `/team;teamId=1/user;userId=2`.
+ * You can use dynamic values to generate the link.
+ * For a dynamic link, pass an array of path segments,
+ * followed by the params for each segment.
+ * For example, `['/team', teamId, 'user', userName, {details: true}]`
+ * generates a link to `/team/11/user/bob;details=true`.
+ *
+ * Multiple static segments can be merged into one term and combined with
+ * dynamic segments. For example, `['/team/11/user', userName, {details: true}]`
+ *
+ * The input that you provide to the link is treated as a delta to the current
+ * URL. For instance, suppose the current URL is `/user/(box//aux:team)`. The
+ * link `<Label [nsRouterLink]="['/user/jim']">Jim</Label>` creates the URL
+ * `/user/(jim//aux:team)`.
+ * See {@link Router#createUrlTree} for more information.
+ *
+ * @usageNotes
+ *
+ * You can use absolute or relative paths in a link, set query parameters,
+ * control how parameters are handled, and keep a history of navigation states.
+ *
+ * ### Relative link paths
  *
  * The first segment name can be prepended with `/`, `./`, or `../`.
- * If the segment begins with `/`, the router will look up the route from the root of the app.
- * If the segment begins with `./`, or doesn"t begin with a slash, the router will
- * instead look in the current component"s children for the route.
- * And if the segment begins with `../`, the router will go up one level.
+ * * If the first segment begins with `/`, the router looks up the route from
+ * the root of the app.
+ * * If the first segment begins with `./`, or doesn't begin with a slash, the
+ * router looks in the children of the current activated route.
+ * * If the first segment begins with `../`, the router goes up one level in the
+ * route tree.
+ *
+ * ### Setting and handling query params and fragments
+ *
+ * The following link adds a query parameter and a fragment to the generated URL:
+ *
+ * ```html
+ * <Label [nsRouterLink]="['/user/bob']" [queryParams]="{debug: true}"
+ * fragment="education" text="link to user component"></Label>
+ * ```
+ *
+ * By default, the directive constructs the new URL using the given query
+ * parameters. The example generates the link: `/user/bob?debug=true#education`.
+ *
+ * You can instruct the directive to handle query parameters differently
+ * by specifying the `queryParamsHandling` option in the link.
+ * Allowed values are:
+ *
+ *  - `'merge'`: Merge the given `queryParams` into the current query params.
+ *  - `'preserve'`: Preserve the current query params.
+ *
+ * For example:
+ *
+ * ```html
+ * <Label [nsRouterLink]="['/user/bob']" [queryParams]="{debug: true}"
+ * queryParamsHandling="merge" text="link to user component"></Label>
+ * ```
+ *
+ * `queryParams`, `fragment`, `queryParamsHandling`, `preserveFragment`, and
+ * `relativeTo` cannot be used when the `nsRouterLink` input is a `UrlTree`.
+ *
+ * ### NativeScript-specific options
+ *
+ * NativeScript adds support for page transitions and history clearing:
+ *
+ * ```html
+ * <Label [nsRouterLink]="['/user/bob']" [clearHistory]="true"
+ * pageTransition="slide" [pageTransitionDuration]="200"
+ * text="link to user component"></Label>
+ * ```
  */
-declare class NSRouterLink implements AfterViewInit {
-    private ngZone;
-    private router;
-    private navigator;
-    private route;
-    private el;
-    target: string;
-    queryParams: {
+declare class NSRouterLink implements OnChanges, OnDestroy {
+    private readonly ngZone;
+    private readonly router;
+    private readonly navigator;
+    private readonly route;
+    private readonly el;
+    /**
+     * Passed to {@link Router#createUrlTree} as part of the
+     * `UrlCreationOptions`.
+     * @see {@link UrlCreationOptions#queryParams}
+     * @see {@link Router#createUrlTree}
+     */
+    set queryParams(value: {
         [k: string]: any;
-    };
-    fragment: string;
-    queryParamsHandling: QueryParamsHandling;
-    preserveQueryParams: boolean;
-    preserveFragment: boolean;
-    skipLocationChange: boolean;
-    replaceUrl: boolean;
+    } | null | undefined);
+    get queryParams(): {
+        [k: string]: any;
+    } | null | undefined;
+    private _queryParams;
+    /**
+     * Passed to {@link Router#createUrlTree} as part of the
+     * `UrlCreationOptions`.
+     * @see {@link UrlCreationOptions#fragment}
+     * @see {@link Router#createUrlTree}
+     */
+    set fragment(value: string | undefined);
+    get fragment(): string | undefined;
+    private _fragment;
+    /**
+     * Passed to {@link Router#createUrlTree} as part of the
+     * `UrlCreationOptions`.
+     * @see {@link UrlCreationOptions#queryParamsHandling}
+     * @see {@link Router#createUrlTree}
+     */
+    set queryParamsHandling(value: QueryParamsHandling | null | undefined);
+    get queryParamsHandling(): QueryParamsHandling | null | undefined;
+    private _queryParamsHandling;
+    /**
+     * Passed to {@link Router#navigateByUrl} as part of the
+     * `NavigationBehaviorOptions`.
+     * @see {@link NavigationBehaviorOptions#state}
+     * @see {@link Router#navigateByUrl}
+     */
+    set state(value: {
+        [k: string]: any;
+    } | undefined);
+    get state(): {
+        [k: string]: any;
+    } | undefined;
+    private _state;
+    /**
+     * Passed to {@link Router#navigateByUrl} as part of the
+     * `NavigationBehaviorOptions`.
+     * @see {@link NavigationBehaviorOptions#info}
+     * @see {@link Router#navigateByUrl}
+     */
+    set info(value: unknown);
+    get info(): unknown;
+    private _info;
+    /**
+     * Passed to {@link Router#createUrlTree} as part of the
+     * `UrlCreationOptions`.
+     * Specify a value here when you do not want to use the default value
+     * for `nsRouterLink`, which is the current activated route.
+     * Note that a value of `undefined` here will use the `nsRouterLink` default.
+     * @see {@link UrlCreationOptions#relativeTo}
+     * @see {@link Router#createUrlTree}
+     */
+    set relativeTo(value: ActivatedRoute | null | undefined);
+    get relativeTo(): ActivatedRoute | null | undefined;
+    private _relativeTo;
+    /**
+     * Passed to {@link Router#createUrlTree} as part of the
+     * `UrlCreationOptions`.
+     * @see {@link UrlCreationOptions#preserveFragment}
+     * @see {@link Router#createUrlTree}
+     */
+    set preserveFragment(value: boolean);
+    get preserveFragment(): boolean;
+    private _preserveFragment;
+    /**
+     * Passed to {@link Router#navigateByUrl} as part of the
+     * `NavigationBehaviorOptions`.
+     * @see {@link NavigationBehaviorOptions#skipLocationChange}
+     * @see {@link Router#navigateByUrl}
+     */
+    set skipLocationChange(value: boolean);
+    get skipLocationChange(): boolean;
+    private _skipLocationChange;
+    /**
+     * Passed to {@link Router#navigateByUrl} as part of the
+     * `NavigationBehaviorOptions`.
+     * @see {@link NavigationBehaviorOptions#replaceUrl}
+     * @see {@link Router#navigateByUrl}
+     */
+    set replaceUrl(value: boolean);
+    get replaceUrl(): boolean;
+    private _replaceUrl;
     clearHistory: boolean;
     pageTransition: boolean | string | NavigationTransition;
     pageTransitionDuration: any;
-    private commands;
-    constructor(ngZone: NgZone, router: Router, navigator: RouterExtensions, route: ActivatedRoute, el: ElementRef);
-    ngAfterViewInit(): void;
-    set params(data: any[] | string);
-    onTap(): void;
+    /** @internal */
+    onChanges: Subject<NSRouterLink>;
+    private routerLinkInput;
+    private tapHandler;
+    constructor();
+    /**
+     * Commands to pass to {@link Router#createUrlTree} or a `UrlTree`.
+     *   - **array**: commands to pass to {@link Router#createUrlTree}.
+     *   - **string**: shorthand for array of commands with just the string, i.e. `['/route']`
+     *   - **UrlTree**: a `UrlTree` for this link rather than creating one from
+     * the commands and other inputs that correspond to properties of `UrlCreationOptions`.
+     *   - **null|undefined**: effectively disables the `nsRouterLink`
+     * @see {@link Router#createUrlTree}
+     */
+    set nsRouterLink(commandsOrUrlTree: readonly any[] | string | UrlTree | null | undefined);
+    ngOnChanges(_changes?: SimpleChanges): void;
+    ngOnDestroy(): void;
+    /** @internal */
+    _urlTree: i0.Signal<UrlTree>;
+    get urlTree(): UrlTree | null;
+    private onTap;
     private getExtras;
-    get urlTree(): UrlTree;
     private convertClearHistory;
     private getTransition;
     static ɵfac: i0.ɵɵFactoryDeclaration<NSRouterLink, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<NSRouterLink, "[nsRouterLink]", never, { "target": { "alias": "target"; "required": false; }; "queryParams": { "alias": "queryParams"; "required": false; }; "fragment": { "alias": "fragment"; "required": false; }; "queryParamsHandling": { "alias": "queryParamsHandling"; "required": false; }; "preserveQueryParams": { "alias": "preserveQueryParams"; "required": false; }; "preserveFragment": { "alias": "preserveFragment"; "required": false; }; "skipLocationChange": { "alias": "skipLocationChange"; "required": false; }; "replaceUrl": { "alias": "replaceUrl"; "required": false; }; "clearHistory": { "alias": "clearHistory"; "required": false; }; "pageTransition": { "alias": "pageTransition"; "required": false; }; "pageTransitionDuration": { "alias": "pageTransitionDuration"; "required": false; }; "params": { "alias": "nsRouterLink"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NSRouterLink, "[nsRouterLink]", never, { "queryParams": { "alias": "queryParams"; "required": false; }; "fragment": { "alias": "fragment"; "required": false; }; "queryParamsHandling": { "alias": "queryParamsHandling"; "required": false; }; "state": { "alias": "state"; "required": false; }; "info": { "alias": "info"; "required": false; }; "relativeTo": { "alias": "relativeTo"; "required": false; }; "preserveFragment": { "alias": "preserveFragment"; "required": false; }; "skipLocationChange": { "alias": "skipLocationChange"; "required": false; }; "replaceUrl": { "alias": "replaceUrl"; "required": false; }; "clearHistory": { "alias": "clearHistory"; "required": false; }; "pageTransition": { "alias": "pageTransition"; "required": false; }; "pageTransitionDuration": { "alias": "pageTransitionDuration"; "required": false; }; "nsRouterLink": { "alias": "nsRouterLink"; "required": false; }; }, {}, never, never, true, never>;
+    static ngAcceptInputType_preserveFragment: unknown;
+    static ngAcceptInputType_skipLocationChange: unknown;
+    static ngAcceptInputType_replaceUrl: unknown;
 }
 
 /**
- * The NSRouterLinkActive directive lets you add a CSS class to an element when the link"s route
+ * The NSRouterLinkActive directive lets you add a CSS class to an element when the link's route
  * becomes active.
  *
  * Consider the following example:
  *
  * ```
- * <a [nsRouterLink]="/user/bob" [nsRouterLinkActive]="active-link">Bob</a>
+ * <Label [nsRouterLink]="/user/bob" [nsRouterLinkActive]="'active-link'" text="Bob"></Label>
  * ```
  *
  * When the url is either "/user" or "/user/bob", the active-link class will
@@ -2488,114 +2698,107 @@ declare class NSRouterLink implements AfterViewInit {
  * You can set more than one class, as follows:
  *
  * ```
- * <a [nsRouterLink]="/user/bob" [nsRouterLinkActive]="class1 class2">Bob</a>
- * <a [nsRouterLink]="/user/bob" [nsRouterLinkActive]="["class1", "class2"]">Bob</a>
+ * <Label [nsRouterLink]="/user/bob" [nsRouterLinkActive]="'class1 class2'" text="Bob"></Label>
+ * <Label [nsRouterLink]="/user/bob" [nsRouterLinkActive]="['class1', 'class2']" text="Bob"></Label>
  * ```
  *
  * You can configure NSRouterLinkActive by passing `exact: true`. This will add the
  * classes only when the url matches the link exactly.
  *
  * ```
- * <a [nsRouterLink]="/user/bob" [nsRouterLinkActive]="active-link"
- * [nsRouterLinkActiveOptions]="{exact: true}">Bob</a>
+ * <Label [nsRouterLink]="/user/bob" [nsRouterLinkActive]="'active-link'"
+ * [nsRouterLinkActiveOptions]="{exact: true}" text="Bob"></Label>
  * ```
  *
- * Finally, you can apply the NSRouterLinkActive directive to an ancestor of a RouterLink.
+ * To directly check the `isActive` status of the link, assign the `NSRouterLinkActive`
+ * instance to a template variable.
+ * For example, the following checks the status without assigning any CSS classes:
  *
  * ```
- * <div [nsRouterLinkActive]="active-link" [nsRouterLinkActiveOptions]="{exact: true}">
- *   <a [nsRouterLink]="/user/jim">Jim</a>
- *   <a [nsRouterLink]="/user/bob">Bob</a>
- * </div>
+ * <Label [nsRouterLink]="/user/bob" nsRouterLinkActive #rla="routerLinkActive"
+ *   [text]="'Bob ' + (rla.isActive ? '(already open)' : '')"></Label>
  * ```
  *
- * This will set the active-link class on the div tag if the url is either "/user/jim" or
+ * You can apply the NSRouterLinkActive directive to an ancestor of a RouterLink.
+ *
+ * ```
+ * <StackLayout [nsRouterLinkActive]="'active-link'" [nsRouterLinkActiveOptions]="{exact: true}">
+ *   <Label [nsRouterLink]="/user/jim" text="Jim"></Label>
+ *   <Label [nsRouterLink]="/user/bob" text="Bob"></Label>
+ * </StackLayout>
+ * ```
+ *
+ * This will set the active-link class on the StackLayout if the url is either "/user/jim" or
  * "/user/bob".
  *
- * @stable
+ * The `NSRouterLinkActive` directive can also be used to set the aria-current attribute
+ * to provide an alternative distinction for active elements to visually impaired users.
+ *
+ * For example, the following code adds the 'active' class to the Home Page link when it is
+ * indeed active and in such case also sets its aria-current attribute to 'page':
+ *
+ * ```
+ * <Label nsRouterLink="/" [nsRouterLinkActive]="'active'" ariaCurrentWhenActive="page" text="Home Page"></Label>
+ * ```
  */
 declare class NSRouterLinkActive implements OnChanges, OnDestroy, AfterContentInit {
-    private router;
-    private element;
-    private renderer;
     links: QueryList<NSRouterLink>;
     private classes;
-    private subscription;
-    private active;
+    private routerEventsSubscription;
+    private linkInputChangesSubscription?;
+    private _isActive;
+    get isActive(): boolean;
+    /**
+     * Options to configure how to determine if the router link is active.
+     *
+     * These options are passed to the `isActive()` function.
+     *
+     * @see {@link isActive}
+     */
     nsRouterLinkActiveOptions: {
         exact: boolean;
-    };
-    constructor(router: Router, element: ElementRef, renderer: Renderer2);
-    get isActive(): boolean;
+    } | Partial<IsActiveMatchOptions>;
+    /**
+     * Aria-current attribute to apply when the router link is active.
+     *
+     * Possible values: `'page'` | `'step'` | `'location'` | `'date'` | `'time'` | `true` | `false`.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-current}
+     */
+    ariaCurrentWhenActive?: 'page' | 'step' | 'location' | 'date' | 'time' | true | false;
+    /**
+     *
+     * You can use the output `isActiveChange` to get notified each time the link becomes
+     * active or inactive.
+     *
+     * Emits:
+     * true  -> Route is active
+     * false -> Route is inactive
+     *
+     * ```html
+     * <Label
+     *  [nsRouterLink]="/user/bob"
+     *  [nsRouterLinkActive]="'active-link'"
+     *  (isActiveChange)="this.onRouterLinkActive($event)" text="Bob"></Label>
+     * ```
+     */
+    readonly isActiveChange: EventEmitter<boolean>;
+    private readonly link;
+    private readonly router;
+    private readonly element;
+    private readonly renderer;
+    private readonly cdr;
+    constructor();
     ngAfterContentInit(): void;
+    private subscribeToEachLinkOnChanges;
     set nsRouterLinkActive(data: string[] | string);
-    ngOnChanges(): void;
+    ngOnChanges(_changes: SimpleChanges): void;
     ngOnDestroy(): void;
     private update;
-    private reduceList;
     private isLinkActive;
     private hasActiveLinks;
     static ɵfac: i0.ɵɵFactoryDeclaration<NSRouterLinkActive, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<NSRouterLinkActive, "[nsRouterLinkActive]", ["routerLinkActive"], { "nsRouterLinkActiveOptions": { "alias": "nsRouterLinkActiveOptions"; "required": false; }; "nsRouterLinkActive": { "alias": "nsRouterLinkActive"; "required": false; }; }, {}, ["links"], never, true, never>;
-}
-
-declare class PageRoute {
-    activatedRoute: BehaviorSubject<ActivatedRoute>;
-    constructor(startRoute: ActivatedRoute);
-}
-declare class PageRouterOutlet implements OnDestroy, RouterOutletContract {
-    private parentContexts;
-    private location;
-    private locationStrategy;
-    private resolver;
-    private changeDetector;
-    private pageFactory;
-    private routeReuseStrategy;
-    private ngZone;
-    private router;
-    private environmentInjector;
-    private activated;
-    private _activatedRoute;
-    private detachedLoaderFactory;
-    private outlet;
-    private name;
-    private isEmptyOutlet;
-    private viewUtil;
-    private frame;
-    private postNavFunction;
-    attachEvents: EventEmitter<unknown>;
-    detachEvents: EventEmitter<unknown>;
-    activateEvents: EventEmitter<any>;
-    deactivateEvents: EventEmitter<any>;
-    get isActivated(): boolean;
-    get component(): unknown;
-    get activatedRoute(): ActivatedRoute;
-    get activatedRouteData(): Data;
-    constructor();
-    setActionBarVisibility(actionBarVisibility: string): void;
-    ngOnDestroy(): void;
-    deactivate(): void;
-    /**
-     * Called when the `RouteReuseStrategy` instructs to detach the subtree
-     */
-    detach(): ComponentRef<any>;
-    /**
-     * Called when the `RouteReuseStrategy` instructs to re-attach a previously detached subtree
-     */
-    attach(ref: ComponentRef<any>, activatedRoute: ActivatedRoute): void;
-    private isFinalPageRouterOutlet;
-    /**
-     * Called by the Router to instantiate a new component during the commit phase of a navigation.
-     * This method in turn is responsible for calling the `routerOnActivate` hook of its child.
-     */
-    activateWith(activatedRoute: ActivatedRoute, resolver: ComponentFactoryResolver | EnvironmentInjector | null): void;
-    private activateOnGoForward;
-    private loadComponentInPage;
-    private markActivatedRoute;
-    private getComponentType;
-    private getOutlet;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PageRouterOutlet, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PageRouterOutlet, "page-router-outlet", never, {}, { "activateEvents": "activate"; "deactivateEvents": "deactivate"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NSRouterLinkActive, "[nsRouterLinkActive]", ["routerLinkActive"], { "nsRouterLinkActiveOptions": { "alias": "nsRouterLinkActiveOptions"; "required": false; }; "ariaCurrentWhenActive": { "alias": "ariaCurrentWhenActive"; "required": false; }; "nsRouterLinkActive": { "alias": "nsRouterLinkActive"; "required": false; }; }, { "isActiveChange": "isActiveChange"; }, ["links"], never, true, never>;
 }
 
 declare class NSEmptyOutletComponent {
@@ -2606,6 +2809,32 @@ declare class NSEmptyOutletComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<NSEmptyOutletComponent, "ns-empty-outlet", never, {}, {}, never, never, true, never>;
 }
 
+type ExtendedNavigationExtras = NavigationExtras & NavigationOptions;
+type ExtendedNavigationBehaviorOptions = NavigationBehaviorOptions & NavigationOptions;
+interface BackNavigationOptions {
+    outlets?: Array<string>;
+    relativeTo?: ActivatedRoute | null;
+}
+declare class RouterExtensions {
+    router: Router;
+    locationStrategy: NSLocationStrategy;
+    frameService: FrameService;
+    constructor(router: Router, locationStrategy: NSLocationStrategy, frameService: FrameService);
+    navigate(commands: any[], extras?: ExtendedNavigationExtras): Promise<boolean>;
+    navigateByUrl(url: string | UrlTree, options?: ExtendedNavigationBehaviorOptions): Promise<boolean>;
+    back(backNavigationOptions?: BackNavigationOptions): void;
+    canGoBack(backNavigationOptions?: BackNavigationOptions): boolean;
+    backToPreviousPage(): void;
+    canGoBackToPreviousPage(): boolean;
+    private backOutlets;
+    private findOutletsToBack;
+    private findOutletsRecursive;
+    private findOutletByRoute;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RouterExtensions, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<RouterExtensions>;
+}
+
+declare function provideComponentInputBinding(options?: ComponentInputBindingOptions): Provider[];
 declare function provideLocationStrategy(locationStrategy: NSLocationStrategy, frameService: FrameService, startPath: string): NSLocationStrategy;
 declare class NativeScriptRouterModule {
     static forRoot(routes: Routes, config?: ExtraOptions): ModuleWithProviders<NativeScriptRouterModule>;
@@ -2830,5 +3059,5 @@ declare class NativeScriptNgZone implements NgZone {
 }
 declare function provideNativeScriptNgZone(options?: NgZoneOptions): i0.StaticProvider[];
 
-export { APP_ROOT_VIEW, ActionBarComponent, ActionBarScope, ActionItemDirective, AndroidFilterComponent, AppHostAsyncView, AppHostView, AppleFilterComponent, BasePortalOutlet, BaseValueAccessor, COMMON_PROVIDERS, CdkPortal, CdkPortalOutlet, CheckedValueAccessor, CommentNode, ComponentPortal, DEVICE, DISABLE_ROOT_VIEW_HANDLING, DateValueAccessor, DetachedLoader, DomPortal, ENABLE_REUSABE_VIEWS, EmulatedRenderer, FrameDirective, FramePageComponent, FramePageModule, FrameService, HmrCacheService, HmrCacheStore, IOSFilterComponent, InjectableAnimationEngine, InvisibleNode, ItemContext, ListViewComponent, ModalDialogParams, ModalDialogService, NAMESPACE_FILTERS, NATIVESCRIPT_MODULE_PROVIDERS, NATIVESCRIPT_MODULE_STATIC_PROVIDERS, NATIVESCRIPT_ROOT_MODULE_ID, NATIVE_DIALOG_DATA, NATIVE_DIALOG_DEFAULT_OPTIONS, NSEmptyOutletComponent, NSFileSystem, NSLocationStrategy, NSRouteReuseStrategy, NSRouterLink, NSRouterLinkActive, NativeDialog, NativeDialogCloseDirective, NativeDialogConfig, NativeDialogModule, NativeDialogRef, NativeDialog as NativeDialogService, NativeDialogState, NativeModalRef, NativeScriptAnimationDriver, NativeScriptAnimationPlayer, NativeScriptAnimationsModule, NativeScriptCommonModule, NativeScriptDocument, NativeScriptDomPortalOutlet, NativeScriptFormsModule, NativeScriptHttpClientModule, NativeScriptLoadingService, NativeScriptModule, NativeScriptNgSafeEvent, NativeScriptNgZone, NativeScriptRendererFactory, NativeScriptRendererHelperService, NativeScriptRouterModule, NativeScriptSanitizer, NativescriptXhrFactory, NavigationButtonDirective, NgViewRef, NsHttpBackEnd, NsTemplatedItem, NumberValueAccessor, Outlet, PAGE_FACTORY, PREVENT_CHANGE_EVENTS_DURING_CD, PREVENT_SPECIFIC_EVENTS_DURING_CD, PageDirective, PageRoute, PageRouterOutlet, PageService, PlatformNamespaceFilter, Portal, PortalModule, RootCompositeModule, RootViewProxy, RouterExtensions, START_PATH, SelectedIndexValueAccessor, TEMPLATED_ITEMS_COMPONENT, TabViewDirective, TabViewItemDirective, TemplateKeyDirective, TemplatePortal, TextNode, TextValueAccessor, TimeValueAccessor, VisionOSFilterComponent, bootstrapApplication, configureHmrCache, createDefaultHmrCacheStore, createKeyframeAnimation, customFrameComponentFactory, customFrameDirectiveFactory, customPageFactory, customPageFactoryFromFrame, dashCaseToCamelCase, defaultNavOptions, defaultPageFactory, defaultPageFactoryProvider, detachViewFromParent, disableRootViewHanding, errorHandler, extractSingleViewRecursive, frameMeta, generateDetachedLoader, generateFallbackRootView, generateNativeScriptView, generateRandomId, generateRootLayoutAndProxy, getAngularHmrRestoringRoute, getFirstNativeLikeView, getHmrCacheStore, getItemViewRoot, getSingleViewRecursive, getViewClass, getViewMeta, instantiateDefaultStyleNormalizer, instantiateSupportedAnimationDriver, isAngularHmrRestoringRoute, isBlank, isContentView, isDetachedElement, isInvisibleNode, isJsObject, isKnownView, isLayout, isListLikeIterable, isPresent, isView, onAfterLivesync, onBeforeLivesync, once, platformNativeScript, platformNativeScriptDynamic, postAngularBootstrap$, preAngularDisposal$, provideLocationStrategy, provideNativeScriptHttpClient, provideNativeScriptNgZone, provideNativeScriptRouter, registerElement, registerNativeScriptViewComponents, rootRoute, runNativeScriptAngularApp, throwIfAlreadyLoaded, throwNoPortalAttachedError, throwNullPortalError, throwNullPortalOutletError, throwPortalAlreadyAttachedError, throwPortalOutletAlreadyDisposedError, throwUnknownPortalTypeError, COMPONENT_VARIABLE as ɵCOMPONENT_VARIABLE, CONTENT_ATTR as ɵCONTENT_ATTR, HOST_ATTR as ɵHOST_ATTR, NativeScriptDebug as ɵNativeScriptAngularDebug, viewUtil_d as ɵViewUtil, actionBarMeta as ɵactionBarMeta, elementMap as ɵelementMap, isActionItem as ɵisActionItem, isNavigationButton as ɵisNavigationButton };
-export type { AppLaunchView, AppOptions, AppRunOptions, ApplicationConfig, BaseShowModalOptions, CdkPortalOutletAttachedRef, ComponentType, HmrCacheScope, HmrCacheStoreOptions, HmrOptions, Keyframe, LocationState, ModalDialogOptions, NamespaceFilter, NativeShowModalOptions, NavigationOptions, NgModuleEvent, NgModuleReason, NgView, NgViewTemplate, PageFactory, PageFactoryOptions, PortalOutlet, RootLocator, SelectableView, SetupItemViewArgs, ShowDialogOptions, TabViewItemDef, TemplatedItemsHost, TextView, ViewClass, ViewClassMeta, ViewExtensions, ViewResolver };
+export { APP_ROOT_VIEW, ActionBarComponent, ActionBarScope, ActionItemDirective, AndroidFilterComponent, AppHostAsyncView, AppHostView, AppleFilterComponent, BasePortalOutlet, BaseValueAccessor, COMMON_PROVIDERS, CdkPortal, CdkPortalOutlet, CheckedValueAccessor, CommentNode, ComponentPortal, DEVICE, DISABLE_ROOT_VIEW_HANDLING, DateValueAccessor, DetachedLoader, DomPortal, ENABLE_REUSABE_VIEWS, EmulatedRenderer, FrameDirective, FramePageComponent, FramePageModule, FrameService, HmrCacheService, HmrCacheStore, IOSFilterComponent, InjectableAnimationEngine, InvisibleNode, ItemContext, ListViewComponent, ModalDialogParams, ModalDialogService, NAMESPACE_FILTERS, NATIVESCRIPT_MODULE_PROVIDERS, NATIVESCRIPT_MODULE_STATIC_PROVIDERS, NATIVESCRIPT_ROOT_MODULE_ID, NATIVE_DIALOG_DATA, NATIVE_DIALOG_DEFAULT_OPTIONS, NSEmptyOutletComponent, NSFileSystem, NSLocationStrategy, NSRouteReuseStrategy, NSRouterLink, NSRouterLinkActive, NativeDialog, NativeDialogCloseDirective, NativeDialogConfig, NativeDialogModule, NativeDialogRef, NativeDialog as NativeDialogService, NativeDialogState, NativeModalRef, NativeScriptAnimationDriver, NativeScriptAnimationPlayer, NativeScriptAnimationsModule, NativeScriptCommonModule, NativeScriptDocument, NativeScriptDomPortalOutlet, NativeScriptFormsModule, NativeScriptHttpClientModule, NativeScriptLoadingService, NativeScriptModule, NativeScriptNgSafeEvent, NativeScriptNgZone, NativeScriptRendererFactory, NativeScriptRendererHelperService, NativeScriptRouterModule, NativeScriptSanitizer, NativescriptXhrFactory, NavigationButtonDirective, NgViewRef, NsHttpBackEnd, NsTemplatedItem, NumberValueAccessor, Outlet, PAGE_FACTORY, PREVENT_CHANGE_EVENTS_DURING_CD, PREVENT_SPECIFIC_EVENTS_DURING_CD, PageDirective, PageRoute, PageRouterOutlet, PageService, PlatformNamespaceFilter, Portal, PortalModule, RootCompositeModule, RootViewProxy, RouterExtensions, START_PATH, SelectedIndexValueAccessor, TEMPLATED_ITEMS_COMPONENT, TabViewDirective, TabViewItemDirective, TemplateKeyDirective, TemplatePortal, TextNode, TextValueAccessor, TimeValueAccessor, VisionOSFilterComponent, bootstrapApplication, configureHmrCache, createApplication, createDefaultHmrCacheStore, createKeyframeAnimation, customFrameComponentFactory, customFrameDirectiveFactory, customPageFactory, customPageFactoryFromFrame, dashCaseToCamelCase, defaultNavOptions, defaultPageFactory, defaultPageFactoryProvider, detachViewFromParent, disableRootViewHanding, errorHandler, extractSingleViewRecursive, frameMeta, generateDetachedLoader, generateFallbackRootView, generateNativeScriptView, generateRandomId, generateRootLayoutAndProxy, getAngularHmrRestoringRoute, getFirstNativeLikeView, getHmrCacheStore, getItemViewRoot, getSingleViewRecursive, getViewClass, getViewMeta, instantiateDefaultStyleNormalizer, instantiateSupportedAnimationDriver, isAngularHmrRestoringRoute, isBlank, isContentView, isDetachedElement, isInvisibleNode, isJsObject, isKnownView, isLayout, isListLikeIterable, isPresent, isView, onAfterLivesync, onBeforeLivesync, once, platformNativeScript, platformNativeScriptDynamic, postAngularBootstrap$, preAngularDisposal$, provideComponentInputBinding, provideLocationStrategy, provideNativeScriptHttpClient, provideNativeScriptNgZone, provideNativeScriptRouter, registerElement, registerNativeScriptViewComponents, rootRoute, runNativeScriptAngularApp, throwIfAlreadyLoaded, throwNoPortalAttachedError, throwNullPortalError, throwNullPortalOutletError, throwPortalAlreadyAttachedError, throwPortalOutletAlreadyDisposedError, throwUnknownPortalTypeError, COMPONENT_VARIABLE as ɵCOMPONENT_VARIABLE, CONTENT_ATTR as ɵCONTENT_ATTR, HOST_ATTR as ɵHOST_ATTR, NativeScriptDebug as ɵNativeScriptAngularDebug, viewUtil_d as ɵViewUtil, actionBarMeta as ɵactionBarMeta, elementMap as ɵelementMap, isActionItem as ɵisActionItem, isNavigationButton as ɵisNavigationButton };
+export type { AppLaunchView, AppOptions, AppRunOptions, ApplicationConfig, BaseShowModalOptions, BootstrapContext, CdkPortalOutletAttachedRef, ComponentInputBindingOptions, ComponentType, HmrCacheScope, HmrCacheStoreOptions, HmrOptions, Keyframe, LocationState, ModalDialogOptions, NamespaceFilter, NativeShowModalOptions, NavigationOptions, NgModuleEvent, NgModuleReason, NgView, NgViewTemplate, PageFactory, PageFactoryOptions, PortalOutlet, RootLocator, SelectableView, SetupItemViewArgs, ShowDialogOptions, TabViewItemDef, TemplatedItemsHost, TextView, ViewClass, ViewClassMeta, ViewExtensions, ViewResolver };