@ronas-it/nx-generators 0.15.0-alpha.0 → 0.15.0-alpha.1

package/README.md

@@ -1,6 +1,28 @@
 # Nx Generators
 
-Nx generators for Ronas IT projects.
+This package provides a set of [Nx](https://nx.dev/getting-started/intro) generators that help maintain a consistent project structure, enforce best practices, and automate common development tasks. It is designed to streamline and standardize the development workflow for monorepos with React Native and/or Next.js apps.
+
+## Features
+
+- **Automated setup**: Quick setup of new projects with pre-configured [best practices](#best-practices)
+- **Cross-platform support**: Generators for both web (Next.js) and mobile (RN Expo) applications
+- **Code quality tools**: Built-in configuration for ESLint, Prettier, and TypeScript pre-commit checks
+- **Library management**: Tools for creating, moving, renaming, and managing libraries with pre-defined boundaries
+- **Component generation**: Automated creation of components, form interaction, and other utility tools
+- **Data access setup**: State management and API interaction setup using [Redux Toolkit](https://redux-toolkit.js.org/) and [RTKQ Entity API](https://github.com/RonasIT/rtkq-entity-api)
+- **Internationalization**: Built-in support for i18n in both Next.js and RN Expo applications
+
+See full list of generators [below](#generators-overview).
+
+## Best Practices
+
+The generators enforce several best practices according to [Nx concepts](https://nx.dev/concepts/decisions):
+
+- Scalable [monorepo organization](https://nx.dev/concepts/decisions/why-monorepos)
+- Consistent [project structure](https://nx.dev/concepts/decisions/folder-structure)
+- Clear [libraries hierarchy](https://nx.dev/concepts/decisions/project-dependency-rules)
+- Proper [module boundaries](https://nx.dev/features/enforce-module-boundaries)
+- Streamlined [dependency management](https://nx.dev/concepts/decisions/dependency-management)
 
 ## Usage
 
@@ -120,7 +142,7 @@ npx nx g next-app my-app web
 
 ### 5. `react-lib`
 
-Generates a library according to [Nx notation](https://nx.dev/concepts/more-concepts/applications-and-libraries).
+Generates a library according to [Nx notation](https://nx.dev/concepts/decisions/project-dependency-rules).
 
 #### Options
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ronas-it/nx-generators",
-  "version": "0.15.0-alpha.0",
+  "version": "0.15.0-alpha.1",
   "description": "Nx generators for Ronas IT projects",
   "license": "MIT",
   "author": "Ronas IT",

package/src/shared/dependencies.d.ts

@@ -19,6 +19,7 @@ export declare const dependencies: {
     'next-app': {
         'next-intl': string;
         'lodash-es': string;
+        'class-transformer': string;
     };
     'api-client': {
         '@ronas-it/axios-api-client': string;

package/src/shared/dependencies.js

@@ -24,6 +24,7 @@ exports.dependencies = {
     'next-app': {
         'next-intl': '^3.26.3',
         'lodash-es': '^4.17.21',
+        'class-transformer': '^0.5.1',
     },
     'api-client': {
         '@ronas-it/axios-api-client': '^0.1.0',

package/src/shared/dependencies.js.map

@@ -1 +1 @@
-{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../../../plugin/src/shared/dependencies.ts"],"names":[],"mappings":";;;AAAa,QAAA,YAAY,GAAG;IAC1B,UAAU,EAAE;QACV,uCAAuC,EAAE,QAAQ;QACjD,mBAAmB,EAAE,QAAQ;QAC7B,gBAAgB,EAAE,SAAS;QAC3B,iBAAiB,EAAE,QAAQ;QAC3B,aAAa,EAAE,SAAS;QACxB,gCAAgC,EAAE,SAAS;QAC3C,sBAAsB,EAAE,QAAQ;QAChC,cAAc,EAAE,QAAQ;QACxB,iBAAiB,EAAE,QAAQ;QAC3B,cAAc,EAAE,UAAU;QAC1B,eAAe,EAAE,QAAQ;QACzB,WAAW,EAAE,UAAU;KACxB;IACD,eAAe,EAAE;QACf,sCAAsC;QACtC,yEAAyE;QACzE,8BAA8B,EAAE,QAAQ;KACzC;IACD,UAAU,EAAE;QACV,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,UAAU;KACxB;IACD,YAAY,EAAE;QACZ,4BAA4B,EAAE,QAAQ;KACvC;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,QAAQ;KAChB;IACD,WAAW,EAAE;QACX,kCAAkC,EAAE,SAAS;KAC9C;IACD,KAAK,EAAE;QACL,2BAA2B,EAAE,QAAQ;QACrC,aAAa,EAAE,QAAQ;KACxB;IACD,WAAW,EAAE;QACX,iBAAiB,EAAE,QAAQ;QAC3B,uBAAuB,EAAE,QAAQ;KAClC;IACD,IAAI,EAAE;QACJ,qBAAqB,EAAE,QAAQ;QAC/B,iBAAiB,EAAE,SAAS;QAC5B,GAAG,EAAE,QAAQ;KACd;IACD,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,sBAAsB,EAAE,QAAQ;SACjC;QACD,IAAI,EAAE;YACJ,gBAAgB,EAAE,SAAS;SAC5B;KACF;CACF,CAAC;AAEW,QAAA,eAAe,GAAG;IAC7B,aAAa,EAAE;QACb,gBAAgB,EAAE,QAAQ;QAC1B,kBAAkB,EAAE,QAAQ;QAC5B,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,QAAQ;QAClB,wBAAwB,EAAE,QAAQ;QAClC,mCAAmC,EAAE,QAAQ;QAC7C,sBAAsB,EAAE,SAAS;QACjC,wBAAwB,EAAE,QAAQ;QAClC,qBAAqB,EAAE,SAAS;QAChC,2BAA2B,EAAE,QAAQ;QACrC,8BAA8B,EAAE,QAAQ;QACxC,KAAK,EAAE,QAAQ;QACf,0BAA0B,EAAE,SAAS;QACrC,kCAAkC,EAAE,SAAS;QAC7C,2BAA2B,EAAE,SAAS;QACtC,WAAW,EAAE,QAAQ;KACtB;IACD,UAAU,EAAE;QACV,kBAAkB,EAAE,UAAU;KAC/B;IACD,eAAe,EAAE;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,UAAU,EAAE;QACV,wDAAwD;QACxD,oBAAoB,EAAE,SAAS;QAC/B,kBAAkB,EAAE,UAAU;KAC/B;IACD,aAAa,EAAE;QACb,QAAQ,EAAE,SAAS;KACpB;IACD,IAAI,EAAE;QACJ,cAAc,EAAE,OAAO;KACxB;CACF,CAAC"}
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../../../plugin/src/shared/dependencies.ts"],"names":[],"mappings":";;;AAAa,QAAA,YAAY,GAAG;IAC1B,UAAU,EAAE;QACV,uCAAuC,EAAE,QAAQ;QACjD,mBAAmB,EAAE,QAAQ;QAC7B,gBAAgB,EAAE,SAAS;QAC3B,iBAAiB,EAAE,QAAQ;QAC3B,aAAa,EAAE,SAAS;QACxB,gCAAgC,EAAE,SAAS;QAC3C,sBAAsB,EAAE,QAAQ;QAChC,cAAc,EAAE,QAAQ;QACxB,iBAAiB,EAAE,QAAQ;QAC3B,cAAc,EAAE,UAAU;QAC1B,eAAe,EAAE,QAAQ;QACzB,WAAW,EAAE,UAAU;KACxB;IACD,eAAe,EAAE;QACf,sCAAsC;QACtC,yEAAyE;QACzE,8BAA8B,EAAE,QAAQ;KACzC;IACD,UAAU,EAAE;QACV,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,UAAU;QACvB,mBAAmB,EAAE,QAAQ;KAC9B;IACD,YAAY,EAAE;QACZ,4BAA4B,EAAE,QAAQ;KACvC;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,QAAQ;KAChB;IACD,WAAW,EAAE;QACX,kCAAkC,EAAE,SAAS;KAC9C;IACD,KAAK,EAAE;QACL,2BAA2B,EAAE,QAAQ;QACrC,aAAa,EAAE,QAAQ;KACxB;IACD,WAAW,EAAE;QACX,iBAAiB,EAAE,QAAQ;QAC3B,uBAAuB,EAAE,QAAQ;KAClC;IACD,IAAI,EAAE;QACJ,qBAAqB,EAAE,QAAQ;QAC/B,iBAAiB,EAAE,SAAS;QAC5B,GAAG,EAAE,QAAQ;KACd;IACD,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,sBAAsB,EAAE,QAAQ;SACjC;QACD,IAAI,EAAE;YACJ,gBAAgB,EAAE,SAAS;SAC5B;KACF;CACF,CAAC;AAEW,QAAA,eAAe,GAAG;IAC7B,aAAa,EAAE;QACb,gBAAgB,EAAE,QAAQ;QAC1B,kBAAkB,EAAE,QAAQ;QAC5B,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,QAAQ;QAClB,wBAAwB,EAAE,QAAQ;QAClC,mCAAmC,EAAE,QAAQ;QAC7C,sBAAsB,EAAE,SAAS;QACjC,wBAAwB,EAAE,QAAQ;QAClC,qBAAqB,EAAE,SAAS;QAChC,2BAA2B,EAAE,QAAQ;QACrC,8BAA8B,EAAE,QAAQ;QACxC,KAAK,EAAE,QAAQ;QACf,0BAA0B,EAAE,SAAS;QACrC,kCAAkC,EAAE,SAAS;QAC7C,2BAA2B,EAAE,SAAS;QACtC,WAAW,EAAE,QAAQ;KACtB;IACD,UAAU,EAAE;QACV,kBAAkB,EAAE,UAAU;KAC/B;IACD,eAAe,EAAE;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,UAAU,EAAE;QACV,wDAAwD;QACxD,oBAAoB,EAAE,SAAS;QAC/B,kBAAkB,EAAE,UAAU;KAC/B;IACD,aAAa,EAAE;QACb,QAAQ,EAAE,SAAS;KACpB;IACD,IAAI,EAAE;QACJ,cAAc,EAAE,OAAO;KACxB;CACF,CAAC"}

package/src/shared/generators/navigation-utils/{next-app-lib-files/shared/utils/navigation → filtering-search-params-lib-files/shared/utils/filtering-search-params}/src/lib/hooks/use-filtering-search-params.ts.template

@@ -8,7 +8,7 @@ interface FilteringSearchParamsConfig<TParams> {
 }
 
 export const useFilteringSearchParams = <TParams extends FilteringSearchParams>({
-  searchParamsConstructor
+  searchParamsConstructor,
 }: FilteringSearchParamsConfig<TParams>): typeof result => {
   const initialParams = useRef<TParams | null>(null);
   const searchParams = useSearchParams();
@@ -18,16 +18,30 @@ export const useFilteringSearchParams = <TParams extends FilteringSearchParams>(
   const getSearchParams = useCallback((): TParams => {
     const initialParams = {} as Record<string, any>;
     searchParams.forEach((value, key) => {
+      let parsedValue: any;
+
       try {
-        initialParams[key] = JSON.parse(value);
+        parsedValue = JSON.parse(value);
       } catch {
-        initialParams[key] = value;
+        parsedValue = value;
+      }
+
+      if (key in initialParams) {
+        if (Array.isArray(initialParams[key])) {
+          if (!initialParams[key].includes(parsedValue)) {
+            initialParams[key].push(parsedValue);
+          }
+        } else {
+          initialParams[key] = [...new Set([initialParams[key], parsedValue])];
+        }
+      } else {
+        initialParams[key] = parsedValue;
       }
     });
 
     return plainToInstance(searchParamsConstructor, initialParams, {
       excludeExtraneousValues: true,
-      exposeUnsetFields: false
+      exposeUnsetFields: false,
     });
   }, [searchParams]);
 
@@ -39,8 +53,15 @@ export const useFilteringSearchParams = <TParams extends FilteringSearchParams>(
       Object.keys(plainParams).forEach((field) => {
         const value = plainParams[field];
 
-        if (value !== null && value !== undefined && !(Array.isArray(value) && value.length === 0)) {
-          newSearchParams.set(field, JSON.stringify(value));
+        if (value !== null && value !== undefined) {
+          if (Array.isArray(value)) {
+            const uniqueValues = new Set(value);
+            uniqueValues.forEach((item) => {
+              newSearchParams.append(field, JSON.stringify(item));
+            });
+          } else {
+            newSearchParams.set(field, JSON.stringify(value));
+          }
         }
       });
 
@@ -54,7 +75,7 @@ export const useFilteringSearchParams = <TParams extends FilteringSearchParams>(
 
   const result = {
     initialSearchParams: initialParams.current,
-    setSearchParams
+    setSearchParams,
   };
 
   return result;

package/src/shared/generators/navigation-utils/filtering-search-params-lib-files/shared/utils/filtering-search-params/src/lib/index.ts.template

@@ -0,0 +1,2 @@
+export * from './hooks';
+export * from './types';

package/src/shared/generators/navigation-utils/generator.js

@@ -2,27 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runNavigationUtilsGenerator = void 0;
 const tslib_1 = require("tslib");
-const child_process_1 = require("child_process");
-const path = require("path");
-const devkit_1 = require("@nx/devkit");
 const enums_1 = require("../../enums");
-const utils_1 = require("../../utils");
+const utils_1 = require("./utils");
 function runNavigationUtilsGenerator(tree, options) {
     return tslib_1.__awaiter(this, void 0, void 0, function* () {
-        const libRoot = `libs/${options.appDirectory}`;
-        // Generate shared libs
-        (0, child_process_1.execSync)(`npx nx g react-lib --app=${options.appDirectory} --scope=shared --type=utils --name=navigation`, {
-            stdio: 'inherit',
-        });
-        // Remove unnecessary files and files that will be replaced
-        const libPath = `${libRoot}/shared/utils/navigation/src`;
-        tree.delete(`${libPath}/index.ts`);
-        // Add lib files
-        (0, devkit_1.generateFiles)(tree, path.join(__dirname, '/common-lib-files'), libRoot, {});
-        if (options.baseGeneratorType === enums_1.BaseGeneratorType.NEXT_APP) {
-            (0, devkit_1.generateFiles)(tree, path.join(__dirname, '/next-app-lib-files'), libRoot, {});
-            const newIndexContent = `export * from './hooks';\nexport * from './types';`;
-            (0, utils_1.appendFileContent)(`${libPath}/lib/index.ts`, newIndexContent, tree);
+        const { appDirectory, baseGeneratorType } = options;
+        (0, utils_1.setupLib)(tree, appDirectory, 'navigation');
+        if (baseGeneratorType === enums_1.BaseGeneratorType.NEXT_APP) {
+            (0, utils_1.setupLib)(tree, appDirectory, 'filtering-search-params');
         }
     });
 }

package/src/shared/generators/navigation-utils/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../plugin/src/shared/generators/navigation-utils/generator.ts"],"names":[],"mappings":";;;;AAAA,iDAAyC;AACzC,6BAA6B;AAC7B,uCAAiD;AACjD,uCAAgD;AAChD,uCAAgD;AAGhD,SAAsB,2BAA2B,CAAC,IAAU,EAAE,OAAuC;;QACnG,MAAM,OAAO,GAAG,QAAQ,OAAO,CAAC,YAAY,EAAE,CAAC;QAE/C,uBAAuB;QACvB,IAAA,wBAAQ,EAAC,4BAA4B,OAAO,CAAC,YAAY,gDAAgD,EAAE;YACzG,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QAEH,2DAA2D;QAC3D,MAAM,OAAO,GAAG,GAAG,OAAO,8BAA8B,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,GAAG,OAAO,WAAW,CAAC,CAAC;QAEnC,gBAAgB;QAChB,IAAA,sBAAa,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAE5E,IAAI,OAAO,CAAC,iBAAiB,KAAK,yBAAiB,CAAC,QAAQ,EAAE,CAAC;YAC7D,IAAA,sBAAa,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;YAE9E,MAAM,eAAe,GAAG,oDAAoD,CAAC;YAC7E,IAAA,yBAAiB,EAAC,GAAG,OAAO,eAAe,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;CAAA;AArBD,kEAqBC;AAED,kBAAe,2BAA2B,CAAC"}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../plugin/src/shared/generators/navigation-utils/generator.ts"],"names":[],"mappings":";;;;AACA,uCAAgD;AAEhD,mCAAmC;AAEnC,SAAsB,2BAA2B,CAAC,IAAU,EAAE,OAAuC;;QACnG,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC;QAEpD,IAAA,gBAAQ,EAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;QAE3C,IAAI,iBAAiB,KAAK,yBAAiB,CAAC,QAAQ,EAAE,CAAC;YACrD,IAAA,gBAAQ,EAAC,IAAI,EAAE,YAAY,EAAE,yBAAyB,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;CAAA;AARD,kEAQC;AAED,kBAAe,2BAA2B,CAAC"}

package/src/shared/generators/navigation-utils/navigation-lib-files/shared/utils/navigation/src/index.ts.template

@@ -0,0 +1 @@
+export * from './lib';

package/src/shared/generators/navigation-utils/utils/index.d.ts

@@ -0,0 +1 @@
+export * from './setup-lib';

package/src/shared/generators/navigation-utils/utils/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./setup-lib"), exports);
+//# sourceMappingURL=index.js.map

package/src/shared/generators/navigation-utils/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../plugin/src/shared/generators/navigation-utils/utils/index.ts"],"names":[],"mappings":";;;AAAA,sDAA4B"}

package/src/shared/generators/navigation-utils/utils/setup-lib.d.ts

@@ -0,0 +1,2 @@
+import { Tree } from '@nx/devkit';
+export declare function setupLib(tree: Tree, appDirectory: string, libName: string): void;

package/src/shared/generators/navigation-utils/utils/setup-lib.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupLib = void 0;
+const child_process_1 = require("child_process");
+const path = require("path");
+const devkit_1 = require("@nx/devkit");
+function setupLib(tree, appDirectory, libName) {
+    (0, child_process_1.execSync)(`npx nx g react-lib --app=${appDirectory} --scope=shared --type=utils --name=${libName}`, {
+        stdio: 'inherit',
+    });
+    const libRoot = `libs/${appDirectory}`;
+    const libPath = `${libRoot}/shared/utils/${libName}/src`;
+    tree.delete(`${libPath}/index.ts`);
+    (0, devkit_1.generateFiles)(tree, path.join(__dirname, `../${libName}-lib-files`), libRoot, {});
+}
+exports.setupLib = setupLib;
+//# sourceMappingURL=setup-lib.js.map

package/src/shared/generators/navigation-utils/utils/setup-lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-lib.js","sourceRoot":"","sources":["../../../../../../../plugin/src/shared/generators/navigation-utils/utils/setup-lib.ts"],"names":[],"mappings":";;;AAAA,iDAAyC;AACzC,6BAA6B;AAC7B,uCAAiD;AAEjD,SAAgB,QAAQ,CAAC,IAAU,EAAE,YAAoB,EAAE,OAAe;IACxE,IAAA,wBAAQ,EAAC,4BAA4B,YAAY,uCAAuC,OAAO,EAAE,EAAE;QACjG,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,QAAQ,YAAY,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,GAAG,OAAO,iBAAiB,OAAO,MAAM,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,GAAG,OAAO,WAAW,CAAC,CAAC;IAEnC,IAAA,sBAAa,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,OAAO,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AACpF,CAAC;AAVD,4BAUC"}