@nx/webpack 0.0.0-pr-22179-271588f

package/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2017-2023 Narwhal Technologies Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+<p style="text-align: center;">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-dark.svg">
+    <img alt="Nx - Smart Monorepos · Fast CI" src="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-light.svg" width="100%">
+  </picture>
+</p>
+
+<div style="text-align: center;">
+
+[![CircleCI](https://circleci.com/gh/nrwl/nx.svg?style=svg)](https://circleci.com/gh/nrwl/nx)
+[![License](https://img.shields.io/npm/l/@nx/workspace.svg?style=flat-square)]()
+[![NPM Version](https://badge.fury.io/js/%40nrwl%2Fworkspace.svg)](https://www.npmjs.com/@nx/workspace)
+[![Semantic Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=flat-square)]()
+[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)
+[![Join the chat at https://gitter.im/nrwl-nx/community](https://badges.gitter.im/nrwl-nx/community.svg)](https://gitter.im/nrwl-nx/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Join us on the Official Nx Discord Server](https://img.shields.io/discord/1143497901675401286?label=discord)](https://go.nx.dev/community)
+
+</div>
+
+
+<hr>
+
+# Nx: Smart Monorepos · Fast CI
+
+Nx is a build system with built-in tooling and advanced CI capabilities. It helps you maintain and scale monorepos, both locally and on CI.
+
+This package is a [Webpack plugin for Nx](https://nx.dev/packages/webpack).
+
+## Getting Started
+
+### Creating an Nx Workspace
+
+**Using `npx`**
+
+```bash
+npx create-nx-workspace
+```
+
+**Using `npm init`**
+
+```bash
+npm init nx-workspace
+```
+
+**Using `yarn create`**
+
+```bash
+yarn create nx-workspace
+```
+
+### Adding Nx to an Existing Repository
+
+Run:
+
+```bash
+npx nx@latest init
+```
+
+## Documentation & Resources
+
+- [Nx.Dev: Documentation, Guides, Tutorials](https://nx.dev)
+- [Intro to Nx](https://nx.dev/getting-started/intro)
+- [Official Nx YouTube Channel](https://www.youtube.com/@NxDevtools)
+- [Blog Posts About Nx](https://blog.nrwl.io/nx/home)
+
+<p style="text-align: center;"><a href="https://nx.dev/#learning-materials" target="_blank" rel="noreferrer"><img src="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-courses-and-videos.svg" 
+width="100%" alt="Nx - Smart Monorepos · Fast CI"></a></p>
+

package/executors.json

@@ -0,0 +1,19 @@
+{
+  "executors": {
+    "webpack": {
+      "implementation": "./src/executors/webpack/webpack.impl",
+      "schema": "./src/executors/webpack/schema.json",
+      "description": "Run webpack build."
+    },
+    "dev-server": {
+      "implementation": "./src/executors/dev-server/dev-server.impl",
+      "schema": "./src/executors/dev-server/schema.json",
+      "description": "Serve a web application."
+    },
+    "ssr-dev-server": {
+      "implementation": "./src/executors/ssr-dev-server/ssr-dev-server.impl",
+      "schema": "./src/executors/ssr-dev-server/schema.json",
+      "description": "Serve a SSR application."
+    }
+  }
+}

package/generators.json

@@ -0,0 +1,20 @@
+{
+  "name": "Nx Webpack",
+  "version": "0.1",
+  "generators": {
+    "init": {
+      "factory": "./src/generators/init/init#webpackInitGeneratorInternal",
+      "schema": "./src/generators/init/schema.json",
+      "description": "Initialize the `@nrwl/webpack` plugin.",
+      "aliases": ["ng-add"],
+      "hidden": true
+    },
+    "configuration": {
+      "aliases": ["webpack-project"],
+      "factory": "./src/generators/configuration/configuration#configurationGeneratorInternal",
+      "schema": "./src/generators/configuration/schema.json",
+      "description": "Add webpack configuration to a project.",
+      "hidden": true
+    }
+  }
+}

package/index.d.ts

@@ -0,0 +1,18 @@
+import { configurationGenerator } from './src/generators/configuration/configuration';
+export { configurationGenerator };
+/** @deprecated Use `configurationGenerator` instead. */
+export declare const webpackProjectGenerator: typeof configurationGenerator;
+export * from './src/utils/create-copy-plugin';
+export * from './src/utils/config';
+export { webpackInitGenerator } from './src/generators/init/init';
+export type { WebDevServerOptions } from './src/executors/dev-server/schema';
+export * from './src/executors/dev-server/dev-server.impl';
+export * from './src/executors/webpack/lib/normalize-options';
+export type { WebpackExecutorOptions, NormalizedWebpackExecutorOptions, AssetGlobPattern, FileReplacement, } from './src/executors/webpack/schema';
+export * from './src/executors/webpack/webpack.impl';
+export * from './src/utils/get-css-module-local-ident';
+export * from './src/utils/with-nx';
+export * from './src/utils/with-web';
+export * from './src/utils/module-federation/public-api';
+export { NxWebpackPlugin } from './src/plugins/nx-webpack-plugin/nx-webpack-plugin';
+export { NxTsconfigPathsWebpackPlugin } from './src/plugins/nx-typescript-webpack-plugin/nx-tsconfig-paths-webpack-plugin';

package/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NxTsconfigPathsWebpackPlugin = exports.NxWebpackPlugin = exports.webpackInitGenerator = exports.webpackProjectGenerator = exports.configurationGenerator = void 0;
+const tslib_1 = require("tslib");
+const configuration_1 = require("./src/generators/configuration/configuration");
+Object.defineProperty(exports, "configurationGenerator", { enumerable: true, get: function () { return configuration_1.configurationGenerator; } });
+// Exported for backwards compatibility in case a plugin is using the old name.
+/** @deprecated Use `configurationGenerator` instead. */
+exports.webpackProjectGenerator = configuration_1.configurationGenerator;
+tslib_1.__exportStar(require("./src/utils/create-copy-plugin"), exports);
+tslib_1.__exportStar(require("./src/utils/config"), exports);
+var init_1 = require("./src/generators/init/init");
+Object.defineProperty(exports, "webpackInitGenerator", { enumerable: true, get: function () { return init_1.webpackInitGenerator; } });
+tslib_1.__exportStar(require("./src/executors/dev-server/dev-server.impl"), exports);
+tslib_1.__exportStar(require("./src/executors/webpack/lib/normalize-options"), exports);
+tslib_1.__exportStar(require("./src/executors/webpack/webpack.impl"), exports);
+tslib_1.__exportStar(require("./src/utils/get-css-module-local-ident"), exports);
+tslib_1.__exportStar(require("./src/utils/with-nx"), exports);
+tslib_1.__exportStar(require("./src/utils/with-web"), exports);
+tslib_1.__exportStar(require("./src/utils/module-federation/public-api"), exports);
+var nx_webpack_plugin_1 = require("./src/plugins/nx-webpack-plugin/nx-webpack-plugin");
+Object.defineProperty(exports, "NxWebpackPlugin", { enumerable: true, get: function () { return nx_webpack_plugin_1.NxWebpackPlugin; } });
+var nx_tsconfig_paths_webpack_plugin_1 = require("./src/plugins/nx-typescript-webpack-plugin/nx-tsconfig-paths-webpack-plugin");
+Object.defineProperty(exports, "NxTsconfigPathsWebpackPlugin", { enumerable: true, get: function () { return nx_tsconfig_paths_webpack_plugin_1.NxTsconfigPathsWebpackPlugin; } });

package/migrations.json

@@ -0,0 +1,60 @@
+{
+  "generators": {
+    "add-babel-inputs": {
+      "cli": "nx",
+      "version": "15.0.0-beta.0",
+      "description": "Adds babel.config.json to the hash of all tasks",
+      "factory": "./src/migrations/update-15-0-0/add-babel-inputs"
+    },
+    "remove-es2015-polyfills-option": {
+      "cli": "nx",
+      "version": "15.4.5-beta.0",
+      "description": "Removes es2015Polyfills option since legacy browsers are no longer supported.",
+      "factory": "./src/migrations/update-15-4-5/remove-es2015-polyfills-option"
+    },
+    "webpack-config-setup": {
+      "cli": "nx",
+      "version": "15.6.3-beta.0",
+      "description": "Creates or updates webpack.config.js file with the new options for webpack.",
+      "factory": "./src/migrations/update-15-6-3/webpack-config-setup"
+    },
+    "add-babelUpwardRootMode-flag": {
+      "cli": "nx",
+      "version": "15.7.2-beta.0",
+      "description": "Add the babelUpwardRootMode option to the build executor options.",
+      "factory": "./src/migrations/update-15-7-2/add-babelUpwardRootMode-flag"
+    },
+    "update-16-0-0-add-nx-packages": {
+      "cli": "nx",
+      "version": "16.0.0-beta.1",
+      "description": "Replace @nrwl/webpack with @nx/webpack",
+      "implementation": "./src/migrations/update-16-0-0-add-nx-packages/update-16-0-0-add-nx-packages"
+    },
+    "update-17-2-1-webpack-config-setup": {
+      "cli": "nx",
+      "version": "17.2.1-beta.0",
+      "description": "Add webpack.config.js file when webpackConfig is not defined",
+      "implementation": "./src/migrations/update-17-2-1/webpack-config-setup"
+    }
+  },
+  "packageJsonUpdates": {
+    "16.3.0": {
+      "version": "16.3.0-beta.8",
+      "packages": {
+        "@svgr/webpack": {
+          "version": "^8.0.1",
+          "alwaysAddToPackageJson": false
+        }
+      }
+    },
+    "16.4.1": {
+      "version": "16.4.1-beta.0",
+      "packages": {
+        "webpack": {
+          "version": "^5.80.0",
+          "alwaysAddToPackageJson": false
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@nx/webpack",
+  "version": "0.0.0-pr-22179-271588f",
+  "private": false,
+  "description": "The Nx Plugin for Webpack contains executors and generators that support building applications using Webpack.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nrwl/nx.git",
+    "directory": "packages/webpack"
+  },
+  "keywords": [
+    "Monorepo",
+    "Webpack",
+    "Web",
+    "CLI"
+  ],
+  "main": "./index.js",
+  "typings": "./index.d.ts",
+  "author": "Victor Savkin",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/nrwl/nx/issues"
+  },
+  "homepage": "https://nx.dev",
+  "generators": "./generators.json",
+  "executors": "./executors.json",
+  "ng-update": {
+    "requirements": {},
+    "migrations": "./migrations.json"
+  },
+  "dependencies": {
+    "@babel/core": "^7.23.2",
+    "ajv": "^8.12.0",
+    "autoprefixer": "^10.4.9",
+    "babel-loader": "^9.1.2",
+    "browserslist": "^4.21.4",
+    "chalk": "^4.1.0",
+    "copy-webpack-plugin": "^10.2.4",
+    "css-loader": "^6.4.0",
+    "css-minimizer-webpack-plugin": "^5.0.0",
+    "fork-ts-checker-webpack-plugin": "7.2.13",
+    "less": "4.1.3",
+    "less-loader": "11.1.0",
+    "license-webpack-plugin": "^4.0.2",
+    "loader-utils": "^2.0.3",
+    "mini-css-extract-plugin": "~2.4.7",
+    "parse5": "4.0.0",
+    "postcss": "^8.4.14",
+    "postcss-import": "~14.1.0",
+    "postcss-loader": "^6.1.1",
+    "rxjs": "^7.8.0",
+    "sass": "^1.42.1",
+    "sass-loader": "^12.2.0",
+    "source-map-loader": "^3.0.0",
+    "style-loader": "^3.3.0",
+    "stylus": "^0.59.0",
+    "stylus-loader": "^7.1.0",
+    "terser-webpack-plugin": "^5.3.3",
+    "ts-loader": "^9.3.1",
+    "tsconfig-paths-webpack-plugin": "4.0.0",
+    "tslib": "^2.3.0",
+    "webpack": "^5.80.0",
+    "webpack-dev-server": "^4.9.3",
+    "webpack-node-externals": "^3.0.0",
+    "webpack-subresource-integrity": "^5.1.0",
+    "@nx/devkit": "0.0.0-pr-22179-271588f",
+    "@nx/js": "0.0.0-pr-22179-271588f",
+    "@nrwl/webpack": "0.0.0-pr-22179-271588f"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "commonjs"
+}

package/plugin.d.ts

@@ -0,0 +1 @@
+export { createNodes } from './src/plugins/plugin';

package/plugin.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNodes = void 0;
+var plugin_1 = require("./src/plugins/plugin");
+Object.defineProperty(exports, "createNodes", { enumerable: true, get: function () { return plugin_1.createNodes; } });

package/src/executors/dev-server/dev-server.impl.d.ts

@@ -0,0 +1,7 @@
+import { ExecutorContext } from '@nx/devkit';
+import { WebDevServerOptions } from './schema';
+export declare function devServerExecutor(serveOptions: WebDevServerOptions, context: ExecutorContext): AsyncGenerator<{
+    baseUrl: string;
+    success: boolean;
+}, any, undefined>;
+export default devServerExecutor;

package/src/executors/dev-server/dev-server.impl.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.devServerExecutor = void 0;
+const webpack = require("webpack");
+const devkit_1 = require("@nx/devkit");
+const rxjs_for_await_1 = require("@nx/devkit/src/utils/rxjs-for-await");
+const operators_1 = require("rxjs/operators");
+const WebpackDevServer = require("webpack-dev-server");
+const get_dev_server_config_1 = require("./lib/get-dev-server-config");
+const buildable_libs_utils_1 = require("@nx/js/src/utils/buildable-libs-utils");
+const run_webpack_1 = require("../../utils/run-webpack");
+const resolve_user_defined_webpack_config_1 = require("../../utils/webpack/resolve-user-defined-webpack-config");
+const normalize_options_1 = require("../webpack/lib/normalize-options");
+const config_1 = require("../../utils/config");
+const js_1 = require("@nx/js");
+async function* devServerExecutor(serveOptions, context) {
+    // Default to dev mode so builds are faster and HMR mode works better.
+    process.env.NODE_ENV ??= 'development';
+    const { root: projectRoot, sourceRoot } = context.projectsConfigurations.projects[context.projectName];
+    const buildOptions = (0, normalize_options_1.normalizeOptions)(getBuildOptions(serveOptions, context), context.root, projectRoot, sourceRoot);
+    process.env.NX_BUILD_LIBS_FROM_SOURCE = `${buildOptions.buildLibsFromSource}`;
+    process.env.NX_BUILD_TARGET = serveOptions.buildTarget;
+    // TODO(jack): Figure out a way to port this into NxWebpackPlugin
+    if (!buildOptions.buildLibsFromSource) {
+        if (!buildOptions.tsConfig) {
+            throw new Error(`Cannot find "tsConfig" to remap paths for. Set this option in project.json.`);
+        }
+        const { target, dependencies } = (0, buildable_libs_utils_1.calculateProjectBuildableDependencies)(context.taskGraph, context.projectGraph, context.root, context.projectName, 'build', // should be generalized
+        context.configurationName);
+        buildOptions.tsConfig = (0, buildable_libs_utils_1.createTmpTsConfig)(buildOptions.tsConfig, context.root, target.data.root, dependencies);
+        process.env.NX_TSCONFIG_PATH = buildOptions.tsConfig;
+    }
+    let config;
+    const devServer = (0, get_dev_server_config_1.getDevServerOptions)(context.root, serveOptions, buildOptions);
+    if (buildOptions.webpackConfig) {
+        let userDefinedWebpackConfig = (0, resolve_user_defined_webpack_config_1.resolveUserDefinedWebpackConfig)(buildOptions.webpackConfig, (0, js_1.getRootTsConfigPath)());
+        if (typeof userDefinedWebpackConfig.then === 'function') {
+            userDefinedWebpackConfig = await userDefinedWebpackConfig;
+        }
+        // Only add the dev server option if user is composable plugin.
+        // Otherwise, user should define `devServer` option directly in their webpack config.
+        if (typeof userDefinedWebpackConfig === 'function' &&
+            ((0, config_1.isNxWebpackComposablePlugin)(userDefinedWebpackConfig) ||
+                !buildOptions.standardWebpackConfigFunction)) {
+            config = await userDefinedWebpackConfig({ devServer }, {
+                options: buildOptions,
+                context,
+                configuration: serveOptions.buildTarget.split(':')[2],
+            });
+        }
+    }
+    return yield* (0, rxjs_for_await_1.eachValueFrom)((0, run_webpack_1.runWebpackDevServer)(config, webpack, WebpackDevServer).pipe((0, operators_1.tap)(({ stats }) => {
+        console.info(stats.toString(config.stats));
+    }), (0, operators_1.map)(({ baseUrl, stats }) => {
+        return {
+            baseUrl,
+            success: !stats.hasErrors(),
+        };
+    })));
+}
+exports.devServerExecutor = devServerExecutor;
+function getBuildOptions(options, context) {
+    const target = (0, devkit_1.parseTargetString)(options.buildTarget, context);
+    const overrides = {
+        watch: false,
+    };
+    if (options.memoryLimit) {
+        overrides.memoryLimit = options.memoryLimit;
+    }
+    if (options.baseHref) {
+        overrides.baseHref = options.baseHref;
+    }
+    const buildOptions = (0, devkit_1.readTargetOptions)(target, context);
+    return {
+        ...buildOptions,
+        ...overrides,
+    };
+}
+exports.default = devServerExecutor;

package/src/executors/dev-server/lib/get-dev-server-config.d.ts

@@ -0,0 +1,4 @@
+import type { Configuration as WebpackDevServerConfiguration } from 'webpack-dev-server';
+import { WebDevServerOptions } from '../schema';
+import { NormalizedWebpackExecutorOptions } from '../../webpack/schema';
+export declare function getDevServerOptions(root: string, serveOptions: WebDevServerOptions, buildOptions: NormalizedWebpackExecutorOptions): WebpackDevServerConfiguration;

package/src/executors/dev-server/lib/get-dev-server-config.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDevServerOptions = void 0;
+const devkit_1 = require("@nx/devkit");
+const path = require("path");
+const fs_1 = require("fs");
+const serve_path_1 = require("./serve-path");
+function getDevServerOptions(root, serveOptions, buildOptions) {
+    const servePath = (0, serve_path_1.buildServePath)(buildOptions);
+    let scriptsOptimization;
+    let stylesOptimization;
+    if (typeof buildOptions.optimization === 'boolean') {
+        scriptsOptimization = stylesOptimization = buildOptions.optimization;
+    }
+    else if (buildOptions.optimization) {
+        scriptsOptimization = buildOptions.optimization.scripts;
+        stylesOptimization = buildOptions.optimization.styles;
+    }
+    else {
+        scriptsOptimization = stylesOptimization = false;
+    }
+    const config = {
+        host: serveOptions.host,
+        port: serveOptions.port,
+        headers: { 'Access-Control-Allow-Origin': '*' },
+        historyApiFallback: {
+            index: buildOptions.index &&
+                `${servePath}${path.basename(buildOptions.index)}`,
+            disableDotRule: true,
+            htmlAcceptHeaders: ['text/html', 'application/xhtml+xml'],
+        },
+        onListening(server) {
+            const isHttps = server.options.https || server.options.server?.type === 'https';
+            devkit_1.logger.info(`NX Web Development Server is listening at ${isHttps ? 'https' : 'http'}://${server.options.host}:${server.options.port}${(0, serve_path_1.buildServePath)(buildOptions)}`);
+        },
+        open: serveOptions.open,
+        static: false,
+        compress: scriptsOptimization || stylesOptimization,
+        devMiddleware: {
+            publicPath: servePath,
+            stats: false,
+        },
+        client: {
+            webSocketURL: serveOptions.publicHost,
+            overlay: {
+                errors: !(scriptsOptimization || stylesOptimization),
+                warnings: false,
+            },
+        },
+        liveReload: serveOptions.hmr ? false : serveOptions.liveReload, // disable liveReload if hmr is enabled
+        hot: serveOptions.hmr,
+    };
+    if (serveOptions.ssl) {
+        config.server = {
+            type: 'https',
+        };
+        if (serveOptions.sslKey && serveOptions.sslCert) {
+            config.server.options = getSslConfig(root, serveOptions);
+        }
+    }
+    if (serveOptions.proxyConfig) {
+        config.proxy = getProxyConfig(root, serveOptions);
+    }
+    if (serveOptions.allowedHosts) {
+        config.allowedHosts = serveOptions.allowedHosts.split(',');
+    }
+    return config;
+}
+exports.getDevServerOptions = getDevServerOptions;
+function getSslConfig(root, options) {
+    return {
+        key: (0, fs_1.readFileSync)(path.resolve(root, options.sslKey), 'utf-8'),
+        cert: (0, fs_1.readFileSync)(path.resolve(root, options.sslCert), 'utf-8'),
+    };
+}
+function getProxyConfig(root, options) {
+    const proxyPath = path.resolve(root, options.proxyConfig);
+    return require(proxyPath);
+}

package/src/executors/dev-server/lib/serve-path.d.ts

@@ -0,0 +1,3 @@
+import type { NormalizedWebpackExecutorOptions } from '../../webpack/schema';
+export declare function buildServePath(browserOptions: NormalizedWebpackExecutorOptions): string;
+export declare function _findDefaultServePath(baseHref?: string, deployUrl?: string): string | null;

package/src/executors/dev-server/lib/serve-path.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._findDefaultServePath = exports.buildServePath = void 0;
+function buildServePath(browserOptions) {
+    let servePath = _findDefaultServePath(browserOptions.baseHref, browserOptions.deployUrl) ||
+        '/';
+    if (servePath.endsWith('/')) {
+        servePath = servePath.slice(0, -1);
+    }
+    if (!servePath.startsWith('/')) {
+        servePath = `/${servePath}`;
+    }
+    return servePath;
+}
+exports.buildServePath = buildServePath;
+function _findDefaultServePath(baseHref, deployUrl) {
+    if (!baseHref && !deployUrl) {
+        return '';
+    }
+    if (/^(\w+:)?\/\//.test(baseHref || '') ||
+        /^(\w+:)?\/\//.test(deployUrl || '')) {
+        // If baseHref or deployUrl is absolute, unsupported by nx serve
+        return null;
+    }
+    // normalize baseHref
+    // for nx serve the starting base is always `/` so a relative
+    // and root relative value are identical
+    const baseHrefParts = (baseHref || '')
+        .split('/')
+        .filter((part) => part !== '');
+    if (baseHref && !baseHref.endsWith('/')) {
+        baseHrefParts.pop();
+    }
+    const normalizedBaseHref = baseHrefParts.length === 0 ? '/' : `/${baseHrefParts.join('/')}/`;
+    if (deployUrl && deployUrl[0] === '/') {
+        if (baseHref && baseHref[0] === '/' && normalizedBaseHref !== deployUrl) {
+            // If baseHref and deployUrl are root relative and not equivalent, unsupported by nx serve
+            return null;
+        }
+        return deployUrl;
+    }
+    // Join together baseHref and deployUrl
+    return `${normalizedBaseHref}${deployUrl || ''}`;
+}
+exports._findDefaultServePath = _findDefaultServePath;

package/src/executors/dev-server/schema.d.ts

@@ -0,0 +1,17 @@
+export interface WebDevServerOptions {
+  host?: string;
+  port?: number;
+  publicHost?: string;
+  ssl?: boolean;
+  sslKey?: string;
+  sslCert?: string;
+  proxyConfig?: string;
+  buildTarget: string;
+  open?: boolean;
+  liveReload?: boolean;
+  hmr?: boolean;
+  watch?: boolean;
+  allowedHosts?: string;
+  memoryLimit?: number;
+  baseHref?: string;
+}

package/src/executors/dev-server/schema.json

@@ -0,0 +1,76 @@
+{
+  "version": 2,
+  "outputCapture": "direct-nodejs",
+  "title": "Webpack dev server",
+  "description": "Serve an application using webpack.",
+  "cli": "nx",
+  "type": "object",
+  "properties": {
+    "buildTarget": {
+      "type": "string",
+      "description": "Target which builds the application.",
+      "x-priority": "important"
+    },
+    "port": {
+      "type": "number",
+      "description": "Port to listen on.",
+      "default": 4200,
+      "x-priority": "important"
+    },
+    "host": {
+      "type": "string",
+      "description": "Host to listen on.",
+      "default": "localhost"
+    },
+    "ssl": {
+      "type": "boolean",
+      "description": "Serve using `HTTPS`.",
+      "default": false
+    },
+    "sslKey": {
+      "type": "string",
+      "description": "SSL key to use for serving `HTTPS`."
+    },
+    "sslCert": {
+      "type": "string",
+      "description": "SSL certificate to use for serving `HTTPS`."
+    },
+    "watch": {
+      "type": "boolean",
+      "description": "Watches for changes and rebuilds application.",
+      "default": true
+    },
+    "liveReload": {
+      "type": "boolean",
+      "description": "Whether to reload the page on change, using live-reload.",
+      "default": true
+    },
+    "hmr": {
+      "type": "boolean",
+      "description": "Enable hot module replacement.",
+      "default": false
+    },
+    "publicHost": {
+      "type": "string",
+      "description": "Public URL where the application will be served."
+    },
+    "open": {
+      "type": "boolean",
+      "description": "Open the application in the browser.",
+      "default": false,
+      "x-priority": "important"
+    },
+    "allowedHosts": {
+      "type": "string",
+      "description": "This option allows you to whitelist services that are allowed to access the dev server."
+    },
+    "memoryLimit": {
+      "type": "number",
+      "description": "Memory limit for type checking service process in `MB`."
+    },
+    "baseHref": {
+      "type": "string",
+      "description": "Base url for the application being built."
+    }
+  }
+}

package/src/executors/ssr-dev-server/lib/wait-until-server-is-listening.d.ts

@@ -0,0 +1 @@
+export declare function waitUntilServerIsListening(port: number): Promise<void>;