@skyux/forms 10.1.0 → 10.3.0

package/index.d.ts

@@ -1,8 +1,7 @@
 export { SkyCharacterCounterModule } from './lib/modules/character-counter/character-counter.module';
 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 { SkyFieldGroupModule } from './lib/modules/field-group/field-group.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';
@@ -11,6 +10,8 @@ export { SkyFileSizePipe } from './lib/modules/file-attachment/file-size.pipe';
 export { SkyFileAttachmentChange } from './lib/modules/file-attachment/types/file-attachment-change';
 export { SkyFileAttachmentClick } from './lib/modules/file-attachment/types/file-attachment-click';
 export { SkyFileDropChange } from './lib/modules/file-attachment/types/file-drop-change';
+export { SkyFormErrorsModule } from './lib/modules/form-error/form-errors.module';
+export { SkyFormErrorModule } from './lib/modules/form-error/form-error.module';
 export { SkyInputBoxHostService } from './lib/modules/input-box/input-box-host.service';
 export { SkyInputBoxPopulateArgs } from './lib/modules/input-box/input-box-populate-args';
 export { SkyInputBoxModule } from './lib/modules/input-box/input-box.module';
@@ -29,6 +30,7 @@ export { SkyCharacterCounterScreenReaderPipe as λ23 } from './lib/modules/chara
 export { SkyCheckboxLabelComponent as λ4 } from './lib/modules/checkbox/checkbox-label.component';
 export { SkyCheckboxComponent as λ3 } from './lib/modules/checkbox/checkbox.component';
 export { SkyCheckboxGroupComponent as λ24 } from './lib/modules/checkbox/checkbox-group.component';
+export { SkyFieldGroupComponent as λ25 } from './lib/modules/field-group/field-group.component';
 export { SkyFileAttachmentLabelComponent as λ6 } from './lib/modules/file-attachment/file-attachment-label.component';
 export { SkyFileAttachmentComponent as λ7 } from './lib/modules/file-attachment/file-attachment.component';
 export { SkyFileDropComponent as λ8 } from './lib/modules/file-attachment/file-drop.component';

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

@@ -0,0 +1,26 @@
+import * as i0 from "@angular/core";
+/**
+ * Organizes form fields into a group.
+ */
+export declare class SkyFieldGroupComponent {
+    /**
+     * The text to display as the field group's label.
+     * @preview
+     */
+    labelText: string;
+    /**
+     * Indicates whether to hide the `labelText`.
+     * @preview
+     */
+    labelHidden: boolean;
+    /**
+     * Whether the field group is stacked on another field group. When specified, the appropriate
+     * vertical spacing is automatically added to the field group.
+     * @preview
+     */
+    stacked: boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SkyFieldGroupComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkyFieldGroupComponent, "sky-field-group", never, { "labelText": { "alias": "labelText"; "required": true; }; "labelHidden": { "alias": "labelHidden"; "required": false; }; "stacked": { "alias": "stacked"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ngAcceptInputType_labelHidden: unknown;
+    static ngAcceptInputType_stacked: unknown;
+}

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

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

package/lib/modules/file-attachment/file-attachments.module.d.ts

@@ -14,6 +14,6 @@ import * as i12 from "@skyux/core";
 import * as i13 from "@skyux/theme";
 export declare class SkyFileAttachmentsModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<SkyFileAttachmentsModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<SkyFileAttachmentsModule, [typeof i1.SkyFileAttachmentComponent, typeof i2.SkyFileAttachmentLabelComponent, typeof i3.SkyFileDropComponent, typeof i4.SkyFileItemComponent, typeof i5.SkyFileSizePipe], [typeof i6.CommonModule, typeof i7.FormsModule, typeof i8.SkyFormsResourcesModule, typeof i9.SkyFormErrorModule, typeof i10.SkyFormErrorsModule, typeof i11.SkyIconModule, typeof i12.SkyIdModule, typeof i13.SkyThemeModule, typeof i12.SkyTrimModule], [typeof i1.SkyFileAttachmentComponent, typeof i2.SkyFileAttachmentLabelComponent, typeof i3.SkyFileDropComponent, typeof i4.SkyFileItemComponent, typeof i5.SkyFileSizePipe]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SkyFileAttachmentsModule, [typeof i1.SkyFileAttachmentComponent, typeof i2.SkyFileAttachmentLabelComponent, typeof i3.SkyFileDropComponent, typeof i4.SkyFileItemComponent, typeof i5.SkyFileSizePipe], [typeof i6.CommonModule, typeof i7.FormsModule, typeof i8.SkyFormsResourcesModule, typeof i9.SkyFormErrorModule, typeof i10.SkyFormErrorsModule, typeof i11.SkyIconModule, typeof i12.SkyIdModule, typeof i13.SkyThemeModule, typeof i12.SkyTrimModule], [typeof i1.SkyFileAttachmentComponent, typeof i2.SkyFileAttachmentLabelComponent, typeof i3.SkyFileDropComponent, typeof i4.SkyFileItemComponent, typeof i5.SkyFileSizePipe, typeof i9.SkyFormErrorModule]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<SkyFileAttachmentsModule>;
 }

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

@@ -1,4 +1,5 @@
 import { ElementRef, EventEmitter, OnDestroy } from '@angular/core';
+import { SkyFileItem } from './file-item';
 import { SkyFileLink } from './file-link';
 import { SkyFileValidateFn } from './file-validate-function';
 import { SkyFileDropChange } from './types/file-drop-change';
@@ -60,6 +61,7 @@ export declare class SkyFileDropComponent implements OnDestroy {
     /**
      * The custom validation function. This validation runs alongside the internal
      * file validation. This function takes a `SkyFileItem` object as a parameter.
+     * The string returned is used as the error message in multi-file attachment.
      */
     validateFn: SkyFileValidateFn | undefined;
     /**
@@ -90,6 +92,8 @@ export declare class SkyFileDropComponent implements OnDestroy {
     rejectedOver: boolean;
     acceptedOver: boolean;
     linkUrl: string | undefined;
+    protected errorId: string;
+    protected rejectedFiles: SkyFileItem[];
     ngOnDestroy(): void;
     dropClicked(): void;
     fileChangeEvent(fileChangeEvent: Event): void;

package/lib/modules/file-attachment/file-validate-function.d.ts

@@ -1,2 +1,5 @@
 import { SkyFileItem } from './file-item';
+/**
+ * Custom validation run on each file uploaded. The string returned is used as the error message in multi-file attachment.
+ */
 export type SkyFileValidateFn = (file: SkyFileItem) => string | undefined;

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

@@ -18,7 +18,10 @@ export declare class SkyInputBoxComponent implements OnInit, AfterContentChecked
     /**
      * Whether to visually highlight the input box as disabled. To disable the input box's
      * input element, use the HTML `disabled` attribute or the Angular `FormControl.disabled`
-     * property. You must set both properties to disable an input element and visually indicate
+     * property. If the input element is mapped to an Angular form control
+     * (e.g. `formControlName`, `ngModel`, etc.), "disabled" styles are applied automatically;
+     * if the input element is not associated with an Angular form control, the `disabled`
+     * property on the input box must be set to `true` to visually indicate
      * the disabled state on the input box.
      * @default false
      */
@@ -77,6 +80,7 @@ export declare class SkyInputBoxComponent implements OnInit, AfterContentChecked
     inputRef: ElementRef | undefined;
     protected controlDir: AbstractControlDirective | undefined;
     protected helpPopoverOpen: boolean | undefined;
+    protected get isDisabled(): boolean;
     protected get hasErrorsComputed(): boolean;
     protected get required(): boolean;
     protected characterCountScreenReader: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyux/forms",
-  "version": "10.1.0",
+  "version": "10.3.0",
   "author": "Blackbaud, Inc.",
   "keywords": [
     "blackbaud",
@@ -41,12 +41,12 @@
     "@angular/core": "^17.3.1",
     "@angular/forms": "^17.3.1",
     "@angular/platform-browser": "^17.3.1",
-    "@skyux-sdk/testing": "10.1.0",
-    "@skyux/core": "10.1.0",
-    "@skyux/i18n": "10.1.0",
-    "@skyux/indicators": "10.1.0",
-    "@skyux/popovers": "10.1.0",
-    "@skyux/theme": "10.1.0"
+    "@skyux-sdk/testing": "10.3.0",
+    "@skyux/core": "10.3.0",
+    "@skyux/i18n": "10.3.0",
+    "@skyux/indicators": "10.3.0",
+    "@skyux/popovers": "10.3.0",
+    "@skyux/theme": "10.3.0"
   },
   "dependencies": {
     "tslib": "^2.6.2"

package/esm2022/lib/modules/shared/forms-utility.mjs

@@ -1,26 +0,0 @@
-// Need to add the following to classes which contain static methods.
-// See: https://github.com/ng-packagr/ng-packagr/issues/641
-// @dynamic
-export class SkyFormsUtility {
-    /** Coerces a data-bound value (typically a string) to a boolean. */
-    static coerceBooleanProperty(value) {
-        return value !== undefined && `${value}` !== 'false';
-    }
-    /**
-     * Gets the required state of the checkbox.
-     * Currently, Angular doesn't offer a way to get this easily, so we have to create an empty
-     * control using the current validator to see if it throws a `required` validation error.
-     * https://github.com/angular/angular/issues/13461#issuecomment-340368046
-     */
-    static hasRequiredValidation(ngControl) {
-        const abstractControl = ngControl.control;
-        if (abstractControl && abstractControl.validator) {
-            const validator = abstractControl.validator({});
-            if (validator && validator['required']) {
-                return true;
-            }
-        }
-        return false;
-    }
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZm9ybXMtdXRpbGl0eS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uLy4uLy4uL2xpYnMvY29tcG9uZW50cy9mb3Jtcy9zcmMvbGliL21vZHVsZXMvc2hhcmVkL2Zvcm1zLXV0aWxpdHkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEscUVBQXFFO0FBQ3JFLDJEQUEyRDtBQUMzRCxXQUFXO0FBQ1gsTUFBTSxPQUFPLGVBQWU7SUFDMUIsb0VBQW9FO0lBQzdELE1BQU0sQ0FBQyxxQkFBcUIsQ0FBQyxLQUFVO1FBQzVDLE9BQU8sS0FBSyxLQUFLLFNBQVMsSUFBSSxHQUFHLEtBQUssRUFBRSxLQUFLLE9BQU8sQ0FBQztJQUN2RCxDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSSxNQUFNLENBQUMscUJBQXFCLENBQUMsU0FBb0I7UUFDdEQsTUFBTSxlQUFlLEdBQUcsU0FBUyxDQUFDLE9BQTBCLENBQUM7UUFDN0QsSUFBSSxlQUFlLElBQUksZUFBZSxDQUFDLFNBQVMsRUFBRSxDQUFDO1lBQ2pELE1BQU0sU0FBUyxHQUFHLGVBQWUsQ0FBQyxTQUFTLENBQUMsRUFBcUIsQ0FBQyxDQUFDO1lBQ25FLElBQUksU0FBUyxJQUFJLFNBQVMsQ0FBQyxVQUFVLENBQUMsRUFBRSxDQUFDO2dCQUN2QyxPQUFPLElBQUksQ0FBQztZQUNkLENBQUM7UUFDSCxDQUFDO1FBQ0QsT0FBTyxLQUFLLENBQUM7SUFDZixDQUFDO0NBQ0YiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBBYnN0cmFjdENvbnRyb2wsIE5nQ29udHJvbCB9IGZyb20gJ0Bhbmd1bGFyL2Zvcm1zJztcblxuLy8gTmVlZCB0byBhZGQgdGhlIGZvbGxvd2luZyB0byBjbGFzc2VzIHdoaWNoIGNvbnRhaW4gc3RhdGljIG1ldGhvZHMuXG4vLyBTZWU6IGh0dHBzOi8vZ2l0aHViLmNvbS9uZy1wYWNrYWdyL25nLXBhY2thZ3IvaXNzdWVzLzY0MVxuLy8gQGR5bmFtaWNcbmV4cG9ydCBjbGFzcyBTa3lGb3Jtc1V0aWxpdHkge1xuICAvKiogQ29lcmNlcyBhIGRhdGEtYm91bmQgdmFsdWUgKHR5cGljYWxseSBhIHN0cmluZykgdG8gYSBib29sZWFuLiAqL1xuICBwdWJsaWMgc3RhdGljIGNvZXJjZUJvb2xlYW5Qcm9wZXJ0eSh2YWx1ZTogYW55KTogYm9vbGVhbiB7XG4gICAgcmV0dXJuIHZhbHVlICE9PSB1bmRlZmluZWQgJiYgYCR7dmFsdWV9YCAhPT0gJ2ZhbHNlJztcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXRzIHRoZSByZXF1aXJlZCBzdGF0ZSBvZiB0aGUgY2hlY2tib3guXG4gICAqIEN1cnJlbnRseSwgQW5ndWxhciBkb2Vzbid0IG9mZmVyIGEgd2F5IHRvIGdldCB0aGlzIGVhc2lseSwgc28gd2UgaGF2ZSB0byBjcmVhdGUgYW4gZW1wdHlcbiAgICogY29udHJvbCB1c2luZyB0aGUgY3VycmVudCB2YWxpZGF0b3IgdG8gc2VlIGlmIGl0IHRocm93cyBhIGByZXF1aXJlZGAgdmFsaWRhdGlvbiBlcnJvci5cbiAgICogaHR0cHM6Ly9naXRodWIuY29tL2FuZ3VsYXIvYW5ndWxhci9pc3N1ZXMvMTM0NjEjaXNzdWVjb21tZW50LTM0MDM2ODA0NlxuICAgKi9cbiAgcHVibGljIHN0YXRpYyBoYXNSZXF1aXJlZFZhbGlkYXRpb24obmdDb250cm9sOiBOZ0NvbnRyb2wpOiBib29sZWFuIHtcbiAgICBjb25zdCBhYnN0cmFjdENvbnRyb2wgPSBuZ0NvbnRyb2wuY29udHJvbCBhcyBBYnN0cmFjdENvbnRyb2w7XG4gICAgaWYgKGFic3RyYWN0Q29udHJvbCAmJiBhYnN0cmFjdENvbnRyb2wudmFsaWRhdG9yKSB7XG4gICAgICBjb25zdCB2YWxpZGF0b3IgPSBhYnN0cmFjdENvbnRyb2wudmFsaWRhdG9yKHt9IGFzIEFic3RyYWN0Q29udHJvbCk7XG4gICAgICBpZiAodmFsaWRhdG9yICYmIHZhbGlkYXRvclsncmVxdWlyZWQnXSkge1xuICAgICAgICByZXR1cm4gdHJ1ZTtcbiAgICAgIH1cbiAgICB9XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG59XG4iXX0=

package/lib/modules/shared/forms-utility.d.ts

@@ -1,12 +0,0 @@
-import { NgControl } from '@angular/forms';
-export declare class SkyFormsUtility {
-    /** Coerces a data-bound value (typically a string) to a boolean. */
-    static coerceBooleanProperty(value: any): boolean;
-    /**
-     * Gets the required state of the checkbox.
-     * Currently, Angular doesn't offer a way to get this easily, so we have to create an empty
-     * control using the current validator to see if it throws a `required` validation error.
-     * https://github.com/angular/angular/issues/13461#issuecomment-340368046
-     */
-    static hasRequiredValidation(ngControl: NgControl): boolean;
-}