@spider-baby/utils-forms 2.0.3 → 2.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spider-baby/utils-forms",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "A comprehensive Angular forms utility library for streamlined validation, error handling, and accessible error display.",
   "keywords": [
     "angular",
@@ -21,28 +21,15 @@
   "license": "MIT",
   "main": "./bundles/utils-forms.umd.js",
   "module": "fesm2022/spider-baby-utils-forms.mjs",
-  "es2020": "./fesm2020/utils-forms.mjs",
-  "esm2020": "./esm2020/utils-forms.mjs",
-  "types": "./index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./types/spider-baby-utils-forms.d.ts",
-      "default": "./fesm2022/spider-baby-utils-forms.mjs"
-    },
-    "./package.json": {
-      "default": "./package.json"
-    },
-    "./validators": {
-      "types": "./types/spider-baby-utils-forms-validators.d.ts",
-      "default": "./fesm2022/spider-baby-utils-forms-validators.mjs"
-    }
-  },
+  "es2020": "./fesm2020/spider-baby-utils-forms.mjs",
+  "esm2020": "./esm2020/spider-baby-utils-forms.mjs",
+  "types": "./types/spider-baby-utils-forms.d.ts",
   "files": [
     "bundles/",
     "fesm2022/",
     "fesm2020/",
     "esm2020/",
-    "index.d.ts",
+    "types/",
     "package.json",
     "README.md"
   ],
@@ -57,6 +44,19 @@
   },
   "sideEffects": false,
   "typings": "types/spider-baby-utils-forms.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/spider-baby-utils-forms.d.ts",
+      "default": "./fesm2022/spider-baby-utils-forms.mjs"
+    },
+    "./validators": {
+      "types": "./types/spider-baby-utils-forms-validators.d.ts",
+      "default": "./fesm2022/spider-baby-utils-forms-validators.mjs"
+    }
+  },
   "dependencies": {
     "tslib": "^2.3.0"
   }

package/types/spider-baby-utils-forms-validators.d.ts

@@ -0,0 +1,29 @@
+import { ValidatorFn, ValidationErrors } from '@angular/forms';
+import { CountryCode } from 'libphonenumber-js';
+
+declare class NumericValidation {
+    static lessThanValidator(minControlName: string, maxControlName: string, strictlyLessThan?: boolean, errorMessage?: string): ValidatorFn;
+}
+
+declare class PasswordValidation {
+    static validationArray: (minLength?: number) => ValidatorFn[];
+    static matchValidator(passwordControlName?: string, confirmPasswordControlName?: string, errorMessage?: string): ValidatorFn;
+    static patternValidator(regex: RegExp, error: ValidationErrors): ValidatorFn;
+    static hasUppercaseValidator(): ValidatorFn;
+    static hasLowercaseValidator(): ValidatorFn;
+    static hasNumberValidator(): ValidatorFn;
+    static hasNonAlphaNumericValidator(): ValidatorFn;
+}
+
+declare const StrongPassword6Regx: RegExp;
+declare const StrongPassword6WithSpecialRegx: RegExp;
+declare const StrongPassword8Regx: RegExp;
+declare const StrongPassword8WithSpecialRegx: RegExp;
+declare const StrongPassword10Regx: RegExp;
+declare const StrongPassword10WithSpecialRegx: RegExp;
+
+declare class PhoneValidation {
+    static validator(defaultCountry?: CountryCode): ValidatorFn;
+}
+
+export { NumericValidation, PasswordValidation, PhoneValidation, StrongPassword10Regx, StrongPassword10WithSpecialRegx, StrongPassword6Regx, StrongPassword6WithSpecialRegx, StrongPassword8Regx, StrongPassword8WithSpecialRegx };

package/types/spider-baby-utils-forms.d.ts

@@ -0,0 +1,93 @@
+import * as i0 from '@angular/core';
+import { TemplateRef, OnDestroy } from '@angular/core';
+import { AbstractControl, FormGroup } from '@angular/forms';
+
+declare class FirstErrorComponent {
+    control: i0.InputSignal<AbstractControl<any, any, any>>;
+    customErrorTemplate: i0.InputSignal<TemplateRef<unknown> | undefined>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FirstErrorComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FirstErrorComponent, "sb-first-error", never, { "control": { "alias": "control"; "required": true; "isSignal": true; }; "customErrorTemplate": { "alias": "customErrorTemplate"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare class FirstErrorMatComponent {
+    control: i0.InputSignal<AbstractControl<any, any, any>>;
+    customErrorTemplate: i0.InputSignal<TemplateRef<unknown> | undefined>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FirstErrorMatComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FirstErrorMatComponent, "sb-first-error-mat", never, { "control": { "alias": "control"; "required": true; "isSignal": true; }; "customErrorTemplate": { "alias": "customErrorTemplate"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+type ErrorMessageFunction = (fieldName: string, errorValue: any) => string;
+type CustomErrorMessageMap = Map<string, ErrorMessageFunction>;
+declare class FormErrors {
+    static setFirstErrors(form: FormGroup, customErrorMessages?: CustomErrorMessageMap): void;
+    static setFirstErrorMessage(name: string, control: AbstractControl, customErrorMessages?: CustomErrorMessageMap): void;
+    static getFirstErrorMessage(name: string, control: AbstractControl, customErrorMessages?: CustomErrorMessageMap): string | null;
+    private static firstErrorKey;
+    private static toTitleCase;
+}
+
+/**
+ * Directive: sbFormControlFirstError
+ *
+ * Automatically manages and displays the first validation error for each control in a FormGroup.
+ * - Shows errors only after controls are touched (unless showUntouched is true)
+ * - Dynamically adds blur/focusout listeners for untouched invalid controls
+ * - Supports custom error messages via CustomErrorMessageMap
+ * - Cleans up all listeners and subscriptions on destroy
+ * - SSR-safe: all DOM access is guarded by isPlatformBrowser
+ *
+ * Limitations:
+ * - Dynamic form changes (adding/removing controls at runtime) are NOT automatically handled in this version.
+ *   If you add or remove controls after initialization, you must manually re-run error setup logic.
+ *   (This feature is planned for a future release.)
+ */
+declare class FirstErrorDirective implements OnDestroy {
+    private _platformId;
+    private _renderer;
+    private _host;
+    set sbFormControlFirstError(form: FormGroup);
+    /**
+     * Custom error messages map to override default error messages.
+     * If map returns undefined for a specific error, the default message map will be used.
+     */
+    customErrorMessages?: CustomErrorMessageMap;
+    /**
+     * If true, errors will be shown immediately for untouched controls.
+     * If false, errors will only be shown after the control is touched.
+     * Default is false.
+     */
+    showUntouched: boolean;
+    private _form?;
+    private _vcSub?;
+    private blurListeners;
+    ngOnDestroy(): void;
+    private addBlurListener;
+    private removeAllBlurListeners;
+    private observeValueChanges;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FirstErrorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<FirstErrorDirective, "[sbFormControlFirstError]", never, { "sbFormControlFirstError": { "alias": "sbFormControlFirstError"; "required": true; }; "customErrorMessages": { "alias": "customErrorMessages"; "required": false; }; "showUntouched": { "alias": "showUntouched"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+interface ControlData {
+    name: string;
+    control: AbstractControl;
+}
+declare class FormUtility {
+    static findInvalidControlNames(form: FormGroup): Set<string>;
+    static findInvalidControlInfo(form: FormGroup): Set<string>;
+    static findInvalidControls(form: FormGroup): AbstractControl[];
+    static findInvalidControlsData(form: FormGroup): ControlData[];
+    static replaceNullWithUndefined(obj: Record<string, any>): Record<string, any>;
+    static getFirstFormError(form: FormGroup): Record<string, any> | null;
+    static firstErrorKey: (control: AbstractControl) => string | null;
+}
+
+declare class RemoveNullsService<T> {
+    remove: (obj: T) => T;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RemoveNullsService<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<RemoveNullsService<any>>;
+}
+declare function RemoveNulls<T>(obj: T, iterate?: boolean): T;
+
+export { FirstErrorComponent, FirstErrorDirective, FirstErrorMatComponent, FormErrors, FormUtility, RemoveNulls, RemoveNullsService };
+export type { ControlData, CustomErrorMessageMap, ErrorMessageFunction };