@ethlete/components 1.0.0-next.66 → 1.0.0-next.67

package/generators/migrate-time-picker-ring/migration.js

@@ -0,0 +1,17 @@
+import { runRemovedExportsMigration, } from '../removed-exports/run-removed-exports-migration.js';
+import { REMOVED_SELECTORS, replaceSetActiveSide, TIME_PICKER_RING_REMOVALS } from './time-picker-ring.js';
+export const TIME_PICKER_RING_REPORT_PATH = 'time-picker-ring-migration-tasks.md';
+export default async function migrateTimePickerRing(tree, schema) {
+    await runRemovedExportsMigration(tree, schema, {
+        title: 'Moving the time picker to the ring API',
+        removed: TIME_PICKER_RING_REMOVALS,
+        reportPath: TIME_PICKER_RING_REPORT_PATH,
+        rewrite: (_tree, filePath, content) => {
+            if (REMOVED_SELECTORS.test(content)) {
+                console.warn(`\n⚠️  ${filePath} uses etTimePickerColumn or etTimePickerOption, which are removed. See the time picker guide: /components/time-picker.`);
+            }
+            return replaceSetActiveSide(content);
+        },
+    });
+}
+//# sourceMappingURL=migration.js.map

package/generators/migrate-time-picker-ring/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "migrate-time-picker-ring",
+  "title": "Replace the removed time picker setActiveSide with activeSide.set, and mark the removed column and option directives",
+  "type": "object",
+  "properties": {
+    "projects": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Nx projects to scan. Defaults to every project in the workspace.",
+      "alias": "project"
+    },
+    "include": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Path prefixes to scan, relative to the workspace root (e.g. 'apps/shop'). Unioned with `projects`.",
+      "alias": "includePath"
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "description": "Skip formatting files after migration",
+      "default": false
+    }
+  },
+  "required": []
+}

package/generators/migrate-time-picker-ring/time-picker-ring.js

@@ -0,0 +1,25 @@
+const GUIDE = 'See the time picker guide (/components/time-picker).';
+export const TIME_PICKER_RING_REMOVALS = [
+    {
+        name: 'TimePickerColumnDirective',
+        dropFromArrays: ['imports'],
+        todo: `TimePickerColumnDirective is removed; the time picker is a ring. ${GUIDE}`,
+    },
+    {
+        name: 'TimePickerOptionDirective',
+        dropFromArrays: ['imports'],
+        todo: `TimePickerOptionDirective is removed; the time picker is a ring. ${GUIDE}`,
+    },
+];
+export const REMOVED_SELECTORS = /\betTimePicker(?:Column|Option)\b/;
+const TIME_PICKER_USE = /TimePicker|etTimePicker|et-time-picker/;
+const SET_ACTIVE_SIDE = /(\.\s*)setActiveSide(\s*\()/g;
+export const mentionsTimePicker = (content) => TIME_PICKER_USE.test(content);
+/** Returns the source or template with every `.setActiveSide(` call turned into `.activeSide.set(`, or `null` when there is none. */
+export const replaceSetActiveSide = (content) => {
+    if (!mentionsTimePicker(content))
+        return null;
+    const next = content.replace(SET_ACTIVE_SIDE, '$1activeSide.set$2');
+    return next === content ? null : next;
+};
+//# sourceMappingURL=time-picker-ring.js.map

package/migrations.json

@@ -4,6 +4,7 @@
       "name": "query-error-labels",
       "version": "1.0.0-next.33",
       "kind": "auto",
+      "level": "required",
       "description": "Find the query-error call sites the English-only label default changes, and report where German must be opted back in.",
       "generator": "@ethlete/components:migrate-query-error-labels",
       "docs": "/components/query-error"
@@ -12,6 +13,7 @@
       "name": "rich-text-editor-link-editor",
       "version": "1.0.0-next.33",
       "kind": "auto",
+      "level": "required",
       "description": "Find the rich text editors that lose the link editor popover, and report where to opt back in.",
       "generator": "@ethlete/components:migrate-rich-text-editor-link-editor",
       "docs": "/components/rich-text-editor"
@@ -20,6 +22,7 @@
       "name": "rich-text-editor-tools",
       "version": "1.0.0-next.36",
       "kind": "auto",
+      "level": "required",
       "description": "Find the rich text editors that lose the heading, quote, code-block and link tools, and report where to opt back in.",
       "generator": "@ethlete/components:migrate-rich-text-editor-tools",
       "docs": "/components/rich-text-editor"
@@ -28,6 +31,7 @@
       "name": "rich-text-editor-floating-toolbar",
       "version": "1.0.0-next.36",
       "kind": "auto",
+      "level": "required",
       "description": "Find the rich text editors that lose the selection toolbar, and report where to opt back in.",
       "generator": "@ethlete/components:migrate-rich-text-editor-floating-toolbar",
       "docs": "/components/rich-text-editor"
@@ -36,6 +40,7 @@
       "name": "bracket-ethlete-renames",
       "version": "1.0.0-next.64",
       "kind": "auto",
+      "level": "required",
       "description": "Rename generateTournamentModeFormEthleteRounds to generateTournamentModeFromEthleteRounds.",
       "generator": "@ethlete/components:migrate-bracket-ethlete-renames",
       "docs": "/components/bracket"
@@ -44,6 +49,7 @@
       "name": "bracket-default-cards",
       "version": "1.0.0-next.64",
       "kind": "auto",
+      "level": "required",
       "description": "Spread BRACKET_DEFAULT_CARDS into provideBracketConfig, and report the brackets that need it by hand.",
       "generator": "@ethlete/components:migrate-bracket-default-cards",
       "docs": "/components/bracket"
@@ -52,6 +58,7 @@
       "name": "overlay-nav-tab-imports",
       "version": "1.0.0-next.64",
       "kind": "auto",
+      "level": "required",
       "description": "Add OVERLAY_NAV_TAB_IMPORTS where a NAV_TAB_IMPORTS component renders et-overlay-nav-tab-link.",
       "generator": "@ethlete/components:migrate-overlay-nav-tab-imports",
       "docs": "/components/tabs"
@@ -60,6 +67,7 @@
       "name": "youtube-player-slot-directive",
       "version": "1.0.0-next.64",
       "kind": "auto",
+      "level": "required",
       "description": "Remove YoutubePlayerSlotDirective and YOUTUBE_PLAYER_SLOT_TOKEN, and mark the uses that need a YoutubePlayerSlotComponent.",
       "generator": "@ethlete/components:migrate-youtube-player-slot-directive",
       "docs": "/components/stream"
@@ -68,6 +76,7 @@
       "name": "chart-baseline-y",
       "version": "1.0.0-next.65",
       "kind": "auto",
+      "level": "required",
       "description": "Rename the removed chart-grid baselineY alias to baseline.",
       "generator": "@ethlete/components:migrate-chart-baseline-y",
       "docs": "/components/chart"
@@ -76,6 +85,7 @@
       "name": "grid-engine-internals",
       "version": "1.0.0-next.65",
       "kind": "auto",
+      "level": "required",
       "description": "Remove the grid layout engine internals from @ethlete/components imports and mark the uses that need another approach.",
       "generator": "@ethlete/components:migrate-grid-engine-internals",
       "docs": "/components/grid"
@@ -84,6 +94,7 @@
       "name": "overlay-fullscreen-animation",
       "version": "1.0.0-next.65",
       "kind": "auto",
+      "level": "required",
       "description": "Remove the overlay fullscreen animation internals from @ethlete/components imports and mark the uses that need another approach.",
       "generator": "@ethlete/components:migrate-overlay-fullscreen-animation",
       "docs": "/components/overlays"
@@ -92,9 +103,73 @@
       "name": "stream-default-components",
       "version": "1.0.0-next.65",
       "kind": "auto",
+      "level": "required",
       "description": "Spread STREAM_DEFAULT_COMPONENTS into provideStreamConfig, add it to the app config of an app without one, and report the rest.",
       "generator": "@ethlete/components:migrate-stream-default-components",
       "docs": "/components/stream"
+    },
+    {
+      "name": "time-picker-ring",
+      "version": "1.0.0-next.67",
+      "kind": "auto",
+      "level": "required",
+      "description": "Replace the removed time picker setActiveSide with activeSide.set, and mark the removed column and option directives.",
+      "generator": "@ethlete/components:migrate-time-picker-ring",
+      "docs": "/components/time-picker"
+    },
+    {
+      "name": "cascader-tree-internals",
+      "version": "1.0.0-next.67",
+      "kind": "auto",
+      "level": "required",
+      "description": "Remove the cascader tree helpers from @ethlete/components imports and mark the uses that need another approach.",
+      "generator": "@ethlete/components:migrate-cascader-tree-internals",
+      "docs": "/components/cascader"
+    },
+    {
+      "name": "duration-format-internals",
+      "version": "1.0.0-next.67",
+      "kind": "auto",
+      "level": "required",
+      "description": "Remove the duration format helpers from @ethlete/components imports and mark the uses that need another approach.",
+      "generator": "@ethlete/components:migrate-duration-format-internals",
+      "docs": "/components/date-time-inputs"
+    },
+    {
+      "name": "line-chart-stacked-area-mix",
+      "version": "1.0.0-next.67",
+      "kind": "auto",
+      "level": "required",
+      "description": "Rename --et-line-chart-stacked-area-opacity to --et-line-chart-stacked-area-mix and map each opacity to a percentage.",
+      "generator": "@ethlete/components:migrate-line-chart-stacked-area-mix",
+      "docs": "/components/line-chart"
+    },
+    {
+      "name": "error-color-theme-signal",
+      "version": "1.0.0-next.67",
+      "kind": "auto",
+      "level": "required",
+      "description": "Call errorColorTheme() where an injectFormSupport() result or a TableComponent reads it, now that it is a signal.",
+      "generator": "@ethlete/components:migrate-error-color-theme-signal",
+      "docs": "/components/forms"
+    },
+    {
+      "name": "select-input-renames",
+      "version": "1.0.0-next.67",
+      "kind": "auto",
+      "level": "required",
+      "description": "Rename the et-select inputs error, customValueSeparators and normalizeCustomValue, and the tag input inputs maxTags and normalizeTag, in templates.",
+      "generator": "@ethlete/components:migrate-select-input-renames",
+      "docs": "/components/select"
+    },
+    {
+      "name": "loader-determinate",
+      "version": "1.0.0-next.67",
+      "kind": "auto",
+      "level": "required",
+      "description": "Remove determinate from et-spinner and indeterminate from et-progress-bar, which now follow whether value is bound, and rewrite value where the mode was dynamic.",
+      "generator": "@ethlete/components:migrate-loader-determinate",
+      "docs": "/components/loader"
     }
   ]
 }

package/package.json

@@ -1,33 +1,29 @@
 {
   "name": "@ethlete/components",
-  "version": "1.0.0-next.66",
+  "version": "1.0.0-next.67",
   "license": "MIT",
   "sideEffects": false,
   "dependencies": {
-    "@ethlete/bracket": "^1.0.0-next.2",
+    "@ethlete/bracket": "^1.0.0-next.3",
     "tslib": "^2.3.0"
   },
   "peerDependencies": {
-    "@analogjs/vitest-angular": "2.6.3",
-    "@angular/common": "22.1.6",
-    "@angular/compiler": "22.1.6",
-    "@angular/core": "22.1.6",
-    "@angular/forms": "22.1.6",
-    "@angular/platform-browser": "22.1.6",
-    "@angular/router": "22.1.6",
-    "@date-fns/tz": "1.5.0",
+    "@angular/common": "^22.1.0",
+    "@angular/compiler": "^22.1.0",
+    "@angular/core": "^22.1.0",
+    "@angular/forms": "^22.1.0",
+    "@angular/platform-browser": "^22.1.0",
+    "@angular/router": "^22.1.0",
+    "@date-fns/tz": "^1.2.0",
     "@ethlete/core": "^5.0.0-beta.11",
     "@ethlete/query": "^6.0.0-beta.8",
     "@ethlete/types": "^2.0.0-beta.4",
-    "@floating-ui/dom": "1.8.0",
-    "@nx/devkit": "23.1.0",
-    "date-fns": "4.4.0",
-    "rxjs": "7.8.2"
+    "@floating-ui/dom": "^1.6.0",
+    "@nx/devkit": "^23.0.0",
+    "date-fns": "^4.0.0",
+    "rxjs": "^7.8.0"
   },
   "peerDependenciesMeta": {
-    "@analogjs/vitest-angular": {
-      "optional": true
-    },
     "@date-fns/tz": {
       "optional": true
     },
@@ -51,6 +47,10 @@
     ".": {
       "types": "./types/ethlete-components.d.ts",
       "default": "./fesm2022/ethlete-components.mjs"
+    },
+    "./testing": {
+      "types": "./types/ethlete-components-testing.d.ts",
+      "default": "./fesm2022/ethlete-components-testing.mjs"
     }
   },
   "type": "module"

package/types/ethlete-components-testing.d.ts

@@ -0,0 +1,311 @@
+import * as _angular_core from '@angular/core';
+import { Type, Provider } from '@angular/core';
+import { ComponentFixture } from '@angular/core/testing';
+import { OverlayRuntimeCloseSource } from '@ethlete/core';
+import { OverlayRef, OverlayConfig, SelectDirective, TabBarDirective } from '@ethlete/components';
+
+type ControlDriverOptions = {
+    /** Matches the element carrying the directive, when the host template nests it. */
+    directiveSelector?: string;
+};
+/** The host, the directive under test, and queries scoped to the fixture - what every driver needs. */
+declare const createControlDriver: <T, D>(fixture: ComponentFixture<T>, directiveType: Type<D>, { directiveSelector }?: ControlDriverOptions) => {
+    fixture: ComponentFixture<T>;
+    host: T;
+    control: D;
+    detectChanges: () => void;
+    tick: () => void;
+    element: () => HTMLElement;
+    directive: <X>(type: Type<X>, selector?: string) => X;
+    query: <E extends HTMLElement = HTMLElement>(selector: string) => E | null;
+    queryAll: <E extends HTMLElement = HTMLElement>(selector: string) => E[];
+    text: (selector: string) => string | null;
+    click: (element: HTMLElement) => void;
+};
+
+/**
+ * Types masked date/time text one character at a time, with the caret tracking the insertion -
+ * what `InputMaskDirective`'s live reformatting needs, unlike a whole-string {@link typeInField}.
+ */
+declare const typeMasked: (field: HTMLInputElement, text: string) => void;
+/**
+ * Driver for every date-time control that pairs text fields with a picker overlay: date, date
+ * range, date-time, time and time range. The picker trigger is matched by its directive, so a test
+ * host can put it on any element; the fields are matched by CSS, defaulting to the only `input`.
+ */
+declare const createDatePickerDriver: <T, D extends {
+    closePicker: () => void;
+}>(fixture: ComponentFixture<T>, directiveType: Type<D>, options?: ControlDriverOptions) => {
+    dayCell: (label: string) => HTMLButtonElement | null;
+    clickDayCell: (label: string) => void;
+    field: (selector?: string) => HTMLInputElement;
+    fields: () => HTMLInputElement[];
+    type: (text: string, selector?: string) => void;
+    typeMasked: (text: string, selector?: string) => void;
+    typeAndBlur: (text: string, selector?: string) => void;
+    focusField: (selector?: string) => void;
+    blurField: (selector?: string) => void;
+    pressInField: (key: string, selector?: string) => KeyboardEvent;
+    settle: () => Promise<void>;
+    trigger: <E extends HTMLElement = HTMLElement>() => E;
+    pane: () => HTMLElement | null;
+    paneEl: <E extends HTMLElement = HTMLElement>(selector: string) => E | null;
+    paneEls: <E extends HTMLElement = HTMLElement>(selector: string) => E[];
+    open: () => Promise<void>;
+    close: () => Promise<void>;
+    closeAndRemovePanes: () => void;
+    press: (key: string) => KeyboardEvent;
+    escape: () => KeyboardEvent;
+    pointerDownOutside: () => void;
+    clickInPane: (selector: string) => void;
+    fixture: ComponentFixture<T>;
+    host: T;
+    control: D;
+    detectChanges: () => void;
+    tick: () => void;
+    element: () => HTMLElement;
+    directive: <X>(type: Type<X>, selector?: string) => X;
+    query: <E extends HTMLElement = HTMLElement>(selector: string) => E | null;
+    queryAll: <E extends HTMLElement = HTMLElement>(selector: string) => E[];
+    text: (selector: string) => string | null;
+    click: (element: HTMLElement) => void;
+};
+type DatePickerDriver<T, D extends {
+    closePicker: () => void;
+}> = ReturnType<typeof createDatePickerDriver<T, D>>;
+
+declare const tick: () => void;
+declare const flushFrames: () => Promise<void>;
+declare const resetOverlays: () => void;
+/**
+ * The newest overlay pane in the document.
+ *
+ * Overlays render into the document, not into the fixture, and jsdom fires no transition events -
+ * so a pane stuck in its leave transition stays reachable. Scope every pane query through here, or
+ * a stale pane answers it.
+ */
+declare const latestPane: () => HTMLElement | null;
+declare const hostDirective: <T>(fixture: ComponentFixture<unknown>, type: Type<T>) => T;
+declare const directiveAt: <T>(fixture: ComponentFixture<unknown>, type: Type<T>, selector: string) => T;
+declare const hostElement: (fixture: ComponentFixture<unknown>) => HTMLElement;
+/**
+ * Queries the fixture's root element, narrowing `nativeElement` (typed `any`) to `HTMLElement`
+ * once - a generic call directly through `fixture.nativeElement.querySelectorAll<E>(...)` fails
+ * with TS2347 and collapses every downstream member access to `{}`.
+ */
+declare const queryAll: <E extends Element = HTMLElement>(fixture: ComponentFixture<unknown>, selector: string) => E[];
+/** Single-result counterpart of {@link queryAll}. */
+declare const query: <E extends Element = HTMLElement>(fixture: ComponentFixture<unknown>, selector: string) => E | null;
+declare const pressKey: (target: EventTarget, key: string, init?: KeyboardEventInit) => KeyboardEvent;
+declare const focusEvent: (target: EventTarget, type: "focus" | "blur") => void;
+declare const pointerEnter: (target: EventTarget) => void;
+declare const pointerEvent: (target: EventTarget, type: string, init?: PointerEventInit) => void;
+declare const setInputValue: (input: HTMLInputElement, value: string) => void;
+declare const focusField: (field: HTMLInputElement) => void;
+declare const typeInField: (field: HTMLInputElement, text: string) => void;
+/**
+ * Types `text` one character at a time, each with its own `input` event and the caret left after
+ * the inserted character - what a real keyboard produces. Use it instead of {@link typeInField}
+ * whenever the control reads or rewrites the element between keystrokes; a whole-string
+ * {@link setInputValue} hides every defect that only appears mid-entry.
+ */
+declare const typeChars: (field: HTMLInputElement, text: string) => void;
+declare const blurField: (field: HTMLInputElement) => void;
+declare const pointerDownOutside: () => void;
+type ClipboardPayload = Readonly<Record<string, string>>;
+/** jsdom has no `DataTransfer`, so the clipboard payload is faked onto the event. */
+declare const pasteInto: (target: EventTarget, payload: ClipboardPayload | string) => void;
+declare const textOf: (element: Element | null | undefined) => string | null;
+
+type TestOverlayRef<TComponent extends object = object, TResult = unknown> = OverlayRef<TComponent, TResult> & {
+    /** Every `close()` / `forceClose()` call, in order, including ones a close guard vetoed. */
+    readonly closeCalls: readonly {
+        result: TResult | undefined;
+        source: OverlayRuntimeCloseSource;
+        forced: boolean;
+    }[];
+    /** Whether a close got past the close guards. */
+    readonly isClosed: () => boolean;
+};
+/**
+ * A standalone `OverlayRef` for unit-testing an overlay component without opening it: `close(result)`
+ * runs the registered close guards, records the call and emits `beforeClosed` / `afterClosed`
+ * (replayed, so a late subscriber still sees the result). Pair it with {@link provideTestOverlayRef}.
+ *
+ * @example
+ * const ref = createTestOverlayRef<ProductResult>();
+ * TestBed.configureTestingModule({ providers: [provideTestOverlayRef(ref)] });
+ * // … press the component's save button …
+ * expect(ref.closeCalls.at(-1)?.result).toEqual({ saved: true });
+ */
+declare const createTestOverlayRef: <TResult = unknown, TComponent extends object = object>(config?: OverlayConfig) => TestOverlayRef<TComponent, TResult>;
+/** Provides `ref` (a fresh {@link createTestOverlayRef} by default) as `OVERLAY_REF`, so `definition.injectRef()` resolves it. */
+declare const provideTestOverlayRef: <TResult = unknown>(ref?: TestOverlayRef<object, TResult>) => Provider[];
+
+type FieldControlDriverOptions = ControlDriverOptions & {
+    /** Matches the editable field, when it is not the host's only `input`. */
+    fieldSelector?: string;
+};
+/**
+ * The plumbing every text-field form control driver needs: the host component, the directive, the
+ * native field, and the value / focus / key events a user produces on it.
+ */
+declare const createFieldControlDriver: <T, D>(fixture: ComponentFixture<T>, directiveType: Type<D>, { fieldSelector, ...controlOptions }?: FieldControlDriverOptions) => {
+    field: () => HTMLInputElement;
+    fieldValue: () => string;
+    placeholder: () => string;
+    type: (text: string) => void;
+    /** Types one character at a time - what a keyboard produces, unlike `type`'s single event. */
+    typeChars: (text: string) => void;
+    typeAndBlur: (text: string) => void;
+    focus: () => void;
+    blur: () => void;
+    press: (key: string, init?: KeyboardEventInit) => KeyboardEvent;
+    pointer: (target: EventTarget, type: string, init?: PointerEventInit) => void;
+    fixture: ComponentFixture<T>;
+    host: T;
+    control: D;
+    detectChanges: () => void;
+    tick: () => void;
+    element: () => HTMLElement;
+    directive: <X>(type: Type<X>, selector?: string) => X;
+    query: <E extends HTMLElement = HTMLElement>(selector: string) => E | null;
+    queryAll: <E extends HTMLElement = HTMLElement>(selector: string) => E[];
+    text: (selector: string) => string | null;
+    click: (element: HTMLElement) => void;
+};
+type FieldControlDriver<T, D> = ReturnType<typeof createFieldControlDriver<T, D>>;
+
+type OverlayControlDriverOptions<D> = ControlDriverOptions & {
+    /** The element the user clicks to open the overlay. */
+    triggerSelector?: string;
+    /** How this control closes its overlay from code. */
+    hide: (control: D) => void;
+};
+/**
+ * The plumbing every overlay-backed form control driver needs: the host component, the directive,
+ * the trigger, the overlay pane, and the open/close dance jsdom needs two frames for.
+ */
+declare const createOverlayControlDriver: <T, D>(fixture: ComponentFixture<T>, directiveType: Type<D>, { triggerSelector, hide, ...controlOptions }: OverlayControlDriverOptions<D>) => {
+    settle: () => Promise<void>;
+    trigger: <E extends HTMLElement = HTMLElement>() => E;
+    pane: () => HTMLElement | null;
+    paneEl: <E extends HTMLElement = HTMLElement>(selector: string) => E | null;
+    paneEls: <E extends HTMLElement = HTMLElement>(selector: string) => E[];
+    open: () => Promise<void>;
+    close: () => Promise<void>;
+    closeAndRemovePanes: () => void;
+    press: (key: string) => KeyboardEvent;
+    escape: () => KeyboardEvent;
+    pointerDownOutside: () => void;
+    clickInPane: (selector: string) => void;
+    fixture: ComponentFixture<T>;
+    host: T;
+    control: D;
+    detectChanges: () => void;
+    tick: () => void;
+    element: () => HTMLElement;
+    directive: <X>(type: Type<X>, selector?: string) => X;
+    query: <E extends HTMLElement = HTMLElement>(selector: string) => E | null;
+    queryAll: <E extends HTMLElement = HTMLElement>(selector: string) => E[];
+    text: (selector: string) => string | null;
+    click: (element: HTMLElement) => void;
+};
+
+declare const createSelectDriver: <T>(fixture: ComponentFixture<T>, controlOptions?: ControlDriverOptions) => {
+    select: SelectDirective<unknown>;
+    searchInput: () => HTMLInputElement;
+    valueEl: () => HTMLElement | null;
+    valueText: () => string | null;
+    chips: () => HTMLElement[];
+    chipLabels: () => (string | null)[];
+    chipRemoveButton: (index: number) => HTMLElement | null;
+    listbox: () => HTMLElement | null;
+    paneText: () => string | null;
+    options: () => HTMLElement[];
+    visibleOptions: () => HTMLElement[];
+    activeOption: () => HTMLElement | null;
+    activeLabel: () => string | null;
+    optionLabels: () => (string | null)[];
+    visibleLabels: () => (string | null)[];
+    optionByLabel: (label: string) => HTMLElement | null;
+    optionGroups: () => HTMLElement[];
+    groupsHidden: () => boolean[];
+    groupOptionCounts: () => number[];
+    groupLabel: (index: number) => string | null;
+    virtualPadding: () => {
+        start: number;
+        end: number;
+    };
+    clickOption: (index: number) => void;
+    clickOptionByLabel: (label: string) => void;
+    removeChip: (index: number) => void;
+    hover: (element: HTMLElement) => void;
+    type: (text: string) => void;
+    pressInSearch: (key: string) => KeyboardEvent;
+    paste: (text: string) => void;
+    settle: () => Promise<void>;
+    trigger: <E extends HTMLElement = HTMLElement>() => E;
+    pane: () => HTMLElement | null;
+    paneEl: <E extends HTMLElement = HTMLElement>(selector: string) => E | null;
+    paneEls: <E extends HTMLElement = HTMLElement>(selector: string) => E[];
+    open: () => Promise<void>;
+    close: () => Promise<void>;
+    closeAndRemovePanes: () => void;
+    press: (key: string) => KeyboardEvent;
+    escape: () => KeyboardEvent;
+    pointerDownOutside: () => void;
+    clickInPane: (selector: string) => void;
+    fixture: ComponentFixture<T>;
+    host: T;
+    control: SelectDirective<unknown>;
+    detectChanges: () => void;
+    tick: () => void;
+    element: () => HTMLElement;
+    directive: <X>(type: _angular_core.Type<X>, selector?: string) => X;
+    query: <E extends HTMLElement = HTMLElement>(selector: string) => E | null;
+    queryAll: <E extends HTMLElement = HTMLElement>(selector: string) => E[];
+    text: (selector: string) => string | null;
+    click: (element: HTMLElement) => void;
+};
+type SelectDriver<T> = ReturnType<typeof createSelectDriver<T>>;
+
+type TabBarDriverOptions = ControlDriverOptions & {
+    /** Matches every trigger inside the bar. Defaults to the role every `TabBarTriggerDirective` host carries. */
+    triggerSelector?: string;
+};
+/**
+ * Wraps a mounted `[etTabBar]` host with the roving-tabindex vocabulary its keyboard model needs:
+ * which trigger is currently the tab stop, and dispatching a key from wherever focus actually is.
+ */
+declare const createTabBarDriver: <T>(fixture: ComponentFixture<T>, options?: TabBarDriverOptions) => {
+    triggers: () => HTMLButtonElement[];
+    trigger: (index: number) => HTMLButtonElement;
+    tabbableTrigger: () => HTMLButtonElement | null;
+    focusTabbable: () => void;
+    press: (key: string, init?: KeyboardEventInit) => KeyboardEvent;
+    focusedIndex: () => number;
+    selectedIndex: () => number;
+    fixture: ComponentFixture<T>;
+    host: T;
+    control: TabBarDirective;
+    detectChanges: () => void;
+    tick: () => void;
+    element: () => HTMLElement;
+    directive: <X>(type: _angular_core.Type<X>, selector?: string) => X;
+    query: <E extends HTMLElement = HTMLElement>(selector: string) => E | null;
+    queryAll: <E extends HTMLElement = HTMLElement>(selector: string) => E[];
+    text: (selector: string) => string | null;
+    click: (element: HTMLElement) => void;
+};
+
+/**
+ * Installs the browser APIs jsdom lacks and `@ethlete/components` needs to render: `ResizeObserver`,
+ * `IntersectionObserver`, `matchMedia` and `Element.prototype.animate`. Call it once in a test setup file;
+ * an API that already exists is left alone. The fakes never report: observers never fire, no media query
+ * matches, and an animation finishes on the next microtask.
+ */
+declare const setupComponentsTestEnvironment: () => void;
+
+export { blurField, createControlDriver, createDatePickerDriver, createFieldControlDriver, createOverlayControlDriver, createSelectDriver, createTabBarDriver, createTestOverlayRef, directiveAt, flushFrames, focusEvent, focusField, hostDirective, hostElement, latestPane, pasteInto, pointerDownOutside, pointerEnter, pointerEvent, pressKey, provideTestOverlayRef, query, queryAll, resetOverlays, setInputValue, setupComponentsTestEnvironment, textOf, tick, typeChars, typeInField, typeMasked };
+export type { ClipboardPayload, ControlDriverOptions, DatePickerDriver, FieldControlDriver, FieldControlDriverOptions, OverlayControlDriverOptions, SelectDriver, TabBarDriverOptions, TestOverlayRef };