@nr1e/commons 0.3.0 → 0.3.1

package/dist/lang/currency.d.mts

@@ -0,0 +1,10 @@
+/**
+ * Formats a currency amount using the Intl.NumberFormat API
+ *
+ * @param amount - The amount in cents (e.g., 1000 for $10.00) as number or string
+ * @param currency - The currency code (e.g., 'USD', 'EUR')
+ * @param locale - The locale to use (e.g., 'en-US', 'fr-FR') - defaults to 'en-US'
+ * @returns Formatted currency string
+ */
+export declare const formatCurrency: (amount: number | string, currency: string, locale?: string) => string;
+//# sourceMappingURL=currency.d.mts.map

package/dist/lang/currency.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.mts","sourceRoot":"","sources":["../../src/lang/currency.mts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,WACjB,MAAM,GAAG,MAAM,YACb,MAAM,WACP,MAAM,KACd,MAOF,CAAC"}

package/dist/lang/currency.mjs

@@ -0,0 +1,16 @@
+/**
+ * Formats a currency amount using the Intl.NumberFormat API
+ *
+ * @param amount - The amount in cents (e.g., 1000 for $10.00) as number or string
+ * @param currency - The currency code (e.g., 'USD', 'EUR')
+ * @param locale - The locale to use (e.g., 'en-US', 'fr-FR') - defaults to 'en-US'
+ * @returns Formatted currency string
+ */
+export const formatCurrency = (amount, currency, locale) => {
+    const numericAmount = typeof amount === 'string' ? parseFloat(amount) : amount;
+    return new Intl.NumberFormat(locale ?? 'en-US', {
+        style: 'currency',
+        currency: currency.toUpperCase(),
+    }).format(numericAmount);
+};
+//# sourceMappingURL=currency.mjs.map

package/dist/lang/currency.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.mjs","sourceRoot":"","sources":["../../src/lang/currency.mts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,MAAuB,EACvB,QAAgB,EAChB,MAAe,EACP,EAAE;IACV,MAAM,aAAa,GACjB,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3D,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,IAAI,OAAO,EAAE;QAC9C,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,QAAQ,CAAC,WAAW,EAAE;KACjC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AAC3B,CAAC,CAAC"}

package/dist/lang/datetime.d.mts

@@ -1,3 +1,24 @@
 export declare function isoDateToFormattedUtc(isoDate: string): string;
 export declare function formatDate(date: Date): string;
+/**
+ * Formats a date and time to a human-readable string with time zone.
+ * @param date - Date string or Date object to format.
+ * @param locale - The locale to use (e.g., 'en-US', 'fr-FR') - defaults to 'en-US'
+ * @returns Formatted date string (e.g., "June 14, 2023 12:00 PM MST").
+ */
+export declare function formatDateTimeReadable(date: string | Date, locale?: string): string;
+/**
+ * Formats a date to "Jun 30, 2025" style using the local time zone.
+ * Accepts a Date object or a string parseable by Date.
+ * @param date - Date string or Date object to format.
+ * @param locale - The locale to use (e.g., 'en-US', 'fr-FR') - defaults to 'en-US'
+ * @returns Formatted date string like "Jun 30, 2025".
+ */
+export declare function formatDateShort(date: string | Date, locale?: string): string;
+/**
+ * Calculates the number of days between a given date and the current date.
+ * @param date - The date to calculate from.
+ * @returns The number of days that have passed since the given date.
+ */
+export declare function getDaysSince(date: string | Date): number;
 //# sourceMappingURL=datetime.d.mts.map

package/dist/lang/datetime.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"datetime.d.mts","sourceRoot":"","sources":["../../src/lang/datetime.mts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2B7D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAO7C"}
+{"version":3,"file":"datetime.d.mts","sourceRoot":"","sources":["../../src/lang/datetime.mts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2B7D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAO7C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAWR;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAO5E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKxD"}

package/dist/lang/datetime.mjs

@@ -32,4 +32,48 @@ export function formatDate(date) {
     };
     return new Intl.DateTimeFormat('en-US', options).format(date);
 }
+/**
+ * Formats a date and time to a human-readable string with time zone.
+ * @param date - Date string or Date object to format.
+ * @param locale - The locale to use (e.g., 'en-US', 'fr-FR') - defaults to 'en-US'
+ * @returns Formatted date string (e.g., "June 14, 2023 12:00 PM MST").
+ */
+export function formatDateTimeReadable(date, locale) {
+    const dateObj = typeof date === 'string' ? new Date(date) : date;
+    return new Intl.DateTimeFormat(locale ?? 'en-US', {
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric',
+        hour: 'numeric',
+        minute: '2-digit',
+        hour12: true,
+        timeZoneName: 'short',
+    }).format(dateObj);
+}
+/**
+ * Formats a date to "Jun 30, 2025" style using the local time zone.
+ * Accepts a Date object or a string parseable by Date.
+ * @param date - Date string or Date object to format.
+ * @param locale - The locale to use (e.g., 'en-US', 'fr-FR') - defaults to 'en-US'
+ * @returns Formatted date string like "Jun 30, 2025".
+ */
+export function formatDateShort(date, locale) {
+    const dateObj = typeof date === 'string' ? new Date(date) : date;
+    return new Intl.DateTimeFormat(locale ?? 'en-US', {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+    }).format(dateObj);
+}
+/**
+ * Calculates the number of days between a given date and the current date.
+ * @param date - The date to calculate from.
+ * @returns The number of days that have passed since the given date.
+ */
+export function getDaysSince(date) {
+    const dateObj = typeof date === 'string' ? new Date(date) : date;
+    const now = new Date();
+    const diffTime = now.getTime() - dateObj.getTime();
+    return Math.floor(diffTime / (1000 * 60 * 60 * 24));
+}
 //# sourceMappingURL=datetime.mjs.map

package/dist/lang/datetime.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"datetime.mjs","sourceRoot":"","sources":["../../src/lang/datetime.mts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,UAAU,GAAG;QACjB,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;KACN,CAAC;IACF,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IAEnC,IAAI,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,KAAK,GAAG,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,mCAAmC;IAC7D,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEvD,OAAO,GAAG,KAAK,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,IAAI,UAAU,IAAI,IAAI,MAAM,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,MAAM,OAAO,GAA+B;QAC1C,KAAK,EAAE,OAAO,EAAE,qBAAqB;QACrC,GAAG,EAAE,SAAS,EAAE,iBAAiB;QACjC,IAAI,EAAE,SAAS,EAAE,SAAS;KAC3B,CAAC;IACF,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"datetime.mjs","sourceRoot":"","sources":["../../src/lang/datetime.mts"],"names":[],"mappings":"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"}

package/dist/lang/index.d.mts

@@ -1,3 +1,4 @@
+export * from './currency.mjs';
 export * from './datetime.mjs';
 export * from './equality.mjs';
 export * from './merge.mjs';

package/dist/lang/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/lang/index.mts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/lang/index.mts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}

package/dist/lang/index.mjs

@@ -1,3 +1,4 @@
+export * from './currency.mjs';
 export * from './datetime.mjs';
 export * from './equality.mjs';
 export * from './merge.mjs';

package/dist/lang/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/lang/index.mts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/lang/index.mts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nr1e/commons",
   "description": "Common utilities for TypeScript projects",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "author": "NR1E, Inc.",
   "publishConfig": {