@oh-my-pi/pi-natives 12.0.0 → 12.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-natives",
-	"version": "12.0.0",
+	"version": "12.1.0",
 	"description": "Native Rust functionality via N-API",
 	"type": "module",
 	"main": "./src/index.ts",
@@ -32,7 +32,7 @@
 		"directory": "packages/natives"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-utils": "12.0.0"
+		"@oh-my-pi/pi-utils": "12.1.0"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3.9"

package/src/glob/index.ts

@@ -34,3 +34,13 @@ export async function glob(options: GlobOptions, onMatch?: (match: GlobMatch) =>
 		cb,
 	);
 }
+
+/**
+ * Invalidate the filesystem scan cache.
+ *
+ * When called with a path, removes entries for roots containing that path.
+ * When called without a path, clears the entire cache.
+ */
+export function invalidateFsScanCache(path?: string): void {
+	native.invalidateFsScanCache(path);
+}

package/src/glob/types.ts

@@ -27,8 +27,12 @@ export interface GlobOptions extends Cancellable {
 	maxResults?: number;
 	/** Respect .gitignore files (default: true). */
 	gitignore?: boolean;
+	/** Enable shared filesystem scan cache (default: false). */
+	cache?: boolean;
 	/** Sort results by mtime (most recent first) before applying limit. */
 	sortByMtime?: boolean;
+	/** Include node_modules entries even when pattern does not mention node_modules. */
+	includeNodeModules?: boolean;
 }
 
 /** A single filesystem match. */
@@ -57,5 +61,7 @@ declare module "../bindings" {
 		 * @param onMatch Optional callback for streaming matches as they are found.
 		 */
 		glob(options: GlobOptions, onMatch?: TsFunc<GlobMatch>): Promise<GlobResult>;
+		/** Invalidate the filesystem scan cache for the given path (or all caches if omitted). */
+		invalidateFsScanCache(path?: string): void;
 	}
 }

package/src/grep/types.ts

@@ -20,6 +20,8 @@ export interface GrepOptions extends Cancellable {
 	multiline?: boolean;
 	/** Include hidden files (default: true) */
 	hidden?: boolean;
+	/** Enable shared filesystem scan cache (default: false). */
+	cache?: boolean;
 	/** Maximum number of matches to return */
 	maxCount?: number;
 	/** Skip first N matches */
@@ -132,7 +134,7 @@ export interface SearchResult {
 
 /** Options for fuzzy file path search. */
 export interface FuzzyFindOptions extends Cancellable {
-	/** Substring query to match against file paths (case-insensitive). */
+	/** Fuzzy query to match against file paths (case-insensitive). */
 	query: string;
 	/** Directory to search. */
 	path: string;
@@ -140,6 +142,8 @@ export interface FuzzyFindOptions extends Cancellable {
 	hidden?: boolean;
 	/** Respect .gitignore (default: true). */
 	gitignore?: boolean;
+	/** Enable shared filesystem scan cache (default: false). */
+	cache?: boolean;
 	/** Maximum number of matches to return (default: 100). */
 	maxResults?: number;
 }
@@ -150,6 +154,8 @@ export interface FuzzyFindMatch {
 	path: string;
 	/** Whether this entry is a directory. */
 	isDirectory: boolean;
+	/** Match quality score (higher is better). */
+	score: number;
 }
 
 /** Result of fuzzy file path search. */

package/src/index.ts

@@ -37,6 +37,7 @@ export {
 	type GlobOptions,
 	type GlobResult,
 	glob,
+	invalidateFsScanCache,
 } from "./glob";
 
 // =============================================================================

package/src/native.ts

@@ -9,6 +9,7 @@ import { createRequire } from "node:module";
 import * as os from "node:os";
 import * as path from "node:path";
 import { $env } from "@oh-my-pi/pi-utils";
+import { getNativesDir } from "@oh-my-pi/pi-utils/dirs";
 
 import packageJson from "../package.json";
 import type { NativeBindings } from "./bindings";
@@ -37,7 +38,7 @@ const addonFilename = `pi_natives.${platformTag}.node`;
 const packageVersion = (packageJson as { version: string }).version;
 const nativeDir = path.join(import.meta.dir, "..", "native");
 const execDir = path.dirname(process.execPath);
-const versionedDir = path.join(os.homedir(), ".omp", "natives", packageVersion);
+const versionedDir = path.join(getNativesDir(), packageVersion);
 const versionedAddonPath = path.join(versionedDir, addonFilename);
 const legacyUserDataDir =
 	process.platform === "win32"
@@ -185,6 +186,7 @@ function validateNative(bindings: NativeBindings, source: string): void {
 	checkFn("listDescendants");
 	checkFn("getSystemInfo");
 	checkFn("getWorkProfile");
+	checkFn("invalidateFsScanCache");
 
 	if (missing.length) {
 		throw new Error(