@truenas/ui-components 0.1.56 → 0.1.58

package/types/truenas-ui-components.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { ElementRef, OnDestroy, AfterViewInit, AfterContentInit, TemplateRef, Provider, ChangeDetectorRef, OnInit, PipeTransform, ViewContainerRef, AfterViewChecked, ComponentRef } from '@angular/core';
+import { ElementRef, OnDestroy, AfterViewInit, AfterContentInit, TemplateRef, Provider, ChangeDetectorRef, OnInit, PipeTransform, ViewContainerRef, AfterViewChecked, ComponentRef, InjectionToken } from '@angular/core';
 import { ControlValueAccessor, NgControl } from '@angular/forms';
 import { ComponentHarness, BaseHarnessFilters, HarnessPredicate, HarnessLoader } from '@angular/cdk/testing';
 import { SafeHtml, SafeResourceUrl, DomSanitizer } from '@angular/platform-browser';
@@ -270,6 +270,11 @@ declare class TnDrawerComponent implements OnDestroy {
     position: _angular_core.InputSignal<TnDrawerPosition>;
     /** Accessible label for the drawer panel */
     ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Test-id applied to the drawer panel. Rendered under whichever attribute name is
+     * configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId: _angular_core.InputSignal<string | undefined>;
     /** Fires after the open transition completes */
     openedComplete: _angular_core.OutputEmitterRef<void>;
     /** Fires after the close transition completes */
@@ -308,7 +313,7 @@ declare class TnDrawerComponent implements OnDestroy {
     protected onTransitionEnd(event: TransitionEvent): void;
     private restoreFocus;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnDrawerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnDrawerComponent, "tn-drawer", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "opened": { "alias": "opened"; "required": false; "isSignal": true; }; "disableClose": { "alias": "disableClose"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "opened": "openedChange"; "openedComplete": "openedComplete"; "closed": "closed"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnDrawerComponent, "tn-drawer", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "opened": { "alias": "opened"; "required": false; "isSignal": true; }; "disableClose": { "alias": "disableClose"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; }, { "opened": "openedChange"; "openedComplete": "openedComplete"; "closed": "closed"; }, never, ["*"], true, never>;
 }
 
 declare class TnDrawerContainerComponent {
@@ -527,10 +532,37 @@ declare class TnButtonComponent {
     backgroundColor: _angular_core.InputSignal<string | undefined>;
     label: _angular_core.InputSignal<string>;
     disabled: _angular_core.InputSignal<boolean>;
+    /**
+     * Test-id applied to the rendered element. Rendered under whichever attribute
+     * name is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Renders the button as an `<a>` with a plain `href` attribute.
+     * Mutually exclusive with `routerLink` — if both are provided, `routerLink` wins.
+     */
+    href: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Renders the button as an `<a>` driven by Angular Router. Accepts the same
+     * shapes as `[routerLink]` (`string | any[]`).
+     */
+    routerLink: _angular_core.InputSignal<string | unknown[] | undefined>;
+    queryParams: _angular_core.InputSignal<Record<string, unknown> | undefined>;
+    fragment: _angular_core.InputSignal<string | undefined>;
+    target: _angular_core.InputSignal<string | undefined>;
+    rel: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Accessible label for the rendered element. Mirrors `aria-label`; useful when
+     * the visible label alone is insufficient (e.g. icon-only links).
+     */
+    ariaLabel: _angular_core.InputSignal<string | undefined>;
     onClick: _angular_core.OutputEmitterRef<MouseEvent>;
+    isAnchor: _angular_core.Signal<boolean>;
+    isRouterLink: _angular_core.Signal<boolean>;
     classes: _angular_core.Signal<string[]>;
+    handleAnchorClick(event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnButtonComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnButtonComponent, "tn-button", never, { "primary": { "alias": "primary"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "onClick": "onClick"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnButtonComponent, "tn-button", never, { "primary": { "alias": "primary"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "queryParams": { "alias": "queryParams"; "required": false; "isSignal": true; }; "fragment": { "alias": "fragment"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; "rel": { "alias": "rel"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "onClick": "onClick"; }, never, never, true, never>;
 }
 
 /**
@@ -599,6 +631,18 @@ declare class TnButtonHarness extends ComponentHarness {
      * ```
      */
     isDisabled(): Promise<boolean>;
+    /**
+     * Gets the resolved URL of the rendered element. Returns the `href` for
+     * anchor-mode renders (both plain `href` and `routerLink`) and `null` for
+     * button-mode renders.
+     *
+     * @example
+     * ```typescript
+     * const link = await loader.getHarness(TnButtonHarness.with({ label: 'Audit Settings' }));
+     * expect(await link.getHref()).toContain('/audit/settings');
+     * ```
+     */
+    getHref(): Promise<string | null>;
     /**
      * Clicks the button.
      *
@@ -673,6 +717,11 @@ declare class TnIconComponent {
 declare class TnIconButtonComponent {
     disabled: _angular_core.InputSignal<boolean>;
     ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Test-id applied to the rendered `<button>` element. Rendered under whichever attribute
+     * name is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId: _angular_core.InputSignal<string | undefined>;
     name: _angular_core.InputSignal<string>;
     size: _angular_core.InputSignal<IconSize>;
     color: _angular_core.InputSignal<string | undefined>;
@@ -682,7 +731,7 @@ declare class TnIconButtonComponent {
     classes: _angular_core.Signal<string[]>;
     effectiveAriaLabel: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnIconButtonComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnIconButtonComponent, "tn-icon-button", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "library": { "alias": "library"; "required": false; "isSignal": true; }; }, { "onClick": "onClick"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnIconButtonComponent, "tn-icon-button", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "library": { "alias": "library"; "required": false; "isSignal": true; }; }, { "onClick": "onClick"; }, never, never, true, never>;
 }
 
 /**
@@ -1213,20 +1262,40 @@ interface TnCardAction {
     handler: () => void;
     disabled?: boolean;
     icon?: string;
+    /**
+     * Test-id applied to the rendered action button. Rendered under whichever attribute name
+     * is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId?: string;
 }
 interface TnCardControl {
     label: string;
     checked: boolean;
     handler: (checked: boolean) => void;
     disabled?: boolean;
+    /**
+     * Test-id applied to the rendered slide-toggle. Rendered under whichever attribute name
+     * is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId?: string;
 }
 interface TnCardHeaderStatus {
     label: string;
     type?: 'success' | 'warning' | 'error' | 'info' | 'neutral';
+    /**
+     * Test-id applied to the rendered status pill `<div>`. Rendered under whichever attribute name
+     * is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId?: string;
 }
 interface TnCardFooterLink {
     label: string;
     handler: () => void;
+    /**
+     * Test-id applied to the rendered footer link button. Rendered under whichever attribute name
+     * is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId?: string;
 }
 
 /**
@@ -1259,6 +1328,12 @@ interface TnMenuItem {
     action?: () => void;
     children?: TnMenuItem[];
     shortcut?: string;
+    /**
+     * Marks this item as the currently-chosen option (e.g. the active sort key
+     * or export format). Applies the `tn-menu-item--selected` class and an
+     * `aria-current="true"` attribute. Visually distinct from focus/hover.
+     */
+    selected?: boolean;
 }
 declare class TnMenuComponent {
     items: _angular_core.InputSignal<TnMenuItem[]>;
@@ -1272,6 +1347,8 @@ declare class TnMenuComponent {
     private overlay;
     private viewContainerRef;
     onMenuItemClick(item: TnMenuItem): void;
+    private contentItems;
+    constructor();
     hasChildren: _angular_core.Signal<(item: TnMenuItem) => boolean>;
     onMenuOpen(): void;
     onMenuClose(): void;
@@ -1284,7 +1361,7 @@ declare class TnMenuComponent {
     onContextMenu(event: MouseEvent): void;
     trackByItemId(index: number, item: TnMenuItem): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnMenuComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnMenuComponent, "tn-menu", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "contextMenu": { "alias": "contextMenu"; "required": false; "isSignal": true; }; }, { "menuItemClick": "menuItemClick"; "menuOpen": "menuOpen"; "menuClose": "menuClose"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnMenuComponent, "tn-menu", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "contextMenu": { "alias": "contextMenu"; "required": false; "isSignal": true; }; }, { "menuItemClick": "menuItemClick"; "menuOpen": "menuOpen"; "menuClose": "menuClose"; }, ["contentItems"], ["*", "tn-menu-item, .tn-menu-separator"], true, never>;
 }
 
 declare class TnCardComponent {
@@ -1301,6 +1378,12 @@ declare class TnCardComponent {
     headerStatus: _angular_core.InputSignal<TnCardHeaderStatus | undefined>;
     headerControl: _angular_core.InputSignal<TnCardControl | undefined>;
     headerMenu: _angular_core.InputSignal<TnMenuItem[] | undefined>;
+    /**
+     * Test-id applied to the kebab-menu trigger button rendered when `headerMenu` is set.
+     * Rendered under whichever attribute name is configured via `TN_TEST_ATTR`
+     * (default `data-testid`).
+     */
+    headerMenuTriggerTestId: _angular_core.InputSignal<string | undefined>;
     primaryAction: _angular_core.InputSignal<TnCardAction | undefined>;
     secondaryAction: _angular_core.InputSignal<TnCardAction | undefined>;
     footerLink: _angular_core.InputSignal<TnCardFooterLink | undefined>;
@@ -1317,7 +1400,7 @@ declare class TnCardComponent {
     onHeaderMenuItemClick(_item: TnMenuItem): void;
     getStatusClass(type?: string): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnCardComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnCardComponent, "tn-card", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "titleLink": { "alias": "titleLink"; "required": false; "isSignal": true; }; "elevation": { "alias": "elevation"; "required": false; "isSignal": true; }; "padding": { "alias": "padding"; "required": false; "isSignal": true; }; "padContent": { "alias": "padContent"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "background": { "alias": "background"; "required": false; "isSignal": true; }; "headerStatus": { "alias": "headerStatus"; "required": false; "isSignal": true; }; "headerControl": { "alias": "headerControl"; "required": false; "isSignal": true; }; "headerMenu": { "alias": "headerMenu"; "required": false; "isSignal": true; }; "primaryAction": { "alias": "primaryAction"; "required": false; "isSignal": true; }; "secondaryAction": { "alias": "secondaryAction"; "required": false; "isSignal": true; }; "footerLink": { "alias": "footerLink"; "required": false; "isSignal": true; }; }, {}, ["projectedHeader"], ["[tnCardHeader]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnCardComponent, "tn-card", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "titleLink": { "alias": "titleLink"; "required": false; "isSignal": true; }; "elevation": { "alias": "elevation"; "required": false; "isSignal": true; }; "padding": { "alias": "padding"; "required": false; "isSignal": true; }; "padContent": { "alias": "padContent"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "background": { "alias": "background"; "required": false; "isSignal": true; }; "headerStatus": { "alias": "headerStatus"; "required": false; "isSignal": true; }; "headerControl": { "alias": "headerControl"; "required": false; "isSignal": true; }; "headerMenu": { "alias": "headerMenu"; "required": false; "isSignal": true; }; "headerMenuTriggerTestId": { "alias": "headerMenuTriggerTestId"; "required": false; "isSignal": true; }; "primaryAction": { "alias": "primaryAction"; "required": false; "isSignal": true; }; "secondaryAction": { "alias": "secondaryAction"; "required": false; "isSignal": true; }; "footerLink": { "alias": "footerLink"; "required": false; "isSignal": true; }; }, {}, ["projectedHeader"], ["[tnCardHeader]", "*"], true, never>;
 }
 
 declare class TnExpansionPanelComponent {
@@ -1329,6 +1412,15 @@ declare class TnExpansionPanelComponent {
     expanded: _angular_core.InputSignal<boolean>;
     disabled: _angular_core.InputSignal<boolean>;
     titleStyle: _angular_core.InputSignal<"body" | "header" | "link">;
+    /**
+     * Test-id applied to the panel's root element. Rendered under whichever attribute name
+     * is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Test-id applied to the expand/collapse toggle header button.
+     */
+    toggleTestId: _angular_core.InputSignal<string | undefined>;
     expandedChange: _angular_core.OutputEmitterRef<boolean>;
     toggleEvent: _angular_core.OutputEmitterRef<void>;
     private internalExpanded;
@@ -1337,7 +1429,7 @@ declare class TnExpansionPanelComponent {
     toggle(): void;
     classes: _angular_core.Signal<string[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnExpansionPanelComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnExpansionPanelComponent, "tn-expansion-panel", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "elevation": { "alias": "elevation"; "required": false; "isSignal": true; }; "padding": { "alias": "padding"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "background": { "alias": "background"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "titleStyle": { "alias": "titleStyle"; "required": false; "isSignal": true; }; }, { "expandedChange": "expandedChange"; "toggleEvent": "toggleEvent"; }, never, ["[slot=title]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnExpansionPanelComponent, "tn-expansion-panel", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "elevation": { "alias": "elevation"; "required": false; "isSignal": true; }; "padding": { "alias": "padding"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "background": { "alias": "background"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "titleStyle": { "alias": "titleStyle"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; "toggleTestId": { "alias": "toggleTestId"; "required": false; "isSignal": true; }; }, { "expandedChange": "expandedChange"; "toggleEvent": "toggleEvent"; }, never, ["[slot=title]", "*"], true, never>;
 }
 
 /**
@@ -1992,6 +2084,11 @@ declare class TnTabsComponent implements AfterContentInit, AfterViewInit, OnDest
     selectedIndex: _angular_core.InputSignal<number>;
     orientation: _angular_core.InputSignal<"horizontal" | "vertical">;
     highlightPosition: _angular_core.InputSignal<"top" | "bottom" | "left" | "right">;
+    /**
+     * Test-id applied to the tablist root element. Rendered under whichever attribute name
+     * is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId: _angular_core.InputSignal<string | undefined>;
     selectedIndexChange: _angular_core.OutputEmitterRef<number>;
     tabChange: _angular_core.OutputEmitterRef<TabChangeEvent>;
     private internalSelectedIndex;
@@ -2017,7 +2114,7 @@ declare class TnTabsComponent implements AfterContentInit, AfterViewInit, OnDest
     private focusTab;
     classes: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnTabsComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnTabsComponent, "tn-tabs", never, { "selectedIndex": { "alias": "selectedIndex"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "highlightPosition": { "alias": "highlightPosition"; "required": false; "isSignal": true; }; }, { "selectedIndexChange": "selectedIndexChange"; "tabChange": "tabChange"; }, ["tabs", "panels"], ["tn-tab", "tn-tab-panel"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnTabsComponent, "tn-tabs", never, { "selectedIndex": { "alias": "selectedIndex"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "highlightPosition": { "alias": "highlightPosition"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; }, { "selectedIndexChange": "selectedIndexChange"; "tabChange": "tabChange"; }, ["tabs", "panels"], ["tn-tab", "tn-tab-panel"], true, never>;
 }
 
 /**
@@ -2378,6 +2475,55 @@ interface TabsHarnessFilters extends BaseHarnessFilters {
     hasTab?: string | RegExp;
 }
 
+/**
+ * Projection-based menu item for use inside `<tn-menu>`.
+ *
+ * Two authoring modes:
+ * 1. **Convenience** — set `label` (and optionally `icon`/`shortcut`); the
+ *    default icon + label + shortcut layout renders.
+ * 2. **Custom content** — omit `label`; project arbitrary content via
+ *    `<ng-content>` (badges, two-line layouts, etc.).
+ *
+ * Existing `<tn-menu [items]="...">` consumers don't need this component;
+ * the items-array API continues to work unchanged. Items-array entries and
+ * projected `<tn-menu-item>` children render together inside one `<tn-menu>`.
+ *
+ * Subscribe to either the projected item's own `itemClick` output (preferred,
+ * per-item handlers) or the parent menu's `menuItemClick` (uniform handler).
+ * Trigger-driven menus close automatically on projected-item click.
+ *
+ * **Note on keyboard navigation:** projected items render as `role="menuitem"`
+ * buttons but do not participate in `CdkMenu` arrow-key navigation (CdkMenuItem
+ * requires its parent `CdkMenu` in the same injector tree, which projection
+ * breaks). For menus that depend on arrow-key navigation between options, use
+ * the `items` input form. Tab/Shift+Tab and Enter/Space activation still work.
+ *
+ * @example
+ * ```html
+ * <tn-menu>
+ *   <tn-menu-item label="JSON" [selected]="format === 'json'"
+ *                 (itemClick)="setFormat('json')" />
+ *   <tn-menu-item label="CSV"  [selected]="format === 'csv'"
+ *                 (itemClick)="setFormat('csv')" />
+ * </tn-menu>
+ * ```
+ */
+declare class TnMenuItemComponent {
+    id: _angular_core.InputSignal<string | undefined>;
+    label: _angular_core.InputSignal<string | undefined>;
+    icon: _angular_core.InputSignal<string | undefined>;
+    iconLibrary: _angular_core.InputSignal<"material" | "mdi" | "custom" | "lucide" | undefined>;
+    shortcut: _angular_core.InputSignal<string | undefined>;
+    disabled: _angular_core.InputSignal<boolean>;
+    selected: _angular_core.InputSignal<boolean>;
+    testId: _angular_core.InputSignal<string | undefined>;
+    itemClick: _angular_core.OutputEmitterRef<MouseEvent>;
+    resolvedTestId: _angular_core.Signal<string | undefined>;
+    handleClick(event: MouseEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnMenuItemComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnMenuItemComponent, "tn-menu-item", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "iconLibrary": { "alias": "iconLibrary"; "required": false; "isSignal": true; }; "shortcut": { "alias": "shortcut"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; }, never, ["*"], true, never>;
+}
+
 /**
  * Directive that attaches a menu to any element.
  * Usage: <button [tnMenuTriggerFor]="menu">Open Menu</button>
@@ -2500,6 +2646,24 @@ declare class TnMenuHarness extends ComponentHarness {
      * Gets the number of menu items (excluding separators).
      */
     getItemCount(): Promise<number>;
+    /**
+     * Checks whether a menu item is marked as the currently-selected option
+     * (i.e. has `aria-current="true"`).
+     *
+     * @example
+     * ```typescript
+     * const menu = await rootLoader.getHarness(TnMenuHarness);
+     * expect(await menu.isItemSelected({ label: 'JSON' })).toBe(true);
+     * ```
+     */
+    isItemSelected(filter: {
+        label: string | RegExp;
+    }): Promise<boolean>;
+    /**
+     * Gets the label of the currently-selected item, or `null` when no item is
+     * marked as selected.
+     */
+    getSelectedItemLabel(): Promise<string | null>;
 }
 /**
  * A set of criteria that can be used to filter `TnMenuHarness` instances.
@@ -3494,6 +3658,32 @@ declare class TnListOptionComponent implements AfterContentInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnListOptionComponent, "tn-list-option", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, never, ["[tnListIcon], [tnListAvatar]", "[tnListItemTitle], [tnListItemPrimary]", "*", "[tnListItemLine], [tnListItemSecondary]"], true, never>;
 }
 
+/**
+ * Primitive directive that writes a raw `testId` value to whichever attribute name has been
+ * configured via {@link TN_TEST_ATTR} (default `data-testid`).
+ *
+ * Library components should use this directive instead of hard-coding `[attr.data-testid]` so
+ * the attribute name remains centrally controlled and consumers with different conventions
+ * (e.g. `data-test`) can opt in with a single root-level provider.
+ *
+ * @example
+ * ```html
+ * <button [tnTestId]="myTestId()">Click me</button>
+ * ```
+ *
+ * Passing `null` / `undefined` / `''` removes the attribute entirely (avoids `data-testid=""`).
+ */
+declare class TnTestIdDirective {
+    private readonly renderer;
+    private readonly host;
+    private readonly attrName;
+    /** The raw test-id value to apply. Falsy values remove the attribute. */
+    readonly testId: _angular_core.InputSignal<string | null | undefined>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnTestIdDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TnTestIdDirective, "[tnTestId]", never, { "testId": { "alias": "tnTestId"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 interface TnSelectionChange {
     source: TnSelectionListComponent;
     options: TnListOptionComponent[];
@@ -3517,7 +3707,7 @@ declare class TnSelectionListComponent implements ControlValueAccessor {
     onOptionSelectionChange(): void;
     get selectedOptions(): TnListOptionComponent[];
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnSelectionListComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnSelectionListComponent, "tn-selection-list", never, { "dense": { "alias": "dense"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, ["options"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnSelectionListComponent, "tn-selection-list", never, { "dense": { "alias": "dense"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, ["options"], ["*"], true, [{ directive: typeof TnTestIdDirective; inputs: { "tnTestId": "testId"; }; outputs: {}; }]>;
 }
 
 declare class TnHeaderCellDefDirective {
@@ -3614,7 +3804,7 @@ declare class TnTableComponent<T = unknown> implements OnInit {
     getColumnDef(columnName: string): TnTableColumnDirective | undefined;
     getCellValue(row: T, column: string): unknown;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnTableComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnTableComponent<any>, "tn-table", never, { "dataSource": { "alias": "dataSource"; "required": false; "isSignal": true; }; "displayedColumns": { "alias": "displayedColumns"; "required": false; "isSignal": true; }; "trackBy": { "alias": "trackBy"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "emptyIcon": { "alias": "emptyIcon"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; }, { "sortChange": "sortChange"; "selectionChange": "selectionChange"; }, ["columnDefs", "detailRowDef"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnTableComponent<any>, "tn-table", never, { "dataSource": { "alias": "dataSource"; "required": false; "isSignal": true; }; "displayedColumns": { "alias": "displayedColumns"; "required": false; "isSignal": true; }; "trackBy": { "alias": "trackBy"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "emptyIcon": { "alias": "emptyIcon"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; }, { "sortChange": "sortChange"; "selectionChange": "selectionChange"; }, ["columnDefs", "detailRowDef"], never, true, [{ directive: typeof TnTestIdDirective; inputs: { "tnTestId": "testId"; }; outputs: {}; }]>;
 }
 
 /**
@@ -3790,7 +3980,7 @@ declare class TnTreeFlatDataSource<T, F> extends DataSource<F> {
 declare class TnTreeComponent<T, K = T> extends CdkTree<T, K> {
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnTreeComponent<any, any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnTreeComponent<any, any>, "tn-tree", ["tnTree"], {}, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnTreeComponent<any, any>, "tn-tree", ["tnTree"], {}, {}, never, never, true, [{ directive: typeof TnTestIdDirective; inputs: { "tnTestId": "testId"; }; outputs: {}; }]>;
 }
 
 declare class TnTreeNodeComponent<T, K = T> extends CdkTreeNode<T, K> {
@@ -3802,7 +3992,7 @@ declare class TnTreeNodeComponent<T, K = T> extends CdkTreeNode<T, K> {
     /** Whether the tree node is expanded */
     get isExpanded(): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnTreeNodeComponent<any, any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnTreeNodeComponent<any, any>, "tn-tree-node", ["tnTreeNode"], {}, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnTreeNodeComponent<any, any>, "tn-tree-node", ["tnTreeNode"], {}, {}, never, ["*"], true, [{ directive: typeof TnTestIdDirective; inputs: { "tnTestId": "testId"; }; outputs: {}; }]>;
 }
 
 declare class TnNestedTreeNodeComponent<T, K = T> extends CdkNestedTreeNode<T, K> {
@@ -4172,6 +4362,11 @@ interface DateRange {
 declare class TnDateRangeInputComponent implements ControlValueAccessor, OnInit, OnDestroy {
     disabled: _angular_core.InputSignal<boolean>;
     placeholder: _angular_core.InputSignal<string>;
+    /**
+     * Test-id applied to the date-range-input container. Rendered under whichever attribute name
+     * is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId: _angular_core.InputSignal<string | undefined>;
     private formDisabled;
     isDisabled: _angular_core.Signal<boolean>;
     startMonthRef: _angular_core.Signal<ElementRef<HTMLInputElement>>;
@@ -4220,7 +4415,7 @@ declare class TnDateRangeInputComponent implements ControlValueAccessor, OnInit,
     close(): void;
     private createOverlay;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnDateRangeInputComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnDateRangeInputComponent, "tn-date-range-input", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnDateRangeInputComponent, "tn-date-range-input", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class TnCalendarComponent implements OnInit {
@@ -4260,7 +4455,7 @@ declare class TnCalendarComponent implements OnInit {
      */
     resetInteractionState(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnCalendarComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnCalendarComponent, "tn-calendar", never, { "startView": { "alias": "startView"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "dateFilter": { "alias": "dateFilter"; "required": false; "isSignal": true; }; "rangeMode": { "alias": "rangeMode"; "required": false; "isSignal": true; }; "selectedRange": { "alias": "selectedRange"; "required": false; "isSignal": true; }; }, { "selectedChange": "selectedChange"; "activeDateChange": "activeDateChange"; "viewChanged": "viewChanged"; "selectedRangeChange": "selectedRangeChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnCalendarComponent, "tn-calendar", never, { "startView": { "alias": "startView"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "dateFilter": { "alias": "dateFilter"; "required": false; "isSignal": true; }; "rangeMode": { "alias": "rangeMode"; "required": false; "isSignal": true; }; "selectedRange": { "alias": "selectedRange"; "required": false; "isSignal": true; }; }, { "selectedChange": "selectedChange"; "activeDateChange": "activeDateChange"; "viewChanged": "viewChanged"; "selectedRangeChange": "selectedRangeChange"; }, never, never, true, [{ directive: typeof TnTestIdDirective; inputs: { "tnTestId": "testId"; }; outputs: {}; }]>;
 }
 
 declare class TnCalendarHeaderComponent {
@@ -4372,6 +4567,11 @@ declare class TnDateInputComponent implements ControlValueAccessor, OnInit, OnDe
     min: _angular_core.InputSignal<Date | undefined>;
     max: _angular_core.InputSignal<Date | undefined>;
     dateFilter: _angular_core.InputSignal<((date: Date) => boolean) | undefined>;
+    /**
+     * Test-id applied to the date-input container. Rendered under whichever attribute name
+     * is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId: _angular_core.InputSignal<string | undefined>;
     private formDisabled;
     isDisabled: _angular_core.Signal<boolean>;
     monthRef: _angular_core.Signal<ElementRef<HTMLInputElement>>;
@@ -4409,7 +4609,7 @@ declare class TnDateInputComponent implements ControlValueAccessor, OnInit, OnDe
     close(): void;
     private createOverlay;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnDateInputComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnDateInputComponent, "tn-date-input", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "dateFilter": { "alias": "dateFilter"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnDateInputComponent, "tn-date-input", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "dateFilter": { "alias": "dateFilter"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -4674,6 +4874,11 @@ declare class TnSliderComponent implements ControlValueAccessor, OnDestroy, Afte
     labelPrefix: _angular_core.InputSignal<string>;
     labelSuffix: _angular_core.InputSignal<string>;
     labelType: _angular_core.InputSignal<LabelType>;
+    /**
+     * Test-id applied to the slider's root container. Rendered under whichever attribute name
+     * is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId: _angular_core.InputSignal<string | undefined>;
     thumbDirective: _angular_core.Signal<TnSliderThumbDirective>;
     sliderContainer: _angular_core.Signal<ElementRef<HTMLDivElement>>;
     thumbVisual: _angular_core.Signal<ElementRef<HTMLDivElement>>;
@@ -4709,7 +4914,7 @@ declare class TnSliderComponent implements ControlValueAccessor, OnDestroy, Afte
     private onInteractionStart;
     private onInteractionEnd;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnSliderComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnSliderComponent, "tn-slider", never, { "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "labelPrefix": { "alias": "labelPrefix"; "required": false; "isSignal": true; }; "labelSuffix": { "alias": "labelSuffix"; "required": false; "isSignal": true; }; "labelType": { "alias": "labelType"; "required": false; "isSignal": true; }; }, {}, ["thumbDirective"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnSliderComponent, "tn-slider", never, { "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "labelPrefix": { "alias": "labelPrefix"; "required": false; "isSignal": true; }; "labelSuffix": { "alias": "labelSuffix"; "required": false; "isSignal": true; }; "labelType": { "alias": "labelType"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; }, {}, ["thumbDirective"], ["*"], true, never>;
 }
 
 declare class TnSliderWithLabelDirective implements OnInit, OnDestroy {
@@ -4734,6 +4939,11 @@ declare class TnButtonToggleGroupComponent implements ControlValueAccessor {
     name: _angular_core.InputSignal<string>;
     ariaLabel: _angular_core.InputSignal<string>;
     ariaLabelledby: _angular_core.InputSignal<string>;
+    /**
+     * Test-id applied to the group root. Rendered under whichever attribute name
+     * is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId: _angular_core.InputSignal<string | undefined>;
     change: _angular_core.OutputEmitterRef<{
         source: TnButtonToggleComponent;
         value: unknown;
@@ -4755,7 +4965,7 @@ declare class TnButtonToggleGroupComponent implements ControlValueAccessor {
     private updateTogglesFromValue;
     private updateTogglesFromValues;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnButtonToggleGroupComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnButtonToggleGroupComponent, "tn-button-toggle-group", never, { "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "ariaLabelledby"; "required": false; "isSignal": true; }; }, { "change": "change"; }, ["buttonToggles"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnButtonToggleGroupComponent, "tn-button-toggle-group", never, { "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "ariaLabelledby"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; }, { "change": "change"; }, ["buttonToggles"], ["*"], true, never>;
 }
 
 declare class TnButtonToggleComponent implements ControlValueAccessor {
@@ -4767,6 +4977,11 @@ declare class TnButtonToggleComponent implements ControlValueAccessor {
     checked: _angular_core.WritableSignal<boolean>;
     ariaLabel: _angular_core.InputSignal<string>;
     ariaLabelledby: _angular_core.InputSignal<string>;
+    /**
+     * Test-id applied to the rendered toggle button. Rendered under whichever attribute name
+     * is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId: _angular_core.InputSignal<string | undefined>;
     change: _angular_core.OutputEmitterRef<{
         source: TnButtonToggleComponent;
         value: unknown;
@@ -4786,7 +5001,7 @@ declare class TnButtonToggleComponent implements ControlValueAccessor {
     _markForCheck(): void;
     _markForUncheck(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnButtonToggleComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnButtonToggleComponent, "tn-button-toggle", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "ariaLabelledby"; "required": false; "isSignal": true; }; }, { "change": "change"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnButtonToggleComponent, "tn-button-toggle", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "ariaLabelledby"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; }, { "change": "change"; }, never, ["*"], true, never>;
 }
 
 /**
@@ -5285,6 +5500,15 @@ declare class TnSidePanelComponent implements OnDestroy {
     hasBackdrop: _angular_core.InputSignal<boolean>;
     closeOnBackdropClick: _angular_core.InputSignal<boolean>;
     closeOnEscape: _angular_core.InputSignal<boolean>;
+    /**
+     * Test-id applied to the panel's root overlay element. Rendered under whichever attribute
+     * name is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Test-id applied to the panel's close (×) button.
+     */
+    closeButtonTestId: _angular_core.InputSignal<string | undefined>;
     opened: _angular_core.OutputEmitterRef<void>;
     closed: _angular_core.OutputEmitterRef<void>;
     private actionContent;
@@ -5301,7 +5525,7 @@ declare class TnSidePanelComponent implements OnDestroy {
     private restoreFocus;
     private registerMdiIcons;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnSidePanelComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnSidePanelComponent, "tn-side-panel", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "hasBackdrop": { "alias": "hasBackdrop"; "required": false; "isSignal": true; }; "closeOnBackdropClick": { "alias": "closeOnBackdropClick"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "opened": "opened"; "closed": "closed"; }, ["actionContent"], ["[tnSidePanelHeaderAction]", "*", "[tnSidePanelAction]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnSidePanelComponent, "tn-side-panel", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "hasBackdrop": { "alias": "hasBackdrop"; "required": false; "isSignal": true; }; "closeOnBackdropClick": { "alias": "closeOnBackdropClick"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; "closeButtonTestId": { "alias": "closeButtonTestId"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "opened": "opened"; "closed": "closed"; }, ["actionContent"], ["[tnSidePanelHeaderAction]", "*", "[tnSidePanelAction]"], true, never>;
 }
 
 interface SidePanelHarnessFilters extends BaseHarnessFilters {
@@ -5353,6 +5577,11 @@ declare class TnStepperComponent {
     orientation: _angular_core.InputSignal<"auto" | "horizontal" | "vertical">;
     linear: _angular_core.InputSignal<boolean>;
     selectedIndex: _angular_core.ModelSignal<number>;
+    /**
+     * Test-id applied to the stepper root. Rendered under whichever attribute name
+     * is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId: _angular_core.InputSignal<string | undefined>;
     selectionChange: _angular_core.OutputEmitterRef<{
         selectedIndex: number;
         previouslySelectedIndex: number;
@@ -5374,7 +5603,7 @@ declare class TnStepperComponent {
     previous(): void;
     _trackByStepIndex(index: number): number;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnStepperComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnStepperComponent, "tn-stepper", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "linear": { "alias": "linear"; "required": false; "isSignal": true; }; "selectedIndex": { "alias": "selectedIndex"; "required": false; "isSignal": true; }; }, { "selectedIndex": "selectedIndexChange"; "selectionChange": "selectionChange"; "completed": "completed"; }, ["steps"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnStepperComponent, "tn-stepper", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "linear": { "alias": "linear"; "required": false; "isSignal": true; }; "selectedIndex": { "alias": "selectedIndex"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; }, { "selectedIndex": "selectedIndexChange"; "selectionChange": "selectionChange"; "completed": "completed"; }, ["steps"], never, true, never>;
 }
 
 declare class TnFilePickerComponent implements ControlValueAccessor, OnInit, OnDestroy {
@@ -5386,6 +5615,11 @@ declare class TnFilePickerComponent implements ControlValueAccessor, OnInit, OnD
     allowManualInput: _angular_core.InputSignal<boolean>;
     placeholder: _angular_core.InputSignal<string>;
     disabled: _angular_core.InputSignal<boolean>;
+    /**
+     * Test-id applied to the file-picker container. Rendered under whichever attribute name
+     * is configured via `TN_TEST_ATTR` (default `data-testid`).
+     */
+    testId: _angular_core.InputSignal<string | undefined>;
     startPath: _angular_core.InputSignal<string>;
     rootPath: _angular_core.InputSignal<string | undefined>;
     fileExtensions: _angular_core.InputSignal<string[] | undefined>;
@@ -5444,7 +5678,7 @@ declare class TnFilePickerComponent implements ControlValueAccessor, OnInit, OnD
     private emitError;
     private createOverlay;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnFilePickerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnFilePickerComponent, "tn-file-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "multiSelect": { "alias": "multiSelect"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "allowDatasetCreate": { "alias": "allowDatasetCreate"; "required": false; "isSignal": true; }; "allowZvolCreate": { "alias": "allowZvolCreate"; "required": false; "isSignal": true; }; "allowManualInput": { "alias": "allowManualInput"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "startPath": { "alias": "startPath"; "required": false; "isSignal": true; }; "rootPath": { "alias": "rootPath"; "required": false; "isSignal": true; }; "fileExtensions": { "alias": "fileExtensions"; "required": false; "isSignal": true; }; "callbacks": { "alias": "callbacks"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; "pathChange": "pathChange"; "createFolder": "createFolder"; "error": "error"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnFilePickerComponent, "tn-file-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "multiSelect": { "alias": "multiSelect"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "allowDatasetCreate": { "alias": "allowDatasetCreate"; "required": false; "isSignal": true; }; "allowZvolCreate": { "alias": "allowZvolCreate"; "required": false; "isSignal": true; }; "allowManualInput": { "alias": "allowManualInput"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; "startPath": { "alias": "startPath"; "required": false; "isSignal": true; }; "rootPath": { "alias": "rootPath"; "required": false; "isSignal": true; }; "fileExtensions": { "alias": "fileExtensions"; "required": false; "isSignal": true; }; "callbacks": { "alias": "callbacks"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; "pathChange": "pathChange"; "createFolder": "createFolder"; "error": "error"; }, never, never, true, never>;
 }
 
 declare class TnFilePickerPopupComponent implements OnInit, AfterViewInit, AfterViewChecked {
@@ -5535,14 +5769,20 @@ declare class TnEmptyComponent {
     description: _angular_core.InputSignal<string | undefined>;
     icon: _angular_core.InputSignal<string | undefined>;
     iconLibrary: _angular_core.InputSignal<IconLibraryType>;
+    /**
+     * Overrides the icon size derived from `size`. Accepts any valid CSS size value
+     * (e.g. `'48px'`, `'3rem'`). Use this when the variant presets are too small for an
+     * empty-state illustration. When unset, the icon falls back to the `size`-based preset.
+     */
+    iconSize: _angular_core.InputSignal<string | undefined>;
     actionText: _angular_core.InputSignal<string | undefined>;
     bordered: _angular_core.InputSignal<boolean>;
     size: _angular_core.InputSignal<TnEmptySize>;
     onAction: _angular_core.OutputEmitterRef<void>;
     protected hasAction: _angular_core.Signal<boolean>;
-    iconSize: _angular_core.Signal<"lg" | "xl">;
+    protected iconSizePreset: _angular_core.Signal<"lg" | "xl">;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnEmptyComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnEmptyComponent, "tn-empty", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "iconLibrary": { "alias": "iconLibrary"; "required": false; "isSignal": true; }; "actionText": { "alias": "actionText"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, { "onAction": "onAction"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnEmptyComponent, "tn-empty", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "iconLibrary": { "alias": "iconLibrary"; "required": false; "isSignal": true; }; "iconSize": { "alias": "iconSize"; "required": false; "isSignal": true; }; "actionText": { "alias": "actionText"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, { "onAction": "onAction"; }, never, never, true, never>;
 }
 
 /**
@@ -5883,6 +6123,32 @@ declare class TnKeyboardShortcutService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<TnKeyboardShortcutService>;
 }
 
+/**
+ * Test-id attribute names supported by the library.
+ *
+ * - `'data-testid'` is the modern industry default and the library's out-of-the-box behavior.
+ * - `'data-test'` exists for consumers that have an established convention they don't want to disrupt
+ *   (notably webui, which has thousands of selectors targeting `data-test`).
+ */
+type TnTestAttrName = 'data-test' | 'data-testid';
+/**
+ * Controls which attribute name the library renders `testId` values to.
+ *
+ * Defaults to `'data-testid'`. Consumers can override at the application root:
+ *
+ * ```ts
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     { provide: TN_TEST_ATTR, useValue: 'data-test' },
+ *   ],
+ * });
+ * ```
+ *
+ * Every component-level `testId` input and every `[tnTestId]` directive usage reads this token
+ * so that a single override switches the entire library consistently.
+ */
+declare const TN_TEST_ATTR: InjectionToken<TnTestAttrName>;
+
 /**
  * Enum of available theme names.
  * Use these constants instead of hardcoded strings.
@@ -6077,5 +6343,5 @@ declare const TN_THEME_DEFINITIONS: readonly TnThemeDefinition[];
  */
 declare const THEME_MAP: Map<TnTheme, TnThemeDefinition>;
 
-export { CommonShortcuts, DEFAULT_THEME, DiskIconComponent, DiskType, FileSizePipe, InputType, LIGHT_THEME, LinuxModifierKeys, LinuxShortcuts, ModifierKeys, QuickShortcuts, ShortcutBuilder, StripMntPrefixPipe, THEME_MAP, THEME_STORAGE_KEY, TN_THEME_DEFINITIONS, TnAutocompleteComponent, TnAutocompleteHarness, TnBannerActionDirective, TnBannerComponent, TnBannerHarness, TnBrandedSpinnerComponent, TnButtonComponent, TnButtonHarness, TnButtonToggleComponent, TnButtonToggleGroupComponent, TnButtonToggleGroupHarness, TnButtonToggleHarness, TnCalendarComponent, TnCalendarHeaderComponent, TnCardComponent, TnCardHeaderDirective, TnCellDefDirective, TnCheckboxComponent, TnCheckboxHarness, TnCheckboxLabelDirective, TnChipComponent, TnConfirmDialogComponent, TnDateInputComponent, TnDateInputHarness, TnDateRangeInputComponent, TnDateRangeInputHarness, TnDetailRowDefDirective, TnDialog, TnDialogHarness, TnDialogShellComponent, TnDialogTesting, TnDividerComponent, TnDividerDirective, TnDrawerComponent, TnDrawerContainerComponent, TnDrawerContainerHarness, TnDrawerContentComponent, TnDrawerHarness, TnEmptyComponent, TnEmptyHarness, TnExpansionPanelComponent, TnExpansionPanelHarness, TnFilePickerComponent, TnFilePickerPopupComponent, TnFormFieldComponent, TnFormFieldHarness, TnHeaderCellDefDirective, TnIconButtonComponent, TnIconButtonHarness, TnIconComponent, TnIconHarness, TnIconRegistryService, TnIconTesting, TnInputComponent, TnInputDirective, TnInputHarness, TnKeyboardShortcutComponent, TnKeyboardShortcutService, TnListAvatarDirective, TnListComponent, TnListIconDirective, TnListItemComponent, TnListItemLineDirective, TnListItemPrimaryDirective, TnListItemSecondaryDirective, TnListItemTitleDirective, TnListItemTrailingDirective, TnListOptionComponent, TnListSubheaderComponent, TnMenuActivateHoverDirective, TnMenuComponent, TnMenuHarness, TnMenuTesting, TnMenuTriggerDirective, TnMonthViewComponent, TnMultiYearViewComponent, TnNestedTreeNodeComponent, TnParticleProgressBarComponent, TnProgressBarComponent, TnRadioComponent, TnRadioHarness, TnSelectComponent, TnSelectHarness, TnSelectionListComponent, TnSidePanelActionDirective, TnSidePanelComponent, TnSidePanelHarness, TnSidePanelHeaderActionDirective, TnSlideToggleComponent, TnSlideToggleHarness, TnSliderComponent, TnSliderThumbDirective, TnSliderWithLabelDirective, TnSpinnerComponent, TnSpriteLoaderService, TnStepComponent, TnStepperComponent, TnTabComponent, TnTabHarness, TnTabPanelComponent, TnTabPanelHarness, TnTableColumnDirective, TnTableComponent, TnTableHarness, TnTabsComponent, TnTabsHarness, TnTheme, TnThemeService, TnTimeInputComponent, TnToastComponent, TnToastMock, TnToastPosition, TnToastRef, TnToastService, TnToastTesting, TnToastType, TnTooltipComponent, TnTooltipDirective, TnTreeComponent, TnTreeFlatDataSource, TnTreeFlattener, TnTreeNodeComponent, TnTreeNodeOutletDirective, TruncatePathPipe, WindowsModifierKeys, WindowsShortcuts, createLucideLibrary, createShortcut, defaultSpriteBasePath, defaultSpriteConfigPath, libIconMarker, registerLucideIcons, setupLucideIntegration, tnIconMarker };
-export type { AutocompleteHarnessFilters, BannerHarnessFilters, ButtonHarnessFilters, ButtonToggleHarnessFilters, CalendarCell, CheckboxHarnessFilters, ChipColor, CreateFolderEvent, DateInputHarnessFilters, DateRange, DateRangeInputHarnessFilters, DialogHarnessFilters, EmptyHarnessFilters, ExpansionPanelHarnessFilters, FilePickerCallbacks, FilePickerError, FilePickerMode, FileSystemItem, FormFieldHarnessFilters, IconButtonHarnessFilters, IconHarnessFilters, IconLibrary, IconLibraryType, IconResult, IconSize, IconSource, IconTestingMockOverrides, InputHarnessFilters, KeyCombination, LabelType, LucideIconOptions, MenuHarnessFilters, MockIconRegistry, MockSpriteLoader, PathSegment, PlatformType, ProgressBarMode, RadioHarnessFilters, ResolvedIcon, SelectHarnessFilters, ShortcutHandler, SidePanelHarnessFilters, SlideToggleColor, SlideToggleHarnessFilters, SpinnerMode, SpriteConfig, SubscriptSizing, TabChangeEvent, TabHarnessFilters, TabPanelHarnessFilters, TabsHarnessFilters, TnBannerType, TnButtonToggleType, TnCardAction, TnCardControl, TnCardFooterLink, TnCardHeaderStatus, TnConfirmDialogData, TnDialogDefaults, TnDialogOpenTarget, TnDrawerMode, TnDrawerPosition, TnEmptySize, TnFlatTreeNode, TnMenuItem, TnSelectOption, TnSelectOptionGroup, TnSelectionChange, TnSortEvent, TnTableDataSource, TnTableHarnessFilters, TnThemeDefinition, TnToastCall, TnToastConfig, TooltipPosition, YearCell };
+export { CommonShortcuts, DEFAULT_THEME, DiskIconComponent, DiskType, FileSizePipe, InputType, LIGHT_THEME, LinuxModifierKeys, LinuxShortcuts, ModifierKeys, QuickShortcuts, ShortcutBuilder, StripMntPrefixPipe, THEME_MAP, THEME_STORAGE_KEY, TN_TEST_ATTR, TN_THEME_DEFINITIONS, TnAutocompleteComponent, TnAutocompleteHarness, TnBannerActionDirective, TnBannerComponent, TnBannerHarness, TnBrandedSpinnerComponent, TnButtonComponent, TnButtonHarness, TnButtonToggleComponent, TnButtonToggleGroupComponent, TnButtonToggleGroupHarness, TnButtonToggleHarness, TnCalendarComponent, TnCalendarHeaderComponent, TnCardComponent, TnCardHeaderDirective, TnCellDefDirective, TnCheckboxComponent, TnCheckboxHarness, TnCheckboxLabelDirective, TnChipComponent, TnConfirmDialogComponent, TnDateInputComponent, TnDateInputHarness, TnDateRangeInputComponent, TnDateRangeInputHarness, TnDetailRowDefDirective, TnDialog, TnDialogHarness, TnDialogShellComponent, TnDialogTesting, TnDividerComponent, TnDividerDirective, TnDrawerComponent, TnDrawerContainerComponent, TnDrawerContainerHarness, TnDrawerContentComponent, TnDrawerHarness, TnEmptyComponent, TnEmptyHarness, TnExpansionPanelComponent, TnExpansionPanelHarness, TnFilePickerComponent, TnFilePickerPopupComponent, TnFormFieldComponent, TnFormFieldHarness, TnHeaderCellDefDirective, TnIconButtonComponent, TnIconButtonHarness, TnIconComponent, TnIconHarness, TnIconRegistryService, TnIconTesting, TnInputComponent, TnInputDirective, TnInputHarness, TnKeyboardShortcutComponent, TnKeyboardShortcutService, TnListAvatarDirective, TnListComponent, TnListIconDirective, TnListItemComponent, TnListItemLineDirective, TnListItemPrimaryDirective, TnListItemSecondaryDirective, TnListItemTitleDirective, TnListItemTrailingDirective, TnListOptionComponent, TnListSubheaderComponent, TnMenuActivateHoverDirective, TnMenuComponent, TnMenuHarness, TnMenuItemComponent, TnMenuTesting, TnMenuTriggerDirective, TnMonthViewComponent, TnMultiYearViewComponent, TnNestedTreeNodeComponent, TnParticleProgressBarComponent, TnProgressBarComponent, TnRadioComponent, TnRadioHarness, TnSelectComponent, TnSelectHarness, TnSelectionListComponent, TnSidePanelActionDirective, TnSidePanelComponent, TnSidePanelHarness, TnSidePanelHeaderActionDirective, TnSlideToggleComponent, TnSlideToggleHarness, TnSliderComponent, TnSliderThumbDirective, TnSliderWithLabelDirective, TnSpinnerComponent, TnSpriteLoaderService, TnStepComponent, TnStepperComponent, TnTabComponent, TnTabHarness, TnTabPanelComponent, TnTabPanelHarness, TnTableColumnDirective, TnTableComponent, TnTableHarness, TnTabsComponent, TnTabsHarness, TnTestIdDirective, TnTheme, TnThemeService, TnTimeInputComponent, TnToastComponent, TnToastMock, TnToastPosition, TnToastRef, TnToastService, TnToastTesting, TnToastType, TnTooltipComponent, TnTooltipDirective, TnTreeComponent, TnTreeFlatDataSource, TnTreeFlattener, TnTreeNodeComponent, TnTreeNodeOutletDirective, TruncatePathPipe, WindowsModifierKeys, WindowsShortcuts, createLucideLibrary, createShortcut, defaultSpriteBasePath, defaultSpriteConfigPath, libIconMarker, registerLucideIcons, setupLucideIntegration, tnIconMarker };
+export type { AutocompleteHarnessFilters, BannerHarnessFilters, ButtonHarnessFilters, ButtonToggleHarnessFilters, CalendarCell, CheckboxHarnessFilters, ChipColor, CreateFolderEvent, DateInputHarnessFilters, DateRange, DateRangeInputHarnessFilters, DialogHarnessFilters, EmptyHarnessFilters, ExpansionPanelHarnessFilters, FilePickerCallbacks, FilePickerError, FilePickerMode, FileSystemItem, FormFieldHarnessFilters, IconButtonHarnessFilters, IconHarnessFilters, IconLibrary, IconLibraryType, IconResult, IconSize, IconSource, IconTestingMockOverrides, InputHarnessFilters, KeyCombination, LabelType, LucideIconOptions, MenuHarnessFilters, MockIconRegistry, MockSpriteLoader, PathSegment, PlatformType, ProgressBarMode, RadioHarnessFilters, ResolvedIcon, SelectHarnessFilters, ShortcutHandler, SidePanelHarnessFilters, SlideToggleColor, SlideToggleHarnessFilters, SpinnerMode, SpriteConfig, SubscriptSizing, TabChangeEvent, TabHarnessFilters, TabPanelHarnessFilters, TabsHarnessFilters, TnBannerType, TnButtonToggleType, TnCardAction, TnCardControl, TnCardFooterLink, TnCardHeaderStatus, TnConfirmDialogData, TnDialogDefaults, TnDialogOpenTarget, TnDrawerMode, TnDrawerPosition, TnEmptySize, TnFlatTreeNode, TnMenuItem, TnSelectOption, TnSelectOptionGroup, TnSelectionChange, TnSortEvent, TnTableDataSource, TnTableHarnessFilters, TnTestAttrName, TnThemeDefinition, TnToastCall, TnToastConfig, TooltipPosition, YearCell };