Merge pull request #453 from cidgoh/bundling_changes

ddooley · web-flow · commit aa45f962e0c2 · 2024-12-17T09:24:04.000-08:00
Webpack bundling changes
diff --git a/.eslintrc.js b/.eslintrc.js
@@ -2,6 +2,7 @@ module.exports = {
   ignorePatterns: [
     '.eslintrc.js',
     'web/webpack.config.js',
+    'web/webpack.schemas.js',
     'lib/rollup.config.js',
     '**/dist/**/*.js',
     '.venv',
diff --git a/package.json b/package.json
@@ -27,9 +27,11 @@
     "lint": "prettier --check . && eslint .",
     "clean:lib": "rimraf lib/dist",
     "clean:web": "rimraf web/dist",
+    "clean:schemas": "rimraf web/dist/dist-schemas web/dist/templates",
     "clean": "yarn clean:lib && yarn clean:web",
     "build:lib": "yarn clean:lib && rollup --config lib/rollup.config.js",
-    "build:web": "yarn clean:web && webpack --mode=production --config web/webpack.config.js",
+    "build:web": "yarn clean:web && webpack --mode=production --config web/webpack.config.js && yarn build:schemas",
+    "build:schemas": "yarn clean:schemas && webpack --config web/webpack.schemas.js",
     "dev": "webpack serve --mode=development --config web/webpack.config.js",
     "test": "jest tests/"
   },
diff --git a/web/index.html b/web/index.html
@@ -5,6 +5,8 @@
     <meta http-equiv="X-UA-Compatible" content="IE=edge" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>DataHarmonizer</title>
+    <!--Ignore script 404 on dev server; this external import used in prod-->
+    <script src="dist-schemas/schemas.js"></script>
   </head>
   <body>
     <div class="container-fluid">
diff --git a/web/index.js b/web/index.js
@@ -1,9 +1,10 @@
 import { DataHarmonizer, Footer, Toolbar } from '../lib';
-import menu from './templates/menu.json';
 
 import 'bootstrap/dist/css/bootstrap.min.css';
 import './index.css';
 
+import { menu, getSchema, getExportFormats } from 'schemas';
+
 document.addEventListener('DOMContentLoaded', function () {
   const dhRoot = document.querySelector('#data-harmonizer-grid');
   const dhFooterRoot = document.querySelector('#data-harmonizer-footer');
@@ -25,11 +26,7 @@ document.addEventListener('DOMContentLoaded', function () {
   new Toolbar(dhToolbarRoot, dh, menu, {
     templatePath: templatePath,
     releasesURL: 'https://github.com/cidgoh/pathogen-genomics-package/releases',
-    getSchema: async (schema) => {
-      return (await import(`./templates/${schema}/schema.json`)).default;
-    },
-    getExportFormats: async (schema) => {
-      return (await import(`./templates/${schema}/export.js`)).default;
-    },
+    getSchema: getSchema,
+    getExportFormats: getExportFormats,
   });
 });
diff --git a/web/schemas.js b/web/schemas.js
@@ -0,0 +1,9 @@
+import menu_ from './templates/menu.json';
+
+export const menu = menu_;
+export const getSchema = async (schema) => {
+  return (await import(`./templates/${schema}/schema.json`)).default;
+};
+export const getExportFormats = async (schema) => {
+  return (await import(`./templates/${schema}/export.js`)).default;
+};
diff --git a/web/webpack.config.js b/web/webpack.config.js
@@ -9,29 +9,23 @@ module.exports = (env, argv) => {
     output: {
       path: path.resolve(__dirname, 'dist'),
       filename: 'scripts/[name].js',
-      assetModuleFilename: 'assets/[hash][ext][query]',
+    },
+    externals: {
+      // Without declaring `schemas` as external, Webpack will attempt to look
+      // for the `schemas` library and bundle it. However, we want our schemas
+      // bundle to be separate from this one. This external config tells webpack
+      // that the schemas library will instead be supplied at runtime. External
+      // libraries can be provided in multiple ways, but we provide it through a
+      // script reference in the HTML file outputted by this bundle.
+      // https://webpack.js.org/configuration/externals/#externals
+      schemas: 'schemas',
     },
     plugins: [
       new HtmlWebpackPlugin({
         template: './index.html',
       }),
       new CopyPlugin({
         patterns: [
-          {
-            context: 'templates',
-            from: '**/*.pdf',
-            to: 'templates/[path][name][ext]',
-          },
-          {
-            context: 'templates',
-            from: '**/schema.yaml',
-            to: 'templates/[path][name][ext]',
-          },
-          {
-            context: 'templates',
-            from: '**/exampleInput/*',
-            to: 'templates/[path][name][ext]',
-          },
           {
             from: 'main.html',
           },
@@ -52,6 +46,12 @@ module.exports = (env, argv) => {
         {
           test: /\.(png|svg|jpg|jpeg|gif)$/i,
           type: 'asset/resource',
+          generator: {
+            // Will throw a file not found error if ``dist`` folder not in
+            // ``{project root}/web/``.
+            filename: '../[file]',
+            emit: false,
+          },
         },
       ],
     },
@@ -61,8 +61,44 @@ module.exports = (env, argv) => {
     },
   };
 
+  // Difficult to run two webpack instances on a single dev server (i.e., this
+  // file, and the other webpack file that builds schemas). So for dev servers,
+  // we will stick to a singular build that concatenates both application and
+  // schema content. This is fine, because the whole point of having a separate
+  // build for schema content was to reduce production build times when users
+  // are only editing schema files (and not the rest of the application), but
+  // the dev server already gets around this problem through hot loading.
   if (argv.mode === 'development') {
     config.devtool = 'eval-source-map';
+    // The external schemas lib is replaced by a direct reference to the
+    // schemas entrypoint. When you directly reference the schemas entrypoint in
+    // this bundle, a separate schemas library is not needed, because this
+    // bundle will now include all schema content as well.
+    config.resolve = {
+      alias: {
+        schemas: path.resolve(__dirname, 'schemas.js'),
+      },
+    };
+    delete config.externals;
+    // Need pdf SOPs that schema build previously supplied
+    config.plugins.push(
+      new CopyPlugin({
+        patterns: [
+          {
+            context: 'templates',
+            from: '**/*.pdf',
+            to: 'templates/[path][name][ext]',
+          },
+        ],
+      })
+    );
+    // False emits don't play nice with dev servers either
+    for (const rule of config.module.rules) {
+      if (rule.hasOwnProperty('generator')) {
+        delete rule.generator.filename;
+        delete rule.generator.emit;
+      }
+    }
   }
 
   return config;
diff --git a/web/webpack.schemas.js b/web/webpack.schemas.js
@@ -0,0 +1,29 @@
+const path = require('path');
+const CopyPlugin = require('copy-webpack-plugin');
+
+module.exports = {
+  context: path.resolve(__dirname),
+  entry: {
+    schemas: './schemas.js',
+  },
+  output: {
+    path: path.resolve(__dirname, 'dist', 'dist-schemas'),
+    filename: '[name].js',
+    globalObject: 'this',
+    library: {
+      name: 'schemas',
+      type: 'umd',
+    },
+  },
+  plugins: [
+    new CopyPlugin({
+      patterns: [
+        {
+          context: 'templates',
+          from: '**/*.pdf',
+          to: '../templates/[path][name][ext]',
+        },
+      ],
+    }),
+  ],
+};
