@leaderty/utils 2.1.1 → 3.1.0

package/README.md

@@ -38,13 +38,39 @@ 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`.
 
 **Behavior:**
 - `'aaaa-mm-dd'` strings, and date-time strings without a time zone (`'2026-10-01T00:00:00'`), are read as written. `'2026-10-11'` gives `11/10/2026`, even though `new Date('2026-10-11')` is midnight UTC, which is still October 10 in Argentina.
-- `Date` objects and ISO strings with a time zone (`Z` or `±hh:mm`, as in `'2026-10-22T22:05:36.036Z'`) are shown in `America/Argentina/Buenos_Aires` time (UTC-3, no daylight saving time).
+- `Date` objects are read in the system time zone, as their own getters do: `new Date(2026, 10, 1)` is November 1 in any system time zone.
+- ISO strings with a time zone (`Z` or `±hh:mm`, as in `'2026-10-22T22:05:36.036Z'`) are shown in `America/Argentina/Buenos_Aires` time (UTC-3, no daylight saving time).
 - Any other string gives `'-'` (`'11/10/2026'`, `'2026-10'`, `'Oct 11 2026'`): `new Date()` would read it in the system time zone or guess the day/month order.
 - Also returns `'-'` for `null`, `undefined`, invalid dates and impossible dates such as `'2026-02-30'`.
 
@@ -58,14 +84,14 @@ Formats a date as `dd/mm/aaaa`, or `dd/mm/aaaa hh:mm` (24-hour) with `time: true
 ```typescript
 dateToShort('2026-10-11')                               // "11/10/2026"
 dateToShort('2026-10-01T00:00:00')                      // "01/10/2026"
-dateToShort(new Date('2026-10-22T22:05:36Z'))           // "22/10/2026"
+dateToShort(new Date(2026, 9, 22))                      // "22/10/2026"
 dateToShort('2026-10-22T02:05:36Z', { time: true })     // "21/10/2026 23:05"
 dateToShort('11/10/2026')                               // "-"
 ```
 
 ### `dateToYMD(value)`
 
-Formats a date as `aaaa-mm-dd`, the value of an `<input type="date">`. Reads `value` like `dateToShort`, so `'2026-10-11'` stays the 11th and a `Date` is taken in Buenos Aires time.
+Formats a date as `aaaa-mm-dd`, the value of an `<input type="date">`. Reads `value` like `dateToShort`, so `'2026-10-11'` stays the 11th and a `Date` is taken in the system time zone.
 
 **Parameters:**
 - `value` - `Date | string | null | undefined`
@@ -75,7 +101,7 @@ Formats a date as `aaaa-mm-dd`, the value of an `<input type="date">`. Reads `va
 **Examples:**
 ```typescript
 dateToYMD('2026-10-11')                       // "2026-10-11"
-dateToYMD(new Date('2026-10-22T02:05:36Z'))   // "2026-10-21"
+dateToYMD(new Date(2026, 9, 21))              // "2026-10-21"
 dateToYMD('11/10/2026')                       // ""
 ```
 

package/dist/format.d.ts

@@ -32,14 +32,28 @@ 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`.
  *
  * - `'aaaa-mm-dd'` strings, and date-time strings without a time zone (`'2026-10-01T00:00:00'`),
  *   are read as written: `'2026-10-11'` is the 11th, never the 10th
  *   (`new Date('2026-10-11')` is midnight UTC, which is still the 10th in Argentina).
- * - `Date` objects and ISO strings with a time zone (`'2026-10-22T22:05:36.036Z'`) are shown in
- *   `America/Argentina/Buenos_Aires` time.
+ * - `Date` objects are read in the system time zone, as their own getters do: `new Date(2026, 10, 1)` is
+ *   November 1 in any system time zone.
+ * - ISO strings with a time zone (`'2026-10-22T22:05:36.036Z'`) are shown in `America/Argentina/Buenos_Aires` time.
  * - Any other string (`'11/10/2026'`, `'2026-10'`, `'Oct 11 2026'`) gives `'-'`: the engine would parse it
  *   in the system time zone, or guess the day/month order.
  *
@@ -49,7 +63,7 @@ export declare function numberToMoney(amount: number | null | undefined, options
  *
  * @example
  * dateToShort('2026-10-11')                                    // "11/10/2026"
- * dateToShort(new Date('2026-10-22T22:05:36Z'))                // "22/10/2026"
+ * dateToShort(new Date(2026, 9, 22))                           // "22/10/2026"
  * dateToShort('2026-10-22T02:05:36Z', { time: true })          // "21/10/2026 23:05"
  */
 export declare function dateToShort(value: Date | string | null | undefined, options?: DateToShortOptions): string;
@@ -62,7 +76,7 @@ export declare function dateToShort(value: Date | string | null | undefined, opt
  * @example
  * dateToYMD('2026-10-11')                       // "2026-10-11"
  * dateToYMD('2026-10-11T00:00:00')              // "2026-10-11"
- * dateToYMD(new Date('2026-10-22T02:05:36Z'))   // "2026-10-21"
+ * dateToYMD(new Date(2026, 9, 21))             // "2026-10-21"
  * dateToYMD('11/10/2026')                       // ""
  */
 export declare function dateToYMD(value: Date | string | null | undefined): string;

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,14 +55,34 @@ 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`.
  *
  * - `'aaaa-mm-dd'` strings, and date-time strings without a time zone (`'2026-10-01T00:00:00'`),
  *   are read as written: `'2026-10-11'` is the 11th, never the 10th
  *   (`new Date('2026-10-11')` is midnight UTC, which is still the 10th in Argentina).
- * - `Date` objects and ISO strings with a time zone (`'2026-10-22T22:05:36.036Z'`) are shown in
- *   `America/Argentina/Buenos_Aires` time.
+ * - `Date` objects are read in the system time zone, as their own getters do: `new Date(2026, 10, 1)` is
+ *   November 1 in any system time zone.
+ * - ISO strings with a time zone (`'2026-10-22T22:05:36.036Z'`) are shown in `America/Argentina/Buenos_Aires` time.
  * - Any other string (`'11/10/2026'`, `'2026-10'`, `'Oct 11 2026'`) gives `'-'`: the engine would parse it
  *   in the system time zone, or guess the day/month order.
  *
@@ -70,7 +92,7 @@ export function numberToMoney(amount, options = {}) {
  *
  * @example
  * dateToShort('2026-10-11')                                    // "11/10/2026"
- * dateToShort(new Date('2026-10-22T22:05:36Z'))                // "22/10/2026"
+ * dateToShort(new Date(2026, 9, 22))                           // "22/10/2026"
  * dateToShort('2026-10-22T02:05:36Z', { time: true })          // "21/10/2026 23:05"
  */
 export function dateToShort(value, options = {}) {
@@ -89,7 +111,7 @@ export function dateToShort(value, options = {}) {
  * @example
  * dateToYMD('2026-10-11')                       // "2026-10-11"
  * dateToYMD('2026-10-11T00:00:00')              // "2026-10-11"
- * dateToYMD(new Date('2026-10-22T02:05:36Z'))   // "2026-10-21"
+ * dateToYMD(new Date(2026, 9, 21))             // "2026-10-21"
  * dateToYMD('11/10/2026')                       // ""
  */
 export function dateToYMD(value) {
@@ -120,6 +142,17 @@ export function dateToMonthYearLong(value) {
 function toDateParts(value) {
     if (value === null || value === undefined)
         return null;
+    if (value instanceof Date) {
+        if (Number.isNaN(value.getTime()))
+            return null;
+        return {
+            year: value.getFullYear(),
+            month: value.getMonth() + 1,
+            day: value.getDate(),
+            hours: value.getHours(),
+            minutes: value.getMinutes(),
+        };
+    }
     if (typeof value === 'string') {
         const match = WALL_CLOCK_PATTERN.exec(value);
         if (match) {

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": "2.1.1",
+  "version": "3.1.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",