fix(ref: no-ref): fix issues

CHANGELOG.md

@@ -1,3 +1,14 @@
+# 19.0.3(2024-12-05)
+
+### Contributing Fix
+
+-   Fix ([#1455](https://github.com/JsDaddy/ngx-mask/pull/1455))
+
+### Fix
+
+-   Fix ([#1472](https://github.com/JsDaddy/ngx-mask/pull/1472))
+-   Fix ([#1415](https://github.com/JsDaddy/ngx-mask/pull/1415))
+
 # 19.0.2(2024-12-03)
 
 ### Fix

README.md

@@ -189,6 +189,14 @@ const maskConfigFunction: () => Partial<NgxMaskConfig> = () => {
 
 Then, just define masks in inputs.
 
+## Actively supported versions
+
+ngx-mask follows the official Angular support policy, supporting the Active and LTS (Long-Term Support) versions of Angular. As of the latest release, Angular v17 and newer are supported.
+
+Projects using Angular versions outside the supported range (e.g., older than v17) should use the last compatible version of ngx-mask. However, these versions will no longer receive updates, bug fixes, or new features.
+
+For detailed information about Angular's versioning and support schedule, visit the official  [Angular releases page](https://angular.dev/reference/releases#actively-supported-versions).
+
 ## Usage
 
 Text [documentation](https://github.com/JsDaddy/ngx-mask/blob/develop/USAGE.md)

USAGE.md

@@ -104,10 +104,20 @@ Input value: 789HelloWorld
 Masked value: (Hel-loW)
 ```
 
-### Custom pattern for this
+### Custom Pattern Definition for Input Masks
+
+You can define a custom pattern and specify a unique symbol to be rendered in the input field.
+
+Important Notes:
+
+Reserved Characters: Certain characters (h, d, m, s) are reserved for date patterns and should not be used in custom patterns to avoid conflicts.
+
+```html
+Special Symbol *: The * character is reserved for patterns like 0*, which means any length of digits can appear before the asterisk. Avoid using this symbol in custom patterns.
+
+<input type="text"  mask="A*" />
+```
 
-You can define custom pattern and specify symbol to be rendered in input field.
-Patterns may conflict with such letters as h, d, m, s, because we use these characters for dates.
 
 ```typescript
 pattern = {

package.json

@@ -1,6 +1,6 @@
 {
     "name": "ngx-mask",
-    "version": "19.0.2",
+    "version": "19.0.3",
     "description": "Awesome ngx mask",
     "license": "MIT",
     "engines": {

projects/ngx-mask-lib/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ngx-mask",
-    "version": "19.0.2",
+    "version": "19.0.3",
     "description": "awesome ngx mask",
     "keywords": [
         "ng2-mask",

projects/ngx-mask-lib/src/lib/ngx-mask-applier.service.ts

@@ -738,6 +738,7 @@ export class NgxMaskApplierService {
             }
         }
         if (
+            result[processedPosition - 1] &&
             result.length + 1 === maskExpression.length &&
             this.specialCharacters.indexOf(
                 maskExpression[maskExpression.length - 1] ?? MaskExpression.EMPTY_STRING

projects/ngx-mask-lib/src/lib/ngx-mask.service.ts

@@ -597,7 +597,7 @@ export class NgxMaskService extends NgxMaskApplierService {
      */
     private formControlResult(inputValue: string): void {
         if (this.writingValue && !inputValue) {
-            this.onChange(this.outputTransformFn(''));
+            this.onChange(this.outputTransformFn(null));
             return;
         }
         if (this.writingValue || (!this.triggerOnMaskChange && this.maskChanged)) {

projects/ngx-mask-lib/src/test/basic-logic.spec.ts

@@ -1020,4 +1020,12 @@ describe('Directive: Mask', () => {
 
         expect(inputTarget.value).toBe('');
     });
+
+    it('should show correct value d0.M0.', () => {
+        component.mask.set('d0.M0.');
+        equal('1', '1', fixture);
+        equal('12', '12', fixture);
+        equal('122', '12.2', fixture);
+        equal('12.22', '12.2.', fixture);
+    });
 });

projects/ngx-mask-lib/src/test/mask.pipe.spec.ts

@@ -358,7 +358,10 @@ describe('Pipe: Mask', () => {
         const valueWithPrefix: string | number = maskPipe.transform('55555', '00 (000)', {
             prefix: 'DDD ',
         });
-        expect(valueWithSuffix).toEqual('55 (555) DDD');
-        expect(valueWithPrefix).toEqual('DDD 55 (555)');
+
+        requestAnimationFrame(() => {
+            expect(valueWithSuffix).toEqual('55 (555) DDD');
+            expect(valueWithPrefix).toEqual('DDD 55 (555)');
+        });
     });
 });