@skyux/forms 12.0.0-alpha.0 → 12.0.0-alpha.1

package/lib/modules/file-attachment/file-attachment/file-attachment.service.d.ts

@@ -6,7 +6,7 @@ import * as i0 from "@angular/core";
  */
 export declare class SkyFileAttachmentService {
     #private;
-    checkFiles(files: FileList, minFileSize: number, maxFileSize: number, acceptedTypes?: string, validateFn?: SkyFileValidateFn): SkyFileItem[];
+    checkFiles(files: SkyFileItem[], minFileSize: number, maxFileSize: number, acceptedTypes?: string, validateFn?: SkyFileValidateFn): SkyFileItem[];
     /**
      * Returns `true` if a directory is found in the provided `files` parameter.
      */

package/lib/modules/file-attachment/file-drop/file-drop.component.d.ts

@@ -1,4 +1,5 @@
 import { ElementRef, EventEmitter, OnDestroy, TemplateRef } from '@angular/core';
+import { ControlValueAccessor, NgControl } from '@angular/forms';
 import { SkyFileItem } from '../shared/file-item';
 import { SkyFileValidateFn } from '../shared/file-validate-function';
 import { SkyFileDropChange } from './file-drop-change';
@@ -14,7 +15,7 @@ import * as i0 from "@angular/core";
  * outside of the file drop component, you can place the `sky-file-drop-target` CSS class
  * on the element that receives drop events to exempt it from the drop exclusion rule.
  */
-export declare class SkyFileDropComponent implements OnDestroy {
+export declare class SkyFileDropComponent implements OnDestroy, ControlValueAccessor {
     #private;
     /**
      * Fires when users add or remove files.
@@ -135,8 +136,13 @@ export declare class SkyFileDropComponent implements OnDestroy {
     acceptedOver: boolean;
     linkUrl: string | undefined;
     protected errorId: string;
+    protected ngControl: NgControl | null;
     protected rejectedFiles: SkyFileItem[];
+    constructor();
     ngOnDestroy(): void;
+    writeValue(value: unknown): void;
+    registerOnChange(fn: any): void;
+    registerOnTouched(fn: () => void): void;
     dropClicked(): void;
     fileChangeEvent(fileChangeEvent: Event): void;
     fileDragEnter(dragEnterEvent: DragEvent): void;
@@ -145,9 +151,11 @@ export declare class SkyFileDropComponent implements OnDestroy {
     fileDragLeave(dragLeaveEvent: any): void;
     addLinkEnter(event: KeyboardEvent): void;
     addLink(event: Event): void;
+    protected uploadLink(file: SkyFileLink): void;
     onLinkBlur(): void;
+    protected get isRequired(): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyFileDropComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SkyFileDropComponent, "sky-file-drop", never, { "fileUploadAriaLabel": { "alias": "fileUploadAriaLabel"; "required": false; }; "linkUploadAriaLabel": { "alias": "linkUploadAriaLabel"; "required": false; }; "linkUploadHintText": { "alias": "linkUploadHintText"; "required": false; }; "minFileSize": { "alias": "minFileSize"; "required": false; }; "maxFileSize": { "alias": "maxFileSize"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "validateFn": { "alias": "validateFn"; "required": false; }; "acceptedTypes": { "alias": "acceptedTypes"; "required": false; }; "acceptedTypesErrorMessage": { "alias": "acceptedTypesErrorMessage"; "required": false; }; "noClick": { "alias": "noClick"; "required": false; }; "allowLinks": { "alias": "allowLinks"; "required": false; }; "labelText": { "alias": "labelText"; "required": false; }; "labelHidden": { "alias": "labelHidden"; "required": false; }; "hintText": { "alias": "hintText"; "required": false; }; "required": { "alias": "required"; "required": false; }; "helpPopoverContent": { "alias": "helpPopoverContent"; "required": false; }; "helpPopoverTitle": { "alias": "helpPopoverTitle"; "required": false; }; "stacked": { "alias": "stacked"; "required": false; }; "helpKey": { "alias": "helpKey"; "required": false; }; }, { "filesChanged": "filesChanged"; "linkInputBlur": "linkInputBlur"; "linkChanged": "linkChanged"; }, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkyFileDropComponent, "sky-file-drop", never, { "fileUploadAriaLabel": { "alias": "fileUploadAriaLabel"; "required": false; }; "linkUploadAriaLabel": { "alias": "linkUploadAriaLabel"; "required": false; }; "linkUploadHintText": { "alias": "linkUploadHintText"; "required": false; }; "minFileSize": { "alias": "minFileSize"; "required": false; }; "maxFileSize": { "alias": "maxFileSize"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "validateFn": { "alias": "validateFn"; "required": false; }; "acceptedTypes": { "alias": "acceptedTypes"; "required": false; }; "acceptedTypesErrorMessage": { "alias": "acceptedTypesErrorMessage"; "required": false; }; "noClick": { "alias": "noClick"; "required": false; }; "allowLinks": { "alias": "allowLinks"; "required": false; }; "labelText": { "alias": "labelText"; "required": false; }; "labelHidden": { "alias": "labelHidden"; "required": false; }; "hintText": { "alias": "hintText"; "required": false; }; "required": { "alias": "required"; "required": false; }; "helpPopoverContent": { "alias": "helpPopoverContent"; "required": false; }; "helpPopoverTitle": { "alias": "helpPopoverTitle"; "required": false; }; "stacked": { "alias": "stacked"; "required": false; }; "helpKey": { "alias": "helpKey"; "required": false; }; }, { "filesChanged": "filesChanged"; "linkInputBlur": "linkInputBlur"; "linkChanged": "linkChanged"; }, never, ["*", "sky-form-error"], true, never>;
     static ngAcceptInputType_labelHidden: unknown;
     static ngAcceptInputType_required: unknown;
     static ngAcceptInputType_stacked: unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyux/forms",
-  "version": "12.0.0-alpha.0",
+  "version": "12.0.0-alpha.1",
   "author": "Blackbaud, Inc.",
   "keywords": [
     "blackbaud",
@@ -37,14 +37,14 @@
     "@angular/core": "^19.0.5",
     "@angular/forms": "^19.0.5",
     "@angular/platform-browser": "^19.0.5",
-    "@skyux-sdk/testing": "12.0.0-alpha.0",
-    "@skyux/core": "12.0.0-alpha.0",
-    "@skyux/help-inline": "12.0.0-alpha.0",
-    "@skyux/i18n": "12.0.0-alpha.0",
-    "@skyux/icon": "12.0.0-alpha.0",
-    "@skyux/indicators": "12.0.0-alpha.0",
-    "@skyux/popovers": "12.0.0-alpha.0",
-    "@skyux/theme": "12.0.0-alpha.0"
+    "@skyux-sdk/testing": "12.0.0-alpha.1",
+    "@skyux/core": "12.0.0-alpha.1",
+    "@skyux/help-inline": "12.0.0-alpha.1",
+    "@skyux/i18n": "12.0.0-alpha.1",
+    "@skyux/icon": "12.0.0-alpha.1",
+    "@skyux/indicators": "12.0.0-alpha.1",
+    "@skyux/popovers": "12.0.0-alpha.1",
+    "@skyux/theme": "12.0.0-alpha.1"
   },
   "dependencies": {
     "tslib": "^2.8.1"

package/testing/modules/file-attachment/file-drop/file-drop-harness.d.ts

@@ -3,7 +3,6 @@ import { SkyComponentHarness } from '@skyux/core/testing';
 import { SkyFileDropHarnessFilters } from './file-drop-harness-filters';
 /**
  * Harness for interacting with a file drop component in tests.
- * @internal
  */
 export declare class SkyFileDropHarness extends SkyComponentHarness {
     #private;
@@ -17,7 +16,95 @@ export declare class SkyFileDropHarness extends SkyComponentHarness {
      */
     static with(filters: SkyFileDropHarnessFilters): HarnessPredicate<SkyFileDropHarness>;
     /**
-     * Drops a file onto the component's drop target.
+     * Clicks the file drop target.
      */
-    dropFile(file: File): Promise<void>;
+    clickFileDropTarget(): Promise<void>;
+    /**
+     * Clicks the help inline button.
+     */
+    clickHelpInline(): Promise<void>;
+    /**
+     * Clicks the link upload `Done` button'.
+     */
+    clickLinkUploadDoneButton(): Promise<void>;
+    /**
+     * Enters text into the link upload input.
+     */
+    enterLinkUploadText(link: string): Promise<void>;
+    /**
+     * Gets the accepted file types.
+     */
+    getAcceptedTypes(): Promise<string | null>;
+    /**
+     * Gets the aria-label for the file upload button.
+     */
+    getFileUploadAriaLabel(): Promise<string | null>;
+    /**
+     * Gets the help inline popover content.
+     */
+    getHelpPopoverContent(): Promise<string | undefined>;
+    /**
+     * Gets the help inline popover title.
+     */
+    getHelpPopoverTitle(): Promise<string | undefined>;
+    /**
+     * Gets the hint text.
+     */
+    getHintText(): Promise<string>;
+    /**
+     * Gets the label text.
+     */
+    getLabelText(): Promise<string>;
+    /**
+     * Gets the link upload aria-label.
+     */
+    getLinkUploadAriaLabel(): Promise<string | null>;
+    /**
+     * Gets the link upload hint text.
+     */
+    getLinkUploadHintText(): Promise<string | undefined>;
+    /**
+     * Whether a custom form error has fired.
+     */
+    hasCustomError(errorName: string): Promise<boolean>;
+    /**
+     * Whether the file type error has fired.
+     */
+    hasFileTypeError(): Promise<boolean>;
+    /**
+     * Whether the max file size error has fired.
+     */
+    hasMaxFileSizeError(): Promise<boolean>;
+    /**
+     * Whether the min file size error has fired.
+     */
+    hasMinFileSizeError(): Promise<boolean>;
+    /**
+     * Whether the required error has fired.
+     */
+    hasRequiredError(): Promise<boolean>;
+    /**
+     * Whether the validate error from the customer validation has fired.
+     */
+    hasValidateFnError(): Promise<boolean>;
+    /**
+     * Whether label text is hidden.
+     */
+    isLabelHidden(): Promise<boolean>;
+    /**
+     * Whether file drop is required.
+     */
+    isRequired(): Promise<boolean>;
+    /**
+     * Whether file drop has stacked enabled.
+     */
+    isStacked(): Promise<boolean>;
+    /**
+     * Loads a single file.
+     */
+    loadFile(file: File): Promise<void>;
+    /**
+     * Loads multiple files.
+     */
+    loadFiles(files: File[] | null): Promise<void>;
 }

package/testing/modules/file-attachment/file-drop/file-drop-link-upload-harness.d.ts

@@ -0,0 +1,28 @@
+import { SkyComponentHarness } from '@skyux/core/testing';
+/**
+ * Harness for interacting with file drop component's link upload feature in tests.
+ * @internal
+ */
+export declare class SkyFileDropLinkUploadHarness extends SkyComponentHarness {
+    #private;
+    /**
+     * @internal
+     */
+    static hostSelector: string;
+    /**
+     * Clicks the `Done` button
+     */
+    clickDoneButton(): Promise<void>;
+    /**
+     * Enters text into the link upload input.
+     */
+    enterText(link: string): Promise<void>;
+    /**
+     * Gets the link upload aria-label.
+     */
+    getAriaLabel(): Promise<string | null>;
+    /**
+     * Gets the hint text.
+     */
+    getHintText(): Promise<string | undefined>;
+}

package/testing/modules/file-attachment/file-drop/file-drop-link-upload-input-harness.d.ts

@@ -0,0 +1,14 @@
+import { SkyInputHarness } from '@skyux/core/testing';
+/**
+ * Harness to interact with the file drop link upload input harness.
+ */
+export declare class SkyFileDropLinkUploadInputHarness extends SkyInputHarness {
+    /**
+     * @internal
+     */
+    static hostSelector: string;
+    /**
+     * Gets the input aria-label
+     */
+    getAriaLabel(): Promise<string | null>;
+}

package/testing/modules/file-attachment/file-drop/file-item-harness-filters.d.ts

@@ -0,0 +1,10 @@
+import { SkyHarnessFilters } from '@skyux/core/testing';
+/**
+ * A set of criteria that can be used to filter a list of `SkyFileItemHarness` instances.
+ */
+export interface SkyFileItemHarnessFilters extends SkyHarnessFilters {
+    /**
+     * Finds files whose file name matches this value.
+     */
+    fileName: string;
+}

package/testing/modules/file-attachment/file-drop/file-item-harness.d.ts

@@ -0,0 +1,28 @@
+import { ComponentHarness, HarnessPredicate } from '@angular/cdk/testing';
+import { SkyFileItemHarnessFilters } from './file-item-harness-filters';
+/**
+ * Harness for interacting with a file item component in tests.
+ */
+export declare class SkyFileItemHarness extends ComponentHarness {
+    /**
+     * @internal
+     */
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a
+     * `SkyFileItemHarness` that meets certain criteria.
+     */
+    static with(filters: SkyFileItemHarnessFilters): HarnessPredicate<SkyFileItemHarness>;
+    /**
+     * Clicks the delete button.
+     */
+    clickDeleteButton(): Promise<void>;
+    /**
+     * Gets the file name.
+     */
+    getFileName(): Promise<string>;
+    /**
+     * Gets the file size.
+     */
+    getFileSize(): Promise<string>;
+}

package/testing/public-api.d.ts

@@ -13,6 +13,8 @@ export { SkyFileAttachmentHarnessFilters } from './modules/file-attachment/file-
 export { SkyFileDropHarness } from './modules/file-attachment/file-drop/file-drop-harness';
 export { SkyFileDropHarnessFilters } from './modules/file-attachment/file-drop/file-drop-harness-filters';
 export { provideSkyFileAttachmentTesting } from './modules/file-attachment/shared/provide-file-attachment-testing';
+export { SkyFileItemHarness } from './modules/file-attachment/file-drop/file-item-harness';
+export { SkyFileItemHarnessFilters } from './modules/file-attachment/file-drop/file-item-harness-filters';
 export { SkyFormErrorsHarness } from './modules/form-error/form-errors-harness';
 export { SkyFormErrorsHarnessFilters } from './modules/form-error/form-errors-harness.filters';
 export { SkyFormErrorHarness } from './modules/form-error/form-error-harness';