[generated] Run dprint

[git-generate]
test -f ./node_modules/.bin/dprint || npm ci
npx dprint fmt

Author: jakebailey

.eslintrc.json

@@ -34,14 +34,53 @@
 
         "@typescript-eslint/naming-convention": [
             "error",
-            { "selector": "typeLike", "format": ["PascalCase"], "filter": { "regex": "^(__String|[A-Za-z]+_[A-Za-z]+)$", "match": false } },
-            { "selector": "interface", "format": ["PascalCase"], "custom": { "regex": "^I[A-Z]", "match": false }, "filter": { "regex": "^I(Arguments|TextWriter|O([A-Z][a-z]+[A-Za-z]*)?)$", "match": false } },
-            { "selector": "variable", "format": ["camelCase", "PascalCase", "UPPER_CASE"], "leadingUnderscore": "allow", "filter": { "regex": "^(_{1,2}filename|_{1,2}dirname|_+|[A-Za-z]+_[A-Za-z]+)$", "match": false } },
-            { "selector": "function", "format": ["camelCase", "PascalCase"], "leadingUnderscore": "allow", "filter": { "regex": "^[A-Za-z]+_[A-Za-z]+$", "match": false } },
-            { "selector": "parameter", "format": ["camelCase"], "leadingUnderscore": "allow", "filter": { "regex": "^(_+|[A-Za-z]+_[A-Z][a-z]+)$", "match": false } },
-            { "selector": "method", "format": ["camelCase", "PascalCase"], "leadingUnderscore": "allow", "filter": { "regex": "^([0-9]+|[A-Za-z]+_[A-Za-z]+)$", "match": false } },
-            { "selector": "memberLike", "format": ["camelCase"], "leadingUnderscore": "allow", "filter": { "regex": "^([0-9]+|[A-Za-z]+_[A-Za-z]+)$", "match": false } },
-            { "selector": "enumMember", "format": ["camelCase", "PascalCase"], "leadingUnderscore": "allow", "filter": { "regex": "^[A-Za-z]+_[A-Za-z]+$", "match": false } },
+            {
+                "selector": "typeLike",
+                "format": ["PascalCase"],
+                "filter": { "regex": "^(__String|[A-Za-z]+_[A-Za-z]+)$", "match": false }
+            },
+            {
+                "selector": "interface",
+                "format": ["PascalCase"],
+                "custom": { "regex": "^I[A-Z]", "match": false },
+                "filter": { "regex": "^I(Arguments|TextWriter|O([A-Z][a-z]+[A-Za-z]*)?)$", "match": false }
+            },
+            {
+                "selector": "variable",
+                "format": ["camelCase", "PascalCase", "UPPER_CASE"],
+                "leadingUnderscore": "allow",
+                "filter": { "regex": "^(_{1,2}filename|_{1,2}dirname|_+|[A-Za-z]+_[A-Za-z]+)$", "match": false }
+            },
+            {
+                "selector": "function",
+                "format": ["camelCase", "PascalCase"],
+                "leadingUnderscore": "allow",
+                "filter": { "regex": "^[A-Za-z]+_[A-Za-z]+$", "match": false }
+            },
+            {
+                "selector": "parameter",
+                "format": ["camelCase"],
+                "leadingUnderscore": "allow",
+                "filter": { "regex": "^(_+|[A-Za-z]+_[A-Z][a-z]+)$", "match": false }
+            },
+            {
+                "selector": "method",
+                "format": ["camelCase", "PascalCase"],
+                "leadingUnderscore": "allow",
+                "filter": { "regex": "^([0-9]+|[A-Za-z]+_[A-Za-z]+)$", "match": false }
+            },
+            {
+                "selector": "memberLike",
+                "format": ["camelCase"],
+                "leadingUnderscore": "allow",
+                "filter": { "regex": "^([0-9]+|[A-Za-z]+_[A-Za-z]+)$", "match": false }
+            },
+            {
+                "selector": "enumMember",
+                "format": ["camelCase", "PascalCase"],
+                "leadingUnderscore": "allow",
+                "filter": { "regex": "^[A-Za-z]+_[A-Za-z]+$", "match": false }
+            },
             { "selector": "property", "format": null }
         ],
 
@@ -99,7 +138,15 @@
         "no-new-func": "error",
         "no-new-wrappers": "error",
         "no-return-await": "error",
-        "no-restricted-globals": ["error", { "name": "setTimeout" }, { "name": "clearTimeout" }, { "name": "setInterval" }, { "name": "clearInterval" }, { "name": "setImmediate" }, { "name": "clearImmediate" }],
+        "no-restricted-globals": [
+            "error",
+            { "name": "setTimeout" },
+            { "name": "clearTimeout" },
+            { "name": "setInterval" },
+            { "name": "clearInterval" },
+            { "name": "setImmediate" },
+            { "name": "clearImmediate" }
+        ],
         "no-sparse-arrays": "error",
         "no-template-curly-in-string": "error",
         "no-throw-literal": "error",
@@ -133,7 +180,14 @@
             "files": ["*.mjs", "*.mts"],
             "rules": {
                 // These globals don't exist outside of CJS files.
-                "no-restricted-globals": ["error", { "name": "__filename" }, { "name": "__dirname" }, { "name": "require" }, { "name": "module" }, { "name": "exports" }]
+                "no-restricted-globals": [
+                    "error",
+                    { "name": "__filename" },
+                    { "name": "__dirname" },
+                    { "name": "require" },
+                    { "name": "module" },
+                    { "name": "exports" }
+                ]
             }
         }
     ]

.vscode/settings.template.json

@@ -10,7 +10,7 @@
     "[typescript][javascript][json][jsonc]": {
         // "editor.formatOnSave": true,
         "editor.defaultFormatter": "dprint.dprint"
-    }
+    },
 
     // To ignore commits listed in .git-blame-ignore-revs in GitLens:
     // "gitlens.advanced.blame.customArguments": [

Herebyfile.mjs

@@ -6,8 +6,23 @@ import { task } from "hereby";
 import _glob from "glob";
 import util from "util";
 import chalk from "chalk";
-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 {
+    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";
@@ -109,7 +124,12 @@ const localize = task({
     dependencies: [generateDiagnostics],
     run: async () => {
         if (needsUpdate(diagnosticMessagesGeneratedJson, generatedLCGFile)) {
-            await exec(process.execPath, ["scripts/generateLocalizedDiagnosticMessages.mjs", "src/loc/lcl", "built/local", diagnosticMessagesGeneratedJson], { ignoreExitCode: true });
+            await exec(process.execPath, [
+                "scripts/generateLocalizedDiagnosticMessages.mjs",
+                "src/loc/lcl",
+                "built/local",
+                diagnosticMessagesGeneratedJson,
+            ], { ignoreExitCode: true });
         }
     },
 });
@@ -195,7 +215,9 @@ function createBundler(entrypoint, outfile, taskOptions = {}) {
                             //
                             // See: https://github.com/evanw/esbuild/issues/1958
                             return {
-                                errors: [{ text: 'Attempted to bundle from node_modules; ensure "external" is set correctly.' }],
+                                errors: [{
+                                    text: 'Attempted to bundle from node_modules; ensure "external" is set correctly.',
+                                }],
                             };
                         });
                     },
@@ -237,7 +259,8 @@ function createBundler(entrypoint, outfile, taskOptions = {}) {
 
     return {
         build: async () => esbuild.build(await getOptions()),
-        watch: async () => esbuild.build({ ...await getOptions(), watch: taskOptions.watchMode ?? true, logLevel: "info" }),
+        watch: async () =>
+            esbuild.build({ ...await getOptions(), watch: taskOptions.watchMode ?? true, logLevel: "info" }),
     };
 }
 
@@ -288,7 +311,10 @@ function entrypointBuildTask(options) {
             const outDir = path.dirname(options.output);
             await fs.promises.mkdir(outDir, { recursive: true });
             const moduleSpecifier = path.relative(outDir, options.builtEntrypoint);
-            await fs.promises.writeFile(options.output, `module.exports = require("./${moduleSpecifier.replace(/[\\/]/g, "/")}")`);
+            await fs.promises.writeFile(
+                options.output,
+                `module.exports = require("./${moduleSpecifier.replace(/[\\/]/g, "/")}")`,
+            );
         },
     });
 
@@ -312,13 +338,19 @@ function entrypointBuildTask(options) {
     const watch = task({
         name: `watch-${options.name}`,
         hiddenFromTaskList: true, // This is best effort.
-        dependencies: (options.buildDeps ?? []).concat(options.mainDeps ?? []).concat(cmdLineOptions.bundle ? [] : [shim]),
+        dependencies: (options.buildDeps ?? []).concat(options.mainDeps ?? []).concat(
+            cmdLineOptions.bundle ? [] : [shim],
+        ),
         run: () => {
             // These watch functions return promises that resolve once watch mode has started,
             // allowing them to operate as regular tasks, while creating unresolved promises
             // in the background that keep the process running after all tasks have exited.
             if (!printedWatchWarning) {
-                console.error(chalk.yellowBright("Warning: watch mode is incomplete and may not work as expected. Use at your own risk."));
+                console.error(
+                    chalk.yellowBright(
+                        "Warning: watch mode is incomplete and may not work as expected. Use at your own risk.",
+                    ),
+                );
                 printedWatchWarning = true;
             }
 
@@ -362,7 +394,12 @@ export const dtsServices = task({
     description: "Bundles typescript.d.ts",
     dependencies: [buildServices],
     run: async () => {
-        if (needsUpdate("./built/local/typescript/tsconfig.tsbuildinfo", ["./built/local/typescript.d.ts", "./built/local/typescript.internal.d.ts"])) {
+        if (
+            needsUpdate("./built/local/typescript/tsconfig.tsbuildinfo", [
+                "./built/local/typescript.d.ts",
+                "./built/local/typescript.internal.d.ts",
+            ])
+        ) {
             await runDtsBundler("./built/local/typescript/typescript.d.ts", "./built/local/typescript.d.ts");
         }
     },
@@ -411,8 +448,16 @@ export const dtsLssl = task({
     description: "Bundles tsserverlibrary.d.ts",
     dependencies: [buildLssl],
     run: async () => {
-        if (needsUpdate("./built/local/tsserverlibrary/tsconfig.tsbuildinfo", ["./built/local/tsserverlibrary.d.ts", "./built/local/tsserverlibrary.internal.d.ts"])) {
-            await runDtsBundler("./built/local/tsserverlibrary/tsserverlibrary.d.ts", "./built/local/tsserverlibrary.d.ts");
+        if (
+            needsUpdate("./built/local/tsserverlibrary/tsconfig.tsbuildinfo", [
+                "./built/local/tsserverlibrary.d.ts",
+                "./built/local/tsserverlibrary.internal.d.ts",
+            ])
+        ) {
+            await runDtsBundler(
+                "./built/local/tsserverlibrary/tsserverlibrary.d.ts",
+                "./built/local/tsserverlibrary.d.ts",
+            );
         }
     },
 });
@@ -545,7 +590,13 @@ export const watchOtherOutputs = task({
     name: "watch-other-outputs",
     description: "Builds miscelaneous scripts and documents distributed with the LKG",
     hiddenFromTaskList: true,
-    dependencies: [watchCancellationToken, watchTypingsInstaller, watchWatchGuard, generateTypesMap, copyBuiltLocalDiagnosticMessages],
+    dependencies: [
+        watchCancellationToken,
+        watchTypingsInstaller,
+        watchWatchGuard,
+        generateTypesMap,
+        copyBuiltLocalDiagnosticMessages,
+    ],
 });
 
 export const local = task({
@@ -623,7 +674,10 @@ export const runTestsAndWatch = task({
             if (!token.signaled) {
                 running = true;
                 try {
-                    await runConsoleTests(testRunner, "mocha-fivemat-progress-reporter", /*runInParallel*/ false, { token, watching: true });
+                    await runConsoleTests(testRunner, "mocha-fivemat-progress-reporter", /*runInParallel*/ false, {
+                        token,
+                        watching: true,
+                    });
                 }
                 catch {
                     // ignore
@@ -782,7 +836,10 @@ export const updateSublime = task({
     dependencies: [tsserver],
     run: async () => {
         for (const file of ["built/local/tsserver.js", "built/local/tsserver.js.map"]) {
-            await fs.promises.copyFile(file, path.resolve("../TypeScript-Sublime-Plugin/tsserver/", path.basename(file)));
+            await fs.promises.copyFile(
+                file,
+                path.resolve("../TypeScript-Sublime-Plugin/tsserver/", path.basename(file)),
+            );
         }
     },
 });
@@ -818,7 +875,10 @@ export const produceLKG = task({
             .concat(localizationTargets)
             .filter(f => !fs.existsSync(f));
         if (missingFiles.length > 0) {
-            throw new Error("Cannot replace the LKG unless all built targets are present in directory 'built/local/'. The following files are missing:\n" + missingFiles.join("\n"));
+            throw new Error(
+                "Cannot replace the LKG unless all built targets are present in directory 'built/local/'. The following files are missing:\n"
+                    + missingFiles.join("\n"),
+            );
         }
         const sizeBefore = getDirSize("lib");
         await exec(process.execPath, ["scripts/produceLKG.mjs"]);
@@ -839,7 +899,13 @@ export const generateSpec = task({
     name: "generate-spec",
     description: "Generates a Markdown version of the Language Specification",
     hiddenFromTaskList: true,
-    run: () => exec("cscript", ["//nologo", "scripts/word2md.mjs", path.resolve("doc/TypeScript Language Specification - ARCHIVED.docx"), path.resolve("doc/spec-ARCHIVED.md")]),
+    run: () =>
+        exec("cscript", [
+            "//nologo",
+            "scripts/word2md.mjs",
+            path.resolve("doc/TypeScript Language Specification - ARCHIVED.docx"),
+            path.resolve("doc/spec-ARCHIVED.md"),
+        ]),
 });
 
 export const cleanBuilt = task({
@@ -857,19 +923,37 @@ export const clean = task({
 export const configureNightly = task({
     name: "configure-nightly",
     description: "Runs scripts/configurePrerelease.mjs to prepare a build for nightly publishing",
-    run: () => exec(process.execPath, ["scripts/configurePrerelease.mjs", "dev", "package.json", "src/compiler/corePublic.ts"]),
+    run: () =>
+        exec(process.execPath, [
+            "scripts/configurePrerelease.mjs",
+            "dev",
+            "package.json",
+            "src/compiler/corePublic.ts",
+        ]),
 });
 
 export const configureInsiders = task({
     name: "configure-insiders",
     description: "Runs scripts/configurePrerelease.mjs to prepare a build for insiders publishing",
-    run: () => exec(process.execPath, ["scripts/configurePrerelease.mjs", "insiders", "package.json", "src/compiler/corePublic.ts"]),
+    run: () =>
+        exec(process.execPath, [
+            "scripts/configurePrerelease.mjs",
+            "insiders",
+            "package.json",
+            "src/compiler/corePublic.ts",
+        ]),
 });
 
 export const configureExperimental = task({
     name: "configure-experimental",
     description: "Runs scripts/configurePrerelease.mjs to prepare a build for experimental publishing",
-    run: () => exec(process.execPath, ["scripts/configurePrerelease.mjs", "experimental", "package.json", "src/compiler/corePublic.ts"]),
+    run: () =>
+        exec(process.execPath, [
+            "scripts/configurePrerelease.mjs",
+            "experimental",
+            "package.json",
+            "src/compiler/corePublic.ts",
+        ]),
 });
 
 export const help = task({

scripts/build/localization.mjs

@@ -1 +1,15 @@
-export const localizationDirectories = ["cs", "de", "es", "fr", "it", "ja", "ko", "pl", "pt-br", "ru", "tr", "zh-cn", "zh-tw"].map(f => f.toLowerCase());
+export const localizationDirectories = [
+    "cs",
+    "de",
+    "es",
+    "fr",
+    "it",
+    "ja",
+    "ko",
+    "pl",
+    "pt-br",
+    "ru",
+    "tr",
+    "zh-cn",
+    "zh-tw",
+].map(f => f.toLowerCase());

scripts/build/options.mjs

@@ -4,7 +4,21 @@ import os from "os";
 const ci = ["1", "true"].includes(process.env.CI ?? "");
 
 const parsed = minimist(process.argv.slice(2), {
-    boolean: ["dirty", "light", "colors", "lkg", "soft", "fix", "failed", "keepFailed", "force", "built", "ci", "bundle", "typecheck"],
+    boolean: [
+        "dirty",
+        "light",
+        "colors",
+        "lkg",
+        "soft",
+        "fix",
+        "failed",
+        "keepFailed",
+        "force",
+        "built",
+        "ci",
+        "bundle",
+        "typecheck",
+    ],
     string: ["browser", "tests", "break", "host", "reporter", "stackTraceLimit", "timeout", "shards", "shardId"],
     alias: {
         /* eslint-disable quote-props */

scripts/build/projects.mjs

@@ -29,9 +29,16 @@ class ProjectQueue {
     }
 }
 
-const execTsc = (/** @type {string[]} */ ...args) => exec(process.execPath, [resolve(findUpRoot(), cmdLineOptions.lkg ? "./lib/tsc.js" : "./built/local/tsc.js"), "-b", ...args], { hidePrompt: true });
-
-const projectBuilder = new ProjectQueue(projects => execTsc(...(cmdLineOptions.bundle ? [] : ["--emitDeclarationOnly", "false"]), ...projects));
+const execTsc = (/** @type {string[]} */ ...args) =>
+    exec(process.execPath, [
+        resolve(findUpRoot(), cmdLineOptions.lkg ? "./lib/tsc.js" : "./built/local/tsc.js"),
+        "-b",
+        ...args,
+    ], { hidePrompt: true });
+
+const projectBuilder = new ProjectQueue(projects =>
+    execTsc(...(cmdLineOptions.bundle ? [] : ["--emitDeclarationOnly", "false"]), ...projects)
+);
 
 /**
  * @param {string} project