@nx/devkit 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 contains a set of utilities for creating Nx plugins.
+
+## 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/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The Nx Devkit is the underlying technology used to customize Nx to support
+ * different technologies and custom use-cases. It contains many utility
+ * functions for reading and writing files, updating configuration,
+ * working with Abstract Syntax Trees(ASTs), and more.
+ *
+ * As with most things in Nx, the core of Nx Devkit is very simple.
+ * It only uses language primitives and immutable objects
+ * (the tree being the only exception).
+ *
+ * @module @nx/devkit
+ */
+export * from 'nx/src/devkit-exports';
+export * from './public-api';

package/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * The Nx Devkit is the underlying technology used to customize Nx to support
+ * different technologies and custom use-cases. It contains many utility
+ * functions for reading and writing files, updating configuration,
+ * working with Abstract Syntax Trees(ASTs), and more.
+ *
+ * As with most things in Nx, the core of Nx Devkit is very simple.
+ * It only uses language primitives and immutable objects
+ * (the tree being the only exception).
+ *
+ * @module @nx/devkit
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// eslint-disable-next-line @typescript-eslint/no-restricted-imports
+tslib_1.__exportStar(require("nx/src/devkit-exports"), exports);
+tslib_1.__exportStar(require("./public-api"), exports);

package/migrations.json

@@ -0,0 +1,18 @@
+{
+  "generators": {
+    "update-16-0-0-add-nx-packages": {
+      "cli": "nx",
+      "version": "16.0.0-beta.1",
+      "description": "Replace @nrwl/devkit with @nx/devkit",
+      "implementation": "./src/migrations/update-16-0-0-add-nx-packages/update-16-0-0-add-nx-packages"
+    },
+    "update-16-9-0-migrate-mf-usage-to-webpack": {
+      "cli": "nx",
+      "version": "16.9.0-beta.1",
+      "description": "Replace imports of Module Federation utils frm @nx/devkit to @nx/webpack",
+      "implementation": "./src/migrations/update-16-9-0/migrate-mf-util-usage"
+    }
+  },
+  "packageJsonUpdates": {},
+  "version": "0.1"
+}

package/ngcli-adapter.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @category Ng CLI Adapter
+ */
+export { wrapAngularDevkitSchematic, mockSchematicsForTesting, NxScopedHost, } from 'nx/src/adapter/ngcli-adapter';

package/ngcli-adapter.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NxScopedHost = exports.mockSchematicsForTesting = exports.wrapAngularDevkitSchematic = void 0;
+/**
+ * @category Ng CLI Adapter
+ */
+// eslint-disable-next-line @typescript-eslint/no-restricted-imports
+var ngcli_adapter_1 = require("nx/src/adapter/ngcli-adapter");
+Object.defineProperty(exports, "wrapAngularDevkitSchematic", { enumerable: true, get: function () { return ngcli_adapter_1.wrapAngularDevkitSchematic; } });
+Object.defineProperty(exports, "mockSchematicsForTesting", { enumerable: true, get: function () { return ngcli_adapter_1.mockSchematicsForTesting; } });
+Object.defineProperty(exports, "NxScopedHost", { enumerable: true, get: function () { return ngcli_adapter_1.NxScopedHost; } });

package/nx.d.ts

@@ -0,0 +1 @@
+export declare function requireNx(): typeof import('nx/src/devkit-exports') & Partial<typeof import('nx/src/devkit-internals')>;

package/nx.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireNx = void 0;
+// After Nx v19, this can be removed and replaced with either:
+// - import {} from 'nx/src/devkit-exports'
+// - import {} from 'nx/src/devkit-internals'
+function requireNx() {
+    let result = { ...require('nx/src/devkit-exports') };
+    try {
+        result = {
+            ...result,
+            // Remove in Nx v19, devkit should not support Nx v16.0.2 at that point.
+            ...require('nx/src/devkit-internals'),
+        };
+    }
+    catch { }
+    return result;
+}
+exports.requireNx = requireNx;

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@nx/devkit",
+  "version": "0.0.0-pr-22179-271588f",
+  "private": false,
+  "description": "The Nx Devkit is used to customize Nx for different technologies and use cases. It contains many utility functions for reading and writing files, updating configuration, working with Abstract Syntax Trees(ASTs), and more. Learn more about [extending Nx by leveraging the Nx Devkit](https://nx.dev/extending-nx/intro/getting-started) on our docs.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nrwl/nx.git",
+    "directory": "packages/devkit"
+  },
+  "keywords": [
+    "Monorepo",
+    "Angular",
+    "React",
+    "Web",
+    "Node",
+    "Nest",
+    "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",
+  "dependencies": {
+    "ejs": "^3.1.7",
+    "enquirer": "~2.3.6",
+    "ignore": "^5.0.4",
+    "tmp": "~0.2.1",
+    "tslib": "^2.3.0",
+    "semver": "^7.5.3",
+    "yargs-parser": "21.1.1",
+    "@nrwl/devkit": "0.0.0-pr-22179-271588f"
+  },
+  "peerDependencies": {
+    "nx": ">= 16 <= 18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "nx-migrations": {
+    "migrations": "./migrations.json"
+  },
+  "type": "commonjs"
+}

package/public-api.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Note to developers: STOP! This is the Public API of @nx/devkit.
+ * @nx/devkit should be compatible with versions of Nx 1 major version prior.
+ * This is so that plugins can use the latest @nx/devkit while their users may use versions +/- 1 of Nx.
+ *
+ * 1. Try hard to not add to this API to reduce the surface area we need to maintain.
+ * 2. Do not add newly created paths from the nx package to this file as they will not be available in older versions of Nx.
+ *   a. We might need to duplicate code instead of importing from nx until all supported versions of nx contain the file.
+ */
+/**
+ * @category Generators
+ */
+export { formatFiles } from './src/generators/format-files';
+/**
+ * @category Generators
+ */
+export { generateFiles } from './src/generators/generate-files';
+/**
+ * @category Generators
+ */
+export { toJS, ToJSOptions } from './src/generators/to-js';
+/**
+ * @category Generators
+ */
+export { updateTsConfigsToJs } from './src/generators/update-ts-configs-to-js';
+/**
+ * @category Generators
+ */
+export { runTasksInSerial } from './src/generators/run-tasks-in-serial';
+/**
+ * @category Generators
+ */
+export { visitNotIgnoredFiles } from './src/generators/visit-not-ignored-files';
+export { parseTargetString, targetToTargetString, } from './src/executors/parse-target-string';
+/**
+ * @category Executors
+ */
+export { readTargetOptions } from './src/executors/read-target-options';
+/**
+ * @category Utils
+ */
+export { addDependenciesToPackageJson, ensurePackage, removeDependenciesFromPackageJson, NX_VERSION, } from './src/utils/package-json';
+/**
+ * @category Utils
+ */
+export { installPackagesTask } from './src/tasks/install-packages-task';
+/**
+ * @category Utils
+ */
+export { names } from './src/utils/names';
+/**
+ * @category Utils
+ */
+export { getWorkspaceLayout, extractLayoutDirectory, } from './src/utils/get-workspace-layout';
+/**
+ * @category Utils
+ */
+export type { StringChange, StringDeletion, StringInsertion, } from './src/utils/string-change';
+/**
+ * @category Utils
+ */
+export { applyChangesToString, ChangeType } from './src/utils/string-change';
+/**
+ * @category Utils
+ */
+export { offsetFromRoot } from './src/utils/offset-from-root';
+/**
+ * @category Utils
+ */
+export { convertNxGenerator } from './src/utils/invoke-nx-generator';
+/**
+ * @category Utils
+ */
+export { convertNxExecutor } from './src/utils/convert-nx-executor';
+/**
+ * @category Utils
+ */
+export { moveFilesToNewDirectory } from './src/utils/move-dir';

package/public-api.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * Note to developers: STOP! This is the Public API of @nx/devkit.
+ * @nx/devkit should be compatible with versions of Nx 1 major version prior.
+ * This is so that plugins can use the latest @nx/devkit while their users may use versions +/- 1 of Nx.
+ *
+ * 1. Try hard to not add to this API to reduce the surface area we need to maintain.
+ * 2. Do not add newly created paths from the nx package to this file as they will not be available in older versions of Nx.
+ *   a. We might need to duplicate code instead of importing from nx until all supported versions of nx contain the file.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.moveFilesToNewDirectory = exports.convertNxExecutor = exports.convertNxGenerator = exports.offsetFromRoot = exports.ChangeType = exports.applyChangesToString = exports.extractLayoutDirectory = exports.getWorkspaceLayout = exports.names = exports.installPackagesTask = exports.NX_VERSION = exports.removeDependenciesFromPackageJson = exports.ensurePackage = exports.addDependenciesToPackageJson = exports.readTargetOptions = exports.targetToTargetString = exports.parseTargetString = exports.visitNotIgnoredFiles = exports.runTasksInSerial = exports.updateTsConfigsToJs = exports.toJS = exports.generateFiles = exports.formatFiles = void 0;
+/**
+ * @category Generators
+ */
+var format_files_1 = require("./src/generators/format-files");
+Object.defineProperty(exports, "formatFiles", { enumerable: true, get: function () { return format_files_1.formatFiles; } });
+/**
+ * @category Generators
+ */
+var generate_files_1 = require("./src/generators/generate-files");
+Object.defineProperty(exports, "generateFiles", { enumerable: true, get: function () { return generate_files_1.generateFiles; } });
+/**
+ * @category Generators
+ */
+var to_js_1 = require("./src/generators/to-js");
+Object.defineProperty(exports, "toJS", { enumerable: true, get: function () { return to_js_1.toJS; } });
+/**
+ * @category Generators
+ */
+var update_ts_configs_to_js_1 = require("./src/generators/update-ts-configs-to-js");
+Object.defineProperty(exports, "updateTsConfigsToJs", { enumerable: true, get: function () { return update_ts_configs_to_js_1.updateTsConfigsToJs; } });
+/**
+ * @category Generators
+ */
+var run_tasks_in_serial_1 = require("./src/generators/run-tasks-in-serial");
+Object.defineProperty(exports, "runTasksInSerial", { enumerable: true, get: function () { return run_tasks_in_serial_1.runTasksInSerial; } });
+/**
+ * @category Generators
+ */
+var visit_not_ignored_files_1 = require("./src/generators/visit-not-ignored-files");
+Object.defineProperty(exports, "visitNotIgnoredFiles", { enumerable: true, get: function () { return visit_not_ignored_files_1.visitNotIgnoredFiles; } });
+var parse_target_string_1 = require("./src/executors/parse-target-string");
+Object.defineProperty(exports, "parseTargetString", { enumerable: true, get: function () { return parse_target_string_1.parseTargetString; } });
+Object.defineProperty(exports, "targetToTargetString", { enumerable: true, get: function () { return parse_target_string_1.targetToTargetString; } });
+/**
+ * @category Executors
+ */
+var read_target_options_1 = require("./src/executors/read-target-options");
+Object.defineProperty(exports, "readTargetOptions", { enumerable: true, get: function () { return read_target_options_1.readTargetOptions; } });
+/**
+ * @category Utils
+ */
+var package_json_1 = require("./src/utils/package-json");
+Object.defineProperty(exports, "addDependenciesToPackageJson", { enumerable: true, get: function () { return package_json_1.addDependenciesToPackageJson; } });
+Object.defineProperty(exports, "ensurePackage", { enumerable: true, get: function () { return package_json_1.ensurePackage; } });
+Object.defineProperty(exports, "removeDependenciesFromPackageJson", { enumerable: true, get: function () { return package_json_1.removeDependenciesFromPackageJson; } });
+Object.defineProperty(exports, "NX_VERSION", { enumerable: true, get: function () { return package_json_1.NX_VERSION; } });
+/**
+ * @category Utils
+ */
+var install_packages_task_1 = require("./src/tasks/install-packages-task");
+Object.defineProperty(exports, "installPackagesTask", { enumerable: true, get: function () { return install_packages_task_1.installPackagesTask; } });
+/**
+ * @category Utils
+ */
+var names_1 = require("./src/utils/names");
+Object.defineProperty(exports, "names", { enumerable: true, get: function () { return names_1.names; } });
+/**
+ * @category Utils
+ */
+var get_workspace_layout_1 = require("./src/utils/get-workspace-layout");
+Object.defineProperty(exports, "getWorkspaceLayout", { enumerable: true, get: function () { return get_workspace_layout_1.getWorkspaceLayout; } });
+Object.defineProperty(exports, "extractLayoutDirectory", { enumerable: true, get: function () { return get_workspace_layout_1.extractLayoutDirectory; } });
+/**
+ * @category Utils
+ */
+var string_change_1 = require("./src/utils/string-change");
+Object.defineProperty(exports, "applyChangesToString", { enumerable: true, get: function () { return string_change_1.applyChangesToString; } });
+Object.defineProperty(exports, "ChangeType", { enumerable: true, get: function () { return string_change_1.ChangeType; } });
+/**
+ * @category Utils
+ */
+var offset_from_root_1 = require("./src/utils/offset-from-root");
+Object.defineProperty(exports, "offsetFromRoot", { enumerable: true, get: function () { return offset_from_root_1.offsetFromRoot; } });
+/**
+ * @category Utils
+ */
+var invoke_nx_generator_1 = require("./src/utils/invoke-nx-generator");
+Object.defineProperty(exports, "convertNxGenerator", { enumerable: true, get: function () { return invoke_nx_generator_1.convertNxGenerator; } });
+/**
+ * @category Utils
+ */
+var convert_nx_executor_1 = require("./src/utils/convert-nx-executor");
+Object.defineProperty(exports, "convertNxExecutor", { enumerable: true, get: function () { return convert_nx_executor_1.convertNxExecutor; } });
+/**
+ * @category Utils
+ */
+var move_dir_1 = require("./src/utils/move-dir");
+Object.defineProperty(exports, "moveFilesToNewDirectory", { enumerable: true, get: function () { return move_dir_1.moveFilesToNewDirectory; } });

package/src/executors/parse-target-string.d.ts

@@ -0,0 +1,44 @@
+import type { Target } from 'nx/src/command-line/run/run';
+import type { ProjectGraph } from 'nx/src/config/project-graph';
+import type { ExecutorContext } from 'nx/src/devkit-exports';
+/**
+ * @deprecated(v17) A project graph should be passed to parseTargetString for best accuracy.
+ */
+export declare function parseTargetString(targetString: string): Target;
+/**
+ * Parses a target string into {project, target, configuration}
+ *
+ * Examples:
+ * ```typescript
+ * parseTargetString("proj:test", graph) // returns { project: "proj", target: "test" }
+ * parseTargetString("proj:test:production", graph) // returns { project: "proj", target: "test", configuration: "production" }
+ * ```
+ *
+ * @param targetString - target reference
+ */
+export declare function parseTargetString(targetString: string, projectGraph: ProjectGraph): Target;
+/**
+ * Parses a target string into {project, target, configuration}. Passing a full
+ * {@link ExecutorContext} enables the targetString to reference the current project.
+ *
+ * Examples:
+ * ```typescript
+ * parseTargetString("test", executorContext) // returns { project: "proj", target: "test" }
+ * parseTargetString("proj:test", executorContext) // returns { project: "proj", target: "test" }
+ * parseTargetString("proj:test:production", executorContext) // returns { project: "proj", target: "test", configuration: "production" }
+ * ```
+ */
+export declare function parseTargetString(targetString: string, ctx: ExecutorContext): Target;
+/**
+ * Returns a string in the format "project:target[:configuration]" for the target
+ *
+ * @param target - target object
+ *
+ * Examples:
+ *
+ * ```typescript
+ * targetToTargetString({ project: "proj", target: "test" }) // returns "proj:test"
+ * targetToTargetString({ project: "proj", target: "test", configuration: "production" }) // returns "proj:test:production"
+ * ```
+ */
+export declare function targetToTargetString({ project, target, configuration, }: Target): string;

package/src/executors/parse-target-string.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.targetToTargetString = exports.parseTargetString = void 0;
+const nx_1 = require("../../nx");
+let { readCachedProjectGraph, splitTarget, splitByColons } = (0, nx_1.requireNx)();
+// TODO: Remove this in Nx 19 when Nx 16.7.0 is no longer supported
+splitTarget = splitTarget ?? require('nx/src/utils/split-target').splitTarget;
+splitByColons =
+    splitByColons ?? ((s) => s.split(':'));
+function parseTargetString(targetString, projectGraphOrCtx) {
+    let projectGraph = projectGraphOrCtx && 'projectGraph' in projectGraphOrCtx
+        ? projectGraphOrCtx.projectGraph
+        : projectGraphOrCtx;
+    if (!projectGraph) {
+        try {
+            projectGraph = readCachedProjectGraph();
+        }
+        catch (e) {
+            projectGraph = { nodes: {} };
+        }
+    }
+    const [maybeProject] = splitByColons(targetString);
+    if (!projectGraph.nodes[maybeProject] &&
+        projectGraphOrCtx &&
+        'projectName' in projectGraphOrCtx &&
+        maybeProject !== projectGraphOrCtx.projectName) {
+        targetString = `${projectGraphOrCtx.projectName}:${targetString}`;
+    }
+    const [project, target, configuration] = splitTarget(targetString, projectGraph);
+    if (!project || !target) {
+        throw new Error(`Invalid Target String: ${targetString}`);
+    }
+    return {
+        project,
+        target,
+        configuration,
+    };
+}
+exports.parseTargetString = parseTargetString;
+/**
+ * Returns a string in the format "project:target[:configuration]" for the target
+ *
+ * @param target - target object
+ *
+ * Examples:
+ *
+ * ```typescript
+ * targetToTargetString({ project: "proj", target: "test" }) // returns "proj:test"
+ * targetToTargetString({ project: "proj", target: "test", configuration: "production" }) // returns "proj:test:production"
+ * ```
+ */
+function targetToTargetString({ project, target, configuration, }) {
+    return `${project}:${target.indexOf(':') > -1 ? `"${target}"` : target}${configuration !== undefined ? ':' + configuration : ''}`;
+}
+exports.targetToTargetString = targetToTargetString;

package/src/executors/read-target-options.d.ts

@@ -0,0 +1,8 @@
+import type { Target } from 'nx/src/command-line/run/run';
+import type { ExecutorContext } from 'nx/src/config/misc-interfaces';
+/**
+ * Reads and combines options for a given target.
+ *
+ * Works as if you invoked the target yourself without passing any command lint overrides.
+ */
+export declare function readTargetOptions<T = any>({ project, target, configuration }: Target, context: ExecutorContext): T;

package/src/executors/read-target-options.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readTargetOptions = void 0;
+const nx_1 = require("../../nx");
+const path_1 = require("path");
+let { Workspaces, getExecutorInformation, calculateDefaultProjectName, combineOptionsForExecutor, } = (0, nx_1.requireNx)();
+// TODO: Remove this in Nx 19 when Nx 16.7.0 is no longer supported
+combineOptionsForExecutor =
+    combineOptionsForExecutor ??
+        require('nx/src/utils/params').combineOptionsForExecutor;
+/**
+ * Reads and combines options for a given target.
+ *
+ * Works as if you invoked the target yourself without passing any command lint overrides.
+ */
+function readTargetOptions({ project, target, configuration }, context) {
+    const projectConfiguration = (context.workspace || context.projectsConfigurations).projects[project];
+    if (!projectConfiguration) {
+        throw new Error(`Unable to find project ${project}`);
+    }
+    const targetConfiguration = projectConfiguration.targets[target];
+    if (!targetConfiguration) {
+        throw new Error(`Unable to find target ${target} for project ${project}`);
+    }
+    // TODO(v19): remove Workspaces.
+    const ws = new Workspaces(context.root);
+    const [nodeModule, executorName] = targetConfiguration.executor.split(':');
+    const { schema } = getExecutorInformation
+        ? getExecutorInformation(nodeModule, executorName, context.root, context.projectsConfigurations?.projects ?? context.workspace.projects)
+        : // TODO(v19): remove readExecutor. This is to be backwards compatible with Nx 16.5 and below.
+            ws.readExecutor(nodeModule, executorName);
+    const defaultProject = calculateDefaultProjectName
+        ? calculateDefaultProjectName(context.cwd, context.root, { version: 2, projects: context.projectsConfigurations.projects }, context.nxJsonConfiguration)
+        : // TODO(v19): remove calculateDefaultProjectName. This is to be backwards compatible with Nx 16.5 and below.
+            ws.calculateDefaultProjectName(context.cwd, { version: 2, projects: context.projectsConfigurations.projects }, context.nxJsonConfiguration);
+    return combineOptionsForExecutor({}, configuration ?? targetConfiguration.defaultConfiguration ?? '', targetConfiguration, schema, defaultProject, (0, path_1.relative)(context.root, context.cwd));
+}
+exports.readTargetOptions = readTargetOptions;

package/src/generators/add-build-target-defaults.d.ts

@@ -0,0 +1,2 @@
+import type { Tree } from 'nx/src/devkit-exports';
+export declare function addBuildTargetDefaults(tree: Tree, executorName: string, buildTargetName?: string): void;

package/src/generators/add-build-target-defaults.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addBuildTargetDefaults = void 0;
+const nx_1 = require("../../nx");
+const { readNxJson, updateNxJson } = (0, nx_1.requireNx)();
+function addBuildTargetDefaults(tree, executorName, buildTargetName = 'build') {
+    const nxJson = readNxJson(tree);
+    nxJson.targetDefaults ??= {};
+    nxJson.targetDefaults[executorName] ??= {
+        cache: true,
+        dependsOn: [`^${buildTargetName}`],
+        inputs: nxJson.namedInputs && 'production' in nxJson.namedInputs
+            ? ['production', '^production']
+            : ['default', '^default'],
+    };
+    updateNxJson(tree, nxJson);
+}
+exports.addBuildTargetDefaults = addBuildTargetDefaults;

package/src/generators/artifact-name-and-directory-utils.d.ts

@@ -0,0 +1,48 @@
+import type { Tree } from 'nx/src/generators/tree';
+export type NameAndDirectoryFormat = 'as-provided' | 'derived';
+export type ArtifactGenerationOptions = {
+    artifactType: string;
+    callingGenerator: string | null;
+    name: string;
+    directory?: string;
+    disallowPathInNameForDerived?: boolean;
+    fileExtension?: 'js' | 'jsx' | 'ts' | 'tsx' | 'vue';
+    fileName?: string;
+    flat?: boolean;
+    nameAndDirectoryFormat?: NameAndDirectoryFormat;
+    pascalCaseDirectory?: boolean;
+    pascalCaseFile?: boolean;
+    project?: string;
+    suffix?: string;
+    derivedDirectory?: string;
+};
+export type NameAndDirectoryOptions = {
+    /**
+     * Normalized artifact name.
+     */
+    artifactName: string;
+    /**
+     * Normalized directory path where the artifact will be generated.
+     */
+    directory: string;
+    /**
+     * Normalized file name of the artifact without the extension.
+     */
+    fileName: string;
+    /**
+     * Normalized full file path of the artifact.
+     */
+    filePath: string;
+    /**
+     * Project name where the artifact will be generated.
+     */
+    project: string;
+};
+export declare function determineArtifactNameAndDirectoryOptions(tree: Tree, options: ArtifactGenerationOptions): Promise<NameAndDirectoryOptions & {
+    nameAndDirectoryFormat: NameAndDirectoryFormat;
+}>;
+export declare function getRelativeCwd(): string;
+/**
+ * Function for setting cwd during testing
+ */
+export declare function setCwd(path: string): void;