lpm install @lpm.dev/neo.string-width

import stringWidth from "@lpm.dev/neo.string-width";

// ASCII text
stringWidth("hello"); // => 5

// CJK characters (fullwidth)
stringWidth("你好"); // => 4 (2 chars × 2 width)

// Emoji
stringWidth("👍"); // => 2

// ANSI colored text (codes are stripped)
stringWidth("\x1b[31mRed\x1b[0m"); // => 3

// Mixed content
stringWidth("Hello 你好 👍"); // => 11

import stringWidth from "@lpm.dev/neo.string-width";

stringWidth("hello"); // => 5
stringWidth("你好世界"); // => 8
stringWidth("👍👎"); // => 4

import { truncateToWidth } from "@lpm.dev/neo.string-width";

// End truncation (default)
truncateToWidth("Hello World", 8);
// => 'Hello W…'

// Start truncation
truncateToWidth("Hello World", 8, { position: "start" });
// => '…o World'

// Middle truncation
truncateToWidth("Hello World", 8, { position: "middle" });
// => 'Hel…orld'

// Custom ellipsis
truncateToWidth("Hello World", 8, { ellipsis: "..." });
// => 'Hello...'

// Word boundary preference
truncateToWidth("Hello World Test", 10, { wordBoundary: true });
// => 'Hello…'

import { padToWidth } from "@lpm.dev/neo.string-width";

// Right padding (default)
padToWidth("Hello", 10);
// => 'Hello     '

// Left padding
padToWidth("Hello", 10, { align: "right" });
// => '     Hello'

// Center padding
padToWidth("Hello", 10, { align: "center" });
// => '  Hello   '

// Custom pad character
padToWidth("Hello", 10, { padChar: "." });
// => 'Hello.....'

// Works with CJK
padToWidth("你好", 10);
// => '你好      '

import { sliceByWidth } from "@lpm.dev/neo.string-width";

// Basic slicing
sliceByWidth("Hello World", 0, 5);
// => 'Hello'

// Negative indices
sliceByWidth("Hello World", -5);
// => 'World'

// Works with CJK (width-based, not character-based)
sliceByWidth("你好世界", 0, 4);
// => '你好' (2 chars, width 4)

// Mixed content
sliceByWidth("Hello 你好", 0, 7);
// => 'Hello 你'

import { splitByWidth } from "@lpm.dev/neo.string-width";

// Basic splitting
splitByWidth("Hello World", 5);
// => ['Hello', 'World']

// CJK text
splitByWidth("你好世界测试", 8);
// => ['你好世界', '测试']

// Word boundary preference
splitByWidth("Hello World Test", 10, { preferSplitOnSpace: true });
// => ['Hello', 'World Test']

// Preserve whitespace
splitByWidth("  Hello  ", 10, { preserveWhitespace: true });
// => ['  Hello  ']

@lpm.dev/neo.string-width: 13.70 KB (ESM)
string-width + dependencies: ~17 KB

Savings: ~20% smaller

// Import everything (13.70 KB)
import stringWidth, {
  truncateToWidth,
  padToWidth,
} from "@lpm.dev/neo.string-width";

// Import only stringWidth (~8 KB)
import stringWidth from "@lpm.dev/neo.string-width";

// Import only helpers you need
import { truncateToWidth } from "@lpm.dev/neo.string-width";

import stringWidth, {
  type StringWidthOptions,
  type TruncateOptions,
  type PadOptions,
  type SliceOptions,
  type SplitOptions,
} from "@lpm.dev/neo.string-width";

// Type-safe options
const options: StringWidthOptions = {
  ambiguousIsNarrow: false,
  emojiWidth: 1,
};

stringWidth("text", options); // number

import { padToWidth, truncateToWidth } from "@lpm.dev/neo.string-width";

function formatTableRow(name: string, value: string) {
  const nameCol = padToWidth(truncateToWidth(name, 20), 20);
  const valueCol = padToWidth(value, 30, { align: "right" });
  return `│ ${nameCol} │ ${valueCol} │`;
}

formatTableRow("User Name", "你好世界");
// => '│ User Name            │                      你好世界 │'

import { padToWidth } from "@lpm.dev/neo.string-width";

function progressBar(percent: number, width: number = 40) {
  const filled = Math.floor((width * percent) / 100);
  const bar = "█".repeat(filled) + "░".repeat(width - filled);
  return `[${bar}] ${percent}%`;
}

progressBar(75, 20);
// => '[███████████████░░░░] 75%'

import { splitByWidth } from "@lpm.dev/neo.string-width";

function wrapText(text: string, maxWidth: number): string[] {
  return splitByWidth(text, maxWidth, { preferSplitOnSpace: true });
}

wrapText("这是一段很长的中文文本需要被分割", 20);
// => ['这是一段很长的中文文', '本需要被分割']

import { truncateToWidth } from "@lpm.dev/neo.string-width";

function truncatePath(path: string, maxWidth: number) {
  return truncateToWidth(path, maxWidth, { position: "middle" });
}

truncatePath("/very/long/path/to/some/file.txt", 25);
// => '/very/long/…some/file.txt'

// Before
import stringWidth from "string-width";
const width = stringWidth("text");

// After
import stringWidth from "@lpm.dev/neo.string-width";
const width = stringWidth("text"); // Same API!

npm test              # Run all tests
npm run test:coverage # Coverage report (99.55%)
npm run bench         # Performance benchmarks