@xynogen/pix-find 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,25 @@
+# pix-find
+
+Pi tool — glob file search with FFF acceleration.
+
+## What it does
+
+Replaces Pi's default `find` tool with an enhanced version backed by `pix-pretty`. Uses FFF (frecency-ranked, SIMD-accelerated file finder) when available, falling back to the standard glob search. Results are rendered with file icons, match counts, and a dim preview of the top hits. Call labels show the glob pattern and search directory inline. Depends on `@xynogen/pix-pretty`, installed automatically as a dependency.
+
+## Install
+
+```bash
+pi install npm:@xynogen/pix-find
+```
+
+## Full distro
+
+To install the complete pix suite (all packages + Pi itself):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/xynogen/pix-mono/main/scripts/install.sh | sh
+```
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-find",
-	"version": "0.1.0",
+	"version": "0.1.2",
 	"description": "Pi tool — glob file search",
 	"type": "module",
 	"main": "src/index.ts",

package/src/extension.ts

@@ -5,35 +5,37 @@ import type {
 	TextComponentCtor,
 } from "@xynogen/pix-pretty/types";
 import { shortPath } from "@xynogen/pix-pretty/utils";
-
 import { registerFindTool } from "./find.js";
+import { once } from "./once.ts";
 
 export default function pixFindExtension(pi: PiPrettyApi): void {
-	let sdk: PiPrettySdk;
-	try {
-		sdk = require("@earendil-works/pi-coding-agent");
-	} catch {
-		return;
-	}
+	once("pix-find", () => {
+		let sdk: PiPrettySdk;
+		try {
+			sdk = require("@earendil-works/pi-coding-agent");
+		} catch {
+			return;
+		}
 
-	const createFindTool = sdk.createFindToolDefinition ?? sdk.createFindTool;
-	if (!createFindTool) return;
+		const createFindTool = sdk.createFindToolDefinition ?? sdk.createFindTool;
+		if (!createFindTool) return;
 
-	let TextComponent: TextComponentCtor;
-	try {
-		TextComponent = require("@earendil-works/pi-tui").Text;
-	} catch {
-		return;
-	}
+		let TextComponent: TextComponentCtor;
+		try {
+			TextComponent = require("@earendil-works/pi-tui").Text;
+		} catch {
+			return;
+		}
 
-	const cwd = process.cwd();
-	const home = process.env.HOME ?? "";
+		const cwd = process.cwd();
+		const home = process.env.HOME ?? "";
 
-	registerFindTool(pi, createFindTool, {
-		cwd,
-		sp: (p: string) => shortPath(cwd, home, p),
-		TextComponent,
-		fffState,
-		cursorStore: new CursorStore(),
+		registerFindTool(pi, createFindTool, {
+			cwd,
+			sp: (p: string) => shortPath(cwd, home, p),
+			TextComponent,
+			fffState,
+			cursorStore: new CursorStore(),
+		});
 	});
 }

package/src/once.ts

@@ -0,0 +1,16 @@
+/**
+ * Idempotency guard for extension activation.
+ *
+ * pix-core (the meta-package) invokes this package's factory in addition to a
+ * possible direct install. Pi's loader uses jiti with `moduleCache: false`, so
+ * each load pass re-evaluates modules — a plain module-level flag would not be
+ * shared. The dedupe key therefore lives on `globalThis`, which persists for
+ * the lifetime of the process across all load passes.
+ */
+export function once(key: string, fn: () => void): void {
+	const g = globalThis as { __pixLoaded?: Set<string> };
+	const loaded = (g.__pixLoaded ??= new Set<string>());
+	if (loaded.has(key)) return;
+	loaded.add(key);
+	fn();
+}