ngx-com 0.1.16 → 0.1.17

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 };

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 };