@skyux/forms 10.18.0 → 10.19.0

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

@@ -7,7 +7,7 @@ import * as i0 from "@angular/core";
 export declare class SkyCheckboxGroupComponent {
     #private;
     /**
-     * The content of the help popover. When specified along with `labelText`, a [help inline](https://developer.blackbaud.com/skyux/components/help-inline)
+     * The content of the help popover. When specified, a [help inline](https://developer.blackbaud.com/skyux/components/help-inline)
      * button is added to the checkbox group fieldset legend. The help inline button displays a [popover](https://developer.blackbaud.com/skyux/components/popover)
      * when clicked using the specified content and optional title.
      * @preview
@@ -20,15 +20,15 @@ export declare class SkyCheckboxGroupComponent {
      */
     helpPopoverTitle: string | undefined;
     /**
-     * The text to display as the checkbox group's label.
+     * The text to display as the checkbox group's heading.
      * @preview
      */
-    labelText: string;
+    headingText: string;
     /**
-     * Indicates whether to hide the `labelText`.
+     * Indicates whether to hide the `headingText`.
      * @preview
      */
-    labelHidden: boolean;
+    headingHidden: boolean;
     /**
      * [Persistent inline help text](https://developer.blackbaud.com/skyux/design/guidelines/user-assistance#inline-help) that provides
      * additional context to the user.
@@ -51,11 +51,17 @@ export declare class SkyCheckboxGroupComponent {
      * @preview
      */
     formGroup: FormGroup;
+    /**
+     * A help key that identifies the global help content to display. When specified, a [help inline](https://developer.blackbaud.com/skyux/components/help-inline) button is
+     * placed beside the checkbox group heading. Clicking the button invokes global help as configured by the application.
+     * @preview
+     */
+    helpKey: string | undefined;
     protected errorId: string;
     protected formErrorsDataId: string;
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyCheckboxGroupComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SkyCheckboxGroupComponent, "sky-checkbox-group", never, { "helpPopoverContent": { "alias": "helpPopoverContent"; "required": false; }; "helpPopoverTitle": { "alias": "helpPopoverTitle"; "required": false; }; "labelText": { "alias": "labelText"; "required": true; }; "labelHidden": { "alias": "labelHidden"; "required": false; }; "hintText": { "alias": "hintText"; "required": false; }; "required": { "alias": "required"; "required": false; }; "stacked": { "alias": "stacked"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": true; }; }, {}, never, ["sky-checkbox[icon]", "sky-checkbox", "sky-form-error"], true, never>;
-    static ngAcceptInputType_labelHidden: unknown;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkyCheckboxGroupComponent, "sky-checkbox-group", never, { "helpPopoverContent": { "alias": "helpPopoverContent"; "required": false; }; "helpPopoverTitle": { "alias": "helpPopoverTitle"; "required": false; }; "headingText": { "alias": "headingText"; "required": true; }; "headingHidden": { "alias": "headingHidden"; "required": false; }; "hintText": { "alias": "hintText"; "required": false; }; "required": { "alias": "required"; "required": false; }; "stacked": { "alias": "stacked"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": true; }; "helpKey": { "alias": "helpKey"; "required": false; }; }, {}, never, ["sky-checkbox[icon]", "sky-checkbox", "sky-form-error"], true, never>;
+    static ngAcceptInputType_headingHidden: unknown;
     static ngAcceptInputType_required: unknown;
     static ngAcceptInputType_stacked: unknown;
 }

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

@@ -133,6 +133,12 @@ export declare class SkyCheckboxComponent implements ControlValueAccessor, OnIni
      * @preview
      */
     stacked: boolean;
+    /**
+     * A help key that identifies the global help content to display. When specified, a [help inline](https://developer.blackbaud.com/skyux/components/help-inline) button is
+     * placed beside the checkbox label. Clicking the button invokes global help as configured by the application.
+     * @preview
+     */
+    helpKey: string | undefined;
     /**
      * Fires when users select or deselect the checkbox.
      */
@@ -181,7 +187,7 @@ 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; }; "helpPopoverContent": { "alias": "helpPopoverContent"; "required": false; }; "helpPopoverTitle": { "alias": "helpPopoverTitle"; "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; }; "hintText": { "alias": "hintText"; "required": false; }; "stacked": { "alias": "stacked"; "required": false; }; }, { "change": "change"; "checkedChange": "checkedChange"; "disabledChange": "disabledChange"; "indeterminateChange": "indeterminateChange"; }, never, ["sky-checkbox-label", "sky-form-error"], 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; }; "helpPopoverContent": { "alias": "helpPopoverContent"; "required": false; }; "helpPopoverTitle": { "alias": "helpPopoverTitle"; "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; }; "hintText": { "alias": "hintText"; "required": false; }; "stacked": { "alias": "stacked"; "required": false; }; "helpKey": { "alias": "helpKey"; "required": false; }; }, { "change": "change"; "checkedChange": "checkedChange"; "disabledChange": "disabledChange"; "indeterminateChange": "indeterminateChange"; }, never, ["sky-checkbox-label", "sky-form-error"], false, never>;
     static ngAcceptInputType_required: unknown;
     static ngAcceptInputType_labelHidden: unknown;
     static ngAcceptInputType_stacked: unknown;

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

@@ -7,10 +7,10 @@ import * as i0 from "@angular/core";
  */
 export declare class SkyFieldGroupComponent {
     /**
-     * The text to display as the field group's label.
+     * The text to display as the field group's heading.
      * @preview
      */
-    labelText: string;
+    headingText: string;
     /**
      * [Persistent inline help text](https://developer.blackbaud.com/skyux/design/guidelines/user-assistance#inline-help) that provides
      * additional context to the user.
@@ -18,10 +18,10 @@ export declare class SkyFieldGroupComponent {
      */
     hintText: string | undefined;
     /**
-     * Indicates whether to hide the `labelText`.
+     * Indicates whether to hide the `headingText`.
      * @preview
      */
-    labelHidden: boolean;
+    headingHidden: boolean;
     /**
      * Whether the field group is stacked on another field group. When specified, the appropriate
      * vertical spacing is automatically added to the field group.
@@ -39,8 +39,8 @@ export declare class SkyFieldGroupComponent {
      */
     set headingStyle(value: SkyFieldGroupHeadingStyle);
     /**
-     * The content of the help popover. When specified along with `labelText`, a [help inline](https://developer.blackbaud.com/skyux/components/help-inline)
-     * button is added to the field group label. The help inline button displays a [popover](https://developer.blackbaud.com/skyux/components/popover)
+     * The content of the help popover. When specified, a [help inline](https://developer.blackbaud.com/skyux/components/help-inline)
+     * button is added to the field group heading. The help inline button displays a [popover](https://developer.blackbaud.com/skyux/components/popover)
      * when clicked using the specified content and optional title.
      * @preview
      */
@@ -53,14 +53,14 @@ export declare class SkyFieldGroupComponent {
     helpPopoverTitle: string | undefined;
     /**
      * A help key that identifies the global help content to display. When specified, a [help inline](https://developer.blackbaud.com/skyux/components/help-inline) button is
-     * placed beside the field group label. Clicking the button invokes global help as configured by the application.
+     * placed beside the field group heading. Clicking the button invokes global help as configured by the application.
      * @preview
      */
     helpKey: string | undefined;
     protected headingClass: string;
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyFieldGroupComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SkyFieldGroupComponent, "sky-field-group", never, { "labelText": { "alias": "labelText"; "required": true; }; "hintText": { "alias": "hintText"; "required": false; }; "labelHidden": { "alias": "labelHidden"; "required": false; }; "stacked": { "alias": "stacked"; "required": false; }; "headingLevel": { "alias": "headingLevel"; "required": false; }; "headingStyle": { "alias": "headingStyle"; "required": false; }; "helpPopoverContent": { "alias": "helpPopoverContent"; "required": false; }; "helpPopoverTitle": { "alias": "helpPopoverTitle"; "required": false; }; "helpKey": { "alias": "helpKey"; "required": false; }; }, {}, never, ["*"], true, never>;
-    static ngAcceptInputType_labelHidden: unknown;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkyFieldGroupComponent, "sky-field-group", never, { "headingText": { "alias": "headingText"; "required": true; }; "hintText": { "alias": "hintText"; "required": false; }; "headingHidden": { "alias": "headingHidden"; "required": false; }; "stacked": { "alias": "stacked"; "required": false; }; "headingLevel": { "alias": "headingLevel"; "required": false; }; "headingStyle": { "alias": "headingStyle"; "required": false; }; "helpPopoverContent": { "alias": "helpPopoverContent"; "required": false; }; "helpPopoverTitle": { "alias": "helpPopoverTitle"; "required": false; }; "helpKey": { "alias": "helpKey"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ngAcceptInputType_headingHidden: unknown;
     static ngAcceptInputType_stacked: unknown;
     static ngAcceptInputType_headingLevel: unknown;
     static ngAcceptInputType_headingStyle: unknown;

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

@@ -122,6 +122,12 @@ export declare class SkyFileDropComponent implements OnInit, OnDestroy {
      * @preview
      */
     stacked: boolean;
+    /**
+     * A help key that identifies the global help content to display. When specified, a [help inline](https://developer.blackbaud.com/skyux/components/help-inline) button is
+     * placed beside the file attachment label. Clicking the button invokes global help as configured by the application.
+     * @preview
+     */
+    helpKey: string | undefined;
     inputEl: ElementRef | undefined;
     display: string | undefined;
     rejectedOver: boolean;
@@ -141,7 +147,7 @@ export declare class SkyFileDropComponent implements OnInit, OnDestroy {
     addLink(event: Event): void;
     onLinkBlur(): void;
     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; }; "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; }; "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; }; }, { "filesChanged": "filesChanged"; "linkInputBlur": "linkInputBlur"; "linkChanged": "linkChanged"; }, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkyFileDropComponent, "sky-file-drop", never, { "fileUploadAriaLabel": { "alias": "fileUploadAriaLabel"; "required": false; }; "linkUploadAriaLabel": { "alias": "linkUploadAriaLabel"; "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; }; "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, ["*"], false, never>;
     static ngAcceptInputType_labelHidden: unknown;
     static ngAcceptInputType_required: unknown;
     static ngAcceptInputType_stacked: unknown;

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

@@ -2,6 +2,8 @@ import { AfterContentInit, AfterViewInit, ChangeDetectorRef, OnDestroy, OnInit,
 import { NgControl } from '@angular/forms';
 import { SkyRadioGroupIdService } from './radio-group-id.service';
 import { SkyRadioComponent } from './radio.component';
+import { SkyRadioGroupHeadingLevel } from './types/radio-group-heading-level';
+import { SkyRadioGroupHeadingStyle } from './types/radio-group-heading-style';
 import * as i0 from "@angular/core";
 /**
  * Organizes radio buttons into a group. It is required for radio
@@ -17,7 +19,7 @@ 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.
+     * @deprecated Use `headingText` instead.
      */
     set ariaLabelledBy(value: string | undefined);
     get ariaLabelledBy(): string | undefined;
@@ -27,7 +29,7 @@ export declare class SkyRadioGroupComponent implements AfterContentInit, AfterVi
      * [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.
+     * @deprecated Use `headingText` instead.
      */
     set ariaLabel(value: string | undefined);
     get ariaLabel(): string | undefined;
@@ -38,6 +40,16 @@ export declare class SkyRadioGroupComponent implements AfterContentInit, AfterVi
      */
     set disabled(value: boolean | undefined);
     get disabled(): boolean;
+    /**
+     * The heading level in the document structure.
+     * @preview
+     */
+    headingLevel: SkyRadioGroupHeadingLevel;
+    /**
+     * The heading font style.
+     * @preview
+     */
+    set headingStyle(value: SkyRadioGroupHeadingStyle);
     /**
      * The name for the collection of radio buttons that the component groups together.
      * This property overwrites the deprecated `name` property on individual `sky-radio` elements,
@@ -77,15 +89,15 @@ 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.
+     * The text to display as the radio group's heading.
      * @preview
      */
-    labelText: string | undefined;
+    headingText: string | undefined;
     /**
-     * Indicates whether to hide the `labelText`.
+     * Indicates whether to hide the `headingText`.
      * @preview
      */
-    labelHidden: boolean;
+    headingHidden: boolean;
     display: string | undefined;
     /**
      * [Persistent inline help text](https://developer.blackbaud.com/skyux/design/guidelines/user-assistance#inline-help) that provides
@@ -94,7 +106,7 @@ export declare class SkyRadioGroupComponent implements AfterContentInit, AfterVi
      */
     hintText: string | undefined;
     /**
-     * The content of the help popover. When specified along with `labelText`, a [help inline](https://developer.blackbaud.com/skyux/components/help-inline)
+     * The content of the help popover. When specified along with `headingText`, a [help inline](https://developer.blackbaud.com/skyux/components/help-inline)
      * button is added to radio group. The help inline button displays a [popover](https://developer.blackbaud.com/skyux/components/popover)
      * when clicked using the specified content and optional title.
      * @preview
@@ -117,6 +129,7 @@ export declare class SkyRadioGroupComponent implements AfterContentInit, AfterVi
     radios: QueryList<SkyRadioComponent> | undefined;
     protected errorId: string;
     protected ngControl: NgControl | undefined;
+    protected headingClass: string;
     constructor(changeDetector: ChangeDetectorRef, radioGroupIdSvc: SkyRadioGroupIdService, ngControl: NgControl);
     ngAfterContentInit(): void;
     ngAfterViewInit(): void;
@@ -132,7 +145,9 @@ 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; }; "stacked": { "alias": "stacked"; "required": false; }; "value": { "alias": "value"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "labelText": { "alias": "labelText"; "required": false; }; "labelHidden": { "alias": "labelHidden"; "required": false; }; "hintText": { "alias": "hintText"; "required": false; }; "helpPopoverContent": { "alias": "helpPopoverContent"; "required": false; }; "helpPopoverTitle": { "alias": "helpPopoverTitle"; "required": false; }; }, {}, ["radios"], ["*", "sky-form-error"], 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; }; "headingLevel": { "alias": "headingLevel"; "required": false; }; "headingStyle": { "alias": "headingStyle"; "required": false; }; "name": { "alias": "name"; "required": false; }; "required": { "alias": "required"; "required": false; }; "stacked": { "alias": "stacked"; "required": false; }; "value": { "alias": "value"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "headingText": { "alias": "headingText"; "required": false; }; "headingHidden": { "alias": "headingHidden"; "required": false; }; "hintText": { "alias": "hintText"; "required": false; }; "helpPopoverContent": { "alias": "helpPopoverContent"; "required": false; }; "helpPopoverTitle": { "alias": "helpPopoverTitle"; "required": false; }; }, {}, ["radios"], ["*", "sky-form-error"], false, never>;
+    static ngAcceptInputType_headingLevel: unknown;
+    static ngAcceptInputType_headingStyle: unknown;
     static ngAcceptInputType_stacked: unknown;
-    static ngAcceptInputType_labelHidden: unknown;
+    static ngAcceptInputType_headingHidden: unknown;
 }

package/lib/modules/radio/types/radio-group-heading-level.d.ts

@@ -0,0 +1 @@
+export type SkyRadioGroupHeadingLevel = 3 | 4 | 5;

package/lib/modules/radio/types/radio-group-heading-style.d.ts

@@ -0,0 +1 @@
+export type SkyRadioGroupHeadingStyle = 3 | 4 | 5;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyux/forms",
-  "version": "10.18.0",
+  "version": "10.19.0",
   "author": "Blackbaud, Inc.",
   "keywords": [
     "blackbaud",
@@ -41,13 +41,13 @@
     "@angular/core": "^17.3.4",
     "@angular/forms": "^17.3.4",
     "@angular/platform-browser": "^17.3.4",
-    "@skyux-sdk/testing": "10.18.0",
-    "@skyux/core": "10.18.0",
-    "@skyux/help-inline": "10.18.0",
-    "@skyux/i18n": "10.18.0",
-    "@skyux/indicators": "10.18.0",
-    "@skyux/popovers": "10.18.0",
-    "@skyux/theme": "10.18.0"
+    "@skyux-sdk/testing": "10.19.0",
+    "@skyux/core": "10.19.0",
+    "@skyux/help-inline": "10.19.0",
+    "@skyux/i18n": "10.19.0",
+    "@skyux/indicators": "10.19.0",
+    "@skyux/popovers": "10.19.0",
+    "@skyux/theme": "10.19.0"
   },
   "dependencies": {
     "tslib": "^2.6.2"