@theseam/ui-common 1.0.2-beta.39 → 1.0.2-beta.42

package/fesm2022/theseam-ui-common-validators.mjs

@@ -1,19 +1,21 @@
+import { isEmptyInputValue, isNumeric } from '@theseam/ui-common/utils';
 import { isObservable } from 'rxjs';
 import { map } from 'rxjs/operators';
 import { Validators } from '@angular/forms';
-import { isEmptyInputValue, isNumeric } from '@theseam/ui-common/utils';
 
+const TAX_ID_PATTERN = /^\d{9}$|^\d{2}-\d{7}$|^\d{3}-\d{2}-\d{4}$/;
 /**
- * Validates that value matches on of the following:
- *  ''             // empty string
+ * Validates that value matches one of the following:
  *  'xxxxxxxxx'    // 'x' is a number
  *  'xx-xxxxxxx'   // 'x' is a number
  *  'xxx-xx-xxxx'  // 'x' is a number
  */
-function taxIdValidator(control) {
-    const isValid = /^$|^\d{9}$|^\d{2}-\d{7}$|^\d{3}-\d{2}-\d{4}$/.test(control.value);
-    return isValid ? null : { taxId: {} };
-}
+const taxIdValidator = (control) => {
+    if (isEmptyInputValue(control.value)) {
+        return null;
+    }
+    return TAX_ID_PATTERN.test(control.value) ? null : { taxId: {} };
+};
 
 /**
  * Validates that an email already exists.
@@ -31,61 +33,77 @@ function emailExistsValidator(emailExists) {
     };
 }
 
+const DEFAULT_CONFIG$2 = {
+    minLength: 7,
+    maxLength: 18,
+};
 /**
  * Validates that a value is a valid phone number length.
  */
-function phoneLengthValidator(control) {
-    return control.value.length === 0 ||
-        (control.value.length <= 18 && control.value.length >= 7)
-        ? null
-        : { phoneLength: {} };
+function phoneLengthValidator(config) {
+    const c = { ...DEFAULT_CONFIG$2, ...config };
+    return (control) => {
+        if (isEmptyInputValue(control.value)) {
+            return null;
+        }
+        return control.value.length <= c.maxLength &&
+            control.value.length >= c.minLength
+            ? null
+            : { phoneLength: {} };
+    };
 }
 
 const DECIMAL_REGEX = /^([-+]{1})?\d*(\.\d*)?$/;
-function _decimalValidator() {
+const DEFAULT_CONFIG$1 = {
+    regex: DECIMAL_REGEX,
+};
+/**
+ * Validates control value is a valid decimal number.
+ *
+ * NOTE: This does not allow any js valid decimal number. It only accepts them
+ * in a format expected by our backend.
+ */
+function decimalValidator(config) {
+    const c = { ...DEFAULT_CONFIG$1, ...config };
     return (control) => {
         if (isEmptyInputValue(control.value)) {
             return null; // don't validate empty values to allow optional controls
         }
         const isDecimal = !Array.isArray(control.value) &&
             isNumeric(control.value) &&
-            Validators.pattern(DECIMAL_REGEX)(control) === null;
+            Validators.pattern(c.regex)(control) === null;
         if (!isDecimal) {
             return { decimal: { reason: 'Must be valid decimal number.' } };
         }
         return null;
     };
 }
+
+const INTEGER_REGEX = /^([-+]{1})?[0-9]*$/;
+const DEFAULT_CONFIG = {
+    regex: INTEGER_REGEX,
+};
 /**
- * Validates control value is a valid decimal number.
+ * Validates control value is a valid integer number.
  *
- * NOTE: This does not allow any js valid decimal number. It only accepts them
+ * NOTE: This does not allow any js valid integer number. It only accepts them
  * in a format expected by our backend.
  */
-const decimalValidator = _decimalValidator();
-
-const INTEGER_REGEX = /^([-+]{1})?[0-9]*$/;
-function _integerValidator() {
+function integerValidator(config) {
+    const c = { ...DEFAULT_CONFIG, ...config };
     return (control) => {
         if (isEmptyInputValue(control.value)) {
             return null; // don't validate empty values to allow optional controls
         }
         const isInteger = !Array.isArray(control.value) &&
             isNumeric(control.value) &&
-            Validators.pattern(INTEGER_REGEX)(control) === null;
+            Validators.pattern(c.regex)(control) === null;
         if (!isInteger) {
             return { integer: { reason: 'Must be valid integer.' } };
         }
         return null;
     };
 }
-/**
- * Validates control value is a valid integer number.
- *
- * NOTE: This does not allow any js valid integer number. It only accepts them
- * in a format expected by our backend.
- */
-const integerValidator = _integerValidator();
 
 /**
  * Generated bundle index. Do not edit.

package/fesm2022/theseam-ui-common-validators.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"theseam-ui-common-validators.mjs","sources":["../../../projects/ui-common/validators/tax-id.validator.ts","../../../projects/ui-common/validators/email-exists.validator.ts","../../../projects/ui-common/validators/phone-length.validator.ts","../../../projects/ui-common/validators/decimal.validator.ts","../../../projects/ui-common/validators/integer.validator.ts","../../../projects/ui-common/validators/theseam-ui-common-validators.ts"],"sourcesContent":["import { FormControl } from '@angular/forms'\n\n/**\n * Validates that value matches on of the following:\n *  ''             // empty string\n *  'xxxxxxxxx'    // 'x' is a number\n *  'xx-xxxxxxx'   // 'x' is a number\n *  'xxx-xx-xxxx'  // 'x' is a number\n */\nexport function taxIdValidator(control: FormControl) {\n  const isValid = /^$|^\\d{9}$|^\\d{2}-\\d{7}$|^\\d{3}-\\d{2}-\\d{4}$/.test(\n    control.value,\n  )\n  return isValid ? null : { taxId: {} }\n}\n","import { FormControl } from '@angular/forms'\nimport { isObservable, Observable } from 'rxjs'\nimport { map } from 'rxjs/operators'\n\n/**\n * Validates that an email already exists.\n */\nexport function emailExistsValidator(\n  emailExists: (\n    email: string,\n  ) => Promise<boolean> | Observable<boolean> | boolean,\n) {\n  return (control: FormControl) => {\n    const validationResult = (exists: boolean) => {\n      return exists === false ? null : { emailExists: {} }\n    }\n\n    const fnRes = emailExists(control.value)\n    if (isObservable(fnRes)) {\n      return fnRes.pipe(map(validationResult))\n    }\n    return Promise.resolve(fnRes).then(validationResult)\n  }\n}\n","import { FormControl } from '@angular/forms'\n\n/**\n * Validates that a value is a valid phone number length.\n */\nexport function phoneLengthValidator(control: FormControl) {\n  return control.value.length === 0 ||\n    (control.value.length <= 18 && control.value.length >= 7)\n    ? null\n    : { phoneLength: {} }\n}\n","import { AbstractControl, ValidatorFn, Validators } from '@angular/forms'\n\nimport { isEmptyInputValue, isNumeric } from '@theseam/ui-common/utils'\n\nexport const DECIMAL_REGEX = /^([-+]{1})?\\d*(\\.\\d*)?$/\n\nfunction _decimalValidator(): ValidatorFn {\n  return (control: AbstractControl) => {\n    if (isEmptyInputValue(control.value)) {\n      return null // don't validate empty values to allow optional controls\n    }\n\n    const isDecimal =\n      !Array.isArray(control.value) &&\n      isNumeric(control.value) &&\n      Validators.pattern(DECIMAL_REGEX)(control) === null\n\n    if (!isDecimal) {\n      return { decimal: { reason: 'Must be valid decimal number.' } }\n    }\n\n    return null\n  }\n}\n\n/**\n * Validates control value is a valid decimal number.\n *\n * NOTE: This does not allow any js valid decimal number. It only accepts them\n * in a format expected by our backend.\n */\nexport const decimalValidator: ValidatorFn = _decimalValidator()\n","import { AbstractControl, ValidatorFn, Validators } from '@angular/forms'\n\nimport { isEmptyInputValue, isNumeric } from '@theseam/ui-common/utils'\n\nexport const INTEGER_REGEX = /^([-+]{1})?[0-9]*$/\n\nfunction _integerValidator(): ValidatorFn {\n  return (control: AbstractControl) => {\n    if (isEmptyInputValue(control.value)) {\n      return null // don't validate empty values to allow optional controls\n    }\n\n    const isInteger =\n      !Array.isArray(control.value) &&\n      isNumeric(control.value) &&\n      Validators.pattern(INTEGER_REGEX)(control) === null\n\n    if (!isInteger) {\n      return { integer: { reason: 'Must be valid integer.' } }\n    }\n    return null\n  }\n}\n\n/**\n * Validates control value is a valid integer number.\n *\n * NOTE: This does not allow any js valid integer number. It only accepts them\n * in a format expected by our backend.\n */\nexport const integerValidator: ValidatorFn = _integerValidator()\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;;AAEA;;;;;;AAMG;AACG,SAAU,cAAc,CAAC,OAAoB,EAAA;IACjD,MAAM,OAAO,GAAG,8CAA8C,CAAC,IAAI,CACjE,OAAO,CAAC,KAAK,CACd;AACD,IAAA,OAAO,OAAO,GAAG,IAAI,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE;AACvC;;ACVA;;AAEG;AACG,SAAU,oBAAoB,CAClC,WAEqD,EAAA;IAErD,OAAO,CAAC,OAAoB,KAAI;AAC9B,QAAA,MAAM,gBAAgB,GAAG,CAAC,MAAe,KAAI;AAC3C,YAAA,OAAO,MAAM,KAAK,KAAK,GAAG,IAAI,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE;AACtD,QAAA,CAAC;QAED,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;AACxC,QAAA,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE;YACvB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC1C;QACA,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;AACtD,IAAA,CAAC;AACH;;ACrBA;;AAEG;AACG,SAAU,oBAAoB,CAAC,OAAoB,EAAA;AACvD,IAAA,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;AAC/B,SAAC,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC;AACxD,UAAE;AACF,UAAE,EAAE,WAAW,EAAE,EAAE,EAAE;AACzB;;ACNO,MAAM,aAAa,GAAG;AAE7B,SAAS,iBAAiB,GAAA;IACxB,OAAO,CAAC,OAAwB,KAAI;AAClC,QAAA,IAAI,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACpC,OAAO,IAAI,CAAA;QACb;QAEA,MAAM,SAAS,GACb,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;AAC7B,YAAA,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC;YACxB,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI;QAErD,IAAI,CAAC,SAAS,EAAE;YACd,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,+BAA+B,EAAE,EAAE;QACjE;AAEA,QAAA,OAAO,IAAI;AACb,IAAA,CAAC;AACH;AAEA;;;;;AAKG;AACI,MAAM,gBAAgB,GAAgB,iBAAiB;;AC3BvD,MAAM,aAAa,GAAG;AAE7B,SAAS,iBAAiB,GAAA;IACxB,OAAO,CAAC,OAAwB,KAAI;AAClC,QAAA,IAAI,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACpC,OAAO,IAAI,CAAA;QACb;QAEA,MAAM,SAAS,GACb,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;AAC7B,YAAA,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC;YACxB,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI;QAErD,IAAI,CAAC,SAAS,EAAE;YACd,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,wBAAwB,EAAE,EAAE;QAC1D;AACA,QAAA,OAAO,IAAI;AACb,IAAA,CAAC;AACH;AAEA;;;;;AAKG;AACI,MAAM,gBAAgB,GAAgB,iBAAiB;;AC9B9D;;AAEG;;;;"}
+{"version":3,"file":"theseam-ui-common-validators.mjs","sources":["../../../projects/ui-common/validators/tax-id.validator.ts","../../../projects/ui-common/validators/email-exists.validator.ts","../../../projects/ui-common/validators/phone-length.validator.ts","../../../projects/ui-common/validators/decimal.validator.ts","../../../projects/ui-common/validators/integer.validator.ts","../../../projects/ui-common/validators/theseam-ui-common-validators.ts"],"sourcesContent":["import { AbstractControl, ValidatorFn } from '@angular/forms'\n\nimport { isEmptyInputValue } from '@theseam/ui-common/utils'\n\nconst TAX_ID_PATTERN = /^\\d{9}$|^\\d{2}-\\d{7}$|^\\d{3}-\\d{2}-\\d{4}$/\n\n/**\n * Validates that value matches one of the following:\n *  'xxxxxxxxx'    // 'x' is a number\n *  'xx-xxxxxxx'   // 'x' is a number\n *  'xxx-xx-xxxx'  // 'x' is a number\n */\nexport const taxIdValidator: ValidatorFn = (control: AbstractControl) => {\n  if (isEmptyInputValue(control.value)) {\n    return null\n  }\n  return TAX_ID_PATTERN.test(control.value) ? null : { taxId: {} }\n}\n","import { FormControl } from '@angular/forms'\nimport { isObservable, Observable } from 'rxjs'\nimport { map } from 'rxjs/operators'\n\n/**\n * Validates that an email already exists.\n */\nexport function emailExistsValidator(\n  emailExists: (\n    email: string,\n  ) => Promise<boolean> | Observable<boolean> | boolean,\n) {\n  return (control: FormControl) => {\n    const validationResult = (exists: boolean) => {\n      return exists === false ? null : { emailExists: {} }\n    }\n\n    const fnRes = emailExists(control.value)\n    if (isObservable(fnRes)) {\n      return fnRes.pipe(map(validationResult))\n    }\n    return Promise.resolve(fnRes).then(validationResult)\n  }\n}\n","import { AbstractControl, ValidatorFn } from '@angular/forms'\n\nimport { isEmptyInputValue } from '@theseam/ui-common/utils'\n\nexport interface TheSeamPhoneLengthConfig {\n  minLength: number\n  maxLength: number\n}\n\nconst DEFAULT_CONFIG: TheSeamPhoneLengthConfig = {\n  minLength: 7,\n  maxLength: 18,\n}\n\n/**\n * Validates that a value is a valid phone number length.\n */\nexport function phoneLengthValidator(\n  config?: Partial<TheSeamPhoneLengthConfig>,\n): ValidatorFn {\n  const c = { ...DEFAULT_CONFIG, ...config }\n  return (control: AbstractControl) => {\n    if (isEmptyInputValue(control.value)) {\n      return null\n    }\n    return control.value.length <= c.maxLength &&\n      control.value.length >= c.minLength\n      ? null\n      : { phoneLength: {} }\n  }\n}\n","import { AbstractControl, ValidatorFn, Validators } from '@angular/forms'\n\nimport { isEmptyInputValue, isNumeric } from '@theseam/ui-common/utils'\n\nexport const DECIMAL_REGEX = /^([-+]{1})?\\d*(\\.\\d*)?$/\n\nexport interface TheSeamDecimalConfig {\n  regex: RegExp\n}\n\nconst DEFAULT_CONFIG: TheSeamDecimalConfig = {\n  regex: DECIMAL_REGEX,\n}\n\n/**\n * Validates control value is a valid decimal number.\n *\n * NOTE: This does not allow any js valid decimal number. It only accepts them\n * in a format expected by our backend.\n */\nexport function decimalValidator(\n  config?: Partial<TheSeamDecimalConfig>,\n): ValidatorFn {\n  const c = { ...DEFAULT_CONFIG, ...config }\n  return (control: AbstractControl) => {\n    if (isEmptyInputValue(control.value)) {\n      return null // don't validate empty values to allow optional controls\n    }\n\n    const isDecimal =\n      !Array.isArray(control.value) &&\n      isNumeric(control.value) &&\n      Validators.pattern(c.regex)(control) === null\n\n    if (!isDecimal) {\n      return { decimal: { reason: 'Must be valid decimal number.' } }\n    }\n\n    return null\n  }\n}\n","import { AbstractControl, ValidatorFn, Validators } from '@angular/forms'\n\nimport { isEmptyInputValue, isNumeric } from '@theseam/ui-common/utils'\n\nexport const INTEGER_REGEX = /^([-+]{1})?[0-9]*$/\n\nexport interface TheSeamIntegerConfig {\n  regex: RegExp\n}\n\nconst DEFAULT_CONFIG: TheSeamIntegerConfig = {\n  regex: INTEGER_REGEX,\n}\n\n/**\n * Validates control value is a valid integer number.\n *\n * NOTE: This does not allow any js valid integer number. It only accepts them\n * in a format expected by our backend.\n */\nexport function integerValidator(\n  config?: Partial<TheSeamIntegerConfig>,\n): ValidatorFn {\n  const c = { ...DEFAULT_CONFIG, ...config }\n  return (control: AbstractControl) => {\n    if (isEmptyInputValue(control.value)) {\n      return null // don't validate empty values to allow optional controls\n    }\n\n    const isInteger =\n      !Array.isArray(control.value) &&\n      isNumeric(control.value) &&\n      Validators.pattern(c.regex)(control) === null\n\n    if (!isInteger) {\n      return { integer: { reason: 'Must be valid integer.' } }\n    }\n    return null\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":["DEFAULT_CONFIG"],"mappings":"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"}

package/framework/index.d.ts

@@ -1,8 +1,9 @@
+import { ValidatorFn, AsyncValidatorFn, FormControl, FormGroup, AbstractControl } from '@angular/forms';
 import * as i0 from '@angular/core';
-import { ElementRef, TemplateRef, OnInit, InjectionToken, OnDestroy, EventEmitter, ComponentRef, EmbeddedViewRef, AfterViewInit, QueryList, ViewContainerRef, AfterContentInit } from '@angular/core';
-import { HasElementRef, CanDisableCtor } from '@theseam/ui-common/core';
+import { DestroyRef, ElementRef, TemplateRef, OnInit, InjectionToken, OnDestroy, EventEmitter, ComponentRef, EmbeddedViewRef, AfterViewInit, QueryList, ViewContainerRef, AfterContentInit } from '@angular/core';
 import * as rxjs from 'rxjs';
-import { Observable, Subject, BehaviorSubject } from 'rxjs';
+import { Observable, Subscription, Subject, BehaviorSubject } from 'rxjs';
+import { HasElementRef, CanDisableCtor } from '@theseam/ui-common/core';
 import * as _fortawesome_fontawesome_common_types from '@fortawesome/fontawesome-common-types';
 import { TemplatePortal, ComponentType, ComponentPortal, BasePortalOutlet, Portal, CdkPortalOutletAttachedRef } from '@angular/cdk/portal';
 import { MediaQueryAliases, TheSeamLayoutService } from '@theseam/ui-common/layout';
@@ -18,9 +19,124 @@ import * as _angular_animations from '@angular/animations';
 import * as i2 from '@angular/common';
 import * as i2$1 from '@ajsf/core';
 import { JsonSchemaFormService, isArray, TitleMapItem, Framework } from '@ajsf/core';
-import { AbstractControl } from '@angular/forms';
 import { TheSeamTiledSelectItem, TheSeamTiledSelectLayout } from '@theseam/ui-common/tiled-select';
 
+interface TheSeamControlValidators {
+    validators: ValidatorFn[];
+    asyncValidators: AsyncValidatorFn[];
+}
+
+interface TheSeamValidatorOverrides {
+    /**
+     * Include `Validators.required`. Set to `false` to exclude it.
+     *
+     * default: true
+     */
+    required?: boolean;
+}
+
+interface TheSeamAddressFieldConfig {
+    address1MaxLength: number;
+    address2MaxLength: number;
+    cityMaxLength: number;
+    stateMaxLength: number;
+    countryMaxLength: number;
+    zipcodePattern: RegExp;
+}
+declare const DEFAULT_ADDRESS_FIELD_CONFIG: TheSeamAddressFieldConfig;
+
+interface TheSeamUsernameFieldConfig {
+    minLength: number;
+    pattern: RegExp;
+}
+declare const DEFAULT_USERNAME_FIELD_CONFIG: TheSeamUsernameFieldConfig;
+
+interface TheSeamCreateCountryControlOptions {
+    /**
+     * Only allow 'USA' as the value.
+     *
+     * default: false
+     */
+    onlyAllowUsa?: boolean;
+}
+
+interface TheSeamAddressFormValue {
+    address1: string | null;
+    address2: string | null;
+    city: string | null;
+    state: string | null;
+    zip: string | null;
+    country: string | null;
+}
+
+interface TheSeamAddressFormGroupOptions {
+    config?: Partial<TheSeamAddressFieldConfig>;
+    stateCodes: Observable<string[]>;
+    /** default: true */
+    countryRequiredOutsideUSA?: boolean;
+    /** default: 'USA' */
+    defaultCountry?: string;
+    /** If provided, country-change subscription is auto-cleaned up. */
+    destroyRef?: DestroyRef;
+}
+type TheSeamAddressFormControls = Record<keyof TheSeamAddressFormValue, FormControl<string | null>>;
+type TheSeamAddressFormGroupResult<T extends TheSeamAddressFormGroupOptions> = T extends {
+    destroyRef: DestroyRef;
+} ? FormGroup<TheSeamAddressFormControls> : {
+    group: FormGroup<TheSeamAddressFormControls>;
+    subscription: Subscription;
+};
+
+declare function isCountryUSA(control: AbstractControl): boolean;
+
+/**
+ * Use Validator if 'country' control value is 'USA'.
+ *
+ * If `countryControlOrPath` is not provided, it will be assumed there is a
+ * sibling named 'country'.
+ */
+declare function ifUSA(fn: ValidatorFn, countryControlOrPath?: AbstractControl | string | (string | number)[]): ValidatorFn;
+
+declare function stateProvinceRegionValidator(stateCodes: Observable<string[]>): AsyncValidatorFn;
+
+type TheSeamUserExistsFn = (userName: string) => Promise<boolean> | Observable<boolean> | boolean;
+/**
+ * Validates that a username already exists.
+ *
+ * Mirrors the `emailExistsValidator` pattern from `@theseam/ui-common/validators`.
+ */
+declare function usernameExistsValidator(userExists: TheSeamUserExistsFn): AsyncValidatorFn;
+
+declare function getAddress1Validators(config?: Partial<TheSeamAddressFieldConfig>, overrides?: TheSeamValidatorOverrides): TheSeamControlValidators;
+
+declare function getAddress2Validators(config?: Partial<TheSeamAddressFieldConfig>, overrides?: TheSeamValidatorOverrides): TheSeamControlValidators;
+
+declare function getCityValidators(config?: Partial<TheSeamAddressFieldConfig>, overrides?: TheSeamValidatorOverrides): TheSeamControlValidators;
+
+declare function getCountryValidators(config?: Partial<TheSeamAddressFieldConfig>, options?: TheSeamCreateCountryControlOptions, overrides?: TheSeamValidatorOverrides): TheSeamControlValidators;
+
+declare function getStateValidators(stateCodes: Observable<string[]>, countryControlOrPath?: AbstractControl | string | (string | number)[], requiredOutsideUSA?: boolean, config?: Partial<TheSeamAddressFieldConfig>): TheSeamControlValidators;
+
+declare function getZipValidators(countryControlOrPath?: AbstractControl | string | (string | number)[], config?: Partial<TheSeamAddressFieldConfig>): TheSeamControlValidators;
+
+declare function getUsernameValidators(userExists: TheSeamUserExistsFn, config?: Partial<TheSeamUsernameFieldConfig>, overrides?: TheSeamValidatorOverrides): TheSeamControlValidators;
+
+declare function createAddress1Control(formState?: string | null, config?: Partial<TheSeamAddressFieldConfig>, overrides?: TheSeamValidatorOverrides): FormControl<string | null>;
+
+declare function createAddress2Control(formState?: string | null, config?: Partial<TheSeamAddressFieldConfig>, overrides?: TheSeamValidatorOverrides): FormControl<string | null>;
+
+declare function createCityControl(formState?: string | null, config?: Partial<TheSeamAddressFieldConfig>, overrides?: TheSeamValidatorOverrides): FormControl<string | null>;
+
+declare function createCountryControl(formState?: string | null, options?: TheSeamCreateCountryControlOptions, overrides?: TheSeamValidatorOverrides): FormControl<string | null>;
+
+declare function createStateControl(formState: string | null | undefined, stateCodes: Observable<string[]>, requiredOutsideUSA?: boolean): FormControl<string | null>;
+
+declare function createZipControl(formState?: string | null): FormControl<string | null>;
+
+declare function createUsernameControl(formState: string | null | undefined, userExists: TheSeamUserExistsFn, config?: Partial<TheSeamUsernameFieldConfig>, overrides?: TheSeamValidatorOverrides): FormControl<string | null>;
+
+declare function createAddressFormGroup<T extends TheSeamAddressFormGroupOptions>(options: T): TheSeamAddressFormGroupResult<T>;
+
 declare class BaseLayoutContentFooterDirective implements HasElementRef {
     readonly _elementRef: ElementRef<any>;
     static ɵfac: i0.ɵɵFactoryDeclaration<BaseLayoutContentFooterDirective, never>;
@@ -1454,5 +1570,5 @@ declare class SeamRouteShellComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<SeamRouteShellComponent, "seam-route-shell", never, {}, {}, never, never, true, never>;
 }
 
-export { BaseLayoutContentDirective, BaseLayoutContentFooterDirective, BaseLayoutContentHeaderDirective, BaseLayoutSideBarDirective, BaseLayoutSideBarFooterDirective, BaseLayoutSideBarHeaderDirective, BaseLayoutTopBarDirective, DEFAULT_SIDE_NAV_CONFIG, DashboardComponent, DashboardWidgetContainerComponent, DashboardWidgetPortalOutletDirective, DashboardWidgetTemplateContainerComponent, DashboardWidgetsComponent, DashboardWidgetsPreferencesService, DashboardWidgetsService, HierarchyLevelResolver, HierarchyRouterOutletComponent, HorizontalNavComponent, NavItemComponent, SeamRouteShellComponent, SideNavComponent, SideNavItemComponent, SideNavToggleComponent, THESEAM_BASE_LAYOUT_REF, THESEAM_DASHBOARD_WIDGETS_PREFERENCES_ACCESSOR, THESEAM_SCHEMA_FRAMEWORK_OVERRIDES, THESEAM_SIDE_NAV_ACCESSOR, THESEAM_SIDE_NAV_CONFIG, THE_SEAM_BASE_LAYOUT, TheSeamBaseLayoutComponent, TheSeamBaseLayoutModule, TheSeamBaseLayoutNavToggleDirective, TheSeamDashboardModule, TheSeamDynamicRouterModule, TheSeamFramework, TheSeamNavModule, TheSeamSchemaFormFrameworkComponent, TheSeamSchemaFormModule, TheSeamSideNavModule, TheSeamTopBarComponent, TheSeamTopBarModule, TopBarCompactMenuBtnDetailDirective, TopBarItemDirective, TopBarMenuBtnDetailDirective, TopBarMenuButtonComponent, TopBarMenuDirective, TopBarNavToggleBtnDetailDirective, TopBarTitleComponent, applyItemConfig, areSameHorizontalNavItem, canBeActive, canExpand, canHaveChildren, computeDirection, extendFramework, fader, findHorizontalNavLinkItems, findLinkItems, getHorizontalNavItemStateProp, getItemStateProp, getUrlSegments, hasActiveChild, hasChildren, hasExpandedChild, horizontalNavItemCanBeActive, horizontalNavItemCanExpand, horizontalNavItemCanHaveChildren, horizontalNavItemHasActiveChild, horizontalNavItemHasChildren, horizontalNavItemHasExpandedChild, isExpanded, isHorizontalNavItemActive, isHorizontalNavItemExpanded, isHorizontalNavItemFocused, isHorizontalNavItemType, isNavItemActive, isNavItemType, routeChanges, seamRouteTransition, setDefaultHorizontalNavItemState, setDefaultState, setHorizontalNavItemStateProp, setItemStateProp, sideNavExpandStateChangeFn, sideToSide, slider, stepper, transformer };
-export type { IDashboardWidgetItemLayout, IDashboardWidgetItemLayoutPreference, IDashboardWidgetsColumnRecord, IDashboardWidgetsItem, IDashboardWidgetsItemDef, IDashboardWidgetsItemSerialized, IDashboardWidgetsPreferences, IDashboardWidgetsPreferencesMapRecord, IDynamicRouteDef, INavBadge, INavBasic, INavButton, INavDivider, INavItem, INavItemBase, INavItemState, INavLink, INavTitle, ISideNavBadge, ISideNavBasic, ISideNavButton, ISideNavDivider, ISideNavItem, ISideNavItemBase, ISideNavItemState, ISideNavLink, ISideNavTitle, ITheSeamDashboardWidgetsPreferencesAccessor, NavItemBadgeTooltip, NavItemCanHaveChildren, NavItemCanHaveState, NavItemChildAction, NavItemExpandAction, NavItemExpandedEvent, NavItemStateChanged, RouteDirection, SideNavAccessor, SideNavConfig, SideNavItemBadgeTooltip, SideNavItemCanBeActive, SideNavItemCanHaveChildren, SideNavItemCanHaveState, SideNavItemMenuItemTooltipBehavior, SideNavItemMenuItemTooltipConfig, SideNavItemStateChanged, TheSeamBaseLayoutAction, TheSeamBaseLayoutActionBase, TheSeamBaseLayoutActionButton, TheSeamBaseLayoutActionHref, TheSeamBaseLayoutActionRouterLink, TheSeamBaseLayoutActionTemplate, TheSeamBaseLayoutNav, TheSeamBaseLayoutRef, TheSeamSchemaFormControlWidget, TheSeamSchemaFormFrameworkOverrides, TheSeamSchemaFormWidget, TheSeamSchemaFormWidgetLayoutNodeOptions, TopBarPosition };
+export { BaseLayoutContentDirective, BaseLayoutContentFooterDirective, BaseLayoutContentHeaderDirective, BaseLayoutSideBarDirective, BaseLayoutSideBarFooterDirective, BaseLayoutSideBarHeaderDirective, BaseLayoutTopBarDirective, DEFAULT_ADDRESS_FIELD_CONFIG, DEFAULT_SIDE_NAV_CONFIG, DEFAULT_USERNAME_FIELD_CONFIG, DashboardComponent, DashboardWidgetContainerComponent, DashboardWidgetPortalOutletDirective, DashboardWidgetTemplateContainerComponent, DashboardWidgetsComponent, DashboardWidgetsPreferencesService, DashboardWidgetsService, HierarchyLevelResolver, HierarchyRouterOutletComponent, HorizontalNavComponent, NavItemComponent, SeamRouteShellComponent, SideNavComponent, SideNavItemComponent, SideNavToggleComponent, THESEAM_BASE_LAYOUT_REF, THESEAM_DASHBOARD_WIDGETS_PREFERENCES_ACCESSOR, THESEAM_SCHEMA_FRAMEWORK_OVERRIDES, THESEAM_SIDE_NAV_ACCESSOR, THESEAM_SIDE_NAV_CONFIG, THE_SEAM_BASE_LAYOUT, TheSeamBaseLayoutComponent, TheSeamBaseLayoutModule, TheSeamBaseLayoutNavToggleDirective, TheSeamDashboardModule, TheSeamDynamicRouterModule, TheSeamFramework, TheSeamNavModule, TheSeamSchemaFormFrameworkComponent, TheSeamSchemaFormModule, TheSeamSideNavModule, TheSeamTopBarComponent, TheSeamTopBarModule, TopBarCompactMenuBtnDetailDirective, TopBarItemDirective, TopBarMenuBtnDetailDirective, TopBarMenuButtonComponent, TopBarMenuDirective, TopBarNavToggleBtnDetailDirective, TopBarTitleComponent, applyItemConfig, areSameHorizontalNavItem, canBeActive, canExpand, canHaveChildren, computeDirection, createAddress1Control, createAddress2Control, createAddressFormGroup, createCityControl, createCountryControl, createStateControl, createUsernameControl, createZipControl, extendFramework, fader, findHorizontalNavLinkItems, findLinkItems, getAddress1Validators, getAddress2Validators, getCityValidators, getCountryValidators, getHorizontalNavItemStateProp, getItemStateProp, getStateValidators, getUrlSegments, getUsernameValidators, getZipValidators, hasActiveChild, hasChildren, hasExpandedChild, horizontalNavItemCanBeActive, horizontalNavItemCanExpand, horizontalNavItemCanHaveChildren, horizontalNavItemHasActiveChild, horizontalNavItemHasChildren, horizontalNavItemHasExpandedChild, ifUSA, isCountryUSA, isExpanded, isHorizontalNavItemActive, isHorizontalNavItemExpanded, isHorizontalNavItemFocused, isHorizontalNavItemType, isNavItemActive, isNavItemType, routeChanges, seamRouteTransition, setDefaultHorizontalNavItemState, setDefaultState, setHorizontalNavItemStateProp, setItemStateProp, sideNavExpandStateChangeFn, sideToSide, slider, stateProvinceRegionValidator, stepper, transformer, usernameExistsValidator };
+export type { IDashboardWidgetItemLayout, IDashboardWidgetItemLayoutPreference, IDashboardWidgetsColumnRecord, IDashboardWidgetsItem, IDashboardWidgetsItemDef, IDashboardWidgetsItemSerialized, IDashboardWidgetsPreferences, IDashboardWidgetsPreferencesMapRecord, IDynamicRouteDef, INavBadge, INavBasic, INavButton, INavDivider, INavItem, INavItemBase, INavItemState, INavLink, INavTitle, ISideNavBadge, ISideNavBasic, ISideNavButton, ISideNavDivider, ISideNavItem, ISideNavItemBase, ISideNavItemState, ISideNavLink, ISideNavTitle, ITheSeamDashboardWidgetsPreferencesAccessor, NavItemBadgeTooltip, NavItemCanHaveChildren, NavItemCanHaveState, NavItemChildAction, NavItemExpandAction, NavItemExpandedEvent, NavItemStateChanged, RouteDirection, SideNavAccessor, SideNavConfig, SideNavItemBadgeTooltip, SideNavItemCanBeActive, SideNavItemCanHaveChildren, SideNavItemCanHaveState, SideNavItemMenuItemTooltipBehavior, SideNavItemMenuItemTooltipConfig, SideNavItemStateChanged, TheSeamAddressFieldConfig, TheSeamAddressFormControls, TheSeamAddressFormGroupOptions, TheSeamAddressFormGroupResult, TheSeamAddressFormValue, TheSeamBaseLayoutAction, TheSeamBaseLayoutActionBase, TheSeamBaseLayoutActionButton, TheSeamBaseLayoutActionHref, TheSeamBaseLayoutActionRouterLink, TheSeamBaseLayoutActionTemplate, TheSeamBaseLayoutNav, TheSeamBaseLayoutRef, TheSeamControlValidators, TheSeamCreateCountryControlOptions, TheSeamSchemaFormControlWidget, TheSeamSchemaFormFrameworkOverrides, TheSeamSchemaFormWidget, TheSeamSchemaFormWidgetLayoutNodeOptions, TheSeamUserExistsFn, TheSeamUsernameFieldConfig, TheSeamValidatorOverrides, TopBarPosition };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theseam/ui-common",
-  "version": "1.0.2-beta.39",
+  "version": "1.0.2-beta.42",
   "peerDependencies": {
     "@angular/cdk": "^20.2.3",
     "@angular/common": "^20.3.0",

package/validators/index.d.ts

@@ -1,16 +1,13 @@
-import { FormControl, ValidatorFn } from '@angular/forms';
+import { ValidatorFn, FormControl } from '@angular/forms';
 import { Observable } from 'rxjs';
 
 /**
- * Validates that value matches on of the following:
- *  ''             // empty string
+ * Validates that value matches one of the following:
  *  'xxxxxxxxx'    // 'x' is a number
  *  'xx-xxxxxxx'   // 'x' is a number
  *  'xxx-xx-xxxx'  // 'x' is a number
  */
-declare function taxIdValidator(control: FormControl): {
-    taxId: {};
-} | null;
+declare const taxIdValidator: ValidatorFn;
 
 /**
  * Validates that an email already exists.
@@ -21,29 +18,38 @@ declare function emailExistsValidator(emailExists: (email: string) => Promise<bo
     emailExists: {};
 } | null>;
 
+interface TheSeamPhoneLengthConfig {
+    minLength: number;
+    maxLength: number;
+}
 /**
  * Validates that a value is a valid phone number length.
  */
-declare function phoneLengthValidator(control: FormControl): {
-    phoneLength: {};
-} | null;
+declare function phoneLengthValidator(config?: Partial<TheSeamPhoneLengthConfig>): ValidatorFn;
 
 declare const DECIMAL_REGEX: RegExp;
+interface TheSeamDecimalConfig {
+    regex: RegExp;
+}
 /**
  * Validates control value is a valid decimal number.
  *
  * NOTE: This does not allow any js valid decimal number. It only accepts them
  * in a format expected by our backend.
  */
-declare const decimalValidator: ValidatorFn;
+declare function decimalValidator(config?: Partial<TheSeamDecimalConfig>): ValidatorFn;
 
 declare const INTEGER_REGEX: RegExp;
+interface TheSeamIntegerConfig {
+    regex: RegExp;
+}
 /**
  * Validates control value is a valid integer number.
  *
  * NOTE: This does not allow any js valid integer number. It only accepts them
  * in a format expected by our backend.
  */
-declare const integerValidator: ValidatorFn;
+declare function integerValidator(config?: Partial<TheSeamIntegerConfig>): ValidatorFn;
 
 export { DECIMAL_REGEX, INTEGER_REGEX, decimalValidator, emailExistsValidator, integerValidator, phoneLengthValidator, taxIdValidator };
+export type { TheSeamDecimalConfig, TheSeamIntegerConfig, TheSeamPhoneLengthConfig };