ngx-essentials-schematics 0.0.1

package/README.md

@@ -0,0 +1,28 @@
+# Getting Started With Schematics
+
+This repository is a basic Schematic implementation that serves as a starting point to create and publish Schematics to NPM.
+
+### Testing
+
+To test locally, install `@angular-devkit/schematics-cli` globally and use the `schematics` command line tool. That tool acts the same as the `generate` command of the Angular CLI, but also has a debug mode.
+
+Check the documentation with
+
+```bash
+schematics --help
+```
+
+### Unit Testing
+
+`npm run test` will run the unit tests, using Jasmine as a runner and test framework.
+
+### Publishing
+
+To publish, simply do:
+
+```bash
+npm run build
+npm publish
+```
+
+That's it!

package/dist/collection.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "../node_modules/@angular-devkit/schematics/collection-schema.json",
+  "schematics": {
+    "app-store": {
+      "description": "Adds NgRx Store to the Angular application with signal support.",
+      "factory": "./ngrx/store/index#signalStore",
+      "schema": "./ngrx/store/schema.json"
+    }
+  }
+}

package/dist/ngrx/store/files/__name@dasherize__.store.ts.template

@@ -0,0 +1,34 @@
+import { signalStore, withState, withMethods, withComputed, patchState } from '@ngrx/signals';
+import { withEntities } from '@ngrx/signals/entities';
+import { computed } from '@angular/core';
+import { EntityStatus } from '@shared/models/common.model';
+
+export interface <%= classify(name) %> {
+  cod: number;
+}
+
+const initialStatus: EntityStatus = {
+  loading: false,
+  error: null,
+};
+
+export const <%= classify(name) %>Store = signalStore(
+  { providedIn: 'root' },
+  withEntities<<%= classify(name) %>>(),
+  withState({
+    status: initialStatus,
+    selectedId: null as number | null,
+  }),
+  withComputed(({ entityMap, selectedId }) => ({
+    selectedEntity: computed(() => {
+      const id = selectedId();
+      return id ? entityMap()[id] : null;
+    }),
+  })),
+  withMethods((store) => ({
+    setLoading: (loading: boolean) =>
+      patchState(store, (state) => ({ status: { ...state.status, loading } })),
+    setError: (error: string | null) =>
+      patchState(store, (state) => ({ status: { ...state.status, error, loading: false } })),
+  }))
+);

package/dist/ngrx/store/index.d.ts

@@ -0,0 +1,8 @@
+import { Rule } from '@angular-devkit/schematics';
+import { SchemaOptions } from './schema';
+/**
+ * Genera un Signal Store profesional para Angular 20
+ * @param {SchemaOptions} options - Opciones del esquema
+ * @returns {Rule} - Una regla de esquema para generar el Signal Store
+ */
+export declare function signalStore(options: SchemaOptions): Rule;

package/dist/ngrx/store/index.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signalStore = signalStore;
+const core_1 = require("@angular-devkit/core");
+const schematics_1 = require("@angular-devkit/schematics");
+/**
+ * Genera un Signal Store profesional para Angular 20
+ * @param {SchemaOptions} options - Opciones del esquema
+ * @returns {Rule} - Una regla de esquema para generar el Signal Store
+ */
+function signalStore(options) {
+    return (tree) => {
+        const movePath = (0, core_1.normalize)(options.path || 'src/app/state');
+        // 1. Lógica para actualizar el index.ts (Barrel)
+        const indexPath = (0, core_1.join)(movePath, 'index.ts');
+        const exportLine = `export * from './${core_1.strings.dasherize(options.name)}.store';\n`;
+        if (tree.exists(indexPath)) {
+            const content = tree.read(indexPath).toString();
+            if (!content.includes(exportLine)) {
+                tree.overwrite(indexPath, content + exportLine);
+            }
+        }
+        else {
+            tree.create(indexPath, exportLine);
+        }
+        // 2. Lógica de generación del archivo .store.ts
+        const templateSource = (0, schematics_1.apply)((0, schematics_1.url)('./files'), [(0, schematics_1.applyTemplates)(Object.assign(Object.assign({}, core_1.strings), options)), (0, schematics_1.move)(movePath)]);
+        return (0, schematics_1.chain)([(0, schematics_1.mergeWith)(templateSource)]);
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/ngrx/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ngrx/store/index.ts"],"names":[],"mappings":";;AAUA,kCAsBC;AAhCD,+CAAgE;AAChE,2DAA4G;AAI5G;;;;GAIG;AACH,SAAgB,WAAW,CAAC,OAAsB;IAChD,OAAO,CAAC,IAAU,EAAE,EAAE;QACpB,MAAM,QAAQ,GAAG,IAAA,gBAAS,EAAC,OAAO,CAAC,IAAI,IAAI,eAAe,CAAC,CAAC;QAE5D,iDAAiD;QACjD,MAAM,SAAS,GAAG,IAAA,WAAI,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,oBAAoB,cAAO,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;QAEnF,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAE,CAAC,QAAQ,EAAE,CAAC;YACjD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACrC,CAAC;QAED,gDAAgD;QAChD,MAAM,cAAc,GAAG,IAAA,kBAAK,EAAC,IAAA,gBAAG,EAAC,SAAS,CAAC,EAAE,CAAC,IAAA,2BAAc,kCAAM,cAAO,GAAK,OAAO,EAAG,EAAE,IAAA,iBAAI,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAE3G,OAAO,IAAA,kBAAK,EAAC,CAAC,IAAA,sBAAS,EAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC;AACJ,CAAC"}

package/dist/ngrx/store/schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "SignalStoreSchematic",
+  "title": "Signal Store Schema",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Nombre de la entidad.",
+      "x-prompt": "¿Cómo se llama la entidad?",
+      "priority": 1
+    },
+    "path": {
+      "type": "string",
+      "description": "Ruta de destino.",
+      "default": "src/app/store"
+    }
+  },
+  "required": ["name"]
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "ngx-essentials-schematics",
+  "version": "0.0.1",
+  "description": "A collection of Angular schematics for essential functionalities.",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc -p tsconfig.json && copyfiles -u 1 \"src/**/*.json\" \"src/**/files/**/*\" dist/",
+    "test": "npm run build && jasmine src/**/*_spec.js",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist/**/*",
+    "src/*/schema.json",
+    "src/collection.json"
+  ],
+  "keywords": [
+    "schematics"
+  ],
+  "author": "",
+  "license": "MIT",
+  "schematics": "./src/collection.json",
+  "dependencies": {
+    "@angular-devkit/core": "^20.3.13",
+    "@angular-devkit/schematics": "^20.3.13",
+    "typescript": "~5.9.2"
+  },
+  "devDependencies": {
+    "@types/jasmine": "~5.1.0",
+    "@types/node": "^20.17.19",
+    "copyfiles": "^2.4.1",
+    "jasmine": "^5.0.0"
+  }
+}

package/src/collection.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "../node_modules/@angular-devkit/schematics/collection-schema.json",
+  "schematics": {
+    "app-store": {
+      "description": "Adds NgRx Store to the Angular application with signal support.",
+      "factory": "./ngrx/store/index#signalStore",
+      "schema": "./ngrx/store/schema.json"
+    }
+  }
+}