@arthony/keybook 0.5.0 → 0.6.0

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { spawn, spawnSync } from "node:child_process";
-import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { Command } from "commander";
@@ -868,6 +868,52 @@ function copyToClipboard(text) {
 	}
 }
 //#endregion
+//#region src/data/favorites.ts
+const SEP = "\0";
+function favKey(app, action) {
+	return `${app}${SEP}${action}`;
+}
+function favoritesPath(dir) {
+	return join(dir, "favorites.json");
+}
+/** Read favorites.json -> Set of favKeys. Missing/malformed -> empty set (never throws). */
+function loadFavorites(dir) {
+	const set = /* @__PURE__ */ new Set();
+	try {
+		const data = JSON.parse(readFileSync(favoritesPath(dir), "utf8"));
+		const list = Array.isArray(data?.favorites) ? data.favorites : [];
+		for (const f of list) if (f && typeof f.app === "string" && typeof f.action === "string") set.add(favKey(f.app, f.action));
+	} catch {}
+	return set;
+}
+/** Atomic write (temp + rename) of the favKey set back to favorites.json. */
+function saveFavorites(dir, keys) {
+	const data = {
+		version: 1,
+		favorites: [...keys].map((k) => {
+			const i = k.indexOf(SEP);
+			return {
+				app: k.slice(0, i),
+				action: k.slice(i + 1)
+			};
+		})
+	};
+	const path = favoritesPath(dir);
+	const tmp = `${path}.tmp`;
+	writeFileSync(tmp, `${JSON.stringify(data, null, 2)}
+`, "utf8");
+	renameSync(tmp, path);
+}
+/** Toggle one favorite, persist, and return the new set. */
+function toggleFavorite(dir, app, action) {
+	const keys = loadFavorites(dir);
+	const k = favKey(app, action);
+	if (keys.has(k)) keys.delete(k);
+	else keys.add(k);
+	saveFavorites(dir, keys);
+	return keys;
+}
+//#endregion
 //#region src/search.ts
 function haystack(e) {
 	return [
@@ -888,8 +934,109 @@ function search(entries, query) {
 	}).find(q).map((r) => r.item);
 }
 //#endregion
+//#region src/tui/FilterPicker.tsx
+function FilterPicker({ apps, onSelect, onCancel, height = 16, width = 40 }) {
+	const [query, setQuery] = useState("");
+	const [selected, setSelected] = useState(0);
+	const matchedApps = useMemo(() => {
+		const q = query.trim().toLowerCase();
+		return q ? apps.filter((a) => a.toLowerCase().includes(q)) : apps;
+	}, [apps, query]);
+	const total = 2 + matchedApps.length;
+	const sel = Math.min(selected, Math.max(0, total - 1));
+	useInput((input, key) => {
+		if (key.escape || key.ctrl && input === "f") return onCancel();
+		if (key.downArrow || key.ctrl && input === "n") {
+			setSelected((s) => Math.min(s + 1, total - 1));
+			return;
+		}
+		if (key.upArrow || key.ctrl && input === "p") {
+			setSelected((s) => Math.max(s - 1, 0));
+			return;
+		}
+		if (key.return) {
+			if (sel === 0) return onSelect({ type: "favorites" });
+			if (sel === 1) return onSelect({ type: "all" });
+			const app = matchedApps[sel - 2];
+			if (app) return onSelect({
+				type: "app",
+				app
+			});
+			return;
+		}
+		if (key.backspace || key.delete) {
+			setQuery((q) => q.slice(0, -1));
+			setSelected(0);
+			return;
+		}
+		if (input && !key.ctrl && !key.meta) {
+			setQuery((q) => q + input);
+			setSelected(2);
+		}
+	});
+	const bodyHeight = Math.max(1, height - 2);
+	const appSel = Math.max(0, sel - 2);
+	const startApp = matchedApps.length > bodyHeight ? Math.max(0, Math.min(appSel - Math.floor(bodyHeight / 2), matchedApps.length - bodyHeight)) : 0;
+	const visibleApps = matchedApps.slice(startApp, startApp + bodyHeight);
+	const row = (text, idx) => {
+		const isSel = idx === sel;
+		return /* @__PURE__ */ jsxs(Text, {
+			wrap: "truncate-end",
+			color: isSel ? "cyan" : void 0,
+			inverse: isSel,
+			children: [isSel ? "▸ " : "  ", text]
+		}, `${idx}:${text}`);
+	};
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		borderStyle: "round",
+		paddingX: 1,
+		width,
+		children: [
+			/* @__PURE__ */ jsx(Text, {
+				wrap: "truncate-end",
+				color: "cyan",
+				children: "Filter by app"
+			}),
+			/* @__PURE__ */ jsxs(Text, {
+				wrap: "truncate-end",
+				children: [query ? query : /* @__PURE__ */ jsx(Text, {
+					color: "gray",
+					children: "type to filter…"
+				}), /* @__PURE__ */ jsx(Text, {
+					inverse: true,
+					children: " "
+				})]
+			}),
+			row("★ Favorites", 0),
+			row("All apps", 1),
+			/* @__PURE__ */ jsx(Text, {
+				wrap: "truncate-end",
+				color: "gray",
+				children: "──────────────"
+			}),
+			startApp > 0 ? /* @__PURE__ */ jsxs(Text, {
+				wrap: "truncate-end",
+				color: "gray",
+				children: [" ", "↑ more"]
+			}) : null,
+			visibleApps.map((app, i) => row(app, startApp + i + 2)),
+			startApp + bodyHeight < matchedApps.length ? /* @__PURE__ */ jsxs(Text, {
+				wrap: "truncate-end",
+				color: "gray",
+				children: [" ", "↓ more"]
+			}) : null,
+			/* @__PURE__ */ jsx(Text, {
+				wrap: "truncate-end",
+				color: "gray",
+				children: "↑↓ move ⏎ select ⎋ cancel"
+			})
+		]
+	});
+}
+//#endregion
 //#region src/tui/Footer.tsx
-function Footer({ flash, errorCount, resultCount, confirm }) {
+function Footer({ flash, errorCount, resultCount, confirm, filterActive = false }) {
 	if (confirm) return /* @__PURE__ */ jsxs(Box, {
 		marginTop: 1,
 		justifyContent: "space-between",
@@ -906,19 +1053,17 @@ function Footer({ flash, errorCount, resultCount, confirm }) {
 	return /* @__PURE__ */ jsxs(Box, {
 		marginTop: 1,
 		justifyContent: "space-between",
-		children: [/* @__PURE__ */ jsxs(Text, {
+		children: [/* @__PURE__ */ jsx(Text, {
 			color: "gray",
 			wrap: "truncate-end",
-			children: [
-				"↑↓ move ⏎ copy ⌃O add ⌃E edit ⌃X del ⎋ quit ⌃U clear (",
-				resultCount,
-				")"
-			]
+			children: `↑↓ move ⏎ copy ⌃O add ⌃E edit ⌃X del ⌃F filter ⌃S star ${filterActive ? "⎋ clear filter" : "⎋ quit"} ⌃U clear (${resultCount})`
 		}), flash ? /* @__PURE__ */ jsx(Text, {
 			color: "green",
+			wrap: "truncate-end",
 			children: flash
 		}) : errorCount > 0 ? /* @__PURE__ */ jsxs(Text, {
 			color: "yellow",
+			wrap: "truncate-end",
 			children: [
 				"⚠ ",
 				errorCount,
@@ -973,7 +1118,7 @@ function PreviewPane({ entry, width = "50%" }) {
 }
 //#endregion
 //#region src/tui/ResultRow.tsx
-function ResultRow({ entry, selected }) {
+function ResultRow({ entry, selected, favorite = false }) {
 	const right = entry.keys ?? "recipe";
 	return /* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsxs(Text, {
 		wrap: "truncate-end",
@@ -982,6 +1127,7 @@ function ResultRow({ entry, selected }) {
 			inverse: selected,
 			children: [
 				selected ? "▸ " : "  ",
+				favorite ? "★ " : "  ",
 				entry.app,
 				" · ",
 				entry.action
@@ -994,17 +1140,13 @@ function ResultRow({ entry, selected }) {
 }
 //#endregion
 //#region src/tui/ResultList.tsx
-function ResultList({ results, selected, query, height = 12, width = "50%" }) {
+function ResultList({ results, selected, query, height = 12, width = "50%", favorites, emptyMessage }) {
 	if (results.length === 0) return /* @__PURE__ */ jsx(Box, {
 		width,
 		justifyContent: "center",
-		children: /* @__PURE__ */ jsxs(Text, {
+		children: /* @__PURE__ */ jsx(Text, {
 			color: "gray",
-			children: [
-				"No matches for \"",
-				query,
-				"\""
-			]
+			children: emptyMessage ?? `No matches for "${query}"`
 		})
 	});
 	const start = Math.max(0, Math.min(selected - Math.floor(height / 2), results.length - height));
@@ -1013,27 +1155,35 @@ function ResultList({ results, selected, query, height = 12, width = "50%" }) {
 		width,
 		children: results.slice(Math.max(0, start), Math.max(0, start) + height).map((e, i) => /* @__PURE__ */ jsx(ResultRow, {
 			entry: e,
-			selected: Math.max(0, start) + i === selected
+			selected: Math.max(0, start) + i === selected,
+			favorite: favorites?.has(favKey(e.app, e.action)) ?? false
 		}, `${e.app}:${e.action}`))
 	});
 }
 //#endregion
 //#region src/tui/SearchInput.tsx
-function SearchInput({ query }) {
-	return /* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsxs(Text, {
-		wrap: "truncate-end",
-		children: [
-			/* @__PURE__ */ jsx(Text, {
-				color: "cyan",
-				children: "search: "
-			}),
-			/* @__PURE__ */ jsx(Text, { children: query }),
-			/* @__PURE__ */ jsx(Text, {
-				inverse: true,
-				children: " "
-			})
-		]
-	}) });
+function SearchInput({ query, filterLabel }) {
+	return /* @__PURE__ */ jsxs(Box, {
+		justifyContent: "space-between",
+		children: [/* @__PURE__ */ jsxs(Text, {
+			wrap: "truncate-end",
+			children: [
+				/* @__PURE__ */ jsx(Text, {
+					color: "cyan",
+					children: "search: "
+				}),
+				/* @__PURE__ */ jsx(Text, { children: query }),
+				/* @__PURE__ */ jsx(Text, {
+					inverse: true,
+					children: " "
+				})
+			]
+		}), filterLabel ? /* @__PURE__ */ jsx(Text, {
+			color: "gray",
+			wrap: "truncate-end",
+			children: filterLabel
+		}) : null]
+	});
 }
 //#endregion
 //#region src/tui/input.ts
@@ -1078,6 +1228,8 @@ function App({ entries: initial, errorCount = 0, dataDir, onCopy = copyToClipboa
 	const { stdout } = useStdout();
 	const [entries, setEntries] = useState(initial);
 	const [mode, setMode] = useState("search");
+	const [filter, setFilter] = useState({ type: "all" });
+	const [favorites, setFavorites] = useState(() => dataDir ? loadFavorites(dataDir) : /* @__PURE__ */ new Set());
 	const [editTarget, setEditTarget] = useState(null);
 	const [pendingDelete, setPendingDelete] = useState(null);
 	const [query, setQuery] = useState("");
@@ -1086,7 +1238,16 @@ function App({ entries: initial, errorCount = 0, dataDir, onCopy = copyToClipboa
 	const reload = useCallback(() => {
 		if (dataDir) setEntries(loadEntries(dataDir).entries);
 	}, [dataDir]);
-	const results = useMemo(() => search(entries, query), [entries, query]);
+	const scoped = useMemo(() => {
+		if (filter.type === "app") return entries.filter((e) => e.app === filter.app);
+		if (filter.type === "favorites") return entries.filter((e) => favorites.has(favKey(e.app, e.action)));
+		return entries;
+	}, [
+		entries,
+		filter,
+		favorites
+	]);
+	const results = useMemo(() => search(scoped, query), [scoped, query]);
 	const sel = results.length ? Math.min(selected, results.length - 1) : 0;
 	const current = results[sel];
 	const listHeight = visibleListHeight(stdout?.rows);
@@ -1110,6 +1271,11 @@ function App({ entries: initial, errorCount = 0, dataDir, onCopy = copyToClipboa
 		}
 		if (!key.return && flash) setFlash("");
 		if (key.escape) {
+			if (filter.type !== "all") {
+				setFilter({ type: "all" });
+				setSelected(0);
+				return;
+			}
 			exit();
 			return;
 		}
@@ -1126,6 +1292,16 @@ function App({ entries: initial, errorCount = 0, dataDir, onCopy = copyToClipboa
 			setPendingDelete(current);
 			return;
 		}
+		if (key.ctrl && input === "f") {
+			setMode("filter");
+			return;
+		}
+		if (dataDir && current && key.ctrl && input === "s") {
+			const next = toggleFavorite(dataDir, current.app, current.action);
+			setFavorites(next);
+			setFlash(next.has(favKey(current.app, current.action)) ? "★ starred" : "☆ unstarred");
+			return;
+		}
 		if (key.downArrow || key.ctrl && input === "n") {
 			setSelected((s) => Math.min(s + 1, results.length - 1));
 			return;
@@ -1159,6 +1335,17 @@ function App({ entries: initial, errorCount = 0, dataDir, onCopy = copyToClipboa
 		}
 	}, { isActive: mode === "search" });
 	const existingTags = [...new Set(entries.flatMap((e) => e.tags ?? []))].sort();
+	if (mode === "filter") return /* @__PURE__ */ jsx(FilterPicker, {
+		apps: [...new Set(entries.map((e) => e.app))].sort(),
+		height: listHeight,
+		width: left,
+		onSelect: (f) => {
+			setFilter(f);
+			setSelected(0);
+			setMode("search");
+		},
+		onCancel: () => setMode("search")
+	});
 	if (mode === "add" && dataDir) return /* @__PURE__ */ jsx(AddEntryForm, {
 		apps: listApps(dataDir),
 		existingTags,
@@ -1202,13 +1389,18 @@ function App({ entries: initial, errorCount = 0, dataDir, onCopy = copyToClipboa
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		children: [
-			/* @__PURE__ */ jsx(SearchInput, { query }),
+			/* @__PURE__ */ jsx(SearchInput, {
+				query,
+				filterLabel: filter.type === "app" ? `(filter: ${filter.app})` : filter.type === "favorites" ? "(★ Favorites)" : void 0
+			}),
 			/* @__PURE__ */ jsxs(Box, { children: [/* @__PURE__ */ jsx(ResultList, {
 				results,
 				selected: sel,
 				query,
 				height: listHeight,
-				width: left
+				width: left,
+				favorites,
+				emptyMessage: filter.type === "favorites" ? "No favorites yet — ⌃S stars an entry." : void 0
 			}), /* @__PURE__ */ jsx(PreviewPane, {
 				entry: current,
 				width: right
@@ -1217,6 +1409,7 @@ function App({ entries: initial, errorCount = 0, dataDir, onCopy = copyToClipboa
 				flash,
 				errorCount,
 				resultCount: results.length,
+				filterActive: filter.type !== "all",
 				confirm: pendingDelete ? `Delete '${pendingDelete.app}: ${pendingDelete.action}'?` : void 0
 			})
 		]

package/package.json

@@ -1,7 +1,9 @@
 {
   "name": "@arthony/keybook",
-  "version": "0.5.0",
-  "publishConfig": { "access": "public" },
+  "version": "0.6.0",
+  "publishConfig": {
+    "access": "public"
+  },
   "description": "A macOS TUI for searching keyboard shortcuts and recipes of your favorite apps",
   "keywords": [
     "cli",
@@ -15,22 +17,27 @@
     "productivity"
   ],
   "homepage": "https://github.com/Ariyapong/keybook#readme",
-  "repository": { "type": "git", "url": "git+https://github.com/Ariyapong/keybook.git" },
-  "bugs": { "url": "https://github.com/Ariyapong/keybook/issues" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ariyapong/keybook.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Ariyapong/keybook/issues"
+  },
   "author": "Ariyapong Wimolnoch",
   "type": "module",
-  "bin": { "keybook": "dist/cli.js", "kb": "dist/cli.js" },
-  "files": ["dist", "seed", "README.md", "LICENSE"],
-  "engines": { "node": ">=22" },
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsx src/cli.ts",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check .",
-    "format": "biome format --write .",
-    "prepublishOnly": "pnpm build"
+  "bin": {
+    "keybook": "dist/cli.js",
+    "kb": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "seed",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
   },
   "dependencies": {
     "commander": "^12.1.0",
@@ -51,8 +58,13 @@
     "vitest": "^2.1.0"
   },
   "license": "MIT",
-  "packageManager": "pnpm@10.25.0",
-  "pnpm": {
-    "onlyBuiltDependencies": ["@biomejs/biome", "esbuild"]
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "format": "biome format --write ."
   }
-}
+}