@nx/webpack 24.0.0-beta.1 → 24.0.0-beta.3

package/dist/src/executors/webpack/schema.json

@@ -1,459 +0,0 @@
-{
-  "version": 2,
-  "outputCapture": "direct-nodejs",
-  "title": "Webpack builder",
-  "description": "Build a project using webpack.",
-  "cli": "nx",
-  "type": "object",
-  "x-deprecated": "The `@nx/webpack:webpack` executor is deprecated and will be removed in Nx v24. Run `nx g @nx/webpack:convert-to-inferred` to migrate to the `@nx/webpack/plugin` inferred plugin. See https://nx.dev/docs/guides/tasks--caching/convert-to-inferred for details.",
-  "properties": {
-    "crossOrigin": {
-      "type": "string",
-      "description": "The `crossorigin` attribute to use for generated javascript script tags.  One of 'none' | 'anonymous' | 'use-credentials'."
-    },
-    "main": {
-      "type": "string",
-      "description": "The name of the main entry-point file.",
-      "x-completion-type": "file",
-      "x-completion-glob": "**/*@(.js|.ts|.tsx)",
-      "x-priority": "important"
-    },
-    "tsConfig": {
-      "type": "string",
-      "description": "The name of the Typescript configuration file.",
-      "x-completion-type": "file",
-      "x-completion-glob": "tsconfig.*.json",
-      "x-priority": "important"
-    },
-    "compiler": {
-      "type": "string",
-      "description": "The compiler to use.",
-      "enum": ["babel", "swc", "tsc"]
-    },
-    "outputPath": {
-      "type": "string",
-      "description": "The output path of the generated files.",
-      "x-completion-type": "directory",
-      "x-priority": "important"
-    },
-    "target": {
-      "type": "string",
-      "alias": "platform",
-      "description": "Target platform for the build, same as the Webpack target option.",
-      "enum": ["node", "web", "webworker"]
-    },
-    "watch": {
-      "type": "boolean",
-      "description": "Enable re-building when files change."
-    },
-    "cache": {
-      "description": "Configure webpack caching behavior. When not specified, defaults to `{ type: 'memory' }` for Node targets in watch mode, and `undefined` otherwise.",
-      "oneOf": [
-        {
-          "type": "boolean"
-        },
-        {
-          "type": "object",
-          "properties": {
-            "type": {
-              "type": "string",
-              "description": "The type of cache to use.",
-              "enum": ["memory", "filesystem"]
-            }
-          },
-          "additionalProperties": true
-        }
-      ]
-    },
-    "baseHref": {
-      "type": "string",
-      "description": "Base url for the application being built."
-    },
-    "deployUrl": {
-      "type": "string",
-      "description": "URL where the application will be deployed."
-    },
-    "vendorChunk": {
-      "type": "boolean",
-      "description": "Use a separate bundle containing only vendor libraries."
-    },
-    "commonChunk": {
-      "type": "boolean",
-      "description": "Use a separate bundle containing code used across multiple bundles."
-    },
-    "runtimeChunk": {
-      "type": "boolean",
-      "description": "Use a separate bundle containing the runtime."
-    },
-    "skipTypeChecking": {
-      "alias": "typeCheck",
-      "type": "boolean",
-      "description": "Skip the type checking. Default is `false`.",
-      "x-deprecated": "Use `typeCheckOptions` instead. This option will be removed in Nx 24."
-    },
-    "typeCheckOptions": {
-      "description": "Configure type checking during the build. Set to `true` to enable with defaults (async: true). Set to `false` to disable type checking entirely. Use `{ async: true }` to run type checking in a separate process without blocking the build. Default is `{ async: true }`.",
-      "oneOf": [
-        {
-          "type": "boolean"
-        },
-        {
-          "type": "object",
-          "properties": {
-            "async": {
-              "type": "boolean",
-              "description": "Run type checking in a separate process without blocking the build.",
-              "default": true
-            }
-          },
-          "additionalProperties": false
-        }
-      ]
-    },
-    "sourceMap": {
-      "description": "Output sourcemaps. Use 'hidden' for use with error reporting tools without generating sourcemap comment.",
-      "oneOf": [
-        {
-          "type": "boolean"
-        },
-        {
-          "type": "string"
-        }
-      ]
-    },
-    "progress": {
-      "type": "boolean",
-      "description": "Log progress to the console while building."
-    },
-    "poll": {
-      "type": "number",
-      "description": "Enable and define the file watching poll time period."
-    },
-    "assets": {
-      "type": "array",
-      "description": "List of static application assets.",
-      "items": {
-        "$ref": "#/definitions/assetPattern"
-      }
-    },
-    "index": {
-      "type": "string",
-      "description": "HTML File which will be contain the application.",
-      "x-completion-type": "file",
-      "x-completion-glob": "**/*@(.html|.htm)"
-    },
-    "scripts": {
-      "type": "array",
-      "description": "External Scripts which will be included before the main application entry.",
-      "items": {
-        "$ref": "#/definitions/extraEntryPoint"
-      }
-    },
-    "styles": {
-      "type": "array",
-      "description": "External Styles which will be included with the application",
-      "items": {
-        "$ref": "#/definitions/extraEntryPoint"
-      }
-    },
-    "namedChunks": {
-      "type": "boolean",
-      "description": "Names the produced bundles according to their entry file."
-    },
-    "outputHashing": {
-      "type": "string",
-      "description": "Define the output filename cache-busting hashing mode.",
-      "enum": ["none", "all", "media", "bundles"]
-    },
-    "stylePreprocessorOptions": {
-      "description": "Options to pass to style preprocessors.",
-      "type": "object",
-      "properties": {
-        "includePaths": {
-          "description": "Paths to include. Paths will be resolved to project root.",
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        }
-      },
-      "additionalProperties": false
-    },
-    "optimization": {
-      "description": "Enables optimization of the build output.",
-      "oneOf": [
-        {
-          "type": "object",
-          "properties": {
-            "scripts": {
-              "type": "boolean",
-              "description": "Enables optimization of the scripts output.",
-              "default": true
-            },
-            "styles": {
-              "type": "boolean",
-              "description": "Enables optimization of the styles output.",
-              "default": true
-            }
-          },
-          "additionalProperties": false
-        },
-        {
-          "type": "boolean"
-        }
-      ]
-    },
-    "generatePackageJson": {
-      "type": "boolean",
-      "description": "Generates a `package.json` and pruned lock file with the project's `node_module` dependencies populated for installing in a container. If a `package.json` exists in the project's directory, it will be reused with dependencies populated."
-    },
-    "skipOverrides": {
-      "type": "boolean",
-      "description": "Do not add a `overrides` and `resolutions` entries to the generated package.json file. Only works in conjunction with `generatePackageJson` option."
-    },
-    "skipPackageManager": {
-      "type": "boolean",
-      "description": "Do not add a `packageManager` entry to the generated package.json file. Only works in conjunction with `generatePackageJson` option."
-    },
-    "transformers": {
-      "type": "array",
-      "description": "List of TypeScript Compiler Transfomers Plugins.",
-      "aliases": ["tsPlugins"],
-      "items": {
-        "$ref": "#/definitions/transformerPattern"
-      }
-    },
-    "additionalEntryPoints": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "entryName": {
-            "type": "string",
-            "description": "Name of the additional entry file."
-          },
-          "entryPath": {
-            "type": "string",
-            "description": "Path to the additional entry file.",
-            "x-completion-type": "file",
-            "x-completion-glob": "**/*@(.js|.ts)"
-          }
-        }
-      }
-    },
-    "outputFileName": {
-      "type": "string",
-      "description": "Name of the main output file.",
-      "default": "main.js"
-    },
-    "externalDependencies": {
-      "oneOf": [
-        {
-          "type": "string",
-          "enum": ["none", "all"]
-        },
-        {
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        }
-      ],
-      "description": "Dependencies to keep external to the bundle. (`all` (default), `none`, or an array of module names)"
-    },
-    "extractCss": {
-      "type": "boolean",
-      "description": "Extract CSS into a `.css` file."
-    },
-    "cssModuleHashFunction": {
-      "type": "string",
-      "description": "Hash algorithm used to generate CSS module class names. Defaults to `md5`, which FIPS-restricted OpenSSL rejects. Changing it renames generated class names."
-    },
-    "subresourceIntegrity": {
-      "type": "boolean",
-      "description": "Enables the use of subresource integrity validation."
-    },
-    "polyfills": {
-      "type": "string",
-      "description": "Polyfills to load before application",
-      "x-completion-type": "file",
-      "x-completion-glob": "**/*@(.js|.ts|.tsx)"
-    },
-    "verbose": {
-      "type": "boolean",
-      "description": "Emits verbose output"
-    },
-    "statsJson": {
-      "type": "boolean",
-      "description": "Generates a 'stats.json' file which can be analyzed using tools such as: 'webpack-bundle-analyzer' or `<https://webpack.github.io/analyse>`."
-    },
-    "runtimeDependencies": {
-      "description": "Add runtime dependencies to the generated `package.json` file. Useful for Docker install.",
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "standardWebpackConfigFunction": {
-      "type": "boolean",
-      "description": "Set to true if the webpack config exports a standard webpack function, not an Nx-specific one. See: https://webpack.js.org/configuration/configuration-types/#exporting-a-function",
-      "default": false
-    },
-    "extractLicenses": {
-      "type": "boolean",
-      "description": "Extract all licenses in a separate file, in the case of production builds only."
-    },
-    "memoryLimit": {
-      "type": "number",
-      "description": "Memory limit for type checking service process in `MB`."
-    },
-    "fileReplacements": {
-      "description": "Replace files with other files in the build.",
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "replace": {
-            "type": "string",
-            "description": "The file to be replaced.",
-            "x-completion-type": "file"
-          },
-          "with": {
-            "type": "string",
-            "description": "The file to replace with.",
-            "x-completion-type": "file"
-          }
-        },
-        "additionalProperties": false,
-        "required": ["replace", "with"]
-      }
-    },
-    "buildLibsFromSource": {
-      "type": "boolean",
-      "description": "Read buildable libraries from source instead of building them separately. If set to `false`, the `tsConfig` option must also be set to remap paths.",
-      "default": true
-    },
-    "generateIndexHtml": {
-      "type": "boolean",
-      "description": "Generates `index.html` file to the output path. This can be turned off if using a webpack plugin to generate HTML such as `html-webpack-plugin`."
-    },
-    "postcssConfig": {
-      "type": "string",
-      "description": "Set a path to PostCSS config that applies to the app and all libs. Defaults to `undefined`, which auto-detects postcss.config.js files in each `app`/`lib` directory."
-    },
-    "webpackConfig": {
-      "type": "string",
-      "description": "Path to a function which takes a webpack config, some context and returns the resulting webpack config. See https://nx.dev/guides/customize-webpack",
-      "x-completion-type": "file",
-      "x-completion-glob": "webpack?(*)@(.js|.ts)",
-      "x-priority": "important"
-    },
-    "babelUpwardRootMode": {
-      "type": "boolean",
-      "description": "Whether to set rootmode to upward. See https://babeljs.io/docs/en/options#rootmode"
-    },
-    "babelConfig": {
-      "type": "string",
-      "description": "Path to the babel configuration file of your project. If not provided, Nx will default to the .babelrc file at the root of your project. See https://babeljs.io/docs/en/config-files",
-      "x-completion-type": "file"
-    },
-    "publicPath": {
-      "type": "string",
-      "description": "Set a public path for assets resources with absolute paths."
-    },
-    "rebaseRootRelative": {
-      "type": "boolean",
-      "description": "Whether to rebase absolute path for assets in postcss cli resources."
-    }
-  },
-  "required": [],
-  "definitions": {
-    "assetPattern": {
-      "oneOf": [
-        {
-          "type": "object",
-          "properties": {
-            "glob": {
-              "type": "string",
-              "description": "The pattern to match."
-            },
-            "input": {
-              "type": "string",
-              "description": "The input directory path in which to apply 'glob'. Defaults to the project root."
-            },
-            "ignore": {
-              "description": "An array of globs to ignore.",
-              "type": "array",
-              "items": {
-                "type": "string"
-              }
-            },
-            "output": {
-              "type": "string",
-              "description": "Absolute path within the output."
-            }
-          },
-          "additionalProperties": false,
-          "required": ["glob", "input", "output"]
-        },
-        {
-          "type": "string"
-        }
-      ]
-    },
-    "extraEntryPoint": {
-      "oneOf": [
-        {
-          "type": "object",
-          "properties": {
-            "input": {
-              "type": "string",
-              "description": "The file to include.",
-              "x-completion-type": "file",
-              "x-completion-glob": "**/*@(.css|.scss|.less|.sass)"
-            },
-            "bundleName": {
-              "type": "string",
-              "description": "The bundle name for this extra entry point."
-            },
-            "inject": {
-              "type": "boolean",
-              "description": "If the bundle will be referenced in the HTML file.",
-              "default": true
-            }
-          },
-          "additionalProperties": false,
-          "required": ["input"]
-        },
-        {
-          "type": "string",
-          "description": "The file to include.",
-          "x-completion-type": "file",
-          "x-completion-glob": "**/*@(.css|.scss|.less|.sass)"
-        }
-      ]
-    },
-    "transformerPattern": {
-      "oneOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "object",
-          "properties": {
-            "name": {
-              "type": "string"
-            },
-            "options": {
-              "type": "object",
-              "additionalProperties": true
-            }
-          },
-          "additionalProperties": false,
-          "required": ["name"]
-        }
-      ]
-    }
-  },
-  "examplesFile": "../../../docs/webpack-build-executor-examples.md"
-}

package/dist/src/executors/webpack/webpack.impl.d.ts

@@ -1,13 +0,0 @@
-import { ExecutorContext } from '@nx/devkit';
-import type { WebpackExecutorOptions } from './schema';
-export type WebpackExecutorEvent = {
-    success: false;
-    outfile?: string;
-    options?: WebpackExecutorOptions;
-} | {
-    success: true;
-    outfile: string;
-    options?: WebpackExecutorOptions;
-};
-export declare function webpackExecutor(_options: WebpackExecutorOptions, context: ExecutorContext): AsyncGenerator<WebpackExecutorEvent, WebpackExecutorEvent, undefined>;
-export default webpackExecutor;

package/dist/src/executors/webpack/webpack.impl.js

@@ -1,117 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.webpackExecutor = webpackExecutor;
-const internal_1 = require("@nx/devkit/internal");
-const devkit_1 = require("@nx/devkit");
-const js_1 = require("@nx/js");
-const internal_2 = require("@nx/js/internal");
-const path_1 = require("path");
-const rxjs_1 = require("rxjs");
-const operators_1 = require("rxjs/operators");
-const config_1 = require("../../utils/config");
-const resolve_user_defined_webpack_config_1 = require("../../utils/webpack/resolve-user-defined-webpack-config");
-const deprecation_1 = require("../../utils/deprecation");
-const normalize_options_1 = require("./lib/normalize-options");
-const run_webpack_1 = require("./lib/run-webpack");
-async function getWebpackConfigs(options, context) {
-    let userDefinedWebpackConfig = null;
-    if (options.webpackConfig) {
-        userDefinedWebpackConfig = (0, resolve_user_defined_webpack_config_1.resolveUserDefinedWebpackConfig)(options.webpackConfig, (0, js_1.getRootTsConfigPath)());
-        if (typeof userDefinedWebpackConfig.then === 'function') {
-            userDefinedWebpackConfig = await userDefinedWebpackConfig;
-        }
-    }
-    const config = {};
-    if (typeof userDefinedWebpackConfig === 'function' &&
-        ((0, config_1.isNxWebpackComposablePlugin)(userDefinedWebpackConfig) ||
-            !options.standardWebpackConfigFunction)) {
-        // Old behavior, call the Nx-specific webpack config function that user exports
-        return await userDefinedWebpackConfig(config, {
-            options,
-            context,
-            configuration: context.configurationName, // backwards compat
-        });
-    }
-    else if (userDefinedWebpackConfig) {
-        if (typeof userDefinedWebpackConfig === 'function') {
-            // assume it's an async standard webpack config function
-            // https://webpack.js.org/configuration/configuration-types/#exporting-a-promise
-            return await userDefinedWebpackConfig(process.env.NODE_ENV, {});
-        }
-        // New behavior, we want the webpack config to export object
-        return userDefinedWebpackConfig;
-    }
-    else {
-        // Fallback case, if we cannot find a webpack config path
-        return config;
-    }
-}
-async function* webpackExecutor(_options, context) {
-    (0, deprecation_1.warnWebpackExecutorDeprecation)();
-    // Default to production build.
-    process.env['NODE_ENV'] ||= 'production';
-    const metadata = context.projectsConfigurations.projects[context.projectName];
-    const sourceRoot = (0, internal_2.getProjectSourceRoot)(metadata);
-    const options = (0, normalize_options_1.normalizeOptions)(_options, context.root, metadata.root, sourceRoot);
-    const isScriptOptimizeOn = typeof options.optimization === 'boolean'
-        ? options.optimization
-        : options.optimization && options.optimization.scripts
-            ? options.optimization.scripts
-            : false;
-    process.env.NODE_ENV ||= isScriptOptimizeOn
-        ? 'production'
-        : 'development';
-    process.env.NX_BUILD_LIBS_FROM_SOURCE = `${options.buildLibsFromSource}`;
-    process.env.NX_BUILD_TARGET = (0, devkit_1.targetToTargetString)({
-        project: context.projectName,
-        target: context.targetName,
-        configuration: context.configurationName,
-    });
-    if (options.compiler === 'swc') {
-        try {
-            require.resolve('swc-loader');
-            require.resolve('@swc/core');
-        }
-        catch {
-            devkit_1.logger.error(`Missing SWC dependencies: @swc/core, swc-loader. Make sure you install them first.`);
-            return {
-                success: false,
-                options,
-            };
-        }
-    }
-    if (options.generatePackageJson && metadata.projectType !== 'application') {
-        devkit_1.logger.warn((0, devkit_1.stripIndents) `The project ${context.projectName} is using the 'generatePackageJson' option which is deprecated for library projects. It should only be used for applications.
-        For libraries, configure the project to use the '@nx/dependency-checks' ESLint rule instead (https://nx.dev/nx-api/eslint-plugin/documents/dependency-checks).`);
-    }
-    const configs = await getWebpackConfigs(options, context);
-    return yield* (0, internal_1.eachValueFrom)((0, rxjs_1.of)(configs).pipe((0, operators_1.mergeMap)((config) => (Array.isArray(config) ? (0, rxjs_1.from)(config) : (0, rxjs_1.of)(config))), 
-    // Run build sequentially and bail when first one fails.
-    (0, operators_1.mergeScan)((acc, config) => {
-        if (!acc.hasErrors()) {
-            // Propagate watch mode from executor options to webpack config.
-            // Without this, NxAppWebpackPlugin-based configs run in single-run
-            // mode even when the executor is invoked with watch: true, causing
-            // @nx/js:node to restart the process after every build.
-            config.watch = options.watch ?? config.watch;
-            return (0, run_webpack_1.runWebpack)(config).pipe((0, operators_1.tap)((stats) => {
-                console.info(stats.toString(config.stats));
-            }));
-        }
-        else {
-            return (0, rxjs_1.of)();
-        }
-    }, { hasErrors: () => false }, 1), 
-    // Collect build results as an array.
-    (0, operators_1.bufferCount)(Array.isArray(configs) ? configs.length : 1), (0, operators_1.switchMap)(async (results) => {
-        const success = results.every((result) => Boolean(result) && !result.hasErrors());
-        // TODO(jack): This should read output from webpack config if provided.
-        // The outfile is only used by NestJS, where `@nx/js:node` executor requires it to run the file.
-        return {
-            success,
-            outfile: (0, path_1.resolve)(context.root, options.outputPath, options.outputFileName),
-            options,
-        };
-    })));
-}
-exports.default = webpackExecutor;

package/dist/src/utils/has-plugin.d.ts

@@ -1,2 +0,0 @@
-import { Tree } from '@nx/devkit';
-export declare function hasPlugin(tree: Tree): boolean;

package/dist/src/utils/has-plugin.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasPlugin = hasPlugin;
-const devkit_1 = require("@nx/devkit");
-function hasPlugin(tree) {
-    const nxJson = (0, devkit_1.readNxJson)(tree);
-    return !!nxJson.plugins?.some((p) => typeof p === 'string'
-        ? p === '@nx/webpack/plugin'
-        : p.plugin === '@nx/webpack/plugin');
-}