Merge pull request #621 from spotify/rugvip/plugin-serve

Make plugin:serve work and add for home-page plugin + fix declaration maps

packages/app/.eslintrc.js

@@ -1,4 +1,5 @@
 module.exports = {
+  extends: [require.resolve('@backstage/cli/config/eslint')],
   overrides: [
     {
       files: ['**/*.ts?(x)'],

packages/cli/.eslintrc.js

@@ -1,4 +1,5 @@
 module.exports = {
+  extends: [require.resolve('@backstage/cli/config/eslint')],
   ignorePatterns: ['templates/**'],
   rules: {
     'no-console': 0,

packages/cli/config/eslint.js

@@ -65,7 +65,7 @@ module.exports = {
       },
     },
     {
-      files: ['**/*.test.*', '**/src/setupTests.*'],
+      files: ['*.test.*', 'src/setupTests.*', 'dev/**'],
       rules: {
         // Tests are allowed to import dev dependencies
         'import/no-extraneous-dependencies': [

packages/cli/src/commands/plugin/rollup.config.ts

@@ -46,6 +46,17 @@ export default {
     json(),
     typescript({
       include: `${paths.resolveTarget('src')}/**/*.{js,jsx,ts,tsx}`,
+      tsconfigOverride: {
+        // The dev folder is for the local plugin serve, ignore it in the build
+        // If we don't do this we get a folder structure similar to dist/{src,dev}/...
+        exclude: ['dev'],
+        compilerOptions: {
+          // Use absolute path to src dir as root for declarations, relying on the default
+          // seems to produce declaration maps that are relative to dist/ instead of src/
+          // Using a relative path like ../src doesn't work either becaus it will be used as is in subdirs.
+          sourceRoot: paths.resolveTarget('src'),
+        },
+      },
       clean: true,
     }),
   ],

packages/cli/src/commands/plugin/serve/config.ts

@@ -31,18 +31,19 @@ export function createConfig(paths: Paths): webpack.Configuration {
     profile: false,
     bail: false,
     devtool: 'cheap-module-eval-source-map',
-    context: paths.appPath,
+    context: paths.targetPath,
     entry: [
       `${require.resolve('webpack-dev-server/client')}?/`,
       require.resolve('webpack/hot/dev-server'),
-      paths.appDevEntry,
+      paths.targetDevEntry,
     ],
     resolve: {
-      extensions: ['.ts', '.tsx', '.js', '.jsx'],
+      extensions: ['.ts', '.tsx', '.mjs', '.js', '.jsx'],
+      modules: ['node_modules', paths.targetSrc],
       plugins: [
         new ModuleScopePlugin(
-          [paths.appSrc, paths.appDev],
-          [paths.appPackageJson],
+          [paths.targetSrc, paths.targetDev],
+          [paths.targetPackageJson],
         ),
       ],
     },
@@ -51,7 +52,7 @@ export function createConfig(paths: Paths): webpack.Configuration {
         {
           test: /\.(tsx?|jsx?|mjs)$/,
           enforce: 'pre',
-          include: [paths.appSrc, paths.appDev],
+          include: [paths.targetSrc, paths.targetDev],
           use: {
             loader: 'eslint-loader',
             options: {
@@ -61,7 +62,7 @@ export function createConfig(paths: Paths): webpack.Configuration {
         },
         {
           test: /\.(tsx?|jsx?|mjs)$/,
-          include: [paths.appSrc, paths.appDev],
+          include: [paths.targetSrc, paths.targetDev],
           exclude: /node_modules/,
           loader: 'ts-loader',
           options: {
@@ -72,7 +73,7 @@ export function createConfig(paths: Paths): webpack.Configuration {
         {
           test: [/\.bmp$/, /\.gif$/, /\.jpe?g$/, /\.png$/, /\.frag/, /\.xml/],
           loader: 'url-loader',
-          include: paths.appAssets,
+          include: paths.targetAssets,
           options: {
             limit: 10000,
             name: 'static/media/[name].[hash:8].[ext]',
@@ -98,15 +99,15 @@ export function createConfig(paths: Paths): webpack.Configuration {
     },
     plugins: [
       new HtmlWebpackPlugin({
-        template: paths.appHtml,
+        template: paths.targetHtml,
       }),
       new ForkTsCheckerWebpackPlugin({
-        tsconfig: paths.appTsConfig,
+        tsconfig: paths.targetTsConfig,
         eslint: true,
         eslintOptions: {
           parserOptions: {
-            project: paths.appTsConfig,
-            tsconfigRootDir: paths.appPath,
+            project: paths.targetTsConfig,
+            tsconfigRootDir: paths.targetPath,
           },
         },
         reportFiles: ['**', '!**/__tests__/**', '!**/?(*.)(spec|test).*'],

packages/cli/src/commands/plugin/serve/index.ts

@@ -15,7 +15,13 @@
  */
 
 import { startDevServer } from './server';
+import { watchDeps } from 'lib/watchDeps';
 
 export default async () => {
+  await watchDeps({ build: true });
+
   await startDevServer();
+
+  // Wait for interrupt signal
+  await new Promise(() => {});
 };

packages/cli/src/commands/plugin/serve/paths.ts

@@ -14,39 +14,35 @@
  * limitations under the License.
  */
 
-import { resolve as resolvePath } from 'path';
-import { existsSync, realpathSync } from 'fs';
+import { existsSync } from 'fs';
+import { paths } from 'lib/paths';
 
 export function getPaths() {
-  const appDir = realpathSync(process.cwd());
-
-  const resolveApp = (path: string) => resolvePath(appDir, path);
-  const resolveOwn = (path: string) => resolvePath(__dirname, '..', path);
-  const resolveAppModule = (path: string) => {
+  const resolveTargetModule = (path: string) => {
     for (const ext of ['mjs', 'js', 'ts', 'tsx', 'jsx']) {
-      const filePath = resolveApp(`${path}.${ext}`);
+      const filePath = paths.resolveTarget(`${path}.${ext}`);
       if (existsSync(filePath)) {
         return filePath;
       }
     }
-    return resolveApp(`${path}.js`);
+    return paths.resolveTarget(`${path}.js`);
   };
 
-  let appHtml = resolveApp('dev/index.html');
-  if (!existsSync(appHtml)) {
-    appHtml = resolveOwn('../../templates/serve_index.html');
+  let targetHtml = paths.resolveTarget('dev/index.html');
+  if (!existsSync(targetHtml)) {
+    targetHtml = paths.resolveOwn('templates/serve_index.html');
   }
 
   return {
-    appHtml,
-    appPath: resolveApp('.'),
-    appAssets: resolveApp('assets'),
-    appSrc: resolveApp('src'),
-    appDev: resolveApp('dev'),
-    appDevEntry: resolveAppModule('dev/index'),
-    appTsConfig: resolveApp('tsconfig.json'),
-    appNodeModules: resolveApp('node_modules'),
-    appPackageJson: resolveApp('package.json'),
+    targetHtml,
+    targetPath: paths.resolveTarget('.'),
+    targetAssets: paths.resolveTarget('assets'),
+    targetSrc: paths.resolveTarget('src'),
+    targetDev: paths.resolveTarget('dev'),
+    targetDevEntry: resolveTargetModule('dev/index'),
+    targetTsConfig: paths.resolveTarget('tsconfig.json'),
+    targetNodeModules: paths.resolveTarget('node_modules'),
+    targetPackageJson: paths.resolveTarget('package.json'),
   };
 }
 

packages/cli/src/commands/plugin/serve/server.ts

@@ -39,6 +39,7 @@ export async function startDevServer() {
   const server = new WebpackDevServer(compiler, {
     hot: true,
     publicPath: '/',
+    historyApiFallback: true,
     quiet: true,
     https: protocol === 'https',
     host,

packages/cli/templates/default-app/.eslintrc.js

@@ -1,3 +1,3 @@
 module.exports = {
-  extends: [require.resolve('@backstage/cli/config/eslint.js')],
+  extends: [require.resolve('@backstage/cli/config/eslint')],
 };

packages/cli/templates/default-app/packages/app/.eslintrc.js

@@ -0,0 +1,3 @@
+module.exports = {
+  extends: [require.resolve('@backstage/cli/config/eslint')],
+};

packages/cli/templates/default-app/plugins/welcome/.eslintrc.js

@@ -0,0 +1,3 @@
+module.exports = {
+  extends: [require.resolve('@backstage/cli/config/eslint')],
+};

packages/cli/templates/default-plugin/.eslintrc.js

@@ -1,3 +1,3 @@
 module.exports = {
-  extends: [require.resolve('@backstage/cli/config/eslint.js')],
+  extends: [require.resolve('@backstage/cli/config/eslint')],
 };

packages/core/.eslintrc.js

@@ -1,5 +1,5 @@
 module.exports = {
-  extends: [require.resolve('@backstage/cli/config/eslint.js')],
+  extends: [require.resolve('@backstage/cli/config/eslint')],
   rules: {
     // TODO: add prop types to JS and remove
     'react/prop-types': 0,

packages/test-utils-core/.eslintrc.js

@@ -0,0 +1,3 @@
+module.exports = {
+  extends: [require.resolve('@backstage/cli/config/eslint')],
+};

packages/test-utils/.eslintrc.js

@@ -0,0 +1,3 @@
+module.exports = {
+  extends: [require.resolve('@backstage/cli/config/eslint')],
+};