@gajae-code/tui 0.15.4 → 0.15.6

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## [Unreleased]
 
+## [0.15.6] - 2026-08-30
+
+### Fixed
+
+- Composer file autocomplete now keeps the `@` fuzzy/chosung path reachable from explicit Tab and while Korean query characters are typed, without changing ordinary path-prefix completion.
+
+## [0.15.5] - 2026-08-29
+
+### Added
+
+- `@` fuzzy file search supports Hangul chosung (초성) matching: a bare consonant matches any syllable with that initial, so `@ㅎㄱ` finds `한글.txt`. Literal and full-syllable matches keep ranking above chosung matches.
+
 ## [0.15.4] - 2026-08-29
 
 ### Fixed

package/dist/types/autocomplete.d.ts

@@ -1,3 +1,17 @@
+export declare function normalizeFuzzyText(value: string): string;
+/**
+ * Check if query is a subsequence of target (fuzzy match).
+ * "wig" matches "skill:wig" because w-i-g appear in order.
+ * A bare Hangul consonant also matches a syllable's initial (초성 검색),
+ * so "ㅎㄱ" matches "한글".
+ */
+declare function fuzzyMatch(query: string, target: string): boolean;
+/**
+ * Score a fuzzy match. Higher = better match.
+ * Prioritizes: exact match > starts-with > contains > subsequence
+ */
+declare function fuzzyScore(query: string, target: string): number;
+export { fuzzyMatch as autocompleteFuzzyMatch, fuzzyScore as autocompleteFuzzyScore };
 export declare function getSlashCommandMatchRank(query: string, commandName: string): number;
 export declare function isInsideInlineCodeSpan(text: string): boolean;
 export declare function extractSlashCommandTokenPrefix(text: string): string | null;
@@ -82,4 +96,3 @@ export declare class CombinedAutocompleteProvider implements AutocompleteProvide
         prefix: string;
     } | null;
 }
-export {};

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/tui",
-	"version": "0.15.4",
+	"version": "0.15.6",
 	"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.15.4",
-		"@gajae-code/utils": "0.15.4",
+		"@gajae-code/natives": "0.15.6",
+		"@gajae-code/utils": "0.15.6",
 		"lru-cache": "11.3.6",
 		"marked": "18.0.6"
 	},

package/src/autocomplete.ts

@@ -17,6 +17,7 @@ async function fuzzyFindNative(): Promise<NativeFuzzyFind> {
 }
 
 const PATH_DELIMITERS = new Set([" ", "\t", '"', "'", "="]);
+const MAX_AUTOCOMPLETE_SUGGESTIONS = 100;
 
 function isAbsolutePathLike(value: string): boolean {
 	return path.isAbsolute(value) || path.win32.isAbsolute(value);
@@ -121,9 +122,30 @@ function buildCompletionValue(
 	return `${openQuote}${path}${closeQuote}`;
 }
 
+const HANGUL_INITIAL_COMPAT_JAMO = "ㄱㄲㄴㄷㄸㄹㅁㅂㅃㅅㅆㅇㅈㅉㅊㅋㅌㅍㅎ";
+
+function hangulInitialJamo(char: string): string | undefined {
+	const offset = char.charCodeAt(0) - 0xac00;
+	if (offset < 0 || offset >= 11172) return undefined;
+	return HANGUL_INITIAL_COMPAT_JAMO[Math.floor(offset / 588)];
+}
+
+function fuzzyCharMatches(queryChar: string, targetChar: string): boolean {
+	return queryChar === targetChar || hangulInitialJamo(targetChar) === queryChar;
+}
+
+export function normalizeFuzzyText(value: string): string {
+	return value
+		.normalize("NFC")
+		.toLowerCase()
+		.replace(/[\s/\\._-]+/g, "");
+}
+
 /**
  * Check if query is a subsequence of target (fuzzy match).
  * "wig" matches "skill:wig" because w-i-g appear in order.
+ * A bare Hangul consonant also matches a syllable's initial (초성 검색),
+ * so "ㅎㄱ" matches "한글".
  */
 function fuzzyMatch(query: string, target: string): boolean {
 	if (query.length === 0) return true;
@@ -131,7 +153,7 @@ function fuzzyMatch(query: string, target: string): boolean {
 
 	let qi = 0;
 	for (let ti = 0; ti < target.length && qi < query.length; ti++) {
-		if (query[qi] === target[ti]) qi++;
+		if (fuzzyCharMatches(query[qi] as string, target[ti] as string)) qi++;
 	}
 	return qi === query.length;
 }
@@ -152,7 +174,7 @@ function fuzzyScore(query: string, target: string): number {
 	let gaps = 0;
 	let lastMatchIdx = -1;
 	for (let ti = 0; ti < target.length && qi < query.length; ti++) {
-		if (query[qi] === target[ti]) {
+		if (fuzzyCharMatches(query[qi] as string, target[ti] as string)) {
 			if (lastMatchIdx >= 0 && ti - lastMatchIdx > 1) gaps++;
 			lastMatchIdx = ti;
 			qi++;
@@ -163,6 +185,8 @@ function fuzzyScore(query: string, target: string): number {
 	// Base score 40 for subsequence, minus penalty for gaps
 	return Math.max(1, 40 - gaps * 5);
 }
+
+export { fuzzyMatch as autocompleteFuzzyMatch, fuzzyScore as autocompleteFuzzyScore };
 export function getSlashCommandMatchRank(query: string, commandName: string): number {
 	const normalizedQuery = normalizeSlashCommandText(query);
 	if (normalizedQuery.length === 0) return 4;
@@ -328,22 +352,32 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 
 	#getSlashCommandNameSuggestions(prefix: string): AutocompleteItem[] {
 		const lowerPrefix = prefix.toLowerCase();
+		const normalizedPrefix = normalizeFuzzyText(prefix);
+		if (prefix.length > 0 && normalizedPrefix.length === 0) return [];
 
 		return this.#commands
 			.filter(cmd => {
 				const name = this.#getCommandName(cmd);
 				if (!name) return false;
-				if (fuzzyMatch(lowerPrefix, name.toLowerCase())) return true;
-				if (getSlashCommandMatchRank(lowerPrefix, name.toLowerCase()) < 4) return true;
-				const desc = cmd.description?.toLowerCase();
-				return desc ? fuzzyMatch(lowerPrefix, desc) : false;
+				const lowerName = name.toLowerCase();
+				if (fuzzyMatch(normalizedPrefix, normalizeFuzzyText(name))) return true;
+				const isAscii = /^[\x00-\x7F]*$/.test(`${prefix}${name}`);
+				if (isAscii && getSlashCommandMatchRank(lowerPrefix, lowerName) < 4) return true;
+				const desc = cmd.description;
+				return desc ? fuzzyMatch(normalizedPrefix, normalizeFuzzyText(desc)) : false;
 			})
 			.map((cmd, index) => {
 				const name = this.#getCommandName(cmd);
 				const lowerName = name?.toLowerCase() ?? "";
-				const lowerDesc = cmd.description?.toLowerCase() ?? "";
-				const nameScore = fuzzyMatch(lowerPrefix, lowerName) ? fuzzyScore(lowerPrefix, lowerName) : 0;
-				const descScore = fuzzyMatch(lowerPrefix, lowerDesc) ? fuzzyScore(lowerPrefix, lowerDesc) * 0.5 : 0;
+				const lowerDesc = cmd.description ?? "";
+				const normalizedName = normalizeFuzzyText(name);
+				const normalizedDesc = normalizeFuzzyText(lowerDesc);
+				const nameScore = fuzzyMatch(normalizedPrefix, normalizedName)
+					? fuzzyScore(normalizedPrefix, normalizedName)
+					: 0;
+				const descScore = fuzzyMatch(normalizedPrefix, normalizedDesc)
+					? fuzzyScore(normalizedPrefix, normalizedDesc) * 0.5
+					: 0;
 				const hint = "argumentHint" in cmd && cmd.argumentHint ? cmd.argumentHint : undefined;
 				const desc = cmd.description ?? "";
 				const fullDesc = hint ? (desc ? `${hint} — ${desc}` : hint) : desc;
@@ -353,7 +387,9 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 					label: "name" in cmd ? cmd.name : cmd.label,
 					score: Math.max(nameScore, descScore),
 					priority,
-					matchRank: getSlashCommandMatchRank(lowerPrefix, lowerName),
+					matchRank: /^[\x00-\x7F]*$/.test(`${prefix}${name}`)
+						? getSlashCommandMatchRank(lowerPrefix, lowerName)
+						: 4,
 					index,
 					...(fullDesc && { description: fullDesc }),
 				} as AutocompleteItem & { score: number; priority: number; matchRank: number; index: number };
@@ -373,16 +409,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 		// Check for @ file reference (fuzzy search) - must be after a delimiter or at start
 		const atPrefix = this.#extractAtPrefix(textBeforeCursor);
 		if (atPrefix) {
-			const { rawPrefix, isQuotedPrefix } = parsePathPrefix(atPrefix);
-			const suggestions =
-				rawPrefix.length > 0
-					? await this.#getFuzzyFileSuggestions(rawPrefix, { isQuotedPrefix })
-					: await this.#getFileSuggestions("@");
-			if (suggestions.length === 0 && rawPrefix.length > 0) {
-				const fallback = await this.#getFileSuggestions(atPrefix);
-				if (fallback.length === 0) return null;
-				return { items: fallback, prefix: atPrefix };
-			}
+			const suggestions = await this.#getAtFileSuggestions(atPrefix);
 			if (suggestions.length === 0) return null;
 
 			return {
@@ -837,14 +864,14 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 			const searchPath = scopedQuery?.baseDir ?? this.#basePath;
 			const fuzzyQuery = scopedQuery?.query ?? query;
 			const result = await (await fuzzyFindNative())(buildAutocompleteFuzzyDiscoveryProfile(fuzzyQuery, searchPath));
-			const lowerQuery = fuzzyQuery.normalize("NFC").toLowerCase();
+			const normalizedQuery = normalizeFuzzyText(fuzzyQuery);
 			const filteredMatches = result.matches.filter(entry => {
 				const p = entry.path.endsWith("/") ? entry.path.slice(0, -1) : entry.path;
 				const normalized = p.replaceAll("\\", "/");
 				if (/(^|\/)\.git(\/|$)/.test(normalized)) {
 					return false;
 				}
-				return lowerQuery.length === 0 || fuzzyMatch(lowerQuery, normalized.normalize("NFC").toLowerCase());
+				return normalizedQuery.length === 0 || fuzzyMatch(normalizedQuery, normalizeFuzzyText(normalized));
 			});
 			const topEntries = filteredMatches.slice(0, 20);
 			const suggestions: AutocompleteItem[] = [];
@@ -872,6 +899,23 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 		}
 	}
 
+	async #getAtFileSuggestions(atPrefix: string): Promise<AutocompleteItem[]> {
+		const prefixSuggestions = await this.#getFileSuggestions(atPrefix);
+		const { rawPrefix, isQuotedPrefix } = parsePathPrefix(atPrefix);
+		if (rawPrefix.length === 0) return prefixSuggestions.slice(0, MAX_AUTOCOMPLETE_SUGGESTIONS);
+
+		const fuzzySuggestions = await this.#getFuzzyFileSuggestions(rawPrefix, { isQuotedPrefix });
+		const seen = new Set(fuzzySuggestions.map(item => item.value));
+		return [
+			...fuzzySuggestions,
+			...prefixSuggestions.filter(item => {
+				if (seen.has(item.value)) return false;
+				seen.add(item.value);
+				return true;
+			}),
+		].slice(0, MAX_AUTOCOMPLETE_SUGGESTIONS);
+	}
+
 	// Force file completion (called on Tab key) - always returns suggestions
 	async getForceFileSuggestions(
 		lines: string[],
@@ -887,6 +931,14 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 		}
 
 		// Force extract path prefix - this will always return something
+		const atPrefix = this.#extractAtPrefix(textBeforeCursor);
+		if (atPrefix !== null) {
+			const suggestions = await this.#getAtFileSuggestions(atPrefix);
+			if (suggestions.length === 0) return null;
+
+			return { items: suggestions, prefix: atPrefix };
+		}
+
 		const pathMatch = this.#extractPathPrefix(textBeforeCursor, true);
 		if (pathMatch !== null) {
 			const suggestions = await this.#getFileSuggestions(pathMatch);

package/src/components/editor.ts

@@ -1994,7 +1994,7 @@ export class Editor implements Component, Focusable {
 				this.#tryTriggerAutocomplete();
 			}
 			// Also auto-trigger when typing letters/path chars in a completable context
-			else if (/[a-zA-Z0-9.\-_/]/.test(char)) {
+			else if (/[\p{L}0-9.\-_/]/u.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 or inline slash token