jeopi-tui 16.2.24 → 16.2.26

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [16.2.25] - 2026-07-05
+
+### Added
+
+- Added `priority?: number` to `SlashCommand` (ported from gajae-code): `CombinedAutocompleteProvider`'s slash-command ranking now breaks same-score ties by `priority` (higher first) instead of falling through only to registry order. Text-match quality (exact/prefix/contains/subsequence) still ranks first — `priority` only decides ties within the same score tier, most visibly the bare `/` menu where every command scores 1.
+
 ## [16.2.14] - 2026-07-02
 
 ### Fixed

package/dist/types/autocomplete.d.ts

@@ -18,6 +18,8 @@ export interface SlashCommand {
     name: string;
     aliases?: string[];
     description?: string;
+    /** Ranking boost for the empty-prefix `/` menu and tied fuzzy matches; higher shows first. Commands without a priority default to 0. */
+    priority?: number;
     argumentHint?: string;
     /** Dynamic display-only description for slash-command autocomplete. Must be synchronous and side-effect free. */
     getAutocompleteDescription?: () => string | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "jeopi-tui",
-	"version": "16.2.24",
+	"version": "16.2.26",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://github.com/akillness/jeopi",
 	"author": "Can Boluk",
@@ -37,8 +37,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"jeopi-natives": "16.2.24",
-		"jeopi-utils": "16.2.24",
+		"jeopi-natives": "16.2.26",
+		"jeopi-utils": "16.2.26",
 		"lru-cache": "11.5.1",
 		"marked": "^18.0.5"
 	},

package/src/autocomplete.ts

@@ -181,6 +181,8 @@ export interface SlashCommand {
 	name: string;
 	aliases?: string[];
 	description?: string;
+	/** Ranking boost for the empty-prefix `/` menu and tied fuzzy matches; higher shows first. Commands without a priority default to 0. */
+	priority?: number;
 	argumentHint?: string;
 	/** Dynamic display-only description for slash-command autocomplete. Must be synchronous and side-effect free. */
 	getAutocompleteDescription?: () => string | undefined;
@@ -286,63 +288,74 @@ function scoreCommandTextMatch(lowerPrefix: string, lowerTarget: string): number
 }
 
 function buildSlashCommandCompletions(commands: CommandEntry[], lowerPrefix: string): AutocompleteItem[] {
-	return commands
-		.flatMap(cmd => {
-			const name = getCommandName(cmd);
-			if (!name) return [];
-			const hint = "argumentHint" in cmd && cmd.argumentHint ? cmd.argumentHint : undefined;
-			const staticDesc = getStaticCommandDescription(cmd);
-			let fullDescMemo: string | undefined;
-			let fullDescComputed = false;
-			// Resolve the (possibly live) display description lazily, only once a
-			// candidate actually matches — getAutocompleteDescription reads live
-			// session state and must not run for every command on each keystroke.
-			const resolveFullDesc = (): string | undefined => {
-				if (!fullDescComputed) {
-					const displayDesc = getAutocompleteCommandDescription(cmd);
-					fullDescMemo = hint ? (displayDesc ? `${hint} - ${displayDesc}` : hint) : displayDesc;
-					fullDescComputed = true;
-				}
-				return fullDescMemo;
-			};
-			const candidates: Array<AutocompleteItem & { score: number }> = [];
-
-			const isSkillCommand = name.startsWith("skill:");
-			const nameScore =
-				lowerPrefix.length === 0 && isSkillCommand ? 950 : scoreCommandTextMatch(lowerPrefix, name.toLowerCase());
-			const lowerDesc = staticDesc.toLowerCase();
-			const descScore =
-				lowerDesc && fuzzyMatch(lowerPrefix, lowerDesc) ? fuzzyScore(lowerPrefix, lowerDesc) * 0.5 : 0;
-			const primaryScore = Math.max(nameScore, descScore);
-			if (primaryScore > 0) {
-				const fullDesc = resolveFullDesc();
-				candidates.push({
-					value: name,
-					label: "name" in cmd ? cmd.name : cmd.label,
-					score: primaryScore,
-					...(fullDesc && { description: fullDesc }),
-				});
-			}
-
-			if (lowerPrefix.length > 0) {
-				for (const alias of getCommandAliases(cmd)) {
-					if (alias === name) continue;
-					const aliasScore = scoreCommandTextMatch(lowerPrefix, alias.toLowerCase());
-					if (aliasScore === 0) continue;
+	return (
+		commands
+			.flatMap(cmd => {
+				const name = getCommandName(cmd);
+				if (!name) return [];
+				const hint = "argumentHint" in cmd && cmd.argumentHint ? cmd.argumentHint : undefined;
+				const staticDesc = getStaticCommandDescription(cmd);
+				let fullDescMemo: string | undefined;
+				let fullDescComputed = false;
+				// Resolve the (possibly live) display description lazily, only once a
+				// candidate actually matches — getAutocompleteDescription reads live
+				// session state and must not run for every command on each keystroke.
+				const resolveFullDesc = (): string | undefined => {
+					if (!fullDescComputed) {
+						const displayDesc = getAutocompleteCommandDescription(cmd);
+						fullDescMemo = hint ? (displayDesc ? `${hint} - ${displayDesc}` : hint) : displayDesc;
+						fullDescComputed = true;
+					}
+					return fullDescMemo;
+				};
+				const candidates: Array<AutocompleteItem & { score: number; priority: number }> = [];
+				const priority = "priority" in cmd && typeof cmd.priority === "number" ? cmd.priority : 0;
+
+				const isSkillCommand = name.startsWith("skill:");
+				const nameScore =
+					lowerPrefix.length === 0 && isSkillCommand
+						? 950
+						: scoreCommandTextMatch(lowerPrefix, name.toLowerCase());
+				const lowerDesc = staticDesc.toLowerCase();
+				const descScore =
+					lowerDesc && fuzzyMatch(lowerPrefix, lowerDesc) ? fuzzyScore(lowerPrefix, lowerDesc) * 0.5 : 0;
+				const primaryScore = Math.max(nameScore, descScore);
+				if (primaryScore > 0) {
 					const fullDesc = resolveFullDesc();
 					candidates.push({
-						value: alias,
-						label: alias,
-						score: aliasScore,
+						value: name,
+						label: "name" in cmd ? cmd.name : cmd.label,
+						score: primaryScore,
+						priority,
 						...(fullDesc && { description: fullDesc }),
 					});
 				}
-			}
 
-			return candidates;
-		})
-		.sort((a, b) => b.score - a.score)
-		.map(({ score: _, ...rest }) => rest);
+				if (lowerPrefix.length > 0) {
+					for (const alias of getCommandAliases(cmd)) {
+						if (alias === name) continue;
+						const aliasScore = scoreCommandTextMatch(lowerPrefix, alias.toLowerCase());
+						if (aliasScore === 0) continue;
+						const fullDesc = resolveFullDesc();
+						candidates.push({
+							value: alias,
+							label: alias,
+							score: aliasScore,
+							priority,
+							...(fullDesc && { description: fullDesc }),
+						});
+					}
+				}
+
+				return candidates;
+			})
+			// Score ranks fuzzy-match quality first (exact/prefix/contains/subsequence);
+			// `priority` only breaks ties within the same score tier — most visibly the
+			// empty-prefix `/` menu, where every command scores 1 and priority alone
+			// decides display order (e.g. `/help`, `/new`, `/resume` surface first).
+			.sort((a, b) => b.score - a.score || b.priority - a.priority)
+			.map(({ score: _score, priority: _priority, ...rest }) => rest)
+	);
 }
 
 function hasPromptTextBeforeSlash(