@skyux/validation 15.0.0-alpha.9 → 15.0.0-beta.0

package/fesm2022/skyux-validation.mjs

@@ -2,6 +2,7 @@ import * as i0 from '@angular/core';
 import { forwardRef, Directive, NgModule, Input } from '@angular/core';
 import { NG_VALIDATORS, FormsModule } from '@angular/forms';
 import isURL from 'validator/es/lib/isURL';
+import { validate } from '@angular/forms/signals';
 
 class SkyValidation {
     static isEmail(emailAddress) {
@@ -139,6 +140,34 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.2", ngImpor
                 }]
         }] });
 
+/**
+ * Validates that a signal forms field contains a valid email address. Apply inside a
+ * `form()` schema. Empty values pass; combine with Angular's `required` rule to require a
+ * value.
+ * @preview
+ */
+function skyEmail(path) {
+    validate(path, ({ value }) => {
+        const email = value();
+        return !email || SkyValidation.isEmail(email)
+            ? undefined
+            : { kind: 'skyEmail' };
+    });
+}
+/**
+ * Validates that a signal forms field contains a valid URL. Apply inside a `form()` schema.
+ * Empty values pass; combine with Angular's `required` rule to require a value.
+ * @preview
+ */
+function skyUrl(path, options) {
+    validate(path, ({ value }) => {
+        const url = value();
+        return !url || SkyValidation.isUrl(url, options)
+            ? undefined
+            : { kind: 'skyUrl' };
+    });
+}
+
 class SkyValidators {
     /**
      * Validates email addresses in reactive forms. Add this validator directly to the form control
@@ -188,5 +217,5 @@ class SkyValidators {
  * Generated bundle index. Do not edit.
  */
 
-export { SkyEmailValidationModule, SkyUrlValidationModule, SkyValidation, SkyValidators, SkyEmailValidationDirective as λ1, SkyUrlValidationDirective as λ2 };
+export { SkyEmailValidationModule, SkyUrlValidationModule, SkyValidation, SkyValidators, skyEmail, skyUrl, SkyEmailValidationDirective as λ1, SkyUrlValidationDirective as λ2 };
 //# sourceMappingURL=skyux-validation.mjs.map

package/fesm2022/skyux-validation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"skyux-validation.mjs","sources":["../../../../../libs/components/validation/src/lib/modules/validation/validation.ts","../../../../../libs/components/validation/src/lib/modules/email-validation/email-validation.directive.ts","../../../../../libs/components/validation/src/lib/modules/email-validation/email-validation.module.ts","../../../../../libs/components/validation/src/lib/modules/url-validation/url-validation.directive.ts","../../../../../libs/components/validation/src/lib/modules/url-validation/url-validation.module.ts","../../../../../libs/components/validation/src/lib/modules/validators/validators.ts","../../../../../libs/components/validation/src/skyux-validation.ts"],"sourcesContent":["import isURL from 'validator/es/lib/isURL';\n\nimport { SkyUrlValidationOptions } from '../url-validation/url-validation-options';\n\nexport abstract class SkyValidation {\n  public static isEmail(emailAddress: string): boolean {\n    // The regex was obtained from http://emailregex.com/\n    // which claims to correctly handle ~99% of all email addresses.\n    const regex =\n      /^(([^<>()[\\]\\\\.,;:\\s@\"]+(\\.[^<>()[\\]\\\\.,;:\\s@\"]+)*)|(\".+\"))@((\\[[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}])|(([a-zA-Z\\-0-9]+\\.)+[a-zA-Z]{2,}))$/;\n    return regex.test(emailAddress);\n  }\n\n  public static isUrl(\n    value: unknown,\n    options?: SkyUrlValidationOptions,\n  ): boolean {\n    if (typeof value !== 'string') {\n      return false;\n    }\n\n    const url: string = value;\n\n    const regex = /^((http|https):\\/\\/)?([\\w-]+\\.)+[\\w-]+/i;\n    if (options) {\n      switch (options.rulesetVersion) {\n        case 1:\n          return regex.test(url);\n        case 2:\n          // we are using the `validator` package's default options\n          return isURL(url);\n      }\n    } else {\n      return regex.test(url);\n    }\n  }\n}\n","import { Directive, forwardRef } from '@angular/core';\nimport {\n  AbstractControl,\n  NG_VALIDATORS,\n  ValidationErrors,\n  Validator,\n} from '@angular/forms';\n\nimport { SkyValidation } from '../validation/validation';\n\nconst SKY_EMAIL_VALIDATION_VALIDATOR = {\n  provide: NG_VALIDATORS,\n  useExisting: forwardRef(() => SkyEmailValidationDirective),\n  multi: true,\n};\n\n/**\n * Adds email address validation to an input element. The directive uses `NgModel` to bind data.\n */\n@Directive({\n  selector: '[skyEmailValidation]',\n  providers: [SKY_EMAIL_VALIDATION_VALIDATOR],\n  standalone: false,\n})\nexport class SkyEmailValidationDirective implements Validator {\n  public validate(control: AbstractControl): ValidationErrors | null {\n    const value = control.value;\n\n    if (!value || this.emailIsValid(value)) {\n      return null;\n    }\n\n    return {\n      skyEmail: {\n        invalid: control.value,\n      },\n    };\n  }\n\n  public emailIsValid(email: string): boolean {\n    return SkyValidation.isEmail(email);\n  }\n}\n","import { NgModule } from '@angular/core';\nimport { FormsModule } from '@angular/forms';\n\nimport { SkyEmailValidationDirective } from './email-validation.directive';\n\n@NgModule({\n  declarations: [SkyEmailValidationDirective],\n  imports: [FormsModule],\n  exports: [SkyEmailValidationDirective],\n})\nexport class SkyEmailValidationModule {}\n","import { Directive, Input, forwardRef } from '@angular/core';\nimport {\n  AbstractControl,\n  NG_VALIDATORS,\n  ValidationErrors,\n  Validator,\n} from '@angular/forms';\n\nimport { SkyValidation } from '../validation/validation';\n\nimport { SkyUrlValidationOptions } from './url-validation-options';\n\nconst SKY_URL_VALIDATION_VALIDATOR = {\n  provide: NG_VALIDATORS,\n  useExisting: forwardRef(() => SkyUrlValidationDirective),\n  multi: true,\n};\n\n/**\n * Adds URL validation to an input element. The directive uses `NgModel` to bind data.\n */\n@Directive({\n  selector: '[skyUrlValidation]',\n  providers: [SKY_URL_VALIDATION_VALIDATOR],\n  standalone: false,\n})\nexport class SkyUrlValidationDirective implements Validator {\n  /**\n   * Configuration options for the URL validation component.\n   */\n  @Input()\n  public set skyUrlValidation(value: SkyUrlValidationOptions | undefined) {\n    this.#_skyUrlValidationOptions = value;\n    this.#validatorChange();\n  }\n\n  #_skyUrlValidationOptions: SkyUrlValidationOptions | undefined;\n\n  // eslint-disable-next-line @typescript-eslint/no-empty-function\n  #validatorChange = (): void => {};\n\n  public validate(control: AbstractControl): ValidationErrors | null {\n    const value = control.value;\n\n    if (!value) {\n      return null;\n    }\n\n    return SkyValidation.isUrl(value, this.#_skyUrlValidationOptions)\n      ? null\n      : { skyUrl: { invalid: value } };\n  }\n\n  public registerOnValidatorChange(fn: () => void): void {\n    this.#validatorChange = fn;\n  }\n}\n","import { NgModule } from '@angular/core';\nimport { FormsModule } from '@angular/forms';\n\nimport { SkyUrlValidationDirective } from './url-validation.directive';\n\n@NgModule({\n  declarations: [SkyUrlValidationDirective],\n  imports: [FormsModule],\n  exports: [SkyUrlValidationDirective],\n})\nexport class SkyUrlValidationModule {}\n","import { AbstractControl, ValidationErrors, ValidatorFn } from '@angular/forms';\n\nimport { SkyUrlValidationOptions } from '../url-validation/url-validation-options';\nimport { SkyValidation } from '../validation/validation';\n\nexport class SkyValidators {\n  /**\n   * Validates email addresses in reactive forms. Add this validator directly to the form control\n   * model in the component class. If users enter values that are not valid email addresses, the\n   * validator throws an error. Since this is a sync validator, it returns a set of validation\n   * errors or `null` immediately when users enter values.\n   */\n  public static email(control: AbstractControl): ValidationErrors | null {\n    const value = control.value;\n\n    if (!value) {\n      return null;\n    }\n\n    return SkyValidation.isEmail(value)\n      ? null\n      : { skyEmail: { invalid: value } };\n  }\n\n  /**\n   * Validates URLs in reactive forms. Add this validator directly to the form control model in\n   * the component class. If users enter values that are not valid URLs, the validator throws an\n   * error. Since this is a sync validator, it returns a set of validation errors or `null`\n   * immediately when users enter values.\n   */\n  public static url(abstractControl: AbstractControl): ValidationErrors | null;\n\n  /**\n   * Validates URLs in reactive forms. Add this validator with ruleset parameters directly to\n   * the form control model in the component class. If users enter values that are not valid\n   * URLs, the validator throws an error. Since this is a sync validator, it returns a set of\n   * validation errors or `null` immediately when users enter values.\n   */\n  public static url(\n    skyUrlValidationOptions: SkyUrlValidationOptions,\n  ): ValidatorFn;\n\n  public static url(\n    value: AbstractControl | SkyUrlValidationOptions,\n  ): ValidatorFn | ValidationErrors | null {\n    const typeTester = value as SkyUrlValidationOptions;\n    if (typeTester.rulesetVersion === undefined) {\n      // there are no SkyUrlValidationOptions passed in, so return ValidationErrors | null\n      const abstractControl = value as AbstractControl;\n      const abstractControlValue = abstractControl.value;\n      if (!abstractControlValue) {\n        return null;\n      }\n      return SkyValidation.isUrl(abstractControlValue)\n        ? null\n        : { skyUrl: { invalid: abstractControlValue } };\n    } else {\n      // there are SkyUrlValidationOptions passed in, so return ValidatorFn\n      const skyUrlValidationOptions = value as SkyUrlValidationOptions;\n      return (abstractControl: AbstractControl): ValidationErrors | null => {\n        const abstractControlValue = abstractControl.value;\n        if (!abstractControlValue) {\n          return null;\n        }\n\n        return SkyValidation.isUrl(\n          abstractControl.value,\n          skyUrlValidationOptions,\n        )\n          ? null\n          : { skyUrl: { invalid: abstractControl.value } };\n      };\n    }\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"skyux-validation.mjs","sources":["../../../../../libs/components/validation/src/lib/modules/validation/validation.ts","../../../../../libs/components/validation/src/lib/modules/email-validation/email-validation.directive.ts","../../../../../libs/components/validation/src/lib/modules/email-validation/email-validation.module.ts","../../../../../libs/components/validation/src/lib/modules/url-validation/url-validation.directive.ts","../../../../../libs/components/validation/src/lib/modules/url-validation/url-validation.module.ts","../../../../../libs/components/validation/src/lib/modules/validators/signal-validators.ts","../../../../../libs/components/validation/src/lib/modules/validators/validators.ts","../../../../../libs/components/validation/src/skyux-validation.ts"],"sourcesContent":["import isURL from 'validator/es/lib/isURL';\n\nimport { SkyUrlValidationOptions } from '../url-validation/url-validation-options';\n\nexport abstract class SkyValidation {\n  public static isEmail(emailAddress: string): boolean {\n    // The regex was obtained from http://emailregex.com/\n    // which claims to correctly handle ~99% of all email addresses.\n    const regex =\n      /^(([^<>()[\\]\\\\.,;:\\s@\"]+(\\.[^<>()[\\]\\\\.,;:\\s@\"]+)*)|(\".+\"))@((\\[[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}])|(([a-zA-Z\\-0-9]+\\.)+[a-zA-Z]{2,}))$/;\n    return regex.test(emailAddress);\n  }\n\n  public static isUrl(\n    value: unknown,\n    options?: SkyUrlValidationOptions,\n  ): boolean {\n    if (typeof value !== 'string') {\n      return false;\n    }\n\n    const url: string = value;\n\n    const regex = /^((http|https):\\/\\/)?([\\w-]+\\.)+[\\w-]+/i;\n    if (options) {\n      switch (options.rulesetVersion) {\n        case 1:\n          return regex.test(url);\n        case 2:\n          // we are using the `validator` package's default options\n          return isURL(url);\n      }\n    } else {\n      return regex.test(url);\n    }\n  }\n}\n","import { Directive, forwardRef } from '@angular/core';\nimport {\n  AbstractControl,\n  NG_VALIDATORS,\n  ValidationErrors,\n  Validator,\n} from '@angular/forms';\n\nimport { SkyValidation } from '../validation/validation';\n\nconst SKY_EMAIL_VALIDATION_VALIDATOR = {\n  provide: NG_VALIDATORS,\n  useExisting: forwardRef(() => SkyEmailValidationDirective),\n  multi: true,\n};\n\n/**\n * Adds email address validation to an input element. The directive uses `NgModel` to bind data.\n */\n@Directive({\n  selector: '[skyEmailValidation]',\n  providers: [SKY_EMAIL_VALIDATION_VALIDATOR],\n  standalone: false,\n})\nexport class SkyEmailValidationDirective implements Validator {\n  public validate(control: AbstractControl): ValidationErrors | null {\n    const value = control.value;\n\n    if (!value || this.emailIsValid(value)) {\n      return null;\n    }\n\n    return {\n      skyEmail: {\n        invalid: control.value,\n      },\n    };\n  }\n\n  public emailIsValid(email: string): boolean {\n    return SkyValidation.isEmail(email);\n  }\n}\n","import { NgModule } from '@angular/core';\nimport { FormsModule } from '@angular/forms';\n\nimport { SkyEmailValidationDirective } from './email-validation.directive';\n\n@NgModule({\n  declarations: [SkyEmailValidationDirective],\n  imports: [FormsModule],\n  exports: [SkyEmailValidationDirective],\n})\nexport class SkyEmailValidationModule {}\n","import { Directive, Input, forwardRef } from '@angular/core';\nimport {\n  AbstractControl,\n  NG_VALIDATORS,\n  ValidationErrors,\n  Validator,\n} from '@angular/forms';\n\nimport { SkyValidation } from '../validation/validation';\n\nimport { SkyUrlValidationOptions } from './url-validation-options';\n\nconst SKY_URL_VALIDATION_VALIDATOR = {\n  provide: NG_VALIDATORS,\n  useExisting: forwardRef(() => SkyUrlValidationDirective),\n  multi: true,\n};\n\n/**\n * Adds URL validation to an input element. The directive uses `NgModel` to bind data.\n */\n@Directive({\n  selector: '[skyUrlValidation]',\n  providers: [SKY_URL_VALIDATION_VALIDATOR],\n  standalone: false,\n})\nexport class SkyUrlValidationDirective implements Validator {\n  /**\n   * Configuration options for the URL validation component.\n   */\n  @Input()\n  public set skyUrlValidation(value: SkyUrlValidationOptions | undefined) {\n    this.#_skyUrlValidationOptions = value;\n    this.#validatorChange();\n  }\n\n  #_skyUrlValidationOptions: SkyUrlValidationOptions | undefined;\n\n  // eslint-disable-next-line @typescript-eslint/no-empty-function\n  #validatorChange = (): void => {};\n\n  public validate(control: AbstractControl): ValidationErrors | null {\n    const value = control.value;\n\n    if (!value) {\n      return null;\n    }\n\n    return SkyValidation.isUrl(value, this.#_skyUrlValidationOptions)\n      ? null\n      : { skyUrl: { invalid: value } };\n  }\n\n  public registerOnValidatorChange(fn: () => void): void {\n    this.#validatorChange = fn;\n  }\n}\n","import { NgModule } from '@angular/core';\nimport { FormsModule } from '@angular/forms';\n\nimport { SkyUrlValidationDirective } from './url-validation.directive';\n\n@NgModule({\n  declarations: [SkyUrlValidationDirective],\n  imports: [FormsModule],\n  exports: [SkyUrlValidationDirective],\n})\nexport class SkyUrlValidationModule {}\n","import {\n  PathKind,\n  SchemaPath,\n  SchemaPathRules,\n  validate,\n} from '@angular/forms/signals';\n\nimport { SkyUrlValidationOptions } from '../url-validation/url-validation-options';\nimport { SkyValidation } from '../validation/validation';\n\n/**\n * Validates that a signal forms field contains a valid email address. Apply inside a\n * `form()` schema. Empty values pass; combine with Angular's `required` rule to require a\n * value.\n * @preview\n */\nexport function skyEmail<TPathKind extends PathKind = PathKind.Root>(\n  path: SchemaPath<string | undefined, SchemaPathRules.Supported, TPathKind>,\n): void {\n  validate(path, ({ value }) => {\n    const email = value();\n\n    return !email || SkyValidation.isEmail(email)\n      ? undefined\n      : { kind: 'skyEmail' };\n  });\n}\n\n/**\n * Validates that a signal forms field contains a valid URL. Apply inside a `form()` schema.\n * Empty values pass; combine with Angular's `required` rule to require a value.\n * @preview\n */\nexport function skyUrl<TPathKind extends PathKind = PathKind.Root>(\n  path: SchemaPath<string | undefined, SchemaPathRules.Supported, TPathKind>,\n  options?: SkyUrlValidationOptions,\n): void {\n  validate(path, ({ value }) => {\n    const url = value();\n\n    return !url || SkyValidation.isUrl(url, options)\n      ? undefined\n      : { kind: 'skyUrl' };\n  });\n}\n","import { AbstractControl, ValidationErrors, ValidatorFn } from '@angular/forms';\n\nimport { SkyUrlValidationOptions } from '../url-validation/url-validation-options';\nimport { SkyValidation } from '../validation/validation';\n\nexport class SkyValidators {\n  /**\n   * Validates email addresses in reactive forms. Add this validator directly to the form control\n   * model in the component class. If users enter values that are not valid email addresses, the\n   * validator throws an error. Since this is a sync validator, it returns a set of validation\n   * errors or `null` immediately when users enter values.\n   */\n  public static email(control: AbstractControl): ValidationErrors | null {\n    const value = control.value;\n\n    if (!value) {\n      return null;\n    }\n\n    return SkyValidation.isEmail(value)\n      ? null\n      : { skyEmail: { invalid: value } };\n  }\n\n  /**\n   * Validates URLs in reactive forms. Add this validator directly to the form control model in\n   * the component class. If users enter values that are not valid URLs, the validator throws an\n   * error. Since this is a sync validator, it returns a set of validation errors or `null`\n   * immediately when users enter values.\n   */\n  public static url(abstractControl: AbstractControl): ValidationErrors | null;\n\n  /**\n   * Validates URLs in reactive forms. Add this validator with ruleset parameters directly to\n   * the form control model in the component class. If users enter values that are not valid\n   * URLs, the validator throws an error. Since this is a sync validator, it returns a set of\n   * validation errors or `null` immediately when users enter values.\n   */\n  public static url(\n    skyUrlValidationOptions: SkyUrlValidationOptions,\n  ): ValidatorFn;\n\n  public static url(\n    value: AbstractControl | SkyUrlValidationOptions,\n  ): ValidatorFn | ValidationErrors | null {\n    const typeTester = value as SkyUrlValidationOptions;\n    if (typeTester.rulesetVersion === undefined) {\n      // there are no SkyUrlValidationOptions passed in, so return ValidationErrors | null\n      const abstractControl = value as AbstractControl;\n      const abstractControlValue = abstractControl.value;\n      if (!abstractControlValue) {\n        return null;\n      }\n      return SkyValidation.isUrl(abstractControlValue)\n        ? null\n        : { skyUrl: { invalid: abstractControlValue } };\n    } else {\n      // there are SkyUrlValidationOptions passed in, so return ValidatorFn\n      const skyUrlValidationOptions = value as SkyUrlValidationOptions;\n      return (abstractControl: AbstractControl): ValidationErrors | null => {\n        const abstractControlValue = abstractControl.value;\n        if (!abstractControlValue) {\n          return null;\n        }\n\n        return SkyValidation.isUrl(\n          abstractControl.value,\n          skyUrlValidationOptions,\n        )\n          ? null\n          : { skyUrl: { invalid: abstractControl.value } };\n      };\n    }\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyux/validation",
-  "version": "15.0.0-alpha.9",
+  "version": "15.0.0-beta.0",
   "author": "Blackbaud, Inc.",
   "keywords": [
     "blackbaud",

package/types/skyux-validation.d.ts

@@ -1,6 +1,7 @@
 import * as i0 from '@angular/core';
 import * as i2 from '@angular/forms';
 import { Validator, AbstractControl, ValidationErrors, ValidatorFn } from '@angular/forms';
+import { PathKind, SchemaPath, SchemaPathRules } from '@angular/forms/signals';
 
 /**
  * Adds email address validation to an input element. The directive uses `NgModel` to bind data.
@@ -54,6 +55,20 @@ declare abstract class SkyValidation {
     static isUrl(value: unknown, options?: SkyUrlValidationOptions): boolean;
 }
 
+/**
+ * Validates that a signal forms field contains a valid email address. Apply inside a
+ * `form()` schema. Empty values pass; combine with Angular's `required` rule to require a
+ * value.
+ * @preview
+ */
+declare function skyEmail<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string | undefined, SchemaPathRules.Supported, TPathKind>): void;
+/**
+ * Validates that a signal forms field contains a valid URL. Apply inside a `form()` schema.
+ * Empty values pass; combine with Angular's `required` rule to require a value.
+ * @preview
+ */
+declare function skyUrl<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string | undefined, SchemaPathRules.Supported, TPathKind>, options?: SkyUrlValidationOptions): void;
+
 declare class SkyValidators {
     /**
      * Validates email addresses in reactive forms. Add this validator directly to the form control
@@ -78,5 +93,5 @@ declare class SkyValidators {
     static url(skyUrlValidationOptions: SkyUrlValidationOptions): ValidatorFn;
 }
 
-export { SkyEmailValidationModule, SkyUrlValidationModule, SkyValidation, SkyValidators, SkyEmailValidationDirective as λ1, SkyUrlValidationDirective as λ2 };
+export { SkyEmailValidationModule, SkyUrlValidationModule, SkyValidation, SkyValidators, skyEmail, skyUrl, SkyEmailValidationDirective as λ1, SkyUrlValidationDirective as λ2 };
 export type { SkyUrlValidationOptions };