@react-native-windows/find-dotnet-tools 0.0.0-canary.2

package/README.md

@@ -0,0 +1,50 @@
+# @react-native-windows/find-dotnet-tools
+
+Helpers to locate .NET-based tools (e.g. PowerShell) restored via `dotnet tool restore` or
+available on PATH.
+
+Used to resolve tool paths consistently across local development and CI
+environments.
+
+## Usage
+
+Add the package as a dependency:
+
+```json
+{
+  "dependencies": {
+    "@react-native-windows/find-dotnet-tools": "<version>"
+  }
+}
+```
+
+### findPowerShell
+
+Locates a PowerShell executable by checking, in order:
+
+1. A `dotnet-tool`-restored copy of `pwsh.exe` (skipped in CI builds)
+2. `pwsh.exe` on the system PATH
+
+Throws an error if `pwsh.exe` cannot be found.
+
+```js
+import {findPowerShell} from '@react-native-windows/find-dotnet-tools';
+
+const pwsh = findPowerShell();
+// e.g. "C:\\Users\\user\\.nuget\\packages\\PowerShell\\7.6.1\\tools\\net10.0\\any\\win\\pwsh.exe"
+```
+
+### getNugetGlobalPackagesFolder
+
+Returns the path to the global NuGet packages folder by checking, in order:
+
+1. The `NUGET_PACKAGES` environment variable
+2. The output of `dotnet nuget locals global-packages --list`
+3. The default `~/.nuget/packages` location
+
+```js
+import {getNugetGlobalPackagesFolder} from '@react-native-windows/find-dotnet-tools';
+
+const packagesDir = getNugetGlobalPackagesFolder();
+// e.g. "C:\\Users\\user\\.nuget\\packages"
+```

package/lib-commonjs/findDotnetTools.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+/**
+ * Returns the path to the global NuGet packages folder, checking (in order):
+ * 1. The NUGET_PACKAGES environment variable
+ * 2. The `dotnet nuget locals` command output
+ * 3. The default ~/.nuget/packages location
+ */
+export declare function getNugetGlobalPackagesFolder(): string;
+/**
+ * Locates a PowerShell executable, checking (in order):
+ * 1. A NuGet-restored copy of pwsh (skipped in CI builds)
+ * 2. pwsh.exe on the system PATH
+ *
+ * Throws if no pwsh.exe can be located.
+ */
+export declare function findPowerShell(): string;

package/lib-commonjs/findDotnetTools.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findPowerShell = exports.getNugetGlobalPackagesFolder = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("@react-native-windows/fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Returns the path to the global NuGet packages folder, checking (in order):
+ * 1. The NUGET_PACKAGES environment variable
+ * 2. The `dotnet nuget locals` command output
+ * 3. The default ~/.nuget/packages location
+ */
+function getNugetGlobalPackagesFolder() {
+    if (process.env.NUGET_PACKAGES) {
+        return process.env.NUGET_PACKAGES;
+    }
+    try {
+        const output = (0, child_process_1.execSync)('dotnet.exe nuget locals global-packages --list', {
+            encoding: 'utf8',
+        }).trim();
+        const match = output.match(/global-packages:\s*(.+)/i);
+        if (match) {
+            return match[1].trim();
+        }
+    }
+    catch { }
+    return path_1.default.join(os_1.default.homedir(), '.nuget', 'packages');
+}
+exports.getNugetGlobalPackagesFolder = getNugetGlobalPackagesFolder;
+/**
+ * Locates a PowerShell executable, checking (in order):
+ * 1. A NuGet-restored copy of pwsh (skipped in CI builds)
+ * 2. pwsh.exe on the system PATH
+ *
+ * Throws if no pwsh.exe can be located.
+ */
+function findPowerShell() {
+    // Build agents already have PowerShell (pwsh) installed
+    if (!process.env.TF_BUILD) {
+        const nugetPackages = getNugetGlobalPackagesFolder();
+        const nugetPwsh = path_1.default.join(nugetPackages, 'PowerShell', '7.6.1', 'tools', 'net10.0', 'any', 'win', 'pwsh.exe');
+        if (fs_1.default.existsSync(nugetPwsh)) {
+            return nugetPwsh;
+        }
+    }
+    try {
+        const found = (0, child_process_1.execSync)('where pwsh.exe', { encoding: 'utf8' }).trim();
+        if (found) {
+            return found.split(/\r?\n/)[0];
+        }
+    }
+    catch { }
+    throw new Error('Unable to find pwsh.exe. It should have been made available by `yarn install`.');
+}
+exports.findPowerShell = findPowerShell;
+//# sourceMappingURL=findDotnetTools.js.map

package/lib-commonjs/findDotnetTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findDotnetTools.js","sourceRoot":"","sources":["../src/findDotnetTools.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,iDAAuC;AACvC,kEAA0C;AAC1C,4CAAoB;AACpB,gDAAwB;AAExB;;;;;GAKG;AACH,SAAgB,4BAA4B;IAC1C,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE;QAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;KACnC;IACD,IAAI;QACF,MAAM,MAAM,GAAG,IAAA,wBAAQ,EAAC,gDAAgD,EAAE;YACxE,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACvD,IAAI,KAAK,EAAE;YACT,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACxB;KACF;IAAC,MAAM,GAAE;IACV,OAAO,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AACvD,CAAC;AAdD,oEAcC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc;IAC5B,wDAAwD;IACxD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE;QACzB,MAAM,aAAa,GAAG,4BAA4B,EAAE,CAAC;QACrD,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CACzB,aAAa,EACb,YAAY,EACZ,OAAO,EACP,OAAO,EACP,SAAS,EACT,KAAK,EACL,KAAK,EACL,UAAU,CACX,CAAC;QACF,IAAI,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;YAC5B,OAAO,SAAS,CAAC;SAClB;KACF;IAED,IAAI;QACF,MAAM,KAAK,GAAG,IAAA,wBAAQ,EAAC,gBAAgB,EAAE,EAAC,QAAQ,EAAE,MAAM,EAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpE,IAAI,KAAK,EAAE;YACT,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;SAChC;KACF;IAAC,MAAM,GAAE;IAEV,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;AACJ,CAAC;AA7BD,wCA6BC","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n * @format\n */\n\nimport {execSync} from 'child_process';\nimport fs from '@react-native-windows/fs';\nimport os from 'os';\nimport path from 'path';\n\n/**\n * Returns the path to the global NuGet packages folder, checking (in order):\n * 1. The NUGET_PACKAGES environment variable\n * 2. The `dotnet nuget locals` command output\n * 3. The default ~/.nuget/packages location\n */\nexport function getNugetGlobalPackagesFolder(): string {\n  if (process.env.NUGET_PACKAGES) {\n    return process.env.NUGET_PACKAGES;\n  }\n  try {\n    const output = execSync('dotnet.exe nuget locals global-packages --list', {\n      encoding: 'utf8',\n    }).trim();\n    const match = output.match(/global-packages:\\s*(.+)/i);\n    if (match) {\n      return match[1].trim();\n    }\n  } catch {}\n  return path.join(os.homedir(), '.nuget', 'packages');\n}\n\n/**\n * Locates a PowerShell executable, checking (in order):\n * 1. A NuGet-restored copy of pwsh (skipped in CI builds)\n * 2. pwsh.exe on the system PATH\n *\n * Throws if no pwsh.exe can be located.\n */\nexport function findPowerShell(): string {\n  // Build agents already have PowerShell (pwsh) installed\n  if (!process.env.TF_BUILD) {\n    const nugetPackages = getNugetGlobalPackagesFolder();\n    const nugetPwsh = path.join(\n      nugetPackages,\n      'PowerShell',\n      '7.6.1',\n      'tools',\n      'net10.0',\n      'any',\n      'win',\n      'pwsh.exe',\n    );\n    if (fs.existsSync(nugetPwsh)) {\n      return nugetPwsh;\n    }\n  }\n\n  try {\n    const found = execSync('where pwsh.exe', {encoding: 'utf8'}).trim();\n    if (found) {\n      return found.split(/\\r?\\n/)[0];\n    }\n  } catch {}\n\n  throw new Error(\n    'Unable to find pwsh.exe. It should have been made available by `yarn install`.',\n  );\n}\n"]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@react-native-windows/find-dotnet-tools",
+  "description": "Helpers to locate .NET-based tools (e.g. pwsh) restored via NuGet or available on PATH.",
+  "version": "0.0.0-canary.2",
+  "license": "MIT",
+  "scripts": {
+    "build": "rnw-scripts build",
+    "clean": "rnw-scripts clean",
+    "lint": "rnw-scripts lint",
+    "lint:fix": "rnw-scripts lint:fix",
+    "watch": "rnw-scripts watch"
+  },
+  "main": "lib-commonjs/findDotnetTools.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/react-native-windows",
+    "directory": "packages/@react-native-windows/find-dotnet-tools"
+  },
+  "dependencies": {
+    "@react-native-windows/fs": "^0.0.0-canary.72"
+  },
+  "devDependencies": {
+    "@rnw-scripts/eslint-config": "1.2.38",
+    "@rnw-scripts/just-task": "2.3.58",
+    "@rnw-scripts/ts-config": "2.0.6",
+    "@types/node": "^22.14.0",
+    "@typescript-eslint/eslint-plugin": "^8.36.0",
+    "@typescript-eslint/parser": "^8.36.0",
+    "eslint": "^8.19.0",
+    "prettier": "^3.6.2",
+    "typescript": "5.0.4"
+  },
+  "beachball": {
+    "defaultNpmTag": "canary",
+    "disallowedChangeTypes": [
+      "major",
+      "minor",
+      "patch",
+      "premajor",
+      "preminor",
+      "prepatch"
+    ]
+  },
+  "promoteRelease": true,
+  "files": [
+    "lib-commonjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">= 22"
+  }
+}