@oh-my-pi/pi-natives 18.3.4 → 18.4.0

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

@@ -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.
  *

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.4",
+	"version": "18.4.0",
 	"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.4",
-		"@oh-my-pi/pi-natives-linux-arm64": "18.3.4",
-		"@oh-my-pi/pi-natives-darwin-x64": "18.3.4",
-		"@oh-my-pi/pi-natives-darwin-arm64": "18.3.4",
-		"@oh-my-pi/pi-natives-win32-x64": "18.3.4",
-		"@oh-my-pi/pi-natives-win32-arm64": "18.3.4"
+		"@oh-my-pi/pi-natives-linux-x64": "18.4.0",
+		"@oh-my-pi/pi-natives-linux-arm64": "18.4.0",
+		"@oh-my-pi/pi-natives-darwin-x64": "18.4.0",
+		"@oh-my-pi/pi-natives-darwin-arm64": "18.4.0",
+		"@oh-my-pi/pi-natives-win32-x64": "18.4.0",
+		"@oh-my-pi/pi-natives-win32-arm64": "18.4.0"
 	}
 }