@theseam/ui-common 2.0.0 → 2.0.1-beta.101

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/google-maps/index.d.ts

@@ -16,7 +16,7 @@ import * as i7 from '@angular/common';
 import * as i8 from '@angular/cdk/observers';
 import * as i9 from '@theseam/ui-common/shared';
 import * as i13 from '@angular/google-maps';
-import * as geojson from 'geojson';
+import { Polygon } from 'geojson';
 
 declare abstract class TheSeamGoogleMapsApiLoader {
     abstract load(): Observable<void>;
@@ -49,7 +49,10 @@ declare class GoogleMapsService implements OnDestroy {
     private readonly _ngUnsubscribe;
     private readonly _mapReadySubject;
     private readonly _editingEnabledSubject;
-    private _drawingManager?;
+    private _terraDraw?;
+    private _terraDrawReady;
+    private readonly _drawingSubject;
+    readonly drawing$: Observable<boolean>;
     private _featureContextMenu;
     private _activeContextMenu;
     private _baseLatLng?;
@@ -74,11 +77,16 @@ declare class GoogleMapsService implements OnDestroy {
      * Iterates the map's features and removes any that are selected.
      */
     deleteSelection(): void;
+    /** Whether polygon drawing mode is currently active. */
+    isDrawing(): boolean;
+    /** Enter polygon drawing mode. */
+    startDrawing(): void;
     /**
-     * Stops the current drawing.
+     * Cancel any in-progress drawing and leave drawing mode. Switching to the
+     * `static` mode clears an unfinished line.
      */
     stopDrawing(): void;
-    private _initDrawingManager;
+    private _initTerraDraw;
     addControl(element: HTMLElement, position: google.maps.ControlPosition): void;
     setData(data: any): Promise<void>;
     reCenterOnFeatures(): void;
@@ -89,7 +97,6 @@ declare class GoogleMapsService implements OnDestroy {
     setFeatureHoveredStyleOverride(feature: google.maps.Data.Feature): void;
     private _mergeStyleOptions;
     private _initFeatureChangeListeners;
-    isDrawing(): boolean;
     hasSelectedFeature(): boolean;
     getSelectedFeature(): google.maps.Data.Feature | null;
     openContextMenu(): void;
@@ -98,6 +105,20 @@ declare class GoogleMapsService implements OnDestroy {
     getGeoJson(removeAppProperties?: boolean): Promise<object>;
     /** Asserts that the map has been initialized. */
     private _assertInitialized;
+    private _onDrawFinished;
+    /**
+     * Normalize a finished Terra Draw geometry into a Polygon. A Polygon (the
+     * user closed the line on its start point) passes through; an open LineString
+     * (the user finished without closing) is closed into a polygon so nothing
+     * they drew is discarded. Any other geometry type yields undefined.
+     */
+    private _toDrawnPolygon;
+    /**
+     * Find an existing Polygon feature that fully contains the drawn polygon, so
+     * the drawing can be applied as a cutout. Returns the existing feature
+     * instance (never a copy).
+     */
+    private _getPossibleExteriorFeature;
     static ɵfac: i0.ɵɵFactoryDeclaration<GoogleMapsService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<GoogleMapsService>;
 }
@@ -148,6 +169,7 @@ declare class TheSeamGoogleMapsComponent extends _TheSeamGoogleMapsMixinBase imp
     readonly _gmApiLoaded: Observable<boolean>;
     readonly _fileUploadControlDef: MapControl;
     readonly _reCenterControlDef: MapControl;
+    readonly _drawControlDef: MapControl;
     private _focusOrigin;
     set value(value: MapValue);
     get value(): MapValue;
@@ -529,25 +551,15 @@ declare function getStyleOptionsDefinedByFeature(feature: google.maps.Data.Featu
 declare function getHoveredStyleOptionsDefinedByFeature(feature: google.maps.Data.Feature): google.maps.Data.StyleOptions | undefined;
 declare function getSelectedStyleOptionsDefinedByFeature(feature: google.maps.Data.Feature): google.maps.Data.StyleOptions | undefined;
 declare function stripAppFeaturePropertiesFromJson(json: any): void;
-/**
- * Searches for a Feature in Data that contains the provided Feature and can use
- * it as a cutout area.
- */
-declare function getPossibleExteriorFeature(data: google.maps.Data, feature: google.maps.Data.Feature): google.maps.Data.Feature | undefined;
-declare function addInnerFeatureCutoutToExteriorFeature(exteriorFeature: google.maps.Data.Feature, innerFeature: google.maps.Data.Feature): void;
-/**
- * Google maps paths don't always start and stop at the exact same position, so
- * this will fix that for turfjs.
- */
-declare function fixPathDifferentStartingAndEndingPoint(coordinates: number[][]): void;
 declare function polygonHasValidPathsLengths(polygon: google.maps.Polygon, minPointsInValidPath?: number): boolean;
 declare function polygonCoordinates(polygon: google.maps.Data.Polygon): number[][][];
-declare function multiPolygonCoordinates(multiPolygon: google.maps.Data.MultiPolygon): number[][][][];
-declare function toTurfJsPolygon(polygon: google.maps.Data.Polygon): geojson.Feature<geojson.Polygon, geojson.GeoJsonProperties>;
-declare function toTurfJsMultiPolygon(multiPolygon: google.maps.Data.MultiPolygon): geojson.Feature<geojson.MultiPolygon, geojson.GeoJsonProperties>;
-declare function toTurfJsFeature(googleFeature: google.maps.Data.Feature): geojson.Feature<geojson.Polygon, geojson.GeoJsonProperties> | geojson.Feature<geojson.MultiPolygon, geojson.GeoJsonProperties>;
-declare function featureContains(featureA: google.maps.Data.Feature, featureB: google.maps.Data.Feature): boolean;
-declare function createDataFeatureFromPolygon(polygon: google.maps.Polygon): google.maps.Data.Feature;
+/** Build a google.maps.Data.Polygon from a GeoJSON Polygon (lng/lat order). */
+declare function dataPolygonFromGeoJson(polygon: Polygon): google.maps.Data.Polygon;
+/**
+ * Read an existing feature's Polygon geometry as a closed GeoJSON Polygon.
+ * Returns undefined for non-Polygon geometries. Does not mutate the feature.
+ */
+declare function geoJsonPolygonFromDataFeature(feature: google.maps.Data.Feature): Polygon | undefined;
 declare function getBoundsWithAllFeatures(data: google.maps.Data): google.maps.LatLngBounds;
 declare function getFeatureBounds(feature: google.maps.Data.Feature): google.maps.LatLngBounds;
 declare function getFeatureCenter(feature: google.maps.Data.Feature): google.maps.LatLng;
@@ -653,5 +665,5 @@ declare class TheSeamNoopGoogleMapsAPILoader extends TheSeamGoogleMapsApiLoader
     static ɵprov: i0.ɵɵInjectableDeclaration<TheSeamNoopGoogleMapsAPILoader>;
 }
 
-export { AppFeaturePropertyName, GoogleMapsContextMenu, GoogleMapsControlsService, GoogleMapsService, MAP_CONTROLS_SERVICE, MAP_CONTROL_DATA, MapControlRef, MapValueManagerService, MapValueSource, SEAM_GOOGLE_PLACES_AUTOCOMPLETE_DEFAULT_OPTIONS, THESEAM_LAZY_MAPS_API_CONFIG, TheSeamGoogleMapsApiLoader, TheSeamGoogleMapsComponent, TheSeamGoogleMapsModule, TheSeamGoogleMapsPlacesAutoCompleteComponent, TheSeamGoogleMapsPlacesAutocompleteDirective, TheSeamGoogleMapsRecenterButtonControlComponent, TheSeamGoogleMapsUploadButtonControlComponent, TheSeamLazyMapsApiLoader, TheSeamMapFileDropComponent, TheSeamMapsControlComponent, TheSeamNoopGoogleMapsAPILoader, addInnerFeatureCutoutToExteriorFeature, createDataFeatureFromPolygon, createFeatureChangeObservable, featureContains, fixPathDifferentStartingAndEndingPoint, getBoundsWithAllFeatures, getFeatureBounds, getFeatureCenter, getFeaturesCount, getHoveredStyleOptionsDefinedByFeature, getPossibleExteriorFeature, getSelectedStyleOptionsDefinedByFeature, getStyleOptionsDefinedByFeature, isAppFeatureProperty, isFeatureSelected, multiPolygonCoordinates, polygonCoordinates, polygonHasValidPathsLengths, removeAllFeatures, setFeatureSelected, stripAppFeaturePropertiesFromJson, toTurfJsFeature, toTurfJsMultiPolygon, toTurfJsPolygon };
+export { AppFeaturePropertyName, GoogleMapsContextMenu, GoogleMapsControlsService, GoogleMapsService, MAP_CONTROLS_SERVICE, MAP_CONTROL_DATA, MapControlRef, MapValueManagerService, MapValueSource, SEAM_GOOGLE_PLACES_AUTOCOMPLETE_DEFAULT_OPTIONS, THESEAM_LAZY_MAPS_API_CONFIG, TheSeamGoogleMapsApiLoader, TheSeamGoogleMapsComponent, TheSeamGoogleMapsModule, TheSeamGoogleMapsPlacesAutoCompleteComponent, TheSeamGoogleMapsPlacesAutocompleteDirective, TheSeamGoogleMapsRecenterButtonControlComponent, TheSeamGoogleMapsUploadButtonControlComponent, TheSeamLazyMapsApiLoader, TheSeamMapFileDropComponent, TheSeamMapsControlComponent, TheSeamNoopGoogleMapsAPILoader, createFeatureChangeObservable, dataPolygonFromGeoJson, geoJsonPolygonFromDataFeature, getBoundsWithAllFeatures, getFeatureBounds, getFeatureCenter, getFeaturesCount, getHoveredStyleOptionsDefinedByFeature, getSelectedStyleOptionsDefinedByFeature, getStyleOptionsDefinedByFeature, isAppFeatureProperty, isFeatureSelected, polygonCoordinates, polygonHasValidPathsLengths, removeAllFeatures, setFeatureSelected, stripAppFeaturePropertiesFromJson };
 export type { GoogleMapsRecenterButtonControlData, GoogleMapsUploadButtonControlData, MapControl, MapControlsService, MapValue, MapValueChange, TheSeamLazyMapsApiLoaderConfig };

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": "2.0.0",
+  "version": "2.0.1-beta.101",
   "peerDependencies": {
     "@angular/cdk": "^20.2.3",
     "@angular/common": "^20.3.0",
@@ -35,7 +35,7 @@
     "@types/webfontloader": "^1.6.29",
     "intl-tel-input": "^17.0.5",
     "@ajsf/core": "^0.8.0",
-    "quill": "2.0.3",
+    "quill": "2.0.2",
     "ngx-quill": "^27.1.2",
     "@turf/area": "^7.2.0",
     "@turf/boolean-contains": "^7.2.0",
@@ -353,4 +353,4 @@
     }
   },
   "sideEffects": false
-}
+}

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/utils/index.d.ts

@@ -3,7 +3,7 @@ import { ElementRef, QueryList } from '@angular/core';
 import { AbstractControl, ValidatorFn } from '@angular/forms';
 import { Observable } from 'rxjs';
 import { ActivatedRoute, Data, ActivatedRouteSnapshot } from '@angular/router';
-import { FeatureCollection, GeoJSON, Feature, GeoJsonProperties, Geometry, Polygon, MultiPolygon } from 'geojson';
+import { FeatureCollection, GeoJSON, Feature, GeoJsonProperties, Geometry, Polygon, MultiPolygon, Position } from 'geojson';
 import { AreaUnits } from '@turf/helpers';
 
 /**
@@ -234,14 +234,46 @@ declare function readGeoFile(fileOrBuffer: File | ArrayBuffer): Promise<FeatureC
 declare function splitMultiPolygons(featureCollection: FeatureCollection): void;
 
 /**
- * Close all polygons in the GeoJSON.
+ * Close all polygons in the GeoJSON so the first and last position of every
+ * ring are identical.
  *
- * Google Maps requires that polygons be closed, but not all libraries have that
- * requirement. This may add redundent points to the GeoJSON, but it will ensure
- * that the GeoJSON is valid for Google Maps.
+ * Google Maps requires closed polygon rings, but not all libraries produce
+ * them. This is idempotent: rings that are already closed are left unchanged.
  */
 declare function closePolygons(geoJson: FeatureCollection | Feature | Polygon | MultiPolygon): void;
 
+/**
+ * Checks if a single polygon ring's coordinate count violates the given
+ * min/max point bounds. `max` is only applied when it is greater than `min`.
+ */
+declare function polygonViolatesMinMax(coordinateLength: number, min: number, max?: number | undefined): boolean;
+
+/**
+ * Whether a polygon's outer ring has at least `min` distinct vertices.
+ * Ring closure (a repeated first/last point) does not count toward the total,
+ * so this behaves the same for closed and unclosed rings.
+ */
+declare function polygonHasMinDistinctVertices(polygon: Polygon, min?: number): boolean;
+
+/**
+ * Whether `outer` fully contains `inner`, using turf's boolean-contains on the
+ * GeoJSON geometries directly (no Google Maps dependency).
+ */
+declare function polygonContains(outer: Polygon, inner: Polygon): boolean;
+
+/**
+ * Whether a ring is wound clockwise, via the shoelace signed-area sign.
+ * Sum of (x2 - x1) * (y2 + y1) is positive for clockwise rings in standard
+ * (x = lng, y = lat) orientation.
+ */
+declare function ringIsClockwise(ring: Position[]): boolean;
+/**
+ * Append the outer ring of `hole` to `exterior` as an interior ring (a
+ * cutout), wound opposite the exterior ring so it renders as a hole. Returns a
+ * new Polygon; inputs are not mutated.
+ */
+declare function addHoleToPolygon(exterior: Polygon, hole: Polygon): Polygon;
+
 /**
   Moves the item to the new position in the input array. Useful for huge arrays
   where absolute performance is needed.
@@ -452,5 +484,5 @@ interface SanitizeFilenameOptions {
 }
 declare function sanitizeFilename(filename: string, options?: SanitizeFilenameOptions): string;
 
-export { IS_FEATURE_COLLECTION_VALIDATOR_NAME, IS_ONLY_GEOMETRY_TYPES_VALIDATOR_NAME, MIN_MAX_POINTS_VALIDATOR_NAME, NO_EMPTY_FEATURE_COLLECTION_VALIDATOR_NAME, NO_INNER_RINGS_VALIDATOR_NAME, NO_KINKS_VALIDATOR_NAME, PollingTickerOptions, Refreshable, activatedRoutesWithDataProperty, arrayMoveImmutable, arrayMoveMutable, calcPercentage, closePolygons, coerceFeatureCollection, createPadding, deleteProperties, deleteProperty, fileBufferToBlob, fileBufferToObjectUrl, fileDataFromBuffer, fractionalDigitsCount, geoJsonToArea, getAttribute, getClosestWidgetCdkDrag, getControlName, getControlPath, hasAttribute, hasProperty, hasRequiredControl, isAbsoluteUrl, isEmptyInputValue, isEmptyUrlRoute, isFeatureCollectionValidator, isNullOrUndefined, isNullOrUndefinedOrEmpty, isNumeric, isOnlyGeometryTypes, isOnlyGeometryTypesValidator, leafChildRoute, loadStyle, loadStyleSheet, mapEach, mergePolygons, minMaxPointsValidator, noEmptyFeatureCollectionValidator, noInnerRingsValidator, noKinksValidator, notNullOrUndefined, notNullOrUndefinedOrEmpty, observeControlIsDifferent, observeControlStatus, observeControlValid, observeControlValue, observeControlValueChange, observeQueryList, openBlob, padEnd, padStart, phoneNumberMask, pollingTicker, readFileAsDataUrlAsync, readFileAsync, readGeoFile, routeSnapshotPathFull, routeSnapshotPathRelative, sanitizeFilename, splitMultiPolygons, stripOuter, subscriberCount, tapFirst, toggleAttribute, trimRepeated, waitOnConditionAsync, waitOnNonPendingStatus, willHaveDataProp, withoutProperties, withoutProperty, wrapIntoObservable };
+export { IS_FEATURE_COLLECTION_VALIDATOR_NAME, IS_ONLY_GEOMETRY_TYPES_VALIDATOR_NAME, MIN_MAX_POINTS_VALIDATOR_NAME, NO_EMPTY_FEATURE_COLLECTION_VALIDATOR_NAME, NO_INNER_RINGS_VALIDATOR_NAME, NO_KINKS_VALIDATOR_NAME, PollingTickerOptions, Refreshable, activatedRoutesWithDataProperty, addHoleToPolygon, arrayMoveImmutable, arrayMoveMutable, calcPercentage, closePolygons, coerceFeatureCollection, createPadding, deleteProperties, deleteProperty, fileBufferToBlob, fileBufferToObjectUrl, fileDataFromBuffer, fractionalDigitsCount, geoJsonToArea, getAttribute, getClosestWidgetCdkDrag, getControlName, getControlPath, hasAttribute, hasProperty, hasRequiredControl, isAbsoluteUrl, isEmptyInputValue, isEmptyUrlRoute, isFeatureCollectionValidator, isNullOrUndefined, isNullOrUndefinedOrEmpty, isNumeric, isOnlyGeometryTypes, isOnlyGeometryTypesValidator, leafChildRoute, loadStyle, loadStyleSheet, mapEach, mergePolygons, minMaxPointsValidator, noEmptyFeatureCollectionValidator, noInnerRingsValidator, noKinksValidator, notNullOrUndefined, notNullOrUndefinedOrEmpty, observeControlIsDifferent, observeControlStatus, observeControlValid, observeControlValue, observeControlValueChange, observeQueryList, openBlob, padEnd, padStart, phoneNumberMask, pollingTicker, polygonContains, polygonHasMinDistinctVertices, polygonViolatesMinMax, readFileAsDataUrlAsync, readFileAsync, readGeoFile, ringIsClockwise, routeSnapshotPathFull, routeSnapshotPathRelative, sanitizeFilename, splitMultiPolygons, stripOuter, subscriberCount, tapFirst, toggleAttribute, trimRepeated, waitOnConditionAsync, waitOnNonPendingStatus, willHaveDataProp, withoutProperties, withoutProperty, wrapIntoObservable };
 export type { IActivatedRouteWithData, IFileData, PollingActionFn, RefreshableOptions, SanitizeFilenameOptions, SubscriberCountChangedFn };

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