@cranberry-money/shared-utils 4.1.0 → 4.3.0

package/dist/currency.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Currency formatting utility functions and constants
+ *
+ * This module provides pure functions for formatting currency values,
+ * parsing currency inputs, and working with different currency formats.
+ */
+/**
+ * Number formatting options for currency display
+ */
+export declare const NUMBER_FORMAT_OPTIONS_CURRENCY: {
+    readonly style: "currency";
+    readonly minimumFractionDigits: 2;
+    readonly maximumFractionDigits: 2;
+};
+/**
+ * Number formatting options for currency with explicit sign display
+ */
+export declare const NUMBER_FORMAT_OPTIONS_CURRENCY_SIGNED: {
+    readonly signDisplay: "always";
+    readonly style: "currency";
+    readonly minimumFractionDigits: 2;
+    readonly maximumFractionDigits: 2;
+};
+/**
+ * Formats a number as currency with commas and 2 decimal places
+ *
+ * @param value - Number or string value to format
+ * @returns Formatted currency string without currency symbol
+ *
+ * @example
+ * ```typescript
+ * formatCurrency(1234.5) // '1,234.50'
+ * formatCurrency('1234.5') // '1,234.50'
+ * formatCurrency(0) // '0.00'
+ * ```
+ */
+export declare function formatCurrency(value: number | string): string;
+/**
+ * Parses a currency string input into a number
+ *
+ * @param value - Currency string to parse
+ * @returns Parsed number value (or 0 if invalid)
+ *
+ * @example
+ * ```typescript
+ * parseCurrencyInput('$1,234.56') // 1234.56
+ * parseCurrencyInput('1234.567') // 1234.56
+ * parseCurrencyInput('abc') // 0
+ * ```
+ */
+export declare function parseCurrencyInput(value: string): number;
+/**
+ * Formats a number as currency with specific currency code and locale
+ *
+ * @param value - Number to format
+ * @param currencyCode - ISO 4217 currency code (default: DEFAULT_CURRENCY)
+ * @param locale - Locale for formatting (default: 'en-AU')
+ * @param minimumFractionDigits - Minimum decimal places (default: 0)
+ * @param maximumFractionDigits - Maximum decimal places (default: 0)
+ * @returns Formatted currency string
+ *
+ * @example
+ * ```typescript
+ * formatCurrencyWithCode(1234.5) // 'A$1,235'
+ * formatCurrencyWithCode(1234.5, 'USD', 'en-US') // '$1,235'
+ * formatCurrencyWithCode(1234.56, 'AUD', 'en-AU', 2, 2) // 'A$1,234.56'
+ * ```
+ */
+export declare function formatCurrencyWithCode(value: number, currencyCode?: string, locale?: string, minimumFractionDigits?: number, maximumFractionDigits?: number): string;
+/**
+ * Convenience function to format currency with the default currency (AUD)
+ *
+ * @param value - Number to format
+ * @param minimumFractionDigits - Minimum decimal places (default: 0)
+ * @param maximumFractionDigits - Maximum decimal places (default: 0)
+ * @returns Formatted currency string with default currency
+ *
+ * @example
+ * ```typescript
+ * formatDefaultCurrency(1234.5) // 'A$1,235'
+ * formatDefaultCurrency(1234.56, 2, 2) // 'A$1,234.56'
+ * ```
+ */
+export declare function formatDefaultCurrency(value: number, minimumFractionDigits?: number, maximumFractionDigits?: number): string;
+/**
+ * Formats a number for displaying share quantities (no decimals)
+ *
+ * @param shares - Number of shares to format
+ * @param locale - Locale for formatting (default: 'en-AU')
+ * @returns Formatted shares string with commas as thousands separators
+ *
+ * @example
+ * ```typescript
+ * formatShares(1234) // '1,234'
+ * formatShares(1234567) // '1,234,567'
+ * ```
+ */
+export declare function formatShares(shares: number, locale?: string): string;
+//# sourceMappingURL=currency.d.ts.map

package/dist/currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../src/currency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;CAIjC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,qCAAqC;;;;;CAGxC,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAW7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOxD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,YAAY,GAAE,MAAyB,EACvC,MAAM,GAAE,MAAgB,EACxB,qBAAqB,GAAE,MAAU,EACjC,qBAAqB,GAAE,MAAU,GAChC,MAAM,CASR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,qBAAqB,GAAE,MAAU,EACjC,qBAAqB,GAAE,MAAU,GAChC,MAAM,CAER;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAgB,GAAG,MAAM,CAK7E"}

package/dist/currency.js

@@ -0,0 +1,128 @@
+/**
+ * Currency formatting utility functions and constants
+ *
+ * This module provides pure functions for formatting currency values,
+ * parsing currency inputs, and working with different currency formats.
+ */
+import { DEFAULT_CURRENCY, DECIMAL_PLACES } from '@cranberry-money/shared-constants';
+/**
+ * Number formatting options for currency display
+ */
+export const NUMBER_FORMAT_OPTIONS_CURRENCY = {
+    style: 'currency',
+    minimumFractionDigits: DECIMAL_PLACES,
+    maximumFractionDigits: DECIMAL_PLACES,
+};
+/**
+ * Number formatting options for currency with explicit sign display
+ */
+export const NUMBER_FORMAT_OPTIONS_CURRENCY_SIGNED = {
+    ...NUMBER_FORMAT_OPTIONS_CURRENCY,
+    signDisplay: 'always',
+};
+/**
+ * Formats a number as currency with commas and 2 decimal places
+ *
+ * @param value - Number or string value to format
+ * @returns Formatted currency string without currency symbol
+ *
+ * @example
+ * ```typescript
+ * formatCurrency(1234.5) // '1,234.50'
+ * formatCurrency('1234.5') // '1,234.50'
+ * formatCurrency(0) // '0.00'
+ * ```
+ */
+export function formatCurrency(value) {
+    if (!value && value !== 0)
+        return '';
+    const numValue = typeof value === 'string' ? parseFloat(value) : value;
+    if (isNaN(numValue))
+        return '';
+    return numValue.toLocaleString('en-AU', {
+        minimumFractionDigits: 2,
+        maximumFractionDigits: 2,
+    });
+}
+/**
+ * Parses a currency string input into a number
+ *
+ * @param value - Currency string to parse
+ * @returns Parsed number value (or 0 if invalid)
+ *
+ * @example
+ * ```typescript
+ * parseCurrencyInput('$1,234.56') // 1234.56
+ * parseCurrencyInput('1234.567') // 1234.56
+ * parseCurrencyInput('abc') // 0
+ * ```
+ */
+export function parseCurrencyInput(value) {
+    const cleanValue = value.replace(/[^0-9.]/g, '');
+    const parts = cleanValue.split('.');
+    const formattedValue = parts[0] + (parts.length > 1 && parts[1] ? '.' + parts[1].slice(0, 2) : '');
+    return parseFloat(formattedValue) || 0;
+}
+/**
+ * Formats a number as currency with specific currency code and locale
+ *
+ * @param value - Number to format
+ * @param currencyCode - ISO 4217 currency code (default: DEFAULT_CURRENCY)
+ * @param locale - Locale for formatting (default: 'en-AU')
+ * @param minimumFractionDigits - Minimum decimal places (default: 0)
+ * @param maximumFractionDigits - Maximum decimal places (default: 0)
+ * @returns Formatted currency string
+ *
+ * @example
+ * ```typescript
+ * formatCurrencyWithCode(1234.5) // 'A$1,235'
+ * formatCurrencyWithCode(1234.5, 'USD', 'en-US') // '$1,235'
+ * formatCurrencyWithCode(1234.56, 'AUD', 'en-AU', 2, 2) // 'A$1,234.56'
+ * ```
+ */
+export function formatCurrencyWithCode(value, currencyCode = DEFAULT_CURRENCY, locale = 'en-AU', minimumFractionDigits = 0, maximumFractionDigits = 0) {
+    if (value == null || isNaN(value))
+        return '';
+    return new Intl.NumberFormat(locale, {
+        style: 'currency',
+        currency: currencyCode,
+        minimumFractionDigits,
+        maximumFractionDigits,
+    }).format(value);
+}
+/**
+ * Convenience function to format currency with the default currency (AUD)
+ *
+ * @param value - Number to format
+ * @param minimumFractionDigits - Minimum decimal places (default: 0)
+ * @param maximumFractionDigits - Maximum decimal places (default: 0)
+ * @returns Formatted currency string with default currency
+ *
+ * @example
+ * ```typescript
+ * formatDefaultCurrency(1234.5) // 'A$1,235'
+ * formatDefaultCurrency(1234.56, 2, 2) // 'A$1,234.56'
+ * ```
+ */
+export function formatDefaultCurrency(value, minimumFractionDigits = 0, maximumFractionDigits = 0) {
+    return formatCurrencyWithCode(value, DEFAULT_CURRENCY, 'en-AU', minimumFractionDigits, maximumFractionDigits);
+}
+/**
+ * Formats a number for displaying share quantities (no decimals)
+ *
+ * @param shares - Number of shares to format
+ * @param locale - Locale for formatting (default: 'en-AU')
+ * @returns Formatted shares string with commas as thousands separators
+ *
+ * @example
+ * ```typescript
+ * formatShares(1234) // '1,234'
+ * formatShares(1234567) // '1,234,567'
+ * ```
+ */
+export function formatShares(shares, locale = 'en-AU') {
+    return new Intl.NumberFormat(locale, {
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 0,
+    }).format(shares);
+}

package/dist/date.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Date and time formatting utility functions
+ *
+ * This module provides pure functions for formatting dates and times
+ * in various formats suitable for display in the application.
+ */
+/**
+ * Formats a date string to a localized date
+ *
+ * @param dateString - ISO date string or null
+ * @param fallback - Fallback text when date is null (default: 'No expiry')
+ * @returns Formatted date string
+ *
+ * @example
+ * ```typescript
+ * formatDate('2024-03-15') // '3/15/2024' (in en-US)
+ * formatDate(null) // 'No expiry'
+ * formatDate(null, 'Not set') // 'Not set'
+ * ```
+ */
+export declare function formatDate(dateString: string | null, fallback?: string): string;
+/**
+ * Formats a date string to a short date format (e.g., "Jan 15")
+ *
+ * @param dateString - ISO date string
+ * @param locale - Locale for formatting (default: 'en-AU')
+ * @returns Formatted short date string
+ *
+ * @example
+ * ```typescript
+ * formatShortDate('2024-01-15') // 'Jan 15'
+ * formatShortDate('2024-12-25', 'en-US') // 'Dec 25'
+ * ```
+ */
+export declare function formatShortDate(dateString: string, locale?: string): string;
+/**
+ * Formats a date string to a time format (24-hour)
+ *
+ * @param dateString - ISO date string
+ * @param locale - Locale for formatting (default: 'en-AU')
+ * @returns Formatted time string in 24-hour format
+ *
+ * @example
+ * ```typescript
+ * formatTime('2024-01-15T14:30:00') // '14:30'
+ * formatTime('2024-01-15T09:05:00') // '09:05'
+ * ```
+ */
+export declare function formatTime(dateString: string, locale?: string): string;
+/**
+ * Formats a date string to a combined short date and time format
+ *
+ * @param dateString - ISO date string
+ * @param locale - Locale for formatting (default: 'en-AU')
+ * @returns Formatted string like "Jan 15 14:30"
+ *
+ * @example
+ * ```typescript
+ * formatDateTime('2024-01-15T14:30:00') // 'Jan 15 14:30'
+ * formatDateTime('2024-12-25T09:00:00', 'en-US') // 'Dec 25 09:00'
+ * ```
+ */
+export declare function formatDateTime(dateString: string, locale?: string): string;
+//# sourceMappingURL=date.d.ts.map

package/dist/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../src/date.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,GAAE,MAAoB,GAAG,MAAM,CAG5F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,MAAgB,GAAG,MAAM,CAMpF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,MAAgB,GAAG,MAAM,CAM/E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,MAAgB,GAAG,MAAM,CAYnF"}

package/dist/date.js

@@ -0,0 +1,91 @@
+/**
+ * Date and time formatting utility functions
+ *
+ * This module provides pure functions for formatting dates and times
+ * in various formats suitable for display in the application.
+ */
+/**
+ * Formats a date string to a localized date
+ *
+ * @param dateString - ISO date string or null
+ * @param fallback - Fallback text when date is null (default: 'No expiry')
+ * @returns Formatted date string
+ *
+ * @example
+ * ```typescript
+ * formatDate('2024-03-15') // '3/15/2024' (in en-US)
+ * formatDate(null) // 'No expiry'
+ * formatDate(null, 'Not set') // 'Not set'
+ * ```
+ */
+export function formatDate(dateString, fallback = 'No expiry') {
+    if (!dateString)
+        return fallback;
+    return new Date(dateString).toLocaleDateString();
+}
+/**
+ * Formats a date string to a short date format (e.g., "Jan 15")
+ *
+ * @param dateString - ISO date string
+ * @param locale - Locale for formatting (default: 'en-AU')
+ * @returns Formatted short date string
+ *
+ * @example
+ * ```typescript
+ * formatShortDate('2024-01-15') // 'Jan 15'
+ * formatShortDate('2024-12-25', 'en-US') // 'Dec 25'
+ * ```
+ */
+export function formatShortDate(dateString, locale = 'en-AU') {
+    const date = new Date(dateString);
+    return date.toLocaleDateString(locale, {
+        month: 'short',
+        day: 'numeric',
+    });
+}
+/**
+ * Formats a date string to a time format (24-hour)
+ *
+ * @param dateString - ISO date string
+ * @param locale - Locale for formatting (default: 'en-AU')
+ * @returns Formatted time string in 24-hour format
+ *
+ * @example
+ * ```typescript
+ * formatTime('2024-01-15T14:30:00') // '14:30'
+ * formatTime('2024-01-15T09:05:00') // '09:05'
+ * ```
+ */
+export function formatTime(dateString, locale = 'en-AU') {
+    return new Date(dateString).toLocaleTimeString(locale, {
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false,
+    });
+}
+/**
+ * Formats a date string to a combined short date and time format
+ *
+ * @param dateString - ISO date string
+ * @param locale - Locale for formatting (default: 'en-AU')
+ * @returns Formatted string like "Jan 15 14:30"
+ *
+ * @example
+ * ```typescript
+ * formatDateTime('2024-01-15T14:30:00') // 'Jan 15 14:30'
+ * formatDateTime('2024-12-25T09:00:00', 'en-US') // 'Dec 25 09:00'
+ * ```
+ */
+export function formatDateTime(dateString, locale = 'en-AU') {
+    const date = new Date(dateString);
+    const shortDate = date.toLocaleDateString(locale, {
+        month: 'short',
+        day: 'numeric',
+    });
+    const time = date.toLocaleTimeString(locale, {
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false,
+    });
+    return `${shortDate} ${time}`;
+}

package/dist/index.d.ts

@@ -5,4 +5,6 @@
  * All utilities are pure functions with no side effects.
  */
 export { truncateText } from './text';
+export { formatDate, formatShortDate, formatTime, formatDateTime } from './date';
+export { NUMBER_FORMAT_OPTIONS_CURRENCY, NUMBER_FORMAT_OPTIONS_CURRENCY_SIGNED, formatCurrency, parseCurrencyInput, formatCurrencyWithCode, formatDefaultCurrency, formatShares, } from './currency';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAGjF,OAAO,EACL,8BAA8B,EAC9B,qCAAqC,EACrC,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -6,3 +6,7 @@
  */
 // Text manipulation utilities
 export { truncateText } from './text';
+// Date and time formatting utilities
+export { formatDate, formatShortDate, formatTime, formatDateTime } from './date';
+// Currency formatting utilities
+export { NUMBER_FORMAT_OPTIONS_CURRENCY, NUMBER_FORMAT_OPTIONS_CURRENCY_SIGNED, formatCurrency, parseCurrencyInput, formatCurrencyWithCode, formatDefaultCurrency, formatShares, } from './currency';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cranberry-money/shared-utils",
-  "version": "4.1.0",
+  "version": "4.3.0",
   "description": "Shared utility functions for MyPortfolio platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",