es-toolkit 1.17.0-dev.511 → 1.17.0-dev.514

package/dist/compat/index.d.mts

@@ -101,6 +101,7 @@ export { pascalCase } from '../string/pascalCase.mjs';
 export { upperFirst } from '../string/upperFirst.mjs';
 export { lowerFirst } from '../string/lowerFirst.mjs';
 export { deburr } from '../string/deburr.mjs';
+export { pad } from '../string/pad.mjs';
 export { chunk } from './array/chunk.mjs';
 export { concat } from './array/concat.mjs';
 export { difference } from './array/difference.mjs';

package/dist/compat/index.d.ts

@@ -101,6 +101,7 @@ export { pascalCase } from '../string/pascalCase.js';
 export { upperFirst } from '../string/upperFirst.js';
 export { lowerFirst } from '../string/lowerFirst.js';
 export { deburr } from '../string/deburr.js';
+export { pad } from '../string/pad.js';
 export { chunk } from './array/chunk.js';
 export { concat } from './array/concat.js';
 export { difference } from './array/difference.js';

package/dist/compat/index.js

@@ -933,6 +933,7 @@ exports.deburr = string_index.deburr;
 exports.kebabCase = string_index.kebabCase;
 exports.lowerCase = string_index.lowerCase;
 exports.lowerFirst = string_index.lowerFirst;
+exports.pad = string_index.pad;
 exports.pascalCase = string_index.pascalCase;
 exports.snakeCase = string_index.snakeCase;
 exports.startCase = string_index.startCase;

package/dist/compat/index.mjs

@@ -102,6 +102,7 @@ export { pascalCase } from '../string/pascalCase.mjs';
 export { upperFirst } from '../string/upperFirst.mjs';
 export { lowerFirst } from '../string/lowerFirst.mjs';
 export { deburr } from '../string/deburr.mjs';
+export { pad } from '../string/pad.mjs';
 export { chunk } from './array/chunk.mjs';
 export { concat } from './array/concat.mjs';
 export { difference } from './array/difference.mjs';

package/dist/index.d.mts

@@ -120,3 +120,4 @@ export { pascalCase } from './string/pascalCase.mjs';
 export { upperFirst } from './string/upperFirst.mjs';
 export { lowerFirst } from './string/lowerFirst.mjs';
 export { deburr } from './string/deburr.mjs';
+export { pad } from './string/pad.mjs';

package/dist/index.d.ts

@@ -120,3 +120,4 @@ export { pascalCase } from './string/pascalCase.js';
 export { upperFirst } from './string/upperFirst.js';
 export { lowerFirst } from './string/lowerFirst.js';
 export { deburr } from './string/deburr.js';
+export { pad } from './string/pad.js';

package/dist/index.js

@@ -136,6 +136,7 @@ exports.deburr = string_index.deburr;
 exports.kebabCase = string_index.kebabCase;
 exports.lowerCase = string_index.lowerCase;
 exports.lowerFirst = string_index.lowerFirst;
+exports.pad = string_index.pad;
 exports.pascalCase = string_index.pascalCase;
 exports.snakeCase = string_index.snakeCase;
 exports.startCase = string_index.startCase;

package/dist/index.mjs

@@ -120,3 +120,4 @@ export { pascalCase } from './string/pascalCase.mjs';
 export { upperFirst } from './string/upperFirst.mjs';
 export { lowerFirst } from './string/lowerFirst.mjs';
 export { deburr } from './string/deburr.mjs';
+export { pad } from './string/pad.mjs';

package/dist/string/index.d.mts

@@ -8,3 +8,4 @@ export { pascalCase } from './pascalCase.mjs';
 export { upperFirst } from './upperFirst.mjs';
 export { lowerFirst } from './lowerFirst.mjs';
 export { deburr } from './deburr.mjs';
+export { pad } from './pad.mjs';

package/dist/string/index.d.ts

@@ -8,3 +8,4 @@ export { pascalCase } from './pascalCase.js';
 export { upperFirst } from './upperFirst.js';
 export { lowerFirst } from './lowerFirst.js';
 export { deburr } from './deburr.js';
+export { pad } from './pad.js';

package/dist/string/index.js

@@ -109,12 +109,17 @@ function deburr(str) {
     return result.join('');
 }
 
+const pad = (str, length = 0, chars = ' ') => {
+    return str.padStart(Math.floor((length - str.length) / 2) + str.length, chars).padEnd(length, chars);
+};
+
 exports.camelCase = camelCase;
 exports.capitalize = capitalize;
 exports.deburr = deburr;
 exports.kebabCase = kebabCase;
 exports.lowerCase = lowerCase;
 exports.lowerFirst = lowerFirst;
+exports.pad = pad;
 exports.pascalCase = pascalCase;
 exports.snakeCase = snakeCase;
 exports.startCase = startCase;

package/dist/string/index.mjs

@@ -8,3 +8,4 @@ export { pascalCase } from './pascalCase.mjs';
 export { upperFirst } from './upperFirst.mjs';
 export { lowerFirst } from './lowerFirst.mjs';
 export { deburr } from './deburr.mjs';
+export { pad } from './pad.mjs';

package/dist/string/pad.d.mts

@@ -0,0 +1,21 @@
+/**
+ * Pads string on the left and right sides if it's shorter than length. Padding characters are truncated if they can't be evenly divided by length.
+ * If the length is less than or equal to the original string's length, or if the padding character is an empty string, the original string is returned unchanged.
+ *
+ *
+ *
+ * @param {string} str - The string to pad.
+ * @param {number} [length] - The length of the resulting string once padded.
+ * @param {string} [chars] - The character(s) to use for padding.
+ * @returns {string} - The padded string, or the original string if padding is not required.
+ *
+ * @example
+ * const result1 = pad('abc', 8);         // result will be '  abc   '
+ * const result2 = pad('abc', 8, '_-');   // result will be '_-abc_-_'
+ * const result3 = pad('abc', 3);         // result will be 'abc'
+ * const result4 = pad('abc', 2);         // result will be 'abc'
+ *
+ */
+declare const pad: (str: string, length?: number, chars?: string) => string;
+
+export { pad };

package/dist/string/pad.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pads string on the left and right sides if it's shorter than length. Padding characters are truncated if they can't be evenly divided by length.
+ * If the length is less than or equal to the original string's length, or if the padding character is an empty string, the original string is returned unchanged.
+ *
+ *
+ *
+ * @param {string} str - The string to pad.
+ * @param {number} [length] - The length of the resulting string once padded.
+ * @param {string} [chars] - The character(s) to use for padding.
+ * @returns {string} - The padded string, or the original string if padding is not required.
+ *
+ * @example
+ * const result1 = pad('abc', 8);         // result will be '  abc   '
+ * const result2 = pad('abc', 8, '_-');   // result will be '_-abc_-_'
+ * const result3 = pad('abc', 3);         // result will be 'abc'
+ * const result4 = pad('abc', 2);         // result will be 'abc'
+ *
+ */
+declare const pad: (str: string, length?: number, chars?: string) => string;
+
+export { pad };

package/dist/string/pad.mjs

@@ -0,0 +1,5 @@
+const pad = (str, length = 0, chars = ' ') => {
+    return str.padStart(Math.floor((length - str.length) / 2) + str.length, chars).padEnd(length, chars);
+};
+
+export { pad };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.17.0-dev.511+3a6cb365",
+  "version": "1.17.0-dev.514+4b529e2a",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {