@skyux/forms 10.0.0-alpha.1 → 10.0.0-alpha.3

package/index.d.ts

@@ -2,6 +2,7 @@ export { SkyCharacterCounterModule } from './lib/modules/character-counter/chara
 export { SkyCheckboxChange } from './lib/modules/checkbox/checkbox-change';
 export { SkyCheckboxModule } from './lib/modules/checkbox/checkbox.module';
 export { SkyFormErrorsModule } from './lib/modules/form-error/form-errors.module';
+export { SkyFormErrorModule } from './lib/modules/form-error/form-error.module';
 export { SkyFileAttachmentsModule } from './lib/modules/file-attachment/file-attachments.module';
 export { SkyFileItem } from './lib/modules/file-attachment/file-item';
 export { SkyFileItemErrorType } from './lib/modules/file-attachment/file-item-error-type';
@@ -21,8 +22,10 @@ export { SkySelectionBoxGridAlignItems } from './lib/modules/selection-box/types
 export { SkySelectionBoxGridAlignItemsType } from './lib/modules/selection-box/types/selection-box-grid-align-items-type';
 export { SkyToggleSwitchModule } from './lib/modules/toggle-switch/toggle-switch.module';
 export { SkyToggleSwitchChange } from './lib/modules/toggle-switch/types/toggle-switch-change';
+export { SKY_FORM_ERRORS_ENABLED } from './lib/modules/form-error/form-errors-enabled-token';
 export { SkyCharacterCounterIndicatorComponent as λ1 } from './lib/modules/character-counter/character-counter-indicator.component';
 export { SkyCharacterCounterInputDirective as λ2 } from './lib/modules/character-counter/character-counter.directive';
+export { SkyCharacterCounterScreenReaderPipe as λ23 } from './lib/modules/character-counter/character-counter-screen-reader.pipe';
 export { SkyCheckboxLabelComponent as λ4 } from './lib/modules/checkbox/checkbox-label.component';
 export { SkyCheckboxComponent as λ3 } from './lib/modules/checkbox/checkbox.component';
 export { SkyFileAttachmentLabelComponent as λ6 } from './lib/modules/file-attachment/file-attachment-label.component';
@@ -30,6 +33,7 @@ export { SkyFileAttachmentComponent as λ7 } from './lib/modules/file-attachment
 export { SkyFileDropComponent as λ8 } from './lib/modules/file-attachment/file-drop.component';
 export { SkyFileItemComponent as λ9 } from './lib/modules/file-attachment/file-item.component';
 export { SkyFormErrorsComponent as λ21 } from './lib/modules/form-error/form-errors.component';
+export { SkyFormErrorComponent as λ22 } from './lib/modules/form-error/form-error.component';
 export { SkyInputBoxControlDirective as λ20 } from './lib/modules/input-box/input-box-control.directive';
 export { SkyInputBoxComponent as λ10 } from './lib/modules/input-box/input-box.component';
 export { SkyRadioGroupComponent as λ11 } from './lib/modules/radio/radio-group.component';

package/lib/modules/character-counter/character-counter-screen-reader.pipe.d.ts

@@ -0,0 +1,8 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class SkyCharacterCounterScreenReaderPipe implements PipeTransform {
+    #private;
+    transform(characterCount: number | undefined, characterCountLimit: number | undefined): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SkyCharacterCounterScreenReaderPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<SkyCharacterCounterScreenReaderPipe, "skyCharacterCounterScreenReader", true>;
+}

package/lib/modules/character-counter/character-counter.module.d.ts

@@ -3,9 +3,10 @@ import * as i1 from "./character-counter.directive";
 import * as i2 from "./character-counter-indicator.component";
 import * as i3 from "@angular/common";
 import * as i4 from "@angular/forms";
-import * as i5 from "../shared/sky-forms-resources.module";
+import * as i5 from "./character-counter-screen-reader.pipe";
+import * as i6 from "../shared/sky-forms-resources.module";
 export declare class SkyCharacterCounterModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyCharacterCounterModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<SkyCharacterCounterModule, [typeof i1.SkyCharacterCounterInputDirective, typeof i2.SkyCharacterCounterIndicatorComponent], [typeof i3.CommonModule, typeof i4.FormsModule, typeof i4.ReactiveFormsModule, typeof i5.SkyFormsResourcesModule], [typeof i1.SkyCharacterCounterInputDirective, typeof i2.SkyCharacterCounterIndicatorComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SkyCharacterCounterModule, [typeof i1.SkyCharacterCounterInputDirective, typeof i2.SkyCharacterCounterIndicatorComponent], [typeof i3.CommonModule, typeof i4.FormsModule, typeof i4.ReactiveFormsModule, typeof i5.SkyCharacterCounterScreenReaderPipe, typeof i6.SkyFormsResourcesModule], [typeof i1.SkyCharacterCounterInputDirective, typeof i2.SkyCharacterCounterIndicatorComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<SkyCharacterCounterModule>;
 }

package/lib/modules/checkbox/checkbox-label-text-label.component.d.ts

@@ -0,0 +1,12 @@
+import * as i0 from "@angular/core";
+/**
+@internal
+ */
+export declare class SkyCheckboxLabelTextLabelComponent {
+    #private;
+    labelHidden: boolean;
+    set labelText(value: string);
+    get labelText(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SkyCheckboxLabelTextLabelComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkyCheckboxLabelTextLabelComponent, "sky-checkbox-label-text-label", never, { "labelHidden": { "alias": "labelHidden"; "required": false; }; "labelText": { "alias": "labelText"; "required": false; }; }, {}, never, never, false, never>;
+}

package/lib/modules/checkbox/checkbox-label.component.d.ts

@@ -3,6 +3,7 @@ import * as i0 from "@angular/core";
  * Specifies a label for the checkbox. To display a help button beside the label, include a help button element, such as
  * `sky-help-inline`, in the `sky-checkbox-label` element and a `sky-control-help` CSS class on that help button
  * element.
+ * @deprecated Use `labelText` input on `sky-checkbox-component` instead.
  */
 export declare class SkyCheckboxLabelComponent {
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyCheckboxLabelComponent, never>;

package/lib/modules/checkbox/checkbox.component.d.ts

@@ -1,5 +1,5 @@
 import { ElementRef, EventEmitter, OnInit } from '@angular/core';
-import { ControlValueAccessor } from '@angular/forms';
+import { ControlValueAccessor, NgControl } from '@angular/forms';
 import { Observable } from 'rxjs';
 import { SkyCheckboxChange } from './checkbox-change';
 import * as i0 from "@angular/core";
@@ -14,15 +14,19 @@ export declare class SkyCheckboxComponent implements ControlValueAccessor, OnIni
      * [to support accessibility](https://developer.blackbaud.com/skyux/components/checkbox#accessibility)
      * when the checkbox does not include a visible label. You must set this property for icon
      * checkboxes. If the checkbox includes a visible label, use `labelledBy` instead.
+     * @deprecated Use `labelText` instead.
      */
-    label: string | undefined;
+    set label(value: string | undefined);
+    get label(): string | undefined;
     /**
      * The HTML element ID of the element that labels the
      * checkbox. This sets the checkbox's `aria-labelledby` attribute
      * [to support accessibility](https://developer.blackbaud.com/skyux/components/checkbox#accessibility).
      * If the checkbox does not include a visible label, use `label` instead.
+     * @deprecated Use `labelText` instead.
      */
-    labelledBy: string | undefined;
+    set labelledBy(value: string | undefined);
+    get labelledBy(): string | undefined;
     /**
      * The ID for the checkbox.
      * If a value is not provided, an autogenerated ID is used.
@@ -97,8 +101,14 @@ export declare class SkyCheckboxComponent implements ControlValueAccessor, OnIni
     /**
      * The text to display as the checkbox's label. Use this instead of the `sky-checkbox-label` when the label is text-only.
      * Specifying `labelText` also enables automatic error message handling for checkbox.
+     * @preview
      */
     labelText: string | undefined;
+    /**
+     * Indicates whether to hide the `labelText`.
+     * @preview
+     */
+    labelHidden: boolean;
     /**
      * Fires when users select or deselect the checkbox.
      */
@@ -115,6 +125,8 @@ export declare class SkyCheckboxComponent implements ControlValueAccessor, OnIni
     set inputEl(el: ElementRef | undefined);
     get inputEl(): ElementRef | undefined;
     protected inputId: string;
+    protected readonly ngControl: NgControl | null;
+    protected readonly errorId: string;
     constructor();
     ngOnInit(): void;
     /**
@@ -142,5 +154,5 @@ export declare class SkyCheckboxComponent implements ControlValueAccessor, OnIni
     /** Called when the checkbox is blurred. Needed to properly implement ControlValueAccessor. */
     onTouched: () => any;
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyCheckboxComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SkyCheckboxComponent, "sky-checkbox", never, { "label": { "alias": "label"; "required": false; }; "labelledBy": { "alias": "labelledBy"; "required": false; }; "id": { "alias": "id"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "tabindex": { "alias": "tabindex"; "required": false; }; "name": { "alias": "name"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "checkboxType": { "alias": "checkboxType"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; "indeterminate": { "alias": "indeterminate"; "required": false; }; "required": { "alias": "required"; "required": false; }; "labelText": { "alias": "labelText"; "required": false; }; }, { "change": "change"; "checkedChange": "checkedChange"; "disabledChange": "disabledChange"; "indeterminateChange": "indeterminateChange"; }, never, ["sky-checkbox-label"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkyCheckboxComponent, "sky-checkbox", never, { "label": { "alias": "label"; "required": false; }; "labelledBy": { "alias": "labelledBy"; "required": false; }; "id": { "alias": "id"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "tabindex": { "alias": "tabindex"; "required": false; }; "name": { "alias": "name"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "checkboxType": { "alias": "checkboxType"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; "indeterminate": { "alias": "indeterminate"; "required": false; }; "required": { "alias": "required"; "required": false; }; "labelText": { "alias": "labelText"; "required": false; }; "labelHidden": { "alias": "labelHidden"; "required": false; }; }, { "change": "change"; "checkedChange": "checkedChange"; "disabledChange": "disabledChange"; "indeterminateChange": "indeterminateChange"; }, never, ["sky-checkbox-label", "sky-form-error"], false, never>;
 }

package/lib/modules/checkbox/checkbox.module.d.ts

@@ -1,12 +1,16 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./checkbox.component";
 import * as i2 from "./checkbox-label.component";
-import * as i3 from "@angular/common";
-import * as i4 from "@angular/forms";
-import * as i5 from "@skyux/indicators";
-import * as i6 from "@skyux/core";
+import * as i3 from "./checkbox-label-text-label.component";
+import * as i4 from "@angular/common";
+import * as i5 from "@angular/forms";
+import * as i6 from "../form-error/form-error.module";
+import * as i7 from "../form-error/form-errors.module";
+import * as i8 from "../shared/sky-forms-resources.module";
+import * as i9 from "@skyux/indicators";
+import * as i10 from "@skyux/core";
 export declare class SkyCheckboxModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyCheckboxModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<SkyCheckboxModule, [typeof i1.SkyCheckboxComponent, typeof i2.SkyCheckboxLabelComponent], [typeof i3.CommonModule, typeof i4.FormsModule, typeof i5.SkyIconModule, typeof i6.SkyTrimModule], [typeof i1.SkyCheckboxComponent, typeof i2.SkyCheckboxLabelComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SkyCheckboxModule, [typeof i1.SkyCheckboxComponent, typeof i2.SkyCheckboxLabelComponent, typeof i3.SkyCheckboxLabelTextLabelComponent], [typeof i4.CommonModule, typeof i5.FormsModule, typeof i6.SkyFormErrorModule, typeof i7.SkyFormErrorsModule, typeof i8.SkyFormsResourcesModule, typeof i9.SkyIconModule, typeof i10.SkyTrimModule], [typeof i1.SkyCheckboxComponent, typeof i2.SkyCheckboxLabelComponent, typeof i6.SkyFormErrorModule]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<SkyCheckboxModule>;
 }

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

@@ -3,11 +3,13 @@ import * as i0 from "@angular/core";
  * Displays a label above the file attachment element. To display a help button beside the label, include a help button
  * element, such as `sky-help-inline`, in the `sky-file-attachment-label` element and a `sky-control-help` CSS class on
  * that help button element.
+ * @deprecated use the `labelText` input on the single file attachment component instead.
  */
 export declare class SkyFileAttachmentLabelComponent {
     labelContentId: {
         id: string;
     } | undefined;
+    constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyFileAttachmentLabelComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<SkyFileAttachmentLabelComponent, "sky-file-attachment-label", never, {}, {}, never, ["*", ".sky-control-help"], false, never>;
 }

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

@@ -27,6 +27,16 @@ export declare class SkyFileAttachmentComponent implements AfterViewInit, AfterC
      */
     set disabled(value: boolean | undefined);
     get disabled(): boolean;
+    /**
+     * The text to display as the file attachment's label.
+     * @preview
+     */
+    labelText: string | undefined;
+    /**
+     * Whether to hide `labelText` from view.
+     * @preview
+     */
+    labelHidden: boolean;
     /**
      * The maximum size in bytes for valid files.
      * @default 500000
@@ -98,5 +108,5 @@ export declare class SkyFileAttachmentComponent implements AfterViewInit, AfterC
     setDisabledState(isDisabled: boolean): void;
     emitClick(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyFileAttachmentComponent, [null, null, null, { optional: true; self: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SkyFileAttachmentComponent, "sky-file-attachment", never, { "acceptedTypes": { "alias": "acceptedTypes"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "maxFileSize": { "alias": "maxFileSize"; "required": false; }; "minFileSize": { "alias": "minFileSize"; "required": false; }; "validateFn": { "alias": "validateFn"; "required": false; }; "required": { "alias": "required"; "required": false; }; }, { "fileChange": "fileChange"; "fileClick": "fileClick"; }, ["labelComponents"], ["sky-file-attachment-label"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkyFileAttachmentComponent, "sky-file-attachment", never, { "acceptedTypes": { "alias": "acceptedTypes"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "labelText": { "alias": "labelText"; "required": false; }; "labelHidden": { "alias": "labelHidden"; "required": false; }; "maxFileSize": { "alias": "maxFileSize"; "required": false; }; "minFileSize": { "alias": "minFileSize"; "required": false; }; "validateFn": { "alias": "validateFn"; "required": false; }; "required": { "alias": "required"; "required": false; }; }, { "fileChange": "fileChange"; "fileClick": "fileClick"; }, ["labelComponents"], ["sky-file-attachment-label"], false, never>;
 }

package/lib/modules/file-attachment/types/file-drop-change.d.ts

@@ -3,9 +3,9 @@ export interface SkyFileDropChange {
     /**
      * The array of files that were added or removed.
      */
-    files: Array<SkyFileItem>;
+    files: SkyFileItem[];
     /**
      * The array of files that were rejected.
      */
-    rejectedFiles: Array<SkyFileItem>;
+    rejectedFiles: SkyFileItem[];
 }

package/lib/modules/form-error/form-error.component.d.ts

@@ -1,9 +1,23 @@
 import * as i0 from "@angular/core";
 /**
- * @internal
+ * Displays default and custom form field error messages for form field components.
+ * Set `labelText` on the form field component to automatically display required,
+ * maximum length, minimum length, date, email, phone number, time, and URL errors.
+ * To display custom errors, include sky-form-error elements in the form field component.
  */
 export declare class SkyFormErrorComponent {
-    protected readonly cssClass = "sky-form-error-indicator";
+    /**
+     * The name of the error.
+     * @required
+     */
+    errorName: string;
+    /**
+     * The error message to display.
+     * @required
+     */
+    errorText: string;
+    protected readonly formErrors: boolean | null;
+    constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyFormErrorComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SkyFormErrorComponent, "sky-form-error", never, {}, {}, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkyFormErrorComponent, "sky-form-error", never, { "errorName": { "alias": "errorName"; "required": true; }; "errorText": { "alias": "errorText"; "required": true; }; }, {}, never, never, true, never>;
 }

package/lib/modules/form-error/form-error.module.d.ts

@@ -0,0 +1,7 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./form-error.component";
+export declare class SkyFormErrorModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<SkyFormErrorModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SkyFormErrorModule, never, [typeof i1.SkyFormErrorComponent], [typeof i1.SkyFormErrorComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<SkyFormErrorModule>;
+}

package/lib/modules/form-error/form-errors-enabled-token.d.ts

@@ -0,0 +1,5 @@
+import { InjectionToken } from '@angular/core';
+/**
+ * @internal
+ */
+export declare const SKY_FORM_ERRORS_ENABLED: InjectionToken<boolean>;

package/lib/modules/form-error/form-errors.module.d.ts

@@ -1,10 +1,11 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./form-errors.component";
+import * as i2 from "./form-error.component";
 /**
  * @internal
  */
 export declare class SkyFormErrorsModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyFormErrorsModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<SkyFormErrorsModule, never, [typeof i1.SkyFormErrorsComponent], [typeof i1.SkyFormErrorsComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SkyFormErrorsModule, never, [typeof i1.SkyFormErrorsComponent, typeof i2.SkyFormErrorComponent], [typeof i1.SkyFormErrorsComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<SkyFormErrorsModule>;
 }

package/lib/modules/input-box/input-box-hint-text.pipe.d.ts

@@ -0,0 +1,10 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * @internal
+ */
+export declare class SkyInputBoxHintTextPipe implements PipeTransform {
+    transform(hintText?: string, hostHintText?: string): string | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SkyInputBoxHintTextPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<SkyInputBoxHintTextPipe, "skyInputBoxHintText", true>;
+}

package/lib/modules/input-box/input-box-host.service.d.ts

@@ -12,6 +12,8 @@ export declare class SkyInputBoxHostService {
     get ariaDescribedBy(): Observable<string | undefined> | undefined;
     init(host: SkyInputBoxComponent): void;
     populate(args: SkyInputBoxPopulateArgs): void;
+    setHintText(hintText: string | undefined): void;
+    setHintTextHidden(hide: boolean): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyInputBoxHostService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SkyInputBoxHostService>;
 }

package/lib/modules/input-box/input-box.component.d.ts

@@ -64,6 +64,8 @@ export declare class SkyInputBoxComponent implements OnInit, AfterContentChecked
     formControlHasFocus: boolean;
     hostIconsInsetTemplate: TemplateRef<unknown> | undefined;
     hostIconsInsetLeftTemplate: TemplateRef<unknown> | undefined;
+    protected hintTextHidden: boolean;
+    protected hostHintText: string | undefined;
     readonly controlId: string;
     readonly errorId: string;
     readonly hintTextId: string;
@@ -77,6 +79,7 @@ export declare class SkyInputBoxComponent implements OnInit, AfterContentChecked
     protected helpPopoverOpen: boolean | undefined;
     protected get hasErrorsComputed(): boolean;
     protected get required(): boolean;
+    protected characterCountScreenReader: number;
     ngOnInit(): void;
     ngAfterContentChecked(): void;
     ngOnDestroy(): void;
@@ -84,6 +87,8 @@ export declare class SkyInputBoxComponent implements OnInit, AfterContentChecked
     formControlFocusOut(): void;
     onInsetIconClick(): void;
     populate(args: SkyInputBoxPopulateArgs): void;
+    setHintTextHidden(hide: boolean): void;
+    setHostHintText(value: string | undefined): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyInputBoxComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SkyInputBoxComponent, "sky-input-box", never, { "hasErrors": { "alias": "hasErrors"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "labelText": { "alias": "labelText"; "required": false; }; "characterLimit": { "alias": "characterLimit"; "required": false; }; "stacked": { "alias": "stacked"; "required": false; }; "helpPopoverTitle": { "alias": "helpPopoverTitle"; "required": false; }; "helpPopoverContent": { "alias": "helpPopoverContent"; "required": false; }; "hintText": { "alias": "hintText"; "required": false; }; }, {}, ["formControl", "formControlByName", "ngModel", "inputRef"], [".sky-control-label", ".sky-control-help", "sky-character-counter-indicator", "input,select,.sky-form-control:not(textarea),sky-text-editor", "textarea", ".sky-input-group-btn.sky-input-box-btn-left", ".sky-input-group-btn:not(.sky-input-box-btn-left):not(.sky-input-box-btn-inset)", ".sky-input-group-btn.sky-input-box-btn-inset", ".sky-input-group-icon.sky-input-box-icon-inset", ".sky-input-group-icon.sky-input-box-icon-inset-left", ".sky-error-label,.sky-error-indicator"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkyInputBoxComponent, "sky-input-box", never, { "hasErrors": { "alias": "hasErrors"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "labelText": { "alias": "labelText"; "required": false; }; "characterLimit": { "alias": "characterLimit"; "required": false; }; "stacked": { "alias": "stacked"; "required": false; }; "helpPopoverTitle": { "alias": "helpPopoverTitle"; "required": false; }; "helpPopoverContent": { "alias": "helpPopoverContent"; "required": false; }; "hintText": { "alias": "hintText"; "required": false; }; }, {}, ["formControl", "formControlByName", "ngModel", "inputRef"], [".sky-control-label", ".sky-control-help", "sky-character-counter-indicator", "input,select,.sky-form-control:not(textarea),sky-text-editor", "textarea", ".sky-input-group-btn.sky-input-box-btn-left", ".sky-input-group-btn:not(.sky-input-box-btn-left):not(.sky-input-box-btn-inset)", ".sky-input-group-btn.sky-input-box-btn-inset", ".sky-input-group-icon.sky-input-box-icon-inset", ".sky-input-group-icon.sky-input-box-icon-inset-left", "sky-form-error", ".sky-error-label,.sky-error-indicator"], false, never>;
 }

package/lib/modules/input-box/input-box.module.d.ts

@@ -2,12 +2,15 @@ import * as i0 from "@angular/core";
 import * as i1 from "./input-box.component";
 import * as i2 from "@angular/common";
 import * as i3 from "../character-counter/character-counter.module";
-import * as i4 from "../form-error/form-errors.component";
-import * as i5 from "./input-box-control.directive";
-import * as i6 from "./input-box-help-inline.component";
-import * as i7 from "@skyux/theme";
+import * as i4 from "../form-error/form-errors.module";
+import * as i5 from "../form-error/form-error.module";
+import * as i6 from "../shared/sky-forms-resources.module";
+import * as i7 from "./input-box-control.directive";
+import * as i8 from "./input-box-help-inline.component";
+import * as i9 from "./input-box-hint-text.pipe";
+import * as i10 from "@skyux/theme";
 export declare class SkyInputBoxModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyInputBoxModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<SkyInputBoxModule, [typeof i1.SkyInputBoxComponent], [typeof i2.CommonModule, typeof i3.SkyCharacterCounterModule, typeof i4.SkyFormErrorsComponent, typeof i5.SkyInputBoxControlDirective, typeof i6.SkyInputBoxHelpInlineComponent, typeof i7.SkyThemeModule], [typeof i1.SkyInputBoxComponent, typeof i5.SkyInputBoxControlDirective]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SkyInputBoxModule, [typeof i1.SkyInputBoxComponent], [typeof i2.CommonModule, typeof i3.SkyCharacterCounterModule, typeof i4.SkyFormErrorsModule, typeof i5.SkyFormErrorModule, typeof i6.SkyFormsResourcesModule, typeof i7.SkyInputBoxControlDirective, typeof i8.SkyInputBoxHelpInlineComponent, typeof i9.SkyInputBoxHintTextPipe, typeof i10.SkyThemeModule], [typeof i1.SkyInputBoxComponent, typeof i7.SkyInputBoxControlDirective, typeof i5.SkyFormErrorModule]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<SkyInputBoxModule>;
 }

package/lib/modules/radio/radio-group.component.d.ts

@@ -17,16 +17,20 @@ export declare class SkyRadioGroupComponent implements AfterContentInit, AfterVi
      * [to support accessibility](https://developer.blackbaud.com/skyux/learn/accessibility).
      * If the radio button group does not include a visible label, use `ariaLabel` instead.
      * For more information about the `aria-labelledby` attribute, see the [WAI-ARIA definition](https://www.w3.org/TR/wai-aria/#aria-labelledby).
+     * @deprecated Use `labelText` instead.
      */
-    ariaLabelledBy: string | undefined;
+    set ariaLabelledBy(value: string | undefined);
+    get ariaLabelledBy(): string | undefined;
     /**
      * The ARIA label for the radio button group. This sets the
      * radio button group's `aria-label` attribute to provide a text equivalent for screen readers
      * [to support accessibility](https://developer.blackbaud.com/skyux/learn/accessibility).
      * If the radio button group includes a visible label, use `ariaLabelledBy` instead.
      * For more information about the `aria-label` attribute, see the [WAI-ARIA definition](https://www.w3.org/TR/wai-aria/#aria-label).
+     * @deprecated Use `labelText` instead.
      */
-    ariaLabel: string | undefined;
+    set ariaLabel(value: string | undefined);
+    get ariaLabel(): string | undefined;
     /**
      * Whether to disable the input on template-driven forms. Don't use this input on reactive forms because they may overwrite the input or leave the control out of sync.
      * To set the disabled state on reactive forms, use the `FormControl` instead.
@@ -66,6 +70,16 @@ export declare class SkyRadioGroupComponent implements AfterContentInit, AfterVi
      */
     set tabIndex(value: number | undefined);
     get tabIndex(): number | undefined;
+    /**
+     * The text to display as the radio group's label.
+     * @preview
+     */
+    labelText: string | undefined;
+    /**
+     * Indicates whether to hide the `labelText`.
+     * @preview
+     */
+    labelHidden: boolean;
     /**
      * Our radio components are usually implemented using an unordered list. This is an
      * accessibility violation because the unordered list has an implicit role which
@@ -75,6 +89,8 @@ export declare class SkyRadioGroupComponent implements AfterContentInit, AfterVi
      */
     ariaOwns: string | undefined;
     radios: QueryList<SkyRadioComponent> | undefined;
+    protected errorId: string;
+    protected ngControl: NgControl | undefined;
     constructor(changeDetector: ChangeDetectorRef, radioGroupIdSvc: SkyRadioGroupIdService, ngControl: NgControl);
     ngAfterContentInit(): void;
     ngAfterViewInit(): void;
@@ -89,5 +105,5 @@ export declare class SkyRadioGroupComponent implements AfterContentInit, AfterVi
     registerOnChange(fn: (value: any) => void): void;
     registerOnTouched(fn: any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyRadioGroupComponent, [null, null, { optional: true; self: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SkyRadioGroupComponent, "sky-radio-group", never, { "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "name": { "alias": "name"; "required": false; }; "required": { "alias": "required"; "required": false; }; "value": { "alias": "value"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; }, {}, ["radios"], ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkyRadioGroupComponent, "sky-radio-group", never, { "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "name": { "alias": "name"; "required": false; }; "required": { "alias": "required"; "required": false; }; "value": { "alias": "value"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "labelText": { "alias": "labelText"; "required": false; }; "labelHidden": { "alias": "labelHidden"; "required": false; }; }, {}, ["radios"], ["*", "sky-form-error"], false, never>;
 }

package/lib/modules/radio/radio.module.d.ts

@@ -4,10 +4,13 @@ import * as i2 from "./radio-group.component";
 import * as i3 from "./radio-label.component";
 import * as i4 from "@angular/common";
 import * as i5 from "@angular/forms";
-import * as i6 from "@skyux/indicators";
-import * as i7 from "@skyux/core";
+import * as i6 from "../form-error/form-error.module";
+import * as i7 from "../form-error/form-errors.module";
+import * as i8 from "@skyux/indicators";
+import * as i9 from "@skyux/core";
+import * as i10 from "../shared/sky-forms-resources.module";
 export declare class SkyRadioModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyRadioModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<SkyRadioModule, [typeof i1.SkyRadioComponent, typeof i2.SkyRadioGroupComponent, typeof i3.SkyRadioLabelComponent], [typeof i4.CommonModule, typeof i5.FormsModule, typeof i6.SkyIconModule, typeof i7.SkyTrimModule], [typeof i1.SkyRadioComponent, typeof i2.SkyRadioGroupComponent, typeof i3.SkyRadioLabelComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SkyRadioModule, [typeof i1.SkyRadioComponent, typeof i2.SkyRadioGroupComponent, typeof i3.SkyRadioLabelComponent], [typeof i4.CommonModule, typeof i5.FormsModule, typeof i6.SkyFormErrorModule, typeof i7.SkyFormErrorsModule, typeof i8.SkyIconModule, typeof i9.SkyIdModule, typeof i10.SkyFormsResourcesModule, typeof i9.SkyTrimModule], [typeof i6.SkyFormErrorModule, typeof i1.SkyRadioComponent, typeof i2.SkyRadioGroupComponent, typeof i3.SkyRadioLabelComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<SkyRadioModule>;
 }

package/lib/modules/toggle-switch/toggle-switch-label.component.d.ts

@@ -3,8 +3,10 @@ import * as i0 from "@angular/core";
  * Specifies the label to display beside the toggle switch. To display a help button beside the label, include a help
  * button element, such as `sky-help-inline`, in the `sky-toggle-switch` element and a `sky-control-help` CSS class on
  * that help button element.
+ * @deprecated Use the `labelText` input on the toggle switch component instead.
  */
 export declare class SkyToggleSwitchLabelComponent {
+    constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyToggleSwitchLabelComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<SkyToggleSwitchLabelComponent, "sky-toggle-switch-label", never, {}, {}, never, ["*"], false, never>;
 }

package/lib/modules/toggle-switch/toggle-switch.component.d.ts

@@ -12,8 +12,10 @@ export declare class SkyToggleSwitchComponent implements AfterContentInit, OnDes
      * Use a context-sensitive label, such as "Activate annual fundraiser" for a toggle switch that activates and deactivates an annual fundraiser. Context is especially important if multiple toggle switches are in close proximity.
      * When the `sky-toggle-switch-label` component displays a visible label, this property is only necessary if that label requires extra context.
      * For more information about the `aria-label` attribute, see the [WAI-ARIA definition](https://www.w3.org/TR/wai-aria/#aria-label).
+     * @deprecated Use the `labelText` input instead.
      */
-    ariaLabel: string | undefined;
+    set ariaLabel(value: string | undefined);
+    get ariaLabel(): string | undefined;
     /**
      * Whether the toggle switch is selected.
      * @default false
@@ -30,6 +32,16 @@ export declare class SkyToggleSwitchComponent implements AfterContentInit, OnDes
      * of the toggle switch on load.
      */
     tabIndex: number | undefined;
+    /**
+     * The text to display as the toggle switch's label.
+     * @preview
+     */
+    labelText: string | undefined;
+    /**
+     * Whether to hide `labelText` from view.
+     * @preview
+     */
+    labelHidden: boolean;
     /**
      * Fires when the checked state of a toggle switch changes.
      */
@@ -49,5 +61,5 @@ export declare class SkyToggleSwitchComponent implements AfterContentInit, OnDes
     onButtonClick(event: any): void;
     onButtonBlur(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyToggleSwitchComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SkyToggleSwitchComponent, "sky-toggle-switch", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; }, { "toggleChange": "toggleChange"; }, ["labelComponents"], [".sky-control-help", "sky-toggle-switch-label"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkyToggleSwitchComponent, "sky-toggle-switch", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "labelText": { "alias": "labelText"; "required": false; }; "labelHidden": { "alias": "labelHidden"; "required": false; }; }, { "toggleChange": "toggleChange"; }, ["labelComponents"], [".sky-control-help", "sky-toggle-switch-label"], false, never>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyux/forms",
-  "version": "10.0.0-alpha.1",
+  "version": "10.0.0-alpha.3",
   "author": "Blackbaud, Inc.",
   "keywords": [
     "blackbaud",
@@ -36,17 +36,17 @@
     }
   },
   "peerDependencies": {
-    "@angular/cdk": "^17.1.0",
-    "@angular/common": "^17.1.0",
-    "@angular/core": "^17.1.0",
-    "@angular/forms": "^17.1.0",
-    "@angular/platform-browser": "^17.1.0",
-    "@skyux-sdk/testing": "10.0.0-alpha.1",
-    "@skyux/core": "10.0.0-alpha.1",
-    "@skyux/i18n": "10.0.0-alpha.1",
-    "@skyux/indicators": "10.0.0-alpha.1",
-    "@skyux/popovers": "10.0.0-alpha.1",
-    "@skyux/theme": "10.0.0-alpha.1"
+    "@angular/cdk": "^17.1.1",
+    "@angular/common": "^17.1.1",
+    "@angular/core": "^17.1.1",
+    "@angular/forms": "^17.1.1",
+    "@angular/platform-browser": "^17.1.1",
+    "@skyux-sdk/testing": "10.0.0-alpha.3",
+    "@skyux/core": "10.0.0-alpha.3",
+    "@skyux/i18n": "10.0.0-alpha.3",
+    "@skyux/indicators": "10.0.0-alpha.3",
+    "@skyux/popovers": "10.0.0-alpha.3",
+    "@skyux/theme": "10.0.0-alpha.3"
   },
   "dependencies": {
     "tslib": "^2.6.2"

package/testing/checkbox/checkbox-harness.d.ts

@@ -37,9 +37,14 @@ export declare class SkyCheckboxHarness extends SkyComponentHarness {
      */
     getAriaLabelledby(): Promise<string | null>;
     /**
-     * Gets the checkbox's label text.
+     * Gets the checkbox's label text. If the label is set via `labelText` and `labelHidden` is true,
+     * the text will still be returned.
      */
     getLabelText(): Promise<string | undefined>;
+    /**
+     * Whether the label is hidden. Only supported when using the `labelText` input to set the label.
+     */
+    getLabelHidden(): Promise<boolean>;
     /**
      * Gets the checkbox's name.
      */
@@ -68,4 +73,6 @@ export declare class SkyCheckboxHarness extends SkyComponentHarness {
      * Puts the checkbox in an unchecked state by toggling it if it is currently checked, or doing nothing if it is already unchecked.
      */
     uncheck(): Promise<void>;
+    hasRequiredError(): Promise<boolean>;
+    hasCustomError(errorName: string): Promise<boolean>;
 }

package/testing/checkbox/checkbox-label-text-label.harness.d.ts

@@ -0,0 +1,16 @@
+import { ComponentHarness } from '@angular/cdk/testing';
+/**
+ * Harness for interacting with a `labelText` checkbox label component in tests.
+ * @internal
+ */
+export declare class SkyCheckboxLabelTextLabelHarness extends ComponentHarness {
+    #private;
+    /**
+     * @internal
+     */
+    static hostSelector: string;
+    /**
+     * Gets the text content of the `labelText` checkbox label.
+     */
+    getText(): Promise<string | undefined>;
+}

package/testing/form-error/form-error-harness.d.ts

@@ -2,7 +2,6 @@ import { HarnessPredicate } from '@angular/cdk/testing';
 import { SkyComponentHarness } from '@skyux/core/testing';
 import { SkyFormErrorHarnessFilters } from './form-error-harness.filters';
 export declare class SkyFormErrorHarness extends SkyComponentHarness {
-    #private;
     /**
      * @internal
      */
@@ -12,5 +11,8 @@ export declare class SkyFormErrorHarness extends SkyComponentHarness {
      * `SkyFormErrorHarness` that meets certain criteria
      */
     static with(filters: SkyFormErrorHarnessFilters): HarnessPredicate<SkyFormErrorHarness>;
-    getFirstClassError(): Promise<string>;
+    /**
+     * Gets the error name.
+     */
+    getErrorName(): Promise<string | null>;
 }

package/testing/form-error/form-errors-harness.d.ts

@@ -2,7 +2,6 @@ import { HarnessPredicate } from '@angular/cdk/testing';
 import { SkyComponentHarness } from '@skyux/core/testing';
 import { SkyFormErrorsHarnessFilters } from './form-errors-harness.filters';
 export declare class SkyFormErrorsHarness extends SkyComponentHarness {
-    #private;
     /**
      * @internal
      */
@@ -12,14 +11,14 @@ export declare class SkyFormErrorsHarness extends SkyComponentHarness {
      * `SkyFormErrorsHarness` that meets certain criteria
      */
     static with(filters: SkyFormErrorsHarnessFilters): HarnessPredicate<SkyFormErrorsHarness>;
-    getNumberOfErrors(): Promise<number>;
-    hasRequiredError(): Promise<boolean>;
-    hasMaxLengthError(): Promise<boolean>;
-    hasMinLengthError(): Promise<boolean>;
-    hasCharacterCountError(): Promise<boolean>;
-    hasDateError(): Promise<boolean>;
-    hasEmailError(): Promise<boolean>;
-    hasPhoneFieldError(): Promise<boolean>;
-    hasTimeError(): Promise<boolean>;
-    hasUrlError(): Promise<boolean>;
+    /**
+     * Gets a list of all errors fired.
+     */
+    getFormErrors(): Promise<{
+        errorName: string | null;
+    }[]>;
+    /**
+     * Whether an error with the given name has fired.
+     */
+    hasError(errorName: string): Promise<boolean>;
 }