Use eslint-plugin-simple-import-sort (microsoft#52090)

.eslintrc.json

@@ -11,7 +11,7 @@
         "es6": true
     },
     "plugins": [
-        "@typescript-eslint", "no-null", "import", "eslint-plugin-local"
+        "@typescript-eslint", "no-null", "import", "eslint-plugin-local", "simple-import-sort"
     ],
     "ignorePatterns": [
         "**/node_modules/**",
@@ -25,11 +25,8 @@
         "/coverage/**"
     ],
     "rules": {
-        "sort-imports": ["error", {
-            "ignoreCase": true,
-            "ignoreDeclarationSort": true,
-            "allowSeparatedGroups": true
-        }],
+        "simple-import-sort/imports": "error",
+        "simple-import-sort/exports": "error",
 
         "@typescript-eslint/adjacent-overload-signatures": "error",
         "@typescript-eslint/array-type": "error",
@@ -180,6 +177,14 @@
                     { "name": "exports" }
                 ]
             }
+        },
+        {
+            // These files contain imports in a specific order that are generally unsafe to modify.
+            "files": ["**/_namespaces/**"],
+            "rules": {
+                "simple-import-sort/imports": "off",
+                "simple-import-sort/exports": "off"
+            }
         }
     ]
 }

.vscode/settings.template.json

@@ -13,6 +13,14 @@
     //     ".git-blame-ignore-revs"
     // ]
 
+    // Match eslint-plugin-simple-import-sort in organize/auto-imports.
+    "typescript.unstable": {
+        "organizeImportsCollation": "unicode",
+        "organizeImportsCaseFirst": "upper",
+        "organizeImportsIgnoreCase": false,
+        "organizeImportsNumericCollation": true
+    },
+
     // These options search the repo recursively and slow down
     // the build task menu. We define our own in tasks.json.
     "typescript.tsc.autoDetect": "off",

Herebyfile.mjs

@@ -1,21 +1,22 @@
 // @ts-check
-import path from "path";
-import fs from "fs";
+import { CancelToken } from "@esfx/canceltoken";
+import chalk from "chalk";
+import chokidar from "chokidar";
 import del from "del";
-import { task } from "hereby";
+import esbuild from "esbuild";
+import { EventEmitter } from "events";
+import fs from "fs";
+import fsExtra from "fs-extra";
 import _glob from "glob";
+import { task } from "hereby";
+import path from "path";
 import util from "util";
-import chalk from "chalk";
-import fsExtra from "fs-extra";
-import { Debouncer, Deferred, exec, getDiffTool, getDirSize, memoize, needsUpdate, readJson } from "./scripts/build/utils.mjs";
-import { localBaseline, localRwcBaseline, refBaseline, refRwcBaseline, runConsoleTests } from "./scripts/build/tests.mjs";
-import { buildProject, cleanProject, watchProject } from "./scripts/build/projects.mjs";
+
 import { localizationDirectories } from "./scripts/build/localization.mjs";
 import cmdLineOptions from "./scripts/build/options.mjs";
-import esbuild from "esbuild";
-import chokidar from "chokidar";
-import { EventEmitter } from "events";
-import { CancelToken } from "@esfx/canceltoken";
+import { buildProject, cleanProject, watchProject } from "./scripts/build/projects.mjs";
+import { localBaseline, localRwcBaseline, refBaseline, refRwcBaseline, runConsoleTests } from "./scripts/build/tests.mjs";
+import { Debouncer, Deferred, exec, getDiffTool, getDirSize, memoize, needsUpdate, readJson } from "./scripts/build/utils.mjs";
 
 const glob = util.promisify(_glob);
 

package.json

@@ -66,6 +66,7 @@
         "eslint-plugin-import": "^2.26.0",
         "eslint-plugin-local": "^1.0.0",
         "eslint-plugin-no-null": "^1.0.2",
+        "eslint-plugin-simple-import-sort": "^10.0.0",
         "fast-xml-parser": "^4.0.11",
         "fs-extra": "^9.1.0",
         "glob": "latest",

scripts/browserIntegrationTest.mjs

@@ -1,6 +1,6 @@
 import chalk from "chalk";
-import { join } from "path";
 import { readFileSync } from "fs";
+import { join } from "path";
 
 let playwright;
 try {

scripts/build/findUpDir.mjs

@@ -1,5 +1,5 @@
-import { dirname, join, resolve } from "path";
 import { existsSync } from "fs";
+import { dirname, join, resolve } from "path";
 import url from "url";
 
 const __filename = url.fileURLToPath(new URL(import.meta.url));

scripts/build/projects.mjs

@@ -1,7 +1,8 @@
-import { Debouncer, exec } from "./utils.mjs";
 import { resolve } from "path";
+
 import { findUpRoot } from "./findUpDir.mjs";
 import cmdLineOptions from "./options.mjs";
+import { Debouncer, exec } from "./utils.mjs";
 
 class ProjectQueue {
     /**

scripts/build/tests.mjs

@@ -1,12 +1,13 @@
+import { CancelError } from "@esfx/canceltoken";
+import chalk from "chalk";
 import del from "del";
 import fs from "fs";
 import os from "os";
 import path from "path";
-import chalk from "chalk";
+
+import { findUpFile, findUpRoot } from "./findUpDir.mjs";
 import cmdLineOptions from "./options.mjs";
 import { exec } from "./utils.mjs";
-import { findUpFile, findUpRoot } from "./findUpDir.mjs";
-import { CancelError } from "@esfx/canceltoken";
 
 const mochaJs = path.resolve(findUpRoot(), "node_modules", "mocha", "bin", "_mocha");
 export const localBaseline = "tests/baselines/local/";

scripts/build/utils.mjs

@@ -1,13 +1,13 @@
 /* eslint-disable no-restricted-globals */
 
-import fs from "fs";
-import path from "path";
+import { CancelError } from "@esfx/canceltoken";
+import assert from "assert";
 import chalk from "chalk";
-import which from "which";
 import { spawn } from "child_process";
-import assert from "assert";
+import fs from "fs";
 import JSONC from "jsonc-parser";
-import { CancelError } from "@esfx/canceltoken";
+import path from "path";
+import which from "which";
 
 /**
  * Executes the provided command once with the supplied arguments.

scripts/configurePrerelease.mjs

@@ -1,6 +1,6 @@
-import { normalize, relative } from "path";
 import assert from "assert";
 import { readFileSync, writeFileSync } from "fs";
+import { normalize, relative } from "path";
 import url from "url";
 
 const __filename = url.fileURLToPath(new URL(import.meta.url));

scripts/dtsBundler.mjs

@@ -5,12 +5,13 @@
  * bundle as namespaces again, even though the project is modules.
  */
 
+import assert, { fail } from "assert";
 import fs from "fs";
-import path from "path";
 import minimist from "minimist";
+import path from "path";
 import url from "url";
+
 import ts from "../lib/typescript.js";
-import assert, { fail } from "assert";
 
 const __filename = url.fileURLToPath(new URL(import.meta.url));
 const __dirname = path.dirname(__filename);

scripts/find-unused-diganostic-messages.mjs

@@ -1,9 +1,9 @@
 // This file requires a modern version of node 14+, and grep to be available.
 
 // node scripts/find-unused-diagnostic-messages.mjs
+import { execSync } from "child_process";
 import { readFileSync } from "fs";
 import { EOL } from "os";
-import { execSync } from "child_process";
 
 const diags = readFileSync("src/compiler/diagnosticInformationMap.generated.ts", "utf8");
 const startOfDiags = diags.split("export const Diagnostics")[1];

scripts/generateLocalizedDiagnosticMessages.mjs

@@ -1,6 +1,6 @@
+import { XMLParser } from "fast-xml-parser";
 import fs from "fs";
 import path from "path";
-import { XMLParser } from "fast-xml-parser";
 
 /** @typedef {{
     LCX: {

scripts/importDefinitelyTypedTests.mjs

@@ -1,7 +1,7 @@
+import * as childProcess from "child_process";
 import * as fs from "fs";
-import * as path from "path";
 import * as os from "os";
-import * as childProcess from "child_process";
+import * as path from "path";
 import url from "url";
 
 const __filename = url.fileURLToPath(new URL(import.meta.url));

scripts/link-hooks.mjs

@@ -1,6 +1,7 @@
 import fs from "fs";
 import path from "path";
 import url from "url";
+
 import { findUpRoot } from "./build/findUpDir.mjs";
 
 const __filename = url.fileURLToPath(new URL(import.meta.url));

scripts/open-cherry-pick-pr.mjs

@@ -1,9 +1,10 @@
 import { Octokit } from "@octokit/rest";
-import { runSequence } from "./run-sequence.mjs";
 import fs from "fs";
 import path from "path";
 import url from "url";
 
+import { runSequence } from "./run-sequence.mjs";
+
 const __filename = url.fileURLToPath(new URL(import.meta.url));
 const __dirname = path.dirname(__filename);
 

scripts/open-user-pr.mjs

@@ -1,4 +1,5 @@
 import { Octokit } from "@octokit/rest";
+
 import { runSequence } from "./run-sequence.mjs";
 
 const userName = process.env.GH_USERNAME || "typescript-bot";

scripts/perf-result-post.mjs

@@ -1,8 +1,8 @@
 import { Octokit } from "@octokit/rest";
-import fs from "fs";
+import assert from "assert";
 import ado from "azure-devops-node-api";
+import fs from "fs";
 import fetch from "node-fetch";
-import assert from "assert";
 
 
 async function main() {

scripts/processDiagnosticMessages.mjs

@@ -1,5 +1,5 @@
-import path from "path";
 import fs from "fs";
+import path from "path";
 
 /** @typedef {{
     category: string;

scripts/produceLKG.mjs

@@ -1,8 +1,9 @@
+import del from "del";
 import fs from "fs-extra";
-import path from "path";
 import glob from "glob";
+import path from "path";
 import url from "url";
-import del from "del";
+
 import { localizationDirectories } from "./build/localization.mjs";
 
 const __filename = url.fileURLToPath(new URL(import.meta.url));

scripts/update-experimental-branches.mjs

@@ -1,4 +1,5 @@
 import { Octokit } from "@octokit/rest";
+
 import { runSequence } from "./run-sequence.mjs";
 
 // The first is used by bot-based kickoffs, the second by automatic triggers

src/compiler/checker.ts

@@ -1062,8 +1062,8 @@ import {
     WithStatement,
     YieldExpression,
 } from "./_namespaces/ts";
-import * as performance from "./_namespaces/ts.performance";
 import * as moduleSpecifiers from "./_namespaces/ts.moduleSpecifiers";
+import * as performance from "./_namespaces/ts.performance";
 
 const ambientModuleSymbolRegex = /^".+"$/;
 const anon = "(anonymous)" as __String & string;

src/compiler/moduleNameResolver.ts

@@ -103,8 +103,8 @@ import {
     tryExtractTSExtension,
     tryGetExtensionFromPath,
     tryParsePatterns,
-    version,
     Version,
+    version,
     versionMajorMinor,
     VersionRange,
 } from "./_namespaces/ts";

src/compiler/transformer.ts

@@ -55,14 +55,14 @@ import {
     transformECMAScriptModule,
     Transformer,
     TransformerFactory,
+    transformES5,
     transformES2015,
     transformES2016,
     transformES2017,
     transformES2018,
     transformES2019,
     transformES2020,
     transformES2021,
-    transformES5,
     transformESDecorators,
     transformESNext,
     transformGenerators,

src/compiler/utilities.ts

@@ -199,8 +199,8 @@ import {
     HasExpressionInitializer,
     hasExtension,
     HasFlowNode,
-    hasInitializer,
     HasInitializer,
+    hasInitializer,
     HasJSDoc,
     hasJSDocNodes,
     HasModifiers,

src/deprecatedCompat/deprecate.ts

@@ -3,8 +3,8 @@ import {
     DeprecationOptions,
     formatStringFromArgs,
     noop,
-    version,
     Version,
+    version,
 } from "./_namespaces/ts";
 
 export let enableDeprecationWarnings = true;

src/executeCommandLine/executeCommandLine.ts

@@ -1,3 +1,4 @@
+import * as performance from "../compiler/_namespaces/ts.performance";
 import * as ts from "./_namespaces/ts";
 import {
     arrayFrom,
@@ -19,8 +20,8 @@ import {
     createDiagnosticReporter,
     createGetCanonicalFileName,
     createIncrementalCompilerHost,
-    createProgram,
     CreateProgram,
+    createProgram,
     CreateProgramOptions,
     createSolutionBuilder,
     createSolutionBuilderHost,
@@ -87,7 +88,6 @@ import {
     WatchCompilerHost,
     WatchOptions,
 } from "./_namespaces/ts";
-import * as performance from "../compiler/_namespaces/ts.performance";
 
 interface Statistic {
     name: string;