shared/lib/string-format.ts - dev - githubmirror/tabler

shared/lib/string-format.ts
65 строк2 KB
Paweł Kuna
Narrow component prop types, remove unused props and dead code (#2838)
10 авг 2026, 00:14
10 авг 2026, 00:144f7beec
// String/number formatting helpers used by the demo data across components.

/** Uppercases the first char, lowercases the rest. */
export function capitalize(s: string): string {
  return s.charAt(0).toUpperCase() + s.slice(1).toLowerCase()
}

/** Uppercases only the first char, leaves the rest untouched. */
export function ucFirst(s: string): string {
  return s.charAt(0).toUpperCase() + s.slice(1)
}

/** Takes the first letter of each space-separated word (e.g. avatar initials). */
export function firstLetters(s: string): string {
  return (s || '')
    .split(' ')
    .map((w) => w.charAt(0))
    .join('')
}

/** Adds thousands separators to a number. */
export function formatNumber(value: number): string {
  return value.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',')
}

/** Lowercases a single-word string for use as an anchor slug. */
export function slugifyWord(text: string): string {
  return text.toLowerCase()
}

/** Strips slashes and joins segments: "/ui/getting-started/" -> "uigetting-started". */
export function pathSlug(u: string): string {
  return u.split('/').filter(Boolean).join('')
}

/** Strips a trailing "%" from a value, defaulting to "0" when empty/undefined. */
export function parsePercentage(value: number | string | undefined): string {
  return `${value ?? ''}`.split('%').join('') || '0'
}

/** Formats a millisecond duration as "M:SS". */
export function millisecondsToMinutes(value: number): string {
  const minutes = Math.floor(value / 60000)
  const seconds = ((value % 60000) / 1000).toFixed(0)
  return `${minutes}:${Number(seconds) < 10 ? '0' : ''}${seconds}`
}

/** Parses a "$1,234.56"-style currency string into a plain number. */
export function parseCurrency(s: string): number {
  return parseFloat(s.replace(/[$,]/g, ''))
}

/** Rounds to the given number of decimal digits, dropping trailing zeros. */
export function roundTo(x: number, digits = 8): number {
  return parseFloat(x.toFixed(digits))
}

/** Sorts items by a case-sensitive string key, without mutating the input array. */
export function sortBy<T>(items: T[], key: (item: T) => string): T[] {
  return [...items].sort((a, b) => {
    const l = key(a)
    const r = key(b)
    return l < r ? -1 : l > r ? 1 : 0
  })
}