SliceAnsiOptions

interface SliceAnsiOptions

• ambiguousIsNarrow?: boolean

  Count characters with East Asian Width "Ambiguous" as 1 column (narrow) instead of 2 (wide). Affects Greek, Cyrillic, some symbols, etc. that render wide in CJK-encoded terminals but narrow in Western ones.

  Matches the option of the same name in stringWidth and wrapAnsi.

• ellipsis?: string

  If set, and content was cut at either edge of the requested range, insert this string at the cut edge(s). The ellipsis is counted against the visible-width budget and is emitted inside any active SGR styles (color, bold, etc.) so it inherits them, but outside any active OSC 8 hyperlink.

  This turns sliceAnsi into a drop-in cli-truncate replacement:

  • truncate-end: sliceAnsi(str, 0, max, { ellipsis: "\u2026" })
  • truncate-start: sliceAnsi(str, -max, undefined, { ellipsis: "\u2026" })