@oh-my-pi/pi-natives 8.12.5 → 8.12.8

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-natives",
-	"version": "8.12.5",
+	"version": "8.12.8",
 	"description": "Native Rust functionality compiled to WebAssembly via wasm-bindgen",
 	"type": "module",
 	"main": "./src/index.ts",
@@ -30,7 +30,7 @@
 		"directory": "packages/natives"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-utils": "8.12.5"
+		"@oh-my-pi/pi-utils": "8.12.8"
 	},
 	"devDependencies": {
 		"@types/node": "^25.0.10"

package/src/index.ts

@@ -133,6 +133,19 @@ export {
 	terminate as terminateImageWorker,
 } from "./image/index";
 
+// =============================================================================
+// Text utilities
+// =============================================================================
+
+export {
+	type ExtractSegmentsResult,
+	extractSegments,
+	type SliceWithWidthResult,
+	sliceWithWidth,
+	truncateToWidth,
+	visibleWidth,
+} from "./text/index";
+
 // =============================================================================
 // Worker Pool (shared infrastructure)
 // =============================================================================

package/src/text/index.ts

@@ -0,0 +1,64 @@
+/**
+ * ANSI-aware text utilities powered by WASM.
+ */
+
+import * as wasm from "../../wasm/pi_natives";
+
+export interface SliceWithWidthResult {
+	text: string;
+	width: number;
+}
+
+export interface ExtractSegmentsResult {
+	before: string;
+	beforeWidth: number;
+	after: string;
+	afterWidth: number;
+}
+
+type WasmTextExports = typeof wasm & {
+	visible_width: (text: string) => number;
+	truncate_to_width: (text: string, maxWidth: number, ellipsis: string, pad: boolean) => string;
+	slice_with_width: (line: string, startCol: number, length: number, strict: boolean) => SliceWithWidthResult;
+	extract_segments: (
+		line: string,
+		beforeEnd: number,
+		afterStart: number,
+		afterLen: number,
+		strictAfter: boolean,
+	) => ExtractSegmentsResult;
+};
+
+const wasmText = wasm as WasmTextExports;
+
+/** Compute the visible width of a string, ignoring ANSI codes. */
+export function visibleWidth(text: string): number {
+	return wasmText.visible_width(text);
+}
+
+/**
+ * Truncate a string to a visible width, preserving ANSI codes.
+ */
+export function truncateToWidth(text: string, maxWidth: number, ellipsis = "…", pad = false): string {
+	return wasmText.truncate_to_width(text, maxWidth, ellipsis, pad);
+}
+
+/**
+ * Slice a range of visible columns from a line.
+ */
+export function sliceWithWidth(line: string, startCol: number, length: number, strict = false): SliceWithWidthResult {
+	return wasmText.slice_with_width(line, startCol, length, strict);
+}
+
+/**
+ * Extract before/after segments around an overlay region.
+ */
+export function extractSegments(
+	line: string,
+	beforeEnd: number,
+	afterStart: number,
+	afterLen: number,
+	strictAfter = false,
+): ExtractSegmentsResult {
+	return wasmText.extract_segments(line, beforeEnd, afterStart, afterLen, strictAfter);
+}

package/wasm/pi_natives.d.ts

@@ -55,7 +55,8 @@ export class PhotonImage {
      */
     get_width(): number;
     /**
-     * Create a new PhotonImage from encoded image bytes (PNG, JPEG, WebP, GIF).
+     * Create a new `PhotonImage` from encoded image bytes (PNG, JPEG, WebP,
+     * GIF).
      */
     static new_from_byteslice(bytes: Uint8Array): PhotonImage;
 }
@@ -71,6 +72,11 @@ export enum SamplingFilter {
     Lanczos3 = 5,
 }
 
+/**
+ * Extract the before/after slices around an overlay region.
+ */
+export function extract_segments(line: string, before_end: number, after_start: number, after_len: number, strict_after: boolean): any;
+
 /**
  * Quick check if content matches a pattern.
  */
@@ -86,3 +92,18 @@ export function resize(image: PhotonImage, width: number, height: number, filter
  * For repeated searches with the same pattern, use [`CompiledPattern`].
  */
 export function search(content: string, options: any): any;
+
+/**
+ * Slice a range of visible columns from a line.
+ */
+export function slice_with_width(line: string, start_col: number, length: number, strict: boolean): any;
+
+/**
+ * Truncate text to a visible width, preserving ANSI codes.
+ */
+export function truncate_to_width(text: string, max_width: number, ellipsis: string, pad: boolean): string;
+
+/**
+ * Compute the visible width of a string, ignoring ANSI codes.
+ */
+export function visible_width(text: string): number;

package/wasm/pi_natives.js

@@ -1,7 +1,7 @@
-/* @ts-self-types="./pi_natives.d.ts" */
-
 import wasmPath from "./pi_natives_bg.wasm";
 
+/* @ts-self-types="./pi_natives.d.ts" */
+
 /**
  * A compiled regex matcher that can be reused across multiple searches.
  */
@@ -173,7 +173,8 @@ export class PhotonImage {
         return ret >>> 0;
     }
     /**
-     * Create a new PhotonImage from encoded image bytes (PNG, JPEG, WebP, GIF).
+     * Create a new `PhotonImage` from encoded image bytes (PNG, JPEG, WebP,
+     * GIF).
      * @param {Uint8Array} bytes
      * @returns {PhotonImage}
      */
@@ -209,6 +210,22 @@ export const SamplingFilter = Object.freeze({
     Lanczos3: 5, "5": "Lanczos3",
 });
 
+/**
+ * Extract the before/after slices around an overlay region.
+ * @param {string} line
+ * @param {number} before_end
+ * @param {number} after_start
+ * @param {number} after_len
+ * @param {boolean} strict_after
+ * @returns {any}
+ */
+export function extract_segments(line, before_end, after_start, after_len, strict_after) {
+    const ptr0 = passStringToWasm0(line, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.extract_segments(ptr0, len0, before_end, after_start, after_len, strict_after);
+    return takeObject(ret);
+}
+
 /**
  * Quick check if content matches a pattern.
  * @param {string} content
@@ -265,6 +282,62 @@ export function search(content, options) {
     return takeObject(ret);
 }
 
+/**
+ * Slice a range of visible columns from a line.
+ * @param {string} line
+ * @param {number} start_col
+ * @param {number} length
+ * @param {boolean} strict
+ * @returns {any}
+ */
+export function slice_with_width(line, start_col, length, strict) {
+    const ptr0 = passStringToWasm0(line, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.slice_with_width(ptr0, len0, start_col, length, strict);
+    return takeObject(ret);
+}
+
+/**
+ * Truncate text to a visible width, preserving ANSI codes.
+ * @param {string} text
+ * @param {number} max_width
+ * @param {string} ellipsis
+ * @param {boolean} pad
+ * @returns {string}
+ */
+export function truncate_to_width(text, max_width, ellipsis, pad) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(text, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(ellipsis, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.truncate_to_width(retptr, ptr0, len0, max_width, ptr1, len1, pad);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred3_0 = r0;
+        deferred3_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export3(deferred3_0, deferred3_1, 1);
+    }
+}
+
+/**
+ * Compute the visible width of a string, ignoring ANSI codes.
+ * @param {string} text
+ * @returns {number}
+ */
+export function visible_width(text) {
+    const ptr0 = passStringToWasm0(text, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.visible_width(ptr0, len0);
+    return ret >>> 0;
+}
+
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,

package/wasm/pi_natives_bg.wasm.d.ts

@@ -6,6 +6,7 @@ export const __wbg_photonimage_free: (a: number, b: number) => void;
 export const compiledpattern_has_match: (a: number, b: number, c: number) => number;
 export const compiledpattern_new: (a: number, b: number) => void;
 export const compiledpattern_search: (a: number, b: number, c: number, d: number, e: number) => number;
+export const extract_segments: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
 export const has_match: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const photonimage_get_bytes: (a: number, b: number) => void;
 export const photonimage_get_bytes_jpeg: (a: number, b: number, c: number) => void;
@@ -14,6 +15,9 @@ export const photonimage_get_width: (a: number) => number;
 export const photonimage_new_from_byteslice: (a: number, b: number, c: number) => void;
 export const resize: (a: number, b: number, c: number, d: number) => number;
 export const search: (a: number, b: number, c: number) => number;
+export const slice_with_width: (a: number, b: number, c: number, d: number, e: number) => number;
+export const truncate_to_width: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const visible_width: (a: number, b: number) => number;
 export const compiledpattern_has_match_bytes: (a: number, b: number, c: number) => number;
 export const compiledpattern_search_bytes: (a: number, b: number, c: number, d: number, e: number) => number;
 export const __wbindgen_export: (a: number, b: number) => number;