@leaderty/utils 2.1.0 → 3.0.0

package/README.md

@@ -44,7 +44,8 @@ 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 +59,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 +76,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')                       // ""
 ```
 
@@ -97,7 +98,7 @@ dateToMonthYearLong('2026-10-01')   // "octubre de 2026" (not September)
 
 ### `numberToDecimalString(numero)`
 
-Formats a number with two decimals and thousands separators. Rounds with `toFixed(2)`, so `1.005` gives `1,00`; prefer `numberToMoney(n, { decimals: 2 })` in new code. Formerly `numberToStringWithDecimals`, which stays as a deprecated alias.
+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.
 
 **Parameters:**
 - `numero` - `number`

package/dist/format.d.ts

@@ -38,8 +38,9 @@ export declare function numberToMoney(amount: number | null | undefined, options
  * - `'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 +50,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 +63,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

@@ -59,8 +59,9 @@ export function numberToMoney(amount, options = {}) {
  * - `'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 +71,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 +90,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 +121,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

@@ -1,5 +1,6 @@
 /**
  * Formatea un número a una cadena con dos decimales y separadores de miles.
+ * Redondea igual que `numberToMoney(numero, { decimals: 2 })`: `1.005` da `1,01`.
  */
 export declare function numberToDecimalString(numero: number): string;
 /** @deprecated Renamed to {@link numberToDecimalString}. */

package/dist/index.js

@@ -1,11 +1,10 @@
+import { numberToMoney } from './format.js';
 /**
  * Formatea un número a una cadena con dos decimales y separadores de miles.
+ * Redondea igual que `numberToMoney(numero, { decimals: 2 })`: `1.005` da `1,01`.
  */
 export function numberToDecimalString(numero) {
-    const formatted = numero.toFixed(2);
-    const [integerPart, decimalPart] = formatted.split('.');
-    const withThousandsSeparator = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, '.');
-    return `${withThousandsSeparator},${decimalPart}`;
+    return numberToMoney(numero, { decimals: 2 });
 }
 /** @deprecated Renamed to {@link numberToDecimalString}. */
 export const numberToStringWithDecimals = numberToDecimalString;

package/package.json

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