@liangjie559567/ultrapower 5.5.20 → 5.5.21

package/dist/utils/__tests__/string-width.test.js

@@ -0,0 +1,173 @@
+/**
+ * Tests for CJK-aware string width utilities.
+ * Related: Issue #344 - Korean IME input visibility
+ */
+import { describe, it, expect } from "vitest";
+import { isCJKCharacter, isZeroWidth, getCharWidth, stringWidth, stripAnsi, truncateToWidth, padToWidth, sliceByWidth, } from "../string-width.js";
+describe("isCJKCharacter", () => {
+    it("detects Korean Hangul syllables", () => {
+        expect(isCJKCharacter("안".codePointAt(0))).toBe(true);
+        expect(isCJKCharacter("녕".codePointAt(0))).toBe(true);
+        expect(isCJKCharacter("하".codePointAt(0))).toBe(true);
+    });
+    it("detects CJK Unified Ideographs (Chinese)", () => {
+        expect(isCJKCharacter("中".codePointAt(0))).toBe(true);
+        expect(isCJKCharacter("文".codePointAt(0))).toBe(true);
+    });
+    it("detects Japanese Hiragana and Katakana", () => {
+        expect(isCJKCharacter("あ".codePointAt(0))).toBe(true);
+        expect(isCJKCharacter("カ".codePointAt(0))).toBe(true);
+    });
+    it("detects full-width ASCII", () => {
+        expect(isCJKCharacter("Ａ".codePointAt(0))).toBe(true);
+        expect(isCJKCharacter("１".codePointAt(0))).toBe(true);
+    });
+    it("returns false for ASCII characters", () => {
+        expect(isCJKCharacter("A".codePointAt(0))).toBe(false);
+        expect(isCJKCharacter("1".codePointAt(0))).toBe(false);
+        expect(isCJKCharacter(" ".codePointAt(0))).toBe(false);
+    });
+});
+describe("isZeroWidth", () => {
+    it("detects zero-width space", () => {
+        expect(isZeroWidth(0x200b)).toBe(true);
+    });
+    it("detects zero-width joiner", () => {
+        expect(isZeroWidth(0x200d)).toBe(true);
+    });
+    it("detects combining diacritical marks", () => {
+        expect(isZeroWidth(0x0300)).toBe(true); // Combining Grave Accent
+        expect(isZeroWidth(0x0301)).toBe(true); // Combining Acute Accent
+    });
+    it("returns false for regular characters", () => {
+        expect(isZeroWidth("a".codePointAt(0))).toBe(false);
+        expect(isZeroWidth("가".codePointAt(0))).toBe(false);
+    });
+});
+describe("getCharWidth", () => {
+    it("returns 2 for CJK characters", () => {
+        expect(getCharWidth("한")).toBe(2);
+        expect(getCharWidth("中")).toBe(2);
+    });
+    it("returns 1 for ASCII characters", () => {
+        expect(getCharWidth("A")).toBe(1);
+        expect(getCharWidth("z")).toBe(1);
+    });
+    it("returns 0 for empty string", () => {
+        expect(getCharWidth("")).toBe(0);
+    });
+});
+describe("stringWidth", () => {
+    it("calculates width of ASCII string", () => {
+        expect(stringWidth("hello")).toBe(5);
+    });
+    it("calculates width of Korean string", () => {
+        // Each Korean character is double-width
+        expect(stringWidth("안녕하세요")).toBe(10);
+    });
+    it("calculates width of mixed ASCII and CJK", () => {
+        // "hi" = 2, "안녕" = 4
+        expect(stringWidth("hi안녕")).toBe(6);
+    });
+    it("strips ANSI codes before calculating", () => {
+        expect(stringWidth("\x1b[31mhello\x1b[0m")).toBe(5);
+        expect(stringWidth("\x1b[1m안녕\x1b[0m")).toBe(4);
+    });
+    it("returns 0 for empty string", () => {
+        expect(stringWidth("")).toBe(0);
+    });
+    it("returns 0 for null/undefined", () => {
+        expect(stringWidth("")).toBe(0);
+    });
+    it("calculates width of Japanese text", () => {
+        // Each character is double-width
+        expect(stringWidth("こんにちは")).toBe(10);
+    });
+    it("calculates width of Chinese text", () => {
+        expect(stringWidth("你好世界")).toBe(8);
+    });
+});
+describe("stripAnsi", () => {
+    it("strips SGR sequences", () => {
+        expect(stripAnsi("\x1b[31mred\x1b[0m")).toBe("red");
+    });
+    it("strips bold sequences", () => {
+        expect(stripAnsi("\x1b[1mbold\x1b[0m")).toBe("bold");
+    });
+    it("strips multiple sequences", () => {
+        expect(stripAnsi("\x1b[1m\x1b[31mboldred\x1b[0m")).toBe("boldred");
+    });
+    it("returns unchanged string without ANSI", () => {
+        expect(stripAnsi("hello")).toBe("hello");
+    });
+});
+describe("truncateToWidth", () => {
+    it("returns string unchanged if within width", () => {
+        expect(truncateToWidth("hello", 10)).toBe("hello");
+    });
+    it("truncates ASCII string with ellipsis", () => {
+        expect(truncateToWidth("hello world", 8)).toBe("hello...");
+    });
+    it("truncates Korean string correctly", () => {
+        // "안녕하세요" = 10 columns
+        // With maxWidth=6, suffix "..." = 3 cols, target = 3 cols = 1 Korean char (2) + overflow
+        const result = truncateToWidth("안녕하세요", 7);
+        // "안녕" = 4 cols, "..." = 3 cols = total 7
+        expect(result).toBe("안녕...");
+    });
+    it("truncates mixed CJK/ASCII correctly", () => {
+        // "hi안녕하세요" = 2 + 10 = 12 columns
+        const result = truncateToWidth("hi안녕하세요", 9);
+        // "hi안녕" = 6 cols, "..." = 3 cols = total 9
+        expect(result).toBe("hi안녕...");
+    });
+    it("handles maxWidth of 0", () => {
+        expect(truncateToWidth("hello", 0)).toBe("");
+    });
+    it("handles empty string", () => {
+        expect(truncateToWidth("", 10)).toBe("");
+    });
+    it("handles string exactly at width", () => {
+        expect(truncateToWidth("hello", 5)).toBe("hello");
+    });
+    it("uses custom suffix", () => {
+        expect(truncateToWidth("hello world", 8, "…")).toBe("hello w…");
+    });
+    it("does not break CJK characters", () => {
+        // "안녕" = 4 columns. With maxWidth=5, "..." = 3, target = 2 = 1 Korean char
+        const result = truncateToWidth("안녕하세요", 5);
+        expect(result).toBe("안...");
+    });
+});
+describe("padToWidth", () => {
+    it("pads ASCII string to width", () => {
+        expect(padToWidth("hi", 5)).toBe("hi   ");
+    });
+    it("pads CJK string correctly", () => {
+        // "안녕" = 4 columns, pad to 6 = 2 spaces
+        expect(padToWidth("안녕", 6)).toBe("안녕  ");
+    });
+    it("does not pad if already at width", () => {
+        expect(padToWidth("hello", 5)).toBe("hello");
+    });
+    it("does not pad if exceeding width", () => {
+        expect(padToWidth("hello world", 5)).toBe("hello world");
+    });
+});
+describe("sliceByWidth", () => {
+    it("slices ASCII string by width", () => {
+        expect(sliceByWidth("hello", 0, 3)).toBe("hel");
+    });
+    it("slices CJK string by width", () => {
+        // "안녕하" = 6 columns, slice 0-4 = "안녕"
+        expect(sliceByWidth("안녕하", 0, 4)).toBe("안녕");
+    });
+    it("does not split CJK character", () => {
+        // "안녕" = 4 columns. Slicing to width 3 should only include "안" (2 cols)
+        expect(sliceByWidth("안녕", 0, 3)).toBe("안");
+    });
+    it("handles empty string", () => {
+        expect(sliceByWidth("", 0, 5)).toBe("");
+    });
+});
+//# sourceMappingURL=string-width.test.js.map

package/dist/utils/__tests__/string-width.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-width.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/string-width.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,cAAc,EACd,WAAW,EACX,YAAY,EACZ,WAAW,EACX,SAAS,EACT,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxD,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxD,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAyB;QACjE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAyB;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,wCAAwC;QACxC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,qBAAqB;QACrB,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,iCAAiC;QACjC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,eAAe,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,uBAAuB;QACvB,yFAAyF;QACzF,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC3C,0CAA0C;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,kCAAkC;QAClC,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAC7C,4CAA4C;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,eAAe,CAAC,aAAa,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,2EAA2E;QAC3E,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,wCAAwC;QACxC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,sCAAsC;QACtC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,wEAAwE;QACxE,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/config-dir.d.ts

@@ -0,0 +1,2 @@
+export declare function getConfigDir(): string;
+//# sourceMappingURL=config-dir.d.ts.map

package/dist/utils/config-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-dir.d.ts","sourceRoot":"","sources":["../../src/utils/config-dir.ts"],"names":[],"mappings":"AAGA,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/utils/config-dir.js

@@ -0,0 +1,6 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export function getConfigDir() {
+    return process.env.CLAUDE_CONFIG_DIR || join(homedir(), ".claude");
+}
+//# sourceMappingURL=config-dir.js.map

package/dist/utils/config-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-dir.js","sourceRoot":"","sources":["../../src/utils/config-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACrE,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Cross-Platform Path Utilities
+ *
+ * Provides utility functions for handling paths across Windows, macOS, and Linux.
+ * These utilities ensure paths in configuration files use forward slashes
+ * (which work universally) and handle platform-specific directory conventions.
+ */
+/**
+ * Convert a path to use forward slashes (for JSON/config files)
+ * This is necessary because settings.json commands are executed
+ * by shells that expect forward slashes even on Windows
+ */
+export declare function toForwardSlash(path: string): string;
+/**
+ * Get Claude config directory path.
+ * Respects the CLAUDE_CONFIG_DIR environment variable when set.
+ */
+export declare function getClaudeConfigDir(): string;
+/**
+ * Get a path suitable for use in shell commands
+ * Converts backslashes to forward slashes for cross-platform compatibility
+ */
+export declare function toShellPath(path: string): string;
+/**
+ * Get Windows-appropriate data directory
+ * Falls back to sensible locations instead of XDG paths
+ */
+export declare function getDataDir(): string;
+/**
+ * Get Windows-appropriate config directory
+ */
+export declare function getConfigDir(): string;
+/**
+ * Get the plugin cache base directory for ultrapower.
+ * This is the directory containing version subdirectories.
+ *
+ * Structure: <configDir>/plugins/cache/omc/ultrapower/
+ */
+export declare function getPluginCacheBase(): string;
+/**
+ * Safely delete a file, ignoring ENOENT errors.
+ * Prevents crashes when cleaning up files that may not exist (Bug #13 fix).
+ */
+export declare function safeUnlinkSync(filePath: string): boolean;
+/**
+ * Safely remove a directory recursively, ignoring errors.
+ */
+export declare function safeRmSync(dirPath: string): boolean;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAKnC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAKrC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAUxD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAUnD"}

package/dist/utils/paths.js

@@ -0,0 +1,98 @@
+/**
+ * Cross-Platform Path Utilities
+ *
+ * Provides utility functions for handling paths across Windows, macOS, and Linux.
+ * These utilities ensure paths in configuration files use forward slashes
+ * (which work universally) and handle platform-specific directory conventions.
+ */
+import { join } from 'path';
+import { existsSync, unlinkSync, rmSync } from 'fs';
+import { homedir } from 'os';
+import { getConfigDir as getClaudeBaseConfigDir } from './config-dir.js';
+/**
+ * Convert a path to use forward slashes (for JSON/config files)
+ * This is necessary because settings.json commands are executed
+ * by shells that expect forward slashes even on Windows
+ */
+export function toForwardSlash(path) {
+    return path.replace(/\\/g, '/');
+}
+/**
+ * Get Claude config directory path.
+ * Respects the CLAUDE_CONFIG_DIR environment variable when set.
+ */
+export function getClaudeConfigDir() {
+    return getClaudeBaseConfigDir();
+}
+/**
+ * Get a path suitable for use in shell commands
+ * Converts backslashes to forward slashes for cross-platform compatibility
+ */
+export function toShellPath(path) {
+    const normalized = toForwardSlash(path);
+    // Windows paths with spaces need quoting
+    if (normalized.includes(' ')) {
+        return `"${normalized}"`;
+    }
+    return normalized;
+}
+/**
+ * Get Windows-appropriate data directory
+ * Falls back to sensible locations instead of XDG paths
+ */
+export function getDataDir() {
+    if (process.platform === 'win32') {
+        return process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local');
+    }
+    return process.env.XDG_DATA_HOME || join(homedir(), '.local', 'share');
+}
+/**
+ * Get Windows-appropriate config directory
+ */
+export function getConfigDir() {
+    if (process.platform === 'win32') {
+        return process.env.APPDATA || join(homedir(), 'AppData', 'Roaming');
+    }
+    return process.env.XDG_CONFIG_HOME || join(homedir(), '.config');
+}
+/**
+ * Get the plugin cache base directory for ultrapower.
+ * This is the directory containing version subdirectories.
+ *
+ * Structure: <configDir>/plugins/cache/omc/ultrapower/
+ */
+export function getPluginCacheBase() {
+    return join(getClaudeConfigDir(), 'plugins', 'cache', 'omc', 'ultrapower');
+}
+/**
+ * Safely delete a file, ignoring ENOENT errors.
+ * Prevents crashes when cleaning up files that may not exist (Bug #13 fix).
+ */
+export function safeUnlinkSync(filePath) {
+    try {
+        if (existsSync(filePath)) {
+            unlinkSync(filePath);
+            return true;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Safely remove a directory recursively, ignoring errors.
+ */
+export function safeRmSync(dirPath) {
+    try {
+        if (existsSync(dirPath)) {
+            rmSync(dirPath, { recursive: true, force: true });
+            return true;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,YAAY,IAAI,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,sBAAsB,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACxC,yCAAyC;IACzC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,UAAU,GAAG,CAAC;IAC3B,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,UAAU,CAAC,QAAQ,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/utils/string-width.d.ts

@@ -0,0 +1,80 @@
+/**
+ * CJK-aware String Width Utilities
+ *
+ * Provides functions for calculating visual width of strings containing
+ * CJK (Chinese, Japanese, Korean) characters, which are typically displayed
+ * as double-width in terminal emulators.
+ *
+ * This is a lightweight implementation without external dependencies.
+ * For full Unicode support, consider using the 'string-width' npm package.
+ *
+ * Related: Issue #344 - Korean IME input visibility
+ */
+/**
+ * Check if a character code point is a CJK (double-width) character.
+ *
+ * This covers the main CJK Unicode ranges:
+ * - CJK Unified Ideographs
+ * - Hangul Syllables
+ * - Hiragana and Katakana
+ * - Full-width ASCII and punctuation
+ * - CJK Compatibility Ideographs
+ */
+export declare function isCJKCharacter(codePoint: number): boolean;
+/**
+ * Check if a character is a zero-width character.
+ * These characters don't contribute to visual width.
+ */
+export declare function isZeroWidth(codePoint: number): boolean;
+/**
+ * Get the visual width of a single character.
+ * - CJK characters: 2 (double-width)
+ * - Zero-width characters: 0
+ * - Regular ASCII and most others: 1
+ */
+export declare function getCharWidth(char: string): number;
+/**
+ * Calculate the visual width of a string in terminal columns.
+ * Accounts for CJK double-width characters.
+ *
+ * Note: This strips ANSI escape codes before calculating width.
+ *
+ * @param str - The string to measure
+ * @returns Visual width in terminal columns
+ */
+export declare function stringWidth(str: string): number;
+/**
+ * Strip ANSI escape codes from a string.
+ */
+export declare function stripAnsi(str: string): string;
+/**
+ * Truncate a string to fit within a maximum visual width.
+ * CJK-aware: accounts for double-width characters.
+ *
+ * @param str - The string to truncate
+ * @param maxWidth - Maximum visual width in terminal columns
+ * @param suffix - Suffix to append if truncated (default: "...")
+ * @returns Truncated string that fits within maxWidth
+ */
+export declare function truncateToWidth(str: string, maxWidth: number, suffix?: string): string;
+/**
+ * Pad a string to a minimum visual width (right-pad with spaces).
+ * CJK-aware: accounts for double-width characters.
+ *
+ * @param str - The string to pad
+ * @param minWidth - Minimum visual width
+ * @param padChar - Character to pad with (default: space)
+ * @returns Padded string
+ */
+export declare function padToWidth(str: string, minWidth: number, padChar?: string): string;
+/**
+ * Slice a string by visual width instead of character count.
+ * CJK-aware: accounts for double-width characters.
+ *
+ * @param str - The string to slice
+ * @param startWidth - Start position in visual columns (0-based)
+ * @param endWidth - End position in visual columns (exclusive)
+ * @returns Sliced string
+ */
+export declare function sliceByWidth(str: string, startWidth: number, endWidth?: number): string;
+//# sourceMappingURL=string-width.d.ts.map

package/dist/utils/string-width.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-width.d.ts","sourceRoot":"","sources":["../../src/utils/string-width.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAuCzD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAkBtD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAW/C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAc,GACrB,MAAM,CAeR;AAoBD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,MAAY,GACpB,MAAM,CAMR;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAgCR"}

package/dist/utils/string-width.js

@@ -0,0 +1,219 @@
+/**
+ * CJK-aware String Width Utilities
+ *
+ * Provides functions for calculating visual width of strings containing
+ * CJK (Chinese, Japanese, Korean) characters, which are typically displayed
+ * as double-width in terminal emulators.
+ *
+ * This is a lightweight implementation without external dependencies.
+ * For full Unicode support, consider using the 'string-width' npm package.
+ *
+ * Related: Issue #344 - Korean IME input visibility
+ */
+/**
+ * Check if a character code point is a CJK (double-width) character.
+ *
+ * This covers the main CJK Unicode ranges:
+ * - CJK Unified Ideographs
+ * - Hangul Syllables
+ * - Hiragana and Katakana
+ * - Full-width ASCII and punctuation
+ * - CJK Compatibility Ideographs
+ */
+export function isCJKCharacter(codePoint) {
+    return (
+    // CJK Unified Ideographs (Chinese characters)
+    (codePoint >= 0x4e00 && codePoint <= 0x9fff) ||
+        // CJK Unified Ideographs Extension A
+        (codePoint >= 0x3400 && codePoint <= 0x4dbf) ||
+        // CJK Unified Ideographs Extension B-F (rare characters)
+        (codePoint >= 0x20000 && codePoint <= 0x2ebef) ||
+        // CJK Compatibility Ideographs
+        (codePoint >= 0xf900 && codePoint <= 0xfaff) ||
+        // Hangul Syllables (Korean)
+        (codePoint >= 0xac00 && codePoint <= 0xd7af) ||
+        // Hangul Jamo (Korean components)
+        (codePoint >= 0x1100 && codePoint <= 0x11ff) ||
+        // Hangul Compatibility Jamo
+        (codePoint >= 0x3130 && codePoint <= 0x318f) ||
+        // Hangul Jamo Extended-A
+        (codePoint >= 0xa960 && codePoint <= 0xa97f) ||
+        // Hangul Jamo Extended-B
+        (codePoint >= 0xd7b0 && codePoint <= 0xd7ff) ||
+        // Hiragana (Japanese)
+        (codePoint >= 0x3040 && codePoint <= 0x309f) ||
+        // Katakana (Japanese)
+        (codePoint >= 0x30a0 && codePoint <= 0x30ff) ||
+        // Katakana Phonetic Extensions
+        (codePoint >= 0x31f0 && codePoint <= 0x31ff) ||
+        // Full-width ASCII variants
+        (codePoint >= 0xff01 && codePoint <= 0xff60) ||
+        // Full-width punctuation and symbols
+        (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||
+        // CJK Symbols and Punctuation
+        (codePoint >= 0x3000 && codePoint <= 0x303f) ||
+        // Enclosed CJK Letters and Months
+        (codePoint >= 0x3200 && codePoint <= 0x32ff) ||
+        // CJK Compatibility
+        (codePoint >= 0x3300 && codePoint <= 0x33ff) ||
+        // CJK Compatibility Forms
+        (codePoint >= 0xfe30 && codePoint <= 0xfe4f));
+}
+/**
+ * Check if a character is a zero-width character.
+ * These characters don't contribute to visual width.
+ */
+export function isZeroWidth(codePoint) {
+    return (
+    // Zero-width characters
+    codePoint === 0x200b || // Zero Width Space
+        codePoint === 0x200c || // Zero Width Non-Joiner
+        codePoint === 0x200d || // Zero Width Joiner
+        codePoint === 0xfeff || // Byte Order Mark / Zero Width No-Break Space
+        // Combining diacritical marks (they modify previous character)
+        (codePoint >= 0x0300 && codePoint <= 0x036f) ||
+        // Combining Diacritical Marks Extended
+        (codePoint >= 0x1ab0 && codePoint <= 0x1aff) ||
+        // Combining Diacritical Marks Supplement
+        (codePoint >= 0x1dc0 && codePoint <= 0x1dff) ||
+        // Combining Diacritical Marks for Symbols
+        (codePoint >= 0x20d0 && codePoint <= 0x20ff) ||
+        // Combining Half Marks
+        (codePoint >= 0xfe20 && codePoint <= 0xfe2f));
+}
+/**
+ * Get the visual width of a single character.
+ * - CJK characters: 2 (double-width)
+ * - Zero-width characters: 0
+ * - Regular ASCII and most others: 1
+ */
+export function getCharWidth(char) {
+    const codePoint = char.codePointAt(0);
+    if (codePoint === undefined)
+        return 0;
+    if (isZeroWidth(codePoint))
+        return 0;
+    if (isCJKCharacter(codePoint))
+        return 2;
+    return 1;
+}
+/**
+ * Calculate the visual width of a string in terminal columns.
+ * Accounts for CJK double-width characters.
+ *
+ * Note: This strips ANSI escape codes before calculating width.
+ *
+ * @param str - The string to measure
+ * @returns Visual width in terminal columns
+ */
+export function stringWidth(str) {
+    if (!str)
+        return 0;
+    // Strip ANSI escape codes
+    const stripped = stripAnsi(str);
+    let width = 0;
+    for (const char of stripped) {
+        width += getCharWidth(char);
+    }
+    return width;
+}
+/**
+ * Strip ANSI escape codes from a string.
+ */
+export function stripAnsi(str) {
+    // ANSI escape code pattern: ESC [ ... m (SGR sequences)
+    // Also handles other common sequences
+    return str.replace(/\x1b\[[0-9;]*[a-zA-Z]|\x1b\][^\x07]*\x07/g, "");
+}
+/**
+ * Truncate a string to fit within a maximum visual width.
+ * CJK-aware: accounts for double-width characters.
+ *
+ * @param str - The string to truncate
+ * @param maxWidth - Maximum visual width in terminal columns
+ * @param suffix - Suffix to append if truncated (default: "...")
+ * @returns Truncated string that fits within maxWidth
+ */
+export function truncateToWidth(str, maxWidth, suffix = "...") {
+    if (!str || maxWidth <= 0)
+        return "";
+    const strWidth = stringWidth(str);
+    if (strWidth <= maxWidth)
+        return str;
+    const suffixWidth = stringWidth(suffix);
+    const targetWidth = maxWidth - suffixWidth;
+    if (targetWidth <= 0) {
+        // Can't even fit the suffix, return truncated suffix
+        return truncateToWidthNoSuffix(suffix, maxWidth);
+    }
+    return truncateToWidthNoSuffix(str, targetWidth) + suffix;
+}
+/**
+ * Truncate a string to fit within a maximum visual width without adding suffix.
+ * Used internally and when you don't want ellipsis.
+ */
+function truncateToWidthNoSuffix(str, maxWidth) {
+    let width = 0;
+    let result = "";
+    for (const char of str) {
+        const charWidth = getCharWidth(char);
+        if (width + charWidth > maxWidth)
+            break;
+        result += char;
+        width += charWidth;
+    }
+    return result;
+}
+/**
+ * Pad a string to a minimum visual width (right-pad with spaces).
+ * CJK-aware: accounts for double-width characters.
+ *
+ * @param str - The string to pad
+ * @param minWidth - Minimum visual width
+ * @param padChar - Character to pad with (default: space)
+ * @returns Padded string
+ */
+export function padToWidth(str, minWidth, padChar = " ") {
+    const currentWidth = stringWidth(str);
+    if (currentWidth >= minWidth)
+        return str;
+    const padWidth = minWidth - currentWidth;
+    return str + padChar.repeat(padWidth);
+}
+/**
+ * Slice a string by visual width instead of character count.
+ * CJK-aware: accounts for double-width characters.
+ *
+ * @param str - The string to slice
+ * @param startWidth - Start position in visual columns (0-based)
+ * @param endWidth - End position in visual columns (exclusive)
+ * @returns Sliced string
+ */
+export function sliceByWidth(str, startWidth, endWidth) {
+    if (!str)
+        return "";
+    let currentWidth = 0;
+    let result = "";
+    let started = false;
+    for (const char of str) {
+        const charWidth = getCharWidth(char);
+        // Check if we've reached the start position
+        if (!started && currentWidth + charWidth > startWidth) {
+            started = true;
+        }
+        // Check if we've reached the end position
+        if (endWidth !== undefined && currentWidth >= endWidth) {
+            break;
+        }
+        if (started) {
+            // Check if adding this character would exceed endWidth
+            if (endWidth !== undefined && currentWidth + charWidth > endWidth) {
+                break;
+            }
+            result += char;
+        }
+        currentWidth += charWidth;
+    }
+    return result;
+}
+//# sourceMappingURL=string-width.js.map