@oh-my-pi/pi-natives 18.3.5 → 18.4.1

package/README.md

@@ -45,6 +45,14 @@ const pdf = await pdfToMarkdown(pdfBytes);
 console.log(pdf.markdown, pdf.pagesNeedingOcr);
 ```
 
+### Lazy Windows path helpers
+
+Import `expandWindowsLongPath` and `getWindowsShortPath` from
+`@oh-my-pi/pi-natives/path` when importing a module must not load the native addon.
+The addon loads only when a helper is called on Windows; other platforms preserve
+the input path without loading it. These helpers change long/8.3 spellings without
+resolving symlinks or junctions.
+
 ## Building
 
 ```bash

package/native/index.d.ts

@@ -416,9 +416,9 @@ export declare class TextPredictor {
 /**
  * Dedicated writer thread for one terminal fd.
  *
- * Constructed by the TUI's `ProcessTerminal` around stdout. The fd is
- * `dup(2)`'d at construction and closed on drop, so later manipulation of the
- * original descriptor does not affect the pump.
+ * `dup(2)`'d at construction and closed on drop. The duplicate keeps the
+ * pump's fd alive if the original is closed or replaced; file-status flags
+ * such as `O_NONBLOCK` are shared and handled by polling for `POLLOUT`.
  */
 export declare class TtyWriter {
   /**
@@ -1567,6 +1567,9 @@ export declare function execReplace(argv: Array<string>): void
  */
 export declare function executeShell(options: ShellExecuteOptions, onChunk?: ((error: Error | null, chunk: string) => void) | undefined | null): Promise<ShellRunResult>
 
+/** Expand Windows 8.3 components without resolving symlinks or junctions. */
+export declare function expandWindowsLongPath(path: string): string
+
 /** Locate `*** Edit File: path` payloads the model emitted as plain text. */
 export declare function extractInlineSloppyRegions(text: string): Array<InlineSloppyRegion>
 
@@ -1644,6 +1647,9 @@ export interface FuzzyFindResult {
 /** Get list of supported languages. */
 export declare function getSupportedLanguages(): Array<string>
 
+/** Get the existing Windows 8.3 spelling; preserve the input when unavailable. */
+export declare function getWindowsShortPath(path: string): string
+
 /**
  * Get work profile data from the last N seconds.
  *
@@ -1733,7 +1739,8 @@ export interface GlobResult {
  *
  * # Arguments
  * - `options`: Pattern, path, filters, and output mode.
- * - `on_match`: Optional callback invoked per match/result.
+ * - `on_match`: Optional callback invoked per returned match/result, after the
+ *   search (never called when `options.onMatches` streams instead).
  *
  * # Returns
  * Aggregated results across matching files.
@@ -1810,6 +1817,16 @@ export interface GrepOptions {
    * absent).
    */
   filesystem?: ShellFilesystem
+  /**
+   * Stream results instead of returning them: called on the JS thread with
+   * batches (at most 1024 entries, files in no particular order) of what
+   * `matches` would hold, while the search runs. A slow callback pauses the
+   * search instead of buffering, every call returns before the promise
+   * settles, and the result then carries counts with empty `matches`.
+   * A throw rejects the search with it. Incompatible with `maxCount` and
+   * `offset`.
+   */
+  onMatches?: (matches: GrepMatch[]) => void
 }
 
 /** Output mode for [`search`] and [`grep`] (string values match JS callers). */

package/native/index.js

@@ -72,10 +72,12 @@ export const enclosingBlockBoundaries = nativeBindings.enclosingBlockBoundaries
 export const encodeSixel = nativeBindings.encodeSixel ?? missingNativeExport("encodeSixel");
 export const execReplace = nativeBindings.execReplace ?? missingNativeExport("execReplace");
 export const executeShell = nativeBindings.executeShell ?? missingNativeExport("executeShell");
+export const expandWindowsLongPath = nativeBindings.expandWindowsLongPath ?? missingNativeExport("expandWindowsLongPath");
 export const extractInlineSloppyRegions = nativeBindings.extractInlineSloppyRegions ?? missingNativeExport("extractInlineSloppyRegions");
 export const extractSegments = nativeBindings.extractSegments ?? missingNativeExport("extractSegments");
 export const fuzzyFind = nativeBindings.fuzzyFind ?? missingNativeExport("fuzzyFind");
 export const getSupportedLanguages = nativeBindings.getSupportedLanguages ?? missingNativeExport("getSupportedLanguages");
+export const getWindowsShortPath = nativeBindings.getWindowsShortPath ?? missingNativeExport("getWindowsShortPath");
 export const getWorkProfile = nativeBindings.getWorkProfile ?? missingNativeExport("getWorkProfile");
 export const glob = nativeBindings.glob ?? missingNativeExport("glob");
 export const grep = nativeBindings.grep ?? missingNativeExport("grep");

package/native/path.d.ts

@@ -0,0 +1,5 @@
+/** Expand Windows 8.3 components without resolving symlinks or junctions. Load the addon only on Windows. */
+export declare function expandWindowsLongPath(path: string): string;
+
+/** Get the existing Windows 8.3 spelling. Load the addon only on Windows; preserve paths on other platforms. */
+export declare function getWindowsShortPath(path: string): string;

package/native/path.js

@@ -0,0 +1,21 @@
+import { loadNative, missingNativeExportMessage } from "./loader-state.js";
+
+let bindings;
+
+/** Load the addon once; an addon built before these helpers existed fails with rebuild guidance. */
+function nativePathFn(symbolName) {
+	bindings ??= loadNative();
+	const fn = bindings[symbolName];
+	if (typeof fn !== "function") throw new Error(missingNativeExportMessage(symbolName));
+	return fn;
+}
+
+/** Expand Windows 8.3 components without resolving symlinks or junctions. Load the addon only on Windows. */
+export function expandWindowsLongPath(path) {
+	return process.platform === "win32" ? nativePathFn("expandWindowsLongPath")(path) : path;
+}
+
+/** Get the existing Windows 8.3 spelling. Load the addon only on Windows; preserve paths on other platforms. */
+export function getWindowsShortPath(path) {
+	return process.platform === "win32" ? nativePathFn("getWindowsShortPath")(path) : path;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-natives",
-	"version": "18.3.5",
+	"version": "18.4.1",
 	"description": "Native Rust bindings for PDF conversion, audio, WebRTC, grep, clipboard, image processing, syntax highlighting, PTY, and shell operations via N-API",
 	"type": "module",
 	"homepage": "https://omp.sh",
@@ -77,6 +77,8 @@
 		"native/version-sentinel.d.ts",
 		"native/loader-state.js",
 		"native/loader-state.d.ts",
+		"native/path.js",
+		"native/path.d.ts",
 		"native/vcs.js",
 		"native/vcs.d.ts",
 		"native/embedded-addon.js",
@@ -90,6 +92,11 @@
 			"import": "./native/index.js",
 			"default": "./native/index.js"
 		},
+		"./path": {
+			"types": "./native/path.d.ts",
+			"import": "./native/path.js",
+			"default": "./native/path.js"
+		},
 		"./desktop": {
 			"types": "./native/desktop.d.ts",
 			"import": "./native/desktop.js",
@@ -107,11 +114,11 @@
 		}
 	},
 	"optionalDependencies": {
-		"@oh-my-pi/pi-natives-linux-x64": "18.3.5",
-		"@oh-my-pi/pi-natives-linux-arm64": "18.3.5",
-		"@oh-my-pi/pi-natives-darwin-x64": "18.3.5",
-		"@oh-my-pi/pi-natives-darwin-arm64": "18.3.5",
-		"@oh-my-pi/pi-natives-win32-x64": "18.3.5",
-		"@oh-my-pi/pi-natives-win32-arm64": "18.3.5"
+		"@oh-my-pi/pi-natives-linux-x64": "18.4.1",
+		"@oh-my-pi/pi-natives-linux-arm64": "18.4.1",
+		"@oh-my-pi/pi-natives-darwin-x64": "18.4.1",
+		"@oh-my-pi/pi-natives-darwin-arm64": "18.4.1",
+		"@oh-my-pi/pi-natives-win32-x64": "18.4.1",
+		"@oh-my-pi/pi-natives-win32-arm64": "18.4.1"
 	}
 }