Nx Angular Generators Derived

A wrapper for Angular generators in Nx that simplifies component and other element creation, maintaining compatibility with the previous "derived" behavior.

✨ Features

• Simplifies Nx Angular generator syntax
• Supports component, library, and other Angular generators
• Automatically duplicates the last path segment for component name
• Automatically adds .module.ts to module names
• Compatible with Nx 20+

📦 Installation

npm install @jcendal/nx-angular-generators-derived

📚 Usage

Generate a component

Instead of using the full Nx command:

npx nx g @nx/angular:component libs/shared/ui/toasts/src/lib/component-name/component-name --name=component-name --module=ui-toasts.module.ts

You can use the simplified syntax:

npm run g component libs/shared/ui/toasts/src/lib/component-name --module=ui-toasts

Generate a library

Instead of using the full Nx command:

npx nx g @nx/angular:library libs/shared/asd

You can use the simplified syntax:

npm run g library libs/shared/asd

With import path prefix (optional):

npm run g library libs/shared/library --importPathPrefix=@myorg

This will be converted to --importPath=@myorg/shared/library in the Nx command (prefix + path without libs/). If --importPathPrefix is not provided or is empty, no --importPath option will be added to the command.

Automatic transformation

The wrapper automatically converts:

• Input: npm run g component <path> --module=<module-name>

• Output: npx nx g @nx/angular:component <path>/<last-segment> --name=<last-segment> --module=<module-name>.module.ts

• Input: npm run g library <path>

• Output: npx nx g @nx/angular:library <path>

• Input: npm run g library <path> --importPathPrefix=<prefix>

• Output: npx nx g @nx/angular:library <path> --importPath=<prefix>/<path-without-libs>

Complete examples

# Simplified command for component
npm run g component libs/shared/ui/toasts/src/lib/component-name --module=ui-toasts

# Executed internally as:
# npx nx g @nx/angular:component libs/shared/ui/toasts/src/lib/component-name/component-name --name=component-name --module=ui-toasts.module.ts

# Simplified command for library
npm run g library libs/shared/asd

# Executed internally as:
# npx nx g @nx/angular:library libs/shared/asd

# Simplified command for library with import path prefix
npm run g library libs/shared/library --importPathPrefix=@myorg

# Executed internally as:
# npx nx g @nx/angular:library libs/shared/asd --importPath=@myorg/ui/shared/asd

🛠 API

g script

The g script accepts the following arguments:

• <generator-type>: Generator type (e.g., component, library, service, etc.)
• <path>: Path where the element will be generated
• [--option=value]: Additional options for the generator

Special behavior

• Components and other generators: Automatically duplicates the last path segment and adds --name option
• Library: Uses the path as-is without modification
• --module option: Automatically adds .module.ts to the end of the module name
• --importPathPrefix option (library only, optional): If provided and non-empty, combines the prefix with the path (without libs/) to create --importPath. Example: libs/shared/library with prefix @myorg becomes @myorg/shared/library. If not provided or empty, no --importPath option is added.

⚙️ Configuration

Make sure you have @nx/angular installed in your Nx project:

npm install -D @nx/angular

📄 License

MIT – Feel free to use, modify, and distribute.