@truenas/ui-components 0.1.13 → 0.1.15

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

@@ -465,6 +465,14 @@ declare class TnInputComponent implements AfterViewInit, ControlValueAccessor {
     disabled: _angular_core.InputSignal<boolean>;
     multiline: _angular_core.InputSignal<boolean>;
     rows: _angular_core.InputSignal<number>;
+    prefixIcon: _angular_core.InputSignal<string | undefined>;
+    prefixIconLibrary: _angular_core.InputSignal<IconLibraryType | undefined>;
+    suffixIcon: _angular_core.InputSignal<string | undefined>;
+    suffixIconLibrary: _angular_core.InputSignal<IconLibraryType | undefined>;
+    suffixIconAriaLabel: _angular_core.InputSignal<string | undefined>;
+    onSuffixAction: _angular_core.OutputEmitterRef<MouseEvent>;
+    hasPrefixIcon: _angular_core.Signal<boolean>;
+    hasSuffixIcon: _angular_core.Signal<boolean>;
     id: string;
     value: string;
     private formDisabled;
@@ -480,7 +488,308 @@ declare class TnInputComponent implements AfterViewInit, ControlValueAccessor {
     onValueChange(event: Event): void;
     onBlur(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TnInputComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnInputComponent, "tn-input", never, { "inputType": { "alias": "inputType"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "multiline": { "alias": "multiline"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TnInputComponent, "tn-input", never, { "inputType": { "alias": "inputType"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "multiline": { "alias": "multiline"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "prefixIcon": { "alias": "prefixIcon"; "required": false; "isSignal": true; }; "prefixIconLibrary": { "alias": "prefixIconLibrary"; "required": false; "isSignal": true; }; "suffixIcon": { "alias": "suffixIcon"; "required": false; "isSignal": true; }; "suffixIconLibrary": { "alias": "suffixIconLibrary"; "required": false; "isSignal": true; }; "suffixIconAriaLabel": { "alias": "suffixIconAriaLabel"; "required": false; "isSignal": true; }; }, { "onSuffixAction": "onSuffixAction"; }, never, never, true, never>;
+}
+
+/**
+ * Harness for interacting with tn-icon in tests.
+ * Provides filtering by icon name and library for existence checks, as well as click interaction.
+ *
+ * @example
+ * ```typescript
+ * // Check for existence
+ * const icon = await loader.getHarness(TnIconHarness);
+ *
+ * // Find icon by name
+ * const folderIcon = await loader.getHarness(
+ *   TnIconHarness.with({ name: 'folder' })
+ * );
+ *
+ * // Find icon by name and library
+ * const mdiIcon = await loader.getHarness(
+ *   TnIconHarness.with({ name: 'account-circle', library: 'mdi' })
+ * );
+ *
+ * // Check if icon exists
+ * const hasIcon = await loader.hasHarness(
+ *   TnIconHarness.with({ name: 'check' })
+ * );
+ *
+ * // Click an icon
+ * const closeIcon = await loader.getHarness(
+ *   TnIconHarness.with({ name: 'close' })
+ * );
+ * await closeIcon.click();
+ * ```
+ */
+declare class TnIconHarness extends ComponentHarness {
+    /**
+     * The selector for the host element of a `TnIconComponent` instance.
+     */
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for an icon
+     * with specific attributes.
+     *
+     * @param options Options for filtering which icon instances are considered a match.
+     * @returns A `HarnessPredicate` configured with the given options.
+     *
+     * @example
+     * ```typescript
+     * // Find icon by name
+     * const icon = await loader.getHarness(
+     *   TnIconHarness.with({ name: 'home' })
+     * );
+     *
+     * // Find icon by library
+     * const customIcon = await loader.getHarness(
+     *   TnIconHarness.with({ library: 'custom' })
+     * );
+     *
+     * // Find icon with specific size
+     * const largeIcon = await loader.getHarness(
+     *   TnIconHarness.with({ size: 'lg' })
+     * );
+     * ```
+     */
+    static with(options?: IconHarnessFilters): HarnessPredicate<TnIconHarness>;
+    /**
+     * Gets the icon name.
+     *
+     * @returns Promise resolving to the icon name.
+     *
+     * @example
+     * ```typescript
+     * const icon = await loader.getHarness(TnIconHarness);
+     * const name = await icon.getName();
+     * expect(name).toBe('folder');
+     * ```
+     */
+    getName(): Promise<string | null>;
+    /**
+     * Gets the icon library.
+     *
+     * @returns Promise resolving to the icon library.
+     *
+     * @example
+     * ```typescript
+     * const icon = await loader.getHarness(TnIconHarness);
+     * const library = await icon.getLibrary();
+     * expect(library).toBe('mdi');
+     * ```
+     */
+    getLibrary(): Promise<string | null>;
+    /**
+     * Gets the icon size.
+     *
+     * @returns Promise resolving to the icon size.
+     *
+     * @example
+     * ```typescript
+     * const icon = await loader.getHarness(TnIconHarness);
+     * const size = await icon.getSize();
+     * expect(size).toBe('lg');
+     * ```
+     */
+    getSize(): Promise<string | null>;
+    /**
+     * Gets the icon color.
+     *
+     * @returns Promise resolving to the icon color.
+     *
+     * @example
+     * ```typescript
+     * const icon = await loader.getHarness(TnIconHarness);
+     * const color = await icon.getColor();
+     * expect(color).toBe('primary');
+     * ```
+     */
+    getColor(): Promise<string | null>;
+    /**
+     * Checks if the icon is in full-size mode.
+     *
+     * @returns Promise resolving to true if the icon is full-size, false otherwise.
+     *
+     * @example
+     * ```typescript
+     * const icon = await loader.getHarness(TnIconHarness);
+     * const isFullSize = await icon.isFullSize();
+     * expect(isFullSize).toBe(true);
+     * ```
+     */
+    isFullSize(): Promise<boolean>;
+    /**
+     * Gets the icon custom size.
+     *
+     * @returns Promise resolving to the custom size value, or null if not set.
+     *
+     * @example
+     * ```typescript
+     * const icon = await loader.getHarness(TnIconHarness);
+     * const customSize = await icon.getCustomSize();
+     * expect(customSize).toBe('64px');
+     * ```
+     */
+    getCustomSize(): Promise<string | null>;
+    /**
+     * Checks if the icon is using a custom size.
+     *
+     * @returns Promise resolving to true if a custom size is set, false otherwise.
+     *
+     * @example
+     * ```typescript
+     * const icon = await loader.getHarness(TnIconHarness);
+     * const hasCustomSize = await icon.hasCustomSize();
+     * expect(hasCustomSize).toBe(true);
+     * ```
+     */
+    hasCustomSize(): Promise<boolean>;
+    /**
+     * Clicks the icon.
+     *
+     * @returns Promise that resolves when the click action is complete.
+     *
+     * @example
+     * ```typescript
+     * const icon = await loader.getHarness(TnIconHarness.with({ name: 'close' }));
+     * await icon.click();
+     * ```
+     */
+    click(): Promise<void>;
+}
+/**
+ * A set of criteria that can be used to filter a list of `TnIconHarness` instances.
+ */
+interface IconHarnessFilters extends BaseHarnessFilters {
+    /** Filters by icon name. */
+    name?: string;
+    /** Filters by icon library (material, mdi, custom, lucide). */
+    library?: string;
+    /** Filters by icon size (xs, sm, md, lg, xl). */
+    size?: string;
+    /** Filters by full-size mode. */
+    fullSize?: boolean;
+    /** Filters by custom size value. */
+    customSize?: string;
+}
+
+/**
+ * Harness for interacting with tn-input in tests.
+ * Provides methods for querying state, setting values, and interacting with prefix/suffix icons.
+ *
+ * @example
+ * ```typescript
+ * // Get the input harness
+ * const input = await loader.getHarness(TnInputHarness);
+ *
+ * // Set and read a value
+ * await input.setValue('hello');
+ * expect(await input.getValue()).toBe('hello');
+ *
+ * // Check for prefix icon
+ * expect(await input.hasPrefixIcon()).toBe(true);
+ *
+ * // Click suffix action
+ * await input.clickSuffixAction();
+ * ```
+ */
+declare class TnInputHarness extends ComponentHarness {
+    /**
+     * The selector for the host element of a `TnInputComponent` instance.
+     */
+    static hostSelector: string;
+    private inputEl;
+    private textareaEl;
+    private prefixIconEl;
+    private suffixButton;
+    private suffixIconEl;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for an input
+     * with specific attributes.
+     *
+     * @param options Options for filtering which input instances are considered a match.
+     * @returns A `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: InputHarnessFilters): HarnessPredicate<TnInputHarness>;
+    /**
+     * Gets the current value of the input.
+     *
+     * @returns Promise resolving to the input value.
+     */
+    getValue(): Promise<string>;
+    /**
+     * Sets the value of the input by clearing and typing.
+     *
+     * @param value The value to set.
+     */
+    setValue(value: string): Promise<void>;
+    /**
+     * Gets the placeholder text.
+     *
+     * @returns Promise resolving to the placeholder string.
+     */
+    getPlaceholder(): Promise<string | null>;
+    /**
+     * Checks whether the input is disabled.
+     *
+     * @returns Promise resolving to true if the input is disabled.
+     */
+    isDisabled(): Promise<boolean>;
+    /**
+     * Checks whether the input renders as a textarea.
+     *
+     * @returns Promise resolving to true if multiline.
+     */
+    isMultiline(): Promise<boolean>;
+    /**
+     * Checks whether a prefix icon is present.
+     *
+     * @returns Promise resolving to true if a prefix icon exists.
+     */
+    hasPrefixIcon(): Promise<boolean>;
+    /**
+     * Gets the prefix icon harness for further inspection.
+     *
+     * @returns Promise resolving to the prefix TnIconHarness, or null if not present.
+     */
+    getPrefixIcon(): Promise<TnIconHarness | null>;
+    /**
+     * Checks whether a suffix action button is present.
+     *
+     * @returns Promise resolving to true if a suffix action exists.
+     */
+    hasSuffixAction(): Promise<boolean>;
+    /**
+     * Gets the suffix icon harness for further inspection.
+     *
+     * @returns Promise resolving to the suffix TnIconHarness, or null if not present.
+     */
+    getSuffixIcon(): Promise<TnIconHarness | null>;
+    /**
+     * Clicks the suffix action button.
+     *
+     * @returns Promise that resolves when the click action is complete.
+     */
+    clickSuffixAction(): Promise<void>;
+    /**
+     * Focuses the input element.
+     *
+     * @returns Promise that resolves when the input is focused.
+     */
+    focus(): Promise<void>;
+    /**
+     * Blurs the input element.
+     *
+     * @returns Promise that resolves when the input is blurred.
+     */
+    blur(): Promise<void>;
+}
+/**
+ * A set of criteria that can be used to filter a list of `TnInputHarness` instances.
+ */
+interface InputHarnessFilters extends BaseHarnessFilters {
+    /** Filters by placeholder text. */
+    placeholder?: string;
 }
 
 declare class TnInputDirective {
@@ -730,6 +1039,7 @@ declare class TnTabComponent implements AfterContentInit {
     isActive: _angular_core.WritableSignal<boolean>;
     tabsComponent?: {
         onKeydown: (event: KeyboardEvent, index: number) => void;
+        selectTab: (index: number) => void;
     };
     elementRef: ElementRef<any>;
     protected hasIconContent: _angular_core.WritableSignal<boolean>;
@@ -800,15 +1110,373 @@ declare class TnTabsComponent implements AfterContentInit, AfterViewInit, OnDest
 }
 
 /**
- * Directive that attaches a menu to any element.
- * Usage: <button [tnMenuTriggerFor]="menu">Open Menu</button>
+ * Harness for interacting with tn-tab in tests.
+ * Provides methods for querying individual tab state and simulating selection.
+ *
+ * @example
+ * ```typescript
+ * // Find a tab by label
+ * const tab = await loader.getHarness(TnTabHarness.with({ label: 'Settings' }));
+ *
+ * // Check if active
+ * expect(await tab.isSelected()).toBe(false);
+ *
+ * // Select it
+ * await tab.select();
+ * expect(await tab.isSelected()).toBe(true);
+ * ```
  */
-declare class TnMenuTriggerDirective {
-    menu: _angular_core.InputSignal<TnMenuComponent>;
-    tnMenuPosition: _angular_core.InputSignal<"after" | "before" | "above" | "below">;
-    private overlayRef?;
-    private isMenuOpen;
-    private elementRef;
+declare class TnTabHarness extends ComponentHarness {
+    /**
+     * The selector for the host element of a `TnTabComponent` instance.
+     */
+    static hostSelector: string;
+    private _button;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a tab
+     * with specific attributes.
+     *
+     * @param options Options for filtering which tab instances are considered a match.
+     * @returns A `HarnessPredicate` configured with the given options.
+     *
+     * @example
+     * ```typescript
+     * // Find tab by exact label
+     * const tab = await loader.getHarness(TnTabHarness.with({ label: 'Overview' }));
+     *
+     * // Find tab by regex
+     * const tab = await loader.getHarness(TnTabHarness.with({ label: /settings/i }));
+     * ```
+     */
+    static with(options?: TabHarnessFilters): HarnessPredicate<TnTabHarness>;
+    /**
+     * Gets the tab's label text.
+     *
+     * @returns Promise resolving to the tab's label string.
+     *
+     * @example
+     * ```typescript
+     * const tab = await loader.getHarness(TnTabHarness);
+     * expect(await tab.getLabel()).toBe('Overview');
+     * ```
+     */
+    getLabel(): Promise<string>;
+    /**
+     * Checks whether the tab is currently selected (active).
+     *
+     * @returns Promise resolving to true if the tab is selected.
+     *
+     * @example
+     * ```typescript
+     * const tab = await loader.getHarness(TnTabHarness.with({ label: 'Overview' }));
+     * expect(await tab.isSelected()).toBe(true);
+     * ```
+     */
+    isSelected(): Promise<boolean>;
+    /**
+     * Checks whether the tab is disabled.
+     *
+     * @returns Promise resolving to true if the tab is disabled.
+     *
+     * @example
+     * ```typescript
+     * const tab = await loader.getHarness(TnTabHarness.with({ label: 'Disabled Tab' }));
+     * expect(await tab.isDisabled()).toBe(true);
+     * ```
+     */
+    isDisabled(): Promise<boolean>;
+    /**
+     * Selects the tab by clicking it.
+     *
+     * @returns Promise that resolves when the tab has been clicked.
+     *
+     * @example
+     * ```typescript
+     * const tab = await loader.getHarness(TnTabHarness.with({ label: 'Settings' }));
+     * await tab.select();
+     * ```
+     */
+    select(): Promise<void>;
+    /**
+     * Gets the tab's testId attribute value.
+     *
+     * @returns Promise resolving to the data-testid value, or null if not set.
+     *
+     * @example
+     * ```typescript
+     * const tab = await loader.getHarness(TnTabHarness);
+     * expect(await tab.getTestId()).toBe('my-tab');
+     * ```
+     */
+    getTestId(): Promise<string | null>;
+}
+/**
+ * A set of criteria that can be used to filter a list of `TnTabHarness` instances.
+ */
+interface TabHarnessFilters extends BaseHarnessFilters {
+    /** Filters by tab label text. Supports string or regex matching. */
+    label?: string | RegExp;
+}
+
+/**
+ * Harness for interacting with tn-tab-panel in tests.
+ * Provides methods for querying panel visibility and content.
+ *
+ * @example
+ * ```typescript
+ * // Get all panels
+ * const panels = await loader.getAllHarnesses(TnTabPanelHarness);
+ *
+ * // Check which panel is active
+ * for (const panel of panels) {
+ *   if (await panel.isActive()) {
+ *     const text = await panel.getTextContent();
+ *     expect(text).toContain('Overview');
+ *   }
+ * }
+ * ```
+ */
+declare class TnTabPanelHarness extends ComponentHarness {
+    /**
+     * The selector for the host element of a `TnTabPanelComponent` instance.
+     */
+    static hostSelector: string;
+    private _panel;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a tab panel
+     * with specific attributes.
+     *
+     * @param options Options for filtering which panel instances are considered a match.
+     * @returns A `HarnessPredicate` configured with the given options.
+     *
+     * @example
+     * ```typescript
+     * const panel = await loader.getHarness(
+     *   TnTabPanelHarness.with({ textContains: 'Overview' })
+     * );
+     * ```
+     */
+    static with(options?: TabPanelHarnessFilters): HarnessPredicate<TnTabPanelHarness>;
+    /**
+     * Checks whether the panel is currently active (visible).
+     *
+     * @returns Promise resolving to true if the panel is active.
+     *
+     * @example
+     * ```typescript
+     * const panel = await loader.getHarness(TnTabPanelHarness);
+     * expect(await panel.isActive()).toBe(true);
+     * ```
+     */
+    isActive(): Promise<boolean>;
+    /**
+     * Gets the text content of the panel.
+     *
+     * @returns Promise resolving to the panel's text content.
+     *
+     * @example
+     * ```typescript
+     * const panel = await loader.getHarness(TnTabPanelHarness);
+     * expect(await panel.getTextContent()).toContain('Overview');
+     * ```
+     */
+    getTextContent(): Promise<string>;
+    /**
+     * Gets the panel's testId attribute value.
+     *
+     * @returns Promise resolving to the data-testid value, or null if not set.
+     *
+     * @example
+     * ```typescript
+     * const panel = await loader.getHarness(TnTabPanelHarness);
+     * expect(await panel.getTestId()).toBe('my-panel');
+     * ```
+     */
+    getTestId(): Promise<string | null>;
+}
+/**
+ * A set of criteria that can be used to filter a list of `TnTabPanelHarness` instances.
+ */
+interface TabPanelHarnessFilters extends BaseHarnessFilters {
+    /** Filters by text content within panel. Supports string or regex matching. */
+    textContains?: string | RegExp;
+}
+
+/**
+ * Harness for interacting with tn-tabs in tests.
+ * Provides methods for querying tab state, selecting tabs, and inspecting panels.
+ *
+ * @example
+ * ```typescript
+ * // Get the tabs harness
+ * const tabs = await loader.getHarness(TnTabsHarness);
+ *
+ * // Select a tab by label
+ * await tabs.selectTab({ label: 'Settings' });
+ *
+ * // Get the selected tab label
+ * const selected = await tabs.getSelectedTab();
+ * expect(await selected.getLabel()).toBe('Settings');
+ *
+ * // Get all tab labels
+ * const labels = await tabs.getTabLabels();
+ * expect(labels).toEqual(['Overview', 'Details', 'Settings']);
+ * ```
+ */
+declare class TnTabsHarness extends ComponentHarness {
+    /**
+     * The selector for the host element of a `TnTabsComponent` instance.
+     */
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for tabs
+     * with specific attributes.
+     *
+     * @param options Options for filtering which tabs instances are considered a match.
+     * @returns A `HarnessPredicate` configured with the given options.
+     *
+     * @example
+     * ```typescript
+     * // Find by orientation
+     * const tabs = await loader.getHarness(TnTabsHarness.with({ orientation: 'vertical' }));
+     *
+     * // Find the tab group containing a "Settings" tab
+     * const tabs = await loader.getHarness(TnTabsHarness.with({ hasTab: 'Settings' }));
+     *
+     * // Find by regex
+     * const tabs = await loader.getHarness(TnTabsHarness.with({ hasTab: /settings/i }));
+     * ```
+     */
+    static with(options?: TabsHarnessFilters): HarnessPredicate<TnTabsHarness>;
+    /**
+     * Gets all tab harnesses within this tab group.
+     *
+     * @returns Promise resolving to an array of `TnTabHarness` instances.
+     *
+     * @example
+     * ```typescript
+     * const tabs = await loader.getHarness(TnTabsHarness);
+     * const allTabs = await tabs.getTabs();
+     * expect(allTabs.length).toBe(3);
+     * ```
+     */
+    getTabs(): Promise<TnTabHarness[]>;
+    /**
+     * Gets a specific tab by filter criteria.
+     *
+     * @param filter Optional filter to match a specific tab.
+     * @returns Promise resolving to the matching `TnTabHarness`.
+     *
+     * @example
+     * ```typescript
+     * const tabs = await loader.getHarness(TnTabsHarness);
+     * const settingsTab = await tabs.getTab({ label: 'Settings' });
+     * ```
+     */
+    getTab(filter?: TabHarnessFilters): Promise<TnTabHarness>;
+    /**
+     * Gets all panel harnesses within this tab group.
+     *
+     * @returns Promise resolving to an array of `TnTabPanelHarness` instances.
+     *
+     * @example
+     * ```typescript
+     * const tabs = await loader.getHarness(TnTabsHarness);
+     * const panels = await tabs.getPanels();
+     * expect(panels.length).toBe(3);
+     * ```
+     */
+    getPanels(): Promise<TnTabPanelHarness[]>;
+    /**
+     * Gets all tab labels as strings.
+     *
+     * @returns Promise resolving to an array of tab label strings.
+     *
+     * @example
+     * ```typescript
+     * const tabs = await loader.getHarness(TnTabsHarness);
+     * const labels = await tabs.getTabLabels();
+     * expect(labels).toEqual(['Overview', 'Details', 'Settings']);
+     * ```
+     */
+    getTabLabels(): Promise<string[]>;
+    /**
+     * Gets the currently selected (active) tab.
+     *
+     * @returns Promise resolving to the active `TnTabHarness`.
+     * @throws If no active tab is found.
+     *
+     * @example
+     * ```typescript
+     * const tabs = await loader.getHarness(TnTabsHarness);
+     * const selected = await tabs.getSelectedTab();
+     * expect(await selected.getLabel()).toBe('Overview');
+     * ```
+     */
+    getSelectedTab(): Promise<TnTabHarness>;
+    /**
+     * Selects a tab by filter criteria. Clicks the matching tab button.
+     *
+     * @param filter Filter to identify which tab to select.
+     * @returns Promise that resolves when the tab has been selected.
+     *
+     * @example
+     * ```typescript
+     * const tabs = await loader.getHarness(TnTabsHarness);
+     *
+     * // Select by label
+     * await tabs.selectTab({ label: 'Settings' });
+     *
+     * // Select by regex
+     * await tabs.selectTab({ label: /detail/i });
+     * ```
+     */
+    selectTab(filter: TabHarnessFilters): Promise<void>;
+    /**
+     * Gets the orientation of the tab group.
+     *
+     * @returns Promise resolving to 'horizontal' or 'vertical'.
+     *
+     * @example
+     * ```typescript
+     * const tabs = await loader.getHarness(TnTabsHarness);
+     * expect(await tabs.getOrientation()).toBe('horizontal');
+     * ```
+     */
+    getOrientation(): Promise<string>;
+    /**
+     * Gets the number of tabs.
+     *
+     * @returns Promise resolving to the tab count.
+     *
+     * @example
+     * ```typescript
+     * const tabs = await loader.getHarness(TnTabsHarness);
+     * expect(await tabs.getTabCount()).toBe(3);
+     * ```
+     */
+    getTabCount(): Promise<number>;
+}
+/**
+ * A set of criteria that can be used to filter a list of `TnTabsHarness` instances.
+ */
+interface TabsHarnessFilters extends BaseHarnessFilters {
+    /** Filters by tab group orientation. */
+    orientation?: 'horizontal' | 'vertical';
+    /** Filters by the presence of a tab with a matching label. Supports string or regex. */
+    hasTab?: string | RegExp;
+}
+
+/**
+ * Directive that attaches a menu to any element.
+ * Usage: <button [tnMenuTriggerFor]="menu">Open Menu</button>
+ */
+declare class TnMenuTriggerDirective {
+    menu: _angular_core.InputSignal<TnMenuComponent>;
+    tnMenuPosition: _angular_core.InputSignal<"after" | "before" | "above" | "below">;
+    private overlayRef?;
+    private isMenuOpen;
+    private elementRef;
     private overlay;
     private viewContainerRef;
     onClick(): void;
@@ -1076,188 +1744,6 @@ interface SelectHarnessFilters extends BaseHarnessFilters {
     displayText?: string | RegExp;
 }
 
-/**
- * Harness for interacting with tn-icon in tests.
- * Provides filtering by icon name and library for existence checks, as well as click interaction.
- *
- * @example
- * ```typescript
- * // Check for existence
- * const icon = await loader.getHarness(TnIconHarness);
- *
- * // Find icon by name
- * const folderIcon = await loader.getHarness(
- *   TnIconHarness.with({ name: 'folder' })
- * );
- *
- * // Find icon by name and library
- * const mdiIcon = await loader.getHarness(
- *   TnIconHarness.with({ name: 'account-circle', library: 'mdi' })
- * );
- *
- * // Check if icon exists
- * const hasIcon = await loader.hasHarness(
- *   TnIconHarness.with({ name: 'check' })
- * );
- *
- * // Click an icon
- * const closeIcon = await loader.getHarness(
- *   TnIconHarness.with({ name: 'close' })
- * );
- * await closeIcon.click();
- * ```
- */
-declare class TnIconHarness extends ComponentHarness {
-    /**
-     * The selector for the host element of a `TnIconComponent` instance.
-     */
-    static hostSelector: string;
-    /**
-     * Gets a `HarnessPredicate` that can be used to search for an icon
-     * with specific attributes.
-     *
-     * @param options Options for filtering which icon instances are considered a match.
-     * @returns A `HarnessPredicate` configured with the given options.
-     *
-     * @example
-     * ```typescript
-     * // Find icon by name
-     * const icon = await loader.getHarness(
-     *   TnIconHarness.with({ name: 'home' })
-     * );
-     *
-     * // Find icon by library
-     * const customIcon = await loader.getHarness(
-     *   TnIconHarness.with({ library: 'custom' })
-     * );
-     *
-     * // Find icon with specific size
-     * const largeIcon = await loader.getHarness(
-     *   TnIconHarness.with({ size: 'lg' })
-     * );
-     * ```
-     */
-    static with(options?: IconHarnessFilters): HarnessPredicate<TnIconHarness>;
-    /**
-     * Gets the icon name.
-     *
-     * @returns Promise resolving to the icon name.
-     *
-     * @example
-     * ```typescript
-     * const icon = await loader.getHarness(TnIconHarness);
-     * const name = await icon.getName();
-     * expect(name).toBe('folder');
-     * ```
-     */
-    getName(): Promise<string | null>;
-    /**
-     * Gets the icon library.
-     *
-     * @returns Promise resolving to the icon library.
-     *
-     * @example
-     * ```typescript
-     * const icon = await loader.getHarness(TnIconHarness);
-     * const library = await icon.getLibrary();
-     * expect(library).toBe('mdi');
-     * ```
-     */
-    getLibrary(): Promise<string | null>;
-    /**
-     * Gets the icon size.
-     *
-     * @returns Promise resolving to the icon size.
-     *
-     * @example
-     * ```typescript
-     * const icon = await loader.getHarness(TnIconHarness);
-     * const size = await icon.getSize();
-     * expect(size).toBe('lg');
-     * ```
-     */
-    getSize(): Promise<string | null>;
-    /**
-     * Gets the icon color.
-     *
-     * @returns Promise resolving to the icon color.
-     *
-     * @example
-     * ```typescript
-     * const icon = await loader.getHarness(TnIconHarness);
-     * const color = await icon.getColor();
-     * expect(color).toBe('primary');
-     * ```
-     */
-    getColor(): Promise<string | null>;
-    /**
-     * Checks if the icon is in full-size mode.
-     *
-     * @returns Promise resolving to true if the icon is full-size, false otherwise.
-     *
-     * @example
-     * ```typescript
-     * const icon = await loader.getHarness(TnIconHarness);
-     * const isFullSize = await icon.isFullSize();
-     * expect(isFullSize).toBe(true);
-     * ```
-     */
-    isFullSize(): Promise<boolean>;
-    /**
-     * Gets the icon custom size.
-     *
-     * @returns Promise resolving to the custom size value, or null if not set.
-     *
-     * @example
-     * ```typescript
-     * const icon = await loader.getHarness(TnIconHarness);
-     * const customSize = await icon.getCustomSize();
-     * expect(customSize).toBe('64px');
-     * ```
-     */
-    getCustomSize(): Promise<string | null>;
-    /**
-     * Checks if the icon is using a custom size.
-     *
-     * @returns Promise resolving to true if a custom size is set, false otherwise.
-     *
-     * @example
-     * ```typescript
-     * const icon = await loader.getHarness(TnIconHarness);
-     * const hasCustomSize = await icon.hasCustomSize();
-     * expect(hasCustomSize).toBe(true);
-     * ```
-     */
-    hasCustomSize(): Promise<boolean>;
-    /**
-     * Clicks the icon.
-     *
-     * @returns Promise that resolves when the click action is complete.
-     *
-     * @example
-     * ```typescript
-     * const icon = await loader.getHarness(TnIconHarness.with({ name: 'close' }));
-     * await icon.click();
-     * ```
-     */
-    click(): Promise<void>;
-}
-/**
- * A set of criteria that can be used to filter a list of `TnIconHarness` instances.
- */
-interface IconHarnessFilters extends BaseHarnessFilters {
-    /** Filters by icon name. */
-    name?: string;
-    /** Filters by icon library (material, mdi, custom, lucide). */
-    library?: string;
-    /** Filters by icon size (xs, sm, md, lg, xl). */
-    size?: string;
-    /** Filters by full-size mode. */
-    fullSize?: boolean;
-    /** Filters by custom size value. */
-    customSize?: string;
-}
-
 /**
  * Default base path for sprite assets (namespaced to avoid collisions with consumer apps)
  * This should match the value in sprite-config-interface.ts
@@ -3251,5 +3737,5 @@ declare const TN_THEME_DEFINITIONS: readonly TnThemeDefinition[];
  */
 declare const THEME_MAP: Map<TnTheme, TnThemeDefinition>;
 
-export { CommonShortcuts, DEFAULT_THEME, DiskIconComponent, DiskType, FileSizePipe, InputType, LinuxModifierKeys, LinuxShortcuts, ModifierKeys, QuickShortcuts, ShortcutBuilder, StripMntPrefixPipe, THEME_MAP, THEME_STORAGE_KEY, TN_THEME_DEFINITIONS, TnBannerActionDirective, TnBannerComponent, TnBannerHarness, TnBrandedSpinnerComponent, TnButtonComponent, TnButtonHarness, TnButtonToggleComponent, TnButtonToggleGroupComponent, TnCalendarComponent, TnCalendarHeaderComponent, TnCardComponent, TnCellDefDirective, TnCheckboxComponent, TnChipComponent, TnConfirmDialogComponent, TnDateInputComponent, TnDateRangeInputComponent, TnDialog, TnDialogShellComponent, TnDividerComponent, TnDividerDirective, TnExpansionPanelComponent, TnFilePickerComponent, TnFilePickerPopupComponent, TnFormFieldComponent, TnHeaderCellDefDirective, TnIconButtonComponent, TnIconButtonHarness, TnIconComponent, TnIconHarness, TnIconRegistryService, TnIconTesting, TnInputComponent, TnInputDirective, TnKeyboardShortcutComponent, TnKeyboardShortcutService, TnListAvatarDirective, TnListComponent, TnListIconDirective, TnListItemComponent, TnListItemLineDirective, TnListItemPrimaryDirective, TnListItemSecondaryDirective, TnListItemTitleDirective, TnListItemTrailingDirective, TnListOptionComponent, TnListSubheaderComponent, TnMenuComponent, TnMenuTriggerDirective, TnMonthViewComponent, TnMultiYearViewComponent, TnNestedTreeNodeComponent, TnParticleProgressBarComponent, TnProgressBarComponent, TnRadioComponent, TnSelectComponent, TnSelectHarness, TnSelectionListComponent, TnSlideToggleComponent, TnSliderComponent, TnSliderThumbDirective, TnSliderWithLabelDirective, TnSpinnerComponent, TnSpriteLoaderService, TnStepComponent, TnStepperComponent, TnTabComponent, TnTabPanelComponent, TnTableColumnDirective, TnTableComponent, TnTabsComponent, TnTheme, TnThemeService, TnTimeInputComponent, TnTooltipComponent, TnTooltipDirective, TnTreeComponent, TnTreeFlatDataSource, TnTreeFlattener, TnTreeNodeComponent, TnTreeNodeOutletDirective, TruncatePathPipe, WindowsModifierKeys, WindowsShortcuts, createLucideLibrary, createShortcut, defaultSpriteBasePath, defaultSpriteConfigPath, libIconMarker, registerLucideIcons, setupLucideIntegration, tnIconMarker };
-export type { BannerHarnessFilters, ButtonHarnessFilters, CalendarCell, ChipColor, CreateFolderEvent, DateRange, FilePickerCallbacks, FilePickerError, FilePickerMode, FileSystemItem, IconButtonHarnessFilters, IconHarnessFilters, IconLibrary, IconLibraryType, IconResult, IconSize, IconSource, IconTestingMockOverrides, KeyCombination, LabelType, LucideIconOptions, MockIconRegistry, MockSpriteLoader, PathSegment, PlatformType, ProgressBarMode, ResolvedIcon, SelectHarnessFilters, ShortcutHandler, SlideToggleColor, SpinnerMode, SpriteConfig, TabChangeEvent, TnBannerType, TnButtonToggleType, TnCardAction, TnCardControl, TnCardFooterLink, TnCardHeaderStatus, TnConfirmDialogData, TnDialogDefaults, TnDialogOpenTarget, TnFlatTreeNode, TnMenuItem, TnSelectOption, TnSelectOptionGroup, TnSelectionChange, TnTableDataSource, TnThemeDefinition, TooltipPosition, YearCell };
+export { CommonShortcuts, DEFAULT_THEME, DiskIconComponent, DiskType, FileSizePipe, InputType, LinuxModifierKeys, LinuxShortcuts, ModifierKeys, QuickShortcuts, ShortcutBuilder, StripMntPrefixPipe, THEME_MAP, THEME_STORAGE_KEY, TN_THEME_DEFINITIONS, TnBannerActionDirective, TnBannerComponent, TnBannerHarness, TnBrandedSpinnerComponent, TnButtonComponent, TnButtonHarness, TnButtonToggleComponent, TnButtonToggleGroupComponent, TnCalendarComponent, TnCalendarHeaderComponent, TnCardComponent, TnCellDefDirective, TnCheckboxComponent, TnChipComponent, TnConfirmDialogComponent, TnDateInputComponent, TnDateRangeInputComponent, TnDialog, TnDialogShellComponent, TnDividerComponent, TnDividerDirective, TnExpansionPanelComponent, TnFilePickerComponent, TnFilePickerPopupComponent, TnFormFieldComponent, TnHeaderCellDefDirective, TnIconButtonComponent, TnIconButtonHarness, TnIconComponent, TnIconHarness, TnIconRegistryService, TnIconTesting, TnInputComponent, TnInputDirective, TnInputHarness, TnKeyboardShortcutComponent, TnKeyboardShortcutService, TnListAvatarDirective, TnListComponent, TnListIconDirective, TnListItemComponent, TnListItemLineDirective, TnListItemPrimaryDirective, TnListItemSecondaryDirective, TnListItemTitleDirective, TnListItemTrailingDirective, TnListOptionComponent, TnListSubheaderComponent, TnMenuComponent, TnMenuTriggerDirective, TnMonthViewComponent, TnMultiYearViewComponent, TnNestedTreeNodeComponent, TnParticleProgressBarComponent, TnProgressBarComponent, TnRadioComponent, TnSelectComponent, TnSelectHarness, TnSelectionListComponent, TnSlideToggleComponent, TnSliderComponent, TnSliderThumbDirective, TnSliderWithLabelDirective, TnSpinnerComponent, TnSpriteLoaderService, TnStepComponent, TnStepperComponent, TnTabComponent, TnTabHarness, TnTabPanelComponent, TnTabPanelHarness, TnTableColumnDirective, TnTableComponent, TnTabsComponent, TnTabsHarness, TnTheme, TnThemeService, TnTimeInputComponent, TnTooltipComponent, TnTooltipDirective, TnTreeComponent, TnTreeFlatDataSource, TnTreeFlattener, TnTreeNodeComponent, TnTreeNodeOutletDirective, TruncatePathPipe, WindowsModifierKeys, WindowsShortcuts, createLucideLibrary, createShortcut, defaultSpriteBasePath, defaultSpriteConfigPath, libIconMarker, registerLucideIcons, setupLucideIntegration, tnIconMarker };
+export type { BannerHarnessFilters, ButtonHarnessFilters, CalendarCell, ChipColor, CreateFolderEvent, DateRange, FilePickerCallbacks, FilePickerError, FilePickerMode, FileSystemItem, IconButtonHarnessFilters, IconHarnessFilters, IconLibrary, IconLibraryType, IconResult, IconSize, IconSource, IconTestingMockOverrides, InputHarnessFilters, KeyCombination, LabelType, LucideIconOptions, MockIconRegistry, MockSpriteLoader, PathSegment, PlatformType, ProgressBarMode, ResolvedIcon, SelectHarnessFilters, ShortcutHandler, SlideToggleColor, SpinnerMode, SpriteConfig, TabChangeEvent, TabHarnessFilters, TabPanelHarnessFilters, TabsHarnessFilters, TnBannerType, TnButtonToggleType, TnCardAction, TnCardControl, TnCardFooterLink, TnCardHeaderStatus, TnConfirmDialogData, TnDialogDefaults, TnDialogOpenTarget, TnFlatTreeNode, TnMenuItem, TnSelectOption, TnSelectOptionGroup, TnSelectionChange, TnTableDataSource, TnThemeDefinition, TooltipPosition, YearCell };