@oh-my-pi/pi-tui 8.0.20 → 8.2.0

package/package.json

@@ -1,17 +1,31 @@
 {
 	"name": "@oh-my-pi/pi-tui",
-	"version": "8.0.20",
+	"version": "8.2.0",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"type": "module",
-	"main": "src/index.ts",
+	"main": "./src/index.ts",
+	"types": "./src/index.ts",
+	"exports": {
+		".": {
+			"types": "./src/index.ts",
+			"import": "./src/index.ts"
+		},
+		"./components/*": {
+			"types": "./src/components/*.ts",
+			"import": "./src/components/*.ts"
+		},
+		"./*": {
+			"types": "./src/*.ts",
+			"import": "./src/*.ts"
+		}
+	},
 	"scripts": {
-		"test": "bun test test/*.test.ts",
-		"prepublishOnly": "cp tsconfig.publish.json tsconfig.json"
+		"check": "tsgo -p tsconfig.json",
+		"test": "bun test test/*.test.ts"
 	},
 	"files": [
 		"src/**/*",
-		"README.md",
-		"tsconfig.json"
+		"README.md"
 	],
 	"keywords": [
 		"tui",
@@ -32,23 +46,15 @@
 	"engines": {
 		"bun": ">=1.0.0"
 	},
-	"types": "./src/index.ts",
 	"dependencies": {
-		"@types/mime-types": "^2.1.4",
+		"@types/mime-types": "^3.0.1",
 		"chalk": "^5.5.0",
 		"get-east-asian-width": "^1.3.0",
-		"marked": "^15.0.12",
+		"marked": "^17.0.1",
 		"mime-types": "^3.0.1"
 	},
 	"devDependencies": {
-		"@xterm/headless": "^5.5.0",
-		"@xterm/xterm": "^5.5.0"
-	},
-	"exports": {
-		".": {
-			"types": "./src/index.ts",
-			"import": "./src/index.ts"
-		},
-		"./*": "./src/*"
+		"@xterm/headless": "^6.0.0",
+		"@xterm/xterm": "^6.0.0"
 	}
 }

package/src/autocomplete.ts

@@ -1,36 +1,34 @@
-import { readdirSync, statSync } from "node:fs";
-import { homedir } from "node:os";
-import { basename, dirname, join } from "node:path";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
 
-// Use fd to walk directory tree (fast, respects .gitignore)
-function walkDirectoryWithFd(
+async function walkDirectoryWithFd(
 	baseDir: string,
 	fdPath: string,
 	query: string,
 	maxResults: number,
-): Array<{ path: string; isDirectory: boolean }> {
+): Promise<Array<{ path: string; isDirectory: boolean }>> {
 	const args = ["--base-directory", baseDir, "--max-results", String(maxResults), "--type", "f", "--type", "d"];
 
-	// Add query as pattern if provided
 	if (query) {
 		args.push(query);
 	}
 
-	const result = Bun.spawnSync([fdPath, ...args], {
+	const proc = Bun.spawn([fdPath, ...args], {
 		stdout: "pipe",
 		stderr: "pipe",
 	});
 
-	if (!result.success || !result.stdout) {
+	const exitCode = await proc.exited;
+	if (exitCode !== 0 || !proc.stdout) {
 		return [];
 	}
 
-	const stdout = new TextDecoder().decode(result.stdout);
+	const stdout = await new Response(proc.stdout).text();
 	const lines = stdout.trim().split("\n").filter(Boolean);
 	const results: Array<{ path: string; isDirectory: boolean }> = [];
 
 	for (const line of lines) {
-		// fd outputs directories with trailing /
 		const isDirectory = line.endsWith("/");
 		results.push({
 			path: line,
@@ -62,10 +60,10 @@ export interface AutocompleteProvider {
 		lines: string[],
 		cursorLine: number,
 		cursorCol: number,
-	): {
+	): Promise<{
 		items: AutocompleteItem[];
 		prefix: string; // What we're matching against (e.g., "/" or "src/")
-	} | null;
+	} | null>;
 
 	// Apply the selected item
 	// Returns the new text and cursor position
@@ -87,6 +85,8 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 	private commands: (SlashCommand | AutocompleteItem)[];
 	private basePath: string;
 	private fdPath: string | null;
+	private dirCache: Map<string, { entries: fs.Dirent[]; timestamp: number }> = new Map();
+	private readonly DIR_CACHE_TTL = 2000; // 2 seconds
 
 	constructor(
 		commands: (SlashCommand | AutocompleteItem)[] = [],
@@ -98,11 +98,11 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 		this.fdPath = fdPath ?? Bun.which("fd") ?? Bun.which("fdfind");
 	}
 
-	getSuggestions(
+	async getSuggestions(
 		lines: string[],
 		cursorLine: number,
 		cursorCol: number,
-	): { items: AutocompleteItem[]; prefix: string } | null {
+	): Promise<{ items: AutocompleteItem[]; prefix: string } | null> {
 		const currentLine = lines[cursorLine] || "";
 		const textBeforeCursor = currentLine.slice(0, cursorCol);
 
@@ -111,9 +111,10 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 		if (atMatch) {
 			const prefix = atMatch[1] ?? "@"; // The @... part
 			const query = prefix.slice(1); // Remove the @
-			const suggestions = query.length > 0 ? this.getFuzzyFileSuggestions(query) : this.getFileSuggestions("@");
+			const suggestions =
+				query.length > 0 ? await this.getFuzzyFileSuggestions(query) : await this.getFileSuggestions("@");
 			if (suggestions.length === 0 && query.length > 0) {
-				const fallback = this.getFileSuggestions(prefix);
+				const fallback = await this.getFileSuggestions(prefix);
 				if (fallback.length === 0) return null;
 				return { items: fallback, prefix };
 			}
@@ -133,11 +134,11 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 				// No space yet - complete command names
 				const prefix = textBeforeCursor.slice(1); // Remove the "/"
 				const filtered = this.commands
-					.filter((cmd) => {
+					.filter(cmd => {
 						const name = "name" in cmd ? cmd.name : cmd.value; // Check if SlashCommand or AutocompleteItem
 						return name?.toLowerCase().startsWith(prefix.toLowerCase());
 					})
-					.map((cmd) => ({
+					.map(cmd => ({
 						value: "name" in cmd ? cmd.name : cmd.value,
 						label: "name" in cmd ? cmd.name : cmd.label,
 						...(cmd.description && { description: cmd.description }),
@@ -154,7 +155,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 				const commandName = textBeforeCursor.slice(1, spaceIndex); // Command without "/"
 				const argumentText = textBeforeCursor.slice(spaceIndex + 1); // Text after space
 
-				const command = this.commands.find((cmd) => {
+				const command = this.commands.find(cmd => {
 					const name = "name" in cmd ? cmd.name : cmd.value;
 					return name === commandName;
 				});
@@ -178,7 +179,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 		const pathMatch = this.extractPathPrefix(textBeforeCursor, false);
 
 		if (pathMatch !== null) {
-			const suggestions = this.getFileSuggestions(pathMatch);
+			const suggestions = await this.getFileSuggestions(pathMatch);
 			if (suggestions.length === 0) return null;
 
 			// Check if we have an exact match that is a directory
@@ -311,19 +312,51 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 	}
 
 	// Expand home directory (~/) to actual home path
-	private expandHomePath(path: string): string {
-		if (path.startsWith("~/")) {
-			const expandedPath = join(homedir(), path.slice(2));
+	private expandHomePath(filePath: string): string {
+		if (filePath.startsWith("~/")) {
+			const expandedPath = path.join(os.homedir(), filePath.slice(2));
 			// Preserve trailing slash if original path had one
-			return path.endsWith("/") && !expandedPath.endsWith("/") ? `${expandedPath}/` : expandedPath;
-		} else if (path === "~") {
-			return homedir();
+			return filePath.endsWith("/") && !expandedPath.endsWith("/") ? `${expandedPath}/` : expandedPath;
+		} else if (filePath === "~") {
+			return os.homedir();
+		}
+		return filePath;
+	}
+
+	private async getCachedDirEntries(searchDir: string): Promise<fs.Dirent[]> {
+		const now = Date.now();
+		const cached = this.dirCache.get(searchDir);
+
+		if (cached && now - cached.timestamp < this.DIR_CACHE_TTL) {
+			return cached.entries;
+		}
+
+		const entries = await fs.promises.readdir(searchDir, { withFileTypes: true });
+		this.dirCache.set(searchDir, { entries, timestamp: now });
+
+		if (this.dirCache.size > 100) {
+			const sortedKeys = [...this.dirCache.entries()]
+				.sort((a, b) => a[1].timestamp - b[1].timestamp)
+				.slice(0, 50)
+				.map(([key]) => key);
+			for (const key of sortedKeys) {
+				this.dirCache.delete(key);
+			}
+		}
+
+		return entries;
+	}
+
+	public invalidateDirCache(dir?: string): void {
+		if (dir) {
+			this.dirCache.delete(dir);
+		} else {
+			this.dirCache.clear();
 		}
-		return path;
 	}
 
 	// Get file/directory suggestions for a given path prefix
-	private getFileSuggestions(prefix: string): AutocompleteItem[] {
+	private async getFileSuggestions(prefix: string): Promise<AutocompleteItem[]> {
 		try {
 			let searchDir: string;
 			let searchPrefix: string;
@@ -354,7 +387,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 				if (prefix.startsWith("~") || expandedPrefix === "/") {
 					searchDir = expandedPrefix;
 				} else {
-					searchDir = join(this.basePath, expandedPrefix);
+					searchDir = path.join(this.basePath, expandedPrefix);
 				}
 				searchPrefix = "";
 			} else if (expandedPrefix.endsWith("/")) {
@@ -362,22 +395,22 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 				if (prefix.startsWith("~") || expandedPrefix.startsWith("/")) {
 					searchDir = expandedPrefix;
 				} else {
-					searchDir = join(this.basePath, expandedPrefix);
+					searchDir = path.join(this.basePath, expandedPrefix);
 				}
 				searchPrefix = "";
 			} else {
 				// Split into directory and file prefix
-				const dir = dirname(expandedPrefix);
-				const file = basename(expandedPrefix);
+				const dir = path.dirname(expandedPrefix);
+				const file = path.basename(expandedPrefix);
 				if (prefix.startsWith("~") || expandedPrefix.startsWith("/")) {
 					searchDir = dir;
 				} else {
-					searchDir = join(this.basePath, dir);
+					searchDir = path.join(this.basePath, dir);
 				}
 				searchPrefix = file;
 			}
 
-			const entries = readdirSync(searchDir, { withFileTypes: true });
+			const entries = await this.getCachedDirEntries(searchDir);
 			const suggestions: AutocompleteItem[] = [];
 
 			for (const entry of entries) {
@@ -389,8 +422,8 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 				let isDirectory = entry.isDirectory();
 				if (!isDirectory && entry.isSymbolicLink()) {
 					try {
-						const fullPath = join(searchDir, entry.name);
-						isDirectory = statSync(fullPath).isDirectory();
+						const fullPath = path.join(searchDir, entry.name);
+						isDirectory = (await fs.promises.stat(fullPath)).isDirectory();
 					} catch {
 						// Broken symlink, file deleted between readdir and stat, or permission error
 						continue;
@@ -408,10 +441,10 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 					} else if (pathWithoutAt.includes("/")) {
 						if (pathWithoutAt.startsWith("~/")) {
 							const homeRelativeDir = pathWithoutAt.slice(2); // Remove ~/
-							const dir = dirname(homeRelativeDir);
-							relativePath = `@~/${dir === "." ? name : join(dir, name)}`;
+							const dir = path.dirname(homeRelativeDir);
+							relativePath = `@~/${dir === "." ? name : path.join(dir, name)}`;
 						} else {
-							relativePath = `@${join(dirname(pathWithoutAt), name)}`;
+							relativePath = `@${path.join(path.dirname(pathWithoutAt), name)}`;
 						}
 					} else {
 						if (pathWithoutAt.startsWith("~")) {
@@ -427,18 +460,18 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 					// Preserve ~/ format for home directory paths
 					if (prefix.startsWith("~/")) {
 						const homeRelativeDir = prefix.slice(2); // Remove ~/
-						const dir = dirname(homeRelativeDir);
-						relativePath = `~/${dir === "." ? name : join(dir, name)}`;
+						const dir = path.dirname(homeRelativeDir);
+						relativePath = `~/${dir === "." ? name : path.join(dir, name)}`;
 					} else if (prefix.startsWith("/")) {
 						// Absolute path - construct properly
-						const dir = dirname(prefix);
+						const dir = path.dirname(prefix);
 						if (dir === "/") {
 							relativePath = `/${name}`;
 						} else {
 							relativePath = `${dir}/${name}`;
 						}
 					} else {
-						relativePath = join(dirname(prefix), name);
+						relativePath = path.join(path.dirname(prefix), name);
 					}
 				} else {
 					// For standalone entries, preserve ~/ if original prefix was ~/
@@ -474,7 +507,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 	// Score an entry against the query (higher = better match)
 	// isDirectory adds bonus to prioritize folders
 	private scoreEntry(filePath: string, query: string, isDirectory: boolean): number {
-		const fileName = basename(filePath);
+		const fileName = path.basename(filePath);
 		const lowerFileName = fileName.toLowerCase();
 		const lowerQuery = query.toLowerCase();
 
@@ -495,34 +528,28 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 		return score;
 	}
 
-	// Fuzzy file search using fd (fast, respects .gitignore)
-	private getFuzzyFileSuggestions(query: string): AutocompleteItem[] {
+	private async getFuzzyFileSuggestions(query: string): Promise<AutocompleteItem[]> {
 		if (!this.fdPath) {
-			// fd not available, return empty results
 			return [];
 		}
 
 		try {
-			const entries = walkDirectoryWithFd(this.basePath, this.fdPath, query, 100);
+			const entries = await walkDirectoryWithFd(this.basePath, this.fdPath, query, 100);
 
-			// Score entries
 			const scoredEntries = entries
-				.map((entry) => ({
+				.map(entry => ({
 					...entry,
 					score: query ? this.scoreEntry(entry.path, query, entry.isDirectory) : 1,
 				}))
-				.filter((entry) => entry.score > 0);
+				.filter(entry => entry.score > 0);
 
-			// Sort by score (descending) and take top 20
 			scoredEntries.sort((a, b) => b.score - a.score);
 			const topEntries = scoredEntries.slice(0, 20);
 
-			// Build suggestions
 			const suggestions: AutocompleteItem[] = [];
 			for (const { path: entryPath, isDirectory } of topEntries) {
-				// fd already includes trailing / for directories
 				const pathWithoutSlash = isDirectory ? entryPath.slice(0, -1) : entryPath;
-				const entryName = basename(pathWithoutSlash);
+				const entryName = path.basename(pathWithoutSlash);
 
 				suggestions.push({
 					value: `@${entryPath}`,
@@ -533,17 +560,16 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 
 			return suggestions;
 		} catch {
-			// Directory doesn't exist or not accessible
 			return [];
 		}
 	}
 
 	// Force file completion (called on Tab key) - always returns suggestions
-	getForceFileSuggestions(
+	async getForceFileSuggestions(
 		lines: string[],
 		cursorLine: number,
 		cursorCol: number,
-	): { items: AutocompleteItem[]; prefix: string } | null {
+	): Promise<{ items: AutocompleteItem[]; prefix: string } | null> {
 		const currentLine = lines[cursorLine] || "";
 		const textBeforeCursor = currentLine.slice(0, cursorCol);
 
@@ -555,7 +581,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 		// Force extract path prefix - this will always return something
 		const pathMatch = this.extractPathPrefix(textBeforeCursor, true);
 		if (pathMatch !== null) {
-			const suggestions = this.getFileSuggestions(pathMatch);
+			const suggestions = await this.getFileSuggestions(pathMatch);
 			if (suggestions.length === 0) return null;
 
 			return {

package/src/components/box.ts

@@ -1,5 +1,5 @@
-import type { Component } from "@oh-my-pi/pi-tui/tui";
-import { applyBackgroundToLine, visibleWidth } from "@oh-my-pi/pi-tui/utils";
+import type { Component } from "../tui";
+import { applyBackgroundToLine, visibleWidth } from "../utils";
 
 /**
  * Box component - a container that applies padding and background to all children

package/src/components/cancellable-loader.ts

@@ -1,4 +1,4 @@
-import { matchesKey } from "@oh-my-pi/pi-tui/keys";
+import { matchesKey } from "../keys";
 import { Loader } from "./loader";
 
 /**

package/src/components/editor.ts

@@ -1,14 +1,8 @@
-import type { AutocompleteProvider, CombinedAutocompleteProvider } from "@oh-my-pi/pi-tui/autocomplete";
-import { matchesKey } from "@oh-my-pi/pi-tui/keys";
-import type { SymbolTheme } from "@oh-my-pi/pi-tui/symbols";
-import { type Component, CURSOR_MARKER, type Focusable } from "@oh-my-pi/pi-tui/tui";
-import {
-	getSegmenter,
-	isPunctuationChar,
-	isWhitespaceChar,
-	truncateToWidth,
-	visibleWidth,
-} from "@oh-my-pi/pi-tui/utils";
+import type { AutocompleteProvider, CombinedAutocompleteProvider } from "../autocomplete";
+import { matchesKey } from "../keys";
+import type { SymbolTheme } from "../symbols";
+import { type Component, CURSOR_MARKER, type Focusable } from "../tui";
+import { getSegmenter, isPunctuationChar, isWhitespaceChar, truncateToWidth, visibleWidth } from "../utils";
 import { SelectList, type SelectListTheme } from "./select-list";
 
 const segmenter = getSegmenter();
@@ -296,6 +290,7 @@ export class Editor implements Component, Focusable {
 	private autocompleteList?: SelectList;
 	private isAutocompleting: boolean = false;
 	private autocompletePrefix: string = "";
+	private autocompleteRequestId: number = 0;
 	public onAutocompleteUpdate?: () => void;
 
 	// Paste tracking for large pastes
@@ -316,6 +311,9 @@ export class Editor implements Component, Focusable {
 	private undoStack: EditorState[] = [];
 	private suspendUndo = false;
 
+	// Debounce timer for autocomplete updates
+	private autocompleteTimeout: ReturnType<typeof setTimeout> | null = null;
+
 	public onSubmit?: (text: string) => void;
 	public onAltEnter?: (text: string) => void;
 	public onChange?: (text: string) => void;
@@ -357,7 +355,7 @@ export class Editor implements Component, Focusable {
 	setHistoryStorage(storage: HistoryStorage): void {
 		this.historyStorage = storage;
 		const recent = storage.getRecent(100);
-		this.history = recent.map((entry) => entry.prompt);
+		this.history = recent.map(entry => entry.prompt);
 		this.historyIndex = -1;
 	}
 
@@ -549,7 +547,7 @@ export class Editor implements Component, Focusable {
 							// Rebuild 'before' without the last grapheme
 							const beforeWithoutLast = beforeGraphemes
 								.slice(0, -1)
-								.map((g) => g.segment)
+								.map(g => g.segment)
 								.join("");
 							displayText = beforeWithoutLast + marker + cursor;
 							displayWidth -= 1; // Back to original width (reverse video replaces, doesn't add)
@@ -1125,8 +1123,8 @@ export class Editor implements Component, Focusable {
 					this.tryTriggerAutocomplete();
 				}
 			}
-			// Also auto-trigger when typing letters in a slash command context
-			else if (/[a-zA-Z0-9.\-_]/.test(char)) {
+			// Also auto-trigger when typing letters/path chars in a slash command context
+			else if (/[a-zA-Z0-9.\-_/]/.test(char)) {
 				const currentLine = this.state.lines[this.state.cursorLine] || "";
 				const textBeforeCursor = currentLine.slice(0, this.state.cursorCol);
 				// Check if we're in a slash command (with or without space for arguments)
@@ -1139,7 +1137,7 @@ export class Editor implements Component, Focusable {
 				}
 			}
 		} else {
-			this.updateAutocomplete();
+			this.debouncedUpdateAutocomplete();
 		}
 	}
 
@@ -1158,7 +1156,7 @@ export class Editor implements Component, Focusable {
 			// Filter out non-printable characters except newlines
 			let filteredText = tabExpandedText
 				.split("")
-				.filter((char) => char === "\n" || char.charCodeAt(0) >= 32)
+				.filter(char => char === "\n" || char.charCodeAt(0) >= 32)
 				.join("");
 
 			// If pasting a file path (starts with /, ~, or .) and the character before
@@ -1302,7 +1300,7 @@ export class Editor implements Component, Focusable {
 
 		// Update or re-trigger autocomplete after backspace
 		if (this.isAutocompleting) {
-			this.updateAutocomplete();
+			this.debouncedUpdateAutocomplete();
 		} else {
 			// If autocomplete was cancelled (no matches), re-trigger if we're in a completable context
 			const currentLine = this.state.lines[this.state.cursorLine] || "";
@@ -1388,7 +1386,7 @@ export class Editor implements Component, Focusable {
 		}
 
 		if (this.isAutocompleting) {
-			this.updateAutocomplete();
+			this.debouncedUpdateAutocomplete();
 		} else {
 			const currentLine = this.state.lines[this.state.cursorLine] || "";
 			const textBeforeCursor = currentLine.slice(0, this.state.cursorCol);
@@ -1613,7 +1611,7 @@ export class Editor implements Component, Focusable {
 
 		// Update or re-trigger autocomplete after forward delete
 		if (this.isAutocompleting) {
-			this.updateAutocomplete();
+			this.debouncedUpdateAutocomplete();
 		} else {
 			const currentLine = this.state.lines[this.state.cursorLine] || "";
 			const textBeforeCursor = currentLine.slice(0, this.state.cursorCol);
@@ -1841,9 +1839,8 @@ export class Editor implements Component, Focusable {
 	}
 
 	// Autocomplete methods
-	private tryTriggerAutocomplete(explicitTab: boolean = false): void {
+	private async tryTriggerAutocomplete(explicitTab: boolean = false): Promise<void> {
 		if (!this.autocompleteProvider) return;
-
 		// Check if we should trigger file completion on Tab
 		if (explicitTab) {
 			const provider = this.autocompleteProvider as CombinedAutocompleteProvider;
@@ -1855,18 +1852,23 @@ export class Editor implements Component, Focusable {
 			}
 		}
 
-		const suggestions = this.autocompleteProvider.getSuggestions(
+		const requestId = ++this.autocompleteRequestId;
+
+		const suggestions = await this.autocompleteProvider.getSuggestions(
 			this.state.lines,
 			this.state.cursorLine,
 			this.state.cursorCol,
 		);
+		if (requestId !== this.autocompleteRequestId) return;
 
 		if (suggestions && suggestions.items.length > 0) {
 			this.autocompletePrefix = suggestions.prefix;
 			this.autocompleteList = new SelectList(suggestions.items, 5, this.theme.selectList);
 			this.isAutocompleting = true;
+			this.onAutocompleteUpdate?.();
 		} else {
 			this.cancelAutocomplete();
+			this.onAutocompleteUpdate?.();
 		}
 	}
 
@@ -1893,7 +1895,7 @@ https://github.com/EsotericSoftware/spine-runtimes/actions/runs/19536643416/job/
 17 this job fails with https://github.com/EsotericSoftware/spine-runtimes/actions/runs/19
 536643416/job/55932288317 havea  look at .gi
     */
-	private forceFileAutocomplete(): void {
+	private async forceFileAutocomplete(): Promise<void> {
 		if (!this.autocompleteProvider) return;
 
 		// Check if provider supports force file suggestions via runtime check
@@ -1901,27 +1903,33 @@ https://github.com/EsotericSoftware/spine-runtimes/actions/runs/19536643416/job/
 			getForceFileSuggestions?: CombinedAutocompleteProvider["getForceFileSuggestions"];
 		};
 		if (typeof provider.getForceFileSuggestions !== "function") {
-			this.tryTriggerAutocomplete(true);
+			await this.tryTriggerAutocomplete(true);
 			return;
 		}
 
-		const suggestions = provider.getForceFileSuggestions(
+		const requestId = ++this.autocompleteRequestId;
+		const suggestions = await provider.getForceFileSuggestions(
 			this.state.lines,
 			this.state.cursorLine,
 			this.state.cursorCol,
 		);
+		if (requestId !== this.autocompleteRequestId) return;
 
 		if (suggestions && suggestions.items.length > 0) {
 			this.autocompletePrefix = suggestions.prefix;
 			this.autocompleteList = new SelectList(suggestions.items, 5, this.theme.selectList);
 			this.isAutocompleting = true;
+			this.onAutocompleteUpdate?.();
 		} else {
 			this.cancelAutocomplete();
+			this.onAutocompleteUpdate?.();
 		}
 	}
 
 	private cancelAutocomplete(notifyCancel: boolean = false): void {
 		const wasAutocompleting = this.isAutocompleting;
+		this.clearAutocompleteTimeout();
+		this.autocompleteRequestId += 1;
 		this.isAutocompleting = false;
 		this.autocompleteList = undefined;
 		this.autocompletePrefix = "";
@@ -1934,21 +1942,42 @@ https://github.com/EsotericSoftware/spine-runtimes/actions/runs/19536643416/job/
 		return this.isAutocompleting;
 	}
 
-	private updateAutocomplete(): void {
+	private async updateAutocomplete(): Promise<void> {
 		if (!this.isAutocompleting || !this.autocompleteProvider) return;
+		const requestId = ++this.autocompleteRequestId;
 
-		const suggestions = this.autocompleteProvider.getSuggestions(
+		const suggestions = await this.autocompleteProvider.getSuggestions(
 			this.state.lines,
 			this.state.cursorLine,
 			this.state.cursorCol,
 		);
+		if (requestId !== this.autocompleteRequestId) return;
 
 		if (suggestions && suggestions.items.length > 0) {
 			this.autocompletePrefix = suggestions.prefix;
 			// Always create new SelectList to ensure update
 			this.autocompleteList = new SelectList(suggestions.items, 5, this.theme.selectList);
+			this.onAutocompleteUpdate?.();
 		} else {
 			this.cancelAutocomplete();
+			this.onAutocompleteUpdate?.();
+		}
+	}
+
+	private debouncedUpdateAutocomplete(): void {
+		if (this.autocompleteTimeout) {
+			clearTimeout(this.autocompleteTimeout);
+		}
+		this.autocompleteTimeout = setTimeout(() => {
+			this.updateAutocomplete();
+			this.autocompleteTimeout = null;
+		}, 100);
+	}
+
+	private clearAutocompleteTimeout(): void {
+		if (this.autocompleteTimeout) {
+			clearTimeout(this.autocompleteTimeout);
+			this.autocompleteTimeout = null;
 		}
 	}
 }

package/src/components/image.ts

@@ -4,8 +4,8 @@ import {
 	type ImageDimensions,
 	imageFallback,
 	renderImage,
-} from "@oh-my-pi/pi-tui/terminal-image";
-import type { Component } from "@oh-my-pi/pi-tui/tui";
+} from "../terminal-image";
+import type { Component } from "../tui";
 
 export interface ImageTheme {
 	fallbackColor: (str: string) => string;