ngx-com 0.1.16 → 0.1.18

package/types/ngx-com-components-menu-testing.d.ts

@@ -0,0 +1,167 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate, TestKey } from '@angular/cdk/testing';
+
+/** Harness filters for ComMenuItemHarness. */
+interface ComMenuItemHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the item's text content. */
+    text?: string | RegExp;
+    /** Filter by whether the item is disabled. */
+    disabled?: boolean;
+}
+/** Harness filters for ComMenuItemCheckboxHarness. */
+interface ComMenuItemCheckboxHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the item's text content. */
+    text?: string | RegExp;
+    /** Filter by whether the item is disabled. */
+    disabled?: boolean;
+    /** Filter by whether the item is checked. */
+    checked?: boolean;
+}
+/** Harness filters for ComMenuItemRadioHarness. */
+interface ComMenuItemRadioHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the item's text content. */
+    text?: string | RegExp;
+    /** Filter by whether the item is disabled. */
+    disabled?: boolean;
+    /** Filter by whether the item is checked. */
+    checked?: boolean;
+}
+/** Harness filters for ComMenuHarness. */
+interface ComMenuHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the menu's aria-label. */
+    ariaLabel?: string | RegExp;
+}
+/** Harness filters for ComMenuTriggerHarness. */
+interface ComMenuTriggerHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the trigger element's text. */
+    text?: string | RegExp;
+}
+/**
+ * Harness for interacting with a menu item in tests.
+ */
+declare class ComMenuItemHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a HarnessPredicate for matching menu items.
+     * @param options Filter options.
+     */
+    static with(options?: ComMenuItemHarnessFilters): HarnessPredicate<ComMenuItemHarness>;
+    /** Gets the item's text content. */
+    getText(): Promise<string>;
+    /** Whether the item is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Clicks the menu item. */
+    click(): Promise<void>;
+    /** Focuses the menu item. */
+    focus(): Promise<void>;
+    /** Whether the menu item is focused. */
+    isFocused(): Promise<boolean>;
+}
+/**
+ * Harness for interacting with a checkbox menu item in tests.
+ */
+declare class ComMenuItemCheckboxHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a HarnessPredicate for matching checkbox menu items.
+     * @param options Filter options.
+     */
+    static with(options?: ComMenuItemCheckboxHarnessFilters): HarnessPredicate<ComMenuItemCheckboxHarness>;
+    /** Gets the item's text content. */
+    getText(): Promise<string>;
+    /** Whether the item is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the item is checked. */
+    isChecked(): Promise<boolean>;
+    /** Toggles the checkbox item by clicking it. */
+    toggle(): Promise<void>;
+    /** Focuses the item. */
+    focus(): Promise<void>;
+    /** Whether the item is focused. */
+    isFocused(): Promise<boolean>;
+}
+/**
+ * Harness for interacting with a radio menu item in tests.
+ */
+declare class ComMenuItemRadioHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a HarnessPredicate for matching radio menu items.
+     * @param options Filter options.
+     */
+    static with(options?: ComMenuItemRadioHarnessFilters): HarnessPredicate<ComMenuItemRadioHarness>;
+    /** Gets the item's text content. */
+    getText(): Promise<string>;
+    /** Whether the item is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the item is checked. */
+    isChecked(): Promise<boolean>;
+    /** Clicks the radio item. */
+    click(): Promise<void>;
+    /** Focuses the item. */
+    focus(): Promise<void>;
+    /** Whether the item is focused. */
+    isFocused(): Promise<boolean>;
+}
+/**
+ * Harness for interacting with a com-menu panel in tests.
+ */
+declare class ComMenuHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly menuPanel;
+    /**
+     * Gets a HarnessPredicate for matching menus.
+     * @param options Filter options.
+     */
+    static with(options?: ComMenuHarnessFilters): HarnessPredicate<ComMenuHarness>;
+    /** Gets the menu's aria-label. */
+    getAriaLabel(): Promise<string | null>;
+    /** Gets the menu panel's ID. */
+    getMenuId(): Promise<string | null>;
+    /** Gets all menu items, optionally filtered. */
+    getItems(filters?: ComMenuItemHarnessFilters): Promise<ComMenuItemHarness[]>;
+    /** Gets all checkbox menu items, optionally filtered. */
+    getCheckboxItems(filters?: ComMenuItemCheckboxHarnessFilters): Promise<ComMenuItemCheckboxHarness[]>;
+    /** Gets all radio menu items, optionally filtered. */
+    getRadioItems(filters?: ComMenuItemRadioHarnessFilters): Promise<ComMenuItemRadioHarness[]>;
+    /** Gets all menu item texts. */
+    getItemLabels(): Promise<string[]>;
+}
+/**
+ * Harness for interacting with a menu trigger in tests.
+ */
+declare class ComMenuTriggerHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly documentRootLocator;
+    /**
+     * Gets a HarnessPredicate for matching menu triggers.
+     * @param options Filter options.
+     */
+    static with(options?: ComMenuTriggerHarnessFilters): HarnessPredicate<ComMenuTriggerHarness>;
+    /** Gets the trigger element's text. */
+    getText(): Promise<string>;
+    /** Whether the menu is currently open. */
+    isOpen(): Promise<boolean>;
+    /** Opens the menu if it's closed. */
+    open(): Promise<void>;
+    /** Closes the menu if it's open. */
+    close(): Promise<void>;
+    /** Toggles the menu open/close state. */
+    toggle(): Promise<void>;
+    /** Gets the menu panel harness, or null if the menu is closed. */
+    getMenu(): Promise<ComMenuHarness | null>;
+    /** Opens the menu and gets all menu items. */
+    getItems(filters?: ComMenuItemHarnessFilters): Promise<ComMenuItemHarness[]>;
+    /** Opens the menu, finds an item by filter, and clicks it. */
+    clickItem(filter: ComMenuItemHarnessFilters): Promise<void>;
+    /** Sends keyboard input to the trigger element. */
+    sendKeys(...keys: (string | TestKey)[]): Promise<void>;
+    /** Focuses the trigger element. */
+    focus(): Promise<void>;
+    /** Blurs the trigger element. */
+    blur(): Promise<void>;
+    /** Whether the trigger element is focused. */
+    isFocused(): Promise<boolean>;
+}
+
+export { ComMenuHarness, ComMenuItemCheckboxHarness, ComMenuItemHarness, ComMenuItemRadioHarness, ComMenuTriggerHarness };
+export type { ComMenuHarnessFilters, ComMenuItemCheckboxHarnessFilters, ComMenuItemHarnessFilters, ComMenuItemRadioHarnessFilters, ComMenuTriggerHarnessFilters };

package/types/ngx-com-components-paginator-testing.d.ts

@@ -0,0 +1,58 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComPaginatorHarness. */
+interface ComPaginatorHarnessFilters extends BaseHarnessFilters {
+    /** Filter by whether the paginator is disabled. */
+    disabled?: boolean;
+}
+/**
+ * Harness for interacting with a ComPaginator in tests.
+ */
+declare class ComPaginatorHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly previousButton;
+    private readonly nextButton;
+    private readonly firstButton;
+    private readonly lastButton;
+    private readonly rangeLabel;
+    private readonly select;
+    private readonly nav;
+    /**
+     * Gets a HarnessPredicate for matching paginators.
+     * @param options Filter options.
+     */
+    static with(options?: ComPaginatorHarnessFilters): HarnessPredicate<ComPaginatorHarness>;
+    /** Navigates to the first page. Throws if the first page button is not present. */
+    goToFirstPage(): Promise<void>;
+    /** Navigates to the previous page. */
+    goToPreviousPage(): Promise<void>;
+    /** Navigates to the next page. */
+    goToNextPage(): Promise<void>;
+    /** Navigates to the last page. Throws if the last page button is not present. */
+    goToLastPage(): Promise<void>;
+    /** Navigates to a specific page (1-based). Throws if page button is not present. */
+    goToPage(pageNumber: number): Promise<void>;
+    /** Gets the range label text. */
+    getRangeLabel(): Promise<string>;
+    /** Gets the current page size from the select element. Throws if no select is present. */
+    getPageSize(): Promise<number>;
+    /** Sets the page size by selecting a value. Throws if no select is present. */
+    setPageSize(size: number): Promise<void>;
+    /** Whether the previous page button is disabled. */
+    isPreviousPageDisabled(): Promise<boolean>;
+    /** Whether the next page button is disabled. */
+    isNextPageDisabled(): Promise<boolean>;
+    /** Whether the paginator is fully disabled (both prev and next buttons disabled). */
+    isDisabled(): Promise<boolean>;
+    /** Gets the aria-label of the navigation element. */
+    getAriaLabel(): Promise<string | null>;
+    /** Whether the paginator navigation is focused. */
+    isFocused(): Promise<boolean>;
+    /** Focuses the paginator host element. */
+    focus(): Promise<void>;
+    /** Blurs the paginator host element. */
+    blur(): Promise<void>;
+}
+
+export { ComPaginatorHarness };
+export type { ComPaginatorHarnessFilters };

package/types/ngx-com-components-popover-testing.d.ts

@@ -0,0 +1,63 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComPopoverContentHarness. */
+type ComPopoverContentHarnessFilters = BaseHarnessFilters;
+/** Harness filters for ComPopoverTriggerHarness. */
+interface ComPopoverTriggerHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the trigger element's text. */
+    text?: string | RegExp;
+}
+/**
+ * Harness for interacting with popover content in tests.
+ * This harness targets the `com-popover-content` element rendered in the overlay.
+ */
+declare class ComPopoverContentHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly dialogPanel;
+    /**
+     * Gets a HarnessPredicate for matching popover content.
+     * @param options Filter options.
+     */
+    static with(options?: ComPopoverContentHarnessFilters): HarnessPredicate<ComPopoverContentHarness>;
+    /** Gets the popover dialog panel's aria-label. */
+    getAriaLabel(): Promise<string | null>;
+    /** Gets the text content of the popover dialog panel. */
+    getText(): Promise<string>;
+    /** Gets the `data-side` attribute from the popover wrapper. */
+    getSide(): Promise<string | null>;
+    /** Gets the `data-state` attribute from the popover wrapper. */
+    getState(): Promise<string | null>;
+}
+/**
+ * Harness for interacting with a popover trigger in tests.
+ */
+declare class ComPopoverTriggerHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly documentRootLocator;
+    /**
+     * Gets a HarnessPredicate for matching popover triggers.
+     * @param options Filter options.
+     */
+    static with(options?: ComPopoverTriggerHarnessFilters): HarnessPredicate<ComPopoverTriggerHarness>;
+    /** Gets the trigger element's text. */
+    getText(): Promise<string>;
+    /** Whether the popover is currently open. */
+    isOpen(): Promise<boolean>;
+    /** Opens the popover if it's closed. */
+    open(): Promise<void>;
+    /** Closes the popover if it's open. */
+    close(): Promise<void>;
+    /** Toggles the popover open/close state by clicking the trigger. */
+    toggle(): Promise<void>;
+    /** Gets the popover content harness, or null if the popover is closed. */
+    getPopoverContent(): Promise<ComPopoverContentHarness | null>;
+    /** Focuses the trigger element. */
+    focus(): Promise<void>;
+    /** Blurs the trigger element. */
+    blur(): Promise<void>;
+    /** Whether the trigger element is focused. */
+    isFocused(): Promise<boolean>;
+}
+
+export { ComPopoverContentHarness, ComPopoverTriggerHarness };
+export type { ComPopoverContentHarnessFilters, ComPopoverTriggerHarnessFilters };

package/types/ngx-com-components-radio-testing.d.ts

@@ -0,0 +1,86 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComRadioButtonHarness. */
+interface ComRadioButtonHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the radio button's label text. */
+    label?: string | RegExp;
+    /** Filter by the radio button's value. */
+    value?: string | RegExp;
+    /** Filter by whether the radio button is disabled. */
+    disabled?: boolean;
+    /** Filter by whether the radio button is checked. */
+    checked?: boolean;
+}
+/** Harness filters for ComRadioGroupHarness. */
+interface ComRadioGroupHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the radio group's name. */
+    name?: string | RegExp;
+    /** Filter by whether the radio group is disabled. */
+    disabled?: boolean;
+}
+/**
+ * Harness for interacting with a radio button in tests.
+ */
+declare class ComRadioButtonHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly label;
+    private readonly input;
+    private readonly labelText;
+    /**
+     * Gets a HarnessPredicate for matching radio buttons.
+     * @param options Filter options.
+     */
+    static with(options?: ComRadioButtonHarnessFilters): HarnessPredicate<ComRadioButtonHarness>;
+    /** Whether the radio button is checked. */
+    isChecked(): Promise<boolean>;
+    /** Whether the radio button is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Gets the radio button's label text. */
+    getLabelText(): Promise<string>;
+    /** Gets the radio button's value. */
+    getValue(): Promise<string>;
+    /** Checks the radio button if it is not already checked. */
+    check(): Promise<void>;
+    /** Focuses the radio button's input. */
+    focus(): Promise<void>;
+    /** Blurs the radio button's input. */
+    blur(): Promise<void>;
+    /** Whether the radio button's input is focused. */
+    isFocused(): Promise<boolean>;
+}
+/**
+ * Harness for interacting with a radio group in tests.
+ */
+declare class ComRadioGroupHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly radioGroup;
+    private readonly errorMessage;
+    /**
+     * Gets a HarnessPredicate for matching radio groups.
+     * @param options Filter options.
+     */
+    static with(options?: ComRadioGroupHarnessFilters): HarnessPredicate<ComRadioGroupHarness>;
+    /** Gets all radio buttons in the group, optionally filtered. */
+    getRadioButtons(filters?: ComRadioButtonHarnessFilters): Promise<ComRadioButtonHarness[]>;
+    /** Gets the checked radio button, or null if none is checked. */
+    getCheckedRadioButton(): Promise<ComRadioButtonHarness | null>;
+    /** Gets the value of the checked radio button, or null if none is checked. */
+    getCheckedValue(): Promise<string | null>;
+    /** Gets the name attribute of the radio group from the first radio input. */
+    getName(): Promise<string | null>;
+    /** Whether the radio group is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the radio group is required. */
+    isRequired(): Promise<boolean>;
+    /** Whether the radio group has an error state. */
+    hasError(): Promise<boolean>;
+    /** Gets the error message text, or null if no error is displayed. */
+    getErrorMessage(): Promise<string | null>;
+    /** Gets the aria-label of the radio group. */
+    getAriaLabel(): Promise<string | null>;
+    /** Checks a radio button matching the given filter. */
+    checkRadioButton(filter?: ComRadioButtonHarnessFilters): Promise<void>;
+}
+
+export { ComRadioButtonHarness, ComRadioGroupHarness };
+export type { ComRadioButtonHarnessFilters, ComRadioGroupHarnessFilters };

package/types/ngx-com-components-segmented-control-testing.d.ts

@@ -0,0 +1,66 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComSegmentHarness. */
+interface ComSegmentHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the segment's label text. */
+    label?: string | RegExp;
+    /** Filter by whether the segment is selected. */
+    selected?: boolean;
+    /** Filter by whether the segment is disabled. */
+    disabled?: boolean;
+}
+/** Harness filters for ComSegmentedControlHarness. */
+interface ComSegmentedControlHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the control's aria-label. */
+    ariaLabel?: string | RegExp;
+}
+/**
+ * Harness for interacting with an individual segment button in tests.
+ */
+declare class ComSegmentHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a HarnessPredicate for matching segments.
+     * @param options Filter options.
+     */
+    static with(options?: ComSegmentHarnessFilters): HarnessPredicate<ComSegmentHarness>;
+    /** Gets the segment's label text. Uses aria-label if present, otherwise text content. */
+    getLabel(): Promise<string>;
+    /** Whether the segment is currently selected. */
+    isSelected(): Promise<boolean>;
+    /** Whether the segment is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Clicks the segment to select it. Throws if disabled. */
+    select(): Promise<void>;
+    /** Focuses the segment button. */
+    focus(): Promise<void>;
+    /** Blurs the segment button. */
+    blur(): Promise<void>;
+    /** Whether the segment button is focused. */
+    isFocused(): Promise<boolean>;
+}
+/**
+ * Harness for interacting with a ComSegmentedControl in tests.
+ */
+declare class ComSegmentedControlHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly radioGroup;
+    /**
+     * Gets a HarnessPredicate for matching segmented controls.
+     * @param options Filter options.
+     */
+    static with(options?: ComSegmentedControlHarnessFilters): HarnessPredicate<ComSegmentedControlHarness>;
+    /** Gets all segment buttons, optionally filtered. */
+    getSegments(filters?: ComSegmentHarnessFilters): Promise<ComSegmentHarness[]>;
+    /** Gets the currently selected segment, or null if none is selected. */
+    getSelectedSegment(): Promise<ComSegmentHarness | null>;
+    /** Selects a segment matching the given filter. */
+    selectSegment(filter: ComSegmentHarnessFilters): Promise<void>;
+    /** Gets all segment label texts. */
+    getSegmentLabels(): Promise<string[]>;
+    /** Gets the radiogroup's aria-label. */
+    getAriaLabel(): Promise<string | null>;
+}
+
+export { ComSegmentHarness, ComSegmentedControlHarness };
+export type { ComSegmentHarnessFilters, ComSegmentedControlHarnessFilters };

package/types/ngx-com-components-sort-testing.d.ts

@@ -0,0 +1,62 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Sort direction as exposed by the aria-sort attribute. */
+type SortHeaderSortDirection = 'ascending' | 'descending' | 'none';
+/** Harness filters for ComSortHeaderHarness. */
+interface ComSortHeaderHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the header's text content. */
+    label?: string | RegExp;
+    /** Filter by the column id (comSortHeader attribute value). */
+    id?: string | RegExp;
+    /** Filter by the current sort direction. */
+    sortDirection?: SortHeaderSortDirection;
+}
+/** Harness filters for ComSortHarness. */
+type ComSortHarnessFilters = BaseHarnessFilters;
+/**
+ * Harness for interacting with a sort header in tests.
+ */
+declare class ComSortHeaderHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a HarnessPredicate for matching sort headers.
+     * @param options Filter options.
+     */
+    static with(options?: ComSortHeaderHarnessFilters): HarnessPredicate<ComSortHeaderHarness>;
+    /** Gets the header's text content. */
+    getLabel(): Promise<string>;
+    /** Gets the column id (comSortHeader attribute value). */
+    getId(): Promise<string>;
+    /** Gets the current sort direction from aria-sort. */
+    getSortDirection(): Promise<SortHeaderSortDirection>;
+    /** Whether this header is actively sorted (direction is not 'none'). */
+    isActive(): Promise<boolean>;
+    /** Whether this header is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Clicks the header to cycle sort direction. */
+    click(): Promise<void>;
+    /** Focuses the header element. */
+    focus(): Promise<void>;
+    /** Blurs the header element. */
+    blur(): Promise<void>;
+    /** Whether the header element is focused. */
+    isFocused(): Promise<boolean>;
+}
+/**
+ * Harness for interacting with a sort container in tests.
+ */
+declare class ComSortHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a HarnessPredicate for matching sort containers.
+     * @param options Filter options.
+     */
+    static with(options?: ComSortHarnessFilters): HarnessPredicate<ComSortHarness>;
+    /** Gets all sort headers, optionally filtered. */
+    getSortHeaders(filters?: ComSortHeaderHarnessFilters): Promise<ComSortHeaderHarness[]>;
+    /** Gets the actively sorted header, or null if none is sorted. */
+    getActiveHeader(): Promise<ComSortHeaderHarness | null>;
+}
+
+export { ComSortHarness, ComSortHeaderHarness };
+export type { ComSortHarnessFilters, ComSortHeaderHarnessFilters, SortHeaderSortDirection };

package/types/ngx-com-components-switch-testing.d.ts

@@ -0,0 +1,52 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComSwitchHarness. */
+interface ComSwitchHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the switch's label text. */
+    label?: string | RegExp;
+    /** Filter by whether the switch is disabled. */
+    disabled?: boolean;
+    /** Filter by whether the switch is checked. */
+    checked?: boolean;
+}
+/**
+ * Harness for interacting with a ComSwitch in tests.
+ */
+declare class ComSwitchHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly label;
+    private readonly input;
+    private readonly labelText;
+    /**
+     * Gets a HarnessPredicate for matching switches.
+     * @param options Filter options.
+     */
+    static with(options?: ComSwitchHarnessFilters): HarnessPredicate<ComSwitchHarness>;
+    /** Whether the switch is currently checked. */
+    isChecked(): Promise<boolean>;
+    /** Whether the switch is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the switch is required. */
+    isRequired(): Promise<boolean>;
+    /** Gets the switch's label text. */
+    getLabelText(): Promise<string>;
+    /** Gets the switch's name attribute. */
+    getName(): Promise<string | null>;
+    /** Gets the switch's aria-label attribute. */
+    getAriaLabel(): Promise<string | null>;
+    /** Toggles the switch by clicking its label. */
+    toggle(): Promise<void>;
+    /** Checks the switch if it is not already checked. */
+    check(): Promise<void>;
+    /** Unchecks the switch if it is currently checked. */
+    uncheck(): Promise<void>;
+    /** Focuses the switch's input element. */
+    focus(): Promise<void>;
+    /** Blurs the switch's input element. */
+    blur(): Promise<void>;
+    /** Whether the switch's input element is focused. */
+    isFocused(): Promise<boolean>;
+}
+
+export { ComSwitchHarness };
+export type { ComSwitchHarnessFilters };