smartwrap

Textwrap for JavaScript/Node.js, written in TypeScript.
Correctly handles wide characters (宽字符) and emojis (😃).
Optionally break words when wrapping strings. Preserves ANSI escape codes.

Ships compiled CommonJS + declaration files (.d.ts).

Installation

npm install smartwrap

CLI (global):

npm install -g smartwrap

Usage

// ESM
import smartwrap from 'smartwrap'
// or: import { smartwrap } from 'smartwrap'

// CommonJS
const smartwrap = require('smartwrap')

console.log(smartwrap('宽字符', { width: 2 }))
// 宽
// 字
// 符

console.log(smartwrap('break at word', { width: 10 }))
// break at
// word

console.log(smartwrap('break at word', { width: 10, breakword: true }))
// break at w
// ord

Options (SmartwrapOptions)

| Option | Type | Default | Description | |----------------|----------|-------------|-------------| | width | number | 10 | Target line width in terminal columns | | breakword | boolean | false | Break words that exceed remaining space | | minWidth | 1 | 2 | 2 | Minimum usable width (use 1 only if no wide chars) | | paddingLeft | number | 0 | Spaces prepended to each line | | paddingRight | number | 0 | Spaces appended to each line | | splitAt | string[] | [" ","\t"]| Characters that split words | | trim | boolean | true | Trim leading/trailing whitespace from input | | errorChar | string | "�" | Replacement when a single wide char cannot fit |

CLI

echo "somestring you want to wrap" | smartwrap --width=3 --paddingLeft=1
smartwrap --help

Development

npm install
npm run build   # tsc → dist/
npm test

Source is pure TypeScript under src/. Published artifacts live in dist/.

Breaking changes in 3.0.0

• Node.js ≥ 22 required (matches [email protected]).
• Display width is now measured by breakword.width() instead of wcwidth: a generated Unicode 18.0.0 East Asian Width table plus UAX #51 Emoji_Presentation, no dependencies of its own. Output changes where the two disagree — code points wcwidth 1.x scored 1 cell but measure 2 (e.g. ⚡ U+26A1) now wrap wider.
• Source rewritten in TypeScript; main / types point at dist/.
• Removed unused grapheme-splitter and the array.prototype.flat polyfill.
• See prior changelog notes on the modernize release for dependency cleanup details.

License

MIT