@nx/angular 17.0.4 → 17.0.6

package/src/utils/{index.d.ts → public-api.d.ts}

@@ -1,7 +1,2 @@
-/**
- * Note to developers: STOP! These exports end up as the public API of @nx/angular/src/utils.
- *
- * Try hard to not add to this API to reduce the surface area we need to maintain.
- */
 export { isStandalone, addImportToComponent, addImportToDirective, addImportToPipe, addImportToModule, addProviderToBootstrapApplication, addProviderToAppConfig, addProviderToComponent, addProviderToModule, } from './nx-devkit/ast-utils';
 export { addRoute, addProviderToRoute } from './nx-devkit/route-utils';

package/src/utils/{index.js → public-api.js}

@@ -1,9 +1,4 @@
 "use strict";
-/**
- * Note to developers: STOP! These exports end up as the public API of @nx/angular/src/utils.
- *
- * Try hard to not add to this API to reduce the surface area we need to maintain.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addProviderToRoute = exports.addRoute = exports.addProviderToModule = exports.addProviderToComponent = exports.addProviderToAppConfig = exports.addProviderToBootstrapApplication = exports.addImportToModule = exports.addImportToPipe = exports.addImportToDirective = exports.addImportToComponent = exports.isStandalone = void 0;
 var ast_utils_1 = require("./nx-devkit/ast-utils");

package/src/utils/version-utils.d.ts

@@ -1,3 +1,3 @@
-import type { CompatPackageVersionNames, LatestPackageVersionNames, PackageCompatVersions, PackageLatestVersions } from './backward-compatible-versions';
-export declare function getPkgVersionForAngularMajorVersion(pkgVersionName: LatestPackageVersionNames | CompatPackageVersionNames, angularMajorVersion: number): string;
-export declare function getPkgVersionsForAngularMajorVersion(angularMajorVersion: number): PackageLatestVersions | PackageCompatVersions;
+import type { PackageVersionNames, PackageVersions } from './backward-compatible-versions';
+export declare function getPkgVersionForAngularMajorVersion(pkgVersionName: PackageVersionNames, angularMajorVersion: number): string;
+export declare function getPkgVersionsForAngularMajorVersion(angularMajorVersion: number): PackageVersions;

package/src/utils/versions.d.ts

@@ -1,25 +1,27 @@
 export declare const nxVersion: any;
-export declare const angularVersion = "~17.3.0";
-export declare const angularDevkitVersion = "~17.3.0";
-export declare const ngPackagrVersion = "~17.3.0";
-export declare const ngrxVersion = "~17.0.0";
+export declare const angularVersion = "~16.2.0";
+export declare const angularDevkitVersion = "~16.2.0";
+export declare const ngPackagrVersion = "~16.2.0";
+export declare const ngrxVersion = "~16.0.0";
 export declare const rxjsVersion = "~7.8.0";
-export declare const zoneJsVersion = "~0.14.3";
+export declare const zoneJsVersion = "~0.13.0";
 export declare const angularJsVersion = "1.7.9";
 export declare const tsLibVersion = "^2.3.0";
+export declare const ngUniversalVersion = "~16.2.0";
 export declare const corsVersion = "~2.8.5";
 export declare const typesCorsVersion = "~2.8.5";
 export declare const expressVersion = "~4.18.2";
 export declare const typesExpressVersion = "4.17.14";
-export declare const browserSyncVersion = "^3.0.0";
 export declare const moduleFederationNodeVersion = "~1.0.5";
-export declare const angularEslintVersion = "~17.3.0";
+export declare const angularEslintVersion = "~16.0.0";
 export declare const tailwindVersion = "^3.0.2";
 export declare const postcssVersion = "^8.4.5";
+export declare const postcssImportVersion = "~14.1.0";
+export declare const postcssPresetEnvVersion = "~7.5.0";
 export declare const postcssUrlVersion = "~10.1.3";
 export declare const autoprefixerVersion = "^10.4.0";
 export declare const tsNodeVersion = "10.9.1";
-export declare const jestPresetAngularVersion = "~14.0.3";
-export declare const typesNodeVersion = "18.16.9";
+export declare const jestPresetAngularVersion = "~13.1.0";
+export declare const typesNodeVersion = "16.11.7";
 export declare const jasmineMarblesVersion = "^0.9.2";
 export declare const jsoncEslintParserVersion = "^2.1.0";

package/src/utils/versions.js

@@ -1,28 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.jsoncEslintParserVersion = exports.jasmineMarblesVersion = exports.typesNodeVersion = exports.jestPresetAngularVersion = exports.tsNodeVersion = exports.autoprefixerVersion = exports.postcssUrlVersion = exports.postcssVersion = exports.tailwindVersion = exports.angularEslintVersion = exports.moduleFederationNodeVersion = exports.browserSyncVersion = exports.typesExpressVersion = exports.expressVersion = exports.typesCorsVersion = exports.corsVersion = exports.tsLibVersion = exports.angularJsVersion = exports.zoneJsVersion = exports.rxjsVersion = exports.ngrxVersion = exports.ngPackagrVersion = exports.angularDevkitVersion = exports.angularVersion = exports.nxVersion = void 0;
+exports.jsoncEslintParserVersion = exports.jasmineMarblesVersion = exports.typesNodeVersion = exports.jestPresetAngularVersion = exports.tsNodeVersion = exports.autoprefixerVersion = exports.postcssUrlVersion = exports.postcssPresetEnvVersion = exports.postcssImportVersion = exports.postcssVersion = exports.tailwindVersion = exports.angularEslintVersion = exports.moduleFederationNodeVersion = exports.typesExpressVersion = exports.expressVersion = exports.typesCorsVersion = exports.corsVersion = exports.ngUniversalVersion = exports.tsLibVersion = exports.angularJsVersion = exports.zoneJsVersion = exports.rxjsVersion = exports.ngrxVersion = exports.ngPackagrVersion = exports.angularDevkitVersion = exports.angularVersion = exports.nxVersion = void 0;
 exports.nxVersion = require('../../package.json').version;
-exports.angularVersion = '~17.3.0';
-exports.angularDevkitVersion = '~17.3.0';
-exports.ngPackagrVersion = '~17.3.0';
-exports.ngrxVersion = '~17.0.0';
+exports.angularVersion = '~16.2.0';
+exports.angularDevkitVersion = '~16.2.0';
+exports.ngPackagrVersion = '~16.2.0';
+exports.ngrxVersion = '~16.0.0';
 exports.rxjsVersion = '~7.8.0';
-exports.zoneJsVersion = '~0.14.3';
+exports.zoneJsVersion = '~0.13.0';
 exports.angularJsVersion = '1.7.9';
 exports.tsLibVersion = '^2.3.0';
+exports.ngUniversalVersion = '~16.2.0';
 exports.corsVersion = '~2.8.5';
 exports.typesCorsVersion = '~2.8.5';
 exports.expressVersion = '~4.18.2';
 exports.typesExpressVersion = '4.17.14';
-exports.browserSyncVersion = '^3.0.0';
 exports.moduleFederationNodeVersion = '~1.0.5';
-exports.angularEslintVersion = '~17.3.0';
+exports.angularEslintVersion = '~16.0.0';
 exports.tailwindVersion = '^3.0.2';
 exports.postcssVersion = '^8.4.5';
+exports.postcssImportVersion = '~14.1.0';
+exports.postcssPresetEnvVersion = '~7.5.0';
 exports.postcssUrlVersion = '~10.1.3';
 exports.autoprefixerVersion = '^10.4.0';
 exports.tsNodeVersion = '10.9.1';
-exports.jestPresetAngularVersion = '~14.0.3';
-exports.typesNodeVersion = '18.16.9';
+exports.jestPresetAngularVersion = '~13.1.0';
+exports.typesNodeVersion = '16.11.7';
 exports.jasmineMarblesVersion = '^0.9.2';
 exports.jsoncEslintParserVersion = '^2.1.0';

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

@@ -1,4 +0,0 @@
-import type { Schema } from './schema';
-export declare function executeDevServerBuilder(rawOptions: Schema, context: import('@angular-devkit/architect').BuilderContext): import("rxjs").Observable<import("@angular-devkit/build-angular").DevServerBuilderOutput>;
-declare const _default: any;
-export default _default;

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

@@ -1,160 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeDevServerBuilder = void 0;
-const devkit_1 = require("@nx/devkit");
-const js_1 = require("@nx/js");
-const webpack_nx_build_coordination_plugin_1 = require("@nx/webpack/src/plugins/webpack-nx-build-coordination-plugin");
-const fs_1 = require("fs");
-const operators_1 = require("nx/src/project-graph/operators");
-const project_graph_1 = require("nx/src/project-graph/project-graph");
-const path_1 = require("path");
-const rxjs_1 = require("rxjs");
-const operators_2 = require("rxjs/operators");
-const angular_version_utils_1 = require("../../executors/utilities/angular-version-utils");
-const esbuild_extensions_1 = require("../../executors/utilities/esbuild-extensions");
-const patch_builder_context_1 = require("../../executors/utilities/patch-builder-context");
-const buildable_libs_1 = require("../utilities/buildable-libs");
-const webpack_1 = require("../utilities/webpack");
-const lib_1 = require("./lib");
-function executeDevServerBuilder(rawOptions, context) {
-    (0, lib_1.validateOptions)(rawOptions);
-    process.env.NX_TSCONFIG_PATH = (0, js_1.getRootTsConfigPath)();
-    const options = (0, lib_1.normalizeOptions)(rawOptions);
-    const parsedBuildTarget = (0, devkit_1.parseTargetString)(options.buildTarget, {
-        cwd: context.currentDirectory,
-        projectGraph: (0, devkit_1.readCachedProjectGraph)(),
-        projectName: context.target.project,
-        root: context.workspaceRoot,
-        isVerbose: false,
-    });
-    const browserTargetProjectConfiguration = (0, project_graph_1.readCachedProjectConfiguration)(parsedBuildTarget.project);
-    const buildTarget = browserTargetProjectConfiguration.targets[parsedBuildTarget.target];
-    const buildTargetOptions = {
-        ...buildTarget.options,
-        ...(parsedBuildTarget.configuration
-            ? buildTarget.configurations[parsedBuildTarget.configuration]
-            : buildTarget.defaultConfiguration
-                ? buildTarget.configurations[buildTarget.defaultConfiguration]
-                : {}),
-    };
-    const buildLibsFromSource = options.buildLibsFromSource ??
-        buildTargetOptions.buildLibsFromSource ??
-        true;
-    process.env.NX_BUILD_LIBS_FROM_SOURCE = `${buildLibsFromSource}`;
-    process.env.NX_BUILD_TARGET = options.buildTarget;
-    let pathToWebpackConfig;
-    if (buildTargetOptions.customWebpackConfig?.path) {
-        pathToWebpackConfig = (0, devkit_1.joinPathFragments)(context.workspaceRoot, buildTargetOptions.customWebpackConfig.path);
-        if (pathToWebpackConfig && !(0, fs_1.existsSync)(pathToWebpackConfig)) {
-            throw new Error(`Custom Webpack Config File Not Found!\nTo use a custom webpack config, please ensure the path to the custom webpack file is correct: \n${pathToWebpackConfig}`);
-        }
-    }
-    const normalizedIndexHtmlTransformer = buildTargetOptions.indexHtmlTransformer ??
-        buildTargetOptions.indexFileTransformer;
-    let pathToIndexFileTransformer;
-    if (normalizedIndexHtmlTransformer) {
-        pathToIndexFileTransformer = (0, devkit_1.joinPathFragments)(context.workspaceRoot, normalizedIndexHtmlTransformer);
-        if (pathToIndexFileTransformer && !(0, fs_1.existsSync)(pathToIndexFileTransformer)) {
-            throw new Error(`File containing Index File Transformer function Not Found!\n Please ensure the path to the file containing the function is correct: \n${pathToIndexFileTransformer}`);
-        }
-    }
-    let dependencies;
-    if (!buildLibsFromSource) {
-        const { tsConfigPath, dependencies: foundDependencies } = (0, buildable_libs_1.createTmpTsConfigForBuildableLibs)(buildTargetOptions.tsConfig, context, {
-            target: parsedBuildTarget.target,
-        });
-        dependencies = foundDependencies;
-        const relativeTsConfigPath = (0, devkit_1.normalizePath)((0, path_1.relative)(context.workspaceRoot, tsConfigPath));
-        // We can't just pass the tsconfig path in memory to the angular builder
-        // function because we can't pass the build target options to it, the build
-        // targets options will be retrieved by the builder from the project
-        // configuration. Therefore, we patch the method in the context to retrieve
-        // the target options to overwrite the tsconfig path to use the generated
-        // one with the updated path mappings.
-        const originalGetTargetOptions = context.getTargetOptions;
-        context.getTargetOptions = async (target) => {
-            const options = await originalGetTargetOptions(target);
-            options.tsConfig = relativeTsConfigPath;
-            return options;
-        };
-        // The buildTargetConfiguration also needs to use the generated tsconfig path
-        // otherwise the build will fail if customWebpack function/file is referencing
-        // local libs. This synchronize the behavior with webpack-browser and
-        // webpack-server implementation.
-        buildTargetOptions.tsConfig = relativeTsConfigPath;
-    }
-    const delegateBuilderOptions = getDelegateBuilderOptions(options);
-    const isUsingWebpackBuilder = ![
-        '@angular-devkit/build-angular:application',
-        '@angular-devkit/build-angular:browser-esbuild',
-        '@nx/angular:application',
-        '@nx/angular:browser-esbuild',
-    ].includes(buildTarget.executor);
-    /**
-     * The Angular CLI dev-server builder make some decisions based on the build
-     * target builder but it only considers `@angular-devkit/build-angular:*`
-     * builders. Since we are using a custom builder, we patch the context to
-     * handle `@nx/angular:*` executors.
-     */
-    (0, patch_builder_context_1.patchBuilderContext)(context, !isUsingWebpackBuilder, parsedBuildTarget);
-    return (0, rxjs_1.combineLatest)([
-        (0, rxjs_1.from)(Promise.resolve().then(() => require('@angular-devkit/build-angular'))),
-        (0, rxjs_1.from)((0, esbuild_extensions_1.loadPlugins)(buildTargetOptions.plugins, buildTargetOptions.tsConfig)),
-        (0, rxjs_1.from)((0, esbuild_extensions_1.loadMiddleware)(options.esbuildMiddleware, buildTargetOptions.tsConfig)),
-        (0, rxjs_1.from)(loadIndexHtmlFileTransformer(pathToIndexFileTransformer, buildTargetOptions.tsConfig, context, isUsingWebpackBuilder)),
-    ]).pipe((0, operators_2.switchMap)(([{ executeDevServerBuilder }, plugins, middleware, indexHtmlTransformer,]) => executeDevServerBuilder(delegateBuilderOptions, context, {
-        webpackConfiguration: isUsingWebpackBuilder
-            ? async (baseWebpackConfig) => {
-                if (!buildLibsFromSource) {
-                    const workspaceDependencies = dependencies
-                        .filter((dep) => !(0, operators_1.isNpmProject)(dep.node))
-                        .map((dep) => dep.node.name);
-                    // default for `nx run-many` is --all projects
-                    // by passing an empty string for --projects, run-many will default to
-                    // run the target for all projects.
-                    // This will occur when workspaceDependencies = []
-                    if (workspaceDependencies.length > 0) {
-                        baseWebpackConfig.plugins.push(
-                        // @ts-expect-error - difference between angular and webpack plugin definitions bc of webpack versions
-                        new webpack_nx_build_coordination_plugin_1.WebpackNxBuildCoordinationPlugin(`nx run-many --target=${parsedBuildTarget.target} --projects=${workspaceDependencies.join(',')}`));
-                    }
-                }
-                if (!pathToWebpackConfig) {
-                    return baseWebpackConfig;
-                }
-                return (0, webpack_1.mergeCustomWebpackConfig)(baseWebpackConfig, pathToWebpackConfig, buildTargetOptions, context.target);
-            }
-            : undefined,
-        ...(indexHtmlTransformer
-            ? {
-                indexHtml: indexHtmlTransformer,
-            }
-            : {}),
-    }, {
-        buildPlugins: plugins,
-        middleware,
-    })));
-}
-exports.executeDevServerBuilder = executeDevServerBuilder;
-exports.default = require('@angular-devkit/architect').createBuilder(executeDevServerBuilder);
-function getDelegateBuilderOptions(options) {
-    const delegateBuilderOptions = {
-        ...options,
-    };
-    const { major: angularMajorVersion } = (0, angular_version_utils_1.getInstalledAngularVersionInfo)();
-    if (angularMajorVersion <= 17) {
-        delegateBuilderOptions.browserTarget = delegateBuilderOptions.buildTarget;
-        delete delegateBuilderOptions.buildTarget;
-    }
-    // delete extra option not supported by the delegate builder
-    delete delegateBuilderOptions.buildLibsFromSource;
-    return delegateBuilderOptions;
-}
-async function loadIndexHtmlFileTransformer(pathToIndexFileTransformer, tsConfig, context, isUsingWebpackBuilder) {
-    if (!pathToIndexFileTransformer) {
-        return undefined;
-    }
-    return isUsingWebpackBuilder
-        ? (0, webpack_1.resolveIndexHtmlTransformer)(pathToIndexFileTransformer, tsConfig, context.target)
-        : await (0, esbuild_extensions_1.loadIndexHtmlTransformer)(pathToIndexFileTransformer, tsConfig);
-}

package/src/builders/dev-server/lib/normalize-options.d.ts

@@ -1,2 +0,0 @@
-import type { NormalizedSchema, Schema } from '../schema';
-export declare function normalizeOptions(schema: Schema): NormalizedSchema;

package/src/builders/dev-server/lib/normalize-options.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeOptions = void 0;
-function normalizeOptions(schema) {
-    let buildTarget = schema.buildTarget;
-    if (schema.browserTarget) {
-        buildTarget ??= schema.browserTarget;
-        delete schema.browserTarget;
-    }
-    return {
-        ...schema,
-        buildTarget,
-        host: schema.host ?? 'localhost',
-        port: schema.port ?? 4200,
-        liveReload: schema.liveReload ?? true,
-        open: schema.open ?? false,
-        ssl: schema.ssl ?? false,
-    };
-}
-exports.normalizeOptions = normalizeOptions;

package/src/builders/dev-server/lib/validate-options.d.ts

@@ -1,2 +0,0 @@
-import type { Schema } from '../schema';
-export declare function validateOptions(options: Schema): void;

package/src/builders/dev-server/lib/validate-options.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateOptions = void 0;
-const devkit_1 = require("@nx/devkit");
-const semver_1 = require("semver");
-const angular_version_utils_1 = require("../../../executors/utilities/angular-version-utils");
-function validateOptions(options) {
-    const { major: angularMajorVersion, version: angularVersion } = (0, angular_version_utils_1.getInstalledAngularVersionInfo)();
-    if ((0, semver_1.lt)(angularVersion, '16.1.0') && options.forceEsbuild) {
-        throw new Error((0, devkit_1.stripIndents) `The "forceEsbuild" option is only supported in Angular >= 16.1.0. You are currently using "${angularVersion}".
-      You can resolve this error by removing the "forceEsbuild" option or by migrating to Angular 16.1.0.`);
-    }
-    if (angularMajorVersion < 17 && options.esbuildMiddleware?.length > 0) {
-        throw new Error((0, devkit_1.stripIndents) `The "esbuildMiddleware" option is only supported in Angular >= 17.0.0. You are currently using "${angularVersion}".
-      You can resolve this error by removing the "esbuildMiddleware" option or by migrating to Angular 17.0.0.`);
-    }
-    if ((0, semver_1.lt)(angularVersion, '17.2.0') && options.prebundle) {
-        throw new Error((0, devkit_1.stripIndents) `The "prebundle" option is only supported in Angular >= 17.2.0. You are currently using "${angularVersion}".
-      You can resolve this error by removing the "prebundle" option or by migrating to Angular 17.2.0.`);
-    }
-}
-exports.validateOptions = validateOptions;

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

@@ -1,39 +0,0 @@
-interface BaseSchema {
-  port?: number;
-  host?: string;
-  proxyConfig?: string;
-  ssl?: boolean;
-  sslKey?: string;
-  sslCert?: string;
-  headers?: Record<string, string>;
-  open?: boolean;
-  verbose?: boolean;
-  liveReload?: boolean;
-  publicHost?: string;
-  allowedHosts?: string[];
-  servePath?: string;
-  disableHostCheck?: boolean;
-  hmr?: boolean;
-  watch?: boolean;
-  poll?: number;
-  forceEsbuild?: boolean;
-  prebundle?: boolean | { exclude: string[] };
-  buildLibsFromSource?: boolean;
-  esbuildMiddleware?: string[];
-}
-
-export type SchemaWithBrowserTarget = BaseSchema & {
-  browserTarget: string;
-};
-
-export type SchemaWithBuildTarget = BaseSchema & {
-  buildTarget: string;
-};
-
-export type Schema = SchemaWithBrowserTarget | SchemaWithBuildTarget;
-
-export type NormalizedSchema = SchemaWithBuildTarget & {
-  liveReload: boolean;
-  open: boolean;
-  ssl: boolean;
-};

package/src/executors/application/application.impl.d.ts

@@ -1,3 +0,0 @@
-import type { ExecutorContext } from '@nx/devkit';
-import type { ApplicationExecutorOptions } from './schema';
-export default function applicationExecutor(options: ApplicationExecutorOptions, context: ExecutorContext): AsyncGenerator<import("@angular-devkit/build-angular/src/builders/application").ApplicationBuilderOutput, any, undefined>;

package/src/executors/application/application.impl.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const ngcli_adapter_1 = require("nx/src/adapter/ngcli-adapter");
-const semver_1 = require("semver");
-const angular_version_utils_1 = require("../utilities/angular-version-utils");
-const buildable_libs_1 = require("../utilities/buildable-libs");
-const esbuild_extensions_1 = require("../utilities/esbuild-extensions");
-const validate_options_1 = require("./utils/validate-options");
-async function* applicationExecutor(options, context) {
-    (0, validate_options_1.validateOptions)(options);
-    const { buildLibsFromSource = true, plugins: pluginPaths, indexHtmlTransformer: indexHtmlTransformerPath, ...delegateExecutorOptions } = options;
-    let dependencies;
-    if (!buildLibsFromSource) {
-        const { tsConfigPath, dependencies: foundDependencies } = (0, buildable_libs_1.createTmpTsConfigForBuildableLibs)(delegateExecutorOptions.tsConfig, context);
-        dependencies = foundDependencies;
-        delegateExecutorOptions.tsConfig = tsConfigPath;
-    }
-    const plugins = await (0, esbuild_extensions_1.loadPlugins)(pluginPaths, options.tsConfig);
-    const indexHtmlTransformer = indexHtmlTransformerPath
-        ? await (0, esbuild_extensions_1.loadIndexHtmlTransformer)(indexHtmlTransformerPath, options.tsConfig)
-        : undefined;
-    const { buildApplication } = await Promise.resolve().then(() => require('@angular-devkit/build-angular'));
-    const builderContext = await (0, ngcli_adapter_1.createBuilderContext)({
-        builderName: 'application',
-        description: 'Build an application.',
-        optionSchema: await Promise.resolve().then(() => require('./schema.json')),
-    }, context);
-    const { version: angularVersion } = (0, angular_version_utils_1.getInstalledAngularVersionInfo)();
-    if ((0, semver_1.gte)(angularVersion, '17.1.0')) {
-        return yield* buildApplication(delegateExecutorOptions, builderContext, {
-            codePlugins: plugins,
-            indexHtmlTransformer,
-        });
-    }
-    return yield* buildApplication(delegateExecutorOptions, builderContext, plugins);
-}
-exports.default = applicationExecutor;

package/src/executors/application/schema.d.ts

@@ -1,8 +0,0 @@
-import type { ApplicationBuilderOptions } from '@angular-devkit/build-angular';
-import type { PluginSpec } from '../utilities/esbuild-extensions';
-
-export interface ApplicationExecutorOptions extends ApplicationBuilderOptions {
-  buildLibsFromSource?: boolean;
-  indexHtmlTransformer?: string;
-  plugins?: string[] | PluginSpec[];
-}