@cranberry-money/shared-utils 4.11.0 → 4.13.0

package/dist/collections.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 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 declare function sortByStringField<T>(items: T[], fieldName: keyof T): T[];
+/**
+ * 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 declare function filterByTextSearch<T>(items: T[], fieldName: keyof T, searchTerm: string): T[];
+/**
+ * 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 declare function filterByBooleanField<T>(items: T[], fieldName: keyof T, value: boolean): T[];
+/**
+ * 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 declare function findByField<T>(items: T[], fieldName: keyof T, value: unknown): T | undefined;
+/**
+ * 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 declare function findByStringField<T>(items: T[], fieldName: keyof T, value: string): T | undefined;
+/**
+ * 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 declare function extractAndSortField<T, K extends keyof T>(items: T[], fieldName: K): T[K][];
+/**
+ * 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 declare function groupByFirstLetter<T>(items: T[], fieldName: keyof T): Record<string, T[]>;
+/**
+ * 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 declare function groupByField<T, K extends keyof T>(items: T[], fieldName: K): Record<string, T[]>;
+/**
+ * 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 declare function hasItemWithFieldValue<T>(items: T[], fieldName: keyof T, value: unknown): boolean;
+/**
+ * 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 declare function countByFieldValue<T>(items: T[], fieldName: keyof T, value: unknown): number;
+//# sourceMappingURL=collections.d.ts.map

package/dist/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAMxE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,EAAE,CAM7F;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE,CAE3F;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS,CAE5F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAMjG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAE1F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAazF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAYhG;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAEhG;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAE3F"}

package/dist/collections.js

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

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

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

@@ -0,0 +1,91 @@
+/**
+ * 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');
+}

package/dist/formatting.d.ts

@@ -0,0 +1,59 @@
+/**
+ * String formatting utilities
+ * Generic string manipulation and formatting functions
+ */
+/**
+ * Capitalize the first letter of a string and make the rest lowercase
+ * @param str - The string to capitalize
+ * @returns Capitalized string
+ * @example
+ * capitalizeFirstLetter('HELLO WORLD') // 'Hello world'
+ * capitalizeFirstLetter('low') // 'Low'
+ */
+export declare function capitalizeFirstLetter(str: string): string;
+/**
+ * Format a status string for display (capitalize first letter, lowercase rest)
+ * @param status - The status string to format
+ * @returns Formatted status string
+ * @example
+ * formatStatus('PENDING') // 'Pending'
+ * formatStatus('completed') // 'Completed'
+ */
+export declare function formatStatus(status: string): string;
+/**
+ * Format a risk level string for display (capitalize first letter, lowercase rest)
+ * @param riskLevel - The risk level string to format
+ * @returns Formatted risk level string
+ * @example
+ * formatRiskLevel('HIGH') // 'High'
+ * formatRiskLevel('moderate') // 'Moderate'
+ */
+export declare function formatRiskLevel(riskLevel: string): string;
+/**
+ * Capitalize only the first letter, keeping the rest unchanged
+ * @param str - The string to capitalize
+ * @returns String with first letter capitalized
+ * @example
+ * capitalizeFirst('hello World') // 'Hello World'
+ * capitalizeFirst('iPhone') // 'IPhone'
+ */
+export declare function capitalizeFirst(str: string): string;
+/**
+ * Format a label by replacing underscores with spaces and capitalizing
+ * @param label - The label to format
+ * @returns Formatted label
+ * @example
+ * formatLabel('first_name') // 'First name'
+ * formatLabel('user_profile_data') // 'User profile data'
+ */
+export declare function formatLabel(label: string): string;
+/**
+ * Convert camelCase to Title Case
+ * @param str - The camelCase string to convert
+ * @returns Title Case string
+ * @example
+ * camelToTitle('firstName') // 'First Name'
+ * camelToTitle('userProfileData') // 'User Profile Data'
+ */
+export declare function camelToTitle(str: string): string;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../src/formatting.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMhD"}

package/dist/formatting.js

@@ -0,0 +1,81 @@
+/**
+ * String formatting utilities
+ * Generic string manipulation and formatting functions
+ */
+/**
+ * Capitalize the first letter of a string and make the rest lowercase
+ * @param str - The string to capitalize
+ * @returns Capitalized string
+ * @example
+ * capitalizeFirstLetter('HELLO WORLD') // 'Hello world'
+ * capitalizeFirstLetter('low') // 'Low'
+ */
+export function capitalizeFirstLetter(str) {
+    if (!str)
+        return str;
+    return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+}
+/**
+ * Format a status string for display (capitalize first letter, lowercase rest)
+ * @param status - The status string to format
+ * @returns Formatted status string
+ * @example
+ * formatStatus('PENDING') // 'Pending'
+ * formatStatus('completed') // 'Completed'
+ */
+export function formatStatus(status) {
+    return capitalizeFirstLetter(status);
+}
+/**
+ * Format a risk level string for display (capitalize first letter, lowercase rest)
+ * @param riskLevel - The risk level string to format
+ * @returns Formatted risk level string
+ * @example
+ * formatRiskLevel('HIGH') // 'High'
+ * formatRiskLevel('moderate') // 'Moderate'
+ */
+export function formatRiskLevel(riskLevel) {
+    return capitalizeFirstLetter(riskLevel);
+}
+/**
+ * Capitalize only the first letter, keeping the rest unchanged
+ * @param str - The string to capitalize
+ * @returns String with first letter capitalized
+ * @example
+ * capitalizeFirst('hello World') // 'Hello World'
+ * capitalizeFirst('iPhone') // 'IPhone'
+ */
+export function capitalizeFirst(str) {
+    if (!str)
+        return str;
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+ * Format a label by replacing underscores with spaces and capitalizing
+ * @param label - The label to format
+ * @returns Formatted label
+ * @example
+ * formatLabel('first_name') // 'First name'
+ * formatLabel('user_profile_data') // 'User profile data'
+ */
+export function formatLabel(label) {
+    if (!label)
+        return label;
+    return capitalizeFirstLetter(label.replace(/_/g, ' '));
+}
+/**
+ * Convert camelCase to Title Case
+ * @param str - The camelCase string to convert
+ * @returns Title Case string
+ * @example
+ * camelToTitle('firstName') // 'First Name'
+ * camelToTitle('userProfileData') // 'User Profile Data'
+ */
+export function camelToTitle(str) {
+    if (!str)
+        return str;
+    return str
+        .replace(/([A-Z])/g, ' $1')
+        .replace(/^./, match => match.toUpperCase())
+        .trim();
+}

package/dist/index.d.ts

@@ -15,10 +15,14 @@ export { formatPortfolioValue, calculateTotalValue, getMarketAllocation, getCash
 export type { LiquidationProgress } from './withdrawal';
 export { formatWithdrawalAmount, formatLiquidationValue, formatSharesQuantity, calculateLiquidationProgress, getTotalEstimatedValue, } from './withdrawal';
 export type { PasswordValidation, EmailConfirmationValidation, ExtendedPasswordValidation } from './validation';
-export { isNumericOnly, validatePassword, isValidTokenFormat, formatVerificationToken, validateEmailConfirmation, isValidEmail, hasUppercase, hasLowercase, hasSpecialCharacter, hasDigit, validatePasswordExtended, isValidPhoneNumber, isValidPhoneFormat, isValidUrl, isValidDate, isEmptyOrWhitespace, meetsMinLength, meetsMaxLength, isInRange, isPositiveNumber, isNonNegativeNumber, isValidFullName, isValidDateOfBirth, formatPhoneNumber, isValidInvestmentAmount, hasMinimumSelection, isSelected, } from './validation';
+export { isNumericOnly, validatePassword, isValidTokenFormat, formatVerificationToken, validateEmailConfirmation, isValidEmail, hasUppercase, hasLowercase, hasSpecialCharacter, hasDigit, validatePasswordExtended, isValidPhoneNumber, isValidPhoneFormat, isValidUrl, isValidDate, isEmptyOrWhitespace, meetsMinLength, meetsMaxLength, isInRange, isPositiveNumber, isNonNegativeNumber, isValidFullName, isValidDateOfBirth, formatPhoneNumber, isValidInvestmentAmount, hasMinimumSelection, isSelected, validatePercentageSum, validateAllocationSum, isInNumberRange, isValidPercentage, } from './validation';
 export { hasActiveFilters, countActiveFilters, clearAllFilters, updateFilters, isFilterEmpty, removeEmptyFilters, mergeFilters, areFiltersEqual, createFilterPredicate, } from './filters';
 export type { DeviceInfo, TokenRefreshResponse, TokenRefreshError, AutoRefreshHandler } from './auth';
 export { isTokenExpired, isTokenExpiringSoon, getTimeUntilExpiry, formatTimeUntilExpiry, parseDeviceInfo, isRefreshSuccess, getRefreshErrorMessage, createAutoRefreshHandler, } from './auth';
 export type { InstrumentTypeInfo, InstrumentBasicInfo, PriceChangeResult, PriceSnapshot, FormattedPriceChange, TradeableInstrument, MarketDataInfo, } from './instruments';
 export { formatInstrumentPrice, getCurrencySymbol, getInstrumentType, formatInstrumentName, calculatePriceChange, formatPriceChange, isInstrumentTradeable, formatMarketCap, formatVolume, hasMarketData, } from './instruments';
+export { sortByStringField, filterByTextSearch, filterByBooleanField, findByField, findByStringField, extractAndSortField, groupByFirstLetter, groupByField, hasItemWithFieldValue, countByFieldValue, } from './collections';
+export { downloadBlob, downloadTextFile, downloadJsonFile, generateTimestampedFilename, downloadDataUrl, downloadCsvFile, } from './downloads';
+export { capitalizeFirstLetter, formatStatus, formatRiskLevel, capitalizeFirst, formatLabel, camelToTitle, } from './formatting';
+export { formatQuantityWithSuffix, formatLargeNumber, formatAsPercentage, formatWithSeparators, roundToDecimals, clampNumber, } from './numbers';
 //# 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;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;AAGpB,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGnE,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhH,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAChH,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,QAAQ,EACR,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAGnB,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACtG,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,aAAa,GACd,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -15,8 +15,18 @@ export { getTradeStatusBadge, getWithdrawalStatusBadge, getLiquidationStatusBadg
 // Portfolio utilities
 export { formatPortfolioValue, calculateTotalValue, getMarketAllocation, getCashAllocation } from './portfolio';
 export { formatWithdrawalAmount, formatLiquidationValue, formatSharesQuantity, calculateLiquidationProgress, getTotalEstimatedValue, } from './withdrawal';
-export { isNumericOnly, validatePassword, isValidTokenFormat, formatVerificationToken, validateEmailConfirmation, isValidEmail, hasUppercase, hasLowercase, hasSpecialCharacter, hasDigit, validatePasswordExtended, isValidPhoneNumber, isValidPhoneFormat, isValidUrl, isValidDate, isEmptyOrWhitespace, meetsMinLength, meetsMaxLength, isInRange, isPositiveNumber, isNonNegativeNumber, isValidFullName, isValidDateOfBirth, formatPhoneNumber, isValidInvestmentAmount, hasMinimumSelection, isSelected, } from './validation';
+export { isNumericOnly, validatePassword, isValidTokenFormat, formatVerificationToken, validateEmailConfirmation, isValidEmail, hasUppercase, hasLowercase, hasSpecialCharacter, hasDigit, validatePasswordExtended, isValidPhoneNumber, isValidPhoneFormat, isValidUrl, isValidDate, isEmptyOrWhitespace, meetsMinLength, meetsMaxLength, isInRange, isPositiveNumber, isNonNegativeNumber, isValidFullName, isValidDateOfBirth, formatPhoneNumber, isValidInvestmentAmount, hasMinimumSelection, isSelected, 
+// Enhanced validation utilities (Phase 14)
+validatePercentageSum, validateAllocationSum, isInNumberRange, isValidPercentage, } from './validation';
 // Filter utilities
 export { hasActiveFilters, countActiveFilters, clearAllFilters, updateFilters, isFilterEmpty, removeEmptyFilters, mergeFilters, areFiltersEqual, createFilterPredicate, } from './filters';
 export { isTokenExpired, isTokenExpiringSoon, getTimeUntilExpiry, formatTimeUntilExpiry, parseDeviceInfo, isRefreshSuccess, getRefreshErrorMessage, createAutoRefreshHandler, } from './auth';
 export { formatInstrumentPrice, getCurrencySymbol, getInstrumentType, formatInstrumentName, calculatePriceChange, formatPriceChange, isInstrumentTradeable, formatMarketCap, formatVolume, hasMarketData, } from './instruments';
+// Collection utilities
+export { sortByStringField, filterByTextSearch, filterByBooleanField, findByField, findByStringField, extractAndSortField, groupByFirstLetter, groupByField, hasItemWithFieldValue, countByFieldValue, } from './collections';
+// Download utilities
+export { downloadBlob, downloadTextFile, downloadJsonFile, generateTimestampedFilename, downloadDataUrl, downloadCsvFile, } from './downloads';
+// String formatting utilities
+export { capitalizeFirstLetter, formatStatus, formatRiskLevel, capitalizeFirst, formatLabel, camelToTitle, } from './formatting';
+// Number formatting utilities
+export { formatQuantityWithSuffix, formatLargeNumber, formatAsPercentage, formatWithSeparators, roundToDecimals, clampNumber, } from './numbers';

package/dist/numbers.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Number formatting utilities
+ * Generic number manipulation and formatting functions
+ */
+/**
+ * Format a large number with K/M suffixes for display
+ * @param quantity - The number to format
+ * @param decimals - Number of decimal places (default: 1)
+ * @returns Formatted number string with suffix
+ * @example
+ * formatQuantityWithSuffix(1000) // '1.0K'
+ * formatQuantityWithSuffix(1500000) // '1.5M'
+ * formatQuantityWithSuffix(999) // '999'
+ */
+export declare function formatQuantityWithSuffix(quantity: number, decimals?: number): string;
+/**
+ * Format a large number with customizable suffixes
+ * @param num - The number to format
+ * @param suffixes - Array of suffix configurations (default: standard K, M, B, T)
+ * @param decimals - Number of decimal places (default: 1)
+ * @returns Formatted number string with suffix
+ * @example
+ * formatLargeNumber(1500000) // '1.5M'
+ * formatLargeNumber(1500000000) // '1.5B'
+ */
+export declare function formatLargeNumber(num: number, suffixes?: Array<{
+    threshold: number;
+    suffix: string;
+}>, decimals?: number): string;
+/**
+ * Format a number as a percentage
+ * @param value - The decimal value to format as percentage
+ * @param decimals - Number of decimal places (default: 1)
+ * @returns Formatted percentage string
+ * @example
+ * formatAsPercentage(0.1234) // '12.3%'
+ * formatAsPercentage(0.5, 0) // '50%'
+ */
+export declare function formatAsPercentage(value: number, decimals?: number): string;
+/**
+ * Format a number with thousand separators
+ * @param num - The number to format
+ * @param separator - The separator character (default: ',')
+ * @returns Formatted number string with separators
+ * @example
+ * formatWithSeparators(1234567) // '1,234,567'
+ * formatWithSeparators(1234567, ' ') // '1 234 567'
+ */
+export declare function formatWithSeparators(num: number, separator?: string): string;
+/**
+ * Round a number to specified decimal places
+ * @param num - The number to round
+ * @param decimals - Number of decimal places (default: 2)
+ * @returns Rounded number
+ * @example
+ * roundToDecimals(3.14159, 2) // 3.14
+ * roundToDecimals(123.456, 0) // 123
+ */
+export declare function roundToDecimals(num: number, decimals?: number): number;
+/**
+ * Clamp a number between min and max values
+ * @param num - The number to clamp
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns Clamped number
+ * @example
+ * clampNumber(150, 0, 100) // 100
+ * clampNumber(-10, 0, 100) // 0
+ * clampNumber(50, 0, 100) // 50
+ */
+export declare function clampNumber(num: number, min: number, max: number): number;
+//# sourceMappingURL=numbers.d.ts.map

package/dist/numbers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../src/numbers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAWvF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAKpD,EACD,QAAQ,GAAE,MAAU,GACnB,MAAM,CAOR;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAE9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CAEjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAGzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/dist/numbers.js

@@ -0,0 +1,101 @@
+/**
+ * Number formatting utilities
+ * Generic number manipulation and formatting functions
+ */
+/**
+ * Format a large number with K/M suffixes for display
+ * @param quantity - The number to format
+ * @param decimals - Number of decimal places (default: 1)
+ * @returns Formatted number string with suffix
+ * @example
+ * formatQuantityWithSuffix(1000) // '1.0K'
+ * formatQuantityWithSuffix(1500000) // '1.5M'
+ * formatQuantityWithSuffix(999) // '999'
+ */
+export function formatQuantityWithSuffix(quantity, decimals = 1) {
+    const million = 1000000;
+    const thousand = 1000;
+    if (quantity >= million) {
+        return `${(quantity / million).toFixed(decimals)}M`;
+    }
+    else if (quantity >= thousand) {
+        return `${(quantity / thousand).toFixed(decimals)}K`;
+    }
+    else {
+        return quantity.toString();
+    }
+}
+/**
+ * Format a large number with customizable suffixes
+ * @param num - The number to format
+ * @param suffixes - Array of suffix configurations (default: standard K, M, B, T)
+ * @param decimals - Number of decimal places (default: 1)
+ * @returns Formatted number string with suffix
+ * @example
+ * formatLargeNumber(1500000) // '1.5M'
+ * formatLargeNumber(1500000000) // '1.5B'
+ */
+export function formatLargeNumber(num, suffixes = [
+    { threshold: 1000000000000, suffix: 'T' },
+    { threshold: 1000000000, suffix: 'B' },
+    { threshold: 1000000, suffix: 'M' },
+    { threshold: 1000, suffix: 'K' },
+], decimals = 1) {
+    for (const { threshold, suffix } of suffixes) {
+        if (num >= threshold) {
+            return `${(num / threshold).toFixed(decimals)}${suffix}`;
+        }
+    }
+    return num.toString();
+}
+/**
+ * Format a number as a percentage
+ * @param value - The decimal value to format as percentage
+ * @param decimals - Number of decimal places (default: 1)
+ * @returns Formatted percentage string
+ * @example
+ * formatAsPercentage(0.1234) // '12.3%'
+ * formatAsPercentage(0.5, 0) // '50%'
+ */
+export function formatAsPercentage(value, decimals = 1) {
+    return `${(value * 100).toFixed(decimals)}%`;
+}
+/**
+ * Format a number with thousand separators
+ * @param num - The number to format
+ * @param separator - The separator character (default: ',')
+ * @returns Formatted number string with separators
+ * @example
+ * formatWithSeparators(1234567) // '1,234,567'
+ * formatWithSeparators(1234567, ' ') // '1 234 567'
+ */
+export function formatWithSeparators(num, separator = ',') {
+    return num.toString().replace(/\B(?=(\d{3})+(?!\d))/g, separator);
+}
+/**
+ * Round a number to specified decimal places
+ * @param num - The number to round
+ * @param decimals - Number of decimal places (default: 2)
+ * @returns Rounded number
+ * @example
+ * roundToDecimals(3.14159, 2) // 3.14
+ * roundToDecimals(123.456, 0) // 123
+ */
+export function roundToDecimals(num, decimals = 2) {
+    const factor = Math.pow(10, decimals);
+    return Math.round(num * factor) / factor;
+}
+/**
+ * Clamp a number between min and max values
+ * @param num - The number to clamp
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns Clamped number
+ * @example
+ * clampNumber(150, 0, 100) // 100
+ * clampNumber(-10, 0, 100) // 0
+ * clampNumber(50, 0, 100) // 50
+ */
+export function clampNumber(num, min, max) {
+    return Math.min(Math.max(num, min), max);
+}

package/dist/validation.d.ts

@@ -202,4 +202,48 @@ export declare function hasMinimumSelection<T>(items: T[], minItems?: number): b
  * @returns true if value is selected, false otherwise
  */
 export declare function isSelected(value: unknown): boolean;
+/**
+ * Validates that percentage values sum to a target value (default 100)
+ * @param values - Array of percentage values
+ * @param target - Target sum value (default: 100)
+ * @param tolerance - Allowed tolerance for floating point differences (default: 0.01)
+ * @returns true if sum equals target within tolerance, false otherwise
+ * @example
+ * validatePercentageSum([25, 25, 50]) // true (sums to 100)
+ * validatePercentageSum([33.33, 33.33, 33.34]) // true (within tolerance)
+ * validatePercentageSum([50, 30, 15]) // false (sums to 95)
+ */
+export declare function validatePercentageSum(values: number[], target?: number, tolerance?: number): boolean;
+/**
+ * Validates that allocation objects with percentage properties sum to 100%
+ * @param allocations - Array of objects with percentage property
+ * @param percentageField - Name of the percentage field (default: 'percentage')
+ * @param tolerance - Allowed tolerance for floating point differences (default: 0.01)
+ * @returns true if sum equals 100 within tolerance, false otherwise
+ * @example
+ * validateAllocationSum([{percentage: 50}, {percentage: 50}]) // true
+ * validateAllocationSum([{percentage: '33.33'}, {percentage: '66.67'}]) // true
+ */
+export declare function validateAllocationSum<T extends Record<string, unknown>>(allocations: T[], percentageField?: keyof T, tolerance?: number): boolean;
+/**
+ * Validates that a number is within a specified range (inclusive)
+ * @param value - The number to validate
+ * @param min - Minimum allowed value
+ * @param max - Maximum allowed value
+ * @returns true if number is within range, false otherwise
+ * @example
+ * isInNumberRange(50, 0, 100) // true
+ * isInNumberRange(150, 0, 100) // false
+ */
+export declare function isInNumberRange(value: number, min: number, max: number): boolean;
+/**
+ * Validates that a percentage is between 0 and 100
+ * @param percentage - The percentage to validate
+ * @returns true if valid percentage, false otherwise
+ * @example
+ * isValidPercentage(50) // true
+ * isValidPercentage(150) // false
+ * isValidPercentage(-10) // false
+ */
+export declare function isValidPercentage(percentage: number): boolean;
 //# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

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

package/dist/validation.js

@@ -273,3 +273,65 @@ export function hasMinimumSelection(items, minItems = 1) {
 export function isSelected(value) {
     return value !== null && value !== undefined && value !== '';
 }
+// ENHANCED VALIDATION UTILITIES (Phase 14)
+/**
+ * Validates that percentage values sum to a target value (default 100)
+ * @param values - Array of percentage values
+ * @param target - Target sum value (default: 100)
+ * @param tolerance - Allowed tolerance for floating point differences (default: 0.01)
+ * @returns true if sum equals target within tolerance, false otherwise
+ * @example
+ * validatePercentageSum([25, 25, 50]) // true (sums to 100)
+ * validatePercentageSum([33.33, 33.33, 33.34]) // true (within tolerance)
+ * validatePercentageSum([50, 30, 15]) // false (sums to 95)
+ */
+export function validatePercentageSum(values, target = 100, tolerance = 0.01) {
+    if (!Array.isArray(values) || values.length === 0)
+        return false;
+    const sum = values.reduce((total, value) => total + (value || 0), 0);
+    return Math.abs(sum - target) <= tolerance;
+}
+/**
+ * Validates that allocation objects with percentage properties sum to 100%
+ * @param allocations - Array of objects with percentage property
+ * @param percentageField - Name of the percentage field (default: 'percentage')
+ * @param tolerance - Allowed tolerance for floating point differences (default: 0.01)
+ * @returns true if sum equals 100 within tolerance, false otherwise
+ * @example
+ * validateAllocationSum([{percentage: 50}, {percentage: 50}]) // true
+ * validateAllocationSum([{percentage: '33.33'}, {percentage: '66.67'}]) // true
+ */
+export function validateAllocationSum(allocations, percentageField = 'percentage', tolerance = 0.01) {
+    if (!Array.isArray(allocations) || allocations.length === 0)
+        return false;
+    const values = allocations.map(allocation => {
+        const value = allocation[percentageField];
+        return typeof value === 'string' ? parseFloat(value) || 0 : Number(value) || 0;
+    });
+    return validatePercentageSum(values, 100, tolerance);
+}
+/**
+ * Validates that a number is within a specified range (inclusive)
+ * @param value - The number to validate
+ * @param min - Minimum allowed value
+ * @param max - Maximum allowed value
+ * @returns true if number is within range, false otherwise
+ * @example
+ * isInNumberRange(50, 0, 100) // true
+ * isInNumberRange(150, 0, 100) // false
+ */
+export function isInNumberRange(value, min, max) {
+    return typeof value === 'number' && !isNaN(value) && value >= min && value <= max;
+}
+/**
+ * Validates that a percentage is between 0 and 100
+ * @param percentage - The percentage to validate
+ * @returns true if valid percentage, false otherwise
+ * @example
+ * isValidPercentage(50) // true
+ * isValidPercentage(150) // false
+ * isValidPercentage(-10) // false
+ */
+export function isValidPercentage(percentage) {
+    return isInNumberRange(percentage, 0, 100);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cranberry-money/shared-utils",
-  "version": "4.11.0",
+  "version": "4.13.0",
   "description": "Shared utility functions for MyPortfolio platform",
   "type": "module",
   "main": "dist/index.js",