chore(deps): Updated to Theia 1.39.0 (#2144)

- update Theia to `1.39.0`,
 - remove the application packager and fix the security vulnerabilities,
 - bundle the backed application with `webpack`, and
 - enhance the developer docs.

Co-authored-by: Akos Kitta <a.kitta@arduino.cc>
Co-authored-by: per1234 <accounts@perglass.com>

Signed-off-by: Akos Kitta <a.kitta@arduino.cc>

electron-app/webpack.base.js

@@ -0,0 +1,138 @@
+// @ts-check
+'use strict';
+
+const chmodr = require('chmodr');
+const CopyWebpackPlugin = require('copy-webpack-plugin');
+const path = require('node:path');
+const fs = require('node:fs/promises');
+
+const isWindows = process.platform === 'win32';
+const isMacOS = process.platform === 'darwin';
+
+function resolvePackagePath(target, baseDir = __dirname) {
+  const resolvePackageJsonPath = require('resolve-package-path');
+  const packageJsonPath = resolvePackageJsonPath(target, baseDir);
+  if (!packageJsonPath) {
+    throw new Error(
+      `Could not resolve package '${target}'. Base dir: ${baseDir}`
+    );
+  }
+  return path.join(packageJsonPath, '..'); // one level up to locate the package folder
+}
+
+// restore file permissions after webpack copy
+// https://github.com/webpack-contrib/copy-webpack-plugin/issues/35#issuecomment-1407280257
+class PermissionsPlugin {
+  constructor(targetPath, patchTheia12780 = false) {
+    this.targetPath = targetPath;
+    this.patchTheia12780 = patchTheia12780;
+  }
+
+  /**
+   * @param {import('webpack').Compiler} compiler
+   */
+  apply(compiler) {
+    compiler.hooks.afterEmit.tap('PermissionsPlugin', () => {
+      return new Promise(async (resolve, reject) => {
+        if (this.patchTheia12780) {
+          let trashBinaryFilename = undefined;
+          if (isWindows) {
+            trashBinaryFilename = 'windows-trash.exe';
+          } else if (isMacOS) {
+            trashBinaryFilename = 'macos-trash';
+          }
+          if (trashBinaryFilename) {
+            await fs.chmod(
+              path.join(__dirname, 'lib', 'backend', trashBinaryFilename),
+              0o755
+            );
+          }
+        }
+        chmodr(this.targetPath, 0o755, (err) =>
+          err ? reject(err) : resolve(undefined)
+        );
+      });
+    });
+  }
+}
+
+/**
+ * Creates webpack plugins to copy all required resources (binaries, plotter app, translation files, etc.) to the appropriate location.
+ * @param {string} targetPath where to copy the resources
+ * @param {boolean|undefined} [patchTheia12780=true] to apply patch for https://github.com/eclipse-theia/theia/issues/12780. Only required in the production app.
+ * @param {string|undefined} [baseDir=__dirname] to calculate the modules from. Defaults to `__dirname`
+ */
+function createCopyArduinoResourcesPlugins(
+  targetPath,
+  patchTheia12780 = false,
+  baseDir = __dirname
+) {
+  const trashBinariesPath = path.join(
+    resolvePackagePath('trash', baseDir),
+    'lib'
+  );
+  const copyOptions = {
+    patterns: [
+      // binaries
+      {
+        from: path.join(
+          resolvePackagePath('arduino-ide-extension', baseDir),
+          'src',
+          'node',
+          'resources'
+        ),
+        to: targetPath,
+        globOptions: {
+          ignore: ['**/i18n/**'],
+        },
+      },
+      // plotter app
+      {
+        from: path.join(
+          resolvePackagePath('arduino-serial-plotter-webapp', baseDir),
+          'build'
+        ),
+        to: path.resolve(targetPath, 'arduino-serial-plotter-webapp'),
+      },
+    ],
+  };
+
+  if (patchTheia12780) {
+    // workaround for https://github.com/eclipse-theia/theia/issues/12780
+    // copy the Windows (`windows-trash.exe`) and macOS (`macos-trash`) executables for `trash`
+    if (isWindows) {
+      copyOptions.patterns.push({
+        from: path.join(trashBinariesPath, 'windows-trash.exe'),
+        to: path.resolve(__dirname, 'lib', 'backend'),
+      });
+    } else if (isMacOS) {
+      copyOptions.patterns.push({
+        from: path.join(trashBinariesPath, 'macos-trash'),
+        to: path.resolve(__dirname, 'lib', 'backend'),
+      });
+    }
+  }
+  return [
+    new CopyWebpackPlugin(copyOptions),
+    new PermissionsPlugin(targetPath, patchTheia12780),
+  ];
+}
+
+/**
+ * Removes the compression webpack plugin if it's set in the config. Otherwise, it's NOOP>
+ * @param {import('webpack').Configuration} config
+ */
+function removeCompressionPlugin(config) {
+  const CompressionPlugin = require('compression-webpack-plugin');
+  for (let i = config.plugins?.length || 0; i >= 0; i--) {
+    const plugin = config.plugins?.[i];
+    if (plugin instanceof CompressionPlugin) {
+      config.plugins?.splice(i, 1);
+    }
+  }
+}
+
+module.exports = {
+  createCopyArduinoResourcesPlugins,
+  removeCompressionPlugin,
+};