@nx/plugin 16.0.0-beta.5

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+
+
+**Note:** Version bump only for package @nx/plugin

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,67 @@
+<p style="text-align: center;"><img src="https://raw.githubusercontent.com/nrwl/nx/master/images/nx.png" width="600" alt="Nx - Smart, Fast and Extensible Build System"></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/@nrwl/workspace.svg?style=flat-square)]()
+[![NPM Version](https://badge.fury.io/js/%40nrwl%2Fworkspace.svg)](https://www.npmjs.com/@nrwl/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 @nrwl/community on slack](https://img.shields.io/badge/slack-%40nrwl%2Fcommunity-brightgreen)](https://join.slack.com/t/nrwlcommunity/shared_invite/enQtNzU5MTE4OTQwOTk0LTgxY2E0ZWYzMWE0YzA5ZDA2MWM1NDVhNmI2ZWMyYmZhNWJiODk3MjkxZjY3MzU5ZjRmM2NmNWU1OTgyZmE4Mzc)
+
+</div>
+
+
+<hr>
+
+# Nx: Smart, Fast and Extensible Build System
+
+Nx is a next generation build system with first class monorepo support and powerful integrations.
+
+## What is It?
+
+It's an Nx plugin used to build other Nx plugins.
+
+Check out the list of community plugins and the documentation on how to create one using `create-nx-plugin` here: [https://nx.dev/community](https://nx.dev/community)
+
+## 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, Fast and Extensible Build System"></a></p>
+

package/executors.json

@@ -0,0 +1,16 @@
+{
+  "builders": {
+    "e2e": {
+      "implementation": "./src/executors/e2e/compat",
+      "schema": "./src/executors/e2e/schema.json",
+      "description": "Creates and runs the E2E tests for an Nx Plugin."
+    }
+  },
+  "executors": {
+    "e2e": {
+      "implementation": "./src/executors/e2e/e2e.impl",
+      "schema": "./src/executors/e2e/schema.json",
+      "description": "Creates and runs the E2E tests for an Nx Plugin."
+    }
+  }
+}

package/generators.d.ts

@@ -0,0 +1,6 @@
+export * from './src/generators/create-package/create-package';
+export * from './src/generators/e2e-project/e2e';
+export * from './src/generators/executor/executor';
+export * from './src/generators/generator/generator';
+export * from './src/generators/plugin/plugin';
+export * from './src/generators/migration/migration';

package/generators.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./src/generators/create-package/create-package"), exports);
+tslib_1.__exportStar(require("./src/generators/e2e-project/e2e"), exports);
+tslib_1.__exportStar(require("./src/generators/executor/executor"), exports);
+tslib_1.__exportStar(require("./src/generators/generator/generator"), exports);
+tslib_1.__exportStar(require("./src/generators/plugin/plugin"), exports);
+tslib_1.__exportStar(require("./src/generators/migration/migration"), exports);
+//# sourceMappingURL=generators.js.map

package/generators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.js","sourceRoot":"","sources":["../../../packages/plugin/generators.ts"],"names":[],"mappings":";;;AAAA,yFAA+D;AAC/D,2EAAiD;AACjD,6EAAmD;AACnD,+EAAqD;AACrD,yEAA+C;AAC/C,+EAAqD"}

package/generators.json

@@ -0,0 +1,81 @@
+{
+  "name": "nx/plugin",
+  "version": "0.1",
+  "extends": ["@nx/workspace"],
+  "generators": {
+    "plugin": {
+      "factory": "./src/generators/plugin/plugin",
+      "schema": "./src/generators/plugin/schema.json",
+      "description": "Create a Nx Plugin."
+    },
+    "create-package": {
+      "factory": "./src/generators/create-package/create-package",
+      "schema": "./src/generators/create-package/schema.json",
+      "description": "Create a package which can be used by npx to create a new workspace"
+    },
+    "e2e-project": {
+      "factory": "./src/generators/e2e-project/e2e",
+      "schema": "./src/generators/e2e-project/schema.json",
+      "description": "Create a E2E application for a Nx Plugin."
+    },
+    "migration": {
+      "factory": "./src/generators/migration/migration",
+      "schema": "./src/generators/migration/schema.json",
+      "description": "Create a migration for an Nx Plugin."
+    },
+    "generator": {
+      "factory": "./src/generators/generator/generator",
+      "schema": "./src/generators/generator/schema.json",
+      "description": "Create a generator for an Nx Plugin."
+    },
+    "executor": {
+      "factory": "./src/generators/executor/executor",
+      "schema": "./src/generators/executor/schema.json",
+      "description": "Create an executor for an Nx Plugin."
+    },
+    "plugin-lint-checks": {
+      "factory": "./src/generators/lint-checks/generator",
+      "schema": "./src/generators/lint-checks/schema.json",
+      "description": "Adds linting configuration to validate common json files for nx plugins."
+    },
+    "preset": {
+      "factory": "./src/generators/preset/generator",
+      "schema": "./src/generators/preset/schema.json",
+      "description": "Initializes a workspace with an nx-plugin inside of it. Use as: `create-nx-workspace --preset @nrwl/nx-plugin`.",
+      "hidden": true,
+      "x-use-standalone-layout": true
+    }
+  },
+  "schematics": {
+    "plugin": {
+      "factory": "./src/generators/plugin/plugin#pluginSchematic",
+      "schema": "./src/generators/plugin/schema.json",
+      "description": "Create a Nx Plugin."
+    },
+    "create-package": {
+      "factory": "./src/generators/create-package/create-package#createPackageSchematic",
+      "schema": "./src/generators/create-package/schema.json",
+      "description": "Create a package which can be used by npx to create a new workspace"
+    },
+    "e2e-project": {
+      "factory": "./src/generators/e2e-project/e2e#e2eProjectSchematic",
+      "schema": "./src/generators/e2e-project/schema.json",
+      "description": "Create a E2E application for a Nx Plugin."
+    },
+    "migration": {
+      "factory": "./src/generators/migration/migration#migrationSchematic",
+      "schema": "./src/generators/migration/schema.json",
+      "description": "Create a migration for an Nx Plugin."
+    },
+    "generator": {
+      "factory": "./src/generators/generator/generator#generatorSchematic",
+      "schema": "./src/generators/generator/schema.json",
+      "description": "Create a generator for an Nx Plugin."
+    },
+    "executor": {
+      "factory": "./src/generators/executor/executor#executorSchematic",
+      "schema": "./src/generators/executor/schema.json",
+      "description": "Create an executor for an Nx Plugin."
+    }
+  }
+}

package/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/plugin/index.ts"],"names":[],"mappings":""}

package/migrations.json

@@ -0,0 +1,46 @@
+{
+  "generators": {
+    "add-swc-deps": {
+      "cli": "nx",
+      "version": "14.1.9-beta.0",
+      "description": "Adds @swc/core and @swc-node as a dev dep if you are using them",
+      "factory": "./src/migrations/update-14-1-9/add-swc-deps-if-needed"
+    },
+    "add-swc-deps-again": {
+      "cli": "nx",
+      "version": "14.2.3-beta.0",
+      "description": "Adds @swc/core and @swc-node as a dev dep if you are using them (repeated due to bad version on earlier migration)",
+      "factory": "./src/migrations/update-14-1-9/add-swc-deps-if-needed"
+    },
+    "update-15-0-0": {
+      "cli": "nx",
+      "version": "15.0.0-beta.0",
+      "description": "Migrates executor schema files to v2",
+      "factory": "./src/migrations/update-15-0-0/specify-output-capture"
+    },
+    "update-configs-jest-29": {
+      "version": "15.9.0-beta.0",
+      "cli": "nx",
+      "description": "Update nx plugin jest configs to support jest 29 changes (https://jestjs.io/docs/upgrading-to-jest29)",
+      "factory": "./src/migrations/update-15-9-0/jest-29-configs"
+    },
+    "update-tests-jest-29": {
+      "version": "15.9.0-beta.0",
+      "cli": "nx",
+      "description": "Update nx plugin jest test files to support jest 29 changes (https://jestjs.io/docs/upgrading-to-jest29)",
+      "factory": "./src/migrations/update-15-9-0/jest-29-tests"
+    },
+    "update-remove-cli-prop": {
+      "version": "16.0.0-beta.1",
+      "cli": "nx",
+      "description": "Removes CLI property within schema.json files and moves generators and schematics to the proper root node in migrations.json",
+      "factory": "./src/migrations/update-16-0-0/cli-in-schema-json"
+    },
+    "update-16-0-0-add-nx-packages": {
+      "cli": "nx",
+      "version": "16.0.0-beta.1",
+      "description": "Replace @nrwl/nx-plugin with @nx/plugin",
+      "implementation": "./src/migrations/update-16-0-0-add-nx-packages/update-16-0-0-add-nx-packages"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@nx/plugin",
+  "version": "16.0.0-beta.5",
+  "private": false,
+  "description": "This plugin is used to create Nx plugins! It contains generators for generating common plugin features like generators, executors, migrations and more.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nrwl/nx.git",
+    "directory": "packages/nx-plugin"
+  },
+  "keywords": [
+    "Monorepo",
+    "Nx",
+    "CLI"
+  ],
+  "main": "./index",
+  "types": "./index.d.ts",
+  "author": "Nrwl",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/nrwl/nx/issues"
+  },
+  "homepage": "https://nx.dev",
+  "schematics": "./generators.json",
+  "builders": "./executors.json",
+  "ng-update": {
+    "requirements": {},
+    "migrations": "./migrations.json"
+  },
+  "dependencies": {
+    "@nrwl/nx-plugin": "16.0.0-beta.5",
+    "@nx/devkit": "16.0.0-beta.5",
+    "@nx/jest": "16.0.0-beta.5",
+    "@nx/js": "16.0.0-beta.5",
+    "@nx/linter": "16.0.0-beta.5",
+    "@phenomnomnominal/tsquery": "~5.0.1",
+    "dotenv": "~10.0.0",
+    "fs-extra": "^11.1.0",
+    "tslib": "^2.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "04fed26279d04c2b02663df5872c6857eb7914bf"
+}

package/src/executors/e2e/compat.d.ts

@@ -0,0 +1 @@
+export declare const nxPluginE2EBuilder: any;

package/src/executors/e2e/compat.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nxPluginE2EBuilder = void 0;
+const devkit_1 = require("@nx/devkit");
+const e2e_impl_1 = require("./e2e.impl");
+exports.nxPluginE2EBuilder = (0, devkit_1.convertNxExecutor)(e2e_impl_1.nxPluginE2EExecutor);
+//# sourceMappingURL=compat.js.map

package/src/executors/e2e/compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.js","sourceRoot":"","sources":["../../../../../../packages/plugin/src/executors/e2e/compat.ts"],"names":[],"mappings":";;;AAAA,uCAA+C;AAC/C,yCAAiD;AAEpC,QAAA,kBAAkB,GAAG,IAAA,0BAAiB,EAAC,8BAAmB,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+import 'dotenv/config';
+import type { ExecutorContext } from '@nx/devkit';
+import type { NxPluginE2EExecutorOptions } from './schema';
+export declare function nxPluginE2EExecutor(options: NxPluginE2EExecutorOptions, context: ExecutorContext): AsyncGenerator<{
+    success: boolean;
+}>;
+export default nxPluginE2EExecutor;

package/src/executors/e2e/e2e.impl.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nxPluginE2EExecutor = void 0;
+const tslib_1 = require("tslib");
+require("dotenv/config");
+const devkit_1 = require("@nx/devkit");
+const jest_impl_1 = require("@nx/jest/src/executors/jest/jest.impl");
+// TODO(Caleb & Craigory): can we get rid of this and just use @nx/jest directly?
+function nxPluginE2EExecutor(options, context) {
+    return tslib_1.__asyncGenerator(this, arguments, function* nxPluginE2EExecutor_1() {
+        var _a, e_1, _b, _c;
+        const { target } = options, jestOptions = tslib_1.__rest(options, ["target"]);
+        let success;
+        try {
+            for (var _d = true, _e = tslib_1.__asyncValues(runBuildTarget(target, context)), _f; _f = yield tslib_1.__await(_e.next()), _a = _f.done, !_a;) {
+                _c = _f.value;
+                _d = false;
+                try {
+                    const _ = _c;
+                    try {
+                        success = yield tslib_1.__await(runTests(jestOptions, context));
+                    }
+                    catch (e) {
+                        devkit_1.logger.error(e.message);
+                        success = false;
+                    }
+                }
+                finally {
+                    _d = true;
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (!_d && !_a && (_b = _e.return)) yield tslib_1.__await(_b.call(_e));
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return yield tslib_1.__await({ success });
+    });
+}
+exports.nxPluginE2EExecutor = nxPluginE2EExecutor;
+function runBuildTarget(buildTarget, context) {
+    return tslib_1.__asyncGenerator(this, arguments, function* runBuildTarget_1() {
+        var _a, e_2, _b, _c;
+        const { project, target, configuration } = (0, devkit_1.parseTargetString)(buildTarget);
+        const buildTargetOptions = (0, devkit_1.readTargetOptions)({ project, target, configuration }, context);
+        const targetSupportsWatch = Object.keys(buildTargetOptions).includes('watch');
+        try {
+            for (var _d = true, _e = tslib_1.__asyncValues(yield tslib_1.__await((0, devkit_1.runExecutor)({ project, target, configuration }, targetSupportsWatch ? { watch: false } : {}, context))), _f; _f = yield tslib_1.__await(_e.next()), _a = _f.done, !_a;) {
+                _c = _f.value;
+                _d = false;
+                try {
+                    const output = _c;
+                    if (!output.success)
+                        throw new Error('Could not compile application files.');
+                    yield yield tslib_1.__await(output.success);
+                }
+                finally {
+                    _d = true;
+                }
+            }
+        }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (!_d && !_a && (_b = _e.return)) yield tslib_1.__await(_b.call(_e));
+            }
+            finally { if (e_2) throw e_2.error; }
+        }
+    });
+}
+function runTests(jestOptions, context) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const { success } = yield (0, jest_impl_1.jestExecutor)(Object.assign(Object.assign({}, jestOptions), { watch: false }), context);
+        return success;
+    });
+}
+exports.default = nxPluginE2EExecutor;
+//# sourceMappingURL=e2e.impl.js.map

package/src/executors/e2e/e2e.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e.impl.js","sourceRoot":"","sources":["../../../../../../packages/plugin/src/executors/e2e/e2e.impl.ts"],"names":[],"mappings":";;;;AAAA,yBAAuB;AAIvB,uCAKoB;AAEpB,qEAAqE;AAGrE,iFAAiF;AACjF,SAAuB,mBAAmB,CACxC,OAAmC,EACnC,OAAwB;;;QAExB,MAAM,EAAE,MAAM,KAAqB,OAAO,EAAvB,WAAW,kBAAK,OAAO,EAApC,UAA0B,CAAU,CAAC;QAE3C,IAAI,OAAgB,CAAC;;YACrB,KAAsB,eAAA,KAAA,sBAAA,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA,IAAA;gBAA/B,cAA+B;gBAA/B,WAA+B;;oBAA1C,MAAM,CAAC,KAAA,CAAA;oBAChB,IAAI;wBACF,OAAO,GAAG,sBAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA,CAAC;qBAChD;oBAAC,OAAO,CAAC,EAAE;wBACV,eAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;wBACxB,OAAO,GAAG,KAAK,CAAC;qBACjB;;;;;aACF;;;;;;;;;QAED,6BAAO,EAAE,OAAO,EAAE,EAAC;IACrB,CAAC;CAAA;AAjBD,kDAiBC;AAED,SAAgB,cAAc,CAC5B,WAAmB,EACnB,OAAwB;;;QAExB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAA,0BAAiB,EAAC,WAAW,CAAC,CAAC;QAC1E,MAAM,kBAAkB,GAAG,IAAA,0BAAiB,EAC1C,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,EAClC,OAAO,CACR,CAAC;QACF,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;;YAE9E,KAA2B,eAAA,KAAA,sBAAA,sBAAM,IAAA,oBAAW,EAC1C,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,EAClC,mBAAmB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAC3C,OAAO,CACR,CAAA,CAAA,IAAA;gBAJ0B,cAI1B;gBAJ0B,WAI1B;;oBAJU,MAAM,MAAM,KAAA,CAAA;oBAKrB,IAAI,CAAC,MAAM,CAAC,OAAO;wBACjB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;oBAC1D,4BAAM,MAAM,CAAC,OAAO,CAAA,CAAC;;;;;aACtB;;;;;;;;;IACH,CAAC;CAAA;AAED,SAAe,QAAQ,CACrB,WAAgC,EAChC,OAAwB;;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAA,wBAAY,kCAC/B,WAAW,KAAE,KAAK,EAAE,KAAK,KAC9B,OAAO,CACR,CAAC;QAEF,OAAO,OAAO,CAAC;IACjB,CAAC;CAAA;AAED,kBAAe,mBAAmB,CAAC"}

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

@@ -0,0 +1,6 @@
+import { JestExecutorOptions } from '@nx/jest/src/executors/jest/schema';
+
+export interface NxPluginE2EExecutorOptions extends JestExecutorOptions {
+  target: string;
+  jestConfig: string;
+}