Allowed codemod to set linters for the v2 addon (#82)

* feature: Allowed codemod to set development dependencies for addon

* feature: Allowed codemod to configure linters for addon

* refactor: Removed unused step

* chore: Updated move-project-root-files step

* chore: Updated fixtures

* chore: Updated README

---------

Co-authored-by: ijlee2 <[email protected]>

Author: ijlee2

README.md

@@ -15,33 +15,43 @@ _Codemod to convert Ember addons to v2 addon format_
 
 ## Usage
 
-You can check [`ember-container-query`](https://github.com/ijlee2/ember-container-query/pull/151) as a reference.
+For examples, see [`ember-container-query`](https://github.com/ijlee2/ember-container-query/pull/151/commits) and [`ember-render-helpers`](https://github.com/buschtoens/ember-render-helpers/pull/447/commits).
 
-Step 1. Quickly migrate to [v2 format](https://github.com/embroider-build/embroider/blob/main/ADDON-AUTHOR-GUIDE.md).<sup>1</sup>
+Step 1. Quickly migrate to [v2 format](https://github.com/embroider-build/embroider/blob/v4.3.1-%40embroider/addon-dev/docs/addon-author-guide.md).
 
 ```sh
 cd <path/to/your/project>
 npx ember-codemod-v1-to-v2 <arguments>
 ```
 
+> [!IMPORTANT]
+>
+> Before you run `ember-codemod-v1-to-v2`, I recommend that you address existing tech debts (one at a time). That is, treat the v2 migration as its own thing.
+>
+> Here are examples of what you may want to work on first:
+>
+> - [Meet prerequisites for v2 addon](https://github.com/embroider-build/embroider/blob/v4.3.1-%40embroider/addon-dev/docs/porting-addons-to-v2.md#part-3-prerequisites-for-v2-addon).
+> - [Un-pod v1 addon](https://github.com/ijlee2/ember-codemod-pod-to-octane).
+> - Update dependencies.
+> - Switch `npm` or `yarn` to `pnpm`.
+
 Step 2. Review the addon package.
 
-- [x] Update the configuration files.<sup>2</sup>
+- [x] Update the configuration files.<sup>1</sup>
+- [x] Install missing dependencies.
 - [x] Relative import paths must specify the file extension `.js` or `.ts`.
 - [x] Colocate stylesheets (if any). Let each component import the relevant stylesheet in the backing class.
 - [x] Confirm that you can run all scripts in `package.json`.
 
 Step 3. Review the test-app package.
 
-- [x] Update the configuration files.<sup>2</sup>
+- [x] Update the configuration files.<sup>1</sup>
 - [x] Rename the remaining instances of `dummy` to `test-app`.
 - [x] Confirm that you can run all scripts in `package.json`.
 
 Step 4. Review the workspace root including CI/CD.
 
-<sup>1. Before running `ember-codemod-v1-to-v2`, consider [meeting the prerequisites](https://github.com/embroider-build/embroider/blob/v1.8.3/PORTING-ADDONS-TO-V2.md#part-3-prerequisites-for-v2-addon). You can run [`ember-codemod-pod-to-octane`](https://github.com/ijlee2/ember-codemod-pod-to-octane) to un-pod a v1 addon.</sup>
-
-<sup>2. Files such as `.eslintrc.js`, `.gitignore`, `babel.config.json` (addon only), `config/environment.js` (test-app only), `ember-cli-build.js` (test-app only), `package.json`, `rollup.config.mjs` (addon only), `tsconfig.json`, etc.</sup>
+<sup>1. Files such as `.eslintrc.js`, `.gitignore`, `babel.config.json` (addon only), `config/environment.js` (test-app only), `ember-cli-build.js` (test-app only), `package.json`, `rollup.config.mjs` (addon only), `tsconfig.json`, etc.</sup>
 
 
 ### Arguments
@@ -133,7 +143,7 @@ If you have an open-sourced addon (v1 or v2) that I can use as a reference, reac
 
 ## Credits
 
-The codemod steps were based on [Migrating an Ember addon to the next-gen v2 format](https://www.kaliber5.de/de/blog/v2-addon_en) and [Guide: Porting an Addon to v2](https://github.com/embroider-build/embroider/blob/v3.1.3-core/docs/porting-addons-to-v2.md). The blueprints were derived from [`@embroider/addon-blueprint`](https://github.com/embroider-build/addon-blueprint).
+The codemod steps were based on [Migrating an Ember addon to the next-gen v2 format](https://www.kaliber5.de/de/blog/v2-addon_en) and [Guide: Porting an Addon to v2](https://github.com/embroider-build/embroider/blob/v4.3.1-%40embroider/addon-dev/docs/porting-addons-to-v2.md). The blueprints were derived from [`@embroider/addon-blueprint`](https://github.com/embroider-build/addon-blueprint).
 
 
 ## License

src/blueprints/ember-addon/__addonLocation__/.eslintignore

@@ -2,8 +2,8 @@
 /blueprints/*/files/
 
 # compiled output
-/declarations/
 /dist/
+/declarations/
 
 # misc
 /coverage/

src/blueprints/ember-addon/__addonLocation__/.eslintrc.cjs

@@ -0,0 +1,68 @@
+'use strict';
+
+module.exports = {
+  root: true,
+  parser: '<%= options.packages.addon.hasTypeScript ? '@typescript-eslint/parser' : '@babel/eslint-parser' %>',
+  parserOptions: {
+    ecmaVersion: 'latest',<% if (!options.packages.addon.hasTypeScript) { %>
+    sourceType: 'module',
+    babelOptions: {
+      root: __dirname,
+    },<% } %>
+  },
+  plugins: ['ember'],
+  extends: [
+    'eslint:recommended',
+    'plugin:ember/recommended',
+    'plugin:prettier/recommended',
+  ],
+  env: {
+    browser: true,
+  },
+  rules: {},
+  overrides: [
+<% if (options.packages.addon.hasTypeScript) { %>    // ts files
+    {
+      files: ['**/*.ts', '**/*.gts'],
+      extends: [
+        'plugin:@typescript-eslint/eslint-recommended',
+        'plugin:@typescript-eslint/recommended',
+      ],
+      rules: {
+        // Add any custom rules here
+      },
+    },
+    // require relative imports use full extensions
+    {
+      files: ['src/**/*.{js,ts,gjs,gts}'],
+      rules: {
+        'import/extensions': ['error', 'always', { ignorePackages: true }],
+      },
+    },
+<% } else { %>    // require relative imports use full extensions
+    {
+      files: ['src/**/*.{js,gjs}'],
+      rules: {
+        'import/extensions': ['error', 'always', { ignorePackages: true }],
+      },
+    },
+<% } %>    // node files
+    {
+      files: [
+        './.eslintrc.cjs',
+        './.prettierrc.cjs',
+        './.template-lintrc.cjs',
+        './addon-main.cjs',
+      ],
+      parserOptions: {
+        sourceType: 'script',
+      },
+      env: {
+        browser: false,
+        node: true,
+      },
+      plugins: ['n'],
+      extends: ['plugin:n/recommended'],
+    },
+  ],
+};

src/blueprints/ember-addon/__addonLocation__/.prettierignore

@@ -2,8 +2,8 @@
 /blueprints/*/files/
 
 # compiled output
-/declarations/
 /dist/
+/declarations/
 
 # misc
 /coverage/

tests/fixtures/new-v1-addon-customizations/output/packages/new-v1-addon/.prettierrc.js renamed to src/blueprints/ember-addon/__addonLocation__/.prettierrc.cjs

@@ -1,12 +1,17 @@
 # The authoritative copies of these live in the monorepo root (because they're
 # more useful on github that way), but the build copies them into here so they
 # will also appear in published NPM packages.
-/LICENSE.md
 /README.md
+/LICENSE.md
 
 # compiled output
-/declarations
-/dist
+dist/
+declarations/
 
 # npm/pnpm/yarn pack output
 *.tgz
+
+# deps & caches
+node_modules/
+.eslintcache
+.prettiercache

tests/fixtures/new-v1-addon-customizations/output/packages/new-v1-addon/.template-lintrc.js renamed to src/blueprints/ember-addon/__addonLocation__/.template-lintrc.cjs

@@ -0,0 +1,21 @@
+{
+  "extends": "@tsconfig/ember/tsconfig.json",
+  "compilerOptions": {
+    "allowImportingTsExtensions": true,
+    "allowJs": true,
+    "declarationDir": "declarations",
+    "emitDeclarationOnly": true,
+    "noEmit": false,
+    "noEmitOnError": false,
+    "rootDir": "./src"
+  },
+  "include": [
+    "src/**/*",
+    "unpublished-development-types/**/*"
+  ]<% if (options.packages.addon.hasGlint) { %>,
+  "glint": {
+    "environment": [
+      "ember-loose"
+    ]
+  }<% } %>
+}

src/blueprints/ember-addon/__addonLocation__/__gitignore__

@@ -2,7 +2,6 @@
 // These will *not* be published as part of your addon, so be careful that your published code does not rely on them!
 <% if (options.packages.addon.hasGlint) { %>
 import '@glint/environment-ember-loose';
-// import '@glint/environment-ember-template-imports';
 
 declare module '@glint/environment-ember-loose/registry' {
   // Remove this once entries have been added! 👇

src/blueprints/ember-addon/__addonLocation__/tsconfig.json

@@ -6,7 +6,6 @@ import {
   moveProjectRootFiles,
   moveTestAppFiles,
   updateAddonPackageJson,
-  updateAddonTsConfigJson,
   updateTestAppPackageJson,
   updateTestAppTsConfigJson,
 } from './steps/index.js';
@@ -34,7 +33,6 @@ export function runCodemod(codemodOptions: CodemodOptions): void {
 
   // Fine-tune individual files
   updateAddonPackageJson(context, options);
-  updateAddonTsConfigJson(options);
   updateTestAppPackageJson(options);
   updateTestAppTsConfigJson(options);
 }