@oh-my-pi/pi-natives 9.6.0 → 9.6.3

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-natives",
-	"version": "9.6.0",
+	"version": "9.6.3",
 	"description": "Native Rust functionality via N-API",
 	"type": "module",
 	"main": "./src/index.ts",
@@ -30,7 +30,7 @@
 		"directory": "packages/natives"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-utils": "9.6.0"
+		"@oh-my-pi/pi-utils": "9.6.3"
 	},
 	"devDependencies": {
 		"@types/node": "^25.0.10"

package/src/index.ts

@@ -70,6 +70,7 @@ export {
 // =============================================================================
 
 export {
+	Ellipsis,
 	type ExtractSegmentsResult,
 	extractSegments,
 	type SliceWithWidthResult,
@@ -89,6 +90,12 @@ export {
 	supportsLanguage,
 } from "./highlight/index";
 
+// =============================================================================
+// Keyboard sequence helpers
+// =============================================================================
+
+export { matchesKittySequence } from "./keys/index";
+
 // =============================================================================
 // HTML to Markdown
 // =============================================================================

package/src/keys/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Keyboard sequence utilities powered by native bindings.
+ */
+
+import { native } from "../native";
+
+/** Match Kitty protocol sequences for codepoint and modifier. */
+export function matchesKittySequence(data: string, expectedCodepoint: number, expectedModifier: number): boolean {
+	return native.matchesKittySequence(data, expectedCodepoint, expectedModifier);
+}

package/src/native.ts

@@ -11,7 +11,7 @@ import type {
 } from "./grep/types";
 import type { HighlightColors } from "./highlight/index";
 import type { HtmlToMarkdownOptions } from "./html/types";
-import type { ExtractSegmentsResult, SliceWithWidthResult, TextInput } from "./text/index";
+import type { ExtractSegmentsResult, SliceWithWidthResult } from "./text/index";
 
 export interface NativePhotonImage {
 	getWidth(): number;
@@ -55,16 +55,17 @@ export interface NativeBindings {
 	getSupportedLanguages(): string[];
 	SamplingFilter: NativeSamplingFilter;
 	PhotonImage: NativePhotonImageConstructor;
-	visibleWidth(text: TextInput): number;
-	truncateToWidth(text: TextInput, maxWidth: number, ellipsis: TextInput, pad: boolean): string;
-	sliceWithWidth(line: TextInput, startCol: number, length: number, strict: boolean): SliceWithWidthResult;
+	truncateToWidth(text: string, maxWidth: number, ellipsisKind: number, pad: boolean): string;
+	sliceWithWidth(line: string, startCol: number, length: number, strict: boolean): SliceWithWidthResult;
+	visibleWidth(text: string): number;
 	extractSegments(
-		line: TextInput,
+		line: string,
 		beforeEnd: number,
 		afterStart: number,
 		afterLen: number,
 		strictAfter: boolean,
 	): ExtractSegmentsResult;
+	matchesKittySequence(data: string, expectedCodepoint: number, expectedModifier: number): boolean;
 }
 
 const require = createRequire(import.meta.url);
@@ -76,12 +77,12 @@ const execDir = path.dirname(process.execPath);
 const SUPPORTED_PLATFORMS = ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64", "win32-x64"];
 
 const candidates = [
+	path.join(repoRoot, "target", "release", "pi_natives.node"),
+	path.join(repoRoot, "crates", "pi-natives", "target", "release", "pi_natives.node"),
 	path.join(nativeDir, `pi_natives.${platformTag}.node`),
 	path.join(nativeDir, "pi_natives.node"),
 	path.join(execDir, `pi_natives.${platformTag}.node`),
 	path.join(execDir, "pi_natives.node"),
-	path.join(repoRoot, "target", "release", "pi_natives.node"),
-	path.join(repoRoot, "crates", "pi-natives", "target", "release", "pi_natives.node"),
 ];
 
 function loadNative(): NativeBindings {
@@ -133,20 +134,10 @@ function validateNative(bindings: NativeBindings, source: string): void {
 	checkFn("highlightCode");
 	checkFn("supportsLanguage");
 	checkFn("getSupportedLanguages");
-	checkFn("visibleWidth");
 	checkFn("truncateToWidth");
 	checkFn("sliceWithWidth");
 	checkFn("extractSegments");
-
-	if (!bindings.PhotonImage?.newFromByteslice) {
-		missing.push("PhotonImage.newFromByteslice");
-	}
-	if (!bindings.PhotonImage?.prototype?.resize) {
-		missing.push("PhotonImage.resize");
-	}
-	if (!bindings.SamplingFilter || typeof bindings.SamplingFilter.Lanczos3 !== "number") {
-		missing.push("SamplingFilter");
-	}
+	checkFn("matchesKittySequence");
 
 	if (missing.length) {
 		throw new Error(

package/src/text/index.ts

@@ -16,29 +16,44 @@ export interface ExtractSegmentsResult {
 	afterWidth: number;
 }
 
-export type TextInput = string | Uint8Array;
-
-/** Compute the visible width of a string, ignoring ANSI codes. */
-export function visibleWidth(text: TextInput): number {
-	return native.visibleWidth(text);
+export const enum Ellipsis {
+	Unicode = 0, // "…"
+	Ascii = 1, // "..."
+	Omit = 2, // ""
 }
 
 /**
- * Truncate a string to a visible width, preserving ANSI codes.
+ * Truncate text to fit within a maximum visible width, adding ellipsis if needed.
+ * Optionally pad with spaces to reach exactly maxWidth.
+ * Properly handles ANSI escape codes (they don't count toward width).
+ *
+ * @param text - Text to truncate (may contain ANSI codes)
+ * @param maxWidth - Maximum visible width
+ * @param ellipsis - Ellipsis kind to append when truncating (default: Unicode "…")
+ * @param pad - If true, pad result with spaces to exactly maxWidth (default: false)
+ * @returns Truncated text, optionally padded to exactly maxWidth
  */
-export function truncateToWidth(text: TextInput, maxWidth: number, ellipsis: TextInput = "…", pad = false): string {
+export function truncateToWidth(
+	text: string,
+	maxWidth: number,
+	ellipsis: Ellipsis = Ellipsis.Unicode,
+	pad = false,
+): string {
 	return native.truncateToWidth(text, maxWidth, ellipsis, pad);
 }
 
+/**
+ * Measure the visible width of text (excluding ANSI codes).
+ */
+export function visibleWidth(text: string): number {
+	return native.visibleWidth(text);
+}
+
 /**
  * Slice a range of visible columns from a line.
  */
-export function sliceWithWidth(
-	line: TextInput,
-	startCol: number,
-	length: number,
-	strict = false,
-): SliceWithWidthResult {
+export function sliceWithWidth(line: string, startCol: number, length: number, strict = false): SliceWithWidthResult {
+	if (length <= 0) return { text: "", width: 0 };
 	return native.sliceWithWidth(line, startCol, length, strict);
 }
 
@@ -46,7 +61,7 @@ export function sliceWithWidth(
  * Extract before/after segments around an overlay region.
  */
 export function extractSegments(
-	line: TextInput,
+	line: string,
 	beforeEnd: number,
 	afterStart: number,
 	afterLen: number,