@nx/web 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 [Web plugin for Nx](https://nx.dev/packages/web).
+
+## 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/babel.d.ts

@@ -0,0 +1 @@
+declare const nxJsBabelPreset: any;

package/babel.js

@@ -0,0 +1,6 @@
+const nxJsBabelPreset = require('@nx/js/babel');
+/** @deprecated Use `@nx/js/babel`. */
+module.exports = function (api, options = {}) {
+    console.warn('`@nx/web/babel` has been deprecated. Use `@nx/js/babel` instead in your .babelrc files.');
+    return nxJsBabelPreset(api, options);
+};

package/executors.json

@@ -0,0 +1,16 @@
+{
+  "builders": {
+    "file-server": {
+      "implementation": "./src/executors/file-server/compat",
+      "schema": "./src/executors/file-server/schema.json",
+      "description": "Serve a web application from a folder."
+    }
+  },
+  "executors": {
+    "file-server": {
+      "implementation": "./src/executors/file-server/file-server.impl",
+      "schema": "./src/executors/file-server/schema.json",
+      "description": "Serve a web application from a folder."
+    }
+  }
+}

package/generators.json

@@ -0,0 +1,25 @@
+{
+  "name": "nx/web",
+  "version": "0.1",
+  "extends": ["@nx/workspace"],
+  "generators": {
+    "init": {
+      "factory": "./src/generators/init/init#webInitGenerator",
+      "schema": "./src/generators/init/schema.json",
+      "description": "Add `@nrwl/web` to a project.",
+      "hidden": true
+    },
+    "application": {
+      "factory": "./src/generators/application/application#applicationGeneratorInternal",
+      "schema": "./src/generators/application/schema.json",
+      "aliases": ["app"],
+      "x-type": "application",
+      "description": "Create an web application."
+    },
+    "static-config": {
+      "factory": "./src/generators/static-serve/static-serve-configuration",
+      "schema": "./src/generators/static-serve/schema.json",
+      "description": "Add a new static-serve target to a project."
+    }
+  }
+}

package/index.d.ts

@@ -0,0 +1,3 @@
+export { webInitGenerator } from './src/generators/init/init';
+export { applicationGenerator } from './src/generators/application/application';
+export { webStaticServeGenerator } from './src/generators/static-serve/static-serve-configuration';

package/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webStaticServeGenerator = exports.applicationGenerator = exports.webInitGenerator = void 0;
+var init_1 = require("./src/generators/init/init");
+Object.defineProperty(exports, "webInitGenerator", { enumerable: true, get: function () { return init_1.webInitGenerator; } });
+var application_1 = require("./src/generators/application/application");
+Object.defineProperty(exports, "applicationGenerator", { enumerable: true, get: function () { return application_1.applicationGenerator; } });
+var static_serve_configuration_1 = require("./src/generators/static-serve/static-serve-configuration");
+Object.defineProperty(exports, "webStaticServeGenerator", { enumerable: true, get: function () { return static_serve_configuration_1.webStaticServeGenerator; } });

package/migrations.json

@@ -0,0 +1,51 @@
+{
+  "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"
+    },
+    "update-rollup-executor": {
+      "cli": "nx",
+      "version": "15.0.0-beta.1",
+      "description": "Update usages of rollup executors to @nrwl/rollup",
+      "factory": "./src/migrations/update-15-0-0/update-rollup-executor"
+    },
+    "update-babel-preset": {
+      "cli": "nx",
+      "version": "15.5.4-beta.0",
+      "description": "Update `@nrwl/web/babel` preset to `@nrwl/js/babel` for projects that have a .babelrc file.",
+      "factory": "./src/migrations/update-15-5-4/update-babel-preset"
+    },
+    "add-dropped-dependencies": {
+      "cli": "nx",
+      "version": "15.9.1",
+      "description": "Add @nrwl/linter, @nrwl/cypress, @nrwl/jest, @nrwl/rollup if they are used",
+      "factory": "./src/migrations/update-15-9-1/add-dropped-dependencies"
+    },
+    "update-16-0-0-add-nx-packages": {
+      "cli": "nx",
+      "version": "16.0.0-beta.1",
+      "description": "Replace @nrwl/web with @nx/web",
+      "implementation": "./src/migrations/update-16-0-0-add-nx-packages/update-16-0-0-add-nx-packages"
+    },
+    "update-16-0-0-update-executors": {
+      "cli": "nx",
+      "version": "16.0.0-beta.4",
+      "description": "Replace @nrwl/web executors with @nx/webpack and @nx/rollup",
+      "implementation": "./src/migrations/update-16-0-0-update-executors/update-16-0-0-update-executors"
+    }
+  },
+  "packageJsonUpdates": {
+    "17.3.0": {
+      "version": "17.3.0-beta.3",
+      "packages": {
+        "@types/node": {
+          "version": "18.16.9",
+          "alwaysAddToPackageJson": false
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@nx/web",
+  "version": "0.0.0-pr-22179-271588f",
+  "private": false,
+  "description": "The Nx Plugin for Web Components contains generators for managing Web Component applications and libraries within an Nx workspace. It provides:\n\n\n- Integration with libraries such as Jest, Cypress, and Storybook.\n\n- Scaffolding for creating buildable libraries that can be published to npm.\n\n- Utilities for automatic workspace refactoring.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nrwl/nx.git",
+    "directory": "packages/web"
+  },
+  "keywords": [
+    "Monorepo",
+    "Web",
+    "Jest",
+    "Cypress",
+    "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": {
+    "chalk": "^4.1.0",
+    "detect-port": "^1.5.1",
+    "http-server": "^14.1.0",
+    "tslib": "^2.3.0",
+    "@nx/devkit": "0.0.0-pr-22179-271588f",
+    "@nx/js": "0.0.0-pr-22179-271588f",
+    "@nrwl/web": "0.0.0-pr-22179-271588f"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "commonjs"
+}

package/src/executors/file-server/compat.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;

package/src/executors/file-server/compat.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const devkit_1 = require("@nx/devkit");
+const file_server_impl_1 = require("./file-server.impl");
+exports.default = (0, devkit_1.convertNxExecutor)(file_server_impl_1.default);

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

@@ -0,0 +1,8 @@
+import { ExecutorContext } from '@nx/devkit';
+import { Schema } from './schema';
+export default function fileServerExecutor(options: Schema, context: ExecutorContext): AsyncGenerator<{
+    success: boolean;
+    baseUrl: string;
+}, {
+    success: boolean;
+}, unknown>;

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

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const chalk = require("chalk");
+const devkit_1 = require("@nx/devkit");
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const package_json_1 = require("nx/src/utils/package-json");
+const detectPort = require("detect-port");
+const client_1 = require("nx/src/daemon/client/client");
+const utils_1 = require("nx/src/tasks-runner/utils");
+// platform specific command name
+const pmCmd = (0, os_1.platform)() === 'win32' ? `npx.cmd` : 'npx';
+function getHttpServerArgs(options) {
+    const args = [`-c${options.cacheSeconds}`];
+    if (options.cors) {
+        args.push(`--cors`);
+    }
+    if (options.host) {
+        args.push(`-a=${options.host}`);
+    }
+    if (options.ssl) {
+        args.push(`-S`);
+    }
+    if (options.sslCert) {
+        args.push(`-C=${options.sslCert}`);
+    }
+    if (options.sslKey) {
+        args.push(`-K=${options.sslKey}`);
+    }
+    if (options.proxyUrl) {
+        args.push(`-P=${options.proxyUrl}`);
+    }
+    if (options.gzip) {
+        args.push('-g');
+    }
+    if (options.brotli) {
+        args.push('-b');
+    }
+    if (options.proxyOptions) {
+        Object.keys(options.proxyOptions).forEach((key) => {
+            args.push(`--proxy-options.${key}=${options.proxyOptions[key]}`);
+        });
+    }
+    return args;
+}
+function getBuildTargetCommand(options, context) {
+    const target = (0, devkit_1.parseTargetString)(options.buildTarget, context);
+    const cmd = ['nx', 'run'];
+    if (target.configuration) {
+        cmd.push(`${target.project}:${target.target}:${target.configuration}`);
+    }
+    else {
+        cmd.push(`${target.project}:${target.target}`);
+    }
+    if (options.parallel) {
+        cmd.push(`--parallel`);
+    }
+    if (options.maxParallel) {
+        cmd.push(`--maxParallel=${options.maxParallel}`);
+    }
+    return cmd;
+}
+function getBuildTargetOutputPath(options, context) {
+    if (options.staticFilePath) {
+        return options.staticFilePath;
+    }
+    let outputPath;
+    try {
+        const target = (0, devkit_1.parseTargetString)(options.buildTarget, context);
+        const buildOptions = (0, devkit_1.readTargetOptions)(target, context);
+        if (buildOptions?.outputPath) {
+            outputPath = buildOptions.outputPath;
+        }
+        else {
+            const project = context.projectGraph.nodes[context.projectName];
+            const buildTarget = project.data.targets[target.target];
+            outputPath = buildTarget.outputs?.[0];
+            if (outputPath)
+                outputPath = (0, utils_1.interpolate)(outputPath, {
+                    projectName: project.data.name,
+                    projectRoot: project.data.root,
+                });
+        }
+    }
+    catch (e) {
+        throw new Error(`Invalid buildTarget: ${options.buildTarget}`);
+    }
+    if (!outputPath) {
+        throw new Error(`Unable to get the outputPath from buildTarget ${options.buildTarget}. Make sure ${options.buildTarget} has an outputPath property or manually provide an staticFilePath property`);
+    }
+    return outputPath;
+}
+function createFileWatcher(project, changeHandler) {
+    return client_1.daemonClient.registerFileWatcher({
+        watchProjects: project ? [project] : 'all',
+        includeGlobalWorkspaceFiles: true,
+        includeDependentProjects: true,
+    }, async (error, val) => {
+        if (error === 'closed') {
+            throw new Error('Watch error: Daemon closed the connection');
+        }
+        else if (error) {
+            throw new Error(`Watch error: ${error?.message ?? 'Unknown'}`);
+        }
+        else if (val?.changedFiles.length > 0) {
+            changeHandler();
+        }
+    });
+}
+async function* fileServerExecutor(options, context) {
+    if (!options.buildTarget && !options.staticFilePath) {
+        throw new Error("You must set either 'buildTarget' or 'staticFilePath'.");
+    }
+    if (options.watch && !options.buildTarget) {
+        throw new Error("Watch error: You can only specify 'watch' when 'buildTarget' is set.");
+    }
+    let running = false;
+    let disposeWatch;
+    if (options.buildTarget) {
+        const run = () => {
+            if (!running) {
+                running = true;
+                /**
+                 * Expose a variable to the build target to know if it's being run by the serve-static executor
+                 * This is useful because a config might need to change if it's being run by serve-static without the user's input
+                 * or if being ran by another executor (eg. E2E tests)
+                 * */
+                process.env.NX_SERVE_STATIC_BUILD_RUNNING = 'true';
+                try {
+                    const args = getBuildTargetCommand(options, context);
+                    (0, child_process_1.execFileSync)(pmCmd, args, {
+                        stdio: [0, 1, 2],
+                    });
+                }
+                catch {
+                    throw new Error(`Build target failed: ${chalk.bold(options.buildTarget)}`);
+                }
+                finally {
+                    process.env.NX_SERVE_STATIC_BUILD_RUNNING = undefined;
+                    running = false;
+                }
+            }
+        };
+        if (options.watch) {
+            const projectRoot = context.projectsConfigurations.projects[context.projectName].root;
+            disposeWatch = await createFileWatcher(context.projectName, run);
+        }
+        // perform initial run
+        run();
+    }
+    const outputPath = getBuildTargetOutputPath(options, context);
+    if (options.spa) {
+        const src = (0, path_1.join)(outputPath, 'index.html');
+        const dst = (0, path_1.join)(outputPath, '404.html');
+        // See: https://github.com/http-party/http-server#magic-files
+        (0, fs_1.copyFileSync)(src, dst);
+    }
+    const args = getHttpServerArgs(options);
+    const { path: pathToHttpServerPkgJson, packageJson } = (0, package_json_1.readModulePackageJson)('http-server', module.paths);
+    const pathToHttpServerBin = packageJson.bin['http-server'];
+    const pathToHttpServer = (0, path_1.resolve)(pathToHttpServerPkgJson.replace('package.json', ''), pathToHttpServerBin);
+    // detect port as close to when used to prevent port being used by another process
+    // when running in  parallel
+    const port = await detectPort(options.port || 8080);
+    args.push(`-p=${port}`);
+    const serve = (0, child_process_1.fork)(pathToHttpServer, [outputPath, ...args], {
+        stdio: 'pipe',
+        cwd: context.root,
+        env: {
+            FORCE_COLOR: 'true',
+            ...process.env,
+        },
+    });
+    const processExitListener = () => {
+        serve.kill();
+        if (disposeWatch) {
+            disposeWatch();
+        }
+        if (options.spa) {
+            (0, fs_1.unlinkSync)((0, path_1.join)(outputPath, '404.html'));
+        }
+    };
+    process.on('exit', processExitListener);
+    process.on('SIGTERM', processExitListener);
+    serve.stdout.on('data', (chunk) => {
+        if (chunk.toString().indexOf('GET') === -1) {
+            process.stdout.write(chunk);
+        }
+    });
+    serve.stderr.on('data', (chunk) => {
+        process.stderr.write(chunk);
+    });
+    yield {
+        success: true,
+        baseUrl: `${options.ssl ? 'https' : 'http'}://${options.host}:${port}`,
+    };
+    return new Promise((res) => {
+        serve.on('exit', (code) => {
+            if (code == 0) {
+                res({ success: true });
+            }
+            else {
+                res({ success: false });
+            }
+        });
+    });
+}
+exports.default = fileServerExecutor;

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

@@ -0,0 +1,20 @@
+export interface Schema {
+  host?: string;
+  port?: number;
+  ssl?: boolean;
+  sslKey?: string;
+  sslCert?: string;
+  proxyUrl?: string;
+  buildTarget?: string;
+  parallel: boolean;
+  maxParallel?: number;
+  withDeps: boolean;
+  proxyOptions?: object;
+  watch?: boolean;
+  spa: boolean;
+  staticFilePath?: string;
+  cors?: boolean;
+  gzip?: boolean;
+  brotli?: boolean;
+  cacheSeconds?: number;
+}

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

@@ -0,0 +1,98 @@
+{
+  "version": 2,
+  "outputCapture": "direct-nodejs",
+  "title": "File Server",
+  "description": "Serve a web application from a folder.",
+  "type": "object",
+  "cli": "nx",
+  "properties": {
+    "buildTarget": {
+      "type": "string",
+      "description": "Target which builds the application."
+    },
+    "parallel": {
+      "type": "boolean",
+      "description": "Build the target in parallel.",
+      "default": true
+    },
+    "maxParallel": {
+      "type": "number",
+      "description": "Max number of parallel jobs."
+    },
+    "port": {
+      "type": "number",
+      "description": "Port to listen on.",
+      "default": 4200
+    },
+    "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`."
+    },
+    "proxyUrl": {
+      "type": "string",
+      "description": "URL to proxy unhandled requests to."
+    },
+    "proxyOptions": {
+      "type": "object",
+      "description": "Options for the proxy used by `http-server`.",
+      "default": {},
+      "properties": {
+        "secure": {
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "additionalProperties": true
+    },
+    "watch": {
+      "type": "boolean",
+      "description": "Watch for file changes.",
+      "default": true
+    },
+    "spa": {
+      "type": "boolean",
+      "description": "Redirect 404 errors to index.html (useful for SPA's)",
+      "default": false,
+      "x-priority": "important"
+    },
+    "staticFilePath": {
+      "type": "string",
+      "description": "Path where the build artifacts are located. If not provided then it will be infered from the buildTarget executor options as outputPath"
+    },
+    "cors": {
+      "type": "boolean",
+      "description": "Enable CORS",
+      "default": true
+    },
+    "gzip": {
+      "type": "boolean",
+      "description": "Enable gzip compression",
+      "default": false
+    },
+    "brotli": {
+      "type": "boolean",
+      "description": "Enable brotli compression",
+      "default": false
+    },
+    "cacheSeconds": {
+      "type": "number",
+      "description": "Set cache time (in seconds) for cache-control max-age header. To disable caching, use -1. Caching defaults to disabled.",
+      "default": -1
+    }
+  },
+  "additionalProperties": false
+}

package/src/generators/application/application.d.ts

@@ -0,0 +1,5 @@
+import { GeneratorCallback, Tree } from '@nx/devkit';
+import { Schema } from './schema';
+export declare function applicationGenerator(host: Tree, schema: Schema): Promise<GeneratorCallback>;
+export declare function applicationGeneratorInternal(host: Tree, schema: Schema): Promise<GeneratorCallback>;
+export default applicationGenerator;