@@ -351,12 +351,48 @@ export class ResponsiveTable {
351351 }
352352}
353353
354+ let _humanReadable = false ;
355+
356+ /**
357+ * Enables or disables human-readable number formatting (K/M/B suffixes)
358+ * @param human - Whether to use human-readable format
359+ */
360+ export function setHumanReadableNumbers ( human : boolean ) : void {
361+ _humanReadable = human ;
362+ }
363+
364+ /**
365+ * Formats a number with human-readable suffixes (K, M, B)
366+ * Numbers below 1000 are displayed as-is with locale formatting
367+ * @param num - The number to format
368+ * @returns Formatted string with suffix (e.g., "1.23M", "456K")
369+ */
370+ export function formatNumberHuman ( num : number ) : string {
371+ const absNum = Math . abs ( num ) ;
372+ const sign = num < 0 ? '-' : '' ;
373+
374+ if ( absNum >= 1_000_000_000 ) {
375+ return `${ sign } ${ ( absNum / 1_000_000_000 ) . toFixed ( 2 ) } B` ;
376+ }
377+ if ( absNum >= 1_000_000 ) {
378+ return `${ sign } ${ ( absNum / 1_000_000 ) . toFixed ( 2 ) } M` ;
379+ }
380+ if ( absNum >= 1_000 ) {
381+ return `${ sign } ${ ( absNum / 1_000 ) . toFixed ( 2 ) } K` ;
382+ }
383+ return num . toLocaleString ( 'en-US' ) ;
384+ }
385+
354386/**
355387 * Formats a number with locale-specific thousand separators
388+ * When human-readable mode is enabled, uses K/M/B suffixes instead
356389 * @param num - The number to format
357- * @returns Formatted number string with commas as thousand separators
390+ * @returns Formatted number string
358391 */
359392export function formatNumber ( num : number ) : string {
393+ if ( _humanReadable ) {
394+ return formatNumberHuman ( num ) ;
395+ }
360396 return num . toLocaleString ( 'en-US' ) ;
361397}
362398
@@ -984,6 +1020,58 @@ if (import.meta.vitest != null) {
9841020 } ) ;
9851021 } ) ;
9861022
1023+ describe ( 'formatNumberHuman' , ( ) => {
1024+ it ( 'formats billions' , ( ) => {
1025+ expect ( formatNumberHuman ( 1_000_000_000 ) ) . toBe ( '1.00B' ) ;
1026+ expect ( formatNumberHuman ( 2_500_000_000 ) ) . toBe ( '2.50B' ) ;
1027+ expect ( formatNumberHuman ( 1_234_567_890 ) ) . toBe ( '1.23B' ) ;
1028+ } ) ;
1029+
1030+ it ( 'formats millions' , ( ) => {
1031+ expect ( formatNumberHuman ( 1_000_000 ) ) . toBe ( '1.00M' ) ;
1032+ expect ( formatNumberHuman ( 1_500_000 ) ) . toBe ( '1.50M' ) ;
1033+ expect ( formatNumberHuman ( 12_345_678 ) ) . toBe ( '12.35M' ) ;
1034+ } ) ;
1035+
1036+ it ( 'formats thousands' , ( ) => {
1037+ expect ( formatNumberHuman ( 1_000 ) ) . toBe ( '1.00K' ) ;
1038+ expect ( formatNumberHuman ( 1_500 ) ) . toBe ( '1.50K' ) ;
1039+ expect ( formatNumberHuman ( 999_999 ) ) . toBe ( '1000.00K' ) ;
1040+ } ) ;
1041+
1042+ it ( 'keeps numbers below 1000 as-is' , ( ) => {
1043+ expect ( formatNumberHuman ( 0 ) ) . toBe ( '0' ) ;
1044+ expect ( formatNumberHuman ( 1 ) ) . toBe ( '1' ) ;
1045+ expect ( formatNumberHuman ( 999 ) ) . toBe ( '999' ) ;
1046+ expect ( formatNumberHuman ( 500 ) ) . toBe ( '500' ) ;
1047+ } ) ;
1048+
1049+ it ( 'handles negative numbers' , ( ) => {
1050+ expect ( formatNumberHuman ( - 1_500_000 ) ) . toBe ( '-1.50M' ) ;
1051+ expect ( formatNumberHuman ( - 2_500 ) ) . toBe ( '-2.50K' ) ;
1052+ expect ( formatNumberHuman ( - 500 ) ) . toBe ( '-500' ) ;
1053+ } ) ;
1054+ } ) ;
1055+
1056+ describe ( 'setHumanReadableNumbers' , ( ) => {
1057+ afterEach ( ( ) => {
1058+ setHumanReadableNumbers ( false ) ;
1059+ } ) ;
1060+
1061+ it ( 'formatNumber uses human-readable format when enabled' , ( ) => {
1062+ setHumanReadableNumbers ( true ) ;
1063+ expect ( formatNumber ( 1_500_000 ) ) . toBe ( '1.50M' ) ;
1064+ expect ( formatNumber ( 2_500 ) ) . toBe ( '2.50K' ) ;
1065+ expect ( formatNumber ( 500 ) ) . toBe ( '500' ) ;
1066+ } ) ;
1067+
1068+ it ( 'formatNumber uses default format when disabled' , ( ) => {
1069+ setHumanReadableNumbers ( false ) ;
1070+ expect ( formatNumber ( 1_500_000 ) ) . toBe ( '1,500,000' ) ;
1071+ expect ( formatNumber ( 2_500 ) ) . toBe ( '2,500' ) ;
1072+ } ) ;
1073+ } ) ;
1074+
9871075 describe ( 'formatCurrency' , ( ) => {
9881076 it ( 'formats positive amounts' , ( ) => {
9891077 expect ( formatCurrency ( 10 ) ) . toBe ( '$10.00' ) ;
0 commit comments