@gajae-code/tui 0.12.12 → 0.12.13

package/CHANGELOG.md

@@ -2,9 +2,12 @@
 
 ## [Unreleased]
 
+## [0.12.13] - 2026-08-06
+
 ## [0.12.12] - 2026-08-05
 ### Fixed
 
+- Applied the compact 12–32-column primary layout to slash-command autocomplete while leaving file and other completion lists on their existing layout.
 - Restored 60 fps time-dependent loader gradients on direct local terminals while retaining the 80 ms cadence and congestion dropping on SSH and multiplexed terminals.
 - Bounded loader animation scheduling to 80 ms, stopped OSC 11 polling after DA1 proves the query unsupported while preserving Mode 2031 recovery, and added the default-on `GJC_TUI_SYNCHRONIZED_OUTPUT=0` compatibility opt-out for terminal parsers that mishandle synchronized-output framing. Real iOS-client validation remains pending for #3798.
 - Decorative animation ticks now pause while stdout has more than 64 KiB buffered, preventing slow SSH terminals and multiplexers from accumulating stale spinner frames.

package/dist/types/autocomplete.d.ts

@@ -8,6 +8,12 @@ export interface AutocompleteItem {
     /** Dim hint text shown inline after cursor when this item is selected */
     hint?: string;
 }
+export type AutocompleteSuggestionKind = "slash-command" | "default";
+export interface AutocompleteSuggestions {
+    items: AutocompleteItem[];
+    prefix: string;
+    kind?: AutocompleteSuggestionKind;
+}
 type Awaitable<T> = T | Promise<T>;
 export interface SlashCommand {
     name: string;
@@ -24,10 +30,7 @@ export interface SlashCommand {
 }
 export interface AutocompleteProvider {
     /** Get autocomplete suggestions for current text/cursor position */
-    getSuggestions(lines: string[], cursorLine: number, cursorCol: number): Promise<{
-        items: AutocompleteItem[];
-        prefix: string;
-    } | null>;
+    getSuggestions(lines: string[], cursorLine: number, cursorCol: number): Promise<AutocompleteSuggestions | null>;
     /** Apply the selected item and return new text + cursor position */
     applyCompletion(lines: string[], cursorLine: number, cursorCol: number, item: AutocompleteItem, prefix: string): {
         lines: string[];
@@ -59,10 +62,7 @@ export interface AutocompleteProvider {
 export declare class CombinedAutocompleteProvider implements AutocompleteProvider {
     #private;
     constructor(commands?: (SlashCommand | AutocompleteItem)[], basePath?: string);
-    getSuggestions(lines: string[], cursorLine: number, cursorCol: number): Promise<{
-        items: AutocompleteItem[];
-        prefix: string;
-    } | null>;
+    getSuggestions(lines: string[], cursorLine: number, cursorCol: number): Promise<AutocompleteSuggestions | null>;
     applyCompletion(lines: string[], cursorLine: number, cursorCol: number, item: AutocompleteItem, prefix: string): {
         lines: string[];
         cursorLine: number;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/tui",
-	"version": "0.12.12",
+	"version": "0.12.13",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://gajae-code.com",
 	"author": "Yeachan-Heo and Gajae Code Contributors",
@@ -36,8 +36,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@gajae-code/natives": "0.12.12",
-		"@gajae-code/utils": "0.12.12",
+		"@gajae-code/natives": "0.12.13",
+		"@gajae-code/utils": "0.12.13",
 		"lru-cache": "11.3.6",
 		"marked": "18.0.6"
 	},

package/src/autocomplete.ts

@@ -242,6 +242,13 @@ export interface AutocompleteItem {
 	/** Dim hint text shown inline after cursor when this item is selected */
 	hint?: string;
 }
+export type AutocompleteSuggestionKind = "slash-command" | "default";
+
+export interface AutocompleteSuggestions {
+	items: AutocompleteItem[];
+	prefix: string;
+	kind?: AutocompleteSuggestionKind;
+}
 
 type Awaitable<T> = T | Promise<T>;
 
@@ -263,14 +270,7 @@ export interface SlashCommand {
 
 export interface AutocompleteProvider {
 	/** Get autocomplete suggestions for current text/cursor position */
-	getSuggestions(
-		lines: string[],
-		cursorLine: number,
-		cursorCol: number,
-	): Promise<{
-		items: AutocompleteItem[];
-		prefix: string; // What we're matching against (e.g., "/" or "src/")
-	} | null>;
+	getSuggestions(lines: string[], cursorLine: number, cursorCol: number): Promise<AutocompleteSuggestions | null>;
 
 	/** Apply the selected item and return new text + cursor position */
 	applyCompletion(
@@ -381,7 +381,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 		lines: string[],
 		cursorLine: number,
 		cursorCol: number,
-	): Promise<{ items: AutocompleteItem[]; prefix: string } | null> {
+	): Promise<AutocompleteSuggestions | null> {
 		const currentLine = lines[cursorLine] || "";
 		const textBeforeCursor = currentLine.slice(0, cursorCol);
 
@@ -403,6 +403,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 			return {
 				items: suggestions,
 				prefix: atPrefix,
+				kind: "default",
 			};
 		}
 
@@ -419,6 +420,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 
 				return {
 					items: matches,
+					kind: "slash-command",
 					prefix: textBeforeCursor,
 				};
 			}
@@ -439,6 +441,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 
 			return {
 				items: argumentSuggestions,
+				kind: "default",
 				prefix: argumentText,
 			};
 		}
@@ -452,6 +455,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 				if (pathSuggestions.length > 0) {
 					return {
 						items: pathSuggestions,
+						kind: "default",
 						prefix: pathMatch,
 					};
 				}
@@ -461,6 +465,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 			if (matches.length > 0) {
 				return {
 					items: matches,
+					kind: "slash-command",
 					prefix: slashPrefix,
 				};
 			}
@@ -479,12 +484,14 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 				// We still return it so user can select it and add /
 				return {
 					items: suggestions,
+					kind: "default",
 					prefix: pathMatch,
 				};
 			}
 
 			return {
 				items: suggestions,
+				kind: "default",
 				prefix: pathMatch,
 			};
 		}

package/src/components/editor.ts

@@ -1,6 +1,7 @@
 import { getProjectDir, logger, onDefaultTabWidthChange } from "@gajae-code/utils";
 import {
 	type AutocompleteProvider,
+	type AutocompleteSuggestionKind,
 	type CombinedAutocompleteProvider,
 	extractSlashCommandTokenPrefix,
 	isInsideInlineCodeSpan,
@@ -2838,11 +2839,7 @@ export class Editor implements Component, Focusable {
 		);
 	}
 
-	#isSlashCommandNameAutocompleteSelection(): boolean {
-		if (this.#autocompleteState !== "regular") {
-			return false;
-		}
-
+	#isSlashCommandNameAutocompleteContext(): boolean {
 		const currentLine = this.#state.lines[this.#state.cursorLine] || "";
 		const textBeforeCursor = currentLine.slice(0, this.#state.cursorCol).trimStart();
 		return (
@@ -2850,6 +2847,14 @@ export class Editor implements Component, Focusable {
 		);
 	}
 
+	#isSlashCommandNameAutocompleteSelection(): boolean {
+		if (this.#autocompleteState !== "regular") {
+			return false;
+		}
+
+		return this.#isSlashCommandNameAutocompleteContext();
+	}
+
 	#isCompletedSlashCommandAtCursor(): boolean {
 		const currentLine = this.#state.lines[this.#state.cursorLine] || "";
 		if (this.#state.cursorCol !== currentLine.length) {
@@ -2890,7 +2895,7 @@ export class Editor implements Component, Focusable {
 
 		if (suggestions && Array.isArray(suggestions.items) && suggestions.items.length > 0) {
 			this.#autocompletePrefix = suggestions.prefix;
-			this.#autocompleteList = this.#createAutocompleteList(suggestions.prefix, suggestions.items);
+			this.#autocompleteList = this.#createAutocompleteList(suggestions.items, suggestions.kind ?? "default");
 			this.#autocompleteState = "regular";
 			this.#autocompleteOrigin = origin;
 			this.onAutocompleteUpdate?.();
@@ -2901,14 +2906,11 @@ export class Editor implements Component, Focusable {
 		}
 	}
 	#createAutocompleteList(
-		prefix: string,
 		items: Array<{ value: string; label: string; description?: string }>,
+		kind: AutocompleteSuggestionKind,
 	): SelectList {
-		// Layout options prepared for future SelectList enhancements (e.g., for slash commands)
-		const layout = prefix.startsWith("/") ? SLASH_COMMAND_SELECT_LIST_LAYOUT : undefined;
-		// TODO: Pass layout to SelectList when constructor is updated to support it
-		void layout; // Use layout variable to avoid lint warnings
-		return new SelectList(items, this.#autocompleteMaxVisible, this.#theme.selectList);
+		const layout = kind === "slash-command" ? SLASH_COMMAND_SELECT_LIST_LAYOUT : undefined;
+		return new SelectList(items, this.#autocompleteMaxVisible, this.#theme.selectList, layout);
 	}
 
 	#handleTabCompletion(): void {
@@ -2985,7 +2987,7 @@ https://github.com/EsotericSoftware/spine-runtimes/actions/runs/19536643416/job/
 			}
 
 			this.#autocompletePrefix = suggestions.prefix;
-			this.#autocompleteList = this.#createAutocompleteList(suggestions.prefix, suggestions.items);
+			this.#autocompleteList = this.#createAutocompleteList(suggestions.items, "default");
 			this.#autocompleteState = "force";
 			this.#autocompleteOrigin = origin;
 			this.onAutocompleteUpdate?.();
@@ -3035,7 +3037,7 @@ https://github.com/EsotericSoftware/spine-runtimes/actions/runs/19536643416/job/
 		if (suggestions && Array.isArray(suggestions.items) && suggestions.items.length > 0) {
 			this.#autocompletePrefix = suggestions.prefix;
 			// Always create new SelectList to ensure update
-			this.#autocompleteList = this.#createAutocompleteList(suggestions.prefix, suggestions.items);
+			this.#autocompleteList = this.#createAutocompleteList(suggestions.items, suggestions.kind ?? "default");
 			this.#autocompleteOrigin = origin;
 			this.onAutocompleteUpdate?.();
 		} else {