@vibe-validate/utils 0.17.6 → 0.18.0-rc.1

package/dist/path-helpers.d.ts

@@ -69,17 +69,22 @@ export declare function mkdirSyncReal(path: string, options?: Parameters<typeof
  * Normalize any path (resolve short names on Windows)
  *
  * Utility to normalize paths without creating directories.
- * Useful when you have an existing path that might contain short names.
+ * Accepts multiple path segments like path.resolve() for convenience.
  *
- * @param path - Path to normalize
- * @returns Real (normalized) path, or original if normalization fails
+ * @param paths - Path segments to join and normalize
+ * @returns Real (normalized) path, or resolved path if normalization fails
  *
  * @example
  * ```typescript
+ * // Single path
  * const shortPath = 'C:\\PROGRA~1\\nodejs';
  * const longPath = normalizePath(shortPath);
  * // Result: 'C:\\Program Files\\nodejs'
+ *
+ * // Multiple segments (like path.resolve)
+ * const cliPath = normalizePath(__dirname, '../../dist/bin.js');
+ * // Resolves to absolute path AND normalizes short names
  * ```
  */
-export declare function normalizePath(path: string): string;
+export declare function normalizePath(...paths: string[]): string;
 //# sourceMappingURL=path-helpers.d.ts.map

package/dist/path-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-helpers.d.ts","sourceRoot":"","sources":["../src/path-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAgB,MAAM,SAAS,CAAC;AAGlD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAUzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,GACxC,MAAM,CAYR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlD"}
+{"version":3,"file":"path-helpers.d.ts","sourceRoot":"","sources":["../src/path-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAgB,MAAM,SAAS,CAAC;AAKlD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAgBzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,GACxC,MAAM,CAiBR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAmBxD"}

package/dist/path-helpers.js

@@ -36,13 +36,19 @@ import { tmpdir } from 'node:os';
 export function normalizedTmpdir() {
     const temp = tmpdir();
     try {
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Safe: temp is from tmpdir() (OS-provided system temp directory), not user input
-        return realpathSync(temp);
+        // Use native OS realpath for better Windows compatibility
+        return realpathSync.native(temp);
     }
     catch {
-        // Fallback: if realpathSync fails, return original
-        // (shouldn't happen, but safety first)
-        return temp;
+        // Fallback to regular realpathSync
+        try {
+            // eslint-disable-next-line security/detect-non-literal-fs-filename -- Safe: temp is from tmpdir()
+            return realpathSync(temp);
+        }
+        catch {
+            // Last resort: return original
+            return temp;
+        }
     }
 }
 /**
@@ -77,41 +83,64 @@ export function normalizedTmpdir() {
  * ```
  */
 export function mkdirSyncReal(path, options) {
-    // eslint-disable-next-line security/detect-non-literal-fs-filename -- Safe: path is function parameter from test setup (tmpdir + test name), not user input
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- This IS the mkdirSyncReal() implementation
     mkdirSync(path, options);
     try {
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Safe: path is function parameter from test setup (tmpdir + test name), not user input
-        return realpathSync(path);
+        // Use native OS realpath for better Windows compatibility
+        return realpathSync.native(path);
     }
     catch {
-        // Fallback: if realpathSync fails, return original
-        // (might happen if directory creation failed)
-        return path;
+        // Fallback to regular realpathSync
+        try {
+            // eslint-disable-next-line security/detect-non-literal-fs-filename -- Safe: path is function parameter
+            return realpathSync(path);
+        }
+        catch {
+            // Last resort: return original
+            return path;
+        }
     }
 }
 /**
  * Normalize any path (resolve short names on Windows)
  *
  * Utility to normalize paths without creating directories.
- * Useful when you have an existing path that might contain short names.
+ * Accepts multiple path segments like path.resolve() for convenience.
  *
- * @param path - Path to normalize
- * @returns Real (normalized) path, or original if normalization fails
+ * @param paths - Path segments to join and normalize
+ * @returns Real (normalized) path, or resolved path if normalization fails
  *
  * @example
  * ```typescript
+ * // Single path
  * const shortPath = 'C:\\PROGRA~1\\nodejs';
  * const longPath = normalizePath(shortPath);
  * // Result: 'C:\\Program Files\\nodejs'
+ *
+ * // Multiple segments (like path.resolve)
+ * const cliPath = normalizePath(__dirname, '../../dist/bin.js');
+ * // Resolves to absolute path AND normalizes short names
  * ```
  */
-export function normalizePath(path) {
+export function normalizePath(...paths) {
+    // First resolve to absolute path (handles multiple segments)
+    const resolved = paths.length === 1
+        ? paths[0]
+        : require('node:path').resolve(...paths);
     try {
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Safe: path is function parameter from test setup (tmpdir + test name), not user input
-        return realpathSync(path);
+        // Use native OS realpath for better Windows compatibility
+        return realpathSync.native(resolved);
     }
     catch {
-        return path;
+        // Fallback to regular realpathSync
+        try {
+            // eslint-disable-next-line security/detect-non-literal-fs-filename -- Safe: resolved is from path.resolve
+            return realpathSync(resolved);
+        }
+        catch {
+            // Last resort: return resolved path (better than original input)
+            return resolved;
+        }
     }
 }
 //# sourceMappingURL=path-helpers.js.map

package/dist/path-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"path-helpers.js","sourceRoot":"","sources":["../src/path-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,sJAAsJ;QACtJ,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;QACnD,uCAAuC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,OAAyC;IAEzC,4JAA4J;IAC5J,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEzB,IAAI,CAAC;QACH,4JAA4J;QAC5J,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;QACnD,8CAA8C;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,4JAA4J;QAC5J,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"path-helpers.js","sourceRoot":"","sources":["../src/path-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,gBAAgB;IAE9B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,0DAA0D;QAC1D,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;QACnC,IAAI,CAAC;YACH,kGAAkG;YAClG,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,OAAyC;IAEzC,iHAAiH;IACjH,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEzB,IAAI,CAAC;QACH,0DAA0D;QAC1D,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;QACnC,IAAI,CAAC;YACH,uGAAuG;YACvG,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa,CAAC,GAAG,KAAe;IAC9C,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC;QACjC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACV,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,0DAA0D;QAC1D,OAAO,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;QACnC,IAAI,CAAC;YACH,0GAA0G;YAC1G,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,iEAAiE;YACjE,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-validate/utils",
-  "version": "0.17.6",
+  "version": "0.18.0-rc.1",
   "description": "Common utilities for vibe-validate packages (command execution, path normalization)",
   "type": "module",
   "main": "./dist/index.js",