@eclipse-scout/migrate 23.1.1

package/LICENSE

@@ -0,0 +1,277 @@
+Eclipse Public License - v 2.0
+
+    THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+    PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION
+    OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.
+
+1. DEFINITIONS
+
+"Contribution" means:
+
+  a) in the case of the initial Contributor, the initial content
+     Distributed under this Agreement, and
+
+  b) in the case of each subsequent Contributor:
+     i) changes to the Program, and
+     ii) additions to the Program;
+  where such changes and/or additions to the Program originate from
+  and are Distributed by that particular Contributor. A Contribution
+  "originates" from a Contributor if it was added to the Program by
+  such Contributor itself or anyone acting on such Contributor's behalf.
+  Contributions do not include changes or additions to the Program that
+  are not Modified Works.
+
+"Contributor" means any person or entity that Distributes the Program.
+
+"Licensed Patents" mean patent claims licensable by a Contributor which
+are necessarily infringed by the use or sale of its Contribution alone
+or when combined with the Program.
+
+"Program" means the Contributions Distributed in accordance with this
+Agreement.
+
+"Recipient" means anyone who receives the Program under this Agreement
+or any Secondary License (as applicable), including Contributors.
+
+"Derivative Works" shall mean any work, whether in Source Code or other
+form, that is based on (or derived from) the Program and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship.
+
+"Modified Works" shall mean any work in Source Code or other form that
+results from an addition to, deletion from, or modification of the
+contents of the Program, including, for purposes of clarity any new file
+in Source Code form that contains any contents of the Program. Modified
+Works shall not include works that contain only declarations,
+interfaces, types, classes, structures, or files of the Program solely
+in each case in order to link to, bind by name, or subclass the Program
+or Modified Works thereof.
+
+"Distribute" means the acts of a) distributing or b) making available
+in any manner that enables the transfer of a copy.
+
+"Source Code" means the form of a Program preferred for making
+modifications, including but not limited to software source code,
+documentation source, and configuration files.
+
+"Secondary License" means either the GNU General Public License,
+Version 2.0, or any later versions of that license, including any
+exceptions or additional permissions as identified by the initial
+Contributor.
+
+2. GRANT OF RIGHTS
+
+  a) Subject to the terms of this Agreement, each Contributor hereby
+  grants Recipient a non-exclusive, worldwide, royalty-free copyright
+  license to reproduce, prepare Derivative Works of, publicly display,
+  publicly perform, Distribute and sublicense the Contribution of such
+  Contributor, if any, and such Derivative Works.
+
+  b) Subject to the terms of this Agreement, each Contributor hereby
+  grants Recipient a non-exclusive, worldwide, royalty-free patent
+  license under Licensed Patents to make, use, sell, offer to sell,
+  import and otherwise transfer the Contribution of such Contributor,
+  if any, in Source Code or other form. This patent license shall
+  apply to the combination of the Contribution and the Program if, at
+  the time the Contribution is added by the Contributor, such addition
+  of the Contribution causes such combination to be covered by the
+  Licensed Patents. The patent license shall not apply to any other
+  combinations which include the Contribution. No hardware per se is
+  licensed hereunder.
+
+  c) Recipient understands that although each Contributor grants the
+  licenses to its Contributions set forth herein, no assurances are
+  provided by any Contributor that the Program does not infringe the
+  patent or other intellectual property rights of any other entity.
+  Each Contributor disclaims any liability to Recipient for claims
+  brought by any other entity based on infringement of intellectual
+  property rights or otherwise. As a condition to exercising the
+  rights and licenses granted hereunder, each Recipient hereby
+  assumes sole responsibility to secure any other intellectual
+  property rights needed, if any. For example, if a third party
+  patent license is required to allow Recipient to Distribute the
+  Program, it is Recipient's responsibility to acquire that license
+  before distributing the Program.
+
+  d) Each Contributor represents that to its knowledge it has
+  sufficient copyright rights in its Contribution, if any, to grant
+  the copyright license set forth in this Agreement.
+
+  e) Notwithstanding the terms of any Secondary License, no
+  Contributor makes additional grants to any Recipient (other than
+  those set forth in this Agreement) as a result of such Recipient's
+  receipt of the Program under the terms of a Secondary License
+  (if permitted under the terms of Section 3).
+
+3. REQUIREMENTS
+
+3.1 If a Contributor Distributes the Program in any form, then:
+
+  a) the Program must also be made available as Source Code, in
+  accordance with section 3.2, and the Contributor must accompany
+  the Program with a statement that the Source Code for the Program
+  is available under this Agreement, and informs Recipients how to
+  obtain it in a reasonable manner on or through a medium customarily
+  used for software exchange; and
+
+  b) the Contributor may Distribute the Program under a license
+  different than this Agreement, provided that such license:
+     i) effectively disclaims on behalf of all other Contributors all
+     warranties and conditions, express and implied, including
+     warranties or conditions of title and non-infringement, and
+     implied warranties or conditions of merchantability and fitness
+     for a particular purpose;
+
+     ii) effectively excludes on behalf of all other Contributors all
+     liability for damages, including direct, indirect, special,
+     incidental and consequential damages, such as lost profits;
+
+     iii) does not attempt to limit or alter the recipients' rights
+     in the Source Code under section 3.2; and
+
+     iv) requires any subsequent distribution of the Program by any
+     party to be under a license that satisfies the requirements
+     of this section 3.
+
+3.2 When the Program is Distributed as Source Code:
+
+  a) it must be made available under this Agreement, or if the
+  Program (i) is combined with other material in a separate file or
+  files made available under a Secondary License, and (ii) the initial
+  Contributor attached to the Source Code the notice described in
+  Exhibit A of this Agreement, then the Program may be made available
+  under the terms of such Secondary Licenses, and
+
+  b) a copy of this Agreement must be included with each copy of
+  the Program.
+
+3.3 Contributors may not remove or alter any copyright, patent,
+trademark, attribution notices, disclaimers of warranty, or limitations
+of liability ("notices") contained within the Program from any copy of
+the Program which they Distribute, provided that Contributors may add
+their own appropriate notices.
+
+4. COMMERCIAL DISTRIBUTION
+
+Commercial distributors of software may accept certain responsibilities
+with respect to end users, business partners and the like. While this
+license is intended to facilitate the commercial use of the Program,
+the Contributor who includes the Program in a commercial product
+offering should do so in a manner which does not create potential
+liability for other Contributors. Therefore, if a Contributor includes
+the Program in a commercial product offering, such Contributor
+("Commercial Contributor") hereby agrees to defend and indemnify every
+other Contributor ("Indemnified Contributor") against any losses,
+damages and costs (collectively "Losses") arising from claims, lawsuits
+and other legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such
+Commercial Contributor in connection with its distribution of the Program
+in a commercial product offering. The obligations in this section do not
+apply to any claims or Losses relating to any actual or alleged
+intellectual property infringement. In order to qualify, an Indemnified
+Contributor must: a) promptly notify the Commercial Contributor in
+writing of such claim, and b) allow the Commercial Contributor to control,
+and cooperate with the Commercial Contributor in, the defense and any
+related settlement negotiations. The Indemnified Contributor may
+participate in any such claim at its own expense.
+
+For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor's responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those performance
+claims and warranties, and if a court requires any other Contributor to
+pay any damages as a result, the Commercial Contributor must pay
+those damages.
+
+5. NO WARRANTY
+
+EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT
+PERMITTED BY APPLICABLE LAW, THE PROGRAM IS PROVIDED ON AN "AS IS"
+BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR
+IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF
+TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+PURPOSE. Each Recipient is solely responsible for determining the
+appropriateness of using and distributing the Program and assumes all
+risks associated with its exercise of rights under this Agreement,
+including but not limited to the risks and costs of program errors,
+compliance with applicable laws, damage to or loss of data, programs
+or equipment, and unavailability or interruption of operations.
+
+6. DISCLAIMER OF LIABILITY
+
+EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT
+PERMITTED BY APPLICABLE LAW, NEITHER RECIPIENT NOR ANY CONTRIBUTORS
+SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST
+PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE
+EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+7. GENERAL
+
+If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further
+action by the parties hereto, such provision shall be reformed to the
+minimum extent necessary to make such provision valid and enforceable.
+
+If Recipient institutes patent litigation against any entity
+(including a cross-claim or counterclaim in a lawsuit) alleging that the
+Program itself (excluding combinations of the Program with other software
+or hardware) infringes such Recipient's patent(s), then such Recipient's
+rights granted under Section 2(b) shall terminate as of the date such
+litigation is filed.
+
+All Recipient's rights under this Agreement shall terminate if it
+fails to comply with any of the material terms or conditions of this
+Agreement and does not cure such failure in a reasonable period of
+time after becoming aware of such noncompliance. If all Recipient's
+rights under this Agreement terminate, Recipient agrees to cease use
+and distribution of the Program as soon as reasonably practicable.
+However, Recipient's obligations under this Agreement and any licenses
+granted by Recipient relating to the Program shall continue and survive.
+
+Everyone is permitted to copy and distribute copies of this Agreement,
+but in order to avoid inconsistency the Agreement is copyrighted and
+may only be modified in the following manner. The Agreement Steward
+reserves the right to publish new versions (including revisions) of
+this Agreement from time to time. No one other than the Agreement
+Steward has the right to modify this Agreement. The Eclipse Foundation
+is the initial Agreement Steward. The Eclipse Foundation may assign the
+responsibility to serve as the Agreement Steward to a suitable separate
+entity. Each new version of the Agreement will be given a distinguishing
+version number. The Program (including Contributions) may always be
+Distributed subject to the version of the Agreement under which it was
+received. In addition, after a new version of the Agreement is published,
+Contributor may elect to Distribute the Program (including its
+Contributions) under the new version.
+
+Except as expressly stated in Sections 2(a) and 2(b) above, Recipient
+receives no rights or licenses to the intellectual property of any
+Contributor under this Agreement, whether expressly, by implication,
+estoppel or otherwise. All rights in the Program not expressly granted
+under this Agreement are reserved. Nothing in this Agreement is intended
+to be enforceable by any entity that is not a Contributor or Recipient.
+No third-party beneficiary rights are created under this Agreement.
+
+Exhibit A - Form of Secondary Licenses Notice
+
+"This Source Code may also be made available under the following
+Secondary Licenses when the conditions for such availability set forth
+in the Eclipse Public License, v. 2.0 are satisfied: {name license(s),
+version(s), and exceptions or additional permissions here}."
+
+  Simply including a copy of this Agreement, including this Exhibit A
+  is not sufficient to license the Source Code under Secondary Licenses.
+
+  If it is not possible or desirable to put the notice in a particular
+  file, then You may include the notice in a location (such as a LICENSE
+  file in a relevant directory) where a recipient would be likely to
+  look for such a notice.
+
+  You may add additional accurate notices of copyright ownership.

package/README.md

@@ -0,0 +1,189 @@
+<p align="center">
+  <a href="https://www.eclipse.org/scout/" target="_blank" rel="noopener noreferrer"><img src="https://eclipsescout.github.io/assets/img/eclipse-scout-logo.svg"></a>
+</p>
+
+<p align="center">
+  <a href="https://ci.eclipse.org/scout/view/Scout%20Nightly%20Jobs/job/scout-integration-22.0-RT-nightly_pipeline/" target="_blank" rel="noopener noreferrer"><img alt="Jenkins" src="https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fci.eclipse.org%2Fscout%2Fview%2FScout%2520Nightly%2520Jobs%2Fjob%2Fscout-integration-22.0-RT-nightly_pipeline%2F"></a>
+  <a href="https://ci.eclipse.org/scout/view/Scout%20Nightly%20Jobs/job/scout-integration-22.0-RT-nightly_pipeline/" target="_blank" rel="noopener noreferrer"><img alt="Jenkins tests" src="https://img.shields.io/jenkins/tests?compact_message&jobUrl=https%3A%2F%2Fci.eclipse.org%2Fscout%2Fview%2FScout%2520Nightly%2520Jobs%2Fjob%2Fscout-integration-22.0-RT-nightly_pipeline%2F"></a>
+  <a href="https://www.npmjs.com/package/@eclipse-scout/migrate" target="_blank" rel="noopener noreferrer"><img alt="npm" src="https://img.shields.io/npm/dm/@eclipse-scout/migrate"></a>
+  <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank" rel="noopener noreferrer"><img alt="NPM" src="https://img.shields.io/npm/l/@eclipse-scout/migrate"></a>
+  <a href="https://www.npmjs.com/package/@eclipse-scout/migrate" target="_blank" rel="noopener noreferrer"><img alt="npm (scoped)" src="https://img.shields.io/npm/v/@eclipse-scout/migrate"></a>
+  <a href="https://www.npmjs.com/package/@eclipse-scout/migrate" target="_blank" rel="noopener noreferrer"><img alt="node" src="https://img.shields.io/node/v/@eclipse-scout/migrate"></a>
+  <a href="https://www.eclipse.org/scout/" target="_blank" rel="noopener noreferrer"><img alt="Website" src="https://img.shields.io/website?url=https%3A%2F%2Fwww.eclipse.org%2Fscout%2F"></a>
+</p>
+
+# Eclipse Scout - Migrate
+
+Migration tool to help migrating the JavaScript/TypeScript code from one Scout release to another.
+
+## Usage
+
+To set up the tool, do the following:
+
+- Open the `package.json` of your ui module (e.g. `your.project.ui.html`).
+- Add a devDependency to `@eclipse-scout/migrate`.
+- Run `pnpm install` to install the new dependency.
+- Do the required migration as described in the following chapters.
+- When you are finished, remove the added dependency and migration script from you `package.json`.
+
+```json
+{
+  "devDependencies": {
+    "@eclipse-scout/migrate": "~23.1.0"
+  }
+}
+```
+
+### TSConfig
+
+Some migrations require a `tsconfig.json`. You can add it as follows (do it only if stated in the migration description):
+
+- Add a devDependency to `@eclipse-scout/tsconfig`.
+- Run `pnpm install` to install the new dependency.
+- Create a `tsconfig.json` beside your `package.json` according to the `Readme.md` of the `@eclipse-scout/tsconfig` module.
+
+```json
+{
+  "devDependencies": {
+    "@eclipse-scout/tsconfig": "~23.1.0"
+  }
+}
+```
+
+### Module Map
+
+The module map is used by certain migration tasks to automatically add imports.
+If a migration task requires a module map, do the following:
+
+- Adjust the `moduleMap` argument by replacing `yourNamespace` with the namespace in your `index.js` file.
+  The moduleMap entry is used to add imports to your `index.js` automatically. If you omit it, you need to add the imports manually.
+- If you have dependencies to other Scout based modules, you add them to the `moduleMap` to have the imports to these modules created automatically.
+  Add the namespace of the other module and the name of the npm package as follows: `--moduleMap.otherNamespace @other/npm-module`
+
+## ObjectType and MenuType Migration
+
+In order to migrate string literals to class references and menu type constants, do the following:
+
+- Add a script in your `package.json` as described below.
+- Adjust the module map as described in the chapter [Module Map](#module-map)
+- Run the `migrate` script by pressing the play button next to it in IntelliJ or using the command line: `npm run migrate`
+- Review the changes and add the missing imports, if there are any.
+
+```json
+{
+  "scripts": {
+    "migrate": "scout-migrate --migrate objectType menuTypes --sources src/main/js/**/*.js --moduleMap.yourNamespace path:src/main/js/index.js"
+  }
+}
+```
+
+## Widget and Column Map Migration
+
+In order to create widget and column maps, do the following:
+
+- Create a `tsconfig.json` as described [here](#tsconfig)
+- Add a rename and a migrate script in your `package.json` as described below.
+- Run the `rename` script by pressing the play button next to it in IntelliJ or using the command line: `npm run rename`.
+  Commit the changes to ensure Git can track the renames correctly.
+- Run the `migrate` script.
+- Review and commit the changes.
+
+```json
+{
+  "scripts": {
+    "rename": "scout-migrate --rename --sources src/main/js/**/*Model.js",
+    "migrate": "scout-migrate --migrate widgetColumnMap --sources src/main/js/**/*Model.ts"
+  }
+}
+```
+
+## Migrate to TypeScript
+
+If you plan to migrate your Scout JS code base to TypeScript, use the migration tool for the initial migration.
+From there, you need to add the missing types, fix errors and clean up your code.
+
+**Important**: if you have dependencies to other Scout based modules, make sure these modules are migrated to TypeScript first.
+We don't recommend migrating to TypeScript unless all dependencies are migrated.
+
+The automatic migration includes:
+
+- Renaming the files to `*.ts`.
+- Declaring class properties
+- Declaring method parameters and return types based on JsDoc and naming conventions
+- Removing types from JsDoc
+- Adding imports for the types based on module maps
+- Adding method accessors
+
+In order to run the TypeScript migration, do the following:
+
+- Ensure you have a clean Git working tree (no uncommitted files).
+- Create a `tsconfig.json` as described [here](#tsconfig)
+- Add scripts in your `package.json` as described below.
+- Adjust the module map as described in the chapter [Module Map](#module-map)
+- Add custom type maps if you have a large code base and would like to automate a little more, see [Type Map](#type-map)
+- Run the `rename` script by pressing the play button next to it in IntelliJ or using the command line: `npm run rename`.
+  Commit the changes to ensure Git can track the renames correctly.
+- Run the `migrate` script.
+- Review every file:
+  - Verify / add the types of the class properties.
+  - Verify / add the types of the method parameters and return values.
+- If you have custom widgets, you should create a `Model` and an `EventMap` for each widget.
+  Please use existing widgets as template, e.g. `Menu.ts`, `MenuModel.ts`, `MenuEventMap.ts`.
+  - The model needs to be extracted manually.
+    Copy the relevant class properties to a separate model file.
+    In your widget, implement the model interface and declare a model variable.
+  - To create the event maps, you can run the `event-maps` script from below and copy the result into a separate event maps file.
+
+```json
+{
+  "scripts": {
+    "rename": "scout-migrate --rename --sources src/main/js/**/*.js",
+    "migrate": "scout-migrate --rename false --migrate ts --sources src/main/js/**/*.ts --moduleMap.yourNamespace path:src/main/js/index.ts",
+    "event-maps": "scout-migrate --print-event-maps --sources src/main/js/**/*.ts"
+  }
+}
+```
+
+### Type Map
+
+Type maps are used to add types automatically based on naming rules.
+Scout provides many rules out of the box that should detect many types.
+If you have a large code base with custom types, you can add custom type maps.
+
+To do so, create a config file ending with `.mjs`, e.g. `migrate-config.mjs` and configure your type maps like in the following example:
+
+```js
+// The key has no special meaning
+// The `name` is the name of the member variable or method parameter.
+// If the predicate returns true, the type is used.
+// The namespace in the type is used to create the import. To make it work, the module map has to contain an entry for that namespace.
+// Example: doSomething(opts) -> doSomething(opts: Options)
+const typeMap = {
+  Options: {
+    predicate: name => name === 'opts',
+    type: 'yourNamespace.Options'
+  }
+};
+
+// Compared to the typeMap above, the returnTypeMap is only used to determine the return types of functions.
+// The 'name' parameter is the method name
+// Example: createOptions() -> createOptions(): Options
+const returnTypeMap = {
+  Options: {
+    predicate: name => name === 'createOptions',
+    type: 'yourNamespace.Options'
+  }
+};
+
+// Necessary if the imports should be created automatically.
+const moduleMap = {
+  yourNamespace: '@your-module/core'
+};
+
+export {typeMap, returnTypeMap, moduleMap};
+```
+
+You can add as many mappings as you like, or none at all, they are completely optional.
+
+**Note**: you can either define the module map in the config file or pass it ass arguments to the script.
+If you do both, they will be merged. If they contain the same keys, the value passed via argument wins.

package/bin/scout-migrate.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+
+import {createRequire} from 'module';
+import path from 'path';
+import fs from 'fs';
+import typescript from 'typescript';
+import {eslintFixPlugin, jsDocPlugin} from 'ts-migrate-plugins';
+import {migrate, MigrateConfig} from 'ts-migrate-server';
+import renameModule from 'ts-migrate/build/commands/rename.js';
+import parser from 'yargs-parser';
+import convertToCRLFPlugin from '../src/convertToCRLFPlugin.js';
+import memberAccessModifierPlugin from '../src/memberAccessModifierPlugin.js';
+import convertToLFPlugin from '../src/convertToLFPlugin.js';
+import declareMissingClassPropertiesPlugin from '../src/declareMissingClassPropertiesPlugin.js';
+import methodsPlugin from '../src/methodsPlugin.js';
+import countMethodsPlugin from '../src/countMethodsPlugin.js';
+import printEventMapsPlugin from '../src/printEventMapsPlugin.js';
+import typedObjectTypePlugin from '../src/typedObjectTypePlugin.js';
+import widgetColumnMapPlugin from '../src/widgetColumnMapPlugin.js';
+import menuTypesPlugin from '../src/menuTypesPlugin.js';
+
+const rename = renameModule.default; // Default imports don't work as expected when importing from cjs modules
+
+const yargsOptions = {
+  boolean: ['count', 'rename', 'printEventMaps'],
+  array: ['sources', 'migrate'],
+  string: ['moduleMap', 'jsDocTypeMap', 'paramTypeMap', 'returnTypeMap', 'menuTypesMap', 'config'],
+  default: {'migrate': [], 'rename': null, 'jsDocTypeMap': {}, 'count': false, 'printEventMaps': false},
+  choices: ['migrate', ['ts', 'objectType', 'widgetColumnMap', 'menuTypes']]
+};
+const args = parser(process.argv, yargsOptions);
+
+let sources = args.sources;
+if (sources) {
+  console.log('Processing sources: ' + sources);
+} else if (!tsConfigContainsSources()) {
+  console.warn('Please set sources argument or provide a tsconfig.json specifying the sources.');
+  process.exit();
+}
+
+const rootDir = path.resolve(process.cwd());
+let renameToTs = args.rename;
+if (args.rename === null) {
+  // Rename if migrate to ts is enabled and renaming not explicitly disabled
+  renameToTs = args.migrate.includes('ts');
+}
+if (renameToTs) {
+  rename({rootDir, sources});
+}
+if (!args.migrate.length && !args.count && !args.printEventMaps) {
+  process.exit();
+}
+
+let config = await readConfig();
+let moduleMap = Object.assign({}, config.moduleMap, args.moduleMap);
+if (moduleMap) {
+  for (let [key, value] of Object.entries(moduleMap)) {
+    if (Array.isArray(value)) {
+      moduleMap[key] = value[value.length - 1]; // If same namespace was passed multiple times, use the last provided
+    }
+  }
+  console.log('Using moduleMap: ' + JSON.stringify(moduleMap));
+}
+
+let menuTypesMap = Object.assign({}, config.menuTypesMap, args.menuTypesMap);
+if (menuTypesMap) {
+  console.log('Using menuTypesMap: ' + JSON.stringify(menuTypesMap));
+}
+
+let tsConfigDir;
+if (!fs.existsSync('./tsconfig.json')) {
+  // https://errorsandanswers.com/do-require-resolve-for-es-modules/
+  const require = createRequire(import.meta.url);
+  tsConfigDir = require.resolve('@eclipse-scout/tsconfig').replace('tsconfig.json', '');
+}
+
+const migrateConfig = new MigrateConfig();
+if (args.migrate.length > 0) {
+  console.log('Preparing migrations ' + args.migrate);
+  migrateConfig.addPlugin(convertToCRLFPlugin, {});
+  if (args.migrate.includes('objectType')) {
+    migrateConfig.addPlugin(typedObjectTypePlugin, {moduleMap});
+  }
+  if (args.migrate.includes('menuTypes')) {
+    migrateConfig.addPlugin(menuTypesPlugin, {menuTypesMap, moduleMap});
+  }
+  if (args.migrate.includes('widgetColumnMap')) {
+    migrateConfig.addPlugin(widgetColumnMapPlugin, {});
+  }
+  if (args.migrate.includes('ts')) {
+    await configTypeScript();
+  }
+  migrateConfig.addPlugin(convertToLFPlugin, {});
+  migrateConfig.addPlugin(eslintFixPlugin, {});
+}
+if (args.count) {
+  migrateConfig.addPlugin(countMethodsPlugin, {});
+}
+if (args.printEventMaps) {
+  migrateConfig.addPlugin(printEventMapsPlugin, {});
+}
+if (migrateConfig.plugins.length === 0) {
+  console.warn('No tasks executed, please consult README.md');
+} else {
+  migrate({rootDir, tsConfigDir, config: migrateConfig, sources}).then(exitCode => process.exit(exitCode));
+}
+
+function configTypeScript() {
+  // Only consider .ts files for migration, no .less or .js files
+  if (sources) {
+    sources = sources.map(source => {
+      source = source.replace(/(.js)$/, '.ts');
+      if (!source.endsWith('.ts')) {
+        source += '.ts';
+      }
+      return source;
+    });
+  }
+
+  const jsDocTypeMap = Object.assign({
+    function: {
+      tsName: 'Function',
+      acceptsTypeParameters: false
+    },
+    $: {
+      tsName: 'JQuery',
+      acceptsTypeParameters: false
+    }
+  }, config.jsDocTypeMap);
+  let typeMap = config.typeMap;
+  let paramTypeMap = config.paramTypeMap || typeMap;
+  let returnTypeMap = config.returnTypeMap;
+  migrateConfig
+    .addPlugin(jsDocPlugin, {typeMap: jsDocTypeMap, annotateReturns: true})
+    .addPlugin(declareMissingClassPropertiesPlugin, {moduleMap, typeMap})
+    .addPlugin(memberAccessModifierPlugin, {})
+    .addPlugin(methodsPlugin, {moduleMap, paramTypeMap, returnTypeMap});
+}
+
+function parseTsConfig(path) {
+  const content = typescript.sys.readFile(path);
+  const {config, error} = typescript.parseConfigFileTextToJson(path, content);
+  if (error) {
+    const errorMessage = typescript.flattenDiagnosticMessageText(error.messageText, typescript.default.sys.newLine);
+    throw new Error(`Parsing TypeScript config failed: ${path}\n${errorMessage}`);
+  }
+  return config;
+}
+
+function tsConfigContainsSources() {
+  if (!fs.existsSync('./tsconfig.json')) {
+    return false;
+  }
+  let config = parseTsConfig('./tsconfig.json');
+  return config.include || config.files;
+}
+
+async function readConfig() {
+  let config;
+  if (args.config) {
+    config = 'file://' + path.resolve(args.config);
+    console.log('Using config from file ' + config);
+    return import(config);
+  }
+  return {};
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@eclipse-scout/migrate",
+  "version": "23.1.1",
+  "description": "TypeScript migration module",
+  "author": "BSI Business Systems Integration AG",
+  "homepage": "https://www.eclipse.org/scout",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eclipse-scout/scout.rt.git"
+  },
+  "license": "EPL-2.0",
+  "engines": {
+    "node": ">=18.12.1",
+    "npm": ">=9.1.1",
+    "pnpm": ">=7.16.0"
+  },
+  "keywords": [
+    "scout",
+    "eclipse-scout",
+    "migrate",
+    "typescript"
+  ],
+  "files": [
+    "bin",
+    "src"
+  ],
+  "type": "module",
+  "bin": {
+    "scout-migrate": "bin/scout-migrate.js"
+  },
+  "dependencies": {
+    "ts-migrate": "0.1.35",
+    "ts-migrate-plugins": "0.1.35",
+    "ts-migrate-server": "0.1.33",
+    "yargs-parser": "21.1.1",
+    "jscodeshift": "0.14.0",
+    "typescript": "4.9.3"
+  },
+  "devDependencies": {
+    "@types/jscodeshift": "^0.11.5",
+    "@types/yargs": "^17.0.13",
+    "jest": "29.3.1",
+    "@babel/preset-env": "7.20.2",
+    "@babel/core": "7.20.5",
+    "@eclipse-scout/tsconfig": "23.1.1"
+  },
+  "scripts": {
+    "scout-migrate": "node bin/scout-migrate",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config jest-config.json"
+  }
+}