@spider-baby/utils-forms 1.0.0

package/README.md

@@ -0,0 +1,377 @@
+# Spider Baby Form Utils 
+
+A comprehensive Angular forms utility library that provides streamlined form validation and error handling with automatic error display and user-friendly messaging.
+
+## Overview
+
+This library simplifies Angular form validation by providing:
+- **Automatic error detection** and display
+- **First error only** display strategy to avoid overwhelming users
+- **Accessible error messages** with ARIA attributes
+- **Smooth animations** for error state transitions
+- **Customizable error messaging** system
+- **Touch-based validation** (errors only show after user interaction)
+
+## Core Components
+
+### 🎯 FirstErrorDirective
+
+A powerful directive that automatically manages form validation state and displays the first error for each form control.
+
+**Selector:** `[sbFormControlFirstError]`
+
+#### Features
+- Automatically monitors form status changes
+- Shows only the first validation error per control
+- Respects touched/untouched state (errors only show after user interaction)
+- Supports custom error messages
+- Memory leak prevention with automatic subscription cleanup
+
+#### Basic Usage
+
+```typescript
+// Component
+export class LoginFormComponent {
+  protected _form: FormGroup<LoginForm> = this.fb.nonNullable.group({
+    email: ['', [Validators.required, Validators.email]],
+    password: ['', [Validators.required, Validators.minLength(3)]],
+    rememberMe: [false, []]
+  });
+}
+```
+
+```html
+<!-- Template - Apply directive to form element -->
+<form [formGroup]="_form" 
+      [sbFormControlFirstError]="_form" 
+      (ngSubmit)="submit()">
+  
+  <div class="form-group">
+    <input type="email" 
+           formControlName="email" 
+           placeholder="Enter your email"/>
+    <sb-first-error [control]="_form.controls.email"/>
+  </div>
+  
+  <div class="form-group">
+    <input type="password" 
+           formControlName="password" 
+           placeholder="Enter your password"/>
+    <sb-first-error [control]="_form.controls.password"/>
+  </div>
+</form>
+```
+
+#### Advanced Configuration
+
+```html
+<!-- Custom error messages -->
+<form [formGroup]="myForm" 
+      [sbFormControlFirstError]="myForm"
+      [customErrorMessages]="customMessages">
+  <!-- form controls -->
+</form>
+
+<!-- Show errors immediately (bypass touch requirement) -->
+<form [formGroup]="myForm" 
+      [sbFormControlFirstError]="myForm"
+      [showUntouched]="true">
+  <!-- form controls -->
+</form>
+```
+
+#### Inputs
+
+| Property                  | Type                    | Default      | Description                         |
+| ------------------------- | ----------------------- | ------------ | ----------------------------------- |
+| `sbFormControlFirstError` | `FormGroup`             | **required** | The reactive form to monitor        |
+| `customErrorMessages`     | `CustomErrorMessageMap` | `undefined`  | Custom error message mappings       |
+| `showUntouched`           | `boolean`               | `false`      | Show errors before user interaction |
+
+### 🎨 FirstErrorComponent
+
+A standalone component that displays validation errors with smooth animations and accessibility features.
+
+**Selector:** `sb-first-error`
+
+#### Features
+- Displays only the first validation error
+- Smooth fade-in animation for error appearance
+- ARIA live regions for screen reader compatibility
+
+#### Usage
+
+```html
+<!-- Basic usage -->
+<sb-first-error [control]="myForm.controls.fieldName"/>
+
+<!-- Real example from login form -->
+<input type="email" 
+       formControlName="email" 
+       placeholder="Enter your email"/>
+<sb-first-error [control]="_form.controls.email"/>
+```
+
+#### Styling
+
+The component uses CSS custom properties for easy theming:
+
+```css
+sb-first-error {
+  --error-color: #custom-error-color;
+}
+```
+
+**Default styling:**
+- Color: Material Design error color with fallback (`var(--mat-sys-error, #d9534f);`)
+- Font size: 0.875rem
+- Smooth fade-in animation
+- Accessible spacing and layout
+
+#### Inputs
+
+| Property  | Type              | Description                                          |
+| --------- | ----------------- | ---------------------------------------------------- |
+| `control` | `AbstractControl` | **Required.** The form control to display errors for |
+
+## Installation & Setup
+
+### 1. Import the Library
+
+```typescript
+import { 
+  FirstErrorDirective, 
+  FirstErrorComponent 
+} from '@spider-baby/utils-forms';
+
+@Component({
+  standalone: true,
+  imports: [
+    ReactiveFormsModule,
+    FirstErrorDirective,
+    FirstErrorComponent,
+    // ...other imports
+  ],
+  // ...component definition
+})
+export class MyFormComponent { }
+```
+
+### 2. Apply to Your Form
+
+```html
+<form [formGroup]="myForm" [sbFormControlFirstError]="myForm">
+  <!-- Your form controls with error display -->
+  <input formControlName="email" />
+  <sb-first-error [control]="myForm.controls.email"/>
+</form>
+```
+
+## Real-World Example
+
+Here's a complete login form implementation using the library:
+
+```typescript
+// login.component.ts
+@Component({
+  selector: 'sb-login-form',
+  standalone: true,
+  imports: [
+    ReactiveFormsModule,
+    FirstErrorDirective,
+    FirstErrorComponent,
+    // ...other imports
+  ],
+  templateUrl: './login.component.html',
+  styleUrl: './login.component.scss',
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class LoginFormComponent {
+  private fb = inject(FormBuilder)
+
+  protected _form: FormGroup<LoginForm> = this.fb.nonNullable.group({
+    email: ['', [Validators.required, Validators.email]],
+    password: ['', [Validators.required, Validators.minLength(3)]],
+    rememberMe: [false, []]
+  });
+
+  submit() {
+    if (!this._form.valid) return;
+    
+    const dto: LoginFormDto = {
+      email: this._form.controls.email.value,
+      password: this._form.controls.password.value,
+      rememberMe: this._form.controls.rememberMe.value,
+    };
+    
+    this.login.emit(dto);
+  }
+}
+```
+
+```html
+<!-- login.component.html -->
+<form [formGroup]="_form" 
+      [sbFormControlFirstError]="_form" 
+      (ngSubmit)="submit()" 
+      class="login-form">
+      
+  <div class="form-group">
+    <label for="email">Email</label>
+    <input id="email" 
+           type="email" 
+           formControlName="email" 
+           placeholder="Enter your email"/>
+    <sb-first-error [control]="_form.controls.email"/>
+  </div>
+  
+  <div class="form-group">
+    <label for="password">Password</label>
+    <input id="password" 
+           type="password" 
+           formControlName="password" 
+           placeholder="Enter your password"/>
+    <sb-first-error [control]="_form.controls.password"/>
+  </div>
+
+  <button type="submit" [disabled]="_form.invalid">
+    Login
+  </button>
+</form>
+```
+
+## Error Message Customization
+
+### Default Error Messages
+
+The library provides sensible defaults for common validation errors:
+
+| Error Key        | Example Message                                                                                                     |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------- |
+| required         | `Email is required.`                                                                                                |
+| email            | `Please enter a valid email address.`                                                                               |
+| minlength        | `Password must be at least 8 characters.`                                                                           |
+| maxlength        | `Field must be no more than 20 characters.`                                                                         |
+| pattern          | `Field format is invalid.`                                                                                          |
+| min              | `Value must be at least 1.`                                                                                         |
+| max              | `Value must be no more than 100.`                                                                                   |
+| passwordMismatch | `Passwords do not match.`                                                                                           |
+| mustMatch        | `Fields do not match.`                                                                                              |
+| whitespace       | `Field cannot contain only whitespace.`                                                                             |
+| forbiddenValue   | `Field cannot be "forbidden".`                                                                                      |
+| asyncValidation  | `Field validation is pending...`                                                                                    |
+| invalidDate      | `Please enter a valid date.`                                                                                        |
+| futureDate       | `Date must be in the future.`                                                                                       |
+| pastDate         | `Date must be in the past.`                                                                                         |
+| strongPassword   | `Password must contain at least one uppercase letter, one lowercase letter, one number, and one special character.` |
+| phoneNumber      | `Please enter a valid phone number.`                                                                                |
+| url              | `Please enter a valid URL.`                                                                                         |
+| unique           | `This field is already taken.`                                                                                      |
+| fileSize         | `File size must be less than 2MB.`                                                                                  |
+| fileType         | `Only PDF, DOCX files are allowed.`                                                                                 |
+
+> **Note:** Some messages are parameterized and will display the actual field name or value as appropriate.
+
+### Custom Error Messages
+
+```typescript
+import { CustomErrorMessageMap } from '@spider-baby/utils-forms';
+
+const customMessages: CustomErrorMessageMap = new Map([
+  ['email', (field, error) => {
+    if (error.required) return 'Email address is mandatory';
+    if (error.email) return 'Please provide a valid email format';
+    return '';
+  }],
+  ['password', (field, error) => {
+    if (error.required) return 'Password cannot be empty';
+    if (error.minlength) return 'Password must be at least 8 characters long';
+    return '';
+  }],
+]);
+```
+
+```html
+<form [formGroup]="myForm" 
+      [sbFormControlFirstError]="myForm"
+      [customErrorMessages]="customMessages">
+  <!-- form controls -->
+</form>
+```
+
+
+#### 🌎 Example: Custom Error Messages in Spanish
+
+```typescript
+import { CustomErrorMessageMap } from '@spider-baby/utils-forms';
+
+const customMessagesEs: CustomErrorMessageMap = new Map([
+  ['email', (field, error) => {
+    if (error.required) return 'El correo electrónico es obligatorio';
+    if (error.email) return 'Por favor, introduce un correo electrónico válido';
+    return '';
+  }],
+  ['password', (field, error) => {
+    if (error.required) return 'La contraseña no puede estar vacía';
+    if (error.minlength) return 'La contraseña debe tener al menos 8 caracteres';
+    return '';
+  }],
+]);
+```
+
+```html
+<form [formGroup]="myForm" 
+      [sbFormControlFirstError]="myForm"
+      [customErrorMessages]="customMessagesEs">
+  <!-- form controls -->
+</form>
+```
+
+#### Custom Error Template
+
+You can provide a custom error message template to `sb-first-error` using the `customErrorTemplate` input. This allows you to fully control the rendering and styling of error messages.
+
+**Usage:**
+
+```html
+<sb-first-error [control]="form.controls.email" [customErrorTemplate]="customErrorMessageTemplate"/>
+
+<ng-template #customErrorMessageTemplate let-errorMessage="errorMessage">
+  <h3 class="custom-error">****{{errorMessage}}****</h3>
+</ng-template>
+```
+
+**Inputs Table:**
+
+| Property              | Type                        | Description                                      |
+|-----------------------|-----------------------------|--------------------------------------------------|
+| `control`             | `AbstractControl`           | **Required.** The form control to display errors for |
+| `customErrorTemplate` | `TemplateRef<unknown>`      | Optional. Custom template for error message display |
+
+If `customErrorTemplate` is provided, it will be used to render the error message. The template receives an `errorMessage` context variable containing the error text.
+
+> **Limitation:**  
+> Dynamic form changes (adding or removing controls at runtime) are **not automatically handled** in this version.  
+> If you add or remove controls after initialization, you must manually re-run the error setup logic (e.g., by calling the directive's setup method again).  
+> Support for automatic handling of dynamic form changes is planned for a future release.
+
+## Running unit tests
+
+Run `nx test spider-baby-utils-forms` to execute the unit tests.
+
+## Contributing
+
+This library is part of the Spider Baby ecosystem. For contributions:
+
+1. Follow the established coding standards
+2. Add comprehensive tests for new features
+3. Update documentation for API changes
+4. Ensure accessibility compliance
+
+## License
+
+Part of the Spider Baby utilities collection.
+
+---
+
+**Built with ❤️ for better Angular forms**

package/fesm2022/spider-baby-utils-forms-validators.mjs

@@ -0,0 +1,141 @@
+import { Validators } from '@angular/forms';
+import { validatePhoneNumberLength, ParseError } from 'libphonenumber-js';
+
+//##########################//
+class NumericValidation {
+    // Custom validator for password confirmation
+    static lessThanValidator(minControlName, maxControlName, strictlyLessThan = true, errorMessage) {
+        return (control) => {
+            const minControl = control.get(minControlName);
+            const maxControl = control.get(maxControlName);
+            if (!minControl || !maxControl)
+                return null;
+            const minValue = Number(minControl.value);
+            const maxValue = Number(maxControl.value);
+            if (isNaN(minValue) || isNaN(maxValue))
+                return null;
+            if (minValue < maxValue)
+                return null;
+            if (!strictlyLessThan && minValue == maxValue)
+                return null;
+            return {
+                minMaxError: {
+                    message: errorMessage ?? `${minControlName} must be less ${!strictlyLessThan ? 'or equal to' : ''}  than ${maxControlName}`,
+                    code: 'minMaxError',
+                    minControlName,
+                    maxControlName
+                }
+            };
+        };
+    }
+} //Cls
+
+//##########################//
+class PasswordValidation {
+    static validationArray = (minLength = 6) => [
+        Validators.required,
+        Validators.minLength(minLength),
+        PasswordValidation.hasLowercaseValidator(),
+        PasswordValidation.hasUppercaseValidator(),
+        PasswordValidation.hasNumberValidator(),
+        PasswordValidation.hasNonAlphaNumericValidator(),
+    ];
+    //----------------------------//
+    // Custom validator for password confirmation
+    static matchValidator(passwordControlName = 'password', confirmPasswordControlName = 'confirmPassword', errorMessage = "Passwords don't match") {
+        return (control) => {
+            const password = control.get(passwordControlName);
+            const confirmPassword = control.get(confirmPasswordControlName);
+            if (!password || !confirmPassword)
+                return null;
+            return password.value === confirmPassword.value
+                ? null
+                : { passwordMismatch: errorMessage ?? "Passwords don't match" };
+        };
+    }
+    //----------------------------//
+    static patternValidator(regex, error) {
+        return (control) => {
+            // if control is empty return no error
+            if (!control.value)
+                return null;
+            // test the value of the control against the regexp supplied
+            const valid = regex.test(control.value);
+            // if true, return no error (no error), else return error passed in the second parameter
+            return valid ? null : error;
+        };
+    }
+    //----------------------------//
+    static hasUppercaseValidator() {
+        return PasswordValidation.patternValidator(/[A-Z]/, {
+            hasUpper: 'Password must contain at least 1 uppercase letter',
+        });
+    }
+    //----------------------------//
+    static hasLowercaseValidator() {
+        return PasswordValidation.patternValidator(/[a-z]/, {
+            hasLower: 'Password must contain at least 1 lowercase letter',
+        });
+    }
+    //----------------------------//
+    static hasNumberValidator() {
+        return PasswordValidation.patternValidator(/\d/, {
+            hasNumber: 'Password must contain at least 1 number',
+        });
+    }
+    //----------------------------//
+    static hasNonAlphaNumericValidator() {
+        return PasswordValidation.patternValidator(/\W/, {
+            hasNonAlpahaNumeric: 'Password must contain at least 1 non-alphanumeric character',
+        });
+    }
+} //Cls
+
+const StrongPassword6Regx = /^(?=[^A-Z]*[A-Z])(?=[^a-z]*[a-z])(?=\D*\d).{6,}$/;
+const StrongPassword6WithSpecialRegx = /^(?=[^A-Z]*[A-Z])(?=[^a-z]*[a-z])(?=\D*\d)(?=.*[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]).{6,}$/;
+const StrongPassword8Regx = /^(?=[^A-Z]*[A-Z])(?=[^a-z]*[a-z])(?=\D*\d).{8,}$/;
+const StrongPassword8WithSpecialRegx = /^(?=[^A-Z]*[A-Z])(?=[^a-z]*[a-z])(?=\D*\d)(?=.*[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]).{8,}$/;
+const StrongPassword10Regx = /^(?=[^A-Z]*[A-Z])(?=[^a-z]*[a-z])(?=\D*\d).{10,}$/;
+const StrongPassword10WithSpecialRegx = /^(?=[^A-Z]*[A-Z])(?=[^a-z]*[a-z])(?=\D*\d)(?=.*[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]).{10,}$/;
+
+//##########################//
+class PhoneValidation {
+    // Custom validator for password confirmation
+    static validator(defaultCountry = 'IE') {
+        return (control) => {
+            const value = control.value;
+            if (!value)
+                return null;
+            try {
+                const result = validatePhoneNumberLength(value, defaultCountry);
+                if (!result)
+                    return null; // valid length
+                let reason = '';
+                reason = ` : ${result}`;
+                return {
+                    phoneNumber: {
+                        message: `Invalid phone number. Reason: ${reason}`,
+                    }
+                };
+                // return null; // valid
+            }
+            catch (error) {
+                let reason = '';
+                if (error instanceof ParseError)
+                    reason = ` : ${error.message}`;
+                return {
+                    phoneNumber: {
+                        message: `Invalid phone number. Reason: ${reason}`,
+                    }
+                };
+            }
+        };
+    }
+} //Cls
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { NumericValidation, PasswordValidation, PhoneValidation, StrongPassword10Regx, StrongPassword10WithSpecialRegx, StrongPassword6Regx, StrongPassword6WithSpecialRegx, StrongPassword8Regx, StrongPassword8WithSpecialRegx };
+//# sourceMappingURL=spider-baby-utils-forms-validators.mjs.map

package/fesm2022/spider-baby-utils-forms-validators.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"spider-baby-utils-forms-validators.mjs","sources":["../../../../../libs/utils/forms/validators/src/lib/numeric-validators.ts","../../../../../libs/utils/forms/validators/src/lib/password-validators.ts","../../../../../libs/utils/forms/validators/src/lib/pwd-regexes.ts","../../../../../libs/utils/forms/validators/src/lib/phone-validators.ts","../../../../../libs/utils/forms/validators/src/spider-baby-utils-forms-validators.ts"],"sourcesContent":["import {\r\n    AbstractControl,\r\n    ValidatorFn\r\n} from '@angular/forms';\r\n\r\n\r\n//##########################//\r\n\r\n\r\ninterface MinMaxValidationResult {\r\n  minMaxError?: {\r\n    message: string;\r\n    code?: string;\r\n    minControlName?: string;\r\n    maxControlName?: string;\r\n  };\r\n}\r\n\r\n\r\n//##########################//\r\n\r\nexport class NumericValidation {\r\n\r\n    // Custom validator for password confirmation\r\n    static lessThanValidator(\r\n        minControlName: string,\r\n        maxControlName: string,\r\n        strictlyLessThan: boolean = true,\r\n        errorMessage?: string ): ValidatorFn {\r\n\r\n        return (control: AbstractControl): MinMaxValidationResult | null => {\r\n            const minControl = control.get(minControlName);\r\n            const maxControl = control.get(maxControlName);\r\n\r\n            if (!minControl || !maxControl)\r\n                return null;\r\n\r\n            const minValue = Number(minControl.value);\r\n            const maxValue = Number(maxControl.value);\r\n            \r\n\r\n            if (isNaN(minValue) || isNaN(maxValue))\r\n                return null;\r\n\r\n            if (minValue < maxValue)\r\n                return null;\r\n\r\n            if (!strictlyLessThan && minValue == maxValue)\r\n                return null;\r\n            return {\r\n                minMaxError: {\r\n                    message: errorMessage ?? `${minControlName} must be less ${!strictlyLessThan ? 'or equal to': ''}  than ${maxControlName}`,\r\n                    code: 'minMaxError',\r\n                    minControlName,\r\n                    maxControlName\r\n                }\r\n            }\r\n        }\r\n\r\n    }\r\n\r\n} //Cls\r\n","import {\r\n    ValidatorFn,\r\n    AbstractControl,\r\n    ValidationErrors,\r\n    Validators,\r\n} from '@angular/forms';\r\n\r\n\r\n//##########################//\r\n\r\n\r\ninterface PwdMatchValidationResult {\r\n    passwordMismatch?: string;\r\n}\r\n\r\n\r\n//##########################//\r\n\r\nexport class PasswordValidation {\r\n\r\n    static validationArray = (minLength = 6) => [\r\n        Validators.required,\r\n        Validators.minLength(minLength),\r\n        PasswordValidation.hasLowercaseValidator(),\r\n        PasswordValidation.hasUppercaseValidator(),\r\n        PasswordValidation.hasNumberValidator(),\r\n        PasswordValidation.hasNonAlphaNumericValidator(),\r\n    ]\r\n\r\n\r\n    //----------------------------//\r\n\r\n\r\n    // Custom validator for password confirmation\r\n    static matchValidator(\r\n        passwordControlName: string = 'password',\r\n        confirmPasswordControlName: string = 'confirmPassword',\r\n        errorMessage: string = \"Passwords don't match\"): ValidatorFn {\r\n\r\n        return (control: AbstractControl): PwdMatchValidationResult | null => {\r\n            const password = control.get(passwordControlName);\r\n            const confirmPassword = control.get(confirmPasswordControlName);\r\n\r\n            if (!password || !confirmPassword)\r\n                return null;\r\n\r\n            return password.value === confirmPassword.value\r\n                ? null\r\n                : { passwordMismatch: errorMessage ?? \"Passwords don't match\" };\r\n        }\r\n\r\n    }\r\n\r\n    //----------------------------//\r\n\r\n    static patternValidator(regex: RegExp, error: ValidationErrors): ValidatorFn {\r\n        return (control: AbstractControl): { [key: string]: any } | null => {\r\n            // if control is empty return no error\r\n            if (!control.value) return null;\r\n\r\n            // test the value of the control against the regexp supplied\r\n            const valid = regex.test(control.value);\r\n\r\n            // if true, return no error (no error), else return error passed in the second parameter\r\n            return valid ? null : error;\r\n        }; \r\n    }\r\n\r\n    //----------------------------//\r\n\r\n    static hasUppercaseValidator(): ValidatorFn {\r\n        return PasswordValidation.patternValidator(/[A-Z]/, {\r\n            hasUpper: 'Password must contain at least 1 uppercase letter',\r\n        });\r\n    }\r\n\r\n    //----------------------------//\r\n\r\n    static hasLowercaseValidator(): ValidatorFn {\r\n        return PasswordValidation.patternValidator(/[a-z]/, {\r\n            hasLower: 'Password must contain at least 1 lowercase letter',\r\n        });\r\n    }\r\n\r\n    //----------------------------//\r\n\r\n    static hasNumberValidator(): ValidatorFn {\r\n        return PasswordValidation.patternValidator(/\\d/, {\r\n            hasNumber: 'Password must contain at least 1 number',\r\n        });\r\n    }\r\n\r\n    //----------------------------//\r\n\r\n    static hasNonAlphaNumericValidator(): ValidatorFn {\r\n        return PasswordValidation.patternValidator(/\\W/, {\r\n            hasNonAlpahaNumeric:\r\n                'Password must contain at least 1 non-alphanumeric character',\r\n        });\r\n    }\r\n\r\n\r\n} //Cls\r\n","export const StrongPassword6Regx: RegExp =\r\n  /^(?=[^A-Z]*[A-Z])(?=[^a-z]*[a-z])(?=\\D*\\d).{6,}$/\r\n\r\nexport const StrongPassword6WithSpecialRegx: RegExp =\r\n  /^(?=[^A-Z]*[A-Z])(?=[^a-z]*[a-z])(?=\\D*\\d)(?=.*[!@#$%^&*()_+\\-=[\\]{};':\"\\\\|,.<>/?]).{6,}$/\r\n\r\nexport const StrongPassword8Regx: RegExp =\r\n  /^(?=[^A-Z]*[A-Z])(?=[^a-z]*[a-z])(?=\\D*\\d).{8,}$/\r\n\r\nexport const StrongPassword8WithSpecialRegx: RegExp =\r\n  /^(?=[^A-Z]*[A-Z])(?=[^a-z]*[a-z])(?=\\D*\\d)(?=.*[!@#$%^&*()_+\\-=[\\]{};':\"\\\\|,.<>/?]).{8,}$/\r\n\r\nexport const StrongPassword10Regx: RegExp =\r\n  /^(?=[^A-Z]*[A-Z])(?=[^a-z]*[a-z])(?=\\D*\\d).{10,}$/\r\n\r\nexport const StrongPassword10WithSpecialRegx: RegExp =\r\n  /^(?=[^A-Z]*[A-Z])(?=[^a-z]*[a-z])(?=\\D*\\d)(?=.*[!@#$%^&*()_+\\-=[\\]{};':\"\\\\|,.<>/?]).{10,}$/\r\n\r\n","import { AbstractControl, ValidatorFn } from '@angular/forms';\r\nimport { devConsole } from '@spider-baby/dev-console';\r\nimport { CountryCode, ParseError, validatePhoneNumberLength } from 'libphonenumber-js';\r\n\r\n//##########################//\r\n\r\n\r\ninterface PhoneValidationResult {\r\n    phoneNumber?: {\r\n        message: string;\r\n    }\r\n}\r\n\r\n\r\n//##########################//\r\n\r\nexport class PhoneValidation {\r\n\r\n    // Custom validator for password confirmation\r\n    static validator(defaultCountry: CountryCode = 'IE'): ValidatorFn {\r\n        return (control: AbstractControl): PhoneValidationResult | null => {\r\n            const value = control.value;\r\n            if (!value) \r\n                return null;\r\n            try {\r\n                const result = validatePhoneNumberLength(value, defaultCountry);\r\n                \r\n                if (!result)\r\n                    return null; // valid length\r\n                let reason = '';\r\n                reason = ` : ${result}`;\r\n                return {\r\n                    phoneNumber: {\r\n                        message: `Invalid phone number. Reason: ${reason}`,\r\n                    }\r\n                };\r\n\r\n                // return null; // valid\r\n            } catch (error: unknown) {\r\n                let reason = '';\r\n                if (error instanceof ParseError)\r\n                    reason = ` : ${error.message}`;\r\n                return {\r\n                    phoneNumber: {\r\n                        message: `Invalid phone number. Reason: ${reason}`,\r\n                    }\r\n                };\r\n            }\r\n        };\r\n    }\r\n\r\n} //Cls\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/spider-baby-utils-forms.mjs

@@ -0,0 +1,336 @@
+import { NgTemplateOutlet, isPlatformBrowser } from '@angular/common';
+import * as i0 from '@angular/core';
+import { input, Component, inject, PLATFORM_ID, Renderer2, ElementRef, Input, Directive, Injectable } from '@angular/core';
+import '@angular/forms';
+import { filter } from 'rxjs';
+import { startWith, map } from 'rxjs/operators';
+
+class FirstErrorComponent {
+    control = input.required();
+    customErrorTemplate = input(undefined);
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.9", ngImport: i0, type: FirstErrorComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "19.2.9", type: FirstErrorComponent, isStandalone: true, selector: "sb-first-error", inputs: { control: { classPropertyName: "control", publicName: "control", isSignal: true, isRequired: true, transformFunction: null }, customErrorTemplate: { classPropertyName: "customErrorTemplate", publicName: "customErrorTemplate", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: `
+    @if(this.control().errors?.['firstError']; as err) {
+       @if(customErrorTemplate(); as template){
+         <ng-container 
+          [ngTemplateOutlet]="template" 
+          [ngTemplateOutletContext]="{errorMessage: err}"/>
+        }@else {
+          <span class="error" 
+                [attr.aria-live]="'polite'"
+                [attr.role]="'alert'">
+            {{err}}
+          </span>
+        }
+    }
+  `, isInline: true, styles: [":host{display:block;--error-color: var(--mat-sys-error, #d9534f)}.error{color:var(--error-color, #d9534f );font-size:.875rem;margin-top:.25rem;display:block;animation:fadeIn .3s ease-in}@keyframes fadeIn{0%{opacity:0;transform:translateY(-2px)}to{opacity:1;transform:translateY(0)}}\n"], dependencies: [{ kind: "directive", type: NgTemplateOutlet, selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }] });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.9", ngImport: i0, type: FirstErrorComponent, decorators: [{
+            type: Component,
+            args: [{ selector: 'sb-first-error', standalone: true, imports: [NgTemplateOutlet], template: `
+    @if(this.control().errors?.['firstError']; as err) {
+       @if(customErrorTemplate(); as template){
+         <ng-container 
+          [ngTemplateOutlet]="template" 
+          [ngTemplateOutletContext]="{errorMessage: err}"/>
+        }@else {
+          <span class="error" 
+                [attr.aria-live]="'polite'"
+                [attr.role]="'alert'">
+            {{err}}
+          </span>
+        }
+    }
+  `, styles: [":host{display:block;--error-color: var(--mat-sys-error, #d9534f)}.error{color:var(--error-color, #d9534f );font-size:.875rem;margin-top:.25rem;display:block;animation:fadeIn .3s ease-in}@keyframes fadeIn{0%{opacity:0;transform:translateY(-2px)}to{opacity:1;transform:translateY(0)}}\n"] }]
+        }] });
+
+const errorMessageMap = new Map([
+    ['required', (fieldName) => `${fieldName} is required.`],
+    ['email', () => 'Please enter a valid email address.'],
+    ['minlength', (fieldName, errorValue) => !errorValue ? 'Value is too short' : `${fieldName} must be at least ${errorValue?.requiredLength} characters.`],
+    ['maxlength', (fieldName, errorValue) => !errorValue ? 'Value is too long' : `${fieldName} must be no more than ${errorValue?.requiredLength} characters.`],
+    ['pattern', (fieldName) => `${fieldName} format is invalid.`],
+    ['min', (fieldName, errorValue) => !errorValue ? 'Value is too small' : `${fieldName} must be at least ${errorValue?.min}.`],
+    ['max', (fieldName, errorValue) => !errorValue ? 'Value is too large' : `${fieldName} must be no more than ${errorValue?.max}.`],
+    ['passwordMismatch', () => 'Passwords do not match.'],
+    ['mustMatch', () => 'Fields do not match.'],
+    ['whitespace', (fieldName) => `${fieldName} cannot contain only whitespace.`],
+    ['forbiddenValue', (fieldName, errorValue) => !errorValue ? 'This value is not allowed' : `${fieldName} cannot be "${errorValue?.value}".`],
+    ['asyncValidation', (fieldName) => `${fieldName} validation is pending...`],
+    ['invalidDate', () => 'Please enter a valid date.'],
+    ['futureDate', () => 'Date must be in the future.'],
+    ['pastDate', () => 'Date must be in the past.'],
+    ['strongPassword', () => 'Password must contain at least one uppercase letter, one lowercase letter, one number, and one special character.'],
+    ['phoneNumber', (fieldName, errorValue) => !errorValue.message ? 'Please enter a valid phone number.' : errorValue.message],
+    ['url', () => 'Please enter a valid URL.'],
+    ['unique', (fieldName) => `This ${fieldName.toLowerCase()} is already taken.`],
+    ['fileSize', (fieldName, errorValue) => !errorValue ? 'File is too large' : `File size must be less than ${errorValue?.maxSize}.`],
+    ['fileType', (fieldName, errorValue) => !errorValue ? 'Invalid file type' : `Only ${errorValue?.allowedTypes?.join(', ')} files are allowed.`]
+]);
+//##########################//
+class FormErrors {
+    static setFirstErrors(form, customErrorMessages) {
+        const controls = form.controls;
+        for (const name in controls) {
+            const control = controls[name];
+            if (control.invalid)
+                this.setFirstErrorMessage(name, control, customErrorMessages);
+        }
+    }
+    //----------------------------//    
+    static setFirstErrorMessage(name, control, customErrorMessages) {
+        const currentErrors = control.errors;
+        const firstErrorMessage = FormErrors.getFirstErrorMessage(name, control, customErrorMessages);
+        if (firstErrorMessage)
+            control.setErrors({ ...currentErrors, firstError: firstErrorMessage }, { emitEvent: false } // This prevents statusChanges emission
+            );
+    }
+    //----------------------------//    
+    static getFirstErrorMessage(name, control, customErrorMessages) {
+        const errorKey = this.firstErrorKey(control);
+        if (!errorKey)
+            return null;
+        const errorValue = control.errors?.[errorKey];
+        const fieldName = this.toTitleCase(name);
+        // Handle string error values (custom error messages)
+        if (typeof errorValue === 'string')
+            return errorValue;
+        const errorMessageFn = customErrorMessages?.get(errorKey) ?? errorMessageMap.get(errorKey);
+        // Get error message function and call it
+        if (errorMessageFn)
+            return errorMessageFn(fieldName, errorValue);
+        // Fallback for unknown error types
+        return `Invalid value for ${fieldName}.`;
+    }
+    //----------------------------//
+    static firstErrorKey = (control) => Object.keys(control.errors || {}).length > 0 ? Object.keys(control.errors || {})[0] : null;
+    //----------------------------//
+    static toTitleCase(s) {
+        const result = s.replace(/([A-Z])/g, ' $1');
+        return result.charAt(0).toUpperCase() + result.slice(1);
+    }
+} //Cls
+
+//##########################//
+class FormUtility {
+    static findInvalidControlNames(form) {
+        const invalid = new Set();
+        const controls = form.controls;
+        for (const name in controls) {
+            if (controls[name].invalid)
+                invalid.add(name);
+        }
+        return invalid;
+    }
+    //----------------------------//
+    static findInvalidControlInfo(form) {
+        const invalid = new Set();
+        const controls = form.controls;
+        for (const name in controls) {
+            if (controls[name].invalid)
+                invalid.add(`${name}: ${this.firstErrorKey(controls[name]) || 'Invalid'}`);
+        }
+        return invalid;
+    }
+    //----------------------------//
+    static findInvalidControls(form) {
+        const invalid = [];
+        const controls = form.controls;
+        for (const name in controls) {
+            if (controls[name].invalid)
+                invalid.push(controls[name]);
+        }
+        return invalid;
+    }
+    //----------------------------//
+    static findInvalidControlsData(form) {
+        const invalid = [];
+        const controls = form.controls;
+        for (const name in controls) {
+            const control = controls[name];
+            if (control.invalid)
+                invalid.push({ name, control });
+        }
+        return invalid;
+    }
+    //----------------------------//
+    static replaceNullWithUndefined(obj) {
+        for (const [key, value] of Object.entries(obj)) {
+            if (value === null)
+                obj[key] = undefined;
+        }
+        return obj;
+    }
+    //----------------------------//
+    static getFirstFormError(form) {
+        if (form.valid)
+            return null;
+        // Check form-level errors first
+        if (form.errors) {
+            const firstKey = Object.keys(form.errors)[0];
+            return { [firstKey]: form.errors[firstKey] };
+        }
+        // Check control-specific errors
+        for (const key of Object.keys(form.controls)) {
+            const control = form.get(key);
+            if (control?.errors) {
+                const errorKey = Object.keys(control.errors)[0];
+                return { [errorKey]: control.errors[errorKey] };
+            }
+        }
+        return null;
+    }
+    //----------------------------//
+    static firstErrorKey = (control) => Object.keys(control.errors || {}).length > 0 ? Object.keys(control.errors || {})[0] : null;
+} //Cls
+
+/**
+ * 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.)
+ */
+class FirstErrorDirective {
+    _platformId = inject(PLATFORM_ID);
+    _renderer = inject(Renderer2);
+    _host = inject(ElementRef);
+    set sbFormControlFirstError(form) {
+        this._form = form;
+        this.observeValueChanges(this._form);
+    }
+    /**
+     * 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;
+    /**
+     * 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 = false;
+    //- - - - - - - - - - - - - - //
+    _form;
+    _vcSub;
+    blurListeners = new Map();
+    //----------------------------//
+    ngOnDestroy() {
+        this._vcSub?.unsubscribe();
+        this.removeAllBlurListeners();
+    }
+    //----------------------------//
+    addBlurListener(controlName, control) {
+        // Find the input element by formControlName
+        const input = this._host.nativeElement.querySelector(`[formControlName="${controlName}"]`);
+        if (!input)
+            return;
+        // Use Renderer2 to listen for 'focusout'
+        const unlisten = this._renderer.listen(input, 'focusout', () => {
+            if (!control.errors?.['firstError']) {
+                FormErrors.setFirstErrorMessage(controlName, control, this.customErrorMessages);
+            }
+            // Remove the event listener after setting the error
+            unlisten();
+            this.blurListeners.delete(controlName);
+        });
+        this.blurListeners.set(controlName, unlisten);
+    }
+    //- - - - - - - - - - - - - - //
+    removeAllBlurListeners() {
+        for (const unlisten of this.blurListeners.values())
+            unlisten();
+        this.blurListeners.clear();
+    }
+    //----------------------------//
+    observeValueChanges(form) {
+        if (!isPlatformBrowser(this._platformId))
+            return;
+        this._vcSub?.unsubscribe();
+        this._vcSub = form.statusChanges
+            .pipe(startWith('PENDING'), // Start with non-Invalid so the first error will be set on blur if the user clicks input without entering any data
+        filter(() => form.status === 'INVALID'), map(() => FormUtility.findInvalidControlsData(form)))
+            .subscribe((invalidControlData) => {
+            for (const controlData of invalidControlData) {
+                const control = controlData.control;
+                const name = controlData.name;
+                // Skip if firstError is already set
+                if (control.errors?.['firstError'])
+                    continue;
+                if (this.showUntouched || control.touched) {
+                    FormErrors.setFirstErrorMessage(name, control, this.customErrorMessages);
+                }
+                else if (!control.touched) {
+                    // Add blur listener if not already present
+                    if (!this.blurListeners.has(name))
+                        this.addBlurListener(name, control);
+                }
+            }
+        });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.9", ngImport: i0, type: FirstErrorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.9", type: FirstErrorDirective, isStandalone: true, selector: "[sbFormControlFirstError]", inputs: { sbFormControlFirstError: "sbFormControlFirstError", customErrorMessages: "customErrorMessages", showUntouched: "showUntouched" }, ngImport: i0 });
+} //Cls
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.9", ngImport: i0, type: FirstErrorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[sbFormControlFirstError]',
+                    standalone: true
+                }]
+        }], propDecorators: { sbFormControlFirstError: [{
+                type: Input,
+                args: [{ required: true }]
+            }], customErrorMessages: [{
+                type: Input
+            }], showUntouched: [{
+                type: Input
+            }] } });
+
+class RemoveNullsService {
+    remove = (obj) => RemoveNulls(obj, true);
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.9", ngImport: i0, type: RemoveNullsService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.2.9", ngImport: i0, type: RemoveNullsService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.9", ngImport: i0, type: RemoveNullsService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }] });
+//==============================//
+function RemoveNulls(obj, iterate = true) {
+    if (obj === null || obj === undefined)
+        return obj;
+    // Handle arrays
+    if (Array.isArray(obj)) {
+        return obj
+            .filter(item => item !== null && item !== undefined) // Remove null/undefined items
+            .map(item => iterate && typeof item === 'object' ? RemoveNulls(item, iterate) : item);
+    }
+    // Handle non-objects (primitives)
+    if (typeof obj !== 'object')
+        return obj;
+    const cleaned = structuredClone(obj);
+    for (const key in cleaned) {
+        if (cleaned[key] === null || cleaned[key] === undefined)
+            delete cleaned[key];
+        if (cleaned[key] instanceof Object && iterate)
+            cleaned[key] = RemoveNulls(cleaned[key], iterate);
+    }
+    return cleaned;
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { FirstErrorComponent, FirstErrorDirective, FormErrors, FormUtility, RemoveNulls, RemoveNullsService };
+//# sourceMappingURL=spider-baby-utils-forms.mjs.map

package/fesm2022/spider-baby-utils-forms.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"spider-baby-utils-forms.mjs","sources":["../../../../../libs/utils/forms/src/lib/first-error.component.ts","../../../../../libs/utils/forms/src/lib/form-errors.ts","../../../../../libs/utils/forms/src/lib/form-utility.ts","../../../../../libs/utils/forms/src/lib/first-error.directive.ts","../../../../../libs/utils/forms/src/lib/remove-nulls.service.ts","../../../../../libs/utils/forms/src/spider-baby-utils-forms.ts"],"sourcesContent":["import { NgTemplateOutlet } from '@angular/common';\r\nimport { Component, input, TemplateRef } from \"@angular/core\";\r\nimport { AbstractControl } from \"@angular/forms\";\r\n\r\n@Component({\r\n  selector: 'sb-first-error',\r\n  standalone: true,\r\n  imports: [NgTemplateOutlet],\r\n  template: `\r\n    @if(this.control().errors?.['firstError']; as err) {\r\n       @if(customErrorTemplate(); as template){\r\n         <ng-container \r\n          [ngTemplateOutlet]=\"template\" \r\n          [ngTemplateOutletContext]=\"{errorMessage: err}\"/>\r\n        }@else {\r\n          <span class=\"error\" \r\n                [attr.aria-live]=\"'polite'\"\r\n                [attr.role]=\"'alert'\">\r\n            {{err}}\r\n          </span>\r\n        }\r\n    }\r\n  `,\r\n  styles: [`\r\n    :host {\r\n      display: block;\r\n     --error-color: var(--mat-sys-error, #d9534f);\r\n    }\r\n    .error {\r\n      color: var(--error-color, #d9534f );\r\n      font-size: 0.875rem;\r\n      margin-top: 0.25rem;\r\n      display: block;\r\n      animation: fadeIn 0.3s ease-in;\r\n    }\r\n    \r\n    @keyframes fadeIn {\r\n      from { opacity: 0; transform: translateY(-2px); }\r\n      to { opacity: 1; transform: translateY(0); }\r\n    }\r\n  `]\r\n})\r\nexport class FirstErrorComponent {\r\n\r\n  control = input.required<AbstractControl>();\r\n  customErrorTemplate = input<TemplateRef<unknown> | undefined>(undefined)\r\n\r\n}","/* eslint-disable @typescript-eslint/no-explicit-any */\r\nimport { AbstractControl, FormGroup } from \"@angular/forms\";\r\n\r\n\r\n//##########################//\r\n\r\nexport type ErrorMessageFunction = (fieldName: string, errorValue: any) => string;\r\nexport type CustomErrorMessageMap = Map<string, ErrorMessageFunction>;\r\n\r\n\r\nconst errorMessageMap: CustomErrorMessageMap = new Map<string, ErrorMessageFunction>([\r\n    ['required', (fieldName) => `${fieldName} is required.`],\r\n    ['email', () => 'Please enter a valid email address.'],\r\n    ['minlength', (fieldName, errorValue) => !errorValue ? 'Value is too short' : `${fieldName} must be at least ${errorValue?.requiredLength} characters.`],\r\n    ['maxlength', (fieldName, errorValue) => !errorValue ? 'Value is too long' : `${fieldName} must be no more than ${errorValue?.requiredLength} characters.`],\r\n    ['pattern', (fieldName) => `${fieldName} format is invalid.`],\r\n    ['min', (fieldName, errorValue) => !errorValue ? 'Value is too small' : `${fieldName} must be at least ${errorValue?.min}.`],\r\n    ['max', (fieldName, errorValue) => !errorValue ? 'Value is too large' : `${fieldName} must be no more than ${errorValue?.max}.`],\r\n    ['passwordMismatch', () => 'Passwords do not match.'],\r\n    ['mustMatch', () => 'Fields do not match.'],\r\n    ['whitespace', (fieldName) => `${fieldName} cannot contain only whitespace.`],\r\n    ['forbiddenValue', (fieldName, errorValue) => !errorValue ? 'This value is not allowed' : `${fieldName} cannot be \"${errorValue?.value}\".`],\r\n    ['asyncValidation', (fieldName) => `${fieldName} validation is pending...`],\r\n    ['invalidDate', () => 'Please enter a valid date.'],\r\n    ['futureDate', () => 'Date must be in the future.'],\r\n    ['pastDate', () => 'Date must be in the past.'],\r\n    ['strongPassword', () => 'Password must contain at least one uppercase letter, one lowercase letter, one number, and one special character.'],\r\n    ['phoneNumber', (fieldName, errorValue) => !errorValue.message ? 'Please enter a valid phone number.' : errorValue.message],\r\n    ['url', () => 'Please enter a valid URL.'],\r\n    ['unique', (fieldName) => `This ${fieldName.toLowerCase()} is already taken.`],\r\n    ['fileSize', (fieldName, errorValue) => !errorValue ? 'File is too large' : `File size must be less than ${errorValue?.maxSize}.`],\r\n    ['fileType', (fieldName, errorValue) => !errorValue ? 'Invalid file type' : `Only ${errorValue?.allowedTypes?.join(', ')} files are allowed.`]\r\n]);\r\n\r\n\r\n//##########################//\r\n\r\n\r\nexport class FormErrors {\r\n\r\n\r\n    static setFirstErrors(\r\n        form: FormGroup,\r\n        customErrorMessages?: CustomErrorMessageMap): void {\r\n\r\n        const controls = form.controls\r\n        for (const name in controls) {\r\n            const control = controls[name]\r\n            if (control.invalid)\r\n                this.setFirstErrorMessage(name, control, customErrorMessages)\r\n        }\r\n    }\r\n\r\n\r\n    //----------------------------//    \r\n\r\n\r\n    static setFirstErrorMessage(\r\n        name: string,\r\n        control: AbstractControl,\r\n        customErrorMessages?: CustomErrorMessageMap): void {\r\n\r\n        const currentErrors = control.errors\r\n        const firstErrorMessage = FormErrors.getFirstErrorMessage(name, control, customErrorMessages)\r\n        if (firstErrorMessage)\r\n            control.setErrors(\r\n                { ...currentErrors, firstError: firstErrorMessage },\r\n                { emitEvent: false }  // This prevents statusChanges emission\r\n            )\r\n\r\n    }\r\n\r\n\r\n\r\n    //----------------------------//    \r\n\r\n\r\n    static getFirstErrorMessage(\r\n        name: string,\r\n        control: AbstractControl,\r\n        customErrorMessages?: CustomErrorMessageMap): string | null {\r\n\r\n        const errorKey = this.firstErrorKey(control)\r\n        if (!errorKey)\r\n            return null\r\n\r\n\r\n        const errorValue = control.errors?.[errorKey]\r\n        const fieldName = this.toTitleCase(name) \r\n\r\n        // Handle string error values (custom error messages)\r\n        if (typeof errorValue === 'string')\r\n            return errorValue\r\n\r\n\r\n        const errorMessageFn = customErrorMessages?.get(errorKey) ?? errorMessageMap.get(errorKey);\r\n\r\n\r\n        // Get error message function and call it\r\n        if (errorMessageFn)\r\n            return errorMessageFn(fieldName, errorValue)\r\n\r\n        // Fallback for unknown error types\r\n        return `Invalid value for ${fieldName}.`\r\n    }\r\n\r\n    //----------------------------//\r\n\r\n\r\n    private static firstErrorKey = (control: AbstractControl): string | null =>\r\n        Object.keys(control.errors || {}).length > 0 ? Object.keys(control.errors || {})[0] : null;\r\n\r\n\r\n    //----------------------------//\r\n\r\n    private static toTitleCase(s: string): string {\r\n        const result = s.replace(/([A-Z])/g, ' $1');\r\n        return result.charAt(0).toUpperCase() + result.slice(1);\r\n    }\r\n\r\n}//Cls","import { AbstractControl, FormGroup } from \"@angular/forms\";\r\n\r\n//##########################//\r\n\r\nexport interface ControlData{\r\n  name: string;\r\n  control: AbstractControl;\r\n}\r\n\r\n//##########################//\r\n\r\nexport class FormUtility {\r\n\r\n  public static findInvalidControlNames(form: FormGroup): Set<string> {\r\n\r\n    const invalid = new Set<string>()\r\n    const controls = form.controls\r\n\r\n    for (const name in controls) {\r\n      if (controls[name].invalid)\r\n        invalid.add(name)\r\n    }\r\n\r\n    return invalid\r\n  }\r\n\r\n  //----------------------------//\r\n\r\n  public static findInvalidControlInfo(form: FormGroup): Set<string> {\r\n\r\n    const invalid = new Set<string>()\r\n    const controls = form.controls\r\n\r\n    for (const name in controls) {\r\n      if (controls[name].invalid)\r\n        invalid.add(`${name}: ${this.firstErrorKey(controls[name]) || 'Invalid'}`)\r\n    }\r\n\r\n    return invalid\r\n  }\r\n\r\n  //----------------------------//\r\n\r\n  public static findInvalidControls(form: FormGroup): AbstractControl[] {\r\n\r\n    const invalid = []\r\n    const controls = form.controls\r\n\r\n    for (const name in controls) {\r\n      if (controls[name].invalid)\r\n        invalid.push(controls[name])\r\n    }\r\n\r\n    return invalid\r\n  }\r\n\r\n  //----------------------------//\r\n\r\n  public static findInvalidControlsData(form: FormGroup): ControlData[] {\r\n\r\n    const invalid: { name: string, control: AbstractControl }[] = [];\r\n    const controls = form.controls\r\n\r\n    for (const name in controls) {\r\n      const control = controls[name]\r\n      if (control.invalid)\r\n        invalid.push({ name, control })\r\n    }\r\n\r\n    return invalid\r\n  }\r\n\r\n  //----------------------------//\r\n\r\n\r\n  static replaceNullWithUndefined(obj: Record<string, any>): Record<string, any> {\r\n\r\n    for (const [key, value] of Object.entries(obj)) {\r\n      if (value === null) \r\n        obj[key] = undefined;\r\n    }\r\n    return obj;\r\n  }\r\n\r\n  //----------------------------//\r\n\r\n  static getFirstFormError(form: FormGroup): Record<string, any> | null {\r\n    if (form.valid)\r\n      return null\r\n\r\n    // Check form-level errors first\r\n    if (form.errors) {\r\n      const firstKey = Object.keys(form.errors)[0]\r\n      return { [firstKey]: form.errors[firstKey] }\r\n    }\r\n\r\n    // Check control-specific errors\r\n    for (const key of Object.keys(form.controls)) {\r\n      const control = form.get(key)\r\n      if (control?.errors) {\r\n        const errorKey = Object.keys(control.errors)[0]\r\n        return { [errorKey]: control.errors[errorKey] }\r\n      }\r\n    }\r\n\r\n    return null\r\n  }\r\n\r\n  //----------------------------//\r\n\r\n  static firstErrorKey = (control: AbstractControl): string | null =>\r\n    Object.keys(control.errors || {}).length > 0 ? Object.keys(control.errors || {})[0] : null;\r\n\r\n\r\n}//Cls","import { isPlatformBrowser } from '@angular/common';\r\nimport { Directive, ElementRef, inject, Input, OnDestroy, PLATFORM_ID, Renderer2 } from '@angular/core';\r\nimport { AbstractControl, FormGroup } from '@angular/forms';\r\nimport { filter, Subscription } from 'rxjs';\r\nimport { map, startWith } from 'rxjs/operators';\r\nimport { CustomErrorMessageMap, FormErrors } from './form-errors';\r\nimport { FormUtility } from './form-utility';\r\n\r\n\r\n/**\r\n * Directive: sbFormControlFirstError\r\n *\r\n * Automatically manages and displays the first validation error for each control in a FormGroup.\r\n * - Shows errors only after controls are touched (unless showUntouched is true)\r\n * - Dynamically adds blur/focusout listeners for untouched invalid controls\r\n * - Supports custom error messages via CustomErrorMessageMap\r\n * - Cleans up all listeners and subscriptions on destroy\r\n * - SSR-safe: all DOM access is guarded by isPlatformBrowser\r\n *\r\n * Limitations:\r\n * - Dynamic form changes (adding/removing controls at runtime) are NOT automatically handled in this version.\r\n *   If you add or remove controls after initialization, you must manually re-run error setup logic.\r\n *   (This feature is planned for a future release.)\r\n */\r\n@Directive({\r\n  selector: '[sbFormControlFirstError]',\r\n  standalone: true\r\n})\r\nexport class FirstErrorDirective implements OnDestroy {\r\n\r\n  private _platformId = inject(PLATFORM_ID);\r\n  private _renderer = inject(Renderer2);\r\n  private _host: ElementRef<HTMLElement> = inject(ElementRef);\r\n\r\n\r\n  @Input({ required: true }) set sbFormControlFirstError(form: FormGroup) {\r\n    this._form = form\r\n    this.observeValueChanges(this._form)\r\n  }\r\n\r\n  /** \r\n   * Custom error messages map to override default error messages.\r\n   * If map returns undefined for a specific error, the default message map will be used.\r\n   */\r\n  @Input() customErrorMessages?: CustomErrorMessageMap;\r\n\r\n  /**\r\n   * If true, errors will be shown immediately for untouched controls.\r\n   * If false, errors will only be shown after the control is touched.\r\n   * Default is false.\r\n   */\r\n  @Input() showUntouched: boolean = false; \r\n\r\n  //- - - - - - - - - - - - - - //\r\n\r\n  private _form?: FormGroup\r\n  private _vcSub?: Subscription\r\n  private blurListeners = new Map<string, () => void>()\r\n\r\n  //----------------------------//\r\n\r\n  ngOnDestroy(): void {\r\n    this._vcSub?.unsubscribe()\r\n    this.removeAllBlurListeners();\r\n  }\r\n\r\n  //----------------------------//\r\n\r\n  private addBlurListener(controlName: string, control: AbstractControl): void {\r\n\r\n    // Find the input element by formControlName\r\n    const input: HTMLElement | null = this._host.nativeElement.querySelector(`[formControlName=\"${controlName}\"]`);\r\n\r\n    if (!input)\r\n      return;\r\n\r\n    // Use Renderer2 to listen for 'focusout'\r\n    const unlisten = this._renderer.listen(input, 'focusout', () => {\r\n      if (!control.errors?.['firstError']) {\r\n        FormErrors.setFirstErrorMessage(\r\n          controlName,\r\n          control,\r\n          this.customErrorMessages\r\n        );\r\n      }\r\n      // Remove the event listener after setting the error\r\n      unlisten();\r\n      this.blurListeners.delete(controlName);\r\n    });\r\n\r\n    this.blurListeners.set(controlName, unlisten);\r\n  }\r\n\r\n  //- - - - - - - - - - - - - - //\r\n\r\n  private removeAllBlurListeners() {\r\n\r\n    for (const unlisten of this.blurListeners.values()) \r\n      unlisten()\r\n    \r\n    this.blurListeners.clear();\r\n  }\r\n\r\n  //----------------------------//\r\n\r\n\r\n  private observeValueChanges(form: FormGroup) {\r\n\r\n    if (!isPlatformBrowser(this._platformId))\r\n      return;\r\n\r\n    this._vcSub?.unsubscribe()\r\n    this._vcSub = form.statusChanges\r\n      .pipe(\r\n        startWith('PENDING'), // Start with non-Invalid so the first error will be set on blur if the user clicks input without entering any data\r\n        filter(() => form.status === 'INVALID'),\r\n        map(() => FormUtility.findInvalidControlsData(form))\r\n      )\r\n      .subscribe((invalidControlData) => {\r\n\r\n        for (const controlData of invalidControlData) {\r\n          const control = controlData.control;\r\n          const name = controlData.name;\r\n\r\n          // Skip if firstError is already set\r\n          if (control.errors?.['firstError'])\r\n            continue;\r\n\r\n\r\n          if (this.showUntouched || control.touched) {\r\n            FormErrors.setFirstErrorMessage(name, control, this.customErrorMessages);\r\n          } else if (!control.touched) {\r\n            // Add blur listener if not already present\r\n            if (!this.blurListeners.has(name)) \r\n              this.addBlurListener(name, control);            \r\n          }\r\n        }\r\n      })\r\n  }\r\n\r\n}//Cls\r\n","import { Injectable } from '@angular/core';\r\n\r\n@Injectable({\r\n  providedIn: 'root',\r\n})\r\nexport class RemoveNullsService<T> {\r\n\r\n  remove = (obj: T): T => RemoveNulls(obj, true)\r\n\r\n} \r\n\r\n\r\n//==============================//\r\n\r\n\r\nexport function RemoveNulls<T>(obj: T, iterate = true): T {\r\n\r\n  if (obj === null || obj === undefined)\r\n    return obj;\r\n\r\n  // Handle arrays\r\n  if (Array.isArray(obj)) {\r\n    return obj\r\n      .filter(item => item !== null && item !== undefined) // Remove null/undefined items\r\n      .map(item => iterate && typeof item === 'object' ? RemoveNulls(item, iterate) : item) as T;\r\n  }\r\n\r\n  // Handle non-objects (primitives)\r\n  if (typeof obj !== 'object')\r\n    return obj;\r\n\r\n  const cleaned = structuredClone(obj);\r\n\r\n  for (const key in cleaned) {\r\n\r\n    if (cleaned[key] === null || cleaned[key] === undefined)\r\n      delete cleaned[key];\r\n\r\n    if (cleaned[key] instanceof Object && iterate)\r\n      cleaned[key] = RemoveNulls(cleaned[key], iterate);\r\n  }\r\n\r\n  return cleaned\r\n\r\n}\r\n\r\n//==============================//","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,5 @@
+export * from './lib/first-error.component';
+export * from './lib/first-error.directive';
+export * from './lib/form-errors';
+export * from './lib/form-utility';
+export * from './lib/remove-nulls.service';

package/lib/first-error.component.d.ts

@@ -0,0 +1,9 @@
+import { TemplateRef } from "@angular/core";
+import { AbstractControl } from "@angular/forms";
+import * as i0 from "@angular/core";
+export declare class FirstErrorComponent {
+    control: import("@angular/core").InputSignal<AbstractControl<any, any>>;
+    customErrorTemplate: import("@angular/core").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>;
+}

package/lib/first-error.directive.d.ts

@@ -0,0 +1,45 @@
+import { OnDestroy } from '@angular/core';
+import { FormGroup } from '@angular/forms';
+import { CustomErrorMessageMap } from './form-errors';
+import * as i0 from "@angular/core";
+/**
+ * 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.)
+ */
+export 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>;
+}

package/lib/form-errors.d.ts

@@ -0,0 +1,10 @@
+import { AbstractControl, FormGroup } from "@angular/forms";
+export type ErrorMessageFunction = (fieldName: string, errorValue: any) => string;
+export type CustomErrorMessageMap = Map<string, ErrorMessageFunction>;
+export 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;
+}

package/lib/form-utility.d.ts

@@ -0,0 +1,14 @@
+import { AbstractControl, FormGroup } from "@angular/forms";
+export interface ControlData {
+    name: string;
+    control: AbstractControl;
+}
+export 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;
+}

package/lib/remove-nulls.service.d.ts

@@ -0,0 +1,7 @@
+import * as i0 from "@angular/core";
+export declare class RemoveNullsService<T> {
+    remove: (obj: T) => T;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RemoveNullsService<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<RemoveNullsService<any>>;
+}
+export declare function RemoveNulls<T>(obj: T, iterate?: boolean): T;

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@spider-baby/utils-forms",
+  "version": "1.0.0",
+  "peerDependencies": {
+    "@angular/core": "^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
+    "@angular/forms": "^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
+    "@angular/common": "^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
+    "rxjs": "~7.8.0",
+    "@spider-baby/dev-console": "^1.1.2",
+    "libphonenumber-js": "^1.12.9"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/spider-baby-utils-forms.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/spider-baby-utils-forms.mjs"
+    },
+    "./validators": {
+      "types": "./validators/index.d.ts",
+      "default": "./fesm2022/spider-baby-utils-forms-validators.mjs"
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/validators/README.md

@@ -0,0 +1,3 @@
+# @spider-baby/utils-forms/validators
+
+Secondary entry point of `@spider-baby/utils-forms`. It can be used by importing from `@spider-baby/utils-forms/validators`.

package/validators/index.d.ts

@@ -0,0 +1,4 @@
+export * from './lib/numeric-validators';
+export * from './lib/password-validators';
+export * from './lib/pwd-regexes';
+export * from './lib/phone-validators';

package/validators/lib/numeric-validators.d.ts

@@ -0,0 +1,4 @@
+import { ValidatorFn } from '@angular/forms';
+export declare class NumericValidation {
+    static lessThanValidator(minControlName: string, maxControlName: string, strictlyLessThan?: boolean, errorMessage?: string): ValidatorFn;
+}

package/validators/lib/password-validators.d.ts

@@ -0,0 +1,10 @@
+import { ValidatorFn, ValidationErrors } from '@angular/forms';
+export 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;
+}

package/validators/lib/phone-validators.d.ts

@@ -0,0 +1,5 @@
+import { ValidatorFn } from '@angular/forms';
+import { CountryCode } from 'libphonenumber-js';
+export declare class PhoneValidation {
+    static validator(defaultCountry?: CountryCode): ValidatorFn;
+}

package/validators/lib/pwd-regexes.d.ts

@@ -0,0 +1,6 @@
+export declare const StrongPassword6Regx: RegExp;
+export declare const StrongPassword6WithSpecialRegx: RegExp;
+export declare const StrongPassword8Regx: RegExp;
+export declare const StrongPassword8WithSpecialRegx: RegExp;
+export declare const StrongPassword10Regx: RegExp;
+export declare const StrongPassword10WithSpecialRegx: RegExp;