@ms-cloudpack/path-utilities 2.1.2 → 2.2.1

package/lib/findPackageRoot.d.ts

@@ -2,5 +2,7 @@
  * Given an absolute folder path into a package, traverse up the paths
  * until the root has been found (containing the package.json file).
  * Returns undefined if no package root is found after traversing to the filesystem root.
+ * @param startFolder - Absolute path to the folder to start searching from.
+ * @param excludeNodeModules - If true, don't return a path that contains a `node_modules` segment.
  */
-export declare function findPackageRoot(currentPath: string): string | undefined;
+export declare function findPackageRoot(startFolder: string, excludeNodeModules?: boolean): string | undefined;

package/lib/findPackageRoot.js

@@ -1,18 +1,25 @@
 import fs from 'fs';
 import path from 'path';
+const nodeModulesRegex = /[\\/]node_modules($|[\\/])/;
 /**
  * Given an absolute folder path into a package, traverse up the paths
  * until the root has been found (containing the package.json file).
  * Returns undefined if no package root is found after traversing to the filesystem root.
+ * @param startFolder - Absolute path to the folder to start searching from.
+ * @param excludeNodeModules - If true, don't return a path that contains a `node_modules` segment.
  */
-export function findPackageRoot(currentPath) {
-    const root = path.parse(currentPath).root;
-    while (!fs.existsSync(path.join(currentPath, 'package.json'))) {
-        if (currentPath === root) {
+export function findPackageRoot(startFolder, excludeNodeModules) {
+    const root = path.parse(startFolder).root;
+    let currentFolder = startFolder;
+    if (excludeNodeModules && nodeModulesRegex.test(startFolder)) {
+        currentFolder = startFolder.split(nodeModulesRegex)[0];
+    }
+    while (!fs.existsSync(path.join(currentFolder, 'package.json'))) {
+        if (currentFolder === root) {
             return undefined;
         }
-        currentPath = path.dirname(currentPath);
+        currentFolder = path.dirname(currentFolder);
     }
-    return currentPath;
+    return currentFolder;
 }
 //# sourceMappingURL=findPackageRoot.js.map

package/lib/findPackageRoot.js.map

@@ -1 +1 @@
-{"version":3,"file":"findPackageRoot.js","sourceRoot":"","sources":["../src/findPackageRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;IAE1C,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,EAAE;QAC7D,IAAI,WAAW,KAAK,IAAI,EAAE;YACxB,OAAO,SAAS,CAAC;SAClB;QACD,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;KACzC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\n/**\n * Given an absolute folder path into a package, traverse up the paths\n * until the root has been found (containing the package.json file).\n * Returns undefined if no package root is found after traversing to the filesystem root.\n */\nexport function findPackageRoot(currentPath: string): string | undefined {\n  const root = path.parse(currentPath).root;\n\n  while (!fs.existsSync(path.join(currentPath, 'package.json'))) {\n    if (currentPath === root) {\n      return undefined;\n    }\n    currentPath = path.dirname(currentPath);\n  }\n\n  return currentPath;\n}\n"]}
+{"version":3,"file":"findPackageRoot.js","sourceRoot":"","sources":["../src/findPackageRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,kBAA4B;IAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;IAC1C,IAAI,aAAa,GAAG,WAAW,CAAC;IAChC,IAAI,kBAAkB,IAAI,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE;QAC5D,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;KACxD;IAED,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,EAAE;QAC/D,IAAI,aAAa,KAAK,IAAI,EAAE;YAC1B,OAAO,SAAS,CAAC;SAClB;QACD,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;KAC7C;IAED,OAAO,aAAa,CAAC;AACvB,CAAC","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\nconst nodeModulesRegex = /[\\\\/]node_modules($|[\\\\/])/;\n\n/**\n * Given an absolute folder path into a package, traverse up the paths\n * until the root has been found (containing the package.json file).\n * Returns undefined if no package root is found after traversing to the filesystem root.\n * @param startFolder - Absolute path to the folder to start searching from.\n * @param excludeNodeModules - If true, don't return a path that contains a `node_modules` segment.\n */\nexport function findPackageRoot(startFolder: string, excludeNodeModules?: boolean): string | undefined {\n  const root = path.parse(startFolder).root;\n  let currentFolder = startFolder;\n  if (excludeNodeModules && nodeModulesRegex.test(startFolder)) {\n    currentFolder = startFolder.split(nodeModulesRegex)[0];\n  }\n\n  while (!fs.existsSync(path.join(currentFolder, 'package.json'))) {\n    if (currentFolder === root) {\n      return undefined;\n    }\n    currentFolder = path.dirname(currentFolder);\n  }\n\n  return currentFolder;\n}\n"]}

package/lib/intermediateToSourcePath.js

@@ -31,6 +31,7 @@ export function intermediateToSourcePath(relativeIntermediatePath, rootPath) {
     }
     let match = candidates.find((candidate) => {
         const resolvedPath = path.resolve(rootPath, candidate);
+        // eslint-disable-next-line no-restricted-syntax
         return isFileSync(resolvedPath);
     });
     // Re-add the leading period.

package/lib/intermediateToSourcePath.js.map

@@ -1 +1 @@
-{"version":3,"file":"intermediateToSourcePath.js","sourceRoot":"","sources":["../src/intermediateToSourcePath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,wBAAgC,EAAE,QAAgB;IACzF,MAAM,UAAU,GAAG,EAAE,CAAC;IACtB,MAAM,KAAK,GAAG,KAAK,CAAC,wBAAwB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzD,IAAI,gBAAgB,GAAG,CAAC,CAAC;IAEzB,qCAAqC;IACrC,OACE,KAAK,CAAC,MAAM;QACZ,gBAAgB,GAAG,KAAK,CAAC,MAAM;QAC/B,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC,EACjG;QACA,gBAAgB,EAAE,CAAC;KACpB;IAED,mFAAmF;IACnF,IAAI,KAAK,CAAC,MAAM,GAAG,gBAAgB,GAAG,CAAC,EAAE;QACvC,MAAM,kBAAkB,GACtB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9F,MAAM,UAAU,GAAG,kBAAkB;YACnC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnF,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QAE3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;QAE9D,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,EAAE;YAC3C,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CACrF,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CACpE,CAAC;SACH;QAED,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAE9D,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;KAClD;IAED,IAAI,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;QACxC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACvD,OAAO,UAAU,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;QACpC,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;KACtB;IAED,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import path from 'path';\nimport { isFileSync } from './isFileSync.js';\nimport { slash } from '@ms-cloudpack/path-string-parsing';\n\n/**\n * Takes a relative intermediate content path (e.g. \"lib/foo/bar.js\") and resolves it to a source content path\n * (e.g. \"/src/foo/foo.tsx\"). Note: source files must exist so that the utility can resolve the source.\n */\nexport function intermediateToSourcePath(relativeIntermediatePath: string, rootPath: string): string | undefined {\n  const candidates = [];\n  const parts = slash(relativeIntermediatePath).split('/');\n  let firstFolderIndex = 0;\n\n  // Find first folder in relative path\n  while (\n    parts.length &&\n    firstFolderIndex < parts.length &&\n    (!parts[firstFolderIndex] || parts[firstFolderIndex] === '.' || parts[firstFolderIndex] === '..')\n  ) {\n    firstFolderIndex++;\n  }\n\n  // If there is at least 1 folder and 1 filename in the path, add source candidates.\n  if (parts.length - firstFolderIndex > 1) {\n    const isIntermediatePath =\n      ['lib', 'lib-amd', 'lib-esm', 'lib-commonjs', 'dist'].indexOf(parts[firstFolderIndex]) >= 0;\n    const sourcePath = isIntermediatePath\n      ? path.dirname(parts.map((v, i) => (i === firstFolderIndex ? 'src' : v)).join('/'))\n      : path.dirname(relativeIntermediatePath);\n\n    const ext = path.extname(relativeIntermediatePath);\n    const basename = path.basename(relativeIntermediatePath, ext);\n\n    if (!ext || ext === '.js' || ext === '.mjs') {\n      ['.tsx', '.ts', '.mtsx', '.mts', '.jsx', '.mjs', '.js', '.cjs', ''].forEach((newExt) =>\n        candidates.unshift(slash(path.join(sourcePath, basename + newExt))),\n      );\n    }\n\n    candidates.push(slash(path.join(sourcePath, basename + ext)));\n\n    candidates.push(slash(relativeIntermediatePath));\n  }\n\n  let match = candidates.find((candidate) => {\n    const resolvedPath = path.resolve(rootPath, candidate);\n    return isFileSync(resolvedPath);\n  });\n\n  // Re-add the leading period.\n  if (match && !match.startsWith('./')) {\n    match = './' + match;\n  }\n\n  return match;\n}\n"]}
+{"version":3,"file":"intermediateToSourcePath.js","sourceRoot":"","sources":["../src/intermediateToSourcePath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,wBAAgC,EAAE,QAAgB;IACzF,MAAM,UAAU,GAAG,EAAE,CAAC;IACtB,MAAM,KAAK,GAAG,KAAK,CAAC,wBAAwB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzD,IAAI,gBAAgB,GAAG,CAAC,CAAC;IAEzB,qCAAqC;IACrC,OACE,KAAK,CAAC,MAAM;QACZ,gBAAgB,GAAG,KAAK,CAAC,MAAM;QAC/B,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC,EACjG;QACA,gBAAgB,EAAE,CAAC;KACpB;IAED,mFAAmF;IACnF,IAAI,KAAK,CAAC,MAAM,GAAG,gBAAgB,GAAG,CAAC,EAAE;QACvC,MAAM,kBAAkB,GACtB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9F,MAAM,UAAU,GAAG,kBAAkB;YACnC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnF,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QAE3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;QAE9D,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,EAAE;YAC3C,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CACrF,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CACpE,CAAC;SACH;QAED,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAE9D,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;KAClD;IAED,IAAI,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;QACxC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACvD,gDAAgD;QAChD,OAAO,UAAU,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;QACpC,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;KACtB;IAED,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import path from 'path';\nimport { isFileSync } from './isFileSync.js';\nimport { slash } from '@ms-cloudpack/path-string-parsing';\n\n/**\n * Takes a relative intermediate content path (e.g. \"lib/foo/bar.js\") and resolves it to a source content path\n * (e.g. \"/src/foo/foo.tsx\"). Note: source files must exist so that the utility can resolve the source.\n */\nexport function intermediateToSourcePath(relativeIntermediatePath: string, rootPath: string): string | undefined {\n  const candidates = [];\n  const parts = slash(relativeIntermediatePath).split('/');\n  let firstFolderIndex = 0;\n\n  // Find first folder in relative path\n  while (\n    parts.length &&\n    firstFolderIndex < parts.length &&\n    (!parts[firstFolderIndex] || parts[firstFolderIndex] === '.' || parts[firstFolderIndex] === '..')\n  ) {\n    firstFolderIndex++;\n  }\n\n  // If there is at least 1 folder and 1 filename in the path, add source candidates.\n  if (parts.length - firstFolderIndex > 1) {\n    const isIntermediatePath =\n      ['lib', 'lib-amd', 'lib-esm', 'lib-commonjs', 'dist'].indexOf(parts[firstFolderIndex]) >= 0;\n    const sourcePath = isIntermediatePath\n      ? path.dirname(parts.map((v, i) => (i === firstFolderIndex ? 'src' : v)).join('/'))\n      : path.dirname(relativeIntermediatePath);\n\n    const ext = path.extname(relativeIntermediatePath);\n    const basename = path.basename(relativeIntermediatePath, ext);\n\n    if (!ext || ext === '.js' || ext === '.mjs') {\n      ['.tsx', '.ts', '.mtsx', '.mts', '.jsx', '.mjs', '.js', '.cjs', ''].forEach((newExt) =>\n        candidates.unshift(slash(path.join(sourcePath, basename + newExt))),\n      );\n    }\n\n    candidates.push(slash(path.join(sourcePath, basename + ext)));\n\n    candidates.push(slash(relativeIntermediatePath));\n  }\n\n  let match = candidates.find((candidate) => {\n    const resolvedPath = path.resolve(rootPath, candidate);\n    // eslint-disable-next-line no-restricted-syntax\n    return isFileSync(resolvedPath);\n  });\n\n  // Re-add the leading period.\n  if (match && !match.startsWith('./')) {\n    match = './' + match;\n  }\n\n  return match;\n}\n"]}

package/lib/isFolderSync.js

@@ -1,6 +1,7 @@
 import fs from 'fs';
 export function isFolderSync(itemPath) {
     try {
+        // eslint-disable-next-line no-restricted-syntax
         return fs.lstatSync(itemPath)?.isDirectory();
     }
     catch (e) {

package/lib/isFolderSync.js.map

@@ -1 +1 @@
-{"version":3,"file":"isFolderSync.js","sourceRoot":"","sources":["../src/isFolderSync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI;QACF,OAAO,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;KAC9C;IAAC,OAAO,CAAC,EAAE;QACV,WAAW;KACZ;IAED,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import fs from 'fs';\n\nexport function isFolderSync(itemPath: string): boolean {\n  try {\n    return fs.lstatSync(itemPath)?.isDirectory();\n  } catch (e) {\n    /* no-op */\n  }\n\n  return false;\n}\n"]}
+{"version":3,"file":"isFolderSync.js","sourceRoot":"","sources":["../src/isFolderSync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI;QACF,gDAAgD;QAChD,OAAO,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;KAC9C;IAAC,OAAO,CAAC,EAAE;QACV,WAAW;KACZ;IAED,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import fs from 'fs';\n\nexport function isFolderSync(itemPath: string): boolean {\n  try {\n    // eslint-disable-next-line no-restricted-syntax\n    return fs.lstatSync(itemPath)?.isDirectory();\n  } catch (e) {\n    /* no-op */\n  }\n\n  return false;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ms-cloudpack/path-utilities",
-  "version": "2.1.2",
+  "version": "2.2.1",
   "description": "Utilities for resolving paths between source/intermediate/output locations in Cloudpack.",
   "license": "MIT",
   "type": "module",