ngx-mask 22.0.0 → 22.0.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ngx-mask",
-  "version": "22.0.0",
-  "description": "awesome ngx mask",
+  "version": "22.0.2",
+  "description": "Input masking for modern Angular — Reactive, template-driven and Signal Forms, zoneless and SSR ready. Dates, numbers, separators, custom patterns.",
   "keywords": [
     "ng2-mask",
     "ngx-mask",
@@ -11,21 +11,27 @@
     "angular",
     "angular2",
     "angular2-mask",
-    "ng2mask",
-    "jsdaddy"
+    "ng2mask"
   ],
   "license": "MIT",
   "author": "ngx-mask",
+  "files": [
+    "LICENSE",
+    "README.md",
+    "fesm2022/ngx-mask.mjs",
+    "types",
+    "package.json"
+  ],
   "contributors": [
     "ngx-mask"
   ],
-  "homepage": "https://github.com/JsDaddy/ngx-mask",
+  "homepage": "https://github.com/NepipenkoIgor/ngx-mask",
   "repository": {
     "type": "git",
-    "url": "git@github.com:JsDaddy/ngx-mask.git"
+    "url": "git@github.com:NepipenkoIgor/ngx-mask.git"
   },
   "bugs": {
-    "url": "https://github.com/JsDaddy/ngx-mask/issues"
+    "url": "https://github.com/NepipenkoIgor/ngx-mask/issues"
   },
   "peerDependencies": {
     "@angular/common": "^22.0.0",

package/types/ngx-mask.d.ts

@@ -6,11 +6,13 @@ import { FormValueControl } from '@angular/forms/signals';
 
 type InputTransformFn = (value: unknown) => string | number;
 type OutputTransformFn = (value: string | number | undefined | null) => unknown;
+/** Single decimal marker character accepted when `decimalMarker` is given as an array. */
+type DecimalMarkerChar = '.' | ',';
 type NgxMaskConfig = {
     suffix: string;
     prefix: string;
     thousandSeparator: string;
-    decimalMarker: '.' | ',' | ['.', ','];
+    decimalMarker: DecimalMarkerChar | [DecimalMarkerChar, DecimalMarkerChar];
     clearIfNotMatch: boolean;
     showMaskTyped: boolean;
     placeHolderCharacter: string;
@@ -104,7 +106,7 @@ declare class NgxMaskApplierService {
     keepCharacterPositions: NgxMaskConfig['keepCharacterPositions'];
     instantPrefix: NgxMaskConfig['instantPrefix'];
     triggerOnMaskChange: NgxMaskConfig['triggerOnMaskChange'];
-    private _shift;
+    protected _shift: Set<number>;
     plusOnePosition: boolean;
     maskExpression: string;
     actualValue: string;
@@ -118,11 +120,11 @@ declare class NgxMaskApplierService {
     writingValue: boolean;
     ipError?: boolean;
     cpfCnpjError?: boolean;
-    applyMask(inputValue: string | object | boolean | null | undefined, maskExpression: string, position?: number, justPasted?: boolean, backspaced?: boolean, cb?: (...args: any[]) => any): string;
+    applyMask(inputValue: string | object | boolean | null | undefined, maskExpression: string, position?: number, justPasted?: boolean, backspaced?: boolean, cb?: (actualShift: number, backspaceShift: boolean) => void): string;
     _findDropSpecialChar(inputSymbol: string): undefined | string;
     _findSpecialChar(inputSymbol: string): undefined | string;
     _checkSymbolMask(inputSymbol: string, maskSymbol: string): boolean;
-    private _formatWithSeparators;
+    protected _formatWithSeparators: (str: string, thousandSeparatorChar: string, decimalChars: string | string[], precision: number) => string;
     /**
      * Formats a value for the `typeFromDecimals` mode: every digit of the raw value is
      * read as one integer that is then split `precision` digits from the right
@@ -130,20 +132,23 @@ declare class NgxMaskApplierService {
      * mid-string edits and backspace all reduce to "digits shifted through the
      * decimal marker".
      */
-    private _formatFromDecimals;
+    protected _formatFromDecimals(value: string, precision: number, decimalMarker: string): string;
     /** Inserts `separator` between every 3-digit group of an integer-digit string. */
     private _applyThousandGrouping;
-    private percentage;
+    protected percentage: (str: string) => boolean;
     getPrecision: (maskExpression: string) => number;
     private checkAndRemoveSuffix;
-    private checkInputPrecision;
-    private _stripToDecimal;
-    private _charToRegExpExpression;
-    private _shiftStep;
+    protected checkInputPrecision: (inputValue: string, precision: number, decimalMarker: NgxMaskConfig["decimalMarker"]) => string;
+    protected _stripToDecimal(str: string): string;
+    protected _charToRegExpExpression(char: string): string;
+    protected _shiftStep(cursor: number): void;
     protected _compareOrIncludes<T>(value: T, comparedValue: T | T[], excludedValue: T): boolean;
-    private _validIP;
-    private _splitPercentZero;
-    private _findFirstNonZeroAndDecimalIndex;
+    protected _validIP(valuesIP: string[]): boolean;
+    protected _splitPercentZero(value: string): string;
+    protected _findFirstNonZeroAndDecimalIndex(inputString: string, decimalMarker: '.' | ','): {
+        decimalMarkerIndex: number | null;
+        nonZeroIndex: number | null;
+    };
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgxMaskApplierService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<NgxMaskApplierService>;
 }
@@ -172,7 +177,7 @@ declare class NgxMaskService extends NgxMaskApplierService {
     private _emitValue;
     private _start;
     private _end;
-    onChange: (_: any) => void;
+    onChange: (_: unknown) => void;
     readonly _elementRef: ElementRef<any> | null;
     private readonly document;
     protected _config: NgxMaskConfig;
@@ -187,9 +192,9 @@ declare class NgxMaskService extends NgxMaskApplierService {
      * @param cb Callback function.
      * @returns The masked value.
      */
-    applyMask(inputValue: string, maskExpression: string, position?: number, justPasted?: boolean, backspaced?: boolean, cb?: (...args: any[]) => any): string;
+    applyMask(inputValue: string, maskExpression: string, position?: number, justPasted?: boolean, backspaced?: boolean, cb?: (actualShift: number, backspaceShift: boolean) => void): string;
     private _numberSkipedSymbols;
-    applyValueChanges(position: number, justPasted: boolean, backspaced: boolean, cb?: (...args: any[]) => any): void;
+    applyValueChanges(position: number, justPasted: boolean, backspaced: boolean, cb?: (actualShift: number, backspaceShift: boolean) => void): void;
     hideInput(inputValue: string, maskExpression: string): string;
     getActualValue(res: string): string;
     shiftTypedSymbols(inputValue: string): string;
@@ -226,7 +231,7 @@ declare class NgxMaskService extends NgxMaskApplierService {
      * model value too. Therefore, we don't trigger onChange in this scenario.
      * @param inputValue the current form input value
      */
-    private formControlResult;
+    formControlResult(inputValue: string): void;
     private _toNumber;
     private _removeMask;
     private _removePrefix;
@@ -278,7 +283,7 @@ declare class NgxMaskDirective implements ControlValueAccessor, OnChanges, Valid
     prefix: _angular_core.InputSignal<string>;
     suffix: _angular_core.InputSignal<string>;
     thousandSeparator: _angular_core.InputSignal<string>;
-    decimalMarker: _angular_core.InputSignal<"." | "," | [".", ","]>;
+    decimalMarker: _angular_core.InputSignal<ngx_mask.DecimalMarkerChar | [ngx_mask.DecimalMarkerChar, ngx_mask.DecimalMarkerChar]>;
     dropSpecialCharacters: _angular_core.InputSignal<boolean | string[] | readonly string[] | null>;
     hiddenInput: _angular_core.InputSignal<boolean | null>;
     showMaskTyped: _angular_core.InputSignal<boolean | null>;
@@ -375,7 +380,7 @@ declare class NgxMaskDirective implements ControlValueAccessor, OnChanges, Valid
     private readonly _injector;
     private _ngControl;
     private _resolveNgControl;
-    onChange: (_: any) => void;
+    onChange: (_: unknown) => void;
     onTouch: () => void;
     constructor();
     ngOnChanges(changes: SimpleChanges): void;
@@ -419,7 +424,7 @@ declare class NgxMaskDirective implements ControlValueAccessor, OnChanges, Valid
      */
     private _restoreControlStateAfterWrite;
     /** It writes the value in the input */
-    writeValue(controlValue: unknown): Promise<void>;
+    writeValue(controlValue: unknown): void;
     /**
      * Mirrors a writeValue-driven render into the DOM synchronously, in the same
      * change-detection pass (#1305). The service's `formElementProperty` setter defers all
@@ -455,7 +460,21 @@ declare class NgxMaskDirective implements ControlValueAccessor, OnChanges, Valid
     focus(): void;
     private _getActiveElement;
     checkSelectionOnDeletion(el: HTMLInputElement): void;
-    /** It disables the input element */
+    /**
+     * It disables the input element.
+     *
+     * Mirrors `_writeElementValueSync` (#1305): the service's `formElementProperty` setter
+     * defers ALL DOM writes via `queueMicrotask` to dodge ExpressionChangedAfterItHasBeenChecked
+     * and keep FIFO ordering with config-driven re-renders. For `disabled` specifically, that
+     * deferral leaves `nativeElement.disabled` stale for at least one microtask after Angular
+     * Forms' `setUpControl` calls this method synchronously during init — long enough for a
+     * consumer reading the DOM property in the same synchronous phase (or another deferred write
+     * racing in FIFO order) to observe the wrong value, e.g. an initially-disabled FormControl
+     * whose native input briefly (or, depending on interleaving, persistently) reports
+     * `disabled === false` (#1633). Writing synchronously here closes that gap; the deferred
+     * write below still runs afterwards and re-applies the same final value, preserving the
+     * existing ordering guarantees other call sites rely on.
+     */
     setDisabledState(isDisabled: boolean): void;
     private _applyMask;
     /**
@@ -517,4 +536,4 @@ declare class NgxMaskPipe implements PipeTransform {
 }
 
 export { INITIAL_CONFIG, NEW_CONFIG, NGX_MASK_CONFIG, NgxMaskDirective, NgxMaskPipe, NgxMaskService, initialConfig, provideEnvironmentNgxMask, provideNgxMask, resolveMaskAlias, timeMasks, withoutValidation };
-export type { InputTransformFn, NgxMaskConfig, NgxMaskOptions, OutputTransformFn };
+export type { DecimalMarkerChar, InputTransformFn, NgxMaskConfig, NgxMaskOptions, OutputTransformFn };