@deneb-ui/cli 2.0.7 → 2.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
  > The premier visual-first React component ecosystem.
7
7
  > Proudly presented by **DENEB-UI Collaborate with FIVORA**.
8
8
 
9
- [![Framework: DENEB UI](https://img.shields.io/badge/Framework-DENEB_UI_v2.0-blue.svg)](https://github.com/chamikathereal)
9
+ [![Framework: DENEB UI](https://img.shields.io/badge/Framework-DENEB_UI_v2.0-blue.svg)](https://github.com/deneb-ui/ui)
10
10
  [![License: MIT](https://img.shields.io/badge/License-MIT-teal.svg)](https://opensource.org/licenses/MIT)
11
11
 
12
12
  ---
@@ -50,50 +50,84 @@ npx @deneb-ui/cli add dialog
50
50
  npx @deneb-ui/cli add all
51
51
  ```
52
52
 
53
- ### 2. `deneb init` (Configure an Existing Project)
54
- Converts any **existing Next.js project** into a compliant DENEB storefront template:
53
+ ### 1. `deneb init` (Initialize Existing Project)
54
+ Converts and configures any **ongoing Next.js project** for the Fivora platform:
55
+ - Generates `fivora-template.json` (Version 2 contract with strict visual editing)
56
+ - Creates `src/data/site-data.json` with merchant defaults
57
+ - Injects npm scripts (`lab`, `validate`, `zip`, `validate-and-zip`, `update:deneb`)
58
+ - Installs `@deneb-ui/ui` and `@deneb-ui/cli`
55
59
 
56
60
  ```bash
57
61
  npx @deneb-ui/cli init
62
+ # Or: deneb init
58
63
  ```
59
64
 
60
- ### 3. `deneb create <project-name>` (Start from Scratch)
61
- Scaffolds a brand-new Next.js App Router storefront with Tailwind CSS and `@deneb-ui/ui`:
65
+ ### 2. `deneb update` (Update Packages & DENEB Components)
66
+ Keeps your project up to date by updating both npm packages and installed DENEB components:
67
+ - Updates `@deneb-ui/ui` and `@deneb-ui/cli` to the latest releases
68
+ - Automatically scans `src/components/ui/` and synchronizes existing DENEB UI components with the latest definitions
62
69
 
63
70
  ```bash
64
- npx @deneb-ui/cli create my-store
65
- ```
66
-
67
- ### 4. `deneb lab` (Local Visual Editing Lab)
68
- Launches the interactive visual editing test lab:
69
-
70
- ```bash
71
- npm run lab
72
- # Or: deneb lab .
71
+ npm run update:deneb
72
+ # Or: deneb update
73
73
  ```
74
74
 
75
- ### 5. `deneb validate` (Preflight Contract Validator)
76
- Runs preflight checks to guarantee 100% compliance with visual editing and platform rules:
75
+ ### 3. `deneb validate` (Preflight Contract Validator)
76
+ Runs Fivora preflight verification against manifest contracts, static export fixtures, and visual editing markers (`data-fivora-path`, `data-fivora-page`):
77
77
 
78
78
  ```bash
79
79
  npm run validate
80
80
  # Or: deneb validate .
81
+ # Or validate and immediately bundle on success:
82
+ deneb validate --zip
81
83
  ```
82
84
 
83
- ### 6. `deneb zip` / `deneb pack` (Clean Package Generator)
84
- Creates a clean, production-ready template ZIP excluding `node_modules`, `.next`, `.git`, `.env*`:
85
+ ### 4. `deneb zip` / `deneb pack` (Clean Package Generator)
86
+ Creates a clean, upload-ready `fivora-template.zip` excluding unnecessary directories and secret files (`node_modules`, `.next`, `.git`, `.env*`, `.cache`, `.turbo`, logs):
85
87
 
86
88
  ```bash
87
89
  npm run zip
88
90
  # Or: deneb zip .
89
91
  ```
90
92
 
91
- ### 7. `deneb update` (Dependency Updater)
92
- Updates `@deneb-ui/ui` and `@deneb-ui/cli` to the latest versions:
93
+ ### 5. `deneb validate-and-zip` (One-Step Preflight Check & Clean ZIP)
94
+ The safest, recommended command for releasing templates. Runs full preflight validation; if and only if all platform checks pass 100%, it bundles a clean `fivora-template.zip`:
93
95
 
94
96
  ```bash
95
- npm run update:deneb
96
- # Or: deneb update
97
+ npm run validate-and-zip
98
+ # Or: deneb validate-and-zip .
99
+ # Or: deneb validate and zip
100
+ ```
101
+
102
+ ### 6. `deneb add <component>` (Component Registry)
103
+ Add or update production-ready DENEB UI components into `src/components/ui/`:
104
+
105
+ ```bash
106
+ # List available components:
107
+ npx @deneb-ui/cli add list
108
+
109
+ # Add specific components:
110
+ npx @deneb-ui/cli add product-card
111
+ npx @deneb-ui/cli add contact-actions
112
+ npx @deneb-ui/cli add location-card
113
+ npx @deneb-ui/cli add whatsapp-button
114
+ npx @deneb-ui/cli add dialog
115
+ npx @deneb-ui/cli add all
116
+ ```
117
+
118
+ ### 7. `deneb create <project-name>` (Start from Scratch)
119
+ Scaffolds a brand-new Next.js App Router storefront pre-configured with Tailwind CSS and `@deneb-ui/ui`:
120
+
121
+ ```bash
122
+ npx @deneb-ui/cli create my-store
123
+ ```
124
+
125
+ ### 8. `deneb lab` (Local Visual Editing Lab)
126
+ Launches the interactive visual editing test lab simulating Fivora editor messages:
127
+
128
+ ```bash
129
+ npm run lab
130
+ # Or: deneb lab .
97
131
  ```
98
132
 
99
133
  ---