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

package/file-input/index.d.ts

@@ -4,6 +4,7 @@ import * as _angular_core from '@angular/core';
 import { AfterViewInit } from '@angular/core';
 import * as _fortawesome_fontawesome_common_types from '@fortawesome/fontawesome-common-types';
 import { ControlValueAccessor } from '@angular/forms';
+import { ComponentHarness } from '@angular/cdk/testing';
 
 /** Tagged union describing where a file item's bytes (or asset pointer) live. */
 type SeamFileItemSource = {
@@ -186,5 +187,81 @@ declare class TheSeamFileFieldComponent implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TheSeamFileFieldComponent, "seam-file-field", never, { "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "maxSize": { "alias": "maxSize"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "previewMode": { "alias": "previewMode"; "required": false; "isSignal": true; }; "showTileName": { "alias": "showTileName"; "required": false; "isSignal": true; }; "promptText": { "alias": "promptText"; "required": false; "isSignal": true; }; "promptSuffix": { "alias": "promptSuffix"; "required": false; "isSignal": true; }; "replaceText": { "alias": "replaceText"; "required": false; "isSignal": true; }; "hideErrors": { "alias": "hideErrors"; "required": false; "isSignal": true; }; }, { "rejected": "rejected"; }, never, never, true, never>;
 }
 
-export { TheSeamFileDropZoneDirective, TheSeamFileFieldComponent, TheSeamFileInputComponent, TheSeamFileTileComponent, iconForMime, seamFileItemFromFile, seamFileItemFromUrl, seamFilesFromItems };
+/**
+ * Test harness for an element with `[seamFileDropZone]` attached.
+ *
+ * Usage:
+ * ```ts
+ * const harness = await loader.getHarness(TheSeamFileDropZoneHarness)
+ * await harness.dropFiles([new File(['x'], 'x.txt')])
+ * expect(await harness.isOver()).toBe(false)
+ * ```
+ */
+declare class TheSeamFileDropZoneHarness extends ComponentHarness {
+    static hostSelector: string;
+    isOver(): Promise<boolean>;
+    dropFiles(files: File[]): Promise<void>;
+}
+
+/**
+ * Test harness for `<seam-file-input>`.
+ */
+declare class TheSeamFileInputHarness extends ComponentHarness {
+    static hostSelector: string;
+    private _zone;
+    private _prompt;
+    private _errors;
+    private _native;
+    /** Trimmed prompt text including the bold portion and suffix. */
+    getPromptText(): Promise<string>;
+    /** Component renders `tabindex=-1` on the zone when disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Trimmed error line text, or null when no errors are visible. */
+    getErrorMessage(): Promise<string | null>;
+    /**
+     * Simulates drop of files on the zone. The directive performs validation
+     * and emits `filesAdded` / `rejected` via the component.
+     */
+    dropFiles(files: File[]): Promise<void>;
+}
+
+/**
+ * Test harness for `<seam-file-tile>`.
+ */
+declare class TheSeamFileTileHarness extends ComponentHarness {
+    static hostSelector: string;
+    private _root;
+    private _rowName;
+    private _previewName;
+    private _remove;
+    private _clickableBody;
+    getName(): Promise<string>;
+    getVariant(): Promise<SeamFileTileVariant>;
+    /** True when a consumer has wired `(itemClick)` AND the tile isn't disabled. */
+    isClickable(): Promise<boolean>;
+    click(): Promise<void>;
+    clickRemove(): Promise<void>;
+}
+
+/**
+ * Test harness for `<seam-file-field>`. Delegates to tile/input harnesses
+ * for their respective pieces.
+ */
+declare class TheSeamFileFieldHarness extends ComponentHarness {
+    static hostSelector: string;
+    private _replace;
+    private _allInputs;
+    private _tiles;
+    /**
+     * Returns the visible embedded file-input harness, or null when the field
+     * is in the filled single-mode state (visible input replaced by tile).
+     * In filled single-mode the hidden input still exists but is not returned.
+     */
+    getInputHarness(): Promise<TheSeamFileInputHarness | null>;
+    getTiles(): Promise<TheSeamFileTileHarness[]>;
+    getReplaceButtonText(): Promise<string | null>;
+    clickReplace(): Promise<void>;
+}
+
+export { TheSeamFileDropZoneDirective, TheSeamFileDropZoneHarness, TheSeamFileFieldComponent, TheSeamFileFieldHarness, TheSeamFileInputComponent, TheSeamFileInputHarness, TheSeamFileTileComponent, TheSeamFileTileHarness, iconForMime, seamFileItemFromFile, seamFileItemFromUrl, seamFilesFromItems };
 export type { SeamFileItem, SeamFileItemFromUrlOptions, SeamFileItemSource, SeamFileRejection, SeamFileRejectionReason, SeamFileTileVariant };

package/icon/index.d.ts

@@ -1,11 +1,12 @@
 import * as i0 from '@angular/core';
 import { DoCheck, ElementRef, Renderer2, OnInit } from '@angular/core';
 import { BooleanInput } from '@angular/cdk/coercion';
-import { IconProp, IconDefinition, SizeProp } from '@fortawesome/fontawesome-svg-core';
+import { IconProp, IconDefinition, SizeProp, IconLookup } from '@fortawesome/fontawesome-svg-core';
 import { ThemeTypes } from '@theseam/ui-common/models';
 import * as _angular_animations from '@angular/animations';
 import * as i4 from '@angular/common';
 import * as i5 from '@fortawesome/angular-fontawesome';
+import { BaseHarnessFilters, ContentContainerComponentHarness, ComponentHarnessConstructor, HarnessPredicate } from '@angular/cdk/testing';
 
 type SeamIcon = IconProp | IconDefinition | string;
 
@@ -189,5 +190,34 @@ declare function fileExtensionIcon(extension: string | null | undefined, default
 
 declare function getKnownIcon(iconStr: string): SeamIcon | undefined;
 
-export { DEFAULT_FILE_EXTENSION_ICON, IconBtnComponent, IconComponent, IconNotificationComponent, TheSeamIconModule, fileExtensionIcon, getKnownIcon, pulseAnimation };
-export type { SeamIcon, TheSeamIconType };
+/**
+ * Returns only IconLookup for FontAwesome icons
+ */
+type TestSeamIcon = string | IconLookup;
+declare function toIconLookup(icon: IconDefinition): IconLookup;
+/** A set of criteria that can be used to filter a list of `TheSeamIconComponentHarness` instances. */
+interface TheSeamIconComponentHarnessFilters extends BaseHarnessFilters {
+    /** Only find instances whose text matches the given value. */
+    icon?: string | RegExp | SeamIcon;
+}
+declare class TheSeamIconComponentHarness extends ContentContainerComponentHarness<string> {
+    /** The selector for the host element of a `TheSeamIconComponent` instance. */
+    static hostSelector: string;
+    private readonly _imgElement;
+    private readonly _svgElement;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a menu item with specific attributes.
+     * @param options Options for filtering which menu item instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with<T extends TheSeamIconComponentHarness>(this: ComponentHarnessConstructor<T>, options?: TheSeamIconComponentHarnessFilters): HarnessPredicate<T>;
+    /** Whether the menu is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Get icon image. */
+    getIcon(): Promise<TestSeamIcon | undefined>;
+    /** Get icon type. */
+    getIconType(): Promise<string | undefined>;
+}
+
+export { DEFAULT_FILE_EXTENSION_ICON, IconBtnComponent, IconComponent, IconNotificationComponent, TheSeamIconComponentHarness, TheSeamIconModule, fileExtensionIcon, getKnownIcon, pulseAnimation, toIconLookup };
+export type { SeamIcon, TestSeamIcon, TheSeamIconComponentHarnessFilters, TheSeamIconType };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theseam/ui-common",
-  "version": "1.0.2-beta.83",
+  "version": "1.0.2-beta.84",
   "peerDependencies": {
     "@angular/cdk": "^20.2.3",
     "@angular/common": "^20.3.0",

package/tooltip/index.d.ts

@@ -4,6 +4,7 @@ import { AnimationEvent } from '@angular/animations';
 import { Subject } from 'rxjs';
 import * as i1 from '@angular/common';
 import * as i2 from '@angular/cdk/overlay';
+import { BaseHarnessFilters, ComponentHarness, HarnessPredicate, ElementDimensions } from '@angular/cdk/testing';
 
 type TheSeamTooltipPlacement = 'top' | 'top-left' | 'top-right' | 'bottom' | 'bottom-left' | 'bottom-right' | 'left' | 'left-top' | 'left-bottom' | 'right' | 'right-top' | 'right-bottom' | 'auto';
 declare class TheSeamTooltipComponent implements OnDestroy {
@@ -114,5 +115,42 @@ declare class TheSeamTooltipModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<TheSeamTooltipModule>;
 }
 
-export { TheSeamTooltipComponent, TheSeamTooltipDirective, TheSeamTooltipModule };
-export type { TheSeamTooltipPlacement, TheSeamTooltipPlacementInput, TheSeamTooltipTrigger };
+interface TheSeamTooltipHarnessFilters extends BaseHarnessFilters {
+}
+/**
+ * Harness for interacting with tooltip directives in tests
+ */
+declare class TheSeamTooltipHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a tooltip with specific attributes
+     */
+    static with(options?: TheSeamTooltipHarnessFilters): HarnessPredicate<TheSeamTooltipHarness>;
+    /** Hovers over the element to show the tooltip */
+    hover(): Promise<void>;
+    /** Moves the mouse away from the element to hide the tooltip */
+    mouseAway(): Promise<void>;
+    /** Focuses the element to show the tooltip */
+    focus(): Promise<void>;
+    /** Blurs the element to hide the tooltip */
+    blur(): Promise<void>;
+    /** Clicks the element */
+    click(): Promise<void>;
+    /** Gets whether the tooltip is currently visible */
+    isTooltipVisible(): Promise<boolean>;
+    /** Gets the visible tooltip text content */
+    getVisibleTooltipText(): Promise<string | null>;
+    /** Gets the visible tooltip classes */
+    getVisibleTooltipClasses(): Promise<string[]>;
+    /** Gets the tooltip ID from the aria-describedby attribute */
+    private _getTooltipId;
+    /** Waits for the tooltip to appear */
+    waitForTooltipToShow(timeout?: number): Promise<void>;
+    /** Waits for the tooltip to disappear */
+    waitForTooltipToHide(timeout?: number): Promise<void>;
+    getTriggerDimensions(): Promise<ElementDimensions | null>;
+    getTooltipDimensions(): Promise<ElementDimensions | null>;
+}
+
+export { TheSeamTooltipComponent, TheSeamTooltipDirective, TheSeamTooltipHarness, TheSeamTooltipModule };
+export type { TheSeamTooltipHarnessFilters, TheSeamTooltipPlacement, TheSeamTooltipPlacementInput, TheSeamTooltipTrigger };

package/widget/index.d.ts

@@ -22,6 +22,7 @@ import * as i7 from '@fortawesome/angular-fontawesome';
 import * as i9 from '@theseam/ui-common/loading';
 import * as i12 from '@angular/cdk/table';
 import * as i24 from '@angular/router';
+import { BaseHarnessFilters, ContentContainerComponentHarness, ComponentHarnessConstructor, HarnessPredicate } from '@angular/cdk/testing';
 
 type Writeable<T> = {
     -readonly [P in keyof T]-?: T[P];
@@ -531,5 +532,19 @@ declare class TheSeamWidgetModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<TheSeamWidgetModule>;
 }
 
-export { CURRENT_WIDGET_PREFERENCES_VERSION, EMPTY_WIDGET_PREFERENCES, THESEAM_WIDGETS, THESEAM_WIDGET_ACCESSOR, THESEAM_WIDGET_DATA, THESEAM_WIDGET_DEFAULTS, THESEAM_WIDGET_PREFERENCES_ACCESSOR, TheSeamWidgetButtonGroupModule, TheSeamWidgetContentHeaderModule, TheSeamWidgetDescriptionModule, TheSeamWidgetEmptyLabelModule, TheSeamWidgetFooterLinkModule, TheSeamWidgetFooterTextModule, TheSeamWidgetHeaderBadgeModule, TheSeamWidgetListGroupModule, TheSeamWidgetModule, TheSeamWidgetTableModule, TheSeamWidgetTileListModule, TheSeamWidgetTileModule, WidgetButtonGroupComponent, WidgetComponent, WidgetContentHeaderComponent, WidgetDescriptionComponent, WidgetDragHandleDirective, WidgetEmptyLabelComponent, WidgetFooterComponent, WidgetFooterLinkComponent, WidgetFooterTextComponent, WidgetHeaderBadgeComponent, WidgetIconTplDirective, WidgetListGroupComponent, WidgetListGroupItemAnchorComponent, WidgetListGroupItemButtonComponent, WidgetListGroupItemComponent, WidgetListGroupItemIconTplDirective, WidgetPreferencesService, WidgetRegistryService, WidgetTableComponent, WidgetTileComponent, WidgetTileFooterComponent, WidgetTileFooterItemComponent, WidgetTileGroupComponent, WidgetTileListComponent, WidgetTileSecondaryIconDirective, WidgetTitleTplDirective, extendStyles, toggleNativeDragInteractions };
-export type { IWidgetRegistryRecord, TheSeamWidgetAccessor, TheSeamWidgetData, TheSeamWidgetDefaults, TheSeamWidgetPreferences, TheSeamWidgetPreferences_v1 };
+/** A set of criteria that can be used to filter a list of `TheSeamWidgetHarness` instances. */
+interface TheSeamWidgetHarnessFilters extends BaseHarnessFilters {
+}
+declare class TheSeamWidgetHarness extends ContentContainerComponentHarness<string> {
+    /** The selector for the host element of a `WidgetComponent` instance. */
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a menu item with specific attributes.
+     * @param options Options for filtering which menu item instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with<T extends TheSeamWidgetHarness>(this: ComponentHarnessConstructor<T>, options?: TheSeamWidgetHarnessFilters): HarnessPredicate<T>;
+}
+
+export { CURRENT_WIDGET_PREFERENCES_VERSION, EMPTY_WIDGET_PREFERENCES, THESEAM_WIDGETS, THESEAM_WIDGET_ACCESSOR, THESEAM_WIDGET_DATA, THESEAM_WIDGET_DEFAULTS, THESEAM_WIDGET_PREFERENCES_ACCESSOR, TheSeamWidgetButtonGroupModule, TheSeamWidgetContentHeaderModule, TheSeamWidgetDescriptionModule, TheSeamWidgetEmptyLabelModule, TheSeamWidgetFooterLinkModule, TheSeamWidgetFooterTextModule, TheSeamWidgetHarness, TheSeamWidgetHeaderBadgeModule, TheSeamWidgetListGroupModule, TheSeamWidgetModule, TheSeamWidgetTableModule, TheSeamWidgetTileListModule, TheSeamWidgetTileModule, WidgetButtonGroupComponent, WidgetComponent, WidgetContentHeaderComponent, WidgetDescriptionComponent, WidgetDragHandleDirective, WidgetEmptyLabelComponent, WidgetFooterComponent, WidgetFooterLinkComponent, WidgetFooterTextComponent, WidgetHeaderBadgeComponent, WidgetIconTplDirective, WidgetListGroupComponent, WidgetListGroupItemAnchorComponent, WidgetListGroupItemButtonComponent, WidgetListGroupItemComponent, WidgetListGroupItemIconTplDirective, WidgetPreferencesService, WidgetRegistryService, WidgetTableComponent, WidgetTileComponent, WidgetTileFooterComponent, WidgetTileFooterItemComponent, WidgetTileGroupComponent, WidgetTileListComponent, WidgetTileSecondaryIconDirective, WidgetTitleTplDirective, extendStyles, toggleNativeDragInteractions };
+export type { IWidgetRegistryRecord, TheSeamWidgetAccessor, TheSeamWidgetData, TheSeamWidgetDefaults, TheSeamWidgetHarnessFilters, TheSeamWidgetPreferences, TheSeamWidgetPreferences_v1 };