ngx-com 0.1.16 → 0.1.18

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

@@ -0,0 +1,124 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComTableCellHarness. */
+interface ComTableCellHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the cell's text content. */
+    text?: string | RegExp;
+}
+/** Harness filters for ComTableRowHarness. */
+type ComTableRowHarnessFilters = BaseHarnessFilters;
+/** Harness filters for ComTableHeaderRowHarness. */
+type ComTableHeaderRowHarnessFilters = BaseHarnessFilters;
+/** Harness filters for ComTableFooterRowHarness. */
+type ComTableFooterRowHarnessFilters = BaseHarnessFilters;
+/** Harness filters for ComTableHarness. */
+interface ComTableHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the table's aria-label. */
+    ariaLabel?: string | RegExp;
+}
+/**
+ * Harness for interacting with a table cell (`<th>` or `<td>`) in tests.
+ */
+declare class ComTableCellHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a HarnessPredicate for matching table cells.
+     * @param options Filter options.
+     */
+    static with(options?: ComTableCellHarnessFilters): HarnessPredicate<ComTableCellHarness>;
+    /** Gets the cell's text content. */
+    getText(): Promise<string>;
+}
+/**
+ * Harness for interacting with a table header row (`<thead> <tr>`) in tests.
+ */
+declare class ComTableHeaderRowHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a HarnessPredicate for matching header rows.
+     * @param options Filter options.
+     */
+    static with(options?: ComTableHeaderRowHarnessFilters): HarnessPredicate<ComTableHeaderRowHarness>;
+    /** Gets all header cells in this row, optionally filtered. */
+    getCells(filters?: ComTableCellHarnessFilters): Promise<ComTableCellHarness[]>;
+    /** Gets the text content of all header cells. */
+    getCellTexts(): Promise<string[]>;
+}
+/**
+ * Harness for interacting with a table body row (`<tbody> <tr>`) in tests.
+ */
+declare class ComTableRowHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a HarnessPredicate for matching body rows.
+     * @param options Filter options.
+     */
+    static with(options?: ComTableRowHarnessFilters): HarnessPredicate<ComTableRowHarness>;
+    /** Gets all cells in this row, optionally filtered. */
+    getCells(filters?: ComTableCellHarnessFilters): Promise<ComTableCellHarness[]>;
+    /** Gets the text content of all cells in this row. */
+    getCellTexts(): Promise<string[]>;
+    /** Clicks the row. Useful for tables with clickable rows. */
+    click(): Promise<void>;
+    /** Whether the row is clickable (has tabindex="0"). */
+    isClickable(): Promise<boolean>;
+}
+/**
+ * Harness for interacting with a table footer row (`<tfoot> <tr>`) in tests.
+ */
+declare class ComTableFooterRowHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a HarnessPredicate for matching footer rows.
+     * @param options Filter options.
+     */
+    static with(options?: ComTableFooterRowHarnessFilters): HarnessPredicate<ComTableFooterRowHarness>;
+    /** Gets all cells in this footer row, optionally filtered. */
+    getCells(filters?: ComTableCellHarnessFilters): Promise<ComTableCellHarness[]>;
+    /** Gets the text content of all cells in this footer row. */
+    getCellTexts(): Promise<string[]>;
+}
+/**
+ * Harness for interacting with a ComTable in tests.
+ */
+declare class ComTableHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly tableElement;
+    /**
+     * Gets a HarnessPredicate for matching tables.
+     * @param options Filter options.
+     */
+    static with(options?: ComTableHarnessFilters): HarnessPredicate<ComTableHarness>;
+    /** Gets the table's aria-label. */
+    getAriaLabel(): Promise<string | null>;
+    /** Whether the table is currently loading (aria-busy="true"). */
+    isLoading(): Promise<boolean>;
+    /** Gets all header rows. */
+    getHeaderRows(): Promise<ComTableHeaderRowHarness[]>;
+    /** Gets the text content of all header cells from the first header row. */
+    getHeaderCellTexts(): Promise<string[]>;
+    /** Gets all body rows, optionally filtered. */
+    getRows(filters?: ComTableRowHarnessFilters): Promise<ComTableRowHarness[]>;
+    /** Gets the number of body rows. */
+    getRowCount(): Promise<number>;
+    /**
+     * Gets the text content of all body cells as a 2D array.
+     * Each inner array contains the cell texts for a single row.
+     */
+    getCellTexts(): Promise<string[][]>;
+    /** Gets all footer rows. */
+    getFooterRows(): Promise<ComTableFooterRowHarness[]>;
+    /** Gets the text content of all footer cells from the first footer row. */
+    getFooterCellTexts(): Promise<string[]>;
+    /** Whether the table is disabled (aria-disabled). */
+    isDisabled(): Promise<boolean>;
+    /** Whether the table host is focused. */
+    isFocused(): Promise<boolean>;
+    /** Focuses the table host element. */
+    focus(): Promise<void>;
+    /** Blurs the table host element. */
+    blur(): Promise<void>;
+}
+
+export { ComTableCellHarness, ComTableFooterRowHarness, ComTableHarness, ComTableHeaderRowHarness, ComTableRowHarness };
+export type { ComTableCellHarnessFilters, ComTableFooterRowHarnessFilters, ComTableHarnessFilters, ComTableHeaderRowHarnessFilters, ComTableRowHarnessFilters };

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

@@ -0,0 +1,67 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComTabHarness. */
+interface ComTabHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the tab's label text. */
+    label?: string | RegExp;
+    /** Filter by whether the tab is selected. */
+    selected?: boolean;
+    /** Filter by whether the tab is disabled. */
+    disabled?: boolean;
+}
+/** Harness filters for ComTabGroupHarness. */
+type ComTabGroupHarnessFilters = BaseHarnessFilters;
+/**
+ * Harness for interacting with an individual tab button in tests.
+ */
+declare class ComTabHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly closeButton;
+    /**
+     * Gets a HarnessPredicate for matching tab buttons.
+     * @param options Filter options.
+     */
+    static with(options?: ComTabHarnessFilters): HarnessPredicate<ComTabHarness>;
+    /** Gets the tab's label text. */
+    getLabel(): Promise<string>;
+    /** Whether the tab is currently selected. */
+    isSelected(): Promise<boolean>;
+    /** Whether the tab is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Clicks the tab to select it. */
+    select(): Promise<void>;
+    /** Gets the aria-controls attribute linking to the panel. */
+    getAriaControls(): Promise<string | null>;
+    /** Whether the tab is closable. */
+    isClosable(): Promise<boolean>;
+    /** Clicks the close button on the tab. Throws if not closable. */
+    close(): Promise<void>;
+    /** Focuses the tab button. */
+    focus(): Promise<void>;
+    /** Blurs the tab button. */
+    blur(): Promise<void>;
+    /** Whether the tab button is focused. */
+    isFocused(): Promise<boolean>;
+}
+/**
+ * Harness for interacting with a ComTabGroup in tests.
+ */
+declare class ComTabGroupHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a HarnessPredicate for matching tab groups.
+     * @param options Filter options.
+     */
+    static with(options?: ComTabGroupHarnessFilters): HarnessPredicate<ComTabGroupHarness>;
+    /** Gets all tab buttons, optionally filtered. */
+    getTabs(filters?: ComTabHarnessFilters): Promise<ComTabHarness[]>;
+    /** Gets the currently selected tab. Throws if none is selected. */
+    getSelectedTab(): Promise<ComTabHarness>;
+    /** Selects a tab matching the given filter. */
+    selectTab(filter: ComTabHarnessFilters): Promise<void>;
+    /** Gets all tab label texts. */
+    getTabLabels(): Promise<string[]>;
+}
+
+export { ComTabGroupHarness, ComTabHarness };
+export type { ComTabGroupHarnessFilters, ComTabHarnessFilters };

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

@@ -0,0 +1,53 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComTimePickerHarness. */
+interface ComTimePickerHarnessFilters extends BaseHarnessFilters {
+    /** Filter by whether the time picker is disabled. */
+    disabled?: boolean;
+}
+/**
+ * Harness for interacting with a ComTimePicker in tests.
+ */
+declare class ComTimePickerHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly hourInput;
+    private readonly minuteInput;
+    private readonly secondInput;
+    private readonly periodToggle;
+    /**
+     * Gets a HarnessPredicate for matching time pickers.
+     * @param options Filter options.
+     */
+    static with(options?: ComTimePickerHarnessFilters): HarnessPredicate<ComTimePickerHarness>;
+    /** Gets the current hours value from the hours spinbutton. */
+    getHours(): Promise<number>;
+    /** Gets the current minutes value from the minutes spinbutton. */
+    getMinutes(): Promise<number>;
+    /** Gets the current seconds value, or null if seconds field is not shown. */
+    getSeconds(): Promise<number | null>;
+    /** Gets the current period (AM/PM), or null if not in 12-hour format. */
+    getPeriod(): Promise<'AM' | 'PM' | null>;
+    /** Sets the hours value by clearing and typing into the hours input. */
+    setHours(value: number): Promise<void>;
+    /** Sets the minutes value by clearing and typing into the minutes input. */
+    setMinutes(value: number): Promise<void>;
+    /** Sets the seconds value. Throws if the seconds field is not shown. */
+    setSeconds(value: number): Promise<void>;
+    /** Toggles the AM/PM period. Throws if not in 12-hour format. */
+    togglePeriod(): Promise<void>;
+    /** Whether the time picker is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the seconds field is visible. */
+    hasSeconds(): Promise<boolean>;
+    /** Whether the time picker is in 12-hour format (has a period toggle). */
+    has12HourFormat(): Promise<boolean>;
+    /** Focuses the hours input element. */
+    focus(): Promise<void>;
+    /** Blurs the hours input element. */
+    blur(): Promise<void>;
+    /** Whether the time picker host element is focused. */
+    isFocused(): Promise<boolean>;
+}
+
+export { ComTimePickerHarness };
+export type { ComTimePickerHarnessFilters };

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

@@ -0,0 +1,93 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComToastHarness. */
+interface ComToastHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the toast's message text. */
+    message?: string | RegExp;
+    /** Filter by the toast's title text. */
+    title?: string | RegExp;
+}
+/** Harness filters for ComToastContainerHarness. */
+type ComToastContainerHarnessFilters = BaseHarnessFilters;
+/**
+ * Harness for interacting with an individual toast notification in tests.
+ *
+ * Because toasts are rendered inside a CDK overlay, use
+ * `TestbedHarnessEnvironment.documentRootLoader(fixture)` or
+ * `documentRootLocatorFactory()` to locate them.
+ */
+declare class ComToastHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly innerDiv;
+    private readonly titleEl;
+    private readonly messageEl;
+    private readonly closeButton;
+    private readonly actionButton;
+    /**
+     * Gets a HarnessPredicate for matching toasts.
+     * @param options Filter options.
+     */
+    static with(options?: ComToastHarnessFilters): HarnessPredicate<ComToastHarness>;
+    /** Gets the ARIA role of the toast (`"alert"` or `"status"`). */
+    getRole(): Promise<string | null>;
+    /** Gets the `aria-live` value of the toast (`"assertive"` or `"polite"`). */
+    getAriaLive(): Promise<string | null>;
+    /** Gets the `data-state` attribute (`"open"` or `"closed"`). */
+    getState(): Promise<string | null>;
+    /**
+     * Gets the toast's title text, or `null` if no title is present.
+     */
+    getTitleText(): Promise<string | null>;
+    /** Gets the toast's message text. */
+    getMessageText(): Promise<string>;
+    /** Whether the toast has an action button. */
+    hasAction(): Promise<boolean>;
+    /** Gets the action button's text, or `null` if no action exists. */
+    getActionText(): Promise<string | null>;
+    /**
+     * Clicks the action button.
+     * @throws If no action button is present.
+     */
+    clickAction(): Promise<void>;
+    /** Whether the toast has a close (dismiss) button. */
+    isDismissible(): Promise<boolean>;
+    /**
+     * Clicks the close button to dismiss the toast.
+     * @throws If no close button is present.
+     */
+    dismiss(): Promise<void>;
+    /** Whether the toast is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the toast host is focused. */
+    isFocused(): Promise<boolean>;
+    /** Focuses the toast host element. */
+    focus(): Promise<void>;
+    /** Blurs the toast host element. */
+    blur(): Promise<void>;
+}
+/**
+ * Harness for interacting with the toast container in tests.
+ *
+ * The container is rendered in a CDK overlay. Use
+ * `TestbedHarnessEnvironment.documentRootLoader(fixture)` to locate it.
+ */
+declare class ComToastContainerHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly regionDiv;
+    /**
+     * Gets a HarnessPredicate for matching toast containers.
+     * @param options Filter options.
+     */
+    static with(options?: ComToastContainerHarnessFilters): HarnessPredicate<ComToastContainerHarness>;
+    /** Gets the container's `aria-label` attribute. */
+    getAriaLabel(): Promise<string | null>;
+    /** Gets all toast harnesses inside the container, optionally filtered. */
+    getToasts(filters?: ComToastHarnessFilters): Promise<ComToastHarness[]>;
+    /** Gets the number of toasts currently in the container. */
+    getToastCount(): Promise<number>;
+    /** Gets the message text of all toasts. */
+    getToastMessages(): Promise<string[]>;
+}
+
+export { ComToastContainerHarness, ComToastHarness };
+export type { ComToastContainerHarnessFilters, ComToastHarnessFilters };

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

@@ -0,0 +1,57 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComTooltipHarness. */
+interface ComTooltipHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the trigger element's text content. */
+    text?: string | RegExp;
+}
+/**
+ * Harness for interacting with a `[comTooltip]` directive in tests.
+ *
+ * The tooltip panel is rendered in a CDK overlay, so this harness uses
+ * `documentRootLocatorFactory()` to locate the panel in the document root.
+ */
+declare class ComTooltipHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly documentRootLocator;
+    /**
+     * Gets a HarnessPredicate for matching tooltip triggers.
+     * @param options Filter options.
+     */
+    static with(options?: ComTooltipHarnessFilters): HarnessPredicate<ComTooltipHarness>;
+    /** Gets the trigger element's text content. */
+    getText(): Promise<string>;
+    /** Whether the tooltip is currently open/visible. */
+    isOpen(): Promise<boolean>;
+    /**
+     * Shows the tooltip by hovering over the trigger element.
+     * If the tooltip is already open, this is a no-op.
+     */
+    show(): Promise<void>;
+    /**
+     * Hides the tooltip by pressing Escape on the trigger element.
+     * If the tooltip is already closed, this is a no-op.
+     */
+    hide(): Promise<void>;
+    /**
+     * Gets the text content of the tooltip panel.
+     * Returns `null` if the tooltip is not open.
+     */
+    getTooltipText(): Promise<string | null>;
+    /**
+     * Gets the side the tooltip is positioned on (`data-side` attribute).
+     * Returns `null` if the tooltip is not open.
+     */
+    getTooltipSide(): Promise<string | null>;
+    /** Gets the `aria-describedby` value from the trigger element. */
+    getAriaDescribedBy(): Promise<string | null>;
+    /** Focuses the trigger element (also shows the tooltip via focusin). */
+    focus(): Promise<void>;
+    /** Blurs the trigger element (hides the tooltip via focusout). */
+    blur(): Promise<void>;
+    /** Whether the trigger element is currently focused. */
+    isFocused(): Promise<boolean>;
+}
+
+export { ComTooltipHarness };
+export type { ComTooltipHarnessFilters };