@alevnyacow/nzmt 0.40.2 → 0.41.0

package/README.md

@@ -8,7 +8,7 @@
   <img src='https://img.shields.io/npm/l/%40alevnyacow%2Fnzmt'></img>
 </p>
 
-Scaffold full-stack modules in Next.js in seconds with **Next Zod Modules Toolkit (NZMT)**. 
+Scaffold Next.js full-stack modules in seconds with **Next Zod Modules Toolkit (NZMT)**. 
 
 Get a domain-focused architecture with a contract-first approach out of the box.
 
@@ -23,8 +23,8 @@ https://stackblitz.com/edit/nzmt-playground
 
 # What you get
 
-Get production-ready backend + React Query hooks after one CLI command with NZMT. Install and initialize it, then run:
- 
+After installing and initializing NZMT, run one CLI command to generate a production-ready backend with React Query hooks:
+
 ```bash
 npx nzmt crud-api user
 ```
@@ -43,18 +43,10 @@ app/api/user/... # api routes
 ui/shared/queries/user/... # react queries
 ```
 
-Everything is already setup and ready-to-use after a few tweaks. See `Quick start with Prisma` section for more detailed information.
-
-NZMT also comes with useful infrastructure like DI, logging, in-memory stores, unified errors, and endpoint guards. All code is editable, so you stay in full control. Full `crud-api` is only one of cases, you can scaffold entities, stores, services, controllers and infrastructure helpers on its own and combine them any way you want. List of all NZMT cli commands is provided in `CLI commands glossary` sections.
+Features DI, logging, in-memory stores, unified errors, and endpoint guards. Everything is ready after a few tweaks — see `Quick start with Prisma` for details.
 
-Fully wired flow:
-```bash
-# client fetching
-Client → React Query → API → Controller → Service → Store → DB
+All code is editable — scaffold parts individually or together. CLI commands are listed in `CLI commands glossary`. 
 
-# server actions
-Server Action → Service → Store → DB
-```
 
 # Quick start with Prisma
 

package/bin/cli.js

@@ -112,7 +112,8 @@ function createDefaultConfig() {
                 valueObjects: '/domain/value-objects',
                 sharedErrors: '/domain/errors',
                 queries: '/ui/shared/queries',
-                clientUtils: '/ui/shared/utils'
+                clientUtils: '/ui/shared/utils',
+                widgets: '/ui/widgets'
             },
             store: {
                 prisma: {
@@ -135,7 +136,8 @@ function createDefaultConfig() {
                 valueObjects: '/domain/value-objects',
                 sharedErrors: '/domain/errors',
                 queries: '/ui/shared/queries',
-                clientUtils: '/ui/shared/utils'
+                clientUtils: '/ui/shared/utils',
+                widgets: '/ui/widgets'
             },
             services: {
                 defaultInjections: []
@@ -1430,3 +1432,40 @@ if (command.toLowerCase() === 'crud-api') {
     process.exit(0)
 }
 
+function generateWidget(name, rootPath) {
+    const [lowerCase, upperCase] = camelizeVariants(name)
+
+    const widgetsPath = config.paths.widgets
+    const root = findProjectRoot()
+
+    const folder = path.resolve(root, widgetsPath, rootPath ?? '.', name)
+    fs.mkdirSync(folder, { recursive: true })
+
+    fs.writeFileSync(path.resolve(folder, `${lowerCase}.widget.tsx`), [
+        `import { FC } from 'react'`,
+        `import styles from './${lowerCase}.widget.module.css'`,
+        ``,
+        `export type ${upperCase}WidgetProps = {}`,
+        ``,
+        `export const ${upperCase}Widget: FC<${upperCase}WidgetProps> = ({ }) => {`,
+        `\treturn undefined`,
+        `}`
+    ].join('\n'))
+
+    fs.writeFileSync(path.resolve(folder, `${lowerCase}.widget.module.css`), [
+       ''
+    ].join('\n'))
+
+    fs.writeFileSync(path.resolve(folder, `index.ts`), [
+        `export * from './${name}.widget'`
+    ].join('\n'))
+}
+
+if (command === 'w') {
+    let rootPath = undefined
+    const rootPathOption = (options ?? []).find(x => x.startsWith('root:'))
+    if (rootPathOption) {
+        rootPath = rootPathOption.split(':')[1]
+    }
+    generateWidget(entityName, rootPath)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alevnyacow/nzmt",
-  "version": "0.40.2",
+  "version": "0.41.0",
   "description": "Next Zod Modules Toolkit",
   "keywords": ["next", "full-stack", "server", "backend", "cli", "scaffolding", "zod", "rest", "contract programming", "contract-first", "react-query", "ddd", "domain-driven"],
   "repository": {