index.d.ts
1 /** 2 * Wrap words to a specified length. 3 */ 4 export = wrap; 5 6 declare function wrap(str: string, options?: wrap.IOptions): string; 7 8 declare namespace wrap { 9 export interface IOptions { 10 11 /** 12 * The width of the text before wrapping to a new line. 13 * @default ´50´ 14 */ 15 width?: number; 16 17 /** 18 * The string to use at the beginning of each line. 19 * @default ´ ´ (two spaces) 20 */ 21 indent?: string; 22 23 /** 24 * The string to use at the end of each line. 25 * @default ´\n´ 26 */ 27 newline?: string; 28 29 /** 30 * An escape function to run on each line after splitting them. 31 * @default (str: string) => string; 32 */ 33 escape?: (str: string) => string; 34 35 /** 36 * Trim trailing whitespace from the returned string. 37 * This option is included since .trim() would also strip 38 * the leading indentation from the first line. 39 * @default true 40 */ 41 trim?: boolean; 42 43 /** 44 * Break a word between any two letters when the word is longer 45 * than the specified width. 46 * @default false 47 */ 48 cut?: boolean; 49 } 50 }