@nx/plugin 16.0.0-beta.5

package/src/generators/e2e-project/e2e.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e.js","sourceRoot":"","sources":["../../../../../../packages/plugin/src/generators/e2e-project/e2e.ts"],"names":[],"mappings":";;;;AACA,uCAaoB;AACpB,mCAAgD;AAChD,+BAAuD;AACvD,6BAA6B;AAG7B,uCAA0D;AAU1D,SAAS,gBAAgB,CAAC,IAAU,EAAE,OAAe;;IACnD,MAAM,EAAE,eAAe,EAAE,gBAAgB,EAAE,GAAG,IAAA,+BAAsB,EAClE,OAAO,CAAC,gBAAgB,CACzB,CAAC;IACF,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,IAAA,2BAAkB,EAAC,IAAI,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,eAAe,aAAf,eAAe,cAAf,eAAe,GAAI,cAAc,CAAC;IAElD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,MAAM,CAAC;IAC9E,MAAM,WAAW,GACf,gBAAgB,IAAI,CAAC,OAAO,CAAC,WAAW;QACtC,CAAC,CAAC,IAAA,0BAAiB,EAAC,OAAO,EAAE,GAAG,gBAAgB,MAAM,CAAC;QACvD,CAAC,CAAC,OAAO,CAAC,WAAW;YACrB,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,IAAA,0BAAiB,EAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC9C,MAAM,kBAAkB,GAAG,IAAA,cAAK,EAAC,OAAO,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC;IAElE,uCACK,OAAO,KACV,WAAW,EACX,MAAM,EAAE,MAAA,OAAO,CAAC,MAAM,mCAAI,eAAM,CAAC,MAAM,EACvC,kBAAkB;QAClB,WAAW;QACX,QAAQ,IACR;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,IAAU,EAAE,UAAkB;IACpD,IAAI;QACF,IAAA,iCAAwB,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC;KAC5C;IAAC,WAAM;QACN,MAAM,IAAI,KAAK,CAAC,iBAAiB,UAAU,sBAAsB,CAAC,CAAC;KACpE;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,IAAU,EAAE,OAAyB;IACrD,IAAA,sBAAa,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,kCACnE,OAAO,KACV,IAAI,EAAE,EAAE,EACR,gBAAgB,EAAE,IAAA,kCAA6B,EAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,IAC1E,CAAC;AACL,CAAC;AAED,SAAS,4BAA4B,CAAC,IAAU,EAAE,OAAyB;IACzE,IAAA,gCAAuB,EAAC,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE;QACjD,IAAI,EAAE,OAAO,CAAC,WAAW;QACzB,WAAW,EAAE,aAAa;QAC1B,UAAU,EAAE,GAAG,OAAO,CAAC,WAAW,QAAQ;QAC1C,OAAO,EAAE;YACP,GAAG,EAAE;gBACH,QAAQ,EAAE,gBAAgB;gBAC1B,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,QAAQ,EAAE;aACnD;SACF;QACD,IAAI,EAAE,EAAE;QACR,oBAAoB,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;KAC3C,CAAC,CAAC;AACL,CAAC;AAED,SAAe,OAAO,CAAC,IAAU,EAAE,OAAyB;;QAC1D,MAAM,IAAA,2BAAoB,EAAC,IAAI,EAAE;YAC/B,OAAO,EAAE,OAAO,CAAC,WAAW;YAC5B,SAAS,EAAE,MAAM;YACjB,UAAU,EAAE,KAAK;YACjB,eAAe,EAAE,IAAI;YACrB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAA,iCAAwB,EAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QACjD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QAC/C,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,mCACtB,UAAU,KACb,UAAU,EAAE,WAAW,CAAC,UAAU,GACnC,CAAC;QAEF,+BAA+B;QAC/B,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAE5B,IAAA,mCAA0B,EAAC,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;CAAA;AAED,SAAe,uBAAuB,CACpC,IAAU,EACV,OAAyB;;QAEzB,MAAM,QAAQ,GAAG,MAAM,IAAA,6BAAoB,EAAC,IAAI,EAAE;YAChD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,WAAW;YAC5B,aAAa,EAAE;gBACb,IAAA,0BAAiB,EAAC,OAAO,CAAC,WAAW,EAAE,mBAAmB,CAAC;aAC5D;YACD,kBAAkB,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,UAAU,CAAC;YACtD,cAAc,EAAE,MAAM;YACtB,UAAU,EAAE,IAAI;YAChB,uBAAuB,EAAE,KAAK;SAC/B,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;CAAA;AAED,SAAsB,mBAAmB,CAAC,IAAU,EAAE,MAAc;;QAClE,MAAM,KAAK,GAAwB,EAAE,CAAC;QAEtC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxB,4BAA4B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE7B,IAAI,OAAO,CAAC,MAAM,KAAK,eAAM,CAAC,IAAI,EAAE;YAClC,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,IAAI,oBAC9C,OAAO,EACV,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;SACtB;QAED,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;YACvB,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;SACzB;QAED,OAAO,IAAA,yBAAgB,EAAC,GAAG,KAAK,CAAC,CAAC;IACpC,CAAC;CAAA;AArBD,kDAqBC;AAED,kBAAe,mBAAmB,CAAC;AACtB,QAAA,mBAAmB,GAAG,IAAA,2BAAkB,EAAC,mBAAmB,CAAC,CAAC"}

package/src/generators/e2e-project/files/tests/__pluginName__.spec.ts__tmpl__

@@ -0,0 +1,37 @@
+import {
+  checkFilesExist,
+  ensureNxProject,
+  readJson,
+  runNxCommandAsync,
+  runNxCommand,
+  uniq,
+} from '@nx/plugin/testing';
+
+describe('<%= pluginName %> e2e', () => {
+  // Setting up individual workspaces per
+  // test can cause e2e runs to take a long time.
+  // For this reason, we recommend each suite only
+  // consumes 1 workspace. The tests should each operate
+  // on a unique project in the workspace, such that they
+  // are not dependant on one another.
+  beforeAll(() => {
+    ensureNxProject('<%= npmPackageName %>', '<%= pluginOutputPath %>');
+  });
+
+  afterAll(() => {
+    // `nx reset` kills the daemon, and performs
+    // some work which can help clean up e2e leftovers
+    runNxCommandAsync('reset');
+  });
+
+
+  // Add some tests here to check that your plugin functionality works as expected.
+  // A sample test is included below to give you some ideas.
+  xit('should be able to build generated projects', async () => {
+    const name = uniq('proj');
+    const generator = 'PLACEHOLDER';
+    await runNxCommandAsync(`generate <%= npmPackageName %>:${generator} --name ${name}`);
+    expect(() => runNxCommand('build ${proj}')).not.toThrow();
+    expect(() => checkFilesExist(`dist/${name}/index.js`)).not.toThrow();
+  });
+});

package/src/generators/e2e-project/files/tsconfig.json__tmpl__

@@ -0,0 +1,6 @@
+{
+  "extends": "<%= rootTsConfigPath %>",
+  "files": [],
+  "include": [],
+  "references": []
+}

package/src/generators/e2e-project/schema.d.ts

@@ -0,0 +1,12 @@
+import { Linter } from '@nx/linter';
+
+export interface Schema {
+  pluginName: string;
+  npmPackageName: string;
+  projectDirectory?: string;
+  pluginOutputPath?: string;
+  jestConfig?: string;
+  linter?: Linter;
+  skipFormat?: boolean;
+  rootProject?: boolean;
+}

package/src/generators/e2e-project/schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "cli": "nx",
+  "$id": "NxPluginE2E",
+  "title": "Create an E2E app for a Nx Plugin",
+  "description": "Create an E2E app for a Nx Plugin.",
+  "type": "object",
+  "properties": {
+    "pluginName": {
+      "type": "string",
+      "description": "the project name of the plugin to be tested.",
+      "x-priority": "important"
+    },
+    "npmPackageName": {
+      "type": "string",
+      "description": "the package name of the plugin as it would be published to NPM.",
+      "x-priority": "important"
+    },
+    "projectDirectory": {
+      "type": "string",
+      "description": "the directory where the plugin is placed."
+    },
+    "pluginOutputPath": {
+      "type": "string",
+      "description": "the output path of the plugin after it builds.",
+      "x-priority": "important"
+    },
+    "jestConfig": {
+      "type": "string",
+      "description": "Jest config file."
+    },
+    "standaloneConfig": {
+      "description": "Split the project configuration into `<projectRoot>/project.json` rather than including it inside `workspace.json`.",
+      "type": "boolean",
+      "default": true,
+      "x-deprecated": "Nx only supports standaloneConfig"
+    },
+    "linter": {
+      "description": "The tool to use for running lint checks.",
+      "type": "string",
+      "enum": ["eslint", "none"],
+      "default": "eslint"
+    },
+    "minimal": {
+      "type": "boolean",
+      "description": "Generate the e2e project with a minimal setup. This would involve not generating tests for a default executor and generator.",
+      "default": false
+    },
+    "skipFormat": {
+      "description": "Skip formatting files.",
+      "type": "boolean",
+      "default": false,
+      "x-priority": "internal"
+    }
+  },
+  "required": ["pluginName", "npmPackageName"]
+}

package/src/generators/executor/executor.d.ts

@@ -0,0 +1,6 @@
+import type { Tree } from '@nx/devkit';
+import type { Schema } from './schema';
+export declare function createExecutorsJson(host: Tree, projectRoot: string, projectName: string, skipLintChecks?: boolean): Promise<void>;
+export declare function executorGenerator(host: Tree, schema: Schema): Promise<void>;
+export default executorGenerator;
+export declare const executorSchematic: (generatorOptions: Schema) => (tree: any, context: any) => Promise<any>;

package/src/generators/executor/executor.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executorSchematic = exports.executorGenerator = exports.createExecutorsJson = void 0;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const path = require("path");
+const generator_1 = require("../lint-checks/generator");
+function addFiles(host, options) {
+    (0, devkit_1.generateFiles)(host, path.join(__dirname, './files/executor'), `${options.projectSourceRoot}/executors`, Object.assign(Object.assign({}, options), { tmpl: '' }));
+    if (options.unitTestRunner === 'none') {
+        host.delete((0, devkit_1.joinPathFragments)(options.projectSourceRoot, 'executors', options.fileName, `executor.spec.ts`));
+    }
+}
+function addHasherFiles(host, options) {
+    (0, devkit_1.generateFiles)(host, path.join(__dirname, './files/hasher'), `${options.projectSourceRoot}/executors`, Object.assign(Object.assign({}, options), { tmpl: '' }));
+    if (options.unitTestRunner === 'none') {
+        host.delete((0, devkit_1.joinPathFragments)(options.projectSourceRoot, 'executors', options.fileName, 'hasher.spec.ts'));
+    }
+}
+function createExecutorsJson(host, projectRoot, projectName, skipLintChecks) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        (0, devkit_1.updateJson)(host, (0, devkit_1.joinPathFragments)(projectRoot, 'package.json'), (json) => {
+            var _a;
+            (_a = json.executors) !== null && _a !== void 0 ? _a : (json.executors = './executors.json');
+            return json;
+        });
+        (0, devkit_1.writeJson)(host, (0, devkit_1.joinPathFragments)(projectRoot, 'executors.json'), {
+            executors: {},
+        });
+        if (!skipLintChecks) {
+            yield (0, generator_1.default)(host, {
+                projectName,
+            });
+        }
+    });
+}
+exports.createExecutorsJson = createExecutorsJson;
+function updateExecutorJson(host, options) {
+    var _a;
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const packageJson = (0, devkit_1.readJson)(host, (0, devkit_1.joinPathFragments)(options.projectRoot, 'package.json'));
+        const packageJsonExecutors = (_a = packageJson.executors) !== null && _a !== void 0 ? _a : packageJson.builders;
+        let executorsPath = packageJsonExecutors
+            ? (0, devkit_1.joinPathFragments)(options.projectRoot, packageJsonExecutors)
+            : null;
+        if (!executorsPath) {
+            executorsPath = (0, devkit_1.joinPathFragments)(options.projectRoot, 'executors.json');
+        }
+        if (!host.exists(executorsPath)) {
+            yield createExecutorsJson(host, options.projectRoot, options.project, options.skipLintChecks);
+        }
+        return (0, devkit_1.updateJson)(host, executorsPath, (json) => {
+            var _a;
+            let executors = (_a = json.executors) !== null && _a !== void 0 ? _a : json.builders;
+            executors || (executors = {});
+            executors[options.name] = {
+                implementation: `./src/executors/${options.fileName}/executor`,
+                schema: `./src/executors/${options.fileName}/schema.json`,
+                description: options.description,
+            };
+            if (options.includeHasher) {
+                executors[options.name].hasher = `./src/executors/${options.fileName}/hasher`;
+            }
+            json.executors = executors;
+            return json;
+        });
+    });
+}
+function normalizeOptions(host, options) {
+    const { npmScope } = (0, devkit_1.getWorkspaceLayout)(host);
+    const { fileName, className, propertyName } = (0, devkit_1.names)(options.name);
+    const { root: projectRoot, sourceRoot: projectSourceRoot } = (0, devkit_1.readProjectConfiguration)(host, options.project);
+    let description;
+    if (options.description) {
+        description = options.description;
+    }
+    else {
+        description = `${options.name} executor`;
+    }
+    return Object.assign(Object.assign({}, options), { fileName,
+        className,
+        propertyName,
+        description,
+        projectRoot,
+        projectSourceRoot,
+        npmScope });
+}
+function executorGenerator(host, schema) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const options = normalizeOptions(host, schema);
+        addFiles(host, options);
+        if (options.includeHasher) {
+            addHasherFiles(host, options);
+        }
+        yield updateExecutorJson(host, options);
+        if (!schema.skipFormat) {
+            yield (0, devkit_1.formatFiles)(host);
+        }
+    });
+}
+exports.executorGenerator = executorGenerator;
+exports.default = executorGenerator;
+exports.executorSchematic = (0, devkit_1.convertNxGenerator)(executorGenerator);
+//# sourceMappingURL=executor.js.map

package/src/generators/executor/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../packages/plugin/src/generators/executor/executor.ts"],"names":[],"mappings":"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"}

package/src/generators/executor/files/executor/__fileName__/executor.spec.ts__tmpl__

@@ -0,0 +1,11 @@
+import { <%= className %>ExecutorSchema } from './schema';
+import executor from './executor';
+
+const options: <%= className %>ExecutorSchema = {};
+
+describe('<%= className %> Executor', () => {
+  it('can run', async () => {
+    const output = await executor(options);
+    expect(output.success).toBe(true);
+  });
+});

package/src/generators/executor/files/executor/__fileName__/executor.ts__tmpl__

@@ -0,0 +1,11 @@
+import { <%= className %>ExecutorSchema } from './schema';
+
+export default async function runExecutor(
+  options: <%= className %>ExecutorSchema,
+) {
+  console.log('Executor ran for <%= className %>', options);
+  return {
+    success: true
+  };
+}
+

package/src/generators/executor/files/executor/__fileName__/schema.d.ts__tmpl__

@@ -0,0 +1 @@
+export interface <%= className %>ExecutorSchema {} // eslint-disable-line

package/src/generators/executor/files/executor/__fileName__/schema.json__tmpl__

@@ -0,0 +1,9 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "version": 2,
+  "title": "<%= className %> executor",
+  "description": "",
+  "type": "object",
+  "properties": {},
+  "required": []
+}

package/src/generators/executor/files/hasher/__fileName__/hasher.spec.ts__tmpl__

@@ -0,0 +1,22 @@
+import { Hasher, HasherContext } from '@nx/devkit';
+
+import { <%=propertyName%>Hasher } from './hasher';
+
+describe('<%=propertyName%>Hasher', () => {
+    it('should generate hash', async () => {
+        const mockHasher: Hasher = {
+            hashTask: jest.fn().mockReturnValue({value: 'hashed-task'})
+        } as unknown as Hasher
+        const hash = await <%=propertyName%>Hasher({
+            id: 'my-task-id',
+            target: {
+                project: 'proj',
+                target: 'target'
+            },
+            overrides: {}
+        }, {
+            hasher: mockHasher
+        } as unknown as HasherContext)
+        expect(hash).toEqual({value: 'hashed-task'})
+    })
+})

package/src/generators/executor/files/hasher/__fileName__/hasher.ts__tmpl__

@@ -0,0 +1,12 @@
+import { CustomHasher } from '@nx/devkit';
+
+/**
+ * This is a boilerplate custom hasher that matches
+ * the default Nx hasher. If you need to extend the behavior,
+ * you can consume workspace details from the context.
+ */
+export const <%=propertyName%>Hasher: CustomHasher = async (task, context) => {
+    return context.hasher.hashTask(task);
+};
+
+export default <%=propertyName%>Hasher;

package/src/generators/executor/schema.d.ts

@@ -0,0 +1,9 @@
+export interface Schema {
+  project: string;
+  name: string;
+  description?: string;
+  unitTestRunner: 'jest' | 'none';
+  includeHasher: boolean;
+  skipLintChecks?: boolean;
+  skipFormat?: boolean;
+}

package/src/generators/executor/schema.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "cli": "nx",
+  "$id": "NxPluginExecutor",
+  "title": "Create an Executor for an Nx Plugin",
+  "description": "Create an Executor for an Nx Plugin.",
+  "type": "object",
+  "examples": [
+    {
+      "command": "nx g executor my-executor --project=my-plugin",
+      "description": "Generate `libs/my-plugin/src/executors/my-executor`"
+    }
+  ],
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The name of the project.",
+      "alias": "p",
+      "$default": {
+        "$source": "projectName"
+      },
+      "x-prompt": "What is the name of the project for the executor?",
+      "x-priority": "important"
+    },
+    "name": {
+      "type": "string",
+      "description": "Executor name.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use for the executor?",
+      "x-priority": "important"
+    },
+    "description": {
+      "type": "string",
+      "description": "Executor description."
+    },
+    "unitTestRunner": {
+      "type": "string",
+      "enum": ["jest", "none"],
+      "description": "Test runner to use for unit tests.",
+      "default": "jest"
+    },
+    "includeHasher": {
+      "type": "boolean",
+      "default": false,
+      "description": "Should the boilerplate for a custom hasher be generated?"
+    },
+    "skipLintChecks": {
+      "type": "boolean",
+      "default": false,
+      "description": "Do not add an eslint configuration for plugin json files."
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "description": "Skip formatting files.",
+      "default": false,
+      "x-priority": "internal"
+    }
+  },
+  "required": ["project", "name"],
+  "additionalProperties": false
+}

package/src/generators/generator/files/generator/__fileName__/generator.spec.ts__tmpl__

@@ -0,0 +1,20 @@
+import { createTreeWithEmptyWorkspace } from '@nx/devkit/testing';
+import { Tree, readProjectConfiguration } from '@nx/devkit';
+
+import generator from './generator';
+import { <%= className %>GeneratorSchema } from './schema';
+
+describe('<%= name %> generator', () => {
+  let appTree: Tree;
+  const options: <%= className %>GeneratorSchema = { name: 'test' };
+
+  beforeEach(() => {
+    appTree = createTreeWithEmptyWorkspace({layout: 'apps-libs'});
+  });
+
+  it('should run successfully', async () => {
+    await generator(appTree, options);
+    const config = readProjectConfiguration(appTree, 'test');
+    expect(config).toBeDefined();
+  });
+});

package/src/generators/generator/files/generator/__fileName__/generator.ts__tmpl__

@@ -0,0 +1,72 @@
+import {
+  addProjectConfiguration,
+  formatFiles,
+  generateFiles,
+  getWorkspaceLayout,
+  names,
+  offsetFromRoot,
+  Tree,
+} from '@nx/devkit';
+import * as path from 'path';
+import { <%= className %>GeneratorSchema } from './schema';
+
+interface NormalizedSchema extends <%= className %>GeneratorSchema {
+  projectName: string;
+  projectRoot: string;
+  projectDirectory: string;
+  parsedTags: string[];
+}
+
+function normalizeOptions(tree: Tree, options: <%= className %>GeneratorSchema): NormalizedSchema {
+  const name = names(options.name).fileName;
+  const projectDirectory = options.directory
+    ? `${names(options.directory).fileName}/${name}`
+    : name;
+  const projectName = projectDirectory.replace(new RegExp('/', 'g'), '-');
+  const projectRoot =
+    getWorkspaceLayout(tree).libsDir === '.'
+      ? '.'
+      : `${getWorkspaceLayout(tree).libsDir}/${projectDirectory}`;
+  const parsedTags = options.tags
+    ? options.tags.split(',').map((s) => s.trim())
+    : [];
+
+  return {
+    ...options,
+    projectName,
+    projectRoot,
+    projectDirectory,
+    parsedTags,
+  };
+}
+
+function addFiles(tree: Tree, options: NormalizedSchema) {
+    const templateOptions = {
+      ...options,
+      ...names(options.name),
+      offsetFromRoot: offsetFromRoot(options.projectRoot),
+      template: ''
+    };
+    generateFiles(tree, path.join(__dirname, 'files'), options.projectRoot, templateOptions);
+}
+
+export default async function (tree: Tree, options: <%= className %>GeneratorSchema) {
+  const normalizedOptions = normalizeOptions(tree, options);
+  addProjectConfiguration(
+    tree,
+    normalizedOptions.projectName,
+    {
+      root: normalizedOptions.projectRoot,
+      projectType: 'library',
+      sourceRoot: `${normalizedOptions.projectRoot}/src`,
+      targets: {
+        build: {
+          executor: "<%= npmPackageName %>:build",
+        },
+      },
+      tags: normalizedOptions.parsedTags,
+    }
+  );
+  addFiles(tree, normalizedOptions);
+  await formatFiles(tree);
+}

package/src/generators/generator/files/generator/__fileName__/schema.d.ts__tmpl__

@@ -0,0 +1,5 @@
+export interface <%= className %>GeneratorSchema {
+    name: string;
+    tags?: string;
+    directory?: string;
+}

package/src/generators/generator/files/generator/__fileName__/schema.json__tmpl__

@@ -0,0 +1,27 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "<%= className %>",
+  "title": "",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use?"
+    },
+    "tags": {
+      "type": "string",
+      "description": "Add tags to the project (used for linting)",
+      "alias": "t"
+    }, 
+    "directory": {
+      "type": "string",
+      "description": "A directory where the project is placed"
+    }
+  },
+  "required": ["name"]
+}

package/src/generators/generator/generator.d.ts

@@ -0,0 +1,6 @@
+import { Tree } from '@nx/devkit';
+import type { Schema } from './schema';
+export declare function createGeneratorsJson(host: Tree, projectRoot: string, projectName: string, skipLintChecks?: boolean, skipFormat?: boolean): Promise<void>;
+export declare function generatorGenerator(host: Tree, schema: Schema): Promise<void>;
+export default generatorGenerator;
+export declare const generatorSchematic: (generatorOptions: Schema) => (tree: any, context: any) => Promise<any>;

package/src/generators/generator/generator.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatorSchematic = exports.generatorGenerator = exports.createGeneratorsJson = void 0;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const path = require("path");
+const has_generator_1 = require("../../utils/has-generator");
+const generator_1 = require("../lint-checks/generator");
+function normalizeOptions(host, options) {
+    const { npmScope } = (0, devkit_1.getWorkspaceLayout)(host);
+    const { fileName, className } = (0, devkit_1.names)(options.name);
+    const { root: projectRoot, sourceRoot: projectSourceRoot } = (0, devkit_1.readProjectConfiguration)(host, options.project);
+    const npmPackageName = (0, devkit_1.readJson)(host, path.join(projectRoot, 'package.json')).name;
+    let description;
+    if (options.description) {
+        description = options.description;
+    }
+    else {
+        description = `${options.name} generator`;
+    }
+    return Object.assign(Object.assign({}, options), { fileName,
+        className,
+        description,
+        projectRoot,
+        projectSourceRoot,
+        npmScope,
+        npmPackageName });
+}
+function addFiles(host, options) {
+    const indexPath = `${options.projectSourceRoot}/generators/${options.fileName}/files/src/index.ts__template__`;
+    if (!host.exists(indexPath)) {
+        host.write(indexPath, 'const variable = "<%= projectName %>";');
+    }
+    (0, devkit_1.generateFiles)(host, path.join(__dirname, './files/generator'), `${options.projectSourceRoot}/generators`, Object.assign(Object.assign({}, options), { tmpl: '' }));
+    if (options.unitTestRunner === 'none') {
+        host.delete(path.join(options.projectSourceRoot, 'generators', options.fileName, `generator.spec.ts`));
+    }
+}
+function createGeneratorsJson(host, projectRoot, projectName, skipLintChecks, skipFormat) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        (0, devkit_1.updateJson)(host, (0, devkit_1.joinPathFragments)(projectRoot, 'package.json'), (json) => {
+            var _a;
+            (_a = json.generators) !== null && _a !== void 0 ? _a : (json.generators = './generators.json');
+            return json;
+        });
+        (0, devkit_1.writeJson)(host, (0, devkit_1.joinPathFragments)(projectRoot, 'generators.json'), {
+            generators: {},
+        });
+        if (!skipLintChecks) {
+            yield (0, generator_1.default)(host, {
+                projectName,
+                skipFormat,
+            });
+        }
+    });
+}
+exports.createGeneratorsJson = createGeneratorsJson;
+function updateGeneratorJson(host, options) {
+    var _a;
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const packageJson = (0, devkit_1.readJson)(host, (0, devkit_1.joinPathFragments)(options.projectRoot, 'package.json'));
+        const packageJsonGenerators = (_a = packageJson.generators) !== null && _a !== void 0 ? _a : packageJson.schematics;
+        let generatorsPath = packageJsonGenerators
+            ? (0, devkit_1.joinPathFragments)(options.projectRoot, packageJsonGenerators)
+            : null;
+        if (!generatorsPath) {
+            generatorsPath = (0, devkit_1.joinPathFragments)(options.projectRoot, 'generators.json');
+        }
+        if (!host.exists(generatorsPath)) {
+            yield createGeneratorsJson(host, options.projectRoot, options.project, options.skipLintChecks, options.skipFormat);
+        }
+        (0, devkit_1.updateJson)(host, generatorsPath, (json) => {
+            var _a;
+            let generators = (_a = json.generators) !== null && _a !== void 0 ? _a : json.schematics;
+            generators = generators || {};
+            generators[options.name] = {
+                factory: `./src/generators/${options.fileName}/generator`,
+                schema: `./src/generators/${options.fileName}/schema.json`,
+                description: options.description,
+            };
+            // @todo(v17): Remove this, prop is defunct.
+            if (options.name === 'preset') {
+                generators[options.name]['x-use-standalone-layout'] = true;
+            }
+            json.generators = generators;
+            return json;
+        });
+    });
+}
+function generatorGenerator(host, schema) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const options = normalizeOptions(host, schema);
+        if ((0, has_generator_1.hasGenerator)(host, options.project, options.name)) {
+            throw new Error(`Generator ${options.name} already exists.`);
+        }
+        addFiles(host, options);
+        yield updateGeneratorJson(host, options);
+        if (!options.skipFormat) {
+            yield (0, devkit_1.formatFiles)(host);
+        }
+    });
+}
+exports.generatorGenerator = generatorGenerator;
+exports.default = generatorGenerator;
+exports.generatorSchematic = (0, devkit_1.convertNxGenerator)(generatorGenerator);
+//# sourceMappingURL=generator.js.map

package/src/generators/generator/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/plugin/src/generators/generator/generator.ts"],"names":[],"mappings":"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"}