@deneb-ui/cli 2.0.22 → 2.0.23

package/README.md

@@ -1,138 +1,86 @@
-# DENEB
-
-### The official developer CLI for DENEB UI.
-
-> **DENEB UI — Build beautiful interfaces, effortlessly.**  
-> The premier visual-first React component ecosystem.  
-> Proudly presented by **DENEB-UI Collaborate with FIVORA**.
-
-[![Framework: DENEB UI](https://img.shields.io/badge/Framework-DENEB_UI_v2.0-blue.svg)](https://github.com/deneb-ui/ui)
-[![License: MIT](https://img.shields.io/badge/License-MIT-teal.svg)](https://opensource.org/licenses/MIT)
-
----
-
-## Installation
-
-You can run commands directly using `npx`:
-```bash
-npx @deneb-ui/cli <command>
-```
-
-Or install as a project devDependency:
-```bash
-npm install -D @deneb-ui/cli
-```
-
-Or install globally:
-```bash
-npm install -g @deneb-ui/cli
-```
-
-The CLI command is available as `deneb` (with alias `denebui`).
+<p align="center">
+  <a href="https://deneb.fivora.site">
+    <img src="https://img.shields.io/badge/DENEB_CLI-Storefront_Authoring_Toolkit-6366F1?style=for-the-badge&labelColor=0f172a" alt="DENEB CLI" />
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@deneb-ui/cli"><img src="https://img.shields.io/npm/v/@deneb-ui/cli.svg?style=flat-square&color=6366F1" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/@deneb-ui/cli"><img src="https://img.shields.io/npm/dm/@deneb-ui/cli.svg?style=flat-square&color=6366F1" alt="npm downloads" /></a>
+  <img src="https://img.shields.io/badge/Node-%3E%3D18-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node.js" />
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-emerald?style=flat-square" alt="MIT License" /></a>
+</p>
+
+<p align="center">
+  <strong>Scaffold, convert, validate, and ship Fivora-ready storefront templates.</strong>
+</p>
+
+<p align="center">
+  <a href="https://deneb.fivora.site/docs/cli"><strong>CLI Reference</strong></a> ·
+  <a href="https://deneb.fivora.site/docs/installation"><strong>Installation</strong></a> ·
+  <a href="https://github.com/deneb-ui/core"><strong>GitHub</strong></a>
+</p>
 
 ---
 
-## Commands
-
-### 1. `deneb add <component>` (Component Registry)
-Add production-ready DENEB UI components into `src/components/ui/`:
-
-```bash
-# List available components:
-npx @deneb-ui/cli add list
-
-# Add specific components:
-npx @deneb-ui/cli add product-card
-npx @deneb-ui/cli add contact-actions
-npx @deneb-ui/cli add location-card
-npx @deneb-ui/cli add whatsapp-button
-npx @deneb-ui/cli add dialog
-npx @deneb-ui/cli add all
-```
-
-### 1. `deneb init` (Initialize Existing Project)
-Converts and configures any **ongoing Next.js project** for the Fivora platform:
-- Generates `fivora-template.json` (Version 2 contract with strict visual editing)
-- Creates `src/data/site-data.json` with merchant defaults
-- Injects npm scripts (`lab`, `validate`, `zip`, `validate-and-zip`, `update:deneb`)
-- Installs `@deneb-ui/ui` and `@deneb-ui/cli`
+## Quick start
 
 ```bash
+# Convert an existing Next.js app (Deneb ARC — default engine)
 npx @deneb-ui/cli init
-# Or: deneb init
-```
-
-### 2. `deneb update` (Update Packages & DENEB Components)
-Keeps your project up to date by updating both npm packages and installed DENEB components:
-- Updates `@deneb-ui/ui` and `@deneb-ui/cli` to the latest releases
-- Automatically scans `src/components/ui/` and synchronizes existing DENEB UI components with the latest definitions
 
-```bash
-npm run update:deneb
-# Or: deneb update
-```
+# Preview the transformation plan without writing files
+npx @deneb-ui/cli init --explain
 
-### 3. `deneb validate` (Preflight Contract Validator)
-Runs Fivora preflight verification against manifest contracts, static export fixtures, and visual editing markers (`data-fivora-path`, `data-fivora-page`):
+# Validate Fivora contract compliance
+npx @deneb-ui/cli validate .
 
-```bash
-npm run validate
-# Or: deneb validate .
-# Or validate and immediately bundle on success:
-deneb validate --zip
+# Package a clean upload ZIP
+npx @deneb-ui/cli validate --zip
 ```
 
-### 4. `deneb zip` / `deneb pack` (Clean Package Generator)
-Creates a clean, upload-ready `fivora-template.zip` excluding unnecessary directories and secret files (`node_modules`, `.next`, `.git`, `.env*`, `.cache`, `.turbo`, logs):
+Install as a dev dependency:
 
 ```bash
-npm run zip
-# Or: deneb zip .
-```
-
-### 5. `deneb validate-and-zip` (One-Step Preflight Check & Clean ZIP)
-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`:
-
-```bash
-npm run validate-and-zip
-# Or: deneb validate-and-zip .
-# Or: deneb validate and zip
+npm install -D @deneb-ui/cli
+# Command: deneb
 ```
 
-### 6. `deneb add <component>` (Component Registry)
-Add or update production-ready DENEB UI components into `src/components/ui/`:
+---
 
-```bash
-# List available components:
-npx @deneb-ui/cli add list
-
-# Add specific components:
-npx @deneb-ui/cli add product-card
-npx @deneb-ui/cli add contact-actions
-npx @deneb-ui/cli add location-card
-npx @deneb-ui/cli add whatsapp-button
-npx @deneb-ui/cli add dialog
-npx @deneb-ui/cli add all
-```
+## Commands
 
-### 7. `deneb create <project-name>` (Start from Scratch)
-Scaffolds a brand-new Next.js App Router storefront pre-configured with Tailwind CSS and `@deneb-ui/ui`:
+| Command | Description |
+| :--- | :--- |
+| `deneb init` | Run **Deneb ARC** — AST conversion of React/Next.js apps into Fivora-editable templates |
+| `deneb init --legacy` | Use the legacy regex converter instead of ARC |
+| `deneb init --dry-run` | Simulate conversion; print field paths without writing |
+| `deneb init --explain` | Show transformation plan with confidence scores |
+| `deneb validate` | Preflight manifest + visual editing contract checks |
+| `deneb zip` | Create upload-ready `fivora-template.zip` |
+| `deneb doctor` | Environment, dependency, and export diagnostics |
+| `deneb add <component>` | Copy DENEB UI components into your project |
+| `deneb lab` | Launch local visual editing preview lab |
+| `deneb update` | Update `@deneb-ui/*` packages and synced components |
+
+Full reference: [deneb.fivora.site/docs/cli](https://deneb.fivora.site/docs/cli)
 
-```bash
-npx @deneb-ui/cli create my-store
-```
+---
 
-### 8. `deneb lab` (Local Visual Editing Lab)
-Launches the interactive visual editing test lab simulating Fivora editor messages:
+## What `deneb init` does (ARC)
 
-```bash
-npm run lab
-# Or: deneb lab .
-```
+1. **Scans** your Next.js project — routes, dependencies, reachable pages  
+2. **Analyzes** JSX for editable text, images, URLs, collections, CTAs  
+3. **Transforms** source via AST — injects preview markers and `site-data` bindings  
+4. **Generates** `fivora-template.json` + `site-data.json` with strict self-validation  
+5. **Backs up** changed files to `.deneb-backup-*` for safe rollback  
 
 ---
 
-## 👤 Author & Credits
+## Authors
+
+Created and maintained by **[Chamika Gayashan](https://github.com/chamikathereal)** and **[Induranga Kawishwara](https://github.com/Induranga-kawishwara)**.
 
-Created and architected by **Chamika Gayashan & Induranga Kawishwara**.  
-Part of the **DENEB UI** ecosystem.
+<p align="center">
+  <sub>MIT © DENEB UI</sub>
+</p>

package/bin/index.js

@@ -602,8 +602,8 @@ function initProject(targetInput, options = {}) {
   const pkgPath = path.join(targetDir, 'package.json');
 
   console.log('\n' + createBox([
-    '\x1b[1m\x1b[37mDENEB TEMPLATE INITIALIZER\x1b[0m',
-    '\x1b[90mConfigure existing Next.js project for Fivora Platform\x1b[0m',
+    '\x1b[1m\x1b[37mDENEB ARC\x1b[0m',
+    '\x1b[90mAdaptive Refactoring Compiler for Fivora-editable UI\x1b[0m',
     '\x1b[90mPowered by DENEB-UI Collaborate with FIVORA\x1b[0m'
   ], 58) + '\n');
 
@@ -637,20 +637,27 @@ function initProject(targetInput, options = {}) {
   // 1. Scan / Detect Pages
   const detectedPages = detectPages(targetDir);
 
-  // 2. Run Universal Template Conversion Engine
-  // Automatically detects CSS/UI frameworks (shadcn/ui, HeroUI, Tailwind CSS),
-  // creates safe backup, instruments Root Layout with SiteDataProvider,
-  // extracts hardcoded text/images/buttons/placeholders,
-  // injects data-preview-field-path markers, harmonizes UI components,
-  // and builds synchronized site-data.json & fivora-template.json.
+  // 2. Deneb ARC (default) or legacy regex converter (--legacy)
   let conversionRes = null;
   try {
-    const { runUniversalTemplateConversion } = require('../src/tools/template-converter.cjs');
-    conversionRes = runUniversalTemplateConversion(targetDir, projectName, detectedPages, options);
+    if (options.legacy) {
+      const { runUniversalTemplateConversion } = require('../src/tools/template-converter.cjs');
+      conversionRes = runUniversalTemplateConversion(targetDir, projectName, detectedPages, options);
+    } else {
+      const { runDenebArc } = require('../src/arc/index.cjs');
+      conversionRes = runDenebArc(targetDir, projectName, {
+        ...options,
+        detectedPages,
+      });
+    }
   } catch (err) {
     console.error(`\x1b[33m⚠ Note:\x1b[0m Automated conversion encountered an issue: ${err.message}. Falling back to default generation.`);
   }
 
+  if (options.dryRun) {
+    return conversionRes;
+  }
+
   // 3. Fallback: Generate fivora-template.json if not yet present
   const manifestPath = path.join(targetDir, 'fivora-template.json');
   if (!fs.existsSync(manifestPath)) {
@@ -999,17 +1006,31 @@ if (command === 'validate' && (commandArgs[0] === 'and' || commandArgs[0] === '&
 if (command === 'init') {
   let targetInput = '.';
   let recipeName = null;
+  let dryRun = false;
+  let explain = false;
+  let legacy = false;
+  let telemetry = 'off';
   for (let i = 0; i < commandArgs.length; i++) {
     const arg = commandArgs[i];
     if (arg === '--recipe' || arg === '-r') {
       recipeName = commandArgs[++i];
     } else if (arg.startsWith('--recipe=')) {
       recipeName = arg.split('=')[1];
+    } else if (arg === '--dry-run' || arg === '--dryrun') {
+      dryRun = true;
+    } else if (arg === '--explain') {
+      explain = true;
+    } else if (arg === '--legacy') {
+      legacy = true;
+    } else if (arg === '--telemetry' && commandArgs[i + 1]) {
+      telemetry = commandArgs[++i];
+    } else if (arg.startsWith('--telemetry=')) {
+      telemetry = arg.split('=')[1] || 'off';
     } else if (!arg.startsWith('-')) {
       targetInput = arg;
     }
   }
-  initProject(targetInput, { recipeName });
+  initProject(targetInput, { recipeName, dryRun, explain, legacy, telemetry });
 } else if (command === 'create') {
   createTemplate(commandArgs[0]);
 } else if (command === 'add') {
@@ -1072,7 +1093,8 @@ if (command === 'init') {
   DENEB UI Framework — Powered by DENEB-UI Collaborate with FIVORA
 
 Core Commands:
-  init              Auto-convert & configure existing Next.js into editable Fivora storefront (e.g. deneb init --recipe fashion)
+  init              Deneb ARC: convert an existing React/Next.js app into a Fivora-editable storefront
+                    flags: --dry-run  --explain  --recipe <name>  --legacy  --telemetry off|anonymous|enhanced
   doctor            Run comprehensive environment, manifest, visual editing AST & asset diagnostic checks (flags: --fix, --json)
   save-recipe       Learn and save calibrated fixes & schemas into reusable recipe bank (e.g. deneb save-recipe . shoes-store)
   learn             Alias for save-recipe
@@ -1093,9 +1115,12 @@ Examples:
   deneb doctor --fix
   deneb doctor --json
   deneb init
+  deneb init --dry-run
+  deneb init --explain
   deneb init --recipe fashion
   deneb init --recipe electronics
   deneb init --recipe cosmetics
+  deneb init --legacy
   deneb update
   deneb validate .
   deneb validate --zip

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deneb-ui/cli",
-  "version": "2.0.22",
-  "description": "Official developer CLI for DENEB UI — Validating, scaffolding, testing, and packaging storefront templates. Created by Chamika Gayashan & Induranga Kawishwara.",
+  "version": "2.0.23",
+  "description": "Official DENEB CLI — scaffold, convert, validate, and package Fivora-ready storefront templates.",
   "bin": {
     "deneb": "bin/index.js",
     "denebui": "bin/index.js",
@@ -15,7 +15,7 @@
     "url": "git+https://github.com/deneb-ui/core.git",
     "directory": "cli/deneb-cli"
   },
-  "homepage": "https://github.com/deneb-ui/core#readme",
+  "homepage": "https://deneb.fivora.site/docs/cli",
   "bugs": {
     "url": "https://github.com/deneb-ui/core/issues"
   },
@@ -24,16 +24,31 @@
     "src",
     "README.md"
   ],
+  "scripts": {
+    "test": "node --test src/arc/__tests__/arc.test.cjs"
+  },
   "keywords": [
     "deneb",
     "deneb-ui",
     "cli",
+    "fivora",
+    "nextjs",
+    "template",
     "validator",
-    "packager"
+    "packager",
+    "visual-editing",
+    "storefront",
+    "scaffold"
   ],
   "author": "Chamika Gayashan & Induranga Kawishwara",
+  "contributors": [
+    "Chamika Gayashan <https://github.com/chamikathereal>",
+    "Induranga Kawishwara <https://github.com/Induranga-kawishwara>"
+  ],
   "license": "MIT",
   "dependencies": {
-    "adm-zip": "^0.6.0"
+    "@babel/parser": "^7.28.0",
+    "adm-zip": "^0.6.0",
+    "recast": "^0.23.11"
   }
 }

package/src/arc/__fixtures__/next-app-basic/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "arc-fixture-next-app",
+  "private": true,
+  "dependencies": {
+    "next": "16.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwindcss": "^3.4.0"
+  }
+}

package/src/arc/__fixtures__/next-app-basic/src/app/globals.css

@@ -0,0 +1,3 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;

package/src/arc/__fixtures__/next-app-basic/src/app/layout.tsx

@@ -0,0 +1,9 @@
+import './globals.css';
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

package/src/arc/__fixtures__/next-app-basic/src/app/page.tsx

@@ -0,0 +1,11 @@
+import { Hero } from '../components/Hero';
+import { Header } from '../components/Header';
+
+export default function HomePage() {
+  return (
+    <main>
+      <Header />
+      <Hero />
+    </main>
+  );
+}

package/src/arc/__fixtures__/next-app-basic/src/components/Header.tsx

@@ -0,0 +1,13 @@
+export function Header() {
+  return (
+    <header className="site-header">
+      <a href="/" className="logo">
+        Aurora Store
+      </a>
+      <nav>
+        <a href="/shop">Shop</a>
+        <a href="/about">About</a>
+      </nav>
+    </header>
+  );
+}

package/src/arc/__fixtures__/next-app-basic/src/components/Hero.tsx

@@ -0,0 +1,12 @@
+export function Hero() {
+  return (
+    <section className="hero">
+      <h1>Summer Collection</h1>
+      <p>Discover lightweight performance apparel for every season.</p>
+      <a href="https://wa.me/94771234567" className="btn cta">
+        Start a Conversation
+      </a>
+      <img src="/hero.jpg" alt="Summer Collection" />
+    </section>
+  );
+}

package/src/arc/__fixtures__/next-app-basic/src/components/PromoBanner.tsx

@@ -0,0 +1,10 @@
+'use client';
+
+export function PromoBanner() {
+  return (
+    <div className="banner">
+      <h2>Limited Drop</h2>
+      <button>Notify Me</button>
+    </div>
+  );
+}

package/src/arc/__fixtures__/next-app-basic/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "jsx": "preserve",
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  }
+}

package/src/arc/__fixtures__/next-app-storefront/components.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "tailwind": {
+    "config": "",
+    "css": "src/app/globals.css",
+    "baseColor": "slate",
+    "cssVariables": true
+  },
+  "aliases": {
+    "components": "@/components",
+    "ui": "@/components/ui"
+  }
+}

package/src/arc/__fixtures__/next-app-storefront/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "acme-storefront",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build"
+  },
+  "dependencies": {
+    "next": "15.1.0",
+    "react": "19.0.0",
+    "react-dom": "19.0.0",
+    "lucide-react": "^0.460.0",
+    "framer-motion": "^11.11.0",
+    "class-variance-authority": "^0.7.0",
+    "@radix-ui/react-slot": "^1.1.0"
+  },
+  "devDependencies": {
+    "tailwindcss": "^4.0.0",
+    "typescript": "^5.6.0"
+  }
+}

package/src/arc/__fixtures__/next-app-storefront/src/app/about/page.tsx

@@ -0,0 +1,13 @@
+export default function AboutPage() {
+  return (
+    <main className="mx-auto max-w-3xl px-6 py-24">
+      <h1 className="text-4xl font-semibold tracking-tight">Our Story</h1>
+      <p className="mt-6 text-lg leading-relaxed text-slate-600">
+        Acme was founded in a garage in 2014 with a single goal: build tools that outlast trends.
+      </p>
+      <div className="mt-10 text-sm text-slate-500">
+        Every product is assembled by hand in small batches.
+      </div>
+    </main>
+  );
+}

package/src/arc/__fixtures__/next-app-storefront/src/app/globals.css

@@ -0,0 +1,5 @@
+@import 'tailwindcss';
+
+:root {
+  --brand-primary: #0f172a;
+}

package/src/arc/__fixtures__/next-app-storefront/src/app/layout.tsx

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+import { SiteHeader } from '@/components/SiteHeader';
+import { SiteFooter } from '@/components/SiteFooter';
+
+export const metadata = {
+  title: 'Acme Storefront',
+};
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body className="min-h-screen bg-white text-slate-900 antialiased">
+        <SiteHeader />
+        {children}
+        <SiteFooter />
+      </body>
+    </html>
+  );
+}

package/src/arc/__fixtures__/next-app-storefront/src/app/page.tsx

@@ -0,0 +1,13 @@
+import { Hero } from '@/components/Hero';
+import { ProductGrid } from '@/components/ProductGrid';
+import { Features } from '@/components/Features';
+
+export default function HomePage() {
+  return (
+    <main className="flex flex-col gap-24 pb-24">
+      <Hero />
+      <ProductGrid />
+      <Features />
+    </main>
+  );
+}

package/src/arc/__fixtures__/next-app-storefront/src/components/Features.tsx

@@ -0,0 +1,31 @@
+'use client';
+
+import { motion } from 'framer-motion';
+import { Truck, ShieldCheck, Recycle } from 'lucide-react';
+
+const features = [
+  { icon: Truck, title: 'Free carbon-neutral shipping', body: 'On every order above $80.' },
+  { icon: ShieldCheck, title: 'Five year warranty', body: 'Repairs handled in-house, forever.' },
+  { icon: Recycle, title: 'Circular by design', body: 'Send it back and we rebuild it.' },
+];
+
+export function Features() {
+  return (
+    <section className="bg-slate-50 px-6 py-20">
+      <div className="mx-auto grid max-w-5xl gap-10 md:grid-cols-3">
+        {features.map((feature) => (
+          <motion.div
+            key={feature.title}
+            initial={{ opacity: 0, y: 12 }}
+            whileInView={{ opacity: 1, y: 0 }}
+            className="flex flex-col gap-3"
+          >
+            <feature.icon className="size-6 text-slate-900" aria-hidden="true" />
+            <h3 className="text-base font-semibold">{feature.title}</h3>
+            <p className="text-sm text-slate-600">{feature.body}</p>
+          </motion.div>
+        ))}
+      </div>
+    </section>
+  );
+}

package/src/arc/__fixtures__/next-app-storefront/src/components/Hero.tsx

@@ -0,0 +1,45 @@
+import Image from 'next/image';
+import Link from 'next/link';
+import { ArrowRight } from 'lucide-react';
+import { Button } from '@/components/ui/button';
+
+export function Hero() {
+  const badge = 'New Season 2026';
+
+  return (
+    <section className="relative grid gap-12 px-6 pt-20 md:grid-cols-2 md:items-center">
+      <div className="flex flex-col gap-6">
+        <span className="w-fit rounded-full bg-slate-100 px-3 py-1 text-xs uppercase tracking-widest">
+          {badge}
+        </span>
+        <h1 className="text-5xl font-semibold leading-tight tracking-tight">
+          Engineered for modern living
+        </h1>
+        <p className="max-w-md text-lg text-slate-600">
+          Discover a minimalist collection crafted from premium materials that age beautifully.
+        </p>
+        <div className="flex items-center gap-4">
+          <Button asChild>
+            <Link href="/products">
+              Shop the collection
+              <ArrowRight className="ml-2 size-4" aria-hidden="true" />
+            </Link>
+          </Button>
+          <a
+            href="https://wa.me/15550192834"
+            className="text-sm font-medium underline underline-offset-4"
+          >
+            Chat with a stylist
+          </a>
+        </div>
+      </div>
+      <Image
+        src="/hero-lounge.webp"
+        alt="Lounge chair in a sunlit room"
+        width={720}
+        height={540}
+        className="rounded-3xl object-cover shadow-2xl"
+      />
+    </section>
+  );
+}