@cranberry-money/shared-utils 4.12.0 → 4.14.0

package/dist/filters.d.ts

@@ -62,4 +62,60 @@ export declare function areFiltersEqual<T extends Record<string, unknown>>(filte
  * @returns A predicate function that tests if an item matches the filters
  */
 export declare function createFilterPredicate<T extends Record<string, unknown>, U extends Record<string, unknown>>(filters: T): (item: U) => boolean;
+/**
+ * Check if any instrument filters are active (excluding searchQuery)
+ * Common pattern for instrument filter checking across applications
+ * @param filters - The instrument filter object to check
+ * @returns true if any non-search filters are active
+ */
+export declare function hasActiveInstrumentFilters<T extends Record<string, unknown>>(filters: T): boolean;
+/**
+ * Count active instrument filters (excluding searchQuery)
+ * Common pattern for instrument filter counting across applications
+ * @param filters - The instrument filter object to count
+ * @returns number of active non-search filters
+ */
+export declare function countActiveInstrumentFilters<T extends Record<string, unknown>>(filters: T): number;
+/**
+ * Check if any trade filters are active (excluding searchQuery)
+ * Common pattern for trade filter checking across applications
+ * @param filters - The trade filter object to check
+ * @returns true if any non-search filters are active
+ */
+export declare function hasActiveTradeFilters<T extends Record<string, unknown>>(filters: T): boolean;
+/**
+ * Count active trade filters (excluding searchQuery)
+ * Common pattern for trade filter counting across applications
+ * @param filters - The trade filter object to count
+ * @returns number of active non-search filters
+ */
+export declare function countActiveTradeFilters<T extends Record<string, unknown>>(filters: T): number;
+/**
+ * Check if any transaction filters are active (excluding searchQuery)
+ * Common pattern for transaction filter checking across applications
+ * @param filters - The transaction filter object to check
+ * @returns true if any non-search filters are active
+ */
+export declare function hasActiveTransactionFilters<T extends Record<string, unknown>>(filters: T): boolean;
+/**
+ * Count active transaction filters (excluding searchQuery)
+ * Common pattern for transaction filter counting across applications
+ * @param filters - The transaction filter object to count
+ * @returns number of active non-search filters
+ */
+export declare function countActiveTransactionFilters<T extends Record<string, unknown>>(filters: T): number;
+/**
+ * Check if any target trade filters are active (excluding searchQuery)
+ * Common pattern for target trade filter checking across applications
+ * @param filters - The target trade filter object to check
+ * @returns true if any non-search filters are active
+ */
+export declare function hasActiveTargetTradeFilters<T extends Record<string, unknown>>(filters: T): boolean;
+/**
+ * Count active target trade filters (excluding searchQuery)
+ * Common pattern for target trade filter counting across applications
+ * @param filters - The target trade filter object to count
+ * @returns number of active non-search filters
+ */
+export declare function countActiveTargetTradeFilters<T extends Record<string, unknown>>(filters: T): number;
 //# sourceMappingURL=filters.d.ts.map

package/dist/filters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../src/filters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,OAAO,EAAE,CAAC,EACV,aAAa,GAAE,CAAC,MAAM,CAAC,CAAC,EAA+B,GACtD,OAAO,CAOT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,OAAO,EAAE,CAAC,EACV,aAAa,GAAE,CAAC,MAAM,CAAC,CAAC,EAA+B,GACtD,MAAM,CAOR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,OAAO,EAAE,CAAC,EACV,cAAc,GAAE,CAAC,MAAM,CAAC,CAAC,EAAO,GAC/B,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAE1G;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQrD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAW5F;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAE9G;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAkBpG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxG,OAAO,EAAE,CAAC,GACT,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAuBtB"}
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../src/filters.ts"],"names":[],"mappings":"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"}

package/dist/filters.js

@@ -128,3 +128,79 @@ export function createFilterPredicate(filters) {
         });
     };
 }
+// ============================================================================
+// Common Filter Patterns
+// Pre-configured utilities for common filter use cases
+// ============================================================================
+/**
+ * Check if any instrument filters are active (excluding searchQuery)
+ * Common pattern for instrument filter checking across applications
+ * @param filters - The instrument filter object to check
+ * @returns true if any non-search filters are active
+ */
+export function hasActiveInstrumentFilters(filters) {
+    return hasActiveFilters(filters, ['searchQuery']);
+}
+/**
+ * Count active instrument filters (excluding searchQuery)
+ * Common pattern for instrument filter counting across applications
+ * @param filters - The instrument filter object to count
+ * @returns number of active non-search filters
+ */
+export function countActiveInstrumentFilters(filters) {
+    return countActiveFilters(filters, ['searchQuery']);
+}
+/**
+ * Check if any trade filters are active (excluding searchQuery)
+ * Common pattern for trade filter checking across applications
+ * @param filters - The trade filter object to check
+ * @returns true if any non-search filters are active
+ */
+export function hasActiveTradeFilters(filters) {
+    return hasActiveFilters(filters, ['searchQuery']);
+}
+/**
+ * Count active trade filters (excluding searchQuery)
+ * Common pattern for trade filter counting across applications
+ * @param filters - The trade filter object to count
+ * @returns number of active non-search filters
+ */
+export function countActiveTradeFilters(filters) {
+    return countActiveFilters(filters, ['searchQuery']);
+}
+/**
+ * Check if any transaction filters are active (excluding searchQuery)
+ * Common pattern for transaction filter checking across applications
+ * @param filters - The transaction filter object to check
+ * @returns true if any non-search filters are active
+ */
+export function hasActiveTransactionFilters(filters) {
+    return hasActiveFilters(filters, ['searchQuery']);
+}
+/**
+ * Count active transaction filters (excluding searchQuery)
+ * Common pattern for transaction filter counting across applications
+ * @param filters - The transaction filter object to count
+ * @returns number of active non-search filters
+ */
+export function countActiveTransactionFilters(filters) {
+    return countActiveFilters(filters, ['searchQuery']);
+}
+/**
+ * Check if any target trade filters are active (excluding searchQuery)
+ * Common pattern for target trade filter checking across applications
+ * @param filters - The target trade filter object to check
+ * @returns true if any non-search filters are active
+ */
+export function hasActiveTargetTradeFilters(filters) {
+    return hasActiveFilters(filters, ['searchQuery']);
+}
+/**
+ * Count active target trade filters (excluding searchQuery)
+ * Common pattern for target trade filter counting across applications
+ * @param filters - The target trade filter object to count
+ * @returns number of active non-search filters
+ */
+export function countActiveTargetTradeFilters(filters) {
+    return countActiveFilters(filters, ['searchQuery']);
+}

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,12 +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 { hasActiveFilters, countActiveFilters, clearAllFilters, updateFilters, isFilterEmpty, removeEmptyFilters, mergeFilters, areFiltersEqual, createFilterPredicate, } from './filters';
+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, hasActiveInstrumentFilters, countActiveInstrumentFilters, hasActiveTradeFilters, countActiveTradeFilters, hasActiveTransactionFilters, countActiveTransactionFilters, hasActiveTargetTradeFilters, countActiveTargetTradeFilters, } 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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -15,12 +15,20 @@ 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 { hasActiveFilters, countActiveFilters, clearAllFilters, updateFilters, isFilterEmpty, removeEmptyFilters, mergeFilters, areFiltersEqual, createFilterPredicate, 
+// Common filter patterns
+hasActiveInstrumentFilters, countActiveInstrumentFilters, hasActiveTradeFilters, countActiveTradeFilters, hasActiveTransactionFilters, countActiveTransactionFilters, hasActiveTargetTradeFilters, countActiveTargetTradeFilters, } 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.12.0",
+  "version": "4.14.0",
   "description": "Shared utility functions for MyPortfolio platform",
   "type": "module",
   "main": "dist/index.js",