refactor: make JS executables included in the tsconfig for editor hints (#6861)

* refactor: make JS executables included in the tsconfig for editor hints

* oops

packages/docusaurus-migrate/bin/index.mjs

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+// @ts-check
+
+import logger from '@docusaurus/logger';
+import semver from 'semver';
+import cli from 'commander';
+import path from 'path';
+import {createRequire} from 'module';
+
+const moduleRequire = createRequire(import.meta.url);
+const requiredVersion = moduleRequire('../package.json').engines.node;
+
+if (!semver.satisfies(process.version, requiredVersion)) {
+  logger.error('Minimum Node.js version not met :(');
+  logger.info`You are using Node.js number=${process.version}, Requirement: Node.js number=${requiredVersion}.`;
+  process.exit(1);
+}
+
+// See https://github.com/facebook/docusaurus/pull/6860
+const {migrateDocusaurusProject, migrateMDToMDX} =
+  moduleRequire('../lib/index.js');
+
+cli
+  .command('migrate [siteDir] [newDir]')
+  .option('--mdx', 'try to migrate MD to MDX too')
+  .option('--page', 'try to migrate pages too')
+  .description('Migrate between versions of Docusaurus website.')
+  .action((siteDir = '.', newDir = '.', {mdx, page} = {}) => {
+    const sitePath = path.resolve(siteDir);
+    const newSitePath = path.resolve(newDir);
+    migrateDocusaurusProject(sitePath, newSitePath, mdx, page);
+  });
+
+cli
+  .command('mdx [siteDir] [newDir]')
+  .description('Migrate markdown files to MDX.')
+  .action((siteDir = '.', newDir = '.') => {
+    const sitePath = path.resolve(siteDir);
+    const newSitePath = path.resolve(newDir);
+    migrateMDToMDX(sitePath, newSitePath);
+  });
+
+cli.parse(process.argv);
+
+if (!process.argv.slice(2).length) {
+  cli.outputHelp();
+}
+
+process.on('unhandledRejection', (err) => {
+  logger.error(err);
+  process.exit(1);
+});