@ni/nimble-angular 33.4.7 → 33.4.9

package/index.d.ts

@@ -1,15 +1,14 @@
+import { RouterLink, Router, ActivatedRoute } from '@angular/router';
 import * as i0 from '@angular/core';
-import { OnChanges, OnDestroy, Renderer2, ElementRef, SimpleChanges, EventEmitter, AfterViewChecked, AfterViewInit, OnInit, Injector } from '@angular/core';
-import * as i2 from '@angular/common';
-import { LocationStrategy } from '@angular/common';
-import { Subject } from 'rxjs';
-import { Params, QueryParamsHandling, ActivatedRoute, Router, UrlTree } from '@angular/router';
+import { Renderer2, ElementRef, EventEmitter, AfterViewChecked, AfterViewInit, OnDestroy, OnInit, Injector } from '@angular/core';
 import { Anchor } from '@ni/nimble-components/dist/esm/anchor';
 export { Anchor, anchorTag } from '@ni/nimble-components/dist/esm/anchor';
 import { AnchorAppearance } from '@ni/nimble-components/dist/esm/anchor/types';
 export { AnchorAppearance } from '@ni/nimble-components/dist/esm/anchor/types';
 import { BooleanValueOrAttribute, NumberValueOrAttribute } from '@ni/nimble-angular/internal-utilities';
 import { AnchorBase } from '@ni/nimble-components/dist/esm/anchor-base';
+import * as i2 from '@angular/common';
+import { LocationStrategy } from '@angular/common';
 import { AnchorButton } from '@ni/nimble-components/dist/esm/anchor-button';
 export { AnchorButton, anchorButtonTag } from '@ni/nimble-components/dist/esm/anchor-button';
 import { ButtonAppearance, ButtonAppearanceVariant } from '@ni/nimble-components/dist/esm/anchor-button/types';
@@ -356,249 +355,6 @@ export { TabsToolbar, tabsToolbarTag } from '@ni/nimble-components/dist/esm/tabs
 export { Toolbar, toolbarTag } from '@ni/nimble-components/dist/esm/toolbar';
 export { processUpdates } from '@ni/nimble-components/dist/esm/testing/async-helpers';
 
-/**
- * @description
- *
- * When applied to an element in a template, makes that element a link
- * that initiates navigation to a route. Navigation opens one or more routed components
- * in one or more `<router-outlet>` locations on the page.
- *
- * Given a route configuration `[{ path: 'user/:name', component: UserCmp }]`,
- * the following creates a static link to the route:
- * `<a routerLink="/user/bob">link to user component</a>`
- *
- * 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 `<a [routerLink]="['/user/jim']">Jim</a>` 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 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
- * <a [routerLink]="['/user/bob']" [queryParams]="{debug: true}" fragment="education">
- *   link to user component
- * </a>
- * ```
- * 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
- * <a [routerLink]="['/user/bob']" [queryParams]="{debug: true}" queryParamsHandling="merge">
- *   link to user component
- * </a>
- * ```
- *
- * `queryParams`, `fragment`, `queryParamsHandling`, `preserveFragment`, and `relativeTo`
- * cannot be used when the `routerLink` input is a `UrlTree`.
- *
- * See {@link UrlCreationOptions#queryParamsHandling}.
- *
- * ### Preserving navigation history
- *
- * You can provide a `state` value to be persisted to the browser's
- * [`History.state` property](https://developer.mozilla.org/en-US/docs/Web/API/History#Properties).
- * For example:
- *
- * ```html
- * <a [routerLink]="['/user/bob']" [state]="{tracingId: 123}">
- *   link to user component
- * </a>
- * ```
- *
- * Use {@link Router#getCurrentNavigation} to retrieve a saved
- * navigation-state value. For example, to capture the `tracingId` during the `NavigationStart`
- * event:
- *
- * ```ts
- * // Get NavigationStart events
- * router.events.pipe(filter(e => e instanceof NavigationStart)).subscribe(e => {
- *   const navigation = router.getCurrentNavigation();
- *   tracingService.trace({id: navigation.extras.state.tracingId});
- * });
- * ```
- *
- * ### RouterLink compatible custom elements
- *
- * In order to make a custom element work with routerLink, the corresponding custom
- * element must implement the `href` attribute and must list `href` in the array of
- * the static property/getter `observedAttributes`.
- *
- * @ngModule RouterModule
- *
- * @publicApi
- */
-declare class RouterLink implements OnChanges, OnDestroy {
-    private router;
-    private route;
-    private readonly tabIndexAttribute;
-    private readonly renderer;
-    private readonly el;
-    private locationStrategy?;
-    /** @nodoc */
-    protected readonly reactiveHref: i0.WritableSignal<string | null>;
-    /**
-     * Represents an `href` attribute value applied to a host element,
-     * when a host element is an `<a>`/`<area>` tag or a compatible custom element.
-     * For other tags, the value is `null`.
-     */
-    href: string | null;
-    /**
-     * Represents the `target` attribute on a host element.
-     * This is only used when the host element is
-     * an `<a>`/`<area>` tag or a compatible custom element.
-     */
-    target?: string;
-    /**
-     * Passed to {@link Router#createUrlTree} as part of the
-     * `UrlCreationOptions`.
-     * @see {@link UrlCreationOptions#queryParams}
-     * @see {@link Router#createUrlTree}
-     */
-    queryParams?: Params | null;
-    /**
-     * Passed to {@link Router#createUrlTree} as part of the
-     * `UrlCreationOptions`.
-     * @see {@link UrlCreationOptions#fragment}
-     * @see {@link Router#createUrlTree}
-     */
-    fragment?: string;
-    /**
-     * Passed to {@link Router#createUrlTree} as part of the
-     * `UrlCreationOptions`.
-     * @see {@link UrlCreationOptions#queryParamsHandling}
-     * @see {@link Router#createUrlTree}
-     */
-    queryParamsHandling?: QueryParamsHandling | null;
-    /**
-     * Passed to {@link Router#navigateByUrl} as part of the
-     * `NavigationBehaviorOptions`.
-     * @see {@link NavigationBehaviorOptions#state}
-     * @see {@link Router#navigateByUrl}
-     */
-    state?: {
-        [k: string]: any;
-    };
-    /**
-     * Passed to {@link Router#navigateByUrl} as part of the
-     * `NavigationBehaviorOptions`.
-     * @see {@link NavigationBehaviorOptions#info}
-     * @see {@link Router#navigateByUrl}
-     */
-    info?: unknown;
-    /**
-     * 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 `routerLink`, which is the current activated route.
-     * Note that a value of `undefined` here will use the `routerLink` default.
-     * @see {@link UrlCreationOptions#relativeTo}
-     * @see {@link Router#createUrlTree}
-     */
-    relativeTo?: ActivatedRoute | null;
-    /** Whether a host element is an `<a>`/`<area>` tag or a compatible custom element. */
-    private isAnchorElement;
-    private subscription?;
-    /** @internal */
-    onChanges: Subject<RouterLink>;
-    private readonly applicationErrorHandler;
-    private readonly options;
-    constructor(router: Router, route: ActivatedRoute, tabIndexAttribute: string | null | undefined, renderer: Renderer2, el: ElementRef, locationStrategy?: LocationStrategy | undefined);
-    private subscribeToNavigationEventsIfNecessary;
-    /**
-     * Passed to {@link Router#createUrlTree} as part of the
-     * `UrlCreationOptions`.
-     * @see {@link UrlCreationOptions#preserveFragment}
-     * @see {@link Router#createUrlTree}
-     */
-    preserveFragment: boolean;
-    /**
-     * Passed to {@link Router#navigateByUrl} as part of the
-     * `NavigationBehaviorOptions`.
-     * @see {@link NavigationBehaviorOptions#skipLocationChange}
-     * @see {@link Router#navigateByUrl}
-     */
-    skipLocationChange: boolean;
-    /**
-     * Passed to {@link Router#navigateByUrl} as part of the
-     * `NavigationBehaviorOptions`.
-     * @see {@link NavigationBehaviorOptions#replaceUrl}
-     * @see {@link Router#navigateByUrl}
-     */
-    replaceUrl: boolean;
-    /**
-     * Modifies the tab index if there was not a tabindex attribute on the element during
-     * instantiation.
-     */
-    private setTabIndexIfNotOnNativeEl;
-    /** @docs-private */
-    ngOnChanges(changes?: SimpleChanges): void;
-    private routerLinkInput;
-    /**
-     * 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 `routerLink`
-     * @see {@link Router#createUrlTree}
-     */
-    set routerLink(commandsOrUrlTree: readonly any[] | string | UrlTree | null | undefined);
-    /** @docs-private */
-    onClick(button: number, ctrlKey: boolean, shiftKey: boolean, altKey: boolean, metaKey: boolean): boolean;
-    /** @docs-private */
-    ngOnDestroy(): any;
-    private updateHref;
-    private applyAttributeValue;
-    get urlTree(): UrlTree | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<RouterLink, [null, null, { attribute: "tabindex"; }, null, null, null]>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<RouterLink, never, never, { "target": { "alias": "target"; "required": false; }; "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; }; "routerLink": { "alias": "routerLink"; "required": false; }; }, {}, never, never, true, never>;
-    static ngAcceptInputType_preserveFragment: unknown;
-    static ngAcceptInputType_skipLocationChange: unknown;
-    static ngAcceptInputType_replaceUrl: unknown;
-}
-
-/**
- * Selectors used for built-in Angular RouterLink directives:
- * RouterLink: ':not(a):not(area)[routerLink]'
- * RouterLinkWithHref: 'a[routerLink],area[routerLink]'
- *
- * See https://github.com/angular/angular/blob/5957ff4163f55d814be2cf80b9909244f1ce5262/packages/router/src/directives/router_link.ts
- */
 /**
  * Directive to handle nimble-anchor RouterLink support.
  * Note: Clients need to use [nimbleRouterLink] instead of [routerLink], so that there
@@ -699,13 +455,6 @@ declare class NimbleAnchorButtonDirective extends NimbleAnchorBaseDirective<Anch
     static ɵdir: i0.ɵɵDirectiveDeclaration<NimbleAnchorButtonDirective, "nimble-anchor-button", never, { "appearance": { "alias": "appearance"; "required": false; }; "appearanceVariant": { "alias": "appearance-variant"; "required": false; }; "contentHidden": { "alias": "content-hidden"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, {}, never, never, false, never>;
 }
 
-/**
- * Selectors used for built-in Angular RouterLink directives:
- * RouterLink: ':not(a):not(area)[routerLink]'
- * RouterLinkWithHref: 'a[routerLink],area[routerLink]'
- *
- * See https://github.com/angular/angular/blob/5957ff4163f55d814be2cf80b9909244f1ce5262/packages/router/src/directives/router_link.ts
- */
 /**
  * Directive to handle nimble-anchor-button RouterLink support.
  * Note: Clients need to use [nimbleRouterLink] instead of [routerLink], so that there
@@ -745,13 +494,6 @@ declare class NimbleAnchorMenuItemDirective extends NimbleAnchorBaseDirective<An
     static ɵdir: i0.ɵɵDirectiveDeclaration<NimbleAnchorMenuItemDirective, "nimble-anchor-menu-item", never, { "disabled": { "alias": "disabled"; "required": false; }; }, {}, never, never, false, never>;
 }
 
-/**
- * Selectors used for built-in Angular RouterLink directives:
- * RouterLink: ':not(a):not(area)[routerLink]'
- * RouterLinkWithHref: 'a[routerLink],area[routerLink]'
- *
- * See https://github.com/angular/angular/blob/5957ff4163f55d814be2cf80b9909244f1ce5262/packages/router/src/directives/router_link.ts
- */
 /**
  * Directive to handle nimble-anchor-menu-item RouterLink support.
  * Note: Clients need to use [nimbleRouterLink] instead of [routerLink], so that there
@@ -791,13 +533,6 @@ declare class NimbleAnchorTabDirective extends NimbleAnchorBaseDirective<AnchorT
     static ɵdir: i0.ɵɵDirectiveDeclaration<NimbleAnchorTabDirective, "nimble-anchor-tab", never, { "disabled": { "alias": "disabled"; "required": false; }; }, {}, never, never, false, never>;
 }
 
-/**
- * Selectors used for built-in Angular RouterLink directives:
- * RouterLink: ':not(a):not(area)[routerLink]'
- * RouterLinkWithHref: 'a[routerLink],area[routerLink]'
- *
- * See https://github.com/angular/angular/blob/5957ff4163f55d814be2cf80b9909244f1ce5262/packages/router/src/directives/router_link.ts
- */
 /**
  * Directive to handle nimble-anchor-tab RouterLink support.
  * Note: Clients need to use [nimbleRouterLink] instead of [routerLink], so that there
@@ -859,13 +594,6 @@ declare class NimbleAnchorTreeItemDirective extends NimbleAnchorBaseDirective<An
     static ɵdir: i0.ɵɵDirectiveDeclaration<NimbleAnchorTreeItemDirective, "nimble-anchor-tree-item", never, { "disabled": { "alias": "disabled"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; }, {}, never, never, false, never>;
 }
 
-/**
- * Selectors used for built-in Angular RouterLink directives:
- * RouterLink: ':not(a):not(area)[routerLink]'
- * RouterLinkWithHref: 'a[routerLink],area[routerLink]'
- *
- * See https://github.com/angular/angular/blob/5957ff4163f55d814be2cf80b9909244f1ce5262/packages/router/src/directives/router_link.ts
- */
 /**
  * Directive to handle nimble-anchor-tree-item RouterLink support.
  * Note: Clients need to use [nimbleRouterLink] instead of [routerLink], so that there
@@ -940,13 +668,6 @@ declare class NimbleBreadcrumbModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<NimbleBreadcrumbModule>;
 }
 
-/**
- * Selectors used for built-in Angular RouterLink directives:
- * RouterLink: ':not(a):not(area)[routerLink]'
- * RouterLinkWithHref: 'a[routerLink],area[routerLink]'
- *
- * See https://github.com/angular/angular/blob/5957ff4163f55d814be2cf80b9909244f1ce5262/packages/router/src/directives/router_link.ts
- */
 /**
  * Directive to handle nimble-breadcrumb-item RouterLink support.
  * Note: Clients need to use [nimbleRouterLink] instead of [routerLink], so that there

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ni/nimble-angular",
-  "version": "33.4.7",
+  "version": "33.4.9",
   "description": "Angular components for the NI Nimble Design System",
   "type": "module",
   "exports": {
@@ -215,7 +215,7 @@
     "@angular/forms": "^20.3.19",
     "@angular/localize": "^20.3.19",
     "@angular/router": "^20.3.19",
-    "@ni/nimble-components": "^35.12.6",
+    "@ni/nimble-components": "^35.12.7",
     "@ni/unit-format": "^1.0.5"
   },
   "module": "fesm2022/ni-nimble-angular.mjs",