@domain-first/project-structure 2.2.0 → 2.3.1

package/README.md

@@ -1,11 +1,54 @@
-# Domain-First Project Structure
+# @domain-first/project-structure
 
-Build and manage your Domain-First project structure with CLI.
+Stop hand-rolling folders. Scaffold a clean, consistent **Domain-First** architecture — bounded contexts, aggregates, use cases, commands/queries, ports, REST endpoints, React modules — with one command, every time.
 
-## Usage
+```bash
+npx df-ps
+```
+
+## Why
+
+- **Zero boilerplate** — aggregates, repositories, wiring and tests generated in seconds, correctly named and cross-linked
+- **One consistent architecture** — every bounded context, layer and file lands in the same place, no matter who on the team runs it
+- **Grows with your stack** — adapts output to whichever `@domain-first` packages (`types`, `errors`, `handlers`, `wire`, `handlers-rest`) you use, or stays framework-free if you don't
+- **Interactive, not magic** — a guided CLI menu, not a rigid template you fight against
+
+## Install
 
 ```bash
-npm i @domain-first/project-structure
+npm i -D @domain-first/project-structure
+```
+
+## Quick start
 
+```bash
 npx df-ps
 ```
+
+First run walks you through a short setup (source folder, packages, testing library) and writes a config file. Every run after that opens a menu to scaffold whatever you need next — a new aggregate, use case, endpoint, widget — into your existing structure.
+
+## What gets generated
+
+Pick a piece, get the whole slice — class, tests, infra implementation and wiring, all linked together:
+
+- **Domain** — aggregates, repositories, services, namespaced errors
+- **Application** — use cases, commands & queries (execution or orchestration), ports
+- **Infrastructure** — adapter implementations per port/repository (e.g. `prisma`, `in-memory`)
+- **Presentation** — REST endpoints, React pages/widgets
+
+Everything lands with consistent naming and imports. For example:
+
+```
+bounded-contexts/
+  order/
+    domain/aggregates/order/
+    application/use-cases/
+    application/commands/
+    infrastructure/repositories/
+    presentation/rest/
+    wiring/
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -360,6 +360,10 @@ const scaffoldNewApplicationPort = async (boundedContextFolder)=>{
         message: 'Name: '
     });
     const naming = new UnknownFormatNaming(name);
+    let scaffoldUnitTests;
+    if (ConfigFile.Instance.data.testingLibrary) scaffoldUnitTests = await (0, prompts_namespaceObject.confirm)({
+        message: 'Scaffold unit-tests'
+    });
     const wiringFolder = boundedContextFolder.subitem([
         'wiring',
         'ports'
@@ -373,8 +377,26 @@ export abstract class ${naming.ClassName} {
 
 }
             `.trim());
+    if (scaffoldUnitTests) applicationPortsFolder.createFile(`${naming.fileName}.spec.ts`, `
+import { define, test, expect, beforeEach } from '${ConfigFile.Instance.data.testingLibrary}'
+import { type ${naming.ClassName} } from './${naming.fileName}'
+import { wire${naming.ClassName} } from '../../wiring/ports/wire-${naming.fileName}'
+
+let ${naming.variableName}: ${naming.ClassName}
+
+beforeEach(() => {
+    ${naming.variableName} = wire${naming.ClassName}()
+})
+
+define('${naming.withSpaces}', () => {
+    test('can be wired', () => {
+        expect(${naming.variableName}).toBeDefined()
+    })
+})
+    `.trim());
     const implementationType = await (0, prompts_namespaceObject.input)({
-        message: 'Adapter implementation type:'
+        message: 'Adapter implementation type:',
+        default: 'api'
     });
     const addTestImplementation = await (0, prompts_namespaceObject.confirm)({
         message: 'With test implementation'

package/dist/index.js

@@ -330,6 +330,10 @@ const scaffoldNewApplicationPort = async (boundedContextFolder)=>{
         message: 'Name: '
     });
     const naming = new UnknownFormatNaming(name);
+    let scaffoldUnitTests;
+    if (ConfigFile.Instance.data.testingLibrary) scaffoldUnitTests = await prompts_confirm({
+        message: 'Scaffold unit-tests'
+    });
     const wiringFolder = boundedContextFolder.subitem([
         'wiring',
         'ports'
@@ -343,8 +347,26 @@ export abstract class ${naming.ClassName} {
 
 }
             `.trim());
+    if (scaffoldUnitTests) applicationPortsFolder.createFile(`${naming.fileName}.spec.ts`, `
+import { define, test, expect, beforeEach } from '${ConfigFile.Instance.data.testingLibrary}'
+import { type ${naming.ClassName} } from './${naming.fileName}'
+import { wire${naming.ClassName} } from '../../wiring/ports/wire-${naming.fileName}'
+
+let ${naming.variableName}: ${naming.ClassName}
+
+beforeEach(() => {
+    ${naming.variableName} = wire${naming.ClassName}()
+})
+
+define('${naming.withSpaces}', () => {
+    test('can be wired', () => {
+        expect(${naming.variableName}).toBeDefined()
+    })
+})
+    `.trim());
     const implementationType = await input({
-        message: 'Adapter implementation type:'
+        message: 'Adapter implementation type:',
+        default: 'api'
     });
     const addTestImplementation = await prompts_confirm({
         message: 'With test implementation'

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@domain-first/project-structure",
     "description": "Build and manage your Domain-First project structure with CLI",
-    "version": "2.2.0",
+    "version": "2.3.1",
     "type": "module",
     "repository": {
         "type": "git",