@leaderty/utils 3.2.0 → 3.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @leaderty/utils
 
-Argentine number and date formatting. Every function returns the same output on any system: none of them uses `Intl`, `toLocaleString()` or the system time zone, so a WebView in English still shows `350.000` and `dd/mm/aaaa`.
+Argentine number and date formatting. Every formatter returns the same output on any system: none of them uses `Intl`, `toLocaleString()` or the system time zone, so a WebView in English still shows `350.000` and `dd/mm/aaaa`. `parseLocalDate` is the exception: it returns a `Date` at local midnight.
 
 ## Setup
 
@@ -121,6 +121,25 @@ dateToMonthYearLong('2026-10-11')   // "octubre de 2026"
 dateToMonthYearLong('2026-10-01')   // "octubre de 2026" (not September)
 ```
 
+### `parseLocalDate(value)`
+
+Lee una fecha del API como fecha local. `new Date('aaaa-mm-dd')` es medianoche UTC: en Argentina es el día anterior, y el día 1 cae en el mes anterior.
+
+**Comportamiento:**
+- `'aaaa-mm-dd'` da la medianoche de ese día en la zona horaria del sistema.
+- Cualquier otro string se lee con `new Date(value)`: `'aaaa-mm-ddThh:mm:ss'` (sin zona, ya local) y las fechas con zona quedan igual.
+
+**Parámetros:**
+- `value` - `string`
+
+**Devuelve:** `Date`
+
+**Ejemplos:**
+```typescript
+parseLocalDate('2026-10-01')             // 1 de octubre, 00:00 locales (no el 30/9)
+parseLocalDate('2026-10-22T22:05:36Z')   // igual que new Date('2026-10-22T22:05:36Z')
+```
+
 ### `numberToDecimalString(numero)`
 
 Formats a number with two decimals and thousands separators. Rounds like `numberToMoney(n, { decimals: 2 })`, so `1.005` gives `1,01`. Formerly `numberToStringWithDecimals`, which stays as a deprecated alias.

package/dist/format.d.ts

@@ -93,3 +93,16 @@ export declare function dateToYMD(value: Date | string | null | undefined): stri
  * dateToMonthYearLong(new Date(2027, 0, 11)) // "enero de 2027"
  */
 export declare function dateToMonthYearLong(value: Date | string | null | undefined): string;
+/**
+ * Reads an API date as a local date. `new Date('aaaa-mm-dd')` is midnight UTC: in Argentina that is
+ * the previous day, and the 1st falls in the previous month.
+ * Only that format changes; `'aaaa-mm-ddThh:mm:ss'` (no zone, already local) and zoned dates are read by `new Date`.
+ *
+ * @param value - Date string from the API
+ * @returns Local midnight of that day for `'aaaa-mm-dd'`, otherwise `new Date(value)`
+ *
+ * @example
+ * parseLocalDate('2026-10-01')            // October 1, 00:00 in the system time zone
+ * parseLocalDate('2026-10-22T22:05:36Z')  // same as new Date('2026-10-22T22:05:36Z')
+ */
+export declare function parseLocalDate(value: string): Date;

package/dist/format.js

@@ -139,6 +139,22 @@ export function dateToMonthYearLong(value) {
         return PLACEHOLDER;
     return `${MONTH_NAMES[parts.month - 1]} de ${parts.year}`;
 }
+/**
+ * Reads an API date as a local date. `new Date('aaaa-mm-dd')` is midnight UTC: in Argentina that is
+ * the previous day, and the 1st falls in the previous month.
+ * Only that format changes; `'aaaa-mm-ddThh:mm:ss'` (no zone, already local) and zoned dates are read by `new Date`.
+ *
+ * @param value - Date string from the API
+ * @returns Local midnight of that day for `'aaaa-mm-dd'`, otherwise `new Date(value)`
+ *
+ * @example
+ * parseLocalDate('2026-10-01')            // October 1, 00:00 in the system time zone
+ * parseLocalDate('2026-10-22T22:05:36Z')  // same as new Date('2026-10-22T22:05:36Z')
+ */
+export function parseLocalDate(value) {
+    const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+    return match ? new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3])) : new Date(value);
+}
 function toDateParts(value) {
     if (value === null || value === undefined)
         return null;

package/dist/index.d.ts

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

package/dist/index.js

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

package/package.json

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