@skyux/core 15.0.0-alpha.0 → 15.0.0-alpha.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyux/core",
-  "version": "15.0.0-alpha.0",
+  "version": "15.0.0-alpha.10",
   "author": "Blackbaud, Inc.",
   "keywords": [
     "blackbaud",
@@ -16,12 +16,12 @@
   },
   "homepage": "https://github.com/blackbaud/skyux#readme",
   "peerDependencies": {
-    "@angular/cdk": "^22.0.1",
-    "@angular/common": "^22.0.1",
-    "@angular/core": "^22.0.1",
-    "@angular/platform-browser": "^22.0.1",
-    "@angular/router": "^22.0.1",
-    "@skyux/i18n": "15.0.0-alpha.0"
+    "@angular/cdk": "^22.1.2",
+    "@angular/common": "^22.1.2",
+    "@angular/core": "^22.1.2",
+    "@angular/platform-browser": "^22.1.2",
+    "@angular/router": "^22.1.2",
+    "@skyux/i18n": "15.0.0-alpha.10"
   },
   "dependencies": {
     "tslib": "^2.8.1"

package/types/skyux-core-testing.d.ts

@@ -1,8 +1,9 @@
 import * as i0 from '@angular/core';
-import { Provider } from '@angular/core';
+import { Provider, Predicate, DebugElement } from '@angular/core';
 import { SkyMediaQueryService, SkyMediaBreakpoints, SkyMediaQueryListener, SkyUIConfigService, SkyBreakpoint } from '@skyux/core';
 import { BehaviorSubject, Subscription, Observable } from 'rxjs';
 import { BaseHarnessFilters, ComponentHarness, ComponentHarnessConstructor, HarnessPredicate, HarnessQuery, TestElement } from '@angular/cdk/testing';
+import { ComponentFixture } from '@angular/core/testing';
 
 /**
  * @internal
@@ -186,6 +187,60 @@ declare class SkyOverlayHarness extends SkyQueryableComponentHarness {
     static with(filters: SkyOverlayHarnessFilters): HarnessPredicate<SkyOverlayHarness>;
 }
 
+/**
+ * Provides predicates for querying elements rendered by SKY UX components.
+ * @internal
+ */
+declare class SkyBy {
+    /**
+     * Creates a predicate that matches elements with the given `data-sky-id` attribute value.
+     */
+    static dataSkyId(skyId: string): Predicate<DebugElement>;
+}
+
+/**
+ * Options for `SkyAppTestUtility.fireDomEvent()`.
+ * @internal
+ */
+interface SkyAppTestUtilityDomEventOptions {
+    bubbles?: boolean;
+    cancelable?: boolean;
+    keyboardEventInit?: KeyboardEventInit;
+    customEventInit?: object;
+}
+
+/**
+ * A collection of low-level DOM and Angular test helpers.
+ * @internal
+ */
+declare class SkyAppTestUtility {
+    static fireDomEvent(element: EventTarget | null | undefined, eventName: string, options?: SkyAppTestUtilityDomEventOptions): void;
+    /**
+     * Returns the inner text content of an element.
+     */
+    static getText(element: any): string | undefined;
+    /**
+     * Returns true if the element exists on the page.
+     */
+    static isVisible(element: any): boolean | undefined;
+    /**
+     * Sets the value of an input element and triggers its 'input' and 'change' events.
+     */
+    static setInputValue(element: any, value: string): void;
+    /**
+     * Returns the URL of an element's background image, if it exists.
+     */
+    static getBackgroundImageUrl(el: any): string | undefined;
+    /**
+     * Returns a DebugElement representing a SKY UX component.
+     * @internal
+     * @param fixture The ComponentFixture where the SKY UX component resides.
+     * @param skyTestId The value of the `data-sky-id` property specified on the SKY UX component.
+     * @param componentSelector The selector name for the SKY UX component (e.g. 'sky-alert').
+     */
+    static getDebugElementByTestId(fixture: ComponentFixture<any>, skyTestId: string, componentSelector: string): DebugElement;
+}
+
 declare class SkyHarnessUtility {
     static getBackgroundImageUrl(el: TestElement): Promise<string | undefined>;
 }
@@ -225,5 +280,5 @@ declare class SkyInputHarness extends ComponentHarness {
     setValue(value: string): Promise<void>;
 }
 
-export { MockSkyMediaQueryService, MockSkyUIConfigService, SkyComponentHarness, SkyCoreTestingModule, SkyHarnessUtility, SkyHelpTestingController, SkyHelpTestingModule, SkyInputHarness, SkyMediaQueryTestingController, SkyOverlayHarness, SkyQueryableComponentHarness, mockResizeObserver, mockResizeObserverEntry, mockResizeObserverHandle, provideSkyFileReaderTesting, provideSkyMediaQueryTesting };
-export type { SkyHarnessFilters, SkyOverlayHarnessFilters };
+export { MockSkyMediaQueryService, MockSkyUIConfigService, SkyAppTestUtility, SkyBy, SkyComponentHarness, SkyCoreTestingModule, SkyHarnessUtility, SkyHelpTestingController, SkyHelpTestingModule, SkyInputHarness, SkyMediaQueryTestingController, SkyOverlayHarness, SkyQueryableComponentHarness, mockResizeObserver, mockResizeObserverEntry, mockResizeObserverHandle, provideSkyFileReaderTesting, provideSkyMediaQueryTesting };
+export type { SkyAppTestUtilityDomEventOptions, SkyHarnessFilters, SkyOverlayHarnessFilters };

package/types/skyux-core.d.ts

@@ -816,6 +816,8 @@ declare abstract class SkyHelpService {
     static ɵprov: i0.ɵɵInjectableDeclaration<SkyHelpService>;
 }
 
+declare const SKY_ICON_SVG_URL: InjectionToken<string>;
+
 /**
  * Sets the element's `id` attribute to a unique ID. To reference this unique ID on other elements,
  * such as in a `label` element's `for` attribute, assign this directive to a template reference
@@ -1557,6 +1559,8 @@ declare class SkyScrollShadowDirective implements OnDestroy {
     static ɵdir: i0.ɵɵDirectiveDeclaration<SkyScrollShadowDirective, "[skyScrollShadow]", never, { "skyScrollShadowEnabled": { "alias": "skyScrollShadowEnabled"; "required": false; }; }, { "skyScrollShadow": "skyScrollShadow"; }, never, never, true, never>;
 }
 
+type HostRect = Pick<DOMRect, 'top' | 'left' | 'right' | 'bottom'>;
+type MaskingContainers<T> = Partial<Record<keyof HostRect, T>>;
 declare class SkyScrollableHostService {
     #private;
     constructor(mutationObserverSvc: SkyMutationObserverService, windowRef: SkyAppWindowRef, resizeObserverSvc?: SkyResizeObserverService, zone?: NgZone);
@@ -1579,7 +1583,10 @@ declare class SkyScrollableHostService {
      * @returns An observable which emits when the elements scrollable host is scrolled or is changed
      */
     watchScrollableHostScrollEvents(elementRef: ElementRef): Observable<void>;
-    watchScrollableHostClipPathChanges(elementRef: ElementRef, additionalContainers?: Observable<ElementRef[]>): Observable<string>;
+    watchScrollableHostClipPathChanges(elementRef: ElementRef, options?: Observable<ElementRef[]> | {
+        additionalContainers?: Observable<ElementRef[]>;
+        additionalMasking?: MaskingContainers<Observable<ElementRef[]>>;
+    }): Observable<string>;
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyScrollableHostService, [null, null, { optional: true; }, { optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SkyScrollableHostService>;
 }
@@ -1761,5 +1768,5 @@ declare class Version {
  */
 declare const VERSION: Version;
 
-export { NumericOptions, SKY_BREAKPOINTS, SKY_BREAKPOINT_OBSERVER, SKY_HELP_GLOBAL_OPTIONS, SKY_LOG_LEVEL, SKY_STACKING_CONTEXT, SkyAffixAutoFitContext, SkyAffixModule, SkyAffixService, SkyAffixer, SkyAppFormat, SkyAppTitleService, SkyAppWindowRef, SkyContainerBreakpointObserver, SkyContentInfoProvider, SkyCoreAdapterModule, SkyCoreAdapterService, SkyDefaultInputProvider, SkyDockItem, SkyDockLocation, SkyDockModule, SkyDockService, SkyDynamicComponentLegacyService, SkyDynamicComponentLocation, SkyDynamicComponentModule, SkyDynamicComponentService, SkyFileReaderService, SkyHelpService, SkyIdModule, SkyIdService, SkyLayoutHostDirective, SkyLayoutHostService, SkyLiveAnnouncerService, SkyLogLevel, SkyLogModule, SkyLogService, SkyMediaBreakpointObserver, SkyMediaBreakpoints, SkyMediaQueryModule, SkyMediaQueryService, SkyMutationObserverService, SkyNumericModule, SkyNumericPipe, SkyNumericService, SkyOverlayInstance, SkyOverlayLegacyService, SkyOverlayModule, SkyOverlayService, SkyPercentPipe, SkyPercentPipeModule, SkyResizeObserverMediaQueryService, SkyResizeObserverService, SkyResponsiveHostDirective, SkyScreenReaderLabelDirective, SkyScrollShadowDirective, SkyScrollableHostService, SkyTrimModule, SkyUIConfigService, SkyViewkeeper, SkyViewkeeperHostOptions, SkyViewkeeperModule, SkyViewkeeperService, VERSION, _SkyAnimationEndHandlerDirective, _SkyAnimationSlideComponent, _SkyTransitionEndHandlerDirective, provideNoopSkyAnimations, provideSkyBreakpointObserver, SkyAffixDirective as λ1, SkyIdDirective as λ2, SkyViewkeeperDirective as λ3, SkyTrimDirective as λ4 };
+export { NumericOptions, SKY_BREAKPOINTS, SKY_BREAKPOINT_OBSERVER, SKY_HELP_GLOBAL_OPTIONS, SKY_ICON_SVG_URL, SKY_LOG_LEVEL, SKY_STACKING_CONTEXT, SkyAffixAutoFitContext, SkyAffixModule, SkyAffixService, SkyAffixer, SkyAppFormat, SkyAppTitleService, SkyAppWindowRef, SkyContainerBreakpointObserver, SkyContentInfoProvider, SkyCoreAdapterModule, SkyCoreAdapterService, SkyDefaultInputProvider, SkyDockItem, SkyDockLocation, SkyDockModule, SkyDockService, SkyDynamicComponentLegacyService, SkyDynamicComponentLocation, SkyDynamicComponentModule, SkyDynamicComponentService, SkyFileReaderService, SkyHelpService, SkyIdModule, SkyIdService, SkyLayoutHostDirective, SkyLayoutHostService, SkyLiveAnnouncerService, SkyLogLevel, SkyLogModule, SkyLogService, SkyMediaBreakpointObserver, SkyMediaBreakpoints, SkyMediaQueryModule, SkyMediaQueryService, SkyMutationObserverService, SkyNumericModule, SkyNumericPipe, SkyNumericService, SkyOverlayInstance, SkyOverlayLegacyService, SkyOverlayModule, SkyOverlayService, SkyPercentPipe, SkyPercentPipeModule, SkyResizeObserverMediaQueryService, SkyResizeObserverService, SkyResponsiveHostDirective, SkyScreenReaderLabelDirective, SkyScrollShadowDirective, SkyScrollableHostService, SkyTrimModule, SkyUIConfigService, SkyViewkeeper, SkyViewkeeperHostOptions, SkyViewkeeperModule, SkyViewkeeperService, VERSION, _SkyAnimationEndHandlerDirective, _SkyAnimationSlideComponent, _SkyTransitionEndHandlerDirective, provideNoopSkyAnimations, provideSkyBreakpointObserver, SkyAffixDirective as λ1, SkyIdDirective as λ2, SkyViewkeeperDirective as λ3, SkyTrimDirective as λ4 };
 export type { SkyAffixConfig, SkyAffixHorizontalAlignment, SkyAffixOffset, SkyAffixOffsetChange, SkyAffixPlacement, SkyAffixPlacementChange, SkyAffixPosition, SkyAffixVerticalAlignment, SkyAppSetTitleArgs, SkyBreakpoint, SkyBreakpointObserver, SkyContentInfo, SkyContentInfoDescriptor, SkyDockInsertComponentConfig, SkyDockItemConfig, SkyDockOptions, SkyDynamicComponentOptions, SkyFocusableChildrenOptions, SkyHelpGlobalOptions, SkyHelpOpenArgs, SkyHelpUpdateArgs, SkyLayoutHostForChildArgs, SkyLiveAnnouncerArgs, SkyLiveAnnouncerPoliteness, SkyMediaQueryListener, SkyNumericOptions, SkyNumericSymbol, SkyOverlayConfig, SkyOverlayPosition, SkyScrollShadowEventArgs, SkyStackingContext, SkyViewkeeperOptions };