ngx-digits-only 1.0.3 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-digits-only",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "peerDependencies": {
     "@angular/common": ">=16.0.0",
     "@angular/core": ">=16.0.0"

package/types/ngx-digits-only.d.ts

@@ -85,8 +85,16 @@ declare class DigitsOnlyDirective implements ControlValueAccessor, Validator, On
     private el;
     private renderer;
     private document;
-    /** How many decimal places are allowed. 0 = integers only. Ignored when pattern is set. */
-    decimalPlaces: number;
+    /**
+     * How many decimal places are allowed. Ignored when pattern is set.
+     *
+     *   0    (default) — integers only, decimal point blocked
+     *   N              — exactly N decimal places allowed (e.g. 2 for currency)
+     *   null           — unlimited decimal places allowed
+     *
+     * Matches the same null = "no limit" convention used by maxLength, min, and max.
+     */
+    decimalPlaces: number | null;
     /** Visual grouping character inserted between digit groups. Ignored when pattern is set. */
     thousandSeparator: '' | ',' | '.' | ' ' | '_';
     /** Visual text prepended to the displayed value (e.g. '$'). Never reaches the model. */
@@ -205,12 +213,6 @@ declare class DigitsOnlyDirective implements ControlValueAccessor, Validator, On
      * number portion start" — cursor clamping, minus-key position check, etc.
      */
     private get editableStartOffset();
-    /**
-     * The number of characters at the RIGHT end of the display string that
-     * belong to the suffix (LTR) or prefix (RTL) — i.e. characters the cursor
-     * must never move past on the right side.
-     */
-    private get editableEndPadding();
     constructor(el: ElementRef<HTMLInputElement>, renderer: Renderer2, document: Document);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
@@ -270,11 +272,11 @@ declare class DigitsOnlyDirective implements ControlValueAccessor, Validator, On
      */
     private buildModelValue;
     /**
-     * Write the formatted display string back to the <input> DOM element
-     * and try to restore the cursor to a sensible position.
-     *
-     * @param cursorBefore  Cursor position in the display string BEFORE we reformatted
-     * @param lengthBefore  Total display string length BEFORE we reformatted
+     * Write the formatted display string back to the <input> DOM element.
+     * Cursor placement is left entirely to the browser — we never call
+     * setSelectionRange here. The browser naturally keeps the cursor where
+     * the user last interacted, which is the correct behaviour for both
+     * LTR and RTL inputs.
      */
     private refreshDisplay;
     /**
@@ -373,6 +375,34 @@ declare class DigitsOnlyDirective implements ControlValueAccessor, Validator, On
      *     '0'  pos 7 → digit (raw index 4)  digit consumed → raw index 5
      *   We reached position 8, so raw index = 5  ✔
      */
+    /**
+     * Convert a DOM cursor position (selectionStart) to an index inside the
+     * raw digit string.
+     *
+     * Works correctly in both LTR and RTL:
+     *
+     *   LTR: display = [prefix][formattedNumber][suffix]
+     *        number starts at prefix.length
+     *
+     *   RTL: display = [LRM][suffix][formattedNumber][prefix]
+     *        number starts at LRM.length + suffix.length
+     *
+     *   In both cases we subtract editableStartOffset to get a position
+     *   relative to the start of the formatted number, then walk the pattern
+     *   (if any) to count how many raw digits precede that position.
+     *
+     * Non-pattern mode:
+     *   The cursor position inside the number portion equals the raw digit
+     *   index directly (no separators injected in string/integer mode, and
+     *   thousands separators shift characters but the raw index is what we
+     *   need for splice operations).
+     *
+     * Example (RTL, pattern='(000) 000-0000', prefix='﷼', suffix=''):
+     *   editableStartOffset = LRM.length (1) + suffix.length (0) = 1
+     *   displayCursorPos = 5 → positionInPattern = 5 - 1 = 4
+     *   Walk: '(' pos0, '5' pos1 (raw 1), '5' pos2 (raw 2), '5' pos3 (raw 3), ')' pos4
+     *   → rawDigitIndex = 3  ✔
+     */
     private mapDisplayCursorToRawIndex;
     /**
      * Decide whether a keyboard event is a "control" key that should always