@oh-my-pi/pi-natives 13.1.1 → 13.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-natives",
-	"version": "13.1.1",
+	"version": "13.2.0",
 	"description": "Native Rust bindings for grep, clipboard, image processing, syntax highlighting, PTY, and shell operations via N-API",
 	"homepage": "https://github.com/can1357/oh-my-pi",
 	"author": "Can Boluk",
@@ -38,7 +38,7 @@
 		"bench": "bun bench/grep.ts"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-utils": "13.1.1"
+		"@oh-my-pi/pi-utils": "13.2.0"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3"

package/src/text/index.ts

@@ -2,7 +2,8 @@
  * ANSI-aware text utilities powered by native bindings.
  */
 
-import { Ellipsis, type SliceWithWidthResult } from "@oh-my-pi/pi-natives";
+import { Ellipsis, type ExtractSegmentsResult, type SliceWithWidthResult } from "@oh-my-pi/pi-natives";
+import { getDefaultTabWidth } from "@oh-my-pi/pi-utils";
 import { native } from "../native";
 
 export type { ExtractSegmentsResult, SliceWithWidthResult } from "./types";
@@ -24,8 +25,9 @@ export function truncateToWidth(
 	maxWidth: number,
 	ellipsis: Ellipsis = Ellipsis.Unicode,
 	pad = false,
+	tabWidth = getDefaultTabWidth(),
 ): string {
-	return native.truncateToWidth(text, maxWidth, ellipsis, pad);
+	return native.truncateToWidth(text, maxWidth, ellipsis, pad, tabWidth);
 }
 
 /**
@@ -36,9 +38,60 @@ export function truncateToWidth(
  * @param strict - Whether to strictly enforce the length
  * @returns The sliced line
  */
-export function sliceWithWidth(line: string, startCol: number, length: number, strict = false): SliceWithWidthResult {
+export function sliceWithWidth(
+	line: string,
+	startCol: number,
+	length: number,
+	strict = false,
+	tabWidth = getDefaultTabWidth(),
+): SliceWithWidthResult {
 	if (length <= 0) return { text: "", width: 0 };
-	return native.sliceWithWidth(line, startCol, length, strict);
+	return native.sliceWithWidth(line, startCol, length, strict, tabWidth);
 }
 
-export const { wrapTextWithAnsi, visibleWidth, extractSegments, sanitizeText } = native;
+/**
+ * Wrap text to a visible width while preserving ANSI color/style sequences.
+ *
+ * @param text - Input text, optionally containing ANSI escape codes
+ * @param width - Maximum visible width per output line
+ * @param tabWidth - Width used when measuring tab characters (default: configured tab width)
+ * @returns Wrapped lines with ANSI state preserved across breaks
+ */
+export function wrapTextWithAnsi(text: string, width: number, tabWidth = getDefaultTabWidth()): string[] {
+	return native.wrapTextWithAnsi(text, width, tabWidth);
+}
+
+/**
+ * Measure visible terminal width of text, excluding ANSI escape sequences.
+ *
+ * @param text - Input text, optionally containing ANSI escape codes
+ * @param tabWidth - Width used when measuring tab characters (default: configured tab width)
+ * @returns Visible width in terminal cells
+ */
+export function visibleWidth(text: string, tabWidth = getDefaultTabWidth()): number {
+	return native.visibleWidth(text, tabWidth);
+}
+
+/**
+ * Extract before/after segments around an overlay range using visible-column boundaries.
+ *
+ * @param line - Input line, optionally containing ANSI escape codes
+ * @param beforeEnd - Visible column where the `before` segment ends
+ * @param afterStart - Visible column where the `after` segment starts
+ * @param afterLen - Visible width to include in the `after` segment
+ * @param strictAfter - When true, graphemes that overflow `afterLen` are dropped
+ * @param tabWidth - Width used when measuring tab characters (default: configured tab width)
+ * @returns Visible-width-aware before/after segments
+ */
+export function extractSegments(
+	line: string,
+	beforeEnd: number,
+	afterStart: number,
+	afterLen: number,
+	strictAfter: boolean,
+	tabWidth = getDefaultTabWidth(),
+): ExtractSegmentsResult {
+	return native.extractSegments(line, beforeEnd, afterStart, afterLen, strictAfter, tabWidth);
+}
+
+export const { sanitizeText } = native;

package/src/text/types.ts

@@ -41,7 +41,7 @@ declare module "../bindings" {
 		 * @param ellipsisKind Ellipsis strategy (see {@link Ellipsis}).
 		 * @param pad Whether to pad the output to `maxWidth`.
 		 */
-		truncateToWidth(text: string, maxWidth: number, ellipsisKind: number, pad: boolean): string;
+		truncateToWidth(text: string, maxWidth: number, ellipsisKind: number, pad: boolean, tabWidth?: number): string;
 		/**
 		 * Sanitize text output: strip ANSI codes, remove binary garbage, normalize line endings.
 		 */
@@ -52,7 +52,7 @@ declare module "../bindings" {
 		 * @param text UTF-16 input text with optional ANSI escapes.
 		 * @param width Maximum visible width per line.
 		 */
-		wrapTextWithAnsi(text: string, width: number): string[];
+		wrapTextWithAnsi(text: string, width: number, tabWidth?: number): string[];
 		/**
 		 * Slice a range of visible columns from a line.
 		 * @param line UTF-16 input line with optional ANSI escapes.
@@ -60,12 +60,18 @@ declare module "../bindings" {
 		 * @param length Number of visible cells to include.
 		 * @param strict Whether to drop graphemes that overflow the range.
 		 */
-		sliceWithWidth(line: string, startCol: number, length: number, strict: boolean): SliceWithWidthResult;
+		sliceWithWidth(
+			line: string,
+			startCol: number,
+			length: number,
+			strict: boolean,
+			tabWidth?: number,
+		): SliceWithWidthResult;
 		/**
 		 * Measure the visible width of text (excluding ANSI codes).
 		 * @param text UTF-16 input text with optional ANSI escapes.
 		 */
-		visibleWidth(text: string): number;
+		visibleWidth(text: string, tabWidth?: number): number;
 		/** Extract before/after segments around an overlay region.
 		 * @param line UTF-16 input line with optional ANSI escapes.
 		 * @param beforeEnd Column where the "before" segment ends.
@@ -79,6 +85,7 @@ declare module "../bindings" {
 			afterStart: number,
 			afterLen: number,
 			strictAfter: boolean,
+			tabWidth?: number,
 		): ExtractSegmentsResult;
 	}
 }