@nr1e/commons 0.4.1 → 0.4.3

package/dist/lang/datetime.d.mts

@@ -1,5 +1,5 @@
 export declare function isoDateToFormattedUtc(isoDate: string): string;
-export declare function formatDate(date: Date): string;
+export declare function formatDate(date: Date, timeZone?: string, locale?: string): string;
 /**
  * Formats a date and time to a human-readable string with time zone.
  * @param date - Date string or Date object to format.
@@ -7,6 +7,14 @@ export declare function formatDate(date: Date): string;
  * @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 and time to a human-readable string with time zone.
+ * @param date - Date string or Date object to format.
+ * @param timeZone - The time zone to use (e.g., 'America/Los_Angeles') - defaults to the local time zone.
+ * @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 formatTimeZoneDateTimeReadable(date: string | Date, timeZone?: string, 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.
@@ -15,6 +23,15 @@ export declare function formatDateTimeReadable(date: string | Date, locale?: str
  * @returns Formatted date string like "Jun 30, 2025".
  */
 export declare function formatDateShort(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 timeZone - The time zone to use (e.g., 'America/Los_Angeles') - defaults to the local time zone.
+ * @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 formatTimeZoneDateShort(date: string | Date, timeZone?: string, locale?: string): string;
 /**
  * Calculates the number of days between a given date and the current date.
  * @param date - The date to calculate from.

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;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"}
+{"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,CACxB,IAAI,EAAE,IAAI,EACV,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAQR;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAWR;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAYR;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAO5E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAQR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKxD"}

package/dist/lang/datetime.mjs

@@ -24,13 +24,14 @@ export function isoDateToFormattedUtc(isoDate) {
     const minutesStr = minutes.toString().padStart(2, '0');
     return `${month} ${day}, ${year} ${hours}:${minutesStr} ${ampm} UTC`;
 }
-export function formatDate(date) {
+export function formatDate(date, timeZone, locale) {
     const options = {
+        timeZone,
         month: 'short', // “Jan”, “Feb”, etc.
         day: 'numeric', // “1”, “2”, etc.
         year: 'numeric', // “2020”
     };
-    return new Intl.DateTimeFormat('en-US', options).format(date);
+    return new Intl.DateTimeFormat(locale ?? 'en-US', options).format(date);
 }
 /**
  * Formats a date and time to a human-readable string with time zone.
@@ -50,6 +51,26 @@ export function formatDateTimeReadable(date, locale) {
         timeZoneName: 'short',
     }).format(dateObj);
 }
+/**
+ * Formats a date and time to a human-readable string with time zone.
+ * @param date - Date string or Date object to format.
+ * @param timeZone - The time zone to use (e.g., 'America/Los_Angeles') - defaults to the local time zone.
+ * @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 formatTimeZoneDateTimeReadable(date, timeZone, locale) {
+    const dateObj = typeof date === 'string' ? new Date(date) : date;
+    return new Intl.DateTimeFormat(locale ?? 'en-US', {
+        timeZone,
+        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.
@@ -65,6 +86,23 @@ export function formatDateShort(date, locale) {
         day: 'numeric',
     }).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 timeZone - The time zone to use (e.g., 'America/Los_Angeles') - defaults to the local time zone.
+ * @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 formatTimeZoneDateShort(date, timeZone, locale) {
+    const dateObj = typeof date === 'string' ? new Date(date) : date;
+    return new Intl.DateTimeFormat(locale ?? 'en-US', {
+        timeZone,
+        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.

package/dist/lang/datetime.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"datetime.mjs","sourceRoot":"","sources":["../../src/lang/datetime.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"datetime.mjs","sourceRoot":"","sources":["../../src/lang/datetime.mts"],"names":[],"mappings":"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"}

package/dist/lang/string.d.mts

@@ -1,2 +1,61 @@
+/**
+ * Capitalizes the first letter of a string
+ *
+ * @param input - The string to capitalize
+ */
 export declare function capitalizeFirstLetter(input: string): string;
+/**
+ * Returns null if the input string is empty or only whitespace. Otherwise, returns the input string.
+ *
+ * @param input - The string to check
+ */
+export declare function emptyToNull(input?: string | null): string | null;
+/**
+ * Tests if a string is lower case alphanumeric
+ *
+ * @param str the string to check
+ */
+export declare function isLowerAlphanumeric(str?: string | null): boolean;
+/**
+ * Tests if a string is upper case alphanumeric.
+ *
+ * @param str the string to check
+ */
+export declare function isUpperAlphanumeric(str?: string | null): boolean;
+/**
+ * Tests if a string is PascalCase.
+ *
+ * @param str the string to test
+ */
+export declare function isPascalCase(str?: string | null): boolean;
+/**
+ * Tests if a string is camelCase.
+ *
+ * @param str the string to test
+ */
+export declare function isCamelCase(str?: string | null): boolean;
+/**
+ * Converts a string to snake_case
+ *
+ * @param str the string to convert
+ */
+export declare function toSnakeCase(str: string): string;
+/**
+ * Converts a string to kebab-case
+ *
+ * @param str the string to convert
+ */
+export declare function toKebabCase(str: string): string;
+/**
+ * Converts a string to camelCase.
+ *
+ * @param str the string to convert
+ */
+export declare function toCamelCase(str: string): string;
+/**
+ * Converts a string to PascalCase.
+ *
+ * @param str the string to convert
+ */
+export declare function toPascalCase(str: string): string;
 //# sourceMappingURL=string.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"string.d.mts","sourceRoot":"","sources":["../../src/lang/string.mts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D"}
+{"version":3,"file":"string.d.mts","sourceRoot":"","sources":["../../src/lang/string.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAIhE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAKhE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAKhE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,WAK/C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,WAK9C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ/C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ/C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD"}

package/dist/lang/string.mjs

@@ -1,4 +1,104 @@
+/**
+ * Capitalizes the first letter of a string
+ *
+ * @param input - The string to capitalize
+ */
 export function capitalizeFirstLetter(input) {
     return input.charAt(0).toUpperCase() + input.slice(1);
 }
+/**
+ * Returns null if the input string is empty or only whitespace. Otherwise, returns the input string.
+ *
+ * @param input - The string to check
+ */
+export function emptyToNull(input) {
+    if (!input)
+        return null;
+    if (input.trim().length === 0)
+        return null;
+    return input;
+}
+/**
+ * Tests if a string is lower case alphanumeric
+ *
+ * @param str the string to check
+ */
+export function isLowerAlphanumeric(str) {
+    if (str) {
+        return /^[a-z0-9]+$/.test(str);
+    }
+    return false;
+}
+/**
+ * Tests if a string is upper case alphanumeric.
+ *
+ * @param str the string to check
+ */
+export function isUpperAlphanumeric(str) {
+    if (str) {
+        return /^[A-Z0-9]+$/.test(str);
+    }
+    return false;
+}
+/**
+ * Tests if a string is PascalCase.
+ *
+ * @param str the string to test
+ */
+export function isPascalCase(str) {
+    if (str) {
+        return /^[A-Z][a-z0-9]*(?:[A-Z][a-z0-9]*)*$/.test(str);
+    }
+    return false;
+}
+/**
+ * Tests if a string is camelCase.
+ *
+ * @param str the string to test
+ */
+export function isCamelCase(str) {
+    if (str) {
+        return /^[a-z][a-z0-9]*([A-Z][a-z0-9]*)*$/.test(str);
+    }
+    return false;
+}
+/**
+ * Converts a string to snake_case
+ *
+ * @param str the string to convert
+ */
+export function toSnakeCase(str) {
+    return (str.match(/[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g) || [])
+        .map((x) => x.toLowerCase())
+        .join('_');
+}
+/**
+ * Converts a string to kebab-case
+ *
+ * @param str the string to convert
+ */
+export function toKebabCase(str) {
+    return (str.match(/[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g) || [])
+        .map((x) => x.toLowerCase())
+        .join('-');
+}
+/**
+ * Converts a string to camelCase.
+ *
+ * @param str the string to convert
+ */
+export function toCamelCase(str) {
+    str = toPascalCase(str);
+    return str.charAt(0).toLowerCase() + str.slice(1);
+}
+/**
+ * Converts a string to PascalCase.
+ *
+ * @param str the string to convert
+ */
+export function toPascalCase(str) {
+    return (str.match(/[a-zA-Z0-9]+/g) || [])
+        .map((x) => `${x.charAt(0).toUpperCase()}${x.slice(1)}`)
+        .join('');
+}
 //# sourceMappingURL=string.mjs.map

package/dist/lang/string.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"string.mjs","sourceRoot":"","sources":["../../src/lang/string.mts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"string.mjs","sourceRoot":"","sources":["../../src/lang/string.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAqB;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAmB;IACrD,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAmB;IACrD,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAmB;IAC9C,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,qCAAqC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAmB;IAC7C,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,mCAAmC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,CACL,GAAG,CAAC,KAAK,CACP,oEAAoE,CACrE,IAAI,EAAE,CACR;SACE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,CACL,GAAG,CAAC,KAAK,CACP,oEAAoE,CACrE,IAAI,EAAE,CACR;SACE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;SACvD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nr1e/commons",
   "description": "Common utilities for TypeScript projects",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "type": "module",
   "author": "NR1E, Inc.",
   "publishConfig": {
@@ -16,9 +16,9 @@
     "dist"
   ],
   "devDependencies": {
-    "@eslint/js": "^9.39.2",
+    "@eslint/js": "^9.39.3",
     "@types/node": "^24.10.13",
-    "eslint": "9.39.2",
+    "eslint": "9.39.3",
     "prettier": "3.8.1",
     "typescript": "5.9.3",
     "typescript-eslint": "8.56.0",