@leaderty/utils 3.0.0 → 3.1.0

package/README.md

@@ -38,6 +38,31 @@ numberToMoney(-1234.5, { decimals: 2 })                                     // "
 numberToMoney(undefined, { currency: 'ARS' })                               // "-"
 ```
 
+### `moneyToNumber(value)`
+
+Lee un monto escrito a la manera argentina: coma para los decimales y sin separador de miles. Es la inversa de lo que un usuario tipea en un campo de plata.
+
+**Comportamiento:**
+- Rechaza cualquier punto: `350.5` y `350.000` no se distinguen sin adivinar.
+- Admite un monto a medio escribir (`1234,`) y hasta dos decimales. Con más decimales devuelve `null`: no redondea lo que escribió el usuario.
+- Admite el signo menos y hasta 13 cifras enteras, para que cada centavo sea exacto en un `number`.
+- Ignora los espacios alrededor del monto.
+
+**Parámetros:**
+- `value` - `string`
+
+**Devuelve:** `number`, o `null` si `value` está vacío o no es un monto válido
+
+**Ejemplos:**
+```typescript
+moneyToNumber('357672,50')   // 357672.5
+moneyToNumber('350000')      // 350000
+moneyToNumber('1234,')       // 1234
+moneyToNumber('450.000')     // null
+moneyToNumber('1,2,3')       // null
+moneyToNumber('')            // null
+```
+
 ### `dateToShort(value, options?)`
 
 Formats a date as `dd/mm/aaaa`, or `dd/mm/aaaa hh:mm` (24-hour) with `time: true`.

package/dist/format.d.ts

@@ -32,6 +32,19 @@ export interface DateToShortOptions {
  * numberToMoney(-1234.5, { currency: 'USD', currencyDisplay: 'symbol', decimals: 2 }) // "-US$ 1.234,50"
  */
 export declare function numberToMoney(amount: number | null | undefined, options?: NumberToMoneyOptions): string;
+/**
+ * Reads an amount typed the Argentine way: `,` for decimals and no thousands separator.
+ * Any dot is rejected: `350.5` and `350.000` can't be told apart without guessing.
+ *
+ * @param value - Text of a money field
+ * @returns The amount, or `null` when `value` has no amount or is not a valid one
+ *
+ * @example
+ * moneyToNumber('357672,50')  // 357672.5
+ * moneyToNumber('1234,')      // 1234
+ * moneyToNumber('450.000')    // null
+ */
+export declare function moneyToNumber(value: string): number | null;
 /**
  * Formats a date as `dd/mm/aaaa`, optionally with the time as `dd/mm/aaaa hh:mm`.
  *

package/dist/format.js

@@ -6,6 +6,8 @@
 /** Shown instead of a value that is missing or not a valid number/date. */
 const PLACEHOLDER = '-';
 const CURRENCY_SYMBOLS = { ARS: '$', USD: 'US$' };
+/** Up to 13 integer digits: with two decimals, 15 significant digits are always exact to the cent in a `number`. */
+const MONEY_INPUT_PATTERN = /^-?(?:\d{1,13}(?:,\d{0,2})?|,\d{1,2})$/;
 /** Argentina is UTC-3 all year (no daylight saving time since 2009). */
 const BUENOS_AIRES_OFFSET_MS = -3 * 60 * 60 * 1000;
 /** `aaaa-mm-dd`, optionally followed by a time and no time zone: a calendar date or Argentine wall-clock time. */
@@ -53,6 +55,25 @@ export function numberToMoney(amount, options = {}) {
     const prefix = currencyDisplay === 'symbol' ? CURRENCY_SYMBOLS[currency] : currency;
     return `${sign}${prefix} ${number}`;
 }
+/**
+ * Reads an amount typed the Argentine way: `,` for decimals and no thousands separator.
+ * Any dot is rejected: `350.5` and `350.000` can't be told apart without guessing.
+ *
+ * @param value - Text of a money field
+ * @returns The amount, or `null` when `value` has no amount or is not a valid one
+ *
+ * @example
+ * moneyToNumber('357672,50')  // 357672.5
+ * moneyToNumber('1234,')      // 1234
+ * moneyToNumber('450.000')    // null
+ */
+export function moneyToNumber(value) {
+    const text = value.trim();
+    if (!MONEY_INPUT_PATTERN.test(text))
+        return null;
+    // `|| 0` turns -0 into 0
+    return Number(text.replace(',', '.')) || 0;
+}
 /**
  * Formats a date as `dd/mm/aaaa`, optionally with the time as `dd/mm/aaaa hh:mm`.
  *

package/dist/index.d.ts

@@ -5,4 +5,4 @@
 export declare function numberToDecimalString(numero: number): string;
 /** @deprecated Renamed to {@link numberToDecimalString}. */
 export declare const numberToStringWithDecimals: typeof numberToDecimalString;
-export { numberToMoney, dateToShort, dateToYMD, dateToMonthYearLong, type Currency, type NumberToMoneyOptions, type DateToShortOptions, } from './format.js';
+export { numberToMoney, moneyToNumber, dateToShort, dateToYMD, dateToMonthYearLong, type Currency, type NumberToMoneyOptions, type DateToShortOptions, } from './format.js';

package/dist/index.js

@@ -8,4 +8,4 @@ export function numberToDecimalString(numero) {
 }
 /** @deprecated Renamed to {@link numberToDecimalString}. */
 export const numberToStringWithDecimals = numberToDecimalString;
-export { numberToMoney, dateToShort, dateToYMD, dateToMonthYearLong, } from './format.js';
+export { numberToMoney, moneyToNumber, dateToShort, dateToYMD, dateToMonthYearLong, } from './format.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leaderty/utils",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",