function getStringWidth(
    input: string,
    options?: StringWidthOptions
): number;

import { getStringWidth } from "@visulima/string/get-string-width";

// Basic ASCII
getStringWidth("hello");               // 5

// CJK characters (width 2 each)
getStringWidth("你好");                 // 4
getStringWidth("あいう");               // 6

// Emojis (width 2 each)
getStringWidth("👋");                   // 2
getStringWidth("👨‍👩‍👧‍👦");       // 2 (ZWJ family emoji)

// ANSI escape codes (ignored by default)
getStringWidth("\x1b[31mRed\x1b[39m");  // 3

// Combining characters
getStringWidth("e\u0301");              // 1 (e with combining acute accent)
getStringWidth("\u0e01\u0e31");          // 1 (Thai character with vowel mark)

// Mixed content
getStringWidth("Hello 世界");           // 9

// Custom widths
getStringWidth("hello", { regularWidth: 2 });  // 10
getStringWidth("👋👋", { emojiWidth: 1 });      // 2

type StringWidthOptions = Omit<
    StringTruncatedWidthOptions,
    "ellipsis" | "ellipsisWidth" | "limit"
>;

function getStringTruncatedWidth(
    input: string,
    options?: StringTruncatedWidthOptions
): StringTruncatedWidthResult;

import { getStringTruncatedWidth } from "@visulima/string/get-string-truncated-width";

// Basic width calculation
getStringTruncatedWidth("hello");
// { width: 5, truncated: false, ellipsed: false, index: 5 }

// With truncation limit
getStringTruncatedWidth("hello world", { limit: 8 });
// { width: 8, truncated: true, ellipsed: false, index: 8 }

// With truncation and ellipsis
getStringTruncatedWidth("hello world", {
    limit: 8,
    ellipsis: "...",
});
// { width: 8, truncated: true, ellipsed: true, index: 5 }

// CJK with truncation
getStringTruncatedWidth("あいうえお", {
    limit: 6,
    ellipsis: "...",
});
// { width: 6, truncated: true, ellipsed: true, index: ... }

// Empty string
getStringTruncatedWidth("");
// { width: 0, truncated: false, ellipsed: false, index: 0 }

interface StringTruncatedWidthOptions {
    /** Treat ambiguous width characters as narrow. @default false */
    ambiguousIsNarrow?: boolean;

    /** Width of ANSI escape sequences. @default 0 */
    ansiWidth?: number;

    /** Width of control characters. @default 0 */
    controlWidth?: number;

    /** Whether to count ANSI escape codes in width. @default false */
    countAnsiEscapeCodes?: boolean;

    /** Text appended to the string when it is truncated. @default '' */
    ellipsis?: string;

    /** Width of the ellipsis string. Auto-calculated if not provided. */
    ellipsisWidth?: number;

    /** Width of emoji characters. @default 2 */
    emojiWidth?: number;

    /** Width of full-width characters. @default 2 */
    fullWidth?: number;

    /** Width of half-width characters. @default 1 */
    halfWidth?: number;

    /** Maximum width limit for the string. @default Infinity */
    limit?: number;

    /** Width of regular characters. @default 1 */
    regularWidth?: number;

    /** Width of tab characters. @default 8 */
    tabWidth?: number;

    /** Width of wide characters. @default 2 */
    wideWidth?: number;
}

interface StringTruncatedWidthResult {
    /** The calculated visual width of the string. */
    width: number;

    /** Whether the string was truncated. */
    truncated: boolean;

    /** Whether an ellipsis was added. */
    ellipsed: boolean;

    /** The index at which truncation occurred, or the full string length if not truncated. */
    index: number;
}