tshex-cli 1.0.21 → 1.0.22

package/README.md

@@ -70,29 +70,29 @@ The command creates this structure:
 
 ```text
 core/
-├── index.d.ts
-├── main.ts
-├── shared/
-│   ├── application/
-│   │   ├── data/
-│   │   │   ├── drivers.ts
-│   │   │   ├── managers.ts
-│   │   │   └── repositories.ts
-│   │   ├── events.ts
-│   │   ├── http.ts
-│   │   ├── loggers.ts
-│   │   ├── services.ts
-│   │   └── validations.ts
-│   └── domain/
-│       ├── aggregates.ts
-│       ├── entities.ts
-│       ├── errors.ts
-│       └── value-objects.ts
-└── users/
-    ├── adapters/
-    ├── application/
-    ├── domain/
-    └── example-ports.ts
+|-- index.d.ts
+|-- main.ts
+|-- shared/
+|   |-- application/
+|   |   |-- data/
+|   |   |   |-- drivers.ts
+|   |   |   |-- managers.ts
+|   |   |   `-- repositories.ts
+|   |   |-- events.ts
+|   |   |-- http.ts
+|   |   |-- loggers.ts
+|   |   |-- services.ts
+|   |   `-- validations.ts
+|   `-- domain/
+|       |-- aggregates.ts
+|       |-- entities.ts
+|       |-- errors.ts
+|       `-- value-objects.ts
+`-- users/
+    |-- adapters/
+    |-- application/
+    |-- domain/
+    `-- example-ports.ts
 ```
 
 ### Choose the destination directory
@@ -115,7 +115,11 @@ The context is created at `core/billing`.
 
 ### Create a context for React
 
-The `--react` option creates a context with directories intended for a React application:
+The `--react` option creates a context intended for a React application.
+
+A React context is a consumer by nature. It does not provide a hexagonal capability to other systems. Instead, it consumes existing capabilities and organizes that consumption as a collection of adapters for the UI layer.
+
+Use this mode when the generated context will call APIs, validate interface data, expose hooks, compose components, and localize messages.
 
 ```bash
 npx tshex --ctx users --react
@@ -127,19 +131,33 @@ You can also use its short form:
 npx tshex --ctx users -R
 ```
 
-The context structure includes adapters for APIs, hooks, and schemas, together with application, domain, and language resources:
+The command creates this structure:
 
 ```text
 users/
-├── adapters/
-│   ├── api/
-│   ├── hooks/
-│   └── schemas/
-├── application/
-├── domain/
-└── languages/
+|-- api/
+|-- assets/
+|-- components/
+|-- core/
+|-- hooks/
+|-- languages/
+`-- schemas/
 ```
 
+Each directory represents a consumption adapter or a resource used by those adapters:
+
+| Directory | Responsibility |
+| --- | --- |
+| `api/` | Adapters that call external services or backend contexts. |
+| `assets/` | Static resources used by the React context. |
+| `components/` | Visual react adapters that render the consumed capability. |
+| `core/` | Local support code and project modules adapters shared by the adapters in this context. |
+| `hooks/` | React hook adapters that expose behavior to components. |
+| `languages/` | Translation resources for the interface. Can be json, ts files, etc. |
+| `schemas/` | Validation and parsing adapters for UI input and output. |
+
+This layout is intentionally different from the default context template. The standard context separates `domain`, `application`, and `adapters` because it models and provides a capability. The React context generated with `--react` assumes the opposite role: it always consumes capabilities and groups the code around the adapters required by that consumption.
+
 ## Documentation index
 
 From this point on, the guide is split into dedicated documents under `docs/`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tshex-cli",
-  "version": "1.0.21",
+  "version": "1.0.22",
   "author": "https://github.com/virtualitems/",
   "license": "MIT",
   "description": "Typescript Hexagonal Architecture CLI",

package/templates/ctx-react/languages/en.json

@@ -0,0 +1 @@
+{}

package/templates/ctx-react/languages/es.json

@@ -0,0 +1 @@
+{}