Migrate dev-tool from CommonJS to ESM with native TypeScript support (#37255)

### Packages impacted by this PR

`@azure/dev-tool`

### Issues associated with this PR

#36819

### Describe the problem that is addressed by this PR

Replace tsx runtime with Node's native TypeScript execution. This
simplifies the bootstrap chain and removes the tsx dependency.

Key changes:
- Add "type": "module" to package.json and set engines >= 22.6.0
- Convert launch.js, dtx.js to TypeScript with strip-types shebangs
- Delete register.js/register.d.ts (tsx loader no longer needed)
- Update tsconfig: module/moduleResolution to NodeNext, add
allowImportingTsExtensions and noEmit
- Replace all __dirname usage with import.meta.dirname
- Replace dynamic require() in resolveProject.ts with createRequire()
- Add .ts extensions to all relative imports (~82 files)
- Add JSON import assertions (with { type: "json" })
- Upgrade chalk from v4 to v5 (ESM-only)
- Remove tsx from dependencies

Author: xirzec

.nvmrc

@@ -1 +1 @@
-lts/iron
+lts/jod

common/tools/dev-tool/README.md

@@ -6,7 +6,7 @@ It provides a place to centralize scripts, resources, and processes for developm
 
 ## Installation
 
-`dev-tool` runs using [tsx](https://tsx.is/), so it does not need to be built. It is ready-to-go after a `pnpm install`. It additionally does not need to be installed to a user's machine in order to be used in `package.json` scripts, since it provides the `dev-tool` binary to any dependent packages through the `bin` entry in its `package.json`. Simply add `@azure/dev-tool` to the `devDependencies` of a package, and the `dev-tool` binary will become available. If you wish to use `dev-tool` from the CLI manually, you can run it from a service package using `npx dev-tool`, or you can install it globally on your system by running `npm install -g` from this directory.
+`dev-tool` runs TypeScript source directly using Node.js's built-in type stripping, so it does not need to be built. It is ready-to-go after a `pnpm install` (requires Node.js 22.18+). It additionally does not need to be installed to a user's machine in order to be used in `package.json` scripts, since it provides the `dev-tool` binary to any dependent packages through the `bin` entry in its `package.json`. Simply add `@azure/dev-tool` to the `devDependencies` of a package, and the `dev-tool` binary will become available. If you wish to use `dev-tool` from the CLI manually, you can run it from a service package using `npx dev-tool`, or you can install it globally on your system by running `npm install -g` from this directory.
 
 ## Usage
 

common/tools/dev-tool/dtx.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+/**
+ * This command is an alias for `dev-tool run vendored`
+ */
+
+import { spawn } from "node:child_process";
+import { resolve } from "node:path";
+
+const engine = process.argv0;
+
+const args = [
+  resolve(import.meta.dirname, "launch.ts"),
+  "run",
+  "vendored",
+  ...process.argv.slice(2),
+];
+
+const subProcess = spawn(engine, args, { stdio: "inherit" });
+
+subProcess.on("exit", (code, signal) => {
+  console.error(`subprocess exited with ${code} and signal ${signal}`);
+  process.exit(code ?? 0);
+});
+subProcess.on("error", (error) => {
+  console.error(error);
+  process.exit(1);
+});

common/tools/dev-tool/dtx.ts

@@ -3,7 +3,7 @@ import typescriptEsLint from "typescript-eslint";
 
 export default typescriptEsLint.config(
   {
-    ignores: ["**/test/samples/files/expectations/**/*.*", "**/*.{js,cjs,mjs}"],
+    ignores: ["**/test/samples/files/**/*.*", "**/*.{js,cjs,mjs}"],
   },
   {
     languageOptions: {
@@ -20,7 +20,7 @@ export default typescriptEsLint.config(
   {
     rules: {
       "@typescript-eslint/no-unused-vars": "off",
-      "@typescript-eslint/no-require-imports": "off",
+      "@typescript-eslint/consistent-type-imports": "error",
     },
   },
 );

common/tools/dev-tool/eslint.config.mjs

@@ -3,12 +3,10 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 
-const path = require("path");
+import "dotenv/config";
 
 if (process.env.DEBUG) {
-  console.info("Azure SDK for JS dev-tool: bootstrapping from", __dirname);
+  console.info("Azure SDK for JS dev-tool: bootstrapping from", import.meta.dirname);
 }
 
-require("./register");
-
-require(path.join(__dirname, "src", "index.ts"));
+await import("./src/index.ts");

common/tools/dev-tool/launch.js common/tools/dev-tool/launch.tscommon/tools/dev-tool/launch.js renamed to common/tools/dev-tool/launch.ts

@@ -1,11 +1,15 @@
 {
   "name": "@azure/dev-tool",
   "version": "1.0.0",
+  "type": "module",
   "description": "A helpful command for azure-sdk-for-js developers",
   "sdk-type": "utility",
   "bin": {
-    "dev-tool": "launch.js",
-    "dtx": "dtx.js"
+    "dev-tool": "launch.ts",
+    "dtx": "dtx.ts"
+  },
+  "engines": {
+    "node": ">=22.18.0"
   },
   "files": [
     "src"
@@ -47,7 +51,7 @@
     "@pnpm/catalogs.resolver": "^1000.0.3",
     "@pnpm/catalogs.types": "^1000.0.0",
     "@pnpm/workspace.read-manifest": "^1000.1.5",
-    "chalk": "^4.1.1",
+    "chalk": "^5.4.1",
     "concurrently": "^9.2.1",
     "diff": "^8.0.2",
     "dotenv": "^16.0.0",
@@ -60,7 +64,6 @@
     "tar": "^7.4.3",
     "ts-morph": "^27.0.0",
     "tslib": "^2.8.1",
-    "tsx": "catalog:",
     "typescript": "~6.0.2",
     "unzipper": "~0.12.3",
     "yaml": "^2.3.4"

common/tools/dev-tool/package.json

@@ -4,8 +4,8 @@ import {
   packageJsonCheck,
   enableForEsmPackage,
   enableForSdkType,
-} from "../framework/check";
-import { resolveRoot } from "../util/resolveProject";
+} from "../framework/check.ts";
+import { resolveRoot } from "../util/resolveProject.ts";
 
 /**
  * Expected value for engines field