@bitforgehq/ui 0.3.0 → 0.3.1

package/types/bitforgehq-ui-testing.d.ts

@@ -1,5 +1,5 @@
 import { EnvironmentProviders } from "@angular/core";
-import { provideBfDefaults, provideBfLabels } from "@bitforgehq/ui";
+import { BfTableSort, provideBfDefaults, provideBfLabels } from "@bitforgehq/ui";
 import { BaseHarnessFilters, ComponentHarness, HarnessPredicate, LocatorFactory } from "@angular/cdk/testing";
 /**
  * Options of `installBfJsdomShims()`.
@@ -492,4 +492,751 @@ export declare class BfDesktopToastHarness extends ComponentHarness {
   /** Presses `Escape` inside the toast, which dismisses it with `'dismiss'`. */
   pressEscape(): Promise<void>;
 }
+/**
+ * Harness for `bf-table`. It works by column header text and row position, so a test never needs
+ * the column keys or the row keys (except `getSort()`, which returns the column's `key`, as the
+ * `sort` model holds it).
+ *
+ * @example
+ * const tasks = await loader.getHarness(BfTableHarness.with({ label: 'Tasks' }));
+ * await tasks.sortBy('Title');
+ * expect(await tasks.getCellText(0, 'Title')).toBe('Atlas rebrand');
+ * @summary Test harness for the data table: reads rows and cells, sorts and selects rows
+ * @since 0.3.1
+ */
+export declare class BfTableHarness extends ComponentHarness {
+  /** The host element's selector. */
+  static hostSelector: string;
+  private readonly caption;
+  private readonly headers;
+  private readonly rows;
+  private readonly selectAllBox;
+  private readonly rowBoxes;
+  /**
+   * A predicate for a table with the given label.
+   * @param filters The label (text or pattern) and the CDK's selector and ancestor filters.
+   * @returns The predicate for `getHarness()` and friends.
+   */
+  static with(filters?: BfHarnessFilters): HarnessPredicate<BfTableHarness>;
+  /**
+   * The table's name, its visually hidden caption.
+   * @returns The label text, `''` without one.
+   */
+  getLabel(): Promise<string>;
+  /**
+   * The number of body rows; `0` while the empty slot shows.
+   * @returns The row count.
+   */
+  getRowCount(): Promise<number>;
+  /**
+   * The column headers' text, in order, without the selection column.
+   * @returns The header labels.
+   */
+  getHeaderLabels(): Promise<string[]>;
+  /**
+   * The text of one cell.
+   * @param row The row's position, from 0.
+   * @param column The column's header text.
+   * @returns The cell's text.
+   */
+  getCellText(row: number, column: string): Promise<string>;
+  /**
+   * Clicks a sortable column's header, as a user would: ascending first, then descending.
+   * Throws for an unknown or unsortable column.
+   * @param column The column's header text.
+   */
+  sortBy(column: string): Promise<void>;
+  /**
+   * The sorted column (its `key`) and direction, from `aria-sort`.
+   * @returns The sort, `null` while no column is sorted.
+   */
+  getSort(): Promise<BfTableSort | null>;
+  /**
+   * Checks one row's checkbox, as a user would; a selected row stays selected. Throws when the
+   * table is not selectable or the row does not exist.
+   * @param index The row's position, from 0.
+   */
+  selectRow(index: number): Promise<void>;
+  /**
+   * Checks the header checkbox, as a user would, so every row is selected. Throws when the table
+   * is not selectable.
+   */
+  selectAll(): Promise<void>;
+  /**
+   * The number of selected rows (checked row checkboxes).
+   * @returns The count.
+   */
+  getSelectedCount(): Promise<number>;
+  private check;
+  private columnIndex;
+}
+/**
+ * Harness for `bf-pagination`. It reads the current page and the page count as numbers, so a test
+ * never parses the "Page 3 of 12" text, and clicks the buttons as a user would.
+ *
+ * @example
+ * const pages = await loader.getHarness(BfPaginationHarness.with({ label: 'Invoice pages' }));
+ * await pages.next();
+ * expect(await pages.getCurrentPage()).toBe(2);
+ * @summary Test harness for pagination: reads the current page and moves between pages
+ * @since 0.3.1
+ */
+export declare class BfPaginationHarness extends ComponentHarness {
+  /** The host element's selector. */
+  static hostSelector: string;
+  private readonly nav;
+  private readonly previousButton;
+  private readonly nextButton;
+  private readonly pages;
+  /**
+   * A predicate for a pagination with the given label.
+   * @param filters The label (text or pattern) and the CDK's selector and ancestor filters.
+   * @returns The predicate for `getHarness()` and friends.
+   */
+  static with(filters?: BfHarnessFilters): HarnessPredicate<BfPaginationHarness>;
+  /**
+   * The navigation's accessible name (`label`, else "Pagination").
+   * @returns The label text.
+   */
+  getLabel(): Promise<string>;
+  /**
+   * The page shown as current, 1-based.
+   * @returns The current page.
+   */
+  getCurrentPage(): Promise<number>;
+  /**
+   * The number of pages in effect (`pageCount`, else `total` over `pageSize`, at least 1).
+   * @returns The page count.
+   */
+  getPageCount(): Promise<number>;
+  /**
+   * The page numbers the row shows right now, in order, without the gaps; empty when compact.
+   * @returns The visible page numbers.
+   */
+  getVisiblePages(): Promise<number[]>;
+  /**
+   * Clicks the button of this page, as a user would. Throws when the row does not show it (behind
+   * a gap, or in a compact pagination).
+   * @param page The 1-based page to go to.
+   */
+  goTo(page: number): Promise<void>;
+  /** Clicks Next. Throws on the last page, where the button is disabled. */
+  next(): Promise<void>;
+  /** Clicks Previous. Throws on the first page, where the button is disabled. */
+  previous(): Promise<void>;
+  /**
+   * Whether Previous is disabled (on the first page).
+   * @returns True on the first page.
+   */
+  isPreviousDisabled(): Promise<boolean>;
+  /**
+   * Whether Next is disabled (on the last page).
+   * @returns True on the last page.
+   */
+  isNextDisabled(): Promise<boolean>;
+  /** Clicks an arrow button, unless it is disabled. */
+  private press;
+}
+/**
+ * Harness for `bf-tab-group`. It works by tab label, so a test never needs the panel values.
+ *
+ * @example
+ * const tabs = await loader.getHarness(BfTabGroupHarness.with({ label: 'Project' }));
+ * await tabs.selectTab('Activity');
+ * expect(await tabs.getPanelText()).toContain('No activity yet');
+ * @summary Test harness for the tab group: reads its tabs and panel and selects a tab
+ * @since 0.3.1
+ */
+export declare class BfTabGroupHarness extends ComponentHarness {
+  /** The host element's selector. */
+  static hostSelector: string;
+  private readonly list;
+  private readonly tabs;
+  private readonly tabLabels;
+  private readonly panel;
+  /**
+   * A predicate for a tab group with the given label.
+   * @param filters The label (text or pattern) and the CDK's selector and ancestor filters.
+   * @returns The predicate for `getHarness()` and friends.
+   */
+  static with(filters?: BfHarnessFilters): HarnessPredicate<BfTabGroupHarness>;
+  /**
+   * The tablist's accessible name (`label`, else the `tabGroup` label).
+   * @returns The label text.
+   */
+  getLabel(): Promise<string>;
+  /**
+   * The tabs' labels, in order (without their badges).
+   * @returns The tab labels.
+   */
+  getTabLabels(): Promise<string[]>;
+  /**
+   * The selected tab's label, `null` when the group has no tabs.
+   * @returns The label text or `null`.
+   */
+  getSelectedLabel(): Promise<string | null>;
+  /**
+   * Clicks the tab with this label, as a user would. Throws for an unknown label, and for a
+   * disabled tab (a user's click would do nothing).
+   * @param label The tab's label.
+   */
+  selectTab(label: string): Promise<void>;
+  /**
+   * The text of the panel shown.
+   * @returns The panel's text, `''` when no panel shows.
+   */
+  getPanelText(): Promise<string>;
+}
+/**
+ * Harness for `bf-side-panel`, the panel `BfSidePanelService` opens. Side panels render in the
+ * CDK overlay container outside the tested component, so get it through
+ * `TestbedHarnessEnvironment.documentRootLoader(fixture)`.
+ *
+ * @example
+ * const panel = await TestbedHarnessEnvironment.documentRootLoader(fixture).getHarness(
+ *   BfSidePanelHarness.with({ label: 'INV-204' }),
+ * );
+ * await panel.close();
+ * expect(await panel.isOpen()).toBe(false);
+ * @summary Test harness for a side panel: its title, its close button and its state
+ * @since 0.3.1
+ */
+export declare class BfSidePanelHarness extends ComponentHarness {
+  /** The host element's selector. */
+  static hostSelector: string;
+  private readonly title;
+  private readonly closeButton;
+  /**
+   * A predicate for a side panel with the given title.
+   * @param filters The title (text or pattern) and the CDK's selector and ancestor filters.
+   * @returns The predicate for `getHarness()` and friends.
+   */
+  static with(filters?: BfHarnessFilters): HarnessPredicate<BfSidePanelHarness>;
+  /**
+   * The title heading.
+   * @returns The title, `''` without one.
+   */
+  getTitle(): Promise<string>;
+  /** Clicks the close button (×), which closes the side panel with no result. */
+  close(): Promise<void>;
+  /**
+   * Whether the side panel is open: its overlay pane is in the page and not sliding out. The pane
+   * is found by the panel's own `data-bf-side-panel-id`.
+   * @returns True while the panel is open, false once closing or closed, or outside the service.
+   */
+  isOpen(): Promise<boolean>;
+}
+/**
+ * Harness for `bf-calendar`. It works with ISO dates ('YYYY-MM-DD'), as the calendar's value
+ * does, and drives it as a user would: `selectDate()` jumps to another month through the month
+ * and year views, then clicks the day.
+ *
+ * @example
+ * const due = await loader.getHarness(BfCalendarHarness.with({ label: 'Due date' }));
+ * await due.selectDate('2026-11-03');
+ * expect(await due.getSelected()).toBe('2026-11-03');
+ * @summary Test harness for the calendar: reads the month and picks a date by ISO string
+ * @since 0.3.1
+ */
+export declare class BfCalendarHarness extends ComponentHarness {
+  /** The host element's selector. */
+  static hostSelector: string;
+  private readonly group;
+  private readonly liveTitle;
+  private readonly titleButton;
+  private readonly previousButton;
+  private readonly nextButton;
+  private readonly selectedDay;
+  private readonly dayGrid;
+  /**
+   * A predicate for a calendar with the given label.
+   * @param filters The label (text or pattern) and the CDK's selector and ancestor filters.
+   * @returns The predicate for `getHarness()` and friends.
+   */
+  static with(filters?: BfHarnessFilters): HarnessPredicate<BfCalendarHarness>;
+  /**
+   * The calendar's accessible name (`label`, else `ariaLabel`); it is not rendered visibly.
+   * @returns The label text, `''` without one.
+   */
+  getLabel(): Promise<string>;
+  /**
+   * The shown month and year as the header writes them, in the calendar's locale.
+   * @returns The month label, such as "October 2026".
+   */
+  getMonthLabel(): Promise<string>;
+  /**
+   * The picked date while it is in the shown month.
+   * @returns The ISO date, or `null` when none is picked or it is in another month.
+   */
+  getSelected(): Promise<string | null>;
+  /** Clicks the next-month button. Throws when it is disabled (the month is past `max`). */
+  nextMonth(): Promise<void>;
+  /** Clicks the previous-month button. Throws when it is disabled (the month is before `min`). */
+  previousMonth(): Promise<void>;
+  /**
+   * Picks a date as a user would: when it is in another month, opens the month view, then the
+   * year view, clicks its year and month, then clicks the day. Throws for an invalid date, one
+   * the views do not list, and a disabled date or calendar.
+   * @param iso The ISO date to pick, such as '2026-11-03'.
+   */
+  selectDate(iso: string): Promise<void>;
+  private jumpTo;
+  private clickNav;
+}
+/** The elements that take keyboard focus, as the overlay core counts them. Internal. */
+declare const FOCUSABLE: string;
+/**
+ * Harness for an element with a `[bfTooltip]`. The tooltip renders in the CDK overlay container
+ * only while it shows, so `show()` focuses the element (the tooltip shows at once on keyboard
+ * focus; a 500 ms hover would need real time) and `getText()` reads the `bf-tooltip` its control
+ * is described by. Its `label` filter matches the element's accessible name (`aria-label`, else
+ * its text). Under a coarse pointer no tooltip shows.
+ *
+ * @example
+ * const copy = await loader.getHarness(BfTooltipHarness.with({ label: 'Copy link' }));
+ * expect(await copy.getText()).toBe('Copy link');
+ * @summary Test harness for a tooltip: shows it, reads its text and whether it shows
+ * @since 0.3.1
+ */
+export declare class BfTooltipHarness extends ComponentHarness {
+  /** The host element's selector: the attribute the tooltip directive puts on its host. */
+  static hostSelector: string;
+  private readonly inner;
+  /**
+   * A predicate for an element with a tooltip and the given accessible name.
+   * @param filters The name (text or pattern) and the CDK's selector and ancestor filters.
+   * @returns The predicate for `getHarness()` and friends.
+   */
+  static with(filters?: BfHarnessFilters): HarnessPredicate<BfTooltipHarness>;
+  /**
+   * The element's accessible name: its control's `aria-label`, else its text.
+   * @returns The name.
+   */
+  getLabel(): Promise<string>;
+  /** Shows the tooltip by focusing the element (or the first control inside it). */
+  show(): Promise<void>;
+  /** Hides the tooltip by moving focus off the element. */
+  hide(): Promise<void>;
+  /**
+   * Whether the tooltip shows.
+   * @returns True while it shows.
+   */
+  isOpen(): Promise<boolean>;
+  /**
+   * The tooltip's text, showing it first when it is hidden.
+   * @returns The text; throws when no tooltip shows (an empty text or a coarse pointer).
+   */
+  getText(): Promise<string>;
+  /** The element the tooltip describes: the host when it takes focus, else its first control. */
+  private control;
+  /** The shown `bf-tooltip` among the ids the control is described by, or `null`. */
+  private tooltip;
+}
+/**
+ * Harness for an element with a `[bfPopoverTriggerFor]` and the `bf-popover` it opens, which
+ * renders in the CDK overlay container while open (found through the trigger's
+ * `aria-controls`). Its `label` filter matches the trigger's accessible name (`aria-label`, else
+ * its text).
+ *
+ * @example
+ * const filters = await loader.getHarness(BfPopoverHarness.with({ label: 'Filters' }));
+ * await filters.open();
+ * expect(await filters.getPanelText()).toContain('Status');
+ * @summary Test harness for a popover: opens and closes it and reads its panel
+ * @since 0.3.1
+ */
+export declare class BfPopoverHarness extends ComponentHarness {
+  /** The host element's selector: the attribute the popover trigger directive puts on its host. */
+  static hostSelector: string;
+  private readonly inner;
+  /**
+   * A predicate for a popover trigger with the given accessible name.
+   * @param filters The name (text or pattern) and the CDK's selector and ancestor filters.
+   * @returns The predicate for `getHarness()` and friends.
+   */
+  static with(filters?: BfHarnessFilters): HarnessPredicate<BfPopoverHarness>;
+  /**
+   * The trigger's accessible name: its control's `aria-label`, else its text.
+   * @returns The name.
+   */
+  getLabel(): Promise<string>;
+  /** Opens the popover with a click; does nothing while it is open. */
+  open(): Promise<void>;
+  /** Closes the popover with `Escape`, as a user would; does nothing while it is closed. */
+  close(): Promise<void>;
+  /**
+   * Whether the popover is open (`aria-expanded`).
+   * @returns True while open.
+   */
+  isOpen(): Promise<boolean>;
+  /**
+   * The open panel's text, opening it first when it is closed.
+   * @returns The text; throws when the panel cannot open (a disabled trigger).
+   */
+  getPanelText(): Promise<string>;
+  /** The element that carries the ARIA state: the host, or its first control. */
+  private control;
+  /** The open panel, or `null`. */
+  private panel;
+}
+/**
+ * Harness for `bf-combobox` and `bf-multi-combobox`. Its option list renders in the CDK overlay
+ * container while open (found through the input's `aria-controls`); it works by option label, so a
+ * test never needs the option values. Its `label` filter matches the visible label, else the
+ * `aria-label`.
+ *
+ * @example
+ * const assignee = await loader.getHarness(BfComboboxHarness.with({ label: 'Assignee' }));
+ * await assignee.type('gra');
+ * await assignee.selectOption('Grace Hopper');
+ * expect(await assignee.getValueText()).toBe('Grace Hopper');
+ * @summary Test harness for the comboboxes: types, reads and picks options and tags
+ * @since 0.3.1
+ */
+export declare class BfComboboxHarness extends ComponentHarness {
+  /** The host element's selector: either combobox. */
+  static hostSelector: string;
+  private readonly input;
+  private readonly label;
+  private readonly chips;
+  private readonly removeButtons;
+  /**
+   * A predicate for a combobox with the given label.
+   * @param filters The label (text or pattern) and the CDK's selector and ancestor filters.
+   * @returns The predicate for `getHarness()` and friends.
+   */
+  static with(filters?: BfHarnessFilters): HarnessPredicate<BfComboboxHarness>;
+  /**
+   * The visible label without the required mark, else the `aria-label`.
+   * @returns The label text.
+   */
+  getLabel(): Promise<string>;
+  /** Opens the option list with a click into the field; does nothing while it is open. */
+  open(): Promise<void>;
+  /** Closes the option list with `Escape`, as a user would; does nothing while it is closed. */
+  close(): Promise<void>;
+  /**
+   * Whether the option list is open (`aria-expanded`).
+   * @returns True while open.
+   */
+  isOpen(): Promise<boolean>;
+  /**
+   * Replaces the field's text with `query`, key by key as a user types; the list opens filtered.
+   * @param query The text to type.
+   */
+  type(query: string): Promise<void>;
+  /**
+   * The labels of the listed options, in order, opening the list first when it is closed.
+   * @returns The option labels; empty when nothing matches.
+   */
+  getOptionLabels(): Promise<string[]>;
+  /**
+   * Picks the listed option with this label with a click, opening the list first when it is
+   * closed. Throws for an unknown or disabled option.
+   * @param label The option's label.
+   */
+  selectOption(label: string): Promise<void>;
+  /**
+   * The field's text: the picked option's label on a `bf-combobox` (or the text being typed), the
+   * typed text on a `bf-multi-combobox` (its picks are tags, see `getChipLabels()`).
+   * @returns The input's value.
+   */
+  getValueText(): Promise<string>;
+  /**
+   * The labels of a `bf-multi-combobox`'s tags, in order; empty for a `bf-combobox`.
+   * @returns The tag labels.
+   */
+  getChipLabels(): Promise<string[]>;
+  /**
+   * Removes the tag with this label with its remove button. Throws for an unknown tag or one
+   * without a remove button (a disabled or read-only field).
+   * @param label The tag's label.
+   */
+  removeChip(label: string): Promise<void>;
+  /**
+   * Whether the field is disabled.
+   * @returns True when disabled.
+   */
+  isDisabled(): Promise<boolean>;
+  /** Focuses the input. */
+  focus(): Promise<void>;
+  /** Blurs the input, which closes the list and marks a bound form field touched. */
+  blur(): Promise<void>;
+  /** The text of a tag's label. */
+  private chipLabel;
+  /** The listed options and their label elements, from the listbox the input controls. */
+  private options;
+}
+/**
+ * Harness for `bf-date-input`. It reads and types the field as a user sees it (in its locale's
+ * order) and picks a date through the calendar popover with `BfCalendarHarness`.
+ *
+ * @example
+ * const due = await loader.getHarness(BfDateInputHarness.with({ label: 'Due date' }));
+ * await due.setValue('14/10/2026');
+ * await due.pickDate('2026-11-03');
+ * expect(await due.getValue()).toBe('03/11/2026');
+ * @summary Test harness for the date input: types a date or picks one in its calendar
+ * @since 0.3.1
+ */
+export declare class BfDateInputHarness extends ComponentHarness {
+  /** The host element's selector. */
+  static hostSelector: string;
+  private readonly group;
+  private readonly nativeInput;
+  private readonly segments;
+  private readonly label;
+  private readonly trigger;
+  /**
+   * A predicate for a date input with the given label.
+   * @param filters The label (text or pattern) and the CDK's selector and ancestor filters.
+   * @returns The predicate for `getHarness()` and friends.
+   */
+  static with(filters?: BfHarnessFilters): HarnessPredicate<BfDateInputHarness>;
+  /**
+   * The visible label without the required mark, else the field's `aria-label`.
+   * @returns The label text.
+   */
+  getLabel(): Promise<string>;
+  /**
+   * The field's text as the locale shows it ("14/10/2026"); the ISO value in native mode.
+   * @returns The text, `''` while every part is empty.
+   */
+  getValue(): Promise<string>;
+  /**
+   * Types a date as a user would: clears the field, then types each run of digits (or letters)
+   * into the next part in the field's order, such as "14/10/2026" in an en-GB field. In native mode it sets the
+   * platform input to the ISO value.
+   * @param text The date as the field shows it.
+   */
+  setValue(text: string): Promise<void>;
+  /** Clears every part with `Backspace`, as a user would. */
+  clear(): Promise<void>;
+  /**
+   * Whether the field shows its error state (`aria-invalid` on its parts or native input).
+   * @returns True while invalid.
+   */
+  isInvalid(): Promise<boolean>;
+  /**
+   * Whether the field is disabled.
+   * @returns True while disabled.
+   */
+  isDisabled(): Promise<boolean>;
+  /** Opens the calendar popover with a click on its button; throws when the field has none or it is disabled. */
+  openPicker(): Promise<void>;
+  /**
+   * Whether the calendar popover is open (`aria-expanded` on its button).
+   * @returns True while open.
+   */
+  isPickerOpen(): Promise<boolean>;
+  /**
+   * Picks a date in the calendar as a user would: opens the popover (when closed), then picks the
+   * day through the calendar's harness, which closes it.
+   * @param iso The ISO date to pick, such as '2026-11-03'.
+   */
+  pickDate(iso: string): Promise<void>;
+  private elements;
+}
+/**
+ * Harness for `bf-time-input`. It reads and types the field as a user sees it and picks a time
+ * from the popover list.
+ *
+ * @example
+ * const start = await loader.getHarness(BfTimeInputHarness.with({ label: 'Start' }));
+ * await start.setValue('09:30');
+ * await start.pickTime('14:00');
+ * expect(await start.getValue()).toBe('14:00');
+ * @summary Test harness for the time input: types a time or picks one from its list
+ * @since 0.3.1
+ */
+export declare class BfTimeInputHarness extends ComponentHarness {
+  /** The host element's selector. */
+  static hostSelector: string;
+  private readonly group;
+  private readonly nativeInput;
+  private readonly segments;
+  private readonly label;
+  private readonly trigger;
+  /**
+   * A predicate for a time input with the given label.
+   * @param filters The label (text or pattern) and the CDK's selector and ancestor filters.
+   * @returns The predicate for `getHarness()` and friends.
+   */
+  static with(filters?: BfHarnessFilters): HarnessPredicate<BfTimeInputHarness>;
+  /**
+   * The visible label without the required mark, else the field's `aria-label`.
+   * @returns The label text.
+   */
+  getLabel(): Promise<string>;
+  /**
+   * The field's text as the locale shows it ("14:30" or "02:30 PM"); the ISO value in native mode.
+   * @returns The text, `''` while every part is empty.
+   */
+  getValue(): Promise<string>;
+  /**
+   * Types a time as a user would: clears the field, then types each run of digits (or letters)
+   * into the next part in the field's order, such as "2:30 PM" in a 12-hour field. In native mode it sets the
+   * platform input to the ISO value.
+   * @param text The time as the field shows it.
+   */
+  setValue(text: string): Promise<void>;
+  /** Clears every part with `Backspace`, as a user would. */
+  clear(): Promise<void>;
+  /**
+   * Whether the field shows its error state (`aria-invalid` on its parts or native input).
+   * @returns True while invalid.
+   */
+  isInvalid(): Promise<boolean>;
+  /**
+   * Whether the field is disabled.
+   * @returns True while disabled.
+   */
+  isDisabled(): Promise<boolean>;
+  /** Opens the list of times with a click on its button; throws when the field has none or it is disabled. */
+  openPicker(): Promise<void>;
+  /**
+   * Whether the list of times is open (`aria-expanded` on its button).
+   * @returns True while open.
+   */
+  isPickerOpen(): Promise<boolean>;
+  /**
+   * Picks a time in the list as a user would: opens the list (when closed), then clicks the
+   * time, which closes it. Throws for a time the list does not hold (off the `step`) or disables.
+   * @param time The ISO time to pick, such as '14:30'.
+   */
+  pickTime(time: string): Promise<void>;
+  private elements;
+}
+/**
+ * Harness for `bf-datetime-input`. It reads and types the field as a user sees it and picks the
+ * date in the popover's calendar and the time in its list.
+ *
+ * @example
+ * const meeting = await loader.getHarness(BfDateTimeInputHarness.with({ label: 'Meeting' }));
+ * await meeting.pickDate('2026-10-14');
+ * await meeting.pickTime('09:30');
+ * expect(await meeting.getValue()).toBe('14/10/2026, 09:30');
+ * @summary Test harness for the date and time input: types or picks a date and time
+ * @since 0.3.1
+ */
+export declare class BfDateTimeInputHarness extends ComponentHarness {
+  /** The host element's selector. */
+  static hostSelector: string;
+  private readonly group;
+  private readonly nativeInput;
+  private readonly segments;
+  private readonly label;
+  private readonly trigger;
+  /**
+   * A predicate for a date and time input with the given label.
+   * @param filters The label (text or pattern) and the CDK's selector and ancestor filters.
+   * @returns The predicate for `getHarness()` and friends.
+   */
+  static with(filters?: BfHarnessFilters): HarnessPredicate<BfDateTimeInputHarness>;
+  /**
+   * The visible label without the required mark, else the field's `aria-label`.
+   * @returns The label text.
+   */
+  getLabel(): Promise<string>;
+  /**
+   * The field's text as the locale shows it ("14/10/2026, 09:30"); the ISO value in native mode.
+   * @returns The text, `''` while every part is empty.
+   */
+  getValue(): Promise<string>;
+  /**
+   * Types a date and time as a user would: clears the field, then types each run of digits (or letters)
+   * into the next part in the field's order, such as "14/10/2026, 09:30" in an en-GB field. In native mode it sets the
+   * platform input to the ISO value.
+   * @param text The date and time as the field shows it.
+   */
+  setValue(text: string): Promise<void>;
+  /** Clears every part with `Backspace`, as a user would. */
+  clear(): Promise<void>;
+  /**
+   * Whether the field shows its error state (`aria-invalid` on its parts or native input).
+   * @returns True while invalid.
+   */
+  isInvalid(): Promise<boolean>;
+  /**
+   * Whether the field is disabled.
+   * @returns True while disabled.
+   */
+  isDisabled(): Promise<boolean>;
+  /** Opens the popover with a click on its button; throws when the field has none or it is disabled. */
+  openPicker(): Promise<void>;
+  /**
+   * Whether the popover is open (`aria-expanded` on its button).
+   * @returns True while open.
+   */
+  isPickerOpen(): Promise<boolean>;
+  /**
+   * Picks a date in the calendar as a user would: opens the popover (when closed), then picks the
+   * day through the calendar's harness. The popover stays open, with focus on its time list.
+   * @param iso The ISO date to pick, such as '2026-11-03'.
+   */
+  pickDate(iso: string): Promise<void>;
+  /**
+   * Picks a time in the list as a user would: opens the popover (when closed), then clicks the
+   * time, which closes it. Throws for a time the list does not hold (off the `step`) or disables.
+   * @param time The ISO time to pick, such as '14:30'.
+   */
+  pickTime(time: string): Promise<void>;
+  private elements;
+}
+/**
+ * Harness for the `@bitforgehq/ui/charts` charts (`bf-line-chart`, `bf-bar-chart`,
+ * `bf-donut-chart`). It works through what a user sees: the legend's series names, its toggle
+ * buttons and the Show data table, so a test never reads the SVG.
+ *
+ * @example
+ * const chart = await loader.getHarness(BfChartHarness.with({ label: 'Revenue' }));
+ * await chart.toggleSeries('Store');
+ * expect(await chart.showData()).toContainEqual(['Mar', '15', '11']);
+ * @summary Test harness for the charts: reads the series, toggles one and reads the data table
+ * @since 0.3.1
+ */
+export declare class BfChartHarness extends ComponentHarness {
+  /** The host element's selector. */
+  static hostSelector: string;
+  private readonly figure;
+  private readonly legendButtons;
+  private readonly dataToggle;
+  private readonly headCells;
+  private readonly bodyCells;
+  /**
+   * A predicate for a chart with the given label.
+   * @param filters The label (text or pattern) and the CDK's selector and ancestor filters.
+   * @returns The predicate for `getHarness()` and friends.
+   */
+  static with(filters?: BfHarnessFilters): HarnessPredicate<BfChartHarness>;
+  /**
+   * The figure's accessible name (`label`, else the chart card's title, else the `chart` label).
+   * @returns The label text.
+   */
+  getLabel(): Promise<string>;
+  /**
+   * The series (or slice) names in the legend, in order; empty for a chart of one series, which
+   * draws no legend.
+   * @returns The names.
+   */
+  getSeriesNames(): Promise<string[]>;
+  /**
+   * Whether the legend shows the series (or slice) with this name.
+   * @param name The series name.
+   * @returns `true` while it is drawn.
+   */
+  isSeriesShown(name: string): Promise<boolean>;
+  /**
+   * Clicks the legend button of the series (or slice) with this name, as a user would, to hide
+   * or show it. Throws for an unknown name.
+   * @param name The series name.
+   */
+  toggleSeries(name: string): Promise<void>;
+  /**
+   * Opens the Show data table (if it is closed) and reads it.
+   * @returns One array per category (or slice): its name, then its formatted values.
+   */
+  showData(): Promise<string[][]>;
+  private legendButton;
+}
 export type { BfHarnessFilters, BfJsdomShimOptions, BfTestingOptions };