ngx-com 0.1.16 → 0.1.18

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

@@ -0,0 +1,80 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComCalendarCellHarness. */
+interface ComCalendarCellHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the cell's display text. */
+    text?: string | RegExp;
+    /** Filter by whether the cell is selected. */
+    selected?: boolean;
+    /** Filter by whether the cell is disabled. */
+    disabled?: boolean;
+}
+/** Harness filters for ComCalendarHarness. */
+type ComCalendarHarnessFilters = BaseHarnessFilters;
+/**
+ * Harness for interacting with an individual calendar cell in tests.
+ */
+declare class ComCalendarCellHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly button;
+    /**
+     * Gets a HarnessPredicate for matching calendar cells.
+     * @param options Filter options.
+     */
+    static with(options?: ComCalendarCellHarnessFilters): HarnessPredicate<ComCalendarCellHarness>;
+    /** Gets the cell's display text. */
+    getText(): Promise<string>;
+    /** Gets the cell button's aria-label. */
+    getAriaLabel(): Promise<string | null>;
+    /** Whether the cell is currently selected. */
+    isSelected(): Promise<boolean>;
+    /** Whether the cell is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the cell represents today's date. */
+    isToday(): Promise<boolean>;
+    /** Clicks the cell to select it. */
+    select(): Promise<void>;
+    /** Focuses the cell button. */
+    focus(): Promise<void>;
+    /** Whether the cell button is focused. */
+    isFocused(): Promise<boolean>;
+}
+/**
+ * Harness for interacting with a ComCalendar in tests.
+ */
+declare class ComCalendarHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly prevButton;
+    private readonly periodButton;
+    private readonly nextButton;
+    /**
+     * Gets a HarnessPredicate for matching calendars.
+     * @param options Filter options.
+     */
+    static with(options?: ComCalendarHarnessFilters): HarnessPredicate<ComCalendarHarness>;
+    /** Gets the period label text (e.g., "January 2024", "2024", "2000 – 2023"). */
+    getPeriodLabel(): Promise<string>;
+    /** Navigates to the previous period (month, year, or multi-year page). */
+    goToPreviousPage(): Promise<void>;
+    /** Navigates to the next period (month, year, or multi-year page). */
+    goToNextPage(): Promise<void>;
+    /** Whether the previous page button is disabled. */
+    isPreviousDisabled(): Promise<boolean>;
+    /** Whether the next page button is disabled. */
+    isNextDisabled(): Promise<boolean>;
+    /** Clicks the period button to switch to the next higher view (month → year → multi-year). */
+    switchView(): Promise<void>;
+    /** Gets the current calendar view. */
+    getCurrentView(): Promise<'month' | 'year' | 'multi-year'>;
+    /** Gets all calendar cells, optionally filtered. */
+    getCells(filters?: ComCalendarCellHarnessFilters): Promise<ComCalendarCellHarness[]>;
+    /** Selects a cell by its display text. Throws if no matching cell is found. */
+    selectCell(text: string): Promise<void>;
+    /** Gets all currently selected cells. */
+    getSelectedCells(): Promise<ComCalendarCellHarness[]>;
+    /** Gets the cell representing today, or null if not visible. */
+    getTodayCell(): Promise<ComCalendarCellHarness | null>;
+}
+
+export { ComCalendarCellHarness, ComCalendarHarness };
+export type { ComCalendarCellHarnessFilters, ComCalendarHarnessFilters };

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

@@ -0,0 +1,51 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComCarouselHarness. */
+type ComCarouselHarnessFilters = BaseHarnessFilters;
+/**
+ * Harness for interacting with a ComCarousel in tests.
+ */
+declare class ComCarouselHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly prevButton;
+    private readonly nextButton;
+    private readonly paginationTablist;
+    private readonly paginationDots;
+    private readonly slides;
+    /**
+     * Gets a HarnessPredicate for matching carousels.
+     * @param options Filter options.
+     */
+    static with(options?: ComCarouselHarnessFilters): HarnessPredicate<ComCarouselHarness>;
+    /** Navigates to the next slide. Throws if the next button is not present. */
+    goToNext(): Promise<void>;
+    /** Navigates to the previous slide. Throws if the previous button is not present. */
+    goToPrevious(): Promise<void>;
+    /** Navigates to a specific slide by clicking its pagination dot. Throws if not found. */
+    goToSlide(index: number): Promise<void>;
+    /** Gets the index of the currently active slide based on the selected pagination dot. */
+    getCurrentIndex(): Promise<number>;
+    /** Gets the total number of slide items. */
+    getSlideCount(): Promise<number>;
+    /** Whether the next slide button is disabled. */
+    isNextDisabled(): Promise<boolean>;
+    /** Whether the previous slide button is disabled. */
+    isPreviousDisabled(): Promise<boolean>;
+    /** Whether navigation buttons (next/previous) are present. */
+    hasNavigation(): Promise<boolean>;
+    /** Whether the pagination tablist is present. */
+    hasPagination(): Promise<boolean>;
+    /** Gets the number of pagination dots. */
+    getPaginationCount(): Promise<number>;
+    /** Whether the carousel is disabled (both navigation buttons disabled). */
+    isDisabled(): Promise<boolean>;
+    /** Whether the carousel host is focused. */
+    isFocused(): Promise<boolean>;
+    /** Focuses the carousel host element. */
+    focus(): Promise<void>;
+    /** Blurs the carousel host element. */
+    blur(): Promise<void>;
+}
+
+export { ComCarouselHarness };
+export type { ComCarouselHarnessFilters };

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

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

package/types/ngx-com-components-code-block-testing.d.ts

@@ -0,0 +1,45 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComCodeBlockHarness. */
+interface ComCodeBlockHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the code block's language label. */
+    language?: string | RegExp;
+}
+/**
+ * Harness for interacting with a ComCodeBlock in tests.
+ */
+declare class ComCodeBlockHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly codeElement;
+    private readonly preElement;
+    private readonly copyButton;
+    /**
+     * Gets a HarnessPredicate for matching code blocks.
+     * @param options Filter options.
+     */
+    static with(options?: ComCodeBlockHarnessFilters): HarnessPredicate<ComCodeBlockHarness>;
+    /** Gets the code text content. */
+    getCode(): Promise<string>;
+    /**
+     * Gets the language label.
+     * Returns `null` if no language is set.
+     */
+    getLanguage(): Promise<string | null>;
+    /** Clicks the copy button to copy code to clipboard. */
+    copyToClipboard(): Promise<void>;
+    /** Whether the copy button is currently showing the "Copied" state. */
+    isCopied(): Promise<boolean>;
+    /** Gets the copy button's aria-label. */
+    getCopyButtonLabel(): Promise<string>;
+    /** Whether the code block is disabled (copy button is disabled). */
+    isDisabled(): Promise<boolean>;
+    /** Whether the code block host is focused. */
+    isFocused(): Promise<boolean>;
+    /** Focuses the code block host element. */
+    focus(): Promise<void>;
+    /** Blurs the code block host element. */
+    blur(): Promise<void>;
+}
+
+export { ComCodeBlockHarness };
+export type { ComCodeBlockHarnessFilters };

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

@@ -0,0 +1,53 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComCollapsibleHarness. */
+interface ComCollapsibleHarnessFilters extends BaseHarnessFilters {
+    /** Filter by whether the collapsible is expanded. */
+    expanded?: boolean;
+    /** Filter by whether the collapsible is disabled. */
+    disabled?: boolean;
+}
+/**
+ * Harness for interacting with a ComCollapsible in tests.
+ */
+declare class ComCollapsibleHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly trigger;
+    private readonly content;
+    /**
+     * Gets a HarnessPredicate for matching collapsibles.
+     * @param options Filter options.
+     */
+    static with(options?: ComCollapsibleHarnessFilters): HarnessPredicate<ComCollapsibleHarness>;
+    /** Whether the collapsible is currently expanded. */
+    isExpanded(): Promise<boolean>;
+    /** Whether the collapsible is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Toggles the collapsible by clicking the trigger. */
+    toggle(): Promise<void>;
+    /** Expands the collapsible if it is currently collapsed. */
+    expand(): Promise<void>;
+    /** Collapses the collapsible if it is currently expanded. */
+    collapse(): Promise<void>;
+    /** Gets the text content of the trigger element. */
+    getTriggerText(): Promise<string>;
+    /** Gets the text content of the content element. */
+    getContentText(): Promise<string>;
+    /** Gets the role attribute of the content element. */
+    getContentRole(): Promise<string | null>;
+    /** Gets the aria-controls attribute from the trigger. */
+    getAriaControls(): Promise<string | null>;
+    /** Gets the aria-labelledby attribute from the content. */
+    getAriaLabelledby(): Promise<string | null>;
+    /** Whether the content element has the inert attribute. */
+    isContentInert(): Promise<boolean>;
+    /** Focuses the trigger element. */
+    focus(): Promise<void>;
+    /** Blurs the trigger element. */
+    blur(): Promise<void>;
+    /** Whether the trigger element is focused. */
+    isFocused(): Promise<boolean>;
+}
+
+export { ComCollapsibleHarness };
+export type { ComCollapsibleHarnessFilters };

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

@@ -0,0 +1,78 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComConfirmPanelHarness. */
+type ComConfirmPanelHarnessFilters = BaseHarnessFilters;
+/** Harness filters for ComConfirmTriggerHarness. */
+interface ComConfirmTriggerHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the trigger element's text. */
+    text?: string | RegExp;
+}
+/**
+ * Harness for interacting with a confirm panel in tests.
+ *
+ * The panel renders inside a CDK overlay with `role="alertdialog"`.
+ * Obtain via `TestbedHarnessEnvironment.documentRootLoader(fixture)` or
+ * through `ComConfirmTriggerHarness.getPanel()`.
+ */
+declare class ComConfirmPanelHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly alertdialog;
+    private readonly title;
+    private readonly message;
+    private readonly cancelButton;
+    private readonly confirmButton;
+    /**
+     * Gets a HarnessPredicate for matching confirm panels.
+     * @param options Filter options.
+     */
+    static with(options?: ComConfirmPanelHarnessFilters): HarnessPredicate<ComConfirmPanelHarness>;
+    /** Gets the title text, or null if no title is present. */
+    getTitleText(): Promise<string | null>;
+    /** Gets the message text. */
+    getMessageText(): Promise<string>;
+    /** Gets the confirm button text. */
+    getConfirmButtonText(): Promise<string>;
+    /** Gets the cancel button text. */
+    getCancelButtonText(): Promise<string>;
+    /** Clicks the confirm button. */
+    confirm(): Promise<void>;
+    /** Clicks the cancel button. */
+    cancel(): Promise<void>;
+    /** Gets the `data-state` attribute on the alertdialog element. */
+    getState(): Promise<string | null>;
+}
+/**
+ * Harness for interacting with a confirm trigger in tests.
+ */
+declare class ComConfirmTriggerHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly documentRootLocator;
+    /**
+     * Gets a HarnessPredicate for matching confirm triggers.
+     * @param options Filter options.
+     */
+    static with(options?: ComConfirmTriggerHarnessFilters): HarnessPredicate<ComConfirmTriggerHarness>;
+    /** Gets the trigger element's text. */
+    getText(): Promise<string>;
+    /** Whether the confirm panel is currently open. */
+    isOpen(): Promise<boolean>;
+    /** Opens the confirm panel if it's closed. */
+    open(): Promise<void>;
+    /** Closes the confirm panel if it's open. */
+    close(): Promise<void>;
+    /** Gets the confirm panel harness, or null if the panel is closed. */
+    getPanel(): Promise<ComConfirmPanelHarness | null>;
+    /** Opens the panel and clicks the confirm button. */
+    confirm(): Promise<void>;
+    /** Opens the panel and clicks the cancel button. */
+    cancel(): 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 { ComConfirmPanelHarness, ComConfirmTriggerHarness };
+export type { ComConfirmPanelHarnessFilters, ComConfirmTriggerHarnessFilters };

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

@@ -0,0 +1,61 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate, TestElement } from '@angular/cdk/testing';
+
+/** Harness filters for ComDatepickerHarness. */
+interface ComDatepickerHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the datepicker's placeholder text. */
+    placeholder?: string | RegExp;
+    /** Filter by whether the datepicker is disabled. */
+    disabled?: boolean;
+    /** Filter by whether the datepicker panel is open. */
+    open?: boolean;
+}
+/**
+ * Harness for interacting with a ComDatepicker in tests.
+ */
+declare class ComDatepickerHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly triggerGroup;
+    private readonly input;
+    private readonly clearButton;
+    private readonly calendarButton;
+    /**
+     * Gets a HarnessPredicate for matching datepickers.
+     * @param options Filter options.
+     */
+    static with(options?: ComDatepickerHarnessFilters): HarnessPredicate<ComDatepickerHarness>;
+    /** Whether the datepicker panel is currently open. */
+    isOpen(): Promise<boolean>;
+    /** Opens the datepicker panel if it is closed. */
+    open(): Promise<void>;
+    /** Closes the datepicker panel if it is open. */
+    close(): Promise<void>;
+    /** Whether the datepicker is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the datepicker input has the required attribute. */
+    isRequired(): Promise<boolean>;
+    /** Whether the datepicker input is in an invalid state. */
+    isInvalid(): Promise<boolean>;
+    /** Gets the current value displayed in the input. */
+    getInputValue(): Promise<string>;
+    /** Sets the input value by clearing and typing the given text. */
+    setInputValue(text: string): Promise<void>;
+    /** Gets the placeholder text of the input. */
+    getPlaceholder(): Promise<string>;
+    /** Whether the datepicker currently has a value (clear button is visible). */
+    hasValue(): Promise<boolean>;
+    /** Clears the current value by clicking the clear button. Throws if no value is set. */
+    clear(): Promise<void>;
+    /** Gets the calendar panel element from the overlay. The datepicker must be open. */
+    getCalendarPanel(): Promise<TestElement>;
+    /** Selects a day by its visible number. Opens the panel if closed. */
+    selectDate(day: number): Promise<void>;
+    /** Focuses the datepicker input. */
+    focus(): Promise<void>;
+    /** Blurs the datepicker input. */
+    blur(): Promise<void>;
+    /** Whether the datepicker input is currently focused. */
+    isFocused(): Promise<boolean>;
+}
+
+export { ComDatepickerHarness };
+export type { ComDatepickerHarnessFilters };

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

@@ -0,0 +1,57 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/** Harness filters for ComDialogContainerHarness. */
+type ComDialogContainerHarnessFilters = BaseHarnessFilters;
+/**
+ * Harness for interacting with a dialog container in tests.
+ *
+ * Because dialogs render inside a CDK overlay (outside the component tree),
+ * obtain this harness via `TestbedHarnessEnvironment.documentRootLoader(fixture)`.
+ */
+declare class ComDialogContainerHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly panel;
+    private readonly titleEl;
+    private readonly contentEl;
+    private readonly actionsEl;
+    private readonly closeButton;
+    /**
+     * Gets a HarnessPredicate for matching dialog containers.
+     * @param options Filter options.
+     */
+    static with(options?: ComDialogContainerHarnessFilters): HarnessPredicate<ComDialogContainerHarness>;
+    /** Gets the dialog panel's `aria-label` attribute. */
+    getAriaLabel(): Promise<string | null>;
+    /** Gets the dialog panel's `aria-labelledby` attribute. */
+    getAriaLabelledby(): Promise<string | null>;
+    /** Gets the dialog panel's `aria-describedby` attribute. */
+    getAriaDescribedby(): Promise<string | null>;
+    /** Gets the role attribute on the dialog panel. */
+    getRole(): Promise<string | null>;
+    /** Gets the text content of the `[comDialogTitle]` element, or null if none exists. */
+    getTitleText(): Promise<string | null>;
+    /** Gets the text content of the `[comDialogContent]` element, or null if none exists. */
+    getContentText(): Promise<string | null>;
+    /** Gets the text content of the `[comDialogActions]` element, or null if none exists. */
+    getActionsText(): Promise<string | null>;
+    /** Gets the `data-state` attribute on the dialog panel. */
+    getState(): Promise<string | null>;
+    /**
+     * Closes the dialog by clicking the `[comDialogClose]` button.
+     * Throws if no close button is found.
+     */
+    close(): Promise<void>;
+    /** Sends an Escape key press to the dialog panel to close it. */
+    sendEscapeKey(): Promise<void>;
+    /** Whether the dialog container is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the dialog panel is focused. */
+    isFocused(): Promise<boolean>;
+    /** Focuses the dialog panel. */
+    focus(): Promise<void>;
+    /** Blurs the dialog panel. */
+    blur(): Promise<void>;
+}
+
+export { ComDialogContainerHarness };
+export type { ComDialogContainerHarnessFilters };

package/types/ngx-com-components-dropdown.d.ts

@@ -602,6 +602,8 @@ declare class ComDropdown<T> implements ControlValueAccessor, FormFieldControl<T
     private scrollSubscription;
     /** Throttled handler for standard scroll events. */
     private throttledScrollHandler;
+    /** Cleanup functions for ancestor scroll listeners. */
+    private ancestorScrollCleanups;
     /** IDs for aria-describedby (set by form-field). */
     private readonly _describedByIds;
     /** Form field appearance (set by form-field). */
@@ -732,6 +734,16 @@ declare class ComDropdown<T> implements ControlValueAccessor, FormFieldControl<T
     private flattenGroupedOptions;
     private typeAhead;
     private announce;
+    /**
+     * Listens for scroll events on ancestor elements of the trigger.
+     * Closes the dropdown when the page scrolls, since CDK's reposition strategy
+     * only detects window scroll and registered cdkScrollable elements — not
+     * arbitrary scrollable containers (common in SPAs).
+     * SSR-safe: only called from user interaction handlers.
+     */
+    private setupAncestorScrollListeners;
+    /** Removes ancestor scroll listeners. */
+    private cleanupAncestorScrollListeners;
     /** Sets up scroll detection for the loadMore output. SSR-safe: only called from user interaction. */
     private setupScrollDetection;
     /** Cleans up scroll detection listeners. */

package/types/ngx-com-components-form-field-testing.d.ts

@@ -0,0 +1,61 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate, TestElement } from '@angular/cdk/testing';
+
+/** Harness filters for ComFormFieldHarness. */
+interface ComFormFieldHarnessFilters extends BaseHarnessFilters {
+    /** Filter by the form field's label text. */
+    label?: string | RegExp;
+    /** Filter by whether the form field has errors. */
+    hasErrors?: boolean;
+    /** Filter by whether the form field is disabled. */
+    disabled?: boolean;
+    /** Filter by whether the label is floating. */
+    floatingLabel?: boolean;
+}
+/**
+ * Harness for interacting with a ComFormField in tests.
+ */
+declare class ComFormFieldHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly label;
+    private readonly input;
+    private readonly hints;
+    private readonly errors;
+    private readonly prefix;
+    private readonly suffix;
+    /**
+     * Gets a HarnessPredicate for matching form fields.
+     * @param options Filter options.
+     */
+    static with(options?: ComFormFieldHarnessFilters): HarnessPredicate<ComFormFieldHarness>;
+    /** Gets the form field's label text, or null if no label is present. */
+    getLabel(): Promise<string | null>;
+    /** Whether the form field has a label. */
+    hasLabel(): Promise<boolean>;
+    /** Whether the form field is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the form field is focused. */
+    isFocused(): Promise<boolean>;
+    /** Whether the form field has errors. */
+    hasErrors(): Promise<boolean>;
+    /** Whether the label is currently floating. */
+    isLabelFloating(): Promise<boolean>;
+    /** Gets the text content of all visible error elements. */
+    getTextErrors(): Promise<string[]>;
+    /** Gets the text content of all hint elements. */
+    getTextHints(): Promise<string[]>;
+    /** Whether the form field has a prefix element. */
+    hasPrefix(): Promise<boolean>;
+    /** Whether the form field has a suffix element. */
+    hasSuffix(): Promise<boolean>;
+    /** Whether the form field's control is required. */
+    isRequired(): Promise<boolean>;
+    /** Gets the form field's inner control element (input or textarea). */
+    getControl(): Promise<TestElement | null>;
+    /** Focuses the form field's inner control element. */
+    focus(): Promise<void>;
+    /** Blurs the form field's inner control element. */
+    blur(): Promise<void>;
+}
+
+export { ComFormFieldHarness };
+export type { ComFormFieldHarnessFilters };