@tienedev/datype/dist/types/capitalize/index.d.ts

Modern TypeScript utility library with pragmatic typing and zero dependencies

/**
 * Capitalizes the first character of a string and converts the rest to lowercase.
 *
 * @param str - The string to capitalize
 * @returns A new string with the first character capitalized and the rest lowercase
 *
 * @example
 * ```typescript
 * import { capitalize } from 'datype';
 *
 * // Basic usage
 * capitalize('hello'); // 'Hello'
 * capitalize('WORLD'); // 'World'
 * capitalize('hELLO wORLD'); // 'Hello world'
 *
 * // Edge cases
 * capitalize(''); // ''
 * capitalize('a'); // 'A'
 * capitalize('123abc'); // '123abc'
 *
 * // Unicode support
 * capitalize('ñoño'); // 'Ñoño'
 * capitalize('été'); // 'Été'
 *
 * // Real-world usage
 * const names = ['john', 'JANE', 'bob'];
 * const capitalized = names.map(capitalize);
 * // ['John', 'Jane', 'Bob']
 *
 * // Form input normalization
 * const userInput = 'jOhN dOe';
 * const normalized = capitalize(userInput); // 'John doe'
 * ```
 */
export declare function capitalize(str: string): string;
//# sourceMappingURL=index.d.ts.map