@theseam/ui-common 1.0.2-beta.79 → 1.0.2-beta.84

package/ai/index.d.ts

@@ -1,36 +1,103 @@
 import * as i0 from '@angular/core';
 import { AfterViewInit, InjectionToken, Type } from '@angular/core';
+import { TheSeamDatatableColumn, DatatableComponent, ColumnsAlterationState } from '@theseam/ui-common/datatable';
+import { DatatableGraphQLQueryRef } from '@theseam/ui-common/graphql';
 import { BehaviorSubject, Observable } from 'rxjs';
 import * as _angular_cdk_testing from '@angular/cdk/testing';
 import { ComponentHarness } from '@angular/cdk/testing';
 import { FormGroup, FormControl } from '@angular/forms';
-import { DatatableComponent, ColumnsAlterationState } from '@theseam/ui-common/datatable';
 import { AlterationDisplayItem } from '@theseam/ui-common/datatable-alterations-display';
 
+/**
+ * Implemented by components that contribute "what the user is currently looking at"
+ * to the AI chat assistant. Instances are registered with `TheSeamChatContextRegistry`
+ * (see chat-context-registry.service.ts) and read at chat-send time.
+ *
+ * `getContext()` returning null/undefined means "I have nothing useful to contribute
+ * right now"; the registry drops that entry from the snapshot.
+ */
+interface TheSeamChatContext {
+    /** Discriminator — used by the backend formatter table. e.g. 'datatable', 'modal'. */
+    readonly type: string;
+    /** When true, this context is included even while a 'modal'-typed context is registered. Default false. */
+    readonly alwaysVisible?: boolean;
+    getContext(): unknown | Promise<unknown>;
+}
+/** Wire-shape of one context entry sent to the backend. */
+interface TheSeamChatContextPayload {
+    type: string;
+    data: unknown;
+}
+
 interface ChatMessage {
-    role: 'system' | 'user' | 'assistant';
+    role: 'user' | 'assistant';
     content: string;
 }
 interface ChatResponse {
     content: string;
 }
-interface AiProvider {
-    chat(messages: ChatMessage[]): Promise<ChatResponse>;
+interface TheSeamAiChatRequest {
+    messages: ChatMessage[];
+    contexts?: TheSeamChatContextPayload[];
+}
+interface TheSeamAiProvider {
+    chat(request: TheSeamAiChatRequest): Promise<ChatResponse>;
 }
 
-declare class LmStudioAiProvider implements AiProvider {
-    chat(messages: ChatMessage[]): Promise<ChatResponse>;
+declare class LmStudioAiProvider implements TheSeamAiProvider {
+    chat(request: TheSeamAiChatRequest): Promise<ChatResponse>;
 }
 
-declare class OpenRouterAiProvider implements AiProvider {
-    chat(messages: ChatMessage[]): Promise<ChatResponse>;
+declare class OpenRouterAiProvider implements TheSeamAiProvider {
+    chat(request: TheSeamAiChatRequest): Promise<ChatResponse>;
 }
 
 type MockResponse = string | ((messages: ChatMessage[]) => string);
-declare class MockAiProvider implements AiProvider {
+declare class MockAiProvider implements TheSeamAiProvider {
     private readonly _response;
     constructor(_response?: MockResponse);
-    chat(messages: ChatMessage[]): Promise<ChatResponse>;
+    chat(request: TheSeamAiChatRequest): Promise<ChatResponse>;
+}
+
+declare class TheSeamChatContextRegistry {
+    private readonly _contexts;
+    /**
+     * Register a context. Returns an unregister function — pair it with DestroyRef:
+     *   inject(DestroyRef).onDestroy(registry.register(ctx))
+     */
+    register(ctx: TheSeamChatContext): () => void;
+    unregister(ctx: TheSeamChatContext): void;
+    /**
+     * Resolve registered contexts to a wire-ready payload list. Applies the modal-mask
+     * rule (a `modal`-typed context hides others unless they set `alwaysVisible`) and
+     * drops entries whose `getContext()` returns null/undefined.
+     */
+    snapshot(): Promise<TheSeamChatContextPayload[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TheSeamChatContextRegistry, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<TheSeamChatContextRegistry>;
+}
+
+interface TheSeamDatatableChatContextOptions {
+    /** Optional human label, e.g. 'Bales'. Helps the LLM disambiguate when multiple datatables are registered. */
+    label?: string;
+}
+interface TheSeamDatatableChatContextData {
+    label?: string;
+    operationName: string;
+    query: string;
+    variables: Record<string, unknown>;
+    columns: {
+        prop: string | number | undefined;
+        name: string | undefined;
+    }[];
+}
+declare class TheSeamDatatableChatContext implements TheSeamChatContext {
+    private readonly _queryRef;
+    private readonly _columns;
+    private readonly _options;
+    readonly type = "datatable";
+    constructor(_queryRef: DatatableGraphQLQueryRef<any, any, any>, _columns: readonly TheSeamDatatableColumn[], _options?: TheSeamDatatableChatContextOptions);
+    getContext(): TheSeamDatatableChatContextData | null;
 }
 
 type ChatContentSegment = {
@@ -56,9 +123,9 @@ interface ChatMessageDisplayModel {
 
 declare class TheSeamChatComponent implements AfterViewInit {
     private readonly _provider;
+    private readonly _chatContextRegistry;
     private readonly _cdr;
     private readonly _ngZone;
-    systemPrompt: string;
     placeholder: string;
     private _messageList?;
     private _messageListScrollbar?;
@@ -74,10 +141,10 @@ declare class TheSeamChatComponent implements AfterViewInit {
     private _maybeScrollToBottom;
     private _scrollToBottom;
     static ɵfac: i0.ɵɵFactoryDeclaration<TheSeamChatComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TheSeamChatComponent, "seam-chat", never, { "systemPrompt": { "alias": "systemPrompt"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TheSeamChatComponent, "seam-chat", never, { "placeholder": { "alias": "placeholder"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-declare const THESEAM_CHAT_PROVIDER: InjectionToken<AiProvider>;
+declare const THESEAM_CHAT_PROVIDER: InjectionToken<TheSeamAiProvider>;
 
 type ChatBlockRegistry = Map<string, Type<unknown>>;
 declare const THESEAM_CHAT_BLOCK_REGISTRY: InjectionToken<ChatBlockRegistry>;
@@ -109,7 +176,7 @@ declare const getUserPrompt: (columns: any[], request: string) => string;
 declare function parseResponse(responseContent: string, responseFormat: {
     type: string;
 } | undefined): any;
-declare const THESEAM_DATATABLE_PROMPTER_PROVIDER: InjectionToken<AiProvider>;
+declare const THESEAM_DATATABLE_PROMPTER_PROVIDER: InjectionToken<TheSeamAiProvider>;
 
 declare class TheSeamDatatablePrompterComponent {
     private readonly _prefsAccessor;
@@ -140,5 +207,5 @@ declare class TheSeamDatatablePrompterComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<TheSeamDatatablePrompterComponent, "seam-datatable-prompter", never, { "diffMode": { "alias": "diffMode"; "required": false; }; "compact": { "alias": "compact"; "required": false; }; "prompt": { "alias": "prompt"; "required": false; }; "datatable": { "alias": "datatable"; "required": false; }; "showAlts": { "alias": "showAlts"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-export { LmStudioAiProvider, MockAiProvider, OpenRouterAiProvider, THESEAM_CHAT_BLOCK_REGISTRY, THESEAM_CHAT_PROVIDER, THESEAM_DATATABLE_PROMPTER_PROVIDER, TheSeamChatComponent, TheSeamChatHarness, TheSeamDatatablePrompterComponent, assistantPrompt, getUserPrompt, parseChatResponse, parseResponse };
-export type { AiProvider, ChatBlockRegistry, ChatContentSegment, ChatMessage, ChatResponse };
+export { LmStudioAiProvider, MockAiProvider, OpenRouterAiProvider, THESEAM_CHAT_BLOCK_REGISTRY, THESEAM_CHAT_PROVIDER, THESEAM_DATATABLE_PROMPTER_PROVIDER, TheSeamChatComponent, TheSeamChatContextRegistry, TheSeamChatHarness, TheSeamDatatableChatContext, TheSeamDatatablePrompterComponent, assistantPrompt, getUserPrompt, parseChatResponse, parseResponse };
+export type { ChatBlockRegistry, ChatContentSegment, ChatMessage, ChatResponse, TheSeamAiChatRequest, TheSeamAiProvider, TheSeamChatContext, TheSeamChatContextPayload, TheSeamDatatableChatContextData, TheSeamDatatableChatContextOptions };

package/carousel/index.d.ts

@@ -3,6 +3,8 @@ import { OnInit, OnDestroy, QueryList } from '@angular/core';
 import * as _fortawesome_fontawesome_common_types from '@fortawesome/fontawesome-common-types';
 import { NumberInput, BooleanInput } from '@angular/cdk/coercion';
 import { Observable } from 'rxjs';
+import * as _angular_cdk_testing from '@angular/cdk/testing';
+import { ComponentHarness } from '@angular/cdk/testing';
 
 declare class TheSeamCarouselSlideDirective {
     private readonly template;
@@ -97,4 +99,22 @@ declare class TheSeamCarouselModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<TheSeamCarouselModule>;
 }
 
-export { TheSeamCarouselComponent, TheSeamCarouselModule, TheSeamCarouselSlideDirective };
+declare class TheSeamCarouselHarness extends ComponentHarness {
+    static hostSelector: string;
+    _content: () => Promise<_angular_cdk_testing.TestElement>;
+    _prevSlideButton: () => Promise<_angular_cdk_testing.TestElement | null>;
+    _nextSlideButton: () => Promise<_angular_cdk_testing.TestElement | null>;
+    _playButton: () => Promise<_angular_cdk_testing.TestElement | null>;
+    _pauseButton: () => Promise<_angular_cdk_testing.TestElement | null>;
+    activeTileIndex(): Promise<string | null>;
+    goToPreviousSlide(): Promise<void>;
+    goToNextSlide(): Promise<void>;
+    goToSlide(index: number): Promise<void>;
+    hasPreviousSlideButton(): Promise<boolean>;
+    hasNextSlideButton(): Promise<boolean>;
+    hasSlideButton(index: number): Promise<boolean>;
+    hasSlideButtons(): Promise<boolean>;
+    hasAutoPlayToggleButton(): Promise<boolean>;
+}
+
+export { TheSeamCarouselComponent, TheSeamCarouselHarness, TheSeamCarouselModule, TheSeamCarouselSlideDirective };

package/datatable/index.d.ts

@@ -18,7 +18,7 @@ import { Router } from '@angular/router';
 import * as i38 from '@theseam/ui-common/confirm-dialog';
 import { SeamConfirmDialogService } from '@theseam/ui-common/confirm-dialog';
 import * as i32 from '@theseam/ui-common/menu';
-import { MenuComponent } from '@theseam/ui-common/menu';
+import { MenuComponent, TheSeamMenuItemHarnessFilters, TheSeamMenuItemHarness } from '@theseam/ui-common/menu';
 import { ThemeTypes } from '@theseam/ui-common/models';
 import * as i43 from '@theseam/ui-common/table-cell-type';
 import { TableCellTypeName, TableCellTypeConfig, TableCellTypeColumn, TableCellTypeExportProps, TheSeamTableCellTypeColumnAlign } from '@theseam/ui-common/table-cell-type';
@@ -45,9 +45,13 @@ import * as i33 from '@theseam/ui-common/buttons';
 import * as i37 from '@angular/cdk/portal';
 import * as i39 from '@theseam/ui-common/popover';
 import * as i40 from '@theseam/ui-common/checkbox';
+import { TheSeamCheckboxHarness } from '@theseam/ui-common/checkbox';
 import * as i41 from '@theseam/ui-common/form-field';
 import * as i45 from '@ng-select/ng-select';
 import * as i46 from '@theseam/ui-common/toggle-group';
+import * as _angular_cdk_testing from '@angular/cdk/testing';
+import { BaseHarnessFilters, ComponentHarness, ComponentHarnessConstructor, HarnessPredicate, ContentContainerComponentHarness } from '@angular/cdk/testing';
+import { TheSeamNgSelectHarness } from '@theseam/ui-common/testing';
 
 declare class DatatableActionMenuItemComponent {
     label: string | undefined | null;
@@ -1391,5 +1395,297 @@ declare class TheSeamDatatableModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<TheSeamDatatableModule>;
 }
 
-export { CURRENT_DATATABLE_PREFERENCES_VERSION, ColumnsAlteration, ColumnsDataFilter, ColumnsFiltersService, DatatableActionMenuComponent, DatatableActionMenuItemComponent, DatatableActionMenuItemDirective, DatatableActionMenuToggleDirective, DatatableCellTplDirective, DatatableColumnChangesService, DatatableColumnComponent, DatatableColumnFilterMenuComponent, DatatableColumnFilterSearchDateComponent, DatatableColumnFilterSearchNumericComponent, DatatableColumnFilterSearchTextComponent, DatatableColumnFilterTplDirective, DatatableColumnPreferencesButtonComponent, DatatableColumnPreferencesComponent, DatatableComponent, DatatableDataSource, DatatableExportButtonComponent, DatatableFilterDirective, DatatableFooterTplDirective, DatatableGqlDataSource, DatatableMenuBarColumnCenterComponent, DatatableMenuBarColumnLeftComponent, DatatableMenuBarColumnRightComponent, DatatableMenuBarComponent, DatatableMenuBarRowComponent, DatatableMenuBarTextComponent, DatatablePreferencesService, DatatableRefreshButtonComponent, DatatableRefreshService, DatatableRowActionItemDirective, DatatableRowDetailTplDirective, EMPTY_DATATABLE_PREFERENCES, SearchDateColumnsDataFilter, SearchNumericColumnsDataFilter, SearchTextColumnsDataFilter, THESEAM_COLUMNS_DATA_FILTER, THESEAM_COLUMNS_DATA_FILTERS_DEFAULT, THESEAM_COLUMNS_DATA_FILTER_DATE_RANGE_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_DATE_SEARCH_NAME, THESEAM_COLUMNS_DATA_FILTER_DATE_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_DATE_SELECT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_DATE_TEXT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_RANGE_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_SEARCH_NAME, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_SELECT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_TEXT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_TEXT_SEARCH_NAME, THESEAM_COLUMNS_DATA_FILTER_TEXT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_TEXT_SELECT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_TEXT_TEXT_SEARCH_TYPES, THESEAM_DATATABLE, THESEAM_DATATABLE_CONFIG, THESEAM_DATATABLE_PREFERENCES_ACCESSOR, THESEAM_MENUBAR_ITEM_DATA, TheSeamDatatableColumnFilterDirective, TheSeamDatatableFooterDirective, TheSeamDatatableModule, TheSeamDatatableRowDetailDirective, TheSeamDatatableScrollbarHelperService, _THESEAM_DATATABLE, _THESEAM_DATATABLE_ACCESSOR, _THESEAM_DATA_FILTER_CONTAINER, getFormattedDateForComparison, isColumnBoundToProp, mapColumnsAlterationsStates, withStoredColumnInfo };
-export type { ColumnsAlterationState, ColumnsDataFilterState, ColumnsDataFilterStateState, ICellContext, IDatatableExportButtonData, MenubarItemData, SortEvent, SortItem, TheSeamColumnsDataFilterDateSearchDateType, TheSeamColumnsDataFilterDateSearchForm, TheSeamColumnsDataFilterDateSearchFormState, TheSeamColumnsDataFilterDateSearchOptions, TheSeamColumnsDataFilterDateSearchType, TheSeamColumnsDataFilterNumericSearchForm, TheSeamColumnsDataFilterNumericSearchFormState, TheSeamColumnsDataFilterNumericSearchType, TheSeamColumnsDataFilterTextSearchForm, TheSeamColumnsDataFilterTextSearchFormState, TheSeamColumnsDataFilterTextSearchType, TheSeamDatatableAccessor, TheSeamDatatableColumn, TheSeamDatatableColumnFilterUpdateMethod, TheSeamDatatableColumnFilterable, TheSeamDatatableColumnFilterableConfig, TheSeamDatatableColumnHidable, TheSeamDatatableConfig, TheSeamDatatableDateColumnFilterableConfig, TheSeamDatatableMessages, TheSeamDatatablePreferences, TheSeamDatatablePreferencesAccessor, TheSeamDatatablePreferencesColumn, TheSeamDatatablePreferences_v1, TheSeamDatatablePreferences_v2, TheSeamDatatableRow, TheSeamPageInfo };
+declare const SIMPLE_COLUMNS: TheSeamDatatableColumn[];
+declare const SIMPLE_ROWS: {
+    name: string;
+    age: number;
+    color: string;
+}[];
+declare const FILTERABLE_COLUMNS: TheSeamDatatableColumn[];
+declare const FILTERABLE_ROWS: ({
+    name: string;
+    age: any;
+    color: string;
+    candy: string;
+    candyAttributes: string[];
+    startDate: string;
+} | {
+    name: string;
+    age: null;
+    color: null;
+    candy: null;
+    candyAttributes: undefined;
+    startDate: null;
+})[];
+declare function createRows(count: number): {
+    name: string;
+    age: number;
+    color: string;
+}[];
+
+type TheSeamDatatableActionMenuHarnessFilters = BaseHarnessFilters;
+declare class TheSeamDatatableActionMenuHarness extends ComponentHarness {
+    static hostSelector: string;
+    static with<T extends TheSeamDatatableActionMenuHarness>(this: ComponentHarnessConstructor<T>, options?: TheSeamDatatableActionMenuHarnessFilters): HarnessPredicate<T>;
+    private _getMenuHarness;
+    /** Whether the action menu is open. */
+    isOpen(): Promise<boolean>;
+    /** Opens the action menu. */
+    open(): Promise<void>;
+    /** Closes the action menu. */
+    close(): Promise<void>;
+    /**
+     * Gets the menu items in the action menu.
+     * The menu must be opened first (call `open()`) or use `clickItem()` which opens automatically.
+     */
+    getItems(filters?: Omit<TheSeamMenuItemHarnessFilters, 'ancestor'>): Promise<TheSeamMenuItemHarness[]>;
+    /**
+     * Opens the menu and clicks an item by text.
+     * Supports sub-menu navigation via additional filter arguments.
+     */
+    clickItem(itemFilter: Omit<TheSeamMenuItemHarnessFilters, 'ancestor'>, ...subItemFilters: Omit<TheSeamMenuItemHarnessFilters, 'ancestor'>[]): Promise<void>;
+}
+
+interface TheSeamDatatableCellHarnessFilters extends BaseHarnessFilters {
+    /** Filters based on the text content of the cell. */
+    text?: string | RegExp;
+}
+declare class TheSeamDatatableCellHarness extends ComponentHarness {
+    static hostSelector: string;
+    static with<T extends TheSeamDatatableCellHarness>(this: ComponentHarnessConstructor<T>, options?: TheSeamDatatableCellHarnessFilters): HarnessPredicate<T>;
+    /** Gets the text content of the cell. */
+    getText(): Promise<string>;
+    /** Clicks the cell. */
+    click(): Promise<void>;
+    /**
+     * Gets a child harness of the given type from within this cell.
+     * Useful for retrieving cell-type harnesses (e.g., currency, date, icon).
+     *
+     * Returns `null` if no matching harness is found.
+     */
+    getCellTypeHarness<T extends ComponentHarness>(harnessType: ComponentHarnessConstructor<T>): Promise<T | null>;
+}
+
+type TheSeamDatatableColumnFilterMenuHarnessFilters = BaseHarnessFilters;
+declare class TheSeamDatatableColumnFilterMenuHarness extends ComponentHarness {
+    static hostSelector: string;
+    static with<T extends TheSeamDatatableColumnFilterMenuHarness>(this: ComponentHarnessConstructor<T>, options?: TheSeamDatatableColumnFilterMenuHarnessFilters): HarnessPredicate<T>;
+    /** Gets the filter type by checking which sub-component is rendered. */
+    getFilterType(): Promise<'search-text' | 'search-numeric' | 'search-date' | 'custom'>;
+    /** Gets the search type ng-select harness. */
+    getSearchTypeSelect(): Promise<TheSeamNgSelectHarness>;
+    /** Gets the current search type value (e.g. "Contains", "Equals", "Between"). */
+    getSearchType(): Promise<string | null>;
+    /**
+     * Selects a search type from the dropdown by its displayed label
+     * (e.g. `'Before'`, `'Contains'`, `'Between'`).
+     *
+     * Note: this matches the visible option text, not the underlying form value
+     * (e.g. pass `'Before'` not `'lt'`).
+     */
+    selectSearchType(label: string | RegExp): Promise<void>;
+    /** Gets the primary search input (formControlName="searchText"). */
+    getSearchInput(): Promise<_angular_cdk_testing.TestElement | null>;
+    /** Gets the range start input (formControlName="fromText"). */
+    getRangeStartInput(): Promise<_angular_cdk_testing.TestElement | null>;
+    /** Gets the range end input (formControlName="toText"). */
+    getRangeEndInput(): Promise<_angular_cdk_testing.TestElement | null>;
+    /**
+     * Sets the primary search value.
+     * Clears any existing value first, then types the new value.
+     */
+    setSearchValue(value: string): Promise<void>;
+    /**
+     * Sets the range values (for "Between" search types on numeric/date filters).
+     */
+    setRangeValues(from: string, to: string): Promise<void>;
+    /** Clicks the "Clear" button to reset the filter. */
+    clear(): Promise<void>;
+    /** Clicks the "Apply" button (only present in submit mode). */
+    apply(): Promise<void>;
+    /** Whether the "Apply" button is present (submit mode). */
+    hasApplyButton(): Promise<boolean>;
+    /** Whether the "Clear" button is disabled (filter is already at default). */
+    isClearDisabled(): Promise<boolean>;
+}
+
+type TheSeamDatatableColumnPreferencesButtonHarnessFilters = BaseHarnessFilters;
+declare class TheSeamDatatableColumnPreferencesButtonHarness extends ComponentHarness {
+    static hostSelector: string;
+    private _documentRootLocator;
+    static with<T extends TheSeamDatatableColumnPreferencesButtonHarness>(this: ComponentHarnessConstructor<T>, options?: TheSeamDatatableColumnPreferencesButtonHarnessFilters): HarnessPredicate<T>;
+    private _getMenuHarness;
+    /** Opens the preferences menu by clicking the button. */
+    open(): Promise<void>;
+    /** Closes the preferences menu. */
+    close(): Promise<void>;
+    /** Whether the preferences menu is open. */
+    isOpen(): Promise<boolean>;
+    /**
+     * Opens the "Show/Hide Columns" popover and returns the checkbox harnesses
+     * for each column. The checkboxes are rendered inside a CDK overlay popover.
+     */
+    getColumnCheckboxes(): Promise<TheSeamCheckboxHarness[]>;
+    /**
+     * Toggles a column's visibility by name.
+     * Opens the Show/Hide Columns popover and clicks the matching checkbox.
+     */
+    toggleColumn(name: string | RegExp): Promise<void>;
+    /** Clicks the "Reset Columns" menu item. */
+    resetColumns(): Promise<void>;
+}
+
+type TheSeamDatatableExportButtonHarnessFilters = BaseHarnessFilters;
+declare class TheSeamDatatableExportButtonHarness extends ComponentHarness {
+    static hostSelector: string;
+    static with<T extends TheSeamDatatableExportButtonHarness>(this: ComponentHarnessConstructor<T>, options?: TheSeamDatatableExportButtonHarnessFilters): HarnessPredicate<T>;
+    private _getMenuHarness;
+    /** Opens the export menu. */
+    open(): Promise<void>;
+    /** Closes the export menu. */
+    close(): Promise<void>;
+    /** Whether the export menu is open. */
+    isOpen(): Promise<boolean>;
+    /** Whether the export button is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Gets the exporter menu items. The menu must be opened first or use `clickExporter()`. */
+    getExporters(filters?: Omit<TheSeamMenuItemHarnessFilters, 'ancestor'>): Promise<TheSeamMenuItemHarness[]>;
+    /** Opens the menu and clicks an exporter by label. */
+    clickExporter(label: string | RegExp): Promise<void>;
+}
+
+type SortDirection = 'asc' | 'desc' | 'none';
+interface TheSeamDatatableHeaderCellHarnessFilters extends BaseHarnessFilters {
+    /** Filters based on the column name text. */
+    name?: string | RegExp;
+    /** Filters based on the sort direction. */
+    sortDirection?: SortDirection;
+}
+declare class TheSeamDatatableHeaderCellHarness extends ComponentHarness {
+    static hostSelector: string;
+    static with<T extends TheSeamDatatableHeaderCellHarness>(this: ComponentHarnessConstructor<T>, options?: TheSeamDatatableHeaderCellHarnessFilters): HarnessPredicate<T>;
+    /** Gets the column name text. */
+    getName(): Promise<string>;
+    /** Gets the current sort direction of this column. */
+    getSortDirection(): Promise<SortDirection>;
+    /** Whether this column is sortable. */
+    isSortable(): Promise<boolean>;
+    /** Clicks the sort button to cycle the sort direction. */
+    sort(): Promise<void>;
+    /** Whether this column has a filter button. */
+    isFilterable(): Promise<boolean>;
+    /** Whether the column filter is currently active. */
+    isFilterActive(): Promise<boolean>;
+    /** Opens the column filter menu by clicking the filter button. */
+    openFilter(): Promise<void>;
+    /**
+     * Opens the filter and returns the filter menu harness.
+     * The filter menu renders in a CDK overlay, so this uses the document root locator.
+     */
+    getFilterMenu(): Promise<TheSeamDatatableColumnFilterMenuHarness>;
+    /** Whether this header cell is a checkbox column (select-all). */
+    isCheckboxColumn(): Promise<boolean>;
+    /** Clicks the select-all checkbox in this header cell. */
+    clickCheckbox(): Promise<void>;
+}
+
+type TheSeamDatatableMenuBarHarnessFilters = BaseHarnessFilters;
+declare class TheSeamDatatableMenuBarHarness extends ContentContainerComponentHarness<string> {
+    static hostSelector: string;
+    static with<T extends TheSeamDatatableMenuBarHarness>(this: ComponentHarnessConstructor<T>, options?: TheSeamDatatableMenuBarHarnessFilters): HarnessPredicate<T>;
+    /** Gets the text content of the menu bar. */
+    getTextContent(): Promise<string>;
+}
+
+interface TheSeamDatatablePagerButtonHarnessFilters extends BaseHarnessFilters {
+    /** Filters based on the page number of the button. */
+    pageNumber?: number | string | RegExp | null;
+}
+declare class TheSeamDatatablePagerButtonHarness extends ComponentHarness {
+    static hostSelector: string;
+    /** Creates a `HarnessPredicate` used to locate a particular `MyMenuHarness`. */
+    static with(options: TheSeamDatatablePagerButtonHarnessFilters): HarnessPredicate<TheSeamDatatablePagerButtonHarness>;
+    getLabel(): Promise<string | null>;
+    getAnchor(): Promise<_angular_cdk_testing.TestElement>;
+}
+
+declare class TheSeamDatatablePagerHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly _activePageButton;
+    getPageButtonHarness(pageNumber: number): Promise<TheSeamDatatablePagerButtonHarness>;
+    getCurrentPageNumber(): Promise<number>;
+}
+
+interface TheSeamDatatableRowHarnessFilters extends BaseHarnessFilters {
+    /** Filters based on whether the row is selected. */
+    selected?: boolean;
+}
+declare class TheSeamDatatableRowHarness extends ComponentHarness {
+    static hostSelector: string;
+    static with<T extends TheSeamDatatableRowHarness>(this: ComponentHarnessConstructor<T>, options?: TheSeamDatatableRowHarnessFilters): HarnessPredicate<T>;
+    /** Gets all cells in this row, optionally filtered. */
+    getCells(filters?: TheSeamDatatableCellHarnessFilters): Promise<TheSeamDatatableCellHarness[]>;
+    /** Gets a cell by its index in the row. */
+    getCell(index: number): Promise<TheSeamDatatableCellHarness>;
+    /** Convenience method to get the text content of a cell by index. */
+    getCellText(index: number): Promise<string>;
+    /** Whether this row is selected. */
+    isSelected(): Promise<boolean>;
+    /** Clicks the row to activate it. */
+    click(): Promise<void>;
+    /** Gets the action menu harness for this row, or `null` if no action menu exists. */
+    getActionMenu(): Promise<TheSeamDatatableActionMenuHarness | null>;
+    /** Whether this row's detail section is expanded. */
+    isExpanded(): Promise<boolean>;
+    /** Gets the row detail content element, or `null` if not expanded. */
+    getDetailContent(): Promise<_angular_cdk_testing.TestElement | null>;
+    /** Whether this row has a selection checkbox. */
+    hasCheckbox(): Promise<boolean>;
+    /** Clicks the selection checkbox on this row. */
+    clickCheckbox(): Promise<void>;
+}
+
+type TheSeamDatatableHarnessFilters = BaseHarnessFilters;
+declare class TheSeamDatatableHarness extends ComponentHarness {
+    static hostSelector: string;
+    static with<T extends TheSeamDatatableHarness>(this: ComponentHarnessConstructor<T>, options?: TheSeamDatatableHarnessFilters): HarnessPredicate<T>;
+    private readonly _pager;
+    getCurrentPage(): Promise<number>;
+    getPager(): Promise<TheSeamDatatablePagerHarness | null>;
+    /** Gets all visible body rows, optionally filtered. */
+    getRows(filters?: TheSeamDatatableRowHarnessFilters): Promise<TheSeamDatatableRowHarness[]>;
+    /** Gets a body row by its index. */
+    getRow(index: number): Promise<TheSeamDatatableRowHarness>;
+    /** Gets the number of visible body rows. */
+    getRowCount(): Promise<number>;
+    /** Gets all header cells, optionally filtered. */
+    getHeaderCells(filters?: TheSeamDatatableHeaderCellHarnessFilters): Promise<TheSeamDatatableHeaderCellHarness[]>;
+    /** Gets a header cell by column name. */
+    getHeaderCell(name: string | RegExp): Promise<TheSeamDatatableHeaderCellHarness>;
+    /** Gets the number of visible columns. */
+    getColumnCount(): Promise<number>;
+    /** Gets all currently selected rows. */
+    getSelectedRows(): Promise<TheSeamDatatableRowHarness[]>;
+    /** Gets the menu bar harness, or `null` if no menu bar is present. */
+    getMenuBar(): Promise<TheSeamDatatableMenuBarHarness | null>;
+    /** Gets the column preferences button harness, or `null` if not present. */
+    getColumnPreferencesButton(): Promise<TheSeamDatatableColumnPreferencesButtonHarness | null>;
+    /** Gets the text content of a cell by row and column index. */
+    getCellText(rowIndex: number, colIndex: number): Promise<string>;
+    /** Whether the table is showing its empty message (no rows). */
+    isEmpty(): Promise<boolean>;
+}
+
+type TheSeamDatatableRefreshButtonHarnessFilters = BaseHarnessFilters;
+declare class TheSeamDatatableRefreshButtonHarness extends ComponentHarness {
+    static hostSelector: string;
+    static with<T extends TheSeamDatatableRefreshButtonHarness>(this: ComponentHarnessConstructor<T>, options?: TheSeamDatatableRefreshButtonHarnessFilters): HarnessPredicate<T>;
+    private readonly _button;
+    /** Clicks the refresh button. */
+    click(): Promise<void>;
+    /** Whether the underlying button is disabled. */
+    isDisabled(): Promise<boolean>;
+}
+
+export { CURRENT_DATATABLE_PREFERENCES_VERSION, ColumnsAlteration, ColumnsDataFilter, ColumnsFiltersService, DatatableActionMenuComponent, DatatableActionMenuItemComponent, DatatableActionMenuItemDirective, DatatableActionMenuToggleDirective, DatatableCellTplDirective, DatatableColumnChangesService, DatatableColumnComponent, DatatableColumnFilterMenuComponent, DatatableColumnFilterSearchDateComponent, DatatableColumnFilterSearchNumericComponent, DatatableColumnFilterSearchTextComponent, DatatableColumnFilterTplDirective, DatatableColumnPreferencesButtonComponent, DatatableColumnPreferencesComponent, DatatableComponent, DatatableDataSource, DatatableExportButtonComponent, DatatableFilterDirective, DatatableFooterTplDirective, DatatableGqlDataSource, DatatableMenuBarColumnCenterComponent, DatatableMenuBarColumnLeftComponent, DatatableMenuBarColumnRightComponent, DatatableMenuBarComponent, DatatableMenuBarRowComponent, DatatableMenuBarTextComponent, DatatablePreferencesService, DatatableRefreshButtonComponent, DatatableRefreshService, DatatableRowActionItemDirective, DatatableRowDetailTplDirective, EMPTY_DATATABLE_PREFERENCES, FILTERABLE_COLUMNS, FILTERABLE_ROWS, SIMPLE_COLUMNS, SIMPLE_ROWS, SearchDateColumnsDataFilter, SearchNumericColumnsDataFilter, SearchTextColumnsDataFilter, THESEAM_COLUMNS_DATA_FILTER, THESEAM_COLUMNS_DATA_FILTERS_DEFAULT, THESEAM_COLUMNS_DATA_FILTER_DATE_RANGE_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_DATE_SEARCH_NAME, THESEAM_COLUMNS_DATA_FILTER_DATE_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_DATE_SELECT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_DATE_TEXT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_RANGE_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_SEARCH_NAME, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_SELECT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_TEXT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_TEXT_SEARCH_NAME, THESEAM_COLUMNS_DATA_FILTER_TEXT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_TEXT_SELECT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_TEXT_TEXT_SEARCH_TYPES, THESEAM_DATATABLE, THESEAM_DATATABLE_CONFIG, THESEAM_DATATABLE_PREFERENCES_ACCESSOR, THESEAM_MENUBAR_ITEM_DATA, TheSeamDatatableActionMenuHarness, TheSeamDatatableCellHarness, TheSeamDatatableColumnFilterDirective, TheSeamDatatableColumnFilterMenuHarness, TheSeamDatatableColumnPreferencesButtonHarness, TheSeamDatatableExportButtonHarness, TheSeamDatatableFooterDirective, TheSeamDatatableHarness, TheSeamDatatableHeaderCellHarness, TheSeamDatatableMenuBarHarness, TheSeamDatatableModule, TheSeamDatatablePagerButtonHarness, TheSeamDatatablePagerHarness, TheSeamDatatableRefreshButtonHarness, TheSeamDatatableRowDetailDirective, TheSeamDatatableRowHarness, TheSeamDatatableScrollbarHelperService, _THESEAM_DATATABLE, _THESEAM_DATATABLE_ACCESSOR, _THESEAM_DATA_FILTER_CONTAINER, createRows, getFormattedDateForComparison, isColumnBoundToProp, mapColumnsAlterationsStates, withStoredColumnInfo };
+export type { ColumnsAlterationState, ColumnsDataFilterState, ColumnsDataFilterStateState, ICellContext, IDatatableExportButtonData, MenubarItemData, SortDirection, SortEvent, SortItem, TheSeamColumnsDataFilterDateSearchDateType, TheSeamColumnsDataFilterDateSearchForm, TheSeamColumnsDataFilterDateSearchFormState, TheSeamColumnsDataFilterDateSearchOptions, TheSeamColumnsDataFilterDateSearchType, TheSeamColumnsDataFilterNumericSearchForm, TheSeamColumnsDataFilterNumericSearchFormState, TheSeamColumnsDataFilterNumericSearchType, TheSeamColumnsDataFilterTextSearchForm, TheSeamColumnsDataFilterTextSearchFormState, TheSeamColumnsDataFilterTextSearchType, TheSeamDatatableAccessor, TheSeamDatatableActionMenuHarnessFilters, TheSeamDatatableCellHarnessFilters, TheSeamDatatableColumn, TheSeamDatatableColumnFilterMenuHarnessFilters, TheSeamDatatableColumnFilterUpdateMethod, TheSeamDatatableColumnFilterable, TheSeamDatatableColumnFilterableConfig, TheSeamDatatableColumnHidable, TheSeamDatatableColumnPreferencesButtonHarnessFilters, TheSeamDatatableConfig, TheSeamDatatableDateColumnFilterableConfig, TheSeamDatatableExportButtonHarnessFilters, TheSeamDatatableHarnessFilters, TheSeamDatatableHeaderCellHarnessFilters, TheSeamDatatableMenuBarHarnessFilters, TheSeamDatatableMessages, TheSeamDatatablePreferences, TheSeamDatatablePreferencesAccessor, TheSeamDatatablePreferencesColumn, TheSeamDatatablePreferences_v1, TheSeamDatatablePreferences_v2, TheSeamDatatableRefreshButtonHarnessFilters, TheSeamDatatableRow, TheSeamDatatableRowHarnessFilters, TheSeamPageInfo };

package/datatable-alterations-display/index.d.ts

@@ -2,6 +2,7 @@ import * as i0 from '@angular/core';
 import { OnInit, OnDestroy } from '@angular/core';
 import * as _fortawesome_fontawesome_common_types from '@fortawesome/fontawesome-common-types';
 import { TheSeamLayoutService } from '@theseam/ui-common/layout';
+import { ComponentHarness } from '@angular/cdk/testing';
 
 interface AlterationDisplayItem {
     id: string;
@@ -97,5 +98,64 @@ declare class AlterationsDiffComponent implements OnInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<AlterationsDiffComponent, "seam-alterations-diff", never, { "currentItems": { "alias": "currentItems"; "required": false; }; "pendingItems": { "alias": "pendingItems"; "required": false; }; "diffMode": { "alias": "diffMode"; "required": false; }; "initialDiffState": { "alias": "initialDiffState"; "required": false; }; "compact": { "alias": "compact"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-export { AlterationDisplayService, AlterationItemComponent, AlterationsDiffComponent, AlterationsListComponent };
+declare class AlterationItemHarness extends ComponentHarness {
+    static hostSelector: string;
+    private _getCard;
+    private _getTypeBadge;
+    private _getIcon;
+    private _getSummary;
+    private _getDiffState;
+    private _getDetails;
+    getType(): Promise<string>;
+    getTypeDisplayName(): Promise<string>;
+    getSummary(): Promise<string>;
+    getDiffState(): Promise<string | null>;
+    getDetails(): Promise<string[]>;
+    hasDetails(): Promise<boolean>;
+    hasBorderSuccess(): Promise<boolean>;
+    hasBorderDanger(): Promise<boolean>;
+    hasBorderWarning(): Promise<boolean>;
+    getBadgeClass(): Promise<string>;
+    isVisible(): Promise<boolean>;
+}
+
+declare class AlterationsListHarness extends ComponentHarness {
+    static hostSelector: string;
+    private _getTitle;
+    private _getCount;
+    private _getEmptyState;
+    private _getItems;
+    getTitle(): Promise<string | null>;
+    getCount(): Promise<string | null>;
+    hasEmptyState(): Promise<boolean>;
+    getEmptyStateText(): Promise<string | null>;
+    getItems(): Promise<AlterationItemHarness[]>;
+    getItemCount(): Promise<number>;
+    getItemByType(type: string): Promise<AlterationItemHarness | null>;
+    getItemTypes(): Promise<string[]>;
+    hasItems(): Promise<boolean>;
+}
+
+declare class AlterationsDiffHarness extends ComponentHarness {
+    static hostSelector: string;
+    private _getDiffSummary;
+    private _getCurrentList;
+    private _getPendingList;
+    private _getCurrentListMobile;
+    private _getPendingListMobile;
+    private _getDesktopLayout;
+    private _getMobileLayout;
+    hasDiffSummary(): Promise<boolean>;
+    getDiffSummaryText(): Promise<string | null>;
+    isDesktopLayout(): Promise<boolean>;
+    isMobileLayout(): Promise<boolean>;
+    getCurrentList(): Promise<AlterationsListHarness | null>;
+    getPendingList(): Promise<AlterationsListHarness | null>;
+    getCurrentItemCount(): Promise<number>;
+    getPendingItemCount(): Promise<number>;
+    hasCurrentEmptyState(): Promise<boolean>;
+    hasPendingEmptyState(): Promise<boolean>;
+}
+
+export { AlterationDisplayService, AlterationItemComponent, AlterationItemHarness, AlterationsDiffComponent, AlterationsDiffHarness, AlterationsListComponent, AlterationsListHarness };
 export type { AlterationDiffMode, AlterationDiffState, AlterationDisplayItem, AlterationVisualState };