@cranberry-money/shared-utils 5.0.0 → 5.0.1

package/dist/collections.js

@@ -1,127 +0,0 @@
-/**
- * Generic collection and array utilities
- * Pure functions for common array operations with type safety
- */
-/**
- * Sort array of objects by a string field
- * @param items - Array of objects to sort
- * @param fieldName - Name of the field to sort by
- * @returns New sorted array
- */
-export function sortByStringField(items, fieldName) {
-    return [...items].sort((a, b) => {
-        const aValue = String(a[fieldName]);
-        const bValue = String(b[fieldName]);
-        return aValue.localeCompare(bValue);
-    });
-}
-/**
- * Filter array by text search in a specific field (case-insensitive)
- * @param items - Array of objects to filter
- * @param fieldName - Name of the field to search in
- * @param searchTerm - Search term
- * @returns Filtered array
- */
-export function filterByTextSearch(items, fieldName, searchTerm) {
-    const lowercaseSearch = searchTerm.toLowerCase();
-    return items.filter(item => {
-        const fieldValue = String(item[fieldName]).toLowerCase();
-        return fieldValue.includes(lowercaseSearch);
-    });
-}
-/**
- * Filter array by boolean field
- * @param items - Array of objects to filter
- * @param fieldName - Name of the boolean field
- * @param value - Boolean value to filter by
- * @returns Filtered array
- */
-export function filterByBooleanField(items, fieldName, value) {
-    return items.filter(item => Boolean(item[fieldName]) === value);
-}
-/**
- * Find item by exact field match
- * @param items - Array of objects to search
- * @param fieldName - Name of the field to match
- * @param value - Value to match
- * @returns Found item or undefined
- */
-export function findByField(items, fieldName, value) {
-    return items.find(item => item[fieldName] === value);
-}
-/**
- * Find item by case-insensitive string field match
- * @param items - Array of objects to search
- * @param fieldName - Name of the string field to match
- * @param value - String value to match (case-insensitive)
- * @returns Found item or undefined
- */
-export function findByStringField(items, fieldName, value) {
-    const lowercaseValue = value.toLowerCase();
-    return items.find(item => {
-        const fieldValue = String(item[fieldName]).toLowerCase();
-        return fieldValue === lowercaseValue;
-    });
-}
-/**
- * Extract values from a specific field and sort them
- * @param items - Array of objects
- * @param fieldName - Name of the field to extract
- * @returns Sorted array of extracted values
- */
-export function extractAndSortField(items, fieldName) {
-    return items.map(item => item[fieldName]).sort();
-}
-/**
- * Group array items by the first character of a string field
- * @param items - Array of objects to group
- * @param fieldName - Name of the string field to group by
- * @returns Object with first letters as keys and arrays of items as values
- */
-export function groupByFirstLetter(items, fieldName) {
-    return items.reduce((groups, item) => {
-        const fieldValue = String(item[fieldName]);
-        const firstLetter = fieldValue.charAt(0).toUpperCase();
-        if (!groups[firstLetter]) {
-            groups[firstLetter] = [];
-        }
-        groups[firstLetter].push(item);
-        return groups;
-    }, {});
-}
-/**
- * Group array items by a field value
- * @param items - Array of objects to group
- * @param fieldName - Name of the field to group by
- * @returns Object with field values as keys and arrays of items as values
- */
-export function groupByField(items, fieldName) {
-    return items.reduce((groups, item) => {
-        const fieldValue = String(item[fieldName]);
-        if (!groups[fieldValue]) {
-            groups[fieldValue] = [];
-        }
-        groups[fieldValue].push(item);
-        return groups;
-    }, {});
-}
-/**
- * Check if any item in array has a specific boolean field value
- * @param items - Array of objects to check
- * @param fieldName - Name of the boolean field
- * @param value - Boolean value to check for
- * @returns true if any item matches, false otherwise
- */
-export function hasItemWithFieldValue(items, fieldName, value) {
-    return items.some(item => item[fieldName] === value);
-}
-/**
- * Count items that match a field value
- * @param items - Array of objects to count
- * @param fieldName - Name of the field to check
- * @param value - Value to count
- * @returns Number of matching items
- */
-export function countByFieldValue(items, fieldName, value) {
-    return items.filter(item => item[fieldName] === value).length;
-}

package/dist/currency.d.ts

@@ -1,99 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,128 +0,0 @@
-/**
- * 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

@@ -1,64 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,91 +0,0 @@
-/**
- * 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/downloads.d.ts

@@ -1,46 +0,0 @@
-/**
- * File download utilities
- * Browser-based file download functionality
- */
-/**
- * Download a blob as a file
- * Creates a temporary download link and triggers the download
- * @param blob - The blob to download
- * @param filename - The filename for the downloaded file
- */
-export declare function downloadBlob(blob: Blob, filename: string): void;
-/**
- * Download text content as a file
- * @param content - Text content to download
- * @param filename - The filename for the downloaded file
- * @param mimeType - MIME type for the file (default: text/plain)
- */
-export declare function downloadTextFile(content: string, filename: string, mimeType?: string): void;
-/**
- * Download JSON data as a file
- * @param data - JavaScript object to serialize and download
- * @param filename - The filename for the downloaded file (should end with .json)
- */
-export declare function downloadJsonFile(data: unknown, filename: string): void;
-/**
- * Generate a timestamped filename
- * @param baseName - Base name for the file (without extension)
- * @param extension - File extension (with or without leading dot)
- * @param includeTime - Whether to include time in timestamp (default: false)
- * @returns Timestamped filename
- */
-export declare function generateTimestampedFilename(baseName: string, extension: string, includeTime?: boolean): string;
-/**
- * Download data URL as a file
- * @param dataUrl - Data URL (data:mime/type;base64,data)
- * @param filename - The filename for the downloaded file
- */
-export declare function downloadDataUrl(dataUrl: string, filename: string): void;
-/**
- * Download CSV data as a file
- * @param data - Array of objects to convert to CSV
- * @param filename - The filename for the downloaded file (should end with .csv)
- * @param headers - Optional custom headers (uses object keys if not provided)
- */
-export declare function downloadCsvFile<T extends Record<string, unknown>>(data: T[], filename: string, headers?: string[]): void;
-//# sourceMappingURL=downloads.d.ts.map

package/dist/downloads.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"downloads.d.ts","sourceRoot":"","sources":["../src/downloads.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAS/D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAqB,GAAG,IAAI,CAGzG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGtE;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe,GAAG,MAAM,CASrH;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,IAAI,EAAE,CAAC,EAAE,EACT,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,IAAI,CAqBN"}

package/dist/downloads.js

@@ -1,91 +0,0 @@
-/**
- * File download utilities
- * Browser-based file download functionality
- */
-/**
- * Download a blob as a file
- * Creates a temporary download link and triggers the download
- * @param blob - The blob to download
- * @param filename - The filename for the downloaded file
- */
-export function downloadBlob(blob, filename) {
-    const url = window.URL.createObjectURL(blob);
-    const link = document.createElement('a');
-    link.href = url;
-    link.setAttribute('download', filename);
-    document.body.appendChild(link);
-    link.click();
-    document.body.removeChild(link);
-    window.URL.revokeObjectURL(url);
-}
-/**
- * Download text content as a file
- * @param content - Text content to download
- * @param filename - The filename for the downloaded file
- * @param mimeType - MIME type for the file (default: text/plain)
- */
-export function downloadTextFile(content, filename, mimeType = 'text/plain') {
-    const blob = new Blob([content], { type: mimeType });
-    downloadBlob(blob, filename);
-}
-/**
- * Download JSON data as a file
- * @param data - JavaScript object to serialize and download
- * @param filename - The filename for the downloaded file (should end with .json)
- */
-export function downloadJsonFile(data, filename) {
-    const jsonString = JSON.stringify(data, null, 2);
-    downloadTextFile(jsonString, filename, 'application/json');
-}
-/**
- * Generate a timestamped filename
- * @param baseName - Base name for the file (without extension)
- * @param extension - File extension (with or without leading dot)
- * @param includeTime - Whether to include time in timestamp (default: false)
- * @returns Timestamped filename
- */
-export function generateTimestampedFilename(baseName, extension, includeTime = false) {
-    const now = new Date();
-    const dateString = now.toISOString().split('T')[0]; // YYYY-MM-DD
-    const timeString = now.toTimeString().split(' ')[0]?.replace(/:/g, '-') || '00-00-00'; // HH-MM-SS
-    const cleanExtension = extension.startsWith('.') ? extension : `.${extension}`;
-    const timestamp = includeTime ? `${dateString}-${timeString}` : dateString;
-    return `${baseName}-${timestamp}${cleanExtension}`;
-}
-/**
- * Download data URL as a file
- * @param dataUrl - Data URL (data:mime/type;base64,data)
- * @param filename - The filename for the downloaded file
- */
-export function downloadDataUrl(dataUrl, filename) {
-    const link = document.createElement('a');
-    link.href = dataUrl;
-    link.setAttribute('download', filename);
-    document.body.appendChild(link);
-    link.click();
-    document.body.removeChild(link);
-}
-/**
- * Download CSV data as a file
- * @param data - Array of objects to convert to CSV
- * @param filename - The filename for the downloaded file (should end with .csv)
- * @param headers - Optional custom headers (uses object keys if not provided)
- */
-export function downloadCsvFile(data, filename, headers) {
-    if (data.length === 0) {
-        throw new Error('Cannot create CSV from empty data array');
-    }
-    const csvHeaders = headers || Object.keys(data[0] || {});
-    const csvRows = data.map(row => csvHeaders
-        .map(header => {
-        const value = row[header];
-        // Escape commas and quotes in CSV values
-        const stringValue = String(value ?? '');
-        return stringValue.includes(',') || stringValue.includes('"')
-            ? `"${stringValue.replace(/"/g, '""')}"`
-            : stringValue;
-    })
-        .join(','));
-    const csvContent = [csvHeaders.join(','), ...csvRows].join('\n');
-    downloadTextFile(csvContent, filename, 'text/csv');
-}