![\"ngx-autogen](\"./logo.png\"){kind=logo}
\n\n \n
\n πΊπΈ English | πͺπΈ EspaΓ±ol\n
\n\n\n ![\"npm](\"https://img.shields.io/npm/v/@barcidev/ngx-autogen?style=for-the-badge&color=007acc&labelColor=010101\")
![\"license\"](\"https://img.shields.io/npm/l/@barcidev/ngx-autogen?style=for-the-badge&color=green&labelColor=010101\")
![\"Angular](\"https://img.shields.io/badge/Angular-17%2B-DD0031?style=for-the-badge&logo=angular&labelColor=010101\"){kind=icon}
![\"NgRx](\"https://img.shields.io/badge/NgRx%20Signals-17%2B-BA2BD2?style=for-the-badge&logo=ngrx&labelColor=010101\"){kind=icon}
\n β‘ Angular schematics that scaffold complete NgRx Signal Store entities, Transloco i18n scopes, and standalone components in seconds. β‘\n
\n\n---\n\n## π Table of Contents\n\n- [Overview](#overview)\n- [Requirements](#requirements)\n- [Installation](#installation)\n - [Via ng add (recommended)](#via-ng-add-recommended)\n - [Via npm](#via-npm)\n- [Runtime Exports](#runtime-exports)\n- [Schematics Reference](#schematics-reference)\n - [ng-add](#ng-add)\n - [app-store](#app-store)\n - [app-i18n](#app-i18n)\n - [app-component](#app-component)\n- [License](#license)\n\n---\n\n## π Overview\n\n`@barcidev/ngx-autogen` is a collection of Angular schematics designed to eliminate repetitive scaffolding when building enterprise Angular applications. It generates production-ready code for three core concerns:\n\n- **NgRx Signal Store** (`app-store`) - Full CRUD signal store with entity management, pagination state, status tracking, and an accompanying service and model layer. Built on `@ngrx/signals` and `@ngrx/signals/entities`.\n- **Transloco i18n** (`app-i18n`) - Scoped translation files with typed Transloco integration via `@barcidev/typed-transloco`, automatic provider registration, and global type map updates.\n- **Angular Component** (`app-component`) - Standalone component generation via `@schematics/angular` with optional automatic store and i18n wiring.\n\nThe library also ships runtime utilities under `@barcidev/ngx-autogen/entity` that provide reusable NgRx Signal Store features: `withEntityStatus`, `withPagination`, and typed model helpers.\n\n---\n\n## π Requirements\n\n| Dependency | Minimum Version |\n|---|---|\n| `@angular/core` | `>=17.0.0` |\n| `@angular/common` | `>=17.0.0` |\n| `@angular/forms` | `>=17.0.0` |\n| `@ngrx/signals` | `>=17.0.0` |\n| Node.js | `>=16.0.0` |\n\n---\n\n## π Installation\n\n### Via ng add (recommended)\n\n```bash\nng add @barcidev/ngx-autogen\n```\n\nThis command performs the following actions automatically:\n\n1. **Moves the library to `devDependencies`** - If installed as a production dependency, it is relocated to `devDependencies` in `package.json`.\n2. **Registers the schematic collection** - Adds `@barcidev/ngx-autogen` to `cli.schematicCollections` in `angular.json`, enabling short-form aliases like `ng g app-store`.\n3. **Stores global configuration** - Saves the selected default language (`lang`) under `schematics[\"@barcidev/ngx-autogen:all\"]` in `angular.json` so all schematics inherit it.\n\n**Prompt:**\n\n| Prompt | Default |\n|---|---|\n| What is the default language for the application (en, es)? | `en` |\n\n### Via npm\n\n```bash\nnpm install @barcidev/ngx-autogen --save-dev\n```\n\n> [!NOTE]\n> When installing via npm, you must manually register the collection in `angular.json` and use the fully qualified schematic name (e.g., `ng generate @barcidev/ngx-autogen:app-store`).\n\n---\n\n## π οΈ Runtime Exports\n\nThe library exports reusable NgRx Signal Store features under the `@barcidev/ngx-autogen/entity` entry point:\n\n| Export | Description |\n|---|---|\n| `withEntityStatus()` | Signal Store feature that adds loading, error, and selection state tracking for entities. |\n| `withPagination()` | Signal Store feature that adds pagination state (page, size, total). |\n| `RequestConfig