Repeat Pad

1/**
2 * Pads a string evenly on both sides until it reaches the desired length.
3 *
4 * @param str - The input string.
5 * @param length - Desired total length.
6 * @param pad - The character/string used as padding (default: space).
7 * @returns The padded string centered with the given padding.
8 *
9 * @example
10 * repeatPad("TS", 6, "-"); // "--TS--"
11 */
12export function repeatPad(str: string, length: number, pad = ' '): string {
13  const total = Math.max(length - str.length, 0);
14  const left = Math.floor(total / 2);
15  const right = total - left;
16  return pad.repeat(left) + str + pad.repeat(right);
17}